Гайд · Claude Code 2026
Пошаговый сетап: MCP-серверы, Skills и рабочий Telegram-контур без copy-paste
Контент-завод в TelegramВы уже копируете ответы из чата в Telegram, правите пост руками и снова кидаете текст в канал. Это работает один раз. На десятый — ломается ритм. Claude Code как раз закрывает эту дыру: агент получает инструменты, повторяемые навыки и доступ к рабочему контуру, а не только «умный диалог».
Ниже — сетап на один вечер: установка → короткий CLAUDE.md → MCP → два Skills → Telegram без хаоса с секретами → проверка и защита. Фокус на маркетологе и контентщике из России, без бэкграунда разработчика.
Коротко. Цель гайда — чтобы агент сам читал контекст, собирал дайджест и готовил черновик поста, а вы только утверждали отправку. Не наоборот.
Установка → CLAUDE.md → MCP → два Skills → Telegram → permissions. Агент пишет дайджест и черновик, вы утверждаете отправку.
drafts/ заполнен, send только после approve, секреты не в git
Claude Code — это не «ещё один чат с Claude». Это CLI-агент: он работает в терминале (или встроенной оболочке), видит проектные файлы и может вызывать внешние инструменты. Без контура вы каждый раз объясняете задачу заново и сами таскаете текст между окнами. С контуром — один раз настроили правила, MCP и Skills, дальше повторяете сценарий командой.
Связка закрывает три роли:
Итог для контента: «чат → задача → черновик → ваш approve → канал». Без бесконечного copy-paste.
Хватит простого CLI, если вы разово правите код или спрашиваете советы по тексту. Агентный контур нужен, когда:
Если цель — контент-пайплайн и автоматизация, контур окупается быстрее, чем ещё одна подписка на чат.
Перед настройкой MCP и Telegram агент должен стабильно стартовать у вас локально. Иначе вы будете чинить «не вижу сервер», хотя проблема в установке.
Практический минимум:
claude — должен открыться интерактивный режим.Признак успеха. Команда claude запускается без ошибки, вы видите приглашение к диалогу, можете задать простой вопрос и получить ответ.
Типичные ошибки новичка:
Запросы «claude code в россии», «подписка» и «бесплатно» всплывают часто — и это не случайность. Anthropic и Claude Code официально рассчитаны на международный аккаунт и оплату. Из России доступ и оплата часто требуют обходных путей (иностранная карта, посредник, корпоративный доступ). Честно: единого «официального rub-тарифа» для всех нет.
Рабочий путь для старта:
Не путайте «скачал CLI» и «есть стабильный доступ к модели». Без доступа к API/подписке MCP и Skills не оживут.
CLAUDE.mdКогда CLI живой, создайте папку проекта (например, content-agent) и откройте Claude Code внутри неё. Здесь появляется файл CLAUDE.md — короткие правила проекта, которые агент подхватывает на старте.
Маркер: простыми словами. CLAUDE.md — это памятка для агента в корне проекта: кто вы, какие файлы трогать, что нельзя делать, в каком тоне писать тексты. Не роман на 20 страниц, а короткий бриф.
Достаточно блока на полэкрана:
drafts/;Почему не раздувать файл. В актуальных практиках вокруг Claude Code советуют держать system-инструкции короткими, а повторяемые процедуры выносить в Skills: тело skill подгружается только когда вы его вызываете. Так агент не «задыхается» от длинного промпта на каждый чих.
Коротко. CLAUDE.md = кто мы и чего нельзя. Skills = как делать конкретную работу.
Без MCP Claude Code умеет то, что заложено в самом агенте. С MCP он подключает внешние инструменты как «розетки».
Маркер: простыми словами. MCP (Model Context Protocol) — единый способ подключить к ИИ-агенту внешние сервисы: файлы, GitHub, Telegram, базы. Часто сравнивают с «USB-C для AI»: один раз подключили сервер — агент получил набор инструментов.
Локальный MCP-сервер обычно запускается у вас на машине (часто через stdio — агент стартует процесс и общается с ним напрямую). Готовые примеры — filesystem, GitHub, community Telegram MCP — берут, когда задача типовая. Свой сервер пишут, когда нужен уникальный API бизнеса.
Для первого вечера берите готовое: filesystem (чтение/запись черновиков) → при необходимости GitHub → затем Telegram.
В чате модель только предлагает текст. Через MCP она может реально:
drafts/post.md;Граница простая: если без copy-paste не обойтись — инструмента ещё нет. Если агент сам достал контекст и положил результат в файл — контур работает.
Подключение — сердце сетапа. Здесь чаще всего путают «прописал JSON» и «сервер реально виден агенту».
Маркер: простыми словами. Scope (область видимости) — где живёт настройка MCP: только в текущем проекте у вас, в общем файле команды через git или во всех ваших проектах сразу.
.mcp.json и scopes: local / user / projectВ Claude Code официально три области:
| Scope | Где хранится | Кому доступен | Когда брать |
|---|---|---|---|
| local (по умолчанию) | запись под путём проекта в ~/.claude.json | только вы, только этот проект | секреты, личные токены, пилот |
| project | файл .mcp.json в корне репозитория | команда через git | общие серверы без секретов в открытом виде |
| user | top-level mcpServers в ~/.claude.json | все ваши проекты | личные утилиты «везде» |
Приоритет при одинаковых именах: local → project → user. Берётся целая запись высшего уровня, поля не «склеиваются».
Для project-scope Claude Code при первом использовании спрашивает approval — это нормально, не обходите предупреждение вслепую.
Секреты в .mcp.json не кладите текстом. Используйте переменные окружения (${VAR}) или флаги --env KEY=value при добавлении сервера. То, что уйдёт в git, рано или поздно утечёт.
Пошагово:
Шаг 1. Добавьте сервер через CLI, например filesystem в scope local:
claude mcp add --scope local filesystem ...(точные аргументы смотрите в актуальной документации Anthropic для выбранного сервера.)
Шаг 2. Проверьте список:
claude mcp listШаг 3. Внутри сессии Claude Code откройте /mcp и убедитесь, что сервер в статусе подключён, инструменты видны.
Шаг 4. Дайте агенту простую задачу: «прочитай файл README и кратко перескажи». Если ответ опирается на файл — MCP живой.
Признак успеха. claude mcp list показывает ваш сервер; в /mcp нет ошибки подключения; агент реально читает/пишет через инструмент, а не «придумывает», что якобы прочитал.
Типичные ошибки:
Официальная база по MCP в Claude Code: документация MCP.
Карта сетапа · Claude Code
Пока конфиг лежит в файле, агент ещё «слепой». Живой контур — когда сервер виден в нужном scope, skill задаёт рецепт, а опасные tools режет gate.
/tg-digest и /draft-post подгружают рецепт только по вызову.drafts/, send не «сам».Дальше разберём Skills и вывод в Telegram без хаоса с секретами — по шагам, которые видите на карте справа.
MCP даёт инструменты. Skills говорят, как ими пользоваться под вашу задачу.
Маркер: простыми словами. Skill — папка с файлом SKILL.md: короткое описание навыка + пошаговая инструкция. Вы вызываете его командой вроде /tg-digest, и агент подгружает рецепт только в этот момент.
SKILL.md и когда писать свой skillДва места хранения:
~/.claude/skills/<имя>/SKILL.md;.claude/skills/<имя>/SKILL.md.В начале файла — YAML frontmatter. Обязателен description (по нему агент понимает, когда skill уместен). Полезны флаги вроде disable-model-invocation (чтобы skill не дергался сам), allowed-tools / disallowed-tools (ограничить инструменты).
Старые custom commands из .claude/commands/*.md по сути слиты со skills: оба формата работают, но skills предпочтительнее.
Пишите свой skill, когда:
Skill 1 — /tg-digest. Задача: прочитать указанные чаты/треды через Telegram MCP → выдать 5–7 пульсов: темы, споры, идеи для контента → сохранить в drafts/digest-YYYY-MM-DD.md. Без отправки куда-либо.
Skill 2 — /draft-post. Задача: взять дайджест или бриф → написать черновик поста под канал → сохранить в drafts/ → не отправлять в Telegram. На send лучше поставить жёсткое ограничение (disable-model-invocation / disallowed tools на отправку), чтобы «умный» агент не решил опубликовать сам.
Так вы получаете конвейер: дайджест → черновик → ваш взгляд → публикация. Это и есть рабочий минимум на вечер, а не «библиотека из 40 skills».
Подробности формата — в официальных Skills.
Здесь новички чаще всего путают два разных контура. Они решают разные задачи.
| Путь | Что получаете | Главный риск | Когда брать |
|---|---|---|---|
| Community Telegram MCP (часто Telethon / user-session) | Агент видит ваши чаты и историю | Session string = доступ к аккаунту | Контент из рабочих чатов |
| Bot API / бот | Только то, что видно боту | Узкий контекст | Публичные бот-сценарии |
| Official Channels (research preview) | Пульт к уже запущенной сессии Claude Code с телефона | Сессия должна быть открыта; preview | Удалённые команды агенту |
Маркер: простыми словами. Session string — сохранённая «уже вошедшая» сессия Telegram (как второй клиент). Утечка почти равна передаче аккаунта: чаты, переписка, отправка от вашего имени. В git и скриншоты чатов её нельзя.
Маркер: простыми словами. Telethon / userbot — библиотека и режим, когда бот действует от имени пользователя, а не как отдельный Bot API-бот. Мощно для чтения личных чатов, но опаснее по безопасности.
Bot API безопаснее для продукта: бот видит только свой контур. User-session / Telethon сильнее для контента: можно собрать дайджест из рабочих чатов. Цена — session string.
Правила пилота:
Official Channels — другой сюжет: ставите плагин Telegram, создаёте бота через BotFather, конфигурируете токен, запускаете Claude Code с channels, делаете pairing и allowlist. Channel пушит события в живую сессию; permissions сессии сохраняются — опасные команды всё равно ждут подтверждения в терминале. Это пульт управления агентом, а не «агент читает все ваши чаты».
Практический разбор community-подхода к Telegram MCP (Telethon, pitfalls) есть, например, на Хабре — полезно как кейс, но сверяйте команды с актуальной документацией Claude Code.
Повторяемый мини-пайплайн:
/tg-digest по нужным чатам./draft-post → получите черновик в drafts/.Признак успеха. В drafts/ лежат дайджест и пост; в канал ничего не ушло без вашего действия; секреты не попали в git (git status чистый от .env и session-файлов).
Просьба в промпте «пожалуйста, не удаляй файлы» — не защита. Правила enforce'ит runtime Claude Code.
Маркер: простыми словами. Permissions — список allow / ask / deny для инструментов. Deny всегда сильнее allow. Hooks — скрипты-перехватчики (например PreToolUse), которые могут остановить опасный вызов ещё до выполнения, даже если модель «очень хочет».
Маркер: простыми словами. Allowlist — белый список: разрешено только то, что явно названо (боты, чаты, команды). Всё остальное по умолчанию закрыто.
Практичный минимум защиты:
drafts/;.env, session string, ключи;Две самые дорогие ошибки:
.mcp.json или в skill «для удобства». Лечится: env, .gitignore, ротация токенов, отзыв сессий.Отдельно: auto-send в канал без approve. Для контента это почти всегда рано. Сначала draft, потом человек, потом send.
Пройдите список один раз перед тем, как пускать контур на рабочие чаты:
claude стартует в нужной папке проектаCLAUDE.md короткий, с запретом самовольной отправкиclaude mcp list показывает только нужные серверы/mcp без ошибок подключения/tg-digest и /draft-post вызываются и пишут в drafts/.env в .gitignoreЕсли пункт не закрыт — это ещё лабораторный стенд, не прод.
Вайбкодинг — когда вы ведёте разработку и автоматизацию диалогом с агентом, а не руками пишете каждый файл. Claude Code в этой нише силён именно как локальный агент с MCP и Skills: вы собираете контур под свой процесс, а не только «спрашиваете модель».
«Создать ИИ-агента» в общем смысле часто значит: выбрать платформу, накидать промпт, подключить одну интеграцию. Сетап из этого гайда уже конкретнее:
Дальше, когда черновики стабильно сыпятся в drafts/, имеет смысл надстроить публикационный слой (Make, очереди, WordPress, серии постов) — это уже территория систем вроде «Контент-завод», а не замена tonight-setup. Не смешивайте «настроил Claude Code за вечер» и «построил весь контент-завод».
Skills без MCP отлично гоняют агента по файлам проекта и вашим инструкциям. MCP нужен, когда контекст или действие снаружи: Telegram, GitHub, внешние API. Если вы только пишете посты из брифа в репозитории — начните со Skills и filesystem. Telegram MCP добавите, когда copy-paste из чатов станет узким местом.
Да, и так даже спокойнее. Порядок: установка → CLAUDE.md → filesystem MCP → Skills черновиков → permissions. Telegram — вторым этапом, когда draft-контур уже предсказуем. Channels (пульт с телефона) подключайте только если реально нужны удалённые команды к живой сессии.
claude mcp add|list, Skills/SKILL.md, permissions/hooks и Telegram Channels — по документации Claude Code / Anthropic.Соберите контур в таком порядке: стабильный CLI → короткий CLAUDE.md → MCP с правильным scope и секретами в env → два Skills без auto-send → выбранный Telegram-путь (чаты или пульт) → permissions/hooks → чеклист. Если агент пишет дайджест и черновик в файлы, а в канал идёт только после вашего «да» — сетап выполнен. Если что-то шлётся само или session string лежит в git — остановитесь и почините защиту, прежде чем масштабировать.
