Claude Code 가이드 #14 — 웹 & 리모트 실행

리모트 실행이 필요한 이유

SSH + tmux/screen 조합

SSH + tmux 기본 세팅
# 1. 원격 서버에 SSH 접속
ssh user@your-server.com

# 2. tmux 새 세션 생성 (이름을 붙이면 나중에 찾기 쉽다)
tmux new -s claude-work

# 3. 세션 안에서 CC 실행
claude

# --- SSH 연결이 끊겨도 세션은 살아있다 ---

# 4. 다시 접속 후 세션 복원
ssh user@your-server.com
tmux attach -t claude-work

# 5. 실행 중인 세션 목록 확인
tmux ls

screen을 쓰는 경우 (tmux 대안)
# screen 새 세션 생성
screen -S claude-work

# CC 실행 후 Ctrl+A, D 로 detach (세션 유지)
claude

# 재접속 후 세션 복원
screen -r claude-work

# 실행 중인 세션 목록
screen -ls

API Key 환경변수로 인증 (브라우저 없는 서버)
# ~/.bashrc 또는 ~/.zshrc 에 추가
export ANTHROPIC_API_KEY="sk-ant-api03-..."

# 반영
source ~/.bashrc

# CC 실행 (자동으로 API Key 인증)
claude

code.claude.com 웹 UI

GitHub Codespaces에서 실행하기

Codespace에서 CC 설치 및 실행
# 1. Codespace 터미널에서 Node.js 확인
node --version  # v18 이상 필요

# 2. CC 설치
npm install -g @anthropic-ai/claude-code

# 3. 인증 (API Key 방식 권장)
export ANTHROPIC_API_KEY="sk-ant-api03-..."

# 4. 프로젝트 루트에서 실행
cd /workspaces/your-project
claude

.devcontainer/devcontainer.json — CC 자동 설치 설정
{
  "name": "Project Dev Environment",
  "image": "mcr.microsoft.com/devcontainers/javascript-node:18",
  "postCreateCommand": "npm install -g @anthropic-ai/claude-code",
  "secrets": {
    "ANTHROPIC_API_KEY": {
      "description": "Anthropic API key for Claude Code"
    }
  }
}

Headless 모드 + 원격 조합

Headless 모드 기본 사용법
# -p 플래그로 프롬프트 직접 전달 (비대화형)
claude -p "현재 디렉토리의 JS 파일에서 node --check 실행하고 결과 알려줘"

# 파이프로 전달
echo "README.md 파일의 오탈자를 수정해줘" | claude -p -

# 결과를 파일로 저장
claude -p "sitemap.xml 재생성해줘" > output.log 2>&1

cron + SSH 조합 — 매일 새벽 sitemap 자동 갱신
# 로컬 머신의 crontab에 추가 (crontab -e)
# 매일 새벽 2시에 원격 서버에서 CC로 sitemap 재생성
0 2 * * * ssh user@your-server.com 'cd /var/www/project && ANTHROPIC_API_KEY=sk-ant-api03-... claude -p "sitemap.xml 재생성하고 git commit해줘"' >> /var/log/claude-cron.log 2>&1

GitHub Actions에서 CC Headless 실행
# .github/workflows/claude-review.yml
name: Claude Code Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
      - run: npm install -g @anthropic-ai/claude-code
      - run: claude -p "이 PR의 변경사항을 검토하고 잠재적 버그를 찾아줘"
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

실전 팁

.claude/settings.json — 리모트 환경 공통 설정 예시
// .claude/settings.json (git으로 관리)
{
  "model": "claude-sonnet-4-5",
  "permissions": {
    "allow": [
      "Edit",
      "Write",
      "Bash(node --check *)",
      "Bash(git status)",
      "Bash(git diff *)"
    ]
  }
}

요약 및 관련 편