メインコンテンツへスキップ
これらの設定は、AI providers ページにあるモデルの追加・編集フォームの Advanced settings カードで行います。

Reasoning / 拡張思考

モデルの追加フォームでは、Advanced settings の下に Thinking / Reasoning のトグル(Off / Low / Medium / High / Custom)が表示されます。選択できるオプションは、そのモデルが実際にできることに対応しています。
  • reasoning を行えないモデルは、注記とともに Off に固定されます。
  • 特定のレベルでのみ reasoning を行うモデル(例:GPT-5 の medium/high)では、無効なレベルが選択できなくなります。
  • デフォルトで reasoning を行うモデルでは、出発点として適切な Medium が選択されます。

プリセットレベル

Low / Medium / High を選択すると、Kodus はそのレベルを各プロバイダーのネイティブ形式に自動で変換します。
常に reasoning を行うバリアント(Kimi k2p7-code/k3、GLM-5.3)は無条件に reasoning を行い、Off にできません。Test はこれらのモデルでの Off の設定を拒否します。

Custom JSON override

Thinking / Reasoning のトグルで Custom を選択すると、JSON のテキストエリアが表示されます。プロバイダーのオプションをそのまま貼り付けてください。Kodus が現在のプロバイダーの名前空間で自動的にラップします。 Vercel AI SDK のルーティングルールを知っておく必要はありません。 次のような場合に使用します。
  • Claude で、プリセットの effort マッピングではなく特定の budgetTokens の値が必要な場合
  • OpenAI-compatible プロバイダーで、モデルごとに thinking の有効・無効を切り替えたい場合
  • reasoning 以外のフィールド(キャッシュ、サービスティア、セーフティ設定、user タグ付けなど)を指定したい場合。オーバーライドは providerOptions にマージされるため、アダプターのどのフィールドも通過します
  • プロバイダーが、Kodus がまだラップしていない新しいフィールドを提供した場合

例(そのまま貼り付けます。名前空間は不要です)

Claude の thinking バジェットをちょうど 20,000 トークンにオーバーライドします(Claude 4.7 以降は budgetTokens を拒否するため、そちらでは effort を使用してください)。
プロンプトキャッシュを有効にします(reasoning 以外の例)。

名前空間を手動で指定する(上級者向け)

JSON の最上位がすでに既知の名前空間キー(下のマッピング表にあるキー)で始まっている場合、Kodus はそのまま変更しません。複数のプロバイダーの名前空間を混在させたい場合や、明示的に指定したい場合に便利です。
内部的には、Kodus は次の名前空間のマッピングを使用しています。

注意点

  • 有効な JSON オブジェクトのみ。 カンマの欠落、末尾のカンマ、オブジェクト以外の値は、保存時に拒否されます。
  • 優先順位: JSON オーバーライドは、effort プリセットの名前空間ブロックを完全に置き換えます。anthropic.thinking をオーバーライドして anthropic.effort を指定し忘れた場合、そのフィールドは送信されません。OpenRouter のルーティング(Pin providers / Allow fallbacks)は唯一の例外で、openrouter の下でオーバーライドとディープマージされます。
  • 不明なプロバイダーはラップされない。 BYOK プロバイダーが上の名前空間の表にない場合、Kodus は JSON をそのまま渡します。

Temperature

Temperature は Advanced settings の中にあり、フィールドはモデルのルールに合わせて変化します。ルールはフォームの推測ではなく、プロバイダーが定めたものです。
Test は、設定した temperature をこれらのルールに照らして検証し、保存する前にエラーを返します。そのため、モデルが受け付けない値が保存されることはありません。

同時実行数とレート制限

maxConcurrentRequests フィールド(Advanced settings 内の Max concurrent requests)は、Kodus がプロバイダーに並列で送信する処理中のリクエスト数に上限を設けます。ほとんどの場合はデフォルトで問題ありませんが、同時実行数に厳しい上限があるサブスクリプションプランでは、明示的な設定が必要です。

設定する値

調整するタイミング

引き上げる場合

  • Moonshot や OpenRouter で高いティアのチャージがあり、大きな PR でより高いスループットが欲しい
  • 複数ファイルにまたがる PR でレビューが直列に実行されているように感じられ、429 は出ていない

引き下げる場合

  • レビューのログに 429 や Too much concurrency のエラーが出る
  • プロバイダーのダッシュボードでレート制限に関する警告が出ている
  • より多くの PR にわたって、Coding Plan のウィンドウ(5 時間 / 週次)を節約したい
同時実行数、RPM、TPM の違い。 maxConcurrentRequests が制限するのは、並列で処理中のリクエスト数だけです。多くのプロバイダーは、別途 RPM(1 分あたりのリクエスト数)と TPM(1 分あたりのトークン数)の制限も適用します。同時実行数に問題がなさそうなのに RPM や TPM に達する場合は、通常、ティアのアップグレードや負荷の分散で対処します。maxConcurrentRequests を変更しても解決しません。
フォールバックとの関係。 タスクのモデルが 429 で失敗し続け、Kody が Fallback model にフェイルオーバーすると、フォールバック側の maxConcurrentRequests が適用されます。別のプロバイダーに余裕のあるフォールバックを設定しておくと、メインのモデルが厳しい制限のサブスクリプションにある場合のバーストを吸収できます。