Codex 自定义提供商和模型

简介

Codex 是 OpenAI 推出的 AI 编程代理（Coding Agent），开发者可以直接在本地终端与 AI 交互完成代码编写、重构、修复 Bug、生成测试等任务。

在实际环境中，可以通过 Codex 客户端、Codex CLI、IDE 插件等方式来使用 Codex。本文以 Codex CLI 为例进行展开。

环境

这里使用 npm 来安装，先配置 Node.js 环境。

Node.js

建议版本 22 或以上。

如果已安装，不确定版本是多少，可以通过 node -v 命令来查看。

如果没有安装 Node.js，无论是 Windows，还是 macOS、Linux，都可以通过 Volta 来安装和管理。

Codex

执行下面的命令安装：

npm install -g @openai/codex

安装完成后，可以执行下面的命令验证：

codex --version

安装成功的情况下，会输出版本号。

配置文件

直接修改配置文件，配置自定义提供商和模型。

路径

Codex 的配置文件一般保存在用户目录中。

macOS 和 Linux

macOS 和 Linux 的配置文件路径为 ~/.codex/

Windows

Windows 的配置文件路径为 C:\Users\<用户名>\.codex\

内容

如果 auth.json 和 config.toml 文件不存在，需要手动创建：

auth.json

用于保存密钥，文件内容如下：

{
  "OPENAI_API_KEY": "<your-api-key>"
}

填入 API Key 后，保存。

config.toml

用于保存模型等配置，文件内容如下：

model_provider = "custom"
model = "<your-model>"
model_reasoning_effort = "xhigh"
preferred_auth_method = "apikey"
disable_response_storage = true

[model_providers.custom]
name = "custom"
base_url = "https://<your-api-base-url>/v1"
wire_api = "responses"

sandbox_mode = "workspace-write"

[sandbox_workspace_write]
network_access = true

填入模型的 ID、API 平台的 URL 后，保存。

如果不需要沙箱联网权限，这部分可以删除：

sandbox_mode = "workspace-write"

[sandbox_workspace_write]
network_access = true

使用

在项目的目录中打开终端，执行 codex。

确认无误后选择 1 并回车。

Enjoy～