Лучшие практики для Claude Code

• Чтобы команды выполнялись безопасно без вашего подтверждения каждой из них, новые сессии в терминале и VS Code запускаются в авторежиме, где классификатор проверяет всё рискованное перед выполнением.
• Чтобы ваш основной диалог оставался сфокусированным, пока независимая работа идёт параллельно, Claude делегирует задачи субагентам и обращается к вам только при необходимости.
• Чтобы длинная сессия продолжалась без вашего управления, диалог автоматически сжимается до того, как заполнится контекстное окно.

• Процесс деплоя, который существует только в чьей-то голове
• Файл, который никогда нельзя читать
• Проверка, которая должна пройти, прежде чем что-либо будет считаться выполненным
• Бюджет, который нельзя превышать

• Claude сделал не то, что вы имели в виду, или ему приходится заново выяснять один и тот же факт в начале каждой сессии. Ему не хватает информации, которую нельзя получить из чтения репозитория. См. Сообщите Claude то, чего он не видит.
• Claude сказал, что закончил, но это было не совсем так, обычно потому, что у него не было способа проверить свою работу. См. Дайте Claude проверку для запуска.
• Claude сделал то, чего никогда не должно происходить в этом репозитории, или пропустил шаг, который должен выполняться всегда. Один лишь промпт не может гарантировать ни того, ни другого. См. Обеспечьте соблюдение правил без исключений.
• Claude всё сделал правильно, но это потребовало больше времени, токенов или запросов разрешений, чем стоила задача. См. Измените настройку по умолчанию.

Детерминированные и недетерминированные инструкции

1. Недетерминированные: вы пишете инструкцию, а Claude (модель) её читает. Это может быть ваш промпт, CLAUDE.md или скилл. Затем модель решает, что делать с этой информацией. Обычно она следует вашим командам, и современные модели хорошо понимают ваше намерение без большого контекста, но нет гарантии, что она выполнит ваши инструкции. Она всё равно может решить чего-то не делать или сделать что-то другое.
2. Детерминированные: вы настраиваете инструкцию, и Claude Code (среда выполнения) обязан её выполнить. Это может быть хук, правило deny или управляемая настройка. Claude Code применяет это каждый раз, независимо от того, что решила модель.

• Никогда не редактировать сгенерированный клиент в src/gen/
• Всегда запускать скрипт заголовков лицензии после создания файла

Сообщите Claude то, чего он не видит

• Решение, которое ваша команда приняла на встрече
• Процесс деплоя, который существует только в голове одного человека
• Переменная окружения, нужная вашим интеграционным тестам

1. Может ли он найти это, читая код?
2. Станет ли он действительно это искать?

Пишите конкретный промпт

• Файл: введите @ и путь, чтобы включить содержимое файла в сообщение.
• Изображение: вставьте скриншот макета или ошибки в промпт.
• Вывод команды: передайте его из оболочки через cat error.log | claude -p "what's going on here".

build the settings page from the mockup. be ambitious: empty and error states, the save flow wired up, keyboard navigation, not just the layout

Сначала проведите мозговой штурм с Claude

I want to add rate limiting to the public API but haven't thought it through yet. Interview me until you could write the spec, then write it to SPEC.md.

Держите CLAUDE.md коротким

• Как проверить работу в этом репозитории: точные команды тестов, проверки типов и линтера, а также как запустить один тестовый файл
• Места, где код вводит в заблуждение: старый паттерн, который встречается повсюду, но который новый код не должен копировать, или каталог, который выглядит неиспользуемым, но на самом деле используется
• Решения, которых нет в репозитории: на каком хелпере ошибок остановилась команда, как устроены деплои, что требует ревью миграций
• Всё, что вам уже дважды пришлось исправлять

# Commands
- Install: pnpm install
- Run one test file: pnpm vitest run path/to/file.test.ts
- Typecheck: pnpm tsc --noEmit

# Conventions
- Use the error helpers in src/lib/errors.ts, never throw raw strings
- src/legacy/ is still live but don't copy its patterns into new code

# Gotchas
- Integration tests need DATABASE_URL set, see .env.example

• /init генерирует начальную версию на основе вашей кодовой базы. Дальше работа в основном сводится к удалению строк. Руководство по памяти рекомендует не превышать 200.
• /doctor предлагает сокращения для всего, что Claude может и так вывести из кода.
• /doctor prompt-audit помечает инструкции, которые были написаны для старых моделей, ссылаются на несуществующие файлы или противоречат друг другу.

