Чем ассистент в папке отличается от обычного чата
Ассистент в папке видит файлы на диске, а чат в браузере - нет. Claude Code запускается в терминале внутри рабочей папки и с этого момента читает и правит файлы в ней, подхватывает инструкции из CLAUDE.md, вызывает навыки из .claude/skills и умеет запускать команды. У браузерного чата такого доступа нет по построению.
Собирать ассистент можно не кодом, а словами: файлы навыков и памяти пишет сам Claude Code, если попросить его обычным языком, а команды из этого разбора достаточно скопировать.
Шесть деталей сборки
Ассистент складывается из шести частей: «мозг» - Claude Code, навыки в виде файлов .claude/skills/<имя>/SKILL.md, память в CLAUDE.md, распознавание речи через Whisper, голосовой ответ через системный или локальный синтезатор и небольшой скрипт, который связывает всё в один запуск. Платная в этом списке одна деталь - подписка Claude; распознавание речи и синтез голоса работают локально и бесплатно.
Что нужно до старта
Понадобятся установленный Claude Code с активной подпиской и Python версии 3.9 или новее - он нужен и для распознавания речи, и для синтеза голоса. Проверить установку можно командой claude --version: в ответ должен появиться номер версии. На сборку стоит закладывать пару часов - основная часть времени уходит на загрузку моделей распознавания речи.
Структура папки проекта
Папка проекта держит три вещи: подкаталог .claude/skills с навыками, файл CLAUDE.md с постоянными инструкциями и подкаталог .claude/rules с правилами под отдельные ситуации. Отдельную папку для памяти заводить не нужно - Claude Code хранит её сам в другом месте.
Создайте пустую папку с латинским именем и запустите в ней Claude Code. Попросите словами: «заведи файл CLAUDE.md с правилом отвечать по-русски и папку .claude/skills под навыки» - или используйте встроенную команду инициализации, которая сама читает папку и пишет стартовый CLAUDE.md.
Первый навык
Навык - это папка внутри .claude/skills и файл SKILL.md в ней. Имя папки становится именем команды: файл в папке napishi-post даёт вызов /napishi-post. Внутри файла - короткий заголовок с полями name и description, а ниже обычным текстом инструкция. Описание работает сильнее имени: по нему Claude Code решает, подходит ли навык к вашей просьбе.
Выберите повторяющуюся задачу, попросите Claude Code создать навык под неё с понятным описанием, когда его применять, и проверьте вызов командой с этим именем - перезапускать Claude Code для этого не нужно.
Память: CLAUDE.md и автопамять
У Claude Code есть два вида памяти. CLAUDE.md пишете вы сами - туда идут факты, нужные в каждой сессии: как к вам обращаться, на каком языке отвечать, где лежат заметки. Официальная рекомендация - держать файл короче 200 строк, чем он длиннее, тем хуже соблюдаются инструкции.
Автопамять Claude Code ведёт сам и хранит отдельно от проекта. Проверить, что нужный файл памяти реально загрузился в сессию, можно встроенной командой контекста - в её выводе есть отдельный раздел для файлов памяти.
Подключение заметок
Если заметки хранятся в приложении, которое использует обычные текстовые файлы (например, Obsidian), Claude Code читает их штатными инструментами без дополнительных настроек - достаточно добавить в CLAUDE.md путь к папке с заметками и указание читать подходящие перед ответом. Если папка с заметками лежит вне рабочей директории проекта, к ней нужно явно открыть доступ отдельной командой или флагом при запуске.
Распознавание речи: выбор модели Whisper
Для русской речи стоит выбирать не самую маленькую модель Whisper - младшие версии заметно чаще ошибаются в словах, особенно на разговорной речи, а модель среднего размера справляется значительно точнее ценой немного большего размера на диске и времени обработки. Оба варианта на обычном процессоре без видеокарты работают быстрее реального времени. Язык распознавания стоит указывать явно - иначе модель определяет его по первым секундам и может ошибиться на короткой фразе. Перед распознаванием звук стоит привести к частоте 16 кГц в один канал.
Голосовой ответ
На macOS системный синтезатор речи уже встроен и умеет читать текст на русском языке командой из терминала - ставить ничего не нужно. На Windows и Linux для этого используют отдельный офлайн-синтезатор с открытым исходным кодом; конкретные названия голосов стоит смотреть выводом его собственной команды списка, а не по случайным спискам из интернета, поскольку они меняются между версиями.
Связать всё в один запуск
Небольшой скрипт приводит записанный звук к нужному формату, распознаёт его через Whisper, передаёт текст в Claude Code в неинтерактивном режиме (флаг, который возвращает ответ прямо в вывод команды) и озвучивает результат синтезатором речи. Собирать такой скрипт вручную не обязательно - попросите Claude Code написать его по описанию задачи, он же проверит результат на тестовом файле.
Чек-лист
- Claude Code установлен, версия подтверждена
- Папка проекта создана, структура .claude/skills готова
- Первый навык создан и вызывается командой
- CLAUDE.md заведён и виден в контексте сессии
- Модель Whisper выбрана осознанно, не самая маленькая
- Скрипт связывает распознавание, ответ и голос в один запуск