安装 Codex

1. 安装 Node.js 与 npm

已安装的用户请忽略此步骤。

1. 打开 Node.js 官网 ，下载 LTS 长期支持版（左边的稳定版本）。

2. 按默认配置完成安装。

3. 打开命令行工具并验证版本：

   • Windows：CMD 或 PowerShell
   • macOS/Linux：终端

node -v   # 查看 Node.js 版本
npm -v    # 查看 npm 版本

出现版本号即表示安装成功。

根据您的项目类型，选择合适的 Codex 安装方式：

• 使用 pip 安装（Python 环境）

  pip install codex

• 使用 npm 安装（Node.js 环境）

  npm install codex

安装完成后，可通过以下命令验证是否安装成功：

codex --version

2. 定位 .codex 文件夹

Codex 会在用户主目录下创建名为 .codex 的隐藏文件夹，用于存放配置文件：

• Windows：C:\Users\<您的用户名>\.codex\
• macOS/Linux：/Users/<您的用户名>/.codex/ 或 ~/.codex/

如果该文件夹不存在，请手动创建：

mkdir ~/.codex

3. 创建或编辑配置文件

.codex 文件夹中需要存在 config.toml 和 auth.json 两个配置文件。如果文件不存在，请直接新建。

3.1 配置 config.toml

config.toml 是 Codex 的主配置文件，使用 TOML 格式。请使用文本编辑器打开或新建该文件，并填入以下内容：

model_provider = "Customer"
model = "gpt-5.5"
review_model = "gpt-5.5"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000
model_reasoning_effort = "xhigh"
 
[model_providers.Customer]
name = "Customer"
base_url = "https://api.ykh.ai/v1"
wire_api = "responses"
requires_openai_auth = true

3.2 配置 auth.json

auth.json 用于存放认证信息，采用 JSON 格式。请在该文件中填入您的 API 密钥：

{
  "OPENAI_API_KEY": "sk-rxxxxxx1d"
}

请将 sk-rxxxxxx1d 替换为您实际的 OpenAI API 密钥。

注意：确保该文件的权限设置正确，避免密钥泄露。

4. 验证配置

完成上述步骤后，可运行一个简单的 Codex 命令验证配置是否生效：

codex "Hello, world"

5. 配置支持 GPT 5.5

问题根源是 Codex 124.0 的模型列表没有更新，所以需要通过账号登录获取一份新鲜的模型列表。

下载 model-catalog.gpt-5.5.json

将该 JSON 文件放在 .codex 根目录：

• macOS/Linux：~/.codex/
• Windows：C:\Users\<您的用户名>\.codex\

打开 config.toml，加入以下参数：

model_catalog_json = '.\\model-catalog.gpt-5.5.json'

也可以使用绝对路径。例如 macOS：

model_catalog_json = '/Users/catdd/.codex/model-catalog.gpt-5.5.json'

然后重启 Codex，通过 /model 即可看到 GPT 5.5。