Claude Code, API 키 우선 적용 주의
PSA: If your project has an ANTHROPIC_API_KEY in any .env file, Claude Code will silently bill your API account instead of your Max plan — Anthropic calls it "intentional functionality"
·2026.05.13 03:44
Claude Code 실행 시 환경 변수에 API 키가 있으면 구독 플랜 대신 API 비용이 청구될 수 있습니다.
Claude Code 실행 시 프로젝트의 .env 파일에 ANTHROPIC_API_KEY가 포함되어 있으면, 사용자의 OAuth 구독(Max 플랜 등) 대신 API 키를 우선적으로 사용하여 비용을 청구하는 현상이 확인되었습니다.
Anthropic 측은 이러한 동작이 인증 방식의 유연성을 제공하기 위한 **"의도된 기능(intentional functionality)"**이라고 밝혔습니다. 별도의 경고나 알림 없이 API 크레딧이 소모될 수 있으므로, 자동화 환경(CI/CD, Task Scheduler 등)에서 Claude Code를 사용하는 개발자는 각별한 주의가 필요합니다.
해결 방법: Claude Code 실행 직전에 환경 변수에서 API 키를 해제하여 구독 인증이 적용되도록 설정해야 합니다.
- PowerShell:
$env:ANTHROPIC_API_KEY = $null - Bash/Zsh:
unset ANTHROPIC_API_KEY
이 요약은 원문 이해를 돕기 위한 큐레이션입니다. 저작권은 원저작자에게 있으며, 정확한 내용과 맥락은 원문을 확인하세요.
요약 오류, 출처 표기 문제, 삭제 요청은 문의 · 건의로 알려주세요.