💻Codex 入门指南

本文面向第一次配置 Codex 的同学，按“下载工具 → 账号准备 → 创建 API Key → 在 CC Switch 配置 → 在 Codex 使用”的顺序完成上手。

1. 📥从 Codex 官方下载

方式 A：下载 Codex App

1. 打开 OpenAI Codex App 官方页面：https://openai.com/codex/

2. 按系统选择版本：

   • macOS Apple Silicon：适用于 M 系列芯片 Mac。

   • macOS Intel：适用于 Intel 芯片 Mac。

   • Windows：按页面指引下载或通过 Microsoft Store / winget 安装。

3. 安装后打开 Codex。

4. 登录方式选择(后面在获取了apikey后再登录)

   • ChatGPT 账号登录：适合已有 Plus / Pro / Business / Edu / Enterprise 计划的用户。

   • API Key 登录：适合按 API 调用量付费，或使用第三方/中转平台 Key 的用户。

方式 B：安装 Codex CLI

macOS / Linux 可使用官方安装脚本：

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

Windows 可使用：

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

也可以使用包管理器：

npm install -g @openai/codex
brew install --cask codex

安装后在终端运行：

codex

---

2. 📦下载 CC Switch

模型管理

1. 打开 CC Switch 官方站：https://ccswitch.io/zh/

2. 点击下载入口，按自己的系统选择安装包：

   • macOS

   • Windows

   • Linux

3. 如果官网入口不可用，可从官方 GitHub 仓库的 Releases 下载：https://github.com/farion1231/cc-switch

4. 安装后启动 CC Switch，第一次打开时可以允许它读取本机已有的 Codex / Claude Code / Gemini CLI 配置，便于后续统一管理。

只从官方站或官方 GitHub 仓库下载。不要从不明网盘、群文件、压缩包二次分发链接下载安装包。

---

3. 🔑准备一个大模型平台账号

这里看具体需要使用什么模型，deepseek或者其他AI站等均可，创建账号。

4. 💰准备额度

在选择的平台添加额度或者使用token plan等。

---

5. 🔐新建 API Key

1. 在选择的平台找到api keys或api 控制台。

2. 点击“新建 / Create”。

3. 建议填写一个容易识别的名称，例如：codex-local。

4. 创建后立即复制 API Key，并保存到密码管理器。

5. 不要把 API Key 发到群聊、文档正文、截图、代码仓库或日志里。

建议同时记录以下信息：

字段	从哪里获取	示例说明
API Key	API Key 页面	只保存到本地安全位置
Base URL / Endpoint	API 文档或控制台	通常是 OpenAI-compatible endpoint
Model ID	平台的模型列表	选择支持 Codex / OpenAI Responses / 编程场景的模型

---

6. ⚙️在 CC Switch 上配置 Codex 模型

1. 打开 CC Switch。

2. 在顶部或侧边栏选择 Codex。

3. 进入 Provider / 模型提供商配置。

4. 点击 Add / 新增 Provider。

5. 按平台控制台提供的信息填写：

配置项	填写建议
Provider Name	自定义一个可以识别的
API Key	粘贴刚才创建的API Key
Base URL / Endpoint	填平台提供的 OpenAI-compatible 接口地址
Model	选择平台模型列表中可用于 Codex 的模型
API Format / Wire API	如有选项，优先选择 OpenAI Responses / responses

1. 保存配置。

2. 点击 Sync / Apply / Switch，将该 Provider 应用到 Codex。

3. 如果 CC Switch 提供测试按钮，先执行一次测试，确认 Key、Base URL 和模型可用。

注意：这里如果使用的模型不支持codex接口(即不是GPT相关模型)，可以使用CC Switch的路由功能进行本地转发
CC Switch 设置 -> 路由 -> 开启 codex

推荐检查点

• Provider 是否切换到了 自定义。

• Codex 面板里显示的模型是否是你想使用的模型。

• API Key 没有多余空格、换行或引号。

• Base URL 是平台当前文档给出的地址，不要混用其他平台地址。

---

7. 🚀在 Codex 上使用 API Key 方式

Codex App

1. 打开 Codex App。

2. 登录时选择 API Key / OpenAI API Key 相关选项。

3. 粘贴 API Key，按提示完成登录。

4. 选择一个本地项目文件夹。

5. 发起一个简单测试任务，例如：

查询北京今天的天气

Codex CLI

如果你希望使用 API Key 登录 Codex CLI，可在终端执行：

export OPENAI_API_KEY="你的 API Key"
printenv OPENAI_API_KEY | codex login --with-api-key
codex

如果通过 CC Switch 管理配置，优先在 CC Switch 中完成切换和同步，再打开新的终端窗口运行：

codex

---

8. ✅验证是否配置成功

完成配置后，用一个低风险任务测试：

请查看当前项目结构，只总结主要目录，不要修改任何文件。

成功表现：

• Codex 能正常响应。

• 没有出现 401 / invalid API key。

• 没有出现 model not found。

• 平台后台能看到调用记录或额度扣减。

常见问题排查：

问题	可能原因	处理方式
401 / invalid API key	Key 填错、复制多了空格、Key 被禁用	重新复制 Key，必要时新建 Key
model not found	模型 ID 填错或账号无权限	回平台模型列表复制准确 Model ID
provider not provide base url	Base URL 未填写或格式不对	按平台文档补充完整 Endpoint
仍在使用旧模型	CC Switch 未同步或终端未重启	重新 Sync / Apply，并打开新终端
请求失败但 Key 正确	平台余额不足、限速、网络问题	检查余额、限速提示和平台状态

---