🪟 Windows 安装

打开 PowerShell（以管理员身份运行），执行以下命令：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

⚠️ 需要科学上网。安装完成后在终端输入 codex 即可启动。

🍎 macOS / Linux 安装

打开 终端 (Terminal)，执行以下命令：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

⚠️ 需要科学上网。安装完成后在终端输入 codex 即可启动。

手动下载二进制文件

访问 GitHub Releases 页面 下载对应平台的压缩包：

下载后解压，将二进制文件重命名为 codex 并放入 PATH 目录即可。

本站封装的 Windows 一键安装器

我们已将上述安装流程封装为 Windows 一键安装包，自动检测环境（Node.js / PowerShell / Winget）并选择最佳安装方式：

# Codex CLI Windows 一键安装脚本
# 自动检测环境并选择最佳安装方式

Write-Host "=== Codex CLI 一键安装 ===" -ForegroundColor Cyan
Write-Host "正在检测系统环境..." -ForegroundColor Yellow

# 检测 Node.js
$hasNode = $false
try { $nodeVer = node --version 2>$null; if ($nodeVer) { $hasNode = $true; Write-Host "✓ Node.js 已安装: $nodeVer" -ForegroundColor Green } }
catch { Write-Host "✗ Node.js 未安装" -ForegroundColor Red }

# 检测 Winget
$hasWinget = Get-Command winget -ErrorAction SilentlyContinue
if ($hasWinget) { Write-Host "✓ Winget 可用" -ForegroundColor Green }
else { Write-Host "✗ Winget 不可用" -ForegroundColor Yellow }

# 优先使用 Winget
if ($hasWinget) {
    Write-Host ">>> 使用 Winget 安装..." -ForegroundColor Cyan
    winget install OpenAI.Codex --accept-source-agreements
    if ($LASTEXITCODE -eq 0) {
        Write-Host "✓ Codex CLI 安装完成！输入 'codex' 启动。" -ForegroundColor Green
        exit 0
    }
}

# 其次使用 npm
if ($hasNode) {
    Write-Host ">>> 使用 npm 安装..." -ForegroundColor Cyan
    npm install -g @openai/codex
    if ($LASTEXITCODE -eq 0) {
        Write-Host "✓ Codex CLI 安装完成！输入 'codex' 启动。" -ForegroundColor Green
        exit 0
    }
}

# 最后使用官方 PowerShell 脚本
Write-Host ">>> 使用官方安装脚本..." -ForegroundColor Cyan
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

Write-Host "=== 安装完成 ===" -ForegroundColor Cyan
Write-Host "如果安装失败，请访问: https://github.com/openai/codex/releases/latest" -ForegroundColor Yellow

将上方脚本保存为 install-codex.ps1，右键"使用 PowerShell 运行"即可。

🔑 登录与使用

1. 启动 Codex CLI

   在终端输入 codex 并回车。

2. 选择登录方式

   选择 Sign in with ChatGPT 使用 ChatGPT Plus/Pro 订阅登录（推荐），或使用 API Key 登录。

3. 开始编码

   进入你的项目目录，运行 codex，即可用自然语言描述需求，Codex 会帮你写代码、调试、管理 Git。

🛒 各区 App Store Plus 月费对比

💡 加拿大最便宜约 ¥120/月，日本紧随其后约 ¥126/月。推荐注册日区或美区账号。

🎯 第一步：先准备这些

🌍 第二步：注册哪个区的账号

推荐 美区：最稳 — 应用覆盖广，资料和礼品卡渠道成熟。

也可以用日区（价格更低），但美区的稳定性和礼品卡购买渠道更成熟。

🪪 第三步：注册美区 Apple ID（在 Windows 电脑上操作）

1. 访问 Apple ID 注册页面

   在浏览器打开 appleid.apple.com/account，选择"创建你的 Apple ID"。

2. 填写注册信息

   使用准备好的 新邮箱和 +86 手机号，地区选择 美国 (United States)。

3. 完成验证

   接收邮箱验证码和手机短信验证码，完成双重验证。至此美区 Apple ID 注册成功！

💵 第四步：充值 App Store 余额

通过 Apple 官网购买礼品卡给美区账号充值（在日本 Apple 官网购买日区礼品卡也可以，看你要用哪个区）：

1. 访问礼品卡购买页面

   日区：apple.com/jp/shop/buy-giftcard/giftcard
   美区：apple.com/shop/buy-giftcard/giftcard

2. 选择金额

   选择 ¥3,000（日区）或 $25（美区）等面额。初次建议小额试充。

3. 填写收件信息并支付

   填写邮箱地址（发送电子礼品卡），使用国内银行卡（支持 Visa/Mastercard）完成支付。

4. 查收礼品卡并充值

   在邮箱中查收礼品卡兑换码，到 iPhone 的 App Store → 点击头像 → "兑换礼品卡或代码" → 输入兑换码。

✅ 第五步：在 iPhone 上订阅 ChatGPT Plus

1. 切换 App Store 账号

   iPhone 设置 → 点击顶部头像 → 媒体与购买项目 → 退出登录 → 登录你的美区/日区 Apple ID。

