lich0821/ccNexus

解決的問題

ccNexus 是一個設計用於管理與輪轉多個 AI API 端點的代理代理。它透過提供自動故障轉移、不同 AI 提供商之間的格式轉換，以及集中式的大規模驗證金鑰池管理，解決了 API 不穩定與驗證複雜性的問題。

工作原理

此工具作為 AI 客戶端（如 Claude Code 或 Codex CLI）與各種 AI 後端之間的中介。它提供以下關鍵機制：

• 端點輪轉：若目前端點失效，自動切換至健康的端點。
• API 格式轉換：在 Claude、OpenAI 與 Gemini 格式之間轉換請求與回應，確保不同提供者之間的相容性。
• Codex 金鑰池：管理一組存取與更新金鑰，自動處理金鑰輪轉、過期金鑰的更新，以及無效憑證的隔離。
• 設定管理：透過 Wails 提供跨平台 GUI，或透過 Docker 提供無頭伺服器模式，支援透過 WebDAV 同步資料。

適用對象

使用 AI 程式碼工具（特別是 Claude Code 與 Codex CLI）並希望透過聚合多個 API 金鑰或提供者來確保 AI 服務高可用性的開發者與進階使用者。

主要特色

• 自動故障轉移：無縫切換端點，防止服務中斷。
• 多提供者支援：支援 Claude、OpenAI 與 Gemini 的格式轉換。
• 金鑰池管理：自動處理 Codex 金鑰的輪轉與更新。
• 詳細統計：即時、事件驅動地追蹤每個憑證的請求、錯誤與金鑰使用狀況。
• 跨平台部署：提供適用於 Windows、macOS 與 Linux 的桌面應用程式，或適用於伺服器的 Docker 容器。