Skip to content

安装与准备

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/codex

2. 验证安装

bash
codex --version

安装成功标志

如果能正常输出版本号,说明 CLI 安装成功。

审批模式

Codex CLI 有三种审批模式控制操作确认:

模式说明
suggest默认模式,所有操作需要确认
auto-edit文件编辑自动执行,命令需确认
full-auto所有操作自动执行
bash
# 全自动模式
codex --full-auto "重构这个函数"

注意

full-auto 模式会自动执行命令,请在安全环境中使用。

常用参数

参数说明
--model指定模型(默认 o4-mini)
--full-auto全自动模式,无需确认

相关链接