<!-- Lazu · 网关没认出新版 OpenCode：各家 Agent 的 User-Agent 对照 · https://lazu.ai/zh/blog/coding-agent-user-agents -->

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

2026-11-02 · Lazu 团队

*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` 这类短名字会匹配到别的单词里，比如 optimi**zed**、de**cline**。
- **测试样本是编的。** 测试里有 `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`（[源码](https://github.com/QwenLM/qwen-code/blob/d9d6fc4a4b8e654d405dbb1d01bf3404e6435a1c/packages/core/src/core/anthropicContentGenerator/anthropicContentGenerator.ts#L476-L486)）。区分它和真正的 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 的真实请求在生产环境各发了一次，四个都记录对了。
