Claude CodeをAPIキーで使う方法｜従量課金の設定と料金

Q: サブスクとAPIキーを両方設定した場合、どちらが使われますか?

ANTHROPICAPIKEYが設定され承認済みであればAPIキー側が優先されます。サブスクに戻すには環境変数を解除し、/statusで確認してください。

Q: GitHub ActionsなどCIから使う場合もAPIキーが必要ですか?

CI環境ではブラウザログインができないため、ANTHROPICAPIKEY(または長期OAuthトークン)をシークレット登録し、環境変数経由で渡すのが基本です。 具体的な設定は「GitHub ActionsでClaude Codeを動かす」で解説しています。 ハブネコのひとこと Spend Limitを設定しておけば、想定外の高額請求を未然に防げます。少額から試して消費量を見ながら上限を調整していく進め方が、安心して使い続けるコツだと感じました。

公開: 2026年8月3日 / 更新: 2026年8月11日・読了目安9分

#APIキー #料金

先に結論: Anthropic ConsoleでAPIキーを発行しANTHROPIC_API_KEY環境変数に設定すると、サブスクより優先されて従量課金でClaude Codeを使えます。Spend Limitを設定すれば想定外の請求も防げます。

Claude Codeは通常、Pro/Maxなどのサブスクでログインして使いますが、Anthropic ConsoleでAPIキーを発行し従量課金(Pay-as-you-go)で使うことも可能です。

この記事では、サブスクとAPI従量課金の違い、APIキーの発行・設定手順、モデル別の料金目安、コスト管理の方法を2026年8月時点の公式情報にもとづいて解説します。

API従量課金は使った分だけ支払う仕組みで、CIやスクリプトからの自動実行にも組み込みやすいのが特徴です。

この記事の要点

Claude CodeはPro/Maxサブスクのほか、Anthropic ConsoleでAPIキーを発行し従量課金でも利用できます。

APIキーはANTHROPIC_API_KEY環境変数に設定すると、サブスクのログイン情報より優先して使われます。

2026年8月時点の料金目安は、Opus 5が入力$5.00/出力$25.00、Sonnet 5が入力$3.00(8月31日まで$2.00)/出力$15.00(同期間$10.00)、Haiku 4.5が入力$1.00/出力$5.00(いずれも100万トークンあたり)です。

Anthropic ConsoleでSpend Limit(支出上限)を設定すると、指定額に達した時点でAPIリクエストが自動的に止まります。

サブスクに戻すにはunset ANTHROPIC_API_KEY(Windowsは Remove-Item Env:ANTHROPIC_API_KEY)を実行し、/statusで確認します。

前提・動作環境

この記事は、Claude Codeがインストール済みでclaudeコマンドを実行できる状態を前提にしています。基本操作を確認していない方は、先に「Claude Codeの使い方完全ガイド」に目を通しておくとスムーズです。

対象OSはWindows・macOS・Linux共通の手順で、追加でAnthropicアカウント(Console用)があれば十分です。

サブスク(Pro/Max)とAPI従量課金、どちらを選ぶべきか

Claude Codeの支払い方法は大きく2種類です。ひとつはClaude Pro・Maxなどのサブスクリプションで、月額固定料金の範囲内で利用できます。

もうひとつはAnthropic Consoleで発行するAPIキーによる従量課金で、実際に使ったトークン数に応じて請求されます。

サブスクとAPI従量課金の対比図。課金方式・キーの発行元・優先順位・向いている用途の4項目を比較し、サブスクは月額固定でclaude.aiログイン、API従量課金はトークン従量課金でAnthropic Console発行のANTHROPIC_API_KEYが設定・承認されるとサブスクより優先されることを示す

とりあえず試したい、日常的にコーディングに使うならPro・Maxの方がコスト効率がよいことがほとんどです。プラン別の料金比較は「Claude Code料金まとめ」で解説しています。

一方、使用量が読めず従量課金が安く済むとき、プロジェクトごとにコストを分けたいとき、CI/CDから自動で呼び出したいとき(例は「GitHub ActionsでClaude Codeを動かす」参照)はAPIキーが向いています。

