Claude CodeのAPIキーとサブスク課金: どちらを使うべきか

Claude ProやMaxでClaude Codeを対話的に使うだけなら、通常APIキーは不要です。ANTHROPIC_API_KEY が設定されていると、Claude Codeはそのキーを優先し、利用分がClaude ConsoleのAPI課金側に回ることがあります。さらに、プラン内の利用枠を使い切ったあとにusage creditsを有効にすると、以後の利用は標準API料金で別請求になります。大事なのは、契約名ではなく、今のセッションがどのルートで動いているかです。

最初に見るべきなのは /status です。次に /usage、環境変数、Consoleを分けて見ます。ローカルで人間がコードを書くならサブスクログイン、SDKやCIやサーバー側の自動化ならAPIキー、usage creditsは明示的な有料継続、と分けて考えます。

まず有効なルートを確認する

Claude Codeには、Claudeアカウントでログインして使うルートと、APIキーでConsole側に接続するルートがあります。同じPCに両方の設定があっても、請求主体は同じではありません。

ふだんのコード修正、リファクタリング、リポジトリ調査、エラーの読み解きなら、サブスクログインが自然な初期値です。この場合はProまたはMaxの利用枠を見ます。API tokenごとにConsole残高が減る使い方ではありません。

APIキーは、プログラムからClaude APIを呼ぶときの道具です。CI、ヘッドレス実行、チームの自動化、サーバー側agent、評価ハーネス、Console projectでの予算管理が必要な場面では正しい選択になります。

Usage creditsはさらに別です。Pro、Max 5x、Max 20xでプラン内の利用枠に達したあとも続けるための仕組みですが、その後の利用は標準API料金で別請求になります。ProやMaxの中に隠れている追加枠ではなく、creditへの切り替えは明示的な選択として扱うべきです。

サブスクがあるのにAPI課金になる理由

一番多いのは ANTHROPIC_API_KEY が残っているケースです。この変数は .zshrc、.bashrc、.env、ターミナルprofile、devcontainer、CI secret、起動スクリプトなどに入ります。本人はサブスクで使っているつもりでも、Claude CodeはAPIキーを見てConsole側に接続していることがあります。

次に多いのは自動化です。CIやコンテナは人間のブラウザログインに依存しにくいため、APIキーを使う設計のほうが自然です。ただし、その場合はConsoleのAPI費用として管理します。

確認順は短くて十分です。

bash
claude
/status
echo "$ANTHROPIC_API_KEY"

/status がサブスクログインを示すなら、Pro/Maxの利用枠や制限を見ます。APIルートを示すなら、環境変数、Console project、Usageの順に見ます。計画変更や追加課金の前に、この分岐を決めることが重要です。

/status、/usage、/cost、Consoleの役割

/status はルート確認です。現在のセッションがどのアカウントと経路で動いているかを示すため、最初に確認します。

/usage はサブスク利用者がプラン内の使用量、usage-credit消費、Claude Code内の使い方を把握するためのものです。インストール版やチーム内で /stats と呼んでいても、それは使用パターンの表示であり、ConsoleのAPI請求書ではありません。

/cost やusage出力のドル表示はAPI風のtokenコスト見積もりとして読みます。ProやMaxのサブスク料金そのものではありません。APIルートで動かしている場合でも、最終的な確認はConsole Usageです。

ClaudeのSettings > Usageは、プラン内利用とusage-credit消費を分けて見る場所です。Console BillingとUsageは、API route、auto-reload、API project、APIルートでのClaude Code利用を確認する場所です。チームで費用を追うなら、ローカル画面のスクリーンショットではなくConsoleを基準にします。

チームのrunbookでは、/status のルートとSettingsまたはConsoleの台帳を一緒に残します。この2つが、現在の経路と請求ownerを分けて証明します。

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 を見てください。課金ルートの問題とプラン容量の問題は分けます。

Usage creditsと価格の境界

Usage creditsは、付与済みのプラン枠を使い切ったあとにClaudeとClaude Codeを続けるための有料継続です。標準API料金で別請求されます。Console creditsやauto-reloadはAPIルート側の管理であり、Claude ProやMaxの月額に含まれる同一枠ではありません。

2026年5月25日時点で、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キーの上書きを外します。

bash
unset 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風の見積もりとしては有用ですが、サブスク利用、usage credits、API請求はそれぞれ確認先が違います。

