목차
- Claude Code 웹 버전 사용법 — 접속과 플랜 확인
- GitHub 연동 — App 설치와 /web-setup 두 가지 방식
- 클라우드 환경 생성과 Claude Code 웹 버전 사용법 핵심 설정
- –remote로 Claude Code 웹 병렬 작업 실행
- diff 리뷰와 PR 생성 워크플로우
- –teleport와 Remote Control — 로컬 ↔ 웹 연계
- 웹 버전 운용 시 참고 사항
claude --remote "Fix the authentication bug in src/auth/login.ts"이 명령은 --remote 플래그로 클라우드 세션을 생성하고, 브라우저를 닫아도 작업이 계속 실행되도록 한다. 로컬 터미널에 Claude Code CLI를 설치하지 않아도 claude.ai/code에 접속하면 브라우저만으로 동일한 기능을 사용할 수 있다.
💡 관련 상품: 노트북
이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다.
Claude Code 웹 버전 사용법 — 접속과 플랜 확인
Claude Code는 터미널, IDE, 데스크톱 앱, 브라우저에서 사용할 수 있는 에이전틱 코딩 도구다. 웹 버전은 로컬 설정 없이 브라우저에서 실행되며, 장시간 작업을 맡기고 나중에 확인하거나 여러 작업을 병렬로 실행할 수 있다.
접속 주소는 claude.ai/code다. 현재 research preview 상태이며, Pro, Max, Team 사용자와 premium seats 또는 Chat + Claude Code seats를 가진 Enterprise 사용자가 사용할 수 있다.
💡 관련 상품: ai
이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다.
Free 플랜 사용자를 위한 대안이나 우회 방법에 대한 공식 안내는 없다. 웹 버전을 사용하려면 Pro 이상 플랜이 필요하다.
GitHub 연동 — App 설치와 /web-setup 두 가지 방식
GitHub 인증은 두 가지 방식을 지원한다. 팀 환경이냐 개인 개발이냐에 따라 선택이 달라진다.
Claude GitHub App 설치 (팀용)
리포지토리별로 Claude GitHub App을 설치하는 방식이다. Auto-fix PR 기능을 사용하려면 이 방식이 필수다. Claude Code 웹 퀵스타트 가이드에 따르면 첫 프로젝트 생성 시 GitHub App 설치 및 리포지토리 접근 권한 부여를 안내한다.
/web-setup 명령 (개인용)
터미널에서 /web-setup을 실행하면 로컬 gh CLI 토큰을 동기화한다. 개인 개발자에게 적합한 방식이다.
/web-setup이 명령으로 로컬의 GitHub 인증 정보가 클라우드 세션에 연결된다. v2.1.101(2026-04-10) 기준으로 /web-setup 없이도 기본 클라우드 환경을 자동 생성하도록 개선되었지만, 기존 리포지토리에 세밀한 접근 권한이 필요하면 여전히 App 설치 방식이 안정적이다.
| 방식 | 대상 | Auto-fix PR | 설정 난이도 |
|---|---|---|---|
| GitHub App 설치 | 팀, 조직 리포 | 지원 | 중간 (관리자 권한 필요) |
| /web-setup | 개인 개발자 | 미지원 | 낮음 (CLI 한 줄) |
클라우드 환경 생성과 Claude Code 웹 버전 사용법 핵심 설정
퀵스타트 절차는 세 단계다. claude.ai/code 접속 후 로그인 → Claude GitHub App 설치 및 리포지토리 접근 권한 부여 → 클라우드 환경 생성이다. 환경 생성 시 이름, 네트워크 접근, 환경 변수, 셋업 스크립트를 설정한다. 첫 프로젝트는 기본값으로 생성해도 된다.
VM 스펙
클라우드 세션의 VM에는 개발에 필요한 주요 런타임이 사전 설치되어 있다.
Python 3.x — pip, poetry, uv, pytest, ruff
Node.js 20/21/22 — npm, yarn, pnpm, bun
Ruby 3.1-3.3
PHP 8.4
Java OpenJDK 21
Go, Rust, Docker
PostgreSQL 16, Redis 7.0리소스 제한은 4 vCPU, 16GB RAM, 30GB 디스크다. 단일 마이크로서비스 수준의 프로젝트에는 충분하지만, 대규모 모노레포 빌드에는 빠듯할 수 있다. 빌드 자체를 클라우드에서 하기보다 코드 수정과 테스트에 초점을 맞추는 편이 낫다.
클라우드 세션의 정확한 타임아웃이나 유휴 시간 제한은 공식 문서에 명시되어 있지 않다. 장시간 방치 시 세션이 정리될 가능성을 감안해서 중간중간 결과를 커밋해두는 게 안전하다.
네트워크 접근은 4단계로 제어된다.
| 레벨 | 설명 | 용도 |
|---|---|---|
| None | 모든 외부 접근 차단 | 보안 민감 코드 |
| Trusted | 패키지 레지스트리·GitHub 등 허용 목록만 | 기본값, 대부분의 개발 |
| Full | 모든 도메인 허용 | 외부 API 연동 테스트 |
| Custom | 사용자 정의 허용 목록 | 특정 내부 서비스 접근 |
기본값은 Trusted이며 npm, PyPI, RubyGems, crates.io 등 주요 패키지 레지스트리가 포함된다. 외부 API를 호출하는 테스트가 필요하면 Full로 바꾸거나, Custom으로 특정 도메인만 열면 된다. Trusted는 패키지 설치는 허용하되 임의의 외부 호출은 차단하므로, 보안과 편의 사이에서 합리적인 기본값이다.
–remote로 Claude Code 웹 병렬 작업 실행
--remote 플래그의 핵심은 병렬 실행이다. 각 명령이 독립된 클라우드 세션을 생성하므로 여러 작업을 동시에 돌릴 수 있다.
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"이 세 줄을 연속으로 실행하면 세 개의 독립 세션이 각각 돌아간다. 로컬에서 plan 모드로 전략을 수립한 뒤 --remote로 클라우드에서 자율 실행하는 패턴이 Claude Code 공식 웹 문서에서 권장된다.
테스트 수정, 문서 업데이트, 리팩토링처럼 서로 의존성이 없는 작업을 동시에 맡기면 효율이 올라간다. 의존성이 있는 작업은 순차적으로 실행하는 편이 충돌을 줄인다.
diff 리뷰와 PR 생성 워크플로우
작업 결과 리뷰 시 diff 뷰에서 인라인 코멘트를 남길 수 있다. Create PR 버튼으로 풀 PR 또는 드래프트 PR을 생성할 수 있다.
PR 생성 후에도 세션이 유지된다는 점이 중요하다. CI 실패 출력이나 리뷰어 코멘트를 붙여넣고 수정 요청이 가능하다. 일반적인 워크플로우는 다음 순서를 따른다:
작업 지시 → Claude 실행 → diff 확인 → 인라인 코멘트
→ Create PR (풀 또는 드래프트) → CI 결과 확인
→ 실패 시 세션에 CI 로그 붙여넣기 → 재수정Auto-fix 기능(CI 실패 자동 수정)의 구체적 동작 사례에 대한 공식 튜토리얼은 아직 없다. GitHub App 설치가 필수 조건이라는 것만 확인된 상태다.
–teleport와 Remote Control — 로컬 ↔ 웹 연계
웹에서 시작한 작업을 로컬 터미널로 가져오려면 --teleport를 사용한다. 반대로 터미널에서 클라우드 세션을 시작하려면 --remote를 쓴다. Remote Control 기능으로 로컬 CLI 세션을 웹에서 모니터링하는 것도 가능하다.
# 터미널에서 클라우드 세션 시작
claude --remote "Fix the authentication bug in src/auth/login.ts"
# 웹에서 시작한 작업을 로컬로 가져오기
claude --teleport두 명령의 방향이 반대다:
--remote: 로컬 → 클라우드 방향. 작업을 클라우드에 올려서 실행--teleport: 클라우드 → 로컬 방향. 웹에서 진행 중인 세션을 로컬로 가져옴
활용 시나리오로 보면, 웹에서 Claude가 코드를 수정하고 PR까지 만든 상태에서 로컬 환경에서 직접 테스트를 돌려볼 때 --teleport로 해당 세션의 변경사항을 가져온다. 반대로 시간이 오래 걸리는 리팩토링은 --remote로 클라우드에 넘기고 로컬 터미널을 다른 작업에 사용하면 된다.
웹 버전 운용 시 참고 사항
Claude Code 웹 버전 운용에서 알아두면 유용한 세 가지 포인트가 있다.
첫째, 웹 버전에서의 MCP 서버 설정 실전 예제는 아직 공식 문서에 부족하다. MCP 연동이 필요하면 당분간 로컬 CLI에서 설정하는 편이 확실하다.
둘째, Claude Code 기능 개요를 보면 웹 버전은 “장시간 작업을 맡기고 나중에 확인”하는 비동기 패턴에 최적화되어 있다. 실시간으로 한 줄씩 확인하면서 작업하려면 로컬 CLI나 IDE 통합이 더 적합하다. 빠른 피드백이 필요하면 로컬, 방치형 작업이면 웹으로 선택하면 된다.
셋째, 네트워크 접근 제어의 Custom 레벨은 내부 API 서버나 사내 레지스트리에 접근해야 할 때 유용하다. Trusted 기본값으로 시작하고, 필요할 때만 도메인을 추가하는 방식이 보안상 합리적이다.
Claude Code GitHub 연동 설정이나 Claude Code teleport 활용법, Claude Code Pro Max 플랜별 차이점도 함께 파악해두면 워크플로우 구성에 도움이 된다.
관련 글
- Claude Code LSP 설정 완전 가이드 — TypeScript·Python 언어 서버 5단계 연동 – Claude Code에서 LSP를 설정하면 코드 컨텍스트 파악 정확도가 올라가고 토큰 소비가 줄어든다. TypeScript와 Python …
- Claude Code 자동화 시스템 구축 7단계: 스킬·훅·배치 실전 아키텍처 – Claude Code로 반복 업무를 자동화하는 시스템을 만든다. 커스텀 스킬, 훅, 배치 처리, MCP 서버 연동까지 실전에서 쓰는 구조를…