网关没认出新版 OpenCode:各家 Agent 的 User-Agent 对照

Molly 整理 · Lazu 团队
先说结论:Lazu 会给每条请求标上「是哪个工具发来的」,比如 Claude Code、Codex、OpenCode。2026 年 10 月 29 日我们发现,其中几条识别规则和这些工具现在发出的格式对不上。新版 OpenCode 换了 User-Agent 格式之后,Gemini CLI 从规则上线起,还有在 Kilo 里选 Claude 模型时,发来的请求都被记成了「未识别」。
根因很简单:规则是照着我们以为的 User-Agent 写的,测试样本也是自己编的,没有拿各家工具真正发出的字符串核对过。10 月 30 日的 v0.7.260 修好了这个问题,历史数据也补了标记。
这篇讲问题出在哪、我们怎么修,最后附一张各家 Agent 真实 User-Agent 的对照表。自己做网关、做中转或者做用量统计的人,可以直接拿去用。
网关怎么认出是哪个 Agent #
请求里能用来识别的信息有三处:
User-Agent请求头,大多数工具会在这里写上自己的名字和版本;- 个别工具专用的请求头,比如 Codex 的
originator、Claude Code 的x-app; - 会话 ID 所在的请求头,各家不一样,比如 Goose 用
agent-session-id。
Lazu 的做法是拿 User-Agent 按顺序匹配一张正则表,匹配到的第一条就是结果。控制台里的「常用客户端」、按 Agent 统计的会话花费、每周用量摘要,用的都是这个结果。
出了什么问题 #
我们对照了各家工具的源码,看它们发给第三方接口的 User-Agent 到底是什么:
| 工具 | 实际发出的 User-Agent | 我们原来的规则 | 结果 |
|---|---|---|---|
| OpenCode(新版) | opencode/latest/1.19.5/cli … |
opencode/ 后面紧跟版本号 |
老版本 opencode/1.4.2 能认出;新版中间多了一段 latest/,匹配失败 |
| Gemini CLI | GeminiCLI-tui/0.66.0/gemini-2.5-pro (…) |
GeminiCLI/ |
多了 -tui,匹配失败 |
| Kilo Code(选 Claude 模型时) | kilo/<渠道>/<版本>/cli … |
只认 Kilo-Code/ |
选其他模型时能认出,选 Claude 时认不出 |
| Roo Code(原生 OpenAI 接口) | roo-code/3.45.0 (…) |
只认 RooCode/ |
匹配失败 |
另外还有两个问题:
- 规则没加词边界。
Zed、Cline这类短名字会匹配到别的单词里,比如 optimized、decline。 - 测试样本是编的。 测试里有
Cursor/0.42.0 (mac)这样的字符串,它不是从任何真实请求里取来的。测试一直是绿的,因为它测的是我们的想象。
影响有多大 #
我们用新规则重新识别了近 60 天的请求,只有约 0.2% 的请求标记会变,新认出的 Agent 请求只有一百多条。影响小,原因有两个:
- 这段时间用 OpenCode、Gemini CLI 接 Lazu 的人本来就少;
- 大部分「未识别」的流量根本不是 Agent,而是用户自己的脚本:
python-httpx、OpenAI Python SDK、curl。这部分认不出是对的。
钱一分没有算错:识别结果只影响统计和展示,不影响计费。
怎么修的 #
- 规则全部改成对照源码核对过的真实字符串,加上锚点和词边界。测试样本也全部换成真实字符串,编造的样本都删了。
- User-Agent 认不出时,看两个通用请求头。 Roo Code、pi 等工具会发
originator,Cherry Studio 等会发X-Title。这两个头只认核对过会发它们的工具,避免任意请求头刷出无数个「客户端」。 - 用会话 ID 兜底。 请求头里有 Goose、Kilo、OpenCode 的会话 ID,但 User-Agent 只是 SDK 名的,按会话来源标记。Goose 完全不发 User-Agent,这是认出它的唯一办法。
- 统计页、徽章和每周摘要改用同一张表。 原来每周摘要另有一份只有 9 个名字的名单,其余工具都被记成「API」。
v0.7.260 在 10 月 30 日上线,v0.7.261 修了个别版本号显示,v0.7.262 又补上了 OpenHands、Kode 等工具。60 天内的历史请求也按新规则补了标记,各小时的用量合计没有变化。
有些工具,网关怎么改都认不出 #
下面这些工具向第三方接口发请求时,不带自己的名字:
| 工具 | 发出的 User-Agent |
|---|---|
| Goose | 完全不发 User-Agent |
| Cline v4 | 只有 Vercel AI SDK 的默认值,不带 Cline |
| Continue | OpenAI/JS … 或 node-fetch,没有自报名 |
| Aider | 经过 litellm,只能看到 litellm/… 或 OpenAI/Python |
| Kimi CLI、OpenClaw | 接自定义地址时只发 SDK 默认值 |
还有一个容易混淆的:Qwen Code 接 Anthropic 格式的第三方接口时,会把 User-Agent 写成 claude-cli,并带上 x-app: cli。它的源码注释给了原因:有些中转按客户端身份限制使用,这样写才能通过;直连 Anthropic 官方时,它仍然写 QwenCode(源码)。区分它和真正的 Claude Code,要看版本号:Claude Code 现在是 2.x,Qwen Code 写的是它自己的 0.x 版本号。
如果你在用这些工具,又希望用量统计里能分清,可以在工具的自定义请求头里加一个 X-Title: 工具名。
附:各家 Agent 的 User-Agent 对照表 #
2026 年 10 月从各工具源码核对,版本号只是示例:
| 工具 | 发给第三方接口的 User-Agent 和请求头 |
|---|---|
| Claude Code | claude-cli/2.1.x (external, cli),请求头 x-app: cli、X-Claude-Code-Session-Id |
| Codex | codex_cli_rs/…、codex_exec/… 或 codex-tui/…,请求头 originator |
| OpenCode | opencode/<渠道>/<版本>/cli,请求头 x-opencode-session-id |
| Kilo Code | 选 Claude:kilo/<渠道>/<版本>/cli;选其他:Kilo-Code/<版本> |
| Gemini CLI | GeminiCLI-tui/<版本>/<模型> (…);VS Code 里是 CloudCodeVSCode/… |
| Qwen Code | OpenAI 接口:QwenCode/<版本>;Anthropic 格式的第三方接口:claude-cli/<Qwen Code 版本> (external, cli),请求头 x-app: cli |
| Crush | Charm-Crush/<版本>,请求头 x-session-id |
| Zed | Zed/<版本> (macos; aarch64) |
| GitHub Copilot(自带 Key) | GitHubCopilotChat/<版本> |
| Cherry Studio v1 | Electron 的 UA 里含 CherryStudio/<版本>,并发 X-Title: Cherry Studio |
| Goose | 不发 User-Agent,请求头 agent-session-id |
常见问题 #
识别错了会多扣钱吗? #
不会。识别结果只用于统计和展示,计费按模型和 token 算,跟哪个工具发来的无关。
为什么不直接让用户自己选工具? #
可以选,但大多数人不会去选。按请求自动识别,统计才是准的;认不出时,你可以加 X-Title 请求头告诉我们。
怎么确认这次真的修好了? #
测试样本现在全部是从源码核对过的真实字符串。上线后,我们又用 OpenCode、Goose、Gemini CLI 和 Cherry Studio 的真实请求在生产环境各发了一次,四个都记录对了。