claude code apiの使い方｜キー設定・料金・SDKの違い
「claude code api」と検索して、Claude CodeをAPIキーで動かせるのか、Claudeのサブスクと何が違うのか、アプリへ組み込むには何を選べばよいのか迷っていませんか。この記事では、Claude Codeの認証経路、Claude APIとの役割の違い、CLI・SDK・Routinesの選び方、料金とキー管理の注意点を順に整理します。
Claude Codeは単独の公開REST API名ではなく、サブスクまたはClaude ConsoleのAPIキーで利用する開発環境です。ターミナル操作はCLI、アプリ組み込みは公式SDK、外部から定型処理を起動するならRoutinesを選び、料金と権限を分けて安全に運用できるとわかる。
目次 (7)
claude code apiは何を指す？まず3つの意味を分ける
「Claude Code API」という名前の単一エンドポイントが用意されているわけではありません。Claude Codeはターミナルや対応する開発環境で動き、AnthropicのモデルAPIへリクエストを送って、プロジェクトのファイル確認・編集・コマンド実行などを進めます。製品ページでも、Claude Codeはローカルのターミナルで動作し、モデルAPIと直接通信すると説明されています。
検索者が知りたい内容は、次のように分けると整理しやすくなります。
- APIキーでClaude Codeを使う方法 — Claude Consoleのキーを環境変数に入れて、CLIを起動する
- Claude Codeをスクリプトから呼ぶ方法 —
claude -pで非対話の処理を実行し、テキストやJSONを受け取る - 開発中のアプリへ機能を組み込む方法 — Claude APIのクライアントSDK、またはClaude Code向け公式SDKを使う
- クラウド上の処理を外部から起動する方法 — Claude Code RoutinesのAPIトリガーを利用する
一方、通常のClaude APIは、アプリからMessages APIへテキストやツール呼び出しを送るための開発者向けAPIです。コードベースを読み、変更を提案し、コマンドを実行するClaude Codeの操作環境とは役割が異なります。APIの全体像は公式ドキュメント（https://platform.claude.com/docs/en/api/overview）、Claude Codeの製品上の位置付けは公式ページ（https://claude.com/product/claude-code）で確認できます。
APIキーでClaude Codeを使う設定
Claude Codeの認証には、Claude Pro・Max・Team・Enterpriseのログイン、Claude ConsoleのAPIキー、対応クラウドプロバイダーなど複数の経路があります。ConsoleのAPIキーを明示的に使いたいときは、ANTHROPIC_API_KEY を起動前のシェルへ設定します。
# macOS / Linux / WSL
export ANTHROPIC_API_KEY="sk-ant-ここにキーを入れる"
claude
Windows PowerShellでは次のように設定します。
$env:ANTHROPIC_API_KEY = "sk-ant-ここにキーを入れる"
claude
公式の環境変数リファレンス（https://code.claude.com/docs/en/env-vars）によると、ANTHROPIC_API_KEY は直接のAPIキー認証に使われ、対話モードでは一度承認するとサブスクの認証より優先されます。claude -p のような非対話モードでは、キーが存在すれば常にそのキーが使われます。ProやMaxを使うつもりなのに、古いAPIキーがシェル設定や.envから読み込まれていると、意図せず従量課金へ切り替わる点に注意が必要です。
Bearerトークンを使うゲートウェイではANTHROPIC_AUTH_TOKEN、プロキシや社内ゲートウェイを経由するときはANTHROPIC_BASE_URLを使えます。ただし接続先を変更すると、公式APIとは異なる制限やデータ取り扱い条件が適用される場合があります。まずはAnthropicの公式エンドポイントとConsoleキーで動作を確認し、必要性が明確になってから接続先を変えるのが安全です。
最短手順｜Consoleから起動して動作確認する
初回は認証と請求先を混ぜないよう、次の順番で確認します。公式Quickstart（https://code.claude.com/docs/en/quickstart）にも、インストール、ログイン、最初のセッション、初回変更の流れが掲載されています。
- Claude Consoleにログインし、API利用用のWorkspaceと支払い方法を確認する
- 「API Keys」で用途が分かるキーを発行し、表示された値をパスワードマネージャーなどへ保存する
ANTHROPIC_API_KEYを現在のシェルへ設定し、.gitignoreで秘密情報を含む.envをリポジトリから除外する- 公式インストーラーなどでClaude Codeを導入し、
claude --versionでインストール結果を確認する - プロジェクトのフォルダーで
claudeを起動し、必要なら/statusで現在使われている認証経路を確認する このプロジェクトの構成を説明してのような読み取り中心の質問を送り、請求と権限の動作を確かめる
自動処理を試すときは、いきなりファイル編集を許可せず、まず次のようにJSONを取得します。
claude -p "このプロジェクトのテスト方法を説明して" --output-format json
公式のプログラム実行ガイド（https://code.claude.com/docs/en/headless）では、text、json、stream-jsonの出力形式が案内されています。JSONにはセッション情報や使用量が含まれるため、CIや定期処理の予算を記録しやすい形式です。APIキーをコマンド履歴へ直接書かず、環境変数・CIのSecret・シークレット管理サービスから渡してください。
CLI・SDK・Claude API・Routinesの使い分け
同じ「APIで使う」でも、どこまでClaude Codeの機能が必要かで選択が変わります。
| 選択肢 | 向いている用途 | 主な認証 | 特徴 |
|---|---|---|---|
| Claude Code CLI | 手元のリポジトリを対話的に修正する | サブスクまたはAPIキー | 承認を挟みながらファイル・Git・シェルを扱える |
claude -p |
CI、バッチ、レビュー結果の自動取得 | APIキーまたは設定済みトークン | 非対話で実行し、JSONやストリームを返せる |
| Claude Code向け公式SDK | Python・TypeScriptのアプリからコード作業を呼び出す | 原則APIキー | 読み取り・編集・コマンドなどの処理をアプリ側から組み込める |
| Claude APIの公式SDK | チャット、要約、独自ツールを組み込む | APIキー | Messages APIを中心に、アプリの処理ループを自分で設計する |
| Routines API | クラウド上の定型処理をHTTPで起動する | 発行したトークン | PCを起動せず、保存済みの設定を外部イベントから呼び出せる |
PythonやTypeScriptからClaudeを組み込みたいなら、公式SDK一覧（https://platform.claude.com/docs/en/cli-sdks-libraries/overview）を確認します。コードの読み取りや編集まで必要ならClaude Code向けSDK、会話と独自ツールだけで足りるならMessages API向けSDKを選びます。APIキーを.envなどから読み込む構成が基本で、自社サービスの利用者にClaude.aiのログインやサブスク枠をそのまま提供する設計にはしません。第三者向けのアプリは公式のAPIキー認証を使う必要があります。
RoutinesのHTTP起動は便利ですが、公式ドキュメント（https://platform.claude.com/docs/en/api/claude-code/routines-fire）でも実験的なAPIとされています。URL、リクエスト形式、トークンの仕様が変わる可能性があるため、業務の停止が許されない処理では再送、重複実行、人による確認を設計に含めてください。
料金はサブスクとAPI従量課金を分けて考える
Claude CodeをClaude Consoleアカウントで使う場合、公式製品ページ（https://claude.com/product/claude-code）が案内するように、APIトークンは標準のAPI料金で消費されます。ProやMaxの月額契約とConsoleのAPI利用料は同じ請求ではありません。サブスクを契約していてもAPIキーで実行した分は別に計上され、APIキーだけを使う場合にPro契約が必須になるわけでもありません。
API料金は基本的に、入力トークンと出力トークンをモデルごとの単価で計算します。概算は次の式で考えられます。
概算額 = 入力トークン数 × 入力単価
+ 出力トークン数 × 出力単価
+ ツールやサーバー機能などの追加利用料
単価や対象モデルは更新されるため、固定の金額だけで比較しないことが重要です。公式料金表（https://platform.claude.com/docs/en/about-claude/pricing）では、プロンプトキャッシュの読み取りが通常の入力単価より低く設定され、Batch APIには非同期処理向けの割引が示されています。長いプロジェクト情報を毎回送る処理はキャッシュ、締切を待てる大量処理はBatch APIを検討すると、品質を保ったまま支出を抑えやすくなります。
なお、APIキーを設定したままclaude -pを動かすと、サブスクの残量ではなくAPI側のクレジットが減る場合があります。反対にサブスク用のトークンで自動処理を運用すると、対話利用とは別のプログラム利用枠が適用されることがあります。認証方法を決めたら、ConsoleのUsage画面とスクリプトの実行ログを同じ期間で照合してください。
APIキー管理と認証エラーを防ぐ確認ポイント
APIキーを使う構成は便利ですが、漏えいと認証経路の取り違えが主な事故原因です。運用開始時に次を順番に確認します。
- 開発・検証・本番でWorkspaceまたはキーを分け、キー名に用途と期限を付ける
- キーをソースコード、README、チャット、画面キャプチャへ書かず、Secret管理から注入する
- Gitのコミット履歴とCIログに
sk-ant-などの値が残っていないか確認する /statusで実際の認証経路を見て、サブスクへ戻すときは現在のシェルでunset ANTHROPIC_API_KEYを実行する- 401ならキーの誤り・失効・読み込み先、429ならレート制限、5xxならサービス状態と再試行を確認する
公式エラーリファレンス（https://code.claude.com/docs/en/errors）も、APIキーを想定したのに認証できない場合は、Claude Codeを起動した同じシェルで環境変数を確認するよう案内しています。.envプラグインやIDEの統合ターミナルが古い値を自動で読み込むこともあるため、設定ファイルだけでなく実行環境を調べるのが近道です。
短時間だけ有効なキーをVaultなどから払い出したい場合は、apiKeyHelperのような動的な取得方法も選べます。キーを長期間保存するより安全ですが、スクリプトの標準出力に余計な文字を出さないこと、失敗時に空の値を返さないこと、更新間隔とレート制限を決めておくことが必要です。
目的別に選ぶclaude code apiの構成
最後に、迷ったときの判断を用途でまとめます。
| 目的 | すすめる構成 | 理由 |
|---|---|---|
| 個人でコードを相談・修正したい | Claude Code CLI + Pro / Max | ブラウザ認証で始めやすく、承認を確認しながら使える |
| Consoleで支出を管理したい | Claude Code CLI + ANTHROPIC_API_KEY |
Workspace単位でAPI利用と上限を管理しやすい |
| CIでレビューやテストを自動化したい | claude -p + Secret管理 |
非対話・JSON出力・ログ集計を組み合わせやすい |
| Python / TypeScriptの製品へ組み込みたい | 用途に合う公式SDK + APIキー | Claude Codeの操作が必要か、Messages APIで足りるかを選べる |
| GitHubや外部サービスから起動したい | Routines API | クラウド上の保存済み処理をHTTPで呼び出せる |
APIキーを使うとClaude Codeを自動化しやすくなりますが、API料金、権限、実行ログを一緒に設計することが欠かせません。まずは読み取りだけのclaude -pで認証と費用を確認し、次に必要なツールだけを許可し、最後にSDKやRoutinesへ広げる順番なら、予想外の課金やファイル変更を抑えながら導入できるでしょう。
