在codex中使用 - 聚合API接口文档

注意：Windows推荐使用wsl，Linux系统正常安装即可。

系统要求:

Linux 发行版 (Ubuntu 20.04+ , Debian 10+)

Node.js 22+

npm 10+

网络连接

安装Node.js

Ubuntu/Debian

sudo apt update 
# 安装 Node.js
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

CentOS/RHEL/Fedora

# 使用 dnf (Fedora) 或 yum (CentOS/RHEL)
sudo dnf install nodejs npm
# 或
sudo yum install nodejs npm

Arch Linux

sudo pacman -S nodejs npm

安装Codex

sudo npm install -g @openai/codex

验证安装

codex --version

出现codex-cli后面是版本号即为安装完成。

在VScode中使用

在VScode中用wsl启动终端，并输入以下命令创建文件

mkdir ~/.codex
vi ~/.codex/auth.json
vi ~/.codex/config.toml

可以在C盘Linux下找到这个.codex文件夹，并打开auth.json文件输入：

{"OPENAI_API_KEY": "sk-xxx（这是你从UnifyLLM购买的key）"}

然后保存退出。

继续打开config.toml文件输入：

model_provider = "example"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
[model_providers.example]
name = "example"
base_url = "https://api.example.com/v1"
wire_api = "responses"

注意，请将example替换为你的中转平台，这里可以选择4个等级，model_reasoning_effort = "high"，---high medium low minimal

启动Codex

打开项目，新建wsl终端，输入命令开始使用：

codex

常见命令参考

命令	描述
/mode	切换审批模式（Suggest/Auto Edit/Full Auto）
/model	切换 AI 模型和推理级别
/approvals	切换批准模式（Read Only/Auto/Full Access）
/init	创建 AGENTS.md 文件，为 Codex 提供项目指令
/status	显示当前会话配置和令牌使用情况
/diff	显示 Git 差异（包括未跟踪文件）
/clear	清除会话历史
/prompts	显示示例提示
/help	显示帮助信息

更加详细教程请查询官网：

https://developers.openai.com/codex