Codex 接入

通过自定义模型提供方将 Codex CLI 接入 Sublyx。

Codex 可以通过自定义 OpenAI compatible 模型提供方访问 Sublyx。以下配置使用 Responses 协议,并从环境变量读取 API Key。

配置 API Key

export SUBLYX_API_KEY=sk-sublyx-example

配置 config.toml

编辑 ~/.codex/config.toml:

~/.codex/config.toml
model_provider = "sublyx"
model = "gpt-5.6-terra"

[model_providers.sublyx]
name = "Sublyx"
base_url = "https://api.sublyx.org/v1"
env_key = "SUBLYX_API_KEY"
wire_api = "responses"

兼容性说明

如果当前 Codex 版本或所选模型不支持 Responses 协议,请改用环境变量方式配置 OpenAI compatible Base URL,或选择支持该协议的模型。

运行

codex

也可以直接传入任务:

codex "解释这个项目的模块边界,并指出测试缺口"

项目级覆盖

在受信任的仓库中,可使用项目级 .codex/config.toml 覆盖全局设置。不要在配置文件中直接写入真实 Key,保持 env_key 指向环境变量。

排查

  • 使用 codex --version 确认 CLI 已正确安装。
  • 检查 SUBLYX_API_KEY 是否在启动 Codex 的同一终端中可见。
  • Base URL 必须包含 /v1。
  • 模型 ID 必须与控制台当前可用列表一致。

本页目录