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 錯誤。