跳到主要内容

外接调用 User-Agent 说明

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

什么时候需要看这页​

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

  1. 令牌分组是否选对
  2. 请求头里的User-Agent是否带对

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

  • 403 block
  • 403 Forbidden
  • Connection blocked

速查表​

场景建议分组User-Agent类型
Claude 外接defaultClaude CLI UA
Codex 外接codex0.3Codex CLI UA

Claude 外接​

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

推荐分组：default

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

Codex 外接​

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

推荐分组：codex0.3

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

常见排查顺序​

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

  1. 确认令牌分组是否和接入类型匹配
  2. 确认请求头里是否真的带上了User-Agent
  3. 确认没有把 Claude 的 UA 复用到 Codex，或把 Codex 的 UA 复用到 Claude
  4. 确认Authorization仍是Bearer sk-xxx格式

相关页面​

页面说明
CC Switch 统一配置渠道、模型与常规配置流程
Codex CLI 配置参考Codex 外接、手动配置与排障