AI精品店

Appearance

Codex CLI 集成 ​

Codex CLI 是 OpenAI 官方的终端编程助手，直接在命令行里对话、写代码。它是三种客户端里最轻量的一种，而且 VSCode 插件、Codex App 都和它共用 ~/.codex 配置目录——先把 CLI 跑通，其他客户端可以直接复用配置。

这一页的目标：你的终端里能跑通 node / npm / codex 三个命令。配置报错时，先回到这一页确认环境没问题，能省掉大量排查时间。

1. 检查 Node.js / npm ​

Codex CLI 依赖 Node.js 22+。打开终端运行：

bash
node -v   # 应显示 v22.x.x
npm -v    # 应显示 10.x.x

如果命令报"找不到命令"或版本过低，先完成下一步安装；已经装好的直接跳到第 3 步。

2. 安装 Node.js（按你的系统选一种） ​

bash
# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

# 重新打开终端后，安装 Node.js 22
nvm install 22
nvm use 22
powershell
# 方式一：官网下载安装包（推荐新手）
# 访问 https://nodejs.org，下载 LTS 版本（选 v22）安装即可

# 方式二：使用 nvm-windows（推荐需要多版本的用户）
# 下载 nvm-setup.exe：https://github.com/coreybutler/nvm-windows/releases
# 安装后在管理员终端运行：
nvm install 22
nvm use 22
bash
# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

# 重新打开终端后，安装 Node.js 22
nvm install 22
nvm use 22

装完后重新打开终端，再跑一遍第 1 步的两条命令确认版本。

3. 安装 Codex CLI ​

bash
npm install -g @openai/codex
codex --version

显示版本号即安装成功。

国内网络下安装慢，可临时指定 npm 镜像：

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

4. 首次运行（生成配置目录） ​

bash
codex

首次运行会创建 ~/.codex/ 目录（Windows 在 C:\Users\你的用户名\.codex）。后续配置中转站要用到这个目录，所以这一步不能跳过。看到界面即可退出（Ctrl + C）。

5. 配置接入 CodexZH ​

选一种配置方式完成接入：

6. 启动使用 ​

进入任意项目目录，运行：

bash
codex

能进入对话界面并正常回复，即接入成功。

常见安装问题 ​

npm 全局安装提示权限不足（permission denied） ​

  • Windows：用管理员打开 PowerShell 再重试，或配置 npm 全局目录到用户目录
  • macOS / Linux：建议使用 nvm 管理 Node.js，避免全局权限问题

遇到问题？

  1. 先查 中转站运行状态，排除服务端问题
  2. 再看 错误排查指南 或 常见问题解答