5.21 思考深度配置

把“思考深度”当成挡位：想快就浅，想稳就深。

学完你能做什么

给某个模型单独设置思考预算（thinking budget）

理解“变体”机制如何控制思考深度

使用 Ctrl+T 在不同思考深度间切换

你现在的困境

同一个模型，有时想快、有时想深，但不知道怎么切

配置写进 opencode.json 后，不确定有没有生效

用中转站模型时，不确定是否还能控制思考深度

什么时候用这一招

当你需要：把“思考深度”做成可切换的档位

而且不想：每次换模型或改配置

🎒 开始前的准备

完成了 5.1 配置全解

已能正常启动 OpenCode

核心思路

OpenCode 用 模型变体（variants） 保存不同思考深度

变体是模型级配置，优先级高于默认值

Ctrl+T 会在变体之间循环切换

::: info ℹ️ 什么是“思考深度”？
它指的是模型的“可用思考预算”，例如 Anthropic 的 thinking.budgetTokens。
数值越大，模型可用于推理的 token 越多，但响应更慢、成本更高。
:::

跟我做

第 1 步：确认模型是否支持思考变体

为什么 不是所有模型都有变体，OpenCode 会先检查 capabilities.reasoning。

怎么做 选用支持 reasoning 的模型（如 Anthropic / Gemini 3 / OpenAI）。

你应该看到 模型列表中能出现 high / max 等变体。

第 2 步：在 opencode.json 里为单个模型设置思考预算

为什么 变体配置在 provider.models.[modelID].variants 下，可以覆盖默认值。

怎么做 按你使用的 Provider 填入对应字段：

Anthropic 示例（thinking.budgetTokens）

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "models": {
        "claude-sonnet-4-5": {
          "variants": {
            "high": {
              "thinking": { "type": "enabled", "budgetTokens": 20000 }
            },
            "max": {
              "thinking": { "type": "enabled", "budgetTokens": 32000 }
            }
          }
        }
      }
    }
  }
}

Gemini 3 示例（thinkingConfig.thinkingBudget）

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "google": {
      "models": {
        "gemini-3-flash": {
          "variants": {
            "high": {
              "thinkingConfig": { "includeThoughts": true, "thinkingBudget": 16000 }
            },
            "max": {
              "thinkingConfig": { "includeThoughts": true, "thinkingBudget": 24576 }
            }
          }
        }
      }
    }
  }
}

你应该看到 重启后模型变体的数值生效。

第 3 步：用 Ctrl+T 在思考深度间切换

为什么 变体配置写好后，用快捷键快速切换更顺手。

怎么做 在对话输入框按 Ctrl+T 循环切换：

(无) → high → max → (无) → high → ...

你应该看到 状态栏显示当前变体名称（例如 high）。

第 4 步：自定义变体名字（可选）

为什么 变体名称不是固定的，你可以改成“深度思考/极速”等。

怎么做 在 variants 里使用自定义 key：

{
  "provider": {
    "anthropic": {
      "models": {
        "claude-sonnet-4-5": {
          "variants": {
            "极速": { "thinking": { "type": "enabled", "budgetTokens": 8000 } },
            "深度": { "thinking": { "type": "enabled", "budgetTokens": 32000 } }
          }
        }
      }
    }
  }
}

你应该看到 Ctrl+T 在“极速/深度”之间切换。

::: info ℹ️ 自定义变体是“增加”，不是“替换”
OpenCode 会把你在 opencode.json 里写的变体合并到默认变体中。
如果你只想保留自定义的变体，把默认的 high/max 显式禁用即可：

{
  "provider": {
    "anthropic": {
      "models": {
        "claude-sonnet-4-5": {
          "variants": {
            "high": { "disabled": true },
            "max": { "disabled": true },
            "极速": { "thinking": { "type": "enabled", "budgetTokens": 8000 } },
            "深度": { "thinking": { "type": "enabled", "budgetTokens": 32000 } }
          }
        }
      }
    }
  }
}

:::

