VibeAPI

安装 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 表示成功。

终端显示安装进度,最后出现 added x packages

验证:

codex --version

终端输出版本号

CC Switch 已经把 VibeAPI 配置写好了,直接运行 codex 即可对话,无需登录 OpenAI。


VSCode 插件(可选)

  1. 打开 VSCode
  2. Ctrl+Shift+X(macOS: Cmd+Shift+X)打开扩展面板
  3. 搜索 OpenAI Codex
  4. 找到 OpenAI 官方发布的扩展,点击「安装」

VSCode 扩展面板:搜索 OpenAI Codex,点击「安装」

插件自动读取 CC Switch 写好的 ~/.codex/ 配置,无需额外操作。

不要在插件内登录 OpenAI 账号。


桌面版(可选)

macOS

从 OpenAI 官网下载 .dmg,拖入 Applications 文件夹。

Windows

打开终端输入:

winget install OpenAI.Codex

或在 Microsoft Store 搜索 "Codex" 安装。

Windows:winget 安装 Codex 或从 Microsoft Store 安装

桌面版同样读取 CC Switch 写好的配置,无需额外操作。

不要登录 OpenAI 账号。


如果误操作登录了官方账号

CLI、VSCode 插件、桌面版三者共享同一个配置目录(~/.codex/)。在 CC Switch 中重新同步 VibeAPI 配置即可覆盖,一次操作三者全部生效。

详见 FAQ:已登录官方账号怎么切回 VibeAPI