Codex CLI 安装教程

本页只讲安装：先安装 Codex CLI，再安装 CC Switch 桌面应用。安装完成后，再去「中转站配置」页面，把 Codex 接入 HRET API。

先安装，再配置

不要在安装页里找 API 密钥配置。Codex 的 API 密钥、模型和 CC Switch 都放在「Codex CLI → 中转站配置」里讲。

安装前确认

Codex CLI 需要 Node.js 和 npm。先确认本机已经能运行下面两个命令：

Terminal

node --version
npm --version

安装 Codex CLI

在终端执行安装命令：

Terminal

npm install -g @openai/codex

检查是否安装成功

安装后查看版本号。能看到版本号，就说明 codex 命令已经可用。

Terminal

codex --version

安装 CC Switch App

CC Switch 是后面一键配置中转站要用的桌面应用，不是 HRET API 页面里的按钮本身。这里的 App 指 CC Switch 桌面应用；Codex CLI 本身已经在上一步用 npm 安装。如果电脑上还没有 CC Switch，先去 GitHub Releases 下载对应系统的安装包。

下载哪个文件？

Windows 一般下载 .msi，macOS 下载 .dmg，Linux 按自己的发行版选择对应安装包。下载后按系统提示安装即可。

下一步

安装完成后，继续打开 Codex CLI 中转站配置，用 HRET API 的 API 密钥和 CC 切换完成接入。