Skip to main content
Codex 通过 config.toml 支持自定义模型提供商。这样你可以将 Codex 请求路由到 Phaseo,同时继续使用原有的 CLI、应用或 IDE 工作流。 如果还希望 Codex 在工作时读取最新的 Phaseo 文档,请同时添加 Docs MCP 服务器。
除了配置提供商,还需要可复用的智能体设置帮助?从 phaseoteam/skills 安装 Phaseo 公共 skills:

使用 Phaseo CLI 设置

请先安装 Codex 官方版本。设置过程会创建一个永不过期的 Phaseo CLI: Codex API Key,将其保存到操作系统凭据库,并写入专用的 Phaseo 配置档案。Codex 通过 CLI 助手读取密钥,因此不会将明文密钥写入 config.toml。

使用以下命令启动 Codex:

同一 Phaseo CLI 工作流也可启动 Cline、Kilo Code、oh-my-pi、Muse Code 和 MiniMax Code,并使用隔离的临时提供商配置。

手动配置

创建或更新用户配置文件 ~/.codex/config.toml。对于可信项目,也可以将相同设置放在仓库中的 .codex/config.toml。
Codex 当前通过 Responses 协议连接自定义提供商。请保留 wire_api = "responses",或省略此项以使用默认值。 Codex App 和 IDE 扩展共用相同的配置层。在 IDE 扩展中,可通过 Codex Settings > Open config.toml 打开配置文件。

验证

  • 启动前,请在模型中确认模型 ID 存在。
  • Codex 默认工作流请使用 Responses。

故障排查

  • 401 Unauthorized:运行 phaseo whoami,然后重新运行 phaseo codex。
  • model_not_found:从模型获取当前 ID 并更新 model。
  • 提供商特有问题:查看路由与回退了解故障转移行为。
最后修改于 2026年10月2日