Claude API への最初のリクエストを行うには、Claude コンソールのキーを作成し、それを環境変数に設定した上で、Messages エンドポイントを呼び出し、返された 使用法 各フィールドを入力し、トークンコストを算出します。このガイドでは、2026年9月8日時点で確認済みの最新のモデルIDと価格を用いて、その手順を順を追って説明します。.
APIの仕組みを理解したら、次に考えるべきは、日々の業務のうち、実際にどの程度の部分でカスタム統合が必要なのかということです。調査、執筆、コーディング、そしてクリエイティブな制作においては、, グローバルGPT Claudeを、GPT-5.6 Sol、Gemini 3 Pro、Kimi K3、その他の主要モデルと併せて、より経済的に利用できる方法を提供します。 1つのサブスクリプションで、モデルと幅広いAIツールが1つのダッシュボードに統合されるため、作業を別々のサービスに分割することなく、アイデアから成果物へとスムーズに進めることができます。開発環境にAIを導入する必要がある場合、GlobalGPT CLIを使用することで、そのワークスペースをターミナルや既存の生産ツールに接続できます。.
Claude APIとは何ですか?
Claude API は、アプリケーション、スクリプト、またはバックエンドサービスから Claude モデルへ構造化されたリクエストを送信するための、Anthropic の開発者向けインターフェースです。HTTPS エンドポイントにメッセージを送信すると、生成されたコンテンツに加え、モデル、停止理由、トークンの使用状況などのメタデータを含む構造化されたレスポンスを受け取ることができます。.
Claude API と Claude.ai のサブスクリプションの比較
APIへのアクセスとClaude.aiのサブスクリプションは、それぞれ異なる用途に対応しています。 Claude.aiのプランでは、Anthropicのチャット製品を利用できます。APIは、Claudeコンソールを通じて提供される従量制の開発者向けアクセスであり、利用量に応じた別途の課金が行われます。Anthropicのヘルプセンターによると、Claude ProにはコンソールAPIの利用は含まれていません。.
消費者向けプラン、Claudeコード、およびトークン課金に関するより詳細な違いについては、当社の完全な Claude 価格ガイド. このチュートリアルにおいて重要なポイントは単純です。APIアカウントの作成と資金の投入は、Claude.aiのサブスクリプションとは別に行うことです。.
初回の依頼に至る5つのステップ
- Claude コンソールで API キーを作成してください。.
- それを
ANTHROPIC_API_KEY環境変数。. - リクエストを送信するには
https://api.anthropic.com/v1/messages. - 返されたコンテンツを読み取り、
使用法オブジェクト。. - 各トークンカテゴリに、そのカテゴリに適用される100万トークンあたりのレートを乗じます。.
Claude APIの価格および現在のモデルID
Anthropicでは、APIの価格は100万トークンあたりの米ドルで表示されており、多くの場合「MTok」と略されます。入力と出力は別々に課金されます。プロンプトのキャッシュ機能により、5分ごとの書き込み、1時間ごとの書き込み、およびキャッシュからの読み取りにはそれぞれ異なる料金が適用されるため、正確な見積もりを行うには、これらのカテゴリを区別しておく必要があります。.
現在のモデルと正確なAPI ID
| モデル | API ID | 入力 / MTok | 出力 / MTok |
|---|---|---|---|
| Claude Fable 5.1 | claude-fable-5-1 | $10 | $50 |
| Claude Opus 5 | claude-opus-5 | $5 | $25 |
| クロード・ソネット第5番 | claude-sonnet-5 | $2 | $10 |
| クロード・ハイク 4.5 | claude-haiku-4-5-20251001 | $1 | $5 |

このチュートリアルでは、どのモデルを使えばよいでしょうか?
使用された公式のクイックスタート claude-opus-5 このガイドの検証時点では、以下の cURL および Python のサンプルでは同じ ID が使用されています。Opus をチュートリアルの出発点として扱い、ワークロード、品質要件、レイテンシ、予算に応じて本番環境用のモデルを選択してください。モデル ID やライフサイクルステータスは変更される可能性があるため、長期運用を想定したコードをリリースする前に、「モデル」および「非推奨」のページを再度確認してください。.