Ограничьте правила одной частью кодовой базы

---
paths:
  - "src/api/**/*.ts"
---
- Validate request bodies with the zod schemas in src/api/schemas/, don't hand-roll checks
- Every new endpoint needs an entry in openapi.yaml, CI fails without it

Помещайте командные процедуры в скиллы

---
name: release
description: Cut a new release. Bumps the version, writes the changelog entry, tags it and pushes the tag so CI can publish.
disable-model-invocation: true
---
1. Make sure you're on main with a clean tree. If not, stop and ask.
2. Run `pnpm changeset version` and commit the result.
3. Summarize the PRs merged since the last tag into CHANGELOG.md, one line each, user-facing changes only.
4. Tag `v<new version>` and push the tag. CI publishes from there, never publish from your machine.

Подключите инструменты, которые нужны Claude

claude mcp add --transport http notion https://mcp.notion.com/mcp

Дайте Claude проверку для запуска

• Тестовый файл
• Код выхода сборки
• Линтер
• Скрипт, сравнивающий вывод с фикстурой
• Скриншот браузера рядом с макетом

• В промпте: run the auth tests after, and keep going until they pass. Claude сам решает, когда результат его устраивает. Это работает для любой задачи уже сегодня и без настройки.
• Как цель: /goal all tests in tests/auth pass and lint is clean задаёт условие, которое отдельная модель проверяет по диалогу после каждого хода, и Claude продолжает, пока оно не выполнено. Вам самим в сессии это нужно редко. Это важно для длинных фоновых запусков, где Claude иногда завершает ход сводкой о прогрессе, хотя пункты ещё не закрыты, и цель отправляет его обратно к работе.
• Как хук Stop: хук Stop запускает ваш скрипт каждый раз, когда Claude пытается завершить ход, и возвращает Claude к работе, если скрипт завершается с кодом выхода 2. Это обеспечивается Claude Code (средой выполнения), поэтому ход не закончится, пока проверка типов не пройдёт или не будет достигнут лимит блокировок. Пример приведён ниже.
• Тем, кто не писал код: в терминале /code-review проверяет diff в новом субагенте, который никогда не видел ваш диалог. На него не влияют рассуждения, которые привели к этому коду.

Ревью на соответствие спецификации

use a subagent to review the rate limiter diff against SPEC.md, check every requirement is implemented and the listed edge cases have tests, report gaps that affect correctness and skip style

Обеспечьте проверку с помощью хука Stop

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          { "type": "command", "command": "pnpm tsc --noEmit 1>&2 || exit 2" }
        ]
      }
    ]
  }
}

Обеспечьте соблюдение правил без исключений

Обеспечьте выполнение шагов с помощью хуков

• Shell-команда (обычный случай)
• POST-запрос к HTTP-эндпоинту
• Вызов инструмента на одном из ваших MCP-серверов
• Хук prompt или agent, который позволяет решать модели

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "f=$(jq -r '.tool_input.file_path') && npx prettier --write --ignore-unknown \"$f\"" }
        ]
      }
    ]
  }
}

Ограничьте доступ с помощью правил разрешений и песочницы

{
  "permissions": {
    "allow": ["Bash(pnpm tsc --noEmit)"],
    "ask": ["Bash(git push *)"],
    "deny": ["Read(./.env)", "Read(./.env.local)", "Read(./secrets/**)"]
  }
}

• Правило Read действительно перехватывает cat .env, потому что Claude Code распознаёт распространённые команды чтения файлов.
• Оно не перехватит скрипт, который открывает файл.
• Правило deny для WebFetch на домен ничего не делает с curl к тому же домену, если не включена песочница.

Выберите, к кому применяется правило

• .claude/settings.local.json и ~/.claude/settings.json принадлежат только вам. Когда вы выбираете Yes, and don’t ask again для команды, Claude Code сохраняет это правило в локальный файл.
• .claude/settings.json и хуки в нём принадлежат репозиторию. После коммита они применяются ко всем, кто работает в репозитории. Его правила deny действуют сразу. Его правила allow ждут, пока каждый человек не примет диалоговое окно доверия для этой папки, а доверие к рабочему пространству также определяет, когда его хуки начнут выполняться на их машине.
• Управляемые настройки принадлежат организации. Они поступают из консоли администратора, MDM или файла managed-settings.json, и никакой личный файл настроек не может их переопределить, что делает их единственным местом для политики команды безопасности. Если именно вы их задаёте, см. Настройка Claude Code для вашей организации.