自作アプリに組み込む場合もAPIキーを使う形になり、実装の進め方は「Claude Agent SDK」が参考になります。

Anthropic ConsoleでAPIキーを発行する

APIキーはAnthropic Consoleから発行します。

Anthropicアカウントでログイン(未作成なら新規登録)
支払い方法を登録し、クレジット残高を確認・追加する
左メニューの「API Keys」からAPIキーを新規作成する
キー名を設定し、発行されたキー(sk-ant-で始まる文字列)を控える

発行直後にしか全文が表示されないため、その場でパスワードマネージャーなどに保存してください。

メンバーを招待する場合は、「Claude Code」ロール(APIキー発行のみ)と「Developer」ロール(全種類のAPIキーを発行可)を用途に応じて使い分けましょう。

ANTHROPIC_API_KEYを設定してClaude Codeで使う

APIキーを取得したら、ANTHROPIC_API_KEY環境変数に設定します。

macOS/Linux(bashやzsh)の場合:

export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxxxxx"
claude

Windows(PowerShell)の場合:

$env:ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxxxxx"
claude

Windowsで恒久的に設定するには、PowerShellでsetx ANTHROPIC_API_KEY "sk-ant-xxxxxxxxxxxxxxxx"を実行します(反映には新しいターミナルの起動が必要です)。

環境変数を設定した状態でclaudeを起動すると、ブラウザログイン画面の代わりにAPIキーを使うかの確認が表示されます。承認すると以後はAPIキーで動作し、切り替えは/configの「Use custom API key」トグルから行えます。

Claude Codeは複数の認証情報がある場合、ANTHROPIC_API_KEYをサブスクのログイン情報より優先します。

Pro/Maxでログイン済みの環境で設定すると、承認時点からAPIキー側に切り替わります。

サブスクに戻すにはunset ANTHROPIC_API_KEY(WindowsはRemove-Item Env:ANTHROPIC_API_KEY)を実行し/statusで確認してください。

なお、ブラウザ版のClaude Code on the Webは常にサブスクを使うため、この環境変数の影響を受けません。

ANTHROPIC_BASE_URLで外部のAIゲートウェイに接続する構成の紹介も見かけますが、Pro/MaxのOAuthトークンを外部ツールへ流用する使い方は規約上許可されていないため、「OmniRouteでClaude Codeは無料になる?」もあわせてご確認ください。

料金の目安:モデル別単価とコスト管理

料金は使用するモデルとトークン数(入力・出力)によって決まります。2026年8月時点の主なモデルの目安は次のとおりです。

モデル別の入力単価を階段状に比較する図。Claude Haiku 4.5が入力100万トークンあたり1.00ドルでもっとも安く、Claude Sonnet 5が3.00ドル(2026年8月31日まで2.00ドル)、Claude Opus 5が5.00ドルでもっとも高いことを示す。

モデル	入力 $/100万トークン	出力 $/100万トークン
Claude Opus 5	$5.00	$25.00
Claude Sonnet 5	$3.00(2026年8月31日まで$2.00)	$15.00(同期間$10.00)
Claude Haiku 4.5	$1.00	$5.00

1セッションのコストはタスク規模で変わりますが、目安として小規模な修正1回なら数万トークン程度(Sonnetで数十円前後)、複数ファイルの大きめのリファクタリングなら数十万トークンで数百円規模になることもあります。

料金は改定されやすいため、契約前に公式サイトの料金ページで最新情報を確認してください。

コストを管理するには、Consoleの使用量画面でモデル別・日別の消費量を確認できます。

Spend Limitを設定しておくと、設定した金額に達した時点でAPIリクエストが自動的に止まるため、想定外の高額請求を防げます。まずは少額から試し、消費量を見ながら調整しましょう。

身に覚えのない請求を防ぐには:自動リチャージ・上限・2FA

