在 Ubuntu 24.04 系统上安装并使用 Codex CLI

在 Ubuntu 24.04 系统上安装并使用 Codex CLI

前言

在命令行环境中使用 AI 辅助编程工具，能够极大提升开发效率。Codex CLI 是 OpenAI 推出的命令行编码智能体，能够通过自然语言提示帮助你生成代码、重构、执行命令、分析项目。以下指南适用于 Ubuntu 24.04 系统，展示如何使用 nvm 安装 Node.js，再用 npm 全局安装 Codex CLI 并验证安装。

一、准备环境：安装 nvm 并切换 Shell 环境

我们首先安装 Node.js 版本管理工具 nvm（Node Version Manager），然后使用它来安装 Node.js。这样做的好处是便于切换多个版本并保持环境整洁。

bash 复制代码

# 下载并运行 nvm 安装脚本
curl -o‑ https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

# 使 nvm 脚本立即生效（无需重启 shell）
\. "$HOME/.nvm/nvm.sh"

说明：

上述脚本从官方仓库下载并运行 nvm 安装脚本。

然后我们用 \. "$HOME/.nvm/nvm.sh" 来加载 nvm 到当前 shell 环境，从而立即可用。

安装完成后，建议检查 ~/.bashrc 或 ~/.zshrc 是否已包含 nvm 初始化代码（nvm 安装脚本一般会自动添加）。

如果你以后在新终端中仍无法使用 nvm，可能需要手动 source ~/.bashrc 或重启终端。

二、使用 nvm 安装 Node.js

安装好 nvm 之后，我们使用它来安装 Node.js 的指定版本（例如最新版 25 系列）。

bash 复制代码

# 安装 Node.js 版本 25
nvm install 25

# 验证 Node.js 是否安装成功
node -v   # 应该输出像 "v25.1.0" 这种格式
npm -v    # 应该输出 npm 的版本号，例如 "11.6.2"

说明：

本示例使用 Node.js 25（如用户示例中所写）。你也可以使用其它版本，只要满足工具的最低要求。

根据官方文档，Codex CLI 要求 Node.js 版本 22 或以上 才能正常运行。([API易-帮助中心 - AI大模型 API聚合平台为您服务][1])

如果你已经使用 nvm install 25，但 node -v 仍显示旧版本，你可能需要执行 nvm use 25，并用 nvm alias default 25 设置默认。

若网络或镜像有问题（尤其在国内环境），建议使用淘宝、清华等镜像同步 Node.js 或 npm 镜像。

三、通过 npm 全局安装 Codex CLI

在 Node.js 环境可用之后，就可以安装 Codex CLI。

bash 复制代码

# 通过 npm 全局安装 Codex CLI
npm i -g @openai/codex

说明：

安装命令来自官方：npm install -g @openai/codex。([developers.openai.com][2])

如果出现权限错误（如 EACCES），建议不要长期使用 sudo npm install -g，而是修复 npm 全局安装目录的权限，或者使用用户目录方式安装。([CSDN][3])

在国内网络环境，可能需要配置 npm 镜像或代理，以便顺利下载安装包。

四、确认是否安装成功

安装完成后，可以运行以下命令来验证是否安装成功，并查看版本号。

bash 复制代码

codex --version  # 例如输出 "0.42.0"

说明：

若命令无响应或未找到 codex，请确认全局安装路径是否在 PATH 中。

安装成功后，首次运行 codex 时，工具通常会提示你进行认证（例如登录或设置 API Key）以使用其功能。([developers.openai.com][2])

如果你看到版本号输出（如 0.42.0）即说明安装过程已正确执行。

五、配置与使用：API Key、模式与初步使用

5.1 配置 OPENAI_API_KEY

为了让 Codex CLI 能够调用 OpenAI 模型生成代码，你需要配置你的 API 密钥。通常做法是在 shell 配置文件中添加：

bash 复制代码

export OPENAI_API_KEY="你的‑OpenAI‑API‑密钥"

然后重新加载终端或运行 source ~/.bashrc（或 ~/.zshrc）。很多教程也建议将其加入 ~/.bash_profile、~/.zshrc。([API易-帮助中心 - AI大模型 API聚合平台为您服务][1])

5.2 模式（approval‑mode）说明

Codex CLI 提供几种不同的自主级别模式，允许你控制 AI 对代码的操作权限：([CSDN][4])

模式	描述	适合场景
suggest（默认）	AI 提出建议，需要你手动确认修改或命令	从熟悉工具、初次使用时推荐
auto‑edit	AI 自动修改文件，shell 命令仍需确认	想快速修改代码但仍保留监督
full‑auto	AI 自动读写文件、执行命令（沙箱模式）	高度自动化场景，但建议在 Git 仓库且有备份时使用

使用示例：

bash 复制代码

codex "重构 Dashboard 组件为 React Hooks 写法"
codex --approval-mode auto-edit "将全部 .js 文件转换为 .tsx 并添加类型注释"
codex --approval-mode full-auto "生成一个完整的 TODO 应用，并运行测试"

5.3 初次运行

安装、配置完成后，你可以尝试在任意代码项目根目录运行：

bash 复制代码

codex

然后输入你的自然语言提示，例如：

"分析这个项目中所有未用的依赖并生成报告"

"为 src/utils/createUser.ts 编写单元测试"

工具会读取项目、提出建议或修改，并显示差异。你可以审核后应用。

在 Ubuntu 24.04 系统上安装并使用 Codex CLI