Лучшие практики Claude Code | Кодим с Claude

Коротко

Кэл из команды Applied AI в Anthropic объясняет, как устроен Claude Code изнутри: это «чистый агент» - инструкции, мощные инструменты и цикл, который крутится, пока модель сама не решит, что закончила. Никакой индексации кодовой базы, никакого RAG: Claude ищет через glob, grep и find - точно как живой человек, впервые открывший чужой репозиторий. Практики сводятся к нескольким вещам: держать CLAUDE.md, настроить permissions под себя, ставить CLI-тулзы вместо MCP там, где есть выбор, управлять контекстом через clear и compact, и просить план до кода. Из нового на момент доклада: переключение модели через /model, мышление между вызовами инструментов начиная с Claude 4, интеграции с VS Code и JetBrains. На вопрос про оркестрацию нескольких агентов ответ честный: пока пишите состояние в общий markdown-файл, нативного механизма нет.

Главный тезис

Claude Code работает потому, что он предельно простой: один агент с хорошими инструментами, который исследует код как человек, а не через хитрую индексацию, и вся работа пользователя сводится к тому, чтобы вовремя кормить его контекстом и жать escape в нужный момент.

Ключевые идеи

• 3:05 - ментальная модель: Claude Code это коллега, который живёт в терминале и никогда не открывает GUI
• 3:54 - принцип Anthropic: the simple thing that works, отсюда и архитектура
• 4:06 - агент по определению Anthropic: инструкции + мощные инструменты + цикл, пока модель не решит, что готово
• 5:00 - никакого индексирования и эмбеддингов, вместо этого агентный поиск через Glob, Grep, Find
• 5:26 - агентный поиск итеративен: модель ищет, смотрит результаты, решает поискать ещё
• 5:52 - система разрешений нужна, чтобы человек вмешивался ровно там, где агент делает опасное
• 6:12 - Claude Code это тонкий слой над моделью, поэтому легко переключается на AWS и GCP ради безопасности
• 7:26 - недооценённый сценарий: партнёр по размышлению, а не исполнитель («не пиши файлы, дай два-три варианта»)
• 8:29 - у самой команды Claude Code аномально высокое покрытие тестами, потому что писать их стало дёшево
• 9:39 - неожиданный спрос от клиентов: отложенные миграции со старой Java, с PHP на React или Angular
• 11:10 - CLAUDE.md заменяет память: файл просто вбрасывается в промпт как инструкции разработчика
• 13:48 - при выборе между известным CLI-инструментом и MCP-сервером брать CLI
• 14:18 - контекст в 200 000 токенов упирается в потолок, дальше только /clear или /compact
• 17:38 - escape главный навык: знать, когда прервать, а когда дать доработать; двойной escape возвращает назад по диалогу
• 19:44 - начиная с Claude 4 модель думает между вызовами инструментов, а это ровно тот момент, где мышление важнее всего

Почему это важно

Anthropic здесь показывает не столько продукт, сколько ставку: агенты выигрывают за счёт качества модели, а не за счёт обвязки вокруг неё. Пока конкуренты строят индексацию, эмбеддинги и RAG-пайплайны над репозиторием, Claude Code сознательно этого не делает - и работает. Выигрывают команды с легаси, которые годами откладывали миграцию: месяц рефакторинга внезапно стал продаваемым внутри компании аргументом. Выигрывают и те, кто уже живёт в терминале, потому что gh, git, docker, BigQuery достаются агенту бесплатно. Проигрывает прослойка инструментов, чья ценность была в умном извлечении контекста: если модель сама находит нужное через grep, слой посредников схлопывается. Отдельный сигнал для AWS и GCP: модель доступна через них нативно, и корпоративный клиент, боящийся отправлять код в чужое API, остаётся в периметре.

Идеи

