登录选套餐
博客 · 接入指南

OpenCode 2 很好,但用不了 Claude?

OpenCode 2 把整个 CLI 推倒重写,终端、网页、桌面共用一套服务,用起来确实更顺。可接 Claude 订阅的人,最近都在问同一条 400,而且时好时坏。

十月中旬,OpenCode 2 正式发布。官方没把它当成一次常规的版本号递增,而是把底层架构推倒重写了一遍。

最核心的改动是把多端收拢成一个共享后台服务。1.x 时代,终端 UI、网页端和桌面客户端各跑各的进程,会话是割裂的。到了 2.0,每台机器只起一个本地服务,终端、网页、桌面都作为客户端连上去。

X · @CamilleRouxTUI, web et desktop sur un même service local在 X 上观看
5 秒的 OpenCode 2.0 终端实录:改一个折扣计算的 bug,再跑测试;帖子里列了终端、网页、桌面共用一个本地服务,JS 脚本走新 API 控制 agent,挂上百个 MCP 也不撑爆上下文。封面是视频截帧;链接会打开 X,点击之前页面不会从 X 加载任何内容。

写自动化脚本可以用 @opencode/client 直接连这个后台,定时任务走 opencode api 也是同一个入口。需要跨设备接力时,opencode pair 把本地服务暴露出去,不用再折腾端口转发。

另一个改动是默认开启的 Code Mode。以前挂的 MCP server 一多,几十个工具的 JSON schema 一股脑塞进上下文,既占窗口又容易让模型调错。2.0 把它们统一包成可直接调用的 JavaScript 函数,模型要连调好几个工具时,写一小段脚本在沙箱里一次跑完,不用一轮一轮往返。

OpenCode 2.0 Code Mode 示意图:用户要求“把 GitHub 上的 bug 建到 Linear”,会话里只执行一段代码,脚本里依次调用 tools.github.list_issues 和 tools.linear.save_issue;右侧是 github、linear、sentry 三个 MCP server
Code Mode:一段脚本连调 GitHub 和 Linear,直接返回新建的 issue 编号。图:OpenCode 2.0 发布说明

升级机制也变了。从 1.19.0 开始,客户端去掉了静默自动更新,必须手动执行 /update 或者 opencode upgrade --major 才会跨到 2.0。插件 API 和服务端接口全换了新设计,1.x 的老插件升上去直接失效,得按新接口重写。把升级决定权交回用户,至少不会在早上赶工时突然把环境搞挂。

用下来,响应速度和多端切换比 1.x 顺手。但不少人在升完级、继续用 Claude 订阅登录干活时,开始频繁撞上一条 400。

从查请求头到查请求体

报错的内容很短:

400 Third-party apps now draw from extra usage, not plan limits.Ask your workspace admin to add more and keep going.

如果今年一直拿 Claude 订阅接外部工具,对这句话应该不陌生。过去半年,Anthropic 对订阅额度的外流做过几轮收紧。

4 月 4 日是第一刀。那天起,第三方客户端的调用从 Pro 和 Max 的套餐额度里剥离了出去。套餐额度只留给 Claude.ai、官方的 Claude Code 和 Cowork;其他工具还能登进去,但流量要按 API 原价从 extra usage(预付费余额)里扣。账户没开 extra usage,或者余额是零,请求就被拦下,吐出上面那条 400。

“Starting tomorrow at 12pm PT, Claude subscriptions will no longer cover usage on third-party tools like OpenClaw. You can still use these tools with your Claude login via extra usage bundles, or with a Claude API key.”

Claude Code 的作者 Boris Cherny,当天在 Threads 上写的。

6 月 15 日,官方原本打算把 Agent SDK 和 claude -p 的调用也切进月度 credit 池,改动在当天被暂缓。于是留下一个中间状态:走真 Claude Code 那条通道,调用还算进套餐额度;被判定成其他第三方客户端,就得走 extra usage。

让 OpenCode 用户头疼的是判定方式。社区里的抓包对比显示,上游不只看 User-Agent 和请求头,还会看请求里的系统提示。

