工具配置 · 截至 2026-11-19

OpenCode 配置 GPT-6.2:2.3.2 起 system prompt 可被缓存

截至 2026-11-19,OpenCode 2.3.2(2026-11-18 发布)把 GPT-6.2 的 system prompt 从 Responses 的 instructions 字段改成开头一条 developer message 发送,从第二步起可被缓存,不再每一步都按未缓存输入重新计费。这一修复覆盖 changelog 列出的 Responses 路由;走 QCode 这类自定义 baseURL 时,请用用量明细核对。配置要点:openai provider 的 options.baseURL 写 https://api.qcode.cc/openai/v1(中国大陆用 https://asia.qcode.cc/openai/v1)。按 OpenAI 官方标价,gpt-6.2-sol 的缓存读取为每 1M token $0.10,是输入价 $2.00 的 1/20。

更新于 2026-11-19

把这个工具接到 QCode 端点:一把 key 调 Claude、GPT 与国产模型。

#instructions 不再重复计费#覆盖全部 Responses 路由#QCode 端点配置#缓存读取 1/20 单价

四个数字看懂这次缓存修复

2.3.2

修复所在的 OpenCode 版本

OpenCode 2.3.2 于 2026-11-18 发布,条目名就叫 GPT-6.2 Prompt Caching:把 system prompt 改走 developer message,覆盖 OpenAI(API key 与 ChatGPT 登录)、GitHub Copilot、Zen、Azure 与 OpenRouter。

$0.10

Sol 缓存读取价(每 1M token)

OpenAI 官方标价:gpt-6.2-sol 输入 $2.00、输出 $10.00、缓存读取 $0.10;gpt-6.2-astra 输入 $8.00、输出 $40.00、缓存读取 $0.40。缓存写入另计,30 分钟保留档下 gpt-6.2-sol 为 $2.50。

≈ $0.14

50 步会话的示意账

设 system prompt 加工具定义共 20,000 token、一次会话 50 步:全程未缓存即 1,000,000 token,按 gpt-6.2-sol 官方标价约 $2.00;第二步起命中缓存则约 $0.04 + $0.098 ≈ $0.14(按官方标价示意,不含缓存写入费)。

用量明细

升级后自己核对有没有命中

跑几步后在 QCode 控制台的用量明细里看第二步起是否出现缓存读取。changelog 列出的路由没有点名自定义 baseURL 的 OpenAI 兼容网关,命中与否只能用这份用量明细确认。

OpenCode 里的 GPT-6.2 提示缓存到底改了什么

截至 2026-11-19,问题出在请求的形状上,不是模型本身:OpenCode 内置的 openai provider 走 Responses 接口,而 GPT-6.2 不会缓存放在 Responses instructions 字段里的 system prompt。changelog 原句是 GPT-6.2 models don't cache a system prompt sent in the Responses instructions field, so every step re-billed it as uncached input. 而 OpenCode 的每个 agent 都带自己的 system prompt 与工具定义,这套前缀在一次几十步的会话里会被反复发送,于是每一步都按未缓存输入重新计费,账单自然偏高。2.3.2 把这段 system prompt 换成开头一条 developer message,让它成为可缓存前缀,从第二步起走缓存读取价。

2026-11-17 到 11-18,OpenCode 连发三个版本

2026-11-17 的 v1.19.6 让 OpenCode 1 提供升级到 OpenCode 2.0:安装包后台下载,可选 Restart to upgrade、Upgrade on quit 或 Later,会话、项目与设置保留,但为 OpenCode 1 写的插件需要更新。2026-11-18 的 v2.3.1 让超时的 shell 命令转入后台而不是被杀,timeout: 0 现在等于默认 120 秒,压缩摘要改在后台写(compaction.background: false 可关,未被使用的后台摘要仍然消耗 token),用 ChatGPT 登录时模型选择器里出现 GPT 6.2 Sol 与 GPT 6.2 Astra。同日 v2.3.2 修掉上面这个 GPT-6.2 prompt 缓存问题,另修 webfetch 结构化输出重复回显被调用时的 url 与 format。

三个版本节点:从后台任务到缓存修复

2026-11-13

OpenCode v2.3.0 把 subagent 改成默认后台运行,并把连续的 tool call 与思考折成一行活动摘要。

2026-11-17

v1.19.6 让 OpenCode 1 提供升级到 OpenCode 2.0,安装包后台下载、由用户选择何时重启,会话与设置保留,但为 OpenCode 1 写的插件需要更新。

2026-11-18

同日两个版本:v2.3.1 让超时的 shell 命令转入后台、压缩摘要改后台写、ChatGPT 登录可见 GPT 6.2 Sol 与 Astra;v2.3.2 把 GPT-6.2 的 system prompt 改走 developer message,从第二步起可缓存。

已核实的修复 vs 官方还没公布的部分

已核实(changelog 原句与官方标价)

