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 容器。