Claude APIとClaude Codeの違いと使い分け

Claude APIとClaude Codeは、同じClaudeのモデルを使う別々の製品です。Claude APIは、自分のプログラムからhttps://api.anthropic.com/v1/messagesにリクエストを送り、使ったトークン数だけ支払う開発者向けの窓口です。Claude Codeは、Anthropicが作ったエージェント型のコーディングツールで、リポジトリを読み、ファイルを編集し、コマンドを実行します。モデルではなく、モデルを使って作業する道具です。

いちばん多い疑問への答えから書くと、Claude Codeを使うためにAPIの契約は必要ありません。2026年9月26日時点で、Claude CodeはPro（月払い$20）とMax（$100または$200）に含まれていて、claude.aiのアカウントでログインすれば使えます。APIキーやクラウドの認証情報でも動かせますが、その場合はトークン単位の従量課金になります。逆に、自社のアプリやサービスにClaudeを組み込むなら、選択肢はAPIキー（またはAWSなどのクラウド経由）だけで、Pro/Maxのログインは使えません。

同じモデル、違う層：まず全体像

2つの違いは「どのモデルか」ではなく「誰がループを回し、誰の請求に載るか」です。

Claude APIを直接呼ぶと、たとえば次のようになります。ヘッダーとモデルIDはAnthropicのクイックスタートと同じです。

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 1000,
    "messages": [{"role": "user", "content": "この関数の役割を説明してください"}]
  }'

返ってくるのはJSONの応答だけです。ファイルを開く、テストを走らせる、失敗したら直すといった作業は、呼び出す側のコードがすべて面倒を見ます。Claude Codeは、その「作業の回し方」ごと製品にしたものです。リポジトリでclaudeと打てば、同じモデルが手元のファイルとシェルを使って作業を進めます。

なお「Claude Code API」という言い方には2つの意味が混ざっています。1つは「APIキーの従量課金でClaude Codeを使うこと」、もう1つは「Claude Codeをプログラムから呼び出すこと」（claude -pやAgent SDK）です。前者は課金の話、後者は使い方の話なので、以下では分けて扱います。

作業別の早見表：何を使い、どの請求に載るか

Anthropic自身は、Claudeでエージェント的な処理を作る手段を4つに分けています。Agent SDK（自分のPython・TypeScriptアプリにClaude Codeのエージェントを組み込む）、Claude Code CLI（ターミナルでの対話的な開発や単発タスク）、Client SDK（自分のコードからClaude APIを直接呼び、ツールのループは自分で書く）、Managed Agents（Claude API経由で設定し、Anthropicがエージェントをホストする）です。これに「使える認証情報」「請求先」「越えてはいけない線」を足すと、判断はほぼ機械的にできます。

ここからわかる判断の軸は3つです。

• 作業するのが自分で、対象が自分のコードなら、Claude Codeをサブスクのログインで使うのが基本です。Pro/Maxをすでに払っているなら、追加でAPIクレジットを買う理由はありません。
• 作るものが「自分以外の誰かが使う製品」なら、中身がAPI直叩きでもAgent SDKでも、認証はAPIキーかクラウドです。
• ファイルを触る・コマンドを実行する必要があるかどうかで、Agent SDK（またはclaude -p）かClient SDKかが分かれます。1回の呼び出しで済む要約や分類にエージェントを丸ごと載せる必要はなく、逆に、ファイル編集とテスト実行のループを自前で書き直すのは手間の割に得がありません。

ホスト型のエージェントが自分の用途に合うかは、Claude Managed Agents とは？2026年に使うべき場面と使わないほうがいい場面で詳しく扱っています。

Claude Codeの料金：APIは要らないが、クレジットは2種類ある

2026年9月26日時点のclaude.comの料金ページでは、プランとClaude Codeの関係は次のとおりです（税別）。

有料プランでは、Claude Codeはウェブ・デスクトップ・モバイルのチャットと同じ利用枠を使います。枠は5時間ごとのローリングウィンドウと週単位の上限で管理され、ターミナルで作業した分もチャットと同じプールから減ります。上限に達したら、リセットを待つか、上位プランに移るか、「使用クレジット」をオンにして標準APIレートで続けるかを選びます。「Claude Codeは別料金で、使うと必ずAPI従量課金になる」という理解は、現在のプランには当てはまりません。

