🎯 О чём этот конспект: Разбор Open Code — мощного open-source аналога Claude Code и Cursor, который позволяет использовать любые LLM (включая бесплатные и локальные) для автоматизации написания кода. В видео демонстрируется архитектура агента, процесс установки десктопного приложения и пошаговое создание Kanban-приложения с нуля.

👤 Кому будет полезно: Вайбкодерам, разработчикам и энтузиастам, которые ищут гибкую и бесплатную альтернативу платным AI-агентам с возможностью тонкой настройки моделей.

✨ Что получите: Вы научитесь настраивать Open Code, подключать различных провайдеров моделей и использовать режимы Plan/Build для итеративной разработки IT-продуктов без затрат на подписки.

1. Архитектура Open Code: Как работает AI-агент

Контекст: Многие путают чат-ботов с AI-агентами. Автор объясняет, что Open Code — это не просто интерфейс к модели, а «агентская обвязка» (harness). Она состоит из трех уровней: Tool Execution Layer (взаимодействие с файлами, терминалом, Git, MCP), Provider Layer (подключение к API моделей) и Model Layer (сама «голова» агента, например, GPT-4 или DeepSeek). В отличие от закрытых решений типа Claude Code, Open Code позволяет менять любой из этих слоев, обеспечивая максимальную гибкость.

Тайминг: [01:18]

Выгода: Понимание того, как агент управляет вашим окружением, позволяет безопаснее и эффективнее делегировать ему сложные задачи по рефакторингу и тестированию.

Как применить:

• Шаг 1: Изучение слоев — Осознайте, что агент видит вашу файловую систему и Git через Tool Execution Layer.
• Шаг 2: Выбор провайдера — Используйте Open Code Zen (собственный слой Open Code) для быстрого старта или подключите свои ключи (Anthropic, OpenAI) через Provider Layer.

2. Установка и настройка Open Code Desktop

Контекст: Хотя Open Code доступен через CLI и расширения для IDE (VS Code, Cursor, Windsurf), автор рекомендует использовать автономное десктопное приложение. Оно предоставляет удобный трехпанельный интерфейс: проекты слева, чат в центре и просмотр кода/Git-изменений справа. Это позволяет полностью сфокусироваться на продукте, не перегружая основную IDE лишними панелями.

Тайминг: [02:55], [03:22]

Выгода: Быстрый старт в визуально понятной среде с удобным контролем версий и управлением контекстом.

Как применить:

• Шаг 1: Скачивание — Перейдите на opencode.ai и скачайте версию для вашей ОС (macOS, Windows, Linux).
• Шаг 2: Настройка разрешений — Нажмите Cmd + , (или Ctrl + ,), перейдите в Permissions. Автор рекомендует оставить авто-подтверждение выключенным (default), чтобы контролировать каждое действие агента.
• Шаг 3: Выбор модели — В нижней панели выберите модель. Для начала отлично подойдет DeepSeek V4 Flash (бесплатно и быстро).

3. Режимы Plan и Build: Правильный воркфлоу разработки

Контекст: Ключевая фишка Open Code — разделение процесса на планирование и исполнение. В режиме Plan агент анализирует задачу и предлагает архитектуру, не меняя файлы. Это экономит токены и предотвращает ошибки. В режиме Build агент приступает к написанию кода и выполнению команд в терминале.

Тайминг: [05:58], [07:31]

Выгода: Снижение количества галлюцинаций и ошибок в коде за счет предварительного согласования плана.

Как применить:

• Шаг 1: Формулировка задачи — Введите промпт в режиме Plan.

  Create a simple to-do web app with local storage. Use minimal CSS and separate files for HTML, CSS, and JS.

• Шаг 2: Ревью плана — Проверьте предложенную структуру файлов и логику. Ответьте на уточняющие вопросы агента прямо в чате.
• Шаг 3: Исполнение — Переключитесь в режим Build и дайте команду:

  Go ahead and implement the plan.

4. Итеративное улучшение: От To-Do списка к Kanban-доске

