通过腾讯云 TokenHub 连接模型服务

使用独立 profile 连接 TokenHub 的 /v1 入口，通过 HY3_API_KEY 认证。模型使用 hy3，密钥需与服务地域匹配。

Codex 的模型请求发送到 TokenHub 的 OpenAI Responses 入口。官方 Codex 页给了 [model_providers.hy3-tokenhub] 和 wire_api = "responses"。env_key 已经是变量名 HY3_API_KEY，在启动 Codex 的进程里 export。不要和 experimental_bearer_token / requires_openai_auth / [model_providers.*.auth] 叠在同一张供应商表。不要把密钥写进 launchctl setenv 演示里的引号，也不要写进 http_headers。

base_url 必须带 /v1：国内广州是 https://tokenhub.tencentmaas.com/v1。国际站 Codex 页常写成 https://tokenhub-intl.tencentcloudmaas.com 且漏掉 /v1，要补成 https://tokenhub-intl.tencentcloudmaas.com/v1。API 使用说明把新加坡写成 https://tokenhub-intl.tencentmaas.com，同样要加 /v1。两套国际主机名不要混用，密钥和地域也不要交叉。Codex 不会在 base_url 里展开环境变量。不要写 openai_base_url。不要打 Anthropic 的 /v1/messages，也不要打 Chat Completions 的 /v1/chat/completions。

不要把顶层 model_provider = "hy3-tokenhub" 一上来写进用户 config，除非你就是要把所有会话都改走 TokenHub。官方手册会改成默认。更稳妥是独立 profile（0.134 起不要再写 [profiles.tokenhub]）：

# ~/.codex/config.toml
[model_providers.hy3-tokenhub]
name = "Hy3 via tokenhub"
base_url = "https://tokenhub.tencentmaas.com/v1"
env_key = "HY3_API_KEY"
wire_api = "responses"

# ~/.codex/tokenhub.config.toml
model_provider = "hy3-tokenhub"
model = "hy3"
disable_response_storage = true

export HY3_API_KEY="YOUR_TOKENHUB_KEY"
codex --profile tokenhub
codex --profile tokenhub -m hy3

创建密钥时若勾了限定范围，必须包含 Hy3。模型 ID 以 GET /v1/models 为准。国际站渲染有时把表名写成 [model_providers. hy3- tokenhub]，中间不要留空格。

配置注意事项：

• 不要抄 Token Plan / Coding Plan 的 wire_api = "chat"。https://api.lkeap.cloud.tencent.com/plan/v3、https://tokenhub.tencentmaas.com/plan/v3、https://api.lkeap.cloud.tencent.com/coding/v3 都是 Chat Completions，现行 Codex 会在加载配置时配置错误。残留的 chat 表即使不用也会把CLI 无法启动。
• 不要 npm install -g @openai/codex@0.80.0 去迁就 Token Plan。
• 不要写进项目 .codex/config.toml。项目文件改不了 model_provider / model_providers。
• 不要覆盖内置 ID openai、ollama、lmstudio。hy3-tokenhub 是新 ID，可以。

改完新开会话。codex --profile tokenhub 启动后，发送一条简短请求验证连接。401 先看是不是拿 Token Plan 密钥打了 /v1，或国内站密钥打了 tokenhub-intl。