第三方中转站怎么配

如果你的中转站是 openai-compatible，默认使用 reasoningEffort。示例：

{
  "provider": {
    "relay": {
      "options": {
        "baseURL": "https://your-relay.example.com/v1",
        "apiKey": "{env:RELAY_API_KEY}"
      },
      "models": {
        "gpt-5": {
          "variants": {
            "low": { "reasoningEffort": "low" },
            "high": { "reasoningEffort": "high" }
          }
        }
      }
    }
  }
}

如果中转站其实转发的是 Anthropic 接口（仍走 openai-compatible SDK），可以直接写 Anthropic 字段覆盖：

{
  "provider": {
    "relay": {
      "options": {
        "baseURL": "https://your-relay.example.com/v1",
        "apiKey": "{env:RELAY_API_KEY}"
      },
      "models": {
        "claude-sonnet-4-5": {
          "variants": {
            "high": {
              "thinking": { "type": "enabled", "budgetTokens": 20000 }
            },
            "max": {
              "thinking": { "type": "enabled", "budgetTokens": 32000 }
            }
          }
        }
      }
    }
  }
}

前提是：你的中转站服务端会把 thinking 字段原样转发到 Anthropic。

检查点 ✅

opencode.json 中包含 provider.models.[modelID].variants

启动后可看到变体名称显示在状态栏

Ctrl+T 能轮换变体

踩坑提醒

现象	原因	解决
按 `Ctrl`+`T` 没反应	当前模型没有变体	换支持 reasoning 的模型或添加 variants
变体有但不显示	还未切换到某个变体	按一次 `Ctrl`+`T`
配置不生效	模型 ID 写错	从模型列表复制完整 ID
中转站没变化	用的是 `openai-compatible`，只支持 reasoningEffort	在 variants 里手动覆盖参数

本课小结

你学会了：

变体是“思考深度档位”，在 provider.models.[modelID].variants 配置

默认变体由 ProviderTransform 自动生成，可被配置覆盖

Ctrl+T 用于循环切换变体

下一课预告

下一课我们学习 调试与诊断工具。
你会学到：
如何使用 opencode debug 系列命令
诊断 LSP、配置和搜索问题
像开发者一样剖析 OpenCode

附录：源码参考

点击展开查看源码位置

更新时间：2026-01-16

功能	文件路径	行号
变体生成入口	`src/provider/transform.ts`	297-477
reasoning 过滤与排除	`src/provider/transform.ts`	298-301
Anthropic 思考预算默认值	`src/provider/transform.ts`	371-385
Gemini 3 思考预算默认值	`src/provider/transform.ts`	421-439
变体配置 Schema	`src/config/config.ts`	818-833
变体配置合并	`src/provider/provider.ts`	929-936
Ctrl+T 默认快捷键	`src/config/config.ts`	632-688
Ctrl+T 命令绑定	`src/cli/cmd/tui/app.tsx`	393-399
变体循环逻辑	`src/cli/cmd/tui/context/local.tsx`	310-346
变体显示逻辑	`src/cli/cmd/tui/component/prompt/index.tsx`	696-700
变体名称渲染	`src/cli/cmd/tui/component/prompt/index.tsx`	946-950
变体应用到 LLM 参数	`src/session/llm.ts`	96-109
变体 keybind 配置	`src/config/config.ts`	632-688

关键常量：

WIDELY_SUPPORTED_EFFORTS = ["low", "medium", "high"]

OPENAI_EFFORTS = ["none", "minimal", "low", "medium", "high", "xhigh"]

学完你能做什么#

你现在的困境#

什么时候用这一招#

🎒 开始前的准备#

核心思路#

跟我做#

第 1 步：确认模型是否支持思考变体#

第 2 步：在 opencode.json 里为单个模型设置思考预算#

第 3 步：用 Ctrl+T 在思考深度间切换#

第 4 步：自定义变体名字（可选）#

检查点 ✅#

踩坑提醒#

本课小结#

下一课预告#

附录：源码参考#