[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-70558":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":9,"totalLinesOfCode":9,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":9,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":9,"rankLanguage":9,"license":9,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":22,"hasPages":22,"topics":24,"createdAt":9,"pushedAt":9,"updatedAt":28,"readmeContent":29,"aiSummary":30,"trendingCount":16,"starSnapshotCount":16,"syncStatus":31,"lastSyncTime":32,"discoverSource":33},70558,"ccx","BenedictKing\u002Fccx","BenedictKing","Claude \u002F Codex \u002F Gemini API Proxy - CCX",null,"https:\u002F\u002Fgithub.com\u002FBenedictKing\u002Fccx","Go",3511,265,12,23,0,192,755,1972,576,29.27,false,"main",[25,26,27],"claude","codex","gemini","2026-06-12 02:02:34","# Claude \u002F OpenAI Chat \u002F OpenAI Images \u002F Codex Responses \u002F Gemini API Proxy - CCX\n\nEnglish | [简体中文](README.zh-CN.md)\n\n[![GitHub release](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002FBenedictKing\u002Fccx)](https:\u002F\u002Fgithub.com\u002FBenedictKing\u002Fccx\u002Freleases\u002Flatest)\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-yellow.svg)](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT)\n\nCCX is a high-performance AI API proxy and protocol translation gateway for Claude, OpenAI Chat, OpenAI Images, Codex Responses, and Gemini. It provides a unified entrypoint, built-in web administration, channel orchestration, failover, multi-key management, and model routing.\n\n## Features\n\n- Integrated backend + frontend architecture with single-port deployment\n- Dual-key authentication with `PROXY_ACCESS_KEY` and optional `ADMIN_ACCESS_KEY`\n- Web admin console for channel management, testing, logs, and monitoring\n- Support for Claude Messages, OpenAI Chat Completions, OpenAI Images, Codex Responses, and Gemini APIs\n- Smart scheduling with priorities, promotion windows, health checks, failover, and circuit recovery\n- Per-channel API key rotation, proxy support, custom headers, model allowlists, and route prefixes\n- Responses session tracking for multi-turn workflows\n- Embedded frontend assets for simple binary deployment\n\n## Screenshots\n\n### Channel Orchestration\n\nVisual channel management with drag-and-drop priority adjustment and real-time health monitoring.\n\n![Channel Orchestration](docs\u002Fscreenshots\u002Fchannel-orchestration.png)\n\n### Add Channel\n\nSupports multiple upstream service types and flexible API key, model mapping, and request parameter configuration.\n\n\u003Cimg src=\"docs\u002Fscreenshots\u002Fadd-channel-modal.png\" width=\"500\" alt=\"Add Channel\">\n\n### Traffic Stats\n\nReal-time monitoring of per-channel request traffic, success rate, and latency.\n\n![Traffic Stats](docs\u002Fscreenshots\u002Ftraffic-stats.png)\n\n## Architecture\n\nCCX exposes one backend entrypoint:\n\n```text\nClient -> backend :3000 ->\n  |- \u002F                            -> Web UI\n  |- \u002Fapi\u002F*                       -> Admin API\n  |- \u002Fv1\u002Fmessages                 -> Claude Messages proxy\n  |- \u002Fv1\u002Fchat\u002Fcompletions         -> OpenAI Chat proxy\n  |- \u002Fv1\u002Fresponses                -> Codex Responses proxy\n  |- \u002Fv1\u002Fimages\u002F{...}             -> OpenAI Images proxy\n  |- \u002Fv1\u002Fmodels                   -> Models API\n  `- \u002Fv1beta\u002Fmodels\u002F*             -> Gemini proxy\n```\n\nImages endpoints currently include:\n- `POST \u002Fv1\u002Fimages\u002Fgenerations`\n- `POST \u002Fv1\u002Fimages\u002Fedits`\n- `POST \u002Fv1\u002Fimages\u002Fvariations`\n\nSee [ARCHITECTURE.md](ARCHITECTURE.md) for the detailed design.\n\n## Quick Start\n\n### Option 1: Binary\n\n1. Download the latest binary from [Releases](https:\u002F\u002Fgithub.com\u002FBenedictKing\u002Fccx\u002Freleases\u002Flatest)\n2. Create a `.env` file next to the binary:\n\n```bash\nPROXY_ACCESS_KEY=your-proxy-access-key\nPORT=3000\nENABLE_WEB_UI=true\nAPP_UI_LANGUAGE=en\n```\n\n3. Run the binary and open `http:\u002F\u002Flocalhost:3000`\n\nOn Windows, if the client runs from cmd, PowerShell, WSL, or Docker and `localhost` does not reach CCX, use the Windows host IPv4 address instead, for example `http:\u002F\u002F192.168.1.23:3000`. CCX listens on all interfaces by default through `:PORT`.\n\nFor background startup without Docker, see [Service Startup](docs\u002Fservice\u002FREADME.md).\n\n### Option 2: Docker\n\n```bash\ndocker run -d \\\n  --name ccx \\\n  -p 3000:3000 \\\n  -e PROXY_ACCESS_KEY=your-proxy-access-key \\\n  -e APP_UI_LANGUAGE=en \\\n  -v $(pwd)\u002F.config:\u002Fapp\u002F.config \\\n  crpi-i19l8zl0ugidq97v.cn-hangzhou.personal.cr.aliyuncs.com\u002Fbene\u002Fccx:latest\n```\n\nRun in the background with Docker Compose:\n\n```bash\ndocker compose up -d\n```\n\nEnable Watchtower auto-update:\n\n```bash\ndocker compose -f docker-compose.yml -f docker-compose.watchtower.yml up -d\n```\n\nPull the latest image immediately after setup if needed:\n\n```bash\ndocker compose pull ccx\ndocker compose up -d ccx\n```\n\n### Option 3: Build From Source\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FBenedictKing\u002Fccx\ncd ccx\ncp backend-go\u002F.env.example backend-go\u002F.env\nmake run\n```\n\nUseful commands:\n\n```bash\nmake dev\nmake run\nmake build\nmake frontend-dev\n```\n\n## Core Environment Variables\n\n```bash\nPORT=3000\nENV=production\nENABLE_WEB_UI=true\nPROXY_ACCESS_KEY=your-proxy-access-key\nADMIN_ACCESS_KEY=your-admin-secret-key\nAPP_UI_LANGUAGE=en\nLOG_LEVEL=info\nREQUEST_TIMEOUT=300000\n```\n\n## Main Endpoints\n\n- Web UI: `GET \u002F`\n- Health: `GET \u002Fhealth`\n- Admin API: `\u002Fapi\u002F*`\n- Claude Messages: `POST \u002Fv1\u002Fmessages`\n- OpenAI Chat: `POST \u002Fv1\u002Fchat\u002Fcompletions`\n- Codex Responses: `POST \u002Fv1\u002Fresponses`\n- OpenAI Images: `POST \u002Fv1\u002Fimages\u002Fgenerations`, `POST \u002Fv1\u002Fimages\u002Fedits`, `POST \u002Fv1\u002Fimages\u002Fvariations`\n- Gemini: `POST \u002Fv1beta\u002Fmodels\u002F{model}:generateContent`\n- Models API: `GET \u002Fv1\u002Fmodels`\n\n## Development\n\nRecommended local workflow:\n\n```bash\nmake dev\n```\n\nFrontend only:\n\n```bash\ncd \"frontend\"\nbun install\nbun run dev\n```\n\nBackend only:\n\n```bash\ncd \"backend-go\"\nmake dev\n```\n\n## Additional Docs\n\n- [README.zh-CN.md](README.zh-CN.md)\n- [backend-go\u002FREADME.md](backend-go\u002FREADME.md)\n- [ARCHITECTURE.md](ARCHITECTURE.md)\n- [DEVELOPMENT.md](DEVELOPMENT.md)\n- [ENVIRONMENT.md](ENVIRONMENT.md)\n- [docs\u002Fservice\u002FREADME.md](docs\u002Fservice\u002FREADME.md) - non-Docker service startup\n- [RELEASE.md](RELEASE.md)\n\n## Community\n\nJoin the QQ group for discussion: **642217364**\n\n\u003Cimg src=\"docs\u002Fqrcode_1769645166806.png\" width=\"300\" alt=\"QQ Group QR Code\">\n\n## License\n\nMIT\n","CCX 是一个高性能的AI API代理和协议转换网关，支持Claude、OpenAI Chat、OpenAI Images、Codex Responses以及Gemini等服务。该项目采用Go语言开发，提供统一入口点、内置Web管理界面、通道编排、故障转移、多密钥管理和模型路由等功能。它具备前后端集成架构，单端口部署，双密钥认证机制，支持多种上游服务类型及灵活的API密钥、模型映射配置。此外，CCX还具有智能调度、会话跟踪、实时监控等特性，适用于需要高效管理和优化多个AI服务请求的企业级应用场景中。",2,"2026-06-11 03:32:47","trending"]