lich0821/ccNexus

Intelligent API gateway for Claude Code and Codex CLI - rotate endpoints, monitor usage, and seamlessly integrate OpenAI, Gemini, and other platforms.

What it solves

ccNexus is a proxy agent designed to manage and rotate multiple AI API endpoints. It solves the problem of API instability and authentication complexity by providing automatic failover, format conversion between different AI providers, and a centralized system for managing large pools of authentication tokens.

How it works

The tool acts as an intermediary between AI clients (like Claude Code or Codex CLI) and various AI backends. It provides several key mechanisms:

  • Endpoint Rotation: Automatically switches to a healthy endpoint if the current one fails.
  • API Format Conversion: Translates requests and responses between Claude, OpenAI, and Gemini formats to ensure compatibility across different providers.
  • Codex Token Pool: Manages a batch of access and refresh tokens, handling automatic rotation, refreshing of expired tokens, and isolation of invalid credentials.
  • Configuration Management: Offers a cross-platform GUI (via Wails) or a headless server mode (via Docker) to configure endpoints and sync data via WebDAV.

Who it’s for

Developers and power users who use AI coding tools (specifically Claude Code and Codex CLI) and want to ensure high availability of their AI services by aggregating multiple API keys or providers.

Highlights

  • Automatic Failover: Seamlessly switches endpoints to prevent service interruption.
  • Multi-Provider Support: Supports format conversion for Claude, OpenAI, and Gemini.
  • Token Pool Management: Automated handling of token rotation and refreshing for Codex tokens.
  • Detailed Statistics: Real-time, event-driven tracking of requests, errors, and token usage per credential.
  • Cross-Platform Deployment: Available as a desktop application for Windows, macOS, and Linux, or as a Docker container for server use.

Related

  • Project
    BenedictKing/ccx

    A high-performance AI API proxy and protocol translation gateway that provides a unified entry point for Claude, OpenAI, and Gemini APIs with built-in channel orchestration and failover.

  • Project
    icebear0828/codex-proxy

    A local proxy that converts Codex Desktop's API into OpenAI, Anthropic, and Gemini standard protocols to enable integration with any AI client.

  • Project
    caidaoli/ccLoad

    An AI API gateway that provides smart routing, automatic failover, and cost control for Claude Code, Codex, Gemini, and OpenAI-compatible clients.

  • Project
    SaladDay/cc-switch-cli

    A CLI and TUI switchboard for managing API providers, accounts, and configurations for multiple AI coding assistants like Claude Code, Codex, and Gemini.

  • Project
    farion1231/cc-switch

    A cross-platform manager for AI coding agents and CLI tools that simplifies the configuration and switching between tools like Claude Code, Codex, and Gemini CLI.