Циановские инженеры начали внедрять ИИ-помощников для разработки около года назад, а несколько месяцев назад сосредоточились на Claude Code — агентном инструменте от Anthropic, который работает в терминале и умеет самостоятельно читать файлы, запускать команды и итерировать код. Сейчас инструмент используется в командах инфраструктуры, платформы и продуктовой разработки. Андрей, инженер компании, опубликовал разбор проблем, с которыми столкнулась команда.
Первая и самая базовая проблема — где хранить конфигурацию. Для Claude Code репозиторий компонента — нативное место: файл claude.md и папка.claude с агентами, скилами, хуками и settings.json. Если компания решает не класть артефакты ИИ-помощников в репозитории, весь этот слой становится недоступным. Частичное решение — распространять общую конфигурацию через плагины, а компонентоспецифичную информацию отдавать через MCP-интеграцию с внутренними порталами вроде Backstage или Confluence.
| Проблема | Суть | Решение из статьи |
|---|---|---|
| Хранение конфигурации | claude.md и .claude вне репозитория недоступны | Плагины для общей конфигурации, MCP для компонентоспецифичной |
| Windows | Проблемы с bash, слешами, кавычками; разный инструментарий | Ветвление в скилах, универсальная утилита или переход на WSL |
| Ограничение контекста | 200 тыс. токенов заканчиваются до завершения задачи | Архитектура с субагентами, корневой агент только оркестрирует |
| Сторонние субагенты | Субагент из плагина не знает специфики проекта | Скилы с context: fork модифицируют инструкции агента |
| Петли обратной связи | Субагенты не всегда делают то, о чём отчитываются | Корневой агент сам запускает билды, линтеры и тесты |
| Универсальный комбайн | Система «ID эпика → готовый результат» ненадёжна | Обязательный план с чек-листом и хук на Plan Mode |
Вторая проблема — Windows. Поддержка этой ОС появилась в Claude Code сравнительно недавно, в версии 1.0.51, и до сих пор остаётся источником трудностей: инструмент путается в bash-командах, кавычках и слешах. Помимо этого, инструментарий сборки, линтеры и тесты на Windows отличаются от Linux-окружения. Команда рассматривает три подхода: ветвление в скилах по типу ОС, универсальная утилита с единым API поверх платформенных различий и перевод разработчиков на WSL. Для Циана этот вопрос стал аргументом в пользу полного отказа от Windows на машинах разработчиков.
Поддержка Windows появилась в версии 1.0.51, но до сих пор вызывает проблемы с bash-командами, слешами и кавычками.
Третья проблема — контекст. На момент написания статьи максимальный контекст вырос с 200 тысяч до миллиона токенов, но не для всех моделей и не для всех пользователей. При 200 тысячах токенов контекст заканчивается задолго до завершения реальной продуктовой задачи. Компакция контекста в Claude Code работает плохо, поэтому рекомендуется архитектура с субагентами: корневой агент занимается только оркестрацией, а кодинг делегируется специализированным субагентам.
Четвёртая проблема — расширение сторонних субагентов. Субагент из плагина не знает о специфике конкретного проекта: например, что вместо написания кода ему нужно запустить генератор. Недавно в Claude Code появились скилы с параметром context: fork — они работают поверх существующих агентов и позволяют модифицировать их инструкции без форка плагина. Через поле agent можно указать тип субагента: explore, plan, general-purpose или кастомный из.claude/agents/.
Пятая проблема — петли обратной связи. Корневой агент не должен доверять субагентам: он обязан самостоятельно запускать билды, линтеры и тесты, чтобы проверить, ли субагент выполнил задачу. Для этого в корневом агенте активируются те же скилы, что и в субагентах, либо субагентам передаются инструкции по возврату команд для сборки и прогона тестов.
Шестая проблема — соблазн построить универсальный «комбайн». Дать Claude Code ID эпика из Jira и получить готовый результат технически возможно, но на практике такая система ненадёжна. Вместо этого команда предлагает одно обязательное правило: разработка всегда ведётся через план. Неважно, откуда план взялся — из Plan Mode, фреймворка или ручного ввода. Главное — наличие чек-листа: прогон тестов, код-ревью, валидация шагов. Инструмент автоматически дописывает в план недостающие пункты. Если используется Plan Mode, это реализуется через хук на событие перед показом плана пользователю.
Отдельно команда подчёркивает: всё стороннее — плагины, скилы, агенты, MCP-серверы — проходит обязательное security-ревью перед тем, как разработчики получают к ним доступ. Масштаб корпоративного внедрения делает этот шаг обязательным, а не опциональным.
