Claude Code 是 Anthropic 出品的终端编程工具，代码理解和重构能力在同类工具里排第一梯队。但它有个让很多人犹豫的门槛：要用 Claude Code，要么付 $200/月 Max 订阅，要么付 $100/月含有限用量。 对于不是全天在写代码的人，这个固定月费不好消化。
好消息是，Claude Code 支持 BYOK（Bring Your Own Key），只配两行环境变量就能接第三方 API。这篇文章讲怎么用 HiAPI 的 Claude 模型驱动 Claude Code，把固定月费变成按量计费。
为什么 Claude Code 用户都在找第三方 API Key
Max 订阅的月费结构对两类人不友好：
中轻度用户。 一天只用一两个小时 Claude Code，token 消耗远撑不满 Max 的价值。付 $100/月相当于每天花 $3 买个可能只用了 $0.5 的额度。
已有 API 使用习惯的用户。 很多人本来就有一套 API Key 管理工作流，订阅制反而是多出来的管理负担。他们更想"一个 Key 打通所有工具"，不想单独为 Claude Code 买份订阅。
按量付费的优势很直观：用了多少付多少，没用到就不花钱。月费省下来的部分，可以投入其他模型或工具。
Claude Code 的 BYOK 机制怎么用
Claude Code 启动时读取两个环境变量（HiAPI 的 Anthropic Messages 端点已实现工具调用、流式响应和扩展思考，但 Claude Code + HiAPI 端到端组合尚未实测，建议配置后先用简单任务验证）：
ANTHROPIC_BASE_URL：API 端点地址。默认指向 Anthropic 官方，改成第三方提供商的地址就能切到自定义端点。ANTHROPIC_API_KEY：鉴权 Key。第三方提供商生成的 API Key，格式通常以sk-开头。
原理不复杂：Claude Code 所有请求都走 Anthropic Messages API 协议。只要自定义端点实现了这套协议，Claude Code 就能正常工作。HiAPI 的 /v1/messages 端点完整支持 Anthropic Messages API，包括工具调用、流式响应和扩展思考。
配置方法就是把这两个变量写进终端环境，然后照常启动 claude 命令。后面有完整的配置步骤。
为什么选 HiAPI 接 Claude Code
HiAPI 目前提供 4 款 Claude 模型（价格截至 2026-10），覆盖不同场景和预算：
| 模型 | 输入 $/M | 输出 $/M | 上下文 |
|---|---|---|---|
| claude-opus-5-5 | $2.02 | $10.08 | 1M |
| claude-opus-4-8 | $2.29 | $11.47 | 200K |
| claude-sonnet-4-6 | $3.00 | $15.00 | 200K |
| claude-opus-4-8@aws | $5.74 | $28.70 | 1M |
挑重点说：
Opus 5.5 是最大亮点。 输入 $2.02/M、输出 $10.08/M，比典型 Opus 级模型定价（$15/$75）低了约 87%。用 Opus 级别能力处理复杂重构任务，成本大幅低于预期。
Sonnet 4.6 价格与官方持平。 $3/$15 的定价让日常编码场景没有溢价，该用什么还用什么。
4 款模型各有分工。 不是"哪个便宜用哪个"，而是按任务复杂度选模型——下一节具体说怎么选。
另外，HiAPI 的这些 Claude 模型同时支持 Anthropic Messages 和 OpenAI Chat 两种协议。Claude Code 走 Messages 协议，其他支持 OpenAI 兼容接口的工具（如 Cursor、Codex CLI）也可以接进来，一套 Key 覆盖多个编程环境。
配置步骤（5 分钟搞定）
1. 获取 HiAPI API Key
登录 HiAPI，进入控制台「API Key」页面，创建一个新 Key。Key 格式为 sk- 开头，创建后立即复制保存。
如果没有账号，先注册并完成基础配置。
2. 设置环境变量
在终端执行：
export ANTHROPIC_BASE_URL=https://api.hiapi.ai
export ANTHROPIC_API_KEY=sk-<你的 HiAPI Key>
把 <你的 HiAPI Key> 替换为上一步拿到的 Key。
建议把这两行写入 shell 配置文件（~/.zshrc 或 ~/.bashrc），不用每次开终端都重新输：
echo 'export ANTHROPIC_BASE_URL=https://api.hiapi.ai' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY=sk-<你的 HiAPI Key>' >> ~/.zshrc
source ~/.zshrc
3. 启动 Claude Code
claude
Claude Code 启动后会自动读取这两个环境变量，把请求发到 HiAPI。如果一切正常，就能像平时一样使用 Claude Code，区别只是后端换成了 HiAPI。
4. 验证
启动后输入一个简单任务测试，比如"列出当前目录的文件"，确认响应正常、流式输出流畅。如果有问题，检查环境变量是否正确设置：
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY
模型怎么选：Sonnet vs Opus
新手最容易犯的错是"有 Opus 就用 Opus"。其实按任务选模型比按价格选模型更重要。以下按场景给建议：
日常编码 → claude-sonnet-4-6。 写代码、修 bug、加功能、理解项目结构。Sonnet 的响应速度够快，能力覆盖绝大多数日常编程需求。价格与官方持平，但因为没有 $100 月费门槛，实际开销少很多。
复杂重构 / 跨文件修改 → claude-opus-5-5。 涉及多个文件的架构调整、需要深度理解代码逻辑的任务。Opus 5.5 能力最强，价格仅 $2.02/$10.08，是当前最有性价比的 Opus 选项。1M 上下文也够处理大型项目。
一般性复杂任务 → claude-opus-4-8。 介于 Sonnet 和 Opus 5.5 之间。价格 $2.29/$11.47 也很友好。适合不想在模型选择上纠结时用的"默认加强版"。
需要 1M 上下文但用不了 Opus 5.5 → claude-opus-4-8@aws。 这是 Opus 4.8 的大上下文版本，价格较高（$5.74/$28.70），适合特大代码库的全局分析。一般场景优先考虑 Opus 5.5。
一句话总结：日常用 Sonnet，复杂任务切 Opus 5.5。 按天算开销的话，中度使用大概 $1-3/天，远比 $100/月订阅灵活。
关于成本：Claude Code 每次对话消耗的 token 量差异很大。简单问答几百 token，复杂重构可能上万 token。建议用一周实际用量来评估是否比订阅划算，别只看定价表。HiAPI 控制台提供用量统计，方便追踪实际消耗。
FAQ
Claude Code 真的能用第三方 API Key 吗？
可以。Anthropic 官方在 Claude Code 中提供了 ANTHROPIC_BASE_URL 环境变量，就是用来支持自定义端点的。这不是破解或非官方用法。
配置后 Claude Code 功能有缺失吗？
核心功能（代码读写、终端执行、工具调用、对话）都走 Anthropic Messages API 协议，不受影响。HiAPI 端点完整实现了该协议。如果遇到异常行为，先检查 API Key 是否有效、环境变量是否正确。
配置后 Claude Code 报错怎么办？
最常见的问题是环境变量没生效。确认当前终端 session 里 echo $ANTHROPIC_BASE_URL 有输出。如果用 Claude Code 桌面应用而非终端版本，环境变量的生效方式不同，需要查 Claude Code 对应平台的环境变量配置方法。
一个月能省多少钱？
假设每天用 Claude Code 编码 2-3 小时，按 Sonnet 4.6 的价格算，日均 token 消耗大概在 $1-3 左右，月开销约 $30-90。对比 $100/月 Max 订阅，中轻度用户能省 40-70%。
重度用户（全天候编码、大量重构）的情况需要实测：$100/月是个分界线，如果实际 API 费用跑超过这个数，Max 订阅反而更划算。建议先接第三方 Key 跑一周，对比实际 token 费用和 Max 订阅价格再决定。
HiAPI 上的其他模型（GPT、DeepSeek 等）能用于 Claude Code 吗？
不能。Claude Code 是 Anthropic 的工具，只能用 Claude 系列模型。但 HiAPI 的非 Claude 模型可以在其他支持 OpenAI 兼容接口的编程工具中使用（如 Codex CLI、Cursor 等），同一套 Key 覆盖多个工具。
用 HiAPI 的 Claude 模型有速率限制吗？
HiAPI 对 API Key 有速率限制，具体数值见控制台。一般编程场景不会触达限制。如果长时间连续高强度使用，可以先在控制台确认当前限值。
选了 HiAPI 接 Claude Code，最大的变化不是省钱本身，而是不用再为一个工具单独付一份月费。一个 Key 管 Claude Code，也能管其他编程环境，回到按用量付费的简单逻辑。
