2026-01-02 Борис Черный, создатель Claude Code, опубликовал в X тред из тринадцати пунктов о том, как сам пользуется инструментом; тред открывается замечанием, что настройка на удивление обычная. Когда мы читали его 2026-11-08, первый пост показывал около 8,2 млн просмотров, пункт 13 — около 575 тысяч. Десять месяцев для Claude Code — большой срок: сменились модель по умолчанию, режим разрешений по умолчанию, способ организации slash-команд и способ передачи сессий между терминалом и облаком. Поэтому статья не пересказывает тред, а кладёт каждый пункт рядом с документацией на тот день.
Борис Черный: начало треда (2026-01-02) · Борис Черный: пункт 13, петля верификации
Мерило взято со страницы best practices: любая инструкция либо недетерминированная (написана для модели, и модель решает, следовать ли ей: промпт, CLAUDE.md, skill), либо детерминированная (исполняется Claude Code как harness независимо от решения модели: hook, deny-правило, управляемая настройка). Часть привычек из треда относится к первому типу, часть ко второму, и надёжность у них несопоставима. Самое сильное утверждение треда — пункт 13: дайте Claude способ проверить свою работу, и итоговое качество вырастет в два-три раза. Структура статьи повторяет эту петлю.
Борис Черный: пункт 13, петля верификации · Документация Claude Code: Best practices
Сначала границы. Мы не запускали Claude Code, не включали эти hooks ни в одном реальном репозитории и проверяли JSON, Markdown и shell-блоки только офлайн. Там, где тред называет модель, команду или плагин, которых актуальная документация уже не содержит, текст прямо говорит об этом («как описано в треде») и указывает на текущую страницу. Просмотры и номера версий — показания на 2026-11-08, позже они могут не совпадать.
1. Что говорится в треде и что мы проверяли
Тринадцать пунктов распадаются на четыре группы. Оркестровка сессий: пять локальных экземпляров Claude в пронумерованных вкладках терминала с системными уведомлениями, когда одному нужен ввод (пункт 1); ещё пять-десять сессий на claude.ai/code, локальные сессии передаются в веб через амперсанд и иногда возвращаются через --teleport (пункт 2); Opus 4.5 с thinking для всего — крупнее и медленнее Sonnet, но требует меньше правок по ходу (пункт 3). Накопление знаний: один CLAUDE.md для репозитория Claude Code в git, который вся команда правит несколько раз в неделю, добавляя запись всякий раз, когда Claude ошибается (пункт 4); упоминание Claude в PR коллег, чтобы GitHub Action дописывал урок в CLAUDE.md прямо в рамках PR — автор треда называет это compounding engineering вслед за Дэном Шиппером (пункт 5).
Процесс и разрешения: большинство сессий начинаются в plan mode, план итерируется, затем переключение на автоприём правок (пункт 6); slash-команда на каждый частый «внутренний цикл», файлы в .claude/commands/ в git (пункт 7); несколько субагентов — code-simplifier подчищает код после Claude, verify-app хранит инструкции сквозного тестирования (пункт 8); PostToolUse hook форматирует код и ловит те примерно десять процентов, которые модель пропускает, чтобы CI оставался зелёным (пункт 9); никакого --dangerously-skip-permissions, вместо этого /permissions для предварительного разрешения безопасных команд в общем .claude/settings.json (пункт 10); Slack через MCP из общего .mcp.json, BigQuery через bq CLI, логи из Sentry (пункт 11).
И верификация: для долгих задач — попросить Claude проверить результат фоновым агентом по завершении, использовать Stop hook, чтобы сделать это детерминированнее, или плагин ralph-wiggum (пункт 12); и заключительный совет, что верификация — вероятно, самое важное: Claude тестирует каждое изменение claude.ai/code через расширение Chrome, открывая браузер, прогоняя UI и итерируя, а подходящая проверка зависит от области — bash-команда, набор тестов, браузер или симулятор телефона (пункт 13). Наш объект сравнения — документация code.claude.com на 2026-11-08; «актуальная документация» ниже всегда означает эту дату.
Борис Черный: пункт 13, петля верификации · Документация Claude Code: Best practices
2. 13 пунктов: актуальная документация, тип механизма и файл
Эта таблица — оглавление остальной статьи. Колонка «механизм» следует определению из best practices: «решает модель» означает, что Claude читает инструкцию и выбирает; «принуждает harness» — что Claude Code применяет её в любом случае. Одна и та же цель часто существует в обеих формах. Прохождение typecheck перед завершением может быть строкой в CLAUDE.md (решает модель) или Stop hook (принуждает harness), и документация советует: строка CLAUDE.md, которую вы всё время усиливаете, должна стать hook.
| Пункт | Тред (2026-01) | Документация (2026-11-08) | Механизм | Файл или команда |
|---|---|---|---|---|
| 1 | 5 локальных сессий параллельно, нумерованные вкладки, уведомления | Terminal config: Ghostty, Kitty и iTerm2 умеют показывать уведомления; для параллельной работы — отдельный worktree на сессию (claude -w) | Инструменты, не поведение модели | claude -w <name>; настройки уведомлений терминала |
| 2 | 5–10 облачных сессий; передача амперсандом; --teleport обратно | Страница облачных сессий: --cloud создаёт новую облачную задачу; --teleport забирает облачную сессию в терминал; CLI не может отправить существующую локальную сессию в облако (передача амперсандом — только тред) | Инструменты | claude --cloud ...; claude --teleport |
| 3 | Opus 4.5 с thinking для всего | Model config: по умолчанию на большинстве планов Opus 5.5 при medium effort; регулируется /effort, а не формулировками промпта | Решает модель (effort задаёт глубину размышления) | /model; /effort high |
| 4 | Один общий CLAUDE.md в git, запись на каждую ошибку | Memory: держать CLAUDE.md до 200 строк; писать только то, чего нет в репозитории; /init, /doctor, /doctor prompt-audit | Решает модель | CLAUDE.md; .claude/rules/*.md |
| 5 | Упомянуть Claude в PR, чтобы GitHub Action дополнил CLAUDE.md | GitHub Actions: /install-github-app ставит приложение и workflow; упоминание @claude в комментарии PR или issue (в треде — /install-github-action) | Решает модель (Action выполняется детерминированно, текст пишет модель) | /install-github-app; .github/workflows/claude.yml |
| 6 | Старт в plan mode (Shift+Tab дважды), затем автоприём правок | Режимы разрешений: интерактивные сессии стартуют в auto; Shift+Tab идёт auto → default → acceptEdits → plan; или префикс /plan; при одобрении плана выбирается следующий режим | План решает модель; правки в plan mode блокирует harness | Shift+Tab; /plan; claude --permission-mode plan |
| 7 | Slash-команда на каждый внутренний цикл в .claude/commands/ | Skills: пользовательские команды объединены со skills; .claude/commands/*.md работает; новая форма .claude/skills/<name>/SKILL.md с опцией disable-model-invocation | Решает модель (кто может вызвать — настраивается) | .claude/skills/verify-app/SKILL.md |
| 8 | Субагенты code-simplifier и verify-app | Sub-agents: .claude/agents/<name>.md с name, description, tools, model и другими полями; список tools принуждает harness | Смешанный: делегирование решает модель, набор инструментов принуждается | .claude/agents/code-simplifier.md |
| 9 | PostToolUse hook форматирует код | Hooks и best practices: matcher Edit|Write, команда читает .tool_input.file_path; опционально onFailure block | Принуждает harness | .claude/settings.json hooks.PostToolUse |
| 10 | Без --dangerously-skip-permissions; /permissions и общий settings.json | Permissions: правила allow, ask и deny; deny действует в любом режиме; allow в общем файле ждёт диалога доверия у каждого | Принуждает harness | .claude/settings.json permissions |
| 11 | Slack MCP в .mcp.json; bq CLI; Sentry | Best practices: предпочитать CLI, когда он есть; иначе claude mcp add --transport http; выключать неиспользуемые серверы в /mcp | Инструменты | claude mcp add ...; .mcp.json |
| 12 | Долгие задачи: фоновый агент, Stop hook или плагин ralph-wiggum | Hooks: Stop hook выходит с кодом 2 и возвращает Claude к работе, лимит 8 блокировок подряд, CLAUDE_CODE_STOP_HOOK_BLOCK_CAP регулируется; /goal — встроенная альтернатива; плагин ralph-wiggum не найден по проверенному пути репозитория | Stop hook принуждается; /goal оценивает модель | hooks.Stop; /goal <условие> |
| 13 | Дать Claude способ проверки; качество ×2–3; расширение Chrome тестирует UI | Best practices: дать проверку, возвращающую pass или fail; требовать доказательства (команда и вывод или скриншот); Chrome: claude --chrome, нужен прямой план Pro, Max, Ultra, Team или Enterprise со входом через /login | Проверка детерминирована; доверяет ли ей Claude — решает модель; Stop hook может принудить | scripts/verify.sh; claude --chrome; /verify |
Документация Claude Code: Best practices · Документация Claude Code: справочник Hooks · Документация Claude Code: субагенты · Документация Claude Code: Memory и CLAUDE.md · Документация Claude Code: Skills (slash-commands ведёт сюда) · Документация Claude Code: интеграция Chrome · Документация Claude Code: режимы разрешений · Документация Claude Code: правила разрешений · Документация Claude Code: облачные сессии (--cloud и --teleport) · Документация Claude Code: GitHub Actions · Документация Claude Code: настройка терминала и уведомления · Документация Claude Code: /goal · Документация Claude Code: конфигурация модели
Три строки расходятся с тредом, и их стоит запомнить. Во-первых, команда теперь называется /install-github-app, а не /install-github-action. Во-вторых, передаче локальной сессии в веб амперсандом нет соответствия на странице облачных сессий: там сказано, что передача из CLI односторонняя — --teleport забирает облачную сессию в терминал, --cloud создаёт новую облачную задачу, и только настольное приложение может отправить локальную сессию в облако. В-третьих, каталог plugins в anthropics/claude-code на момент проверки содержал только README, поэтому расположение плагина ralph-wiggum не подтверждено; статья упоминает его как описанный в треде и не даёт шагов установки.
Документация Claude Code: облачные сессии (--cloud и --teleport) · Документация Claude Code: GitHub Actions
3. Петля верификации: план, реализация, проверка, доказательства, ревью
Соедините пункты 6, 9, 12 и 13 — получится одна петля. Plan mode фиксирует, что строить и что считать готовым. После одобрения Claude реализует в режиме acceptEdits или auto. Каждую правку форматирует PostToolUse hook. Когда Claude пытается завершить работу, Stop hook запускает typecheck или тесты и при провале возвращает вывод компилятора, чтобы Claude продолжил. Когда проверка проходит, Claude предъявляет доказательства: выполненные команды, их коды выхода и вывод или скриншот браузера. Наконец код смотрит тот, кто его не писал: свежий субагент из /code-review или другой инженер.
Какие шаги детерминированы? Hook форматирования и Stop hook исполняет harness; результаты тестов и typecheck дают компилятор и тест-раннер, а не память модели; запрет правок в plan mode тоже обеспечивает harness. Разумен ли план, достаточны ли доказательства и принимать ли замечания ревью — по-прежнему суждения модели или человека. Проектируя петлю, кладите на детерминированную сторону те немногие шаги, которые нельзя пропускать никогда, а остальное оставляйте модели.
Страница best practices прямолинейна насчёт доказательств: фраза «все тесты проходят» почти не несёт информации; читайте команду и её вывод, а для сессии, за которой вы не следили, это единственное доказательство. Скрипт verify.sh из раздела 8 существует ради этого шага: он записывает код выхода, длительность и путь к логу каждой проверки в Markdown-файл с меткой времени, так что Claude, Stop hook и ревьюер цитируют один документ.
- Plan mode: прочитать код, предложить, договориться об определении готовности (Shift+Tab или /plan)
- Одобрить план → переключиться на acceptEdits или auto; Claude реализует
- После каждого Edit/Write PostToolUse hook форматирует файл (принуждает harness)
- Claude запускает команду проверки из CLAUDE.md, читает вывод, правит до прохождения
- Claude пытается остановиться → Stop hook запускает tsc или verify.sh; код 2 возвращает к работе (принуждает harness, лимит 8 подряд)
- Проход → доказательства: команды, коды выхода, пути логов, скриншоты (scripts/verify.sh пишет .claude/evidence/)
- Независимое ревью: свежий субагент /code-review или другой инженер сверяет доказательства с планом
- Слияние одобряет человек; защита ветки — последний детерминированный барьер
Документация Claude Code: Best practices · Документация Claude Code: справочник Hooks · Документация Claude Code: режимы разрешений
4. CLAUDE.md: общий, растущий из ошибок, короткий
Пункт 4 сохранился на страницах memory и best practices с двумя ограничениями. Длина: memory рекомендует держать каждый CLAUDE.md в пределах 200 строк, потому что длинные файлы расходуют контекст и снижают следование; правила, важные лишь для части дерева, уходят в файлы .claude/rules/ с front matter paths:, чтобы загружаться только при работе с подходящими файлами. Содержание: пишите лишь то, чего Claude не прочтёт из репозитория — решение, принятое на встрече, процесс деплоя из чьей-то головы, переменную окружения для интеграционных тестов и всё, что вы исправляли дважды. Архитектура и структура каталогов туда не входят: Claude читает репозиторий сам.
Документация Claude Code: Best practices · Документация Claude Code: Memory и CLAUDE.md
Добавлять строку на каждую оплошность Claude по-прежнему работает, но документация ясно обозначает потолок: CLAUDE.md недетерминирован, и как бы сильно ни была сформулирована строка, следовать ей — выбор Claude. Если правило продолжает теряться после жирного шрифта и IMPORTANT, то либо файл достаточно длинный, чтобы её похоронить, либо правило не допускает исключений, и тогда ему место в hook или deny-правиле. Пример ниже следует этим правилам. Его последний блок, определение готовности, обслуживает требование доказательств из раздела 3; он повышает шанс, что Claude покажет доказательства, а само принуждение живёт в Stop hook.
# Commands
- Install: pnpm install
- Typecheck: pnpm tsc --noEmit
- Run one test file: pnpm vitest run path/to/file.test.ts
- Full verification with evidence file: bash scripts/verify.sh
# Conventions
- Use the error helpers in src/lib/errors.ts; never throw raw strings
- src/legacy/ is still live, but do not copy its patterns into new code
# Gotchas
- Integration tests need DATABASE_URL set, see .env.example
- src/gen/ is generated (2026-10-30: edited by hand once); run pnpm gen instead
# Definition of done
- Before saying a task is complete, show the command you ran and its output,
or the screenshot. "Tests pass" without output does not count.Поддерживают файл три команды. /init создаёт черновик по кодовой базе и предлагает улучшения вместо перезаписи существующего; /doctor предлагает вырезать всё, что Claude выведет из кода сам; /doctor prompt-audit помечает инструкции, написанные для старых моделей, указывающие на несуществующие файлы или противоречащие друг другу. В сессии /context all подтверждает, что файл загружен. Пункт 5 — дополнение CLAUDE.md во время ревью PR — опирается на GitHub Action: актуальная команда установки /install-github-app ставит GitHub App, сохраняет секрет аутентификации, пушит ветку с файлами workflow и открывает pull request; после слияния упоминание @claude в комментарии issue или PR запускает его. Результат этого шага — текст, написанный моделью, так что попадёт ли он в CLAUDE.md, по-прежнему решает ревьюер-человек.
Документация Claude Code: Best practices · Документация Claude Code: Memory и CLAUDE.md · Документация Claude Code: GitHub Actions
5. Plan mode, правила разрешений и два hook в одном settings.json
Пункт 6 говорит о двух нажатиях Shift+Tab для plan mode — это счёт от ручного режима по умолчанию в январе 2026. Страница режимов разрешений теперь сообщает, что с Claude Code v2.1.283 интерактивные сессии в терминале и VS Code стартуют в auto mode, где рискованные действия вместо вас проверяет модель-классификатор; из auto Shift+Tab ведёт в default (ручной), затем acceptEdits, затем plan. Быстрее — префикс /plan перед одним промптом или запуск claude --permission-mode plan. В plan mode Claude читает файлы, выполняет исследовательские команды и пишет план, но не может править исходники, и это гарантирует harness; одобряя план, вы выбираете следующий режим — это и есть переключение на автоприём правок из треда.
Пункт 10 целиком сохранился на странице permissions: allow-правила разрешают заранее, ask-правила принуждают к запросу, deny-правила действуют в любом режиме, включая auto и bypassPermissions. Важны две границы. Deny на Read(./.env) останавливает и cat .env, потому что Claude Code распознаёт типичные команды чтения файлов, но не скрипт, который откроет файл; а deny домена для WebFetch ничего не делает с curl, пока не включён sandbox. Best practices добавляет: классификатор auto mode — это суждение, а не жёсткое правило, поэтому ваши «никогда» должны жить в deny-правилах или hooks. Отказ треда от --dangerously-skip-permissions совпадает с актуальной документацией, которая оставляет bypassPermissions для одноразовых контейнеров.
Документация Claude Code: Best practices · Документация Claude Code: правила разрешений · Документация Claude Code: режимы разрешений
{
"permissions": {
"allow": [
"Bash(pnpm tsc --noEmit)",
"Bash(pnpm vitest run *)",
"Bash(bash scripts/verify.sh)",
"Bash(git status *)",
"Bash(git diff *)"
],
"ask": ["Bash(git push *)"],
"deny": ["Read(./.env)", "Read(./.env.local)", "Read(./secrets/**)"]
},
"hooks": {
"PostToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{
"type": "command",
"command": "npx prettier --write --ignore-unknown \"$(jq -r '.tool_input.file_path')\""
}
]
}
],
"Stop": [
{
"hooks": [
{ "type": "command", "command": "pnpm tsc --noEmit 1>&2 || exit 2" }
]
}
]
}
}Два hook — это пункты 9 и 12. Matcher PostToolUse — Edit|Write, команда достаёт .tool_input.file_path из JSON на stdin через jq и передаёт Prettier; документация отмечает, что файл, переписанный Bash-командой или внешним процессом, этот hook не запускает — для этого есть событие FileChanged. Контракт Stop hook: код выхода 2 блокирует остановку, а stderr возвращается Claude как причина, почему завершить нельзя, поэтому пример перенаправляет туда вывод компилятора. Страница hooks добавляет два предохранителя: после восьми Stop-блокировок подряд без вызова инструмента между ними Claude Code перекрывает следующую блокировку и завершает ход (CLAUDE_CODE_STOP_HOOK_BLOCK_CAP поднимает лимит), а поле stop_hook_active во входных данных равно true, когда ход уже является продолжением по hook, так что скрипты должны его читать, чтобы не зациклиться на невыполнимом условии.
Документация Claude Code: справочник Hooks · Документация Claude Code: Best practices
А если сломается сам hook? По умолчанию упавший или просроченный hook пропускает действие и оставляет уведомление об ошибке. Для hook безопасности можно задать onFailure: block, чтобы даже не запустившийся hook блокировал действие; но страница hooks предупреждает, что на событиях Stop блокировка возвращает Claude к работе, а Claude не может починить hook, который не запускается, поэтому пример не ставит его на Stop hook. Помните и напоминание best practices: набор принуждаемых правил должен оставаться небольшим, а при сорока правилах большинство, вероятно, предпочтения, которые модель взвесила бы сама.
Документация Claude Code: справочник Hooks · Документация Claude Code: Best practices
| Файл или место | К кому применяется | Что класть | Примечание |
|---|---|---|---|
| ~/.claude/settings.json | Вы, каждый проект на этой машине | Тема, модель по умолчанию, личные allow-правила, конфигурация autoMode | Блок autoMode работает только здесь; в настройках проекта классификатор его игнорирует |
| .claude/settings.local.json | Вы, только этот проект | Личные переопределения; сюда сохраняется «Да, и больше не спрашивать» | Claude Code добавляет его в исключения git при создании; созданный вручную — в .gitignore сами |
| .claude/settings.json | Все в этой папке | Командные allow/ask/deny, hooks, плагины, переменные окружения | Deny действует сразу; allow и hooks ждут диалога доверия у каждого |
| Управляемые настройки (managed-settings.json и другие) | Все, кому их разворачивает организация | Политика безопасности, комплаенс | Личный файл не переопределит; единственное место для политики службы безопасности |
| CLAUDE.md | Все в этой папке | Команды, соглашения, подводные камни, решения команды | Недетерминирован; до 200 строк |
| CLAUDE.local.md | Вы, только этот проект | Предпочтения, локальные URL, тестовые данные | В .gitignore; загружается вместе с CLAUDE.md |
| .claude/rules/*.md | Все, но только для подходящих путей | Правила для одного каталога или типа файлов | Front matter paths: управляет загрузкой |
| .claude/skills/, .claude/agents/ | Все | Многошаговые процедуры, определения субагентов | Skill может задать disable-model-invocation; список tools субагента принуждает harness |
Документация Claude Code: файлы настроек и приоритет · Документация Claude Code: Best practices · Документация Claude Code: Memory и CLAUDE.md · Документация Claude Code: субагенты · Документация Claude Code: Skills (slash-commands ведёт сюда)
6. Slash-команды стали skills; у субагентов появился front matter
Пункт 7 держит команды в .claude/commands/. На 2026-11-08 адрес документации slash-commands ведёт на страницу skills, которая начинается с того, что пользовательские команды объединены со skills: .claude/commands/deploy.md и .claude/skills/deploy/SKILL.md оба создают /deploy, старые файлы продолжают работать, а новая форма добавляет каталог для вспомогательных файлов, front matter и контроль над тем, кто вызывает. Для внутреннего цикла с побочными эффектами или долгим выполнением документация предлагает disable-model-invocation: true — тогда skill запускается только когда вы набираете /verify-app, и Claude не может запустить его сам. $ARGUMENTS заменяется на то, что вы набрали после команды.
Документация Claude Code: Skills (slash-commands ведёт сюда)
Приведённый ниже verify-app соответствует субагенту из пункта 8, хранившему инструкции сквозного тестирования, но мы оформили его как skill, а не субагент, потому что ему нужно управлять браузером в текущей сессии и вернуть доказательства. allowed-tools действует только на ход, который его вызвал, и заранее разрешает verify.sh и чтение файла доказательств. Содержание требует от Claude на каждом шаге записать, что сделано, что ожидалось и что увидено, и запрещает писать «работает» без доказательств. Учтите: страница skills перечисляет встроенный /verify, который собирает и запускает приложение для подтверждения изменения; без записанного рецепта он сохраняет сработавшие шаги в .claude/skills/verify/SKILL.md, а записанный skill в корне репозитория заменяет встроенный — поэтому не называйте свой skill просто verify.
Документация Claude Code: Skills (slash-commands ведёт сюда)
---
name: verify-app
description: End-to-end check of the web app after a change. Runs the evidence script, drives the changed flow in the browser and reports what was seen. Use before opening a PR.
disable-model-invocation: true
argument-hint: [flow-name]
allowed-tools: Bash(bash scripts/verify.sh) Read
---
1. Run `bash scripts/verify.sh`, then read .claude/evidence/latest.md.
If any step shows a non-zero exit code, stop and report it.
2. Start the app with the command from CLAUDE.md and open it in the
connected browser (http://localhost:3000).
3. Exercise the flow named in $ARGUMENTS: the happy path, one invalid
input, one empty state.
4. For each step write down what you did, what you expected, what you saw.
Take a screenshot of the final state.
5. Report: commands with exit codes, the evidence file path, screenshot
paths, and every mismatch against the plan. Never write "works" without
attaching the evidence.Субагенты — по одному Markdown-файлу в .claude/agents/ для проекта (в git) или в ~/.claude/agents/ для себя. Актуальная страница sub-agents перечисляет front matter: name и description обязательны; tools, disallowedTools, model, permissionMode, maxTurns, skills, memory, isolation и другие — опциональны. Поле tools детерминировано: субагент с Read, Grep, Glob — ревьюер, который не может править, и этот предел обеспечивает Claude Code, а не просьба в промпте. code-simplifier из треда должен менять файлы и запускать проверки, поэтому пример даёт Edit и Bash; model: inherit сохраняет модель основной сессии. Делегировать ли ему — решает Claude основной сессии по description; его можно и назвать в промпте.
---
name: code-simplifier
description: Simplifies code that was just written without changing behaviour. Use after the implementation passes its tests and before review.
tools: Read, Grep, Glob, Edit, Bash
model: inherit
---
You are cleaning up a diff you did not write. Work only on files changed
since the base branch: `git diff --name-only main...HEAD`.
- Remove dead code, duplicated helpers and abstraction layers used once.
- Keep public interfaces and observable behaviour identical. Add no features.
- After each file, run `pnpm tsc --noEmit` and the test file for that module.
- Finish with a table: file, lines before, lines after, commands run and
their exit codes. If a check fails, revert that file and say so.Замечание о стоимости со страницы best practices: каждый запрос субагента засчитывается в ваше использование, а свежий субагент сначала собирает контекст, который уже был в разговоре, поэтому может оказаться медленнее; передача той же задачи субагенту не даёт более умного ответа — только параллелизм, вывод, не засоряющий основной разговор, и взгляд, не видевший рассуждения. Ставьте model: haiku для простых задач и смотрите в /usage, сколько стоит каждый тип субагента.
Документация Claude Code: Best practices · Документация Claude Code: субагенты
7. Верификация зависит от области: какая проверка, какие доказательства, кто принуждает
Суть пункта 13 не в расширении Chrome, а в том, чтобы дать Claude нечто, возвращающее pass или fail. Страница best practices перечисляет тестовые файлы, код выхода сборки, линтер, скрипт, сравнивающий вывод с эталоном, и скриншот браузера рядом с макетом, и говорит: если в репозитории уже есть одно из этого, самая полезная строка CLAUDE.md — команда его запуска. Строгость бывает четырёх уровней: в промпте (Claude сам решает, когда доволен), как /goal (отдельная модель проверяет условие после каждого хода, полезно для долгих фоновых запусков), как Stop hook (принуждает harness до прохождения или лимита) и силами того, кто не писал код (/code-review в свежем субагенте).
Документация Claude Code: Best practices · Документация Claude Code: /goal
| Область | Проверка | Доказательства | Кто принуждает |
|---|---|---|---|
| Библиотека / чистая логика | Юнит-тесты, typecheck, lint | Команда, код выхода, имена упавших кейсов | Оценивает инструментарий; Stop hook гарантирует запуск |
| CLI-инструмент | Одна bash-команда против ожидаемого вывода; diff с эталоном | Команда и фрагмент stdout/stderr | Код выхода скрипта; Stop hook |
| Web UI | Интеграция Chrome открывает локальную страницу, заполняет формы, читает консоль; /verify собирает и запускает | Скриншоты, список ошибок консоли, заметки по шагам | Браузером управляет модель; скриншоты читает человек |
| Мобильное приложение | Запуск в симуляторе, как описано в треде; отдельной страницы документации не найдено | Скриншоты, лог сборки | Решает модель; зависит от вашего инструментария |
| Данные / скрипты | Повторный прогон на фиксированном входе, сравнение хеша или числа строк | Хеш вывода, число строк, diff | Оценивает скрипт; можно включить в verify.sh |
| Долгий автономный запуск | Условие /goal плюс Stop hook плюс --max-turns | Файл доказательств плюс описание PR | /goal оценивает модель; hook и лимит ходов — harness |
Документация Claude Code: Best practices · Документация Claude Code: интеграция Chrome · Документация Claude Code: Skills (slash-commands ведёт сюда) · Документация Claude Code: /goal
Chrome заслуживает отдельной проверки предпосылок. Актуальная страница Chrome требует Chrome, Edge или другой Chromium-браузер с расширением Claude in Chrome версии 1.0.36 и новее; прямой план Anthropic Pro, Max, Ultra, Team или Enterprise со входом через /login, потому что с API-ключом или долгоживущим токеном интеграция остаётся выключенной; сторонние облачные провайдеры не поддерживаются; WSL не поддерживается. Запуск — claude --chrome или «Enabled by default» в /chrome с предупреждением, что постоянно включённые инструменты браузера увеличивают расход контекста. На страницах входа и CAPTCHA Claude останавливается и просит вас разобраться. Из привычки треда тестировать каждое изменение claude.ai/code скопировать можно вот что: Claude открывает страницу на localhost, проходит изменённый сценарий, читает ошибки консоли и делает скриншоты; скопировать нельзя содержание тестов чужой команды.
На любом уровне требуйте доказательства. Страница best practices по сути говорит, что «все тесты проходят» сообщает очень мало, что прочитать вывод быстрее, чем перезапускать проверку, и что для сессии, за которой вы не следили, это единственное доказательство. Там же контринтуитивный совет по ревью: велите ревьюеру пропускать стиль, потому что ревьюер, которому велено искать проблемы, всегда что-нибудь найдёт, а исправление каждого замечания нагромождает слои абстракции и тесты для невозможных случаев.
8. Скрипт доказательств: один файл для Claude, Stop hook и ревьюера
verify.sh ниже — собственный пример этой статьи; он прошёл bash -n офлайн и не запускался в реальном проекте. Он по очереди выполняет typecheck, тесты и сборку, записывает код выхода, длительность и путь к логу каждого шага в .claude/evidence/ в файл .md с меткой времени, направляет latest.md на свежайший файл и в конце печатает весь файл в stderr — так что при использовании как Stop hook (bash scripts/verify.sh || exit 2) причиной, по которой Claude не может завершить, становятся сами доказательства. Пример CLAUDE.md и skill verify-app ссылаются на ту же команду, поэтому все трое цитируют один вывод.
Документация Claude Code: Best practices · Документация Claude Code: справочник Hooks
#!/usr/bin/env bash
# scripts/verify.sh - run the project's checks and write an evidence file
# that Claude, a Stop hook and a human reviewer can all quote.
set -u
OUT_DIR=".claude/evidence"; mkdir -p "$OUT_DIR"
STAMP="$(date -u +%Y%m%dT%H%M%SZ)"
OUT="$OUT_DIR/$STAMP.md"
status=0
run() { # run <label> <command...>
local label="$1"; shift
local start; start=$(date +%s)
local rc=0
"$@" >"$OUT_DIR/$label.log" 2>&1 || rc=$?
printf -- '- %s: exit %s, %ss, log %s/%s.log\n' \
"$label" "$rc" "$(( $(date +%s) - start ))" "$OUT_DIR" "$label" >>"$OUT"
[ "$rc" -ne 0 ] && status=1
return 0
}
{
echo "# Verification evidence $STAMP"
echo "- commit: $(git rev-parse --short HEAD 2>/dev/null || echo none)"
echo "- changed files: $(git diff --name-only HEAD 2>/dev/null | wc -l | tr -d ' ')"
} >"$OUT"
run typecheck pnpm tsc --noEmit
run tests pnpm vitest run
run build pnpm build
echo "- overall: $([ "$status" -eq 0 ] && echo PASS || echo FAIL)" >>"$OUT"
ln -sfn "$STAMP.md" "$OUT_DIR/latest.md"
cat "$OUT" >&2 # stderr, so "bash scripts/verify.sh || exit 2" works as a Stop hook
exit "$status"Три компромисса. Вешать ли весь скрипт на Stop: полные тесты и сборка при каждой попытке Claude завершить могут быть медленными, поэтому settings.json из раздела 5 запускает на Stop только tsc и оставляет полный скрипт skill или промпту; если ваш набор идёт минуту-две, можно повесить всё. Скрипт намеренно игнорирует stop_hook_active, потому что пересчитывает всё заново и не имеет условия, которое никогда не выполнится; если ваша проверка зависит от внешнего сервиса, читайте JSON со stdin в начале и выходите с 0, когда stop_hook_active равен true и провал повторяется, передавая проблему человеку. И коммитить ли каталог доказательств: добавьте его в .gitignore и вставляйте latest.md в описание PR, иначе каждый запуск станет шумом в истории.
Сочетая скрипт с CLAUDE.md, разделяйте роли. CLAUDE.md сообщает Claude, что команда существует, и Claude обычно запускает её после завершения; Stop hook гарантирует, что она выполнилась и прошла хотя бы раз до конца хода; файл доказательств позволяет человеку проверить без перезапуска. Поэтому best practices оставляет строку typecheck в CLAUDE.md одной лишь командой: команда — для модели, принуждение — для hook.
9. Что изменилось с января по ноябрь
Пункты 1, 2, 3 и 11 — в основном выбор окружения и инструментов, и перед копированием их нужно обновить. Opus 4.5 с thinking был выбором автора треда на тот момент; страница model config теперь называет Opus 5.5 при medium effort моделью по умолчанию на большинстве планов и провайдеров, а best practices делает effort главным регулятором глубины размышления, тогда как фразы вроде think hard — обычный текст промпта. Логика треда — более крупная модель, требующая меньше правок, в итоге быстрее — по-прежнему верна; имя модели берите из /model. Для параллельных сессий документация теперь рекомендует worktree на сессию (claude -w feature-x), чтобы правки не сталкивались, а страница terminal config сообщает, что Ghostty, Kitty и iTerm2 показывают уведомления, причём в iTerm2 нужно сначала включить настройки оповещений.
Документация Claude Code: конфигурация модели · Документация Claude Code: Best practices · Документация Claude Code: настройка терминала и уведомления
| Тред (2026-01) | Документация 2026-11-08 | Что это значит для команды |
|---|---|---|
| Opus 4.5 с thinking | По умолчанию Opus 5.5 при medium effort; регулирует /effort | Не зашивайте имя модели в CLAUDE.md; используйте /effort, а не формулировки промпта |
| Shift+Tab дважды для plan mode | Сессии стартуют в auto; из auto три нажатия, или /plan | Пишите в своей документации /plan |
| Амперсанд передаёт локальную сессию в веб | Передача из CLI односторонняя: --cloud создаёт, --teleport забирает; настольное приложение может отправить локальную сессию | Передача амперсандом — только тред; документируйте актуальные команды |
| .claude/commands/ для slash-команд | Объединены со skills; старые файлы работают; новая форма SKILL.md | Новые процессы пишите как skills и управляйте тем, кто их вызывает |
| /install-github-action | /install-github-app | Команда переименована |
| Без --dangerously-skip-permissions | Существует; документация ограничивает одноразовыми контейнерами | Позиция та же; deny-правила действуют и в этом режиме |
| Плагин ralph-wiggum | Не найден по проверенному пути репозитория | Не ставьте по треду; сначала подтвердите источник |
| Фоновый агент проверяет долгие задачи | Субагенты по умолчанию работают в фоне; /goal — встроенная альтернатива | Для долгих задач предпочитайте /goal или Stop hook |
Документация Claude Code: конфигурация модели · Документация Claude Code: режимы разрешений · Документация Claude Code: облачные сессии (--cloud и --teleport) · Документация Claude Code: Skills (slash-commands ведёт сюда) · Документация Claude Code: GitHub Actions · Документация Claude Code: справочник Hooks · Документация Claude Code: субагенты · Документация Claude Code: /goal
Принцип пункта 11 не изменился: предпочитайте CLI, когда он есть, — с установленным и авторизованным gh Claude открывает pull request и читает ревью без объяснений; для систем без CLI используйте MCP через claude mcp add --transport http с именем и адресом сервера, после чего сервер появляется в /mcp. Best practices добавляет замечание о стоимости: подключённые серверы добавляют имена и описания своих инструментов в контекст, даже когда не используются, поэтому ненужные выключайте. Общий .mcp.json с конфигурацией Slack, как в треде, этому не противоречит; учётные данные держите в переменных окружения, а не в файле.
10. Воспроизвести в команде за неделю: порядок и приёмка
Упорядочьте работу по зависимостям и начните с того, что подтверждают тесты. Последовательность предполагает, что в репозитории уже есть команда тестов или typecheck; если нет, сначала добавьте одну команду, возвращающую pass или fail, потому что на ней держатся все дальнейшие шаги. Для каждого шага указано, как убедиться, что он сработал, и каждый способ взят из актуальной документации.
- День 1: написать CLAUDE.md по шаблону из раздела 4 — только команды, соглашения, подводные камни и определение готовности; дать /init набросать черновик, затем сократить до 200 строк; подтвердить через /context all и прочитать предложения /doctor.
- День 2: закоммитить раздел permissions в .claude/settings.json; каждому участнику принять диалог доверия для папки, иначе allow-правила бездействуют; проверить действующие правила через /permissions и попросить Claude прочитать .env, чтобы убедиться в отказе.
- День 3: добавить PostToolUse hook форматирования; попросить Claude вставить криво отформатированную строку в файл, который обрабатывает Prettier, и убедиться, что сохранённый файл исправлен; список зарегистрированных hooks смотреть в /hooks.
- День 4: добавить scripts/verify.sh и Stop hook (сначала только tsc); попросить Claude сделать изменение, ломающее тип, и убедиться, что он получает ошибки компилятора и продолжает работу вместо остановки; если срабатывает лимит восьми блокировок — ошибка в самом условии.
- День 5: добавить skill verify-app и субагент code-simplifier; один раз запустить /verify-app <flow> и проверить файл доказательств и скриншоты; попросить Claude вызвать code-simplifier и просмотреть коды выхода в его отчёте.
- Еженедельно: переносить повторяющиеся замечания ревью в CLAUDE.md (или доверить это GitHub Action); раз в месяц запускать /doctor prompt-audit; когда принуждаемых правил больше десятка, спросить, какие из них на самом деле предпочтения.
Документация Claude Code: Best practices · Документация Claude Code: справочник Hooks · Документация Claude Code: Memory и CLAUDE.md · Документация Claude Code: Skills (slash-commands ведёт сюда) · Документация Claude Code: правила разрешений
Достаточно одного критерия приёмки: для любого изменения, выполненного Claude, ревьюер видит из описания PR или файла доказательств, что запускалось, с какими кодами выхода и какими скриншотами, не перезапуская ни одной команды. Когда это выполняется, петля из пункта 13 существует. Утверждение о росте качества в два-три раза — опыт автора треда; воспроизвести коэффициент мы не могли и не пытались.
Чего мы не проверяли: мы не запускали Claude Code, поэтому не наблюдали лимит восьми Stop-блокировок, момент срабатывания PostToolUse и интеграцию Chrome на практике; не подтвердили текущее расположение плагина ralph-wiggum; передаче локальной сессии в веб амперсандом нет соответствия в актуальной документации, и мы не можем сказать, работает ли она ещё; просмотры — показания на 2026-11-08; рост качества в два-три раза — личный опыт автора треда, не воспроизведённый нами. Статья разбирает публичную документацию Anthropic и публичный тред одного инженера; сайт не связан с Anthropic. Связанные статьи ниже охватывают границы автономных запусков, инцидент с адресом аккаунта в User-Agent и отчёт об использовании Claude исследователями.