100万トークンあたりの米ドル。棒グラフの長さは、$50の出力最大値に合わせて正規化されています。.
claude-fable-5-1claude-opus-5claude-sonnet-5claude-haiku-4-5-20251001初めてリクエストを行う前に必要なもの
Claude ConsoleのアカウントとAPIキーを作成する
Claudeコンソールを開き、適切な組織を作成または選択して、APIキーを作成してください。Anthropicでは、新しいキーは1回しか表示されないという警告が表示されますので、キーが表示されたら、承認済みのシークレットマネージャーやその他の安全な場所に保存してください。キーをスクリーンショット、共有ドキュメント、公開リポジトリ、またはブラウザ側のJavaScriptに含めないでください。.

キーを環境変数に保存する
これらの例では、変数 ANTHROPIC_API_KEY. 実際の値は、プライベート端末または秘密鍵管理システムでのみ入力してください。以下のコマンドは、画面に表示せずに値を読み取り、現在のシェルセッションにエクスポートします:
read -s ANTHROPIC_API_KEY
export ANTHROPIC_API_KEY
環境変数は不注意による情報漏洩を防ぐことができますが、それだけでは完全なシークレット管理戦略とは言えません。本番環境のアプリケーションでは、ホスティングプラットフォームが定めるシークレットの保存およびアクセス制御のガイドラインに従う必要があります。.
請求内容を確認し、安全なテスト上限額を選択してください
APIの課金は、Claude.aiのサブスクリプションとは別扱いとなります。Anthropicによると、ほとんどの組織では利用クレジットを前払いしていますが、月次請求制の組織は例外です。コンソールアカウントからAPIリクエストを送信できることを確認した後、最初のリクエストは少量に抑えてください。 max_tokens: 128. このフィールドは生成される出力の上限を定めるものであり、128個の課金対象出力トークンを確保したり保証したりするものではありません。.
cURL を使って最初の Claude API リクエストを送信する
cURL を使えば、リクエストの構成を直接確認できます。以下の例では、Messages エンドポイント、JSON コンテンツタイプ、API キーヘッダー、Anthropic のバージョンヘッダー、検証済みのクイックスタートモデル ID、および 1 件のユーザーメッセージを使用しています。.
いずれかのサンプルを実行する前に、ご自身のAPIキーを追加し、組織でAPI課金が有効になっていることを確認してください。このコードはAnthropicのドキュメントに記載されているリクエスト形式に準拠しており、ローカルでの構文チェックも通過していますが、実際のアカウントからの応答はここに含まれていません。.
各ヘッダーおよびJSONフィールドの役割
| パート | 目的 |
|---|---|
コンテンツタイプ | リクエスト本文がJSONであることをエンドポイントに通知します。. |
x-api-key | 環境変数に保存されている値を使用して、リクエストの認証を行います。. |
アンソロピック版 | リクエストで使用される、文書化されたAPI契約を選択します。. |
モデル | Claude APIモデルの正確なIDを選択します。. |
max_tokens | このレスポンスに対して、Claudeが生成できるトークンの最大数を設定します。. |
メッセージ | 各ロールおよびコンテンツの値を含む、順序付けられた会話入力を提供します。. |
コマンドがエラーを返した場合は、リクエストを変更する前に、HTTPステータスとエラーの種類を確認してください。認証や課金に関するエラーはアカウントの設定修正が必要ですが、JSONの形式が正しくない場合やモデルIDが無効な場合は、リクエスト内容を変更する必要があります。.
Python SDK を使用して同じリクエストを送信する
公式の Anthropic SDK をインストールする
python -m pip install anthropic
普段のPythonワークフローで仮想環境を使用している場合は、仮想環境を利用してください。SDKは ANTHROPIC_API_KEY 環境から、次の場合に anthropic.Anthropic() 明示的なキーを指定せずに作成されます。.
同等のPythonリクエストを実行する

