现在位置: 首页 / 免费干货 / 正文

Codex 安装配置全攻略：Windows/Mac + CC-Switch/CC-GUI 第三方设置

Codex 这东西吧，说实话，就是个全能型的AI助手——能看文件、能改代码、能跑命令，完了还能把结果解释给你听。对AI小白来说，第一次接触它，根本不用先学一堆编程术语。你只要记住一个最简单的用法：把事情说清楚，让Codex先看看现场，然后一步步让它做就完了。

优先装桌面 App

现在的Codex早就不只是一个命令行工具了。对刚入门的用户，我倒是更建议从桌面App开始。为啥这么说？因为桌面App的心理负担最低啊，对吧。你要是后面想玩得更深，再去补CLI和IDE插件也不迟。

可以按这个顺序理解：

  1. 桌面 App：最适合小白入门，跟打开个普通软件没区别。
  2. IDE 插件：适合已经在VS Code、Cursor这类编辑器里写代码的人。
  3. 终端 CLI：适合愿意用命令行的，自动化和工程能力强不少。
  4. 云端任务：适合把那种比较长、比较独立的任务丢给Codex异步处理。

这些后面配置有教程！

Windows 安装

1、命令行CLI

确保你装了Node.js，然后装或更新Codex CLI就行：

npm install -g @openai/codex

启动也简单：

codex

如果你明确知道自己在干嘛，也可以跳过权限确认：

codex --dangerously-bypass-approvals-and-sandbox

2、官方 codex app

第一步，打开OpenAI官方的Codex App页面，下载Windows版本安装包。地址：https://openai.com/zh-Hans-CN/codex

千万别从不明网盘、群文件、二次打包站下载。 你想啊，AI工具能读你本地文件的，安装来源一定要干净。第二步，双击安装包，按提示完成安装就行。

Mac 怎么安装

Mac用户的话，同样建议先从官方Codex App页面下载Mac版本。地址：https://openai.com/zh-Hans-CN/codex

流程差不多：下载后打开安装文件，把Codex拖进“应用程序”，然后从启动台或应用程序文件夹打开。第一次打开时，macOS可能会提示确认来源、权限或登录，按系统提示完成就行。

打开Codex后，同样用ChatGPT/OpenAI账号登录，再选个测试文件夹开始。如果你想走命令行路线，Mac上有两种常见方式。有Homebrew的用户，可以试试：

brew install --cask codex

强烈推荐 CC Switch 使用

CC Switch这东西，用来管理Claude Code的多套环境配置，比如官方、不同中转站、不同Token。适合不想手动改环境变量的用户。官网：https://ccswitch.io/zh/

打开之后长这样（最底部） wind系统下载：CC-Switch-v3.12.3-Windows-Portable.zip mac系统下载：CC-Switch-v3.12.3-macOS.dmg

下载安装完之后就能配置使用了，以我的站点为例：

  1. 访问站点登录 https://ai.bearjia.cn/，确保有余额或者有订阅
  2. 新建一个 API key

  • 名称随便填
  • 分组的话，如果你是订阅用户，选订阅的分组；不是的话，选自己需要的分组就行

  1. 右边操作列【导入到 CCS】，也就是我们前面下载的CC-Switch这个软件

点击启用就完事了！！！ 每次切换配置文件启用的时候，需要重新打开codex app——也就是说，先完全退出codex——>切换——>再打开codex。里面的具体配置：确保URL和Key正确✅

配置第三方的使用方法

PS：本教程说明第三方可用，但第三方插件出现的不稳定性跟本站点无关，优先建议用codex cli或者codex app

CC-GUI

最近这个插件有点小火，很多博主在推，我自己也在用。总体使用体验还是不错的，第一个兼容IDEA的插件啊，当然VS Code也能用

  1. 先装插件，不多说了，确保自己有node.js环境
  2. 开始配置。如果你用cc-switch启用了，可以默认读到本地cli的配置，直接就可用

没有的话，自定义也可以。URL和key正确就行

VS Code系列的codex插件

这个读取的还是跟codex app和codex cli一样的本地配置，所以前面配置好了，这里直接就能用

VS Code 系列API 调用插件

目前最早出来的、能接入第三方中转站的AI插件主要有三个：

  • Cline
  • Roo Code
  • Kilo Code（Roo Code的fork版本）

安装步骤

  1. 在VS Code中搜索Kilo Code或RooCode，安装完成
  2. 安装后，打开Roo Code或者三个插件中的任意一个
  3. 选择配置提供商，新增一个OpenAI Compatible的供应商。供应商也可以选其他的，比如Kimi、Qwen等，如果你有官方的API Key也能直接使用。

站点配置如下：

OpenAI 兼容接口的 IDE 客户端

目前有TRAE CN等软件支持自定义的OpenAI Base URL，这里就以它为例

同样的，填写这三个：

Cursor助手搭配 cursor 使用

这个我也用过，总体来说还是可以的。作者更新得挺频繁的，而且提供了很详细的文档，直接参考作者的说明就行。文档地址：https://dcne38qm5vlg.feishu.cn/wiki/JeP7wdGnziBXuikNaF5czWbrn8c

针对站点的配置：

  • 模型标识：跟官方一样
  • 显示名称：自己随便填，能区分就行。我一般就是gpt-5.5-bearjia
  • 访问密钥：就是站点的API key

FAQ

Codex 桌面 App 和 CLI 有什么区别？

桌面App适合新手，图形界面操作简单；CLI适合有命令行基础的用户，自动化和工程能力更强。新手的话，我建议从桌面App开始。

CC-Switch 能管理哪些配置？

CC-Switch可以管理Claude Code的多套环境配置，包括官方API、不同中转站的Token和URL，省得你手动改环境变量。

第三方插件配置不稳定怎么办？

优先用Codex CLI或官方App。第三方插件的不稳定性跟本站点无关，确保URL和API Key正确就行。