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

Когда 16 сентября 2026 года Claude Cowork влился в чат, одновременно с этим в бете появились три функции создания: Claude Docs для документов, Claude Slides для презентаций и Claude Design для визуального дизайна. Эта статья — про первую из них. Если в одном предложении, то Claude Docs превращает то, что вышло из диалога, в документ, который можно продолжать править. Попросите оформить обсуждение как спецификацию, которой можно поделиться с командой, — и Claude напишет черновик прямо у вас на глазах, а прежде чем начать, спросит обо всём, чего ему не хватает. На выходе — форматированный текст с заголовками и таблицами, причём один документ может состоять из нескольких вкладок. Править его можно самому, а можно выделить текст внутри документа, оставить комментарий и упомянуть @Claude, чтобы правку внёс он. Сильнее всего недооценивают то, что в спецификацию, runbook или отчёт можно превратить и сессию Claude Code. Это, однако, бета, и то, чего в ней нет, отсутствует совершенно откровенно: истории версий нет, удаление необратимо, с телефона документ можно попросить, но не поправить, а Team и Enterprise не могут делиться за пределы организации. В статье отсутствующему отведено столько же места, сколько возможностям, и разобрано, для чего этот инструмент подходит, а для чего нет.

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 читает код и вывод инструментов; язык забывается сразу после компактизации, которая сводит диалог в резюме; ответ приходит не на английском, а на совсем другом языке. Помогает в каждом случае своё. В статье разобрано, как различить типы, почему настройка language в Claude Code, закрепляющая указание в системном промпте, продолжает действовать и после компактизации, а также проблема, о которой начали сообщать в сентябре 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) и причина, по которой уже выведенный текст сохраняется намеренно: повторная отправка грозит выполнить тот же вызов инструмента дважды, а процедура восстановления сводится к ответу 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.