Codex CLI 安装教程（Linux）

Linux 下安装 Codex CLI 的流程与 macOS 基本一致，推荐通过 npm 全局安装，并在 ~/.codex/ 下写两个配置文件。

0. 前置：安装 Node.js

需要 Node.js 22+。常见发行版可这样安装：

# Ubuntu / Debian（通过 NodeSource 获取新版本）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 或使用 nvm（推荐，无需 sudo）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install 22

验证版本：

node -v
npm -v

1. 安装 Codex

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

若提示 EACCES 权限错误，说明 npm 全局前缀指向系统目录。可改用 nvm/fnm，或执行：

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

2. 配置 Codex 接入 AI通道

2.1 配置文件在哪里

• ~/.codex/config.toml
• ~/.codex/auth.json

2.2 创建配置目录

mkdir -p ~/.codex

2.3 写入主配置 config.toml

cat > ~/.codex/config.toml <<'EOF'
model = "gpt-5-codex"
model_provider = "aitongdao"
approval_policy = "on-request"

[model_providers.aitongdao]
name = "aitongdao"
base_url = "https://ai.aitongdao.com/v1"
wire_api = "responses"
EOF

2.4 写入认证文件 auth.json

cat > ~/.codex/auth.json <<'EOF'
{
  "OPENAI_API_KEY": "sk-你的密钥"
}
EOF

把 sk-你的密钥 替换为从 aitongdao.com 获取的实际 Key。

2.5 验证配置文件是否创建成功

ls -la ~/.codex
cat ~/.codex/config.toml

3. 启动并验证

codex --version
cd ~/your-project
codex

进入会话后尝试问一句，若能看到 GPT 的返回，说明整条链路已通。

常见问题

codex: command not found

检查全局 npm bin 目录是否在 PATH：npm bin -g 查看路径，添加到 ~/.bashrc 中。

配置写入后仍然 401

• 确认 auth.json 中的 Key 与 AI通道后台完全一致。
• 确认该令牌的分组是 codex，否则调用 GPT 系列会被拒绝。

请求超时或连接被拒

服务器侧若有防火墙限制出站 443，请放行。也可先用 curl https://ai.aitongdao.com/v1/models -H "Authorization: Bearer sk-..." 确认网络通达。

想切换模型

直接修改 config.toml 的 model 字段，例如改成 gpt-5.2-codex 使用新版 Codex 专用模型。