INTERMEDIATE · 14 уроков · ~6 часов
Claude Code Guide
Курс из 14 уроков про устройство Claude Code изнутри: harness, context window, prompt cache, skills, hooks, MCP, subagents, модели, антипаттерны. Со сквозным примером Travel Agent.
- 01 01. Что такое Claude Code: harness, agent loop и ваше место в нём Claude Code — это harness вокруг LLM, а не сама модель. Модель решает, какой tool вызвать; harness исполняет, возвращает результат и ведёт agent loop до финального ответа.
- 02 02. Контекстное окно и prompt cache Контекстное окно — это и деньги, и качество. Стандарт Opus/Sonnet 4.6 — 200k токенов; 1M доступен через alias opus[1m]/sonnet[1m]. Prompt cache режет счёт в 10 раз, но живёт всего 5 минут по умолчанию.
- 03 03. CLAUDE.md: уровни, импорты, авто-память CLAUDE.md — это «paste this every time» в красивой обёртке: автоматический префикс для каждой сессии. У него пять уровней (managed, user, project, local, subdirectory), они конкатенируются, а не перезаписывают друг друга.
- 04 04. Skills: SKILL.md, scripts, references Skill — это директория с SKILL.md и опциональными scripts/references/templates, а не один markdown-файл. Краткое описание скилла попадает в каждый запрос; полный SKILL.md «раскрывается» только когда задача подходит.
- 05 05. Hooks: детерминированный контроль над agent loop Hooks — это git hooks для Claude Code: точки в lifecycle, в которых harness гарантированно исполнит ваш скрипт. В Claude Code v2.1.89 их 28+ событий, exit code 2 блокирует действие модели, JSON-ответ {"action":"block"} делает то же.
- 06 06. MCP-серверы MCP (Model Context Protocol) — «USB-C для AI-интеграций»: пишете сервер один раз, его потребляют Claude Code, Claude Desktop, Cursor, Continue, custom SDK. Три транспорта (stdio, SSE, HTTP); экспортируются tools, resources, prompts, elicitation.
- 07 07. Plugins: упаковка skills + hooks + agents + MCP Plugin — npm-пакет для Claude Code: упаковка skills, hooks, subagents, slash-команд и MCP-конфига в одну версионируемую сущность. Манифест .claude-plugin/plugin.json, установка через /plugin install, маркетплейсы.
- 08 08. Tool calls и agent loop под капотом Tool call — фундаментальный механизм, превращающий LLM из чат-бота в агента. Модель возвращает не текст, а tool_use block; harness исполняет вызов и возвращает tool_result. Поняв этот цикл, вы понимаете 80% работы любого AI-агента.
- 09 09. Subagents: изолированные агентные циклы Subagent — мини-сессия Claude Code со своим контекстом и system prompt. В основной контекст возвращается только финальный summary. Это спасение от переполнения окна на browse-heavy задачах и причина неожиданных счетов, если запускать их без меры.
- 10 10. Agent Teams (экспериментально) Если subagents — это «отправил помощника в командировку, дождался результата», то Agent Teams — это «собрал команду из нескольких разработчиков, дал им task list и они работают параллельно,
- 11 11. Модели и pricing Выбор модели — компромисс скорость/стоимость/качество, а не «всегда Opus». Cache read стоит 0.1× input (10× дешевле), output ~5× input. Opus 4.7 имеет новый токенизатор (+35% токенов на тех же текстах), на Bedrock/Vertex дефолтные алиасы сдвинуты на версию назад.
- 12 12. Travel Agent с нуля: blueprint Сводим всё вместе. Один реальный проект. Один монорепо. Конкретные файлы, конфиги, структура. Дальше уже копипастите и адаптируете.
- 13 13. Best practices: ежедневная рутина и антипаттерны Все предыдущие главы — про механику. Эта — про дисциплину. Без неё даже идеальная конфигурация со временем превращается в свалку: кэш мимо, скиллы протухли, hooks падают молча, а вы не поним
- 14 14. Проверка утверждений из исходного треда Эта глава — построчный разбор тех ~20 пунктов, с которых началась подготовка гайда. Каждое утверждение проверено по официальной документации (`docs.claude.com`, `code.claude.com/docs`), chan