CodexSwitch 提供商标准
更新时间：2026-04-01 用途：定义
CodexSwitch当前支持和推荐的提供商配置标准
先说结论
CodexSwitch 里的提供商不应该只是“随便填一个 base URL”。
从产品上，更合理的理解是：
- 官方是一份默认配置模板
- 中转是一份从默认模板派生出来的配置模板
- 第三方兼容端是一份带预设规则的配置模板
另外要区分：
provider_name- UI 展示名
provider_key- 客户端配置里真正使用的协议 key
建议至少按 3 层理解：
- 官方
- OpenAI
- Anthropic
- 官方兼容
- Kimi 的 OpenAI 兼容地址
- 智谱的 OpenAI / Claude 兼容地址
- Relay / Custom
- 你自己的中转
- 第三方网关
当前标准模板
1. OpenAI 官方
- 客户端：
Codex - 模式：
Official - Provider Key：
OpenAI - Base URL：
https://api.openai.com/v1 - 协议：
responses
2. Anthropic 官方
- 客户端：
Claude - 模式：
Official - Provider Key：
Anthropic - Base URL：
https://api.anthropic.com - 协议：
responses
3. Kimi（Moonshot）
Codex 方向
- 客户端：
Codex - 模式：
Relay / Custom - Provider Key：
OpenAI - Base URL：
https://api.moonshot.cn/v1 - 协议：
chat
说明：
- Moonshot 官方文档明确提供了 OpenAI 兼容接入方式。
4. 智谱（Zhipu）
Codex 方向
- 客户端：
Codex - 模式：
Relay / Custom - Provider Key：
OpenAI - Base URL：
https://open.bigmodel.cn/api/coding/paas/v4 - 协议：
chat
Claude 方向
- 客户端：
Claude - 模式：
Relay / Custom - Provider Key：
Anthropic - Base URL：
https://open.bigmodel.cn/api/anthropic - 协议：
responses
说明：
- 智谱官方文档和 FAQ 已明确给出 Coding Plan / Claude Code 兼容地址。
推荐规则
1. 默认优先提供“文件模板 profile”
无论官方还是第三方，都先定义成一套 profile 文件：
- 目标文件模板
- 默认变量
- 必填字段说明
- 兼容协议说明
这样用户更容易理解：
- 这个配置会改哪些文件
- 哪些值必须填写
- 保存之后切换的到底是什么
2. Runtime Override 作为兼容路径保留
如果某个客户端还没有稳定文件模型，再退到：
Runtime Override
但它不应该反过来成为主心智。
3. 第三方需要写明兼容协议
不能只写名称，至少要说明：
- OpenAI 兼容
- Anthropic 兼容
chat还是responses
当前已落进界面的预设
- OpenAI 官方 / Codex
- Anthropic 官方 / Claude
- Kimi / Codex
- 智谱 Coding / Codex
- 智谱 / Claude
GUI 中应如何呈现
在界面上，每种提供商预设应该体现成：
模板名称客户端模式兼容协议会影响的文件需要填写的字段
例如：
OpenAI 官方 / Codex- 文件：
config.toml、auth.json - 必填：
OPENAI_API_KEY
- 文件：
Aimizy Relay / Codex- 文件：
config.toml、auth.json - 预填：
base_url - 必填：
OPENAI_API_KEY
- 文件：