返されたテキストを安全に読み取る
メッセージの応答には複数のコンテンツブロックが含まれる可能性があるため、この例ではテキストを出力する前に各ブロックのタイプを確認しています。実際のアプリケーションでも、サポートやログ記録のためにリクエストIDを保持しつつ、外部に公開しないようにし、返されたモデルと停止理由を記録し、APIエラーを明示的に処理する必要があります。.
短いテキストの回答が予想される場合でも、コンテンツブロックのチェックは維持してください。これにより、回答に複数のブロックが含まれる場合に、例を拡張しやすくなります。また、出力する際も message.usage これにより、以下のコスト計算に必要な数値が得られます。.
使用量の読み方と費用の計算方法
応答テキスト、モデル、停止理由、およびリクエストIDを特定する
Messages APIのレスポンス契約には、生成されたコンテンツ、リクエストを処理したモデル、および処理が中断された理由が含まれます。また、HTTPレスポンスには、Anthropicサポートが問題の追跡を行う際に役立つリクエスト識別子も含まれています。識別子は慎重に記録し、顧客のコンテンツや認証情報とともに公開しないようにしてください。.
入力、出力、およびキャッシュ・トークンの使用状況を確認する
について 使用法 objectは、コスト分析に必要なトークンカテゴリを報告します。少なくとも、入力トークンと出力トークンを確認してください。 プロンプトのキャッシュを使用する場合は、5分ごとのキャッシュ書き込み、1時間ごとのキャッシュ書き込み、およびキャッシュ読み取りを別々に管理してください。これらはレートが異なるためです。Anthropicの「Token Counting」エンドポイントは、リクエスト前に入力トークンを推定できますが、その推定値は最終的な入力使用量と若干異なる場合があり、また独自のレート制限があります。.
トークンの使用量を推定コストに換算する
各カテゴリを個別に計算し、その結果を合計します。標準のグローバルレートで Claude Opus 5 を使用した計画例の場合、キャッシュされていない入力トークン 1,000 個のコストは 1,000 × $5 / 1,000,000 = $0.005, 一方、300の出力トークンのコストは 300 × $25 / 1,000,000 = $0.0075. 推定総額は $0.0125. これらの例示的なトークン数を、 使用法 ご自身の回答から得られた値。.
Claude API 料金計算ツール
計算ツールを使用して、モデル、リクエスト数、トークンカテゴリ、課金モード、推論の実施地域を変更してください。 バッチ処理の料金は、対象となる使用量に対して標準料金の50%が適用されます。米国限定の推論では、対象となるClaude 4.6+モデルについて、すべてのトークンカテゴリに1.1倍の係数が適用されます。Claude Haiku 4.5は対象外であるため、この組み合わせでは「サポートされていない」状態が返されます。.
米ドル建ての基本トークン見積額。アカウント固有の手数料は含まれていません。.
この見積もりは計画立案の参考資料であり、請求書ではありません。税金、為替換算、交渉による条件、Fast Mode、サーバーツール料金、およびアカウント固有の条件は含まれていません。価格や利用条件は変更される可能性があるため、購入やアーキテクチャの決定を行う前に、公式の価格ページを再度ご確認ください。.
上記の計算ツールは、プログラム可能な従量課金制のClaude API呼び出しのコスト構造を示しています。複数のモデルやAI機能にまたがる日常的な作業においては、, グローバルGPT このサービスは、他とは一味違う価値を提供します。1つのサブスクリプションで、複数の主要なモデルやツールを1つのダッシュボードに統合できるため、コストの見通しが立ちやすくなります。また、調査、執筆、コーディング、クリエイティブ作業を、別々のサブスクリプションや散在するインターフェースに分散させる必要がありません。そのCLI(コマンドラインインターフェース)により、ターミナルベースの開発環境や、すでに使用している本番環境向けツールにおいても、同じプラットフォームを利用できます。当社のガイドでは、 1か所で複数のAIモデルを扱う より広範なプラットフォームがどのように組み合わさっているかを示しています。.
Claude APIでよく発生するエラーとその対処法
まず、HTTPステータスと「Anthropic」というエラー種別を確認し、キーを公開せずにリクエストを調査してください。公式の定義を参考にすれば、原因の絞り込みは可能ですが、具体的な原因は、アカウント、選択したモデル、リクエストの形式、およびトラフィックの状況によって異なります。.

