安装与准备
Codex CLI 是 OpenAI 官方的 AI 编程助手命令行工具,基于 GPT-4 模型。
⚠️ 前置条件(必须满足)
在开始安装之前,请确保您已具备以下条件:
系统要求
- Node.js 22+ - 下载地址
- 代理工具(可选) - 网络受限时用于访问 OpenAI 服务(如 Clash、v2rayN 等)
账号准备
- 官方登录方式:OpenAI 账号(ChatGPT 账号)
- 自定义供应商方式:第三方 API 供应商的端点与密钥
网络环境
- 官方登录需可访问
chatgpt.com(或auth.openai.com) - 自定义供应商需可访问对应 API Endpoint
- 或配置了可用的代理服务器
重要提醒
如果您无法满足上述任何一个条件,请先解决相关问题再继续安装。
快速安装
1. 安装 Codex CLI
bash
npm install -g @openai/codex2. 验证安装
bash
codex --version安装成功标志
如果能正常输出版本号,说明 CLI 安装成功。
审批模式
Codex CLI 有三种审批模式控制操作确认:
| 模式 | 说明 |
|---|---|
suggest | 默认模式,所有操作需要确认 |
auto-edit | 文件编辑自动执行,命令需确认 |
full-auto | 所有操作自动执行 |
bash
# 全自动模式
codex --full-auto "重构这个函数"注意
full-auto 模式会自动执行命令,请在安全环境中使用。
常用参数
| 参数 | 说明 |
|---|---|
--model | 指定模型(默认 o4-mini) |
--full-auto | 全自动模式,无需确认 |