Чем больше агентов и скилов накапливается в Claude Code, тем острее встаёт вопрос: где они вообще хранятся и что с ними будет, если сменить машину или потерять доступ к аккаунту? Автор статьи на Habr столкнулся с этим лично и вместо ручного копирования файлов создал шаблон claude-config-template — форкаемый Git-репозиторий, который монтируется в ~/.claude/ через симлинки.
Контекст
Claude Code хранит всю пользовательскую конфигурацию в одной директории: ~/.claude/skills/, ~/.claude/agents/, ~/.claude/commands/, ~/.claude/hooks/. Anthropic кладёт туда и свои встроенные файлы — без предупреждения, обновляя при каждом релизе. Если просто клонировать всю папку в Git и залинковать её целиком, встроенные скилы затираются. Поэтому задача нетривиальная.
Практика «конфигурация как код» давно стандартна для dotfiles: nvim, zsh, tmux — всё это годами хранят в Git с симлинками через stow или собственные скрипты. Claude Code — следующий очевидный кандидат. Особенно теперь, когда у многих разработчиков накапливаются десятки агентов и сотни строк правил, которые реально влияют на качество работы.
Решение — поэлементная линковка: скрипт проходит по категориям и создаёт симлинк на каждый отдельный файл, а не на директорию целиком. Так пользовательские скилы живут рядом с встроенными, не мешая друг другу.
Аналитика
На первый взгляд — узкоспециализированный devtool для продвинутых пользователей Claude Code. На деле — индикатор зрелости экосистемы. Когда разработчики начинают версионировать промпты и конфигурации агентов с git blame и pull request'ами — это означает, что AI-инструменты перестали быть экспериментом и стали частью производственного процесса.
Проблема потери наработок при смене аккаунта или машины — не паранойя. Несколько волн блокировок и ограничений сервисов за последние два года (не только Anthropic, но и OpenAI, GitHub Copilot) показали: полагаться на облачное хранение конфигурации небезопасно. Локальный Git с push в приватный репозиторий — единственный надёжный бэкап.
Отдельно важен набор линтеров. Claude Code молча игнорирует файл с кривым frontmatter — никакого сообщения об ошибке, скил просто не появляется. В команде это означает часы отладки «почему агент не работает». Pre-push хук с yamllint, jsonschema и кастомным lint_skills.py закрывает эту дыру ещё до попадания в main. Это не оверинжиниринг — это базовая гигиена для командной работы.
Кейсы применения в бизнесе
B2B-SaaS стартап (5-15 разработчиков). Команда накопила 20+ агентов: для code review, генерации тестов, написания миграций, обновления документации. Без версионирования каждый держит «свою» версию скилов — несовместимые правила, разные результаты. Claude-config-template как общий репозиторий: новый разработчик делает git clone + make install и через минуту работает с теми же агентами, что и вся команда. PR на скил проходит review как обычный код.
IT-студия или аутсорс (КР/СНГ). Работа на разных клиентов с разными стеками — каждый клиент требует своих конвенций и агентов. Решение: основной репозиторий с общими скилами + ветки или форки под каждый проект. Переключение контекста — одна команда. История изменений по агентам доступна через git log.
Соло-разработчик или фрилансер. Несколько машин (рабочий ноутбук, домашний ПК, VPS), периодическая переустановка системы. Без этого шаблона — ручное копирование и гарантированная рассинхронизация. С ним: git clone + make install восстанавливает всё окружение. Бэкап бесплатный — приватный GitHub-репозиторий.
Кейсы в личной жизни
Разработчик, активно использующий Claude Code. Накопил скилы для рефакторинга, документирования, написания тестов. Ставит шаблон, переносит скилы в репозиторий, добавляет make new-skill в workflow. Через месяц — git-история развития своих агентов, возможность откатиться к «той версии, что работала лучше».
Контент-мейкер или маркетолог, работающий с AI-агентами. Собрал агентов для генерации черновиков, адаптации под разные платформы, проверки тона. Хранит их в репозитории, делится с коллегами через форки. Обновление скила = коммит, коллеги получают изменения через git pull.
Студент или начинающий разработчик. Учится работать с Claude Code, постепенно собирает скилы для своих задач. Репозиторий как учебный дневник: видно, как менялись промпты и правила по мере роста понимания. Плюс — make doctor помогает разобраться, почему что-то не работает.
Как применить сегодня
- Найдите репозиторий claude-config-template на GitHub (автор — пользователь Habr, статья ведёт напрямую), сделайте форк в приватный репозиторий.
- Запустите
make install— скрипт создаст симлинки в~/.claude/не затронув встроенные файлы Anthropic. Проверьте вывод: строки с+— новые ссылки,!— конфликты, которые нужно разобрать вручную. - Перенесите существующие скилы и агенты из
~/.claude/в соответствующие папки репозитория, сделайте первый коммит — это ваша точка отката. - Добавьте
make new-skill name=my-skill desc="Что делает"в привычку при создании нового скила: frontmatter генерируется автоматически и сразу проходит линтер. - Настройте GitHub Actions по примеру из шаблона — CI будет проверять YAML, JSON и frontmatter при каждом push, до того как сломанный скил попадёт в рабочее окружение.