Codex CLI

手动安装

如果本机还没有 codex 命令，先按系统安装 Codex CLI；已经安装过的用户可以直接进入手动接入。

可以从 Node.js 官网下载安装程序；使用包管理器时，从下面任选一种：

winget install OpenJS.NodeJS.LTS

choco install nodejs-lts

scoop install nodejs-lts

重新打开终端：

node -v
npm -v

如果 npm 连接较慢，可以先切换镜像源；不需要时直接安装。

npm config set registry https://registry.npmmirror.com

npm install -g @openai/codex@latest

codex --version

可以从 Node.js 官网下载安装程序；使用 Homebrew 时，也可以执行：

brew install node

node -v
npm -v

如果 npm 连接较慢，可以先切换镜像源；不需要时直接安装。

npm config set registry https://registry.npmmirror.com

npm install -g @openai/codex@latest

也可以使用 Homebrew cask 安装：

brew install --cask codex

codex --version

可以从 Node.js 官网选择适合发行版的安装方式；也可以使用 NodeSource。安装后继续：

node -v
npm -v

如果 npm 连接较慢，可以先切换镜像源；不需要时直接安装。

npm config set registry https://registry.npmmirror.com

npm install -g @openai/codex@latest

codex --version

手动接入

没有使用 CC Switch 时，在用户级 .codex 目录写入 config.toml 和 auth.json：config.toml 负责 provider、model 和 Base URL，令牌保存在同目录的 auth.json。不要写到项目内的 .codex/config.toml。

创建并进入配置目录。
cmd
```
mkdir %USERPROFILE%\.codex
cd %USERPROFILE%\.codex
```
bash
```
mkdir -p ~/.codex
cd ~/.codex
```
bash
```
mkdir -p ~/.codex
cd ~/.codex
```

新建或更新 config.toml。

base_url 使用 OpenAI 兼容地址，结尾保留 /v1。

model_provider = "qiuqiutoken"
model = "gpt-5.4"
model_reasoning_effort = "xhigh"
network_access = "enabled"
disable_response_storage = true

[model_providers.qiuqiutoken]
name = "OpenAI"
base_url = "https://api.qiuqiutoken.net/v1"
wire_api = "responses"
requires_openai_auth = true

新建或更新 auth.json。

将 sk-your-token 替换为 Codex 对应分组令牌。
json
```
{
"OPENAI_API_KEY": "sk-your-token"
}
```
关闭所有 Codex 相关终端窗口，重新打开终端后进入项目启动。
cmd
```
cd your-project-folder
codex
```
bash
```
cd your-project-folder
codex
```
bash
```
cd your-project-folder
codex
```