Documentation — Spybara

admin-setup.md +1 −0

Details

106| [Отключить синхронизацию claude.ai](/docs/ru/settings-reference#syncclaudeaiskills) | Остановить Claude Code от загрузки [skills](/docs/ru/skills#how-synced-skills-behave) и [плагинов](/docs/ru/plugins/loading#synced-plugins), которые ваши разработчики включают на claude.ai. Если вы отключите Skills для вашей организации на claude.ai, Claude Code останавливает синхронизацию обоих, и на v2.1.273 или позже это также удаляет те, которые он уже синхронизировал. Чтобы остановить один из них без отключения Skills, установите его ключ на `false` в управляемых параметрах | `syncClaudeAiSkills`, `syncClaudeAiPlugins` |106| [Отключить синхронизацию claude.ai](/docs/ru/settings-reference#syncclaudeaiskills) | Остановить Claude Code от загрузки [skills](/docs/ru/skills#how-synced-skills-behave) и [плагинов](/docs/ru/plugins/loading#synced-plugins), которые ваши разработчики включают на claude.ai. Если вы отключите Skills для вашей организации на claude.ai, Claude Code останавливает синхронизацию обоих, и на v2.1.273 или позже это также удаляет те, которые он уже синхронизировал. Чтобы остановить один из них без отключения Skills, установите его ключ на `false` в управляемых параметрах | `syncClaudeAiSkills`, `syncClaudeAiPlugins` |

107| [Ограничения hooks](/docs/ru/settings-reference#allowmanagedhooksonly) | Ограничить, какие hooks выполняются, и ограничить URL-адреса HTTP hooks; см. [что выполняется под `allowManagedHooksOnly`](/docs/ru/settings-reference#what-runs-under-allowmanagedhooksonly) для полного списка эффектов | `allowManagedHooksOnly`, `allowedHttpHookUrls` |107| [Ограничения hooks](/docs/ru/settings-reference#allowmanagedhooksonly) | Ограничить, какие hooks выполняются, и ограничить URL-адреса HTTP hooks; см. [что выполняется под `allowManagedHooksOnly`](/docs/ru/settings-reference#what-runs-under-allowmanagedhooksonly) для полного списка эффектов | `allowManagedHooksOnly`, `allowedHttpHookUrls` |

108| [Принудительный вход](/docs/ru/settings-reference#forceloginmethod) | Ограничить вход определённым методом или организацией Anthropic. Ограничение метода применяется во всём расширении VS Code, Agent SDK, `claude setup-token` и `/install-github-app`, а интерактивный экран входа терминала, доступный через `/login` или первоначальную настройку, предварительно выбирает метод без его принудительного применения; Claude Code проверяет организацию для входов в учётную запись claude.ai в терминале, расширении VS Code и Agent SDK, и не проверяет её для входов в Claude Console или для входа через [gateway](/docs/ru/claude-apps-gateway). До версии 2.1.212 только входы в терминал применяли любой из ключей. Когда установлено, сеансы, аутентифицированные через `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, блокируются при запуске; облачные сеансы поставщиков не затрагиваются, если только одно из этих учётных данных или ключ API, сохранённый более ранним входом в Claude Console, также не присутствует | `forceLoginMethod`, `forceLoginOrgUUID` |108| [Принудительный вход](/docs/ru/settings-reference#forceloginmethod) | Ограничить вход определённым методом или организацией Anthropic. Ограничение метода применяется во всём расширении VS Code, Agent SDK, `claude setup-token` и `/install-github-app`, а интерактивный экран входа терминала, доступный через `/login` или первоначальную настройку, предварительно выбирает метод без его принудительного применения; Claude Code проверяет организацию для входов в учётную запись claude.ai в терминале, расширении VS Code и Agent SDK, и не проверяет её для входов в Claude Console или для входа через [gateway](/docs/ru/claude-apps-gateway). До версии 2.1.212 только входы в терминал применяли любой из ключей. Когда установлено, сеансы, аутентифицированные через `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, блокируются при запуске; облачные сеансы поставщиков не затрагиваются, если только одно из этих учётных данных или ключ API, сохранённый более ранним входом в Claude Console, также не присутствует | `forceLoginMethod`, `forceLoginOrgUUID` |

109| [Ограничения поставщика](/docs/ru/settings-reference#allowedproviders) | Ограничить, какие поставщики API может использовать машина. Сеанс на поставщике, который не указан в списке, отклоняется при запуске, при входе и когда он в следующий раз обращается к API. Требуется Claude Code v2.1.285 или позже | `allowedProviders` |

109| [Отключить представление агента](/docs/ru/agent-view#how-background-sessions-are-hosted) | Отключить `claude agents`, `--bg`, `/background` и супервизор по требованию | `disableAgentView` |110| [Отключить представление агента](/docs/ru/agent-view#how-background-sessions-are-hosted) | Отключить `claude agents`, `--bg`, `/background` и супервизор по требованию | `disableAgentView` |

110| [Настройка корпоративного запускателя](/docs/ru/corporate-launcher) | Добавить префикс к [супервизору фонового агента](/docs/ru/agent-view#how-background-sessions-are-hosted), его рабочим процессам и [другим охватываемым фоновым процессам](/docs/ru/corporate-launcher#what-the-launcher-covers) с требуемым корпоративным запускателем вместо отключения представления агента | `processWrapper` |111| [Настройка корпоративного запускателя](/docs/ru/corporate-launcher) | Добавить префикс к [супервизору фонового агента](/docs/ru/agent-view#how-background-sessions-are-hosted), его рабочим процессам и [другим охватываемым фоновым процессам](/docs/ru/corporate-launcher#what-the-launcher-covers) с требуемым корпоративным запускателем вместо отключения представления агента | `processWrapper` |

111| [Ограничения модели](/docs/ru/model-config#restrict-model-selection) | `availableModels` фильтрует, какие модели появляются в средстве выбора. Добавление `enforceAvailableModels` также ограничивает автоматически выбранную модель по умолчанию. См. [охват поверхности](/docs/ru/model-config#surface-coverage) для того, как этот параметр достигает CLI, веб-интерфейса и IDE | `availableModels`, `enforceAvailableModels` |112| [Ограничения модели](/docs/ru/model-config#restrict-model-selection) | `availableModels` фильтрует, какие модели появляются в средстве выбора. Добавление `enforceAvailableModels` также ограничивает автоматически выбранную модель по умолчанию. См. [охват поверхности](/docs/ru/model-config#surface-coverage) для того, как этот параметр достигает CLI, веб-интерфейса и IDE | `availableModels`, `enforceAvailableModels` |

agent-sdk/hooks.md +6 −2

Details

418 ```418 ```

419</CodeGroup>419</CodeGroup>

420 420

421Чтобы подтвердить блокировку, зарегистрируйте callback под `PreToolUse` с matcher `Write|Edit` и попросите агента создать файл в `/etc`: результат инструмента Write в потоке сообщений содержит `Writing to /etc is not allowed`, и файл не создается.

422

421<h3 id="auto-approve-specific-tools">423<h3 id="auto-approve-specific-tools">

422 Автоматическое одобрение конкретных инструментов424 Автоматическое одобрение конкретных инструментов

423</h3>425</h3>

468 470

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

470 472

471Пример ниже регистрирует три независимые проверки для каждого вызова инструмента:473Пример ниже регистрирует три независимые проверки для каждого вызова инструмента. Имена hooks в нем, такие как `audit_logger` в Python или `auditLogger` в TypeScript, служат заменой для callbacks, которые вы определяете:

472 474

473<CodeGroup>475<CodeGroup>

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

500 Фильтрация с помощью multi-tool matchers502 Фильтрация с помощью multi-tool matchers

501</h3>503</h3>

502 504

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

504 506

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

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

585 ```587 ```

586</CodeGroup>588</CodeGroup>

587 589

590Чтобы подтвердить срабатывание hook, зарегистрируйте callback и попросите агента делегировать небольшую задачу подагенту, например список файлов в текущем каталоге: когда подагент завершится, callback выведет строки `[SUBAGENT] Completed:` с ID подагента и путем к транскрипту.

591

588<h3 id="make-http-requests-from-hooks">592<h3 id="make-http-requests-from-hooks">

589 Выполнение HTTP запросов из hooks593 Выполнение HTTP запросов из hooks

590</h3>594</h3>

agent-sdk/permissions.md +9 −0

Details

121 121

122Режимы разрешений обеспечивают глобальный контроль над тем, как Claude использует инструменты. Вы можете установить режим разрешений при вызове `query()` или изменить его динамически во время сеансов потоковой передачи.122Режимы разрешений обеспечивают глобальный контроль над тем, как Claude использует инструменты. Вы можете установить режим разрешений при вызове `query()` или изменить его динамически во время сеансов потоковой передачи.

123 123

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

125

126* `permissions.defaultMode` из [файлов параметров](/docs/ru/settings#where-settings-live) сеанса, когда он применяется

127* В противном случае встроенное значение по умолчанию, которое может быть [режимом auto](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode)

128

129Сеанс, который начинается в режиме auto, отбрасывает широкие правила разрешения, такие как простая запись `Bash`, как описано в [Как режим auto оценивает действия](/docs/ru/permission-modes#how-auto-mode-evaluates-actions). Если ваше приложение полагается на режим `default` или на такое правило, передайте `default` явно.

130

131До TypeScript Agent SDK v0.3.286 пропуск `permissionMode` был эквивалентен передаче `default`.

132

124<h3 id="available-modes">133<h3 id="available-modes">

125 Доступные режимы134 Доступные режимы

126</h3>135</h3>

agent-sdk/python.md +245 −71

Details

517 async def set_model(self, model: str | None = None) -> None517 async def set_model(self, model: str | None = None) -> None

518 async def rewind_files(self, user_message_id: str) -> None518 async def rewind_files(self, user_message_id: str) -> None

519 async def get_mcp_status(self) -> McpStatusResponse519 async def get_mcp_status(self) -> McpStatusResponse

520 async def get_context_usage(self) -> ContextUsageResponse

520 async def reconnect_mcp_server(self, server_name: str) -> None521 async def reconnect_mcp_server(self, server_name: str) -> None

521 async def toggle_mcp_server(self, server_name: str, enabled: bool) -> None522 async def toggle_mcp_server(self, server_name: str, enabled: bool) -> None

522 async def stop_task(self, task_id: str) -> None523 async def stop_task(self, task_id: str) -> None

540| `set_model(model)` | Измените модель для текущего сеанса. Передайте `None` для сброса на [модель по умолчанию Claude Code](/docs/ru/model-config) |541| `set_model(model)` | Измените модель для текущего сеанса. Передайте `None` для сброса на [модель по умолчанию Claude Code](/docs/ru/model-config) |

541| `rewind_files(user_message_id)` | Восстановите файлы в их состояние в указанном пользовательском сообщении. Требует `enable_file_checkpointing=True`. См. [File checkpointing](/docs/ru/agent-sdk/file-checkpointing) |542| `rewind_files(user_message_id)` | Восстановите файлы в их состояние в указанном пользовательском сообщении. Требует `enable_file_checkpointing=True`. См. [File checkpointing](/docs/ru/agent-sdk/file-checkpointing) |

542| `get_mcp_status()` | Получите статус всех настроенных MCP servers. Возвращает [`McpStatusResponse`](#mcpstatusresponse) |543| `get_mcp_status()` | Получите статус всех настроенных MCP servers. Возвращает [`McpStatusResponse`](#mcpstatusresponse) |

544| `get_context_usage()` | Получите разбивку использования контекстного окна по категориям, навыкам и инструментам. Те же данные, которые `/context` показывает в интерактивном сеансе. Возвращает [`ContextUsageResponse`](#contextusageresponse). Для вычисления разбивки Claude Code делает несколько запросов API подсчета токенов, которые не отображаются в потоке сообщений; см. [как эти запросы обрабатываются](#contextusageresponse) |

544| `toggle_mcp_server(server_name, enabled)` | Включите или отключите MCP server в середине сеанса. Отключение удаляет его инструменты |546| `toggle_mcp_server(server_name, enabled)` | Включите или отключите MCP server в середине сеанса. Отключение удаляет его инструменты |

545| `stop_task(task_id)` | Остановите выполняющуюся фоновую задачу. [`TaskNotificationMessage`](#tasknotificationmessage) со статусом `"stopped"` следует в потоке сообщений |547| `stop_task(task_id)` | Остановите выполняющуюся фоновую задачу. [`TaskNotificationMessage`](#tasknotificationmessage) со статусом `"stopped"` следует в потоке сообщений |

616 Пример - Потоковый ввод с ClaudeSDKClient618 Пример - Потоковый ввод с ClaudeSDKClient

617</h4>619</h4>

618 620

621`query()` также принимает асинхронный итерируемый объект словарей пользовательских сообщений, поэтому вы можете собрать подсказку во время отправки или включить блоки содержимого, такие как изображения. Claude Code начинает отвечать на первое полученное сообщение сразу же по его прибытии, не дожидаясь завершения итерируемого объекта, и `receive_response()` останавливается на `ResultMessage`, который завершает этот ответ. Поместите все, что Claude должен прочитать перед ответом, в одно сообщение, как это делает этот генератор, и свяжите каждый вызов `query()` с его собственным циклом `receive_response()`.

622

619```python theme={null}623```python theme={null}

620import asyncio624import asyncio

621from claude_agent_sdk import ClaudeSDKClient625from claude_agent_sdk import ClaudeSDKClient

622 626

623 627

624async def message_stream():628async def message_stream():

625 """Generate messages dynamically."""629 """Assemble the prompt at send time and yield it as one user message."""

626 yield {630 readings = {"Temperature": "25°C", "Humidity": "60%"}

627 "type": "user",631 data = ", ".join(f"{name}: {value}" for name, value in readings.items())

628 "message": {"role": "user", "content": "Analyze the following data:"},

629 }

630 await asyncio.sleep(0.5)

631 yield {

632 "type": "user",

633 "message": {"role": "user", "content": "Temperature: 25°C, Humidity: 60%"},

634 }

635 await asyncio.sleep(0.5)

636 yield {632 yield {

637 "type": "user",633 "type": "user",

638 "message": {"role": "user", "content": "What patterns do you see?"},634 "message": {

635 "role": "user",

636 "content": f"Analyze the following sensor data and describe any patterns you see: {data}",

637 },

639 }638 }

640 639

641 640

1609 1608

1609<h3 id="contextusageresponse">

1610 `ContextUsageResponse`

1611</h3>

1612

1613Ответ от [`ClaudeSDKClient.get_context_usage()`](#methods). Это тот же payload, который Claude Code отображает для команды `/context` в интерактивном сеансе, поэтому наряду с подсчётом токенов он содержит поля отображения, такие как `color` и `gridRows`, которые Claude Code использует для рисования сетки использования `/context`.

1614

1615Claude Code создаёт этот payload, отправляя несколько запросов к API [подсчёта токенов](https://platform.claude.com/docs/en/build-with-claude/token-counting). Эти запросы не отображаются в потоке сообщений, поэтому отслеживание стоимости, которое читает поток, их не увидит. На API Anthropic подсчёт токенов не выставляется счётом.

1616

1617```python theme={null}

1618class ContextUsageResponse(TypedDict):

1619 categories: list[ContextUsageCategory]

1620 totalTokens: int

1621 maxTokens: int

1622 rawMaxTokens: int

1623 percentage: float

1624 model: str

1625 isAutoCompactEnabled: bool

1626 memoryFiles: list[dict[str, Any]]

1627 mcpTools: list[dict[str, Any]]

1628 agents: list[dict[str, Any]]

1629 gridRows: list[list[dict[str, Any]]]

1630 autoCompactThreshold: NotRequired[int]

1631 deferredBuiltinTools: NotRequired[list[dict[str, Any]]]

1632 systemTools: NotRequired[list[dict[str, Any]]]

1633 systemPromptSections: NotRequired[list[dict[str, Any]]]

1634 slashCommands: NotRequired[dict[str, Any]]

1635 skills: NotRequired[dict[str, Any]] # skill usage with frontmatter breakdown

1636 messageBreakdown: NotRequired[dict[str, Any]] # message tokens by type

1637 apiUsage: NotRequired[dict[str, Any] | None]

1638```

1639

1640Каждая запись `ContextUsageCategory` содержит `name`, `tokens`, `color` и дополнительный флаг `isDeferred`. `totalTokens` — это текущее использование контекста сеанса, а `maxTokens` — это окно, против которого измеряется использование. Это окно — это окно контекста модели, или более низкое окно auto-compaction, когда оно применяется, и `rawMaxTokens` содержит то же значение, что и `maxTokens`. `apiUsage` содержит использование из последнего ответа API, а не итоговое значение для сеанса. Claude Code оставляет дополнительные ключи `deferredBuiltinTools`, `systemTools` и `systemPromptSections` не установленными, поэтому ожидайте их отсутствия, даже если тип их объявляет.

1641

1610<h3 id="sdkpluginconfig">1642<h3 id="sdkpluginconfig">

1611 `SdkPluginConfig`1643 `SdkPluginConfig`

1612</h3>1644</h3>

2712 2744

2713Документация схем ввода/вывода для всех встроенных инструментов Claude Code. Хотя Python SDK не экспортирует их как типы, они представляют структуру входов и выходов инструментов в сообщениях.2745Документация схем ввода/вывода для всех встроенных инструментов Claude Code. Хотя Python SDK не экспортирует их как типы, они представляют структуру входов и выходов инструментов в сообщениях.

2714 2746

2747Каждый показанный вывод — это значение, которое вы читаете из [`UserMessage.tool_use_result`](#usermessage) для этого инструмента. Названия ключей появляются точно так, как их выдает Claude Code. Ключ, аннотированный `| None` с комментарием "present when" или "optional", опускается, когда он не применяется.

2748

2715<h3 id="agent">2749<h3 id="agent">

2716 Agent2750 Agent

2717</h3>2751</h3>

2805```python theme={null}2839```python theme={null}

2806{2840{

2807 "status": "remote_launched",2841 "status": "remote_launched",

2808 "taskId": str, # ID удаленной задачи2842 "taskId": str, # ID отправленной задачи

2809 "sessionUrl": str, # Ссылка на удаленный облачный сеанс2843 "sessionUrl": str, # Ссылка на облачный сеанс

2810 "description": str, # Описание задачи2844 "description": str, # Описание задачи

2811 "prompt": str, # Подсказка, которую запускает агент2845 "prompt": str, # Подсказка, которую запускает агент

2812 "outputFile": str, # Путь файла, где записывается вывод агента2846 "outputFile": str, # Путь файла, где записывается вывод агента

2813}2847}

2814```2848```

2815 2849

2816Возвращает результат от подагента. Вывод различается по полю `status`: `"completed"` для завершенных задач, `"async_launched"` для фоновых задач и `"remote_launched"` для задач, которые Claude Code отправил в удаленный облачный сеанс, где `sessionUrl` ссылается на этот сеанс и `taskId` его идентифицирует. Если Claude Code [сохранил изолированный worktree подагента](/docs/ru/worktrees#isolate-subagents-with-worktrees), `worktreePath` в варианте `completed` — это место, где его найти, и `worktreeBranch` — это его ветка, когда Claude Code создал worktree с git.2850Возвращает результат от подагента. Вывод различается по полю `status`: `"completed"` для завершенных задач, `"async_launched"` для фоновых задач и `"remote_launched"` для задач, которые Claude Code отправил в облачный сеанс, где `sessionUrl` ссылается на этот сеанс и `taskId` его идентифицирует. Если Claude Code [сохранил изолированный worktree подагента](/docs/ru/worktrees#isolate-subagents-with-worktrees), `worktreePath` в варианте `completed` — это место, где его найти, и `worktreeBranch` — это его ветка, когда Claude Code создал worktree с git.

2817 2851

2818В варианте `completed`, `resolvedModel` называет модель, на которой запустился подагент, которая может отличаться от запрошенного входа `model`, когда применяется [`availableModels`](/docs/ru/model-config#restrict-model-selection) или другое переопределение. Это поле требует Claude Code v2.1.174 или позже. В варианте `async_launched`, `resolvedModel` называет модель, используемую, когда агент перешел в фоновый режим, поэтому обмен, произошедший перед фоновым режимом, отражается там. Поле `modelsUsed` в обоих вариантах перечисляет использованные модели по порядку, с коллапсированными последовательными повторениями; оно устанавливается только при обмене модели во время выполнения. `modelsUsed` и поведение `resolvedModel` во время фонового режима требуют Claude Code v2.1.212 или позже.2852В варианте `completed`, `resolvedModel` называет модель, на которой запустился подагент, которая может отличаться от запрошенного входа `model`, когда применяется [`availableModels`](/docs/ru/model-config#restrict-model-selection) или другое переопределение. Это поле требует Claude Code v2.1.174 или позже. В варианте `async_launched`, `resolvedModel` называет модель, используемую, когда агент перешел в фоновый режим, поэтому обмен, произошедший перед фоновым режимом, отражается там. Поле `modelsUsed` в обоих вариантах перечисляет использованные модели по порядку, с коллапсированными последовательными повторениями; оно устанавливается только при обмене модели во время выполнения. `modelsUsed` и поведение `resolvedModel` во время фонового режима требуют Claude Code v2.1.212 или позже.

2819 2853

2885 2919

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

2887 2921

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

2889 2923

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

2891 2925

2962 2996

2963```python theme={null}2997```python theme={null}

2964{2998{

2965 "message": str, # Сообщение подтверждения2999 "filePath": str, # Файл, который был отредактирован

2966 "replacements": int, # Количество выполненных замен3000 "oldString": str, # Текст, который был заменен

2967 "file_path": str, # Путь файла, который был отредактирован3001 "newString": str, # Текст, который его заменил

3002 "originalFile": str | None, # Содержимое файла перед редактированием

3003 "structuredPatch": [ # Diff-блоки для изменения

3004 {

3005 "oldStart": int,

3006 "oldLines": int,

3007 "newStart": int,

3008 "newLines": int,

3009 "lines": list[str],

3010 }

3011 ],

3012 "userModified": bool, # Изменил ли пользователь предложенное редактирование перед его принятием

3013 "replaceAll": bool, # Были ли заменены все вхождения

3014 "gitDiff": { # Необязательное резюме git diff для файла

3015 "filename": str,

3016 "status": "modified" | "added",

3017 "additions": int,

3018 "deletions": int,

3019 "changes": int,

3020 "patch": str,

3021 "repository": str | None, # GitHub owner/repo, когда доступно

3022 } | None,

2968}3023}

2969```3024```

2970 3025

2984}3039}

2985```3040```

2986 3041

2987**Вывод (текстовые файлы):**3042Вывод принимает одну из следующих форм в зависимости от того, что прочитал Claude. Проверьте ключ `type`, чтобы их различить.

3043

3044**Вывод (type: `"text"`):**

3045

3046```python theme={null}

3047{

3048 "type": "text",

3049 "file": {

3050 "filePath": str, # Файл, который был прочитан

3051 "content": str, # Возвращенное содержимое

3052 "numLines": int, # Количество строк в возвращенном содержимом

3053 "startLine": int, # Номер строки, с которой начинается содержимое

3054 "totalLines": int, # Общее количество строк в файле

3055 "truncatedByTokenCap": bool | None, # Присутствует и True, когда чтение всего файла превысило лимит токенов и содержимое — это первая страница

3056 },

3057}

3058```

3059

3060**Вывод (type: `"image"`):**

3061

3062```python theme={null}

3063{

3064 "type": "image",

3065 "file": {

3066 "base64": str, # Данные изображения в кодировке Base64

3067 "type": "image/jpeg" | "image/png" | "image/gif" | "image/webp", # MIME-тип изображения

3068 "originalSize": int, # Исходный размер файла в байтах

3069 "dimensions": { # Необязательная информация о размерах для сопоставления координат

3070 "originalWidth": int | None, # Необязательно; исходная ширина в пикселях

3071 "originalHeight": int | None, # Необязательно; исходная высота в пикселях

3072 "displayWidth": int | None, # Необязательно; ширина после изменения размера

3073 "displayHeight": int | None, # Необязательно; высота после изменения размера

3074 } | None,

3075 },

3076}

3077```

3078

3079**Вывод (type: `"notebook"`):**

3080

3081```python theme={null}

3082{

3083 "type": "notebook",

3084 "file": {

3085 "filePath": str, # Записная книжка, которая была прочитана

3086 "cells": list, # Ячейки записной книжки

3087 },

3088}

3089```

3090

3091**Вывод (type: `"pdf"`):**

3092

3093```python theme={null}

3094{

3095 "type": "pdf",

3096 "file": {

3097 "filePath": str, # PDF, который был прочитан

3098 "base64": str, # Данные PDF в кодировке Base64

3099 "originalSize": int, # Размер файла в байтах

3100 },

3101}

3102```

3103

3104**Вывод (type: `"parts"`):**

2988 3105

2989```python theme={null}3106```python theme={null}

2990{3107{

2991 "content": str, # Содержимое файла с номерами строк3108 "type": "parts",

2992 "total_lines": int, # Общее количество строк в файле3109 "file": {

2993 "lines_returned": int, # Фактически возвращенные строки3110 "filePath": str, # PDF, который был прочитан

3111 "originalSize": int, # Размер файла в байтах

3112 "count": int, # Количество страниц, извлеченных как изображения

3113 "outputDir": str, # Каталог, содержащий извлеченные изображения страниц

3114 },

3115 "firstPage": int | None, # Необязательный номер страницы документа первой извлеченной страницы

2994}3116}

2995```3117```

2996 3118

2997**Вывод (изображения):**3119**Вывод (type: `"file_unchanged"`):**

2998 3120

2999```python theme={null}3121```python theme={null}

3000{3122{

3001 "image": str, # Данные изображения в кодировке Base643123 "type": "file_unchanged", # Файл не изменился с момента последнего чтения Claude в этом сеансе, поэтому содержимое не повторяется

3002 "mime_type": str, # MIME-тип изображения3124 "file": {

3003 "file_size": int, # Размер файла в байтах3125 "filePath": str,

3126 },

3127 "source": "seeded" | None, # Присутствует, когда более ранняя копия поступила из файла CLAUDE.md или памяти, загруженного при запуске, а не из вызова Read

3004}3128}

3005```3129```

3006 3130

3023 3147

3024```python theme={null}3148```python theme={null}

3025{3149{

3026 "message": str, # Сообщение об успехе3150 "type": "create" | "update", # Создала ли запись новый файл или перезаписала существующий

3027 "bytes_written": int, # Количество записанных байтов3151 "filePath": str, # Файл, который был записан

3028 "file_path": str, # Путь файла, который был записан3152 "content": str, # Содержимое, которое было записано

3153 "structuredPatch": [ # Diff-блоки; пусто для нового файла, когда ничего не изменилось или когда Claude Code пропустил diff

3154 {

3155 "oldStart": int,

3156 "oldLines": int,

3157 "newStart": int,

3158 "newLines": int,

3159 "lines": list[str],

3160 }

3161 ],

3162 "originalFile": str | None, # Предыдущее содержимое; None для нового файла или когда предыдущее содержимое было слишком большим для включения

3163 "gitDiff": { # Необязательное резюме git diff для файла

3164 "filename": str,

3165 "status": "modified" | "added",

3166 "additions": int,

3167 "deletions": int,

3168 "changes": int,

3169 "patch": str,

3170 "repository": str | None, # GitHub owner/repo, когда доступно

3171 } | None,

3172 "userModified": bool | None, # Необязательно; изменил ли пользователь предложенное содержимое перед его принятием

3029}3173}

3030```3174```

3031 3175

3048 3192

3049```python theme={null}3193```python theme={null}

3050{3194{

3051 "matches": list[str], # Массив совпадающих путей файлов3195 "durationMs": int, # Время, затраченное на выполнение поиска, в миллисекундах

3052 "count": int, # Количество найденных совпадений3196 "numFiles": int, # Количество возвращенных путей после любого усечения

3053 "search_path": str, # Использованный каталог поиска3197 "filenames": list[str], # Совпадающие пути файлов

3198 "truncated": bool, # Были ли результаты усечены на лимите 100 файлов

3199 "totalMatches": int | None, # Необязательное общее количество совпадающих файлов перед усечением; нижняя граница, когда countIsComplete равно False

3200 "countIsComplete": bool | None, # Необязательно; является ли totalMatches точным

3054}3201}

3055```3202```

3056 3203

3204`totalMatches` и `countIsComplete` требуют Claude Code v2.1.191 или позже.

3205

3057<h3 id="grep">3206<h3 id="grep">

3058 Grep3207 Grep

3059</h3>3208</h3>

3074 "-B": int | None, # Строки для отображения перед каждым совпадением3223 "-B": int | None, # Строки для отображения перед каждым совпадением

3075 "-A": int | None, # Строки для отображения после каждого совпадения3224 "-A": int | None, # Строки для отображения после каждого совпадения

3076 "-C": int | None, # Строки для отображения до и после3225 "-C": int | None, # Строки для отображения до и после

3226 "context": int | None, # Строки для отображения до и после; -C является псевдонимом

3227 "-o": bool | None, # Печать только совпадающих частей каждой строки

3077 "head_limit": int | None, # Ограничить вывод первыми N строками/записями3228 "head_limit": int | None, # Ограничить вывод первыми N строками/записями

3229 "offset": int | None, # Пропустить первые N строк/записей перед применением head_limit

3078 "multiline": bool | None, # Включить многострочный режим3230 "multiline": bool | None, # Включить многострочный режим

3079}3231}

3080```3232```

3081 3233

3082**Вывод (режим content):**3234**Вывод:**

3083 3235

3084```python theme={null}3236```python theme={null}

3085{3237{

3086 "matches": [3238 "mode": "content" | "files_with_matches" | "count" | None, # Использованный режим вывода

3087 {3239 "numFiles": int, # Количество файлов в результате; всегда 0 в режиме content

3088 "file": str,3240 "filenames": list[str], # Совпадающие файлы в режиме files_with_matches; пусто в других режимах

3089 "line_number": int | None,3241 "content": str | None, # Совпадающие строки в режиме content или подсчеты для каждого файла в режиме count

3090 "line": str,3242 "numLines": int | None, # Количество строк в содержимом, присутствует в режиме content

3091 "before_context": list[str] | None,3243 "numMatches": int | None, # Общее количество совпадений, присутствует в режиме count

3092 "after_context": list[str] | None,3244 "totalFiles": int | None, # Необязательное общее количество перед head_limit и offset в режиме files_with_matches

3093 }3245 "totalLines": int | None, # Необязательное общее количество перед head_limit и offset в режиме content

3094 ],3246 "appliedLimit": int | None, # Присутствует, когда head_limit усек результат

3095 "total_matches": int,3247 "appliedOffset": int | None, # Присутствует, когда был применен offset

3096}3248}

3097```3249```

3098 3250

3099**Вывод (режим files\_with\_matches):**3251Grep возвращает эту форму dict в каждом режиме вывода. Какие необязательные ключи присутствуют, зависит от `output_mode`.

3100 3252

3101```python theme={null}3253`totalFiles` требует Claude Code v2.1.208 или позже. `totalLines` требует Claude Code v2.1.210 или позже.

3102{

3103 "files": list[str], # Файлы, содержащие совпадения

3104 "count": int, # Количество файлов с совпадениями

3105}

3106```

3107 3254

3108<h3 id="notebookedit">3255<h3 id="notebookedit">

3109 NotebookEdit3256 NotebookEdit

3127 3274

3128```python theme={null}3275```python theme={null}

3129{3276{

3130 "message": str, # Сообщение об успехе3277 "new_source": str, # Исходный код, записанный в ячейку

3131 "edit_type": "replaced" | "inserted" | "deleted", # Тип выполненного редактирования3278 "old_source": str | None, # Предыдущий исходный код ячейки, присутствует для replace и delete

3132 "cell_id": str | None, # ID ячейки, которая была затронута3279 "cell_id": str | None, # ID отредактированной ячейки, когда доступно

3133 "total_cells": int, # Общее количество ячеек в записной книжке после редактирования3280 "cell_type": "code" | "markdown", # Тип ячейки

3281 "language": str, # Язык программирования записной книжки

3282 "edit_mode": str, # Использованный режим редактирования

3283 "error": str | None, # Сообщение об ошибке, когда операция не удалась

3284 "notebook_path": str, # Файл записной книжки

3285 "original_file": str, # Содержимое записной книжки перед редактированием

3286 "updated_file": str, # Содержимое записной книжки после редактирования

3134}3287}

3135```3288```

3136 3289

3228 3381

3229```python theme={null}3382```python theme={null}

3230{3383{

3231 "message": str, # Сообщение об успехе3384 "oldTodos": [ # Список задач перед обновлением

3232 "stats": {"total": int, "pending": int, "in_progress": int, "completed": int},3385 {

3386 "content": str,

3387 "status": "pending" | "in_progress" | "completed",

3388 "activeForm": str,

3389 }

3390 ],

3391 "newTodos": [ # Список задач после обновления

3392 {

3393 "content": str,

3394 "status": "pending" | "in_progress" | "completed",

3395 "activeForm": str,

3396 }

3397 ],

3233}3398}

3234```3399```

3235 3400

3401 3566

3402```python theme={null}3567```python theme={null}

3403{3568{

3404 "message": str, # Сообщение подтверждения3569 "plan": str | None, # План, который был представлен пользователю

3405 "approved": bool | None, # Одобрил ли пользователь план3570 "isAgent": bool, # True, когда подагент вызвал инструмент

3571 "filePath": str | None, # Присутствует, когда план был сохранен в файл

3572 "hasTaskTool": bool | None, # Необязательно; доступен ли инструмент Agent в текущем контексте

3573 "planWasEdited": bool | None, # Присутствует и True, когда пользователь отредактировал план перед одобрением

3574 "awaitingLeaderApproval": bool | None, # Присутствует и True, когда товарищ по команде отправил план руководителю команды на одобрение

3575 "requestId": str | None, # Необязательный ID этого запроса на одобрение

3406}3576}

3407```3577```

3408 3578

3420}3590}

3421```3591```

3422 3592

3593Результат — это список, а не dict, поэтому `tool_use_result` содержит `list` для этого инструмента.

3594

3423**Вывод:**3595**Вывод:**

3424 3596

3425```python theme={null}3597```python theme={null}

3426{3598[ # Одна запись на ресурс

3427 "resources": [

3428 {3599 {

3429 "uri": str,3600 "uri": str, # URI ресурса

3430 "name": str,3601 "name": str, # Имя ресурса

3431 "description": str | None,3602 "mimeType": str | None, # Необязательный MIME-тип

3432 "mimeType": str | None,3603 "description": str | None, # Необязательное описание

3433 "server": str,3604 "server": str, # Сервер, предоставляющий этот ресурс

3434 }3605 }

3435 ],3606]

3436 "total": int,

3437}

3438```3607```

3439 3608

3440<h3 id="readmcpresource">3609<h3 id="readmcpresource">

3457```python theme={null}3626```python theme={null}

3458{3627{

3459 "contents": [3628 "contents": [

3460 {"uri": str, "mimeType": str | None, "text": str | None, "blob": str | None}3629 {

3630 "uri": str, # URI ресурса

3631 "mimeType": str | None, # Необязательный MIME-тип

3632 "text": str | None, # Текстовое содержимое или примечание о двоичном содержимом

3633 "blobSavedTo": str | None, # Присутствует, когда Claude Code сохранил двоичное содержимое на диск; путь сохраненного файла

3634 }

3461 ],3635 ],

3462 "server": str,3636 "error": str | None, # Присутствует, когда сервер не смог прочитать ресурс

3463}3637}

3464```3638```

3465 3639

agent-sdk/typescript.md +14 −9

Details

575| `outputFormat` | `{ type: 'json_schema', schema: JSONSchema }` | `undefined` | Определите формат вывода для результатов агента. См. [Структурированные выходы](/docs/ru/agent-sdk/structured-outputs) для деталей |575| `outputFormat` | `{ type: 'json_schema', schema: JSONSchema }` | `undefined` | Определите формат вывода для результатов агента. См. [Структурированные выходы](/docs/ru/agent-sdk/structured-outputs) для деталей |

576| `outputStyle` | `string` | `undefined` | Не поле `Options`. Установите `outputStyle` в встроенном объекте [`settings`](/docs/ru/settings) или файле параметров вместо этого. См. [Активировать стиль вывода](/docs/ru/agent-sdk/modifying-system-prompts#activate-an-output-style) |576| `outputStyle` | `string` | `undefined` | Не поле `Options`. Установите `outputStyle` в встроенном объекте [`settings`](/docs/ru/settings) или файле параметров вместо этого. См. [Активировать стиль вывода](/docs/ru/agent-sdk/modifying-system-prompts#activate-an-output-style) |

577| `pathToClaudeCodeExecutable` | `string` | Автоматически разрешено из встроенного собственного двоичного файла | Путь к исполняемому файлу Claude Code. Требуется только если дополнительные зависимости были пропущены во время установки или ваша платформа не входит в поддерживаемый набор |577| `pathToClaudeCodeExecutable` | `string` | Автоматически разрешено из встроенного собственного двоичного файла | Путь к исполняемому файлу Claude Code. Требуется только если дополнительные зависимости были пропущены во время установки или ваша платформа не входит в поддерживаемый набор |

580| `permissionPrompts` | `'host' \| 'none'` | `'host'` | Кто отвечает на запросы разрешений: `'host'` маршрутизирует их на ваш обратный вызов [`canUseTool`](#canusetool) или инструмент `permissionPromptToolName`, и `'none'` [отклоняет вызовы, которые иначе запросили бы](/docs/ru/agent-sdk/permissions#how-permissions-are-evaluated). Требует Claude Code v2.1.259 или позже |580| `permissionPrompts` | `'host' \| 'none'` | `'host'` | Кто отвечает на запросы разрешений: `'host'` маршрутизирует их на ваш обратный вызов [`canUseTool`](#canusetool) или инструмент `permissionPromptToolName`, и `'none'` [отклоняет вызовы, которые иначе запросили бы](/docs/ru/agent-sdk/permissions#how-permissions-are-evaluated). Требует Claude Code v2.1.259 или позже |

712| `getContextUsage(opts?)` | Возвращает [`SDKControlGetContextUsageResponse`](#sdkcontrolgetcontextusageresponse), разбивая использование контекстного окна сеанса по категориям, навыкам и инструментам. С параметром по умолчанию `detail`, это те же данные, которые `/context` показывает в интерактивном сеансе. Параметр [`detail`](#sdkcontrolgetcontextusageresponse) требует Agent SDK v0.3.257 или позже |712| `getContextUsage(opts?)` | Возвращает [`SDKControlGetContextUsageResponse`](#sdkcontrolgetcontextusageresponse), разбивая использование контекстного окна сеанса по категориям, навыкам и инструментам. С параметром по умолчанию `detail`, это те же данные, которые `/context` показывает в интерактивном сеансе, вычисленные с запросами API подсчета токенов, которые не появляются в потоке сообщений; см. [как эти запросы обрабатываются](#sdkcontrolgetcontextusageresponse). Параметр [`detail`](#sdkcontrolgetcontextusageresponse) требует Agent SDK v0.3.257 или позже |

713| `readFile(path, options?)` | Читает файл из файловой системы сеанса. Claude Code разрешает путь против `cwd`; [Что `readFile()` может читать](#what-readfile-can-read) перечисляет файлы, которые он обслуживает. Передайте `{ maxBytes }` для изменения ограничения чтения (по умолчанию 1 МБ, потолок 10 МБ) и `{ encoding: 'base64' }` для двоичных файлов, таких как изображения. Разрешается с помощью [`SDKControlReadFileResponse`](#sdkcontrolreadfileresponse) или `null` при отказе в разрешении, отсутствующем файле или ошибке транспорта. Требует TypeScript SDK v0.2.121 или позже |713| `readFile(path, options?)` | Читает файл из файловой системы сеанса. Claude Code разрешает путь против `cwd`; [Что `readFile()` может читать](#what-readfile-can-read) перечисляет файлы, которые он обслуживает. Передайте `{ maxBytes }` для изменения ограничения чтения (по умолчанию 1 МБ, потолок 10 МБ) и `{ encoding: 'base64' }` для двоичных файлов, таких как изображения. Разрешается с помощью [`SDKControlReadFileResponse`](#sdkcontrolreadfileresponse) или `null` при отказе в разрешении, отсутствующем файле или ошибке транспорта. Требует TypeScript SDK v0.2.121 или позже |

714| `reloadPlugins(options?)` | Перезагружает плагины с диска, поэтому плагины, которые вы устанавливаете или редактируете в середине сеанса, достигают работающего сеанса. Разрешается с помощью [`SDKControlReloadPluginsResponse`](#sdkcontrolreloadpluginsresponse), перечисляющего команды, подагентов, плагины и статус MCP сервера сеанса. Требует Agent SDK v0.2.85 или позже. Параметр [`holdOnCacheImpact`](#sdkcontrolreloadpluginsresponse) требует Agent SDK v0.3.268 или позже |714| `reloadPlugins(options?)` | Перезагружает плагины с диска, поэтому плагины, которые вы устанавливаете или редактируете в середине сеанса, достигают работающего сеанса. Разрешается с помощью [`SDKControlReloadPluginsResponse`](#sdkcontrolreloadpluginsresponse), перечисляющего команды, подагентов, плагины и статус MCP сервера сеанса. Требует Agent SDK v0.2.85 или позже. Параметр [`holdOnCacheImpact`](#sdkcontrolreloadpluginsresponse) требует Agent SDK v0.3.268 или позже |

715| `reloadSkills()` | Перезагружает навыки с диска, поэтому навыки, которые вы добавляете или редактируете в середине сеанса, становятся доступны для работающего сеанса. Разрешается с помощью [`SDKControlReloadSkillsResponse`](#sdkcontrolreloadskillsresponse), перечисляющего доступные навыки после перезагрузки. Требует Agent SDK v0.3.163 или позже |715| `reloadSkills()` | Перезагружает навыки с диска, поэтому навыки, которые вы добавляете или редактируете в середине сеанса, становятся доступны для работающего сеанса. Разрешается с помощью [`SDKControlReloadSkillsResponse`](#sdkcontrolreloadskillsresponse), перечисляющего доступные навыки после перезагрузки. Требует Agent SDK v0.3.163 или позже |

716| `reloadOutputStyles()` | Повторно читает [стили вывода](/docs/ru/output-styles) с диска, поэтому файл стиля, который вы добавляете или редактируете в середине сеанса, становится доступен для работающего сеанса. Разрешается с помощью [`SDKControlReloadOutputStylesResponse`](#sdkcontrolreloadoutputstylesresponse), перечисляющего имена стилей, доступные после перезагрузки. Требует Agent SDK v0.3.261 или позже |716| `reloadOutputStyles()` | Повторно читает [стили вывода](/docs/ru/output-styles) с диска, поэтому файл стиля, который вы добавляете или редактируете в середине сеанса, становится доступен для работающего сеанса. Разрешается с помощью [`SDKControlReloadOutputStylesResponse`](#sdkcontrolreloadoutputstylesresponse), перечисляющего имена стилей, доступные после перезагрузки. Требует Agent SDK v0.3.261 или позже |

718| `reconnectMcpServer(serverName)` | Переподключить MCP сервер по имени. Если имя также совпадает с записью в файле параметров, таком как `.mcp.json` или `~/.claude.json`, Claude Code переподключает сервер, который вы настроили через [`mcpServers`](#options) или `setMcpServers()`, а не запись файла параметров. Этот порядок разрешения требует Claude Code v2.1.257 или позже |718| `reconnectMcpServer(serverName)` | Переподключить MCP сервер по имени. Если имя также совпадает с записью в файле параметров, таком как `.mcp.json` или `~/.claude.json`, Claude Code переподключает сервер, который вы настроили через [`mcpServers`](#options) или `setMcpServers()`, а не запись файла параметров. Этот порядок разрешения требует Claude Code v2.1.257 или позже |

719| `toggleMcpServer(serverName, enabled)` | Включить или отключить MCP сервер по имени с тем же разрешением имени, что и `reconnectMcpServer()`. Отключение отключает сервер |719| `toggleMcpServer(serverName, enabled)` | Включить или отключить MCP сервер по имени с тем же разрешением имени, что и `reconnectMcpServer()`. Отключение отключает сервер stdio, SSE или HTTP и удаляет его инструменты; для сервера, который вы добавили в середине сеанса с `setMcpServers()`, удаление инструментов требует Claude Code v2.1.285 или позже |

720| `setMcpServers(servers)` | Динамически замените набор MCP серверов для этого сеанса. Разрешается с помощью [`McpSetServersResult`](#mcpsetserversresult), называющего, какие серверы были добавлены и удалены, и любые ошибки |720| `setMcpServers(servers)` | Динамически замените набор MCP серверов для этого сеанса. Разрешается с помощью [`McpSetServersResult`](#mcpsetserversresult), называющего, какие серверы были добавлены и удалены, и любые ошибки |

721| `readMcpResource(serverName, uri)` | *Alpha.* Читает один MCP Apps `ui://` ресурс из подключенного MCP сервера, чтобы ваше приложение могло отобразить виджет инструмента. Разрешается с помощью [`SDKControlMcpReadResourceResponse`](#sdkcontrolmcpreadresourceresponse). Требует TypeScript Agent SDK v0.3.280 или позже |721| `readMcpResource(serverName, uri)` | *Alpha.* Читает один MCP Apps `ui://` ресурс из подключенного MCP сервера, чтобы ваше приложение могло отобразить виджет инструмента. Разрешается с помощью [`SDKControlMcpReadResourceResponse`](#sdkcontrolmcpreadresourceresponse). Требует TypeScript Agent SDK v0.3.280 или позже |

909 909

910Тип возврата [`getContextUsage()`](#query-object). С параметром по умолчанию `detail`, это та же полезная нагрузка, которую Claude Code отображает для команды `/context` в интерактивном сеансе, поэтому наряду с подсчетом токенов она содержит поля отображения, такие как `color` и `gridRows`, которые Claude Code использует для рисования сетки использования `/context`.910Тип возврата [`getContextUsage()`](#query-object). С параметром по умолчанию `detail`, это та же полезная нагрузка, которую Claude Code отображает для команды `/context` в интерактивном сеансе, поэтому наряду с подсчетом токенов она содержит поля отображения, такие как `color` и `gridRows`, которые Claude Code использует для рисования сетки использования `/context`.

911 911

912Аргумент `detail` метода выбирает, как Claude Code подсчитывает каждую категорию. С параметром по умолчанию `'full'`, Claude Code подсчитывает каждую категорию с запросами API подсчета токенов. Передайте `{ detail: 'summary' }` для получения ответа из использования последнего ответа и локальных оценок вместо этого. Никакие запросы подсчета токенов не выходят, и числа для каждой категории приблизительны. Аргумент `detail` требует Agent SDK v0.3.257 или позже.912Аргумент `detail` метода выбирает, как Claude Code подсчитывает каждую категорию. Аргумент `detail` требует Agent SDK v0.3.257 или позже.

913

914* **`'full'`**: по умолчанию. Claude Code подсчитывает каждую категорию с запросами API [подсчета токенов](https://platform.claude.com/docs/en/build-with-claude/token-counting). Эти запросы не появляются в потоке сообщений, поэтому отслеживание стоимости, которое читает поток, их не увидит. На API Anthropic подсчет токенов не выставляется счетом.

915* **`'summary'`**: передайте `{ detail: 'summary' }` для получения ответа из использования последнего ответа и локальных оценок вместо этого. Никакие запросы подсчета токенов не выходят, и числа для каждой категории приблизительны.

913 916

914Когда вы отправляете `/context` как подсказку вместо вызова метода, Claude Code прикрепляет полезную нагрузку [`SDKContextUsage`](#sdkcontextusage) к полю `context_usage` сообщения помощника, которое доставляет результат. Это поле требует Agent SDK v0.3.232 или позже.917Когда вы отправляете `/context` как подсказку вместо вызова метода, Claude Code прикрепляет полезную нагрузку [`SDKContextUsage`](#sdkcontextusage) к полю `context_usage` сообщения помощника, которое доставляет результат. Это поле требует Agent SDK v0.3.232 или позже.

915 918

1015* `memoryFiles` перечисляет каждый загруженный файл памяти с его стоимостью.1018* `memoryFiles` перечисляет каждый загруженный файл памяти с его стоимостью.

1016* `skills.skillFrontmatter` атрибутирует токены списка навыков каждому включенному навыку. Подсчеты для каждого навыка измеряют запись каждого навыка, как Claude Code фактически отправляет ее, что может быть короче полного frontmatter навыка. Сравните `skills.totalSkills` с `skills.includedSkills`, чтобы увидеть, попал ли каждый обнаруженный навык в список.1019* `skills.skillFrontmatter` атрибутирует токены списка навыков каждому включенному навыку. Подсчеты для каждого навыка измеряют запись каждого навыка, как Claude Code фактически отправляет ее, что может быть короче полного frontmatter навыка. Сравните `skills.totalSkills` с `skills.includedSkills`, чтобы увидеть, попал ли каждый обнаруженный навык в список.

1017 1020

1018`totalTokens` — это текущее использование контекста сеанса, а `maxTokens` — это окно, против которого измеряется использование. Это окно — контекстное окно модели или более низкое окно автокомпактирования, когда оно применяется. `rawMaxTokens` содержит то же значение, что и `maxTokens`, и `percentage` — это `totalTokens` как округленный процент этого окна.1021`totalTokens` — это текущее использование контекста сеанса, а `maxTokens` — это окно, против которого измеряется использование. Это окно — контекстное окно модели или более низкое окно автокомпактирования, когда оно применяется. `rawMaxTokens` содержит то же значение, что и `maxTokens`, и `percentage` — это `totalTokens` как округленный процент этого окна. `apiUsage` содержит использование из последнего ответа API, а не итоговое значение для сеанса.

1019 1022

1020Claude Code оставляет дополнительные диагностики `deferredBuiltinTools`, `systemTools` и `systemPromptSections` неустановленными, поэтому ожидайте их отсутствия, даже если тип их объявляет.1023Claude Code оставляет дополнительные диагностики `deferredBuiltinTools`, `systemTools` и `systemPromptSections` неустановленными, поэтому ожидайте их отсутствия, даже если тип их объявляет.

1021 1024

1275 | "bypassPermissions" // Bypass permission checks; explicit ask rules still prompt1278 | "bypassPermissions" // Bypass permission checks; explicit ask rules still prompt

1276 | "plan" // Planning mode - explore without editing1279 | "plan" // Planning mode - explore without editing

1277 | "dontAsk" // Don't prompt for permissions, deny if not pre-approved1280 | "dontAsk" // Don't prompt for permissions, deny if not pre-approved

1278 | "auto"; // Model classifier approves or denies permission prompts1281 | "auto"; // A model classifier reviews actions such as shell commands and network requests

1279```1282```

1280 1283

1281<h3 id="canusetool">1284<h3 id="canusetool">

1821```typescript theme={null}1824```typescript theme={null}

1822type SDKStartupFailureReason =1825type SDKStartupFailureReason =

1823 | "org_pin_api_key_conflict"1826 | "org_pin_api_key_conflict"

1827 | "provider_not_allowed"

1824 | "org_verify_failed"1828 | "org_verify_failed"

1825 | "org_pin_mismatch"1829 | "org_pin_mismatch"

1826 | "managed_settings_invalid"1830 | "managed_settings_invalid"

1843| Значение | Что остановило сеанс |1847| Значение | Что остановило сеанс |

1844| :- | :- |1848| :- | :- |

1845| `org_pin_api_key_conflict` | Управляемые параметры [требуют вход в первую сторону или облачный шлюз](/docs/ru/authentication#restrict-login-to-your-organization), и вместо этого настроены ключ API Anthropic, токен аутентификации или `apiKeyHelper` |1849| `org_pin_api_key_conflict` | Управляемые параметры [требуют вход в первую сторону или облачный шлюз](/docs/ru/authentication#restrict-login-to-your-organization), и вместо этого настроены ключ API Anthropic, токен аутентификации или `apiKeyHelper` |

1850| `provider_not_allowed` | Управляемые параметры [перечисляют поставщиков API, которых эта машина может использовать](/docs/ru/settings-reference#allowedproviders), и сеанс настроен для поставщика, который не указан в списке, или для конечной точки, которую параметры не закрепляют. Требует Claude Code v2.1.285 или позже |

1846| `org_verify_failed` | Организация входа не смогла быть проверена против булавки, например из-за сбоя сети или отозванного токена |1851| `org_verify_failed` | Организация входа не смогла быть проверена против булавки, например из-за сбоя сети или отозванного токена |

1848| `managed_settings_invalid` | Управляемые параметры политики не смогли быть прочитаны, булавка не называет организацию, или [управляемые ограничения модели](/docs/ru/errors#managed-settings-block-the-default-model) не оставляют разрешённую модель для опции Default |1853| `managed_settings_invalid` | Управляемые параметры политики не смогли быть прочитаны, булавка не называет организацию, или [управляемые ограничения модели](/docs/ru/errors#managed-settings-block-the-default-model) не оставляют разрешённую модель для опции Default |

2092 `SDKContextUsage`2097 `SDKContextUsage`

2093</h3>2098</h3>

2094 2099

2095Структурированная форма отчёта `/context`, переносимая как `context_usage` на [`SDKAssistantMessage`](#sdkassistantmessage), который доставляет результат `/context`. Agent SDK v0.3.232 и позже экспортируют тип. В отличие от [`SDKControlGetContextUsageResponse`](#sdkcontrolgetcontextusageresponse), он содержит только данные, необходимые для отображения разбивки использования, без полей отображения, таких как `color` и `gridRows`.2100Структурированная форма отчёта `/context`, переносимая как `context_usage` на [`SDKAssistantMessage`](#sdkassistantmessage), который доставляет результат `/context`. Agent SDK v0.3.232 и позже экспортируют тип. В отличие от [`SDKControlGetContextUsageResponse`](#sdkcontrolgetcontextusageresponse), он содержит только данные, необходимые для отображения разбивки использования, без полей отображения, таких как `color` и `gridRows`. Claude Code вычисляет отчёт с помощью запросов API подсчёта токенов, которые не появляются в потоке сообщений; см. [как эти запросы обрабатываются](#sdkcontrolgetcontextusageresponse).

2096 2101

2097```typescript theme={null}2102```typescript theme={null}

2098type SDKContextUsage = {2103type SDKContextUsage = {

3209};3214};

3210```3215```

3211 3216

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

3213 3218

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

3215 Monitor3220 Monitor

4113 4118

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

4115 4120

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

4117 4122

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

4119 4124

agent-view.md +2 −20

Details

8 8

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

10 10

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

12 12

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

14 14

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

16 16

958 958

959Claude Code никогда не перезапускает строку, работающую [команду оболочки](#run-a-shell-command), из `Enter` или из `claude attach`, потому что это запустит команду снова; сообщение строки и `claude attach` оба говорят, что команда не запускается снова.959Claude Code никогда не перезапускает строку, работающую [команду оболочки](#run-a-shell-command), из `Enter` или из `claude attach`, потому что это запустит команду снова; сообщение строки и `claude attach` оба говорят, что команда не запускается снова.

960 960

961<h4 id="terminal-host-died">

962 Хост терминала умер

963</h4>

~~964~~

965На Linux и WSL супервизор проверяет каждый хост-процесс каждые несколько секунд, открыт ли вы сеанс или нет, и отмечает сеанс как неудачный, когда процесс завершился, но его соединение с супервизором никогда не закрывалось.

~~966~~

967* В представлении агентов строка показывает `terminal host process died — press Enter to restart`. Нажмите `Enter` на ней, и Claude Code перезапустит сеанс на свежем хост-процессе.

968* Из оболочки `claude attach <id>` перезапускает сеанс, уже отмеченный как неудачный. В противном случае он сообщает причину и выходит, говоря вам запустить `claude attach <id>` снова.

~~969~~

970<h4 id="session-isn’t-responding">

971 Сеанс не отвечает

972</h4>

~~973~~

974Когда супервизор принимает открытие, но никакой вывод не поступает примерно десять секунд, Claude Code завершает попытку и предлагает перезагрузку. Сеанс, который просто зависает, например при переходе машины в спящий режим, не достигает этого предложения: супервизор [перезапускает его при открытии](#read-session-state) сам.

~~975~~

976* В представлении агентов нижний колонтитул показывает `Press enter again to restart this session — it isn't responding (its conversation is saved and resumes).` Нажмите `Enter` на той же строке снова, и Claude Code остановит неответивший процесс и перезапустит сеанс; он ничего не останавливает без этого второго нажатия.

977* Из оболочки `claude attach <id>` сообщает причину и выходит, говоря вам запустить `claude stop <id>`, затем `claude attach <id>`.

~~978~~

979<h3 id="a-session-fails-before-starting-with-a-possibly-low-memory-note">961<h3 id="a-session-fails-before-starting-with-a-possibly-low-memory-note">

980 Сеанс не запускается с примечанием `possibly low memory`962 Сеанс не запускается с примечанием `possibly low memory`

981</h3>963</h3>

amazon-bedrock.md +12 −0

Details

384 384

385Псевдонимы моделей, такие как `opus`, не действуют как закрепления, и также не действует ID модели, который Claude Code не распознаёт, например ARN профиля вывода приложения.385Псевдонимы моделей, такие как `opus`, не действуют как закрепления, и также не действует ID модели, который Claude Code не распознаёт, например ARN профиля вывода приложения.

386 386

387Когда эти проверки находят модель, которую ваша учётная запись не может вызвать, Claude Code запоминает отказ на этом компьютере на срок до одного дня, и при запуске в течение этого времени пропускает запомненную модель без повторного обращения к Amazon Bedrock. Claude Code проверяет запомненный отказ текущей модели по умолчанию снова при запуске один раз через десять минут после последней проверки, поэтому значение по умолчанию, которое ваш администратор повторно включит, вернётся. Чтобы отключить память, установите [`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](/docs/ru/env-vars).

388

389<h3 id="when-a-model-is-disabled-mid-session">

390 Когда модель отключена во время сеанса

391</h3>

392

393Если ваша учётная запись потеряет доступ к модели, на которой работает ваш сеанс, например потому что администратор отключит её в вашей учётной записи Amazon Bedrock, Claude Code переключает сеанс на другую модель вместо того, чтобы не выполнять каждый запрос, и показывает `Switched to <fallback> because <model> is not available`. Он пытается использовать те же модели, что и резервный вариант при запуске: сначала более ранние версии того же уровня и, для сеанса Opus без доступной версии Opus, модель Sonnet по умолчанию.

394

395Переключение применяется только к уровню, который вы не закрепили, то же условие, что и резервный вариант при запуске. Сеанс на конкретной версии, которую вы выбрали, или на [ARN профиля вывода приложения](#map-each-model-version-to-an-inference-profile), сохраняет свою модель и, без цепочки резервных моделей, запрос не выполняется. В [режиме auto](/docs/ru/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry) Claude Code переключается только на модель, которую режим auto поддерживает на Amazon Bedrock. Если ни одна из этих моделей также недоступна, запрос не выполняется с ошибкой [AWS authentication failed](/docs/ru/errors#aws-authentication-failed) и подсказкой для включения модели.

396

397[Цепочка резервных моделей](/docs/ru/model-config#fallback-model-chains), которую вы настраиваете, заменяет переключение уровня: при этих отказах Claude Code переключается на ваш настроенный резервный вариант. Чтобы отклонённые запросы не выполнялись вместо переключения, установите [`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](/docs/ru/env-vars). Цепочка резервных моделей, которую вы настроили, всё ещё переключается при этих отказах; удалите цепочку также, если вы хотите, чтобы каждый отклонённый запрос не выполнялся.

398

387<h2 id="cross-region-inference-profile-prefixes">399<h2 id="cross-region-inference-profile-prefixes">

388 Префиксы профилей кросс-региональной инференции400 Префиксы профилей кросс-региональной инференции

389</h2>401</h2>

artifacts.md +1 −1

Details

400 400

401После того как вы отключите артефакты в файле [`--settings`](/docs/ru/cli-reference#cli-flags) или с помощью `CLAUDE_CODE_DISABLE_ARTIFACT`, или ваш администратор отключит их в [управляемых параметрах](/docs/ru/server-managed-settings), ни один файл параметров не включит их обратно. До версии v2.1.242 файл, расположенный выше в [стеке приоритетов](/docs/ru/settings#settings-precedence), мог включить артефакты обратно, даже если файл с более низким приоритетом установил `"enableArtifact": false`.401После того как вы отключите артефакты в файле [`--settings`](/docs/ru/cli-reference#cli-flags) или с помощью `CLAUDE_CODE_DISABLE_ARTIFACT`, или ваш администратор отключит их в [управляемых параметрах](/docs/ru/server-managed-settings), ни один файл параметров не включит их обратно.

402 402

403Вы также можете установить `"enableArtifact": false` в файле `.claude/settings.json` или `.claude/settings.local.json` проекта, чтобы отключить артефакты для сеансов в этом проекте. Параметр `"enableArtifact": true` в любом из этих файлов не включит их обратно. Поддержка этого ключа в параметрах проекта и локальных параметрах требует Claude Code версии 2.1.242 или более поздней.403Вы также можете установить `"enableArtifact": false` в файле `.claude/settings.json` или `.claude/settings.local.json` проекта, чтобы отключить артефакты для сеансов в этом проекте. Параметр `"enableArtifact": true` в любом из этих файлов не включит их обратно. Поддержка этого ключа в параметрах проекта и локальных параметрах требует Claude Code версии 2.1.242 или более поздней.

404 404

authentication.md +51 −31

Details

50 Настройка аутентификации команды50 Настройка аутентификации команды

51</h2>51</h2>

52 52

~~53Для команд и организаций вы можете настроить доступ Claude Code одним из следующих способов:~~53Для команд и организаций вы можете настроить доступ к Claude Code одним из следующих способов:

54 54

55* [Claude for Teams или Enterprise](#claude-for-teams-or-enterprise), рекомендуется для большинства команд55* [Claude for Teams или Enterprise](#claude-for-teams-or-enterprise), рекомендуется для большинства команд

56* [Claude Console](#claude-console-authentication)56* [Claude Console](#claude-console-authentication)

57* [Claude apps gateway](/docs/ru/claude-apps-gateway), самостоятельно размещаемый шлюз, который подписывает разработчиков с помощью вашего IdP и маршрутизирует вывод к облачному провайдеру, который вы настраиваете57* [Claude apps gateway](/docs/ru/claude-apps-gateway), самостоятельно размещаемый шлюз, который подписывает разработчиков с помощью вашего IdP и маршрутизирует вывод на облачного провайдера, который вы настраиваете

58* [Amazon Bedrock](/docs/ru/amazon-bedrock)58* [Amazon Bedrock](/docs/ru/amazon-bedrock)

59* [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai)59* [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai)

60* [Microsoft Foundry](/docs/ru/microsoft-foundry)60* [Microsoft Foundry](/docs/ru/microsoft-foundry)

65 65

66[Claude for Teams](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_teams#team-&-enterprise) и [Claude for Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_enterprise) обеспечивают лучший опыт для организаций, использующих Claude Code. Члены команды получают доступ как к Claude Code, так и к Claude в веб-версии с централизованным выставлением счетов и управлением командой.66[Claude for Teams](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_teams#team-&-enterprise) и [Claude for Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_enterprise) обеспечивают лучший опыт для организаций, использующих Claude Code. Члены команды получают доступ как к Claude Code, так и к Claude в веб-версии с централизованным выставлением счетов и управлением командой.

67 67

68* **Claude for Teams**: план самообслуживания с функциями сотрудничества, инструментами администратора, SSO, управлением выставлением счетов и [параметрами, управляемыми сервером](/docs/ru/server-managed-settings) для конфигурации Claude Code на уровне организации. Лучше всего подходит для небольших команд.68* **Claude for Teams**: самостоятельный план с функциями сотрудничества, инструментами администратора, SSO, управлением выставлением счетов и [параметрами, управляемыми сервером](/docs/ru/server-managed-settings) для конфигурации Claude Code на уровне организации. Лучше всего подходит для небольших команд.

69* **Claude for Enterprise**: добавляет захват домена, разрешения на основе ролей и API соответствия. Лучше всего подходит для крупных организаций с требованиями безопасности и соответствия.69* **Claude for Enterprise**: добавляет захват домена, разрешения на основе ролей и API соответствия. Лучше всего подходит для крупных организаций с требованиями безопасности и соответствия.

70 70

71<Steps>71<Steps>

~~72 <Step title="Подпишитесь">~~72 <Step title="Подписка">

73 Подпишитесь на [Claude for Teams](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_teams_step#team-&-enterprise) или свяжитесь с отделом продаж для [Claude for Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_enterprise_step).73 Подпишитесь на [Claude for Teams](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_teams_step#team-&-enterprise) или свяжитесь с отделом продаж для [Claude for Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_enterprise_step).

74 </Step>74 </Step>

75 75

~~76 <Step title="Пригласите членов команды">~~76 <Step title="Пригласить членов команды">

77 Пригласите членов команды из панели администратора.77 Пригласите членов команды из панели администратора.

78 </Step>78 </Step>

79 79

~~80 <Step title="Установите и войдите">~~80 <Step title="Установка и вход">

~~81 Члены команды устанавливают Claude Code и входят с помощью своих учетных записей claude.ai.~~81 Члены команды устанавливают Claude Code и входят со своими учетными записями claude.ai.

82 </Step>82 </Step>

83</Steps>83</Steps>

84 84

85<h3 id="claude-console-authentication">85<h3 id="claude-console-authentication">

~~86 Claude Console authentication~~86 Claude Console аутентификация

87</h3>87</h3>

88 88

89Для организаций, которые предпочитают выставление счетов на основе API, вы можете настроить доступ через Claude Console.89Для организаций, которые предпочитают выставление счетов на основе API, вы можете настроить доступ через Claude Console.

90 90

91<Steps>91<Steps>

~~92 <Step title="Создайте или используйте учетную запись Console">~~92 <Step title="Создать или использовать учетную запись Console">

93 Используйте существующую учетную запись Claude Console или создайте новую.93 Используйте существующую учетную запись Claude Console или создайте новую.

94 </Step>94 </Step>

95 95

~~96 <Step title="Добавьте пользователей">~~96 <Step title="Добавить пользователей">

~~97 Вы можете добавлять пользователей любым из следующих способов:~~97 Вы можете добавить пользователей одним из двух способов:

98 98

99 * Массовое приглашение пользователей из Console: Settings -> Members -> Invite99 * Массовое приглашение пользователей из Console: Settings -> Members -> Invite

100 * [Настройте SSO](https://support.claude.com/en/articles/13132885-setting-up-single-sign-on-sso)100 * [Настройка SSO](https://support.claude.com/en/articles/13132885-setting-up-single-sign-on-sso)

101 </Step>101 </Step>

102 102

103 <Step title="Назначьте роли">103 <Step title="Назначить роли">

104 При приглашении пользователей назначьте одну из следующих ролей:104 При приглашении пользователей назначьте одну из следующих ролей:

105 105

106 * **Claude Code** роль: пользователи могут создавать только ключи API Claude Code106 * **Claude Code** роль: пользователи могут создавать только ключи API Claude Code

118</Steps>118</Steps>

119 119

120<h4 id="sign-in-without-an-api-key">120<h4 id="sign-in-without-an-api-key">

121 Sign in without an API key121 Вход без ключа API

122</h4>122</h4>

123 123

124Вы можете войти в свою учетную запись Console без создания ключа API, даже если ваша организация не позволяет разработчикам их создавать. Выберите учетную запись Anthropic Console в приглашении `/login` и Claude Code спросит, как вы хотите войти. Требуется Claude Code v2.1.242 или позже. Оба маршрута подписывают вас в Console в браузере и отличаются тем, что Claude Code сохраняет впоследствии:124Вы можете войти в свою учетную запись Console без создания ключа API, даже если ваша организация не позволяет разработчикам их создавать. Выберите учетную запись Anthropic Console в приглашении `/login` и Claude Code спросит, как вы хотите войти. Требуется Claude Code v2.1.242 или позже. Оба маршрута подписывают вас в Console в браузере и отличаются тем, что Claude Code сохраняет впоследствии:

125 125

126* **Вход с помощью вашей учетной записи Console**, помечено как `(рекомендуется)`: Claude Code сохраняет токен OAuth из этого входа и сохраняет его как [профиль Anthropic](#anthropic-profiles-and-federation-credentials). Он не создает ключ API126* **Вход с вашей учетной записью Console**, помечено как `(recommended)`: Claude Code сохраняет токен OAuth из этого входа и сохраняет его как [профиль Anthropic](#anthropic-profiles-and-federation-credentials). Он не создает ключ API

127* **Создать ключ API**, помечено как `(устаревший)`: Claude Code создает для вас ключ API Console и сохраняет его с вашими другими учетными данными127* **Создать ключ API**, помечено как `(legacy)`: Claude Code создает ключ API Console для вас и сохраняет его с вашими другими учетными данными

128 128

129На практике профиль хранит вход OAuth, а ключ API — это статические учетные данные: Claude Code автоматически обновляет вход профиля, и когда обновление не удается, запросы не выполняются с [истекшим входом профиля Anthropic](/docs/ru/errors#anthropic-profile-login-expired) до тех пор, пока вы снова не войдете.129На практике профиль хранит вход OAuth, а ключ API — это статические учетные данные: Claude Code автоматически обновляет вход профиля, и когда обновление не удается, запросы не выполняются с [истекшим входом профиля Anthropic](/docs/ru/errors#anthropic-profile-login-expired) до тех пор, пока вы снова не войдете.

130 130

131Вы не получаете выбор на каждой машине. Claude Code создает ключ API без запроса в этих случаях:131Вы не получаете выбор на каждой машине. Claude Code создает ключ API без запроса в этих случаях:

132 132

133* Вы работаете с облачным провайдером, таким как [Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry](/docs/ru/third-party-integrations) или [Claude Platform на AWS](/docs/ru/claude-platform-on-aws)133* Вы работаете с облачным провайдером, таким как [Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry](/docs/ru/third-party-integrations) или [Claude Platform on AWS](/docs/ru/claude-platform-on-aws)

134* Любой файл параметров устанавливает [`forceLoginOrgUUID`](#restrict-login-to-your-organization), или устанавливает `forceLoginMethod` на `"claudeai"` или `"console"`134* Любой файл параметров устанавливает [`forceLoginOrgUUID`](#restrict-login-to-your-organization), или устанавливает `forceLoginMethod` на `"claudeai"` или `"console"`

135* На вашей машине существует управляемый источник параметров, такой как файл управляемых параметров, профиль MDM или кэшированные параметры, управляемые сервером, но Claude Code [не может его прочитать](/docs/ru/managed-settings#invalid-entries-in-managed-settings) и никакой другой управляемый источник не предоставляет политику135* На вашей машине существует источник управляемых параметров, такой как файл управляемых параметров, профиль MDM или кэшированные параметры, управляемые сервером, но Claude Code [не может его прочитать](/docs/ru/managed-settings#invalid-entries-in-managed-settings) и никакой другой управляемый источник не предоставляет политику

136 136

137Отмените установку `ANTHROPIC_API_KEY` перед входом без ключа.137Отмените установку `ANTHROPIC_API_KEY` перед входом без ключа.

138 138

147Все остальное о профилях применяется к этому входу, включая его ранжирование по сравнению с вашими другими учетными данными, строку `Profile`, которую вы получаете в `/status`, и функции, которые требуют входа claude.ai. См. [Профили Anthropic и учетные данные федерации](#anthropic-profiles-and-federation-credentials).147Все остальное о профилях применяется к этому входу, включая его ранжирование по сравнению с вашими другими учетными данными, строку `Profile`, которую вы получаете в `/status`, и функции, которые требуют входа claude.ai. См. [Профили Anthropic и учетные данные федерации](#anthropic-profiles-and-federation-credentials).

148 148

149<h3 id="cloud-provider-authentication">149<h3 id="cloud-provider-authentication">

150 Cloud provider authentication150 Аутентификация облачного провайдера

151</h3>151</h3>

152 152

153Для команд, использующих Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry:153Для команд, использующих Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry:

157 Следуйте [документации Amazon Bedrock](/docs/ru/amazon-bedrock), [документации Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) или [документации Microsoft Foundry](/docs/ru/microsoft-foundry).157 Следуйте [документации Amazon Bedrock](/docs/ru/amazon-bedrock), [документации Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) или [документации Microsoft Foundry](/docs/ru/microsoft-foundry).

158 </Step>158 </Step>

159 159

160 <Step title="Распределите конфигурацию">160 <Step title="Распределить конфигурацию">

161 Распределите переменные окружения и инструкции по созданию облачных учетных данных среди ваших пользователей. Узнайте больше о том, как [управлять конфигурацией здесь](/docs/ru/settings).161 Распределите переменные окружения и инструкции по созданию облачных учетных данных вашим пользователям. Узнайте больше о том, как [управлять конфигурацией здесь](/docs/ru/settings).

162 </Step>162 </Step>

163 163

164 <Step title="Установите Claude Code">164 <Step title="Установить Claude Code">

165 Пользователи могут [установить Claude Code](/docs/ru/setup#install-claude-code).165 Пользователи могут [установить Claude Code](/docs/ru/setup#install-claude-code).

166 </Step>166 </Step>

167</Steps>167</Steps>

168 168

169<h3 id="restrict-login-to-your-organization">169<h3 id="restrict-login-to-your-organization">

170 Restrict login to your organization170 Ограничить вход в вашу организацию

171</h3>171</h3>

172 172

173Чтобы требовать, чтобы входы claude.ai разработчиков принадлежали определенной организации Anthropic, установите [`forceLoginMethod`](/docs/ru/settings-reference#forceloginmethod) и [`forceLoginOrgUUID`](/docs/ru/settings-reference#forceloginorguuid) в [управляемых параметрах](/docs/ru/managed-settings). Установите `forceLoginOrgUUID` на ваш ID организации, показанный в [параметрах администратора claude.ai](https://claude.ai/admin-settings/organization) для организаций Claude for Teams или Enterprise. Claude Code сообщает об ошибке для входа claude.ai в любую другую организацию и выходит при запуске, если учетные данные claude.ai в использовании принадлежат организации, которая не указана в списке.173Чтобы требовать, чтобы входы claude.ai разработчиков принадлежали определенной организации Anthropic, установите [`forceLoginMethod`](/docs/ru/settings-reference#forceloginmethod) и [`forceLoginOrgUUID`](/docs/ru/settings-reference#forceloginorguuid) в [управляемых параметрах](/docs/ru/managed-settings). Установите `forceLoginOrgUUID` на ваш ID организации, показанный в [параметрах администратора claude.ai](https://claude.ai/admin-settings/organization) для организаций Claude for Teams или Enterprise. Claude Code сообщает об ошибке для входа claude.ai в любую другую организацию и выходит при запуске, если используемые учетные данные claude.ai принадлежат организации, которая не указана в списке.

174 174

175Для входов Claude Console, Claude Code использует `forceLoginOrgUUID` для предварительного выбора организации на странице входа Console, когда вы устанавливаете его на один ID организации Console, показанный на [platform.claude.com/settings/organization](https://platform.claude.com/settings/organization). Он не проверяет, какой организации принадлежат полученные учетные данные Console, при входе или при запуске. Разработчик, который вошел с учетной записью Console до развертывания ключей, остается в системе, и этот сохраненный ключ блокируется на машине, которая также требует [вход через шлюз](/docs/ru/claude-apps-gateway) или в сеансе, который выбирает облачного провайдера.175Для входов Claude Console, Claude Code использует `forceLoginOrgUUID` для предварительного выбора организации на странице входа Console, когда вы устанавливаете его на один ID организации Console, показанный на [platform.claude.com/settings/organization](https://platform.claude.com/settings/organization). Он не проверяет, какой организации принадлежат полученные учетные данные Console, при входе или при запуске. Разработчик, который вошел с учетной записью Console до развертывания ключей, остается в системе, и этот сохраненный ключ блокируется на машине, которая также требует входа [шлюза](/docs/ru/claude-apps-gateway) или в сеансе, который выбирает облачного провайдера.

176 176

177Если вы установите `forceLoginOrgUUID` в любом файле параметров, Claude Code прекратит предлагать [вход в Console без ключа](#sign-in-without-an-api-key) в сеансах, к которым применяется этот файл, и вместо этого создаст ключ API. Чтобы направить разработчиков на вход claude.ai, установите `forceLoginMethod` на `"claudeai"`.177Если вы установите `forceLoginOrgUUID` в любом файле параметров, Claude Code прекратит предлагать [вход в Console без ключа](#sign-in-without-an-api-key) в сеансах, к которым применяется этот файл, и вместо этого создаст ключ API. Чтобы направить разработчиков на вход claude.ai, установите `forceLoginMethod` на `"claudeai"`.

178 178

182 182

183* **Входы терминала, [расширения VS Code](/docs/ru/vs-code) и Agent SDK**: проверяют `forceLoginOrgUUID` для входов учетной записи claude.ai183* **Входы терминала, [расширения VS Code](/docs/ru/vs-code) и Agent SDK**: проверяют `forceLoginOrgUUID` для входов учетной записи claude.ai

184* **`claude setup-token` и `/install-github-app`**: применяют только `forceLoginMethod`, поэтому они могут создать токен в другой организации184* **`claude setup-token` и `/install-github-app`**: применяют только `forceLoginMethod`, поэтому они могут создать токен в другой организации

185* **[Вход через шлюз](/docs/ru/claude-apps-gateway)**: выбран `forceLoginMethod: "gateway"` вместо ограничения им, и не аутентифицируется против организации Anthropic, поэтому `forceLoginOrgUUID` не применяется; используйте поставщика идентификации вашего шлюза для ограничения доступа185* **Вход [шлюза](/docs/ru/claude-apps-gateway)**: выбирается `forceLoginMethod: "gateway"` вместо ограничения им, и не аутентифицируется против организации Anthropic, поэтому `forceLoginOrgUUID` не применяется; используйте поставщика удостоверений вашего шлюза для ограничения доступа

186 186

187Развертывайте ключи через инструменты управления устройствами. [Параметры, управляемые сервером](/docs/ru/server-managed-settings), достигают только учетных записей, которые уже аутентифицированы в вашей организации, поэтому они не могут перенаправить первый вход разработчика. Если ваша организация также распределяет параметры, управляемые сервером, установите ключи в обоих местах: управляемые источники параметров [не объединяются](/docs/ru/server-managed-settings#settings-precedence), и кэшированные параметры, управляемые сервером, заменяют файл, управляемый устройством, за исключением нескольких [исключений для каждого ключа](/docs/ru/server-managed-settings#per-key-exceptions-across-managed-sources). `forceLoginOrgUUID` и значения `"claudeai"` и `"console"` `forceLoginMethod` не входят в эти исключения, поэтому держите их в обоих местах.187Развертывайте ключи через инструменты управления устройствами. [Параметры, управляемые сервером](/docs/ru/server-managed-settings), достигают только учетных записей, которые уже аутентифицированы в вашей организации, поэтому они не могут перенаправить первый вход разработчика. Если ваша организация также распределяет параметры, управляемые сервером, установите ключи в обоих местах: управляемые источники [не объединяются](/docs/ru/server-managed-settings#settings-precedence), и кэшированные параметры, управляемые сервером, заменяют файл, управляемый устройством, за исключением нескольких [исключений для каждого ключа](/docs/ru/server-managed-settings#per-key-exceptions-across-managed-sources). `forceLoginOrgUUID` и значения `"claudeai"` и `"console"` `forceLoginMethod` не входят в эти исключения, поэтому держите их в обоих местах.

188 188

189В развертывании [шлюза](/docs/ru/claude-apps-gateway) также держите `forceLoginMethod` и `forceLoginOrgUUID` вне [параметров, которые служит шлюз](/docs/ru/claude-apps-gateway-config#managed).189При развертывании [шлюза](/docs/ru/claude-apps-gateway) также держите `forceLoginMethod` и `forceLoginOrgUUID` вне [параметров, которые служит шлюз](/docs/ru/claude-apps-gateway-config#managed).

190 190

191Ключи также определяют, может ли сеанс, который не использует учетные данные входа, начаться. См. [`forceLoginOrgUUID`](/docs/ru/settings-reference#forceloginorguuid) в справочнике параметров для полного поведения.191Ключи также определяют, может ли сеанс, который не использует учетные данные входа, начаться. См. [`forceLoginOrgUUID`](/docs/ru/settings-reference#forceloginorguuid) в справочнике параметров для полного поведения.

192 192

193* **`ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`**: заблокированы при запуске. При `forceLoginOrgUUID` членство в организации не может быть проверено для учетных данных окружения, и при `forceLoginMethod` учетные данные будут стоять вместо требуемого входа. Когда управляемые параметры также требуют [вход через шлюз](/docs/ru/claude-apps-gateway), Claude Code блокирует ключ API, сохраненный более ранним входом Claude Console, таким же образом. См. [Политика администратора требует вход через облачный шлюз](/docs/ru/errors#administrator-policy-requires-a-cloud-gateway-sign-in)193* **`ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`**: заблокировано при запуске. При `forceLoginOrgUUID` членство в организации не может быть проверено для учетных данных окружения, и при `forceLoginMethod` учетные данные будут служить вместо требуемого входа. Когда управляемые параметры также требуют входа [шлюза](/docs/ru/claude-apps-gateway), Claude Code блокирует ключ API, сохраненный более ранним входом Claude Console, таким же образом. См. [Политика администратора требует входа облачного шлюза](/docs/ru/errors#administrator-policy-requires-a-cloud-gateway-sign-in)

194* **Сеансы облачного провайдера, такие как Amazon Bedrock**: заблокированы только пока учетные данные `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, или ключ API, сохраненный более ранним входом Claude Console, все еще присутствуют на машине. Удалите его и сеанс начнется. Эти сеансы аутентифицируются против вашего облачного провайдера, политики доступа которого их регулируют194* **Сеансы облачного провайдера, такие как Amazon Bedrock**: блокируются только при наличии учетных данных `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, или ключа API, сохраненного более ранним входом Claude Console, на машине. Удалите его и сеанс начнется. Эти сеансы аутентифицируются против вашего облачного провайдера, политики доступа которого их регулируют

195* **[Профиль Anthropic или учетные данные федерации](#anthropic-profiles-and-federation-credentials)**: не заблокированы, если только учетные данные `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, или ключ API, сохраненный более ранним входом Claude Console, также не присутствуют на машине. Удалите его и сеанс начнется. Ключи не проверяют, какой организации принадлежит профиль195* **[Профиль Anthropic или учетные данные федерации](#anthropic-profiles-and-federation-credentials)**: не блокируются, если только учетные данные `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, или ключ API, сохраненный более ранним входом Claude Console, также не присутствуют на машине. Ключи не проверяют, какой организации принадлежит профиль

196

197<h3 id="restrict-which-api-providers-a-machine-may-use">

198 Ограничить, какие поставщики API может использовать машина

199</h3>

200

201[`allowedProviders`](/docs/ru/settings-reference#allowedproviders) в [управляемых параметрах](/docs/ru/managed-settings) перечисляет, какие сервисы управляемая машина может использовать для доступа к Claude, такие как Anthropic API, Amazon Bedrock или шлюз LLM. Он дополняет `forceLoginMethod` и `forceLoginOrgUUID`, которые управляют тем, какую учетную запись использует сеанс при разговоре с Anthropic. Требуется Claude Code v2.1.285 или позже.

202

203```json managed-settings.json theme={null}

204{

205 "forceLoginMethod": "claudeai",

206 "forceLoginOrgUUID": ["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"],

207 "allowedProviders": ["anthropic", "bedrock"]

208}

209```

210

211С этим файлом разработчик, вошедший в вашу организацию claude.ai или настроенный для Amazon Bedrock, запускается нормально. Сеанс, настроенный для любого другого провайдера, отказывается при запуске, и работающий сеанс, который переключается на один, отказывается при следующем запросе. [Управляемые параметры не позволяют этому поставщику API](/docs/ru/errors#managed-settings-dont-allow-this-api-provider) показывает каждое сообщение.

212

213* **Разрешить шлюз LLM или прокси**: перечислите `"customEndpoint"` и установите URL шлюза в управляемом блоке `env` того же источника. [Справочник параметров](/docs/ru/settings-reference#allowedproviders) перечисляет каждое значение и говорит, какие переменные конечной точки требуют управляемого закрепления `env`.

214* **Развертывание на управляемых машинах**: поместите список в управляемый источник, который несет остальную часть вашей политики. Примечание [Scope](/docs/ru/settings-reference#allowedproviders) записи говорит, как управляемый список сервера объединяется с ним.

215* **Только параметры, управляемые сервером**: список, который вы устанавливаете только в [параметрах, управляемых сервером](/docs/ru/server-managed-settings), достигает только сеансов, которые получают параметры вашей организации, поэтому рассматривайте его как удобство для машин, которые вы не можете достичь с помощью управления устройствами, а не как принудительное применение. [Доступность платформы](/docs/ru/server-managed-settings#platform-availability) перечисляет, какие сеансы их получают.

196 216

197<h2 id="credential-management">217<h2 id="credential-management">

198 Управление учетными данными218 Управление учетными данными

auto-mode-config.md +2 −6

Details

285 Редактирование правил из `/permissions`285 Редактирование правил из `/permissions`

286</h2>286</h2>

287 287

288Чтобы просмотреть и отредактировать правила классификатора без открытия файла параметров, запустите [`/permissions`](/docs/ru/permissions#manage-permissions) и выберите вкладку **Auto mode**. Вкладка требует Claude Code версии 2.1.246 или более поздней версии и появляется только когда [автоматический режим доступен](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) для вашей сессии.288Чтобы просмотреть и отредактировать правила классификатора и записи `environment` без открытия файла параметров, запустите [`/permissions`](/docs/ru/permissions#manage-permissions) и выберите вкладку **Auto mode**. Вкладка требует Claude Code версии 2.1.246 или более поздней версии и появляется только когда [автоматический режим доступен](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) для вашей сессии.

289 289

290На вкладке отображаются записи `allow`, `soft_deny`, `hard_deny` и `environment` из каждой из [областей, которые читает классификатор](#where-the-classifier-reads-configuration), и показывается, действуют ли встроенные правила для каждого раздела. Claude Code показывает записи из [управляемых параметров](/docs/ru/server-managed-settings) или флага `--settings` как доступные только для чтения и сохраняет каждое внесённое вами изменение на вкладке в `~/.claude/settings.json`. На вкладке вы можете:290Claude Code показывает записи из [управляемых параметров](/docs/ru/server-managed-settings) или флага `--settings` как доступные только для чтения и сохраняет каждое внесённое вами изменение на вкладке в `~/.claude/settings.json`.

~~291~~

292* Добавлять, редактировать или удалять правила в разделах `allow`, `soft_deny` и `hard_deny`. Когда вы добавляете первое правило в раздел, Claude Code также вставляет `"$defaults"`, чтобы [встроенные правила](#override-the-block-and-allow-rules) оставались в силе.

293* Включать или отключать встроенные правила для `allow`, `soft_deny` или `hard_deny`. Claude Code записывает выбор, добавляя или удаляя `"$defaults"` в вашем списке для этого раздела, поэтому раздел должен содержать по крайней мере одно ваше собственное правило, прежде чем вы сможете отключить его встроенные правила.

294* Редактировать записи `environment` как один документ в вашем редакторе. Если вы ещё не настроили никакие записи `environment`, Claude Code сначала спрашивает, следует ли заменить встроенную среду, затем открывает редактор с полным встроенным текстом. При сохранении Claude Code заменяет ваш массив `autoMode.environment` документом. Включите строку `"$defaults"`, чтобы [сохранить встроенные записи](#define-trusted-infrastructure).

295 291

296<h2 id="route-all-shell-commands-through-the-classifier">292<h2 id="route-all-shell-commands-through-the-classifier">

297 Маршрутизировать все команды shell через классификатор293 Маршрутизировать все команды shell через классификатор

cli-reference.md +4 −3

Details

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

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

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

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

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

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

112| `--no-session-persistence` | Отключить сохранение сеанса, чтобы сеансы не сохранялись на диск и не могли быть возобновлены. Только режим печати. Переменная окружения [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/ru/env-vars) делает то же самое в любом режиме | `claude -p --no-session-persistence "query"` |113| `--no-session-persistence` | Отключить сохранение сеанса, чтобы сеансы не сохранялись на диск и не могли быть возобновлены. Только режим печати. Переменная окружения [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/ru/env-vars) делает то же самое в любом режиме | `claude -p --no-session-persistence "query"` |

114| `--permission-mode` | Начать в указанном [режиме разрешения](/docs/ru/permission-modes). Принимает `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions` или `manual` как псевдоним для `default`. Псевдоним `manual` выбирает режим разрешения, который UI обозначает как Manual и требует Claude Code v2.1.200 или позже; `claude --help` выводит его вместо `default`, и оба значения работают. Переопределяет `defaultMode` из файлов параметров. Без этого флага или `--dangerously-skip-permissions` новый сеанс начинается в режиме разрешения, описанном в [какой режим разрешения начинает сеанс](/docs/ru/permission-modes#which-mode-a-session-starts-in). Для `-p` это `default`, когда ничего не настроено | `claude --permission-mode plan` |115| `--permission-mode` | Начать в указанном [режиме разрешения](/docs/ru/permission-modes). Принимает `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions` или `manual` как псевдоним для `default`. Псевдоним `manual` выбирает режим разрешения, который UI обозначает как Manual и требует Claude Code v2.1.200 или позже; `claude --help` выводит его вместо `default`, и оба значения работают. Переопределяет `defaultMode` из файлов параметров. Без этого флага или `--dangerously-skip-permissions` новый сеанс начинается в режиме разрешения, описанном в [какой режим разрешения начинает сеанс](/docs/ru/permission-modes#which-mode-a-session-starts-in), который также охватывает то, в каком режиме начинается запуск `-p` | `claude --permission-mode plan` |

115| `--permission-prompt-tool` | Указать инструмент MCP для обработки запросов разрешения в неинтерактивном режиме. Claude Code ждёт подключения MCP сервера этого инструмента перед запуском первого хода, до стартового таймаута [`MCP_TIMEOUT`](/docs/ru/env-vars), 30 секунд по умолчанию. <br /><br />Инструмент приглашения не может одобрить инструмент MCP, отмеченный как [требующий взаимодействия пользователя](/docs/ru/mcp#require-approval-for-a-specific-tool): Claude Code преобразует результат `allow` для одного в отрицание. Это ограничение требует Claude Code v2.1.199 или позже | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |116| `--permission-prompt-tool` | Указать инструмент MCP для обработки запросов разрешения в неинтерактивном режиме. Claude Code ждёт подключения MCP сервера этого инструмента перед запуском первого хода, до стартового таймаута [`MCP_TIMEOUT`](/docs/ru/env-vars), 30 секунд по умолчанию. <br /><br />Инструмент приглашения не может одобрить инструмент MCP, отмеченный как [требующий взаимодействия пользователя](/docs/ru/mcp#require-approval-for-a-specific-tool): Claude Code преобразует результат `allow` для одного в отрицание. Это ограничение требует Claude Code v2.1.199 или позже | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |

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

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

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

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

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

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

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

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

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

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

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

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

cloud-environments.md +1 −1

Details

439 439

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

441 441

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

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

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

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

commands.md +1 −1

Details

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

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

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

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

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

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

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

context-window.md +1 −1

Details

1634 1634

1635Если вам нужно большее окно, а не меньший разговор, модели Fable, Sonnet 5 и более поздние версии, Opus 4.6 и более поздние версии, а также Sonnet 4.6 поддерживают контекстное окно в 1 миллион токенов. Смотрите [Extended context](/docs/ru/model-config#extended-context) для доступности по плану и как выбрать вариант модели `[1m]`. Компактирование работает так же при большем лимите.1635Если вам нужно большее окно, а не меньший разговор, модели Fable, Sonnet 5 и более поздние версии, Opus 4.6 и более поздние версии, а также Sonnet 4.6 поддерживают контекстное окно в 1 миллион токенов. Смотрите [Extended context](/docs/ru/model-config#extended-context) для доступности по плану и как выбрать вариант модели `[1m]`. Компактирование работает так же при большем лимите.

1636 1636

1637Sonnet 5.5 и Sonnet 5 работают с контекстным окном 1M и не имеют варианта `[1m]` для выбора. Смотрите [Sonnet 5.5 and Sonnet 5 context window](/docs/ru/model-config#sonnet-5-5-and-sonnet-5-context-window) для их пороговых значений автокомпактирования и исключения шлюза LLM.1637Sonnet 5.5 и Sonnet 5 работают с контекстным окном 1M и не имеют варианта `[1m]` для выбора. Смотрите [Sonnet 5.5 and Sonnet 5 context window](/docs/ru/model-config#sonnet-5-5-and-sonnet-5-context-window) для их пороговых значений автокомпактирования и [the context window behind a gateway](/docs/ru/model-config#context-window-behind-a-gateway) для того, как Claude Code определяет размер окна, когда вы устанавливаете `ANTHROPIC_BASE_URL` на [LLM gateway](/docs/ru/llm-gateway).

1638 1638

1639Точка, в которой запускается автоматическое компактирование, зависит от вашей модели и конфигурации. Смотрите [Default auto-compact thresholds](/docs/ru/model-config#default-auto-compact-thresholds) для границ по модели и [Correct the window for a gateway or custom model ID](/docs/ru/model-config#correct-the-window-for-a-gateway-or-custom-model-id), если Claude Code предполагает неправильное окно для вашего ID модели, например [LLM gateway](/docs/ru/llm-gateway) псевдоним.1639Точка, в которой запускается автоматическое компактирование, зависит от вашей модели и конфигурации. Смотрите [Default auto-compact thresholds](/docs/ru/model-config#default-auto-compact-thresholds) для границ по модели и [Correct the window for a gateway or custom model ID](/docs/ru/model-config#correct-the-window-for-a-gateway-or-custom-model-id), если Claude Code предполагает неправильное окно для вашего ID модели, например [LLM gateway](/docs/ru/llm-gateway) псевдоним.

1640 1640

costs.md +1 −1

Details

51 51

52Промахи, ожидаемые перестроения и горячие или холодные части строки означают следующее:52Промахи, ожидаемые перестроения и горячие или холодные части строки означают следующее:

53 53

54* **Misses**: запросы, которые повторно обработали содержимое, которое кэш уже содержал, с временем последнего промаха и количеством токенов, которые эти запросы записали обратно в кэш. Claude Code считает запрос промахом, когда запрос повторно обработал более 5% и по крайней мере 2000 токенов того, что он мог бы прочитать из кэша. [Действия, которые инвалидируют кэш](/docs/ru/prompt-caching#actions-that-invalidate-the-cache), перечисляют обычные причины. Когда Claude Code может определить вероятную причину последнего промаха, строка её называет, например `likely cause: tool definitions changed`. Текст вероятной причины требует Claude Code v2.1.260 или более поздней версии.54* **Misses**: запросы, которые повторно обработали содержимое, которое кэш уже содержал, с временем последнего промаха и количеством токенов, которые эти запросы записали обратно в кэш. [Действия, которые инвалидируют кэш](/docs/ru/prompt-caching#actions-that-invalidate-the-cache), перечисляют обычные причины. Когда Claude Code может определить вероятную причину последнего промаха, строка её называет, например `likely cause: tool definitions changed`. Текст вероятной причины требует Claude Code v2.1.260 или более поздней версии.

55* **Expected rebuilds**: когда Claude Code сам только что переписал разговор, путём [компактирования](/docs/ru/prompt-caching#compacting-the-conversation) или путём очистки старых результатов инструментов из контекста, он считает тот же вид промаха как ожидаемое перестроение вместо этого. Эта часть появляется только после того, как произошло по крайней мере одно ожидаемое перестроение.55* **Expected rebuilds**: когда Claude Code сам только что переписал разговор, путём [компактирования](/docs/ru/prompt-caching#compacting-the-conversation) или путём очистки старых результатов инструментов из контекста, он считает тот же вид промаха как ожидаемое перестроение вместо этого. Эта часть появляется только после того, как произошло по крайней мере одно ожидаемое перестроение.

56* **Warm or cold**: находится ли кэшированный префикс всё ещё в пределах своего [времени жизни кэша](/docs/ru/prompt-caching#cache-lifetime), с действующим TTL. Когда кэш холодный, строка показывает, как долго сессия была неактивна. Когда ни один ответ не сообщил о токенах кэша, строка заканчивается `no prompt caching reported by the API` вместо этого.56* **Warm or cold**: находится ли кэшированный префикс всё ещё в пределах своего [времени жизни кэша](/docs/ru/prompt-caching#cache-lifetime), с действующим TTL. Когда кэш холодный, строка показывает, как долго сессия была неактивна. Когда ни один ответ не сообщил о токенах кэша, строка заканчивается `no prompt caching reported by the API` вместо этого.

57 57

desktop.md +8 −0

Details

967 967

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

969 969

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

971

972```bash theme={null}

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

974```

975

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

977

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

971 979

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

desktop-linux.md +12 −0

Details

163 163

164Если `claude-desktop` завершается с этим сообщением, вы запустили его от имени root. Войдите как обычный пользователь и запустите его оттуда.164Если `claude-desktop` завершается с этим сообщением, вы запустили его от имени root. Войдите как обычный пользователь и запустите его оттуда.

165 165

166<h3 id="your-sign-in-won’t-be-saved-on-this-device">

167 Your sign-in won't be saved on this device

168</h3>

169

170Claude Desktop сохраняет вашу учетную запись в связке ключей вашего рабочего стола, такой как GNOME Keyring или KDE Wallet. Если он не может получить доступ к разблокированной связке ключей, ваша учетная запись не сохраняется и вы входите снова каждый раз при запуске приложения. Выберите случай, который соответствует вашей системе:

171

172* **No keyring installed, on a desktop other than KDE Plasma**: если вы установили с `--no-install-recommends`, или на минимальном образе, который пропускает рекомендуемые пакеты, apt не установил связку ключей. Установите GNOME Keyring с помощью `sudo apt install gnome-keyring`.

173* **KDE Plasma with GNOME Keyring also installed**: KDE Wallet поставляется с рабочим столом Plasma. Две связки ключей конфликтуют, и Claude Desktop может показать это уведомление, даже если KDE Wallet работает. Удалите лишнюю с помощью `sudo apt remove gnome-keyring`, затем перезагрузите компьютер.

174* **Keyring installed but locked**: разблокируйте его.

175

176После исправления перезагрузите приложение и войдите. Затем выйдите и запустите его снова, чтобы подтвердить, что приложение открывается с вами все еще вошедшим.

177

166<h3 id="cowork-isn’t-available">178<h3 id="cowork-isn’t-available">

167 Cowork isn't available179 Cowork isn't available

168</h3>180</h3>

env-vars.md +41 −35

Details

56 </Tab>56 </Tab>

57</Tabs>57</Tabs>

58 58

59Строка присваивания ничего не выводит при успехе, поэтому подтвердите, что переменная установлена, выведя её в той же оболочке перед запуском `claude`:59Строка присваивания ничего не выводит при успехе. Чтобы подтвердить, что переменная установлена, выведите её в той же оболочке:

60 60

61<Tabs>61<Tabs>

62 <Tab title="macOS, Linux, WSL">62 <Tab title="macOS, Linux, WSL">

110 110

111Некоторые поведения имеют как переменную окружения, так и выделенный ключ параметров, и то, какой из них Claude Code читает первым, отличается для каждого ключа. Для `ANTHROPIC_MODEL` и `CLAUDE_CODE_AUTO_CONNECT_IDE` Claude Code сначала читает переменную и использует параметр `model` или `autoConnectIde` только когда переменная не установлена. Для пары, которую вы устанавливаете, проверьте строку переменной ниже и запись ключа в [справочнике параметров](/docs/ru/settings-reference).111Некоторые поведения имеют как переменную окружения, так и выделенный ключ параметров, и то, какой из них Claude Code читает первым, отличается для каждого ключа. Для `ANTHROPIC_MODEL` и `CLAUDE_CODE_AUTO_CONNECT_IDE` Claude Code сначала читает переменную и использует параметр `model` или `autoConnectIde` только когда переменная не установлена. Для пары, которую вы устанавливаете, проверьте строку переменной ниже и запись ключа в [справочнике параметров](/docs/ru/settings-reference).

112 112

113Когда одна и та же переменная установлена как в вашей оболочке, так и в блоке `env` файла параметров, применяется значение из файла параметров. Claude Code записывает каждую запись `env` в переменные окружения процесса, заменяя значение, унаследованное из оболочки. [Параметр `env`](/docs/ru/settings-reference#when-claude-code-applies-env-values) указывает, когда он их применяет. Несколько переменных имеют специальную обработку; [параметр `env`](/docs/ru/settings-reference#env) перечисляет исключения.113Когда одна и та же переменная установлена как в вашей оболочке, так и в блоке `env` файла параметров, применяется значение из файла параметров в большинстве сеансов. Claude Code записывает каждую запись `env` в переменные окружения процесса, заменяя значение, унаследованное из оболочки. [Как значения `env` взаимодействуют с вашей оболочкой](/docs/ru/settings-reference#how-env-values-interact-with-your-shell) охватывает сеансы, которые сохраняют унаследованное значение вместо этого, и [параметр `env`](/docs/ru/settings-reference#when-claude-code-applies-env-values) указывает, когда он их применяет. Несколько переменных имеют специальную обработку; [параметр `env`](/docs/ru/settings-reference#env) перечисляет исключения.

114 114

115В файле параметров вы можете установить переменную, но не можете удалить её. Чтобы переопределить переменную, которую вы не можете отменить, например устаревшую `CLAUDE_CODE_USE_VERTEX`, экспортированную профилем оболочки, который вы не контролируете, установите её на пустую строку в блоке `env`: `"CLAUDE_CODE_USE_VERTEX": ""`. Claude Code рассматривает пустое значение как неустановленное для выбора поставщика. Подпроцессы по-прежнему наследуют пустое значение.115В файле параметров вы можете установить переменную, но не можете удалить её. Чтобы переопределить переменную, которую вы не можете отменить, например устаревшую `CLAUDE_CODE_USE_VERTEX`, экспортированную профилем оболочки, который вы не контролируете, установите её на пустую строку в блоке `env`: `"CLAUDE_CODE_USE_VERTEX": ""`. Claude Code рассматривает пустое значение как неустановленное для выбора поставщика. Подпроцессы по-прежнему наследуют пустое значение.

116 116

117Между файлами параметров значения `env` следуют [приоритету параметров](/docs/ru/settings#settings-precedence), поэтому управляемая запись параметров переопределяет ту же переменную в пользовательских или проектных параметрах.117Между файлами параметров значения `env` следуют [приоритету параметров](/docs/ru/settings#settings-precedence), поэтому управляемая запись параметров переопределяет ту же переменную в пользовательских или проектных параметрах. Проектные и локальные параметры не могут устанавливать некоторые переменные, такие как `CLAUDE_CONFIG_DIR` и переменные экспортера OpenTelemetry. [Переменные, которые Claude Code игнорирует в `env`](/docs/ru/settings-reference#variables-claude-code-ignores-in-env) перечисляет их, а также значения отключения OpenTelemetry, которые по-прежнему применяются.

118 118

119То, как переменная окружения взаимодействует с флагами CLI и командами в сеансе, варьируется в зависимости от функции: `--model` и `/model` переопределяют `ANTHROPIC_MODEL`, в то время как `CLAUDE_CODE_EFFORT_LEVEL` переопределяет `--effort` и `/effort`. Когда переменная взаимодействует с другим источником конфигурации, её строка в списке [Переменные](#variables) указывает приоритет или ссылается на страницу, которая это документирует.119То, как переменная окружения взаимодействует с флагами CLI и командами в сеансе, варьируется в зависимости от функции: `--model` и `/model` переопределяют `ANTHROPIC_MODEL`, в то время как `CLAUDE_CODE_EFFORT_LEVEL` переопределяет `--effort` и `/effort`. Когда переменная взаимодействует с другим источником конфигурации, её строка в списке [Переменные](#variables) указывает приоритет или ссылается на страницу, которая это документирует.

120 120

127Числовые переменные, такие как таймауты, бюджеты токенов и количество повторов, принимают научную нотацию и написание с разделителями цифр в дополнение к простым цифрам, за исключением случаев, когда в строке переменной указано, что она принимает только простые цифры. Например, Claude Code читает `2e3` как 2000 и `64_000` как 64000. До версии 2.1.211 эти написания могли молча установить гораздо меньшее значение, например `1e6` установить таймаут на 1.127Числовые переменные, такие как таймауты, бюджеты токенов и количество повторов, принимают научную нотацию и написание с разделителями цифр в дополнение к простым цифрам, за исключением случаев, когда в строке переменной указано, что она принимает только простые цифры. Например, Claude Code читает `2e3` как 2000 и `64_000` как 64000. До версии 2.1.211 эти написания могли молча установить гораздо меньшее значение, например `1e6` установить таймаут на 1.

128 128

129<Note>129<Note>

130 Для переменных, которые включают или отключают поведение, установите `1` или `true` для включения и `0` или `false` для отключения, в любом регистре.130 Для переменных, которые включают или отключают поведение, установите `1`, `true`, `yes` или `on`, чтобы включить, и `0`, `false`, `no` или `off`, чтобы отключить, в любом регистре.

131 131

132 Некоторые переменные читают только то, установлены ли они вообще, поэтому любое непустое значение, включая `0`, включает поведение, а отключить поведение можно, отменив установку переменной или установив её на пустое значение. Эти переменные работают таким образом:132 Некоторые переменные читают только то, установлены ли они вообще, поэтому любое непустое значение, включая `0`, включает поведение, а отключить поведение можно, отменив установку переменной или установив её на пустое значение. Эти переменные работают таким образом:

133 133

189| `ANTHROPIC_VERTEX_BASE_URL` | Переопределить URL конечной точки Google Cloud's Agent Platform. Используйте для пользовательских конечных точек Google Cloud's Agent Platform или при маршрутизации через [LLM gateway](/docs/ru/llm-gateway). См. [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) |189| `ANTHROPIC_VERTEX_BASE_URL` | Переопределить URL конечной точки Google Cloud's Agent Platform. Используйте для пользовательских конечных точек Google Cloud's Agent Platform или при маршрутизации через [LLM gateway](/docs/ru/llm-gateway). См. [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) |

190| `ANTHROPIC_VERTEX_PROJECT_ID` | ID проекта GCP, на который адресованы запросы Google Cloud's Agent Platform. См. [Настройка учётных данных GCP](/docs/ru/google-vertex-ai#3-configure-gcp-credentials) |190| `ANTHROPIC_VERTEX_PROJECT_ID` | ID проекта GCP, на который адресованы запросы Google Cloud's Agent Platform. См. [Настройка учётных данных GCP](/docs/ru/google-vertex-ai#3-configure-gcp-credentials) |

191| `ANTHROPIC_WORKSPACE_ID` | ID рабочей области для [федерации рабочей нагрузки](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Установите это, когда ваше правило федерации охватывает более одной рабочей области, чтобы обмен токенов знал, на какую рабочую область ориентироваться |191| `ANTHROPIC_WORKSPACE_ID` | ID рабочей области для [федерации рабочей нагрузки](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Установите это, когда ваше правило федерации охватывает более одной рабочей области, чтобы обмен токенов знал, на какую рабочую область ориентироваться |

192| `API_FORCE_IDLE_TIMEOUT` | Переопределить таймаут простоя тела в 5 минут, который прерывает потоковый ответ модели, когда байты не поступают. Установите на `0`, чтобы отключить таймаут, например, когда медленный [шлюз](/docs/ru/llm-gateway) или локальная модель делает паузу дольше 5 минут между фрагментами, или `1`, чтобы держать его включённым для каждого поставщика. Если не установлено, таймаут активен на поставщиках, отличных от прямого API Anthropic и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws). [Сторожи потока](/docs/ru/network-config#streaming-idle-watchdogs) работают независимо от него и прерывают длительную молчаливую паузу даже при установке `0` здесь |192| `API_FORCE_IDLE_TIMEOUT` | Переопределить таймаут простоя тела в 5 минут, который прерывает потоковый ответ модели, когда байты не поступают. Установите на `0`, чтобы отключить таймаут, например, когда медленный [шлюз](/docs/ru/llm-gateway) или локальная модель делает паузу дольше 5 минут между фрагментами, или `1`, чтобы держать его включённым для каждого поставщика. Если не установлено, таймаут активен на поставщиках, отличных от прямого API Anthropic, [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) и Amazon Bedrock с `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` установленным. [Сторожи потока](/docs/ru/network-config#streaming-idle-watchdogs) работают независимо от него и прерывают длительную молчаливую паузу даже при установке `0` здесь |

193| `API_TIMEOUT_MS` | Таймаут для запросов API в миллисекундах (по умолчанию: 600000 или 10 минут; максимум: 2147483647). Увеличьте это, когда запросы истекают на медленных сетях или при маршрутизации через прокси. Значения выше максимума переполняют базовый таймер и вызывают немедленный отказ запросов |193| `API_TIMEOUT_MS` | Таймаут для запросов API в миллисекундах (по умолчанию: 600000 или 10 минут; максимум: 2147483647). Увеличьте это, когда запросы истекают на медленных сетях или при маршрутизации через прокси. Значения выше максимума переполняют базовый таймер и вызывают немедленный отказ запросов |

194| `AWS_BEARER_TOKEN_BEDROCK` | Ключ API Amazon Bedrock для аутентификации (см. [Ключи API Amazon Bedrock](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)) |194| `AWS_BEARER_TOKEN_BEDROCK` | Ключ API Amazon Bedrock для аутентификации (см. [Ключи API Amazon Bedrock](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)) |

195| `BASH_DEFAULT_TIMEOUT_MS` | Таймаут по умолчанию для долгоживущих команд bash (по умолчанию: 120000 или 2 минуты) |195| `BASH_DEFAULT_TIMEOUT_MS` | Таймаут по умолчанию для команды переднего плана Bash или PowerShell в миллисекундах (по умолчанию: 120000 или 2 минуты). Значение по умолчанию дольше 30 минут также становится значением по умолчанию [ограничение времени для фоновых команд](/docs/ru/tools-reference#time-limit-for-background-commands). Ограничение времени фоновой команды требует Claude Code версии 2.1.285 или позже |

196| `BASH_MAX_OUTPUT_LENGTH` | Максимальное количество символов вывода bash, которое Claude Code читает обратно в результат команды (по умолчанию: 30000; максимум: 150000). Если вы установите параметр [`bashOutputMaxChars`](/docs/ru/settings-reference#bashoutputmaxchars), Claude Code игнорирует эту переменную. См. [Ограничения вывода](/docs/ru/tools-reference#output-limits) |196| `BASH_MAX_OUTPUT_LENGTH` | Максимальное количество символов вывода bash, которое Claude Code читает обратно в результат команды (по умолчанию: 30000; максимум: 150000). Если вы установите параметр [`bashOutputMaxChars`](/docs/ru/settings-reference#bashoutputmaxchars), Claude Code игнорирует эту переменную. См. [Ограничения вывода](/docs/ru/tools-reference#output-limits) |

197| `BASH_MAX_TIMEOUT_MS` | Максимальный таймаут, который модель может установить для долгоживущих команд bash (по умолчанию: 600000 или 10 минут). Эффективный потолок — это больший из этого и `BASH_DEFAULT_TIMEOUT_MS` |197| `BASH_MAX_TIMEOUT_MS` | Максимальный таймаут, который модель может установить для команды переднего плана Bash или PowerShell в миллисекундах (по умолчанию: 600000 или 10 минут). Эффективный потолок — это больший из этого и `BASH_DEFAULT_TIMEOUT_MS`. Эффективный потолок дольше 2 часов также становится максимальным [ограничением времени для фоновых команд](/docs/ru/tools-reference#time-limit-for-background-commands). Ограничение времени фоновой команды требует Claude Code версии 2.1.285 или позже |

198| `BETA_TRACING_ENDPOINT` | Конечная точка OTLP для [детального бета-трассирования](/docs/ru/monitoring-usage#traces-beta): с `ENABLE_BETA_TRACING_DETAILED=1` логи и трассировки идут туда вместо настроенных экспортёров. Установите это в вашей оболочке, пользовательских параметрах или управляемых параметрах. Игнорируется в [параметрах проекта и локальных параметрах](/docs/ru/settings-reference#variables-claude-code-ignores-in-env) |198| `BETA_TRACING_ENDPOINT` | Конечная точка OTLP для [детального бета-трассирования](/docs/ru/monitoring-usage#traces-beta): с `ENABLE_BETA_TRACING_DETAILED=1` логи и трассировки идут туда вместо настроенных экспортёров. Установите это в вашей оболочке, пользовательских параметрах или управляемых параметрах. Игнорируется в [параметрах проекта и локальных параметрах](/docs/ru/settings-reference#variables-claude-code-ignores-in-env) |

199| `CCR_FORCE_BUNDLE` | Установите на `1`, чтобы заставить [`claude --cloud`](/docs/ru/claude-code-on-the-web#send-local-repositories-without-github) упаковать и загрузить ваш локальный репозиторий вместо клонирования из его удалённого источника |199| `CCR_FORCE_BUNDLE` | Установите на `1`, чтобы заставить [`claude --cloud`](/docs/ru/claude-code-on-the-web#send-local-repositories-without-github) упаковать и загрузить ваш локальный репозиторий вместо клонирования из его удалённого источника |

200| `CLAUDECODE` | Установите на `1` в подпроцессах, которые порождает Claude Code (инструменты Bash и PowerShell, сеансы tmux, команды [hook](/docs/ru/hooks), команды [строки состояния](/docs/ru/statusline), подпроцессы [MCP сервера](/docs/ru/mcp) stdio). Расширения IDE также устанавливают это в своих интегрированных терминалах. Используйте для обнаружения, когда скрипт работает внутри подпроцесса, порождённого Claude Code. Чтобы проверить, был ли текущий процесс порождён непосредственно вызовом инструмента или hook, а не внутри MCP сервера stdio, который запустил Claude Code, используйте `CLAUDE_CODE_CHILD_SESSION` вместо этого |200| `CLAUDECODE` | Установите на `1` в подпроцессах, которые порождает Claude Code (инструменты Bash и PowerShell, сеансы tmux, команды [hook](/docs/ru/hooks), команды [строки состояния](/docs/ru/statusline), подпроцессы [MCP сервера](/docs/ru/mcp) stdio). Расширения IDE также устанавливают это в своих интегрированных терминалах. Используйте для обнаружения, когда скрипт работает внутри подпроцесса, порождённого Claude Code. Чтобы проверить, был ли текущий процесс порождён непосредственно вызовом инструмента или hook, а не внутри MCP сервера stdio, который запустил Claude Code, используйте `CLAUDE_CODE_CHILD_SESSION` вместо этого |

223| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | Когда `CLAUDE_AUTO_BACKGROUND_TASKS` включен, секунды между напоминаниями Claude проверить [фоновые подагенты](/docs/ru/sub-agents#run-subagents-in-foreground-or-background), которые всё ещё работают. Принимает простое целое число от `1` до `86400` только; любое другое значение или написание читается как не установленное. Если не установлено, напоминаний о проверке нет. Требует Claude Code версии 2.1.248 или позже |223| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | Когда `CLAUDE_AUTO_BACKGROUND_TASKS` включен, секунды между напоминаниями Claude проверить [фоновые подагенты](/docs/ru/sub-agents#run-subagents-in-foreground-or-background), которые всё ещё работают. Принимает простое целое число от `1` до `86400` только; любое другое значение или написание читается как не установленное. Если не установлено, напоминаний о проверке нет. Требует Claude Code версии 2.1.248 или позже |

224| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Установить [окно автокомпактирования](/docs/ru/model-config#set-the-auto-compact-window) в токенах, от `100000` до `1000000`. Принимает простое целое число, такое как `500000` только: значение, такое как `500k`, читается как `500` и зажимается на минимум 100K. Эффективное окно также ограничено окном контекста модели. Имеет приоритет над командой `/autocompact`, флагом `--autocompact` и параметром `autoCompactWindow`. Процент `used_percentage` в строке состояния всегда измеряется относительно полного окна контекста модели, поэтому после установки этой переменной этот процент больше не указывает, когда будет запущено компактирование |224| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Установить [окно автокомпактирования](/docs/ru/model-config#set-the-auto-compact-window) в токенах, от `100000` до `1000000`. Принимает простое целое число, такое как `500000` только: значение, такое как `500k`, читается как `500` и зажимается на минимум 100K. Эффективное окно также ограничено окном контекста модели. Имеет приоритет над командой `/autocompact`, флагом `--autocompact` и параметром `autoCompactWindow`. Процент `used_percentage` в строке состояния всегда измеряется относительно полного окна контекста модели, поэтому после установки этой переменной этот процент больше не указывает, когда будет запущено компактирование |

225| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Переопределить автоматическое [подключение IDE](/docs/ru/vs-code). По умолчанию Claude Code подключается автоматически при запуске внутри интегрированного терминала поддерживаемой IDE. Установите на `false`, чтобы предотвратить это. Установите на `true`, чтобы принудительно попытаться подключиться, когда автоопределение не работает, например, когда tmux скрывает родительский терминал. Имеет приоритет над глобальным параметром конфигурации [`autoConnectIde`](/docs/ru/settings-reference#autoconnectide) |225| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Переопределить автоматическое [подключение IDE](/docs/ru/vs-code). По умолчанию Claude Code подключается автоматически при запуске внутри интегрированного терминала поддерживаемой IDE. Установите на `false`, чтобы предотвратить это. Установите на `true`, чтобы принудительно попытаться подключиться, когда автоопределение не работает, например, когда tmux скрывает родительский терминал. Имеет приоритет над глобальным параметром конфигурации [`autoConnectIde`](/docs/ru/settings-reference#autoconnectide) |

226| `CLAUDE_CODE_AUTO_MODE_SERVER` | Контролирует, просит ли Claude Code сервер [проверить действия автоматического режима](/docs/ru/permission-modes#server-side-classifier-review). Если не установлено, Claude Code просит сервер на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Claude Platform on AWS, и когда вы указываете `ANTHROPIC_BASE_URL` на LLM gateway или прокси. Установите на `0`, чтобы использовать вместо этого собственные запросы классификатора Claude Code. Не читается при прямом подключении к API Anthropic. Требует Claude Code версии 2.1.271 или позже; запрос сервера по умолчанию требует версии 2.1.278 или позже |226| `CLAUDE_CODE_AUTO_MODE_SERVER` | Контролирует, просит ли Claude Code сервер [проверить действия автоматического режима](/docs/ru/permission-modes#server-side-classifier-review). Установите на `0`, чтобы использовать вместо этого собственные запросы классификатора Claude Code. На прямом подключении к API Anthropic требуется версия 2.1.281 или позже. Связанный раздел перечисляет, какие сеансы просят сервер, когда переменная не установлена, и с какой версии. Требует Claude Code версии 2.1.271 или позже |

227| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Время в миллисекундах, которое Claude Code ждёт, пока цепочка поставщика учётных данных AWS по умолчанию выдаст учётные данные, прежде чем запрос не выполнится с [`AWS default-chain credential resolve timed out`](/docs/ru/errors#aws-default-chain-credential-resolve-timed-out) (по умолчанию: `60000`). Повысьте это, когда шаг в вашей цепочке законно нуждается в большем времени, например вход на основе браузера через обёртку, такую как `aws-vault`, с MFA. Применяется везде, где Claude Code подписывает с цепочкой по умолчанию: [Amazon Bedrock](/docs/ru/amazon-bedrock#credential-caching-and-resolution-timeout), [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) и [конечная точка Mantle](/docs/ru/amazon-bedrock#use-the-mantle-endpoint). Требует Claude Code версии 2.1.207 или позже |227| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Время в миллисекундах, которое Claude Code ждёт, пока цепочка поставщика учётных данных AWS по умолчанию выдаст учётные данные, прежде чем запрос не выполнится с [`AWS default-chain credential resolve timed out`](/docs/ru/errors#aws-default-chain-credential-resolve-timed-out) (по умолчанию: `60000`). Повысьте это, когда шаг в вашей цепочке законно нуждается в большем времени, например вход на основе браузера через обёртку, такую как `aws-vault`, с MFA. Применяется везде, где Claude Code подписывает с цепочкой по умолчанию: [Amazon Bedrock](/docs/ru/amazon-bedrock#credential-caching-and-resolution-timeout), [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) и [конечная точка Mantle](/docs/ru/amazon-bedrock#use-the-mantle-endpoint). Требует Claude Code версии 2.1.207 или позже |

228| `CLAUDE_CODE_BASH_EDIT_DIFF` | Установите на `0`, чтобы отключить [diff файлов, которые изменились во время выполнения команды Bash](/docs/ru/hooks#bash), или `1`, чтобы записать его в каждом режиме разрешений. Имеет приоритет над параметром [`bashEditDiffEnabled`](/docs/ru/settings-reference#basheditdiffenabled). Требует Claude Code версии 2.1.269 или позже |228| `CLAUDE_CODE_BASH_EDIT_DIFF` | Установите на `0`, чтобы отключить [diff файлов, которые изменились во время выполнения команды Bash](/docs/ru/hooks#bash), или `1`, чтобы записать его в каждом режиме разрешений. Имеет приоритет над параметром [`bashEditDiffEnabled`](/docs/ru/settings-reference#basheditdiffenabled). Требует Claude Code версии 2.1.269 или позже |

229| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | Установите на `0`, чтобы неинтерактивный сеанс сообщал статус простоя своему хосту при каждом завершении хода, даже если фоновая работа всё ещё выполняется. По умолчанию сеанс продолжает сообщать статус выполнения после завершения хода, пока фоновая работа, такая как фоновый агент или запуск [workflow](/docs/ru/workflows), всё ещё активна. Это удерживает хост, который наблюдает статус, такой как список удалённых сеансов, от объявления, что Claude ждёт вашего ввода во время работы. Фоновые команды оболочки, такие как сервер разработки, не удерживают статус выполнения. Статус выполнения по умолчанию и отказ `0` требуют Claude Code версии 2.1.269 или позже; на более ранних версиях установите `1`, чтобы удержать статус выполнения |229| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | Установите на `0`, чтобы неинтерактивный сеанс сообщал статус простоя своему хосту при каждом завершении хода, даже если фоновая работа всё ещё выполняется. По умолчанию сеанс продолжает сообщать статус выполнения после завершения хода, пока фоновая работа, такая как фоновый агент или запуск [workflow](/docs/ru/workflows), всё ещё активна. Это удерживает хост, который наблюдает статус, такой как список удалённых сеансов, от объявления, что Claude ждёт вашего ввода во время работы. Фоновые команды оболочки, такие как сервер разработки, не удерживают статус выполнения. Статус выполнения по умолчанию и отказ `0` требуют Claude Code версии 2.1.269 или позже; на более ранних версиях установите `1`, чтобы удержать статус выполнения |

237| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | Удалено в версии 2.1.186 и теперь не работает. Ранее устанавливало отдельный таймаут для фазы подключения, TLS и заголовка ответа потокового запроса API. Используйте `API_TIMEOUT_MS` для таймаута для каждого запроса. Для фазы заголовка ответа потокового запроса см. `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` |237| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | Удалено в версии 2.1.186 и теперь не работает. Ранее устанавливало отдельный таймаут для фазы подключения, TLS и заголовка ответа потокового запроса API. Используйте `API_TIMEOUT_MS` для таймаута для каждого запроса. Для фазы заголовка ответа потокового запроса см. `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` |

238| `CLAUDE_CODE_DEBUG_LOGS_DIR` | Переопределить путь файла журнала отладки. Несмотря на имя, это путь к файлу, а не каталог. Требует отдельного включения режима отладки через `--debug`, `/debug` или переменную окружения `DEBUG`: установка только этой переменной не включает логирование. Флаг [`--debug-file`](/docs/ru/cli-reference#cli-flags) делает оба сразу. По умолчанию `~/.claude/debug/<session-id>.txt` |238| `CLAUDE_CODE_DEBUG_LOGS_DIR` | Переопределить путь файла журнала отладки. Несмотря на имя, это путь к файлу, а не каталог. Требует отдельного включения режима отладки через `--debug`, `/debug` или переменную окружения `DEBUG`: установка только этой переменной не включает логирование. Флаг [`--debug-file`](/docs/ru/cli-reference#cli-flags) делает оба сразу. По умолчанию `~/.claude/debug/<session-id>.txt` |

239| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Минимальный уровень логирования, записываемый в файл журнала отладки. Значения: `verbose`, `debug` (по умолчанию), `info`, `warn`, `error`. Установите на `verbose`, чтобы включить высокообъёмную диагностику, такую как полный вывод команды строки состояния, или повысьте на `error`, чтобы уменьшить шум |239| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Минимальный уровень логирования, записываемый в файл журнала отладки. Значения: `verbose`, `debug` (по умолчанию), `info`, `warn`, `error`. Установите на `verbose`, чтобы включить высокообъёмную диагностику, такую как полный вывод команды строки состояния, или повысьте на `error`, чтобы уменьшить шум |

240| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Установите на `1`, чтобы отключить поддержку [окна контекста 1M](/docs/ru/model-config#extended-context). Если установлено, варианты модели 1M недоступны в средстве выбора модели, и Claude Code удерживает сеансы на моделях с собственным окном 1M, таких как [Sonnet 5](/docs/ru/model-config#sonnet-5-context-window) и модели Fable, на окне 200K; см. [Расширенный контекст](/docs/ru/model-config#extended-context) для того, как применяется удержание. Полезно для корпоративных сред с требованиями соответствия. Для его роли в исправлении окна для нераспознанного ID модели `[1m]` см. [Исправить окно для ID шлюза или пользовательской модели](/docs/ru/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |240| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Установите на `1`, чтобы отключить поддержку [окна контекста 1M](/docs/ru/model-config#extended-context). Если установлено, варианты модели 1M недоступны в средстве выбора модели, и Claude Code удерживает сеансы на моделях с собственным окном 1M, таких как [Sonnet 5.5](/docs/ru/model-config#sonnet-5-5-and-sonnet-5-context-window) и модели Fable, на окне 200K; см. [Расширенный контекст](/docs/ru/model-config#extended-context) для того, как применяется удержание. Полезно для корпоративных сред с требованиями соответствия. Для его роли в исправлении окна для нераспознанного ID модели `[1m]` см. [Исправить окно для ID шлюза или пользовательской модели](/docs/ru/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |

241| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Установите на `1`, чтобы отключить [адаптивное рассуждение](/docs/ru/model-config#adjust-effort-level) на Opus 4.6 и Sonnet 4.6 и вернуться к фиксированному бюджету мышления, контролируемому `MAX_THINKING_TOKENS`. Не имеет эффекта на [модели Fable](/docs/ru/model-config#extended-thinking), Sonnet 5 или Opus 4.7 и позже, которые всегда используют адаптивное рассуждение |241| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Установите на `1`, чтобы отключить [адаптивное рассуждение](/docs/ru/model-config#adjust-effort-level) на Opus 4.6 и Sonnet 4.6 и вернуться к фиксированному бюджету мышления, контролируемому `MAX_THINKING_TOKENS`. Не имеет эффекта на [модели Fable](/docs/ru/model-config#extended-thinking), Sonnet 5 или Opus 4.7 и позже, которые всегда используют адаптивное рассуждение |

242| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | Установите на `1`, чтобы остановить Claude Code от объединения [управляемых параметров](/docs/ru/managed-settings#precedence-within-the-managed-tier) блоков `env` для каждого ключа между источниками администратора, поэтому применяется только весь блок `env` источника с наивысшим приоритетом, как до версии 2.1.223. Установите это в окружении, которое запускает Claude Code, так как Claude Code игнорирует копию, доставленную через блок параметров `env`. Требует Claude Code версии 2.1.223 или позже |242| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | Установите на `1`, чтобы остановить Claude Code от объединения [управляемых параметров](/docs/ru/managed-settings#precedence-within-the-managed-tier) блоков `env` для каждого ключа между источниками администратора, поэтому применяется только весь блок `env` источника с наивысшим приоритетом, как до версии 2.1.223. Установите это в окружении, которое запускает Claude Code, так как Claude Code игнорирует копию, доставленную через блок параметров `env`. Требует Claude Code версии 2.1.223 или позже |

243| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | Установите на `1`, чтобы отключить [инструмент советника](/docs/ru/advisor). Команда `/advisor` становится недоступной, любой настроенный `advisorModel` игнорируется, и флаг `--advisor` принимается, но не имеет эффекта, поэтому существующие скрипты, которые его передают, продолжают работать без ошибок |243| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | Установите на `1`, чтобы отключить [инструмент советника](/docs/ru/advisor). Команда `/advisor` становится недоступной, любой настроенный `advisorModel` игнорируется, и флаг `--advisor` принимается, но не имеет эффекта, поэтому существующие скрипты, которые его передают, продолжают работать без ошибок |

255| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Установите на `1`, чтобы сохранить инструменты браузера [Claude in Chrome](/docs/ru/chrome) доступными, опуская раздел Chrome системной подсказки и `/claude-in-chrome` [встроенный skill](/docs/ru/skills#bundled-skills). Для хостов, которые встраивают Claude Code и предоставляют свои собственные рекомендации браузера. Требует Claude Code версии 2.1.257 или позже |255| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Установите на `1`, чтобы сохранить инструменты браузера [Claude in Chrome](/docs/ru/chrome) доступными, опуская раздел Chrome системной подсказки и `/claude-in-chrome` [встроенный skill](/docs/ru/skills#bundled-skills). Для хостов, которые встраивают Claude Code и предоставляют свои собственные рекомендации браузера. Требует Claude Code версии 2.1.257 или позже |

256| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Установите на `1`, чтобы предотвратить загрузку любых файлов памяти CLAUDE.md в контекст, включая файлы памяти пользователя, проекта и автоматической памяти |256| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Установите на `1`, чтобы предотвратить загрузку любых файлов памяти CLAUDE.md в контекст, включая файлы памяти пользователя, проекта и автоматической памяти |

257| `CLAUDE_CODE_DISABLE_CRON` | Установите на `1`, чтобы отключить [запланированные задачи](/docs/ru/scheduled-tasks). Skill `/loop` и инструменты cron становятся недоступными, и любые уже запланированные задачи перестают срабатывать, включая задачи, которые уже выполняются в середине сеанса |257| `CLAUDE_CODE_DISABLE_CRON` | Установите на `1`, чтобы отключить [запланированные задачи](/docs/ru/scheduled-tasks). Skill `/loop` и инструменты cron становятся недоступными, и любые уже запланированные задачи перестают срабатывать, включая задачи, которые уже выполняются в середине сеанса |

258| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | Установите на `1`, чтобы отключить ограничение времени на [критические пути удаления](/docs/ru/permission-modes#critical-paths) подсказки. В режиме `auto` Claude Code затем отправляет эти удаления классификатору вместо этого, и в режиме `bypassPermissions` подсказка ждёт вашего ответа. Установите это в окружении, которое запускает Claude Code, так как Claude Code игнорирует копию, доставленную через блок параметров `env`. Требует Claude Code версии 2.1.281 или позже |

258| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Установите на `1`, чтобы удалить заголовки запроса `anthropic-beta`, специфичные для Anthropic, и поля схемы инструмента бета-версии (такие как `defer_loading` и `eager_input_streaming`) из запросов API. Используйте это, когда прокси-шлюз отклоняет запросы с ошибками, такими как "Unexpected value(s) for the `anthropic-beta` header" или "Extra inputs are not permitted". Стандартные поля (`name`, `description`, `input_schema`, `cache_control`) сохраняются. [Поиск инструментов MCP](/docs/ru/mcp#scale-with-mcp-tool-search) отключен и все инструменты MCP загружаются заранее, даже при установке `ENABLE_TOOL_SEARCH`. На Claude Code версии 2.1.227 или позже [управляемые параметры](/docs/ru/managed-settings) могут сохранить поиск инструментов включённым. [Отключить предварительные возможности](/docs/ru/llm-gateway-protocol#disable-pre-release-capabilities) охватывает, где применяется переопределение |259| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Установите на `1`, чтобы удалить заголовки запроса `anthropic-beta`, специфичные для Anthropic, и поля схемы инструмента бета-версии (такие как `defer_loading` и `eager_input_streaming`) из запросов API. Используйте это, когда прокси-шлюз отклоняет запросы с ошибками, такими как "Unexpected value(s) for the `anthropic-beta` header" или "Extra inputs are not permitted". Стандартные поля (`name`, `description`, `input_schema`, `cache_control`) сохраняются. [Поиск инструментов MCP](/docs/ru/mcp#scale-with-mcp-tool-search) отключен и все инструменты MCP загружаются заранее, даже при установке `ENABLE_TOOL_SEARCH`. На Claude Code версии 2.1.227 или позже [управляемые параметры](/docs/ru/managed-settings) могут сохранить поиск инструментов включённым. [Отключить предварительные возможности](/docs/ru/llm-gateway-protocol#disable-pre-release-capabilities) охватывает, где применяется переопределение |

259| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | Установите на `1`, чтобы отключить встроенные [подагенты Explore и Plan](/docs/ru/sub-agents#built-in-subagents). Claude исследует с помощью своих инструментов поиска или подагента общего назначения вместо этого, и [режим плана](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode) читает файлы напрямую, а не запускает агентов Explore и Plan. Пользовательские подагенты с именами `Explore` или `Plan` не затронуты. Чтобы удалить каждый встроенный тип подагента в Agent SDK или неинтерактивном режиме, используйте `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` вместо этого. Требует Claude Code версии 2.1.198 или позже |260| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | Установите на `1`, чтобы отключить встроенные [подагенты Explore и Plan](/docs/ru/sub-agents#built-in-subagents). Claude исследует с помощью своих инструментов поиска или подагента общего назначения вместо этого, и [режим плана](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode) читает файлы напрямую, а не запускает агентов Explore и Plan. Пользовательские подагенты с именами `Explore` или `Plan` не затронуты. Чтобы удалить каждый встроенный тип подагента в Agent SDK или неинтерактивном режиме, используйте `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` вместо этого. Требует Claude Code версии 2.1.198 или позже |

262| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Установите на `1`, чтобы отключить файл [checkpointing](/docs/ru/checkpointing). Команда `/rewind` не сможет восстановить изменения кода. Переопределяет параметр [`fileCheckpointingEnabled`](/docs/ru/settings-reference#filecheckpointingenabled) |263| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Установите на `1`, чтобы отключить файл [checkpointing](/docs/ru/checkpointing). Команда `/rewind` не сможет восстановить изменения кода. Переопределяет параметр [`fileCheckpointingEnabled`](/docs/ru/settings-reference#filecheckpointingenabled) |

263| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Установите на `1`, чтобы удалить встроенные инструкции рабочего процесса commit и PR и снимок статуса git из системной подсказки Claude. Полезно при использовании собственных skills рабочего процесса git. Имеет приоритет над параметром [`includeGitInstructions`](/docs/ru/settings-reference#includegitinstructions) при установке |264| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Установите на `1`, чтобы удалить встроенные инструкции рабочего процесса commit и PR и снимок статуса git из системной подсказки Claude. Полезно при использовании собственных skills рабочего процесса git. Имеет приоритет над параметром [`includeGitInstructions`](/docs/ru/settings-reference#includegitinstructions) при установке |

264| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Установите на `1`, чтобы предотвратить автоматическое переотображение Opus 4.0 и 4.1 на текущую версию Opus на API Anthropic. Используйте, когда вы намеренно хотите закрепить более старую модель. Переотображение не выполняется на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry |265| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Установите на `1`, чтобы предотвратить автоматическое переотображение Opus 4.0 и 4.1 на текущую версию Opus на API Anthropic. Используйте, когда вы намеренно хотите закрепить более старую модель. Переотображение не выполняется на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry |

266| `CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK` | Установите на `1`, чтобы остановить Claude Code на [Amazon Bedrock](/docs/ru/amazon-bedrock#when-a-model-is-disabled-mid-session) и [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai#when-a-model-is-disabled-mid-session) от переключения на более старую модель, когда ваша учётная запись теряет доступ к модели сеанса в середине сеанса; отказанный запрос не выполняется сразу вместо этого. [Цепочка модели резервного варианта](/docs/ru/model-config#fallback-model-chains), которую вы настраиваете, по-прежнему переключается на этот отказ, и [проверки модели при запуске](/docs/ru/amazon-bedrock#startup-model-checks) по-прежнему переключаются при запуске. Требует Claude Code версии 2.1.285 или позже |

265| `CLAUDE_CODE_DISABLE_MOUSE` | Установите на `1`, чтобы отключить отслеживание мыши в [полноэкранном рендере](/docs/ru/fullscreen). Прокрутка клавиатуры с `PgUp` и `PgDn` по-прежнему работает. Используйте это, чтобы сохранить собственное поведение копирования при выборе вашего терминала |267| `CLAUDE_CODE_DISABLE_MOUSE` | Установите на `1`, чтобы отключить отслеживание мыши в [полноэкранном рендере](/docs/ru/fullscreen). Прокрутка клавиатуры с `PgUp` и `PgDn` по-прежнему работает. Используйте это, чтобы сохранить собственное поведение копирования при выборе вашего терминала |

266| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | Установите на `1`, чтобы отключить обработку щелчков, перетаскивания и наведения в [полноэкранном рендере](/docs/ru/fullscreen), сохраняя прокрутку колеса мыши. Используйте это, когда вы хотите, чтобы прокрутка колеса работала внутри Claude Code, но не хотите, чтобы щелчки позиционировали курсор, расширяли вывод инструмента или открывали ссылки. `CLAUDE_CODE_DISABLE_MOUSE` имеет приоритет при установке обоих. Требует Claude Code версии 2.1.195 или позже |268| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | Установите на `1`, чтобы отключить обработку щелчков, перетаскивания и наведения в [полноэкранном рендере](/docs/ru/fullscreen) при сохранении прокрутки колеса мыши. Используйте это, когда вы хотите, чтобы прокрутка колеса работала внутри Claude Code, но не хотите, чтобы щелчки позиционировали курсор, расширяли вывод инструмента или открывали ссылки. `CLAUDE_CODE_DISABLE_MOUSE` имеет приоритет при установке обоих. Требует Claude Code версии 2.1.195 или позже |

267| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | Установите на `1`, чтобы остановить Claude Code от повторного чтения [сертификата и ключа клиента mTLS](/docs/ru/network-config#mtls-authentication) при отказе запроса API с ошибкой на уровне подключения, такой как сброс подключения или ошибка TLS handshake. С отключённой перезагрузкой Claude Code загружает повёрнутые файлы только при следующем применении параметров или при следующем запуске. Требует Claude Code версии 2.1.232 или позже |269| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | Установите на `1`, чтобы остановить Claude Code от повторного чтения [сертификата и ключа клиента mTLS](/docs/ru/network-config#mtls-authentication) при отказе запроса API с ошибкой на уровне подключения, такой как сброс подключения или ошибка TLS handshake. С отключённой перезагрузкой Claude Code загружает повёрнутые файлы только при следующем применении параметров или при следующем запуске. Требует Claude Code версии 2.1.232 или позже |

268| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Установите на любое непустое значение, такое как `1`, чтобы отключить несущественный сетевой трафик: автообновления, телеметрию, отчёты об ошибках, команду `/feedback`, [отзывы, составленные Claude](/docs/ru/tools-reference#sendfeedback-tool-behavior), примечания к выпуску, проверки [значка статуса PR и MR](/docs/ru/interactive-mode#pr-review-status) и проверки доступности, такие как проверка [быстрого режима](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways). Это также останавливает [фоновые запуски источников команд плагина](/docs/ru/plugin-marketplaces#when-claude-code-re-runs-the-command), которые являются локальными командами, а не сетевым трафиком, потому что они могут вызвать установку зависимостей. **Установка на `0` или `false` по-прежнему отключает этот трафик**, в отличие от большинства переменных включения/отключения; отмените установку переменной, чтобы разрешить её снова. Также отключает получение флагов функций, что делает [Remote Control](/docs/ru/remote-control#requirements) и другие [функции, которые нуждаются в получении флагов функций](#features-that-need-feature-flag-fetching) недоступными. Автоустановка официального рынка плагинов не охватывается; отключите её с помощью `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. Не влияет на [обнаружение модели шлюза](/docs/ru/llm-gateway-connect#add-gateway-models-to-the-model-picker), которое имеет свой собственный opt-in |270| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Установите на любое непустое значение, такое как `1`, чтобы отключить несущественный сетевой трафик: автообновления, телеметрию, отчёты об ошибках, команду `/feedback`, [отзывы, составленные Claude](/docs/ru/tools-reference#sendfeedback-tool-behavior), примечания к выпуску, проверки [значка статуса PR и MR](/docs/ru/interactive-mode#pr-review-status) и проверки доступности, такие как проверка [быстрого режима](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways). Это также останавливает [фоновые запуски источников команд плагина](/docs/ru/plugins/loading#when-a-command-source-re-runs), которые являются локальными командами, а не сетевым трафиком, потому что они могут вызвать установку зависимостей. **Установка на `0` или `false` по-прежнему отключает этот трафик**, в отличие от большинства переменных включения/отключения; отмените установку переменной, чтобы разрешить её снова. Также отключает получение флагов функций, что делает [Remote Control](/docs/ru/remote-control#requirements) и другие [функции, которые нуждаются в получении флагов функций](#features-that-need-feature-flag-fetching) недоступными. Автоустановка официального рынка плагинов не охватывается; отключите её с помощью `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. Не влияет на [обнаружение модели шлюза](/docs/ru/llm-gateway-connect#add-gateway-models-to-the-model-picker), которое имеет свой собственный opt-in |

269| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Установите на `1`, чтобы отключить резервный вариант без потока, когда потоковый запрос не выполняется в середине потока. Ошибки потока распространяются на уровень повтора вместо этого. Полезно, когда прокси или шлюз вызывает резервный вариант для создания дублирующегося выполнения инструмента |271| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Установите на `1`, чтобы отключить резервный вариант без потока, когда потоковый запрос не выполняется в середине потока. Ошибки потока распространяются на уровень повтора вместо этого. Полезно, когда прокси или шлюз вызывает резервный вариант для создания дублирующегося выполнения инструмента |

270| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | Установите на `1`, чтобы отправить уведомление рабочего стола инструмента `PushNotification` даже во время ввода текста в терминал или его фокусировки. По умолчанию инструмент пропускает как уведомление рабочего стола, так и [мобильный push](/docs/ru/remote-control#mobile-push-notifications), когда обнаруживает недавнюю активность клавиатуры или фокус терминала. Эта переменная отключает только эту локальную проверку, поэтому сервер по-прежнему может подавить мобильный push, когда обнаруживает, что вы активны. Требует Claude Code версии 2.1.193 или позже |272| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | Установите на `1`, чтобы отправить уведомление рабочего стола инструмента `PushNotification` даже во время ввода текста в терминал или его фокусировки. По умолчанию инструмент пропускает как уведомление рабочего стола, так и [мобильный push](/docs/ru/remote-control#mobile-push-notifications), когда обнаруживает недавнюю активность клавиатуры или фокус терминала. Эта переменная отключает только эту локальную проверку, поэтому сервер по-прежнему может подавить мобильный push, когда обнаруживает, что вы активны. Требует Claude Code версии 2.1.193 или позже |

271| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | Установите на `1`, чтобы отключить автоматическую регистрацию официального рынка плагинов. Claude Code читает переменную, когда собирается зарегистрировать рынок, обычно при первом интерактивном запуске машины. Если переменная установлена в этот момент, Claude Code постоянно пропускает регистрацию. Отмена установки переменной позже не отменяет пропуск. Запустите `claude plugin marketplace add anthropics/claude-plugins-official` для регистрации рынка в любое время |273| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | Установите на `1`, чтобы отключить автоматическую регистрацию официального рынка плагинов. Claude Code читает переменную, когда собирается зарегистрировать рынок, обычно при первом интерактивном запуске машины. Если переменная установлена в этот момент, Claude Code постоянно пропускает регистрацию. Отмена установки переменной позже не отменяет пропуск. Запустите `claude plugin marketplace add anthropics/claude-plugins-official` для регистрации рынка в любое время |

272| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Установите на `1`, чтобы остановить Claude Code от запуска ваших [hooks Notification для неотвеченных запросов разрешений](/docs/ru/hooks#notification) в сеансах, где Claude Code отправляет их обратному вызову `canUseTool` Agent SDK, что является тем, как Claude Desktop и расширение VS Code размещают Claude Code. Не имеет эффекта в сеансах терминала. Требует Claude Code версии 2.1.233 или позже |274| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Установите на `1`, чтобы остановить Claude Code от запуска ваших [hooks Notification для неотвеченных запросов разрешений](/docs/ru/hooks#notification) в сеансах, где Claude Code отправляет их обратному вызову `canUseTool` Agent SDK, что является тем, как Claude Desktop и расширение VS Code размещают Claude Code. Не имеет эффекта в сеансах терминала. Требует Claude Code версии 2.1.233 или позже |

273| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Установите на `1`, чтобы пропустить загрузку skills из системного каталога управляемых skills. Полезно для сеансов контейнера или CI, которые не должны загружать skills, предоставленные оператором |275| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Установите на `1`, чтобы пропустить загрузку skills из системного каталога управляемых skills. Полезно для сеансов контейнера или CI, которые не должны загружать skills, предоставленные оператором |

276| `CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY` | Установите на `1`, чтобы отключить проверку [инструмента PowerShell](/docs/ru/tools-reference#powershell-tool), которая отклоняет встроенные команды `cmd` `rd`, `rmdir`, `del` и `erase` на [системном пути](/docs/ru/permission-modes#remove-item-in-powershell), такой как корень диска или ваш домашний каталог. Claude Code игнорирует эту переменную в блоке `env` файла параметров. Требует Claude Code версии 2.1.283 или позже |

277| `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT` | Установите на `1`, чтобы отключить проверку [критических путей](/docs/ru/permission-modes#critical-paths) для рекурсивного `rm`, чей целевой объект полностью является выводом подстановки команды, такой как `rm -rf "$(pwd)"`. Другие проверки критических путей продолжают работать. Установите это в окружении, которое запускает Claude Code, так как Claude Code игнорирует копию, доставленную через блок параметров `env`. Требует Claude Code версии 2.1.281 или позже |

274| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Установите на `1`, чтобы отключить автоматические обновления заголовка терминала на основе контекста разговора. Это также пропускает фоновый запрос модели small/fast для [создания заголовка сеанса](/docs/ru/sessions#name-your-sessions) |278| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Установите на `1`, чтобы отключить автоматические обновления заголовка терминала на основе контекста разговора. Это также пропускает фоновый запрос модели small/fast для [создания заголовка сеанса](/docs/ru/sessions#name-your-sessions) |

275| `CLAUDE_CODE_DISABLE_THINKING` | Установите на `1`, чтобы полностью опустить параметр `thinking` из запросов API. Это вариант совместимости для прокси и шлюзов, которые отклоняют параметр. На моделях, которые думают по умолчанию, опущение параметра означает, что модель может всё ещё думать. Чтобы явно отключить [расширенное мышление](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) на API Anthropic, используйте `MAX_THINKING_TOKENS=0` вместо этого. Ни одна переменная не отключает мышление на Opus 5.5 или моделях Fable, которые не могут иметь отключённое мышление. На [сторонних поставщиках](/docs/ru/third-party-integrations) `MAX_THINKING_TOKENS=0` аналогично опускает параметр, поэтому две переменные ведут себя одинаково там |279| `CLAUDE_CODE_DISABLE_THINKING` | Установите на `1`, чтобы полностью опустить параметр `thinking` из запросов API. Это вариант совместимости для прокси и шлюзов, которые отклоняют параметр. На моделях, которые думают по умолчанию, опущение параметра означает, что модель может всё ещё думать. Чтобы явно отключить [расширенное мышление](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) на API Anthropic, используйте `MAX_THINKING_TOKENS=0` вместо этого. Ни одна переменная не отключает мышление на Opus 5.5, Sonnet 5.5 или моделях Fable, которые не могут иметь отключённое мышление. На [сторонних поставщиках](/docs/ru/third-party-integrations) `MAX_THINKING_TOKENS=0` аналогично опускает параметр, поэтому две переменные ведут себя одинаково там |

276| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Установите на `1`, чтобы пропустить проактивное [автокомпактирование](/docs/ru/costs#reduce-token-usage) когда Claude Code не распознаёт ID модели, такой как [LLM gateway](/docs/ru/llm-gateway) псевдоним. Без этой переменной Claude Code компактирует при окне контекста, которое он предполагает для ID. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` может вместо этого исправить предполагаемое окно; см. [Исправить окно для ID шлюза или пользовательской модели](/docs/ru/model-config#correct-the-window-for-a-gateway-or-custom-model-id) для того, когда каждая переменная применяется. Требует Claude Code версии 2.1.223 или позже |280| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Установите на `1`, чтобы пропустить проактивное [автокомпактирование](/docs/ru/costs#reduce-token-usage) когда Claude Code не распознаёт ID модели, такой как [LLM gateway](/docs/ru/llm-gateway) псевдоним. Без этой переменной Claude Code компактирует при окне контекста, которое он предполагает для ID. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` может вместо этого исправить предполагаемое окно; см. [Исправить окно для ID шлюза или пользовательской модели](/docs/ru/model-config#correct-the-window-for-a-gateway-or-custom-model-id) для того, когда каждая переменная применяется. Требует Claude Code версии 2.1.223 или позже |

277| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Установите на `1`, чтобы отключить виртуальную прокрутку в [полноэкранном рендере](/docs/ru/fullscreen) и отобразить каждое сообщение в стенограмме. Используйте это, если прокрутка в полноэкранном режиме показывает пустые области, где должны появиться сообщения |281| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Установите на `1`, чтобы отключить виртуальную прокрутку в [полноэкранном рендере](/docs/ru/fullscreen) и отобразить каждое сообщение в стенограмме. Используйте это, если прокрутка в полноэкранном режиме показывает пустые области, где должны появиться сообщения |

278| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Установите на `1`, чтобы запустить команды [инструмента PowerShell](/docs/ru/tools-reference#powershell-tool) на Windows напрямую вместо использования средства запуска `cmd.exe`. По умолчанию средство запуска позволяет команде PowerShell [работающей в фоне](/docs/ru/tools-reference#background-commands) [переносить на процесс следующего сеанса](/docs/ru/agent-view#the-supervisor-process), например, когда вы [фоновый сеанс](/docs/ru/agent-view#from-inside-a-session). Если вы установите переменную, фоновая команда PowerShell останавливается при выходе процесса сеанса. Команды Bash не затронуты. Требует Claude Code версии 2.1.269 или позже |282| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Установите на `1`, чтобы запустить команды [инструмента PowerShell](/docs/ru/tools-reference#powershell-tool) на Windows напрямую вместо использования средства запуска `cmd.exe`. По умолчанию средство запуска позволяет команде PowerShell [работающей в фоне](/docs/ru/tools-reference#background-commands) [переносить на процесс следующего сеанса](/docs/ru/agent-view#the-supervisor-process), например, когда вы [фоновый сеанс](/docs/ru/agent-view#from-inside-a-session). Если вы установите переменную, фоновая команда PowerShell останавливается при выходе процесса сеанса. Команды Bash не затронуты. Требует Claude Code версии 2.1.269 или позже |

281| `CLAUDE_CODE_ENABLE_AUTO_MODE` | Принято для совместимости со старыми выпусками и не имеет эффекта. Автоматический режим доступен по умолчанию на каждом поставщике, включая Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и сеансы [Claude apps gateway](/docs/ru/claude-apps-gateway) с входом. В версиях 2.1.158 через 2.1.206 установка на `1` была необходима для доступности [автоматического режима](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) на этих поставщиках |285| `CLAUDE_CODE_ENABLE_AUTO_MODE` | Принято для совместимости со старыми выпусками и не имеет эффекта. Автоматический режим доступен по умолчанию на каждом поставщике, включая Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и сеансы [Claude apps gateway](/docs/ru/claude-apps-gateway) с входом. В версиях 2.1.158 через 2.1.206 установка на `1` была необходима для доступности [автоматического режима](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) на этих поставщиках |

282| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Переопределить доступность [сводки сеанса](/docs/ru/interactive-mode#session-recap). Установите на `0`, чтобы принудительно отключить сводки независимо от переключателя `/config`. Установите на `1`, чтобы принудительно включить сводки, когда [`awaySummaryEnabled`](/docs/ru/settings-reference#awaysummaryenabled) имеет значение `false`. Имеет приоритет над параметром и переключателем `/config` |286| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Переопределить доступность [сводки сеанса](/docs/ru/interactive-mode#session-recap). Установите на `0`, чтобы принудительно отключить сводки независимо от переключателя `/config`. Установите на `1`, чтобы принудительно включить сводки, когда [`awaySummaryEnabled`](/docs/ru/settings-reference#awaysummaryenabled) имеет значение `false`. Имеет приоритет над параметром и переключателем `/config` |

283| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Установите на `1`, чтобы обновить состояние плагина на границах хода в [неинтерактивном режиме](/docs/ru/headless) после завершения фоновой установки. Отключено по умолчанию, потому что обновление изменяет системную подсказку в середине сеанса, что делает недействительным [кэширование подсказок](/docs/ru/prompt-caching) для этого хода |287| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Установите на `1`, чтобы обновить состояние плагина на границах хода в [неинтерактивном режиме](/docs/ru/headless) после завершения фоновой установки. Отключено по умолчанию, потому что обновление изменяет системную подсказку в середине сеанса, что делает недействительным [кэширование подсказок](/docs/ru/prompt-caching) для этого хода |

284| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Установите на `1`, чтобы направить опрос качества сеанса "How is Claude doing?" на ваш собственный [сборщик OpenTelemetry](/docs/ru/monitoring-usage), когда трафик несущественный, связанный с Anthropic, заблокирован. Рейтинги опроса выдаются только как события OTEL вашему настроенному сборщику. Никакие данные опроса не отправляются Anthropic в этом режиме. Применяется, когда установлены `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` или `DO_NOT_TRACK`, и не имеет эффекта в противном случае. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` и политика отзывов организации имеют приоритет |288| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Установите на `1`, чтобы направить опрос качества сеанса "How is Claude doing?" на ваш собственный [сборщик OpenTelemetry](/docs/ru/monitoring-usage) когда трафик несущественный, связанный с Anthropic, заблокирован. Рейтинги опроса выдаются только как события OTEL вашему настроенному сборщику. Никакие данные опроса не отправляются Anthropic в этом режиме. Применяется, когда установлены `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` или `DO_NOT_TRACK`, и не имеет эффекта в противном случае. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` и политика отзывов организации имеют приоритет |

285| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Контролирует, потоком ли входные данные вызова инструмента из API по мере их создания Claude. При отключении большой вход инструмента, такой как длинная запись файла, поступает только после завершения создания Claude, что может выглядеть как зависание. Включено по умолчанию на API Anthropic. На Amazon Bedrock и Google Cloud's Agent Platform включено для каждой модели, где развёрнутый контейнер это поддерживает. Установите на `0`, чтобы отказаться. Установите на `1`, чтобы принудительно включить при маршрутизации через прокси через `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` или `ANTHROPIC_BEDROCK_BASE_URL`. Отключено по умолчанию на Microsoft Foundry и подключениях [шлюза](/docs/ru/llm-gateway) |289| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Контролирует, потоком ли входные данные вызова инструмента из API по мере их создания Claude. При отключении большой вход инструмента, такой как длинная запись файла, поступает только после завершения создания Claude, что может выглядеть как зависание. Включено по умолчанию на API Anthropic. На Amazon Bedrock и Google Cloud's Agent Platform включено для каждой модели, где развёрнутый контейнер это поддерживает. Установите на `0`, чтобы отказаться. Установите на `1`, чтобы принудительно включить при маршрутизации через прокси через `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` или `ANTHROPIC_BEDROCK_BASE_URL`. Отключено по умолчанию на Microsoft Foundry и подключениях [шлюза](/docs/ru/llm-gateway) |

286| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Установите на `1`, чтобы заполнить средство выбора `/model` из конечной точки `/v1/models` вашего шлюза, когда `ANTHROPIC_BASE_URL` указывает на совместимый с Anthropic шлюз, такой как LiteLLM, Kong или внутренний прокси. Отключено по умолчанию, потому что шлюзы, поддерживаемые общим ключом API, в противном случае показали бы каждому пользователю каждую модель, к которой может получить доступ ключ. Обнаруженные модели по-прежнему фильтруются по [`availableModels`](/docs/ru/settings-reference#availablemodels) списку разрешений, который получает сеанс; доставьте список через [MDM или файл управляемых параметров](/docs/ru/managed-settings#delivery-mechanisms), так как [доставка, управляемая сервером, недоступна на конфигурациях шлюза](/docs/ru/server-managed-settings#platform-availability) |290| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Установите на `1`, чтобы заполнить средство выбора `/model` из конечной точки `/v1/models` вашего шлюза, когда `ANTHROPIC_BASE_URL` указывает на совместимый с Anthropic шлюз, такой как LiteLLM, Kong или внутренний прокси. Отключено по умолчанию, потому что шлюзы, поддерживаемые общим ключом API, в противном случае показали бы каждому пользователю каждую модель, к которой может получить доступ ключ. Обнаруженные модели по-прежнему фильтруются по [`availableModels`](/docs/ru/settings-reference#availablemodels) списку разрешений, который получает сеанс; доставьте список через [MDM или файл управляемых параметров](/docs/ru/managed-settings#delivery-mechanisms), так как [доставка, управляемая сервером, недоступна на конфигурациях шлюза](/docs/ru/server-managed-settings#platform-availability) |

287| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | Удалено в версии 2.1.142, когда [быстрый режим](/docs/ru/fast-mode) по умолчанию переместился с Opus 4.6 на Opus 4.7 |291| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | Удалено в версии 2.1.142, когда [быстрый режим](/docs/ru/fast-mode) по умолчанию переместился с Opus 4.6 на Opus 4.7 |

288| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Установите на `false`, чтобы отключить предложения подсказок, серые предсказания, которые появляются в вводе подсказки. Имеет приоритет над параметром [`promptSuggestionEnabled`](/docs/ru/settings-reference#promptsuggestionenabled), который записывает переключатель **Prompt suggestions** в `/config`. Claude Code также [приостанавливает предложения, пока ваша учётная запись близка к или находится на пределе использования](/docs/ru/interactive-mode#when-claude-code-skips-suggestions). Установите на `true`, чтобы сохранить их включёнными до достижения лимита. Требует Claude Code версии 2.1.238 или позже. См. [Предложения подсказок](/docs/ru/interactive-mode#prompt-suggestions) |292| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Установите на `false`, чтобы отключить предложения подсказок, серые предсказания, которые появляются в вводе подсказки. Имеет приоритет над параметром [`promptSuggestionEnabled`](/docs/ru/settings-reference#promptsuggestionenabled), который записывает переключатель **Prompt suggestions** в `/config`. Claude Code также [приостанавливает предложения, пока ваша учётная запись близка к или находится на пределе использования](/docs/ru/interactive-mode#when-claude-code-skips-suggestions). Установите на `true`, чтобы сохранить их включёнными до достижения лимита. Требует Claude Code версии 2.1.238 или позже. См. [Предложения подсказок](/docs/ru/interactive-mode#prompt-suggestions) |

289| `CLAUDE_CODE_ENABLE_TASKS` | Выбирает, какие инструменты отслеживания задач Claude Code предоставляет в [сеансах, которые их имеют](/docs/ru/tools-reference#task-tool-availability). По умолчанию Claude Code предоставляет инструменты Task `TaskCreate`, `TaskUpdate`, `TaskGet` и `TaskList`. Установите на `0`, чтобы получить вместо этого устаревший инструмент `TodoWrite`. См. [Список задач](/docs/ru/interactive-mode#task-list) |293| `CLAUDE_CODE_ENABLE_TASKS` | Выбирает, какие инструменты отслеживания задач Claude Code предоставляет в [сеансах, которые их имеют](/docs/ru/tools-reference#task-tool-availability). По умолчанию Claude Code предоставляет инструменты Task `TaskCreate`, `TaskUpdate`, `TaskGet` и `TaskList`. Установите на `0`, чтобы получить вместо этого устаревший инструмент `TodoWrite`. См. [Список задач](/docs/ru/interactive-mode#task-list) |

290| `CLAUDE_CODE_ENABLE_TELEMETRY` | Установите на `1`, чтобы включить сбор данных OpenTelemetry для метрик и логирования. Требуется перед настройкой экспортёров OTel. См. [Мониторинг](/docs/ru/monitoring-usage) |294| `CLAUDE_CODE_ENABLE_TELEMETRY` | Установите на `1`, чтобы включить сбор данных OpenTelemetry для метрик и логирования. Требуется перед настройкой экспортёров OTel. Установите это в вашей оболочке, пользовательских параметрах или управляемых параметрах. Игнорируется в [параметрах проекта и локальных параметрах](/docs/ru/settings-reference#variables-claude-code-ignores-in-env). См. [Мониторинг](/docs/ru/monitoring-usage) |

291| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | Установите на `1`, чтобы получить инструменты отслеживания задач на каждой модели. Без этого Claude Code предоставляет их по умолчанию только на моделях, перечисленных в [Доступность инструмента Task](/docs/ru/tools-reference#task-tool-availability). `CLAUDE_CODE_ENABLE_TASKS` по-прежнему выбирает инструменты Task или `TodoWrite`. Требует Claude Code версии 2.1.233 или позже |295| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | Установите на `1`, чтобы получить инструменты отслеживания задач на каждой модели. Без этого Claude Code предоставляет их по умолчанию только на моделях, перечисленных в [Доступность инструмента Task](/docs/ru/tools-reference#task-tool-availability). `CLAUDE_CODE_ENABLE_TASKS` по-прежнему выбирает инструменты Task или `TodoWrite`. Требует Claude Code версии 2.1.233 или позже |

292| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Время в миллисекундах для ожидания после того, как цикл запроса становится неактивным, перед автоматическим выходом. Полезно для автоматизированных рабочих процессов и скриптов, использующих режим SDK |296| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Время в миллисекундах для ожидания после того, как цикл запроса становится неактивным, перед автоматическим выходом. Полезно для автоматизированных рабочих процессов и скриптов, использующих режим SDK |

293| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Установите на `1`, чтобы включить [команды агентов](/docs/ru/agent-teams). Команды агентов являются экспериментальными и отключены по умолчанию |297| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Установите на `1`, чтобы включить [команды агентов](/docs/ru/agent-teams). Команды агентов являются экспериментальными и отключены по умолчанию |

341| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Установите на `1`, чтобы позволить Claude Code запустить команду обновления вашего менеджера пакетов в фоне, когда доступна новая версия. Применяется к установкам Homebrew и WinGet. Другие менеджеры пакетов продолжают показывать команду обновления без её запуска. См. [Автообновления](/docs/ru/setup#auto-updates) |345| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Установите на `1`, чтобы позволить Claude Code запустить команду обновления вашего менеджера пакетов в фоне, когда доступна новая версия. Применяется к установкам Homebrew и WinGet. Другие менеджеры пакетов продолжают показывать команду обновления без её запуска. См. [Автообновления](/docs/ru/setup#auto-updates) |

342| `CLAUDE_CODE_PERFORCE_MODE` | Установите на `1`, чтобы включить защиту записи, осведомлённую о Perforce. При установке Edit, Write и NotebookEdit не выполняются с подсказкой `p4 edit <file>`, если целевой файл не имеет бита владельца-записи, который Perforce очищает на синхронизированных файлах до `p4 edit` их открытия. Это предотвращает Claude Code от обхода отслеживания изменений Perforce |346| `CLAUDE_CODE_PERFORCE_MODE` | Установите на `1`, чтобы включить защиту записи, осведомлённую о Perforce. При установке Edit, Write и NotebookEdit не выполняются с подсказкой `p4 edit <file>`, если целевой файл не имеет бита владельца-записи, который Perforce очищает на синхронизированных файлах до `p4 edit` их открытия. Это предотвращает Claude Code от обхода отслеживания изменений Perforce |

343| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Переопределить корневой каталог плагинов. Несмотря на имя, это устанавливает родительский каталог, а не сам кэш: рынки и кэш плагинов находятся в подкаталогах под этим путём. По умолчанию `~/.claude/plugins` |347| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Переопределить корневой каталог плагинов. Несмотря на имя, это устанавливает родительский каталог, а не сам кэш: рынки и кэш плагинов находятся в подкаталогах под этим путём. По умолчанию `~/.claude/plugins` |

344| `CLAUDE_CODE_PLUGIN_DIRS` | Каталоги плагинов для загрузки для сеанса, каждый загруженный способом, которым флаг [`--plugin-dir`](/docs/ru/plugins#test-your-plugins-locally) загружает его. Разделите несколько путей с `:` на Unix или `;` на Windows. Дайте каждый путь как абсолютный путь или начните его с `~`, потому что Claude Code пропускает относительные пути. Требует Claude Code версии 2.1.280 или позже |348| `CLAUDE_CODE_PLUGIN_DIRS` | Каталоги плагинов для загрузки для сеанса, каждый загруженный способом, которым флаг [`--plugin-dir`](/docs/ru/plugins/cli-reference#flags-that-load-a-plugin-for-one-session) загружает его. Разделите несколько путей с `:` на Unix или `;` на Windows. Дайте каждый путь как абсолютный путь или начните его с `~`, потому что Claude Code пропускает относительные пути. Требует Claude Code версии 2.1.280 или позже. См. [Загрузить плагин для одного сеанса](/docs/ru/plugins/create#load-a-directory-or-archive-for-one-session) |

345| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Таймаут в миллисекундах для операций git при установке или обновлении плагинов (по умолчанию: 120000). Увеличьте это значение для больших репозиториев или медленных сетевых подключений. См. [Операции Git истекают](/docs/ru/plugin-marketplaces#git-operations-time-out) |349| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Таймаут в миллисекундах для операций git при установке или обновлении плагинов (по умолчанию: 120000). Увеличьте это значение для больших репозиториев или медленных сетевых подключений. См. [Операции Git истекают](/docs/ru/plugins/troubleshooting#git-clone-timed-out-after-120s) |

346| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Установите на `1`, чтобы пропустить попытку повторного клонирования и продолжить использование существующего клона рынка, когда обновление рынка не может достичь или аутентифицироваться на удалённом источнике. Полезно в автономных или изолированных окружениях, где повторное клонирование не выполнилось бы так же. См. [Обновления рынка не выполняются в автономных окружениях](/docs/ru/plugin-marketplaces#marketplace-updates-fail-in-offline-environments) |350| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Установите на `1`, чтобы пропустить попытку повторного клонирования и продолжить использование существующего клона рынка, когда обновление рынка не может достичь или аутентифицироваться на удалённом источнике. Полезно в автономных или изолированных окружениях, где повторное клонирование не выполнилось бы так же. См. [Обновления рынка не выполняются в автономных окружениях](/docs/ru/plugins/troubleshooting#marketplace-updates-keep-failing-offline) |

347| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Установите на `1`, чтобы клонировать сокращённые источники GitHub `owner/repo` через HTTPS вместо SSH. Применяется к установке и обновлению плагина, а также к `/plugin marketplace add` и `update`. Полезно в средах CI, контейнерах или любом окружении без настроенного ключа SSH для `github.com` |351| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Установите на `1`, чтобы клонировать сокращённые источники GitHub `owner/repo` через HTTPS вместо SSH. Применяется к установке и обновлению плагина, а также к `/plugin marketplace add` и `update`. Полезно в средах CI, контейнерах или любом окружении без настроенного ключа SSH для `github.com` |

348| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Путь к одному или нескольким каталогам семян плагинов только для чтения, разделённым `:` на Unix или `;` на Windows. Используйте это, чтобы упаковать предварительно заполненный каталог плагинов в образ контейнера. Claude Code регистрирует рынки из этих каталогов при запуске и использует предварительно кэшированные плагины без повторного клонирования. См. [Предварительно заполнить плагины для контейнеров](/docs/ru/plugin-marketplaces#pre-populate-plugins-for-containers) |352| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Путь к одному или нескольким каталогам семян плагинов только для чтения, разделённым `:` на Unix или `;` на Windows. Используйте это, чтобы упаковать предварительно заполненный каталог плагинов в образ контейнера. Claude Code регистрирует рынки из этих каталогов при запуске и использует предварительно кэшированные плагины без повторного клонирования. См. [Предварительно заполнить плагины для контейнеров](/docs/ru/plugins/org#seed-containers-and-ci) |

349| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Установите на `1`, чтобы остановить Claude Code от передачи `-ExecutionPolicy Bypass` при порождении PowerShell для вызовов инструментов, hooks и команд строки состояния, и вместо этого соблюдать эффективную политику выполнения машины. По умолчанию Claude Code обходит политику выполнения в области процесса, поэтому скрипты `.ps1` и импорты модулей работают на установках Windows с ограничением по умолчанию. Обход области процесса никогда не переопределяет Group Policy `MachinePolicy` или `UserPolicy` независимо от этого параметра |353| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Установите на `1`, чтобы остановить Claude Code от передачи `-ExecutionPolicy Bypass` при порождении PowerShell для вызовов инструментов, hooks и команд строки состояния, и вместо этого соблюдать эффективную политику выполнения машины. По умолчанию Claude Code обходит политику выполнения в области процесса, поэтому скрипты `.ps1` и импорты модулей работают на установках Windows с ограничением по умолчанию. Обход области процесса никогда не переопределяет Group Policy `MachinePolicy` или `UserPolicy` независимо от этого параметра |

350| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | Потолок в миллисекундах на ожидание простоя для фоновых подагентов и workflows после финального хода в [неинтерактивном режиме](/docs/ru/headless#background-tasks-at-exit) с флагом `-p`. Ожидание простоя начинается заново каждый раз, когда Claude берёт ход для обработки результата фона. По умолчанию: `600000` или 10 минут. Когда ожидание простоя достигает потолка, Claude Code перестаёт ждать оставшихся фоновых задач и выходит. Установите на `0`, чтобы ждать бесконечно. Этот потолок отделён от пятисекундного периода благодарности, который применяется к простым фоновым оболочкам. Требует Claude Code версии 2.1.182 или позже |354| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | Потолок в миллисекундах на ожидание простоя для фоновых подагентов и workflows после финального хода в [неинтерактивном режиме](/docs/ru/headless#background-tasks-at-exit) с флагом `-p`. Ожидание простоя начинается заново каждый раз, когда Claude берёт ход для обработки результата фона. По умолчанию: `600000` или 10 минут. Когда ожидание простоя достигает потолка, Claude Code перестаёт ждать оставшихся фоновых задач и выходит. Установите на `0`, чтобы ждать бесконечно. Этот потолок отделён от пятисекундного периода благодарности, который применяется к простым фоновым оболочкам. Требует Claude Code версии 2.1.182 или позже |

351| `CLAUDE_CODE_PROCESS_WRAPPER` | Запустить процессы, которые Claude Code запускает из своего собственного двоичного файла, такие как фоновый сервис, который размещает сеансы [представления агента](/docs/ru/agent-view), через корпоративный средство запуска, заданное как префикс argv, такой как `/opt/corp/launcher`. Установите это в блоке `env` пользовательских или [управляемых параметров](/docs/ru/managed-settings), а не как экспорт оболочки, поэтому отделённый фоновый сервис его наследует; параметры проекта и локальные параметры не могут его установить. Эквивалентно параметру [`processWrapper`](/docs/ru/settings-reference#processwrapper), который требует Claude Code версии 2.1.210 или позже; эта переменная имеет приоритет при установке обоих. Расширение VS Code настраивает свой собственный средство запуска отдельно через параметр `claudeProcessWrapper`. Игнорируется на Windows. См. [Запустить Claude Code за корпоративным средством запуска](/docs/ru/corporate-launcher) для формата значения, что охватывает средство запуска и контракт, который должно удовлетворять средство запуска. Требует Claude Code версии 2.1.208 или позже |355| `CLAUDE_CODE_PROCESS_WRAPPER` | Запустить процессы, которые Claude Code запускает из своего собственного двоичного файла, такие как фоновый сервис, который размещает сеансы [представления агента](/docs/ru/agent-view), через корпоративный средство запуска, заданное как префикс argv, такой как `/opt/corp/launcher`. Установите это в блоке `env` пользовательских или [управляемых параметров](/docs/ru/managed-settings), а не как экспорт оболочки, поэтому отделённый фоновый сервис его наследует; параметры проекта и локальные параметры не могут его установить. Эквивалентно параметру [`processWrapper`](/docs/ru/settings-reference#processwrapper), который требует Claude Code версии 2.1.210 или позже; эта переменная имеет приоритет при установке обоих. Расширение VS Code настраивает свой собственный средство запуска отдельно через параметр `claudeProcessWrapper`. Игнорируется на Windows. См. [Запустить Claude Code за корпоративным средством запуска](/docs/ru/corporate-launcher) для формата значения, что охватывает средство запуска и контракт, который должно удовлетворять средство запуска. Требует Claude Code версии 2.1.208 или позже |

352| `CLAUDE_CODE_PROJECT_DIR_NAME` | Установите вместе с `CLAUDE_CONFIG_DIR`, чтобы выбрать имя каталога `projects/`, в котором Claude Code хранит стенограммы этого сеанса и автоматическую память, вместо одного, полученного из пути рабочего каталога. Например, запуск Claude Code с `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` хранит их в `/srv/tenant-a/projects/work/`. Claude Code игнорирует эту переменную, когда `CLAUDE_CONFIG_DIR` не установлен, и читает её только из окружения, которое вы запускаете `claude` из, никогда из блока параметров `env` [параметров файла](#in-settings-files). См. [Назовите каталог проекта сами](/docs/ru/sessions#name-the-project-directory-yourself). Требует Claude Code версии 2.1.234 или позже |356| `CLAUDE_CODE_PROJECT_DIR_NAME` | Установите вместе с `CLAUDE_CONFIG_DIR`, чтобы выбрать имя каталога `projects/`, в котором Claude Code хранит стенограммы этого сеанса и автоматическую память, вместо одного, полученного из пути рабочего каталога. Например, запуск Claude Code с `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` хранит их под `/srv/tenant-a/projects/work/`. Claude Code игнорирует эту переменную, когда `CLAUDE_CONFIG_DIR` не установлен, и читает её только из окружения, которое вы запускаете `claude` из, никогда из блока параметров `env` [параметров файла](#in-settings-files). См. [Назовите каталог проекта сами](/docs/ru/sessions#name-the-project-directory-yourself). Требует Claude Code версии 2.1.234 или позже |

353| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Установите `5m` или `1h`, единственные значения, которые Claude Code принимает, чтобы выбрать [TTL кэша подсказок](/docs/ru/prompt-caching#cache-lifetime) для основного разговора: ваши интерактивные, `-p` и SDK ходы, плюс помощники, которые работают встроенно с ними. Имеет приоритет над параметром `promptCacheTtl` и над `ENABLE_PROMPT_CACHING_1H`, и `FORCE_PROMPT_CACHING_5M` переопределяет его. API выставляет счета за записи кэша на 1 час по более высокой ставке. Требует Claude Code версии 2.1.242 или позже |357| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Установите `5m` или `1h`, единственные значения, которые Claude Code принимает, чтобы выбрать [TTL кэша подсказок](/docs/ru/prompt-caching#cache-lifetime) для основного разговора: ваши интерактивные, `-p` и SDK ходы, плюс помощники, которые работают встроенно с ними. Имеет приоритет над параметром `promptCacheTtl` и над `ENABLE_PROMPT_CACHING_1H`, и `FORCE_PROMPT_CACHING_5M` переопределяет его. API выставляет счета за записи кэша на 1 час по более высокой ставке. Требует Claude Code версии 2.1.242 или позже |

354| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Установите на `1`, чтобы распространять контекст трассировки W3C, когда `ANTHROPIC_BASE_URL` указывает на пользовательский прокси. Распространение охватывает заголовок `traceparent` на запросах модели и HTTP MCP и переменную окружения `TRACEPARENT` для подпроцессов Bash, PowerShell и hook. По умолчанию распространение включено только при прямом подключении к API Anthropic. Добавлено в версии 2.1.152. См. [Трассировки (бета)](/docs/ru/monitoring-usage#traces-beta) |358| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Установите на `1`, чтобы распространять контекст трассировки W3C, когда `ANTHROPIC_BASE_URL` указывает на пользовательский прокси. Распространение охватывает заголовок `traceparent` на запросах модели и HTTP MCP и переменную окружения `TRACEPARENT` для подпроцессов Bash, PowerShell и hook. По умолчанию распространение включено только при прямом подключении к API Anthropic. Добавлено в версии 2.1.152. См. [Трассировки (бета)](/docs/ru/monitoring-usage#traces-beta) |

355| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Установлено хост-платформами, которые встраивают Claude Code и управляют маршрутизацией поставщика модели от его имени. При установке Claude Code игнорирует переменные выбора поставщика, конечной точки и аутентификации, такие как `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` и `ANTHROPIC_API_KEY` в файлах параметров, поэтому пользовательские параметры не могут переопределить маршрутизацию хоста. Claude Code также игнорирует ключи выбора модели, такие как `model`, `fallbackModel` и `modelOverrides` в [управляемых параметрах](/docs/ru/managed-settings), какой бы управляемый источник их не доставлял, поэтому конфигурация модели хоста имеет приоритет над устаревшей закреплённой моделью. Claude Code также игнорирует переменные выбора модели, такие как `ANTHROPIC_MODEL` и семейство `ANTHROPIC_DEFAULT_*_MODEL` в управляемом блоке `env`; список разрешений [`availableModels`](/docs/ru/model-config#restrict-model-selection) в управляемых параметрах по-прежнему применяется, если только хост не предоставляет свой собственный. Claude Code также пропускает автоматический отказ от телеметрии, который он в противном случае применяет на сторонних поставщиках, таких как Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform и Microsoft Foundry, поэтому телеметрия следует стандартному отказу `DISABLE_TELEMETRY`. См. [Поведение по умолчанию по поставщику API](/docs/ru/data-usage#default-behaviors-by-api-provider) |359| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Установлено хост-платформами, которые встраивают Claude Code и управляют маршрутизацией поставщика модели от его имени. При установке Claude Code игнорирует переменные выбора поставщика, конечной точки и аутентификации, такие как `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` и `ANTHROPIC_API_KEY` в файлах параметров, поэтому пользовательские параметры не могут переопределить маршрутизацию хоста. Claude Code также игнорирует ключи выбора модели, такие как `model`, `fallbackModel` и `modelOverrides` в [управляемых параметрах](/docs/ru/managed-settings), какой бы управляемый источник их не доставлял, поэтому конфигурация модели хоста имеет приоритет над устаревшей закреплённой моделью. Claude Code также игнорирует переменные выбора модели, такие как `ANTHROPIC_MODEL` и семейство `ANTHROPIC_DEFAULT_*_MODEL` в управляемом блоке `env`; список разрешений [`availableModels`](/docs/ru/model-config#restrict-model-selection) в управляемых параметрах по-прежнему применяется, если только хост не предоставляет свой собственный. Claude Code также пропускает автоматический отказ от телеметрии, который он в противном случае применяет на сторонних поставщиках, таких как Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform и Microsoft Foundry, поэтому телеметрия следует стандартному отказу `DISABLE_TELEMETRY`. См. [Поведение по умолчанию по поставщику API](/docs/ru/data-usage#default-behaviors-by-api-provider) |

359| `CLAUDE_CODE_RESTRICTED` | Установите на `1`, чтобы запустить сеанс в ограниченном режиме, то же самое, что передача [`--restricted`](/docs/ru/cli-reference#cli-flags). Claude Code игнорирует эту переменную в блоке `env` файла параметров. Требует Claude Code версии 2.1.248 или позже |363| `CLAUDE_CODE_RESTRICTED` | Установите на `1`, чтобы запустить сеанс в ограниченном режиме, то же самое, что передача [`--restricted`](/docs/ru/cli-reference#cli-flags). Claude Code игнорирует эту переменную в блоке `env` файла параметров. Требует Claude Code версии 2.1.248 или позже |

360| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Установите на `1`, чтобы автоматически возобновить, если предыдущий сеанс закончился в середине хода. Используется в режиме SDK, поэтому модель продолжает без требования SDK повторно отправить подсказку. Чтобы отключить это, отмените установку переменной или установите её на `0`. До версии 2.1.221 Claude Code игнорировал `0` и другие ложные значения, поэтому установка `0` по-прежнему срабатывала возобновление в неинтерактивном режиме и отмена установки переменной была единственным способом отключить это |364| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Установите на `1`, чтобы автоматически возобновить, если предыдущий сеанс закончился в середине хода. Используется в режиме SDK, поэтому модель продолжает без требования SDK повторно отправить подсказку. Чтобы отключить это, отмените установку переменной или установите её на `0`. До версии 2.1.221 Claude Code игнорировал `0` и другие ложные значения, поэтому установка `0` по-прежнему срабатывала возобновление в неинтерактивном режиме и отмена установки переменной была единственным способом отключить это |

361| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | Максимальный возраст в миллисекундах последнего сообщения стенограммы для сеанса, который закончился в середине хода, чтобы автоматически продолжить при возобновлении. Когда последнее сообщение старше этого ограничения, Claude Code пропускает как автоматическое возобновление `CLAUDE_CODE_RESUME_INTERRUPTED_TURN`, так и введённое сообщение продолжения `CLAUDE_CODE_RESUME_PROMPT`, и сеанс начинается неактивным, чтобы вы продолжили явно. Отсутствие или `0` означает отсутствие ограничения, за исключением того, что ход, чей последний запрос не выполнился с ошибкой API, возобновляется только пока эта ошибка менее шести часов. Положительное значение ограничивает каждый ход, включая те; отрицательное или нечисловое значение применяет ограничение в один час. Скрипты порождения для долгоживущих агентов могут установить это, чтобы перезагрузка против старой стенограммы не повторно запускала устаревшую подсказку. Claude Code устанавливает ограничение в один час сам, когда перезагружает сбойный сеанс [представления агента](/docs/ru/agent-view), который унаследовал свой разговор из интерактивного сеанса. Требует Claude Code версии 2.1.211 или позже |365| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | Максимальный возраст в миллисекундах последнего сообщения стенограммы для сеанса, который закончился в середине хода, чтобы автоматически продолжить при возобновлении. Когда последнее сообщение старше этого ограничения, Claude Code пропускает как автоматическое возобновление `CLAUDE_CODE_RESUME_INTERRUPTED_TURN`, так и введённое сообщение продолжения `CLAUDE_CODE_RESUME_PROMPT`, и сеанс начинается неактивным, чтобы вы продолжили явно. Отсутствие или `0` означает отсутствие ограничения, за исключением того, что ход, чей последний запрос не выполнился с ошибкой API, возобновляется только пока эта ошибка менее шести часов. Положительное значение ограничивает каждый ход, включая те; отрицательное или нечисловое значение применяет ограничение в один час. Скрипты порождения для долгоживущих агентов могут установить это, чтобы перезагрузка против старой стенограммы не повторно запускала устаревшую подсказку. Claude Code устанавливает ограничение в один час сам, когда перезагружает сбойный сеанс [представления агента](/docs/ru/agent-view), который унаследовал свой разговор из интерактивного сеанса. Требует Claude Code версии 2.1.211 или позже |

362| `CLAUDE_CODE_RESUME_PROMPT` | Переопределить сообщение продолжения, введённое при возобновлении сеанса, который закончился в середине хода. По умолчанию `Continue from where you left off.`. Скрипты порождения для долгоживущих агентов могут установить это на более директивное сообщение загрузки. Пустая строка использует значение по умолчанию |366| `CLAUDE_CODE_RESUME_PROMPT` | Переопределить сообщение продолжения, введённое при возобновлении сеанса, который закончился в середине хода. По умолчанию `Continue from where you left off.`. Пустая строка использует значение по умолчанию |

363| `CLAUDE_CODE_RETRY_WATCHDOG` | Установите на `1` для неконтролируемых сеансов, таких как оценочные средства, задачи CI или удалённые рабочие. Повторяет ошибки ёмкости `429` и `529` бесконечно вместо отказа после попыток `CLAUDE_CODE_MAX_RETRIES`. Claude Code не выполняется сразу, когда запрос стандартной скорости получает `429`, который сообщает об ограничении расходов или исчерпанных кредитах использования, даже один из [ограничения расходов шлюза](/docs/ru/errors#spend-limit-reached), который сбрасывается по расписанию. До версии 2.1.239 сторож повторял эти бесконечно. Для запросов быстрого режима см. [Обработка ограничений скорости](/docs/ru/fast-mode#handle-rate-limits). Сторож отступает до 5 минут между попытками или до сброса ограничения, когда ответ несёт время сброса ограничения скорости, поэтому сеанс, который попадает на ограничение использования, ждёт оставшегося окна. На версии 2.1.199 или позже он также повышает количество повторов по умолчанию для других переходных ошибок, таких как ошибки сервера, таймауты и отброшенные подключения, до 300, примерно три часа отступления, и удаляет ограничение 15 на `CLAUDE_CODE_MAX_RETRIES`, если вы явно установите эту переменную. Требует Claude Code версии 2.1.186 или позже |367| `CLAUDE_CODE_RETRY_WATCHDOG` | Установите на `1` для неконтролируемых сеансов, таких как оценочные средства, задачи CI или удалённые рабочие. Повторяет ошибки ёмкости `429` и `529` бесконечно вместо отказа после попыток `CLAUDE_CODE_MAX_RETRIES`. Claude Code не выполняется сразу, когда запрос стандартной скорости получает `429`, который сообщает об ограничении расходов или исчерпанных кредитах использования, даже один из [ограничения расходов шлюза](/docs/ru/errors#spend-limit-reached), который сбрасывается по расписанию. До версии 2.1.239 сторож повторял эти бесконечно. Для запросов быстрого режима см. [Обработка ограничений скорости](/docs/ru/fast-mode#handle-rate-limits). Сторож отступает до 5 минут между попытками или до сброса ограничения, когда ответ несёт время сброса ограничения скорости, поэтому сеанс, который попадает на ограничение использования, ждёт оставшегося окна. На версии 2.1.199 или позже он также повышает количество повторов по умолчанию для других переходных ошибок, таких как ошибки сервера, таймауты и отброшенные подключения, до 300, примерно три часа отступления, и удаляет ограничение 15 на `CLAUDE_CODE_MAX_RETRIES`, если вы явно установите эту переменную. Требует Claude Code версии 2.1.186 или позже |

364| `CLAUDE_CODE_SAFE_MODE` | Установите на `1`, чтобы запустить в безопасном режиме: CLAUDE.md, skills, плагины, hooks, MCP серверы, пользовательские команды и агенты, стили вывода, workflows, пользовательские темы, пользовательские сочетания клавиш, команды строки состояния и предложения файлов, LSP серверы и автоматическая память не загружаются для устранения неполадок сломанной конфигурации. Политика управляемых параметров по-прежнему применяется, включая настроенные политикой hooks, строку состояния и команды предложения файлов; управляемые плагины, управляемые skills, управляемые CLAUDE.md и настроенные политикой MCP серверы не загружаются. Эквивалентно передаче [`--safe-mode`](/docs/ru/cli-reference#cli-flags). Непосредственно порождённые дочерние процессы наследуют переменную |368| `CLAUDE_CODE_SAFE_MODE` | Установите на `1`, чтобы запустить в безопасном режиме: CLAUDE.md, skills, плагины, hooks, MCP серверы, пользовательские команды и агенты, стили вывода, workflows, пользовательские темы, пользовательские сочетания клавиш, команды строки состояния и предложения файлов, LSP серверы и автоматическая память не загружаются для устранения неполадок сломанной конфигурации. Политика управляемых параметров по-прежнему применяется, включая настроенные политикой hooks, строку состояния и команды предложения файлов; управляемые плагины, управляемые skills, управляемые CLAUDE.md и настроенные политикой MCP серверы не загружаются. Эквивалентно передаче [`--safe-mode`](/docs/ru/cli-reference#cli-flags). Непосредственно порождённые дочерние процессы наследуют переменную |

365| `CLAUDE_CODE_SCRIPT_CAPS` | JSON объект, ограничивающий, сколько раз конкретные скрипты могут быть вызваны за сеанс, когда установлен `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`. Ключи — это подстроки, совпадающие с текстом команды; значения — это ограничения количества вызовов. Например, `{"deploy.sh": 2}` позволяет `deploy.sh` быть вызванным максимум дважды. Совпадение основано на подстроке, поэтому трюки расширения оболочки, такие как `./scripts/deploy.sh $(evil)`, по-прежнему считаются против ограничения. Веерное расширение во время выполнения через `xargs` или `find -exec` не обнаруживается; это контроль защиты в глубину |369| `CLAUDE_CODE_SCRIPT_CAPS` | JSON объект, ограничивающий, сколько раз конкретные скрипты могут быть вызваны за сеанс, когда установлен `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`. Ключи — это подстроки, совпадающие с текстом команды; значения — это ограничения количества вызовов. Например, `{"deploy.sh": 2}` позволяет `deploy.sh` быть вызванным максимум дважды. Совпадение основано на подстроке, поэтому трюки расширения оболочки, такие как `./scripts/deploy.sh $(evil)`, по-прежнему считаются против ограничения. Веерное расширение во время выполнения через `xargs` или `find -exec` не обнаруживается; это контроль защиты в глубину |

378| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | Установите на `1`, чтобы пропустить проверку доступности [быстрого режима](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) на стороне клиента для прокси, которые перехватывают запрос проверки, а не отказывают в нём. API по-прежнему отклоняет запросы быстрого режима, когда ваша организация отключила быстрый режим |382| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | Установите на `1`, чтобы пропустить проверку доступности [быстрого режима](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) на стороне клиента для прокси, которые перехватывают запрос проверки, а не отказывают в нём. API по-прежнему отклоняет запросы быстрого режима, когда ваша организация отключила быстрый режим |

379| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Пропустить аутентификацию Azure для Microsoft Foundry, для прокси или шлюза, который вводит свой собственный заголовок `Authorization`. Claude Code отправляет запросы без учётных данных Azure и сохраняет заголовок `Authorization`, который вы предоставляете, например, через `ANTHROPIC_CUSTOM_HEADERS`. Игнорируется, когда установлены `ANTHROPIC_FOUNDRY_API_KEY` или `ANTHROPIC_FOUNDRY_AUTH_TOKEN`. До версии 2.1.203 эта переменная оставляла клиент Microsoft Foundry неспособным отправлять запросы, если ключ API также не был установлен |383| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Пропустить аутентификацию Azure для Microsoft Foundry, для прокси или шлюза, который вводит свой собственный заголовок `Authorization`. Claude Code отправляет запросы без учётных данных Azure и сохраняет заголовок `Authorization`, который вы предоставляете, например, через `ANTHROPIC_CUSTOM_HEADERS`. Игнорируется, когда установлены `ANTHROPIC_FOUNDRY_API_KEY` или `ANTHROPIC_FOUNDRY_AUTH_TOKEN`. До версии 2.1.203 эта переменная оставляла клиент Microsoft Foundry неспособным отправлять запросы, если ключ API также не был установлен |

380| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Пропустить аутентификацию AWS для Amazon Bedrock Mantle (например, при использовании LLM gateway) |384| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Пропустить аутентификацию AWS для Amazon Bedrock Mantle (например, при использовании LLM gateway) |

385| `CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY` | [Проверки модели при запуске](/docs/ru/amazon-bedrock#startup-model-checks) на [Amazon Bedrock](/docs/ru/amazon-bedrock) и [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) помнят на этой машине, какие модели они обнаружили, что ваша учётная запись не может вызвать, в течение дня. Установите на `1`, чтобы отключить эту память. Требует Claude Code версии 2.1.285 или позже |

381| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Установите на `1`, чтобы пропустить запись истории подсказок и стенограмм сеансов на диск. Сеансы, запущенные с этой переменной, не появляются в `--resume`, `--continue` или истории со стрелкой вверх. Полезно для эфемерных скриптовых сеансов |386| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Установите на `1`, чтобы пропустить запись истории подсказок и стенограмм сеансов на диск. Сеансы, запущенные с этой переменной, не появляются в `--resume`, `--continue` или истории со стрелкой вверх. Полезно для эфемерных скриптовых сеансов |

382| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Пропустить аутентификацию Google для Google Cloud's Agent Platform (например, при использовании LLM gateway) |387| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Пропустить аутентификацию Google для Google Cloud's Agent Platform (например, при использовании LLM gateway) |

383| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | Установите на `1`, чтобы сеанс, запущенный с `--output-format stream-json`, написал [сообщение результата, называющее, почему Claude Code отказался запустить](/docs/ru/agent-sdk/typescript#startup_failure_reason) для отказов при запуске, которые в противном случае заканчиваются только stderr. Требует Claude Code версии 2.1.274 или позже |388| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | Установите на `1`, чтобы сеанс, запущенный с `--output-format stream-json`, написал [сообщение результата, называющее, почему Claude Code отказался запустить](/docs/ru/agent-sdk/typescript#startup_failure_reason) для отказов при запуске, которые в противном случае заканчиваются только stderr. Требует Claude Code версии 2.1.274 или позже |

412| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | Верхняя граница в миллисекундах, как долго агент [workflow](/docs/ru/workflows) ждёт первого ответа товарища с одинаковым префиксом перед отправкой своего собственного первого запроса. Когда веерное расширение запускает несколько агентов, которые делят [префикс кэша подсказок](/docs/ru/workflows#prompt-caching-in-a-fan-out), Claude Code удерживает всех, кроме первого агента, до этого времени, чтобы остальные читали кэшированный префикс вместо каждого обработки его без кэша. По умолчанию `5000`. Установите на `0`, чтобы отключить ожидание. Когда установлен `DISABLE_PROMPT_CACHING`, агенты никогда не ждут. Требует Claude Code версии 2.1.229 или позже |417| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | Верхняя граница в миллисекундах, как долго агент [workflow](/docs/ru/workflows) ждёт первого ответа товарища с одинаковым префиксом перед отправкой своего собственного первого запроса. Когда веерное расширение запускает несколько агентов, которые делят [префикс кэша подсказок](/docs/ru/workflows#prompt-caching-in-a-fan-out), Claude Code удерживает всех, кроме первого агента, до этого времени, чтобы остальные читали кэшированный префикс вместо каждого обработки его без кэша. По умолчанию `5000`. Установите на `0`, чтобы отключить ожидание. Когда установлен `DISABLE_PROMPT_CACHING`, агенты никогда не ждут. Требует Claude Code версии 2.1.229 или позже |

413| `CLAUDE_CONFIG_DIR` | Переопределить каталог конфигурации (по умолчанию: `~/.claude`). Все параметры, история сеансов и плагины хранятся под этим путём. Для учётных данных см. [где Claude Code хранит учётные данные](/docs/ru/authentication#credential-management). Полезно для запуска нескольких учётных записей рядом: например, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`. Установите это в вашей оболочке, пользовательских параметрах или управляемых параметрах. Игнорируется в [параметрах проекта и локальных параметрах](/docs/ru/settings-reference#variables-claude-code-ignores-in-env) |418| `CLAUDE_CONFIG_DIR` | Переопределить каталог конфигурации (по умолчанию: `~/.claude`). Все параметры, история сеансов и плагины хранятся под этим путём. Для учётных данных см. [где Claude Code хранит учётные данные](/docs/ru/authentication#credential-management). Полезно для запуска нескольких учётных записей рядом: например, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`. Установите это в вашей оболочке, пользовательских параметрах или управляемых параметрах. Игнорируется в [параметрах проекта и локальных параметрах](/docs/ru/settings-reference#variables-claude-code-ignores-in-env) |

414| `CLAUDE_DISABLE_ADOPT` | Установите на `1`, чтобы остановить текущую фоновую работу вместо её переноса, когда вы фоновый сеанс, нажав `←` или с [`/background`](/docs/ru/agent-view#from-inside-a-session). Claude Code просит вас подтвердить перед фоновым выполнением, затем останавливает задачи, которые в противном случае переносились бы. Требует Claude Code версии 2.1.195 или позже |419| `CLAUDE_DISABLE_ADOPT` | Установите на `1`, чтобы остановить текущую фоновую работу вместо её переноса, когда вы фоновый сеанс, нажав `←` или с [`/background`](/docs/ru/agent-view#from-inside-a-session). Claude Code просит вас подтвердить перед фоновым выполнением, затем останавливает задачи, которые в противном случае переносились бы. Требует Claude Code версии 2.1.195 или позже |

415| `CLAUDE_EFFORT` | Установлено автоматически в подпроцессах инструмента Bash и командах hook на [уровень усилий](/docs/ru/model-config#adjust-effort-level), действующий при запуске подпроцесса: `low`, `medium`, `high`, `xhigh` или `max`. Ultracode не является отдельным уровнем и сообщается как `xhigh`. Совпадает с полем `effort.level`, переданным [hooks](/docs/ru/hooks). Установлено только, когда текущая модель поддерживает параметр усилий |420| `CLAUDE_EFFORT` | Установлено автоматически в подпроцессах инструмента Bash и командах hook на [уровень усилий](/docs/ru/model-config#adjust-effort-level), действующий при запуске подпроцесса: `low`, `medium`, `high`, `xhigh` или `max`. Совпадает с полем `effort.level`, переданным [hooks](/docs/ru/hooks). Установлено только, когда текущая модель поддерживает параметр усилий |

416| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Установите на `1`, чтобы принудительно включить сторожа простоя потока на уровне байтов, или установите на `0`, чтобы принудительно отключить его. `0` также отключает [крайний срок первого байта](/docs/ru/network-config#streaming-idle-watchdogs) на подключениях, где этот крайний срок работает. Если не установлено, сторож включен по умолчанию для прямых подключений API Anthropic и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), и для потоковых ответов на подключениях [шлюза](/docs/ru/gateways), достигнутых через `ANTHROPIC_BASE_URL` или `ANTHROPIC_AWS_BASE_URL`; до версии 2.1.222 он не работал на этих подключениях шлюза, поэтому сторож на уровне событий мог сообщить о стагнации там, даже если ping для поддержания соединения прибывали. Для таймаутов и того, как таймеры взаимодействуют, см. [Сторожи простоя потока](/docs/ru/network-config#streaming-idle-watchdogs) |421| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Установите на `1`, чтобы принудительно включить сторожа простоя потока на уровне байтов, или установите на `0`, чтобы принудительно отключить его. `0` также отключает [крайний срок первого байта](/docs/ru/network-config#streaming-idle-watchdogs) на подключениях, где этот крайний срок работает. Если не установлено, сторож включен по умолчанию для прямых подключений API Anthropic и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), и для потоковых ответов на подключениях [шлюза](/docs/ru/gateways), достигнутых через `ANTHROPIC_BASE_URL` или `ANTHROPIC_AWS_BASE_URL`; до версии 2.1.222 он не работал на этих подключениях шлюза, поэтому сторож на уровне событий мог сообщить о стагнации там, даже если ping для поддержания соединения прибывали. Для таймаутов и того, как таймеры взаимодействуют, см. [Сторожи простоя потока](/docs/ru/network-config#streaming-idle-watchdogs) |

417| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Установите на `1`, чтобы включить сторожа простоя потока на уровне байтов на ответах Amazon Bedrock `vnd.amazon.eventstream`, что также включает [крайний срок первого байта](/docs/ru/network-config#streaming-idle-watchdogs) на потоковых запросах Bedrock. Отключено по умолчанию. Настройте таймаут с помощью `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |422| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Установите на `1`, чтобы включить сторожа простоя потока на уровне байтов на ответах Amazon Bedrock `vnd.amazon.eventstream`, что также включает [крайний срок первого байта](/docs/ru/network-config#streaming-idle-watchdogs) на потоковых запросах Bedrock. Отключено по умолчанию. Настройте таймаут с помощью `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |

418| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Установите на `0`, чтобы принудительно отключить сторожа простоя потока на уровне событий, или установите на `1`, чтобы принудительно включить его. Если не установлено, сторож включен по умолчанию для всех поставщиков. До версии 2.1.196 значение по умолчанию без установки было управляемо сервером на прямом API Anthropic и отключено на других поставщиках. Настройте таймаут с помощью `CLAUDE_STREAM_IDLE_TIMEOUT_MS`; для других таймеров стагнации, которые работают рядом с этим, см. [Сторожи простоя потока](/docs/ru/network-config#streaming-idle-watchdogs) |423| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Установите на `0`, чтобы принудительно отключить сторожа простоя потока на уровне событий, или установите на `1`, чтобы принудительно включить его. Если не установлено, сторож включен по умолчанию для всех поставщиков. До версии 2.1.196 значение по умолчанию без установки было управляемо сервером на прямом API Anthropic и отключено на других поставщиках. Настройте таймаут с помощью `CLAUDE_STREAM_IDLE_TIMEOUT_MS`; для других таймеров стагнации, которые работают рядом с этим, см. [Сторожи простоя потока](/docs/ru/network-config#streaming-idle-watchdogs) |

441| `DISABLE_PROMPT_CACHING` | Установите на `1`, чтобы отключить [кэширование подсказок](/docs/ru/prompt-caching#disable-prompt-caching) для всех моделей (имеет приоритет над параметрами для каждой модели) |446| `DISABLE_PROMPT_CACHING` | Установите на `1`, чтобы отключить [кэширование подсказок](/docs/ru/prompt-caching#disable-prompt-caching) для всех моделей (имеет приоритет над параметрами для каждой модели) |

443| `DISABLE_PROMPT_CACHING_HAIKU` | Установите на `1`, чтобы отключить кэширование подсказок для моделей Haiku |448| `DISABLE_PROMPT_CACHING_HAIKU` | Установите на `1`, чтобы отключить кэширование подсказок для [модели Haiku по умолчанию](/docs/ru/prompt-caching#disable-prompt-caching), где бы она ни работала |

444| `DISABLE_PROMPT_CACHING_OPUS` | Установите на `1`, чтобы отключить кэширование подсказок для моделей Opus |449| `DISABLE_PROMPT_CACHING_OPUS` | Установите на `1`, чтобы отключить кэширование подсказок для [модели Opus по умолчанию](/docs/ru/prompt-caching#disable-prompt-caching) |

445| `DISABLE_PROMPT_CACHING_SONNET` | Установите на `1`, чтобы отключить кэширование подсказок для моделей Sonnet |450| `DISABLE_PROMPT_CACHING_SONNET` | Установите на `1`, чтобы отключить кэширование подсказок для [модели Sonnet по умолчанию](/docs/ru/prompt-caching#disable-prompt-caching) |

446| `DISABLE_TELEMETRY` | Установите на любое непустое значение, такое как `1`, чтобы отказаться от телеметрии. **Установка на `0` или `false` по-прежнему отказывает**, в отличие от большинства переменных включения/отключения; отмените установку переменной, чтобы включить телеметрию обратно. События телеметрии не включают пользовательские данные, такие как код, пути файлов или команды bash. Также отключает получение флагов функций с тем же эффектом, что и `DISABLE_GROWTHBOOK`, что делает [Remote Control](/docs/ru/remote-control#requirements) и другие [функции, которые нуждаются в получении флагов функций](#features-that-need-feature-flag-fetching) недоступными. См. [Отключить телеметрию для вашей организации](/docs/ru/managed-settings#turn-telemetry-off-for-your-organization) |451| `DISABLE_TELEMETRY` | Установите на любое непустое значение, такое как `1`, чтобы отказаться от телеметрии. **Установка на `0` или `false` по-прежнему отказывает**, в отличие от большинства переменных включения/отключения; отмените установку переменной, чтобы включить телеметрию обратно. События телеметрии не включают пользовательские данные, такие как код, пути файлов или команды bash. Также отключает получение флагов функций с тем же эффектом, что и `DISABLE_GROWTHBOOK`, что делает [Remote Control](/docs/ru/remote-control#requirements) и другие [функции, которые нуждаются в получении флагов функций](#features-that-need-feature-flag-fetching) недоступными. См. [Отключить телеметрию для вашей организации](/docs/ru/managed-settings#turn-telemetry-off-for-your-organization) |

447| `DISABLE_UPDATES` | Установите на `1`, чтобы заблокировать все обновления, включая ручной `claude update` и `claude install`. Строже, чем `DISABLE_AUTOUPDATER`. Используйте при распределении Claude Code через ваши собственные каналы и пользователи не должны самостоятельно обновляться |452| `DISABLE_UPDATES` | Установите на `1`, чтобы заблокировать все обновления, включая ручной `claude update` и `claude install`. Строже, чем `DISABLE_AUTOUPDATER`. Используйте при распределении Claude Code через ваши собственные каналы и пользователи не должны самостоятельно обновляться |

461| `IS_DEMO` | Установите на любое непустое значение, такое как `1`, чтобы включить режим демонстрации: скрывает ваш адрес электронной почты и имя организации из заголовка и вывода `/status`, и пропускает адаптацию. **Установка на `0` или `false` по-прежнему включает режим демонстрации**, в отличие от большинства переменных включения/отключения; отмените установку переменной, чтобы отключить его. Полезно при потоковой передаче или записи сеанса |466| `IS_DEMO` | Установите на любое непустое значение, такое как `1`, чтобы включить режим демонстрации: скрывает ваш адрес электронной почты и имя организации из заголовка и вывода `/status`, и пропускает адаптацию. **Установка на `0` или `false` по-прежнему включает режим демонстрации**, в отличие от большинства переменных включения/отключения; отмените установку переменной, чтобы отключить его. Полезно при потоковой передаче или записи сеанса |

462| `MAX_MCP_OUTPUT_TOKENS` | Максимальное количество токенов, разрешённых в ответах инструментов MCP. Claude Code отображает предупреждение, когда вывод превышает 10,000 токенов. Инструменты, которые объявляют [`anthropic/maxResultSizeChars`](/docs/ru/mcp#raise-the-limit-for-a-specific-tool), используют это ограничение символов для текстового содержимого вместо этого, но содержимое изображения из этих инструментов по-прежнему подчиняется этой переменной (по умолчанию: 25000) |467| `MAX_MCP_OUTPUT_TOKENS` | Максимальное количество токенов, разрешённых в ответах инструментов MCP. Claude Code отображает предупреждение, когда вывод превышает 10,000 токенов. Инструменты, которые объявляют [`anthropic/maxResultSizeChars`](/docs/ru/mcp#raise-the-limit-for-a-specific-tool), используют это ограничение символов для текстового содержимого вместо этого, но содержимое изображения из этих инструментов по-прежнему подчиняется этой переменной (по умолчанию: 25000) |

463| `MAX_STRUCTURED_OUTPUT_RETRIES` | Количество попыток Claude Code позволяет, когда ответ модели не выполняет проверку против [`--json-schema`](/docs/ru/cli-reference#cli-flags) в неинтерактивном режиме с флагом `-p`; после такого количества неудачных попыток без действительного вывода запуск не выполняется. То же ограничение применяется, когда структурированный вывод подагента [workflow](/docs/ru/workflows) не выполняет проверку. По умолчанию 5, первая попытка плюс четыре повтора |468| `MAX_STRUCTURED_OUTPUT_RETRIES` | Количество попыток Claude Code позволяет, когда ответ модели не выполняет проверку против [`--json-schema`](/docs/ru/cli-reference#cli-flags) в неинтерактивном режиме с флагом `-p`; после такого количества неудачных попыток без действительного вывода запуск не выполняется. То же ограничение применяется, когда структурированный вывод подагента [workflow](/docs/ru/workflows) не выполняет проверку. По умолчанию 5, первая попытка плюс четыре повтора |

464| `MAX_THINKING_TOKENS` | Фиксированный бюджет токенов для [расширенного мышления](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). Claude Code ограничивает его на один токен ниже максимального выходного токена запроса и никогда ниже 1,024. См. `CLAUDE_CODE_MAX_OUTPUT_TOKENS` для того, как устанавливается это ограничение. Если не установлено и мышление включено, модели с [адаптивным рассуждением](/docs/ru/model-config#adjust-effort-level) выбирают свою собственную глубину мышления, и другие модели используют ограничение. Установите на `0`, чтобы отключить мышление на API Anthropic, за исключением Opus 5.5 и моделей Fable, которые не могут иметь отключённое мышление. На [сторонних поставщиках](/docs/ru/third-party-integrations) `0` опускает параметр `thinking` вместо этого. С отключённым мышлением на API Anthropic Claude Code отправляет усилие `high` вместо более высокого уровня на моделях, которые он знает [не принимают эту комбинацию](/docs/ru/errors#effort-isnt-available-with-thinking-turned-off), такие как Opus 5. Claude Code игнорирует ненулевые значения на моделях адаптивного рассуждения, за исключением моделей, где `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` отключает адаптивное рассуждение |469| `MAX_THINKING_TOKENS` | Фиксированный бюджет токенов для [расширенного мышления](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). Claude Code ограничивает его на один токен ниже максимального выходного токена запроса и никогда ниже 1,024. См. `CLAUDE_CODE_MAX_OUTPUT_TOKENS` для того, как устанавливается это ограничение. Если не установлено и мышление включено, модели с [адаптивным рассуждением](/docs/ru/model-config#adjust-effort-level) выбирают свою собственную глубину мышления, и другие модели используют ограничение. Установите на `0`, чтобы отключить мышление на API Anthropic, за исключением Opus 5.5, Sonnet 5.5 и моделей Fable, которые не могут иметь отключённое мышление. На [сторонних поставщиках](/docs/ru/third-party-integrations) `0` опускает параметр `thinking` вместо этого. С отключённым мышлением на API Anthropic Claude Code отправляет усилие `high` вместо более высокого уровня на моделях, которые он знает [не принимают эту комбинацию](/docs/ru/errors#effort-isnt-available-with-thinking-turned-off), такие как Opus 5. Claude Code игнорирует ненулевые значения на моделях адаптивного рассуждения, за исключением моделей, где `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` отключает адаптивное рассуждение |

465| `MCP_CLIENT_SECRET` | Секрет клиента OAuth для MCP серверов, которые требуют [предварительно настроенные учётные данные](/docs/ru/mcp#use-pre-configured-oauth-credentials). Избегает интерактивного запроса при добавлении сервера с `--client-secret` |470| `MCP_CLIENT_SECRET` | Секрет клиента OAuth для MCP серверов, которые требуют [предварительно настроенные учётные данные](/docs/ru/mcp#use-pre-configured-oauth-credentials). Избегает интерактивного запроса при добавлении сервера с `--client-secret` |

466| `MCP_CONNECTION_NONBLOCKING` | Контролирует, ждёт ли запуск MCP серверов подключения перед первым запросом. Запуск MCP неблокирующий по умолчанию: серверы подключаются в фоне и их инструменты становятся доступными по мере завершения. Установите на `0`, чтобы Claude Code ждал подключения серверов перед первым запросом. Серверы, настроенные с [`alwaysLoad: true`](/docs/ru/mcp#exempt-a-server-from-deferral), по-прежнему заставляют запуск ждать независимо, за исключением случаев, когда обслуживаются из [кэша обнаружения](/docs/ru/mcp#server-status-detail), так как их инструменты должны присутствовать при построении первой подсказки. В неинтерактивном режиме (`-p`) без `--input-format stream-json` Claude Code также ждёт всё ещё ожидающих серверов перед первым ходом независимо от этой переменной. Когда вы передаёте [`--mcp-config`](/docs/ru/cli-reference#cli-flags) явно, ожидание имеет более длительный крайний срок; см. запись этого флага для исключения кэшированного сервера |471| `MCP_CONNECTION_NONBLOCKING` | Контролирует, ждёт ли запуск MCP серверов подключения перед первым запросом. MCP запуск неблокирующий по умолчанию: серверы подключаются в фоне и их инструменты становятся доступными по мере завершения. Установите на `0`, чтобы Claude Code ждал подключения серверов перед первым запросом. Серверы, настроенные с [`alwaysLoad: true`](/docs/ru/mcp#exempt-a-server-from-deferral), по-прежнему заставляют запуск ждать независимо, за исключением случаев, когда обслуживаются из [кэша обнаружения](/docs/ru/mcp#server-status-detail), так как их инструменты должны присутствовать при построении первой подсказки. В неинтерактивном режиме (`-p`) без `--input-format stream-json` Claude Code также ждёт всё ещё ожидающих серверов перед первым ходом независимо от этой переменной. Когда вы передаёте [`--mcp-config`](/docs/ru/cli-reference#cli-flags) явно, ожидание имеет более длительный крайний срок; см. запись этого флага для исключения кэшированного сервера |

467| `MCP_CONNECT_TIMEOUT_MS` | Как долго блокирующий запуск MCP ждёт, в миллисекундах, пакета подключения перед снимком списка инструментов (по умолчанию: 5000). Применяется, когда `MCP_CONNECTION_NONBLOCKING=0` или для серверов, отмеченных [`alwaysLoad: true`](/docs/ru/mcp#exempt-a-server-from-deferral). Серверы, всё ещё ожидающие на крайнем сроке, продолжают подключаться в фоне. Отличается от `MCP_TIMEOUT`, который ограничивает попытку подключения отдельного сервера |472| `MCP_CONNECT_TIMEOUT_MS` | Как долго блокирующий запуск MCP ждёт, в миллисекундах, пакета подключения перед снимком списка инструментов (по умолчанию: 5000). Применяется, когда `MCP_CONNECTION_NONBLOCKING=0` или для серверов, отмеченных [`alwaysLoad: true`](/docs/ru/mcp#exempt-a-server-from-deferral). Серверы, всё ещё ожидающие на крайнем сроке, продолжают подключаться в фоне. Отличается от `MCP_TIMEOUT`, который ограничивает попытку подключения отдельного сервера |

468| `MCP_DISCOVERY_CACHE` | Включает или отключает [кэш обнаружения MCP](/docs/ru/mcp#server-status-detail). С включённым кэшем удалённый HTTP или SSE сервер, который вы использовали раньше, может показать [статус `cached`](/docs/ru/mcp#server-status-detail), и Claude Code подключает его при первом вызове инструмента вместо запуска. Кэш отключен по умолчанию, если постепенное развёртывание не включило его для вашей учётной записи. Установите на `1`, чтобы включить его, или `0`, чтобы сохранить его отключённым, даже если развёртывание включило его. До версии 2.1.238 кэш был включен по умолчанию. Статус `cached` требует Claude Code версии 2.1.221 или позже |473| `MCP_DISCOVERY_CACHE` | Включает или отключает [кэш обнаружения MCP](/docs/ru/mcp#server-status-detail). С включённым кэшем удалённый HTTP или SSE сервер, который вы использовали раньше, может показать [статус `cached`](/docs/ru/mcp#server-status-detail), и Claude Code подключает его при первом вызове инструмента вместо запуска. Кэш отключен по умолчанию, если постепенное развёртывание не включило его для вашей учётной записи. Установите на `1`, чтобы включить его, или `0`, чтобы сохранить его отключённым, даже если развёртывание включило его. До версии 2.1.238 кэш был включен по умолчанию. Статус `cached` требует Claude Code версии 2.1.221 или позже |

469| `MCP_DISCOVERY_CACHE_MAX_STALE_S` | Максимальный возраст в секундах записи [кэша обнаружения](/docs/ru/mcp#server-status-detail) (по умолчанию: 14400 или 4 часа). При запуске, где запись старше этого, Claude Code отбрасывает её и подключает сервер при запуске, как при отключённом кэше. Claude Code ограничивает значение на 7 дней. До версии 2.1.238 значение по умолчанию было 86400 или 24 часа, и Claude Code не ограничивал значение |474| `MCP_DISCOVERY_CACHE_MAX_STALE_S` | Максимальный возраст в секундах записи [кэша обнаружения](/docs/ru/mcp#server-status-detail) (по умолчанию: 14400 или 4 часа). При запуске, где запись старше этого, Claude Code отбрасывает её и подключает сервер при запуске, как при отключённом кэше. Claude Code ограничивает значение на 7 дней. До версии 2.1.238 значение по умолчанию было 86400 или 24 часа, и Claude Code не ограничивал значение |

481| `OTEL_LOG_ASSISTANT_RESPONSES` | Установите на `1`, чтобы включить текст ответа модели на событиях журнала OpenTelemetry `assistant_response`. Если не установлено, используется значение `OTEL_LOG_USER_PROMPTS`. Установите на `0`, чтобы сохранить ответы отредактированными, даже если установлен `OTEL_LOG_USER_PROMPTS`. Требует Claude Code версии 2.1.193 или позже. См. [Мониторинг](/docs/ru/monitoring-usage#assistant-response-event) |486| `OTEL_LOG_ASSISTANT_RESPONSES` | Установите на `1`, чтобы включить текст ответа модели на событиях журнала OpenTelemetry `assistant_response`. Если не установлено, используется значение `OTEL_LOG_USER_PROMPTS`. Установите на `0`, чтобы сохранить ответы отредактированными, даже если установлен `OTEL_LOG_USER_PROMPTS`. Требует Claude Code версии 2.1.193 или позже. См. [Мониторинг](/docs/ru/monitoring-usage#assistant-response-event) |

482| `OTEL_LOG_MANAGED_SETTINGS` | Установите на `1`, чтобы добавить отредактированные управляемые параметры и дайджест SHA-256 параметров перед редактированием к событиям журнала OpenTelemetry `managed_settings_resolved`. Отключено по умолчанию. Установите это в вашей оболочке, пользовательских параметрах или управляемых параметрах; значение в параметрах проекта или локальных параметрах не включает это. Требует Claude Code версии 2.1.274 или позже. См. [Мониторинг](/docs/ru/monitoring-usage#managed-settings-resolved-event) |487| `OTEL_LOG_MANAGED_SETTINGS` | Установите на `1`, чтобы добавить отредактированные управляемые параметры и дайджест SHA-256 параметров перед редактированием к событиям журнала OpenTelemetry `managed_settings_resolved`. Отключено по умолчанию. Установите это в вашей оболочке, пользовательских параметрах или управляемых параметрах; значение в параметрах проекта или локальных параметрах не включает это. Требует Claude Code версии 2.1.274 или позже. См. [Мониторинг](/docs/ru/monitoring-usage#managed-settings-resolved-event) |

483| `OTEL_LOG_RAW_API_BODIES` | Выдавать JSON запроса и ответа API Anthropic Messages как события журнала `api_request_body` / `api_response_body`. Установите на `1` для встроенных тел, усечённых на пределе содержимого, или `file:<dir>`, чтобы написать неусечённые тела на диск и выдать путь `body_ref` вместо этого. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` настраивает предел содержимого, 60 КБ по умолчанию. Отключено по умолчанию; тела включают всю историю разговора. Установите это в вашей оболочке, пользовательских параметрах или управляемых параметрах. Игнорируется в [параметрах проекта и локальных параметрах](/docs/ru/settings-reference#variables-claude-code-ignores-in-env). См. [Мониторинг](/docs/ru/monitoring-usage#api-request-body-event) |488| `OTEL_LOG_RAW_API_BODIES` | Выдавать JSON запроса и ответа API Anthropic Messages как события журнала `api_request_body` / `api_response_body`. Установите на `1` для встроенных тел, усечённых на пределе содержимого, или `file:<dir>`, чтобы написать неусечённые тела на диск и выдать путь `body_ref` вместо этого. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` настраивает предел содержимого, 60 КБ по умолчанию. Отключено по умолчанию; тела включают всю историю разговора. Установите это в вашей оболочке, пользовательских параметрах или управляемых параметрах. Игнорируется в [параметрах проекта и локальных параметрах](/docs/ru/settings-reference#variables-claude-code-ignores-in-env). См. [Мониторинг](/docs/ru/monitoring-usage#api-request-body-event) |

484| `OTEL_LOG_TOOL_CONTENT` | Установите на `1`, чтобы включить содержимое инструмента в событие пролёта OpenTelemetry `tool.output`. Атрибуты пролётов несут содержимое инструмента под [их собственными воротами](/docs/ru/monitoring-usage#new-context-gates). Требует [трассировку](/docs/ru/monitoring-usage#traces-beta). Отключено по умолчанию для защиты чувствительных данных. См. [Мониторинг](/docs/ru/monitoring-usage#tool-output-span-event) |489| `OTEL_LOG_TOOL_CONTENT` | Установите на `1`, чтобы включить содержимое инструмента в событие пролёта OpenTelemetry `tool.output`. Атрибуты пролётов несут содержимое инструмента под [их собственными воротами](/docs/ru/monitoring-usage#new-context-gates). Требует [трассировку](/docs/ru/monitoring-usage#traces-beta). Отключено по умолчанию для защиты чувствительных данных. Установите это в вашей оболочке, пользовательских параметрах или управляемых параметрах. Игнорируется в [параметрах проекта и локальных параметрах](/docs/ru/settings-reference#variables-claude-code-ignores-in-env), кроме значений отключения, которые описывает этот раздел. См. [Мониторинг](/docs/ru/monitoring-usage#tool-output-span-event) |

485| `OTEL_LOG_TOOL_DETAILS` | Установите на `1`, чтобы включить аргументы входа инструмента, имена MCP серверов, имена workflows, созданные пользователем, необработанные строки ошибок при отказах инструментов, категорию отказа `category` на событиях `api_refusal` и другие детали инструментов в трассировках и журналах OpenTelemetry. Отключено по умолчанию для защиты PII. См. [Мониторинг](/docs/ru/monitoring-usage) |490| `OTEL_LOG_TOOL_DETAILS` | Установите на `1`, чтобы включить аргументы входа инструмента, имена MCP серверов, имена workflows, созданные пользователем, необработанные строки ошибок при отказах инструментов, категорию отказа `category` на событиях `api_refusal`, реальные имена агентов, skills, плагинов и MCP серверов на [метриках затрат и токенов](/docs/ru/monitoring-usage#cost-counter) и другие детали инструментов в трассировках и журналах OpenTelemetry. Отключено по умолчанию для защиты PII. Установите это в вашей оболочке, пользовательских параметрах или управляемых параметрах. Игнорируется в [параметрах проекта и локальных параметрах](/docs/ru/settings-reference#variables-claude-code-ignores-in-env), кроме значений отключения, которые описывает этот раздел. См. [Мониторинг](/docs/ru/monitoring-usage) |

486| `OTEL_LOG_USER_PROMPTS` | Установите на `1`, чтобы включить текст подсказки пользователя в трассировки и журналы OpenTelemetry. Отключено по умолчанию (подсказки отредактированы). См. [Мониторинг](/docs/ru/monitoring-usage) |491| `OTEL_LOG_USER_PROMPTS` | Установите на `1`, чтобы включить текст подсказки пользователя в трассировки и журналы OpenTelemetry. Отключено по умолчанию (подсказки отредактированы). Установите это в вашей оболочке, пользовательских параметрах или управляемых параметрах. Игнорируется в [параметрах проекта и локальных параметрах](/docs/ru/settings-reference#variables-claude-code-ignores-in-env), кроме значений отключения, которые описывает этот раздел. См. [Мониторинг](/docs/ru/monitoring-usage) |

487| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Установите на `false`, чтобы исключить UUID учётной записи из атрибутов метрик (по умолчанию: включено). См. [Мониторинг](/docs/ru/monitoring-usage) |492| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Установите на `false`, чтобы исключить UUID учётной записи из атрибутов метрик (по умолчанию: включено). См. [Мониторинг](/docs/ru/monitoring-usage) |

488| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | Установите на `true`, чтобы включить точку входа сеанса в атрибуты метрик (по умолчанию: исключено). Добавлено в версии 2.1.152. См. [Мониторинг](/docs/ru/monitoring-usage) |493| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | Установите на `true`, чтобы включить точку входа сеанса в атрибуты метрик (по умолчанию: исключено). Добавлено в версии 2.1.152. См. [Мониторинг](/docs/ru/monitoring-usage) |

489| `OTEL_METRICS_INCLUDE_REPOSITORY` | Установите на `true`, чтобы пометить метрики и события OpenTelemetry атрибутами `vcs.*`, определяющими репозиторий сеанса (по умолчанию: исключено). Требует Claude Code версии 2.1.269 или позже. См. [Атрибуты репозитория](/docs/ru/monitoring-usage#repository-attributes) |494| `OTEL_METRICS_INCLUDE_REPOSITORY` | Установите на `true`, чтобы пометить метрики и события OpenTelemetry атрибутами `vcs.*`, определяющими репозиторий сеанса (по умолчанию: исключено). Требует Claude Code версии 2.1.269 или позже. См. [Атрибуты репозитория](/docs/ru/monitoring-usage#repository-attributes) |

506| `VERTEX_REGION_CLAUDE_4_7_OPUS` | Переопределить регион для Claude Opus 4.7 при использовании Google Cloud's Agent Platform |511| `VERTEX_REGION_CLAUDE_4_7_OPUS` | Переопределить регион для Claude Opus 4.7 при использовании Google Cloud's Agent Platform |

507| `VERTEX_REGION_CLAUDE_4_8_OPUS` | Переопределить регион для Claude Opus 4.8 при использовании Google Cloud's Agent Platform |512| `VERTEX_REGION_CLAUDE_4_8_OPUS` | Переопределить регион для Claude Opus 4.8 при использовании Google Cloud's Agent Platform |

508| `VERTEX_REGION_CLAUDE_5_5_OPUS` | Переопределить регион для Claude Opus 5.5 при использовании Google Cloud's Agent Platform. Добавлено в версии 2.1.280 |513| `VERTEX_REGION_CLAUDE_5_5_OPUS` | Переопределить регион для Claude Opus 5.5 при использовании Google Cloud's Agent Platform. Добавлено в версии 2.1.280 |

514| `VERTEX_REGION_CLAUDE_5_5_SONNET` | Переопределить регион для Claude Sonnet 5.5 при использовании Google Cloud's Agent Platform. Добавлено в версии 2.1.284 |

509| `VERTEX_REGION_CLAUDE_5_OPUS` | Переопределить регион для Claude Opus 5 при использовании Google Cloud's Agent Platform. Добавлено в версии 2.1.219 |515| `VERTEX_REGION_CLAUDE_5_OPUS` | Переопределить регион для Claude Opus 5 при использовании Google Cloud's Agent Platform. Добавлено в версии 2.1.219 |

510| `VERTEX_REGION_CLAUDE_5_SONNET` | Переопределить регион для Claude Sonnet 5 при использовании Google Cloud's Agent Platform. Добавлено в версии 2.1.197 |516| `VERTEX_REGION_CLAUDE_5_SONNET` | Переопределить регион для Claude Sonnet 5 при использовании Google Cloud's Agent Platform. Добавлено в версии 2.1.197 |

511| `VERTEX_REGION_CLAUDE_FABLE_5` | Переопределить регион для Claude Fable 5 при использовании Google Cloud's Agent Platform. Добавлено в версии 2.1.170 |517| `VERTEX_REGION_CLAUDE_FABLE_5` | Переопределить регион для Claude Fable 5 при использовании Google Cloud's Agent Platform. Добавлено в версии 2.1.170 |

514 520

515Также поддерживаются стандартные переменные экспортёра OpenTelemetry (`OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER`, `OTEL_EXPORTER_OTLP_ENDPOINT`, `OTEL_EXPORTER_OTLP_PROTOCOL`, `OTEL_EXPORTER_OTLP_HEADERS`, `OTEL_METRIC_EXPORT_INTERVAL`, `OTEL_RESOURCE_ATTRIBUTES` и варианты, специфичные для сигнала). См. [Мониторинг](/docs/ru/monitoring-usage) для деталей конфигурации.521Также поддерживаются стандартные переменные экспортёра OpenTelemetry (`OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER`, `OTEL_EXPORTER_OTLP_ENDPOINT`, `OTEL_EXPORTER_OTLP_PROTOCOL`, `OTEL_EXPORTER_OTLP_HEADERS`, `OTEL_METRIC_EXPORT_INTERVAL`, `OTEL_RESOURCE_ATTRIBUTES` и варианты, специфичные для сигнала). См. [Мониторинг](/docs/ru/monitoring-usage) для деталей конфигурации.

516 522

523Установите `CLAUDE_CODE_ENABLE_TELEMETRY` и переменные OpenTelemetry, которые включают экспорт, выбирают его назначение или захватывают содержимое в вашей оболочке, пользовательских параметрах или управляемых параметрах. Claude Code [игнорирует их в параметрах проекта и локальных параметрах](/docs/ru/settings-reference#variables-claude-code-ignores-in-env), кроме значений отключения, которые описывает этот раздел. `OTEL_RESOURCE_ATTRIBUTES` и переменные интервала экспорта, таймаута и сжатия, такие как `OTEL_METRIC_EXPORT_INTERVAL`, по-прежнему применяются из параметров проекта и локальных параметров.

524

517<h2 id="features-that-need-feature-flag-fetching">525<h2 id="features-that-need-feature-flag-fetching">

518 Функции, требующие получения флагов функций526 Функции, требующие получения флагов функций

519</h2>527</h2>

526 534

527Когда получение отключено, вы не можете:535Когда получение отключено, вы не можете:

528 536

529* [Запускать сеансы в режиме auto по умолчанию](/docs/ru/permission-modes#which-mode-a-session-starts-in) на планах Pro, Max и Team

530* Иметь расширение VS Code [читающее файлы параметров для режима разрешений при запуске](/docs/ru/permission-modes#switch-permission-modes)

531* Запускать [`/auto-mode-setup`](/docs/ru/auto-mode-config#generate-environment-entries) для создания записей `autoMode.environment`537* Запускать [`/auto-mode-setup`](/docs/ru/auto-mode-config#generate-environment-entries) для создания записей `autoMode.environment`

532* Использовать [Remote Control](/docs/ru/remote-control#requirements)538* Использовать [Remote Control](/docs/ru/remote-control) с установленными `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` или `DISABLE_GROWTHBOOK`. Для `DISABLE_TELEMETRY` и `DO_NOT_TRACK` см. [требования Remote Control](/docs/ru/remote-control#requirements)

533* [Отправлять сообщения сеансам за пределами этой машины](/docs/ru/cross-session-messaging#message-sessions-on-other-machines); обмен сообщениями между сеансами на этой машине работает с отключённым получением539* [Отправлять сообщения сеансам за пределами этой машины](/docs/ru/cross-session-messaging#message-sessions-on-other-machines), когда [Remote Control](/docs/ru/remote-control#requirements) недоступен. Обмен сообщениями между сеансами на этой машине работает с отключённым получением

534* Запускать [`claude import` или команду `/import`](/docs/ru/cli-reference#cli-commands)540* Запускать [`claude import` или команду `/import`](/docs/ru/cli-reference#cli-commands)

535* Запускать [`/skill-doctor`](/docs/ru/skills#find-unused-skills) или открывать его отчёт на вкладке **Stats** в `/plugin`541* Запускать [`/skill-doctor`](/docs/ru/skills#find-unused-skills) или открывать его отчёт на вкладке **Stats** в `/plugin`

536* Синхронизировать [skills](/docs/ru/skills#where-synced-skills-load) и [plugins](/docs/ru/plugins-reference#synced-plugins), включённые для вашей учётной записи claude.ai, в сеансы терминала542* Синхронизировать [skills](/docs/ru/skills#where-synced-skills-load) и [plugins](/docs/ru/plugins/loading#synced-plugins), включённые для вашей учётной записи claude.ai, в сеансы терминала

537* Использовать [инструмент советника](/docs/ru/advisor#requirements)543* Использовать [инструмент советника](/docs/ru/advisor#requirements)

538* Читать или отвечать на [комментарии к артефакту](/docs/ru/artifacts#collect-comments-on-an-artifact)544* Читать или отвечать на [комментарии к артефакту](/docs/ru/artifacts#collect-comments-on-an-artifact)

539* Иметь Claude Code, зондирующий серверы соединителя claude.ai для [MCP протокола версии 2026-07-28](/docs/ru/mcp#mcp-client-runtimes), если вы не установите `MCP_PROTOCOL_NEGOTIATION=auto`545* Иметь Claude Code, зондирующий серверы соединителя claude.ai для [MCP протокола версии 2026-07-28](/docs/ru/mcp#mcp-client-runtimes), если вы не установите `MCP_PROTOCOL_NEGOTIATION=auto`

546 Первый сеанс после установки или обновления552 Первый сеанс после установки или обновления

547</h3>553</h3>

548 554

549В вашем первом сеансе после установки Claude Code или обновления до версии, которая добавляет функцию, [функция с флагом](#features-that-need-feature-flag-fetching) может отсутствовать, и сеанс может запуститься в режиме Manual на плане, который в противном случае запускается в режиме auto. Claude Code получает флаги во время этого сеанса, поэтому оба они присутствуют в вашем следующем сеансе.555В вашем первом сеансе после установки Claude Code или обновления до версии, которая добавляет функцию, [функция с флагом](#features-that-need-feature-flag-fetching) может отсутствовать. Этот сеанс также может запуститься в другом [режиме разрешений](/docs/ru/permission-modes#which-mode-a-session-starts-in), чем ваши последующие сеансы. Claude Code получает флаги во время этого сеанса, поэтому ваш следующий сеанс имеет функцию и обычный режим разрешений при запуске.

550 556

551После свежей установки в неинтерактивном сеансе, таком как `claude -p`, Agent SDK или расширение VS Code, Claude Code всё ещё может получить флаги перед тем, как он [выбирает режим разрешений при запуске](/docs/ru/permission-modes#which-mode-a-session-starts-in).557После свежей установки в неинтерактивном сеансе, таком как `claude -p`, Agent SDK или расширение VS Code, Claude Code всё ещё может получить флаги перед тем, как он [выбирает режим разрешений при запуске](/docs/ru/permission-modes#which-mode-a-session-starts-in).

552 558

errors.md +64 −36

Details

323| `Transcript saving is off — CLAUDE_CODE_SKIP_PROMPT_HISTORY is set` | [Session saving warnings](#transcript-saving-is-off-skip-prompt-history) |323| `Transcript saving is off — CLAUDE_CODE_SKIP_PROMPT_HISTORY is set` | [Session saving warnings](#transcript-saving-is-off-skip-prompt-history) |

324| `Transcript saving is off — inherited CLAUDE_CODE_CHILD_SESSION marker` | [Session saving warnings](#transcript-saving-is-off-child-session-marker) |324| `Transcript saving is off — inherited CLAUDE_CODE_CHILD_SESSION marker` | [Session saving warnings](#transcript-saving-is-off-child-session-marker) |

325| `Claude Code's fullscreen renderer didn't finish starting last time on this machine` / `Claude Code's fullscreen renderer has repeatedly failed to start on this machine` | [Configuration warnings](#fullscreen-failed-start-notice) |325| `Claude Code's fullscreen renderer didn't finish starting last time on this machine` / `Claude Code's fullscreen renderer has repeatedly failed to start on this machine` | [Fullscreen rendering](/docs/ru/fullscreen#fullscreen-renderer-didnt-finish-starting) |

326| `Claude Code exited after an unrecoverable interface error (...)` | [Configuration warnings](#exited-after-an-unrecoverable-interface-error) |326| `Claude Code exited after an unrecoverable interface error (...)` | [Configuration warnings](#exited-after-an-unrecoverable-interface-error) |

327| `Agent descriptions are over the 15.0k-token limit` | [Configuration warnings](#agent-descriptions-are-over-the-15000-token-limit) |327| `Agent descriptions are over the 15.0k-token limit` | [Configuration warnings](#agent-descriptions-are-over-the-15000-token-limit) |

328| `Not loaded: rename <path>, then restart — its name uses "<name>", a name reserved for the skills synced from your claude.ai account` | [Configuration warnings](#a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved) |328| `Not loaded: rename <path>, then restart — its name uses "<name>", a name reserved for the skills synced from your claude.ai account` | [Configuration warnings](#a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved) |

332| `Managed settings were not approved; exiting without applying them.` | [Configuration warnings](#managed-settings-were-not-approved) |332| `Managed settings were not approved; exiting without applying them.` | [Configuration warnings](#managed-settings-were-not-approved) |

333| `Claude Code can't start: your organization's managed settings block the default model` / `Claude Code can't start: your organization allows only the models listed in "availableModels"` | [Configuration warnings](#managed-settings-block-the-default-model) |333| `Claude Code can't start: your organization's managed settings block the default model` / `Claude Code can't start: your organization allows only the models listed in "availableModels"` | [Configuration warnings](#managed-settings-block-the-default-model) |

334| `Your organization's managed settings allow Claude Code to use: <providers>` | [Configuration warnings](#managed-settings-dont-allow-this-api-provider) |

335| `Your organization's managed settings allow Claude Code to use no API provider at all` | [Configuration warnings](#managed-settings-dont-allow-this-api-provider) |

334| `MCP server <name> is blocked by enterprise managed policy` | [Configuration warnings](#mcp-server-is-blocked-by-enterprise-managed-policy) |336| `MCP server <name> is blocked by enterprise managed policy` | [Configuration warnings](#mcp-server-is-blocked-by-enterprise-managed-policy) |

335| `Managed settings document could not be parsed as a JSON object; none of its settings are in effect. Fix or remove it.` | [Configuration warnings](#managed-settings-document-could-not-be-parsed) |337| `Managed settings document could not be parsed as a JSON object; none of its settings are in effect. Fix or remove it.` | [Configuration warnings](#managed-settings-document-could-not-be-parsed) |

336| `Managed settings drop-in directory could not be read` | [Configuration warnings](#managed-settings-document-could-not-be-parsed) |338| `Managed settings drop-in directory could not be read` | [Configuration warnings](#managed-settings-document-could-not-be-parsed) |

339| `Unable to read managed policy settings` | [Configuration warnings](#unable-to-read-managed-policy-settings) |

337| `otelHeadersHelper failed; telemetry is not being exported. See /status: ...` | [Configuration warnings](#otelheadershelper-failed) |340| `otelHeadersHelper failed; telemetry is not being exported. See /status: ...` | [Configuration warnings](#otelheadershelper-failed) |

338| `"crossSessionInbound" must be one of "accept", "hold", "refuse"` | [Configuration warnings](#crosssessioninbound-must-be-one-of-accept-hold-refuse) |341| `"crossSessionInbound" must be one of "accept", "hold", "refuse"` | [Configuration warnings](#crosssessioninbound-must-be-one-of-accept-hold-refuse) |

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

3658</h3>3661</h3>

3659 3662

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

3664

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

3661 3666

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

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

3664```3669```

3665 3670

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

3667 3672

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

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

3670 3675

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

3672 3677

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

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

3921commands path escapes plugin directory: ./commands\deploy.md — its path contains a backslash, which is not resolved reliably on this platform3926commands path escapes plugin directory: ./commands\deploy.md — its path contains a backslash, which is not resolved reliably on this platform

3922```3927```

3923 3928

3924До версии v2.1.251 Claude Code загружала путь `commands`, объявленный в записи маркетплейса, даже когда он указывал вне директории плагина. Claude Code уже отклоняла пути, объявленные в `plugin.json`, и другие пути компонентов в записи маркетплейса.3929До версии v2.1.251 Claude Code загружала путь `commands`, объявленный в записи маркетплейса, даже когда он указывал вне директории плагина.

3925 3930

3926До версии v2.1.257 проверка смотрела только на написание пути, а не на то, где ведёт символическая ссылка.3931До версии v2.1.257 проверка смотрела только на написание пути, а не на то, где ведёт символическая ссылка.

3927 3932

4001* `Failed to load marketplace configuration`: файл не является действительным JSON, или не может быть прочитан. Пустой файл также не работает таким образом.4006* `Failed to load marketplace configuration`: файл не является действительным JSON, или не может быть прочитан. Пустой файл также не работает таким образом.

4002* `Marketplace configuration file is corrupted`: файл является действительным JSON, но его содержимое не соответствует схеме реестра.4007* `Marketplace configuration file is corrupted`: файл является действительным JSON, но его содержимое не соответствует схеме реестра.

4003 4008

4004Отсутствующий файл не является ошибкой: Claude Code рассматривает его как реестр без маркетплейсов.

~~4005~~

4006С пустым файлом `claude plugin install` сообщает:4009С пустым файлом `claude plugin install` сообщает:

4007 4010

4008```text theme={null}4011```text theme={null}

4460 4463

4461Команды, которые открывают интерактивный диалог, не могут это делать, пока к фоновому сеансу не подключён терминал. `/install-github-app`, список параметров `/mcp` и действия аутентификации в меню сервера MCP отвечают сообщением. Для `/install-github-app` и списка параметров `/mcp` сеанс также появляется под **Needs input** в [представлении агента](/docs/ru/agent-view), чтобы вы могли его найти, подключиться и запустить команду снова. Пока терминал подключён, эти команды работают нормально.4464Команды, которые открывают интерактивный диалог, не могут это делать, пока к фоновому сеансу не подключён терминал. `/install-github-app`, список параметров `/mcp` и действия аутентификации в меню сервера MCP отвечают сообщением. Для `/install-github-app` и списка параметров `/mcp` сеанс также появляется под **Needs input** в [представлении агента](/docs/ru/agent-view), чтобы вы могли его найти, подключиться и запустить команду снова. Пока терминал подключён, эти команды работают нормально.

4462 4465

4463До версии 2.1.216 сеанс не появлялся под **Needs input** после `/install-github-app` или списка параметров `/mcp` был отклонён. В версиях 2.1.213–2.1.215 команды всё ещё работали, пока был подключён терминал, и сообщение об отказе говорило вам подключиться и запустить команду снова. С версии 2.1.208 по 2.1.212 Claude Code отклонял их даже при подключённом терминале с сообщением вроде `Can't open MCP settings in a background session`; на этих версиях запустите команду из обычного сеанса `claude` вместо этого или обновитесь. До версии 2.1.208 они открывали свой диалог внутри фонового сеанса. Только в версии 2.1.208 Claude Code также отклонял средство выбора `/model` в фоновом сеансе, и `/upgrade` выводил URL обновления вместо открытия браузера.4466До версии 2.1.216 сеанс не появлялся под **Needs input** после того, как `/install-github-app` или список параметров `/mcp` был отклонён. В версиях 2.1.213–2.1.215 команды всё ещё работали, пока был подключён терминал, и сообщение об отказе говорило вам подключиться и запустить команду снова. С версии 2.1.208 по 2.1.212 Claude Code отклонял их даже при подключённом терминале с сообщением вроде `Can't open MCP settings in a background session`; на этих версиях запустите команду из обычного сеанса `claude` вместо этого или обновитесь. До версии 2.1.208 они открывали свой диалог внутри фонового сеанса. Только в версии 2.1.208 Claude Code также отклонял средство выбора `/model` в фоновом сеансе, и `/upgrade` выводил URL обновления вместо открытия браузера.

4464 4467

4465Формулировка называет команду. Список параметров `/mcp` сообщает:4468Формулировка называет команду. Список параметров `/mcp` сообщает:

4466 4469

4626terminal host process died — press Enter to restart4629terminal host process died — press Enter to restart

4627```4630```

4628 4631

4629Если вы откроете строку до запуска проверки, нижний колонтитул показывает `This session's terminal host process died (the conversation is saved) — press Enter to restart it` и строка становится неудачной.

~~4630~~

4631Из оболочки `claude attach <id>` перезапускает сеанс, уже отмеченный как неудачный для мёртвого хоста, и в противном случае выводит причину и выходит:4632Из оболочки `claude attach <id>` перезапускает сеанс, уже отмеченный как неудачный для мёртвого хоста, и в противном случае выводит причину и выходит:

4632 4633

4633```text theme={null}4634```text theme={null}

5023 5024

5024Claude Code записывает большинство этих сообщений в stderr, а не в беседу, и выводит большинство из них при запуске. Запись указывает, когда её сообщение появляется в другом месте, например в журнале отладки или как уведомление при запуске в представлении беседы, или в другое время, например [диагностическая строка unrecognized-model](#unrecognized-model-id-on-a-request) во время запроса.5025Claude Code записывает большинство этих сообщений в stderr, а не в беседу, и выводит большинство из них при запуске. Запись указывает, когда её сообщение появляется в другом месте, например в журнале отладки или как уведомление при запуске в представлении беседы, или в другое время, например [диагностическая строка unrecognized-model](#unrecognized-model-id-on-a-request) во время запроса.

5025 5026

5026<h3 id="fullscreen-failed-start-notice">

5027 Fullscreen renderer didn't finish starting

5028</h3>

~~5029~~

5030Предыдущий сеанс [fullscreen](/docs/ru/fullscreen) на этом компьютере завершился до того, как закончил запускаться, поэтому Claude Code запускает этот сеанс на классическом renderer и выводит одно из этих уведомлений:

~~5031~~

5032```text theme={null}

5033Claude Code's fullscreen renderer didn't finish starting last time on this machine, so this launch is using the classic renderer. It will try fullscreen again next launch; /tui default keeps the classic renderer.

~~5034~~

5035Claude Code's fullscreen renderer has repeatedly failed to start on this machine, so it has been turned off here. Run /tui fullscreen to try it again (this also resets after an update).

5036```

~~5037~~

5038**Что делать:**

~~5039~~

5040* Следуйте инструкциям [Fullscreen rendering](/docs/ru/fullscreen#fullscreen-renderer-didnt-finish-starting). Там указано, какое уведомление вы получите, что Claude Code делает в последующих сеансах и как снова попробовать fullscreen или оставить классический renderer.

5041* Если сеанс, который завершился, вывел сообщение об выходе, см. [Claude Code exited after an unrecoverable interface error](#exited-after-an-unrecoverable-interface-error) для получения информации о том, что оно называет.

~~5042~~

5043До версии 2.1.236 Claude Code не выводил уведомление и продолжал запускать сеансы в fullscreen rendering после неудачного запуска.

~~5044~~

5045<h3 id="exited-after-an-unrecoverable-interface-error">5027<h3 id="exited-after-an-unrecoverable-interface-error">

5046 Claude Code exited after an unrecoverable interface error5028 Claude Code exited after an unrecoverable interface error

5047</h3>5029</h3>

5193* Если вы администрируете параметры, добавьте модель, которую ваши пользователи могут запустить, в `availableModels` или сузьте записи `deniedModels`, которые блокируют каждый fallback. [Block specific models or versions](/docs/ru/model-config#block-specific-models-or-versions) описывает, как Default option переходит5175* Если вы администрируете параметры, добавьте модель, которую ваши пользователи могут запустить, в `availableModels` или сузьте записи `deniedModels`, которые блокируют каждый fallback. [Block specific models or versions](/docs/ru/model-config#block-specific-models-or-versions) описывает, как Default option переходит

5194* Если вы их не администрируете, отправьте сообщение вашему администратору. Ваши собственные файлы параметров не могут расширить управляемый `availableModels` или `deniedModels` список5176* Если вы их не администрируете, отправьте сообщение вашему администратору. Ваши собственные файлы параметров не могут расширить управляемый `availableModels` или `deniedModels` список

5195 5177

5178<h3 id="managed-settings-dont-allow-this-api-provider">

5179 Managed settings don't allow this API provider

5180</h3>

5181

5182[managed settings](/docs/ru/managed-settings) вашей организации устанавливают список [`allowedProviders`](/docs/ru/settings-reference#allowedproviders), и поставщик API сеанса не находится в нём или сеанс использует конечную точку, которая не закреплена так, как требует эта запись. Claude Code отказывает при запуске, перед входом или когда сеанс в следующий раз свяжется с API. Сообщение начинается с разрешённых поставщиков:

5183

5184```text theme={null}

5185Your organization's managed settings allow Claude Code to use: Anthropic API, Amazon Bedrock.

5186```

5187

5188Когда список пуст, сообщение читается вместо этого:

5189

5190```text theme={null}

5191Your organization's managed settings allow Claude Code to use no API provider at all (allowedProviders is an empty list), so it cannot start on this machine.

5192```

5193

5194Когда каждая запись не распознана, скобка читается `(allowedProviders lists only unrecognized entries)` вместо этого.

5195

5196**Что делать:**

5197

5198* Следуйте шагам `To continue:` сообщения

5199* Если вы администрируете параметры, строки сообщения, начинающиеся с `Admins:`, называют запись для добавления или значение для закрепления, и запись [`allowedProviders`](/docs/ru/settings-reference#allowedproviders) говорит, какой блок `env` источника может закрепить его

5200

5196<h3 id="mcp-server-is-blocked-by-enterprise-managed-policy">5201<h3 id="mcp-server-is-blocked-by-enterprise-managed-policy">

5197 MCP server is blocked by enterprise managed policy5202 MCP server is blocked by enterprise managed policy

5198</h3>5203</h3>

5246* Если вы администрируете машину, исправьте названный документ так, чтобы он анализировался как объект JSON, или удалите файл, профиль или значение реестра. Пустой `managed-settings.json` считается `{}` и не блокирует запуск.5251* Если вы администрируете машину, исправьте названный документ так, чтобы он анализировался как объект JSON, или удалите файл, профиль или значение реестра. Пустой `managed-settings.json` считается `{}` и не блокирует запуск.

5247* Если нет, попросите вашего администратора исправить развёрнутый документ. Ничто в ваших собственных файлах параметров не вызывает и не очищает эту ошибку.5252* Если нет, попросите вашего администратора исправить развёрнутый документ. Ничто в ваших собственных файлах параметров не вызывает и не очищает эту ошибку.

5248 5253

5254<h3 id="unable-to-read-managed-policy-settings">

5255 Unable to read managed policy settings

5256</h3>

5257

5258Ваша организация развёртывает [managed settings](/docs/ru/managed-settings), и один из развёрнутых источников существует, но не мог быть прочитан по причине, такой как ошибка ввода-вывода, а не отказ операционной системы в чтении. Без другого источника администратора, поставляющего политику, Claude Code выходит при запуске, а не запускается без политики, которую может нести источник:

5259

5260```text theme={null}

5261Unable to read managed policy settings.

5262This machine may require organization login enforcement, but the policy file failed to load.

5263Contact your administrator.

5264

5265Detail: <source>: <reason>

5266```

5267

5268В том же состоянии потоки входа, запросы API из уже работающего сеанса и сервер [`claude gateway`](/docs/ru/claude-apps-gateway) отказываются с вариантом первой строки, которая называет [`allowedProviders`](/docs/ru/settings-reference#allowedproviders).

5269

5270Чтение, которое операционная система отклонила, например на файле только для root, не создаёт этот выход: [сеанс запускается без политик этого источника](/docs/ru/managed-settings#find-entries-claude-code-dropped). Для источника, который не может быть проанализирован, Claude Code выходит с [другим сообщением, называющим источник](#managed-settings-document-could-not-be-parsed).

5271

5272**Что делать:**

5273

5274* Если вы администрируете машину, исправьте проблему, которую называет строка `Detail:`, чтобы развёрнутый источник мог быть прочитан, или удалите источник

5275* Если нет, отправьте сообщение вашему администратору. Ничто в ваших собственных файлах параметров не вызывает и не очищает эту ошибку

5276

5277До версии 2.1.285 только сеансы, вошедшие с учётными данными claude.ai или Claude Console, выходили с этим сообщением, и чтение, которое операционная система отклонила, также создавало его.

5278

5249<h3 id="otelheadershelper-failed">5279<h3 id="otelheadershelper-failed">

5250 otelHeadersHelper failed5280 otelHeadersHelper failed

5251</h3>5281</h3>

5344* Исправьте правило в источнике, который называет предупреждение в скобках: путь файла параметров или сам флаг `--allowed-tools`. Путь `claude-settings-<hash>.json`, который не существует на диске, обозначает встроенное значение `--settings`. Исправьте JSON, который вы передаёте этому флагу.5374* Исправьте правило в источнике, который называет предупреждение в скобках: путь файла параметров или сам флаг `--allowed-tools`. Путь `claude-settings-<hash>.json`, который не существует на диске, обозначает встроенное значение `--settings`. Исправьте JSON, который вы передаёте этому флагу.

5345* Если источник читает `managed policy settings`, перенаправьте предупреждение тому, кто поддерживает ваши управляемые параметры, так как вы не можете очистить его самостоятельно.5375* Если источник читает `managed policy settings`, перенаправьте предупреждение тому, кто поддерживает ваши управляемые параметры, так как вы не можете очистить его самостоятельно.

5346 5376

5347Claude Code не предупреждает о правилах deny и ask с той же формой: он отказывает или запрашивает дополнительные команды, которые они соответствуют, а не одобряет их. Он также не предупреждает о правилах, чья подкоманда приходит перед первым `*`, например `Bash(git commit *)`, или правилах, в которых ни одно слово, кроме опции, не следует за `*`, например `Bash(git *)`, или о правилах префикса `:*` такие как `Bash(git:*)`.

~~5348~~

5349В [background session](/docs/ru/agent-view) или с `--output-format json` или `stream-json`, Claude Code записывает предупреждение в журнал отладки вместо stderr, поэтому вывод, читаемый машиной, остаётся чистым. Выполните с `--debug` для захвата его в `~/.claude/debug/<session-id>.txt`. До версии 2.1.246 Claude Code принимал эти правила без предупреждения.5377В [background session](/docs/ru/agent-view) или с `--output-format json` или `stream-json`, Claude Code записывает предупреждение в журнал отладки вместо stderr, поэтому вывод, читаемый машиной, остаётся чистым. Выполните с `--debug` для захвата его в `~/.claude/debug/<session-id>.txt`. До версии 2.1.246 Claude Code принимал эти правила без предупреждения.

5350 5378

5351<h3 id="crosssessioninbound-must-be-one-of-accept-hold-refuse">5379<h3 id="crosssessioninbound-must-be-one-of-accept-hold-refuse">

5458 Ответы кажутся ниже обычного качества5486 Ответы кажутся ниже обычного качества

5459</h2>5487</h2>

5460 5488

5461Если ответы Claude кажутся менее способными, чем вы ожидаете, но ошибка не отображается, причина обычно в состоянии разговора, а не в самой модели. Claude Code не молча меняет версии модели. Он может переключиться на резервную модель в трёх конкретных случаях:5489Если ответы Claude кажутся менее способными, чем вы ожидаете, но ошибка не отображается, причина обычно в состоянии разговора, а не в самой модели. Claude Code не молча меняет версии модели. Он может переключиться на резервную модель в этих случаях:

5462 5490

5463* Настроенный [`--fallback-model`](/docs/ru/cli-reference#cli-flags) берёт на себя управление после ошибки доступности только для этого хода с уведомлением в расшифровке5491* Настроенный [`--fallback-model`](/docs/ru/cli-reference#cli-flags) берёт на себя управление после ошибки доступности только для этого хода с уведомлением в расшифровке

5464* Проверка запуска Amazon Bedrock или Google Cloud's Agent Platform обнаруживает, что ваша модель по умолчанию недоступна5492* Проверка запуска Amazon Bedrock или Google Cloud's Agent Platform обнаруживает, что ваша модель по умолчанию недоступна, или ваша учётная запись [теряет доступ к ней во время сеанса](/docs/ru/amazon-bedrock#when-a-model-is-disabled-mid-session)

5465* [Автоматический переход на резервную модель](/docs/ru/model-config#automatic-model-fallback) на Fable 5.1, Fable 5, Opus 5.5, Sonnet 5.5 и Opus 5 переводит сеанс на резервную модель категории с флагом, когда у этой категории она есть, и показывает уведомление в расшифровке5493* [Автоматический переход на резервную модель](/docs/ru/model-config#automatic-model-fallback) на Fable 5.1, Fable 5, Opus 5.5, Sonnet 5.5 и Opus 5 переводит сеанс на резервную модель категории с флагом, когда у этой категории она есть, и показывает уведомление в расшифровке

5466 5494

5467Проверка выбора модели ниже ловит второй и третий случаи; первый появляется как уведомление в расшифровке, а не как изменение `/model`. [Конфигурация модели](/docs/ru/model-config) объясняет, когда применяется каждый переход на резервную модель.5495Проверка выбора модели ниже ловит второй и третий случаи; первый появляется как уведомление в расшифровке, а не как изменение `/model`. [Конфигурация модели](/docs/ru/model-config) объясняет, когда применяется каждый переход на резервную модель.

5477 5505

5478Если качество всё ещё кажется неправильным после проверки вышеуказанного, запустите `/feedback` и опишите, что вы ожидали в сравнении с тем, что вы получили. Обратная связь, отправленная таким образом, включает расшифровку разговора, что является самым быстрым способом для Anthropic диагностировать реальную регрессию. См. [Сообщить об ошибке](#report-an-error), если `/feedback` недоступен в вашей среде.5506Если качество всё ещё кажется неправильным после проверки вышеуказанного, запустите `/feedback` и опишите, что вы ожидали в сравнении с тем, что вы получили. Обратная связь, отправленная таким образом, включает расшифровку разговора, что является самым быстрым способом для Anthropic диагностировать реальную регрессию. См. [Сообщить об ошибке](#report-an-error), если `/feedback` недоступен в вашей среде.

5479 5507

5480Если Claude предупреждает о подозреваемой инъекции подсказки или отказывает в запросе из-за подозреваемой инъекции, и текст, который называет предупреждение, — это контекст, который Claude Code добавляет к разговору автоматически, а не содержимое файла или веб-сайта, запустите `claude update` и повторите попытку. Если предупреждение повторяется после обновления, [сообщите об этом](#report-an-error) вместо того, чтобы вставлять отмеченное содержимое обратно в подсказку. До версии 2.1.201 Sonnet 5 отказывал в некоторых запросах таким же образом.5508Если Claude предупреждает о подозреваемой инъекции подсказки, или отказывает в запросе из-за подозреваемой инъекции, и текст, который называет предупреждение, — это контекст, который Claude Code добавляет к разговору автоматически, а не содержимое файла или веб-сайта, запустите `claude update` и повторите попытку. Если предупреждение повторяется после обновления, [сообщите об этом](#report-an-error) вместо того, чтобы вставлять отмеченное содержимое обратно в подсказку. До версии 2.1.201 Sonnet 5 отказывал в некоторых запросах таким же образом.

5481 5509

5482<h2 id="report-an-error">5510<h2 id="report-an-error">

5483 Сообщить об ошибке5511 Сообщить об ошибке

google-vertex-ai.md +12 −0

Details

293 293

294Псевдонимы моделей, такие как `opus`, не действуют как закрепления, и также не действует ID модели, который Claude Code не распознает.294Псевдонимы моделей, такие как `opus`, не действуют как закрепления, и также не действует ID модели, который Claude Code не распознает.

295 295

296Когда эти проверки находят модель, которую ваш проект не может вызвать, Claude Code запоминает отказ на этой машине на срок до одного дня и во время этого времени запускается, пропуская запомненную модель без повторного обращения к Agent Platform. Claude Code проверяет запомненный отказ текущей модели по умолчанию снова при запуске один раз через десять минут после последней проверки, поэтому значение по умолчанию, которое ваш администратор повторно включит, вернется. Чтобы отключить память, установите [`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](/docs/ru/env-vars).

297

298<h3 id="when-a-model-is-disabled-mid-session">

299 Когда модель отключена во время сеанса

300</h3>

301

302Если ваш проект потеряет доступ к модели, на которой работает ваш сеанс, например потому что администратор отключит ее в [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden), Claude Code переключает сеанс на другую модель вместо того, чтобы не выполнять каждый запрос, и показывает `Switched to <fallback> because <model> is not available`. Он пытается использовать те же модели, что и откат при запуске: более ранние версии того же уровня сначала и, для сеанса Opus без доступной версии Opus, модель Sonnet по умолчанию.

303

304Переключение применяется только к уровню, который вы не закрепили, то же условие, что и откат при запуске. Сеанс на конкретной версии, которую вы выбрали, сохраняет свою модель и, без цепочки моделей отката, запрос не выполняется. В [режиме auto](/docs/ru/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry) Claude Code переключается только на модель, которую режим auto поддерживает на Agent Platform. Если ни одна из этих моделей также недоступна, запрос не выполняется.

305

306[Цепочка моделей отката](/docs/ru/model-config#fallback-model-chains), которую вы настраиваете, заменяет переключение уровня: при этих отказах Claude Code переключается на вашу настроенную модель отката вместо этого. Чтобы отказанные запросы не выполнялись вместо переключения, установите [`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](/docs/ru/env-vars). Цепочка отката, которую вы настроили, все еще переключается при этих отказах; удалите цепочку также, если вы хотите, чтобы каждый отказанный запрос не выполнялся.

307

296<h2 id="iam-configuration">308<h2 id="iam-configuration">

297 Конфигурация IAM309 Конфигурация IAM

298</h2>310</h2>

headless.md +2 −2

Details

296 Автоматическое одобрение инструментов296 Автоматическое одобрение инструментов

297</h3>297</h3>

298 298

299Используйте `--allowedTools` для разрешения Claude использовать определённые инструменты без запроса. Этот пример запускает набор тестов и исправляет ошибки, позволяя Claude выполнять команды Bash и читать/редактировать файлы без запроса разрешения:299Используйте `--allowedTools` для разрешения Claude использовать определённые инструменты без запроса. Перечисление `Read` и `Edit` позволяет Claude читать и редактировать файлы без запроса разрешения. Перечисление `Bash` делает то же самое для команд shell, за исключением запуска, который начинается в [режиме auto](/docs/ru/permission-modes#how-auto-mode-evaluates-actions), где Claude Code отбрасывает запись `Bash` как широкое правило разрешения и режим auto оценивает каждую команду вместо этого. Этот пример запускает набор тестов и исправляет ошибки с этими тремя инструментами в списке:

300 300

301```bash theme={null}301```bash theme={null}

302claude -p "Run the test suite and fix any failures" \302claude -p "Run the test suite and fix any failures" \

303 --allowedTools "Bash,Read,Edit"303 --allowedTools "Bash,Read,Edit"

304```304```

305 305

306Чтобы установить базовый уровень для всего сеанса вместо перечисления отдельных инструментов, передайте [режим разрешений](/docs/ru/permission-modes). Для `-p` [встроенный начальный режим разрешений](/docs/ru/permission-modes#which-mode-a-session-starts-in) — это Manual на каждом плане, поэтому передайте нужный вам режим разрешений:306Чтобы установить базовый уровень для всего сеанса вместо перечисления отдельных инструментов, передайте [режим разрешений](/docs/ru/permission-modes). Запуск, где ничто не устанавливает режим разрешений, принимает [встроенный начальный режим разрешений](/docs/ru/permission-modes#which-mode-a-session-starts-in), который может быть `auto`, поэтому передайте нужный вам режим:

307 307

308* **`auto`**: передайте `--permission-mode auto`, чтобы классификатор проверил большинство действий вместо вас308* **`auto`**: передайте `--permission-mode auto`, чтобы классификатор проверил большинство действий вместо вас

309* **`dontAsk`**: Claude Code отклоняет каждый вызов, который иначе вызвал бы запрос, что полезно для заблокированных CI запусков. Действия, которые не требуют одобрения в режиме Manual, всё ещё выполняются, такие как чтение файлов в ваших рабочих каталогах и [набор команд только для чтения](/docs/ru/permissions#read-only-commands), а также действия, которые охватывают ваши записи `--allowedTools` или правила `permissions.allow`. `AskUserQuestion`, инструменты соединителя [которые ваша организация установила на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools) и MCP инструменты, отмеченные [`requiresUserInteraction`](/docs/ru/mcp#require-approval-for-a-specific-tool), отклоняются даже когда правило разрешения совпадает309* **`dontAsk`**: Claude Code отклоняет каждый вызов, который иначе вызвал бы запрос, что полезно для заблокированных CI запусков. Действия, которые не требуют одобрения в режиме Manual, всё ещё выполняются, такие как чтение файлов в ваших рабочих каталогах и [набор команд только для чтения](/docs/ru/permissions#read-only-commands), а также действия, которые охватывают ваши записи `--allowedTools` или правила `permissions.allow`. `AskUserQuestion`, инструменты соединителя [которые ваша организация установила на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools) и MCP инструменты, отмеченные [`requiresUserInteraction`](/docs/ru/mcp#require-approval-for-a-specific-tool), отклоняются даже когда правило разрешения совпадает

hooks.md +2 −2

Details

12 12

13Hooks — это определяемые пользователем команды оболочки, конечные точки HTTP, вызовы инструментов MCP, подсказки LLM или подагенты, которые выполняются автоматически в определённых точках жизненного цикла Claude Code. Claude Code запускает одни и те же события hook везде, где он работает: сеансы в терминале, расширения IDE, [приложение Desktop](/docs/ru/desktop-quickstart) и [облачные сеансы](/docs/ru/claude-code-on-the-web). Используйте этот справочник для поиска схем событий, параметров конфигурации, форматов JSON входа/выхода и расширенных функций, таких как асинхронные hooks, HTTP hooks и MCP tool hooks.13Hooks — это определяемые пользователем команды оболочки, конечные точки HTTP, вызовы инструментов MCP, подсказки LLM или подагенты, которые выполняются автоматически в определённых точках жизненного цикла Claude Code. Claude Code запускает одни и те же события hook везде, где он работает: сеансы в терминале, расширения IDE, [приложение Desktop](/docs/ru/desktop-quickstart) и [облачные сеансы](/docs/ru/claude-code-on-the-web). Используйте этот справочник для поиска схем событий, параметров конфигурации, форматов JSON входа/выхода и расширенных функций, таких как асинхронные hooks, HTTP hooks и MCP tool hooks.

14 14

15Плагин также может регистрировать hooks как функции JavaScript, которые Claude Code вызывает в своём собственном процессе, которые могут отображаться в интерфейсе, а также реагировать на события. Плагин, который это делает, — это [mod](/docs/ru/plugins/mods/overview), и эти функциональные hooks рассматриваются в разделе [Реагирование на события](/docs/ru/plugins/mods/events), а не здесь. Hooks на этой странице продолжают работать наряду с модами.

15<h2 id="hook-lifecycle">17<h2 id="hook-lifecycle">

16 Жизненный цикл hook18 Жизненный цикл hook

17</h2>19</h2>

459 459

460Когда Claude Code не может определить, какие команды запускает входные данные Bash, он запускает ваш hook независимо от шаблона. Поскольку фильтр `if` является лучшим усилием, используйте [систему разрешений](/docs/ru/permissions) вместо hook для обеспечения жёсткого разрешения или отказа.460Когда Claude Code не может определить, какие команды запускает входные данные Bash, он запускает ваш hook независимо от шаблона. Поскольку фильтр `if` является лучшим усилием, используйте [систему разрешений](/docs/ru/permissions) вместо hook для обеспечения жёсткого разрешения или отказа.

hooks-guide.md +3 −1

Details

1014 1014

1015Hooks `PreToolUse` срабатывают перед любой проверкой режима разрешений в каждом [режиме разрешений](/docs/ru/permission-modes), включая `dontAsk`. Hook, возвращающий `permissionDecision: "deny"`, блокирует инструмент даже в режиме `bypassPermissions` или с `--dangerously-skip-permissions`. Это позволяет вам применять политику, которую пользователи не могут обойти, изменив свой режим разрешений.1015Hooks `PreToolUse` срабатывают перед любой проверкой режима разрешений в каждом [режиме разрешений](/docs/ru/permission-modes), включая `dontAsk`. Hook, возвращающий `permissionDecision: "deny"`, блокирует инструмент даже в режиме `bypassPermissions` или с `--dangerously-skip-permissions`. Это позволяет вам применять политику, которую пользователи не могут обойти, изменив свой режим разрешений.

1016 1016

1017Обратное неверно: hook, возвращающий `"allow"`, не обходит правила отказа из параметров, и он не может подавить запрос для инструментов MCP, отмеченных [`requiresUserInteraction`](/docs/ru/mcp#require-approval-for-a-specific-tool), или для инструментов соединителя [которые ваша организация установила на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools) в сеансах, где эта настройка достигает Claude Code. Hooks могут ужесточить ограничения, но не ослабить их сверх того, что разрешают правила разрешений.1017Обратное неверно: hook, возвращающий `"allow"`, не обходит правила отказа из параметров, и он не может подавить запрос для инструментов MCP, отмеченных [`requiresUserInteraction`](/docs/ru/mcp#require-approval-for-a-specific-tool), или для инструментов соединителя [которые ваша организация установила на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools) в сеансах, где эта настройка достигает Claude Code. Hooks в файлах параметров и в `hooks/hooks.json` плагина могут ужесточить ограничения, но не ослабить их сверх того, что разрешают правила разрешений.

1018

1019A [mod](/docs/ru/plugins/mods/overview) that you install that hooks `tool.check` can approve a call that your `PreToolUse` hook blocked, unless the hook is in managed settings. [Extend permissions with hooks](/docs/ru/permissions#extend-permissions-with-hooks) lists which rules hold over a mod.

1018 1020

1019<h3 id="hook-not-firing">1021<h3 id="hook-not-firing">

1020 Hook не срабатывает1022 Hook не срабатывает

interactive-mode.md +4 −6

Details

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

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

348 348

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

350 350

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

352 352

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

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

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

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

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

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

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

365 363

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

367 365

368**Часто используемые фоновые команды:**366**Часто используемые фоновые команды:**

369 367

keybindings.md +1 −3

Details

545* При использовании нелатинской раскладки, такой как кириллица, Claude Code сопоставляет сочетания Ctrl по позиции клавиши в раскладке US, когда терминал использует протокол клавиатуры Kitty и сообщает эту позицию. В таком терминале с активной русской раскладкой нажатие Ctrl и физической клавиши W запускает `ctrl+w`. В терминале, который не сообщает позицию, Claude Code сопоставляет то, что отправляет терминал для нажатия клавиши: код управления ASCII запускает латинское сочетание, а нажатие клавиши, которое приходит как кириллический символ, не соответствует никакой привязке545* При использовании нелатинской раскладки, такой как кириллица, Claude Code сопоставляет сочетания Ctrl по позиции клавиши в раскладке US, когда терминал использует протокол клавиатуры Kitty и сообщает эту позицию. В таком терминале с активной русской раскладкой нажатие Ctrl и физической клавиши W запускает `ctrl+w`. В терминале, который не сообщает позицию, Claude Code сопоставляет то, что отправляет терминал для нажатия клавиши: код управления ASCII запускает латинское сочетание, а нажатие клавиши, которое приходит как кириллический символ, не соответствует никакой привязке

546* При использовании раскладок, которые переставляют латинские буквы, такие как AZERTY, Claude Code сопоставляет букву, которую вводит клавиша, поэтому нажатие Ctrl и клавиши с надписью A запускает `ctrl+a`546* При использовании раскладок, которые переставляют латинские буквы, такие как AZERTY, Claude Code сопоставляет букву, которую вводит клавиша, поэтому нажатие Ctrl и клавиши с надписью A запускает `ctrl+a`

547 547

548До версии 2.1.247 нажатие сочетания Ctrl при использовании нелатинской раскладки не запускало его привязку в терминалах, которые используют протокол клавиатуры Kitty, таких как Ghostty, Kitty, WezTerm и iTerm2.

~~549~~

550<h3 id="chords">548<h3 id="chords">

551 Аккорды549 Аккорды

552</h3>550</h3>

697* Неправильно написанных модификаторов, таких как `ctl+k`. Claude Code удаляет часть, которую он не распознаёт, и применяет привязку к оставшемуся нажатию клавиши, `k` в этом примере.695* Неправильно написанных модификаторов, таких как `ctl+k`. Claude Code удаляет часть, которую он не распознаёт, и применяет привязку к оставшемуся нажатию клавиши, `k` в этом примере.

698* Неверных имён контекстов696* Неверных имён контекстов

699* Неверных значений действий, таких как действие, которое не является строкой или `null`697* Неверных значений действий, таких как действие, которое не является строкой или `null`

700* Неизвестных имён действий, таких как опечатка зарегистрированного действия. Claude Code пропускает привязку и сохраняет любую привязку по умолчанию для этого ключа в силе. До версии 2.1.246 привязка с неизвестным именем действия молча отключала этот ключ698* Неизвестных имён действий, таких как опечатка зарегистрированного действия. Claude Code пропускает привязку и сохраняет любую привязку по умолчанию для этого ключа в силе.

701* Конфликтов зарезервированных сочетаний699* Конфликтов зарезервированных сочетаний

702* Дублирующихся привязок в одном контексте700* Дублирующихся привязок в одном контексте

703 701

llm-gateway.md +2 −0

Details

45 45

46[Развертывание LLM gateway для вашей организации](/docs/ru/llm-gateway-rollout) проходит каждый шаг и показывает файлы конфигурации для распределения на каждом. Шлюз — это одна часть организационной настройки; для применения политики, видимости использования и решений по обработке данных см. [Настройка Claude Code для вашей организации](/docs/ru/admin-setup).46[Развертывание LLM gateway для вашей организации](/docs/ru/llm-gateway-rollout) проходит каждый шаг и показывает файлы конфигурации для распределения на каждом. Шлюз — это одна часть организационной настройки; для применения политики, видимости использования и решений по обработке данных см. [Настройка Claude Code для вашей организации](/docs/ru/admin-setup).

47 47

48Чтобы сделать шлюз, доступный через `ANTHROPIC_BASE_URL`, единственным пунктом назначения, который может использовать управляемая машина, установите [`allowedProviders`](/docs/ru/settings-reference#allowedproviders) на `["customEndpoint"]` в том же управляемом файле параметров и поместите `ANTHROPIC_BASE_URL` шлюза в блок `env` этого файла. Claude Code затем отказывает в сеансе, направленном куда-либо еще, включая непосредственно в Anthropic или на собственный прокси разработчика, и принимает `ANTHROPIC_BASE_URL` только со значением, которое вы там установили. Для шлюза, доступного через переменную конечной точки, специфичную для поставщика, такую как `ANTHROPIC_BEDROCK_BASE_URL`, запись `allowedProviders` указывает, какую переменную закрепить. Требуется Claude Code v2.1.285 или более поздняя версия.

48<h2 id="subscriptions-and-gateways">50<h2 id="subscriptions-and-gateways">

49 Подписки и шлюзы51 Подписки и шлюзы

50</h2>52</h2>

llm-gateway-protocol.md +1 −1

Details

310 310

311Claude Code отправляет запрос обнаружения с обоими заголовками учетных данных ниже и опускает заголовок, значение которого не разрешается. Отправка обоих заголовков требует Claude Code v2.1.248 или позже. Более ранние версии отправляют только `Authorization`, когда установлен `ANTHROPIC_AUTH_TOKEN`, и только `x-api-key` в противном случае.311Claude Code отправляет запрос обнаружения с обоими заголовками учетных данных ниже и опускает заголовок, значение которого не разрешается. Отправка обоих заголовков требует Claude Code v2.1.248 или позже. Более ранние версии отправляют только `Authorization`, когда установлен `ANTHROPIC_AUTH_TOKEN`, и только `x-api-key` в противном случае.

312 312

313* `Authorization`: `ANTHROPIC_AUTH_TOKEN` как токен носителя, в противном случае значение [`apiKeyHelper`](/docs/ru/llm-gateway-connect#rotate-credentials-with-apikeyhelper) как токен носителя. В этом случае Claude Code ждет, пока помощник вернет результат перед отправкой запроса.313* `Authorization`: `ANTHROPIC_AUTH_TOKEN` как токен носителя, в противном случае значение [`apiKeyHelper`](/docs/ru/llm-gateway-connect#rotate-credentials-with-apikeyhelper) как токен носителя.

314* `x-api-key`: разрешенный Claude Code ключ API, такой как `ANTHROPIC_API_KEY`. Когда значение помощника является единственным учетным данием, этот заголовок также его содержит, поэтому значение поступает в оба заголовка.314* `x-api-key`: разрешенный Claude Code ключ API, такой как `ANTHROPIC_API_KEY`. Когда значение помощника является единственным учетным данием, этот заголовок также его содержит, поэтому значение поступает в оба заголовка.

315 315

316Claude Code также отправляет любые заголовки из `ANTHROPIC_CUSTOM_HEADERS`. Когда пользовательский заголовок имеет непустое значение, Claude Code отправляет его вместо встроенного заголовка с тем же именем, сопоставляя имена без учета регистра.316Claude Code также отправляет любые заголовки из `ANTHROPIC_CUSTOM_HEADERS`. Когда пользовательский заголовок имеет непустое значение, Claude Code отправляет его вместо встроенного заголовка с тем же именем, сопоставляя имена без учета регистра.

managed-settings.md +8 −2

Details

199 199

200Ключи [входа в шлюз](#choose-a-delivery-mechanism) следуют отдельному правилу. Claude Code никогда не читает их из параметров, управляемых сервером, поэтому пока параметры, управляемые сервером, являются выбранным источником, источник администратора на машине с наивысшим рейтингом, который несёт ключ политики, всё ещё их предоставляет. Значение в источнике администратора, ранжированном ниже этого, или в реестре HKCU, игнорируется.200Ключи [входа в шлюз](#choose-a-delivery-mechanism) следуют отдельному правилу. Claude Code никогда не читает их из параметров, управляемых сервером, поэтому пока параметры, управляемые сервером, являются выбранным источником, источник администратора на машине с наивысшим рейтингом, который несёт ключ политики, всё ещё их предоставляет. Значение в источнике администратора, ранжированном ниже этого, или в реестре HKCU, игнорируется.

201 201

202[`allowedProviders`](/docs/ru/settings-reference#allowedproviders) имеет своё собственное правило: примечание Scope его записи говорит, как список, установленный на машине, объединяется с управляемым сервером. Требует Claude Code v2.1.285 или позже.

203

202Когда источник администратора устанавливает `allowManagedMcpServersOnly` или список `allowedMcpServers` и это значение не является тем, которое действует, `/status` и `claude doctor` называют этот источник и ключ.204Когда источник администратора устанавливает `allowManagedMcpServersOnly` или список `allowedMcpServers` и это значение не является тем, которое действует, `/status` и `claude doctor` называют этот источник и ключ.

203 205

204<h3 id="compose-every-managed-source">206<h3 id="compose-every-managed-source">

353* Пустой файл управляемых параметров считается `{}`.355* Пустой файл управляемых параметров считается `{}`.

354* Неправильное значение в доступном для записи ключе реестра HKCU никогда не блокирует запуск. Claude Code сообщает об этом как уведомление в `/status` и `claude doctor` вместо этого.356* Неправильное значение в доступном для записи ключе реестра HKCU никогда не блокирует запуск. Claude Code сообщает об этом как уведомление в `/status` и `claude doctor` вместо этого.

355 357

356Если файл управляемых параметров, файл drop-in или каталог `managed-settings.d/` не могут быть прочитаны и ни один источник администратора не предоставляет политику, сеансы, вошедшие с учетными данными claude.ai или Claude Console, выходят при запуске с сообщением о необходимости связаться с администратором.358Когда файл управляемых параметров, файл drop-in, каталог `managed-settings.d/`, профиль MDM или значение реестра HKLM существуют, но не могут быть прочитаны, и ни один источник администратора не предоставляет политику, что происходит, зависит от причины сбоя чтения:

359

360* Если операционная система отказала в чтении, например на файле только для root, каждый сеанс запускается без политик этого источника. `/status` и `claude doctor` записывают сбой, и запуск с `-p` также выводит его в stderr.

361* Для любого другого сбоя чтения, такого как ошибка ввода-вывода, каждый сеанс выходит при запуске с [сообщением о необходимости связаться с администратором](/docs/ru/errors#unable-to-read-managed-policy-settings).

357 362

358Чтобы найти отброшенную запись, посмотрите в одном из трех мест:363Чтобы найти отброшенную запись, посмотрите в одном из трех мест:

359 364

387| Поле | Поведение при наличии, но неправильном |392| Поле | Поведение при наличии, но неправильном |

388| :- | :- |393| :- | :- |

389| `allowedMcpServers` | Применяется как пустой список разрешений до исправления значения, поэтому ни один MCP-сервер, который добавляют пользователи, не допускается. Серверы, которые ваша организация доставляет через [`managedMcpServers`](/docs/ru/settings-reference#managedmcpservers), все еще загружаются, и серверы `managed-mcp.json` загружаются в соответствии с [Как сервер оценивается](/docs/ru/managed-mcp#how-a-server-is-evaluated). Неправильная отдельная запись удаляется и применяется допустимое подмножество. |394| `allowedMcpServers` | Применяется как пустой список разрешений до исправления значения, поэтому ни один MCP-сервер, который добавляют пользователи, не допускается. Серверы, которые ваша организация доставляет через [`managedMcpServers`](/docs/ru/settings-reference#managedmcpservers), все еще загружаются, и серверы `managed-mcp.json` загружаются в соответствии с [Как сервер оценивается](/docs/ru/managed-mcp#how-a-server-is-evaluated). Неправильная отдельная запись удаляется и применяется допустимое подмножество. |

395| [`allowedProviders`](/docs/ru/settings-reference#allowedproviders) | Применяется как пустой список разрешений до исправления значения, поэтому каждый поставщик API отказывается и Claude Code не запускается на машине. Если только отдельная запись не является известным именем поставщика, Claude Code отбрасывает и сообщает эту запись и применяет остальное. |

390| `allowedHttpHookUrls` | Claude Code применяет пустой управляемый [список разрешений](/docs/ru/settings-reference#allowedhttphookurls) до исправления значения, поэтому HTTP hook работает только если другой файл параметров перечисляет его URL. Если неправильна только отдельная запись, Claude Code удаляет эту запись и применяет остальное. |396| `allowedHttpHookUrls` | Claude Code применяет пустой управляемый [список разрешений](/docs/ru/settings-reference#allowedhttphookurls) до исправления значения, поэтому HTTP hook работает только если другой файл параметров перечисляет его URL. Если неправильна только отдельная запись, Claude Code удаляет эту запись и применяет остальное. |

391| `httpHookAllowedEnvVars` | Claude Code применяет пустой управляемый [список разрешений](/docs/ru/settings-reference#httphookallowedenvvars) до исправления значения, поэтому переменная заголовка интерполируется только если другой файл параметров ее называет. Если неправильна только отдельная запись, Claude Code удаляет эту запись и применяет остальное. |397| `httpHookAllowedEnvVars` | Claude Code применяет пустой управляемый [список разрешений](/docs/ru/settings-reference#httphookallowedenvvars) до исправления значения, поэтому переменная заголовка интерполируется только если другой файл параметров ее называет. Если неправильна только отдельная запись, Claude Code удаляет эту запись и применяет остальное. |

392| `allowedChannelPlugins` | Claude Code применяет пустой список разрешений до исправления значения, поэтому ни один плагин канала, переданный в `--channels`, не допускается. Если неправильна только отдельная запись, он удаляет эту запись и применяет остальное. |398| `allowedChannelPlugins` | Claude Code применяет пустой список разрешений до исправления значения, поэтому ни один плагин канала, переданный в `--channels`, не допускается. Если неправильна только отдельная запись, он удаляет эту запись и применяет остальное. |

437 443

438Большинство из них — это блокировки: значение, которое блокировка управляет, такое как правила разрешения или `sandbox.network.allowedDomains`, — это обычный ключ, который может установить любой уровень, и блокировка говорит Claude Code чтить только управляемое значение.444Большинство из них — это блокировки: значение, которое блокировка управляет, такое как правила разрешения или `sandbox.network.allowedDomains`, — это обычный ключ, который может установить любой уровень, и блокировка говорит Claude Code чтить только управляемое значение.

439 445

440Таблица охватывает элементы управления разрешением, плагином и доставкой. Для любого ключа, не указанного здесь, столбец Scope [справочника параметров](/docs/ru/settings-reference#all-settings) говорит, является ли он только управляемым; оставшиеся ключи только управляемые там включают URL входа шлюза, версию, браузер, мобильный симулятор, хост SSH, локальный сеанс Desktop, путь двоичного файла песочницы, ценообразование модели, ограничение модели и элементы управления CLAUDE.md.446Таблица охватывает элементы управления разрешением, плагином и доставкой. Для любого ключа, не указанного здесь, столбец Scope [справочника параметров](/docs/ru/settings-reference#all-settings) говорит, является ли он только управляемым.

441 447

442| Параметр | Описание |448| Параметр | Описание |

443| :- | :- |449| :- | :- |

mcp.md +6 −6

Details

273 273

274* ``⏸ Pending approval (run `claude` to approve)``: сервер с областью проекта из `.mcp.json`, который вы ещё не одобрили. Claude Code показывает его как в `claude mcp list`, так и в `claude mcp get <name>`. Запустите `claude` интерактивно, чтобы просмотреть и одобрить его.274* ``⏸ Pending approval (run `claude` to approve)``: сервер с областью проекта из `.mcp.json`, который вы ещё не одобрили. Claude Code показывает его как в `claude mcp list`, так и в `claude mcp get <name>`. Запустите `claude` интерактивно, чтобы просмотреть и одобрить его.

275* `✘ Rejected (see disabledMcpjsonServers in settings)`: сервер `.mcp.json`, который запись [`disabledMcpjsonServers`](/docs/ru/settings-reference#disabledmcpjsonservers) отклоняет. Claude Code показывает его только в `claude mcp get <name>`.275* `✘ Rejected (see disabledMcpjsonServers in settings)`: сервер `.mcp.json`, который запись [`disabledMcpjsonServers`](/docs/ru/settings-reference#disabledmcpjsonservers) отклоняет. Claude Code показывает его только в `claude mcp get <name>`.

276* `⊘ Disabled for this project (re-enable via /mcp)`: сервер, который список [`disabledMcpServers`](#disable-a-server-without-removing-it) проекта называет. Claude Code показывает его как в `claude mcp list`, так и в `claude mcp get <name>`. Включите сервер обратно из панели `/mcp`. До версии v2.1.238 обе команды подключались к отключённому серверу для проверки здоровья и сообщали результат подключения.276* `⊘ Disabled for this project (re-enable via /mcp)`: сервер, который список [`disabledMcpServers`](#disable-a-server-without-removing-it) проекта называет. Claude Code показывает его как в `claude mcp list`, так и в `claude mcp get <name>`. Включите сервер обратно из панели `/mcp`.

277 277

278WebSocket серверы не появляются в выводе `claude mcp list`. Используйте `claude mcp get <name>` или панель `/mcp` для их проверки.278WebSocket серверы не появляются в выводе `claude mcp list`. Используйте `claude mcp get <name>` или панель `/mcp` для их проверки.

279 279

289* управляемые параметры289* управляемые параметры

290* параметры, переданные с `--settings`290* параметры, переданные с `--settings`

291 291

292Claude Code также применяет одобрения из отслеживаемого `.claude/settings.local.json`, но он запускает git для проверки, отслеживается ли файл, и запускает эту проверку только в [доверенной папке](/docs/ru/permissions#project-allow-rules-and-workspace-trust). В папке, которую вы никогда не доверяли, Claude Code ждёт диалога доверия перед применением одобрений файла, если только папка не является вашей конфигурационной домашней директорией: вашей домашней директорией или директорией, чей `.claude` вы установили как [`CLAUDE_CONFIG_DIR`](/docs/ru/env-vars). До версии v2.1.207 Claude Code применял одобрения из отслеживаемого `.claude/settings.local.json` даже в папке, которую вы никогда не доверяли.292Claude Code также применяет одобрения из неотслеживаемого `.claude/settings.local.json`, но он запускает git для проверки, отслеживается ли файл, и запускает эту проверку только в [доверенной папке](/docs/ru/permissions#project-allow-rules-and-workspace-trust). В папке, которую вы никогда не доверяли, Claude Code ждёт диалога доверия перед применением одобрений файла, если только папка не является вашей конфигурационной домашней директорией: вашей домашней директорией или директорией, чей `.claude` вы установили как [`CLAUDE_CONFIG_DIR`](/docs/ru/env-vars). До версии v2.1.207 Claude Code применял одобрения из неотслеживаемого `.claude/settings.local.json` даже в папке, которую вы никогда не доверяли.

293 293

294Запись `disabledMcpjsonServers` в любом файле параметров по-прежнему отклоняет сервер.294Запись `disabledMcpjsonServers` в любом файле параметров по-прежнему отклоняет сервер.

295 295

321 321

322* **Скрытое пробельное пространство**: Claude Code предупреждает, когда значение конфигурации MCP несёт скрытое ведущее или конечное пробельное пространство, которое часто происходит из вставки токена с конечным переводом строки. Claude Code проверяет `command`, `url`, каждую запись `args` и значения и имена ключей под `env` и `headers`. Claude Code показывает предупреждение в выводе `claude mcp list` и в `/mcp`, называя затронутые поля без повторения их значений, например `Leading or trailing whitespace in: headers.Authorization`. Claude Code не обрезает пробельное пространство и использует значения точно так, как написано, поэтому отредактируйте конфигурацию, чтобы удалить его.322* **Скрытое пробельное пространство**: Claude Code предупреждает, когда значение конфигурации MCP несёт скрытое ведущее или конечное пробельное пространство, которое часто происходит из вставки токена с конечным переводом строки. Claude Code проверяет `command`, `url`, каждую запись `args` и значения и имена ключей под `env` и `headers`. Claude Code показывает предупреждение в выводе `claude mcp list` и в `/mcp`, называя затронутые поля без повторения их значений, например `Leading or trailing whitespace in: headers.Authorization`. Claude Code не обрезает пробельное пространство и использует значения точно так, как написано, поэтому отредактируйте конфигурацию, чтобы удалить его.

323* **Одно имя в более чем одной области**: если вы определяете одно имя сервера в более чем одной [области](#mcp-installation-scopes) с разными конечными точками, Claude Code предупреждает о конфликте в выводе `claude mcp list` и в `/mcp`. Claude Code хранит входы OAuth для каждой конечной точки, поэтому когда вы аутентифицируете определение, которое загружается в одном проекте, вам по-прежнему нужно отдельно войти в проект, где загружается другое определение. Сохраните конечную точку, которую вы хотите, и удалите остальные с помощью `claude mcp remove <name> --scope <scope>`. В предупреждении Claude Code цитирует конечную точку каждой области, как написано в вашей конфигурации, с [ссылками `${VAR}`](#environment-variable-expansion-in-mcp-json) не развёрнутыми, поэтому она никогда не показывает разрешённое значение, такое как ключ API.323* **Одно имя в более чем одной области**: если вы определяете одно имя сервера в более чем одной [области](#mcp-installation-scopes) с разными конечными точками, Claude Code предупреждает о конфликте в выводе `claude mcp list` и в `/mcp`. Claude Code хранит входы OAuth для каждой конечной точки, поэтому когда вы аутентифицируете определение, которое загружается в одном проекте, вам по-прежнему нужно отдельно войти в проект, где загружается другое определение. Сохраните конечную точку, которую вы хотите, и удалите остальные с помощью `claude mcp remove <name> --scope <scope>`. В предупреждении Claude Code цитирует конечную точку каждой области, как написано в вашей конфигурации, с [ссылками `${VAR}`](#environment-variable-expansion-in-mcp-json) не развёрнутыми, поэтому она никогда не показывает разрешённое значение, такое как ключ API.

324* **Зарезервированные имена**: Claude Code резервирует имена своих встроенных серверов, включая `workspace`, `claude-in-chrome`, `computer-use`, `Claude Preview` и `Claude Browser`. Если ваша конфигурация определяет сервер с зарезервированным именем, Claude Code пропускает его при загрузке и показывает предупреждение, прося вас переименовать его. `claude mcp add` отклоняет зарезервированное имя с ошибкой. `Claude Preview` и `Claude Browser` оба называют встроенный сервер, который использует [панель предпросмотра настольного приложения Claude Code](/docs/ru/desktop#preview-your-app). До версии v2.1.205 `Claude Browser` не был зарезервирован, поэтому пользовательский сервер мог зарегистрироваться под этим именем.324* **Зарезервированные имена**: Claude Code резервирует имена своих встроенных серверов, включая `workspace`, `claude-in-chrome`, `computer-use`, `Claude Preview` и `Claude Browser`. Если ваша конфигурация определяет сервер с зарезервированным именем, Claude Code пропускает его при загрузке и показывает предупреждение, прося вас переименовать его. `claude mcp add` отклоняет зарезервированное имя с ошибкой. `Claude Preview` и `Claude Browser` оба называют встроенный сервер, который использует [панель предпросмотра настольного приложения Claude Code](/docs/ru/desktop#preview-your-app).

325* **Отсутствующая переменная окружения**: если ссылка [`${VAR}`](#environment-variable-expansion-in-mcp-json) в конфигурации сервера называет переменную, которая не установлена и не имеет `:-default`, Claude Code предупреждает в выводе `claude mcp list` и в `/mcp`, называя переменную, и по-прежнему загружает сервер с текстом `${VAR}` не развёрнутым. Установите переменную или добавьте резервный вариант `${VAR:-default}`. В `url` и `headers` удалённого сервера некоторые переменные учётных данных [читаются как пустые](#credential-variables-that-read-as-empty) вместо этого, без предупреждения.325* **Отсутствующая переменная окружения**: если ссылка [`${VAR}`](#environment-variable-expansion-in-mcp-json) в конфигурации сервера называет переменную, которая не установлена и не имеет `:-default`, Claude Code предупреждает в выводе `claude mcp list` и в `/mcp`, называя переменную, и по-прежнему загружает сервер с текстом `${VAR}` не развёрнутым. Установите переменную или добавьте резервный вариант `${VAR:-default}`. В `url` и `headers` удалённого сервера некоторые переменные учётных данных [читаются как пустые](#credential-variables-that-read-as-empty) вместо этого, без предупреждения.

326 326

327<h4 id="tool-availability">327<h4 id="tool-availability">

417 Неудачные первые подключения417 Неудачные первые подключения

418</h4>418</h4>

419 419

420Когда первое подключение HTTP или SSE сервера не удаётся с переходной ошибкой, такой как ответ 5xx, отказ в соединении или тайм-аут, Claude Code повторяет попытку до трёх раз. Если подключение по-прежнему не удаётся, Claude Code отмечает сервер как неудачный. Claude Code повторяет попытку таким образом при запуске и когда сервер добавляется во время сеанса. Это включает сервер, который Claude Code добавляет в [облачный сеанс](/docs/ru/claude-code-on-the-web) из его конфигурации, и сервер, который вы добавляете с помощью метода [`setMcpServers()`](/docs/ru/agent-sdk/typescript) Agent SDK.420Когда первое подключение HTTP или SSE сервера не удаётся с переходной ошибкой, такой как ответ 5xx, отказ в соединении или тайм-аут, Claude Code повторяет попытку до трёх раз. Если подключение по-прежнему не удаётся, Claude Code отмечает сервер как неудачный.

421 421

422Claude Code не повторяет попытку в этих случаях:422Claude Code не повторяет попытку в этих случаях:

423 423

551 551

552Серверы плагинов появляются в `/mcp` с индикаторами, показывающими, что они поступают из плагинов.552Серверы плагинов появляются в `/mcp` с индикаторами, показывающими, что они поступают из плагинов.

553 553

554Для stdio сервера плагина `claude mcp get` выводит `Command: stdio`, пустую строку `Args:` и каждую переменную окружения как `NAME=[REDACTED]`. Значения скрыты, потому что они могут нести учётные данные.

555

554**Имена инструментов MCP плагинов**:556**Имена инструментов MCP плагинов**:

555 557

556Инструменты с сервера MCP, объединённого с плагином, включают как имя плагина, так и ключ сервера в их вызываемое имя. Полная форма — `mcp__plugin_<plugin-name>_<server-name>__<tool-name>`, где любой символ вне `A-Z`, `a-z`, `0-9`, `_` и `-` заменяется на `_`. Для сервера `database-tools`, объединённого в плагин с именем `my-plugin`, инструмент `query` вызывается как:558Инструменты с сервера MCP, объединённого с плагином, включают как имя плагина, так и ключ сервера в их вызываемое имя. Полная форма — `mcp__plugin_<plugin-name>_<server-name>__<tool-name>`, где любой символ вне `A-Z`, `a-z`, `0-9`, `_` и `-` заменяется на `_`. Для сервера `database-tools`, объединённого в плагин с именем `my-plugin`, инструмент `query` вызывается как:

1456* Имена свойств верхнего уровня должны быть длиной от 1 до 64 символов и использовать только буквы и цифры ASCII, `_`, `.` и `-`1458* Имена свойств верхнего уровня должны быть длиной от 1 до 64 символов и использовать только буквы и цифры ASCII, `_`, `.` и `-`

1457* Схема должна быть действительной в соответствии с метасхемой JSON Schema draft 2020-12. Claude Code применяет эту проверку к схемам, которые не объявляют `$schema`, и к схемам, которые объявляют draft 2020-12. Схема, которая объявляет любой другой диалект, пропускает эту проверку, хотя проверка имен свойств выше все еще применяется1459* Схема должна быть действительной в соответствии с метасхемой JSON Schema draft 2020-12. Claude Code применяет эту проверку к схемам, которые не объявляют `$schema`, и к схемам, которые объявляют draft 2020-12. Схема, которая объявляет любой другой диалект, пропускает эту проверку, хотя проверка имен свойств выше все еще применяется

1458 1460

1459Claude Code запускает проверки после [переписывания комбинатора корневого уровня](#tool-input-schemas-with-a-root-level-combinator), на схеме, которую он фактически отправит.

~~1460~~

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

1462 1462

1463Claude Code включает исключение через флаг функции, который он получает от Anthropic. На [развертывании, где получение флагов отключено](/docs/ru/env-vars#features-that-need-feature-flag-fetching), или на машине, флаги которой никогда не поступали, например на изолированной машине, Claude Code все еще запускает проверки и записывает в журнал сервера, какой инструмент будет отклонен, но отправляет схему инструмента в API в любом случае. API отклоняет запрос, который включает эту схему с [ошибкой 400, называющей инструмент по его позиции](/docs/ru/errors#tool-input-schema-is-invalid). До версии 2.1.216 ни одно развертывание не запускало эти проверки.1463Claude Code включает исключение через флаг функции, который он получает от Anthropic. На [развертывании, где получение флагов отключено](/docs/ru/env-vars#features-that-need-feature-flag-fetching), или на машине, флаги которой никогда не поступали, например на изолированной машине, Claude Code все еще запускает проверки и записывает в журнал сервера, какой инструмент будет отклонен, но отправляет схему инструмента в API в любом случае. API отклоняет запрос, который включает эту схему с [ошибкой 400, называющей инструмент по его позиции](/docs/ru/errors#tool-input-schema-is-invalid). До версии 2.1.216 ни одно развертывание не запускало эти проверки.

mcp-quickstart.md +4 −2

Details

360 360

361 То, что происходит дальше, говорит вам, где находится проблема:361 То, что происходит дальше, говорит вам, где находится проблема:

362 362

363 * Команда запускается и ждёт ввода: сам сервер работает. Запустите `claude mcp get <name>` и подтвердите, что команда, показанная там, совпадает с тем, что вы только что запустили. Если показанная команда отличается от того, что вы набрали, вы, вероятно, пропустили разделитель `--` перед командой сервера. Удалите сервер и повторно добавьте его с `--` на месте. Если вы написали `.mcp.json` вручную, проверьте его синтаксис и местоположение.363 * Команда запускается и ждёт ввода: сам сервер работает.

364 * Команда выдаёт ошибку: сообщение называет то, что отсутствует, например Node.js или браузер.364

365 Запустите `claude mcp get <name>` и подтвердите, что команда, показанная там, совпадает с тем, что вы только что запустили. Если показанная команда отличается от того, что вы набрали, вы, вероятно, пропустили разделитель `--` перед командой сервера. Удалите сервер и повторно добавьте его с `--` на месте. Если вы написали `.mcp.json` вручную, проверьте его синтаксис и местоположение. До версии 2.1.285 `claude mcp get` не печатал строку `Command` для записи stdio, сохранённой без поля `type`, такой как запись `.mcp.json`, написанная вручную. На этих версиях запустите `claude mcp list` вместо этого, который печатает командную строку в любом случае.

366 * Команда выдаёт ошибку: сообщение называет то, что отсутствует, такое как Node.js или браузер.

365 </Accordion>367 </Accordion>

366 368

367 <Accordion title="Connection timed out at startup">369 <Accordion title="Connection timed out at startup">

model-config.md +12 −7

Details

39| **`sonnet`** | Использует последнюю модель Sonnet для ежедневных задач кодирования |39| **`sonnet`** | Использует последнюю модель Sonnet для ежедневных задач кодирования |

40| **`opus`** | Использует последнюю модель Opus для сложных задач рассуждения |40| **`opus`** | Использует последнюю модель Opus для сложных задач рассуждения |

41| **`haiku`** | Использует быструю и эффективную модель Haiku для простых задач |41| **`haiku`** | Использует быструю и эффективную модель Haiku для простых задач |

42| **`sonnet[1m]`** | Использует Sonnet с [контекстным окном в 1 миллион токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) для длительных сеансов. Не имеет эффекта, когда `sonnet` уже разрешается на Sonnet 5.5 или Sonnet 5 с их встроенным окном 1M; за [шлюзом LLM](/docs/ru/llm-gateway) выбирает окно 1M для этой модели |42| **`sonnet[1m]`** | Использует Sonnet с [контекстным окном в 1 миллион токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) для длительных сеансов. Не имеет эффекта, когда `sonnet` уже разрешается на Sonnet 5.5 или Sonnet 5 с их встроенным окном 1M |

43| **`opus[1m]`** | Использует Opus с [контекстным окном в 1 миллион токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) для длительных сеансов |43| **`opus[1m]`** | Использует Opus с [контекстным окном в 1 миллион токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) для длительных сеансов |

44| **`opusplan`** | Специальный режим, который использует `opus` во время режима плана, затем переключается на `sonnet` для выполнения |44| **`opusplan`** | Специальный режим, который использует `opus` во время режима плана, затем переключается на `sonnet` для выполнения |

45 45

521 Цепочки резервных моделей521 Цепочки резервных моделей

522</h3>522</h3>

523 523

524Когда основная модель перегружена, недоступна или возвращает другую неповторяемую ошибку сервера, Claude Code может переключиться на резервную модель вместо отказа в запросе. Ошибки аутентификации, выставления счетов, ограничения скорости, размера запроса и транспорта, а также [отказ в соответствии с проверкой политики вашей организации](/docs/ru/errors#automatic-retries), никогда не вызывают переключение; они следуют обычной обработке повторных попыток и ошибок.524Когда основная модель перегружена, недоступна или возвращает другую неповторяемую ошибку сервера, Claude Code может переключиться на резервную модель вместо отказа в запросе. Ошибки аутентификации, выставления счетов, ограничения скорости, размера запроса и транспорта, а также [отказ в соответствии с проверкой политики вашей организации](/docs/ru/errors#automatic-retries), никогда не вызывают переключение; они следуют обычной обработке повторных попыток и ошибок. Он переключается, когда [Amazon Bedrock](/docs/ru/amazon-bedrock#when-a-model-is-disabled-mid-session) или [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai#when-a-model-is-disabled-mid-session) отказывает в модели, которую ваша учетная запись не может вызвать, что Claude Code рассматривает как недоступность модели, а не как ошибку аутентификации.

525 525

526Настройте одну или несколько резервных моделей, и Claude Code попробует их по порядку, показывая уведомление при переключении. Переключение длится только для текущего хода, поэтому ваше следующее сообщение сначала попробует основную модель снова. Claude Code ограничивает цепочки тремя моделями после удаления дубликатов и игнорирует дополнительные записи.526Настройте одну или несколько резервных моделей, и Claude Code попробует их по порядку, показывая уведомление при переключении. Переключение длится только для текущего хода, поэтому ваше следующее сообщение сначала попробует основную модель снова. Claude Code ограничивает цепочки тремя моделями после удаления дубликатов и игнорирует дополнительные записи.

527 527

775 775

776Claude Code проверяет эти требования плана только при прямом подключении к Anthropic API. Если вы указываете `ANTHROPIC_BASE_URL` на [LLM gateway](/docs/ru/llm-gateway#subscriptions-and-gateways) и ваш сохраненный вход claude.ai остается активным учетным данным, Claude Code не проверяет кредиты использования вашего плана. Параметры `[1m]` остаются доступными в `/model`, и шлюз решает, успешен ли запрос. До версии 2.1.229 Claude Code отклонял `/model sonnet[1m]` в этой конфигурации, когда не мог подтвердить кредиты использования на учетной записи.776Claude Code проверяет эти требования плана только при прямом подключении к Anthropic API. Если вы указываете `ANTHROPIC_BASE_URL` на [LLM gateway](/docs/ru/llm-gateway#subscriptions-and-gateways) и ваш сохраненный вход claude.ai остается активным учетным данным, Claude Code не проверяет кредиты использования вашего плана. Параметры `[1m]` остаются доступными в `/model`, и шлюз решает, успешен ли запрос. До версии 2.1.229 Claude Code отклонял `/model sonnet[1m]` в этой конфигурации, когда не мог подтвердить кредиты использования на учетной записи.

777 777

778<span id="context-window-behind-a-gateway" />

779

780Если вы установите `ANTHROPIC_BASE_URL` на [LLM gateway](/docs/ru/llm-gateway) или другой прокси, Claude Code дает каждой модели, которую он распознает, то же окно контекста, которое модель имеет на Anthropic API. Fable 5.1, Fable 5, Sonnet 5 и позже, и Opus 4.7 и позже получают окно 1M без варианта `[1m]` для выбора, и модель, которая достигает 1M только через свой вариант `[1m]`, такая как Opus 4.6, работает на 200K без него. Claude Code не может обнаружить более низкий предел, который шлюз или сервер позади него применяет. Если ваш шлюз отклоняет запросы выше 200K токенов, запустите [`/autocompact 200k`](#set-the-auto-compact-window), чтобы сеансы компактировались на этой границе.

781

778Чтобы отключить контекст 1M, установите `CLAUDE_CODE_DISABLE_1M_CONTEXT=1`. Claude Code удаляет варианты модели 1M из средства выбора модели. На моделях с собственным окном 1M, таких как Sonnet 5 и модели Fable, он также рассматривает модель как имеющую окно контекста 200K:782Чтобы отключить контекст 1M, установите `CLAUDE_CODE_DISABLE_1M_CONTEXT=1`. Claude Code удаляет варианты модели 1M из средства выбора модели. На моделях с собственным окном 1M, таких как Sonnet 5 и модели Fable, он также рассматривает модель как имеющую окно контекста 200K:

779 783

780* С включенным auto-compact сеансы компактируются на границе 200K через [auto-compact](#set-the-auto-compact-window). Установка окна auto-compact выше 200K не снимает удержание, потому что Claude Code ограничивает это окно окном контекста модели.784* С включенным auto-compaction сеансы компактируются на границе 200K через [auto-compaction](#set-the-auto-compact-window). Установка окна auto-compact выше 200K не снимает удержание, потому что Claude Code ограничивает это окно окном контекста модели.

781* С отключенным auto-compact сеансы останавливаются на границе 200K с [ошибкой ограничения контекста](/docs/ru/errors#prompt-is-too-long) вместо компактирования.785* С отключенным auto-compaction сеансы останавливаются на границе 200K с [ошибкой ограничения контекста](/docs/ru/errors#prompt-is-too-long) вместо компактирования.

782 786

783До версии 2.1.223 Claude Code удерживал только сеансы Sonnet 5, Opus 4.8 и Opus 5 на 200K. См. [переменные окружения](/docs/ru/env-vars).787До версии 2.1.223 Claude Code удерживал только сеансы Sonnet 5, Opus 4.8 и Opus 5 на 200K. См. [переменные окружения](/docs/ru/env-vars).

784 788

803 807

804На Anthropic API Sonnet 5.5 и Sonnet 5 всегда работают с окном контекста 1M. Нет варианта 200K, нет суффикса `[1m]` для выбора и нет требуемых кредитов использования ни на одном плане. Сеансы автоматически компактируются перед заполнением окна, примерно на 967K токенов по умолчанию; установите [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/ru/env-vars), чтобы выбрать другой порог.808На Anthropic API Sonnet 5.5 и Sonnet 5 всегда работают с окном контекста 1M. Нет варианта 200K, нет суффикса `[1m]` для выбора и нет требуемых кредитов использования ни на одном плане. Сеансы автоматически компактируются перед заполнением окна, примерно на 967K токенов по умолчанию; установите [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/ru/env-vars), чтобы выбрать другой порог.

805 809

806Две конфигурации бюджетируют окно на 200K вместо этого:810Claude Code дает Sonnet 5.5 и Sonnet 5 то же окно 1M позади [LLM gateway](/docs/ru/llm-gateway) или другого пользовательского `ANTHROPIC_BASE_URL`. Если ваш шлюз применяет более низкий предел, см. [окно контекста позади шлюза](#context-window-behind-a-gateway).

811

812Этот параметр бюджетирует окно на 200K вместо этого:

807 813

808* **LLM gateway**: когда `ANTHROPIC_BASE_URL` указывает на [шлюз](/docs/ru/llm-gateway), Claude Code не может проверить поддержку 1M. Чтобы использовать полное окно, выберите Sonnet 5.5 (1M context) в средстве выбора модели, которое сопоставляется с `sonnet[1m]`, или запустите `/model claude-sonnet-5[1m]` для Sonnet 5.

809* **`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`**: удерживает сеансы на каждой модели с собственным окном 1M на окне 200K; см. [Extended context](#extended-context) для того, как удержание применяется. Полезно для развертываний, которым нужно ограничить контекст.814* **`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`**: удерживает сеансы на каждой модели с собственным окном 1M на окне 200K; см. [Extended context](#extended-context) для того, как удержание применяется. Полезно для развертываний, которым нужно ограничить контекст.

810 815

811<h2 id="context-window-and-auto-compaction">816<h2 id="context-window-and-auto-compaction">

841* [Cloud sessions](/docs/ru/claude-code-on-the-web) выполняют компактирование по мере приближения разговора к пределу модели846* [Cloud sessions](/docs/ru/claude-code-on-the-web) выполняют компактирование по мере приближения разговора к пределу модели

842* Sonnet 4.6 и Opus 4.6 без [extended context](#extended-context) выполняют компактирование на границе 200K, как и Opus 4.8 и более поздние версии при работе с контекстным окном 200K, например на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry847* Sonnet 4.6 и Opus 4.6 без [extended context](#extended-context) выполняют компактирование на границе 200K, как и Opus 4.8 и более поздние версии при работе с контекстным окном 200K, например на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry

843* Когда вы установите [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/ru/env-vars), модели с собственным окном 1M, такие как Sonnet 5 и модели Fable, выполняют компактирование на границе 200K848* Когда вы установите [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/ru/env-vars), модели с собственным окном 1M, такие как Sonnet 5 и модели Fable, выполняют компактирование на границе 200K

844* Модели, работающие с собственным окном 1M, такие как Sonnet 5, модели Fable и Opus 4.7 и более поздние версии на Anthropic API, выполняют компактирование перед заполнением окна, примерно на 967K токенов по умолчанию. На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry раздел [Pin models for third-party deployments](#pin-models-for-third-party-deployments) указывает, какие модели работают с этим окном; для конфигураций, которые бюджетируют Sonnet 5.5 и Sonnet 5 на 200K, см. [Sonnet 5.5 and Sonnet 5 context window](#sonnet-5-5-and-sonnet-5-context-window)849* Модели, работающие с собственным окном 1M, выполняют компактирование перед заполнением окна, примерно на 967K токенов по умолчанию. На Anthropic API это включает Sonnet 5, модели Fable и Opus 4.7 и более поздние версии. На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry см. [Pin models for third-party deployments](#pin-models-for-third-party-deployments), чтобы узнать, какие модели работают с этим окном. За пользовательским `ANTHROPIC_BASE_URL` см. [the context window behind a gateway](#context-window-behind-a-gateway)

845* Сеансы на ID модели, которую Claude Code не распознаёт, такие как псевдоним [LLM gateway](/docs/ru/llm-gateway), выполняют компактирование при контекстном окне, которое Claude Code предполагает для ID; см. [Correct the window for a gateway or custom model ID](#correct-the-window-for-a-gateway-or-custom-model-id)850* Сеансы на ID модели, которую Claude Code не распознаёт, такие как псевдоним [LLM gateway](/docs/ru/llm-gateway), выполняют компактирование при контекстном окне, которое Claude Code предполагает для ID; см. [Correct the window for a gateway or custom model ID](#correct-the-window-for-a-gateway-or-custom-model-id)

846 851

847<h3 id="correct-the-window-for-a-gateway-or-custom-model-id">852<h3 id="correct-the-window-for-a-gateway-or-custom-model-id">

monitoring-usage.md +2 −0

Details

1430* `error.type`: почему Claude Code остановил сеанс. Присутствует только на событиях `refused`:1430* `error.type`: почему Claude Code остановил сеанс. Присутствует только на событиях `refused`:

1431 * `"helper_failed"`: [запуск помощника политики не удался](/docs/ru/settings-reference#helper-failures)1431 * `"helper_failed"`: [запуск помощника политики не удался](/docs/ru/settings-reference#helper-failures)

1432 * `"policy_invalid"`: управляемые параметры содержат ошибку, которая останавливает Claude Code от запуска, или источник администратора не смог загрузиться, поэтому Claude Code не может проверить принудительный вход организации1432 * `"policy_invalid"`: управляемые параметры содержат ошибку, которая останавливает Claude Code от запуска, или источник администратора не смог загрузиться, поэтому Claude Code не может проверить принудительный вход организации

1433 *

1434 * `"provider_not_allowed"`: сеанс будет использовать поставщика API или отправлять трафик поставщика на хост, который управляемый список [`allowedProviders`](/docs/ru/settings-reference#allowedproviders) не разрешает. Требуется Claude Code v2.1.285 или позже

1433 * `"consent_rejected"`: пользователь отклонил [диалог одобрения безопасности](/docs/ru/server-managed-settings#security-approval-dialogs) для параметров, управляемых сервером1435 * `"consent_rejected"`: пользователь отклонил [диалог одобрения безопасности](/docs/ru/server-managed-settings#security-approval-dialogs) для параметров, управляемых сервером

1434 * `"force_refresh_failed"`: выборка параметров, которую требует [`forceRemoteSettingsRefresh`](/docs/ru/settings-reference#forceremotesettingsrefresh), не удалась1436 * `"force_refresh_failed"`: выборка параметров, которую требует [`forceRemoteSettingsRefresh`](/docs/ru/settings-reference#forceremotesettingsrefresh), не удалась

1435 * `"gateway_rejected"`: [шлюз приложений Claude](/docs/ru/claude-apps-gateway) ответил на загрузку управляемых параметров с HTTP 4031437 * `"gateway_rejected"`: [шлюз приложений Claude](/docs/ru/claude-apps-gateway) ответил на загрузку управляемых параметров с HTTP 403

network-config.md +1 −1

Details

247| `registry.npmjs.org` | Установки плагинов (получение пакетов плагинов из источника npm и установка зависимостей пакетов Node.js плагинов), MCP-серверы, запущенные через `npx`, и реестр пакетов для установок npm и bun самого Claude Code |247| `registry.npmjs.org` | Установки плагинов (получение пакетов плагинов из источника npm и установка зависимостей пакетов Node.js плагинов), MCP-серверы, запущенные через `npx`, и реестр пакетов для установок npm и bun самого Claude Code |

249| `*.frame.claudeusercontent.com` | [Artifact](/docs/ru/artifacts) чтение содержимого. CLI получает файлы артефакта с этого хоста, когда Claude открывает его, и только когда инструмент Artifact [доступен](/docs/ru/artifacts#availability) для вашей учетной записи. Чтобы отключить инструмент и удалить это требование, установите [`"enableArtifact": false`](/docs/ru/settings-reference#enableartifact) или [`CLAUDE_CODE_DISABLE_ARTIFACT=1`](/docs/ru/env-vars); Claude Code также соблюдает устаревший параметр [`disableArtifact`](/docs/ru/settings-reference#disableartifact). См. [Disable artifacts](/docs/ru/artifacts#disable-artifacts) для того, как эти параметры взаимодействуют |249| `*.frame.claudeusercontent.com` | [Artifact](/docs/ru/artifacts) чтение содержимого. CLI получает файлы артефакта с этого хоста, когда Claude открывает его, и только когда инструмент Artifact [доступен](/docs/ru/artifacts#availability) для вашей учетной записи. Чтобы отключить инструмент и удалить это требование, установите [`"enableArtifact": false`](/docs/ru/settings-reference#enableartifact) или [`CLAUDE_CODE_DISABLE_ARTIFACT=1`](/docs/ru/env-vars) |

250| `github.com` | Клонирование размещенных на GitHub [plugin marketplaces](/docs/ru/plugins/overview) и плагинов, включая официальный рынок Anthropic, через HTTPS или SSH. Чтобы клонировать источники GitHub `owner/repo` только через HTTPS, установите [`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1`](/docs/ru/env-vars) |250| `github.com` | Клонирование размещенных на GitHub [plugin marketplaces](/docs/ru/plugins/overview) и плагинов, включая официальный рынок Anthropic, через HTTPS или SSH. Чтобы клонировать источники GitHub `owner/repo` только через HTTPS, установите [`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1`](/docs/ru/env-vars) |

251| `raw.githubusercontent.com` | Лента изменений для [`/release-notes`](/docs/ru/commands). В интерактивных сеансах Claude Code также получает ее в фоновом режиме при запуске, когда его кэшированная лента изменений еще не охватывает запущенную версию, например при первом запуске после обновления; неинтерактивные и облачные сеансы никогда не получают ее |251| `raw.githubusercontent.com` | Лента изменений для [`/release-notes`](/docs/ru/commands). В интерактивных сеансах Claude Code также получает ее в фоновом режиме при запуске, когда его кэшированная лента изменений еще не охватывает запущенную версию, например при первом запуске после обновления; неинтерактивные и облачные сеансы никогда не получают ее |

252| `*-review.googlesource.com` | Поиск изменений Gerrit на checkouts `googlesource.com`. Когда сеанс вкладки Claude Desktop Code запускается или возобновляется на [доверенном](/docs/ru/permissions#project-allow-rules-and-workspace-trust) checkout, чей `origin` является хостом `googlesource.com`, Claude Code анонимно запрашивает сервер `-review` этого хоста для открытого изменения, соответствующего `Change-Id` HEAD, один раз за запуск или возобновление. Другие типы сеансов пропускают поиск, и никакой другой хост Gerrit не контактируется. Опционально: отключите с помощью [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ru/env-vars) |252| `*-review.googlesource.com` | Поиск изменений Gerrit на checkouts `googlesource.com`. Когда сеанс вкладки Claude Desktop Code запускается или возобновляется на [доверенном](/docs/ru/permissions#project-allow-rules-and-workspace-trust) checkout, чей `origin` является хостом `googlesource.com`, Claude Code анонимно запрашивает сервер `-review` этого хоста для открытого изменения, соответствующего `Change-Id` HEAD, один раз за запуск или возобновление. Другие типы сеансов пропускают поиск, и никакой другой хост Gerrit не контактируется. Опционально: отключите с помощью [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ru/env-vars) |

permission-modes.md +107 −111

Details

86| Как вы запускаете Claude Code | Встроенный начальный режим разрешений |86| Как вы запускаете Claude Code | Встроенный начальный режим разрешений |

87| :- | :- |87| :- | :- |

88| Любой файл параметров устанавливает `disableAutoMode` на `"disable"` | `default` |88| Любой файл параметров устанавливает `disableAutoMode` на `"disable"` | `default` |

~~89| `claude -p` или [Agent SDK](/docs/ru/agent-sdk/permissions) | `default` |~~89| `claude -p` или [Agent SDK](/docs/ru/agent-sdk/permissions#permission-modes) | `default` в сеансах, которые [получают флаги функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching). В сеансах, которые не получают, таких как на стороннем поставщике или с отключённой телеметрией, `auto` с Claude Code v2.1.285 или позже и `default` на более ранних версиях. Сеанс в организации, политика которой не предоставляет режим `auto`, начинается в `default` вместо этого |

90| В терминале или через [расширение VS Code](/docs/ru/vs-code) | `auto` с Claude Code v2.1.283 или позже; на более ранних версиях `auto` на планах Pro, Max или Team в сеансах, которые [получают флаги функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching), и `default` в противном случае |90| В терминале или через [расширение VS Code](/docs/ru/vs-code) | `auto` с Claude Code v2.1.283 или позже; на более ранних версиях `auto` на планах Pro, Max или Team в сеансах, которые [получают флаги функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching), и `default` в противном случае |

91 91

92В вашем [первом сеансе после установки или обновления](/docs/ru/env-vars#first-session-after-an-install-or-upgrade), Claude Code может выбрать начальный режим разрешений до того, как прибудут его флаги функций. Этот сеанс может начаться в другом режиме разрешений, чем указано в таблице, и ваш следующий сеанс соответствует таблице.92В вашем [первом сеансе после установки или обновления](/docs/ru/env-vars#first-session-after-an-install-or-upgrade), Claude Code может выбрать начальный режим разрешений до того, как прибудут его флаги функций. Этот сеанс может начаться в другом режиме разрешений, чем указано в таблице, и ваш следующий сеанс соответствует таблице.

98* В терминале один раз в верхней части сеанса98* В терминале один раз в верхней части сеанса

99* В расширении VS Code как карточка на экране нового разговора, которая остаётся до тех пор, пока вы её не закроете99* В расширении VS Code как карточка на экране нового разговора, которая остаётся до тех пор, пока вы её не закроете

100 100

101На планах Pro, Max и Team, если ваш `~/.claude/settings.json` устанавливает `defaultMode` отличный от `auto` и ни один другой файл параметров не устанавливает его, ваши сеансы продолжают запускаться в этом режиме. Claude Code спрашивает один раз в терминале или в расширении VS Code, следует ли изменить параметр на режим auto. Если вы отклоните, ваш параметр остаётся как есть.101Если ваш `~/.claude/settings.json` устанавливает `defaultMode` отличный от `auto` и ни один другой файл параметров не устанавливает его, ваши сеансы продолжают запускаться в этом режиме. На планах Pro, Max и Team, а также в сеансах, которые [не получают флаги функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching), Claude Code спрашивает один раз в терминале или в расширении VS Code, следует ли изменить параметр на режим auto. Если вы отклоните, ваш параметр остаётся как есть.

102 102

103<h3 id="start-in-a-different-mode">103<h3 id="start-in-a-different-mode">

104 Начните в другом режиме разрешений104 Начните в другом режиме разрешений

288Чтобы сделать режим plan значением по умолчанию для сеансов терминала проекта, установите `defaultMode` на `plan` в `.claude/settings.json`, размещённый как пример в [Начните в другом режиме разрешений](#start-in-a-different-mode) показывает. Разговоры, которые [расширение VS Code](/docs/ru/vs-code) запускает, не читают параметры проекта для начального режима разрешений. Там установите `claudeCode.initialPermissionMode` на `plan` в параметрах пользователя VS Code вместо этого.288Чтобы сделать режим plan значением по умолчанию для сеансов терминала проекта, установите `defaultMode` на `plan` в `.claude/settings.json`, размещённый как пример в [Начните в другом режиме разрешений](#start-in-a-different-mode) показывает. Разговоры, которые [расширение VS Code](/docs/ru/vs-code) запускает, не читают параметры проекта для начального режима разрешений. Там установите `claudeCode.initialPermissionMode` на `plan` в параметрах пользователя VS Code вместо этого.

289 289

290<h2 id="eliminate-prompts-with-auto-mode">290<h2 id="eliminate-prompts-with-auto-mode">

291 Исключение запросов разрешения с помощью автоматического режима291 Исключите запросы разрешений с помощью автоматического режима

292</h2>292</h2>

293 293

294Автоматический режим позволяет Claude выполнять действия без обычных запросов разрешения. Отдельная модель классификатора проверяет действия перед их выполнением, блокируя все, что выходит за рамки вашего запроса, нацелено на неизвестную инфраструктуру или выглядит как результат враждебного контента, который прочитал Claude. Явные [правила запроса](/docs/ru/permissions#manage-permissions) по-прежнему вызывают запрос.294Автоматический режим позволяет Claude выполнять действия без обычных запросов разрешений. Отдельная модель классификатора проверяет действия перед их выполнением, блокируя все, что выходит за рамки вашего запроса, нацелено на неизвестную инфраструктуру или выглядит как результат враждебного контента, который прочитал Claude. Явные [правила запроса](/docs/ru/permissions#manage-permissions) по-прежнему вызывают запрос.

295 295

296С Claude Code v2.1.283 или более поздней версии автоматический режим является [встроенным начальным режимом разрешений](#which-mode-a-session-starts-in) для интерактивных сеансов терминала и VS Code на каждом плане и поставщике. На более ранних версиях это встроенный начальный режим разрешений только на планах Pro, Max и Team.296С Claude Code v2.1.283 или позже автоматический режим является [встроенным начальным режимом разрешений](#which-mode-a-session-starts-in) для интерактивных сеансов терминала и VS Code на всех планах и провайдерах. В более ранних версиях это встроенный начальный режим разрешений только на планах Pro, Max и Team.

297 297

298Классификатор также проверяет каждое сообщение, которое Claude отправляет другому агенту с помощью [`SendMessage`](/docs/ru/tools-reference), будь то простой текст или структурированное сообщение [команды агентов](/docs/ru/agent-teams), перед тем как Claude Code его доставит, как в автоматическом режиме, так и в [режиме плана, пока классификатор проверяет команды](#analyze-before-you-edit-with-plan-mode); проверка отправки требует Claude Code v2.1.222 или более поздней версии.298Классификатор также проверяет каждое сообщение, которое Claude отправляет другому агенту с помощью [`SendMessage`](/docs/ru/tools-reference), будь то простой текст или структурированное сообщение [команды агентов](/docs/ru/agent-teams), перед тем как Claude Code его доставит, как в автоматическом режиме, так и в [режиме плана, пока классификатор проверяет команды](#analyze-before-you-edit-with-plan-mode); проверка отправки требует Claude Code v2.1.222 или позже.

299 299

300По умолчанию классификатор не проверяет удаления `rm` и `rmdir`, нацеленные на критический путь, такие как `rm -rf /` или `rm -rf ~`. [Критические пути](#critical-paths) охватывает то, что с ними происходит в каждом режиме разрешений.300По умолчанию классификатор не проверяет удаления `rm` и `rmdir`, нацеленные на критический путь, такие как `rm -rf /` или `rm -rf ~`. [Критические пути](#critical-paths) описывает, что с ними происходит в каждом режиме разрешений.

301 301

302Автоматический режим также побуждает Claude продолжать работу без остановки для уточняющих вопросов, хотя Claude по-прежнему спрашивает, когда ваш запрос или навык явно на этом основаны. Для более сильного автономного поведения в режиме, который по-прежнему вас спрашивает, установите [стиль вывода Proactive](/docs/ru/output-styles).302Автоматический режим также побуждает Claude продолжать работу без остановки для уточняющих вопросов, хотя Claude все еще спрашивает, когда ваш запрос или навык явно на это полагаются. Для более сильного автономного поведения в режиме, который все еще вас спрашивает, установите вместо этого [стиль проактивного вывода](/docs/ru/output-styles).

303 303

304<Warning>304<Warning>

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

306</Warning>306</Warning>

307 307

308Автоматический режим доступен только при соблюдении всех следующих требований вашей учетной записи:308Автоматический режим доступен только когда ваша учетная запись соответствует всем этим требованиям:

309 309

310* **План**: Все планы.310* **План**: Все планы.

311* **Организация**: на Team и Enterprise автоматический режим доступен по умолчанию. Администраторы могут отключить его для организации, установив `permissions.disableAutoMode` на `"disable"` в [управляемых параметрах](/docs/ru/managed-settings).311* **Организация**: на Team и Enterprise автоматический режим доступен по умолчанию. Администраторы могут отключить его для организации, установив `permissions.disableAutoMode` на `"disable"` в [управляемых параметрах](/docs/ru/managed-settings).

312* **Модель**: на Anthropic API и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), Claude Opus 4.6 или более поздней версии, Sonnet 4.6 или более поздней версии, или [модель Fable](/docs/ru/model-config#work-with-fable). На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и сеансах [Claude apps gateway](/docs/ru/claude-apps-gateway) с входом, только Claude Sonnet 5 или более поздней версии, Opus 4.7 или более поздней версии и модели Fable. Более старые модели, включая Sonnet 4.5, Opus 4.5, Haiku и модели claude-3, не поддерживаются ни на одном поставщике.312* **Модель**: на Anthropic API и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), Claude Opus 4.6 или позже, Sonnet 4.6 или позже, или [модель Fable](/docs/ru/model-config#work-with-fable). На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и сеансах подписанного [Claude apps gateway](/docs/ru/claude-apps-gateway), только Claude Sonnet 5 или позже, Opus 4.7 или позже и модели Fable. Более старые модели, включая Sonnet 4.5, Opus 4.5, Haiku и модели claude-3, не поддерживаются ни на одном провайдере.

313* **Поставщик**: доступен по умолчанию на Anthropic API, Claude Platform on AWS, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и сеансах Claude apps gateway с входом.313* **Провайдер**: доступен по умолчанию на Anthropic API, Claude Platform on AWS, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и сеансах подписанного Claude apps gateway.

314 314

315Если Claude Code сообщает, что автоматический режим недоступен, сначала проверьте эти требования и не устанавливает ли какой-либо файл параметров [`disableAutoMode`](/docs/ru/settings-reference#disableautomode). Anthropic также может отключить автоматический режим на стороне сервера, или сервер может отклонить автоматический режим для вашей учетной записи. Сеанс, получивший любой из этих ответов, держит автоматический режим отключенным до конца сеанса, поэтому позже начните новый сеанс.315Если Claude Code сообщает, что автоматический режим недоступен, сначала проверьте эти требования и установлены ли в файле параметров [`disableAutoMode`](/docs/ru/settings-reference#disableautomode). Anthropic также может отключить автоматический режим на стороне сервера, или сервер может отклонить автоматический режим для вашей учетной записи. Сеанс, получивший любой из этих ответов, держит автоматический режим отключенным до конца сеанса, поэтому позже начните новый сеанс.

316 316

317Отдельное сообщение, которое называет модель и говорит, что автоматический режим "не может определить безопасность" действия, означает, что запрос классификатора не удался. Этот сбой обычно временный, но на Amazon Bedrock он может повторяться до тех пор, пока ваша учетная запись не сможет вызвать названную модель. Смотрите [справочник ошибок](/docs/ru/errors#auto-mode-cannot-determine-the-safety-of-an-action) для причин и что делать.317Отдельное сообщение, которое называет модель и говорит, что автоматический режим "не может определить безопасность" действия, означает, что запрос классификатора не удался. Этот сбой обычно временный, но на Amazon Bedrock он может повторяться до тех пор, пока ваша учетная запись не сможет вызвать названную модель. Смотрите [справочник ошибок](/docs/ru/errors#auto-mode-cannot-determine-the-safety-of-an-action) для причин и что делать.

318 318

319Если вы установили `defaultMode: "auto"` в [параметрах](/docs/ru/settings-reference#all-settings) и сеанс терминала начинается в режиме Manual без ошибки, параметр, вероятно, находится в `.claude/settings.json` или `.claude/settings.local.json`. `auto` не вступает в силу из этих файлов. Переместите его в `~/.claude/settings.json`. Для разговора, который запустило расширение VS Code, вместо этого проверьте собственный список расширения в [Переключение режимов разрешений](#switch-permission-modes).319Если вы установили `defaultMode: "auto"` в [параметрах](/docs/ru/settings-reference#all-settings) и сеанс терминала начинается в режиме Manual без ошибки, параметр, вероятно, находится в `.claude/settings.json` или `.claude/settings.local.json`. `auto` не вступает в силу из этих файлов. Переместите его в `~/.claude/settings.json`. Для разговора, который расширение VS Code запустило, вместо этого проверьте собственный список расширения в [Переключение режимов разрешений](#switch-permission-modes).

320 320

321<h3 id="enable-auto-mode-on-bedrock-agent-platform-or-foundry">321<h3 id="enable-auto-mode-on-bedrock-agent-platform-or-foundry">

322 Автоматический режим на Bedrock, Agent Platform или Foundry322 Автоматический режим на Bedrock, Agent Platform или Foundry

323</h3>323</h3>

324 324

325На [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai), [Microsoft Foundry](/docs/ru/microsoft-foundry) и сеансах [Claude apps gateway](/docs/ru/claude-apps-gateway) с входом автоматический режим доступен по умолчанию. С Claude Code v2.1.283 или более поздней версии это также [встроенный начальный режим разрешений](#which-mode-a-session-starts-in) для интерактивных сеансов терминала и [VS Code](/docs/ru/vs-code). Чтобы выбрать начальный режим разрешений самостоятельно, установите `permissions.defaultMode` как [Начать в другом режиме разрешений](#start-in-a-different-mode) описывает, или выберите режим разрешений из индикатора режима расширения VS Code.325На [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai), [Microsoft Foundry](/docs/ru/microsoft-foundry) и сеансах подписанного [Claude apps gateway](/docs/ru/claude-apps-gateway), автоматический режим доступен по умолчанию. Когда ничто другое не устанавливает режим разрешений, это также [встроенный начальный режим разрешений](#which-mode-a-session-starts-in), на версиях, которые перечисляет таблица этого раздела. Чтобы выбрать начальный режим разрешений самостоятельно, установите `permissions.defaultMode` как описывает [Начать в другом режиме разрешений](#start-in-a-different-mode), или выберите режим разрешений из индикатора режима расширения VS Code.

326 326

327На этих поставщиках поддерживаются только Claude Sonnet 5 или более поздней версии, Opus 4.7 или более поздней версии и модели Fable. На любой другой модели сеанс начинается в Manual вместо этого.327На этих провайдерах поддерживаются только Claude Sonnet 5 или позже, Opus 4.7 или позже и модели Fable. На любой другой модели сеанс начинается в режиме Manual.

328 328

329Чтобы предотвратить использование автоматического режима разработчиками, установите `disableAutoMode` на `"disable"` в [управляемых параметрах](/docs/ru/managed-settings). Это удаляет `auto` из цикла `Shift+Tab`, и сеанс, запущенный с `--permission-mode auto`, начинается в Manual вместо этого. Сеанс, уже работающий в автоматическом режиме, выходит из него, когда параметр достигает этого сеанса из [источника, развернутого администратором](/docs/ru/managed-settings#which-managed-source-claude-code-uses), и показывает `auto mode disabled by settings`. До v2.1.251 работающий сеанс оставался в автоматическом режиме до конца.329Чтобы предотвратить использование автоматического режима разработчиками, установите `disableAutoMode` на `"disable"` в [управляемых параметрах](/docs/ru/managed-settings). Это удаляет `auto` из цикла `Shift+Tab`, и сеанс, запущенный с `--permission-mode auto`, начинается в режиме Manual. Сеанс, уже работающий в автоматическом режиме, выходит из него, когда параметр достигает этого сеанса из [источника, развернутого администратором](/docs/ru/managed-settings#which-managed-source-claude-code-uses), и показывает `auto mode disabled by settings`. До v2.1.251 работающий сеанс сохранял автоматический режим до конца.

330 330

331В v2.1.158 через v2.1.206 автоматический режим был отключен на этих поставщиках до тех пор, пока вы не установили `CLAUDE_CODE_ENABLE_AUTO_MODE=1`, и Claude Code игнорировал `defaultMode: "auto"` на этих поставщиках, если переменная также не была установлена. Переменная по-прежнему принимается для совместимости и не имеет эффекта с v2.1.207 и далее.331В v2.1.158 через v2.1.206 автоматический режим был отключен на этих провайдерах до тех пор, пока вы не установили `CLAUDE_CODE_ENABLE_AUTO_MODE=1`, и Claude Code игнорировал `defaultMode: "auto"` на этих провайдерах, если переменная также не была установлена. Переменная по-прежнему принимается для совместимости и не имеет эффекта с v2.1.207 и позже.

332 332

333<h3 id="server-side-classifier-review">333<h3 id="server-side-classifier-review">

334 Проверка классификатора на стороне сервера334 Проверка классификатора на стороне сервера

336 336

337В автоматическом режиме Claude Code может попросить сервер проверить действия, которые [порядок решений](#how-the-classifier-evaluates-actions) отправляет на проверку, как часть запросов модели сеанса, вместо отправки собственных запросов классификатора. Эти сеансы спрашивают:337В автоматическом режиме Claude Code может попросить сервер проверить действия, которые [порядок решений](#how-the-classifier-evaluates-actions) отправляет на проверку, как часть запросов модели сеанса, вместо отправки собственных запросов классификатора. Эти сеансы спрашивают:

338 338

339* **Прямое подключение к Anthropic API**: в интерактивном сеансе терминала, на каждом плане claude.ai и на учетных записях, которые используют Claude API, по мере развертывания Anthropic. Требует Claude Code v2.1.271 или более поздней версии на планах Pro, Max и Team, и v2.1.278 или более поздней версии на планах Enterprise и учетных записях Claude API. С v2.1.282 сеанс, который [не получает флаги функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching), например потому что вы отключили телеметрию, спрашивает сервер по умолчанию в любом виде сеанса.339* **Прямое соединение с Anthropic API**: в интерактивном сеансе терминала, на каждом плане claude.ai и на учетных записях, которые используют Claude API, по мере развертывания Anthropic. Требует Claude Code v2.1.271 или позже на планах Pro, Max и Team, и v2.1.278 или позже на планах Enterprise и учетных записях Claude API. С v2.1.282 сеанс, который [не получает флаги функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching), например потому что вы отключили телеметрию, по умолчанию спрашивает сервер в любом виде сеанса.

340* **Облачный поставщик, или LLM gateway или proxy**: на [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, и всякий раз, когда вы указываете `ANTHROPIC_BASE_URL` на [LLM gateway или proxy](/docs/ru/llm-gateway), независимо от вашего плана. Запрос по умолчанию требует Claude Code v2.1.278 или более поздней версии.340* **Облачный провайдер, или шлюз LLM или прокси**: на [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, и всякий раз, когда вы указываете `ANTHROPIC_BASE_URL` на [шлюз LLM или прокси](/docs/ru/llm-gateway), независимо от вашего плана. Запрос по умолчанию требует Claude Code v2.1.278 или позже.

341* **Сеанс [Claude apps gateway](/docs/ru/claude-apps-gateway) с входом**: требует Claude Code v2.1.280 или более поздней версии341* **Сеанс подписанного [Claude apps gateway](/docs/ru/claude-apps-gateway)**: требует Claude Code v2.1.280 или позже

342 342

343Где сервер проверяет действия, его вердикты решают их. Возможны два других результата:343Где сервер проверяет действия, его вердикты решают их. Возможны два других результата:

344 344

345* **Сервер не проверяет сеанс**: ответ завершается без результатов проверки, или сервер отвечает, что он не проверяет этот сеанс. Наиболее частые причины — это LLM gateway или proxy, который блокирует запрос на проверку или результаты, и платформа, регион или учетные данные, которые еще не имеют проверок на стороне сервера. Claude Code возвращается к собственным запросам классификатора. Как только этот откат сохраняется для остальной части сеанса, он показывает [уведомление о расходах на запросы классификатора](/docs/ru/auto-mode-classifier-billing) на учетных записях, где эти запросы выставляются счетом.345* **Сервер не проверяет сеанс**: ответ завершается без результатов проверки, или сервер отвечает, что он не проверяет этот сеанс. Наиболее частые причины — шлюз LLM или прокси, который отбрасывает запрос на проверку или результаты, и платформа, регион или учетные данные, которые еще не имеют проверок на стороне сервера. Claude Code возвращается к собственным запросам классификатора. Как только этот откат сохраняется для остальной части сеанса, он показывает [уведомление о расходах на запросы классификатора](/docs/ru/auto-mode-classifier-billing) на учетных записях, где эти запросы выставляются счетом.

346* **Сервер не дает вердикт для действия**: Claude Code отклоняет действие, а не выполняет его без проверки. На любом подключении это происходит, когда ответ заканчивается до прибытия результатов проверки или результаты прибывают в форме, которую Claude Code не может прочитать. LLM gateway или proxy, который сокращает ответы или переписывает результаты, может вызвать любое из них. На прямом подключении к Anthropic API это также происходит, когда проверка сервера не удается для действия, например истечение времени ожидания. [Сервер не вернул вердикт безопасности](/docs/ru/errors#the-server-returned-no-safety-verdict) охватывает сообщение об отказе, что происходит, когда отказы повторяются, и что делать.346* **Сервер не дает вердикт для действия**: Claude Code отклоняет действие, а не выполняет его без проверки. На любом соединении это происходит, когда ответ заканчивается до прибытия результатов проверки или результаты прибывают в форме, которую Claude Code не может прочитать. Шлюз LLM или прокси, который сокращает ответы или переписывает результаты, может вызвать любое из них. На прямом соединении с Anthropic API это также происходит, когда проверка сервера не удается для действия, например истечение времени ожидания. [Сервер не вернул вердикт безопасности](/docs/ru/errors#the-server-returned-no-safety-verdict) описывает сообщение об отказе, что происходит при повторении отказов и что делать.

347 347

348Чтобы пропустить запрос к серверу и всегда использовать собственные запросы классификатора Claude Code, установите [`CLAUDE_CODE_AUTO_MODE_SERVER=0`](/docs/ru/env-vars). На прямом подключении к Anthropic API переменная требует Claude Code v2.1.281 или более поздней версии. Установка ее на `1` там включает проверку сервера в сеансе, который еще ее не имеет, такой как сеанс `-p` или Agent SDK, если вы также не установили `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`. Если вы установили `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` и оставили `CLAUDE_CODE_AUTO_MODE_SERVER` неустановленным, Claude Code также перестает запрашивать сервер, кроме как [Отключение предварительных возможностей](/docs/ru/llm-gateway-protocol#disable-pre-release-capabilities) описывает.348Чтобы пропустить запрос к серверу и всегда использовать собственные запросы классификатора Claude Code, установите [`CLAUDE_CODE_AUTO_MODE_SERVER=0`](/docs/ru/env-vars). На прямом соединении с Anthropic API переменная требует Claude Code v2.1.281 или позже. Установка ее на `1` там включает проверку сервера в сеансе, который еще не имеет ее, такой как сеанс `-p` или Agent SDK, если вы также не установили `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`. Если вы установили `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` и оставили `CLAUDE_CODE_AUTO_MODE_SERVER` неустановленным, Claude Code также перестает спрашивать сервер, кроме как описывает [Отключить возможности предварительного выпуска](/docs/ru/llm-gateway-protocol#disable-pre-release-capabilities).

349 349

350<h3 id="what-the-classifier-blocks-by-default">350<h3 id="what-the-classifier-blocks-by-default">

351 Что классификатор блокирует по умолчанию351 Что классификатор блокирует по умолчанию

357 357

358* Загрузка и выполнение кода, например `curl | bash`358* Загрузка и выполнение кода, например `curl | bash`

359* Отправка чувствительных данных на внешние конечные точки359* Отправка чувствительных данных на внешние конечные точки

360* Развертывание и миграция в production360* Развертывание и миграция в производство

361* Массовое удаление в облачном хранилище361* Массовое удаление в облачном хранилище

362* Предоставление разрешений IAM или репозитория362* Предоставление разрешений IAM или репозитория

363* Изменение общей инфраструктуры363* Изменение общей инфраструктуры

364* Необратимое уничтожение файлов, которые существовали до сеанса364* Необратимое уничтожение файлов, которые существовали до сеанса

365* Force push365* Принудительная отправка

366* Фиксация или отправка изменения, которое отправило бы секреты или чувствительные данные за пределы репозитория при его запуске, или расширило бы то, что развертывание раскрывает. Это охватывает рабочий процесс CI или конфигурацию развертывания, которая передает секрет на назначение, которое его еще не получает, скрипт или шаг настройки, который читает хранилище секретов и отправляет данные, и изменение конфигурации, которое расширяет то, что развертывание публикует, такое как реестр, видимость, артефакт или параметр sourcemap. Проверка применяется на любой ветке, применяется даже когда репозиторий является общедоступным, и срабатывает при фиксации или отправке изменения, независимо от того, запускает ли эта фиксация или отправка конвейер; очистка требует назвать эффект выполнения, а не только фиксацию или отправку. До v2.1.211 эта проверка была ограничена ветвью по умолчанию: отправка туда была заблокирована, когда она содержала чувствительное содержимое, изменения скрытые или неправильно описанные относительно того, что вы просили, содержимое перенесенное из-за пределов репозитория или направленное вокруг проверки, которую вы просили366* Фиксация или отправка изменения, которое отправит секреты или чувствительные данные за пределы репозитория при его запуске, или расширит то, что развертывание раскрывает. Это охватывает рабочий процесс CI или конфигурацию развертывания, которая передает секрет на назначение, которое его еще не получает, скрипт или шаг настройки, который читает хранилище секретов и отправляет данные, и изменение конфигурации, которое расширяет то, что развертывание публикует, такое как реестр, видимость, артефакт или параметр sourcemap. Проверка применяется на любой ветке, применяется даже когда репозиторий является общедоступным, и срабатывает при фиксации или отправке изменения, независимо от того, запускает ли эта фиксация или отправка конвейер; очистка требует назвать эффект выполнения, а не только фиксацию или отправку. До v2.1.211 эта проверка была ограничена ветвью по умолчанию: отправка туда была заблокирована, когда она содержала чувствительный контент, изменения скрыты или неправильно описаны относительно того, что вы просили, контент перенесен из-за пределов репозитория или направлен вокруг проверки, которую вы просили

367* `git reset --hard`, `git checkout -- .`, `git restore .`, `git clean -fd`, `git stash drop` или `git stash clear`, которые классификатор предполагает отбросили бы незафиксированные изменения367* `git reset --hard`, `git checkout -- .`, `git restore .`, `git clean -fd`, `git stash drop` или `git stash clear`, которые классификатор предполагает отбросят незафиксированные изменения

368* `git commit --amend` когда фиксация в HEAD не была создана в этом сеансе368* `git commit --amend` когда фиксация в HEAD не была создана в этом сеансе

369* С v2.1.198, `git commit --amend` когда фиксация в HEAD уже была отправлена. Переформулировка только сообщения не блокируется: `--amend -m` без ничего вновь поставленного на сцену, на фиксации, которую Claude создал во время этого сеанса369* С v2.1.198 `git commit --amend` когда фиксация в HEAD уже была отправлена. Переформулировка только сообщения не блокируется: `--amend -m` без ничего вновь поставленного на сцену, на фиксации, которую Claude создал во время этого сеанса

370* `terraform destroy`, `pulumi destroy`, `cdk destroy` или `terragrunt destroy`, и применение плана, который уничтожает ресурсы370* `terraform destroy`, `pulumi destroy`, `cdk destroy` или `terragrunt destroy`, и применение плана, который уничтожает ресурсы

~~371~~ 371* Запись в менеджер секретов, или изменение записей DNS или сертификатов TLS

372Claude Code v2.1.195 и более поздние версии блокируют больше категорий по умолчанию. Несколько зависят от записей [окружения](/docs/ru/auto-mode-config#define-trusted-infrastructure), таких как чувствительные удаленные цели и защищенные области IaC, которые вы можете сузить до конкретных имен.372* Объединение запроса на извлечение, который ни один человек не одобрил, одобрение собственного запроса на извлечение Claude или отключение проверок CI

~~373~~

374* Запись в менеджер секретов или изменение записей DNS или сертификатов TLS

375* Слияние pull request, который не одобрил ни один человек, одобрение собственного pull request Claude или отключение проверок CI

376* Размещение комментария, который сам по себе является командой для автоматизации, такой как `atlantis apply` или `/deploy` или `/merge` бота373* Размещение комментария, который сам по себе является командой для автоматизации, такой как `atlantis apply` или `/deploy` или `/merge` бота

377* Переключение, постепенное развертывание или удаление флага функции production374* Переключение, увеличение или удаление флага функции производства

378* Применение изменений инфраструктуры к защищенной области IaC или осушение и удаление узлов кластера375* Применение изменений инфраструктуры к защищенной области IaC, или осушение и удаление узлов кластера

379* Записи в общий вычислительный кластер, которые выходят за пределы названного вами ресурса, такие как селектор меток или `--all`, который захватывает задания других пользователей376* Записи в общий вычислительный кластер, которые выходят за пределы названного вами ресурса, такие как селектор меток или `--all`, который захватывает задания других пользователей

380* Создание ресурсов Kubernetes, которые работают на каждом узле или перехватывают трафик кластера, такие как DaemonSets и admission webhooks377* Создание ресурсов Kubernetes, которые работают на каждом узле или перехватывают трафик кластера, такие как DaemonSets и вебхуки допуска

381* Интерактивные оболочки или port-forwards в чувствительную удаленную цель378* Интерактивные оболочки или переадресация портов в чувствительную удаленную цель

382* Открытие туннеля или обратной оболочки, которая делает локальный сервис доступным из общедоступного интернета379* Открытие туннеля или обратной оболочки, которая делает локальный сервис доступным из общедоступного интернета

383* Вывод живого учетного данного или токена в стенограмму или файл380* Вывод живого учетного данного или токена в стенограмму или файл

384* Доступ к местоположению, указанному как местоположение чувствительных данных в вашем [окружении](/docs/ru/auto-mode-config#define-trusted-infrastructure), или копирование данных из него. Начиная с v2.1.198, это также блокирует отправку данных из одного на аудиторию, которую запись исключает381* Доступ к местоположению, указанному как местоположение чувствительных данных в вашей [среде](/docs/ru/auto-mode-config#define-trusted-infrastructure), или копирование данных из одного. С v2.1.198 это также блокирует отправку данных из одного на аудиторию, которую запись исключает

385* Маршрутизация установки пакета вокруг вашего внутреннего реестра пакетов на общедоступный реестр. Начиная с v2.1.198, это также применяется, когда вы сказали Claude, что внутренний реестр или зеркало существует в разговоре, а не только когда один указан в вашем окружении382* Маршрутизация установки пакета вокруг вашего внутреннего реестра пакетов на общедоступный реестр. С v2.1.198 это также применяется, когда вы сказали Claude, что внутренний реестр или зеркало существует в разговоре, а не только когда один указан в вашей среде

386* Запуск команды с флагом, который отключает защиту безопасности, например `--insecure`383* Запуск команды с флагом, который отключает защиту безопасности, например `--insecure`

387* Запуск цикла автономного агента, который работает без одобрения человека или песочницы, такой как запущенный с `--dangerously-skip-permissions` или `--no-sandbox`. Начиная с v2.1.198, это также охватывает запуск стороннего агента или eval harness с отключенной изоляцией и одобрением для каждого действия, такой как runner, запущенный с `--yes-always`384* Запуск цикла автономного агента, который работает без одобрения человека или песочницы, такой как запущенный с `--dangerously-skip-permissions` или `--no-sandbox`. С v2.1.198 это также охватывает запуск агента третьей стороны или оценочного жгута с отключенной изоляцией и одобрением за действие, такой как бегун, запущенный с `--yes-always`

388* [Claude in Chrome](/docs/ru/chrome) действия браузера, которые могут отправить содержимое страницы, cookies или учетные данные за пределы origin385* [Claude в Chrome](/docs/ru/chrome) действия браузера, которые могут отправить содержимое страницы, файлы cookie или учетные данные за пределы источника

386

387Несколько из этих категорий зависят от записей [среды](/docs/ru/auto-mode-config#define-trusted-infrastructure), таких как чувствительные удаленные цели и защищенные области IaC, которые вы можете сузить до конкретных имен.

389 388

390Claude Code v2.1.198 и более поздние версии также блокируют эти по умолчанию:389Claude Code v2.1.198 и позже также блокируют эти по умолчанию:

391 390

392* Удаление файлов в `/tmp`, `$TMPDIR` или другом общем каталоге scratch или cache по подстановочному знаку, glob или фильтру возраста, а не по конкретному названному пути391* Удаление файлов в `/tmp`, `$TMPDIR` или другом общем каталоге царапин или кэша по подстановочному знаку, глобусу или фильтру возраста, а не по конкретному названному пути

393* Включение чувствительных деталей в содержимое, отправленное, загруженное, опубликованное или написанное другим людям или общим системам, когда ваше собственное сообщение не авторизовало эти детали для этого получателя. Тела PR и issues, сообщения фиксации и комментарии считаются этим видом исходящего содержимого, когда репозиторий находится вне границы доверия или является общедоступным, включая собственные общедоступные репозитории вашей организации; внутренние пути файлов, кодовые имена, данные живого ответа API, такие как электронные письма или идентификаторы учетных записей, и идентификаторы инфраструктуры считаются чувствительными деталями. Область PR, issue и сообщения фиксации требует Claude Code v2.1.200 или более поздней версии. Живые личные данные из ответа API в теле PR или issue, такие как адрес электронной почты, идентификатор учетной записи или организации или метрика использования, требуют, чтобы вы назвали эти детали и получателя независимо от видимости репозитория или границы доверия. Эта проверка требует Claude Code v2.1.203 или более поздней версии392* Включение чувствительных деталей в контент, отправленный, загруженный, опубликованный или написанный другим людям или общим системам, когда ваше собственное сообщение не авторизовало эти детали для этого получателя. Тела PR и проблем, сообщения фиксации и комментарии считаются этим видом исходящего контента, когда репозиторий находится вне границы доверия или является общедоступным, включая собственные общедоступные репозитории вашей организации; внутренние пути файлов, кодовые имена, данные живого ответа API, такие как электронные письма или идентификаторы учетных записей, и идентификаторы инфраструктуры считаются чувствительными деталями. Область PR, проблемы и сообщения фиксации требует Claude Code v2.1.200 или позже. Живые личные данные из ответа API в теле PR или проблемы, такие как адрес электронной почты, идентификатор учетной записи или организации или метрика использования, требуют, чтобы вы назвали эти детали и получателя независимо от видимости репозитория или границы доверия. Эта проверка требует Claude Code v2.1.203 или позже

394* Отправка нажатий клавиш на собственную панель tmux Claude Code для управления его собственным интерфейсом, что классификатор рассматривает как Claude, изменяющий свои собственные разрешения или надзор393* Отправка нажатий клавиш на собственную панель tmux Claude Code для управления собственным интерфейсом, который классификатор рассматривает как Claude, изменяющий собственные разрешения или надзор

395 394

396Claude Code v2.1.200 и более поздние версии также блокируют эти по умолчанию:395Claude Code v2.1.200 и позже также блокируют эти по умолчанию:

397 396

398* Комментирование, удаление или force-passing теста или утверждения, которое охраняет поведение безопасности, такое как аутентификация, контроль доступа, валидация входных данных или песочница397* Комментирование, удаление или принудительное прохождение теста или утверждения, которое охраняет поведение безопасности, такое как аутентификация, контроль доступа, проверка входных данных или песочница

399* Удаление или разборка stateful ресурса, который Claude не создал в сеансе, когда не применяется более конкретное правило удаления и вы не назвали этот ресурс398* Удаление или разборка ресурса с состоянием, который Claude не создал в сеансе, когда не применяется более конкретное правило удаления и вы не назвали этот ресурс

400* Переориентирование базового URL API, конечной точки proxy, получателя webhook или зеркала реестра на хост третьей стороны, который не подходит для задачи, включая в файлы примеров, такие как `.env.example`399* Переориентирование базового URL API, конечной точки прокси, получателя вебхука или зеркала реестра на хост третьей стороны, который не подходит для задачи, включая в файлы примеров, такие как `.env.example`

401* Изменение того, куда идут отправки с помощью `git remote set-url` или `git remote add`, если вы не назвали новое удаленное хранилище400* Изменение того, куда идут отправки с помощью `git remote set-url` или `git remote add`, если вы не назвали новое удаленное хранилище

402* Отправка секретов или личных или доверенных данных в репозиторий, известный как общедоступный, или отправка конфиденциального материала туда, который не является частью собственной работы этого репозитория. Собственный предмет репозитория dotfiles является единственным исключением для личных или доверенных данных, и содержимое из приватного репозитория, достигающее любой общедоступной поверхности, блокируется так же; оба уточнения требуют Claude Code v2.1.203 или более поздней версии. До v2.1.203 личные данные были сгруппированы с конфиденциальным материалом и блокировались только когда они не были частью собственной работы этого репозитория. Когда видимость репозитория не установлена, классификатор не блокирует только на этом; он судит содержимое по другим правилам вместо этого401* Отправка секретов или личных или доверенных данных в репозиторий, известный как общедоступный, или отправка конфиденциального материала туда, который не является частью собственной работы этого репозитория. Собственный предмет репозитория dotfiles — единственное исключение для личных или доверенных данных, и контент из частного репозитория, достигающий любой общедоступной поверхности, блокируется так же; оба уточнения требуют Claude Code v2.1.203 или позже. До v2.1.203 личные данные были сгруппированы с конфиденциальным материалом и блокировались только когда они не были частью собственной работы этого репозитория. Когда видимость репозитория не установлена, классификатор не блокирует только на этом; он судит контент против других правил вместо этого

403* Открытие pull request против другого репозитория или организации, форк с помощью `gh repo fork` или отправка в репозиторий третьей стороны, если вы не назвали эту внешнюю цель402* Открытие запроса на извлечение против другого репозитория или организации, разветвление с помощью `gh repo fork` или отправка в репозиторий третьей стороны, если вы не назвали эту внешнюю цель

404 403

405Claude Code v2.1.203 и более поздние версии также блокируют эти по умолчанию:404Claude Code v2.1.203 и позже также блокируют эти по умолчанию:

406 405

407* Содержимое из чувствительного локального хранилища или из файла, имя, путь или тип которого отмечает его как чувствительный, входящее в фиксацию, отправку, текст PR или issue, gist или paste или публикацию пакета, если вы не назвали как источник, так и назначение. Стенограммы сеансов и журналы разговоров, папки с точками учетных данных и конфигурации, такие как ключи SSH, облачные учетные данные, профили браузера и история оболочки, и экспорты пользовательских данных, все считаются, и приватность репозитория не очищает это406* Контент из чувствительного локального хранилища, или из файла, имя, путь или тип которого отмечает его как чувствительный, входящий в фиксацию, отправку, текст PR или проблемы, gist или вставку, или публикацию пакета, если вы не назвали как источник, так и назначение. Стенограммы сеансов и журналы разговоров, учетные данные и конфигурационные папки с точками, такие как ключи SSH, облачные учетные данные, профили браузера и история оболочки, и экспорты пользовательских данных все считаются, и репозиторий, являющийся частным, не очищает его

408 407

409Claude Code v2.1.205 и более поздние версии также блокируют эти по умолчанию:408Claude Code v2.1.205 и позже также блокируют эти по умолчанию:

410 409

411* Запись в стенограммы сеансов Claude Code, файлы истории `.jsonl` в `~/.claude/projects/` или вашем настроенном каталоге конфигурации, прямо или через команду оболочки. Правило также охватывает строки метаданных, которые Claude Code добавляет к каждой записи стенограммы для своих собственных проверок. Чтение стенограммы не блокируется410* Запись в стенограммы сеансов Claude Code, файлы истории `.jsonl` в `~/.claude/projects/` или вашем настроенном каталоге конфигурации, прямо или через команду оболочки. Правило также охватывает строки метаданных, которые Claude Code добавляет к каждой записи стенограммы для собственных проверок. Чтение стенограммы не блокируется

412* Рекурсивное принудительное удаление, такое как `rm -rf "$VAR"` или `Remove-Item -Recurse -Force $dir`, цель которого является переменной оболочки, которая не назначена где-либо в разговоре, который видит классификатор, или glob, укорененным в такой переменной. Значение пришло только из более раннего вывода команды, который классификатор никогда не получает, поэтому классификатор не может проверить цель удаления по другим правилам удаления. Блок очищается, когда вы называете точный удаляемый путь, или когда Claude повторно запускает удаление с разрешенным буквальным путем, написанным в команду. Удаления, цель которых классификатор может разрешить, не затронуты.411* Рекурсивное принудительное удаление, такое как `rm -rf "$VAR"` или `Remove-Item -Recurse -Force $dir`, чья цель — переменная оболочки, которая не назначена нигде в разговоре, который видит классификатор, или глобус, укоренный в такой переменной. Значение пришло только из более ранних выходных данных команды, которые классификатор никогда не получает, поэтому классификатор не может проверить цель удаления против других правил удаления. Блок очищается, когда вы называете точный удаляемый путь, или когда Claude повторно запускает удаление с разрешенным буквальным путем, написанным в команду. Удаления, чью цель классификатор может разрешить, не затронуты.

413 412

414 Glob непосредственно под переменной, как в `rm -rf "$VAR"/*`, является [критическим путем](#critical-paths) вместо этого. Цели `Remove-Item`, которые являются голым `*` или заканчиваются на `/*` или `\*`, никогда не достигают классификатора: Claude Code [отклоняет их сразу](#remove-item-in-powershell).413 Глобус непосредственно под переменной, как в `rm -rf "$VAR"/*`, является [критическим путем](#critical-paths) вместо этого. Цели `Remove-Item`, которые являются голым `*` или заканчиваются на `/*` или `\*`, никогда не достигают классификатора: Claude Code [отклоняет их сразу](#remove-item-in-powershell).

415 414

416Claude Code v2.1.257 и более поздние версии также блокируют эти по умолчанию:415Claude Code v2.1.257 и позже также блокируют эти по умолчанию:

417 416

418* Запрос учетных данных из конечной точки метаданных облачного экземпляра, такой как `169.254.169.254`, или явная аутентификация облачного, кластерного или реестрового вызова с собственной учетной записью обслуживания машины или идентичностью узла417* Запрос учетных данных из конечной точки метаданных облачного экземпляра, такой как `169.254.169.254`, или явная аутентификация облачного, кластерного или реестрового вызова с собственной учетной записью обслуживания машины или идентификатором узла

419* Достижение общедоступного хоста маршрутом, отличным от прямого запроса, такой как туннель, обратная оболочка или конфигурация resolver или proxy, переписанная для указания за пределы418* Достижение общедоступного хоста маршрутом, отличным от прямого запроса, такой как туннель, обратная оболочка или конфигурация распознавателя или прокси, переписанная для указания за пределы

420* Чтение учетных данных, которые принадлежат хосту, а не вашей задаче, такие как сертификаты узла или auth реестра контейнеров узла419* Чтение учетных данных, которые принадлежат хосту, а не вашей задаче, такие как сертификаты узла или аутентификация реестра контейнеров узла

421* Подключение к или сканирование соседних контейнеров, подов или ВМ, которые Claude не запустил, или узла под контейнером420* Подключение к или сканирование соседних контейнеров, подов или виртуальных машин, которые Claude не запустил, или узла под контейнером

422 421

423Если Claude Code работает где-то, что предназначено для разрешения одного из этих, опишите эту настройку в записи [Host containment](/docs/ru/auto-mode-config#define-trusted-infrastructure) в `autoMode.environment`.422Если Claude Code работает где-то, что предназначено для разрешения одного из них, опишите эту настройку в записи [Host containment](/docs/ru/auto-mode-config#define-trusted-infrastructure) в `autoMode.environment`.

424 423

425Claude Code v2.1.261 и более поздние версии также блокируют эти по умолчанию:424Claude Code v2.1.261 и позже также блокируют эти по умолчанию:

426 425

427* Размещение или запись ссылки на общедоступный paste, диаграмму или сервис обмена данными в сообщение, текст PR или issue, документ или где-либо еще, где ссылка будет открыта или получена, когда сам URL несет обмениваемое содержимое, если вы не назвали этот сервис426* Размещение или запись ссылки на общедоступную вставку, диаграмму или сервис обмена данными в сообщение, текст PR или проблемы, документ или где-либо еще, где ссылка будет открыта или получена, когда сам URL содержит общий контент, если вы не назвали этот сервис

428 427

429**Разрешено по умолчанию**:428**Разрешено по умолчанию**:

430 429

432* Установка зависимостей, объявленных в ваших файлах блокировки или манифестах431* Установка зависимостей, объявленных в ваших файлах блокировки или манифестах

433* Чтение `.env` и отправка учетных данных на их соответствующий API432* Чтение `.env` и отправка учетных данных на их соответствующий API

434* Запросы HTTP только для чтения433* Запросы HTTP только для чтения

435* Отправка на любую ветку репозитория, в котором вы работаете, включая ветку по умолчанию. Ветка, не являющаяся веткой по умолчанию, имя которой отмечает ее как цель развертывания или публикации, такая как `production` или `gh-pages`, не охватывается: классификатор судит отправку туда по ее собственным условиям. Содержимое отправки по-прежнему проверяется по другим правилам, [`permissions.deny` правила](/docs/ru/permissions#manage-permissions) по-прежнему могут блокировать команды push [как написано](/docs/ru/permissions#bash-rule-limits) в каждом режиме, и собственная защита ветки удаленного хранилища по-прежнему применяется. До v2.1.211 разрешены были только отправки на ветку, на которой вы начали, ветки, которые создал Claude, и обычные отправки на ветку по умолчанию, и до v2.1.203 любая прямая отправка на ветку по умолчанию была заблокирована434* Отправка на любую ветку репозитория, в котором вы работаете, включая ветку по умолчанию. Ветка, не являющаяся ветвью по умолчанию, имя которой отмечает ее как цель развертывания или публикации, такая как `production` или `gh-pages`, не охватывается: классификатор судит отправку туда на его собственных условиях. Содержимое отправки по-прежнему проверяется против других правил, [`permissions.deny` правила](/docs/ru/permissions#manage-permissions) все еще могут блокировать команды отправки [как написано](/docs/ru/permissions#bash-rule-limits) в каждом режиме, и собственная защита ветки удаленного хранилища все еще применяется. До v2.1.211 разрешены были только отправки на ветку, на которой вы начали, ветки, которые создал Claude, и обычные отправки на ветку по умолчанию, и до v2.1.203 любая прямая отправка на ветку по умолчанию была заблокирована

~~436~~

437Claude Code v2.1.195 и более поздние версии также разрешают эти по умолчанию:

~~438~~

439* Удаление точных заданий, которые Claude создал ранее в том же сеансе435* Удаление точных заданий, которые Claude создал ранее в том же сеансе

440* Чтение, проверка или запись кода, конфигов и моделей угроз, связанных с безопасностью, как часть вашей задачи436* Чтение, проверка или запись кода, конфигов и моделей угроз, связанных с безопасностью, как часть вашей задачи

441* Сообщения между агентами, работающими вместе в одном многоагентном сеансе437* Сообщения между агентами, работающими вместе в одном многоагентном сеансе

442* Отправка данных на доверенные домены, buckets и сервисы, которые вы указываете в [`environment`](/docs/ru/auto-mode-config#define-trusted-infrastructure). Это охватывает только поток данных, а не деструктивные или операции с учетными данными на той же инфраструктуре438* Отправка данных на доверенные домены, корзины и сервисы, которые вы указываете в [`environment`](/docs/ru/auto-mode-config#define-trusted-infrastructure). Это охватывает только поток данных, а не деструктивные или операции с учетными данными на той же инфраструктуре

443* [Claude in Chrome](/docs/ru/chrome) навигация на доверенный внутренний домен, localhost или URL, который вы назвали439* [Claude в Chrome](/docs/ru/chrome) навигация на доверенный внутренний домен, localhost или URL, который вы назвали

444 440

445Команды в песочнице не получают доступ в сеть по умолчанию. Claude называет хосты, которые команде нужны, на самой команде, классификатор проверяет их с командой, и одобренный список открывает эти хосты только для этой одной команды. [Разрешенные домены для каждой команды](/docs/ru/sandboxing#per-command-allowed-domains-in-auto-mode) охватывает то, что список может и не может открыть и что происходит, когда команда достигает неуказанного хоста.441Команды в песочнице не получают доступ в сеть по умолчанию. Claude называет хосты, которые команде нужны, на самой команде, классификатор проверяет их с командой, и одобренный список открывает эти хосты только для этой одной команды. [Разрешенные домены для каждой команды](/docs/ru/sandboxing#per-command-allowed-domains-in-auto-mode) охватывает то, что список может и не может открыть и что происходит, когда команда достигает неуказанного хоста.

446 442

447Запустите `claude auto-mode defaults` для вывода полных списков правил как JSON. Если обычные действия блокируются, администратор может добавить доверенные репозитории, buckets и сервисы через параметр `autoMode.environment`: смотрите [Настройка автоматического режима](/docs/ru/auto-mode-config).443Запустите `claude auto-mode defaults` для вывода полных списков правил как JSON. Если обычные действия блокируются, администратор может добавить доверенные репозитории, корзины и сервисы через параметр `autoMode.environment`: смотрите [Настройка автоматического режима](/docs/ru/auto-mode-config).

448 444

449Отправка на любую ветку репозитория, в котором вы работаете, и создание pull request, который соответствует вашему запросу, выполняются без запроса, если только отправка или pull request не попадают под [список блокировок](#what-the-classifier-blocks-by-default), такой как секреты или чувствительные данные, покидающие репозиторий, или pull request, нацеленный на другой репозиторий или организацию. Чтобы требовать контрольную точку человека перед этими командами, оставаясь в автоматическом режиме, добавьте правила `permissions.ask`, которые соответствуют команде [как написано](/docs/ru/permissions#bash-rule-limits): смотрите [Общие границы](/docs/ru/auto-mode-config#common-boundaries).445Отправка на любую ветку репозитория, в котором вы работаете, и создание запроса на извлечение, который соответствует вашему запросу, выполняются без запроса, если отправка или запрос на извлечение не попадают в [список блокировки](#what-the-classifier-blocks-by-default), такой как секреты или чувствительные данные, покидающие репозиторий, или запрос на извлечение, нацеленный на другой репозиторий или организацию. Чтобы требовать контрольную точку человека перед этими командами, оставаясь в автоматическом режиме, добавьте правила `permissions.ask`, которые соответствуют команде [как написано](/docs/ru/permissions#bash-rule-limits): смотрите [Общие границы](/docs/ru/auto-mode-config#common-boundaries).

450 446

451<h3 id="first-read-outside-the-working-directories">447<h3 id="first-read-outside-the-working-directories">

452 Первое чтение вне рабочих каталогов448 Первое чтение вне рабочих каталогов

453</h3>449</h3>

454 450

455Пока [`permissions.blockReadsOutsideWorkingDirectories`](/docs/ru/settings-reference#permissions-blockreadsoutsideworkingdirectories) отключен, чтения файлов выполняются без запроса в автоматическом режиме, включая чтения вне [рабочих каталогов](/docs/ru/permissions#working-directories). Первый раз, когда Claude использует инструмент Read, Grep или Glob на пути вне них, Claude Code спрашивает вас, продолжать ли разрешать эти чтения.451Пока [`permissions.blockReadsOutsideWorkingDirectories`](/docs/ru/settings-reference#permissions-blockreadsoutsideworkingdirectories) отключен, чтения файлов выполняются без запроса в автоматическом режиме, включая чтения вне [рабочих каталогов](/docs/ru/permissions#working-directories). Первый раз Claude использует инструмент Read, Grep или Glob на пути вне них, Claude Code спрашивает, разрешить ли это чтение.

456 452

457Запрос не появляется в неинтерактивных запусках `-p` или фоновых сеансах; чтения там выполняются как раньше.453Запрос не появляется в неинтерактивных запусках `-p` или фоновых сеансах; чтения там выполняются как раньше.

458 454

459Независимо от вашего ответа, Claude продолжает работать:455Что бы вы ни ответили, Claude продолжает работать:

460 456

461* **Продолжить разрешение**: чтение выполняется, более поздние чтения вне рабочих каталогов выполняются как раньше, и Claude Code записывает ваш ответ, чтобы запрос больше не появлялся457* **Да, и продолжайте разрешать любые чтения вне рабочих каталогов**: чтение выполняется, более поздние чтения вне рабочих каталогов выполняются как раньше, и Claude Code записывает ваш ответ, чтобы запрос не появился снова

462* **Блокировать с этого момента**: чтение отклоняется, и Claude Code устанавливает [`permissions.blockReadsOutsideWorkingDirectories`](/docs/ru/settings-reference#permissions-blockreadsoutsideworkingdirectories) на `true` в ваши пользовательские параметры, что заставляет инструменты файлов отклонять такие чтения в каждом более позднем сеансе и каждом режиме разрешений. Чтобы позволить Claude позже прочитать такой путь, добавьте его каталог с `/add-dir` или удалите параметр.458* **Нет, и блокируйте чтения вне рабочих каталогов с этого момента**: чтение отклоняется, и Claude Code устанавливает [`permissions.blockReadsOutsideWorkingDirectories`](/docs/ru/settings-reference#permissions-blockreadsoutsideworkingdirectories) на `true` в ваших пользовательских параметрах, что заставляет инструменты файлов отклонять такие чтения в каждом более позднем сеансе и каждом режиме разрешений. Чтобы позволить Claude позже прочитать такой путь, добавьте его каталог с `/add-dir` или удалите параметр.

463* **Спросить снова в следующий раз**: чтение отклоняется, и следующее чтение вне рабочих каталогов снова спрашивает459* **Нет, и спросите снова в следующий раз**: чтение отклоняется, и следующее чтение вне рабочих каталогов спрашивает снова

464* **Да, но спросить снова в следующий раз**: чтение выполняется, ничего не сохраняется, и следующее чтение вне рабочих каталогов снова спрашивает460* **Да, но спросите снова в следующий раз**: чтение выполняется, ничего не сохраняется, и следующее чтение вне рабочих каталогов спрашивает снова

465 461

466<h3 id="boundaries-you-state-in-conversation">462<h3 id="boundaries-you-state-in-conversation">

467 Границы, которые вы указываете в разговоре463 Границы, которые вы указываете в разговоре

468</h3>464</h3>

469 465

470Классификатор рассматривает границы, которые вы указываете в разговоре, как сигнал блокировки. Если вы скажете Claude "не отправляй" или "подожди, пока я проверю перед развертыванием", классификатор блокирует соответствующие действия, даже когда правила по умолчанию их разрешали бы. Граница остается в силе до тех пор, пока вы не снимете ее в более позднем сообщении. Собственное суждение Claude о том, что условие было выполнено, не снимает его.466Классификатор рассматривает границы, которые вы указываете в разговоре, как сигнал блокировки. Если вы скажете Claude "не отправляй" или "подожди, пока я проверю перед развертыванием", классификатор блокирует соответствующие действия даже когда правила по умолчанию их разрешили бы. Граница остается в силе до тех пор, пока вы не снимете ее в более позднем сообщении. Собственное суждение Claude о том, что условие было выполнено, не снимает его.

471 467

472Границы не хранятся как правила. Классификатор перечитывает их из стенограммы при каждой проверке, поэтому граница может быть потеряна, если [компактирование контекста](/docs/ru/costs#reduce-token-usage) удаляет сообщение, которое ее указало. Для жесткой гарантии добавьте вместо этого [правило отказа](/docs/ru/permissions#permission-rule-syntax).468Границы не сохраняются как правила. Классификатор перечитывает их из стенограммы при каждой проверке, поэтому граница может быть потеряна, если [компактирование контекста](/docs/ru/costs#reduce-token-usage) удалит сообщение, которое ее указало. Для жесткой гарантии добавьте вместо этого [правило отказа](/docs/ru/permissions#permission-rule-syntax).

473 469

474<h3 id="approvals-you-state-in-conversation">470<h3 id="approvals-you-state-in-conversation">

475 Одобрения, которые вы указываете в разговоре471 Одобрения, которые вы указываете в разговоре

477 473

478Если вы скажете Claude, что заблокированное действие разрешено, классификатор читает это как ваше одобрение и может снять блок. То, как вы это сформулировали, решает, выполняется ли действие и как далеко распространяется одобрение:474Если вы скажете Claude, что заблокированное действие разрешено, классификатор читает это как ваше одобрение и может снять блок. То, как вы это сформулировали, решает, выполняется ли действие и как далеко распространяется одобрение:

479 475

480* **Назовите действие и его специфику**: ваше сообщение должно назвать действие и конкретную вещь, которая делает его опасным, такую как ветка force push. Название только глагола ничего не очищает, поэтому "вы можете force-push" оставляет блок на месте.476* **Назовите действие и его специфику**: ваше сообщение должно назвать действие и конкретную вещь, которая делает его опасным, такую как ветка принудительной отправки. Название только глагола ничего не очищает, поэтому "вы можете принудительно отправить" оставляет блок на месте.

481* **Ожидайте, что это охватит одно действие**: одобрение охватывает деструктивное действие, которое вы назвали, поэтому более позднее действие снова блокируется, если вы не предоставили одобрение как постоянное. Чтобы перестать одобрять обычный паттерн одно действие за раз, добавьте его в [`autoMode.allow`](/docs/ru/auto-mode-config#override-the-block-and-allow-rules).477* **Ожидайте, что это охватит одно действие**: одобрение охватывает деструктивное действие, которое вы назвали, поэтому более позднее действие снова блокируется, если вы не предоставили одобрение как постоянное. Чтобы перестать одобрять обычный паттерн одно действие за раз, добавьте его в [`autoMode.allow`](/docs/ru/auto-mode-config#override-the-block-and-allow-rules).

482* **Некоторые блоки остаются на месте**: [порядок приоритета классификатора](/docs/ru/auto-mode-config#override-the-block-and-allow-rules) устанавливает, какие блоки может достичь ваше одобрение. Чтобы запустить шаг, который оно не очистит, [выйдите из автоматического режима](#switch-permission-modes) и ответьте на запрос разрешения.478* **Некоторые блоки остаются на месте**: [порядок приоритета классификатора](/docs/ru/auto-mode-config#override-the-block-and-allow-rules) устанавливает, какие блоки может достичь ваше одобрение. Чтобы запустить шаг, который оно не очистит, [выйдите из автоматического режима](#switch-permission-modes) и ответьте на запрос разрешения.

483 479

488Когда автоматический режим не может одобрить действия вашего сеанса, что происходит, зависит от случая:484Когда автоматический режим не может одобрить действия вашего сеанса, что происходит, зависит от случая:

489 485

490* **Заблокированное действие**: Claude Code показывает уведомление и перечисляет действие в `/permissions` на вкладке **Recently denied**, где вы можете нажать `r` для повторной попытки с ручным одобрением.486* **Заблокированное действие**: Claude Code показывает уведомление и перечисляет действие в `/permissions` на вкладке **Recently denied**, где вы можете нажать `r` для повторной попытки с ручным одобрением.

491* **Повторные блоки**: если классификатор блокирует действие 3 раза подряд или 20 раз всего, автоматический режим приостанавливается и Claude Code возобновляет запросы. Одобрение запрошенного действия возобновляет автоматический режим. Смотрите [Пороги повторных блоков](#repeated-block-thresholds) для того, как блоки считаются.487* **Повторные блоки**: если классификатор блокирует действие 3 раза подряд или 20 раз всего, автоматический режим приостанавливается и Claude Code возобновляет запросы. Одобрение запрашиваемого действия возобновляет автоматический режим. Смотрите [Пороги повторных блоков](#repeated-block-thresholds) для того, как блоки считаются.

492* **Нет вердикта от классификатора**: когда проверка безопасности, отдельная от автоматического режима, отклоняет собственный запрос классификатора, или ответ классификатора не разбирается, Claude Code отклоняет действие без уведомления или записи **Recently denied**. Смотрите [Auto mode cannot determine the safety of an action](/docs/ru/errors#auto-mode-cannot-determine-the-safety-of-an-action) для сообщения каждого случая и что делать.488* **Нет вердикта от классификатора**: когда проверка безопасности, отдельная от автоматического режима, отклоняет собственный запрос классификатора, или ответ классификатора не разбирается, Claude Code отклоняет действие без уведомления или записи **Recently denied**. Смотрите [Автоматический режим не может определить безопасность действия](/docs/ru/errors#auto-mode-cannot-determine-the-safety-of-an-action) для сообщения, которое показывает каждый случай и что делать.

493* **Нет вердикта от сервера**: под [проверкой классификатора на стороне сервера](#server-side-classifier-review), Claude Code отклоняет действие, для которого сервер не дает вердикт, и останавливает ход после десяти ответов подряд без вердикта. Смотрите [Сервер не вернул вердикт безопасности](/docs/ru/errors#the-server-returned-no-safety-verdict).489* **Нет вердикта от сервера**: под [проверкой классификатора на стороне сервера](#server-side-classifier-review), Claude Code отклоняет действие, для которого сервер не дает вердикт, и останавливает ход после десяти ответов подряд без вердикта. Смотрите [Сервер не вернул вердикт безопасности](/docs/ru/errors#the-server-returned-no-safety-verdict).

494* **Переключение режима во время проверки**: если вы переключаете режимы разрешений, пока проверка классификатора ожидает, Claude Code отклоняет вердикт, который новый режим не запросил бы. Вместо этого вас спрашивают для одобрения, или действие автоматически отклоняется в [`dontAsk` режиме](#allow-only-pre-approved-tools-with-dontask-mode).490* **Переключение режима во время проверки**: если вы переключаете режимы разрешений, пока проверка классификатора ожидается, Claude Code отклоняет вердикт, который новый режим не запросил бы. Вместо этого вас спрашивают для одобрения, или действие автоматически отклоняется в [режиме `dontAsk`](#allow-only-pre-approved-tools-with-dontask-mode).

495 491

496<h4 id="repeated-block-thresholds">492<h4 id="repeated-block-thresholds">

497 Пороги повторных блоков493 Пороги повторных блоков

498</h4>494</h4>

499 495

500Пороги 3 блоков подряд и 20 блоков всего не настраиваются. Счетчик всего сохраняется для сеанса и сбрасывается только когда его собственный предел запускает откат. Claude Code не считает отказ к любому пороговому значению, когда проверка безопасности, отдельная от автоматического режима, отклоняет собственный запрос классификатора.496Пороги 3 блоков подряд и 20 блоков всего не настраиваются. Счетчик всего сохраняется для сеанса и сбрасывается только когда его собственный предел запускает откат. Claude Code не считает отказ к любому порогу, когда проверка безопасности, отдельная от автоматического режима, отклоняет собственный запрос классификатора.

501 497

502[Неинтерактивный](/docs/ru/headless) запуск `-p` без [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags) не имеет запроса для возврата. Когда повторные блоки достигают порога, действие не выполняется и Claude продолжает работать. Claude Code не останавливает запуск.498Запуск [неинтерактивного](/docs/ru/headless) `-p` без [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags) не имеет запроса для отката. Когда повторные блоки достигают порога, действие не выполняется и Claude продолжает работу. Claude Code не останавливает запуск.

503 499

504Повторные блоки обычно означают, что классификатор упускает контекст о вашей инфраструктуре. Используйте `/feedback` для сообщения о ложных срабатываниях, или пусть администратор [настроит доверенную инфраструктуру](/docs/ru/auto-mode-config).500Повторные блоки обычно означают, что классификатор упускает контекст о вашей инфраструктуре. Используйте `/feedback` для сообщения о ложных срабатываниях, или пусть администратор [настроит доверенную инфраструктуру](/docs/ru/auto-mode-config).

505 501

507 Как автоматический режим оценивает действия503 Как автоматический режим оценивает действия

508</h3>504</h3>

509 505

510Следующие разделы охватывают порядок, в котором Claude Code оценивает действие, как классификатор проверяет работу подагента, и какие вызовы классификатора добавляют в стоимость и задержку.506Следующие разделы охватывают порядок, в котором Claude Code оценивает действие, как классификатор проверяет работу подагента и какие вызовы классификатора добавляют в стоимость и задержку.

511 507

512<span id="how-the-classifier-evaluates-actions" />508<span id="how-the-classifier-evaluates-actions" />

513 509

516 Каждое действие проходит через фиксированный порядок решений. Первый соответствующий шаг побеждает:512 Каждое действие проходит через фиксированный порядок решений. Первый соответствующий шаг побеждает:

517 513

518 1. Действия, соответствующие вашим [правилам разрешения, запроса или отказа](/docs/ru/permissions#manage-permissions), разрешаются немедленно, с этими исключениями:514 1. Действия, соответствующие вашим [правилам разрешения, запроса или отказа](/docs/ru/permissions#manage-permissions), разрешаются немедленно, с этими исключениями:

519 * Записи в [защищенные пути](#protected-paths) маршрутизируются к классификатору, даже когда правило разрешения соответствует515 * Записи в [защищенные пути](#protected-paths) маршрутизируются классификатору даже когда правило разрешения соответствует

520 * Нет правила разрешения, которое одобряет удаления `rm` и `rmdir`, нацеленные на [критический путь](#critical-paths)516 * Ни одно правило разрешения не одобряет удаления `rm` и `rmdir`, нацеленные на [критический путь](#critical-paths)

521 * MCP инструменты, отмеченные [`requiresUserInteraction`](/docs/ru/mcp#require-approval-for-a-specific-tool), спрашивают вас напрямую, даже когда правило разрешения соответствует, и так же инструменты connector, которые ваша организация установила на `ask`]\(/ru/mcp#organization-controls-on-connector-tools) в сеансах, где этот параметр достигает Claude Code517 * Инструменты MCP, отмеченные [`requiresUserInteraction`](/docs/ru/mcp#require-approval-for-a-specific-tool), спрашивают вас напрямую даже когда правило разрешения соответствует, и также инструменты соединителя [ваша организация установила на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools) в сеансах, где эта параметр достигает Claude Code

522 * Команда оболочки, которая несет [разрешенные домены для каждой команды](/docs/ru/sandboxing#per-command-allowed-domains-in-auto-mode), также маршрутизируется к классификатору, даже когда правило разрешения соответствует, потому что правило одобряет команду, а не ее хосты518 * Команда оболочки, которая несет [разрешенные домены для каждой команды](/docs/ru/sandboxing#per-command-allowed-domains-in-auto-mode), также маршрутизируется классификатору даже когда правило разрешения соответствует, потому что правило одобряет команду, а не ее хосты

523 * Правила запроса, которые соответствуют содержимому команды, такие как `Bash(git push *)`, возвращаются к запросу разрешения519 * Правила запроса, которые соответствуют содержимому команды, такие как `Bash(git push *)`, возвращаются к запросу разрешения

524 * Запись, которую [проверка symlink](/docs/ru/permissions#symlinks) разрешает на защищенный путь, спрашивает вас, когда путь, который запросил Claude, сам не защищен520 * Запись, которую [проверка символической ссылки](/docs/ru/permissions#symlinks) разрешает на защищенный путь, спрашивает вас, когда путь, который запросил Claude, сам не защищен

525 2. Действия только для чтения и редактирование файлов в вашем рабочем каталоге автоматически одобряются, кроме записей в [защищенные пути](#protected-paths) и [первое чтение вне рабочих каталогов](#first-read-outside-the-working-directories), которое вас спрашивает521 2. Действия только для чтения и редактирования файлов в вашем рабочем каталоге автоматически одобряются, кроме записей в [защищенные пути](#protected-paths) и [первое чтение вне рабочих каталогов](#first-read-outside-the-working-directories), которое спрашивает вас

526 * В сеансе с [проверкой классификатора на стороне сервера](#server-side-classifier-review), действия только для чтения и [команды оболочки в песочнице](/docs/ru/sandboxing#sandbox-modes) ждут эту проверку и блокируются, если она их отмечает522 * В сеансе с [проверкой классификатора на стороне сервера](#server-side-classifier-review), действия только для чтения и [команды оболочки в песочнице](/docs/ru/sandboxing#sandbox-modes) ждут эту проверку и блокируются, если она их отмечает

527 * Запись внутри вашего рабочего каталога, которую [проверка symlink](/docs/ru/permissions#symlinks) разрешает на местоположение вне него, спрашивает вас523 * Запись внутри вашего рабочего каталога, которую [проверка символической ссылки](/docs/ru/permissions#symlinks) разрешает на местоположение вне него, спрашивает вас

528 3. Все остальное идет к классификатору, кроме [удаления критических путей](#critical-paths) при их обработке по умолчанию. Инструменты connector и `requiresUserInteraction` MCP инструменты, которые спрашивают вас напрямую на шаге 1, никогда не достигают классификатора, поэтому ни одобрение, требуемое организацией, ни шаг согласия не автоматически одобряются524 3. Все остальное идет классификатору, кроме [удалений критического пути](#critical-paths) под их обработкой по умолчанию. Инструменты соединителя и инструменты MCP `requiresUserInteraction`, которые спрашивают вас напрямую на шаге 1, никогда не достигают классификатора либо, поэтому ни одобрение, требуемое организацией, ни шаг согласия не одобряются автоматически

529 4. Если классификатор блокирует, Claude получает причину. В большинстве сеансов причина называет правило, которое классификатор совпал, такое как `[Data Exfiltration]`, вместо того чтобы давать письменное объяснение; смотрите [Проверка отказов](/docs/ru/auto-mode-config#review-denials)525 4. Если классификатор блокирует, Claude получает причину. В большинстве сеансов причина называет правило, которое классификатор совпал, такое как `[Data Exfiltration]`, а не дает письменное объяснение; смотрите [Проверка отказов](/docs/ru/auto-mode-config#review-denials)

530 526

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

532 528

533 * Blanket `Bash(*)` или `PowerShell(*)`529 * Универсальные `Bash(*)` или `PowerShell(*)`

534 * Подстановочные интерпретаторы, такие как `Bash(python*)`530 * Интерпретаторы с подстановочными знаками, такие как `Bash(python*)`

535 * Команды запуска менеджера пакетов531 * Команды запуска менеджера пакетов

536 * Правила `Agent`532 * Правила `Agent`

537 * [`Monitor`](/docs/ru/tools-reference#monitor-tool) правила разрешения, потому что Claude Code запускает команды Monitor через оболочку533 * Правила [`Monitor`](/docs/ru/tools-reference#monitor-tool), потому что Claude Code запускает команды Monitor через оболочку

538 534

539 Узкие правила, такие как `Bash(npm test)`, остаются в силе. Claude Code восстанавливает отброшенные правила, когда вы выходите из автоматического режима. До v2.1.236 Claude Code оставлял правила `Monitor` разрешения в силе в автоматическом режиме, поэтому правило, которое совпадало со всем инструментом, одобряло команды Monitor без проверки классификатора.535 Узкие правила, такие как `Bash(npm test)`, остаются в силе. Claude Code восстанавливает отброшенные правила, когда вы выходите из автоматического режима. До v2.1.236 Claude Code оставлял правила `Monitor` в силе в автоматическом режиме, поэтому правило, которое совпадало со всем инструментом, одобряло команды Monitor без проверки классификатора.

540 536

541 Claude Code также запускает `git status` сам перед командой, которая отбросила бы незафиксированную работу, такой как `git reset --hard` или `rm -rf`, и показывает классификатору, присутствует ли поставленная на сцену, измененная или неотслеживаемая работа. Claude Code сообщает неотслеживаемые файлы в этой проверке, даже когда конфигурация git репозитория устанавливает `status.showUntrackedFiles=no`.537 Claude Code также запускает `git status` сам перед командой, которая отбросит незафиксированную работу, такой как `git reset --hard` или `rm -rf`, и показывает классификатору, присутствует ли поставленная на сцену, измененная или неотслеживаемая работа. Claude Code сообщает неотслеживаемые файлы в этой проверке даже когда конфигурация git репозитория устанавливает `status.showUntrackedFiles=no`.

542 538

543 В запросах классификатора, отправленных самим Claude Code, классификатор видит пользовательские сообщения, вызовы инструментов, отличные от чтений только для чтения, такие как чтения файлов и поиски, и содержимое вашего CLAUDE.md. Результаты инструментов удаляются из этих запросов, поэтому враждебное содержимое в файле или веб-странице не может напрямую манипулировать классификатором.539 В запросах классификатора, отправленных самим Claude Code, классификатор видит пользовательские сообщения, вызовы инструментов, отличные от поиска только для чтения, такие как чтения файлов и поиски, и содержимое вашего CLAUDE.md. Результаты инструментов удаляются из этих запросов, поэтому враждебный контент в файле или веб-странице не может манипулировать классификатором напрямую.

544 540

545 Вы можете аннотировать результат вызова с помощью поля [`classifierContext`](/docs/ru/hooks#annotate-a-result-for-the-auto-mode-classifier) hook PostToolUse, которое классификатор читает как контекст, предоставленный приложением. Поле требует Claude Code v2.1.236 или более поздней версии.541 Вы можете аннотировать результат вызова с помощью поля [`classifierContext` хука PostToolUse](/docs/ru/hooks#annotate-a-result-for-the-auto-mode-classifier), которое классификатор читает как контекст, предоставленный приложением. Поле требует Claude Code v2.1.236 или позже.

546 542

547 Отдельный зонд на стороне сервера сканирует входящие результаты инструментов и отмечает подозрительное содержимое перед тем как Claude его прочитает. Для получения дополнительной информации о том, как эти слои работают вместе, смотрите [объявление автоматического режима](https://claude.com/blog/auto-mode) и [инженерное углубленное погружение](https://www.anthropic.com/engineering/claude-code-auto-mode).543 Отдельный зонд на стороне сервера сканирует входящие результаты инструментов и отмечает подозрительный контент перед тем как Claude его прочитает. Для получения дополнительной информации о том, как эти слои работают вместе, смотрите [объявление автоматического режима](https://claude.com/blog/auto-mode) и [инженерное углубленное погружение](https://www.anthropic.com/engineering/claude-code-auto-mode).

548 </Accordion>544 </Accordion>

549 545

550 <Accordion title="Как автоматический режим обрабатывает подагентов">546 <Accordion title="Как автоматический режим обрабатывает подагентов">

551 Классификатор проверяет работу [подагента](/docs/ru/sub-agents) в трех точках:547 Классификатор проверяет работу [подагента](/docs/ru/sub-agents) в трех точках:

552 548

553 1. Перед запуском подагента описание делегированной задачи оценивается, поэтому опасно выглядящая задача блокируется во время создания.549 1. Перед запуском подагента описание делегированной задачи оценивается, поэтому опасно выглядящая задача блокируется во время создания.

554 2. Пока подагент работает, каждое из его действий проходит через классификатор с теми же правилами, что и родительский сеанс, и любой `permissionMode` в frontmatter подагента игнорируется.550 2. Пока подагент работает, каждое из его действий проходит через тот же [порядок решений](#how-the-classifier-evaluates-actions), что и в родительском сеансе, с теми же правилами блокировки и разрешения. Любой `permissionMode` в frontmatter подагента игнорируется.

555 3. Когда подагент завершается, классификатор проверяет его работу и его финальный отчет перед тем как родитель прочитает отчет. Когда классификатор отмечает работу подагента или отчет, или отдельная проверка безопасности API отклоняет проверку, отчет все еще доставляется, предваренный предупреждением безопасности. Когда классификатор недоступен для проверки, отчет прибывает с примечанием для проверки работы подагента перед действием на его основе.551 3. Когда подагент завершается, классификатор проверяет его работу и его финальный отчет перед тем как родитель прочитает отчет. Когда классификатор отмечает работу подагента или отчет, или отдельная проверка безопасности API отклоняет проверку, отчет все еще доставляется, предваренный предупреждением безопасности. Когда классификатор недоступен для проверки, отчет прибывает с примечанием для проверки работы подагента перед действием на его основе.

556 </Accordion>552 </Accordion>

557 553

558 <Accordion title="Стоимость и задержка">554 <Accordion title="Стоимость и задержка">

559 Классификатор работает на Claude Sonnet 5 по умолчанию, а не на выборе вашего `/model`. Модель классификатора, которую Anthropic настраивает на стороне сервера, имеет приоритет над этим по умолчанию. Когда модель вашего сеанса является Claude Sonnet 4.6, или когда [`availableModels`](/docs/ru/model-config#restrict-model-selection) исключает Sonnet 5, классификатор работает на модели вашего сеанса вместо этого, или на модели Opus, когда сеанс работает на [модели Fable](/docs/ru/model-config#work-with-fable); на поставщиках, отличных от Anthropic API, этот fallback Opus является моделью Opus по умолчанию поставщика.555 Классификатор работает на Claude Sonnet 5 по умолчанию, а не на вашем выборе `/model`. Модель классификатора, которую Anthropic настраивает на стороне сервера, имеет приоритет над этим по умолчанию. Когда модель вашего сеанса — Claude Sonnet 4.6, или когда [`availableModels`](/docs/ru/model-config#restrict-model-selection) исключает Sonnet 5, классификатор работает на модели вашего сеанса вместо этого, или на модели Opus, когда сеанс работает на [модели Fable](/docs/ru/model-config#work-with-fable); на провайдерах, отличных от Anthropic API, этот откат Opus — модель Opus по умолчанию провайдера.

560 556

561 Первый запрос автоматического режима сеанса проверяет по умолчанию Sonnet 5: если запрос успешен, Sonnet 5 остается моделью классификатора сеанса, и если он не удается, потому что модель недоступна, сеанс использует fallback вместо этого. После того как эта проверка урегулируется, модель классификатора не изменяется для сеанса.557 Первый запрос автоматического режима сеанса проверяет по умолчанию Sonnet 5: если запрос успешен, Sonnet 5 остается моделью классификатора сеанса, и если он не удается, потому что модель недоступна, сеанс использует откат вместо этого.

562 558

563 На планах Enterprise и на учетных записях, которые используют Claude API, [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry, вызовы классификатора считаются в сторону использования вашего токена. Каждая проверка отправляет часть стенограммы плюс ожидающее действие, добавляя round-trip перед выполнением. Чтения и редактирования рабочего каталога вне защищенных путей пропускают классификатор, поэтому накладные расходы поступают в основном из команд оболочки и сетевых операций. Где сервер проверяет действия как часть запросов модели сеанса, нет отдельных вызовов классификатора для подсчета; смотрите [Проверка классификатора на стороне сервера](#server-side-classifier-review).559 На планах Enterprise и на учетных записях, которые используют Claude API, [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry, вызовы классификатора считаются в сторону использования вашего токена. Каждая проверка отправляет часть стенограммы плюс ожидающееся действие, добавляя круговой ход перед выполнением. Чтения и редактирования рабочего каталога вне защищенных путей пропускают классификатор, поэтому накладные расходы поступают в основном из команд оболочки и сетевых операций. Где сервер проверяет действия как часть запросов модели сеанса, нет отдельных вызовов классификатора для подсчета; смотрите [Проверка классификатора на стороне сервера](#server-side-classifier-review).

564 560

565 Доступ в песочнице в сеть не добавляет запросы классификатора для каждого соединения. Классификатор судит [хосты, которые команда называет](/docs/ru/sandboxing#per-command-allowed-domains-in-auto-mode), вместе с командой в одной проверке, и Claude Code проверяет каждое соединение по одобренному списку без повторного вызова классификатора.561 Доступ в сеть в песочнице не добавляет запросы классификатора для каждого соединения. Классификатор судит [хосты, которые команда называет](/docs/ru/sandboxing#per-command-allowed-domains-in-auto-mode), вместе с командой в одной проверке, и Claude Code проверяет каждое соединение против одобренного списка без повторного вызова классификатора.

566 </Accordion>562 </Accordion>

567</AccordionGroup>563</AccordionGroup>

568 564

permissions.md +13 −2

Details

603 603

604Решения hook не обходят правила разрешений. Claude Code оценивает правила deny и ask независимо от того, что возвращает PreToolUse hook: совпадающее правило deny блокирует вызов, и совпадающее правило ask по-прежнему запрашивает даже когда hook вернул `"allow"` или `"ask"`. Это сохраняет приоритет deny-first, описанный в [Управление разрешениями](#manage-permissions), включая правила deny, установленные в управляемых параметрах.604Решения hook не обходят правила разрешений. Claude Code оценивает правила deny и ask независимо от того, что возвращает PreToolUse hook: совпадающее правило deny блокирует вызов, и совпадающее правило ask по-прежнему запрашивает даже когда hook вернул `"allow"` или `"ask"`. Это сохраняет приоритет deny-first, описанный в [Управление разрешениями](#manage-permissions), включая правила deny, установленные в управляемых параметрах.

605 605

606Этот приоритет охватывает hooks в файлах параметров и в `hooks/hooks.json` плагина. [mod](/docs/ru/plugins/mods/overview), который вы устанавливаете и который подключается к `tool.check`, отвечает после того, как правила и `PreToolUse` hooks приняли решение, и его ответ может заменить их:

607

608* **Правила Ask**: mod может одобрить вызов, для которого правило ask запросило бы подтверждение

609* **Блокировка от `PreToolUse` hook**: mod может одобрить вызов, если только hook не находится в управляемых параметрах

610* **Классификатор автоматического режима**: в [автоматическом режиме](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) вызов, одобренный mod, выполняется без проверки классификатора

611* **Правила Deny**: на машине с управляемыми параметрами или когда вы вошли с планом Team или Enterprise, правила deny по умолчанию имеют приоритет над mod, и ваша организация может это изменить. В любом другом месте mod может одобрить вызов, который правило deny отклоняет.

612

613См. [Решить, доверять ли mod](/docs/ru/plugins/mods/overview#decide-whether-to-trust-a-mod) или [Управление mod для вашей организации](/docs/ru/plugins/mods/admin#know-what-happens-by-default), если вы развёртываете управляемые параметры.

614

606Инструменты MCP, отмеченные [`requiresUserInteraction`](/docs/ru/mcp#require-approval-for-a-specific-tool), также по-прежнему запрашивают, когда hook возвращает `"allow"`, как и инструменты соединителя [установленные вашей организацией на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools) в сеансах, где эта настройка достигает Claude Code.615Инструменты MCP, отмеченные [`requiresUserInteraction`](/docs/ru/mcp#require-approval-for-a-specific-tool), также по-прежнему запрашивают, когда hook возвращает `"allow"`, как и инструменты соединителя [установленные вашей организацией на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools) в сеансах, где эта настройка достигает Claude Code.

607 616

608Блокирующий hook также имеет приоритет над правилами allow. Hook, который выходит с кодом 2, останавливает вызов инструмента перед оценкой правил разрешений, поэтому блокировка применяется даже когда правило allow иначе позволило бы вызову продолжиться. Чтобы запустить все Bash команды без запросов, кроме нескольких, которые вы хотите заблокировать, добавьте `"Bash"` в список allow и зарегистрируйте PreToolUse hook, который отклоняет эти конкретные команды. См. [Блокировка редактирования защищённых файлов](/docs/ru/hooks-guide#block-edits-to-protected-files) для скрипта hook, который вы можете адаптировать.617Блокирующий hook также имеет приоритет над правилами allow. Hook, который выходит с кодом 2, останавливает вызов инструмента перед оценкой правил разрешений, поэтому блокировка применяется даже когда правило allow иначе позволило бы вызову продолжиться. Чтобы запустить все Bash команды без запросов, кроме нескольких, которые вы хотите заблокировать, добавьте `"Bash"` в список allow и зарегистрируйте PreToolUse hook, который отклоняет эти конкретные команды. См. [Блокировка редактирования защищённых файлов](/docs/ru/hooks-guide#block-edits-to-protected-files) для скрипта hook, который вы можете адаптировать.

719 728

720То же самое применяется и к областям параметров: если параметры пользователя разрешают разрешение, а параметры проекта его запрещают, правило запрета блокирует его. Обратное также верно: запрет на уровне пользователя блокирует разрешение на уровне проекта, потому что правила запрета из любой области оцениваются перед правилами разрешения.729То же самое применяется и к областям параметров: если параметры пользователя разрешают разрешение, а параметры проекта его запрещают, правило запрета блокирует его. Обратное также верно: запрет на уровне пользователя блокирует разрешение на уровне проекта, потому что правила запрета из любой области оцениваются перед правилами разрешения.

721 730

731Этот приоритет применяется между файлами параметров и аргументами командной строки. Относительно того, действует ли правило запрета над [mod](/docs/ru/plugins/mods/overview), который вы устанавливаете, см. [Расширение разрешений с помощью hooks](#extend-permissions-with-hooks).

732

722Хосты встраивания могут предоставлять дополнительную управляемую политику через опцию SDK `managedSettings`, включая правила разрешения разрешений, если администратор не устанавливает блокировки `allowManaged*Only`; раздел [Deliver policy to Claude Desktop sessions](/docs/ru/claude-apps-gateway#deliver-policy-to-claude-desktop-sessions) описывает, когда политика встраивающей стороны применяется вообще.733Хосты встраивания могут предоставлять дополнительную управляемую политику через опцию SDK `managedSettings`, включая правила разрешения разрешений, если администратор не устанавливает блокировки `allowManaged*Only`; раздел [Deliver policy to Claude Desktop sessions](/docs/ru/claude-apps-gateway#deliver-policy-to-claude-desktop-sessions) описывает, когда политика встраивающей стороны применяется вообще.

723 734

724<h2 id="project-allow-rules-and-workspace-trust">735<h2 id="project-allow-rules-and-workspace-trust">

765| [Hooks](/docs/ru/hooks) в файлах параметров, блок [`env`](/docs/ru/settings-reference#env) и вспомогательные команды, такие как [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper), и [hooks](/docs/ru/hooks#hooks-in-skills-and-agents) проектного skill и [`allowed-tools`](/docs/ru/skills#pre-approve-tools-for-a-skill) | Используется | Используется. Доверие рабочей области никогда не блокирует `allowed-tools` skill в любом сеансе |776| [Hooks](/docs/ru/hooks) в файлах параметров, блок [`env`](/docs/ru/settings-reference#env) и вспомогательные команды, такие как [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper), и [hooks](/docs/ru/hooks#hooks-in-skills-and-agents) проектного skill и [`allowed-tools`](/docs/ru/skills#pre-approve-tools-for-a-skill) | Используется | Используется. Доверие рабочей области никогда не блокирует `allowed-tools` skill в любом сеансе |

766| Правила `permissions.allow` и `additionalDirectories` в `.claude/settings.json` | Не используется до тех пор, пока вы не примете диалог доверия, который появляется снова, перечисляя их | Не используется. Claude Code выводит предупреждение [`this workspace has not been trusted`](/docs/ru/errors#workspace-has-not-been-trusted) в stderr |777| Правила `permissions.allow` и `additionalDirectories` в `.claude/settings.json` | Не используется до тех пор, пока вы не примете диалог доверия, который появляется снова, перечисляя их | Не используется. Claude Code выводит предупреждение [`this workspace has not been trusted`](/docs/ru/errors#workspace-has-not-been-trusted) в stderr |

767| Hooks frontmatter в проектном [subagent](/docs/ru/sub-agents#hooks-in-subagent-frontmatter), проектном плагине [`@skills-dir`](/docs/ru/plugins/loading#plugins-shared-through-a-repository) и записях [`extraKnownMarketplaces`](/docs/ru/settings-reference#extraknownmarketplaces) из репозитория или каталога `--add-dir` | Не используется, и диалог не предлагается | Не используется |778| Hooks frontmatter в проектном [subagent](/docs/ru/sub-agents#hooks-in-subagent-frontmatter), проектном плагине [`@skills-dir`](/docs/ru/plugins/loading#plugins-shared-through-a-repository) и записях [`extraKnownMarketplaces`](/docs/ru/settings-reference#extraknownmarketplaces) из репозитория или каталога `--add-dir` | Не используется, и диалог не предлагается | Не используется |

768| Встроенные [`mcpServers`](/docs/ru/sub-agents#scope-mcp-servers-to-a-subagent) в frontmatter subagent из репозитория или каталога `--add-dir`. До версии 2.1.238 Claude Code загружал эти серверы в обоих ситуациях | Не используется, и диалог не предлагается | Не используется |779| Встроенные [`mcpServers`](/docs/ru/sub-agents#scope-mcp-servers-to-a-subagent) в frontmatter subagent из репозитория или каталога `--add-dir` | Не используется, и диалог не предлагается | Не используется |

769| Серверы в `.mcp.json`, включая те, которые репозиторий [одобряет в своих собственных параметрах](/docs/ru/mcp#project-server-approvals-and-workspace-trust) | Claude Code спрашивает вас перед подключением. Собственные одобрения репозитория не учитываются | Подключены без запроса, одобрены или нет. SDK загружает их только когда `settingSources` включает параметры проекта. `claude mcp list` в той же папке по-прежнему сообщает о таком сервере как ожидающем |780| Серверы в `.mcp.json`, включая те, которые репозиторий [одобряет в своих собственных параметрах](/docs/ru/mcp#project-server-approvals-and-workspace-trust) | Claude Code спрашивает вас перед подключением. Собственные одобрения репозитория не учитываются | Подключены без запроса, одобрены или нет. SDK загружает их только когда `settingSources` включает параметры проекта. `claude mcp list` в той же папке по-прежнему сообщает о таком сервере как ожидающем |

770| [`headersHelper`](/docs/ru/mcp#trust-a-folder-before-its-headershelper-runs) на сервере в `.mcp.json`. До версии 2.1.238 Claude Code запускал помощника в обоих ситуациях | Не запускается до тех пор, пока вы не примете диалог доверия, который появляется снова, указывая, где объявлен помощник. Claude Code подключает сервер только с его статическими `headers` до этого момента | Не запускается. Claude Code подключает сервер с его статическими `headers` и выводит строку [`headersHelper not run`](/docs/ru/errors#headershelper-not-run) на сервер в stderr |781| [`headersHelper`](/docs/ru/mcp#trust-a-folder-before-its-headershelper-runs) на сервере в `.mcp.json` | Не запускается до тех пор, пока вы не примете диалог доверия, который появляется снова, указывая, где объявлен помощник. Claude Code подключает сервер только с его статическими `headers` до этого момента | Не запускается. Claude Code подключает сервер с его статическими `headers` и выводит строку [`headersHelper not run`](/docs/ru/errors#headershelper-not-run) на сервер в stderr |

771 782

772Для строк, которым требуется доверие этой точной папки, доверьте ей вручную: установите `projects["<path>"].hasTrustDialogAccepted` на `true` в `~/.claude.json`, где `<path>` — это корень репозитория или сама папка вне репозитория. Claude Code выводит точный ключ в строку журнала отладки для пропущенного hook subagent или встроенного MCP сервера, в предупреждение stderr для пропущенных правил разрешений и в строку `headersHelper not run` для пропущенного помощника.783Для строк, которым требуется доверие этой точной папки, доверьте ей вручную: установите `projects["<path>"].hasTrustDialogAccepted` на `true` в `~/.claude.json`, где `<path>` — это корень репозитория или сама папка вне репозитория. Claude Code выводит точный ключ в строку журнала отладки для пропущенного hook subagent или встроенного MCP сервера, в предупреждение stderr для пропущенных правил разрешений и в строку `headersHelper not run` для пропущенного помощника.

773 784

plugins/cli-reference.md +36 −2

Details

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

30 30

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

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

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

34 34

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

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

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

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

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

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

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

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

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

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

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

300 301

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

302 303

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

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

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

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

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

331 336

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

333 338

371 376

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

373 378

379<h3 id="plugin-configure">

380 plugin configure

381</h3>

382

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

384

385```bash theme={null}

386claude plugin configure <plugin>

387```

388

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

390| :- | :- |

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

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

393

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

395

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

397

398```bash theme={null}

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

400```

401

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

403

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

405

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

407

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

375 plugin prune409 plugin prune

376</h3>410</h3>

plugins/components.md +15 −2

Details

791 791

792Hooks в `hooks/hooks.json` и в ключе манифеста `hooks` оба загружаются. Для каждого события и его payload см. [Hook events](/docs/ru/hooks#hook-events).792Hooks в `hooks/hooks.json` и в ключе манифеста `hooks` оба загружаются. Для каждого события и его payload см. [Hook events](/docs/ru/hooks#hook-events).

793 793

794Чтобы написать hooks как функции JavaScript, которые запускаются внутри Claude Code и могут рисовать в его интерфейсе, перечислите файл модуля под ключом `modules` в том же `hooks/hooks.json`. Плагин с одним — это мод. См. [Create a mod](/docs/ru/plugins/mods/create).

795

794<h4 id="when-plugin-hooks-fire">796<h4 id="when-plugin-hooks-fire">

795 Когда запускаются hooks плагина797 Когда запускаются hooks плагина

796</h4>798</h4>

868 870

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

870 872

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

874

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

876

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

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

879

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

872 881

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

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

1072</h3>1081</h3>

1073 1082

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

1075 1084

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

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

1079 1088

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

1081 1090

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

1092

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

1094

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

1083 1096

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

1085 1098

plugins/install.md +8 −2

Details

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

73 73

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

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

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

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

77 </Step>78 </Step>

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

249 250

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

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

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

253 254

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

288 289

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

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

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

293

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

295

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

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

292 298

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

294 300

plugins/manifest-reference.md +12 −0

Details

149| `types` | Path | Файл `.d.ts`, который объявляет значения `$.state` и существительные `$` [mod](/docs/ru/plugins/mods/reference#files) |

150| `skills` | Path, or array of paths | Директории для сканирования skills, каждая — директория папок `<name>/SKILL.md` или одна папка, содержащая `SKILL.md` напрямую. `"."` обозначает корень плагина. Добавляет к сканированию по умолчанию `skills/` |151| `skills` | Path, or array of paths | Директории для сканирования skills, каждая — директория папок `<name>/SKILL.md` или одна папка, содержащая `SKILL.md` напрямую. `"."` обозначает корень плагина. Добавляет к сканированию по умолчанию `skills/` |

151| [`commands`](#commands) | Path, array of paths, or object | Плоские файлы команд `.md`, директории с ними или объект-карта имени команды на `source` или `content`. Заменяет сканирование по умолчанию `commands/` |152| [`commands`](#commands) | Path, array of paths, or object | Плоские файлы команд `.md`, директории с ними или объект-карта имени команды на `source` или `content`. Заменяет сканирование по умолчанию `commands/` |

170 171

171Claude Code помещает каждый компонент в пространство имен под ним, поэтому агент `reviewer` в плагине `deploy-tools` появляется как `deploy-tools:reviewer`.172Claude Code помещает каждый компонент в пространство имен под ним, поэтому агент `reviewer` в плагине `deploy-tools` появляется как `deploy-tools:reviewer`.

172 173

174`claude plugin validate` также проверяет, что имя не проходит как один из собственных плагинов Anthropic. Проверка игнорирует регистр и рассматривает любой набор разделителей как один:

175

176| Имя | Результат |

177| :- | :- |

178| Начинается с `claude-`, `anthropic-`, `anthropics-` или `cc-plugin-` | Ошибка |

179| Это `claude`, `anthropic`, `anthropics`, `claude-code` или `claude-mods` | Ошибка |

180| Ставит `official` рядом с `claude` или `anthropic`, например `official-claude-tools` | Ошибка |

181| Имеет `claude`, `anthropic` или `anthropics` как целое слово где-либо еще, например `mcp-for-claude` | Предупреждение |

182

183Ошибка читается как `Plugin name "<name>" is reserved: it passes as one of Anthropic's own`, а предупреждение читается как `Plugin name "<name>" reads as one of Anthropic's own`. `claude plugin init` и `claude plugin tag` отказывают в имени, которое вызывает ошибку. Только эти команды проверяют имя. Claude Code все еще устанавливает и загружает плагин, имя которого они отказывают.

184

173<h3 id="displayname">185<h3 id="displayname">

174 `displayName`186 `displayName`

175</h3>187</h3>

plugins/marketplace-reference.md +2 −0

Details

487| `Plugin name "x" is reserved: it passes as one of Anthropic's own` | Ошибка | `plugins[i].name`. См. манифест [`name`](/docs/ru/plugins/manifest-reference#name) для зарезервированных имён |

488| `Plugin name "x" reads as one of Anthropic's own` | Предупреждение | `plugins[i].name` |

487| `Claude Code cannot install plugins from marketplace "x". Each part of a plugin id (plugin@marketplace) may use only the letters a-z and A-Z, digits, ".", "_" and "-", and must start with a letter or digit. Change the marketplace's "name".` | Ошибка | `name` |489| `Claude Code cannot install plugins from marketplace "x". Each part of a plugin id (plugin@marketplace) may use only the letters a-z and A-Z, digits, ".", "_" and "-", and must start with a letter or digit. Change the marketplace's "name".` | Ошибка | `name` |

488| `Claude Code cannot install plugin "x". Each part of a plugin id (plugin@marketplace) may use only the letters a-z and A-Z, digits, ".", "_" and "-", and must start with a letter or digit. Change this entry's "name".` | Ошибка | `plugins[i].name` |490| `Claude Code cannot install plugin "x". Each part of a plugin id (plugin@marketplace) may use only the letters a-z and A-Z, digits, ".", "_" and "-", and must start with a letter or digit. Change this entry's "name".` | Ошибка | `plugins[i].name` |

plugins/org.md +4 −1

Details

212| `pluginTrustMessage` | Добавляет ваш текст к предупреждению доверия, которое `/plugin` показывает перед установкой плагина | Не изменяет собственный текст предупреждения |212| `pluginTrustMessage` | Добавляет ваш текст к предупреждению доверия, которое `/plugin` показывает перед установкой плагина | Не изменяет собственный текст предупреждения |

213| `allowedChannelPlugins` | Заменяет список плагинов по умолчанию, разрешенных для отправки сообщений канала. Требует `channelsEnabled: true` | См. [Ограничить, какие плагины канала могут работать](/docs/ru/channels#restrict-which-channel-plugins-can-run) |213| `allowedChannelPlugins` | Заменяет список плагинов по умолчанию, разрешенных для отправки сообщений канала. Требует `channelsEnabled: true` | См. [Ограничить, какие плагины канала могут работать](/docs/ru/channels#restrict-which-channel-plugins-can-run) |

214| [`CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL=1`](/docs/ru/env-vars) | Останавливает интерактивные сессии терминала от автоматической регистрации официального marketplace | Не удаляет marketplace, уже зарегистрированный. Allowlist и blocklist управляют той же автоматической регистрацией без него. Машина, которая запустилась один раз с установленным, не возобновляет автоматическую регистрацию после того, как вы его отключите |214| [`CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL=1`](/docs/ru/env-vars) | Останавливает интерактивные сессии терминала от автоматической регистрации официального marketplace | Не удаляет marketplace, уже зарегистрированный. Allowlist и blocklist управляют той же автоматической регистрацией без него. Машина, которая запустилась один раз с установленным, не возобновляет автоматическую регистрацию после того, как вы его отключите |

215| [`allowManagedModsOnly`](/docs/ru/plugins/mods/admin#stop-user-installed-mods-from-loading) | Останавливает каждый установленный [mod](/docs/ru/plugins/mods/overview), который не [считается модом вашей организации](/docs/ru/plugins/mods/admin#install-your-organizations-mods), от загрузки | Не останавливает плагин, содержащий mod, от установки. Для этого используйте ключи marketplace в этой таблице |

215 216

216Каждый ключ в таблице является управляемым параметром, кроме `enabledPlugins`, `syncClaudeAiPlugins` и `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`:217Каждый ключ в таблице является управляемым параметром, кроме `enabledPlugins`, `syncClaudeAiPlugins`, `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` и `allowManagedModsOnly`:

217 218

218* **`enabledPlugins`**: вы можете установить его в любой области, и управляемые параметры его блокируют.219* **`enabledPlugins`**: вы можете установить его в любой области, и управляемые параметры его блокируют.

219* **`syncClaudeAiPlugins`**: каждый пользователь также может установить его в своих собственных пользовательских или локальных параметрах. См. его [область в справочнике параметров](/docs/ru/settings-reference#syncclaudeaiplugins).220* **`syncClaudeAiPlugins`**: каждый пользователь также может установить его в своих собственных пользовательских или локальных параметрах. См. его [область в справочнике параметров](/docs/ru/settings-reference#syncclaudeaiplugins).

220* **`CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`**: это переменная окружения, которую вы доставляете через управляемый блок `env`, показанный под [Отключить обновления для всего флота](#turn-updates-off-for-the-whole-fleet).221* **`CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`**: это переменная окружения, которую вы доставляете через управляемый блок `env`, показанный под [Отключить обновления для всего флота](#turn-updates-off-for-the-whole-fleet).

222* **`allowManagedModsOnly`**: это опция встроенного плагина, которую вы устанавливаете под `pluginConfigs` в управляемых параметрах. См. [Остановить загрузку пользовательских установленных mods](/docs/ru/plugins/mods/admin#stop-user-installed-mods-from-loading).

221 223

222Каждый ключ параметров здесь имеет запись в [справочнике параметров](/docs/ru/settings-reference).224Каждый ключ параметров здесь имеет запись в [справочнике параметров](/docs/ru/settings-reference).

223 225

457* [Marketplace reference](/docs/ru/plugins/marketplace-reference#marketplace-sources): значения `source`, которые `extraKnownMarketplaces`, `strictKnownMarketplaces` и `blockedMarketplaces` принимают459* [Marketplace reference](/docs/ru/plugins/marketplace-reference#marketplace-sources): значения `source`, которые `extraKnownMarketplaces`, `strictKnownMarketplaces` и `blockedMarketplaces` принимают

458* [Host and maintain a marketplace](/docs/ru/plugins/host-marketplace): запустите marketplace, на который указывает ваша политика460* [Host and maintain a marketplace](/docs/ru/plugins/host-marketplace): запустите marketplace, на который указывает ваша политика

459* [Plugin security and trust](/docs/ru/plugins/security): что плагин может делать на машине и как просмотреть один перед установкой461* [Plugin security and trust](/docs/ru/plugins/security): что плагин может делать на машине и как просмотреть один перед установкой

462* [Manage mods for your organization](/docs/ru/plugins/mods/admin): отключите или ограничьте mods, плагины, которые запускают JavaScript внутри Claude Code

460* [Server-managed settings](/docs/ru/server-managed-settings): доставляйте эти ключи из консоли администратора claude.ai463* [Server-managed settings](/docs/ru/server-managed-settings): доставляйте эти ключи из консоли администратора claude.ai

461* [Troubleshoot plugins](/docs/ru/plugins/troubleshooting#blocked-by-your-organization): сообщения, которые пользователи видят, когда политика их блокирует464* [Troubleshoot plugins](/docs/ru/plugins/troubleshooting#blocked-by-your-organization): сообщения, которые пользователи видят, когда политика их блокирует

plugins/overview.md +2 −1

Details

30* [**Skills**](/docs/ru/plugins/components#skills): инструкции `SKILL.md`, которые Claude загружает при необходимости, и которые вы также можете запустить как команду30* [**Skills**](/docs/ru/plugins/components#skills): инструкции `SKILL.md`, которые Claude загружает при необходимости, и которые вы также можете запустить как команду

31* [**Agents**](/docs/ru/plugins/components#agents): определения подагентов, которым Claude может делегировать31* [**Agents**](/docs/ru/plugins/components#agents): определения подагентов, которым Claude может делегировать

32* [**Hooks**](/docs/ru/plugins/components#hooks): команды, которые Claude Code запускает в точках своего жизненного цикла, например после каждого редактирования32* [**Hooks**](/docs/ru/plugins/components#hooks): команды, которые Claude Code запускает в точках своего жизненного цикла, например после каждого редактирования

33* [**A hooks module**](/docs/ru/plugins/mods/overview): hooks, написанные как функции JavaScript, которые также могут рисовать панели и добавлять команды. Plugin, который имеет один, называется mod

33* [**MCP servers**](/docs/ru/plugins/components#mcp-servers): серверы инструментов, к которым Claude Code подключается, пока plugin включен34* [**MCP servers**](/docs/ru/plugins/components#mcp-servers): серверы инструментов, к которым Claude Code подключается, пока plugin включен

34 35

35На этой диаграмме показан plugin с именем `my-plugin`, который содержит по одному из каждого из этих компонентов, и что вы получаете от каждого файла после загрузки plugin.36На этой диаграмме показан plugin с именем `my-plugin`, который содержит skill, agent, hooks и MCP server, и что вы получаете от каждого файла после загрузки plugin.

36 37

37<img src="https://mintcdn.com/claude-code/2Q_GtOEovg5qaBem/images/plugin-directory.svg?fit=max&auto=format&n=2Q_GtOEovg5qaBem&q=85&s=f623b64e82713b830e48174f0a922888" className="dark:hidden" alt="Диаграмма в двух столбцах, соединенных пятью прямыми стрелками. Слева — директория plugin с именем my-plugin, содержащая манифест в .claude-plugin/plugin.json, skills/review/SKILL.md, agents/reviewer.md, hooks/hooks.json, .mcp.json и другие компоненты. Справа — то, что каждый файл дает вам в вашем сеансе: манифест устанавливает имя plugin, my-plugin; skill запускается как /my-plugin:review; файл agent — это подагент, которому Claude может делегировать; файл hooks содержит hooks, которые запускаются на событиях жизненного цикла; и .mcp.json добавляет MCP server, который дает Claude инструменты." width="760" height="336" data-path="images/plugin-directory.svg" />38<img src="https://mintcdn.com/claude-code/2Q_GtOEovg5qaBem/images/plugin-directory.svg?fit=max&auto=format&n=2Q_GtOEovg5qaBem&q=85&s=f623b64e82713b830e48174f0a922888" className="dark:hidden" alt="Диаграмма в двух столбцах, соединенных пятью прямыми стрелками. Слева — директория plugin с именем my-plugin, содержащая манифест в .claude-plugin/plugin.json, skills/review/SKILL.md, agents/reviewer.md, hooks/hooks.json, .mcp.json и другие компоненты. Справа — то, что каждый файл дает вам в вашем сеансе: манифест устанавливает имя plugin, my-plugin; skill запускается как /my-plugin:review; файл agent — это подагент, которому Claude может делегировать; файл hooks содержит hooks, которые запускаются на событиях жизненного цикла; и .mcp.json добавляет MCP server, который дает Claude инструменты." width="760" height="336" data-path="images/plugin-directory.svg" />

38 39

plugins/security.md +2 −1

Details

29Плагин может содержать контент, который выполняет код на вашей машине с вашими привилегиями пользователя, и контент, который входит в контекст Claude в качестве инструкций, поэтому [перед установкой плагина его следует проверить](#review-a-plugin-before-you-install). Вот что может делать установленный плагин:29Плагин может содержать контент, который выполняет код на вашей машине с вашими привилегиями пользователя, и контент, который входит в контекст Claude в качестве инструкций, поэтому [перед установкой плагина его следует проверить](#review-a-plugin-before-you-install). Вот что может делать установленный плагин:

30 30

31* **Hooks**: [hooks](/docs/ru/hooks) плагина выполняются как команды shell в определённых точках жизненного цикла Claude Code, например до или после вызова инструмента.31* **Hooks**: [hooks](/docs/ru/hooks) плагина выполняются как команды shell в определённых точках жизненного цикла Claude Code, например до или после вызова инструмента.

32* **Mods**: [mod](/docs/ru/plugins/mods/overview) плагина выполняет JavaScript внутри Claude Code с вашими разрешениями. Чтобы увидеть, что делает mod перед установкой, см. [Решите, доверять ли mod](/docs/ru/plugins/mods/overview#decide-whether-to-trust-a-mod).

32* **MCP и LSP серверы**: Claude Code подключается к [MCP серверам](/docs/ru/mcp), которые объявляет включённый плагин, и предоставляет Claude их инструменты. Stdio MCP сервер работает как процесс, который Claude Code запускает на вашей машине. Claude Code также запускает языковые серверы, которые объявляет плагин.33* **MCP и LSP серверы**: Claude Code подключается к [MCP серверам](/docs/ru/mcp), которые объявляет включённый плагин, и предоставляет Claude их инструменты. Stdio MCP сервер работает как процесс, который Claude Code запускает на вашей машине. Claude Code также запускает языковые серверы, которые объявляет плагин.

33* **`bin/` директория**: Claude Code добавляет директорию `bin/` каждого включённого плагина в `PATH` shell инструмента Bash, поэтому команды Bash от Claude могут запускать любой исполняемый файл там.34* **`bin/` директория**: Claude Code добавляет директорию `bin/` каждого включённого плагина в `PATH` shell инструмента Bash, поэтому команды Bash от Claude могут запускать любой исполняемый файл там.

34* **Skills, команды и агенты**: они входят в контекст Claude в качестве инструкций, поэтому они влияют на то, что Claude делает с инструментами, которые у него уже есть.35* **Skills, команды и агенты**: они входят в контекст Claude в качестве инструкций, поэтому они влияют на то, что Claude делает с инструментами, которые у него уже есть.

37[Правила разрешений](/docs/ru/permissions) Claude Code и [sandbox](/docs/ru/sandboxing) охватывают вызовы инструментов, которые делает Claude, а не код, который плагин запускает самостоятельно:38[Правила разрешений](/docs/ru/permissions) Claude Code и [sandbox](/docs/ru/sandboxing) охватывают вызовы инструментов, которые делает Claude, а не код, который плагин запускает самостоятельно:

38 39

39* **Hooks и серверные процессы**: command hooks выполняют команды shell с вашими полными привилегиями пользователя. Claude Code запускает hooks и MCP серверы вне sandbox.40* **Hooks и серверные процессы**: command hooks выполняют команды shell с вашими полными привилегиями пользователя. Claude Code запускает hooks и MCP серверы вне sandbox.

40* **Вызовы инструментов Claude**: вызов одного из инструментов MCP плагина и команда Bash, которая запускает исполняемый файл из `bin/` плагина, являются вызовами инструментов, поэтому к ним применяются ваши правила разрешений.41* **Вызовы инструментов Claude**: вызов одного из инструментов MCP плагина и команда Bash, которая запускает исполняемый файл из `bin/` плагина, являются вызовами инструментов, поэтому к ним применяются ваши правила разрешений. Чтобы узнать, что mod может делать с вызовом инструмента, см. [Решите, доверять ли mod](/docs/ru/plugins/mods/overview#decide-whether-to-trust-a-mod).

41 42

42Установка плагина также включает его, если только его манифест или запись маркетплейса не устанавливают [`defaultEnabled: false`](/docs/ru/plugins/install#choose-an-install-scope) и вы сами его не включили.43Установка плагина также включает его, если только его манифест или запись маркетплейса не устанавливают [`defaultEnabled: false`](/docs/ru/plugins/install#choose-an-install-scope) и вы сами его не включили.

43 44

plugins/troubleshooting.md +41 −2

Details

201 201

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

203 203

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

205 `Invalid git URL`

206</h3>

207

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

209

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

211

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

213

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

215

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

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

206</h3>218</h3>

410 422

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

412 424

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

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

427</h3>

428

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

430

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

432

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

434

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

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

437

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

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

415</h3>440</h3>

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

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

792 817

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

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

820</h4>

821

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

823

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

825

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

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

795</h4>828</h4>

934 967

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

936 969

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

938 971

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

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

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

941 975

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

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

946```980```

947 981

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

983

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

949 985

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

951 987

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

989

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

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

954</h3>992</h3>

968| `Path contains ".." which could be a path traversal attempt: <path>` | Путь компонента выходит за пределы каталога плагина. | Используйте пути внутри корня плагина. |1006| `Path contains ".." which could be a path traversal attempt: <path>` | Путь компонента выходит за пределы каталога плагина. | Используйте пути внутри корня плагина. |

969| `Path is a file; skills entries must be directories containing SKILL.md` | Запись `skills` указывает на `SKILL.md` вместо его каталога. | Укажите на родительский каталог или `.` для `SKILL.md` на уровне корня. |1007| `Path is a file; skills entries must be directories containing SKILL.md` | Запись `skills` указывает на `SKILL.md` вместо его каталога. | Укажите на родительский каталог или `.` для `SKILL.md` на уровне корня. |

970| `No frontmatter block found` или `YAML frontmatter failed to parse: <error>` | Файл skill, агента или команды имеет отсутствующий или недействительный YAML frontmatter. | Добавьте или исправьте frontmatter между разделителями `---`. Сообщается при валидации каталога плагина. |1008| `No frontmatter block found` или `YAML frontmatter failed to parse: <error>` | Файл skill, агента или команды имеет отсутствующий или недействительный YAML frontmatter. | Добавьте или исправьте frontmatter между разделителями `---`. Сообщается при валидации каталога плагина. |

1009| `Plugin name "<name>" is reserved: it passes as one of Anthropic's own` | Имя плагина `name` является одним из [зарезервированных имён](/docs/ru/plugins/manifest-reference#name). | Переименуйте плагин в соответствии с его функциональностью. |

971| `Unknown field '<key>'` | Манифест имеет поле, которое схема не определяет. | Удалите его или используйте имя, которое предлагает сообщение. Claude Code игнорирует неизвестные поля во время загрузки. |1010| `Unknown field '<key>'` | Манифест имеет поле, которое схема не определяет. | Удалите его или используйте имя, которое предлагает сообщение. Claude Code игнорирует неизвестные поля во время загрузки. |

972 1011

973Запустите команду снова после каждого исправления до тех пор, пока она не выведет никаких ошибок.1012Запустите команду снова после каждого исправления до тех пор, пока она не выведет никаких ошибок.

scheduled-tasks.md +1 −1

Details

84<span id="loop-provider-differences" />84<span id="loop-provider-differences" />

85 85

86<Note>86<Note>

87 Динамически выбранные интервалы и [встроенная подсказка обслуживания](#run-the-built-in-maintenance-prompt) работают на каждом поставщике и с [получением флага функции](/docs/ru/env-vars#features-that-need-feature-flag-fetching) отключенным. На Amazon Bedrock, Claude Platform на AWS, Google Cloud's Agent Platform и Microsoft Foundry, или с отключенным получением, оба требуют Claude Code v2.1.248 или позже. В этих случаях на более ранних версиях подсказка без интервала запускается по фиксированному расписанию в 10 минут, а `/loop` без подсказки выводит сообщение об использовании.87 Динамически выбранные интервалы и [встроенная подсказка обслуживания](#run-the-built-in-maintenance-prompt) работают на каждом поставщике и с [получением флага функции](/docs/ru/env-vars#features-that-need-feature-flag-fetching) отключенным. На Amazon Bedrock, Claude Platform на AWS, Google Cloud's Agent Platform и Microsoft Foundry, или с отключенным получением, оба требуют Claude Code v2.1.248 или позже.

88</Note>88</Note>

89 89

90<h3 id="run-the-built-in-maintenance-prompt">90<h3 id="run-the-built-in-maintenance-prompt">

self-hosted-environments.md +1 −1

Details

87Runner служит одному владельцу за раз. Первый сеанс, который runner берёт в работу, закрепляет runner за владельцем этого сеанса, и runner затем запускает сеансы только для этого владельца, до настроенной емкости. Кто владелец, зависит от того, как был запущен сеанс:87Runner служит одному владельцу за раз. Первый сеанс, который runner берёт в работу, закрепляет runner за владельцем этого сеанса, и runner затем запускает сеансы только для этого владельца, до настроенной емкости. Кто владелец, зависит от того, как был запущен сеанс:

88 88

89* **Сеансы, запущенные пользователем**: владелец — это учетная запись этого пользователя.89* **Сеансы, запущенные пользователем**: владелец — это учетная запись этого пользователя.

90* **Сеансы канала Claude Tag**: Claude запускает их без прикрепленной учетной записи пользователя, поэтому владелец — это [агент Claude Tag](https://claude.com/docs/claude-tag/concepts/glossary#agent-identity), который запустил сеанс. Каждый сеанс канала, который запускает этот агент, имеет одного владельца, кто бы ни отправил сообщение Slack, поэтому runner, закреплённый за ним, обслуживает сеансы, которые разные люди запустили, когда вы запускаете его с `--capacity` выше одного или с положительным `--drain-grace-sec`. Runner, закреплённый за пользователем, никогда не берёт эти сеансы, а runner, закреплённый за агентом Claude Tag, никогда не берёт сеансы пользователя.90* **Сеансы канала Claude Tag**: Claude запускает их без прикрепленной учетной записи пользователя, поэтому владелец — это [агент Claude Tag](https://claude.com/docs/claude-tag/concepts/glossary#agent-identity), который запустил сеанс. Каждый сеанс канала, который запускает этот агент, имеет одного владельца, кто бы ни отправил сообщение Slack, поэтому runner, закреплённый за ним, обслуживает сеансы, которые разные люди запустили, когда вы запускаете его с `--capacity` выше одного или с положительным `--drain-grace-sec`.

91 91

92Минимальный размер флота — это количество владельцев, которых вы ожидаете быть активными одновременно, считая пользователей и агентов Claude Tag.92Минимальный размер флота — это количество владельцев, которых вы ожидаете быть активными одновременно, считая пользователей и агентов Claude Tag.

93 93

server-managed-settings.md +2 −1

Details

163 Исключения для отдельных ключей в управляемых источниках163 Исключения для отдельных ключей в управляемых источниках

164</h3>164</h3>

165 165

166Три вида ключей являются исключениями из правила отсутствия объединения:166Эти ключи являются исключениями из правила отсутствия объединения:

167 167

168* **Ключи блокировки между источниками**: небольшой набор ключей, таких как блокировки списка разрешений песочницы, [указанные на странице управляемых параметров](/docs/ru/managed-settings#precedence-within-the-managed-tier). Claude Code соблюдает их, когда любой управляемый администратором источник их устанавливает; уровень реестра HKCU, доступный для записи пользователем, исключен.168* **Ключи блокировки между источниками**: небольшой набор ключей, таких как блокировки списка разрешений песочницы, [указанные на странице управляемых параметров](/docs/ru/managed-settings#precedence-within-the-managed-tier). Claude Code соблюдает их, когда любой управляемый администратором источник их устанавливает; уровень реестра HKCU, доступный для записи пользователем, исключен.

169 169

171* **Блок `env`**: помимо единицы телеметрии и переменных маршрутизации, связанных с ключом учетных данных, оба рассмотрены ниже, он объединяется по ключам в управляемых администратором источниках. Для каждой переменной окружения источник с наивысшим приоритетом, определяющий ее, побеждает, а источники администратора с более низким приоритетом заполняют переменные, которые источники с более высоким приоритетом оставляют неустановленными. Запись `env`, управляемая конечной точкой, поэтому применяется всякий раз, когда конфигурация управляемых сервером параметров оставляет эту переменную неустановленной, или пока кэшированное значение сервера для нее [удерживается в ожидании подтверждения сервером](#fetch-and-caching-behavior). Требуется Claude Code v2.1.223 или более поздняя версия. До v2.1.223 Claude Code применяет только весь блок `env` выбранного источника.171* **Блок `env`**: помимо единицы телеметрии и переменных маршрутизации, связанных с ключом учетных данных, оба рассмотрены ниже, он объединяется по ключам в управляемых администратором источниках. Для каждой переменной окружения источник с наивысшим приоритетом, определяющий ее, побеждает, а источники администратора с более низким приоритетом заполняют переменные, которые источники с более высоким приоритетом оставляют неустановленными. Запись `env`, управляемая конечной точкой, поэтому применяется всякий раз, когда конфигурация управляемых сервером параметров оставляет эту переменную неустановленной, или пока кэшированное значение сервера для нее [удерживается в ожидании подтверждения сервером](#fetch-and-caching-behavior). Требуется Claude Code v2.1.223 или более поздняя версия. До v2.1.223 Claude Code применяет только весь блок `env` выбранного источника.

172 * **Единица телеметрии**: ключи экспортера `OTEL_EXPORTER_OTLP_*`, переключатели захвата содержимого `OTEL_LOG_*`, `OTEL_LOGS_EXPORTER` и бета-переменные трассировки `ENABLE_BETA_TRACING_DETAILED` и `BETA_TRACING_ENDPOINT` следуют источнику с наивысшим приоритетом, который устанавливает любой из них как единицу. Источник, который доставляет ключ учетных данных `otelHeadersHelper`, также претендует на единицу, но размещает эти переменные только когда он является выбранным источником: источник, который не выбран, но доставляет ключ, не вносит ни один из них и все еще блокирует более низкие источники от их заполнения. В любом случае конечная точка экспортера из одного источника никогда не может быть связана с учетными данными из другого.172 * **Единица телеметрии**: ключи экспортера `OTEL_EXPORTER_OTLP_*`, переключатели захвата содержимого `OTEL_LOG_*`, `OTEL_LOGS_EXPORTER` и бета-переменные трассировки `ENABLE_BETA_TRACING_DETAILED` и `BETA_TRACING_ENDPOINT` следуют источнику с наивысшим приоритетом, который устанавливает любой из них как единицу. Источник, который доставляет ключ учетных данных `otelHeadersHelper`, также претендует на единицу, но размещает эти переменные только когда он является выбранным источником: источник, который не выбран, но доставляет ключ, не вносит ни один из них и все еще блокирует более низкие источники от их заполнения. В любом случае конечная точка экспортера из одного источника никогда не может быть связана с учетными данными из другого.

173 * **Маршрутизация с привязкой к учетным данным**: источник, который связывает переменные маршрутизации с ключом учетных данных, доступным только для выбранного источника, такой как `apiKeyHelper` или `otelHeadersHelper`, вносит эти переменные маршрутизации только когда он выигрывает слот.173 * **Маршрутизация с привязкой к учетным данным**: источник, который связывает переменные маршрутизации с ключом учетных данных, доступным только для выбранного источника, такой как `apiKeyHelper` или `otelHeadersHelper`, вносит эти переменные маршрутизации только когда он выигрывает слот.

174* **`allowedProviders`**: список, установленный на машине, и список, управляемый сервером, объединяются как [указано в примечании Scope этой записи](/docs/ru/settings-reference#allowedproviders). Требуется Claude Code v2.1.285 или более поздняя версия

174* **Ключи входа в шлюз**: Claude Code никогда не читает [`forceLoginGatewayUrl`](/docs/ru/settings-reference#forcelogingatewayurl), [`gatewayInternalNetworks`](/docs/ru/settings-reference#gatewayinternalnetworks) или значение `"gateway"` [`forceLoginMethod`](/docs/ru/settings-reference#forceloginmethod) из управляемых сервером параметров, поэтому значение там ни не применяется, ни не скрывает значение, установленное в политике MDM или файле управляемых параметров. Запись [`managedSourcesBehavior`](/docs/ru/settings-reference#managedsourcesbehavior) указывает, какой источник администратора на машине их предоставляет.175* **Ключи входа в шлюз**: Claude Code никогда не читает [`forceLoginGatewayUrl`](/docs/ru/settings-reference#forcelogingatewayurl), [`gatewayInternalNetworks`](/docs/ru/settings-reference#gatewayinternalnetworks) или значение `"gateway"` [`forceLoginMethod`](/docs/ru/settings-reference#forceloginmethod) из управляемых сервером параметров, поэтому значение там ни не применяется, ни не скрывает значение, установленное в политике MDM или файле управляемых параметров. Запись [`managedSourcesBehavior`](/docs/ru/settings-reference#managedsourcesbehavior) указывает, какой источник администратора на машине их предоставляет.

175 176

176<h3 id="fetch-and-caching-behavior">177<h3 id="fetch-and-caching-behavior">

sessions.md +20 −2

Details

29 29

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

31 31

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

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

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

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

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

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

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

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

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

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

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

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

33 51

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

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

36</h3>54</h3>

37 55

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

39 57

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

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

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

52</h4>70</h4>

53 71

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

55 73

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

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

settings-reference.md +223 −130

Details

599| [`allowedChannelPlugins`](#allowedchannelplugins) | Замените список разрешений по умолчанию для [плагинов канала](/docs/ru/channels#restrict-which-channel-plugins-can-run), которые могут отправлять сообщения | Plugins and skills | Managed |599| [`allowedChannelPlugins`](#allowedchannelplugins) | Замените список разрешений по умолчанию для [плагинов канала](/docs/ru/channels#restrict-which-channel-plugins-can-run), которые могут отправлять сообщения | Plugins and skills | Managed |

604| [`allowManagedPermissionRulesOnly`](#allowmanagedpermissionrulesonly) | Сделайте [управляемые параметры](/docs/ru/managed-settings) единственным источником параметров для [правил разрешений](/docs/ru/permissions#managed-settings) | Permission settings | Managed |605| [`allowManagedPermissionRulesOnly`](#allowmanagedpermissionrulesonly) | Сделайте [управляемые параметры](/docs/ru/managed-settings) единственным источником параметров для [правил разрешений](/docs/ru/permissions#managed-settings) | Permission settings | Managed |

607| [`askUserQuestionTimeout`](#askuserquestiontimeout) | Позвольте неотвеченному вопросу [автоматически продолжиться](/docs/ru/tools-reference#question-auto-continue-timeout) после времени простоя | Interface and terminal | User or managed |608| [`askUserQuestionTimeout`](#askuserquestiontimeout) | Позвольте неотвеченному вопросу [автоматически продолжиться](/docs/ru/tools-reference#question-auto-continue-timeout) после времени простоя | Interface and terminal | User or managed |

729| [`policyHelper.timeoutMs`](#policyhelper-timeoutms) | Установите, как долго Claude Code ждёт [помощника](/docs/ru/managed-settings#compute-the-policy-with-a-helper-program) | Enterprise and managed settings | Managed |731| [`policyHelper.timeoutMs`](#policyhelper-timeoutms) | Установите, как долго Claude Code ждёт [помощника](/docs/ru/managed-settings#compute-the-policy-with-a-helper-program) | Enterprise and managed settings | Managed |

730| [`preferredNotifChannel`](#preferrednotifchannel) | Выберите [звонок терминала или уведомление рабочего стола](/docs/ru/terminal-config#get-a-terminal-bell-or-notification) для завершения задачи | Remote, desktop, and notifications | Any file |732| [`preferredNotifChannel`](#preferrednotifchannel) | Выберите [звонок терминала или уведомление рабочего стола](/docs/ru/terminal-config#get-a-terminal-bell-or-notification) для завершения задачи | Remote, desktop, and notifications | Any file |

732| [`processWrapper`](#processwrapper) | Запускайте фоновые процессы Claude Code через [корпоративный запускатель](/docs/ru/corporate-launcher) на macOS и Linux | Agents, sessions, and worktrees | User or managed |735| [`processWrapper`](#processwrapper) | Запускайте фоновые процессы Claude Code через [корпоративный запускатель](/docs/ru/corporate-launcher) на macOS и Linux | Agents, sessions, and worktrees | User or managed |

3203 `askUserQuestionTimeout`3206 `askUserQuestionTimeout`

3204</h3>3207</h3>

3205 3208

3206Позвольте диалогу [`AskUserQuestion`](/docs/ru/tools-reference) без ответа автоматически продолжить работу после периода простоя, отправив любые уже выбранные вами параметры. Установите это, когда вы отходите и хотите, чтобы Claude продолжал работу без вас. По умолчанию вопросы ждут, пока вы на них ответите. Требуется Claude Code v2.1.200 или позже.3209Позвольте диалогу [`AskUserQuestion`](/docs/ru/tools-reference) без ответа автоматически продолжить работу после периода неактивности, отправив любые уже выбранные вами параметры. Установите это значение, когда вы отходите и хотите, чтобы Claude продолжил работу без вас. По умолчанию вопросы ждут, пока вы на них ответите. Требуется Claude Code v2.1.200 или более поздняя версия.

3207 3210

3208* **Область действия**: [`Пользователь или управляемый`](#scopes)3211* **Область действия**: [`User or managed`](#scopes)

3209* **Тип**: строка, одна из `"60s"`, `"5m"`, `"10m"` или `"never"`3212* **Тип**: строка, одно из значений `"60s"`, `"5m"`, `"10m"` или `"never"`

3210* **По умолчанию**: `"never"`3213* **По умолчанию**: `"never"`

3211* **Переопределения для каждого сеанса**: [`CLAUDE_AFK_TIMEOUT_MS`](/docs/ru/env-vars) имеет приоритет над этим ключом для одного сеанса3214* **Переопределения для отдельного сеанса**: [`CLAUDE_AFK_TIMEOUT_MS`](/docs/ru/env-vars) имеет приоритет над этим ключом для одного сеанса

3212 3215

3213```json settings.json theme={null}3216```json settings.json theme={null}

3214{3217{

3216}3219}

3217```3220```

3218 3221

3219Появляется в `/config` как **Question auto-continue timeout**, который записывает этот ключ в пользовательские параметры; Claude Code скрывает строку, пока управляемые параметры или флаг `--settings` устанавливают ключ. Требуется Claude Code v2.1.200 или позже.3222Появляется в `/config` как **Question auto-continue timeout**, который записывает этот ключ в пользовательские параметры; Claude Code скрывает строку, пока управляемые параметры или флаг `--settings` устанавливают ключ. Требуется Claude Code v2.1.200 или более поздняя версия.

3220 3223

3221<h3 id="autocontinueatusagelimit">3224<h3 id="autocontinueatusagelimit">

3222 `autoContinueAtUsageLimit`3225 `autoContinueAtUsageLimit`

3223</h3>3226</h3>

3224 3227

3225После того как лимит использования claude.ai остановит ваш сеанс, ждите в открытом сеансе и продолжайте задачу автоматически после сброса. См. [Отключение автоматического продолжения](/docs/ru/interactive-mode#turn-automatic-continue-off). Требуется Claude Code v2.1.234 или позже.3228После того как лимит использования claude.ai остановит ваш сеанс, ждите в открытом сеансе и автоматически продолжите задачу после сброса. См. [Отключение автоматического продолжения](/docs/ru/interactive-mode#turn-automatic-continue-off). Требуется Claude Code v2.1.234 или более поздняя версия.

3226 3229

3227* **Область действия**: [`Пользователь или управляемый`](#scopes). Читается из пользовательских параметров, `--settings` и управляемых параметров только. Когда ни один из них не устанавливает ключ, файл параметров проекта или локальный файл, который его устанавливает, отключает функцию, а не игнорируется.3230* **Область действия**: [`User or managed`](#scopes). Читается из пользовательских параметров, `--settings` и управляемых параметров только. Когда ни один из них не устанавливает ключ, файл параметров проекта или локальных параметров, который его устанавливает, отключает функцию, а не игнорируется.

3228* **Тип**: Boolean3231* **Тип**: Boolean

3229 * `true`: после того как лимит использования claude.ai остановит ваш сеанс, Claude Code ждет в открытом сеансе и продолжает задачу автоматически после сброса3232 * `true`: после того как лимит использования claude.ai остановит ваш сеанс, Claude Code ждет в открытом сеансе и автоматически продолжает задачу после сброса

3230 * `false`: Claude Code не запускает ожидание самостоятельно. Вы все еще можете [начать ожидание самостоятельно](/docs/ru/interactive-mode#start-a-wait-yourself) из меню параметров лимита использования3233 * `false`: Claude Code не запускает ожидание самостоятельно. Вы все еще можете [начать ожидание самостоятельно](/docs/ru/interactive-mode#start-a-wait-yourself) из меню параметров лимита использования

3231* **По умолчанию**: `true`3234* **По умолчанию**: `true`

3232 3235

3242 `autoScrollEnabled`3245 `autoScrollEnabled`

3243</h3>3246</h3>

3244 3247

3245Следите за новым выводом в конце разговора в [полноэкранном режиме](/docs/ru/fullscreen). Отключите это, чтобы остаться там, где вы прокручивали, пока Claude продолжает работать; подсказки разрешений все еще прокручиваются в поле зрения.3248Следите за новым выводом в конце разговора при [полноэкранном отображении](/docs/ru/fullscreen). Отключите это, чтобы остаться там, где вы прокручивали, пока Claude продолжает работу; подсказки разрешений все еще прокручиваются в поле зрения.

3246 3249

3247* **Область действия**: [`Любой файл`](#scopes)3250* **Область действия**: [`Any file`](#scopes)

3248* **Тип**: Boolean3251* **Тип**: Boolean

3249 * `true`: разговор следует за новым выводом в конец3252 * `true`: разговор следует за новым выводом в конец

3250 * `false`: вы остаетесь там, где вы прокручивали, пока Claude продолжает работать; подсказки разрешений все еще появляются ниже стенограммы3253 * `false`: вы остаетесь там, где вы прокручивали, пока Claude продолжает работу; подсказки разрешений все еще появляются ниже стенограммы

3251* **По умолчанию**: `true`3254* **По умолчанию**: `true`

3252 3255

3253```json settings.json theme={null}3256```json settings.json theme={null}

3256}3259}

3257```3260```

3258 3261

3259Появляется в `/config` как **Auto-scroll**, когда полноэкранный режим включен, который записывает этот ключ в пользовательские параметры.3262Появляется в `/config` как **Auto-scroll**, когда включено полноэкранное отображение, которое записывает этот ключ в пользовательские параметры.

3260 3263

3261<h3 id="axscreenreader">3264<h3 id="axscreenreader">

3262 `axScreenReader`3265 `axScreenReader`

3263</h3>3266</h3>

3264 3267

3265Отрисовка вывода, удобного для программ чтения с экрана: плоский текст без декоративных границ или анимаций. Режим программы чтения с экрана использует классический рендерер, поэтому параметр `tui` не имеет эффекта, пока он активен; прикрепленные [фоновые сеансы](/docs/ru/agent-view) все еще отрисовываются в полноэкранном режиме.3268Отображайте вывод, удобный для программ чтения с экрана: плоский текст без декоративных границ или анимации. Режим программы чтения с экрана использует классический рендерер, поэтому параметр `tui` не имеет эффекта, пока он активен; прикрепленные [фоновые сеансы](/docs/ru/agent-view) все еще отображаются в полноэкранном режиме.

3266 3269

3267* **Область действия**: [`Любой файл`](#scopes)3270* **Область действия**: [`Any file`](#scopes)

3268* **Тип**: Boolean3271* **Тип**: Boolean

3269 * `true`: Claude Code отрисовывает плоский текст без декоративных границ или анимаций, используя классический рендерер3272 * `true`: Claude Code отображает плоский текст без декоративных границ или анимации, используя классический рендерер

3270 * `false`: Claude Code отрисовывает нормально3273 * `false`: Claude Code отображается нормально

3271* **По умолчанию**: не установлено, поэтому режим программы чтения с экрана отключен3274* **По умолчанию**: не установлено, поэтому режим программы чтения с экрана отключен

3272* **Переопределения для каждого сеанса**: [`--ax-screen-reader`](/docs/ru/cli-reference#cli-flags) имеет приоритет над [`CLAUDE_AX_SCREEN_READER`](/docs/ru/env-vars), и оба имеют приоритет над этим ключом для одного сеанса3275* **Переопределения для отдельного сеанса**: [`--ax-screen-reader`](/docs/ru/cli-reference#cli-flags) имеет приоритет над [`CLAUDE_AX_SCREEN_READER`](/docs/ru/env-vars), и оба имеют приоритет над этим ключом для одного сеанса

3273 3276

3274```json settings.json theme={null}3277```json settings.json theme={null}

3275{3278{

3283 3286

3284Выберите, записывает ли Claude Code, какие файлы изменились в репозитории Git, пока выполняется команда Bash. Когда он их записывает, вы видите их diff в терминале после команды, и ваши [PostToolUse Bash hooks](/docs/ru/hooks#bash) получают список измененных файлов.3287Выберите, записывает ли Claude Code, какие файлы изменились в репозитории Git, пока выполняется команда Bash. Когда он их записывает, вы видите их diff в терминале после команды, и ваши [PostToolUse Bash hooks](/docs/ru/hooks#bash) получают список измененных файлов.

3285 3288

3286Указанный файл не всегда является тем, который команда изменила. Изменение, которое другая программа или другой вызов Bash сделали, пока команда выполнялась, может появиться там тоже.3289Указанный файл не всегда является файлом, который команда изменила. Изменение, которое другая программа или другой вызов Bash сделали во время выполнения команды, может также появиться там.

3287 3290

3288Установите ключ на `true`, чтобы записывать их в каждом режиме разрешений. Требуется Claude Code v2.1.269 или позже.3291Установите ключ на `true`, чтобы записывать их в каждом режиме разрешений. Требуется Claude Code v2.1.269 или более поздняя версия.

3289 3292

3290* **Область действия**: [`Пользователь или управляемый`](#scopes). `true` считается только из ваших пользовательских параметров, JSON, переданного с `--settings`, или [управляемых параметров](/docs/ru/managed-settings), поэтому `true` в `.claude/settings.json` или `.claude/settings.local.json` репозитория не может включить запись. `false` в любом файле репозитория все еще отключает его, если файл с [более высоким приоритетом](/docs/ru/settings#settings-precedence) не устанавливает `true`.3293* **Область действия**: [`User or managed`](#scopes). `true` считается только из ваших пользовательских параметров, JSON, переданного с `--settings`, или [управляемых параметров](/docs/ru/managed-settings), поэтому `true` в файле `.claude/settings.json` или `.claude/settings.local.json` репозитория не может включить запись. `false` в любом файле репозитория все еще отключает его, если только файл с [более высоким приоритетом](/docs/ru/settings#settings-precedence) не устанавливает `true`.

3291* **Тип**: Boolean3294* **Тип**: Boolean

3292* **По умолчанию**: не установлено, поэтому Claude Code записывает изменения в режиме auto и режиме `bypassPermissions`, когда он направляет Claude на редактирование файлов через Bash3295* **По умолчанию**: не установлено, поэтому Claude Code записывает изменения в режиме auto и режиме `bypassPermissions`, когда он направляет Claude на редактирование файлов через Bash

3293* **Переопределения для каждого сеанса**: [`CLAUDE_CODE_BASH_EDIT_DIFF`](/docs/ru/env-vars) имеет приоритет над этим ключом для одного сеанса3296* **Переопределения для отдельного сеанса**: [`CLAUDE_CODE_BASH_EDIT_DIFF`](/docs/ru/env-vars) имеет приоритет над этим ключом для одного сеанса

3294 3297

3295```json settings.json theme={null}3298```json settings.json theme={null}

3296{3299{

3304 3307

3305Показывайте объявления вашей организации пользователям при запуске. Когда вы указываете более одного, Claude Code выбирает один случайно для каждого сеанса; при первом запуске человека он показывает первую запись.3308Показывайте объявления вашей организации пользователям при запуске. Когда вы указываете более одного, Claude Code выбирает один случайно для каждого сеанса; при первом запуске человека он показывает первую запись.

3306 3309

3307* **Область действия**: [`Любой файл`](#scopes)3310* **Область действия**: [`Any file`](#scopes)

3308* **Тип**: массив строк3311* **Тип**: массив строк

3309* **По умолчанию**: не установлено, поэтому объявление не показывается3312* **По умолчанию**: не установлено, поэтому объявление не отображается

3310 3313

3311```json settings.json theme={null}3314```json settings.json theme={null}

3312{3315{

3322 3325

3323Выберите, запускается ли Bash или PowerShell команды оболочки, которые вы вводите с префиксом [`!`](/docs/ru/interactive-mode#shell-mode-with-prefix) в поле ввода, те, которые Claude Code запускает напрямую и добавляет в сеанс.3326Выберите, запускается ли Bash или PowerShell команды оболочки, которые вы вводите с префиксом [`!`](/docs/ru/interactive-mode#shell-mode-with-prefix) в поле ввода, те, которые Claude Code запускает напрямую и добавляет в сеанс.

3324 3327

3325`"powershell"` работает только при включенном [инструменте PowerShell](/docs/ru/tools-reference#powershell-tool). Инструмент включен по умолчанию на Windows без Git Bash и на Windows с Git Bash для учетных записей claude.ai и Console. В сеансах Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, а также на macOS, Linux и WSL установите `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`, чтобы включить инструмент. Установите эту переменную на `0`, чтобы отключить инструмент.3328`"powershell"` работает только при включенном [инструменте PowerShell](/docs/ru/tools-reference#powershell-tool). Инструмент включен по умолчанию в Windows без Git Bash и в Windows с Git Bash для учетных записей claude.ai и Console. В сеансах Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, а также на macOS, Linux и WSL установите `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`, чтобы включить инструмент. Установите эту переменную на `0`, чтобы отключить инструмент.

3326 3329

3327* **Область действия**: [`Любой файл`](#scopes)3330* **Область действия**: [`Any file`](#scopes)

3328* **Тип**: строка, одна из:3331* **Тип**: строка, одно из:

3329 * `"bash"`: Claude Code запускает ваши команды `!` в Bash3332 * `"bash"`: Claude Code запускает ваши команды `!` в Bash

3330 * `"powershell"`: Claude Code запускает ваши команды `!` в PowerShell3333 * `"powershell"`: Claude Code запускает ваши команды `!` в PowerShell

3331* **По умолчанию**: `"bash"` или `"powershell"` на Windows, когда Bash недоступен3334* **По умолчанию**: `"bash"`, или `"powershell"` в Windows, когда Bash недоступен

3332 3335

3333```json settings.json theme={null}3336```json settings.json theme={null}

3334{3337{

3336}3339}

3337```3340```

3338 3341

3339Если оболочка, которую вы назвали, недоступна, Claude Code использует другую: `"powershell"` возвращается к Bash, когда инструмент PowerShell отключен, и `"bash"` возвращается к PowerShell, когда Bash не установлен.3342Если названная вами оболочка недоступна, Claude Code использует другую: `"powershell"` возвращается к Bash, когда инструмент PowerShell отключен, и `"bash"` возвращается к PowerShell, когда Bash не установлен.

3340 3343

3341<h3 id="dialogexpiry">3344<h3 id="dialogexpiry">

3342 `dialogExpiry`3345 `dialogExpiry`

3343</h3>3346</h3>

3344 3347

3345Установите крайний срок для диалогов, которые Claude Code [пересылает удаленному клиенту](/docs/ru/remote-control#limitations), такому как хост Remote Control или SDK, и для диалога одобрения [удерживаемого кросссеансового сообщения](/docs/ru/cross-session-messaging#control-inbound-messages). На Claude Code v2.1.236 или позже тот же крайний срок ограничивает подсказку согласия на использование кредитов Fable в середине сеанса]\(/ru/model-config#fable-and-usage-credits) в сеансе, в котором может никого не быть у терминала. Когда ответ не поступает до крайнего срока, Claude Code отменяет диалог и продолжает с его действием по умолчанию без действия. Требуется Claude Code v2.1.224 или позже.3348Установите крайний срок для диалогов, которые Claude Code [пересылает удаленному клиенту](/docs/ru/remote-control#limitations), такому как хост Remote Control или SDK, и для диалога одобрения [удерживаемого кросс-сеансового сообщения](/docs/ru/cross-session-messaging#control-inbound-messages). На Claude Code v2.1.236 или более поздней версии тот же крайний срок ограничивает подсказку согласия на использование кредитов Fable в середине сеанса]\(/ru/model-config#fable-and-usage-credits) в сеансе, в котором может никого не быть у терминала. Когда ответ не поступает до крайнего срока, Claude Code отменяет диалог и продолжает с его действием по умолчанию без действия. Требуется Claude Code v2.1.224 или более поздняя версия.

3346 3349

3347* **Область действия**: [`Пользователь или управляемый`](#scopes)3350* **Область действия**: [`User or managed`](#scopes)

3348* **Тип**: строка, одна из `"60s"`, `"5m"`, `"10m"` или `"never"`, что отключает крайний срок3351* **Тип**: строка, одно из `"60s"`, `"5m"`, `"10m"` или `"never"`, что отключает крайний срок

3349* **По умолчанию**: `"5m"`3352* **По умолчанию**: `"5m"`

3350* **Переопределения для каждого сеанса**: [`CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS`](/docs/ru/env-vars) имеет приоритет над этим ключом для одного сеанса3353* **Переопределения для отдельного сеанса**: [`CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS`](/docs/ru/env-vars) имеет приоритет над этим ключом для одного сеанса

3351 3354

3352```json settings.json theme={null}3355```json settings.json theme={null}

3353{3356{

3355}3358}

3356```3359```

3357 3360

3358Подсказки разрешений и вопросы [`AskUserQuestion`](/docs/ru/tools-reference#askuserquestion-tool-behavior) используют свои собственные потоки и не регулируются этим крайним сроком. Появляется в `/config` как **Dialog expiry**, который записывает этот ключ в пользовательские параметры; строка требует Claude Code v2.1.232 или позже, и Claude Code скрывает ее, пока управляемые параметры или флаг `--settings` устанавливают ключ.3361Подсказки разрешений и вопросы [`AskUserQuestion`](/docs/ru/tools-reference#askuserquestion-tool-behavior) используют свои собственные потоки и не регулируются этим крайним сроком. Появляется в `/config` как **Dialog expiry**, который записывает этот ключ в пользовательские параметры; строка требует Claude Code v2.1.232 или более поздней версии, и Claude Code скрывает ее, пока управляемые параметры или флаг `--settings` устанавливают ключ.

3359 3362

3360<h3 id="editormode">3363<h3 id="editormode">

3361 `editorMode`3364 `editorMode`

3362</h3>3365</h3>

3363 3366

3364Выберите режим сочетаний клавиш для приглашения ввода.3367Выберите режим сочетания клавиш для приглашения ввода.

3365 3368

3366* **Область действия**: [`Любой файл`](#scopes)3369* **Область действия**: [`Any file`](#scopes)

3367* **Тип**: строка, одна из:3370* **Тип**: строка, одно из:

3368 * `"normal"`: стандартные сочетания клавиш в приглашении ввода3371 * `"normal"`: стандартные сочетания клавиш в приглашении ввода

3369 * `"vim"`: редактирование в стиле vim с режимами NORMAL, INSERT и VISUAL3372 * `"vim"`: редактирование в стиле vim с режимами NORMAL, INSERT и VISUAL

3370* **По умолчанию**: `"normal"`3373* **По умолчанию**: `"normal"`

3381 `emojiCompletionEnabled`3384 `emojiCompletionEnabled`

3382</h3>3385</h3>

3383 3386

3384Показывайте предложения эмодзи, когда вы вводите `:` плюс сокращение в приглашение ввода, и замените завершенное сокращение, такое как `:heart:`, его эмодзи. Установите это на `false`, чтобы отключить оба.3387Показывайте предложения эмодзи, когда вы вводите `:` плюс сокращение в приглашение ввода, и замените завершенное сокращение, такое как `:heart:`, его эмодзи. Установите это значение на `false`, чтобы отключить оба.

3385 3388

3386* **Область действия**: [`Любой файл`](#scopes)3389* **Область действия**: [`Any file`](#scopes)

3387* **Тип**: Boolean3390* **Тип**: Boolean

3388 * `true`: Claude Code показывает предложения эмодзи после `:` и заменяет завершенное сокращение его эмодзи3391 * `true`: Claude Code показывает предложения эмодзи после `:` и заменяет завершенное сокращение его эмодзи

3389 * `false`: Claude Code ни предлагает эмодзи, ни заменяет сокращения3392 * `false`: Claude Code ни предлагает эмодзи, ни заменяет сокращения

3395}3398}

3396```3399```

3397 3400

3398См. [Сокращения эмодзи](/docs/ru/interactive-mode#emoji-shortcodes). Требуется Claude Code v2.1.217 или позже.3401См. [Сокращения эмодзи](/docs/ru/interactive-mode#emoji-shortcodes). Требуется Claude Code v2.1.217 или более поздняя версия.

3399 3402

3400<span id="file-suggestion-settings" />3403<span id="file-suggestion-settings" />

3401 3404

3403 `fileSuggestion`3406 `fileSuggestion`

3404</h3>3407</h3>

3405 3408

3406Запустите вашу собственную команду для предоставления автодополнения пути файла `@` вместо встроенного предложения файла. Встроенное предложение использует быстрый обход файловой системы; большой монорепозиторий может работать лучше с индексированием, специфичным для проекта, таким как предварительно построенный индекс файлов.3409Запустите вашу собственную команду для предоставления автодополнения пути файла `@` вместо встроенного предложения файла. Встроенное предложение использует быстрый обход файловой системы; большой монорепо может работать лучше с индексированием, специфичным для проекта, таким как предварительно построенный индекс файлов.

3407 3410

3408* **Область действия**: [`Любой файл`](#scopes). В соответствии с [шлюзами строки состояния и предложения файла](#status-line-and-file-suggestion-gates), Claude Code отключает команду или запускает только управляемое значение и пропускает ваше без предупреждения.3411* **Область действия**: [`Any file`](#scopes). В соответствии с [воротами строки состояния и предложения файла](#status-line-and-file-suggestion-gates), Claude Code отключает команду или запускает только управляемое значение и пропускает ваше без предупреждения.

3409* **Тип**: объект с `type`, всегда `"command"`, и `command`, команда оболочки для запуска3412* **Тип**: объект с `type`, всегда `"command"`, и `command`, команда оболочки для запуска

3410* **По умолчанию**: не установлено, поэтому Claude Code использует встроенное предложение файла3413* **По умолчанию**: не установлено, поэтому Claude Code использует встроенное предложение файла

3411 3414

3453 `footerLinksRegexes`3456 `footerLinksRegexes`

3454</h3>3457</h3>

3455 3458

3456Отрисовка дополнительных кликабельных значков в нижнем колонтитуле под полем ввода, когда регулярное выражение совпадает с выводом хода: результаты инструментов, включая содержимое файлов и полученные страницы, и собственные ответы Claude. Используйте это, чтобы превратить идентификаторы, напечатанные проектными CLI, такие как инструменты проверки и трекеры проблем, в ссылки сеанса.3459Отображайте дополнительные кликабельные значки в нижнем колонтитуле под полем ввода, когда регулярное выражение соответствует выводу хода: результатам инструментов, включая содержимое файлов и полученные страницы, и собственным ответам Claude. Используйте это, чтобы превратить идентификаторы, напечатанные проектными CLI, такие как инструменты проверки и трекеры проблем, в ссылки сеанса.

3457 3460

3458* **Область действия**: [`Пользователь или управляемый`](#scopes)3461* **Область действия**: [`User or managed`](#scopes)

3459* **Тип**: массив объектов, каждый с `type`, установленным на `"regex"`, регулярное выражение `pattern`, шаблон `url` и необязательный `label`; заполнители `{name}` в `url` и `label` заполняются из именованных групп захвата в `pattern`3462* **Тип**: массив объектов, каждый с `type`, установленным на `"regex"`, регулярное выражение `pattern`, шаблон `url` и необязательный `label`; заполнители `{name}` в `url` и `label` заполняются из именованных групп захвата в `pattern`

3460* **По умолчанию**: не установлено, поэтому значки не отрисовываются3463* **По умолчанию**: не установлено, поэтому значки не отображаются

3461 3464

3462Этот пример совпадает с ключами проблем, такими как `PROJ-1234`, и строит каждую ссылку из захваченного ключа:3465Этот пример соответствует ключам проблем, таким как `PROJ-1234`, и создает каждую ссылку из захваченного ключа:

3463 3466

3464```json settings.json theme={null}3467```json settings.json theme={null}

3465{3468{

3480 Ограничения значков3483 Ограничения значков

3481</h4>3484</h4>

3482 3485

3483Каждая запись URL, метка и количество значков ограничены следующим образом:3486URL, метка и количество значков каждой записи ограничены следующим образом:

3484 3487

3485| Ограничение | Поведение |3488| Ограничение | Поведение |

3486| :- | :- |3489| :- | :- |

3487| Источник URL | Захваченные значения кодируются в URL, и построенный URL должен совместно использовать буквальный источник шаблона. Захват может заполнить сегмент пути или значение запроса, но не может изменить, куда указывает ссылка |3490| Источник URL | Захваченные значения кодируются в URL, и построенный URL должен совместно использовать источник шаблона. Захват может заполнить сегмент пути или значение запроса, но не может изменить, куда указывает ссылка |

3488| Длина URL | Построенные URL длиннее 2048 символов отбрасываются |3491| Длина URL | Построенные URL длиннее 2048 символов удаляются |

3489| Схема URL | Должна быть `https`, `http` или признанная схема глубокой ссылки редактора или рабочего пространства: `vscode`, `vscode-insiders`, `cursor`, `windsurf`, `zed`, `jetbrains`, `idea`, `slack`, `linear`, `notion`, `figma` |3492| Схема URL | Должна быть `https`, `http` или признанная схема глубокой ссылки редактора или рабочего пространства: `vscode`, `vscode-insiders`, `cursor`, `windsurf`, `zed`, `jetbrains`, `idea`, `slack`, `linear`, `notion`, `figma` |

3490| Метка | По умолчанию совпадает с текстом и усекается до 28 столбцов отображения |3493| Метка | По умолчанию соответствует совпадающему тексту и усекается до 28 столбцов отображения |

3491| Количество значков | Максимум 5 значков отрисовываются. Самый старый вытесняется новыми совпадениями и `/clear` удаляет их |3494| Количество значков | Максимум 5 значков отображаются. Самый старый вытесняется новыми совпадениями, и `/clear` удаляет их |

3492 3495

3493Когда ход завершается, Claude Code совпадает с регулярным выражением `pattern` каждой записи с выводом хода в главном потоке, поэтому медленное регулярное выражение блокирует пользовательский интерфейс до его завершения. Вложенные квантификаторы, такие как `(a+)+$`, могут занимать экспоненциально долго против определенных входов и заморозить сеанс, поэтому держите каждый `pattern` линейным и избегайте вложения `+` или `*`.3496Когда ход завершается, Claude Code сопоставляет регулярное выражение `pattern` каждой записи с выводом хода в главном потоке, поэтому медленное регулярное выражение блокирует пользовательский интерфейс до его завершения. Вложенные квантификаторы, такие как `(a+)+$`, могут занимать экспоненциально долго для определенных входов и заморозить сеанс, поэтому держите каждый `pattern` линейным и избегайте вложения `+` или `*`.

3494 3497

3495Значки нижнего колонтитула отрисовываются рядом с [пользовательской строкой состояния](/docs/ru/statusline), когда она настроена; ни один не заменяет другой. Используйте строку состояния для строки, управляемой скриптом, которая вычисляет свое собственное содержимое из данных сеанса, и значки нижнего колонтитула, чтобы превратить идентификаторы из разговора в ссылки без скрипта.3498Значки нижнего колонтитула отображаются рядом с [пользовательской строкой состояния](/docs/ru/statusline), когда она настроена; ни один не заменяет другой. Используйте строку состояния для строки, управляемой скриптом, которая вычисляет свое собственное содержимое из данных сеанса, и значки нижнего колонтитула, чтобы превратить идентификаторы из разговора в ссылки без скрипта.

3496 3499

3497<h3 id="keybindingflavor">3500<h3 id="keybindingflavor">

3498 `keybindingFlavor`3501 `keybindingFlavor`

3504 3507

3505В v2.1.238 через v2.1.260 установка его на `"readline"` заставляла `Ctrl+W` удалять назад к предыдущему пробелу вместо только предыдущего слова.3508В v2.1.238 через v2.1.260 установка его на `"readline"` заставляла `Ctrl+W` удалять назад к предыдущему пробелу вместо только предыдущего слова.

3506 3509

3507* **Область действия**: [`Любой файл`](#scopes)3510* **Область действия**: [`Any file`](#scopes)

3508* **Тип**: строка, `"classic"` или `"readline"`3511* **Тип**: строка, `"classic"` или `"readline"`

3509* **По умолчанию**: не установлено3512* **По умолчанию**: не установлено

3510 3513

3512 `maxProseWidth`3515 `maxProseWidth`

3513</h3>3516</h3>

3514 3517

3515Ограничьте ширину прозы в ответах Claude, чтобы строки оставались читаемыми в широком терминале. Абзацы, заголовки, списки и блокировки цитат переносятся в пределах этого количества столбцов, в то время как таблицы и блоки кода сохраняют полную ширину терминала. Требуется Claude Code v2.1.282 или позже.3518Ограничьте ширину прозы в ответах Claude, чтобы строки оставались читаемыми в широком терминале. Абзацы, заголовки, списки и цитаты переносятся в пределах этого количества столбцов, в то время как таблицы и блоки кода сохраняют полную ширину терминала. Требуется Claude Code v2.1.282 или более поздняя версия.

3516 3519

3517* **Область действия**: [`Любой файл`](#scopes)3520* **Область действия**: [`Any file`](#scopes)

3518* **Тип**: количество столбцов терминала, целое число, минимум `40`. Claude Code игнорирует любое другое значение3521* **Тип**: количество столбцов терминала, целое число, минимум `40`. Claude Code игнорирует любое другое значение

3519* **По умолчанию**: не установлено, поэтому проза переносится на край терминала3522* **По умолчанию**: не установлено, поэтому проза переносится на край терминала

3520 3523

3530 3533

3531Уменьшите или отключите анимацию интерфейса, такую как спиннер, мерцание и эффекты вспышки. Появляется в `/config` как **Reduce motion**.3534Уменьшите или отключите анимацию интерфейса, такую как спиннер, мерцание и эффекты вспышки. Появляется в `/config` как **Reduce motion**.

3532 3535

3533* **Область действия**: [`Любой файл`](#scopes)3536* **Область действия**: [`Any file`](#scopes)

3534* **Тип**: Boolean3537* **Тип**: Boolean

3535 * `true`: Claude Code уменьшает или отключает анимацию интерфейса, такую как спиннер, мерцание и эффекты вспышки3538 * `true`: Claude Code уменьшает или отключает анимацию интерфейса, такую как спиннер, мерцание и эффекты вспышки

3536 * `false`: то же самое, что не установлено; Claude Code показывает свои анимации3539 * `false`: то же самое, что не установлено; Claude Code показывает свои анимации

3546 `promptSuggestionEnabled`3549 `promptSuggestionEnabled`

3547</h3>3550</h3>

3548 3551

3549Показывайте или скрывайте [предложения приглашения](/docs/ru/interactive-mode#prompt-suggestions), затемненные предсказания, которые появляются в вашем приглашении ввода. Установите это на `false` или отключите **Prompt suggestions** в `/config`, чтобы скрыть их.3552Показывайте или скрывайте [предложения приглашения](/docs/ru/interactive-mode#prompt-suggestions), затемненные предсказания, которые появляются в вашем приглашении ввода. Установите это значение на `false` или отключите **Prompt suggestions** в `/config`, чтобы скрыть их.

3550 3553

3551* **Область действия**: [`Любой файл`](#scopes)3554* **Область действия**: [`Any file`](#scopes)

3552* **Тип**: Boolean3555* **Тип**: Boolean

3553 * `true`: вы видите предложения приглашения в вашем приглашении ввода3556 * `true`: вы видите предложения приглашения в вашем приглашении ввода

3554 * `false`: Claude Code скрывает предложения приглашения3557 * `false`: Claude Code скрывает предложения приглашения

3555* **По умолчанию**: `true`3558* **По умолчанию**: `true`

3556* **Переопределения для каждого сеанса**: [`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`](/docs/ru/env-vars) имеет приоритет над этим ключом для одного сеанса3559* **Переопределения для отдельного сеанса**: [`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`](/docs/ru/env-vars) имеет приоритет над этим ключом для одного сеанса

3557 3560

3558```json settings.json theme={null}3561```json settings.json theme={null}

3559{3562{

3561}3564}

3562```3565```

3563 3566

3564Предложения приглашения требуют учетной записи claude.ai или Console с включенной телеметрией. На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, или с отключенной телеметрией, такой как [`DISABLE_TELEMETRY`](/docs/ru/env-vars), этот ключ не имеет эффекта и только `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=1` включает их.3567Предложения приглашения требуют учетную запись claude.ai или Console с включенной телеметрией. На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, или с отключенной телеметрией, такой как [`DISABLE_TELEMETRY`](/docs/ru/env-vars), этот ключ не имеет эффекта и только `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=1` включает их.

3565 3568

3566<h3 id="respectgitignore">3569<h3 id="respectgitignore">

3567 `respectGitignore`3570 `respectGitignore`

3568</h3>3571</h3>

3569 3572

3570Контролируйте, оставляет ли средство выбора файлов `@` файлы, которые совпадают с шаблонами `.gitignore`. Появляется в `/config` как **Respect .gitignore in file picker**.3573Контролируйте, оставляет ли средство выбора файлов `@` файлы, которые соответствуют шаблонам `.gitignore`. Появляется в `/config` как **Respect .gitignore in file picker**.

3571 3574

3572* **Область действия**: [`Любой файл`](#scopes). Когда ни один файл параметров его не устанавливает, Claude Code возвращается к `respectGitignore` в `~/.claude.json`, который переключатель `/config` записывает.3575* **Область действия**: [`Any file`](#scopes). Когда ни один файл параметров его не устанавливает, Claude Code возвращается к `respectGitignore` в `~/.claude.json`, который переключатель `/config` записывает.

3573* **Тип**: Boolean3576* **Тип**: Boolean

3574 * `true`: средство выбора файлов `@` оставляет файлы, которые совпадают с шаблонами `.gitignore`3577 * `true`: средство выбора файлов `@` оставляет файлы, которые соответствуют шаблонам `.gitignore`

3575 * `false`: средство выбора файлов `@` включает файлы, которые совпадают с шаблонами `.gitignore`3578 * `false`: средство выбора файлов `@` включает файлы, которые соответствуют шаблонам `.gitignore`

3576* **По умолчанию**: `true`3579* **По умолчанию**: `true`

3577 3580

3578```json settings.json theme={null}3581```json settings.json theme={null}

3587 3590

3588Выберите, отвечает ли Claude после того, как вы запустите команду оболочки с префиксом [`!`](/docs/ru/interactive-mode#shell-mode-with-prefix) в поле ввода. По умолчанию Claude Code добавляет вывод команды в разговор и Claude отвечает на него. Установите этот ключ на `false`, чтобы добавить вывод в контекст без ответа, чтобы вы могли запустить несколько команд и спросить о них вместе.3591Выберите, отвечает ли Claude после того, как вы запустите команду оболочки с префиксом [`!`](/docs/ru/interactive-mode#shell-mode-with-prefix) в поле ввода. По умолчанию Claude Code добавляет вывод команды в разговор и Claude отвечает на него. Установите этот ключ на `false`, чтобы добавить вывод в контекст без ответа, чтобы вы могли запустить несколько команд и спросить о них вместе.

3589 3592

3590* **Область действия**: [`Любой файл`](#scopes)3593* **Область действия**: [`Any file`](#scopes)

3591* **Тип**: Boolean3594* **Тип**: Boolean

3592 * `true`: Claude Code добавляет вывод команды в разговор и Claude отвечает на него3595 * `true`: Claude Code добавляет вывод команды в разговор и Claude отвечает на него

3593 * `false`: Claude Code добавляет вывод в контекст без ответа3596 * `false`: Claude Code добавляет вывод в контекст без ответа

3605 `showClearContextOnPlanAccept`3608 `showClearContextOnPlanAccept`

3606</h3>3609</h3>

3607 3610

3608Когда Claude завершает план в [режиме плана](/docs/ru/permission-modes#review-and-approve-a-plan), он показывает меню одобрения. Планирование может использовать много контекста, поэтому этот ключ добавляет первый вариант в это меню, **Yes, clear context and …**, который одобряет план, очищает контекст разговора и начинает реализацию только из плана. Остальная часть метки называет режим разрешения, в котором продолжается сеанс, и показывает, сколько вашего контекста использовало планирование.3611Когда Claude завершает план в [режиме плана](/docs/ru/permission-modes#review-and-approve-a-plan), он показывает меню одобрения. Планирование может использовать много контекста, поэтому этот ключ добавляет первый вариант в это меню, **Yes, clear context and …**, который одобряет план, очищает контекст разговора и начинает реализацию только из плана. Остальная часть метки называет режим разрешений, в котором продолжается сеанс, и показывает, сколько вашего контекста использовало планирование.

3609 3612

3610* **Область действия**: [`Любой файл`](#scopes)3613* **Область действия**: [`Any file`](#scopes)

3611* **Тип**: Boolean3614* **Тип**: Boolean

3612 * `true`: меню одобрения плана получает первый вариант, **Yes, clear context and …**, который одобряет план и очищает контекст разговора3615 * `true`: меню одобрения плана получает первый вариант, **Yes, clear context and …**, который одобряет план и очищает контекст разговора

3613 * `false`: меню одобрения плана не показывает вариант очистки контекста3616 * `false`: меню одобрения плана не показывает вариант очистки контекста

3625 3628

3626Показывайте или скрывайте сообщение о продолжительности хода после каждого ответа, такое как "Cooked for 1m 6s · done 6:05 PM". Часы после "done" показывают, когда ход завершился; [`timeFormat`](#timeformat) и [`timeZone`](#timezone) контролируют его формат и зону. Появляется в `/config` как **Show turn duration**.3629Показывайте или скрывайте сообщение о продолжительности хода после каждого ответа, такое как "Cooked for 1m 6s · done 6:05 PM". Часы после "done" показывают, когда ход завершился; [`timeFormat`](#timeformat) и [`timeZone`](#timezone) контролируют его формат и зону. Появляется в `/config` как **Show turn duration**.

3627 3630

3628* **Область действия**: [`Любой файл`](#scopes). Значение в `~/.claude.json` из более старой версии применяется, когда ни один файл параметров его не устанавливает.3631* **Область действия**: [`Any file`](#scopes). Значение в `~/.claude.json` из более старой версии применяется, когда ни один файл параметров его не устанавливает.

3629* **Тип**: Boolean3632* **Тип**: Boolean

3630 * `true`: вы видите сообщение о продолжительности хода после каждого ответа3633 * `true`: вы видите сообщение о продолжительности хода после каждого ответа

3631 * `false`: Claude Code скрывает сообщение о продолжительности хода3634 * `false`: Claude Code скрывает сообщение о продолжительности хода

3641 `spellcheck`3644 `spellcheck`

3642</h3>3645</h3>

3643 3646

3644Подчеркивайте неправильно написанные слова в приглашении ввода по мере ввода, используя установленную вами программу проверки орфографии. Claude Code проверяет только текст в поле ввода. [Проверка орфографии по мере ввода](/docs/ru/interactive-mode#check-spelling-as-you-type) охватывает установку aspell, hunspell или ispell и то, что проверяет программа проверки. Требуется Claude Code v2.1.235 или позже.3647Подчеркивайте неправильно написанные слова в приглашении ввода по мере ввода, используя установленную вами программу проверки орфографии. Claude Code проверяет только текст в поле ввода. [Проверка орфографии по мере ввода](/docs/ru/interactive-mode#check-spelling-as-you-type) охватывает установку aspell, hunspell или ispell и то, что проверяет программа проверки. Требуется Claude Code v2.1.235 или более поздняя версия.

3645 3648

3646* **Область действия**: [`Пользователь или управляемый`](#scopes). Блок из самого высокого уровня, который его устанавливает, применяется целиком.3649* **Область действия**: [`User or managed`](#scopes). Блок из самого высокого уровня, который его устанавливает, применяется в целом.

3647* **Тип**: объект с `enabled` (Boolean), `checker` (`"aspell"`, `"hunspell"`, `"ispell"` или `"auto"`), `language` (строка, передаваемая программе проверки как имя ее словаря) и `color` (строка, имя цвета терминала, `#rrggbb`, `rgb(r,g,b)`, `ansi256(n)` или `ansi:<name>`)3650* **Тип**: объект с `enabled` (Boolean), `checker` (`"aspell"`, `"hunspell"`, `"ispell"` или `"auto"`), `language` (строка, передаваемая программе проверки как имя ее словаря) и `color` (строка, имя цвета терминала, `#rrggbb`, `rgb(r,g,b)`, `ansi256(n)` или `ansi:<name>`)

3648* **По умолчанию**: не установлено, поэтому проверка орфографии отключена; `checker` по умолчанию `"auto"`, первый из трех найденных на `PATH`; `language` по умолчанию собственный словарь программы проверки; `color` по умолчанию цвет ошибки темы3651* **По умолчанию**: не установлено, поэтому проверка орфографии отключена; `checker` по умолчанию `"auto"`, первый из трех найденных на `PATH`; `language` по умолчанию собственный словарь программы проверки; `color` по умолчанию цвет ошибки темы

3649 3652

3659 3662

3660Пока Claude работает, строка спиннера вращается через короткие советы о функциях Claude Code, такие как "Use Plan Mode to prepare for a complex request before making changes. Press Shift+Tab twice to enable." Установите этот ключ на `false`, чтобы скрыть их. Появляется в `/config` как **Show tips**.3663Пока Claude работает, строка спиннера вращается через короткие советы о функциях Claude Code, такие как "Use Plan Mode to prepare for a complex request before making changes. Press Shift+Tab twice to enable." Установите этот ключ на `false`, чтобы скрыть их. Появляется в `/config` как **Show tips**.

3661 3664

3662* **Область действия**: [`Любой файл`](#scopes)3665* **Область действия**: [`Any file`](#scopes)

3663* **Тип**: Boolean3666* **Тип**: Boolean

3664 * `true`: вы видите советы в спиннере, пока Claude работает3667 * `true`: вы видите советы в спиннере, пока Claude работает

3665 * `false`: Claude Code скрывает советы спиннера3668 * `false`: Claude Code скрывает советы спиннера

3675 `spinnerTipsOverride`3678 `spinnerTipsOverride`

3676</h3>3679</h3>

3677 3680

3678Добавьте свои собственные советы к [советам спиннера](#spinnertipsenabled), которые Claude Code показывает, пока Claude работает, или замените встроенные советы своими. Claude Code помещает ваши советы в ту же ротацию, что и встроенные: он выбирает совет, который дольше всего не показывался, пропускает советы, все еще находящиеся в своем периоде охлаждения, и разрывает связи по приоритету.3681Добавьте свои собственные советы к [советам спиннера](#spinnertipsenabled), которые Claude Code показывает, пока Claude работает, или замените встроенные советы своими. Claude Code помещает ваши советы в ту же ротацию, что и встроенные.

3679 3682

3680Если вы установите [`spinnerTipsEnabled`](#spinnertipsenabled) на `false`, Claude Code скрывает все советы, включая ваши.3683Если вы установите [`spinnerTipsEnabled`](#spinnertipsenabled) на `false`, Claude Code скроет все советы, включая ваши.

3681 3684

3682* **Область действия**: [`Любой файл`](#scopes). Claude Code соблюдает объекты советов, `tipsFile`, `label` и `excludeDefault` из пользовательских параметров, флага `--settings` и управляемых параметров; из параметров проекта и локальных параметров он читает только простые строковые советы.3685* **Область действия**: [`Any file`](#scopes). Claude Code соблюдает объекты советов, `tipsFile`, `label` и `excludeDefault` из пользовательских параметров, флага `--settings` и управляемых параметров; из параметров проекта и локальных параметров он читает только простые строковые советы.

3683* **Тип**: объект с полями `tips`, `tipsFile`, `label` и `excludeDefault`, каждое необязательное3686* **Тип**: объект с полями `tips`, `tipsFile`, `label` и `excludeDefault`, каждое необязательное

3684* **По умолчанию**: не установлено, поэтому Claude Code показывает только встроенные советы3687* **По умолчанию**: не установлено, поэтому Claude Code показывает только встроенные советы

3685 3688

3686Объекты советов, `tipsFile`, `label` и правило в строке Область действия, что параметры проекта и локальные параметры вносят только простые строки, требуют Claude Code v2.1.247 или позже. На более ранних версиях `excludeDefault` файла проекта или локального файла также применяется.3689Объекты советов, `tipsFile`, `label` и правило в строке Scope, что параметры проекта и локальные параметры вносят только простые строки, требуют Claude Code v2.1.247 или более поздней версии.

3687 3690

3688Каждая запись `tips` — это простая строка или объект с этими полями:3691Каждая запись `tips` — это простая строка или объект с этими полями:

3689 3692

3691| :- | :- | :- |3694| :- | :- | :- |

3692| `id` | Да | До 64 букв, цифр, `.`, `_` или `-`. Claude Code ключает историю показа совета на нем, поэтому период охлаждения совета сохраняется при переупорядочении списка. Из двух записей с одинаковым id Claude Code использует первую |3695| `id` | Да | До 64 букв, цифр, `.`, `_` или `-`. Claude Code ключает историю показа совета на нем, поэтому охлаждение совета выживает переупорядочение списка. Из двух записей с одинаковым id Claude Code использует первую |

3693| `text` | Да | Совет, одна строка до 500 символов. Claude Code удаляет ANSI-экранирования и управляющие символы и сворачивает пробелы |3696| `text` | Да | Совет, одна строка до 500 символов. Claude Code удаляет ANSI-экранирования и управляющие символы и сворачивает пробелы |

3694| `cooldownSessions` | Нет | Сеансы Claude Code ждет перед повторным показом совета, `0` до `1000`, по умолчанию `0` |3697| `cooldownSessions` | Нет | Сеансы Claude Code ждет перед повторным показом совета, `0` до `1000`, по умолчанию `0` |

3695| `priority` | Нет | Порядок среди советов, которые не показывались одинаково долго, выше первым, `-10` до `10`, по умолчанию `0` |3698| `priority` | Нет | Порядок среди советов, которые не показывались одинаково долго, выше первым, `-10` до `10`, по умолчанию `0` |

3696 3699

3697Claude Code читает простую строку как совет с этими значениями по умолчанию и id на основе позиции, поэтому его история показа сбрасывается при переупорядочении списка. Дайте совету `id`, чтобы сохранить его историю при редактировании.3700Claude Code читает простую строку как совет с этими значениями по умолчанию и id на основе позиции, поэтому его история показа сбрасывается при переупорядочении списка. Дайте совету `id`, чтобы сохранить его историю при редактировании.

3698 3701

3699Claude Code читает максимум 200 советов в `tips` и `tipsFile` и отбрасывает неправильную запись с предупреждением отладки вместо отклонения файла параметров.3702Claude Code читает максимум 200 советов в `tips` и `tipsFile` и удаляет неправильную запись с предупреждением отладки вместо отклонения файла параметров.

3700 3703

3701Используйте оставшиеся поля для именования файла советов, установки префикса и скрытия встроенных советов:3704Используйте оставшиеся поля для именования файла советов, установки префикса и скрытия встроенных советов:

3702 3705

3703* `tipsFile`: абсолютный или `~/` путь к локальному JSON-файлу, содержащему массив одинаковых записей, или объект с массивом `tips`, до 256 КБ. Claude Code читает файл один раз за процесс, поэтому он загружает ваши правки при следующем запуске. Вы не можете установить его через [управляемые параметры сервера](/docs/ru/server-managed-settings); развертывайте встроенные `tips` там или развертывайте путь в локальном `managed-settings.json`.3706* `tipsFile`: абсолютный или `~/` путь к локальному JSON-файлу, содержащему массив одинаковых записей, или объект с массивом `tips`, до 256 КБ. Claude Code читает файл один раз за процесс, поэтому он загружает ваши правки при следующем запуске. Вы не можете установить его через [управляемые параметры сервера](/docs/ru/server-managed-settings); развертывайте встроенные `tips` там или развертывайте путь в локальном `managed-settings.json`.

3704* `label`: префикс Claude Code показывает перед советами из пользовательских параметров, `--settings` и управляемых параметров, до 40 символов. По умолчанию `Tip`, тот же префикс, что и встроенные советы, и советы из параметров проекта и локальных параметров всегда его используют.3707* `label`: префикс Claude Code показывает перед советами из пользовательских параметров, `--settings` и управляемых параметров, до 40 символов. По умолчанию `Tip`, тот же префикс, что и встроенные советы, и советы из параметров проекта и локальных параметров всегда его используют.

3705* `excludeDefault`: установите это на `true`, чтобы скрыть встроенные советы и показать только ваши. Когда Claude Code не может загрузить какой-либо из ваших советов, например потому что `tipsFile` не существует или каждая запись неправильна, он сохраняет встроенную ротацию вместо пустого спиннера.3708* `excludeDefault`: установите его на `true`, чтобы скрыть встроенные советы и показать только ваши. Когда Claude Code не может загрузить какой-либо из ваших советов, например потому что `tipsFile` не существует или каждая запись неправильна, он сохраняет встроенную ротацию вместо пустого спиннера.

3706 3709

3707Когда более одного файла параметров устанавливает ключ, Claude Code показывает советы из всех них и берет `tipsFile`, `label` и `excludeDefault` из того, который из управляемых параметров, флага `--settings` и пользовательских параметров является наивысшим приоритетом, который устанавливает каждый.3710Когда более одного файла параметров устанавливает ключ, Claude Code показывает советы из всех них и берет `tipsFile`, `label` и `excludeDefault` из того, который из управляемых параметров, флага `--settings` и пользовательских параметров имеет наивысший приоритет, который устанавливает каждый.

3708 3711

3709Этот пример, в ваших пользовательских параметрах, добавляет простой строковый совет и объектный совет в ротацию под префиксом `Acme tip`:3712Этот пример в ваших пользовательских параметрах добавляет простой строковый совет и объектный совет в ротацию под префиксом `Acme tip`:

3710 3713

3711```json settings.json theme={null}3714```json settings.json theme={null}

3712{3715{

3729 3732

3730* `label`: Claude Code показывает оба совета как `Acme tip: ...` вместо `Tip: ...`.3733* `label`: Claude Code показывает оба совета как `Acme tip: ...` вместо `Tip: ...`.

3731* Простая строка: Claude Code дает ей значения по умолчанию, поэтому она может появиться снова в очень следующем сеансе.3734* Простая строка: Claude Code дает ей значения по умолчанию, поэтому она может появиться снова в очень следующем сеансе.

3732* `id`: Claude Code ключает историю показа второго совета на `gateway-errors`, поэтому его период охлаждения все еще применяется после добавления или переупорядочения советов.3735* `id`: Claude Code ключает историю показа второго совета на `gateway-errors`, поэтому его охлаждение все еще применяется после добавления или переупорядочения советов.

3733* `cooldownSessions`: после того как Claude Code показывает совет `gateway-errors`, он не показывает этот совет снова до пяти сеансов спустя.3736* `cooldownSessions`: после того как Claude Code показывает совет `gateway-errors`, он не показывает этот совет снова до пяти сеансов спустя.

3734* `priority`: когда совет `gateway-errors` и другой совет не показывались одинаково долго, например когда ни один еще не был показан, Claude Code показывает `gateway-errors` первым. Простая строка имеет приоритет по умолчанию, `0`.3737* `priority`: когда совет `gateway-errors` и другой совет не показывались одинаково долго, например когда ни один еще не был показан, Claude Code показывает `gateway-errors` первым. Простая строка имеет приоритет по умолчанию, `0`.

3735 3738

3741 3744

3742Пока ход выполняется, спиннер показывает вращающийся глагол, такой как "Accomplishing", "Architecting" или "Baking". Используйте этот ключ, чтобы добавить свои собственные глаголы в эту ротацию или заменить встроенный список своим.3745Пока ход выполняется, спиннер показывает вращающийся глагол, такой как "Accomplishing", "Architecting" или "Baking". Используйте этот ключ, чтобы добавить свои собственные глаголы в эту ротацию или заменить встроенный список своим.

3743 3746

3744* **Область действия**: [`Любой файл`](#scopes)3747* **Область действия**: [`Any file`](#scopes)

3745* **Тип**: объект с массивом `verbs` строк и `mode`, одна из:3748* **Тип**: объект с массивом `verbs` строк и `mode`, одно из:

3746 * `"append"`: Claude Code добавляет ваши глаголы к встроенному набору3749 * `"append"`: Claude Code добавляет ваши глаголы к встроенному набору

3747 * `"replace"`: Claude Code показывает только ваши глаголы3750 * `"replace"`: Claude Code показывает только ваши глаголы

3748* **По умолчанию**: не установлено, поэтому Claude Code использует встроенные глаголы3751* **По умолчанию**: не установлено, поэтому Claude Code использует встроенные глаголы

3764 `statusLine`3767 `statusLine`

3765</h3>3768</h3>

3766 3769

3767Запустите вашу собственную команду для отрисовки [строки состояния](/docs/ru/statusline) под приглашением с контекстом, таким как модель, стоимость или ветка git. Необязательные поля регулируют интервал, добавляют периодические переустановки и скрывают встроенный индикатор режима vim, когда ваш скрипт отрисовывает `vim.mode` сам.3770Запустите вашу собственную команду для отображения [строки состояния](/docs/ru/statusline) ниже приглашения с контекстом, таким как модель, стоимость или ветка git. Необязательные поля регулируют интервал, добавляют периодические повторные запуски и скрывают встроенный индикатор режима vim, когда ваш скрипт отображает `vim.mode` сам.

3768 3771

3769* **Область действия**: [`Любой файл`](#scopes). Когда [`allowManagedHooksOnly`](#allowmanagedhooksonly) включен или [`disableAllHooks`](#disableallhooks) установлен вне управляемых параметров, запускается только значение управляемых параметров.3772* **Область действия**: [`Any file`](#scopes). Когда [`allowManagedHooksOnly`](#allowmanagedhooksonly) включен или [`disableAllHooks`](#disableallhooks) установлен вне управляемых параметров, запускается только значение управляемых параметров.

3770* **Тип**: объект с `type`, установленным на `"command"` и строкой `command`, плюс необязательный `padding` как количество символов, `refreshInterval` как количество секунд, минимум `1`, и `hideVimModeIndicator` как Boolean3773* **Тип**: объект с `type`, установленным на `"command"` и строкой `command`, плюс необязательный `padding` как количество символов, `refreshInterval` как количество секунд, минимум `1`, и `hideVimModeIndicator` как Boolean

3771* **По умолчанию**: не установлено, поэтому нет строки состояния3774* **По умолчанию**: не установлено, поэтому нет строки состояния

3772 3775

3788 `subagentStatusLine`3791 `subagentStatusLine`

3789</h3>3792</h3>

3790 3793

3791Когда Claude запускает [подагентов](/docs/ru/sub-agents), Claude Code перечисляет их в отображении задач под приглашением, одна строка на подагента, показывающая `name · description · token count`. Этот ключ позволяет вам запустить вашу собственную команду для переписания этих строк, например для показа использования контекста каждого подагента в процентах. При каждом обновлении Claude Code отправляет видимые строки как один JSON-объект на stdin с массивом `tasks`, несущим `id`, `name`, `status`, `model`, `tokenCount` каждого подагента и многое другое, и заменяет строку для каждого `id`, который вы пишете обратно как строку `{"id", "content"}`. Строки, которые вы не пишете обратно, сохраняют отрисовку по умолчанию.3794Когда Claude запускает [подагентов](/docs/ru/sub-agents), Claude Code перечисляет их в отображении задач ниже приглашения, одна строка на подагента, показывающая `name · description · token count`. Этот ключ позволяет вам запустить вашу собственную команду для переписания этих строк, например для показа использования контекста каждого подагента в процентах. При каждом обновлении Claude Code отправляет видимые строки как один JSON-объект на stdin с массивом `tasks`, содержащим `id`, `name`, `status`, `model`, `tokenCount` каждого подагента и многое другое, и заменяет строку для каждого `id`, который вы пишете обратно как строку `{"id", "content"}`. Строки, которые вы не пишете обратно, сохраняют отображение по умолчанию.

3792 3795

3793* **Область действия**: [`Любой файл`](#scopes). Когда [`allowManagedHooksOnly`](#allowmanagedhooksonly) включен или [`disableAllHooks`](#disableallhooks) установлен вне управляемых параметров, запускается только значение управляемых параметров.3796* **Область действия**: [`Any file`](#scopes). Когда [`allowManagedHooksOnly`](#allowmanagedhooksonly) включен или [`disableAllHooks`](#disableallhooks) установлен вне управляемых параметров, запускается только значение управляемых параметров.

3794* **Тип**: объект с `type`, установленным на `"command"` и строкой `command`3797* **Тип**: объект с `type`, установленным на `"command"` и строкой `command`

3795* **По умолчанию**: не установлено, поэтому Claude Code отрисовывает строки по умолчанию3798* **По умолчанию**: не установлено, поэтому Claude Code отображает строки по умолчанию

3796 3799

3797```json settings.json theme={null}3800```json settings.json theme={null}

3798{3801{

3811 3814

3812Claude Code раскрашивает код по языку в дифах, блоках кода и предпросмотрах файлов, которые он показывает в терминале, со своим встроенным подсветчиком; никакой плагин или языковой сервер не задействован. Установите этот ключ на `true`, чтобы показать их как простой текст вместо этого, например если цвета конфликтуют с вашей темой терминала или замедляют программу чтения с экрана.3815Claude Code раскрашивает код по языку в дифах, блоках кода и предпросмотрах файлов, которые он показывает в терминале, со своим встроенным подсветчиком; никакой плагин или языковой сервер не задействован. Установите этот ключ на `true`, чтобы показать их как простой текст вместо этого, например если цвета конфликтуют с вашей темой терминала или замедляют программу чтения с экрана.

3813 3816

3814* **Область действия**: [`Любой файл`](#scopes)3817* **Область действия**: [`Any file`](#scopes)

3815* **Тип**: Boolean3818* **Тип**: Boolean

3816 * `true`: Claude Code отключает подсветку синтаксиса в дифах, блоках кода и предпросмотрах файлов3819 * `true`: Claude Code отключает подсветку синтаксиса в дифах, блоках кода и предпросмотрах файлов

3817 * `false`: Claude Code подсвечивает синтаксис3820 * `false`: Claude Code подсвечивает синтаксис

3827 `terminalProgressBarEnabled`3830 `terminalProgressBarEnabled`

3828</h3>3831</h3>

3829 3832

3830Некоторые терминалы могут показать индикатор прогресса на вкладке или в панели задач для программы, работающей в них. Пока Claude работает, Claude Code сообщает состояние выполнения терминалу, поэтому вы можете видеть с другой вкладки или окна, занят ли сеанс. Индикатор остается видимым после завершения хода, пока [фоновые подагенты](/docs/ru/sub-agents#run-subagents-in-foreground-or-background) или [динамические рабочие процессы](/docs/ru/workflows) все еще работают, и очищается после того, как сеанс неактивен.3833Некоторые терминалы могут показывать индикатор прогресса на вкладке или в панели задач для программы, работающей в них. Пока Claude работает, Claude Code сообщает состояние выполнения терминалу, поэтому вы можете видеть с другой вкладки или окна, занят ли сеанс. Индикатор остается видимым после завершения хода, пока [фоновые подагенты](/docs/ru/sub-agents#run-subagents-in-foreground-or-background) или [динамические рабочие процессы](/docs/ru/workflows) все еще работают, и очищается после того, как сеанс неактивен.

3831 3834

3832Claude Code сообщает это только в терминалах, которые поддерживают индикатор: ConEmu, Ghostty 1.2.0 или позже и iTerm2 3.6.6 или позже. Установите этот ключ на `false`, чтобы остановить Claude Code от сообщения об этом. Появляется в `/config` как **Terminal progress bar**.3835Claude Code сообщает об этом только в терминалах, которые поддерживают индикатор: ConEmu, Ghostty 1.2.0 или более поздняя версия и iTerm2 3.6.6 или более поздняя версия. Установите этот ключ на `false`, чтобы остановить Claude Code от сообщения об этом. Появляется в `/config` как **Terminal progress bar**.

3833 3836

3834* **Область действия**: [`Любой файл`](#scopes). Значение в `~/.claude.json` из более старой версии применяется, когда ни один файл параметров его не устанавливает.3837* **Область действия**: [`Any file`](#scopes). Значение в `~/.claude.json` из более старой версии применяется, когда ни один файл параметров его не устанавливает.

3835* **Тип**: Boolean3838* **Тип**: Boolean

3836 * `true`: вы видите полосу прогресса терминала в терминалах, которые ее поддерживают3839 * `true`: вы видите полосу прогресса терминала в терминалах, которые ее поддерживают

3837 * `false`: Claude Code скрывает полосу прогресса терминала3840 * `false`: Claude Code скрывает полосу прогресса терминала

3849 3852

3850Claude Code устанавливает название вкладки вашего терминала. По умолчанию он использует название, которое он генерирует из разговора, и как только вы дадите сеансу [имя](/docs/ru/sessions#name-your-sessions) с `/rename` или `--name`, вкладка показывает это имя вместо этого. Установите этот ключ на `false`, чтобы сохранить сгенерированное название на вкладке даже после того, как вы назовете сеанс. Само имя все еще применяется, поэтому `/resume <name>` и средство выбора сеанса его находят.3853Claude Code устанавливает название вкладки вашего терминала. По умолчанию он использует название, которое он генерирует из разговора, и как только вы дадите сеансу [имя](/docs/ru/sessions#name-your-sessions) с `/rename` или `--name`, вкладка показывает это имя вместо этого. Установите этот ключ на `false`, чтобы сохранить сгенерированное название на вкладке даже после того, как вы назовете сеанс. Само имя все еще применяется, поэтому `/resume <name>` и средство выбора сеанса его находят.

3851 3854

3852* **Область действия**: [`Любой файл`](#scopes)3855* **Область действия**: [`Any file`](#scopes)

3853* **Тип**: Boolean3856* **Тип**: Boolean

3854 * `true`: название вкладки терминала показывает имя сеанса, которое вы установили3857 * `true`: название вкладки терминала показывает имя сеанса, которое вы установили

3855 * `false`: вкладка сохраняет название Claude Code генерирует из вашего разговора3858 * `false`: вкладка сохраняет название Claude Code генерирует из вашего разговора

3869 3872

3870Выберите цветовую тему для интерфейса. Появляется в `/config` как **Theme**.3873Выберите цветовую тему для интерфейса. Появляется в `/config` как **Theme**.

3871 3874

3872* **Область действия**: [`Любой файл`](#scopes). Значение в `~/.claude.json` из более старой версии применяется, когда ни один файл параметров его не устанавливает.3875* **Область действия**: [`Any file`](#scopes). Значение в `~/.claude.json` из более старой версии применяется, когда ни один файл параметров его не устанавливает.

3873* **Тип**: строка, одна из:3876* **Тип**: строка, одно из:

3874 * `"auto"`: совпадает с светлым или темным фоном вашего терминала3877 * `"auto"`: соответствует светлому или темному фону вашего терминала

3875 * `"dark"`: темная тема3878 * `"dark"`: темная тема

3876 * `"light"`: светлая тема3879 * `"light"`: светлая тема

3877 * `"dark-daltonized"`: темная тема с удобными для дальтоников цветами3880 * `"dark-daltonized"`: темная тема с удобными для дальтоников цветами

3878 * `"light-daltonized"`: светлая тема с удобными для дальтоников цветами3881 * `"light-daltonized"`: светлая тема с удобными для дальтоников цветами

3879 * `"dark-ansi"`: темная тема, используя только палитру цветов ANSI вашего терминала3882 * `"dark-ansi"`: темная тема, использующая только палитру ANSI вашего терминала

3880 * `"light-ansi"`: светлая тема, используя только палитру цветов ANSI вашего терминала3883 * `"light-ansi"`: светлая тема, использующая только палитру ANSI вашего терминала

3881 * `"custom:<slug>"` или `"custom:<plugin-name>:<slug>"`: пользовательская тема из `~/.claude/themes/` или плагина3884 * `"custom:<slug>"` или `"custom:<plugin-name>:<slug>"`: пользовательская тема из `~/.claude/themes/` или плагина

3882* **По умолчанию**: `"dark"`3885* **По умолчанию**: `"dark"`

3883 3886

3893 `timeFormat`3896 `timeFormat`

3894</h3>3897</h3>

3895 3898

3896Выберите, как Claude Code записывает времена, которые он показывает в интерфейсе, такие как `done 6:05 PM` в конце каждого сообщения о продолжительности хода и временные метки в [средстве просмотра стенограммы](/docs/ru/interactive-mode#transcript-viewer). Чтобы выбрать предустановку, запустите `/config` и установите **Time format**. Требуется Claude Code v2.1.257 или позже.3899Выберите, как Claude Code записывает времена, которые он показывает в интерфейсе, такие как `done 6:05 PM` в конце каждого сообщения о продолжительности хода и временные метки в [средстве просмотра стенограммы](/docs/ru/interactive-mode#transcript-viewer). Чтобы выбрать предустановку, запустите `/config` и установите **Time format**. Требуется Claude Code v2.1.257 или более поздняя версия.

3897 3900

3898* **Область действия**: [`Любой файл`](#scopes)3901* **Область действия**: [`Any file`](#scopes)

3899* **Тип**: строка, одна из:3902* **Тип**: строка, одно из:

3900 * `"auto"`: то же самое, что не установлено; каждое время сохраняет свой встроенный формат, который следует вашей локали в сообщении о продолжительности хода3903 * `"auto"`: то же самое, что не установлено; каждое время сохраняет свой встроенный формат, который следует вашей локали в сообщении о продолжительности хода

3901 * `"12-hour"`: 12-часовые часы3904 * `"12-hour"`: 12-часовые часы

3902 * `"24-hour"`: 24-часовые часы3905 * `"24-hour"`: 24-часовые часы

3932 `timeZone`3935 `timeZone`

3933</h3>3936</h3>

3934 3937

3935Показывайте времена в интерфейсе в часовом поясе, отличном от вашего системного. Установите это на [имя часового пояса IANA](https://www.iana.org/time-zones), такое как `"UTC"` или `"Europe/Dublin"`. Времена, которые [`timeFormat`](#timeformat) контролирует, затем показываются в этом поясе. Если `timeFormat` — это `"24-hour-utc"`, времена остаются в UTC и Claude Code игнорирует этот ключ. `/config` не имеет строки для этого ключа, поэтому установите его в файл параметров. Требуется Claude Code v2.1.257 или позже.3938Показывайте времена в интерфейсе в часовом поясе, отличном от вашего системного. Установите его на [имя часового пояса IANA](https://www.iana.org/time-zones), такое как `"UTC"` или `"Europe/Dublin"`. Времена, которые [`timeFormat`](#timeformat) контролирует, затем показываются в этом поясе. Если `timeFormat` — это `"24-hour-utc"`, времена остаются в UTC и Claude Code игнорирует этот ключ. `/config` не имеет строки для этого ключа, поэтому установите его в файл параметров. Требуется Claude Code v2.1.257 или более поздняя версия.

3936 3939

3937* **Область действия**: [`Любой файл`](#scopes)3940* **Область действия**: [`Any file`](#scopes)

3938* **Тип**: строка, имя часового пояса IANA. Когда Claude Code не распознает имя, он использует ваш системный часовой пояс3941* **Тип**: строка, имя часового пояса IANA. Когда Claude Code не распознает имя, он использует ваш системный часовой пояс

3939* **По умолчанию**: не установлено, поэтому времена показываются в вашем системном часовом поясе3942* **По умолчанию**: не установлено, поэтому времена показываются в вашем системном часовом поясе

3940 3943

3950 3953

3951Выберите рендерер пользовательского интерфейса терминала. Используйте `"fullscreen"` для безмерцающего [рендерера alt-screen](/docs/ru/fullscreen) с виртуализированной прокруткой или `"default"` для классического рендерера основного экрана. Запуск `/tui fullscreen` или `/tui default` записывает этот ключ для вас.3954Выберите рендерер пользовательского интерфейса терминала. Используйте `"fullscreen"` для безмерцающего [рендерера alt-screen](/docs/ru/fullscreen) с виртуализированной прокруткой или `"default"` для классического рендерера основного экрана. Запуск `/tui fullscreen` или `/tui default` записывает этот ключ для вас.

3952 3955

3953* **Область действия**: [`Любой файл`](#scopes)3956* **Область действия**: [`Any file`](#scopes)

3954* **Тип**: строка, одна из:3957* **Тип**: строка, одно из:

3955 * `"default"`: классический рендерер основного экрана3958 * `"default"`: классический рендерер основного экрана

3956 * `"fullscreen"`: безмерцающий рендерер alt-screen с виртуализированной прокруткой3959 * `"fullscreen"`: безмерцающий рендерер alt-screen с виртуализированной прокруткой

3957* **По умолчанию**: не установлено, поэтому Claude Code [выбирает рендерер для вас](/docs/ru/fullscreen#fullscreen-by-default)3960* **По умолчанию**: не установлено, поэтому Claude Code [выбирает рендерер для вас](/docs/ru/fullscreen#fullscreen-by-default)

3958* **Переопределения для каждого сеанса**: [`CLAUDE_CODE_NO_FLICKER`](/docs/ru/env-vars) и [`CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN`](/docs/ru/env-vars) имеют приоритет над этим ключом для одного сеанса: `CLAUDE_CODE_NO_FLICKER=1` включает полноэкранный режим, и `CLAUDE_CODE_NO_FLICKER=0` или `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1` отключает его; когда оба установлены, Claude Code отключает его3961* **Переопределения для отдельного сеанса**: [`CLAUDE_CODE_NO_FLICKER`](/docs/ru/env-vars) и [`CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN`](/docs/ru/env-vars) имеют приоритет над этим ключом для одного сеанса: `CLAUDE_CODE_NO_FLICKER=1` включает полноэкранный режим, и `CLAUDE_CODE_NO_FLICKER=0` или `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1` отключает его; когда оба установлены, Claude Code отключает его

3959 3962

3960```json settings.json theme={null}3963```json settings.json theme={null}

3961{3964{

3963}3966}

3964```3967```

3965 3968

3966Под tmux `-CC` или через SSH на Windows Claude Code сохраняет классический рендерер, если вы не установите `CLAUDE_CODE_NO_FLICKER=1`. Фоновые сеансы, открытые из [представления агента](/docs/ru/agent-view), всегда используют полноэкранный рендерер независимо от этого параметра.3969Под tmux `-CC` или через SSH в Windows Claude Code сохраняет классический рендерер, если вы не установите `CLAUDE_CODE_NO_FLICKER=1`. Фоновые сеансы, открытые из [представления агента](/docs/ru/agent-view), всегда используют рендерер полноэкранного режима независимо от этого параметра.

3967 3970

3968<h3 id="verbose">3971<h3 id="verbose">

3969 `verbose`3972 `verbose`

3971 3974

3972По умолчанию стенограмма сворачивает каждый вызов инструмента в краткое резюме, такое как команда, которую запустил Claude, и количество строк его вывода, и вы нажимаете `Ctrl+O`, чтобы переключить всю стенограмму в развернутое представление, когда вы хотите детали. Установите этот ключ на `true`, чтобы показать полный ввод и вывод каждого вызова инструмента встроенным по мере его выполнения, что полезно, когда вы отлаживаете hook, MCP-сервер или длинную команду оболочки. Появляется в `/config` как **Verbose output**.3975По умолчанию стенограмма сворачивает каждый вызов инструмента в краткое резюме, такое как команда, которую запустил Claude, и количество строк его вывода, и вы нажимаете `Ctrl+O`, чтобы переключить всю стенограмму в развернутое представление, когда вы хотите детали. Установите этот ключ на `true`, чтобы показать полный ввод и вывод каждого вызова инструмента встроенным по мере его выполнения, что полезно, когда вы отлаживаете hook, MCP-сервер или длинную команду оболочки. Появляется в `/config` как **Verbose output**.

3973 3976

3974* **Область действия**: [`Любой файл`](#scopes). Значение в `~/.claude.json` из более старой версии применяется, когда ни один файл параметров его не устанавливает.3977* **Область действия**: [`Any file`](#scopes). Значение в `~/.claude.json` из более старой версии применяется, когда ни один файл параметров его не устанавливает.

3975* **Тип**: Boolean3978* **Тип**: Boolean

3976 * `true`: вы видите полный вывод инструмента3979 * `true`: вы видите полный вывод инструмента

3977 * `false`: вы видите усеченные резюме вывода инструмента3980 * `false`: вы видите усеченные резюме вывода инструмента

3978* **По умолчанию**: `false`3981* **По умолчанию**: `false`

3979* **Переопределения для каждого сеанса**: [`--verbose`](/docs/ru/cli-reference#cli-flags) имеет приоритет над этим ключом для одного сеанса3982* **Переопределения для отдельного сеанса**: [`--verbose`](/docs/ru/cli-reference#cli-flags) имеет приоритет над этим ключом для одного сеанса

3980 3983

3981```json settings.json theme={null}3984```json settings.json theme={null}

3982{3985{

3990 `viewMode`3993 `viewMode`

3991</h3>3994</h3>

3992 3995

3993Установите представление стенограммы, в котором Claude Code начинает: `"default"`, `"verbose"` или `"focus"`. Когда установлено, оно переопределяет как липкий выбор `/focus`, так и параметр [`verbose`](#verbose).3996Установите представление стенограммы, в котором Claude Code начинается: `"default"`, `"verbose"` или `"focus"`. Когда установлено, оно переопределяет как липкий выбор `/focus`, так и параметр [`verbose`](#verbose).

3994 3997

3995* **Область действия**: [`Любой файл`](#scopes)3998* **Область действия**: [`Any file`](#scopes)

3996* **Тип**: строка, одна из:3999* **Тип**: строка, одно из:

3997 * `"default"`: нормальная стенограмма с усеченным выводом инструмента4000 * `"default"`: нормальная стенограмма с усеченным выводом инструмента

3998 * `"verbose"`: стенограмма с полным выводом инструмента4001 * `"verbose"`: стенограмма с полным выводом инструмента

3999 * `"focus"`: только ваше последнее приглашение, однострочное резюме вызовов инструментов с редактированием diffstats и финальный ответ. Представление Focus требует [полноэкранного рендерера](#tui)4002 * `"focus"`: только ваше последнее приглашение, однострочное резюме вызовов инструментов с редактированием diffstats и финальный ответ. Представление Focus требует [рендерера полноэкранного режима](#tui)

4000* **По умолчанию**: не установлено, поэтому параметр `verbose` и ваш последний выбор `/focus` применяются4003* **По умолчанию**: не установлено, поэтому параметр `verbose` и ваш последний выбор `/focus` применяются

4001* **Переопределения для каждого сеанса**: [`--verbose`](/docs/ru/cli-reference#cli-flags) имеет приоритет над этим ключом для одного сеанса4004* **Переопределения для отдельного сеанса**: [`--verbose`](/docs/ru/cli-reference#cli-flags) имеет приоритет над этим ключом для одного сеанса

4002 4005

4003```json settings.json theme={null}4006```json settings.json theme={null}

4004{4007{

4010 `vimInsertModeRemaps`4013 `vimInsertModeRemaps`

4011</h3>4014</h3>

4012 4015

4013Сопоставьте двухклавишные последовательности режима INSERT с Escape в [режиме редактора vim](/docs/ru/interactive-mode#vim-editor-mode). Каждый ключ — это ровно два печатаемых символа, введенные последовательно, и `"<Esc>"` — единственная поддерживаемая цель; Claude Code игнорирует другие записи. Требуется Claude Code v2.1.208 или позже.4016Сопоставьте двухклавишные последовательности режима INSERT с Escape в [режиме редактора vim](/docs/ru/interactive-mode#vim-editor-mode). Каждый ключ — это ровно два печатаемых символа, введенные последовательно, и `"<Esc>"` — единственная поддерживаемая цель; Claude Code игнорирует другие записи. Требуется Claude Code v2.1.208 или более поздняя версия.

4014 4017

4015* **Область действия**: [`Пользователь или управляемый`](#scopes). Репозиторий не может переназначить ваши нажатия клавиш.4018* **Область действия**: [`User or managed`](#scopes). Репозиторий не может переназначить ваши нажатия клавиш.

4016* **Тип**: объект, сопоставляющий двухсимвольную последовательность с `"<Esc>"`4019* **Тип**: объект, сопоставляющий двухсимвольную последовательность с `"<Esc>"`

4017* **По умолчанию**: не установлено4020* **По умолчанию**: не установлено

4018 4021

4024}4027}

4025```4028```

4026 4029

4027Не имеет эффекта, если `editorMode` не `"vim"`. См. [Переназначение последовательностей клавиш режима INSERT](/docs/ru/interactive-mode#remap-insert-mode-key-sequences). Требуется Claude Code v2.1.208 или позже.4030Не имеет эффекта, если `editorMode` не `"vim"`. См. [Переназначение последовательностей клавиш режима INSERT](/docs/ru/interactive-mode#remap-insert-mode-key-sequences). Требуется Claude Code v2.1.208 или более поздняя версия.

4028 4031

4029<h3 id="voice">4032<h3 id="voice">

4030 `voice`4033 `voice`

4032 4035

4033Включите [голосовую диктовку](/docs/ru/voice-dictation) и выберите, как ведет себя клавиша диктовки. Claude Code записывает этот объект для вас, когда вы запускаете `/voice`.4036Включите [голосовую диктовку](/docs/ru/voice-dictation) и выберите, как ведет себя клавиша диктовки. Claude Code записывает этот объект для вас, когда вы запускаете `/voice`.

4034 4037

4035* **Область действия**: [`Любой файл`](#scopes)4038* **Область действия**: [`Any file`](#scopes)

4036* **Тип**: объект с `enabled` как Boolean, `autoSubmit` как Boolean, который применяется только в режиме удержания, и `mode`, одна из:4039* **Тип**: объект с `enabled` как Boolean, `autoSubmit` как Boolean, который применяется только в режиме удержания, и `mode`, одно из:

4037 * `"hold"`: вы удерживаете клавишу диктовки во время разговора и отпускаете ее, чтобы остановить4040 * `"hold"`: вы удерживаете клавишу диктовки во время разговора и отпускаете ее, чтобы остановить

4038 * `"tap"`: вы нажимаете клавишу один раз, чтобы начать запись, и снова, чтобы отправить4041 * `"tap"`: вы нажимаете клавишу один раз, чтобы начать запись, и снова, чтобы отправить

4039* **По умолчанию**: не установлено, поэтому диктовка отключена; когда `enabled` — это `true` и `mode` не установлен, Claude Code использует `"hold"`4042* **По умолчанию**: не установлено, поэтому диктовка отключена; когда `enabled` — это `true` и `mode` не установлен, Claude Code использует `"hold"`

4049}4052}

4050```4053```

4051 4054

4052`autoSubmit` отправляет приглашение, когда вы отпускаете клавишу в режиме удержания. Голосовая диктовка требует учетной записи claude.ai.4055`autoSubmit` отправляет приглашение, когда вы отпускаете клавишу в режиме удержания. Голосовая диктовка требует учетную запись claude.ai.

4053 4056

4054<h3 id="voiceenabled">4057<h3 id="voiceenabled">

4055 `voiceEnabled`4058 `voiceEnabled`

4061 4064

4062Включите голосовую диктовку с одной формой Boolean, которая предшествует объекту `voice`. Когда оба установлены, применяется `voice.enabled`.4065Включите голосовую диктовку с одной формой Boolean, которая предшествует объекту `voice`. Когда оба установлены, применяется `voice.enabled`.

4063 4066

4064* **Область действия**: [`Любой файл`](#scopes)4067* **Область действия**: [`Any file`](#scopes)

4065* **Тип**: Boolean4068* **Тип**: Boolean

4066 * `true`: голосовая диктовка включена, когда вы вошли с учетной записью claude.ai и политика вашей организации позволяет голос, если только `voice.enabled` не установлен4069 * `true`: голосовая диктовка включена, когда вы вошли с учетной записью claude.ai и политика вашей организации позволяет голос, если только `voice.enabled` не установлен

4067 * `false`: голосовая диктовка отключена, если только `voice.enabled` не установлен4070 * `false`: голосовая диктовка отключена, если только `voice.enabled` не установлен

4077 `wheelScrollAccelerationEnabled`4080 `wheelScrollAccelerationEnabled`

4078</h3>4081</h3>

4079 4082

4080Ускорьте скорость прокрутки колеса мыши во время быстрой прокрутки в [полноэкранном режиме](/docs/ru/fullscreen#mouse-wheel-scrolling). Установите это на `false` для постоянной скорости прокрутки на каждый щелчок колеса.4083Ускорьте скорость прокрутки колеса мыши во время быстрой прокрутки при [полноэкранном отображении](/docs/ru/fullscreen#mouse-wheel-scrolling). Установите это значение на `false` для постоянной скорости прокрутки на каждую выемку колеса.

4081 4084

4082* **Область действия**: [`Любой файл`](#scopes)4085* **Область действия**: [`Any file`](#scopes)

4083* **Тип**: Boolean4086* **Тип**: Boolean

4084 * `true`: Claude Code ускоряет скорость прокрутки колеса мыши во время быстрой прокрутки4087 * `true`: Claude Code ускоряет скорость прокрутки колеса мыши во время быстрой прокрутки

4085 * `false`: Claude Code прокручивает с постоянной скоростью на каждый щелчок колеса4088 * `false`: Claude Code прокручивается с постоянной скоростью на каждую выемку колеса

4086* **По умолчанию**: `true`4089* **По умолчанию**: `true`

4087 4090

4088```json settings.json theme={null}4091```json settings.json theme={null}

4305Когда вы устанавливаете это значение в `true`, Claude Code изменяет, какие hooks и похожие на hooks команды загружаются:4308Когда вы устанавливаете это значение в `true`, Claude Code изменяет, какие hooks и похожие на hooks команды загружаются:

4306 4309

4307* **Запускаются управляемые и SDK hooks**: hooks из управляемых параметров и hooks, которые [Agent SDK](/docs/ru/agent-sdk/overview) регистрирует в процессе4310* **Запускаются управляемые и SDK hooks**: hooks из управляемых параметров и hooks, которые [Agent SDK](/docs/ru/agent-sdk/overview) регистрирует в процессе

4308* **Запускаются hooks принудительно включённых плагинов**: hooks из плагинов, которые ваши управляемые параметры принудительно включают через [`enabledPlugins`](#enabledplugins). Claude Code сопоставляет полный ID `plugin@marketplace`, поэтому плагин с тем же именем из другого marketplace остаётся заблокированным. Это позволяет вам распространять проверенные hooks через организационный marketplace, блокируя всё остальное4311* **Запускаются hooks принудительно включённых плагинов**: hooks из плагинов, которые ваши управляемые параметры принудительно включают через [`enabledPlugins`](#enabledplugins). Claude Code сопоставляет полный ID `plugin@marketplace`, поэтому плагин с тем же именем из другого marketplace остаётся заблокированным. Это позволяет вам распространять проверенные hooks через организационный marketplace, блокируя всё остальное. [Mod](/docs/ru/plugins/mods/overview) в таком плагине загружается только когда он [считается вашей организацией](/docs/ru/plugins/mods/admin#install-your-organizations-mods)

4309* **Всё остальное блокируется**: пользовательские, проектные и локальные hooks, hooks из других плагинов и hooks, объявленные в frontmatter агента4312* **Всё остальное блокируется**: пользовательские, проектные и локальные hooks, hooks и mods из других установленных плагинов, и hooks, объявленные в frontmatter агента. [Mods, встроенные в Claude Code](/docs/ru/plugins/mods/overview#mods-built-into-claude-code), продолжают работать. Чтобы блокировать только mods пользователей, установите вместо этого [`allowManagedModsOnly`](/docs/ru/plugins/mods/admin#set-options-on-the-built-in-guard).

4310* **Плагины с источником команды отключены**: Claude Code также отключает плагины с [источником `command`](/docs/ru/plugins/marketplace-reference#command-plugin-source), включая плагины, принудительно включённые в управляемых `enabledPlugins`, если вы не установите [`disableCommandPluginSources`](#disablecommandpluginsources) явно в `false`4313* **Плагины с источником команды отключены**: Claude Code также отключает плагины с [источником `command`](/docs/ru/plugins/marketplace-reference#command-plugin-source), включая плагины, принудительно включённые в управляемых `enabledPlugins`, если вы не установите [`disableCommandPluginSources`](#disablecommandpluginsources) явно в `false`

4311* **Команды marketplace `headersHelper` блокируются**: Claude Code также блокирует команды marketplace [`headersHelper`](/docs/ru/plugins/host-marketplace#authenticate-archive-downloads), если [`disableCommandPluginSources`](#disablecommandpluginsources) явно не установлен в `false`, за исключением marketplace, который сами управляемые параметры объявляют. Требуется Claude Code v2.1.238 или позже4314* **Команды marketplace `headersHelper` блокируются**: Claude Code также блокирует команды marketplace [`headersHelper`](/docs/ru/plugins/host-marketplace#authenticate-archive-downloads), если [`disableCommandPluginSources`](#disablecommandpluginsources) явно не установлен в `false`, за исключением marketplace, который сами управляемые параметры объявляют. Требуется Claude Code v2.1.238 или позже

4312* **Строка состояния и предложение файла сужаются до управляемых параметров**: Claude Code читает [`statusLine`](/docs/ru/statusline), [`fileSuggestion`](#filesuggestion) и [`subagentStatusLine`](/docs/ru/statusline#subagent-status-lines) только из управляемых параметров, следуя [шлюзам строки состояния и предложения файла](#status-line-and-file-suggestion-gates)4315* **Строка состояния и предложение файла сужаются до управляемых параметров**: Claude Code читает [`statusLine`](/docs/ru/statusline), [`fileSuggestion`](#filesuggestion) и [`subagentStatusLine`](/docs/ru/statusline#subagent-status-lines) только из управляемых параметров, следуя [шлюзам строки состояния и предложения файла](#status-line-and-file-suggestion-gates)

5046* **`git`**: любой git URL, с `url`5049* **`git`**: любой git URL, с `url`

5047* **`url`**: прямой URL к файлу `marketplace.json`, с `url` и необязательными `headers` и `headersHelper` для аутентифицированного доступа. `headersHelper` называет команду, которая печатает заголовки, чьи значения слишком недолговечны для перечисления в `headers`, и требует Claude Code v2.1.238 или позже5050* **`url`**: прямой URL к файлу `marketplace.json`, с `url` и необязательными `headers` и `headersHelper` для аутентифицированного доступа. `headersHelper` называет команду, которая печатает заголовки, чьи значения слишком недолговечны для перечисления в `headers`, и требует Claude Code v2.1.238 или позже

5048* **`file`**: локальный путь к файлу `marketplace.json`, с `path`5051* **`file`**: локальный путь к файлу `marketplace.json`, с `path`

5049* **`directory`**: локальный путь файловой системы, с `path`, только для разработки5052* **`directory`**: локальный путь файловой системы, с `path`. Используйте его для разработки или для маркетплейса, который ваша организация [развёртывает на каждой машине](/docs/ru/plugins/mods/admin#install-your-organizations-mods).

5050* **`settings`**: встроенный маркетплейс, объявленный непосредственно в файле параметров без размещённого репозитория, с `name` и `plugins`5053* **`settings`**: встроенный маркетплейс, объявленный непосредственно в файле параметров без размещённого репозитория, с `name` и `plugins`

5051 5054

5052Тип источника `git` работает с любым сервисом размещения git, включая самостоятельно размещённые GitLab и Bitbucket. Claude Code клонирует репозиторий с той же аутентификацией, которую использовал бы `git clone` на этой машине: настроенные помощники учётных данных или ключи SSH. Токен поставщика, такой как `GITHUB_TOKEN`, вступает в силу через помощника учётных данных, который его читает. См. [Приватные репозитории](/docs/ru/plugins/host-marketplace#grant-access-to-a-private-marketplace) для деталей настройки.5055Тип источника `git` работает с любым сервисом размещения git, включая самостоятельно размещённые GitLab и Bitbucket. Claude Code клонирует репозиторий с той же аутентификацией, которую использовал бы `git clone` на этой машине: настроенные помощники учётных данных или ключи SSH. Токен поставщика, такой как `GITHUB_TOKEN`, вступает в силу через помощника учётных данных, который его читает. См. [Приватные репозитории](/docs/ru/plugins/host-marketplace#grant-access-to-a-private-marketplace) для деталей настройки.

5133 5136

5134Claude Code игнорирует записи проекта и локальные, потому что он подставляет эти значения в конфигурации hook, MCP и LSP плагина, и клонированный репозиторий не должен быть в состоянии их предоставить. До v2.1.207, параметры проекта и локальные также читались.5137Claude Code игнорирует записи проекта и локальные, потому что он подставляет эти значения в конфигурации hook, MCP и LSP плагина, и клонированный репозиторий не должен быть в состоянии их предоставить. До v2.1.207, параметры проекта и локальные также читались.

5135 5138

5139<h3 id="prependplugins">

5140 `prependPlugins`

5141</h3>

5142

5143Перечислите управляемые плагины, чьи [mods](/docs/ru/plugins/mods/overview) запускаются перед каждым mod, который устанавливает пользователь, в указанном порядке. Когда вы установите этот ключ в управляемых параметрах, назовите `sec-default@builtin` в списке, чтобы сохранить встроенную защиту. В управляемых параметрах Claude Code пропускает id, чей плагин не считается вашей организацией. См. [Установите mods вашей организации и установите порядок](/docs/ru/plugins/mods/admin#install-your-organizations-mods) для этих условий и для того, как два ключа упорядочения работают вместе.

5144

5145* **Scope**: [`User or managed`](#scopes). Claude Code читает ключ из управляемых параметров. Он читает ключ из пользовательских параметров только на машине без управляемых параметров, для пользователя, который не вошёл с планом Team или Enterprise. Он игнорирует ключ в параметрах проекта и локальных и в файле `--settings`.

5146* **Type**: массив строк `plugin-name@marketplace-name`

5147* **Default**: не установлено

5148

5149```json managed-settings.json theme={null}

5150{

5151 "extraKnownMarketplaces": {

5152 "acme-tools": {

5153 "source": { "source": "directory", "path": "/opt/acme/claude-plugins" }

5154 }

5155 },

5156 "enabledPlugins": { "acme-guard@acme-tools": true },

5157 "prependPlugins": ["acme-guard@acme-tools", "sec-default@builtin"]

5158}

5159```

5160

5161<h3 id="appendplugins">

5162 `appendPlugins`

5163</h3>

5164

5165Перечислите управляемые плагины, чьи [mods](/docs/ru/plugins/mods/overview) запускаются после каждого mod, который устанавливает пользователь, в указанном порядке. Id, перечисленный в обоих `prependPlugins` и `appendPlugins`, добавляется в начало. В управляемых параметрах Claude Code пропускает id, чей плагин не [считается вашей организацией](/docs/ru/plugins/mods/admin#install-your-organizations-mods).

5166

5167* **Scope**: [`User or managed`](#scopes). Claude Code читает ключ из управляемых параметров. Он читает ключ из пользовательских параметров только на машине без управляемых параметров, для пользователя, который не вошёл с планом Team или Enterprise. Он игнорирует ключ в параметрах проекта и локальных и в файле `--settings`.

5168* **Type**: массив строк `plugin-name@marketplace-name`

5169* **Default**: не установлено

5170

5171```json managed-settings.json theme={null}

5172{

5173 "extraKnownMarketplaces": {

5174 "acme-tools": {

5175 "source": { "source": "directory", "path": "/opt/acme/claude-plugins" }

5176 }

5177 },

5178 "enabledPlugins": { "acme-audit@acme-tools": true },

5179 "appendPlugins": ["acme-audit@acme-tools"]

5180}

5181```

5182

5136<h2 id="mcp">5183<h2 id="mcp">

5137 MCP5184 MCP

5138</h2>5185</h2>

5653 5700

5654* **Scope**: [`Any file`](#scopes)5701* **Scope**: [`Any file`](#scopes)

5655* **Type**: Boolean5702* **Type**: Boolean

5656 * `true`: Claude Code отключает инструмент Artifact для каждого сеанса, к которому применяется файл, и ни один другой файл не включает его обратно. До версии 2.1.242 файл с более высоким приоритетом мог переопределить `true` файла с более низким приоритетом, вместо того чтобы ключ действовал как блокировка5703 * `true`: Claude Code отключает инструмент Artifact для каждого сеанса, к которому применяется файл, и ни один другой файл не включает его обратно

5657 * `false`: игнорируется; чтобы оставить инструмент включённым, удалите ключ5704 * `false`: игнорируется; чтобы оставить инструмент включённым, удалите ключ

5658* **Default**: не установлено, поэтому инструмент следует [доступности](/docs/ru/artifacts#availability) вашей учётной записи5705* **Default**: не установлено, поэтому инструмент следует [доступности](/docs/ru/artifacts#availability) вашей учётной записи

5659* **Per-session overrides**: [`CLAUDE_CODE_DISABLE_ARTIFACT`](/docs/ru/env-vars) установленный на `1` отключает инструмент для одного сеанса5706* **Per-session overrides**: [`CLAUDE_CODE_DISABLE_ARTIFACT`](/docs/ru/env-vars) установленный на `1` отключает инструмент для одного сеанса

5740}5787}

5741```5788```

5742 5789

5743Пока источник, отличный от ваших собственных пользовательских настроек, держит инструмент отключённым, Claude Code скрывает строку **Artifacts** в `/config`, потому что включение её там не изменит ничего. [Disable artifacts](/docs/ru/artifacts#disable-artifacts) перечисляет все способы отключения инструмента. До версии 2.1.242 Claude Code игнорировал этот ключ в проектных и локальных настройках, и файл выше в [стеке приоритета](/docs/ru/settings#settings-precedence) мог включить инструмент обратно над отключением файла ниже.5790Пока источник, отличный от ваших собственных пользовательских настроек, держит инструмент отключённым, Claude Code скрывает строку **Artifacts** в `/config`, потому что включение её там не изменит ничего. [Disable artifacts](/docs/ru/artifacts#disable-artifacts) перечисляет все способы отключения инструмента.

5744 5791

5745<h3 id="inputneedednotifenabled">5792<h3 id="inputneedednotifenabled">

5746 `inputNeededNotifEnabled`5793 `inputNeededNotifEnabled`

5879 5926

5880Предоставляйте учетные данные через вспомогательные скрипты и, для организаций, принудительно установите метод входа или организацию. См. [Аутентификация](/docs/ru/authentication).5927Предоставляйте учетные данные через вспомогательные скрипты и, для организаций, принудительно установите метод входа или организацию. См. [Аутентификация](/docs/ru/authentication).

5881 5928

5929<h3 id="allowedproviders">

5930 `allowedProviders`

5931</h3>

5932

5933Перечислите сервисы, через которые машина может обращаться к Claude, такие как Anthropic API, Amazon Bedrock или LLM gateway. Сеанс на поставщике, который не указан в списке, отклоняется при запуске, при входе и когда он в следующий раз обращается к API, поэтому переключение на неуказанного поставщика во время сеанса также отклоняется. [Сообщение об отказе](/docs/ru/errors#managed-settings-dont-allow-this-api-provider) указывает, что выбрало поставщика и какие шаги предпринять для продолжения. Требуется Claude Code v2.1.285 или позже.

5934

5935* **Scope**: [`Managed`](#scopes). Список, который устанавливают собственные источники администратора машины, политики MDM и файлы управляемых параметров, продолжает применяться, когда управляемые сервером параметры также предоставляют один: сеанс может затем использовать только поставщиков из обоих списков, поэтому управляемый сервером список может сузить то, что разрешает машина, но никогда не расширить это. Какой источник машины `allowedProviders` считается, следует [как Claude Code объединяет управляемые источники](/docs/ru/managed-settings#how-claude-code-combines-managed-sources). Список, доставленный только через управляемые сервером параметры, достигает только сеансов, которые [получают управляемые сервером параметры](/docs/ru/server-managed-settings#platform-availability).

5936* **Type**: array of strings, each one of:

5937 * `"anthropic"`: Anthropic API на собственном хосте Anthropic, через вход claude.ai или Console или API ключ. Объедините это с [`forceLoginMethod`](#forceloginmethod) или [`forceLoginOrgUUID`](#forceloginorguuid) чтобы также ограничить вход

5938 * `"bedrock"`: [Amazon Bedrock](/docs/ru/amazon-bedrock)

5939 * `"vertex"`: [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai), ранее Vertex AI

5940 * `"foundry"`: [Microsoft Foundry](/docs/ru/microsoft-foundry)

5941 * `"anthropicAws"`: [Claude Platform on AWS](/docs/ru/claude-platform-on-aws)

5942 * `"mantle"`: конечная точка Amazon Bedrock [Mantle](/docs/ru/amazon-bedrock#use-the-mantle-endpoint). Сеанс, который [запускает Mantle вместе с Invoke API](/docs/ru/amazon-bedrock#run-mantle-alongside-the-invoke-api), использует обоих поставщиков, поэтому перечислите `"bedrock"` и `"mantle"` вместе для него

5943 * `"customEndpoint"`: Anthropic API или API облачного поставщика, отправленные на другой хост, такой как [LLM gateway](/docs/ru/llm-gateway), названный `ANTHROPIC_BASE_URL`, переменная `ANTHROPIC_*_BASE_URL` поставщика или значение `ANTHROPIC_FOUNDRY_RESOURCE`, которое не является простым именем ресурса. Claude Code допускает это только для точного значения, которое управляемый блок [`env`](#env) закрепляет

5944 * `"gateway"`: вход [Cloud gateway](/docs/ru/claude-apps-gateway)

5945* **Default**: unset, so any provider can be used

5946

5947```json managed-settings.json theme={null}

5948{

5949 "allowedProviders": ["anthropic", "bedrock"]

5950}

5951```

5952

5953Запись каждого облачного поставщика означает собственный сервис этого поставщика, включая его региональные, FIPS и приватные конечные точки.

5954

5955Запись, которую Claude Code не распознает как имя поставщика, удаляется и сообщается, а остальная часть списка остается в силе. С пустым списком или списком, каждая запись которого не распознана, Claude Code отклоняет каждого поставщика и не запускается на машине.

5956

5957<h4 id="endpoints-that-need-a-pin-in-managed-env">

5958 Конечные точки, которым нужен pin в управляемом `env`

5959</h4>

5960

5961Pin — это значение переменной конечной точки, установленное в управляемом блоке [`env`](#env). Когда сеанс отправляет трафик поставщика куда-то, кроме собственного сервиса этого поставщика, Claude Code допускает это только если значение сеанса совпадает с pin. Эти конечные точки нуждаются в одном:

5962

5963* **`"customEndpoint"` сеансы**: переменная, которая называет хост, такая как `ANTHROPIC_BASE_URL`

5964* **Amazon Bedrock**: переменные AWS SDK `AWS_ENDPOINT_URL`, `AWS_ENDPOINT_URL_BEDROCK` и `AWS_ENDPOINT_URL_BEDROCK_RUNTIME` когда они указывают вне собственного сервиса Bedrock. Сеанс остается под `"bedrock"` вместо `"customEndpoint"`

5965* **URL входа шлюза**: сеанс остается под `"gateway"`, и [`forceLoginGatewayUrl`](#forcelogingatewayurl) также считается pin

5966

5967Какие блоки `env` считаются pin, зависит от того, где установлен список:

5968

5969* **Источник администратора на машине устанавливает список**: только блоки `env` собственных источников администратора машины считаются

5970* **Только управляемые сервером параметры устанавливают список**: значение `env` в этих управляемых сервером параметрах также считается

5971

5972Список не судит переменные учетных данных и арендатора облачного поставщика или сетевой путь, такие как `HTTPS_PROXY` и параметры сертификата. Установите их для флота в управляемом блоке `env`.

5973

5882<h3 id="apikeyhelper">5974<h3 id="apikeyhelper">

5883 `apiKeyHelper`5975 `apiKeyHelper`

5884</h3>5976</h3>

6401| :- | :- | :- |6493| :- | :- | :- |

6402| Списки | Объединяет записи из каждого источника | [`permissions.allow`](#permissions-allow), [`sandbox.network.allowedDomains`](#sandbox-network-alloweddomains) и другие ключи списков |6494| Списки | Объединяет записи из каждого источника | [`permissions.allow`](#permissions-allow), [`sandbox.network.allowedDomains`](#sandbox-network-alloweddomains) и другие ключи списков |

6403| Блокировки | Применяет самое строгое значение, которое устанавливает любой источник. Когда ни один источник не устанавливает строгое значение, применяет более мягкое значение только из источника с наивысшим приоритетом | [`allowManagedPermissionRulesOnly`](#allowmanagedpermissionrulesonly), [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) и другие логические или перечисляемые блокировки |6495| Блокировки | Применяет самое строгое значение, которое устанавливает любой источник. Когда ни один источник не устанавливает строгое значение, применяет более мягкое значение только из источника с наивысшим приоритетом | [`allowManagedPermissionRulesOnly`](#allowmanagedpermissionrulesonly), [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) и другие логические или перечисляемые блокировки |

6404| Списки ограничений | Берет список целиком из источника с наивысшим приоритетом, который его устанавливает, без добавления записей из более низких источников. Когда источник с наивысшим приоритетом его не устанавливает, берет его целиком из следующего источника вниз | [`availableModels`](#availablemodels), [`allowedMcpServers`](#allowedmcpservers), [`strictKnownMarketplaces`](#strictknownmarketplaces), [`allowedChannelPlugins`](#allowedchannelplugins) и цепь [`fallbackModel`](#fallbackmodel) |6496| Списки ограничений | Берет список целиком из источника с наивысшим приоритетом, который его устанавливает, без добавления записей из более низких источников. Когда источник с наивысшим приоритетом его не устанавливает, берет его целиком из следующего источника вниз | [`availableModels`](#availablemodels), [`allowedMcpServers`](#allowedmcpservers), [`allowedProviders`](#allowedproviders), [`strictKnownMarketplaces`](#strictknownmarketplaces), [`allowedChannelPlugins`](#allowedchannelplugins) и цепь [`fallbackModel`](#fallbackmodel) |

6405| Значения, взятые целиком | Берет значение целиком из источника с наивысшим приоритетом, который его устанавливает, без объединения записей или полей из более низких источников. Когда источник с наивысшим приоритетом его не устанавливает, берет его целиком из следующего источника вниз | [`sandbox.credentials.awsPairs`](#sandbox-credentials-awspairs), [`sandbox.ripgrep`](#sandbox-ripgrep) |6497| Значения, взятые целиком | Берет значение целиком из источника с наивысшим приоритетом, который его устанавливает, без объединения записей или полей из более низких источников. Когда источник с наивысшим приоритетом его не устанавливает, берет его целиком из следующего источника вниз | [`sandbox.credentials.awsPairs`](#sandbox-credentials-awspairs), [`sandbox.ripgrep`](#sandbox-ripgrep) |

6406| Предоставленные MCP серверы | Объединяет имена серверов из каждого источника. Когда два источника устанавливают одно имя, применяет всю запись источника с более высоким приоритетом | [`managedMcpServers`](#managedmcpservers) |6498| Предоставленные MCP серверы | Объединяет имена серверов из каждого источника. Когда два источника устанавливают одно имя, применяет всю запись источника с более высоким приоритетом | [`managedMcpServers`](#managedmcpservers) |

6407| Читается только из источника с наивысшим приоритетом | Читает ключ только из источника с наивысшим приоритетом, который содержит ключ политики, поэтому значение более низкого источника игнорируется даже когда источник с наивысшим приоритетом его не устанавливает | [`apiKeyHelper`](#apikeyhelper), [`awsAuthRefresh`](#awsauthrefresh), [`awsCredentialExport`](#awscredentialexport), [`gcpAuthRefresh`](#gcpauthrefresh), [`otelHeadersHelper`](#otelheadershelper), `proxyAuthHelper`, [`forceLoginOrgUUID`](#forceloginorguuid), значения `"claudeai"` и `"console"` [`forceLoginMethod`](#forceloginmethod), [`parentSettingsBehavior`](#parentsettingsbehavior), [`modelPicker`](#modelpicker), [`policyHelper`](#policyhelper), [`permissions.defaultMode`](#permissions-defaultmode) |6499| Читается только из источника с наивысшим приоритетом | Читает ключ только из источника с наивысшим приоритетом, который содержит ключ политики, поэтому значение более низкого источника игнорируется даже когда источник с наивысшим приоритетом его не устанавливает | [`apiKeyHelper`](#apikeyhelper), [`awsAuthRefresh`](#awsauthrefresh), [`awsCredentialExport`](#awscredentialexport), [`gcpAuthRefresh`](#gcpauthrefresh), [`otelHeadersHelper`](#otelheadershelper), `proxyAuthHelper`, [`forceLoginOrgUUID`](#forceloginorguuid), значения `"claudeai"` и `"console"` [`forceLoginMethod`](#forceloginmethod), [`parentSettingsBehavior`](#parentsettingsbehavior), [`modelPicker`](#modelpicker), [`policyHelper`](#policyhelper), [`permissions.defaultMode`](#permissions-defaultmode) |

6415* **[`policyHelper`](#policyhelper)**: Claude Code соблюдает это только когда источник с наивысшим приоритетом, который содержит ключ политики, является политикой MDM или файлом управляемых параметров, поэтому при управляемых параметрах сервера это не применяется.6507* **[`policyHelper`](#policyhelper)**: Claude Code соблюдает это только когда источник с наивысшим приоритетом, который содержит ключ политики, является политикой MDM или файлом управляемых параметров, поэтому при управляемых параметрах сервера это не применяется.

6416* **[`modelOverrides`](#modeloverrides)**: связан с `availableModels`. Claude Code берет `modelOverrides` из источника с наивысшим приоритетом, который его устанавливает, если только более высокий источник не устанавливает `availableModels` без `modelOverrides`. В этом случае он игнорирует `modelOverrides` из каждого источника.6508* **[`modelOverrides`](#modeloverrides)**: связан с `availableModels`. Claude Code берет `modelOverrides` из источника с наивысшим приоритетом, который его устанавливает, если только более высокий источник не устанавливает `availableModels` без `modelOverrides`. В этом случае он игнорирует `modelOverrides` из каждого источника.

6417* **[`forceLoginGatewayUrl`](#forcelogingatewayurl), [`gatewayInternalNetworks`](#gatewayinternalnetworks) и значение `"gateway"` [`forceLoginMethod`](#forceloginmethod)**: Claude Code никогда не читает ни один из них из управляемых параметров сервера, поэтому значение там ни не применяется, ни не скрывает значение, установленное в политике MDM или файле управляемых параметров. Среди источников администратора на машине только источник с наивысшим рангом, который содержит ключ политики, поставляет их, независимо от того, присутствуют ли также управляемые параметры сервера.6509* **[`forceLoginGatewayUrl`](#forcelogingatewayurl), [`gatewayInternalNetworks`](#gatewayinternalnetworks) и значение `"gateway"` [`forceLoginMethod`](#forceloginmethod)**: Claude Code никогда не читает ни один из них из управляемых параметров сервера, поэтому значение там ни не применяется, ни не скрывает значение, установленное в политике MDM или файле управляемых параметров. Среди источников администратора на машине только источник с наивысшим рангом, который содержит ключ политики, поставляет их, независимо от того, присутствуют ли также управляемые параметры сервера.

6510* **[`allowedProviders`](#allowedproviders)**: после правила таблицы, список машины все еще ограничивает результат, как указано в примечании Scope записи.

6418 6511

6419Чтобы подтвердить, какие источники объединены на машине, запустите `/status` и [прочитайте строку `Setting sources`](/docs/ru/managed-settings#read-the-source-in-/status).6512Чтобы подтвердить, какие источники объединены на машине, запустите `/status` и [прочитайте строку `Setting sources`](/docs/ru/managed-settings#read-the-source-in-/status).

6420 6513

skills.md +1 −1

Details

740 740

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

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

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

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

745 745

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

statusline.md +7 −7

Details

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

21 21

22<Frame>22<Frame>

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

24</Frame>24</Frame>

25 25

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

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

94 94

95<Frame>95<Frame>

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

97</Frame>97</Frame>

98 98

99<Steps>99<Steps>

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

445 445

446<Frame>446<Frame>

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

448</Frame>448</Frame>

449 449

450<CodeGroup>450<CodeGroup>

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

514 514

515<Frame>515<Frame>

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

517</Frame>517</Frame>

518 518

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

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

612 612

613<Frame>613<Frame>

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

615</Frame>615</Frame>

616 616

617<CodeGroup>617<CodeGroup>

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

673 673

674<Frame>674<Frame>

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

676</Frame>676</Frame>

677 677

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

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

782 782

783<Frame>783<Frame>

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

785</Frame>785</Frame>

786 786

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

third-party-integrations.md +2 −0

Details

253 253

254Команды безопасности могут настроить управляемые разрешения для того, что Claude Code может и не может делать, которые не могут быть переопределены локальной конфигурацией. [Узнайте больше](/docs/ru/security).254Команды безопасности могут настроить управляемые разрешения для того, что Claude Code может и не может делать, которые не могут быть переопределены локальной конфигурацией. [Узнайте больше](/docs/ru/security).

255 255

256Чтобы ограничить, какие из этих вариантов развертывания может использовать управляемая машина, установите [`allowedProviders`](/docs/ru/settings-reference#allowedproviders) в управляемых параметрах. Например, `["bedrock"]` разрешает Amazon Bedrock и ничего больше; флот Bedrock, который также включает конечную точку Mantle, также указывает `"mantle"`. Запись указывает, какие переменные конечной точки также требуют управляемого закрепления `env`. Требуется Claude Code v2.1.285 или более поздняя версия.

257

256<h3 id="leverage-mcp-for-integrations">258<h3 id="leverage-mcp-for-integrations">

257 Используйте MCP для интеграций259 Используйте MCP для интеграций

258</h3>260</h3>

tools-reference.md +45 −30

Details

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

155</h3>155</h3>

156 156

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

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

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

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

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

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

163 163

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

165 165

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

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

168</h3>168</h3>

169 169

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

171 171

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

173 173

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

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

176 176

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

178 178

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

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

181</h4>181</h4>

182 182

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

184 184

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

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

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

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

189 189

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

191 191

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

193 193

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

195 195

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

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

198</h3>198</h3>

199 199

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

201 201

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

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

204</h4>

205

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

207

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

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

210</h4>

203 211

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

205 213

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

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

216

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

218

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

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

221</h4>

208 222

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

210 224

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

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

213 227

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

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

230</h4>

215 231

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

217 233

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

219 235

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

221 237

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

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

224 240

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

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

227</h3>243</h3>

228 244

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

230 246

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

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

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

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

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

236 252

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

238 254

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

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

245 261

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

247 263

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

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

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

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

252 267

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

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

ultrareview.md +1 −1

Details

66 66

67В режиме PR удаленная изолированная среда клонирует запрос на слияние непосредственно с хоста, а не упаковывает ваше локальное рабочее дерево. Режим PR работает с репозиториями на `github.com` и на экземплярах [GitHub Enterprise Server](/docs/ru/github-enterprise-server), которые администратор подключил к Claude Code.67В режиме PR удаленная изолированная среда клонирует запрос на слияние непосредственно с хоста, а не упаковывает ваше локальное рабочее дерево. Режим PR работает с репозиториями на `github.com` и на экземплярах [GitHub Enterprise Server](/docs/ru/github-enterprise-server), которые администратор подключил к Claude Code.

68 68

69Для репозиториев на `github.com` изолированная среда клонирует с учетной записью GitHub, подключенной к вашей учетной записи Claude, поэтому учетная запись должна иметь возможность читать репозиторий PR. Claude Code проверяет это перед созданием облачной сессии, если вы не установили [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ru/env-vars#variables), и отказывает в запуске, когда [нет подключенной учетной записи](/docs/ru/errors#no-github-account-is-connected-to-your-claude-account) или [учетная запись не может видеть репозиторий](/docs/ru/errors#your-connected-github-account-cant-see-the-repository); отказ указывает на исправление. До версии 2.1.248 Claude Code не проверял это перед запуском.69Для репозиториев на `github.com` изолированная среда клонирует с учетной записью GitHub, подключенной к вашей учетной записи Claude, поэтому учетная запись должна иметь возможность читать репозиторий PR.

70 70

71Запустите [`/web-setup`](/docs/ru/web-quickstart#connect-from-your-terminal), чтобы подключить вашу учетную запись GitHub CLI к вашей учетной записи Claude.71Запустите [`/web-setup`](/docs/ru/web-quickstart#connect-from-your-terminal), чтобы подключить вашу учетную запись GitHub CLI к вашей учетной записи Claude.

72 72

vs-code.md +25 −5

Details

58 58

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

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

61 * **Status Bar**: если вы установили [`preferredLocation`](#extension-settings) на `sidebar` или открыли Claude с помощью **Claude Code: Open in Side Bar**, нажмите **✻ Claude Code** в нижнем правом углу окна. Это работает даже при отсутствии открытого файла.61 * **Status Bar**: нажмите **✻ Claude Code** в нижнем правом углу окна. Это работает даже при отсутствии открытого файла.

62 62

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

64 </Step>64 </Step>

362 362

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

364 364

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

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

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

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

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

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

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

375 376

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

378

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

380

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

382

383<h3 id="uninstall-plugins">

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

385</h3>

386

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

388

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

390

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

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

393

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

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

378</h3>396</h3>

407 425

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

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

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

429

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

411 431

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

413 433

414<Note>434<Note>

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

7904. **Отключите конфликтующие расширения**: Временно отключите другие расширения ИИ (Cline, Continue и т. д.)8104. **Отключите конфликтующие расширения**: Временно отключите другие расширения ИИ (Cline, Continue и т. д.)

7915. **Проверьте доверие рабочей области**: Расширение не работает в режиме ограниченного доступа8115. **Проверьте доверие рабочей области**: Расширение не работает в режиме ограниченного доступа

792 812

793Кроме того, если вы установили [`preferredLocation`](#extension-settings) на `sidebar` или открыли Claude с помощью **Claude Code: Open in Side Bar**, нажмите "✻ Claude Code" на **строке состояния** (в нижнем правом углу). Это работает даже без открытого файла. Вы также можете использовать **палитру команд** (`Cmd+Shift+P` / `Ctrl+Shift+P`) и ввести "Claude Code".813Кроме того, нажмите **✻ Claude Code** на **строке состояния** (в нижнем правом углу окна). Это работает даже без открытого файла. Вы также можете использовать **палитру команд** (`Cmd+Shift+P` / `Ctrl+Shift+P`) и ввести "Claude Code".

794 814

795<h3 id="cmd-esc-does-nothing-on-macos">815<h3 id="cmd-esc-does-nothing-on-macos">

796 Cmd+Esc ничего не делает на macOS816 Cmd+Esc ничего не делает на macOS

worktrees.md +1 −1

Details

145* Worktree принадлежит сеансу `--worktree`, который вы не отправили в фон, независимо от его возраста.145* Worktree принадлежит сеансу `--worktree`, который вы не отправили в фон, независимо от его возраста.

146* Вы создали worktree самостоятельно с `git worktree add`, даже если вы затем запустили сеанс `--worktree <name>` в нём и отправили этот сеанс в фон.146* Вы создали worktree самостоятельно с `git worktree add`, даже если вы затем запустили сеанс `--worktree <name>` в нём и отправили этот сеанс в фон.

147 147

148Claude Code записывает маркер в метаданные git каждого worktree, который он создаёт с git, и очистка сохраняет любой worktree без него, включая worktree, который создал hook [`WorktreeCreate`](#non-git-version-control). До версии 2.1.246 очистка не проверяла маркер и могла удалить worktree, который вы создали самостоятельно, когда старая запись фонового сеанса указывала на него.148Claude Code записывает маркер в метаданные git каждого worktree, который он создаёт с git, и очистка сохраняет любой worktree без него, включая worktree, который создал hook [`WorktreeCreate`](#non-git-version-control).

149 149

150Пока агент работает, Claude Code держит `git worktree lock` на его worktree, чтобы одновременная очистка не могла его удалить, и освобождает блокировку, когда агент завершает работу. Claude Code держит ту же блокировку на worktree, который он создал для фонового сеанса, пока сеанс работает, поэтому очистка оставляет worktree на месте и `git worktree remove` отказывает его удалить.150Пока агент работает, Claude Code держит `git worktree lock` на его worktree, чтобы одновременная очистка не могла его удалить, и освобождает блокировку, когда агент завершает работу. Claude Code держит ту же блокировку на worktree, который он создал для фонового сеанса, пока сеанс работает, поэтому очистка оставляет worktree на месте и `git worktree remove` отказывает его удалить.

151 151

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