网关没认出新版 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。这部分认不出是对的。

钱一分没有算错:识别结果只影响统计和展示,不影响计费。

怎么修的 #

  1. 规则全部改成对照源码核对过的真实字符串,加上锚点和词边界。测试样本也全部换成真实字符串,编造的样本都删了。
  2. User-Agent 认不出时,看两个通用请求头。 Roo Code、pi 等工具会发 originator,Cherry Studio 等会发 X-Title。这两个头只认核对过会发它们的工具,避免任意请求头刷出无数个「客户端」。
  3. 用会话 ID 兜底。 请求头里有 Goose、Kilo、OpenCode 的会话 ID,但 User-Agent 只是 SDK 名的,按会话来源标记。Goose 完全不发 User-Agent,这是认出它的唯一办法。
  4. 统计页、徽章和每周摘要改用同一张表。 原来每周摘要另有一份只有 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 的真实请求在生产环境各发了一次,四个都记录对了。

相关文章
2026-10-21GPT-6.1 Sol 和 GPT-6 Sol 有什么区别:同价,缓存读取便宜一半 2026-10-01便宜的 Claude API 为什么一句 hi 算 6477 token?逆向和官方 API 的区别 2026-09-30大模型 API 价格对比:Claude、GPT、Gemini、DeepSeek 怎么选

拿一个 Key 试试

免费开始