Claude Code 로그인 / 인증 실패 (Invalid API key / Please run /login / OAuth): 원인과 해결법
지금 장애가 있나요?
Claude Code 공식 상태는 정상입니다. 이 오류가 계속되면 구현(코드) 또는 사용자 환경 문제일 가능성이 높습니다.
업데이트: 2026. 10. 25. 오전 11:46 UTC
Claude Code의 가동 상태 보기 →오류의 의미
Claude Code가 로그인 또는 인증에 실패하는 상태입니다. 흔한 원인은 OAuth 로그인 콜백 타임아웃, 토큰을 저장하지 못하는 잠긴 macOS 키체인, API 키와 base URL의 불일치, DNS/네트워크 문제 등입니다. "Invalid API key · Please run /login" 표시는 키가 잘못되었거나 토큰이 만료되었음을 의미합니다.
자주 있는 원인
- •OAuth 로그인 콜백이 타임아웃됨
- •macOS 키체인이 잠겨 있어 인증 토큰을 저장하지 못함
- •API 키(sk-ant-…)와 base URL(공식 vs proxy)이 일치하지 않음
- •브라우저가 없는 환경(SSH/CI/Docker)에서 OAuth를 시도함
- •DNS/proxy/방화벽이 인증 서버를 차단함
- •오래된 버전 또는 손상된 캐시
해결 방법
- 1./logout으로 기존 토큰을 완전히 지운 뒤 다시 /login하세요
- 2.Claude Code를 최신 버전으로 업데이트하고 ~/.claude/cache를 삭제한 뒤 다시 시도하세요
- 3.브라우저가 없는 환경(SSH/CI/Docker)에서는 OAuth 대신 ANTHROPIC_API_KEY 환경 변수를 설정하세요
- 4.API 키와 base URL이 같은 플랫폼에서 온 것인지 확인하세요(공식 키 → 공식 base URL)
- 5./doctor를 실행해 설정, 인증, 업데이트 문제를 한 번에 점검하세요
- 6.macOS에서는 키체인 잠금을 해제하고 네트워크/proxy 설정을 확인하세요
기다리면 되는 경우 / 기다려도 안 되는 경우
이는 인증/설정 문제이므로 기다린다고 저절로 해결되지 않습니다. /logout 후 /login을 다시 하거나, 업데이트와 캐시 삭제를 하거나, 브라우저가 없는 환경에서는 ANTHROPIC_API_KEY를 설정하세요. 먼저 /doctor를 실행하는 것이 원인을 가장 빠르게 찾는 방법입니다.
Claude Code을(를) 쓸 수 없을 때의 대체
관련 오류
자주 묻는 질문
Login / authentication failed은(는) 무엇인가요?
Claude Code가 로그인 또는 인증에 실패하는 상태입니다. 흔한 원인은 OAuth 로그인 콜백 타임아웃, 토큰을 저장하지 못하는 잠긴 macOS 키체인, API 키와 base URL의 불일치, DNS/네트워크 문제 등입니다. "Invalid API key · Please run /login" 표시는 키가 잘못되었거나 토큰이 만료되었음을 의미합니다.
Login / authentication failed은(는) 어떻게 해결하나요?
/logout으로 기존 토큰을 완전히 지운 뒤 다시 /login하세요 / Claude Code를 최신 버전으로 업데이트하고 ~/.claude/cache를 삭제한 뒤 다시 시도하세요 / 브라우저가 없는 환경(SSH/CI/Docker)에서는 OAuth 대신 ANTHROPIC_API_KEY 환경 변수를 설정하세요 / API 키와 base URL이 같은 플랫폼에서 온 것인지 확인하세요(공식 키 → 공식 base URL) / /doctor를 실행해 설정, 인증, 업데이트 문제를 한 번에 점검하세요 / macOS에서는 키체인 잠금을 해제하고 네트워크/proxy 설정을 확인하세요