ИИ‑агенты > Pastukhov Agent > Документация > Обвязки

Обвязки

У Pastukhov Agent есть понятие обвязки — это «движок», программа, которая на самом деле выполняет задачи: читает файлы, правит код, запускает команды. Приложение не привязано к одному движку: оно оборачивает любой такой агент и превращает его в полноценный веб-интерфейс с чатом, файлами, сравнением версий (diff), сборками, сессиями и аналитикой. Из коробки доступны десять встроенных обвязок — Claude Code (по умолчанию), Codex, OpenCode, Pi, Oh My Pi, Reasonix, DeepSeek Harness, Kimi Code, MiniAgent и Command Code, — а подключение любой новой занимает около суток по запросу. MiniAgent — единственная обвязка без внешней программы: она встроена прямо в Pastukhov Agent, поэтому её не нужно устанавливать.

Все обвязки устроены одинаково (единый внутренний интерфейс IAgentBackend), поэтому для вас они выглядят одинаково: тот же интерфейс чата, те же навыки, хуки, сборки и статистика. Меняется только «движок» под капотом — какой исполняемый файл реально запускается на каждое сообщение. Навыки при этом загружаются автоматически: требование доставляется каждой обвязке её собственным внеполосным каналом — строкой системного промпта, флагом запуска, переменной окружения или файлом, привязанным к чату (подробнее на странице Навыки).

Как это работает

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

  1. Берётся модель, выбранная для чата;
  2. Если не задано — используется настройка selectedModel;
  3. Если и её нет — берётся модель default;
  4. Из результирующего набора переменных читается AGENT_BACKEND. Если её нет — используется claude-code.

Допустимые значения: claude-code (по умолчанию), codex, opencode, pi, oh-my-pi, reasonix, deepseek-harness, kimi-code, mini, command-code. Таким образом, переключить движок можно для каждого чата отдельно — достаточно сменить у него модель.

Авто-установка. Если нужного исполняемого файла нет на компьютере, Pastukhov Agent установит его сам при первом сообщении (через менеджер пакетов npm), а прогресс в реальном времени покажет прямо в чате. Устанавливать что-либо вручную обычно не нужно. Исключение — MiniAgent: ей внешняя программа не нужна вовсе, потому что она встроена в сам Pastukhov Agent.

Встроенные обвязки

  • Claude Code — пакет @anthropic-ai/claude-code. Базовая обвязка, по умолчанию. Полная поддержка: внутренний прокси, подагенты, навыки, переключение моделей.
  • Codex — пакет @openai/codex. Модели GPT-5 от OpenAI. Вход через подписку ChatGPT (Go/Plus/Pro, безлимит) либо по предоплаченному API-ключу. Протестирован отлично — работает полностью.
  • OpenCode — пакет opencode-ai. Движок-универсал: подключаете любой свой провайдер (Anthropic, OpenAI, Gemini, локальная модель).
  • Pi — пакет @earendil-works/pi-coding-agent. Минимальный расширяемый агент из pi.dev. Работает с любым провайдером по вашему ключу.
  • Oh My Pi — пакет @oh-my-pi/pi-coding-agent. Расширенный вариант Pi из omp.sh: те же возможности плюс готовые пресеты и инструменты из коробки.
  • Reasonix — пакет reasonix. Агент, созданный для DeepSeek (reasonix.io): модели DeepSeek-V4 Flash/Pro, большой контекст — 1 миллион токенов. Ключ DeepSeek, без подписки. Протестирован отлично — работает полностью.
  • DeepSeek Harness — собственный открытый агент DeepSeek (deepseek-harness). Архитектура «всё — плагин»: основной цикл, инструменты и адаптер DeepSeek подключаются как плагины. Модели DeepSeek-V4 Flash/Pro, контекст 1 миллион токенов. Ключ DeepSeek, без подписки.
  • Kimi Code — пакет @moonshot-ai/kimi-code. Агент от Moonshot AI (kimi.com). Работает с моделями Kimi или любым совместимым провайдером по вашему ключу.

