C Codex 中文
GitHub 快速安装
  1. 首页
  2. 下载
当前版本：最新稳定版 · 全平台支持

Codex 下载与安装

选择你的操作系统，按照步骤完成 Codex CLI 安装。Windows 版本支持高速下载，macOS 与 Linux 通过 npm 或 Homebrew 安装。

高速下载

点击下方按钮即可高速下载 Codex Windows 版本安装包，国内网络环境友好，下载速度快。

点击按钮 → 进入下载页面 → 保存并下载到本地 → 完成

Windows 用户提示

推荐使用 Windows 10/11。若使用 PowerShell 遇到执行策略限制，请以管理员身份运行 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned。也可直接使用下方 npm 方式安装。

方式二：通过 npm 安装

PowerShell
# 全局安装 Codex CLI
>npm install -g @openai/codex
# 验证安装
>codex --version
codex/1.0.0 (windows-x64)

配置 API 密钥

PowerShell - 配置
# 临时设置（当前会话有效）
>$env:OPENAI_API_KEY="sk-your-api-key-here"
# 永久设置（推荐）
>[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-your-api-key-here", "User")
# 重启 PowerShell 后生效
macOS 用户提示

支持 Intel 与 Apple Silicon (M1/M2/M3) 芯片。若使用 Homebrew 安装，请先确保已安装 Homebrew。

方式一：通过 Homebrew 安装（推荐）

Terminal
# 通过 Homebrew Cask 安装
$brew install --cask codex
# 验证安装
$codex --version
codex/1.0.0 (darwin-arm64)

方式二：通过 npm 安装

Terminal - npm
$npm install -g @openai/codex
# 国内镜像加速
$npm install -g @openai/codex --registry=https://registry.npmmirror.com

配置 API 密钥

Terminal - 配置
# 写入 zsh 配置（macOS 默认）
$echo 'export OPENAI_API_KEY=sk-your-api-key-here' >> ~/.zshrc
$source ~/.zshrc
# 如使用 bash，写入 ~/.bashrc
Linux 用户提示

支持 Ubuntu、Debian、CentOS、Arch 等主流发行版。建议先安装 Node.js 18+ 与 npm。

方式一：通过 npm 安装（推荐）

Bash
# 全局安装 Codex CLI
$npm install -g @openai/codex
# 国内镜像加速
$npm install -g @openai/codex --registry=https://registry.npmmirror.com
# 验证安装
$codex --version

安装 Node.js 前置依赖

Bash - 安装 Node.js
# Ubuntu / Debian
$curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
$sudo apt-get install -y nodejs
# 验证 Node.js 与 npm 版本
$node --version && npm --version

配置 API 密钥

Bash - 配置
# 写入 bash 配置
$echo 'export OPENAI_API_KEY=sk-your-api-key-here' >> ~/.bashrc
$source ~/.bashrc
# 验证配置
$echo $OPENAI_API_KEY
sk-your-api-key-here
系统要求

运行 Codex 的最低配置

Codex 在大多数现代设备上都能流畅运行，以下是各平台的最低要求。

项目 最低要求 推荐配置
操作系统 Windows 10 / macOS 10.15 / Ubuntu 18.04 Windows 11 / macOS 13+ / Ubuntu 22.04+
Node.js 版本 18.0.0 20.0.0 或更高（LTS）
npm 版本 9.0.0 10.0.0 或更高
内存 (RAM) 4 GB 8 GB 或以上
磁盘空间 200 MB 1 GB（含缓存）
网络连接 需访问 OpenAI API 稳定的国际网络或代理
OpenAI 账户 需有可用 API 额度 充值 $5+ 解除速率限制
国内加速

解决 国内网络访问问题

国内用户访问 npm 与 OpenAI API 可能较慢，可通过镜像源与代理配置加速。

npm 镜像加速

使用淘宝 npm 镜像源加速包下载，速度可提升 5-10 倍。

镜像配置
# 永久设置淘宝镜像
$npm config set registry https://registry.npmmirror.com
# 单次安装使用镜像
$npm install -g @openai/codex --registry=https://registry.npmmirror.com

API 代理配置

OpenAI API 在国内访问需通过代理，可通过环境变量配置。

代理配置
# 设置 HTTP 代理
$export HTTPS_PROXY=http://127.0.0.1:7890
$export HTTP_PROXY=http://127.0.0.1:7890
# 或使用 OPENAI_BASE_URL 自定义端点
$export OPENAI_BASE_URL=https://your-proxy.example.com/v1
安全提示

请勿使用来源不明的第三方 API 代理服务，可能导致 API 密钥泄露。建议使用官方 OpenAI API 或可信的国际网络代理。

安装验证

验证 安装是否成功

安装完成后，运行以下命令验证 Codex 是否正确安装。

验证安装
$codex --version
codex/1.0.0 (node/v20.10.0)
$codex --help
Usage: codex [options] [prompt]
AI coding agent for your terminal
Options:
-V, --version output the version number
-h, --help display help for command
查看完整教程