在 Codex 桌面客户端中通过 连连智枢 网关进行 AI 编程。

Codex 是 OpenAI 官方的桌面端 AI 编程 Agent。将自定义 model provider 指向 连连智枢 的 OpenAI 兼容（含 Responses API）端点后，可使用控制台 Key 与统一模型目录。

前提条件

安装 Codex

从 OpenAI Codex 页面 下载并安装 Codex 桌面客户端。

配置 连连智枢 API

步骤 1 — 编辑配置文件

打开用户级配置 ~/.codex/config.toml（勿在仓库内 .codex/config.toml 写入 Key；项目级配置不能覆盖 model_providers）。

将 YOUR_MODEL_ID、YOUR_ROUTERBRAIN_KEY 替换为实际值：

model = "YOUR_MODEL_ID"
model_provider = "routerbrain"

[model_providers.routerbrain]
name = "RouterBrain"
base_url = "https://51kik.com/v1"
experimental_bearer_token = "YOUR_ROUTERBRAIN_KEY"
wire_api = "responses"

说明：

字段值
model模型目录 id
base_urlOpenAI 兼容根地址，须含 /v1
wire_api连连智枢 支持 OpenAI Responses API（/v1/responses），Codex 默认走此协议
experimental_bearer_token控制台推理 Key

安全提示

也可改用环境变量，避免 Key 明文写入磁盘：

export ROUTERBRAIN_API_KEY="YOUR_ROUTERBRAIN_KEY"

并将 provider 改为：

env_key = "ROUTERBRAIN_API_KEY"

删除 experimental_bearer_token 行。

若仅 Chat Completions 可用而 Responses 报错，可尝试 wire_api = "chat"（取决于 Codex 版本与网关能力，见 Chat Completions）。

步骤 2 — 重启 Codex

保存配置后完全退出并重启 Codex，即可在 Agent 中使用所选模型。

配置模型能力目录（可选）

Codex 可通过自定义模型目录声明 reasoning、多模态、工具等能力。配置完成后，在 Codex CLI 输入 /model 可看到模型及 reasoning 选项。

在 ~/.codex/config.toml 中增加：

model_catalog_json = "~/.codex/model-catalogs/routerbrain-catalog.json"

新建 ~/.codex/model-catalogs/routerbrain-catalog.json（将 YOUR_MODEL_ID 换为目录 id，并按模型实际能力调整字段）：

{
  "models": [
    {
      "slug": "YOUR_MODEL_ID",
      "display_name": "RouterBrain Model",
      "description": "RouterBrain gateway model",
      "default_reasoning_level": "none",
      "supported_reasoning_levels": [
        { "effort": "none", "description": "Off" },
        { "effort": "high", "description": "On" }
      ],
      "shell_type": "shell_command",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 0,
      "base_instructions": "You are Codex, a coding agent routed through RouterBrain.",
      "supports_reasoning_summaries": false,
      "default_reasoning_summary": "none",
      "support_verbosity": false,
      "truncation_policy": { "mode": "bytes", "limit": 10000 },
      "supports_parallel_tool_calls": true,
      "experimental_supported_tools": [],
      "input_modalities": ["text"]
    }
  ]
}

常用字段：

  • slug / display_name：须与 config.toml 中 model 及 API 请求的模型名一致。
  • supported_reasoning_levels：模型支持 reasoning 时再开启；不支持则保持 none 且 supports_reasoning_summaries: false。
  • input_modalities：模型支持 vision 时可设为 ["text", "image"]。
  • supports_parallel_tool_calls：声明是否支持并行工具调用。

修改后重启 Codex 使目录生效。

验证

  1. 在 Codex CLI 输入 /model，确认列表中出现配置的模型。
  2. 发起一条简单编程任务；401 / 403 见 错误响应。
  3. 也可先用 curl 验证（见 首次请求）。

配置摘要

项值
配置文件~/.codex/config.toml
Providerrouterbrain
Base URLhttps://51kik.com/v1
API Key控制台推理 Key
模型目录 id

相关