Path 03

Codex CLI 兼容 convertmodel

你可以保留 Codex CLI 的工作流，只把 provider 换成 convertmodel。这样 CLI 不变，网关统一。

OpenAI compatible
CLI workflow preserved
适合已有 Codex 用户

安装 CLI

  1. 安装 Node.js 18+。
  2. 执行 npm install -g @openai/codex@latest。
  3. 首次运行 Codex，确认本地配置目录已经生成。
npm install -g @openai/codex@latest
官方入口： Codex CLI 的安装说明以 OpenAI 官方帮助文档为准；这里保留的是 convertmodel provider 的接入方式。

写入认证和 provider

最少需要两份配置：认证文件和 provider 配置。把 convertmodel 作为一个 OpenAI 兼容 provider 加进去。

auth.json
{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

config.toml
model_provider = "convertmodel"
model = "gpt-5.4"
model_reasoning_effort = "low"

[model_providers.convertmodel]
name = "convertmodel"
base_url = "https://convertmodel.net"
wire_api = "responses"
requires_openai_auth = true

什么时候你应该继续用 Codex，而不是切回 Claude Code

  • 你已经把脚本、习惯和自动化流程围绕 Codex CLI 搭好了。
  • 你更看重统一的 OpenAI 兼容 provider 配置方式。
  • 你不想额外维护一套 Claude Code 的本地工作流。

最常见的误区

误把 Anthropic key 填到 Codex Codex CLI 这一页讲的是 OpenAI 兼容链路，key 类型和 Claude Code 直连页不同。
模型名写死为官方默认 具体要用哪个模型名，以 convertmodel 当前公开的 OpenAI 兼容模型名为准。
把 Codex 和 Claude Code 当同一套配置 两者是两个客户端，配置文件路径、协议和 provider 结构都不同。