KarpelesLab/teamclaude

何を解決するか

TeamClaude は、Claude Code や Codex などのコード作成エージェントが API クォータ制限により停止するのを防ぐためのマルチアカウントプロキシです。Claude Max、ChatGPT/Codex、APIキーベースのアカウントなど複数のアカウントをプールし、1つのアカウントがセッション制限（5時間）または週次制限（7日）に達すると、自動的に次の利用可能なアカウントに切り替えることで、長時間のコード作業を途切れなく継続可能にします。

動作方法

このツールは、コードエージェントとプロバイダーの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 などの第3者 Anthropic互換APIを低優先度のフォールバックとしてサポート。
• 依存関係ゼロ：Node.jsのビルトインのみを使用して構築。
• リクエスト保持：クォータリセットまでリクエストを保持し、429エラーを返さずに待機可能。