ccx
SHA-256A high-performance AI API proxy and protocol translation gateway supporting Claude, OpenAI, Gemini, and Codex with built-in web admin, channel orchestration, failover, and multi-key management.
Smart Download
Download Download Version
v2.8.14 · 29 MB
Unified AI API proxy for Claude, OpenAI, Gemini, and Codex with built-in admin UI and failover.
Core Features
- Single-port deployment with built-in web admin and frontend
- Supports Claude Messages, OpenAI Chat/Images, Codex Responses, and Gemini
- Drag-and-drop channel priority, automatic health checks, and failover
- Per-channel API key rotation, proxy settings, model allowlists, and route prefixes
- Built-in session tracking for multi-turn workflows
What It Can't Do
- •CCX is a proxy tool, not an AI service itself; you need your own API keys from upstream providers like OpenAI or Anthropic
- •No built-in billing limits, so monitor upstream API usage to avoid unexpected charges
- •Listens on all network interfaces by default; consider firewall or reverse proxy for production deployments
Use Cases
- Centralized API key management and monitoring for teams using multiple AI providers
- Local or server-based API gateway for developers to easily switch between model vendors
Detailed Introduction
CCX is a unified AI API proxy that bridges multiple upstream services like Claude, OpenAI Chat/Images, Codex Responses, and Gemini. It features a single-port deployment with an integrated web backend and frontend, allowing you to manage channels, monitor traffic, and configure model routing through a visual admin console. Unlike tools like one-api or new-api, CCX offers native support for Claude Messages and Codex endpoints, drag-and-drop priority scheduling, per-channel API key rotation, health checks with automatic failover, and circuit recovery. It can be deployed as a binary, Docker container, or desktop app, making it suitable for both individuals and teams who need a lightweight yet powerful AI gateway with no external database dependencies.
Troubleshooting & FAQ (1)
TroubleshootingWhy does Codex show 'Invalid assistant message: content or tool_calls must be set' after long conversations?
This is a known issue in ccx versions 2.6.77 and 2.6.81 that occurs after extended dialogue. Workaround: start a new chat session to reset the state. No permanent fix yet.
Tags
Getting Started
Download installer
Click the button above to download the installer for your system
Install the software
Double-click the downloaded installer and follow the prompts
Download the latest binary or Docker image from releases
Create a .env file next to the binary with PROXY_ACCESS_KEY, PORT, etc.
Run the binary or start the container, then open http://localhost:3000 to access the web admin
- Download the latest binary or Docker image from releases
- Create a .env file next to the binary with PROXY_ACCESS_KEY, PORT, etc.
- Run the binary or start the container, then open http://localhost:3000 to access the web admin
SHA-256 checksum verified
Checksum extracted from GitHub official Release page
SHA256 Checksum
37f6b8071174684e7a2dae6f4a30967fd3388797efc7a9a3907a1524418b8ae5This checksum is extracted from the GitHub Release page. Verify file integrity after download.
All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.
Open Source Transparency
View GitHub SourceUninstall Info
Simply delete the binary or stop/remove the Docker container. Optionally delete the .config directory if you want to remove all configuration data.
No Extra Dependencies
Ready to use after download. No additional runtime required.
Having issues? Check the FAQ below
1 FAQ
Similar Projects
codex
OpenAI's lightweight coding agent that runs locally in your terminal, with no IDE dependency and seamless ChatGPT integration.
Visual Studio Code (Code - OSS)
A free, open-source code editor by Microsoft with rich extensions, debugging, and Git integration. The most popular developer tool worldwide.
opencode
OpenCode is a free, open-source AI coding agent that helps you write, refactor, and understand code. It offers two built-in modes: a full-access 'build' agent for active coding and a read-only 'plan' agent for safe exploration.