Codex CLI 与桌面端配置

​

你需要准备什么

1. 一台 Windows、macOS 或 Linux 电脑。
2. 一个可用的 Xcompute API Key。
3. Node.js 22 或更高版本，本文推荐 Node.js 24。
4. Codex CLI，或 Windows/macOS 版 Codex App。

​

CLI 和 App 如何共用配置

​

第一步：安装 Node.js

node -v
npm -v

node -v
npm -v

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs

curl -fsSL https://rpm.nodesource.com/setup_24.x | sudo bash -
sudo dnf install -y nodejs

​

第二步：安装 Codex CLI

npm install -g @openai/codex

codex --version

​

第三步：安装 Codex 桌面 App

• macOS：打开 DMG，将 Codex 拖入 Applications 文件夹。
• Windows：打开安装程序，按照界面提示完成安装。
• Linux：目前优先使用 Codex CLI。

​

第四步：创建 config.toml

• Windows
• macOS / Linux

创建文件前，先打开任意文件夹，点击顶部的 查看，勾选 文件扩展名 和 隐藏的项目。

勾选这两个选项后，才能确认文件是否真的以 .toml 或 .json 结尾。然后点击 开始菜单，搜索并打开 Windows PowerShell。

复制下面两行到 PowerShell，按 Enter 执行：

New-Item -ItemType Directory -Force "$HOME\.codex"
notepad "$HOME\.codex\config.toml"

记事本询问是否创建文件时选择 是。保存时按 Ctrl+S。如果出现“另存为”，将 保存类型 改为 所有文件，确保文件名是 config.toml，而不是 config.toml.txt。

打开终端，执行：

mkdir -p ~/.codex
nano ~/.codex/config.toml

使用 nano 时，按 Ctrl+O 保存，按 Enter 确认，再按 Ctrl+X 退出。

​

第五步：写入 Xcompute 接口配置

model_provider = "xcompute"
model = "gpt-5.6-sol"
review_model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
cli_auth_credentials_store = "file"

[model_providers.xcompute]
name = "Xcompute"
base_url = "https://intl.dualseason.com/v1"
wire_api = "responses"
requires_openai_auth = true

​

每个配置项有什么作用

​

第六步：创建 auth.json

notepad "$HOME\.codex\auth.json"

nano ~/.codex/auth.json

{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "在这里填写你的APIKey"
}

​

Windows 最终文件位置

​

两个文件缺一不可

​

第七步：启动并验证

​

验证 Codex CLI

cd /path/to/your-project
codex

请告诉我你当前使用的模型，并分析这个项目的目录结构，不要修改任何文件。

​

验证 Codex App

1. 完全退出 Codex App。
2. 确认 config.toml 和 auth.json 都已保存。
3. 重新打开 Codex App。
4. 选择一个测试项目文件夹。
5. 输入“分析这个项目，不要修改文件”。

​

如何切换模型

model = "其他模型ID"

​

常见问题

​

codex 命令不存在

node -v
npm -v
npm install -g @openai/codex
codex --version

​

App 没有读取新配置

1. 确认 App 和 CLI 使用的是同一个电脑账户。
2. 确认 config.toml 和 auth.json 都位于用户目录的 .codex 文件夹。
3. Windows 检查文件是否被保存成 config.toml.txt 或 auth.json.txt。
4. 确认 config.toml 包含 cli_auth_credentials_store = "file"。
5. 完全退出 App，而不是只关闭当前项目窗口，然后重新打开。

​

提示未授权或 API Key 无效

1. auth.json 中包含 "auth_mode": "apikey"。
2. OPENAI_API_KEY 的值没有前后空格。
3. API Key 仍然有效且账户有可用额度。
4. config.toml 中的 requires_openai_auth 是 true。
5. base_url 包含 /v1，wire_api 是 responses。

​

以前使用过切换工具或本地代理

base_url = "https://intl.dualseason.com/v1"

​

官方资源

• Codex 官方仓库
• Codex App 官方页面
• Codex 官方文档
• Xcompute API Key