本物のAPIキーをチケット、チャット、スクリーンショット、トラブルシュート用プロンプトに貼らないでください。見せるべきなのはキーの値ではなく、変数が存在するかどうかと /status のルートです。

チームで決めておく運用ルール

個人の端末だけなら、毎回 /status を見て判断すれば十分です。チームでClaude Codeを使う場合は、もう一段はっきりしたルールが必要です。ローカルの対話的な作業はサブスクログイン、CIやscheduled jobやserver-side agentはAPIキー、プラン枠後の継続はusage credits、API projectの支払いはConsole、と書いておくと、あとから請求を見たときに議論が早くなります。

特に混ざりやすいのはcreditsです。Usage creditsは、ProやMaxの含まれる利用枠を使い切ったあとに続けるための明示的な有料継続です。一方でConsoleのAPI creditsは、API、Workbench、APIルートで動くClaude Codeの残高です。どちらも「credit」と呼ばれることがありますが、同じ枠ではありません。社内メモでは、usage creditsは個人プラン側の追加使用、API creditsはConsole project側のAPI予算、と分けて書くほうが安全です。

証拠の残し方もルール化できます。見せてよいのは、/status が示すアカウントとルート、同じshellで ANTHROPIC_API_KEY が設定されているかどうか、Settings > Usageで見えるプラン内利用とcredit消費、Console Usageのprojectと期間です。見せてはいけないのは、実際のAPIキー、完全な .env、請求画面全体、関係ないプロジェクト名です。請求調査に必要なのは秘密そのものではなく、どの契約に流れたかを示す境界情報です。

最後に、Maxへ上げる判断とAPIへ移す判断を分けます。Maxは対話的な作業の中断コストを下げるための選択です。APIキーは自動化とプロジェクト会計のための選択です。Usage creditsは、いまのプラン枠を超えても続けるかどうかの選択です。この三つを同じ「もっと使いたい」の一言で扱うと、必要な対策と請求先がずれます。

長い作業を始める前には、簡単なpreflightも有効です。大きなリファクタリング、複数ファイルのreview、release note生成、agentの長時間実行では、開始前に /status、ANTHROPIC_API_KEY の有無、費用を個人プランに置くのかConsole projectに置くのかを確認します。作業メモにこの三つを残しておけば、あとから /cost やConsoleの数字を見ても、どの契約で動いたのか説明できます。

個人ユーザーでも考え方は同じです。Usage creditsの案内が出たとき、それは無料の追加枠ではなく、今すぐ続けるための有料選択です。待てる作業ならリセットを待つ、CIやbackendならAPIとして予算化する、対話的な作業ならプラン比較を見る、という分岐に戻してください。

確認した公式情報

上のルートと請求の切り分けは、2026年5月25日にClaude Help、Claude Code docs、Anthropic billing、Anthropic pricingを確認した内容に基づきます。

自分のアカウントで確認するときも、順番は同じです。/status、ANTHROPIC_API_KEY、Settings > UsageまたはConsole Usage。この順番なら、支払い判断の前に現在のルートを確定できます。

よくある質問

Claude CodeにAPIキーは必要ですか？

通常の対話的な利用では不要です。ProやMaxのClaudeアカウントでログインできます。APIキーはSDK、CI、backend、自動化、Console projectでの管理が必要な場合に使います。

ProやMaxがあるのにAPI課金が出るのはなぜですか？

Claude CodeがAPIルートで動いている可能性があります。/status を確認し、同じ環境で ANTHROPIC_API_KEY が設定されていないか見てください。

Usage creditsはサブスクの残高ですか？

いいえ。Usage creditsはプラン内利用枠を使い切ったあとも続けるための有料継続で、標準API料金で別請求されます。サブスク利用枠とは別です。

Maxへ上げる代わりにAPIを使うべきですか？

作業がCI、SDK、backend、agentのようなAPI型なら検討できます。ローカルでの対話的な制限が問題なら、まず Claude Code usage limit issues とPro/Maxの違いを確認します。

/costはサブスク料金を示していますか？

いいえ。API風のtokenコスト見積もりとして扱います。サブスクは /status と /usage、API請求はConsole Usageで確認します。

Claude CodeがAPIキーを使わないようにするには？

unset ANTHROPIC_API_KEY を実行し、claude logout、claude login、/status の順に確認します。キーが戻る場合は、shell設定、.env、CI secret、container設定を見直してください。