Контекст: Автор демонстрирует мощь агента, трансформируя простое приложение в сложное. Сначала добавляется функционал Drag-and-Drop, затем приложение переделывается в Kanban-доску с колонками "Working", "Idea", "In Progress" и "Done". Важно: при смене модели на более тяжелую (например, Open Code Zen Super Free) скорость может упасть, поэтому для простых UI-задач лучше использовать быстрые модели типа DeepSeek Flash.

Тайминг: [09:33], [10:58]

Выгода: Возможность быстро прототипировать сложные интерфейсы, просто описывая требования словами.

Как применить:

• Шаг 1: Запрос на трансформацию — Используйте промпт:

  Turn this app into a Kanban board with four groups: Idea, Working, In Progress, and Done. Enable drag and drop between columns.

• Шаг 2: Контроль изменений — В правой панели Open Code следите за тем, как агент меняет JS-логику фильтрации задач.
• Шаг 3: Проверка — Откройте index.html в браузере и протестируйте перетаскивание карточек.

5. Безопасность и откат изменений через Git

Контекст: Работа с AI-агентом всегда несет риск того, что он «сломает» работающий код. Open Code глубоко интегрирован с Git. Автор показывает, как создать репозиторий прямо через агента и как попросить его откатить неудачное изменение.

Тайминг: [11:14], [11:52]

Выгода: Полная безопасность разработки — вы всегда можете вернуться к стабильной версии в один клик или один промпт.

Как применить:

• Шаг 1: Инициализация — Попросите агента: Create a Git repo here.
• Шаг 2: Внесение изменений — Попросите добавить фичу, например: Add a confirmation dialog when deleting a task.
• Шаг 3: Откат — Если результат не понравился, используйте промпт:

  Roll back the previous change.

Агент сам выполнит команду отката в Git и вернет файлы в исходное состояние.

FAQ

В: Чем Open Code лучше Cursor или Claude Code? О: Главное преимущество — это open-source и гибкость. Вы не привязаны к подписке Anthropic или OpenAI. Вы можете подключить любую модель через 75+ провайдеров или запустить локальную модель через Ollama, что делает инструмент потенциально бесплатным и приватным.

В: Можно ли использовать Open Code для существующих больших проектов? О: Да. При открытии папки проекта агент индексирует файлы. Однако помните о лимитах контекста (у стандартных моделей это около 200k токенов). Для очень больших проектов стоит внимательно следить за тем, какие файлы вы добавляете в контекст чата.

В: Что такое режим Reasoning (Low, Medium, High, Max)? О: Это настройка «глубины размышлений» модели. Для простых задач (правка CSS, добавление кнопки) ставьте Low или Medium — это сэкономит время и токены. Для сложной архитектурной логики или поиска багов используйте High или Max.

В: Как посмотреть стоимость генерации кода? О: В окне чата нажмите на иконку контекста (Context Window). Там отобразится количество входных/выходных токенов и итоговая стоимость в долларах (если используете платные API). При использовании бесплатных моделей Open Code Zen стоимость будет $0.

В: Что такое файл agents.md? О: Это файл-инструкция для AI-агентов, который помогает им понять, как работать с вашим репозиторием (как ставить зависимости, запускать тесты и т.д.). Автор рекомендует генерировать его в самом начале работы над проектом.

Ресурсы и ссылки

• Open Code Official — Официальный сайт проекта для скачивания десктоп-версии и CLI — https://opencode.ai
• Models.dev — Платформа, через которую Open Code подключает 75+ провайдеров LLM — упомянут в видео
• DeepSeek V4 Flash — Быстрая и бесплатная модель, рекомендованная автором для UI-задач — доступна внутри приложения
• Patreon автора — Сообщество с промптами и эксклюзивным контентом — первая ссылка в описании видео

Конспект создан на основе видео «Open Code: The Free Open Source AI Coding Agent» канала [имя автора не указано явно, канал посвящен AI-разработке]. Все права на оригинальный материал принадлежат авторам. Источник: https://youtu.be/FyyQuRhpPw8