Claude Code "401 잘못된 인증 자격 증명", "잘못된 API 키", "로그인되지 않음" 및 403 오류

오류 메시지

API Error: 401 {"type":"error","error":{"type":"authentication_error","message":"Invalid authentication credentials"}}
API Error: 401 invalid x-api-key
Invalid API key · Fix external API key
Not logged in · Please run /login
Login expired · Please run /login
API Error: 403 x-deny-reason: host_not_allowed
Error: Poll: Access denied (403): Account is no longer a member of the organization associated with this token.

단계 1: 어떤 자격 증명이 전송되고 있나요?

claude
/status                       # auth method, endpoint, model
echo $ANTHROPIC_API_KEY | cut -c1-12
echo $ANTHROPIC_BASE_URL
grep -n apiKeyHelper ~/.claude/settings.json

알고 나면 우선순위는 간단합니다: ANTHROPIC_API_KEY 환경 변수에 설정된 값(또는 다음이 반환하는 값: apiKeyHelper)이 OAuth 로그인 대신 사용됩니다. .bashrc 에 몇 달 전에 내보낸 오래된 키나 다른 게이트웨이의 키는, 매번 다음을 실행해도 해결되지 않는 401의 전형적인 원인입니다: /login. 해당 값을 해제하거나 올바른 키로 설정하세요.

API 키 사용 시 401: 키와 엔드포인트 불일치

invalid x-api-key 및 Invalid API key · Fix external API key 는 엔드포인트가 키를 인식하지 못했다는 뜻입니다. 키는 정확히 하나의 엔드포인트에 속합니다. Anthropic 콘솔 키는 다음에서만 작동합니다: api.anthropic.com; 게이트웨이 키는 해당 게이트웨이의 다음에서만 작동합니다: ANTHROPIC_BASE_URL. 콘솔 키를 다음으로 보내거나: https://aiprimetech.io 게이트웨이 키를 Anthropic으로 보내면 모두 401을 반환합니다. 또한 변수에 붙여넣은 값 끝에 줄바꿈이나 따옴표가 있는지, 대시보드에서 키가 취소되거나 교체되지 않았는지도 확인하세요.

curl -s https://aiprimetech.io/v1/models -H "x-api-key: $ANTHROPIC_API_KEY" -H "anthropic-version: 2023-06-01" | head -c 300
# a JSON list = key accepted; authentication_error = wrong key for this host

/login 이후 401: OAuth 토큰

