Codex 一键配置安装教程

一条命令完成 Codex CLI 的安装，并为 Codex CLI 和 Codex 桌面版 App 配置AI驿站。默认模型 gpt-6.1-sol，推理强度中档（medium）。

1. 运行一键配置命令

macOS / LinuxWindows PowerShell

bash

curl -fsSL https://docs.aizhan.space/sh/codex.sh | bash

powershell

irm https://sh.api.aizhan.space/codex.ps1 | iex

脚本启动后的菜单：

1 安装 Codex CLI
2 配置 Codex CLI / 桌面版 App
3 一键全部安装（第一次用直接选这个）

配置时会问你在哪个客户端使用（CLI / 桌面版 App / 回车 = 都用），然后选择线路、输入 GPT 分组 的 API Key。

2. 前置：Node.js 22+

Codex CLI 通过 npm 安装（@openai/codex），需要 Node.js 22 或更新版本：安装 Node.js。默认 npm 源失败时脚本会自动切换国内镜像（npmmirror）。只用桌面版 App 的话可以不装 CLI，直接选「2」配置。

3. 脚本会写哪些文件

配置目录：~/.codex/（Windows 为 %USERPROFILE%\.codex\，设置了 CODEX_HOME 时以它为准）

config.toml：

toml

model_provider = "aizhan"
model = "gpt-6.1-sol"
review_model = "gpt-6.1-sol"
model_reasoning_effort = "medium"
# ……其余基础配置

[model_providers.aizhan]
name = "aizhan"
base_url = "https://api.aizhan.space/v1"
wire_api = "responses"
requires_openai_auth = true

auth.json：写入 OPENAI_API_KEY。

config.toml 里你自己的其他配置（MCP 服务器、profiles 等）会保留。
如果 auth.json 里有 ChatGPT 官方登录凭据，Codex 会优先用它，导致请求AI驿站时报 401，所以脚本会把它移除（原文件已备份）。想切回官方登录，把备份文件改回 auth.json，或重新执行 codex login。

4. 验证

bash

codex exec --skip-git-repo-check "Reply with exactly: OK"

看到 OK 就说明配置成功。桌面版 App 需要彻底退出后重新打开。

5. 常见问题

401 Unauthorized：确认 Key 属于 GPT 分组；重新运行脚本选「2」写入正确的 Key。
切换推理强度：在 Codex 里用 /model 选择，或修改 config.toml 的 model_reasoning_effort（low / medium / high / xhigh）。
回滚：把 config.toml.bak.时间戳、auth.json.bak.时间戳 改回原文件名。

Codex 一键配置安装教程 ​

1. 运行一键配置命令 ​

2. 前置：Node.js 22+ ​

3. 脚本会写哪些文件 ​