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 与国产模型。
- 按 token 计费,实时单价见 /models
- 支付宝、微信支付、信用卡、加密货币均可付款
- 充值后自助开通、立刻生效
四个数字看懂这次缓存修复
修复所在的 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。
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。
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。
三个版本节点:从后台任务到缓存修复
OpenCode v2.3.0 把 subagent 改成默认后台运行,并把连续的 tool call 与思考折成一行活动摘要。
v1.19.6 让 OpenCode 1 提供升级到 OpenCode 2.0,安装包后台下载、由用户选择何时重启,会话与设置保留,但为 OpenCode 1 写的插件需要更新。
同日两个版本: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 可核对的有
- 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。
- 2v2.3.1 同日:超时 shell 转后台、timeout: 0 等于默认 120 秒、压缩摘要后台写(compaction.background: false 可关,未使用的摘要仍计 token)。
- 3OpenAI 官方标价:
gpt-6.2-sol输入 $2.00、缓存读取 $0.10、输出 $10.00;gpt-6.2-astra输入 $8.00、缓存读取 $0.40、输出 $40.00。 - 4QCode 的 OpenCode 接入文档:OpenAI 端点
https://api.qcode.cc/openai/v1,密钥经 /connect 保存。
常见误解与官方未公布的事项
changelog 没有说的两件事
- 1没有给出任何节省数字,只写了「从第二步起被缓存」,所以升级到 2.3.2 不等于账单会自动按固定比例下降
- 2没有点名自定义 baseURL 的 OpenAI 兼容网关,所以用 QCode 这类端点时要自己看用量明细,不能假定一定命中。官方尚未公布:OpenCode 是否会在用量界面直接标出缓存命中率;各网关侧的缓存保留策略。
继续留在旧版等确认 vs 先升级再按用量核对
继续用旧版,等别人先确认
system prompt 继续留在 instructions 里,每一步都按未缓存输入计费;prompt 与工具定义越长、会话步数越多,重复计费的部分越大。等待期间唯一确定的是账单结构没变。
先升到 2.3.2 以上,配好端点再核对
升级后 system prompt 变成开头一条 developer message,按 changelog,从第二步起应当可以走缓存读取价;再按自己的用量明细核对第二步起是否出现缓存读取,把「便宜了多少」交给实测而不是猜测。
从装好到能核对缓存的六步
- 1先确认版本:在终端跑 opencode
--version,低于 2.3.2 就升级;OpenCode 2 用 curl -fsSLhttps://opencode.ai/v2/install| bash 或 npm install -g @opencode/cli 安装,从 OpenCode 1 升级可先跑 opencode upgrade--major。 - 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在 OpenCode 里输入 /connect,选 OpenAI,选 Manually enter API Key,粘贴 QCode 的 cr_ 密钥;要同时用 Claude,就在 /connect 里选 Anthropic,端点按 QCode 的 OpenCode 文档填 anthropic provider 的地址(与 Claude Code 用的
https://api.qcode.cc/api不是同一条)。 - 4用 /models 选中 openai/
gpt-6.2-sol,跑几步真实任务,别只发一句话就下结论。 - 5打开 QCode 控制台的用量明细,看第二步起是否出现缓存读取;如果仍然全部按输入计费,先回头核对版本号和是不是真的走了 Responses 路由。
- 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。
相关阅读
按量包:不包月,7 天有效
一次购买额度、7 天内按需使用,支持个人套餐随时叠加加油包,各模型单价见 /models。
OpenCode Go 额度 2026:$10,Plus $40
OpenCode Go $10/月、Go Plus $40/月、Go Teams 每位成员 $20/月;额度按模型的月度美元额度计,5 小时 20%、每周 50%。
GPT-6.2 Sol 对比 GPT-6.2 Astra:官方价格、基准评测与 Codex 选型(2026-11)
逐项对照 OpenAI 2026-11-17 发布的 gpt-6.2-sol($2/$10)与 gpt-6.2-astra($8/$40):1,050,000 上下文、知识截止日、FrontierCode 2.0、AA-3D、>272K 长上下文计费、reasoning_effort 限制及 QCode 接入写法。
加密货币充值指南
9 种币、56 条网络,0 平台手续费购买 AI 编程 API 额度。
QCode.cc 是独立的 API 接入服务,与 OpenAI、Anthropic 等模型厂商无隶属关系,也未获其背书。文中版本变化与行为描述以 OpenCode 官方 changelog 为准,所有美元数字均为 OpenAI 官方 API 标价;QCode 的在售型号与实时单价以 qcode.cc/models 为准。