HopBaseClaude Code 是目前公认最好用的 AI 编程工具,但国内直连官方 API 时断时续:高峰期超时、请求中途断流、账号莫名受限。这篇文章给出一条经过大量用户验证的稳定路径——不用魔法、不改一行代码,两个环境变量完成接入。
为什么需要一层网关
直连官方最大的问题不是「连不上」,而是不确定。跨境链路的抖动你控制不了,上游的风控你预测不了,而写代码的人最怕的恰恰是「刚才还好好的」。网关做的事,是把这些不确定性挡在你的工作流之外:多上游调度、失败自动切换、请求级计费透明。
网关的价值不在于转发本身,而在于把「上游的不确定性」挡在你的工作流之外。
三步接入
第一步,注册并登录控制台,在「API Key」页新建一个 Key。第二步,在终端里设置两个环境变量:
# 一行环境变量,Claude Code 直连网关
export ANTHROPIC_BASE_URL=https://api.hop-base.com
export ANTHROPIC_AUTH_TOKEN=你的Key
claude # 正常使用,用量在控制台实时可见第三步,运行 claude 发起一次对话。看到补全正常返回,接入就完成了。想长期生效,把这两行写进 ~/.zshrc 或 ~/.bashrc 即可。
三个最常见的坑
- 环境变量没生效:改完 shell 配置文件后要开新终端或
source一次;IDE 里启动的终端可能不读取你的 shell 配置。 - Key 权限对不上:一个 Key 绑定一个计费分组,如果提示模型不可用,先到控制台确认该分组是否包含你要用的模型。
- 公司代理干扰:企业内网的 HTTPS 代理可能改写请求头,遇到奇怪的 401/403 时先在无代理环境验证。
按需选择分组
同一个 Key 可以使用你所在分组的全部模型,不同分组对应不同的价格与调度策略:
| 分组 | 适用场景 | 特点 |
|---|---|---|
| 稳定组 | 日常开发、生产集成 | 多上游调度,自动 failover |
| 高速组 | 交互式重度使用 | 首字延迟优先 |
| 经济组 | 批量任务、离线处理 | 单价最低 |
验证与计费透明
发起一次请求后,控制台的用量页会立刻出现这条记录——模型、token 数、缓存命中与费用一一对应。prompt cache 命中的部分按折扣价计费,Claude Code 这类会话式工具的缓存命中比例通常相当可观,实际成本往往低于按牌价的直觉估算。