夜雨聆风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 —
