THQLLM

Codex 接入 THQ API

Codex 通过 OpenAI Responses API 接入 THQ。THQ 侧所选模型必须支持 Responses；仅支持 Chat Completions 的模型不能直接用于这套配置。

准备

  • 在 THQ API 控制台创建 API Key。
  • 确认当前用户可以创建或修改 Codex 配置目录。

模型和可用能力以控制台当前显示为准。下文使用 YOUR_THQ_API_KEY 作为密钥占位符。

安装

使用 npm 安装或更新 Codex：

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

其他安装方式和系统要求见 OpenAI Codex 官方文档。

配置文件路径

Codex 的 provider 配置保存在 config.toml，登录凭据保存在 auth.json。如果 .codex 目录尚不存在，请先创建。

系统Provider 配置登录凭据
macOS / Linux~/.codex/config.toml~/.codex/auth.json
Windows%USERPROFILE%\.codex\config.toml%USERPROFILE%\.codex\auth.json

Windows 可以在文件资源管理器地址栏输入 %USERPROFILE%\.codex 打开该目录。

config.toml

编辑对应系统路径下的 config.toml，并确保以下内容位于文件开头：

推荐配置
model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.thqllm.com/v1"
wire_api = "responses"
requires_openai_auth = true

[features]
goals = true

base_url 保留 /v1 即可，Codex 会根据 wire_api = "responses" 请求实际的 /v1/responses 路径，不要在 Base URL 后手动添加 /responses。

auth.json

编辑对应系统路径下的 auth.json，写入以下合法 JSON。将占位符替换为在 THQ API 控制台 创建的 Key：

auth.json 是 Codex 的共享 OpenAI 登录凭据文件。若你已经通过 ChatGPT 或 OpenAI API 登录 Codex，不要直接覆盖现有文件，否则可能影响原登录状态。需要经常在 THQ 与官方 OpenAI 之间切换时，建议使用下方的环境变量备选方案。

auth.json
{
  "OPENAI_API_KEY": "YOUR_THQ_API_KEY"
}

JSON 不支持注释，字段名与字符串值必须使用双引号，最后一个字段后不要添加逗号。推荐配置通过 requires_openai_auth = true 使用这份 OpenAI 登录凭据，因此主配置中不需要 env_key。

重启验证

保存两个文件后，完全退出并重新启动终端与 Codex。通过 IDE 使用 Codex 时，也要完全退出并 重新打开 IDE，使其重新加载配置与凭据。

启动 Codex 后，执行 /status 查看当前 provider 与模型。若当前版本支持 /debug-config，也可以用它检查配置来源和最终生效值。

然后发送一条最小提示词：

请只回复：Codex 已连接 THQ API

请求成功后，到控制台核对对应使用记录。状态中应显示 OpenAI provider 和 gpt-5.5。

环境变量备选

如果不希望使用上面的 OpenAI provider 与 auth.json 组合，可以改用环境变量。下面是 另一套独立配置，与推荐方案二选一，不要混合其中的 provider、认证字段或凭据来源。

先设置 THQ_API_KEY：

macOS / Linux
export THQ_API_KEY="YOUR_THQ_API_KEY"
Windows PowerShell
$env:THQ_API_KEY = "YOUR_THQ_API_KEY"

然后把 config.toml 改为以下完整配置：

环境变量备选
model_provider = "thq"
model = "CONTROL_PANEL_MODEL_ID"

[model_providers.thq]
name = "THQ API"
base_url = "https://api.thqllm.com/v1"
env_key = "THQ_API_KEY"
wire_api = "responses"
requires_openai_auth = false

这个方案使用独立的 thq provider，不读取 auth.json。环境变量只对从同一终端启动的 Codex 生效；通过 IDE 使用时，需要确保 IDE 继承了该变量。

常见问题

配置了 /v1 仍然返回 404

确认 wire_api = "responses"，并检查最终请求路径是否为 /v1/responses。不要把 /responses 手动写进 base_url，也不要使用 Gemini 的 /v1beta。

提示缺少 OpenAI API Key

使用推荐方案时，确认 auth.json 位于当前用户的 .codex 目录，内容是合法 JSON，并且 requires_openai_auth = true。检查文件是否被误保存为 auth.json.txt。

使用环境变量备选方案时，确认 requires_openai_auth = false、env_key = "THQ_API_KEY"， 并从已设置变量的同一终端启动 Codex。

模型能用于 Chat Completions，但 Codex 请求失败

当前 Codex 自定义 provider 要求 Responses API。模型仅支持 Chat Completions 并不代表它 能用于 Codex，请在控制台选择明确支持 Responses 的模型。

配置没有生效

使用推荐方案时，检查 TOML 段名是否为 [model_providers.OpenAI]，顶层 model_provider 是否为 OpenAI，以及配置是否位于 config.toml 开头。修改后要完全重启 终端、Codex 和承载它的 IDE。

使用环境变量备选方案时，再检查段名是否为 [model_providers.thq]、顶层 model_provider 是否为 thq，以及启动 Codex 的终端是否已设置 THQ_API_KEY。

更多通用步骤见客户端接入总览和 常见问题。

安全

  • 不要把真实 Key 发到聊天、截图、日志、Issue 或代码仓库中。
  • 不要提交包含真实 Key 的 auth.json、shell 配置或诊断信息。
  • 文档、示例和求助信息中统一使用 YOUR_THQ_API_KEY，不要粘贴完整 Key。
  • 为不同设备和用途创建不同 Key；不再使用或怀疑泄露时，立即在控制台撤销。
  • 提交问题时可以保留变量名、状态码和 request ID，但应删除完整 Key 与敏感请求内容。