• Кэл попал в команду через внутренний лидерборд использования: за выходные вышел на первое место среди всех сотрудников Anthropic
• Он при этом боялся, что его отчитают за расход токенов на личный проект, а не на код Anthropic
• Тест на настоящую полезность инструмента: он таскал ноутбук с собой все выходные
• Демо zero-to-one («сделай мне игру») отлично выглядит на сцене, но команда фокусируется на существующих кодовых базах
• Онбординг в новый репозиторий - это период, когда ты не производителен просто потому, что не знаешь, где что лежит
• Запрос «посмотри на файл и git history, расскажи историю изменений за пару недель» работает благодаря терминалу, а не спецфункции
• Хорошие commit- и PR-сообщения появились у команды сами собой: просто просят Claude их написать
• Sticky rebase перестал быть проблемой: описываешь ситуацию и просишь разрулить
• Auto accept mode включается через shift+tab
• Отдельные bash-команды вроде npm run test можно один раз разрешить навсегда в настройках
• CLAUDE.md кладут в проект и коммитят, чтобы им пользовалась вся команда, либо в домашнюю директорию для универсальных вещей
• /clear вычищает всё, кроме CLAUDE.md
• /compact работает как вставленное сообщение пользователя: «суммируй, я передаю дело другому разработчику»
• Подкаталожные CLAUDE.md специально перестали читаться автоматически: в монорепозитории Anthropic люди открывали корень и взрывали себе контекст
• Вместо этого Claude поощряют читать дочерние CLAUDE.md, когда он на них наткнулся и они релевантны
• Через @-ссылку в CLAUDE.md можно подтянуть другие файлы
• To-do список, который Claude строит для большой задачи, это окно наблюдения: странный пункт - повод жать escape
• Screenshot вставляется прямо в диалог, либо даёшь путь к mock.png и просишь собрать по нему сайт
• Люди запускают по четыре Claude одновременно через tmux или вкладки; сам Кэл тянет только два
• Проблема «модель оставляет очевидные inline-комментарии» была проблемой модели, а не промпта: в 3.7 в промпте было много запретов, и они не помогали
• В Claude 4 это в основном починили, заодно улучшив следование инструкциям вообще
• Ранние тестеры сообщили, что их CLAUDE.md вдруг стал соблюдаться заметно точнее
• Переезд на новую модель - хороший повод перечитать свой CLAUDE.md и выкинуть половину костылей
• Обмен состоянием между агентами делают через файл: один Claude пишет Ticket.md, другой читает его как записку от коллеги
• Триггер extended thinking видно по светло-серому тексту в выводе
• MCP - это то, к чему обращаются, когда bash и штатных инструментов уже не хватает
• Changelog лежит в публичном GitHub-проекте Anthropic; Кэл проверяет его раз в неделю, потому что сам не успевает за релизами
• Headless-режим через SDK - направление, которым команда воодушевлена, но которое сама ещё до конца не осмыслила
• У Кэла кладбище незаконченных проектов, и note-taking app из того выходного он довёл дальше, чем довёл бы сам

Инсайты

• Отказ от индексации - это ставка на то, что качество модели растёт быстрее, чем окупается сложность обвязки; вся инженерная сложность делегирована наверх
• Инструмент, который повторяет способ работы человека (искать, читать, думать), масштабируется вместе с моделью, а специализированный пайплайн застывает в момент проектирования
• Когда стоимость рутины падает до нуля, метрики качества растут сами: покрытие тестами и качество коммитов улучшились не от дисциплины, а от дешевизны
• Отсутствие памяти у агента переносит ответственность за состояние на человека, и CLAUDE.md превращается в новый артефакт инженерной культуры команды
• Права доступа - это не безопасность, а темп: настройка разрешений напрямую определяет, сколько раз в час тебя выдёргивают
• Ограничение контекста делает управление им отдельным навыком: выбор между «стереть» и «сжать» это выбор архитектуры сессии
• Наблюдение за агентом в реальном времени ценнее проверки результата: план и to-do дают точки вмешательства до того, как ошибка стала кодом
• Правильная единица работы с агентом - план, а не задача: верификация намерения дешевле верификации диффа
• Часть багов поведения живёт в модели, а не в промпте, и никакая инструкция пользователя их не перебьёт - апгрейд модели чинит то, что не чинится текстом
• Улучшение следования инструкциям обесценивает накопленные обходные приёмы: промпт-костыли надо периодически чистить, иначе они начинают мешать
• Мышление между вызовами инструментов важнее мышления в начале: решение «что искать дальше» принимается по промежуточным результатам
• Файловая система как шина сообщений между агентами - самый простой рабочий протокол, пока продукт не предложил нативный
• Барьер входа в продвинутые инструменты снижается не обучением, а делегированием: Кэл так и не научился приёмам своего ментора, но получил их результат
• Скорость релизов создаёт новую обязанность пользователя: следить за changelog, иначе половина возможностей проходит мимо

