一、安装codex（火山云）
在Ubuntu系统上安装OpenAI Codex CLI的方法如下：
前提条件
- Node.js环境：需要Node.js 22或更高版本
- 网络环境：确保可以访问OpenAI API（国内用户可能需要配置代理）
安装步骤
1. 安装Node.js（如未安装）
# 更新系统包列表
sudo apt update
# 安装Node.js 22.x版本
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
# 验证安装
node --version
npm --version
2. 全局安装Codex CLI
# 通过npm全局安装
npm install -g @openai/codex
# 或者使用淘宝镜像（国内用户）
npm install -g @openai/codex --registry=https://registry.npmmirror.com
3. 验证安装
codex --version
# 正常应显示版本号，如：0.42.0
配置与使用
1. 首次运行与认证
# 启动Codex
codex
# 首次运行会提示认证方式：
# 1. 使用OpenAI账号登录，后续编辑配置文件再修改地址。
# 2. 使用API密钥（推荐）
2. 配置API密钥
您需要OpenAI API密钥才能使用Codex：
# 设置环境变量（临时）
export OPENAI_API_KEY="sk-your-api-key-here"
# 永久设置：添加到~/.bashrc或~/.zshrc
echo 'export OPENAI_API_KEY="sk-your-api-key-here"' >> ~/.bashrc
source ~/.bashrc
3. 配置密钥及地址文件
您需要OpenAI API密钥才能使用Codex：
root@GuassHuoshanECS:~/.codex# more auth.json
{
"auth_mode": "apikey",
"OPENAI_API_KEY": "你的密钥"
}
root@GuassHuoshanECS:~/.codex# more config.toml
# ========== 全局配置 ==========
model_provider = "codez"
model = "gpt-5.3-codex"
model_reasoning_effort = "high"
preferred_auth_method = "apikey"
[projects."/root"]
trust_level = "trusted"
[projects."/root/.codex"]
trust_level = "trusted"
[notice.model_migrations]
"gpt-5.2-codex" = "gpt-5.3-codex"
# ========== 自定义提供商配置 ==========
[model_providers.codez]
name = "codez"
base_url = "你的URL地址"
wire_api = "responses"
requires_openai_auth = false
env_key = "OPENAI_API_KEY"
[network]
timeout = 60
max_retries = 3
使用示例
基本使用
# 进入项目目录
cd /path/to/your/project
# 启动Codex交互模式
codex
# 在交互界面中，您可以：
# - 描述需求让Codex生成代码
# - 要求解释错误
# - 请求代码重构
常用命令
/model- 查看或切换模型/context- 管理上下文/help- 查看帮助信息
注意事项
- 网络问题：国内用户可能需要配置代理或使用中转API
- 权限问题：避免使用
sudo npm install，建议修复npm全局目录权限 - 模型选择：Codex支持多种模型，包括GPT-4和GPT-5系列
- 成本控制：注意API调用费用，合理设置使用限额
按照以上步骤，您就可以在Ubuntu系统上成功安装并使用OpenAI Codex进行AI辅助编程了。
