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).

Борис Черный: начало треда (2026-01-02)

Процесс и разрешения: большинство сессий начинаются в 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).

Борис Черный: начало треда (2026-01-02)

И верификация: для долгих задач — попросить 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.

Документация Claude Code: Best practices

13 пунктов против документации на 2026-11-08. «Только тред» помечает деталь, найденную лишь в треде или с тех пор изменившуюся.
ПунктТред (2026-01)Документация (2026-11-08)МеханизмФайл или команда
15 локальных сессий параллельно, нумерованные вкладки, уведомленияTerminal config: Ghostty, Kitty и iTerm2 умеют показывать уведомления; для параллельной работы — отдельный worktree на сессию (claude -w)Инструменты, не поведение моделиclaude -w <name>; настройки уведомлений терминала
25–10 облачных сессий; передача амперсандом; --teleport обратноСтраница облачных сессий: --cloud создаёт новую облачную задачу; --teleport забирает облачную сессию в терминал; CLI не может отправить существующую локальную сессию в облако (передача амперсандом — только тред)Инструментыclaude --cloud ...; claude --teleport
3Opus 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.mdGitHub 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 блокирует harnessShift+Tab; /plan; claude --permission-mode plan
7Slash-команда на каждый внутренний цикл в .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-appSub-agents: .claude/agents/<name>.md с name, description, tools, model и другими полями; список tools принуждает harnessСмешанный: делегирование решает модель, набор инструментов принуждается.claude/agents/code-simplifier.md
9PostToolUse 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.jsonPermissions: правила allow, ask и deny; deny действует в любом режиме; allow в общем файле ждёт диалога доверия у каждогоПринуждает harness.claude/settings.json permissions
11Slack MCP в .mcp.json; bq CLI; SentryBest practices: предпочитать CLI, когда он есть; иначе claude mcp add --transport http; выключать неиспользуемые серверы в /mcpИнструментыclaude mcp add ...; .mcp.json
12Долгие задачи: фоновый агент, Stop hook или плагин ralph-wiggumHooks: 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 тестирует UIBest 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 и ревьюер цитируют один документ.

  1. Plan mode: прочитать код, предложить, договориться об определении готовности (Shift+Tab или /plan)
  2. Одобрить план → переключиться на acceptEdits или auto; Claude реализует
  3. После каждого Edit/Write PostToolUse hook форматирует файл (принуждает harness)
  4. Claude запускает команду проверки из CLAUDE.md, читает вывод, правит до прохождения
  5. Claude пытается остановиться → Stop hook запускает tsc или verify.sh; код 2 возвращает к работе (принуждает harness, лимит 8 подряд)
  6. Проход → доказательства: команды, коды выхода, пути логов, скриншоты (scripts/verify.sh пишет .claude/evidence/)
  7. Независимое ревью: свежий субагент /code-review или другой инженер сверяет доказательства с планом
  8. Слияние одобряет человек; защита ветки — последний детерминированный барьер
Петля верификации одного изменения. Принуждаемые harness шаги: hook форматирования, Stop hook, блокировка правок в plan mode. Остальное оценивает модель или человек.

Документация 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.

Документация Claude Code: Best practices

Пример CLAUDE.md: команды, соглашения, подводные камни и определение готовности. Корень репозитория, в git; личные предпочтения — в CLAUDE.local.md под .gitignore.
# 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; одобряя план, вы выбираете следующий режим — это и есть переключение на автоприём правок из треда.

Документация Claude Code: режимы разрешений

Пункт 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: режимы разрешений

Пример .claude/settings.json: предразрешённые команды проверки, запрос перед push, запрет секретных файлов, форматирование после Edit|Write, typecheck перед остановкой. В git, действует на всю команду.
{
  "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

Где живёт правило, тем и определяется, к кому оно применяется. Источники: страницы settings, best practices и memory, 2026-11-08.
Файл или местоК кому применяетсяЧто кластьПримечание
~/.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 ведёт сюда)

Пример .claude/skills/verify-app/SKILL.md: процедура сквозной верификации, которую может запустить только человек.
---
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; его можно и назвать в промпте.

Документация Claude Code: субагенты

Пример .claude/agents/code-simplifier.md: подчищает код после прохождения тестов и отчитывается о числе строк и кодах выхода.
---
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