Как подключить обвязку

Подключение сводится к созданию модели с правильной переменной AGENT_BACKEND и данными для входа нужного движка:

  1. Откройте Настройки → Модели и нажмите «Создать»;
  2. Выберите готовый шаблон провайдера — Codex, Reasonix, OpenCode, Pi, Oh My Pi, DeepSeek Harness или Kimi Code; для MiniAgent — шаблон провайдера с поддержкой этой обвязки (Anthropic, DeepSeek, z.ai и другие), а для Command Code — модель типа Custom (готового шаблона у него нет). Шаблоны уже содержат AGENT_BACKEND и нужные переменные;
  3. Заполните API-ключ (секретный ключ доступа) или выполните вход (для Codex — кнопка /login с подпиской ChatGPT);
  4. Выберите эту модель у чата — при первом сообщении исполняемый файл установится автоматически.

Либо создайте модель типа Custom и задайте переменные вручную — это даёт полный контроль. Пример для Codex:

AGENT_BACKEND=codex
CODEX_API_KEY=$CODEX_API_KEY      # или вход через ChatGPT вместо ключа
MODEL=gpt-5.6-sol

Claude Code (по умолчанию)

Базовая обвязка, на которой работает всё остальное. Пакет @anthropic-ai/claude-code (по умолчанию 2.1.217), исполняемый файл claude. Поддерживает внутренний прокси-сервер для журнала трафика и подсчёта стоимости, подагенты, навыки и переключение моделей Opus/Sonnet/Haiku на лету.

Вход — через стандартные переменные Anthropic:

  • ANTHROPIC_API_KEY — прямой ключ Anthropic;
  • ANTHROPIC_AUTH_TOKEN — токен для совместимых прокси (например, z.ai);
  • ANTHROPIC_BASE_URL — адрес поставщика или прокси.

Codex

Codex CLI от OpenAI — модели GPT-5. Пакет @openai/codex (по умолчанию 0.146.0), исполняемый файл codex, запускается в режиме codex exec --json: один процесс на сообщение, события приходят потоком в текстовом формате NDJSON (по одной записи на строку), завершение — по выходу процесса. Сессии сохраняются и возобновляются через resume.

Два способа входа, управляемые переменной CODEX_AUTH (auto по умолчанию):

  • Подписка ChatGPT (CODEX_AUTH=chatgpt) — безлимитное использование по плану Go/Plus/Pro. Вход выполняется командой /login: открывается ссылка auth.openai.com, вводится код, учётка сохраняется в ~/.codex/auth.json. Расход подписки отслеживается встроенным сервисом.
  • API-ключ (CODEX_AUTH=apikey или когда логина нет) — предоплаченные кредиты. Переменные OPENAI_API_KEY/CODEX_API_KEY и опционально OPENAI_BASE_URL для прокси.

В режиме auto (по умолчанию) Pastukhov Agent сам выбирает: если есть вход в ChatGPT — берётся подписка, иначе — API-ключ.

Доступные модели: gpt-5.6-sol (флагманская), gpt-5.6-luna (быстрая и недорогая). Задаются переменной MODEL.

Codex протестирован отлично и работает полностью — чат, инструменты, сессии, аналитика и отслеживание квоты подписки.

OpenCode

Движок-универсал с opencode.ai. Пакет opencode-ai (актуальная версия), исполняемый файл opencode, запуск opencode run --format json. Альтернативная установка одним скриптом: curl -fsSL https://opencode.ai/install | bash.

Вход — свой ключ провайдера (подписок нет):

  • ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY — ключ нужного провайдера;
  • LOCAL_ENDPOINT — для локальной модели;
  • любые переменные с префиксом OPENCODE_.

Модель задаётся в формате «провайдер/модель», например MODEL=anthropic/claude-sonnet-4-20250514.

Pi

