개인 계정 로그인 대신 API Key로 Claude Code를 사용하려면 ANTHROPIC_API_KEY 환경 변수에 API Key를 등록합니다.
이렇게 등록한 상태로 터미널에서 claude 명령을 실행하면, 등록한 API Key를 사용할지 묻는 확인 화면이 나타납니다.

API Key 사용 여부 확인

API Key를 사용하려면 Yes를 선택해야 하는데, 기본 선택이 No (recommended)이므로, 화면을 자세히 읽지 않고 Enter를 누르면 API Key를 사용하지 않는 쪽으로 결정됩니다.
계정 로그인이 권장 경로라서 이렇게 되어 있는데, API Key를 쓰려던 상황에서는 의도와 반대되는 선택입니다.

여기서 실수를 알아차리고 Claude Code를 종료한 뒤 다시 실행해도, 이 확인 화면은 더 이상 나타나지 않습니다.
선택 결과가 파일에 기록되고, 기록이 남아 있는 API Key에 대해서는 다시 묻지 않기 때문입니다.
이는 홈 디렉터리 .claude.json 파일의 customApiKeyResponses 속성에 저장됩니다.

• macOS: ~/.claude.json
• Windows: C:\Users\사용자명\.claude.json

1
2
3
4
5
6
{
  "customApiKeyResponses": {
    "approved": [],
    "rejected": ["AbCdEfGhIjKlMnOpQrSt"]
  }
}

배열(Array)에 들어가는 값은 API Key 전체가 아니라 키의 마지막 20자입니다.
어떤 API Key에 대한 응답인지 구분하기 위한 식별자이며, 전체 키를 이 파일에 평문으로 남기지 않으려는 목적도 있습니다.

Claude Code는 실행할 때 환경 변수에서 마지막 20자를 잘라내 두 배열과 대조하고, 세 가지 상태 중 하나로 판정합니다.

확인 화면은 미결정 상태에서만 나타납니다.
실수로 No를 선택하면 API Key가 rejected에 들어가면서 거절 상태가 되므로, 확인 화면도 나오지 않고 API Key도 사용되지 않습니다.
로그아웃을 하거나 Claude Code를 재설치해도 이 기록은 그대로 남습니다.

따라서 rejected 배열에서 해당 값만 제거하면 판정이 다시 미결정 상태로 돌아가고, 다음 실행에서 확인 화면이 나타납니다.
배열에 값이 하나뿐이라면 빈 배열로 두면 됩니다.

1
2
3
4
5
6
{
  "customApiKeyResponses": {
    "approved": [],
    "rejected": []
  }
}

파일을 직접 편집하지 않는 방법도 있습니다.
ANTHROPIC_API_KEY 환경 변수가 등록된 상태라면, 개인 구독제 계정 등으로 로그인한 후에 /config에서 Use custom API key 항목을 false에서 true로 변경하면 해당 API Key가 rejected에서 approved로 이동합니다.
다시 로그아웃하고 API Key를 사용하도록 시도합니다.

Use custom API key 옵션 활성화 필요