웹에서 Claude Code 시작하기

기준일: 2026-07-26
난이도: 초급
공식 기준: Get started with Claude Code on the web

브라우저·폰에서 Claude Code를 클라우드로 실행합니다. GitHub 저장소를 연결하고 작업을 제출한 뒤, 로컬 설정 없이 PR을 리뷰합니다.

Research preview: Pro, Max, Team, 그리고 premium 또는 Chat+Claude Code 좌석의 Enterprise.

개요

• 실행 위치: Anthropic 관리 클라우드 인프라 (claude.ai/code / 모바일 앱)
• GitHub 저장소 필요(또는 --cloud으로 로컬 번들). 매 세션 클론 → 변경 → 브랜치 푸시
• 세션은 기기 간 유지 (노트북에서 시작 → 폰에서 리뷰)

잘 맞는 경우

• 병렬 독립 작업(세션·브랜치 분리, worktree 관리 불필요)
• 로컬에 없는 저장소
• 자주 조향할 필요 없는 명확한 작업
• 코드 Q&A·탐색

로컬 설정·도구가 필요하면 로컬 CLI 또는 Remote Control.

핵심 개념

세션 흐름

1. Clone and prepare — 저장소 클론, setup script 실행(설정 시)
2. Configure network — 환경의 access level
3. Work — 분석·수정·테스트·조향 가능
4. Push branch — 중지점에서 브랜치 푸시 → diff·인라인 코멘트·PR·추가 메시지

브랜치 푸시 후에도 세션은 닫히지 않습니다.

실행 표면 비교

	On the web	Remote Control	Terminal CLI	Desktop
코드 실행	Anthropic 클라우드 VM	내 머신	내 머신	로컬 또는 클라우드
채팅 UI	claude.ai / 모바일	claude.ai / 모바일	터미널	Desktop UI
로컬 config	아니오(repo only)	예	예	로컬:예 / 클라우드:아니오
GitHub	예(또는 --cloud 번들)	아니오	아니오	클라우드 세션만
연결 끊김 후 계속	예	터미널 열린 동안	아니오	세션 타입 의존
Permission modes	Accept edits, Plan, Auto	Manual, Accept edits, Plan	전부	세션 타입 의존
네트워크	환경별 설정	머신 네트워크	머신 네트워크	세션 타입 의존

상세

GitHub 연결·환경 생성 (1회)

1. claude.ai/code 로그인
2. Claude GitHub App 설치·저장소 권한
3. 클라우드 환경 생성:

필드	설명
Name	표시 이름
Network access	기본 Trusted = 주요 패키지 레지스트리 허용, 일반 인터넷 차단
Environment variables	.env 형식(따옴표 넣지 말 것 — 값에 포함됨). 편집 가능자에게 노출
Setup script	Claude 시작 전 Bash. 캐시되어 매 세션 재실행 안 함

터미널에서 연결 (/web-setup)

요구: Claude Code CLI + gh 인증.

gh auth login
# claude 세션에서
/login
/web-setup

• gh 토큰을 Claude 계정에 동기화, 없으면 Trusted 기본 환경 생성
• 이후 --cloud, /schedule 등
• Zero Data Retention 조직은 /web-setup·클라우드 세션 사용 불가
• gh 없으면 브라우저 온보딩으로 폴백

작업 시작

1. 저장소·브랜치 선택 (다중 저장소 가능)
2. 권한 모드: 기본 Accept edits, 계획 후 승인하려면 Plan. Manual/Bypass 없음
3. 구체적 태스크 서술 (파일·함수명, 에러 출력, 기대 동작)

각 작업 = 독립 세션·브랜치.

URL 프리필

파라미터	설명
prompt / q	입력 프리필
prompt_url	긴 프롬프트 fetch (CORS 허용 URL; prompt 있으면 무시)
repositories / repo	owner/repo 콤마 목록
environment	환경 이름/ID

예: https://claude.ai/code?prompt=Fix%20the%20login%20bug&repositories=acme/webapp

리뷰·반복

1. diff 표시(+42 -18 등) 클릭
2. 줄 단위 인라인 코멘트 → 다음 메시지와 함께 전달
3. Create PR (정식/draft/GitHub compose)
4. PR 후에도 세션 유지 — CI 실패·리뷰 코멘트 붙여 계속. Auto-fix는 별도 문서

트러블슈팅

증상	조치
저장소 목록 비어 있음	GitHub 계정 접근 권한 확인. Auto-fix용 App 설치는 Settings→Applications→Claude
GitHub 로그인 버튼만	브라우저 연결 또는 /web-setup. 대안 Remote Control
Not available for organization	Enterprise Owner/영업팀에 웹 활성화 요청
/web-setup Unknown	CLI 안에서 실행. claude.ai 구독 로그인 필요(API key/서드파티만이면 숨김). Team/Enterprise: 관리자 비활성·ZDR
No cloud environment	/web-setup 또는 claude.ai/code에서 환경 생성
Setup script failed	Trusted/None 네트워크, 경로 존재, Ubuntu 호환. set -x, 비중요 명령 || true
setup 중 hang/timeout	캐시 빌드 ~5분. 병렬 install, 대용량은 SessionStart hook 백그라운드, 긴 sleep 제거
탭 닫아도 계속 실행	설계상. archive/delete로 목록 관리

체크리스트

• 지원 플랜·GitHub 연결·환경을 준비했다
• 웹 vs Remote Control vs 로컬 CLI 적합 여부를 판단했다
• 첫 태스크를 구체적 파일·기대 동작으로 제출했다
• diff 인라인 코멘트·PR 생성을 확인했다

다음 단계

• Claude Code on the web — teleport, setup script, 네트워크
• Routines
• CLAUDE.md
• 모바일: iOS/Android 앱, CLI에서 /mobile QR

공식 원문: https://code.claude.com/docs/en/web-quickstart