Claude Code API。ターミナルウィンドウが封をされたリクエストの封筒と整った応答ページにつながり、コーディングセッションの背後にある見えないリクエストの流れを示しています。

Claude Code APIの仕組みを解説

Claude Codeはターミナルで動作するエージェントですが、内部ではすべてのアクションが、直接利用できるものと同じAnthropic Messages APIへの呼び出しです。この仕組みには便利な利点があります。接続先のエンドポイントと課金対象のキーを制御できるため、セッションの費用も管理できます。このページでは各構成要素を説明し、詳しい設定ガイドへのリンクを紹介します。

「Claude Code API」が実際に意味するもの

Claude Code APIという独立した製品はありません。Claude CodeはClaudeサブスクリプション（Pro/Max）またはAPIキーで認証します。APIモードでは、環境設定で指定されたエンドポイントに、システムプロンプト、会話、ツール定義、ツールの実行結果を含む標準のMessages APIリクエストを送信します。

このエンドポイントは変更できます。すべてを制御するのは、ANTHROPIC_BASE_URL（リクエストの送信先）と、ANTHROPIC_AUTH_TOKENまたはANTHROPIC_API_KEY（支払いを行うアカウント）の環境変数です。Anthropicに直接接続する場合も、Anthropic互換ゲートウェイに接続する場合も、Claude Codeの動作は同じです。

自分のAPIキーでClaude Codeを使う

シェルのプロファイルまたは~/.claude/settings.jsonに両方の変数を設定し、通常どおりclaudeを起動してください。settings.jsonの例を含む詳しい手順は、<a href="/ja/learn/claude-code-api-key-setup/">Claude Code APIキー設定ガイド</a>に掲載しています。

注意点があります。シェルにANTHROPIC_API_KEYが設定されていると、サブスクリプションを契約していても、Claude CodeはAPI料金で課金されます。環境変数が優先されるためです。Pro/Maxプランを使う場合は、この変数の設定を解除してください。

Claude Codeのセッション費用

エージェントを使うセッションは大量のトークンを消費します。読み込んだファイル、ツールの実行結果、差分がすべてコンテキストに入るためです。集中して作業する時間帯には、入力トークンの消費量が数百万に達することもあります。そのため、プロンプトキャッシュが非常に重要です。対応するエンドポイントでは、繰り返されるコンテキストをキャッシュから再読み込みすることで、費用を大幅に抑えられます。

実際のセッションごとの数値、キャッシュの動作、長時間のセッションの費用を抑える方法については、<a href="/ja/learn/claude-code-api-costs/">Claude Code API費用ガイド</a>で詳しく説明しています。

Anthropicへの直接接続とゲートウェイの比較

Anthropic APIへの直接アクセスでは、従量課金と提供元によるサポートを利用できます。安定した予算を確保しているチームに適した標準的な選択肢です。AI Prime Techなどの独立したゲートウェイ（Anthropicとの提携関係はなく、同社の承認も受けていません）は、定額または割引料金でアクセスを再販売し、同じ通信形式を提供します。そのため、ベースURLとキーを変更するだけでClaude Codeを利用できます。

どちらを選ぶ場合も、ストリーミングがエンドツーエンドで動作し、必要なモデルがClaude Codeの要求する正確なIDで利用できることを確認してください。確認項目の一覧は、<a href="/ja/learn/use-claude-api-with-claude-code/">Claude CodeでClaude APIを使う方法</a>をご覧ください。

# Claude Code with your own key + custom endpoint
export ANTHROPIC_BASE_URL="https://aiprimetech.io"
export ANTHROPIC_AUTH_TOKEN="sk-your-key"
claude

# or persist in ~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://aiprimetech.io",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key"
  }
}

よくある質問

自分のAPIキーでClaude Codeを使えますか？

はい。環境変数または~/.claude/settings.jsonにANTHROPIC_API_KEY（またはANTHROPIC_AUTH_TOKEN）を設定し、必要に応じてANTHROPIC_BASE_URLも設定してから、claudeを起動してください。サブスクリプションではなく、そのキーに対して課金されます。

Claude Codeには独自のAPIがありますか？

いいえ。標準のAnthropic Messages APIを使用します。Anthropic互換ゲートウェイを含め、その形式で通信できるサービスであればClaude Codeに対応できます。

Claude Codeがサブスクリプションを無視してAPIキーに課金するのはなぜですか？

シェルでANTHROPIC_API_KEYが設定されていると、サブスクリプションによる認証より優先されます。Pro/Maxプランを使うには、この変数の設定を解除してください。

Claude Codeの接続先を別のエンドポイントに変更できますか？

はい。ANTHROPIC_BASE_URLで変更できます。これにより、Claude Codeを変更せずに、ゲートウェイ、プロキシ、企業向けのルーティング構成を利用できます。

数分でClaudeの利用を開始

APIキーを取得 — Anthropicアカウントもウェイトリストへの登録も不要です。

APIキーを取得

AI Prime Techは独立したAPIゲートウェイです。Anthropicとの提携関係はなく、同社の承認を受けておらず、同社の再販業者でもありません。Claudeおよび関連するモデル名は、それぞれの所有者の商標です。