本頁譯自英文文件。指令、識別名稱與範例保持原樣。執行環境 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）。介面標籤只是呈現層：

介面標籤	典型線路鍵
自動	（無——模型／原則預設）
關閉	`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

桌面版

模型選擇器旁的思考控制
鍵盤循環（與模型變體循環相同的按鍵繫結路徑）
標籤使用與 TUI 相同的友善對應

預設與自動行為

自動表示該模型沒有明確的使用者覆寫。
自動作用時，ReasoningPolicy 套用平衡基準（medium／供應商 default 變體），使模型真正啟用思考／傳遞努力程度旗標，而不是省略它們。
這同時適用於具有 reasoning: true 的模型，以及只把努力程度暴露為變體的供應商（例如 Claude Code／Codex／Grok Build CLI，它們回報 reasoning: false，因為輸出對 AI SDK 是不透明的）。
原則仍可能把深度提高到深入，用於計畫模式、自主模式或高風險提示（以及在提供那些訊號時的重複失敗／高不確定性／高影響範圍）。
使用者挑選明確的努力程度時，該覆寫在後續回合勝出（原則不會與它對抗）。已經設定推理／effort／thinking 的設定或 agent 選項也會被留下。
努力程度依模型記住，存在本機模型偏好中（TUI 狀態目錄裡的 model.json）。

設定

在 agent 上釘選預設：

{
  "agent": {
    "plan": {
      "variant": "high"
    }
  }
}

在 provider.<id>.models.<model>.variants 下定義或停用供應商變體，位置是 ax-code.json（形狀與 OpenCode 相同）。

最佳做法

日常工作偏好自動或平衡／深入；把最大留給困難的除錯或架構。
不要發明第四個與 Agent／Council／Arena 競爭的全域「精簡／超快／最大」模式。
在介面文案中把模型、努力程度與工作模式保持為分開的控制。
切換模型時，無效的已儲存努力程度會退回該模型的自動。

執行模式 — Agent／Council／Arena 與混合放置
支援的供應商 — 哪些供應商提供模型
OpenCode 模型變體：https://opencode.ai/docs/models/