🎯 О чём этот конспект: Разбор Open Code — опенсорсного AI-агента (ранее известного как терминальный помощник), который эволюционировал в полноценную экосистему. Видео охватывает настройку мультиагентных команд, использование визуального интерфейса, интеграцию с GitHub и работу с изображениями прямо в терминале.
👤 Кому будет полезно: Разработчикам и вайбкодерам, которые хотят выйти за пределы возможностей Cursor и ищут инструмент с глубокой кастомизацией, поддержкой MCP и автономными под-агентами.
✨ Что получите: Пошаговую инструкцию по созданию команды AI-инженеров (Team Lead, PM, Backend, QA), настройку безопасного управления ключами через JIT-токены и способы запуска Open Code на iPad или через Web-интерфейс.
1. Архитектура агентов: Primary и Sub-agents
Контекст: В отличие от простых чатов, Open Code разделяет ответственности. Существуют два основных типа агентов: Plan (только чтение и планирование) и Build (имеет права на исполнение кода). Но настоящая мощь раскрывается в под-агентах (Sub-agents), которым можно делегировать узкие задачи: аудит безопасности, написание тестов или ревью кода. Это снижает галлюцинации, так как у каждого агента узкий контекст и специфические инструкции.
Выгода: Повышение качества кода и возможность параллельного выполнения задач без засорения основного контекста.
Как применить:
Шаг 1: Создание специализированного агента — Используйте встроенный мастер настройки.
open-code agent create
Шаг 2: Описание роли — Введите описание (например, "Security Engineer"). Мастер создаст .md файл с системным промптом, где будут прописаны правила, примеры и ограничения.
Шаг 3: Вызов агента — В основном чате используйте символ @ для делегирования задачи конкретному под-агенту.
@security-reviewer проверь этот эндпоинт на возможность SQL-инъекций
Результат: У вас есть команда узких специалистов, работающих под управлением основного агента.
2. Безопасность через JIT-токены с Dcope
Контекст: Одной из главных проблем при работе с AI-агентами является утечка API-ключей и секретов, которые часто хранятся в .env файлах в открытом виде. Автор предлагает интегрировать инструмент Dcope для реализации концепции Just-In-Time (JIT) доступа. Вместо статических ключей агент запрашивает временный токен, который сгорает через несколько минут.
Выгода: Полное исключение риска кражи долгоживущих API-ключей при коммите или взломе локальной машины.
Как применить:
Шаг 1: Установка Dcope — Интегрируйте Dcope в окружение, где запущен Open Code.
Шаг 2: Настройка Security Sub-agent — В инструкциях агента по безопасности пропишите использование Dcope для получения доступа к инфраструктуре.
Шаг 3: Автоматизация запроса — При необходимости выполнить деплой или обратиться к БД, агент сам инициирует получение короткоживущего токена.
Результат: Безопасная среда разработки, где даже AI-агент не имеет постоянного доступа к критическим ресурсам.
3. Настройка автономной команды (Squad Setup)
Контекст: Для крупных фич автор использует "наивную", но эффективную структуру команды, прописанную в open-code.json. Это позволяет имитировать работу реального IT-отдела внутри одного терминального окна.
Выгода: Структурированный подход к разработке: от сбора требований до тестирования, где каждая стадия проверяется отдельным агентом.
Как применить:
Шаг 1: Настройка Team Lead — Главный агент, который распределяет задачи.
Шаг 2: Конфигурация ролей в open-code.json — Добавьте следующих агентов:
Product Manager: анализирует user stories и структуру проекта (только чтение).
Backend Dev: пишет основной функционал.
Tester/QA: пишет unit-тесты и проверяет пограничные случаи.
Code Reviewer: проверяет стиль и производительность.
Шаг 3: Визуальный контроль — Используйте горячие клавиши (Leader + стрелки), чтобы переключаться между потоками мыслей разных агентов и видеть, например, как PM рисует User Flow, пока Backend пишет код.
Результат: Автономный цикл разработки, где вы выступаете в роли супервайзера.
4. Использование Skills (Навыки) и MCP
Контекст: Навыки (Skills) в Open Code — это не просто промпты, а расширения, которые подгружаются по требованию. Это позволяет не перегружать контекстное окно лишней информацией. Например, навык для работы с AWS нужен только тогда, когда вы трогаете инфраструктуру.
Выгода: Экономия токенов и расширение возможностей агента (доступ к Jira, Kubernetes, GitHub Actions).
Как применить:
Шаг 1: Поиск навыков — Используйте каталоги вроде skills.sh или SkillMP.
Шаг 2: Установка через npx — Для установки официальных или проверенных навыков (например, от Vercel):
npx @vercel/ai-skills install
Шаг 3: Автономный поиск — Вы можете дать агенту навык "поиска и установки других навыков", чтобы он сам находил нужные инструменты для решения вашей задачи.
Результат: Агент, который сам обучается новым инструментам в процессе работы.
5. Мультиплатформенность: Web, GUI и iPad
Контекст: Open Code перестал быть только терминальной утилитой. Теперь его можно запустить как сервер и подключаться к нему через браузер или нативное приложение.
Выгода: Возможность кодить с iPad, лежа на диване, имея полный доступ к локальному контексту проекта и истории сессий.
Как применить:
Шаг 1: Запуск сервера — Выполните команду для поднятия headless-сервера:
open-code serve
Шаг 2: Удаленный доступ — Используйте ngrok для проброса локального порта наружу, чтобы зайти в интерфейс с iPad.
Шаг 3: Использование GUI — Для тех, кто предпочитает нативные окна, установите Open Code GUI (в бета-версии), который поддерживает системные уведомления о завершении задач агентом.
Результат: Гибкая рабочая среда, не привязанная к рабочему столу.
FAQ
В: Чем Open Code лучше Cursor? О: Open Code дает гораздо больше контроля над "личностями" агентов и их правами доступа. Это опенсорс-система, которую можно встроить в CI/CD, запускать в headless-режиме и расширять через MCP (Model Context Protocol).
В: Что такое Zen в контексте Open Code? О: Zen — это роутер моделей. Вы привязываете карту один раз и получаете доступ ко всем топовым моделям (Claude, GPT, Gemini) по себестоимости API-вызовов без наценок, с автоматическим пополнением баланса.
В: Можно ли скармливать агенту скриншоты дизайна? О: Да, если вы используете современные терминалы (WezTerm или Ghostty), вы можете просто перетащить изображение в окно Open Code. Агент проанализирует визуал и сможет реализовать его в коде.
В: Как работает интеграция с GitHub? О: Через команду open-code github install. Это добавляет GitHub Action, который позволяет вызывать агента прямо в комментариях к PR через команду /oc. Он сделает ревью и предложит правки прямо в интерфейсе GitHub.
В: Не слишком ли много токенов тратит мультиагентная система? О: Да, это дороже, чем один чат. Автор рекомендует использовать команду из 4-5 агентов только для крупных фич, а для мелких правок оставлять одного стандартного builder.
Конспект создан на основе видео «Open Code: The Best Coding Agent in 2024» канала SSD Nodes (или аналогичного автора, упомянутого в видео). Все права на оригинальный материал принадлежат авторам.Источник: https://www.youtube.com/watch?v=UhRGHr7pgnU