Claude Code 只能对接 Anthropic 兼容接口，于是出现了官方云厂商兼容端点与各类第三方中转并存的局面。本文说明接入需要的环境变量与配置项、挑选接口应看的五个指标、被限流和 token 超支的常见原因，以及一套可照着执行的落地清单。
各家模型的 HTTP 接口在协议层并不统一，而 Claude Code 只认 Anthropic Messages API 这一套协议。于是中间层出现了：只要某个服务把模型包装成 Anthropic 兼容端点，改两个环境变量就能把它接进 Claude Code。社区里流传的「接口总汇」正是这么来的——一边是官方云厂商提供的兼容入口，一边是各类第三方中转和公益网关。
选择一多，问题也跟着来：白天连不上、跑五分钟被限流半小时、免费额度几次交互就见底、一天下来账单几十块。下面把接入方式、选型维度、故障排查和落地建议一次讲清楚。
接入方式：所有方案都是同一套开关
Claude Code 通过环境变量决定请求发往哪里、用什么凭证、映射成哪个模型：
export ANTHROPIC_BASE_URL="https://<你的端点>"
export ANTHROPIC_AUTH_TOKEN="<你的密钥>"
export ANTHROPIC_MODEL="<主模型名>"
export ANTHROPIC_SMALL_FAST_MODEL="<廉价模型名>" # 后台小任务
也可以写进 ~/.claude/settings.json 的 env 字段，省得每次开终端重设。配置时注意三点：
- 变量名（尤其是默认模型映射那几个）在不同版本间有调整，动手前对照官方文档和本地的
claude --version。 - 多数兼容端点只实现了 Messages API 的一部分。tool use、prompt caching、流式输出、图片输入是否支持，直接决定 Claude Code 能不能正常干活，「能返回文字」远远不够。
- 配完用
/status一类命令确认实际生效的端点和模型，别只看环境变量。
选接口该看的五个指标
| 指标 | 为什么关键 | 怎么验证 |
|---|---|---|
| 可用时段与稳定性 | 免费站被打、夜间限流是常态 | 连续两天在正常工作时段各跑一次完整任务 |
| 限流规则（RPM/TPM/并发） | Claude Code 一次任务携带大量文件内容，TPM 往往比 RPM 先爆 | 用中等规模仓库试跑，观察多久触发、恢复要多久 |
| 计费方式与单价 | 按次估算和按 token 估算差一个数量级 | 用 /cost 或服务商后台核对实际用量 |
| 协议兼容度 | 缺 tool use 就只能聊天，缺缓存则成本翻倍 | 跑一遍「读文件 → 改代码 → 执行测试」的完整链路 |
| 数据合规 | 代码和 prompt 会经过中间方 | 看服务条款、是否留存请求、能否开票 |
两类来源，风险完全不同
官方云厂商的 Anthropic 兼容端点
Moonshot 的 Kimi K2、阿里云百炼的 Qwen3 Coder、智谱 GLM 系列、火山引擎等，都在自家文档里给出了接入 Claude Code 的说明。优点是密钥可管理、能开票、条款清晰、出问题有工单通道。缺点同样明显：免费赠送的额度通常只够验证链路，稍大的项目几次交互就用完；低价档位的限流阈值容易被低估，刚开始跑就被限流、恢复要等很久的情况并不少见，实际配额请以控制台显示为准。
第三方中转与「公益」网关
特点是便宜甚至免费、聚合多家模型、开箱即用。风险需要提前知道：
- 你的 prompt 和代码会经过不认识的中间人，密钥可能被记录；
- 上游账号来源不明，可能因违反上游服务条款而整站停摆，被攻击、突然不可用是常态；
- 没有 SLA，出问题只能在群里等公告；
- 部分推广链接刻意混淆成一段编码，本质是拉人头返利，不宜当作技术推荐。
涉及账号共享、转售类的中转，本身就可能违反上游服务条款。这类服务不要用于生产环境或重要私有代码；确有合规要求，就走官方云厂商的兼容端点或官方订阅。
三类高频故障的排查
跑几分钟就被 Rate Limited
- 分清是 RPM 还是 TPM 打满：Claude Code 每轮都会带上文件内容和工具结果，TPM 更容易先触顶。
- 压缩上下文：用
/compact，明确要求只读某几个文件，避免大范围全库检索。 - 降低并发：不要同时开多个会话或多个子 agent。
- 把后台小任务（生成提交信息、格式化）指向更便宜的模型。
- 客户端加重试要带指数退避，触发限流后立刻重发只会延长封禁时间。
token 消耗远超预期
- 成本大头是工具循环：读文件、跑命令、再读结果，每一轮都计费。
- 按「单价 × 每日 token 量」估月成本，不要按聊天次数估。
- 高频但简单的任务用低阶模型，复杂重构再切回主力模型。
免费额度不够用、白天连不上
把免费额度当作「连通性测试」，正式工作至少准备一个付费备选。公益站点在流量高峰不可用属于常态，不要把它排进工作流的关键路径。
一份可执行的落地清单
- 用官方渠道的最小额度跑通一条完整链路：读文件、改代码、执行测试。
- 记录基线：一次典型任务消耗多少 token、耗时多久、是否触发限流。
- 按基线选档位，而不是只看单 token 价格。
- 端点和密钥写进
settings.json或密钥管理工具，不同项目用不同 profile。 - 准备 fallback：主端点限流时能脚本化切到备用端点。
- 含敏感代码的仓库，禁用会留存请求内容的第三方中转。
- 长任务注意网络：本地网络抖动会让流式连接中断，重试又把 token 重新计一遍。如果经常需要让 Claude Code 长时间挂着跑，可以把会话放到一台长期在线的远程 Mac 上执行（整机放在机房、按月租用、远程连接），减少断线和休眠带来的返工；是否值得取决于你的工作方式。
小结
Claude Code 的接口选择本质是一道成本、稳定性与合规的三角题：官方云厂商端点胜在可控，代价是额度和限流；第三方中转胜在便宜，代价是随时可能消失和看不见的数据风险。接入方式只有那几个环境变量，难点从来不在配置，而在选型和用量控制。各家模型名、赠送额度、限流阈值和接入文档都变化很快，动手前请以官方最新说明为准。