VS Code에서 Claude Code 계정을 확인할 때는 구독 화면이나 API Key부터 만지지 마세요. 같은 VS Code 창에서 Claude Code를 열고, 필요하면 통합 터미널에서 claude를 실행한 뒤 /status를 먼저 확인합니다. 브라우저에 기억된 로그인, Console 잔액, 외부 터미널 변수보다 현재 VS Code 세션이 실제로 쓰는 경로가 중요합니다.
| 같은 VS Code 세션에서 보이는 상태 | 의미 | 첫 확인 | 다음 행동 |
|---|---|---|---|
/status가 기대한 계정과 정상 연결을 보여줌 | 현재 창이 의도한 Claude Code 세션을 사용 중 | 계정 라벨, 모델/버전, connectivity 확인 | 계속 진행하고 /usage, /cost, /stats는 보조 정보로만 사용 |
| 로그인 안 됨, 다른 계정, 오래된 세션 | 로컬 세션이 기대와 다름 | /logout, /login, 다시 /status | 경로를 증명하기 전에는 결제 해석 금지 |
| API Key, auth token, Provider, custom base URL 존재 | 구독 로그인 대신 자격 증명 경로일 수 있음 | ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, helper, provider 변수 확인 | 의도적으로 유지하거나 제거하고 VS Code를 다시 로드한 뒤 /status |
| 로컬 경로는 맞지만 요청이 넓게 실패 | 서비스 장애, 조직 제한, 권한 문제 가능성 | 현재 날짜로 Claude Status 확인, 비밀 제거 증거 수집 | 상태나 관리자 증거가 명확해질 때까지 로컬 변경 중단 |
캡처나 지원 요청에 비밀을 넣지 마세요. 공유할 수 있는 것은 /status 결과, 버전, VS Code 실행 경로, 관련 변수 이름, 오류 문구, 시간입니다. 실제 API Key, bearer token, provider secret, 전체 .env는 제외합니다.
같은 VS Code 표면에서 확인하기
계정 확인은 실제로 작업할 같은 VS Code 창에서 해야 합니다. 공식 VS Code 통합은 Spark 아이콘, Activity Bar, Command Palette, Status Bar, 통합 터미널을 제공합니다. 외부 터미널이 보는 PATH와 환경 변수는 현재 VS Code 창과 다를 수 있으므로 외부 터미널의 결과만으로는 충분하지 않습니다.
먼저 통합 터미널에서 실행합니다.
bashclaude
Claude Code 안에서 실행합니다.
text/status
/status는 계정과 경로의 첫 증거입니다. 계정, 모델/버전, 연결 상태를 같은 세션에서 보여줍니다. 확장 프로그램이 로그인되지 않았다고 말하면 /login을 실행하고 브라우저 인증을 마친 뒤 같은 창으로 돌아옵니다. 인증 창이 다시 열리지 않으면 VS Code를 새로고침합니다. 통합 터미널에서 claude --version이 동작하지 않는다면 계정 확인이 아니라 설치 또는 PATH 문제이므로 Claude Code 설치나 VS Code에서 Claude Code가 동작하지 않을 때로 이동합니다.
계정과 자격 증명 경로 해석하기
Claude Code는 Claude.ai 계정, Team/Enterprise, Console, API Key, bearer token, apiKeyHelper, Bedrock, Vertex, Foundry, 호환 gateway 등 여러 경로로 인증될 수 있습니다. 중요한 것은 로그인한 기억이 아니라 현재 VS Code 세션을 어떤 계약이 소유하는지입니다.
| 경로 신호 | 가능한 소유자 | 확인할 것 | 가정하지 말 것 |
|---|---|---|---|
| Claude.ai 로그인 | 개인 또는 플랜 계정 | 계정 라벨이 맞는지 | API 사용도 같은 플랜으로 처리됨 |
| Team/Enterprise | 조직 관리 계정 | org, workspace, repo 권한 | 개인 계정도 같은 권한을 가짐 |
| Console/API Key | API project 또는 key 소유자 | key 존재, Console Usage, project boundary | Pro/Max가 이 세션 비용을 부담함 |
ANTHROPIC_AUTH_TOKEN과 base URL | gateway 또는 proxy route | host, token, model name, trust boundary | 공식 Anthropic direct API와 같음 |
| Bedrock, Vertex, Foundry | cloud account와 region | provider credentials, region, model availability | /login이 주요 스위치임 |
구독 로그인이 증명된 뒤 결제나 한도 문제가 남으면 API Key와 구독 결제를 봅니다. API Key, gateway, provider가 보이면 Claude Code API 설정으로 변수와 settings를 점검합니다. 항상 경로가 먼저이고, 해석은 그 다음입니다.
환경 상속을 비밀 없이 확인하기
VS Code는 외부 터미널과 다른 환경에서 실행될 수 있습니다. Dock, iTerm, Windows Terminal, Git Bash, WSL, devcontainer, CI는 서로 다른 변수를 줄 수 있습니다. 값은 출력하지 말고 존재만 확인합니다.
bashtest -n "$ANTHROPIC_API_KEY" && echo "ANTHROPIC_API_KEY is set" test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set" test -n "$ANTHROPIC_BASE_URL" && echo "ANTHROPIC_BASE_URL is set"
짧게 확인할 때도 값을 가립니다.
bashenv | grep -E '^ANTHROPIC_(API_KEY|AUTH_TOKEN|BASE_URL)=' | sed 's/=.*/=set/'
이 명령은 VS Code 통합 터미널에서 실행해야 합니다. 의도한 shell 환경을 상속하려면 그 shell에서 프로젝트를 엽니다.
bashcode .
새 창에서 claude와 /status를 다시 실행합니다. 경로가 바뀌면 계정이 망가진 것이 아니라 실행 환경이 달랐던 것입니다.
다른 계정, 오래된 로그인, API Key 덮어쓰기 수정하기
한 번에 하나만 바꿉니다. 다른 계정이나 오래된 로그인은 다음 순서로 처리합니다.
text/logout /login /status
현재 shell의 API Key가 구독 로그인을 덮는 경우에는 먼저 현재 shell에서만 제거합니다.
bashunset ANTHROPIC_API_KEY claude
그 뒤 /status를 확인합니다. 새 터미널에서 key가 다시 나타난다면 shell profile, 프로젝트 .env, devcontainer, launch script, CI secret, 설정 도구를 찾아야 합니다. Provider나 gateway 경로에서는 /logout만으로 충분하지 않습니다. base URL, region, model name, credential owner를 확인합니다.
사용량 명령은 경로 확인 뒤에 사용하기
/status는 identity와 route를 답합니다. /usage, /stats, /cost는 그 다음입니다. API route 지출은 Console Usage를 기준으로 보고, subscription route는 plan limit와 local stats를 함께 봅니다. 경로를 모르는 상태에서 /cost나 Console balance만 보면 어떤 계정이 세션을 소유하는지 알 수 없습니다.
| 질문 | 첫 표면 | 이유 |
|---|---|---|
| VS Code가 지금 쓰는 계정은? | /status | 활성 세션 정보 |
| 변수가 경로를 바꾸나? | masked env check | 비밀 없이 존재 증명 |
| API 비용이 왜 생겼나? | /status, env, Console Usage | 비용은 route를 따름 |
| 지원에 무엇을 보내나? | redacted status, version, error, timestamp | 안전하고 재현 가능 |
장애나 조직 제한이면 로컬 변경 멈추기
Claude Status는 날짜가 있는 stop rule이지 로컬 계정 증거가 아닙니다. /status 이후에 넓은 실패, 로그인 루프, 서비스 측 오류가 보일 때 확인합니다. 관련 장애가 있으면 재설치, rollback, key rotation, 계정 변경을 멈춥니다. Status가 clear인데 같은 route가 실패하면 launch path, env vars, /status, logs, exact error로 돌아갑니다.
비밀 제거 증거로 에스컬레이션하기
보낼 내용은 Claude Code version, VS Code version, launch path, 비밀 제거 /status, ANTHROPIC_API_KEY 또는 ANTHROPIC_AUTH_TOKEN 존재 여부, 시도한 /login과 /logout, provider route, exact error, request id 또는 timestamp, Claude Status timestamp, 외부 터미널과 통합 터미널 차이입니다. 실제 key, bearer token, provider secret, 전체 .env, 고객 데이터, 내부 경로는 보내지 않습니다.
팀 환경과 여러 워크스페이스에서 추가로 확인할 것
회사 계정, Team, Enterprise, remote SSH, devcontainer, 여러 VS Code Profile을 쓰는 경우에는 사람의 로그인 상태와 작업 창의 자격 증명 경로를 분리해야 합니다. 브라우저에는 개인 Claude.ai 계정으로 로그인되어 있어도 VS Code 워크스페이스는 조직 API Key나 Provider token을 상속할 수 있습니다. 반대로 외부 터미널에는 key가 없어도 container, profile, launch script가 secret을 주입할 수 있습니다.
동료가 “로그인했습니다”라고 말하는 것만으로는 진단이 끝나지 않습니다. 문제가 난 VS Code 창에서 /status를 실행했는지, 같은 통합 터미널에서 ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL 존재 여부를 값 없이 확인했는지, 같은 repository, branch, remote/container, Profile에서 재현되는지 확인해야 합니다. 이 경계가 빠지면 계정 전환 문제를 권한 문제, quota 문제, provider 장애로 잘못 해석하기 쉽습니다.
| 환경 | 흔한 오해 | 추가 증거 | 처리 |
|---|---|---|---|
| 여러 VS Code Profile | 한 Profile은 로그인됐지만 다른 Profile은 오래된 세션 | Profile 이름, 창 제목, /status | 대상 Profile에서 다시 login하거나 route 정리 |
| devcontainer / remote SSH | 로컬 shell은 깨끗하지만 container가 key 보유 | container 이름, remote host, masked env check | secret 주입 원본을 수정 |
| Team / Enterprise | 개인 로그인은 되지만 org policy가 막음 | org, workspace, repo 권한, admin policy | 조직 관리자 경로로 확인 |
| compatible gateway | base URL이 trust boundary를 바꿈 | host, model name, provider owner | subscription이 아니라 gateway contract로 진단 |
안정적인 순서는 대상 VS Code 창의 /status, 같은 통합 터미널의 masked env check, 실행 원본과 workspace context 확인, 마지막으로 Console Usage, Claude Status, 조직 관리자 화면입니다. 변경을 하나 할 때마다 /status를 다시 실행해야 어떤 조치가 경로를 바꿨는지 팀이 재현할 수 있습니다.
수정 후 최소 기록
수정이 끝나면 짧은 기록을 남겨야 다음 사람이 같은 문제를 다시 계정 문제로 오해하지 않습니다. 대상 VS Code 창, 실행 방식, /status 전후 결과, 세 가지 ANTHROPIC_* 변수 존재 여부, 실제로 한 변경 하나, 창 재로드 여부, 최종 판단을 적습니다. 최종 판단은 local route fixed, organization admin needed, provider route owns the session, service incident active처럼 경로를 드러내야 합니다.
원인이 실행 환경이면 “Claude 계정 오류”라고 쓰지 말고 “Dock으로 실행한 VS Code가 목표 shell을 상속하지 않았다” 또는 “devcontainer가 다른 자격 증명 경로를 주입했다”라고 남깁니다. 조직 정책이면 “로컬 계정 확인 완료, 접근은 org 또는 project permission에서 차단”이라고 적습니다. 이 차이가 다음 장애 대응 시간을 줄이고 불필요한 key 삭제, 확장 재설치, 브라우저 계정 전환을 막습니다.
출처와 검증 경로
동작 사실은 2026년 5월 7일 확인한 Claude Code 공식 문서의 VS Code integration, authentication, quickstart, commands, errors, troubleshooting을 기준으로 합니다. 한국어 로컬 증거는 같은 날 Computer Use로 Google ko-KR 첫 화면을 캡처했습니다. 로컬 블로그와 커뮤니티는 사용자의 혼란을 보여주는 증거이며 정책 근거는 아닙니다.
자주 묻는 질문
VS Code에서 Claude Code 현재 계정을 어떻게 확인하나요?
같은 VS Code 창에서 Claude Code를 열고, 필요하면 통합 터미널에서 claude를 실행한 뒤 /status를 확인합니다.
로그인 안 됨이라고 나오면?
/login을 실행하고 브라우저 인증을 마친 뒤 같은 창에서 /status를 다시 확인합니다.
API Key가 구독 로그인을 덮을 수 있나요?
가능합니다. ANTHROPIC_API_KEY나 token 환경 변수가 세션 경로를 바꿀 수 있습니다.
외부 터미널에는 Key가 있는데 VS Code에는 없는 이유는?
VS Code가 다른 환경에서 실행되었을 수 있습니다. 원하는 shell에서 code .로 다시 여세요.
/cost로 계정을 확인할 수 있나요?
아니요. 계정과 경로는 /status가 먼저입니다.
API Key를 삭제해야 하나요?
보통은 먼저 VS Code 실행 환경에서 변수만 제거하고 /status로 확인합니다.
Claude Status가 정상이라면 로컬 계정도 정상인가요?
아닙니다. Status는 장애 분기를 판단하는 신호이지 로컬 인증 증거가 아닙니다.
지원 요청에는 무엇을 보내나요?
버전, 실행 경로, 비밀 제거 /status, 변수 이름 존재 여부, 오류, 시간, 상태 확인 시간을 보냅니다. 비밀값은 보내지 않습니다.