홈 → 가이드 → Claude Code의 Anthropic base URL: ANTHROPIC_BASE_URL 올바르게 설정하기

Claude Code의 Anthropic base URL: ANTHROPIC_BASE_URL 올바르게 설정하기

Claude Code는 ANTHROPIC_BASE_URL이 가리키는 주소로 연결합니다. 많이들 걸리는 규칙은 하나뿐입니다. /v1 없이 호스트만 적어야 한다는 것, 거의 모든 OpenAI 계열 도구와 정반대입니다.

짧은 답

Claude Code를 실행하기 전에 환경 변수 두 개를 설정하세요:

ANTHROPIC_BASE_URL=https://apiclan.us
ANTHROPIC_AUTH_TOKEN=sk-your-key

Anthropic 공식 주소는 https://api.anthropic.com이며, 중계 서비스를 쓰려면 이것만 바꾸면 됩니다. Claude Code가 /v1/messages를 직접 붙이므로 base URL은 호스트까지만 적어야 합니다. 지난 30일 이 게이트웨이의 Claude 트래픽 중 88%가 이렇게 설정한 Claude Code에서 왔습니다.

어디에 설정하나

macOS / Linux — 실행하는 셸에서:

export ANTHROPIC_BASE_URL=https://apiclan.us
export ANTHROPIC_AUTH_TOKEN=sk-your-key
claude

Windows PowerShell — 현재 창에만 적용:

$env:ANTHROPIC_BASE_URL = "https://apiclan.us"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-key"
claude

~/.claude/settings.json — 셸과 관계없이 모든 세션에 적용:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://apiclan.us",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key"
  }
}

이 값은 Claude Code가 시작할 때 읽힙니다. 바꿨다면 종료하고 새 세션을 시작하세요. 열려 있는 세션은 이전 주소를 계속 씁니다. ANTHROPIC_AUTH_TOKEN은 Authorization: Bearer로, ANTHROPIC_API_KEY는 x-api-key로 전송됩니다. 이 게이트웨이는 둘 다 지원하니 하나만 쓰세요.

한 줄로 테스트하기

Claude Code를 의심하기 전에 주소와 키를 직접 확인하세요:

curl https://apiclan.us/v1/messages \
  -H "Authorization: Bearer sk-your-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":20,"messages":[{"role":"user","content":"hi"}]}'

JSON이 돌아오면 둘 다 맞습니다. text/html이나 404면 URL이 틀린 것이고, JSON 형식의 401이면 URL은 맞고 키가 틀린 것입니다.

/v1을 붙일 때와 붙이지 않을 때

두 SDK 계열은 URL을 나누는 지점이 다릅니다. Anthropic 계열 클라이언트는 /v1/messages를 직접 붙이고, OpenAI 계열 클라이언트는 base URL에 /v1이 있다고 보고 /chat/completions만 붙입니다:

클라이언트	Base URL
Claude Code, Anthropic SDK	https://apiclan.us
Codex, OpenAI SDK	https://apiclan.us/v1
Cursor, Cline, Roo Code	https://apiclan.us/v1
Cherry Studio, Chatbox, LobeChat, LM Studio	https://apiclan.us/v1

Claude Code에 /v1을 붙이면 요청이 /v1/v1/messages로 가서 404가 납니다. Cursor에서 빠뜨리면 /chat/completions로 가서 역시 404입니다. 둘 다 API에 닿지 못합니다.

URL 오류일까, 키 오류일까

• 오류가 났는데 사용 기록에 아무것도 없다 → 경로가 틀렸습니다. 404는 네트워크 가장자리에서 응답되어 과금까지 가지 않습니다. 먼저 /v1을 확인하세요.
• 401이고 기록에 남아 있다 → 키가 틀렸거나, 폐기되었거나, 잔액이 없습니다.
• 같은 키로 다른 모델은 되는데 하나만 404 → 그 모델은 다른 그룹에 속합니다. 키는 한 그룹에만 묶이므로 그 그룹용 키를 하나 더 만드세요.
• 바꿨는데 반영이 안 된다 → 다른 셸에서 변수를 설정했거나, 설정하기 전에 세션을 시작한 경우입니다.

모델 선택

모델 이름은 정확한 문자열이며 점이 아닌 하이픈을 씁니다. claude-fable-5.1이 아니라 claude-fable-5-1입니다. 실행할 때 지정하거나 세션 안에서 /model로 바꾸세요:

claude --model claude-opus-5-5

현재 모델 이름과 가격은 가격표에 있습니다. 다른 클라이언트 설정은 빠른 시작, Claude 데스크톱 앱은 데스크톱 앱 가이드를 참고하세요.

사용 시작하기

구독 없음, 월 최소 사용액 없음, 영업 통화 없음. USDT로 충전하고 쓴 만큼만 지불하세요 — 1 USDT는 2 크레딧의 API 잔액이 됩니다.

30초 빠른 시작 읽기

언어: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

이 페이지의 가격은 실제 과금 데이터에서 자동으로 채워집니다. 제3자 조건은 해당 업체의 공개 문서에서 인용했습니다.