Claude Code 和 Codex 接 HiAPI：一个 Key 按任务选模型

这两天，Karpathy 年初的一句话又被翻出来刷屏：the new default is that you are not writing the code directly 99% of the time, you are orchestrating agents who do and acting as oversight。翻译过来就是：新默认是 99% 的时间你不再亲自写码，而是编排替你干活的 agent、自己只做监督。这句话出自他提出 agentic engineering 概念时的帖子，他在 No Priors 播客里还补了一刀：I don't think I've typed a line of code probably since December。

刷屏归刷屏，数据更能说明这不是一句口号。Claude Code 的年化运行收入已经超过 $2.5B（2026 年 2 月 Series G 官宣口径，非审计 ARR），GitHub Copilot 当年走到 $1B 用了约 3 年。JetBrains 2026 开发者生态调查（1.5 万+ 受访者）里，约 90% 的专业开发者每周都在用 AI 编程 agent，Claude Code 在工作场景的采用率从 18% 涨到 39%（美国 47%），Codex 从 3% 涨到 16%。

问题也跟着来了：agent 变多了，配置和账单还是各管各的。很多人是 Claude Code 和 Codex 同时在用，但两个工具各申请各的 key、各充各的值、各看各的用量，想换个模型还得重新走一遍申请流程。这篇文章讲怎么用一把 HiAPI Key 把两个工具都接上，以及接好之后模型怎么选、怎么切。

先说结论

• 一把 Key 管两个工具：HiAPI 的 API Key 同时给 Claude Code 和 Codex 用，余额、用量、账单都在一个后台
• 各用各的最强模型：Claude Code 走 Anthropic Messages 协议（/v1/messages），用 HiAPI 上的 Claude 模型；Codex 走 Responses API（/v1/responses），用 GPT-6.1 系模型
• 两条红线内的自由：Claude Code 官方不支持经任何网关路由到非 Claude 模型，所以正确姿势是两个工具各接各的模型家族，而不是让一个工具通吃
• 最快 5 分钟接好：打开 /connect/agents 页面，选工具 + 选模型 + 选系统，复制生成的配置；Claude Code 和 Codex 支持 CC Switch 一键导入
• 换模型改一处：Claude Code 改 settings.json 里的模型字段，Codex 改 hiapi.config.toml 里的一行 model，Key 不用换

HiAPI 的解法：一个 Key，两个工具

HiAPI 是聚合多个模型家族的 API 平台，对外统一暴露几种标准协议。编程 agent 这边，官方做了 4 个工具的一键接入页：/zh/connect/agents（英文版 /en/connect/agents），支持 Claude Code、Codex CLI、OpenCode、Hermes Agent。

协议映射是接对的关键：

也就是说，Claude Code 的强项在长程编码 agent 任务，配的是 Claude 家族的旗舰；Codex 的强项在跑量，配的是 GPT-6.1 系。一把 Key 两边都能认证，账单合流。

一句必须说清的话：Anthropic 官方明确不支持把 Claude Code 通过任何网关路由到非 Claude 模型。把 GPT 模型硬塞进 Claude Code，工具调用和 agent 行为会不稳定，出了问题也没有官方兜底。所以「一个 Key 随时切模型」的准确含义是：在两个工具之间按任务分配，每个工具用对自己最强的模型，而不是在一个工具里混用家族。

如果你只用 Claude Code 一个工具，可以再看我们之前写的单工具配置指南《用 HiAPI 接 Claude Code：每月省下 $100 订阅费的完整配置指南》。这篇重点讲双工具共用一个 Key 和切换策略。

接法一（推荐）：/connect/agents 页面生成配置

最省事的接法，全程点选、不用手写任何配置：

1. 打开 hiapi.ai/zh/connect/agents，点「将 HiAPI 接入你的 Agent」
2. 选工具：Claude Code 或 Codex CLI
3. 选模型：比如 Claude Code 侧选 claude-opus-5-5，Codex 侧选 gpt-6.1-sol
4. 选操作系统：macOS / Windows / Linux，配置里的路径会跟着变
5. 复制生成的配置，按提示粘到对应文件即可

