本文最后更新于 56 天前，如有失效请评论区留言。
什么是 OpenAI Codex
OpenAI Codex 是 OpenAI 推出的智能编程代理（Coding Agent），它可以根据自然语言指令自动编写、调试和优化代码。2026 年的 Codex 已经发展出了两种形态：
| 版本 | 形态 | 适用平台 | 说明 |
|——|——|———-|——|
| Codex Desktop | 桌面应用（Electron） | Windows / macOS | 图形界面，开箱即用 |
| Codex CLI| 命令行工具 | Linux / macOS / Windows (WSL) | 终端中使用，轻量灵活 |
简单来说：
– 如果你习惯用图形界面，装 Codex Desktop
– 如果你是终端重度用户，装 Codex CLI
– 两者都需要 OpenAI API Key 或兼容的第三方 API 来调用模型
Windows 安装 Codex Desktop 桌面版
系统要求
– 操作系统：Windows 10（1809 及以上）或 Windows 11
– 内存：建议 4GB 以上
– 硬盘：至少 500MB 可用空间
– 网络：能访问 OpenAI API 端点（后面会讲怎么解决网络问题）
– 运行时：Microsoft Visual C++ Redistributable（2015-2022）
安装 Visual C++
Codex Desktop 基于 Electron 框架，在 Windows 上需要 VC++ 运行时支持。
下载地址：[Microsoft 官方下载页]
下载 x64 版本，双击安装即可。
💡 小技巧：如果你已经装过 Visual Studio 或其他大型软件，VC++ 运行时可能已经存在了。可以跳过这步，如果后面启动报错再回来装。
下载 Codex Desktop
直接进入官方网站下载即可
1. 双击下载好的 .exe 安装包
2. 如果弹出 Windows Defender SmartScreen 警告，点击 **”更多信息”** → **”仍要运行”**
3. 按照安装向导点击 **”下一步”** 完成安装
4. 安装完成后，从桌面或开始菜单启动 Codex Desktop
首次启动配置
1. 登录账户：使用你的 OpenAI 账户登录（如果有的话）
2. 选择模型提供商：
– 如果你使用 OpenAI 官方 API，填入你的 API Key
– 如果你使用第三方 API（推荐，后面会讲），填入对应的 Base URL 和 Key
Linux 安装 Codex CLI 命令行版
系统要求
– 操作系统：Linux（Ubuntu 20.04+、Debian 11+、CentOS 7+ 等主流发行版）
– Node.js：版本 22 或更高
– Git：版本 2.28 或更高
– 网络：能访问 API 端点
安装 Node.js 22+
Codex CLI 要求 Node.js 22 及以上版本。推荐使用 nvm（Node Version Manager）来管理 Node 版本。
安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
安装完成后，重新加载 shell 配置：
source ~/.bashrc # 或 source ~/.zshrc
安装 Node.js 22
nvm install 22
nvm use 22
nvm alias default 22
验证安装：
node -v
# 应输出 v22.x.x
npm -v
# 应输出 10.x.x 或更高
💡 小技巧：如果你不想用 nvm，也可以直接通过系统包管理器安装。以 Ubuntu 为例：
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
安装 Codex CLI
使用 npm 全局安装：
npm install -g @openai/codex
安装完成后验证：
codex --version
# 应输出 codex-cli 0.x.x
配置 API Key
Codex CLI 需要 API Key 来调用模型。你可以配置 OpenAI 官方 Key，也可以配置兼容的第三方 Key。
CC Switch 是什么？为什么要用它？
问题背景
无论是 Codex Desktop 还是 Codex CLI，都需要调用 AI 模型的 API。然而：
1. OpenAI 官方 API 价格较高，对国内用户来说还有网络访问的障碍
2. Claude Code（Anthropic 的编程代理）也需要 API 访问，且价格同样不菲
3. 你可能同时使用多个 API 提供商，需要灵活切换
CC Switch 是什么
[CC Switch] 是一个 API 路由转发工具，它的核心功能是：
– 🔀 统一入口：将 Claude Code 和 Codex 的 API 请求转发到你选择的第三方兼容 API 提供商
– 💰 大幅降低成本：使用国内中转 API 服务，价格通常只有官方的 1/10 到 1/3
– 🌐 解决网络问题：通过国内中转，无需科学上网即可使用
– 🔄 多提供商切换：在配置文件中轻松切换不同的 API 服务商
工作原理
A[“Codex Desktop / CLI”] –> B[“CC Switch\n(本地代理)”]
C[“Claude Code”] –> B[“CC Switch\n(本地代理)”]
B –> D[“第三方 API 提供商”]
B –> E[“OpenAI 官方 API”]
B –> F[“其他兼容 API”]
简单来说，CC Switch 在本地启动一个代理服务，Codex 和 Claude Code 的请求先发给 CC Switch，再由 CC Switch 转发到实际的 API 端点。
CC Switch 安装与配置
CC Switch 支持 Windows、macOS 和 Linux 三个平台。
根据你的系统下载对应版本：
| 平台 | 下载文件 |
|——|———-|
| Windows | CC-Switch-v{version}-Windows.msi 或者 CC-Switch-v{version}-Windows-Portable.zip |
| Linux | CC-Switch-v{version}-Linux-arm64.deb |
| macOS | CC-Switch-v{version}-macOS.dmg 或者 CC-Switch-v{version}-macOS.tar.gz |
Windows 安装 CC Switch
双击下载的msi文件即可
Linux 安装 CC Switch
sudo dpkg -i CC-Switch-v*-Linux-arm64.deb
如果有依赖缺失，修复依赖
sudo apt-get install -f
验证安装
cc-switch --version
配置 CC Switch 路由 Claude Code
Claude Code 是 Anthropic 推出的终端编程代理，它支持通过环境变量 ANTHROPIC_BASE_URL 将请求转发到兼容的 API 端点。codex也是一样。
打开cc switch 之后，在顶部的一排有：Claude Code 、Claude Desktop 、Codex 等等代理，选择你要使用的工具即可。比如codex，选中之后，点击最右边的加号，选择其中的供应商，比如deepseek，然后在下方的：
供应商名称： 你自己可以随意设置，并且最好写明你要使用的具体的模型的版本，cc switch 不支持直接在codex 里面切换同一家该供应商的不同版本的模型。如Zhipu GLM 5.2。表示这个路由是使用的glm 5.2模型。
API Key处填写你在对应供应商的api key即可
默认模型：添写你要使用的模型
点击保存即可
之后点击左上角的设置，在路由模块下开启本地路由下面的
在主页面显示本地路由开关
路由总开关
两个设置，并且选择路由启用下的其中一个工具，比如你要路由的是codex就开启codex即可
之后点击其中一个模型配置即可（右边有测试连接的）