2. 下载 ChatGPT 应用

   在 App Store 搜索 "ChatGPT"，下载 OpenAI 官方应用（需科学上网）。

3. 登录 ChatGPT 账号

   打开 ChatGPT 应用，注册或登录你的 OpenAI 账号。

4. 订阅 Plus

   在 ChatGPT 应用内 → 设置 → 升级到 Plus → 确认订阅。费用从 App Store 余额中扣除，每月自动续费。

🚫 为什么不能直接在网页端订阅？

⚠️ 重要提示：ChatGPT 对 IP 更挑剔

能用谷歌不一定就可以使用 ChatGPT。需要选择质量好的科学上网节点（推荐日本/新加坡/美国节点）。

💰 ChatGPT 套餐价格对比

⚠️ Go 套餐无法使用 Codex！至少要订阅 Plus（$20/月）才能使用 Codex 编码智能体。实际支付会加税费，约 $23.60/月。

📋 使用建议

• 节点选择：使用 ChatGPT/Codex 时，优先选择 日本、新加坡、美国 节点。部分小众地区节点可能被 OpenAI 封禁。
• 全局模式：使用 Codex CLI 时，建议开启代理的全局模式（TUN 模式），确保终端命令走代理。
• 分流设置：将 openai.com、chatgpt.com、oaistatic.com 加入代理规则。
• 套餐建议：如果仅用于 Codex 和 ChatGPT，200G 流量可以用很久（Codex 消耗的主要是 API Token 而非流量）。
• 备用方案：建议准备 2 个不同机场的账号，防止一个机场临时维护。

🖥️ 各平台客户端配置

🔐 安全建议：使用 .env 文件管理敏感信息

将 API Key 等敏感信息写入 .env 文件，Codex 读取时会自动屏蔽等号后面的敏感内容。

# API Keys 配置文件
# 这些信息会被 Codex 自动识别和屏蔽

OPENAI_API_KEY=sk-your-openai-api-key-here
DEEPSEEK_APIKEY=sk-your-deepseek-api-key
DOUBAO_API_KEY=your-doubao-api-key
ZHIPU_API_KEY=your-zhipu-api-key
QWEN_API_KEY=your-qwen-api-key

# 中转站配置
CUSTOM_BASE_URL=https://your-relay-api.com/v1

📋 使用步骤

1. 注册中转站账号

   选择上方推荐的中转站，点击注册链接完成注册。

2. 获取 API Key 和 Base URL

   登录后在控制台获取 API Key 和 API 端点地址（Base URL）。

3. 配置 .env 文件

   在项目目录创建 .env 文件，填入 API Key 和 Base URL（参考上方模板）。

4. 启动 Codex

   在项目目录运行 codex，Codex 会自动读取 .env 中的配置。

GitHub 官方下载 需科学上网

本站直接下载 无需科学上网

macOS 也可通过 Homebrew 安装：brew install --cask cc-switch

🚀 快速上手

1. 安装 CC Switch

   根据你的系统，下载对应的安装包（macOS .dmg 或 Windows .msi），双击安装。

2. 添加 Provider

   打开 CC Switch → 点击"添加 Provider" → 选择预设（如 DeepSeek、豆包、智谱等）或创建自定义配置（填入中转站的 API Key 和 Base URL）。

3. 切换 Provider

   在主界面选择目标 Provider → 点击"启用"。也可以在系统托盘中直接点击 Provider 名称快速切换。

4. 重启终端

   切换后重启终端或对应的 CLI 工具，新配置即可生效（Claude Code 无需重启）。

🔧 常用 Provider 配置示例

名称: DeepSeek
API Key: sk-your-deepseek-api-key
Base URL: https://api.deepseek.com/v1
模型: deepseek-chat  (或 deepseek-reasoner)

名称: 豆包
API Key: your-doubao-api-key
Base URL: https://ark.cn-beijing.volces.com/api/v3
模型: doubao-1.5-pro-32k

名称: 智谱
API Key: your-zhipu-api-key
Base URL: https://open.bigmodel.cn/api/paas/v4
模型: glm-4-plus

名称: 千问
API Key: your-qwen-api-key
Base URL: https://dashscope.aliyuncs.com/compatible-mode/v1
模型: qwen-max

名称: 中转站-xxx
API Key: sk-xxxxxxxxxxxxxxxx
Base URL: https://your-relay-api.com/v1
模型: codex-gpt-5.5  (或中转站提供的模型名)

💡 实用技巧

• 云同步：支持自定义配置目录（Dropbox、OneDrive、iCloud、NAS）和 WebDAV 服务器同步，多设备共享配置。
• 深链导入：通过 ccswitch:// 协议链接一键导入 Provider、MCP 服务器、Prompts 和 Skills。
• 自动备份：配置自动备份到 ~/.cc-switch/backups/ 目录，保留最近 10 个版本。
• 原子写入：采用临时文件 + 重命名模式，防止配置损坏。
• 系统托盘：支持系统托盘快速切换 Provider，无需打开主界面。
• 速度测试：内置 API 端点延迟测试功能，帮你选择最快的节点。
• 切回官方：随时可以切回官方登录方式，从预设列表添加"官方登录"Provider 即可。

❓ 常见问题