Claude Code実践ガイド
Claude CodeをAPIキーで使う｜従量課金・SDK・ヘッドレス実行
Claude Codeは、Pro/Maxの定額プランだけでなくAPIキーによる従量課金でも動きます。そしてAPIキー方式に切り替えると、単に支払い方が変わるだけでなく、対話せずに実行する・自動処理に組み込むという別の使い方が開けます。このページでは、どちらを選ぶべきかの判断から、ヘッドレス実行とSDKによる組み込みまでを整理します。
このサイトは Anthropic や Claude の公式サイトではありません。Claudeの基本的な使い方、ChatGPTとの違い、文章作成・長文整理・仕事での活用を初心者向けに整理する非公式ガイドです。機能・料金・提供状況は変更される可能性があるため、重要な判断ではAnthropic公式情報も確認してください。
定額プランとAPIキー、どちらを選ぶか
| 使い方 | 定額プラン（Pro/Max） | APIキー（従量課金） |
|---|---|---|
| 毎日、対話しながら使う | 有利。上限内なら定額で気にせず使える | 使うほど積み上がる。ヘビー利用では定額を大きく超えることも |
| 月に数回しか使わない | 使わない月も満額 | 有利。使わなければ0円 |
| 自動処理・CIに組み込む | 不向き（人の対話利用が前提） | こちらが前提 |
| 費用の上限管理 | プランの利用枠で自然に止まる | 予算設定とアラートを自分で設定する |
| 会社の経費処理 | 個人契約になりがち | 組織のクラウド課金に載せやすい |
迷ったら判断はシンプルです。「人が画面の前にいる作業」は定額、「人がいない場所で走らせる作業」はAPIキー。両方やりたい場合、環境変数の設定を切り替えるだけで併用もできます。定額プラン側の枠の仕組みは料金ページで詳しく扱っています。
APIキーでの設定手順
- APIキーを発行する──Anthropicのコンソール（console.anthropic.com）でアカウントを作り、キーを発行します。Claudeの月額プランとは別の課金体系なので、支払い方法の登録が必要です
- 予算とアラートを先に設定する──ここを飛ばさないでください。従量課金は「気づいたら使いすぎていた」が起こり得ます。使い始める前に上限を決めます
- 環境変数に設定する──
ANTHROPIC_API_KEYにキーを設定すると、Claude Codeはそちらを使うようになります - 少額で試す──最初は数ドル分で、実際の作業がどれくらい消費するかを体感してから本格運用へ
キーはソースコードに書かず、環境変数か秘密情報の管理機構で渡してください。うっかりコミットする事故はGitHub連携ページで扱った通り、対策を先に組んでおくのが安全です。
ヘッドレス実行──対話せずに走らせる
APIキー方式で本領を発揮するのがこれです。-p（print）オプションを付けると、Claude Codeは対話画面を出さずに、指示を1回実行して結果を標準出力に返して終了します。
claude -p "このディレクトリのCSVを集計してレポートを出力して"
この形になると、Claude Codeはシェルスクリプトの中に置ける部品になります。他のコマンドの出力をパイプで渡す、結果をファイルに書く、cronで定期実行する、といった普通のUNIX的な組み合わせがそのまま使えます。出力形式をJSONで受け取る指定もできるので、後続の処理に渡すのも容易です。
ただし注意が1つ。対話がないということは、確認プロンプトに人が答えられないということです。許可の扱いを緩める設定が必要になる場面がありますが、その場合は「AIが確認なしに実行できる範囲」を自分で線引きしていることになります。作業ディレクトリを限定する、コンテナ内で走らせるなど、影響範囲を物理的に囲う対策と併せて考えてください。具体的な組み方は自動化ページで扱います。
SDK──自分のアプリにClaude Codeを組み込む
コマンドとして呼ぶのではなく、自分のプログラムからClaude Codeの仕組みを使いたい場合はSDKがあります。TypeScript版とPython版が提供されており、「ファイルを読み書きし、コマンドを実行し、目的が達成されるまで自律的に進む」というClaude Codeの中身を、自作アプリの一部として使えるのが要点です。
- 社内ツールに「コードを直す機能」を組み込む
- 問い合わせ内容に応じて調査を自動実行する仕組みを作る
- 定型的な運用作業（設定変更、レポート生成）を担当するエージェントを立てる
ここまで来ると、Claude Codeは「開発を手伝う道具」ではなく「エージェントを作るための土台」になります。ターミナルで使うのが入口、SDKが奥、という関係です。
従量課金の費用感と、抑えるコツ
従量課金の請求は「処理した量 × モデルの単価」で決まります。回数ではありません。ここを理解しないと、体感と請求額が合わずに驚くことになります。
| 費用が増える要因 | 効き方 |
|---|---|
| 使うモデル | 最も大きい。上位モデルと軽量モデルでは単価が大きく違う |
| 読ませる量 | 大きなファイルやフォルダ全体を読ませると跳ね上がる |
| 会話の長さ | 続けるほど毎回の処理量が積み上がる |
| 出力の長さ | 長い生成物ほど費用がかかる |
| リトライ | 自動処理で最も危険。失敗を延々繰り返して費用だけ積む |
体感を正直に書くと、対話でしっかり使うと1日で数ドル規模になることは普通にあります。だからこそ、毎日使うなら定額プランの方が安心という結論になります（プランの比較）。
一方、自動処理での利用は工夫で大きく変わります。効く順に挙げます。
- モデルを作業に見合わせる──定型処理に最上位モデルを使うのは無駄です。ここが最も効きます（モデル選択の考え方）
- 読ませる範囲を絞る──「フォルダ全体」ではなく対象ファイルを指定する
- 繰り返す前提部分をキャッシュさせる──同じ長い前提を毎回送る処理では、プロンプトキャッシュが効くよう組み立てを見直す価値があります
- 失敗時の暴走を止める──実行時間と試行回数の上限を必ず設けてください。無人実行で最も多い事故がこれです
- 予算アラートを設定する──使い始める前に設定します。後からでは遅いです
なお、定額プランと従量課金は併用できます。環境変数の有無で切り替わるので、「人が対話する作業は定額、夜間バッチはAPIキー」という分担が可能です。用途ごとに設定を分けておけば、切り替えの手間はほとんどありません。
Bedrock・Vertex AI経由という選択肢
AWSのBedrockやGoogle CloudのVertex AI経由でClaudeモデルを使う構成にも対応しています。機能面の差より、組織の都合で選ぶものと考えてください。
- 既にAWSやGoogle Cloudと契約していれば、請求を既存のクラウド契約に集約できる
- 権限管理・監査ログを、既に運用しているクラウドの仕組みに載せられる
- 結果として、情シスや購買との調整が早く済むことが多い
会社での導入を進める場合は、この選択肢を早めに机に載せると話が進みやすくなります。詳しくは法人導入ページを参照してください。
AIガイド群
FAQ
定額プランとAPIキーを両方持つ意味はありますか？
あります。人が対話する作業は定額プラン、夜間バッチやCIはAPIキー、という分担です。環境変数の有無で切り替わるので、用途ごとに設定を分けておけば併用は難しくありません。
APIキーだと使える機能が減りますか？
Claude Codeの基本的な動作は同じです。違いは支払い方と、対話を前提としない使い方が開ける点です。ただしプラン限定の提供内容が変わる可能性はあるため、重要な判断の前には公式情報で確認してください。
費用が想定より膨らみました。何を見直すべきですか？
まずモデルの選択、次に1回あたりに読ませている範囲です。自動処理なら、失敗時のリトライが無限に回っていないかも確認してください。予算アラートは設定前提です。
SDKを使うにはプログラミングの知識が必要ですか？
必要です。ただし「SDKを使ったツールを作る作業」自体をClaude Codeに手伝わせられるので、実際の障壁は思うより低い場面もあります。