Codex 安装使用指南

Codex 支持 Mac、Windows 和 Linux 系统

▌ Windows 桌面应用安装（点点鼠标）

官网

https://openai.com/zh-Hans-CN/codex/

Windows 安装包

下载 Codex Installer.zip，解压后双击里面的安装程序，按提示安装完成。

▌ 安装与配置

步骤 1：安装 Codex

打开安装包，一路"下一步"安装即可。

安装完成后打开 Codex，如果报错（如提示缺少 DLL），请安装 Microsoft Visual C++ 运行库：

• x64 版本（64 位主流）：https://aka.ms/vs/17/release/vc_redist.x64.exe
• x86 版本（32 位）：https://aka.ms/vs/17/release/vc_redist.x86.exe

步骤 2：创建 auth.json 文件

这个文件存你的 API Key。

文件路径：

C:\Users\你的用户名\.codex\auth.json

💡 一键写入： 先把下面命令里的 你的API_KEY 替换成你实际的 key，然后整段粘贴到 PowerShell 回车：

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.codex" | Out-Null@'{    "OPENAI_API_KEY": "你的API_KEY",    "auth_mode": "apikey"}'@ | Set-Content -Path "$env:USERPROFILE\.codex\auth.json" -Encoding UTF8

✅ 说明： 这段命令做了两件事：① 自动创建 .codex 文件夹（如果还没有）；② 覆盖写入新的 auth.json（旧文件会被直接替换）。

步骤 3：创建 config.toml 文件

这个文件存模型配置和中转地址。

文件路径：

C:\Users\你的用户名\.codex\config.toml

💡 一键写入： 不需要改任何内容，整段粘贴到 PowerShell 回车：

@'model_provider = "aiweber"model = "gpt-5.4"model_reasoning_effort = "high"disable_response_storage = true[model_providers.aiweber]name = "aiweber"base_url = "https://codex-api-01.aiweber.com"wire_api = "responses"requires_openai_auth = true'@ | Set-Content -Path "$env:USERPROFILE\.codex\config.toml" -Encoding UTF8

步骤 4：开始打开使用

配置完成后，直接打开 Codex 即可开始使用。

▌ 附录：切换 API Key（PowerShell）

如果你换了 key 或需要切账号，重新写一次 auth.json 即可。

文件路径：

C:\Users\你的用户名\.codex\auth.json

文件内容长这样：

{  "OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxxxxxxxxxx",  "auth_mode": "apikey"}

换 key 有三种写法，任选其一：

方式 1（推荐）：交互式粘贴新 key

✅ 好处： key 不会留在 PowerShell 命令历史里，更安全。

把下面整行粘贴到 PowerShell 里回车：

$f="$env:USERPROFILE\.codex\auth.json"; $j=Get-Content $f -Raw | ConvertFrom-Json; $j.OPENAI_API_KEY=(Read-Host "粘贴新的 OPENAI_API_KEY"); ($j | ConvertTo-Json) | Set-Content $f -Encoding UTF8; Write-Host "已更新" -ForegroundColor Green

回车后它会提示你粘贴新 key，粘贴完再按一次回车。auth_mode 等其他字段会原样保留。

方式 2：一行命令带着 key 直接改

把 改成新的 OPENAI_API_KEY 换成你的新 key，粘贴进 PowerShell 回车：

$f="$env:USERPROFILE\.codex\auth.json"; $j=Get-Content $f -Raw | ConvertFrom-Json; $j.OPENAI_API_KEY="改成新的 OPENAI_API_KEY"; ($j | ConvertTo-Json) | Set-Content $f -Encoding UTF8

方式 3：暴力版（整个文件重写）

适合首次创建或彻底重置：

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.codex" | Out-Null'{"OPENAI_API_KEY":"改成新的 OPENAI_API_KEY","auth_mode":"apikey"}' | Set-Content "$env:USERPROFILE\.codex\auth.json" -Encoding UTF8

验证

Get-Content "$env:USERPROFILE\.codex\auth.json"

看到里面 OPENAI_API_KEY 是你的新 key 就 OK 了。

生效时机

• 如果 Codex 没在运行：下次启动自动用新 key
• 如果 Codex 正在运行：退出（命令行 exit、桌面 App 直接关）再重开一次

▌ 补充：常见问题

Q：提示 401 或 key 无效？

• 检查 auth.json 里的 key 有没有多余空格、引号错乱
• 用附录的"方式 1"重新写一次
• 确认你的 key 在 aiweber 那边没被撤销/欠费

Q：怎么看当前的配置？

Get-Content "$env:USERPROFILE\.codex\auth.json"Get-Content "$env:USERPROFILE\.codex\config.toml"

📌 备注： Codex 和 Claude Code 是两个独立的 AI 工具，可以共存，配置文件分别在 .codex 和 .claude 两个不同的文件夹，互不影响。如果你也需要 Claude Code 的安装指南，见同目录 Claude-Code-Windows-新手指南.md。

▌ macOS 终端安装指南

安装前提

在开始安装前，请确保满足以下条件：

• 需要 Node.js 18+ 版本

步骤 1：安装 Codex 最新版

在终端执行：

npm install -g @openai/codex

步骤 2：创建 auth.json 文件

删除 ~/.codex 路径下已存在的 auth.json 文件（若有），然后新建一个 auth.json，内容为：

{  "OPENAI_API_KEY": "你的API_KEY"}

步骤 3：创建 config.toml 文件

删除 ~/.codex 路径下已存在的 config.toml 文件（若有），然后新建一个 config.toml，内容直接原封不动地粘贴下文：

model_provider = "aiweber"model = "gpt-5.4"model_reasoning_effort = "high"disable_response_storage = truepreferred_auth_method = "你的API_KEY"[model_providers.aiweber]name = "aiweber"base_url = "https://codex-api-01.aiweber.com"wire_api = "responses"

步骤 4：重启终端，验证安装结果

重启终端后运行以下命令，确认安装成功：

codex -v

— END —