VS Code의 Claude Code: 연결 및 통합 확인

통합의 세 계층

Claude Code가 응답하지 않는 증상은 서로 독립적인 세 계층에서 생길 수 있습니다.

CLI. 공식 확장에는 통합 터미널에서 사용하는 Claude Code CLI가 포함됩니다. 확장 패키지 밖에서 CLI를 사용할 때만 별도 시스템 설치가 필요합니다.

VS Code 확장. Anthropic 공식 확장은 채팅, 나란히 보는 diff, @ 파일 참조와 세션 기록을 제공합니다. 검증 시점의 공식 문서는 VS Code 1.98.0 이상을 요구했습니다.

API 엔드포인트. Claude Code는 기본으로 Anthropic API를 사용합니다. BetterToken 사용 시 ANTHROPIC_BASE_URL과 ANTHROPIC_AUTH_TOKEN을 설정하고, 확장이 이를 Claude Code에 전달합니다. Dashboard의 성공 기록은 BetterToken이 요청을 받았음을 뜻하며, IDE 통합은 파일 문맥과 diff로 따로 확인합니다.

자신의 BetterToken 계정을 사용해 Dashboard에서 API 키를 만들고 문서에서 Base URL을 가져오세요.

API 키 생성 및 Claude Code 설정: docs.bettertoken.ai/ai-tools/claude-code

API 키 생성과 엔드포인트 연결

1단계. 계정과 API 키 만들기

bettertoken.ai에서 가입한 후 키 관리로 이동해 새 API 키를 만들고 복사합니다.

2단계. Base URL 확인하기

Claude Code에는 다음 Anthropic 호환 Base URL을 사용합니다.

https://www.bettertoken.ai

/v1은 붙이지 마세요. Claude Code가 메서드 경로를 추가합니다. /v1 주소는 Codex CLI 같은 OpenAI 호환 도구용입니다.

3단계. ~/.claude/settings.json 편집하기

macOS/Linux는 ~/.claude/settings.json, Windows는 %USERPROFILE%\.claude\settings.json에 다음 env 블록을 추가합니다.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.bettertoken.ai",
    "ANTHROPIC_AUTH_TOKEN": "your_api_key_here"
  }
}

your_api_key_here를 1단계 키로 바꾸세요. 기존 필드가 있으면 "env"만 추가합니다. CLI와 확장은 같은 파일을 읽습니다.

4단계. 로그인 화면 끄기

VS Code 설정(Mac Cmd+,, Windows/Linux Ctrl+,)의 Extensions → Claude Code에서 Disable Login Prompt를 켭니다. 외부 provider의 Anthropic 로그인 화면을 숨길 뿐 env 설정을 대체하지는 않습니다.

VS Code에서 Claude Code 시작하기

5단계. 확장 설치하기

Mac은 Cmd+Shift+X, Windows/Linux는 Ctrl+Shift+X를 눌러 Anthropic의 “Claude Code”를 Install합니다. 아이콘이 없으면 명령 팔레트에서 Developer: Reload Window를 실행하고, Help → About에서 VS Code 1.98.0 이상인지 확인합니다.

6단계. 패널 열기

파일을 열면 Editor Toolbar의 Spark(✱) 아이콘으로 채팅을 열 수 있습니다. Activity Bar의 Spark, Cmd+Shift+P / Ctrl+Shift+P의 “Claude Code: Open in New Tab”, 오른쪽 아래 Status Bar의 ✱ Claude Code(파일 없이도 가능)도 사용할 수 있습니다.

7단계. 파일 문맥 확인하기

코드 줄을 선택하면 Claude Code가 입력창 아래에 선택 줄 수를 표시합니다. Mac은 Option+K, Windows/Linux는 Alt+K로 @file.ts#5-10 같은 참조를 삽입합니다.

문맥, diff, Dashboard 확인하기

8단계. 저위험 테스트 보내기

작은 스크립트나 설정에서 되돌릴 수 있는 변경을 요청합니다.

첫 번째 함수 앞에 기능을 짧게 설명하는 한 줄 주석을 추가하세요.

또는:

이 파일에서 변수 `tmp`의 이름을 `result`로 바꾸세요.

9단계. 나란히 표시되는 diff 검토하기

확장은 변경 전후를 보여주고 승인을 요청합니다. 확인 후 Accept 또는 Reject를 누르세요. 의미 있는 diff는 모델 응답이 현재 파일에 연결되었음을 보여주며, BetterToken 경로는 Dashboard에서 확인합니다.

10단계. Dashboard에서 요청 찾기

bettertoken.ai의 Dashboard 또는 요청 기록에서 테스트 시각의 항목을 찾습니다. 모델, 상태, 입력·출력·캐시 Token 및 요금을 비교하세요. 같은 시각의 성공 기록과 올바른 diff가 있으면 확장이 문맥을 전달했고 BetterToken이 처리한 뒤 IDE로 응답이 돌아온 것입니다.

통합이 감지되지 않을 때

Spark 아이콘이 없을 때

Editor Toolbar 아이콘은 파일이 열려 있어야 보입니다. Help → About에서 VS Code 1.98.0 이상인지 확인하고 Developer: Reload Window를 실행하며 Cline, Continue, GitHub Copilot을 잠시 끕니다. Status Bar의 ✱ Claude Code는 파일 없이도 작동합니다.

터미널 환경 변수를 상속하지 않을 때

shell에 ANTHROPIC_BASE_URL이 있는데도 로그인 요청이 나오면 Spotlight나 앱 메뉴로 실행한 VS Code가 환경을 상속하지 않은 것입니다. 터미널에서 실행하세요.

code .

또는 Extensions → Claude Code → environmentVariables에 변수를 넣습니다.

확장이 다시 로그인을 요구할 때

Disable Login Prompt가 켜져 있는지 확인하세요. 이 설정은 Anthropic 로그인 화면을 숨기지만 연결 변수는 별도로 계속 설정해야 합니다.

변경한 설정을 읽지 못할 때

settings.json의 경로와 JSON을 확인하세요. 쉼표가 하나 더 있거나 괄호가 닫히지 않으면 env를 읽지 못합니다. Developer: Reload Window를 실행하고 shell 또는 확장 설정에 이전 Base URL이나 키가 남아 있지 않은지도 확인합니다.

401 또는 응답 없음

https://www.bettertoken.ai에 /v1을 붙이지 않았는지, API 키에 공백·줄바꿈·추가 따옴표가 없는지, 다른 ANTHROPIC_AUTH_TOKEN 또는 ANTHROPIC_BASE_URL이 덮어쓰지 않는지 순서대로 확인합니다. Dashboard 기록이 없으면 전송·엔드포인트·네트워크를, 401 기록이면 키 또는 형식을 확인하세요. 필드 이름은 현재 BetterToken 문서에서 확인합니다.

BetterToken용 Claude Code 전체 안내: docs.bettertoken.ai/ai-tools/claude-code