截至 2026-11-19 可核对的有

  1. 1OpenCode 2.3.2(2026-11-18)条目写明 GPT-6.2 模型不缓存放在 Responses instructions 字段里的 system prompt,OpenCode 改为在每条 Responses 路由上把它作为开头一条 developer message 发送,路由包括 OpenAI(API key 与 ChatGPT 登录)、GitHub Copilot、Zen、Azure 与 OpenRouter。
  2. 2v2.3.1 同日:超时 shell 转后台、timeout: 0 等于默认 120 秒、压缩摘要后台写(compaction.background: false 可关,未使用的摘要仍计 token)。
  3. 3OpenAI 官方标价:gpt-6.2-sol 输入 $2.00、缓存读取 $0.10、输出 $10.00;gpt-6.2-astra 输入 $8.00、缓存读取 $0.40、输出 $40.00。
  4. 4QCode 的 OpenCode 接入文档:OpenAI 端点 https://api.qcode.cc/openai/v1,密钥经 /connect 保存。

常见误解与官方未公布的事项

changelog 没有说的两件事

  1. 1没有给出任何节省数字,只写了「从第二步起被缓存」,所以升级到 2.3.2 不等于账单会自动按固定比例下降
  2. 2没有点名自定义 baseURL 的 OpenAI 兼容网关,所以用 QCode 这类端点时要自己看用量明细,不能假定一定命中。官方尚未公布:OpenCode 是否会在用量界面直接标出缓存命中率;各网关侧的缓存保留策略。

继续留在旧版等确认 vs 先升级再按用量核对

继续用旧版,等别人先确认

system prompt 继续留在 instructions 里,每一步都按未缓存输入计费;prompt 与工具定义越长、会话步数越多,重复计费的部分越大。等待期间唯一确定的是账单结构没变。

先升到 2.3.2 以上,配好端点再核对

升级后 system prompt 变成开头一条 developer message,按 changelog,从第二步起应当可以走缓存读取价;再按自己的用量明细核对第二步起是否出现缓存读取,把「便宜了多少」交给实测而不是猜测。

