클로드코드 /web-setup, 웹에서 내 GitHub 저장소 연결하기

클로드코드(Claude Code, AI 코딩 도구)는 터미널뿐 아니라 웹에서도 쓸 수 있어요. 그런데 웹에서 내 코드 저장소로 작업하려면, 먼저 내 GitHub 계정과 연결해줘야 해요. 그 연결을 해주는 명령이 /web-setup이에요.

정의 (뭐냐면)

/web-setup은 웹용 클로드코드에 GitHub 계정을 연결하는 명령이에요.

• GitHub(깃허브): 코드를 온라인에 저장하고 버전을 관리하는 대표적인 서비스예요. 내 프로젝트(저장소, repository)가 여기에 올라가 있어요.
• 연결(연동): 클로드코드가 내 GitHub 저장소를 읽고 다룰 수 있게 권한을 이어주는 거예요. 이게 돼 있어야 웹에서 내 코드를 불러와 작업할 수 있어요.

어떻게 쓰나 (난이도별)

기초 — GitHub 연결하기

/web-setup

실행하면 GitHub 계정을 연결하는 절차로 안내해요. 안내에 따라 GitHub 로그인과 권한 승인을 마치면, 웹용 클로드코드에서 내 저장소를 다룰 수 있게 돼요.

흔한 함정 (해당시만)

• 연결할 때 GitHub에서 권한 승인(어떤 저장소에 접근할지 허용하는 단계)을 묻는데, 작업할 저장소가 권한 범위에 포함됐는지 확인하세요. 특정 저장소만 허용해두면 다른 저장소는 안 보일 수 있어요.
• 회사나 팀 소유의 저장소(조직 계정)는 관리자 승인이 필요할 수 있어요. 연결이 안 되면 조직 권한 설정을 확인해보세요.

실전 사례

집 노트북이 아니라 외부에서 웹 브라우저만으로 작업해야 했던 적이 있어요. /web-setup으로 GitHub를 연결해뒀더니, 웹에서도 내 저장소를 그대로 불러와 코드를 이어 작업할 수 있었어요.

이렇게 더 씁니다

GitHub만 연결해두면 PC, 노트북, 외부 환경 어디서든 같은 저장소로 작업을 이어갈 수 있어요. 터미널 환경을 매번 새로 세팅하기 번거로운 외부 작업이나, 잠깐 짬을 내 코드를 확인할 때 특히 유용해요.

정리

/web-setup은 웹용 클로드코드에 GitHub 계정을 연결해, 어디서든 내 저장소로 작업할 수 있게 해주는 명령이에요. 권한 범위만 잘 확인하면, 장소에 얽매이지 않는 작업 환경을 만들 수 있어요.

FAQ · 자주 묻는 질문

GitHub 권한을 전부 허용해야 하나요? 불안한데요.

아니요, 권한 승인 단계에서 어떤 저장소에 접근할지 직접 고를 수 있습니다. 작업할 저장소만 권한 범위에 포함시키면 되고, 특정 저장소만 허용하면 나머지는 보이지 않아요. 연결은 클로드코드가 내 저장소를 읽고 다룰 수 있게 권한을 이어주는 것이니, 필요한 범위만 허용하는 게 안전합니다.

연결은 어떻게 시작하나요?

웹용 클로드코드에서 /web-setup을 실행하면 GitHub 계정을 연결하는 절차로 안내해 줍니다. 안내에 따라 GitHub 로그인과 권한 승인을 마치면 끝이에요. 한 번 연결해 두면 PC, 노트북, 외부 환경 어디서든 같은 저장소로 작업을 이어갈 수 있어서, 외부에서 브라우저만으로 작업할 때 특히 유용합니다.

연결했는데 저장소가 안 보이면 어떻게 하나요?

권한 범위부터 확인하세요. 특정 저장소만 허용해 뒀다면 다른 저장소는 보이지 않으니, 작업할 저장소가 승인 범위에 포함됐는지 점검하면 됩니다. 회사나 팀 소유의 조직 계정 저장소라면 관리자 승인이 필요할 수 있으므로, 연결이 안 될 때는 조직 권한 설정도 함께 확인해 보세요.

📌 함께 보면 좋은 글

• 로그인(claude auth login) — 설치 후 첫 로그인
• 데스크탑에서 작업 이어가기 — 세션 연결
• Gmail·구글시트 커넥터 연결 — 외부 앱 붙이기

기준: Claude Code v2.1.154 (2026.05)