Claude ProやMaxでClaude Codeを対話的に使うだけなら、通常APIキーは不要です。ANTHROPIC_API_KEY が設定されていると、Claude Codeはそのキーを優先し、利用分がClaude ConsoleのAPI課金側に回ることがあります。大事なのは、契約名ではなく、今のセッションがどのルートで動いているかです。
最初に見るべきなのは /status です。ローカルで人間がコードを書くならサブスクログイン、SDKやCIやサーバー側の自動化ならAPIキー、Consoleで買ったAPI creditsはAPIルート用の別残高、と分けて考えます。
| 状況 | 使うべきルート | 請求元 | 最初に見るもの |
|---|---|---|---|
| Pro/Maxでターミナルから対話的に使う | サブスクログイン | Claudeプランの利用枠 | /status |
ANTHROPIC_API_KEY がある、または自動化で動かす | APIキールート | Claude ConsoleのAPI利用 | 環境変数とConsole Usage |
| API creditsやauto-reloadを有効にした | API credits | Consoleのプリペイド残高 | Console Billing |
| サブスクがあるのにAPI料金が出る | 先にルート診断 | APIキーが優先された可能性 | /status と echo "$ANTHROPIC_API_KEY" |
まず有効なルートを確認する
Claude Codeには、Claudeアカウントでログインして使うルートと、APIキーでConsole側に接続するルートがあります。同じPCに両方の設定があっても、請求主体は同じではありません。
ふだんのコード修正、リファクタリング、リポジトリ調査、エラーの読み解きなら、サブスクログインが自然な初期値です。この場合はProまたはMaxの利用枠を見ます。API tokenごとにConsole残高が減る使い方ではありません。
APIキーは、プログラムからClaude APIを呼ぶときの道具です。CI、ヘッドレス実行、チームの自動化、サーバー側agent、評価ハーネス、Console projectでの予算管理が必要な場面では正しい選択になります。
API creditsはさらに別です。ConsoleにあるAPI用のプリペイド残高であり、API、Workbench、APIルートのClaude Codeに使われます。ProやMaxの中に隠れている追加枠ではありません。
サブスクがあるのにAPI課金になる理由
一番多いのは ANTHROPIC_API_KEY が残っているケースです。この変数は .zshrc、.bashrc、.env、ターミナルprofile、devcontainer、CI secret、起動スクリプトなどに入ります。本人はサブスクで使っているつもりでも、Claude CodeはAPIキーを見てConsole側に接続していることがあります。
次に多いのは自動化です。CIやコンテナは人間のブラウザログインに依存しにくいため、APIキーを使う設計のほうが自然です。ただし、その場合はConsoleのAPI費用として管理します。
確認順は短くて十分です。
bashclaude /status echo "$ANTHROPIC_API_KEY"
/status がサブスクログインを示すなら、Pro/Maxの利用枠や制限を見ます。APIルートを示すなら、環境変数、Console project、Usageの順に見ます。計画変更や追加課金の前に、この分岐を決めることが重要です。
/status、/stats、/cost、Consoleの役割
/status はルート確認です。現在のセッションがどのアカウントと経路で動いているかを示すため、最初に確認します。
/stats はサブスク利用者がClaude Code内の使い方を把握するためのものです。どの作業で利用枠を使いやすいかは見えますが、ConsoleのAPI請求書ではありません。
/cost はAPI風のtokenコスト見積もりとして読みます。ProやMaxのサブスク料金そのものではありません。APIルートで動かしている場合でも、最終的な確認はConsole Usageです。
Console BillingとUsageは、API credits、auto-reload、API project、APIルートでのClaude Code利用を確認する場所です。チームで費用を追うなら、ローカル画面のスクリーンショットではなくConsoleを基準にします。
APIキーを使うべき場面
APIキーは、Claude Codeをより上級者らしく見せるための設定ではありません。作業がAPIとして運用されるときに使うものです。
使うべき場面は次のようなものです。
- SDKやbackendからClaude APIを呼ぶ
- CIやscheduled jobで人間のログインなしに走らせる
- チームのConsole projectに費用を集約したい
- agentやbatch処理を監査可能にしたい
- budget controlとUsage履歴をConsoleで見たい
- 利用モデルのAPI料金で支払う前提がある
一方、単にローカルの対話作業で制限が気になるだけなら、まず Claude Code Pro vs Max を見てください。課金ルートの問題とプラン容量の問題は分けます。
API Creditsと価格の境界
Claude ConsoleのAPI creditsはAPI用の残高です。API、Workbench、APIルートのClaude Codeを支えます。Claude ProやMaxのサブスク利用枠とは別に管理されます。
2026年4月20日時点で、Anthropicの公開価格ページはモデルごとにinput tokenとoutput tokenの価格を示しています。たとえばClaude Sonnet 4.6は100万input tokenあたり3ドル、100万output tokenあたり15ドル、Claude Opus 4.7はそれぞれ5ドルと25ドルです。これは確認日時付きの例であり、実際の予算では最新の公式価格とConsoleを確認してください。
判断軸は、APIが常に安いかどうかではありません。人間の長時間の対話的コーディングならサブスクのほうが読みやすく、CIやbackendやbatch処理ならAPIルートのほうが管理しやすい。無料枠の有無を知りたい場合は、Claude API Key free tier guide のような別トピックとして確認します。
サブスクログインに戻す手順
サブスクで使うつもりだったのにAPI費用が出ている場合、まず現在のshellからAPIキーの上書きを外します。
bashunset ANTHROPIC_API_KEY claude logout claude login claude /status
この操作はClaude ConsoleのAPIキーを削除しません。現在のshellでキーを渡さないようにし、Claude Codeをログインし直して、次のセッションがサブスク側に戻ったか確認するための手順です。
新しいターミナルを開くたびにキーが戻るなら、永続設定が残っています。shell設定、プロジェクト .env、devcontainer、CI secret、IDEのlauncher scriptを確認します。チームでは、ローカル対話はサブスク、自動化はAPIキー、API費用はConsoleで確認、という運用メモを残すだけでも事故を減らせます。
混同しないこと
Claude Codeにログインできるからといって、API利用がサブスクに含まれるわけではありません。ProやMaxはClaudeアカウントでClaude Codeを使うルートを提供しますが、汎用API呼び出しはConsole側の契約です。
/cost をサブスク請求として読まないでください。API風の見積もりとしては有用ですが、サブスク利用、プラン制限、API請求はそれぞれ確認先が違います。
本物のAPIキーをチケット、チャット、スクリーンショット、トラブルシュート用プロンプトに貼らないでください。見せるべきなのはキーの値ではなく、変数が存在するかどうかと /status のルートです。
確認した公式情報
上のルートと請求の切り分けは、2026年4月20日にClaude Help、Claude Code docs、Anthropic billing、Anthropic pricingを確認した内容に基づきます。
自分のアカウントで確認するときも、順番は同じです。/status、ANTHROPIC_API_KEY、Console Usage。この順番なら、支払い判断の前に現在のルートを確定できます。
よくある質問
Claude CodeにAPIキーは必要ですか？
通常の対話的な利用では不要です。ProやMaxのClaudeアカウントでログインできます。APIキーはSDK、CI、backend、自動化、Console projectでの管理が必要な場合に使います。
ProやMaxがあるのにAPI課金が出るのはなぜですか？
Claude CodeがAPIルートで動いている可能性があります。/status を確認し、同じ環境で ANTHROPIC_API_KEY が設定されていないか見てください。
API creditsはサブスクの残高ですか？
いいえ。API creditsはClaude ConsoleのAPI用残高です。サブスク利用枠とは別です。
Maxへ上げる代わりにAPIを使うべきですか？
作業がCI、SDK、backend、agentのようなAPI型なら検討できます。ローカルでの対話的な制限が問題なら、まず Claude Code usage limit issues とPro/Maxの違いを確認します。
/costはサブスク料金を示していますか？
いいえ。API風のtokenコスト見積もりとして扱います。サブスクは /status と /stats、API請求はConsole Usageで確認します。
Claude CodeがAPIキーを使わないようにするには？
unset ANTHROPIC_API_KEY を実行し、claude logout、claude login、/status の順に確認します。キーが戻る場合は、shell設定、.env、CI secret、container設定を見直してください。