|

思考をオフにしたい？claude-haiku-5-5はeffortがhighより高いとエラーになる

ByShark
思考をオフにしたい？claude-haiku-5-5はeffortがhighより高いとエラーになる

著者注：claude-haiku-5-5 はデフォルトで思考します。オフにしようとするとエラーが出る？原因はたいてい effort が high より上にあることです。本記事ではルール、3ステップの修復方法、パラメータの境界を明らかにします。

claude-haiku-5-5 にあまり考えさせず、出力枠を本文に回す——これはバッチ処理や構造化タスクを回すときに非常によくある要望です。あなたはもう thinking を disabled に設定したのに、API がエラーを返してきた、という経験はありませんか？思考をオフにしたいだけなのに、なぜかブロックされてしまう。本記事では effort と disabled の連携ルール を解説し、claude-haiku-5-5 で思考をオフにする正しい方法を素早く身につけられるようにします。

これはオカルトでも、モデルの気まぐれでもありません。ドキュメントにははっきりと書かれています。claude-haiku-5-5 は thinking を渡さなければ適応型思考となり、デフォルトで有効になります。思考をオフにするには thinking の type: disabled を使いますが、この書き方は effort が high 以下の場合にのみ受け付けられます。本記事のパラメータは 2026-11-08（UTC+8）時点の Anthropic 公式ドキュメントに基づき、確認日は 2026-11-13 です。

本記事の価値：読み終えれば、エラーの本当の原因、3ステップの修復方法、そして max_tokens と思考トークンの関係がはっきりわかります。以後、どの環境で呼び出しても、このルールに引っかかることはなくなります。

claude-haiku-5-5-disable-thinking-effort-error-ja-image-0

claude-haiku-5-5 の核心ポイント

先に結論をまとめます。時間のない読者はこのセクションだけ読めば十分です：

ポイント ドキュメントの記載 あなたへの影響
デフォルトで思考が有効 thinking を渡さなければ適応型思考となり、デフォルトで有効 クォータを節約したいなら明示的に無効化する必要がある
無効化スイッチ thinking を type: disabled に設定 唯一の無効化方法
effort のしきい値 effort が high 以下である場合にのみ disabled を受け付ける xhigh や max を設定するとエラーになる
effort のデフォルト値 デフォルトは medium で、claude-opus-5-5 と同じ 自ら引き上げなければ問題は起きない
クォータの境界 最大出力は 128000、思考トークンは max_tokens に含まれる 思考が本文の領域を圧迫する

claude-haiku-5-5 の重要ポイント解説

第一に、デフォルトで思考が行われるということです。 claude-haiku-5-5 はデフォルトで思考機能を有効にして動作するモデルです。リクエストに thinking フィールドが含まれていない場合、適応型思考として動作します。ドキュメントには適応型モードの具体的な判断詳細は記載されていませんが、デフォルト状態では思考が有効になっていることは確実です。

短い質疑応答、バッチでのラベリング、フォーマット変換など、深い推論をあまり必要としないタスクが対象の場合、思考トークンは純粋なオーバーヘッドになります。ドキュメントには、思考トークンが max_tokens に含まれ、最大出力が 128000 であることも記載されています。思考が増えるほど、本文に残せるクォータは減っていきます。これが「思考をオフにして、クォータを本文に残したい」という要望の由来です。

第二に、無効化にはしきい値があります。 思考を無効にする唯一のスイッチは、thinking を type: disabled に設定することです。ただしドキュメントには、この記述が effort が high 以下である場合にのみ受け付けられることも明記されています。effort が medium または high の場合は問題なく動作しますが、xhigh や max に設定するとリクエストがエラーになります。公式が示す修正方針も非常にシンプルで、effort を high 以下に下げることです。APIYI apiyi.com 経由で claude-haiku-5-5 を呼び出す場合も、この種のエラーを調査する際はまずこのパラメータの組み合わせから確認してください。

第三に、デフォルト値のほうがむしろ安全だということです。 claude-haiku-5-5 の effort のデフォルトは medium で、claude-opus-5-5 と同じです。その他の多くのモデルのデフォルトは high です。つまずきやすいパスは通常、別のモデルからコードを移行する際に、習慣的に effort を xhigh や max に明示的に引き上げて品質を確保しようとし、さらにコストを抑えようと disabled を付け加えるというものです。2つの意図が衝突して、エラーが発生します。

逆に、effort を積極的に上げなければ、デフォルトの medium は「high 以下」という条件を自然に満たすため、disabled は正常に有効になります。異なるモデル間で切り替え比較を行う場合、APIYI apiyi.com 上で1つの APIキーを使って複数のモデルを呼び出せば、接続設定を何度も変更する手間も省けます。

claude-haiku-5-5-disable-thinking-effort-error-ja-image-1

上の図が標準的な調査パスです。最もよくあるケースは真ん中の判断ボックスで止まります。つまり effort の範囲外です。修正後は、まず小さいクォータで APIYI apiyi.com 上で一度実行して検証し、返却が正常であることを確認してから、本番トラフィックに組み込むことをおすすめします。

