切换主题
Codex CLI 安装教程
Codex CLI 在终端中读取项目、修改代码和运行命令。第一次配置 Omini API 时,先完成安装,再设置独立服务商。
一、安装和检查
安装 Node.js LTS,打开新终端运行:
sh
npm install -g @openai/codex
codex --version进入自己的项目目录再启动。版本安装方式可参考 官方 CLI 文档。
二、配置 Omini API
打开用户目录下的 .codex/config.toml。Windows 通常位于 %USERPROFILE%\.codex\config.toml,macOS / Linux 通常位于 ~/.codex/config.toml。如果设置了 CODEX_HOME,以该目录为准。
合并以下内容到原有配置,避免创建重复的 TOML 节:
toml
model = "YOUR_MODEL_ID"
model_provider = "omini"
[model_providers.omini]
name = "Omini API"
base_url = "https://api.omini.cn/v1"
wire_api = "responses"
env_key = "OMINI_API_KEY"把 YOUR_MODEL_ID 替换成当前分组开放的模型 ID。这个自定义服务商从环境变量读取密钥。
三、设置密钥并启动
PowerShell:
powershell
$env:OMINI_API_KEY = 'YOUR_API_KEY'
codexmacOS / Linux:
sh
export OMINI_API_KEY='YOUR_API_KEY'
codex当前终端变量只影响从该终端启动的进程。使用桌面客户端时,推荐按 CC Switch 教程 配置相应客户端。
四、确认生效
运行后查看 /status、/model,发送一句简短消息,再到控制台核对实际请求。需要临时指定模型时,使用 codex --model YOUR_MODEL_ID。
五、更新与排查
更新 npm 安装的版本可重新运行安装命令。若报错,先确认当前执行文件的位置,避免旧版与新版同时出现在 PATH 中。连接问题见 常见报错。
配置字段参考:官方配置参考。
