外接与兼容类问题

外接调用返回 403 block / 403 Forbidden

按顺序排查：

1. 确认令牌分组是否匹配当前模型类型
2. 确认 Base URL 是否带错 /v1（Claude 类不带，Codex 需要带）
3. 确认请求头中 User-Agent 是否缺失或填成了别的模型类型（不能把 Claude 的 UA 复用到 Codex）
4. 确认客户端是否真正将 Header 发出去了（部分客户端 UI 填了但实际没传）
5. 确认 Authorization 仍是 Bearer sk-*** 格式

User-Agent 怎么填？各场景示例

Claude 外接：

"User-Agent": "claude-cli/2.0.76 (external, cli)"

Codex 外接：

"User-Agent": "codex_cli_rs/0.77.0 (Windows 10.0.26100; x86_64) WindowsTerminal"

国产模型外接（使用浏览器型 UA）：

"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:149.0) Gecko/20100101 Firefox/149.0"

Base URL 到底要不要加 /v1？

• Claude 类接入（Anthropic Messages 协议）：https://你的请求地址（不带 /v1）
• Codex 类接入（OpenAI Responses 协议）：https://你的请求地址/v1（带 /v1）

最常见错误就是把 Claude 的地址误写成带 /v1，或把 Codex 的地址误写成不带 /v1。

外接前需要确认哪 5 项？

开始配置前必须对应好以下 5 项，任何一项对不上都可能导致 403 / 401 / 模型不可用：

• 分组：Key 属于哪个模型哪个分组
• 协议：客户端走 Anthropic Messages 还是 OpenAI Responses
• Base URL：Claude 类不带 /v1，Codex 类带 /v1
• 请求头：外接场景需要补对应 User-Agent
• 模型：有些分组允许留空，有些必须填写准确模型 ID

JetBrains IDE 里能看到插件，但调用报 401

优先检查：

1. IDE 是否读取到了旧的本地认证状态（OAuth 残留）
2. Key 是否已切到正确分组
3. 插件是否覆盖了本机 settings.json 配置

推荐做法：先用 CC Switch 在本机配好 Claude Code 或 Codex，确认 CLI 可用后，再在 IDE 中复用本机已有环境。

JetBrains / Trae 本机 CLI 可用但 IDE 不可用

问题不在 Key，在 IDE 侧配置。优先排查 IDE 是否读取了错误配置文件、没有带出请求头、或对本地代理/证书有额外限制。

Trae 中改了 Base URL 还是连不上

优先检查：

1. Claude / Codex 的 Base URL 是否写反（Claude 不带 /v1，Codex 带 /v1）
2. 插件是否允许保存完整自定义地址
3. 当前插件版本是否真的支持外接
4. 如果 Claude 正常 Codex 不正常，大概率是 Codex 的 /v1 没带上，或 model 仍填成了 Claude 模型名