MYY中转站文档

Appearance

安装 Codex CLI ​

本文介绍如何在不同操作系统上安装 OpenAI 官方的 Codex CLI 工具。

前置要求 ​

  • ✅ Node.js 18 或更高版本
  • ✅ npm 或 yarn 包管理器
  • ✅ 终端/命令行访问权限

步骤 1：安装 Node.js ​

Windows 安装 ​

方法一：官网下载（推荐）

  1. 访问 Node.js 官网
  2. 点击 LTS 版本下载（长期支持版本）
  3. 下载完成后双击 .msi 文件
  4. 按照安装向导完成安装，保持默认设置

方法二：使用包管理器

使用 Chocolatey 或 Scoop：

powershell
# 使用 Chocolatey
choco install nodejs

# 或使用 Scoop
scoop install nodejs

Windows 注意事项：

  • 建议使用 PowerShell 而不是 CMD
  • 如遇权限问题，以管理员身份运行
  • 部分杀毒软件可能误报，需添加白名单

macOS 安装 ​

方法一：官网下载

  1. 访问 Node.js 官网
  2. 下载 macOS 安装包
  3. 双击 .pkg 文件安装

方法二：使用 Homebrew

bash
brew install node

Linux 安装 ​

Ubuntu/Debian:

bash
# 使用 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

CentOS/RHEL:

bash
# 使用 NodeSource 仓库
curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
sudo yum install -y nodejs

Arch Linux:

bash
sudo pacman -S nodejs npm

验证 Node.js 安装 ​

打开终端运行：

bash
node --version
npm --version

如果显示版本号（Node.js ≥ 18），说明安装成功！

步骤 2：安装 Codex CLI ​

全局安装 ​

打开终端运行以下命令：

bash
npm install -g @openai/codex

使用国内镜像

如果下载速度慢，可以使用国内镜像：

bash
npm install -g @openai/codex --registry=https://registry.npmmirror.com

验证安装 ​

安装完成后运行：

bash
codex --version

应该会显示 Codex 的版本号。

步骤 3：首次运行 ​

第一次运行 Codex 会进行初始化：

bash
codex

Codex 会提示进行配置，先按 Ctrl+C 退出，我们将在下一节配置使用 MYY 中转站。

重要

不要在首次运行时配置官方 API，我们将使用 MYY 中转站的 API！

常见安装问题 ​

问题 1：权限错误 (EACCES) ​

错误信息：

npm ERR! code EACCES
npm ERR! syscall access

解决方案：

Windows:

powershell
# 以管理员身份运行 PowerShell
npm install -g @openai/codex

macOS/Linux:

bash
sudo npm install -g @openai/codex

或配置 npm 使用用户目录（推荐）：

bash
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g @openai/codex

问题 2：Node.js 版本过低 ​

错误信息：

error @openai/codex: The engine "node" is incompatible

解决方案：

升级 Node.js 到 18 或更高版本。

问题 3：网络连接问题 ​

错误信息：

npm ERR! network

解决方案：

使用国内镜像：

bash
npm install -g @openai/codex --registry=https://registry.npmmirror.com

问题 4：命令未找到 ​

错误信息：

codex: command not found

解决方案：

  1. 检查 npm 全局安装路径：
bash
npm config get prefix
  1. 确保该路径在 PATH 环境变量中

Windows PowerShell:

powershell
$env:Path

macOS/Linux:

bash
echo $PATH
  1. 如果不在，添加到 PATH：

Windows:

  • 系统属性 → 环境变量 → Path
  • 添加：C:\Users\你的用户名\AppData\Roaming\npm

macOS/Linux:

bash
echo 'export PATH="$PATH:$(npm config get prefix)/bin"' >> ~/.bashrc
source ~/.bashrc

更新 Codex ​

更新到最新版本：

bash
npm update -g @openai/codex

或重新安装：

bash
npm install -g @openai/codex

卸载 Codex ​

如需卸载：

bash
npm uninstall -g @openai/codex

下一步 ​

安装完成后，继续：

MYY中转站 - 让 AI 工具更易用

Copyright © 2025 MYY中转站