claude-haiku-5-5 クイックスタート：3ステップで修正

長いドキュメントを読み通す必要はありません。以下の3ステップに従えば、この種のエラーはほぼ解決できます。

  1. モデルIDを確認する：リクエストの model は claude-haiku-5-5 であるべきです。まずモデル名の誤記による問題を除外しましょう。
  2. effort を下げる：high 以下に設定します。medium がデフォルト値なので、何も渡さなくても構いません。重要なのは xhigh や max を渡さないことです。
  3. 思考を無効化する：thinking を {"type": "disabled"} に設定します。このとき effort が high 以下であれば、リクエストは正常に受け付けられます。

claude-haiku-5-5 リクエストパラメータ早見表

パラメータ 推奨値 説明
model claude-haiku-5-5 本記事で扱うモデルです。他のバージョンを誤って指定しないよう注意してください
thinking {"type": "disabled"} 思考を無効化する唯一のスイッチ
effort medium（デフォルト）または high high 以下である必要があります。そうでないと disabled と競合します
effort の禁止値 xhigh、max disabled と組み合わせるとエラーになります
max_tokens 上限 128000 思考トークンもこの値に含まれます。思考を無効化すれば、すべてを本文用に確保できます

接続側の情報も複雑ではありません。APIYI を例にすると：

  • 接続先：https://api.apiyi.com/v1
  • 認証方式：APIキー1つでOK
  • インターフェース形式：OpenAI互換API
  • 課金方式：従量課金、価格優位、新規ユーザーには無料テスト枠あり
  • 対応範囲：OpenAI、Claude、Gemini などの主要モデル

🚀 クイックスタート：今回の検証は APIYI apiyi.com で行うことをおすすめします。登録後、無料テスト枠を使って修正後のリクエストを実行し、disabled が正常に反映されエラーが消えることを確認してから、実際の業務に接続してください。数分で一連の確認を完了できます。

claude-haiku-5-5 の effort 互換性

以下の表は、この記事全体で最も覚えておくべきポイントをまとめたものです。チームのノートにそのまま保存しておくのがおすすめです。

effort の値 disabled との組み合わせ 結果
medium（デフォルト） 互換 思考は正常にオフになる
high 互換 思考は正常にオフになる
xhigh 競合 リクエストがエラーになる
max 競合 リクエストがエラーになる

この表を見ながら自分のリクエストを照らし合わせれば、方向性はおのずと明確になります。エラーが、disabled も同時に渡しているリクエストで発生しているなら、まず確認すべきは effort が high というラインを超えていないかどうかです。ドキュメントに記載されている修正方法はただ一言——effort を high 以下に下げることであり、それ以外の回避策はありません。

claude-haiku-5-5-disable-thinking-effort-error-ja-image-2

claude-haiku-5-5 と他のモデルのデフォルト effort の比較

モデル デフォルト effort 思考オフとの関係
claude-haiku-5-5 medium デフォルトで「high 以下」を満たすため、disabled がそのまま有効になる
claude-opus-5-5 medium デフォルト値は haiku と同じ。その思考スイッチのルールは本記事では扱わない
その他の多くのモデル high デフォルト値も同様にしきい値の内側にあり、手動で引き上げたときだけ範囲を超える

この表は「なぜ自分のリクエストだけがエラーになるのか」を説明してくれます。モデルごとにデフォルトの effort は異なるため、コードを移行する際に以前のパラメータの習慣をそのまま引き継ぐと、effort を明示的に xhigh や max に設定してしまいがちです。移行前にデフォルト値を確認しておくことが、最もコストの低い予防策になります。

claude-haiku-5-5 のエラー調査とセルフチェックリスト

現象 最も考えられる原因 対処方法
disabled を渡してもまだエラーが出る effort が xhigh または max になっている effort を high 以下に下げる
effort の値がわからない 渡さない場合のデフォルトは medium デフォルト値が基準を満たすため、追加の処理は不要
本文が短くなる、または切り詰められる 思考トークンが max_tokens に含まれている 思考をオフにする、または 128000 の上限内で max_tokens を大きくする
より深い推論品質を求めたい 思考をオフにすると思考プロセスがない disabled を外し、デフォルトの適応型思考に戻す

修正が終わったら、リクエストを送信する前にこのセルフチェックリストを一通り確認してください。

  • model が正確に claude-haiku-5-5 と記述されている
  • effort が省略されている、または明示的に medium、high になっている
  • thinking が {"type": "disabled"} になっている
  • max_tokens が 128000 を超えていない

この4つの条件をすべて満たしていれば、この種のエラーに悩まされることはもうありません。最終的なパラメータの組み合わせをリクエストテンプレートとして固定化しておけば、その後の誤った変更も防げます。

claude-haiku-5-5 よくある質問 FAQ

