PixMind Docs
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

  1. 开启 Local Routing 主开关。
  2. 在 Routing Enabled 中开启 Codex
  3. 切换到 PixMind 供应商。
  4. 重启 Codex,使 config.toml 和模型目录重新加载。

CC Switch 会完成以下转换:

Codex Responses
  → CC Switch Local Route
  → PixMind Chat Completions
  → CC Switch Local Route
  → Codex Responses

3. 模型映射

可将 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 都已开启。

On this page