Минимальный расширяемый агент из pi.dev. Пакет @earendil-works/pi-coding-agent (актуальная версия), исполняемый файл pi, запуск в режиме pi --mode rpc — Pastukhov Agent общается с ним по RPC-протоколу (команды set_model и т. п.), сессии сохраняются в текстовом формате JSONL (по одной записи на строку) и возобновляются после перезапуска.

Вход — свой ключ провайдера, как у OpenCode:

  • ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY, LOCAL_ENDPOINT;
  • любые переменные с префиксом PI_.

Модель — в формате «провайдер/модель:мышление», например MODEL=anthropic/claude-sonnet-4-20250514:medium (суффикс :thinking задаёт уровень размышлений).

MiniAgent

MiniAgent — встроенная обвязка: не внешняя программа, а библиотека на C#, вшитая в сам Pastukhov Agent (минималистичный кодинг-агент в духе Pi, полностью переписанный на C#). Никакой внешний процесс не запускается и никакой npm-пакет не устанавливается — обвязка всегда «под рукой» у сервера. Выбирается переменной AGENT_BACKEND=mini.

Возможности — как у Pi: инструменты read, write, edit, bash, grep, find, ls плюс glob и загрузка навыков load_skill, сессии JSONL с возобновлением после перезапуска, переключение модели и уровня размышлений на лету, автоматическое сжатие контекста, повторы при временных сбоях и подсчёт стоимости. Инструменты выполняются последовательно, как в Claude Code. Дополнительно MiniAgent поддерживает именованные профили настроек (файл miniagent.yml, переопределение переменными MINI_PROFILE_*) и инструмент параллельного запуска команд parallel_bash — подробнее на странице MiniAgent.

Модель задаётся в формате «провайдер/модель:мышление», например MODEL=anthropic/claude-sonnet-5:medium (суффикс :thinking задаёт уровень размышлений: off, minimal, low, medium, high). Готовые шаблоны провайдеров — Anthropic, DeepSeek, z.ai, BigModel, OpenRouter, xAI, MiniMax, Moonshot, OpenAI, OpenCode Go/Zen — уже содержат обвязку MiniAgent и её параметры: MINI_BASE_URL (адрес), MINI_API (формат протокола — anthropic-messages или openai-completions), MINI_AUTH (api-key или bearer) и MINI_API_KEY (ключ). Любая модель, которой нет в шаблоне, соберётся автоматически по этим параметрам, а при наличии файла ~/.mini/models.json — из него (формат, совместимый с Pi). Если модель не задана вовсе, по умолчанию используется deepseek/deepseek-v4-flash.

Данные MiniAgent живут в папке ~/.mini (переопределяется переменной MINI_AGENT_DIR): models.json — конфигурация моделей, agent-sessions — сессии (JSONL, возобновляются после перезапуска), skills — дополнительные навыки и глобальный CLAUDE.md.

Из коробки MiniAgent сама делает то, что в других обвязках приходится настраивать: читает CLAUDE.md/AGENTS.md проекта (приоритет у CLAUDE.md), сама находит навыки .claude/skills и размечает интерактивные формы и кнопки (agent.form/agent.button) прямо в системном промпте. Передача изображений в чат пока не подключена — картинки при отправке игнорируются с предупреждением в логе.

Полный обзор возможностей и подключения MiniAgent →

Reasonix

Кодинг-агент, созданный для DeepSeek (reasonix.io). Пакет reasonix (актуальная версия), исполняемый файл reasonix, запуск reasonix run --output-format stream-json --auto: один процесс на сообщение, события приходят потоком (NDJSON), завершение — по выходу процесса. Сессии сохраняются в JSONL и возобновляются через --resume.

Вход — ключ DeepSeek (без подписки, предоплаченные кредиты):

  • DEEPSEEK_API_KEY — ключ для api.deepseek.com;
  • для произвольного провайдера в формате OpenAI (OpenRouter и т. п.) — REASONIX_BASE_URL, REASONIX_API_KEY и модель (REASONIX_MODEL либо MODEL).