Q1：claude-haiku-5-5 はデフォルトで思考しますか？

はい。ドキュメントによると、`thinking` を渡さない場合、claude-haiku-5-5 は適応型思考で動作し、デフォルトで有効になっています。出力枠をすべて本文に回したい場合は、明示的に `disabled` を渡してオフにしてください。

Q2：`disabled` を渡したのに、なぜまだエラーになるのですか？

最もよくある原因は `effort` が `high` より高いことです。ドキュメントには、`disabled` は `effort` が `high` 以下の場合にのみ受け付けられ、`xhigh` や `max` と組み合わせるとエラーになると明記されています。修正の方針は、`effort` を `high` 以下に下げることです。

Q3：`effort` を渡さないとどうなりますか？

デフォルトは `medium` です。claude-haiku-5-5 と claude-opus-5-5 のデフォルト値は同じ `medium` で、その他のほとんどのモデルはデフォルトが `high` です。デフォルト値はそれ自体が「`high` 以下」を満たしているため、そのまま `disabled` と組み合わせて使えます。

Q4：思考をオフにすると、出力の長さはどう変わりますか？

ドキュメントには、思考トークンが `max_tokens` に含まれ、最大出力は 128000 と記載されています。思考をオフにすれば、同じ `max_tokens` の予算をすべて本文に充てられるため、途中で打ち切られるリスクも下がります。

Q5：一時的に深い推論が欲しくなったらどうすればいいですか？

`disabled` を外して、claude-haiku-5-5 をデフォルトの適応型思考に戻しましょう。同時に `effort` を上げる場合は、「`xhigh` または `max` + `disabled`」という組み合わせにしないよう注意してください。

Q6：修正が反映されたかを素早く確認するには？

APIYI apiyi.com で登録して無料テスト枠を取得し、接続先に `https://api.apiyi.com/v1` を使って、修正後のパラメータで一度実行してみてください。リクエストがエラーにならず、本文が正常に返ってくれば、`disabled` が有効になっています。プラットフォームは従量課金なので、少額での検証コストは非常に低く抑えられます。

Q7：エラーは必ず `effort` が原因ですか？

必ずしもそうではありませんが、これはドキュメントに明記されている代表的なパターンのひとつです。まず `model` が正確に `claude-haiku-5-5` と書かれているかを確認し、次に `thinking` と `effort` の組み合わせが範囲を超えていないかチェックしてください。それらを除外したうえで、他の原因を見ていきましょう。APIYI 経由で呼び出しているときのエラーも、同じようにこのパラメータの組み合わせから確認を始めてください。

Q8：これらのパラメータの基準はどのバージョンに従うべきですか？

本記事は 2026-11-08（UTC+8）時点の Anthropic 公式ドキュメントを基準としており、確認日は 2026-11-13 です。今後、公式が `effort` と `disabled` のルールを調整した場合は、最新のドキュメントを優先してください。

まとめ

claude-haiku-5-5 で思考をオフにする話は、要するに次の4点です。

  1. デフォルトで思考する：thinking を渡さない場合は適応型思考となり、デフォルトで有効です。クォータを節約したいなら明示的にオフにする必要があります。
  2. オフには条件がある：thinking を disabled に設定する場合、effort は high 以下である必要があります。xhigh や max を組み合わせるとエラーになります。
  3. デフォルトのままが安全：effort のデフォルトは medium で、claude-opus-5-5 と同じです。自分から上げなければ競合は起きません。
  4. クォータの境界：最大出力は 128000 で、思考トークンは max_tokens に計上されます。オフにすればクォータをすべて本文に回せます。

次に「思考を切ろうとしたらエラーが出た」という場面に遭遇したら、まず effort が high のラインを越えていないかを確認し、パラメータの組み合わせを整理してみてください。それでほぼ解決します。APIYI apiyi.com の無料テストクォータを使って効果を素早く検証するのがおすすめです。APIキー1つで claude-haiku-5-5 を含む各種の主要モデルを呼び出せ、OpenAI 互換インターフェースなのでモデルの切り替えも手間がかかりません。

📚 参考資料

  1. APIYIドキュメント：Claude の effort と thinking パラメータの説明
  2. リンク： docs.apiyi.com/api-capabilities/claude-effort-thinking.md

  3. 内容： effort の値、disabled を受け付ける条件、エラーの仕様

  4. APIYIドキュメント：Claude 思考ガイドの更新（2026-11）

  5. リンク： docs.apiyi.com/live/2026-11/claude-thinking-guide-refresh.md

  6. 内容： 思考関連ガイドの更新記録と背景

  7. Anthropic 公式ドキュメント

  8. リンク： docs.anthropic.com
  9. 内容： 本記事のパラメータは 2026-11-08（UTC+8）版の公式仕様に準拠しています

著者：APIYI技術チーム
技術交流：APIYI サイトのトップページからお気軽にお問い合わせください。詳細資料はドキュメントセンターでご覧いただけます

類似投稿