SpyBara
Go Premium

Documentation 2026-06-23 22:00 UTC to 2026-06-24 22:02 UTC

26 files changed +183 −63. View all changes and history on the product overview
2026
Sat 27 01:01 Fri 26 23:00 Thu 25 23:58 Wed 24 22:02 Tue 23 22:00 Mon 22 23:59 Fri 19 22:58 Thu 18 22:00 Wed 17 17:02 Tue 16 21:57 Mon 15 23:02 Sat 13 21:59 Fri 12 22:00 Thu 11 23:01 Wed 10 23:57 Tue 9 06:34 Mon 8 06:52 Sat 6 06:24 Fri 5 06:45 Thu 4 06:52 Wed 3 06:53 Tue 2 06:51

admin-setup.md +3 −2

Details

63 63 

64По умолчанию WSL читает только путь Linux в `/etc/claude-code`. Чтобы расширить вашу политику реестра Windows и `C:\Program Files\ClaudeCode` на WSL на одной машине, установите [`wslInheritsWindowsSettings: true`](/ru/settings#available-settings) в одном из этих источников, доступных только администратору Windows.64По умолчанию WSL читает только путь Linux в `/etc/claude-code`. Чтобы расширить вашу политику реестра Windows и `C:\Program Files\ClaudeCode` на WSL на одной машине, установите [`wslInheritsWindowsSettings: true`](/ru/settings#available-settings) в одном из этих источников, доступных только администратору Windows.

65 65 

66Какой бы механизм вы ни выбрали, управляемые значения имеют приоритет над параметрами пользователя и проекта. Параметры массива, такие как `permissions.allow` и `permissions.deny`, объединяют записи из всех источников, поэтому разработчики могут расширять управляемые списки, но не удалять из них.66Какой бы механизм вы ни выбрали, управляемые значения имеют приоритет над параметрами пользователя и проекта. Параметры массива, такие как `permissions.allow` и `permissions.deny`, объединяют записи из всех источников, поэтому разработчики могут расширять управляемые списки, но не удалять из них, с [двумя исключениями](/ru/settings#settings-precedence), где управляемое значение заменяет нижние слои, а не объединяется: `fallbackModel` и `availableModels`.

67 67 

68См. [Server-managed settings](/ru/server-managed-settings) и [Settings files and precedence](/ru/settings#settings-files).68См. [Server-managed settings](/ru/server-managed-settings) и [Settings files and precedence](/ru/settings#settings-files).

69 69 


74Управляемые параметры могут заблокировать инструменты, изоляцию песочницы, ограничить серверы MCP и источники плагинов, а также контролировать, какие hooks запускаются. Каждая строка — это поверхность управления с ключами параметров, которые ее управляют.74Управляемые параметры могут заблокировать инструменты, изоляцию песочницы, ограничить серверы MCP и источники плагинов, а также контролировать, какие hooks запускаются. Каждая строка — это поверхность управления с ключами параметров, которые ее управляют.

75 75 

76| Управление | Что оно делает | Ключевые параметры |76| Управление | Что оно делает | Ключевые параметры |

77| :------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------- |77| :------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------- |

78| [Permission rules](/ru/permissions) | Разрешить, спросить или запретить определенные инструменты и команды | `permissions.allow`, `permissions.deny` |78| [Permission rules](/ru/permissions) | Разрешить, спросить или запретить определенные инструменты и команды | `permissions.allow`, `permissions.deny` |

79| [Permission lockdown](/ru/permissions#managed-only-settings) | Применяются только управляемые правила разрешений; отключить `--dangerously-skip-permissions` | `allowManagedPermissionRulesOnly`, `permissions.disableBypassPermissionsMode` |79| [Permission lockdown](/ru/permissions#managed-only-settings) | Применяются только управляемые правила разрешений; отключить `--dangerously-skip-permissions` | `allowManagedPermissionRulesOnly`, `permissions.disableBypassPermissionsMode` |

80| [Sandboxing](/ru/sandboxing) | Изоляция файловой системы и сети на уровне ОС с разрешенными списками доменов | `sandbox.enabled`, `sandbox.network.allowedDomains` |80| [Sandboxing](/ru/sandboxing) | Изоляция файловой системы и сети на уровне ОС с разрешенными списками доменов | `sandbox.enabled`, `sandbox.network.allowedDomains` |


84| [Customization lockdown](/ru/settings#strictpluginonlycustomization) | Заблокировать skills, agents, hooks и серверы MCP из источников пользователя и проекта, чтобы они могли поступать только из плагинов или управляемых параметров | `strictPluginOnlyCustomization` |84| [Customization lockdown](/ru/settings#strictpluginonlycustomization) | Заблокировать skills, agents, hooks и серверы MCP из источников пользователя и проекта, чтобы они могли поступать только из плагинов или управляемых параметров | `strictPluginOnlyCustomization` |

85| [Hook restrictions](/ru/settings#hook-configuration) | Загружаются только управляемые hooks; ограничить URL-адреса HTTP hook | `allowManagedHooksOnly`, `allowedHttpHookUrls` |85| [Hook restrictions](/ru/settings#hook-configuration) | Загружаются только управляемые hooks; ограничить URL-адреса HTTP hook | `allowManagedHooksOnly`, `allowedHttpHookUrls` |

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

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

87| [Version floor](/ru/settings) | Предотвратить автоматическое обновление от установки ниже минимума на уровне организации | `minimumVersion` |88| [Version floor](/ru/settings) | Предотвратить автоматическое обновление от установки ниже минимума на уровне организации | `minimumVersion` |

88| [Required version range](/ru/settings) | Отказать в запуске полностью, когда запущенная версия находится вне одобренного организацией диапазона. Более строгий, чем `minimumVersion`, который только блокирует понижение версии | `requiredMinimumVersion`, `requiredMaximumVersion` |89| [Required version range](/ru/settings) | Отказать в запуске полностью, когда запущенная версия находится вне одобренного организацией диапазона. Более строгий, чем `minimumVersion`, который только блокирует понижение версии | `requiredMinimumVersion`, `requiredMaximumVersion` |

89 90 

advisor.md +4 −4

Details

52/advisor opus52/advisor opus

53```53```

54 54 

55Ваш выбор сохраняется в `advisorModel` в параметрах пользователя и сохраняется между сеансами. Если ваша текущая основная модель не поддерживает советника, выбор всё равно сохраняется и активируется при переключении на [совместимую основную модель](#choose-an-advisor-model) с помощью [`/model`](/ru/model-config#setting-your-model).55Ваш выбор сохраняется в `advisorModel` в параметрах пользователя и сохраняется между сеансами. Если [`availableModels`](/ru/model-config#restrict-model-selection) вашей организации исключает сохранённую модель советника из списка разрешённых, советник не будет вызван до тех пор, пока вы не выберете разрешённую модель с помощью `/advisor`. Если ваша текущая основная модель не поддерживает советника, выбор всё равно сохраняется и активируется при переключении на [совместимую основную модель](#choose-an-advisor-model) с помощью [`/model`](/ru/model-config#setting-your-model).

56 56 

57<h3 id="set-advisormodel-in-settings">57<h3 id="set-advisormodel-in-settings">

58 Установка `advisorModel` в параметрах58 Установка `advisorModel` в параметрах


76claude --advisor opus76claude --advisor opus

77```77```

78 78 

79Флаг имеет приоритет над параметром `advisorModel` для этого сеанса. В отличие от `/advisor`, который сохраняет неактивный выбор, флаг завершается с ошибкой, если основная модель сеанса не поддерживает советника.79Флаг имеет приоритет над параметром `advisorModel` для этого сеанса. Он завершается с ошибкой, если основная модель сеанса не поддерживает советника, или если запрошенная модель советника исключена [`availableModels`](/ru/model-config#restrict-model-selection) вашей организации.

80 80 

81<h2 id="choose-an-advisor-model">81<h2 id="choose-an-advisor-model">

82 Выбор модели советника82 Выбор модели советника


182Советник — это один из нескольких способов объединить сильные стороны моделей. Выбирайте в зависимости от того, когда вы хотите, чтобы вторая модель была задействована.182Советник — это один из нескольких способов объединить сильные стороны моделей. Выбирайте в зависимости от того, когда вы хотите, чтобы вторая модель была задействована.

183 183 

184| Подход | Когда работает более мощная модель | Как это начинается |184| Подход | Когда работает более мощная модель | Как это начинается |

185| ------------------------------------------------------------------ | ------------------------------------------------------------------- | ------------------------------------------------- |185| ------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- |

186| Инструмент advisor | В точках принятия решений во время задачи | Claude вызывает его, когда ему нужна рекомендация |186| Инструмент advisor | В точках принятия решений во время задачи | Claude вызывает его, когда ему нужна рекомендация |

187| [`opusplan`](/ru/model-config#opusplan-model-setting) | Во время режима плана, затем переключается на Sonnet для выполнения | Вы входите в режим плана |187| [`opusplan`](/ru/model-config#opusplan-model-setting) | Во время режима плана, когда [разрешено `availableModels`](/ru/model-config#restrict-model-selection), затем переключается на Sonnet для выполнения | Вы входите в режим плана |

188| [Subagents](/ru/sub-agents#choose-a-model) с установленным `model` | Для всей делегированной подзадачи | Claude делегирует или вы вызываете subagent |188| [Subagents](/ru/sub-agents#choose-a-model) с установленным `model` | Для всей делегированной подзадачи | Claude делегирует или вы вызываете subagent |

189| [`/model`](/ru/model-config#setting-your-model) | Для всех последующих ходов | Вы переключаете модели |189| [`/model`](/ru/model-config#setting-your-model) | Для всех последующих ходов | Вы переключаете модели |

190 190 

Details

86`settingSources` охватывает пользовательские, проектные и локальные параметры. Несколько входов читаются независимо от его значения:86`settingSources` охватывает пользовательские, проектные и локальные параметры. Несколько входов читаются независимо от его значения:

87 87 

88| Вход | Поведение | Для отключения |88| Вход | Поведение | Для отключения |

89| :----------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |89| :----------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

90| Параметры управляемой политики | Всегда загружаются при наличии на хосте | Удалите файл управляемых параметров |90| Параметры управляемой политики | Политика, управляемая конечной точкой, будь то MDM plist, политика реестра или файлы управляемых параметров, загружается с хоста; [параметры, управляемые сервером](/ru/server-managed-settings), загружаются при аутентификации сеанса с помощью входа OAuth организации или напрямую настроенного ключа API на [подходящей конфигурации](/ru/server-managed-settings#platform-availability) | Политика конечной точки: удалите файл управляемых параметров, plist или политику реестра с хоста. Параметры, управляемые сервером: контролируются администратором вашей организации; не могут быть отключены из SDK |

91| `~/.claude.json` глобальная конфигурация | Всегда читается | Переместите с помощью `CLAUDE_CONFIG_DIR` в `env` |91| `~/.claude.json` глобальная конфигурация | Всегда читается | Переместите с помощью `CLAUDE_CONFIG_DIR` в `env` |

92| Автоматическая память в `~/.claude/projects/<project>/memory/` | Загружается по умолчанию в системный запрос | Установите `autoMemoryEnabled: false` в параметрах или `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` в `env` |92| Автоматическая память в `~/.claude/projects/<project>/memory/` | Загружается по умолчанию в системный запрос | Установите `autoMemoryEnabled: false` в параметрах или `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` в `env` |

93| [claude.ai MCP connectors](/ru/mcp#use-mcp-servers-from-claude-ai) | Загружаются, когда активный метод аутентификации — это подписка claude.ai. Передача `mcpServers: {}` их не подавляет | Установите `strictMcpConfig: true`, [`disableClaudeAiConnectors: true`](/ru/mcp#disable-claude-ai-connectors) в параметрах или `ENABLE_CLAUDEAI_MCP_SERVERS=false` в `env` |93| [claude.ai MCP connectors](/ru/mcp#use-mcp-servers-from-claude-ai) | Загружаются, когда активный метод аутентификации — это подписка claude.ai. Передача `mcpServers: {}` их не подавляет | Установите `strictMcpConfig: true`, [`disableClaudeAiConnectors: true`](/ru/mcp#disable-claude-ai-connectors) в параметрах или `ENABLE_CLAUDEAI_MCP_SERVERS=false` в `env` |

94 94 

95<Warning>95<Warning>

96 Не полагайтесь на параметры `query()` по умолчанию для изоляции в многопользовательской среде. Поскольку входы выше читаются независимо от `settingSources`, процесс SDK может подхватить конфигурацию уровня хоста и память для каждого каталога. Для развёртываний в многопользовательской среде запустите каждого пользователя в собственной файловой системе и установите `settingSources: []` плюс `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` в `env`. См. [Безопасное развёртывание](/ru/agent-sdk/secure-deployment).96 Не полагайтесь на параметры `query()` по умолчанию для изоляции в многопользовательской среде. Поскольку входы выше читаются независимо от `settingSources`, процесс SDK может подхватить конфигурацию уровня хоста и память для каждого каталога. Для развёртываний в многопользовательской среде запустите каждого пользователя в собственной файловой системе и установите `settingSources: []` плюс `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` в `env`. [Параметры, управляемые сервером](/ru/server-managed-settings), загружаются при аутентификации процесса с помощью учётных данных организации; изоляция файловой системы их не удаляет. См. [Безопасное развёртывание](/ru/agent-sdk/secure-deployment).

97</Warning>97</Warning>

98 98 

99<h2 id="project-instructions-claude-md-and-rules">99<h2 id="project-instructions-claude-md-and-rules">

Details

897```897```

898 898 

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

900| :---------------------------- | :------------------------------------------------------------------------------------ | :--------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |900| :---------------------------- | :------------------------------------------------------------------------------------ | :--------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

901| `tools` | `list[str] \| ToolsPreset \| None` | `None` | Конфигурация инструментов. Используйте `{"type": "preset", "preset": "claude_code"}` для инструментов Claude Code по умолчанию |901| `tools` | `list[str] \| ToolsPreset \| None` | `None` | Конфигурация инструментов. Используйте `{"type": "preset", "preset": "claude_code"}` для инструментов Claude Code по умолчанию |

902| `allowed_tools` | `list[str]` | `[]` | Инструменты для автоматического одобрения без запроса. Это не ограничивает Claude только этими инструментами; неуказанные инструменты переходят к `permission_mode` и `can_use_tool`. Используйте `disallowed_tools` для блокировки инструментов. См. [Permissions](/ru/agent-sdk/permissions#allow-and-deny-rules) |902| `allowed_tools` | `list[str]` | `[]` | Инструменты для автоматического одобрения без запроса. Это не ограничивает Claude только этими инструментами; неуказанные инструменты переходят к `permission_mode` и `can_use_tool`. Используйте `disallowed_tools` для блокировки инструментов. См. [Permissions](/ru/agent-sdk/permissions#allow-and-deny-rules) |

903| `system_prompt` | `str \| SystemPromptPreset \| None` | `None` | Конфигурация системной подсказки. Передайте строку для пользовательской подсказки или используйте `{"type": "preset", "preset": "claude_code"}` для системной подсказки Claude Code. Добавьте `"append"` для расширения предустановки |903| `system_prompt` | `str \| SystemPromptPreset \| None` | `None` | Конфигурация системной подсказки. Передайте строку для пользовательской подсказки или используйте `{"type": "preset", "preset": "claude_code"}` для системной подсказки Claude Code. Добавьте `"append"` для расширения предустановки |


933| `agents` | `dict[str, AgentDefinition] \| None` | `None` | Программно определенные подагенты |933| `agents` | `dict[str, AgentDefinition] \| None` | `None` | Программно определенные подагенты |

934| `plugins` | `list[SdkPluginConfig]` | `[]` | Загрузите пользовательские plugins из локальных путей. См. [Plugins](/ru/agent-sdk/plugins) для деталей |934| `plugins` | `list[SdkPluginConfig]` | `[]` | Загрузите пользовательские plugins из локальных путей. См. [Plugins](/ru/agent-sdk/plugins) для деталей |

935| `sandbox` | [`SandboxSettings`](#sandboxsettings) ` \| None` | `None` | Программно настройте поведение sandbox. См. [Sandbox settings](#sandboxsettings) для деталей |935| `sandbox` | [`SandboxSettings`](#sandboxsettings) ` \| None` | `None` | Программно настройте поведение sandbox. См. [Sandbox settings](#sandboxsettings) для деталей |

936| `setting_sources` | `list[SettingSource] \| None` | `None` (CLI defaults: all sources) | Контролируйте, какие параметры файловой системы загружать. Передайте `[]` для отключения пользовательских, проектных и локальных параметров. Управляемые параметры политики загружаются независимо. См. [Use Claude Code features](/ru/agent-sdk/claude-code-features#what-settingsources-does-not-control) |936| `setting_sources` | `list[SettingSource] \| None` | `None` (CLI defaults: all sources) | Контролируйте, какие параметры файловой системы загружать. Передайте `[]` для отключения пользовательских, проектных и локальных параметров. Управляемые параметры политики загружаются независимо; параметры, управляемые сервером, загружаются, когда сеанс аутентифицируется с учетными данными организации на [подходящей конфигурации](/ru/server-managed-settings#platform-availability). См. [Use Claude Code features](/ru/agent-sdk/claude-code-features#what-settingsources-does-not-control) для входов, которые читаются независимо от этой опции, и как их отключить |

937| `skills` | `list[str] \| Literal["all"] \| None` | `None` | Skills, доступные сеансу. Передайте `"all"` для включения каждого обнаруженного skill, или список имен skills. Когда установлено, SDK автоматически добавляет инструмент Skill в `allowed_tools`. Если вы также передаете `tools`, включите `"Skill"` в этот список. См. [Skills](/ru/agent-sdk/skills) |937| `skills` | `list[str] \| Literal["all"] \| None` | `None` | Skills, доступные сеансу. Передайте `"all"` для включения каждого обнаруженного skill, или список имен skills. Когда установлено, SDK автоматически добавляет инструмент Skill в `allowed_tools`. Если вы также передаете `tools`, включите `"Skill"` в этот список. См. [Skills](/ru/agent-sdk/skills) |

938| `max_thinking_tokens` | `int \| None` | `None` | *Устарело* - Максимальные токены для блоков мышления. Вместо этого используйте `thinking` |938| `max_thinking_tokens` | `int \| None` | `None` | *Устарело* - Максимальные токены для блоков мышления. Вместо этого используйте `thinking` |

939| `thinking` | [`ThinkingConfig`](#thinkingconfig) ` \| None` | `None` | Управляет поведением расширенного мышления. Имеет приоритет над `max_thinking_tokens` |939| `thinking` | [`ThinkingConfig`](#thinkingconfig) ` \| None` | `None` | Управляет поведением расширенного мышления. Имеет приоритет над `max_thinking_tokens` |


1022 Поведение по умолчанию1022 Поведение по умолчанию

1023</h4>1023</h4>

1024 1024 

1025Когда `setting_sources` опущено или `None`, `query()` загружает те же параметры файловой системы, что и Claude Code CLI: пользовательские, проектные и локальные. Управляемые параметры политики загружаются во всех случаях. См. [What settingSources does not control](/ru/agent-sdk/claude-code-features#what-settingsources-does-not-control) для входов, которые читаются независимо от этой опции, и как их отключить.1025Когда `setting_sources` опущено или `None`, `query()` загружает те же параметры файловой системы, что и Claude Code CLI: пользовательские, проектные и локальные. Управляемые параметры политики загружаются во всех случаях; параметры, управляемые сервером, загружаются, когда сеанс аутентифицируется с учетными данными организации на [подходящей конфигурации](/ru/server-managed-settings#platform-availability). См. [What settingSources does not control](/ru/agent-sdk/claude-code-features#what-settingsources-does-not-control) для входов, которые читаются независимо от этой опции, и как их отключить.

1026 1026 

1027<h4 id="why-use-setting_sources">1027<h4 id="why-use-setting_sources">

1028 Почему использовать setting\_sources1028 Почему использовать setting\_sources

Details

421| Параметр | Тип | По умолчанию | Описание |421| Параметр | Тип | По умолчанию | Описание |

422| :------------------------------ | :------------------------------------ | :-------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |422| :------------------------------ | :------------------------------------ | :-------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

423| `options.cwd` | `string` | `process.cwd()` | Директория для разрешения параметров проекта и локальных параметров относительно |423| `options.cwd` | `string` | `process.cwd()` | Директория для разрешения параметров проекта и локальных параметров относительно |

424| `options.settingSources` | [`SettingSource`](#settingsource)`[]` | Все источники | Какие источники файловой системы загружать. Передайте `[]` для пропуска пользовательских, проектных и локальных параметров. Параметры управляемой политики загружаются во всех случаях |424| `options.settingSources` | [`SettingSource`](#settingsource)`[]` | Все источники | Какие источники файловой системы загружать. Передайте `[]` для пропуска пользовательских, проектных и локальных параметров. Параметры управляемой политики загружаются во всех случаях. Параметры, управляемые сервером, берутся из `serverManagedSettings`, когда хост их передаёт, или читаются из кэша CLI на диске в противном случае; снимок не загружает их из сети |

425| `options.managedSettings` | `Settings` | `undefined` | Ограничивающие параметры уровня политики, предоставленные хостом встраивания. Отбрасываются по умолчанию, когда присутствует развёрнутый администратором управляемый уровень; объединяются под этим уровнем, когда [`parentSettingsBehavior`](/ru/settings#available-settings) равен `"merge"`. Неограничивающие ключи, такие как `model`, молча отбрасываются, поэтому этот параметр может усилить управляемую политику, но не ослабить её |425| `options.managedSettings` | `Settings` | `undefined` | Ограничивающие параметры уровня политики, предоставленные хостом встраивания. Отбрасываются по умолчанию, когда присутствует развёрнутый администратором управляемый уровень; объединяются под этим уровнем, когда [`parentSettingsBehavior`](/ru/settings#available-settings) равен `"merge"`. Неограничивающие ключи, такие как `model`, молча отбрасываются, поэтому этот параметр может усилить управляемую политику, но не ослабить её |

426| `options.serverManagedSettings` | `Settings` | `undefined` | Полезная нагрузка параметров, управляемых сервером, из `/api/claude_code/settings`. Неограничивающие ключи проходят без фильтрации |426| `options.serverManagedSettings` | `Settings` | `undefined` | Полезная нагрузка параметров, управляемых сервером, из `/api/claude_code/settings`. Неограничивающие ключи проходят без фильтрации |

427 427 


517| `sessionStore` | [`SessionStore`](/ru/agent-sdk/session-storage#the-sessionstore-interface) | `undefined` | Зеркалируйте транскрипты сессий на внешний бэкенд, чтобы любой хост мог их возобновить. См. [Persist sessions to external storage](/ru/agent-sdk/session-storage) |517| `sessionStore` | [`SessionStore`](/ru/agent-sdk/session-storage#the-sessionstore-interface) | `undefined` | Зеркалируйте транскрипты сессий на внешний бэкенд, чтобы любой хост мог их возобновить. См. [Persist sessions to external storage](/ru/agent-sdk/session-storage) |

518| `sessionStoreFlush` | `'batched' \| 'eager'` | `'batched'` | *Alpha.* Режим flush для `sessionStore`. Игнорируется, когда `sessionStore` не установлен |518| `sessionStoreFlush` | `'batched' \| 'eager'` | `'batched'` | *Alpha.* Режим flush для `sessionStore`. Игнорируется, когда `sessionStore` не установлен |

519| `settings` | `string \| Settings` | `undefined` | Встроенный объект [settings](/ru/settings) или путь к файлу настроек. Заполняет слой flag-settings в [порядке приоритета](/ru/settings#settings-precedence). Измените во время выполнения с помощью [`applyFlagSettings()`](#applyflagsettings) |519| `settings` | `string \| Settings` | `undefined` | Встроенный объект [settings](/ru/settings) или путь к файлу настроек. Заполняет слой flag-settings в [порядке приоритета](/ru/settings#settings-precedence). Измените во время выполнения с помощью [`applyFlagSettings()`](#applyflagsettings) |

520| `settingSources` | [`SettingSource`](#settingsource)`[]` | Значения по умолчанию CLI (все источники) | Контролируйте, какие настройки файловой системы загружать. Передайте `[]` для отключения пользовательских, проектных и локальных настроек. Управляемые политикой настройки загружаются независимо. См. [Use Claude Code features](/ru/agent-sdk/claude-code-features#what-settingsources-does-not-control) |520| `settingSources` | [`SettingSource`](#settingsource)`[]` | Значения по умолчанию CLI (все источники) | Контролируйте, какие настройки файловой системы загружать. Передайте `[]` для отключения пользовательских, проектных и локальных настроек. Управляемые политикой настройки загружаются независимо; серверные управляемые настройки загружаются, когда сессия аутентифицируется с учётными данными организации на [подходящей конфигурации](/ru/server-managed-settings#platform-availability). См. [Use Claude Code features](/ru/agent-sdk/claude-code-features#what-settingsources-does-not-control) |

521| `skills` | `string[] \| 'all'` | `undefined` | Skills доступные для сессии. Передайте `'all'` для включения каждого обнаруженного skill, или список имён skills. Когда установлено, SDK автоматически добавляет инструмент Skill в `allowedTools`. Если вы также передаёте `tools`, включите `'Skill'` в этот список. См. [Skills](/ru/agent-sdk/skills) |521| `skills` | `string[] \| 'all'` | `undefined` | Skills доступные для сессии. Передайте `'all'` для включения каждого обнаруженного skill, или список имён skills. Когда установлено, SDK автоматически добавляет инструмент Skill в `allowedTools`. Если вы также передаёте `tools`, включите `'Skill'` в этот список. См. [Skills](/ru/agent-sdk/skills) |

522| `spawnClaudeCodeProcess` | `(options: SpawnOptions) => SpawnedProcess` | `undefined` | Пользовательская функция для запуска процесса Claude Code. Используйте для запуска Claude Code на ВМ, контейнерах или удалённых окружениях |522| `spawnClaudeCodeProcess` | `(options: SpawnOptions) => SpawnedProcess` | `undefined` | Пользовательская функция для запуска процесса Claude Code. Используйте для запуска Claude Code на ВМ, контейнерах или удалённых окружениях |

523| `stderr` | `(data: string) => void` | `undefined` | Обратный вызов для вывода stderr |523| `stderr` | `(data: string) => void` | `undefined` | Обратный вызов для вывода stderr |


765 Default behavior765 Default behavior

766</h4>766</h4>

767 767 

768Когда `settingSources` опущено или `undefined`, `query()` загружает те же настройки файловой системы, что и CLI Claude Code: пользовательские, проектные и локальные. Управляемые политикой настройки загружаются во всех случаях. См. [What settingSources does not control](/ru/agent-sdk/claude-code-features#what-settingsources-does-not-control) для входных данных, которые читаются независимо от этой опции, и как их отключить.768Когда `settingSources` опущено или `undefined`, `query()` загружает те же настройки файловой системы, что и CLI Claude Code: пользовательские, проектные и локальные. Управляемые политикой настройки загружаются во всех случаях; серверные управляемые настройки загружаются, когда сессия аутентифицируется с учётными данными организации на [подходящей конфигурации](/ru/server-managed-settings#platform-availability). См. [What settingSources does not control](/ru/agent-sdk/claude-code-features#what-settingsources-does-not-control) для входных данных, которые читаются независимо от этой опции, и как их отключить.

769 769 

770<h4 id="why-use-settingsources">770<h4 id="why-use-settingsources">

771 Why use settingSources771 Why use settingSources

Details

477export CLAUDE_CODE_USE_MANTLE=1477export CLAUDE_CODE_USE_MANTLE=1

478```478```

479 479 

480Чтобы отобразить модель Mantle в средстве выбора `/model`, перечислите ее ID в `availableModels` в вашем [файле параметров](/ru/settings). Этот параметр также ограничивает средство выбора перечисленными записями, поэтому включите каждый псевдоним, который вы хотите сохранить доступным:480Чтобы отобразить модель Mantle в средстве выбора `/model`, перечислите ее ID в `availableModels` в вашем [файле параметров](/ru/settings). Этот параметр также ограничивает средство выбора перечисленными записями. Перечисление `anthropic.claude-haiku-4-5` удаляет простой псевдоним `haiku` из средства выбора, поэтому также перечислите префиксы версий или полные ID для версий, которые вы хотите сохранить доступными. См. [Merge behavior](/ru/model-config#merge-behavior):

481 481 

482```json theme={null}482```json theme={null}

483{483{

484 "availableModels": ["opus", "sonnet", "haiku", "anthropic.claude-haiku-4-5"]484 "availableModels": ["opus", "sonnet", "claude-haiku-4-5", "anthropic.claude-haiku-4-5"]

485}485}

486```486```

487 487 

Details

63 Что доступно в облачных сессиях63 Что доступно в облачных сессиях

64</h3>64</h3>

65 65 

66Облачные сессии начинаются со свежего клона вашего репозитория. Всё, что зафиксировано в репозитории, доступно. Всё, что вы установили или настроили только на своей машине, недоступно.66Облачные сессии начинаются со свежего клона вашего репозитория. Всё, что зафиксировано в репозитории, доступно. Всё, что вы установили или настроили только на своей машине, недоступно; политика вашей организации поступает отдельно через [параметры, управляемые сервером](/ru/server-managed-settings).

67 67 

68| | Доступно в облачных сессиях | Почему |68| | Доступно в облачных сессиях | Почему |

69| :------------------------------------------------------------------------------------ | :-------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |69| :------------------------------------------------------------------------------------ | :-------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

70| Ваш репозитория `CLAUDE.md` | Да | Часть клона |70| Ваш репозитория `CLAUDE.md` | Да | Часть клона |

71| Ваши hooks `.claude/settings.json` репозитория | Да | Часть клона |71| Ваши hooks `.claude/settings.json` репозитория | Да | Часть клона |

72| Ваши MCP серверы `.mcp.json` репозитория | Да | Часть клона |72| Ваши MCP серверы `.mcp.json` репозитория | Да | Часть клона |

73| Ваш `.claude/rules/` репозитория | Да | Часть клона |73| Ваш `.claude/rules/` репозитория | Да | Часть клона |

74| Ваш `.claude/skills/`, `.claude/agents/`, `.claude/commands/` репозитория | Да | Часть клона |74| Ваш `.claude/skills/`, `.claude/agents/`, `.claude/commands/` репозитория | Да | Часть клона |

75| Plugins объявленные в `.claude/settings.json` | Да | Установлены при запуске сессии из [marketplace](/ru/plugin-marketplaces), который вы объявили. Требует сетевого доступа для доступа к источнику marketplace |75| Plugins объявленные в `.claude/settings.json` | Да | Установлены при запуске сессии из [marketplace](/ru/plugin-marketplaces), который вы объявили. Требует сетевого доступа для доступа к источнику marketplace |

76| Ваши [параметры, управляемые сервером](/ru/server-managed-settings) организации | Да | Получены с серверов Anthropic при запуске сессии. См. [Охват поверхности](/ru/model-config#surface-coverage) для того, как `availableModels` применяется в облачных сессиях. Параметры, развёрнутые на вашем устройстве через MDM или файлы управляемых параметров, не применяются, потому что сессия работает на виртуальной машине, управляемой Anthropic |

76| Ваш пользовательский `~/.claude/CLAUDE.md` | Нет | Находится на вашей машине, не в репозитории |77| Ваш пользовательский `~/.claude/CLAUDE.md` | Нет | Находится на вашей машине, не в репозитории |

77| Ваши пользовательские `~/.claude/skills/`, `~/.claude/agents/`, `~/.claude/commands/` | Нет | Находятся на вашей машине, не в репозитории. Зафиксируйте их в директории `.claude/` репозитория вместо этого. Skills, которые вы включаете на claude.ai, автоматически загружаются в облачные сессии |78| Ваши пользовательские `~/.claude/skills/`, `~/.claude/agents/`, `~/.claude/commands/` | Нет | Находятся на вашей машине, не в репозитории. Зафиксируйте их в директории `.claude/` репозитория вместо этого. Skills, которые вы включаете на claude.ai, автоматически загружаются в облачные сессии |

78| Plugins включённые только в ваши пользовательские параметры | Нет | Пользовательский `enabledPlugins` находится в `~/.claude/settings.json`. Объявите их в `.claude/settings.json` репозитория вместо этого |79| Plugins включённые только в ваши пользовательские параметры | Нет | Пользовательский `enabledPlugins` находится в `~/.claude/settings.json`. Объявите их в `.claude/settings.json` репозитория вместо этого |


80| Статические API токены и учётные данные | Нет | Выделенного хранилища секретов пока не существует. См. ниже |81| Статические API токены и учётные данные | Нет | Выделенного хранилища секретов пока не существует. См. ниже |

81| Интерактивная аутентификация, такая как AWS SSO | Нет | Не поддерживается. SSO требует входа на основе браузера, который не может работать в облачной сессии |82| Интерактивная аутентификация, такая как AWS SSO | Нет | Не поддерживается. SSO требует входа на основе браузера, который не может работать в облачной сессии |

82 83 

83Чтобы сделать конфигурацию доступной в облачных сессиях, зафиксируйте её в репозитории. Выделенное хранилище секретов пока не доступно. Как переменные окружения, так и setup scripts хранятся в конфигурации окружения, видимой для всех, кто может редактировать это окружение. Если вам нужны секреты в облачной сессии, добавьте их как переменные окружения с учётом этой видимости.84Чтобы сделать конфигурацию доступной в облачных сессиях, зафиксируйте её в репозитории; политика организации поступает отдельно через [параметры, управляемые сервером](/ru/server-managed-settings). Выделенное хранилище секретов пока не доступно. Как переменные окружения, так и setup scripts хранятся в конфигурации окружения, видимой для всех, кто может редактировать это окружение. Если вам нужны секреты в облачной сессии, добавьте их как переменные окружения с учётом этой видимости.

84 85 

85<h3 id="installed-tools">86<h3 id="installed-tools">

86 Установленные инструменты87 Установленные инструменты


245| Запускается | Перед запуском Claude Code, когда нет [кэшированного окружения](#environment-caching) | После запуска Claude Code, на каждой сессии, включая возобновлённые |246| Запускается | Перед запуском Claude Code, когда нет [кэшированного окружения](#environment-caching) | После запуска Claude Code, на каждой сессии, включая возобновлённые |

246| Область | Только облачные окружения | Как локальные, так и облачные |247| Область | Только облачные окружения | Как локальные, так и облачные |

247 248 

248SessionStart hooks также могут быть определены в вашем пользовательском файле `~/.claude/settings.json` локально, но пользовательские параметры не переносятся в облачные сессии. В облаке запускаются только hooks, зафиксированные в репозитории.249SessionStart hooks также могут быть определены в вашем пользовательском файле `~/.claude/settings.json` локально, но пользовательские параметры не переносятся в облачные сессии. В облаке hooks поступают из репозитория и из [управляемых сервером параметров](/ru/server-managed-settings) вашей организации.

249 250 

250<h3 id="install-dependencies-with-a-sessionstart-hook">251<h3 id="install-dependencies-with-a-sessionstart-hook">

251 Install dependencies with a SessionStart hook252 Install dependencies with a SessionStart hook

commands.md +1 −1

Details

88| `/ide` | Управлять интеграциями IDE и показать статус |88| `/ide` | Управлять интеграциями IDE и показать статус |

89| `/init` | Инициализировать проект с руководством `CLAUDE.md`. Установите `CLAUDE_CODE_NEW_INIT=1` для интерактивного потока, который также проходит через skills, hooks и файлы личной памяти |89| `/init` | Инициализировать проект с руководством `CLAUDE.md`. Установите `CLAUDE_CODE_NEW_INIT=1` для интерактивного потока, который также проходит через skills, hooks и файлы личной памяти |

90| `/insights` | Создать отчет, анализирующий ваши сеансы Claude Code, включая области проекта, паттерны взаимодействия и точки трения |90| `/insights` | Создать отчет, анализирующий ваши сеансы Claude Code, включая области проекта, паттерны взаимодействия и точки трения |

91| `/install-github-app` | Установить приложение [Claude GitHub Actions](/ru/github-actions) для репозитория. Проведет вас через выбор репозитория и настройку интеграции |91| `/install-github-app` | Установить приложение Claude GitHub для репозитория с дополнительным шагом для настройки [GitHub Actions](/ru/github-actions) workflows и secrets. Проведет вас через выбор репозитория и настройку интеграции |

92| `/install-slack-app` | Установить приложение Claude Slack. Открывает браузер для завершения потока OAuth |92| `/install-slack-app` | Установить приложение Claude Slack. Открывает браузер для завершения потока OAuth |

93| `/keybindings` | Открыть файл [сочетаний клавиш](/ru/keybindings) |93| `/keybindings` | Открыть файл [сочетаний клавиш](/ru/keybindings) |

94| `/login` | Войти в вашу учетную запись Anthropic |94| `/login` | Войти в вашу учетную запись Anthropic |

desktop.md +8 −4

Details

691 Управляемые параметры691 Управляемые параметры

692</h3>692</h3>

693 693 

694Управляемые параметры переопределяют параметры проекта и пользователя и применяются, когда Desktop порождает сеансы CLI. Вы можете установить эти ключи в файле [управляемых параметров](/ru/settings#settings-precedence) вашей организации или отправить их удалённо через консоль администратора.694Управляемые параметры переопределяют параметры проекта и пользователя и применяются к сеансам Claude Code в Desktop. Вы можете установить эти ключи в файле [управляемых параметров](/ru/settings#settings-precedence) вашей организации или отправить их удалённо через консоль администратора.

695 695 

696| Ключ | Описание |696| Ключ | Описание |

697| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |697| ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

698| `permissions.disableBypassPermissionsMode` | установите на `"disable"`, чтобы предотвратить пользователей от включения режима обхода разрешений. |698| `permissions.disableBypassPermissionsMode` | установите на `"disable"`, чтобы предотвратить пользователей от включения режима обхода разрешений. |

699| `disableAutoMode` | установите на `"disable"`, чтобы предотвратить пользователей от включения режима [Auto](/ru/permission-modes#eliminate-prompts-with-auto-mode). Удаляет Auto из селектора режима. Также принимается под `permissions`. |699| `disableAutoMode` | установите на `"disable"`, чтобы предотвратить пользователей от включения режима [Auto](/ru/permission-modes#eliminate-prompts-with-auto-mode). Удаляет Auto из селектора режима. Также принимается под `permissions`. |

700| `autoMode` | настройте, что классификатор auto mode доверяет и блокирует во всей вашей организации. См. [Configure auto mode](/ru/auto-mode-config). |700| `autoMode` | настройте, что классификатор auto mode доверяет и блокирует во всей вашей организации. См. [Configure auto mode](/ru/auto-mode-config). |

701| `sshConfigs` | предварительно настройте [SSH-соединения](#pre-configure-ssh-connections-for-your-team), которые появляются в раскрывающемся списке окружения. Пользователи не могут редактировать или удалять управляемые соединения. |701| `sshConfigs` | предварительно настройте [SSH-соединения](#pre-configure-ssh-connections-for-your-team), которые появляются в раскрывающемся списке окружения. Пользователи не могут редактировать или удалять управляемые соединения. |

702| `sshHostAllowlist` | ограничьте [SSH-сеансы](#restrict-which-ssh-hosts-users-can-connect-to) хостами, чьё разрешённое имя хоста совпадает с одним из этих шаблонов. Пустой массив отключает SSH-сеансы. Читается только из управляемых параметров. |702| `sshHostAllowlist` | ограничьте [SSH-сеансы](#restrict-which-ssh-hosts-users-can-connect-to) хостами, чьё разрешённое имя хоста совпадает с одним из этих шаблонов. Пустой массив отключает SSH-сеансы. Читается только из управляемых параметров. |

703| `managedMcpServers` | отправьте конфигурации MCP-сервера всем пользователям в развёртывании третьей стороны. Каждая запись указывает транспорт `"http"`, `"sse"` или `"stdio"`, детали подключения и опционально карту `toolPolicy`, которая ограничивает, какие инструменты на этом сервере пользователи могут вызывать. Доступно только в развёртываниях Desktop третьей стороны (3P). |703| `managedMcpServers` | отправьте конфигурации MCP-сервера всем пользователям в развёртывании третьей стороны. Каждая запись указывает транспорт `"http"`, `"sse"` или `"stdio"`, детали подключения и опционально карту `toolPolicy`, которая ограничивает, какие инструменты на этом сервере пользователи могут вызывать. Доступно только в развёртываниях Desktop третьей стороны (3P). Доставляйте этот ключ через файл управляемых параметров или MDM, так как развёртывания третьей стороны не получают параметры консоли администратора. |

704 704 

705Управляемый файл параметров, развёрнутый на диск на каждой машине, применяется к сеансам Desktop. Управляемые параметры, отправленные удалённо через консоль администратора, в настоящее время достигают только сеансов CLI и IDE, поэтому для развёртываний Desktop либо распространяйте файл через MDM, либо используйте [элементы управления консоли администратора](#admin-console-controls) выше.705Какие управляемые параметры достигают сеанса Desktop, зависит от того, где этот сеанс работает. Ограничения модели, такие как [`availableModels`](/ru/model-config#restrict-model-selection), применяются в сеансах Claude Code Desktop так же, как в CLI терминала; см. [охват поверхности](/ru/model-config#surface-coverage).

706 

707* **Локальные сеансы на этой машине**: применяется файл управляемых параметров, развёрнутый на диск. Управляемые параметры, отправленные удалённо через консоль администратора, также достигают эти сеансы на API Anthropic, когда сеанс аутентифицируется с помощью входа в организацию или напрямую настроенного ключа API, следуя тому же [приоритету параметров](/ru/settings#settings-precedence), что и CLI терминала.

708* **[Облачные сеансы](#cloud-sessions)**: работают на управляемых Anthropic виртуальных машинах и получают только [параметры, управляемые сервером](/ru/server-managed-settings).

709* **[SSH-сеансы](#ssh-sessions)**: сеанс читает файл управляемых параметров с удалённого хоста. Desktop сам читает `sshConfigs` и `sshHostAllowlist` из управляемых параметров локальной машины при создании соединения.

706 710 

707`permissions.disableBypassPermissionsMode` и `disableAutoMode` также работают в параметрах пользователя и проекта, но размещение их в управляемых параметрах предотвращает пользователей от их переопределения. `autoMode` читается из параметров пользователя, `.claude/settings.local.json` и управляемых параметров, но не из проверенного `.claude/settings.json`: клонированный репо не может внедрить свои собственные правила классификатора. Для полного списка управляемых параметров, включая `allowManagedPermissionRulesOnly` и `allowManagedHooksOnly`, см. [managed-only settings](/ru/permissions#managed-only-settings).711`permissions.disableBypassPermissionsMode` и `disableAutoMode` также работают в параметрах пользователя и проекта, но размещение их в управляемых параметрах предотвращает пользователей от их переопределения. `autoMode` читается из параметров пользователя, `.claude/settings.local.json` и управляемых параметров, но не из проверенного `.claude/settings.json`: клонированный репо не может внедрить свои собственные правила классификатора. Для полного списка управляемых параметров, включая `allowManagedPermissionRulesOnly` и `allowManagedHooksOnly`, см. [managed-only settings](/ru/permissions#managed-only-settings).

708 712 

Details

330 330 

331Подробный вид показывает компоненты, которые предоставляет плагин: команды, skills, agents, hooks, MCP servers и LSP servers. Тот же инвентарь доступен из командной строки с помощью `claude plugin details`.331Подробный вид показывает компоненты, которые предоставляет плагин: команды, skills, agents, hooks, MCP servers и LSP servers. Тот же инвентарь доступен из командной строки с помощью `claude plugin details`.

332 332 

333В Claude Code v2.1.187 и более поздних версиях вкладка Installed добавляет группу **Not used recently** для плагинов из маркетплейса, которые вы установили сами, но не использовали в течение как минимум двух недель и как минимум 10 сеансов, а подробный вид показывает строку **Last used** для каждого плагина. Используйте их, чтобы найти плагины, которые вы больше не используете, но которые по-прежнему добавляют стоимость запуска и контекста, затем отключите или удалите их.

334 

335Плагины, которыми управляет ваша организация, или которые вы загружаете с помощью `--plugin-dir`, никогда не отображаются как неиспользуемые, и плагины, которые предоставляют LSP server, тему, стиль вывода, монитор или workflow, также никогда не отображаются, поскольку они обеспечивают ценность без вызова для отслеживания. Группа и строка **Last used** обе скрыты, когда ваша организация ограничивает маркетплейсы с помощью [`strictKnownMarketplaces`](/ru/settings#strictknownmarketplaces).

336 

333Когда вы устанавливаете плагин, который объявляет зависимости, вывод установки указывает, какие зависимости были автоматически установлены вместе с ним.337Когда вы устанавливаете плагин, который объявляет зависимости, вывод установки указывает, какие зависимости были автоматически установлены вместе с ним.

334 338 

335Вы также можете управлять плагинами с помощью прямых команд.339Вы также можете управлять плагинами с помощью прямых команд.

env-vars.md +1 −0

Details

230| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Максимальное количество инструментов только для чтения и subagents, которые могут выполняться параллельно (по умолчанию: 10). Более высокие значения увеличивают параллелизм, но потребляют больше ресурсов |230| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Максимальное количество инструментов только для чтения и subagents, которые могут выполняться параллельно (по умолчанию: 10). Более высокие значения увеличивают параллелизм, но потребляют больше ресурсов |

231| `CLAUDE_CODE_MAX_TURNS` | Ограничить количество агентских ходов, когда явный лимит не передан. Эквивалент передачи [`--max-turns`](/ru/cli-reference#cli-flags), который имеет приоритет, когда оба установлены. Значение, которое не является положительным целым числом, отклоняется при запуске с ошибкой, а не рассматривается как отсутствие лимита |231| `CLAUDE_CODE_MAX_TURNS` | Ограничить количество агентских ходов, когда явный лимит не передан. Эквивалент передачи [`--max-turns`](/ru/cli-reference#cli-flags), который имеет приоритет, когда оба установлены. Значение, которое не является положительным целым числом, отклоняется при запуске с ошибкой, а не рассматривается как отсутствие лимита |

232| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Установите на `1`, чтобы порождать stdio MCP servers с только безопасной базовой средой плюс настроенная `env` сервера, вместо наследования вашей среды оболочки |232| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Установите на `1`, чтобы порождать stdio MCP servers с только безопасной базовой средой плюс настроенная `env` сервера, вместо наследования вашей среды оболочки |

233| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | {/* min-version: 2.1.187 */}Тайм-аут неактивности в миллисекундах для удалённых вызовов инструментов MCP (по умолчанию: 300000, или 5 минут). Когда HTTP, SSE, WebSocket или [claude.ai connector](/ru/mcp#use-mcp-servers-from-claude-ai) MCP server не отправляет ответ и не отправляет уведомление о прогрессе в течение этого времени, вызов инструмента прерывается с ошибкой вместо ожидания стены часов `MCP_TOOL_TIMEOUT`. Установите на `0`, чтобы отключить проверку неактивности. Значения ниже 1000 повышаются до одной секунды, и значение ограничено эффективным `MCP_TOOL_TIMEOUT`. Не применяется к stdio или IDE servers. Требуется Claude Code v2.1.187 или более поздняя версия |

233| `CLAUDE_CODE_NATIVE_CURSOR` | Установите на `1`, чтобы показать собственный курсор терминала в позиции ввода вместо нарисованного блока. Курсор соблюдает параметры мигания, формы и фокуса терминала |234| `CLAUDE_CODE_NATIVE_CURSOR` | Установите на `1`, чтобы показать собственный курсор терминала в позиции ввода вместо нарисованного блока. Курсор соблюдает параметры мигания, формы и фокуса терминала |

234| `CLAUDE_CODE_NEW_INIT` | Установите на `1`, чтобы `/init` запустил интерактивный поток настройки. Поток спрашивает, какие файлы генерировать, включая CLAUDE.md, skills и hooks, перед исследованием кодовой базы и их написанием. Без этой переменной `/init` автоматически генерирует CLAUDE.md без запроса. |235| `CLAUDE_CODE_NEW_INIT` | Установите на `1`, чтобы `/init` запустил интерактивный поток настройки. Поток спрашивает, какие файлы генерировать, включая CLAUDE.md, skills и hooks, перед исследованием кодовой базы и их написанием. Без этой переменной `/init` автоматически генерирует CLAUDE.md без запроса. |

235| `CLAUDE_CODE_NO_FLICKER` | Установите на `1`, чтобы включить [полноэкранный режим](/ru/fullscreen), исследовательский предпросмотр, который уменьшает мерцание и сохраняет память плоской в длинных разговорах. Эквивалент параметра [`tui`](/ru/settings#available-settings); вы также можете переключаться с помощью `/tui fullscreen` |236| `CLAUDE_CODE_NO_FLICKER` | Установите на `1`, чтобы включить [полноэкранный режим](/ru/fullscreen), исследовательский предпросмотр, который уменьшает мерцание и сохраняет память плоской в длинных разговорах. Эквивалент параметра [`tui`](/ru/settings#available-settings); вы также можете переключаться с помощью `/tui fullscreen` |

errors.md +17 −0

Details

55| `Extra inputs are not permitted` | [Request errors](#extra-inputs-are-not-permitted) |55| `Extra inputs are not permitted` | [Request errors](#extra-inputs-are-not-permitted) |

56| `There's an issue with the selected model` | [Request errors](#there%E2%80%99s-an-issue-with-the-selected-model) |56| `There's an issue with the selected model` | [Request errors](#there%E2%80%99s-an-issue-with-the-selected-model) |

57| `Claude Opus is not available with the Claude Pro plan` | [Request errors](#claude-opus-is-not-available-with-the-claude-pro-plan) |57| `Claude Opus is not available with the Claude Pro plan` | [Request errors](#claude-opus-is-not-available-with-the-claude-pro-plan) |

58| `Model ... is restricted by your organization's settings` | [Request errors](#model-is-restricted-by-your-organization%E2%80%99s-settings) |

58| `thinking.type.enabled is not supported for this model` | [Request errors](#thinking-type-enabled-is-not-supported-for-this-model) |59| `thinking.type.enabled is not supported for this model` | [Request errors](#thinking-type-enabled-is-not-supported-for-this-model) |

59| `max_tokens must be greater than thinking.budget_tokens` | [Request errors](#thinking-budget-exceeds-output-limit) |60| `max_tokens must be greater than thinking.budget_tokens` | [Request errors](#thinking-budget-exceeds-output-limit) |

60| `API Error: 400 due to tool use concurrency issues` | [Request errors](#tool-use-or-thinking-block-mismatch) |61| `API Error: 400 due to tool use concurrency issues` | [Request errors](#tool-use-or-thinking-block-mismatch) |


706* Если вы недавно обновили свой план и все еще видите это, запустите `/logout`, затем `/login`. Сохраненный токен отражает ваш план на момент входа, поэтому обновление в Интернете не вступает в силу в существующем сеансе, пока вы не повторно аутентифицируетесь.707* Если вы недавно обновили свой план и все еще видите это, запустите `/logout`, затем `/login`. Сохраненный токен отражает ваш план на момент входа, поэтому обновление в Интернете не вступает в силу в существующем сеансе, пока вы не повторно аутентифицируетесь.

707* См. [claude.com/pricing](https://claude.com/pricing) для информации о том, какие модели включает каждый план708* См. [claude.com/pricing](https://claude.com/pricing) для информации о том, какие модели включает каждый план

708 709 

710<h3 id="model-is-restricted-by-your-organization’s-settings">

711 Model is restricted by your organization's settings

712</h3>

713 

714Администратор вашей организации отключил эту модель в Claude Console, или она исключена списком [`availableModels`](/ru/model-config#restrict-model-selection) в управляемых параметрах. Когда ограниченная модель была установлена с помощью `--model`, `ANTHROPIC_MODEL` или параметра `model`, Claude Code подставляет разрешенную модель и продолжает. Ввод `/model <name>` для ограниченной модели отклоняется с `Run /model to choose a different model.` и сеанс сохраняет свою текущую модель.

715 

716```text theme={null}

717Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.

718```

719 

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

721 

722* Запустите `/model`, чтобы выбрать из моделей, которые разрешает ваша организация. Ограниченные модели скрыты от средства выбора.

723* Если ограниченная модель была установлена в `--model`, `ANTHROPIC_MODEL` или поле `model` файла параметров, удалите или обновите это значение, чтобы уведомление не повторялось при каждом запуске

724* Если вам нужен доступ к ограниченной модели, попросите администратора вашей организации включить ее. См. [Organization model restrictions](/ru/model-config#organization-model-restrictions).

725 

709<h3 id="thinking-type-enabled-is-not-supported-for-this-model">726<h3 id="thinking-type-enabled-is-not-supported-for-this-model">

710 thinking.type.enabled is not supported for this model727 thinking.type.enabled is not supported for this model

711</h3>728</h3>

fast-mode.md +1 −1

Details

115* **Включение администратором для Team и Enterprise**: быстрый режим отключен по умолчанию для организаций Team и Enterprise. Администратор должен явно [включить быстрый режим](#enable-fast-mode-for-your-organization) перед тем, как пользователи смогут получить к нему доступ.115* **Включение администратором для Team и Enterprise**: быстрый режим отключен по умолчанию для организаций Team и Enterprise. Администратор должен явно [включить быстрый режим](#enable-fast-mode-for-your-organization) перед тем, как пользователи смогут получить к нему доступ.

116 116 

117<Note>117<Note>

118 Если ваш администратор не включил быстрый режим для вашей организации, команда `/fast` покажет "Fast mode has been disabled by your organization." Если список разрешенных моделей вашей организации [`availableModels`](/ru/model-config#restrict-model-selection) исключает модель быстрого режима Opus, `/fast` отклоняется с сообщением "is not in your organization's allowed models".118 Если ваш администратор не включил быстрый режим для вашей организации, команда `/fast` покажет "Fast mode has been disabled by your organization." Если список разрешенных моделей вашей организации [`availableModels`](/ru/model-config#restrict-model-selection) исключает модель быстрого режима Opus, `/fast` отклоняется с сообщением "is not in your organization's allowed models". Исключением является сеанс, уже работающий на разрешенной модели Opus, которая поддерживает быстрый режим: `/fast` затем применяется к этой модели.

119</Note>119</Note>

120 120 

121<h3 id="enable-fast-mode-for-your-organization">121<h3 id="enable-fast-mode-for-your-organization">

fullscreen.md +1 −0

Details

56 56 

57* **Клик в поле ввода подсказки** для позиционирования курсора в любом месте вводимого вами текста.57* **Клик в поле ввода подсказки** для позиционирования курсора в любом месте вводимого вами текста.

58* **Клик по предложению в команде `/` или списке файлов `@`** для его принятия. Наведение курсора выделяет строку под вашим курсором.58* **Клик по предложению в команде `/` или списке файлов `@`** для его принятия. Наведение курсора выделяет строку под вашим курсором.

59* **Клик по опции в меню выбора** для её выбора. Это охватывает запросы разрешений, `/model`, `/config` и другие диалоги, которые показывают список опций. Наведение курсора показывает указатель на строке под вашим курсором. {/* min-version: 2.1.187 */}Требуется Claude Code v2.1.187 или позже.

59* **Клик по свёрнутому результату инструмента** для его развёртывания и просмотра полного выходного сигнала. Клик снова для свёртывания. Вызов инструмента и его результат развёртываются вместе. Кликабельны только сообщения, которые имеют больше для отображения.60* **Клик по свёрнутому результату инструмента** для его развёртывания и просмотра полного выходного сигнала. Клик снова для свёртывания. Вызов инструмента и его результат развёртываются вместе. Кликабельны только сообщения, которые имеют больше для отображения.

60* **Удерживайте `Cmd` на macOS или `Ctrl` на Linux и Windows и клик по URL или пути к файлу** для его открытия. Пути к файлам в выходных данных инструмента, такие как те, которые выводятся после Edit или Write, открываются в вашем приложении по умолчанию. Простые `http://` и `https://` URL открываются в вашем браузере. {/* min-version: 2.1.181 */}Начиная с версии 2.1.181, простой клик без удержания `Cmd` или `Ctrl` больше не открывает ссылки, что соответствует поведению встроенного терминала. Во встроенном терминале VS Code и аналогичных терминалах на основе xterm.js Claude Code уступает собственному обработчику ссылок терминала, который использует тот же жест.61* **Удерживайте `Cmd` на macOS или `Ctrl` на Linux и Windows и клик по URL или пути к файлу** для его открытия. Пути к файлам в выходных данных инструмента, такие как те, которые выводятся после Edit или Write, открываются в вашем приложении по умолчанию. Простые `http://` и `https://` URL открываются в вашем браузере. {/* min-version: 2.1.181 */}Начиная с версии 2.1.181, простой клик без удержания `Cmd` или `Ctrl` больше не открывает ссылки, что соответствует поведению встроенного терминала. Во встроенном терминале VS Code и аналогичных терминалах на основе xterm.js Claude Code уступает собственному обработчику ссылок терминала, который использует тот же жест.

61* **Клик и перетаскивание** для выделения текста в любом месте диалога. Двойной клик выделяет слово, соответствуя границам слов iTerm2, поэтому путь к файлу выделяется как одна единица. Тройной клик выделяет строку.62* **Клик и перетаскивание** для выделения текста в любом месте диалога. Двойной клик выделяет слово, соответствуя границам слов iTerm2, поэтому путь к файлу выделяется как одна единица. Тройной клик выделяет строку.

Details

44 Быстрая настройка44 Быстрая настройка

45</h2>45</h2>

46 46 

47Самый простой способ настроить это действие через Claude Code в терминале. Просто откройте claude и запустите `/install-github-app`.47Запустите `/install-github-app` в терминале Claude Code для интерактивной настройки интеграции. Команда устанавливает Claude GitHub App в вашем репозитории и затем проводит вас через добавление GitHub Actions workflows и секрета API ключа.

48 48 

49Эта команда проведёт вас через процесс настройки GitHub app и необходимых секретов.49После установки GitHub App команда спрашивает, продолжить ли с настройкой GitHub Actions. В Claude Code v2.1.187 и более поздних версиях вы можете выбрать **Skip for now** (Пропустить на время), чтобы остановиться только с установленным App и вернуться к шагам workflow и секрета, запустив `/install-github-app` снова. Более ранние версии переходят прямо к выбору workflow.

50 50 

51<Note>51<Note>

52 * Вы должны быть администратором репозитория для установки GitHub app и добавления секретов52 * Вы должны быть администратором репозитория для установки GitHub app и добавления секретов

glossary.md +2 −2

Details

208 Managed settings208 Managed settings

209</h3>209</h3>

210 210 

211Файл settings, применяемый организацией IT или DevOps, размещённый в пути уровня ОС вне `~/.claude`. Пользователи не могут переопределять или исключать managed settings. Используйте это для политик безопасности, требований соответствия или стандартизированного инструментария на всём парке.211Параметры, применяемые организацией IT или DevOps, доставляемые с серверов Anthropic через консоль администратора или развёрнутые на устройствах по пути уровня ОС вне `~/.claude`. Пользователи не могут переопределять управляемые параметры из областей с более низким приоритетом. Доставка, управляемая сервером, применяется на [подходящих конфигурациях](/ru/server-managed-settings#platform-availability); см. [Соображения безопасности](/ru/server-managed-settings#security-considerations). Используйте это для политик безопасности, требований соответствия или стандартизированного инструментария на всём парке.

212 212 

213Подробнее: [Server-managed settings](/ru/server-managed-settings)213Подробнее: [Server-managed settings](/ru/server-managed-settings) · [Settings files](/ru/settings#settings-files)

214 214 

215<h3 id="mcp-model-context-protocol">215<h3 id="mcp-model-context-protocol">

216 MCP (Model Context Protocol)216 MCP (Model Context Protocol)

Details

268 * Нажмите `Ctrl+C` для отмены и восстановления вашего исходного ввода268 * Нажмите `Ctrl+C` для отмены и восстановления вашего исходного ввода

269 * Нажмите `Backspace` на пустом поиске для отмены269 * Нажмите `Backspace` на пустом поиске для отмены

270 270 

271Поиск отображает совпадающие команды с выделенным поисковым термином, поэтому вы можете найти и повторно использовать предыдущие вводы.271Поиск загружает 100 самых последних уникальных приглашений в выбранной области, с дубликатами, свёрнутыми до самого нового появления. Совпадающие приглашения отображаются с выделенным поисковым термином, поэтому вы можете найти и повторно использовать предыдущие вводы.

272 272 

273<h2 id="background-bash-commands">273<h2 id="background-bash-commands">

274 Фоновые bash команды274 Фоновые bash команды


374| :------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |374| :------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

375| `Space`, `Enter`, `Escape` | Отклонить ответ и вернуться к запросу |375| `Space`, `Enter`, `Escape` | Отклонить ответ и вернуться к запросу |

376| `Up` / `Down` | Прокрутить ответ |376| `Up` / `Down` | Прокрутить ответ |

377| `Left` / `Right` | {/* min-version: 2.1.187 */}Переключаться между этим ответом и вашими более ранними ответами `/btw` из сеанса. `Left` переходит к более старым ответам, а `Right` возвращается к текущему. Требуется Claude Code v2.1.187 или позже |

377| `c` | Скопировать ответ в буфер обмена как исходный Markdown. Используйте это вместо выделения мышью, которое захватывает жесткий перенос терминала, а не исходный текст |378| `c` | Скопировать ответ в буфер обмена как исходный Markdown. Используйте это вместо выделения мышью, которое захватывает жесткий перенос терминала, а не исходный текст |

378| `f` | Разветвить в новый сеанс. Разветвление наследует родительский разговор плюс этот вопрос и ответ как реальные ходы транскрипта, поэтому вы можете продолжить с полным доступом к инструментам. Исходный сеанс сохраняется под [`/resume`](/ru/commands). Доступно только в локальных сеансах |379| `f` | Разветвить в новый сеанс. Разветвление наследует родительский разговор плюс этот вопрос и ответ как реальные ходы транскрипта, поэтому вы можете продолжить с полным доступом к инструментам. Исходный сеанс сохраняется под [`/resume`](/ru/commands). Доступно только в локальных сеансах |

379| `x` | Очистить список более ранних обменов `/btw`, показанный выше текущего ответа |380| `x` | Очистить список более ранних обменов `/btw`, показанный выше текущего ответа |

mcp.md +2 −0

Details

218 218 

219Timeout для каждого server — это жесткий лимит реального времени для каждого вызова инструмента, и уведомления о прогрессе от server не продлевают его. Значения ниже 1000 игнорируются и переходят к `MCP_TOOL_TIMEOUT`, или к его значению по умолчанию примерно 28 часов, когда эта переменная не установлена. {/* min-version: 2.1.162 */}До версии 2.1.162 значения ниже 1000 округлялись до одной секунды. Для HTTP и SSE servers бюджет первого байта для каждого запроса fetch имеет минимум 60 секунд.219Timeout для каждого server — это жесткий лимит реального времени для каждого вызова инструмента, и уведомления о прогрессе от server не продлевают его. Значения ниже 1000 игнорируются и переходят к `MCP_TOOL_TIMEOUT`, или к его значению по умолчанию примерно 28 часов, когда эта переменная не установлена. {/* min-version: 2.1.162 */}До версии 2.1.162 значения ниже 1000 округлялись до одной секунды. Для HTTP и SSE servers бюджет первого байта для каждого запроса fetch имеет минимум 60 секунд.

220 220 

221Начиная с версии 2.1.187, вызов инструмента к удаленному HTTP, SSE, WebSocket или [claude.ai connector](#use-mcp-servers-from-claude-ai) server, который не отправляет ответ и не отправляет уведомление о прогрессе в течение 5 минут, прерывается с ошибкой вместо ожидания лимита реального времени. Установите переменную окружения [`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`](/ru/env-vars) в миллисекундах, чтобы изменить окно неактивности, или установите ее на `0`, чтобы отключить проверку. Stdio servers — это локальные процессы и не подлежат timeout неактивности.

222 

221<h3 id="plugin-provided-mcp-servers">223<h3 id="plugin-provided-mcp-servers">

222 MCP servers, предоставляемые плагинами224 MCP servers, предоставляемые плагинами

223</h3>225</h3>

model-config.md +69 −16

Details

90 90 

91Флаг `--model` и переменная окружения `ANTHROPIC_MODEL` применяются только к сеансу, с которым вы их запускаете. Чтобы запустить разные модели в разных терминалах одновременно, запустите каждый с собственным флагом `--model` вместо переключения с помощью `/model`.91Флаг `--model` и переменная окружения `ANTHROPIC_MODEL` применяются только к сеансу, с которым вы их запускаете. Чтобы запустить разные модели в разных терминалах одновременно, запустите каждый с собственным флагом `--model` вместо переключения с помощью `/model`.

92 92 

93Возобновленные сеансы, запущенные с `claude --resume`, `--continue` или средством выбора `/resume`, сохраняют модель, которую они использовали при сохранении стенограммы, независимо от текущего параметра `model`. Если эта модель была снята с производства, сеанс переходит к обычному порядку приоритета. Это предотвращает изменение модели при возобновлении выбором `/model` другого сеанса.93Возобновленные сеансы, запущенные с `claude --resume`, `--continue` или средством выбора `/resume`, сохраняют модель, которую они использовали при сохранении стенограммы, независимо от текущего параметра `model`. Если эта модель была снята с производства или исключена [`availableModels`](#restrict-model-selection), сеанс переходит к обычному порядку приоритета. Это предотвращает изменение модели при возобновлении выбором `/model` другого сеанса.

94 94 

95Когда активная модель при запуске поступает из параметров проекта или управляемых параметров, а не из вашего собственного выбора, заголовок при запуске показывает, какой файл параметров установил его. Запустите `/model` для переопределения; параметр проекта или управляемый параметр переприменяется при следующем запуске.95Когда активная модель при запуске поступает из параметров проекта или управляемых параметров, а не из вашего собственного выбора, заголовок при запуске показывает, какой файл параметров установил его. Запустите `/model` для переопределения; параметр проекта или управляемый параметр переприменяется при следующем запуске.

96 96 


121 Ограничение выбора модели121 Ограничение выбора модели

122</h2>122</h2>

123 123 

124Администраторы предприятия могут использовать `availableModels` в [управляемых или политических параметрах](/ru/settings#settings-files) для ограничения того, какие модели могут выбирать пользователи.124Администраторы предприятия могут использовать `availableModels` в [управляемых или политических параметрах](/ru/settings#settings-files) для ограничения того, какие модели могут выбирать пользователи. Записи соответствуют семейству моделей, такому как `sonnet`, префиксу версии, такому как `claude-sonnet-4-5`, или полному идентификатору модели, такому как `claude-sonnet-4-5-20250929`.

125 125 

126Когда установлен `availableModels`, список разрешений применяется к каждой поверхности, где пользователь может назвать модель:126Когда установлен `availableModels`, список разрешений применяется к каждой поверхности, где пользователь может назвать модель:

127 127 

128* **Модель основного сеанса**: `/model`, флаг `--model` и переменная окружения `ANTHROPIC_MODEL`128* **Модель основного сеанса**: `/model`, флаг `--model`, переменная окружения `ANTHROPIC_MODEL`, параметр `model` и модель, восстановленная при [возобновлении сеанса](#setting-your-model)

129* **Разрешение псевдонимов**: {/* min-version: 2.1.176 */}переменные окружения `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL` и `ANTHROPIC_DEFAULT_FABLE_MODEL` не могут перенаправить разрешённый псевдоним на модель вне списка129* **Разрешение псевдонимов**: {/* min-version: 2.1.176 */}переменные окружения `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL` и `ANTHROPIC_DEFAULT_FABLE_MODEL` не могут перенаправить разрешённый псевдоним на модель вне списка

130* **Быстрый режим**: {/* min-version: 2.1.176 */}`/fast` отказывает переключаться, когда это неявно переключилось бы на модель Opus вне списка, с сообщением "is not in your organization's allowed models"130* **Быстрый режим**: {/* min-version: 2.1.176 */}`/fast` отказывает переключаться, когда это неявно переключилось бы на модель Opus вне списка, с сообщением "is not in your organization's allowed models"

131* **Модели подагентов**: поле `model` в [подагенте](/ru/sub-agents#choose-a-model) frontmatter, параметр `model` инструмента Agent, средство выбора модели в `/agents` и `CLAUDE_CODE_SUBAGENT_MODEL`131* **Модели подагентов**: поле `model` в [подагенте](/ru/sub-agents#choose-a-model) frontmatter, параметр `model` инструмента Agent, средство выбора модели в `/agents` и `CLAUDE_CODE_SUBAGENT_MODEL`

132* **Модель советника**: настроенный параметр [`advisorModel`](/ru/advisor)132* **Модели навыков и команд**: frontmatter `model` в [навыках и командах](/ru/skills)

133* **Цепочки резервных моделей**: элементы [цепочки резервной модели](#fallback-model-chains) вне списка удаляются133* **Модель советника**: настроенный параметр [`advisorModel`](/ru/advisor) и флаг `--advisor`

134* **Модель фонового агента**: модель, выбранная в [средстве выбора диспетчера](/ru/agent-view)

134 135 

135Переключение на заблокированную модель с помощью `/model` отклоняется с ошибкой, в то время как заблокированный флаг `--model` или значение `ANTHROPIC_MODEL` заменяются при запуске с предупреждением, в котором указаны как запрошенная, так и подставленная модели, и сеанс начинается с моделью по умолчанию. Заблокированное переопределение подагента или советника возвращается к унаследованной или модели по умолчанию, а не к отказу в запросе.136Переключение на заблокированную модель с помощью `/model` отклоняется с ошибкой, в то время как заблокированный флаг `--model`, `ANTHROPIC_MODEL` или значение параметра `model` заменяются при запуске с предупреждением, в котором указаны как запрошенная, так и подставленная модели, и сеанс начинается с моделью по умолчанию. Заблокированное переопределение подагента, навыка или команды возвращается к унаследованной или модели по умолчанию, а не к отказу в запросе; заблокированный параметр `advisorModel` отключает советника на время сеанса, в то время как заблокированное значение флага `--advisor` завершает работу с ошибкой при запуске. Исключённые модели скрыты из средства выбора `/model`.

137 

138Автоматические изменения модели проверяются таким же образом: элементы [цепочки резервной модели](#fallback-model-chains) вне списка разрешений удаляются, обновление режима планирования, такое как [`opusplan`](#opusplan-model-setting) на исключённую модель, пропускается, чтобы планирование продолжалось на модели сеанса, и [автоматический резервный вариант модели](#automatic-model-fallback), целевая модель которого исключена, не выполняется, поэтому помеченный запрос заканчивается отказом. Включение [быстрого режима](/ru/fast-mode) отклоняется, когда модель, на которой сеанс будет работать впоследствии, находится вне списка разрешений.

136 139 

137```json theme={null}140```json theme={null}

138{141{


140}143}

141```144```

142 145 

146<h3 id="surface-coverage">

147 Охват поверхностей

148</h3>

149 

150Каждая поверхность применяет полученный список разрешений. Какой механизм доставки достигает каждой поверхности, отличается:

151 

152| Механизм доставки | CLI и IDE | Локальные сеансы Desktop | Веб-сеансы, мобильные и облачные сеансы | Agent SDK и неинтерактивные | Cowork |

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

154| [Управляемые параметры сервера](/ru/server-managed-settings) из консоли администратора | Применяется | Применяется | Применяется | Применяется | Не доставляется |

155| [MDM или управляемые файлы параметров](/ru/settings#settings-files) | Применяется | Применяется | Не доставляется | Применяется | Применяется где развёрнуто |

156 

157* Облачные сеансы на [Claude Code в веб-версии](/ru/claude-code-on-the-web) или в приложении Desktop работают на управляемых Anthropic виртуальных машинах: параметры, развёрнутые на вашем устройстве, не достигают их, поэтому доставляйте список разрешений через управляемые параметры сервера. Переключение модели в середине сеанса в облачном сеансе отклоняется, когда запрошенная модель исключена списком разрешений. Отклонение на стороне сервера при создании сеанса применяется к [ограничениям модели организации](#organization-model-restrictions), а не к ключу параметров `availableModels`.

158* Cowork, вкладка агентской работы в приложении Claude Desktop, не является поверхностью Claude Code и по замыслу не получает управляемые параметры сервера. Управляемый файл параметров применяется к сеансам Cowork, когда он присутствует там, где работает сеанс; удалённые сеансы Cowork работают на управляемых Anthropic виртуальных машинах, где развёрнутый на устройстве файл отсутствует.

159* Сеансы на [сторонних поставщиках](/ru/server-managed-settings#platform-availability), таких как Bedrock, Vertex AI, Foundry и [Claude Platform на AWS](/ru/claude-platform-on-aws), не получают управляемые параметры сервера, поэтому доставляйте список разрешений через MDM или управляемые файлы параметров там.

160* Доставка, управляемая сервером, также требует, чтобы сеанс аутентифицировался с помощью входа в организацию или напрямую настроенного ключа API. Флоты, которые генерируют ключи только через скрипт [`apiKeyHelper`](/ru/settings#available-settings), должны доставлять список разрешений через MDM или управляемые файлы параметров.

161* Вкладка Desktop Code также размещает [SSH-сеансы](/ru/desktop#ssh-sessions), которые читают управляемый файл параметров с удалённого хоста, на котором они работают. См. [Управляемые параметры Desktop](/ru/desktop#managed-settings).

162* Средства выбора модели на claude.ai и в приложении Desktop скрывают или затемняют модели, исключённые списком разрешений вашей организации. Состояние средства выбора — это удобство для пользователей; применение происходит в сеансе.

163 

143<h3 id="default-model-behavior">164<h3 id="default-model-behavior">

144 Поведение модели по умолчанию165 Поведение модели по умолчанию

145</h3>166</h3>

146 167 

147По умолчанию опция Default в средстве выбора модели не затрагивается `availableModels`. Она остается доступной и представляет системное значение по умолчанию во время выполнения [на основе уровня подписки пользователя](#default-model-setting).168Опция Default в средстве выбора модели не затрагивается `availableModels`, если также не установлен [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model). Сам по себе `availableModels` оставляет Default доступным, разрешаясь в системное значение по умолчанию во время выполнения [на основе уровня подписки пользователя](#default-model-setting). Если значение по умолчанию для уровня — это модель, которую вы намереваетесь ограничить, установите также `enforceAvailableModels`.

148 169 

149Чтобы расширить список разрешений на опцию Default, установите `enforceAvailableModels` в значение `true` в управляемых или политических параметрах вместе с непустым списком `availableModels`. Когда значение по умолчанию для уровня не находится в списке разрешений, Default разрешается на первую разрешённую запись вместо значения по умолчанию для уровня. Это требует Claude Code v2.1.175 или более поздней версии.170Пустой массив `availableModels` никогда не включает применение Default-модели: с `availableModels: []` именованные выборы модели блокируются, но модель Default для типа учётной записи остаётся пригодной для использования независимо от `enforceAvailableModels`.

150 171 

151Пустой массив `availableModels` никогда не включает принудительное применение. Даже с `availableModels: []` пользователи все ещё могут использовать Claude Code с моделью Default для своего уровня независимо от `enforceAvailableModels`.172<h3 id="enforce-the-allowlist-for-the-default-model">

173 Применение списка разрешений для модели Default

174</h3>

175 

176Установите `enforceAvailableModels: true` вместе с непустым `availableModels` в управляемых параметрах, чтобы расширить список разрешений на опцию Default. Это требует Claude Code v2.1.175 или более поздней версии.

177 

178```json theme={null}

179{

180 "availableModels": ["sonnet", "haiku"],

181 "enforceAvailableModels": true

182}

183```

184 

185Когда модель по умолчанию для типа учётной записи пользователя не находится в списке разрешений, опция Default вместо этого разрешается на первую запись `availableModels`, которая называет разрешённую, доступную модель, и строка Default в средстве выбора `/model` показывает эту модель. Это применяется везде, где достигается значение по умолчанию: запуск сеанса, выбор Default в `/model`, ключевое слово `"default"` в [цепочках резервной модели](#fallback-model-chains) и резервный вариант, используемый при удалении исключённого выбора.

186 

187`enforceAvailableModels` не имеет эффекта, когда `availableModels` не установлен или пуст: с `availableModels: []` модель Default для типа учётной записи остаётся пригодной для использования, поэтому параметр не может заблокировать пользователей от каждой модели. Когда `availableModels` непуст, но ни одна запись не разрешается на разрешённую и доступную модель, применение деградирует и Default переходит к значению по умолчанию для типа учётной записи с предупреждением, видимым только под `--debug`. Сохраняйте по крайней мере одну гарантированно доступную запись в списке, чтобы избежать этого.

188 

189Развёртывайте оба ключа в [источнике управляемых параметров с наивысшим приоритетом](/ru/settings#settings-precedence): развёрнутые администратором управляемые источники не объединяются, поэтому пара, размещённая в управляемом файле параметров, игнорируется, когда консоль администратора доставляет какие-либо параметры.

152 190 

153<h3 id="control-the-model-users-run-on">191<h3 id="control-the-model-users-run-on">

154 Управление моделью, на которой работают пользователи192 Управление моделью, на которой работают пользователи

155</h3>193</h3>

156 194 

157Параметр `model` является начальным выбором, а не принудительным. Он устанавливает, какая модель активна при запуске сеанса, но пользователи все ещё могут открыть `/model` и выбрать Default, который разрешается в системное значение по умолчанию для их уровня независимо от того, что установлено в `model`.195Параметр `model` является начальным выбором, а не применением. Он устанавливает, какая модель активна при запуске сеанса, но пользователи всё ещё могут открыть `/model` и выбрать Default, который разрешается в системное значение по умолчанию для их уровня независимо от того, что установлено в `model`, если только [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) не перенаправит его.

158 196 

159Для полного управления опытом работы с моделью объедините эти параметры:197Для полного управления опытом работы с моделью объедините эти параметры:

160 198 


182 Поведение слияния220 Поведение слияния

183</h3>221</h3>

184 222 

185Когда `availableModels` установлен в параметрах пользователя, проекта и локальных параметрах, массивы объединяются и дедублицируются на этих уровнях.223Когда источник управляемых параметров с [наивысшим приоритетом](/ru/server-managed-settings#settings-precedence) определяет `availableModels`, применяется только этот список: записи в параметрах пользователя, проекта или локальных параметрах не могут расширить его, и развёрнутые администратором управляемые источники не объединяются друг с другом, поэтому список, развёрнутый в управляемом файле параметров, игнорируется, когда управляемые параметры сервера доставляют какие-либо ключи. В противном случае списки из параметров пользователя, проекта и локальных параметров [объединяются и дедублицируются](/ru/settings#settings-precedence) как другие параметры массива. {/* min-version: 2.1.175 */}Начиная с Claude Code v2.1.175, управляемый список заменяет записи с более низким приоритетом; более ранние версии объединяют их.

186 224 

187Когда `availableModels` установлен в управляемых или политических параметрах, управляемое или политическое значение полностью заменяет объединённый результат: записи, добавленные в параметры пользователя или проекта, не могут расширить его. Управляемые и политические параметры заменяют значения с более низким приоритетом для `enforceAvailableModels` таким же образом. Начиная с Claude Code v2.1.175, это единственный способ обеспечить строгий список разрешений; более ранние версии объединяют управляемый список с записями с более низким приоритетом.225В пределах эффективного списка запись, называющая конкретную модель в семействе, будь то префикс версии или полный идентификатор модели, отключает запись подстановочного знака этого семейства: `["sonnet", "claude-sonnet-4-5"]` разрешает только версии Sonnet 4.5, а не каждую модель Sonnet.

188 226 

189<h3 id="mantle-model-ids">227<h3 id="mantle-model-ids">

190 Идентификаторы моделей Mantle228 Идентификаторы моделей Mantle

191</h3>229</h3>

192 230 

193Когда включена [конечная точка Bedrock Mantle](/ru/amazon-bedrock#use-the-mantle-endpoint), записи в `availableModels`, начинающиеся с `anthropic.`, добавляются в средство выбора `/model` как пользовательские опции и маршрутизируются на конечную точку Mantle. Параметр всё ещё ограничивает средство выбора перечисленными записями, поэтому включите стандартные псевдонимы вместе с любыми идентификаторами Mantle.231Когда включена [конечная точка Bedrock Mantle](/ru/amazon-bedrock#use-the-mantle-endpoint), записи в `availableModels`, начинающиеся с `anthropic.`, добавляются в средство выбора `/model` как пользовательские опции и маршрутизируются на конечную точку Mantle. Это исключение из сопоставления псевдонимов, описанного в [Закрепление моделей для развёртываний третьих сторон](#pin-models-for-third-party-deployments). Параметр всё ещё ограничивает средство выбора перечисленными записями, и идентификатор Mantle встраивает имя семейства, поэтому он считается конкретной записью и отключает запись подстановочного знака этого семейства: вместе с любыми идентификаторами Mantle перечислите префиксы версий или полные идентификаторы, которые вы хотите сохранить доступными для выбора. См. [Поведение слияния](#merge-behavior).

232 

233<h3 id="organization-model-restrictions">

234 Ограничения модели организации

235</h3>

236 

237Используйте переключатель Console вместо `availableModels`, когда ваши члены аутентифицируются через API Anthropic и вы хотите один переключатель на уровне организации без развёртывания файлов параметров. Администраторы организации ограничивают, какие модели могут запускать члены, отключая отдельные модели в Claude Console. Это ограничение доставляется с правами учётной записи, когда Claude Code аутентифицируется, отдельно от любого списка `availableModels` в параметрах, и сервер независимо применяет то же ограничение при создании сеанса. Требует Claude Code v2.1.187 или более поздней версии.

238 

239Ограниченная модель скрыта из средства выбора `/model`. Выбор её по имени с помощью `--model`, переменной окружения `ANTHROPIC_MODEL` или параметра `model` показывает уведомление `Model "<name>" is restricted by your organization's settings. Using <model> instead.` и сеанс начинается на разрешённой модели. Ввод `/model <name>` для ограниченной модели отклоняется с `Model '<name>' is restricted by your organization's settings. Run /model to choose a different model.` и сеанс сохраняет свою текущую модель.

240 

241Два механизма составляют: модель доступна для выбора только когда она разрешена `availableModels` и не ограничена организацией. Ограничения организации доставляются сеансам на API Anthropic и развёртываниях [LLM gateway](/ru/llm-gateway). Сеансы на Bedrock, Vertex AI, Foundry и Claude Platform на AWS не получают их, поэтому используйте `availableModels` на этих поставщиках вместо этого.

194 242 

195<h2 id="special-model-behavior">243<h2 id="special-model-behavior">

196 Специальное поведение модели244 Специальное поведение модели


209 257 

210Enterprise с оплатой по мере использования означает организацию Enterprise, выставляемую счет по использованию, а не по месту подписки.258Enterprise с оплатой по мере использования означает организацию Enterprise, выставляемую счет по использованию, а не по месту подписки.

211 259 

260Когда управляемые параметры [применяют список разрешений для модели Default](#enforce-the-allowlist-for-the-default-model) и значение по умолчанию для типа учетной записи отсутствует в `availableModels`, `default` разрешается в применяемый Default вместо значения по умолчанию для типа учетной записи выше.

261 

212Fable 5 не является моделью по умолчанию ни для одного типа учетной записи. Сеансы используют Fable 5 только после того, как вы выберете его с помощью `/model fable`, параметра `model` или псевдонима `best`, где доступна Fable 5. Выбор его с помощью `/model` сохраняет его как выбранную модель в параметрах пользователя, поэтому более поздние сеансы начинаются с Fable 5, пока вы не измените модели.262Fable 5 не является моделью по умолчанию ни для одного типа учетной записи. Сеансы используют Fable 5 только после того, как вы выберете его с помощью `/model fable`, параметра `model` или псевдонима `best`, где доступна Fable 5. Выбор его с помощью `/model` сохраняет его как выбранную модель в параметрах пользователя, поэтому более поздние сеансы начинаются с Fable 5, пока вы не измените модели.

213 263 

214<h3 id="opusplan-model-setting">264<h3 id="opusplan-model-setting">


267 317 

268Сеанс затем продолжается на этой модели Opus. Чтобы вернуться к Fable 5, запустите `/model fable`.318Сеанс затем продолжается на этой модели Opus. Чтобы вернуться к Fable 5, запустите `/model fable`.

269 319 

320Цель резервного варианта проверяется против [`availableModels`](#restrict-model-selection). Когда она заблокирована, резервный вариант не происходит. Отказ появляется как обычная ошибка, и модель сеанса остается неизменной.

321 

270<h4 id="check-what-triggered-fallback">322<h4 id="check-what-triggered-fallback">

271 Проверка того, что вызвало резервный вариант323 Проверка того, что вызвало резервный вариант

272</h4>324</h4>


286* Если обе модели помечают один и тот же запрос, вы можете отредактировать подсказку и повторить попытку, или начать новый сеанс.338* Если обе модели помечают один и тот же запрос, вы можете отредактировать подсказку и повторить попытку, или начать новый сеанс.

287* На мобильных сеансах [Claude Code в веб-браузере](/ru/claude-code-on-the-web) редактирование и повторная попытка не поддерживаются. Переключите модели или продолжите сеанс из браузера рабочего стола или приложения рабочего стола.339* На мобильных сеансах [Claude Code в веб-браузере](/ru/claude-code-on-the-web) редактирование и повторная попытка не поддерживаются. Переключите модели или продолжите сеанс из браузера рабочего стола или приложения рабочего стола.

288* В [неинтерактивном режиме](/ru/cli-reference#cli-flags) и интеграциях SDK, которые не могут показать подсказку, помеченный запрос завершает ход с отказом вместо этого.340* В [неинтерактивном режиме](/ru/cli-reference#cli-flags) и интеграциях SDK, которые не могут показать подсказку, помеченный запрос завершает ход с отказом вместо этого.

341* Когда цель резервного варианта заблокирована [`availableModels`](#restrict-model-selection), подсказка не показывается. Помеченный запрос завершается с отказом, так же как автоматический резервный вариант, когда цель заблокирована.

289 342 

290<h4 id="enable-fallback-on-bedrock-vertex-ai-and-foundry">343<h4 id="enable-fallback-on-bedrock-vertex-ai-and-foundry">

291 Включение резервного варианта на Bedrock, Vertex AI и Foundry344 Включение резервного варианта на Bedrock, Vertex AI и Foundry


452 505 

453Пользовательская запись появляется в нижней части средства выбора `/model`. `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` и `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` являются необязательными. Если они опущены, идентификатор модели используется как имя, а описание по умолчанию — `Custom model (<model-id>)`.506Пользовательская запись появляется в нижней части средства выбора `/model`. `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` и `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` являются необязательными. Если они опущены, идентификатор модели используется как имя, а описание по умолчанию — `Custom model (<model-id>)`.

454 507 

455Claude Code пропускает валидацию для идентификатора модели, установленного в `ANTHROPIC_CUSTOM_MODEL_OPTION`, поэтому вы можете использовать любую строку, которую принимает ваша конечная точка API.508Claude Code пропускает валидацию для идентификатора модели, установленного в `ANTHROPIC_CUSTOM_MODEL_OPTION`, поэтому вы можете использовать любую строку, которую принимает ваша конечная точка API. Когда установлено значение [`availableModels`](#restrict-model-selection), включите пользовательский идентификатор модели в список разрешений: пользовательская запись фильтруется из средства выбора, а выбор `--model` отклоняется как любая другая исключенная модель. Пользовательский идентификатор, который встраивает имя семейства, такой как `my-gateway/claude-opus-4-7`, считается конкретной записью для этого семейства и отключает его подстановочный знак, поэтому также перечислите версии, которые вы намереваетесь оставить выбираемыми. См. [Поведение слияния](#merge-behavior).

456 509 

457<h2 id="environment-variables">510<h2 id="environment-variables">

458 Переменные окружения511 Переменные окружения


505* Суффикс читается для каждой переменной, а не для каждой модели. На Bedrock, Vertex и Foundry идентификатор модели без `[1m]` в одной переменной использует контекст 200K, даже если другая переменная устанавливает ту же модель с суффиксом.558* Суффикс читается для каждой переменной, а не для каждой модели. На Bedrock, Vertex и Foundry идентификатор модели без `[1m]` в одной переменной использует контекст 200K, даже если другая переменная устанавливает ту же модель с суффиксом.

506 559 

507<Note>560<Note>

508 Список разрешений `settings.availableModels` все еще применяется при использовании поставщиков третьих сторон. Фильтрация соответствует псевдониму модели, такому как `opus`, префиксу версии, такому как `claude-opus-4-8`, или полному идентификатору модели. Любой суффикс `[1m]` удаляется как из записи списка разрешений, так и из запрашиваемой модели перед сопоставлением, поэтому запись `claude-opus-4-8` разрешает как стандартные, так и строки Opus с контекстом 1M. Префиксы, специфичные для поставщика, такие как `us.anthropic.`, не удаляются: укажите ту же форму в `availableModels`, которую показывает средство выбора, или отобразите ее через [`modelOverrides`](#override-model-ids-per-version).561 Список разрешений `availableModels`, доставленный через [MDM или управляемый файл параметров](/ru/settings#settings-files), все еще применяется при использовании поставщиков третьих сторон; [параметры, управляемые сервером, не доставляются туда](/ru/server-managed-settings#platform-availability). Фильтрация соответствует псевдониму модели, такому как `opus`, префиксу версии, такому как `claude-opus-4-8`, или полному идентификатору модели в форме поставщика. Префиксы, специфичные для поставщика, такие как `us.anthropic.`, не удаляются, поэтому для разрешения конкретной модели укажите ту же форму идентификатора поставщика, которую показывает средство выбора, или отобразите ее через [`modelOverrides`](#override-model-ids-per-version). Любой суффикс `[1m]` удаляется как из записи списка разрешений, так и из запрашиваемой модели перед сопоставлением.

509</Note>562</Note>

510 563 

511<h3 id="customize-pinned-model-display-and-capabilities">564<h3 id="customize-pinned-model-display-and-capabilities">


572 625 

573Переопределения заменяют встроенные идентификаторы моделей, которые поддерживают каждую запись в средстве выбора `/model`. На Bedrock переопределения имеют приоритет над любыми профилями вывода, которые Claude Code автоматически обнаруживает при запуске. Значения, которые вы предоставляете непосредственно через `ANTHROPIC_MODEL`, `--model` или переменные окружения `ANTHROPIC_DEFAULT_*_MODEL`, передаются поставщику как есть и не преобразуются `modelOverrides`.626Переопределения заменяют встроенные идентификаторы моделей, которые поддерживают каждую запись в средстве выбора `/model`. На Bedrock переопределения имеют приоритет над любыми профилями вывода, которые Claude Code автоматически обнаруживает при запуске. Значения, которые вы предоставляете непосредственно через `ANTHROPIC_MODEL`, `--model` или переменные окружения `ANTHROPIC_DEFAULT_*_MODEL`, передаются поставщику как есть и не преобразуются `modelOverrides`.

574 627 

575`modelOverrides` работает вместе с `availableModels`. Список разрешений оценивается по идентификатору модели Anthropic, а не по значению переопределения, поэтому запись, такая как `"opus"` в `availableModels`, продолжает совпадать, даже когда версии Opus отображаются на ARN.628`modelOverrides` работает вместе с `availableModels`. Список разрешений оценивается по идентификатору модели Anthropic, а не по значению переопределения, поэтому запись, такая как `"opus"` в `availableModels`, продолжает совпадать, даже когда версии Opus отображаются на ARN. Когда `enforceAvailableModels` установлен в управляемых параметрах, принудительное значение Default разрешается через `modelOverrides` из [источника управляемых параметров с наивысшим приоритетом](/ru/server-managed-settings#settings-precedence) только. Отображение администратора, такое как версия, закрепленная на ARN профиля вывода, соблюдается в принудительном Default. Переопределения из параметров пользователя или проекта не влияют на него.

576 629 

577<h3 id="prompt-caching-configuration">630<h3 id="prompt-caching-configuration">

578 Конфигурация кэширования подсказок631 Конфигурация кэширования подсказок

Details

1164 1164 

1165Claude Code повторяет неудачные запросы API внутри и выдает одно событие `claude_code.api_error` только после того, как сдается, поэтому само событие является терминальным сигналом для этого запроса. Промежуточные повторные попытки не логируются как отдельные события.1165Claude Code повторяет неудачные запросы API внутри и выдает одно событие `claude_code.api_error` только после того, как сдается, поэтому само событие является терминальным сигналом для этого запроса. Промежуточные повторные попытки не логируются как отдельные события.

1166 1166 

1167Атрибут `attempt` на событии записывает, сколько попыток было сделано в общей сложности. Значение больше `CLAUDE_CODE_MAX_RETRIES` (по умолчанию `10`, ограничено `15`) указывает, что запрос исчерпал все повторные попытки при переходной ошибке. Более низкое значение указывает на неповторяемую ошибку, такую как ответ `400`.1167Атрибут `attempt` на событии записывает, сколько попыток было сделано в общей сложности. `CLAUDE_CODE_MAX_RETRIES` по умолчанию равен `10` и ограничен `15`. Когда запрос исчерпывает все повторные попытки при переходной ошибке, `attempt` равен на один больше, чем это эффективное ограничение: 11 по умолчанию и никогда не более 16. Более низкое значение указывает на неповторяемую ошибку, такую как ответ `400`.

1168 1168 

1169Чтобы различить сеанс, который восстановился, от того, который застопорился, сгруппируйте события по `session.id` и проверьте, существует ли более позднее событие `api_request` после ошибки.1169Чтобы различить сеанс, который восстановился, от того, который застопорился, сгруппируйте события по `session.id` и проверьте, существует ли более позднее событие `api_request` после ошибки.

1170 1170 

Details

169```169```

170 170 

171<h2 id="eliminate-prompts-with-auto-mode">171<h2 id="eliminate-prompts-with-auto-mode">

172 Исключите запросы с режимом auto172 Исключите запросы разрешений с режимом auto

173</h2>173</h2>

174 174 

175<Note>175<Note>


181Режим auto также побуждает Claude продолжать работу без остановки для уточняющих вопросов, хотя Claude всё ещё спрашивает, когда ваш запрос или навык явно на этом полагается. Для более сильного автономного поведения при сохранении запросов разрешений установите вместо этого [Proactive output style](/ru/output-styles).181Режим auto также побуждает Claude продолжать работу без остановки для уточняющих вопросов, хотя Claude всё ещё спрашивает, когда ваш запрос или навык явно на этом полагается. Для более сильного автономного поведения при сохранении запросов разрешений установите вместо этого [Proactive output style](/ru/output-styles).

182 182 

183<Warning>183<Warning>

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

185</Warning>185</Warning>

186 186 

187Режим auto доступен только когда ваша учётная запись соответствует всем этим требованиям:187Режим auto доступен только когда ваша учётная запись соответствует всем этим требованиям:


342[Claude Code в веб-версии](/ru/claude-code-on-the-web) не учитывает `defaultMode: "bypassPermissions"` или `"dontAsk"` из ваших файлов параметров, поэтому проверенные в репозитории параметры не могут запустить облачный сеанс в режиме bypass-permissions. Параметр игнорируется молча, и сеанс запускается в режиме, показанном в раскрывающемся списке режимов вместо этого. См. [Переключение режимов разрешений](#switch-permission-modes) для информации о том, какие режимы предлагают облачные сеансы.342[Claude Code в веб-версии](/ru/claude-code-on-the-web) не учитывает `defaultMode: "bypassPermissions"` или `"dontAsk"` из ваших файлов параметров, поэтому проверенные в репозитории параметры не могут запустить облачный сеанс в режиме bypass-permissions. Параметр игнорируется молча, и сеанс запускается в режиме, показанном в раскрывающемся списке режимов вместо этого. См. [Переключение режимов разрешений](#switch-permission-modes) для информации о том, какие режимы предлагают облачные сеансы.

343 343 

344<Warning>344<Warning>

345 `bypassPermissions` не обеспечивает защиту от инъекции подсказок или непредвиденных действий. Для фоновых проверок безопасности с гораздо меньшим количеством запросов используйте [режим auto](#eliminate-prompts-with-auto-mode) вместо этого. Администраторы могут заблокировать этот режим, установив `permissions.disableBypassPermissionsMode` на `"disable"` в [управляемых параметрах](/ru/permissions#managed-settings).345 `bypassPermissions` не обеспечивает защиту от инъекции подсказок или непредвиденных действий. Для фоновых проверок безопасности с гораздо меньшим количеством запросов разрешений используйте [режим auto](#eliminate-prompts-with-auto-mode) вместо этого. Администраторы могут заблокировать этот режим, установив `permissions.disableBypassPermissionsMode` на `"disable"` в [управляемых параметрах](/ru/permissions#managed-settings).

346</Warning>346</Warning>

347 347 

348<h2 id="protected-paths">348<h2 id="protected-paths">

sandboxing.md +33 −3

Details

202 202 

203`.` в `allowRead` разрешается в корень проекта, потому что эта конфигурация находится в параметрах проекта. Если вы поместили ту же конфигурацию в `~/.claude/settings.json`, `.` разрешился бы в `~/.claude` вместо этого, и файлы проекта остались бы заблокированы правилом `denyRead`.203`.` в `allowRead` разрешается в корень проекта, потому что эта конфигурация находится в параметрах проекта. Если вы поместили ту же конфигурацию в `~/.claude/settings.json`, `.` разрешился бы в `~/.claude` вместо этого, и файлы проекта остались бы заблокированы правилом `denyRead`.

204 204 

205<h3 id="protect-credentials">

206 Защита учётных данных

207</h3>

208 

209Параметр `sandbox.credentials` объявляет файлы учётных данных и переменные окружения, к которым изолированные команды не должны получать доступ. Перечисленные пути файлов запрещены для чтения внутри sandbox, применяется тот же блок, что и `filesystem.denyRead`, и перечисленные переменные окружения удаляются перед каждой изолированной командой. Выделенный блок `credentials` сохраняет правила учётных данных сгруппированными с удалением переменных окружения и отдельно от общих правил файловой системы. Требуется Claude Code v2.1.187 или позже.

210 

211Пример ниже блокирует чтение файла учётных данных AWS и каталога SSH и удаляет `GITHUB_TOKEN` и `NPM_TOKEN` из окружения изолированных команд:

212 

213```json theme={null}

214{

215 "sandbox": {

216 "enabled": true,

217 "credentials": {

218 "files": [

219 { "path": "~/.aws/credentials", "mode": "deny" },

220 { "path": "~/.ssh", "mode": "deny" }

221 ],

222 "envVars": [

223 { "name": "GITHUB_TOKEN", "mode": "deny" },

224 { "name": "NPM_TOKEN", "mode": "deny" }

225 ]

226 }

227 }

228}

229```

230 

231Каждая запись содержит `"mode": "deny"`, что является единственным поддерживаемым значением. Явное поле `mode` сохраняет схему совместимой с будущими режимами. Пути файлов следуют тем же [правилам префиксов](/ru/settings#sandbox-path-prefixes), что и параметры `sandbox.filesystem.*`, и записи из каждой [области параметров](/ru/settings#settings-precedence) объединяются. Поскольку единственный режим — это `deny`, любая область может добавлять ограничения, но ни одна не может их удалять.

232 

233Встроенного списка запрещённых учётных данных нет, поэтому ограничены только файлы и переменные, которые вы указали. Параметр влияет только на изолированные команды Bash. Чтобы удалить учётные данные Anthropic и поставщиков облачных услуг из всех подпроцессов независимо от sandboxing, установите [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/ru/env-vars).

234 

205<h2 id="how-sandboxing-works">235<h2 id="how-sandboxing-works">

206 Как работает sandboxing236 Как работает sandboxing

207</h2>237</h2>


213Изолированный инструмент Bash ограничивает доступ к файловой системе определёнными каталогами:243Изолированный инструмент Bash ограничивает доступ к файловой системе определёнными каталогами:

214 244 

215* **Поведение записи по умолчанию**: доступ на чтение и запись к текущему рабочему каталогу и его подкаталогам, а также к временному каталогу сеанса, на который указывает `$TMPDIR`245* **Поведение записи по умолчанию**: доступ на чтение и запись к текущему рабочему каталогу и его подкаталогам, а также к временному каталогу сеанса, на который указывает `$TMPDIR`

216* **Поведение чтения по умолчанию**: доступ на чтение ко всему компьютеру, кроме определённых запрещённых каталогов. Обратите внимание, что эта политика по умолчанию всё ещё разрешает чтение файлов учётных данных, таких как `~/.aws/credentials` и `~/.ssh/`. Добавьте их в `denyRead`, чтобы заблокировать их.246* **Поведение чтения по умолчанию**: доступ на чтение ко всему компьютеру, кроме определённых запрещённых каталогов. Обратите внимание, что эта политика по умолчанию всё ещё разрешает чтение файлов учётных данных, таких как `~/.aws/credentials` и `~/.ssh/`. Используйте [`sandbox.credentials`](#protect-credentials) для блокировки чтения этих файлов и отмены установки переменных окружения с секретами, или добавьте пути в `denyRead`.

217* **Заблокированный доступ**: невозможно изменять файлы вне текущего рабочего каталога и временного каталога сеанса без явного разрешения, включая файлы конфигурации оболочки, такие как `~/.bashrc`, и системные двоичные файлы в `/bin/`247* **Заблокированный доступ**: невозможно изменять файлы вне текущего рабочего каталога и временного каталога сеанса без явного разрешения, включая файлы конфигурации оболочки, такие как `~/.bashrc`, и системные двоичные файлы в `/bin/`

218* **Git worktrees**: когда рабочий каталог является [связанным git worktree](/ru/worktrees), sandbox также разрешает запись в общий каталог `.git` основного репозитория, чтобы команды, такие как `git commit`, могли обновлять ссылки и индекс. Запись в `hooks/` и `config` внутри этого каталога остаётся запрещённой.248* **Git worktrees**: когда рабочий каталог является [связанным git worktree](/ru/worktrees), sandbox также разрешает запись в общий каталог `.git` основного репозитория, чтобы команды, такие как `git commit`, могли обновлять ссылки и индекс. Запись в `hooks/` и `config` внутри этого каталога остаётся запрещённой.

219* **Настраиваемо**: определите пользовательские разрешённые и запрещённые пути через параметры249* **Настраиваемо**: определите пользовательские разрешённые и запрещённые пути через параметры


326* **`failIfUnavailable`**: отсутствующая зависимость, такая как bubblewrap на Linux, блокирует запуск Claude Code вместо показа предупреждения и возврата к выполнению без изоляции356* **`failIfUnavailable`**: отсутствующая зависимость, такая как bubblewrap на Linux, блокирует запуск Claude Code вместо показа предупреждения и возврата к выполнению без изоляции

327* **`allowUnsandboxedCommands: false`**: механизм выхода `dangerouslyDisableSandbox` игнорируется, поэтому команды, которые не выполняются в sandbox, не могут быть повторены вне него357* **`allowUnsandboxedCommands: false`**: механизм выхода `dangerouslyDisableSandbox` игнорируется, поэтому команды, которые не выполняются в sandbox, не могут быть повторены вне него

328 358 

329Два дополнения стоит рассмотреть вместе с ними. Добавьте `excludedCommands` для любых одобренных организацией инструментов, которые должны выполняться без изоляции. Добавьте записи [`denyRead`](#filesystem-isolation) для каталогов учётных данных, таких как `~/.aws` и `~/.ssh`, которые политика чтения по умолчанию всё ещё разрешает.359Два дополнения стоит рассмотреть вместе с ними. Добавьте `excludedCommands` для любых одобренных организацией инструментов, которые должны выполняться без изоляции. Добавьте записи [`sandbox.credentials`](#protect-credentials) для каталогов учётных данных, таких как `~/.aws` и `~/.ssh`, и для переменных окружения с секретами, поскольку политика чтения по умолчанию всё ещё разрешает их.

330 360 

331Sandbox не работает на нативной Windows, поэтому если ваш парк включает хосты Windows, ограничьте эту конфигурацию macOS и Linux или попросите этих пользователей запустить Claude Code внутри WSL2 или контейнера.361Sandbox не работает на нативной Windows, поэтому если ваш парк включает хосты Windows, ограничьте эту конфигурацию macOS и Linux или попросите этих пользователей запустить Claude Code внутри WSL2 или контейнера.

332 362 


417 447 

418* **Встроенные инструменты файлов**: Read, Edit и Write используют систему разрешений напрямую, а не работают через sandbox. См. [permissions](/ru/permissions).448* **Встроенные инструменты файлов**: Read, Edit и Write используют систему разрешений напрямую, а не работают через sandbox. См. [permissions](/ru/permissions).

419* **Использование компьютера**: когда Claude открывает приложения и управляет вашим экраном, он работает на вашем фактическом рабочем столе, а не в изолированной среде. Запросы разрешений для каждого приложения контролируют каждое приложение. См. [computer use in the CLI](/ru/computer-use) или [computer use in Desktop](/ru/desktop#let-claude-use-your-computer).449* **Использование компьютера**: когда Claude открывает приложения и управляет вашим экраном, он работает на вашем фактическом рабочем столе, а не в изолированной среде. Запросы разрешений для каждого приложения контролируют каждое приложение. См. [computer use in the CLI](/ru/computer-use) или [computer use in Desktop](/ru/desktop#let-claude-use-your-computer).

420* **Переменные окружения**: изолированные команды Bash наследуют окружение родительского процесса по умолчанию, включая любые учётные данные, установленные там. Чтобы удалить учётные данные Anthropic и поставщика облака из подпроцессов, установите [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/ru/env-vars).450* **Переменные окружения**: изолированные команды Bash наследуют окружение родительского процесса по умолчанию, включая любые учётные данные, установленные там. Используйте [`sandbox.credentials`](#protect-credentials) для удаления определённых переменных для изолированных команд или установите [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/ru/env-vars) для удаления учётных данных Anthropic и поставщика облака из всех подпроцессов.

421* **Subagents**: [subagents](/ru/sub-agents) работают в том же процессе, что и родительский сеанс, и используют ту же конфигурацию sandbox. Команды Bash внутри subagent изолированы, когда sandboxing включен в родительском сеансе.451* **Subagents**: [subagents](/ru/sub-agents) работают в том же процессе, что и родительский сеанс, и используют ту же конфигурацию sandbox. Команды Bash внутри subagent изолированы, когда sandboxing включен в родительском сеансе.

422 452 

423<Warning>453<Warning>

Details

6 6 

7> Централизованно настраивайте Claude Code для вашей организации через параметры, доставляемые сервером, без необходимости инфраструктуры управления устройствами.7> Централизованно настраивайте Claude Code для вашей организации через параметры, доставляемые сервером, без необходимости инфраструктуры управления устройствами.

8 8 

9Параметры, управляемые сервером, позволяют администраторам централизованно настраивать Claude Code через веб-интерфейс на Claude.ai. Клиенты Claude Code автоматически получают эти параметры при аутентификации пользователей с использованием учетных данных организации.9Параметры, управляемые сервером, позволяют администраторам централизованно настраивать Claude Code через веб-интерфейс на Claude.ai. Клиенты Claude Code автоматически получают эти параметры при аутентификации пользователей с использованием организационного входа OAuth или напрямую настроенного ключа API на платформах, где поддерживается доставка параметров, управляемых сервером. См. [Доступность платформы](#platform-availability).

10 10 

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

12 12 


35| **Параметры, управляемые сервером** | Организации без MDM или пользователи на неуправляемых устройствах | Параметры доставляются с серверов Anthropic во время аутентификации |35| **Параметры, управляемые сервером** | Организации без MDM или пользователи на неуправляемых устройствах | Параметры доставляются с серверов Anthropic во время аутентификации |

36| **[Параметры, управляемые конечной точкой](/ru/settings#settings-files)** | Организации с MDM или управлением конечными точками | Параметры развертываются на устройства через профили конфигурации MDM, политики реестра или управляемые файлы параметров |36| **[Параметры, управляемые конечной точкой](/ru/settings#settings-files)** | Организации с MDM или управлением конечными точками | Параметры развертываются на устройства через профили конфигурации MDM, политики реестра или управляемые файлы параметров |

37 37 

38Если ваши устройства зарегистрированы в решении MDM или управления конечными точками, параметры, управляемые конечной точкой, обеспечивают более сильные гарантии безопасности, поскольку файл параметров может быть защищен от изменения пользователем на уровне ОС.38Если ваши устройства зарегистрированы в решении MDM или управления конечными точками, параметры, управляемые конечной точкой, обеспечивают более сильные гарантии безопасности, поскольку файл параметров может быть защищен от изменения пользователем на уровне ОС. Параметры, управляемые конечной точкой, не достигают [облачных сеансов](/ru/model-config#surface-coverage), поэтому организации, использующие Claude Code в веб-версии, должны также настроить параметры, управляемые сервером.

39 39 

40<h2 id="configure-server-managed-settings">40<h2 id="configure-server-managed-settings">

41 Настройка параметров, управляемых сервером41 Настройка параметров, управляемых сервером


228 Доступность платформы228 Доступность платформы

229</h2>229</h2>

230 230 

231Параметры, управляемые сервером, требуют прямого подключения к `api.anthropic.com` и недоступны при использовании поставщиков моделей третьих сторон:231Параметры, управляемые сервером, требуют прямого подключения к `api.anthropic.com`, и доставка требует, чтобы сеанс аутентифицировался с помощью входа в организацию OAuth или напрямую настроенного ключа API: ключи, возвращаемые скриптом [`apiKeyHelper`](/ru/settings#available-settings), не запускают выборку параметров. Параметры, управляемые сервером, недоступны при использовании поставщиков моделей третьих сторон:

232 232 

233* Amazon Bedrock233* Amazon Bedrock

234* Google Vertex AI234* Google Vertex AI

235* Microsoft Foundry235* Microsoft Foundry

236* [Claude Platform on AWS](/ru/claude-platform-on-aws)

236* Пользовательские конечные точки API через `ANTHROPIC_BASE_URL` или [LLM gateways](/ru/llm-gateway)237* Пользовательские конечные точки API через `ANTHROPIC_BASE_URL` или [LLM gateways](/ru/llm-gateway)

237 238 

238<h2 id="audit-logging">239<h2 id="audit-logging">


255| Пользователь удаляет кэшированный файл параметров | Происходит поведение первого запуска: параметры выбираются асинхронно с кратким неприменяемым окном |256| Пользователь удаляет кэшированный файл параметров | Происходит поведение первого запуска: параметры выбираются асинхронно с кратким неприменяемым окном |

256| API недоступен | Кэшированные параметры применяются, если доступны, в противном случае управляемые параметры не применяются до следующей успешной выборки. С `forceRemoteSettingsRefresh: true` CLI выходит вместо продолжения, за исключением [`claude auth` подкоманд](#enforce-fail-closed-startup) |257| API недоступен | Кэшированные параметры применяются, если доступны, в противном случае управляемые параметры не применяются до следующей успешной выборки. С `forceRemoteSettingsRefresh: true` CLI выходит вместо продолжения, за исключением [`claude auth` подкоманд](#enforce-fail-closed-startup) |

257| Пользователь аутентифицируется с другой организацией | Параметры не доставляются для учетных записей вне управляемой организации |258| Пользователь аутентифицируется с другой организацией | Параметры не доставляются для учетных записей вне управляемой организации |

258| Пользователь настраивает [поставщика моделей третьей стороны](#platform-availability) | Параметры, управляемые сервером, обходятся. Это включает установку `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_MANTLE`, `CLAUDE_CODE_USE_VERTEX`, `CLAUDE_CODE_USE_FOUNDRY` или нестандартного `ANTHROPIC_BASE_URL` |259| Пользователь настраивает [поставщика моделей третьей стороны](#platform-availability) | Параметры, управляемые сервером, обходятся. Это включает установку `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_MANTLE`, `CLAUDE_CODE_USE_VERTEX`, `CLAUDE_CODE_USE_FOUNDRY`, `CLAUDE_CODE_USE_ANTHROPIC_AWS` или нестандартного `ANTHROPIC_BASE_URL` |

259 260 

260Для обнаружения изменений конфигурации во время выполнения используйте [`ConfigChange` hooks](/ru/hooks#configchange) для логирования изменений или блокировки несанкционированных изменений перед их вступлением в силу.261Для обнаружения изменений конфигурации во время выполнения используйте [`ConfigChange` hooks](/ru/hooks#configchange) для логирования изменений или блокировки несанкционированных изменений перед их вступлением в силу.

261 262 

skills.md +2 −2

Details

245Все поля необязательны. Только `description` рекомендуется, чтобы Claude знал, когда использовать skill.245Все поля необязательны. Только `description` рекомендуется, чтобы Claude знал, когда использовать skill.

246 246 

247| Поле | Обязательно | Описание |247| Поле | Обязательно | Описание |

248| :------------------------- | :------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |248| :------------------------- | :------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

249| `name` | Нет | Отображаемое имя, показываемое в списках skills. По умолчанию используется имя каталога. См. [Как skill получает имя команды](#how-a-skill-gets-its-command-name), чтобы узнать, чем это отличается от имени, которое вы вводите для вызова skill. |249| `name` | Нет | Отображаемое имя, показываемое в списках skills. По умолчанию используется имя каталога. См. [Как skill получает имя команды](#how-a-skill-gets-its-command-name), чтобы узнать, чем это отличается от имени, которое вы вводите для вызова skill. |

250| `description` | Рекомендуется | Что делает skill и когда его использовать. Claude использует это, чтобы решить, когда применять skill. Если опущено, использует первый абзац содержимого markdown. Поместите основной вариант использования в первую очередь: комбинированный текст `description` и `when_to_use` усекается на 1 536 символах в списке skills для уменьшения использования контекста. |250| `description` | Рекомендуется | Что делает skill и когда его использовать. Claude использует это, чтобы решить, когда применять skill. Если опущено, использует первый абзац содержимого markdown. Поместите основной вариант использования в первую очередь: комбинированный текст `description` и `when_to_use` усекается на 1 536 символах в списке skills для уменьшения использования контекста. |

251| `when_to_use` | Нет | Дополнительный контекст для того, когда Claude должен вызвать skill, такой как фразы-триггеры или примеры запросов. Добавляется к `description` в списке skills и учитывается в лимите 1 536 символов. |251| `when_to_use` | Нет | Дополнительный контекст для того, когда Claude должен вызвать skill, такой как фразы-триггеры или примеры запросов. Добавляется к `description` в списке skills и учитывается в лимите 1 536 символов. |


255| `user-invocable` | Нет | Установите на `false`, чтобы скрыть из меню `/`. Используйте для фоновых знаний, которые пользователи не должны вызывать напрямую. По умолчанию: `true`. |255| `user-invocable` | Нет | Установите на `false`, чтобы скрыть из меню `/`. Используйте для фоновых знаний, которые пользователи не должны вызывать напрямую. По умолчанию: `true`. |

256| `allowed-tools` | Нет | Инструменты, которые Claude может использовать без запроса разрешения, когда этот skill активен. Принимает строку, разделённую пробелами или запятыми, или список YAML. |256| `allowed-tools` | Нет | Инструменты, которые Claude может использовать без запроса разрешения, когда этот skill активен. Принимает строку, разделённую пробелами или запятыми, или список YAML. |

257| `disallowed-tools` | Нет | Инструменты, удалённые из доступного пула Claude, пока этот skill активен. Используйте для автономных skills, которые никогда не должны вызывать определённые инструменты, такие как `AskUserQuestion` для фонового цикла. Принимает строку, разделённую пробелами или запятыми, или список YAML. Ограничение очищается при отправке вашего следующего сообщения. |257| `disallowed-tools` | Нет | Инструменты, удалённые из доступного пула Claude, пока этот skill активен. Используйте для автономных skills, которые никогда не должны вызывать определённые инструменты, такие как `AskUserQuestion` для фонового цикла. Принимает строку, разделённую пробелами или запятыми, или список YAML. Ограничение очищается при отправке вашего следующего сообщения. |

258| `model` | Нет | Модель для использования, когда этот skill активен. Переопределение применяется для остальной части текущего хода и не сохраняется в параметры; модель сессии возобновляется при вашем следующем запросе. Принимает те же значения, что и [`/model`](/ru/model-config), или `inherit`, чтобы сохранить активную модель. |258| `model` | Нет | Модель для использования, когда этот skill активен. Переопределение применяется для остальной части текущего хода и не сохраняется в параметры; модель сессии возобновляется при вашем следующем запросе. Принимает те же значения, что и [`/model`](/ru/model-config), или `inherit`, чтобы сохранить активную модель. Значение, исключённое списком разрешений `availableModels` вашей организации, не используется, и сессия сохраняет свою текущую модель. |

259| `effort` | Нет | [Уровень усилий](/ru/model-config#adjust-effort-level) при активном этом skill. Переопределяет уровень усилий сессии. По умолчанию: наследует из сессии. Опции: `low`, `medium`, `high`, `xhigh`, `max`; доступные уровни зависят от модели. |259| `effort` | Нет | [Уровень усилий](/ru/model-config#adjust-effort-level) при активном этом skill. Переопределяет уровень усилий сессии. По умолчанию: наследует из сессии. Опции: `low`, `medium`, `high`, `xhigh`, `max`; доступные уровни зависят от модели. |

260| `context` | Нет | Установите на `fork`, чтобы запустить в контексте forked subagent. |260| `context` | Нет | Установите на `fork`, чтобы запустить в контексте forked subagent. |

261| `agent` | Нет | Какой тип subagent использовать, когда установлен `context: fork`. |261| `agent` | Нет | Какой тип subagent использовать, когда установлен `context: fork`. |

sub-agents.md +4 −0

Details

3173. Frontmatter `model` определения subagent3173. Frontmatter `model` определения subagent

3184. Модель основного разговора3184. Модель основного разговора

319 319 

320Переменная окружения, параметр для конкретного вызова и значения frontmatter проверяются на соответствие списку разрешений [`availableModels`](/ru/model-config#restrict-model-selection) вашей организации. Значение, которое разрешается в исключённую модель, не используется, и subagent вместо этого работает на унаследованной модели.

321 

320<h3 id="control-subagent-capabilities">322<h3 id="control-subagent-capabilities">

321 Контролируйте возможности subagent323 Контролируйте возможности subagent

322</h3>324</h3>


849 851 

850Глубина считается количеством уровней subagent ниже основного разговора, независимо от того, работает ли каждый уровень в [переднем плане или фоне](#run-subagents-in-foreground-or-background). Subagent на глубине пять не получает инструмент Agent и не может порождать дальше. Лимит фиксирован и не конфигурируется.852Глубина считается количеством уровней subagent ниже основного разговора, независимо от того, работает ли каждый уровень в [переднем плане или фоне](#run-subagents-in-foreground-or-background). Subagent на глубине пять не получает инструмент Agent и не может порождать дальше. Лимит фиксирован и не конфигурируется.

851 853 

854Начиная с Claude Code v2.1.187, глубина фонового subagent фиксируется при его первом порождении, и [возобновление](#resume-subagents) его позже не изменяет эту глубину. Например, если ваш основной разговор порождает subagent A, и A порождает фоновый subagent B на глубине два, B по-прежнему находится на глубине два при возобновлении его непосредственно из основного разговора. Возобновление subagent из более поверхностного контекста не позволяет ему порождать дополнительные уровни, которые лимит глубины уже предотвратил.

855 

852Чтобы предотвратить порождение других subagents конкретным subagent, опустите `Agent` из его списка [`tools`](#available-tools) или добавьте его в `disallowedTools`.856Чтобы предотвратить порождение других subagents конкретным subagent, опустите `Agent` из его списка [`tools`](#available-tools) или добавьте его в `disallowedTools`.

853 857 

854[Fork](#fork-the-current-conversation) по-прежнему не может порождать другой fork. Он может порождать другие типы subagent, и они считаются в сторону лимита глубины.858[Fork](#fork-the-current-conversation) по-прежнему не может порождать другой fork. Он может порождать другие типы subagent, и они считаются в сторону лимита глубины.

Details

34 34 

35```35```

36/voice36/voice

37Voice mode enabled (hold). Hold Space to record. Dictation language: en (/config to change).37Voice mode enabled (hold). Hold space to record. Dictation language: en (/config to change).

38```38```

39 39 

40`/voice` принимает необязательный аргумент режима:40`/voice` принимает необязательный аргумент режима:


57}57}

58```58```

59 59 

60Пока голосовой ввод включен, нижний колонтитул ввода показывает подсказку `hold Space to speak` (удерживайте пробел для речи), когда запрос пуст. Подсказка отражает ваше текущее сочетание клавиш `voice:pushToTalk` и обновляется, если вы [переназначите клавишу диктовки](#rebind-the-dictation-key). Текст подсказки одинаков в обоих режимах и не отображается, если у вас настроена [пользовательская строка состояния](/ru/statusline).60Пока голосовой ввод включен, нижний колонтитул ввода показывает подсказку `hold space to speak` (удерживайте пробел для речи), когда запрос пуст. Подсказка отражает ваше текущее сочетание клавиш `voice:pushToTalk` и обновляется, если вы [переназначите клавишу диктовки](#rebind-the-dictation-key). Текст подсказки одинаков в обоих режимах и не отображается, если у вас настроена [пользовательская строка состояния](/ru/statusline).

61 61 

62Транскрибирование настроено для словаря кодирования в обоих режимах. Распространенные термины разработки, такие как `regex`, `OAuth`, `JSON` и `localhost`, распознаются правильно, а название вашего текущего проекта и имя ветки git автоматически добавляются как подсказки распознавания.62Транскрибирование настроено для словаря кодирования в обоих режимах. Распространенные термины разработки, такие как `regex`, `OAuth`, `JSON` и `localhost`, распознаются правильно, а название вашего текущего проекта и имя ветки git автоматически добавляются как подсказки распознавания.

63 63