混乱しやすいのが「クレジット」という言葉です。

• Consoleのクレジット：Claude Consoleにチャージする前払いのAPI残高です。APIキーで呼んだ分がここから引かれます。キーの作り方と残高の買い方はClaude APIキーの購入方法：買うのはキーではなく利用クレジットにまとめています。
• 使用クレジット：Pro/Maxの利用枠を超えたあとも作業を続けるための、サブスク側の追加利用です。料金は標準APIレートで、claude.aiの「設定 > 使用量」でオン・オフや月の上限を管理します。Claude Codeの/usage-creditsはclaude.aiでログインしているときだけ使え、APIキー認証では使えません。

APIキーの経路で使った場合のトークン単価は、2026年9月26日時点で次のとおりです（100万トークンあたり、入力 / 出力）。

Sonnet 5の$2 / $10は当初2026年8月末までの導入価格とされていましたが、そのまま標準価格になり、9月1日に予定されていた$3 / $15への値上げは行われないとAnthropicが明記しています。キャッシュヒットした入力は基本単価の0.1倍（Opus 5.5は0.05倍、Fable 5.1は0.025倍）、Batch APIは50%引きです。

規模感をつかむための試算を1つ置きます。エージェント型のコーディングは、同じファイルやログを何度も読み直すため入力が膨らみます。仮に1回の作業で入力200万トークン、出力15万トークンを使ったとすると、キャッシュなしの定価で次のようになります。

• Sonnet 5：2 × $2 + 0.15 × $10 = $5.50
• Opus 5.5：2 × $4 + 0.15 × $20 = $11.00

同じ規模の作業を月20回すれば、Sonnet 5で$110、Opus 5.5で$220です。トークン数は仮定で、実際の量はリポジトリの大きさや作業の進め方で大きく変わります。また、サブスクは使い放題ではなく利用枠があるので、「$20で$110分使える」とは言えません。プロンプトキャッシュが効けば、繰り返し読む部分の入力費は大きく下がります。

Anthropicの公式ドキュメントは、企業導入での平均として「アクティブな日1日あたり開発者1人約$13、月あたり$150〜250、90%の利用者は1日$30未満」と示しています。これは企業での平均値で、個人の予算の目安ではありません。自分の使い方でサブスクを続けるか、ダウングレードするか、APIに寄せるかの計算はClaude Code 重度ユーザーはサブスク継続、ダウングレード、API のどれを選ぶべきかで、プランごとの上限はClaude Code 料金 2026：Pro、Max、Team、API、追加利用の選び方とClaude ProとMaxを比較 2026年版：料金、Claude Code制限、Maxの損益分岐点で扱っています。

Claude CodeにAPIキーを入れるとどうなるか

Claude CodeはAPIキーでも動きます。問題は、キーとログインが両方あるときに、黙ってキーの側が選ばれることです。認証情報が複数あると、Claude Codeは次の順で1つを選びます。

1. クラウドの指定（CLAUDE_CODE_USE_BEDROCK、CLAUDE_CODE_USE_VERTEX、CLAUDE_CODE_USE_FOUNDRY）
2. ANTHROPIC_AUTH_TOKEN（LLMゲートウェイやプロキシ用のBearerトークン）
3. ANTHROPIC_API_KEY
4. apiKeyHelperスクリプトの出力
5. CLAUDE_CODE_OAUTH_TOKEN（claude setup-tokenで作る長期トークン）
6. Anthropicのプロファイルやフェデレーションの認証情報
7. /loginでのサブスクのログイン

/loginは最下位です。対話モードでは、ANTHROPIC_API_KEYがあると最初に一度だけ使うかどうかを聞かれ、その選択が記憶されます。あとから変えるには/configの「Use custom API key」を切り替えます。一方、-pでの実行ではキーがあれば確認なしで必ず使われます。以前API検証のために.zshrcへ書いたキーが残っていると、Pro/Maxを払っているのにClaude Codeの利用がConsoleの従量課金に載る、ということが起きます。

