Codex CLI 快速上手

OpenAI 的代码生成工具，基于 GPT 系列，支持可配置推理深度。三步完成：安装 → 配置 → 启动。

步骤一：安装

需要 Node 18+，然后全局安装 Codex CLI：

npm install -g @openai/codex
codex --version

步骤二：配置 API

用 CC Switch 配置（推荐）

CC Switch 会自动写入 ~/.codex/config.toml 和 auth.json，无需手动编辑文件。

1. 打开 CC Switch，"添加配置"，框架选 Codex（不是 Claude Code）
2. 请求地址（Base URL）填 https://ai.kektoken.com/v1
3. 填 API Key（使用 GPT 分组的密钥，如 vip2 / vip2_pro）
4. model 推荐填 gpt-5.5
5. 点 "添加" → 重启终端

Base URL 要带 /v1

Codex 的请求地址需要 /v1 后缀（https://ai.kektoken.com/v1）， 和 Claude Code（不带 /v1）不同。

密钥分组要选 GPT 类（vip2 / vip2_pro），不要用 Claude 分组。 详见 令牌分组速查。

手动配置（仅排障时用）

CC Switch 不可用时，可手动编辑配置文件。

文件位置

系统	config.toml	auth.json
Windows	C:\Users\<用户名>\.codex\config.toml	C:\Users\<用户名>\.codex\auth.json
macOS / Linux	~/.codex/config.toml	~/.codex/auth.json

config.toml

model_provider = "kek"
model = "gpt-5.5"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.kek]
name = "kek"
base_url = "https://ai.kektoken.com/v1"
wire_api = "responses"
requires_openai_auth = true

auth.json

{
  "OPENAI_API_KEY": "sk-你的密钥"
}

步骤三：启动

codex

推理深度

通过 model_reasoning_effort（在 ~/.codex/config.toml 中设置）控制推理深度：

取值	速度	适用场景
low	快	简单代码生成、快速问答
medium	中	日常开发任务（推荐）
high	慢	复杂算法、架构设计

支持的模型

模型	说明
gpt-5.5	推荐，能力最强
gpt-5.4	平衡
gpt-5.4-mini	轻量快速
gpt-5.3-codex	代码专用
gpt-5.2	基础

下一步

• CC Switch 统一配置
• 令牌分组速查
• 报错与踩坑