すべての Anthropic API モデル名をお探しなら、最も簡潔な答えは次のとおりです。Claude の表示名、現在のモデル ID、日付付きスナップショットは、いずれも有効なラベルのように見えますが、model フィールドに入力すべきなのは正確な API 識別子だけです。Anthropic は、製品ページでは人間が読める Claude 名を、再現可能な API 呼び出しには日付付きモデル ID を、便利なアップグレード用にはエイリアスを使用しています。これらの値は関連していますが、互換性があるわけではありません。
実用的なルールは単純です。再現可能な動作が必要な場合は正確なモデル ID を、Anthropic に新しいスナップショットへ意図的に移行してもらいたい場合はエイリアスを使用し、公式モデルリストを事前に確認せずにマーケティング名を API リクエストにコピーしないでください。
次のステップが命名スキームではなくリクエスト形式である場合は、このガイドを Anthropic Messages API ドキュメント と組み合わせてご利用ください。Claude 向けのコーディングワークフローを選択する場合は、Claude Code 対応モデル がより適切なフォローアップ資料です。
Anthropic API モデル名とは
Anthropic API モデル名とは、Messages API へのリクエストの model パラメータで送信される識別子です。これにより、どの Claude ファミリーとスナップショットがリクエストを処理するかを Anthropic に伝えます。
次の3つの形式は混同されがちです。
| 値のタイプ | 例 | 最適な用途 |
|---|---|---|
| 表示名 | Claude Sonnet | ドキュメント、製品 UI、非技術者との会話 |
| 現在のモデル ID | claude-sonnet-5 |
Anthropic の現在のモデルページに掲載されているモデルを使用する新規インテグレーション |
| 日付付きモデル ID | claude-haiku-4-5-20251001 |
テスト、規制対象ワークフロー、評価、再現性が必要な本番環境ロールアウト |
正確なカタログは時間の経過とともに変化します。Anthropic の現在のモデルページ と モデル非推奨ページ を、古いチュートリアルからコピーしたリストをハードコーディングする代わりに、信頼できる情報源として扱ってください。
Claude モデル名と Claude モデル ID の違い
Claude モデル名は人間向けに最適化されています。「Claude Sonnet」は製品ティアを示し、「Claude Haiku」はより高速で低コストなティアを示します。API にはより正確な値が必要です。なぜなら、1つのファミリーに複数のスナップショット、リージョン別の可用性ルール、および提供終了日が存在する可能性があるからです。
日付付き ID には通常、以下が含まれます。
opus、sonnet、haikuなどの Claude ファミリー。- メジャーモデル世代。
YYYYMMDD形式のリリース日。
たとえば、claude-haiku-4-5-20251001 は、2025年10月1日にリリースされた Haiku 4.5 スナップショットを識別します。日付は識別子の一部であり、リクエストのタイムスタンプではないため、現在の日付に置き換えるべきではありません。
一部のモデルカタログでは、より短いファミリーレベルの識別子も公開されています。これらは、日付付きスナップショットを自分で管理することなく、サポートされているモデルを使用したい場合に便利です。そのトレードオフとして、プロバイダー管理のポインターは更新後に動作が変わる可能性があるため、Anthropic の現在のカタログに表示されている正確な ID のセマンティクスを必ず確認してください。
よく見かける一般的な Claude モデル ID
以下の API ID は、2026年7月24日時点で Anthropic の現在のモデルページにアクティブとして掲載されていたものです。この表は特定時点での参考情報であり、永続的なレジストリではありません。新しいデプロイメントで ID を使用する前に、Anthropic のドキュメントを確認してください。
| Claude ファミリー | 現在の API ID | 典型的な役割 |
|---|---|---|
| Claude Opus 4.8 | claude-opus-4-8 |
複雑な推論とハイステークスな分析 |
| Claude Sonnet 5 | claude-sonnet-5 |
汎用的な本番環境ワークロード |
| Claude Haiku 4.5 | claude-haiku-4-5-20251001 |
高速な分類、抽出、短い応答 |
| Claude Opus 4.7 | claude-opus-4-7 |
4.8 に移行していない最近世代の Opus インテグレーション |
| Claude Sonnet 4.6 | claude-sonnet-4-6 |
Sonnet 5 に移行していない最近世代の Sonnet インテグレーション |
これらは識別子であり、すべての Anthropic アカウントでモデルが利用可能であることを保証するものではありません。現在掲載されている ID であっても、アカウントの権限、リージョン、割り当て量、またはその後のライフサイクル変更により失敗する可能性があります。日付付き ID はサポートされている間は再現可能ですが、最終的には廃止されます。
Opus、Sonnet、Haiku の選び方
より長い名前ではなく、ワークロードに基づいて選択してください。
- Opus: 難しい推論、長文の合成、またはニュアンスのあるツール判断が、より高いレイテンシやコストを正当化する場合に使用します。
- Sonnet: ほとんどのプロダクションアシスタント、コーディングワークフロー、構造化生成では、まずここから始めてください。通常、実用的な品質対レイテンシのベースラインとなります。
- Haiku: 大量のルーティング、抽出、モデレーション、短いリライト、および最大の推論 depth よりも応答時間が重要なその他のタスクに使用します。
ファミリーを切り替える前に、代表的なプロンプトに対して小規模な評価を実行してください。不正な形式の入力、長いコンテキスト、ツール呼び出し、JSON 出力、およびリクエストが失敗したときにアプリケーションが使用するフォールバック動作を含めてください。ドロップイン置き換えのように見えるモデル名でも、ツール呼び出しのフォーマットやエッジケースの動作が変わる可能性があります。
Messages API リクエストでのモデル ID の使用
model の値は JSON ボディに含めます。これは API バージョンヘッダーや Claude Web アプリに表示されるモデルとは別のものです。
curl https://api.anthropic.com/v1/messages \
--header "x-api-key: $ANTHROPIC_API_KEY" \
--header "anthropic-version: 2023-06-01" \
--header "content-type: application/json" \
--data '{
"model": "claude-sonnet-5",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "API モデル ID を本番環境で固定すべき理由を説明してください。"
}
]
}'
anthropic-version ヘッダーは API コントラクトを記述します。これは Claude モデルを選択するものではありません。クライアントライブラリのアップグレードがモデルルーティングを暗黙的に変更しないよう、これら2つの設定は設定内で独立して保持してください。
SDK を使用する場合は、クライアントのメッセージ作成メソッドを通じて同じ識別子を設定し、環境固有の設定値に保持してください。API キーやモデル ID をブラウザバンドルに含めないでください。サーバーサイドのルーティングはセキュリテイとテスティングの面でより容易です。
API モデル ID が動作しなくなる理由
invalid_request_error または「モデルが見つかりません」という応答は、通常、以下のカテゴリのいずれかに該当します。
表示名が ID の代わりに使用された
Claude Sonnet は有用なラベルですが、信頼できるリクエスト値ではありません。プロバイダのドキュメンテションに記された ID またはエイアラスに置き換えてください。
スナップショットが非推奨になった
日付付き ID は、プロバイダーがサポートしている間のみ再現可能です。非推奨スケジュール を監視し、移行期限を設定し、廃止日より前に代替をテストしてください。
アカウントがモデルにアクセスできない
有効な識別子であっても、アカウントの権限、リージョン、割り当て量、または組織ポリシーによって利用できない場合があります。プロンプトを変更するのではなく、応答ボディとアカウント設定を確認してください。
ルーターがプロバイダー固有の名前を期待している
ゲートウェイや OpenAI 互換の API は、モデル名を異なる方法で正規化する場合があります。Anthropic は現在 claude-sonnet-5 を文書化していますが、別のプロバイダーは名前空間付きの値やプロバイダー所有のエイリアスを公開する場合があります。ゲートウェイのモデルカタログを使用し、Claude ID がすべてのエンドポイントで移植可能であると想定しないでください。
互換性のあるエンドポイントを介した Claude スタイルのワークフローの使用
アプリケーションがすでに OpenAI クライアント形式を使用している場合、互換性レイヤーにより移行作業を削減できます。Novita LLM API は、使い慣れたチャット補完リクエスト形式を通じて、サポートされているオープンソースモデルをルーティングするための OpenAI 互換エンドポイント を提供しています。
これは、すべての Claude モデル ID が自動的にそこで利用可能になることを意味するわけではありません。プロバイダーのルーティングは明示的に行ってください。
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["NOVITA_API_KEY"],
base_url="https://api.novita.ai/v3/openai",
)
response = client.chat.completions.create(
model="moonshotai/kimi-k2.5",
messages=[
{"role": "user", "content": "このサポートチケットを3つの箇条書きに要約してください。"}
],
)
print(response.choices[0].message.content)
重要な設計パターンは、単一のグローバル文字列ではなく、プロバイダー/モデルマップです。
MODELS = {
"anthropic": "claude-sonnet-5",
"novita": "moonshotai/kimi-k2.5",
}
これにより、ビジネスロジックを書き換えることなく、Claude モデルをオープンソースの代替モデルと評価できます。切り替える前に、表示名やベンチマークの見出しだけでなく、構造化出力、ツール呼び出し、コンテキスト処理、レイテンシ、障害モードを比較してください。
エージェントバックエンドとサンドボックスにおけるモデル ID
エージェントは通常、計画、ツール選択、コード修正、最終応答など、多くの回数モデルを呼び出します。モデル識別子はユーザーが制御するツール引数ではなく、バックエンド設定に配置してください。実行ごとに選択されたプロバイダーとモデル ID をログに記録し、後で評価を再現できるようにしてください。
エージェントが生成されたコードを実行する場合、モデルルーティングを実行環境から分離してください。管理された Agent Sandbox はファイル、パッケージ、コマンドを分離し、LLM API 設定はエージェントサービスに残ります。この分離により、サンドボックスイメージを変更せずにモデルエイリアスを変更したり、固定されたスナップショットをテストしたりできます。
本番環境のエージェントには、次の3つのセーフガードを追加してください。
- 起動時に、小さな認証されたリクエストまたはプロバイダカタログチェックで設定されたモデルを検証する。
- テスティング済みのフォールバック ID を保持し、テレメトリーでフォールバックのアクティベーションを可視化する。
- モデル ID、API バージョン、プロンプトバージョン、ツールスキーマを評価結果と共に保存する。
FAQ
API に正しい Claude モデル名はどれですか？
Anthropic の現在のドキュメントに記載されている正確なモデル ID（claude-sonnet-5 や日付付きの claude-haiku-4-5-20251001 など）を使用してください。「Claude Sonnet」のような表示名を単独で使用しないでください。
日付付き Claude モデル ID はエイリアスよりも優れていますか？
どちらかが常に優れているわけではありません。日付付き ID は再現性と制御されたロールアウトに適しています。エイリアスは、メンテナンスされたファミリーポインターが必要であり、プロバイダーの更新に対する回帰テストがある場合に適しています。
OpenAI 互換の API で Anthropic モデル ID を使用できますか？
そのエンドポイントが明示的に ID をサポートし、文書化している場合にのみ可能です。OpenAI 互換はリクエストインターフェースを説明するものであり、同一のモデルカタログを約束するものではありません。エンドポイントのサポートされているモデルを確認し、その正確なルーティング名を使用してください。
モデルの非推奨化によってアプリが壊れるのを防ぐにはどうすればよいですか？
テスト済みの ID を固定し、Anthropic の非推奨通知を監視し、廃止日より前に代替をテストし、モデル値を設定ファイルに保持して、ビジネスロジックの変更なしで変更できるようにしてください。
