Codex CLI 快速上手

OpenAI 代码生成工具，支持 GPT 系列模型和可配置推理深度。三步完成：安装 → 配置 API → 启动。桌面应用用户请看 Codex 桌面端配置。

步骤一：安装

安装 Git

Codex CLI 依赖 Git。Windows 用户建议安装 Git for Windows，其他系统确保终端里可直接使用 git 即可。

下载地址：Git for Windows

git --version

安装 Node.js

Codex CLI 依赖 Node.js 18+ 和 npm。

下载地址：Node.js LTS，选 LTS 长期支持版。

node -v && npm -v

安装 Codex CLI

npm install -g @openai/codex

验证：

codex --version

步骤二：配置 API

使用前请关闭 CC Switch 的路由模式；保存后直接打开 Codex 发消息验证，不要依赖 CCS 的「检测」按钮。查看完整提醒。

准备令牌

1. 打开 模型广场，用「分组」筛选 codex，确认可用模型（当前为 gpt-5.6-sol、gpt-6-astra、gpt-6-sol）。
2. 在 控制台 · 令牌 新建令牌，分组选 codex（倍率 0.2x）或更稳定的 codex-wending（0.35x），关闭「模型限制」。
3. 复制 API Key 备用。

用 CC Switch 配置

完整步骤、Linux 安装方式见 CC Switch 统一配置。在它之上，Codex 只需注意：

1. 框架选 Codex（不是 Claude Code）。
2. 预设供应商选 「自定义配置」，名称填 Vmvia。
3. 请求地址填 https://www.vmvia.com/v1，带 /v1 后缀，与 Claude Code 不同。
4. 填 API Key，model 推荐 gpt-5.6-sol。
5. CC Switch 会自动写入 ~/.codex/config.toml 和 auth.json，重启终端。

手动配置（config.toml / auth.json）仅在排障或高级自定义时使用，见 配置参考。

使用提醒：请关闭 API 令牌的「模型限制」。如果后台自动审批反复失败，说明审批请求使用的模型不在分组内，按 自动审批设置 关闭审批或映射模型。

步骤三：启动

codex

推理深度

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

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

下一步

会话异常：如果使用 Codex 桌面端时出现会话异常，可右键当前会话 →「分叉」→「创建聊天分支」，在新分支中重试。图示见 会话异常时创建聊天分支。

页面	内容
CC Switch 统一配置	默认配置入口、分组与模型对应关系
配置参考	config.toml 详解、模型列表、常见问题
Codex 桌面端配置	桌面应用的配置与审批设置