Claude Code에서 API Key와 Base URL 설정하기

​

빠른 답변

​

이 설정이 필요한 경우

• Claude Code에서 사용자 지정 API 게이트웨이를 사용하려 할 때
• API Key는 있지만 어떤 Base URL을 사용할지 모를 때
• Claude Code에서 인증 또는 엔드포인트 오류가 발생할 때
• https://www.bettertoken.ai과 https://www.bettertoken.ai/v1 중 하나를 선택해야 할 때
• Claude 제공자와 GPT 제공자의 차이를 이해해야 할 때

​

핵심 개념

​

권장 설정

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.bettertoken.ai",
    "ANTHROPIC_AUTH_TOKEN": "<YOUR_API_KEY>"
  }
}

​

흔한 실수

• Claude Code Base URL에 /v1 추가하기
• API Key만 변경하고 요청은 기본 엔드포인트로 계속 보내기
• GPT 제공자의 모델 ID를 Claude 제공자 모델로 간주하기
• Claude Code의 Anthropic 호환 필드에 OpenAI 호환 엔드포인트 입력하기
• 셸 프로필의 기존 환경 변수가 새 설정을 덮어쓰도록 두기

​

BetterToken에서의 사용 방식

​

관련 문서

• Claude Code 설정 가이드
• Claude Code는 Claude.ai 계정과 API Key 중 무엇을 사용하나요?
• OpenAI 호환 API와 Anthropic 호환 API 비교
• Claude Code가 많은 Token을 사용하는 이유와 비용 줄이기

​

참고 자료

• Claude Code LLM 게이트웨이 설정
• Claude Code 인증
• Claude Code 모델 설정
• Claude Code 설정 가이드