웹에서 Claude Code 사용하기

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

• GitHub 인증 옵션: GitHub를 연결하는 두 가지 방법
• 클라우드 환경: 어떤 구성이 이월되는지, 어떤 도구가 설치되어 있는지, 환경을 구성하는 방법
• 설정 스크립트 및 종속성 관리
• 네트워크 액세스: 수준, 프록시 및 기본 허용 목록
• --remote 및 --teleport를 사용하여 웹과 터미널 간에 작업 이동
• 세션 작업: 검토, 공유, 보관, 삭제
• Pull request 자동 수정: CI 실패 및 검토 주석에 자동으로 응답
• 보안 및 격리: 세션이 어떻게 격리되는지
• 제한 사항: 속도 제한 및 플랫폼 제한

​

GitHub 인증 옵션

​

클라우드 환경

​

클라우드 세션에서 사용 가능한 것

​

설치된 도구

​

GitHub 이슈 및 pull request 작업

​

아티팩트를 세션으로 다시 연결

echo "https://claude.ai/code/${CLAUDE_CODE_REMOTE_SESSION_ID/#cse_/session_}"

​

테스트 실행, 서비스 시작 및 패키지 추가

service postgresql start

service redis-server start

​

리소스 제한

• 4 vCPU
• 16 GB RAM
• 30 GB 디스크

​

환경 구성

NODE_ENV=development
LOG_LEVEL=debug
DATABASE_URL=postgres://localhost:5432/myapp

​

설정 스크립트

#!/bin/bash
apt update && apt install -y gh

​

환경 캐싱

​

설정 스크립트 vs. SessionStart hooks

​

SessionStart hook로 종속성 설치

{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "startup|resume",
        "hooks": [
          {
            "type": "command",
            "command": "\"$CLAUDE_PROJECT_DIR\"/scripts/install_pkgs.sh"
          }
        ]
      }
    ]
  }
}

#!/bin/bash

if [ "$CLAUDE_CODE_REMOTE" != "true" ]; then
  exit 0
fi

npm install
pip install -r requirements.txt
exit 0

• 클라우드 전용 범위 없음: hooks는 로컬 및 클라우드 세션 모두에서 실행됩니다. 로컬 실행을 건너뛰려면 위에 표시된 대로 CLAUDE_CODE_REMOTE 환경 변수를 확인하세요.
• 네트워크 액세스 필요: 설치 명령은 패키지 레지스트리에 도달해야 합니다. 환경이 None 네트워크 액세스를 사용하면 이러한 hooks가 실패합니다. Trusted 아래의 기본 허용 목록은 npm, PyPI, RubyGems 및 crates.io를 포함합니다.
• 프록시 호환성: 모든 아웃바운드 트래픽은 보안 프록시를 통과합니다. 일부 패키지 관리자는 이 프록시에서 제대로 작동하지 않습니다. Bun은 알려진 예입니다.
• 시작 지연 추가: hooks는 세션이 시작되거나 재개될 때마다 실행됩니다. 설정 스크립트와 달리 환경 캐싱의 이점을 얻지 못합니다. 재설치하기 전에 종속성이 이미 있는지 확인하여 설치 스크립트를 빠르게 유지하세요.

​

네트워크 액세스

​

액세스 수준

​

특정 도메인 허용

api.example.com
*.internal.example.com
registry.example.com

​

GitHub 프록시

• GitHub 인증을 안전하게 관리합니다: git 클라이언트는 샌드박스 내에서 범위 자격 증명을 사용하며, 프록시가 이를 확인하고 실제 GitHub 인증 토큰으로 변환합니다
• 안전을 위해 git push 작업을 현재 작업 분기로 제한합니다
• 보안 경계를 유지하면서 복제, 가져오기 및 PR 작업을 활성화합니다

​

보안 프록시

• 악의적인 요청으로부터의 보호
• 속도 제한 및 남용 방지
• 향상된 보안을 위한 콘텐츠 필터링

​

