Soamee — веб-агентство из Мадрида, которое за полтора года собрало собственный сайт на Claude Code: 639 коммитов, из них 331 с меткой агента (52%), пять языков и продакшен на Dokku. Это перевод-адаптация их открытого пост-мортема с разбором, что агент строил сам, что пришлось делать людям и какие грабли ждут любую команду на этом пути.
В августе 2026 года Javier Manzano, CEO и сооснователь Soamee, опубликовал пост-мортем под названием We Built Our Entire Website with Claude Code — Lessons from the Git Log. Автор сам отмечает неловкость ситуации:
«В публикации этого поста есть что-то неудобное. Soamee — это софтверное агентство. Клиенты нанимают нас, чтобы мы строили цифровые продукты. И за последние полтора года мы активно использовали Claude Code для собственного сайта. Это не маркетинговый текст про ИИ — это честный пост-мортем: что сэкономило нам недели, что пришлось переделывать и почему мы продолжаем пользоваться инструментом, несмотря на его ограничения».
Оригинал — на английском (soamee.com, 06.08.2026); перевод фрагментов в статье наш, ссылки на первоисточник в каждом блоке. Если термины вроде «агентный кодинг» встречаются впервые — сначала стоит прочитать «Что такое агентный кодинг».
Цифры из git-лога
Факты команда взяла не из ощущений, а из истории репозитория. Показатели на момент публикации (пост-мортем Soamee):
- 639 коммитов с января 2025 года;
- 331 коммит с участием Claude Code — в них стоит метка
Co-Authored-By: Claude, это 52% всех коммитов; - 534 .astro-файла в текущем проекте;
- 345 постов блога — опубликованных и в драфте;
- 115 кейсов на нескольких языках;
- 5 языков сайта — испанский, английский, португальский, итальянский и немецкий;
- сайт непрерывно работает в продакшене на Dokku по адресу soamee.com.
Manzano отдельно объясняет, что означает эта 52%:
«То, что в 52% коммитов замешан ИИ, не значит, что Claude Code написал половину кода. Это значит, что он присутствовал больше чем в половине наших рабочих сессий — иногда генерируя целые файлы, иногда предлагая правку на три строки».
Что Claude Code построил
Система переводов
Сайт существует на пяти языках: каждый пост блога, каждый кейс, каждая страница услуг — в версиях ES, EN, PT, IT и DE. Без ИИ это означало бы нанять четырёх переводчиков или смириться с тем, что контент отстаёт от испанского оригинала. Claude Code генерировал черновые переводы:
«Не идеальные. Португальский стремится «протечь» испанским, когда модель теряет контекст, в немецком нужно проверять умлауты, итальянский иногда смешивает регистры. Но рабочий черновик появляется за секунды, а не за дни».
История коммитов это подтверждает — там встречаются коммиты вроде «Revisión contextual del portugués: bloques en español y acentos ambiguos» («Контекстная проверка португальского: блоки на испанском и спорные акценты») и «Corrige contenido en alemán: umlauts, erratas y bloques en español» («Исправление немецкого контента: умлауты, опечатки и блоки на испанском»). Каждый перевод всё равно вычитывается человеком — но вычитать готовый черновик быстрее, чем писать с нуля.
Скрипт проверки переводов
Отдельная история — scripts/translation-checker.cjs: проверка, которая валит CI, если для испанского контента нет версии на остальных четырёх языках. Первую версию написал Claude Code — целиком, включая алиасы категорий, исключения для испанских страниц и интеграцию с pre-push хуком. Это скрипт на ~400 строк Node.js:
«Делает ровно то, что мы специфицировали. Никакой магии. Ровно та задача, где разработчик-человек сидит два часа, а Claude Code справляется за двадцать минут».
Повторяющиеся компоненты
У агентства много страниц одной структуры с разным наполнением — страницы услуг, отраслей, решений. Claude Code сгенерировал большинство из них по уже заданному паттерну; когда паттерн менялся, страницы обновлялись батчами. Ему же принадлежат middleware нормализации URL (HTTP→HTTPS, завершающие слэши, 301-редиректы по ошибкам из Google Search Console), генератор sitemap и несколько CI-скриптов.
Контент блога
Почти каждый пост блога прошёл через Claude Code — от полного черновика по плану до расширения отдельных слабых секций. Автор подчёркивает границу:
«Голос всегда вычитывается. Структуру обычно предлагает он. Данные всегда проверяются вручную».
Что пришлось делать людям
Самый чёткий разделитель проходит по визуальному дизайну. Claude Code умеет реализовать дизайн, который ему точно описали, но не умеет его придумать:
«Визуальная айдентика Soamee — глубокий фиолетовый (#1e1548), мятный (#5dd3b3), диагональные полосы под 45 градусов, концентрические пузыри — это человеческие решения, а не ИИ. Когда мы просили Claude Code „улучшить дизайн блога“, он иногда выдавал технически рабочее, но не звучащее как мы. Пришлось научиться формулировать предельно конкретно: „добавь левую рамку 3px мятного цвета на блокцитаты“ работает, а „улучши дизайн“ — нет».
За людьми остались архитектурные решения: Astro 5 с гибридным SSR, Tailwind CSS v4 ещё до появления нормальной документации (дорогое в смысле отладки решение), Dokku вместо альтернатив. Осталась и реальная бизнес-логика: форма обратной связи через Mailgun, rate limiting, обработка ошибок, обязательные поля — всё это команда проектировала сама, а агент лишь реализовал готовое поведение.
И — ревью каждого PR. Git-лог показывает, к чему приводит пропуск этого шага:
«Ни одно изменение от Claude Code не уходило в продакшен без ревью. Не потому, что мы не доверяем модели, а потому что человеческое ревью ловит то, чего модель знать не может: попадает ли тон абзаца в наш стиль, имеет ли смысл новая фича для бизнеса, туда ли ведёт внутренняя ссылка».
В логе есть коммит «Fix broken internal links: /contacto and /servicios/consultoria-tecnologica» — эти ссылки сломал предыдущий сгенерированный агентом коммит, а исправили уже в следующей ревью-сессии.
Процесс, который сработал
Команда потратила несколько месяцев, чтобы найти рабочий процесс. Что не работает — дать агенту размытую задачу и ждать идеального результата. Что работает — пять правил (пост-мортем Soamee):
- Спецификация до запуска. Перед открытием Claude Code пишется точное поведение, ограничения, краевые случаи. Чем детальнее спецификация — тем меньше итераций.
- Ветки и PR — всегда. Каждое изменение от агента уходит на ветку, никогда напрямую в master. Так можно посмотреть полный дифф перед мержем и легко откатить.
- CI как страховочная сетка. Проверка переводов, проверка картинок, тесты внутренних ссылок — всё в CI. Claude Code иногда генерирует контент, который синтаксически корректен, а семантически нет (ссылка на несуществующую страницу, картинка, которую не создали). Это ловит CI.
- Ревью по секциям. PR на 50 файлов не ревьюится целиком — его делят на тематические блоки: сначала испанский контент, потом переводы одного языка, потом остальных.
- Коммит закрывает человек. Сообщение коммита пишет человек, а не Claude Code. «Маленький, но важный сигнал, что кто-то посмотрел».
Так выглядит рабочий процесс с точки зрения команды: панель Agent View собирает все сессии Claude Code в один экран — что выполняется, что ждёт человека, что готово.
Грабли и как их обходили
Галлюцинации зависимостей
На ранних этапах с Astro 5 и Tailwind v4 Claude Code предлагал API, которых в этих версиях не существовало. Лечение простое и строгое:
«Мы научились всегда сверяться с официальной документацией перед реализацией».
Потеря контекста в длинных сессиях
В очень длинных сессиях модель «забывает» ограничения, заданные в начале. Конкретный пример из лога:
«Мы с самого начала договорились не использовать определённые устаревшие компоненты, и пять часов спустя Claude Code предложил их снова. Короткие сфокусированные сессии работают лучше».
«Дженерик» дизайн по умолчанию
Без предельно конкретных инструкций Claude Code стремится к решениям, которые выглядят как любой другой сайт на Tailwind: технически корректно, визуально безлично. Айдентика бренда требует постоянного надзора — это не разовая настройка, а режим работы.
Португальский перевод — отдельная зона риска
Модель путает испанский и португальский чаще, чем любую другую пару языков — видимо, из-за схожести. Ревью португальских переводов стабильно дольше, чем немецких или итальянских.
Что удивило в плюс
Три вещи команда оценила неожиданно высоко:
- Отладка CSS. Tailwind v4 был новой территорией с редкой документацией — Claude Code помог понять, почему брейкпоинты ведут себя не так, как ожидалось, и как работает система слоёв v4.
- Скрипты автоматизации — его зона комфорта. Чекер переводов, чекер ссылок, генератор sitemap, скрипты SEO-снапшотов: то, что писалось бы днями, генерируется за часы.
- Консистентность между похожими файлами. При заданном паттерне — страница услуги, пост с FAQ, кейс — модель воспроизводит его без отклонений. Люди по своей природе непоследовательны, модель — нет.
Уроки: как повторить этот подход
Из пост-мортема Soamee для команды любого размера вынимается конкретный рецепт.
Репозиторий и правила с самого начала. Файлы-конвенции вроде AGENTS.md решают ровно ту проблему, о которой пишет Manzano: агент в длинной сессии «забывает» договорённости. Подробно про структуру и практику — в нашей статье «AGENTS.md: файл конвенций для ИИ-агентов».
Небольшие задачи. Короткие сфокусированные сессии работают лучше длинных — это прямое наблюдение из кейса. Одна задача на сессию, спецификация до запуска.
CI без исключений. «Каждый раз, когда мы думали „это изменение настолько простое, что не требует полной проверки“, что-то ломалось. CI работает всегда, без исключений».
Человек решает, агент делает объём. Формула автора: use it for volume, not decisions — «используйте его для объёма, а не для решений». Если нужно создать 20 похожих страниц — Claude Code незаменим. Нужно решить, должны ли эти страницы существовать — решаете вы.
Ревью никуда не девается, оно меняет форму. До ИИ-процесса команда тратила время на создание. Теперь — на ревью. Это смена характера работы, а не пропорциональное сокращение.
Если вы только выбираете агента и подписку — актуальное сравнение Claude Code, Codex, Gemini CLI и других в статье «Лучший ИИ-агент для кодинга в 2026», а бесплатные варианты для старта — в «Бесплатные IDE и инструменты для агентского кодинга».
Российские реалии
Кейс Soamee — про платный Claude Code, и для читателей из РФ это сразу два вопроса: как установить и как платить.
- Доступ и установка. Россия не входит в список поддерживаемых стран Anthropic ни для API, ни для claude.ai (список стран): прямой доступ с российского IP заблокирован, нужен стабильный VPN. Пошаговая установка и аутентификация разобраны в нашей статье «Как установить Claude Code».
- Оплата. Бесплатного тарифа у Claude Code нет: Pro — $20/мес, Max — $100–200/мес, либо оплата по токенам через API (claude.com/pricing). Российские карты Visa и Mastercard не работают; реальные пути — UnionPay российских банков (проходят не у всех), крипта через посредников, пополнение баланса API-консоли или юрлицо в поддерживаемой стране. Общие механики оплаты зарубежных подписок из РФ описаны в разборе на Хабре («Как оплатить подписку ChatGPT из России в 2026 году», актуально и для Anthropic по способам).
- Русскоязычный опыт. Тема кейсов «сайт на Claude Code» в рунете почти не освещена — прямых аналогов пост-мортему Soamee я не нашёл. Но свежий практический материал по самому инструменту есть: на Хабре вышло сравнение Codex, Claude Code и Kimi на одной реальной задаче — разработчик прогнал три агента на рабочем лендинге и сравнил результат, стоимость и покрытие тестами (Habr, 4 августа 2026). Общий опыт вайбкодинга с агентами из РФ, включая платные, — в «Как стать вайбкодером».
На момент публикации (август 2026): с 14 августа в Claude Code на планах Pro, Max и Team auto mode становится режимом разрешений по умолчанию — агент сам обрабатывает запросы разрешений через классификатор, а опасные действия блокирует (вместо --dangerously-skip-permissions), плюс появилась cross-session messaging между сессиями (docs.claude.com, неделя 32). Для процесса Soamee это меняет детали (меньше кликов на одобрение), но не суть: ревью, ветки и CI остаются обязательными.
Честные ограничения
- Кейс — про объёмный контент, а не про сложную архитектуру. Soamee делали многостраничный контентный сайт на Astro: переводы, шаблонные страницы, блог. Это сценарий, где агент сильнее всего. Выводы про «Claude Code написал 52% коммитов» не переносятся автоматически на высоконагруженный сервис с бизнес-логикой — там, по их же словам, остались только люди.
- Ревью — обязательное звено, а не опция. Команда закрывала каждый PR человеком и писала сообщения коммитов вручную. Убрать это звено — значит получить «Fix broken internal links» в продакшене.
- Свежесть данных. Цифры верны для репозитория soamee.com на август 2026 года; версии Claude Code и его режимы меняются еженедельно — актуальное состояние сверяйте с официальными доками.
- Это одно агентство. Один стек (Astro, Tailwind, Dokku), один автор, одна команда. Выводы подтверждаются их опытом, а не статистикой по рынку.
Вывод
Кейс Soamee — редкий пример честного пост-мортема: с цифрами из git-лога, списком граблей и правилами, которые команда реально применяет. Ответ на вопрос «построил ли Claude Code soamee.com?» автор формулирует точно:
«Не совсем. Мы построили его, а Claude Code был основным инструментом для объёмной работы. Разница важна: у инструмента нет доли в результате, он не знает контекст бизнеса и не принимает решений, которые определяют продукт».
Git-лог, по словам автора, не врёт. И в этом репозитории связка «спецификация → ветки → CI → ревью человеком» с агентом в роли генератора объёма — работает.
Дальше по теме: что такое агентный кодинг, как установить Claude Code, AGENTS.md: файл конвенций, лучший ИИ-агент для кодинга в 2026, бесплатные инструменты агентского кодинга.