Documentation — Spybara

agent-sdk/hooks.md +21 −17

Details

9Hooks — это функции обратного вызова, которые выполняют ваш код в ответ на события агента, такие как вызов инструмента, начало сеанса или остановка выполнения. С помощью hooks вы можете:9Hooks — это функции обратного вызова, которые выполняют ваш код в ответ на события агента, такие как вызов инструмента, начало сеанса или остановка выполнения. С помощью hooks вы можете:

10 10

11* **Блокировать опасные операции** перед их выполнением, такие как деструктивные команды shell или несанкционированный доступ к файлам11* **Блокировать опасные операции** перед их выполнением, такие как деструктивные команды shell или несанкционированный доступ к файлам

~~12* **Логировать и аудировать** каждый вызов инструмента для соответствия требованиям, отладки или аналитики~~12* **Логировать и аудировать** вызовы инструментов для соответствия требованиям, отладки или аналитики

13* **Преобразовывать входные и выходные данные** для санитизации данных, внедрения учетных данных или перенаправления путей файлов13* **Преобразовывать входные и выходные данные** для санитизации данных, внедрения учетных данных или перенаправления путей файлов

14* **Требовать одобрение человека** для чувствительных действий, таких как запись в базу данных или вызовы API14* **Требовать одобрение человека** для чувствительных действий, таких как запись в базу данных или вызовы API

15* **Отслеживать жизненный цикл сеанса** для управления состоянием, очистки ресурсов или отправки уведомлений15* **Отслеживать жизненный цикл сеанса** для управления состоянием, очистки ресурсов или отправки уведомлений

40 </Step>40 </Step>

41</Steps>41</Steps>

42 42

43Следующий пример объединяет эти шаги. Он регистрирует хук `PreToolUse` (шаг 1) с matcher `"Write|Edit"` (шаг 3), поэтому callback срабатывает только для инструментов записи файлов. При срабатывании callback получает входные данные инструмента (шаг 4), проверяет, указывает ли путь файла на файл `.env`, и возвращает `permissionDecision: "deny"` для блокировки операции (шаг 5):43Этот пример регистрирует хук `PreToolUse` (шаг 1) с matcher `"Write|Edit"` (шаг 3), поэтому callback срабатывает для инструментов Write и Edit. При срабатывании callback получает входные данные инструмента (шаг 4), проверяет, указывает ли путь файла на файл `.env`, и возвращает `permissionDecision: "deny"` для блокировки операции (шаг 5):

44 44

45<CodeGroup>45<CodeGroup>

46 ```python Python theme={null}46 ```python Python theme={null}

61 file_name = file_path.split("/")[-1]61 file_name = file_path.split("/")[-1]

62 62

63 # Block the operation if targeting a .env file63 # Block the operation if targeting a .env file

~~64 if file_name == ".env":~~64 if file_name.lower() == ".env":

