Claude AI: руководство, советы и лучшие практики

Projects в Claude Code собрали заново. Раньше проект был папкой, в которой лежали диалоги и справочные материалы; новые Projects — это один диалог. Вы описываете, что вам нужно, Claude разбивает это на треды, треды параллельно выполняются в облаке, и каждый по завершении открывает pull request и отчитывается. Закрытый ноутбук их не останавливает. Правда, прежде чем бросаться пробовать, стоит проверить три вещи: круг аккаунтов по-прежнему ограничен (публичная бета для Pro и Max, которая в первую очередь доходит до аккаунтов без существующих проектов), github.com и Claude GitHub App на практике обязательны, а скорость, с которой всё это съедает лимит использования, несопоставима с одиночной сессией. Статья разбирает, как понять, дошёл ли до вас выкат, с чем стартует тред (включая ловушку, из-за которой правила разрешений и хуки перестают применяться, как только в проекте оказывается больше одного репозитория), откуда берётся расход токенов, в том числе из стоящего по умолчанию Opus с усилием high, и как выбрать из пяти способов работать параллельно: субагенты, agent view, команды агентов, динамические рабочие процессы и Projects — всё по официальной документации и блогу.

Хочется, чтобы план составляла умная модель, а реализацию брала на себя модель побыстрее и подешевле. opusplan в Claude Code — это указание модели, которое делает это автоматически. В plan mode работает Opus, всё остальное время — Sonnet; включается он через /model opusplan или через model в settings.json. Но в списке /model его нет, а поскольку модель переключается при каждом входе в plan mode и выходе из него, при каждом переключении весь диалог читается заново без кэша. В статье по официальной документации, журналу изменений и issue на GitHub на 15 сентября 2026 года разобрано, как его настроить (включая закрепление версий и контекст 1M), как проходит работа от plan mode через одобрение к реализации, как в v2.0.0 его убрали из экрана выбора и что об этом сказал сотрудник Anthropic, сколько стоит кэш при переключении и как это сократить, чем он отличается от инструмента advisor и субагентов и для какой работы он подходит, а для какой нет.

Можно ли оставить основную сессию Claude Code на Opus 5 и отдавать субагентам на Sonnet или Haiku только такую работу, как переводы или массовые проверки? Можно. Модель субагента определяется в таком порядке: указание при вызове, model в файле определения, переменная окружения CLAUDE_CODE_SUBAGENT_MODEL и, наконец, модель основной сессии; effort тоже можно задать для каждого субагента отдельно. В статье по официальной документации на 15 сентября 2026 года разобрано, чем этот порядок отличается в разных версиях, как CLAUDE_CODE_SUBAGENT_MODEL_FORCE закрепляет одну модель за всеми субагентами, куда ведут псевдонимы у разных провайдеров и то, что встроенный Explore с v2.1.198 наследует модель основной сессии. Затем — результаты, которые я получил, запустив субагентов на других моделях и проверив логи диалогов: они работали на указанных моделях, каждый только на запуск читал десятки тысяч токенов, кэш субагентов даже по подписке живёт 5 минут, а один и тот же перевод, порученный Opus 5, Sonnet 5 и Haiku 4.5 по два раза, различался по времени, стоимости и качеству. В конце — как это сказывается на стоимости и лимитах и что учитывать, решая, какую работу отдать модели попроще.

Когда несколько сессий работают параллельно, хочется понять, какая из них съедает недельный лимит. Однако /usage в Claude Code показывает только цифры текущей сессии и расход по всему тарифу в разбивке по навыкам, субагентам, плагинам и серверам MCP, а долю каждой сессии не видно ни в кольце расхода десктопного приложения, ни на странице настроек claude.ai (по состоянию на сентябрь 2026 года). Ответ лежит в логах диалогов на вашем компьютере (файлы JSONL в ~/.claude/projects), но если сложить их как есть, результат выйдет неверным: один ответ записывается в несколько строк, по одной на каждый блок содержимого, а записи субагентов хранятся в отдельных файлах. По замерам на моём компьютере простая сумма оказалась примерно вдвое больше правильного значения, а поскольку величина ошибки в каждой сессии была своей, поменялся даже порядок мест. В статье разобрано, что официальные экраны показывают и чего не показывают, как правильно подсчитать логи скриптом примерно на 50 строк, результат замеров, в котором одна сессия взяла почти треть всего расхода, пределы того, что могут сказать эти цифры, и как настроить OpenTelemetry, если нужно следить за расходом постоянно.