Выбор проверки и доказательств по области. «Кто принуждает» — кто гарантирует результат: проверку оценивает инструментарий, запуск может гарантировать Stop hook.
ОбластьПроверкаДоказательстваКто принуждает
Библиотека / чистая логикаЮнит-тесты, 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, проходит изменённый сценарий, читает ошибки консоли и делает скриншоты; скопировать нельзя содержание тестов чужой команды.

Документация Claude Code: интеграция Chrome

На любом уровне требуйте доказательства. Страница best practices по сути говорит, что «все тесты проходят» сообщает очень мало, что прочитать вывод быстрее, чем перезапускать проверку, и что для сессии, за которой вы не следили, это единственное доказательство. Там же контринтуитивный совет по ревью: велите ревьюеру пропускать стиль, потому что ревьюер, которому велено искать проблемы, всегда что-нибудь найдёт, а исправление каждого замечания нагромождает слои абстракции и тесты для невозможных случаев.

Документация Claude Code: 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

scripts/verify.sh: запустить проверки и записать файл доказательств; замените команды pnpm на команды вашего проекта.
#!/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 Code: справочник Hooks

Сочетая скрипт с CLAUDE.md, разделяйте роли. CLAUDE.md сообщает Claude, что команда существует, и Claude обычно запускает её после завершения; Stop hook гарантирует, что она выполнилась и прошла хотя бы раз до конца хода; файл доказательств позволяет человеку проверить без перезапуска. Поэтому best practices оставляет строку typecheck в CLAUDE.md одной лишь командой: команда — для модели, принуждение — для hook.

Документация Claude Code: Best practices

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-11-08.
Тред (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, как в треде, этому не противоречит; учётные данные держите в переменных окружения, а не в файле.

Документация Claude Code: Best practices

10. Воспроизвести в команде за неделю: порядок и приёмка

Упорядочьте работу по зависимостям и начните с того, что подтверждают тесты. Последовательность предполагает, что в репозитории уже есть команда тестов или typecheck; если нет, сначала добавьте одну команду, возвращающую pass или fail, потому что на ней держатся все дальнейшие шаги. Для каждого шага указано, как убедиться, что он сработал, и каждый способ взят из актуальной документации.

  1. День 1: написать CLAUDE.md по шаблону из раздела 4 — только команды, соглашения, подводные камни и определение готовности; дать /init набросать черновик, затем сократить до 200 строк; подтвердить через /context all и прочитать предложения /doctor.
  2. День 2: закоммитить раздел permissions в .claude/settings.json; каждому участнику принять диалог доверия для папки, иначе allow-правила бездействуют; проверить действующие правила через /permissions и попросить Claude прочитать .env, чтобы убедиться в отказе.
  3. День 3: добавить PostToolUse hook форматирования; попросить Claude вставить криво отформатированную строку в файл, который обрабатывает Prettier, и убедиться, что сохранённый файл исправлен; список зарегистрированных hooks смотреть в /hooks.
  4. День 4: добавить scripts/verify.sh и Stop hook (сначала только tsc); попросить Claude сделать изменение, ломающее тип, и убедиться, что он получает ошибки компилятора и продолжает работу вместо остановки; если срабатывает лимит восьми блокировок — ошибка в самом условии.
  5. День 5: добавить skill verify-app и субагент code-simplifier; один раз запустить /verify-app <flow> и проверить файл доказательств и скриншоты; попросить Claude вызвать code-simplifier и просмотреть коды выхода в его отчёте.
  6. Еженедельно: переносить повторяющиеся замечания ревью в 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 существует. Утверждение о росте качества в два-три раза — опыт автора треда; воспроизвести коэффициент мы не могли и не пытались.

Борис Черный: пункт 13, петля верификации

Чего мы не проверяли: мы не запускали Claude Code, поэтому не наблюдали лимит восьми Stop-блокировок, момент срабатывания PostToolUse и интеграцию Chrome на практике; не подтвердили текущее расположение плагина ralph-wiggum; передаче локальной сессии в веб амперсандом нет соответствия в актуальной документации, и мы не можем сказать, работает ли она ещё; просмотры — показания на 2026-11-08; рост качества в два-три раза — личный опыт автора треда, не воспроизведённый нами. Статья разбирает публичную документацию Anthropic и публичный тред одного инженера; сайт не связан с Anthropic. Связанные статьи ниже охватывают границы автономных запусков, инцидент с адресом аккаунта в User-Agent и отчёт об использовании Claude исследователями.