本文内容
claude-rotate:一个代理管理多个 Claude Max 账户
claude-rotate 在你拥有的多个 Claude Max 或 Pro 账户前放置一个私有端点。当当前账户没有可用配额时,它会把 Claude Code 流量切到下一个账户。这样,笔记本、工作站和个人智能体 pod 不再需要退出登录、浏览器换号、重启终端。claude-rotate 开源仓库采用 MIT 许可,并刻意保持精简:一个 Python 代理进程、一份配置、JSON 状态与审计日志,不需要数据库。
代理可以记录多台设备的用量,同时也能接触凭证和流量。Anthropic 的凭证规则规定哪些应用可以处理这些流量。
采购评估可参考Claude Code 与 OpenCode 团队成本对比。若 gateway 服务于公司而非单个所有者,请先看生产级 LLM gateway 对比。
哪种 Claude Code 访问方式适合你的工作?
| 你的情况 | 更合适的选择 | 原因 |
|---|---|---|
| 同一个人拥有多个付费 Claude 账户,并在多台私人设备工作 | Claude Code 原生登录 | 购买额外订阅前先比较套餐内额度与用量积分。 |
| 一个付费账户只是偶尔触顶 | 等待、换模型或开启 usage credits | 代理会增加安全与运维工作,却不会增加单个账户的配额。 |
| 多名员工或客户需要共享容量 | 使用 Team、Enterprise 或按量 API | 消费者凭证不适合作为身份、治理与计费边界。 |
| 需要每用户预算、SSO、审计导出或合同支持 | 使用生产 gateway 与商业套餐 | claude-rotate 提供设备分析,不是企业控制平面。 |
为什么三个 Claude Max 订阅仍会让一个会话停下
独立订阅不会自动合成一个配额池。每次登录都有自己的额度和重置时间。Anthropic 的当前 Max 套餐说明称,会话用量每五小时重置一次,每周限额则在分配给该账户的固定时间重置。此外还可能有周度、月度、模型或功能限额。因此,一群高负载的 AI 智能体可能耗尽所有机器当前登录的账户,而另一个付费账户仍有额度即将过期。
手动轮换可以工作,但操作成本高。你必须中断任务、退出登录、用另一个账户完成浏览器 OAuth、核对身份,再在每台机器上重复。面对远程 Mac、类似 CI 的个人任务与长时间 loop,注意力损耗往往比登录动作本身更贵。
claude-rotate 如何工作
- 每个 Claude Code 客户端通过
ANTHROPIC_BASE_URL指向代理,并使用独立的内部设备 key 验证。 - 代理将设备 key 替换为当前付费账户的 setup token,再把请求转发给 Anthropic。
- 代理读取响应中的
anthropic-ratelimit-unified-*header,保存观测到的五小时与每周使用率。 - 当前配额耗尽时,一次同步决策选择下一个可用账户。短时突发限流会在同一账户等待重试,避免浪费热缓存。
- 面板按设备、模型与账户聚合审计记录,并计算 API 标价等价值。该金额只是可比 API 用量估算,不是 Anthropic 的订阅配额算法。
Anthropic 官方记录了连接所需的两个基础能力。Claude Code 身份验证文档说明,可用 ANTHROPIC_BASE_URL 设置自定义端点,也可用 claude setup-token 为脚本或 CI 生成长期订阅 OAuth token。但它没有记录或批准多账户池化。两者不能混为一谈。
consume-first 优先保护即将过期的付费容量
Round robin 看似公平,却忽略重置时间。假设账户 A 剩余 15%,今晚重置;账户 B 剩余 70%,六天后才重置。下一次请求发给 B,可能让 A 的剩余额度白白过期。默认 consume-first 策略优先选择最早重置的可用周窗口。直白地说,它先花掉最容易过期的容量。
代理也会区分配额耗尽与短时突发限制。配额拒绝可以触发换号。带 retry-after 的每分钟 429 通常应该在同一账户暂停重试,因为换号只会转移突发压力,还会丢掉 prompt cache 的局部性。阈值、cooldown 与 hysteresis 可减少硬拒绝前的来回切换。
101 项检查证明了什么,又没有证明什么
仓库的 test runner 目前列出 101 项离线检查,覆盖轮换逻辑、分析、HTTP 代理行为与压力场景。其公开的模拟上游结果包括:处理 300 个并发请求,逐字节转发 50 条并行 SSE stream,以及在 100 个请求同时进行时遭遇配额失败,只触发一次账户切换。一个 lock 会串行化 failover 决策,避免整个设备群同时把账户池推进到底。
维护者公布的结果来自单进程和模拟上游环境,衡量的是代理行为和额外开销。正式环境的可靠性、服务商延迟及当前凭证下的表现不在公开测试范围内。
Anthropic 目前的凭证政策
Claude Code 法律与合规文档将订阅 OAuth 用于 Anthropic 原生应用中的正常使用。开发者不得收集、存储或中转 Claude.ai 凭证和会话令牌,也不得代其他用户转发消费者凭证。消费者条款第 3 节原则上要求使用 Anthropic API 密钥进行自动化访问,除非 Anthropic 明确授权,并禁止绕过保护措施。交互式 Claude Code 使用 Anthropic 原生登录,无人值守任务或产品网关使用受支持的 API 密钥认证。
如果真正的问题是限额,还有哪些更稳妥的选择
Anthropic 的 用量积分文档涵盖 Pro、Max 和 Ultra。启用积分后,套餐内额度用完时按标准 API 费率继续使用,直至达到每月上限,或在关闭自动充值时耗尽余额。Max 和 Ultra 还有单独的 Fable 每周限额。合格套餐所含的每月 API 积分独立计算。Anthropic 说明,2026 年 12 月 7 日起购买的大多数用量积分将在 12 个月后到期,具体取决于当地条款。
| 选择 | 运维投入 | 更适合 | 主要代价 |
|---|---|---|---|
| 等待或减少用量 | 低 | 偶尔触顶 | 工作暂停或模型质量变化。 |
| Usage credits | 低 | 不可预测的个人溢出 | 按 API 标价产生浮动支出。 |
| 直连 API 加生产 gateway | 高 | 团队、产品与受治理自动化 | 按量成本与平台工程。 |
| Team 或 Enterprise | 中 | 受管用户与组织控制 | 需要核实合同、seat 与用量经济性。 |
结论
claude-rotate 展示了代理如何集中记录配额,但这也让代理成为凭证存储点和单点故障。个人超额使用可选择设置每月上限的用量积分。组织工作负载应使用商业账户或支持的 API 网关。
