Codex CLI 快速上手

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

---

步骤一：安装

安装 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 统一管理所有环境的 API 配置。查看 CC Switch 统一配置 →

配置步骤：

1. 打开 CC Switch，框架选Codex
2. 点击"添加配置"，请求地址填写https://duoapi.zeabur.app/v1 （不要以/结尾）
3. 填写 API Key（sk-xxx），model推荐填写gpt-5.4
4. 点击添加，CC Switch 自动写入config.toml和auth.json，重启终端

CC Switch 中的请求地址按上方填写为https://duoapi.zeabur.app/v1 ，末尾不要加/。

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

---

步骤三：启动

codex

推理深度

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

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

---

下一步

页面	内容
CC Switch 统一配置	默认配置入口、渠道与模型对应关系
配置参考	config.toml 详解、模型列表、常见问题
推荐工具	CC Switch、AI Session Viewer