| ステータス | 公式の境界 | 次に確認すべきこと | 再試行しますか? |
|---|---|---|---|
| 400 | 無効なリクエスト | JSON、フィールド名、ロール、モデルID、およびパラメータの組み合わせの妥当性を検証します。. | リクエストを修正した後でのみ。. |
| 401 | 認証エラー | キーが存在し、有効であり、以下の経路を通じてサーバーに到達することを確認してください。 x-api-key. 決して印刷してはいけません。. | 無闇に再試行せず、まず認証の問題を解決してください。. |
| 402 | 請求またはクレジットに関する要件 | コンソールで、組織のAPI課金状況と利用可能な利用クレジットを確認してください。. | 請求条件が解決された後。. |
| 403 | 権限エラー | そのキーと組織が、要求されたリソースまたはモデルを使用できるかどうかを確認してください。. | 無闇に再試行せず、まずアクセスを正しく行ってください。. |
| 404 | リソースが見つかりません | エンドポイント、リソース識別子、モデルのライフサイクル、およびスペルを確認してください。. | ターゲットを修正してからでないと。. |
| 413 | リクエストが大きすぎます | リクエストのサイズを縮小するか、入力を分割してください。単にサイズを増やすだけではいけません。 max_tokens. | リクエストを縮小した後。. |
| 429 | レート制限超過 | レート制限ヘッダーとコンソールティアを確認し、同時実行数を減らし、バックオフを行ってください。. | はい、制御されたバックオフを伴います。. |
| 500 | 内部APIエラー | リクエストIDを記録し、冪等性を確保し、Anthropicのステータス情報を確認します。. | 通常、有界バックオフを用いる。. |
| 504 | ゲートウェイのタイムアウト | リクエストが異常に長かったかどうか、また再試行することで作業が重複する可能性があるかどうかを確認してください。. | 多くの場合、その操作を安全に再実行できるかどうか。. |
| 529 | APIが一時的に過負荷状態です | バーストを低減し、バックオフ後に再試行する。過負荷を認証失敗として扱わない。. | はい、バックオフに上限を設けています。. |

