OpenAI Codex 完整下载+安装+CC-Switch联动配置（国内可用版）

前置说明

Codex 是 OpenAI 代码专用AI，分 桌面客户端 Codex Desktop + 终端 Codex CLI；国内无法直连OpenAI官方接口，必须搭配 CC-Switch本地代理 做协议转发，才能接入DeepSeek、中转API、本地Ollama等模型。
完整链路：Codex → CC-Switch(127.0.0.1:15721) → 第三方API服务商

一、Codex 下载安装（全平台）

方式1：桌面App安装（最推荐，可视化操作）

---

**Windows:**：https://pan.quark.cn/s/1ed5727cd602

---

• Windows：Codex-Desktop-x.x.x.msi 双击安装，路径默认C盘
• macOS：.dmg 镜像，拖入应用程序
• Linux：.deb / .AppImage

3. 打开报错拦截处理
   Windows：更多信息→仍要运行
   macOS终端执行：

xattr -d com.apple.quarantine /Applications/Codex.app

方式2：Codex CLI（终端命令行，程序员首选）

全局一键安装

# 全平台通用
npm install -g @openai/codex

# Mac Homebrew备选
brew install codex

验证安装成功：

codex --version

二、CC-Switch 提前安装（必须先装，核心中转）

安全下载渠道

GitHub Releases：https://github.com/farion1231/cc-switch/releases
Assets内对应系统包：

• Windows：.msi安装版 / Portable.zip绿色版
• macOS：Universal.dmg

CC-Switch基础初始化

1. 打开软件，顶部切换到 Codex 标签页
2. 左上角开启本地代理Proxy（端口默认15721，绿色运行）

三、CC-Switch 配置Codex对接（核心步骤）

步骤1：添加API服务商（DeepSeek/中转API/Ollama任选）

1. Codex标签页 → 右侧 +新增服务商
2. 选择预设模型（例DeepSeek），或自定义中转
   | 配置项 | 填写规范 |
   |--------|----------|
   | 供应商名称 | 自定义备注（DeepSeek/中转平台） |
   | Base URL | 平台提供接口地址，结尾不加/v1 |
   | API Key | 平台后台生成sk密钥 |
   | 模型名称 | deepseek-coder-v2 / gpt-4o-codex等 |
   | 开启本地路由 | ✅ 勾选（自动适配Codex专属Responses协议） |
3. 保存，右侧点击启用，状态Active

步骤2：开启Codex专属路由

1. CC-Switch右上角设置 → 路由Routing
2. 打开「Codex路由接管」开关
3. 确认端口：127.0.0.1:15721，无端口占用即可

步骤3：CC-Switch自动同步Codex配置文件

保存服务商后，软件自动写入Codex本地配置：

• Windows路径：C:\Users\用户名\.codex\config.toml
• Mac/Linux路径：~/.codex/config.toml
  无需手动修改文件，重启Codex即可生效

四、Codex 启动与验证配置

1. CLI终端验证（最准）

打开终端执行：

codex

出现对话窗口，顶部model显示你在CC-Switch启用的模型名，提问能正常返回代码=配置成功

2. Codex桌面端验证

1. 完全关闭Codex、CC-Switch，重新打开CC-Switch再开Codex
2. 右下角模型下拉框，选择你添加的模型
3. 发送代码提问，正常回复即链路打通

五、手动配置方案（CC-Switch失效备用）

如果不想用CC-Switch，手动修改Codex配置文件

1. 新建/编辑 ~/.codex/config.toml

openai_base_url = "http://127.0.0.1:15721/v1"
model = "deepseek-coder-v2"
sandbox_mode = "workspace-write"
web_search = "disabled"
[model_providers.custom]
api_key = "你的API密钥"

2. 新建 auth.json

{"OPENAI_API_KEY":"你的密钥"}

六、常见报错解决

1. 连接超时/请求失败

• 检查CC-Switch代理是否开启，端口15721未被占用
• Base URL末尾不要带多余斜杠，API Key复制完整
• 切换手机热点重试网络

2. Codex识别不到自定义模型

• CC-Switch勾选「Codex本地路由」，保存后重启Codex

3. 端口占用15721

• CC-Switch设置内修改代理端口，保存重启软件

4. macOS打开Codex提示损坏
   终端执行隔离解除命令

xattr -cr /Applications/Codex.app

补充区分：Codex vs Claude Code

• Codex：OpenAI 代码工具，适配GPT系列代码模型，用CC-Switch走Responses协议转发
• Claude Code：Anthropic工具，适配Claude系列，CC-Switch单独Claude标签配置，两者不互通