[Claude Code] VS Code에서 "credit balance" 에러 — 원인은 로그인 방식이었다

증상

VS Code에서 Claude Code를 쓰는데 credit balance 관련 에러가 났다.

진단 — 어떤 방식으로 쓰고 있었는지부터 확인

VS Code 안에서 Claude Code를 쓰는 방식은 크게 두 가지다.

1. VS Code 확장(Extension): 사이드바에 Claude 아이콘이 있고, 거기서 대화창으로 쓰는 방식
2. VS Code 통합 터미널에서 CLI로 접속: 터미널 패널(Ctrl+`` 또는 Cmd+``)을 열고 claude라고 입력해서 실행하는 방식

두 방식 중 어느 쪽인지에 따라 확인할 곳이 다르다. 터미널 CLI 방식이라면 진단 순서는 이렇다:

1. VS Code 터미널 열기 (Ctrl+`` 또는 Cmd+``)
2. claude 입력해서 실행
3. 안에서 /status 입력 → 로그인 방식이 subscription인지 API key인지 확인

원인

/status로 확인해보니 API 키로 계정이 연결되어 있었다. 구독제(subscription) 요금제를 쓰고 있다고 생각했는데, 실제로는 API 키 연결 상태라 요금 방식 자체가 달랐던 것 — 이게 credit balance 문제의 원인이었다.

해결

VS Code에서 Claude Code 로그인을 다시 하면서 요금제를 다시 선택했다. 재로그인 과정에서 subscription 방식으로 다시 연결하니 문제가 해결됐다.

정리

• credit balance류 에러가 나면, 일단 /status로 지금 API 키로 연결된 상태인지 구독(subscription)으로 연결된 상태인지부터 확인하는 게 먼저다
• 둘은 과금 방식 자체가 다르기 때문에, 의도한 요금제와 실제 연결 방식이 다르면 이런 문제가 생길 수 있다
• 재로그인하면서 요금제를 다시 선택하는 것으로 해결 가능