Фреймворки

Что такое агент в понимании Anthropic: инструкции + мощные инструменты + цикл выполнения, пока модель сама не решит, что задача закончена.

Сценарии использования Claude Code: discovery (онбординг в незнакомый код), thought partner (проработка вариантов до кода), build (zero-to-one и работа в существующей базе), deployment через SDK и headless-режим, support and scale (отладка, миграции).

Пять практик: файлы CLAUDE.md, управление разрешениями, настройка интеграций (CLI поверх MCP), управление контекстом (clear против compact), эффективные workflow (план, to-do, TDD, скриншоты).

Уровни разрешений по умолчанию: чтение и поиск проходят без вопросов, запись и bash-команды поднимают UI подтверждения с опциями «да», «всегда разрешать», «нет».

Цитаты

«Cloud Code is like that co-worker that does everything on the terminal» - 3:10 Claude Code это тот самый коллега, который всё делает в терминале

«having Cloud Code on your computer is kind of like having Tony next to you all the time» - 3:40 Claude Code на твоём компьютере это как будто Тони всё время сидит рядом

«At Anthropic, we try to always do what we call the simple thing that works» - 3:54 В Anthropic мы всегда стараемся делать то, что называем простой работающей вещью

«some instructions, some powerful tools, and you let the model just run in a loop until it decides it's done» - 4:06 Немного инструкций, мощные инструменты, и модель просто крутится в цикле, пока сама не решит, что закончила

«That is not how Claude code works. We don't do any sort of indexing» - 5:00 Claude Code работает не так. Мы не делаем никакой индексации

«I was super addicted to just watching cloud code work» - 1:46 Я подсел на то, чтобы просто смотреть, как Claude Code работает

«I hope I don't get in trouble or anyone notices. I'm not really contributing to anthropic code» - 2:10 Надеюсь, мне не влетит и никто не заметит. Я же не пишу код для Anthropic

«And over the weekend, I'd shot to the top» - 2:24 И за выходные я взлетел на первое место

«the reality is it's kind of great at everything» - 6:33 По правде говоря, он хорош почти во всём

«instead of just diving in and starting to work, you can use Cloud Code as a thought partner» - 7:23 Вместо того чтобы сразу нырять в работу, используй Claude Code как партнёра по размышлению

«Don't start working. Don't start writing any files yet» - 7:43 Не начинай работать. Пока не пиши никаких файлов

«we have in our code base abnormally high I would say unit test coverage» - 8:29 У нас в кодовой базе, я бы сказал, ненормально высокое покрытие юнит-тестами

«how do I get myself out of this sticky rebase, I'll just fire up Cloud Code and tell it the situation» - 10:23 Как мне выбраться из этого залипшего rebase - просто запускаю Claude Code и описываю ситуацию

«it has some lightweight instructions in the prompt, but it doesn't really have memory» - 10:48 У него есть лёгкие инструкции в промпте, но памяти по сути нет

«I would recommend using the CLI tool» - 13:48 Я бы рекомендовал брать CLI-инструмент

«our models have a context window of 200,000 tokens and you can max this thing out» - 14:18 У наших моделей окно контекста 200 000 токенов, и его вполне можно забить под завязку

«So escape is your best friend» - 17:38 Escape твой лучший друг

«Knowing when the right time to press escape is versus just letting Claude figure it out is key» - 17:51 Понимать, когда жать escape, а когда дать Claude разобраться самому, и есть ключ

«I can only do two, but I know people that do four» - 17:33 Я тяну только два, но знаю людей, которые гоняют четыре

«people would open it at the top and blow up their context with all the Cloud MDs» - 22:03 Люди открывали монорепозиторий сверху и разносили себе контекст всеми CLAUDE.md разом

«despite that, the model just loves to leave comments» - 23:27 И несмотря на всё это, модель обожает оставлять комментарии

«my Cloud.MD is being followed way more closely» - 23:54 Мой CLAUDE.md вдруг стал соблюдаться заметно точнее