サブスクに戻すにはunset ANTHROPIC_API_KEYでキーを外し、/statusで有効な認証方法を確認します。ログインとキーの両方が設定されていれば、/statusは使われていない側に印を付けます。この優先順位はCLIだけでなく、VS Code拡張、Agent SDK、GitHub Actionsにも同じように効きます。ブラウザで動くクラウドセッションは例外で、環境変数にキーを置いても常にサブスクの認証情報を使います。

なお、Google Cloud経由の場合、Anthropicのドキュメントでは製品名が「Google Cloud's Agent Platform」になっていますが、環境変数はCLAUDE_CODE_USE_VERTEXのままです。症状から今の課金経路を突き止めて戻す手順はClaude CodeのAPIキーとサブスク課金: どちらを使うべきか、キーやsettings.json、モデル、ゲートウェイの設定はClaude Code API 設定：キー、settings.json、モデル、ゲートウェイの確認手順で詳しく扱っています。Anthropic直結以外の接続経路（対応クラウドや互換ゲートウェイ）を比べたい場合はClaude を安定して使うにはどう選ぶべきか: Anthropic 直結、対応クラウド、それとも laozhang.ai の互換ゲートウェイ？を参照してください。

Claude Codeをプログラムから呼ぶ：claude -pとAgent SDK

「Claude CodeをAPIのように使いたい」なら、Messages APIではなくAgent SDKが答えです。Agent SDKはClaude Codeと同じツール、エージェントループ、コンテキスト管理をプログラムから使えるようにしたもので、スクリプトやCI向けのCLI（claude -p）と、PythonおよびTypeScriptのパッケージとして提供されています。

claude -p "auth.pyのバグを見つけて直してください" --allowedTools "Read,Edit,Bash"

PythonやTypeScript以外の言語から同じループを使いたい場合は、claude -pをサブプロセスとして起動し、--output-format jsonで結果を受け取るのがAnthropicの案内する方法です。

スクリプトやCIで使うときは、認証とセキュリティの2点を押さえておきます。

• --bareはAPIキー専用：--bareはhooks、スキル、プラグイン、MCPサーバー、CLAUDE.mdなどの自動読み込みを省き、どのマシンでも同じ結果を得やすくするモードです。スクリプトやSDKからの呼び出しには推奨されていて、将来は-pの既定になる予定です。ただしbareモードはOAuthの認証情報もキーチェーンも読まないので、ANTHROPIC_API_KEYかapiKeyHelperが必要です（クラウドは各社の認証情報をそのまま読みます）。CLAUDE_CODE_OAUTH_TOKENも読みません。
• CIでサブスクを使うならclaude setup-token：ブラウザでログインできない環境向けに、1年有効のOAuthトークンを発行できます。Pro/Max/Team/Enterpriseが必要で、CLAUDE_CODE_OAUTH_TOKENに設定して使います。このトークンはモデルへのリクエスト専用で、--bareとは組み合わせられません。
• --bareなしの-pは、リポジトリの設定を信頼確認なしで実行する：プロジェクトの.claude/settings.jsonにあるhooksや.mcp.jsonのサーバーは、一度も信頼していないフォルダでも、確認ダイアログなしで動きます。外部からのプルリクエストをCIで処理するなら、この挙動を前提に設計してください。

サブスクのログインで越えてはいけない線

Pro/Maxのログイン（OAuth）は、契約者本人がClaude CodeやAnthropic純正のアプリを普通に使うためのものです。公開されている利用上限も、Claude CodeとAgent SDKの「通常の個人利用」を前提にしています。自分のサブスクで改変していないClaude Codeにログインし、自分のコードを書くのはまさに想定どおりの使い方です。

一方、製品やサービスを作る開発者に対しては、AnthropicはConsoleのAPIキーか対応クラウドでの認証を求めていて、次のことを認めていません。

• 自社のアプリやAgent SDKで作ったエージェントに、claude.aiのログインを組み込んで提供すること（事前に承認を得た場合を除く）
• Free・Pro・Maxの認証情報を使い、利用者に代わってリクエストを中継すること
• claude.aiの認証情報やセッショントークンを収集・保存・仲介すること。ログインは必ずAnthropic自身の画面で完結させる必要があります