安全なデバッグ順序
- APIキーを記録せずに、ステータス、エラーの種類、タイムスタンプ、およびリクエストIDを記録してください。.
- エンドポイント、ヘッダー、JSONの構文、モデルID、およびリクエストサイズの境界を確認してください。.
- 組織の請求設定、権限、レート制限ヘッダー、および現在のモデルのライフサイクルを確認してください。.
- 合理的に一時的であると見なせるエラーのみを、上限付きの指数関数的バックオフとジッターを用いて再試行する。.
- それでもエラーが解消されない場合は、サポートに連絡する前に、リクエストを再現可能な最小のケースまで絞り込んでください。.
Anthropicの公式SDKでは、接続エラー、429レスポンス、および5xxレスポンスに対して、デフォルトで2回の再試行が行われます。アプリケーションレベルでの再試行ロジックについては、特にリクエストによってツールやその他の外部アクションがトリガーされる可能性がある場合、制限の設定や冪等性の考慮が必要です。.
Claude APIのコストを管理する方法
出力の制限を控えめに設定する
一番小さいものから始めましょう max_tokens それでも有用な回答が得られる値です。出力を増やす前に、実際の出力の使用量を測定してください。プロンプトを短くすることは有効ですが、再試行やエラー、あるいは使用できない出力を防ぐ指示を削除すると、全体としてコストが高くなる可能性があります。.
プロンプトのキャッシュ機能とバッチ処理は、状況に応じてのみ使用してください
- プロンプトのプレフィックスがかなりの部分で繰り返し出現し、キャッシュの有効期間がワークフローに合致する場合は、プロンプトのキャッシュ機能を使用してください。.
- 非同期で完了できる作業にはBatchをご利用ください。Batchの利用対象となる作業については、標準料金の50%が適用されます。.
- レポート作成時には、キャッシュへの書き込みと読み取りを区別して表示し、節約効果が「推測」ではなく「可視化」されるようにしてください。.
- 居住要件によって、トークン価格に1.1倍の係数が適用されることが正当化され、かつ選択したモデルが適格である場合にのみ、米国限定の推論を使用してください。.
利用状況、レート制限、および利用限度額の監視
リクエスト数、モデルID、入力および出力の使用状況、キャッシュカテゴリ、再試行回数、エラーを追跡します。組織で利用可能なアラートや利用制限を設定してください。ただし、他のアカウントのティアや制限が自分のアカウントにも適用されるとは考えないでください。詳細については、以下のガイドをご覧ください。 Claudeのプラン、APIの費用、および利用制限 より幅広い請求ルートを網羅しています。.
初回のお申し込み後の手順
次のプロジェクトに最適な道を選びましょう
アプリケーションを開発する際は、Anthropicの公式Messages APIリファレンス、ストリーミングに関するガイダンス、ツール使用ガイド、モデルライフサイクルに関するページ、および独自のロギング・評価計画に基づいて進めてください。モデル戦略を慎重に決定し、トラフィックを追加する前にエラーへの対処を行い、プロンプトの長さだけでなく、実際の使用状況に基づいてコストを算出してください。.
プログラミングが主な用途である場合は、当社のガイドをご覧ください。 コーディングにクロードAIを使用 インタラクティブなコーディング課題から、繰り返し実行可能な開発ワークフローへと移行するための実践的な方法を解説しています。.
マルチモデルワークスペースがより適したツールとなる場合
コードレベルでの統合、開発者向け課金、リクエストのメタデータ、または公式のプラットフォーム制御が必要な場合は、APIへの直接アクセスが適切な手段です。アプリケーションを構築せずに、対話型の文書作成、調査、計画立案、あるいはプロバイダー間の出力結果の比較を行うことが目的である場合は、マルチモデルワークスペースの方が実用的かもしれません。.
よくある質問
Claude APIは無料ですか?
ここでは、APIの利用に関する一律の無料枠は保証されていません。ClaudeのAPI利用料は、Claudeコンソールを通じて別途請求されます。また、Anthropicによると、ほとんどの組織ではプリペイドクレジットを利用して利用料を支払っており、月次請求制の組織は例外となっています。リクエストを送信する前に、ご利用の組織に関する最新のコンソール情報および公式の料金情報をご確認ください。.
ClaudeのAPIキーを取得するにはどうすればよいですか?
Claude コンソールで、該当する組織用のキーを作成してください。Anthropic では、新しいキーは一度しか表示されないという警告が表示されますので、表示されたら安全に保管してください。サーバー側の環境変数またはシークレットマネージャーを通じて読み込み、ブラウザのコード、スクリーンショット、または公開リポジトリには決して公開しないでください。.
どのClaudeモデルIDを使用すればよいですか?
このチュートリアルでは、 claude-opus-5 というのも、2026年9月8日に確認した時点で、それがAnthropicの公式クイックスタートに記載されていたモデルだったからです。ワークロードや予算に合ったモデルを選択し、モデルID、エイリアス、ライフサイクルステータスは変更される可能性があるため、Anthropicの「モデル」および「非推奨情報」のページを再度確認してください。.
Claude API はどのエンドポイントを使用していますか?
このガイドの最初のリクエストでは、https://api.anthropic.com/v1/messages の Messages エンドポイントを使用します。 このリクエストでは、content-type、x-api-key、anthropic-version ヘッダーを含む JSON を送信します。Anthropic には他にも API 機能がありますので、実装する操作についてはリファレンスページを参照してください。.
Claude ProにはAPIクレジットが含まれていますか?
No. Anthropicのヘルプセンターによると、Claude ProにはClaude Consoleを通じた利用は含まれていません。Claude.aiのサブスクリプションとAPI課金は別々の製品です。開発者によるリクエストについては、ConsoleでAPI課金を設定し、当社の Claude 価格ガイド より広範なプランの比較については。.
Claude APIリクエスト1件あたりのコストはいくらですか?
費用は、選択したモデル、入力トークン、出力トークン、キャッシュ書き込み、キャッシュ読み取り、バッチモード、および対象となる推論地域によって異なります。各カテゴリの費用は、リクエスト数にトークン数を掛け、そのトークン100万単位あたりの実効単価を乗じた後、100万で割ることで算出します。その後、各カテゴリの費用を合計します。概算については、上記の計算ツールをご利用ください。.
なぜ401エラーが出るのですか?
401 は認証エラーです。API キーが存在し、有効な状態であり、対象の組織に属しており、かつサーバーに正しく送信されていることを確認してください。 x-api-key ヘッダー。デバッグ中は、このキーを印刷したり共有したりしないでください。何度再試行しても、欠落または無効な認証情報は修復されません。.
なぜ429エラーが出るのですか?
「429」は、リクエストがレート制限を超過したことを意味します。制限は組織や利用プランによって異なるため、返されたレート制限ヘッダーや、現在のコンソール、あるいはドキュメントを確認してください。同時実行数を減らし、リトライのタイミングを遵守し、同じバーストを即座に繰り返すのではなく、ジッターを伴う有界指数バックオフを使用してください。.
出典および鮮度に関する注記: モデルID、価格、APIの動作、およびサポートポリシーについては、2026年9月8日時点のAnthropicの公式ドキュメントに基づいて確認しました。本番環境での利用前に、最新のモデルおよび価格ページを確認し、ご自身のClaudeコンソールキー、課金設定、およびアカウントアクセス情報を使用してサンプルを実行してください。.




