外接调用 User-Agent 说明

本页只聚焦 User-Agent 规则。外接兼容的完整接入顺序、分组选择、Base URL 和客户端分类说明见外接兼容与接入说明。

什么时候需要看这页

只要你不是走工具的官方默认链路，而是通过中转站把模型接到其他客户端，就需要同时确认两件事：

如果缺少对应 User-Agent，常见报错包括：

完整 21 个分组的对应关系见首页「令牌分组速查」。

适用于 Claude Code 外接、Anthropic Messages 协议接入，以及其他 Claude 兼容调用场景。

推荐分组：vip_1_ext / vip_1_max_ext / free_2*

json

"headers": {
  "Authorization": "Bearer sk-xxx",
  "User-Agent": "claude-cli/2.0.76 (external, cli)"
}

适用于 Codex CLI 外接、OpenAI Responses 协议接入，以及其他 Codex 兼容调用场景。

推荐分组：vip_2

json

"headers": {
  "Authorization": "Bearer sk-xxx",
  "User-Agent": "codex_cli_rs/0.77.0 (Windows 10.0.26100; x86_64) WindowsTerminal"
}

适用于国产模型分组通过 OpenClaw、第三方平台、网关、自定义客户端等方式外接调用的场景。

推荐分组：vip_4 / vip_4_ds*

国产模型外接时，建议直接使用浏览器型 User-Agent：

json

"headers": {
  "Authorization": "Bearer sk-xxx",
  "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:149.0) Gecko/20100101 Firefox/149.0"
}

如果外接请求返回 403，先按这个顺序检查：