Claude Sonnet 5 API：数分でクイックスタート
Messages API で claude-sonnet-5 を呼ぶために必要なすべて - モデル ID、curl と Python の例、effort、適応的思考、max_tokens の再調整。2026-10-20 時点で最新の Sonnet は 2026-09-28 に公開された Sonnet 5.5 のままです（$2 / $10、キャッシュ読み取りは $0.10、Sonnet 5 は $0.20）。Sonnet 4.5 は 2026-09-30 で非推奨、2026-11-30 で提供終了となり、公式の代替は claude-sonnet-5-5 です。
クイックスタート
Sonnet 5 は標準の Messages API にそのまま使えます。すでに Opus 4.8 や Sonnet 4.6 を呼び出しているなら、あと 3 つの小さなステップで完了です。まだ Sonnet 4.5 を使っている場合は、claude-sonnet-4-5-20250929 が 2026-11-30 に提供終了となる点に注意してください。代替は claude-sonnet-5-5 です。
モデルIDを設定する
claude-sonnet-5を使用します - 日付なし、-v1サフィックスなしの固定スナップショットです。基本的な呼び出しには他の変更は不要です。
サンプリングパラメータを削除する
temperature、top_p、top_kを削除します。Opus 4.7以降と同様に、Sonnet 5はこれらをHTTP 400で拒否します。
思考を適応的なままにする
適応的思考はデフォルトで有効です。手動の拡張思考設定を送信しないでください - 明示的な思考は400を返します。代わりにeffortで深さを調整してください。
curl https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5",
"max_tokens": 4096,
"thinking": { "type": "adaptive" },
"output_config": { "effort": "high" },
"messages": [
{ "role": "user", "content": "Refactor this module and add tests." }
]
}'
# NOTE: do NOT send temperature / top_p / top_k -> HTTP 400
from anthropic import Anthropic
client = Anthropic() # reads ANTHROPIC_API_KEY
resp = client.messages.create(
model="claude-sonnet-5",
max_tokens=4096,
thinking={"type": "adaptive"}, # on by default
output_config={"effort": "high"}, # low | medium | high | xhigh | max
messages=[
{"role": "user", "content": "Explain this stack trace and propose a fix."}
],
# temperature / top_p / top_k omitted -> sending them returns HTTP 400
)
print(resp.content[0].text)
どちらの例も意図的にtemperature、top_p、top_kを省略しています：claude-sonnet-5にこれらのいずれかを送信するとHTTP 400が返ります。適応的思考（thinking={"type":"adaptive"}）がデフォルトであり、effortフィールドがリクエストごとにモデルが費やす推論量を制御します。
max_tokensを再調整する
Sonnet 5は新しいトークナイザーを搭載しています。同じテキストがSonnet 4.6より約30%多くのトークンを消費するため、古いコードからコピーした上限やバジェットは問題を引き起こします。
出力上限を引き上げる
Sonnet 4.6のレスポンスに余裕を持って収まっていたmax_tokens値が、今では切り詰められる可能性があります。128Kの出力上限（output-300k-2026-03-24バッチベータヘッダー経由で300K）まで、おおよそ30%多い余裕を持たせてください。
コンテキストバジェットを再確認する
コンテキストウィンドウは1Mトークンです - デフォルトかつ最大で、より小さいバリアントはありません - ただしトークン単位でサイズ設定されていたプロンプトはより高密度に詰め込まれるため、想定するのではなくトークンカウントで再計測してください。
リクエストあたりのコストを再見積もりする
同じ文章でもトークン数が約 30% 増えるため、入力 $2/MTok・出力 $10/MTok という価格は、同一文章に対する Sonnet 4.6 の $3/$15 とほぼ費用同等と読むのが適切で、単純な 33% 引きではありません。
標準料金は入力 $2/MTok・出力 $10/MTok です（2026-09-01 の値上げ中止を受け、2026-08-10 に長期価格として確定）。キャッシュ読み取りは $0.20、5 分キャッシュ書き込みは基本入力の 1.25 倍、1 時間キャッシュ書き込みは 2 倍です。Sonnet 5.5（2026-09-28 公開）は Sonnet 5 と同じ $2/$10 で、キャッシュ読み取りは半額の $0.10 になり、公式は同じ作業により少ない token を使い、1 タスクあたりのコストは最大 30% 下がると書いています。Haiku 5.5（2026-10-07 公開）も新しいトークナイザに切り替え、公式は Sonnet 5.5 や Opus 5.5 の分に近いと説明しています。max_tokens は必ず新しいトークナイザを基準に設定してください。
effortレベル
effortパラメータは、Sonnet 5がリクエストごとに費やす推論量を調整します。5つのレベルを受け付け、デフォルトはhighです。
| effort | 最適な用途 | レイテンシと出力トークン |
|---|---|---|
| low | 分類、抽出、短いチャット、その他のレイテンシに敏感で範囲が明確な呼び出し。 | 最低レイテンシ、最少の推論トークン。 |
| medium | 日常的な補助や、フルの深さは不要だがもう少し熟考が欲しい軽めのコーディング。 | 中程度のレイテンシとトークン消費。 |
| high デフォルト | ほとんどのエージェント作業とコーディング作業 - スピードと強力な推論を両立するバランスの取れたデフォルト。 | バランス型；推奨される出発点。 |
| xhigh | 難しい多段階デバッグ、アーキテクチャ設計、より深い思考が報われる長期的なエージェント実行。 | より高いレイテンシ、より多くの推論トークン。 |
| max | コストに関係なく最大の深さが欲しい、最も要求の厳しい推論と判断のタスク。 | 最高のレイテンシとトークン消費。 |
high から始め、安価でレイテンシに敏感なトラフィックには下げ、最も難しい問題には上げてください。Sonnet 5 は低価格で当時の Opus 枠に近づきます。2026-10-20 時点で最新の Opus は Opus 5.5 です（2026-09-22 公開、$4 / $20）。公式は慎重な判断を要する複雑な作業向けと位置づけています - max effort で足りないときは Opus 5.5 へ。公式のモデル一覧は、ほとんどの作業では Opus 5.5 から始め、より強い推論や長時間のエージェント作業には Fable 5.1 を使うと書いています。
QCode経由でSonnet 5を使う
QCodeは同じMessages APIをリレーするため、Sonnet 5のコードは変更不要です - 異なるのはベースURLとキーだけです。
同一のAPIサーフェス
同じclaude-sonnet-5モデルID、同じeffortパラメータ、同じ適応的思考。SDKをリレーのベースURLに向けるだけで、既存のコードがそのまま動作します。
1つのキーで多数のモデル
単一のQCodeキーでClaude、Codex、中国系の各モデルにアクセスできます - 別々のプロバイダーアカウントや請求のやりくりは不要です。
安定した中国からのアクセス
中国本土からの通信は asia.qcode.cc のアジアノード（韓国・台湾・香港のうち最寄り）が優先で、主ドメインの api.qcode.cc はグローバルなルーティングを使います。どちらの接続でも低レイテンシで安定しており、Sonnet 5 は越境接続に苦労する必要がありません。
ツールにそのまま利用可能
anthropic SDK、Claude Code、およびMessages APIに対応するあらゆるクライアントで動作します - ベースURLを設定するだけです。
from anthropic import Anthropic
client = Anthropic(
base_url="https://api.qcode.cc/api", # QCode
api_key="cr_...", # your QCode API key
)
resp = client.messages.create(
model="claude-sonnet-5",
max_tokens=4096,
thinking={"type": "adaptive"},
output_config={"effort": "high"},
messages=[{"role": "user", "content": "Ship it."}],
)
よくある質問
Claude Sonnet 5のモデルIDは何ですか？
モデル ID は claude-sonnet-5 です - 日付なし、-v1 サフィックスなしの固定スナップショット。Amazon Bedrock では anthropic.claude-sonnet-5、OpenRouter ではスラッグが anthropic/claude-sonnet-5-20260630 です。任意の Messages API リクエストの model フィールドに claude-sonnet-5 を渡してください。まだ Sonnet 4.5 を使っている場合、公式は 2026-09-30 に claude-sonnet-4-5-20250929 を非推奨とし、2026-11-30 に提供を終えると記載、代替は claude-sonnet-5-5 です。claude-sonnet-5 自体は現在も提供中で、公式は提供終了を 2027-06-30 より前にはしないとしています。
Sonnet 5を呼び出すためにコードを変更する必要がありますか？
ほとんど不要です - モデルIDをclaude-sonnet-5に切り替えれば、既存のMessages APIコードはそのまま動作し続けます。確認すべき点は2つ：temperature、top_p、top_kの各フィールドを削除すること（Opus 4.7以降と同様に、Sonnet 5ではHTTP 400を返します）、そして手動の拡張思考設定を送信しないこと - 適応的思考はデフォルトで有効であり、明示的な思考設定は400を返します。また、新しいトークナイザーは同じテキストで約30%多くのトークンを出力するため、max_tokensを再調整してください。
Sonnet 5ではどのeffortレベルを使うべきですか？
デフォルトはhighで、ほとんどのエージェント作業やコーディング作業に適しています。分類、抽出、短いチャットのような安価でレイテンシに敏感な呼び出しにはlowまたはmediumを、最大の深さが欲しい最も難しい多段階推論にはxhighまたはmaxを使ってください。effortはレイテンシと出力トークンを推論の深さと引き換えにするため、highから始めてワークロードごとに調整してください。
QCode経由でClaude Sonnet 5を使えますか？
はい。QCodeはリレーで同じMessages APIサーフェスを公開するので、claude-sonnet-5モデルID、effortパラメータ、適応的思考はそのままです - 異なるのはベースURLとキーだけ。claude-sonnet-5-5 は 2026-09-29 に QCode で利用可能になり、claude-sonnet-5 と claude-opus-5-5 も引き続き使えます。
関連ガイド
Claude Sonnet 5概要
モデルの完全な紹介：ポジショニング、コンテキストウィンドウ、提供状況、そしてSonnet 5がラインナップのどこに位置するか。
Sonnet 5 対 Sonnet 4.6
何が変わったか - トークナイザー、価格、effort、品質 - そしてなぜSonnet 4.6が引退していないのか。
Claude Sonnet 5の料金
導入価格と標準価格、キャッシュコスト、そして実際のリクエストあたりの支出を左右するトークナイザーの注意点。
Claude Codeのコスト最適化
実践的な戦略 - effortの調整、キャッシュ、モデル選択 - でエージェントコーディングの支出を抑える。