Codex CLI 配置教程

📋 系统要求

Node.js 版本 ≥ 18.0

支持的操作系统：macOS、Linux、Windows (WSL)

1. 安装 Node.js

💡 提示：如果您已经安装了 Node.js 18.0 或更高版本，可以跳过此步骤。

Ubuntu / Debian 用户

macOS 用户

Windows 用户

2. 安装 Codex

使用 npm 全局安装 Claude Code：

3. 配置并开始使用

获取必要的配置信息

您需要准备两个重要的配置项：

配置项	说明	获取方式
OPENAI_API_KEY	API 认证令牌	注册后在 `控制台/令牌管理` 页面点击 `添加令牌` 获得（以 `sk-` 开头）
base_url	API 服务地址	`https://www.sudocode.run/v1`

📝 创建令牌时的建议设置：
名称：随意命名
额度：设为无限额度
分组：选择vip gpt
其他选项：保持默认设置

Codex环境配置

以下内容粘贴到文件中并保存：

model_provider = "sudocode"
model = "gpt-5.3-codex"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true
windows_wsl_setup_acknowledged = true
model_verbosity = "high"

[model_providers.sudocode]
name = "sudocode"
base_url = "https://www.sudocode.run/v1"
wire_api = "responses"
requires_openai_auth = true

[projects."/Users/xxxx/.codex"]#这里xxxx需要修改为您自己的用户名
trust_level = "untrusted"

以下内容粘贴到文件中并保存：

{
  "OPENAI_API_KEY": "此处粘贴平台上创建的令牌，sk开头"
}

初次运行配置

✨ 恭喜！ 现在您可以开始与您的 AI 编程搭档一起写代码了！

使用VS Code的Codex插件的话，需要使用（免费的或者付费的都可以）chatgpt账号登陆一下，登陆以后，VS Code的Codex插件同样使用上面的配置来运行。

提升gpt-5.4上下文

gpt-5.4 上下文最高支持1M（之前总上下文最大400K），但是消耗*2，有大项目，长上下文需求的用户可以按需配置

在Codex CLI 中显示 gpt-5.5

1）下载 model-catalog.gpt-5.5.json ，复制文件到.codex 目录下

codex目录

mac：~/.codex
Windows：C:\Users\你的用户名\.codex

2）配置config.toml文件，修改model，增加 model_catalog_json

3）重启Codex CLI，/model 可以显示 gpt-5.5

📋 系统要求#

1. 安装 Node.js#

Ubuntu / Debian 用户#

macOS 用户#

Windows 用户#

2. 安装 Codex#

3. 配置并开始使用#

获取必要的配置信息#

Codex环境配置#

初次运行配置#

提升gpt-5.4上下文#

在Codex CLI 中显示 gpt-5.5#

📋 系统要求

1. 安装 Node.js

Ubuntu / Debian 用户

macOS 用户

Windows 用户

2. 安装 Codex

3. 配置并开始使用

获取必要的配置信息

Codex环境配置

初次运行配置

提升gpt-5.4上下文

在Codex CLI 中显示 gpt-5.5