一個配置文件，35家AI供應商自動切換：我做了個永不撞墻的終端智能體

上個月我在做一個 side project 時，被同一件事反復打斷：剛用 OpenAI 啟動任務，就撞上速率限制；手動切到 Anthropic，又碰上限流；再開一個新標簽頁配置 Gemini。三個 API 控制臺同時開著，三個不同的賬單頁面，而我真正想做的項目就晾在那兒。

我不想為多套 API 付費才能保持工作流。于是做了點東西來解決它。

HelloChusquis 是一個開源終端 AI 智能體，當一家供應商觸及速率限制或宕機時，自動在 35 家以上 AI 供應商之間切換。一個配置文件，零手動切換。

安裝只需一行命令：pip install hellochusquis，然后 hellochusquis --quick 即可啟動。智能體先嘗試你的首選供應商，如果失敗或限流，靜默 fallback 到下一家。你看不到報錯——任務直接完成。

最棘手的 bug 出現在多步驟計劃執行命令時。智能體會生成計劃、開始執行，然后中途丟失工具訪問權限。第 1 步能跑，第 2-6 步報 "Unknown tool" 錯誤。問題根源：工具在初始上下文中可用，但未在每次執行循環中傳遞。修復上下文傳播后，"搜索 AI 新聞并總結前 3 條" 這類多步驟任務才端到端跑通。

核心是一個 ProviderPool 類，追蹤每家供應商狀態。用 dataclass 定義 Provider，包含名稱、base_url、api_key、模型，以及 exhausted 標記和耗盡時間戳。chat 方法篩選可用供應商，逐個嘗試調用；遇到 429、402 或 503 錯誤，標記為 exhausted 并記錄時間，默認 1 小時后自動重置。本質上是把熔斷器模式套用到大語言模型供應商上。

除了 fallback，HelloChusquis 已成長為完整終端智能體。快速安裝后，60 秒完成配置。代碼托管在 GitHub，MIT 協議，永久免費。

如果你也遇到過同樣的速率限制 frustration，想聽聽你怎么處理的——或者希望 HelloChusquis 實現什么新功能。