웹의 Claude Code는 Pro, Max, Team 사용자와 프리미엄 시트 또는 Chat + Claude Code 시트가 있는 Enterprise 사용자를 위한 연구 미리보기 상태입니다.
- 병렬 작업: 여러 개의 독립적인 작업을 동시에 실행하며, 각각 자신의 세션과 브랜치에서 실행되고, 여러 worktrees를 관리할 필요가 없습니다
- 로컬에 없는 저장소: Claude는 매 세션마다 저장소를 새로 복제하므로, 체크아웃할 필요가 없습니다
- 자주 조정할 필요가 없는 작업: 잘 정의된 작업을 제출하고, 다른 작업을 하고, Claude가 완료되면 결과를 검토합니다
- 코드 질문 및 탐색: 로컬 체크아웃 없이 코드베이스를 이해하거나 기능이 어떻게 구현되는지 추적합니다
세션이 실행되는 방식
작업을 제출할 때:- 복제 및 준비: 저장소가 Anthropic 관리 VM으로 복제되고, 구성된 경우 설정 스크립트가 실행됩니다.
- 네트워크 구성: 인터넷 접근은 환경의 접근 수준에 따라 설정됩니다.
- 작업: Claude는 코드를 분석하고, 변경 사항을 만들고, 테스트를 실행하고, 작업을 확인합니다. 전체 과정을 지켜보고 조정할 수 있거나, 물러나 있다가 완료되면 돌아올 수 있습니다.
- 브랜치 푸시: Claude가 중지점에 도달하면, 브랜치를 GitHub로 푸시합니다. 차이를 검토하고, 인라인 댓글을 남기고, PR을 생성하거나, 계속 진행하도록 다른 메시지를 보냅니다.
Claude Code를 실행하는 방법 비교
Claude Code는 모든 곳에서 동일하게 작동합니다. 변경되는 것은 코드가 실행되는 위치와 로컬 구성을 사용할 수 있는지 여부입니다. Desktop 앱은 로컬 및 클라우드 세션을 모두 제공하므로, 아래의 답변은 선택한 것에 따라 달라집니다:| 웹에서 | Remote Control | Terminal CLI | Desktop 앱 | |
|---|---|---|---|---|
| 코드 실행 위치 | Anthropic 클라우드 VM | 사용자의 머신 | 사용자의 머신 | 사용자의 머신 또는 클라우드 VM |
| 채팅 위치 | claude.ai 또는 모바일 앱 | claude.ai 또는 모바일 앱 | 터미널 | Desktop UI |
| 로컬 구성 사용 | 아니오, 저장소만 | 예 | 예 | 로컬의 경우 예, 클라우드의 경우 아니오 |
| GitHub 필요 | 예, 또는 --remote를 통해 로컬 저장소 번들 | 아니오 | 아니오 | 클라우드 세션의 경우만 |
| 연결 해제 시 계속 실행 | 예 | 터미널이 열려 있는 동안 | 아니오 | 세션 유형에 따라 다름 |
| 권한 모드 | 편집 자동 수락, Plan | 요청, 편집 자동 수락, Plan | 모든 모드 | 세션 유형에 따라 다름 |
| 네트워크 접근 | 환경별로 구성 가능 | 머신의 네트워크 | 머신의 네트워크 | 세션 유형에 따라 다름 |
GitHub 연결 및 환경 생성
설정은 일회성 프로세스입니다. 이미 GitHub CLI를 사용하는 경우, 브라우저 대신 터미널에서 이를 수행할 수 있습니다.claude.ai/code 방문
claude.ai/code로 이동하고 Anthropic 계정으로 로그인합니다.
Claude GitHub 앱 설치
로그인 후, claude.ai/code는 GitHub를 연결하도록 요청합니다. 프롬프트를 따라 Claude GitHub 앱을 설치하고 저장소에 대한 접근을 허용합니다. 클라우드 세션은 기존 GitHub 저장소와 함께 작동하므로, 새 프로젝트를 시작하려면 먼저 GitHub에서 빈 저장소를 생성합니다.
환경 생성
GitHub를 연결한 후, 클라우드 환경을 생성하도록 요청받습니다. 환경은 세션 중에 Claude가 가진 네트워크 접근 권한과 새 세션이 생성될 때 실행되는 것을 제어합니다. 구성 없이 사용 가능한 것은 설치된 도구를 참조합니다.양식에는 다음 필드가 있습니다:
- 이름: 표시 레이블입니다. 다양한 프로젝트 또는 접근 수준을 위해 여러 환경이 있을 때 유용합니다.
- 네트워크 접근: 세션이 인터넷에서 도달할 수 있는 것을 제어합니다. 기본값인
Trusted는 npm, PyPI, RubyGems와 같은 일반적인 패키지 레지스트리에 대한 연결을 허용하면서 일반 인터넷 접근을 차단합니다. - 환경 변수:
.env형식의 모든 세션에서 사용 가능한 선택적 변수입니다. 따옴표가 값의 일부로 저장되므로 값을 따옴표로 감싸지 마십시오. 이 환경을 편집할 수 있는 모든 사람에게 표시됩니다. - 설정 스크립트: Claude Code가 시작되기 전에 실행되는 선택적 Bash 스크립트입니다.
apt install -y gh와 같이 클라우드 VM에 포함되지 않은 시스템 도구를 설치하는 데 사용합니다. 결과는 캐시됨이므로, 스크립트는 매 세션마다 다시 실행되지 않습니다. 예제 및 디버깅 팁은 설정 스크립트를 참조합니다.
터미널에서 연결
이미 GitHub CLI(gh)를 사용하는 경우, 브라우저를 열지 않고 웹에서 Claude Code를 설정할 수 있습니다. 이는 Claude Code CLI가 필요합니다. /web-setup은 로컬 gh 토큰을 읽고, Claude 계정에 연결하고, 아직 없는 경우 기본 클라우드 환경을 생성합니다.
Zero Data Retention이 활성화된 조직은
/web-setup 또는 기타 클라우드 세션 기능을 사용할 수 없습니다. GitHub CLI가 설치되지 않았거나 인증되지 않은 경우, /web-setup은 브라우저 온보딩 흐름을 대신 엽니다./web-setup 실행
Claude Code CLI에서 다음을 실행합니다:이는
gh 토큰을 Claude 계정과 동기화합니다. 아직 클라우드 환경이 없는 경우, /web-setup은 Trusted 네트워크 접근 및 설정 스크립트 없이 환경을 생성합니다. 나중에 환경을 편집하거나 변수를 추가할 수 있습니다. /web-setup이 완료되면, 터미널에서 --remote를 사용하여 클라우드 세션을 시작하거나 /schedule을 사용하여 반복 작업을 설정할 수 있습니다.작업 시작
GitHub가 연결되고 환경이 생성되면, 작업을 제출할 준비가 되었습니다.저장소 및 브랜치 선택
claude.ai/code 또는 Claude 모바일 앱의 Code 탭에서, 입력 상자 아래의 저장소 선택기를 클릭하고 Claude가 작업할 저장소를 선택합니다. 각 저장소는 브랜치 선택기를 표시합니다. 기본값 대신 기능 브랜치에서 Claude를 시작하도록 변경합니다. 한 세션에서 여러 저장소를 추가하여 작업할 수 있습니다.
권한 모드 선택
입력 옆의 모드 드롭다운은 기본값으로 편집 자동 수락이며, Claude는 승인을 기다리지 않고 변경 사항을 만들고 브랜치를 푸시합니다. Claude가 접근 방식을 제안하고 파일을 편집하기 전에 승인을 기다리도록 하려면 Plan mode로 전환합니다. 클라우드 세션은 Ask 권한, Auto 모드 또는 Bypass 권한을 제공하지 않습니다. 전체 목록은 권한 모드를 참조합니다.
세션 미리 채우기
claude.ai/code URL에 쿼리 매개변수를 추가하여 새 세션의 프롬프트, 저장소 및 환경을 미리 채울 수 있습니다. 이를 사용하여 문제 추적기의 버튼과 같은 통합을 구축하여 문제 설명을 프롬프트로 하여 Claude Code를 엽니다.| 매개변수 | 설명 |
|---|---|
prompt | 입력 상자에 미리 채울 프롬프트 텍스트입니다. 별칭 q도 허용됩니다. |
prompt_url | 쿼리 문자열에 포함하기에 너무 긴 프롬프트 텍스트를 가져올 URL입니다. URL은 교차 출처 요청을 허용해야 합니다. prompt도 설정된 경우 무시됩니다. |
repositories | 미리 선택할 owner/repo 슬러그의 쉼표로 구분된 목록입니다. 별칭 repo도 허용됩니다. |
environment | 미리 선택할 환경의 이름 또는 ID입니다. |
검토 및 반복
Claude가 완료되면, 변경 사항을 검토하고, 특정 줄에 피드백을 남기고, 차이가 올바를 때까지 계속합니다.차이 보기 열기
차이 표시기는 세션 전체에서 추가되고 제거된 줄을 표시합니다(예:
+42 -18). 이를 선택하여 차이 보기를 열고, 왼쪽에 파일 목록이 있고 오른쪽에 변경 사항이 있습니다.인라인 댓글 남기기
차이의 모든 줄을 선택하고, 피드백을 입력하고, Enter를 누릅니다. 댓글은 다음 메시지를 보낼 때까지 대기열에 있다가 함께 번들로 제공됩니다. Claude는 주요 지침과 함께 “
src/auth.ts:47에서 여기서 오류를 포착하지 마십시오”를 보므로, 문제가 있는 위치를 설명할 필요가 없습니다.풀 요청 생성
차이가 올바르면, 차이 보기 상단에서 PR 생성을 선택합니다. 전체 PR로 열거나, 초안으로 열거나, 생성된 제목 및 설명과 함께 GitHub의 작성 페이지로 이동할 수 있습니다.
PR 후 계속 반복
PR이 생성된 후 세션이 활성 상태로 유지됩니다. CI 실패 출력 또는 검토자 댓글을 채팅에 붙여넣고 Claude에게 이를 해결하도록 요청합니다. Claude가 PR을 자동으로 모니터링하도록 하려면, 자동 수정 풀 요청을 참조합니다.
설정 문제 해결
GitHub 연결 후 저장소가 나타나지 않음
Claude GitHub 앱은 사용하려는 각 저장소에 대한 명시적 접근이 필요합니다. github.com에서 Settings → Applications → Claude → Configure를 열고 저장소가 Repository access 아래에 나열되어 있는지 확인합니다. 비공개 저장소는 공개 저장소와 동일한 권한이 필요합니다.페이지에 GitHub 로그인 버튼만 표시됨
클라우드 세션은 연결된 GitHub 계정이 필요합니다. 위의 브라우저 흐름을 통해 연결하거나, GitHub CLI를 사용하는 경우 터미널에서/web-setup을 실행합니다. GitHub를 연결하지 않으려면, Remote Control을 참조하여 자신의 머신에서 Claude Code를 실행하고 웹에서 모니터링합니다.
”선택한 조직에서 사용할 수 없음”
Enterprise 조직은 관리자가 웹에서 Claude Code를 활성화해야 할 수 있습니다. Anthropic 계정 팀에 문의합니다./web-setup이 “Unknown command” 반환
/web-setup은 셸이 아닌 Claude Code CLI 내부에서 실행됩니다. 먼저 claude를 시작한 다음, 프롬프트에서 /web-setup을 입력합니다.
Claude Code 내부에 입력했는데도 오류가 표시되면, CLI가 v2.1.80보다 오래되었거나 API 키 또는 타사 공급자 대신 claude.ai 구독으로 인증되었습니다. claude update를 실행한 다음, /login을 실행하여 claude.ai 계정으로 로그인합니다.
--remote 또는 ultraplan 사용 시 “클라우드 환경을 생성할 수 없음” 또는 “사용 가능한 클라우드 환경 없음”
원격 세션 기능은 아직 없는 경우 기본 클라우드 환경을 자동으로 생성합니다. “클라우드 환경을 생성할 수 없음”이 표시되면, 자동 생성이 실패했습니다. “사용 가능한 클라우드 환경 없음”이 표시되면, CLI가 자동 생성보다 앞서 있습니다. 어느 경우든, Claude Code CLI에서 /web-setup을 실행하여 수동으로 생성하거나, claude.ai/code를 방문하고 위의 환경 생성 단계를 따릅니다.
설정 스크립트 실패
설정 스크립트가 0이 아닌 상태로 종료되어 세션 시작을 차단합니다. 일반적인 원인:- 레지스트리가 네트워크 접근 수준에 없어서 패키지 설치가 실패했습니다.
Trusted는 대부분의 패키지 관리자를 포함합니다.None은 모두 차단합니다. - 스크립트가 신선한 복제에 존재하지 않는 파일 또는 경로를 참조합니다.
- 로컬에서 작동하는 명령이 Ubuntu에서 다른 호출이 필요합니다.
set -x를 추가하여 어느 명령이 실패했는지 확인합니다. 중요하지 않은 명령의 경우, || true를 추가하여 세션 시작을 차단하지 않도록 합니다.
탭을 닫은 후 세션이 계속 실행됨
이는 의도된 동작입니다. 탭을 닫거나 다른 곳으로 이동해도 세션이 중지되지 않습니다. Claude가 현재 작업을 완료한 다음 유휴 상태가 될 때까지 백그라운드에서 계속 실행됩니다. 사이드바에서, 세션을 보관하여 목록에서 숨기거나, 삭제하여 영구적으로 제거할 수 있습니다.다음 단계
이제 작업을 제출하고 검토할 수 있으므로, 이 페이지들은 다음에 올 것을 다룹니다: 터미널에서 클라우드 세션 시작, 반복 작업 예약, Claude에게 상시 지침 제공.- 웹에서 Claude Code 사용: 터미널로 세션 텔레포트, 설정 스크립트, 환경 변수, 네트워크 구성을 포함한 전체 참조
- Routines: 일정에 따라, API 호출을 통해, 또는 GitHub 이벤트에 응답하여 작업을 자동화합니다
- CLAUDE.md: 모든 세션의 시작 시 로드되는 지속적인 지침 및 컨텍스트를 Claude에게 제공합니다
- iOS 또는 Android용 Claude 모바일 앱을 설치하여 휴대폰에서 세션을 모니터링합니다. Claude Code CLI에서,
/mobile은 QR 코드를 표시합니다.