Codex 安装指南
官方原版安装 — 此流程 100% 使用官方原版安装包，确保服务体验与官方完全一致。
系统要求 · macOS 10.15+ 或任意现代 Linux 发行版
01
安装 Codex CLI
运行以下任意一条命令，全局安装官方 Codex CLI：
npm install -g @openai/codex # 或者 / or brew install codex
两条命令安装的是同一个包，选择适合你环境的即可。
02
创建 .codex 目录
在终端中执行以下命令：
rm -rf ~/.codex mkdir ~/.codex
04
创建 auth.json
在 ~/.codex 目录下新建 auth.json 文件，写入以下内容：
{ "OPENAI_API_KEY": "YOUR_API_KEY" }
将 YOUR_API_KEY 替换为上一步复制的密钥。
05
创建 config.toml
在 ~/.codex 目录下新建 config.toml 文件，写入以下内容：
以下内容请原封不动粘贴，不要修改任何值。
model_provider = "codeMan" model = "gpt-5.5" model_reasoning_effort = "xhigh" disable_response_storage = true preferred_auth_method = "apikey" [model_providers.codeMan] name = "codeMan" base_url = "https://pay.ncma.cn/v1" wire_api = "responses"
06
重启终端 验证安装
重启终端后运行以下命令，确认安装成功：
codex -V
若输出版本号，则说明 Codex 已正确安装。
07
开始使用 Codex
进入任意项目目录，启动 Codex：
# 切换到项目目录 cd your-project-folder # 启动 Codex codex
完全支持 VSCode 官方插件。
官方原版安装 — 此流程 100% 使用官方原版安装包，确保服务体验与官方完全一致。
系统要求 · Windows 10（版本 1809 / build 17763）及以上 · 需预先安装 Node.js
01
安装 Codex CLI
打开 PowerShell 或命令提示符，运行以下命令全局安装官方 Codex CLI：
npm install -g @openai/codex
如果尚未安装 Node.js，请先前往 nodejs.org 下载并安装。
02
创建 .codex 目录
在 PowerShell 中执行以下命令（将 <your-username> 替换为你的 Windows 用户名）：
# 删除旧目录（若有） Remove-Item -Recurse -Force "C:\Users\<your-username>\.codex" -ErrorAction SilentlyContinue # 创建新目录 New-Item -ItemType Directory "C:\Users\<your-username>\.codex"
将 <your-username> 替换为你的实际 Windows 用户名，例如
C:\Users\张三\.codex04
创建 auth.json
在 C:\Users\<your-username>\.codex 目录下，用记事本新建 auth.json 文件，写入以下内容：
保存时「文件类型」请选择「所有文件 (*.*)」，避免被保存为 auth.json.txt
{ "OPENAI_API_KEY": "YOUR_API_KEY" }
将 YOUR_API_KEY 替换为上一步复制的密钥。
05
创建 config.toml
在同一目录下，用记事本新建 config.toml 文件，写入以下内容：
以下内容请原封不动粘贴，不要修改任何值。保存时同样选择「所有文件 (*.*)」。
model_provider = "codeMan" model = "gpt-5.5" model_reasoning_effort = "xhigh" disable_response_storage = true preferred_auth_method = "apikey" [model_providers.codeMan] name = "codeMan" base_url = "https://pay.ncma.cn/v1" wire_api = "responses"
06
重启终端 验证安装
关闭并重新打开 PowerShell，运行以下命令确认安装成功：
codex -V
若输出版本号，则说明 Codex 已正确安装。
07
开始使用 Codex
进入任意项目目录，启动 Codex：
# 切换到项目目录 cd your-project-folder # 启动 Codex codex
完全支持 VSCode 官方插件。