65 return {65 return {

66 "hookSpecificOutput": {66 "hookSpecificOutput": {

67 "hookEventName": input_data["hook_event_name"],67 "hookEventName": input_data["hook_event_name"],

108 const fileName = filePath?.split("/").pop();108 const fileName = filePath?.split("/").pop();

109 109

110 // Block the operation if targeting a .env file110 // Block the operation if targeting a .env file

111 if (fileName === ".env") {111 if (fileName?.toLowerCase() === ".env") {

112 return {112 return {

113 hookSpecificOutput: {113 hookSpecificOutput: {

114 hookEventName: preInput.hook_event_name,114 hookEventName: preInput.hook_event_name,

140 ```140 ```

141</CodeGroup>141</CodeGroup>

142 142

143Когда вы запустите любой из скриптов, Claude попытается создать файл `.env`, и хук отклонит вызов инструмента.143Хук отклоняет вызов Write или Edit, у которого `file_path` заканчивается на `/.env`, в любом регистре букв. В Windows `file_path` использует обратные косые черты, например `C:\project\.env`, и этот хук разрешает вызов Write или Edit для `C:\project\.env`.

144

145<Warning>

146 Matcher `Write|Edit` ограничивает действие этого хука инструментами Write и Edit. Если Claude запишет `.env` с помощью команды Bash, хук не запустится. Чтобы заблокировать запись через Bash в файл там, где [работает песочница](/docs/ru/sandboxing), см. конфигурацию песочницы для [Python](/docs/ru/agent-sdk/python#sandbox-configuration) или [TypeScript](/docs/ru/agent-sdk/typescript#sandbox-configuration).

147</Warning>

144 148

145<h2 id="available-hooks">149<h2 id="available-hooks">

146 Доступные hooks150 Доступные hooks

152| - | - | - | - | - |156| - | - | - | - | - |

153| `PreToolUse` | Да | Да | Запрос вызова инструмента (может блокировать или изменять) | Блокировать опасные команды shell |157| `PreToolUse` | Да | Да | Запрос вызова инструмента (может блокировать или изменять) | Блокировать опасные команды shell |

154| `PostToolUse` | Да | Да | Результат выполнения инструмента | Логировать все изменения файлов в журнал аудита |158| `PostToolUse` | Да | Да | Результат выполнения инструмента | Логировать изменения файлов в журнал аудита |

155| `PostToolUseFailure` | Да | Да | Ошибка выполнения инструмента | Обработать или логировать ошибки инструмента |159| `PostToolUseFailure` | Да | Да | Ошибка выполнения инструмента | Обработать или логировать ошибки инструмента |

156| `PostToolBatch` | Нет | Да | Полный пакет вызовов инструментов разрешается, один раз за пакет перед следующим вызовом модели | Внедрить соглашения один раз для всего пакета |160| `PostToolBatch` | Нет | Да | Полный пакет вызовов инструментов разрешается, один раз за пакет перед следующим вызовом модели | Внедрить соглашения один раз для всего пакета |

157| [`UserPromptSubmit`](/docs/ru/hooks#userpromptsubmit) | Да | Да | Отправляется промпт, включая ход, который Claude Code начинает самостоятельно | Внедрить дополнительный контекст в промпты |161| [`UserPromptSubmit`](/docs/ru/hooks#userpromptsubmit) | Да | Да | Отправляется промпт, включая ход, который Claude Code начинает самостоятельно | Внедрить дополнительный контекст в промпты |

237 241

238Используйте паттерн `matcher` для нацеливания на конкретные инструменты, когда это возможно. Matcher с `'Bash'` запускается только для команд Bash, в то время как опущение паттерна запускает ваши callbacks для каждого возникновения события. Опустите его намеренно для логирования каждого вызова инструмента, который делает ваша сессия.242Используйте паттерн `matcher` для нацеливания на конкретные инструменты, когда это возможно. Matcher с `'Bash'` запускается только для команд Bash, в то время как опущение паттерна запускает ваши callbacks для каждого возникновения события.

239 243

240<h3 id="callback-functions">244<h3 id="callback-functions">

241 Функции обратного вызова245 Функции обратного вызова

268Возвращайте `{}` для разрешения операции без изменений. SDK callback-хуки используют тот же формат вывода JSON, что и [хуки shell-команд Claude Code](/docs/ru/hooks#json-output), который документирует каждое поле и опцию, специфичную для события. Для определений типов SDK см. справочники [TypeScript](/docs/ru/agent-sdk/typescript#synchookjsonoutput) и [Python](/docs/ru/agent-sdk/python#synchookjsonoutput) SDK.272Возвращайте `{}` для разрешения операции без изменений. SDK callback-хуки используют тот же формат вывода JSON, что и [хуки shell-команд Claude Code](/docs/ru/hooks#json-output), который документирует каждое поле и опцию, специфичную для события. Для определений типов SDK см. справочники [TypeScript](/docs/ru/agent-sdk/typescript#synchookjsonoutput) и [Python](/docs/ru/agent-sdk/python#synchookjsonoutput) SDK.

269 273

270<Note>274<Note>

271 Когда применяются несколько хуков или правил разрешений, `deny` имеет приоритет над `defer`, который имеет приоритет над `ask`, который имеет приоритет над `allow`. Если какой-либо хук возвращает `deny`, операция блокируется независимо от других хуков.275 Когда несколько хуков `PreToolUse` возвращают разные [решения](/docs/ru/hooks#pretooluse-decision-control), `deny` имеет приоритет над `defer`, который имеет приоритет над `ask`, который имеет приоритет над `allow`.

272</Note>276</Note>

273 277

274<h4 id="asynchronous-output">278<h4 id="asynchronous-output">

313 Изменение входных данных инструмента317 Изменение входных данных инструмента

314</h3>318</h3>

315 319

316Этот пример перехватывает вызовы инструмента Write и переписывает аргумент `file_path` для добавления префикса `/sandbox`, перенаправляя все записи файлов в изолированный каталог. Callback возвращает `updatedInput` с измененным путем и `permissionDecision: 'allow'` для автоматического одобрения переписанной операции:320Этот пример перехватывает вызовы инструмента Write и переписывает аргумент `file_path`, добавляя к нему префикс `/sandbox`. Callback возвращает `updatedInput` с измененным путем и `permissionDecision: 'allow'` для автоматического одобрения переписанной операции:

317 321

318<CodeGroup>322<CodeGroup>

319 ```python Python theme={null}323 ```python Python theme={null}

370 Добавление контекста и блокировка инструмента374 Добавление контекста и блокировка инструмента

371</h3>375</h3>

372 376

373Этот пример блокирует записи в каталог `/etc` и объясняет причину как модели, так и пользователю:377Этот пример отклоняет вызовы инструментов, у которых `file_path` начинается с `/etc`, и объясняет причину как модели, так и пользователю:

374 378

375* `permissionDecision: 'deny'` останавливает вызов инструмента.379* `permissionDecision: 'deny'` останавливает вызов инструмента.

376* `permissionDecisionReason` сообщает модели причину, чтобы она избежала повторной попытки.380* `permissionDecisionReason` сообщает модели причину.

377* `systemMessage` показывает пользователю, что произошло.381* `systemMessage` показывает пользователю, что произошло.

378 382

379<CodeGroup>383<CodeGroup>

468 Регистрация нескольких hooks472 Регистрация нескольких hooks

469</h3>473</h3>

470 474

471Когда событие срабатывает, все соответствующие hooks выполняются параллельно. Для решений о разрешениях побеждает наиболее ограничивающий результат: одно `deny` блокирует вызов инструмента независимо от того, что возвращают другие hooks. Поскольку порядок завершения недетерминирован, напишите каждый hook так, чтобы он действовал независимо, а не полагаясь на то, что другой hook уже выполнился.475Когда событие срабатывает, соответствующие хуки выполняются параллельно. Для решений о разрешениях применяется наиболее ограничивающий результат. `deny` одного хука блокирует вызов инструмента. Поскольку порядок завершения недетерминирован, пишите каждый хук так, чтобы он действовал независимо, а не полагался на то, что другой хук уже выполнился.

472 476

473Пример ниже регистрирует три независимые проверки для каждого вызова инструмента. Имена hooks в нем, такие как `audit_logger` в Python или `auditLogger` в TypeScript, служат заменой для callbacks, которые вы определяете:477Пример ниже регистрирует три независимые проверки, каждую с [опущенным matcher](/docs/ru/hooks#matcher-patterns). Имена хуков в нем, такие как `audit_logger` в Python или `auditLogger` в TypeScript, служат заменой для callbacks, которые вы определяете:

474 478

475<CodeGroup>479<CodeGroup>

476 ```python Python theme={null}480 ```python Python theme={null}

504 508

505Используйте multi-tool matchers для совместного использования одного callback для связанных инструментов. Этот пример регистрирует три matcher с разными областями, и каждый hook, который он называет, служит заменой для callback, который вы определяете:509Используйте multi-tool matchers для совместного использования одного callback для связанных инструментов. Этот пример регистрирует три matcher с разными областями, и каждый hook, который он называет, служит заменой для callback, который вы определяете:

506 510

507* Список с разделением через трубу (`Write|Edit|NotebookEdit`) срабатывает `file_security_hook` только для инструментов модификации файлов.511* Точный список с разделением вертикальной чертой (`Write|Edit|NotebookEdit`) запускает `file_security_hook` для инструментов Write, Edit и NotebookEdit.

508* Regex (`^mcp__`) срабатывает `mcp_audit_hook` для любого MCP инструмента, имя которого начинается с `mcp__`.512* Regex (`^mcp__`) срабатывает `mcp_audit_hook` для любого MCP инструмента, имя которого начинается с `mcp__`.

509* Пропущенный matcher срабатывает `global_logger` для каждого вызова инструмента независимо от имени.513* Опущенный matcher запускает `global_logger` без фильтрации по имени инструмента.

510 514

511<CodeGroup>515<CodeGroup>

512 ```python Python theme={null}516 ```python Python theme={null}

832 836

833Когда callback превышает свой таймаут, Claude Code отменяет его и отбрасывает его выходные данные, и сессия продолжается, а не зависает. Что происходит дальше, зависит от события:837Когда callback превышает свой таймаут, Claude Code отменяет его и отбрасывает его выходные данные, и сессия продолжается, а не зависает. Что происходит дальше, зависит от события:

834 838

835* `PreToolUse`: Claude Code не выполняет вызов инструмента, Claude получает результат инструмента, указывающий, что хук не ответил до истечения таймаута, и ход продолжается. Если другой хук `PreToolUse` вернул явный отказ, Claude получает этот отказ вместо ошибки таймаута. До версии 2.1.210 Claude Code сообщал Claude о таймауте как об отклонении пользователем, из-за чего автоматические сессии останавливались и ждали ввода.839* `PreToolUse`: Claude Code блокирует вызов инструмента. Вместо него Claude получает результат инструмента, указывающий, что хук не ответил до истечения таймаута, и ход продолжается. До версии 2.1.210 Claude Code сообщал Claude о таймауте как об отклонении пользователем, из-за чего автоматические сессии останавливались и ждали ввода.

836* `PostToolUse` и `PostToolUseFailure`: Claude Code сохраняет результат инструмента, и ход продолжается.840* `PostToolUse` и `PostToolUseFailure`: Claude Code сохраняет результат инструмента, и ход продолжается.

837* `UserPromptSubmit` и [`UserPromptExpansion`](/docs/ru/hooks#userpromptexpansion): Claude Code блокирует промпт с сообщением, указывающим хук и таймаут, и сессия продолжается. Поскольку callback на этих событиях может действовать как шлюз политики, Claude Code никогда не пропускает промпт с истекшим таймаутом без проверки. До версии 2.1.208 Claude Code завершал запрос с `error_during_execution`, когда у callback на этих событиях истекал таймаут.841* `UserPromptSubmit` и [`UserPromptExpansion`](/docs/ru/hooks#userpromptexpansion): Claude Code блокирует промпт с сообщением, указывающим хук и таймаут, и сессия продолжается. До версии 2.1.208 Claude Code завершал запрос с `error_during_execution`, когда у callback на этих событиях истекал таймаут.

838* `Stop` и `SubagentStop`: callback с истекшим таймаутом считается не вернувшим решения. Агент или субагент останавливается так, как если бы этот callback это разрешил, а решение ваших других хуков на этом событии по-прежнему применяется. До Claude Code версии 2.1.273 callback `Stop` или `SubagentStop` с истекшим таймаутом считался неудачным запуском хука, и Claude Code отбрасывал решения ваших других хуков на этом событии.842* `Stop` и `SubagentStop`: callback с истекшим таймаутом считается не вернувшим решения. Агент или субагент останавливается так, как если бы этот callback это разрешил, а решение ваших других хуков на этом событии по-прежнему применяется. До Claude Code версии 2.1.273 callback `Stop` или `SubagentStop` с истекшим таймаутом считался неудачным запуском хука, и Claude Code отбрасывал решения ваших других хуков на этом событии.

839* `SessionStart`: callback с истекшим таймаутом считается не вернувшим выходных данных, и сессия продолжается с выходными данными ваших других хуков `SessionStart`.843* `SessionStart`: callback с истекшим таймаутом считается не вернувшим выходных данных, и сессия продолжается с выходными данными ваших других хуков `SessionStart`.

840* `PreModelSwitch`: Claude Code блокирует переключение модели. Хук, который не отвечает, не одобрил переключение.844* `PreModelSwitch`: Claude Code блокирует переключение модели. Хук, который не отвечает, не одобрил переключение.

agent-sdk/python.md +3 −1

Details

3881<Note>3881<Note>

3882 Sandbox зависит от поддержки платформы и, на Linux, инструментов, таких как `bubblewrap` и `socat`. По умолчанию, когда `enabled` имеет значение `True`, но sandbox не может запуститься, команды выполняются без sandbox с предупреждением на stderr. Это поведение отличается от TypeScript SDK, где `failIfUnavailable` по умолчанию имеет значение `true`.3882 Sandbox зависит от поддержки платформы и, на Linux, инструментов, таких как `bubblewrap` и `socat`. По умолчанию, когда `enabled` имеет значение `True`, но sandbox не может запуститься, команды выполняются без sandbox с предупреждением на stderr. Это поведение отличается от TypeScript SDK, где `failIfUnavailable` по умолчанию имеет значение `true`.

3883 3883

3884 Установите `"failIfUnavailable": True` в параметрах sandbox, чтобы остановиться вместо этого. Ключ еще не объявлен на `SandboxSettings`, но SDK передает его в Claude Code, который его соблюдает. `query()` затем сообщает `ResultMessage` с `subtype="error_during_execution"` и причину в `errors`. Поскольку это одноразовый вызов `query()`, SDK вызывает исключение после выдачи этого результата ошибки, поэтому оберните цикл в блок try, чтобы продолжить после него. См. [Handle the result](/docs/ru/agent-sdk/agent-loop#handle-the-result) для контракта ошибки.3884 Установите `"failIfUnavailable": True` в настройках песочницы, чтобы вместо этого остановить выполнение. SDK передаёт `failIfUnavailable` в Claude Code вместе с объявленными полями `SandboxSettings`. Затем `query()` сообщает `ResultMessage` с `subtype="error_during_execution"` и причиной в `errors`. Поскольку это одноразовый вызов `query()`, SDK вызывает исключение после выдачи этого результата ошибки, поэтому оберните цикл в блок try, чтобы продолжить после него. См. [Handle the result](/docs/ru/agent-sdk/agent-loop#handle-the-result) для контракта ошибки.

3885</Note>3885</Note>

3886 3886

3887Чтобы запретить командам в песочнице запись в файл, укажите его абсолютный путь в [`denyWrite`](/docs/ru/settings-reference#sandbox-filesystem-denywrite) в настройках песочницы, например `"filesystem": {"denyWrite": ["/home/user/project/.env"]}`. SDK передаёт `filesystem` в Claude Code вместе с объявленными полями `SandboxSettings`. После запуска песочница блокирует запись по каждому указанному пути. Если указать `.env` или `./.env`, команды в песочнице смогут записывать в файл `.env` в рабочем каталоге сессии.

3888

3887<h4 id="example-usage">3889<h4 id="example-usage">

3888 Пример использования3890 Пример использования

3889</h4>3891</h4>

agent-sdk/skills.md +1 −1

Details

557[Руководство Claude Code skills](/docs/ru/skills) охватывает разработку в глубину. Его рекомендации применяются к сеансам SDK. Начните с этих разделов:557[Руководство Claude Code skills](/docs/ru/skills) охватывает разработку в глубину. Его рекомендации применяются к сеансам SDK. Начните с этих разделов:

558 558

559* [Справочник Frontmatter](/docs/ru/skills#frontmatter-reference): каждое поддерживаемое поле559* [Справочник Frontmatter](/docs/ru/skills#frontmatter-reference): каждое поддерживаемое поле

560* [Передача аргументов в skills](/docs/ru/skills#pass-arguments-to-skills): `$ARGUMENTS`, `$0`, `$1` и стекирование skills. [Полная таблица подстановок](/docs/ru/skills#available-string-substitutions) добавляет именованные аргументы и переменные `${CLAUDE_*}`560* [Передача аргументов в скиллы](/docs/ru/skills#pass-arguments-to-skills): `$ARGUMENTS`, `$0` и `$1`. [Полная таблица подстановок](/docs/ru/skills#available-string-substitutions) добавляет именованные аргументы и переменные `${CLAUDE_*}`

561* [Внедрение динамического контекста](/docs/ru/skills#inject-dynamic-context): строки `` !`command` ``, которые запускаются перед тем, как Claude увидит содержимое skill561* [Внедрение динамического контекста](/docs/ru/skills#inject-dynamic-context): строки `` !`command` ``, которые запускаются перед тем, как Claude увидит содержимое skill

562* [Выберите, где загружаются skills](/docs/ru/skills#where-skills-live): каждое расположение skill, пространство имён плагина и какой skill запускается, когда два имеют одно имя562* [Выберите, где загружаются skills](/docs/ru/skills#where-skills-live): каждое расположение skill, пространство имён плагина и какой skill запускается, когда два имеют одно имя

563 563

agent-sdk/typescript.md +1 −1

Details

6368| Свойство | Тип | По умолчанию | Описание |6368| Свойство | Тип | По умолчанию | Описание |

6369| :- | :- | :- | :- |6369| :- | :- | :- | :- |

6373 6373

6374<h3 id="permissions-fallback-for-unsandboxed-commands">6374<h3 id="permissions-fallback-for-unsandboxed-commands">

agent-teams.md +4 −4

Details

231 231

232Лидер отправляет запрос на завершение. Товарищ по команде может одобрить, выходя корректно, или отклонить с объяснением.232Лидер отправляет запрос на завершение. Товарищ по команде может одобрить, выходя корректно, или отклонить с объяснением.

233 233

234Общие каталоги команды очищаются автоматически при завершении сеанса, поэтому отдельный шаг очистки не требуется. См. [Architecture](#architecture) для информации о том, какие каталоги удаляются и какие сохраняются для возобновленных сеансов.234Общие каталоги команды очищаются автоматически при завершении сессии, поэтому отдельный шаг очистки не требуется. См. [Architecture](#architecture), чтобы узнать, какие каталоги удаляются, а какие остаются на диске.

235 235

236<h3 id="enforce-quality-gates-with-hooks">236<h3 id="enforce-quality-gates-with-hooks">

237 Обеспечение качества с помощью hooks237 Обеспечение качества с помощью hooks

278 278

279Команды и задачи хранятся локально под именем, производным от сеанса. Имя — это `session-` с последующими первыми восемью символами ID сеанса:279Команды и задачи хранятся локально под именем, производным от сеанса. Имя — это `session-` с последующими первыми восемью символами ID сеанса:

280 280

281* **Конфигурация команды**: `~/.claude/teams/{team-name}/config.json`281* **Конфигурация команды**: `~/.claude/teams/{team-name}/config.json`. Claude Code удаляет директорию конфигурации команды при завершении сессии.

282* **Список задач**: `~/.claude/tasks/{team-name}/`282* **Список задач**: `~/.claude/tasks/{team-name}/`. Эта директория остается на диске после завершения сессии. Чтобы изменить, [как долго Claude Code ее хранит](/docs/ru/claude-directory#cleaned-up-automatically), задайте [`cleanupPeriodDays`](/docs/ru/settings-reference#cleanupperioddays).

283 283

284Claude Code генерирует оба этих файла автоматически при запуске сеанса и обновляет их по мере присоединения товарищей по команде, перехода в режим ожидания или ухода. Директория конфигурации команды удаляется при завершении сеанса. Директория списка задач сохраняется локально и никогда не загружается, поэтому возобновленные сеансы сохраняют свои задачи. Хранение управляется тем же [`cleanupPeriodDays`](/docs/ru/settings-reference#cleanupperioddays), который вы уже контролируете для стенограмм сеансов, следуя [правилам очистки хранилища](/docs/ru/claude-directory#cleaned-up-automatically).284Claude Code генерирует оба этих элемента автоматически при запуске сессии и обновляет их по мере того, как участники команды присоединяются, переходят в режим ожидания или уходят.

285 285

286Конфигурация команды содержит состояние выполнения, такое как ID сеансов и ID панелей tmux, поэтому не редактируйте ее вручную и не создавайте предварительно: ваши изменения будут перезаписаны при следующем обновлении состояния.286Конфигурация команды содержит состояние выполнения, такое как ID сеансов и ID панелей tmux, поэтому не редактируйте ее вручную и не создавайте предварительно: ваши изменения будут перезаписаны при следующем обновлении состояния.

287 287

agent-view.md +1 −1

Details

325 325

326Второе нажатие удаляет сессию, даже если попытка остановки не удалась, например потому что [фоновая служба не отвечает](#agent-view-says-the-background-service-did-not-respond): подтверждение остаётся активным ещё две секунды, и удаление само завершает процесс сессии. Нажмите `Esc`, чтобы закрыть подтверждение без удаления.326Второе нажатие удаляет сессию, даже если попытка остановки не удалась, например потому что [фоновая служба не отвечает](#agent-view-says-the-background-service-did-not-respond): подтверждение остаётся активным ещё две секунды, и удаление само завершает процесс сессии. Нажмите `Esc`, чтобы закрыть подтверждение без удаления.

327 327

328За исключением случаев сохранения, описанных в [What deleting a session removes](#what-deleting-a-session-removes), удаление убирает сессию из списка, а worktree, созданный для неё Claude, удаляется, сохраняется или остаётся на месте в зависимости от способа удаления и содержимого worktree. Транскрипт диалога всегда остаётся на вашем локальном компьютере и доступен через `claude --resume`.328За исключением случаев сохранения, описанных в [What deleting a session removes](#what-deleting-a-session-removes), удаление убирает сессию из списка, а worktree, созданный для неё Claude, удаляется, сохраняется или остаётся на месте в зависимости от способа удаления и содержимого worktree. Транскрипт диалога остаётся на вашем локальном компьютере и доступен через `claude --resume`.

329 329

330Чтобы вернуть сессию в Claude Code v2.1.212 или новее, введите `/resume` в поле отправки. Откроется окно выбора с прошлыми сессиями репозитория, из которого вы открыли agent view, начиная с самых новых, включая сессии, удалённые из списка; сессии, у которых уже есть строка, не отображаются. `↑`/`↓` перемещают выделение, `Enter` возобновляет выбранную сессию как фоновую, и она снова появляется в списке строкой, а `Esc` закрывает окно выбора.330Чтобы вернуть сессию в Claude Code v2.1.212 или новее, введите `/resume` в поле отправки. Откроется окно выбора с прошлыми сессиями репозитория, из которого вы открыли agent view, начиная с самых новых, включая сессии, удалённые из списка; сессии, у которых уже есть строка, не отображаются. `↑`/`↓` перемещают выделение, `Enter` возобновляет выбранную сессию как фоновую, и она снова появляется в списке строкой, а `Esc` закрывает окно выбора.

331 331

auto-mode-classifier-billing.md +3 −1

Details

12We're changing auto mode to no longer charge for classifier requests in Claude Code. However, this session isn't eligible.12We're changing auto mode to no longer charge for classifier requests in Claude Code. However, this session isn't eligible.

13```13```

14 14

15В приглашении Claude Code удерживает первое действие, которое он проверил бы таким образом, пока вы не ответите. Ничего не сломано: режим auto продолжает работать, и его запросы классификатора выставляются счетом, как и раньше. Наиболее частая причина — это шлюз LLM или прокси между Claude Code и API, и когда Claude Code может идентифицировать его, уведомление называет его. Нажмите **Enter** для продолжения или см. [Сделать сеанс подходящим](#make-the-session-eligible), чтобы предотвратить его появление в новых сеансах.15Пока отображается это уведомление, Claude Code удерживает первое действие, которое он проверил бы таким образом, пока вы не ответите. Авторежим продолжает работать, а его запросы классификатора оплачиваются так же, как и раньше.

17Наиболее частая причина — это LLM-шлюз или прокси между Claude Code и API, и когда Claude Code может идентифицировать его, уведомление называет его. Нажмите **Enter** для продолжения или см. [Сделать сессию подходящей](#make-the-session-eligible), чтобы предотвратить его появление в новых сессиях.

16 18

17<h2 id="respond-to-the-notice">19<h2 id="respond-to-the-notice">

18 Ответить на уведомление20 Ответить на уведомление

channels.md +4 −4

Details

45 Если установка не удалась, сопоставьте сообщение, которое сообщает Claude Code:45 Если установка не удалась, сопоставьте сообщение, которое сообщает Claude Code:

46 46

47 * `Marketplace "claude-plugins-official" not found`: добавьте маркетплейс с помощью `/plugin marketplace add anthropics/claude-plugins-official`, затем повторите попытку установки.47 * `Marketplace "claude-plugins-official" not found`: добавьте маркетплейс с помощью `/plugin marketplace add anthropics/claude-plugins-official`, затем повторите попытку установки.

~~48 * Плагин [не найден в маркетплейсе](/docs/ru/plugins/install#install-a-plugin): проверьте имя плагина.~~48 * `Plugin "<name>" not found in marketplace "claude-plugins-official"`: ваша локальная копия каталога маркетплейса может быть устаревшей. Обновите её с помощью `/plugin marketplace update claude-plugins-official`, затем повторите попытку установки. Если повторная попытка выводит то же сообщение, см. [Плагин не найден в маркетплейсе](/docs/ru/plugins/troubleshooting#plugin-not-found-in-marketplace).

49 49

50 Когда установка запрашивает область действия установки, выберите опцию области действия пользователя, чтобы плагин был доступен во всех ваших проектах. Проверьте сводку установки: если она сообщает `Run /reload-plugins to apply.`, см. [Применение изменений плагина без перезагрузки](/docs/ru/plugins/cli-reference#reload-plugins), чтобы сделать команду настройки плагина доступной.50 Когда установка запрашивает область действия установки, выберите опцию области действия пользователя, чтобы плагин был доступен во всех ваших проектах. Проверьте сводку установки: если она сообщает `Run /reload-plugins to apply.`, см. [Применение изменений плагина без перезагрузки](/docs/ru/plugins/cli-reference#reload-plugins), чтобы сделать команду настройки плагина доступной.

51 </Step>51 </Step>

123 Если установка не удалась, сопоставьте сообщение, которое сообщает Claude Code:123 Если установка не удалась, сопоставьте сообщение, которое сообщает Claude Code:

124 124

125 * `Marketplace "claude-plugins-official" not found`: добавьте маркетплейс с помощью `/plugin marketplace add anthropics/claude-plugins-official`, затем повторите попытку установки.125 * `Marketplace "claude-plugins-official" not found`: добавьте маркетплейс с помощью `/plugin marketplace add anthropics/claude-plugins-official`, затем повторите попытку установки.

126 * Плагин [не найден в маркетплейсе](/docs/ru/plugins/install#install-a-plugin): проверьте имя плагина.126 * `Plugin "<name>" not found in marketplace "claude-plugins-official"`: ваша локальная копия каталога маркетплейса может быть устаревшей. Обновите её с помощью `/plugin marketplace update claude-plugins-official`, затем повторите попытку установки. Если повторная попытка выводит то же сообщение, см. [Плагин не найден в маркетплейсе](/docs/ru/plugins/troubleshooting#plugin-not-found-in-marketplace).

127 127

128 Когда установка запрашивает область действия установки, выберите опцию области действия пользователя, чтобы плагин был доступен во всех ваших проектах. Проверьте сводку установки: если она сообщает `Run /reload-plugins to apply.`, см. [Применение изменений плагина без перезагрузки](/docs/ru/plugins/cli-reference#reload-plugins), чтобы сделать команду настройки плагина доступной.128 Когда установка запрашивает область действия установки, выберите опцию области действия пользователя, чтобы плагин был доступен во всех ваших проектах. Проверьте сводку установки: если она сообщает `Run /reload-plugins to apply.`, см. [Применение изменений плагина без перезагрузки](/docs/ru/plugins/cli-reference#reload-plugins), чтобы сделать команду настройки плагина доступной.

129 </Step>129 </Step>

188 Если установка не удалась, сопоставьте сообщение, которое сообщает Claude Code:188 Если установка не удалась, сопоставьте сообщение, которое сообщает Claude Code:

189 189

190 * `Marketplace "claude-plugins-official" not found`: добавьте маркетплейс с помощью `/plugin marketplace add anthropics/claude-plugins-official`, затем повторите попытку установки.190 * `Marketplace "claude-plugins-official" not found`: добавьте маркетплейс с помощью `/plugin marketplace add anthropics/claude-plugins-official`, затем повторите попытку установки.

191 * Плагин [не найден в маркетплейсе](/docs/ru/plugins/install#install-a-plugin): проверьте имя плагина.191 * `Plugin "<name>" not found in marketplace "claude-plugins-official"`: ваша локальная копия каталога маркетплейса может быть устаревшей. Обновите её с помощью `/plugin marketplace update claude-plugins-official`, затем повторите попытку установки. Если повторная попытка выводит то же сообщение, см. [Плагин не найден в маркетплейсе](/docs/ru/plugins/troubleshooting#plugin-not-found-in-marketplace).

192 192

193 Когда установка запрашивает область установки, выберите опцию области пользователя, чтобы плагин был доступен во всех ваших проектах.193 Когда установка запрашивает область установки, выберите опцию области пользователя, чтобы плагин был доступен во всех ваших проектах.

194 194

247 Если установка не удается, сопоставьте сообщение, которое сообщает Claude Code:247 Если установка не удается, сопоставьте сообщение, которое сообщает Claude Code:

248 248

249 * `Marketplace "claude-plugins-official" not found`: добавьте маркетплейс с помощью `/plugin marketplace add anthropics/claude-plugins-official`, затем повторите попытку установки.249 * `Marketplace "claude-plugins-official" not found`: добавьте маркетплейс с помощью `/plugin marketplace add anthropics/claude-plugins-official`, затем повторите попытку установки.

250 * Плагин [не найден в маркетплейсе](/docs/ru/plugins/install#install-a-plugin): проверьте имя плагина.250 * `Plugin "<name>" not found in marketplace "claude-plugins-official"`: ваша локальная копия каталога маркетплейса может быть устаревшей. Обновите её с помощью `/plugin marketplace update claude-plugins-official`, затем повторите попытку установки. Если повторная попытка выводит то же сообщение, см. [Plugin not found in marketplace](/docs/ru/plugins/troubleshooting#plugin-not-found-in-marketplace).

251 251

252 Когда установка запросит область установки, выберите опцию области пользователя, чтобы плагин был доступен во всех ваших проектах.252 Когда установка запросит область установки, выберите опцию области пользователя, чтобы плагин был доступен во всех ваших проектах.

253 253

claude-directory.md +1 −1

Details

290 note: commandsNote,290 note: commandsNote,

291 when: <>User types <C>/command-name</C></>,291 when: <>User types <C>/command-name</C></>,

292 description: <>A file at <C>commands/deploy.md</C> creates <C>/deploy</C> the same way a skill at <C>skills/deploy/SKILL.md</C> does, and both can be auto-invoked by Claude. Skills use a directory with SKILL.md, letting you bundle reference docs, templates, or scripts alongside the prompt.</>,292 description: <>A file at <C>commands/deploy.md</C> creates <C>/deploy</C> the same way a skill at <C>skills/deploy/SKILL.md</C> does, and both can be auto-invoked by Claude. Skills use a directory with SKILL.md, letting you bundle reference docs, templates, or scripts alongside the prompt.</>,

293 tips: [<>Use <C>$ARGUMENTS</C> in the file to accept parameters: <C>/fix-issue 123</C></>, 'If a skill and command share a name, the skill takes precedence', 'New commands should usually be skills instead; commands remain supported'],293 tips: [<>Use <C>$ARGUMENTS</C> in the file to accept parameters: <C>/fix-issue 123</C></>, 'If a skill and command share a name, the skill takes precedence', 'New commands should usually be skills instead; command files still work'],

294 docsLink: '/en/skills',294 docsLink: '/en/skills',

295 children: [{295 children: [{

296 id: 'cmd-example',296 id: 'cmd-example',

claude-security.md +3 −3

Details

48 48

49Команда открывает детали плагина, где вы выбираете [область установки](/docs/ru/plugins/install#install-a-plugin) для начала установки.49Команда открывает детали плагина, где вы выбираете [область установки](/docs/ru/plugins/install#install-a-plugin) для начала установки.

50 50

~~51Если установка не удается, исправление зависит от того, какое сообщение сообщает Claude Code:~~51Если установка не удается, ориентируйтесь на сообщение, которое выводит Claude Code:

52 52

53* Если он сообщает `Marketplace "claude-plugins-official" not found`, добавьте рынок с помощью `/plugin marketplace add anthropics/claude-plugins-official`, затем повторите попытку установки.53* `Marketplace "claude-plugins-official" not found`: добавьте маркетплейс с помощью `/plugin marketplace add anthropics/claude-plugins-official`, затем повторите попытку установки.

54* Если он сообщает, что [не может найти плагин на рынке](/docs/ru/plugins/install#install-a-plugin), проверьте имя плагина на опечатки.54* `Plugin "claude-security" not found in marketplace "claude-plugins-official"`: возможно, ваша локальная копия каталога маркетплейса устарела. Обновите ее с помощью `/plugin marketplace update claude-plugins-official`, затем повторите попытку установки. Если при повторной попытке выводится то же сообщение, см. раздел [Плагин не найден в маркетплейсе](/docs/ru/plugins/troubleshooting#plugin-not-found-in-marketplace).

55 55

56Проверьте сводку установки. Если она сообщает `Run /reload-plugins to apply.`, см. [Применение изменений плагина без перезагрузки](/docs/ru/plugins/cli-reference#reload-plugins) для активации плагина в вашей текущей сессии.56Проверьте сводку установки. Если она сообщает `Run /reload-plugins to apply.`, см. [Применение изменений плагина без перезагрузки](/docs/ru/plugins/cli-reference#reload-plugins) для активации плагина в вашей текущей сессии.

57 57

code-review-local.md +1 −1

Details

118После уровня effort и флагов Claude Code читает остаток строки как цель ревью. Аргумент `ultra` меняет эту интерпретацию:118После уровня effort и флагов Claude Code читает остаток строки как цель ревью. Аргумент `ultra` меняет эту интерпретацию:

119 119

120* **С `ultra`**: Claude Code интерпретирует одно слово как базовую ветку или номер PR. Более длинный текст, не являющийся именем ветки или PR, становится [заметкой, прикреплённой к ревью](/docs/ru/ultrareview#pass-a-request-in-plain-words). `/code-review ultra check my auth changes` проверяет вашу текущую ветку, и Claude соотносит результаты с вашей заметкой.120* **С `ultra`**: Claude Code интерпретирует одно слово как базовую ветку или номер PR. Более длинный текст, не являющийся именем ветки или PR, становится [заметкой, прикреплённой к ревью](/docs/ru/ultrareview#pass-a-request-in-plain-words). `/code-review ultra check my auth changes` проверяет вашу текущую ветку, и Claude соотносит результаты с вашей заметкой.

121* **Без `ultra`**: всё оставшееся является целью ревью, даже если начинается с имени другой команды. `/code-review /fix-issue 123` проводит ревью с `/fix-issue 123` в качестве текста цели, а не загружает `/fix-issue` как второй [составной скилл](/docs/ru/skills#pass-arguments-to-skills). До версии v2.1.218 команда, указанная после `/code-review`, раскрывалась как отдельный скилл.121* **Без `ultra`**: всё оставшееся является целью ревью, даже если начинается с имени другой команды. `/code-review /fix-issue 123` проводит ревью с `/fix-issue 123` в качестве текста цели, а не загружает `/fix-issue` как второй [составной скилл](/docs/ru/skills#stack-several-skills-in-one-message). До версии v2.1.218 команда, указанная после `/code-review`, раскрывалась как отдельный скилл.

122 122

123<h2 id="run-in-the-foreground">123<h2 id="run-in-the-foreground">

124 Запуск в основном режиме124 Запуск в основном режиме

commands.md +1 −1

Details

10 10

11Введите `/` для просмотра доступных вам команд или введите `/` с последующими буквами для фильтрации. [Как меню команд соответствует тому, что вы вводите](#how-the-command-menu-matches-what-you-type) охватывает выделение, опечатки и несколько команд, которые Claude Code скрывает из меню до тех пор, пока вы не введете их полное имя.11Введите `/` для просмотра доступных вам команд или введите `/` с последующими буквами для фильтрации. [Как меню команд соответствует тому, что вы вводите](#how-the-command-menu-matches-what-you-type) охватывает выделение, опечатки и несколько команд, которые Claude Code скрывает из меню до тех пор, пока вы не введете их полное имя.

12 12

13Команда распознается только в начале вашего сообщения. Текст, следующий за именем команды, становится её аргументами. [Скиллы](/docs/ru/skills#pass-arguments-to-skills) являются исключением: вызов скилла, за которым следуют другие скиллы, такие как `/skill-a /skill-b do XYZ`, загружает скиллы, названные в начале, и передает завершающий текст каждому из них в качестве аргументов. Можно объединить в цепочку до шести скиллов.13Команда распознается только в начале вашего сообщения. Текст, следующий за именем команды, становится её аргументами. В промпте терминала вы можете начать одно сообщение с нескольких [скиллов](/docs/ru/skills#stack-several-skills-in-one-message): ввод `/skill-a /skill-b do XYZ` загружает оба скилла и передает завершающий текст каждому из них в качестве аргументов. Можно объединить в цепочку до шести скиллов.

14 14

15Если вы отправите команду, пока Claude отвечает, Claude Code ставит её в очередь и запускает после завершения текущего хода. Claude Code запускает некоторые команды немедленно без прерывания ответа, такие как `/status`, `/tasks` и `/usage`. В [полноэкранном режиме отображения](/docs/ru/fullscreen) Claude Code также открывает диалоговые команды, такие как `/theme` и `/help`, немедленно. До версии 2.1.234 Claude Code ставил эти диалоги в очередь до завершения хода.15Если вы отправите команду, пока Claude отвечает, Claude Code ставит её в очередь и запускает после завершения текущего хода. Claude Code запускает некоторые команды немедленно без прерывания ответа, такие как `/status`, `/tasks` и `/usage`. В [полноэкранном режиме отображения](/docs/ru/fullscreen) Claude Code также открывает диалоговые команды, такие как `/theme` и `/help`, немедленно. До версии 2.1.234 Claude Code ставил эти диалоги в очередь до завершения хода.

16 16

desktop.md +10 −9

Details

1137</Warning>1137</Warning>

1138 1138

1139* **После спящего режима или потери сети**: вы вернёте выполняющуюся задачу, если процесс [всё ещё работает](#limits-while-desktop-is-disconnected) и Desktop может войти без запроса. Если не может, [отправьте сообщение](#reconnect-after-sleep-or-a-network-loss).1139* **После спящего режима или потери сети**: вы вернёте выполняющуюся задачу, если процесс [всё ещё работает](#limits-while-desktop-is-disconnected) и Desktop может войти без запроса. Если не может, [отправьте сообщение](#reconnect-after-sleep-or-a-network-loss).

1140* **После закрытия, с Desktop на macOS или Linux и учётной записью Claude**: вы вернёте выполняющуюся задачу, если Desktop сможет [снова присоединиться к процессу](#reopen-a-session-after-you-quit-desktop). Если не сможет, задача остановится. Если она так и остаётся остановленной, отправьте сообщение.1140* **После закрытия**: задача продолжает выполняться, но вы теряете её при повторном открытии сессии, если Desktop не может снова присоединиться к её процессу. Перед закрытием проверьте, [когда Desktop может снова присоединиться](#reopen-a-session-after-you-quit-desktop). Если вы потеряли задачу, отправьте сообщение, чтобы продолжить.

1141* **После закрытия, с Desktop на Windows или со [сторонним провайдером](/docs/ru/third-party-integrations)**: вы теряете выполняющуюся задачу, потому что Desktop завершает процесс при открытии сессии. Отправьте сообщение, чтобы продолжить.

1142 1141

1143Когда вы вернётесь, а задача не выполнена, проверьте, нет ли сообщения о том, что Desktop не может переподключиться, ошибки аутентификации или ожидающего запроса:1142Когда вы вернётесь, а задача не выполнена, проверьте, нет ли сообщения о том, что Desktop не может переподключиться, ошибки аутентификации или ожидающего запроса:

1144 1143

1154</h5>1153</h5>

1155 1154

1156* **Сначала обновитесь**: обновите Desktop перед запуском длительной задачи. На macOS и Windows Desktop может самостоятельно перезапуститься, чтобы установить загруженное обновление. Этот перезапуск ожидает, пока Claude работает над SSH-задачей. На macOS с учётной записью Claude по умолчанию перезапуск всё же может произойти, когда обновление ожидает уже 72 часа.1155* **Сначала обновитесь**: обновите Desktop перед запуском длительной задачи. На macOS и Windows Desktop может самостоятельно перезапуститься, чтобы установить загруженное обновление. Этот перезапуск ожидает, пока Claude работает над SSH-задачей. На macOS с учётной записью Claude по умолчанию перезапуск всё же может произойти, когда обновление ожидает уже 72 часа.

1157* **Не закрывайте Desktop**: если Desktop работает на Windows или использует стороннего провайдера, оставьте его открытым, пока выполняется длительная задача. После закрытия он [завершает выполняющуюся задачу](#reopen-a-session-after-you-quit-desktop) при открытии сессии. Открытый Desktop не защищает запрос, который [ожидает вас](#handle-requests-that-arrive-while-you-are-away).1156* **Не закрывайте Desktop в Windows или до v2.42304.0 со сторонним провайдером**: после закрытия в этих случаях вы теряете выполняющуюся задачу, поэтому оставляйте Desktop открытым во время задачи. В любом другом случае перед закрытием посмотрите, [что вы получите обратно](#reopen-a-session-after-you-quit-desktop).

1158* **Сократите число запросов**: выберите режим разрешений, правила или хуки, благодаря которым [задача будет реже ожидать вас](#handle-requests-that-arrive-while-you-are-away)1157* **Сократите число запросов**: выберите режим разрешений, правила или хуки, благодаря которым [задача будет реже ожидать вас](#handle-requests-that-arrive-while-you-are-away)

1159* **Проверьте jump-хост**: если ваш jump-хост запрашивает вход, например push-уведомление на телефон, перейдите на вход, который работает без запроса. Иначе Desktop может отправлять новое push-уведомление при каждой попытке переподключения.1158* **Проверьте jump-хост**: если ваш jump-хост запрашивает вход, например push-уведомление на телефон, перейдите на вход, который работает без запроса. Иначе Desktop может отправлять новое push-уведомление при каждой попытке переподключения.

1160* **Протестируйте удалённую машину**: запустите короткую задачу, закройте Desktop, пока задача ещё выполняется, и снова откройте сессию значительно позже того момента, когда задача должна была завершиться. Если задача не завершена, а сессия не показывает ошибку аутентификации, проверьте на удалённой машине, [что может завершить задачу](#limits-while-desktop-is-disconnected).1159* **Протестируйте удалённую машину**: запустите короткую задачу, закройте Desktop, пока задача ещё выполняется, и снова откройте сессию значительно позже того момента, когда задача должна была завершиться. Если задача не завершена, а сессия не показывает ошибку аутентификации, проверьте на удалённой машине, [что может завершить задачу](#limits-while-desktop-is-disconnected).

1206 1205

1207Если Claude нужно ваше подтверждение или Claude задаёт вам вопрос, пока Desktop отключён, Claude ожидает на удалённой машине. У этого ожидания нет собственного ограничения по времени. Когда Desktop снова присоединяется к процессу, он показывает вам запрос. Если вместо этого Desktop запускает новый процесс, вы теряете запрос.1206Если Claude нужно ваше подтверждение или Claude задаёт вам вопрос, пока Desktop отключён, Claude ожидает на удалённой машине. У этого ожидания нет собственного ограничения по времени. Когда Desktop снова присоединяется к процессу, он показывает вам запрос. Если вместо этого Desktop запускает новый процесс, вы теряете запрос.

1208 1207

1209Пока задача ожидает вас, Desktop может самостоятельно перезапуститься, например чтобы установить обновление. Если Desktop работает на Windows или использует стороннего провайдера, после такого перезапуска вы теряете запрос.1208Если запрос, который ждал вас, пропал к вашему возвращению, одна из причин — Desktop перезапустился сам, например чтобы установить обновление. Запрос сохраняется после перезапуска, только если Desktop может снова присоединиться к процессу, поэтому, прежде чем оставить задачу выполняться, проверьте, [когда Desktop может снова присоединиться](#reopen-a-session-after-you-quit-desktop).

1210 1209

1211Если вы потеряли запрос, отправьте сообщение, чтобы продолжить.1210Если вы потеряли запрос, отправьте сообщение, чтобы продолжить.

1212 1211

1238 - **Jump-хост, push-уведомления продолжают приходить**: там, где Desktop не может определить, что никто не отвечает, как в случае Desktop на Windows, он продолжает попытки, пока у него есть процесс, к которому можно снова присоединиться, независимо от того, работает ли этот процесс. С каждой попыткой вы можете получать новое push-уведомление. Чтобы прекратить попытки, закройте Desktop, что [может стоить вам выполняющейся задачи](#reopen-a-session-after-you-quit-desktop).1237 - **Jump-хост, push-уведомления продолжают приходить**: там, где Desktop не может определить, что никто не отвечает, как в случае Desktop на Windows, он продолжает попытки, пока у него есть процесс, к которому можно снова присоединиться, независимо от того, работает ли этот процесс. С каждой попыткой вы можете получать новое push-уведомление. Чтобы прекратить попытки, закройте Desktop, что [может стоить вам выполняющейся задачи](#reopen-a-session-after-you-quit-desktop).

1239 - **Длительный перебой**: Desktop замедляется примерно до одной попытки каждые пять минут. Чтобы переподключиться быстрее, повторите попытку в сессии или отправьте сообщение, которое Desktop доставит после подключения.1238 - **Длительный перебой**: Desktop замедляется примерно до одной попытки каждые пять минут. Чтобы переподключиться быстрее, повторите попытку в сессии или отправьте сообщение, которое Desktop доставит после подключения.

1240 - **Отсутствующий вывод**: пока Desktop отключён, помощник хранит самый последний вывод Claude Code каждой сессии в буфере размером 16 MiB и отбрасывает более старый вывод. После переподключения Desktop сессия может показывать `Loading recent output from <host>…`. Если Desktop не может загрузить весь вывод, вы увидите строку `Some output produced while you were disconnected may be missing here.` Эта строка не означает, что задача остановилась.1239 - **Отсутствующий вывод**: пока Desktop отключён, помощник хранит самый последний вывод Claude Code каждой сессии в буфере размером 16 MiB и отбрасывает более старый вывод. После переподключения Desktop сессия может показывать `Loading recent output from <host>…`. Если Desktop не может загрузить весь вывод, вы увидите строку `Some output produced while you were disconnected may be missing here.` Эта строка не означает, что задача остановилась.

1241 - **Процесс исчез**: если процесс исчез к моменту переподключения Desktop, Desktop может запустить новый на основе сохранённой истории диалога и сказать Claude продолжить задачу. Desktop не продолжает задачу самостоятельно, если процесс продолжает завершаться или если Desktop использует стороннего провайдера. Отправьте сообщение, чтобы продолжить.1240 - **Процесс пропал**: процесс завершился, пока Desktop был отключён, например при перезапуске удалённой машины. Тогда Desktop может запустить новый процесс из сохранённой истории диалога и сказать Claude продолжить задачу. Если задача остаётся остановленной, отправьте сообщение. Со сторонним провайдером обновитесь до Claude Desktop v2.42304.0 или новее, поскольку более ранние версии никогда не продолжают задачу самостоятельно.

1242</Accordion>1241</Accordion>

1243 1242

1244<a id="reopen-a-session-after-you-quit-desktop" />1243<a id="reopen-a-session-after-you-quit-desktop" />

1247 Повторное открытие сессии после закрытия Desktop1246 Повторное открытие сессии после закрытия Desktop

1248</h5>1247</h5>

1249 1248

1250После того как вы закроете Desktop, задача продолжает выполняться на удалённой машине, пока не завершится, не потребует вашего участия или не достигнет одного из [ограничений](#limits-while-desktop-is-disconnected).1249После закрытия Desktop задача продолжает выполняться на удалённой машине, но останавливается при повторном открытии сессии, если Desktop не может снова присоединиться к её процессу. Пока Desktop закрыт, задача выполняется, пока не завершится, не потребует вашего участия или не достигнет одного из [ограничений](#limits-while-desktop-is-disconnected).

1251 1250

1252* **Desktop на macOS или Linux, с учётной записью Claude**: запустите Desktop и откройте сессию. Вы вернёте выполняющуюся задачу, если Desktop сможет снова присоединиться к процессу. Это возможно не всегда, например после некоторых обновлений Desktop или после того, как ваша организация изменит свои управляемые настройки.1251* **Desktop в Windows**: вы не получите выполняющуюся задачу обратно, поскольку Desktop никогда не присоединяется снова после закрытия. Запускайте Desktop снова только когда ожидаете, что задача завершена, поскольку сессия может открыться при запуске Desktop.

1253* **На macOS или Linux, когда Desktop не может снова присоединиться**: Desktop завершает процесс и запускает новый на основе сохранённой истории диалога. Ваша выполняющаяся задача останавливается, и вы теряете любое ожидавшее вас подтверждение или вопрос. После обновления Desktop затем может сказать Claude продолжить. Если задача так и остаётся остановленной, отправьте сообщение.1252* **Сторонний провайдер, задача из более ранней версии**: если вы запустили задачу в версии Desktop до v2.42304.0, вы не получите её обратно и в macOS или Linux. Запускайте Desktop снова только когда ожидаете, что задача завершена.

1254* **Desktop на Windows или со сторонним провайдером на любой платформе**: запускайте Desktop снова только тогда, когда ожидаете, что задача уже выполнена. Вы не вернёте выполняющуюся задачу, потому что после закрытия Desktop никогда не присоединяется к процессу снова. Он завершает процесс при открытии сессии, что может произойти при запуске Desktop. Отправьте сообщение, чтобы продолжить.1253* **Любая другая задача, с Desktop в macOS или Linux**: запустите Desktop и откройте сессию, и задача продолжится, если Desktop снова присоединится. Это возможно не всегда, например после некоторых обновлений Desktop, поэтому [обновитесь перед длительной задачей](#prepare-a-long-task).

1254

1255Когда Desktop не может снова присоединиться, вы также теряете любое подтверждение или вопрос, которые вас ожидали. Если задача не продолжается сама, отправьте сообщение, и Claude продолжит из сохранённой истории диалога.

1255 1256

1256Для сторонних развёртываний см. [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).1257Для сторонних развёртываний см. [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).

1257 1258

features-overview.md +1 −1

Details

186 | - | - | - |186 | - | - | - |

188 | **Запущено** | [События жизненного цикла](/docs/ru/hooks#hook-events), такие как `PostToolUse` или `SessionStart` | Ты печатаешь `/<name>`, или Claude соответствует описанию твоей задаче |188 | **Запущено** | [События жизненного цикла](/docs/ru/hooks#hook-events), такие как `PostToolUse` или `SessionStart` | Ты печатаешь `/<name>`, или Claude соответствует описанию твоей задаче |

191 | **Лучше всего для** | Линтинг после редактирования, блокирование небезопасных команд, логирование, уведомления | Рабочие процессы, которые нуждаются в рассуждении, справочный материал, многошаговые задачи |191 | **Лучше всего для** | Линтинг после редактирования, блокирование небезопасных команд, логирование, уведомления | Рабочие процессы, которые нуждаются в рассуждении, справочный материал, многошаговые задачи |

192 192

hooks.md +1 −1

Details

1832 1832

1833Используйте [управление решениями PreToolUse](#pretooluse-decision-control), чтобы разрешить, запретить, запросить подтверждение или отложить вызов инструмента.1833Используйте [управление решениями PreToolUse](#pretooluse-decision-control), чтобы разрешить, запретить, запросить подтверждение или отложить вызов инструмента.

1834 1834

1835[Callback-хук Agent SDK](/docs/ru/agent-sdk/hooks) на `PreToolUse`, превысивший таймаут, блокирует вызов инструмента, и Claude получает результат с ошибкой, указывающий на таймаут. Явный запрет, возвращённый другим хуком, по-прежнему имеет приоритет.1835[Callback-хук Agent SDK](/docs/ru/agent-sdk/hooks) на `PreToolUse`, превысивший таймаут, блокирует вызов инструмента, и Claude получает результат с ошибкой, в которой указан таймаут.

1836 1836

1837<h4 id="pretooluse-input">1837<h4 id="pretooluse-input">

1838 Входные данные PreToolUse1838 Входные данные PreToolUse

large-codebases.md +1 −1

Details

213Если установка не удаётся, сопоставьте сообщение, которое сообщает Claude Code:213Если установка не удаётся, сопоставьте сообщение, которое сообщает Claude Code:

214 214

215* `Marketplace "claude-plugins-official" not found`: добавьте маркетплейс с помощью `/plugin marketplace add anthropics/claude-plugins-official`, затем повторите попытку установки.215* `Marketplace "claude-plugins-official" not found`: добавьте маркетплейс с помощью `/plugin marketplace add anthropics/claude-plugins-official`, затем повторите попытку установки.

216* Плагин [не найден в маркетплейсе](/docs/ru/plugins/install#install-a-plugin): проверьте имя плагина.216* `Plugin "<name>" not found in marketplace "claude-plugins-official"`: ваша локальная копия каталога маркетплейса может быть устаревшей. Обновите её с помощью `/plugin marketplace update claude-plugins-official`, затем повторите попытку установки. Если повторная попытка выводит то же сообщение, см. [Plugin not found in marketplace](/docs/ru/plugins/troubleshooting#plugin-not-found-in-marketplace).

217 217

218Чтобы включить плагин для всех в репозитории, а не устанавливать его самостоятельно, добавьте его в параметр проекта [`enabledPlugins`](/docs/ru/settings-reference#plugin-settings).218Чтобы включить плагин для всех в репозитории, а не устанавливать его самостоятельно, добавьте его в параметр проекта [`enabledPlugins`](/docs/ru/settings-reference#plugin-settings).

219 219

mcp.md +2 −2

Details

49 49

50 Если установка не удается, сопоставьте сообщение, которое сообщает Claude Code:50 Если установка не удается, сопоставьте сообщение, которое сообщает Claude Code:

51 51

52 * `Marketplace "claude-plugins-official" not found`: добавьте marketplace с помощью `/plugin marketplace add anthropics/claude-plugins-official`, затем повторите попытку установки.52 * `Marketplace "claude-plugins-official" not found`: добавьте маркетплейс с помощью `/plugin marketplace add anthropics/claude-plugins-official`, затем повторите попытку установки.

~~53 * Плагин [не найден в marketplace](/docs/ru/plugins/install#install-a-plugin): проверьте имя плагина.~~53 * `Plugin "<name>" not found in marketplace "claude-plugins-official"`: ваша локальная копия каталога маркетплейса может быть устаревшей. Обновите ее с помощью `/plugin marketplace update claude-plugins-official`, затем повторите попытку установки. Если при повторной попытке выводится то же сообщение, см. [Плагин не найден в маркетплейсе](/docs/ru/plugins/troubleshooting#plugin-not-found-in-marketplace).

54 54

55 Если в сводке установки указано `Run /reload-plugins to apply.`, Claude Code затем запустит эту перезагрузку для вас. Если перезагрузка предупреждает, что ваше следующее сообщение повторно прочитает диалог, выполните `/reload-plugins --force`.55 Если в сводке установки указано `Run /reload-plugins to apply.`, Claude Code затем запустит эту перезагрузку для вас. Если перезагрузка предупреждает, что ваше следующее сообщение повторно прочитает диалог, выполните `/reload-plugins --force`.

56 </Step>56 </Step>

monitoring-usage.md +1 −1

Details

772**Атрибуты**:772**Атрибуты**:

773 773

774* Все [стандартные атрибуты](#standard-attributes)774* Все [стандартные атрибуты](#standard-attributes)

775* `type`: (`"input"`, `"output"`, `"cacheRead"`, `"cacheCreation"`). Тип `"input"` исключает токены, прочитанные из кэша промптов или записанные в него, — они учитываются в `"cacheRead"` и `"cacheCreation"`775* `type`: (`"input"`, `"output"`, `"cacheRead"`, `"cacheCreation"`). Тип `"input"` не включает токены, прочитанные из кэша промптов или записанные в него, — они учитываются в `"cacheRead"` и `"cacheCreation"`. Тип `"cacheCreation"` учитывает записи в кэш с пятиминутным и часовым [временем жизни кэша](/docs/ru/prompt-caching#cache-lifetime) вместе.

776* `model`: Идентификатор модели (например, "claude-sonnet-5")776* `model`: Идентификатор модели (например, "claude-sonnet-5")

777* `query_source`: Категория подсистемы, которая выдала запрос. Один из `"main"`, `"subagent"` или `"auxiliary"`777* `query_source`: Категория подсистемы, которая выдала запрос. Один из `"main"`, `"subagent"` или `"auxiliary"`

778* `speed`: `"fast"`, когда запрос использовал быстрый режим. Отсутствует в противном случае778* `speed`: `"fast"`, когда запрос использовал быстрый режим. Отсутствует в противном случае

permissions.md +0 −2

Details

749Эти проверки по-прежнему применяются:749Эти проверки по-прежнему применяются:

750 750

751* Правила запроса с областью действия контента, такие как `Bash(git push *)`, по-прежнему требуют запроса751* Правила запроса с областью действия контента, такие как `Bash(git push *)`, по-прежнему требуют запроса

752* Явные правила отказа по-прежнему применяются

753* Команды `rm` или `rmdir`, которые нацелены на [критический путь](/docs/ru/permission-modes#critical-paths), по-прежнему проходят через обычный поток разрешений

754* Другие команды в песочнице также могут проходить через обычный поток разрешений, как описано в разделе [Режим автоматического разрешения](/docs/ru/sandboxing#auto-allow-mode)752* Другие команды в песочнице также могут проходить через обычный поток разрешений, как описано в разделе [Режим автоматического разрешения](/docs/ru/sandboxing#auto-allow-mode)

755 753

756Команды, которые не будут выполняться в песочнице, такие как исключённые команды, соблюдают простое правило запроса `Bash` как обычно. См. [режимы песочницы](/docs/ru/sandboxing#sandbox-modes) для изменения этого поведения.754Команды, которые не будут выполняться в песочнице, такие как исключённые команды, соблюдают простое правило запроса `Bash` как обычно. См. [режимы песочницы](/docs/ru/sandboxing#sandbox-modes) для изменения этого поведения.

plugins/mods/admin.md +1 −1

Details

78 78

79Моды не заменяют элементы управления, которые у вас уже есть:79Моды не заменяют элементы управления, которые у вас уже есть:

80 80

81* **Hooks параметров продолжают работать.** Hooks команд, HTTP, запросов и агентов в файлах параметров и в `hooks/hooks.json` плагинов работают как раньше, наряду с модами. Ничего в них не устарело.81* **Хуки настроек продолжают работать.** Хуки команд, HTTP, промптов и агентов в файлах настроек и в `hooks/hooks.json` плагинов работают как раньше, наряду с модами.

82* **Правила отказа имеют приоритет, где загружается защита.** Мод пользователя не может одобрить вызов, который правило `deny` отказывает, если вы не установите [`allowModsToOverrideDenyRules`](#set-options-on-the-built-in-guard).82* **Правила отказа имеют приоритет, где загружается защита.** Мод пользователя не может одобрить вызов, который правило `deny` отказывает, если вы не установите [`allowModsToOverrideDenyRules`](#set-options-on-the-built-in-guard).

83* **Управляемые hooks работают первыми.** Hook `PreToolUse` в управляемых параметрах работает перед тем, как любой мод увидит вызов инструмента, и его блокировка окончательна. Если мод затем переписывает вызов, ваши управляемые hooks работают снова на переписанном вызове, поэтому блокировка по-прежнему применяется. Hooks `PreToolUse` из других файлов параметров и из плагинов работают после последнего мода, поэтому мод, который возвращает свой собственный результат вместо запуска инструмента, не позволяет им работать. См. [Порядок, в котором работают моды](/docs/ru/plugins/mods/events#the-order-mods-run-in).83* **Управляемые hooks работают первыми.** Hook `PreToolUse` в управляемых параметрах работает перед тем, как любой мод увидит вызов инструмента, и его блокировка окончательна. Если мод затем переписывает вызов, ваши управляемые hooks работают снова на переписанном вызове, поэтому блокировка по-прежнему применяется. Hooks `PreToolUse` из других файлов параметров и из плагинов работают после последнего мода, поэтому мод, который возвращает свой собственный результат вместо запуска инструмента, не позволяет им работать. См. [Порядок, в котором работают моды](/docs/ru/plugins/mods/events#the-order-mods-run-in).

84* **Сетевая политика охватывает `$.http.fetch`.**84* **Сетевая политика охватывает `$.http.fetch`.**

plugins/mods/gallery.md +1 −1

Details

114 `Text`114 `Text`

115</h3>115</h3>

116 116

117`Text` отрисовывает строку с заданными вами стилями. В этом примере каждому стилю соответствует одна строка:117`Text` отрисовывает строку с заданными вами стилями. В этом примере показаны обычный текст и восемь стилей, каждый на отдельной строке:

118 118

119```javascript theme={null}119```javascript theme={null}

120Box({120Box({

plugins/mods/interface.md +2 −2

Details

455 455

456| Элемент | Что он рисует | Где |456| Элемент | Что он рисует | Где |

457| :- | :- | :- |457| :- | :- | :- |

458| `Box` | Контейнер flex. Принимает пропсы макета, такие как `flexDirection`, `columnGap`, `padding`, [`borderStyle`](/docs/ru/plugins/mods/reference#box-border-styles) и `width`. | Везде |458| `Box` | Контейнер flex. Принимает пропсы макета, такие как `flexDirection`, [`borderStyle`](/docs/ru/plugins/mods/reference#box-border-styles) и `width`. Пропсы отступов, такие как `columnGap` и `padding`, принимают число или [имя шага](/docs/ru/plugins/mods/reference#box-spacing-steps) от `'xs'` до `'xl'`. | Везде |

459| `Text` | Стилизованный текст. Принимает `color`, `bold`, `dimColor`, `italic` и `wrap`. `color` — это ключ темы или цвет, такой как `'red'`. `wrap` — это `'wrap'`, `'truncate'`, `'truncate-start'`, `'truncate-middle'` или `'truncate-end'`. | Везде |459| `Text` | Стилизованный текст. Принимает `color`, `bold`, `dimColor`, `italic`, `wrap` и другие, такие как [`weight`](/docs/ru/plugins/mods/reference#text-typography). `color` — это ключ темы или цвет, такой как `'red'`. `wrap` — это `'wrap'`, `'truncate'`, `'truncate-start'`, `'truncate-middle'` или `'truncate-end'`. | Везде |

461| `Link`, `Code`, `Markdown` | Ссылка с `href` и необязательной `label`, блок кода и текст, отформатированный так, как ответы Claude. `Markdown` принимает свое содержимое в свойстве `text`, а не в `children`, и нуждается в `key`, когда вы передаете `onLinkPress`. | Везде |461| `Link`, `Code`, `Markdown` | Ссылка с `href` и необязательной `label`, блок кода и текст, отформатированный так, как ответы Claude. `Markdown` принимает свое содержимое в свойстве `text`, а не в `children`, и нуждается в `key`, когда вы передаете `onLinkPress`. | Везде |

plugins/mods/reference.md +44 −2

Details

293 293

295| :- | :- | :-: | :-: | :-: |295| :- | :- | :-: | :-: | :-: |

296| [`Box`](/docs/ru/plugins/mods/interface#build-a-tree-from-elements) | `key`, flex-раскладка, `gap`, `padding`, `margin`, `width`, `height`, [`borderStyle`](#box-border-styles), `backgroundColor`, `position`, `hover` | ✓ | ✓ | ✓ |296| [`Box`](/docs/ru/plugins/mods/interface#build-a-tree-from-elements) | `key`, flex-раскладка, [`gap`, `padding`, `margin`](#box-spacing-steps), `width`, `height`, [`borderStyle`](#box-border-styles), `backgroundColor`, `position`, `hover` | ✓ | ✓ | ✓ |

297| [`Text`](/docs/ru/plugins/mods/interface#build-a-tree-from-elements) | `color`, `backgroundColor`, `bold`, `italic`, `underline`, `dimColor`, `inverse`, `wrap` | ✓ | ✓ | ✓ |297| [`Text`](/docs/ru/plugins/mods/interface#build-a-tree-from-elements) | `color`, `backgroundColor`, [`bold`](#text-bold), `italic`, `underline`, `dimColor`, `inverse`, `wrap`, [`size`, `weight`, `mono`, `tabular`](#text-typography) | ✓ | ✓ | ✓ |

298| [`Button`](/docs/ru/plugins/mods/interface#respond-to-presses-and-typing) | `key`, `label`, `onPress`, `hotkey`, `plain`, `dimColor`, `autoFocus`, `action` | ✓ | ✓ | ✓ |298| [`Button`](/docs/ru/plugins/mods/interface#respond-to-presses-and-typing) | `key`, `label`, `onPress`, `hotkey`, `plain`, `dimColor`, `autoFocus`, `action` | ✓ | ✓ | ✓ |

299| [`Link`](/docs/ru/plugins/mods/interface#link-in-the-desktop-app) | `href`, `label`. См. [Ограничения](#limits). | ✓ | ✓ | ✓ |299| [`Link`](/docs/ru/plugins/mods/interface#link-in-the-desktop-app) | `href`, `label`. См. [Ограничения](#limits). | ✓ | ✓ | ✓ |

300| [`Code`](/docs/ru/plugins/mods/gallery#show-code-and-changes) | `source`, `language`, `path`, `startLine`, `format`, `wrap` | ✓ | ✓ | ✓ |300| [`Code`](/docs/ru/plugins/mods/gallery#show-code-and-changes) | `source`, `language`, `path`, `startLine`, `format`, `wrap` | ✓ | ✓ | ✓ |

311Расширение VS Code игнорирует некоторые пропсы элементов и рисует элемент так, как если бы вы их не указали:311Расширение VS Code игнорирует некоторые пропсы элементов и рисует элемент так, как если бы вы их не указали:

312 312

313* **`Box`**: `position` и `hover`313* **`Box`**: `position` и `hover`

314* **`Text`**: `size`, `mono` и `tabular`

314* **`Button`**: `hotkey`, `plain`, `autoFocus` и `action`, поэтому там пользователь нажимает кнопку щелчком или клавишей Enter, когда кнопка в фокусе315* **`Button`**: `hotkey`, `plain`, `autoFocus` и `action`, поэтому там пользователь нажимает кнопку щелчком или клавишей Enter, когда кнопка в фокусе

315* **`Code`**: `language`, `path`, `startLine`, `format` и `wrap`, поэтому код рисуется без цветов и номеров строк, а блок с `format: 'diff'` показывает необработанный текст diff316* **`Code`**: `language`, `path`, `startLine`, `format` и `wrap`, поэтому код рисуется без цветов и номеров строк, а блок с `format: 'diff'` показывает необработанный текст diff

316* **`Input` и `Select`**: `autoFocus`317* **`Input` и `Select`**: `autoFocus`

336 337

337`Box`, у которого `borderStyle` указывает любое другое имя, например `'rounded'`, рисуется без рамки.338`Box`, у которого `borderStyle` указывает любое другое имя, например `'rounded'`, рисуется без рамки.

338 339

340<h3 id="box-spacing-steps">

341 Шаги отступов `Box`

342</h3>

343

344Пропсы отступов `Box` — это `gap`, `columnGap`, `rowGap`, `padding`, `margin`, а также формы `padding` и `margin` для одной стороны и одной оси, например `paddingX` и `marginTop`. Каждый из них принимает число ячеек терминала, например `gap: 1`, или имя шага, например `gap: 'md'`. В терминале и расширении VS Code каждый шаг равен следующему числу ячеек:

345

346| Шаг | Ячеек по горизонтали | Ячеек по вертикали |

347| :- | :- | :- |

348| `'xs'` | 1 | 0 |

349| `'sm'` | 1 | 0 |

350| `'md'` | 2 | 1 |

351| `'lg'` | 3 | 1 |

352| `'xl'` | 4 | 2 |

353

354Если задать для `gap`, `padding` или `margin` шаг, он применяется сразу и по горизонтали, и по вертикали. Например, в терминале и расширении VS Code `padding: 'md'` означает две ячейки с каждой стороны и одну строку сверху и снизу.

355

356Имена шагов требуют Claude Code v2.1.299 или более поздней версии. В более ранних выпусках Claude Code [рисует собственную версию сайта](/docs/ru/plugins/mods/interface#build-a-tree-from-elements) вместо дерева, в котором используется имя шага.

357

358<h3 id="text-typography">

359 Типографские пропсы `Text`

360</h3>

361

362Задайте `size`, `weight`, `mono` или `tabular` для `Text`, чтобы запросить у приложения, рисующего ваше дерево, размер текста, насыщенность, моноширинный шрифт или цифры одинаковой ширины. Прежде чем полагаться на проп, проверьте, что делают с ним терминал и расширение VS Code. Если приложение игнорирует заданный вами проп, ваше дерево всё равно рисуется там, а текст выглядит так, как если бы вы этот проп не указали.

363

365| :- | :- | :- | :- |

369| `tabular` | `true`, чтобы запросить цифры одинаковой ширины, чтобы число, обновляемое на месте, или столбец чисел оставались выровненными | Игнорируется: цифры в терминале и так занимают одну ячейку | Игнорируется |

370

371Эти четыре пропса требуют Claude Code v2.1.299 или более поздней версии. В более ранних выпусках Claude Code [рисует собственную версию сайта](/docs/ru/plugins/mods/interface#build-a-tree-from-elements) вместо дерева, в котором задан `size`, `weight`, `mono` или `tabular`.

372

373<h4 id="text-bold">

374 Замена `bold` на `weight`

375</h4>

376

377`bold` для `Text` объявлен устаревшим в пользу `weight`, но по-прежнему работает. Чтобы заменить его для `Text` без `weight`, измените `bold: true` на `weight: 'semibold'` — в Claude Code v2.1.299 или более поздней версии результат будет тем же.

378

379В выпусках до v2.1.299 дерево, в котором задан `weight`, не рисуется, и вместо него Claude Code [рисует собственную версию сайта](/docs/ru/plugins/mods/interface#build-a-tree-from-elements). Если задать для `Text` и `bold`, и `weight`, `bold` не действует.

380

339<h2 id="limits">381<h2 id="limits">

340 Ограничения382 Ограничения

341</h2>383</h2>

plugins/mods/troubleshoot.md +13 −0

Details

235 235

236Мод загрузился, и его панель, полоса, всплывающее уведомление или элементы управления не ведут себя так, как вы ожидаете.236Мод загрузился, и его панель, полоса, всплывающее уведомление или элементы управления не ведут себя так, как вы ожидаете.

237 237

238<h3 id="another-mods-band-shows-and-yours-doesnt">

239 Полоса другого мода отображается, а ваша нет

240</h3>

241

242Над промптом есть одна полоса, и все моды используют ее совместно. Мод, который выполняется [до вашего](/docs/ru/plugins/mods/events#the-order-mods-run-in), заменяет вашу полосу, когда возвращает дерево, в котором нет результата `next(e)`. Чтобы показать обе полосы, измените хук этого мода или попросите его автора сделать это:

243

244* **Сохраните полосы после него**: поместите результат `await next(e)` среди дочерних элементов `Box` в его дереве, как на вкладке Band above the prompt в разделе [Выберите, где рисовать](/docs/ru/plugins/mods/interface#pick-where-to-draw)

245* **Сохраните дерево валидным**: не задавайте этому `Box` или любому `Box` вокруг него проп `width`, `height`, `minWidth`, `minHeight`, `position`, `top`, `left`, `right`, `bottom`, `display` или `overflow`

246

247Чтобы найти этот мод, [запишите лог отладки](#read-the-debug-log) и найдите в нем `answered ui.render without next()`. Строка вроде `other-mod (user) answered ui.render without next()` называет мод, который вернул свое дерево, не вызвав `next(e)`. Она не называет [точку отрисовки](/docs/ru/plugins/mods/reference#render-sites), поэтому в ней может оказаться и мод, который рисует только панель. Для мода, который вызывает `next(e)` и отбрасывает результат, строки нет, поэтому проверьте также хуки, выполняемые до вашего.

248

249После изменения вы ничего не увидите в полосе, если любой из модов вернет дерево, которое не проходит валидацию. Чтобы узнать причину, найдите строку `ui.render (AbovePrompt) refused:` в транскрипте сессии `--plugin-dir` или найдите в логе отладки `does not validate`. Когда в полосе несколько модов, ни одна из этих строк не называет мод, поэтому проверьте дерево каждого мода.

250

238<h3 id="a-pane-or-band-is-empty-or-shows-claude-code’s-usual-content">251<h3 id="a-pane-or-band-is-empty-or-shows-claude-code’s-usual-content">

239 Панель или полоса пуста или показывает обычное содержимое Claude Code252 Панель или полоса пуста или показывает обычное содержимое Claude Code

240</h3>253</h3>

sandboxing.md +2 −2

Details

199 199

200Даже в режиме auto-allow по-прежнему действует следующее:200Даже в режиме auto-allow по-прежнему действует следующее:

201 201

202* Явные [правила запрета](/docs/ru/permissions) всегда соблюдаются202* Команда в [форме, которой соответствует правило запрета `Bash`](/docs/ru/permissions#bash-rule-limits), по-прежнему блокируется

203* Команды `rm` или `rmdir`, нацеленные на [критический путь](/docs/ru/permission-modes#critical-paths), по-прежнему проходят обычный процесс получения разрешений203* Команды `rm` или `rmdir`, распознанные как нацеленные на [критический путь](/docs/ru/permission-modes#which-paths-are-critical), по-прежнему проходят обычный процесс получения разрешений

204* [Правила запроса](/docs/ru/permissions) с ограничением по содержимому, например `Bash(git push *)`, по-прежнему вызывают запрос даже для команд в песочнице204* [Правила запроса](/docs/ru/permissions) с ограничением по содержимому, например `Bash(git push *)`, по-прежнему вызывают запрос даже для команд в песочнице

205* Голое правило запроса `Bash` или эквивалентная форма `Bash(*)` пропускается для команд, выполняемых в песочнице; оно по-прежнему применяется к командам, которые выполняются вне песочницы. В [режиме планирования](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode) правило не пропускается: оно вызывает запрос и для команд в песочнице, включая команды только для чтения205* Голое правило запроса `Bash` или эквивалентная форма `Bash(*)` пропускается для команд, выполняемых в песочнице; оно по-прежнему применяется к командам, которые выполняются вне песочницы. В [режиме планирования](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode) правило не пропускается: оно вызывает запрос и для команд в песочнице, включая команды только для чтения

206* Команды [инструмента Monitor](/docs/ru/tools-reference#monitor-tool) не подтверждаются автоматически, хотя по-прежнему выполняются в песочнице. Чтобы пропустить запрос, добавьте [правило разрешения](/docs/ru/permissions#bash), соответствующее команде, например `Bash(npm run *)`206* Команды [инструмента Monitor](/docs/ru/tools-reference#monitor-tool) не подтверждаются автоматически, хотя по-прежнему выполняются в песочнице. Чтобы пропустить запрос, добавьте [правило разрешения](/docs/ru/permissions#bash), соответствующее команде, например `Bash(npm run *)`

security.md +1 −1

Details

114 Безопасность IDE114 Безопасность IDE

115</h2>115</h2>

116 116

117См. [Безопасность и конфиденциальность VS Code](/docs/ru/vs-code#security-and-privacy) для получения дополнительной информации о запуске Claude Code в IDE.117См. [Встроенный MCP-сервер IDE](/docs/ru/vs-code#the-built-in-ide-mcp-server) для получения дополнительной информации о запуске Claude Code в IDE.

118 118

119<h2 id="cloud-execution-security">119<h2 id="cloud-execution-security">

120 Безопасность облачного выполнения120 Безопасность облачного выполнения

security-guidance.md +1 −1

Details

42Если установка не удалась, сопоставьте сообщение, которое сообщает Claude Code:42Если установка не удалась, сопоставьте сообщение, которое сообщает Claude Code:

43 43

44* `Marketplace "claude-plugins-official" not found`: добавьте маркетплейс с помощью `/plugin marketplace add anthropics/claude-plugins-official`, затем повторите попытку установки.44* `Marketplace "claude-plugins-official" not found`: добавьте маркетплейс с помощью `/plugin marketplace add anthropics/claude-plugins-official`, затем повторите попытку установки.

~~45* Плагин [не найден в маркетплейсе](/docs/ru/plugins/install#install-a-plugin): проверьте имя плагина.~~45* `Plugin "<name>" not found in marketplace "claude-plugins-official"`: ваша локальная копия каталога маркетплейса может быть устаревшей. Обновите её с помощью `/plugin marketplace update claude-plugins-official`, затем повторите попытку установки. Если повторная попытка выводит то же сообщение, см. [Plugin not found in marketplace](/docs/ru/plugins/troubleshooting#plugin-not-found-in-marketplace).

46 46

47Проверьте сводку установки. Если она сообщает `Run /reload-plugins to apply.`, см. [Apply plugin changes without restarting](/docs/ru/plugins/cli-reference#reload-plugins), чтобы активировать плагин в вашей текущей сессии.47Проверьте сводку установки. Если она сообщает `Run /reload-plugins to apply.`, см. [Apply plugin changes without restarting](/docs/ru/plugins/cli-reference#reload-plugins), чтобы активировать плагин в вашей текущей сессии.

48 48

skills.md +9 −5

Details

718 718

719Если вы вызываете skill с аргументами, но ни один заполнитель в содержимом skill не получает один, Claude Code добавляет `ARGUMENTS: <your input>` в конец содержимого skill, чтобы Claude все еще видел, что вы ввели. Заполнитель — это `$ARGUMENTS`, индексированная форма, такая как `$1`, или именованный аргумент. Индексированный заполнитель без аргумента в его позиции остается как буквальный текст и не считается получившим один. Именованный заполнитель считается даже когда его позиция не имеет аргумента, потому что он расширяется до пустой строки.719Если вы вызываете skill с аргументами, но ни один заполнитель в содержимом skill не получает один, Claude Code добавляет `ARGUMENTS: <your input>` в конец содержимого skill, чтобы Claude все еще видел, что вы ввели. Заполнитель — это `$ARGUMENTS`, индексированная форма, такая как `$1`, или именованный аргумент. Индексированный заполнитель без аргумента в его позиции остается как буквальный текст и не считается получившим один. Именованный заполнитель считается даже когда его позиция не имеет аргумента, потому что он расширяется до пустой строки.

720 720

721Вы также можете складывать несколько skills в начале одного сообщения. Ввод `/write-tests /fix-issue 123` загружает оба skills и передает конечный текст `123` как `$ARGUMENTS` каждому из них.

~~722~~

723Claude Code расширяет первый skill плюс до пяти дополнительных, сложенных после него. Расширение останавливается на первом токене, который не является встроенным skill, вызываемым пользователем, поэтому skill, который запускается как [субагент fork](#run-skills-in-a-subagent), такой как [`/code-review`](/docs/ru/code-review-local), или тот, чьи аргументы сами могут начинаться со слеш-команды, такой как `/loop`, также заканчивает последовательность там. Этот токен и все, что после него, становятся текстом аргумента для каждого расширенного skill. `/code-review` запускается как субагент fork с v2.1.218; на более ранних версиях он запускался встроенным и складывался.

~~724~~

725Чтобы получить доступ к отдельным аргументам по позиции, используйте `$ARGUMENTS[N]` или более короткий `$N`:721Чтобы получить доступ к отдельным аргументам по позиции, используйте `$ARGUMENTS[N]` или более короткий `$N`:

726 722

727```yaml theme={null}723```yaml theme={null}

746Preserve all existing behavior and tests.742Preserve all existing behavior and tests.

747```743```

748 744

745<h4 id="stack-several-skills-in-one-message">

746 Несколько skills в одном сообщении

747</h4>

748

749Когда вы вводите текст в поле промпта Claude Code в терминале, вы можете указать несколько skills подряд в начале одного сообщения. Через Agent SDK или `claude -p` Claude Code загружает только первый skill, а остальная часть строки становится его аргументами. В поле промпта терминала ввод `/write-tests /fix-issue 123` загружает оба skills и передает конечный текст `123` как `$ARGUMENTS` каждому из них.

750

751Claude Code расширяет первый skill плюс до пяти дополнительных, указанных после него. Расширение останавливается на первом токене, который не является встроенным skill, вызываемым пользователем. Если вы указываете skill, который запускается как [субагент fork](#run-skills-in-a-subagent), например [`/code-review`](/docs/ru/code-review-local), или skill, чьи аргументы могут начинаться с другой команды, например `/loop`, расширение на этом заканчивается. Этот токен и все, что после него, становятся текстом аргумента для каждого расширенного skill.

752

749<h2 id="advanced-patterns">753<h2 id="advanced-patterns">

750 Продвинутые приёмы754 Продвинутые приёмы

751</h2>755</h2>

1044Если установка не удалась, сопоставьте сообщение, которое сообщает Claude Code:1048Если установка не удалась, сопоставьте сообщение, которое сообщает Claude Code:

1045 1049

1046* `Marketplace "claude-plugins-official" not found`: добавьте marketplace с помощью `/plugin marketplace add anthropics/claude-plugins-official`, затем повторите попытку установки.1050* `Marketplace "claude-plugins-official" not found`: добавьте marketplace с помощью `/plugin marketplace add anthropics/claude-plugins-official`, затем повторите попытку установки.

1047* Плагин [не найден в marketplace](/docs/ru/plugins/install#install-a-plugin): проверьте имя плагина.1051* `Plugin "<name>" not found in marketplace "claude-plugins-official"`: ваша локальная копия каталога маркетплейса может быть устаревшей. Обновите ее с помощью `/plugin marketplace update claude-plugins-official`, затем повторите попытку установки. Если повторная попытка выводит то же сообщение, см. [Плагин не найден в маркетплейсе](/docs/ru/plugins/troubleshooting#plugin-not-found-in-marketplace).

1048 1052

1049Если сводка установки сообщает `Run /reload-plugins to apply.`, Claude Code затем сам выполняет эту перезагрузку. Если при перезагрузке появляется предупреждение о том, что ваше следующее сообщение повторно прочитает диалог, выполните `/reload-plugins --force`, чтобы сделать скиллы плагина доступными в текущей сессии. Затем попросите Claude оценить существующий скилл, например `evaluate my summarize-changes skill with skill-creator`. Плагин проведет вас через написание тестовых случаев и запустит цикл:1053Если сводка установки сообщает `Run /reload-plugins to apply.`, Claude Code затем сам выполняет эту перезагрузку. Если при перезагрузке появляется предупреждение о том, что ваше следующее сообщение повторно прочитает диалог, выполните `/reload-plugins --force`, чтобы сделать скиллы плагина доступными в текущей сессии. Затем попросите Claude оценить существующий скилл, например `evaluate my summarize-changes skill with skill-creator`. Плагин проведет вас через написание тестовых случаев и запустит цикл:

1050 1054

terminal-config.md +2 −1

Details

281 Полноэкранный режим281 Полноэкранный режим

282 </h4>282 </h4>

283 283

284 Claude Code рисует `userMessageBackground`, `bashMessageBackgroundColor` и `memoryBackgroundColor` как в средстве отрисовки по умолчанию, так и в полноэкранном. Он использует `userMessageBackgroundHover` и `selectionBg` только в [режиме полноэкранной отрисовки](/docs/ru/fullscreen).284 Claude Code использует `userMessageBackgroundHover`, `selectionBg` и `composerSidebarBackground` только в [режиме полноэкранной отрисовки](/docs/ru/fullscreen). `userMessageBackground`, `bashMessageBackgroundColor` и `memoryBackgroundColor` он рисует как в средстве отрисовки по умолчанию, так и в полноэкранном.

285 285

286 | Токен | Управляет |286 | Токен | Управляет |

287 | :- | :- |287 | :- | :- |

293 | `composerSidebarBackground` | Фон панели рядом с диалогом, например [панели diff](/docs/ru/fullscreen#watch-your-changes-in-the-diff-panel) или [панели мода](/docs/ru/plugins/mods/interface) |

293 294

294 <h4 id="usage-meter-and-speaker-labels">295 <h4 id="usage-meter-and-speaker-labels">

295 Счётчик использования и метки динамика296 Счётчик использования и метки динамика

vs-code.md +514 −451

Details

6 6

7> Установите и настройте расширение Claude Code для VS Code. Получите помощь AI при кодировании с встроенными diff, @-упоминаниями, проверкой плана и сочетаниями клавиш.7> Установите и настройте расширение Claude Code для VS Code. Получите помощь AI при кодировании с встроенными diff, @-упоминаниями, проверкой плана и сочетаниями клавиш.

8 8

9<img src="https://mintcdn.com/claude-code/-YhHHmtSxwr7W8gy/images/vs-code-extension-interface.jpg?fit=max&auto=format&n=-YhHHmtSxwr7W8gy&q=85&s=300652d5678c63905e6b0ea9e50835f8" alt="Редактор VS Code с открытой панелью расширения Claude Code справа, показывающей беседу с Claude" width="2500" height="1155" data-path="images/vs-code-extension-interface.jpg" />9<img src="https://mintcdn.com/claude-code/-YhHHmtSxwr7W8gy/images/vs-code-extension-interface.jpg?fit=max&auto=format&n=-YhHHmtSxwr7W8gy&q=85&s=300652d5678c63905e6b0ea9e50835f8" alt="Редактор VS Code с открытой панелью расширения Claude Code справа, показывающей диалог с Claude" width="2500" height="1155" data-path="images/vs-code-extension-interface.jpg" />

10 10

11Расширение VS Code предоставляет собственный графический интерфейс для Claude Code, интегрированный непосредственно в вашу IDE. Это рекомендуемый способ использования Claude Code в VS Code.11Расширение VS Code предоставляет собственный графический интерфейс для Claude Code, интегрированный непосредственно в вашу IDE. Это рекомендуемый способ использования Claude Code в VS Code.

12 12

13С расширением вы можете просматривать и редактировать планы Claude перед их принятием, автоматически принимать правки по мере их внесения, использовать @-упоминания файлов с определёнными диапазонами строк из вашего выделения, получать доступ к истории беседы и открывать несколько бесед в отдельных вкладках или окнах.13С расширением вы можете:

15* Просматривать и редактировать планы Claude перед их принятием

16* Автоматически принимать правки по мере их внесения

17* Использовать @-упоминания файлов с определёнными диапазонами строк из вашего выделения

18* Получать доступ к истории диалога

19* Открывать несколько диалогов в отдельных вкладках или окнах

14 20

15<h2 id="prerequisites">21<h2 id="prerequisites">

16 Предварительные требования22 Предварительные требования

29 Установка расширения35 Установка расширения

30</h2>36</h2>

31 37

~~32Нажмите на ссылку для вашей IDE, чтобы установить напрямую:~~38Нажмите на ссылку для вашей IDE, чтобы установить расширение напрямую:

33 39

34* [Установить для VS Code](vscode:extension/anthropic.claude-code)40* [Установить для VS Code](vscode:extension/anthropic.claude-code)

35* [Установить для Cursor](cursor:extension/anthropic.claude-code)41* [Установить для Cursor](cursor:extension/anthropic.claude-code)

36 42

37Или в VS Code нажмите `Cmd+Shift+X` (Mac) или `Ctrl+Shift+X` (Windows/Linux), чтобы открыть представление расширений, найдите "Claude Code" и нажмите **Установить**.43Или в VS Code нажмите `Cmd+Shift+X` (Mac) или `Ctrl+Shift+X` (Windows/Linux), чтобы открыть представление Extensions, найдите «Claude Code» и нажмите **Install**.

38 44

39Номер версии расширения соответствует версии Claude Code, которую оно включает. Например, для функции, требующей Claude Code v2.1.286 или новее, нужна версия расширения 2.1.286 или новее, которая отображается в представлении расширений.45Номер версии расширения соответствует версии Claude Code, которая в него входит. Например, для функции, требующей Claude Code v2.1.286 или новее, нужна версия расширения 2.1.286 или новее; её можно увидеть в представлении Extensions.

40 46

41Расширение также устанавливается в других форках VS Code, таких как Devin Desktop или Kiro. Найдите "Claude Code" в представлении расширений вашего редактора или установите из [реестра Open VSX](https://open-vsx.org/extension/Anthropic/claude-code). Если ваш редактор не может установить расширение, [установите CLI](/docs/ru/quickstart) и запустите `claude` в его встроенном терминале. CLI работает в любом терминале.47Claude Code также работает в других редакторах и контейнерах:

42 48

~~43Чтобы запустить Claude Code внутри контейнера разработки, см. [Контейнеры разработки](/docs/ru/devcontainer).~~49* **Другие форки VS Code**: расширение также устанавливается в форках, таких как Devin Desktop или Kiro. Найдите «Claude Code» в представлении Extensions редактора или установите его из [реестра Open VSX](https://open-vsx.org/extension/Anthropic/claude-code).

50* **Редакторы, в которые нельзя установить расширение**: [установите CLI](/docs/ru/quickstart) и запускайте `claude` во встроенном терминале редактора. CLI работает в любом терминале.

51* **Dev-контейнеры**: чтобы запустить Claude Code внутри dev-контейнера, см. раздел [Контейнеры для разработки](/docs/ru/devcontainer).

44 52

45<Note>Если расширение не появляется после установки, перезагрузите VS Code или выполните "Developer: Reload Window" из палитры команд.</Note>53<Note>Если расширение не появилось после установки, перезапустите VS Code или выполните «Developer: Reload Window» из палитры команд.</Note>

46 54

47<h2 id="get-started">55<h2 id="get-started">

48 Начало работы56 Начало работы

52 60

53<Steps>61<Steps>

54 <Step title="Откройте панель Claude Code">62 <Step title="Откройте панель Claude Code">

55 По всему VS Code значок Spark указывает на Claude Code: <img src="https://mintcdn.com/claude-code/c5r9_6tjPMzFdDDT/images/vs-code-spark-icon.svg?fit=max&auto=format&n=c5r9_6tjPMzFdDDT&q=85&s=3ca45e00deadec8c8f4b4f807da94505" alt="Spark icon" style={{display: "inline", height: "0.85em", verticalAlign: "middle"}} width="16" height="16" data-path="images/vs-code-spark-icon.svg" />63 Во всём VS Code значок Spark обозначает Claude Code: <img src="https://mintcdn.com/claude-code/c5r9_6tjPMzFdDDT/images/vs-code-spark-icon.svg?fit=max&auto=format&n=c5r9_6tjPMzFdDDT&q=85&s=3ca45e00deadec8c8f4b4f807da94505" alt="Значок Spark" style={{display: "inline", height: "0.85em", verticalAlign: "middle"}} width="16" height="16" data-path="images/vs-code-spark-icon.svg" />

56 64

57 Самый быстрый способ открыть Claude — нажать значок Spark на **панели инструментов редактора** (верхний правый угол редактора). Значок появляется только при открытом файле.65 Самый быстрый способ открыть Claude — нажать на значок Spark на **панели инструментов редактора** (правый верхний угол редактора). Значок отображается только тогда, когда у вас открыт файл.

58 66

59 <img src="https://mintcdn.com/claude-code/mfM-EyoZGnQv8JTc/images/vs-code-editor-icon.png?fit=max&auto=format&n=mfM-EyoZGnQv8JTc&q=85&s=eb4540325d94664c51776dbbfec4cf02" alt="VS Code editor showing the Spark icon in the Editor Toolbar" width="2796" height="734" data-path="images/vs-code-editor-icon.png" />67 <img src="https://mintcdn.com/claude-code/mfM-EyoZGnQv8JTc/images/vs-code-editor-icon.png?fit=max&auto=format&n=mfM-EyoZGnQv8JTc&q=85&s=eb4540325d94664c51776dbbfec4cf02" alt="Редактор VS Code со значком Spark на панели инструментов редактора" width="2796" height="734" data-path="images/vs-code-editor-icon.png" />

60 68

61 Другие способы открыть Claude Code:69 Другие способы открыть Claude Code:

62 70

63 * **Activity Bar**: нажмите значок Spark на левой боковой панели, чтобы открыть список сеансов. Нажмите на любой сеанс, чтобы открыть его в вашем [предпочитаемом месте](#extension-settings), или начните новый. Этот значок всегда виден на Activity Bar.71 * **Панель действий (Activity Bar)**: нажмите на значок Spark на левой боковой панели, чтобы открыть список сессий. Нажмите на любую сессию, чтобы открыть её в [предпочитаемом расположении](#extension-settings), или начните новую. Этот значок всегда виден на панели действий.

~~64 * **Command Palette**: `Cmd+Shift+P` (Mac) или `Ctrl+Shift+P` (Windows/Linux), введите "Claude Code" и выберите опцию, например "Open in New Tab"~~72 * **Палитра команд**: `Cmd+Shift+P` (Mac) или `Ctrl+Shift+P` (Windows/Linux), введите «Claude Code» и выберите вариант, например «Open in New Tab»

~~65 * **Status Bar**: нажмите **✻ Claude Code** в нижнем правом углу окна. Это работает даже при отсутствии открытого файла.~~73 * **Строка состояния**: нажмите **✻ Claude Code** в правом нижнем углу окна. Это работает, даже когда ни один файл не открыт.

66 74

67 Вы можете перетащить панель Claude в любое место VS Code. Подробнее см. в разделе [Настройка вашего рабочего процесса](#customize-your-workflow).75 Вы можете перетащить панель Claude в любое место VS Code. Подробнее см. в разделе [Настройка рабочего процесса](#customize-your-workflow).

68 </Step>76 </Step>

69 77

70 <Step title="Войдите в систему">78 <Step title="Войдите в систему">

71 При первом открытии панели появляется экран входа. Нажмите **Sign in** и завершите авторизацию в браузере.79 При первом открытии панели появляется экран входа. Нажмите **Sign in** и завершите авторизацию в браузере.

72 80

73 Если позже вы увидите **Not logged in · Please run /login**, расширение автоматически откроет экран входа. Если это не произойдет, перезагрузите окно из Command Palette с помощью **Developer: Reload Window**.81 Если позже вы увидите **Not logged in · Please run /login**, расширение автоматически снова откроет экран входа. Если он не появился, перезагрузите окно из палитры команд с помощью **Developer: Reload Window**.

74 82

75 Если у вас установлена переменная `ANTHROPIC_API_KEY` в оболочке, но вы все еще видите приглашение входа, VS Code может не унаследовать переменные окружения вашей оболочки. Запустите VS Code из терминала с помощью `code .`, чтобы он унаследовал переменные окружения, или вместо этого войдите с помощью своей учетной записи Claude.83 Если в вашей оболочке задана переменная `ANTHROPIC_API_KEY`, но запрос на вход всё равно появляется, возможно, VS Code не унаследовал окружение вашей оболочки. Запустите VS Code из терминала командой `code .`, чтобы он унаследовал ваши переменные окружения, или вместо этого войдите с помощью своей учётной записи Claude.

76 84

77 После входа появляется контрольный список **Learn Claude Code**. Пройдите каждый пункт, нажав **Show me**, или закройте его с помощью X. Чтобы открыть его позже, снимите флажок **Hide Onboarding** в параметрах VS Code в разделе Extensions → Claude Code.85 После входа появится контрольный список **Learn Claude Code**. Пройдите по каждому пункту, нажимая **Show me**, или закройте его с помощью X. Чтобы снова открыть его позже, снимите флажок **Hide Onboarding** в настройках VS Code в разделе **Extensions > Claude Code**.

78 </Step>86 </Step>

79 87

~~80 <Step title="Отправьте запрос">~~88 <Step title="Отправьте промпт">

81 Попросите Claude помочь с вашим кодом или файлами, будь то объяснение того, как что-то работает, отладка проблемы или внесение изменений.89 Попросите Claude помочь с вашим кодом или файлами — будь то объяснение того, как что-то работает, отладка проблемы или внесение изменений.

82 90

83 <Tip>Claude автоматически видит выделенный текст. Нажмите `Option+K` (Mac) / `Alt+K` (Windows/Linux), чтобы также вставить ссылку @-mention (например `@file.ts#5-10`) в ваш запрос.</Tip>91 <Tip>Claude автоматически видит выделенный вами текст. Нажмите `Option+K` (Mac) / `Alt+K` (Windows/Linux), чтобы также вставить в промпт ссылку с @-упоминанием (например, `@file.ts#5-10`).</Tip>

84 92

85 Вот пример вопроса о конкретной строке в файле:93 Вот пример вопроса о конкретной строке в файле:

86 94

87 <img src="https://mintcdn.com/claude-code/FVYz38sRY-VuoGHA/images/vs-code-send-prompt.png?fit=max&auto=format&n=FVYz38sRY-VuoGHA&q=85&s=ede3ed8d8d5f940e01c5de636d009cfd" alt="VS Code editor with lines 2-3 selected in a Python file, and the Claude Code panel showing a question about those lines with an @-mention reference" width="3288" height="1876" data-path="images/vs-code-send-prompt.png" />95 <img src="https://mintcdn.com/claude-code/FVYz38sRY-VuoGHA/images/vs-code-send-prompt.png?fit=max&auto=format&n=FVYz38sRY-VuoGHA&q=85&s=ede3ed8d8d5f940e01c5de636d009cfd" alt="Редактор VS Code с выделенными строками 2–3 в файле Python и панель Claude Code с вопросом об этих строках, содержащим ссылку с @-упоминанием" width="3288" height="1876" data-path="images/vs-code-send-prompt.png" />

88 </Step>96 </Step>

89 97

~~90 <Step title="Проверьте изменения">~~98 <Step title="Просмотрите изменения">

91 То, что вы видите, зависит от [режима разрешений](/docs/ru/permission-modes#which-mode-a-session-starts-in), показанного в нижней части поля запроса:99 <span id="security-considerations" />

100

101 <span id="security-and-privacy" />

102

103 Проверьте [режим разрешений](/docs/ru/permission-modes#which-mode-a-session-starts-in), отображаемый в нижней части поля ввода промпта:

92 104

~~93 * В режиме Auto или Edit automatically Claude редактирует большинство файлов в вашем рабочем пространстве без запроса.~~105 * В режиме Auto или Edit automatically Claude редактирует [большинство файлов](/docs/ru/permission-modes#protected-paths) в вашей рабочей области, не спрашивая.

94 * В режиме Manual, когда Claude хочет отредактировать файл, он показывает сравнение исходного и предложенного изменений рядом, а затем запрашивает разрешение. Вы можете принять, отклонить или сказать Claude, что делать вместо этого. Если вы отредактируете предложенное содержимое непосредственно в представлении diff перед принятием, Claude будет уведомлен, что вы его изменили, поэтому он не будет предполагать, что файл соответствует его исходному предложению.106 * В режиме Manual, когда Claude хочет отредактировать файл, он показывает сравнение исходного содержимого и предлагаемых изменений бок о бок, а затем запрашивает разрешение. Вы можете принять, отклонить изменения или сказать Claude, что сделать вместо этого. Если вы отредактируете предлагаемое содержимое непосредственно в представлении diff перед принятием, Claude получит информацию о том, что вы его изменили, чтобы он не предполагал, что файл соответствует его исходному предложению.

95 107

96 <img src="https://mintcdn.com/claude-code/FVYz38sRY-VuoGHA/images/vs-code-edits.png?fit=max&auto=format&n=FVYz38sRY-VuoGHA&q=85&s=e005f9b41c541c5c7c59c082f7c4841c" alt="VS Code showing a diff of Claude's proposed changes with a permission prompt asking whether to make the edit" width="3292" height="1876" data-path="images/vs-code-edits.png" />108 <img src="https://mintcdn.com/claude-code/FVYz38sRY-VuoGHA/images/vs-code-edits.png?fit=max&auto=format&n=FVYz38sRY-VuoGHA&q=85&s=e005f9b41c541c5c7c59c082f7c4841c" alt="VS Code с diff предлагаемых Claude изменений и запросом разрешения на внесение правки" width="3292" height="1876" data-path="images/vs-code-edits.png" />

97 109

98 Чтобы проверить предложенное редактирование по одному изменению за раз, используйте кнопки **Accept this change** и **Reject this change** под каждым изменением в diff. Отклонение изменения отменяет его в предложенном содержимом; принятие отмечает его как проверенное. Принятие или отклонение всего файла все равно завершает проверку. Diff с более чем 100 изменениями открывается без кнопок для каждого изменения, поэтому проверьте его как целый файл. Проверка по изменениям требует Claude Code v2.1.275 или более поздней версии.110 Чтобы просматривать предлагаемую правку по одному изменению за раз, используйте кнопки **Accept this change** и **Reject this change** под каждым изменением в diff. Отклонение изменения отменяет его в предлагаемом содержимом; принятие помечает его как просмотренное. Для просмотра по отдельным изменениям требуется Claude Code v2.1.275 или более поздней версии.

99 111

100 Те же действия доступны в курсоре из контекстного меню редактора и из Command Palette как **Claude Code: Accept Change at Cursor** и **Claude Code: Reject Change at Cursor**.112 Принятие или отклонение всего файла по-прежнему завершает просмотр. Diff, содержащий более 100 изменений, открывается без кнопок для отдельных изменений, поэтому просматривайте его как целый файл.

113

114 Те же действия доступны в позиции курсора из контекстного меню редактора и из палитры команд как **Claude Code: Accept Change at Cursor** и **Claude Code: Reject Change at Cursor**.

101 </Step>115 </Step>

102</Steps>116</Steps>

103 117

104Для получения дополнительных идей о том, что вы можете делать с Claude Code, см. [Распространенные рабочие процессы](/docs/ru/common-workflows).118Больше идей о том, что можно делать с Claude Code, см. в разделе [Типичные рабочие процессы](/docs/ru/common-workflows).

105 119

106<Tip>120<Tip>

107 Запустите "Claude Code: Open Walkthrough" из Command Palette для пошагового руководства по основам.121 Запустите «Claude Code: Open Walkthrough» из палитры команд, чтобы пройти пошаговый обзор основ.

108</Tip>122</Tip>

109 123

110<h2 id="use-the-prompt-box">124<h2 id="use-the-prompt-box">

113 127

114Поле ввода промпта поддерживает несколько функций:128Поле ввода промпта поддерживает несколько функций:

115 129

116* **Режимы разрешений**: нажмите на индикатор режима в нижней части поля ввода промпта, чтобы переключить режим разрешений. В Claude Code v2.1.283 и новее Auto является встроенным начальным режимом разрешений, а в более ранних версиях — только на тарифах Pro, Max и Team. О том, что на это влияет, и обо всех режимах разрешений, которые предлагает индикатор, см. в разделе [как расширение выбирает начальный режим разрешений](/docs/ru/permission-modes#switch-permission-modes).130* **Режимы разрешений**: нажмите на индикатор режима внизу поля ввода промпта, чтобы переключить режим разрешений. В Claude Code v2.1.283 и более поздних версиях Auto является встроенным начальным режимом разрешений, а в более ранних версиях — только на тарифах Pro, Max и Team. О том, что на это влияет, и обо всех режимах разрешений, которые предлагает индикатор, см. в разделе [как расширение выбирает начальный режим разрешений](/docs/ru/permission-modes#switch-permission-modes).

117 * **Auto**: классификатор проверяет большинство действий вместо того, чтобы спрашивать вас. О том, что он проверяет и блокирует, см. в разделе [авторежим](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode).131 * **Auto**: классификатор проверяет большинство действий вместо того, чтобы спрашивать вас. О том, что он проверяет и блокирует, см. в разделе [авторежим](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode).

118 * **Manual**: Claude запрашивает разрешение перед редактированием файлов и выполнением большинства shell-команд.132 * **Manual**: Claude запрашивает разрешение перед редактированием файлов и большинством shell-команд.

119 * **Plan**: Claude описывает, что собирается сделать, и ждёт подтверждения перед внесением изменений. VS Code автоматически открывает план как полноценный Markdown-документ, в котором можно добавлять встроенные комментарии, чтобы оставить отзыв до того, как Claude начнёт работу.133 * **Plan**: Claude описывает, что собирается сделать, и ждёт подтверждения, прежде чем вносить изменения. VS Code автоматически открывает план как полноценный документ Markdown, в котором можно добавлять встроенные комментарии, чтобы дать обратную связь до того, как Claude начнёт работу.

120 134

121 Также можно ввести `/plan` в поле ввода промпта. Требуется Claude Code v2.1.280 или новее.135 Также можно ввести `/plan` в поле ввода промпта. Требуется Claude Code v2.1.280 или более поздней версии.

122 136

123 * `/plan`: переключает в режим планирования. Если вы уже находитесь в режиме планирования, вместо этого показывает текущий план.137 * `/plan`: переключает в режим планирования. Если вы уже в режиме планирования, вместо этого показывает текущий план.

124 * `/plan` с задачей, например `/plan fix the auth bug`: переключает в режим планирования и начинает планирование этой задачи.138 * `/plan` с задачей, например `/plan fix the auth bug`: переключает в режим планирования и начинает планировать эту задачу.

125 * `/plan open`: если вы уже находитесь в режиме планирования, открывает файл плана в редакторе.139 * `/plan open`: если вы уже в режиме планирования, открывает файл плана в редакторе.

126 * **Edit automatically**: Claude вносит правки, не спрашивая.140 * **Edit automatically**: Claude вносит правки, не спрашивая.

127* **Модель**: выберите **Switch model…** в меню команд, чтобы сменить модель посреди сессии. Также можно нажать на название модели в нижней части поля ввода промпта, чтобы открыть то же окно выбора. В Claude Code v2.1.284 и новее окно выбора также открывается, если ввести в поле ввода промпта `/model` без аргументов.141* **Модель**: выберите **Switch model…** в меню команд, чтобы сменить модель посреди сессии. Также можно нажать на название модели внизу поля ввода промпта, чтобы открыть то же окно выбора. В Claude Code v2.1.284 и более поздних версиях окно выбора также открывается, если ввести в поле ввода промпта только `/model`.

128 142

129 Если текущая модель поддерживает [уровни effort](/docs/ru/model-config#adjust-effort-level), в окне выбора также отображается строка **Effort**, а на кнопке с названием модели показан выбранный уровень. Когда вы выбираете уровень, отличный от `max`, Claude Code сохраняет его для текущей модели как уровень по умолчанию в разделе [`modelSettings`](/docs/ru/settings-reference#modelsettings) ваших пользовательских настроек; `max` применяется только к текущей сессии. Кнопка с названием модели и строка **Effort** требуют Claude Code v2.1.257 или новее.143 Если текущая модель поддерживает [уровни effort](/docs/ru/model-config#adjust-effort-level), в окне выбора также отображается строка **Effort**, а на кнопке с названием модели показывается выбранный уровень. Если вы выбираете уровень, отличный от `max`, Claude Code сохраняет его для текущей модели как уровень по умолчанию в [`modelSettings`](/docs/ru/settings-reference#modelsettings) в ваших пользовательских настройках; `max` применяется только к текущей сессии. Кнопка с названием модели и строка **Effort** требуют Claude Code v2.1.257 или более поздней версии.

130 144

131 Когда включены [динамические рабочие процессы](/docs/ru/workflows) и текущая модель их поддерживает, под строкой **Effort** появляется переключатель **Ultracode**. Включите его, чтобы Claude планировал [рабочий процесс](/docs/ru/workflows#let-claude-decide-with-ultracode) для каждой содержательной задачи в этой сессии с выбранным уровнем effort. Пока он включён, на кнопке с названием модели после уровня отображается `· Ultracode`. Переключатель требует Claude Code v2.1.284 или новее.145 Если включены [динамические рабочие процессы](/docs/ru/workflows) и текущая модель их поддерживает, под строкой **Effort** появляется переключатель **Ultracode**. Включите его, чтобы Claude планировал [рабочий процесс](/docs/ru/workflows#let-claude-decide-with-ultracode) для каждой содержательной задачи в этой сессии с выбранным уровнем effort. Пока он включён, на кнопке с названием модели после уровня отображается `· Ultracode`. Переключатель требует Claude Code v2.1.284 или более поздней версии.

132* **Меню команд**: нажмите `/` или введите `/`, чтобы открыть меню команд. Среди вариантов — прикрепление файлов, переключение моделей и включение расширенного мышления.146* **Меню команд**: нажмите `/` или введите `/`, чтобы открыть меню команд. Среди вариантов — прикрепление файлов, переключение моделей и включение или отключение расширенного мышления.

133 147

134 Раздел Customize содержит такие пункты, как MCP-серверы, команды, стили вывода, хуки, память, инструкции, разрешения и плагины. Пункты со значком терминала открываются во встроенном терминале.148 Раздел Customize содержит такие пункты, как MCP-серверы, команды, стили вывода, хуки, память, инструкции, разрешения и плагины. Пункты со значком терминала открываются во встроенном терминале.

135 149

136 * Чтобы просмотреть команды, такие как `/usage` или [`/remote-control`](/docs/ru/remote-control), выберите **Slash commands** в разделе Customize. Откроется диалоговое окно со списком команд и полем фильтра. Выберите команду, чтобы запустить её. При вводе `/` в поле ввода промпта команды по-прежнему предлагаются прямо в строке. Требуется Claude Code v2.1.257 или новее.150 * Чтобы просмотреть команды, такие как `/usage` или [`/remote-control`](/docs/ru/remote-control), выберите **Slash commands** в разделе Customize. Откроется диалоговое окно со списком команд и полем фильтра. Выберите команду, чтобы выполнить её. Ввод `/` в поле ввода промпта по-прежнему предлагает команды прямо в строке. Требуется Claude Code v2.1.257 или более поздней версии.

151

152 Ввод `/skills` также открывает это диалоговое окно. В каждой строке [скилла](/docs/ru/skills) отображается его [видимость](/docs/ru/skills#override-skill-visibility-from-settings), например **On** или **Name only**. Нажмите на значение видимости, чтобы изменить его, за исключением строк с пометкой **locked**, например скиллов плагинов. Сокращение `/skills` и элементы управления видимостью требуют Claude Code v2.1.280 или более поздней версии.

153 * Выберите **Output styles** в разделе Customize, чтобы выбрать [стиль вывода](/docs/ru/output-styles), включая ваши пользовательские стили. Требуется Claude Code v2.1.257 или более поздней версии.

137 154

138 Ввод `/skills` также открывает это диалоговое окно. В каждой строке [скилла](/docs/ru/skills) показана его [видимость](/docs/ru/skills#override-skill-visibility-from-settings), например **On** или **Name only**. Нажмите на значение видимости, чтобы изменить его, — кроме строк с пометкой **locked**, таких как скиллы плагинов. Сокращение `/skills` и элементы управления видимостью требуют Claude Code v2.1.280 или новее.155 Чтобы вместо этого создать пользовательский стиль, выберите **Build a custom style** в меню **Output styles**. Claude Code создаст для вас [файл стиля](/docs/ru/output-styles#create-a-custom-output-style) на уровне проекта или пользователя. Требуется Claude Code v2.1.261 или более поздней версии.

139 * Выберите **Output styles** в разделе Customize, чтобы выбрать [стиль вывода](/docs/ru/output-styles), включая ваши пользовательские стили. Требуется Claude Code v2.1.257 или новее.156 * Выберите **Hooks** в разделе Customize, чтобы просмотреть [хуки](/docs/ru/hooks), загруженные в сессии, сгруппированные по событиям. Можно добавлять, редактировать или удалять хуки, сохранённые в ваших файлах пользовательских, проектных и локальных настроек. Хуки из других источников, например из управляемых настроек или плагинов, доступны только для чтения. Требуется Claude Code v2.1.269 или более поздней версии.

157 * Выберите **Permissions** в разделе Customize, чтобы просмотреть [правила разрешений](/docs/ru/permissions) сессии, сгруппированные на Allow, Ask и Deny. Можно добавлять правила в пользовательские, проектные или локальные настройки и удалять сохранённые там правила. Правила из других источников, например из управляемых настроек или подтверждений, данных только для этой сессии, доступны только для чтения. Требуется Claude Code v2.1.269 или более поздней версии.

158 * Выберите **Memory** в разделе Customize, чтобы включить или отключить [автоматическую память](/docs/ru/memory#auto-memory). Пока она включена, можно также просматривать воспоминания, сохранённые Claude, и открывать папки, в которых они хранятся, в файловом менеджере. Требуется Claude Code v2.1.274 или более поздней версии.

140 159

141 Чтобы вместо этого создать пользовательский стиль, выберите **Build a custom style** в меню **Output styles**. Claude Code сам создаст [файл стиля](/docs/ru/output-styles#create-a-custom-output-style) на уровне проекта или пользователя. Требуется Claude Code v2.1.261 или новее.160 Нажмите на сохранённое воспоминание, чтобы прочитать его в диалоговом окне, где можно отредактировать текст, удалить воспоминание или открыть его файл в редакторе. Просмотр, редактирование и удаление воспоминания в диалоговом окне требуют Claude Code v2.1.275 или более поздней версии.

142 * Выберите **Hooks** в разделе Customize, чтобы просмотреть [хуки](/docs/ru/hooks), загруженные в сессии, сгруппированные по событиям. Вы можете добавлять, редактировать и удалять хуки, сохранённые в файлах пользовательских, проектных и локальных настроек. Хуки из других источников, например из управляемых настроек или плагинов, доступны только для чтения. Требуется Claude Code v2.1.269 или новее.161 * Выберите **Instructions** в разделе Customize, чтобы редактировать [файлы CLAUDE.md](/docs/ru/memory#claude-md-files), которые читает Claude. Выберите файл, чтобы открыть его в редакторе. Если файл ещё не существует, Claude Code сначала создаст его. Требуется Claude Code v2.1.274 или более поздней версии.

143 * Выберите **Permissions** в разделе Customize, чтобы просмотреть [правила разрешений](/docs/ru/permissions) сессии, сгруппированные по категориям Allow, Ask и Deny. Вы можете добавлять правила в пользовательские, проектные или локальные настройки и удалять сохранённые там правила. Правила из других источников, например из управляемых настроек или подтверждений, данных только для этой сессии, доступны только для чтения. Требуется Claude Code v2.1.269 или новее.162 * Выберите **Status** в разделе Customize или введите `/status`, чтобы проверить версию Claude Code, учётную запись, модель и сведения о MCP-серверах для сессии. Требуется Claude Code v2.1.280 или более поздней версии.

144 * Выберите **Memory** в разделе Customize, чтобы включить или отключить [автоматическую память](/docs/ru/memory#auto-memory). Пока она включена, вы также можете просматривать воспоминания, сохранённые Claude, и открывать папки, в которых они хранятся, в файловом менеджере. Требуется Claude Code v2.1.274 или новее.163 * Выберите **Sandbox** в разделе Customize или введите `/sandbox`, чтобы узнать, выполняются ли команды Bash от Claude [в песочнице](/docs/ru/sandboxing). Там же можно переключить режим песочницы и добавить [исключённые команды](/docs/ru/settings-reference#sandbox-excludedcommands). Требуется Claude Code v2.1.280 или более поздней версии.

164 * Выберите **Claude in Chrome** в разделе Customize или введите `/chrome`, чтобы проверить подключение [Claude in Chrome](/docs/ru/chrome) и управлять им. Оба способа требуют входа с учётной записью claude.ai. Требуется Claude Code v2.1.280 или более поздней версии.

165 * Выберите **Export conversation** в разделе Context или введите `/export`, чтобы скопировать диалог как обычный текст или сохранить его в файл. Добавьте имя файла, например `/export notes.txt`, чтобы пропустить диалоговое окно и выбрать, куда сохранить файл. Требуется Claude Code v2.1.280 или более поздней версии.

166 * Раздел Settings содержит пункт **Enable Remote Control for all sessions**, который задаёт [`remoteControlAtStartup`](/docs/ru/settings-reference#remotecontrolatstartup) и определяет, будут ли [новые интерактивные сессии автоматически подключаться к Remote Control](/docs/ru/remote-control#enable-remote-control-for-all-sessions). Требуется Claude Code v2.1.203 или более поздней версии.

145 167

146 Нажмите на сохранённое воспоминание, чтобы прочитать его в диалоговом окне, где можно отредактировать текст, удалить воспоминание или открыть его файл в редакторе. Просмотр, редактирование и удаление воспоминания в диалоговом окне требуют Claude Code v2.1.275 или новее.168 Когда вы включаете или отключаете переключатель в окне VS Code, изменение касается не только сессий, которые вы запустите после этого. Оно также применяется к сессиям, уже открытым в этом окне VS Code. Если вы его отключите, открытые сессии отключатся. В Claude Code v2.1.261 и более поздних версиях изменение также распространяется на сессии, открытые в других ваших окнах VS Code.

147 * Выберите **Instructions** в разделе Customize, чтобы отредактировать [файлы CLAUDE.md](/docs/ru/memory#claude-md-files), которые читает Claude. Выберите файл, чтобы открыть его в редакторе. Если файл ещё не существует, Claude Code сначала создаст его. Требуется Claude Code v2.1.274 или новее.169 * Раздел Settings также содержит пункт **Focus view**, который скрывает вызовы инструментов, результаты инструментов и размышления за разворачиваемыми строками, оставляя ваши промпты и ответы Claude. Переключайте его там же, сочетанием `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux) или из палитры команд с помощью **Claude Code: Toggle Focus view**. Изменение применяется ко всем открытым сессиям и сохраняется между сессиями. Требуется Claude Code v2.1.221 или более поздней версии.

148 * Выберите **Status** в разделе Customize или введите `/status`, чтобы проверить версию Claude Code, аккаунт, модель и сведения об MCP-серверах для сессии. Требуется Claude Code v2.1.280 или новее.

149 * Выберите **Sandbox** в разделе Customize или введите `/sandbox`, чтобы узнать, выполняются ли команды Bash от Claude [в песочнице](/docs/ru/sandboxing). Там же можно переключить режим песочницы и добавить [исключённые команды](/docs/ru/settings-reference#sandbox-excludedcommands). Требуется Claude Code v2.1.280 или новее.

150 * Выберите **Claude in Chrome** в разделе Customize или введите `/chrome`, чтобы проверить подключение [Claude in Chrome](/docs/ru/chrome) и управлять им. Оба способа требуют входа с аккаунтом claude.ai. Требуется Claude Code v2.1.280 или новее.

151 * Выберите **Export conversation** в разделе Context или введите `/export`, чтобы скопировать диалог как обычный текст или сохранить его в файл. Добавьте имя файла, например `/export notes.txt`, чтобы пропустить диалоговое окно и выбрать, куда сохранить файл. Требуется Claude Code v2.1.280 или новее.

152 * Раздел Settings содержит пункт **Enable Remote Control for all sessions**, который задаёт настройку [`remoteControlAtStartup`](/docs/ru/settings-reference#remotecontrolatstartup), определяющую, [подключаются ли новые интерактивные сессии к Remote Control автоматически](/docs/ru/remote-control#enable-remote-control-for-all-sessions). Требуется Claude Code v2.1.203 или новее.

153 170

154 Когда вы включаете или отключаете этот переключатель в окне VS Code, изменение применяется к сессиям, уже открытым в этом окне VS Code, а не только к сессиям, которые вы запустите после этого. Если вы его отключите, открытые сессии отключатся. В Claude Code v2.1.261 и новее изменение также применяется к сессиям, открытым в других ваших окнах VS Code.171 Последний список задач Claude остаётся видимым, как и текст, о котором спрашивает ожидающий ответа вопрос от Claude; для этого требуется Claude Code v2.1.225 или более поздней версии. Пока Claude запускает [субагентов](/docs/ru/sub-agents), под группой вызовов инструментов, которая их запустила, появляются строки с ходом выполнения в реальном времени и их последней активностью. Для этого требуется Claude Code v2.1.269 или более поздней версии.

155 * Раздел Settings также содержит пункт **Focus view**, который скрывает вызовы инструментов, результаты инструментов и размышления за раскрываемыми строками, оставляя ваши промпты и ответы Claude. Переключить его можно там же, сочетанием клавиш `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux) или из палитры команд с помощью **Claude Code: Toggle Focus view**. Изменение применяется ко всем открытым сессиям и сохраняется между сессиями. Требуется Claude Code v2.1.221 или новее.172 * Чтобы выйти из учётной записи Anthropic, выберите **Sign out** в разделе Settings или введите `/logout`. При использовании [стороннего провайдера](#use-third-party-providers) меню не предлагает ни того, ни другого. Требуется Claude Code v2.1.277 или более поздней версии.

173 * Чтобы сообщить об ошибке, нажмите **Report a problem** внизу меню или введите `/bug` или `/feedback` с необязательным описанием, которым будет предварительно заполнен отчёт. Когда вы отправляете отчёт и при этом вошли в Anthropic через собственное подключение Anthropic, Claude Code отправляет его в Anthropic. Требуется Claude Code v2.1.229 или более поздней версии.

156 174

157 Последний список задач Claude остаётся видимым, как и текст, о котором спрашивает ожидающий ответа вопрос от Claude; это требует Claude Code v2.1.225 или новее. Пока Claude выполняет [субагентов](/docs/ru/sub-agents), строки с их текущим прогрессом и последней активностью отображаются под группой вызовов инструментов, которая их запустила. Это требует Claude Code v2.1.269 или новее.175 При использовании стороннего провайдера или без учётных данных Anthropic ничего не отправляется. Диалоговое окно сообщает об этом до того, как вы начнёте писать. При отправке отчёт сохраняется как [локальный архив в `~/.claude/feedback-bundles/`](/docs/ru/data-usage#telemetry-services), в котором известные шаблоны API-ключей и токенов скрыты. Сохранение отчёта на вашем компьютере требует Claude Code v2.1.284 или более поздней версии.

158 * Чтобы выйти из аккаунта Anthropic, выберите **Sign out** в разделе Settings или введите `/logout`. При использовании [стороннего провайдера](#use-third-party-providers) меню не предлагает ни того, ни другого. Требуется Claude Code v2.1.277 или новее.

159 * Чтобы сообщить об ошибке, нажмите **Report a problem** в нижней части меню или введите `/bug` либо `/feedback` с необязательным описанием, которое предварительно заполнит отчёт. Когда вы отправляете отчёт, будучи авторизованным в Anthropic через прямое подключение, Claude Code отправляет его в Anthropic. Требуется Claude Code v2.1.229 или новее.

160 176

161 При использовании стороннего провайдера или без учётных данных Anthropic ничего не отправляется. Диалоговое окно сообщает об этом до того, как вы начнёте писать. При отправке отчёт сохраняется как [локальный архив в `~/.claude/feedback-bundles/`](/docs/ru/data-usage#telemetry-services), в котором скрыты известные шаблоны API-ключей и токенов. Отправьте этот файл представителю вашего аккаунта в Anthropic или прикрепите его к обращению в поддержку. В подтверждении указано имя файла и есть кнопка **Show folder**. Сохранение отчёта на вашем компьютере требует Claude Code v2.1.284 или новее.177 После сохранения отчёта в подтверждении указывается имя файла и есть кнопка **Show folder**. Отправьте этот файл представителю вашей учётной записи в Anthropic или прикрепите его к обращению в службу поддержки.

162 178

163 Если политика вашей организации отключает отзывы о продукте, пункт **Report a problem** не отображается в меню, а `/bug` и `/feedback` вместо открытия отчёта показывают уведомление `Feedback is turned off by your organization's policy or this environment's settings.`. В Claude Code v2.1.284 и новее, если вы задали переменную окружения `DISABLE_FEEDBACK_COMMAND` или `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, отзывы также отключаются, и при открытии отчёта вместо него отображается это уведомление.179 Если политика вашей организации отключает отзывы о продукте, пункт **Report a problem** не отображается в меню, а `/bug` и `/feedback` вместо открытия отчёта показывают уведомление `Feedback is turned off by your organization's policy or this environment's settings.`. В Claude Code v2.1.284 и более поздних версиях, если вы задали переменную окружения `DISABLE_FEEDBACK_COMMAND` или `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, отзывы также отключаются, и при открытии отчёта вместо него показывается это уведомление.

164* **Побочные вопросы**: введите `/btw`, а затем вопрос, чтобы спросить о своей сессии, [не добавляя его в диалог](/docs/ru/interactive-mode#side-questions-with-%2Fbtw). Ответ открывается на панели рядом с чатом, где можно задавать уточняющие вопросы. Ветка сохраняется при перезагрузке окна. Claude Code хранит 20 последних обменов сообщениями и удаляет сохранённые ветки по расписанию [`cleanupPeriodDays`](/docs/ru/settings-reference#cleanupperioddays), если Claude Code может [безопасно определить срок хранения](/docs/ru/claude-directory#cleaned-up-automatically). Чтобы очистить ветку, нажмите на значок корзины на панели. Требуется Claude Code v2.1.227 или новее.180* **Побочные вопросы**: введите `/btw`, а затем вопрос, чтобы спросить о вашей сессии, [не добавляя его в диалог](/docs/ru/interactive-mode#side-questions-with-%2Fbtw). Ответ открывается на панели рядом с чатом, где можно задавать уточняющие вопросы. Требуется Claude Code v2.1.227 или более поздней версии.

165* **Копирование ответа**: наведите курсор на ответ и нажмите **Copy response**, чтобы скопировать его в буфер обмена, или введите `/copy`, чтобы скопировать последний ответ. `/copy 2` копирует предпоследний. Требуется Claude Code v2.1.277 или новее.181

182 Ветка сохраняется при перезагрузке окна. Claude Code хранит 20 последних обменов сообщениями и удаляет сохранённые ветки по расписанию [`cleanupPeriodDays`](/docs/ru/settings-reference#cleanupperioddays), если Claude Code может [безопасно определить срок хранения](/docs/ru/claude-directory#cleaned-up-automatically). Чтобы очистить ветку, нажмите на значок корзины на панели.

183* **Копирование ответа**: наведите курсор на ответ и нажмите **Copy response**, чтобы скопировать его в буфер обмена, или введите `/copy`, чтобы скопировать последний ответ. `/copy 2` копирует предпоследний. Требуется Claude Code v2.1.277 или более поздней версии.

166* **Закладки**: наведите курсор на ответ и нажмите **Bookmark response**, чтобы сохранить его, или нажмите **Remove bookmark** на сохранённом ответе, чтобы удалить закладку.184* **Закладки**: наведите курсор на ответ и нажмите **Bookmark response**, чтобы сохранить его, или нажмите **Remove bookmark** на сохранённом ответе, чтобы удалить закладку.

167 185

168 Чтобы просмотреть сохранённые ответы, откройте панель Bookmarks: нажмите на значок закладки в верхней части панели Claude Code, выберите **Bookmarks** в разделе Context меню команд или введите `/bookmarks`. Требуется Claude Code v2.1.286 или новее.186 Чтобы просмотреть сохранённые ответы, откройте панель Bookmarks. Можно нажать на значок закладки вверху панели Claude Code, выбрать **Bookmarks** в разделе Context меню команд или ввести `/bookmarks`. Требуется Claude Code v2.1.286 или более поздней версии.

169* **Файлы, которые вам отправляет Claude**: когда сессия подключена к [Remote Control](/docs/ru/remote-control#start-a-remote-control-session) и Claude отправляет вам файлы с помощью [инструмента `SendUserFile`](/docs/ru/tools-reference), в диалоге отображается строка, например **Sent report.md, chart.png**. Нажмите на имя файла, чтобы открыть его в редакторе.187* **Файлы, которые отправляет вам Claude**: когда сессия подключена к [Remote Control](/docs/ru/remote-control#start-a-remote-control-session) и Claude отправляет вам файлы с помощью [инструмента `SendUserFile`](/docs/ru/tools-reference), в диалоге отображается строка вида **Sent report.md, chart.png**. Нажмите на имя файла, чтобы открыть его в редакторе.

170* **Индикатор контекста**: поле ввода промпта показывает, какая часть контекстного окна Claude используется. Claude автоматически выполняет сжатие контекста при необходимости, или вы можете запустить `/compact` вручную.188* **Индикатор контекста**: поле ввода промпта показывает, какую часть контекстного окна Claude вы используете. Claude автоматически выполняет сжатие контекста при необходимости, или вы можете запустить `/compact` вручную.

171* **Часы кэша промптов**: значок часов рядом с индикатором контекста показывает приблизительное время, оставшееся до истечения [кэша промптов](/docs/ru/prompt-caching) диалога. Отсчёт идёт от пятиминутного или часового [срока жизни](/docs/ru/prompt-caching#cache-lifetime) кэша, и каждый ответ, использующий кэш, перезапускает отсчёт. Помимо сжатия контекста, [действия, которые делают кэш недействительным](/docs/ru/prompt-caching#actions-that-invalidate-the-cache), не сбрасывают часы, поэтому после смены модели они всё ещё могут показывать оставшиеся минуты.189* **Часы кэша промптов**: значок часов рядом с индикатором контекста оценивает, сколько времени осталось до истечения срока действия [кэша промптов](/docs/ru/prompt-caching) диалога. Он отсчитывает время от пятиминутного или часового [срока жизни](/docs/ru/prompt-caching#cache-lifetime) кэша, и каждый ответ, использующий кэш, перезапускает отсчёт. Помимо сжатия контекста, [действия, которые делают кэш недействительным](/docs/ru/prompt-caching#actions-that-invalidate-the-cache), не сбрасывают часы, поэтому после смены модели они всё ещё могут показывать оставшиеся минуты.

172 * Пока отсчёт не закончился, значок показывает оставшиеся минуты, например **12m**.190 * Пока отсчёт не закончился, значок показывает оставшиеся минуты, например **12m**.

173 * Когда отсчёт заканчивается, минуты исчезают, а значок становится красным (или цвета ошибки в вашей теме) до следующего ответа. Кэш, скорее всего, истёк, поэтому ожидайте более медленного и дорогого ответа на следующее сообщение, пока кэш создаётся заново. Если пятиминутный срок жизни постоянно истекает между вашими сообщениями, см. раздел [Выбор TTL вручную](/docs/ru/prompt-caching#choose-the-ttl-yourself).191 * Когда отсчёт заканчивается, минуты исчезают, а значок становится красным или цвета ошибки вашей темы до следующего ответа. Срок действия кэша, скорее всего, истёк, поэтому ожидайте более медленный и более дорогой ответ на следующее сообщение, пока кэш перестраивается. Если пятиминутный срок жизни постоянно истекает между вашими сообщениями, см. раздел [Выбор TTL самостоятельно](/docs/ru/prompt-caching#choose-the-ttl-yourself).

174 * Сразу после [сжатия](/docs/ru/prompt-caching#compacting-the-conversation) диалога значок также становится красным без минут до следующего ответа, потому что кэш ещё не охватывает сжатый диалог.192 * Сразу после [сжатия диалога](/docs/ru/prompt-caching#compacting-the-conversation) значок также становится красным без минут до следующего ответа, потому что кэш ещё не охватывает сжатый диалог.

175* **Карта агентов**: когда диалог включает [субагентов](/docs/ru/sub-agents), в нижней части поля ввода промпта появляется счётчик агентов, например **2 agents**. Его точка показывает, работает ли какой-либо субагент или ожидает вашего разрешения.193* **Карта агентов**: когда диалог включает [субагентов](/docs/ru/sub-agents), внизу поля ввода промпта появляется счётчик агентов, например **2 agents**. Его точка показывает, работает ли какой-либо субагент или ожидает вашего разрешения.

176 194

177 Нажмите на счётчик агентов, чтобы открыть карту агентов, которая отображает субагентов диалога в виде дерева под основным агентом, с указанием статуса, затраченного времени и количества токенов для каждого. Нажмите на субагента, чтобы увидеть его промпт и вызовы инструментов, открыть его транскрипт только для чтения или остановить его во время работы. Требуется Claude Code v2.1.269 или новее.195 Нажмите на счётчик агентов, чтобы открыть карту агентов, на которой субагенты диалога изображены в виде дерева под основным агентом, у каждого — статус, затраченное время и количество токенов. Нажмите на субагента, чтобы увидеть его промпт и вызовы инструментов, открыть его транскрипт только для чтения или остановить его во время работы. Требуется Claude Code v2.1.269 или более поздней версии.

178 196

179 Под агентами на карте также перечислены другие [фоновые задачи](/docs/ru/tools-reference#background-commands) сессии, например фоновые shell-команды и [мониторы](/docs/ru/tools-reference#monitor-tool). Нажмите на строку, чтобы открыть карточку задачи и остановить её там.197 На карте также перечислены другие [фоновые задачи](/docs/ru/tools-reference#background-commands) сессии, такие как фоновые shell-команды и [мониторы](/docs/ru/tools-reference#monitor-tool), под агентами. Нажмите на строку, чтобы открыть карточку задачи и остановить её там.

180 198

181 Чтобы открыть карту, когда счётчик агентов не отображается, например когда Claude запустил фоновую оболочку, но не субагентов, введите `/tasks` в поле ввода промпта. Фоновые задачи на карте и ввод `/tasks` требуют Claude Code v2.1.277 или новее.199 Чтобы открыть карту, когда счётчик агентов не отображается, например когда Claude запустил фоновую оболочку, но не запустил субагентов, введите `/tasks` в поле ввода промпта. Фоновые задачи на карте и ввод `/tasks` требуют Claude Code v2.1.277 или более поздней версии.

182 200

183 В Claude Code v2.1.286 и новее, когда вы нажимаете **Stop** или клавишу `Esc`, текущий ход завершается. Фоновые агенты продолжают работать, пока не завершатся или пока вы не остановите их с карты.201 В Claude Code v2.1.286 и более поздних версиях, когда вы нажимаете **Stop** или клавишу `Esc`, текущий ход завершается. Фоновые агенты продолжают работать, пока не закончат или пока вы не остановите их с карты.

184* **Расширенное мышление**: позволяет Claude тратить больше времени на рассуждения над сложными задачами. Включите его через меню команд (`/`). Размышления Claude отображаются в диалоге в виде свёрнутых блоков: нажмите на блок, чтобы прочитать его, или нажмите `Ctrl+O`, чтобы развернуть или свернуть все блоки размышлений в сессии. Подробнее см. в разделе [Расширенное мышление](/docs/ru/model-config#extended-thinking).202* **Расширенное мышление**: позволяет Claude тратить больше времени на рассуждения над сложными задачами. Включите его через меню команд (`/`). Размышления Claude отображаются в диалоге в виде свёрнутых блоков: нажмите на блок, чтобы прочитать его, или нажмите `Ctrl+O`, чтобы развернуть или свернуть все блоки размышлений в сессии. Подробнее см. в разделе [Расширенное мышление](/docs/ru/model-config#extended-thinking).

185* **Многострочный ввод**: нажмите `Shift+Enter`, чтобы добавить новую строку без отправки. Это также работает в поле свободного ввода «Other» в диалоговых окнах с вопросами.203* **Многострочный ввод**: нажмите `Shift+Enter`, чтобы добавить новую строку без отправки. Это также работает в поле свободного ввода «Other» в диалоговых окнах с вопросами.

186 204

195What's in @src/components/ (include a trailing slash for folders)213What's in @src/components/ (include a trailing slash for folders)

196```214```

197 215

198Для больших PDF-файлов можно попросить Claude прочитать определённые страницы вместо всего файла: одну страницу, диапазон, например страницы 1–10, или открытый диапазон, например начиная со страницы 3. Чтение определённых страниц требует наличия [poppler-utils](/docs/ru/tools-reference#read-tool-behavior) на машине, где работает Claude Code.216Для больших PDF-файлов можно попросить Claude прочитать определённые страницы вместо всего файла. Запросите одну страницу, диапазон, например страницы 1–10, или открытый диапазон, например со страницы 3 и далее. Чтение определённых страниц требует наличия [poppler-utils](/docs/ru/tools-reference#read-tool-behavior) на машине, где работает Claude Code.

217

218Когда вы выделяете текст в редакторе, Claude автоматически видит выделенный код. В нижней части поля ввода промпта показывается, сколько строк выделено. Нажмите `Option+K` (Mac) / `Alt+K` (Windows/Linux), чтобы вставить @-упоминание с путём к файлу и номерами строк, например `@app.ts#5-10`. Нажмите **X** на индикаторе выделения, чтобы убрать его, и тогда Claude не получит выделение. Индикатор вернётся, когда вы выделите другой текст.

219

220Расширение не передаёт выделенный текст из некоторых файлов:

199 221

200Когда вы выделяете текст в редакторе, Claude автоматически видит выделенный код. В нижней части поля ввода промпта отображается количество выделенных строк. Нажмите `Option+K` (Mac) / `Alt+K` (Windows/Linux), чтобы вставить @-упоминание с путём к файлу и номерами строк (например, `@app.ts#5-10`). Нажмите **X** на индикаторе выделения, чтобы убрать его, и тогда Claude не получит выделенный фрагмент. Индикатор появится снова, когда вы выделите другой текст.222* Если файл находится внутри вашей рабочей области и соответствует настройкам `files.exclude` или `search.exclude`, Claude получает не более чем путь к файлу, но не выделенный вами текст.

223* То же самое относится к файлу, который игнорируется git, при условии что настройка VS Code `search.useIgnoreFiles` и [настройка `respectGitIgnore`](#extension-settings) расширения обе включены, что является значением по умолчанию.

201 224

202Расширение не передаёт выделенный текст из некоторых файлов. Если файл находится внутри вашей рабочей области и соответствует настройкам `files.exclude` или `search.exclude`, Claude получает не более чем путь к файлу, но не выделенный вами текст. То же относится к файлу, который игнорирует git, при условии что настройка VS Code `search.useIgnoreFiles` и [настройка расширения `respectGitIgnore`](#extension-settings) обе включены, что является поведением по умолчанию. Этот фильтр действует только для панели чата: когда Claude Code работает во встроенном терминале, CLI отправляет выделенный текст независимо от файла, поэтому добавьте [правило запрета `Read`](#the-built-in-ide-mcp-server), чтобы скрыть содержимое файла от Claude в этом случае.225Этот фильтр распространяется только на панель чата. Когда Claude Code работает во встроенном терминале, CLI отправляет выделенный текст независимо от файла. Чтобы скрыть содержимое файла от Claude в этом случае, добавьте [правило запрета `Read`](#the-built-in-ide-mcp-server).

203 226

204Claude также видит, какой файл открыт в редакторе, даже когда ничего не выделено, а поле ввода промпта показывает его имя. Чтобы добавлять только выделенный текст, отключите [настройку Attach Open File](vscode://settings/claudeCode.attachOpenFile). Эта настройка требует Claude Code v2.1.271 или новее.227Claude также видит, какой файл открыт в редакторе, даже если ничего не выделено, и поле ввода промпта показывает его имя. Чтобы добавлять только выделенный текст, отключите [настройку Attach Open File](vscode://settings/claudeCode.attachOpenFile). Эта настройка требует Claude Code v2.1.271 или более поздней версии.

205 228

206Вы также можете прикреплять к сообщению изображения и файлы:229Также можно прикреплять к сообщению изображения и файлы:

207 230

208* Чтобы прикрепить изображение, вставьте его из буфера обмена в поле ввода промпта.231* Чтобы прикрепить изображение, вставьте его из буфера обмена в поле ввода промпта.

209* Чтобы прикрепить файлы, перетащите их в поле ввода промпта, удерживая `Shift`.232* Чтобы прикрепить файлы, перетащите их в поле ввода промпта, удерживая `Shift`.

210* Чтобы удалить вложение из контекста, нажмите на X на нём.233* Чтобы удалить вложение из контекста, нажмите на X на нём.

211 234

235<h3 id="include-terminal-output-in-prompts">

236 Включение вывода терминала в промпты

237</h3>

238

239Ссылайтесь на вывод терминала в промптах с помощью `@terminal:name`, где `name` — заголовок терминала. Это позволяет Claude видеть вывод команд, сообщения об ошибках или логи без копирования и вставки.

240

212<h3 id="paste-text">241<h3 id="paste-text">

213 Вставка текста242 Вставка текста

214</h3>243</h3>

215 244

216Вставленный текст остаётся видимым в поле ввода промпта, а не сворачивается в заполнитель, как это происходит [в терминале](/docs/ru/terminal-config#paste-large-content). В сессиях, где Claude Code [помечает вставленный текст](/docs/ru/terminal-config#how-claude-treats-pasted-text), Claude по-прежнему воспринимает большую вставку как вставленный, а не набранный вами текст.245Вставленный текст остаётся видимым в поле ввода промпта, а не сворачивается в заполнитель, как это происходит [в терминале](/docs/ru/terminal-config#paste-large-content). В сессиях, где Claude Code [помечает вставленный текст](/docs/ru/terminal-config#how-claude-treats-pasted-text), Claude по-прежнему видит большой фрагмент как вставленный вами текст, а не набранный.

217 246

218Claude Code также удаляет [невидимые символы Unicode](/docs/ru/interactive-mode#invisible-characters-in-prompts) из текста, который вы вставляете в поле ввода промпта, и из всего остального, что вы отправляете:247Claude Code также удаляет [невидимые символы Unicode](/docs/ru/interactive-mode#invisible-characters-in-prompts) из текста, который вы вставляете в поле ввода промпта, и из всего остального, что вы отправляете:

219 248

220* Если при вставке появляется уведомление вида `Removed 3 invisible characters from the pasted text`, текст был вставлен без этих символов.249* Если при вставке появляется уведомление, например `Removed 3 invisible characters from the pasted text`, текст был вставлен без этих символов.

221* Если уведомление об удалённых символах появляется при отправке, ничего не было отправлено. Очищенный текст возвращается в поле ввода промпта. Отправьте ещё раз, чтобы отправить текст в показанном виде.250* Если уведомление об удалённых символах появляется при отправке, ничего не было отправлено. Очищенный текст возвращается в поле ввода промпта. Отправьте снова, чтобы отправить текст в том виде, в котором он отображается.

222 251

223<h3 id="latex-math-in-responses">252<h3 id="latex-math-in-responses">

224 Математические формулы LaTeX в ответах253 Математика LaTeX в ответах

225</h3>254</h3>

226 255

227Панель чата отображает математические формулы LaTeX в ответах Claude в виде свёрстанных формул. Отображение формул требует Claude Code v2.1.301 или новее. В [режиме терминала](#switch-to-terminal-mode) формулы не верстаются. Панель верстает как выносные, так и строчные формулы:256Панель чата отображает математические выражения LaTeX в ответах Claude в виде свёрстанных формул. Отрисовка математики требует Claude Code v2.1.301 или более поздней версии. В [режиме терминала](#switch-to-terminal-mode) математика не верстается. Панель верстает как выносные, так и строчные формулы:

228 257

229* **Выносные формулы**: блок `$$ … $$` или `\[ … \]` на отдельной строке или строках, а также огороженный блок кода с языком `math`258* **Выносные формулы**: блок `$$ … $$` или `\[ … \]` на отдельной строке или строках, а также огороженный блок кода с языком `math`

230* **Строчные формулы**: `$…$` или `$…$`, которые открываются и закрываются в одной строке, например `$E = mc^2$` или `$a^2 + b^2 = c^2$`259* **Строчные формулы**: `$…$` или `$…$`, которые открываются и закрываются на одной строке, например `$E = mc^2$` или `$a^2 + b^2 = c^2$`

231 260

232Панель пытается отличать формулы от других случаев использования тех же символов, поэтому такой текст, как `$HOME`, цена вроде `$5` или `sed 's/$foo$/\1/'`, не верстается. Не верстается и текст внутри фрагмента кода или внутри любого блока кода, кроме огороженного блока `math`. Если формула отображается в исходном виде, хотя вы ожидали свёрстанную, см. раздел [Формула отображается как необработанный LaTeX](#a-formula-shows-as-raw-latex).261Панель пытается отличать математику от других вариантов использования тех же символов, поэтому такой текст, как `$HOME`, цена вроде `$5` или `sed 's/$foo$/\1/'`, не верстается. Не верстается и текст внутри фрагмента кода или внутри любого блока кода, кроме огороженного блока `math`. Если формула отображается в исходном виде, хотя вы ожидали её свёрстанной, см. раздел [Формула отображается как необработанный LaTeX](#a-formula-shows-as-raw-latex).

233 262

234Когда вы выделяете и копируете текст, содержащий свёрстанную формулу, вы получаете исходный код TeX этой формулы в разделителях `$…$` или `$$…$$`, а не отрисованные символы. [**Copy response**](#use-the-prompt-box) и `/copy` выдают ответ в том виде, в каком его написал Claude, включая исходный код TeX.263Когда вы выделяете и копируете текст, содержащий свёрстанную формулу, вы получаете исходный код TeX формулы в разделителях `$…$` или `$$…$$`, а не отрисованные символы. [**Copy response**](#use-the-prompt-box) и `/copy` дают ответ в том виде, в котором его написал Claude, включая исходный код TeX.

235 264

236<h3 id="resume-past-conversations">265<h3 id="resume-past-conversations">

237 Возобновление прошлых диалогов266 Возобновление прошлых диалогов

238</h3>267</h3>

239 268

240Нажмите кнопку **Session history** в верхней части панели Claude Code, чтобы открыть историю диалогов. Можно искать по ключевому слову или просматривать по времени.269Нажмите кнопку **Session history** вверху панели Claude Code, чтобы получить доступ к истории диалогов. Можно искать по ключевому слову или просматривать по времени.

270

271Нажмите на любой диалог, чтобы возобновить его с полной историей сообщений. Если диалог уже открыт в другой вкладке текущего окна, нажатие переключит на эту вкладку. Если сообщения поначалу остаются пустыми, см. раздел [почему они пустые и когда появляются](#a-resumed-conversation-is-blank-at-first). Подробнее о возобновлении сессий см. в разделе [Управление сессиями](/docs/ru/sessions).

241 272

242Нажмите на любой диалог, чтобы возобновить его с полной историей сообщений. Если диалог уже открыт в другой вкладке текущего окна, нажатие переключит вас на эту вкладку. Если сообщения поначалу остаются пустыми, см. раздел [почему они пусты и когда появятся](#a-resumed-conversation-is-blank-at-first). Подробнее о возобновлении сессий см. в разделе [Управление сессиями](/docs/ru/sessions).273* **Заголовки сессий**: новые сессии получают сгенерированные ИИ заголовки на основе вашего первого сообщения.

274* **Переименование и архивация**: наведите курсор на сессию, чтобы увидеть эти действия. Переименуйте её, чтобы дать описательный заголовок, или заархивируйте, чтобы переместить в группу **Archived sessions** внизу списка.

243 275

244* **Названия сессий**: новые сессии получают названия, сгенерированные ИИ на основе вашего первого сообщения.276Если диалог открыт в другом процессе Claude Code, например `claude` в терминале или в другом окне VS Code, вместо поля ввода промпта появляется следующее уведомление:

245* **Переименование и архивирование**: наведите курсор на сессию, чтобы увидеть эти действия. Переименуйте её, чтобы дать описательное название, или заархивируйте, чтобы переместить в группу **Archived sessions** в нижней части списка.

246 277

247Если диалог (сам разговор с Claude, а не окно) открыт в другом процессе Claude Code, например в `claude` в терминале или в другом окне VS Code, вместо поля ввода промпта появляется уведомление: `This conversation is still open somewhere else. Using it in two places at once can mix up its messages.` Чтобы продолжить здесь, закройте этот диалог в другом месте, а затем нажмите **Open here anyway**. Если нажать, не закрыв его, диалог будет открыт в обоих местах. Если задана настройка [`claudeProcessWrapper`](#extension-settings), расширение пропускает эту проверку и сразу открывает диалог.278```text theme={null}

279This conversation is still open somewhere else. Using it in two places at once can mix up its messages.

280```

248 281

249По умолчанию сессия без активности в течение 14 дней автоматически перемещается в **Archived sessions**, если она не открыта, не является непрочитанной и не находится в [группе](#organize-sessions-into-groups). Автоматическое архивирование требует Claude Code v2.1.265 или новее. Чтобы изменить период или отключить эту функцию, откройте [настройку Archive Inactive Sessions](vscode://settings/claudeCode.archiveInactiveSessions) и выберите количество дней или **Never**.282Чтобы продолжить здесь, закройте диалог в другом месте, а затем нажмите **Open here anyway**. Если нажать, не закрыв его, диалог будет открыт в обоих местах. Если задана настройка [`claudeProcessWrapper`](#extension-settings), расширение пропускает эту проверку и открывает диалог напрямую.

250 283

251Чтобы восстановить заархивированную сессию, разверните **Archived sessions** и нажмите **Unarchive session**. Чтобы восстановить все заархивированные сессии сразу, наведите курсор на заголовок **Archived sessions** в списке сессий на панели действий и нажмите на его значок разархивирования; для этого требуется Claude Code v2.1.277 или новее. До v2.1.257 это действие называлось **Delete session** и скрывало сессию без возможности её восстановить. Удалённые тогда сессии появятся в **Archived sessions** после обновления.284По умолчанию сессия без активности в течение 14 дней автоматически перемещается в **Archived sessions**, если она не открыта, не является непрочитанной и не находится в [группе](#organize-sessions-into-groups). Автоматическая архивация требует Claude Code v2.1.265 или более поздней версии. Чтобы изменить период или отключить её, откройте [настройку Archive Inactive Sessions](vscode://settings/claudeCode.archiveInactiveSessions) и выберите количество дней или **Never**.

252 285

253Если возобновляемый диалог завершился в режиме планирования, Claude Code восстанавливает режим планирования. Требуется Claude Code v2.1.246 или новее. Claude Code не восстанавливает его в следующих случаях:286Чтобы восстановить заархивированные сессии:

287

288* **Одна сессия**: разверните **Archived sessions** и нажмите **Unarchive session**.

289* **Все заархивированные сессии сразу**: наведите курсор на заголовок **Archived sessions** в списке сессий на панели действий и нажмите на его значок разархивации. Требуется Claude Code v2.1.277 или более поздней версии.

290

291До v2.1.257 это действие называлось **Delete session** и скрывало сессию без возможности восстановления. Сессии, которые вы тогда удалили, после обновления появятся в разделе **Archived sessions**.

292

293Если возобновляемый диалог завершился в режиме планирования, Claude Code восстанавливает режим планирования. Требуется Claude Code v2.1.246 или более поздней версии. Claude Code не восстанавливает его в следующих случаях:

254 294

255* Расширение [выбирает начальный режим разрешений](/docs/ru/permission-modes#switch-permission-modes) из `claudeCode.initialPermissionMode` или из выбора, перенесённого из более раннего диалога295* Расширение [выбирает начальный режим разрешений](/docs/ru/permission-modes#switch-permission-modes) из `claudeCode.initialPermissionMode` или из выбора, перенесённого из более раннего диалога

256* У вас настроен `claudeCode.claudeProcessWrapper`296* У вас настроен `claudeCode.claudeProcessWrapper`

257* [Правило запрета](/docs/ru/permissions#manage-permissions) удаляет инструмент [`ExitPlanMode`](/docs/ru/tools-reference)297* [Правило запрета](/docs/ru/permissions#manage-permissions) удаляет инструмент [`ExitPlanMode`](/docs/ru/tools-reference)

258 298

259<h3 id="resume-cloud-sessions-from-claude-ai">299<h3 id="resume-cloud-sessions-from-claude-ai">

260 Возобновление облачных сессий из Claude.ai300 Возобновление облачных сессий из claude.ai

261</h3>301</h3>

262 302

263Если вы используете [облачные сессии](/docs/ru/claude-code-on-the-web), их можно возобновлять прямо в VS Code. Для этого требуется вход через **Claude.ai Subscription**, а не Anthropic Console.303Если вы запускаете [облачные сессии](/docs/ru/claude-code-on-the-web), их можно возобновлять прямо в VS Code. Для этого требуется вход с помощью **Claude.ai Subscription**, а не Anthropic Console.

264 304

265<Steps>305<Steps>

266 <Step title="Откройте историю сессий">306 <Step title="Откройте историю сессий">

267 Нажмите кнопку **Session history** в верхней части панели Claude Code.307 Нажмите кнопку **Session history** вверху панели Claude Code.

268 </Step>308 </Step>

269 309

270 <Step title="Выберите вкладку Web">310 <Step title="Выберите вкладку Web">

271 В диалоговом окне есть две вкладки: Local и Web. Нажмите **Web**, чтобы увидеть сессии из claude.ai.311 В диалоговом окне отображаются две вкладки: Local и Web. Нажмите **Web**, чтобы увидеть сессии из claude.ai.

272 </Step>312 </Step>

273 313

274 <Step title="Выберите сессию для возобновления">314 <Step title="Выберите сессию для возобновления">

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

276 </Step>316 </Step>

277</Steps>317</Steps>

278 318

282 При возобновлении облачной сессии расширение загружает копию истории диалога; изменения не синхронизируются обратно с claude.ai.322 При возобновлении облачной сессии расширение загружает копию истории диалога; изменения не синхронизируются обратно с claude.ai.

283</Note>323</Note>

284 324

285На вкладке Web также перечислены ваши сессии [Remote Control](/docs/ru/remote-control). Если вы нажмёте на сессию, которая выполнялась в открытой у вас папке, расширение откроет этот локальный диалог вместо загрузки копии и переключится на вкладку, где он уже отображается, если такая есть. Если расширение не может исключить, что диалог открыт в другом процессе Claude, вместо этого вы получите загруженную копию.325На вкладке Web также перечислены ваши сессии [Remote Control](/docs/ru/remote-control). Если нажать на сессию, которая выполнялась в открытой у вас папке, расширение откроет этот локальный диалог вместо загрузки копии. Расширение переходит на вкладку, в которой он уже отображается, если такая есть. Если расширение не может исключить, что диалог открыт другим процессом Claude, вместо этого вы получите загруженную копию.

286 326

287Если какую-либо часть диалога не удаётся загрузить, появляется ошибка, и копия не сохраняется. Выберите сессию снова, чтобы повторить попытку. Если вы выберете сессию, в которой ещё нет диалога для загрузки, в сообщении об ошибке будет указано, где её продолжить.327Если какую-либо часть диалога не удаётся загрузить, появляется ошибка и копия не сохраняется. Выберите сессию снова, чтобы повторить попытку. Если вы выбираете сессию, в которой ещё нет диалога для загрузки, ошибка сообщит, где его можно продолжить.

288 328

289<h3 id="check-account-and-usage">329<h3 id="check-account-and-usage">

290 Проверка аккаунта и использования330 Проверка учётной записи и использования

291</h3>331</h3>

292 332

293Выполните `/usage`, чтобы открыть диалоговое окно Account & usage. В нём показан аккаунт, с которым вы вошли, а отображаемые данные об использовании зависят от способа входа:333Выполните `/usage`, чтобы открыть диалоговое окно Account & usage, в котором отображаются учётная запись, с которой вы вошли, и ваше использование. Показатели использования зависят от способа входа:

334

335* **Тариф claude.ai**: полосы использования для лимитов вашего тарифа, например для текущей сессии и недели. Каждая полоса показывает, сколько времени осталось до сброса её лимита.

294 336

295* **Тариф claude.ai**: шкалы использования для лимитов вашего тарифа, например для текущей сессии и недели. Каждая шкала показывает, сколько времени осталось до сброса её лимита.337 Диалоговое окно также показывает разбивку того, что влияет на лимиты тарифа. Оно помечает модели поведения, на которые приходится 10% или более недавнего использования, например промахи кэша, длинный контекст и сессии с интенсивным использованием субагентов или высоким параллелизмом. Для каждого помеченного поведения даётся совет, как его сократить. Таблицы атрибуции показывают, сколько использования пришлось на каждый скилл, субагент, плагин и MCP-сервер.

296 338

297 Диалоговое окно также показывает, что влияет на расход лимитов тарифа. Оно помечает действия, на которые приходится 10% или более недавнего использования, например промахи кэша, длинный контекст, а также сессии с активным использованием субагентов или высоким параллелизмом, и для каждого даёт совет, как его снизить. Таблицы атрибуции показывают, какая доля использования пришлась на каждый скилл, субагент, плагин и MCP-сервер.339 Используйте переключатель Day и Week, чтобы переключаться между последними 24 часами и последними 7 днями. Показатели приблизительны и вычисляются по локальным сессиям на этой машине, поэтому использование с других устройств или claude.ai не учитывается.

340* **Другие способы входа**: когда лимиты тарифа не применяются к вашему способу входа, например при использовании [стороннего провайдера](#use-third-party-providers) или API-ключа, раздел Usage вместо этого показывает стоимость и использование токенов самой сессии. `/usage` в CLI показывает те же итоги в своём [блоке Session](/docs/ru/costs#track-your-costs). Список сессий на панели действий также показывает итоги активной сессии под заголовком **Account & usage**. Требуется Claude Code v2.1.277 или более поздней версии.

298 341

299 Используйте переключатель Day и Week, чтобы переключаться между последними 24 часами и последними 7 днями. Цифры приблизительные и рассчитываются по локальным сессиям на этой машине, поэтому использование с других устройств или claude.ai не учитывается.342Подробнее об отслеживании и сокращении использования см. в разделе [Отслеживание расходов](/docs/ru/costs#track-your-costs).

300* **Другие способы входа**: когда лимиты тарифа не применяются к вашему способу входа, например при использовании [стороннего провайдера](#use-third-party-providers) или API-ключа, в разделе Usage вместо этого отображаются стоимость и использование токенов самой сессии. Команда `/usage` в CLI показывает те же итоги в своём [блоке Session](/docs/ru/costs#track-your-costs). Список сессий на панели действий также показывает итоги активной сессии под заголовком **Account & usage**. Требуется Claude Code v2.1.277 или новее.

301 343

302Подробнее об отслеживании и сокращении использования см. в разделе [Отслеживание затрат](/docs/ru/costs#track-your-costs).344<h3 id="rewind-with-checkpoints">

345 Откат с помощью чекпоинтов

346</h3>

347

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

349

350* **Fork conversation from here**: начать новую ветку диалога с этого сообщения, сохранив все изменения кода

351* **Rewind code to here**: откатить изменения файлов к этому моменту диалога, сохранив полную историю диалога

352* **Fork conversation and rewind code**: начать новую ветку диалога и откатить изменения файлов к этому моменту

353

354Подробнее о том, как работают чекпоинты, и об их ограничениях см. в разделе [Чекпоинты](/docs/ru/checkpointing).

303 355

304<h2 id="customize-your-workflow">356<h2 id="customize-your-workflow">

305 Настройте свой рабочий процесс357 Настройка рабочего процесса

306</h2>358</h2>

307 359

308Вы можете переместить панель Claude, запустить несколько разговоров, сгруппировать или отфильтровать список сеансов или переключиться в режим терминала.360Вы можете переместить панель Claude, вести несколько диалогов, группировать или фильтровать список сессий, а также переключиться в режим терминала.

309 361

310<h3 id="choose-where-claude-lives">362<h3 id="choose-where-claude-lives">

311 Выберите, где находится Claude363 Выбор расположения Claude

312</h3>364</h3>

313 365

314Вы можете перетащить панель Claude, чтобы переместить её в любое место в VS Code. Возьмитесь за вкладку или заголовок панели и перетащите её в:366Вы можете перетащить панель Claude в любое место в VS Code. Захватите вкладку или заголовок панели и перетащите её в одно из следующих мест:

315 367

316* **Вторичная боковая панель**: правая сторона окна. Держит Claude видимым во время кодирования.368* **Вторичная боковая панель**: правая часть окна. Claude остаётся на виду, пока вы пишете код.

317* **Основная боковая панель**: левая боковая панель со значками для Explorer, Search и т. д.369* **Основная боковая панель**: левая боковая панель со значками Explorer, Search и т. д.

318* **Область редактора**: открывает Claude как вкладку рядом с вашими файлами. Полезно для дополнительных задач.370* **Область редактора**: Claude открывается как вкладка рядом с вашими файлами. Удобно для побочных задач.

319 371

320Когда Claude открывает вкладку в новой группе редактора, расширение блокирует эту группу, поэтому файлы, которые вы открываете, пока вкладка Claude сфокусирована, переходят в другую группу вместо того, чтобы находиться рядом с ней.372Когда Claude открывает вкладку в новой группе редакторов, расширение блокирует эту группу. Файлы, которые вы открываете, пока вкладка Claude в фокусе, в этом случае попадают в другую группу, а не рядом с ней.

321 373

322Чтобы остановить расширение от блокировки групп, отключите [параметр Lock Editor Groups](vscode://settings/claudeCode.lockEditorGroups). Группы, которые уже заблокированы, остаются заблокированными, пока вы их не разблокируете. Этот параметр требует Claude Code v2.1.274 или более поздней версии.374Чтобы расширение не блокировало группы, отключите [настройку Lock Editor Groups](vscode://settings/claudeCode.lockEditorGroups). Уже заблокированные группы остаются заблокированными, пока вы их не разблокируете. Для этой настройки требуется Claude Code v2.1.274 или новее.

323 375

324<Tip>376<Tip>

325 Используйте боковую панель для вашего основного сеанса Claude и открывайте дополнительные вкладки для дополнительных задач. Claude запоминает ваше предпочтительное местоположение. Значок списка сеансов на панели действий отделён от панели Claude: список сеансов всегда виден на панели действий, а значок панели Claude появляется там только тогда, когда панель закреплена на левой боковой панели.377 Используйте боковую панель для основной сессии Claude и открывайте дополнительные вкладки для побочных задач. Claude запоминает выбранное вами расположение. Значок списка сессий на панели действий (Activity Bar) не связан с панелью Claude. Список сессий всегда доступен на панели действий, а значок панели Claude появляется там, только когда панель закреплена на левой боковой панели.

326</Tip>378</Tip>

327 379

328<h3 id="continue-conversations-after-a-reload">380<h3 id="continue-conversations-after-a-reload">

329 Продолжение диалогов после перезагрузки381 Продолжение диалогов после перезагрузки

330</h3>382</h3>

331 383

332После запуска **Developer: Reload Window** или перезагрузки VS Code, вернётся ли разговор со своей историей разговора, зависит от того, где он был открыт:384После выполнения **Developer: Reload Window** или перезапуска VS Code проверьте, где был открыт диалог:

333 385

334* **Вкладка редактора**: разговор возвращается со своей вкладкой.386* **Вкладка редактора**: диалог возвращается вместе со своей вкладкой.

335* **Боковая панель**: разговор возвращается, если вы отправили сообщение или Claude ответил в нём в течение последних 10 минут. Если он не вернётся, возобновите разговор из [истории сеансов](#resume-past-conversations).387* **Боковая панель**: диалог возвращается, если в последние 10 минут вы отправили в нём сообщение или Claude ответил в нём. Если диалог не вернулся, возобновите его из [истории сессий](#resume-past-conversations).

336 388

337Если другой процесс Claude Code всё ещё держит этот диалог открытым, перед его открытием здесь у вас запросят подтверждение с тем же уведомлением **Open here anyway**, что и при [возобновлении из истории сессий](#resume-past-conversations). Если сообщения поначалу остаются пустыми, см. [почему они пустые и когда они появятся](#a-resumed-conversation-is-blank-at-first).389Если диалог всё ещё открыт в другом процессе Claude Code, перед его открытием здесь вас спросят об этом с тем же уведомлением **Open here anyway**, что и при [возобновлении из истории сессий](#resume-past-conversations). Если сообщения поначалу пустые, см. раздел [о том, почему они пустые и когда появятся](#a-resumed-conversation-is-blank-at-first).

390

391<h4 id="interrupted-steps-after-a-reload">

392 Прерванные шаги после перезагрузки

393</h4>

394

395Если перезагрузка прервала Claude посреди шага, Claude продолжит этот шаг, когда диалог вернётся, а уведомление в чате отметит продолжение. Требуется Claude Code v2.1.274 или новее. Если шаг был прерван более часа назад или сессия открыта в другом месте, диалог вернётся в неактивном состоянии.

396

397<h4 id="turn-off-continuation-after-a-reload">

398 Отключение продолжения после перезагрузки

399</h4>

338 400

339Если перезагрузка прервала Claude в середине шага, Claude продолжит этот шаг, когда разговор вернётся, и уведомление в чате отметит продолжение. Требует Claude Code v2.1.274 или более поздней версии. Если шаг был прерван более часа назад или сеанс открыт в другом месте, разговор вернётся в режиме ожидания.401Чтобы Claude не продолжал прерванный шаг после перезагрузки, откройте [настройку Continue After Reload](vscode://settings/claudeCode.continueAfterReload) и снимите флажок.

340 402

341Чтобы отключить продолжение, откройте [настройку Continue After Reload](vscode://settings/claudeCode.continueAfterReload) и снимите флажок. Установка [`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/ru/env-vars#variables) или любой другой переменной `CLAUDE_CODE_RESUME_` в окружении VS Code или в [настройке `environmentVariables`](#extension-settings) не влияет на панель, поскольку расширение удаляет эти переменные перед запуском сессий панели.403Если вы задали [`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/ru/env-vars#variables) или любую другую переменную `CLAUDE_CODE_RESUME_` в окружении VS Code или в [настройке `environmentVariables`](#extension-settings), это не повлияет на панель. Дело в том, что расширение удаляет эти переменные перед запуском сессий панели.

342 404

343<h4 id="a-conversation-was-not-reopened">405<h4 id="a-conversation-was-not-reopened">

344 Диалог не был открыт повторно406 A conversation was not reopened

345</h4>407</h4>

346 408

347Если после перезагрузки появляется новый чат с подобным уведомлением над полем ввода промпта, это означает, что панель оставила ваш диалог закрытым, поскольку два последних открытия этого диалога не завершились:409Если после перезагрузки открылся новый чат с подобным уведомлением над полем ввода промпта, значит, панель оставила ваш диалог закрытым, потому что два последних его открытия не завершились:

348 410

349```text theme={null}411```text theme={null}

350“Fix the login bug” was not reopened. It did not finish opening the last 2 times, and opening it again may stop Claude Code from responding here.412“Fix the login bug” was not reopened. It did not finish opening the last 2 times, and opening it again may stop Claude Code from responding here.

351```413```

352 414

353Открытие не завершается, если панель аварийно завершает работу или перестаёт отвечать во время загрузки диалога, либо если вы перезагружаете или закрываете окно примерно в течение трёх секунд после его открытия. Ничего не теряется: диалог остаётся без изменений и сохраняется в [истории сессий](#resume-past-conversations).415Открытие не завершается, если панель аварийно завершает работу или перестаёт отвечать во время загрузки диалога, либо если вы перезагружаете или закрываете окно примерно в течение трёх секунд после его открытия. Диалог не изменяется и остаётся в [истории сессий](#resume-past-conversations).

354 416

355* **Чтобы всё равно открыть его**: нажмите **Open it anyway** или выберите диалог в истории сессий. Если он открывается и панель продолжает работать, он будет возвращаться после последующих перезагрузок как обычно. Если панель снова перестанет отвечать, перезагрузите окно, чтобы вернуться к новому чату с уведомлением.417* **Чтобы всё равно открыть его**: нажмите **Open it anyway** или выберите диалог в истории сессий. Если он откроется и панель продолжит работать, при последующих перезагрузках он будет возвращаться как обычно. Если панель снова перестанет отвечать, перезагрузите окно, чтобы вернуться к новому чату с уведомлением.

356* **Чтобы оставить его закрытым**: продолжайте работать в новом чате. Уведомление исчезнет, как только вы отправите промпт.418* **Чтобы оставить его закрытым**: продолжайте работать в новом чате. Уведомление исчезнет, как только вы отправите промпт.

357 419

358<h3 id="run-multiple-conversations">420<h3 id="run-multiple-conversations">

359 Запустите несколько разговоров421 Несколько диалогов одновременно

360</h3>422</h3>

361 423

362Используйте **Open in New Tab** или **Open in New Window** из палитры команд, чтобы начать дополнительные разговоры. Каждый разговор сохраняет свою собственную историю и контекст, позволяя вам работать над различными задачами параллельно.424Используйте **Open in New Tab** или **Open in New Window** из палитры команд, чтобы начать дополнительные диалоги. Каждый диалог хранит собственную историю и контекст, что позволяет работать над разными задачами параллельно.

363 425

364При использовании вкладок небольшая цветная точка на значке искры указывает статус: синий означает, что запрос разрешения ожидает, оранжевый означает, что Claude завершил работу, пока вкладка была скрыта.426При использовании вкладок небольшая цветная точка на значке искры показывает статус: синяя означает ожидающий запрос разрешения, оранжевая — что Claude завершил работу, пока вкладка была скрыта.

365 427

366<h3 id="organize-sessions-into-groups">428<h3 id="organize-sessions-into-groups">

367 Организуйте сеансы в группы429 Группировка сессий

368</h3>430</h3>

369 431

370В списке сеансов на панели действий вы можете собрать связанные сеансы в именованные, сворачиваемые группы. Требует Claude Code v2.1.229 или более поздней версии.432В списке сессий на панели действий можно объединять связанные сессии в именованные сворачиваемые группы. Требуется Claude Code v2.1.229 или новее.

371 433

372* **Сгруппировать или разгруппировать сеанс**: щёлкните правой кнопкой мыши на сеансе, чтобы создать группу из него, переместить его в существующую группу или удалить его из его группы. Каждый сеанс принадлежит одной группе одновременно, поэтому перемещение его в другую группу удаляет его из первой.434* **Добавление сессии в группу и удаление из неё**: щёлкните сессию правой кнопкой мыши, чтобы создать на её основе группу, переместить её в существующую группу или удалить из группы. Каждая сессия одновременно принадлежит только одной группе, поэтому при перемещении в другую группу она удаляется из первой.

373* **Переместить несколько сеансов одновременно**: `Cmd`-щелчок (Mac) / `Ctrl`-щелчок (Windows/Linux) на каждом сеансе или `Shift`-щелчок для выбора диапазона, затем щёлкните правой кнопкой мыши на выборе.435* **Перемещение нескольких сессий сразу**: щёлкните каждую сессию с `Cmd` (Mac) / `Ctrl` (Windows/Linux) или щёлкните с `Shift`, чтобы выбрать диапазон, затем щёлкните выделение правой кнопкой мыши.

374* **Сгруппировать сеанс из его вкладки**: запустите **Claude Code: Add Session Tab to Group** из палитры команд, затем выберите или создайте группу. Требует Claude Code v2.1.257 или более поздней версии.436* **Добавление сессии в группу с её вкладки**: выполните **Claude Code: Add Session Tab to Group** из палитры команд, затем выберите или создайте группу. Требуется Claude Code v2.1.257 или новее.

375* **Переименовать или удалить группу**: щёлкните правой кнопкой мыши на заголовке группы. Удаление группы удаляет только группу, и её сеансы возвращаются в список несгруппированных.437* **Переименование или удаление группы**: щёлкните заголовок группы правой кнопкой мыши. При удалении группы удаляется только сама группа, а её сессии возвращаются в список без группы.

376 438

377Расширение сохраняет группы для каждой папки рабочего пространства, поэтому они сохраняются при перезагрузке окна и появляются в каждом окне, где вы открываете одну и ту же папку. Когда вы ищете в списке, расширение показывает совпадения в одном плоском списке во всех группах.439Расширение сохраняет группы для каждой папки рабочей области, поэтому они сохраняются после перезагрузки окна и отображаются в каждом окне, где открыта та же папка. При поиске по списку расширение показывает совпадения единым плоским списком по всем группам.

378 440

379<h3 id="filter-the-sessions-list">441<h3 id="filter-the-sessions-list">

380 Отфильтруйте список сеансов442 Фильтрация списка сессий

381</h3>443</h3>

382 444

383Чтобы сузить длинный список сеансов на панели действий, используйте два элемента управления фильтром в верхней части списка. Требует Claude Code v2.1.271 или более поздней версии. Архивированные сеансы не отображаются, пока включен какой-либо фильтр.445Чтобы сократить длинный список сессий на панели действий, используйте два элемента фильтрации в верхней части списка. Требуется Claude Code v2.1.271 или новее. Архивированные сессии не отображаются, пока включён любой из фильтров.

384 446

385* **Active**: включите этот переключатель, чтобы показать только сеансы, которые требуют вашего ввода, работают или не прочитаны, плюс сеанс на вкладке Claude, на которой вы в последний раз сфокусировались.447* **Active**: включите этот переключатель, чтобы показывать только сессии, которые ожидают вашего ввода, выполняются или не прочитаны, а также сессию во вкладке Claude, на которой вы последний раз были в фокусе.

386* **Filter by status**: щёлкните на значке воронки, затем установите флажок **Needs input**, **Working** или **Completed**, чтобы показать сеансы в любом из этих состояний. Установите флажок **Open** или **Closed**, чтобы сузить по тому, открыт ли сеанс. Сеанс считается открытым, когда он имеет вкладку в этом окне или работает в другом процессе Claude Code на этой машине, например в терминале.448* **Фильтр по статусу**: щёлкните значок воронки, затем отметьте **Needs input**, **Working** или **Completed**, чтобы показать сессии в любом из этих состояний. Отметьте **Open** или **Closed**, чтобы отфильтровать сессии по тому, открыты ли они. Сессия считается открытой, если у неё есть вкладка в этом окне или она выполняется в другом процессе Claude Code на этом компьютере, например в терминале.

387 449

388Когда **Active** включен и вы устанавливаете флажок на статус, **Open** или **Closed**, список также показывает каждый сеанс, который соответствует вашим проверкам. Фильтры, которые вы установили, сохраняются при перезагрузке окна.450Когда **Active** включён и вы отмечаете статус, **Open** или **Closed**, в списке также отображаются все сессии, соответствующие отмеченным условиям. Заданные вами фильтры сохраняются после перезагрузки окна.

389 451

390<h3 id="switch-to-terminal-mode">452<h3 id="switch-to-terminal-mode">

391 Переключитесь в режим терминала453 Переключение в режим терминала

392</h3>454</h3>

393 455

394По умолчанию расширение открывает графическую панель чата. Если вы предпочитаете интерфейс в стиле CLI, откройте [параметр Use Terminal](vscode://settings/claudeCode.useTerminal) и установите флажок.456По умолчанию расширение открывает графическую панель чата. Если вы предпочитаете интерфейс в стиле CLI, откройте [настройку Use Terminal](vscode://settings/claudeCode.useTerminal) и установите флажок.

395 457

396Вы также можете открыть параметры VS Code (`Cmd+,` на Mac или `Ctrl+,` на Windows/Linux), перейти в Extensions → Claude Code и установить флажок **Use Terminal**.458Также можно нажать `Cmd+,` на Mac или `Ctrl+,` на Windows/Linux, чтобы открыть настройки VS Code, перейти в **Extensions > Claude Code** и отметить **Use Terminal**.

397 459

398<h2 id="manage-plugins">460<h2 id="manage-plugins">

399 Управление плагинами461 Управление плагинами

400</h2>462</h2>

401 463

402Расширение VS Code включает графический интерфейс для установки и управления [плагинами](/docs/ru/plugins/overview). Введите `/plugins` в поле подсказки, чтобы открыть интерфейс **Управление плагинами**.464Расширение VS Code включает графический интерфейс для установки [плагинов](/docs/ru/plugins/overview) и управления ими. Введите `/plugins` в поле промпта, чтобы открыть интерфейс **Manage plugins**.

403 465

404<h3 id="install-plugins">466<h3 id="install-plugins">

405 Установка плагинов467 Установка плагинов

406</h3>468</h3>

407 469

408Диалоговое окно плагина показывает две вкладки: **Плагины** и **Маркетплейсы**.470В диалоговом окне плагинов есть две вкладки: **Plugins** и **Marketplaces**.

409 471

410На вкладке Плагины:472На вкладке Plugins:

411 473

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

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

414 * Для плагина, который не удалось загрузить, в его строке отображается краткая причина. Нажмите на причину, чтобы узнать, что можно сделать, включая копирование полного сообщения об ошибке для поиска в разделе [Устранение неполадок с плагинами](/docs/ru/plugins/troubleshooting).476 * Для плагина, который не удалось загрузить, в его строке отображается краткая причина. Нажмите на причину, чтобы узнать, что можно сделать, включая копирование полного сообщения об ошибке для поиска в разделе [Устранение неполадок с плагинами](/docs/ru/plugins/troubleshooting).

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

416* Используйте поиск для фильтрации плагинов по названию или описанию478* Используйте поиск, чтобы отфильтровать плагины по имени или описанию

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

418 480

419При установке плагина выберите область установки:481При установке плагина выберите область действия установки:

420 482

421* **Установить для вас**: доступно во всех ваших проектах (область пользователя)483* **Install for you**: доступен во всех ваших проектах (область действия пользователя)

422* **Установить для этого проекта**: общее использование с сотрудниками проекта (область проекта)484* **Install for this project**: доступен участникам проекта (область действия проекта)

423* **Установить локально**: только для вас, только в этом репозитории (локальная область)485* **Install locally**: только для вас и только в этом репозитории (локальная область действия)

424 486

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

426 488

427Чувствительные текстовые поля скрыты, а сохраненный ранее секрет отображается как **(без изменений)**. Оставьте поле пустым, чтобы сохранить сохраненное значение.489Конфиденциальные текстовые поля маскируются, а для ранее сохранённого секрета отображается **(unchanged)**. Оставьте поле пустым, чтобы сохранить прежнее значение. После сохранения изменений открытые сессии перезагружают свои плагины, а в диалоговом окне отображается **Restart Claude to apply plugin changes**.

~~428~~

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

430 490

431<h3 id="uninstall-plugins">491<h3 id="uninstall-plugins">

432 Удаление плагинов492 Удаление плагинов

433</h3>493</h3>

434 494

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

436 496

437Расширение спрашивает в двух случаях:497Расширение сначала задаёт вопрос в двух случаях:

438 498

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

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

441 501

442<h3 id="share-a-plugin-install-link">502<h3 id="share-a-plugin-install-link">

443 Поделиться ссылкой на установку плагина503 Отправка ссылки на установку плагина

444</h3>504</h3>

445 505

446Чтобы отправить кому-то прямую ссылку на установку конкретного плагина, дайте им URL `install-plugin` расширения. При открытии он запускает или фокусирует VS Code, открывает панель Claude Code и открывает диалоговое окно **Управление плагинами** с выбором области этого плагина. Ничего не устанавливается, пока пользователь не выберет область. Если маркетплейс плагина еще не настроен в Claude Code, диалоговое окно сначала попросит его добавить.506Чтобы сразу направить кого-либо к установке определённого плагина, отправьте ему URL расширения `install-plugin`. При открытии ссылки запускается или выводится на передний план VS Code, открывается панель Claude Code и диалоговое окно **Manage plugins** на выборе области действия для этого плагина. Ничего не устанавливается, пока человек не выберет область действия. Если маркетплейс плагина ещё не настроен в его Claude Code, диалоговое окно сначала предложит его добавить.

447 507

448```text theme={null}508```text theme={null}

449vscode://anthropic.claude-code/install-plugin?plugin=code-review&marketplace=anthropics/claude-plugins-official509vscode://anthropic.claude-code/install-plugin?plugin=code-review&marketplace=anthropics/claude-plugins-official

453 513

454| Параметр | Описание |514| Параметр | Описание |

455| - | - |515| - | - |

457| `marketplace` | [Источник](/docs/ru/plugins/install#add-a-marketplace) маркетплейса: репозиторий GitHub `owner/repo`, URL `https://` или git SSH-адрес, например `git@github.com:owner/repo.git`. По умолчанию используется `anthropics/claude-plugins-official`, если не указано. |517| `marketplace` | [Источник](/docs/ru/plugins/install#add-a-marketplace) маркетплейса: `owner/repo` на GitHub, URL `https://` или SSH-адрес git, например `git@github.com:owner/repo.git`. Если не указан, по умолчанию используется `anthropics/claude-plugins-official`. |

458 518

459Расширение проверяет оба значения, прежде чем что-либо открыть:519Расширение проверяет оба значения, прежде чем что-либо открыть:

460 520

461* **Имя плагина**: не более 100 символов, начинается с буквы ASCII или цифры, а в остальном содержит только буквы ASCII, цифры, `.`, `_` и `-`.521* **Имя плагина**: не более 100 символов, начинается с ASCII-буквы или цифры и в остальном содержит только ASCII-буквы, цифры, `.`, `_` и `-`.

462* **Источник маркетплейса**: только формы, перечисленные для параметра `marketplace`, то есть не локальный путь, не адрес `http://` и не имя маркетплейса, например `claude-plugins-official`. URL `https://` не может содержать имя пользователя, пароль или строку запроса.522* **Источник маркетплейса**: только формы, перечисленные для параметра `marketplace`, то есть не локальный путь, не адрес `http://` и не имя маркетплейса, например `claude-plugins-official`. URL `https://` не может содержать имя пользователя, пароль или строку запроса.

463* **Git ref**: чтобы закрепить маркетплейс за веткой или тегом, добавьте ref к источнику после `%23` — закодированной формы `#`, например `marketplace=owner/repo%23v1.0`. Ссылка с незакодированным `#` не сработает. Маркетплейсы в организации GitHub `anthropics` нельзя закрепить в ссылке.523* **Git-ссылка (ref)**: чтобы закрепить маркетплейс за веткой или тегом, добавьте ref к источнику после `%23` — закодированной формы `#`, например `marketplace=owner/repo%23v1.0`. Ссылка с незакодированным `#` не сработает. Маркетплейсы в организации GitHub `anthropics` нельзя закрепить в ссылке.

464 524

465Пользователь, открывший ссылку, нарушающую эти правила, увидит ошибку, начинающуюся с `Invalid plugin installation URL`. Панель Claude Code и диалоговое окно не открываются, и ничего не устанавливается. Если имя вашего плагина или маркетплейс нельзя поместить в ссылку, попросите пользователей добавить маркетплейс на вкладке **Маркетплейсы**, а затем установить плагин с вкладки **Плагины**.525Тот, кто откроет ссылку, нарушающую эти правила, увидит ошибку, начинающуюся с `Invalid plugin installation URL`. Панель Claude Code и диалоговое окно не открываются, и ничего не устанавливается. Если имя вашего плагина или маркетплейс нельзя поместить в ссылку, попросите пользователей добавить маркетплейс на вкладке **Marketplaces**, а затем установить плагин на вкладке **Plugins**.

466 526

467Следующие случаи заканчиваются сообщением в диалоговом окне вместо выбора области действия:527В следующих случаях вместо выбора области действия в диалоговом окне отображается сообщение:

468 528

469* **Маркетплейс не содержит плагин с таким названием**: диалоговое окно сообщает, что плагин не найден. Проверьте значение `plugin` в списке маркетплейса.529* **В маркетплейсе нет плагина с таким именем**: диалоговое окно сообщает, что плагин не найден. Сверьте значение `plugin` со списком маркетплейса.

470* **Плагин уже установлен**: диалоговое окно это указывает, и ничего не меняется.530* **Плагин уже установлен**: диалоговое окно сообщает об этом, и ничего не меняется.

471* **Уже добавлен другой маркетплейс с таким же именем**: диалоговое окно сообщает, что маркетплейс из ссылки не был добавлен, и ничего не устанавливается.531* **Уже добавлен другой маркетплейс с тем же именем**: диалоговое окно сообщает, что маркетплейс из ссылки не был добавлен, и ничего не устанавливается.

472 532

473README на GitHub, проблемы и некоторые другие хосты Markdown удаляют ссылки, схема которых не `http` или `https`, поэтому ссылка `vscode://` там отображается как простой текст. Поместите URL в блок кода на этих хостах, как описано в разделе [Ссылка отображается как простой текст вместо того, чтобы быть кликабельной](/docs/ru/deep-links#the-link-renders-as-plain-text-instead-of-being-clickable) для ссылок `claude-cli://`.533README и issues на GitHub, а также некоторые другие платформы для markdown удаляют ссылки, схема которых не `http` или `https`, поэтому ссылка `vscode://` там отображается как обычный текст. На таких платформах помещайте URL в блок кода, как описано в разделе [Ссылка отображается как обычный текст, а не как кликабельная](/docs/ru/deep-links#the-link-renders-as-plain-text-instead-of-being-clickable) для ссылок `claude-cli://`.

474 534

475<h3 id="manage-marketplaces">535<h3 id="manage-marketplaces">

476 Управление маркетплейсами536 Управление маркетплейсами

477</h3>537</h3>

478 538

479Перейдите на вкладку **Маркетплейсы**, чтобы добавить или удалить источники плагинов:539Перейдите на вкладку **Marketplaces**, чтобы добавить или удалить источники плагинов:

480 540

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

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

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

484 544

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

486 546

487Если сеанс, из которого вы открыли диалоговое окно, не может перезагрузить свои плагины, диалоговое окно предлагает повторить попытку или перезагрузить Claude в этом сеансе.547Если сессия, из которой вы открыли диалоговое окно, не может перезагрузить свои плагины, диалоговое окно предлагает повторить попытку или перезапустить Claude в этой сессии.

488 548

489<Note>549<Note>

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

491</Note>551</Note>

492 552

493Дополнительную информацию о системе плагинов см. в разделах [Плагины](/docs/ru/plugins/overview) и [Маркетплейсы плагинов](/docs/ru/plugins/overview).553Подробнее о системе плагинов см. в разделах [Плагины](/docs/ru/plugins/overview) и [Маркетплейсы плагинов](/docs/ru/plugins/overview).

494 554

495<h3 id="plugins-that-draw-in-the-panel">555<h3 id="plugins-that-draw-in-the-panel">

496 Плагины, которые рисуют в панели556 Плагины, которые отображают содержимое в панели

497</h3>557</h3>

498 558

499Плагин, содержащий [мод](/docs/ru/plugins/mods/overview), может рисовать в панели чата. Для рисования требуется расширение версии 2.1.299 или новее и сессия, которая [получает флаги функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching). От такого плагина вы можете увидеть:559Плагин, содержащий [мод](/docs/ru/plugins/mods/overview), может отображать содержимое в панели чата. Для этого требуется расширение версии 2.1.299 или новее и сессия, которая [получает флаги функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching). От такого плагина вы можете увидеть:

500 560

501* Панель рядом с диалогом или над полем промпта561* Панель рядом с диалогом или над полем промпта

502* Всплывающее уведомление или строку состояния над полем промпта562* Всплывающее уведомление или строку состояния над полем промпта

503* Сообщение или вызов инструмента, отрисованные собственным способом плагина563* Сообщение или вызов инструмента, отображённые собственным способом плагина

504 564

505Когда установленный вами плагин добавляет или изменяет что-либо в панели, метка называет его, например такими фразами:565Когда установленный вами плагин добавляет или изменяет что-либо в панели, это обозначается меткой с формулировками, например такими:

506 566

507* **Из плагина token-chart**: плагин нарисовал или вывел это, либо эта карточка — это плагин, который что-то у вас спрашивает567* **From the token-chart plugin**: плагин отобразил или вывел это, либо эта карточка — вопрос плагина к вам

508* **Изменено плагином token-chart**: плагин изменил что-то, что рисует Claude Code, например вызов инструмента568* **Edited by the token-chart plugin**: плагин изменил что-то, что отображает Claude Code, например вызов инструмента

509* **Промпт от плагина token-chart**: плагин отправил это сообщение от вашего имени569* **Prompt from the token-chart plugin**: плагин отправил это сообщение от вашего имени

510 570

511Чтобы запретить плагину рисовать, отключите плагин в [диалоговом окне плагинов](#install-plugins).571Чтобы запретить плагину отображать содержимое, отключите плагин в [диалоговом окне плагинов](#install-plugins).

512 572

513<h2 id="automate-browser-tasks-with-chrome">573<h2 id="automate-browser-tasks-with-chrome">

514 Автоматизация задач браузера с помощью Chrome574 Автоматизация задач в браузере с помощью Chrome

515</h2>575</h2>

516 576

517Подключите Claude к вашему браузеру Chrome для тестирования веб-приложений, отладки с помощью логов консоли и автоматизации рабочих процессов браузера, не покидая VS Code. Это требует расширение [Claude in Chrome extension](https://chromewebstore.google.com/detail/claude/fcoeoabgfenejglbffodgkkbkcdhcgfn) версии 1.0.36 или выше.577Подключите Claude к браузеру Chrome, чтобы тестировать веб-приложения, выполнять отладку с помощью логов консоли и автоматизировать рабочие процессы в браузере, не покидая VS Code. Для этого требуется [расширение Claude in Chrome](https://chromewebstore.google.com/detail/claude/fcoeoabgfenejglbffodgkkbkcdhcgfn) версии 1.0.36 или новее.

518 578

519Введите `@browser` в поле промпта, а затем то, что вы хотите, чтобы Claude сделал:579Введите `@browser` в поле промпта, а затем опишите, что должен сделать Claude:

520 580

521```text wrap theme={null}581```text wrap theme={null}

522@browser go to localhost:3000 and check the console for errors582@browser go to localhost:3000 and check the console for errors

523```583```

524 584

525Вы также можете открыть меню вложений, чтобы выбрать конкретные инструменты браузера, такие как открытие новой вкладки или чтение содержимого страницы.585Вы также можете открыть меню вложений, чтобы выбрать конкретные инструменты браузера, например открытие новой вкладки или чтение содержимого страницы.

586

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

526 588

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

528 590

529Чтобы каждая сессия подключалась к вашему браузеру при запуске без ввода `@browser`, см. раздел [Включение Chrome по умолчанию](/docs/ru/chrome#enable-chrome-by-default). О том, когда Claude Code запрашивает у вас подтверждение перед действием в браузере, см. раздел [Запросы разрешений в сессиях VS Code](/docs/ru/chrome#permission-prompts-in-vs-code-sessions).591* [Включение Chrome по умолчанию](/docs/ru/chrome#enable-chrome-by-default): каждая сессия будет подключаться к вашему браузеру при запуске без ввода `@browser`

592* [Запросы разрешений в сессиях VS Code](/docs/ru/chrome#permission-prompts-in-vs-code-sessions): когда Claude Code спрашивает вас перед действием в браузере

593* [Использование Claude Code с Chrome](/docs/ru/chrome): инструкции по настройке, полный список возможностей и устранение неполадок

530 594

531Инструкции по настройке, полный список возможностей и устранение неполадок см. в разделе [Use Claude Code with Chrome](/docs/ru/chrome).595<h2 id="work-with-git">

596 Работа с git

597</h2>

598

599Claude Code интегрируется с git для помощи в рабочих процессах контроля версий прямо в VS Code. Попросите Claude совершить коммиты, создать pull request'ы или работать между ветками. Чтобы запустить Claude в изолированном worktree с собственными файлами и веткой, см. [Запуск параллельных сеансов с worktrees](/docs/ru/worktrees).

600

601<h3 id="create-commits-and-pull-requests">

602 Создание коммитов и pull request'ов

603</h3>

604

605Claude может подготавливать изменения, писать сообщения коммитов и создавать pull request'ы на основе вашей работы:

606

607```text wrap theme={null}

608commit my changes with a descriptive message

609create a pr for this feature

610summarize the changes I've made to the auth module

611```

612

613При создании pull request'ов Claude генерирует описания на основе фактических изменений кода и может добавлять контекст о тестировании или решениях по реализации.

614

615<h2 id="run-work-in-the-background">

616 Выполнение работы в фоновом режиме

617</h2>

618

619Отправьте длительную команду или субагента в фоновый режим, а затем проверяйте их состояние из поля ввода промпта.

620

621<h3 id="move-a-running-command-or-subagent-to-the-background">

622 Перевод выполняющейся команды или субагента в фоновый режим

623</h3>

624

625Когда команда или [субагент](/docs/ru/sub-agents) заставляет Claude ждать дольше, чем вам хотелось бы, нажмите **Run in background** под соответствующим вызовом инструмента в диалоге. Требуется Claude Code v2.1.287 или новее.

626

627* **Когда появляется**: действие становится доступным, когда команда выполняется около двух секунд, или сразу после запуска субагента.

628* **После нажатия**: Claude перестаёт ждать и продолжает ход. Команда или субагент продолжают работать как [фоновая задача](/docs/ru/tools-reference#background-commands), которая уведомит Claude о завершении.

629

630Чтобы тем временем проверить состояние задачи или остановить её, введите `/tasks` в поле ввода промпта, чтобы открыть [карту агентов](#use-the-prompt-box). Субагент сохраняет своё место в дереве агентов, а команда отображается под агентами с [последним выводом на её карточке](#monitor-background-processes).

631

632<h3 id="monitor-background-processes">

633 Отслеживание фоновых процессов

634</h3>

635

636Введите `/tasks` в поле ввода промпта, чтобы открыть [карту агентов](#use-the-prompt-box), где перечислены фоновые задачи сессии, например dev-сервер, который Claude оставил работать как фоновую shell-команду. Нажмите на задачу, чтобы открыть её карточку, где её можно остановить. Требуется Claude Code v2.1.277 или новее.

637

638Для фоновой shell-команды или [монитора](/docs/ru/tools-reference#monitor-tool), который запускает команду, карточка также показывает последний вывод команды и обновляет его, пока команда выполняется.

532 639

533<h2 id="vs-code-commands-and-shortcuts">640<h2 id="vs-code-commands-and-shortcuts">

534 Команды и сочетания клавиш VS Code641 Команды и сочетания клавиш VS Code

535</h2>642</h2>

536 643

537Откройте палитру команд (`Cmd+Shift+P` на Mac или `Ctrl+Shift+P` на Windows/Linux) и введите "Claude Code", чтобы увидеть все доступные команды VS Code для расширения Claude Code.644Чтобы открыть палитру команд, нажмите `Cmd+Shift+P` на Mac или `Ctrl+Shift+P` на Windows/Linux. Введите там «Claude Code», чтобы увидеть все доступные команды VS Code для расширения Claude Code.

538 645

539Некоторые сочетания клавиш зависят от того, какая панель находится в "фокусе" (получает ввод с клавиатуры). Когда ваш курсор находится в файле кода, редактор находится в фокусе. Когда ваш курсор находится в поле подсказки Claude, Claude находится в фокусе. Используйте `Cmd+Esc` / `Ctrl+Esc` для переключения между ними.646Некоторые сочетания клавиш зависят от того, какая панель находится «в фокусе» (получает ввод с клавиатуры). Когда курсор находится в файле с кодом, в фокусе редактор. Когда курсор находится в поле ввода промпта Claude, в фокусе Claude. Используйте `Cmd+Esc` / `Ctrl+Esc` для переключения между ними.

540 647

541<Note>648<Note>

542 Это команды VS Code для управления расширением. Не все встроенные команды Claude Code доступны в расширении. Подробнее см. в разделе [VS Code extension vs. Claude Code CLI](#vs-code-extension-vs-claude-code-cli).649 Это команды VS Code для управления расширением. Не все встроенные команды Claude Code доступны в расширении. Подробнее см. в разделе [Расширение VS Code и Claude Code CLI](#vs-code-extension-vs-claude-code-cli).

543</Note>650</Note>

544 651

546| - | - | - |653| - | - | - |

548| Focus last message | - | Переместить фокус клавиатуры на самое новое сообщение в разговоре или на ожидающий запрос разрешения, чтобы вы могли читать оттуда с помощью клавиатуры или программы чтения с экрана. Недоступно в [режиме терминала](#switch-to-terminal-mode). Требует Claude Code v2.1.268 или позже |655| Focus last message | - | Переместить фокус клавиатуры на самое новое сообщение в диалоге или на ожидающий запрос разрешения, чтобы читать оттуда с помощью клавиатуры или программы чтения с экрана. Недоступно в [режиме терминала](#switch-to-terminal-mode). Требуется Claude Code v2.1.268 или новее |

549| Open in Side Bar | - | Открыть Claude на боковой панели |656| Open in Side Bar | - | Открыть Claude на боковой панели |

550| Open in Terminal | - | Открыть Claude в режиме терминала |657| Open in Terminal | - | Открыть Claude в режиме терминала |

552| Open in New Window | - | Открыть новый разговор в отдельном окне |659| Open in New Window | - | Открыть новый диалог в отдельном окне |

553| New Conversation | `Cmd+N` (Mac) / `Ctrl+N` (Windows/Linux) | Начать новый разговор. Требует, чтобы Claude был в фокусе и `enableNewConversationShortcut` был установлен на `true` |660| New Conversation | `Cmd+N` (Mac) / `Ctrl+N` (Windows/Linux) | Начать новый диалог. Требуется, чтобы Claude был в фокусе, а `enableNewConversationShortcut` имел значение `true` |

554| Reopen Closed Session | `Cmd+Shift+T` (Mac) / `Ctrl+Shift+T` (Windows/Linux) | Повторно открыть самую недавно закрытую вкладку сеанса Claude. Переходит к обычному переоткрытию закрытого редактора VS Code, если последняя закрытая вкладка не была сеансом Claude. Отключить с помощью `enableReopenClosedSessionShortcut` |661| Reopen Closed Session | `Cmd+Shift+T` (Mac) / `Ctrl+Shift+T` (Windows/Linux) | Повторно открыть последнюю закрытую вкладку сессии Claude. Если последняя закрытая вкладка не была сессией Claude, выполняется стандартное повторное открытие закрытого редактора VS Code. Отключается с помощью `enableReopenClosedSessionShortcut` |

556| Accept Change at Cursor | - | Принять изменение в позиции курсора при [проверке предложенного редактирования](#get-started) одно изменение за раз. Требует Claude Code v2.1.275 или позже |663| Accept Change at Cursor | - | Принять изменение в позиции курсора при [просмотре предложенной правки](#get-started) по одному изменению за раз. Требуется Claude Code v2.1.275 или новее |

557| Reject Change at Cursor | - | Отменить изменение в позиции курсора при проверке предложенного редактирования одно изменение за раз. Требует Claude Code v2.1.275 или позже |664| Reject Change at Cursor | - | Отменить изменение в позиции курсора при просмотре предложенной правки по одному изменению за раз. Требуется Claude Code v2.1.275 или новее |

558| Toggle Focus view | `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux) | Скрыть или показать активность инструментов в разговоре. Работает, когда видна панель Claude или боковая панель. Требует Claude Code v2.1.221 или позже |665| Toggle Focus view | `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux) | Скрыть или показать активность инструментов в диалоге. Работает, когда видна панель или боковая панель Claude. Требуется Claude Code v2.1.221 или новее |

559| Rename Session Tab | - | Переименовать сеанс на активной вкладке Claude. Требует Claude Code v2.1.257 или позже |666| Rename Session Tab | - | Переименовать сессию в активной вкладке Claude. Требуется Claude Code v2.1.257 или новее |

560| Add Session Tab to Group | - | Добавить сеанс на активной вкладке Claude в [группу сеансов](#organize-sessions-into-groups), которую вы выберете или создадите. Требует Claude Code v2.1.257 или позже |667| Add Session Tab to Group | - | Добавить сессию из активной вкладки Claude в [группу сессий](#organize-sessions-into-groups), которую вы выберете или создадите. Требуется Claude Code v2.1.257 или новее |

561| Mark Session as Unread | - | Отметить сеанс на активной вкладке Claude как непрочитанный в списке сеансов. Требует Claude Code v2.1.257 или позже |668| Mark Session as Unread | - | Отметить сессию в активной вкладке Claude как непрочитанную в списке сессий. Требуется Claude Code v2.1.257 или новее |

562| Show Logs | - | Просмотр журналов отладки расширения |669| Show Logs | - | Просмотреть отладочные логи расширения |

563| Logout | - | Выйти из своей учетной записи Anthropic |670| Logout | - | Выйти из учётной записи Anthropic |

564 671

565<h3 id="launch-a-vs-code-tab-from-other-tools">672<h3 id="launch-a-vs-code-tab-from-other-tools">

566 Запуск вкладки VS Code из других инструментов673 Запуск вкладки VS Code из других инструментов

567</h3>674</h3>

568 675

569Расширение регистрирует обработчик URI по адресу `vscode://anthropic.claude-code/open`. Используйте его для открытия новой вкладки Claude Code из вашего собственного инструмента: псевдонима оболочки, букмарклета браузера или любого скрипта, который может открыть URL. Если VS Code еще не запущен, открытие URL сначала запускает его. Если VS Code уже запущен, URL открывается в окне, которое в данный момент находится в фокусе.676Расширение регистрирует обработчик URI по адресу `vscode://anthropic.claude-code/open`. Используйте его, чтобы открыть новую вкладку Claude Code из собственных инструментов: псевдонима оболочки, букмарклета браузера или любого скрипта, который может открыть URL. Если VS Code ещё не запущен, открытие URL сначала запустит его. Если VS Code уже запущен, URL откроется в том окне, которое сейчас находится в фокусе.

570 677

571Вызовите обработчик с помощью открывателя URL вашей операционной системы.678Вызовите обработчик с помощью средства открытия URL вашей операционной системы.

572 679

573<Tabs>680<Tabs>

574 <Tab title="macOS">681 <Tab title="macOS">

582 xdg-open "vscode://anthropic.claude-code/open"689 xdg-open "vscode://anthropic.claude-code/open"

583 ```690 ```

584 691

585 Команда `xdg-open` поступает из пакета `xdg-utils`. Если оболочка сообщает, что она не найдена, см. [xdg-open is not found on Linux](/docs/ru/deep-links#xdg-open-is-not-found-on-linux).692 Команда `xdg-open` входит в пакет `xdg-utils`. Если оболочка сообщает, что команда не найдена, см. раздел [xdg-open не найден в Linux](/docs/ru/deep-links#xdg-open-is-not-found-on-linux).

586 </Tab>693 </Tab>

587 694

588 <Tab title="Windows">695 <Tab title="Windows">

592 Start-Process "vscode://anthropic.claude-code/open"699 Start-Process "vscode://anthropic.claude-code/open"

593 ```700 ```

594 701

595 В `cmd.exe`, `start` рассматривает свой первый аргумент в кавычках как заголовок окна, поэтому передайте пустой заголовок перед URL:702 В `cmd.exe` команда `start` воспринимает первый аргумент в кавычках как заголовок окна, поэтому передайте пустой заголовок перед URL:

596 703

597 ```cmd theme={null}704 ```cmd theme={null}

598 start "" "vscode://anthropic.claude-code/open"705 start "" "vscode://anthropic.claude-code/open"

604 711

605| Параметр | Описание |712| Параметр | Описание |

606| - | - |713| - | - |

607| `prompt` | Текст для предварительного заполнения в поле подсказки. Должен быть закодирован в URL. Подсказка предварительно заполняется, но не отправляется автоматически. |714| `prompt` | Текст для предварительного заполнения поля ввода промпта. Должен быть закодирован для URL. Промпт подставляется, но не отправляется автоматически. |

608| `session` | Идентификатор сеанса для возобновления вместо начала нового разговора. Сеанс должен принадлежать рабочей области, которая в данный момент открыта в VS Code. Если сеанс не найден, вместо этого начинается новый разговор. Если сеанс уже открыт на вкладке, эта вкладка получает фокус. Чтобы программно захватить идентификатор сеанса, см. [Continue conversations](/docs/ru/headless#continue-conversations). |715| `session` | ID сессии, которую нужно возобновить вместо начала нового диалога. Сессия должна принадлежать рабочей области, открытой в данный момент в VS Code. Если сессия не найдена, вместо неё начинается новый диалог. Если сессия уже открыта во вкладке, фокус переходит на эту вкладку. Чтобы получить ID сессии программно, см. раздел [Продолжение диалогов](/docs/ru/headless#continue-conversations). |

609 716

610Например, чтобы открыть вкладку с предварительным заполнением "review my changes":717Например, чтобы открыть вкладку с предварительно заполненным текстом «review my changes»:

611 718

612```text theme={null}719```text theme={null}

613vscode://anthropic.claude-code/open?prompt=review%20my%20changes720vscode://anthropic.claude-code/open?prompt=review%20my%20changes

614```721```

615 722

616Расширение также обрабатывает `vscode://anthropic.claude-code/install-plugin`, который [открывает диалог плагина на одном плагине](#share-a-plugin-install-link). Чтобы запустить сеанс терминала вместо вкладки VS Code, используйте обработчик `claude-cli://` CLI. См. [Launch sessions from links](/docs/ru/deep-links).723Расширение также обрабатывает `vscode://anthropic.claude-code/install-plugin`, который [открывает диалоговое окно плагинов для одного плагина](#share-a-plugin-install-link). Чтобы запустить сессию в терминале вместо вкладки VS Code, используйте обработчик `claude-cli://` из CLI. См. раздел [Запуск сессий по ссылкам](/docs/ru/deep-links).

617 724

618<h2 id="configure-settings">725<h2 id="configure-settings">

619 Настройка параметров726 Настройка параметров

620</h2>727</h2>

621 728

622Расширение имеет два типа параметров:729Расширение настраивается в двух местах: в настройках расширения VS Code и в файле настроек Claude Code:

623 730

624* **Параметры расширения** в VS Code: управляют поведением расширения в VS Code. Откройте с помощью `Cmd+,` (Mac) или `Ctrl+,` (Windows/Linux), затем перейдите в Extensions → Claude Code. Вы также можете ввести `/` и выбрать **General config…** для открытия параметров.731* **Настройки расширения** в VS Code: управляют поведением расширения внутри VS Code. Откройте их с помощью `Cmd+,` (Mac) или `Ctrl+,` (Windows/Linux), затем перейдите в **Extensions > Claude Code**. Также можно ввести `/` и выбрать **General config…**, чтобы открыть настройки.

625* **Параметры Claude Code** в `~/.claude/settings.json`: общие для расширения и CLI. Используйте для разрешённых команд, переменных окружения, hooks и MCP серверов. С Claude Code v2.1.283 или позже это также один из входных параметров режима разрешений, с которого начинаются беседы, а в более ранних версиях только на планах Pro, Max и Team. [Switch permission modes](/docs/ru/permission-modes#switch-permission-modes) указывает порядок. Подробнее см. [Settings](/docs/ru/settings).732* **Настройки Claude Code** в `~/.claude/settings.json`: общие для расширения и CLI. Используйте их для разрешённых команд, переменных окружения, хуков и MCP-серверов. В Claude Code v2.1.283 и более поздних версиях они также являются одним из факторов, определяющих режим разрешений, в котором начинаются диалоги, а в более ранних версиях — только в планах Pro, Max и Team. Порядок приведён в разделе [Переключение режимов разрешений](/docs/ru/permission-modes#switch-permission-modes). Подробнее см. в разделе [Настройки](/docs/ru/settings).

626 733

627<Tip>734<Tip>

628 Добавьте `"$schema": "https://json.schemastore.org/claude-code-settings.json"` в ваш `settings.json`, чтобы получить автодополнение и встроенную проверку для всех доступных параметров прямо в VS Code.735 Добавьте `"$schema": "https://json.schemastore.org/claude-code-settings.json"` в ваш `settings.json`, чтобы получить автодополнение и встроенную валидацию всех доступных настроек прямо в VS Code.

629</Tip>736</Tip>

630 737

631<h3 id="extension-settings">738<h3 id="extension-settings">

632 Параметры расширения739 Настройки расширения

633</h3>740</h3>

634 741

635VS Code читает `initialPermissionMode` из ваших пользовательских параметров и игнорирует значения рабочей области. До версии 2.1.225 VS Code по умолчанию устанавливал параметр на `default` и применял значения рабочей области.742VS Code считывает `initialPermissionMode` из ваших пользовательских настроек и игнорирует значения рабочей области. До v2.1.225 VS Code по умолчанию устанавливал для этой настройки значение `default` и применял значения рабочей области.

636 743

638| - | - | - |745| - | - | - |

640| `initialPermissionMode` | - | Управляет запросами одобрения для новых бесед: `default`, `plan`, `acceptEdits` или `bypassPermissions`. `manual` является псевдонимом для `default` и выбирает режим, обозначенный как **Manual** в индикаторе режима. Если оставить его неустановленным, расширение выбирает начальный режим разрешений, как описано в [Switch permission modes](/docs/ru/permission-modes#switch-permission-modes). |747| `initialPermissionMode` | - | Управляет запросами подтверждения для новых диалогов: `default`, `plan`, `acceptEdits` или `bypassPermissions`. `manual` — псевдоним для `default`, он выбирает режим с меткой **Manual** в индикаторе режима. Если настройка не задана, расширение выбирает начальный режим разрешений так, как описано в разделе [Переключение режимов разрешений](/docs/ru/permission-modes#switch-permission-modes). |

642| `lockEditorGroups` | `true` | [Заблокировать группы редактора, которые Claude запускает для своих вкладок](#choose-where-claude-lives), чтобы файлы, которые вы открываете, когда вкладка Claude сфокусирована, переходили в другую группу. Когда отключено, расширение никогда не блокирует группу редактора. Требуется Claude Code v2.1.274 или позже |749| `lockEditorGroups` | `true` | [Блокировать группы редактора, которые Claude создаёт для своих вкладок](#choose-where-claude-lives), чтобы файлы, открываемые, когда в фокусе вкладка Claude, попадали в другую группу. Если отключено, расширение никогда не блокирует группу редактора. Требуется Claude Code v2.1.274 или более поздней версии |

644| `attachOpenFile` | `true` | Добавить файл, открытый в редакторе, к вашим сообщениям и показать его в поле подсказки. Когда отключено, добавляется только выбранный текст. Требуется Claude Code v2.1.271 или позже |751| `attachOpenFile` | `true` | Добавлять файл, открытый в редакторе, к вашим сообщениям и показывать его в поле ввода промпта. Если отключено, добавляется только выделенный текст. Требуется Claude Code v2.1.271 или более поздней версии |

646| `scrollToBottomOnSend` | `true` | Прокручивать беседу в конец при отправке сообщения. Когда отключено, беседа остаётся там, где вы её оставили. Требуется Claude Code v2.1.275 или позже |753| `scrollToBottomOnSend` | `true` | Прокручивать диалог вниз при отправке сообщения. Если отключено, диалог остаётся там, где вы его оставили. Требуется Claude Code v2.1.275 или более поздней версии |

647| `showMessageTimestamps` | `true` | Показывать, когда было отправлено каждое сообщение. Строка с датой отмечает место смены дня. Требуется Claude Code v2.1.284 или позже. До версии 2.1.290 значением по умолчанию было `false` |754| `showMessageTimestamps` | `true` | Показывать, когда было отправлено каждое сообщение. Строка с датой отмечает место, где меняется день. Требуется Claude Code v2.1.284 или более поздней версии. До v2.1.290 значение по умолчанию было `false` |

648| `spinnerVerbs` | `{"mode": "append", "verbs": []}` | Задать глаголы, которые поочерёдно показывает индикатор выполнения в диалоге во время хода, с теми же полями `mode` и `verbs`, что и у параметра CLI [`spinnerVerbs`](/docs/ru/settings-reference#spinnerverbs). |755| `spinnerVerbs` | `{"mode": "append", "verbs": []}` | Задаёт глаголы, которые поочерёдно отображает индикатор выполнения диалога во время хода, с теми же полями `mode` и `verbs`, что и в настройке CLI [`spinnerVerbs`](/docs/ru/settings-reference#spinnerverbs). |

650| `enableReopenClosedSessionShortcut` | `true` | Использовать Cmd/Ctrl+Shift+T для повторного открытия самой недавно закрытой вкладки сеанса Claude. Когда последняя закрытая вкладка не была сеансом Claude, сочетание клавиш запускает обычную команду VS Code для повторного открытия закрытого редактора. |757| `enableReopenClosedSessionShortcut` | `true` | Использовать Cmd/Ctrl+Shift+T для повторного открытия последней закрытой вкладки сессии Claude. Если последняя закрытая вкладка не была сессией Claude, сочетание клавиш выполняет обычную команду VS Code для повторного открытия закрытого редактора. |

651| `archiveInactiveSessions` | `14` | [Архивировать сеанс автоматически](#resume-past-conversations) после этого количества дней без активности: `1`, `2`, `7` или `14`. Установите `0` для отключения. Требуется Claude Code v2.1.265 или позже |758| `archiveInactiveSessions` | `14` | [Автоматически архивировать сессию](#resume-past-conversations) после указанного количества дней без активности: `1`, `2`, `7` или `14`. Установите `0`, чтобы отключить. Требуется Claude Code v2.1.265 или более поздней версии |

652| `continueAfterReload` | `true` | После перезагрузки окна Claude [продолжает шаг, который был прерван](#continue-conversations-after-a-reload), в восстановленной сессии. Требуется Claude Code v2.1.274 или позже |759| `continueAfterReload` | `true` | После перезагрузки окна Claude [продолжает прерванный шаг](#continue-conversations-after-a-reload) в восстановленной сессии. Требуется Claude Code v2.1.274 или более поздней версии |

654| `focusView` | `false` | Скрыть вызовы инструментов, результаты инструментов и мышление за расширяемыми строками, оставляя ваши подсказки и ответы Claude. Последний список дел Claude остаётся видимым; это требует Claude Code v2.1.225 или позже. Вы также можете переключить Focus view из меню команд. Требуется Claude Code v2.1.221 или позже |761| `focusView` | `false` | Скрывать вызовы инструментов, результаты инструментов и размышления за раскрываемыми строками, оставляя ваши промпты и ответы Claude. Последний список задач Claude остаётся видимым; для этого требуется Claude Code v2.1.225 или более поздней версии. Режим Focus view также можно переключать из меню команд. Требуется Claude Code v2.1.221 или более поздней версии |

657| `environmentVariables` | `[]` | Установить переменные окружения для процесса Claude. Используйте параметры Claude Code вместо этого для общей конфигурации. Запись [`CLAUDE_CONFIG_DIR`](/docs/ru/env-vars) применяется только в том случае, если её значение является абсолютным путём; расширение не раскрывает `~` и игнорирует относительное значение. |764| `environmentVariables` | `[]` | Задать переменные окружения для процесса Claude. Для общей конфигурации используйте вместо этого настройки Claude Code. Запись [`CLAUDE_CONFIG_DIR`](/docs/ru/env-vars) применяется только в том случае, если её значение — абсолютный путь; расширение не раскрывает `~` и игнорирует относительное значение. |

660| `claudeProcessWrapper` | - | Исполняемый файл, используемый для запуска процесса Claude. Путь к встроенному двоичному файлу передаётся в качестве аргумента при наличии. Установите это на отдельно установленный двоичный файл `claude`, если сборка расширения не включает его для вашей платформы. |767| `claudeProcessWrapper` | - | Исполняемый файл, используемый для запуска процесса Claude. Путь к встроенному бинарному файлу передаётся как аргумент, если он присутствует. Укажите здесь отдельно установленный бинарный файл `claude`, если сборка расширения не содержит его для вашей платформы. |

768

769<h2 id="use-third-party-providers">

770 Использование сторонних провайдеров

771</h2>

772

773По умолчанию Claude Code подключается напрямую к API Anthropic. Если ваша организация использует Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry для доступа к Claude, настройте расширение на использование вашего провайдера:

774

775<Steps>

776 <Step title="Отключите промпт входа">

777 Откройте [настройку Disable Login Prompt](vscode://settings/claudeCode.disableLoginPrompt) и установите флажок.

778

779 Вы также можете нажать `Cmd+,` на Mac или `Ctrl+,` на Windows/Linux, чтобы открыть настройки VS Code, выполнить поиск по запросу "Claude Code login" и установить флажок **Disable Login Prompt**.

780 </Step>

781

782 <Step title="Настройте провайдера">

783 Следуйте руководству по настройке для вашего провайдера:

784

785 * [Claude Code в Amazon Bedrock](/docs/ru/amazon-bedrock)

786 * [Claude Code в Google Cloud's Agent Platform](/docs/ru/google-vertex-ai)

787 * [Claude Code в Microsoft Foundry](/docs/ru/microsoft-foundry)

788

789 В этих руководствах описана настройка провайдера в `~/.claude/settings.json`, что гарантирует общие настройки для расширения VS Code и CLI.

790 </Step>

791</Steps>

792

793При использовании стороннего провайдера расширение не предоставляет функции, для которых требуется учётная запись claude.ai, например шкалы использования плана, [голосовую диктовку](/docs/ru/voice-dictation) и вкладку Web для [облачных сессий](#resume-cloud-sessions-from-claude-ai). О том, что показывает диалог Account & usage при таких способах входа, см. раздел [Проверка учётной записи и использования](#check-account-and-usage).

794

795Вход в claude.ai, оставшийся от предыдущего выполнения `/login`, не используется: расширение не отправляет его ни с одним запросом.

661 796

662<h2 id="use-a-screen-reader">797<h2 id="use-a-screen-reader">

663 Использование программы чтения с экрана798 Использование программы чтения с экрана

664</h2>799</h2>

665 800

666Панель чата расширения работает с программами чтения с экрана. Вам не нужно ничего включать: расширение объявляет активность разговора для каждого пользователя без визуальных изменений. Это отличается от режима программы чтения с экрана CLI с явным согласием пользователя [screen reader mode](/docs/ru/accessibility), который адаптирует интерфейс терминала.801Панель чата расширения работает с программами чтения с экрана. Вам не нужно ничего включать: расширение озвучивает активность в диалоге для всех пользователей, без каких-либо визуальных изменений. Это не связано с [режимом чтения с экрана](/docs/ru/accessibility) в CLI, который включается вручную и адаптирует интерфейс терминала.

667 802

668Поддержка программы чтения с экрана в панели чата требует Claude Code версии 2.1.236 или более поздней.803Поддержка программ чтения с экрана в панели чата требует Claude Code v2.1.236 или новее.

669 804

670Во время разговора расширение объявляет:805Во время диалога расширение озвучивает:

671 806

672* **Ответы Claude**: расширение объявляет каждый ответ один раз, когда он завершен, и молчит во время потоковой передачи текста. Ваша программа чтения с экрана читает блоки кода как сводку по количеству строк, читает ссылки по их метке и читает таблицы ячейка за ячейкой; полный ответ остается читаемым в стенограмме.807* **Ответы Claude**: расширение озвучивает каждый ответ один раз, когда он завершён, и молчит, пока текст поступает потоком. Программа чтения с экрана зачитывает блоки кода в виде сводки с количеством строк, ссылки — по их подписи, а таблицы — ячейка за ячейкой; полный ответ остаётся доступным для чтения в транскрипте.

673* **Запросы разрешений и вопросы**: расширение объявляет запрос, когда появляется его диалоговое окно разрешения, называя инструмент, который Claude хочет использовать. Оно объявляет таким же образом, когда Claude задает вам вопрос и когда Claude завершает план и ждет вашего рассмотрения.808* **Запросы разрешений и вопросы**: расширение озвучивает запрос, когда появляется запрос разрешения, называя инструмент, который Claude хочет использовать. Аналогичным образом оно сообщает, когда Claude задаёт вам вопрос и когда Claude завершает план и ждёт вашей проверки.

674* **Изменения статуса**: расширение объявляет, когда Claude начинает работать, когда Claude готов к вашему вводу и когда Claude Code начинает сжимать разговор.809* **Изменения статуса**: расширение сообщает, когда Claude начинает работу, когда Claude готов к вашему вводу и когда Claude Code начинает сжатие диалога.

675* **Сообщения в очереди**: когда вы отправляете сообщение, пока Claude работает, расширение объявляет "Message queued." для этого сообщения.810* **Сообщения в очереди**: когда вы отправляете сообщение, пока Claude работает, расширение озвучивает для этого сообщения «Message queued.».

676* **Ошибки и подсказки модели**: расширение объявляет об ошибках в разговоре и объявляет, когда появляется [диалоговое окно согласия на использование кредитов](/docs/ru/model-config#fable-and-usage-credits) или [диалоговое окно помеченного запроса](/docs/ru/model-config#ask-before-switching).811* **Ошибки и запросы, связанные с моделью**: расширение озвучивает ошибки в диалоге, а также сообщает о появлении [запроса согласия на использование кредитов использования](/docs/ru/model-config#fable-and-usage-credits) или [запроса для помеченного запроса](/docs/ru/model-config#ask-before-switching).

677 812

678Пока Claude работает, ваша программа чтения с экрана читает текстовую метку вместо анимации спиннера прогресса.813Пока Claude работает, программа чтения с экрана зачитывает текстовую метку вместо анимации индикатора выполнения.

679 814

680Когда вы повторно открываете сеанс или переключаетесь на другой, расширение ничего не объявляет: восстановленная история, ожидающие запросы разрешений и текущий статус остаются молчаливыми до тех пор, пока не произойдет что-то новое.815Когда вы повторно открываете сессию или переключаетесь на другую, расширение ничего не озвучивает: восстановленная история, ожидающие запросы разрешений и статус выполнения остаются без озвучивания, пока не произойдёт что-то новое.

681 816

682<h3 id="use-the-chat-panel-from-the-keyboard">817<h3 id="use-the-chat-panel-from-the-keyboard">

683 Использование панели чата с клавиатуры818 Использование панели чата с клавиатуры

684</h3>819</h3>

685 820

686Каждый ход в стенограмме начинается с визуально скрытого заголовка, помеченного подсказкой, которая начала ход, поэтому вы можете переходить между ходами с помощью навигации по заголовкам вашей программы чтения с экрана.821Каждый ход в транскрипте начинается с визуально скрытого заголовка, подписанного промптом, с которого начался этот ход. Используйте навигацию по заголовкам в вашей программе чтения с экрана, чтобы переходить между ходами.

687 822

688В пределах хода ваша программа чтения с экрана объявляет, чье сообщение вы читаете, когда вы перемещаетесь по нему:823Внутри хода программа чтения с экрана по мере перемещения сообщает, чьё сообщение перед вами:

689 824

690* **Ваши сообщения**: "Вы"825* **Ваши сообщения**: «You»

691* **Сообщения Claude**: "Claude"826* **Сообщения Claude**: «Claude»

692* **Шаги инструмента**: "Claude" плюс имя инструмента, например "Claude, Bash"827* **Шаги инструментов**: «Claude» плюс название инструмента, например «Claude, Bash»

693* **Блоки размышления**: "Claude, thinking"828* **Блоки размышлений**: «Claude, thinking»

694 829

695Поскольку расширение предоставляет стенограмму как помеченный регион, вы также можете переместить фокус на саму стенограмму с помощью `Tab` и читать ее в своем собственном темпе. Чтобы вместо этого переместить фокус на последнее сообщение или ожидающий запрос разрешения, запустите **Claude Code: Focus last message** из [Command Palette](#vs-code-commands-and-shortcuts).830Поскольку расширение представляет транскрипт как помеченную область, вы также можете переместить фокус на сам транскрипт с помощью `Tab` и читать его в удобном вам темпе. Чтобы вместо этого переместить фокус на последнее сообщение или ожидающий запрос разрешения, выполните **Claude Code: Focus last message** из [палитры команд](#vs-code-commands-and-shortcuts).

696 831

697Когда опция в диалоговом окне разрешения сохраняет правило разрешения или доступ к каталогу, ее метка заканчивается названием места сохранения одобрения, например "все проекты" или "этот сеанс". Когда опция сфокусирована, нажмите клавишу `Left` или `Right` для изменения назначения, и расширение объявляет каждое назначение по мере того, как вы на него переходите. Вы также можете щелкнуть на назначение в метке. Клавиши со стрелками требуют Claude Code версии 2.1.268 или более поздней.832Когда вариант в запросе разрешения сохраняет правило разрешений или доступ к каталогу, его подпись заканчивается указанием места сохранения подтверждения, например «all projects» или «this session». Чтобы изменить место сохранения:

833

834* Установив фокус на этом варианте, нажмите клавишу со стрелкой `Left` или `Right`. Расширение озвучивает каждое место сохранения при переходе к нему. Клавиши со стрелками требуют Claude Code v2.1.268 или новее.

835* Щёлкните место сохранения в подписи.

698 836

699<h2 id="vs-code-extension-vs-claude-code-cli">837<h2 id="vs-code-extension-vs-claude-code-cli">

700 Расширение VS Code и Claude Code CLI838 Расширение VS Code и Claude Code CLI

701</h2>839</h2>

702 840

703Claude Code доступен как расширение VS Code (графическая панель), так и как CLI (интерфейс командной строки в терминале). Некоторые функции доступны только в CLI. Если вам нужна функция, доступная только в CLI, запустите `claude` во встроенном терминале VS Code. Это требует [автономной установки CLI](/docs/ru/setup): расширение не добавляет `claude` в ваш PATH. См. [Запуск CLI в VS Code](#run-cli-in-vs-code).841Claude Code доступен как в виде расширения VS Code (графическая панель), так и в виде CLI (интерфейс командной строки в терминале). Некоторые функции доступны только в CLI. Если вам нужна функция, доступная только в CLI, запустите `claude` во встроенном терминале VS Code. Для этого требуется [автономная установка CLI](/docs/ru/setup): расширение не добавляет `claude` в ваш PATH. См. раздел [Запуск CLI в VS Code](#run-cli-in-vs-code).

704 842

705| Функция | CLI | Расширение VS Code |843| Функция | CLI | Расширение VS Code |

706| - | - | - |844| - | - | - |

708| Конфигурация MCP server | Да | Да ([добавление и управление серверами](#connect-to-external-tools-with-mcp) с помощью `/mcp` на панели чата) |846| Настройка MCP-серверов | Да | Да: [добавляйте серверы и управляйте ими](#connect-to-external-tools-with-mcp) с помощью `/mcp` в панели чата |

709| Checkpoints | Да | Да |847| Чекпоинты | Да | Да |

710| Сочетание клавиш `!` Bash | Да | Нет |848| Ярлык `!` для Bash | Да | Нет |

711| Автодополнение Tab | Да | Нет |849| Автодополнение по Tab | Да | Нет |

~~712~~

713<h3 id="rewind-with-checkpoints">

714 Rewind с checkpoints

715</h3>

~~716~~

717Расширение VS Code поддерживает checkpoints, которые отслеживают редактирование файлов Claude и позволяют вернуться к предыдущему состоянию. Наведите указатель мыши на любое сообщение, чтобы открыть кнопку rewind, затем выберите один из трёх вариантов:

~~718~~

719* **Fork conversation from here**: начните новую ветку разговора с этого сообщения, сохраняя все изменения кода

720* **Rewind code to here**: отмените изменения файлов до этой точки в разговоре, сохраняя полную историю разговора

721* **Fork conversation and rewind code**: начните новую ветку разговора и отмените изменения файлов до этой точки

~~722~~

723Полные сведения о том, как работают checkpoints и их ограничения, см. в разделе [Checkpointing](/docs/ru/checkpointing).

724 850

725<h3 id="run-cli-in-vs-code">851<h3 id="run-cli-in-vs-code">

726 Запуск CLI в VS Code852 Запуск CLI в VS Code

727</h3>853</h3>

728 854

729Чтобы использовать CLI, оставаясь в VS Code, откройте встроенный терминал (`` Ctrl+` `` на Windows/Linux или `` Cmd+` `` на Mac) и запустите `claude`. CLI автоматически интегрируется с вашей IDE для функций, таких как просмотр diff и обмен диагностикой.855Чтобы использовать CLI, не выходя из VS Code, нажмите `` Ctrl+` `` в Windows/Linux или `` Cmd+` `` на Mac, чтобы открыть встроенный терминал, а затем выполните `claude`. CLI автоматически интегрируется с вашей IDE для таких функций, как просмотр diff и передача диагностики. Если вы используете внешний терминал, выполните `/ide` внутри Claude Code, чтобы подключить его к VS Code.

~~730~~

731Установка расширения не добавляет `claude` в PATH вашей оболочки. Расширение включает приватную копию CLI для своей панели чата, но ввод `claude` в терминал требует [автономной установки CLI](/docs/ru/setup). Запустите установку один раз, и команды на этой странице, включая `claude mcp add` и `claude --resume`, будут работать в любом терминале. Если `claude` всё ещё не найден после установки, [проверьте ваш PATH](/docs/ru/troubleshoot-install#verify-your-path).

732 856

733Если вы используете внешний терминал, запустите `/ide` внутри Claude Code, чтобы подключить его к VS Code.857Установка расширения не добавляет `claude` в PATH вашей оболочки. Расширение содержит собственную копию CLI для своей панели чата, но для ввода `claude` в терминале требуется [автономная установка CLI](/docs/ru/setup). Выполните установку один раз, и команды на этой странице, включая `claude mcp add` и `claude --resume`, будут работать в любом терминале. Если после установки `claude` по-прежнему не найден, [проверьте ваш PATH](/docs/ru/troubleshoot-install#verify-your-path).

734 858

735<h3 id="switch-between-extension-and-cli">859<h3 id="switch-between-extension-and-cli">

736 Переключение между расширением и CLI860 Переключение между расширением и CLI

737</h3>861</h3>

738 862

739Расширение и CLI используют одну и ту же историю разговоров. Чтобы продолжить разговор расширения в CLI, запустите `claude --resume` в терминале. Это откроет интерактивный выбор, где вы можете найти и выбрать ваш разговор.863Расширение и CLI используют общую историю диалогов. Чтобы продолжить диалог из расширения в CLI, выполните `claude --resume` в терминале. Откроется интерактивное окно выбора, в котором вы можете найти и выбрать нужный диалог.

740 864

741<h3 id="include-terminal-output-in-prompts">865<h2 id="connect-to-external-tools-with-mcp">

742 Включение вывода терминала в подсказки866 Подключение к внешним инструментам с помощью MCP

743</h3>867</h2>

~~744~~

745Ссылайтесь на вывод терминала в ваших подсказках, используя `@terminal:name`, где `name` — это название терминала. Это позволяет Claude видеть вывод команды, сообщения об ошибках или логи без копирования и вставки.

~~746~~

747<h3 id="move-a-running-command-or-subagent-to-the-background">

748 Перемещение выполняющейся команды или субагента в фон

749</h3>

~~750~~

751Когда Claude ожидает команду или [субагента](/docs/ru/sub-agents), которые выполняются дольше, чем вам хотелось бы, нажмите **Run in background** под соответствующим вызовом инструмента в диалоге. Это действие появляется, когда команда выполняется около двух секунд, или сразу после запуска субагента. Claude перестаёт ждать и продолжает ход, а команда или субагент продолжают работать как [фоновая задача](/docs/ru/tools-reference#background-commands), которая уведомляет Claude о своём завершении. Требуется Claude Code v2.1.287 или более поздняя версия.

~~752~~

753Чтобы тем временем проверить задачу или остановить её, введите `/tasks` в поле промпта, чтобы открыть [карту агентов](#use-the-prompt-box). Субагент сохраняет там своё место в дереве агентов, а команда отображается под агентами с [последним выводом на её карточке](#monitor-background-processes).

~~754~~

755<h3 id="monitor-background-processes">

756 Мониторинг фоновых процессов

757</h3>

~~758~~

759Введите `/tasks` в поле промпта, чтобы открыть [карту агентов](#use-the-prompt-box), которая отображает фоновые задачи сессии, такие как сервер разработки, который Claude оставил запущенным в качестве фоновой shell-команды. Нажмите на задачу, чтобы открыть её карточку и остановить её там. Требуется Claude Code v2.1.277 или более поздняя версия.

760 868

761Для фоновой shell-команды или [монитора](/docs/ru/tools-reference#monitor-tool), который запускает команду, карточка также показывает последний вывод команды и обновляет его, пока команда выполняется.869MCP-серверы (Model Context Protocol) предоставляют Claude доступ к внешним инструментам, базам данных и API.

762 870

763<h3 id="connect-to-external-tools-with-mcp">871Чтобы управлять MCP-серверами, не выходя из VS Code, введите `/mcp` на панели чата. В открывшемся диалоговом окне вы можете:

764 Подключение к внешним инструментам с помощью MCP

765</h3>

766 872

767MCP (Model Context Protocol) серверы дают Claude доступ к внешним инструментам, базам данных и API.873* Добавлять серверы

874* Удалять серверы, сохранённые в локальной, пользовательской или проектной [области действия](/docs/ru/mcp#mcp-installation-scopes)

875* Включать или отключать серверы

876* Переподключаться к серверу

877* Управлять аутентификацией OAuth

768 878

769Чтобы управлять MCP серверами, не покидая VS Code, введите `/mcp` на панели чата. В открывшемся диалоговом окне вы можете добавлять серверы, удалять серверы, сохранённые в локальной, пользовательской или проектной [области](/docs/ru/mcp#mcp-installation-scopes), включать или отключать серверы, переподключаться к серверу и управлять аутентификацией OAuth. Добавление и удаление серверов в диалоговом окне требует Claude Code v2.1.261 или более поздней версии.879Для добавления и удаления серверов в диалоговом окне требуется Claude Code v2.1.261 или более поздней версии.

770 880

771Вы также можете запустить `claude mcp add` во встроенном терминале VS Code (`` Ctrl+` `` или `` Cmd+` ``). Диалоговое окно и команда терминала сохраняют в одну и ту же конфигурацию MCP, и изменения из любого источника вступают в силу в разговорах, которые вы начинаете впоследствии. Пример ниже добавляет удалённый MCP сервер GitHub, который аутентифицируется с помощью [личного токена доступа](https://github.com/settings/personal-access-tokens), переданного в качестве заголовка:881Вы также можете выполнить `claude mcp add` во встроенном терминале VS Code (`` Ctrl+` `` или `` Cmd+` ``). Диалоговое окно и команда терминала сохраняют данные в одну и ту же конфигурацию MCP, и изменения, внесённые любым из способов, вступают в силу в диалогах, которые вы начнёте после этого. В примере ниже добавляется удалённый MCP-сервер GitHub, который выполняет аутентификацию с помощью [персонального токена доступа](https://github.com/settings/personal-access-tokens), передаваемого в заголовке:

772 882

773```bash theme={null}883```bash theme={null}

774claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \884claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \

775 --header "Authorization: Bearer YOUR_GITHUB_PAT"885 --header "Authorization: Bearer YOUR_GITHUB_PAT"

776```886```

777 887

778Замените `YOUR_GITHUB_PAT` на ваш личный токен доступа. Команда `claude mcp add` сохраняет конфигурацию без проверки учётных данных, поэтому здесь принимается значение-заполнитель, но сервер не подключится позже. Чтобы проверить соединение, начните новый разговор, введите `/mcp` и проверьте, что сервер показывает **Connected**. Сервер с неправильными учётными данными показывает **Failed**.888Замените `YOUR_GITHUB_PAT` своим персональным токеном доступа. Команда `claude mcp add` сохраняет конфигурацию без проверки учётных данных, поэтому значение-заполнитель здесь будет принято, но позже сервер не сможет подключиться. Чтобы проверить подключение, начните новый диалог, введите `/mcp` и убедитесь, что у сервера отображается статус **Connected**. Для сервера с неверными учётными данными отображается **Failed**.

~~779~~

780После настройки попросите Claude использовать инструменты (например, "Review PR #456").

~~781~~

782Чтобы найти серверы для подключения, см. [Find and build MCP servers](/docs/ru/mcp#find-and-build-mcp-servers).

~~783~~

784<h2 id="work-with-git">

785 Работа с git

786</h2>

~~787~~

788Claude Code интегрируется с git для помощи в рабочих процессах контроля версий прямо в VS Code. Попросите Claude совершить коммиты, создать pull request'ы или работать между ветками. Чтобы запустить Claude в изолированном worktree с собственными файлами и веткой, см. [Запуск параллельных сеансов с worktrees](/docs/ru/worktrees).

~~789~~

790<h3 id="create-commits-and-pull-requests">

791 Создание коммитов и pull request'ов

792</h3>

~~793~~

794Claude может подготавливать изменения, писать сообщения коммитов и создавать pull request'ы на основе вашей работы:

~~795~~

796```text wrap theme={null}

797commit my changes with a descriptive message

798create a pr for this feature

799summarize the changes I've made to the auth module

800```

~~801~~

802При создании pull request'ов Claude генерирует описания на основе фактических изменений кода и может добавлять контекст о тестировании или решениях по реализации.

803 889

804<h2 id="use-third-party-providers">890После настройки попросите Claude использовать инструменты (например, «Review PR #456»).

805 Использование сторонних поставщиков

806</h2>

807 891

808По умолчанию Claude Code подключается непосредственно к API Anthropic. Если ваша организация использует Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry для доступа к Claude, настройте расширение на использование вашего поставщика:892<Note>Чтобы найти серверы для подключения, см. раздел [Поиск и создание MCP-серверов](/docs/ru/mcp#find-and-build-mcp-servers).</Note>

~~809~~

810<Steps>

811 <Step title="Отключение запроса входа">

812 Откройте [параметр Disable Login Prompt](vscode://settings/claudeCode.disableLoginPrompt) и установите флажок.

813 893

814 Вы также можете открыть параметры VS Code (`Cmd+,` на Mac или `Ctrl+,` на Windows/Linux), найти "Claude Code login" и установить флажок **Disable Login Prompt**.894<h2 id="the-built-in-ide-mcp-server">

815 </Step>

~~816~~

817 <Step title="Настройка вашего поставщика">

818 Следуйте руководству по настройке для вашего поставщика:

~~819~~

820 * [Claude Code на Amazon Bedrock](/docs/ru/amazon-bedrock)

821 * [Claude Code на Google Cloud's Agent Platform](/docs/ru/google-vertex-ai)

822 * [Claude Code на Microsoft Foundry](/docs/ru/microsoft-foundry)

~~823~~

824 Эти руководства охватывают настройку вашего поставщика в `~/.claude/settings.json`, что обеспечивает совместное использование ваших параметров между расширением VS Code и CLI.

825 </Step>

826</Steps>

~~827~~

828На сторонних поставщиках расширение не предлагает функции, требующие учетной записи claude.ai, такие как отслеживание использования, [голосовой ввод](/docs/ru/voice-dictation) и вкладка Web для [облачных сеансов](#resume-cloud-sessions-from-claude-ai). Для информации о том, что показывает диалог Account & usage при этих входах, см. [Проверка учетной записи и использования](#check-account-and-usage).

~~829~~

830Вход в claude.ai, оставшийся с более ранней версии `/login`, остается неиспользованным: расширение не отправляет его ни с одним запросом.

~~831~~

832<h2 id="security-and-privacy">

833 Безопасность и конфиденциальность

834</h2>

~~835~~

836Ваш код остаётся приватным. Claude Code обрабатывает ваш код для предоставления помощи, но не использует его для обучения моделей. Подробнее о обработке данных и способах отказа от логирования см. [Data and privacy](/docs/ru/data-usage).

~~837~~

838Когда включены разрешения на автоматическое редактирование, Claude Code может изменять файлы конфигурации VS Code (такие как `settings.json` или `tasks.json`), которые VS Code может выполнять автоматически. Чтобы снизить риск при работе с ненадёжным кодом:

~~839~~

840* Включите [VS Code Restricted Mode](https://code.visualstudio.com/docs/editor/workspace-trust#_restricted-mode) для ненадёжных рабочих областей

841* Используйте Manual mode вместо Edit automatically или Auto для редактирования

842* Внимательно проверяйте изменения перед их принятием

~~843~~

844<h3 id="the-built-in-ide-mcp-server">

845 Встроенный MCP-сервер IDE895 Встроенный MCP-сервер IDE

846</h3>896</h2>

847 897

848Когда расширение активно, оно запускает локальный MCP-сервер, к которому CLI подключается автоматически. Именно так CLI открывает diff во встроенном средстве просмотра различий VS Code, читает ваше текущее выделение для упоминаний `@` и — когда вы работаете в записной книжке Jupyter — просит VS Code выполнить ячейки.898Когда расширение активно, оно запускает локальный MCP-сервер, к которому CLI подключается автоматически. Через этот сервер CLI:

849 899

850Сервер называется `ide` и скрыт от `/mcp`, потому что в нём нечего настраивать. Однако если ваша организация использует хук `PreToolUse` для создания списка разрешённых MCP-инструментов, вам нужно знать, что он существует.900* Открывает diff во встроенном средстве просмотра diff в VS Code

901* Считывает ваше текущее выделение для `@`-упоминаний

902* Просит VS Code выполнить ячейки, когда вы работаете в блокноте Jupyter

851 903

852**Выделение и контекст открытого файла.** Во время подключения CLI включает ваше текущее выделение в редакторе и путь активного файла в качестве контекста в каждый отправляемый вами промпт. Когда это происходит, в транскрипте отображается строка `⧉ Selected N lines from <file>`.904Сервер называется `ide` и скрыт из `/mcp`, поскольку в нём нечего настраивать. Однако если ваша организация использует хук `PreToolUse` для ведения списка разрешённых инструментов MCP, вам нужно знать о его существовании.

853 905

854Если вы [поставите сообщение в очередь, пока Claude работает](/docs/ru/interactive-mode#queue-messages-while-claude-works), он сохранит выделение, которое у вас было, когда вы нажали `Enter`, независимо от того, что вы выделите после этого.906**Контекст выделения и открытого файла.** Пока CLI подключён, он включает ваше текущее выделение в редакторе и путь к активному файлу в качестве контекста в каждый отправляемый вами промпт. Когда это происходит, в транскрипте отображается строка `⧉ Selected N lines from <file>`. Следующие случаи изменяют этот контекст:

855 907

856Чтобы исключить конфиденциальный файл, такой как `.env`, добавьте [правило запрета `Read`](/docs/ru/permissions#read-and-edit) для его пути. Соответствующее правило запрета не позволяет ни выделенному тексту, ни уведомлению об открытом файле для этого файла попасть к Claude.908* **Сообщения в очереди**: если вы [ставите сообщение в очередь, пока Claude работает](/docs/ru/interactive-mode#queue-messages-while-claude-works), оно сохраняет выделение, которое было у вас в момент нажатия `Enter`, независимо от того, что вы выделите после этого.

909* **Конфиденциальные файлы**: чтобы исключить конфиденциальный файл, например `.env`, добавьте [запрещающее правило `Read`](/docs/ru/permissions#read-and-edit) для его пути. Соответствующее запрещающее правило не позволяет ни выделенному тексту, ни уведомлению об открытом файле для этого файла попасть к Claude.

910* **Настройка Attach Open File отключена**: если вы отключите [настройку Attach Open File](#extension-settings), CLI получает путь к активному файлу только тогда, когда в нём выделен текст.

857 911

858Если вы отключите [настройку Attach Open File](#extension-settings), CLI получит путь активного файла только при наличии выделенного текста в нём.912**Транспорт и аутентификация.** Сервер привязывается к `127.0.0.1` на случайном порту в диапазоне 10000–65535, и этот порт нельзя настроить. Транспорт и токен аутентификации работают следующим образом:

859 913

860**Транспорт и аутентификация.** Сервер привязывается к `127.0.0.1` на случайном порту в диапазоне 10000–65535, и порт не настраивается. Транспорт — это незашифрованный `ws://`; поскольку сокет доступен только через loopback, любой процесс, который может перехватить трафик, также может прочитать токен из файла блокировки, поэтому TLS не добавит защиты. Каждая активация расширения генерирует новый случайный токен аутентификации, записывает его в файл блокировки `~/.claude/ide/<port>.lock`, и для подключения CLI должен предъявить его в заголовке `X-Claude-Code-Ide-Authorization`. Файл блокировки имеет права доступа `0600` в каталоге с правами `0700`, поэтому только пользователь, запустивший VS Code, может его прочитать. Если установлена переменная `CLAUDE_CONFIG_DIR`, файл блокировки вместо этого записывается в `$CLAUDE_CONFIG_DIR/ide/`.914* **Транспорт**: незашифрованный `ws://`. Поскольку сокет доступен только через loopback, любой процесс, способный перехватить трафик, может также прочитать токен из lock-файла, поэтому TLS не добавил бы защиты.

915* **Токен аутентификации**: при каждой активации расширение генерирует новый случайный токен аутентификации и записывает его в lock-файл `~/.claude/ide/<port>.lock`. Для подключения CLI должен предъявить токен в заголовке `X-Claude-Code-Ide-Authorization`.

916* **Права доступа к lock-файлу**: lock-файл имеет права доступа `0600` в каталоге с правами `0700`, поэтому прочитать его может только пользователь, запустивший VS Code. Если задана переменная `CLAUDE_CONFIG_DIR`, lock-файл вместо этого записывается в `$CLAUDE_CONFIG_DIR/ide/`.

861 917

862**Инструменты, предоставляемые модели.** Сервер размещает дюжину инструментов, но только два видны модели. Остальные — это внутренний RPC, который CLI использует для собственного пользовательского интерфейса, например для открытия diff, чтения выделений и сохранения файлов. Они отфильтровываются до того, как список инструментов попадает к Claude.918**Инструменты, доступные модели.** Сервер предоставляет около дюжины инструментов, но модели видны только два. Остальные — это внутренние RPC, которые CLI использует для собственного интерфейса, например для открытия diff, чтения выделения и сохранения файлов. Они отфильтровываются до того, как список инструментов попадает к Claude.

863 919

865| - | - | - |921| - | - | - |

866| `mcp__ide__getDiagnostics` | Возвращает диагностику языкового сервера: ошибки и предупреждения на панели Problems в VS Code. Опционально ограничено одним файлом. | Да |922| `mcp__ide__getDiagnostics` | Возвращает диагностику языкового сервера: ошибки и предупреждения из панели Problems в VS Code. При необходимости может ограничиваться одним файлом. | Да |

867| `mcp__ide__executeCode` | Запускает код Python в ядре активной записной книжки Jupyter. См. процесс подтверждения ниже. | Нет |923| `mcp__ide__executeCode` | Выполняет код Python в ядре активного блокнота Jupyter. См. процесс подтверждения ниже. | Нет |

868 924

869**Диагностика в панели чата.** В панели чата, начиная с Claude Code v2.1.285, Claude читает панель Problems в VS Code через отдельный встроенный сервер с именем `claude-vscode`. Claude может запросить у него текущие ошибки и предупреждения для одного файла или для всех файлов, по которым у VS Code есть диагностика.925**Диагностика в панели чата.** В панели чата при использовании Claude Code v2.1.285 или более поздней версии Claude считывает панель Problems в VS Code через отдельный встроенный сервер с именем `claude-vscode`. Claude может запросить у него текущие ошибки и предупреждения в одном файле или во всех файлах, для которых у VS Code есть диагностика.

870 926

871Хуки и правила разрешений видят инструмент диагностики панели чата как `mcp__claude-vscode__getDiagnostics`. Чтобы охватить диагностику и в CLI, и в панели чата, укажите в своём хуке или правиле оба имени: `mcp__ide__getDiagnostics` и `mcp__claude-vscode__getDiagnostics`.927Хуки и правила разрешений видят инструмент диагностики панели чата как `mcp__claude-vscode__getDiagnostics`. Чтобы охватить диагностику и в CLI, и в панели чата, укажите в хуке или правиле оба имени: `mcp__ide__getDiagnostics` и `mcp__claude-vscode__getDiagnostics`.

872 928

873Этот пример `settings.json` запрещает оба инструмента:929Этот пример `settings.json` запрещает оба инструмента:

874 930

883}939}

884```940```

885 941

886Правило запрета `Read` не распространяется ни на один из этих инструментов, поэтому блокируйте их по имени с помощью [правила запрета](/docs/ru/permissions#mcp), как в примере.942Запрещающее правило `Read` не распространяется ни на один из этих инструментов, поэтому блокируйте их по имени с помощью [запрещающего правила](/docs/ru/permissions#mcp), как показано в примере.

943

944**Выполнение в Jupyter всегда требует подтверждения.** `mcp__ide__executeCode` не может ничего выполнить незаметно. Каждый вызов проходит следующие шаги:

945

9461. Код вставляется как новая ячейка в конец активного блокнота.

9472. VS Code прокручивает представление к этой ячейке.

9483. Встроенное окно Quick Pick предлагает выбрать **Execute** или **Cancel**.

887 949

888**Выполнение Jupyter всегда сначала запрашивает подтверждение.** `mcp__ide__executeCode` не может ничего запустить молча. При каждом вызове код вставляется как новая ячейка в конце активной записной книжки, VS Code прокручивает к ней, и встроенное окно Quick Pick предлагает вам выбрать **Execute** или **Cancel**. Отмена или закрытие окна выбора с помощью `Esc` возвращает ошибку Claude, и ничего не запускается. Инструмент также сразу отказывает, когда нет активной записной книжки, когда расширение Jupyter (`ms-toolsai.jupyter`) не установлено или когда ядро не является Python.950Отмена или закрытие окна выбора клавишей `Esc` возвращает Claude ошибку, и ничего не выполняется. Инструмент также сразу отказывает в выполнении, если нет активного блокнота, если не установлено расширение Jupyter (`ms-toolsai.jupyter`) или если ядро не Python.

889 951

890<Note>952<Note>

891 Подтверждение Quick Pick не зависит от хуков `PreToolUse`. Запись в списке разрешённых инструментов для `mcp__ide__executeCode` позволяет Claude *предложить* запуск ячейки; а Quick Pick внутри VS Code — это то, что позволяет ей *фактически* запуститься.953 Подтверждение через Quick Pick не связано с хуками `PreToolUse`. Запись в списке разрешённых для `mcp__ide__executeCode` позволяет Claude *предложить* выполнить ячейку; а *фактически* выполнить её позволяет именно Quick Pick внутри VS Code.

892</Note>954</Note>

893 955

894<a id="troubleshooting" />956<a id="troubleshooting" />

895 957

896<h2 id="fix-common-issues">958<h2 id="fix-common-issues">

897 Решение распространённых проблем959 Устранение распространённых проблем

898</h2>960</h2>

899 961

900Ошибкам входа, сети и запуска посвящены отдельные разделы на страницах устранения неполадок установки и справочника ошибок. Найдите в таблице то, что вы видите, и перейдите по ссылке.962Ошибкам входа, сети и запуска посвящены отдельные разделы на страницах устранения неполадок установки и справочника ошибок. Найдите в таблице то, что вы видите, и перейдите по ссылке.

901 963

902| Что вы видите | Куда перейти |964| Что вы видите | Куда перейти |

903| - | - |965| - | - |

904| `API Error: 403 Request not allowed` после входа в систему | [403 Forbidden после входа в систему](/docs/ru/troubleshoot-install#403-forbidden-after-login) |966| `API Error: 403 Request not allowed` после входа | [403 Forbidden после входа](/docs/ru/troubleshoot-install#403-forbidden-after-login) |

905| Вас просят войти снова, хотя вы уже вошли в систему | [Не выполнен вход или истёк срок действия токена](/docs/ru/troubleshoot-install#not-logged-in-or-token-expired) |967| Вас просят войти снова, хотя вы уже вошли | [Вход не выполнен или срок действия токена истёк](/docs/ru/troubleshoot-install#not-logged-in-or-token-expired) |

906| Учётные данные облачного провайдера работают в терминале, но не в расширении | [Учётные данные Bedrock, Agent Platform или Foundry не загружаются](/docs/ru/troubleshoot-install#bedrock-agent-platform-or-foundry-credentials-not-loading) |968| Учётные данные облачного провайдера работают в терминале, но не в расширении | [Учётные данные Bedrock, Agent Platform или Foundry не загружаются](/docs/ru/troubleshoot-install#bedrock-agent-platform-or-foundry-credentials-not-loading) |

907| `SSL certificate verification failed` или `Self-signed certificate detected` | [Ошибки SSL-сертификатов](/docs/ru/errors#ssl-certificate-errors) |969| `SSL certificate verification failed` или `Self-signed certificate detected` | [Ошибки SSL-сертификатов](/docs/ru/errors#ssl-certificate-errors) |

908| `Claude Code process exited with code 1` или другой код | [Claude Code process exited with code N](/docs/ru/errors#claude-code-process-exited-with-code-n) |970| `Claude Code process exited with code 1` или другой код | [Claude Code process exited with code N](/docs/ru/errors#claude-code-process-exited-with-code-n) |

914 Расширение не устанавливается976 Расширение не устанавливается

915</h3>977</h3>

916 978

917* Убедитесь, что у вас установлена совместимая версия VS Code (1.94.0 или выше)979* Убедитесь, что у вас совместимая версия VS Code (1.94.0 или новее)

918* Проверьте, что VS Code имеет разрешение на установку расширений980* Проверьте, что у VS Code есть разрешение на установку расширений

919* Попробуйте установить напрямую из [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code)981* Попробуйте установить расширение напрямую из [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code)

920 982

921<h3 id="spark-icon-not-visible">983<h3 id="spark-icon-not-visible">

922 Значок Spark не виден984 Значок Spark не отображается

923</h3>985</h3>

924 986

925Значок Spark появляется на **панели инструментов редактора** (в верхнем правом углу редактора) при открытом файле. Если вы его не видите:987Значок Spark появляется на **панели инструментов редактора** (в правом верхнем углу редактора), когда у вас открыт файл. Если вы его не видите:

926 988

9271. **Откройте файл**: Значок требует открытого файла. Просто открытой папки недостаточно.9891. **Откройте файл**: для отображения значка должен быть открыт файл. Открытой папки недостаточно.

9282. **Проверьте версию VS Code**: Требуется версия 1.94.0 или выше (Help → About)9902. **Проверьте версию VS Code**: требуется 1.94.0 или новее. Проверьте в разделе **Help > About**

9293. **Перезагрузите VS Code**: Выполните "Developer: Reload Window" из палитры команд9913. **Перезапустите VS Code**: выполните «Developer: Reload Window» из палитры команд

9304. **Отключите конфликтующие расширения**: Временно отключите другие расширения ИИ (Cline, Continue и т. д.)9924. **Отключите конфликтующие расширения**: временно отключите другие AI-расширения (Cline, Continue и т. д.)

9315. **Проверьте доверие рабочей области**: Расширение не работает в режиме ограниченного доступа9935. **Проверьте доверие к рабочей области**: расширение не работает в ограниченном режиме (Restricted Mode)

932 994

933Кроме того, нажмите **✻ Claude Code** на **строке состояния** (в нижнем правом углу окна). Это работает даже без открытого файла. Вы также можете использовать **палитру команд** (`Cmd+Shift+P` / `Ctrl+Shift+P`) и ввести "Claude Code".995Кроме того, можно нажать **✻ Claude Code** в **строке состояния** в правом нижнем углу окна. Это работает даже без открытого файла. Также можно открыть **палитру команд** (`Cmd+Shift+P` / `Ctrl+Shift+P`) и ввести «Claude Code».

934 996

935<h3 id="cmd-esc-does-nothing-on-macos">997<h3 id="cmd-esc-does-nothing-on-macos">

936 Cmd+Esc ничего не делает на macOS998 Cmd+Esc ничего не делает в macOS

937</h3>999</h3>

938 1000

939На macOS Tahoe и более поздних версиях системный ярлык Game Overlay по умолчанию привязан к `Cmd+Esc` и перехватывает нажатие клавиши до того, как оно достигнет VS Code. Чтобы освободить ярлык:1001В macOS Tahoe и новее системное сочетание клавиш Game Overlay по умолчанию назначено на `Cmd+Esc` и перехватывает нажатие до того, как оно дойдёт до VS Code. Чтобы освободить это сочетание клавиш:

940 1002

9411. Откройте System Settings10031. Откройте System Settings

9422. Перейдите в Keyboard, затем Keyboard Shortcuts, затем Game Controllers10042. Перейдите в Keyboard, затем Keyboard Shortcuts, затем Game Controllers

9433. Снимите флажок Game Overlay10053. Снимите флажок Game Overlay

944 1006

945Кроме того, вы можете переназначить расширение на другую клавишу: откройте редактор [Keyboard Shortcuts](https://code.visualstudio.com/docs/configure/keybindings) в VS Code (`Cmd+K Cmd+S`), найдите `Claude Code: Focus input` и назначьте новое сочетание клавиш.1007Либо назначьте расширению другое сочетание клавиш: откройте в VS Code [редактор сочетаний клавиш](https://code.visualstudio.com/docs/configure/keybindings) (`Cmd+K Cmd+S`), найдите `Claude Code: Focus input` и назначьте новое сочетание.

946 1008

947<h3 id="a-resumed-conversation-is-blank-at-first">1009<h3 id="a-resumed-conversation-is-blank-at-first">

948 Возобновлённый диалог поначалу пустой1010 Возобновлённый диалог сначала пуст

949</h3>1011</h3>

950 1012

951Когда вы [возобновляете прошлый диалог](#resume-past-conversations) или диалог [восстанавливается после перезагрузки](#continue-conversations-after-a-reload), его сообщения могут оставаться пустыми, пока запускается процесс Claude Code для этого диалога. Примерно через секунду в пустой области появляется `Waiting for your plugins…`.1013Когда вы [возобновляете прошлый диалог](#resume-past-conversations) или диалог [восстанавливается после перезагрузки](#continue-conversations-after-a-reload), его сообщения могут оставаться пустыми, пока запускается процесс Claude Code для этого диалога. Примерно через секунду на пустом месте появляется `Waiting for your plugins…`.

952 1014

953Вам не нужно ничего делать. Сообщения появятся, как только процесс запустится и подтвердит, что ни одному плагину не нужно сначала их проверить, или через 20 секунд, если запуск занимает больше времени.1015Ничего делать не нужно. Сообщения появятся, как только процесс запустится и подтвердит, что ни одному плагину не нужно предварительно их проверить, либо через 20 секунд, если запуск занимает больше времени.

954 1016

955<h3 id="the-panel-stops-responding-each-time-a-reload-reopens-a-conversation">1017<h3 id="the-panel-stops-responding-each-time-a-reload-reopens-a-conversation">

956 Панель перестаёт отвечать каждый раз, когда перезагрузка снова открывает диалог1018 Панель перестаёт отвечать каждый раз, когда перезагрузка заново открывает диалог

957</h3>1019</h3>

958 1020

959Если вся панель аварийно завершает работу, зависает или показывает только `Something went wrong` каждый раз, когда вы перезагружаете окно и ваш диалог восстанавливается, обновите расширение до версии v2.1.301 или выше. Затем снова перезагрузите окно или перезапустите VS Code. Если диалогу дважды подряд не удаётся завершить открытие, вместо него вы получите новый чат с уведомлением о том, что [он не был открыт повторно](#a-conversation-was-not-reopened).1021Если вся панель аварийно завершает работу, зависает или показывает только `Something went wrong` каждый раз, когда вы перезагружаете окно и ваш диалог восстанавливается, обновите расширение до v2.1.301 или новее. Затем снова перезагрузите окно или перезапустите VS Code. После того как диалогу дважды подряд не удастся полностью открыться, вместо него вы получите новый чат с уведомлением о том, что [он не был открыт заново](#a-conversation-was-not-reopened).

960 1022

961<h3 id="a-formula-shows-as-raw-latex">1023<h3 id="a-formula-shows-as-raw-latex">

962 Формула отображается как необработанный LaTeX1024 Формула отображается как исходный LaTeX

963</h3>1025</h3>

964 1026

965Если ни одна математическая формула в ответах Claude не отображается в отформатированном виде, проверьте версию расширения в представлении Extensions, поскольку [отображение математики](#latex-math-in-responses) требует версии 2.1.301 или выше. Если вы используете [режим терминала](#switch-to-terminal-mode), который не форматирует математику независимо от версии, снимите флажок [настройки Use Terminal](vscode://settings/claudeCode.useTerminal), чтобы Claude Code открывался в панели чата.1027Если никакие математические выражения в ответах Claude не отображаются в наборе, проверьте версию расширения в представлении Extensions, поскольку [отображение математики](#latex-math-in-responses) требует версии 2.1.301 или новее. Если вы используете [режим терминала](#switch-to-terminal-mode), который не отображает математику независимо от версии, снимите флажок [настройки Use Terminal](vscode://settings/claudeCode.useTerminal), чтобы Claude Code открывался в панели чата.

966 1028

967Если одна формула отображается в исходном виде, а другие рядом с ней отформатированы, проверьте её на следующие причины:1029Если одна формула отображается в исходном виде, а соседние — в наборе, проверьте её на следующие причины:

968 1030

969* **Она воспринимается не как математика**: текст `$…$`, который читается как слово, остаётся в исходном виде, например `$O(n log n)$`. Текст `$…$`, начинающийся с цифры, например `$30$` или `$1/N$`, также остаётся в исходном виде, если только такой символ, как `=`, `+` или `^`, не помечает его как математику. Вместо этого попросите Claude использовать блок `$$` на отдельных строках, который панель форматирует без этой проверки.1031* **Она читается не как математика**: текст `$…$`, который читается как слово, остаётся в исходном виде, например `$O(n log n)$`. Текст `$…$`, начинающийся с цифры, например `$30$` или `$1/N$`, также остаётся в исходном виде, если только такой символ, как `=`, `+` или `^`, не помечает его как математику. Вместо этого попросите Claude оформить блок `$$` на отдельных строках — панель отображает его в наборе без этой проверки.

970* **Она содержит отступы, слишком длинная или разбита на строки**: `$ x^2 $` с пробелами внутри знаков доллара, содержимое `$…$` длиннее 60 символов, а также `$…$` или `$…$`, разбитые на две строки, не форматируются. Вместо этого попросите Claude использовать блок `$$` на отдельных строках, у которого нет этих ограничений.1032* **Она содержит пробелы по краям, слишком длинная или разбита на строки**: `$ x^2 $` с пробелами внутри знаков доллара, содержимое `$…$` длиннее 60 символов, а также `$…$` или `$…$`, разбитые на две строки, не отображаются в наборе. Вместо этого попросите Claude оформить блок `$$` на отдельных строках — у него нет ни одного из этих ограничений.

971* **TeX невозможно отформатировать**: формула с синтаксической ошибкой, определением макроса, например `\newcommand` или `\def`, или неэкранированным `%` отображается в исходном виде. Попросите Claude переписать её, исправив ошибку, без макроса или с `\%` для знака процента.1033* **TeX невозможно набрать**: формула с синтаксической ошибкой, определением макроса, например `\newcommand` или `\def`, или неэкранированным `%` отображается в исходном виде. Попросите Claude переписать её с исправленной ошибкой, без макроса или с `\%` для знака процента.

972* **Она слишком большая**: формула длиннее 8 192 символов или формула, которая при отрисовке оказалась бы намного больше своего исходного текста, отображается в исходном виде. Попросите Claude разбить её на формулы поменьше или записать компактнее.1034* **Она слишком большая**: формула длиннее 8 192 символов или формула, которая при отрисовке получилась бы намного больше своего исходного текста, отображается в исходном виде. Попросите Claude разбить её на формулы поменьше или записать компактнее.

973* **Она следует за большим объёмом математики**: в пределах одного блока текста в ответе панель форматирует формулы по порядку до определённого предела. Следующая формула, которая превысила бы этот предел, отображается в исходном виде. Попросите Claude отправить нужную вам формулу ещё раз отдельно.1035* **Она следует за большим объёмом математики**: в пределах одного текстового блока ответа панель отображает формулы в наборе по порядку до определённого предела. Последующая формула, которая превысила бы этот предел, отображается в исходном виде. Попросите Claude отправить нужную вам формулу ещё раз отдельно.

974 1036

975<h3 id="claude-code-never-responds">1037<h3 id="claude-code-never-responds">

976 Claude Code никогда не отвечает1038 Claude Code не отвечает

977</h3>1039</h3>

978 1040

979Если Claude Code не отвечает на ваши запросы:1041Если Claude Code не отвечает на ваши промпты:

980 1042

9811. **Проверьте подключение к интернету**: Убедитесь, что у вас есть стабильное подключение к интернету10431. **Проверьте подключение к интернету**: убедитесь, что у вас стабильное подключение к интернету

9822. **Начните новый разговор**: Попробуйте начать новый разговор, чтобы проверить, сохраняется ли проблема10442. **Начните новый диалог**: попробуйте начать новый диалог, чтобы проверить, сохраняется ли проблема

9833. **Попробуйте CLI**: Выполните `claude` из терминала, чтобы увидеть более подробные сообщения об ошибках10453. **Попробуйте CLI**: запустите `claude` в терминале, чтобы увидеть более подробные сообщения об ошибках

984 1046

985Если проблемы сохраняются, [создайте проблему на GitHub](https://github.com/anthropics/claude-code/issues) с подробностями об ошибке.1047Если проблемы не исчезают, [создайте issue на GitHub](https://github.com/anthropics/claude-code/issues) с подробным описанием ошибки.

986 1048

987<h2 id="uninstall-the-extension">1049<h2 id="uninstall-the-extension">

988 Удаление расширения1050 Удаление расширения

990 1052

991Чтобы удалить расширение Claude Code:1053Чтобы удалить расширение Claude Code:

992 1054

9931. Откройте представление расширений (`Cmd+Shift+X` на Mac или `Ctrl+Shift+X` на Windows/Linux)10551. Нажмите `Cmd+Shift+X` на Mac или `Ctrl+Shift+X` на Windows/Linux, чтобы открыть представление Extensions

9942. Найдите "Claude Code"10562. Найдите «Claude Code»

9953. Нажмите **Uninstall**10573. Нажмите **Uninstall**

996 1058

997Если вы запустите `claude` в интегрированном терминале VS Code, Claude Code автоматически переустановит расширение. Чтобы оно оставалось удалённым, отключите **Auto-install IDE extension** в `/config` или установите [`autoInstallIdeExtension`](/docs/ru/settings-reference#autoinstallideextension) на `false`. Вы также можете установить переменную окружения [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/docs/ru/env-vars) на `1`.1059Если вы запускаете `claude` во встроенном терминале VS Code, Claude Code автоматически переустанавливает расширение. Чтобы оно оставалось удалённым, отключите **Auto-install IDE extension** в `/config` или задайте для [`autoInstallIdeExtension`](/docs/ru/settings-reference#autoinstallideextension) значение `false`. Также можно задать для переменной окружения [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/docs/ru/env-vars) значение `1`.

998 1060

999Чтобы также удалить данные расширения и сбросить все параметры, удалите каталог хранилища расширения для вашей платформы.1061Чтобы также удалить данные расширения и сбросить все настройки, удалите каталог хранилища расширения для вашей платформы.

1000 1062

1001На macOS:1063В macOS:

1002 1064

1003```bash theme={null}1065```bash theme={null}

1004rm -rf ~/Library/"Application Support"/Code/User/globalStorage/anthropic.claude-code1066rm -rf ~/Library/"Application Support"/Code/User/globalStorage/anthropic.claude-code

1005```1067```

1006 1068

1007На Linux:1069В Linux:

1008 1070

1009```bash theme={null}1071```bash theme={null}

1010rm -rf ~/.config/Code/User/globalStorage/anthropic.claude-code1072rm -rf ~/.config/Code/User/globalStorage/anthropic.claude-code

1011```1073```

1012 1074

1013На Windows в PowerShell:1075В Windows, в PowerShell:

1014 1076

1015```powershell theme={null}1077```powershell theme={null}

1016Remove-Item -Recurse -Force "$env:APPDATA\Code\User\globalStorage\anthropic.claude-code"1078Remove-Item -Recurse -Force "$env:APPDATA\Code\User\globalStorage\anthropic.claude-code"

1017```1079```

1018 1080

1019Для получения дополнительной помощи см. [руководство по устранению неполадок](/docs/ru/troubleshooting).1081Дополнительную помощь см. в [руководстве по устранению неполадок](/docs/ru/troubleshooting).

1020 1082

1021<h2 id="next-steps">1083<h2 id="next-steps">

1022 Следующие шаги1084 Дальнейшие шаги

1023</h2>1085</h2>

1024 1086

1025Теперь, когда вы настроили Claude Code в VS Code:1087Теперь, когда вы настроили Claude Code в VS Code:

1026 1088

1027* [Изучите распространённые рабочие процессы](/docs/ru/common-workflows), чтобы максимально использовать Claude Code1089* [Изучите распространённые рабочие процессы](/docs/ru/common-workflows), чтобы получить максимум от Claude Code

1028* [Настройте MCP серверы](/docs/ru/mcp) для расширения возможностей Claude с помощью внешних инструментов. Добавляйте и управляйте ими с помощью `/mcp` в панели чата.1090* [Настройте MCP-серверы](/docs/ru/mcp), чтобы расширить возможности Claude с помощью внешних инструментов. Добавляйте их и управляйте ими с помощью `/mcp` в панели чата.

1029* [Настройте параметры Claude Code](/docs/ru/settings) для настройки разрешённых команд, hooks и многого другого. Эти параметры общие для расширения и CLI.1091* [Настройте параметры Claude Code](/docs/ru/settings), чтобы настроить разрешённые команды, хуки и многое другое. Эти настройки являются общими для расширения и CLI.

1092* [Ознакомьтесь с мерами безопасности](/docs/ru/security) и [использованием данных](/docs/ru/data-usage) в Claude Code

zero-data-retention.md +1 −0

Details

68| Функция | Причина |68| Функция | Причина |

69| - | - |69| - | - |

70| [Cloud sessions](/docs/ru/claude-code-on-the-web), включая те, которые запущены из [приложения Desktop](/docs/ru/desktop#cloud-sessions) | Требует серверного хранилища данных сеанса, включая историю беседы с запросами и завершениями. |70| [Cloud sessions](/docs/ru/claude-code-on-the-web), включая те, которые запущены из [приложения Desktop](/docs/ru/desktop#cloud-sessions) | Требует серверного хранилища данных сеанса, включая историю беседы с запросами и завершениями. |

71| [Единый интерфейс Chat и Cowork](https://support.claude.com/en/articles/17444462-set-up-and-manage-the-new-unified-claude-experience-for-your-enterprise-organization) | Требует облачных сессий. |

71| [Claude Tag](https://claude.com/docs/claude-tag) | Сохраняет память канала и стенограммы сеансов. |72| [Claude Tag](https://claude.com/docs/claude-tag) | Сохраняет память канала и стенограммы сеансов. |

72| [Артефакты](/docs/ru/artifacts) | Требует сохранения опубликованного содержимого страницы на инфраструктуре, управляемой Anthropic. |73| [Артефакты](/docs/ru/artifacts) | Требует сохранения опубликованного содержимого страницы на инфраструктуре, управляемой Anthropic. |

73| Отправка отзыва (`/feedback`, `/bug`, `/share`) | Отправка отзыва отправляет данные беседы в Anthropic. |74| Отправка отзыва (`/feedback`, `/bug`, `/share`) | Отправка отзыва отправляет данные беседы в Anthropic. |

Documentation 2026-10-15 23:58 UTC to 2026-10-16 22:59 UTC