逆に、次のことは問題ありません。

• 自社で発行したAPIキーやクラウドの認証情報を、開発環境やシークレット管理に置いて、自社の許可した利用者に使わせること（請求がキーの持ち主に来て、再販・中継にあたらない場合）
• 自社の環境でClaude Codeを動かし、利用者がそれぞれ自分のサブスクやAPIキーでログインすること。この場合、Claude Code本体は改変せず、組み込みのログイン方法を無効にしてはいけません

Anthropicは、これらの制限を事前の通知なく執行できるとしています。とはいえ「サブスクでスクリプトを1本回しただけで止められる」という話ではなく、線引きの基準は「自分が普通に使っているか、他人のために使わせているか」です。他人に使わせる時点で、APIキーかクラウドに切り替えます。

今の課金経路を確かめる手順と、高くつく3つのミス

Claude Codeがどの請求に載っているかは、次の順で確認できます。

1. Claude Codeの中で/statusを実行し、有効な認証方法を見ます。ログインとキーが両方あれば、使われていない側に印が付いています。
2. シェルにANTHROPIC_API_KEYやANTHROPIC_AUTH_TOKENが残っていないか、echo $ANTHROPIC_API_KEYなどで確かめます。
3. /usageを開きます。Pro/Maxでは利用枠のバーが表示されます。上部の「Session」の金額はトークン数から定価で計算した推定値で、サブスク利用者の請求とは関係ありません。
4. APIの実際の請求は、Claude Console（platform.claude.com）の使用量ページが正です。サブスクで使っているつもりの日にここの数字が増えていれば、キーの側が使われています。
5. サブスクの追加利用は、claude.aiの「設定 > 使用量」で使用クレジットのオン・オフと今月の支出を確認します。

避けたいミスは、どれも「違いを取り違えた」ことから起きます。

• プランに含まれる作業にAPIクレジットを払う：Pro/MaxならClaude Codeは利用枠の範囲で使えます。「Claude CodeにはAPIが必要」と思ってConsoleにチャージし、キーでログインすると、同じ作業に別料金を払うことになります。
• 残ったキーで従量課金に切り替わる：ANTHROPIC_API_KEYは/loginより優先され、-pでは確認なしで使われます。/statusとConsoleの使用量ページを定期的に見るのが確実です。
• サブスクのログインで自社プロダクトを動かす：利用者向けのサービスをPro/Maxのログインで裏から動かすのは規約上認められていません。最初からAPIキーかクラウドで設計すれば、利用が増えたときに作り直す必要もありません。

よくある質問

Claude CodeとClaude APIは、どっちを使えばいいですか？

自分のリポジトリで、自分がコードを書く作業ならClaude Codeです。Pro/Maxのログインで使えばプランの利用枠に収まります。自社のアプリやサービスにClaudeの機能を組み込むならClaude API（Client SDK経由のMessages API）で、認証はConsoleのAPIキーかクラウドです。スクリプトやCIでClaude Codeの作業能力をそのまま使いたいときは、その中間にあるclaude -pやAgent SDKを選びます。

ClaudeとClaude Codeの違いは何ですか？

claude.aiやアプリのClaudeは、会話で質問に答えたり文章を書いたりするチャットです。Claude Codeは、手元のリポジトリを読み、ファイルを編集し、テストなどのコマンドを実行して作業を進めます。どちらも同じ契約（Pro/Max）の利用枠を共有していて、ターミナルで使った分もチャットと同じプールから減ります。

VS CodeでもAPIキーで使えますか？

使えます。VS Code拡張はCLIと同じ認証の仕組みを使うため、ANTHROPIC_API_KEYやapiKeyHelperが設定されていれば、ログインより優先されます。サブスクで使いたいのにConsoleに請求が来るときは、エディタを起動した環境にキーが残っていないかを確認してください。インストール手順はClaude Codeのインストール方法【2026年版】Mac・Windows・Linux完全ガイドにあります。

日本からClaude APIやClaude Codeを使えますか？

使えます。日本はAnthropicが公開している対応地域のリストに含まれています。APIとプランの料金はドル建てで公開されています。