Documentation — Spybara

agent-sdk/python.md +1 −1

Details

2885 2885

2886**Имя инструмента:** `Bash`2886**Имя инструмента:** `Bash`

2887 2887

2888Для информации о том, что устанавливает потолок переднего плана, см. [Тайм-ауты и ограничения вывода](/docs/ru/tools-reference#timeout-and-output-limits). Для ограничения времени фонового режима см. [Фоновые команды](/docs/ru/tools-reference#background-commands).2888Для информации о том, что устанавливает потолок переднего плана, см. [Тайм-ауты и ограничения вывода](/docs/ru/tools-reference#timeout-and-output-limits). Для ограничения времени фонового режима см. [Ограничение времени для фоновых команд](/docs/ru/tools-reference#time-limit-for-background-commands).

2889 2889

2890**Ввод:**2890**Ввод:**

2891 2891

agent-sdk/typescript.md +2 −2

Details

3209};3209};

3210```3210```

3211 3211

3212Выполняет команды Bash с опциональным timeout и фоновым выполнением. Рабочий каталог сохраняется между командами, включая команды, запущенные в более поздних ходах многоходовой сессии; состояние shell, такое как экспортированные переменные окружения, не сохраняется. Для ограничений на то, какие изменения каталога переносятся, см. [Что сохраняется между командами](/docs/ru/tools-reference#what-persists-between-commands). Для того, что устанавливает потолок foreground, см. [Timeout и лимиты вывода](/docs/ru/tools-reference#timeout-and-output-limits). Для лимита времени фона см. [Фоновые команды](/docs/ru/tools-reference#background-commands).3212Выполняет команды Bash с опциональным timeout и фоновым выполнением. Рабочий каталог сохраняется между командами, включая команды, запущенные в более поздних ходах многоходовой сессии; состояние shell, такое как экспортированные переменные окружения, не сохраняется. Для ограничений на то, какие изменения каталога переносятся, см. [Что сохраняется между командами](/docs/ru/tools-reference#what-persists-between-commands). Для того, что устанавливает потолок foreground, см. [Timeout и лимиты вывода](/docs/ru/tools-reference#timeout-and-output-limits). Для лимита времени фона см. [Лимит времени для фоновых команд](/docs/ru/tools-reference#time-limit-for-background-commands).

3213 3213

3214<h3 id="monitor">3214<h3 id="monitor">

3215 Monitor3215 Monitor

4113 4113

4114`timedOutAfterMs` — это тайм-аут в миллисекундах, установленный, когда команда достигла своего тайм-аута и перешла в фоновый режим, а не начала там явно. `backgroundCwdHint` устанавливается, когда фоновая команда содержала встроенную команду изменения каталога, такую как `cd`, `pushd`, `popd` или `chdir`, и отмечает, что рабочий каталог сеанса не изменился. Оба поля требуют Claude Code v2.1.210 или более поздней версии.4114`timedOutAfterMs` — это тайм-аут в миллисекундах, установленный, когда команда достигла своего тайм-аута и перешла в фоновый режим, а не начала там явно. `backgroundCwdHint` устанавливается, когда фоновая команда содержала встроенную команду изменения каталога, такую как `cd`, `pushd`, `popd` или `chdir`, и отмечает, что рабочий каталог сеанса не изменился. Оба поля требуют Claude Code v2.1.210 или более поздней версии.

4115 4115

4116Когда подагент, работающий на переднем плане, владеет фоновой командой, команда [завершается, когда этот подагент даёт свой финальный ответ](/docs/ru/tools-reference#background-commands). Claude Code устанавливает `backgroundEndsWithFinalResponse` в `true` для таких команд и опускает поле, когда команда сохраняется после хода, как команды, запущенные основным разговором или фоновыми подагентами. Поле требует Claude Code v2.1.227 или более поздней версии.4116Когда подагент, работающий на переднем плане, владеет фоновой командой, команда [завершается, когда этот подагент даёт свой финальный ответ](/docs/ru/tools-reference#when-a-background-command-stops). Claude Code устанавливает `backgroundEndsWithFinalResponse` в `true` для таких команд и опускает поле, когда команда сохраняется после хода, как команды, запущенные основным разговором или фоновыми подагентами. Поле требует Claude Code v2.1.227 или более поздней версии.

4117 4117

4118Claude Code устанавливает `gitOperation.commit.branch` в ветку, названную в строке сводки коммита git, и опускает её для коммита, сделанного на отсоединённой HEAD. Поле требует Agent SDK v0.3.227 или более поздней версии. Claude Code сообщает команду `gh pr reopen` как действие PR `reopened`, что требует Agent SDK v0.3.234 или более поздней версии.4118Claude Code устанавливает `gitOperation.commit.branch` в ветку, названную в строке сводки коммита git, и опускает её для коммита, сделанного на отсоединённой HEAD. Поле требует Agent SDK v0.3.227 или более поздней версии. Claude Code сообщает команду `gh pr reopen` как действие PR `reopened`, что требует Agent SDK v0.3.234 или более поздней версии.

4119 4119

agent-view.md +2 −2

Details

8 8

9Agent view, открываемое с помощью `claude agents`, — это один экран для всех ваших фоновых сеансов: что работает, что требует вашего ввода и что завершено. Отправляйте новые сеансы, наблюдайте их состояние с первого взгляда вместо прокрутки стенограмм и вмешивайтесь только когда один из них требует вас. Каждый фоновый сеанс — это полная беседа Claude Code, которая продолжает работать без подключённого терминала, поэтому вы можете открыть его, ответить и уйти в любой момент.9Agent view, открываемое с помощью `claude agents`, — это один экран для всех ваших фоновых сеансов: что работает, что требует вашего ввода и что завершено. Отправляйте новые сеансы, наблюдайте их состояние с первого взгляда вместо прокрутки стенограмм и вмешивайтесь только когда один из них требует вас. Каждый фоновый сеанс — это полная беседа Claude Code, которая продолжает работать без подключённого терминала, поэтому вы можете открыть его, ответить и уйти в любой момент.

10 10

11<img src="https://mintcdn.com/claude-code/1B48Qz2Z9hac4SLG/images/agent-view-light.png?fit=max&auto=format&n=1B48Qz2Z9hac4SLG&q=85&s=7a186c96ed47d6700d084d77e786be65" className="dark:hidden" alt="Agent view в терминале: заголовок показывает Claude Code v2.1.140, модель, рабочий каталог и сводный счёт. Сеансы сгруппированы под Требуется ввод, Работает и Завершено, с полем отправки в нижней части и подвалом с подсказками сочетаний клавиш." width="1772" height="780" data-path="images/agent-view-light.png" />11<img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/agent-view-light.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=d6905012bee31f3e6b3920b09c05dd02" className="dark:hidden" alt="Agent view в терминале: заголовок показывает Claude Code v2.1.140, модель, рабочий каталог и сводный счёт. Сеансы сгруппированы под Требуется ввод, Работает и Завершено, с полем отправки в нижней части и подвалом с подсказками сочетаний клавиш." width="1872" height="680" data-path="images/agent-view-light.png" />

12 12

13<img src="https://mintcdn.com/claude-code/1B48Qz2Z9hac4SLG/images/agent-view-dark.png?fit=max&auto=format&n=1B48Qz2Z9hac4SLG&q=85&s=a5bed7434bae368faea3a8f023b52aa2" className="hidden dark:block" alt="Agent view в терминале: заголовок показывает Claude Code v2.1.140, модель, рабочий каталог и сводный счёт. Сеансы сгруппированы под Требуется ввод, Работает и Завершено, с полем отправки в нижней части и подвалом с подсказками сочетаний клавиш." width="1772" height="780" data-path="images/agent-view-dark.png" />13<img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/agent-view-dark.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=fc3c195bfc57e313ced1f1beb36cee93" className="hidden dark:block" alt="Agent view в терминале: заголовок показывает Claude Code v2.1.140, модель, рабочий каталог и сводный счёт. Сеансы сгруппированы под Требуется ввод, Работает и Завершено, с полем отправки в нижней части и подвалом с подсказками сочетаний клавиш." width="1872" height="680" data-path="images/agent-view-dark.png" />

14 14

15Используйте agent view, когда у вас есть несколько независимых задач, над которыми Claude может работать без вашего наблюдения на каждом шаге. Отправьте исправление ошибки, проверку pull request и исследование нестабильного теста как три строки, продолжайте работать в другом окне и проверьте, когда строка показывает, что она требует вас или имеет результат.15Используйте agent view, когда у вас есть несколько независимых задач, над которыми Claude может работать без вашего наблюдения на каждом шаге. Отправьте исправление ошибки, проверку pull request и исследование нестабильного теста как три строки, продолжайте работать в другом окне и проверьте, когда строка показывает, что она требует вас или имеет результат.

16 16

cli-reference.md +3 −2

Details

84| `--dangerously-skip-permissions` | Пропустить запросы разрешения. Эквивалентно `--permission-mode bypassPermissions`. См. [режимы разрешения](/docs/ru/permission-modes#skip-all-checks-with-bypasspermissions-mode) для информации о том, что это пропускает и что не пропускает. Для сеансов, запущенных с `--bg`, режим [сохраняется при перезапуске сеанса супервизором](/docs/ru/agent-view#permission-mode-model-and-effort) | `claude --dangerously-skip-permissions` |84| `--dangerously-skip-permissions` | Пропустить запросы разрешения. Эквивалентно `--permission-mode bypassPermissions`. См. [режимы разрешения](/docs/ru/permission-modes#skip-all-checks-with-bypasspermissions-mode) для информации о том, что это пропускает и что не пропускает. Для сеансов, запущенных с `--bg`, режим [сохраняется при перезапуске сеанса супервизором](/docs/ru/agent-view#permission-mode-model-and-effort) | `claude --dangerously-skip-permissions` |

85| `--debug` | Включить режим отладки с дополнительной фильтрацией категорий, такой как `--debug='mcp,startup'` или `--debug='!1p'`. Фильтр привязывается только в форме `=`; разделённый пробелом фильтр включает режим отладки без фильтрации | `claude --debug='mcp,startup'` |85| `--debug` | Включить режим отладки с дополнительной фильтрацией категорий, такой как `--debug='mcp,startup'` или `--debug='!1p'`. Фильтр привязывается только в форме `=`; разделённый пробелом фильтр включает режим отладки без фильтрации | `claude --debug='mcp,startup'` |

86| `--debug-file <path>` | Записать журналы отладки в конкретный путь файла. Неявно включает режим отладки. Имеет приоритет над `CLAUDE_CODE_DEBUG_LOGS_DIR` | `claude --debug-file /tmp/claude-debug.log` |86| `--debug-file <path>` | Записать журналы отладки в конкретный путь файла. Неявно включает режим отладки. Имеет приоритет над `CLAUDE_CODE_DEBUG_LOGS_DIR` | `claude --debug-file /tmp/claude-debug.log` |

87| `--desktop` | Открыть [приложение Claude Desktop](/docs/ru/desktop) в текущем каталоге и выйти без запуска сеанса в терминале. Добавьте `--continue` или `--resume` с ID сеанса для [открытия этого сеанса в Desktop](/docs/ru/desktop#coming-from-the-cli) вместо этого. `--resume` здесь принимает только ID сеанса, не имя или путь транскрипта. Не принимает приглашение и никакие другие флаги, кроме `--verbose` и флагов `--debug`, так как приложение само запускает сеанс. Доступно на macOS и x64 Windows, когда вы вошли с подпиской Claude. Требует Claude Code v2.1.285 или позже | `claude --desktop` |

88| `--disallowedTools`, `--disallowed-tools` | Правила отрицания. Простое имя инструмента удаляет соответствующие инструменты из контекста Claude: `"Edit"` удаляет Edit, `"*"` удаляет каждый инструмент, и `"mcp__*"` удаляет каждый MCP инструмент. Правило с областью действия, такое как `Bash(rm *)`, оставляет инструмент доступным и отрицает только вызовы, которые совпадают [как написано](/docs/ru/permissions#bash-rule-limits). Правило, называющее [`EndConversation`](/docs/ru/tools-reference#endconversation-tool-behavior), не может удалить его, пока остаётся любой другой инструмент | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |89| `--disallowedTools`, `--disallowed-tools` | Правила отрицания. Простое имя инструмента удаляет соответствующие инструменты из контекста Claude: `"Edit"` удаляет Edit, `"*"` удаляет каждый инструмент, и `"mcp__*"` удаляет каждый MCP инструмент. Правило с областью действия, такое как `Bash(rm *)`, оставляет инструмент доступным и отрицает только вызовы, которые совпадают [как написано](/docs/ru/permissions#bash-rule-limits). Правило, называющее [`EndConversation`](/docs/ru/tools-reference#endconversation-tool-behavior), не может удалить его, пока остаётся любой другой инструмент | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |

89| `--effort` | Установить [уровень усилий](/docs/ru/model-config#adjust-effort-level) для текущего сеанса. Опции: `low`, `medium`, `high`, `xhigh`, `max` или `ultracode`. Доступные уровни зависят от модели. `ultracode` запускает сеанс с усилием `xhigh` с включённым [ultracode](/docs/ru/workflows#let-claude-decide-with-ultracode) и требует Claude Code v2.1.203 или позже. Переопределяет параметры [`modelSettings`](/docs/ru/settings-reference#modelsettings) и [`effortLevel`](/docs/ru/settings-reference#effortlevel) для этого сеанса и не сохраняется | `claude --effort high` |90| `--effort` | Установить [уровень усилий](/docs/ru/model-config#adjust-effort-level) для текущего сеанса. Опции: `low`, `medium`, `high`, `xhigh`, `max` или `ultracode`. Доступные уровни зависят от модели. `ultracode` запускает сеанс с усилием `xhigh` с включённым [ultracode](/docs/ru/workflows#let-claude-decide-with-ultracode) и требует Claude Code v2.1.203 или позже. Переопределяет параметры [`modelSettings`](/docs/ru/settings-reference#modelsettings) и [`effortLevel`](/docs/ru/settings-reference#effortlevel) для этого сеанса и не сохраняется | `claude --effort high` |

116| `--permission-prompts` | Установить, кто отвечает на запросы разрешения в режиме печати. С по умолчанию `host`, Claude Code отправляет их хосту Agent SDK или инструменту `--permission-prompt-tool`. Передайте `none`, когда никто не может ответить, и Claude Code отклоняет их вместо этого. См. [Отключить запросы разрешения в автоматических запусках](/docs/ru/headless#turn-off-permission-prompts-in-unattended-runs). Требует Claude Code v2.1.259 или позже | `claude -p --permission-prompts none "query"` |117| `--permission-prompts` | Установить, кто отвечает на запросы разрешения в режиме печати. С по умолчанию `host`, Claude Code отправляет их хосту Agent SDK или инструменту `--permission-prompt-tool`. Передайте `none`, когда никто не может ответить, и Claude Code отклоняет их вместо этого. См. [Отключить запросы разрешения в автоматических запусках](/docs/ru/headless#turn-off-permission-prompts-in-unattended-runs). Требует Claude Code v2.1.259 или позже | `claude -p --permission-prompts none "query"` |

117| `--plugin-dir` | Загрузить plugin из каталога или архива `.zip`, или несколько из [папки plugins](/docs/ru/plugins/create#load-a-directory-or-archive-for-one-session), только для этого сеанса. Каждый флаг принимает один путь. Повторите флаг для нескольких путей: `--plugin-dir A --plugin-dir B.zip`. Передача папки plugins требует Claude Code v2.1.265 или позже | `claude --plugin-dir ./my-plugin` |118| `--plugin-dir` | Загрузить plugin из каталога или архива `.zip`, или несколько из [папки plugins](/docs/ru/plugins/create#load-a-directory-or-archive-for-one-session), только для этого сеанса. Каждый флаг принимает один путь. Повторите флаг для нескольких путей: `--plugin-dir A --plugin-dir B.zip`. Передача папки plugins требует Claude Code v2.1.265 или позже | `claude --plugin-dir ./my-plugin` |

118| `--plugin-url` | Получить plugin архив `.zip` из URL только для этого сеанса. Повторите флаг для нескольких plugins, или передайте разделённые пробелом URL в одном значении в кавычках | `claude --plugin-url https://example.com/plugin.zip` |119| `--plugin-url` | Получить plugin архив `.zip` из URL только для этого сеанса. Повторите флаг для нескольких plugins, или передайте разделённые пробелом URL в одном значении в кавычках | `claude --plugin-url https://example.com/plugin.zip` |

119| `--print`, `-p` | Вывести ответ без интерактивного режима (см. [документацию Agent SDK](/docs/ru/agent-sdk/overview) для деталей программного использования) | `claude -p "query"` |120| `--print`, `-p` | Вывести ответ без интерактивного режима (см. [документацию Agent SDK](/docs/ru/agent-sdk/overview) для деталей программного использования). Для `--resume` на фоновом сеансе, который всё ещё работает, см. [Возобновить сеанс](/docs/ru/sessions#resume-a-running-background-session) | `claude -p "query"` |

120| `--prompt-suggestions` | Выдать сообщение `prompt_suggestion` с предсказанным следующим приглашением пользователя после каждого хода, который генерирует один; очень короткие беседы могут не производить ни одного. Требует `--print`, `--output-format stream-json` и `--verbose`. См. [Предложения приглашений](/docs/ru/interactive-mode#prompt-suggestions) | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |121| `--prompt-suggestions` | Выдать сообщение `prompt_suggestion` с предсказанным следующим приглашением пользователя после каждого хода, который генерирует один; очень короткие беседы могут не производить ни одного. Требует `--print`, `--output-format stream-json` и `--verbose`. См. [Предложения приглашений](/docs/ru/interactive-mode#prompt-suggestions) | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |

121| `--ref <branch>` | С `--environment`, основать новый checkout сеанса на именованном ref вместо локального `HEAD` | `claude -p "Run the smoke test" --environment ccpool_abc123 --ref main` |122| `--ref <branch>` | С `--environment`, основать новый checkout сеанса на именованном ref вместо локального `HEAD` | `claude -p "Run the smoke test" --environment ccpool_abc123 --ref main` |

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| `--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` |126| `--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"` |127| `--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` сеанса](/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| `--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`. Возобновление того, который всё ещё работает, [открывает этот сеанс](/docs/ru/sessions#resume-a-running-background-session) в этом терминале через `claude attach`, и приглашение, которое вы передаёте в командной строке, идёт ему как его следующий ход. До v2.1.285 Claude Code отказывал и выводил команду `claude attach` для запуска вместо этого | `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` |129| `--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` |

130| `--setting-sources` | Разделённый запятыми список источников параметров для загрузки (`user`, `project`, `local`). См. [agent view](/docs/ru/agent-view#what-carries-over-when-you-background) и [agent teams](/docs/ru/agent-teams#context-and-communication) для сеансов, которые вы запускаете из этого, которые наследуют список | `claude --setting-sources user,project` |131| `--setting-sources` | Разделённый запятыми список источников параметров для загрузки (`user`, `project`, `local`). См. [agent view](/docs/ru/agent-view#what-carries-over-when-you-background) и [agent teams](/docs/ru/agent-teams#context-and-communication) для сеансов, которые вы запускаете из этого, которые наследуют список | `claude --setting-sources user,project` |

cloud-environments.md +1 −1

Details

439 439

440* **Команды, которые запускает Claude**: облачная среда не устанавливает свой собственный timeout команды, поэтому применяются значения по умолчанию инструмента Bash. Claude ждёт 2 минуты для команды переднего плана по умолчанию и может запросить до 10 минут.440* **Команды, которые запускает Claude**: облачная среда не устанавливает свой собственный timeout команды, поэтому применяются значения по умолчанию инструмента Bash. Claude ждёт 2 минуты для команды переднего плана по умолчанию и может запросить до 10 минут.

441 441

442 Когда команда достигает своего [timeout](/docs/ru/tools-reference#timeout-and-output-limits), Claude Code [перемещает её в фон](/docs/ru/tools-reference#background-commands) вместо того, чтобы остановить её, если только команда не начинается с `sleep`. Команда, перемещённая таким образом, может продолжать работать до 30 дополнительных минут, прежде чем Claude Code остановит её в её [ограничении времени фона](/docs/ru/tools-reference#background-commands). Установка `BASH_DEFAULT_TIMEOUT_MS` выше `1800000` миллисекунд удлиняет это ограничение, а также значение по умолчанию переднего плана.442 Когда команда достигает своего [timeout](/docs/ru/tools-reference#timeout-and-output-limits), Claude Code [перемещает её в фон](/docs/ru/tools-reference#foreground-commands-that-move-to-the-background) вместо того, чтобы остановить её, если только команда не начинается с `sleep`. Команда, перемещённая таким образом, может продолжать работать до 30 дополнительных минут, прежде чем Claude Code остановит её в её [ограничении времени фона](/docs/ru/tools-reference#time-limit-for-background-commands). Установка `BASH_DEFAULT_TIMEOUT_MS` выше `1800000` миллисекунд удлиняет это ограничение, а также значение по умолчанию переднего плана.

443* **SessionStart hooks**: Claude Code отменяет hook `command` после 600 секунд, если вы не установите [`timeout`](/docs/ru/hooks#common-fields), в секундах, на запись hook. Claude Code не применяет timeout на hook, который вы запускаете с [`async: true`](/docs/ru/hooks#run-hooks-in-the-background).443* **SessionStart hooks**: Claude Code отменяет hook `command` после 600 секунд, если вы не установите [`timeout`](/docs/ru/hooks#common-fields), в секундах, на запись hook. Claude Code не применяет timeout на hook, который вы запускаете с [`async: true`](/docs/ru/hooks#run-hooks-in-the-background).

444* **Setup script**: скрипт, который занимает больше примерно пяти минут, не кэшируется. [Требования скрипта](#script-requirements) охватывает, как оставаться ниже этого.444* **Setup script**: скрипт, который занимает больше примерно пяти минут, не кэшируется. [Требования скрипта](#script-requirements) охватывает, как оставаться ниже этого.

445* **Idle sessions**: после нескольких минут без активности, VM сеанса приостанавливается с сохранёнными файлами, и приостановленная VM может позже быть восстановлена. [Установка переменных среды](#set-environment-variables) описывает, что сеанс подхватывает в каждом случае, и [Environment expired](/docs/ru/claude-code-on-the-web#environment-expired) охватывает, как повторно открыть сеанс, чей VM был восстановлен.445* **Idle sessions**: после нескольких минут без активности, VM сеанса приостанавливается с сохранёнными файлами, и приостановленная VM может позже быть восстановлена. [Установка переменных среды](#set-environment-variables) описывает, что сеанс подхватывает в каждом случае, и [Environment expired](/docs/ru/claude-code-on-the-web#environment-expired) охватывает, как повторно открыть сеанс, чей VM был восстановлен.

commands.md +1 −1

Details

132| `/remote-control` | Сделать эту сессию доступной для [Remote Control](/docs/ru/remote-control) из claude.ai. Запуск при выходе выводит, что Remote Control требует подписку claude.ai и говорит вам как войти; до версии 2.1.206 это сообщало `Unknown command: /remote-control`. Псевдоним: `/rc` |132| `/remote-control` | Сделать эту сессию доступной для [Remote Control](/docs/ru/remote-control) из claude.ai. Запуск при выходе выводит, что Remote Control требует подписку claude.ai и говорит вам как войти; до версии 2.1.206 это сообщало `Unknown command: /remote-control`. Псевдоним: `/rc` |

133| `/remote-env` | Выбрать [облачное окружение](/docs/ru/cloud-environments#select-an-environment-from-the-cli) по умолчанию для облачных сессий, которые вы запускаете из CLI |133| `/remote-env` | Выбрать [облачное окружение](/docs/ru/cloud-environments#select-an-environment-from-the-cli) по умолчанию для облачных сессий, которые вы запускаете из CLI |

134| `/rename [name]` | Переименовать текущую сессию и показать имя на строке подсказки. Без имени автоматически создаёт одно из истории разговора. Также доступно в неинтерактивном режиме (`-p`); требует Claude Code v2.1.205 или позже. Из каждой поверхности переименования, включая claude.ai и приложение рабочего стола, Claude Code заменяет управляющие и невидимые символы в новом имени пробелами и ограничивает имя 200 символами. Если имя пусто после удаления невидимых символов, Claude Code отклоняет его и показывает `That name is empty once invisible characters are removed. Usage: /rename <name>`. Замена символов и ограничение длины требуют Claude Code v2.1.221 или позже. Если другая живая сессия на этой машине уже использует имя, которое вы передаёте, Claude Code применяет [вариант его](/docs/ru/sessions#name-your-sessions) вместо этого |134| `/rename [name]` | Переименовать текущую сессию и показать имя на строке подсказки. Без имени автоматически создаёт одно из истории разговора. Также доступно в неинтерактивном режиме (`-p`); требует Claude Code v2.1.205 или позже. Из каждой поверхности переименования, включая claude.ai и приложение рабочего стола, Claude Code заменяет управляющие и невидимые символы в новом имени пробелами и ограничивает имя 200 символами. Если имя пусто после удаления невидимых символов, Claude Code отклоняет его и показывает `That name is empty once invisible characters are removed. Usage: /rename <name>`. Замена символов и ограничение длины требуют Claude Code v2.1.221 или позже. Если другая живая сессия на этой машине уже использует имя, которое вы передаёте, Claude Code применяет [вариант его](/docs/ru/sessions#name-your-sessions) вместо этого |

135| `/resume [session]` | Возобновить разговор по ID или имени или открыть средство выбора сессии. [Фоновые сессии](/docs/ru/agent-view) появляются в средстве выбора отмеченные с `bg`; одна, которая всё ещё работает, не может быть возобновлена здесь, поэтому прикрепитесь к ней из `claude agents` или остановите её там сначала. Псевдоним: `/continue` |135| `/resume [session]` | Возобновить разговор по ID или имени или открыть средство выбора сессии. [Фоновые сессии](/docs/ru/agent-view) появляются в средстве выбора отмеченные с `bg`. Возобновление одной, которая всё ещё работает, из средства выбора или по ID или имени, [открывает эту сессию](/docs/ru/sessions#resume-a-running-background-session): ваш текущий разговор переходит в фон и этот терминал прикрепляется к работающей. Нажмите `←` на пустой подсказке для возврата в представление агента, которое также перечисляет разговор, который вы оставили. До версии 2.1.285 Claude Code отказывал и говорил вам прикрепиться к сессии с `claude attach` или остановить её сначала. Псевдоним: `/continue` |

136| `/review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | Псевдоним [`/code-review`](/docs/ru/code-review#review-a-diff-locally): проверяет текущий diff или номер PR, ветку или путь, который вы передаёте, такой как `/review 1234`, и принимает те же уровни усилия и флаги. Без уровня, заданного, проверка повторно использует последний уровень `low` через `max`, который вы вводили; см. [Проверить diff локально](/docs/ru/code-review#review-a-diff-locally) для точных правил. Для глубокой облачной проверки используйте [`/code-review ultra`](/docs/ru/ultrareview). До версии 2.1.223 `/review` была отдельной командой, которая запускала однопроходную проверку только для чтения GitHub pull request по номеру, перечисляя открытые PR для выбора при запуске без аргумента; с v2.1.186 по v2.1.201 она запускала тот же многоагентный движок, что и `/code-review medium` |136| `/review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | Псевдоним [`/code-review`](/docs/ru/code-review#review-a-diff-locally): проверяет текущий diff или номер PR, ветку или путь, который вы передаёте, такой как `/review 1234`, и принимает те же уровни усилия и флаги. Без уровня, заданного, проверка повторно использует последний уровень `low` через `max`, который вы вводили; см. [Проверить diff локально](/docs/ru/code-review#review-a-diff-locally) для точных правил. Для глубокой облачной проверки используйте [`/code-review ultra`](/docs/ru/ultrareview). До версии 2.1.223 `/review` была отдельной командой, которая запускала однопроходную проверку только для чтения GitHub pull request по номеру, перечисляя открытые PR для выбора при запуске без аргумента; с v2.1.186 по v2.1.201 она запускала тот же многоагентный движок, что и `/code-review medium` |

137| `/rewind` | Перемотать разговор и/или код к предыдущей точке или суммировать из выбранного сообщения. См. [checkpointing](/docs/ru/checkpointing). Псевдонимы: `/checkpoint`, `/undo` |137| `/rewind` | Перемотать разговор и/или код к предыдущей точке или суммировать из выбранного сообщения. См. [checkpointing](/docs/ru/checkpointing). Псевдонимы: `/checkpoint`, `/undo` |

138| `/run` | **[Skill](/docs/ru/skills#bundled-skills).** Запустить и управлять приложением вашего проекта, чтобы увидеть работающее изменение, не только проходящие тесты. См. [Запустить и проверить ваше приложение](/docs/ru/skills#run-and-verify-your-app) |138| `/run` | **[Skill](/docs/ru/skills#bundled-skills).** Запустить и управлять приложением вашего проекта, чтобы увидеть работающее изменение, не только проходящие тесты. См. [Запустить и проверить ваше приложение](/docs/ru/skills#run-and-verify-your-app) |

desktop.md +8 −0

Details

967 967

968Чтобы переместить сеанс CLI в Desktop, запустите `/desktop` в терминале. Claude сохраняет ваш сеанс и открывает его в приложении desktop, затем выходит из CLI. Эта команда доступна на macOS и x64 Windows, когда вы вошли с подпиской Claude. Она недоступна при аутентификации по ключу API или на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry.968Чтобы переместить сеанс CLI в Desktop, запустите `/desktop` в терминале. Claude сохраняет ваш сеанс и открывает его в приложении desktop, затем выходит из CLI. Эта команда доступна на macOS и x64 Windows, когда вы вошли с подпиской Claude. Она недоступна при аутентификации по ключу API или на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry.

969 969

970Из вашей оболочки [`claude --desktop`](/docs/ru/cli-reference#cli-flags) открывает Desktop напрямую без запуска сеанса терминала. Это требует Claude Code v2.1.285 или позже и имеет те же требования к платформе и входу, что и `/desktop`. Без других аргументов он открывает Desktop в текущем каталоге. Чтобы открыть существующий сеанс CLI в Desktop, добавьте `--continue` для самого последнего разговора в этом каталоге или `--resume` с ID сеанса, который показывает `/status`:

971

972```bash theme={null}

973claude --desktop --resume <session-id>

974```

975

976Claude Code выводит `Opening session <session-id> in Claude Desktop`, сеанс открывается в приложении и команда завершается. Имя сеанса не работает вместо ID. Claude Code не перемещает сеанс, который открыт в другом терминале или всё ещё работает в фоне. Если Claude Desktop не установлен, команда выводит ссылку для загрузки и завершается.

977

970Вы также можете продолжить сеанс CLI из Desktop с помощью `/resume`. Команда доступна в локальных сеансах, но не в SSH, WSL или облачных сеансах.978Вы также можете продолжить сеанс CLI из Desktop с помощью `/resume`. Команда доступна в локальных сеансах, но не в SSH, WSL или облачных сеансах.

971 979

972Чтобы продолжить сеанс терминала в Desktop:980Чтобы продолжить сеанс терминала в Desktop:

errors.md +7 −5

Details

3657 Не удалось открыть Claude Desktop3657 Не удалось открыть Claude Desktop

3658</h3>3658</h3>

3659 3659

3660Вы запустили [`/desktop`](/docs/ru/desktop#coming-from-the-cli) или его псевдоним `/app`, и системная команда, которую Claude Code использует для открытия Claude Desktop, не прошла. Сеанс остаётся в терминале.3660Вы запустили [`/desktop`](/docs/ru/desktop#coming-from-the-cli) или его псевдоним `/app` в сеансе, или [`claude --desktop`](/docs/ru/cli-reference#cli-flags) в вашей оболочке, и системная команда Claude Code использует для открытия Claude Desktop не прошла. После `/desktop`, сеанс остаётся в терминале; `claude --desktop` выводит сообщение без префикса `Error:` и завершает работу со статусом 1.

3661

3662Текст в скобках указывает команду, которая не прошла, с её кодом выхода и первой строкой её вывода ошибки, когда она их выдала. На macOS эта команда — это `open`, как в этом примере; на Windows это `rundll32`:

3661 3663

3662```text theme={null}3664```text theme={null}

3663Error: Couldn't open Claude Desktop (`open` exited 1: LSOpenURLsWithRole() failed for the URL claude://resume?session=<session-id> with error -10814). Open Claude Desktop and run /desktop again.3665Error: Couldn't open Claude Desktop (`open` exited 1: LSOpenURLsWithRole() failed for the URL claude://resume?session=<session-id> with error -10814). Open Claude Desktop and try again.

3664```3666```

3665 3667

3666**Что делать:**3668**Что делать:**

3667 3669

3668* Откройте Claude Desktop самостоятельно, затем запустите `/desktop` снова3670* Откройте Claude Desktop самостоятельно, затем запустите `/desktop` или `claude --desktop` снова

3669* Чтобы прочитать полный вывод ошибки этой команды, включите отладочное логирование с `/debug`, запустите `/desktop` снова и проверьте журнал отладки3671* Чтобы прочитать полный вывод ошибки этой команды, включите отладочное логирование с `/debug` и запустите `/desktop` снова, или запустите `claude --desktop --debug-file <path>`, затем проверьте журнал отладки

3670 3672

3671До версии v2.1.275 сообщение было `Failed to open Claude Desktop. Please try opening it manually.` и не говорило, что не прошло.3673До версии v2.1.285 сообщение заканчивалось `Open Claude Desktop and run /desktop again.` До версии v2.1.275 это было `Failed to open Claude Desktop. Please try opening it manually.` и не говорило, что не прошло.

3672 3674

3673<h3 id="terminal-setup-left-your-zed-keymap-unchanged">3675<h3 id="terminal-setup-left-your-zed-keymap-unchanged">

3674 /terminal-setup оставил вашу Zed keymap без изменений3676 /terminal-setup оставил вашу Zed keymap без изменений

interactive-mode.md +3 −5

Details

346* Попросить Claude Code запустить команду в фоне346* Попросить Claude Code запустить команду в фоне

347* Нажать `Ctrl+B` для перемещения обычного вызова инструмента Bash в фон. Пользователи Tmux должны нажать `Ctrl+B` дважды из-за префиксного ключа tmux.347* Нажать `Ctrl+B` для перемещения обычного вызова инструмента Bash в фон. Пользователи Tmux должны нажать `Ctrl+B` дважды из-за префиксного ключа tmux.

348 348

349Когда команда достигает своего времени ожидания до завершения, Claude Code автоматически [перемещает её в фон](/docs/ru/tools-reference#background-commands) вместо остановки, если только команда не начинается с `sleep`. Чтобы изменить, как долго команды выполняются перед этим, установите [переменные окружения для времени ожидания Bash](/docs/ru/tools-reference#timeout-and-output-limits).349Когда команда достигает своего времени ожидания до завершения, Claude Code автоматически [перемещает её в фон](/docs/ru/tools-reference#foreground-commands-that-move-to-the-background) вместо остановки, если только команда не начинается с `sleep`. Чтобы изменить, как долго команды выполняются перед этим, установите [переменные окружения для времени ожидания Bash](/docs/ru/tools-reference#timeout-and-output-limits).

350 350

351**Ключевые возможности:**351**Ключевые возможности:**

352 352

358* На macOS и Linux Claude Code останавливает ваши работающие фоновые задачи, когда операционная система сообщает о критическом давлении памяти, при условии, что сеанс был неактивен не менее 30 минут и не выполняется ни один ход или подагент. Требуется Claude Code v2.1.193 или позже358* На macOS и Linux Claude Code останавливает ваши работающие фоновые задачи, когда операционная система сообщает о критическом давлении памяти, при условии, что сеанс был неактивен не менее 30 минут и не выполняется ни один ход или подагент. Требуется Claude Code v2.1.193 или позже

359 * [Журнал отладки](/docs/ru/debug-your-config) указывает, почему задачи были остановлены или почему событие давления оставило их работающими359 * [Журнал отладки](/docs/ru/debug-your-config) указывает, почему задачи были остановлены или почему событие давления оставило их работающими

360 * Установите [`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`](/docs/ru/env-vars) в `1`, чтобы отключить остановки из-за давления памяти360 * Установите [`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`](/docs/ru/env-vars) в `1`, чтобы отключить остановки из-за давления памяти

361* Фоновые команды Bash и PowerShell имеют ограничение по времени, отсчитываемое с момента входа команды в фон: 30 минут или `timeout`, который Claude запрашивает при запуске команды в фоне, до максимума 2 часов. Команда, которая переходит в фон во время выполнения, например с `Ctrl+B`, получает 30 минут с момента перемещения. Когда команда достигает своего лимита, Claude Code останавливает её и сообщает Claude причину, и Claude может запустить её снова с более длительным `timeout`, если работа всё ещё необходима. Две переменные окружения повышают лимиты в миллисекундах, и ни одна из них не может их сократить:361* Фоновые команды Bash и PowerShell имеют ограничение по времени, отсчитываемое с момента входа команды в фон: 30 минут или `timeout`, который Claude запрашивает при запуске команды в фоне, до максимума 2 часов. Команда, которая переходит в фон во время выполнения, например с `Ctrl+B`, получает 30 минут с момента перемещения. Когда команда достигает своего лимита, Claude Code останавливает её и сообщает Claude причину, и Claude может запустить её снова с более длительным `timeout`, если работа всё ещё необходима. Чтобы увеличить лимиты, см. [Повышение временного лимита для фоновых команд](/docs/ru/tools-reference#raise-the-time-limit-for-background-commands) в справочнике инструментов

362 * Установите [`BASH_DEFAULT_TIMEOUT_MS`](/docs/ru/env-vars) выше `1800000`, чтобы заменить 30-минутное значение по умолчанию этим значением для перемещённых команд также362* Фоновая команда, запущенная переднеплановым [подагентом](/docs/ru/sub-agents#run-subagents-in-foreground-or-background), заканчивается, когда заканчивается выполнение этого подагента, независимо от того, завершилась ли она, не удалась или была прервана; см. [Когда фоновая команда останавливается](/docs/ru/tools-reference#when-a-background-command-stops) в справочнике инструментов

363 * Установите [`BASH_MAX_TIMEOUT_MS`](/docs/ru/env-vars) выше `7200000`, чтобы повысить максимум 2 часов. Установка `BASH_DEFAULT_TIMEOUT_MS` выше `7200000` повышает его таким же образом

364* Фоновая команда, запущенная переднеплановым [подагентом](/docs/ru/sub-agents#run-subagents-in-foreground-or-background), заканчивается, когда заканчивается выполнение этого подагента, независимо от того, завершилась ли она, не удалась или была прервана; см. [Фоновые команды](/docs/ru/tools-reference#background-commands) в справочнике инструментов

365 363

366Чтобы отключить всю функциональность фоновых задач, установите переменную окружения `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` в `1`. См. [Переменные окружения](/docs/ru/env-vars) для получения подробной информации.364Чтобы отключить всю функциональность фоновых задач, установите переменную окружения `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` в `1`. См. [Переменные окружения](/docs/ru/env-vars) для получения подробной информации.

367 365

plugins/cli-reference.md +36 −2

Details

29Каждая подкоманда имеет эти коды выхода, аргументы плагина и значения области действия:29Каждая подкоманда имеет эти коды выхода, аргументы плагина и значения области действия:

30 30

31* **Коды выхода**: `0` при успехе и `1` при ошибке. `validate` добавляет выход `2` для неожиданной ошибки, а `eval` добавляет коды, указанные в [его разделе](#plugin-eval).31* **Коды выхода**: `0` при успехе и `1` при ошибке. `validate` добавляет выход `2` для неожиданной ошибки, а `eval` добавляет коды, указанные в [его разделе](#plugin-eval).

32* **Аргументы плагина**: аргумент `<plugin>` — это `name` плагина или `name@marketplace`. Когда два маркетплейса предлагают одно и то же имя, используйте квалифицированную форму.32* **Аргументы плагина**: аргумент `<plugin>` — это `name` плагина или `name@marketplace`. Когда два маркетплейса предлагают одно и то же имя, используйте квалифицированную форму. `configure` принимает только квалифицированную форму.

33* **Области действия**: `--scope` принимает `user`, `project` или `local`, и называет файл параметров, в который команда записывает. `update` также принимает `managed`.33* **Области действия**: `--scope` принимает `user`, `project` или `local`, и называет файл параметров, в который команда записывает. `update` также принимает `managed`.

34 34

35<h3 id="plugin-init">35<h3 id="plugin-init">

87| Флаг | Описание |87| Флаг | Описание |

88| :- | :- |88| :- | :- |

89| `-s, --scope <scope>` | Область действия установки: `user`, `project` или `local`. По умолчанию `user` |89| `-s, --scope <scope>` | Область действия установки: `user`, `project` или `local`. По умолчанию `user` |

90| `--config <key=value>` | Установите опцию [`userConfig`](/docs/ru/plugins/manifest-reference), которую объявляет манифест плагина. Повторите флаг для каждой опции. Требует Claude Code v2.1.147 или позже |90| `--config <key=value>` | Установите опцию [`userConfig`](/docs/ru/plugins/manifest-reference), которую объявляет манифест плагина. Повторите флаг для каждой опции. Требует Claude Code v2.1.147 или позже. Ключ, написанный как `<server>.<key>`, устанавливает параметр, который [упакованный MCP сервер](/docs/ru/plugins/components#include-a-packaged-mcpb-server) объявляет в своём собственном `user_config` вместо этого, для файла пакета, поставляемого внутри плагина. Форма `<server>.<key>` требует Claude Code v2.1.285 или позже |

91| `-y, --yes` | Примите отображаемую команду установки без запроса `Run this command now?`. Игнорируется, когда команда запускается внутри сеанса Claude Code, например из инструмента Bash или hook. Требует Claude Code v2.1.229 или позже |91| `-y, --yes` | Примите отображаемую команду установки без запроса `Run this command now?`. Игнорируется, когда команда запускается внутри сеанса Claude Code, например из инструмента Bash или hook. Требует Claude Code v2.1.229 или позже |

92| `--accept-command <sha256>` | Примите отображаемую команду установки, чей `sha256` предыдущий запуск [`--json`](#plugin-json-result) сообщил в `shownCommand`, вместо `-y`. Не может быть объединён с `-y`. См. [Принять отображаемую команду установки](#accept-a-displayed-install-command). Требует Claude Code v2.1.271 или позже |92| `--accept-command <sha256>` | Примите отображаемую команду установки, чей `sha256` предыдущий запуск [`--json`](#plugin-json-result) сообщил в `shownCommand`, вместо `-y`. Не может быть объединён с `-y`. См. [Принять отображаемую команду установки](#accept-a-displayed-install-command). Требует Claude Code v2.1.271 или позже |

93| `--json` | Выведите результат как один JSON объект на последней строке stdout вместо читаемого сообщения для использования в скриптах. См. [Формат результата JSON](#plugin-json-result). Требует Claude Code v2.1.268 или позже |93| `--json` | Выведите результат как один JSON объект на последней строке stdout вместо читаемого сообщения для использования в скриптах. См. [Формат результата JSON](#plugin-json-result). Требует Claude Code v2.1.268 или позже |

297| :- | :- |297| :- | :- |

299| `--available` | Также выведите плагины, которые предлагают ваши маркетплейсы, но которые вы не установили. Не имеет эффекта без `--json` |299| `--available` | Также выведите плагины, которые предлагают ваши маркетплейсы, но которые вы не установили. Не имеет эффекта без `--json` |

300| `--data-size [plugin]` | Измерьте каталог сохранённых данных каждого установленного плагина [saved data directory](#what-an-uninstall-deletes-and-keeps), или только названного плагина, указанного как `name@marketplace`. Не имеет эффекта без `--json`. Если имя не имеет записи об установке, команда выводит `--data-size names a plugin that is not installed` и выходит с кодом `1` вместо вывода списка. Требует Claude Code v2.1.285 или позже |

300 301

301Claude Code группирует читаемый выход по тому, как загружается каждый плагин:302Claude Code группирует читаемый выход по тому, как загружается каждый плагин:

302 303

329| `errorDetails` | array of objects | Один объект на запись `errors`, дающий его диагностический `type` и имена, на которые он ссылается, такие как плагин, маркетплейс, сервер или файл. Требует Claude Code v2.1.268 или позже |330| `errorDetails` | array of objects | Один объект на запись `errors`, дающий его диагностический `type` и имена, на которые он ссылается, такие как плагин, маркетплейс, сервер или файл. Требует Claude Code v2.1.268 или позже |

332| `hasUserConfig` | boolean | Присутствует и `true`, когда плагин загрузился и его манифест объявляет опции [`userConfig`](/docs/ru/plugins/manifest-reference#user-configuration). Отсутствует для плагина, который не загрузился, независимо от того, что объявляет его манифест. Сохранённые значения никогда не включаются. Требует Claude Code v2.1.285 или позже |

333| `projectEnabled` | boolean | Включает ли общий файл `.claude/settings.json` проекта плагин. Только установки маркетплейса. Требует Claude Code v2.1.285 или позже |

334| `dataDirSize` | object | С `--data-size`, размер каталога сохранённых данных плагина [saved data directory](#what-an-uninstall-deletes-and-keeps) как `bytes` и `human`; отсутствует, когда каталог отсутствует или пуст. Только установки маркетплейса. Требует Claude Code v2.1.285 или позже |

335| `dataDirUnreadable` | boolean | С `--data-size`, `true`, когда каталог сохранённых данных существует, но не мог быть измерен. Только установки маркетплейса. Требует Claude Code v2.1.285 или позже |

331 336

332С `--json --available` Claude Code выводит один объект вместо массива. Его поле `installed` содержит массив объектов установленных плагинов, а его поле `available` содержит один объект на неустановленный плагин маркетплейса с полями ниже.337С `--json --available` Claude Code выводит один объект вместо массива. Его поле `installed` содержит массив объектов установленных плагинов, а его поле `available` содержит один объект на неустановленный плагин маркетплейса с полями ниже.

333 338

371 376

372Для плагина, который не загружен, Claude Code выводит ``Plugin "formatter" not found. Run `claude plugin list` to see installed plugins, or pass --plugin-dir <path> to load one from disk.`` и выходит с кодом `1`.377Для плагина, который не загружен, Claude Code выводит ``Plugin "formatter" not found. Run `claude plugin list` to see installed plugins, or pass --plugin-dir <path> to load one from disk.`` и выходит с кодом `1`.

373 378

379<h3 id="plugin-configure">

380 plugin configure

381</h3>

382

383Покажите опции [`userConfig`](/docs/ru/plugins/manifest-reference#user-configuration) установленного плагина и какие из них установлены, или сохраните значения, переданные на stdin. Требует Claude Code v2.1.285 или позже.

384

385```bash theme={null}

386claude plugin configure <plugin>

387```

388

389| Флаг | Описание |

390| :- | :- |

391| `--values-stdin` | Прочитайте значения опций из stdin как JSON объект однострочных строк и сохраните их. Опции, которые вы оставляете, сохраняют свои сохранённые значения |

392| `--json` | Выведите результат как один JSON объект на stdout. Без `--values-stdin` объект содержит `schema` и `choices` опций, их начальные `inputs` и имена `configured` и `unconfigured` опций. С `--values-stdin` он содержит имена `saved` опций и, когда они могут быть прочитаны обратно, имена `unconfigured` |

393

394Без флагов команда выводит список каждой опции с до трёх ярлыков: `required` или `optional`, затем `sensitive` для опции, которую манифест объявляет чувствительной, затем `set` или `not set`. Она не выводит сохранённые значения. С `--json` выходные данные включают сохранённые значения опций, которые не чувствительны, и никогда текст чувствительной.

395

396Чтобы сохранить значения, запишите их в файл как JSON объект, который отображает ключи опций на строковые значения, затем передайте файл на stdin. Замените `formatter@my-marketplace` на id вашего собственного плагина, как показывает `claude plugin list`. Этот пример устанавливает одну опцию с именем `api_url` из файла `values.json`, который содержит `{"api_url": "https://example.com"}`:

397

398```bash theme={null}

399claude plugin configure formatter@my-marketplace --values-stdin < values.json

400```

401

402Claude Code проверяет каждое значение против объявленного типа опции и выводит `Configuration saved. Restart Claude Code to apply it.` Если вы передаёте ключ, который манифест не объявляет, или значение, которое не проходит проверку, команда ничего не сохраняет, выводит `Failed to save configuration:` с причиной и выходит с кодом `1`. С `--json` отклонённое значение также выводит объект на stdout, чьё поле `refused` содержит `message` и, когда одна опция виновата, её ключ `option`.

403

404Передайте полный id плагина `name@marketplace`, как показывает `claude plugin list`. `configure` не принимает простое `name`. Когда ни один загруженный плагин не имеет этот id, команда выводит `No installed plugin has the id "<plugin>".` и выходит с кодом `1`.

405

406Для параметров упакованного MCP сервера см. [`plugin install --config`](#plugin-install) или элемент **Configure** в `/plugin`.

407

374<h3 id="plugin-prune">408<h3 id="plugin-prune">

375 plugin prune409 plugin prune

376</h3>410</h3>

plugins/components.md +13 −2

Details

868 868

869Сервер берёт своё имя из `name` в манифесте пакета.869Сервер берёт своё имя из `name` в манифесте пакета.

870 870

871Пакет собственного манифеста может объявлять параметры, которые серверу нужны от пользователя в блоке `user_config`. Упакованный сервер с требуемым параметром, который не имеет сохранённого значения, не запускается. На вкладке **Errors** в `/plugin` показывается `Bundled MCP server "<name>" was not started: it needs configuration`.

872

873Пользователи предоставляют значения одним из двух способов:

874

875* **В `/plugin`**: выберите плагин на вкладке **Installed** и выберите **Configure**

876* **При установке из оболочки**: передайте [`--config <server>.<key>=<value>`](/docs/ru/plugins/cli-reference#plugin-install) в `claude plugin install`. Требуется Claude Code v2.1.285 или позже, и работает только для пакета, упакованного внутри плагина.

877

871Для транспортов и аутентификации см. [MCP](/docs/ru/mcp#plugin-provided-mcp-servers).878Для транспортов и аутентификации см. [MCP](/docs/ru/mcp#plugin-provided-mcp-servers).

872 879

873<h3 id="lsp-servers">880<h3 id="lsp-servers">

1071 Когда появляется диалог конфигурации1078 Когда появляется диалог конфигурации

1072</h3>1079</h3>

1073 1080

1074Диалог появляется только в интерактивном интерфейсе `/plugin`. Он открывается для любого варианта, который ещё не установлен, когда пользователь делает любое из следующего:1081Диалог является частью интерактивного интерфейса `/plugin`. Когда пользователь делает любое из следующего, он открывается для любого варианта, который ещё не установлен:

1075 1082

1076* Устанавливает плагин в `/plugin`1083* Устанавливает плагин в `/plugin`

1077* Запускает `/plugin install <plugin>@<marketplace>` внутри сессии1084* Запускает `/plugin install <plugin>@<marketplace>` внутри сессии

1079 1086

1080Чтобы открыть тот же диалог в любое время, пользователь запускает `/plugin configure <plugin>@<marketplace>`.1087Чтобы открыть тот же диалог в любое время, пользователь запускает `/plugin configure <plugin>@<marketplace>`.

1081 1088

1082Команда оболочки `claude plugin install` никогда не запрашивает значения `userConfig`. Чтобы установить значения из оболочки, передайте каждое как `--config KEY=VALUE`. Когда варианты остаются неустановленными, команда выводит строку `userConfig options not yet set`, которая называет оба способа их установки. [The `userConfig` dialog never appears](/docs/ru/plugins/troubleshooting#the-userconfig-dialog-never-appears) цитирует строку.1089Диалог управления плагинами VS Code [Manage plugins dialog](/docs/ru/vs-code#install-plugins) запрашивает неустановленные варианты в виде формы после установки, и значок шестерёнки в строке плагина открывает форму снова со всеми вариантами.

1090

1091Команда оболочки `claude plugin install` никогда не запрашивает значения `userConfig`. Чтобы установить значения из оболочки, передайте каждое как `--config KEY=VALUE` при установке, или передайте объект JSON в [`claude plugin configure --values-stdin`](/docs/ru/plugins/cli-reference#plugin-configure) после этого.

1092

1093Когда варианты остаются неустановленными, `claude plugin install` выводит строку `userConfig options not yet set`. Для точного текста строки см. [The `userConfig` dialog never appears](/docs/ru/plugins/troubleshooting#the-userconfig-dialog-never-appears).

1083 1094

1084Для полей варианта, где хранится каждое значение, как компонент ссылается на сохранённое значение и какие поля отклоняют `${user_config.*}`, см. [User configuration](/docs/ru/plugins/manifest-reference#user-configuration).1095Для полей варианта, где хранится каждое значение, как компонент ссылается на сохранённое значение и какие поля отклоняют `${user_config.*}`, см. [User configuration](/docs/ru/plugins/manifest-reference#user-configuration).

1085 1096

plugins/install.md +8 −2

Details

72 Последнее предложение сводки говорит вам, доступен ли плагин в этой сессии прямо сейчас:72 Последнее предложение сводки говорит вам, доступен ли плагин в этой сессии прямо сейчас:

73 73

74 * **Active now**: `Plugin is now active.` Перезагрузка не требуется.74 * **Active now**: `Plugin is now active.` Перезагрузка не требуется.

75 * **Active, but a server needs setup**: `Plugin is now active.` сопровождается `Its bundled MCP server needs configuration before it can start`. [Bundled MCP server](/docs/ru/plugins/components#include-a-packaged-mcpb-server) плагина не может запуститься, пока вы не установите его параметры. Выберите плагин на вкладке **Installed** в `/plugin` и выберите **Configure**, чтобы установить параметры сервера.

75 * **Reload needed**: `Run /reload-plugins to activate.` Панель закрывается и Claude Code запускает эту перезагрузку для вас. Если перезагрузка [инвалидирует кэш подсказок](/docs/ru/prompt-caching#enabling-or-disabling-a-plugin), она предупреждает и оставляет плагин в ожидании. Запустите `/reload-plugins --force`, чтобы активировать его в любом случае, что стоит один некэшированный запрос.76 * **Reload needed**: `Run /reload-plugins to activate.` Панель закрывается и Claude Code запускает эту перезагрузку для вас. Если перезагрузка [инвалидирует кэш подсказок](/docs/ru/prompt-caching#enabling-or-disabling-a-plugin), она предупреждает и оставляет плагин в ожидании. Запустите `/reload-plugins --force`, чтобы активировать его в любом случае, что стоит один некэшированный запрос.

76 * **Load failed**: `The plugin couldn't be loaded`. Откройте вкладку **Errors** в `/plugin`, чтобы узнать причину, затем см. [After install: plugin not working](/docs/ru/plugins/troubleshooting#plugin-installed-but-not-working).77 * **Load failed**: `The plugin couldn't be loaded`. Откройте вкладку **Errors** в `/plugin`, чтобы узнать причину, затем см. [After install: plugin not working](/docs/ru/plugins/troubleshooting#plugin-installed-but-not-working).

77 </Step>78 </Step>

248Приватный маркетплейс — это один в репозитории, для которого вам нужны учётные данные для клонирования, на GitHub или любом другом хосте git. Вы добавляете его с помощью той же команды `/plugin marketplace add` или `claude plugin marketplace add`, что и публичный. Claude Code клонирует его с учётными данными git, уже находящимися на вашей машине, и никогда не запрашивает, поэтому каждый способ подключения имеет требование:249Приватный маркетплейс — это один в репозитории, для которого вам нужны учётные данные для клонирования, на GitHub или любом другом хосте git. Вы добавляете его с помощью той же команды `/plugin marketplace add` или `claude plugin marketplace add`, что и публичный. Claude Code клонирует его с учётными данными git, уже находящимися на вашей машине, и никогда не запрашивает, поэтому каждый способ подключения имеет требование:

249 250

250* **HTTPS**: применяются ваши помощники учётных данных git, поэтому доступ, который вы установили с помощью `gh auth login`, macOS Keychain или `git-credential-store`, работает. Интерактивные запросы подавляются, поэтому хост, к которому вы никогда не аутентифицировались, не удаётся вместо запроса пароля.251* **HTTPS**: применяются ваши помощники учётных данных git, поэтому доступ, который вы установили с помощью `gh auth login`, macOS Keychain или `git-credential-store`, работает. Интерактивные запросы подавляются, поэтому хост, к которому вы никогда не аутентифицировались, не удаётся вместо запроса пароля.

251* **SSH**: хост должен уже находиться в вашем файле `known_hosts` и ключ должен работать без запроса парольной фразы, потому что запросы отпечатка хоста и парольной фразы также подавляются.252* **SSH**: хост должен уже находиться в вашем файле `known_hosts` и ключ должен работать без запроса парольной фразы. Если ваша настройка git называет программу SSH в `GIT_SSH_COMMAND`, `GIT_SSH` или `core.sshCommand` конфигурации git, Claude Code запускает эту программу.

252* **Сокращение GitHub `owner/repo`**: Claude Code проверяет, аутентифицирует ли ваш ключ SSH на `github.com`, затем клонирует по SSH, если это так, и по HTTPS, если нет. Установите [`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1`](/docs/ru/env-vars#variables), чтобы пропустить эту проверку и всегда клонировать по HTTPS.253* **Сокращение GitHub `owner/repo`**: Claude Code проверяет, аутентифицирует ли ваш ключ SSH на `github.com`, затем клонирует по SSH, если это так, и по HTTPS, если нет. Установите [`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1`](/docs/ru/env-vars#variables), чтобы пропустить эту проверку и всегда клонировать по HTTPS.

253 254

254Те же учётные данные применяются, когда вы запускаете `/plugin install`, `/plugin marketplace update` и `claude plugin update`.255Те же учётные данные применяются, когда вы запускаете `/plugin install`, `/plugin marketplace update` и `claude plugin update`.

288 289

289* Введите для фильтрации по имени или описанию.290* Введите для фильтрации по имени или описанию.

290* Нажмите **Space**, чтобы включить или отключить выбранный плагин, и **f**, чтобы добавить его в избранное.291* Нажмите **Space**, чтобы включить или отключить выбранный плагин, и **f**, чтобы добавить его в избранное.

291* Нажмите **Enter**, чтобы открыть детали плагина. Меню там предлагает **Disable plugin** или **Enable plugin**, **Update now** и **Uninstall**. Плагины, которые принимают настройки, также предлагают **Configure options**.292* Нажмите **Enter**, чтобы открыть детали плагина.

293

294Меню деталей плагина предлагает **Disable plugin** или **Enable plugin**, **Update now** и **Uninstall**. Для плагинов, которые принимают настройки, появляются ещё два элемента, и плагин может показать оба:

295

296* **Configure options**: показывается, когда манифест плагина объявляет [параметры `userConfig`](/docs/ru/plugins/manifest-reference#user-configuration). Открывает диалог для этих параметров

297* **Configure**: показывается, когда плагин включает [упакованный MCP сервер](/docs/ru/plugins/components#include-a-packaged-mcpb-server). Устанавливает собственные параметры `user_config` этого сервера

292 298

293Вкладка также может показывать плагины в области **Managed**. Ваша организация установила их через [управляемые настройки](/docs/ru/settings#settings-files), и вы не можете включить, отключить или удалить их здесь.299Вкладка также может показывать плагины в области **Managed**. Ваша организация установила их через [управляемые настройки](/docs/ru/settings#settings-files), и вы не можете включить, отключить или удалить их здесь.

294 300

plugins/troubleshooting.md +40 −2

Details

201 201

202Успешное добавление выводит `Successfully added marketplace: <name>`.202Успешное добавление выводит `Successfully added marketplace: <name>`.

203 203

204<h3 id="invalid-git-url">

205 `Invalid git URL`

206</h3>

207

208Вы добавили маркетплейс, установили плагин или запустили обновление с адреса git, и команда не удалась с `Invalid git URL` в сообщении.

209

210Claude Code проверяет каждый адрес git перед запуском git. Он отказывает адресу, чей протокол он не поддерживает. Он также отказывает адресу, который git может прочитать как именование другого сервера или папки, чем тот, который показывает адрес.

211

212Текст после адреса называет, что изменить. Переведите адрес так, как говорит сообщение, и запустите команду снова.

213

214Отказ, который вместо этого говорит `is blocked by enterprise policy`, исходит из параметров вашей организации. См. [Источник маркетплейса заблокирован корпоративной политикой](#marketplace-source-is-blocked-by-enterprise-policy).

215

204<h3 id="path-does-not-exist">216<h3 id="path-does-not-exist">

205 `Path does not exist: <path>`217 `Path does not exist: <path>`

206</h3>218</h3>

410 422

411`claude plugin install` в вашей оболочке выводит другое сообщение. Для плагина, уже установленного в целевой области, он выводит `Plugin "<name>@<marketplace>" is already installed (scope: user)` и выходит с кодом 0. Если его каталог кэша отсутствует, та же команда повторно загружает его.423`claude plugin install` в вашей оболочке выводит другое сообщение. Для плагина, уже установленного в целевой области, он выводит `Plugin "<name>@<marketplace>" is already installed (scope: user)` и выходит с кодом 0. Если его каталог кэша отсутствует, та же команда повторно загружает его.

412 424

425<h3 id="plugin-would-share-its-folder">

426 `"<plugin>" was not installed: it would share its folder with "<other>"`

427</h3>

428

429Вы установили плагин через `claude plugin install`, `/plugin` или предложение установки в сеансе, и Claude Code отказал ему с этой строкой или с `would share its saved data with`.

430

431ID отказанного плагина и ID установленного плагина отображаются в одну и ту же папку на диске: они одинаковы, когда `.` и `@` записываются как `-`. На macOS и Windows ID, которые отличаются только заглавными буквами, также отображаются в одну и ту же папку. Установка обоих поместит файлы одного плагина в папку другого, поэтому Claude Code отказывает и установленный плагин сохраняет свои файлы.

432

433Сообщение называет способ выхода:

434

435* **Другой плагин установлен**: сообщение говорит `Only one of the two can be installed.` и называет команду `claude plugin uninstall` или шаг удаления в `/plugin`, который удаляет другой плагин. Запустите его, затем установите снова. Для того, что удаляет удаление, см. [Что удаление удаляет и сохраняет](/docs/ru/plugins/cli-reference#what-an-uninstall-deletes-and-keeps).

436* **Оба ID приходят в одну установку**, такие как плагин и зависимость, которая ему нужна: никакой порядок установки не помогает. Только разработчик маркетплейса, который содержит оба плагина, может исправить это, переименовав один из них. Когда два приходят из разных маркетплейсов, разработчик любого из них может.

437

413<h3 id="this-plugin-uses-a-source-type-your-claude-code-version-does-not-suppo">438<h3 id="this-plugin-uses-a-source-type-your-claude-code-version-does-not-suppo">

414 `This plugin uses a source type your Claude Code version does not support`439 `This plugin uses a source type your Claude Code version does not support`

415</h3>440</h3>

790* **`URL is unset or invalid`**: опция `${user_config.*}`, которую использует URL, не установлена. Запустите `/plugin configure <plugin>`, чтобы установить её815* **`URL is unset or invalid`**: опция `${user_config.*}`, которую использует URL, не установлена. Запустите `/plugin configure <plugin>`, чтобы установить её

791* **`has an invalid MCP url`** или **`headersHelper for MCP server '<server>' references ${user_config.*}`**: конфигурация самого плагина виновата. Исправьте `url` или `headersHelper` в конфигурации MCP вашего плагина или сообщите об этом автору плагина, если плагин не ваш. Случай `headersHelper` имеет свою собственную запись в разделе [команда плагина ссылается на user\_config](/docs/ru/errors#plugin-command-references-user-config)816* **`has an invalid MCP url`** или **`headersHelper for MCP server '<server>' references ${user_config.*}`**: конфигурация самого плагина виновата. Исправьте `url` или `headersHelper` в конфигурации MCP вашего плагина или сообщите об этом автору плагина, если плагин не ваш. Случай `headersHelper` имеет свою собственную запись в разделе [команда плагина ссылается на user\_config](/docs/ru/errors#plugin-command-references-user-config)

792 817

818<h4 id="bundled-mcp-server-name-was-not-started-it-needs-configuration">

819 `Bundled MCP server "<name>" was not started: it needs configuration`

820</h4>

821

822Плагин включает сервер как [MCPB bundle](/docs/ru/plugins/components#include-a-packaged-mcpb-server), который объявляет `user_config`, и требуемый параметр не имеет сохранённого значения или сохранённое значение не проходит собственную проверку bundle, поэтому Claude Code пропускает запуск сервера. Остальная часть плагина работает.

823

824Выберите плагин на вкладке **Installed** в `/plugin` и выберите **Configure**, чтобы предоставить значения. После сохранения `/plugin` показывает `Configuration saved.` и закрывается, и Claude Code перезагружает плагины, как описано в разделе [Управление установленными плагинами](/docs/ru/plugins/install#manage-installed-plugins). Сервер запускается после применения этой перезагрузки. До v2.1.285 Claude Code пропускал сервер без отображения этой строки.

825

793<h4 id="server-is-configured-but-never-connects">826<h4 id="server-is-configured-but-never-connects">

794 Сервер настроен, но никогда не подключается827 Сервер настроен, но никогда не подключается

795</h4>828</h4>

934 967

935Ваш плагин объявляет опции `userConfig`, но диалог конфигурации не появляется при его установке.968Ваш плагин объявляет опции `userConfig`, но диалог конфигурации не появляется при его установке.

936 969

937Интерактивная установка показывает диалог, и команда оболочки принимает значения как флаги вместо этого:970Появляется ли диалог при установке, зависит от того, где вы его запускаете:

938 971

939* **`/plugin install` в сеансе или вкладка Discover в `/plugin`**: диалог является частью этой интерактивной установки972* **`/plugin install` в сеансе или вкладка Discover в `/plugin`**: диалог является частью этой интерактивной установки

973* **Диалог управления плагинами расширения VS Code**: запрашивает неустановленные опции как форму после установки. До v2.1.285 установка там не показывала форму опций, поэтому установите значения из сеанса терминала с помощью `/plugin configure <plugin>@<marketplace>`

940* **`claude plugin install` в вашей оболочке**: никогда не запрашивает значения `userConfig`. Он сохраняет любые значения `--config KEY=VALUE`, которые вы передаёте, и когда опции остаются неустановленными, он выводит `N userConfig options not yet set — run /plugin configure <plugin>@<marketplace> in Claude Code, or pass --config KEY=VALUE.` Когда любая из неустановленных опций требуется, `(M required)` следует за `not yet set`.974* **`claude plugin install` в вашей оболочке**: никогда не запрашивает значения `userConfig`. Он сохраняет любые значения `--config KEY=VALUE`, которые вы передаёте, и когда опции остаются неустановленными, он выводит `N userConfig options not yet set — run /plugin configure <plugin>@<marketplace> in Claude Code, or pass --config KEY=VALUE.` Когда любая из неустановленных опций требуется, `(M required)` следует за `not yet set`.

941 975

942Если вы установили из оболочки, передайте значения с `--config`, один флаг на опцию:976Если вы установили из оболочки, передайте значения с `--config`, один флаг на опцию:

945claude plugin install my-plugin@my-marketplace --config api_url=https://example.com979claude plugin install my-plugin@my-marketplace --config api_url=https://example.com

946```980```

947 981

948Когда каждая опция установлена, вывод установки не содержит строку `not yet set`. Чтобы открыть диалог позже вместо этого, запустите `/plugin configure my-plugin@my-marketplace` в сеансе.982Когда каждая опция установлена, вывод установки не содержит строку `not yet set`.

983

984Чтобы открыть диалог позже вместо этого, запустите `/plugin configure my-plugin@my-marketplace` в сеансе. Из оболочки, [`claude plugin configure`](/docs/ru/plugins/cli-reference#plugin-configure) показывает, какие опции всё ещё не установлены, и сохраняет значения, переданные в stdin. Это требует Claude Code v2.1.285 или позже.

949 985

950Если вы передаёте ключ `--config`, который манифест не объявляет, плагин всё ещё устанавливается, и команда выводит `⚠ Installed, but --config not applied: --config key "<key>" isn't declared in this plugin's userConfig.` за которым следуют ключи, которые плагин объявляет.986Если вы передаёте ключ `--config`, который манифест не объявляет, плагин всё ещё устанавливается, и команда выводит `⚠ Installed, but --config not applied: --config key "<key>" isn't declared in this plugin's userConfig.` за которым следуют ключи, которые плагин объявляет.

951 987

988Для плагина, который поставляет [файл пакета MCPB](/docs/ru/plugins/components#include-a-packaged-mcpb-server), объявляющий `user_config` собственный, сообщение читается `isn't declared in this plugin's userConfig or by its bundled MCP servers.` вместо этого, и известные ключи включают ключи этого сервера, написанные `<server>.<key>`. Пакет, на который манифест ссылается по URL, не читается во время установки, поэтому его ключи не указаны и сообщение говорит настроить его в `/plugin`. Установка ключей `<server>.<key>` требует Claude Code v2.1.285 или позже.

989

952<h3 id="claude-plugin-validate-reports-errors">990<h3 id="claude-plugin-validate-reports-errors">

953 `claude plugin validate` сообщает об ошибках991 `claude plugin validate` сообщает об ошибках

954</h3>992</h3>

sessions.md +20 −2

Details

29 29

30`claude --continue` открывает [фоновый сеанс](/docs/ru/agent-view), который завершился, но не тот, который всё ещё выполняется; открытие завершённых фоновых сеансов требует Claude Code v2.1.257 или более поздней версии. Если ваш самый последний диалог — это тот, который вы [переместили в фон](/docs/ru/agent-view#send-the-session-to-the-background), и он всё ещё выполняется там, Claude Code завершается с сообщением `Your most recent conversation is running in the background` и ID этого сеанса. Подключитесь к сеансу из [`claude agents`](/docs/ru/agent-view#attach-to-a-session) или запустите `claude --resume`, чтобы выбрать другой.30`claude --continue` открывает [фоновый сеанс](/docs/ru/agent-view), который завершился, но не тот, который всё ещё выполняется; открытие завершённых фоновых сеансов требует Claude Code v2.1.257 или более поздней версии. Если ваш самый последний диалог — это тот, который вы [переместили в фон](/docs/ru/agent-view#send-the-session-to-the-background), и он всё ещё выполняется там, Claude Code завершается с сообщением `Your most recent conversation is running in the background` и ID этого сеанса. Подключитесь к сеансу из [`claude agents`](/docs/ru/agent-view#attach-to-a-session) или запустите `claude --resume`, чтобы выбрать другой.

31 31

32<span id="resume-a-running-background-session" />

34Когда диалог, который вы возобновляете с помощью `claude --resume` или `/resume`, принадлежит [фоновому сеансу](/docs/ru/agent-view), который всё ещё выполняется, Claude Code открывает сам выполняющийся сеанс. С флагом `--bg` в командной строке возобновление является [фоновой отправкой](/docs/ru/agent-view#from-your-shell) вместо этого. До версии 2.1.285 Claude Code отказывал и говорил вам открыть сеанс с помощью `claude attach <id>` или сначала остановить его с помощью `claude stop <id>`.

36* **Из вашей оболочки**: `claude --resume <session>` запускает [`claude attach`](/docs/ru/agent-view#attach-to-a-session) на этом сеансе в том же терминале вместо загрузки самой стенограммы. Приглашение, которое вы передаёте в командной строке, как в `claude --resume <session> "check the tests too"`, идёт в сеанс как его следующий ход в первую очередь, и Claude Code выводит `Sent your prompt to the background session (<id>); opening it…` перед подключением. `claude -p --resume <session> "prompt"`, введённый в терминал, делает то же самое, поэтому `-p` не сохраняет этот запуск неинтерактивным.

38 Claude Code не открывает сеанс, когда командная строка содержит любое из следующего:

40 * Перенаправленный или перенаправленный ввод или вывод

41 * Флаги, которые конфигурируют сеанс, такие как `--permission-mode`, `--model` или `--settings`

42 * Флаги, которые читают вывод, такие как `--output-format json` или `--json-schema`

43 * Флаги, которые ограничивают или перематывают запуск, такие как `--max-turns` или `--max-budget-usd`

45 С любым из этих, или когда [представление agent отключено](/docs/ru/agent-view#turn-off-agent-view), Claude Code ничего не отправляет и выходит со статусом 1, выводя, что сеанс выполняется в фоне вместе с командой `claude attach <id>`, которая его открывает, или говоря вам найти его в `claude agents`, когда он не может определить ID. Добавьте `--fork-session`, чтобы возобновить копию диалога вместо этого. Чтобы продолжить сам диалог в сеансе вашего собственного, с применением ваших флагов, запустите `claude stop <id>` и затем повторите команду.

47 Приглашение, которое начинается с `/` или `!`, не отправляется, и ни одно приглашение, пока сеанс ждёт вашего ответа на вопрос. В обоих случаях Claude Code не открывает сеанс, и сообщение включает `Your prompt was not sent to it` с причиной.

48* **Из внутри сеанса**: `/resume` перемещает ваш текущий диалог в фон и подключает этот терминал к выполняющемуся сеансу, выводя `Opening "<title>", running in the background (<id>)`. Нажмите `←` на пустом приглашении, чтобы вернуться к представлению agent, которое также перечисляет диалог, который вы оставили. Когда текущий диалог не может переместиться в фон, например потому что вы уже подключены к фоновому сеансу или сохранение сеанса отключено, `/resume` выводит команду `claude attach`, которую нужно запустить вместо этого.

32Вы можете запустить `claude --resume <session-id>` из любого каталога: Claude Code ищет ID в каталоге текущего проекта и его git worktrees в первую очередь, затем в каждом другом проекте на этой машине, поэтому находит сеанс, который начался в другом месте или переместился с помощью [`/cd`](/docs/ru/commands). Поиск по проектам разрешает ID только когда ровно один другой проект содержит стенограмму с сообщениями для него, поэтому ручное копирование дубликата заставляет Claude Code сообщить об отсутствии, а не возобновить произвольную копию. Если ни один сохранённый сеанс не соответствует ID, Claude Code сообщает `No conversation found with session ID: <session-id>`. До версии 2.1.223 поиск останавливался в каталоге текущего проекта и его git worktrees, поэтому вам приходилось возобновлять из каталога, в котором сеанс в последний раз работал.50Вы можете запустить `claude --resume <session-id>` из любого каталога: Claude Code ищет ID в каталоге текущего проекта и его git worktrees в первую очередь, затем в каждом другом проекте на этой машине, поэтому находит сеанс, который начался в другом месте или переместился с помощью [`/cd`](/docs/ru/commands). Поиск по проектам разрешает ID только когда ровно один другой проект содержит стенограмму с сообщениями для него, поэтому ручное копирование дубликата заставляет Claude Code сообщить об отсутствии, а не возобновить произвольную копию. Если ни один сохранённый сеанс не соответствует ID, Claude Code сообщает `No conversation found with session ID: <session-id>`. До версии 2.1.223 поиск останавливался в каталоге текущего проекта и его git worktrees, поэтому вам приходилось возобновлять из каталога, в котором сеанс в последний раз работал.

33 51

34<h3 id="what-a-resumed-session-restores">52<h3 id="what-a-resumed-session-restores">

35 Что восстанавливает возобновлённый сеанс53 Что восстанавливает возобновлённый сеанс

36</h3>54</h3>

37 55

~~38Возобновлённый сеанс восстанавливает диалог вместе с состоянием, сохранённым в нём:~~56Когда Claude Code загружает диалог из его стенограммы, возобновлённый сеанс восстанавливает диалог вместе с состоянием, сохранённым в нём:

39 57

40* История диалога: полная история, включая вызовы инструментов и результаты. Инструмент, который всё ещё выполнялся, когда предыдущий процесс завершился, например при сбое, не завершается и не запускается снова при возобновлении. Claude видит вызов, отмеченный как прерванный до того, как был записан его результат, и ему сообщается проверить, был ли он выполнен, перед тем как запустить его снова, если только не установлена переменная [`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/ru/env-vars#variables). До версии 2.1.281 Claude Code либо удалял прерванный вызов из диалога, либо показывал его Claude как вызов, который вы прервали.58* История диалога: полная история, включая вызовы инструментов и результаты. Инструмент, который всё ещё выполнялся, когда предыдущий процесс завершился, например при сбое, не завершается и не запускается снова при возобновлении. Claude видит вызов, отмеченный как прерванный до того, как был записан его результат, и ему сообщается проверить, был ли он выполнен, перед тем как запустить его снова, если только не установлена переменная [`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/ru/env-vars#variables). До версии 2.1.281 Claude Code либо удалял прерванный вызов из диалога, либо показывал его Claude как вызов, который вы прервали.

41* Модель: сеанс продолжается на модели, которую он использовал. Модель не восстанавливается, когда она была снята с производства или не разрешена `availableModels`, когда флаг `--model` или переменная окружения семейства `ANTHROPIC_MODEL` выбирает одну при запуске, или у поставщиков, которые используют ID развёртывания, специфичные для поставщика, такие как [Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry](/docs/ru/third-party-integrations); см. [конфигурация модели](/docs/ru/model-config#setting-your-model) для порядка разрешения.59* Модель: сеанс продолжается на модели, которую он использовал. Модель не восстанавливается, когда она была снята с производства или не разрешена `availableModels`, когда флаг `--model` или переменная окружения семейства `ANTHROPIC_MODEL` выбирает одну при запуске, или у поставщиков, которые используют ID развёртывания, специфичные для поставщика, такие как [Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry](/docs/ru/third-party-integrations); см. [конфигурация модели](/docs/ru/model-config#setting-your-model) для порядка разрешения.

51 Режим разрешений при возобновлении69 Режим разрешений при возобновлении

52</h4>70</h4>

53 71

~~54Режим разрешений, в котором Claude Code запускает возобновлённый сеанс, зависит от того, как вы возобновляете:~~72Режим разрешений, в котором Claude Code запускает возобновлённый сеанс, зависит от того, как вы возобновляете. Случаи ниже применяются, когда Claude Code загружает диалог из его стенограммы; когда вы [открываете фоновый сеанс, который всё ещё выполняется](#resume-a-running-background-session) вместо этого, этот сеанс сохраняет режим разрешений, в котором он находится.

55 73

56* Терминал: `claude --continue`, `claude --resume <session-id>` или `claude --resume <name>`, когда имя соответствует одному сеансу, без `-p`. Claude Code восстанавливает режим разрешений, в котором находился сеанс, за исключением случаев в таблице. Передайте `--permission-mode` или `--dangerously-skip-permissions`, чтобы переопределить восстановленный режим.74* Терминал: `claude --continue`, `claude --resume <session-id>` или `claude --resume <name>`, когда имя соответствует одному сеансу, без `-p`. Claude Code восстанавливает режим разрешений, в котором находился сеанс, за исключением случаев в таблице. Передайте `--permission-mode` или `--dangerously-skip-permissions`, чтобы переопределить восстановленный режим.

57* Неинтерактивный: `claude -p --resume` или `claude -p --continue`. Claude Code запускает выполнение в режиме разрешений, в котором запустился бы новый запуск `claude -p`, за исключением того, что сеанс, который завершился в режиме Plan Mode, возобновляется в режиме Plan Mode при [условиях ниже](#resume-in-plan-mode-with-p).75* Неинтерактивный: `claude -p --resume` или `claude -p --continue`. Claude Code запускает выполнение в режиме разрешений, в котором запустился бы новый запуск `claude -p`, за исключением того, что сеанс, который завершился в режиме Plan Mode, возобновляется в режиме Plan Mode при [условиях ниже](#resume-in-plan-mode-with-p).

skills.md +1 −1

Details

740 740

741* **Рабочий каталог**: Claude Code запускает каждую команду в текущем рабочем каталоге оболочки сеанса. Этот каталог перемещается, когда Claude запускает `cd`. Используйте [`${CLAUDE_SKILL_DIR}` или `${CLAUDE_PROJECT_DIR}`](#available-string-substitutions) в путях, которые должны разрешаться одинаково каждый раз.741* **Рабочий каталог**: Claude Code запускает каждую команду в текущем рабочем каталоге оболочки сеанса. Этот каталог перемещается, когда Claude запускает `cd`. Используйте [`${CLAUDE_SKILL_DIR}` или `${CLAUDE_PROJECT_DIR}`](#available-string-substitutions) в путях, которые должны разрешаться одинаково каждый раз.

742* **stderr**: с оболочкой `bash` по умолчанию Claude Code объединяет stderr в stdout. Все, что команда записывает в stderr, появляется во внедренном тексте.742* **stderr**: с оболочкой `bash` по умолчанию Claude Code объединяет stderr в stdout. Все, что команда записывает в stderr, появляется во внедренном тексте.

743* **Тайм-аут**: каждая команда запускается под тайм-аутом по умолчанию инструмента Bash в 2 минуты [timeout](/docs/ru/tools-reference#timeout-and-output-limits). Когда инструмент Bash [перемещает команду с истекшим тайм-аутом в фоновый режим](/docs/ru/tools-reference#background-commands), навык все еще отображается. Внедренный текст сообщает о перемещении и называет фоновую задачу и файл, собирающий вывод команды. Когда команда — это та, которую инструмент Bash никогда не переводит в фоновый режим автоматически, Claude Code убивает ее при тайм-ауте. Этот отказ [прерывает вызов](#when-an-injected-command-fails).743* **Тайм-аут**: каждая команда запускается под тайм-аутом по умолчанию инструмента Bash в 2 минуты [timeout](/docs/ru/tools-reference#timeout-and-output-limits). Когда инструмент Bash [перемещает команду с истекшим тайм-аутом в фоновый режим](/docs/ru/tools-reference#foreground-commands-that-move-to-the-background), навык все еще отображается. Внедренный текст сообщает о перемещении и называет фоновую задачу и файл, собирающий вывод команды. Когда команда — это та, которую инструмент Bash никогда не переводит в фоновый режим автоматически, Claude Code убивает ее при тайм-ауте. Этот отказ [прерывает вызов](#when-an-injected-command-fails).

744* **Размер вывода**: вывод, превышающий встроенный потолок инструмента Bash, поступает как путь к файлу плюс краткий предпросмотр, а не усеченный текст. [Output limits](/docs/ru/tools-reference#output-limits) охватывает потолок и способы регулировки каждой границы.744* **Размер вывода**: вывод, превышающий встроенный потолок инструмента Bash, поступает как путь к файлу плюс краткий предпросмотр, а не усеченный текст. [Output limits](/docs/ru/tools-reference#output-limits) охватывает потолок и способы регулировки каждой границы.

745 745

746Инструмент PowerShell применяет то же поведение тайм-аута, фонового режима и потолка вывода к командам, которые он запускает. Подробности см. в разделе [инструмент PowerShell](/docs/ru/tools-reference#powershell-tool).746Инструмент PowerShell применяет то же поведение тайм-аута, фонового режима и потолка вывода к командам, которые он запускает. Подробности см. в разделе [инструмент PowerShell](/docs/ru/tools-reference#powershell-tool).

statusline.md +7 −7

Details

20Вот пример [многострочной строки состояния](#display-multiple-lines), которая отображает информацию git в первой строке и цветовую полосу контекста во второй.20Вот пример [многострочной строки состояния](#display-multiple-lines), которая отображает информацию git в первой строке и цветовую полосу контекста во второй.

21 21

22<Frame>22<Frame>

23 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-multiline.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=60f11387658acc9ff75158ae85f2ac87" alt="Многострочная строка состояния, показывающая имя модели, каталог, ветку git в первой строке и полосу прогресса использования контекста с затратами и продолжительностью во второй строке" width="776" height="212" data-path="images/statusline-multiline.png" />23 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-multiline.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=a9d0a2fe8e446d80b1abc46da3f93270" alt="Многострочная строка состояния, показывающая имя модели, каталог, ветку git в первой строке и полосу прогресса использования контекста с затратами и продолжительностью во второй строке" width="1224" height="262" data-path="images/statusline-multiline.png" />

24</Frame>24</Frame>

25 25

26На этой странице описано [настройка базовой строки состояния](#set-up-a-status-line), объясняется [как данные передаются](#how-status-lines-work) из Claude Code в ваш скрипт, перечисляются [все поля, которые вы можете отображать](#available-data), и предоставляются [готовые примеры](#examples) для распространённых паттернов, таких как статус git, отслеживание затрат и полосы прогресса.26На этой странице описано [настройка базовой строки состояния](#set-up-a-status-line), объясняется [как данные передаются](#how-status-lines-work) из Claude Code в ваш скрипт, перечисляются [все поля, которые вы можете отображать](#available-data), и предоставляются [готовые примеры](#examples) для распространённых паттернов, таких как статус git, отслеживание затрат и полосы прогресса.

93Эти примеры используют скрипты Bash, которые работают на macOS и Linux. На Windows см. [Конфигурация Windows](#windows-configuration) для примеров PowerShell и Git Bash.93Эти примеры используют скрипты Bash, которые работают на macOS и Linux. На Windows см. [Конфигурация Windows](#windows-configuration) для примеров PowerShell и Git Bash.

94 94

95<Frame>95<Frame>

96 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-quickstart.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=696445e59ca0059213250651ad23db6b" alt="Строка состояния, показывающая имя модели, каталог и процент контекста" width="726" height="164" data-path="images/statusline-quickstart.png" />96 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-quickstart.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=88a7eab9c1038dd098ee8e284d96b7e6" alt="Строка состояния, показывающая имя модели, каталог и процент контекста" width="1224" height="224" data-path="images/statusline-quickstart.png" />

97</Frame>97</Frame>

98 98

99<Steps>99<Steps>

444Отобразите текущую модель и использование контекстного окна с визуальной полосой прогресса. Каждый скрипт читает JSON из stdin, извлекает поле `used_percentage` и строит 10-символьную полосу, где заполненные блоки (▓) представляют использование:444Отобразите текущую модель и использование контекстного окна с визуальной полосой прогресса. Каждый скрипт читает JSON из stdin, извлекает поле `used_percentage` и строит 10-символьную полосу, где заполненные блоки (▓) представляют использование:

445 445

446<Frame>446<Frame>

447 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-context-window-usage.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=15b58ab3602f036939145dde3165c6f7" alt="Строка состояния, показывающая имя модели и полосу прогресса с процентом" width="448" height="152" data-path="images/statusline-context-window-usage.png" />447 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-context-window-usage.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=f3918a549912dc47e90f2b69e68bc847" alt="Строка состояния, показывающая имя модели и полосу прогресса с процентом" width="1224" height="224" data-path="images/statusline-context-window-usage.png" />

448</Frame>448</Frame>

449 449

450<CodeGroup>450<CodeGroup>

513Показывает ветку git с цветовыми индикаторами для подготовленных и изменённых файлов. Этот скрипт использует [коды экранирования ANSI](https://en.wikipedia.org/wiki/ANSI_escape_code#Colors) для цветов терминала: `\033[32m` — зелёный, `\033[33m` — жёлтый и `\033[0m` — сброс на значение по умолчанию.513Показывает ветку git с цветовыми индикаторами для подготовленных и изменённых файлов. Этот скрипт использует [коды экранирования ANSI](https://en.wikipedia.org/wiki/ANSI_escape_code#Colors) для цветов терминала: `\033[32m` — зелёный, `\033[33m` — жёлтый и `\033[0m` — сброс на значение по умолчанию.

514 514

515<Frame>515<Frame>

516 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-git-context.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=e656f34f90d1d9a1d0e220988914345f" alt="Строка состояния, показывающая модель, каталог, ветку git и цветные индикаторы для подготовленных и изменённых файлов" width="742" height="178" data-path="images/statusline-git-context.png" />516 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-git-context.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=f13c190724d9ec7188c17cd2f98b7bf4" alt="Строка состояния, показывающая модель, каталог, ветку git и цветные индикаторы для подготовленных и изменённых файлов" width="1224" height="224" data-path="images/statusline-git-context.png" />

517</Frame>517</Frame>

518 518

519Каждый скрипт проверяет, является ли текущий каталог репозиторием git, подсчитывает подготовленные и изменённые файлы и отображает цветные индикаторы:519Каждый скрипт проверяет, является ли текущий каталог репозиторием git, подсчитывает подготовленные и изменённые файлы и отображает цветные индикаторы:

611Каждый скрипт форматирует стоимость как валюту и преобразует миллисекунды в минуты и секунды:611Каждый скрипт форматирует стоимость как валюту и преобразует миллисекунды в минуты и секунды:

612 612

613<Frame>613<Frame>

614 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-cost-tracking.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=e3444a51fe6f3440c134bd5f1f08ad29" alt="Строка состояния, показывающая имя модели, стоимость сеанса и продолжительность" width="588" height="180" data-path="images/statusline-cost-tracking.png" />614 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-cost-tracking.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=925f7024c3b38be0f0eca63564bfb52f" alt="Строка состояния, показывающая имя модели, стоимость сеанса и продолжительность" width="1224" height="224" data-path="images/statusline-cost-tracking.png" />

615</Frame>615</Frame>

616 616

617<CodeGroup>617<CodeGroup>

672Ваш скрипт может выводить несколько строк для создания более богатого отображения.672Ваш скрипт может выводить несколько строк для создания более богатого отображения.

673 673

674<Frame>674<Frame>

675 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-multiline.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=60f11387658acc9ff75158ae85f2ac87" alt="Многострочная строка состояния, показывающая имя модели, каталог, ветку git в первой строке и полосу прогресса использования контекста с затратами и продолжительностью во второй строке" width="776" height="212" data-path="images/statusline-multiline.png" />675 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-multiline.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=a9d0a2fe8e446d80b1abc46da3f93270" alt="Многострочная строка состояния, показывающая имя модели, каталог, ветку git в первой строке и полосу прогресса использования контекста с затратами и продолжительностью во второй строке" width="1224" height="262" data-path="images/statusline-multiline.png" />

676</Frame>676</Frame>

677 677

678Этот пример объединяет несколько методов: цвета на основе порогов (зелёный ниже 70%, жёлтый 70-89%, красный 90%+), полосу прогресса и информацию о ветке git. Каждый оператор `print` или `echo` создаёт отдельную строку:678Этот пример объединяет несколько методов: цвета на основе порогов (зелёный ниже 70%, жёлтый 70-89%, красный 90%+), полосу прогресса и информацию о ветке git. Каждый оператор `print` или `echo` создаёт отдельную строку:

781Этот пример создаёт кликабельную ссылку на ваш репозиторий GitHub. Удерживайте Cmd (macOS) или Ctrl (Windows/Linux) и нажмите, чтобы открыть ссылку в браузере.781Этот пример создаёт кликабельную ссылку на ваш репозиторий GitHub. Удерживайте Cmd (macOS) или Ctrl (Windows/Linux) и нажмите, чтобы открыть ссылку в браузере.

782 782

783<Frame>783<Frame>

784 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-links.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=4bcc6e7deb7cf52f41ab85a219b52661" alt="Строка состояния, показывающая кликабельную ссылку на репозиторий GitHub" width="726" height="198" data-path="images/statusline-links.png" />784 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-links.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=4778a144a28cb498c99d5fa018bb374a" alt="Строка состояния, показывающая кликабельную ссылку на репозиторий GitHub" width="1224" height="224" data-path="images/statusline-links.png" />

785</Frame>785</Frame>

786 786

787Каждый скрипт получает URL удалённого репозитория, преобразует формат SSH в HTTPS и оборачивает имя репозитория в коды экранирования OSC 8. Версия Bash использует `printf '%b'`, которая более надёжно интерпретирует экранирующие последовательности, чем `echo -e` в разных оболочках:787Каждый скрипт получает URL удалённого репозитория, преобразует формат SSH в HTTPS и оборачивает имя репозитория в коды экранирования OSC 8. Версия Bash использует `printf '%b'`, которая более надёжно интерпретирует экранирующие последовательности, чем `echo -e` в разных оболочках:

tools-reference.md +46 −30

Details

154 Что сохраняется между командами154 Что сохраняется между командами

155</h3>155</h3>

156 156

157* Когда Claude выполняет `cd` в основной сессии, новый рабочий каталог переносится на последующие команды Bash, пока он остаётся внутри каталога проекта или [дополнительного рабочего каталога](/docs/ru/permissions#working-directories), который вы добавили с помощью `--add-dir`, `/add-dir` или `additionalDirectories` в параметрах. Это включает команды, которые Claude выполняет в ответ на ваши последующие сообщения.157* Когда Claude выполняет `cd` в основной сессии, новый рабочий каталог переносится на более поздние команды Bash, пока он остаётся внутри каталога проекта или [дополнительного рабочего каталога](/docs/ru/permissions#working-directories), который вы добавили с помощью `--add-dir`, `/add-dir` или `additionalDirectories` в параметрах. Это включает команды, которые Claude выполняет в ответ на ваши более поздние сообщения.

158 * Сессии подагентов никогда не переносят изменения рабочего каталога.158 * Сессии подагентов никогда не переносят изменения рабочего каталога.

159 * Если `cd` приводит за пределы этих каталогов, Claude Code сбрасывает на каталог проекта и добавляет `Shell cwd was reset to <dir>` к результату инструмента.159 * Если `cd` приводит за пределы этих каталогов, Claude Code сбрасывает на каталог проекта и добавляет `Shell cwd was reset to <dir>` к результату инструмента.

160 * Чтобы отключить этот перенос, чтобы каждая команда Bash начиналась в каталоге проекта, установите `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1`.160 * Чтобы отключить этот перенос, чтобы каждая команда Bash начиналась в каталоге проекта, установите `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1`.

161* Переменные окружения не сохраняются. `export` в одной команде не будет доступен в следующей.161* Переменные окружения не сохраняются. `export` в одной команде не будет доступен в следующей.

162* Псевдонимы и функции оболочки, определённые в файле запуска оболочки, доступны. При запуске сессии Claude Code загружает `~/.zshrc`, `~/.bashrc` или `~/.profile` в зависимости от вашей оболочки, захватывает полученные псевдонимы, функции и параметры оболочки и применяет их к каждой команде Bash.162* Псевдонимы и функции оболочки, определённые в файле запуска оболочки, доступны. При запуске сессии Claude Code загружает `~/.zshrc`, `~/.bashrc` или `~/.profile` в зависимости от вашей оболочки, захватывает полученные псевдонимы, функции и параметры оболочки и применяет их к каждой команде Bash.

163 163

164Активируйте виртуальное окружение или окружение conda перед запуском Claude Code. Чтобы переменные окружения сохранялись между командами Bash, установите [`CLAUDE_ENV_FILE`](/docs/ru/env-vars) на скрипт оболочки перед запуском Claude Code или используйте [hook SessionStart](/docs/ru/hooks#persist-environment-variables) для его динамического заполнения.164Активируйте вашу virtualenv или conda окружение перед запуском Claude Code. Чтобы переменные окружения сохранялись между командами Bash, установите [`CLAUDE_ENV_FILE`](/docs/ru/env-vars) на скрипт оболочки перед запуском Claude Code или используйте [hook SessionStart](/docs/ru/hooks#persist-environment-variables) для его динамического заполнения.

165 165

166<h3 id="timeout-and-output-limits">166<h3 id="timeout-and-output-limits">

167 Ограничения по времени и выводу167 Ограничения по времени ожидания и выводу

168</h3>168</h3>

169 169

170Каждая команда выполняется с ограничением по времени, которым управляет Claude: когда ему требуется больше времени, чем по умолчанию для команды, он передаёт параметр `timeout` с этим вызовом. Вы никогда не устанавливаете ограничение по времени для отдельной команды.170Каждая команда выполняется с ограничением по времени, и Claude управляет им: когда ему требуется больше времени, чем по умолчанию для команды, он передаёт параметр `timeout` с этим вызовом. Вы никогда не устанавливаете ограничение по времени для отдельной команды.

171 171

172Две [переменные окружения](/docs/ru/env-vars) контролируют, что Claude получает для команды, которая выполняется на переднем плане:172Две [переменные окружения](/docs/ru/env-vars) контролируют, что Claude получает для команды, которая выполняется на переднем плане:

173 173

174* `BASH_DEFAULT_TIMEOUT_MS` — значение по умолчанию, когда Claude не передаёт timeout; две минуты из коробки174* `BASH_DEFAULT_TIMEOUT_MS` — значение по умолчанию, когда Claude не передаёт ограничение по времени; две минуты из коробки

175* `BASH_MAX_TIMEOUT_MS` — по умолчанию устанавливает потолок, который ограничивает всё, что запрашивает Claude: эффективный потолок — это больший из двух, десять минут из коробки175* `BASH_MAX_TIMEOUT_MS` — по умолчанию устанавливает потолок, который ограничивает всё, что запрашивает Claude: эффективный потолок — это больший из двух, десять минут из коробки

176 176

177Для команды, которую Claude запускает в фоне, `timeout` вместо этого устанавливает, как долго команда может работать там, с отдельным значением по умолчанию и максимумом, описанным в разделе [Фоновые команды](#background-commands). [Инструмент PowerShell](#powershell-tool) следует тем же правилам timeout и читает те же две переменные.177Для команды, которую Claude запускает в фоновом режиме, `timeout` вместо этого устанавливает, как долго команда может работать там, с отдельным значением по умолчанию и максимумом, описанным в разделе [Ограничение времени для фоновых команд](#time-limit-for-background-commands). Инструмент [PowerShell](#powershell-tool) следует тем же правилам ограничения по времени и читает те же две переменные.

178 178

179<h4 id="output-limits">179<h4 id="output-limits">

180 Ограничения по выводу180 Ограничения по выводу

181</h4>181</h4>

182 182

183Claude Code передаёт вывод команды в рабочий файл по мере выполнения команды; команда, вывод которой превышает 5 ГБ, прерывается. Когда команда завершается, Claude Code читает вывод обратно из этого файла, вплоть до окна обратного чтения, описанного ниже. Сколько вывода достигает Claude встроенно, зависит от того, рассматривает ли Claude Code результат как ошибку:183Claude Code передаёт вывод команды в рабочий файл по мере выполнения команды; команда, выход которой превышает 5 ГБ, прерывается. Когда команда завершается, Claude Code читает вывод обратно из этого файла, вплоть до окна обратного чтения, описанного ниже. Сколько вывода достигает Claude встроенно, зависит от того, рассматривает ли Claude Code результат как ошибку:

184 184

185| Результат | Что получает Claude |185| Результат | Что получает Claude |

186| :- | :- |186| :- | :- |

187| Успешный | Встроенно до примерно 30 000 символов по умолчанию; сверх этого, путь файла, сохранённого в каталог сессии и усечённого сверх 64 МиБ, плюс предпросмотр до первых 2 000 символов, и Claude читает или ищет файл, когда ему нужен остаток |187| Действительный | Встроенно до примерно 30 000 символов по умолчанию; после этого путь файла, сохранённого в каталог сессии и усечённого после 64 МиБ, плюс предпросмотр до первых 2 000 символов, и Claude читает или ищет файл, когда ему нужен остаток |

188| Ошибка | Встроенно до примерно 10 000 символов; сверх этого, выдержка начала и конца этого размера, вырезанная из окна обратного чтения, без пути файла |188| Ошибка | Встроенно до примерно 10 000 символов; после этого выдержка начала и конца этого размера, вырезанная из окна обратного чтения, без пути файла |

189 189

190Команда, которая выходит с кодом 1, считается успешным результатом для инструмента Bash только когда Claude Code распознаёт код выхода 1 как благоприятный результат для этой команды: `grep`, `rg`, `egrep`, `fgrep`, `find`, `diff`, `test` и `[`, плюс `git diff` и `git grep`. Каждая другая команда, которая выходит с кодом 1, считается ошибкой, даже когда код выхода 1 — это благоприятный информационный результат: нет совпадений для `pgrep` и `jq -e`, файлы, которые отличаются для `cmp`.190Команда, которая выходит с кодом 1, считается действительным результатом для инструмента Bash только когда Claude Code распознаёт код выхода 1 как благоприятный результат для этой команды: `grep`, `rg`, `egrep`, `fgrep`, `find`, `diff`, `test` и `[`, плюс `git diff` и `git grep`. Каждая другая команда, которая выходит с кодом 1, считается ошибкой, даже когда код выхода 1 — это благоприятный информационный результат: нет совпадений для `pgrep` и `jq -e`, файлы, которые отличаются для `cmp`.

191 191

192[`BASH_MAX_OUTPUT_LENGTH`](/docs/ru/env-vars) устанавливает, сколько символов вывода Claude Code читает обратно из рабочего файла в результат команды: 30 000 по умолчанию, вплоть до жёсткого потолка в 150 000. Увеличьте его, когда ваши команды регулярно переполняют это окно, например подробная сборка или полный журнал набора тестов. Увеличение его расширяет окно обратного чтения, которое также является окном, из которого вырезается выдержка команды с ошибкой. Оно не повышает встроенные потолки: успешный результат сверх встроенного потолка поступает как путь файла плюс предпросмотр независимо от этой переменной.192[`BASH_MAX_OUTPUT_LENGTH`](/docs/ru/env-vars) устанавливает, сколько символов вывода Claude Code читает обратно из рабочего файла в результат команды: 30 000 по умолчанию, вплоть до жёсткого потолка в 150 000. Увеличьте его, когда ваши команды регулярно переполняют это окно, например подробная сборка или полный журнал набора тестов. Увеличение его расширяет окно обратного чтения, которое также является окном, из которого вырезается выдержка команды с ошибкой. Это не повышает встроенные потолки: действительный результат выше встроенного потолка поступает как путь файла плюс предпросмотр независимо от этой переменной.

193 193

194Чтобы изменить, сколько успешного результата Claude получает встроенно, установите параметр [`bashOutputMaxChars`](/docs/ru/settings-reference#bashoutputmaxchars) вместо этого, вплоть до 128 000 символов. Он размеры встроенный потолок и окно обратного чтения вместе, и Claude Code затем игнорирует `BASH_MAX_OUTPUT_LENGTH`. Требует Claude Code v2.1.261 или позже.194Чтобы изменить, сколько действительного результата Claude получает встроенно, установите параметр [`bashOutputMaxChars`](/docs/ru/settings-reference#bashoutputmaxchars) вместо этого, вплоть до 128 000 символов. Он размеры встроенный потолок и окно обратного чтения вместе, и Claude Code затем игнорирует `BASH_MAX_OUTPUT_LENGTH`. Требует Claude Code v2.1.261 или позже.

195 195

196<h3 id="background-commands">196<h3 id="background-commands">

197 Фоновые команды197 Фоновые команды

198</h3>198</h3>

199 199

200Для долгоживущих процессов, таких как серверы разработки или сборки с отслеживанием, Claude может установить `run_in_background: true` для запуска команды как фоновой задачи и продолжения работы во время её выполнения. Перечислите и остановите фоновые задачи с помощью `/tasks`. После того как вы остановите одну там или из подключённого клиента, такого как приложение для рабочего стола, Claude продолжает работу вместо ожидания. Если подагент запустил команду, это подагент, который продолжает работу.200Для долгоживущих процессов, таких как серверы разработки или сборки наблюдения, Claude может установить `run_in_background: true` для запуска команды как фоновой задачи и продолжения работы во время её выполнения. Перечислите и остановите фоновые задачи с помощью `/tasks`. После того как вы остановите одну там или из подключённого клиента, такого как настольное приложение, Claude переходит дальше вместо ожидания. Если подагент запустил команду, это подагент, который переходит дальше.

201 201

202Команда, которую [подагент переднего плана](/docs/ru/sub-agents#run-subagents-in-foreground-or-background) запустил, останавливается, когда запуск этого подагента заканчивается, независимо от того, завершился ли он, произошла ошибка или был прерван. Команда, которую основной разговор или фоновый подагент запустил, продолжает работать после окончательного ответа, пока она не выйдет, не будет остановлена или не достигнет своего временного ограничения. В неинтерактивном режиме с флагом `-p` [фоновые команды заканчиваются вскоре после окончательного результата запуска](/docs/ru/headless#background-tasks-at-exit).202<h4 id="when-a-background-command-stops">

203 Когда фоновая команда останавливается

204</h4>

205

206Команда, которую запустил [подагент переднего плана](/docs/ru/sub-agents#run-subagents-in-foreground-or-background), останавливается, когда заканчивается запуск этого подагента, независимо от того, завершился ли он, не удался или был прерван. Команда, которую запустили основной разговор или фоновый подагент, продолжает работать после финального ответа, пока она не выйдет, не будет остановлена или не достигнет своего [ограничения по времени](#time-limit-for-background-commands). В неинтерактивном режиме с флагом `-p` [фоновые команды заканчиваются вскоре после финального результата запуска](/docs/ru/headless#background-tasks-at-exit).

207

208<h4 id="time-limit-for-background-commands">

209 Ограничение времени для фоновых команд

210</h4>

203 211

204Фоновые команды Bash и PowerShell имеют временное ограничение, отсчитываемое с момента входа команды в фон:212Фоновые команды Bash и PowerShell имеют ограничение по времени, отсчитываемое с момента входа команды в фоновый режим:

205 213

206* Команда, которую Claude запускает в фоне, получает 30 минут или `timeout`, который Claude передаёт с `run_in_background`, вплоть до максимума в 2 часа214* Команда, которую Claude запускает в фоновом режиме, получает 30 минут или `timeout`, который Claude передаёт с `run_in_background`, вплоть до максимума в 2 часа

207* Команда, которая начинается на переднем плане и затем переходит в фон, например с помощью `Ctrl+B` или при её timeout, получает 30 минут с момента перехода215* Команда, которая начинается на переднем плане и затем переходит в фоновый режим, например с помощью `Ctrl+B` или при её ограничении по времени, получает 30 минут с момента перехода

216

217Когда фоновая команда достигает своего ограничения по времени, Claude Code останавливает её и сообщает Claude, почему, и Claude может запустить команду снова с более длительным `timeout`, если работа всё ещё нужна. Уведомление об остановке гласит `Background command "<description>" was stopped after reaching its background time limit`.

218

219<h4 id="raise-the-time-limit-for-background-commands">

220 Повысьте ограничение времени для фоновых команд

221</h4>

208 222

209Две [переменные окружения](/docs/ru/env-vars) повышают эти ограничения для команд Bash и PowerShell одинаково. Обе принимают миллисекунды, и ни одна не может сократить ограничение: более низкое значение оставляет 30-минутное значение по умолчанию и 2-часовой максимум на месте.223Две [переменные окружения](/docs/ru/env-vars) повышают эти ограничения для команд Bash и PowerShell одинаково. Обе принимают миллисекунды, и ни одна не может сократить ограничение: более низкое значение оставляет 30-минутное значение по умолчанию и 2-часовой максимум на месте.

210 224

211* Установите `BASH_DEFAULT_TIMEOUT_MS` выше `1800000`, чтобы заменить 30-минутное значение по умолчанию этим значением, как для команд, которые Claude запускает без `timeout`, так и для перемещённых команд225* Установите `BASH_DEFAULT_TIMEOUT_MS` выше `1800000`, чтобы заменить 30-минутное значение по умолчанию этим значением, как для команд, которые Claude запускает без `timeout`, так и для перемещённых команд

212* Установите `BASH_MAX_TIMEOUT_MS` выше `7200000`, чтобы повысить 2-часовой максимум до этого значения. Установка `BASH_DEFAULT_TIMEOUT_MS` выше `7200000` повышает максимум таким же образом226* Установите `BASH_MAX_TIMEOUT_MS` выше `7200000`, чтобы повысить 2-часовой максимум до этого значения. Установка `BASH_DEFAULT_TIMEOUT_MS` выше `7200000` повышает максимум таким же образом

213 227

214Когда фоновая команда достигает своего временного ограничения, Claude Code останавливает её и сообщает Claude, почему, и Claude может запустить команду снова с более длительным `timeout`, если работа всё ещё нужна. Уведомление об остановке гласит `Background command "<description>" was stopped after reaching its background time limit`.228<h4 id="foreground-commands-that-move-to-the-background">

229 Команды переднего плана, которые переходят в фоновый режим

230</h4>

215 231

216Когда команда переднего плана достигает своего timeout без завершения, Claude Code перемещает её в фон вместо остановки, если только команда не начинается с `sleep`. Временное ограничение перемещённой команды отсчитывается с момента перемещения, и перемещённая команда подагента переднего плана всё ещё останавливается, когда запуск этого подагента заканчивается.232Когда команда переднего плана достигает своего ограничения по времени без завершения, Claude Code переводит её в фоновый режим вместо остановки, если только команда не начинается с `sleep`. Перемещённая команда имеет [ограничение по времени](#time-limit-for-background-commands), отсчитываемое с момента перемещения, и перемещённая команда подагента переднего плана всё ещё останавливается, когда заканчивается запуск этого подагента.

217 233

218Установка [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1`](/docs/ru/env-vars#variables) отключает автоматическое перемещение в фон вместе с остальной функциональностью фоновых задач.234Установка [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1`](/docs/ru/env-vars#variables) отключает автоматическое фоновое выполнение вместе с остальной функциональностью фоновых задач.

219 235

220Результат команды, перемещённой в фон, указывает, что произошло:236Результат команды, перемещённой в фоновый режим, указывает, что произошло:

221 237

222* Когда timeout запускает перемещение, результат сообщает об этом явно: `Command did not complete within its 120s timeout and was moved to the background`, с секундами, соответствующими применённому timeout, за которым следует ID задачи и путь файла, в который записывается вывод.238* Когда ограничение по времени запускает перемещение, результат сообщает об этом явно: `Command did not complete within its 120s timeout and was moved to the background`, с секундами, соответствующими применённому ограничению по времени, за которым следует ID задачи и путь файла, в который записывается вывод.

223* `cd`, `pushd`, `popd` или `chdir` внутри команды, которая перемещается в фон, никогда не переносится: результат гласит `Session cwd remains <dir>; directory changes made by the backgrounded command do not apply to subsequent commands.`, поэтому Claude не действует на изменение каталога, которое не произошло.239* `cd`, `pushd`, `popd` или `chdir` внутри команды, которая перемещается в фоновый режим, никогда не переносится: результат гласит `Session cwd remains <dir>; directory changes made by the backgrounded command do not apply to subsequent commands.`, поэтому Claude не действует на изменение каталога, которое не произошло.

224 240

225<h3 id="memory-limit-on-linux-and-wsl">241<h3 id="memory-limit-on-linux-and-wsl">

226 Ограничение памяти на Linux и WSL242 Ограничение памяти на Linux и WSL

227</h3>243</h3>

228 244

229На Linux и WSL установите [`CLAUDE_CODE_TOOL_MEMORY_LIMIT`](/docs/ru/env-vars#variables) на размер, такой как `4G`, чтобы ограничить память, которую могут использовать команды Bash, PowerShell и [Monitor](#monitor-tool), чтобы одна неконтролируемая сборка не заняла память, которая нужна остальной сессии. Требует Claude Code v2.1.233 или позже. До v2.1.246 команды Monitor работали вне ограничения.245На Linux и WSL установите [`CLAUDE_CODE_TOOL_MEMORY_LIMIT`](/docs/ru/env-vars#variables) на размер, такой как `4G`, чтобы ограничить память, которую могут использовать команды Bash, PowerShell и инструмента [Monitor](#monitor-tool), чтобы одна неконтролируемая сборка не могла занять память, которая нужна остальной сессии. Требует Claude Code v2.1.233 или позже. До v2.1.246 команды инструмента Monitor выполнялись вне ограничения.

230 246

231* Напишите размер как количество байтов или с суффиксом `K`, `M`, `G` или `T`. Установите `0`, `off`, `false`, `no` или `none`, чтобы отключить ограничение. Claude Code игнорирует любое другое значение, которое не может прочитать как размер, например `4e9`.247* Напишите размер как количество байтов или с суффиксом `K`, `M`, `G` или `T`. Установите `0`, `off`, `false`, `no` или `none`, чтобы отключить ограничение. Claude Code игнорирует любое другое значение, которое он не может прочитать как размер, например `4e9`.

232* Claude Code считает все команды Bash, PowerShell и Monitor сессии по одному ограничению, а не каждую команду отдельно.248* Claude Code считает все команды Bash, PowerShell и Monitor сессии по одному ограничению, а не каждую команду отдельно.

233* Claude Code применяет ограничение с помощью cgroup памяти. Когда он не может установить cgroup, команды выполняются без ограничения, и журнал отладки из `claude --debug` говорит, почему.249* Claude Code применяет ограничение с помощью cgroup памяти. Когда он не может установить cgroup, команды выполняются без ограничения, и журнал отладки из `claude --debug` говорит, почему.

234* После того как первый процесс, который Claude Code запускает, включил ограничение или отключил его из-за значения off или неудачной установки cgroup, Claude Code удерживает этот результат, пока вы не перезапустите. Чтобы применить изменённое или удалённое значение или исправленную установку, запустите `claude` снова.250* После того как первый процесс, который Claude Code запускает, включил ограничение или отключил его из-за значения off или неудачной установки cgroup, Claude Code удерживает этот результат, пока вы не перезапустите. Чтобы применить изменённое или удалённое значение или исправленную установку, запустите `claude` снова.

235* Когда команды не могут оставаться под ограничением, ядро убивает команду, и ничто в её результате не называет ограничение.251* Когда команды не могут оставаться под ограничением, ядро убивает команду, и ничто в её результате не называет ограничение.

236 252

237Claude Code также может считать другие виды процессов, которые он запускает, по тому же ограничению. Установите [`CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE`](/docs/ru/env-vars#variables) на список видов, разделённый запятыми, которые нужно исключить из ограничения; Claude Code применяет ограничение к каждому виду, который не в вашем списке. Установите его на `none`, чтобы ограничить каждый вид, или на `all-new`, чтобы ограничить только команды Bash, PowerShell и Monitor. Требует Claude Code v2.1.246 или позже. Виды, которые вы можете назвать:253Claude Code также может считать другие виды процессов, которые он запускает, по тому же ограничению. Установите [`CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE`](/docs/ru/env-vars#variables) на список видов, разделённый запятыми, которые нужно исключить из ограничения; Claude Code применяет ограничение к каждому виду, который не в вашем списке. Установите его на `none`, чтобы ограничить каждый вид, или на `all-new`, чтобы ограничить только команды Bash, PowerShell и Monitor инструмента. Требует Claude Code v2.1.246 или позже. Виды, которые вы можете назвать:

238 254

239* `mcp`: локальные [серверы MCP](/docs/ru/mcp)255* `mcp`: локальные [серверы MCP](/docs/ru/mcp)

240* `lsp`: [языковые серверы](#lsp-tool-behavior)256* `lsp`: [языковые серверы](#lsp-tool-behavior)

245 261

246Что бы вы ни указали, применяются эти правила:262Что бы вы ни указали, применяются эти правила:

247 263

248* **Неизвестные имена**: Claude Code игнорирует имена, которые не распознаёт264* **Неизвестные имена**: Claude Code игнорирует имена, которые он не распознаёт

249* **Bash, PowerShell и Monitor**: Claude Code держит команды Bash, PowerShell и Monitor под ограничением, что бы вы ни указали265* **Bash, PowerShell и Monitor**: Claude Code держит команды Bash, PowerShell и Monitor инструмента под ограничением, что бы вы ни указали

250* **Переменная не установлена**: Claude Code берёт набор других видов с ограничением из конфигурации, которую Anthropic доставляет с сервера, и этот набор может меняться со временем, поэтому установите переменную, когда вам нужен набор, который не меняется266* **Переменная не установлена**: Claude Code берёт набор других ограниченных видов из конфигурации, которую Anthropic доставляет с сервера, и этот набор может меняться со временем, поэтому установите переменную, когда вам нужен набор, который не меняется

251* **Hooks с ограничением разрешений**: даже со всеми видами с ограничением, Claude Code исключает из ограничения hook, который может заблокировать или изменить результат действия, и любой сервер MCP, который такой hook вызывает, поэтому ядро, убивающее hook с ограничением разрешений, не может разрешить действие, которое он блокировал267* **Hooks с ограничением разрешений**: даже со всеми видами ограниченными, Claude Code исключает из ограничения hook, который может заблокировать или изменить результат действия, и любой сервер MCP, который такой hook вызывает, поэтому ядро, убивающее hook с ограничением разрешений, не может разрешить действие, которое он блокировал

252 268

253<h2 id="edit-tool-behavior">269<h2 id="edit-tool-behavior">

254 Поведение инструмента Edit270 Поведение инструмента Edit

vs-code.md +23 −3

Details

362 362

363На вкладке Плагины:363На вкладке Плагины:

364 364

365* **Установленные плагины** отображаются в верхней части с переключателями для их включения или отключения365* **Установленные плагины** отображаются в верхней части с переключателями для их включения или отключения.

366 * Если вы отключите плагин, который включен в файле `.claude/settings.json` вашего проекта, расширение сначала спросит: **Отключить для меня** отключает его только для вас, а **Отключить для всех** изменяет общий файл.

366* **Доступные плагины** из ваших настроенных маркетплейсов отображаются ниже367* **Доступные плагины** из ваших настроенных маркетплейсов отображаются ниже

367* Используйте поиск для фильтрации плагинов по названию или описанию368* Используйте поиск для фильтрации плагинов по названию или описанию

368* Нажмите **Установить** на любом доступном плагине369* Нажмите **Установить** на любом доступном плагине

373* **Установить для этого проекта**: общее использование с сотрудниками проекта (область проекта)374* **Установить для этого проекта**: общее использование с сотрудниками проекта (область проекта)

374* **Установить локально**: только для вас, только в этом репозитории (локальная область)375* **Установить локально**: только для вас, только в этом репозитории (локальная область)

375 376

377После завершения установки форма запрашивает любые [параметры конфигурации](/docs/ru/plugins/components#user-configuration) плагина, которые еще не установлены. Чтобы позже просмотреть или изменить параметры, нажмите значок шестеренки в строке плагина.

378

379Чувствительные текстовые поля скрыты, а сохраненный ранее секрет отображается как **(без изменений)**. Оставьте поле пустым, чтобы сохранить сохраненное значение.

380

381После сохранения изменений открытые сеансы перезагружают свои плагины, и диалоговое окно показывает **Перезагрузите Claude, чтобы применить изменения плагинов**.

382

383<h3 id="uninstall-plugins">

384 Удаление плагинов

385</h3>

386

387Каждая установленная строка указывает [область](/docs/ru/plugins/install#choose-an-install-scope), в которой она установлена. Чтобы удалить эту установку, нажмите значок корзины в строке. Затемненный значок корзины отмечает строку, которую вы не можете удалить из этого рабочего пространства, например плагин, которым управляет ваша организация, или плагин, установленный для другого проекта.

388

389Расширение спрашивает в двух случаях:

390

391* **Плагин, который включен в файле `.claude/settings.json` вашего проекта**: выберите **Отключить для меня**, что сохраняет плагин установленным для ваших сотрудников, или **Удалить для всех**, что удаляет установку проекта с помощью [`--keep-data`](/docs/ru/plugins/cli-reference#what-an-uninstall-deletes-and-keeps), поэтому сохраненный каталог данных плагина остается. Если вы уже отключили плагин для себя, значок корзины удаляет вашу собственную установку без вопроса.

392* **В противном случае, последняя установка плагина с сохраненными данными**: выберите, сохранить или удалить данные; **Сохранить** — это значение по умолчанию

393

376<h3 id="share-a-plugin-install-link">394<h3 id="share-a-plugin-install-link">

377 Поделиться ссылкой на установку плагина395 Поделиться ссылкой на установку плагина

378</h3>396</h3>

407 425

408* Введите репозиторий GitHub, URL или локальный путь для добавления нового маркетплейса426* Введите репозиторий GitHub, URL или локальный путь для добавления нового маркетплейса

409* Нажмите значок обновления, чтобы обновить список плагинов маркетплейса427* Нажмите значок обновления, чтобы обновить список плагинов маркетплейса

410* Нажмите значок корзины, чтобы удалить маркетплейс428* Нажмите значок корзины, чтобы удалить маркетплейс. Его удаление [удаляет все плагины, которые вы установили из него](/docs/ru/plugins/install#manage-marketplaces), поэтому подтверждение сначала называет эти плагины

429

430Изменения плагинов, которые вы вносите в диалоговом окне, применяются сразу же к сеансам Claude Code, открытым в этом окне VS Code.

411 431

412Изменения плагинов, которые вы вносите в диалоговом окне, применяются сразу же к сеансам Claude Code, открытым в этом окне VS Code. Если сеанс, из которого вы открыли диалоговое окно, не может перезагрузить свои плагины, диалоговое окно предлагает повторить попытку или перезагрузить Claude в этом сеансе.432Если сеанс, из которого вы открыли диалоговое окно, не может перезагрузить свои плагины, диалоговое окно предлагает повторить попытку или перезагрузить Claude в этом сеансе.

413 433

414<Note>434<Note>

415 Управление плагинами в VS Code использует те же команды CLI под капотом. Плагины и маркетплейсы, которые вы настраиваете в расширении, также доступны в CLI, и наоборот.435 Управление плагинами в VS Code использует те же команды CLI под капотом. Плагины и маркетплейсы, которые вы настраиваете в расширении, также доступны в CLI, и наоборот.

Documentation 2026-09-30 23:00 UTC to 2026-10-01 03:02 UTC