Не нужно каждый раз просить «начни с вывода» или «отвечай по-русски»: достаточно один раз написать это в поле инструкций, которое автоматически действует во всех разговорах. В ChatGPT это «Пользовательские инструкции», в Claude — «Инструкции для Claude», в Gemini — «Инструкции для Gemini», но у них различаются и название в интерфейсе, и расположение, и допустимое число символов. В ChatGPT лимит составляет 1 500 символов на Free и Go и 5 000 на Plus и выше (подняли в июле 2026 года), а Claude и Gemini лимит не публикуют. В этой статье мы проверяем расположение и лимиты по официальной справке трёх компаний и на основе официального руководства Anthropic по промптам показываем, как писать работающие инструкции, с примером. А случаи, в которых, по официальной справке, инструкции не действуют (внутри проектов и Gem-ботов, во временных чатах, в корпоративных аккаунтах), собраны в чек-лист.

Вы пишете Claude по-русски, а он отвечает на английском. В официальный репозиторий раз за разом приходят одинаковые сообщения, а исследования показывают, что в условиях, когда запрос и ответ на разных языках, даже самые сильные модели не могут стабильно отвечать на заданном языке. Но причина не одна. Случаи делятся на четыре типа: ответы постепенно уходят в английский, пока Claude читает код и вывод инструментов; язык забывается сразу после компактизации, которая сводит диалог в резюме; ответ приходит не на английском, а на совсем другом языке; и тип, которого резко стало больше с конца сентября 2026 года на Opus 5.5, — на английском приходят только короткие реплики между запусками инструментов. Помогает в каждом случае своё. В статье разобрано, как различить типы, почему настройка language в Claude Code, закрепляющая указание в системном промпте, продолжает действовать и после компактизации, какой хук, по сообщениям, помог против типа 4, когда не помогала даже эта настройка, замер автора, по которому доля английских реплик посреди работы выросла примерно с 11% до примерно 50%, а также проблема, о которой начали сообщать в сентябре 2026 года, — в длинных сессиях ломается сам вывод. Подтверждённое и неподтверждённое мы разделяем.

Поставите слишком много навыков — они съедят контекст: наполовину это верно, наполовину нет. Согласно документации Claude Code, список навыков расходует фиксированный бюджет в 1% контекстного окна модели, и сколько навыков вы ни добавьте, дальше он не растёт. Вместо того чтобы раздуваться, список начинает убирать описания, начиная с самых редко вызываемых навыков, и оставляет только имена. Навык, потерявший описание, больше не связывается с тем, о чём вы просите, но при этом не появляется ни ошибки, ни замедления. В статье разобраны разные роли трёх инструментов измерения (/context, /usage и /skill-doctor), определение промаха кэша как 5% и 2000 токенов, падение времени жизни кэша с одного часа до пяти минут в зависимости от формы подписки, причина, по которой CLI по-прежнему легче MCP теперь, когда определения инструментов грузятся лениво по умолчанию, обоснование правила держать CLAUDE.md в пределах 200 строк, а также то, что урезать первым после измерения, — и всё это в пределах того, что удалось подтвердить по официальной документации.

Бывают строки, по которым поиск не находит ничего: работа с Claude встала, вы копируете текст ошибки как есть — и тишина. Пять примеров: The model returned no content because the response was blocked by content filtering, The response was blocked by the provider's content filter, Streaming response ended before any complete data was received, Could not locate the Claude CLI on PATH и Connection to Claude's response was lost. Claude may still be working. Общее у них одно: появилось при работе с Claude, но в материалах Claude этого будто бы нет. Причина простая — строку на экране написала не обязательно та программа, о которой вы думаете. Статья не разбирает каждую причину с нуля, а служит входом: определить, кто написал строку, и направить читателя к нужному разбору. Сначала место, где рождается текст ошибки, делится на четыре слоя: бэкенд поставщика модели, сам Claude Code, запускающая программа вроде расширения IDE или обёртки, сторонний клиент. Сверка показала, что две строки из пяти присутствуют пунктами в официальном справочнике ошибок Claude Code. Официальное определение Streaming response ended… — заголовки вернулись, но в теле нет сообщения Claude API, то есть речь не об обрыве на середине. Could not locate the Claude CLI on PATH официальная документация выносит в отдельную главу Wrapper and IDE errors, то есть печатает эту строку запускающая программа. Обе строки про content filter принадлежат сторонней стороне, и issue #35736 в OpenCode сообщает, что три разных сбоя — 404 Vertex, обрыв сокета и настоящий отказ — показываются одной и той же фразой про блокировку фильтром. Верна она лишь в одном случае из трёх. Официальная документация GitHub тоже прямо пишет, что при работе с Claude вход и выход проходят контентные фильтры GitHub Copilot, так что остановить мог и не фильтр Anthropic. Оставшаяся строка не нашлась ни в официальном справочнике, ни в документации Remote Control, поэтому её источник не назван, а вместо этого даны 4 шага, чтобы установить его самому. Подтверждённое и неподтверждённое разделено метками.

