安装 Codex
Codex 的多种安装方式:NPM、VSCode 插件、桌面版
如果你还没有完成前置环境配置(Git、Node.js、CC Switch),请先阅读 快速开始。
NPM 命令行版(推荐)
打开终端(Windows: Win+X → 终端;macOS: Cmd+Space 搜索 Terminal),依次输入:
# 配置国内镜像(只需执行一次)
npm config set registry https://registry.npmmirror.com
# 全局安装 Codex
npm install -g @openai/codex等待安装完成,看到 added x packages 表示成功。

验证:
codex --version
CC Switch 已经把 VibeAPI 配置写好了,直接运行 codex 即可对话,无需登录 OpenAI。
VSCode 插件(可选)
- 打开 VSCode
- 按
Ctrl+Shift+X(macOS:Cmd+Shift+X)打开扩展面板 - 搜索
OpenAI Codex - 找到 OpenAI 官方发布的扩展,点击「安装」

插件自动读取 CC Switch 写好的 ~/.codex/ 配置,无需额外操作。
不要在插件内登录 OpenAI 账号。
桌面版(可选)
macOS
从 OpenAI 官网下载 .dmg,拖入 Applications 文件夹。
Windows
打开终端输入:
winget install OpenAI.Codex或在 Microsoft Store 搜索 "Codex" 安装。

桌面版同样读取 CC Switch 写好的配置,无需额外操作。
不要登录 OpenAI 账号。
如果误操作登录了官方账号
CLI、VSCode 插件、桌面版三者共享同一个配置目录(~/.codex/)。在 CC Switch 中重新同步 VibeAPI 配置即可覆盖,一次操作三者全部生效。