기본 허용 도메인

​

웹과 터미널 간에 작업 이동

​

터미널에서 웹으로

claude --remote "Fix the authentication bug in src/auth/login.ts"

​

클라우드 작업 팁

claude --permission-mode plan

claude --remote "Execute the migration plan in docs/migration-plan.md"

claude --remote "Fix the flaky test in auth.spec.ts"
claude --remote "Update the API documentation"
claude --remote "Refactor the logger to use structured output"

​

GitHub 없이 로컬 저장소 보내기

CCR_FORCE_BUNDLE=1 claude --remote "Run the test suite and fix any failures"

• 디렉토리는 최소 하나의 커밋이 있는 git 저장소여야 합니다
• 번들된 저장소는 100 MB 미만이어야 합니다. 더 큰 저장소는 현재 분기만 번들로 만들기로 폴백한 다음 작업 트리의 단일 스쿼시 스냅샷으로 폴백하고, 스냅샷이 여전히 너무 크면 실패합니다
• 추적되지 않은 파일은 포함되지 않습니다. 클라우드 세션이 보기를 원하는 파일에 대해 git add를 실행하세요
• 번들에서 생성된 세션은 GitHub 인증도 구성되어 있지 않으면 원격으로 다시 푸시할 수 없습니다

​

웹에서 터미널로

• --teleport 사용: 명령줄에서 claude --teleport를 실행하여 대화형 세션 선택기를 사용하거나 claude --teleport <session-id>를 실행하여 특정 세션을 직접 재개합니다. 커밋되지 않은 변경 사항이 있으면 먼저 stash하라는 메시지가 표시됩니다.
• /teleport 사용: 기존 CLI 세션 내에서 /teleport(또는 /tp)를 실행하여 Claude Code를 다시 시작하지 않고 동일한 세션 선택기를 엽니다.
• /tasks에서: /tasks를 실행하여 백그라운드 세션을 보고 t를 눌러 하나로 텔레포트합니다
• 웹 인터페이스에서: Open in CLI를 선택하여 터미널에 붙여넣을 수 있는 명령을 복사합니다

​

텔레포트 요구 사항

​

--teleport를 사용할 수 없음

​

세션 작업

​

컨텍스트 관리

​

변경 사항 검토

​

세션 공유

​

Enterprise 또는 Team 계정에서 공유

​

Max 또는 Pro 계정에서 공유

​

세션 보관

​

세션 삭제

• 사이드바에서: 보관된 세션을 필터링한 다음 삭제할 세션 위에 마우스를 올리고 삭제 아이콘을 선택합니다
• 세션 메뉴에서: 세션을 열고 세션 제목 옆의 드롭다운을 선택한 다음 Delete를 선택합니다

​

Pull request 자동 수정

• 웹에서 Claude Code로 생성된 PR: CI 상태 표시줄을 열고 Auto-fix를 선택합니다
• 터미널에서: PR의 분기에 있는 동안 /autofix-pr을 실행합니다. Claude Code가 gh로 열린 PR을 감지하고, 웹 세션을 생성하고, 한 단계에서 자동 수정을 켭니다
• 모바일 앱에서: Claude에 PR을 자동 수정하도록 지시합니다. 예를 들어 “watch this PR and fix any CI failures or review comments”
• 기존 PR: PR URL을 세션에 붙여넣고 Claude에 자동 수정하도록 지시합니다

​

Claude가 PR 활동에 응답하는 방식

• 명확한 수정: Claude가 수정에 확신하고 이전 지침과 충돌하지 않으면 Claude가 변경을 수행하고, 푸시하고, 세션에서 수행한 작업을 설명합니다
• 모호한 요청: 검토자의 주석을 여러 방식으로 해석할 수 있거나 아키텍처적으로 중요한 사항이 포함되면 Claude가 행동하기 전에 확인합니다
• 중복 또는 조치 불필요 이벤트: 이벤트가 중복이거나 변경이 필요 없으면 Claude가 세션에서 이를 기록하고 계속합니다

