Codex — Linux 安装配置
本指南帮助你在 Linux 上安装并配置 OpenAI Codex CLI，接入 TinyPx API 服务。
前置要求
- Linux 发行版（Ubuntu 20.04+、Debian 11+、Fedora 35+、Arch Linux 等）
- Node.js 18.0 或更高版本
- npm 包管理器
- curl 或 wget
步骤 1：安装 Node.js
Ubuntu / Debian
bash
# 使用 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
# 或使用 snap
sudo snap install node --classicFedora / RHEL / CentOS
bash
curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
sudo dnf install -y nodejs
# 或使用 dnf 模块
sudo dnf module install nodejs:20Arch Linux
bash
sudo pacman -S nodejs npm通用方法：nvm
bash
# 安装 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验证安装：
bash
node --version
npm --version步骤 2：安装 Codex CLI
bash
sudo npm install -g @openai/codex@latest如果用 nvm 管理 Node，不需要 sudo：
bash
npm install -g @openai/codex@latest验证安装：
bash
codex --version步骤 3：创建配置目录
bash
mkdir -p ~/.codex
cd ~/.codex步骤 4：配置 API 端点
bash
cat > ~/.codex/config.toml << 'EOF'
model_provider = "tinypx"
model = "填写该 Codex 分组支持的模型名"
model_reasoning_effort = "xhigh"
[model_providers.tinypx]
name = "TinyPx API"
base_url = "https://ai.tinypx.cn/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
EOF注意端点格式
Codex 必须带 /v1 后缀 —— 使用 https://ai.tinypx.cn/v1。 详见 API 端点说明。
可用模型
具体可用模型请访问 模型广场 查看该 Codex 分组支持的 model 及价格。
步骤 5：配置 API 密钥
bash
export OPENAI_API_KEY="你的 TinyPx API 令牌"
echo 'export OPENAI_API_KEY="你的 TinyPx API 令牌"' >> ~/.bashrc
source ~/.bashrc设置安全权限：
bash
chmod 600 ~/.codex/config.toml
chmod 700 ~/.codex重要
请把占位文本替换为你从 TinyPx API 控制台 获取的实际令牌。
步骤 6：验证配置
bash
codex "你好，请写一个 Python 函数计算斐波那契数列"VSCode 集成
安装 VSCode
Ubuntu / Debian：
bash
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 codeFedora / RHEL：
bash
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 codeArch Linux：
bash
yay -S visual-studio-code-bin配置 VSCode
安装扩展后，实际配置继续使用前面的 ~/.codex/config.toml 和 OPENAI_API_KEY 即可，不需要在 VSCode 里单独填写 apiBase 或 apiKey。
常用命令
bash
# 启动交互式编码会话
codex
# 非交互式执行
codex exec "创建一个 Flask REST API"
# 代码审查
codex review --uncommitted
# 查看帮助
codex --help高级配置
更多可用配置请参考 codex --help 和官方配置参考。若需临时覆盖配置，可以用 codex -c key=value。
故障排除
权限被拒绝
推荐改用户级 npm 目录，避免 sudo：
bash
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命令未找到
bash
echo $PATH
which codex
npm config get prefix添加 npm 全局路径：
bash
# Bash
echo 'export PATH="$PATH:$(npm config get prefix)/bin"' >> ~/.bashrc
source ~/.bashrc
# Zsh
echo 'export PATH="$PATH:$(npm config get prefix)/bin"' >> ~/.zshrc
source ~/.zshrcSSL 证书错误
bash
sudo apt update && sudo apt install ca-certificates # Ubuntu/Debian
sudo dnf install ca-certificates # Fedora
sudo pacman -S ca-certificates # Arch网络连接问题
bash
# 测试连接
curl -I https://ai.tinypx.cn/v1
# 配置代理
export HTTP_PROXY="http://proxy.example.com:8080"
export HTTPS_PROXY="http://proxy.example.com:8080"日志文件过大
配置日志轮转：
bash
cat > ~/.codex/logrotate.conf << 'EOF'
~/.codex/logs/*.log {
daily
rotate 7
compress
missingok
notifempty
maxsize 50M
}
EOF系统服务说明
Codex 没有 daemon 服务模式。如果要长期运行，请直接用 codex 或 codex exec 配合终端多路复用工具（tmux/screen）、脚本或 CI。
Shell 自动补全
bash
# Bash，添加到 ~/.bashrc
eval "$(codex completion bash)"
# Zsh，添加到 ~/.zshrc
eval "$(codex completion zsh)"
# Fish，添加到 ~/.config/fish/config.fish
codex completion fish | source使用技巧
bash
# 启动一次交互式会话
codex
# 让 Codex 在当前项目中执行一次性任务
codex exec "创建一个用户认证模块，并保存为 auth.py"
# 审查当前未提交改动
codex review --uncommitted下一步
提示
用包管理器保持工具更新：sudo npm update -g @openai/codex