🎯 О чём этот конспект: Разбор 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