集成 Codex

Codex 是面向软件开发任务的 AI 编程工具。HiModels 通过 OpenAI Responses 兼容接口为 Codex 提供统一的模型访问地址，配置一次后即可在读取同一 Codex 配置目录的客户端中使用。

1. 安装 Codex CLI

使用 npm 安装 Codex CLI，并确认命令可以正常运行：

npm install -g @openai/codex
codex --version

2. 配置 HiModels 提供方

先在 HiModels「API Keys」页面创建 API Key。

将 API Key 设置到当前终端环境变量中：

# macOS / Linux
export HIMODELS_API_KEY="<your_himodels_api_key>"

# Windows PowerShell
$env:HIMODELS_API_KEY="<your_himodels_api_key>"

创建或编辑 ~/.codex/config.toml，添加以下 HiModels 提供方配置：

model = "gpt-5.5"
model_provider = "himodels"
preferred_auth_method = "apikey"
model_reasoning_effort = "high"

[model_providers.himodels]
name = "HiModels"
base_url = "https://api.himodels.ai/v1"
env_key = "HIMODELS_API_KEY"
wire_api = "responses"

Windows 用户的配置文件通常位于 %USERPROFILE%\.codex\config.toml。不要把真实 API Key 直接提交到项目仓库。

3. 开始使用

进入项目目录并启动 Codex：

cd /path/to/my-project
codex

需要临时切换模型时，可以传入 HiModels 平台上的模型 ID：

codex --model gpt-5.5
codex --model gpt-5.4

Codex 使用 Responses 协议。若请求返回 404，请确认 Base URL 为 https://api.himodels.ai/v1，并确认所选 SKU 已配置 Responses 协议提供方。