如何在国内安装 Codex CLI？
Node 版本不够怎么办？
Windows 能用吗？
是否支持一键安装？
本教程提供：
- ✅ macOS 一键安装脚本
- ✅ Linux 一键安装脚本
- ✅ Windows PowerShell 安装方法
- ✅ Node.js 自动升级方案
- ✅ 国内稳定使用解决方案
5 分钟完成 Codex CLI 安装与配置。
一、什么是 Codex CLI？
Codex CLI 是 OpenAI 官方推出的命令行 AI 编程工具。
安装后可以在终端中使用：
- 代码生成
- 代码解释
- 自动修复 Bug
- 项目重构建议
- 命令生成
- 脚本编写
官方 npm 包：
@openai/codex
二、Codex CLI 安装前的环境要求
最低要求：
- Node.js >= 20
- npm
检查方法：
node -v
npm -v
如果 Node 版本低于 20，本教程的脚本会自动升级。
三、macOS / Linux 一键安装 Codex CLI 脚本
支持系统：
- macOS（Intel / Apple Silicon）
- Ubuntu / Debian
- CentOS
- Fedora
- Arch Linux
✅ 一键安装命令
bash <(curl -fsSL https://yourdomain.com/install-codex.sh)
✅ 完整安装脚本（Node >=20）
#!/usr/bin/env bash
set -euo pipefail
REQUIRED_NODE_MAJOR=20
maybe_sudo() {
if [[ $EUID -eq 0 ]]; then "$@"
elif command -v sudo >/dev/null 2>&1; then sudo "$@"
else echo "need sudo"; exit 1
fi
}
node_ok() {
if ! command -v node >/dev/null 2>&1 || ! command -v npm >/dev/null 2>&1; then return 1; fi
local v="$(node --version 2>/dev/null || true)"
v="${v#v}"
local major="${v%%.*}"
[[ "$major" =~ ^[0-9]+$ ]] && (( major >= REQUIRED_NODE_MAJOR ))
}
install_node() {
if command -v apt >/dev/null 2>&1 || command -v apt-get >/dev/null 2>&1; then
curl -fsSL https://deb.nodesource.com/setup_20.x | maybe_sudo bash -
if command -v apt >/dev/null 2>&1; then maybe_sudo apt install -y nodejs; else maybe_sudo apt-get install -y nodejs; fi
return
fi
if command -v dnf >/dev/null 2>&1; then
curl -fsSL https://rpm.nodesource.com/setup_20.x | maybe_sudo bash -
maybe_sudo dnf install -y nodejs
return
fi
if command -v yum >/dev/null 2>&1; then
curl -fsSL https://rpm.nodesource.com/setup_20.x | maybe_sudo bash -
maybe_sudo yum install -y nodejs
return
fi
if command -v pacman >/dev/null 2>&1; then
maybe_sudo pacman -Sy --needed --noconfirm nodejs npm
return
fi
if command -v brew >/dev/null 2>&1; then
brew update
brew install node@20
brew link --overwrite --force node@20
return
fi
echo "请先手动安装 Node.js >= 20"
exit 1
}
if ! node_ok; then install_node; fi
npm install -g @openai/codex || {
prefix="${HOME:-$PWD}/.npm-global"
mkdir -p "$prefix"
npm config set prefix "$prefix"
npm install -g @openai/codex
export PATH="$prefix/bin:$PATH"
}
echo "Codex CLI 安装完成。"
echo "请继续执行【配置覆盖脚本】。"
四、Windows PowerShell 安装 Codex CLI
适用于：
- Windows 10
- Windows 11
PowerShell 安装脚本
$requiredMajor = 20
$nodeVersion = node -v 2>$null
if (-not $nodeVersion) {
Write-Host "请先安装 Node.js 20 以上版本"
exit
}
$nodeVersion = $nodeVersion.TrimStart("v")
$major = $nodeVersion.Split(".")[0]
if ([int]$major -lt $requiredMajor) {
Write-Host "Node 版本低于 20，请升级 Node.js"
exit
}
npm install -g @openai/codex
if ($LASTEXITCODE -ne 0) {
$prefix = "$HOME.npm-global"
New-Item -ItemType Directory -Force -Path $prefix
npm config set prefix $prefix
npm install -g @openai/codex
$env:PATH="$prefix;$env:PATH"
}
Write-Host "Codex CLI 安装完成"
Write-Host "请继续执行配置步骤"
五、国内使用 Codex CLI 常见问题
在国内直接使用 Codex CLI 常见问题：
- API 无法连接
- 请求超时
- 延迟高
- 认证失败
如果安装成功但无法使用，大概率是网络访问问题。
六、国内稳定使用方案（推荐）
如果你在国内使用 Codex CLI，建议使用中转配置。
国内中转配置获取地址：
支持：
- 稳定访问
- 低延迟
- 无需复杂代理
- 快速部署
获取配置后执行覆盖脚本即可完成。
七、Codex CLI 常见 FAQ
1️⃣ 为什么必须 Node 20？
Codex CLI 依赖 Node 20+ 新特性。
2️⃣ macOS M 系列可以用吗？
支持 Apple Silicon。
3️⃣ Windows 是否支持？
支持，使用 PowerShell 安装。
4️⃣ 安装成功但无法调用？
通常是网络访问问题，建议使用中转配置。
八、总结
通过本教程，你可以：
- 自动升级 Node 20
- 一键安装 Codex CLI
- 支持 macOS / Linux / Windows
- 解决国内访问问题
如需稳定运行 Codex CLI：
建议收藏本页面，我们将持续更新最新版本。