症状因此时好时坏。上游不是在入口处一刀切封账号,而是逐条看请求里装了什么。真是额度用完或者凭证失效,所有请求都会失败,不会前一个刚拿到 200,后一个就要你开 extra usage。

抓包复现与拆解

11 月 12 日,我们这边两个站点先后收到同样的告警。两边的网关日志是一个样子:同一段对话、同一个账号,短请求放行,主请求(一边 24 KB,一边 40 KB)撞上这条 400。

本地复现更干净:OpenCode 2.2.7 走订阅登录,客户端和上游之间加一层记录代理,随手发一句日常提问。代理一共抓到四个连续请求:

OpenCode 2.2.7 一次提问发出的请求
请求请求体结果
生成会话标题2.3 KB,不带工具200
主请求47 KB,四段系统提示、13 个工具400
重试标题请求2.3 KB200
重试主请求47 KB400

然后固定同一个账号和模型,把这个 47 KB 的主请求一段一段往外摘内容,看上游什么时候放行:

对 47 KB 主请求做分段删减后的返回状态码
改动结果
原样发送400
删掉整个 system200
删掉全部 tools,保留 system400
system 只留 1.4 KB 的基础主提示200
system 只留 23.8 KB 的 Code Mode 那一段400
保留 Code Mode,去掉末尾的环境块200
末尾环境块保留 160 / 180 / 220 字符200
末尾环境块保留 240 字符400
换成 1000 个 x 或 240 字符普通英文200

范围缩得很窄。跟请求体多大没关系,跟挂了多少工具也没关系,触发点落在系统提示最末尾那段“今天日期 + 运行环境”的模板上。它也不是关键词黑名单:换成 1000 个 x 或者同样长度的日常英文,照样 200;保留原有结构,实测 220 字符能过、240 字符被拦,中间那一段没再细分。

这也解释了标题请求为什么每次都成:那个请求的 system 只有一段摘要指令,没有末尾的运行环境块。只有主对话请求会把工作目录、系统平台和当天日期拼进去。

社区里排查这个问题的人得出了相同结论。Manifest 的讨论帖里,有人贴出抓包对比,指出上游是在看系统提示做过滤;Claude Code 自己的仓库和 pi 的 issue 区也有人报同样的错。

三条出路

撞上之后先别急着改配置,花一分钟分清是哪一种:

  • 只有带工具的主请求报错,小请求正常,就是上面这条,请求被认成了第三方。
  • 所有请求都报错,或者提示里提到 login、额度耗尽,先去 claude.ai/settings/usage 看账户状态,跟这条不是一回事。
  • 换一个全新账号、只用官方 Claude Code 手动跑也报错,那是账号或网络环境被标记了,客户端这边调不回来。

排除账号问题之后,能选的其实就三条,挑一条你能长期忍的。

最省心的是换成官方 API key。请求走标准接口,没有“你算哪个客户端”这回事;缺点是包月折扣没了,用多少按 token 原价算,写代码这种跑法,账单也会跑得挺快。

舍不得订阅价,就在 Claude 后台把 extra usage 打开、充点钱。请求不再被拦,但被认成第三方的流量按 API 原价从余额扣,等于一份订阅加一份按量,两头付钱。

第三条是找个在转发层做过兼容的网关,客户端不用改,也不用自己盯着上游规则抓包调试。麻烦在于这套判定会变,网关得一直跟着维护。CodingPass 走的就是这条,接上来就能避开这条 400,模型调用和限额还是按套餐的美元额度算。

最后留一句提醒:上游用的是一套动态调整的分类器,不是写死在文档里的公开协议,今天卡在两百多字符的环境块,明天可能换成别的特征。想接着用 OpenCode 2,照着 OpenCode 接入指南 把 baseURL 指向 CodingPass 就行。如果走 CodingPass 的请求还是报错,错误码说明 里列了网关会返回的每种状态码和处理办法。

出发

换供应商,不用换工具。

OpenCode 2 照用。把 Base URL 换成 CodingPass,这条 400 由我们处理,按量计费,随时取消。

  • 每个响应都带请求 ID
  • 用量不超过 5% 可全额退款
  • 不会意外扣费
选 GoOpenCode 指南

每月 $10,直到你取消。