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

公開: 2026年8月3日

Claude Codeは通常、Pro/Maxなどのサブスクでログインして使いますが、Anthropic ConsoleでAPIキーを発行し従量課金(Pay-as-you-go)で使うことも可能です。この記事では、サブスクとAPI従量課金の違い、APIキーの発行・設定手順、モデル別の料金目安、コスト管理の方法を2026年8月時点の公式情報にもとづいて解説します。API従量課金は使った分だけ支払う仕組みで、CIやスクリプトからの自動実行にも組み込みやすいのが特徴です。

前提・動作環境

この記事は、Claude Codeがインストール済みでclaudeコマンドを実行できる状態を前提にしています。基本操作を確認していない方は、先に「Claude Codeの使い方完全ガイド」に目を通しておくとスムーズです。対象OSはWindows・macOS・Linux共通の手順で、追加でAnthropicアカウント(Console用)があれば十分です。

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

Claude Codeの支払い方法は大きく2種類です。ひとつはClaude Pro・Maxなどのサブスクリプションで、月額固定料金の範囲内で利用できます。もうひとつはAnthropic Consoleで発行するAPIキーによる従量課金で、実際に使ったトークン数に応じて請求されます。

とりあえず試したい、日常的にコーディングに使いたい場合はPro・Maxの方がコスト効率がよいことがほとんどです。プラン別の料金比較は「Claude Code料金まとめ」で解説しています。一方、使用量が読めず従量課金の方が安く済むとき、プロジェクトごとにコストを分けたいとき、CI/CDから自動で呼び出したいとき(例は「GitHub ActionsでClaude Codeを動かす」を参照)はAPIキーが向いています。

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は常にサブスクを使うため、この環境変数の影響を受けません。

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

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

モデル	入力 $/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リクエストが自動的に止まるため、想定外の高額請求を防げます。まずは少額から試し、消費量を見ながら調整しましょう。

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

設定してもサブスクのままになる:起動時の承認プロンプトで「いいえ」を選ぶとサブスク側が使われ続けます。/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を動かす」で解説しています。

まとめ

Claude CodeはPro/Maxサブスクのほか、Anthropic Consoleで発行するAPIキーによる従量課金でも利用できます。APIキーを発行しANTHROPIC_API_KEYを設定すればサブスクより優先されて動作し、使った分だけ支払う形になります。料金はモデルとトークン数で変動するため、Spend Limitの設定と使用量画面のチェックを習慣にしましょう。プラン比較は「Claude Code料金まとめ」、基本操作は「Claude Codeの使い方完全ガイド」もあわせてご確認ください。