Reasonix читает ключи провайдера только из своего конфига (<REASONIX_HOME>/.env), а не из переменных окружения — но Pastukhov Agent сам подкладывает туда разрешённые ключи перед запуском, вручную ничего настраивать не нужно.

Модели DeepSeek — Flash (быстрая, по умолчанию) и Pro. Контекст — 1 миллион токенов. Задаются переменной MODEL в формате «провайдер/модель» (например deepseek/deepseek-v4-pro); готовые шаблоны окружения Reasonix уже содержат правильное значение.

Reasonix протестирован отлично и работает полностью — чат, инструменты, рассуждения, сессии и аналитика.

Oh My Pi

Расширенная версия Pi из omp.sh. Пакет @oh-my-pi/pi-coding-agent, исполняемый файл omp, запуск в режиме omp --mode rpc — тот же RPC-протокол, что у Pi, поэтому возможности идентичны: сессии, переключение моделей, инструменты. Отличается набором готовых пресетов и инструментов «из коробки», а также хранит сессии в своей папке ~/.omp/agent/sessions.

Вход — свой ключ провайдера, как у Pi:

  • ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY, LOCAL_ENDPOINT;
  • любые переменные с префиксом OMP_ (например OMP_PROVIDER — провайдер по умолчанию, если в модели не указан).

Модель по умолчанию — anthropic/claude-sonnet-5. Уровень размышлений задаётся отдельно после запуска процесса, поэтому суффикс :thinking в имени модели не нужен.

DeepSeek Harness

Собственный открытый агент DeepSeek (github.com/deepseek-ai/deepseek-harness, сокращённо dsh). Его особенность — архитектура «всё — плагин»: основной цикл, инструменты и адаптер DeepSeek подключаются как плагины. Pastukhov Agent запускает его как один постоянный процесс на чат и общается с ним по протоколу JSON-RPC (вызовы функций в текстовом виде): токены, вызовы инструментов, списки задач и стоимость поступают в чат в реальном времени.

Первый запуск. Исполняемый файл не ставится через npm: при первом использовании Pastukhov Agent сам подготовит рабочую папку dsh-runtime в папке проекта (.pastukhov/dsh-runtime), установит зафиксированную версию пакетов и сгенерирует конфиг. Нужен Node.js версии 22.19+ или 24+ — установщик проверит это заранее.

Вход — ключ DeepSeek (без подписки, предоплаченные кредиты):

  • DEEPSEEK_API_KEY — ключ для api.deepseek.com;
  • DEEPSEEK_BASE_URL — адрес другого провайдера в формате OpenAI (по умолчанию — DeepSeek напрямую).

Модели — deepseek-v4-flash (быстрая, по умолчанию) и deepseek-v4-pro (глубже), задаются переменной DSH_MODEL. Контекст — 1 миллион токенов. Смена модели перезапускает процесс агента.

Подагенты DeepSeek Harness открываются отдельными дочерними чатами (как у Claude Code), списки задач отображаются чек-листами, стоимость считается по ценам DeepSeek с учётом кэша. После паузы или перезапуска агент получает краткую сводку прошлого диалога — файлы на диске остаются главным результатом работы.

DeepSeek Harness находится в активной разработке (предварительная версия). Версии пакетов зафиксированы, поэтому обновление происходит осознанно — через переменную DSH_RUNTIME_VERSION.

Kimi Code

Кодинг-агент от Moonshot AI (kimi.com). Пакет @moonshot-ai/kimi-code, исполняемый файл kimi, запуск kimi -p "<промпт>" --output-format stream-json: один процесс на сообщение, события приходят потоком (NDJSON), завершение — по выходу процесса. Сессии сохраняются и возобновляются через --session. Нужен Node.js 22.19+.

Вход — через переменные канала модели (это единственный путь, которым Kimi Code принимает ключ из переменных окружения — обычный KIMI_API_KEY он игнорирует):

  • KIMI_MODEL_NAME — имя модели (наличие этой переменной включает канал);
  • KIMI_MODEL_API_KEY — ключ провайдера;
  • KIMI_MODEL_BASE_URL — адрес провайдера (по умолчанию — провайдер Kimi);
  • KIMI_MODEL_PROVIDER_TYPE — формат протокола: kimi, anthropic или openai;
  • KIMI_MODEL_MAX_CONTEXT_SIZE — размер контекста в токенах (по умолчанию 262144).

