【应用搭建】火山云（ubuntu）部署codex

一、安装codex（火山云）

在Ubuntu系统上安装OpenAI Codex CLI的方法如下：

前提条件

Node.js环境：需要Node.js 22或更高版本
网络环境：确保可以访问OpenAI API（国内用户可能需要配置代理）

安装步骤

1. 安装Node.js（如未安装）

csharp 复制代码

# 更新系统包列表
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

bash 复制代码

# 通过npm全局安装
npm install -g @openai/codex

# 或者使用淘宝镜像（国内用户）
npm install -g @openai/codex --registry=https://registry.npmmirror.com

3. 验证安装

bash 复制代码

codex --version
# 正常应显示版本号，如：0.42.0

配置与使用

1. 首次运行与认证

bash 复制代码

# 启动Codex
codex

# 首次运行会提示认证方式：
# 1. 使用OpenAI账号登录，后续编辑配置文件再修改地址。
# 2. 使用API密钥（推荐）

2. 配置API密钥

您需要OpenAI API密钥才能使用Codex：

bash 复制代码

# 设置环境变量（临时）
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：

ini 复制代码

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

使用示例

基本使用

bash 复制代码

# 进入项目目录
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辅助编程了。