Codex 可通过自定义模型 Provider 使用腾讯云 TokenHub。腾讯云 Codex 指南以 Hy3 演示配置,TokenHub 混元调用指南另行确认 Hy4 支持 OpenAI Responses 协议;下文将 Codex 示例中的模型名和环境变量替换为 Hy4。该配置是按官方配置结构和协议说明作出的适配,腾讯云未给出 Hy4 专属 Codex 配置,也未声明此组合经过专项测试。
适合的任务:在 Codex 中通过 TokenHub 使用 Hy4 进行代码阅读、编写和修改。
不适合的任务:需要已专项验证的 Hy4-Codex 组合或联网搜索工具保证可用的场景。
适用的模型版本:TokenHub 模型 ID hy4,即 Hy4 正式版。
适用的客户端、Agent 或 API:Codex 桌面端或 CLI 的自定义模型 Provider;TokenHub Responses API。
推荐的推理档位和参数:腾讯云称 Hy4 默认开启深度思考;Codex 接入指南未说明自定义 Provider 的推理档位覆盖方法,因此不添加推理参数。
在 Codex 的 config.toml 中配置 TokenHub Provider:
model_provider = "hy4-tokenhub"
model = "hy4"
disable_response_storage = true
[model_providers.hy4-tokenhub]
name = "Hy4 via TokenHub"
base_url = "https://tokenhub.tencentmaas.com/v1"
env_key = "HY4_API_KEY"
wire_api = "responses"将 API Key 放入名为 HY4_API_KEY 的环境变量。按腾讯云指南,在 macOS 可运行:
launchctl setenv HY4_API_KEY "您的 TokenHub API Key"Windows 可运行:
setx HY4_API_KEY "您的 TokenHub API Key"API Key 应在 TokenHub 控制台创建,且密钥可访问范围须包含 Hy4。不要将真实密钥写入 config.toml 或提交到代码仓库。
在 TokenHub 控制台创建 API Key,并确认其访问范围包含 Hy4。
将上方 TOML 配置加入 Codex 的 config.toml,并按操作系统设置 HY4_API_KEY 环境变量。
完全退出 Codex 后重新启动,使其重新读取配置和环境变量。
发起简单对话或代码解释请求,确认 Hy4 能返回结果。该步骤是建议的本地验证流程,本文未实际调用模型。
腾讯云 Codex 接入指南 最近更新时间为 2026-09-28。指南以 Hy3 为例,给出 model_provider、model、disable_response_storage、base_url、env_key 和 wire_api = "responses" 等设置;并说明自定义 Provider 会使用默认元数据估算值,出现 Model metadata ... not found 提示不代表模型无法使用。
腾讯云 混元调用指南 列明 hy4 兼容 OpenAI Responses 协议,并将其与 hy4-preview 区分。该协议依据支持把 Codex 示例适配到 hy4,但不等于腾讯云公布了 Hy4-Codex 的专项测试结果。
混元调用指南列出的 Hy4 上下文窗口为 1,024k、最大输入为 960k、最大输出为 64k。Codex 指南未给出 Hy4 对应的上下文元数据配置,示例保留 Codex 默认估算。
腾讯云的 Codex 示例使用 Hy3;Hy4 配置是依据同一 TokenHub 上的 Responses 兼容声明替换模型 ID 得出,未经本文实测。
web_search 是否能与 Hy4 在 Codex 中协同工作,官方材料未作说明。配置中不启用或禁用此工具;若 Codex 报相关工具兼容错误,可先在 Codex 中关闭联网搜索后重试,这只是诊断步骤,不代表 Hy4 已验证支持该工具。
Codex 可能提示找不到 hy4 的模型元数据并采用默认估算。这一提示本身不能证明模型调用成功;仍需发送请求验证。若要覆盖上下文估算,应先确认当前 Codex 版本支持的配置字段与 Hy4 的有效窗口值。
本文未验证密钥权限、流式输出、工具调用、联网搜索或实际响应质量。
2026-11-16 使用 Tabbit 阅读腾讯云 TokenHub Codex 接入指南和混元调用指南。配置基于 Codex 页的 Hy3 Provider 样例,以及混元指南列出的 Hy4 Responses 兼容性编写;未安装 Codex、未修改本机配置,也未使用 API Key 发起请求。
Hy4