Claude Code가 클라우드 환경에서 ANTHROPIC_API_KEY가 설정된 경우 자동으로 실패합니다

Claude Code(CC)에 알려진 문제가 있습니다: 클라우드 환경에서 ANTHROPIC_API_KEY 환경 변수를 설정하면 Claude Code가 명령을 실행하지 못합니다. 이 변수가 CLI 결제를 무시하고 모든 호출을 Anthropic API를 통해 라우팅하여 예상치 못한 요금과 도구 작동 중단을 초래합니다. 이 문제는 GitHub 이슈 #54497을 참조하여 Hacker News에 보고되었습니다.

논의에서 나온 주요 세부 사항

• 환경 변수가 오류를 유발: 클라우드 환경(예: CI/CD, 컨테이너)에서 ANTHROPIC_API_KEY를 설정하면 Claude Code가 작동을 멈춥니다. 도구가 결제를 위해 API 키를 사용하려고 하여 무료 티어 또는 로컬 결제 메커니즘을 효과적으로 비활성화합니다.
• 추가 사용 요금: 한 사용자가 Anthropic 청구서에 "추가 사용량"이 많이 표시되었다고 보고했습니다. 아마도 모든 Claude Code 호출이 API 키를 통해 프록시되어 요청당 비용이 발생했기 때문입니다.
• 잘못된 문서: 다른 댓글 작성자는 Anthropic의 자체 문서가 이전에(그리고 부정확하게) Claude Code Web 사용을 위해 ANTHROPIC_API_KEY를 추가하라고 조언했다고 언급했습니다. 이로 인해 의도치 않은 요금이 발생했습니다. Anthropic은 나중에 문서를 업데이트했지만 발생한 비용을 환불해 주지 않았습니다.
• 해결 방법: Claude Code가 실행되는 클라우드 환경에서는 ANTHROPIC_API_KEY를 설정하지 마십시오. 필요한 경우 대체 인증 방법(예: CLI 기반 자격 증명 또는 별도의 결제 토큰)을 사용하십시오.

영향을 받는 대상

CI/CD 파이프라인, 컨테이너화된 환경 또는 환경 변수가 전역적으로 주입되는 클라우드 기반 인프라에서 Claude Code를 사용하는 개발자.