Skip to content

外接调用 User-Agent 说明

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


什么时候需要看这页

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

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

如果缺少对应 User-Agent,常见报错包括:

  • 403 block
  • 403 Forbidden
  • Connection blocked

速查表

场景建议分组User-Agent 类型
Claude 外接max(外接)/ 特渠 / kiroClaude CLI UA
Codex 外接codex / codex-proCodex CLI UA

Claude 外接

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

推荐分组:max(外接)/ 特渠 / kiro

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

Codex 外接

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

推荐分组:codex / codex-pro

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

常见排查顺序

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

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

相关页面

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