«we wouldn't let our model think between tool calls, and that's probably when the thinking matters most» - 19:40 Мы не давали модели думать между вызовами инструментов, а это, вероятно, момент, где мышление важнее всего

«hey, read Ticket.md. Another developer left this note for you» - 25:10 Слушай, прочитай Ticket.md. Другой разработчик оставил тебе записку

«I check this once a week and make sure that I'm on top of all the new stuff we're shipping because even I can't keep up with it» - 21:10 Я проверяю его раз в неделю, чтобы не отстать от того, что мы выкатываем, потому что даже я за этим не успеваю

Факты

• Спикера зовут Кэл, он пришёл в Anthropic примерно за полтора года до доклада, чтобы помочь запустить команду Applied AI
• Миссия Applied AI: помогать клиентам и партнёрам строить продукты и фичи поверх Claude
• Сейчас Кэл один из core-контрибьюторов Claude Code: системные промпты, описания инструментов, результаты вызовов, а также оценка качества инструмента
• Он скачал прототип будущего Claude Code в пятницу вечером в конце 2024 года и делал на нём приложение для заметок
• Команда Claude Code вела внутренний лидерборд использования среди сотрудников Anthropic; за те выходные Кэл вышел на первое место
• Через лидерборд он познакомился с Борисом и Кэт из ранней команды Claude Code
• Инструменты поиска, которыми пользуется агент: Glob, Grep, Find; индексации и эмбеддингов нет
• Контекстное окно моделей Anthropic на момент доклада: 200 000 токенов
• Claude Code доступен через API Anthropic, а также через AWS и GCP
• У GitHub есть CLI-инструмент gh, который спикер приводит как образцовый пример интеграции
• Внутри Anthropic есть собственный инструмент под названием, звучащим как Koo (в транскрипте «Koo»)
• Anthropic использует монорепозиторий, из-за чего автоматическое чтение вложенных CLAUDE.md было отключено
• Начиная с Claude 4 модели думают между вызовами инструментов; в прошлых моделях это было запрещено
• Проблема с лишними inline-комментариями в основном исправлена в Claude 4; в 3.7 её не удавалось победить промптом
• Новое на день доклада: команда /model и переключение через /config, интеграции с VS Code и JetBrains
• Публичный GitHub-проект Claude Code под организацией Anthropic принимает issues и содержит changelog
• Клиенты приходили с отложенными миграциями: старые версии Java на новые, PHP на React или Angular; таких команд было несколько
• Claude Code уже работает в GitHub Actions; заявлен SDK для headless и программного использования

Источники

• Claude Code - публичный GitHub-проект Anthropic (issues и changelog)
• Claude Code SDK - headless и программное использование
• GitHub CLI (gh) - пример CLI-интеграции
• MCP - протокол подключения дополнительных инструментов
• Tmux - для параллельного запуска нескольких Claude
• VS Code, JetBrains - новые IDE-интеграции
• Git, Docker, BigQuery - CLI-инструменты, с которыми агент работает нативно
• Борис, Кэт - участники ранней команды Claude Code
• Доклад про smart vibe coding на 30 минут в тот же день конференции Code w/ Claude

Рекомендации

• Заводите CLAUDE.md в проекте и коммитьте его, чтобы вся команда работала с одним контекстом
• При выборе между известным CLI-инструментом и MCP-сервером берите CLI
• Просите план и варианты до того, как агент начнёт писать файлы
• Добавляйте think hard при отладке и сложных задачах
• Попробуйте запустить несколько Claude одновременно и оркестрировать их
• Настройте permissions и auto accept под свои привычные команды
• Работайте через TDD: маленькие изменения, прогон тестов, проверка типов и линтера, частые коммиты
• Проверяйте changelog Claude Code раз в неделю
• Перечитайте свой CLAUDE.md после перехода на новую модель и выкиньте лишнее
• Обменивайтесь состоянием между агентами через общий markdown-файл

Итог

Claude Code выигрывает не хитростью обвязки, а её отсутствием: один агент, человеческие инструменты поиска, честный цикл до готовности, а всё мастерство пользователя сводится к тому, чтобы дать правильный контекст и знать, когда нажать escape.