Claude Code VS Code 확장을 서드파티 API로 쓰기: environmentVariables 설정

Wokey Team · 2026-09-24

짧은 답: Claude Code VS Code 확장이 서드파티 API를 쓰게 하려면 VS Code 사용자 설정의 claudeCode.environmentVariables에 ANTHROPIC_BASE_URL과 ANTHROPIC_AUTH_TOKEN을 넣고 claudeCode.disableLoginPrompt를 켜세요. 터미널에서 export한 변수는 대부분 확장에 전달되지 않습니다. ~/.claude/settings.json만으로도 부족합니다. 확장의 실행 전 로그인 확인이 이 파일을 읽지 못해 로그인 화면이 계속 나타납니다.

설정 방법

1. 확장을 설치하세요. VS Code 1.94.0 이상이 필요합니다. 확장 보기(Cmd/Ctrl+Shift+X)에서 "Claude Code"(게시자: Anthropic)를 검색하세요. Cursor에서도 같은 확장을 설치할 수 있고, VSCodium 같은 에디터는 Open VSX에서 받을 수 있습니다.
2. 사용자 설정을 여세요. Cmd/Ctrl+Shift+P를 누르고 **Preferences: Open User Settings (JSON)**을 실행하세요.
3. 설정을 추가하세요. 가장 바깥쪽 {} 안에 다음을 추가합니다.

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.wokey.ai" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "your Wokey API key" }
  ],
  "claudeCode.disableLoginPrompt": true
}

4. 다시 로드하세요. 명령 팔레트에서 Developer: Reload Window를 실행한 뒤 Claude Code 패널을 여세요.

주의할 점 세 가지:

• ANTHROPIC_BASE_URL은 도메인만 넣고 /v1은 붙이지 않습니다. /v1/messages는 확장이 직접 붙입니다.
• 이 값은 사용자 설정에 넣으세요. 저장소에 커밋되는 경우가 많은 워크스페이스 .vscode/settings.json에는 넣지 마세요.
• disableLoginPrompt는 로그인 프롬프트를 건너뜁니다. 공식 설명은 "for third-party provider setups"입니다.

export와 settings.json으로 부족한 이유

확장은 Claude 프로세스를 시작하기 전에 자격 증명이 있는지 확인합니다. 이 확인은 claudeCode.environmentVariables만 읽습니다.

• Dock, 시작 메뉴, 바탕화면 아이콘으로 연 VS Code는 ~/.zshrc에서 export한 변수를 받지 못합니다.
• ~/.claude/settings.json의 env 블록은 확장이 시작하는 Claude 프로세스에는 전달되지만, 확장 자체의 로그인 확인에는 전달되지 않습니다.

그래서 settings.json만 있고 disableLoginPrompt가 꺼져 있으면, 전형적인 증상은 확장이 계속 로그인을 요구하는 것입니다. 일회성으로 셸 변수를 쓰려면 변수가 설정된 터미널에서 code .를 실행하세요. 평소에 쓰려면 위의 사용자 설정이 더 확실합니다.

요청이 Wokey를 거치는지 확인하기

확장의 프롬프트 입력란에서 /status를 실행하세요(Claude Code v2.1.280 이상 필요). Status 탭의 Anthropic base URL이 https://api.wokey.ai로 표시되어야 합니다.

모델 선택

명령 메뉴에서 **Switch model…**을 선택하거나 프롬프트 입력란 아래의 모델 이름을 클릭하세요. Opus, Sonnet, Haiku 등급별로 어떤 모델을 쓸지 고정하려면 같은 목록에 변수를 추가하세요.

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.wokey.ai" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "your Wokey API key" },
    { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "claude-opus-5" },
    { "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "claude-sonnet-5" }
  ]
}

서드파티 API에서 사용할 수 없는 것

서드파티 API를 쓰면 확장은 claude.ai 계정이 필요한 기능을 제공하지 않습니다.

• 요금제 사용량 막대, 음성 받아쓰기, 클라우드 세션용 Web 탭.
• 메뉴에 Sign out 항목이 없습니다.
• /bug를 제출하면 오류가 표시되고 아무것도 전송되지 않습니다.

이전에 /login으로 로그인한 claude.ai 계정은 저장된 채로 사용되지 않습니다.

터미널의 CLI와 비교하면 확장은 명령의 일부만 지원하며, ! Bash 단축키와 탭 자동 완성도 없습니다.

문제 해결

로그인 화면이 계속 나타납니다. claudeCode.environmentVariables가 없거나 잘못된 곳(워크스페이스 설정 등)에 있거나, 변경 후 창을 다시 로드하지 않은 경우입니다. disableLoginPrompt가 true인지도 확인하세요.

invalid x-api-key. ANTHROPIC_BASE_URL이 적용되지 않아 요청이 Anthropic 자체 주소로 갔습니다. Wokey는 이 메시지를 반환하지 않습니다. invalid x-api-key 가이드를 참고하세요.

/v1/v1/messages가 언급된 404. base URL에 /v1이 하나 더 붙어 있습니다. https://api.wokey.ai로 바꾸세요.

응답도 오류도 없습니다. 공식 권장 사항은 터미널에서 claude를 실행해 더 자세한 오류를 보는 것입니다. 확장은 자체 CLI를 포함하지만 claude를 PATH에 추가하지 않으므로, CLI를 따로 설치하고 Claude Code base URL 가이드대로 변수를 설정하세요.

JetBrains 사용자

JetBrains 플러그인은 CLI를 포함하지 않습니다. IDE 터미널에서 설치된 claude 명령을 실행하며, 경로는 Settings → Tools → Claude Code [Beta] → Claude command에서 바꿀 수 있습니다. 따라서 JetBrains는 CLI와 같은 방식으로 설정합니다. ANTHROPIC_BASE_URL과 ANTHROPIC_AUTH_TOKEN을 ~/.claude/settings.json의 env 블록에 넣으세요. Claude Code base URL 가이드를 참고하세요.