外接调用 User-Agent 说明

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

什么时候需要看这页

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

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

场景	分组	Base URL	`User-Agent` 类型
Claude 外接	`sale_kiro`	`https://www.vmvia.com`	Claude CLI UA
Codex 外接	`codex` / `codex-wending`	`https://www.vmvia.com/v1`	Codex CLI UA
国产模型外接	`国模`	`https://www.vmvia.com/v1`	浏览器型 UA

cc_max 分组只接受 Claude Code 客户端本身的请求，外接请改用 sale_kiro。完整分组说明见分组速查。

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

分组：sale_kiro

json

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

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

分组：codex / codex-wending

json

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

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

分组：国模

国产模型外接时，建议直接使用浏览器型 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，先按这个顺序检查：