Claude Code 認証ガイド：アカウント、API Key、LLM Gateway

Claude Code は公式に Claude サブスクリプションアカウント、Anthropic Console API アクセス、およびドキュメントに記載されたエンタープライズクラウドプロバイダーをサポートしている。組織は CLI が LLM gateway を通じて組織発行の資格情報を使用することも可能。

これらの方式は課金、モデルの可視性、利用できるインターフェースが異なる。サードパーティの gateway の API Key は Claude サブスクリプションとしては説明できないし、claude.ai ウェブや Remote Control などのアカウント機能も自動では付与されない。

初回実行時に claude はブラウザ認証を案内する。その後にアカウントを切り替えたい場合は、対話セッションで /login を実行する。保存済みログインを破棄するには /logout を実行する。

認証後に /status を実行し、現在のログイン方法、モデル、Anthropic base URL が設定されているかを確認する。「CLI を起動できた」だけでリクエストの行き先を判断してはいけない。

ANTHROPIC_AUTH_TOKEN は保存済みアカウントより直ちに優先される。ANTHROPIC_API_KEY は -p の非対話モードで直接使用され、対話モードでは初回検出時に採用するか尋ねて選択を記憶し、/config で調整できる。

本物の Key をリポジトリ、チュートリアルのスクリーンショット、コマンド履歴、コミット可能な .claude/settings.json に書き込まないこと。例のプレースホルダーはユーザーがローカルで置き換える必要がある。

ANTHROPIC_AUTH_TOKEN は Authorization: Bearer として送信され、ANTHROPIC_API_KEY は x-api-key として送信される。gateway が 401 を返す場合、Key が有効かを確認するほか、サーバー側がどのリクエストヘッダーを期待しているかも確認する。

Gateway の接続には少なくとも base URL と資格情報が必要。まず一時的な shell で検証し、その後どう永続化するかを決めることで、URL、認証、Claude Code 本体の問題をレイヤーごとに切り分けられる。

~/.claude/settings.json はユーザーグローバル設定に適し、.claude/settings.local.json は単一プロジェクトで共有しない設定に適す。なお gitignore に追加済みかを確認すること。共有の .claude/settings.json に資格情報を含めてはいけない。

token のローテーションが必要な組織は、JSON に固定平文を保存するのではなく apiKeyHelper を使ってシークレット保管庫から読み出せる。設定完了後は /status で実際に採用された資格情報の元を確認する。

ANTHROPIC_AUTH_TOKEN は保存済みの claude.ai ログインを上書きする。ANTHROPIC_API_KEY を対話セッションで使用するかは初回の選択または /config 設定によるが、-p モードでは常に使用される。変数を解除すれば保存済みアカウントに戻せる。

トラブルシューティングの順序は、/status の確認、base URL の確認、資格情報変数とリクエストヘッダーの確認、最小リクエストの送信、最後にモデル名の確認とする。未知のモデルエラーは通常、認証とネットワークが通っていることを示し、問題はモデルルーティングにある。