安装与准备
Codex CLI 是 OpenAI 官方的 AI 编程助手命令行工具，基于 GPT-4 模型。
⚠️ 前置条件（必须满足）
在开始安装之前，请确保您已具备以下条件：
系统要求
账号准备
- 官方登录方式：OpenAI 账号（ChatGPT 账号）
- 自定义供应商方式：第三方 API 供应商的端点与密钥
网络环境
- 官方登录需可访问
chatgpt.com（或auth.openai.com） - 自定义供应商需可访问对应 API Endpoint
- 或配置了可用的代理服务器
重要提醒
如果您无法满足上述任何一个条件，请先解决相关问题再继续安装。
快速安装
1. 安装 Codex CLI
bash
npm install -g @openai/codex2. 验证安装
bash
codex --version安装成功标志
如果能正常输出版本号，说明 CLI 安装成功。接下来请在下方选择配置方式。
配置方式（通过 CC Switch）
- 打开 CC Switch，选中Codex，点击右上角
+号
- 预设选择
OpenAI Official，然后点击添加
- 鼠标移到刚添加的供应商上面，点击启用
- 在终端中执行codex
- 选择第一个
- 此时会弹出登录页，自行登录即可
- 回到终端，看到这个就是成功了，点击回车
- 跟codex打个招呼吧
配置文件写入位置：
| 文件 | 说明 |
|---|---|
~/.codex/auth.json | OAuth tokens（access_token、refresh_token） |
~/.codex/config.toml | 官方端点与模型设置 |
推荐使用
官方登录方式无需手动管理 API Key，认证信息由客户端自动维护，更加安全便捷。
快速切换
CC Switch 支持保存多个供应商配置，切换时只需点击「启用」按钮。切换配置后需重启 Codex CLI 才能生效。
审批模式
Codex CLI 有三种审批模式控制操作确认：
| 模式 | 说明 |
|---|---|
suggest | 默认模式，所有操作需要确认 |
auto-edit | 文件编辑自动执行，命令需确认 |
full-auto | 所有操作自动执行 |
bash
# 全自动模式
codex --full-auto "重构这个函数"注意
full-auto 模式会自动执行命令，请在安全环境中使用。
常用参数
| 参数 | 说明 |
|---|---|
--model | 指定模型（默认 o4-mini） |
--full-auto | 全自动模式，无需确认 |