Вместо ключа можно использовать уже выполненный вход OAuth (авторизация через браузер), сохранённый в ~/.kimi-code. Готовые шаблоны провайдеров (Anthropic, DeepSeek, Moonshot и т. д.) уже содержат правильные значения — вручную ничего настраивать не нужно.

Command Code

Кодинг-агент от Langbase (commandcode.ai) — кроссплатформенный терминальный агент с закрытым кодом. Пакет command-code, исполняемый файл cmd (на Windows — cmdc), запуск cmd -p "промпт" --output-format json: один процесс на сообщение, события приходят потоком (NDJSON), завершение — по строке результата. Нужен Node.js 22+.

Запись, правка файлов и команды оболочки в headless-режиме по умолчанию запрещены — Pastukhov Agent запускает Command Code с флагом --yolo, который их включает. Сессии на диск не сохраняются: контекст диалога передаётся в каждом новом сообщении.

Вход — только через аккаунт Command (подписка или предоплаченный ключ API; ключи Anthropic/OpenAI/DeepSeek не принимаются):

  • cmd login — вход через браузер (OAuth); учётка сохраняется в ~/.commandcode;
  • COMMAND_CODE_API_KEY — ключ API Command Code; задаётся в конфигурации модели и имеет приоритет над логином.

Модель задаётся переменной MODEL (за аккаунтом Command доступно более 60 моделей). Если модель не задана, cmd использует свою модель по умолчанию; неизвестное имя модели — это ошибка, проверяйте написание. Токены и стоимость приходят в строке результата каждого ответа и попадают в чат и аналитику.

Свои навыки Command Code ищет в папках .commandcode/skills и .agents/skills, поэтому Pastukhov Agent сам добавляет в промпт указатель на навыки .claude/skills — «вызови навык» работает как обычно.

Справочник переменных

  • AGENT_BACKEND — выбор обвязки: claude-code (по умолчанию), codex, opencode, pi, oh-my-pi, reasonix, deepseek-harness, kimi-code, mini, command-code
  • CLAUDE_PATH / CODEX_PATH / OPENCODE_PATH / PI_PATH / OMP_PATH / REASONIX_PATH / KIMI_CODE_PATH / COMMAND_CODE_PATH — путь к конкретному исполняемому файлу (переопределение авто-поиска)
  • CLAUDE_CODE_VERSION / CODEX_VERSION / OPENCODE_VERSION / PI_VERSION / OMP_VERSION / REASONIX_VERSION / KIMI_CODE_VERSION / COMMAND_CODE_VERSION — зафиксировать версию при авто-установке
  • CODEX_AUTH — способ входа в Codex: auto (по умолчанию), chatgpt, apikey
  • OPENAI_API_KEY / CODEX_API_KEY — предоплаченный ключ OpenAI для Codex (+ OPENAI_BASE_URL для прокси)
  • DEEPSEEK_API_KEY — ключ DeepSeek для Reasonix и DeepSeek Harness; либо REASONIX_BASE_URL + REASONIX_API_KEY для провайдера в формате OpenAI (OpenRouter и т. п.)
  • DSH_MODEL — модель DeepSeek Harness: deepseek-v4-flash (по умолчанию) или deepseek-v4-pro
  • DSH_RUNTIME_VERSION / DSH_RUNTIME_DIR / DSH_AGENT_PATH — управление средой запуска dsh (версия пакетов, папка рантайма, явный путь к исполняемому файлу)
  • DSH_PERMISSION_MODE — режим доступа dsh: danger-full-access (по умолчанию) или workspace-write (строже, с запросом разрешений)
  • KIMI_MODEL_NAME / KIMI_MODEL_API_KEY / KIMI_MODEL_BASE_URL / KIMI_MODEL_PROVIDER_TYPE / KIMI_MODEL_MAX_CONTEXT_SIZE — канал модели Kimi Code (см. раздел выше)
  • COMMAND_CODE_API_KEY — ключ API Command Code (приоритет над входом cmd login)
  • MINI_PROVIDER — провайдер MiniAgent по умолчанию, если в модели нет префикса провайдер/
  • MINI_BASE_URL / MINI_API / MINI_AUTH / MINI_API_KEY — параметры подключения MiniAgent для авто-сборки моделей: адрес провайдера, формат протокола (anthropic-messages или openai-completions), тип авторизации (api-key или bearer) и ключ доступа
  • MINI_AGENT_DIR — папка данных MiniAgent (по умолчанию ~/.mini): сессии, models.json, навыки, глобальный CLAUDE.md
  • MODEL — модель в формате, принятом обвязкой (имя для Codex и Command Code, провайдер/модель для OpenCode, Pi, Reasonix и MiniAgent)

