Claude Code에서 ANTHROPIC_BASE_URL과 API 키 설정하기

필요한 값 두 가지

Claude Code는 Anthropic 프로토콜을 사용합니다. 따라서 Codex를 비롯한 OpenAI-compatible 클라이언트와 주소가 다릅니다. OpenAI-compatible 클라이언트에는 일반적으로 `https://www.bettertoken.ai/v1%60%EC%9D%B4?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-015&utm_content=anthropic-base-url-api-key-nastroyka 필요합니다.

단계 1. 충돌하는 변수 정리하기

설정을 변경하기 전에 이전 값이 남아 있는지 확인하세요.

printenv ANTHROPIC_BASE_URL
test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set"

토큰 값 자체는 출력하지 마세요. 현재 shell에 변수가 설정되어 있고 설정 파일을 우선 적용하려면 다음과 같이 지웁니다.

unset ANTHROPIC_BASE_URL
unset ANTHROPIC_AUTH_TOKEN

그다음 ~/.zshrc, ~/.bashrc, .env, IDE 설정, provider 관리 도구를 확인하세요. 이미 실행 중인 프로세스는 파일을 수정한 뒤에도 시작 시 상속받은 환경 변수를 계속 사용할 수 있습니다.

단계 2. 사용자 설정 추가하기

Claude Code 공식 설정 문서에 따르면 사용자 설정은 ~/.claude/settings.json, 프로젝트 설정은 .claude/settings.json, 프로젝트 로컬 설정은 .claude/settings.local.json에 저장됩니다.

BetterToken을 사용하려면 다음 내용을 추가하세요.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://bettertoken.ai/?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-015&utm_content=anthropic-base-url-api-key-nastroyka",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "API_TIMEOUT_MS": "3000000"
  }
}

YOUR_API_KEY만 실제 값으로 바꾸세요. 파일에 이미 permissions, hooks, plugins 또는 다른 필드가 있다면 전체 파일을 덮어쓰지 마세요. 기존 내용을 유지하면서 env 객체를 추가하거나 병합하고, 결과가 유효한 JSON인지 확인해야 합니다.

파일 접근 권한을 제한한 뒤 실제로 적용됐는지 확인하세요.

chmod 600 ~/.claude/settings.json
ls -l ~/.claude/settings.json

출력에서 그룹과 기타 사용자에게 읽기 또는 쓰기 권한이 부여되어 있지 않아야 합니다. 이슈에 파일 전체를 첨부하지 마세요. 팀 환경에서는 공용 작업 토큰을 공개하지 말고, 각 사용자가 본인 키를 사용하세요.

단계 3. Claude Code 완전히 다시 시작하기

현재 프로세스를 완전히 종료한 뒤 claude를 다시 실행하세요. 실행 중인 Claude Code를 종료하지 않고 터미널 탭만 새로 여는 것으로는 충분하지 않습니다. 프로세스는 시작할 때 전달받은 환경을 그대로 유지합니다.

VS Code Extension은 VS Code의 settings.json에 있는 claudeCode.environmentVariables를 별도 설정 지점으로 사용합니다. 터미널 shell과 Extension이 항상 같은 환경 변수 집합을 읽는다고 가정하지 마세요.

단계 4. 작은 작업으로 연결 확인하기

테스트 폴더에서 Claude Code를 실행하고 안전한 요청을 입력하세요.

한 줄로 답하세요: CLAUDE_PROVIDER_OK. 파일을 변경하거나 명령을 실행하지 마세요.

요청을 보내기 전에 현재 시각을 기록하세요. 다음 조건을 모두 충족하면 설정이 정상적으로 작동한 것입니다.

• 401, 403, ConnectionRefused, model not found 오류 없이 응답이 도착함
• BetterToken Workspace에 테스트 시작 이후 시각의 새 기록이 나타남
• 해당 기록에서 예상 모델, 상태, 사용량을 확인할 수 있음
• 다시 시작한 뒤 Claude Code가 이전 provider로 되돌아가지 않음

성공 응답만으로는 실제 라우팅을 증명할 수 없습니다. 설정이 충돌하면 Claude Code가 다른 provider를 사용했을 수 있습니다. Workspace에 생성된 새 테스트 요청 기록이 확인 근거입니다. 테스트 시작 이후 시각의 새 기록이 Workspace에 생성됐는지 확인한 뒤 작업용 저장소를 여세요.

설정 충돌 위치 찾기

보편적인 우선순위가 있다고 가정하지 마세요. 실제로 적용되는 구성은 실행 방식, managed policy, 프로세스가 이미 상속한 환경에 따라 달라집니다. 먼저 필요한 설정 이름이 들어 있는 모든 소스를 찾으세요.

printenv ANTHROPIC_BASE_URL
test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set"
grep -lE '"ANTHROPIC_(BASE_URL|AUTH_TOKEN)"' \
  ~/.claude/settings.json \
  .claude/settings.json \
  .claude/settings.local.json 2>/dev/null

이 명령은 토큰 값이 아니라 파일 이름만 표시합니다. 시작 과정에 관여한다면 조직의 managed settings, VS Code Extension, 외부 provider 관리 도구도 확인하세요. 그런 다음 설정 소스를 한 번에 하나씩 변경하고, 클라이언트를 완전히 다시 시작한 뒤 Workspace의 새 요청 기록을 확인하면서 작은 요청을 반복하세요.

자주 발생하는 오류

ConnectionRefused 또는 잘못된 endpoint에 연결됨

주소를 문자 그대로 확인하세요. https://bettertoken.ai이며 /v1, /messages, 끝의 공백이 없어야 합니다. 필요한 경로는 클라이언트가 직접 추가합니다.

401 또는 authentication failure

키 유출이 의심되면 새 키를 만들고, 공백 없이 복사했는지 확인하세요. 다른 클라이언트용 변수가 아니라 ANTHROPIC_AUTH_TOKEN을 사용해야 합니다. 지원 채널에 토큰을 평문으로 보내지 마세요.

변경 사항이 적용되지 않음

모든 Claude Code 프로세스를 종료하고 printenv로 이전 값을 확인한 뒤 클라이언트를 다시 실행하세요. VS Code에서는 Reload Window를 실행하거나 Extension을 다시 시작합니다.

model not found

오래된 글에서 임의의 Model ID를 가져오지 마세요. 키나 모델에 명시적인 mapping 설정이 필요하다면 Setup 또는 현재 Claude Code 가이드에서 현재 Model ID를 확인해 사용하세요.

빠른 점검 목록

• Claude Code Base URL에 /v1이 없음
• 실제 키가 Git이나 스크린샷에 포함되지 않음
• 이전 설정이 들어 있는 모든 소스를 찾고 각각 하나씩 검증함
• 클라이언트를 완전히 다시 시작함
• 작은 읽기 전용 요청이 Workspace에 표시됨

다섯 항목을 모두 확인했다면 실제 작업을 시작하세요. 하나라도 충족하지 못했다면 Claude Code 단계별 설정 가이드를 열고, 사용하는 클라이언트를 선택한 뒤 전체 설정을 한꺼번에 바꾸지 말고 각 필드를 하나씩 대조하세요.