自动安装Chatgpt/codex 脚本

这些脚本能做什么

• 自动写入 ~/.codex/config.toml，配置 VC 模型提供商（默认模型 gpt-5.5，具体 base_url 由脚本内部预设）。
• 自动写入或合并 ~/.codex/auth.json 中的 OPENAI_API_KEY，保留已有的 ChatGPT OAuth 等字段。
• 运行前先对 API Key 做冒烟测试，失败则不会改动任何配置文件。
• macOS 一键脚本还能从 OpenAI 官方 CDN 下载 DMG，把桌面 App 安装到 /Applications（无权限时安装到 ~/Applications）。
• Windows 脚本可选通过 Microsoft Store 安装 ChatGPT 桌面版。

快速选择

操作系统	推荐脚本	主要能力
macOS	codex-mac-setup.sh	App 安装 + VC 配置
Windows（PowerShell）	codex-vc-setup.ps1	VC 配置 + 可选安装 ChatGPT
Windows（Git Bash）	codex-vc-setup.sh	VC 配置 + 可选安装 ChatGPT
Linux	codex-vc-setup.sh	VC 配置

如果浏览器点击脚本链接后直接打开文本而非下载，请在链接上「右键 → 另存为」。

准备工作

1. 准备好可用的 OPENAI_API_KEY。
2. 关闭正在运行的 Codex / ChatGPT 桌面 App。
3. 确认系统已联网。
4. macOS / Linux / Git Bash 用户需确保系统自带 curl、sed、awk。

macOS：App + 配置一步到位

1. 下载脚本：

curl -fsSL -o ~/Downloads/codex-mac-setup.sh https://codexguide.ai/scripts/codex-mac-setup.sh

2. 运行：

bash ~/Downloads/codex-mac-setup.sh

3. 按提示输入 API Key；脚本会自动下载官方 DMG 并安装桌面 App（若无 /Applications 写入权限则安装到 ~/Applications）。

常用选项：

bash codex-mac-setup.sh --config-only   # 只写配置，不装 App
bash codex-mac-setup.sh --app-only      # 只装 App，不写配置
bash codex-mac-setup.sh --no-smoke      # 跳过 API 冒烟测试
bash codex-mac-setup.sh --force         # 强制重装 App
bash codex-mac-setup.sh --restore       # 恢复首次运行前的 config.toml

Windows（PowerShell）：原生无依赖

1. 下载脚本：

Invoke-WebRequest -Uri https://codexguide.ai/scripts/codex-vc-setup.ps1 -OutFile "$env:USERPROFILE\Downloads\codex-vc-setup.ps1"

2. 运行：

powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\Downloads\codex-vc-setup.ps1"

常用选项：

powershell -ExecutionPolicy Bypass -File codex-vc-setup.ps1 -WithChatGPT
powershell -ExecutionPolicy Bypass -File codex-vc-setup.ps1 -NoSmoke
powershell -ExecutionPolicy Bypass -File codex-vc-setup.ps1 -Restore

Windows（Git Bash）：bash 跨平台脚本

1. 下载脚本：

curl -fsSL -o ~/Downloads/codex-vc-setup.sh https://codexguide.ai/scripts/codex-vc-setup.sh

2. 运行：

bash ~/Downloads/codex-vc-setup.sh

可选同时安装 ChatGPT 桌面版：

bash codex-vc-setup.sh --with-chatgpt

Linux：同样的 bash 脚本

步骤与 Windows Git Bash 完全一致：

curl -fsSL -o ~/Downloads/codex-vc-setup.sh https://codexguide.ai/scripts/codex-vc-setup.sh
bash ~/Downloads/codex-vc-setup.sh

环境变量与默认值

变量	默认值	说明
OPENAI_API_KEY	从 ~/.codex/auth.json 读取，或交互输入	API Key
VC_BASE_URL	脚本内部预设	模型提供商地址，一般无需手动覆盖
VC_MODEL	gpt-5.5	默认模型
CODEX_HOME	~/.codex	配置目录
CODEX_APP_DMG_URL	官方 CDN 地址	macOS 脚本可覆盖 DMG 下载地址

脚本会修改哪些文件

• ~/.codex/config.toml — 写入 model_provider = "VC" 及 [model_providers.VC] 配置块。
• ~/.codex/auth.json — 合并 OPENAI_API_KEY，保留已有字段。
• ~/.codex/backups/config.toml.pre-vc-*.bak — 首次原配置备份 + 每次运行的带时间戳备份。
• ~/.codex/bin/vc-provider-restore.sh — 一键回滚脚本（Bash 版本生成）。

验证是否成功

1. 脚本输出 Provider API smoke passed 即说明 API Key 与网络正常。
2. 重启 Codex / ChatGPT 桌面 App。
3. 在 Codex 中输入：

Reply with only: connected

如果能正常收到回复，说明配置已生效。

回滚配置

如果配置后出现问题，使用对应脚本回滚：

# macOS / Git Bash / Linux
bash codex-mac-setup.sh --restore
# 或
bash codex-vc-setup.sh --restore

# Windows PowerShell
powershell -ExecutionPolicy Bypass -File codex-vc-setup.ps1 -Restore

回滚会从首次备份恢复 config.toml，auth.json 不会被删除。

安全与排障

• 脚本不依赖 Python、jq 或 Node，只使用系统自带工具（Bash 版用 curl/sed/awk，PowerShell 版用纯 PowerShell + .NET）。
• macOS 脚本会验证 App 签名（Team ID 2DC432GLL2，bundle id com.openai.codex）。
• Windows PowerShell 脚本会校验 Microsoft Store 安装程序签名。
• 若 Linux / Git Bash 提示缺少 curl、sed 或 awk，请先安装。
• 若 Windows 没有 winget，PowerShell 脚本会回退到打开 Store 安装器。
• 所有脚本都会在修改配置前备份，首次备份文件为 ~/.codex/backups/config.toml.pre-vc-original.bak。

下一步

• 还没装过桌面 App？参考 Codex 桌面 App 下载与安装。
• 想了解配置字段含义，阅读 GPT-5.5 设置指南。
• 准备用 CLI 改代码，查看 CLI 安装与登录。