Coddy Agent
AI агентыRUУниверсальный агент, который поставляется одним статичным Go-бинарником и не тянет за собой ни рантайма, ни пакетного менеджера. Из одного и того же ядра работают четыре поверхности: консоль в терминале, ACP-сервер для редактора, HTTP-шлюз со встроенным веб-интерфейсом и Telegram-бот. Код открыт под MIT. Для нас инструмент не посторонний: NeuralDeep у него заведён отдельным типом провайдера, а вход делается аккаунтом хаба, без ручного переноса ключа.
coddy-project
автор
Go
язык
MIT
лицензия
★ 139
GitHub звёзд
Установка
Каждый релиз публикует ещё .deb и .rpm для x86_64 и arm64 и образ ghcr.io/coddy-project/coddy-agent - на своей машине пакет предпочтительнее скрипта, обновление тогда идёт штатным менеджером. Конфиг создаётся при первом запуске в ~/.coddy/config.yaml. Сборка из исходников нужна только ради своих флагов сборки, и путь модуля там прежний, github.com/EvilFreelancer/coddy-agent: репозиторий переехал в организацию coddy-project позже имени модуля.
Четыре поверхности, одно ядро
Бинарник один, а запусков четыре. Голая команда coddy поднимает консольный интерфейс с потоковым выводом и подтверждением опасных действий; coddy acp превращает его в ACP-сервер для редактора; coddy http отдаёт REST-совместимый шлюз и собранный веб-интерфейс; coddy gateway включает Telegram. Все четыре читают одни и те же сессии из CODDY_HOME, поэтому разговор, начатый в терминале, продолжается в браузере.
Режимов работы три: agent с полным доступом к инструментам, plan с правом писать только текстовые файлы и ask, где модель может читать репозиторий и искать в вебе, но ничего не меняет. Из заметного сверху - субагенты с собственным окном контекста, фоновые команды, хуки на события сессии и планировщик по расписанию.
Навыки и правила: читает чужие форматы
Навыки берутся из skills.dirs, и в дефолтах там ~/.agents/skills, ~/.coddy/skills и .coddy/skills в каталоге проекта, причём последующий каталог перекрывает предыдущий. Первый путь - тот самый общий канон, куда кладёт паки npx skillsbd install -g, так что навык из нашего каталога виден агенту сразу и без обёрток.
Правила подхватываются из .coddy/rules, общей .agents/rules, а также из .cursor/rules, .claude/rules, .codex/rules и вложенных AGENTS.md - диалект выбирается по расширению файла. Определения субагентов и хуков читаются в том числе в формате Claude Code. На практике это значит, что репозиторий, уже размеченный под другого агента, заводится без переписывания разметки.
NeuralDeep подключается входом, а не ключом
В конфиге у провайдера есть собственный тип neuraldeep. Команда coddy providers login neuraldeep открывает браузер, забирает ключ, выданный хабом, и дописывает в конфиг модели тарифа; на машине без браузера тот же вход делается флагом --device. Явно указанный api_key или NEURALDEEP_API_KEY по-прежнему сильнее сохранённого входа.
Пока выбрана наша модель, агент показывает остаток лимитов аккаунта - трёхчасовое и недельное окна с временем сброса и баланс кошелька. Данные берутся из читающей ручки хаба /v1/limits, суммы в долларах там не показываются вовсе. Панель отключается на строке провайдера, если экран общий.
Развёртывания два, и api_base выбирает нужное: https://api.neuraldeep.ru/v1 для России и https://api.neuraldeep.tech/v1 для остального мира. Ключ, выпущенный одним хабом, второй не принимает, поэтому эндпоинт выбирают до входа.
Что учесть до внедрения
У HTTP-поверхности нет своей авторизации: coddy http слушает 12345 и пускает любого, кто до порта дотянулся. Наружу его выставляют только за чужой аутентификацией, а по умолчанию держат на локальном адресе или в доверенной сети.
Проектной папки .agents/skills в дефолтных skills.dirs нет - там только .coddy/skills. Если навыки лежат в проекте рядом с кодом, путь дописывается в конфиг одной строкой, иначе агент их не увидит.
Проект молодой и выходит часто, поэтому перед сверкой конфига полезно заглянуть в его документацию: набор ключей растёт от релиза к релизу.
Частые вопросы
Нужен ли установленный Go?
Нет. Ставится готовый бинарник: скрипт установки для Linux и macOS, PowerShell-строка для Windows, пакеты .deb и .rpm, cask в Homebrew и образ в GitHub Container Registry. Go нужен только тому, кто собирает агента сам с собственным набором тегов сборки.
Как подключить NeuralDeep?
Командой coddy providers login neuraldeep: она открывает браузер, забирает выданный хабом ключ и дописывает в конфиг модели вашего тарифа. На сервере без браузера тот же вход делается флагом --device. Ключ можно и вписать руками в api_key, он сильнее сохранённого входа.
Видит ли он навыки из каталога skillsbd?
Да, и без обёрток. Глобальная установка npx skillsbd install -g кладёт пак в ~/.agents/skills, а этот каталог стоит у Coddy в дефолтных skills.dirs. Для навыков, лежащих внутри проекта, путь до них дописывается в skills.dirs отдельной строкой.
Работает ли он внутри редактора?
Да, через ACP: coddy acp поднимает сервер, а клиентами выступают Zed, VS Code, Obsidian и любой другой ACP-клиент. В настройках редактора указывают абсолютный путь к бинарнику - часть клиентов запускает агента без пользовательского PATH.
Можно ли открыть его веб-интерфейс наружу?
Своей авторизации у HTTP-поверхности нет, поэтому напрямую - нельзя. Порт 12345 держат в доверенной сети либо закрывают внешней аутентификацией, иначе доступ к агенту получает каждый, кто до порта дотянулся.