OPENAI CODEX

CodeX - Linux 安装配置

在 Linux 系统安装和配置 OpenAI CodeX，并使用千模岛 API 服务。

#前置要求

Node.js 18 或更高版本与 npm
Linux 系统与管理员或 sudo 权限
千模岛 API 账户和 CodeX 专用分组令牌

#步骤 1：安装 Node.js

#Ubuntu/Debian

# 使用 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# 或使用 snap
sudo snap install node --classic

#Fedora/RHEL/CentOS

# 使用 NodeSource 仓库
curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
sudo dnf install -y nodejs

# 或使用 dnf 模块
sudo dnf module install nodejs:20

#Arch Linux

sudo pacman -S nodejs npm

#通用方法：使用 nvm

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

# 重新加载 shell 配置
source ~/.bashrc # 或 ~/.zshrc

# 安装 Node.js
nvm install 20
nvm use 20

验证安装：

node --version
npm --version

#步骤 2：安装 CodeX CLI

# 系统级 Node.js
sudo npm install -g @openai/codex@latest

# 使用 nvm 时不需要 sudo
npm install -g @openai/codex@latest

# 验证安装
codex --version

#步骤 3：创建配置目录

mkdir -p ~/.codex
cd ~/.codex

#步骤 4：配置 API 端点

编辑 ~/.codex/config.toml：

model_provider = "qianmodao"
model = "自行选择一个该CodeX分组支持的model（在模型广场查看）"
model_reasoning_effort = "xhigh"

[model_providers.qianmodao]
name = "千模岛 API"
base_url = "https://www.qianmodao.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

配置字段说明：

model_provider：提供商名称，本页使用qianmodao。
model：填写模型广场中 CodeX 分组支持的实际 model。
model_reasoning_effort：可选 low、medium、high、xhigh。
env_key：读取 API Key 的环境变量名。

chmod 600 ~/.codex/config.toml

#步骤 5：配置 API 密钥

export OPENAI_API_KEY="你的千模岛_API令牌"
echo 'export OPENAI_API_KEY="你的千模岛_API令牌"' >> ~/.bashrc

替换令牌

将示例中的占位文本替换为千模岛控制台生成的 CodeX 专用分组令牌。

#步骤 6：验证配置

codex "你好，请写一个Python函数计算斐波那契数列"

如果配置正确，CodeX 会生成代码并响应。

#VSCode 集成

#安装 VSCode

Ubuntu/Debian：

wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
sudo install -D -o root -g root -m 644 packages.microsoft.gpg /etc/apt/keyrings/packages.microsoft.gpg
sudo sh -c 'echo "deb [arch=amd64,arm64,armhf signed-by=/etc/apt/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" > /etc/apt/sources.list.d/vscode.list'
sudo apt update
sudo apt install code

Fedora/RHEL：

sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
sudo sh -c 'echo -e "[code]\nname=Visual Studio Code\nbaseurl=https://packages.microsoft.com/yumrepos/vscode\nenabled=1\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" > /etc/yum.repos.d/vscode.repo'
sudo dnf install code

Arch Linux：

yay -S visual-studio-code-bin

#配置 VSCode

安装扩展后，继续使用 ~/.codex/config.toml 与 OPENAI_API_KEY，无需在 VS Code 中单独填写 apiBase 或 apiKey。

#常用命令

# 启动交互式编码会话
codex

# 非交互式执行
codex exec "创建一个Flask REST API"

# 代码审查
codex review --uncommitted

# 查看帮助
codex --help

#快捷键（VSCode）

Ctrl+Shift+X：打开 CodeX 面板
Ctrl+Shift+I：内联代码生成
Ctrl+Shift+E：解释选中代码
Ctrl+Shift+O：优化选中代码
Tab：接受代码建议
Esc：拒绝代码建议
Ctrl+K Ctrl+G：生成代码注释

#高级配置

#额外配置

可用配置以 codex --help 和官方配置参考为准；需要临时覆盖时，使用 codex -c key=value。

#故障排除

#问题：权限被拒绝

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@latest

#问题：命令未找到

npm config get prefix
echo $PATH
which codex

#问题：SSL 证书错误

sudo apt update && sudo apt install ca-certificates
sudo dnf install ca-certificates

#问题：网络连接问题

curl -I https://www.qianmodao.com/v1
export HTTP_PROXY="http://proxy.example.com:8080"
export HTTPS_PROXY="http://proxy.example.com:8080"

#问题：日志文件过大

# ~/.codex/logrotate.conf
~/.codex/logs/*.log {
  daily
  rotate 7
  compress
  missingok
  notifempty
  maxsize 50M
}

#系统服务说明

CodeX 没有 daemon 服务模式。长期任务可使用 codex 或 codex exec 配合终端多路复用工具、脚本或 CI。

#Shell 集成

#Bash 自动补全

eval "$(codex completion bash)"

#Zsh 自动补全

eval "$(codex completion zsh)"

#Fish 自动补全

codex completion fish | source

#使用技巧

# 初始化交互式会话
codex

# 一次性任务
codex exec "创建一个用户认证模块，并保存为 auth.py"

# 审查未提交改动
codex review --uncommitted

#下一步

提示

Linux 用户可使用 npm 保持工具更新：sudo npm update -g @openai/codex