Claude Code 和 Codex 支持 CC Switch 一键导入：在 HiAPI 的 API Keys 页面点导入，浏览器会唤起 CC Switch 完成配置写入。导入链接本身不携带你的密钥，Key 存在本地环境变量里，这点可以放心。

版本要求先自查一下：Codex CLI 需要 0.134 及以上，用 codex --version 看；Claude Code 用 claude --version 确认能正常输出版本号。

接法二：手动写配置文件

手动配置也不复杂，两个文件各管一个工具。

Claude Code：~/.claude/settings.json

在 ~/.claude/settings.json（Windows 是 %USERPROFILE%\.claude\settings.json）的 env 块里写入：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.hiapi.ai",
    "ANTHROPIC_AUTH_TOKEN": "你的 HiAPI API Key",
    "ANTHROPIC_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-4-6",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

逐字段说明：

• ANTHROPIC_BASE_URL 指向 https://api.hiapi.ai，不带 /v1，客户端会自己拼 /v1/messages
• ANTHROPIC_AUTH_TOKEN 填你的 HiAPI API Key，走 Bearer 认证
• ANTHROPIC_MODEL 和 OPUS / SONNET 两个别名都指向你在 HiAPI 选的模型（HiAPI 不服务官方 Claude 模型 ID，别名统一指过去）
• ANTHROPIC_DEFAULT_HAIKU_MODEL 固定为 claude-sonnet-4-6，这是 Claude Code 跑后台杂活（压缩上下文、生成提交信息这类）用的槽位
• CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 是因为新文本管线会拒绝 experimental beta 请求字段，关掉省得踩坑

Codex：~/.codex/hiapi.config.toml

新建 ~/.codex/hiapi.config.toml（Windows 是 %USERPROFILE%\.codex\hiapi.config.toml）：

model_provider = "hiapi"
model = "gpt-6.1-sol"

[model_providers.hiapi]
name = "HiAPI"
base_url = "https://api.hiapi.ai/v1"
env_key = "HIAPI_API_KEY"
wire_api = "responses"

然后在 shell 里设置环境变量并启动：

export HIAPI_API_KEY="你的 HiAPI API Key"
codex --profile hiapi

Windows PowerShell 对应 $env:HIAPI_API_KEY = "..."。注意这里的 base_url 带 /v1，和 Claude Code 那侧不一样，两边不要照抄混用。wire_api = "responses" 声明走 Responses 协议，这是 Codex 的硬性要求。

模型怎么选：复杂任务 Opus，跑量用 GPT-6.1

两个工具都接好之后，模型选择就成了一道按任务路由的题。我们的建议很直接：

• 高难度、长程任务给 claude-opus-5-5：跨文件重构、马拉松式调试、需要理解整个代码库的任务。它是 Claude Code 侧的旗舰，上下文窗口到 1M
• 日常高频跑量给 gpt-6.1-sol / gpt-6.1-terra：批量改写、单文件功能、脚本生成这类任务量大、单任务不复杂，用便宜一档的模型，账单差异很明显
• gpt-6-astra 留给对质量更敏感的 Responses 场景：价格上去一档，按需启用

关键模型的平台价（$/M token，截至 2026-10，基础档）：

注意缓存读价格这一列：agent 会话里大量 token 来自缓存命中，gpt-6.1-terra 缓存读只要 $0.0125/M，长会话反复改同一个仓库时，实际账单会比按输入价估算的低不少。跑量和省钱不是二选一。

想深入对比 Opus 5.5 和 GPT-6.1 Sol 的能力取向，可以看《Claude Opus 5.5 对比 GPT-6.1 Sol》；Terra 最近的降价幅度和背景，《GPT-6.1 Terra 降价分析》里有完整拆解。两个模型的实时价格和参数以模型详情页为准。

