Codex 桌面版国内安装与 CC-Switch API 配置教程

Codex App 是 OpenAI 的桌面版 AI 编程助手，可以在你的电脑上选择项目文件夹，然后帮你阅读项目、解释代码、修改文件、运行任务和排查问题。对 0 基础用户来说，最容易出错的地方不是使用，而是第一步就选错版本：Windows 和 macOS 的文件不一样，安装方式也不一样。

这篇文章只讲 Codex App 版本，不讲 Codex CLI。也就是说，你不需要配置命令行 PATH，不需要执行 codex --version，也不需要用 npm 或 Homebrew 安装。本文优先使用你提供的国内网盘下载方式，因为国内用户经常无法直接访问官方下载入口。

一、先判断自己的电脑系统

安装前先确认你用的是 Windows 还是 macOS。

Windows 用户通常会看到“开始菜单”“此电脑”“文件资源管理器”。联想、戴尔、惠普、华硕、微软 Surface 等设备，大多数是 Windows。

macOS 用户通常使用 MacBook、iMac、Mac mini、Mac Studio，屏幕左上角有苹果图标。点击苹果图标，再点“关于本机”，可以看到 macOS 版本和芯片信息。

按下面规则选择：

Windows 电脑：下载 codex-windows-x64 和 CC-Switch-v3.13.0-Windows。
Mac 电脑：下载 codex-macos 和 CC-Switch-v3.13.0-macOS。
不确定：先看左上角有没有苹果图标。有就是 Mac，没有通常是 Windows。

二、下载 Codex App 和 CC-Switch

下面是本文使用的下载资源。网盘里的文件名称要核对清楚，文件名区分了 Windows 和 macOS。

Codex App 安装文件

点击网盘链接后，按你的电脑系统选择 Windows 或 macOS 版本。

Codex App 安装包Windows / macOS · App 完整包 · 通用 · codex提取码AIHG进入网盘后选择适合你的 Windows 或 macOS 版本，再按系统提示安装。

CC-Switch v3.13.0 安装文件

CC-Switch 用来配置和切换 API。进入网盘后按系统选择 Windows 或 macOS 版本。

CC-Switch 安装包Windows / macOS · v3.13.0 · 通用 · skills提取码AIHG进入网盘后选择适合你的 Windows 或 macOS 版本，再按界面提示安装。

如果网盘页面里出现多个文件，按文件名判断：Windows 选 windows-x64 和 CC-Switch-v3.13.0-Windows.msi，Mac 选 macos 和 CC-Switch-v3.13.0-macOS.dmg。

三、Windows 安装 Codex App

Windows 版是完整包。你的重点是“解压到固定位置，然后运行里面的应用”，不要按 CLI 教程去配置环境变量。

1. 下载并解压 Windows 版

从上面的网盘下载：

windows-x64

下载完成后，如果它是压缩包，右键选择“全部解压”或用解压软件解压。解压后会得到一个完整的 Codex App 文件夹。

2. 放到固定位置

建议把解压后的完整文件夹放到固定目录，例如：

C:\Tools\Codex

也可以放在：

D:\Tools\Codex

不要放在微信、QQ、浏览器临时下载目录里，也不要只把某一个 .exe 单独拖出来。完整包里的文件通常需要保持在同一个文件夹内，单独移动可能导致应用无法启动。

3. 启动 Codex App

打开解压后的 Codex 文件夹，找到 Codex 应用程序，通常是类似下面的文件：

Codex.exe

双击启动即可。如果 Windows 弹出安全提醒，先确认文件来自你上面下载的网盘文件，再选择允许运行。

4. 创建桌面快捷方式

为了方便下次打开，可以右键 Codex 应用程序，选择“发送到 - 桌面快捷方式”。以后直接双击桌面快捷方式即可，不需要每次进文件夹查找。

四、macOS 安装 Codex App

macOS 版需要安装，但不需要再从官方下载。你已经通过网盘拿到安装文件，按正常 Mac 应用安装即可。

1. 下载 macOS 版

从上面的网盘下载：

macos

下载完成后，双击打开。如果它是 DMG 或安装包，按界面提示继续。

2. 安装到应用程序

如果打开后看到 Codex 图标和“Applications / 应用程序”文件夹，直接把 Codex 拖到“应用程序”里。

如果打开后是安装向导，就按提示点击继续、安装。安装完成后，到“应用程序”里找到 Codex。

3. 第一次打开