​

보안 및 격리

• 격리된 가상 머신: 각 세션은 격리된 Anthropic 관리 VM에서 실행됩니다
• 네트워크 액세스 제어: 네트워크 액세스는 기본적으로 제한되며 비활성화할 수 있습니다. 네트워크 액세스가 비활성화된 상태에서 실행할 때 Claude Code는 여전히 Anthropic API와 통신할 수 있으며, 이는 VM에서 데이터가 나갈 수 있습니다.
• 자격 증명 보호: git 자격 증명 또는 서명 키와 같은 민감한 자격 증명은 Claude Code가 있는 샌드박스 내부에 없습니다. 인증은 범위 자격 증명을 사용하는 보안 프록시를 통해 처리됩니다.
• 안전한 분석: 코드는 PR을 생성하기 전에 격리된 VM 내에서 분석 및 수정됩니다

​

문제 해결

​

세션 생성 실패

• status.claude.com에서 클라우드 세션 인시던트를 확인하세요
• 용량이 온디맨드로 프로비저닝되므로 1분 후 다시 시도하세요
• 저장소에 도달할 수 있는지 확인하세요. 연결하는 GitHub 계정은 Claude GitHub App 인증 또는 /web-setup을 통해 동기화된 gh 토큰을 통해 GitHub의 저장소에 액세스할 수 있어야 합니다. 저장소에 App을 설치할 필요는 없습니다. GitHub 인증 옵션을 참조하세요.

​

Remote Control 세션 만료 또는 액세스 거부

• 로컬에서 /login을 실행하여 자격 증명을 새로 고친 다음 다시 연결하세요
• 세션을 소유한 동일한 계정으로 로그인했는지 확인하세요
• Remote Control may not be available for this organization이 표시되면 관리자가 계획에 대해 원격 세션을 활성화하지 않았습니다

​

환경 만료

​

제한 사항

• 속도 제한: Claude Code on the web은 계정 내의 다른 모든 Claude 및 Claude Code 사용과 속도 제한을 공유합니다. 여러 작업을 병렬로 실행하면 비례적으로 더 많은 속도 제한을 소비합니다. 클라우드 VM에 대한 별도의 컴퓨팅 요금은 없습니다.
• 저장소 인증: 웹에서 로컬로 세션을 이동할 때 동일한 계정으로 인증된 경우에만 가능합니다
• 플랫폼 제한: 저장소 복제 및 pull request 생성에는 GitHub가 필요합니다. 자체 호스팅 GitHub Enterprise Server 인스턴스는 Team 및 Enterprise 플랜에서 지원됩니다. GitLab, Bitbucket 및 기타 비 GitHub 저장소는 로컬 번들로 클라우드 세션에 보낼 수 있지만 세션이 원격으로 결과를 다시 푸시할 수 없습니다
• 조직 IP 허용 목록: 클라우드 세션은 네트워크에서가 아닌 Anthropic 관리 인프라에서 Anthropic API를 호출합니다. 조직에 IP 허용 목록이 활성화되어 있으면 모든 클라우드 세션이 인증 오류로 실패합니다. 동일하게 Code Review 및 Routines에 적용됩니다. Anthropic 지원에 문의하여 조직의 IP 허용 목록에서 Anthropic 호스팅 서비스를 제외하세요.

​

관련 리소스

• Ultraplan: 클라우드 세션에서 계획을 작성하고 브라우저에서 검토합니다
• Ultrareview: 클라우드 샌드박스에서 심층 다중 에이전트 코드 검토를 실행합니다
• Routines: 일정에 따라, API 호출을 통해 또는 GitHub 이벤트에 응답하여 작업을 자동화합니다
• Hooks 구성: 세션 수명 주기 이벤트에서 스크립트를 실행합니다
• 설정 참조: 모든 구성 옵션
• 보안: 격리 보장 및 데이터 처리
• 데이터 사용: Anthropic이 클라우드 세션에서 보유하는 것