Codex CLI 安装教程

如果你准备使用 GPT / Codex 系列模型，也可以提前把 Codex CLI 安装好。装完后同样可以通过 CC-Switch 接入 NextHub。

安装步骤

1. 确认 Node.js 环境

Codex CLI 同样需要 Node.js 环境，建议先检查版本：

node -v
npm -v

2. 全局安装 Codex CLI

在终端执行以下命令安装 Codex：

npm install -g @openai/codex

3. 验证 Codex 是否安装成功

执行下面命令，能正常输出版本号或启动 Codex 即可：

codex --version
codex

接入方式一：CC-Switch（推荐）

安装完成后，直接继续 CC-Switch 教程即可。在 CC-Switch 里选择 Codex，请求地址填 https://api.nexthub.cc/v1（OpenAI Responses 协议需带 /v1），再填入你的 ApiKey，就能走 GPT-Azure 分组（0.47x）使用。

接入方式二：手动配置

不想用配置工具的话，手动编辑 Codex 的两个配置文件即可。

1. 打开 Codex 配置目录

Windows (CMD)

start "" "%USERPROFILE%\.codex"

macOS (Terminal)

open "$HOME/.codex"

目录里没有对应文件就手动创建。

2. 配置 config.toml

将以下内容写入 ~/.codex/config.toml：

model = "gpt-5.6"
model_provider = "nexthub"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.nexthub]
name = "nexthub"
base_url = "https://api.nexthub.cc/v1"
wire_api = "responses"
requires_openai_auth = true

请求地址要带 /v1

Codex 走 OpenAI Responses 协议（/v1/responses），base_url 需要带 /v1。model 按需填写 GPT-Azure / GPT-Pro 分组提供的模型 ID（如 gpt-5.6、gpt-6-astra），以模型广场实时数据为准。

3. 配置 auth.json

将 ApiKey 写入 ~/.codex/auth.json（GPT-Azure 或 GPT-Pro 分组的密钥）：

{
  "OPENAI_API_KEY": "你的 NextHub ApiKey"
}

4. 验证

在终端运行 codex 并发送一条测试消息，界面顶部显示所选模型且能正常回复，即接入成功。

全局提示词

~/.codex/AGENTS.md 是 Codex 的全局提示词文件，没有会自动创建，可按需写入你的工作约定。