著者注：本記事は、2026-11-08（UTC+8）時点の Anthropic 公式ドキュメントと、2026-11-09 10:40 に更新された APIYI の Claude 思考パラメータガイドに基づいて整理したものです。記載内容の確認日は 2026-11-13 で、claude-opus-5-5 と claude-sonnet-5-5 の thinking パラメータで発生する 400 エラーを回避することを目的としています。
claude-opus-5-5 で thinking の type に disabled を渡すと、API はそのまま 400 を返します。これは 2026-11-08（UTC+8）時点の Anthropic 公式ドキュメントに明記されている仕様です。APIYI（apiyi.com）は 2026-11-09 10:40 に Claude 思考パラメータガイドを更新し、2 つのモデル ID それぞれの正しい書き方を整理しました。本記事では、この変更が Claude API の利用者に与える影響を手早く解説します。
これは噂話ではありません：2 つの重要な結論はいずれもドキュメントに基づいています。claude-opus-5-5 は思考を無効化できず、effort を下げることしかできません。claude-sonnet-5-5 で事前思考をオフにするには、between_tools を使う必要があります。
核心的なポイント：3 分で、2 つのモデル ID の正しい書き方、between_tools のパラメータ境界、そして 400 エラーの調査アプローチがわかります。
要点早見：claude-opus-5-5 と claude-sonnet-5-5 の thinking 仕様
まず結論の表を見て、それから個別に詳しく見ていきましょう。
| 項目 | 内容 |
|---|---|
| 公式仕様 | 2026-11-08（UTC+8）Anthropic 公式ドキュメント |
| APIYI ガイド更新 | 2026-11-09 10:40、docs.apiyi.com に同期済み |
| claude-opus-5-5 | thinking を渡さなければ自動思考。disabled を渡すと 400 を返す |
| claude-sonnet-5-5 | thinking を渡さなければ同じく自動思考。前置き思考をオフにするには between_tools |
effort のデフォルト値 |
Opus 5.5 は medium、Sonnet 5.5 は high |
| 最大出力 | どちらのモデル ID も 128000 で、思考トークンもこの中に含まれる |
claude-opus-5-5 の仕様はかなりシンプルです。リクエストに thinking フィールドを渡さない場合、モデルは自動思考モードに入り、その回に思考するかどうか、どれだけ深く思考するかを自分で判断します。一方、thinking の type を disabled に設定すると、API はそれを黙って無視せず、そのまま 400 を返します。つまりこのモデル ID には思考をオフにするスイッチが存在せず、ドキュメントが示す唯一の調整手段は effort を下げることで、デフォルトの段階は medium です。
claude-sonnet-5-5 の立場は少し異なります。同様に thinking を渡さない自動思考に対応していますが、公式に認められたオフの経路がもう一つあります。type を between_tools に設定すると、前置き思考をオフにし、ツール呼び出しの合間の進捗更新だけを残せます。この経路の境界も明確に書かれているので、次の表を直接参照するのがおすすめです。
| 制約項目 | ドキュメントの仕様 |
|---|---|
effort の値 |
low、medium、high のみ受け付ける |
| 段階の上限 | high を超えることはできない |
| 併用制限 | display または budget_tokens を同時に指定できない |
| 実際の効果 | 前置き思考をオフにし、ツール呼び出し間の進捗更新のみを残す |
もう一つ見落とされやすいポイントがあります。思考トークンは max_tokens にカウントされるのです。どちらのモデル ID も最大出力は 128000 ですが、max_tokens を低く抑えすぎると、思考が先に予算の大半を消費し、本文が途中で切れてしまう可能性があります。「返答がなぜか短くなった」という問題を調査するときは、まず思考の消費量を確認するとよいでしょう。
図の説明：図中の呼び出しチェーンは、APIYI apiyi.com の Anthropic ネイティブ形式ゲートウェイを例としています。Anthropic 形式を使う場合、base アドレスは https://api.apiyi.com で、/v1 を付けた形式にしないよう注意してください。
影響分析：disabled が 400 を返す影響はどの呼び出し側に及ぶか
今回の仕様変更が呼び出し側に与える影響は、エラー処理、パラメータの組み合わせ、予算計画の3点に集中しています。項目ごとに見ていくと、より分かりやすいでしょう。
既存コードへの影響：disabled 記法の移行
| シナリオ | 旧記法 | 現在の結果 | 正しい方法 |
|---|---|---|---|
| claude-opus-5-5 で思考を無効化したい | type に disabled を渡す |
400 が返る | 無効化できない。effort を下げるしかない |
| claude-sonnet-5-5 で先行思考を無効化したい | type に disabled を渡す |
400 が返る | between_tools に変更する |
| 思考予算を細かく制御したい | between_tools と budget_tokens の併用 |
組み合わせが受け付けられない | 両者は同時に渡せない。effort の3段階に変更する |
| 思考が出力を圧迫するのが心配 | max_tokens を非常に小さく設定 |
本文が途切れる | 思考が max_tokens に含まれるため、余裕を確保する |
第一の影響は、パラメータの組み合わせに関する制約が増えたことです。between_tools は budget_tokens や display と同時に指定できません。つまり、思考予算を細かく制御する方法はこの経路では使えず、low、medium、high の3段階による間接的な調整に頼るしかありません。さらに「思考トークンが max_tokens に含まれる」というルールも重なるため、呼び出し側は effort と max_tokens の間で新たなバランスを見つける必要があります。
第二の影響は、分岐ロジックの更新が必要になることです。スクリプトがモデル ID に応じて disabled を渡すかどうかを決めている場合、この2つの ID では分岐が必要になります。前者は「無効化できない」という現実を受け入れ、effort を下げる。後者は between_tools に切り替える。こうした分岐は1か所の設定にまとめて管理すれば、今後仕様が変わったときの修正範囲を最小限に抑えられます。
ちなみに、同じページには Fable 5.1 と Fable 5 で disabled を渡しても同様に 400 になり、これも無効化できないと記載されています。一方、Haiku 5.5 と Opus 5 は effort が high 以下の場合に限り disabled を引き続き使用できます。コードが複数のモデル ID に対応している場合は、同じ記法を全体に適用するのではなく、モデルごとにスイッチのマトリクスを管理することをお勧めします。
コスト構造への影響：thinking token と使用量
claude-sonnet-5-5 は APIYI（apiyi.com）の料金表で、入力 $2、出力 $10、キャッシュ読み取り $0.1 と設定されています。思考トークンが max_tokens に含まれるため、先行思考を無効化するかどうか、effort をどの段階にするかが、そのままトークン使用量に反映されます。高頻度で呼び出す場面ではこの差が増幅されるので、コードを変更する際にちょっと計算してみる価値はあるでしょう。
図の説明：仕様は 2026-11-08 時点の公式ドキュメントに基づいて整理したもので、APIYI apiyi.com のドキュメントセンターで原文と照合して確認できます。
| モデル ID | disabled の可用性 |
ドキュメントの仕様 |
|---|---|---|
| claude-opus-5-5 | 使用不可、400 を返す | 思考を無効化できない。effort を下げるしかない（デフォルト medium） |
| claude-sonnet-5-5 | 使用不可、400 を返す | between_tools に変更する（デフォルト high） |
| Fable 5.1 / Fable 5 | 使用不可、400 を返す | これも無効化できない |
| Haiku 5.5 / Opus 5 | effort が high 以下の場合に使用可能 |
旧記法はこの2つの ID でのみ有効 |
claude-sonnet-5-5 の between_tools をすばやく検証する方法
変更をリリースする前に、少量のトラフィックで動作の違いを検証することをおすすめします。APIYI（apiyi.com）で登録して APIキーを取得してください。新規ユーザーには無料のテスト枠が用意されています。リクエストは https://api.apiyi.com に送信し、リクエストボディで thinking の type を between_tools に設定します。effort は3段階のいずれかを選び、まず1回実行します。その後、thinking を渡さないアダプティブモードと比較して、出力構造とトークン使用量の変化を確認してください。
🚀 すばやく検証するためのヒント：APIYI apiyi.com で無料のテスト枠を取得し、同じプロンプトセットで
between_toolsとアダプティブの2つのモードをそれぞれ実行してください。違いを確認したうえで、既存コードを変更しましょう。プラットフォームは Claude、OpenAI、Gemini などの主要モデルの統一呼び出しに対応しており、OpenAI 互換インターフェースは従量課金なので、横並び比較や切り替えが簡単です。
よくある質問 FAQ：disabled、between_tools、400 エラー
Q1：claude-opus-5-5 は本当に思考をオフにできるのか？
できません。2026-11-08 の公式見解では、`disabled` を渡すと 400 が返ると明記されています。このモデル ID には思考をオフにするスイッチがなく、`effort` で思考の深さを下げることしかできません。デフォルトの段階は `medium` です。シナリオ上、完全に思考をなくす必要がある場合は、モデル ID を変更するしかありません。
Q2：claude-sonnet-5-5 の between_tools は budget_tokens と併用できますか？
できません。ドキュメントには、`between_tools` が `display` または `budget_tokens` を同時に持てないと明記されています。対応する `effort` は `low`、`medium`、`high` の3段階のみを受け付け、`high` を超えることはできません。思考予算を細かく制御したい場合は、アダプティブモードに戻すか、モデル ID を変更するしかありません。
Q3：Claude へのリクエストが突然 400 を返すのはなぜ？
まず、リクエストボディで `thinking` の `type` を `disabled` に設定していないか確認してください。claude-opus-5-5 と claude-sonnet-5-5 では、これがドキュメントに明記されたトリガー条件です。確認後は本文の対照表に従って処理します。前者は `effort` を下げ、後者は `between_tools` に切り替えます。適用される記述は 2026-11-08（UTC+8）の公式ドキュメントに準拠し、APIYI のページは 2026-11-09 10:40 に同期済みです。
Q4：claude-sonnet-5-5 の between_tools の効果をすばやく検証するには？
APIYI（apiyi.com）でアカウントを登録し、APIキーを取得してください。新規ユーザーには無料のテスト枠があります。リクエストは `https://api.apiyi.com` に送信し、`thinking` の `type` を `between_tools` に設定し、`effort` をいずれか1段階に選んで1回実行すれば、アダプティブモードとの違いを比較できます。
Q5：思考トークンは出力予算を圧迫しますか？
はい。思考トークンは `max_tokens` に計上され、2つのモデル ID の最大出力はいずれも 128000 です。リクエストで `max_tokens` を低く設定しすぎると、思考が先に予算を消費して本文が切り詰められる可能性があります。本文用に十分な余裕を確保することをおすすめします。
claude-opus-5-5 と claude-sonnet-5-5 の核心ポイント Key Takeaways
- claude-opus-5-5 は思考をオフにできない：
disabledを渡すと即 400 になります。下げられるのはeffortだけであり、デフォルトはmediumです。 - claude-sonnet-5-5 は
between_toolsに変更：事前の思考をオフにし、ツール呼び出しの合間の進捗更新だけを残します。 - 3 つのパラメータの禁止事項：
effortはlow、medium、highのみで、highを超える値は不可です。displayおよびbudget_tokensとの併用も禁止です。 - 予算のルール：思考トークンは
max_tokensに計上され、2 つの ID の上限はいずれも 128000 です。 - 検証の入口：APIYI apiyi.com。Anthropic 形式の base は
https://api.apiyi.comであり、/v1を付けないでください。
まとめ：400 を避けるための 3 つのアクション
claude-opus-5-5 と claude-sonnet-5-5 の仕様は、次の 3 文にまとめられます。
- claude-opus-5-5：
disabledを渡すと 400 になります。思考はオフにできず、effortを下げるしかありません。 - claude-sonnet-5-5：事前思考をオフにする場合は
between_toolsに切り替えます。effortは 3 段階で、displayとbudget_tokensの併用は禁止です。 - 予算：思考トークンは
max_tokensに含まれ、上限は 128000 です。本文用に余裕を残しておきましょう。
この 400 エラーで止まっているのであれば、まず APIYI apiyi.com の無料テスト枠で between_tools を一巡動かして挙動を確認し、そのうえで既存のコードを書き換えるのがおすすめです。1 つの API キーで OpenAI、Claude、Gemini などの主要モデルを呼び出せ、従量課金なので素早い比較や切り替えに向いています。
📚 参考資料
- APIYI Claude 思考パラメータガイド：effort と thinking の適切な書き方
- リンク：
docs.apiyi.com/api-capabilities/claude-effort-thinking.md -
説明：2026-11-09 10:40 更新版、本記事の主な事実ソース
-
APIYI ガイド刷新の動向：今回の基準同期に関する公式説明
- リンク：
docs.apiyi.com/live/2026-11/claude-thinking-guide-refresh.md -
説明：2026-11-08 の公式ドキュメントとの整合過程を記録したもの
-
Anthropic 公式ドキュメント：thinking パラメータの原典
- リンク：
docs.anthropic.com - 説明：対照して読むことをおすすめします。最新の記述をご確認ください
作者：APIYI 技術チーム
技術交流：APIYI ウェブサイトのトップページからお気軽にお問い合わせください。より多くの資料は docs.apiyi.com ドキュメントセンターでご覧いただけます