Измените настройку по умолчанию

• Интерактивные сессии в терминале и VS Code запускаются в авторежиме.
• На большинстве тарифов и у большинства провайдеров используется Claude Opus 5.5 с effort medium.
• Работа делегируется субагентам, когда для этого есть причина.
• Диалог сжимается по мере роста.

Измените режим разрешений

• Режим Manual: вы сами подтверждаете каждую правку и каждую команду, которая выходит за рамки чтения. Безопасно, но после десятого запроса вы начинаете подтверждать не читая, и ничего не движется, пока вас нет за клавиатурой.
• bypassPermissions: подтверждает всё, что не покрыто вашими правилами deny и ask, что имеет смысл только в одноразовом контейнере.

• curl | bash
• Деплои и миграции в продакшене
• Force push поверх чужой работы
• Отправка конфиденциальных данных на внешние эндпоинты
• Действия, которые выглядят так, будто ими управляет контент, прочитанный Claude, а не вы

{
  "autoMode": {
    "environment": [
      "$defaults",
      "Source control: github.com/example-org and every repo under it",
      "Trusted internal domains: *.internal.example.com"
    ],
    "allow": [
      "$defaults",
      "Deploying to the staging namespace is fine, it's isolated from production and resets nightly"
    ]
  }
}

Измените модель и effort

• Повысьте его через /effort high или /effort xhigh, когда правильный результат зависит от случаев, которые легко упустить. Например, баг в коде, который писали не вы, нестабильный тест или изменение схемы, при котором Claude должен найти всех, кто читает старую структуру. Тогда Claude проверяет больше граничных случаев и тщательнее перепроверяет свою работу перед ответом — на это и уходят дополнительное время и токены.
• Понизьте его через /effort low, когда вы быстро обмениваетесь репликами и всё равно просматриваете каждый результат: мозговой штурм, первый набросок, переименование в нескольких файлах. Claude быстрее даст вам отправную точку, а поскольку вы направляете каждый шаг, дополнительные размышления почти ничего бы не изменили, кроме времени ожидания.
• Оставьте max для сложной задачи, которую Claude должен проработать без вас, например поиска уязвимости. На обычных задачах он склонен размышлять избыточно, так что вы платите больше за ответ, который может оказаться не лучше, чем дал бы high.
• Когда это нужно только для следующего сообщения, например для одного хитрого вопроса посреди в остальном рутинной работы, добавьте в этот промпт ultrathink, вместо того чтобы менять настройку.

Знайте, во что обходятся субагенты

• Широкий поиск по кодовой базе передаётся встроенному агенту Explore.
• Побочные задачи ответвляются, пока включён режим fork (по умолчанию).
• Запускаемые им субагенты по умолчанию работают в фоне, поэтому ваш основной диалог продолжается.

• Одновременное выполнение независимых частей работы, чтобы вся задача завершилась быстрее
• Вынос длинного вывода, например полного прогона тестов или широкого поиска, из основного диалога, где иначе он оставался бы до конца сессии
• Получение рецензента, который не видел, как писался код
• Предоставление задаче меньшего набора инструментов, чем у основной сессии, например рецензент, который может читать, но не редактировать

• Задайте model: haiku в определении субагента, если его работа проста, например собрать файлы, импортирующие модуль, или проверить ссылки в документации. Такой работе не нужна большая модель, а Haiku стоит намного дешевле за запрос.
• Просите возвращать короткие сводки, чтобы двадцать результатов всё равно не заполнили ваш контекст.
• Смотрите /usage, чтобы увидеть, какую долю использования занимает каждый тип субагентов, и понять, какие из них оправдывают свою стоимость.
• Дайте пользовательскому субагенту в .claude/agents/ только tools: Read, Grep, Glob. Теперь это рецензент, который ничего не может редактировать, и это ограничение обеспечивается Claude Code, а не запрашивается в промпте.

---
name: reviewer
description: Reviews changed files against the spec they were built from. Use after implementing a feature, before opening the PR.
tools: Read, Grep, Glob
---
You're reviewing code you didn't write. Compare the changed files against the spec you're given,
check that every requirement is implemented and the listed edge cases have tests,
and report only the gaps that affect correctness. Skip style.

Сокращайте расходы и контекст