API Error: 401 Invalid authentication credentials 브라우저 로그인이 성공한 직후 발생하는 것이 가장 많이 보고된 양상입니다(#69706, 미해결, Windows, 활성 Pro 구독; #44265, 로그인 직후 토큰이 만료된 것으로 보고됨).

첫 번째 스레드의 한 댓글 작성자는 저장된 refreshToken 값이 다음에서 빈 문자열이었다는 사실을 발견했습니다: ~/.claude/.credentials.json. 이 경우 새로 로그인하여 파일을 교체할 때까지 모든 요청에서 401이 발생합니다. #54443 에는 서버가 로컬에 저장된 만료 시각보다 먼저 세션을 거부하고 갱신 호출이 400을 반환하는 현상이 기록되어 있어, Please run /login 가 몇 시간마다 다시 발생합니다. 한 계정으로 여러 Claude Code 인스턴스를 실행하면 같은 토큰을 갱신하려고 경쟁하므로 상황이 악화됩니다. #44585: /login 는 *로그인 성공*을 출력한 직후 *로그인되지 않음*으로 돌아갑니다.

/logout후 저장된 자격 증명을 삭제하세요(~/.claude/.credentials.json Linux와 Windows에서는 해당 파일, macOS에서는 키체인의 *Claude Code-credentials* 항목). 그런 다음 /login 을 Claude in Chrome 확장 프로그램이 없는 브라우저에서 실행하세요.
로그인하기 전에 다른 Claude Code 창, 데스크톱 앱, IDE 확장 프로그램을 닫으세요. 이들도 같은 토큰을 갱신합니다. OAuth 오류 페이지 에서 *OAuth 토큰 갱신 실패: 다른 Claude Code 프로세스가 토큰을 갱신 중입니다* 오류를 다룹니다.
claude update: #54235 에서는 401의 원인을 특정 버전과 베타 플래그 환경 변수로 추적했습니다. 인증 회귀 버그는 빠르게 수정됩니다.
헤드리스 또는 SSH 머신: claude setup-token 을 브라우저 로그인이 작동하는 머신에서 실행한 다음, 해당 토큰을 헤드리스 또는 SSH 머신에서 사용하세요.
디버깅보다 지금 작동하게 하는 것이 우선입니다: ANTHROPIC_API_KEY 가 설정되어 있으면 Claude Code는 OAuth를 전혀 사용하지 않습니다.

403: 인증은 허용되지만 해당 작업은 허용되지 않음

`x-deny-reason: host_not_allowed` — 요청 앞단의 프록시가 대상에 대한 접근을 거부합니다. 웹/데스크톱 샌드박스의 아웃바운드 허용 목록에서 관찰되었습니다(#93562, 미해결: *모든 도메인*을 선택해도 기본 목록에 없는 호스트는 CONNECT에서 403을 반환함). 기업 프록시에서도 관찰됩니다. 호스트를 허용 목록에 추가하거나 샌드박스 외부에서 CLI를 실행하세요.
샌드박스 git 프록시 403 적용 대상: git push 기존 브랜치로 푸시할 때(#57356) — GitHub가 아니라 샌드박스의 git 프록시 정책 때문입니다. 일반 터미널에서 푸시하세요.
`Account is no longer a member of the organization associated with this token` — 탈퇴했거나 변경된 조직에 대해 토큰이 발급되었습니다; claude remote-control 는 이 오류가 발생하면 모든 세션에서 충돌하곤 했습니다(#53563). 로그아웃한 뒤 다시 로그인하여 현재 조직의 토큰을 발급받으세요.
게이트웨이에서 발생한 403 — 키는 유효하지만 계정이 비활성화되었거나, 해당 모델을 사용할 잔액이 부족하거나, 모델이 요금제에 포함되어 있지 않습니다. 응답 본문에 원인이 나와 있습니다. 클라이언트 측에서 무엇이든 변경하기 전에 대시보드를 확인하세요.
`/feedback`이 403을 반환하는 경우 (#55348) — 해당 엔드포인트 하나의 서비스 측 장애이며, 모델에는 영향을 미치지 않습니다.

API 키를 사용하는 방법

unset ANTHROPIC_API_KEY ANTHROPIC_BASE_URL   # back to the subscription login
# or: bypass OAuth entirely
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key
claude

게이트웨이 키는 일반 API 키입니다. OAuth, 토큰 갱신, 조직 멤버십이 없으며, 401 계열 오류는 *키가 호스트와 일치하는가*의 문제로 단순해집니다. /login 반복에 갇혀 있고 오늘 출시해야 한다면, 이것이 가장 빠른 탈출 방법입니다. 첫 암호화폐 충전 금액은 두 배가 됩니다(+50%).

이 문제와 씨름하는 데 지치셨나요?

대신 AI Prime Tech 게이트웨이를 통해 Claude Code를 실행하세요. 게이트웨이 자체 업스트림 계정에서 동일한 Claude 모델을 사용하며, 환경 변수 두 개로 전환할 수 있고, 신규 계정에는 다음이 제공됩니다: $5의 무료 API 크레딧이 제공됩니다 사용할 코드: FIXIT — 카드 불필요.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

코드 FIXIT로 계정 만들기

자주 묻는 질문

Claude Code에서 'API 오류: 401 인증 자격 증명이 유효하지 않습니다'를 어떻게 해결하나요?

/status에서 현재 사용 중인 자격 증명을 확인하세요. 오래된 ANTHROPIC_API_KEY의 설정을 해제하거나, 다른 Claude Code 인스턴스를 모두 닫은 상태에서 /logout을 실행하고 ~/.claude/.credentials.json(macOS에서는 키체인)을 삭제한 다음 /login으로 다시 로그인하세요. 우회 방법으로 API 키를 사용하면 OAuth를 완전히 건너뛸 수 있습니다.

Claude Code에 API 키가 유효하지 않다고 표시되는 이유는 무엇인가요?

해당 키는 ANTHROPIC_BASE_URL에 지정된 엔드포인트용이 아닙니다. 콘솔 키는 api.anthropic.com을 사용해야 하고, 게이트웨이 키는 해당 게이트웨이의 URL을 사용해야 합니다. 붙여넣은 값에 공백이 포함되어 있는지, 키가 폐기되었는지도 확인하세요.

Claude Code가 계속 /login을 실행하라고 하는 이유는 무엇인가요?

OAuth 토큰이 로컬 만료 시각 전에 거부되거나 갱신에 실패하고 있습니다. 여러 Claude Code 프로세스가 하나의 토큰을 공유할 때 자주 발생합니다. 다른 프로세스를 닫고, 로그아웃한 다음 저장된 자격 증명을 삭제하고 다시 로그인하세요. CLI도 업데이트하세요.

403 x-deny-reason: host_not_allowed는 무슨 뜻인가요?

프록시(샌드박스의 외부 통신 허용 목록 또는 기업 프록시)가 대상 호스트를 거부했습니다. 자격 증명에는 문제가 없습니다. 해당 호스트를 허용하거나 샌드박스 밖에서 실행하세요.

게이트웨이에서 Claude Code 실행하기

동일한 모델, 환경 변수 두 개, 액면가의 7.69231배에 해당하는 크레딧 또는 정액 무제한 요금제를 이용하세요. 신규 계정: 코드 FIXIT로 $5의 무료 API 크레딧을 받으세요.

API 키 발급받기 무제한 요금제 보기

AI Prime Tech는 독립 API 게이트웨이이며 Anthropic과 제휴 관계가 없고, Anthropic의 보증이나 후원을 받지 않습니다. “Claude”와 “Claude Code”는 Anthropic의 상표입니다. 여기에 설명된 Claude Code 기능은 작성 당시 Anthropic의 공개 문서를 기준으로 하며 자주 변경됩니다. 이 페이지의 가격과 모델 목록은 이 게이트웨이의 실시간 설정에서 가져옵니다.

Claude Code 401 및 403: 유효하지 않은 인증 자격 증명, 유효하지 않은 API 키, "로그인되지 않음", host_not_allowed

TLDR