切换模型有多容易

这是这套方案最被低估的好处。换模型只有两个动作：

• Claude Code：改 ~/.claude/settings.json 里 ANTHROPIC_MODEL / ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODEL 三处的值（HiAPI 上 opus/sonnet 别名都指过去，改成同一个新模型 ID 即可），重开会话生效
• Codex：改 ~/.codex/hiapi.config.toml 里的 model = "..." 一行，下次 codex --profile hiapi 生效

Key 从头到尾不用动。对比「给每个工具单独申请官方 key」的老路：换模型要重新申请、等审批、改密钥管理，现在是一行配置的事。如果你用了 CC Switch 导入，在 /connect/agents 页面重新选一次模型、再点一次导入也行，全程图形操作。

还想接更多模型的话，OpenCode 和 Hermes Agent 走 Chat Completions 协议，可选模型覆盖面最大，同一套页面流程。对多模态和世界模型类的新模型感兴趣，可以顺带看《Genie 4 世界模型实测》。

常见问题

Claude Code 能通过 HiAPI 用 GPT 模型吗？

不能，也不需要。Anthropic 官方不支持把 Claude Code 经任何网关路由到非 Claude 模型，硬接会让工具调用和 agent 行为不稳定，也没有官方兜底。HiAPI 上的 Claude Code 可选模型是 claude-opus-5-5、claude-sonnet-4-6、claude-opus-4-8 和 claude-opus-4-8@aws 这 4 个。想用 GPT-6.1 系模型，走 Codex 侧，Responses 协议原生支持。

一把 HiAPI Key 能同时给 Claude Code 和 Codex 用吗？

能，这正是这套方案的核心。两个工具共用同一把 Key，认证方式不同（Claude Code 用 ANTHROPIC_AUTH_TOKEN，Codex 用 HIAPI_API_KEY 环境变量），但都是同一把 Key。余额、用量、账单在同一个后台看，按工具分组统计。

CC Switch 一键导入安全吗？

安全。导入链接本身不携带密钥，Key 存在你本地的环境变量里。流程是：在 HiAPI 生成 Key 后，到 API Keys 页面点 CC Switch 导入，浏览器唤起 CC Switch 写入配置。不放心图形化流程的话，手动写 settings.json 和 hiapi.config.toml 也完全等价。

两个工具都配好了，怎么确认接上了？

Claude Code 侧跑 claude --version 确认客户端正常，然后随便开一个会话发一句话，回到 HiAPI 后台看用量有没有增长；Codex 侧要求 CLI 0.134+，codex --profile hiapi 启动后同样发一个任务看后台计量。第一次建议各跑一个小任务，确认扣费和模型 ID 都对，再放开用。

OpenCode 和 Hermes Agent 值得接吗？

看你团队习惯。这两个工具走 Chat Completions 协议，可选模型家族最多，适合需要在一个客户端里横跨多个模型家族的场景。配置流程和 Claude Code / Codex 完全一样，还是 /connect/agents 那个页面。

换模型会不会影响进行中的会话？

改的是新会话生效的配置。已经开着的会话用的是启动时读到的模型，换配置后重开会话即可，历史会话记录不受影响。

关键结论

Karpathy 那句 99% 的话被翻出来刷屏，说明 agentic engineering 已经不是前沿玩家的游戏，而是默认工作方式。默认工作方式下，同时用 Claude Code 和 Codex 的人会越来越多，配置和账单的碎片化是真实的摩擦。HiAPI 的方案是用一把 Key 接两个工具：Claude Code 走 Messages 协议用 Claude 家族的旗舰，Codex 走 Responses 协议用 GPT-6.1 系，各用各的最强模型，账单合流。接入走 /connect/agents 页面生成配置加 CC Switch 导入，5 分钟能跑通；换模型改一行配置，Key 不动。按任务路由（难题给 Opus 5.5、跑量给 GPT-6.1 Sol/Terra），是当下把质量和账单同时按住的最优解。