本页译自英文文档。命令、标识符和示例保持原样。运行时 7.24.4 · SDK 2.6.7。英文原文

模型努力程度（思考 / 变体）

状态：生效范围：当前状态最近审阅：2026-07-18 负责人：ax-code 运行时

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 的配置或代理选项也会被保留。
努力程度按 每个模型 记在本地模型偏好中（TUI 状态目录里的 model.json）。

配置

在代理上钉住一个默认值：

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

在 provider.<id>.models.<model>.variants 下定义或禁用提供商变体，位置是 ax-code.json（形状与 OpenCode 相同）。

最佳实践

日常工作优先使用自动或 均衡/深入；把最大留给困难的调试或架构工作。
不要发明第四种与 Agent/Council/Arena 竞争的全局 “lite / xfast / max” 模式。
在界面文案中把模型、努力程度和工作模式保持为分开的控件。
切换模型时，对该模型无效的已存储努力程度会回退到自动。

执行模式 — Agent / Council / Arena 以及混合放置
支持的提供商 — 哪些提供商暴露模型
OpenCode 模型变体：https://opencode.ai/docs/models/