KarpelesLab/teamclaude

解决的问题

TeamClaude 是一个专为防止 Claude Code 和 Codex 等代码生成代理因 API 使用配额限制而中断而设计的多账户代理。它允许用户将多个账户（包括 Claude Max、ChatGPT/Codex 以及基于 API 密钥的账户）进行池化，并在某个账户达到会话或每周配额限制时自动切换到下一个可用账户，确保长时间的代码会话持续不断。

工作原理

该工具作为本地代理运行在代码代理与服务提供商 API 之间。它拦截请求并管理池化账户的认证令牌。

1. 账户轮换：通过监控响应头来跟踪会话（5小时）和每周（7天）配额。当账户达到预设阈值（默认98%）时，自动切换到下一个符合条件的账户。
2. 请求路由：注入正确的账户令牌，并重写请求体中的 account_uuid 以匹配当前激活的账户。
3. 智能处理：区分每分钟速率限制（通过控制请求节奏）和已耗尽的配额（通过轮换账户）。
4. MITM 代理：通过本地 MITM 正向代理捕获硬编码的端点（如 Claude Design MCP），确保所有流量均通过代理路由。

适用人群

频繁遇到使用限制的 Claude Code 和 Codex CLI 用户，希望无需手动切换即可无缝管理多个订阅或 API 密钥的开发者。

主要特性

• 自动配额轮换：基于会话和每周配额桶进行账户轮换，优先选择配额即将重置的账户。
• 模型特定追踪：为每个账户分别追踪不同模型（如 Opus、Sonnet、Fable）的配额使用情况。
• TUI 界面：提供终端用户界面，包含配额条、重置倒计时和活动日志。
• 降级支持：支持 DeepSeek 或 GLM 等第三方 Anthropic 兼容 API 作为低优先级降级选项。
• 零依赖：仅使用 Node.js 内置模块构建。
• 请求保持：可在配额重置前保持请求打开状态，而非返回 429 错误。