Agent 客户端接入
通过 CC Switch 在 Codex CLI 中使用 PixMind
使用 CC Switch 本地路由将 Codex Responses 请求转换为 PixMind Chat Completions。
Codex CLI 不能原生直连 PixMind Chat Completions,但可以通过 CC Switch 3.17.0+ 的本地路由使用 PixMind。
为什么不能共用同一个 Base URL
两种协议的请求结构、工具调用事件和流式响应格式不同:
- PixMind 当前端点:
POST /api-platform/v1/chat/completions - Codex CLI 自定义供应商需要:Responses-compatible endpoint
仅修改 URL 或把 wire_api 写成 responses 不会自动转换协议。这样配置通常会返回 404、请求结构错误或无法解析工具调用。
1. 添加 PixMind 供应商
在 CC Switch 的 Codex 页面添加自定义供应商:
- Provider Name:
PixMind - API Endpoint:
https://aihub-admin.aimix.pro/api-platform/v1 - API Key:你的 PixMind API Key
- API Format:
OpenAI Chat Completions (Requires routing) - Model:建议先使用
gpt-5.6-terra
2. 开启本地路由
进入 Settings → Routing → Local Routing:
- 开启 Local Routing 主开关。
- 在 Routing Enabled 中开启
Codex。 - 切换到 PixMind 供应商。
- 重启 Codex,使
config.toml和模型目录重新加载。
CC Switch 会完成以下转换:
Codex Responses
→ CC Switch Local Route
→ PixMind Chat Completions
→ CC Switch Local Route
→ Codex Responses3. 模型映射
可将 Codex 默认模型映射到 PixMind 已开放的任意 LLM,例如:
gpt-5.6-sol:复杂工程与旗舰推理gpt-5.6-terra:日常开发默认选择gpt-5.6-luna:快速编辑与轻量任务claude-sonnet-5:均衡编码与工具调用gemini-3.5-flash:多模态与快速处理
如果返回 404 或流式事件无法解析,确认 API Format 选择的是 Chat Completions,并且 Local Routing 与 Codex takeover 都已开启。