---
title: "OpenCode 2 很好，但用不了 Claude？"
description: "同一账号、同一段对话，短请求能过，带工具的主请求返回 400 Third-party apps now draw from extra usage。我们抓了真实请求做复现，触发点落在系统提示末尾的环境模板上。"
url: https://codingpass.ai/zh/blog/opencode-claude-third-party-400
language: zh-CN
updated: 2026-11-13
---
# OpenCode 2 很好，但用不了 Claude？

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

[CodingPass 团队](https://codingpass.ai/zh/about) 发布于 2026年11月13日 更新于 2026年11月13日 阅读约 7 分钟

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

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

[![](https://codingpass.ai/assets/img/blog/opencode-claude-third-party-400/opencode-2-video-cover.webp) X · @CamilleRoux TUI, web et desktop sur un même service local 在 X 上观看](https://x.com/CamilleRoux/status/2109675661866451333)

*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](https://codingpass.ai/assets/img/blog/opencode-claude-third-party-400/opencode-2-code-mode.webp)

*Code Mode：一段脚本连调 GitHub 和 Linear，直接返回新建的 issue 编号。图：[OpenCode 2.0 发布说明](https://anoma.ly/notes/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 走订阅登录，客户端和上游之间加一层记录代理，随手发一句日常提问。代理一共抓到四个连续请求：

| 请求 | 请求体 | 结果 |
| --- | --- | --- |
| 生成会话标题 | 2.3 KB，不带工具 | 200 |
| 主请求 | 47 KB，四段系统提示、13 个工具 | 400 |
| 重试标题请求 | 2.3 KB | 200 |
| 重试主请求 | 47 KB | 400 |

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

| 改动 | 结果 |
| --- | --- |
| 原样发送 | 400 |
| 删掉整个 `system` | 200 |
| 删掉全部 `tools`，保留 `system` | 400 |
| `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 的讨论帖](https://github.com/mnfst/manifest/issues/2306)里，有人贴出抓包对比，指出上游是在看系统提示做过滤；Claude Code 自己的仓库和 pi 的 issue 区也有人报同样的错。

## 三条出路

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

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

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

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

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

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

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

作者 CodingPass 团队

CodingPass 由我们运营。每篇指南发布前，都会在对应工具的最新稳定版上实测一遍。发现内容过时了？写信到 [support@codingpass.ai](mailto:support@codingpass.ai)。

## 相关阅读。

指南

### [OpenCode 接入指南](https://codingpass.ai/zh/tools/opencode)

opencode.json 的 provider 配置、各档位的模型 ID，以及常见报错怎么查。

规则

### [额度和上限怎么算](https://codingpass.ai/zh/usage-limits)

每个套餐、每个模型的额度和上限，以及 429 响应。

模型

### [全部模型](https://codingpass.ai/zh/models)

每个模型的 ID、所需档位和月度额度。
