跳转到内容

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 是否与当前密钥分组下的模型名称完全一致。

下一步 ​