从装好到能核对缓存的六步

  1. 1先确认版本:在终端跑 opencode --version,低于 2.3.2 就升级;OpenCode 2 用 curl -fsSL https://opencode.ai/v2/install | bash 或 npm install -g @opencode/cli 安装,从 OpenCode 1 升级可先跑 opencode upgrade --major。
  2. 2编辑 ~/.config/opencode/opencode.json,在 openai provider 的 options.baseURL 写 https://api.qcode.cc/openai/v1(中国大陆用 https://asia.qcode.cc/openai/v1,末尾不加斜杠),模型引用写成 openai/gpt-6.2-sol 与 openai/gpt-6.2-astra。
  3. 3在 OpenCode 里输入 /connect,选 OpenAI,选 Manually enter API Key,粘贴 QCode 的 cr_ 密钥;要同时用 Claude,就在 /connect 里选 Anthropic,端点按 QCode 的 OpenCode 文档填 anthropic provider 的地址(与 Claude Code 用的 https://api.qcode.cc/api 不是同一条)。
  4. 4用 /models 选中 openai/gpt-6.2-sol,跑几步真实任务,别只发一句话就下结论。
  5. 5打开 QCode 控制台的用量明细,看第二步起是否出现缓存读取;如果仍然全部按输入计费,先回头核对版本号和是不是真的走了 Responses 路由。
  6. 6国产模型要另建 provider:QCode 的 Responses 接口不支持国产模型,按文档走 chat/completions、baseURL 同为 https://api.qcode.cc/openai/v1 单独建一个,例如 glm-5.3;用 V1 格式(provider 下的 options.baseURL,即 QCode 文档示例那种写法)时,国产模型 provider 的包名是 @ai-sdk/openai-compatible;只有改用 OpenCode 2 原生格式(providers 下的 settings.baseURL)时,包名才是 @opencode/ai/providers/openai-compatible(其 Responses 变体为 @opencode/ai/providers/openai-compatible/responses)。

在 QCode 里配一条端点,模型与单价看 /models

一把 QCode cr_ 密钥可以在 OpenCode 里同时配两条端点:GPT-6.2 Sol 与 GPT-6.2 Astra 走 OpenAI 端点 https://api.qcode.cc/openai/v1(大陆可用 https://asia.qcode.cc/openai/v1,末尾不加斜杠),Claude 系按 QCode 的 OpenCode 文档填写 anthropic provider 的地址。模型 ID 与实时单价统一看 /models。不想包月?按量包 ¥26 起买一笔额度,7 天内用完为止;已有个人套餐的用户额度不够时买加油包。

常见问题

OpenCode 里用 QCode 的密钥配置 GPT-6.2,最少要改哪几处?

三处:配置文件、密钥、模型。先在 ~/.config/opencode/opencode.json 的 openai provider 里把 options.baseURL 写成 https://api.qcode.cc/openai/v1(中国大陆写 https://asia.qcode.cc/openai/v1),再在 OpenCode 里用 /connect 选 OpenAI、选 Manually enter API Key 粘贴 cr_ 密钥,最后用 /models 选 openai/gpt-6.2-sol 或 openai/gpt-6.2-astra。改完 /exit 重开一次,问一句能正常回答就说明通了。

已经升级到 2.3.2,为什么账单看起来还是贵?

先确认三件事:一是 opencode --version 真的到了 2.3.2 或更新;二是请求确实走了 Responses 路由,而不是被别的 provider 或旧插件接管;三是账单里除了缓存读取,还有输入、输出和缓存写入三项,gpt-6.2-sol 的缓存写入按 30 分钟保留档是每 1M token $2.50(OpenAI 官方标价)。另外,system prompt 与工具定义越长、会话步数越多,前缀重复的量才越大;短会话本来就没有多少可省空间。

OpenCode 里 GPT-6.2 的提示缓存怎么计价,到底能便宜多少?

按 OpenAI 官方标价,gpt-6.2-sol 输入每 1M token $2.00、缓存读取 $0.10;gpt-6.2-astra 输入 $8.00、缓存读取 $0.40。用示意数字:system prompt 加工具定义 20,000 token、会话 50 步,全程未缓存是 1,000,000 token,Sol 下约 $2.00;第二步起命中缓存则约 $0.04 + $0.098 ≈ $0.14(按官方标价示意,不含缓存写入费)。真实节省取决于前缀长度、步数与写入次数,所以不给固定百分比。

GLM、DeepSeek、Kimi 这类国产模型在 OpenCode 里要单独配一个 provider 吗?

要。QCode 的 OpenCode 文档写明:内置的 openai provider 走 Responses 接口,而 QCode 的 Responses 接口不支持国产模型,因此要另建一个走 chat/completions 的 provider,baseURL 仍是 https://api.qcode.cc/openai/v1,模型例如 glm-5.3。按 QCode 文档的 V1 格式(provider 下的 options.baseURL)写时,这个 provider 的包名是 @ai-sdk/openai-compatible;@opencode/ai/providers/openai-compatible 只用于 OpenCode 2 原生格式(providers 下的 settings.baseURL),其 Responses 变体是 @opencode/ai/providers/openai-compatible/responses,两种格式不要混用。哪个模型能调、单价多少,看 /models。

opencode.json 里该写 options.baseURL 还是 settings.baseURL?

看你用的是哪一代格式。OpenCode 1 与沿用 V1 格式的配置写在 provider 下的 options.baseURL,QCode 文档给的两个 provider 示例就是这种写法;只想用 OpenCode 2 并偏好原生格式时,写成 providers 下的 settings.baseURL,OpenCode 2 只在内存里归一化字段,不会改写你的源文件。OpenCode 官方 providers 文档也是用 settings.baseURL 覆盖目录里 provider 的端点。两种写法的地址相同。

用 QCode 这种自定义 baseURL 的端点时,升级到 2.3.2 后缓存修复还有效吗?

官方没有给出结论。2.3.2 的 changelog 列出的路由是 OpenAI(API key 与 ChatGPT 登录)、GitHub Copilot、Zen、Azure 与 OpenRouter,并没有点名自定义 baseURL 的 OpenAI 兼容网关。可做的判断只有实测:升级到 2.3.2 或更新版本后跑几步,在 QCode 控制台的用量明细里看第二步起是否出现缓存读取。出现就按缓存读取价计费,没出现就仍然按未缓存输入计费。

参考来源

OpenCode 官方 changelog(https://opencode.ai/changelog,v2.3.0 2026-11-13、v1.19.6 2026-11-17、v2.3.1 与 v2.3.2 2026-11-18);OpenCode 官方 providers 文档(https://opencode.ai/docs/providers,2026-11-19);OpenAI 官方定价页(https://developers.openai.com/api/docs/pricing)与 gpt-6.2-sol 模型页(2026-11-19);QCode 官方文档 OpenCode 接入页(docs.qcode.cc,中英两版);社区信息:CC Switch 4.0.35 的 release 说明(2026-11-18)与 V2EX 讨论(2026-11-14、2026-11-17)。以上均核对于 2026-11-19。

把 GPT-6.2 接进 OpenCode,缓存这件事自己核对

注册获取 QCode cr_ 密钥,在 opencode.json 里配好 openai provider 的端点,就能按 token 计费调用 gpt-6.2-sol 与 gpt-6.2-astra;各模型实时单价见 /models。

不确定从哪开始?

先试一周

小包 ¥26($30 额度,7 天)

每天都用

体验版 ¥63/月,每天 $5 额度;每 $1 额度只要 ¥0.42,中包约 ¥0.79