В Claude Code посреди ответа появляется «API Error: Connection lost mid-response. The response above may be incomplete.», и работа останавливается. Материалов по этой строке находится мало, и причина простая: название сравнительно новое. Официальный справочник ошибок прямо пишет, что до v2.1.227 Connection lost mid-response отображалось как Connection closed mid-response, а вместе с этим Response stalled mid-stream заменили на The response stopped arriving и Connection closed while thinking, before producing a response — на Connection lost before a response was produced. То есть явление прежнее, поменялись только слова. Статья отталкивается от переименования и опирается только на официальную документацию и публичные issue. Сначала разобраны официальные определения шести сообщений об обрыве (Server error, Connection lost, computer went to sleep, The response stopped arriving, Part of the response never arrived, The response stream was malformed) и причина, по которой уже выведенный текст сохраняется намеренно: повторная отправка грозит выполнить тот же вызов инструмента дважды, а процедура восстановления сводится к ответу continue. Дальше объясняется, почему повтор не идёт автоматически, через развилку Automatic retries: обрыв до того, как что-либо завершено, повторяется с экспоненциальной задержкой до десяти раз; после размышления, но до вывода — не более двух раз, после чего ход закрывается сообщением Connection lost before a response was produced; а после завершённого блока повтора нет, есть только пометка. Затем идут три слоя, на которых может рваться связь (машина и канал, маршрут с прокси и шлюзами, сторона сервиса и переиспользование соединений), перечитывание материала mTLS при ротации сертификатов начиная с v2.1.232, чек-лист из девяти шагов, умолчания четырёх сторожевых таймеров потока (first-byte 180 секунд, event 300 секунд, byte 180 секунд, body idle 5 минут) и переменные CLAUDE_CODE_MAX_RETRIES, CLAUDE_CODE_RETRY_WATCHDOG, API_TIMEOUT_MS, таблица отличий от восьми похожих сообщений и реальные отчёты, где обычный HTTPS исправен, а по ECONNRESET падает только CLI (#86473 и #85979). В конце всё разделено по достоверности: симптом и процедура восстановления задокументированы официально, официального объяснения причины нет, а упоминания о смене формулировки в CHANGELOG не найдено.

Миграция на Claude Fable 5.1 не сводится к замене идентификатора модели и отметке о выполнении. Anthropic называет три изменения ломающими, и два из них проявляются далеко от того места, где возникают. Первое падает сразу: передача type any или type tool в tool_choice возвращает 400 invalid_request_error, потому что принудительный вызов пропускает рассуждение, которое эта модель ведёт постоянно, и качество аргументов падает вместе с ним. Второе — тихое. Блоки размышления теперь хранят отметку о породившей их модели и переносятся только в одну сторону, поэтому разговор, переходящий на Fable 5.1, сохраняет рассуждения, а маршрутизатор или откат, возвращающий его на прошлое поколение, теряет этот ход целиком. По умолчанию API отбрасывает нечитаемые блоки ещё до того, как модель их увидит, а поскольку отброшенные токены не попадают ни в input_tokens, ни в счёт, в биллинге не видно ничего. Чтобы это стало заметно, нужен бета-заголовок thinking-binding-controls-2026-08-01. Третье изменение самое широкое: правка чего угодно перед блоком размышления Fable 5.1, включая промпт system, массив tools и любое более раннее сообщение, обнуляет его и все блоки после него. Применяется ли проверка принудительно, зависит от даты создания аккаунта, поэтому свежесозданный тестовый контур может падать там, где продакшен работает. В статье разобрано и то, что не стало хуже: вход остаётся по $10, выход по $50 за миллион токенов, а чтение кэша падает до $0.25, то есть 0.025x базового входа против 0.1x у всех остальных моделей Claude. Anthropic называет экономию примерно 25% на типичных нагрузках и до 45% на задачах с выраженной агентной частью. Семь особенностей поведения меняются без единой правки кода, включая сокращение параллельных вызовов инструментов, меньше рассказа о ходе работы на высоком effort и ответы по памяти на низком, а среди пяти добавлений одно — то самое удешевление чтения кэша, вынесенное в отдельную пятую главу, тогда как среди остальных четырёх есть бета-функции, существующие именно для того, чтобы заменить приёмы, которые ломающие изменения запрещают.

Remote Control соединяет мобильное приложение Claude или claude.ai/code с сессией Claude Code, которая уже работает на вашей собственной машине, и главное, что упускают почти все объяснения: в облако не переезжает ничего. Выполнение кода и доступ к файлам всё время остаются локальными, а смартфон служит лишь окном в эту сессию. Статья разбирает, что такая конструкция даёт и чего стоит. Локальная файловая система, MCP-серверы, инструменты и настройки проекта остаются доступными (набранный символ @ дополняет пути из локального проекта), диалог и прогресс субагентов синхронизируются между терминалом, браузером и телефоном, а уснувший ноутбук или оборвавшаяся связь переживаются спокойно, потому что Claude Code переподключается и доставляет накопившиеся обновления. Требования строже, чем кажется: Pro, Max, Team или Enterprise (ключи API не поддерживаются), вход в claude.ai вместо setup-token, прямое соединение с api.anthropic.com и ни одной из четырёх переменных окружения, отключающих телеметрию, из-за чего заботящиеся о приватности пользователи с DO_NOT_TRACK получают сообщение, что функция для их аккаунта не включена. Разобраны три точки входа (/remote-control для переноса текущего диалога, claude --remote-control и режим сервера с флагами --spawn, --capacity 32 и --continue), граница между слеш-командами, работающими удалённо, и локальными вроде /resume, пятиминутный срок жизни диалогов, который не распространяется на запросы разрешений, и два переключателя push-уведомлений. Раздел о безопасности написан осознанно: входящий порт не открывается никогда, поэтому сетевая поверхность атаки почти исчезает, а риск переезжает на аккаунт; QR-код является коротким путём, а не аутентификацией; воротами по умолчанию служит ровно один аккаунт, в который выполнен вход, что делает passkey самым ценным шагом. Дополняют картину сроки хранения стенограмм (5 лет или 30 дней), порядок действий при потере смартфона, Trusted Devices с окном входа в 18 часов, десятиминутный тайм-аут режима сервера, четырёхчасовое окно возврата сессий, обязательный tmux на удалённых машинах, таблица диагностики по реальным сообщениям об ошибках и сравнение с Dispatch.

То, как думает Claude, пережило смену поколений. Старое расширенное мышление требовало указывать бюджет токенов в каждом запросе — thinking: {"type": "enabled", "budget_tokens": N}, — но правильный бюджет зависит от задачи и заранее не угадывается, а его изменение инвалидирует кеш промптов. Текущее адаптивное мышление — одна строка, type: "adaptive": думать ли и насколько глубоко, модель решает сама, исходя из сложности запроса. Миграция шла поэтапно: budget_tokens объявлен устаревшим на Opus 4.6 / Sonnet 4.6, а начиная с Opus 4.7 отклоняется с ошибкой 400. В статье правила по моделям сведены в одну таблицу: Fable 5.1 и Opus 5.5 думают всегда (отключить нельзя), у Sonnet 5.5 мышление включено по умолчанию, а disabled отклоняется с ошибкой 400, но between_tools отключает только начальное мышление (effort high и ниже), у Legacy-моделей Opus 5 и Sonnet 5 мышление включено по умолчанию (на Opus 5 отключение допускается только при effort high и ниже), Opus 4.8 / 4.7 требуют явной настройки adaptive, а для моделей, поддерживающих только расширенное мышление, вроде Haiku 4.5 / Sonnet 4.5, budget_tokens остаётся единственным режимом. Управление глубиной переехало в output_config: {"effort": ...} с пятью уровнями (по умолчанию high у большинства моделей и medium у Opus 5.5 и Haiku 5.5), и смена effort сбрасывает кеш так же, как раньше смена бюджета. Видимость определяется полем display: умолчание нового поколения — "omitted" (пустые блоки мышления), при этом полный объём токенов мышления оплачивается в любом случае — измеряйте через usage.output_tokens_details.thinking_tokens; сырую цепочку рассуждений не возвращает ни одна настройка. У отключения мышления на Opus 5 есть задокументированные побочные эффекты (вызовы инструментов обычным текстом, утечка внутренних тегов), поэтому более безопасный рычаг экономии — снижение effort. Чередующееся мышление — рассуждения между вызовами инструментов — при adaptive работает автоматически, старый бета-заголовок больше не нужен. А когда нужна скорость, fast mode запускает тот же Opus примерно в 2.5 раза быстрее за двойную цену (только Opus 5.5/5/4.8, в Claude Code переключается через /fast). Всё опирается на официальную документацию Anthropic: Thinking, Extended thinking и Fast mode.