跳转到内容

Codex CLI:手动配置

Codex CLI 使用 Codex 配置目录接入 OpenAI 兼容接口。请将示例中的模型名称替换为当前密钥分组可用的模型。

接入信息

项目内容
OpenAI 兼容接入地址https://ai.hctopup.com/v1
示例模型gpt-5.5
API Key使用 HCAI 平台创建的 Key

配置路径

平台配置目录
Windows%USERPROFILE%\.codex\
macOS / Linux~/.codex/

创建配置文件

在配置目录中创建或更新 config.toml

toml
model_provider = "hcai"
model = "gpt-5.5"
disable_response_storage = true

[model_providers.hcai]
name = "HCAI"
base_url = "https://ai.hctopup.com/v1"
wire_api = "responses"
requires_openai_auth = true

在同一目录创建或更新 auth.json

json
{
  "OPENAI_API_KEY": "替换为您的 HCAI Key"
}

启动 Codex CLI

sh
cd /path/to/your/project
codex

如果启动后模型不可用,请检查 model 是否与当前密钥分组下的模型名称完全一致。

下一步