进入“应用程序”，双击打开 Codex。

如果 macOS 提示“无法验证开发者”或阻止打开，可以按下面步骤处理：

打开“系统设置”。
进入“隐私与安全性”。
找到刚刚被拦截的 Codex。
点击“仍要打开”。
再次启动 Codex。

只对你确认来源的文件这样操作，不要随便给陌生软件放行。

五、官方资料里 Codex App 的正确流程

OpenAI 官方文档说明，Codex App 支持 macOS 和 Windows。官方流程是：下载安装 Codex App，打开后用 ChatGPT 账号或 OpenAI API Key 登录，然后选择一个项目文件夹，并确认使用 Local 模式让 Codex 在本机工作。

这里要注意两点：

官方下载页会区分 macOS Apple Silicon、macOS Intel 和 Windows。本文提供的是国内下载方式，下载时仍然要按系统选择。
本文讲的是 App，不是 CLI。CLI 才会涉及终端命令、npm、Homebrew、PATH 等概念，0 基础用户安装 App 不需要走这些步骤。

六、安装 CC-Switch

Codex App 能打开以后，再安装 CC-Switch。CC-Switch 的作用是帮助你管理 API 配置，例如 API Base URL、API Key、模型名称等。这样后面切换不同 API 服务时，不需要反复手动找配置位置。

Windows 安装 CC-Switch

Windows 用户下载：

CC-Switch-v3.13.0-Windows.msi

安装步骤：

双击 CC-Switch-v3.13.0-Windows.msi。
按安装向导点击“下一步”。
安装完成后，从开始菜单打开 CC-Switch。
如果系统弹出安全提示，确认文件名无误后再允许运行。

macOS 安装 CC-Switch

Mac 用户下载：

CC-Switch-v3.13.0-macOS.dmg

安装步骤：

双击打开 CC-Switch-v3.13.0-macOS.dmg。
按界面提示安装，常见方式是拖入“应用程序”。
到“应用程序”里打开 CC-Switch。
如果 macOS 阻止打开，到“系统设置 - 隐私与安全性”里点击“仍要打开”。

七、用 CC-Switch 配置 API

配置 API 前，先准备三样东西：

API Base URL
API Key
Model Name

它们通常来自你购买或开通的模型服务平台。API Key 是密钥，不要发给别人，也不要出现在截图、群聊、论坛或公开仓库里。

1. 打开 CC-Switch 并选择 Codex

打开 CC-Switch 后，先在工具或应用列表中找到 Codex 相关配置。因为本文安装的是 Codex App，所以优先选择 Codex / Codex App 对应项，不要误选成 Claude Code、Gemini CLI 或其他工具。

不同版本的 CC-Switch 界面文字可能略有不同，但核心思路一致：先选工具，再新增或切换 API 配置。

2. 新增一组 API 配置

新建配置时，建议起一个容易识别的名称，例如：

OpenAI API

或者：

我的中转 API

配置名称只是给自己看的备注，不要把 API Key 写进配置名称里。

3. 填写 API Base URL

API Base URL 是接口地址。OpenAI 官方 API 常见格式是：

https://api.openai.com/v1

如果你使用第三方兼容 OpenAI 格式的服务，请填写服务商后台给你的 Base URL。有些服务商地址末尾带 /v1，有些不带，必须以平台说明为准。

4. 填写 API Key

API Key 是密钥，复制时注意不要多复制空格或换行。

填写后不要截图发给别人。如果怀疑泄露，立刻去对应平台后台删除旧 Key，并重新生成。

5. 填写模型名称

模型名称要按服务商后台给出的真实名称填写。不要只凭别人截图照抄，因为不同平台可能会使用不同模型名。

如果使用 OpenAI 官方 API，就按你的账号实际可用模型填写。如果使用第三方中转或兼容平台，就以该平台后台说明为准。

6. 保存并切换配置

填完以后点击保存，然后把当前配置切换到刚刚新增的 API 配置。保存后建议完全退出 Codex App，再重新打开 Codex App，让新配置生效。

八、第一次启动 Codex App

安装和 API 配置完成后，按下面顺序首次使用。

1. 打开 Codex App

Windows 用户双击解压文件夹里的 Codex 应用或桌面快捷方式。

macOS 用户从“应用程序”里打开 Codex。

2. 登录

Codex App 打开后，根据界面提示登录。官方文档说明，可以使用 ChatGPT 账号，也可以使用 OpenAI API Key。使用 API Key 登录时，部分云端线程能力可能不可用。

