문제 해결

문제는 대부분 키, endpoint, 세션, 네트워크 중 하나입니다. 아래 순서대로 확인하세요.

핵심 점검

Invalid API key

원인: 기존 공식 키가 남아 있거나 ANTHROPIC_AUTH_TOKEN 값이 다릅니다. 해결: 공식 키를 제거하고 발급 키를 다시 넣습니다.

BASE_URL 미반영

원인: 새 셸에 환경변수가 반영되지 않았습니다. 해결: Linux/macOS는 source, Windows는 새 터미널을 사용합니다.

claude /logout 후에도 기존 세션이 살아 있음

원인: 다른 터미널의 CLI 세션이나 캐시가 남아 있습니다. 해결: 모든 세션을 닫고 새 터미널에서 다시 시작합니다.

Windows 에서 setx 가 현재 세션에 반영 안 됨

원인: setx는 다음 셸부터 적용됩니다. 해결: Command Prompt 또는 PowerShell을 완전히 닫고 다시 엽니다.

프록시/방화벽 환경

원인: 회사망, 보안 프록시, DNS 정책이 https://api.clcocloud.com/claude/v1 연결을 막을 수 있습니다.

코덱스(Codex) 점검

코덱스: OPENAI 환경변수와 config.toml 충돌

원인: OPENAI_API_KEY·OPENAI_BASE_URL 환경 변수가 남아 있으면 ~/.codex/config.toml 설정보다 먼저 잡힐 수 있습니다. 해결: 두 환경 변수를 제거하고 설정 파일만 남깁니다. (코덱스CLI 가이드 참고)

코덱스: auth.json 키 누락/형식

원인: ~/.codex/auth.json에 OPENAI_API_KEY가 없거나 형식이 틀립니다. 해결: 발급받은 sk-proj- 키를 다시 넣습니다.

코덱스: base_url 오타

원인: config.toml의 base_url이 잘못됐습니다. 해결: https://api.clcocloud.com/codex/v1 인지 확인합니다.