このページは英語版ドキュメントの翻訳です。コマンド、識別子、例はそのままです。ランタイム 7.24.4 · SDK 2.6.7。 英語版
モデルの努力度（思考 / バリアント）
ステータス: 現行
対象範囲: 現在の状態
最終確認: 2026-07-18
所有者: ax-code runtime
AX Code は 努力度（思考レベルとも呼びます）を使い、アクティブなモデルがどれだけ深く推論するかを制御します。努力度は 作業モードではなく、配置モードでもありません。
| 軸 | 問い | 例 |
|---|---|---|
| モデル | どのモデルか | Sonnet、Opus、GPT、ローカルの Qwen |
| 努力度 | どれだけ考えるべきか | 自動、高速、均衡、深い、最大 |
| 作業モード | 仕事はどう構成されるか | Agent、Council、Arena |
| 配置 | 推論はどこで走るか | ローカル、クラウド、ハイブリッド |
作業モードと配置モードは 実行モード を参照してください。
ワイヤ形式
ランタイムは引き続き、プロバイダーカタログの OpenCode 互換な バリアント キーを保存して送ります（たとえば low、medium、high、xhigh、max）。UI ラベルは表示層だけです。
| UI ラベル | 典型的なワイヤキー |
|---|---|
| 自動 | （なし。モデルまたは方針の既定） |
| オフ | none |
| 最小 | minimal |
| 高速 | low |
| 均衡 | medium |
| 深い | high |
| 最大 | xhigh、max |
使えるキーは モデルごと です。バリアントのないモデルは、努力度のコントロールを隠します。
プロバイダーのサポート
努力度の段階は、次のプロバイダー上の対応モデルについて自動で生成されます。
| プロバイダー | 仕組み | 段階 |
|---|---|---|
| Anthropic (Claude) | 現行モデルでは effort。レガシーモデルでは思考予算 |
高速、均衡、深い、最大（モデルによる） |
| OpenAI (GPT-5.x) | reasoningEffort |
高速、均衡、深い |
| Google (Gemini 3.x) | thinkingConfig.thinkingLevel |
高速、深い（3.1 は均衡を追加） |
| OpenAI 互換エンドポイント | reasoningEffort |
高速、均衡、深い |
| Venice | reasoningEffort |
高速、均衡、深い |
| Claude Code CLI | --effort |
高速、均衡、深い、最大 |
| Codex CLI | model_reasoning_effort の設定上書き |
最小、高速、均衡、深い、最大 |
| Grok Build CLI | --reasoning-effort |
高速、均衡、深い |
努力度 API が未検証または非互換のプロバイダー（Groq のホスト型 API、OpenRouter、DeepSeek / Alibaba / MiniMax / GLM / Mistral のファミリー、未対応の CLI プロバイダー、サードパーティのゲートウェイ）は、組み込みの段階を 出しません。/effort が、黙って失敗する代わりにこれを説明します。プロバイダーがサポートするオプション形状を文書化しているときは、provider.<id>.models.<model>.variants の下に独自の段階を定義します。場所は ax-code.json です。
努力度の設定方法
TUI
- 循環:
ctrl+t（キーバインドvariant_cycle）— 自動 → 使える各段階 → 自動 と進みます - ピッカー:
/effort（別名/variant、/thinking）。段階のないモデルでは説明ダイアログを開きます - ステータス: モデルが段階をサポートするとき、プロンプトフッターに現在の努力度チップが表示されます。送ったメッセージはメタデータ行に努力度ラベルを示します
- CLI:
ax-code run --variant high
Desktop
- モデルピッカーの隣にある思考コントロール
- キーボード循環（モデルバリアント循環と同じキーバインド経路）
- ラベルは TUI と同じ分かりやすい対応を使います
既定と自動の挙動
- 自動 は、そのモデルについて利用者の明示的な上書きがないことを意味します。
- 自動が有効なとき、ReasoningPolicy は 均衡 の基準線（
medium/ プロバイダーのdefaultバリアント）を適用し、モデルが思考を実際に有効にし、努力度フラグを渡すようにします。省略はしません。 - これは
reasoning: trueを持つモデルと、努力度をバリアントとしてだけ出すプロバイダー（たとえば Claude Code / Codex / Grok Build の CLI。出力が AI SDK から不透明なためreasoning: falseと報告します）の両方に適用されます。 - 方針は、計画モード、自律モード、または高リスクのプロンプトについて、深さを深いまで 引き上げる ことがあります（それらの信号が供給されたときの繰り返し失敗、高い不確実性、高い影響範囲についても同様です）。
- 利用者が明示的な努力度を選ぶと、その上書きが後続ターンで優先されます（方針はそれに逆らいません）。すでに推論、
effort、thinkingを設定している設定またはエージェントオプションも、そのままにされます。 - 努力度はローカルのモデル設定の中で モデルごとに 記憶されます（TUI 状態ディレクトリの
model.json）。
設定
エージェントに既定を固定します。
{
"agent": {
"plan": {
"variant": "high"
}
}
}provider.<id>.models.<model>.variants の下でプロバイダーバリアントを定義または無効にします。場所は ax-code.json です（OpenCode と同じ形です）。
良いやり方
- 日常の作業では 自動 または 均衡/深い を優先し、最大 は難しいデバッグや設計のために残します。
- Agent / Council / Arena と競合する、4 つ目のグローバルな「軽量 / 超高速 / 最大」モード を発明しないでください。
- UI の文言では、モデル、努力度、作業モードを別々のコントロールとして保ちます。
- モデルを切り替えたとき、無効になった保存済み努力度は、そのモデルでは自動へ戻ります。
関連
- 実行モード — Agent / Council / Arena とハイブリッド配置
- 対応プロバイダー — どのプロバイダーがモデルを出すか
- OpenCode のモデルバリアント: https://opencode.ai/docs/models/