ccLoad: упрощает работу с несколькими ИИ API и ключами

ccLoad: упрощает работу с несколькими ИИ API и ключами

ccLoad — это саморазворачиваемый API шлюз для работы с Claude Code, Codex и Gemini, который упрощает управление несколькими API-ключами и подписками. Если ты работаешь с несколькими ИИ-сервисами, то этот проект позволяет агрегировать запросы через один конечный точку, автоматически обрабатывая сбои и конвертацию протоколов, а также учитывая затраты.

Вместо настройки каждого клиента отдельно, ccLoad предоставляет один адрес и токен, что значительно упрощает интеграцию. При исчерпании лимита одного из источников, шлюз автоматически перенаправляет запросы к следующему. Проект использует язык Go, и его можно запустить на собственном сервере или компьютере.

Обрати внимание на ограничения: данный проект предназначен только для частного использования, и его работа в полной мере зависит от корректной конфигурации всех используемых источников.

ccLoad — это самостоятелный API шлюз для работы с Claude Code, Codex, Gemini и клиентами, совместимыми с OpenAI. Он позволяет объединить несколько источников AI, таких как официальные API ключи и подписки, и упрощает их управление. Каждый клиент получает доступ через один адрес и токен ccLoad, что значительно упрощает интеграцию и монетизацию.

Зачем нужен ccLoad?

Проект создан для разработчиков, у которых есть несколько подписок на AI-сервисы, и для команд, которым необходимо делиться доступом к моделям. ccLoad позволяет:

  • Управлять ключами API и подписками в одном месте, что облегчает поддержку и переключение между источниками в случае перебоев или исчерпания квоты.
  • Создавать индивидуальные токены доступа для каждого пользователя с ограничениями на использование, что упрощает управление затратами.
  • Мониторить работу каналов, отслеживать затраты и использовать очереди для обработки запросов.

Как установить и запустить?

Для установки и запуска ccLoad доступно несколько способов, основные из которых:

  • Docker (рекомендуется):
    docker run -d --name ccload \
      -p 8080:8080 \
      -e CCLOAD_PASS=your_admin_password \
      -v ccload_data:/app/data \
      ghcr.io/caidaoli/ccload:latest
    
  • Docker Compose:
    curl -o docker-compose.yml https://raw.githubusercontent.com/caidaoli/ccLoad/master/docker-compose.yml
    curl -o .env https://raw.githubusercontent.com/caidaoli/ccLoad/master/.env.docker.example
    # Редактируй .env и укажи CCLOAD_PASS как свой пароль администратора
    docker compose up -d
    
  • Homebrew (macOS / Linux):
    brew tap caidaoli/ccload https://github.com/caidaoli/ccLoad.git
    brew install caidaoli/ccload/ccload
    
    mkdir -p "$(brew --prefix)/var/ccload"
    cd "$(brew --prefix)/var/ccload"
    (umask 077; touch .env)
    ${EDITOR:-vi} .env
    
    brew services start caidaoli/ccload/ccload
    
  • Загрузка бинарного файла: скачай файл для своей платформы и запусти его с установленным паролем администратора.

Проверь, что сервис запущен:

curl http://localhost:8080/health

Как работает ccLoad?

ccLoad направляет запросы, обрабатывает их и управляет каналами с возможностью переключения на резервные источники в случае ошибок. Он поддерживает:

  • Различные протоколы от клиентов и перевод между ними.
  • Систему приоритетного маршрутизирования запросов с учётом состояния каналов.
  • Мониторинг использования и затрат, чтобы контролировать расходы на API.

Ограничения и ошибка

Некоторые распространённые проблемы:

  • Сервис завершается при старте, если не установлен пароль CCLOAD_PASS.
  • Запросы возвращают 401, если не указан или не правильный токен API.
  • Модель не найдена (404) или нет доступного источника (503).

ccLoad предоставляет гибкое решение для управления несколькими AI-источниками и упрощает работу с ними, что особенно полезно для разработчиков и команд.

Радар проекта: 70 из 100 — крепкий проект

ИмпульсТемпЗрелостьСообществоСвежестьСтартПродакшенДовериеДокументацияЭкосистема70
  • Импульс 10 ≈ 21 звезда в месяц
  • Темп разработки 100 592 коммита за 12 недель
  • Зрелость 88 проекту 14 месяцев, больше 100 релизов
  • Сообщество 54 20 участников, 77 форков
  • Свежесть 99 последний коммит — 2 дня назад
  • Быстрый старт 90 есть: команда установки, Docker, сайт/демо
  • Готовность к продакшену 70 релиз v4.13.16-beta.4, автосборка
  • Безопасность и доверие 40 лицензия MIT
  • Документация 94 README 19.4 тыс. знаков, 24 раздела, папка docs
  • Экосистема 55 4 подписчика на обновления, 20 тем
Как считаем

Только открытые данные GitHub на 06.11.2026, без оценок нейросети. Каждая ось — от 0 до 100, итог — среднее.

  • Импульс — звёзд в день: за время наших замеров, а пока их нет — за всю жизнь проекта; 200 в день — максимум.
  • Темп разработки — коммитов за последние 12 недель; 300 — максимум. Пока GitHub не досчитал статистику, ось не учитывается.
  • Зрелость — возраст проекта (3 года — максимум) и число релизов (30 — максимум), поровну.
  • Сообщество — участников с коммитами (200 — максимум) и форков (5000 — максимум), поровну.
  • Свежесть — дней с последнего коммита: сегодня — 100, полгода и больше или архив — 0.
  • Быстрый старт — в README есть команда установки, раздел «быстрый старт» или примеры использования, в репозитории — Docker и папка примеров, у проекта есть сайт или демо.
  • Готовность к продакшену — релизы, версия 1.0 и выше, автосборка (GitHub Actions), тесты, лицензия, журнал изменений.
  • Безопасность и доверие — открытая лицензия (своя — половина балла), политика безопасности (SECURITY.md), проект организации, правила для участников, не в архиве.
  • Документация — объём и структура README, папка docs или сайт, оценка «здоровья сообщества» GitHub.
  • Экосистема — звёзды (50 тыс. — максимум), подписчики на обновления (1000 — максимум), темы репозитория.

Открыть на GitHub: caidaoli/ccLoad →

Что нового на GitHub — короткие обзоры на русском Новые обзоры приходят в Telegram. Без спама, по делу.
Подписаться

Похожие статьи

Популярные темы на сайте