문제 해결 · Claude Code
Claude Code API Error 401 authentication_error 해결 방법
Claude Code는 연결 중인 엔드포인트에 유효한 키가 하나도 도달하지 않으면 API Error: 401 authentication_error를 출력합니다. 이를 일으키는 환경 변수 규칙과 해결 방법.
표시되는 내용
API Error: 401 {"type":"error","error":{"type":"authentication_error","message":"Invalid or missing API key."}}발생 원인
- claude를 실행한 셸에 ANTHROPIC_BASE_URL이 설정되지 않아 키가 api.anthropic.com으로 갑니다. 그 서버는 이 키를 본 적이 없으며 invalid x-api-key로 응답합니다.
- 변수가 claude를 실행한 셸과 다른 셸에 설정되어 있습니다 — 한 터미널의 export는 다른 터미널에 존재하지 않으며, GUI 런처는 셸 프로필을 읽지 않습니다.
- ANTHROPIC_AUTH_TOKEN이 비어 있거나 잘렸거나 다른 프로바이더의 키입니다. 이 엔드포인트는 x-api-key와 Authorization: Bearer 모두에서 키를 받으며, 401은 받은 키 중 유효한 것이 하나도 없다는 뜻입니다.
- 키가 폐기되었거나, 만료일을 두고 발급된 경우 만료되었습니다.
해결 방법
- ANTHROPIC_BASE_URL과 ANTHROPIC_AUTH_TOKEN을 함께 설정하고 ANTHROPIC_API_KEY는 해제해, 다른 프로바이더의 오래된 키가 끼어들지 않게 하세요.
- claude를 실행하는 바로 그 셸에서 확인하세요: 실행 직전에 변수의 앞 몇 글자를 출력해 보세요.
- 대시보드에서 키가 활성 상태인지 확인한 뒤, https://router.apitoken.sale/v1/models에 curl로 테스트하세요.
이 게이트웨이용 정상 환경
export ANTHROPIC_BASE_URL="https://router.apitoken.sale"
export ANTHROPIC_AUTH_TOKEN="sk-pool-•••"
export ANTHROPIC_MODEL="openai/gpt-6.1-terra" # or a google/gemini-* model
export ANTHROPIC_DEFAULT_HAIKU_MODEL="openai/gpt-6-luna" # background tasks
unset ANTHROPIC_API_KEY # keep one credential
claude관련 검색어
API Error: 401 {"type":"error","error":{"type":"authentication_error","message":"invalid x-api-key"}}claude code 401 custom ANTHROPIC_BASE_URLclaude code invalid api key
자주 묻는 질문
커스텀 ANTHROPIC_BASE_URL을 설정하자마자 Claude Code가 401을 반환하는 이유는?+
대개 변수가 claude를 실행하는 셸까지 전달되지 않았거나, 키가 base URL이 가리키는 곳과 다른 엔드포인트의 것입니다. 그 셸의 환경을 확인하고 키와 엔드포인트를 맞추세요.
ANTHROPIC_API_KEY와 ANTHROPIC_AUTH_TOKEN 중 어느 쪽이 맞나요?+
ANTHROPIC_API_KEY는 x-api-key 헤더가 되고, ANTHROPIC_AUTH_TOKEN은 Authorization: Bearer가 됩니다. 이 엔드포인트는 둘 다 받지만 문서화된 선택은 ANTHROPIC_AUTH_TOKEN입니다. 둘 중 하나만 설정해 두세요.
같은 키가 curl에서는 되는데 Claude Code에서는 안 되는 이유는?+
claude를 실행하는 셸의 환경 상태가 다릅니다: 경쟁하는 변수, 오래된 값, 또는 값이 아예 없는 경우입니다. 바로 그 셸에서 환경을 확인하세요.