Codex Linux 使用指南

(一) 安装 Node.js 环境

Codex 需要 Node.js 环境才能运行（版本要求 ≥18）。

Linux 安装方法

方法一：使用官方仓库（推荐）

bash

# 添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
# 安装 Node.js
sudo apt-get install -y nodejs

方法二：使用系统包管理器

虽然版本可能不是最新的，但对于基本使用已经足够：

bash

# Ubuntu/Debian
sudo apt update
sudo apt install nodejs npm
# CentOS/RHEL/Fedora
sudo dnf install nodejs npm

Linux 注意事项

  • 某些发行版可能需要安装额外的依赖
  • 如果遇到权限问题，使用 sudo
  • 确保你的用户在 npm 的全局目录有写权限

验证安装是否成功

安装完成后，打开终端，输入以下命令：

bash

node --version
npm --version

如果显示版本号，说明安装成功了！

(二) 安装 Codex CLI

安装 Codex CLI

打开终端，运行以下命令：

1
2

# 全局安装 Codex
npm i -g @openai/codex --registry=https://registry.npmmirror.com

如果遇到权限问题，可以使用 sudo：

1

sudo npm i -g @openai/codex --registry=https://registry.npmmirror.com

验证安装

安装完成后，输入以下命令检查是否安装成功：

1

codex --version

如果显示版本号，恭喜你！Codex 已经成功安装了。

(三) 配置 Codex 环境变量

方法一：使用 cc switch 配置（强烈推荐）

查看 cc switch 配置文档

方法二：临时设置（当前会话有效）

在终端中运行以下命令：

1
2

export OPENAI_BASE_URL="https://www.88code.org/openai/v1"
export OPENAI_API_KEY="你的API密钥"

注意：API 密钥格式如 88_xxxxxxxxxx

方法三：永久设置（推荐）

添加到你的 shell 配置文件：

对于 bash (默认)：

1
2
3

echo 'export OPENAI_BASE_URL="https://www.88code.org/openai/v1"' >> ~/.bashrc
echo 'export OPENAI_API_KEY="你的API密钥"' >> ~/.bashrc
source ~/.bashrc

对于 zsh：

1
2
3

echo 'export OPENAI_BASE_URL="https://www.88code.org/openai/v1"' >> ~/.zshrc
echo 'export OPENAI_API_KEY="你的API密钥"' >> ~/.zshrc
source ~/.zshrc

验证环境变量

在终端中验证：

1
2

echo $OPENAI_BASE_URL
echo $OPENAI_API_KEY