ccNexus CLI
HTTP-шлюз для Claude Code и Codex переключает API-подключения при ошибке и преобразует форматы запросов моделей
- 973 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Шлюз получает ключи моделей и содержимое запросов
- Открытые маршруты без сетевых ограничений позволяют посторонним расходовать подключенный API
- Пул Codex использует подписочные учетные данные и может вызвать ограничения у поставщика
Установка
- Работает в
Ручная установка
docker compose up -d --buildПервая команда Docker-руководства для серверной сборки. Выполните из cmd/server подготовленных исходников; она собирает и запускает контейнер, панель доступна на localhost:3021/ui/. Команду мы не запускали.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Шлюз получает ключи моделей и содержимое запросов
- Открытые маршруты без сетевых ограничений позволяют посторонним расходовать подключенный API
- Пул Codex использует подписочные учетные данные и может вызвать ограничения у поставщика
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
ccNexus принимает запросы кодового агента и отправляет их в настроенный API модели. При сбое одного подключения шлюз может выбрать следующее. Шлюз преобразует запросы между форматами Anthropic, OpenAI и Gemini под выбранного поставщика. Шлюз можно запустить как сервер без настольного окна, в том числе через Docker. Веб-панель позволяет добавить адрес API с ключом, проверить соединение и смотреть статистику. Если указать модель у подключения, она заменит модель из запроса клиента. Claude Code подключают через `ANTHROPIC_BASE_URL`, Codex через описание поставщика в `config.toml`. Отдельный пул поддерживает учетные данные Codex с обновлением токенов.
Для кого. Для разработчиков, которым нужно подключать Claude Code или Codex к нескольким разрешенным API через один адрес.
Подходит, если
- Один API периодически недоступен, и нужно переключаться на запасной
- Агенту нужен совместимый формат запросов при выборе другого поставщика модели
- Нужно сравнить ошибки и расход по нескольким подключениям в общей панели
- Несколько клиентов должны использовать одинаковый набор резервных API
Не подходит, если
- Достаточно одного стабильного API, который клиент поддерживает напрямую
- Нельзя доверить шлюзу ключи и содержимое запросов
- Нужна гарантия, что преобразование API сохранит каждую функцию исходной модели
Пример запроса к агенту
Подготовь ccNexus для двух моих API модели. Покажи настройки Claude Code и проверь, какие маршруты останутся доступны без Basic Auth.Ограничения
Сервер запускается через Docker или собирается на Go; пример Compose публикует порт контейнера 3000 как 3021 на хосте. Демонстрационное API-подключение после старта нужно заменить своим адресом и ключом. Basic Auth защищает только панель: API моделей, `/health` и `/stats` остаются публичными, поэтому для внешнего доступа отдельно нужны TLS и сетевые ограничения. Пул учетных данных не дает дополнительных прав у провайдера и не отменяет его ограничения на использование аккаунта.
Как отключить. Верните в клиенте прежний адрес API или поставщика. В каталоге `ccNexus/cmd/server` выполните `docker compose down`. Сначала сохраните нужные настройки и статистику; отдельное удаление тома с SQLite уничтожит эти данные. При утечке ключей отзовите их у поставщика модели.
Частые вопросы
Как запустить сервер ccNexus?
Клонируйте репозиторий, перейдите в `ccNexus/cmd/server` и выполните `docker compose up -d --build`. Откройте `http://localhost:3021/ui/` и добавьте реальные API-подключения.
Какой адрес указать в Claude Code?
Для серверного примера укажите `http://127.0.0.1:3021` в `ANTHROPIC_BASE_URL`. Порт должен совпадать с вашим Compose; настольный вариант по умолчанию использует 3000.
Где хранится конфигурация сервера?
В SQLite. Путь задает `CCNEXUS_DB_PATH`; в контейнерном примере это `/data/ccnexus.db`. Доступ к файлу и резервным копиям нужно ограничить.
Можно ли использовать подписочные токены Codex?
Да, в коде есть отдельный пул Codex. Для запросов этого пула шлюз имитирует часть HTTP-заголовков клиента Codex. Это не подтверждает разрешение поставщика на такой способ доступа; учетная запись может попасть под ограничения.
Можно ли менять порт сервера?
Да. Используйте `-port` при запуске бинарника или `CCNEXUS_PORT` для сервиса. Проброс порта контейнера и адрес в клиенте измените вместе.
Входит ли доступ к моделям в установку?
Нет. Модели оплачиваются отдельно; MIT относится к коду шлюза.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыZCF
ZCF - Zero-Config Code Flow
CLI, который в один запуск настраивает Claude Code и Codex: рабочие процессы, агенты, скиллы, MCP и выбор провайдера
Комплект переноса рабочего процесса с Claude Code на OpenAI Codex CLI для мультитенантных PHP/Bitrix24-Marketplace-проектов
Claude Codex Settings
claude-codex-settings
Маркетплейс из нескольких десятков плагинов для Claude Code, Codex, Cursor и Gemini: скиллы, команды, хуки, субагенты и конфиги под разные задачи
Codex MCP Tool (cexll)
Codex MCP Tool
MCP-сервер передает задачи Codex CLI из Claude Code и Cursor: разбор кода по ссылкам @, песочница, правки патчем, идеи
Плагин Codex для Claude Code
Codex plugin for Claude Code
Официальный плагин OpenAI: ревью изменений силами Codex и передача задач в Codex прямо из сессии Claude Code
MCP-сервер на вашей машине, через который ChatGPT и Claude правят код, запускают тесты и смотрят Git в локальном репозитории
Коротко о README
Настольные сборки есть для Windows, macOS и Linux. Серверный вариант включает веб-управление, а отдельный API списка моделей поддерживает кеширование.