• /clear между несвязанными задачами. Это ничего не стоит и означает, что следующая задача не продолжает платить за историю предыдущей. /clear oauth-migration даёт имя сессии, которую вы покидаете, чтобы позже к ней можно было вернуться.
• /compact с фокусом, например /compact keep the API changes and the test commands. В длинной сессии /compact сам по себе является большим запросом, поскольку читает весь диалог, чтобы его обобщить, и тем более после истечения кэша.
• Следите за фоновой работой: /loop, проверка цели после каждого хода и собственные субагенты Claude продолжают отправлять запросы, пока вы ничего не вводите.

Управляйте сессией

• Esc останавливает Claude посреди действия и сохраняет всё сделанное до этого момента, поэтому его можно перенаправить без потери работы.
• /rewind или двойное нажатие Esc при пустом промпте открывает меню перемотки, где можно откатить код, диалог или и то, и другое к более раннему промпту. Благодаря этому можно с небольшим риском сначала попробовать более смелый подход и откатиться, если он не сработает. То же меню может обобщить часть диалога, если она устарела.
• /clear начинает заново. Если вы дважды исправили одно и то же, а всё по-прежнему неправильно, третье исправление в основном лишь добавится к диалогу, который уже содержит две неудачные попытки, которые Claude продолжит перечитывать. /clear плюс один новый промпт, учитывающий то, что вы узнали, почти всегда работает лучше.

Позвольте Claude работать без вас

1. Знает ли он, как выглядит готовый результат? Условие цели, файл спецификации или падающий тест, который он должен сделать зелёным.
2. Может ли он проверить свою работу? Набор тестов, хук Stop, какой-либо этап ревью.
3. К чему ему разрешено прикасаться? Правила разрешений, dontAsk, песочница, worktree, единственная ветка, в которую он может делать push.
4. Что его остановит? --max-turns, --max-budget-usd, лимит расходов.
5. Куда идёт результат и кто его утверждает? PR, комментарий или сводка, а затем человек, одобряющий слияние, деплой или что-либо ещё необратимое.

Запускайте Claude из скрипта

• --bare пропускает хуки, скиллы, плагины, MCP-серверы и файлы CLAUDE.md — как из репозитория, так и с машины, — поэтому запуск ведёт себя одинаково, где бы он ни выполнялся. Он также никогда не использует ваш вход в claude.ai: аутентификация берётся из ANTHROPIC_API_KEY, apiKeyHelper в файле, переданном через --settings, или из учётных данных вашего облачного провайдера.
• --append-system-prompt, --mcp-config и --settings явно передают всё, что запуску действительно нужно. Хуки, переданные через --settings, не выполняются при --bare, поэтому не используйте --bare для запуска, которому они нужны.
• --allowedTools заранее разрешает его инструменты, а --permission-mode dontAsk отклоняет всё остальное, что потребовало бы подтверждения.
• --output-format json даёт единый объект результата для разбора, а stream-json с --verbose передаёт события по мере их возникновения.

for file in $(cat files.txt); do
  claude --bare -p "Migrate $file to the new logger API and commit. Reply OK or FAIL." \
    --allowedTools "Read,Edit,Bash(git add *),Bash(git commit *)" \
    --permission-mode dontAsk \
    --max-turns 20
done

Запускайте по расписанию или по событию

/loop 15m check CI on this branch, and if it's red pull the failing job's log, fix it and push

Запускайте сессии параллельно

.env
.env.local
config/dev-credentials.json

• Когда вы выходите из безымянной сессии в worktree, Claude Code удаляет worktree, если в нём ничего нет. Для именованной сессии или сессии с изменениями он спрашивает, что делать.
• Worktree субагентов исчезают, когда субагент завершает работу без изменений.
• Оставшиеся worktree субагентов и фоновых сессий удаляются, когда они старше cleanupPeriodDays и не содержат работы.

Что можно перестать делать

Связанные ресурсы

• Как работает Claude Code: цикл, инструменты и то, что загружается при запуске
• Изучите контекстное окно: что занимает место в сессии и когда оно загружается
• Расширьте Claude Code: выбор между скиллами, хуками, MCP, субагентами и плагинами
• Выберите режим разрешений и Настройте разрешения
• Эффективно управляйте расходами
• Запускайте Claude Code программно и Автоматизируйте работу с облачными запланированными задачами
• Для руководителей команд и администраторов: Настройка Claude Code для вашей организации