Codex 1 分钟快速配置
这页是给完全没用过终端的同学准备的。 全程只需要：① 下载一个软件 ② 复制粘贴 Key 和两段配置 ③ 在终端复制粘贴一行命令（仅此一行）。
看完跟着做，1 分钟能让 Codex 跑起来。
Codex 比 Claude Code 多一步 “终端命令”。 这一步只是复制粘贴一行，但绕不开 —— Codex 的认证机制要求 API Key 必须从系统环境变量里读取。已经习惯命令行的可以直接跳到 第 3 步。
你需要准备的两样东西
一台 Windows 或 Mac 电脑
Windows 10/11 或 macOS 都可以。
一个 CC Club API Key
如果还没有，先去 获取 API Key 免费申请一把（领完回到这页继续）。
API Key 形如 cr_xxxxxxxxxxxxxxxxxxxxxxxxxxxx，先复制到一个记事本里，等下要用 3 次（GUI 表单、auth.json、终端环境变量）。
第 1 步：下载并安装 CC Switch
CC Switch 是一个桌面应用，帮你管理 API 配置 —— 全程只需复制粘贴，无脑操作。
- 点击下载：CC Switch Windows 版 (.msi, 12 MB)
- 双击下载好的
.exe，按提示完成安装 - 安装完成后，从开始菜单打开 CC Switch
第一次打开如果 Windows 弹出 “Windows 已保护你的电脑”，点 “更多信息” → “仍要运行”。
第 2 步：在 CC Switch 里填一份配置
打开 CC Switch 后，照下面动作做：
切到 Codex 分组
CC Switch 左侧有一列分组：Claude / Claude Desktop / Codex / OpenCode / Gemini。点 Codex。
点 ”+ 添加供应商”
页面右上角的蓝色按钮。会弹出一个表单。
按下表填 GUI 字段
| 字段 | 填什么 |
|---|---|
| 供应商名称 | 随便取，比如 CC Club Codex |
| 官网链接 | 留空 |
| API | 把你的 Key 贴进来 |
| 请求地址 | https://claude-code.club/openai |
| API 格式 | 下拉选 OpenAI Chat Completions |
| 模型区域 | 留空 |
在 “auth.json 配置” 框里贴这段
把整段贴进去，只改一个地方：把 OPENAI_API_KEY 后面那对空引号 "" 里填上你的 API Key。
{
"OPENAI_API_KEY": "你的 API 密钥"
}
↑ 贴完后 CC Switch 的 auth.json (JSON) 框里应该长这样
在 “config.toml 配置” 框里贴这段
整段贴进去，不用改任何内容：
model_provider = "club"
model = "gpt-5.4"
model_reasoning_effort = "medium"
disable_response_storage = true
preferred_auth_method = "apikey"
[model_providers.club]
name = "ai code club"
base_url = "https://claude-code.club/openai"
wire_api = "responses"
requires_openai_auth = true
env_key = "OPENAI_API_KEY"
[features]
shell_snapshot = true
multi_agent = true
unified_exec = true
↑ 贴完后 CC Switch 的 config.toml (TOML) 框里应该长这样
点右下角 “保存”
成功会回到列表，看到一条新的 CC Club Codex 供应商。
保存只是把配置写进 CC Switch，还没生效。 等下 第 4 步 会带你点 测试 → 启用，才算真正激活。
第 3 步：配置环境变量（必做）
这是 Codex 和 Claude Code 最大的不同。 Codex 启动时会去系统环境变量里找 OPENAI_API_KEY，CC Switch 的 GUI 里的 Key 不会自动注入到这里。所以我们需要复制粘贴一行命令到终端。
打开 PowerShell（开始菜单搜 “powershell”），把下面这行整段复制，把 cr_xxxxxxxxxx 替换成你自己的 API Key，回车：
[System.Environment]::SetEnvironmentVariable('OPENAI_API_KEY', 'cr_xxxxxxxxxx', 'User')这条命令做了什么？ 把 OPENAI_API_KEY 写到 Windows 用户级环境变量里，永久生效。设完后 重启 PowerShell 才能让新启动的进程读到。
第 4 步：测试、启用、验证
保存好的供应商还没生效。这一步分三个动作：先 测试 配置（确认 Key + 地址都对）→ 再 启用（让它生效）→ 最后在终端 验证（端到端跑一次）。
✅ 全流程预览（先看一眼，下面有逐步说明）
在 CC Club Codex 那行上点 测试（蓝色按钮）
看到绿色 测试成功 提示
点 启用（绿色按钮），行首出现 ✓ 即生效
终端跑 codex，看到 banner + 应答 —— 链路就通了
📌 图 ①②③ 来自 Claude 配置示例（CC Switch 同一界面），Codex 操作位置完全一致
先点 “测试” 验证配置
在刚保存的那条 CC Club Codex 供应商行上，点蓝色 测试 按钮（如上方图 ①）。CC Switch 会用你填的 Key + 请求地址向上游发一次握手请求。
- ✅ 看到绿色 “测试成功” 提示（图 ②）：Key 和地址都对，可以继续下一步
- ❌ 看到红色错误：通常是 Key 错了 / 地址错了 / 网络不通。点 编辑 检查
OPENAI_API_KEY和base_url，最常见的坑是 Key 首尾带了空格
为什么先测试？ 测试只验证”CC Switch 能连上 API”，不需要 Codex 本体。先把这一步走通，等下装命令行才有底。
点 “启用” 激活这条配置
测试通过后，点同一行的绿色 启用 按钮（图 ③）。激活成功后：
- 行首会出现一个 ✓ 勾选标记
- 状态从”已保存”变成”当前使用”
保存 ≠ 启用 ≠ 测试，三件事各走各的：
- 保存 = 把这条配置写进 CC Switch
- 测试 = 检查这条配置能不能连通
- 启用 = 让 Codex 实际用这条配置
不点”启用”，就算测试通过也不生效。
装 Codex CLI
CC Switch 只管”配置”，不管”安装”。Codex 本体还得装一次 —— 在 CC Switch 顶部找 “安装 Codex” 按钮，点一下，它会自动帮你装好。
（如果找不到按钮、或者按钮报错，按 手动安装步骤 走。）
在终端验证一次
codex "用一句话解释什么是 vibe coding"几秒内返回一段中文（如上方图 ④），整条链路就通了 🎉。
走完了，下一步看什么？
已经能跑了。 建议接下来：
- 看 Codex 启动报错处理，避免后续踩坑
- 在 VS Code 里把 Codex 当编程助手用
出问题了？
问题 1：终端输 codex 提示 “找不到命令”
说明 Codex CLI 本体没装好。两个办法：
- 重试 CC Switch 的”安装 Codex”按钮：可能上一次因为网络中断没装完
- 换手动安装：跟着 手动安装步骤（下面）走
问题 2：跑 codex 报 “Invalid API key” 或 “Authentication failed”
99% 是第 3 步没做或没生效。三个检查：
- 重启终端：环境变量设置后必须重开一个新终端窗口，旧窗口读不到
- 验证环境变量已设置：
- Windows PowerShell：
echo $env:OPENAI_API_KEY - macOS Terminal：
echo $OPENAI_API_KEY - 应该输出你的 Key；如果是空的，第 3 步没生效，重做一遍
- Windows PowerShell：
- 确认 CC Switch 里供应商已激活：列表中那条
CC Club Codex前面要有 ✓ 勾选标记
问题 3：响应很慢 / 一直转圈
可能是网络节点不合适。回 CC Switch 编辑那条供应商，把 请求地址 和 config.toml 里的 base_url 同时改成下面其中一组再保存：
https://jp.claude-code.club/openai— 日本节点（回国优化）https://hk.claude-code.club/openai— 香港节点（回国优化）https://sz.ai-code.club/openai— 深圳节点（国内中转出境）
改完别忘了再单击一次激活。
手动安装 Codex（备用方案）
如果 CC Switch 里没有”安装 Codex”按钮，或者点了报错，手动装一次。
需要先有 Node.js（v18+）：
npm install -g @openai/codex或者 macOS 上用 Homebrew：
brew install --cask codex装完回这页继续做”第 3 步”。
已经是熟手？
如果你看得懂终端、想完全掌控安装过程，直接走传统路径：
