Глоссарий (для новичков): перевод профессионального жаргона на понятный язык
📚 Навигация по серии: Предыдущая статья 51 Устранение неполадок (FAQ / Troubleshooting) помогла разобраться с частыми ошибками и сбоями. В этой статье мы сделаем кое-что более фундаментальное — разберем все понятия, которые встречались на протяжении этого курса. Агентный цикл, окно контекста, MCP, subagent, skill, hook, checkpoint, режим разрешений, headless, transport... За более чем 50 статей накопилось много терминов. Пусть эта страница будет вашим карманным справочником: если какое-то понятие забылось, просто вернитесь сюда и сверьтесь.
Говорят, что «глоссарий нужно прочитать от корки до корки для создания базы», но честно говоря, это самый бесполезный способ чтения.
При изучении любого нового инструмента бессмысленно просто зазубривать глоссарий от А до Я. Вы все равно забудете эти слова через пару минут, потому что они еще ни разу не встретились вам в реальной работе. Термины по-настоящему запоминаются только тогда, когда вы натыкаетесь на них в процессе разработки.
Поэтому я не предлагаю вам просто читать этот текст. Это справочная карточка, а не урок. Продолжайте спокойно учиться и работать, а если споткнетесь о какое-то понятие вроде «что такое transport?» или «зачем нужен auto-compact?», просто вернитесь на эту страницу, найдите нужный пункт, прочитайте определение с простой аналогией — и возвращайтесь к работе. Именно так и стоит использовать глоссарий.
Аналогия: спецификация материалов на строительной площадке. Никто не заучивает этот список наизусть, но при доставке труб или панелей строитель сверяется с ним: «Так, это несущая балка, а это соединитель труб». Сопоставили и продолжили работу. Эта таблица устроена так же: ее не нужно читать целиком, она нужна, чтобы свериться при встрече с термином. Ниже термины сгруппированы по темам (так их легче запомнить, поскольку связанные концепции находятся рядом), и для каждого дано описание в формате «термин → суть в одном предложении → аналогия».
После прочтения (или обратившись к глоссарию в будущем) вы получите:
- Все ключевые понятия из курса, объясненные простым языком с наглядными аналогиями
- Группировку по тематическим семействам для лучшего понимания их взаимосвязи
- Перекрестные ссылки на соответствующие статьи курса для глубокого изучения
- Сравнение часто путаемых терминов для быстрого разграничения
- Практическое упражнение по подключению официального сервера документации для проверки терминов
01 Семейство агентного цикла: Как устроена работа Claude
Это базовый фундамент, который нужно понять в первую очередь. Он отвечает на главный вопрос: чем Claude Code отличается от обычного чат-бота в браузере и почему он способен выполнять задачи самостоятельно. Все остальные термины так или иначе связаны с этой логикой.
Аналогия: автоматизированная сборочная линия. Обычный чат-бот работает по принципу «вопрос-ответ» (как окно заказа). Claude Code — это самостоятельная производственная линия: получив задачу, он сам берет исходные файлы, обрабатывает их, проверяет качество и решает, нужен ли следующий проход. Ниже описаны основные элементы этого процесса.
Agentic loop (Агентный цикл)
Суть: Повторяющийся рабочий цикл Claude при выполнении задачи: сбор контекста → действие → проверка результатов → повтор при необходимости до полного завершения.
Аналогия: процесс приготовления блюда поваром. Он не просто сваливает все ингредиенты в сковороду, а действует поэтапно: добавляет специи → перемешивает → пробует на вкус → досаливает при необходимости. Каждая «проба на вкус» (результат работы инструмента) определяет следующее действие. Вы можете в любой момент прервать процесс или скорректировать его. (Подробнее в Статье 03)
Agentic coding (Агентное программирование)
Суть: Формат работы, при котором AI самостоятельно считывает файлы, запускает консольные команды и изменяет код, пока вы контролируете процесс, вносите правки или отлучаетесь, вместо того чтобы вручную переносить сгенерированный текст.
Аналогия: нанять опытного мастера вместо чтения бумажного руководства. Руководство лишь описывает шаги, а мастер делает всё сам. Claude Code — это практический исполнитель, опирающийся на доступный ему инструментарий. (Подробнее в Статье 01)
Agentic harness (Агентный каркас/обвязка)
Суть: Внешняя программная обвязка, превращающая языковую модель в активного агента разработки: инструменты работы с файлами, исполнение shell-команд, контроль прав доступа, загрузка памяти и координация циклов действий. Claude Code — это каркас, а Claude — модель внутри него.
Аналогия: кузов автомобиля и двигатель. Один и тот же двигатель (модель) в разных кузовах дает совершенно разную динамику и комфорт. Каркас (harness) — это кузов Claude Code, определяющий доступные модели ресурсы и правила взаимодействия с ними. (Подробнее в Статье 03)
Tool (Инструмент)
Суть: Действия, которые Claude может совершать физически: чтение файлов, редактирование кода, запуск shell-команд, поиск в веб-сети или запуск subagents. Без инструментов он может только генерировать текст.
Аналогия: рабочее оборудование на фабрике. Умному конструктору нужны манипуляторы, конвейерные ленты и датчики для сборки деталей. Инструменты — это «руки» Claude, результат работы которых направляется в агентный цикл для принятия следующих решений. (Подробнее в Статье 03)
Turn (Ход/Итерация)
Суть: Полный рабочий цикл от отправки вашего сообщения до окончательного ответа Claude. В рамках одного хода модель может вызывать инструменты множество раз.
Аналогия: один заказ у повара на кухне. Вы озвучиваете пожелание («заказ»), Claude режет продукты, обжаривает их и сервирует блюдо (вызывает инструменты), а вы получаете готовое блюдо («ответ»). Сессия состоит из цепочки таких ходов. (Подробнее в Статье 03)
Verification loop (Цикл валидации/проверки)
Суть: Механизм подтверждения реального завершения задачи, а не просто внешнего соответствия. Вы предоставляете автопроверку (тесты, сборку, сравнение макетов), и Claude правит код до тех пор, пока проверка не выполнится успешно.
Аналогия: самопроверка по ответам в конце учебника. Без готовых ответов вы сдаете работу наобум. Наличие автопроверки заставляет Claude исправлять код до прохождения тестов. Это критически важно при запуске длительных автономных задач — без валидации критерием завершения будет лишь субъективная оценка модели. (Подробнее в Статье 49)
Extended thinking (Глубокое размышление/рассуждение)
Суть: Доступный для просмотра пошаговый процесс рассуждения модели перед выдачей ответа. Отображается в консоли серым курсивом. Объем рассуждений регулируется переменной MAX_THINKING_TOKENS или уровнем effort level.
Аналогия: решение задач на черновике перед записью ответа. Модель не дает ответ мгновенно, а сначала записывает цепочку рассуждений. Это позволяет вам видеть ход его мыслей и легко находить логические ошибки на ранних этапах. (Подробнее в Статье 35)
Effort level (Уровень усилий/сложности)
Суть: Параметр, определяющий объем ресурсов («вычислительного бюджета»), выделяемых на рассуждения в рамках одного хода. Более высокий уровень обеспечивает глубокий анализ, но увеличивает время и стоимость; низкий уровень экономит средства и работает быстрее.
Аналогия: распределение времени на экзамене. Простые вопросы вы решаете быстро (низкий effort), а сложную задачу обдумываете по 10-15 минут (высокий effort). Настраивайте этот баланс в зависимости от сложности задач. (Подробнее в Статье 35)
💡 Краткий вывод: Это семейство описывает механизм автономной работы Claude — в основе лежит цикл «подумать → сделать → проверить» (agentic loop), инструментами выступают его руки, harness — это защитный кузов, extended thinking служит черновиком для расчетов, effort level определяет время обдумывания, а verification loop отвечает за контроль качества.
02 Семейство контекста: Размер памяти и рабочее пространство Claude
Разобравшись с первой группой, вы неизбежно столкнетесь со второй — память Claude ограничена. Термины этого семейства описывают объем удерживаемой информации, поведение при переполнении и очистку истории. Если вам казалось, что Claude забывает контекст, ответы находятся здесь.
Аналогия: рабочий стол определенного размера. Вы чертите схему, но площадь стола ограничена. Если раскладывать чертежи, справочники и наброски бесконечно, место закончится, и придется наводить порядок. Память Claude — это рабочая поверхность стола, а термины ниже описывают управление этим пространством.
Context window (Окно контекста)
Суть: Оперативная память текущей сессии: история сообщений, считанные файлы, вывод терминала, инструкции CLAUDE.md, активные Skills и системные промпты. Размер окна ограничен.
Аналогия: площадь столешницы. Большой стол позволяет разложить много книг и документов, но при его переполнении новые листы перекрывают старые. Команда /context показывает, что именно лежит на столе и сколько места занимает. (Подробнее в Статье 19)
Token (Токен)
Суть: Базовая единица обработки текста моделью (примерно равен слову или его части). Объем контекста и стоимость запросов измеряются в токенах.
Аналогия: вес посылки для расчета доставки. Стоимость отправки посылки зависит от веса, а объем информации для модели измеряется в токенах — все входящие и исходящие тексты переводятся в токены для оценки занятого места и тарификации. (Технические детали токенизации относятся к уровню моделей и здесь опущены).
Compaction (Сжатие контекста)
Суть: Автоматическое суммирование истории диалога для освобождения места при переполнении контекста. Удаляет старые выводы консоли и обобщает беседу. Запускается вручную через /compact.
Аналогия: перенос заметок с черновиков в один итоговый лист. Черновики выбрасываются, на столе остается только выжимка ключевых решений. Важно: файлы CLAUDE.md и auto memory считываются заново с диска, но детали устной беседы при сжатии могут быть утеряны. (Подробнее в Статье 19)
Auto-compact (Автоматическое сжатие)
Суть: Сжатие истории диалога, запускаемое системой автоматически при приближении к лимиту контекста.
Аналогия: датчик переполнения контейнера. Когда контейнер переполняется, конвейер сам сбрасывает лишний груз. Выполняет те же действия, что и /compact, но без участия пользователя. (Подробнее в Статье 19)
Session (Сессия)
Суть: Отдельный поток диалога, привязанный к рабочему каталогу и имеющий собственное окно контекста. Команда /clear создает чистую сессию, а старая сохраняется и может быть восстановлена через /resume.
Аналогия: начало новой задачи с чистого листа. Черновики от предыдущей задачи на столе будут только мешать. Очистив стол (начав новую сессию), вы работаете продуктивнее. История сессий сохраняется в ~/.claude/projects/, поэтому диалог можно продолжить даже после перезапуска консоли командой claude -c. (Подробнее в Статье 19)
CLAUDE.md
Суть: Постоянная инструкция для Claude в корне вашего проекта. Загружается при старте сессии, содержит правила сборки, стайл-гайды и другие соглашения.
Аналогия: памятка для нового сотрудника. К вам каждый день приходит стажер с «амнезией», но памятка на стене помогает ему сразу вспомнить правила проекта. Рекомендуется держать размер файла в пределах 200 строк, перенося справочные данные в Skills. (Подробнее в Статье 18)
Auto memory (Автоматическая память)
Суть: Заметки, которые Claude ведет для себя на основе ваших исправлений и предпочтений. Хранятся как git-репозиторий в ~/.claude/projects/ и частично подгружаются на старте сессии.
Аналогия: личный блокнот стажера для записи ваших замечаний. CLAUDE.md пишется вами в качестве правил, а auto memory заполняется моделью для фиксации собственных ошибок («пользователь просил не использовать npm»). Эти файлы дополняют друг друга. (Подробнее в Статье 25)
Rules (Файлы правил)
Суть: Модульные файлы правил в каталоге .claude/rules/. Параметр paths: позволяет загружать правила точечно при обращении к определенным файлам, сохраняя контекст свободным.
Аналогия: профильные инструкции, открываемые по мере необходимости. CLAUDE.md — это общие правила для всех, а файлы правил — это инструкции для электрика или сантехника, открываемые только при начале соответствующих работ. (Подробнее в Статье 13)
Output style (Стиль вывода)
Суть: Параметр, изменяющий системный промпт Claude для настройки тона, подробности и формата ответов. Доступные стили: Default, Proactive, Explanatory, Learning.
Аналогия: изменение манеры общения диктора. Тот же человек может вести серьезный выпуск новостей или юмористическое шоу. Output style регулирует именно этот «формат вещания», отличаясь от текстовых правил в CLAUDE.md. (Подробнее в Статье 32)
💡 Краткий вывод: Это семейство описывает управление памятью и форматом ответов — окно контекста представляет собой столешницу, токены служат мерой объема, сжатие — это уборка стола при его переполнении, сессия — начало новой задачи с чистого листа, CLAUDE.md, auto memory и rules — памятки на краю стола, а output style меняет стиль вещания.
03 Семейство расширений: Инструменты дооснащения Claude
Этот раздел посвящен кастомизации — как адаптировать Claude к специфике ваших проектов. В Статье 30 детально разобраны критерии выбора расширений. Все они представляют собой точки интеграции на разных этапах агентного цикла.
Аналогия: выдать мастеру специализированный инструмент. Один специалист может работать с базовой инструкцией (CLAUDE.md), но с набором рецептов (Skills), внешним переходником (MCP), помощниками (subagents) и автоматическими триггерами (hooks) его производительность возрастает многократно. Рассмотрим эти расширения подробно.
Skill (Навык)
Суть: Файл SKILL.md, содержащий специализированные знания, инструкции или сценарии. Загружается Claude автоматически по теме обсуждения или вызывается вручную через команду /<имя>.
Аналогия: быстрые команды на смартфоне. Нажатие кнопки «Домой» автоматически гасит свет, включает кондиционер и запускает музыку, избавляя вас от рутины. Skill — это быстрый сценарий для Claude: он содержит готовый шаблон действий, который подгружается в контекст только при необходимости, не забивая оперативную память заранее (принцип прогрессивного раскрытия информации). (Подробнее в Статье 26)
Subagent (Субагент)
Суть: Автономный помощник с собственным окном контекста, системными промптами и набором прав. Вы поручаете ему задачу, а он возвращает только резюме с результатами работы.
Аналогия: делегирование рутины помощнику. Вы просите его проанализировать тридцать отчетов и найти одну цифру. Он проделывает всю работу в стороне, не отвлекая вас, и возвращает готовое число. Главное преимущество — изоляция контекста: промежуточная переписка не засоряет ваш рабочий стол. Доступны Explore, Plan и универсальные субагенты. (Подробнее в Статье 23)
Hook (Хук/Триггер)
Суть: Автоматическое действие (запуск скрипта, shell-команд или отправка уведомления), выполняемое на определенных этапах жизненного цикла Claude Code (перед вызовом инструмента, после изменения файлов, при старте сессии).
Аналогия: конвейерный штамп на производстве. При прохождении детали через рабочий工位 штамп срабатывает автоматически без участия человека или AI. В отличие от CLAUDE.md (который носит рекомендательный характер), хуки гарантируют принудительное исполнение. (Подробнее в Статье 33)
Command / slash command (Слэш-команда)
Суть: Команда, вызываемая через символ / в чате. Встроенные команды (/clear, /model, /compact) управляют сессией, а пользовательские представляют собой Skills, запускаемые через ярлык.
Аналогия: кнопки быстрого доступа на пульте. Кнопка /clear сбрасывает состояние, а созданная вами команда /deploy запускает скрипт публикации проекта. В настоящее время разработчики рекомендуют использовать Skills для создания сложных команд. (Подробнее в Статье 36)
Plugin (Плагин)
Суть: Единый пакет для распространения, содержащий набор Skills, хуков, субагентов и MCP-серверов. Установка плагина сразу активирует весь функционал.
Аналогия: дорожный чемодан с вещами. Вы не несете рубашку, бритву и зарядку в руках, а складываете их в один чемодан. Плагин позволяет переносить настроенный инструментарий между проектами. Для исключения конфликтов имен Skills плагинов поддерживают пространства имен (например, /my-plugin:review). (Подробнее в Статье 24)
Plugin marketplace (Магазин плагинов)
Суть: Платформа для публикации и загрузки плагинов. Позволяет подключать сторонние репозитории плагинов и устанавливать расширения в один клик.
Аналогия: магазин приложений на смартфоне. Вы находите и устанавливаете нужные утилиты. Соблюдайте осторожность: установка плагина из ненадежного источника несет те же риски безопасности, что и запуск неизвестного файла .exe на компьютере. (Подробнее в Статье 38)
💡 Краткий вывод: Семейство расширений расширяет возможности агента — Skills работают как макросы, субагенты (subagents) разгружают контекст, хуки (hooks) автоматизируют рутину, слэш-команды служат кнопками запуска, плагины упаковывают инструменты в чемоданы, а магазины (marketplaces) отвечают за дистрибуцию.
04 Семейство MCP: Протокол интеграции с внешними сервисами
Протокол MCP выделен в отдельную тему, поскольку он содержит собственный набор терминов (transport, server, scope), часто вызывающих путаницу у новичков при настройке. Работа с ним подробно описана в Статье 22.
Аналогия: многопортовый USB-хаб. Если на ультрабуке остался один разъем, к нему нельзя подключить монитор, кабель сети и флешку. Хаб решает эту проблему через один порт. MCP для Claude — это такой хаб, предоставляющий доступ к десяткам внешних приложений одновременно.
MCP (Model Context Protocol / Протокол контекста моделей)
Суть: Открытый стандарт, регламентирующий подключение искусственного интеллекта к внешним базам данных и службам. MCP-серверы связывают Claude с Slack, Jira, СУБД или браузером.
Аналогия: универсальный стандарт USB. Раньше для каждого устройства требовался свой разъем, а стандарт USB объединил мыши, принтеры и флешки под одним штекером. MCP — это стандарт USB для подключения внешнего мира к AI-моделям. (Подробнее в Статье 22)
MCP server (MCP-сервер)
Суть: Конкретное приложение, созданное по стандарту MCP и предоставляющее набор инструментов (например, сервер для GitHub позволяет читать PR и создавать issues).
Аналогия: устройство, подключенное к хабу. Сам хаб — это стандарт (MCP), а внешний накопитель или принтер — серверы (servers), каждый из которых расширяет возможности вашей системы. (Подробнее в Статье 22)
Transport (Транспорт/Протокол передачи)
Суть: Протокол взаимодействия между клиентом Claude Code и MCP-сервером. Используются локальный stdio (запуск процесса на компьютере) и сетевой http (обращение к внешнему веб-адресу).
Аналогия: локальные и сетевые устройства. Протокол stdio запускает утилиту локально на вашем ПК (устройство на столе), а http обращается к удаленному веб-ресурсу (устройство в другой комнате). Ошибки настройки чаще всего связаны с этим: для stdio транспорт опускается, а для http требуется флаг --transport http. (Подробнее в Статье 22)
Scope (Область видимости/доступности)
Суть: Границы доступности MCP-сервера: local (только текущий локальный проект), project (описание в .mcp.json для совместной работы в git) или user (доступен глобально для всех ваших проектов).
Аналогия: общий доступ к принтеру в офисе. Принтер может быть подключен только к вашему ПК (local), открыт для всего отдела (project) или доступен вам на ноутбуке в любой комнате (user). (Подробнее в Статье 22)
MCP Tool Search (Поиск инструментов MCP)
Суть: Оптимизация расхода токенов: при старте загружаются только названия инструментов MCP, а полная спецификация считывается только при непосредственном вызове инструмента.
Аналогия: ознакомление с названиями блюд в меню. Вам не нужно читать рецепты всех ста блюд в меню перед заказом. Вы выбираете название, и только тогда повар открывает рецепт конкретного блюда. Это экономит контекст. (Подробнее в Статье 22)
💡 Краткий вывод: MCP — это стандарт сопряжения AI с внешними сервисами. Сервер (server) является адаптером, транспорт (transport) определяет способ связи (локальный stdio или сетевой http), а область видимости (scope) задает границы использования. Проверяйте надежность сторонних серверов перед подключением.
05 Семейство безопасности и контроля: Степень автономности Claude
После предоставления модели инструментов возникает вопрос контроля действий. Это семейство понятий описывает уровни модерации: от ручного подтверждения каждого шага до принудительной изоляции процессов. Подробно разобрано в Статьях 20 и 21.
Аналогия: уровни безопасности в автомобиле. Ремень безопасности, подушка и дорожные знаки ограничения скорости: один элемент защищает от глупостей водителя, другой спасает при аварии, третий жестко чертит правила движения. Защита Claude также выстроена по слоям.
Permission mode (Режим разрешений)
Суть: Базовый уровень контроля действий Claude в сессии. Доступны шесть режимов: подтверждение каждого шага (default), автопринятие изменений файлов (acceptEdits), режим исследования без записи (plan), полное отключение запросов (bypassPermissions), автоматическая модерация классификатором (auto), фоновое выполнение (dontAsk). Спецификации в Статье 35.
Аналогия: степень доверия стажеру. Вы можете контролировать каждую его задачу («спрашивай обо всем») или разрешить самостоятельно редактировать файлы в определенных рамках. Режимы переключаются в CLI по нажатию Shift+Tab. (Подробнее в Статье 35)
Plan mode (Режим планирования)
Суть: Безопасный режим работы: Claude считывает код, ищет решения, но не вносит изменения в файлы, пока вы не утвердите предложенный им план.
Аналогия: согласование дизайн-проекта перед сносом стен. Строители не начинают крушить перегородки сразу. Сначала они рисуют чертеж перепланировки, согласовывают его с вами и только после одобрения берутся за инструменты. Идеально для крупных доработок. (Подробнее в Статье 35)
Auto mode (Автоматический режим модерации)
Суть: Режим автоматической фильтрации действий. Вызовы инструментов анализируются фоновой моделью-классификатором на предмет подозрительных команд или инъекций, избавляя вас от частых всплывающих окон подтверждения. Находится в режиме превью.
Аналогия: охранник на проходной, проверяющий только пропуска. Он не знает, что именно несет сотрудник в сумке, но проверяет его права на проход в здание. Классификатор не видит выводов инструментов, что защищает от скрытых в них вредоносных команд. (Подробнее в Статье 35)
Permission rule (Правило разрешений)
Суть: Точечное правило (allow / ask / deny) для конкретного инструмента с параметрами. Правила обрабатываются по приоритету deny → ask → allow до первого совпадения.
Аналогия: индивидуальные права доступа в системе контроля доступа. «Этот пропуск открывает дверь на 3-й этаж, но блокирует вход в серверную». Правила накладываются поверх базового уровня разрешений для точной настройки прав. (Подробнее в Статье 20)
Sandboxing (Песочница/Изоляция)
Суть: Ограничение среды выполнения команд Bash на уровне операционной системы (файлы, сеть). Позволяет Claude выполнять скрипты автономно в выделенной зоне без запросов подтверждения.
Аналогия: заезды на закрытом треке с бетонным ограждением. Пилот может разгоняться до любой скорости, так как забор надежно удерживает машину в пределах зоны. Песочница гарантирует безопасность на системном уровне. (Подробнее в Статье 21)
Prompt injection (Инъекция подсказок/промптов)
Суть: Вредоносные текстовые инструкции, внедренные в код, документацию или ответы сторонних API, пытающиеся перехватить управление поведением Claude для выполнения несанкционированных действий.
Аналогия: телефонное мошенничество по готовому сценарию. Злоумышленник обычным голосом просит вас совершить перевод денег. Если Claude прочитает такую инструкцию в файле проекта, он может выполнить ее на вашей машине. Риск повышается при анализе внешних репозиториев. (Подробнее в Статье 21)
Checkpoint (Контрольная точка/Точка восстановления)
Суть: Автоматический снимок состояния файлов проекта перед изменением кодовой базы и отправкой промпта. Позволяет откатить файлы или ветку диалога через меню /rewind или двойное нажатие Esc. Работает локально в рамках сессии и не зависит от git.
Аналогия: сохранение в компьютерных играх. При неудачном шаге вы загружаете сохранение и переигрываете эпизод. Обратите внимание: изменения, внесенные внешними shell-скриптами вне инструментов изменения файлов, контрольной точкой не отслеживаются. (Подробнее в Статье 37)
💡 Краткий вывод: Это семейство отвечает за контроль действий агента — режимы разрешений (permission modes) задают общую планку автономии, правила (rules) настраивают точечный доступ, песочницы изолируют процессы, классификатор (auto mode) отслеживает безопасность команд, контрольные точки (checkpoints) выполняют бэкап, а инъекции подсказок (prompt injections) представляют собой внешнюю угрозу перехвата управления.
06 Семейство интерфейсов и режимов запуска: Форматы взаимодействия с клиентом
Это семейство описывает форматы работы с Claude Code. Консоль, среда разработки VS Code, веб-браузер или интеграция в скрипты автоматизации сборки — при различных интерфейсах ядром везде выступает одно решение.
Аналогия: форматы работы сотрудника. Он может присутствовать в офисе лично (консоль или IDE), работать удаленно из дома (веб-версия) или получать тикеты в трекере и отправлять отчеты (запуск скриптом). Его навыки неизменны, меняется лишь способ постановки задач.
Surface (Интерфейс взаимодействия/Поверхность)
Суть: Любая среда взаимодействия с Claude Code: терминал CLI, плагины для VS Code или JetBrains, настольное приложение или веб-интерфейс. Конфигурация, правила CLAUDE.md и Skills одинаково работают везде.
Аналогия: одна медиасистема в разных моделях автомобилей. Интерфейсы могут немного отличаться визуально, но логика управления и ваши настройки остаются идентичными. Переключение между средами разработки происходит бесшовно. (Подробнее в Статье 08)
Non-interactive mode (Неинтерактивный режим / Ранее headless)
Суть: Запуск клиента с флагом -p (или --print). Выполняет одну переданную команду и завершает процесс, не открывая интерактивный чат. Удобен для CI/CD и скриптов автоматизации. Ранее именовался headless-режимом.
Аналогия: отправка задачи по почте. Вы отсылаете исполнителю техническое задание и получаете обратно готовый результат без ведения диалога. В коде аналогичный функционал реализуется через Agent SDK. (Подробнее в Статье 45)
Agent SDK (Набор инструментов разработчика для агентов)
Суть: Библиотека разработки (Python / TypeScript), позволяющая интегрировать возможности автономного агента Claude Code напрямую в ваши приложения и вызывать его функции из кода.
Аналогия: интеграция кофемашины в торговый автомат. Вы не пользуетесь готовым бытовым прибором, а разбираете его и встраиваете блок приготовления кофе внутрь собственной системы. Разница между CLI и SDK аналогична разнице между консольной утилитой и API-библиотекой. (Подробнее в Статье 45)
Claude Code on the web (Веб-версия)
Суть: Версия клиента для запуска в веб-браузере. Все файловые операции и запуск команд выполняются в изолированной облачной песочнице (в отличие от Remote Control, где вычисления идут на вашем ПК).
Аналогия: аренда виртуальной машины в облаке с оплатой за время. Код компилируется на удаленном сервере и не затрагивает ресурсы вашего локального компьютера. (Подробнее в Статье 11)
Bare mode (Чистый/Базовый режим)
Суть: Запуск с флагом --bare, отключающий автоматический поиск и загрузку хуков, Skills, плагинов, серверов MCP, auto memory и CLAUDE.md. Используются только явно переданные параметры. Полезно для обеспечения идентичности поведения в средах CI.
Аналогия: поездка в командировку только с ручной кладью. Вы оставляете дома все привычные бытовые вещи и берете с собой только минимум для выполнения конкретной задачи. На любом сервере такой запуск отработает одинаково. (Подробнее в Статье 34)
Worktree isolation (Изоляция через рабочие каталоги)
Суть: Способ запуска параллельных задач с флагом -w или параметром isolation: worktree в настройках субагентов. Claude разворачивает отдельный git worktree в папке .claude/worktrees/ и работает в отдельной ветке, исключая конфликты с параллельными процессами.
Аналогия: выделение отдельных строительных площадок для разных бригад. Несколько групп работают с одним проектом в разных местах, поэтому никто не мешает друг другу и не ломает чужую работу. Неизменимо при параллельном запуске сессий. (Подробнее в Статье 41)
Remote Control (Удаленное управление) / Teleport (Телепортация)
Суть: Remote Control позволяет подключиться к активной локальной сессии с мобильного телефона или браузера (код остается на вашем ПК, передается только интерфейс). /teleport выполняет обратную задачу — переносит сессию из облака в ваш локальный терминал.
Аналогия: удаленный рабочий стол для офисного ПК. Remote Control похож на подключение к компьютеру дома со смартфона, а teleport позволяет «перетащить» облачный процесс на экран вашего терминала. (Подробнее в Статье 11)
💡 Краткий вывод: Это семейство описывает форматы запуска — интерфейсы (surfaces) объединяют доступ к ядру, неинтерактивный режим (headless) автоматизирует запуск команд, SDK встраивает агентов в ваш код, веб-версия запускается в облаке, bare mode очищает настройки окружения, worktree изолирует параллельные потоки, а Remote Control / teleport связывают локальный ПК с облаком.
07 Часто путаемые понятия: Сравнение и разграничение
При обилии терминов легко запутаться в похожих понятиях. Мы собрали пары терминов, вызывающие больше всего вопросов у новичков, и привели их краткое сравнение.
| Сравниваемая пара | Ключевое отличие | Различие в одной фразе |
|---|---|---|
| Skill vs Subagent | Куда загружается контекст | Skill загружается напрямую в ваше основное окно; Subagent использует собственную независимую область и возвращает только резюме (Статья 30) |
| CLAUDE.md vs Skill | Время загрузки | CLAUDE.md считывается автоматически при каждом старте сессии; Skill подгружается в контекст только при обращении (Статья 30) |
| Hook vs Правило разрешений | Способ контроля | Хук (hook) выполняет скрипт при наступлении события; правило доступа разрешает или блокирует вызов конкретного инструмента (Статья 30) |
| Subagent vs Agent team | Доступность для прямого диалога | Subagent работает изолированно внутри сессии и отчитывается перед ней; в Agent team разворачивается несколько полноценных сессий, с каждой из которых вы можете общаться напрямую (Статья 29) |
| Session vs Turn | Масштаб | Сессия (session) объединяет всю историю переписки в рамках одного окна контекста; ход (turn) — это один шаг диалога «запрос пользователя → ответ модели» (Статья 03) |
Compaction vs /clear | Сохранение истории | Сжатие (compaction) обобщает старые сообщения в краткую выжимку; /clear полностью удаляет историю и начинает диалог заново (Статья 19) |
| Permission mode vs Правило разрешений | Детализация | Режим доступа (permission mode) задает общий уровень автономности в сессии; правила определяют права вызова конкретных команд и папок (Статья 20) |
| stdio vs http (transport) | Место запуска сервера | stdio запускает исполняемый файл локально на компьютере; http подключается к удаленному веб-серверу по сети (Статья 22) |
| CLAUDE.md vs auto memory | Автор правил | CLAUDE.md создается и редактируется пользователем; auto memory ведется автоматически самой моделью (Статья 25) |
Разграничение этих пар критично на начальных этапах. Например, различие между Skills и субагентами: новички часто оформляют поиск неиспользуемого кода во всех папках проекта в виде Skill. В результате чтение десятков файлов мгновенно переполняет контекст основного диалога. Правильный подход — поручить эту фоновую аналитическую задачу субагенту, сохранив основную сессию чистой.
💡 Краткий вывод: Для разделения похожих понятий найдите ключевое отличие: Skill/Subagent — куда пишется контекст; CLAUDE.md/Skill — время считывания; Mode/Правило — степень гранулярности; stdio/http — расположение сервера.
08 Практика: Настройка интерактивного поиска определений в Claude
Данный глоссарий статичен, но документация постоянно обновляется. Самый надежный способ узнать точное значение термина — попросить саму модель обратиться к официальному серверу документации. Подключив его один раз через протокол MCP, вы сможете получать актуальные данные в любой момент.
Этот сервер работает по протоколу HTTP и требует подключения к интернету; при сбоях доступа настройте прокси-сервер.
Шаг 1: Подключите сервер документации в терминале (не внутри сессии Claude)
claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcpОжидаемый результат: вывод подтверждения вида Added HTTP MCP server claude-code-docs ..., что означает запись параметров в файл настроек.
Шаг 2: Проверьте статус подключения
claude mcp listОжидаемый результат: наличие в списке сервера claude-code-docs с отметкой ✓ Connected. Зеленый маркер подтверждает установку соединения; статус ✗ Failed to connect говорит о сетевых сбоях.
Шаг 3: Начните сессию и запросите определение термина
claudeПосле запуска введите запрос (мы явно указываем сервер, чтобы модель использовала данные MCP вместо своей памяти):
用 claude-code-docs server 查一下官方术语表里 compaction 和 context window 的定义，各用一句话告诉我Ожидаемый результат: при первом обращении к серверу Claude попросит подтвердить действие (это механизм контроля правил из Раздела 05 — запуск хуков и инструментов требует одобрения). Одобрите операцию. Модель вернет определения терминов с пометкой claude-code-docs рядом с вызовом инструмента. Этот значок подтверждает, что данные получены из официального источника, а не сгенерированы по памяти.
Шаг 4: Удаление сервера (Опционально)
claude mcp remove claude-code-docsОжидаемый результат: вывод подтверждения удаления; сервер пропадет из вывода claude mcp list.
Этот алгоритм дает инструмент для проверки актуальности терминов в реальном времени. Если вы сомневаетесь в актуальности данного глоссария, просто попросить Claude свериться с сервером документации. Это исключает догадки и гарантирует точность определений.
💡 Краткий вывод: Этот глоссарий является справочником, а сервер документации выступает живой энциклопедией. Подключите его (
add→listс зеленым маркером → запрос в сессии → одобрение) для получения самых точных и свежих определений.
09 Резюме
Этот глоссарий не нужно заучивать, используйте его в качестве карманного справочника для проверки терминов, разбитых по шести семействам.
Краткий обзор шести семейств:
| Семейство | Описание | Основные понятия |
|---|---|---|
| Агентный цикл | Логика автономной работы Claude | agentic loop, tool, harness, turn, extended thinking, effort level, verification loop |
| Контекст | Объем оперативной памяти и тон ответов | context window, token, compaction, session, CLAUDE.md, auto memory, rules, output style |
| Расширения | Инструменты дооснащения агента | skill, subagent, hook, command, plugin, marketplace |
| Протокол MCP | Универсальный хаб подключения внешних служб | MCP, server, transport, scope, tool search |
| Безопасность | Уровни контроля и модерации действий | permission mode, plan mode, auto mode, правила доступа, sandbox, prompt injection, checkpoint |
| Интерфейсы | Среды запуска и взаимодействия с клиентом | surface, non-interactive (headless), Agent SDK, веб-версия, bare mode, worktree isolation, Remote Control |
Теперь вы можете: уверенно ориентироваться в профессиональных терминах Claude Code. Вы понимаете их суть, знаете тематическое семейство и наглядные аналогии, а также можете легко разграничить похожие понятия (вроде Skills vs Subagents). Вы научились использовать сервер документации в качестве интерактивного словаря для проверки актуальности определений. Этот справочник поможет быстро восстановить в памяти любые концепции из предыдущих 50 глав курса.
На этом основная теоретическая и практическая части курса завершены — от базовых настроек и запуска до интеграции расширений и оптимизации. Вы освоили всю необходимую базу.
В следующей статье 53 «Создание видео (Remotion) [Дополнительно]» вас ждет бонусная глава. Мы выйдем за рамки классического программирования и посмотрим на необычные варианты использования: разработка видеороликов на основе кода с помощью фреймворка Remotion (React-библиотека для рендеринга видео). Этот материал не является обязательным для изучения, но он отлично демонстрирует масштабируемость подходов AI-разработки. Подумайте: если видео можно скомпилировать из кода, то написание этого кода для Claude — просто очередная задача в формате «опишите требования, получите результат».