Claude APIの統合。明瞭なアプリケーションウィンドウの枠がケーブルでつながり、そのケーブルが中央のコード括弧型アダプターにぴったりとはまっています。

アプリケーションへのClaude APIの統合

Claude API の統合は、初日には SDK のインストールと認証付きの呼び出しだけで済む小規模な作業です。しかし、本番運用に対応できるかどうかは、その呼び出しを取り巻くストリーミング、再試行、トークン予算、オブザーバビリティによって決まります。このガイドでは、そのまま応用できる動作するコードとともに、全工程を解説します。

認証と最初のリクエスト

公式SDKをインストールし（pip install anthropic または npm install @anthropic-ai/sdk）、キーをソースコードには決して記述せず、環境変数に設定して、Messages APIを呼び出し、処理経路が動作することを確認します。APIのバージョンはanthropic-versionヘッダーで指定され、SDKが自動で設定します。

キーは、Anthropic Consoleで取得したものでも、AI Prime TechのようなAnthropic互換ゲートウェイ（Anthropicとは提携関係にない独立したサービス）で取得したものでも、同じように機能します。違いは、クライアントの構築時に指定するbase_urlだけです。

タスクに応じたモデルの選択

モデルを固定してハードコードした連携は、過剰なコストや性能不足につながります。タスクに応じて振り分けましょう。分類、抽出、ルーティングにはHaiku 4.5、ほとんどの製品機能やコーディングにはSonnet 4.6、推論の深さが製品の価値になる場合にはOpus 4.8、1Mのコンテキストウィンドウが必要な場合にはFable 5を使用します。詳しい比較は<a href="/ja/learn/claude-api-models-compared/">Claudeモデルの比較</a>をご覧ください。

モデルは定数ではなく設定値にします。モデル名は数か月単位で変わるため、デプロイせずに新しいリリースのA/Bテストを行えるようにしておきましょう。

ストリーミング、タイムアウト、再試行

人が見る出力はすべてストリーミングにします。サーバー送信イベントはトークンが生成されるたびに配信するため、体感待ち時間を何秒もかかる状態から秒未満に短縮できます。max_tokensが大きい非ストリーミング呼び出しは、プロキシの読み取りタイムアウトにも達しやすくなります。これは本番環境で初めて現れる種類のバグです。

429および5xxレスポンスは、ジッターを加えた指数バックオフで再試行し、retry-afterヘッダーがある場合はその指定に従い、総試行回数に上限を設けます。400系は恒久的なエラーとして扱います。ペイロード自体に問題があり（入力が大きすぎるケースがよくあります。<a href="/ja/learn/claude-api-errors-troubleshooting/">Claude APIのエラー</a>を参照）、再試行してもクォータを消費するだけです。

本番運用のチェックリスト

公開前に確認すること：入力と出力の両方にトークン予算を適用すること、リクエストごとのコストを記録すること（使用量はすべてのレスポンスに含まれます）、繰り返し使うシステムプロンプトのプロンプトキャッシュを有効にすること、障害時に備えて代替モデルまたはエンドポイントを用意すること、ユーザー入力がプロンプトに渡される場合はプロンプトインジェクションのレビューを行うこと。

連携で生じる問題の多くは、API自体ではなく、際限のないコンテキストの増大と可観測性の不足にあります。初日から入出力のトークン数を記録すれば、想定外のコストを防げます。

import os, anthropic

client = anthropic.Anthropic(
    api_key=os.environ["ANTHROPIC_API_KEY"],
    base_url=os.environ.get("ANTHROPIC_BASE_URL", "https://aiprimetech.io"),
)

with client.messages.stream(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Summarize our launch plan in 3 bullets."}],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

よくある質問

Claude APIをアプリに組み込むにはどうすればよいですか？

PythonまたはTypeScript用のanthropic SDKをインストールし、APIキーを環境変数に設定して、Messages APIを呼び出します。本番トラフィックを処理する前に、ストリーミング、再試行ロジック、トークン予算を追加してください。

公式のClaude SDKはありますか？

はい。Anthropicは公式のPythonおよびTypeScript SDKを提供しており、ほかの言語向けにはコミュニティSDKもあります。いずれも同じMessages APIを対象としています。

ClaudeでOpenAI SDKの形式を使用できますか？

複数のゲートウェイがOpenAI互換エンドポイント経由でClaudeを提供しており、ベースURLを変更することで、既存のOpenAI形式のコードをClaudeモデルに対して実行できます。Anthropicへの直接アクセスでは、Anthropic形式を使用します。

Claude API連携の運用コストはいくらですか？

コストはトークン使用量にモデルの価格を掛けたものです。単純なタスクをHaiku 4.5に振り分け、繰り返し使うプロンプトのプレフィックスをキャッシュし、max_tokensに上限を設けます。通常、これらを組み合わせることで、工夫のない連携と比べて支出を半分よりも大幅に削減できます。

数分でClaudeの利用を開始

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

APIキーを取得

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