海外のOpenAI Developer Communityなどでは、2026年8月時点でAPIキー漏洩による身に覚えのない高額請求の報告が利用者から複数寄せられています。

Claude Code自体の障害ではありませんが、APIキーを使う以上どのサービスでも起こりうるリスクのため、Anthropic Consoleでも次の3点を確認しておくと安心です。

自動リチャージ(auto-reload)の閾値と補充額を見直す: Anthropic Consoleには、クレジット残高が設定した閾値を下回ると自動で追加課金される機能があります。有効にしている場合は1回あたりの補充額と閾値を確認し、想定外に課金が膨らまないようにしましょう。上限を厳密に固定したいなら無効化し、購入した分だけに支出を限定できます。
月間のSpend Limitを設定する: 「Limits」から月間の支出上限を設定でき、自動リチャージが有効でも上限に達すると課金が止まります。OpenAI PlatformにもOrganization/Project単位のHard Limitがあり、有効にすると上限到達時にAPIリクエストが429エラーで停止します(OpenAI公式ヘルプ・APIドキュメントで確認済み)。
2段階認証(2FA/MFA)を有効にする: OpenAIはアカウント設定の「セキュリティ」からMulti-factor authentication(認証アプリ・プッシュ通知・SMS)を有効にでき、有効化後はChatGPTとAPI Platform両方に適用されます。他サービスでも2段階の確認手段があれば有効化し、パスワードは使い回さないようにしてください。

キーの管理に加えて請求側の上限設定まで済ませておくと、万一キーが漏洩した場合の被害を最小限に抑えられます。

つまずきポイント・よくあるエラー

バグイヌ

うっかり.envファイルごとAPIキーをリポジトリにpushしてしまいました…。git履歴から消せばなかったことになりますか?

ハブネコ

履歴から消しても残ってしまうため、それだけでは不十分です。Anthropic Consoleでそのキーを速やかに失効・再発行してください。

設定してもサブスクのままになる:起動時の承認プロンプトで「いいえ」を選ぶとサブスク側が使われ続けます。/configのトグルを確認してください。
invalid x-api-keyエラー:キーの前後に余分な空白や改行がないか確認します。Consoleでの再発行が確実です。
古いキーが優先され認証エラーになる:無効・期限切れのキーが環境変数に残っていると優先されます。unset ANTHROPIC_API_KEYで外し、/statusで確認してから再設定してください。
キーをリポジトリに誤ってコミットしてしまった:.envなどに書く場合は必ず.gitignoreに追加し、誤ってコミットしたらConsoleで速やかに失効・再発行してください。push済み履歴から削除しても残るため、失効が最優先です。

よくある質問

サブスクとAPIキーを両方設定した場合、どちらが使われますか?

ANTHROPIC_API_KEYが設定され承認済みであればAPIキー側が優先されます。サブスクに戻すには環境変数を解除し、/statusで確認してください。

APIキーでの利用にPro/Maxのような使用量制限はありますか?

サブスクの5時間ローリングウィンドウのような制限はなく、Consoleで設定するレート制限(RPM/TPMなど)とSpend Limitの範囲内で利用できます。

GitHub ActionsなどCIから使う場合もAPIキーが必要ですか?

CI環境ではブラウザログインができないため、ANTHROPIC_API_KEY(または長期OAuthトークン)をシークレット登録し、環境変数経由で渡すのが基本です。

具体的な設定は「GitHub ActionsでClaude Codeを動かす」で解説しています。

ハブネコのひとこと

Spend Limitを設定しておけば、想定外の高額請求を未然に防げます。少額から試して消費量を見ながら上限を調整していく進め方が、安心して使い続けるコツだと感じました。

まとめ

Claude CodeはPro/Maxサブスクのほか、Anthropic Consoleで発行するAPIキーによる従量課金でも利用できます。APIキーを発行しANTHROPIC_API_KEYを設定すればサブスクより優先されて動作し、使った分だけ支払う形になります。

料金はモデルとトークン数で変動するため、Spend Limitの設定と使用量画面のチェックを習慣にしましょう。