빠른 답변
Claude Code는 여러 방식으로 authenticate할 수 있습니다. individual users는 주로 Claude.ai account로 sign in합니다. API users 또는 teams는 Claude Console, cloud providers 또는 지원되는 third-party provider path를 사용할 수 있습니다. Claude.ai account와 API Key는 같은 것이 아닙니다. Claude.ai login은 official product experience용입니다. API Key는 model API requests에 사용하며 일반적으로 Base URL 및 provider configuration과 함께 사용합니다. third-party API gateway를 사용한다면 중요한 fields는 API Key와 Base URL입니다. tool이 Anthropic-compatible 또는 OpenAI-compatible protocol을 기대하는지도 확인해야 합니다.이 내용이 필요한 경우
- Claude Code setup 중 login prompt가 표시됨
- Claude Pro 또는 Max가 API Key를 제공하는지 확실하지 않음
- Claude Code를 custom API gateway를 통해 route하고 싶음
- official login과 third-party provider 중 선택해야 함
- team에 일관된 authentication pattern이 필요함
주요 개념
권장 decision flow
- official Claude Code experience만 원하고 Claude.ai plan을 사용한다면 official login으로 시작하세요.
- API billing 또는 team-managed API access가 필요하면 Claude Console 또는 team provider를 검토하세요.
- custom API gateway가 필요하면 Claude Code가 provider path를 지원하는지 확인한 다음 API Key와 Base URL을 설정하세요.
- official app features와 third-party inference provider가 모두 필요하면 official login state를 유지해야 하는지 결정하세요.
https://www.bettertoken.ai입니다.
일반적인 실수
- Claude.ai subscription을 API Key로 취급함
- ChatGPT Plus 또는 다른 subscription credential을 Claude Code에 붙여넣음
- API Key만 복사하고 Base URL 변경을 잊음
- Claude Code의 Anthropic-compatible configuration에 OpenAI-compatible Base URL을 입력함
auth.json, refresh tokens 또는 session credentials를 API Keys처럼 공유함
BetterToken 정보
API Key + Base URL path를 선택하면 BetterToken이 compatible endpoint와 API Keys, balance, usage history를 위한 dashboard를 제공할 수 있습니다. BetterToken은 Claude.ai login을 대체하거나 Claude.ai subscription을 API Key로 바꾸지 않습니다. model API layer만 처리합니다.관련 문서
- Claude Code 설정 가이드
- Claude Code에서 API Key와 Base URL 구성
- third-party API를 사용하면서 Codex login state 유지
- OpenAI-compatible API와 Anthropic-compatible API 비교