Установка и версии

По умолчанию исполняемые файлы ставятся автоматически через npm при первом использовании. Если нужно поставить вручную:

npm install -g @anthropic-ai/claude-code   # Claude Code
npm install -g @openai/codex               # Codex
npm install -g reasonix                    # Reasonix (либо: brew install esengine/reasonix/reasonix)
npm install -g opencode-ai                 # OpenCode (либо: curl -fsSL https://opencode.ai/install | bash)
npm install -g @earendil-works/pi-coding-agent  # Pi
curl -fsSL https://omp.sh/install | sh            # Oh My Pi (npm-пакет сам по себе не запускается)
npm install -g @moonshot-ai/kimi-code            # Kimi Code
npm install -g command-code                    # Command Code (исполняемый файл cmd, на Windows — cmdc; нужен Node.js 22+)
# DeepSeek Harness — без ручной установки: рантайм готовится автоматически (нужен Node.js 22.19+ или 24+)
# MiniAgent — устанавливать нечего: она встроена в Pastukhov Agent

Версию можно зафиксировать переменной окружения (например CODEX_VERSION=0.146.0), либо указать точный путь к исполняемому файлу через *_PATH — тогда авто-установка не понадобится вовсе.

MiniAgent устанавливать не нужно вообще: она встроена в сам Pastukhov Agent, поэтому у неё нет ни npm-пакета, ни переменной версии, ни отдельного исполняемого файла.

Статус и поддержка

  • Claude Code — обвязка по умолчанию, работает идеально: полный функционал без ограничений.
  • Codex протестирован отлично — стабильная полноценная работа: чат, инструменты, сессии, аналитика, отслеживание квоты ChatGPT.
  • Reasonix протестирован отлично — стабильная полноценная работа: чат, инструменты, рассуждения DeepSeek, сессии и аналитика.
  • Kimi Code протестирован отлично — стабильная работа: чат, инструменты, сессии, аналитика по журналу трафика.
  • OpenCode, Pi и Oh My Pi реализованы и подключаются, но как более свежие обвязки могут содержать мелкие шероховатости. Любые баги в них поправимы буквально за пару часов по запросу.
  • Command Code — реализован и подключается; как новая обвязка может содержать мелкие шероховатости, полная проверка с живым ключом ещё впереди.
  • DeepSeek Harness — предварительная версия от DeepSeek: в активной разработке, версии зафиксированы. Работает: чат, инструменты, подагенты, списки задач, стоимость.
  • MiniAgent — встроенная обвязка: работает сразу, без установки; чат, инструменты, сессии, стоимость и аналитика. Прошла полный цикл тестирования — переключение моделей, остановка и возобновление, сжатие контекста.
  • Новая обвязка по запросу — нужно подключить ещё какой-нибудь агент (Gemini CLI, Cursor, Aider и т. п.)? Архитектура IAgentBackend это предусматривает: подключение любой новой обвязки занимает около 1 суток.

← Назад: Модели

Далее: MiniAgent →