Documentation 2026-09-12 03:02 UTC to 2026-09-13 21:00 UTC

126 126 

127Стиль вывода — это файл markdown с [frontmatter](/docs/ru/output-styles#frontmatter) для метаданных, за которым следует содержимое подсказки. Сохраните его в `~/.claude/output-styles/` для стиля на уровне пользователя, доступного в каждом проекте, или `.claude/output-styles/` в вашем репозитории для стиля на уровне проекта, который вы можете зафиксировать и поделиться с вашей командой.127Стиль вывода — это файл markdown с [frontmatter](/docs/ru/output-styles#frontmatter) для метаданных, за которым следует содержимое подсказки. Сохраните его в `~/.claude/output-styles/` для стиля на уровне пользователя, доступного в каждом проекте, или `.claude/output-styles/` в вашем репозитории для стиля на уровне проекта, который вы можете зафиксировать и поделиться с вашей командой.

128 128 

129Пользовательский стиль вывода оставляет инструкции по разработке программного обеспечения предустановки `claude_code` и использует ваши собственные. Чтобы сохранить их и наложить ваши инструкции сверху, установите `keep-coding-instructions: true` в frontmatter. Эти инструкции находятся только в полной системной подсказке Claude Code, поэтому параметр не имеет эффекта в сеансе на более короткой системной подсказке, которую вы включаете или отключаете с помощью [`CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT`](/docs/ru/env-vars#variables). Сохраняйте их, когда ваш агент всё ещё выполняет работу по разработке программного обеспечения. Оставляйте их, когда вы полностью заменяете роль.129Пользовательский стиль вывода опускает инструкции по разработке программного обеспечения предустановки `claude_code` и использует ваши собственные. Чтобы сохранить их и наложить ваши инструкции сверху, установите `keep-coding-instructions: true` в frontmatter. Эти инструкции находятся только в полной системной подсказке Claude Code, поэтому параметр не имеет эффекта в сеансе на более короткой системной подсказке, которую вы включаете или отключаете с помощью [`CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT`](/docs/ru/env-vars#variables). Сохраняйте их, когда ваш агент всё ещё выполняет работу по разработке программного обеспечения. Опускайте их, когда вы полностью заменяете роль.

130 130 

131Пример ниже определяет персону рецензента кода, которая сохраняет инструкции кодирования, поскольку проверка кода всё ещё выигрывает от руководства Claude Code по безопасности и качеству кода. Сохраните его как `~/.claude/output-styles/code-reviewer.md`, чтобы сделать его доступным во всех проектах:131Пример ниже определяет персону рецензента кода, которая сохраняет инструкции кодирования, поскольку проверка кода всё ещё выигрывает от руководства Claude Code по безопасности и качеству кода. Сохраните его как `~/.claude/output-styles/code-reviewer.md`, чтобы сделать его доступным во всех проектах:

132 132 

385 385 

386* SDK объединяет строки с каждой стороны маркера с пустой строкой между ними и удаляет сам маркер, поэтому текст маркера не достигает Claude.386* SDK объединяет строки с каждой стороны маркера с пустой строкой между ними и удаляет сам маркер, поэтому текст маркера не достигает Claude.

387* Если вы включите маркер более одного раза, первый — это разделение и SDK удаляет остальные.387* Если вы включите маркер более одного раза, первый — это разделение и SDK удаляет остальные.

388* Если вы оставите маркер, SDK объединяет все строки в один блок, то же самое, что передача одной строки.388* Если вы опустите маркер, SDK объединяет все строки в один блок, то же самое, что передача одной строки.

389 389 

390<h3 id="change-the-prompt-of-an-existing-session">390<h3 id="change-the-prompt-of-an-existing-session">

391 Изменение подсказки существующего сеанса391 Изменение подсказки существующего сеанса

124| `--remote-control-session-name-prefix <prefix>` | Префикс для автоматически генерируемых имён сеансов [Remote Control](/docs/ru/remote-control) при отсутствии явного имени. По умолчанию используется имя хоста вашей машины, создавая имена вроде `myhost-graceful-unicorn`. Установите `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` для того же эффекта | `claude remote-control --remote-control-session-name-prefix dev-box` |124| `--remote-control-session-name-prefix <prefix>` | Префикс для автоматически генерируемых имён сеансов [Remote Control](/docs/ru/remote-control) при отсутствии явного имени. По умолчанию используется имя хоста вашей машины, создавая имена вроде `myhost-graceful-unicorn`. Установите `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` для того же эффекта | `claude remote-control --remote-control-session-name-prefix dev-box` |

125| `--replay-user-messages` | Повторно отправить пользовательские сообщения из stdin обратно на stdout для подтверждения. Требует `--input-format stream-json` и `--output-format stream-json` | `claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages` |125| `--replay-user-messages` | Повторно отправить пользовательские сообщения из stdin обратно на stdout для подтверждения. Требует `--input-format stream-json` и `--output-format stream-json` | `claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages` |

126| `--restricted` | Запустить в ограниченном режиме. Используйте его, когда оценочный каркас управляет `claude` на общей машине и Claude Code не должен запускать команды или читать параметры пользователя и проекта этой машины. Claude Code удаляет встроенные инструменты, которые запускают команды или код, и WebFetch, если вы не назовёте их индивидуально в `--tools`, не через предустановку `default`. Он также ограничивает встроенные инструменты файлов [рабочими каталогами](/docs/ru/permissions#working-directories), загружает только [управляемые параметры](/docs/ru/managed-settings) и `--settings`, отказывает [`bypassPermissions`](/docs/ru/permission-modes#skip-all-checks-with-bypasspermissions-mode) и [отказывает создавать облачные сеансы](/docs/ru/errors#cloud-sessions-cannot-be-created-from-a-restricted-session). Требует Claude Code v2.1.248 или позже | `claude --restricted -p "query"` |126| `--restricted` | Запустить в ограниченном режиме. Используйте его, когда оценочный каркас управляет `claude` на общей машине и Claude Code не должен запускать команды или читать параметры пользователя и проекта этой машины. Claude Code удаляет встроенные инструменты, которые запускают команды или код, и WebFetch, если вы не назовёте их индивидуально в `--tools`, не через предустановку `default`. Он также ограничивает встроенные инструменты файлов [рабочими каталогами](/docs/ru/permissions#working-directories), загружает только [управляемые параметры](/docs/ru/managed-settings) и `--settings`, отказывает [`bypassPermissions`](/docs/ru/permission-modes#skip-all-checks-with-bypasspermissions-mode) и [отказывает создавать облачные сеансы](/docs/ru/errors#cloud-sessions-cannot-be-created-from-a-restricted-session). Требует Claude Code v2.1.248 или позже | `claude --restricted -p "query"` |

127| `--resume`, `-r` | Возобновить конкретный сеанс по ID или имени, или показать интерактивный выбор для выбора сеанса. Вместо ID вы можете передать абсолютный путь к файлу транскрипта `.jsonl` сеанса]\(/ru/sessions#where-transcripts-are-stored). Выбор и поиск по имени включают сеансы, которые добавили этот каталог с `/add-dir`. Когда вы передаёте ID сеанса, Claude Code ищет текущий каталог проекта и его git worktrees, затем каждый другой проект на этой машине. До v2.1.223 поиск ID охватывал только текущий каталог проекта и его git worktrees. [Фоновые сеансы](/docs/ru/agent-view) появляются в выборе, отмеченные с `bg` | `claude --resume auth-refactor` |127| `--resume`, `-r` | Возобновить конкретный сеанс по ID или имени, или показать интерактивный выбор для выбора сеанса. Вместо ID вы можете передать абсолютный путь к [файлу транскрипта `.jsonl` сеанса](/docs/ru/sessions#where-transcripts-are-stored). Выбор и поиск по имени включают сеансы, которые добавили этот каталог с `/add-dir`. Когда вы передаёте ID сеанса, Claude Code ищет текущий каталог проекта и его git worktrees, затем каждый другой проект на этой машине. До v2.1.223 поиск ID охватывал только текущий каталог проекта и его git worktrees. [Фоновые сеансы](/docs/ru/agent-view) появляются в выборе, отмеченные с `bg` | `claude --resume auth-refactor` |

128| `--safe-mode` | Запустить со всеми отключенными настройками для устранения неполадок в нарушенной конфигурации: CLAUDE.md, skills, plugins, hooks, MCP серверы, пользовательские команды и агенты, стили вывода, рабочие процессы, пользовательские темы, пользовательские сочетания клавиш, строка состояния и команды предложения файлов, LSP серверы и автоматическая память не загружаются. Аутентификация, выбор модели, встроенные инструменты и разрешения работают нормально, что отличается от [`--bare`](/docs/ru/headless#start-faster-with-bare-mode). Политика управляемых параметров всё ещё применяется, включая настроенные политикой hooks, строку состояния и команды предложения файлов; управляемые plugins, управляемые skills, управляемый CLAUDE.md и настроенные политикой MCP серверы не загружаются. Полезно для проверки того, является ли настройка причиной [автоматического переключения модели](/docs/ru/model-config#automatic-model-fallback). Устанавливает [`CLAUDE_CODE_SAFE_MODE`](/docs/ru/env-vars) | `claude --safe-mode` |128| `--safe-mode` | Запустить со всеми отключенными настройками для устранения неполадок в нарушенной конфигурации: CLAUDE.md, skills, plugins, hooks, MCP серверы, пользовательские команды и агенты, стили вывода, рабочие процессы, пользовательские темы, пользовательские сочетания клавиш, строка состояния и команды предложения файлов, LSP серверы и автоматическая память не загружаются. Аутентификация, выбор модели, встроенные инструменты и разрешения работают нормально, что отличается от [`--bare`](/docs/ru/headless#start-faster-with-bare-mode). Политика управляемых параметров всё ещё применяется, включая настроенные политикой hooks, строку состояния и команды предложения файлов; управляемые plugins, управляемые skills, управляемый CLAUDE.md и настроенные политикой MCP серверы не загружаются. Полезно для проверки того, является ли настройка причиной [автоматического переключения модели](/docs/ru/model-config#automatic-model-fallback). Устанавливает [`CLAUDE_CODE_SAFE_MODE`](/docs/ru/env-vars) | `claude --safe-mode` |

129| `--session-id` | Использовать конкретный ID сеанса для беседы (должен быть действительным UUID) | `claude --session-id "550e8400-e29b-41d4-a716-446655440000"` |129| `--session-id` | Использовать конкретный ID сеанса для беседы (должен быть действительным UUID) | `claude --session-id "550e8400-e29b-41d4-a716-446655440000"` |

130| `--setting-sources` | Разделённый запятыми список источников параметров для загрузки (`user`, `project`, `local`) | `claude --setting-sources user,project` |130| `--setting-sources` | Разделённый запятыми список источников параметров для загрузки (`user`, `project`, `local`) | `claude --setting-sources user,project` |

136| `--teleport` | Возобновить [веб-сеанс](/docs/ru/claude-code-on-the-web) в вашем локальном терминале | `claude --teleport` |136| `--teleport` | Возобновить [веб-сеанс](/docs/ru/claude-code-on-the-web) в вашем локальном терминале | `claude --teleport` |

137| `--teammate-mode` | Установить способ отображения товарищей по [команде агентов](/docs/ru/agent-teams): `in-process` (по умолчанию), `auto`, `tmux` или `iterm2` (добавлено в v2.1.186). Переопределяет параметр [`teammateMode`](/docs/ru/settings-reference#teammatemode) для этого сеанса. См. [Выбор режима отображения](/docs/ru/agent-teams#choose-a-display-mode) | `claude --teammate-mode auto` |137| `--teammate-mode` | Установить способ отображения товарищей по [команде агентов](/docs/ru/agent-teams): `in-process` (по умолчанию), `auto`, `tmux` или `iterm2` (добавлено в v2.1.186). Переопределяет параметр [`teammateMode`](/docs/ru/settings-reference#teammatemode) для этого сеанса. См. [Выбор режима отображения](/docs/ru/agent-teams#choose-a-display-mode) | `claude --teammate-mode auto` |

138| `--tmux` | Создать сеанс tmux для worktree. Требует `--worktree`. Использует встроенные панели iTerm2, если доступны; передайте `--tmux=classic` для традиционного tmux | `claude -w feature-auth --tmux` |138| `--tmux` | Создать сеанс tmux для worktree. Требует `--worktree`. Использует встроенные панели iTerm2, если доступны; передайте `--tmux=classic` для традиционного tmux | `claude -w feature-auth --tmux` |

139| `--tools` | Ограничить, какие встроенные инструменты может использовать Claude. Используйте `""` для отключения всех, `"default"` для всех или имена инструментов, такие как `"Bash,Edit,Read"`. На macOS, Linux и WSL набор по умолчанию исключает `Glob` и `Grep`, как описано в разделе [Поведение инструмента Glob](/docs/ru/tools-reference#glob-tool-behavior). Если вы назовёте один из [инструментов отслеживания задач](/docs/ru/tools-reference#task-tool-availability) здесь, Claude Code также включает сеанс. Флаг не влияет на MCP инструменты; чтобы отрицать и их, используйте `--disallowedTools "mcp__*"`. Список, который опускает [`EndConversation`](/docs/ru/tools-reference#endconversation-tool-behavior), не удаляет его; `""` удаляет его только, когда не остаётся MCP инструментов | `claude --tools "Bash,Edit,Read"` |139| `--tools` | Ограничить, какие встроенные инструменты может использовать Claude. Используйте `""` для отключения всех, `"default"` для набора по умолчанию или имена инструментов, такие как `"Bash,Edit,Read"`. На macOS, Linux и WSL набор по умолчанию исключает `Glob` и `Grep`, как описано в разделе [Поведение инструмента Glob](/docs/ru/tools-reference#glob-tool-behavior). Если вы назовёте один из [инструментов отслеживания задач](/docs/ru/tools-reference#task-tool-availability) здесь, Claude Code также включает сеанс. Флаг не влияет на MCP инструменты; чтобы запретить и их, используйте `--disallowedTools "mcp__*"`. Список, который опускает [`EndConversation`](/docs/ru/tools-reference#endconversation-tool-behavior), не удаляет его; `""` удаляет его только, когда не остаётся MCP инструментов | `claude --tools "Bash,Edit,Read"` |

140| `--verbose` | Включить подробное логирование, показывает полный вывод по ходам. Переопределяет параметр [`viewMode`](/docs/ru/settings-reference#viewmode) для этого сеанса | `claude --verbose` |140| `--verbose` | Включить подробное логирование, показывает полный вывод по ходам. Переопределяет параметр [`viewMode`](/docs/ru/settings-reference#viewmode) для этого сеанса | `claude --verbose` |

141| `--version`, `-v` | Вывести номер версии | `claude -v` |141| `--version`, `-v` | Вывести номер версии | `claude -v` |

142| `--worktree`, `-w` | Запустить Claude в изолированном [git worktree](/docs/ru/worktrees) в `<repo>/.claude/worktrees/<name>`. Если имя не указано, Claude Code генерирует одно. Передайте `#<number>`, URL GitHub pull request или URL GitLab merge request для [получения этого PR или MR из `origin` и ветвления worktree из него](/docs/ru/worktrees#branch-from-a-pull-request). Ветвление из GitLab merge request требует Claude Code v2.1.233 или позже | `claude -w feature-auth` |142| `--worktree`, `-w` | Запустить Claude в изолированном [git worktree](/docs/ru/worktrees) в `<repo>/.claude/worktrees/<name>`. Если имя не указано, Claude Code генерирует одно. Передайте `#<number>`, URL GitHub pull request или URL GitLab merge request для [получения этого PR или MR из `origin` и ветвления worktree из него](/docs/ru/worktrees#branch-from-a-pull-request). Ветвление из GitLab merge request требует Claude Code v2.1.233 или позже | `claude -w feature-auth` |

126[Входящие элементы управления](#control-inbound-messages) каждой стороны применяются к уведомлению как к сообщению:126[Входящие элементы управления](#control-inbound-messages) каждой стороны применяются к уведомлению как к сообщению:

127 127 

128* **`refuse` на любой стороне**: ничего не прибывает. Наблюдаемый сеанс отбрасывает запрос без записи или ответа на него, поэтому подписка истекает без ответа через 12 часов, и запрашивающий сеанс с `refuse` никогда не подписывается.128* **`refuse` на любой стороне**: ничего не прибывает. Наблюдаемый сеанс отбрасывает запрос без записи или ответа на него, поэтому подписка истекает без ответа через 12 часов, и запрашивающий сеанс с `refuse` никогда не подписывается.

129* **`hold` на любой стороне**: уведомление прибывает с меньшим. Наблюдаемый сеанс оставляет однострочный статус, и запрашивающий сеанс показывает уведомление в вашей расшифровке без доставки его Claude.129* **`hold` на любой стороне**: уведомление прибывает с меньшим. Наблюдаемый сеанс опускает однострочный статус, и запрашивающий сеанс показывает уведомление в вашей расшифровке без доставки его Claude.

130 130 

131Только Claude в вашем основном разговоре может подписаться, и только на ваши сеансы на этом компьютере. Когда подагент или товарищ команды агентов устанавливает `notify_when_idle`, Claude Code не делает подписку и сообщает ему об этом. Когда Claude просит уведомление от любого другого агента, такого как товарищ, подагент или сеанс за пределами этого компьютера, Claude Code отказывает весь вызов, включая любое прикрепленное сообщение, и сообщает об отказе Claude, чтобы оно могло отправить сообщение без запроса.131Только Claude в вашем основном разговоре может подписаться, и только на ваши сеансы на этом компьютере. Когда подагент или товарищ команды агентов устанавливает `notify_when_idle`, Claude Code не делает подписку и сообщает ему об этом. Когда Claude просит уведомление от любого другого агента, такого как товарищ, подагент или сеанс за пределами этого компьютера, Claude Code отказывает весь вызов, включая любое прикрепленное сообщение, и сообщает об отказе Claude, чтобы оно могло отправить сообщение без запроса.

132 132 

146 146 

147Пока этот сеанс подключен к [Удаленному управлению](/docs/ru/remote-control), Claude Code скрывает некоторые детали ваших локальных сеансов из вывода `/list-agents`, без изменения того, что Claude видит, когда ищет сеанс для отправки сообщения:147Пока этот сеанс подключен к [Удаленному управлению](/docs/ru/remote-control), Claude Code скрывает некоторые детали ваших локальных сеансов из вывода `/list-agents`, без изменения того, что Claude видит, когда ищет сеанс для отправки сообщения:

148 148 

149* **Рабочие каталоги**: он оставляет рабочий каталог каждого локального сеанса.149* **Рабочие каталоги**: он опускает рабочий каталог каждого локального сеанса.

150* **Имена сеансов**: он оставляет любое имя сеанса, которое не может приписать человеку, поэтому строка, оставленная без имени, читается как `(unnamed session)`.150* **Имена сеансов**: он опускает любое имя сеанса, которое не может приписать человеку, поэтому строка, оставленная без имени, читается как `(unnamed session)`.

151* **Первая строка**: он оставляет строку с именем этого сеанса, если вы не вводили это имя на этом терминале, с `--name` или с `/rename` и имя, с момента запуска или последнего возобновления сеанса.151* **Первая строка**: он опускает строку с именем этого сеанса, если вы не вводили это имя на этом терминале, с `--name` или с `/rename` и имя, с момента запуска или последнего возобновления сеанса.

152 152 

153Когда вывод что-то перечисляет, он заканчивается примечанием, говорящим, что детали были скрыты. Запуск `/rename` с последующим неиспользованным именем на клавиатуре сеанса дает этому сеансу имя, которое появляется в выводе.153Когда вывод что-то перечисляет, он заканчивается примечанием, говорящим, что детали были скрыты. Запуск `/rename` с последующим неиспользованным именем на клавиатуре сеанса дает этому сеансу имя, которое появляется в выводе.

154 154 

359 359 

360Используйте помощника, когда учетные данные истекают по расписанию, поступают из хранилища или команды SSO, или администратор сказал вам настроить один. Если ваши учетные данные — это фиксированная строка, которую вы устанавливаете один раз, [переменная учетных данных](#set-the-credential-variable) — это все, что вам нужно, и вы можете пропустить этот раздел.360Используйте помощника, когда учетные данные истекают по расписанию, поступают из хранилища или команды SSO, или администратор сказал вам настроить один. Если ваши учетные данные — это фиксированная строка, которую вы устанавливаете один раз, [переменная учетных данных](#set-the-credential-variable) — это все, что вам нужно, и вы можете пропустить этот раздел.

361 361 

362Помощник — это любая команда оболочки, которая выводит текущие учетные данные на stdout. Claude Code запускает ее через вашу системную оболочку, поэтому на Windows это может быть исполняемый файл или вызов PowerShell. Напишите скрипт, сделайте его исполняемым и ссылайтесь на него из `apiKeyHelper` в вашем [файле параметров](/docs/ru/settings). На Claude Code v2.1.227 или позже баннер или строка журнала, выведенные вместе с ключом, приводят к [отказу помощника](/docs/ru/errors#your-apikeyhelper-script-is-failing). Напишите скрипт, сделайте его исполняемым и ссылайтесь на него из `apiKeyHelper` в вашем [файле параметров](/docs/ru/settings):362Помощник — это любая команда оболочки, которая выводит текущие учетные данные на stdout. Claude Code запускает ее через вашу системную оболочку, поэтому на Windows это может быть исполняемый файл или вызов PowerShell. Сделайте так, чтобы команда не выводила ничего, кроме учетных данных. На Claude Code v2.1.227 или позже баннер или строка журнала, выведенные вместе с ключом, приводят к [отказу помощника](/docs/ru/errors#your-apikeyhelper-script-is-failing). Напишите скрипт, сделайте его исполняемым и ссылайтесь на него из `apiKeyHelper` в вашем [файле параметров](/docs/ru/settings):

363 363 

364<Tabs>364<Tabs>

365 <Tab title="Bash или Zsh">365 <Tab title="Bash или Zsh">

431* Она отключает автоматические обновления, поэтому планируйте другой путь обновления, такой как ваш менеджер пакетов или управляемое распределение.431* Она отключает автоматические обновления, поэтому планируйте другой путь обновления, такой как ваш менеджер пакетов или управляемое распределение.

432* Она подавляет проверку доступности [быстрого режима](/docs/ru/fast-mode). Если предыдущая проверка уже не включила быстрый режим на машине, `/fast` сообщает, что быстрый режим недоступен.432* Она подавляет проверку доступности [быстрого режима](/docs/ru/fast-mode). Если предыдущая проверка уже не включила быстрый режим на машине, `/fast` сообщает, что быстрый режим недоступен.

433* Она не влияет на [обнаружение модели шлюза](#add-gateway-models-to-the-model-picker), которое запрашивает только ваш шлюз. До v2.1.257 переменная также останавливала обновление обнаружения, поэтому средство выбора сохраняло ранее кэшированный список.433* Она не влияет на [обнаружение модели шлюза](#add-gateway-models-to-the-model-picker), которое запрашивает только ваш шлюз. До v2.1.257 переменная также останавливала обновление обнаружения, поэтому средство выбора сохраняло ранее кэшированный список.

434* Проверка безопасности домена инструмента WebFetch не затрагивается и по-прежнему вызывает `api.anthropic.com`. Отключите ее отдельно с помощью `skipWebFetchPreflight: true` в [параметрах](/docs/ru/settings), если ваша сеть блокирует этот хост.434* [Проверка безопасности домена](/docs/ru/data-usage#webfetch-domain-safety-check) инструмента WebFetch не затрагивается и по-прежнему вызывает `api.anthropic.com`. Отключите ее отдельно с помощью `skipWebFetchPreflight: true` в [параметрах](/docs/ru/settings), если ваша сеть блокирует этот хост.

435* Для каждого потока телеметрии и переменной, которая его контролирует, см. [сервисы телеметрии](/docs/ru/data-usage#telemetry-services).435* Для каждого потока телеметрии и переменной, которая его контролирует, см. [сервисы телеметрии](/docs/ru/data-usage#telemetry-services).

436 436 

437<h3 id="route-to-a-cloud-provider-through-a-gateway">437<h3 id="route-to-a-cloud-provider-through-a-gateway">

152| Функция | Заголовок и связь тела | Симптом при нарушении | Исправление |152| Функция | Заголовок и связь тела | Симптом при нарушении | Исправление |

153| :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------- |153| :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------- |

154| [Адаптивное рассуждение](/docs/ru/model-config#adjust-effort-level) | Нет бета-заголовка. Claude Code отправляет `thinking: {"type": "adaptive"}` для Claude 4.6 и позже и рассматривает имена моделей, которые он не распознает, такие как псевдонимы gateway, как текущие модели, которые получают поле | `400` с указанием поля `thinking` или тега `adaptive`, когда сборка модели upstream его не принимает | Обновите upstream. На Opus 4.6 и Sonnet 4.6 разработчики могут вместо этого установить `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` |154| [Адаптивное рассуждение](/docs/ru/model-config#adjust-effort-level) | Нет бета-заголовка. Claude Code отправляет `thinking: {"type": "adaptive"}` для Claude 4.6 и позже и рассматривает имена моделей, которые он не распознает, такие как псевдонимы gateway, как текущие модели, которые получают поле | `400` с указанием поля `thinking` или тега `adaptive`, когда сборка модели upstream его не принимает | Обновите upstream. На Opus 4.6 и Sonnet 4.6 разработчики могут вместо этого установить `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` |

155| [Управление контекстом](https://platform.claude.com/docs/en/build-with-claude/context-management) | Бета-заголовок управления контекстом связан с полем тела `context_management` | `400` с `Extra inputs are not permitted`. Часто встречается, когда gateway принимает запросы формата Anthropic, но пересылает их на Amazon Bedrock | Пересылайте оба или [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/docs/ru/env-vars) |155| [Управление контекстом](https://platform.claude.com/docs/en/build-with-claude/context-editing) | Бета-заголовок управления контекстом связан с полем тела `context_management` | `400` с `Extra inputs are not permitted`. Часто встречается, когда gateway принимает запросы формата Anthropic, но пересылает их на Amazon Bedrock | Пересылайте оба или [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/docs/ru/env-vars) |

156| [Расширенный контекст](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) и [чередующееся мышление](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) | Только бета-заголовки, нет поля тела | Молча недоступно, когда заголовок удален; upstream никогда не видит запрос возможности | Пересылайте `anthropic-beta` дословно |156| [Расширенный контекст](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) и [чередующееся мышление](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) | Только бета-заголовки, нет поля тела | Молча недоступно, когда заголовок удален; upstream никогда не видит запрос возможности | Пересылайте `anthropic-beta` дословно |

157| Бета [поля инструментов](https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview) | Бета-заголовки, связанные с инструментами, связаны с полями схемы инструментов, такими как `strict` и `defer_loading` | `400` с указанием неузнанного поля схемы инструмента, когда тело проходит без его заголовка | Пересылайте оба или [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) |157| Бета [поля инструментов](https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview) | Бета-заголовки, связанные с инструментами, связаны с полями схемы инструментов, такими как `strict` и `defer_loading` | `400` с указанием неузнанного поля схемы инструмента, когда тело проходит без его заголовка | Пересылайте оба или [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) |

158| [Усилие](https://platform.claude.com/docs/en/build-with-claude/effort) и [структурированные выходы](https://platform.claude.com/docs/en/build-with-claude/structured-outputs) | Поле тела `output_config` содержит усилие, формат структурированного вывода и параметры бюджета задачи; каждое связано с собственным бета-заголовком | `400` с указанием `output_config`, часто `Extra inputs are not permitted`, на upstream-ах Amazon Bedrock и Google Cloud's Agent Platform | Пересылайте поле и его заголовки вместе |158| [Усилие](https://platform.claude.com/docs/en/build-with-claude/effort) и [структурированные выходы](https://platform.claude.com/docs/en/build-with-claude/structured-outputs) | Поле тела `output_config` содержит усилие, формат структурированного вывода и параметры бюджета задачи; каждое связано с собственным бета-заголовком | `400` с указанием `output_config`, часто `Extra inputs are not permitted`, на upstream-ах Amazon Bedrock и Google Cloud's Agent Platform | Пересылайте поле и его заголовки вместе |

499* Плагины определяют MCP servers в `.mcp.json` в корне плагина или встроенные в `plugin.json`499* Плагины определяют MCP servers в `.mcp.json` в корне плагина или встроенные в `plugin.json`

500* Когда вы включаете плагин, Claude Code автоматически запускает его MCP servers500* Когда вы включаете плагин, Claude Code автоматически запускает его MCP servers

501* Claude Code предлагает plugin MCP tools рядом с вручную настроенными MCP tools501* Claude Code предлагает plugin MCP tools рядом с вручную настроенными MCP tools

502* Вы добавляете и удаляете plugin servers путем установки или удаления плагина, а не с помощью команд `/mcp`. Вы все еще можете [переключить установленный plugin server](/docs/ru/plugins#disable-a-server-without-removing-it) в `/mcp`, что останавливает Claude Code от подключения к нему без удаления плагина502* Вы добавляете и удаляете plugin servers путем установки или удаления плагина, а не с помощью команд `/mcp`. Вы все еще можете [отключить установленный plugin server](#disable-a-server-without-removing-it) в `/mcp`, что останавливает Claude Code от подключения к нему без удаления плагина

503 503 

504**Пример конфигурации plugin MCP**:504**Пример конфигурации plugin MCP**:

505 505 

16 16 

17Каждый режим делает различный компромисс между удобством и контролем. В таблице ниже показано, что Claude может делать без запроса разрешения в каждом режиме. Manual режим отображается под его значением конфигурации, `default`.17Каждый режим делает различный компромисс между удобством и контролем. В таблице ниже показано, что Claude может делать без запроса разрешения в каждом режиме. Manual режим отображается под его значением конфигурации, `default`.

18 18 

19| Mode | What runs without asking | Best for |19| Режим | Что выполняется без запроса | Лучше всего для |

20| :------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------- | :---------------------------------------------- |20| :------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------- |

21| `default` | Reads only | Reviewing every action yourself, sensitive work |21| `default` | Только чтение | Проверка каждого действия самостоятельно, чувствительная работа |

22| [`acceptEdits`](#auto-approve-file-edits-with-acceptedits-mode) | Reads, file edits, and common filesystem commands (`mkdir`, `touch`, `mv`, `cp`, etc.) | Iterating on code you're reviewing |22| [`acceptEdits`](#auto-approve-file-edits-with-acceptedits-mode) | Чтение, редактирование файлов и распространённые команды файловой системы (`mkdir`, `touch`, `mv`, `cp` и т.д.) | Итерация по коду, который вы проверяете |

23| [`plan`](#analyze-before-you-edit-with-plan-mode) | Reads, plus classifier-approved commands when [auto mode](#eliminate-prompts-with-auto-mode) is available | Exploring a codebase before changing it |23| [`plan`](#analyze-before-you-edit-with-plan-mode) | Чтение, плюс одобренные классификатором команды, когда [режим auto](#eliminate-prompts-with-auto-mode) доступен | Изучение кодовой базы перед её изменением |

24| [`auto`](#eliminate-prompts-with-auto-mode) | Everything, with background safety checks | Long tasks, reducing prompt fatigue |24| [`auto`](#eliminate-prompts-with-auto-mode) | Всё, с фоновыми проверками безопасности | Длительные задачи, снижение усталости от запросов |

25| [`dontAsk`](#allow-only-pre-approved-tools-with-dontask-mode) | Reads and pre-approved tools; anything that would prompt is denied | Locked-down CI and scripts |25| [`dontAsk`](#allow-only-pre-approved-tools-with-dontask-mode) | Чтение и предварительно одобренные инструменты; всё, что вызвало бы запрос, отклоняется | Заблокированные CI и скрипты |

26| [`bypassPermissions`](#skip-all-checks-with-bypasspermissions-mode) | Everything | Isolated containers and VMs only |26| [`bypassPermissions`](#skip-all-checks-with-bypasspermissions-mode) | Всё | Только изолированные контейнеры и виртуальные машины |

27 27 

28Режим, который проверяет каждое действие, называется **Manual** в CLI, в `claude --help`, в расширениях VS Code и JetBrains, а также в настольном приложении. Его значение конфигурации — `default`, которое используют hooks и интеграции SDK. CLI принимает `manual` как псевдоним везде, где вы вводите значение, например `claude --permission-mode manual` или `"defaultMode": "manual"`. Метка Manual и псевдоним `manual` требуют Claude Code v2.1.200 или более поздней версии. Метка настольного приложения не зависит от вашей версии CLI.28Режим, который проверяет каждое действие, называется **Manual** в CLI, в `claude --help`, в расширениях VS Code и JetBrains, а также в настольном приложении. Его значение конфигурации — `default`, которое используют hooks и интеграции SDK. CLI принимает `manual` как псевдоним везде, где вы вводите значение, например `claude --permission-mode manual` или `"defaultMode": "manual"`. Метка Manual и псевдоним `manual` требуют Claude Code v2.1.200 или более поздней версии. Метка настольного приложения не зависит от вашей версии CLI.

29 29 

32Режимы устанавливают базовый уровень. Наложите [правила разрешений](/docs/ru/permissions#manage-permissions) сверху, чтобы предварительно одобрить или заблокировать определённые инструменты. Правила отказа блокируют в каждом режиме, включая `bypassPermissions`. Правила отказа и запроса не применяются к [`EndConversation`](/docs/ru/tools-reference#endconversation-tool-behavior), пока Claude всё ещё имеет хотя бы один другой инструмент, который он может вызвать. Правила разрешения не имеют эффекта в `bypassPermissions`.32Режимы устанавливают базовый уровень. Наложите [правила разрешений](/docs/ru/permissions#manage-permissions) сверху, чтобы предварительно одобрить или заблокировать определённые инструменты. Правила отказа блокируют в каждом режиме, включая `bypassPermissions`. Правила отказа и запроса не применяются к [`EndConversation`](/docs/ru/tools-reference#endconversation-tool-behavior), пока Claude всё ещё имеет хотя бы один другой инструмент, который он может вызвать. Правила разрешения не имеют эффекта в `bypassPermissions`.

33 33 

34<h3 id="actions-no-mode-auto-approves">34<h3 id="actions-no-mode-auto-approves">

35 Actions no mode auto-approves35 Действия, которые ни один режим не одобряет автоматически

36</h3>36</h3>

37 37 

38Claude Code не одобряет автоматически следующее ни в одном режиме, включая `bypassPermissions`. Каждый пункт ссылается на раздел, который говорит, что происходит вместо этого в каждом режиме:38Claude Code не одобряет автоматически следующее ни в одном режиме, включая `bypassPermissions`. Каждый пункт ссылается на раздел, который говорит, что происходит вместо этого в каждом режиме:

15Выберите платформу в зависимости от того, как вы предпочитаете работать и где находится ваш проект.15Выберите платформу в зависимости от того, как вы предпочитаете работать и где находится ваш проект.

16 16 

17| Платформа | Лучше всего для | Что вы получаете |17| Платформа | Лучше всего для | Что вы получаете |

18| :-------------------------------- | :-------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |18| :-------------------------------- | :----------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

19| [CLI](/docs/ru/quickstart) | Рабочие процессы терминала, скриптинг, удалённые серверы | Полный набор функций, [Agent SDK](/docs/ru/headless), [использование компьютера](/docs/ru/computer-use) на macOS (Pro и Max), сторонние поставщики |19| [CLI](/docs/ru/quickstart) | Рабочие процессы терминала, скриптинг, удалённые серверы | Полный набор функций, [Agent SDK](/docs/ru/headless), [использование компьютера](/docs/ru/computer-use) на macOS (Pro и Max), сторонние поставщики |

20| [Desktop](/docs/ru/desktop) | Визуальный просмотр, параллельные сеансы, управляемая установка | Средство просмотра различий, предпросмотр приложения, [использование компьютера](/docs/ru/desktop#let-claude-use-your-computer) и [Dispatch](/docs/ru/desktop#sessions-from-dispatch) на Pro и Max |20| [Desktop](/docs/ru/desktop) | Визуальный просмотр, параллельные сеансы, управляемая установка | Средство просмотра различий, предпросмотр приложения, [использование компьютера](/docs/ru/desktop#let-claude-use-your-computer) и [Dispatch](/docs/ru/desktop#sessions-from-dispatch) на Pro и Max |

21| [VS Code](/docs/ru/vs-code) | Работа внутри VS Code без переключения на терминал | Встроенные различия, интегрированный терминал, контекст файла |21| [VS Code](/docs/ru/vs-code) | Работа внутри VS Code без переключения на терминал | Встроенные различия, интегрированный терминал, контекст файла |

22| [JetBrains](/docs/ru/jetbrains) | Работа внутри IntelliJ, PyCharm, WebStorm или других IDE JetBrains | Средство просмотра различий, совместное использование выделения, сеанс терминала |22| [JetBrains](/docs/ru/jetbrains) | Работа внутри IntelliJ, PyCharm, WebStorm или других IDE JetBrains | Средство просмотра различий, совместное использование выделения, сеанс терминала |

23| [Web](/docs/ru/claude-code-on-the-web) | Долгосрочные задачи, которые не требуют большого управления, или работа, которая должна продолжаться, когда вы в сети | Облако, управляемое Anthropic, продолжается после отключения |23| [Web](/docs/ru/claude-code-on-the-web) | Долгосрочные задачи, которые не требуют большого управления, или работа, которая должна продолжаться, когда вы не в сети | Облако, по умолчанию управляемое Anthropic; продолжается после отключения |

24| [Mobile](/docs/ru/mobile) | Запуск и мониторинг задач вдали от вашего компьютера | Облачные сеансы из приложения Claude для iOS и Android, [Remote Control](/docs/ru/remote-control) для локальных сеансов, [Dispatch](/docs/ru/desktop#sessions-from-dispatch) на Desktop на Pro и Max |24| [Mobile](/docs/ru/mobile) | Запуск и мониторинг задач вдали от вашего компьютера | Облачные сеансы из приложения Claude для iOS и Android, [Remote Control](/docs/ru/remote-control) для локальных сеансов, [Dispatch](/docs/ru/desktop#sessions-from-dispatch) на Desktop на Pro и Max |

25 25 

26CLI — это наиболее полная поверхность для работы, ориентированной на терминал: скриптинг и Agent SDK доступны только в CLI. Сторонние поставщики также работают в [VS Code](/docs/ru/vs-code#use-third-party-providers) и в [JetBrains](/docs/ru/feature-availability#features-available-on-every-provider), который запускает CLI в терминале вашей IDE. Корпоративные развёртывания [Desktop](/docs/ru/desktop) поддерживают Google Cloud's Agent Platform, и Desktop поддерживает [поставщиков шлюза](/docs/ru/llm-gateway-connect#desktop-app); для Amazon Bedrock или Microsoft Foundry используйте CLI или расширение IDE, или [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview), который запускает вкладку Code на этих поставщиках. Desktop и расширения IDE обменивают некоторые функции, доступные только в CLI, на визуальный просмотр и более тесную интеграцию с редактором. Веб работает в облаке, поэтому задачи продолжают выполняться после отключения. Mobile — это тонкий клиент для этих же облачных сеансов или для локального сеанса через Remote Control, и может отправлять задачи на Desktop с помощью Dispatch.26CLI — это наиболее полная поверхность для работы, ориентированной на терминал: скриптинг и Agent SDK доступны только в CLI. Сторонние поставщики также работают в [VS Code](/docs/ru/vs-code#use-third-party-providers) и в [JetBrains](/docs/ru/feature-availability#features-available-on-every-provider), который запускает CLI в терминале вашей IDE. Корпоративные развёртывания [Desktop](/docs/ru/desktop) поддерживают Google Cloud's Agent Platform, и Desktop поддерживает [поставщиков шлюза](/docs/ru/llm-gateway-connect#desktop-app); для Amazon Bedrock или Microsoft Foundry используйте CLI или расширение IDE, или [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview), который запускает вкладку Code на этих поставщиках. Desktop и расширения IDE обменивают некоторые функции, доступные только в CLI, на визуальный просмотр и более тесную интеграцию с редактором. Веб работает в облаке, поэтому задачи продолжают выполняться после отключения. Mobile — это тонкий клиент для этих же облачных сеансов или для локального сеанса через Remote Control, и может отправлять задачи на Desktop с помощью Dispatch.

222 222 

223* Для длинного вывода, такого как сгенерированный файл, оцените его с помощью `regex` grader над содержимым файла, который проверяет весь файл одинаково каждый раз. Держите `llm` graders для коротких выводов с рубриками, написанными как конкретные условия PASS и FAIL.223* Для длинного вывода, такого как сгенерированный файл, оцените его с помощью `regex` grader над содержимым файла, который проверяет весь файл одинаково каждый раз. Держите `llm` graders для коротких выводов с рубриками, написанными как конкретные условия PASS и FAIL.

224* Дайте каждому кейсу один grader на результат, такой как финальное сообщение или произведенный файл, и один на то, как Claude туда попал, такой как `tool_used` или `tool_order`. Вместе они говорят вам как то, был ли ответ правильным, так и то, произвел ли ваш plugin его.224* Дайте каждому кейсу один grader на результат, такой как финальное сообщение или произведенный файл, и один на то, как Claude туда попал, такой как `tool_used` или `tool_order`. Вместе они говорят вам как то, был ли ответ правильным, так и то, произвел ли ваш plugin его.

225* Если grader `tool_used: Skill` кейса проходит, но `Δ` отрицательное, подозревайте judge перед plugin. Небольшая judge модель может отметить правильный ответ как неправильный, потому что он отформатирован иначе, чем описывает рубрика. Переустановите с `--judge-model sonnet` и затяните рубрику, чтобы форматирование не решало вердикт.225* Если grader `tool_used: Skill` кейса проходит, но `Δ` отрицательное, подозревайте judge перед plugin. Небольшая judge модель может отметить правильный ответ как неправильный, потому что он отформатирован иначе, чем описывает рубрика. Перезапустите с `--judge-model sonnet` и затяните рубрику, чтобы форматирование не решало вердикт.

226* Чтобы проверить, что сборка или тест прошли внутри запуска, попросите Claude запустить его и написать результат в файл, оцените этот файл и утверждайте, что команда запустилась с помощью `tool_used` grader, чей `input_match` называет команду.226* Чтобы проверить, что сборка или тест прошли внутри запуска, попросите Claude запустить его и написать результат в файл, оцените этот файл и утверждайте, что команда запустилась с помощью `tool_used` grader, чей `input_match` называет команду.

227 227 

228<h3 id="compare-against-a-no-plugin-baseline">228<h3 id="compare-against-a-no-plugin-baseline">

644 644 

645Если сводка не имеет столбца `W/OUT` или кейс не пройдет с "ablation requested but no plugin resolved", никакой plugin не был найден для кейса. Добавьте `plugins: ["../.."]` к кейсу, давая путь от директории кейса к директории plugin.645Если сводка не имеет столбца `W/OUT` или кейс не пройдет с "ablation requested but no plugin resolved", никакой plugin не был найден для кейса. Добавьте `plugins: ["../.."]` к кейсу, давая путь от директории кейса к директории plugin.

646 646 

647Если plugin действительно загружен и `Δ` все еще близко к нулю с неудачным grader `tool_used: Skill`, это обычно реальное открытие, означающее, что `description` skill не запускается на формулировке prompt. Отрегулируйте описание и переустановите ту же suite.647Если plugin действительно загружен и `Δ` все еще близко к нулю с неудачным grader `tool_used: Skill`, это обычно реальное открытие, означающее, что `description` skill не запускается на формулировке prompt. Отрегулируйте описание и перезапустите ту же suite.

648 648 

649<h3 id="everything-scores-zero-although-the-right-files-were-produced">649<h3 id="everything-scores-zero-although-the-right-files-were-produced">

650 Everything scores zero although the right files were produced650 Everything scores zero although the right files were produced

686 Runs fail with a usage-limit or rate-limit error partway through686 Runs fail with a usage-limit or rate-limit error partway through

687</h3>687</h3>

688 688 

689Если ваш аккаунт достигает лимита использования плана или API лимита скорости, пока suite запускается, каждый более поздний запуск заканчивается этой ошибкой, оценивается на том, что он произвел, и обычно оценивается в 0. Suite все еще завершается и не отмечена `partial`, поэтому результат может выглядеть как регрессия. Проверьте столбец `NOTES` или `cases[].arms.with[].error` в JSON для сообщения лимита перед тем как доверять оценкам, затем переустановите после того как лимит сбросится, с `--runs 1` или фильтром `--case`, если вам нужно остаться под ним.689Если ваш аккаунт достигает лимита использования плана или API лимита скорости, пока suite запускается, каждый более поздний запуск заканчивается этой ошибкой, оценивается на том, что он произвел, и обычно оценивается в 0. Suite все еще завершается и не отмечена `partial`, поэтому результат может выглядеть как регрессия. Проверьте столбец `NOTES` или `cases[].arms.with[].error` в JSON для сообщения лимита перед тем как доверять оценкам, затем перезапустите после того как лимит сбросится, с `--runs 1` или фильтром `--case`, если вам нужно остаться под ним.

690 690 

691<h3 id="runs-time-out-or-hit-the-turn-cap">691<h3 id="runs-time-out-or-hit-the-turn-cap">

692 Runs time out or hit the turn cap692 Runs time out or hit the turn cap

72 72 

73Эти действия приводят к тому, что следующий запрос пропускает часть или весь кэш. Вы видите одноразовый более медленный и дорогостоящий ход, после чего новый префикс кэшируется. Большинство из них можно избежать во время выполнения задачи, если вы знаете, что они имеют стоимость. Переключение модели может казаться бесплатным, пока вы не заметите более медленный ход, который следует за ним.73Эти действия приводят к тому, что следующий запрос пропускает часть или весь кэш. Вы видите одноразовый более медленный и дорогостоящий ход, после чего новый префикс кэшируется. Большинство из них можно избежать во время выполнения задачи, если вы знаете, что они имеют стоимость. Переключение модели может казаться бесплатным, пока вы не заметите более медленный ход, который следует за ним.

74 74 

75* [Switching models](#switching-models)75* [Переключение моделей](#switching-models)

76* [Changing effort level](#changing-effort-level)76* [Изменение уровня усилий](#changing-effort-level)

77* [Turning on fast mode](#turning-on-fast-mode)77* [Включение быстрого режима](#turning-on-fast-mode)

78* [Connecting or disconnecting an MCP server](#connecting-or-disconnecting-an-mcp-server)78* [Подключение или отключение MCP сервера](#connecting-or-disconnecting-an-mcp-server)

79* [Enabling or disabling a plugin](#enabling-or-disabling-a-plugin)79* [Включение или отключение плагина](#enabling-or-disabling-a-plugin)

80* [Denying an entire tool](#denying-an-entire-tool)80* [Отказ от всего инструмента](#denying-an-entire-tool)

81* [Compacting the conversation](#compacting-the-conversation)81* [Сжатие разговора](#compacting-the-conversation)

82* [Accumulating many images](#accumulating-many-images)82* [Накопление большого количества изображений](#accumulating-many-images)

83* [Upgrading Claude Code](#upgrading-claude-code)83* [Обновление Claude Code](#upgrading-claude-code)

84 84 

85<h3 id="switching-models">85<h3 id="switching-models">

86 Switching models86 Переключение моделей

87</h3>87</h3>

88 88 

89Каждая модель имеет свой собственный кэш. Переключение с помощью [`/model`](/docs/ru/model-config#setting-your-model) означает, что следующий запрос читает всю историю разговора без попаданий в кэш, даже если содержимое идентично.89Каждая модель имеет свой собственный кэш. Переключение с помощью [`/model`](/docs/ru/model-config#setting-your-model) означает, что следующий запрос читает всю историю разговора без попаданий в кэш, даже если содержимое идентично.

101Когда frontmatter навыка или команды указывает [`model`](/docs/ru/skills#frontmatter-reference), отличный от текущей модели сеанса, этот ход также является переключением модели: следующий запрос читает всю историю разговора без попаданий в кэш. Модель сеанса возобновляется при вашем следующем запросе. Навык `context: fork` устанавливает [модель разветвленного подагента](/docs/ru/skills#run-skills-in-a-subagent) вместо этого.101Когда frontmatter навыка или команды указывает [`model`](/docs/ru/skills#frontmatter-reference), отличный от текущей модели сеанса, этот ход также является переключением модели: следующий запрос читает всю историю разговора без попаданий в кэш. Модель сеанса возобновляется при вашем следующем запросе. Навык `context: fork` устанавливает [модель разветвленного подагента](/docs/ru/skills#run-skills-in-a-subagent) вместо этого.

102 102 

103<h3 id="changing-effort-level">103<h3 id="changing-effort-level">

104 Changing effort level104 Изменение уровня усилий

105</h3>105</h3>

106 106 

107На большинстве моделей изменение [уровня усилий](/docs/ru/model-config#adjust-effort-level) в середине сеанса означает, что следующий запрос читает всю историю разговора без попаданий в кэш. Пока кэш еще теплый, Claude Code просит вас сначала подтвердить изменение.107На большинстве моделей изменение [уровня усилий](/docs/ru/model-config#adjust-effort-level) в середине сеанса означает, что следующий запрос читает всю историю разговора без попаданий в кэш. Пока кэш еще теплый, Claude Code просит вас сначала подтвердить изменение.

111До версии v2.1.260 изменение усилий на Fable 5.1 с ключом API или подпиской Claude также инвалидировало кэш.111До версии v2.1.260 изменение усилий на Fable 5.1 с ключом API или подпиской Claude также инвалидировало кэш.

112 112 

113<h3 id="turning-on-fast-mode">113<h3 id="turning-on-fast-mode">

114 Turning on fast mode114 Включение быстрого режима

115</h3>115</h3>

116 116 

117Включение [fast mode](/docs/ru/fast-mode) добавляет заголовок запроса, который является частью ключа кэша, поэтому первый запрос, который Claude Code отправляет с включенным fast mode, читает всю историю разговора без попаданий в кэш. Claude Code устанавливает этот заголовок один раз при запуске хода и сохраняет его для всего хода, поэтому когда вы включаете fast mode во время работы Claude, пропуск кэша из заголовка происходит при первом запросе вашего следующего хода. Эти некэшированные входные токены выставляются по [fast mode rates](/docs/ru/fast-mode#understand-the-cost-tradeoff), поэтому включение его в начале сеанса стоит меньше, чем включение его глубоко в длинный сеанс. Если ваша текущая модель не поддерживает fast mode, включение fast mode также [переключает вашу модель](#switching-models), и это переключение запускает свежий кэш самостоятельно с следующего запроса в текущем ходе.117Включение [fast mode](/docs/ru/fast-mode) добавляет заголовок запроса, который является частью ключа кэша, поэтому первый запрос, который Claude Code отправляет с включенным fast mode, читает всю историю разговора без попаданий в кэш. Claude Code устанавливает этот заголовок один раз при запуске хода и сохраняет его для всего хода, поэтому когда вы включаете fast mode во время работы Claude, пропуск кэша из заголовка происходит при первом запросе вашего следующего хода. Эти некэшированные входные токены выставляются по [fast mode rates](/docs/ru/fast-mode#understand-the-cost-tradeoff), поэтому включение его в начале сеанса стоит меньше, чем включение его глубоко в длинный сеанс. Если ваша текущая модель не поддерживает fast mode, включение fast mode также [переключает вашу модель](#switching-models), и это переключение запускает свежий кэш самостоятельно с следующего запроса в текущем ходе.

119Стоимость применяется один раз за разговор. После первого хода fast mode Claude Code продолжает отправлять заголовок и варьирует только параметр скорости запроса, который не является частью ключа кэша. Отключение fast mode, [автоматический откат к стандартной скорости](/docs/ru/fast-mode#handle-rate-limits) после ограничения скорости и повторное включение позже все сохраняют кэш. Если вы [исчерпаете кредиты использования](/docs/ru/fast-mode#handle-rate-limits) в середине сеанса, Claude Code повторяет каждый отклоненный запрос fast mode на стандартной скорости таким же образом, поэтому этот откат также сохраняет кэш. `/clear` и `/compact` сбрасывают это, так как они все равно перестраивают кэш в этих точках.119Стоимость применяется один раз за разговор. После первого хода fast mode Claude Code продолжает отправлять заголовок и варьирует только параметр скорости запроса, который не является частью ключа кэша. Отключение fast mode, [автоматический откат к стандартной скорости](/docs/ru/fast-mode#handle-rate-limits) после ограничения скорости и повторное включение позже все сохраняют кэш. Если вы [исчерпаете кредиты использования](/docs/ru/fast-mode#handle-rate-limits) в середине сеанса, Claude Code повторяет каждый отклоненный запрос fast mode на стандартной скорости таким же образом, поэтому этот откат также сохраняет кэш. `/clear` и `/compact` сбрасывают это, так как они все равно перестраивают кэш в этих точках.

120 120 

121<h3 id="connecting-or-disconnecting-an-mcp-server">121<h3 id="connecting-or-disconnecting-an-mcp-server">

122 Connecting or disconnecting an MCP server122 Подключение или отключение MCP сервера

123</h3>123</h3>

124 124 

125Определения инструментов находятся в слое системной подсказки, поэтому кэш инвалидируется, когда набор определений инструментов в запросе изменяется между ходами. Переключение [advisor tool](/docs/ru/advisor) является исключением: его определение находится после точки разрыва кэша, поэтому включение или отключение `/advisor` сохраняет кэшированный префикс нетронутым. Зависит ли изменение [MCP server](/docs/ru/mcp) от этого от того, отложены ли его инструменты [tool search](/docs/ru/mcp#scale-with-mcp-tool-search) или загружены в префикс:125Определения инструментов находятся в слое системной подсказки, поэтому кэш инвалидируется, когда набор определений инструментов в запросе изменяется между ходами. Переключение [advisor tool](/docs/ru/advisor) является исключением: его определение находится после точки разрыва кэша, поэтому включение или отключение `/advisor` сохраняет кэшированный префикс нетронутым. Зависит ли изменение [MCP server](/docs/ru/mcp) от этого от того, отложены ли его инструменты [tool search](/docs/ru/mcp#scale-with-mcp-tool-search) или загружены в префикс:

132Редактирование конфигурации MCP само по себе не изменяет кэш. Новая конфигурация вступает в силу только после перезагрузки, когда сервер подключается или отключается.132Редактирование конфигурации MCP само по себе не изменяет кэш. Новая конфигурация вступает в силу только после перезагрузки, когда сервер подключается или отключается.

133 133 

134<h3 id="enabling-or-disabling-a-plugin">134<h3 id="enabling-or-disabling-a-plugin">

135 Enabling or disabling a plugin135 Включение или отключение плагина

136</h3>136</h3>

137 137 

138Когда вы включаете или отключаете [plugin](/docs/ru/plugins), стоимость изменения зависит от того, какие типы компонентов предоставляет плагин. Случаи ниже охватывают каждый тип компонента, когда Claude Code применяет изменение и что происходит, когда вы отключаете плагин снова в том же сеансе.138Когда вы включаете или отключаете [plugin](/docs/ru/plugins), стоимость изменения зависит от того, какие типы компонентов предоставляет плагин. Случаи ниже охватывают каждый тип компонента, когда Claude Code применяет изменение и что происходит, когда вы отключаете плагин снова в том же сеансе.

139 139 

140<h4 id="plugin-components-that-keep-the-cache">140<h4 id="plugin-components-that-keep-the-cache">

141 Plugin components that keep the cache141 Компоненты плагина, которые сохраняют кэш

142</h4>142</h4>

143 143 

144Claude Code никогда не инвалидирует кэш для навыков, команд, агентов, hooks, мониторов или тем плагина. Он добавляет их содержимое после существующего разговора, поэтому следующий запрос платит за это содержимое и все еще читает все, что было до него, из кэша.144Claude Code никогда не инвалидирует кэш для навыков, команд, агентов, hooks, мониторов или тем плагина. Он добавляет их содержимое после существующего разговора, поэтому следующий запрос платит за это содержимое и все еще читает все, что было до него, из кэша.

145 145 

146<h4 id="plugins-that-provide-mcp-servers">146<h4 id="plugins-that-provide-mcp-servers">

147 Plugins that provide MCP servers147 Плагины, которые предоставляют MCP серверы

148</h4>148</h4>

149 149 

150Когда вы включаете или отключаете плагин, который предоставляет [MCP servers](/docs/ru/plugins-reference#mcp-servers), Claude Code следует тем же правилам, что и при [подключении или отключении MCP server](#connecting-or-disconnecting-an-mcp-server):150Когда вы включаете или отключаете плагин, который предоставляет [MCP servers](/docs/ru/plugins-reference#mcp-servers), Claude Code следует тем же правилам, что и при [подключении или отключении MCP server](#connecting-or-disconnecting-an-mcp-server):

153* Если Claude Code загружает их в префикс, следующий запрос повторно читает весь разговор.153* Если Claude Code загружает их в префикс, следующий запрос повторно читает весь разговор.

154 154 

155<h4 id="code-intelligence-plugins">155<h4 id="code-intelligence-plugins">

156 Code intelligence plugins156 Плагины анализа кода

157</h4>157</h4>

158 158 

159Когда вы включаете [code intelligence plugin](/docs/ru/discover-plugins#code-intelligence), Claude получает [LSP tool](/docs/ru/tools-reference#lsp-tool-behavior).159Когда вы включаете [code intelligence plugin](/docs/ru/discover-plugins#code-intelligence), Claude получает [LSP tool](/docs/ru/tools-reference#lsp-tool-behavior).

160 160 

161<h4 id="when-plugin-changes-apply">161<h4 id="when-plugin-changes-apply">

162 When plugin changes apply162 Когда применяются изменения плагинов

163</h4>163</h4>

164 164 

165Изменение, которое вы вносите в меню `/plugin`, проходит через [`/reload-plugins`](/docs/ru/discover-plugins#apply-plugin-changes-without-restarting), которое Claude Code запускает для вас при закрытии меню. Вы платите стоимость, будь то добавленные объявления или полное повторное чтение, при первом ходе после применения изменения. Claude Code также может применить изменение самостоятельно:165Изменение, которое вы вносите в меню `/plugin`, проходит через [`/reload-plugins`](/docs/ru/discover-plugins#apply-plugin-changes-without-restarting), которое Claude Code запускает для вас при закрытии меню. Вы платите стоимость, будь то добавленные объявления или полное повторное чтение, при первом ходе после применения изменения. Claude Code также может применить изменение самостоятельно:

176В этих сеансах перезагрузка применяет все, кроме изменений MCP сервера плагина, которые [вступают в силу в вашем следующем сеансе](/docs/ru/discover-plugins#apply-plugin-changes-without-restarting) и поэтому никогда не стоят полного повторного чтения в середине сеанса.176В этих сеансах перезагрузка применяет все, кроме изменений MCP сервера плагина, которые [вступают в силу в вашем следующем сеансе](/docs/ru/discover-plugins#apply-plugin-changes-without-restarting) и поэтому никогда не стоят полного повторного чтения в середине сеанса.

177 177 

178<h4 id="plugins-you-enable-and-then-disable-in-one-session">178<h4 id="plugins-you-enable-and-then-disable-in-one-session">

179 Plugins you enable and then disable in one session179 Плагины, которые вы включаете, а затем отключаете в одном сеансе

180</h4>180</h4>

181 181 

182Когда вы отключаете плагин, который вы включили ранее в сеансе, Claude Code восстанавливает предыдущую форму запроса. Если этот префикс все еще находится в пределах его [cache lifetime](#cache-lifetime), следующий запрос читает более старую запись кэша вместо перестройки.182Когда вы отключаете плагин, который вы включили ранее в сеансе, Claude Code восстанавливает предыдущую форму запроса. Если этот префикс все еще находится в пределах его [cache lifetime](#cache-lifetime), следующий запрос читает более старую запись кэша вместо перестройки.

183 183 

184<h3 id="denying-an-entire-tool">184<h3 id="denying-an-entire-tool">

185 Denying an entire tool185 Отказ от всего инструмента

186</h3>186</h3>

187 187 

188Добавление простого имени инструмента, такого как `Bash` или `WebFetch`, как [deny rule](/docs/ru/permissions#manage-permissions) удаляет этот инструмент из контекста Claude полностью. Claude Code загружает определения встроенных инструментов в слой системной подсказки, поэтому добавление или удаление одного из этих правил в середине сеанса инвалидирует кэш. Claude Code применяет изменение при следующем запросе, независимо от того, добавляете ли вы правило через `/permissions` или путем [редактирования файла параметров напрямую](/docs/ru/settings#when-edits-take-effect). Это включает правило, которое вы добавляете через `/permissions` в середине хода.188Добавление простого имени инструмента, такого как `Bash` или `WebFetch`, как [deny rule](/docs/ru/permissions#manage-permissions) удаляет этот инструмент из контекста Claude полностью. Claude Code загружает определения встроенных инструментов в слой системной подсказки, поэтому добавление или удаление одного из этих правил в середине сеанса инвалидирует кэш. Claude Code применяет изменение при следующем запросе, независимо от того, добавляете ли вы правило через `/permissions` или путем [редактирования файла параметров напрямую](/docs/ru/settings#when-edits-take-effect). Это включает правило, которое вы добавляете через `/permissions` в середине хода.

190Только правило отрицания, которое совпадает в позиции имени инструмента, имеет этот эффект: простое имя инструмента, эквивалентная форма `Bash(*)` или [tool-name glob](/docs/ru/permissions#tool-name-wildcards) как `"*"`. Glob, который совпадает только с инструментами MCP, такой как `"mcp__*"`, удаляет эти инструменты таким же образом, но оставляет кэш нетронутым, когда совпадающие инструменты [отложены](#connecting-or-disconnecting-an-mcp-server), по умолчанию, так как отложенные определения никогда не были в кэшированном префиксе. Правила отрицания с областью действия, такие как `Bash(rm *)`, и все правила разрешения и запроса не изменяют, какие инструменты видит Claude. Claude Code проверяет их, когда Claude пытается выполнить вызов, оставляя префикс нетронутым.190Только правило отрицания, которое совпадает в позиции имени инструмента, имеет этот эффект: простое имя инструмента, эквивалентная форма `Bash(*)` или [tool-name glob](/docs/ru/permissions#tool-name-wildcards) как `"*"`. Glob, который совпадает только с инструментами MCP, такой как `"mcp__*"`, удаляет эти инструменты таким же образом, но оставляет кэш нетронутым, когда совпадающие инструменты [отложены](#connecting-or-disconnecting-an-mcp-server), по умолчанию, так как отложенные определения никогда не были в кэшированном префиксе. Правила отрицания с областью действия, такие как `Bash(rm *)`, и все правила разрешения и запроса не изменяют, какие инструменты видит Claude. Claude Code проверяет их, когда Claude пытается выполнить вызов, оставляя префикс нетронутым.

191 191 

192<h3 id="compacting-the-conversation">192<h3 id="compacting-the-conversation">

193 Compacting the conversation193 Сжатие разговора

194</h3>194</h3>

195 195 

196[Compaction](/docs/ru/context-window#what-survives-compaction) заменяет историю ваших сообщений на сводку. По замыслу, это инвалидирует слой разговора, так как следующий запрос имеет новую, более короткую историю, которая не делит префикс со старой. Claude Code повторно использует слой системной подсказки, если разговор не был [возобновлен при сохранении системной подсказки, которая иначе изменилась бы](#resuming-a-session); в этом случае первая компактизация переключается на текущую подсказку и этот слой перестраивается один раз. Он перезагружает контекст проекта с диска, который кэшируется только если CLAUDE.md и память не изменились с начала сеанса.196[Compaction](/docs/ru/context-window#what-survives-compaction) заменяет историю ваших сообщений на сводку. По замыслу, это инвалидирует слой разговора, так как следующий запрос имеет новую, более короткую историю, которая не делит префикс со старой. Claude Code повторно использует слой системной подсказки, если разговор не был [возобновлен при сохранении системной подсказки, которая иначе изменилась бы](#resuming-a-session); в этом случае первая компактизация переключается на текущую подсказку и этот слой перестраивается один раз. Он перезагружает контекст проекта с диска, который кэшируется только если CLAUDE.md и память не изменились с начала сеанса.

204</Tip>204</Tip>

205 205 

206<h3 id="accumulating-many-images">206<h3 id="accumulating-many-images">

207 Accumulating many images207 Накопление большого количества изображений

208</h3>208</h3>

209 209 

210API ограничивает количество изображений и PDF-файлов, которые может содержать каждый запрос. Для текущих чисел см. [Request limits](https://platform.claude.com/docs/en/build-with-claude/vision#request-limits) в документации API. Claude Code также ограничивает общий размер изображений и PDF-файлов в запросе, поэтому большие снимки экрана достигают лимита с меньшим количеством изображений, чем маленькие.210API ограничивает количество изображений и PDF-файлов, которые может содержать каждый запрос. Для текущих чисел см. [Request limits](https://platform.claude.com/docs/en/build-with-claude/vision#request-limits) в документации API. Claude Code также ограничивает общий размер изображений и PDF-файлов в запросе, поэтому большие снимки экрана достигают лимита с меньшим количеством изображений, чем маленькие.

214Удаление изображений изменяет сообщения, которые их содержали, поэтому следующий запрос повторно обрабатывает разговор с самого раннего из этих сообщений. Поскольку Claude Code удаляет партию за раз, вы видите один более медленный ход за партию, а не один с каждым новым снимком экрана.214Удаление изображений изменяет сообщения, которые их содержали, поэтому следующий запрос повторно обрабатывает разговор с самого раннего из этих сообщений. Поскольку Claude Code удаляет партию за раз, вы видите один более медленный ход за партию, а не один с каждым новым снимком экрана.

215 215 

216<h3 id="upgrading-claude-code">216<h3 id="upgrading-claude-code">

217 Upgrading Claude Code217 Обновление Claude Code

218</h3>218</h3>

219 219 

220Новая версия Claude Code обычно обновляет системную подсказку или определения инструментов, поэтому первый разговор, который вы начинаете после обновления, строит свой кэш с нуля. [Auto-update](/docs/ru/setup#auto-updates) загружает новые версии в фоновом режиме, но применяет их при следующем запуске, никогда в середине сеанса, поэтому вы видите это как некэшированный первый ход после перезагрузки, а не сюрприз во время сеанса. Установите `DISABLE_AUTOUPDATER=1` для управления тем, когда применяются обновления.220Новая версия Claude Code обычно обновляет системную подсказку или определения инструментов, поэтому первый разговор, который вы начинаете после обновления, строит свой кэш с нуля. [Auto-update](/docs/ru/setup#auto-updates) загружает новые версии в фоновом режиме, но применяет их при следующем запуске, никогда в середине сеанса, поэтому вы видите это как некэшированный первый ход после перезагрузки, а не сюрприз во время сеанса. Установите `DISABLE_AUTOUPDATER=1` для управления тем, когда применяются обновления.