如果你已经用 CC-Switch 配置了 API，先确认 CC-Switch 当前启用的是正确配置，再回到 Codex App 继续登录或启动。

3. 选择项目文件夹

Codex App 会让你选择一个项目文件夹。0 基础用户建议先新建一个测试文件夹，例如：

codex-test

然后在 Codex App 里选择这个文件夹。不要第一次就选择桌面、下载目录、微信文件目录或重要资料目录。

4. 确认 Local 模式

官方文档提示，选择项目后要确认使用 Local，让 Codex 在你的电脑本机工作。看到 Local 选项时，优先选择 Local。

5. 发送第一条消息

第一次可以问一个低风险问题：

请告诉我这个文件夹里有哪些内容，并说明你能帮我做什么。

如果能正常回答，再测试一个简单任务：

请帮我在当前文件夹里创建一个 hello.txt，内容是“你好，Codex”。

如果 Codex App 在执行前询问是否允许写文件，先看清楚它要操作的位置，确认是测试文件夹后再允许。

九、新手使用建议

Codex App 适合放在项目目录里使用。刚开始不要直接让它“大改项目”或“重构全部代码”，先从低风险任务开始。

可以先问：

请阅读当前项目，并用通俗语言告诉我这个项目是做什么的。

再问：

请找出这个项目应该如何启动，不要修改文件，先告诉我需要运行哪些步骤。

确认它能正确理解项目后，再让它改小范围内容，例如修改一个文档、解释一个报错、补一个简单配置。

十、常见问题

Windows 解压后打不开

先确认你没有只移动单个 .exe。请保留完整解压文件夹，再从文件夹里面启动 Codex 应用。

如果系统提示安全风险，确认文件来自本文提供的 Windows 网盘资源，并确认文件名是 windows-x64 下载解压后的内容。

Windows 是否需要配置环境变量

不需要。本文讲的是 Codex App，不是 CLI。App 直接双击运行，不需要把目录加入 PATH。

macOS 安装后找不到 Codex

到“应用程序”里找 Codex。如果刚刚打开的是 DMG，但没有拖入“应用程序”，请重新打开 DMG，把 Codex 拖入“应用程序”后再启动。

macOS 提示无法打开

进入“系统设置 - 隐私与安全性”，找到被拦截的 Codex，点击“仍要打开”。只对确认来源的安装包这样操作。

CC-Switch 配置后还是不能用

按顺序检查：

CC-Switch 里选择的是不是 Codex / Codex App。
当前启用的是不是刚刚保存的 API 配置。
API Base URL 是否正确。
API Key 有没有多复制空格或换行。
模型名称是否是平台支持的真实名称。
保存配置后有没有完全退出并重新打开 Codex App。
账号余额、额度或服务商状态是否正常。

可以同时安装 Windows 和 macOS 版吗

不需要。你只安装自己电脑对应的版本。Windows 电脑使用 Windows 版，Mac 电脑使用 macOS 版。

十一、安全建议

安装 Codex App 和配置 API 时，记住这几条：

按系统下载，Windows 和 macOS 不要混用。
Windows 解压后保留完整文件夹，不要只移动单个程序文件。
macOS 安装后从“应用程序”打开。
API Key 只保存在本机可信工具里。
不要把 API Key 发给别人，也不要截图。
第一次使用先选择测试文件夹，不要直接操作重要资料。
Codex App 请求写入、删除或覆盖文件时，先看清楚操作位置再确认。

十二、总结

0 基础用户按下面顺序做最稳：

先判断电脑是 Windows 还是 macOS。
Windows 下载 windows-x64，解压后保留完整文件夹，直接运行 Codex App。
macOS 下载 macos，打开安装包完成安装，从“应用程序”启动 Codex App。
下载并安装对应系统的 CC-Switch。
在 CC-Switch 里选择 Codex / Codex App，填写 API Base URL、API Key、Model Name。
保存配置后重启 Codex App。
第一次打开 Codex App，登录，选择测试项目文件夹，确认 Local，然后发送第一条消息。

把安装和 API 配置跑通以后，再把 Codex App 用到真实项目里。先让它读项目、解释项目、找启动方式，熟悉之后再让它修改文件。

参考资料

OpenAI Codex App：https://developers.openai.com/codex/app
OpenAI Codex Quickstart：https://developers.openai.com/codex/quickstart