• 🔄 Auto Endpoint Rotation - Seamless failover on errors
• 🔀 Multi-Format Support - Claude, OpenAI, and Gemini API formats
• 🔁 Smart Retry - Automatic retry with endpoint switching
• 📊 Real-time Stats - Monitor requests, errors, and token usage
• 📈 Historical Data - SQLite-based statistics with monthly archives
• 🖥️ Desktop GUI - Cross-platform interface with light/dark themes
• 🚀 Single Binary - No dependencies required
• 🔒 Local First - All data stays on your machine

📥 Download Latest Release

Windows: Extract ZIP and run ccNexus.exe macOS: Extract ZIP, move to Applications, right-click → Open Linux: tar -xzf ccNexus-linux-amd64.tar.gz && ./ccNexus

1. Click "Add Endpoint" and configure:

   • Name: Friendly identifier
   • API URL: e.g., api.anthropic.com
   • API Key: Your API key
   • Transformer: Claude/OpenAI/Gemini
   • Model: Required for OpenAI/Gemini (e.g., gpt-4-turbo)

2. Configure Claude Code:

   • API Base URL: http://localhost:3000
   • API Key: Any value

Claude Code → Proxy (localhost:3000) → Endpoint #1 (fails) → Endpoint #2 (success) ✅

Proxy intercepts requests, forwards to enabled endpoints with round-robin rotation, and automatically retries on failures.

Data Location: ~/.ccNexus/ (Windows: %USERPROFILE%\.ccNexus\)

Files:

• ccnexus.db - SQLite database (config + stats)
• config.json - Legacy config (auto-migrated on first run)

Settings:

• port: Proxy port (default: 3000)
• logLevel: 0=DEBUG, 1=INFO, 2=WARN, 3=ERROR

Prerequisites: Go 1.22+, Node.js 18+

# Clone and run
git clone https://github.com/lich0821/ccNexus.git
cd ccNexus
node run.mjs  # Auto-installs Wails CLI and dependencies

# Build
npm run build              # Current platform
npm run build:prod         # Optimized build
npm run build:windows      # Windows
npm run build:macos        # macOS
npm run build:linux        # Linux

ccNexus/
├── main.go & app.go           # Application entry
├── internal/
│   ├── proxy/                 # HTTP proxy with retry logic
│   ├── storage/               # SQLite persistence + migration
│   ├── transformer/           # API format converters (Claude/OpenAI/Gemini)
│   ├── config/                # Configuration management
│   └── logger/                # Multi-level logging
└── frontend/                  # Vanilla JS UI