Cmd. /web-setup
로컬 gh CLI 자격 증명으로 GitHub 계정을 Claude Code on the web에 연결하는 명령
핵심 요약
/web-setup은 로컬ghCLI 자격 증명으로 GitHub 계정을 Claude Code on the web에 연결하는 명령입니다./schedule은 GitHub가 연결돼 있지 않으면 알아서 이 연결을 요청합니다. 미리 한 번 실행해 두면 흐름이 끊기지 않습니다.- 인자·별칭이 없는 CLI 내장 명령이며, 로컬
gh가 로그인되어 있어야 합니다. - GitHub Enterprise·조직 SSO·repository 권한 정책에 따라 추가 승인을 받아야 할 수 있고, 웹 접근 권한이 있는 플랜·환경에서만 의미가 있습니다.
명령어 원본 선언
/web-setup공식 설명 요약
/web-setup은 로컬 gh CLI 자격 증명을 사용해 GitHub 계정을 Claude Code on the web에 연결하는 명령입니다.
공식 문서의 표현 그대로 옮기면 다음과 같습니다.
Connect your GitHub account to Claude Code on the web using your local
ghCLI credentials./scheduleprompts for this automatically if GitHub isn't connected.
웹 기반 PR 자동 수정·routine·원격 세션을 쓰기 전에 GitHub 연결 상태를 맞춰 두는 준비 단계입니다. /schedule은 GitHub가 연결돼 있지 않으면 알아서 이 연결을 요청합니다. /web-setup을 미리 한 번 실행해 두면 이후 흐름이 끊기지 않습니다.
별도 인자나 별칭(alias)은 없으며, 번들 Skill이나 Workflow가 아닌 CLI 내장(built-in) 명령으로 분류됩니다.
최소 지원 버전
- 현재 공식
Commands문서에 내장 명령으로 포함되어 있습니다. 공식 문서에 별도의 최소 버전 표기는 없으며, 공개 Changelog에서도 최초 도입 버전이 명시적으로 확인되지 않았습니다.
사용법
/web-setup- 인자를 받지 않습니다. 메시지 맨 앞에서
/web-setup만 입력하면 실행됩니다.
좋은 사용 예
/autofix-pr또는 routine을 쓰기 전 GitHub 연결 점검- 새 개발 장비에서 Claude Code on the web 권한을 빠르게 맞춤
- 조직 SSO/권한 변경 이후 연결 재검증
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/web-setup | 웹 세션용 GitHub 연결 준비 (gh 자격 증명 사용) | 원격 PR/웹 자동화 전 |
/autofix-pr [prompt] | 현재 브랜치 PR을 감시하다 CI 실패·리뷰 코멘트 시 수정 | 연결 후 CI/리뷰 수정 자동화 |
/schedule [description] | routine 생성·수정·조회·실행 (별칭 /routines) | 반복 자동화 구성 |
/install-github-app | repository에 Claude GitHub Actions 앱 설정 | repository app 통합 설정 |
/schedule은 GitHub 연결이 없으면 내부적으로 /web-setup을 먼저 요청하므로 두 명령은 짝을 이룹니다. /autofix-pr 역시 gh CLI와 Claude Code on the web 접근 권한이 있어야 동작합니다.
활용 사례
- 팀 onboarding 체크리스트에 GitHub 연결 확인 추가
- PR 자동 수정 기능 사용 전 권한 오류 예방
- routine(
/schedule) 설정 흐름이 GitHub 연결 단계에서 멈추지 않도록 사전 연결
주의사항
- 로컬
ghCLI가 로그인되어 있어야 합니다. 로그인 자격 증명을 그대로 사용해 웹 연결을 구성합니다. - GitHub Enterprise, 조직 SSO, repository 권한 정책에 따라 추가 승인이 필요할 수 있습니다.
- Claude Code on the web 접근 권한이 있는 플랜·환경에서만 의미가 있습니다. 표시 여부는 플랫폼·플랜·환경에 따라 달라질 수 있습니다.
출처
- Commands: https://code.claude.com/docs/en/commands
- Claude Code on the web (Quickstart, 터미널에서 연결): https://code.claude.com/docs/en/web-quickstart