SpyBara
Go Premium

Documentation 2026-09-22 23:59 UTC to 2026-09-23 23:57 UTC

19 files changed +545 −498. View all changes and history on the product overview
2026
Fri 25 23:58 Thu 24 22:57 Wed 23 23:57 Tue 22 23:59 Mon 21 22:59 Sun 20 23:59 Sat 19 23:57 Fri 18 23:58 Tue 15 23:58 Mon 14 22:58 Sun 13 21:00 Sat 12 03:02 Thu 10 23:00 Wed 9 22:58 Tue 8 20:00 Tue 1 21:02

artifacts.md +4 −0

Details

354| Organization policy | Ключи шифрования, управляемые клиентом (CMEK), HIPAA и [Zero Data Retention](/docs/ru/zero-data-retention) не включены для организации. |354| Organization policy | Ключи шифрования, управляемые клиентом (CMEK), HIPAA и [Zero Data Retention](/docs/ru/zero-data-retention) не включены для организации. |

355| Surface | Claude Code CLI или приложение Claude для рабочего стола версии 1.13576.0 или позже. Сеансы [Claude Tag](https://claude.com/docs/claude-tag/overview) также могут публиковать артефакты, когда оба Claude Tag и артефакты включены для организации. По умолчанию отключено в контекстах [Agent SDK](/docs/ru/agent-sdk/overview), GitHub Action и MCP-server, а также когда установлен [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ru/env-vars). |355| Surface | Claude Code CLI или приложение Claude для рабочего стола версии 1.13576.0 или позже. Сеансы [Claude Tag](https://claude.com/docs/claude-tag/overview) также могут публиковать артефакты, когда оба Claude Tag и артефакты включены для организации. По умолчанию отключено в контекстах [Agent SDK](/docs/ru/agent-sdk/overview), GitHub Action и MCP-server, а также когда установлен [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ru/env-vars). |

356 356 

357Доступность артефактов для вашей организации определяется политикой вашей организации, которую Claude Code загружает из `api.anthropic.com`. Когда Claude Code не может загрузить политику, артефакты недоступны. Когда вы просите один, Claude объясняет почему.

358 

359Если задействован прокси, VPN или веб-фильтр, попросите вашего администратора IT разрешить `api.anthropic.com`. Claude Code продолжает повторять попытки в фоновом режиме, и артефакты становятся доступными после загрузки политики и её разрешения.

360 

357<h2 id="disable-artifacts">361<h2 id="disable-artifacts">

358 Отключение артефактов362 Отключение артефактов

359</h2>363</h2>

Details

7> Запускайте сессии Claude Code в облаке из браузера, телефона, настольного приложения или терминала, перемещайте их с помощью --cloud и --teleport, а также автоматически исправляйте pull requests.7> Запускайте сессии Claude Code в облаке из браузера, телефона, настольного приложения или терминала, перемещайте их с помощью --cloud и --teleport, а также автоматически исправляйте pull requests.

8 8 

9<Note>9<Note>

10 Облачные сессии находятся в исследовательском предпросмотре для пользователей Pro, Max и Team, а также для пользователей Enterprise с премиум-местами или местами Chat + Claude Code.10 Облачные сессии доступны в планах Pro, Max и Team, а также для пользователей Enterprise с премиум-местами или местами Chat + Claude Code.

11</Note>11</Note>

12 12 

13Облачная сессия — это сессия Claude Code, которая запускается на облачной инфраструктуре вместо вашей машины. По умолчанию она запускается на инфраструктуре, управляемой Anthropic, или в [самостоятельно размещённом окружении](/docs/ru/self-hosted-environments) вашей организации, когда маршрутизируется туда. Сессия продолжает работать после того, как вы закроете ноутбук, и вы можете проверить её или управлять ею с любого устройства.13Облачная сессия — это сессия Claude Code, которая запускается на облачной инфраструктуре вместо вашей машины. По умолчанию она запускается на инфраструктуре, управляемой Anthropic, или в [самостоятельно размещённом окружении](/docs/ru/self-hosted-environments) вашей организации, когда маршрутизируется туда. Сессия продолжает работать после того, как вы закроете ноутбук, и вы можете проверить её или управлять ею с любого устройства.

Details

7> Настройте облачные среды для облачных сеансов Claude Code: уровни доступа в сети, переменные окружения, скрипты настройки и кэширование среды.7> Настройте облачные среды для облачных сеансов Claude Code: уровни доступа в сети, переменные окружения, скрипты настройки и кэширование среды.

8 8 

9<Note>9<Note>

10 Облачные среды применяются к [облачным сеансам](/docs/ru/claude-code-on-the-web), которые находятся в исследовательском предпросмотре для пользователей Pro, Max и Team, а также для пользователей Enterprise с [премиум-местами или местами Chat + Claude Code](https://support.claude.com/en/articles/11845131-use-claude-code-with-your-team-or-enterprise-plan).10 Облачные среды применяются к [облачным сеансам](/docs/ru/claude-code-on-the-web), которые доступны на планах Pro, Max и Team, а также для пользователей Enterprise с [премиум-местами или местами Chat + Claude Code](https://support.claude.com/en/articles/11845131-use-claude-code-with-your-team-or-enterprise-plan).

11</Note>11</Note>

12 12 

13Каждый [облачный сеанс](/docs/ru/claude-code-on-the-web) выполняется в облачной среде. Вы можете настроить среду, чтобы разрешить или запретить [доступ в сеть](#access-levels), [установить переменные окружения](#set-environment-variables) для сеанса, на планах Pro и Max сохранять [учётные данные API](#add-api-credentials), которые сеансы используют без их просмотра, и запустить [скрипт настройки](#setup-scripts) перед тем, как Claude начнёт работу.13Каждый [облачный сеанс](/docs/ru/claude-code-on-the-web) выполняется в облачной среде. Вы можете настроить среду, чтобы разрешить или запретить [доступ в сеть](#access-levels), [установить переменные окружения](#set-environment-variables) для сеанса, на планах Pro и Max сохранять [учётные данные API](#add-api-credentials), которые сеансы используют без их просмотра, и запустить [скрипт настройки](#setup-scripts) перед тем, как Claude начнёт работу.

env-vars.md +2 −1

Details

311| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Установите на `1`, чтобы пропустить проверку записей файла блокировки IDE при подключении. Используйте, когда автоподключение не может найти вашу IDE, несмотря на её работу |311| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Установите на `1`, чтобы пропустить проверку записей файла блокировки IDE при подключении. Используйте, когда автоподключение не может найти вашу IDE, несмотря на её работу |

312| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Сколько [подагентов](/docs/ru/sub-agents#concurrent-subagent-limit) может работать в одном сеансе перед тем, как инструмент Agent откажется порождать другого (по умолчанию: 20). Принимает положительное целое число в простых цифрах; всё остальное игнорируется, поэтому переменная может отрегулировать ограничение, но не может отключить его. Требует Claude Code версии 2.1.217 или позже |312| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Сколько [подагентов](/docs/ru/sub-agents#concurrent-subagent-limit) может работать в одном сеансе перед тем, как инструмент Agent откажется порождать другого (по умолчанию: 20). Принимает положительное целое число в простых цифрах; всё остальное игнорируется, поэтому переменная может отрегулировать ограничение, но не может отключить его. Требует Claude Code версии 2.1.217 или позже |

313| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Переопределить размер окна контекста, который Claude Code предполагает для активной модели. Начиная с версии 2.1.193, как это применяется, зависит от того, как Claude Code разрешает ID модели; см. [Исправить окно для ID шлюза или пользовательской модели](/docs/ru/model-config#correct-the-window-for-a-gateway-or-custom-model-id). Используйте это при маршрутизации к модели через `ANTHROPIC_BASE_URL`, чьё окно контекста не совпадает с встроенным размером для её имени |313| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Переопределить размер окна контекста, который Claude Code предполагает для активной модели. Начиная с версии 2.1.193, как это применяется, зависит от того, как Claude Code разрешает ID модели; см. [Исправить окно для ID шлюза или пользовательской модели](/docs/ru/model-config#correct-the-window-for-a-gateway-or-custom-model-id). Используйте это при маршрутизации к модели через `ANTHROPIC_BASE_URL`, чьё окно контекста не совпадает с встроенным размером для её имени |

314| `CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH` | Максимальная длина в символах каждого описания инструмента MCP и инструкций каждого MCP сервера, которые Claude Code отправляет модели (по умолчанию: 2048). Claude Code [усекает более длинный текст](/docs/ru/mcp#for-mcp-server-authors). Принимает положительное целое число в простых цифрах. Всё остальное игнорируется и применяется значение по умолчанию. Требует Claude Code версии 2.1.280 или позже |

314| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Установить максимальное количество выходных токенов для большинства запросов. Значения по умолчанию и ограничения варьируются по модели; см. [максимальные выходные токены](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). Claude Code по умолчанию использует 32000 для ID моделей, которые он не распознаёт, такие как имена, специфичные для шлюза, и понижает значения выше ограничения модели до ограничения. Увеличение этого значения уменьшает эффективное окно контекста, доступное перед срабатыванием [автокомпактирования](/docs/ru/costs#reduce-token-usage) |315| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Установить максимальное количество выходных токенов для большинства запросов. Значения по умолчанию и ограничения варьируются по модели; см. [максимальные выходные токены](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). Claude Code по умолчанию использует 32000 для ID моделей, которые он не распознаёт, такие как имена, специфичные для шлюза, и понижает значения выше ограничения модели до ограничения. Увеличение этого значения уменьшает эффективное окно контекста, доступное перед срабатыванием [автокомпактирования](/docs/ru/costs#reduce-token-usage) |

315| `CLAUDE_CODE_MAX_RETRIES` | Переопределить количество раз для повтора неудачных запросов API (по умолчанию: 10). Ограничено 15 начиная с версии 2.1.186; начиная с версии 2.1.199, `CLAUDE_CODE_RETRY_WATCHDOG` повышает значение по умолчанию и удаляет ограничение. Для неконтролируемых сеансов, которым нужно ждать через более длительные сбои, установите `CLAUDE_CODE_RETRY_WATCHDOG` вместо этого |316| `CLAUDE_CODE_MAX_RETRIES` | Переопределить количество раз для повтора неудачных запросов API (по умолчанию: 10). Ограничено 15 начиная с версии 2.1.186; начиная с версии 2.1.199, `CLAUDE_CODE_RETRY_WATCHDOG` повышает значение по умолчанию и удаляет ограничение. Для неконтролируемых сеансов, которым нужно ждать через более длительные сбои, установите `CLAUDE_CODE_RETRY_WATCHDOG` вместо этого |

316| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | Удалено в версии 2.1.224 и теперь не работает. Ранее ограничивало общее количество [подагентов](/docs/ru/sub-agents), которых Claude мог порождать с инструментом Agent в одном сеансе (по умолчанию: 200); порождение сверх ограничения не выполнялось с `Subagent spawn limit reached`. [Ограничение одновременных подагентов](/docs/ru/sub-agents#concurrent-subagent-limit) и [ограничение глубины](/docs/ru/sub-agents#let-subagents-spawn-their-own-subagents) по-прежнему применяются |317| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | Удалено в версии 2.1.224 и теперь не работает. Ранее ограничивало общее количество [подагентов](/docs/ru/sub-agents), которых Claude мог порождать с инструментом Agent в одном сеансе (по умолчанию: 200); порождение сверх ограничения не выполнялось с `Subagent spawn limit reached`. [Ограничение одновременных подагентов](/docs/ru/sub-agents#concurrent-subagent-limit) и [ограничение глубины](/docs/ru/sub-agents#let-subagents-spawn-their-own-subagents) по-прежнему применяются |


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

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

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

344| `CLAUDE_CODE_PLUGIN_DIRS` | Каталоги плагинов для загрузки для сеанса, каждый загруженный способом, которым флаг [`--plugin-dir`](/docs/ru/plugins#test-your-plugins-locally) загружает его. Разделите несколько путей с `:` на Unix или `;` на Windows. Дайте каждый путь как абсолютный путь или начните его с `~`, потому что Claude Code пропускает относительные пути. Требует Claude Code версии 2.1.280 или позже |

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

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

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


524 526 

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

526 528 

527* Иметь Claude Code [читающий файлы `AGENTS.md`](/docs/ru/memory#agents-md) как инструкции проекта; он загружает только файлы `CLAUDE.md`

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

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

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

Details

38 38 

39Они имеют различия, зависящие от поставщика:39Они имеют различия, зависящие от поставщика:

40 40 

41* **Память CLAUDE.md**: файлы `CLAUDE.md` загружаются у каждого поставщика. Чтение [файлов `AGENTS.md`](/docs/ru/memory#agents-md) в качестве инструкций проекта также требует сеанса, который [получает флаги функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching)

42* **MCP servers**: [коннекторы из claude.ai](/docs/ru/mcp#use-mcp-servers-from-claude-ai) загружаются только когда ваша подписка claude.ai является активным методом аутентификации. [Поиск инструментов](/docs/ru/mcp#configure-tool-search) отключён по умолчанию когда `ANTHROPIC_BASE_URL` указывает на хост, не принадлежащий первой стороне, и не поддерживается на моделях Google Cloud's Agent Platform более ранних, чем поколение Claude 4.5, или на развёртываниях Microsoft Foundry [размещённых на Azure](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options)41* **MCP servers**: [коннекторы из claude.ai](/docs/ru/mcp#use-mcp-servers-from-claude-ai) загружаются только когда ваша подписка claude.ai является активным методом аутентификации. [Поиск инструментов](/docs/ru/mcp#configure-tool-search) отключён по умолчанию когда `ANTHROPIC_BASE_URL` указывает на хост, не принадлежащий первой стороне, и не поддерживается на моделях Google Cloud's Agent Platform более ранних, чем поколение Claude 4.5, или на развёртываниях Microsoft Foundry [размещённых на Azure](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options)

43* **Subagents**: встроенный [Explore subagent](/docs/ru/sub-agents#built-in-subagents) ограничивает унаследованную модель до Opus на Claude API и наследует модель основного разговора напрямую у любого другого поставщика, включая Claude Platform на AWS42* **Subagents**: встроенный [Explore subagent](/docs/ru/sub-agents#built-in-subagents) ограничивает унаследованную модель до Opus на Claude API и наследует модель основного разговора напрямую у любого другого поставщика, включая Claude Platform на AWS

44* **[Commands](/docs/ru/commands#all-commands)**:43* **[Commands](/docs/ru/commands#all-commands)**:

glossary.md +1 −1

Details

16 AGENTS.md16 AGENTS.md

17</h3>17</h3>

18 18 

19Файл markdown с инструкциями проекта, которые вы пишете для AI-агентов кодирования. Если в вашем репозитории есть такой файл и нет [CLAUDE.md](#claude-md), Claude читает его как инструкции вашего проекта без необходимости добавления второго файла. Вы можете изменить параметр **Project instructions** в `/config`, чтобы Claude читал оба файла или только `CLAUDE.md`. Прямое чтение `AGENTS.md` требует Claude Code v2.1.277 или более поздней версии в сеансе, который получает флаги функций; в других версиях импортируйте его из CLAUDE.md.19Файл markdown с инструкциями проекта, которые вы пишете для AI-агентов кодирования. Если в вашем репозитории есть такой файл и нет [CLAUDE.md](#claude-md), Claude читает его как инструкции вашего проекта без необходимости добавления второго файла. Вы можете изменить параметр **Project instructions** в `/config`, чтобы Claude читал оба файла или только `CLAUDE.md`. Прямое чтение `AGENTS.md` требует Claude Code v2.1.277 или более поздней версии. В некоторых сеансах Claude [не может читать `AGENTS.md`](/docs/ru/memory#when-agents-md-support-is-unavailable), поэтому [импортируйте его из `CLAUDE.md`](/docs/ru/memory#share-one-file-with-other-coding-tools) вместо этого.

20 20 

21Подробнее: [AGENTS.md](/docs/ru/memory#agents-md)21Подробнее: [AGENTS.md](/docs/ru/memory#agents-md)

22 22 

mcp.md +3 −1

Details

1562* Когда Claude должен искать ваши инструменты1562* Когда Claude должен искать ваши инструменты

1563* Ключевые возможности, которые предоставляет ваш сервер1563* Ключевые возможности, которые предоставляет ваш сервер

1564 1564 

1565Claude Code усекает описания инструментов и инструкции сервера на 2 КБ каждое. Держите их в краткой форме, чтобы избежать усечения, и поместите критические детали в начало.1565Claude Code усекает описания инструментов и инструкции сервера на 2 048 символов по умолчанию. Держите их в краткой форме, и поместите критические детали в начало.

1566 

1567Чтобы изменить лимит для каждого сервера MCP в вашем сеансе, установите [`CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH`](/docs/ru/env-vars#variables) на количество символов. Эта переменная требует Claude Code v2.1.280 или позже.

1566 1568 

1567<h3 id="configure-tool-search">1569<h3 id="configure-tool-search">

1568 Настройка поиска инструментов1570 Настройка поиска инструментов

memory.md +5 −7

Details

379Чтобы изменить значение по умолчанию, например чтобы Claude всегда читал оба файла, читал только `CLAUDE.md` или читал только управляемые организацией инструкции, [измените параметр **Project instructions**](#choose-which-instruction-files-load).379Чтобы изменить значение по умолчанию, например чтобы Claude всегда читал оба файла, читал только `CLAUDE.md` или читал только управляемые организацией инструкции, [измените параметр **Project instructions**](#choose-which-instruction-files-load).

380 380 

381<Note>381<Note>

382 Чтение `AGENTS.md` напрямую требует Claude Code v2.1.277 или более поздней версии. В некоторых сеансах, таких как сеансы на Amazon Bedrock или с отключённой телеметрией, Claude [не может читать `AGENTS.md`](#when-agents-md-support-is-unavailable), поэтому [импортируйте его из `CLAUDE.md`](#share-one-file-with-other-coding-tools) вместо этого.382 Чтение `AGENTS.md` напрямую требует Claude Code v2.1.277 или более поздней версии. В некоторых сеансах Claude [не может читать `AGENTS.md`](#when-agents-md-support-is-unavailable), поэтому [импортируйте его из `CLAUDE.md`](#share-one-file-with-other-coding-tools) вместо этого.

383</Note>383</Note>

384 384 

385<h3 id="when-claude-code-reads-agents-md">385<h3 id="when-claude-code-reads-agents-md">


436В этих сеансах Claude читает только файлы `CLAUDE.md`, и **Project instructions** не появляется в панели параметров `/config`:436В этих сеансах Claude читает только файлы `CLAUDE.md`, и **Project instructions** не появляется в панели параметров `/config`:

437 437 

438* Вы используете Claude Code версии до v2.1.277438* Вы используете Claude Code версии до v2.1.277

439* Ваш сеанс не [получает флаги функций от Anthropic](/docs/ru/env-vars#features-that-need-feature-flag-fetching), например потому что вы используете Amazon Bedrock или другого поставщика третьей стороны, или вы отключили телеметрию. Связанный раздел содержит полный список

440* Это ваш [первый сеанс после установки или обновления](/docs/ru/env-vars#first-session-after-an-install-or-upgrade) до версии с поддержкой `AGENTS.md`. Claude читает `AGENTS.md` со следующего сеанса

441* Вы отключили встроенный плагин `agents-md` в `/plugin`439* Вы отключили встроенный плагин `agents-md` в `/plugin`

440* В некоторых случаях это ваш [первый сеанс после обновления](/docs/ru/env-vars#first-session-after-an-install-or-upgrade) с v2.1.276 или более ранней версии. Claude читает `AGENTS.md` со следующего сеанса

442 441 

443Чтобы дать Claude ваш `AGENTS.md` в этих сеансах, [импортируйте его из `CLAUDE.md`](#share-one-file-with-other-coding-tools).442До v2.1.281 некоторые сеансы, такие как сеансы на Amazon Bedrock или с отключённой телеметрией, читали только файлы `CLAUDE.md`. На этих версиях обновите Claude Code. Чтобы дать Claude ваш `AGENTS.md` в любом из этих сеансов, [импортируйте его из `CLAUDE.md`](#share-one-file-with-other-coding-tools).

444 443 

445<h3 id="where-agents-md-differs-from-claude-md">444<h3 id="where-agents-md-differs-from-claude-md">

446 Where AGENTS.md differs from CLAUDE.md445 Where AGENTS.md differs from CLAUDE.md


637Если ваш репозиторий содержит `AGENTS.md` и Claude, похоже, не знает, что в нём написано, обычной причиной является `CLAUDE.md` где-то на пути проекта. По умолчанию Claude читает `AGENTS.md` только когда у вас нет `CLAUDE.md` или `CLAUDE.local.md` в вашем рабочем каталоге или выше него. Проверьте их в таком порядке:636Если ваш репозиторий содержит `AGENTS.md` и Claude, похоже, не знает, что в нём написано, обычной причиной является `CLAUDE.md` где-то на пути проекта. По умолчанию Claude читает `AGENTS.md` только когда у вас нет `CLAUDE.md` или `CLAUDE.local.md` в вашем рабочем каталоге или выше него. Проверьте их в таком порядке:

638 637 

6391. Ищите `CLAUDE.md`, `.claude/CLAUDE.md` или `CLAUDE.local.md` в вашем рабочем каталоге или в любом каталоге выше него, кроме вашего `~/.claude/CLAUDE.md`. Если вы найдёте один, Claude читает его вместо `AGENTS.md`, если вы не установите **Project instructions** на `claude-md-and-agents-md`.6381. Ищите `CLAUDE.md`, `.claude/CLAUDE.md` или `CLAUDE.local.md` в вашем рабочем каталоге или в любом каталоге выше него, кроме вашего `~/.claude/CLAUDE.md`. Если вы найдёте один, Claude читает его вместо `AGENTS.md`, если вы не установите **Project instructions** на `claude-md-and-agents-md`.

6402. Запустите `claude --version` и подтвердите v2.1.277 или более позднюю версию.6392. Запустите `claude --version` и подтвердите v2.1.277 или более позднюю версию. До версии v2.1.281 некоторые сеансы, такие как сеансы на Amazon Bedrock или с отключённой телеметрией, [не могли загружать `AGENTS.md`](#when-agents-md-support-is-unavailable), поэтому на этих версиях обновитесь до v2.1.281 или более поздней версии.

6413. Проверьте, является ли ваш сеанс одним из тех, которые [не могут загружать `AGENTS.md`](#when-agents-md-support-is-unavailable), например сеанс у стороннего поставщика или с отключённой телеметрией.6403. Введите `/config` в вашем сеансе, чтобы открыть панель параметров и подтвердить, что **Project instructions** не установлен на `claude-md` или `managed-only`. Если вы вообще не видите этот параметр, ваш сеанс — это один из тех, которые [не могут загружать `AGENTS.md`](#when-agents-md-support-is-unavailable).

6424. Введите `/config` в вашем сеансе, чтобы открыть панель параметров и подтвердить, что **Project instructions** не установлен на `claude-md` или `managed-only`. Если вы вообще не видите этот параметр, ваш сеанс — это один из тех, которые [не могут загружать `AGENTS.md`](#when-agents-md-support-is-unavailable).

643 641 

644Чтобы проверить, прочитал ли Claude ваш `AGENTS.md`, запустите `/memory` и ищите его путь в списке.642Чтобы проверить, прочитал ли Claude ваш `AGENTS.md`, запустите `/memory` и ищите его путь в списке.

645 643 

monitoring-usage.md +311 −306

Details

526 526 

527Все метрики и события имеют эти стандартные атрибуты:527Все метрики и события имеют эти стандартные атрибуты:

528 528 

529| Атрибут | Описание | Управляется |529| Атрибут | Описание | Контролируется |

530| --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------- |530| --------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |

531| `session.id` | Уникальный идентификатор сеанса | `OTEL_METRICS_INCLUDE_SESSION_ID` (по умолчанию: true) |531| `session.id` | Уникальный идентификатор сеанса | `OTEL_METRICS_INCLUDE_SESSION_ID` (по умолчанию: true) |

532| `app.version` | Текущая версия Claude Code | `OTEL_METRICS_INCLUDE_VERSION` (по умолчанию: false) |532| `app.version` | Текущая версия Claude Code | `OTEL_METRICS_INCLUDE_VERSION` (по умолчанию: false) |

533| `app.entrypoint` | Как был запущен сеанс, такой как `cli`, `sdk-cli`, `sdk-ts`, `sdk-py` или `claude-vscode` | `OTEL_METRICS_INCLUDE_ENTRYPOINT` (по умолчанию: false) |533| `app.entrypoint` | Способ запуска сеанса, например `cli`, `sdk-cli`, `sdk-ts`, `sdk-py` или `claude-vscode` | `OTEL_METRICS_INCLUDE_ENTRYPOINT` (по умолчанию: false) |

534| `organization.id` | UUID организации (при аутентификации) | Всегда включается, когда доступно |534| `organization.id` | UUID организации (при аутентификации) | Всегда включается, когда доступен |

535| `user.account_uuid` | UUID учетной записи (при аутентификации) | `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` (по умолчанию: true) |535| `user.account_uuid` | UUID учётной записи (при аутентификации) | `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` (по умолчанию: true) |

536| `user.account_id` | ID учетной записи в формате с тегами, соответствующий API администратора Anthropic (при аутентификации), такой как `user_01BWBeN28...` | `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` (по умолчанию: true) |536| `user.account_id` | ID учётной записи в формате с тегами, соответствующий API администратора Anthropic (при аутентификации), например `user_01BWBeN28...` | `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` (по умолчанию: true) |

537| `user.id` | Случайный анонимный идентификатор, генерируемый при первом запуске и сохраняемый в `~/.claude.json`. Он не содержит личной информации и не является производным от вашей учетной записи Claude. Удаление файла создает новое несвязанное значение при следующем запуске. | Всегда включается |537| `user.id` | Случайный анонимный идентификатор, созданный при первом запуске и сохранённый в `~/.claude.json`. Он не содержит личной информации и не является производным от вашей учётной записи Claude. Удаление файла создаёт новое несвязанное значение при следующем запуске. | Всегда включается |

538| `user.email` | Адрес электронной почты пользователя, из вашего входа или, в [облачном сеансе](/docs/ru/claude-code-on-the-web), из учетных данных самого сеанса | Всегда включается, когда доступно |538| `user.email` | Адрес электронной почты пользователя из вашего входа или, в [облачном сеансе](/docs/ru/claude-code-on-the-web), из учётных данных самого сеанса | Всегда включается, когда доступен |

539| `terminal.type` | Тип терминала, такой как `iTerm.app`, `vscode`, `cursor` или `tmux` | Всегда включается при обнаружении |539| `terminal.type` | Тип терминала, например `iTerm.app`, `vscode`, `cursor` или `tmux` | Всегда включается при обнаружении |

540| Ключи из `OTEL_RESOURCE_ATTRIBUTES` | Пользовательские атрибуты, которые вы установили, такие как `department` или `team.id`. См. [Поддержка многокомандной организации](#multi-team-organization-support) | `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` (по умолчанию: true) |540| Ключи из `OTEL_RESOURCE_ATTRIBUTES` | Пользовательские атрибуты, которые вы устанавливаете, например `department` или `team.id`. См. [Поддержка многокомандной организации](#multi-team-organization-support) | `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` (по умолчанию: true) |

541| `vcs.repository.url.full`, `vcs.owner.name`, `vcs.repository.name`, `vcs.provider.name` | Идентичность репозитория сеанса, полученная из его удаленного хранилища `origin`. См. [Атрибуты репозитория](#repository-attributes) | `OTEL_METRICS_INCLUDE_REPOSITORY` (по умолчанию: false). Требует Claude Code v2.1.269 или позже |541| `vcs.repository.url.full`, `vcs.owner.name`, `vcs.repository.name`, `vcs.provider.name` | Идентификация репозитория сеанса, полученная из его удалённого хранилища `origin`. См. [Атрибуты репозитория](#repository-attributes) | `OTEL_METRICS_INCLUDE_REPOSITORY` (по умолчанию: false). Требуется Claude Code v2.1.269 или позже |

542 542 

543Когда Claude Code подписан на [Claude apps gateway](/docs/ru/claude-apps-gateway), CLI помечает экспорты аутентифицированной идентичностью из сеанса gateway: `user.id` является субъектом IdP, а не анонимным идентификатором установки, `user.email` является адресом электронной почты, на который выполнен вход, и `user.groups` содержит членство в группе IdP в виде строки, разделенной запятыми. Каждый экспорт также содержит `identity.source: gateway-oidc`. Идентичность gateway применяется последней, поэтому ключи `user.*` и `identity.*`, установленные через `OTEL_RESOURCE_ATTRIBUTES`, игнорируются в сеансах gateway.543Когда Claude Code подписан на [шлюз приложений Claude](/docs/ru/claude-apps-gateway), CLI помечает экспорты аутентифицированной идентификацией из сеанса шлюза: `user.id` — это субъект IdP, а не анонимный идентификатор установки, `user.email` — это адрес электронной почты входа, а `user.groups` содержит членство в группе IdP в виде строки, разделённой запятыми. Каждый экспорт также содержит `identity.source: gateway-oidc`. Идентификация шлюза применяется последней, поэтому ключи `user.*` и `identity.*`, установленные через `OTEL_RESOURCE_ATTRIBUTES`, игнорируются в сеансах шлюза.

544 544 

545События дополнительно включают следующие атрибуты. Они никогда не прикрепляются к метрикам, потому что они вызовут неограниченную кардинальность:545События дополнительно включают следующие атрибуты. Они никогда не прикрепляются к метрикам, так как это вызовет неограниченную кардинальность:

546 546 

547* `prompt.id`: UUID, коррелирующий пользовательскую подсказку со всеми последующими событиями до следующей подсказки. См. [Атрибуты корреляции событий](#event-correlation-attributes).547* `prompt.id`: UUID, коррелирующий пользовательский запрос со всеми последующими событиями до следующего запроса. См. [Атрибуты корреляции событий](#event-correlation-attributes).

548* `workspace.host_paths`: каталоги рабочей области хоста, выбранные в приложении для рабочего стола, как массив строк548* `workspace.host_paths`: каталоги рабочей области хоста, выбранные в приложении для рабочего стола, в виде массива строк

549* `workflow.run_id`: идентификатор запуска, с префиксом `wf_`, на событиях API и инструментов, выданных агентами, которые принадлежат запуску инструмента [Workflow](/docs/ru/workflows). Фильтрация событий по одному `workflow.run_id` восстанавливает запросы API и результаты инструментов этого запуска. Идентификатор охватывает агентов, которых порождает скрипт workflow, и любых агентов, которых они порождают в свою очередь, такие как вызовы навыков. Он совпадает с идентификатором запуска, указанным в результате инструмента Workflow. Отсутствует на всех остальных событиях. Требует Claude Code v2.1.202 или позже549* `workflow.run_id`: идентификатор запуска с префиксом `wf_` на событиях API и инструментов, выпущенных агентами, которые принадлежат запуску инструмента [Workflow](/docs/ru/workflows). Фильтрация событий по одному `workflow.run_id` восстанавливает запросы API и результаты инструментов этого запуска. Идентификатор охватывает агентов, которых порождает скрипт рабочего процесса, и любых агентов, которых они порождают в свою очередь, например вызовы навыков. Он совпадает с идентификатором запуска, указанным в результате инструмента Workflow. Отсутствует на всех остальных событиях. Требуется Claude Code v2.1.202 или позже

550* `workflow.name`: имя workflow, `meta.name` его скрипта, выданное вместе с `workflow.run_id`. Встроенные имена workflow появляются как есть при выполнении немодифицированного встроенного скрипта. Определяемые пользователем имена, включая отредактированные копии встроенных скриптов, заменяются на `custom`, если не установлен `OTEL_LOG_TOOL_DETAILS=1`. Требует Claude Code v2.1.202 или позже550* `workflow.name`: имя рабочего процесса, `meta.name` его скрипта, выпущенное вместе с `workflow.run_id`. Встроенные имена рабочих процессов отображаются как есть при выполнении немодифицированного встроенного скрипта. Имена, созданные пользователем, включая отредактированные копии встроенных скриптов, заменяются на `custom`, если не установлено `OTEL_LOG_TOOL_DETAILS=1`. Требуется Claude Code v2.1.202 или позже

551 551 

552<h4 id="repository-attributes">552<h4 id="repository-attributes">

553 Атрибуты репозитория553 Атрибуты репозитория

554</h4>554</h4>

555 555 

556Установите `OTEL_METRICS_INCLUDE_REPOSITORY=true`, чтобы пометить метрики и события идентичностью репозитория сеанса, чтобы общий сборщик мог атрибутировать использование по репозиторию. Требует Claude Code v2.1.269 или позже.556Установите `OTEL_METRICS_INCLUDE_REPOSITORY=true`, чтобы пометить метрики и события идентификацией репозитория сеанса, чтобы общий сборщик мог атрибутировать использование по репозиторию. Требуется Claude Code v2.1.269 или позже.

557 557 

558Claude Code получает эти атрибуты один раз за сеанс из удаленного хранилища `origin` репозитория. HTTPS и SSH удаленные хранилища одного репозитория производят идентичные значения:558Claude Code получает эти атрибуты один раз за сеанс из удалённого хранилища `origin` репозитория. HTTPS и SSH удалённые хранилища одного репозитория создают идентичные значения:

559 559 

560| Атрибут | Значение |560| Атрибут | Значение |

561| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |561| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

562| `vcs.repository.url.full` | URL браузера репозитория без `.git`, такой как `https://github.com/example-org/example-repo` |562| `vcs.repository.url.full` | URL браузера репозитория без `.git`, например `https://github.com/example-org/example-repo` |

563| `vcs.owner.name` | Путь владельца или группы, такой как `example-org`; опущен, когда путь удаленного хранилища имеет один сегмент |563| `vcs.owner.name` | Путь владельца или группы, например `example-org`; опускается, когда путь удалённого хранилища имеет один сегмент |

564| `vcs.repository.name` | Простое имя репозитория, такой как `example-repo` |564| `vcs.repository.name` | Простое имя репозитория, например `example-repo` |

565| `vcs.provider.name` | `github`, `gitlab`, `bitbucket` или `gitea`, когда Claude Code распознает хост удаленного хранилища или форму URL как один из этих поставщиков; опущен в противном случае |565| `vcs.provider.name` | `github`, `gitlab`, `bitbucket` или `gitea`, когда Claude Code распознаёт хост удалённого хранилища или форму URL как один из этих поставщиков; опускается в противном случае |

566 566 

567Значения преобразуются в нижний регистр, и учетные данные, строки запроса и фрагменты из URL удаленного хранилища никогда не появляются в них. Атрибуты опущены, когда сеанс не имеет удаленного хранилища `origin`, когда удаленное хранилище не имеет формы URL или когда единственный охватывающий репозиторий — это ваш домашний каталог.567Значения приводятся в нижний регистр, и учётные данные, строки запроса и фрагменты из URL удалённого хранилища никогда не отображаются в них. Атрибуты опускаются, когда сеанс не имеет удалённого хранилища `origin`, когда удалённое хранилище не имеет формы URL или когда единственный охватывающий репозиторий — это ваш домашний каталог.

568 568 

569Ключ `vcs.*`, который вы объявляете в [`OTEL_RESOURCE_ATTRIBUTES`](#multi-team-organization-support), заменяет полученное значение для этого ключа. Если вы объявляете `vcs.repository.url.full`, Claude Code никогда не читает удаленное хранилище и сообщает только ключи, которые вы объявляете.569Ключ `vcs.*`, который вы объявляете в [`OTEL_RESOURCE_ATTRIBUTES`](#multi-team-organization-support), заменяет полученное значение для этого ключа. Если вы объявляете `vcs.repository.url.full`, Claude Code никогда не читает удалённое хранилище и сообщает только объявленные вами ключи.

570 570 

571Атрибуты поступают только на ваши собственные экспортеры; телеметрия Anthropic отбрасывает каждый ключ `vcs.*`.571Атрибуты передаются только вашим собственным экспортёрам; телеметрия Anthropic отбрасывает каждый ключ `vcs.*`.

572 572 

573<h3 id="metrics">573<h3 id="metrics">

574 Метрики574 Метрики

575</h3>575</h3>

576 576 

577Claude Code экспортирует следующие метрики. Столбец Unit показывает строку единицы OpenTelemetry, прикрепленную к каждой метрике; метрики count не имеют единиц.577Claude Code экспортирует следующие метрики. Столбец Unit показывает строку единицы OpenTelemetry, прикреплённую к каждой метрике; метрики подсчёта не имеют никаких.

578 578 

579| Имя метрики | Описание | Единица |579| Имя метрики | Описание | Единица |

580| ------------------------------------- | --------------------------------------------------------------- | ------- |580| ------------------------------------- | --------------------------------------------------------------- | ------- |

581| `claude_code.session.count` | Количество запущенных сеансов CLI | none |581| `claude_code.session.count` | Количество запущенных сеансов CLI | нет |

582| `claude_code.lines_of_code.count` | Количество строк кода, которые были изменены | none |582| `claude_code.lines_of_code.count` | Количество изменённых строк кода | нет |

583| `claude_code.pull_request.count` | Количество созданных pull request | none |583| `claude_code.pull_request.count` | Количество созданных запросов на слияние | нет |

584| `claude_code.commit.count` | Количество созданных git коммитов | none |584| `claude_code.commit.count` | Количество созданных коммитов git | нет |

585| `claude_code.cost.usage` | Стоимость сеанса Claude Code | USD |585| `claude_code.cost.usage` | Стоимость сеанса Claude Code | USD |

586| `claude_code.token.usage` | Количество использованных токенов | tokens |586| `claude_code.token.usage` | Количество использованных токенов | tokens |

587| `claude_code.code_edit_tool.decision` | Количество решений о разрешении инструмента редактирования кода | none |587| `claude_code.code_edit_tool.decision` | Количество решений о разрешении инструмента редактирования кода | нет |

588| `claude_code.active_time.total` | Общее активное время | s |588| `claude_code.active_time.total` | Общее активное время | s |

589 589 

590Когда `prometheus` является единственным экспортером, указанным в `OTEL_METRICS_EXPORTER`, Claude Code опускает единицы `USD`, `tokens` и `s` из экспортируемых метрик, чтобы скрейп оставался в действительном формате текста Prometheus. Имена метрик не изменяются, и конфигурации, которые объединяют экспортеры, такие как `otlp,prometheus`, сохраняют единицы. До v2.1.216 скрейп Prometheus включал строки `# UNIT`, специфичные для OpenMetrics, которые некоторые скрейперы отклоняли.590Когда `prometheus` — единственный экспортёр, указанный в `OTEL_METRICS_EXPORTER`, Claude Code опускает единицы `USD`, `tokens` и `s` из экспортируемых метрик, чтобы скрейп оставался действительным текстовым форматом Prometheus. Имена метрик не изменяются, и конфигурации, которые объединяют экспортёры, такие как `otlp,prometheus`, сохраняют единицы. До v2.1.216 скрейп Prometheus включал строки `# UNIT`, специфичные для OpenMetrics, которые некоторые скрейперы отклоняли.

591 591 

592<h3 id="metric-details">592<h3 id="metric-details">

593 Детали метрик593 Детали метрик


596Каждая метрика включает стандартные атрибуты, перечисленные выше. Метрики с дополнительными контекстно-специфичными атрибутами отмечены ниже.596Каждая метрика включает стандартные атрибуты, перечисленные выше. Метрики с дополнительными контекстно-специфичными атрибутами отмечены ниже.

597 597 

598<h4 id="session-counter">598<h4 id="session-counter">

599 Счетчик сеансов599 Счётчик сеансов

600</h4>600</h4>

601 601 

602Увеличивается в начале каждого сеанса.602Увеличивается в начале каждого сеанса.


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

605 605 

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

607* `start_type`: Как был запущен сеанс. Один из `"fresh"`, `"resume"`, `"continue"` или `"agents_view"`. Значение `"agents_view"` идентифицирует процесс панели управления `claude agents`, локальный пользовательский интерфейс, запущенный пользователем, а не разговорный сеанс. Отфильтруйте по этому значению, чтобы отделить запуски процесса UI от разговорных сеансов в ваших панелях управления.607* `start_type`: Способ запуска сеанса. Один из `"fresh"`, `"resume"`, `"continue"` или `"agents_view"`. Значение `"agents_view"` идентифицирует процесс панели управления `claude agents`, локальный пользовательский интерфейс, а не разговорный сеанс. Фильтруйте по этому значению, чтобы отделить запуски процесса пользовательского интерфейса от разговорных сеансов в ваших панелях управления.

608 608 

609<h4 id="lines-of-code-counter">609<h4 id="lines-of-code-counter">

610 Счетчик строк кода610 Счётчик строк кода

611</h4>611</h4>

612 612 

613Увеличивается при добавлении или удалении кода.613Увеличивается при добавлении или удалении кода.


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

620 620 

621<h4 id="pull-request-counter">621<h4 id="pull-request-counter">

622 Счетчик pull request622 Счётчик запросов на слияние

623</h4>623</h4>

624 624 

625Увеличивается при создании pull request или merge request через команду shell или инструмент MCP.625Увеличивается, когда Claude Code создаёт запрос на слияние или запрос на объединение через команду оболочки или инструмент MCP.

626 626 

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

628 628 

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

630 630 

631<h4 id="commit-counter">631<h4 id="commit-counter">

632 Счетчик коммитов632 Счётчик коммитов

633</h4>633</h4>

634 634 

635Увеличивается при создании git коммитов через Claude Code.635Увеличивается при создании коммитов git через Claude Code.

636 636 

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

638 638 

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

640 640 

641<h4 id="cost-counter">641<h4 id="cost-counter">

642 Счетчик затрат642 Счётчик стоимости

643</h4>643</h4>

644 644 

645Увеличивается после каждого запроса API.645Увеличивается после каждого запроса API.


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

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

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

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

653* `effort`: [Уровень усилий](/docs/ru/model-config#adjust-effort-level), применяемый к запросу: `"low"`, `"medium"`, `"high"`, `"xhigh"` или `"max"`. Отсутствует, когда модель не поддерживает усилия.653* `effort`: [Уровень усилий](/docs/ru/model-config#adjust-effort-level), применённый к запросу: `"low"`, `"medium"`, `"high"`, `"xhigh"` или `"max"`. Отсутствует, когда Claude Code не отправляет уровень усилий, например на модели, которая не поддерживает усилия.

654* `agent.name`: Тип подагента, который выдал запрос. Встроенные имена агентов и агенты из официальных плагинов маркетплейса появляются как есть. Другие определяемые пользователем имена агентов заменяются на `"custom"`. Отсутствует, когда запрос не был выдан именованным типом подагента.654* `agent.name`: Тип подагента, который выдал запрос. Встроенные имена агентов и агенты из официальных плагинов маркетплейса отображаются как есть. Другие определённые пользователем имена агентов заменяются на `"custom"`. Отсутствует, когда запрос не был выдан именованным типом подагента.

655* `skill.name`: Навык, активный для запроса, установленный инструментом Skill, командой `/` или унаследованный порожденным подагентом. Встроенные, поставляемые, определяемые пользователем и навыки плагинов официального маркетплейса появляются как есть. Навыки плагинов третьих сторон заменяются на `"third-party"`. Отсутствует, когда нет активного навыка.655* `skill.name`: Навык, активный для запроса, установленный инструментом Skill, командой `/` или унаследованный порождённым подагентом. Встроенные, связанные, определённые пользователем и имена навыков плагинов официального маркетплейса отображаются как есть. Имена навыков плагинов третьих сторон заменяются на `"third-party"`. Отсутствует, когда нет активного навыка.

656* `plugin.name`: Владельцы плагина, когда активный навык или подагент предоставляются плагином. Имена плагинов официального маркетплейса появляются как есть. Имена плагинов третьих сторон заменяются на `"third-party"`. Отсутствует, когда ни навык, ни подагент не имеют владельца плагина.656* `plugin.name`: Владеющий плагин, когда активный навык или подагент предоставляется плагином. Имена плагинов официального маркетплейса отображаются как есть. Имена плагинов третьих сторон заменяются на `"third-party"`. Отсутствует, когда ни навык, ни подагент не имеют владеющего плагина.

657* `marketplace.name`: Маркетплейс, из которого был установлен владельцы плагин. Выдается только для плагинов официального маркетплейса. Отсутствует в противном случае.657* `marketplace.name`: Маркетплейс, из которого был установлен владеющий плагин. Выпускается только для плагинов официального маркетплейса. Отсутствует в противном случае.

658* `mcp_server.name`: MCP сервер, чей результат инструмента этот запрос потребил. Встроенные, claude.ai-проксированные и официальные имена серверов реестра появляются как есть. Пользовательские имена серверов заменяются на `"custom"`. Отсутствует, когда запрос не потребил результат инструмента MCP. До v2.1.222 Claude Code устанавливал этот атрибут на каждый запрос после вызова инструмента MCP, а не только на запросы, которые потребили результат инструмента, поэтому панели управления, которые его агрегируют, показывают снижение после обновления.658* `mcp_server.name`: Сервер MCP, результат инструмента которого этот запрос потребил. Встроенные, проксируемые claude.ai и имена серверов официального реестра отображаются как есть. Имена серверов, настроенные пользователем, заменяются на `"custom"`. Отсутствует, когда запрос не потребил результат инструмента MCP. До v2.1.222 Claude Code устанавливал этот атрибут на каждый запрос после вызова инструмента MCP, а не только на запросы, которые потребили результат инструмента, поэтому панели управления, которые его агрегируют, показывают снижение после обновления.

659* `mcp_tool.name`: Инструмент MCP, чей результат этот запрос потребил, с тем же редактированием и поведением версии, что и `mcp_server.name`. Отсутствует, когда запрос не потребил результат инструмента MCP.659* `mcp_tool.name`: Инструмент MCP, результат которого этот запрос потребил, с тем же редактированием и поведением версии, что и `mcp_server.name`. Отсутствует, когда запрос не потребил результат инструмента MCP.

660 660 

661<h4 id="token-counter">661<h4 id="token-counter">

662 Счетчик токенов662 Счётчик токенов

663</h4>663</h4>

664 664 

665Увеличивается после каждого запроса API.665Увеличивается после каждого запроса API.


670* `type`: (`"input"`, `"output"`, `"cacheRead"`, `"cacheCreation"`)670* `type`: (`"input"`, `"output"`, `"cacheRead"`, `"cacheCreation"`)

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

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

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

674* `effort`: [Уровень усилий](/docs/ru/model-config#adjust-effort-level), применяемый к запросу. Подробности см. в разделе [Счетчик затрат](#cost-counter).674* `effort`: [Уровень усилий](/docs/ru/model-config#adjust-effort-level), применённый к запросу. См. [Счётчик стоимости](#cost-counter) для деталей.

675* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Атрибуция навыка, плагина, агента и MCP для запроса. Определения и поведение редактирования см. в разделе [Счетчик затрат](#cost-counter).675* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Атрибуция навыка, плагина, агента и MCP для запроса. См. [Счётчик стоимости](#cost-counter) для определений и поведения редактирования.

676 676 

677<h4 id="code-edit-tool-decision-counter">677<h4 id="code-edit-tool-decision-counter">

678 Счетчик решений инструмента редактирования кода678 Счётчик решений инструмента редактирования кода

679</h4>679</h4>

680 680 

681Увеличивается, когда пользователь принимает или отклоняет использование инструмента Edit, Write или NotebookEdit.681Увеличивается, когда пользователь принимает или отклоняет использование инструмента Edit, Write или NotebookEdit.


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

686* `tool_name`: Имя инструмента (`"Edit"`, `"Write"`, `"NotebookEdit"`)686* `tool_name`: Имя инструмента (`"Edit"`, `"Write"`, `"NotebookEdit"`)

687* `decision`: Решение пользователя (`"accept"`, `"reject"`)687* `decision`: Решение пользователя (`"accept"`, `"reject"`)

688* `source`: Источник решения. Один из `"config"`, `"hook"`, `"user_permanent"`, `"user_temporary"`, `"user_abort"` или `"user_reject"`. См. [Событие решения инструмента](#tool-decision-event) для получения информации о том, что означает каждое значение.688* `source`: Откуда пришло решение. Один из `"config"`, `"hook"`, `"user_permanent"`, `"user_temporary"`, `"user_abort"` или `"user_reject"`. См. [Событие решения инструмента](#tool-decision-event) для того, что означает каждое значение.

689* `language`: Язык программирования отредактированного файла, такой как `"TypeScript"`, `"Python"`, `"JavaScript"` или `"Markdown"`. Возвращает `"unknown"` для неузнанных расширений файлов.689* `language`: Язык программирования отредактированного файла, например `"TypeScript"`, `"Python"`, `"JavaScript"` или `"Markdown"`. Возвращает `"unknown"` для неизвестных расширений файлов.

690 690 

691<h4 id="active-time-counter">691<h4 id="active-time-counter">

692 Счетчик активного времени692 Счётчик активного времени

693</h4>693</h4>

694 694 

695Отслеживает фактическое время, потраченное на активное использование Claude Code, исключая время простоя. Эта метрика увеличивается во время взаимодействия пользователя, такого как ввод текста и чтение ответов, и во время обработки CLI, такой как выполнение инструментов и генерация ответов AI.695Отслеживает фактическое время активного использования Claude Code, исключая время простоя. Эта метрика увеличивается во время взаимодействия пользователя, такого как ввод текста и чтение ответов, и во время обработки CLI, такой как выполнение инструментов и генерация ответов AI.

696 696 

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

698 698 


709 Атрибуты корреляции событий709 Атрибуты корреляции событий

710</h4>710</h4>

711 711 

712Когда пользователь отправляет подсказку, Claude Code может сделать несколько вызовов API и запустить несколько инструментов. Атрибут `prompt.id` позволяет связать все эти события с одной подсказкой, которая их вызвала.712Когда пользователь отправляет запрос, Claude Code может сделать несколько вызовов API и запустить несколько инструментов. Атрибут `prompt.id` позволяет вам связать все эти события с единственным запросом, который их вызвал.

713 713 

714| Атрибут | Описание |714| Атрибут | Описание |

715| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |715| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

716| `prompt.id` | Идентификатор UUID v4, связывающий все события, созданные при обработке одной пользовательской подсказки |716| `prompt.id` | Идентификатор UUID v4, связывающий все события, созданные при обработке одного пользовательского запроса |

717| `event.sequence` | Счетчик на основе 0 для упорядочивания событий, подсчитываемый для каждого процесса Claude Code, а не для каждого сеанса |717| `event.sequence` | Счётчик на основе 0 для упорядочивания событий, подсчитанный на процесс Claude Code, а не на сеанс |

718| `message.uuid` | UUID сообщения, как сохраненного в транскрипте сеанса, файлы `~/.claude/projects/*/*.jsonl`. Присутствует на `assistant_response`, на `api_response_body` и на `user_prompt`, кроме отправок команд, которые могут создавать ноль или много сообщений. На `assistant_response` и `api_response_body` это финальная запись транскрипта ответа, от которой цепляется `parentUuid` следующего хода. Требует Claude Code v2.1.214 или позже, или v2.1.274 или позже на `api_response_body` |718| `message.uuid` | UUID сообщения, как сохранено в стенограмме сеанса, файлы `~/.claude/projects/*/*.jsonl`. Присутствует на `assistant_response`, на `api_response_body` и на `user_prompt`, кроме отправок команд, которые могут создавать ноль или много сообщений. На `assistant_response` и `api_response_body` это последняя запись стенограммы ответа, от которой цепочка `parentUuid` следующего хода. Требуется Claude Code v2.1.214 или позже, или v2.1.274 или позже на `api_response_body` |

719| `client_request_id` | UUID, созданный клиентом, отправленный как заголовок запроса `x-client-request-id`. Присутствует на `api_request` и `api_error` на подключениях API первой стороны; отсутствует на бэкендах поставщиков третьих сторон и когда запрос был повторен через резервный вариант без потоковой передачи. Связывает запрос с его ответом и остается доступным для сбоев, таких как тайм-ауты, которые никогда не создали `request_id` сервера. Совпадает с тем же атрибутом на span трассировки `llm_request`. Требует Claude Code v2.1.214 или позже |719| `client_request_id` | UUID, созданный клиентом, отправленный как заголовок запроса `x-client-request-id`. Присутствует на `api_request` и `api_error` на подключениях API первой стороны; отсутствует на бэкендах поставщиков третьих сторон и когда запрос был повторён через резервный вариант без потоковой передачи. Связывает запрос с его ответом и остаётся доступным для сбоев, таких как тайм-ауты, которые никогда не создали `request_id` сервера. Совпадает с тем же атрибутом на диапазоне трассировки `llm_request`. Требуется Claude Code v2.1.214 или позже |

720 720 

721Чтобы отследить всю активность, вызванную одной подсказкой, отфильтруйте события по определенному значению `prompt.id`. Это возвращает событие user\_prompt, любые события api\_request и любые события tool\_result, которые произошли при обработке этой подсказки.721Чтобы отследить всю деятельность, вызванную одним запросом, отфильтруйте события по определённому значению `prompt.id`. Это возвращает событие user\_prompt, любые события api\_request и любые события tool\_result, которые произошли при обработке этого запроса.

722 722 

723`event.sequence` начинается с 0 каждый раз, когда процесс Claude Code запускается, и считает вверх на протяжении всей жизни этого процесса. Он продолжает считать через `/clear`, который назначает новый `session.id`. Если вы [возобновите сеанс без разветвления](/docs/ru/how-claude-code-works#resume-or-fork-sessions), сеанс сохраняет свой `session.id`, но берет свои значения `event.sequence` из процесса, который его возобновил, поэтому в одном сеансе более позднее событие может нести более низкое значение, чем более раннее, или повторить одно. Чтобы упорядочить события сеанса, отсортируйте по `event.timestamp` и используйте `event.sequence` для упорядочивания событий, которые имеют одну и ту же временную метку.723`event.sequence` начинается с 0 каждый раз, когда процесс Claude Code запускается, и считает вверх в течение жизни этого процесса. Он продолжает считать через `/clear`, который назначает новый `session.id`. Если вы [возобновляете сеанс без ветвления](/docs/ru/how-claude-code-works#resume-or-fork-sessions), сеанс сохраняет свой `session.id`, но берёт свои значения `event.sequence` из процесса, который его возобновил, поэтому в одном сеансе более позднее событие может нести более низкое значение, чем более раннее, или повторить одно. Чтобы упорядочить события сеанса, отсортируйте по `event.timestamp` и используйте `event.sequence` для упорядочивания событий, которые имеют одну и ту же временную метку.

724 724 

725Для восстановления на уровне сообщений каждый класс событий содержит ключ, который совпадает с полем в транскрипте сеанса. Формат записи транскрипта [внутренний для Claude Code](/docs/ru/sessions#where-transcripts-are-stored) и изменяется между версиями, поэтому конвейер, который объединяет эти поля, может сломаться при любом выпуске; рассматривайте объединения как специфичные для версии, а не как стабильный контракт:725Для восстановления на уровне сообщений каждый класс событий содержит ключ, который совпадает с полем в стенограмме сеанса. Формат записи стенограммы [внутренний для Claude Code](/docs/ru/sessions#where-transcripts-are-stored) и изменяется между версиями, поэтому конвейер, который объединяет эти поля, может сломаться при любом выпуске; рассматривайте объединения как специфичные для версии, а не как стабильный контракт:

726 726 

727* `message.uuid` на `user_prompt`, `assistant_response` и `api_response_body`727* `message.uuid` на `user_prompt`, `assistant_response` и `api_response_body`

728* `request_id` на событиях API, сохраненный как `requestId` на записях помощника транскрипта728* `request_id` на событиях API, сохранённых как `requestId` на записях помощника стенограммы

729* `tool_use_id` на событиях `tool_result` и `tool_decision`729* `tool_use_id` на событиях `tool_result` и `tool_decision`

730 730 

731<h4 id="user-prompt-event">731<h4 id="user-prompt-event">

732 Событие пользовательской подсказки732 Событие пользовательского запроса

733</h4>733</h4>

734 734 

735Логируется, когда пользователь отправляет подсказку.735Регистрируется, когда пользователь отправляет запрос.

736 736 

737**Имя события**: `claude_code.user_prompt`737**Имя события**: `claude_code.user_prompt`

738 738 


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

742* `event.name`: `"user_prompt"`742* `event.name`: `"user_prompt"`

743* `event.timestamp`: Временная метка ISO 8601743* `event.timestamp`: Временная метка ISO 8601

744* `event.sequence`: счетчик для каждого процесса для упорядочивания событий, описанный в разделе [Атрибуты корреляции событий](#event-correlation-attributes)744* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

745* `prompt_length`: Длина подсказки745* `prompt_length`: Длина запроса

746* `prompt`: Содержимое подсказки. Скрыто по умолчанию. Установите `OTEL_LOG_USER_PROMPTS=1` для включения746* `prompt`: Содержание запроса. Редактируется по умолчанию. Установите `OTEL_LOG_USER_PROMPTS=1`, чтобы включить его

747* `message.uuid`: UUID результирующего пользовательского сообщения, совпадающий с сохраненной записью транскрипта. Отсутствует при отправках команд, которые могут создавать ноль или много сообщений. Требует Claude Code v2.1.214 или позже747* `message.uuid`: UUID результирующего пользовательского сообщения, совпадающий с сохранённой записью стенограммы. Отсутствует при отправке команд, которые могут создавать ноль или много сообщений. Требуется Claude Code v2.1.214 или позже

748* `command_name`: Имя команды, когда подсказка вызывает одну. Встроенные и поставляемые имена команд, такие как `compact` или `debug`, выдаются как есть; псевдонимы, такие как `reset`, выдаются как введено, а не как каноническое имя. Пользовательские, плагин и MCP имена команд сворачиваются в `custom` или `mcp`, если не установлен `OTEL_LOG_TOOL_DETAILS=1`748* `command_name`: Имя команды, когда запрос вызывает одну. Встроенные и связанные имена команд, такие как `compact` или `debug`, выпускаются как есть; псевдонимы, такие как `reset`, выпускаются как введено, а не как каноническое имя. Пользовательские, плагины и имена команд MCP сворачиваются в `custom` или `mcp`, если не установлено `OTEL_LOG_TOOL_DETAILS=1`

749* `command_source`: Происхождение команды, когда присутствует: `builtin`, `custom` или `mcp`. Команды, предоставляемые плагинами, сообщают как `custom`749* `command_source`: Происхождение команды, когда присутствует: `builtin`, `custom` или `mcp`. Команды, предоставленные плагинами, сообщаются как `custom`

750 750 

751<h4 id="assistant-response-event">751<h4 id="assistant-response-event">

752 Событие результата помощника752 Событие ответа помощника

753</h4>753</h4>

754 754 

755Логируется после каждого запроса API, который возвращает текстовое содержимое от модели. Включены только текстовые блоки ответа; блоки мышления и блоки использования инструментов исключены. Требует Claude Code v2.1.193 или позже.755Регистрируется после каждого запроса API, который возвращает текстовое содержание от модели. Включены только текстовые блоки ответа; блоки мышления и блоки использования инструментов исключены. Требуется Claude Code v2.1.193 или позже.

756 756 

757**Имя события**: `claude_code.assistant_response`757**Имя события**: `claude_code.assistant_response`

758 758 


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

762* `event.name`: `"assistant_response"`762* `event.name`: `"assistant_response"`

763* `event.timestamp`: Временная метка ISO 8601763* `event.timestamp`: Временная метка ISO 8601

764* `event.sequence`: счетчик для каждого процесса для упорядочивания событий, описанный в разделе [Атрибуты корреляции событий](#event-correlation-attributes)764* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

765* `response_length`: Длина текста ответа в символах765* `response_length`: Длина текста ответа в символах

766* `response`: Текст ответа, усеченный на лимит содержимого (60 КБ по умолчанию). Скрыт как `<REDACTED>` по умолчанию. Установите `OTEL_LOG_ASSISTANT_RESPONSES=1` для включения. Когда `OTEL_LOG_ASSISTANT_RESPONSES` не установлен, `OTEL_LOG_USER_PROMPTS` контролирует его вместо этого, поэтому установите `OTEL_LOG_ASSISTANT_RESPONSES=0`, чтобы сохранить ответы скрытыми, пока логирование подсказок включено766* `response`: Текст ответа, усечённый на пределе содержания (60 КБ по умолчанию). Редактируется в `<REDACTED>` по умолчанию. Установите `OTEL_LOG_ASSISTANT_RESPONSES=1`, чтобы включить его. Когда `OTEL_LOG_ASSISTANT_RESPONSES` не установлен, `OTEL_LOG_USER_PROMPTS` контролирует его вместо этого, поэтому установите `OTEL_LOG_ASSISTANT_RESPONSES=0`, чтобы сохранить ответы редактируемыми, пока логирование запроса включено

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

768* `request_id`: ID запроса Anthropic API из заголовка ответа `request-id`. Присутствует только, когда API возвращает его768* `request_id`: ID запроса API Anthropic из заголовка ответа `request-id`. Присутствует только, когда API возвращает один

769* `message.uuid`: UUID финальной записи транскрипта ответа. Ответ API сохраняется как одна запись транскрипта на блок содержимого; это последняя, от которой цепляется `parentUuid` следующего хода. Требует Claude Code v2.1.214 или позже769* `message.uuid`: UUID последней записи стенограммы ответа. Ответ API сохраняется как одна запись стенограммы на блок содержания; это последний, от которого цепочка `parentUuid` следующего хода. Требуется Claude Code v2.1.214 или позже

770* `query_source`: Подсистема, которая выдала запрос, такая как `"repl_main_thread"`, `"compact"` или имя подагента770* `query_source`: Подсистема, которая выдала запрос, например `"repl_main_thread"`, `"compact"` или имя подагента

771 771 

772<h4 id="tool-result-event">772<h4 id="tool-result-event">

773 Событие результата инструмента773 Событие результата инструмента

774</h4>774</h4>

775 775 

776Логируется, когда инструмент завершает выполнение. Не выдается, если вызов инструмента был отклонен; см. [Событие решения инструмента](#tool-decision-event) для отклонений.776Регистрируется, когда инструмент завершает выполнение. Не выпускается, если вызов инструмента был отклонён; см. [Событие решения инструмента](#tool-decision-event) для отклонений.

777 777 

778**Имя события**: `claude_code.tool_result`778**Имя события**: `claude_code.tool_result`

779 779 


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

783* `event.name`: `"tool_result"`783* `event.name`: `"tool_result"`

784* `event.timestamp`: Временная метка ISO 8601784* `event.timestamp`: Временная метка ISO 8601

785* `event.sequence`: счетчик для каждого процесса для упорядочивания событий, описанный в разделе [Атрибуты корреляции событий](#event-correlation-attributes)785* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

786* `tool_name`: Имя инструмента786* `tool_name`: Имя инструмента

787* `tool_use_id`: Уникальный идентификатор для этого вызова инструмента. Совпадает с `tool_use_id`, переданным в hooks, позволяя корреляцию между событиями OTel и данными, захваченными hooks.787* `tool_use_id`: Уникальный идентификатор для этого вызова инструмента. Совпадает с `tool_use_id`, переданным в hooks, позволяя корреляцию между событиями OTel и данными, захваченными hooks.

788* `success`: `"true"` или `"false"`788* `success`: `"true"` или `"false"`

789* `duration_ms`: Время выполнения в миллисекундах789* `duration_ms`: Время выполнения в миллисекундах

790* `error_type`: Строка категории ошибки при сбое инструмента, такая как `"Error:ENOENT"` или `"ShellError"`790* `error_type`: Строка категории ошибки, когда инструмент не удался, например `"Error:ENOENT"` или `"ShellError"`

791* `error` (когда `OTEL_LOG_TOOL_DETAILS=1`): Полное сообщение об ошибке при сбое инструмента791* `error` (когда `OTEL_LOG_TOOL_DETAILS=1`): Полное сообщение об ошибке, когда инструмент не удался

792* `decision_type`: Всегда `"accept"`, так как это событие выдается только после запуска инструмента. Отклоненные вызовы не производят результат инструмента792* `decision_type`: Всегда `"accept"`, так как это событие выпускается только после запуска инструмента. Отклонённые вызовы не создают результат инструмента

793* `decision_source`: Источник решения о разрешении. Один из `"config"`, `"hook"`, `"user_permanent"` или `"user_temporary"`. См. [Событие решения инструмента](#tool-decision-event) для получения информации о том, что означает каждое значение. Источники, только для отклонения, `"user_abort"` и `"user_reject"`, никогда не появляются на этом событии.793* `decision_source`: Откуда пришло решение о разрешении. Один из `"config"`, `"hook"`, `"user_permanent"` или `"user_temporary"`. См. [Событие решения инструмента](#tool-decision-event) для того, что означает каждое значение. Источники, специфичные для отклонения, `"user_abort"` и `"user_reject"`, никогда не появляются на этом событии.

794* `tool_input_size_bytes`: Размер JSON-сериализованного входа инструмента в байтах794* `tool_input_size_bytes`: Размер сериализованного JSON входа инструмента в байтах

795* `tool_result_size_bytes`: Размер результата инструмента в байтах795* `tool_result_size_bytes`: Размер результата инструмента в байтах

796* `mcp_server_scope`: Идентификатор области MCP сервера (для инструментов MCP)796* `mcp_server_scope`: Идентификатор области сервера MCP (для инструментов MCP)

797* `vcs.ref.head.revision`, `vcs.ref.head.name`, `vcs.ref.head.type` (когда `OTEL_LOG_TOOL_DETAILS=1`): идентичность коммита успешного запуска `git commit` инструментом Bash или PowerShell. `vcs.ref.head.revision` это SHA коммита, `vcs.ref.head.name` это ветка, на которую был совершен коммит, и `vcs.ref.head.type` это `branch`. Имя и тип опущены, когда коммит был сделан на отсоединенном HEAD. Требует Claude Code v2.1.269 или позже797* `vcs.ref.head.revision`, `vcs.ref.head.name`, `vcs.ref.head.type` (когда `OTEL_LOG_TOOL_DETAILS=1`): идентификация коммита успешного запуска `git commit` инструментом Bash или PowerShell. `vcs.ref.head.revision` — это SHA коммита, `vcs.ref.head.name` — это ветка, на которую он был закоммичен, и `vcs.ref.head.type` — это `branch`. Имя и тип опускаются, когда коммит был сделан на отсоединённой HEAD. Требуется Claude Code v2.1.269 или позже

798* `tool_parameters` (когда `OTEL_LOG_TOOL_DETAILS=1`): JSON строка, содержащая параметры, специфичные для инструмента. Для встроенных серверов Claude Desktop в сеансах, которыми владеет Claude Desktop, пара `mcp_server_name`/`mcp_tool_name` включается даже без флага, то же исключение, авторизованное хостом, что и [Событие решения инструмента](#tool-decision-event), требующее Claude Code v2.1.214 или позже. Параметры варьируются по инструменту:798* `tool_parameters` (когда `OTEL_LOG_TOOL_DETAILS=1`): Строка JSON, содержащая параметры, специфичные для инструмента. Для встроенных серверов Claude Desktop в сеансах, которыми владеет Claude Desktop, пара `mcp_server_name`/`mcp_tool_name` включается даже с отключённым флагом, то же исключение, созданное хостом, что и [Событие решения инструмента](#tool-decision-event), требующее Claude Code v2.1.214 или позже. Параметры варьируются по инструменту:

799 * Для инструмента Bash: включает `bash_command`, `full_command`, `timeout`, `description`, `dangerouslyDisableSandbox`, плюс `git_commit_id` и `git_branch`, когда команда `git commit` успешна. `git_commit_id` это полный SHA коммита, когда коммит это HEAD рабочего каталога сеанса, и сокращенный SHA git в противном случае. `git_branch` это ветка, на которую был совершен коммит, опущена на отсоединенном HEAD799 * Для инструмента Bash: включает `bash_command`, `full_command`, `timeout`, `description` и `dangerouslyDisableSandbox`, плюс `git_commit_id` и `git_branch`, когда команда `git commit` успешна. `git_commit_id` — это полный SHA коммита, когда коммит является HEAD рабочего каталога сеанса, и сокращённый SHA git в противном случае. `git_branch` — это ветка, на которую он был закоммичен, опускается на отсоединённой HEAD

800 * Для инструмента bash рабочей области приложения для рабочего стола, который также сообщает `tool_name` как `Bash`: включает только `bash_command`, `full_command` и `timeout`800 * Для инструмента рабочей области приложения для рабочего стола, который также сообщает `tool_name` как `Bash`: включает только `bash_command`, `full_command` и `timeout`

801 * Для инструментов MCP: включает `mcp_server_name`, `mcp_tool_name`801 * Для инструментов MCP: включает `mcp_server_name`, `mcp_tool_name`

802 * Для инструмента Skill: включает `skill_name`802 * Для инструмента Skill: включает `skill_name`

803 * Для инструмента Agent или устаревшего инструмента Task: включает `subagent_type`803 * Для инструмента Agent или устаревшего инструмента Task: включает `subagent_type`

804* `tool_input` (когда `OTEL_LOG_TOOL_DETAILS=1`): JSON-сериализованные аргументы инструмента. Отдельные значения более 512 символов усекаются, и полная нагрузка ограничена примерно 4 K символами. Применяется ко всем инструментам, включая инструменты MCP.804* `tool_input` (когда `OTEL_LOG_TOOL_DETAILS=1`): Сериализованные JSON аргументы инструмента. Отдельные значения свыше 512 символов усекаются, и полная нагрузка ограничена примерно 4 К символами. Применяется ко всем инструментам, включая инструменты MCP.

805 805 

806<h4 id="api-request-event">806<h4 id="api-request-event">

807 Событие запроса API807 Событие запроса API

808</h4>808</h4>

809 809 

810Логируется для каждого запроса API к Claude.810Регистрируется для каждого запроса API к Claude.

811 811 

812**Имя события**: `claude_code.api_request`812**Имя события**: `claude_code.api_request`

813 813 


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

817* `event.name`: `"api_request"`817* `event.name`: `"api_request"`

818* `event.timestamp`: Временная метка ISO 8601818* `event.timestamp`: Временная метка ISO 8601

819* `event.sequence`: счетчик для каждого процесса для упорядочивания событий, описанный в разделе [Атрибуты корреляции событий](#event-correlation-attributes)819* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

820* `model`: Используемая модель (например, "claude-sonnet-5")820* `model`: Используемая модель (например, "claude-sonnet-5")

821* `cost_usd`: Приблизительная стоимость в USD821* `cost_usd`: Предполагаемая стоимость в USD

822* `cost_usd_micros`: Приблизительная стоимость в миллионных долях доллара США, выданная как целое число822* `cost_usd_micros`: Предполагаемая стоимость в миллионных долях доллара США, выпущенная как целое число

823* `duration_ms`: Длительность запроса в миллисекундах823* `duration_ms`: Длительность запроса в миллисекундах

824* `input_tokens`: Количество входных токенов824* `input_tokens`: Количество входных токенов

825* `output_tokens`: Количество выходных токенов825* `output_tokens`: Количество выходных токенов

826* `cache_read_tokens`: Количество токенов, прочитанных из кэша826* `cache_read_tokens`: Количество токенов, прочитанных из кэша

827* `cache_creation_tokens`: Количество токенов, использованных для создания кэша827* `cache_creation_tokens`: Количество токенов, использованных для создания кэша

828* `request_id`: ID запроса Anthropic API из заголовка ответа `request-id`, такой как `"req_011..."`. Присутствует только, когда API возвращает его.828* `request_id`: ID запроса API Anthropic из заголовка ответа `request-id`, например `"req_011..."`. Присутствует только, когда API возвращает один.

829* `client_request_id`: UUID, созданный клиентом, отправленный как заголовок запроса `x-client-request-id`; см. таблицу [атрибутов корреляции событий](#event-correlation-attributes) для того, когда он присутствует. Требует Claude Code v2.1.214 или позже829* `client_request_id`: UUID, созданный клиентом, отправленный как заголовок запроса `x-client-request-id`; см. таблицу [атрибуты корреляции событий](#event-correlation-attributes) для того, когда он присутствует. Требуется Claude Code v2.1.214 или позже

830* `speed`: `"fast"` или `"normal"`, указывающий, был ли активен быстрый режим830* `speed`: `"fast"` или `"normal"`, указывающий, был ли активен быстрый режим

831* `query_source`: Подсистема, которая выдала запрос, такая как `"repl_main_thread"`, `"compact"` или имя подагента831* `query_source`: Подсистема, которая выдала запрос, например `"repl_main_thread"`, `"compact"` или имя подагента

832* `effort`: [Уровень усилий](/docs/ru/model-config#adjust-effort-level), применяемый к запросу: `"low"`, `"medium"`, `"high"`, `"xhigh"` или `"max"`. Отсутствует, когда модель не поддерживает усилия.832* `effort`: [Уровень усилий](/docs/ru/model-config#adjust-effort-level), применённый к запросу: `"low"`, `"medium"`, `"high"`, `"xhigh"` или `"max"`. Отсутствует, когда Claude Code не отправляет уровень усилий, например на модели, которая не поддерживает усилия.

833* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Атрибуция навыка, плагина, агента и MCP для запроса. Определения и поведение редактирования см. в разделе [Счетчик затрат](#cost-counter).833* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Атрибуция навыка, плагина, агента и MCP для запроса. См. [Счётчик стоимости](#cost-counter) для определений и поведения редактирования.

834 834 

835<h4 id="api-error-event">835<h4 id="api-error-event">

836 Событие ошибки API836 Событие ошибки API

837</h4>837</h4>

838 838 

839Логируется, когда запрос API к Claude не удается.839Регистрируется, когда запрос API к Claude не удаётся.

840 840 

841**Имя события**: `claude_code.api_error`841**Имя события**: `claude_code.api_error`

842 842 


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

846* `event.name`: `"api_error"`846* `event.name`: `"api_error"`

847* `event.timestamp`: Временная метка ISO 8601847* `event.timestamp`: Временная метка ISO 8601

848* `event.sequence`: счетчик для каждого процесса для упорядочивания событий, описанный в разделе [Атрибуты корреляции событий](#event-correlation-attributes)848* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

849* `model`: Используемая модель (например, "claude-sonnet-5")849* `model`: Используемая модель (например, "claude-sonnet-5")

850* `error`: Сообщение об ошибке850* `error`: Сообщение об ошибке

851* `status_code`: HTTP код состояния в виде числа. Отсутствует для ошибок, не связанных с HTTP, таких как сбои соединения.851* `status_code`: Код состояния HTTP как число. Отсутствует для ошибок, не связанных с HTTP, таких как сбои соединения.

852* `duration_ms`: Длительность запроса в миллисекундах852* `duration_ms`: Длительность запроса в миллисекундах

853* `attempt`: Общее количество попыток, включая исходный запрос (`1` означает, что повторных попыток не было)853* `attempt`: Общее количество попыток, включая исходный запрос (`1` означает, что повторных попыток не было)

854* `request_id`: ID запроса Anthropic API из заголовка ответа `request-id`, такой как `"req_011..."`. Присутствует только, когда API возвращает его.854* `request_id`: ID запроса API Anthropic из заголовка ответа `request-id`, например `"req_011..."`. Присутствует только, когда API возвращает один.

855* `client_request_id`: UUID, созданный клиентом, отправленный как заголовок запроса `x-client-request-id`. Доступен даже при сбое, таком как тайм-аут или ошибка соединения, которые никогда не создали `request_id` сервера; см. таблицу [атрибутов корреляции событий](#event-correlation-attributes) для того, когда он присутствует. Требует Claude Code v2.1.214 или позже855* `client_request_id`: UUID, созданный клиентом, отправленный как заголовок запроса `x-client-request-id`. Доступен даже при сбое, таком как тайм-аут или ошибка соединения, которые никогда не создали `request_id` сервера; см. таблицу [атрибуты корреляции событий](#event-correlation-attributes) для того, когда он присутствует. Требуется Claude Code v2.1.214 или позже

856* `speed`: `"fast"` или `"normal"`, указывающий, был ли активен быстрый режим856* `speed`: `"fast"` или `"normal"`, указывающий, был ли активен быстрый режим

857* `query_source`: Подсистема, которая выдала запрос, такая как `"repl_main_thread"`, `"compact"` или имя подагента857* `query_source`: Подсистема, которая выдала запрос, например `"repl_main_thread"`, `"compact"` или имя подагента

858* `effort`: [Уровень усилий](/docs/ru/model-config#adjust-effort-level), применяемый к запросу. Отсутствует, когда модель не поддерживает усилия.858* `effort`: [Уровень усилий](/docs/ru/model-config#adjust-effort-level), применённый к запросу. Отсутствует, когда Claude Code не отправляет уровень усилий, например на модели, которая не поддерживает усилия.

859* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Атрибуция навыка, плагина, агента и MCP для запроса. Определения и поведение редактирования см. в разделе [Счетчик затрат](#cost-counter).859* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Атрибуция навыка, плагина, агента и MCP для запроса. См. [Счётчик стоимости](#cost-counter) для определений и поведения редактирования.

860 860 

861<h4 id="api-refusal-event">861<h4 id="api-refusal-event">

862 Событие отказа API862 Событие отказа API

863</h4>863</h4>

864 864 

865Логируется, когда запрос API возвращает `stop_reason: "refusal"`. Отказы поступают в успешном потоке ответов, а не как ошибка HTTP, поэтому событие `api_error` не срабатывает для них. Это событие позволяет отслеживать частоту отказов и группировать отказы по тем же атрибутам, что и `api_request` и `api_error`.865Регистрируется, когда запрос API возвращает `stop_reason: "refusal"`. Отказы поступают на успешный поток ответов, а не как ошибка HTTP, поэтому событие `api_error` не срабатывает для них. Это событие позволяет вам отслеживать частоту отказов и группировать отказы по тем же атрибутам, что и `api_request` и `api_error`.

866 866 

867**Имя события**: `claude_code.api_refusal`867**Имя события**: `claude_code.api_refusal`

868 868 


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

872* `event.name`: `"api_refusal"`872* `event.name`: `"api_refusal"`

873* `event.timestamp`: Временная метка ISO 8601873* `event.timestamp`: Временная метка ISO 8601

874* `event.sequence`: счетчик для каждого процесса для упорядочивания событий, описанный в разделе [Атрибуты корреляции событий](#event-correlation-attributes)874* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

875* `model`: Идентификатор модели из запроса875* `model`: Идентификатор модели из запроса

876* `request_id`: ID запроса Anthropic API из заголовка ответа `request-id`, такой как `"req_011..."`. Присутствует только, когда API возвращает его.876* `request_id`: ID запроса API Anthropic из заголовка ответа `request-id`, например `"req_011..."`. Присутствует только, когда API возвращает один.

877* `query_source`: Подсистема, которая выдала запрос, такая как `"repl_main_thread"`, `"compact"` или имя подагента. Определения см. в разделе [`api_request`](#api-request-event).877* `query_source`: Подсистема, которая выдала запрос, например `"repl_main_thread"`, `"compact"` или имя подагента. См. [`api_request`](#api-request-event) для определений.

878* `speed`: Либо `"fast"` когда активен [Fast mode](/docs/ru/fast-mode), либо `"normal"`878* `speed`: Либо `"fast"`, когда активен [Быстрый режим](/docs/ru/fast-mode), либо `"normal"`

879* `attempt`: Номер попытки повтора. Первая попытка это `1`.879* `attempt`: Номер попытки повтора. Первая попытка — это `1`.

880* `effort`: [Уровень усилий](/docs/ru/model-config#adjust-effort-level), применяемый к запросу. Отсутствует, когда модель не поддерживает усилия.880* `effort`: [Уровень усилий](/docs/ru/model-config#adjust-effort-level), применённый к запросу. Отсутствует, когда Claude Code не отправляет уровень усилий, например на модели, которая не поддерживает усилия.

881* `server_fallback_hop`: `true` когда резервный вариант модели на стороне сервера API уже повторил этот отказ на другой модели, поэтому пользователь не видел этот конкретный отказ. `false` когда запрос закончился отказом. Один ход может выдать как событие `true` hop, так и позже событие `false` final, когда модель резервного варианта также отказывает.881* `server_fallback_hop`: `true`, когда резервный вариант модели на стороне сервера API уже повторил этот отказ на другой модели, поэтому пользователь не видел этот конкретный отказ. `false`, когда запрос закончился отказом. Один ход может выпустить как событие `true` hop, так и более позднее событие `false` final, когда модель резервного варианта также отказывает.

882* `has_category`: `true` когда ответ API содержал `stop_details.category` из `"cyber"`, `"bio"`, `"frontier_llm"` или `"reasoning_extraction"`. `false` когда ответ не содержал категорию или значение вне этого набора. Отсутствует, когда `server_fallback_hop` это `true`, потому что hop блоки не содержат `stop_details`.882* `has_category`: `true`, когда ответ API содержал `stop_details.category` из `"cyber"`, `"bio"`, `"frontier_llm"` или `"reasoning_extraction"`. `false`, когда ответ не содержал категорию или значение вне этого набора. Отсутствует, когда `server_fallback_hop` — это `true`, потому что hop блоки не содержат `stop_details`.

883* `has_explanation`: `true` когда ответ API содержал `stop_details.explanation`, иначе `false`. Отсутствует, когда `server_fallback_hop` это `true`.883* `has_explanation`: `true`, когда ответ API содержал `stop_details.explanation`, в противном случае `false`. Отсутствует, когда `server_fallback_hop` — это `true`.

884* `category`: Значение `stop_details.category` из ответа API. Один из `"cyber"`, `"bio"`, `"frontier_llm"` или `"reasoning_extraction"`. Присутствует только, когда установлен `OTEL_LOG_TOOL_DETAILS=1` и `has_category` это `true`.884* `category`: Значение `stop_details.category` из ответа API. Один из `"cyber"`, `"bio"`, `"frontier_llm"` или `"reasoning_extraction"`. Присутствует только, когда установлено `OTEL_LOG_TOOL_DETAILS=1` и `has_category` — это `true`.

885* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Атрибуция навыка, плагина, агента и MCP для запроса. Определения и поведение редактирования см. в разделе [Счетчик затрат](#cost-counter).885* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Атрибуция навыка, плагина, агента и MCP для запроса. См. [Счётчик стоимости](#cost-counter) для определений и поведения редактирования.

886 886 

887<h4 id="api-request-body-event">887<h4 id="api-request-body-event">

888 Событие тела запроса API888 Событие тела запроса API

889</h4>889</h4>

890 890 

891Логируется для каждой попытки запроса API, когда установлен `OTEL_LOG_RAW_API_BODIES`. Одно событие выдается за попытку, поэтому повторные попытки с скорректированными параметрами каждая производят свое собственное событие.891Регистрируется для каждой попытки запроса API, когда установлено `OTEL_LOG_RAW_API_BODIES`. Одно событие выпускается на попытку, поэтому повторные попытки с отрегулированными параметрами каждая создают своё собственное событие.

892 892 

893**Имя события**: `claude_code.api_request_body`893**Имя события**: `claude_code.api_request_body`

894 894 


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

898* `event.name`: `"api_request_body"`898* `event.name`: `"api_request_body"`

899* `event.timestamp`: Временная метка ISO 8601899* `event.timestamp`: Временная метка ISO 8601

900* `event.sequence`: счетчик для каждого процесса для упорядочивания событий, описанный в разделе [Атрибуты корреляции событий](#event-correlation-attributes)900* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

901* `body`: JSON-сериализованные параметры запроса Messages API, такие как системная подсказка, сообщения и инструменты, усеченные на лимит содержимого (60 КБ по умолчанию). Содержимое расширенного мышления в предыдущих ходах помощника скрыто. Выдается только в встроенном режиме (`OTEL_LOG_RAW_API_BODIES=1`).901* `body`: Сериализованные JSON параметры запроса Messages API, такие как системный запрос, сообщения и инструменты, усечённые на пределе содержания (60 КБ по умолчанию). Содержание расширенного мышления в предыдущих ходах помощника редактируется. Выпускается только в встроенном режиме (`OTEL_LOG_RAW_API_BODIES=1`).

902* `body_ref`: Абсолютный путь к файлу `<dir>/<uuid>.request.json`, содержащему неусеченное тело. Выдается только в режиме файла (`OTEL_LOG_RAW_API_BODIES=file:<dir>`).902* `body_ref`: Абсолютный путь к файлу `<dir>/<uuid>.request.json`, содержащему неусечённое тело. Выпускается только в режиме файла (`OTEL_LOG_RAW_API_BODIES=file:<dir>`).

903* `body_length`: Длина неусеченного тела. UTF-8 байты, когда `OTEL_LOG_RAW_API_BODIES=file:<dir>`, или единицы кода UTF-16, когда `=1`903* `body_length`: Неусечённая длина тела. Байты UTF-8, когда `OTEL_LOG_RAW_API_BODIES=file:<dir>`, или единицы кода UTF-16, когда `=1`

904* `body_truncated`: `"true"` когда произошло встроенное усечение. Отсутствует в режиме файла и когда усечение не произошло.904* `body_truncated`: `"true"`, когда произошло встроенное усечение. Отсутствует в режиме файла и когда усечение не произошло.

905* `model`: Идентификатор модели из параметров запроса905* `model`: Идентификатор модели из параметров запроса

906* `query_source`: Подсистема, которая выдала запрос (например, `"compact"`)906* `query_source`: Подсистема, которая выдала запрос (например, `"compact"`)

907* `request_body_id`: UUID, который идентифицирует тело запроса этой попытки. Событие [`api_response_body`](#api-response-body-event) для попытки, которая успешна, содержит то же значение, поэтому вы можете связать ответ с точным запросом, который его создал. Требует Claude Code v2.1.274 или позже907* `request_body_id`: UUID, который идентифицирует тело запроса этой попытки. Событие [`api_response_body`](#api-response-body-event) для попытки, которая успешна, содержит то же значение, поэтому вы можете связать ответ с точным запросом, который его создал. Требуется Claude Code v2.1.274 или позже

908 908 

909<h4 id="api-response-body-event">909<h4 id="api-response-body-event">

910 Событие тела ответа API910 Событие тела ответа API

911</h4>911</h4>

912 912 

913Логируется для каждого успешного ответа API, когда установлен `OTEL_LOG_RAW_API_BODIES`.913Регистрируется для каждого успешного ответа API, когда установлено `OTEL_LOG_RAW_API_BODIES`.

914 914 

915В режиме файла (`OTEL_LOG_RAW_API_BODIES=file:<dir>`), Claude Code также добавляет одну строку JSON к `<dir>/index.jsonl` для каждого успешного ответа, с полями `timestamp`, `session_id`, `query_source`, `model`, `request_id`, `message_id`, `message_uuid`, `request_file` и `response_file`. Прочитайте его, чтобы найти файлы запроса и ответа за данным сообщением транскрипта без запроса к вашему бэкенду телеметрии. Файл индекса требует Claude Code v2.1.274 или позже.915В режиме файла (`OTEL_LOG_RAW_API_BODIES=file:<dir>`), Claude Code также добавляет одну строку JSON в `<dir>/index.jsonl` для каждого успешного ответа с полями `timestamp`, `session_id`, `query_source`, `model`, `request_id`, `message_id`, `message_uuid`, `request_file` и `response_file`. Прочитайте его, чтобы найти файлы запроса и ответа за данным сообщением стенограммы без запроса к вашему бэкенду телеметрии. Файл индекса требует Claude Code v2.1.274 или позже.

916 916 

917**Имя события**: `claude_code.api_response_body`917**Имя события**: `claude_code.api_response_body`

918 918 


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

922* `event.name`: `"api_response_body"`922* `event.name`: `"api_response_body"`

923* `event.timestamp`: Временная метка ISO 8601923* `event.timestamp`: Временная метка ISO 8601

924* `event.sequence`: счетчик для каждого процесса для упорядочивания событий, описанный в разделе [Атрибуты корреляции событий](#event-correlation-attributes)924* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

925* `body`: JSON-сериализованный ответ Messages API, включая id, блоки содержимого, использование и причину остановки, усеченный на лимит содержимого (60 КБ по умолчанию). Содержимое расширенного мышления скрыто. Выдается только в встроенном режиме (`OTEL_LOG_RAW_API_BODIES=1`).925* `body`: Сериализованный JSON ответ Messages API, включая id, блоки содержания, использование и причину остановки, усечённый на пределе содержания (60 КБ по умолчанию). Содержание расширенного мышления редактируется. Выпускается только в встроенном режиме (`OTEL_LOG_RAW_API_BODIES=1`).

926* `body_ref`: Абсолютный путь к файлу `<dir>/<request_id>.response.json`, содержащему неусеченное тело. Выдается только в режиме файла (`OTEL_LOG_RAW_API_BODIES=file:<dir>`).926* `body_ref`: Абсолютный путь к файлу `<dir>/<request_id>.response.json`, содержащему неусечённое тело. Выпускается только в режиме файла (`OTEL_LOG_RAW_API_BODIES=file:<dir>`).

927* `body_length`: Длина неусеченного тела. UTF-8 байты, когда `OTEL_LOG_RAW_API_BODIES=file:<dir>`, или единицы кода UTF-16, когда `=1`927* `body_length`: Неусечённая длина тела. Байты UTF-8, когда `OTEL_LOG_RAW_API_BODIES=file:<dir>`, или единицы кода UTF-16, когда `=1`

928* `body_truncated`: `"true"` когда произошло встроенное усечение. Отсутствует в режиме файла и когда усечение не произошло.928* `body_truncated`: `"true"`, когда произошло встроенное усечение. Отсутствует в режиме файла и когда усечение не произошло.

929* `model`: Идентификатор модели929* `model`: Идентификатор модели

930* `query_source`: Подсистема, которая выдала запрос930* `query_source`: Подсистема, которая выдала запрос

931* `request_id`: ID запроса Anthropic API из заголовка ответа `request-id`, такой как `"req_011..."`. Присутствует только, когда API возвращает его.931* `request_id`: ID запроса API Anthropic из заголовка ответа `request-id`, например `"req_011..."`. Присутствует только, когда API возвращает один.

932* `request_body_id`: `request_body_id` события [`api_request_body`](#api-request-body-event), на которое этот ответ отвечает. Требует Claude Code v2.1.274 или позже932* `request_body_id`: `request_body_id` события [`api_request_body`](#api-request-body-event), на которое этот ответ отвечает. Требуется Claude Code v2.1.274 или позже

933* `message.id`: ID сообщения, который API назначил ответу, поле `id` тела ответа. Требует Claude Code v2.1.274 или позже933* `message.id`: ID сообщения, назначенный API ответу, поле `id` тела ответа. Требуется Claude Code v2.1.274 или позже

934* `message.uuid`: UUID финальной записи транскрипта ответа. Вместе с `request_body_id` он связывает сообщение транскрипта с телами запроса и ответа позади него. Требует Claude Code v2.1.274 или позже934* `message.uuid`: UUID последней записи стенограммы ответа. Вместе с `request_body_id` он связывает сообщение стенограммы с телами запроса и ответа позади него. Требуется Claude Code v2.1.274 или позже

935 935 

936<h4 id="tool-decision-event">936<h4 id="tool-decision-event">

937 Событие решения инструмента937 Событие решения инструмента

938</h4>938</h4>

939 939 

940Логируется, когда принимается решение о разрешении инструмента (принять/отклонить).940Регистрируется, когда принимается решение о разрешении инструмента (принять/отклонить).

941 941 

942**Имя события**: `claude_code.tool_decision`942**Имя события**: `claude_code.tool_decision`

943 943 


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

947* `event.name`: `"tool_decision"`947* `event.name`: `"tool_decision"`

948* `event.timestamp`: Временная метка ISO 8601948* `event.timestamp`: Временная метка ISO 8601

949* `event.sequence`: счетчик для каждого процесса для упорядочивания событий, описанный в разделе [Атрибуты корреляции событий](#event-correlation-attributes)949* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

950* `tool_name`: Имя инструмента (например, "Read", "Edit", "Write", "NotebookEdit")950* `tool_name`: Имя инструмента (например, "Read", "Edit", "Write", "NotebookEdit")

951* `tool_use_id`: Уникальный идентификатор для этого вызова инструмента. Совпадает с `tool_use_id`, переданным в hooks, позволяя корреляцию между событиями OTel и данными, захваченными hooks.951* `tool_use_id`: Уникальный идентификатор для этого вызова инструмента. Совпадает с `tool_use_id`, переданным в hooks, позволяя корреляцию между событиями OTel и данными, захваченными hooks.

952* `decision`: Либо `"accept"`, либо `"reject"`952* `decision`: Либо `"accept"`, либо `"reject"`

953* `tool_source`: Всегда присутствует. Происхождение инструмента, как закрытый набор значений, авторизованных CLI. Требует Claude Code v2.1.214 или позже953* `tool_source`: Всегда присутствует. Происхождение инструмента как закрытый набор значений, созданных CLI. Требуется Claude Code v2.1.214 или позже

954 * `"builtin"`: собственные инструменты CLI954 * `"builtin"`: собственные инструменты CLI

955 * `"mcp"`: MCP серверы в целом955 * `"mcp"`: серверы MCP в целом

956 * `"sdk_host_builtin_mcp"`: встроенный в процесс сервер, встроенный в Claude Desktop, в сеансе, которым владеет Claude Desktop. Claude Desktop владеет сеансом, который он запустил из одной из своих собственных точек входа, `claude-desktop`, `claude-desktop-3p` или `local-agent`, когда этот сеанс не является вложенным дочерним; вложенные сеансы, включая сеансы, которые порождает Claude Code, сообщают эти серверы как `"mcp"`956 * `"sdk_host_builtin_mcp"`: встроенный в процесс сервер, встроенный в сам Claude Desktop, в сеансе, которым владеет Claude Desktop. Claude Desktop владеет сеансом, который он запустил из одной из своих собственных точек входа, `claude-desktop`, `claude-desktop-3p` или `local-agent`, когда этот сеанс не является вложенным дочерним; вложенные сеансы, включая сеансы, которые сам Claude Code порождает, сообщают эти серверы как `"mcp"`

957* `source`: Источник решения:957* `source`: Откуда пришло решение:

958 * `"config"`: Решено автоматически без запроса, на основе параметров проекта, правил разрешения или запрета в личных параметрах пользователя, корпоративной управляемой политики, флагов `--allowedTools` или `--disallowedTools`, активного режима разрешений, разрешения в области сеанса из более ранней подсказки в том же интерактивном сеансе CLI, или потому что инструмент по своей природе безопасен. Событие не указывает, какой из этих источников совпал. Claude Code также сообщает `"config"`, когда сам запрос на запрос разрешения не удается, например когда callback [`canUseTool`](/docs/ru/agent-sdk/typescript#canusetool) Agent SDK или инструмент [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags) возвращает недействительный результат, или когда входной поток закрывается во время ожидания запроса. До v2.1.216 Claude Code сообщал эти сбои как `"user_reject"`.958 * `"config"`: Решено автоматически без подсказки, на основе параметров проекта, правил разрешения или запрета в личных параметрах пользователя, политики, управляемой предприятием, флагов `--allowedTools` или `--disallowedTools`, активного режима разрешения, предоставления области действия сеанса из более раннего запроса в одном интерактивном сеансе CLI или потому что инструмент по своей природе безопасен. Событие не указывает, какой из этих источников совпадал. Claude Code также сообщает `"config"`, когда сам запрос подсказки разрешения не удаётся, например когда обратный вызов [`canUseTool`](/docs/ru/agent-sdk/typescript#canusetool) Agent SDK или инструмент [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags) возвращает недействительный результат, или когда входной поток закрывается, пока запрос ожидает. До v2.1.216 Claude Code сообщал эти сбои как `"user_reject"`.

959 * `"hook"`: Hook `PreToolUse` или `PermissionRequest` вернул решение.959 * `"hook"`: Hook `PreToolUse` или `PermissionRequest` вернул решение.

960 * `"user_permanent"`: Выдается, когда пользователь выбрал "Да, и больше не спрашивать для ..." при запросе разрешения, что сохраняет правило разрешения в его личных параметрах. В интерактивном CLI это выдается только для самого этого выбора; более поздние вызовы, которые соответствуют сохраненному правилу, выдают `"config"` вместо этого. В Agent SDK или неинтерактивных сеансах `-p` как начальный выбор, так и более поздние совпадения правил выдают `"user_permanent"`. Рассматривается как принятие.960 * `"user_permanent"`: Выпускается, когда пользователь выбрал "Да, и больше не спрашивай для ..." в подсказке разрешения, которая сохраняет правило разрешения в его личные параметры. В интерактивном CLI это выпускается только для самого этого выбора; более поздние вызовы, которые совпадают с сохранённым правилом, выпускают `"config"` вместо этого. В сеансах Agent SDK или неинтерактивных `-p`, как исходный выбор, так и более поздние совпадения правил выпускают `"user_permanent"`. Рассматривается как принятие.

961 * `"user_temporary"`: Выдается, когда пользователь выбрал "Да" при запросе разрешения для одноразового одобрения, или выбрал один из вариантов, который предоставляет доступ на оставшуюся часть сеанса на запросе редактирования или чтения файла. В интерактивном CLI это выдается только для самого выбора; более поздние вызовы, разрешенные этим разрешением в области сеанса, выдают `"config"` вместо этого. В Agent SDK или неинтерактивных сеансах `-p` как выбор, так и более поздние совпадения выдают `"user_temporary"`. Рассматривается как принятие.961 * `"user_temporary"`: Выпускается, когда пользователь выбрал "Да" в подсказке разрешения для одобрения в один раз, или выбрал опцию, которая предоставляет доступ на оставшуюся часть сеанса в подсказке редактирования или чтения файла. В интерактивном CLI это выпускается только для самого выбора; более поздние вызовы, разрешённые этим предоставлением области действия сеанса, выпускают `"config"` вместо этого. В сеансах Agent SDK или неинтерактивных `-p`, как выбор, так и более поздние совпадения выпускают `"user_temporary"`. Рассматривается как принятие.

962 * `"user_abort"`: Выдается, когда пользователь отклонил запрос разрешения без ответа. В Agent SDK и неинтерактивных сеансах `-p` это включает прерывание хода, пока запрос разрешения `canUseTool` или `--permission-prompt-tool` ожидает; до v2.1.216 Claude Code сообщал это прерывание как `"user_reject"`. Рассматривается как отклонение.962 * `"user_abort"`: Выпускается, когда пользователь отклонил подсказку разрешения без ответа. В сеансах Agent SDK и неинтерактивных `-p`, это включает прерывание хода, пока запрос разрешения `canUseTool` или `--permission-prompt-tool` ожидает; до v2.1.216 Claude Code сообщал это прерывание как `"user_reject"`. Рассматривается как отклонение.

963 * `"user_reject"`: Выдается, когда пользователь выбрал "Нет" при запросе. В интерактивном CLI это выдается только для самого этого выбора; вызовы, которые соответствуют правилу отказа в личных параметрах пользователя, выдают `"config"` вместо этого. В Agent SDK или неинтерактивных сеансах `-p` вызовы, которые соответствуют правилу отказа в личных параметрах, выдают `"user_reject"`. Рассматривается как отклонение.963 * `"user_reject"`: Выпускается, когда пользователь выбрал "Нет" при подсказке. В интерактивном CLI это выпускается только для самого этого выбора; вызовы, которые совпадают с правилом запрета в личных параметрах пользователя, выпускают `"config"` вместо этого. В сеансах Agent SDK или неинтерактивных `-p`, вызовы, которые совпадают с правилом запрета в личных параметрах, выпускают `"user_reject"`. Рассматривается как отклонение.

964* `tool_parameters` (когда `OTEL_LOG_TOOL_DETAILS=1`): JSON строка, содержащая параметры, специфичные для инструмента. Та же форма, что и [Событие результата инструмента](#tool-result-event), минус поля после выполнения, такие как `git_commit_id`. Значения могут отличаться от `tool_result` для принятого вызова, если решение о разрешении переписывает входные данные инструмента через `updatedInput`. Используйте этот атрибут, чтобы увидеть, какая команда была отклонена, когда `decision` это `"reject"`.964* `tool_parameters` (когда `OTEL_LOG_TOOL_DETAILS=1`): Строка JSON, содержащая параметры, специфичные для инструмента. Та же форма, что и [Событие результата инструмента](#tool-result-event), минус поля после выполнения, такие как `git_commit_id`. Значения могут отличаться от `tool_result` для принятого вызова, если решение разрешения переписывает вход инструмента через `updatedInput`. Используйте этот атрибут, чтобы увидеть, какая команда была отклонена, когда `decision` — это `"reject"`.

965 * Для инструментов `"sdk_host_builtin_mcp"`: `mcp_server_name` и `mcp_tool_name` включаются даже когда `OTEL_LOG_TOOL_DETAILS` отключен, потому что хост-приложение определяет эти имена; без них отклоненный вызов одного из этих встроенных серверов был бы неатрибутируемым на потоке по умолчанию. Для пользовательских MCP серверов `tool_name` события всегда буквальный `"mcp_tool"`, и имена сервера и инструмента появляются только в `tool_parameters` с флагом включенным; содержимое аргумента требует флага везде. Требует Claude Code v2.1.214 или позже965 * Для инструментов `"sdk_host_builtin_mcp"`: `mcp_server_name` и `mcp_tool_name` включаются даже когда `OTEL_LOG_TOOL_DETAILS` отключен, потому что приложение хоста определяет эти имена; без них отклонённый вызов одного из этих встроенных серверов был бы неатрибутируемым в потоке по умолчанию. Для серверов MCP, настроенных пользователем, `tool_name` события всегда является буквальным `"mcp_tool"`, и имена сервера и инструмента отображаются только в `tool_parameters` с включённым флагом; содержание аргумента требует флага везде. Требуется Claude Code v2.1.214 или позже

966 * Для инструмента Bash: включает `bash_command`, `full_command`, `timeout`, `description`, `dangerouslyDisableSandbox`. Инструмент bash рабочей области приложения для рабочего стола также сообщает `tool_name` как `Bash`, но включает только `bash_command`, `full_command` и `timeout`966 * Для инструмента Bash: включает `bash_command`, `full_command`, `timeout`, `description`, `dangerouslyDisableSandbox`. Инструмент bash рабочей области приложения для рабочего стола также сообщает `tool_name` как `Bash`, но включает только `bash_command`, `full_command` и `timeout`

967 * Для инструментов MCP: включает `mcp_server_name`, `mcp_tool_name`967 * Для инструментов MCP: включает `mcp_server_name`, `mcp_tool_name`

968 * Для инструмента Skill: включает `skill_name`968 * Для инструмента Skill: включает `skill_name`

969 * Для инструмента Agent или устаревшего инструмента Task: включает `subagent_type`969 * Для инструмента Agent или устаревшего инструмента Task: включает `subagent_type`

970 970 

971<h4 id="permission-mode-changed-event">971<h4 id="permission-mode-changed-event">

972 Событие изменения режима разрешений972 Событие изменения режима разрешения

973</h4>973</h4>

974 974 

975Логируется, когда режим разрешений изменяется, например при циклировании Shift+Tab, выходе из Plan Mode или проверке gate автоматического режима.975Регистрируется, когда режим разрешения изменяется, например из цикла Shift+Tab, выхода из режима плана или проверки ворот автоматического режима.

976 976 

977**Имя события**: `claude_code.permission_mode_changed`977**Имя события**: `claude_code.permission_mode_changed`

978 978 


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

982* `event.name`: `"permission_mode_changed"`982* `event.name`: `"permission_mode_changed"`

983* `event.timestamp`: Временная метка ISO 8601983* `event.timestamp`: Временная метка ISO 8601

984* `event.sequence`: счетчик для каждого процесса для упорядочивания событий, описанный в разделе [Атрибуты корреляции событий](#event-correlation-attributes)984* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

985* `from_mode`: Предыдущий режим разрешений, например `"default"`, `"plan"`, `"acceptEdits"`, `"auto"` или `"bypassPermissions"`985* `from_mode`: Предыдущий режим разрешения, например `"default"`, `"plan"`, `"acceptEdits"`, `"auto"` или `"bypassPermissions"`

986* `to_mode`: Новый режим разрешений986* `to_mode`: Новый режим разрешения

987* `trigger`: Что вызвало изменение. Один из `"shift_tab"`, `"exit_plan_mode"`, `"auto_gate_denied"` или `"auto_opt_in"`. Отсутствует, когда переход исходит из SDK или моста987* `trigger`: Что вызвало изменение. Один из `"shift_tab"`, `"exit_plan_mode"`, `"auto_gate_denied"` или `"auto_opt_in"`. Отсутствует, когда переход происходит из SDK или моста

988 988 

989<h4 id="auth-event">989<h4 id="auth-event">

990 Событие аутентификации990 Событие аутентификации

991</h4>991</h4>

992 992 

993Логируется, когда `/login` или `/logout` завершается.993Регистрируется, когда `/login` или `/logout` завершается.

994 994 

995**Имя события**: `claude_code.auth`995**Имя события**: `claude_code.auth`

996 996 


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

1000* `event.name`: `"auth"`1000* `event.name`: `"auth"`

1001* `event.timestamp`: Временная метка ISO 86011001* `event.timestamp`: Временная метка ISO 8601

1002* `event.sequence`: счетчик для каждого процесса для упорядочивания событий, описанный в разделе [Атрибуты корреляции событий](#event-correlation-attributes)1002* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

1003* `action`: `"login"` или `"logout"`1003* `action`: `"login"` или `"logout"`

1004* `success`: `"true"` или `"false"`1004* `success`: `"true"` или `"false"`

1005* `auth_method`: Метод аутентификации, такой как `"oauth"`1005* `auth_method`: Метод аутентификации, например `"oauth"`

1006* `error_category`: Категориальный вид ошибки при сбое действия. Исходное сообщение об ошибке никогда не включается1006* `error_category`: Категориальный вид ошибки, когда действие не удалось. Необработанное сообщение об ошибке никогда не включается

1007* `status_code`: HTTP код состояния в виде строки при сбое действия с ошибкой HTTP1007* `status_code`: Код состояния HTTP как строка, когда действие не удалось с ошибкой HTTP

1008 1008 

1009<h4 id="mcp-server-connection-event">1009<h4 id="mcp-server-connection-event">

1010 Событие подключения MCP сервера1010 Событие подключения сервера MCP

1011</h4>1011</h4>

1012 1012 

1013Логируется, когда MCP сервер подключается, отключается или не удается подключиться.1013Регистрируется, когда сервер MCP подключается, отключается или не удаётся подключиться.

1014 1014 

1015**Имя события**: `claude_code.mcp_server_connection`1015**Имя события**: `claude_code.mcp_server_connection`

1016 1016 


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

1020* `event.name`: `"mcp_server_connection"`1020* `event.name`: `"mcp_server_connection"`

1021* `event.timestamp`: Временная метка ISO 86011021* `event.timestamp`: Временная метка ISO 8601

1022* `event.sequence`: счетчик для каждого процесса для упорядочивания событий, описанный в разделе [Атрибуты корреляции событий](#event-correlation-attributes)1022* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

1023* `status`: `"connected"`, `"failed"` или `"disconnected"`1023* `status`: `"connected"`, `"failed"` или `"disconnected"`

1024* `transport_type`: Транспорт сервера, такой как `"stdio"`, `"sse"` или `"http"`1024* `transport_type`: Транспорт сервера, например `"stdio"`, `"sse"` или `"http"`

1025* `server_scope`: Область, в которой настроен сервер, такая как `"user"`, `"project"` или `"local"`1025* `server_scope`: Область, в которой настроен сервер, например `"user"`, `"project"` или `"local"`

1026* `duration_ms`: Длительность попытки подключения в миллисекундах1026* `duration_ms`: Длительность попытки подключения в миллисекундах

1027* `error_code`: Код ошибки при сбое подключения1027* `error_code`: Код ошибки, когда подключение не удалось

1028* `is_plugin`: `true` когда сервер предоставляется плагином, `false` в противном случае1028* `is_plugin`: `true`, когда сервер предоставляется плагином, `false` в противном случае

1029* `plugin_id_hash` (когда `is_plugin` это `true`): Стабильный хеш имени плагина и маркетплейса для группировки событий по плагину без раскрытия имени. Claude Code вычисляет его, как описано в разделе [Событие загрузки плагина](#plugin-loaded-event)1029* `plugin_id_hash` (когда `is_plugin` — это `true`): Стабильный хеш имени плагина и маркетплейса для группировки событий по плагину без раскрытия имени. Claude Code вычисляет его, как описано в [событие загрузки плагина](#plugin-loaded-event)

1030* `plugin.name` (когда `is_plugin` это `true`): Имя плагина, который предоставляет сервер. Для плагинов третьих сторон это буквальная строка `"third-party"`, если не установлен `OTEL_LOG_TOOL_DETAILS=1`; это защищает имена плагинов третьих сторон от появления в логах по умолчанию. Плагины из официальных источников Anthropic всегда идентифицируются по имени. Атрибуты `plugin_id_hash` и `plugin.name` поступают на ваш собственный бэкенд мониторинга и не отправляются в Anthropic1030* `plugin.name` (когда `is_plugin` — это `true`): Имя плагина, который предоставляет сервер. Для плагинов третьих сторон это буквальная строка `"third-party"`, если не установлено `OTEL_LOG_TOOL_DETAILS=1`; это защищает имена плагинов третьих сторон от появления в логах по умолчанию. Плагины из официальных источников Anthropic всегда идентифицируются по имени. Атрибуты `plugin_id_hash` и `plugin.name` передаются только вашему собственному бэкенду мониторинга и не отправляются в Anthropic

1031* `server_name` (когда `OTEL_LOG_TOOL_DETAILS=1`): Настроенное имя сервера1031* `server_name` (когда `OTEL_LOG_TOOL_DETAILS=1`): Настроенное имя сервера

1032* `error` (когда `OTEL_LOG_TOOL_DETAILS=1`): Полное сообщение об ошибке при сбое подключения1032* `error` (когда `OTEL_LOG_TOOL_DETAILS=1`): Полное сообщение об ошибке, когда подключение не удалось

1033 1033 

1034<h4 id="internal-error-event">1034<h4 id="internal-error-event">

1035 Событие внутренней ошибки1035 Событие внутренней ошибки

1036</h4>1036</h4>

1037 1037 

1038Логируется, когда Claude Code перехватывает неожиданную внутреннюю ошибку. Записываются только имя класса ошибки и код в стиле errno. Сообщение об ошибке и трассировка стека никогда не включаются. Это событие не выдается при запуске против Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry, или когда установлен `DISABLE_ERROR_REPORTING`.1038Регистрируется, когда Claude Code перехватывает неожиданную внутреннюю ошибку. Записываются только имя класса ошибки и код в стиле errno. Сообщение об ошибке и трассировка стека никогда не включаются. Это событие не выпускается при запуске против Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry, или когда установлено `DISABLE_ERROR_REPORTING`.

1039 1039 

1040**Имя события**: `claude_code.internal_error`1040**Имя события**: `claude_code.internal_error`

1041 1041 


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

1045* `event.name`: `"internal_error"`1045* `event.name`: `"internal_error"`

1046* `event.timestamp`: Временная метка ISO 86011046* `event.timestamp`: Временная метка ISO 8601

1047* `event.sequence`: счетчик для каждого процесса для упорядочивания событий, описанный в разделе [Атрибуты корреляции событий](#event-correlation-attributes)1047* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

1048* `error_name`: Имя класса ошибки, такой как `"TypeError"` или `"SyntaxError"`1048* `error_name`: Имя класса ошибки, например `"TypeError"` или `"SyntaxError"`

1049* `error_code`: Код errno Node.js, такой как `"ENOENT"`, когда присутствует в ошибке1049* `error_code`: Код errno Node.js, такой как `"ENOENT"`, когда присутствует на ошибке

1050 1050 

1051<h4 id="plugin-installed-event">1051<h4 id="plugin-installed-event">

1052 Событие установки плагина1052 Событие установки плагина

1053</h4>1053</h4>

1054 1054 

1055Логируется, когда плагин завершает установку, как из команды CLI `claude plugin install`, так и из интерактивного UI `/plugin`.1055Регистрируется, когда плагин завершает установку, как из команды CLI `claude plugin install`, так и из интерактивного пользовательского интерфейса `/plugin`.

1056 1056 

1057**Имя события**: `claude_code.plugin_installed`1057**Имя события**: `claude_code.plugin_installed`

1058 1058 


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

1062* `event.name`: `"plugin_installed"`1062* `event.name`: `"plugin_installed"`

1063* `event.timestamp`: Временная метка ISO 86011063* `event.timestamp`: Временная метка ISO 8601

1064* `event.sequence`: счетчик для каждого процесса для упорядочивания событий, описанный в разделе [Атрибуты корреляции событий](#event-correlation-attributes)1064* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

1065* `marketplace.is_official`: `"true"` если маркетплейс является официальным маркетплейсом Anthropic, `"false"` в противном случае1065* `marketplace.is_official`: `"true"`, если маркетплейс является официальным маркетплейсом Anthropic, `"false"` в противном случае

1066* `install.trigger`: `"cli"` или `"ui"`1066* `install.trigger`: `"cli"` или `"ui"`

1067* `plugin.name`: Имя установленного плагина. Для сторонних маркетплейсов это включается только, когда `OTEL_LOG_TOOL_DETAILS=1`1067* `plugin.name`: Имя установленного плагина. Для маркетплейсов третьих сторон это включается только, когда установлено `OTEL_LOG_TOOL_DETAILS=1`

1068* `plugin.version`: Версия плагина, когда объявлена в записи маркетплейса. Для сторонних маркетплейсов это включается только, когда `OTEL_LOG_TOOL_DETAILS=1`1068* `plugin.version`: Версия плагина, когда объявлена в записи маркетплейса. Для маркетплейсов третьих сторон это включается только, когда установлено `OTEL_LOG_TOOL_DETAILS=1`

1069* `marketplace.name`: Маркетплейс, из которого был установлен плагин. Для сторонних маркетплейсов это включается только, когда `OTEL_LOG_TOOL_DETAILS=1`1069* `marketplace.name`: Маркетплейс, из которого был установлен плагин. Для маркетплейсов третьих сторон это включается только, когда установлено `OTEL_LOG_TOOL_DETAILS=1`

1070 1070 

1071<h4 id="plugin-loaded-event">1071<h4 id="plugin-loaded-event">

1072 Событие загрузки плагина1072 Событие загрузки плагина

1073</h4>1073</h4>

1074 1074 

1075Логируется один раз для каждого включенного плагина при запуске сеанса. Используйте это событие для инвентаризации активных плагинов в вашем парке, как дополнение к `plugin_installed`, которое записывает само действие установки.1075Регистрируется один раз на включённый плагин при запуске сеанса. Используйте это событие для инвентаризации активных плагинов в вашем парке, как дополнение к `plugin_installed`, которое записывает само действие установки.

1076 1076 

1077**Имя события**: `claude_code.plugin_loaded`1077**Имя события**: `claude_code.plugin_loaded`

1078 1078 


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

1082* `event.name`: `"plugin_loaded"`1082* `event.name`: `"plugin_loaded"`

1083* `event.timestamp`: Временная метка ISO 86011083* `event.timestamp`: Временная метка ISO 8601

1084* `event.sequence`: счетчик для каждого процесса для упорядочивания событий, описанный в разделе [Атрибуты корреляции событий](#event-correlation-attributes)1084* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

1085* `plugin.name`: имя плагина. Для плагинов вне официального маркетплейса и встроенного пакета значение `"third-party"`, если не установлен `OTEL_LOG_TOOL_DETAILS=1`1085* `plugin.name`: имя плагина. Для плагинов вне официального маркетплейса и встроенного пакета значение — это `"third-party"`, если не установлено `OTEL_LOG_TOOL_DETAILS=1`

1086* `marketplace.name`: маркетплейс, из которого был установлен плагин, когда известен. Скрыто как `"third-party"` при том же условии, что и `plugin.name`1086* `marketplace.name`: маркетплейс, из которого был установлен плагин, когда известен. Редактируется в `"third-party"` при том же условии, что и `plugin.name`

1087* `plugin.version`: версия из манифеста плагина. Включается только, когда имя не скрыто и манифест объявляет версию1087* `plugin.version`: версия из манифеста плагина. Включается только, когда имя не редактируется и манифест объявляет версию

1088* `plugin.scope`: категория происхождения для плагина: `"official"`, `"community"`, `"org"`, `"user-local"` или `"default-bundle"`1088* `plugin.scope`: категория происхождения для плагина: `"official"`, `"community"`, `"org"`, `"user-local"` или `"default-bundle"`

1089* `enabled_via`: как плагин был включен: `"default-enable"`, `"org-policy"`, `"admin-install"`, `"seed-mount"` или `"user-install"`. Значение `"admin-install"` означает, что плагин установлен как обязательный или автоустановка для вашей организации в [**Organization settings > Plugins**](https://claude.ai/admin-settings/plugins). До v2.1.246 Claude Code сообщал эти плагины как `"user-install"` или `"seed-mount"`1089* `enabled_via`: как плагин стал включённым: `"default-enable"`, `"org-policy"`, `"admin-install"`, `"seed-mount"` или `"user-install"`. Значение `"admin-install"` означает, что плагин установлен как обязательный или автоустановка для вашей организации в [**Organization settings > Plugins**](https://claude.ai/admin-settings/plugins). До v2.1.246 Claude Code сообщал эти плагины как `"user-install"` или `"seed-mount"`

1090* `plugin_id_hash`: детерминированный хеш имени плагина и маркетплейса, отправляемый только на ваш настроенный экспортер. Позволяет вам подсчитать различные плагины третьих сторон, загруженные в вашем парке, без записи их имен. Для [плагинов, синхронизированных из claude.ai](/docs/ru/plugins-reference#synced-plugins), Claude Code хеширует имя плагина с именем маркетплейса, которое claude.ai сообщает для плагина, или с `synced` в противном случае. До v2.1.246 Claude Code не использовал имя маркетплейса claude.ai в хеше1090* `plugin_id_hash`: детерминированный хеш имени плагина и маркетплейса, отправляемый только вашему настроенному экспортёру. Позволяет вам считать отдельные плагины третьих сторон, загруженные в вашем парке, без записи их имён. Для [плагинов, синхронизированных из claude.ai](/docs/ru/plugins-reference#synced-plugins), Claude Code хеширует имя плагина с именем маркетплейса, которое claude.ai сообщает для плагина, или с `synced` в противном случае. До v2.1.246 Claude Code не использовал имя маркетплейса claude.ai сообщает в хеше

1091* `has_hooks`: предоставляет ли плагин hooks1091* `has_hooks`: предоставляет ли плагин hooks

1092* `has_mcp`: предоставляет ли плагин MCP серверы1092* `has_mcp`: предоставляет ли плагин серверы MCP

1093* `host_owned_mcp`: `true` когда хост SDK управляет подключениями MCP этого плагина и Claude Code пропустил чтение конфигурации MCP сервера плагина, `false` в противном случае. Требует Claude Code v2.1.172 или позже1093* `host_owned_mcp`: `true`, когда хост SDK управляет подключениями MCP этого плагина и Claude Code пропустил чтение конфигурации сервера MCP плагина, `false` в противном случае. Требуется Claude Code v2.1.172 или позже

1094* `skill_path_count`: количество каталогов навыков, которые объявляет плагин1094* `skill_path_count`: количество каталогов навыков, которые объявляет плагин

1095* `command_path_count`: количество каталогов команд, которые объявляет плагин1095* `command_path_count`: количество каталогов команд, которые объявляет плагин

1096* `agent_path_count`: количество каталогов агентов, которые объявляет плагин1096* `agent_path_count`: количество каталогов агентов, которые объявляет плагин

1097* `safe_mode`: `"true"` когда сеанс был запущен с [`--safe-mode`](/docs/ru/cli-reference), `"false"` в противном случае. В безопасном режиме это событие сообщает только настроенный инвентарь; команды, навыки, hooks и MCP серверы плагина не загружаются. Требует Claude Code v2.1.169 или позже1097* `safe_mode`: `"true"`, когда сеанс был запущен с [`--safe-mode`](/docs/ru/cli-reference), `"false"` в противном случае. В безопасном режиме это событие сообщает только настроенный инвентарь; команды, навыки, hooks и серверы MCP плагина не загружаются. Требуется Claude Code v2.1.169 или позже

1098 1098 

1099<h4 id="skill-activated-event">1099<h4 id="skill-activated-event">

1100 Событие активации навыка1100 Событие активации навыка

1101</h4>1101</h4>

1102 1102 

1103Логируется, когда навык вызывается, будь то Claude вызывает его через инструмент Skill или вы запускаете его как команду `/`.1103Регистрируется, когда навык вызывается, будь то Claude вызывает его через инструмент Skill или вы запускаете его как команду `/`.

1104 1104 

1105**Имя события**: `claude_code.skill_activated`1105**Имя события**: `claude_code.skill_activated`

1106 1106 


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

1110* `event.name`: `"skill_activated"`1110* `event.name`: `"skill_activated"`

1111* `event.timestamp`: Временная метка ISO 86011111* `event.timestamp`: Временная метка ISO 8601

1112* `event.sequence`: счетчик для каждого процесса для упорядочивания событий, описанный в разделе [Атрибуты корреляции событий](#event-correlation-attributes)1112* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

1113* `skill.name`: Имя навыка. Для определяемых пользователем и сторонних плагин навыков значение является заполнителем `"custom_skill"`, если не установлен `OTEL_LOG_TOOL_DETAILS=1`1113* `skill.name`: Имя навыка. Для определённых пользователем и навыков плагинов третьих сторон значение — это заполнитель `"custom_skill"`, если не установлено `OTEL_LOG_TOOL_DETAILS=1`

1114* `invocation_trigger`: Как был вызван навык (`"user-slash"`, `"claude-proactive"` или `"nested-skill"`)1114* `invocation_trigger`: Как был вызван навык (`"user-slash"`, `"claude-proactive"` или `"nested-skill"`)

1115* `skill.source`: Откуда был загружен навык (например, `"bundled"`, `"userSettings"`, `"projectSettings"`, `"plugin"`)1115* `skill.source`: Откуда был загружен навык (например, `"bundled"`, `"userSettings"`, `"projectSettings"`, `"plugin"`)

1116* `skill.kind`: `"workflow"` когда навык является навыком workflow. Отсутствует в противном случае1116* `skill.kind`: `"workflow"`, когда навык является навыком рабочего процесса. Отсутствует в противном случае

1117* `plugin.name` (когда `OTEL_LOG_TOOL_DETAILS=1` или плагин из официального маркетплейса): Имя владельца плагина, когда навык предоставляется плагином1117* `plugin.name` (когда `OTEL_LOG_TOOL_DETAILS=1` или плагин из официального маркетплейса): Имя владеющего плагина, когда навык предоставляется плагином

1118* `marketplace.name` (когда `OTEL_LOG_TOOL_DETAILS=1` или плагин из официального маркетплейса): Маркетплейс владельца плагина, когда навык предоставляется плагином1118* `marketplace.name` (когда `OTEL_LOG_TOOL_DETAILS=1` или плагин из официального маркетплейса): Маркетплейс, из которого был установлен владеющий плагин, когда навык предоставляется плагином

1119 1119 

1120<h4 id="at-mention-event">1120<h4 id="at-mention-event">

1121 Событие упоминания @1121 Событие упоминания @

1122</h4>1122</h4>

1123 1123 

1124Логируется, когда Claude Code разрешает упоминание `@` в подсказке. Не каждое упоминание выдает событие: пути раннего выхода, такие как отказ в разрешении, файлы большого размера, вложения ссылок PDF и сбои при перечислении каталогов, возвращаются без логирования.1124Регистрируется, когда Claude Code разрешает упоминание `@` в запросе. Не каждое упоминание выпускает событие: пути раннего выхода, такие как отказы в разрешении, файлы чрезмерного размера, вложения ссылок PDF и сбои перечисления каталогов, возвращаются без логирования.

1125 1125 

1126**Имя события**: `claude_code.at_mention`1126**Имя события**: `claude_code.at_mention`

1127 1127 


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

1131* `event.name`: `"at_mention"`1131* `event.name`: `"at_mention"`

1132* `event.timestamp`: Временная метка ISO 86011132* `event.timestamp`: Временная метка ISO 8601

1133* `event.sequence`: счетчик для каждого процесса для упорядочивания событий, описанный в разделе [Атрибуты корреляции событий](#event-correlation-attributes)1133* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

1134* `mention_type`: Тип упоминания (`"file"`, `"directory"`, `"agent"`, `"mcp_resource"`, `"peer"`). Значение `"peer"` означает, что вы упомянули [один из ваших других сеансов Claude Code](/docs/ru/cross-session-messaging). Требует Claude Code v2.1.232 или позже1134* `mention_type`: Тип упоминания (`"file"`, `"directory"`, `"agent"`, `"mcp_resource"`, `"peer"`). Значение `"peer"` означает, что вы упомянули [один из ваших других сеансов Claude Code](/docs/ru/cross-session-messaging). Требуется Claude Code v2.1.232 или позже

1135* `success`: Было ли упоминание успешно разрешено (`"true"` или `"false"`)1135* `success`: Было ли упоминание успешно разрешено (`"true"` или `"false"`)

1136 1136 

1137<h4 id="api-retries-exhausted-event">1137<h4 id="api-retries-exhausted-event">

1138 Событие исчерпания повторных попыток API1138 Событие исчерпания повторных попыток API

1139</h4>1139</h4>

1140 1140 

1141Логируется один раз, когда запрос API не удается после более чем одной попытки. Выдается вместе с финальным событием `api_error`.1141Регистрируется один раз, когда запрос API не удаётся после более чем одной попытки. Выпускается вместе с финальным событием `api_error`.

1142 1142 

1143**Имя события**: `claude_code.api_retries_exhausted`1143**Имя события**: `claude_code.api_retries_exhausted`

1144 1144 


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

1148* `event.name`: `"api_retries_exhausted"`1148* `event.name`: `"api_retries_exhausted"`

1149* `event.timestamp`: Временная метка ISO 86011149* `event.timestamp`: Временная метка ISO 8601

1150* `event.sequence`: счетчик для каждого процесса для упорядочивания событий, описанный в разделе [Атрибуты корреляции событий](#event-correlation-attributes)1150* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

1151* `model`: Используемая модель1151* `model`: Используемая модель

1152* `error`: Финальное сообщение об ошибке1152* `error`: Финальное сообщение об ошибке

1153* `status_code`: HTTP код состояния в виде числа. Отсутствует для ошибок, не связанных с HTTP.1153* `status_code`: Код состояния HTTP как число. Отсутствует для ошибок, не связанных с HTTP.

1154* `total_attempts`: Общее количество попыток1154* `total_attempts`: Общее количество попыток

1155* `total_retry_duration_ms`: Общее время в реальном времени по всем попыткам1155* `total_retry_duration_ms`: Общее время на стене часов во всех попытках

1156* `speed`: `"fast"` или `"normal"`1156* `speed`: `"fast"` или `"normal"`

1157 1157 

1158<h4 id="hook-registered-event">1158<h4 id="hook-registered-event">

1159 Событие регистрации hook1159 Событие регистрации hook

1160</h4>1160</h4>

1161 1161 

1162Логируется один раз для каждого настроенного hook при запуске сеанса. Используйте это событие для инвентаризации активных hooks в вашем парке, как дополнение к событиям `hook_execution_start` и `hook_execution_complete` для каждого выполнения.1162Регистрируется один раз на настроенный hook при запуске сеанса. Используйте это событие для инвентаризации активных hooks в вашем парке, как дополнение к событиям `hook_execution_start` и `hook_execution_complete` на выполнение.

1163 1163 

1164**Имя события**: `claude_code.hook_registered`1164**Имя события**: `claude_code.hook_registered`

1165 1165 


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

1169* `event.name`: `"hook_registered"`1169* `event.name`: `"hook_registered"`

1170* `event.timestamp`: Временная метка ISO 86011170* `event.timestamp`: Временная метка ISO 8601

1171* `event.sequence`: счетчик для каждого процесса для упорядочивания событий, описанный в разделе [Атрибуты корреляции событий](#event-correlation-attributes)1171* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

1172* `hook_event`: тип события hook, такой как `"PreToolUse"` или `"PostToolUse"`1172* `hook_event`: тип события hook, например `"PreToolUse"` или `"PostToolUse"`

1173* `hook_type`: тип реализации hook: `"command"`, `"prompt"`, `"mcp_tool"`, `"http"` или `"agent"`1173* `hook_type`: тип реализации hook: `"command"`, `"prompt"`, `"mcp_tool"`, `"http"` или `"agent"`

1174* `hook_source`: где определен hook: `"userSettings"`, `"projectSettings"`, `"localSettings"`, `"flagSettings"`, `"policySettings"` или `"pluginHook"`1174* `hook_source`: где определён hook: `"userSettings"`, `"projectSettings"`, `"localSettings"`, `"flagSettings"`, `"policySettings"` или `"pluginHook"`

1175* `safe_mode`: `"true"` когда сеанс был запущен с [`--safe-mode`](/docs/ru/cli-reference), `"false"` в противном случае. Требует Claude Code v2.1.169 или позже1175* `safe_mode`: `"true"`, когда сеанс был запущен с [`--safe-mode`](/docs/ru/cli-reference), `"false"` в противном случае. Требуется Claude Code v2.1.169 или позже

1176* `hook_matcher` (когда `OTEL_LOG_TOOL_DETAILS=1`): строка matcher из конфигурации hook, когда она установлена1176* `hook_matcher` (когда `OTEL_LOG_TOOL_DETAILS=1`): строка сопоставления из конфигурации hook, когда она установлена

1177* `plugin.name` (когда `hook_source` это `"pluginHook"`): имя участвующего плагина. Для плагинов вне официального маркетплейса и встроенного пакета значение `"third-party"`, если не установлен `OTEL_LOG_TOOL_DETAILS=1`1177* `plugin.name` (когда `hook_source` — это `"pluginHook"`): имя способствующего плагина. Для плагинов вне официального маркетплейса и встроенного пакета значение — это `"third-party"`, если не установлено `OTEL_LOG_TOOL_DETAILS=1`

1178* `plugin_id_hash` (когда `hook_source` это `"pluginHook"`): детерминированный хеш имени плагина и маркетплейса, отправляемый только на ваш настроенный экспортер. Позволяет вам подсчитать различные участвующие плагины без записи их имен. Claude Code вычисляет его, как описано в разделе [Событие загрузки плагина](#plugin-loaded-event)1178* `plugin_id_hash` (когда `hook_source` — это `"pluginHook"`): детерминированный хеш имени плагина и маркетплейса, отправляемый только вашему настроенному экспортёру. Позволяет вам считать отдельные способствующие плагины без записи их имён. Claude Code вычисляет его, как описано в [событие загрузки плагина](#plugin-loaded-event)

1179 1179 

1180<h4 id="hook-execution-start-event">1180<h4 id="hook-execution-start-event">

1181 Событие начала выполнения hook1181 Событие начала выполнения hook

1182</h4>1182</h4>

1183 1183 

1184Логируется, когда один или несколько hooks начинают выполняться для события hook.1184Регистрируется, когда один или несколько hooks начинают выполняться для события hook.

1185 1185 

1186**Имя события**: `claude_code.hook_execution_start`1186**Имя события**: `claude_code.hook_execution_start`

1187 1187 


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

1191* `event.name`: `"hook_execution_start"`1191* `event.name`: `"hook_execution_start"`

1192* `event.timestamp`: Временная метка ISO 86011192* `event.timestamp`: Временная метка ISO 8601

1193* `event.sequence`: счетчик для каждого процесса для упорядочивания событий, описанный в разделе [Атрибуты корреляции событий](#event-correlation-attributes)1193* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

1194* `hook_event`: Тип события hook, такой как `"PreToolUse"` или `"PostToolUse"`1194* `hook_event`: Тип события hook, например `"PreToolUse"` или `"PostToolUse"`

1195* `hook_name`: Полное имя hook, включая matcher, такой как `"PreToolUse:Write"`1195* `hook_name`: Полное имя hook, включая сопоставление, например `"PreToolUse:Write"`

1196* `num_hooks`: Количество соответствующих команд hook1196* `num_hooks`: Количество совпадающих команд hook

1197* `managed_only`: `"true"` когда разрешены только управляемые политики hooks1197* `managed_only`: `"true"`, когда разрешены только hooks управляемой политики

1198* `hook_source`: `"policySettings"` или `"merged"`1198* `hook_source`: `"policySettings"` или `"merged"`

1199* `safe_mode`: `"true"` когда сеанс был запущен с [`--safe-mode`](/docs/ru/cli-reference), `"false"` в противном случае. Требует Claude Code v2.1.169 или позже1199* `safe_mode`: `"true"`, когда сеанс был запущен с [`--safe-mode`](/docs/ru/cli-reference), `"false"` в противном случае. Требуется Claude Code v2.1.169 или позже

1200* `hook_definitions`: JSON-сериализованная конфигурация hook. Включается только, когда включены как детальная бета-трассировка, так и `OTEL_LOG_TOOL_DETAILS=1`1200* `hook_definitions`: Сериализованная JSON конфигурация hook. Включается только, когда включены как детальная бета-трассировка, так и `OTEL_LOG_TOOL_DETAILS=1`

1201 1201 

1202<h4 id="hook-execution-complete-event">1202<h4 id="hook-execution-complete-event">

1203 Событие завершения выполнения hook1203 Событие завершения выполнения hook

1204</h4>1204</h4>

1205 1205 

1206Логируется, когда все hooks для события hook завершены.1206Регистрируется, когда все hooks для события hook завершены.

1207 1207 

1208**Имя события**: `claude_code.hook_execution_complete`1208**Имя события**: `claude_code.hook_execution_complete`

1209 1209 


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

1213* `event.name`: `"hook_execution_complete"`1213* `event.name`: `"hook_execution_complete"`

1214* `event.timestamp`: Временная метка ISO 86011214* `event.timestamp`: Временная метка ISO 8601

1215* `event.sequence`: счетчик для каждого процесса для упорядочивания событий, описанный в разделе [Атрибуты корреляции событий](#event-correlation-attributes)1215* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

1216* `hook_event`: Тип события hook1216* `hook_event`: Тип события hook

1217* `hook_name`: Полное имя hook, включая matcher1217* `hook_name`: Полное имя hook, включая сопоставление

1218* `num_hooks`: Количество соответствующих команд hook1218* `num_hooks`: Количество совпадающих команд hook

1219* `num_success`: Количество, которые завершились успешно1219* `num_success`: Количество, которое завершилось успешно

1220* `num_blocking`: Количество, которые вернули решение блокировки1220* `num_blocking`: Количество, которое вернуло решение блокировки

1221* `num_non_blocking_error`: Количество, которые не удались без блокировки1221* `num_non_blocking_error`: Количество, которое не удалось без блокировки

1222* `num_cancelled`: Количество, отмененные до завершения1222* `num_cancelled`: Количество отменено до завершения

1223* `total_duration_ms`: Длительность в реальном времени всех соответствующих hooks1223* `total_duration_ms`: Длительность на стене часов всех совпадающих hooks

1224* `managed_only`: `"true"` когда разрешены только управляемые политики hooks1224* `stdout_chars`: Общее количество символов stdout в совпадающих hooks, которые успешно завершились. Требуется Claude Code v2.1.280 или позже

1225* `additional_context_chars`: Общее количество символов `additionalContext`, возвращённых совпадающими hooks. Требуется Claude Code v2.1.280 или позже

1226* `system_message_chars`: Общее количество символов `systemMessage`, возвращённых совпадающими hooks. Требуется Claude Code v2.1.280 или позже

1227* `initial_user_message_chars`: Общее количество символов `initialUserMessage`, возвращённых совпадающими hooks. Требуется Claude Code v2.1.280 или позже

1228* `num_outputs_persisted`: Количество выходов hook сверх [лимита 10 000 символов](/docs/ru/hooks#json-output), которые Claude Code сохранил в файл. Требуется Claude Code v2.1.280 или позже

1229* `managed_only`: `"true"`, когда разрешены только hooks управляемой политики

1225* `hook_source`: `"policySettings"` или `"merged"`1230* `hook_source`: `"policySettings"` или `"merged"`

1226* `safe_mode`: `"true"` когда сеанс был запущен с [`--safe-mode`](/docs/ru/cli-reference), `"false"` в противном случае. Требует Claude Code v2.1.169 или позже1231* `safe_mode`: `"true"`, когда сеанс был запущен с [`--safe-mode`](/docs/ru/cli-reference), `"false"` в противном случае. Требуется Claude Code v2.1.169 или позже

1227* `hook_definitions`: JSON-сериализованная конфигурация hook. Включается только, когда включены как детальная бета-трассировка, так и `OTEL_LOG_TOOL_DETAILS=1`1232* `hook_definitions`: Сериализованная JSON конфигурация hook. Включается только, когда включены как детальная бета-трассировка, так и `OTEL_LOG_TOOL_DETAILS=1`

1228 1233 

1229<h4 id="hook-plugin-metrics-event">1234<h4 id="hook-plugin-metrics-event">

1230 Событие метрик плагина hook1235 Событие метрик hook плагина

1231</h4>1236</h4>

1232 1237 

1233Логируется, когда hook плагина из официального маркетплейса выдает метрики для каждого вызова. Только плагины, установленные из официального маркетплейса Anthropic, могут выдавать эти метрики. Плагины сторонних маркетплейсов и пользовательские hooks не выдают в это событие. Используйте это событие для мониторинга поведения плагина, такого как показатели поиска, затраты и длительность из вашего собственного стека наблюдаемости.1238Регистрируется, когда hook плагина официального маркетплейса выпускает метрики на выполнение. Только плагины, установленные из официального маркетплейса Anthropic, могут выпускать эти. Плагины маркетплейса третьих сторон и пользовательские hooks не выпускают в это событие. Используйте это событие для мониторинга поведения плагина, такого как скорости поиска, затраты и длительность из вашего собственного стека наблюдаемости.

1234 1239 

1235**Имя события**: `claude_code.hook_plugin_metrics`1240**Имя события**: `claude_code.hook_plugin_metrics`

1236 1241 


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

1240* `event.name`: `"hook_plugin_metrics"`1245* `event.name`: `"hook_plugin_metrics"`

1241* `event.timestamp`: Временная метка ISO 86011246* `event.timestamp`: Временная метка ISO 8601

1242* `event.sequence`: счетчик для каждого процесса для упорядочивания событий, описанный в разделе [Атрибуты корреляции событий](#event-correlation-attributes)1247* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

1243* `plugin_id`: идентификатор плагина в форме `<name>@<marketplace>`1248* `plugin_id`: идентификатор плагина в форме `<name>@<marketplace>`

1244* `hook_event`: тип события hook, который выдал метрики1249* `hook_event`: тип события hook, который выпустил метрики

1245* До 20 ключей метрик, выданных плагином. Имена соответствуют `^[a-z][a-z0-9_]{0,39}$`. Значения являются логическими или числовыми.1250* До 20 ключей метрик, выпущенных плагином. Имена совпадают с `^[a-z][a-z0-9_]{0,39}$`. Значения — это логическое значение или число.

1246 1251 

1247<h4 id="compaction-event">1252<h4 id="compaction-event">

1248 Событие компактирования1253 Событие компактирования

1249</h4>1254</h4>

1250 1255 

1251Логируется, когда компактирование разговора завершается.1256Регистрируется, когда компактирование разговора завершается.

1252 1257 

1253**Имя события**: `claude_code.compaction`1258**Имя события**: `claude_code.compaction`

1254 1259 


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

1258* `event.name`: `"compaction"`1263* `event.name`: `"compaction"`

1259* `event.timestamp`: Временная метка ISO 86011264* `event.timestamp`: Временная метка ISO 8601

1260* `event.sequence`: счетчик для каждого процесса для упорядочивания событий, описанный в разделе [Атрибуты корреляции событий](#event-correlation-attributes)1265* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

1261* `trigger`: `"auto"` или `"manual"`1266* `trigger`: `"auto"` или `"manual"`

1262* `success`: `"true"` или `"false"`1267* `success`: `"true"` или `"false"`

1263* `duration_ms`: Длительность компактирования1268* `duration_ms`: Длительность компактирования

1264* `pre_tokens`: Приблизительное количество токенов до компактирования1269* `pre_tokens`: Приблизительный подсчёт токенов до компактирования

1265* `post_tokens`: Приблизительное количество токенов после компактирования1270* `post_tokens`: Приблизительный подсчёт токенов после компактирования

1266* `error`: Сообщение об ошибке при сбое компактирования1271* `error`: Сообщение об ошибке, когда компактирование не удалось

1267* `precompute_reuse`: Установлено только, когда `trigger` это `"manual"`. Автоматическое компактирование может подготовить сводку в фоновом режиме перед заполнением окна контекста, и этот атрибут записывает, была ли эта подготовленная сводка повторно использована `/compact`. `"hit"` означает, что она была повторно использована; `"miss_custom_instructions"`, `"miss_hook"` и `"miss_not_ready"` дают причину, по которой вместо этого была вычислена свежая сводка. Требует Claude Code v2.1.153 или позже1272* `precompute_reuse`: Установлено только, когда `trigger` — это `"manual"`. Автокомпактирование может подготовить резюме в фоне перед заполнением окна контекста, и этот атрибут записывает, было ли это подготовленное резюме повторно использовано `/compact`. `"hit"` означает, что оно было повторно использовано; `"miss_custom_instructions"`, `"miss_hook"` и `"miss_not_ready"` дают причину, по которой вместо этого было вычислено свежее резюме. Требуется Claude Code v2.1.153 или позже

1268 1273 

1269<h4 id="subagent-completed-event">1274<h4 id="subagent-completed-event">

1270 Событие завершения подагента1275 Событие завершения подагента

1271</h4>1276</h4>

1272 1277 

1273Логируется, когда [подагент](/docs/ru/sub-agents) завершает работу и возвращает свой результат в разговор, который его запустил. Используйте его для сворачивания использования инструментов и времени выполнения по типу подагента; для сворачивания токенов или затрат используйте [счетчик токенов](#token-counter) и [счетчик затрат](#cost-counter), отфильтрованные по `query_source` `"subagent"`, так как `total_tokens` этого события охватывает только финальный запрос. Категория `"subagent"` также подсчитывает запросы от hooks на основе агентов, которые не выдают событие подагента.1278Регистрируется, когда [подагент](/docs/ru/sub-agents) завершается и возвращает свой результат в разговор, который его запустил. Используйте его для сворачивания использования инструментов и времени выполнения по типу подагента; для сворачивания токенов или затрат используйте [счётчик токенов](#token-counter) и [счётчик стоимости](#cost-counter), отфильтрованные по `query_source` `"subagent"`, так как `total_tokens` этого события охватывает только финальный запрос. Категория `"subagent"` также считает запросы от hooks на основе агентов, которые не выпускают событие подагента.

1274 1279 

1275**Имя события**: `claude_code.subagent_completed`1280**Имя события**: `claude_code.subagent_completed`

1276 1281 


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

1280* `event.name`: `"subagent_completed"`1285* `event.name`: `"subagent_completed"`

1281* `event.timestamp`: Временная метка ISO 86011286* `event.timestamp`: Временная метка ISO 8601

1282* `event.sequence`: счетчик для каждого процесса для упорядочивания событий, описанный в разделе [Атрибуты корреляции событий](#event-correlation-attributes)1287* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

1283* `agent_type`: Тип подагента. Встроенные имена агентов и агенты из официальных плагинов маркетплейса появляются как есть; другие имена агентов заменяются на `"custom"`, если не установлен `OTEL_LOG_TOOL_DETAILS=1`1288* `agent_type`: Тип подагента. Встроенные имена агентов и агенты из официальных плагинов маркетплейса отображаются как есть; другие имена агентов заменяются на `"custom"`, если не установлено `OTEL_LOG_TOOL_DETAILS=1`

1284* `agent.source`: Откуда пришло определение агента: `built-in`, `plugin` или источник параметров, который определил пользовательского агента, такой как `userSettings` или `projectSettings`1289* `agent.source`: Откуда пришло определение агента: `built-in`, `plugin` или источник параметров, который определил пользовательского агента, например `userSettings` или `projectSettings`

1285* `is_built_in`: Является ли подагент встроенным типом агента1290* `is_built_in`: Является ли подагент встроенным типом агента

1286* `is_async`: Работал ли подагент в [фоновом режиме](/docs/ru/sub-agents#run-subagents-in-foreground-or-background)1291* `is_async`: Работал ли подагент в [фоне](/docs/ru/sub-agents#run-subagents-in-foreground-or-background)

1287* `total_tokens`: Токен-отпечаток финального запроса API подагента: входные, создание кэша, чтение кэша и выходные токены этого одного запроса, примерно размер контекста подагента при завершении. Не сумма по всему запуску1292* `total_tokens`: Отпечаток токена финального запроса API подагента: входные, создание кэша, чтение кэша и выходные токены этого одного запроса, примерно размер контекста подагента при завершении. Не сумма по всему запуску

1288* `total_tool_uses`: Количество вызовов инструментов, которые подагент сделал по всему запуску1293* `total_tool_uses`: Количество вызовов инструментов, которые подагент сделал во всём запуске

1289* `duration_ms`: Время выполнения в миллисекундах1294* `duration_ms`: Время выполнения в миллисекундах

1290* `model`: Модель, на которой подагент был разрешен запускаться1295* `model`: Модель, на которую был разрешён подагент для запуска

1291* `final_model`: Модель, которая создала финальный ответ подагента, отличается от `model` после переключения во время запуска, такого как резервный вариант. Требует Claude Code v2.1.212 или позже1296* `final_model`: Модель, которая создала финальный ответ подагента, отличающаяся от `model` после переключения во время запуска, такого как резервный вариант. Требуется Claude Code v2.1.212 или позже

1292* `model_swapped`: Обслуживали ли более одной модели запросы подагента. Требует Claude Code v2.1.212 или позже1297* `model_swapped`: Обслуживала ли более одной модели запросы подагента. Требуется Claude Code v2.1.212 или позже

1293* `plugin_id_hash`, `plugin.name`: Присутствует для агентов, предоставляемых плагинами. Имена плагинов официального маркетплейса появляются как есть; другие имена плагинов заменяются на `"third-party"`, если не установлен `OTEL_LOG_TOOL_DETAILS=1`1298* `plugin_id_hash`, `plugin.name`: Присутствует для агентов, предоставленных плагинами. Имена плагинов официального маркетплейса отображаются как есть; другие имена плагинов заменяются на `"third-party"`, если не установлено `OTEL_LOG_TOOL_DETAILS=1`

1294 1299 

1295<h4 id="feedback-survey-event">1300<h4 id="feedback-survey-event">

1296 Событие опроса обратной связи1301 Событие опроса обратной связи

1297</h4>1302</h4>

1298 1303 

1299Логируется, когда опрос качества сеанса показывается или на него отвечают. Дополнительную информацию о том, что собирают опросы и как их контролировать, см. в разделе [Опросы качества сеанса](/docs/ru/data-usage#session-quality-surveys).1304Регистрируется, когда показывается или отвечается опрос качества сеанса. См. [Опросы качества сеанса](/docs/ru/data-usage#session-quality-surveys) для того, что опросы собирают и как их контролировать.

1300 1305 

1301**Имя события**: `claude_code.feedback_survey`1306**Имя события**: `claude_code.feedback_survey`

1302 1307 


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

1306* `event.name`: `"feedback_survey"`1311* `event.name`: `"feedback_survey"`

1307* `event.timestamp`: Временная метка ISO 86011312* `event.timestamp`: Временная метка ISO 8601

1308* `event.sequence`: счетчик для каждого процесса для упорядочивания событий, описанный в разделе [Атрибуты корреляции событий](#event-correlation-attributes)1313* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

1309* `event_type`: Событие жизненного цикла опроса, например `"appeared"`, `"responded"` или `"transcript_prompt_appeared"`1314* `event_type`: Событие жизненного цикла опроса, например `"appeared"`, `"responded"` или `"transcript_prompt_appeared"`

1310* `appearance_id`: Уникальный ID, связывающий события, выданные для одного экземпляра опроса1315* `appearance_id`: Уникальный ID, связывающий события, выпущенные для одного экземпляра опроса

1311* `survey_type`: Какой опрос произвел событие. `"session"` это подсказка рейтинга "Как работает Claude?"1316* `survey_type`: Какой опрос создал событие. `"session"` — это подсказка рейтинга "Как работает Claude?"

1312* `response`: Выбор пользователя на событиях `responded`1317* `response`: Выбор пользователя на событиях `responded`

1313* `enabled_via_override`: `true` когда установлен [`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`](/docs/ru/env-vars). Выдается как логическое значение, а не строка. Присутствует на событиях опроса `session`. Отфильтруйте по этому атрибуту, чтобы подтвердить, что переопределение применяется в вашем парке1318* `enabled_via_override`: `true`, когда установлено [`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`](/docs/ru/env-vars). Выпускается как логическое значение, не строка. Присутствует на событиях опроса `session`. Фильтруйте по этому атрибуту, чтобы подтвердить, что переопределение применяется в парке

1314 1319 

1315<h4 id="retention-sweep-event">1320<h4 id="retention-sweep-event">

1316 Событие очистки удержания1321 Событие развёртки удержания

1317</h4>1322</h4>

1318 1323 

1319Логируется один раз за запуск очистки удержания, которая удаляет [транскрипты сеансов и другие данные приложения](/docs/ru/claude-directory#cleaned-up-automatically), старше чем параметр [`cleanupPeriodDays`](/docs/ru/settings-reference#cleanupperioddays). Claude Code запускает очистку в фоновом режиме максимум один раз за сеанс, и запуск, который ничего не удаляет, все равно выдает событие. Если Claude Code запустил очистку в любом сеансе на одной машине в течение последних 24 часов, он задерживает очистку этого сеанса как минимум на 10 минут, поэтому сеанс, который выходит раньше, ничего не выдает. Когда вы запускаете `claude -p` с `--bare`, Claude Code не запускает очистку и ничего не выдает.1324Регистрируется один раз за запуск развёртки очистки удержания, которая удаляет [стенограммы сеансов и другие данные приложения](/docs/ru/claude-directory#cleaned-up-automatically), старше чем параметр [`cleanupPeriodDays`](/docs/ru/settings-reference#cleanupperioddays). Claude Code запускает развёртку в фоне максимум один раз за сеанс, и запуск, который ничего не удаляет, всё ещё выпускает событие. Если Claude Code запустил развёртку в любом сеансе на одной машине в последние 24 часа, он задерживает развёртку этого сеанса как минимум на 10 минут, поэтому сеанс, который выходит раньше, ничего не выпускает. Когда вы запускаете `claude -p` с `--bare`, Claude Code не запускает развёртку и ничего не выпускает.

1320 1325 

1321Как и каждое событие OTel на этой странице, оно идет только на бэкенд телеметрии, который вы настраиваете. Требует Claude Code v2.1.227 или позже.1326Как каждое событие OTel на этой странице, оно идёт только на бэкенд телеметрии, который вы настраиваете. Требуется Claude Code v2.1.227 или позже.

1322 1327 

1323Когда Claude Code не может безопасно определить период удержания, он приостанавливает очистку и выдает событие с `result`, установленным на `"skipped"` и `skip_reason`. Когда [управляемые параметры](/docs/ru/server-managed-settings) устанавливают `cleanupPeriodDays`, управляемое значение закрепляет период удержания и очистка запускается даже когда файл параметров в более низком приоритете области сломан или недействителен. Когда сам `managed-settings.json` не может быть прочитан, Claude Code все равно приостанавливает очистку, если только [управляемый уровень](/docs/ru/managed-settings#how-claude-code-combines-managed-sources) не поставляет `cleanupPeriodDays` откуда-то еще, такой как управляемые параметры сервера или `managed-settings.d/` drop-in рядом с поломанным файлом. Атрибуты счетчика удаления присутствуют только когда `result` это `"complete"`.1328Когда Claude Code не может безопасно определить период удержания, он приостанавливает развёртку и выпускает событие с `result`, установленным в `"skipped"`, и `skip_reason`. Когда [управляемые параметры](/docs/ru/server-managed-settings) устанавливают `cleanupPeriodDays`, управляемое значение закрепляет период удержания и развёртка работает даже когда файл параметров в более низком приоритете области повреждён или недействителен. Когда сам `managed-settings.json` не может быть прочитан, Claude Code всё ещё приостанавливает развёртку, если только [управляемый уровень](/docs/ru/managed-settings#how-claude-code-combines-managed-sources) не поставляет `cleanupPeriodDays` откуда-то ещё, например из параметров, управляемых сервером, или `managed-settings.d/` drop-in рядом с повреждённым файлом. Атрибуты счётчика удаления присутствуют только, когда `result` — это `"complete"`.

1324 1329 

1325**Имя события**: `claude_code.retention_sweep`1330**Имя события**: `claude_code.retention_sweep`

1326 1331 


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

1330* `event.name`: `"retention_sweep"`1335* `event.name`: `"retention_sweep"`

1331* `event.timestamp`: Временная метка ISO 86011336* `event.timestamp`: Временная метка ISO 8601

1332* `event.sequence`: счетчик для каждого процесса для упорядочивания событий, описанный в разделе [Атрибуты корреляции событий](#event-correlation-attributes)1337* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

1333* `result`: `"complete"` когда очистка запустилась, `"skipped"` когда Claude Code приостановил ее1338* `result`: `"complete"`, когда развёртка работала, `"skipped"`, когда Claude Code её приостановил

1334* `period_days`: Значение `cleanupPeriodDays` из объединенных параметров, в днях, или `30` когда ни один источник его не устанавливает. На пропущенных событиях значение, которое очистка использовала бы, вычисленное из источников параметров, которые Claude Code мог прочитать1339* `period_days`: Значение `cleanupPeriodDays` из объединённых параметров, в днях, или `30`, когда ни один источник его не устанавливает. На пропущенных событиях значение, которое развёртка использовала бы, вычисленное из источников параметров, которые Claude Code мог прочитать

1335* `used_default`: `"true"` когда ни один читаемый источник параметров не устанавливает `cleanupPeriodDays`, `"false"` в противном случае. На завершенных событиях `"true"` означает, что применялось значение по умолчанию 30 дней1340* `used_default`: `"true"`, когда ни один читаемый источник параметров не устанавливает `cleanupPeriodDays`, `"false"` в противном случае. На полных событиях `"true"` означает, что применялось значение по умолчанию 30 дней

1336* `skip_reason`: Почему Claude Code приостановил очистку. Присутствует только когда `result` это `"skipped"`:1341* `skip_reason`: Почему Claude Code приостановил развёртку. Присутствует только, когда `result` — это `"skipped"`:

1337 * `"user_source_disabled"`: Параметры пользователя исключены, например флагом [`--setting-sources`](/docs/ru/cli-reference#cli-flags) или опцией SDK [`settingSources`](/docs/ru/agent-sdk/typescript#options), и ни один включенный источник не предоставляет `cleanupPeriodDays`1342 * `"user_source_disabled"`: Параметры пользователя исключены, например флагом [`--setting-sources`](/docs/ru/cli-reference#cli-flags) или опцией [`settingSources`](/docs/ru/agent-sdk/typescript#options) SDK, и ни один включённый источник не предоставляет `cleanupPeriodDays`

1338 * `"settings_unknowable"`: Файл параметров не может быть прочитан или разобран, поэтому `cleanupPeriodDays` или `desktopSessionCleanupPeriodDays` может быть установлен на значение, которое Claude Code не может видеть1343 * `"settings_unknowable"`: Файл параметров не мог быть прочитан или разобран, поэтому `cleanupPeriodDays` или `desktopSessionCleanupPeriodDays` может быть установлен на значение, которое Claude Code не может видеть

1339 * `"settings_invalid_key_set"`: Параметры имеют ошибки валидации и `cleanupPeriodDays` или `desktopSessionCleanupPeriodDays` явно установлены, поэтому возврат к значению по умолчанию может удалить или сохранить файлы против этого параметра1344 * `"settings_invalid_key_set"`: Параметры имеют ошибки валидации и `cleanupPeriodDays` или `desktopSessionCleanupPeriodDays` явно установлены, поэтому возврат к значению по умолчанию может удалить или сохранить файлы против этого параметра

1340* `transcripts_deleted`: Количество транскриптов сеансов, файлы верхнего уровня `~/.claude/projects/*/*.jsonl`, которые очистка удалила1345* `transcripts_deleted`: Количество стенограмм сеансов, файлы верхнего уровня `~/.claude/projects/*/*.jsonl`, которые развёртка удалила

1341* `transcripts_exempted_desktop`: Количество транскриптов, прошедших период удержания, которые очистка сохранила в соответствии с [правилом Claude Desktop и Cowork](/docs/ru/claude-directory#cleaned-up-automatically). Они не учитываются в `files_past_cutoff`. Требует Claude Code v2.1.248 или позже1346* `transcripts_exempted_desktop`: Количество стенограмм, прошедших период удержания, которые развёртка сохранила в соответствии с [правилом Claude Desktop и Cowork](/docs/ru/claude-directory#cleaned-up-automatically). Они не считаются в `files_past_cutoff`. Требуется Claude Code v2.1.248 или позже

1342* `session_files_deleted`: Количество артефактов, которые очистка файлов сеанса удалила: транскрипты плюс файлы-спутники для каждого сеанса, такие как sidecars, записи и результаты инструментов1347* `session_files_deleted`: Количество артефактов, которые развёртка файлов сеанса удалила: стенограммы плюс файлы-спутники на сеанс, такие как боковые панели, записи и результаты инструментов

1343* `artifacts_deleted`: Общее количество элементов, которые очистка удалила по всем каталогам данных, которые она охватывает, включая файлы сеанса. Некоторые очистки подсчитывают целое удаленное дерево каталогов как один элемент и несколько проходов очистки не вносят вклад в счетчик, поэтому рассматривайте значение как нижний предел, а не точный подсчет файлов1348* `artifacts_deleted`: Общее количество элементов, которые развёртка удалила во всех каталогах данных, которые она охватывает, включая файлы сеанса. Некоторые развёртки считают целое удалённое дерево каталогов как один элемент и несколько проходов очистки не способствуют счётчику, поэтому рассматривайте значение как нижний предел, а не точный подсчёт файлов

1344* `files_retained_fresh`: Файлы, проверенные и оставленные на месте, потому что они все еще находятся в пределах периода удержания. Только очистки для каждого файла подсчитывают эти, поэтому значение является нижним пределом; ненулевое значение является нормальным устойчивым состоянием1349* `files_retained_fresh`: Файлы, проверенные и оставленные на месте, потому что они всё ещё находятся в пределах периода удержания. Только развёртки на основе файлов считают эти, поэтому значение — это нижний предел; ненулевое значение — это нормальное устойчивое состояние

1345* `files_past_cutoff`: Файлы, старше чем период удержания, которые очистка не смогла удалить, например из-за ошибки разрешения или файла, удерживаемого открытым. Значение выше нуля означает, что файлы пережили настроенный период удержания; ноль не является доказательством того, что они не были, потому что неудачное удаление целого каталога учитывается в `error_count` вместо этого1350* `files_past_cutoff`: Файлы, старше чем период удержания, которые развёртка не удалась удалить, например из-за ошибки разрешения или файла, удерживаемого открытым. Значение выше нуля означает, что файлы пережили настроенный период удержания; ноль не является доказательством того, что они не были, потому что неудачное удаление целого каталога считается в `error_count` вместо этого

1346* `error_count`: Количество ошибок, которые очистка встретила при перечислении или удалении файлов1351* `error_count`: Количество ошибок, которые развёртка встретила при перечислении или удалении файлов

1347 1352 

1348<h4 id="managed-settings-resolved-event">1353<h4 id="managed-settings-resolved-event">

1349 Событие разрешения управляемых параметров1354 Событие разрешения управляемых параметров

1350</h4>1355</h4>

1351 1356 

1352Логируется с [управляемыми параметрами](/docs/ru/managed-settings), которые сеанс разрешил: один раз при запуске сеанса, снова когда либо управляемые параметры, либо состояние [помощника политики](/docs/ru/managed-settings#compute-the-policy-with-a-helper-program) изменяется во время сеанса, и когда Claude Code отказывает в запуске или завершает сеанс по одной из причин, которые список атрибутов `error.type`.1357Регистрируется с [управляемыми параметрами](/docs/ru/managed-settings), которые сеанс разрешил: один раз при запуске сеанса, снова когда либо управляемые параметры, либо состояние [помощника политики](/docs/ru/managed-settings#compute-the-policy-with-a-helper-program) изменяется во время сеанса, и когда Claude Code отказывает в запуске или завершает сеанс по одной из причин, которые атрибут `error.type` перечисляет.

1353Используйте это событие, чтобы найти машины, работающие на неожиданном управляемом источнике, машины, чей помощник политики не работает, и причину, по которой машина отказала в запуске.1358Используйте это событие, чтобы найти машины, работающие на неожиданном управляемом источнике, машины, чей помощник политики не работает, и причину, по которой машина отказала в запуске.

1354Требует Claude Code v2.1.274 или позже.1359Требуется Claude Code v2.1.274 или позже.

1355 1360 

1356По умолчанию событие содержит управляемые источники и состояние помощника политики, но не сами параметры. Чтобы добавить отредактированный атрибут `managed_settings.settings` и дайджест `managed_settings.resolved_sha256`, установите `OTEL_LOG_MANAGED_SETTINGS=1`:1361По умолчанию событие содержит управляемые источники и состояние помощника политики, но не сами параметры. Чтобы добавить редактируемый атрибут `managed_settings.settings` и дайджест `managed_settings.resolved_sha256`, установите `OTEL_LOG_MANAGED_SETTINGS=1`:

1357 1362 

1358* Установите его в блоке `env` управляемых параметров, параметров пользователя или `--settings`, или в окружении, в котором вы запускаете Claude Code. Значение в параметрах проекта или локальных параметрах не включает его, потому что клонированный репозиторий может их писать.1363* Установите его в блоке `env` управляемых параметров, параметров пользователя или `--settings`, или в окружении, в котором вы запускаете Claude Code. Значение в параметрах проекта или локальных параметрах не включает его, потому что клонированный репозиторий может их писать.

1359* Управляемые параметры сервера могут установить его без отображения [диалога одобрения безопасности](/docs/ru/server-managed-settings#security-approval-dialogs), потому что переменная только добавляет вашу собственную отредактированную политику организации к событию, которое ваша организация уже получает.1364* Параметры, управляемые сервером, могут установить его без показа [диалога одобрения безопасности](/docs/ru/server-managed-settings#security-approval-dialogs), потому что переменная только добавляет вашу собственную редактируемую политику организации к событию, которое ваша организация уже получает.

1360 1365 

1361В интерактивном сеансе в папке, которую вы не [доверили](/docs/ru/permissions#what-runs-before-you-trust-a-folder), Claude Code не экспортирует событие отказа, потому что параметры проекта и локальные параметры могут указать экспорт на другой сборщик перед доверием.1366В интерактивном сеансе в папке, которую вы не [доверили](/docs/ru/permissions#what-runs-before-you-trust-a-folder), Claude Code не экспортирует событие отказа, потому что параметры проекта и локальные параметры могут указать экспорт на другой сборщик перед доверием.

1362 1367 


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

1368* `event.name`: `"managed_settings_resolved"`1373* `event.name`: `"managed_settings_resolved"`

1369* `event.timestamp`: Временная метка ISO 86011374* `event.timestamp`: Временная метка ISO 8601

1370* `event.sequence`: счетчик для каждого процесса для упорядочивания событий, описанный в разделе [Атрибуты корреляции событий](#event-correlation-attributes)1375* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

1371* `managed_settings.trigger`: `"startup"` для события запуска сеанса, `"change"` когда управляемые параметры или состояние помощника политики изменились позже в сеансе, или `"refused"` когда политика управляемых параметров остановила сеанс. Claude Code отправляет событие `change` только когда атрибут отличается от последнего события, которое он отправил, и измененное значение параметра считается даже когда `OTEL_LOG_MANAGED_SETTINGS` отключен1376* `managed_settings.trigger`: `"startup"` для события запуска сеанса, `"change"`, когда управляемые параметры или состояние помощника политики изменились позже в сеансе, или `"refused"`, когда политика управляемых параметров остановила сеанс. Claude Code отправляет событие `change` только, когда атрибут отличается от последнего события, которое он отправил, и изменённое значение параметра считается даже когда `OTEL_LOG_MANAGED_SETTINGS` отключен

1372* `error.type`: почему Claude Code остановил сеанс. Присутствует только на событиях `refused`:1377* `error.type`: почему Claude Code остановил сеанс. Присутствует только на событиях `refused`:

1373 * `"helper_failed"`: [запуск помощника политики не удался](/docs/ru/settings-reference#helper-failures)1378 * `"helper_failed"`: [запуск помощника политики не удался](/docs/ru/settings-reference#helper-failures)

1374 * `"policy_invalid"`: управляемые параметры содержат ошибку, которая останавливает Claude Code от запуска, или источник администратора не удалось загрузить, поэтому Claude Code не может проверить принудительное входа организации1379 * `"policy_invalid"`: управляемые параметры содержат ошибку, которая останавливает Claude Code от запуска, или источник администратора не удалось загрузить, поэтому Claude Code не может проверить принудительное входа организации

1375 * `"consent_rejected"`: пользователь отклонил [диалог одобрения безопасности](/docs/ru/server-managed-settings#security-approval-dialogs) для управляемых параметров сервера1380 * `"consent_rejected"`: пользователь отклонил [диалог одобрения безопасности](/docs/ru/server-managed-settings#security-approval-dialogs) для параметров, управляемых сервером

1376 * `"force_refresh_failed"`: выборка параметров, которую требует [`forceRemoteSettingsRefresh`](/docs/ru/settings-reference#forceremotesettingsrefresh), не удалась1381 * `"force_refresh_failed"`: выборка параметров, которую требует [`forceRemoteSettingsRefresh`](/docs/ru/settings-reference#forceremotesettingsrefresh), не удалась

1377 * `"gateway_rejected"`: [Claude apps gateway](/docs/ru/claude-apps-gateway) ответил на загрузку управляемых параметров с HTTP 4031382 * `"gateway_rejected"`: [шлюз приложений Claude](/docs/ru/claude-apps-gateway) ответил на загрузку управляемых параметров с HTTP 403

1378 * `"version_below_minimum"`: эта версия Claude Code ниже [`requiredMinimumVersion`](/docs/ru/settings-reference#requiredminimumversion) или выше [`requiredMaximumVersion`](/docs/ru/settings-reference#requiredmaximumversion)1383 * `"version_below_minimum"`: эта версия Claude Code ниже [`requiredMinimumVersion`](/docs/ru/settings-reference#requiredminimumversion) или выше [`requiredMaximumVersion`](/docs/ru/settings-reference#requiredmaximumversion)

1379 * `"_OTHER"`: загрузка управляемых параметров Claude apps gateway не удалась по другой причине1384 * `"_OTHER"`: загрузка управляемых параметров шлюза приложений Claude не удалась по другой причине

1380* `managed_settings.sources`: каждый управляемый источник, который доставляет как минимум один [ключ политики](/docs/ru/managed-settings#how-claude-code-combines-managed-sources), наивысший приоритет первым, включая источники, чьи ключи не вступают в силу в `first-wins`. Значения это `"remote"`, `"plist"` или `"hklm"` для политики MDM или уровня ОС, `"file"` для управляемых файлов параметров и drop-ins, `"parent"` когда [хост встраивания](/docs/ru/managed-settings#let-an-embedding-host-add-policy) поставляет параметры, и `"hkcu"` для [значения реестра Windows HKCU](/docs/ru/managed-settings#where-each-mechanism-stores-the-policy) когда Claude Code [читает его](/docs/ru/managed-settings#how-claude-code-combines-managed-sources). Источник, который содержит только ключи управления, или который Claude Code не мог прочитать, не указан. Выдается как массив строк, пусто когда ни один управляемый источник не доставляет ключ политики1385* `managed_settings.sources`: каждый управляемый источник, который доставляет как минимум один [ключ политики](/docs/ru/managed-settings#how-claude-code-combines-managed-sources), в порядке приоритета от высшего к низшему, включая источники, чьи ключи не вступают в силу в соответствии с `first-wins`. Значения — это `"remote"`, `"plist"` или `"hklm"` для политики MDM или уровня ОС, `"file"` для файлов управляемых параметров и drop-ins, `"parent"`, когда [хост встраивания](/docs/ru/managed-settings#let-an-embedding-host-add-policy) поставляет параметры, и `"hkcu"` для [значения реестра Windows HKCU](/docs/ru/managed-settings#where-each-mechanism-stores-the-policy), когда Claude Code [его читает](/docs/ru/managed-settings#how-claude-code-combines-managed-sources). Источник, который содержит только ключи управления, или который Claude Code не мог прочитать, не указывается. Выпускается как массив строк, пусто, когда ни один управляемый источник не доставляет ключ политики

1381* `managed_settings.source_behavior`: значение [`managedSourcesBehavior`](/docs/ru/settings-reference#managedsourcesbehavior), которое Claude Code прочитал, `"first-wins"` или `"merge"`. `"first-wins"` когда ни один источник не устанавливает ключ1386* `managed_settings.source_behavior`: значение [`managedSourcesBehavior`](/docs/ru/settings-reference#managedsourcesbehavior), которое Claude Code прочитал, `"first-wins"` или `"merge"`. `"first-wins"`, когда ни один источник не устанавливает ключ

1382* `managed_settings.helper.state`: состояние помощника политики, который выбранный источник MDM или файла настраивает:1387* `managed_settings.helper.state`: состояние помощника политики, который выбранный источник MDM или файла настраивает:

1383 * `"ok"`: выход помощника служит управляемыми параметрами1388 * `"ok"`: выход помощника служит управляемыми параметрами

1384 * `"bad_path"`, `"not_a_file"`, `"exit_nonzero"`, `"timed_out"`, `"oversize"`, `"parse_failed"`, `"envelope_invalid"` или `"schema_rejected"`: последний запуск помощника не удался. [Сбои помощника](/docs/ru/settings-reference#helper-failures) описывает случаи1389 * `"bad_path"`, `"not_a_file"`, `"exit_nonzero"`, `"timed_out"`, `"oversize"`, `"parse_failed"`, `"envelope_invalid"` или `"schema_rejected"`: последний запуск помощника не удался. [Сбои помощника](/docs/ru/settings-reference#helper-failures) описывает случаи

1385 * `"none"`: помощник не настроен, или источник, который его настраивает, не является политикой MDM или файлом управляемых параметров1390 * `"none"`: помощник не настроен, или источник, который его настраивает, не является политикой MDM или файлом управляемых параметров

1386* `managed_settings.helper.applied`: `"output"` пока выход помощника служит управляемыми параметрами, `"none"` когда он не служит1391* `managed_settings.helper.applied`: `"output"`, пока выход помощника служит управляемыми параметрами, `"none"`, когда он не служит

1387* `managed_settings.helper.entry`: `"policyHelper"` когда Claude Code выбрал [`policyHelper`](/docs/ru/settings-reference#policyhelper). Отсутствует когда он выбрал помощника1392* `managed_settings.helper.entry`: `"policyHelper"`, когда Claude Code выбрал [`policyHelper`](/docs/ru/settings-reference#policyhelper). Отсутствует, когда он не выбрал помощника

1388* `managed_settings.helper.path`: путь помощника [`path`](/docs/ru/settings-reference#policyhelper-path). Присутствует всякий раз, когда Claude Code выбрал помощника, независимо от того, установлен ли `OTEL_LOG_MANAGED_SETTINGS`1393* `managed_settings.helper.path`: настроенный [`path`](/docs/ru/settings-reference#policyhelper-path) помощника. Присутствует, когда Claude Code выбрал помощника, независимо от того, установлено ли `OTEL_LOG_MANAGED_SETTINGS`

1389* `managed_settings.resolved_sha256` (когда `OTEL_LOG_MANAGED_SETTINGS=1`): SHA-256 разрешенных управляемых параметров перед редактированием, сериализованный как JSON с ключами, отсортированными рекурсивно и без пробелов. Машины с одинаковым дайджестом запускают одну и ту же политику. Claude Code отправляет дайджест только с opt-in, потому что короткая политика может быть восстановлена путем хеширования предположений. Отсутствует когда управляемые параметры не разрешены, и на событиях `refused`1394* `managed_settings.resolved_sha256` (когда `OTEL_LOG_MANAGED_SETTINGS=1`): SHA-256 разрешённых управляемых параметров перед редактированием, сериализованных как JSON с ключами, отсортированными рекурсивно и без пробелов. Машины с одинаковым дайджестом работают с одной и той же политикой. Claude Code отправляет дайджест только с opt-in, потому что короткая политика может быть восстановлена путём хеширования предположений. Отсутствует, когда управляемые параметры не разрешены, и на событиях `refused`

1390* `managed_settings.settings` (когда `OTEL_LOG_MANAGED_SETTINGS=1`): имена и форма разрешенных управляемых параметров как JSON строка, с отредактированными значениями. Отсутствует на событиях `refused`. Claude Code строит его из своей схемы параметров:1395* `managed_settings.settings` (когда `OTEL_LOG_MANAGED_SETTINGS=1`): имена и форма разрешённых управляемых параметров как строка JSON, с редактируемыми значениями. Отсутствует на событиях `refused`. Claude Code строит его из своей схемы параметров:

1391 1396 

1392 * Имя параметра, которое схема объявляет, экспортируется, и ключ, который она не объявляет, опускается1397 * Имя параметра, которое схема объявляет, экспортируется, и ключ, который она не объявляет, опускается

1393 * Логические значения, числа и строковые значения, которые схема ограничивает фиксированным набором опций, такие как `permissions.defaultMode`, экспортируются как есть. `sandbox.network.httpProxyPort` и `sandbox.network.socksProxyPort` экспортируются как `"[REDACTED]"`1398 * Логические значения, числа и строковые значения, которые схема ограничивает фиксированным набором опций, такие как `permissions.defaultMode`, экспортируются как есть. `sandbox.network.httpProxyPort` и `sandbox.network.socksProxyPort` экспортируются как `"[REDACTED]"`

1394 * Каждая другая строка, такая как `model`, `apiKeyHelper`, каждое значение `env`, каждый URL и каждая команда, экспортируется как `"[REDACTED]"`1399 * Каждая другая строка, такая как `model`, `apiKeyHelper`, каждое значение `env`, каждый URL и каждая команда, экспортируется как `"[REDACTED]"`

1395 * Имена записей карт, такие как имена переменных `env` и ID плагинов, экспортируются как есть. Параметр, чьи записи схема не типирует, такой как `vimInsertModeRemaps`, экспортируется как одно `"[REDACTED]"`, и `sandbox.ignoreViolations` экспортируется как список его списков путей без шаблонов команд1400 * Имена записей карт, такие как имена переменных `env` и ID плагинов, экспортируются как есть. Параметр, чьи записи схема не типирует, такой как `vimInsertModeRemaps`, экспортируется как одиночный `"[REDACTED]"`, и `sandbox.ignoreViolations` экспортируется как список его списков путей без шаблонов команд

1396 * Список сохраняет свою длину, с каждой записью отредактированной по тем же правилам1401 * Список сохраняет свою длину, с каждой записью редактируемой по тем же правилам

1397 * Правило `permissions.allow`, `permissions.deny` или `permissions.ask` экспортируется как его имя инструмента с отредактированным содержимым, такой как `Read([REDACTED])`, когда инструмент встроен в эту версию Claude Code или является ссылкой `mcp__`, такой как `mcp__jira__create_issue`. Любое другое правило экспортируется как `"[REDACTED]"`1402 * Правило `permissions.allow`, `permissions.deny` или `permissions.ask` экспортируется как его имя инструмента с редактируемым содержанием, такое как `Read([REDACTED])`, когда инструмент встроен в эту версию Claude Code или является ссылкой `mcp__`, такой как `mcp__jira__create_issue`. Любое другое правило экспортируется как `"[REDACTED]"`

1398 * Hooks следуют тем же правилам, поэтому поля с фиксированными опциями и числовые поля, такие как `type` и `timeout`, показываются, пока каждая команда, URL, `matcher` и условие `if` экспортируется как `"[REDACTED]"`1403 * Hooks следуют тем же правилам, поэтому поля с фиксированными опциями и числовые поля, такие как `type` и `timeout`, показываются, пока каждая команда, URL, `matcher` и условие `if` экспортируются как `"[REDACTED]"`

1399 1404 

1400 Например, управляемые параметры с `apiKeyHelper`, двумя переменными `env` и правилом отказа экспортируются как `{"apiKeyHelper":"[REDACTED]","env":{"HTTPS_PROXY":"[REDACTED]","CLAUDE_CODE_ENABLE_TELEMETRY":"[REDACTED]"},"permissions":{"deny":["Read([REDACTED])"]}}`.1405 Например, управляемые параметры с `apiKeyHelper`, двумя переменными `env` и правилом запрета экспортируются как `{"apiKeyHelper":"[REDACTED]","env":{"HTTPS_PROXY":"[REDACTED]","CLAUDE_CODE_ENABLE_TELEMETRY":"[REDACTED]"},"permissions":{"deny":["Read([REDACTED])"]}}`.

1401 1406 

1402 Claude Code обрезает значение на 8 КБ UTF-8, и обрезанное значение не является действительным JSON1407 Claude Code обрезает значение на 8 КБ UTF-8, и обрезанное значение не является действительным JSON

1403* `managed_settings.settings_truncated` (когда `managed_settings.settings` присутствует): `true` когда Claude Code обрезал `managed_settings.settings` на 8 КБ, `false` в противном случае. Выдается как логическое значение, а не строка.1408* `managed_settings.settings_truncated` (когда `managed_settings.settings` присутствует): `true`, когда Claude Code обрезал `managed_settings.settings` на 8 КБ, `false` в противном случае. Выпускается как логическое значение, не строка

1404 1409 

1405<h2 id="interpret-metrics-and-events-data">1410<h2 id="interpret-metrics-and-events-data">

1406 Интерпретация данных метрик и событий1411 Интерпретация данных метрик и событий

Details

859 Фоновые автоматические обновления859 Фоновые автоматические обновления

860</h4>860</h4>

861 861 

862По умолчанию фоновое обновление отключает помощников учетных данных Git при проверке удаленного хранилища marketplace на предмет новых коммитов, поэтому проверка не может аутентифицироваться в частных репозиториях через HTTPS, даже если помощник настроен. Удаленные SSH не затронуты: ключ, загруженный в `ssh-agent`, аутентифицирует фоновую проверку так же, как команды, которые вы запускаете.862Фоновое обновление проверяет удаленное хранилище marketplace на предмет новых коммитов с помощью ваших настроенных помощников учетных данных Git, так же как команды, которые вы запускаете. Для удаленных SSH ключ, загруженный в `ssh-agent`, аутентифицирует проверку. Claude Code запускает проверку неинтерактивно: он отключает подсказки терминала Git и программы askpass, а также указывает помощникам учетных данных не выводить подсказки. Возможность проверки аутентифицироваться в частном репозитории через HTTPS зависит от вашего помощника:

863 863 

864Когда проверка находит новые коммиты или не удается, потому что не может достичь или аутентифицироваться на удаленном хранилище, Claude Code клонирует marketplace снова и заменяет новый клон. Если этот клон не удается, существующий checkout остается на месте. Повторное клонирование использует ваши сохраненные учетные данные Git, но оно может [истечь на больших репозиториях](#git-operations-time-out), поэтому автоматические обновления частного marketplace могут периодически не удаваться.864* Помощник, который может предоставить сохраненные учетные данные без подсказки, аутентифицирует проверку. Git Credential Manager, помощник macOS Keychain и `git-credential-store` работают таким образом, как только они содержат учетные данные для хоста.

865* Помощник, который должен вас попросить, не может ответить в фоновом режиме. Обновление не удается молча, и существующий checkout остается на месте, поэтому ваши плагины продолжают работать из последнего синхронизированного состояния. Запустите `/plugin marketplace update <name>`, чтобы обновить marketplace с вашими учетными данными.

866 

867Когда проверка находит checkout в актуальном состоянии, Claude Code оставляет его как есть. Когда проверка находит новые коммиты или не удается, потому что не может достичь или аутентифицироваться на удаленном хранилище, Claude Code клонирует marketplace снова и заменяет новый клон. Если этот клон не удается, существующий checkout остается на месте. Повторное клонирование может [истечь на больших репозиториях](#git-operations-time-out).

865 868 

866Два параметра делают частные marketplace предсказуемыми:869Два параметра делают частные marketplace предсказуемыми:

867 870 

868* Установите `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1`, чтобы сохранить существующий checkout без попытки повторного клонирования, когда фоновая проверка не может достичь или аутентифицироваться на удаленном хранилище. Ваши плагины продолжают работать из последнего синхронизированного состояния, и ручные обновления с `/plugin marketplace update` по-прежнему аутентифицируются с вашими учетными данными.871* Установите `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1`, чтобы сохранить существующий checkout без попытки повторного клонирования, когда фоновая проверка не может достичь или аутентифицироваться на удаленном хранилище. Ваши плагины продолжают работать из последнего синхронизированного состояния, и ручные обновления с `/plugin marketplace update` по-прежнему аутентифицируются с вашими учетными данными.

869* Настройте помощника учетных данных Git, например с помощью `gh auth setup-git` для GitHub, чтобы повторное клонирование могло аутентифицироваться без подсказок.872* Настройте помощника учетных данных Git, например с помощью `gh auth setup-git` для GitHub, чтобы фоновая проверка и повторное клонирование могли аутентифицироваться без подсказок.

870 873 

871Установка токена поставщика, такого как `GITHUB_TOKEN`, в вашей среде не включает фоновую аутентификацию сама по себе. Токены вступают в силу только через настроенного помощника учетных данных, например помощника CLI `gh`, который читает `GH_TOKEN` и `GITHUB_TOKEN`.874Установка токена поставщика, такого как `GITHUB_TOKEN`, в вашей среде не включает фоновую аутентификацию сама по себе. Токены вступают в силу только через настроенного помощника учетных данных, например помощника CLI `gh`, который читает `GH_TOKEN` и `GITHUB_TOKEN`.

872 875 

873Чтобы сама фоновая проверка аутентифицировалась через HTTPS, настройте глобальное переписывание URL Git. Переписывание встраивает токен в удаленный URL, поэтому оно вступает в силу, несмотря на то, что фоновая проверка отключает помощников учетных данных. Когда проверка находит checkout в актуальном состоянии, Claude Code пропускает повторное клонирование. Следующий пример переписывает URL репозитория marketplace, чтобы включить токен доступа:

874 

875```bash theme={null}

876git config --global url."https://x-access-token:YOUR_TOKEN@github.com/acme-corp/plugins".insteadOf "https://github.com/acme-corp/plugins"

877```

878 

879Ограничьте переписывание путем репозитория marketplace или организации. Переписывание, чья база является только хостом, применяется к каждому fetch и push к этому хосту на машине и переопределяет ваши обычные учетные данные, включая push в ваши собственные репозитории.

880 

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

882 

883| Поставщик | Форма переписанного URL |

884| :-------- | :---------------------------------------------------------------- |

885| GitHub | `https://x-access-token:YOUR_TOKEN@github.com/acme-corp/plugins` |

886| GitLab | `https://oauth2:YOUR_TOKEN@gitlab.com/acme-corp/plugins` |

887| Bitbucket | `https://x-token-auth:YOUR_TOKEN@bitbucket.org/acme-corp/plugins` |

888 

889Переписывание хранит токен в открытом виде в вашем gitconfig, поэтому используйте токен с доступом только для чтения к репозиторию marketplace.

890 

891<Note>876<Note>

892 В средах CI/CD настройте помощника учетных данных Git перед установкой плагинов из частных репозиториев. На GitHub Actions экспортируйте токен с доступом для чтения к репозиторию marketplace как `GH_TOKEN`, затем запустите `gh auth setup-git`. Токен рабочего процесса по умолчанию может получить доступ только к репозиторию самого рабочего процесса, поэтому частный marketplace в другом репозитории требует личного токена доступа или токена приложения.877 В средах CI/CD настройте помощника учетных данных Git перед установкой плагинов из частных репозиториев. На GitHub Actions экспортируйте токен с доступом для чтения к репозиторию marketplace как `GH_TOKEN`, затем запустите `gh auth setup-git`. Токен рабочего процесса по умолчанию может получить доступ только к репозиторию самого рабочего процесса, поэтому частный marketplace в другом репозитории требует личного токена доступа или токена приложения.

893 

894 Если вы настроите глобальное переписывание URL в конвейере, переписывание также аутентифицирует фоновую проверку напрямую.

895</Note>878</Note>

896 879 

897<h3 id="distribute-through-organization-settings">880<h3 id="distribute-through-organization-settings">


1158 1141 

1159Точное сопоставление списка разрешений рассматривает URL, которые отличаются только конечной косой чертой, суффиксом `.git` или схемой `ssh://` и `https://` как разные значения. Если marketplace вашей организации можно клонировать более чем одной формой URL, предпочтите запись `hostPattern` буквальному URL, чтобы формы `https://`, `ssh://` и `user@host:path` все совпадали.1142Точное сопоставление списка разрешений рассматривает URL, которые отличаются только конечной косой чертой, суффиксом `.git` или схемой `ssh://` и `https://` как разные значения. Если marketplace вашей организации можно клонировать более чем одной формой URL, предпочтите запись `hostPattern` буквальному URL, чтобы формы `https://`, `ssh://` и `user@host:path` все совпадали.

1160 1143 

1161A [marketplace hosted on claude.ai](/docs/ru/discover-plugins#add-from-claude-ai) is matched by host: a `hostPattern` entry that matches `claude.ai` governs it, in `strictKnownMarketplaces` and in `blockedMarketplaces`. On the allowlist, such an entry doesn't admit a member's personal claude.ai uploads. Requires Claude Code v2.1.273 or later.1144Marketplace [размещенный на claude.ai](/docs/ru/discover-plugins#add-from-claude-ai) сопоставляется по хосту: запись `hostPattern`, которая совпадает с `claude.ai`, управляет им в `strictKnownMarketplaces` и в `blockedMarketplaces`. В списке разрешений такая запись не допускает личные загрузки claude.ai члена. Требуется Claude Code v2.1.273 или позже.

1162 1145 

1163Поскольку `strictKnownMarketplaces` установлен в [управляемых параметрах](/docs/ru/managed-settings), отдельные пользователи и конфигурации проекта не могут переопределить эти ограничения.1146Поскольку `strictKnownMarketplaces` установлен в [управляемых параметрах](/docs/ru/managed-settings), отдельные пользователи и конфигурации проекта не могут переопределить эти ограничения.

1164 1147 


1620 1603 

1621Для фоновых автоматических обновлений:1604Для фоновых автоматических обновлений:

1622 1605 

1623* По умолчанию фоновые обновления отключают помощники учетных данных Git при проверке удаленного хоста на наличие новых коммитов, поэтому проверка не может аутентифицироваться через HTTPS. SSH удаленные хосты с загруженным ключом в `ssh-agent` все еще аутентифицируются1606* Фоновая проверка использует ваши настроенные помощники учетных данных Git, но никогда не запрашивает, поэтому ваш помощник должен иметь возможность ответить сохраненными учетными данными. SSH удаленные хосты с загруженным ключом в `ssh-agent` также аутентифицируются

1624* Когда проверка не может аутентифицироваться, Claude Code повторно клонирует marketplace с вашими сохраненными учетными данными, но повторное клонирование может истечь по времени на больших репозиториях1607* Если ваш помощник должен вас запросить, фоновое обновление не удается молча и существующий checkout остается на месте. Сначала войдите в ваш помощник, чтобы он содержал учетные данные для хоста. Для GitHub запустите `gh auth login`, затем `gh auth setup-git`

1608* Когда проверка находит новые коммиты или не может достичь или аутентифицироваться на удаленном хосте, Claude Code повторно клонирует marketplace с теми же учетными данными. Повторное клонирование может истечь по времени на больших репозиториях

1625* Установите `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1`, чтобы сохранить существующий checkout без попытки повторного клонирования, когда фоновая проверка не может достичь или аутентифицироваться на удаленном хосте1609* Установите `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1`, чтобы сохранить существующий checkout без попытки повторного клонирования, когда фоновая проверка не может достичь или аутентифицироваться на удаленном хосте

1626* Настройте помощник учетных данных Git, например `gh auth setup-git`, чтобы повторное клонирование могло аутентифицироваться

1627* Если повторное клонирование истекает по времени на большом репозитории, увеличьте лимит с помощью [`CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS`](#git-operations-time-out)1610* Если повторное клонирование истекает по времени на большом репозитории, увеличьте лимит с помощью [`CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS`](#git-operations-time-out)

1628* Настройте [переписывание URL Git](#private-repositories), ограниченное репозиторием marketplace, чтобы фоновая проверка аутентифицировалась напрямую

1629* Или обновляйте частные marketplace вручную с помощью `/plugin marketplace update <name>`, которая использует ваши учетные данные1611* Или обновляйте частные marketplace вручную с помощью `/plugin marketplace update <name>`, которая использует ваши учетные данные

1630 1612 

1613До v2.1.280 фоновая проверка запускалась без ваших помощников учетных данных и не могла аутентифицироваться на частных репозиториях через HTTPS.

1614 

1631<h3 id="marketplace-updates-fail-in-offline-environments">1615<h3 id="marketplace-updates-fail-in-offline-environments">

1632 Обновления marketplace не работают в автономных средах1616 Обновления marketplace не работают в автономных средах

1633</h3>1617</h3>

plugins.md +2 −0

Details

340 Чтобы протестировать plugin вместе с plugin, от которого он зависит, см. [Протестируйте plugin и его зависимость локально](/docs/ru/plugin-dependencies#test-a-plugin-and-its-dependency-locally).340 Чтобы протестировать plugin вместе с plugin, от которого он зависит, см. [Протестируйте plugin и его зависимость локально](/docs/ru/plugin-dependencies#test-a-plugin-and-its-dependency-locally).

341</Tip>341</Tip>

342 342 

343Чтобы загружать plugins в сеансе, где вы не можете добавить флаг, перечислите их абсолютные пути в переменной окружения [`CLAUDE_CODE_PLUGIN_DIRS`](/docs/ru/env-vars#variables). Claude Code загружает каждый путь так же, как загружает путь `--plugin-dir`. Эти plugins загружаются в дополнение к любым, которые вы передаёте с помощью `--plugin-dir`. [Параметры проекта и локальные параметры не могут устанавливать эту переменную](/docs/ru/settings-reference#variables-claude-code-ignores-in-env). `CLAUDE_CODE_PLUGIN_DIRS` требует Claude Code v2.1.280 или более поздней версии.

344 

343Попробовав plugin с `--plugin-dir`, вы узнаете, что он может работать. Чтобы узнать, как часто Claude на самом деле обращается к нему и получает правильный результат, запустите его против набора тестовых prompts с помощью [`claude plugin eval`](/docs/ru/plugin-evals). Каждый prompt запускается несколько раз с plugin и без него, поэтому вы можете увидеть, что вносит plugin, и поймать регрессии при его изменении или выпуске новой модели.345Попробовав plugin с `--plugin-dir`, вы узнаете, что он может работать. Чтобы узнать, как часто Claude на самом деле обращается к нему и получает правильный результат, запустите его против набора тестовых prompts с помощью [`claude plugin eval`](/docs/ru/plugin-evals). Каждый prompt запускается несколько раз с plugin и без него, поэтому вы можете увидеть, что вносит plugin, и поймать регрессии при его изменении или выпуске новой модели.

344 346 

345Чтобы загружать несколько plugins из одного места, передайте папку, которая их содержит, например `--plugin-dir ./plugins`. Загрузка папки plugins требует Claude Code v2.1.265 или более поздней версии. Claude Code читает верхний уровень папки, чтобы решить, какие plugins загружаются, и в интерактивном сеансе он также отслеживает папку на предмет последующих изменений:347Чтобы загружать несколько plugins из одного места, передайте папку, которая их содержит, например `--plugin-dir ./plugins`. Загрузка папки plugins требует Claude Code v2.1.265 или более поздней версии. Claude Code читает верхний уровень папки, чтобы решить, какие plugins загружаются, и в интерактивном сеансе он также отслеживает папку на предмет последующих изменений:

Details

37Два параметра не отображаются в таблице слоёв, но всё ещё влияют на то, что остаётся в кэше:37Два параметра не отображаются в таблице слоёв, но всё ещё влияют на то, что остаётся в кэше:

38 38 

39* **Model**: каждая модель имеет свой кэш. Переключение моделей пересчитывает весь запрос даже когда содержимое идентично. Подробнее см. в разделе [Переключение моделей](#switching-models) ниже.39* **Model**: каждая модель имеет свой кэш. Переключение моделей пересчитывает весь запрос даже когда содержимое идентично. Подробнее см. в разделе [Переключение моделей](#switching-models) ниже.

40* **Effort level**: на большинстве моделей каждый уровень усилий имеет свой кэш, поэтому изменение усилий во время сеанса пересчитывает весь запрос. На Fable 5.1 с API ключом или подпиской Claude кэш по умолчанию остаётся нетронутым. Подробнее см. в разделе [Изменение уровня усилий](#changing-effort-level) ниже.40* **Effort level**: на большинстве моделей каждый уровень усилий имеет свой кэш, поэтому изменение усилий во время сеанса пересчитывает весь запрос. На Opus 5.5 и Fable 5.1 с API ключом или подпиской Claude кэш по умолчанию остаётся нетронутым. Подробнее см. в разделе [Изменение уровня усилий](#changing-effort-level) ниже.

41 41 

42<Tip>42<Tip>

43 Выберите вашу модель и уровень усилий в начале сеанса, затем сохраните `/compact` для естественных перерывов между задачами. Чем меньше изменений вы делаете во время задачи, тем выше ваш процент попаданий в кэш.43 Выберите вашу модель и уровень усилий в начале сеанса, затем сохраните `/compact` для естественных перерывов между задачами. Чем меньше изменений вы делаете во время задачи, тем выше ваш процент попаданий в кэш.


106 106 

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

108 108 

109На Fable 5.1 с ключом API или подпиской Claude изменение усилий сохраняет кэш, и Claude Code применяет новый уровень без запроса. Это не применяется на Amazon Bedrock, платформе Google Cloud Agent Platform или [Claude apps gateway](/docs/ru/claude-apps-gateway), или когда вы установили [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/ru/llm-gateway-protocol#disable-pre-release-capabilities) или ваша организация имеет конфигурацию HIPAA.109На Opus 5.5 и Fable 5.1 с ключом API или подпиской Claude изменение усилий сохраняет кэш, и Claude Code применяет новый уровень без запроса. Это не применяется на Amazon Bedrock, платформе Google Cloud Agent Platform или [Claude apps gateway](/docs/ru/claude-apps-gateway), или когда вы установили [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/ru/llm-gateway-protocol#disable-pre-release-capabilities) или ваша организация имеет конфигурацию HIPAA.

110 110 

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

112 112 


367Производительность кэша отображается в виде двух подсчётов токенов, которые API сообщает в каждом ответе. Наиболее прямой способ отслеживать их в реальном времени — это [скрипт строки состояния](/docs/ru/statusline), который читает объект `current_usage`:367Производительность кэша отображается в виде двух подсчётов токенов, которые API сообщает в каждом ответе. Наиболее прямой способ отслеживать их в реальном времени — это [скрипт строки состояния](/docs/ru/statusline), который читает объект `current_usage`:

368 368 

369| Поле | Значение |369| Поле | Значение |

370| ----------------------------- | --------------------------------------------------------------------------------------------------- |370| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

371| `cache_creation_input_tokens` | Токены, записанные в кэш на этом ходу, выставляются по ставке записи в кэш |371| `cache_creation_input_tokens` | Токены, записанные в кэш на этом ходу, выставляются по ставке записи в кэш |

372| `cache_read_input_tokens` | Токены, обслуживаемые из кэша на этом ходу, выставляются примерно в 10% от стандартной ставки ввода |372| `cache_read_input_tokens` | Токены, обслуживаемые из кэша на этом ходу, выставляются по [кэшированной ставке токенов](https://platform.claude.com/docs/en/about-claude/pricing) модели, ниже стандартной ставки ввода |

373 373 

374Высокое соотношение чтения к созданию означает, что кэширование работает хорошо. Если создание остаётся высоким ход за ходом, что-то меняется в вашем префиксе. В разделе [действия, которые инвалидируют кэш](#actions-that-invalidate-the-cache) перечислены обычные причины.374Высокое соотношение чтения к созданию означает, что кэширование работает хорошо. Если создание остаётся высоким ход за ходом, что-то меняется в вашем префиксе. В разделе [действия, которые инвалидируют кэш](#actions-that-invalidate-the-cache) перечислены обычные причины.

375 375 

settings-reference.md +111 −112

Details

1194| `multiplier` | число больше 0 и не более 10 | Масштабирует каждую стоимость, которую вычисляет Claude Code, независимо от того, охватывает ли её строка `overrides`. Ниже 1 — скидка, выше 1 — надбавка |1194| `multiplier` | число больше 0 и не более 10 | Масштабирует каждую стоимость, которую вычисляет Claude Code, независимо от того, охватывает ли её строка `overrides`. Ниже 1 — скидка, выше 1 — надбавка |

1195| `overrides` | карта ID модели к объекту ставки с `input`, `output`, `cacheRead` и `cacheWrite`, каждый от 0 до 10000 | Ставки USD за миллион токенов для этой модели, все четыре обязательны. `cacheWrite` охватывает как пятиминутные, так и одночасовые записи кэша. См. [Какие модели применяет строка modelPricing](#which-models-a-modelpricing-row-applies-to) |1195| `overrides` | карта ID модели к объекту ставки с `input`, `output`, `cacheRead` и `cacheWrite`, каждый от 0 до 10000 | Ставки USD за миллион токенов для этой модели, все четыре обязательны. `cacheWrite` охватывает как пятиминутные, так и одночасовые записи кэша. См. [Какие модели применяет строка modelPricing](#which-models-a-modelpricing-row-applies-to) |

1196 1196 

1197Claude Code использует ставки строки ровно так, как вы их написали, без добавления надбавки быстрого режима или [ставки только для США](/docs/ru/about-claude/pricing). Если вы также установите `multiplier`, Claude Code применяет его поверх ставок строки. Claude Code удаляет строку со ставкой, которую он не может разобрать, или `multiplier`, который он не может разобрать, и сохраняет остальные; см. [Исправьте сломанный файл параметров](/docs/ru/settings#fix-a-broken-settings-file).1197Claude Code использует ставки строки ровно так, как вы их написали, без добавления надбавки быстрого режима или [ставки только для США](https://platform.claude.com/docs/en/about-claude/pricing). Если вы также установите `multiplier`, Claude Code применяет его поверх ставок строки. Claude Code удаляет строку со ставкой, которую он не может разобрать, или `multiplier`, который он не может разобрать, и сохраняет остальные; см. [Исправьте сломанный файл параметров](/docs/ru/settings#fix-a-broken-settings-file).

1198 1198 

1199<h4 id="which-models-a-modelpricing-row-applies-to">1199<h4 id="which-models-a-modelpricing-row-applies-to">

1200 Какие модели применяет строка `modelPricing`1200 Какие модели применяет строка `modelPricing`


1921}1921}

1922```1922```

1923 1923 

1924Claude Code применяет эти списки на границе песочницы ОС, поэтому они применяются к каждому подпроцессу, который запускает изолированная команда, такому как `kubectl`, `terraform` или `npm`, а не только к инструментам файлов Claude. Claude Code добавляет ваши [permission rules](/docs/ru/sandboxing#permission-rules) в те же списки: правила `Edit` allow и deny в `allowWrite` и `denyWrite`, правила `Read` deny в `denyRead` и правила `WebFetch(domain:...)` allow и deny в списки доменов [`network`](#sandbox-network).1924Claude Code применяет эти списки на границе песочницы ОС, поэтому они применяются к каждому подпроцессу, который запускает изолированная команда, такому как `kubectl`, `terraform` или `npm`. Claude Code добавляет ваши [permission rules](/docs/ru/sandboxing#permission-rules) в те же списки: правила `Edit` allow и deny в `allowWrite` и `denyWrite`, правила `Read` deny в `denyRead` и правила `WebFetch(domain:...)` allow и deny в списки доменов [`network`](#sandbox-network).

1925 1925 

1926Если не установлена управляемая блокировка, Claude Code объединяет каждый список во всех файлах параметров, которые загружает сеанс. [`allowManagedReadPathsOnly`](#sandbox-filesystem-allowmanagedreadpathsonly) ограничивает `allowRead` записями из управляемых параметров, а [`allowManagedDomainsOnly`](#sandbox-network-allowmanageddomainsonly) делает то же самое для разрешенных доменов.1926Если не установлена управляемая блокировка, Claude Code объединяет каждый список во всех файлах параметров, которые загружает сеанс. [`allowManagedReadPathsOnly`](#sandbox-filesystem-allowmanagedreadpathsonly) ограничивает `allowRead` записями из управляемых параметров, а [`allowManagedDomainsOnly`](#sandbox-network-allowmanageddomainsonly) делает то же самое для разрешенных доменов.

1927 1927 


4369 Plugins и skills4369 Plugins и skills

4370</h2>4370</h2>

4371 4371 

4372Включайте plugins, регистрируйте marketplaces, ограничивайте источники plugins, которые разрешены организации, и контролируйте, какие skills загружаются. Для установки и создания plugins см. [Plugins](/docs/ru/plugins).4372Включайте plugins, регистрируйте marketplaces, ограничивайте источники plugins, которые разрешены в вашей организации, и контролируйте, какие skills загружаются. Для установки и создания plugins см. [Plugins](/docs/ru/plugins).

4373 4373 

4374<h3 id="disablebundledskills">4374<h3 id="disablebundledskills">

4375 `disableBundledSkills`4375 `disableBundledSkills`

4376</h3>4376</h3>

4377 4377 

4378Отключите [skills](/docs/ru/skills) и workflows, включённые в Claude Code. Claude Code полностью удаляет bundled skills и workflows, в то время как встроенные команды, такие как `/init`, остаются доступными для ввода, но скрыты от модели.4378Отключите [skills](/docs/ru/skills) и workflows, включённые в Claude Code. Claude Code полностью удаляет встроенные skills и workflows, в то время как встроенные команды, такие как `/init`, остаются доступными для ввода, но скрыты от модели.

4379 4379 

4380* **Scope**: [`Any file`](#scopes)4380* **Scope**: [`Any file`](#scopes)

4381* **Type**: Boolean4381* **Type**: Boolean

4382 * `true`: Claude Code удаляет bundled skills и workflows и скрывает встроенные команды, такие как `/init`, от модели4382 * `true`: Claude Code удаляет встроенные skills и workflows и скрывает встроенные команды, такие как `/init`, от модели

4383 * `false`: bundled skills загружаются4383 * `false`: встроенные skills загружаются

4384* **Default**: не установлено, поэтому bundled skills загружаются4384* **Default**: не установлено, поэтому встроенные skills загружаются

4385* **Per-session overrides**: [`CLAUDE_CODE_DISABLE_BUNDLED_SKILLS`](/docs/ru/env-vars) установлено на `1` отключает bundled skills на одну сессию; какой бы из двух способов их ни отключил, другой не может их включить обратно4385* **Per-session overrides**: [`CLAUDE_CODE_DISABLE_BUNDLED_SKILLS`](/docs/ru/env-vars) установлено на `1` отключает встроенные skills на одну сессию; какой бы из двух способов их ни отключил, другой не сможет их включить обратно

4386 4386 

4387```json settings.json theme={null}4387```json settings.json theme={null}

4388{4388{


4390}4390}

4391```4391```

4392 4392 

4393Skills из plugins, `.claude/skills/` и `.claude/commands/` не затронуты. `/doctor` остаётся доступным для ввода, как встроенные команды; чтобы скрыть его, установите [`DISABLE_DOCTOR_COMMAND`](/docs/ru/env-vars) вместо этого.4393Skills из plugins, `.claude/skills/` и `.claude/commands/` не затрагиваются. `/doctor` остаётся доступным для ввода, как встроенные команды; чтобы скрыть его, установите [`DISABLE_DOCTOR_COMMAND`](/docs/ru/env-vars) вместо этого.

4394 4394 

4395<h3 id="disableskillshellexecution">4395<h3 id="disableskillshellexecution">

4396 `disableSkillShellExecution`4396 `disableSkillShellExecution`


4398 4398 

4399Отключите встроенное выполнение shell для `` !`...` `` и ` ```! ` блоков в [skills](/ru/skills) и пользовательских команд из источников user, project, plugin или additional-directory. Claude Code заменяет каждую команду на `[shell command execution disabled by policy]` вместо её выполнения.4399Отключите встроенное выполнение shell для `` !`...` `` и ` ```! ` блоков в [skills](/ru/skills) и пользовательских команд из источников user, project, plugin или additional-directory. Claude Code заменяет каждую команду на `[shell command execution disabled by policy]` вместо её выполнения.

4400 4400 

4401* **Scope**: [`Any file`](#scopes). `true` в managed settings не может быть переопределён на `false` в другом месте.4401* **Scope**: [`Any file`](#scopes). `true` в управляемых параметрах не может быть переопределён на `false` в другом месте.

4402* **Type**: Boolean4402* **Type**: Boolean

4403 * `true`: Claude Code заменяет каждую встроенную shell команду на `[shell command execution disabled by policy]` вместо её выполнения4403 * `true`: Claude Code заменяет каждую встроенную shell-команду на `[shell command execution disabled by policy]` вместо её выполнения

4404 * `false`: встроенный shell выполняется4404 * `false`: встроенный shell выполняется

4405* **Default**: не установлено, поэтому встроенный shell выполняется4405* **Default**: не установлено, поэтому встроенный shell выполняется

4406 4406 


4410}4410}

4411```4411```

4412 4412 

4413Bundled skills и skills, развёрнутые через managed settings, не затронуты.4413Встроенные skills и skills, развёрнутые через управляемые параметры, не затрагиваются.

4414 4414 

4415<h3 id="skilloverrides">4415<h3 id="skilloverrides">

4416 `skillOverrides`4416 `skillOverrides`

4417</h3>4417</h3>

4418 4418 

4419Скройте или свёрните [skill](/docs/ru/skills#override-skill-visibility-from-settings) без редактирования его `SKILL.md`. Claude Code применяет значение под именем каждого skill к списку skills, который видит Claude, и к вашему `/` автодополнению.4419Скройте или свёрните [skill](/docs/ru/skills#override-skill-visibility-from-settings) без редактирования его `SKILL.md`. Claude Code применяет значение под каждым именем skill к списку skills, который видит Claude, и к вашему `/` автодополнению.

4420 4420 

4421* **Scope**: [`Any file`](#scopes). Меню `/skills` записывает в `.claude/settings.local.json`.4421* **Scope**: [`Any file`](#scopes). Меню `/skills` записывает в `.claude/settings.local.json`.

4422* **Type**: объект, отображающий имя skill на одно из:4422* **Type**: object, отображающий имя skill на одно из:

4423 * `"on"`: Claude видит skill и вы можете ввести `/name`4423 * `"on"`: Claude видит skill и вы можете ввести `/name`

4424 * `"name-only"`: Claude видит skill только по имени без его описания4424 * `"name-only"`: Claude видит skill по имени без его описания

4425 * `"user-invocable-only"`: Claude не видит skill, но вы всё ещё можете ввести `/name`4425 * `"user-invocable-only"`: Claude не видит skill, но вы всё ещё можете ввести `/name`

4426 * `"off"`: Claude не видит skill и `/name` скрыт из автодополнения4426 * `"off"`: Claude не видит skill и `/name` скрыт от автодополнения

4427* **Default**: не установлено, поэтому каждый skill имеет значение `"on"`4427* **Default**: не установлено, поэтому каждый skill имеет значение `"on"`

4428 4428 

4429Этот пример перечисляет `legacy-context` для Claude только по имени и скрывает `deploy` от Claude и из автодополнения `/`:4429Этот пример отображает `legacy-context` Claude только по имени и скрывает `deploy` от Claude и от автодополнения `/`:

4430 4430 

4431```json settings.json theme={null}4431```json settings.json theme={null}

4432{4432{


4439 4439 

4440Переопределения не применяются к plugin skills, которыми вы управляете через `/plugin`.4440Переопределения не применяются к plugin skills, которыми вы управляете через `/plugin`.

4441 4441 

4442В managed settings и файлах, переданных с `--settings`, ключ на alias bundled skill, такой как `checkup` для `/doctor`, также применяется к skill; см. [как ключи alias объединяются с ключами на собственном имени skill](/docs/ru/skills#override-skill-visibility-from-settings).4442В управляемых параметрах и файлах, переданных с `--settings`, ключ на alias встроенного skill, такой как `checkup` для `/doctor`, также применяется к skill; см. [как ключи alias объединяются с ключами на собственном имени skill](/docs/ru/skills#override-skill-visibility-from-settings).

4443 4443 

4444<h3 id="syncclaudeaiskills">4444<h3 id="syncclaudeaiskills">

4445 `syncClaudeAiSkills`4445 `syncClaudeAiSkills`

4446</h3>4446</h3>

4447 4447 

4448Отключите загрузку [skills, которые вы включаете на claude.ai](/docs/ru/skills#how-synced-skills-behave). Claude Code загружает их в `~/.claude/skills/synced/` в [terminal sessions, где вы входите с вашей claude.ai учётной записью](/docs/ru/skills#where-synced-skills-load), интерактивных или non-interactive, и в Cowork и cloud сессиях. Установите `false`, чтобы остановить эту загрузку и скрыть skills, которые она уже синхронизировала. Claude Code соблюдает только `false`: `true` то же самое, что и не установлено, и не включает синхронизацию, где она иначе отключена.4448Отключите загрузку [skills, включённых для вашей учётной записи claude.ai](/docs/ru/skills#how-synced-skills-behave). Claude Code загружает их в `~/.claude/skills/synced/` в [сеансах терминала, где вы входите с вашей учётной записью claude.ai](/docs/ru/skills#where-synced-skills-load), интерактивных или неинтерактивных, а также в сеансах Cowork и cloud. Установите `false`, чтобы остановить эту загрузку и остановить загрузку skills, которые она уже синхронизировала. Claude Code учитывает только `false`: `true` то же самое, что и не установлено, и не включает синхронизацию там, где она иначе отключена.

4449 4449 

4450* **Scope**: [`User, local, or managed`](#scopes), и файлы, переданные с `--settings`. Репозиторий не может отключить это для вас.4450* **Scope**: [`User, local, or managed`](#scopes), и файлы, переданные с `--settings`. Репозиторий не может отключить её для вас.

4451* **Type**: Boolean4451* **Type**: Boolean

4452 * `false`: Claude Code прекращает загрузку синхронизированных skills и скрывает те, которые уже находятся в `~/.claude/skills/synced/`. В user или managed settings он также перемещает их в `~/.claude/skills/.trash/`4452 * `false`: Claude Code прекращает загрузку синхронизированных skills и прекращает загрузку тех, которые уже находятся в `~/.claude/skills/synced/`. В пользовательских или управляемых параметрах он также перемещает их в `~/.claude/skills/.trash/`

4453 * `true`: то же самое, что и не установлено4453 * `true`: то же самое, что и не установлено

4454* **Default**: не установлено, поэтому сессии, вошедшие с вашей claude.ai учётной записью, синхронизируют ваши skills4454* **Default**: не установлено, поэтому сеансы, вошедшие с вашей учётной записью claude.ai, синхронизируют ваши skills

4455 4455 

4456Этот пример предотвращает загрузку skills учётной записи машиной в любой сессии:4456Этот пример предотвращает загрузку skills учётной записи машиной в любом сеансе:

4457 4457 

4458```json settings.json theme={null}4458```json settings.json theme={null}

4459{4459{


4465 `syncClaudeAiPlugins`4465 `syncClaudeAiPlugins`

4466</h3>4466</h3>

4467 4467 

4468Отключите загрузку [plugins, которые вы включаете на claude.ai](/docs/ru/plugins-reference#synced-plugins). Claude Code загружает их в `~/.claude/plugins/synced/` в начале terminal sessions, где вы входите с вашей claude.ai учётной записью, и в Cowork и cloud сессиях, и загружает каждый как `<name>@synced`. Установите `false`, чтобы остановить эту загрузку и скрыть plugins, которые она уже синхронизировала. Claude Code соблюдает только `false`: `true` то же самое, что и не установлено, и не включает синхронизацию, где она иначе отключена. Требует Claude Code v2.1.273 или позже.4468Отключите загрузку [plugins, включённых для вашей учётной записи claude.ai](/docs/ru/plugins-reference#synced-plugins). Claude Code загружает их в `~/.claude/plugins/synced/` в начале сеансов терминала, где вы входите с вашей учётной записью claude.ai, а также в сеансах Cowork и cloud, и загружает каждый как `<name>@synced`. Установите `false`, чтобы остановить эту загрузку и остановить загрузку plugins, которые она уже синхронизировала. Claude Code учитывает только `false`: `true` то же самое, что и не установлено, и не включает синхронизацию там, где она иначе отключена. Требуется Claude Code v2.1.273 или позже.

4469 4469 

4470* **Scope**: [`User, local, or managed`](#scopes), и файлы, переданные с `--settings`. Репозиторий не может отключить это для вас.4470* **Scope**: [`User, local, or managed`](#scopes), и файлы, переданные с `--settings`. Репозиторий не может отключить её для вас.

4471* **Type**: Boolean4471* **Type**: Boolean

4472 * `false`: Claude Code прекращает загрузку синхронизированных plugins и скрывает те, которые уже находятся в `~/.claude/plugins/synced/`. В user или managed settings он также перемещает их в `~/.claude/plugins/.trash/`4472 * `false`: Claude Code прекращает загрузку синхронизированных plugins и прекращает загрузку тех, которые уже находятся в `~/.claude/plugins/synced/`. В пользовательских или управляемых параметрах он также перемещает их в `~/.claude/plugins/.trash/`

4473 * `true`: то же самое, что и не установлено4473 * `true`: то же самое, что и не установлено

4474* **Default**: не установлено, поэтому сессии, вошедшие с вашей claude.ai учётной записью, синхронизируют ваши plugins4474* **Default**: не установлено, поэтому сеансы, вошедшие с вашей учётной записью claude.ai, синхронизируют ваши plugins

4475 4475 

4476Чтобы отключить один синхронизированный plugin вместо всех, установите `"<name>@synced": false` в [`enabledPlugins`](#enabledplugins).4476Чтобы отключить один синхронизированный plugin вместо всех, установите `"<name>@synced": false` в [`enabledPlugins`](#enabledplugins).

4477 4477 

4478Этот пример предотвращает загрузку plugins учётной записи машиной в любой сессии:4478Этот пример предотвращает загрузку plugins учётной записи машиной в любом сеансе:

4479 4479 

4480```json settings.json theme={null}4480```json settings.json theme={null}

4481{4481{


4487 `allowedChannelPlugins`4487 `allowedChannelPlugins`

4488</h3>4488</h3>

4489 4489 

4490Выберите, какие [channel](/docs/ru/channels) plugins могут отправлять сообщения в сессии в вашей организации. Когда вы это установите, Claude Code использует ваш список вместо allowlist Anthropic по умолчанию; каждая запись называет plugin и marketplace, из которого он поступает.4490Выберите, какие [channel](/docs/ru/channels) plugins могут отправлять сообщения в сеансы в вашей организации. Когда вы это установите, Claude Code использует ваш список вместо списка разрешений Anthropic по умолчанию; каждая запись называет plugin и marketplace, из которого он поступает.

4491 4491 

4492* **Scope**: [`Managed`](#scopes)4492* **Scope**: [`Managed`](#scopes)

4493* **Type**: массив объектов, каждый с строками `marketplace` и `plugin`. Запись может быть вместо этого строкой `"plugin@marketplace"`, такой как `"telegram@claude-plugins-official"`, которую Claude Code рассматривает как эквивалентный объект. Форма строки требует Claude Code v2.1.267 или позже; более ранние версии отклоняют всё значение `allowedChannelPlugins`, когда оно содержит одну4493* **Type**: массив объектов, каждый с строками `marketplace` и `plugin`. Запись может быть вместо этого строкой `"plugin@marketplace"`, такой как `"telegram@claude-plugins-official"`, которую Claude Code рассматривает как эквивалентный объект. Форма строки требует Claude Code v2.1.267 или позже; более ранние версии отклоняют всё значение `allowedChannelPlugins`, когда оно содержит одну

4494* **Default**: не установлено, поэтому Claude Code использует allowlist Anthropic по умолчанию4494* **Default**: не установлено, поэтому Claude Code использует список разрешений Anthropic по умолчанию

4495 4495 

4496Этот пример включает channels и разрешает только Telegram plugin из официального marketplace Anthropic:4496Этот пример включает channels и разрешает только plugin Telegram из официального marketplace Anthropic:

4497 4497 

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

4499{4499{


4506 4506 

4507Пустой массив блокирует каждый channel plugin.4507Пустой массив блокирует каждый channel plugin.

4508 4508 

4509Этот ключ вступает в силу, когда channels проходят gate [`channelsEnabled`](#channelsenabled) для учётной записи: на Team и Enterprise планах, а также на Console учётных записях с managed settings, это означает `channelsEnabled: true`. См. [Restrict which channel plugins can run](/docs/ru/channels#restrict-which-channel-plugins-can-run).4509Этот ключ вступает в силу после того, как channels пройдут ворота [`channelsEnabled`](#channelsenabled) для учётной записи: на планах Team и Enterprise, а также на учётных записях Console с управляемыми параметрами, это означает `channelsEnabled: true`. См. [Ограничьте, какие channel plugins могут работать](/docs/ru/channels#restrict-which-channel-plugins-can-run).

4510 4510 

4511<h3 id="blockedmarketplaces">4511<h3 id="blockedmarketplaces">

4512 `blockedMarketplaces`4512 `blockedMarketplaces`

4513</h3>4513</h3>

4514 4514 

4515Блокируйте источники plugin marketplace для вашей организации. Claude Code проверяет blocklist при добавлении marketplace и при установке, обновлении, обновлении и автоматическом обновлении plugin, поэтому marketplace, который кто-то добавил до того, как вы установили политику, не может быть использован для получения plugins. Заблокированные источники проверяются перед загрузкой, поэтому они никогда не касаются файловой системы.4515Блокируйте источники plugin marketplace для вашей организации. Claude Code проверяет список блокировки при добавлении marketplace и при установке, обновлении, обновлении и автоматическом обновлении plugin, поэтому marketplace, который кто-то добавил до того, как вы установили политику, не может быть использован для получения plugins. Заблокированные источники проверяются перед загрузкой, поэтому они никогда не касаются файловой системы.

4516 4516 

4517* **Scope**: [`Managed`](#scopes)4517* **Scope**: [`Managed`](#scopes)

4518* **Type**: массив объектов источника marketplace в тех же формах, что и [`strictKnownMarketplaces`](#allowed-source-types)4518* **Type**: массив объектов источника marketplace в тех же формах, что и [`strictKnownMarketplaces`](#allowed-source-types)

4519* **Default**: не установлено, поэтому ни один marketplace не заблокирован4519* **Default**: не установлено, поэтому ни один marketplace не заблокирован

4520 4520 

4521Этот пример блокирует один GitHub репозиторий как источник marketplace:4521Этот пример блокирует один репозиторий GitHub как источник marketplace:

4522 4522 

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

4524{4524{


4528}4528}

4529```4529```

4530 4530 

4531Запись `github` может использовать [owner-wildcard form](#owner-wildcards) `"owner/*"` для блокирования каждого репозитория под этим GitHub owner, что требует Claude Code v2.1.223 или позже. Добавьте `{ "source": "skills-dir" }`, чтобы остановить загрузку Claude Code [`@skills-dir` plugins](/docs/ru/plugins-reference#skills-directory-plugins) из `~/.claude/skills/` без ограничения какого-либо marketplace. См. [Managed marketplace restrictions](/docs/ru/plugin-marketplaces#managed-marketplace-restrictions).4531Запись `github` может использовать [форму owner-wildcard](#owner-wildcards) `"owner/*"` для блокировки каждого репозитория под этим владельцем GitHub, что требует Claude Code v2.1.223 или позже. Добавьте `{ "source": "skills-dir" }`, чтобы остановить загрузку Claude Code [`@skills-dir` plugins](/docs/ru/plugins-reference#skills-directory-plugins) из `~/.claude/skills/` без ограничения какого-либо marketplace. См. [Управляемые ограничения marketplace](/docs/ru/plugin-marketplaces#managed-marketplace-restrictions).

4532 4532 

4533<h3 id="channelsenabled">4533<h3 id="channelsenabled">

4534 `channelsEnabled`4534 `channelsEnabled`

4535</h3>4535</h3>

4536 4536 

4537Разрешите [channels](/docs/ru/channels) для вашей организации. На claude.ai Team и Enterprise планах Claude Code блокирует channels до тех пор, пока вы не установите это на `true`. Для [Anthropic Console](/docs/ru/authentication#claude-console-authentication) учётных записей, которые аутентифицируются с помощью API key, channels разрешены по умолчанию. Если ваша организация развёртывает managed settings, Claude Code блокирует channels на этих учётных записях тоже до тех пор, пока вы не установите этот ключ на `true`.4537Разрешите [channels](/docs/ru/channels) для вашей организации. На планах claude.ai Team и Enterprise Claude Code блокирует channels до тех пор, пока вы не установите это на `true`. Для учётных записей [Anthropic Console](/docs/ru/authentication#claude-console-authentication), которые аутентифицируются с помощью API key, channels разрешены по умолчанию. Если ваша организация развёртывает управляемые параметры, Claude Code блокирует channels на этих учётных записях до тех пор, пока вы не установите этот ключ на `true`.

4538 4538 

4539* **Scope**: [`Managed`](#scopes)4539* **Scope**: [`Managed`](#scopes)

4540* **Type**: Boolean4540* **Type**: Boolean

4541 * `true`: Claude Code разрешает channels для вашей организации4541 * `true`: Claude Code разрешает channels для вашей организации

4542 * `false`: то же самое, что и не установлено; блокируются ли channels, зависит от вашего плана, как говорит Default4542 * `false`: то же самое, что и не установлено; разрешены ли channels, зависит от вашего плана, как говорит Default

4543* **Default**: не установлено; channels блокируются на Team и Enterprise планах и на Console учётных записях с managed settings, и разрешены на Pro и Max планах и на Console учётных записях без managed settings4543* **Default**: не установлено; channels блокированы на планах Team и Enterprise и на учётных записях Console с управляемыми параметрами, и разрешены на планах Pro и Max и на учётных записях Console без управляемых параметров

4544 4544 

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

4546{4546{


4554 `disableCommandPluginSources`4554 `disableCommandPluginSources`

4555</h3>4555</h3>

4556 4556 

4557Блокируйте [`command` plugin source](/docs/ru/plugin-marketplaces#command-sources), который устанавливает plugin путём запуска объявленной marketplace команды на машине пользователя. Когда вы установите это на `true`, Claude Code никогда не запускает команду, не устанавливает и не обновляет command-sourced plugins, и прекращает загрузку уже установленных. Установите на `false`, чтобы явно разрешить их. Когда бы он ни блокировал command sources, установите ли вы на `true` или оставьте не установленным под [`allowManagedHooksOnly`](#allowmanagedhooksonly), он также блокирует marketplace [`headersHelper` commands](/docs/ru/plugin-marketplaces#authenticate-archive-downloads), кроме marketplace, который сами managed settings объявляют. Требует Claude Code v2.1.229 или позже, и блокировка `headersHelper` требует v2.1.238 или позже.4557Блокируйте [источник `command` plugin](/docs/ru/plugin-marketplaces#command-sources), который устанавливает plugin путём выполнения команды, объявленной marketplace, на машине пользователя. Когда вы установите это на `true`, Claude Code никогда не выполняет команду, не устанавливает и не обновляет plugins из command sources, и прекращает загрузку уже установленных. Установите на `false`, чтобы явно разрешить их. Всякий раз, когда он блокирует command sources, независимо от того, установили ли вы это на `true` или оставили не установленным под [`allowManagedHooksOnly`](#allowmanagedhooksonly), он также блокирует marketplace [`headersHelper` commands](/docs/ru/plugin-marketplaces#authenticate-archive-downloads), кроме marketplace, который сами управляемые параметры объявляют. Требуется Claude Code v2.1.229 или позже, и блокировка `headersHelper` требует v2.1.238 или позже.

4558 4558 

4559* **Scope**: [`Managed`](#scopes)4559* **Scope**: [`Managed`](#scopes)

4560* **Type**: Boolean4560* **Type**: Boolean

4561 * `true`: Claude Code никогда не запускает объявленную marketplace команду, не устанавливает и не обновляет command-sourced plugins, и прекращает загрузку уже установленных4561 * `true`: Claude Code никогда не выполняет команду, объявленную marketplace, не устанавливает и не обновляет plugins из command sources, и прекращает загрузку уже установленных

4562 * `false`: Claude Code явно разрешает command-sourced plugins4562 * `false`: Claude Code явно разрешает plugins из command sources

4563* **Default**: не установлено, поэтому Claude Code следует [`allowManagedHooksOnly`](#allowmanagedhooksonly): организация, которая ограничивает выполнение hook только managed settings, также получает отключённые command sources4563* **Default**: не установлено, поэтому Claude Code следует [`allowManagedHooksOnly`](#allowmanagedhooksonly): организация, которая ограничивает выполнение hook только управляемыми параметрами, также получает отключённые command sources

4564 4564 

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

4566{4566{


4568}4568}

4569```4569```

4570 4570 

4571Требует Claude Code v2.1.229 или позже.4571Требуется Claude Code v2.1.229 или позже.

4572 4572 

4573<h3 id="pluginsuggestionmarketplaces">4573<h3 id="pluginsuggestionmarketplaces">

4574 `pluginSuggestionMarketplaces`4574 `pluginSuggestionMarketplaces`

4575</h3>4575</h3>

4576 4576 

4577Назовите marketplaces, чьи plugins могут появляться как контекстные предложения установки, в советах spinner и закреплённые в верхней части вкладки `/plugin` **Discover**. Встроенный первый совет по дизайну frontend не затронут. Предложения поступают из объявления `relevance` каждого plugin в его записи marketplace.4577Назовите marketplaces, чьи plugins могут появляться как контекстные предложения установки, в советах spinner и закреплённые в верхней части вкладки `/plugin` **Discover**. Встроенный совет first-party frontend-design не затрагивается. Предложения поступают из объявления `relevance` каждого plugin в его записи marketplace.

4578 4578 

4579* **Scope**: [`Managed`](#scopes)4579* **Scope**: [`Managed`](#scopes)

4580* **Type**: массив имён marketplace4580* **Type**: массив имён marketplace


4586}4586}

4587```4587```

4588 4588 

4589Имя вступает в силу только когда marketplace зарегистрирован на машине и его зарегистрированный источник также объявлен в тех же managed settings, либо как запись [`extraKnownMarketplaces`](#extraknownmarketplaces) для этого имени, либо как запись [`strictKnownMarketplaces`](#strictknownmarketplaces). Claude Code игнорирует marketplace, зарегистрированный из другого источника под allowlisted именем. Официальный marketplace освобождён от требования источника: allowlisting только его имени достаточно, так как это имя может регистрироваться только из официального источника Anthropic. См. [Suggest plugins by context](/docs/ru/plugin-relevance).4589Имя вступает в силу только когда marketplace зарегистрирован на машине и его зарегистрированный источник также объявлен в тех же управляемых параметрах, либо как запись [`extraKnownMarketplaces`](#extraknownmarketplaces) для этого имени, либо как запись [`strictKnownMarketplaces`](#strictknownmarketplaces). Claude Code игнорирует marketplace, зарегистрированный из другого источника под разрешённым именем. Официальный marketplace освобождён от требования источника: разрешение только его имени достаточно, так как это имя может регистрироваться только из официального источника Anthropic. См. [Предложите plugins по контексту](/docs/ru/plugin-relevance).

4590 4590 

4591<h3 id="plugintrustmessage">4591<h3 id="plugintrustmessage">

4592 `pluginTrustMessage`4592 `pluginTrustMessage`


4608 `strictKnownMarketplaces`4608 `strictKnownMarketplaces`

4609</h3>4609</h3>

4610 4610 

4611Ограничьте, какие источники plugin marketplace люди в вашей организации могут добавлять и устанавливать plugins из. Claude Code применяет allowlist при добавлении marketplace и при установке, обновлении, обновлении и автоматическом обновлении plugin, перед любой сетевой или файловой операцией, поэтому marketplace, который кто-то добавил до того, как вы установили политику, не может быть использован для получения plugins, как только его источник больше не совпадает. Заблокированные пользователи видят ошибку, называющую managed политику.4611Ограничьте, какие источники plugin marketplace люди в вашей организации могут добавлять и устанавливать plugins из. Claude Code применяет список разрешений при добавлении marketplace и при установке, обновлении, обновлении и автоматическом обновлении plugin, перед любой сетевой или файловой операцией, поэтому marketplace, который кто-то добавил до того, как вы установили политику, не может быть использован для получения plugins после того, как его источник больше не совпадает. Заблокированные пользователи видят ошибку, называющую управляемую политику.

4612 4612 

4613* **Scope**: [`Managed`](#scopes)4613* **Scope**: [`Managed`](#scopes)

4614* **Type**: массив объектов источника marketplace; см. [Allowed source types](#allowed-source-types)4614* **Type**: массив объектов источника marketplace; см. [Allowed source types](#allowed-source-types)

4615* **Default**: не установлено, поэтому пользователи могут добавлять любой marketplace. Пустой массив — это полная блокировка, которая блокирует каждый источник marketplace, включая официальный marketplace Anthropic4615* **Default**: не установлено, поэтому пользователи могут добавлять любой marketplace. Пустой массив — это полная блокировка, которая блокирует каждый источник marketplace, включая официальный marketplace Anthropic

4616 4616 

4617Этот пример разрешает два GitHub репозитория, один закреплённый на ref `v2.0`, и один размещённый URL `marketplace.json`:4617Этот пример разрешает два репозитория GitHub, один закреплённый на ref `v2.0`, и один размещённый URL `marketplace.json`:

4618 4618 

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

4620{4620{


4626}4626}

4627```4627```

4628 4628 

4629Вы также можете написать этот ключ как `allowedMarketplaces`; [Marketplace key aliases](#marketplace-key-aliases) описывает, как Claude Code рассматривает alias и какая версия его принимает. Этот ключ — это policy gate: он контролирует, что пользователи могут добавлять, но ничего не регистрирует. Чтобы ограничить и предварительно зарегистрировать в одном файле, см. [Combine with `extraKnownMarketplaces`](#combine-with-extraknownmarketplaces). Для пользовательского представления см. [Managed marketplace restrictions](/docs/ru/plugin-marketplaces#managed-marketplace-restrictions).4629Вы также можете написать этот ключ как `allowedMarketplaces`; [Marketplace key aliases](#marketplace-key-aliases) описывает, как Claude Code рассматривает alias и какая версия его принимает. Этот ключ — это ворота политики: он контролирует, что пользователи могут добавлять, но ничего не регистрирует. Чтобы ограничить и предварительно зарегистрировать в одном файле, см. [Объедините с `extraKnownMarketplaces`](#combine-with-extraknownmarketplaces). Для представления, обращённого к пользователю, см. [Управляемые ограничения marketplace](/docs/ru/plugin-marketplaces#managed-marketplace-restrictions).

4630 4630 

4631<h4 id="allowed-source-types">4631<h4 id="allowed-source-types">

4632 Allowed source types4632 Allowed source types

4633</h4>4633</h4>

4634 4634 

4635Каждая запись ниже показывает одну запись allowlist на тип источника и поля, которые она принимает. Большинство типов совпадают точно; `hostPattern` и `pathPattern` совпадают по regex, и записи `github` могут использовать [owner wildcard](#owner-wildcards).4635Каждая запись ниже показывает одну запись списка разрешений на тип источника и поля, которые она принимает. Большинство типов совпадают точно; `hostPattern` и `pathPattern` совпадают по regex, и записи `github` могут использовать [owner wildcard](#owner-wildcards).

4636 4636 

4637| Source | Example entry | Fields |4637| Source | Example entry | Fields |

4638| :------------ | :------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------------------------- |4638| :------------ | :------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------------------------- |

4639| `github` | `{ "source": "github", "repo": "acme-corp/plugins", "ref": "main", "path": "marketplace" }` | `repo` обязателен; `ref` — это branch или tag; `path` — это подпапка |4639| `github` | `{ "source": "github", "repo": "acme-corp/plugins", "ref": "main", "path": "marketplace" }` | `repo` обязателен; `ref` — это ветка или тег; `path` — это подпапка |

4640| `git` | `{ "source": "git", "url": "https://gitlab.example.com/tools/plugins.git", "ref": "production" }` | `url` обязателен; `ref` и `path` как для `github` |4640| `git` | `{ "source": "git", "url": "https://gitlab.example.com/tools/plugins.git", "ref": "production" }` | `url` обязателен; `ref` и `path` как для `github` |

4641| `url` | `{ "source": "url", "url": "https://plugins.example.com/marketplace.json", "headers": { "Authorization": "Bearer ${TOKEN}" } }` | `url` обязателен; `headers` добавляет HTTP headers для аутентифицированного доступа |4641| `url` | `{ "source": "url", "url": "https://plugins.example.com/marketplace.json", "headers": { "Authorization": "Bearer ${TOKEN}" } }` | `url` обязателен; `headers` добавляет HTTP headers для аутентифицированного доступа |

4642| `npm` | `{ "source": "npm", "package": "@acme-corp/claude-plugins" }` | `package` обязателен, npm пакет, который содержит `marketplace.json` |

4643| `file` | `{ "source": "file", "path": "/opt/acme-corp/plugins/marketplace.json" }` | `path` обязателен, абсолютный путь к файлу `marketplace.json` |4642| `file` | `{ "source": "file", "path": "/opt/acme-corp/plugins/marketplace.json" }` | `path` обязателен, абсолютный путь к файлу `marketplace.json` |

4644| `directory` | `{ "source": "directory", "path": "/opt/acme-corp/approved-marketplaces" }` | `path` обязателен, абсолютный путь к папке, содержащей `.claude-plugin/marketplace.json` |4643| `directory` | `{ "source": "directory", "path": "/opt/acme-corp/approved-marketplaces" }` | `path` обязателен, абсолютный путь к папке, содержащей `.claude-plugin/marketplace.json` |

4645| `hostPattern` | `{ "source": "hostPattern", "hostPattern": "^github\\.example\\.com$" }` | `hostPattern` обязателен, regex, сопоставляемый с хостом marketplace |4644| `hostPattern` | `{ "source": "hostPattern", "hostPattern": "^github\\.example\\.com$" }` | `hostPattern` обязателен, regex, сопоставляемый с хостом marketplace |

4646| `pathPattern` | `{ "source": "pathPattern", "pathPattern": "^/opt/approved/" }` | `pathPattern` обязателен, regex, сопоставляемый с `path` источников `file` и `directory` |4645| `pathPattern` | `{ "source": "pathPattern", "pathPattern": "^/opt/approved/" }` | `pathPattern` обязателен, regex, сопоставляемый с `path` источников `file` и `directory` |

4647| `skills-dir` | `{ "source": "skills-dir" }` | Нет полей. Включает сканирование plugin `~/.claude/skills/` обратно |4646| `skills-dir` | `{ "source": "skills-dir" }` | Нет полей. Включает обратно сканирование plugin `~/.claude/skills/` |

4648 4647 

4649Три типа источников имеют правила сверх таблицы:4648Три типа источников имеют правила, выходящие за рамки таблицы:

4650 4649 

4651* **`url`**: URL marketplace загружает только файл `marketplace.json`, и Claude Code не получает файлы plugin по относительному пути с этого сервера, поэтому его plugins должны использовать [plugin source](/docs/ru/plugin-marketplaces#plugin-sources) отличный от относительного пути, такой как URL архива, который может быть на том же хосте. Для plugins с относительными путями используйте вместо этого Git-based marketplace. См. [Plugins with relative paths fail in URL-based marketplaces](/docs/ru/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces).4650* **`url`**: URL marketplace загружает только файл `marketplace.json`, и Claude Code не получает файлы plugin по относительному пути с этого сервера, поэтому его plugins должны использовать [plugin source](/docs/ru/plugin-marketplaces#plugin-sources) отличный от относительного пути, такой как URL архива, который может быть на том же хосте. Для plugins с относительными путями используйте вместо этого Git-based marketplace. См. [Plugins с относительными путями не работают в URL-based marketplaces](/docs/ru/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces).

4652* **`hostPattern`**: используйте его, чтобы разрешить каждый marketplace на внутреннем GitHub Enterprise или GitLab сервере без перечисления каждого репозитория. Claude Code сопоставляет источники `github` с `github.com`, берёт имя хоста из источников `url` и берёт его из источников `git` в зависимости от формы [git URL](https://git-scm.com/docs/git-clone#_git_urls):4651* **`hostPattern`**: используйте его, чтобы разрешить каждый marketplace на внутреннем GitHub Enterprise или GitLab сервере без перечисления каждого репозитория. Claude Code сопоставляет источники `github` с `github.com`, берёт имя хоста из источников `url` и берёт его из источников `git` в зависимости от формы [git URL](https://git-scm.com/docs/git-clone#_git_urls):

4653 4652 

4654 * URL со схемой, такой как `https://` или `ssh://`: имя хоста в URL.4653 * URL со схемой, такой как `https://` или `ssh://`: имя хоста в URL.

4655 * SSH адрес без схемы, в форме git `user@host:path`, такой как `git@git.example.com:tools/plugins.git`: хост между `@` и `:`, который является хостом, к которому подключается git.4654 * SSH адрес без схемы, в форме `user@host:path` git, такой как `git@git.example.com:tools/plugins.git`: хост между `@` и `:`, который является хостом, к которому подключается git.

4656 * Любая другая форма без схемы: нет хоста, поэтому никакая запись `strictKnownMarketplaces` `hostPattern` не совпадает с ней. Для `blockedMarketplaces` `hostPattern`, Claude Code берёт хост из более широкого набора форм, поэтому запись blocklist всё ещё может совпадать с такой формой. До v2.1.234, `strictKnownMarketplaces` `hostPattern` также совпадал с некоторыми формами, которые git не рассматривает как SSH адреса.4655 * Любая другая форма без схемы: нет хоста, поэтому ни одна запись `strictKnownMarketplaces` `hostPattern` не совпадает с ней. Для `blockedMarketplaces` `hostPattern` Claude Code берёт хост из более широкого набора форм, поэтому запись списка блокировки всё ещё может совпадать с такой формой. До v2.1.234 `strictKnownMarketplaces` `hostPattern` также совпадала с некоторыми формами, которые git не рассматривает как SSH адреса.

4657 4656 

4658 Источники `file` и `directory` не имеют хоста и никогда не совпадают с записью `hostPattern`.4657 Источники `file` и `directory` не имеют хоста и никогда не совпадают с записью `hostPattern`.

4659* **`pathPattern`**: используйте его, чтобы разрешить filesystem marketplaces наряду с записями `hostPattern` для сетевых источников. `".*"` разрешает каждый локальный путь; более узкий pattern, такой как `"^/opt/approved/"`, ограничивает папкой.4658* **`pathPattern`**: используйте его, чтобы разрешить marketplaces файловой системы наряду с записями `hostPattern` для сетевых источников. `".*"` разрешает каждый локальный путь; более узкий паттерн, такой как `"^/opt/approved/"`, ограничивает папку.

4660 4659 

4661Любой allowlist, даже пустой, также прекращает загрузку Claude Code [`@skills-dir` plugins](/docs/ru/plugins-reference#skills-directory-plugins) из `~/.claude/skills/`. Добавьте запись `{ "source": "skills-dir" }`, чтобы продолжить их загрузку; запись не имеет значения вне этого ключа и `blockedMarketplaces`.4660Любой список разрешений, даже пустой, также останавливает загрузку Claude Code [`@skills-dir` plugins](/docs/ru/plugins-reference#skills-directory-plugins) из `~/.claude/skills/`. Добавьте запись `{ "source": "skills-dir" }`, чтобы продолжить их загрузку; запись не имеет значения вне этого ключа и `blockedMarketplaces`.

4662 4661 

4663<h4 id="owner-wildcards">4662<h4 id="owner-wildcards">

4664 Owner wildcards4663 Owner wildcards

4665</h4>4664</h4>

4666 4665 

4667Запись `github`, чьё значение `repo` — это `"<owner>/*"`, совпадает с каждым репозиторием под этим GitHub owner. Owner wildcards требуют Claude Code v2.1.223 или позже и работают только в `strictKnownMarketplaces` и `blockedMarketplaces`. Везде, где источник `github` появляется, такой как `extraKnownMarketplaces` или `/plugin marketplace add`, значение `repo` должно называть один репозиторий. До v2.1.223, Claude Code сравнивал запись буквально, поэтому запись allowlist не совпадала ни с одним репозиторием и запись blocklist ничего не блокировала; записи с одним репозиторием применяются на каждой версии.4666Запись `github`, чьё значение `repo` — это `"<owner>/*"`, совпадает с каждым репозиторием под этим владельцем GitHub. Owner wildcards требуют Claude Code v2.1.223 или позже и работают только в `strictKnownMarketplaces` и `blockedMarketplaces`. Везде, где появляется источник `github`, такой как `extraKnownMarketplaces` или `/plugin marketplace add`, значение `repo` должно называть один репозиторий. До v2.1.223 Claude Code сравнивал запись буквально, поэтому запись списка разрешений не совпадала ни с одним репозиторием, а запись списка блокировки ничего не блокировала; записи с одним репозиторием применяются на каждой версии.

4668 4667 

4669Эта запись разрешает любой репозиторий marketplace в организации `acme-corp`:4668Эта запись разрешает любой репозиторий marketplace в организации `acme-corp`:

4670 4669 


4678 4677 

4679Только вся позиция имени репозитория может быть wildcard. Claude Code сравнивает записи, такие как `*`, `*/plugins` или `acme-corp/tools-*`, буквально, поэтому они не совпадают ни с одним репозиторием.4678Только вся позиция имени репозитория может быть wildcard. Claude Code сравнивает записи, такие как `*`, `*/plugins` или `acme-corp/tools-*`, буквально, поэтому они не совпадают ни с одним репозиторием.

4680 4679 

4681Правила сопоставления отличаются между двумя settings:4680Правила сопоставления отличаются между двумя параметрами:

4682 4681 

4683| Rule | `strictKnownMarketplaces` | `blockedMarketplaces` |4682| Rule | `strictKnownMarketplaces` | `blockedMarketplaces` |

4684| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |4683| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |

4685| Matching source spellings | Только форма `owner/repo`. Git URL, который клонирует тот же репозиторий, не совпадает | Любое написание, включая git URLs, которые разрешаются в тот же github.com репозиторий |4684| Matching source spellings | Только форма `owner/repo`. Git URL, который клонирует тот же репозиторий, не совпадает | Любое написание, включая git URLs, которые разрешаются в тот же репозиторий github.com |

4686| Owner case | Чувствителен к регистру, как точное сопоставление записей | Нечувствителен к регистру |4685| Owner case | Чувствителен к регистру, как точное сопоставление записей | Нечувствителен к регистру |

4687| `ref` | Следует правилам точного сопоставления: запись с `ref` совпадает только с источниками с этим точным ref, и запись без одного совпадает только с источниками, которые не указывают ref | Запись без `ref` блокирует все refs репозиториев, которые она совпадает |4686| `ref` | Следует правилам точного сопоставления: запись с `ref` совпадает только с источниками с этим точным ref, и запись без одного совпадает только с источниками, которые не указывают ref | Запись без `ref` блокирует все refs репозиториев, которые она совпадает |

4688| `path` | Более свободно, чем правила точного сопоставления: запись с `path` требует это точное значение, в то время как запись без одного совпадает с любым путём внутри репозитория | Запись без `path` блокирует все пути репозиториев, которые она совпадает |4687| `path` | Более свободно, чем правила точного сопоставления: запись с `path` требует это точное значение, в то время как запись без одного совпадает с любым путём внутри репозитория | Запись без `path` блокирует все пути репозиториев, которые она совпадает |


4691 Exact matching4690 Exact matching

4692</h4>4691</h4>

4693 4692 

4694Для каждого типа источника, кроме owner-wildcard записей `github` и regex-сопоставляемых записей `hostPattern` и `pathPattern`, Claude Code разрешает добавление пользователя только когда источник marketplace точно совпадает с записью. Для git-based источников `github` и `git`, точное сопоставление включает опциональные поля:4693Для каждого типа источника, кроме owner-wildcard записей `github` и regex-сопоставляемых записей `hostPattern` и `pathPattern`, Claude Code разрешает добавление пользователя только когда источник marketplace точно совпадает с записью. Для Git-based источников `github` и `git`, точное сопоставление включает необязательные поля:

4695 4694 

4696* `repo` или `url` должны совпадать точно4695* `repo` или `url` должны совпадать точно

4697* Поле `ref` должно совпадать точно, или оба должны быть undefined4696* Поле `ref` должно совпадать точно, или оба должны быть undefined


4718 4717 

4719С этой записью Claude Code сохраняет уже зарегистрированный официальный marketplace доступным и, на свежей машине, регистрирует marketplace автоматически при первом интерактивном запуске Claude Code. Автоматическая регистрация чаще всего пропускает:4718С этой записью Claude Code сохраняет уже зарегистрированный официальный marketplace доступным и, на свежей машине, регистрирует marketplace автоматически при первом интерактивном запуске Claude Code. Автоматическая регистрация чаще всего пропускает:

4720 4719 

4721* Non-interactive окружения, которые запускаются до первого интерактивного запуска машины.4720* Неинтерактивные окружения, которые работают перед первым интерактивным запуском машины.

4722* Машины, где Claude Code уже запускался интерактивно под политикой, которая блокировала marketplace, такой как пустая блокировка массива. Claude Code записывает заблокированную попытку и не повторяет попытку после изменения политики.4721* Машины, где Claude Code уже работал интерактивно под политикой, которая блокировала marketplace, такой как блокировка пустого массива. Claude Code записывает заблокированную попытку и не повторяет попытку после изменения политики.

4723 4722 

4724На этих машинах добавьте marketplace в [`extraKnownMarketplaces`](#extraknownmarketplaces) в том же `managed-settings.json`, чтобы Claude Code регистрировал его автоматически, или запустите `claude plugin marketplace add anthropics/claude-plugins-official`.4723На этих машинах добавьте marketplace в [`extraKnownMarketplaces`](#extraknownmarketplaces) в том же `managed-settings.json`, чтобы Claude Code регистрировал его автоматически, или запустите `claude plugin marketplace add anthropics/claude-plugins-official`.

4725 4724 


4730Два ключа выполняют разные работы. Эта таблица их сравнивает:4729Два ключа выполняют разные работы. Эта таблица их сравнивает:

4731 4730 

4732| Aspect | `strictKnownMarketplaces` | `extraKnownMarketplaces` |4731| Aspect | `strictKnownMarketplaces` | `extraKnownMarketplaces` |

4733| ----------------- | ------------------------------------- | ------------------------------------------------------------------------------------------ |4732| ----------------- | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |

4734| Purpose | Применение организационной политики | Удобство команды |4733| Purpose | Применение организационной политики | Удобство команды |

4735| Settings file | Только managed settings | Любой settings файл |4734| Settings file | Только управляемые параметры | Любой файл параметров |

4736| Behavior | Блокирует non-allowlisted добавления | Регистрирует отсутствующие marketplaces |4735| Behavior | Блокирует неразрешённые добавления | Регистрирует отсутствующие marketplaces |

4737| When enforced | Перед сетевыми и файловыми операциями | Сразу из user или managed settings; после диалога доверия workspace для файлов репозитория |4736| When enforced | Перед сетевыми и файловыми операциями | Сразу же из пользовательских или управляемых параметров; после диалога доверия рабочей области для файлов репозитория |

4738| Can be overridden | Нет, наивысший приоритет | Да, более высокоприоритетными settings |4737| Can be overridden | Нет, наивысший приоритет | Да, более высокоприоритетными параметрами |

4739| Source format | Прямой объект источника | Именованный marketplace с вложенным объектом `source` |4738| Source format | Прямой объект источника | Именованный marketplace с вложенным объектом `source` |

4740 4739 

4741Чтобы одновременно ограничить и предварительно зарегистрировать marketplace для всех пользователей, установите оба в `managed-settings.json`:4740Чтобы одновременно ограничить и предварительно зарегистрировать marketplace для всех пользователей, установите оба в `managed-settings.json`:


4753}4752}

4754```4753```

4755 4754 

4756Только с установленным `strictKnownMarketplaces`, пользователи всё ещё могут добавить разрешённый marketplace сами с помощью `/plugin marketplace add`. Официальный marketplace Anthropic — единственный, который Claude Code регистрирует автоматически, и только когда allowlist его разрешает. [Allow only the official marketplace](#allow-only-the-official-marketplace) перечисляет машины, которые он пропускает.4755Только с установленным `strictKnownMarketplaces` пользователи всё ещё могут добавить разрешённый marketplace сами с помощью `/plugin marketplace add`. Официальный marketplace Anthropic — единственный, который Claude Code регистрирует автоматически, и только когда список разрешений его разрешает. [Allow only the official marketplace](#allow-only-the-official-marketplace) перечисляет машины, которые он пропускает.

4757 4756 

4758<h3 id="strictpluginonlycustomization">4757<h3 id="strictpluginonlycustomization">

4759 `strictPluginOnlyCustomization`4758 `strictPluginOnlyCustomization`

4760</h3>4759</h3>

4761 4760 

4762Блокируйте skills, agents, hooks и MCP servers из user и project источников, поэтому они могут поступать только из plugins или managed settings. Объедините его с [`strictKnownMarketplaces`](#strictknownmarketplaces), чтобы контролировать полную цепь поставок customization: allowlist marketplace контролирует, какие plugins пользователи могут устанавливать.4761Блокируйте skills, agents, hooks и MCP servers из пользовательских и project источников, поэтому они могут поступать только из plugins или управляемых параметров. Объедините его с [`strictKnownMarketplaces`](#strictknownmarketplaces), чтобы контролировать полную цепь поставок настройки: список разрешений marketplace контролирует, какие plugins пользователи могут устанавливать.

4763 4762 

4764* **Scope**: [`Managed`](#scopes)4763* **Scope**: [`Managed`](#scopes)

4765* **Type**: `true` для блокировки всех четырёх видов customization, или массив, называющий виды для блокировки, из `"skills"`, `"agents"`, `"hooks"` и `"mcp"`4764* **Type**: `true` для блокировки всех четырёх видов настройки, или массив, называющий виды для блокировки, из `"skills"`, `"agents"`, `"hooks"` и `"mcp"`

4766* **Default**: не установлено, поэтому ничего не заблокировано4765* **Default**: не установлено, поэтому ничего не заблокировано

4767 4766 

4768Этот пример блокирует skills и hooks и оставляет agents и MCP servers разблокированными:4767Этот пример блокирует skills и hooks и оставляет agents и MCP servers разблокированными:


4773}4772}

4774```4773```

4775 4774 

4776Четыре записи sub-key ниже перечисляют, что каждая surface блокирует и что всё ещё загружается. Claude Code игнорирует имена surface, которые он не распознаёт, вместо того, чтобы не пройти файл settings, поэтому вы можете добавлять новые имена surface перед обновлением каждого клиента.4775Четыре записи sub-key ниже перечисляют, что каждая поверхность блокирует и что всё ещё загружается. Claude Code игнорирует имена поверхностей, которые он не распознаёт, вместо того чтобы не пройти файл параметров, поэтому вы можете добавлять новые имена поверхностей перед обновлением каждого клиента.

4777 4776 

4778<h3 id="strictpluginonlycustomization-skills">4777<h3 id="strictpluginonlycustomization-skills">

4779 `strictPluginOnlyCustomization.skills`4778 `strictPluginOnlyCustomization.skills`

4780</h3>4779</h3>

4781 4780 

4782Блокируйте surface `skills`. Claude Code прекращает загрузку skills из `~/.claude/skills/` и `.claude/skills/`, пользовательских команд из `~/.claude/commands/` и `.claude/commands/`, skills под папками `--add-dir`, и skills синхронизированные из вашей claude.ai учётной записи, и продолжает загружать plugin skills, bundled skills и skills в папке managed политики.4781Блокируйте поверхность `skills`. Claude Code прекращает загрузку skills из `~/.claude/skills/` и `.claude/skills/`, пользовательских команд из `~/.claude/commands/` и `.claude/commands/`, skills под папками `--add-dir` и skills, синхронизированные из вашей учётной записи claude.ai, и продолжает загружать plugin skills, встроенные skills и skills в папке управляемой политики.

4783 4782 

4784* **Scope**: [`Managed`](#scopes)4783* **Scope**: [`Managed`](#scopes)

4785* **Type**: строка `"skills"` в массиве [`strictPluginOnlyCustomization`](#strictpluginonlycustomization)4784* **Type**: строка `"skills"` в массиве [`strictPluginOnlyCustomization`](#strictpluginonlycustomization)


4795 `strictPluginOnlyCustomization.agents`4794 `strictPluginOnlyCustomization.agents`

4796</h3>4795</h3>

4797 4796 

4798Блокируйте surface `agents`. Claude Code прекращает загрузку agents из `~/.claude/agents/` и `.claude/agents/`, и продолжает загружать plugin agents, встроенные agents и agents в папке managed политики.4797Блокируйте поверхность `agents`. Claude Code прекращает загрузку agents из `~/.claude/agents/` и `.claude/agents/` и продолжает загружать plugin agents, встроенные agents и agents в папке управляемой политики.

4799 4798 

4800* **Scope**: [`Managed`](#scopes)4799* **Scope**: [`Managed`](#scopes)

4801* **Type**: строка `"agents"` в массиве [`strictPluginOnlyCustomization`](#strictpluginonlycustomization)4800* **Type**: строка `"agents"` в массиве [`strictPluginOnlyCustomization`](#strictpluginonlycustomization)


4811 `strictPluginOnlyCustomization.hooks`4810 `strictPluginOnlyCustomization.hooks`

4812</h3>4811</h3>

4813 4812 

4814Блокируйте surface `hooks`. Claude Code прекращает запуск hooks из user, project и локального `settings.json`, и продолжает запускать plugin hooks и hooks в managed settings.4813Блокируйте поверхность `hooks`. Claude Code прекращает выполнение hooks из пользовательских, project и локальных `settings.json` и продолжает выполнять plugin hooks и hooks в управляемых параметрах.

4815 4814 

4816* **Scope**: [`Managed`](#scopes)4815* **Scope**: [`Managed`](#scopes)

4817* **Type**: строка `"hooks"` в массиве [`strictPluginOnlyCustomization`](#strictpluginonlycustomization)4816* **Type**: строка `"hooks"` в массиве [`strictPluginOnlyCustomization`](#strictpluginonlycustomization)


4827 `strictPluginOnlyCustomization.mcp`4826 `strictPluginOnlyCustomization.mcp`

4828</h3>4827</h3>

4829 4828 

4830Блокируйте surface `mcp`. Claude Code прекращает загрузку MCP servers из `~/.claude.json` и `.mcp.json`, и продолжает загружать plugin MCP servers, [`managed-mcp.json`](/docs/ru/managed-mcp) servers и servers из [`managedMcpServers`](#managedmcpservers).4829Блокируйте поверхность `mcp`. Claude Code прекращает загрузку MCP servers из `~/.claude.json` и `.mcp.json` и продолжает загружать plugin MCP servers, [`managed-mcp.json`](/docs/ru/managed-mcp) servers и servers из [`managedMcpServers`](#managedmcpservers).

4831 4830 

4832* **Scope**: [`Managed`](#scopes)4831* **Scope**: [`Managed`](#scopes)

4833* **Type**: строка `"mcp"` в массиве [`strictPluginOnlyCustomization`](#strictpluginonlycustomization)4832* **Type**: строка `"mcp"` в массиве [`strictPluginOnlyCustomization`](#strictpluginonlycustomization)


4843 `enabledPlugins`4842 `enabledPlugins`

4844</h3>4843</h3>

4845 4844 

4846Включайте или отключайте отдельные [plugins](/docs/ru/plugins), ключ `plugin-name@marketplace-name`. Plugin без записи в любом scope возвращается к его значению [`defaultEnabled`](/docs/ru/plugins-reference#default-enablement). Когда вы включаете или отключаете plugin с `/plugin` или `claude plugin enable`, Claude Code записывает этот ключ для вас.4845Включайте или отключайте отдельные [plugins](/docs/ru/plugins), обозначенные как `plugin-name@marketplace-name`. Plugin без записи в любой scope возвращается к его значению [`defaultEnabled`](/docs/ru/plugins-reference#default-enablement). Когда вы включаете или отключаете plugin с помощью `/plugin` или `claude plugin enable`, Claude Code записывает этот ключ для вас.

4847 4846 

4848* **Scope**: [`Any file`](#scopes)4847* **Scope**: [`Any file`](#scopes)

4849* **Type**: объект, отображающий `plugin-name@marketplace-name` на Boolean4848* **Type**: object, отображающий `plugin-name@marketplace-name` на Boolean

4850* **Default**: не установлено, поэтому каждый plugin следует его значению `defaultEnabled`4849* **Default**: не установлено, поэтому каждый plugin следует его значению `defaultEnabled`

4851 4850 

4852Этот пример включает два plugins из marketplace `team-tools` и отключает один из `personal`:4851Этот пример включает два plugins из marketplace `team-tools` и отключает один из `personal`:


4865 4864 

4866* **User settings**: ваши личные предпочтения plugin4865* **User settings**: ваши личные предпочтения plugin

4867* **Project settings**: plugins, общие со всеми в репозитории4866* **Project settings**: plugins, общие со всеми в репозитории

4868* **Local settings**: переопределения для каждой машины, gitignored когда Claude Code сохраняет setting там4867* **Local settings**: переопределения для каждой машины, gitignored, когда Claude Code сохраняет параметр там

4869* **Managed settings**: организационная политика. Plugin установленный на `false` здесь заблокирован от установки в каждом scope и скрыт из marketplace4868* **Managed settings**: организационная политика. Plugin, установленный на `false` здесь, заблокирован от установки в каждом scope и скрыт от marketplace

4870 4869 

4871Project settings имеют приоритет над user settings, поэтому установка plugin на `false` в `~/.claude/settings.json` не отключает plugin, который project's `.claude/settings.json` включает. Чтобы отказаться от project-enabled plugin на вашей машине, установите его на `false` в `.claude/settings.local.json` вместо этого. Plugins force-enabled managed settings не могут быть отключены таким образом, так как managed settings переопределяют local settings.4870Project settings имеют приоритет над user settings, поэтому установка plugin на `false` в `~/.claude/settings.json` не отключает plugin, который `.claude/settings.json` проекта включает. Чтобы отказаться от plugin, включённого проектом, на вашей машине, установите его на `false` в `.claude/settings.local.json` вместо этого. Plugins, принудительно включённые управляемыми параметрами, не могут быть отключены таким образом, так как управляемые параметры переопределяют локальные параметры.

4872 4871 

4873Включение plugin из внешнего источника, такого как GitHub репозиторий или npm пакет, в project's `.claude/settings.json` не устанавливает его для других людей. На каждом пути, который загружает plugins, Claude Code сообщает о plugin как не установленном до тех пор, пока каждый пользователь [не установит его сам](/docs/ru/discover-plugins#configure-team-marketplaces).4872Включение plugin из внешнего источника, такого как репозиторий GitHub или пакет npm, в `.claude/settings.json` проекта не устанавливает его для других людей. На каждом пути, который загружает plugins, Claude Code сообщает о plugin как не установленном до тех пор, пока каждый пользователь [не установит его сам](/docs/ru/discover-plugins#configure-team-marketplaces).

4874 4873 

4875<h3 id="extraknownmarketplaces">4874<h3 id="extraknownmarketplaces">

4876 `extraKnownMarketplaces`4875 `extraKnownMarketplaces`

4877</h3>4876</h3>

4878 4877 

4879Регистрируйте дополнительные plugin marketplaces по имени, чтобы люди, которые открывают репозиторий, или все, кого достигают ваши managed settings, получали marketplace без добавления его сами. Claude Code регистрирует каждый marketplace, который он ещё не знает. Устанавливается ли plugin, который [`enabledPlugins`](#enabledplugins) называет из него, зависит от источника plugin и какой файл его включает; эта запись имеет правила.4878Регистрируйте дополнительные plugin marketplaces по имени, чтобы люди, которые открывают репозиторий, или все, кого достигают ваши управляемые параметры, получали marketplace без добавления его самостоятельно. Claude Code регистрирует каждый marketplace, который он ещё не знает. Устанавливается ли plugin, который [`enabledPlugins`](#enabledplugins) называет из него, зависит от источника plugin и какой файл его включает; эта запись имеет правила.

4880 4879 

4881* **Scope**: [`Any file`](#scopes). Claude Code соблюдает записи в `.claude/settings.json` или `.claude/settings.local.json` репозитория только после того, как вы примете диалог доверия workspace для этой папки; в папке, которую вы не доверяете, включая запуск `-p` там, он игнорирует их без сообщения.4880* **Scope**: [`Any file`](#scopes). Claude Code учитывает записи в `.claude/settings.json` или `.claude/settings.local.json` репозитория только после того, как вы примете диалог доверия рабочей области для этой папки; в папке, которую вы не доверяете, включая запуск `-p` там, он игнорирует их без сообщения.

4882* **Type**: объект, отображающий имя marketplace на объект с объектом `source` и опциональным Boolean `autoUpdate`4881* **Type**: object, отображающий имя marketplace на объект с объектом `source` и необязательным Boolean `autoUpdate`

4883* **Default**: не установлено4882* **Default**: не установлено

4884 4883 

4885Этот пример регистрирует GitHub marketplace и marketplace из self-hosted git URL:4884Этот пример регистрирует GitHub marketplace и marketplace из самостоятельно размещённого git URL:

4886 4885 

4887```json settings.json theme={null}4886```json settings.json theme={null}

4888{4887{


4903}4902}

4904```4903```

4905 4904 

4906[What runs before you trust a folder](/docs/ru/permissions#what-runs-before-you-trust-a-folder) сравнивает gate доверия с другим контентом, который репозиторий может поставлять. Вы также можете написать этот ключ как `additionalMarketplaces`; см. [Marketplace key aliases](#marketplace-key-aliases).4905[Что работает перед тем, как вы доверяете папке](/docs/ru/permissions#what-runs-before-you-trust-a-folder), сравнивает ворота доверия с другим содержимым, которое репозиторий может предоставить. Вы также можете написать этот ключ как `additionalMarketplaces`; см. [Marketplace key aliases](#marketplace-key-aliases).

4907 4906 

4908Установите `"autoUpdate": true` рядом с `source`, чтобы Claude Code обновлял этот marketplace и обновлял его установленные plugins в фоне после запуска. Когда опущено, `claude-plugins-official` и большинство других официальных marketplaces Anthropic по умолчанию `true`, и third-party marketplaces по умолчанию `false`. См. [Configure auto-updates](/docs/ru/discover-plugins#configure-auto-updates).4907Установите `"autoUpdate": true` рядом с `source`, чтобы Claude Code обновлял этот marketplace и обновлял его установленные plugins в фоне после запуска. Когда опущено, `claude-plugins-official` и большинство других официальных marketplaces Anthropic по умолчанию имеют `true`, а marketplaces третьих сторон по умолчанию имеют `false`. См. [Configure auto-updates](/docs/ru/discover-plugins#configure-auto-updates).

4909 4908 

4910Когда более одного settings файла определяет запись marketplace под тем же именем, Claude Code использует запись из [highest-precedence file](/docs/ru/settings#settings-precedence) целиком. Эта запись заменяет lower-precedence запись и не наследует ни одно из её полей, поэтому переопределение не может объединить `source.headers` credential одного файла с URL, который контролирует другой файл. До v2.1.228, Claude Code объединял same-name записи поле за полем, поэтому запись в higher-precedence файле могла наследовать поля, которые она не установила, включая `headers` другого файла.4909Когда более одного файла параметров определяет запись marketplace под одним и тем же именем, Claude Code использует запись из [файла с наивысшим приоритетом](/docs/ru/settings#settings-precedence) целиком. Эта запись заменяет запись с более низким приоритетом и не наследует ни одно из её полей, поэтому переопределение не может объединить `source.headers` учётные данные одного файла с URL, который контролирует другой файл. До v2.1.228 Claude Code объединял записи с одним именем поле за полем, поэтому запись в файле с более высоким приоритетом могла наследовать поля, которые она не установила, включая `headers` другого файла.

4911 4910 

4912<h4 id="marketplace-source-types">4911<h4 id="marketplace-source-types">

4913 Marketplace source types4912 Marketplace source types


4915 4914 

4916Объект `source` принимает одну из этих форм:4915Объект `source` принимает одну из этих форм:

4917 4916 

4918* **`github`**: GitHub репозиторий, с `repo`4917* **`github`**: репозиторий GitHub, с `repo`

4919* **`git`**: любой git URL, с `url`4918* **`git`**: любой git URL, с `url`

4920* **`url`**: прямой URL к файлу `marketplace.json`, с `url` и опциональными `headers` и `headersHelper` для аутентифицированного доступа. `headersHelper` называет команду, которая печатает headers, чьи значения слишком недолговечны, чтобы перечислять в `headers`, и требует Claude Code v2.1.238 или позже4919* **`url`**: прямой URL к файлу `marketplace.json`, с `url` и необязательными `headers` и `headersHelper` для аутентифицированного доступа. `headersHelper` называет команду, которая печатает headers, чьи значения слишком недолговечны для перечисления в `headers`, и требует Claude Code v2.1.238 или позже

4921* **`file`**: локальный путь к файлу `marketplace.json`, с `path`4920* **`file`**: локальный путь к файлу `marketplace.json`, с `path`

4922* **`directory`**: локальный путь файловой системы, с `path`, только для разработки4921* **`directory`**: локальный путь файловой системы, с `path`, только для разработки

4923* **`settings`**: встроенный marketplace, объявленный прямо в settings файле без размещённого репозитория, с `name` и `plugins`4922* **`settings`**: встроенный marketplace, объявленный непосредственно в файле параметров без размещённого репозитория, с `name` и `plugins`

4924 4923 

4925Тип источника `git` работает с любым git хостингом, включая self-hosted GitLab и Bitbucket. Claude Code клонирует репозиторий с той же аутентификацией, которую использовал бы `git clone` на этой машине: настроенные credential helpers или SSH ключи. Provider token, такой как `GITHUB_TOKEN`, вступает в силу только через credential helper, который его читает. См. [Private repositories](/docs/ru/plugin-marketplaces#private-repositories) для деталей настройки.4924Тип источника `git` работает с любым сервисом хостинга git, включая самостоятельно размещённые GitLab и Bitbucket. Claude Code клонирует репозиторий с той же аутентификацией, которую использовал бы `git clone` на этой машине: настроенные помощники учётных данных или SSH ключи. Токен поставщика, такой как `GITHUB_TOKEN`, вступает в силу только через помощника учётных данных, который его читает. См. [Private repositories](/docs/ru/plugin-marketplaces#private-repositories) для деталей настройки.

4926 4925 

4927Для источников `github` и `git`, Claude Code никогда не загружает контент [Git LFS](https://git-lfs.com) когда он клонирует репозиторий marketplace для добавления или обновления. LFS-отслеживаемые файлы проверяются как pointer файлы, и вывод добавления или обновления сообщает, сколько их.4926Для источников `github` и `git` Claude Code никогда не загружает содержимое [Git LFS](https://git-lfs.com) при клонировании репозитория marketplace для добавления или обновления. LFS-отслеживаемые файлы проверяются как файлы указателей, и вывод добавления или обновления сообщает, сколько их.

4928 4927 

4929Поле `skipLfs` внутри объекта `source` принимается и не имеет эффекта. До v2.1.274, Claude Code загружал контент LFS, если вы не установили `"skipLfs": true`.4928Поле `skipLfs` внутри объекта `source` принимается и не имеет эффекта. До v2.1.274 Claude Code загружал содержимое LFS, если вы не установили `"skipLfs": true`.

4930 4929 

4931Для источника `url`, установите `headersHelper` внутри объекта `source`, когда credential в `headers` истекает и команда должна произвести свежий. Требует Claude Code v2.1.238 или позже. Для того, что команда должна печатать и где Claude Code её запускает, см. [Write the headersHelper command](/docs/ru/plugin-marketplaces#write-the-headershelper-command), и для случаев, когда Claude Code её не запускает, см. [When Claude Code skips a headersHelper command](/docs/ru/plugin-marketplaces#when-claude-code-skips-a-headershelper-command-or-drops-its-output). Как только вы установите `headersHelper` на URL `https://` marketplace, Claude Code запускает команду в двух точках, переиспользуя вывод одного запуска до 60 секунд:4930Для источника `url` установите `headersHelper` внутри объекта `source`, когда учётные данные в `headers` истекают и команда должна произвести свежие. Требуется Claude Code v2.1.238 или позже. Для того, что команда должна печатать и где Claude Code её запускает, см. [Write the headersHelper command](/docs/ru/plugin-marketplaces#write-the-headershelper-command), и для случаев, когда Claude Code не запускает её, см. [When Claude Code skips a headersHelper command](/docs/ru/plugin-marketplaces#when-claude-code-skips-a-headershelper-command-or-drops-its-output). Как только вы установите `headersHelper` на URL marketplace `https://`, Claude Code запускает команду в двух точках, повторно используя вывод одного запуска в течение до 60 секунд:

4932 4931 

4933* Перед каждой выборкой `marketplace.json` этого marketplace, включая более позднее обновление. Claude Code отправляет напечатанные headers с этой выборкой.4932* Перед каждой выборкой `marketplace.json` этого marketplace, включая более позднее обновление. Claude Code отправляет напечатанные headers с этой выборкой.

4934* Перед каждой загрузкой plugin архива на origin URL marketplace, означая ту же схему, хост и порт. Claude Code отправляет вывод с этой загрузкой, и никакая другая загрузка не получает headers.4933* Перед каждой загрузкой архива plugin на происхождение URL marketplace, означая ту же схему, хост и порт. Claude Code отправляет вывод с этой загрузкой, и никакая другая загрузка не получает headers.

4935 4934 

4936Claude Code игнорирует любой `headersHelper`, установленный в `.claude/settings.json` или `.claude/settings.local.json` папки, которую вы добавляете с [`--add-dir`](/docs/ru/permissions#what-runs-before-you-trust-a-folder), на источнике `url` и на встроенной записи plugin, и отправляет только фиксированный `headers`, установленный в этом файле. [How users accept a headersHelper command](/docs/ru/plugin-marketplaces#how-users-accept-a-headershelper-command) охватывает другие settings файлы.4935Claude Code игнорирует любой `headersHelper`, установленный в `.claude/settings.json` или `.claude/settings.local.json` папки, которую вы добавляете с [`--add-dir`](/docs/ru/permissions#what-runs-before-you-trust-a-folder), на источнике `url` и на встроенной записи plugin одинаково, и отправляет только фиксированные `headers`, установленные в этом файле. [How users accept a headersHelper command](/docs/ru/plugin-marketplaces#how-users-accept-a-headershelper-command) охватывает другие файлы параметров.

4937 4936 

4938Plugins, перечисленные в источнике `settings`, должны ссылаться на внешние источники, такие как GitHub или npm, и `name` должен совпадать с ключом marketplace. Вы всё ещё включаете каждый plugin отдельно в `enabledPlugins`. Этот пример объявляет один plugin встроенным:4937Plugins, перечисленные в источнике `settings`, должны ссылаться на внешние источники, такие как GitHub или npm, и `name` должен совпадать с ключом marketplace. Вы всё ещё включаете каждый plugin отдельно в `enabledPlugins`. Этот пример объявляет один plugin встроенным:

4939 4938 


4959}4958}

4960```4959```

4961 4960 

4962Запись plugin под `source: 'settings'`, чей собственный `source` — это [`archive`](/docs/ru/plugin-marketplaces#zip-archives), может установить `headers` для загрузки архива. Если значение, которое вы бы поместили в `headers`, недолговечно, такое как token, который ваш registry чеканит по запросу, установите вместо этого команду `headersHelper`. Запись может установить оба. Оба поля требуют Claude Code v2.1.238 или позже.4961Запись plugin под `source: 'settings'`, чей собственный `source` — это [`archive`](/docs/ru/plugin-marketplaces#zip-archives), может установить `headers` для загрузки архива. Если значение, которое вы поместили бы в `headers`, недолговечно, такое как токен, который ваш реестр чеканит по запросу, установите вместо этого команду `headersHelper`. Запись может установить оба. Оба поля требуют Claude Code v2.1.238 или позже.

4963 4962 

4964Claude Code отправляет `headers` записи и всё, что печатает команда, с загрузкой архива этого plugin и ни с какой другой загрузкой. Claude Code запускает команду только когда пользователь [устанавливает или обновляет только этот один plugin](/docs/ru/plugin-marketplaces#how-users-accept-a-headershelper-command). Три дополнительных правила зависят от того, какой файл содержит запись:4963Claude Code отправляет `headers` записи и всё, что печатает команда, с загрузкой архива этого plugin и ни с какой другой загрузкой. Claude Code запускает команду только когда пользователь [устанавливает или обновляет этот один plugin сам](/docs/ru/plugin-marketplaces#how-users-accept-a-headershelper-command). Три дополнительных правила зависят от того, какой файл содержит запись:

4965 4964 

4966* **`strict`**: в отличие от записи в `marketplace.json` marketplace, запись в settings не нуждается в `"strict": false`, потому что settings файл не несёт полей manifest для встраивания. См. [Strict mode](/docs/ru/plugin-marketplaces#strict-mode).4965* **`strict`**: в отличие от записи в `marketplace.json` marketplace, запись в параметрах не нуждается в `"strict": false`, потому что файл параметров не несёт полей манифеста для встраивания. См. [Strict mode](/docs/ru/plugin-marketplaces#strict-mode).

4967* **Folder trust**: для записи в project's `.claude/settings.json` или `.claude/settings.local.json`, Claude Code запускает команду только после того, как пользователь также [доверил эту папку](/docs/ru/permissions#what-runs-before-you-trust-a-folder).4966* **Folder trust**: для записи в `.claude/settings.json` или `.claude/settings.local.json` проекта Claude Code запускает команду только после того, как пользователь также [доверил эту папку](/docs/ru/permissions#what-runs-before-you-trust-a-folder).

4968* **Header filter**: Claude Code удаляет [request-routing и client-identity имена headers](/docs/ru/plugin-marketplaces#when-claude-code-skips-a-headershelper-command-or-drops-its-output) из записи в project's `.claude/settings.json` или `.claude/settings.local.json`, потому что репозиторий может поставлять эти файлы. Claude Code применяет тот же фильтр к записи каталога и к записи в папке `--add-dir` settings, и никакой фильтр к записи в ваши user settings, файл `--settings` или managed settings.4967* **Header filter**: Claude Code удаляет [имена headers маршрутизации запросов и идентификации клиента](/docs/ru/plugin-marketplaces#when-claude-code-skips-a-headershelper-command-or-drops-its-output) из записи в `.claude/settings.json` или `.claude/settings.local.json` проекта, потому что репозиторий может предоставить эти файлы. Claude Code применяет тот же фильтр к записи каталога и к записи в папке `--add-dir`, и никакой фильтр к записи в ваших пользовательских параметрах, файле `--settings` или управляемых параметрах.

4969 4968 

4970<h4 id="marketplace-key-aliases">4969<h4 id="marketplace-key-aliases">

4971 Marketplace key aliases4970 Marketplace key aliases

4972</h4>4971</h4>

4973 4972 

4974На Claude Code v2.1.232 или позже, вы можете написать `extraKnownMarketplaces` как `additionalMarketplaces` и `strictKnownMarketplaces` как `allowedMarketplaces`. Claude Code рассматривает каждый alias следующим образом:4973На Claude Code v2.1.232 или позже вы можете написать `extraKnownMarketplaces` как `additionalMarketplaces` и `strictKnownMarketplaces` как `allowedMarketplaces`. Claude Code рассматривает каждый alias следующим образом:

4975 4974 

4976* Более ранние версии игнорируют alias, поэтому сохраняйте каноническое написание в файле, который также читают более старые версии, такой как managed settings файл для флота со смешанными версиями Claude Code.4975* Более ранние версии игнорируют alias, поэтому сохраняйте каноническое написание в файле, который также читают более старые версии, такой как файл управляемых параметров для флота со смешанными версиями Claude Code.

4977* В любом settings файле, который принимает канонический ключ, Claude Code читает alias точно так же, как он читает канонический ключ.4976* В любом файле параметров, который принимает канонический ключ, Claude Code читает alias точно так же, как он читает канонический ключ.

4978* Claude Code может переписать `additionalMarketplaces` на `extraKnownMarketplaces`, когда он обновляет файл.4977* Claude Code может переписать `additionalMarketplaces` на `extraKnownMarketplaces` при обновлении файла.

4979* Если вы установите оба написания в одном файле, Claude Code использует каноническое значение и игнорирует alias.4978* Если вы установите оба написания в одном файле, Claude Code использует каноническое значение и игнорирует alias.

4980 4979 

4981<h3 id="pluginconfigs">4980<h3 id="pluginconfigs">

4982 `pluginConfigs`4981 `pluginConfigs`

4983</h3>4982</h3>

4984 4983 

4985Сохраняйте non-sensitive ответы, которые вы даёте диалогу конфигурации [`userConfig`](/docs/ru/plugins-reference#user-configuration) plugin, ключ по ID plugin. Claude Code записывает этот ключ в ваши user settings, когда вы заполняете диалог, поэтому вам не нужно редактировать его вручную. Claude Code сохраняет sensitive опции в macOS Keychain вместо этого, возвращаясь к `~/.claude/.credentials.json`, когда Keychain отклоняет запись; на платформах без поддерживаемого keychain, он сохраняет их в `~/.claude/.credentials.json`.4984Сохраняйте неконфиденциальные ответы, которые вы даёте диалогу конфигурации [`userConfig`](/docs/ru/plugins-reference#user-configuration) plugin, обозначенные по ID plugin. Claude Code записывает этот ключ в ваши пользовательские параметры при заполнении диалога, поэтому вам не нужно редактировать его вручную. Claude Code сохраняет конфиденциальные опции в macOS Keychain вместо этого, возвращаясь к `~/.claude/.credentials.json`, когда Keychain отклоняет запись; на платформах без поддерживаемого keychain он сохраняет их в `~/.claude/.credentials.json`.

4986 4985 

4987* **Scope**: [`User or managed`](#scopes)4986* **Scope**: [`User or managed`](#scopes)

4988* **Type**: объект, отображающий ID plugin на объект с полем `options`, отображающим каждое имя опции на string, number, Boolean или массив strings, и опциональное поле `mcpServers`, содержащее per-server user configuration значения в той же форме4987* **Type**: object, отображающий ID plugin на объект с полем `options`, отображающим каждое имя опции на строку, число, Boolean или массив строк, и необязательное поле `mcpServers`, содержащее значения конфигурации пользователя для каждого сервера в той же форме

4989* **Default**: не установлено4988* **Default**: не установлено

4990 4989 

4991Этот пример сохраняет опцию `api_endpoint` для plugin `deployer` из `acme-tools`:4990Этот пример сохраняет опцию `api_endpoint` для plugin `deployer` из `acme-tools`:


5002}5001}

5003```5002```

5004 5003 

5005Built-in plugins сохраняют свои опции под тем же ключом с суффиксом `@builtin`. Например, [**Project instructions**](/docs/ru/memory#choose-which-instruction-files-load) настройка, которая контролирует, читает ли Claude Code файлы `AGENTS.md`, — это `pluginConfigs["agents-md@builtin"].options.instructionFiles`.5004Встроенные plugins сохраняют свои опции под тем же ключом с суффиксом `@builtin`. Например, параметр [**Project instructions**](/docs/ru/memory#choose-which-instruction-files-load), который контролирует, читает ли Claude Code файлы `AGENTS.md`, — это `pluginConfigs["agents-md@builtin"].options.instructionFiles`.

5006 5005 

5007Claude Code игнорирует project и local записи, потому что он подставляет эти значения в plugin hook, MCP и LSP конфигурации, и клонированный репозиторий не должен быть в состоянии их поставлять. До v2.1.207, project и local settings также читались.5006Claude Code игнорирует записи project и local, потому что он подставляет эти значения в конфигурации plugin hook, MCP и LSP, и клонированный репозиторий не должен быть в состоянии их предоставить. До v2.1.207 параметры project и local также читались.

5008 5007 

5009<h2 id="mcp">5008<h2 id="mcp">

5010 MCP5009 MCP

skills.md +10 −0

Details

1166 1166 

1167Чтобы увеличить бюджет, установите параметр [`skillListingBudgetFraction`](/docs/ru/settings-reference#skilllistingbudgetfraction) (например `0.02` = 2%) или переменную окружения `SLASH_COMMAND_TOOL_CHAR_BUDGET` на фиксированное количество символов. Чтобы освободить бюджет для других skills, установите записи с низким приоритетом на `"name-only"` в [`skillOverrides`](#override-skill-visibility-from-settings), чтобы они отображались без описания. Вы также можете сократить текст `description` и `when_to_use` в источнике: поместите основной вариант использования в первую очередь, так как объединённый текст каждой записи ограничен 1536 символами независимо от бюджета. Ограничение настраивается с помощью [`skillListingMaxDescChars`](/docs/ru/settings-reference#skilllistingmaxdescchars).1167Чтобы увеличить бюджет, установите параметр [`skillListingBudgetFraction`](/docs/ru/settings-reference#skilllistingbudgetfraction) (например `0.02` = 2%) или переменную окружения `SLASH_COMMAND_TOOL_CHAR_BUDGET` на фиксированное количество символов. Чтобы освободить бюджет для других skills, установите записи с низким приоритетом на `"name-only"` в [`skillOverrides`](#override-skill-visibility-from-settings), чтобы они отображались без описания. Вы также можете сократить текст `description` и `when_to_use` в источнике: поместите основной вариант использования в первую очередь, так как объединённый текст каждой записи ограничен 1536 символами независимо от бюджета. Ограничение настраивается с помощью [`skillListingMaxDescChars`](/docs/ru/settings-reference#skilllistingmaxdescchars).

1168 1168 

1169<h3 id="personal-skills-disappeared">

1170 Personal skills disappeared

1171</h3>

1172 

1173Если папки skills, которые вы создали в `~/.claude/skills/`, исчезли, посмотрите в `~/.claude/skills/.trash/`. Когда Claude Code [синхронизирует skills из claude.ai](#how-synced-skills-behave), он загружает их в отдельную подпапку `synced` и не перемещает и не удаляет папки, которые вы создаёте.

1174 

1175До v2.1.280 файл с именем `manifest.json` в `~/.claude/skills/` заставлял Claude Code перемещать папки skills, которые этот файл указывал, в папку с временной меткой под `~/.claude/skills/.trash/`, и эти skills перестали загружаться.

1176 

1177Чтобы восстановить skill, переместите его папку из папки с временной меткой обратно в `~/.claude/skills/`. Сделайте это до того, как [очистка хранилища](/docs/ru/claude-directory#cleaned-up-automatically) удалит записи из корзины, по умолчанию через 30 дней после их перемещения в корзину.

1178 

1169<h2 id="related-resources">1179<h2 id="related-resources">

1170 Связанные ресурсы1180 Связанные ресурсы

1171</h2>1181</h2>

ultrareview.md +25 −19

Details

157 157 

158Используйте `/tasks` для просмотра выполняемых и завершенных анализов, открытия подробного представления анализа или остановки выполняемого анализа. Если вы остановите анализ, Claude Code архивирует облачную сессию и не возвращает частичные результаты.158Используйте `/tasks` для просмотра выполняемых и завершенных анализов, открытия подробного представления анализа или остановки выполняемого анализа. Если вы остановите анализ, Claude Code архивирует облачную сессию и не возвращает частичные результаты.

159 159 

160Claude также может сообщить вам, что анализ был остановлен или что его сессия не была найдена:

161 

162* Если облачная сессия анализа остановлена или [архивирована](/docs/ru/claude-code-on-the-web#archive-sessions) на claude.ai до завершения анализа, Claude сообщит вам, что она была остановлена.

163* Если облачная сессия анализа была удалена, или вы вошли в другой аккаунт Claude или организацию с момента её запуска, Claude сообщит вам, что сессия не была найдена.

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

165 

160Когда анализ завершится, Claude Code показывает проверенные результаты как уведомление в вашей сессии. Каждый результат включает расположение файла и объяснение проблемы, чтобы вы могли попросить Claude исправить это напрямую.166Когда анализ завершится, Claude Code показывает проверенные результаты как уведомление в вашей сессии. Каждый результат включает расположение файла и объяснение проблемы, чтобы вы могли попросить Claude исправить это напрямую.

161 167 

162<h2 id="run-ultrareview-non-interactively">168<h2 id="run-ultrareview-non-interactively">

163 Запуск ultrareview неинтерактивно169 Запуск ultrareview неинтерактивно

164</h2>170</h2>

165 171 

166Используйте подкоманду `claude ultrareview` для запуска ultrareview из CI или скрипта без интерактивной сессии. Подкоманда запускает тот же анализ, что и `/code-review ultra`, блокирует до завершения удаленного анализа и выводит результаты в stdout.172Используйте подкоманду `claude ultrareview` для запуска ultrareview из CI или скрипта без интерактивной сессии. Подкоманда запускает тот же обзор, что и `/code-review ultra`, блокирует выполнение до завершения удалённого обзора и выводит результаты в stdout.

167 173 

168```bash theme={null}174```bash theme={null}

169claude ultrareview175claude ultrareview


171claude ultrareview origin/main177claude ultrareview origin/main

172```178```

173 179 

174Без аргументов подкоманда анализирует разницу между вашей текущей ветвью и ветвью по умолчанию, с тем же [резервным вариантом для всего репозитория](#diff-limits-and-fallbacks), что и `/code-review ultra`, когда база слияния не существует. Передайте номер PR для анализа запроса на слияние или базовую ветвь для анализа против нее; [обработка базовой ветви](#review-against-a-different-base) соответствует интерактивной команде.180Без аргументов подкоманда проверяет разницу между вашей текущей веткой и веткой по умолчанию, с тем же [резервным вариантом для всего репозитория](#diff-limits-and-fallbacks), что и `/code-review ultra`, когда база слияния не существует. Передайте номер PR для проверки pull request или базовую ветку для проверки относительно неё; [обработка базовой ветки](#review-against-a-different-base) соответствует интерактивной команде.

175 181 

176Вы даете согласие на резервный вариант для всего репозитория и на подсказку выставления счетов и условий при запуске подкоманды, поэтому запуск начинается без ожидания ввода. Запуск его самостоятельно — это то, что считается согласием. Когда Claude запускает подкоманду для вас вместо этого, например через инструмент Bash, Claude Code отказывает в анализе всего репозитория.182Вы даёте согласие на резервный вариант для всего репозитория и на подтверждение выставления счёта и условия при запуске подкоманды, поэтому выполнение начинается без ожидания ввода. Запуск её самостоятельно — это то, что считается согласием. Когда Claude запускает подкоманду для вас, например через инструмент Bash, Claude Code отказывает в проверке всего репозитория.

177 183 

178В Claude Code v2.1.218 или позже вы также можете запустить облачный анализ, запустив `/code-review ultra` в неинтерактивной сессии, например `claude -p '/code-review ultra'`. Claude Code запускает анализ и выводит ссылку отслеживания без ожидания результатов, в отличие от `claude ultrareview`, который блокирует до их получения. Когда анализ будет выставлять счета за использование кредитов, Claude Code останавливается перед запуском и указывает вам на `claude ultrareview`, потому что подтверждение выставления счетов требует интерактивной сессии. До v2.1.218 `/code-review ultra` в неинтерактивной сессии запускал локальный анализ.184На Claude Code v2.1.218 или позже вы также можете запустить облачный обзор, выполнив `/code-review ultra` в неинтерактивной сессии, например `claude -p '/code-review ultra'`. Claude Code запускает обзор и выводит ссылку отслеживания без ожидания результатов, в отличие от `claude ultrareview`, который блокирует выполнение до их получения. Когда обзор будет выставлять счёт за использование кредитов, Claude Code останавливается перед запуском и указывает вам на `claude ultrareview`, потому что подтверждение выставления счёта требует интерактивной сессии. До v2.1.218 `/code-review ultra` в неинтерактивной сессии запускал локальный обзор.

179 185 

180Сообщения о ходе выполнения и URL живой сессии идут в stderr, чтобы stdout оставался анализируемым. Используйте эти флаги для управления выводом, тайм-аутом и тем, публиковать ли результаты:186Сообщения о ходе выполнения и URL живой сессии идут в stderr, чтобы stdout оставался пригодным для анализа. Используйте эти флаги для управления выводом, тайм-аутом и тем, следует ли публиковать результаты:

181 187 

182| Флаг | Описание |188| Флаг | Описание |

183| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |189| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

184| `--json` | Выведите необработанный полезный груз `bugs.json` вместо отформатированных результатов |190| `--json` | Выведите необработанный payload `bugs.json` вместо отформатированных результатов |

185| `--timeout <minutes>` | Максимальное количество минут для ожидания завершения анализа. По умолчанию 45 |191| `--timeout <minutes>` | Максимальное количество минут для ожидания завершения обзора. По умолчанию 45 |

186| `--post` | [Опубликуйте готовые результаты](#post-findings-to-the-pull-request) в запросе на слияние как один простой комментарий с вашего аккаунта GitHub. Работает на целевых запросах на слияние `github.com`; на других целевых объектах Claude Code игнорирует флаг и сообщает об этом. Требует Claude Code v2.1.227 или позже |192| `--post` | [Опубликуйте готовые результаты](#post-findings-to-the-pull-request) в pull request как один простой комментарий с вашего аккаунта GitHub. Работает на целевых pull request на `github.com`; на других целевых объектах Claude Code игнорирует флаг и сообщает об этом. Требует Claude Code v2.1.227 или позже |

187| `--no-post` | Не публикуйте результаты. Это значение по умолчанию, и если вы передадите оба флага, Claude Code не публикует. Требует Claude Code v2.1.227 или позже |193| `--no-post` | Не публикуйте результаты. Это значение по умолчанию, и если вы передадите оба флага, Claude Code не будет публиковать. Требует Claude Code v2.1.227 или позже |

188 194 

189Запуск `claude ultrareview` требует той же аутентификации и конфигурации дополнительного использования, что и `/code-review ultra`.195Запуск `claude ultrareview` требует той же аутентификации и конфигурации кредитов использования, что и `/code-review ultra`.

190 196 

191Подкоманда выходит с одним из трех кодов:197Подкоманда завершается с одним из трёх кодов:

192 198 

193* **0**: анализ завершен, с результатами или без них199* **0**: обзор завершился, с результатами или без них

194* **1**: анализ не запустился, облачная сессия ошибилась или истек тайм-аут200* **1**: обзор не запустился или был остановлен до завершения, облачная сессия ошибилась или истёк тайм-аут

195* **130**: вы прервали подкоманду с помощью Ctrl-C201* **130**: вы прервали подкоманду с помощью Ctrl-C

196 202 

197Если вы прерываете подкоманду, удаленный анализ продолжает работать; следите за URL сессии, выведенным в stderr, чтобы смотреть его в браузере.203Если вы прервёте подкоманду, удалённый обзор продолжит работу; следуйте по ссылке сессии, выведённой в stderr, чтобы наблюдать за ней в браузере.

198 204 

199С флагом `--post` подкоманда начинает публикацию сразу после вывода результатов, и выводит ссылку в stderr.205С флагом `--post` подкоманда начинает публикацию сразу после вывода результатов и выводит ссылку в stderr.

200 206 

201* Если запуск не удается, истекает тайм-аут или вы его прерываете, подкоманда ничего не публикует.207* Если выполнение не удаётся, остановлено, истекает тайм-аут или вы его прерываете, подкоманда ничего не публикует.

202* Если анализ завершается, но комментарий не опубликован, Claude Code выводит причину в stderr, а результаты остаются в stdout, чтобы вы могли опубликовать их вручную.208* Если обзор завершится, но комментарий не будет опубликован, Claude Code выведет причину в stderr, а результаты останутся в stdout, чтобы вы могли опубликовать их вручную.

203 209 

204Для автоматических анализов запросов на слияние GitHub [Code Review](/docs/ru/code-review) интегрируется непосредственно с вашим репозиторием и публикует результаты как встроенные комментарии PR без этапа CLI.210Для автоматических обзоров на pull request GitHub [Code Review](/docs/ru/code-review) интегрируется с вашим репозиторием напрямую и публикует результаты как встроенные комментарии PR без этапа CLI.

205 211 

206<h2 id="how-ultrareview-compares-to-/code-review">212<h2 id="how-ultrareview-compares-to-/code-review">

207 Как ultrareview сравнивается с /code-review213 Как ultrareview сравнивается с /code-review

Details

65 Удержание для записи65 Удержание для записи

66</h2>66</h2>

67 67 

68Режим удержания — это push-to-talk: запись выполняется, пока вы удерживаете клавишу, и останавливается при отпускании. Это режим по умолчанию.68Режим удержания — это push-to-talk: запись выполняется, пока вы удерживаете клавишу, и останавливается при её отпускании. Это режим по умолчанию.

69 69 

70Удерживайте `Space` для начала записи. Claude Code обнаруживает удерживаемую клавишу, отслеживая быстрые события повтора клавиш от вашего терминала, поэтому перед началом записи есть краткий период прогрева. Нижний колонтитул показывает `keep holding…` во время прогрева, затем `listening…` после активации записи. Во время записи курсор подсказки становится полосой, которая поднимается и опускается в соответствии с уровнем вашего микрофона, если у вас не включена опция [`prefersReducedMotion`](/docs/ru/settings-reference#prefersreducedmotion).70Удерживайте `Space` для начала записи. Claude Code обнаруживает удерживаемую клавишу, отслеживая события быстрого повтора клавиш из вашего терминала, поэтому перед началом записи есть краткий период прогрева. Нижняя панель показывает `keep holding…` во время прогрева, затем `listening…` после активации записи. Во время записи курсор приглашения становится полосой, которая поднимается и опускается в соответствии с уровнем микрофона, если у вас не включена опция [`prefersReducedMotion`](/docs/ru/settings-reference#prefersreducedmotion).

71 71 

72Первые несколько символов повтора клавиши печатаются в ввод во время прогрева и автоматически удаляются при активации записи. Одиночное нажатие `Space` все еще печатает пробел, так как обнаружение удержания срабатывает только при быстром повторении.72Первые несколько символов повтора клавиши вводятся в приглашение во время прогрева и автоматически удаляются при активации записи. Одиночное нажатие `Space` по-прежнему вводит пробел, так как обнаружение удержания срабатывает только при быстром повторении.

73 

74Удержание или нажатие `Space` запускает диктовку только там, где нажатие клавиши иначе вводило бы текст в приглашение. В [средстве просмотра транскрипции](/docs/ru/interactive-mode#transcript-viewer) `Space` листает разговор, а в [режиме vim](/docs/ru/interactive-mode#vim-editor-mode) вне режима INSERT это команда. [Переназначенная комбинация модификаторов](#rebind-the-dictation-key) как `meta+k` никогда не вводит текст, поэтому она также запускает диктовку из этих мест.

73 75 

74<Tip>76<Tip>

75 Чтобы пропустить прогрев, переключитесь на [режим нажатия](#tap-to-record-and-send) с помощью `/voice tap` или [переназначьте на комбинацию модификаторов](#rebind-the-dictation-key), такую как `meta+k`. Комбинации модификаторов начинают запись при первом нажатии клавиши.77 Чтобы пропустить прогрев, переключитесь на [режим касания](#tap-to-record-and-send) с помощью `/voice tap` или [переназначьте на комбинацию модификаторов](#rebind-the-dictation-key) как `meta+k`. Комбинации модификаторов начинают запись при первом нажатии клавиши.

76</Tip>78</Tip>

77 79 

78Ваша речь появляется в запросе по мере того, как вы говорите, затемненная до завершения транскрибирования. Отпустите `Space` для остановки записи и завершения текста. Транскрибирование вставляется в позицию вашего курсора, и курсор остается в конце вставленного текста, поэтому вы можете смешивать печать и диктовку в любом порядке. Удерживайте `Space` снова для добавления еще одной записи или сначала переместите курсор для вставки речи в другое место в запросе:80Ваша речь появляется в приглашении по мере того, как вы говорите, затемнённая до завершения транскрипции. Отпустите `Space` для остановки записи и завершения текста. Транскрипция вставляется в позицию вашего курсора, и курсор остаётся в конце вставленного текста, поэтому вы можете смешивать печать и диктовку в любом порядке. Удерживайте `Space` снова, чтобы добавить ещё одну запись, или сначала переместите курсор, чтобы вставить речь в другое место в приглашении:

79 81 

80```82```

81> refactor the auth middleware to ▮83> refactor the auth middleware to ▮

82 # hold Space, speak "use the new token validation helper"84 # hold space, speak "use the new token validation helper"

83> refactor the auth middleware to use the new token validation helper▮85> refactor the auth middleware to use the new token validation helper▮

84```86```

85 87 

86По умолчанию при отпускании клавиши Claude Code вставляет транскрибирование и ждет, пока вы нажмете `Enter`. Установите `"autoSubmit": true` в объекте настроек `voice` для автоматической отправки запроса при отпускании клавиши, при условии, что транскрибирование содержит не менее трех слов.88По умолчанию при отпускании клавиши Claude Code вставляет транскрипцию и ждёт, пока вы нажмёте `Enter`. Установите `"autoSubmit": true` в объекте параметров `voice`, чтобы отправить приглашение автоматически при отпускании клавиши, при условии, что транскрипция содержит как минимум три слова.

87 89 

88<h2 id="tap-to-record-and-send">90<h2 id="tap-to-record-and-send">

89 Нажатие для записи и отправки91 Нажатие для записи и отправки


99 101 

100Первое нажатие начинает запись только при пустом поле ввода запроса, поэтому вы все еще можете нормально печатать пробелы при составлении сообщения. Второе нажатие останавливает запись независимо от содержимого ввода. Запись также автоматически останавливается после 15 секунд молчания или двух минут в целом.102Первое нажатие начинает запись только при пустом поле ввода запроса, поэтому вы все еще можете нормально печатать пробелы при составлении сообщения. Второе нажатие останавливает запись независимо от содержимого ввода. Запись также автоматически останавливается после 15 секунд молчания или двух минут в целом.

101 103 

104<h2 id="cancel-a-recording">

105 Отмена записи

106</h2>

107 

108Нажмите `Esc` или `Ctrl+C`, чтобы отменить диктовку вместо её завершения. Claude Code останавливает микрофон, отбрасывает транскрипцию и восстанавливает приглашение в том состоянии, в котором оно находилось до начала записи.

109 

110Обе клавиши также отменяют запись, пока транскрипция завершённой записи всё ещё обрабатывается. Приглашение, которое вы отредактировали или отправили во время обработки, остаётся в том виде, в котором вы его оставили.

111 

112Ни одна из этих клавиш не делает ничего другого при нажатии, которое отменяет запись: `Esc` не прерывает ответ Claude, а `Ctrl+C` не очищает приглашение и не считается первым из [двух нажатий, которые выходят из Claude Code](/docs/ru/interactive-mode#general-controls).

113 

102<h2 id="change-the-dictation-language">114<h2 id="change-the-dictation-language">

103 Изменение языка диктовки115 Изменение языка диктовки

104</h2>116</h2>

vs-code.md +24 −1

Details

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

114 * **Manual**: Claude запрашивает разрешение перед редактированием файлов и большинством команд оболочки.114 * **Manual**: Claude запрашивает разрешение перед редактированием файлов и большинством команд оболочки.

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

116 

117 Вы также можете ввести `/plan` в поле ввода подсказки. Требует Claude Code v2.1.280 или позже.

118 

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

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

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

116 * **Edit automatically**: Claude вносит изменения без запроса.122 * **Edit automatically**: Claude вносит изменения без запроса.

117* **Model**: выберите **Switch model…** из меню команд, чтобы изменить модель во время сеанса. Вы также можете нажать на имя модели в нижней части поля ввода подсказки, чтобы открыть тот же выбор.123* **Model**: выберите **Switch model…** из меню команд, чтобы изменить модель во время сеанса. Вы также можете нажать на имя модели в нижней части поля ввода подсказки, чтобы открыть тот же выбор.

118 124 

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

120* **Command menu**: нажмите `/` или введите `/`, чтобы открыть меню команд. Опции включают присоединение файлов, переключение моделей и переключение расширенного мышления.126* **Command menu**: нажмите `/` или введите `/`, чтобы открыть меню команд. Опции включают присоединение файлов, переключение моделей и переключение расширенного мышления.

121 127 

122 Раздел Customize предоставляет доступ к серверам MCP, slash commands, стилям вывода, hooks, памяти, инструкциям, разрешениям и плагинам. Элементы со значком терминала открываются в интегрированном терминале.128 Раздел Customize предоставляет доступ к серверам MCP, commands, стилям вывода, hooks, памяти, инструкциям, разрешениям и плагинам. Элементы со значком терминала открываются в интегрированном терминале.

123 129 

124 * Для просмотра команд, таких как `/usage` или [`/remote-control`](/docs/ru/remote-control), выберите **Slash commands** в разделе Customize. Диалог отображает их с полем фильтра. Выберите один для его запуска. Ввод `/` в поле ввода подсказки по-прежнему предлагает команды встроенным образом. Требует Claude Code v2.1.257 или позже.130 * Для просмотра команд, таких как `/usage` или [`/remote-control`](/docs/ru/remote-control), выберите **Slash commands** в разделе Customize. Диалог отображает их с полем фильтра. Выберите один для его запуска. Ввод `/` в поле ввода подсказки по-прежнему предлагает команды встроенным образом. Требует Claude Code v2.1.257 или позже.

131 

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

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

126 134 

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


131 139 

132 Нажмите на сохраненное воспоминание, чтобы прочитать его в диалоге, где вы можете редактировать текст, удалить воспоминание или открыть его файл в редакторе. Просмотр, редактирование и удаление воспоминания в диалоге требуют Claude Code v2.1.275 или позже.140 Нажмите на сохраненное воспоминание, чтобы прочитать его в диалоге, где вы можете редактировать текст, удалить воспоминание или открыть его файл в редакторе. Просмотр, редактирование и удаление воспоминания в диалоге требуют Claude Code v2.1.275 или позже.

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

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

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

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

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

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

135 147 

136 Когда вы включаете или выключаете переключатель в окне VS Code, изменение применяется к сеансам, уже открытым в этом окне VS Code, а не только к сеансам, которые вы запускаете позже. Если вы его выключите, открытые сеансы отключатся. С Claude Code v2.1.261 или позже изменение также достигает сеансов, открытых в ваших других окнах VS Code.148 Когда вы включаете или выключаете переключатель в окне VS Code, изменение применяется к сеансам, уже открытым в этом окне VS Code, а не только к сеансам, которые вы запускаете позже. Если вы его выключите, открытые сеансы отключатся. С Claude Code v2.1.261 или позже изменение также достигает сеансов, открытых в ваших других окнах VS Code.


183* Чтобы прикрепить файлы, удерживайте `Shift` при перетаскивании их в поле ввода подсказки.195* Чтобы прикрепить файлы, удерживайте `Shift` при перетаскивании их в поле ввода подсказки.

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

185 197 

198<h3 id="paste-text">

199 Вставка текста

200</h3>

201 

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

203 

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

205 

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

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

208 

186<h3 id="resume-past-conversations">209<h3 id="resume-past-conversations">

187 Возобновление прошлых разговоров210 Возобновление прошлых разговоров

188</h3>211</h3>

Details

7> Запустите Claude Code в облаке из браузера или мобильного приложения. Подключите репозиторий GitHub, отправьте задачу и просмотрите PR без локальной настройки.7> Запустите Claude Code в облаке из браузера или мобильного приложения. Подключите репозиторий GitHub, отправьте задачу и просмотрите PR без локальной настройки.

8 8 

9<Note>9<Note>

10 Облачные сеансы находятся в исследовательском предпросмотре для пользователей Pro, Max и Team, а также для пользователей Enterprise с премиум-местами или местами Chat + Claude Code.10 Облачные сеансы доступны в планах Pro, Max и Team, а также для пользователей Enterprise с премиум-местами или местами Chat + Claude Code.

11</Note>11</Note>

12 12 

13Облачный сеанс запускает Claude Code на облачной инфраструктуре вместо вашей машины, управляемой Anthropic по умолчанию. Этот краткий старт запускает один с [claude.ai/code](https://claude.ai/code) в вашем браузере. Вы также можете запустить один из мобильного приложения Claude, приложения Desktop или вашего терминала с помощью `claude --cloud`.13Облачный сеанс запускает Claude Code на облачной инфраструктуре вместо вашей машины, управляемой Anthropic по умолчанию. Этот краткий старт запускает один с [claude.ai/code](https://claude.ai/code) в вашем браузере. Вы также можете запустить один из мобильного приложения Claude, приложения Desktop или вашего терминала с помощью `claude --cloud`.

workflows.md +9 −7

Details

231 231 

232До версии 2.1.216 Claude Code следовал ссылке, что могло поместить файл вне выбранного вами местоположения.232До версии 2.1.216 Claude Code следовал ссылке, что могло поместить файл вне выбранного вами местоположения.

233 233 

234В монорепо с несколькими каталогами `.claude/` вы можете хранить workflows рядом с пакетом, к которому они применяются. Начиная с версии 2.1.178, сохранение в местоположение проекта записывает в ближайший каталог `.claude/workflows/`, который уже существует между вашей рабочей директорией и корнем репозитория, или в корень репозитория, если ни один ещё не существует. Workflows проекта также загружаются из каждого `.claude/workflows/` вдоль этого пути, и когда более одного определяет одно имя, Claude Code запускает тот, который ближе всего к рабочей директории.234В монорепо с несколькими каталогами `.claude/` вы можете хранить workflows рядом с пакетом, к которому они применяются. Сохранение в местоположение проекта записывает в ближайший каталог `.claude/workflows/`, который уже существует между вашей рабочей директорией и корнем репозитория, или в корень репозитория, если ни один ещё не существует. Workflows проекта также загружаются из каждого `.claude/workflows/` вдоль этого пути, и когда более одного определяет одно имя, Claude Code запускает тот, который ближе всего к рабочей директории.

235 235 

236Если project workflow и personal workflow имеют одно имя, запускается project.236Если project workflow и personal workflow имеют одно имя, запускается project.

237 237 


348 348 

349Тело — это простой JavaScript с top-level `await`. `agent()` создаёт один подагент, `pipeline()` запускает один на элемент в списке, а `parallel()` запускает набор задач агента одновременно и ждёт завершения всех из них.349Тело — это простой JavaScript с top-level `await`. `agent()` создаёт один подагент, `pipeline()` запускает один на элемент в списке, а `parallel()` запускает набор задач агента одновременно и ждёт завершения всех из них.

350 350 

351Вызов `agent()` разрешается в `null`, если вы остановите его во время выполнения или он столкнётся с неустранимой ошибкой API. В [режиме auto](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) классификатор может заблокировать вызов `agent()` перед запуском подагента. Заблокированный вызов разрешается в `null` и отображается в представлении прогресса запуска с причиной. `pipeline()` сохраняет каждый `null` в массиве результатов, поэтому пример заканчивается на `.filter(Boolean)`, чтобы удалить эти записи.351Вызов `agent()` разрешается в `null`, если вы остановите его во время выполнения или он столкнётся с неустранимой ошибкой API. `pipeline()` сохраняет каждый `null` в массиве результатов, поэтому пример заканчивается на `.filter(Boolean)`, чтобы удалить эти записи.

352 

353В [режиме auto](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) подсказка, которую ваш скрипт передаёт в `agent()`, не считается запросом от вас, когда классификатор проверяет действия этого подагента, потому что Claude Code отмечает её как текст, вычисленный скриптом.

352 354 

353Если вы передаёте `schema` при вызове `agent()`, этот подагент возвращает JSON, соответствующий форме, вместо прозы. Claude Code проверяет схему перед запуском подагента: когда он может доказать, что схема противоречит сама себе, вызов завершается с ошибкой, называющей противоречие, и подагент никогда не запускается. Одно противоречие, которое он может доказать, — это ключ `required`, который `additionalProperties: false` исключает.355Если вы передаёте `schema` при вызове `agent()`, этот подагент возвращает JSON, соответствующий форме, вместо прозы. Claude Code проверяет схему перед запуском подагента: когда он может доказать, что схема противоречит сама себе, вызов завершается с ошибкой, называющей противоречие, и подагент никогда не запускается. Одно противоречие, которое он может доказать, — это ключ `required`, который `additionalProperties: false` исключает.

354 356 


377 379 

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

379 381 

380Каждый запуск записывает свой скрипт в файл в каталоге вашей сессии в `~/.claude/projects/`. Claude получает путь при запуске, поэтому вы можете попросить его. Вы можете открыть этот файл, чтобы прочитать оркестровку, которую написал Claude, сравнить его со скриптом предыдущего запуска или отредактировать его и попросить Claude перезапустить с отредактированной версией.382Каждый запуск записывает свой скрипт в файл в каталоге вашей сессии в `~/.claude/projects/`. Claude получает путь при запуске, поэтому вы можете попросить его. Вы можете открыть этот файл, чтобы прочитать оркестровку, которую написал Claude, сравнить его с скриптом предыдущего запуска или отредактировать его и попросить Claude перезапустить с отредактированной версией.

381 383 

382Claude может запустить workflow только из файла скрипта, который сессия уже имеет право читать. Чтобы запустить скрипт, находящийся вне вашего рабочего каталога, сначала добавьте его каталог с помощью [`/add-dir`](/docs/ru/permissions#working-directories) или [правила Read](/docs/ru/permissions#read-and-edit).384Claude может запустить workflow только из файла скрипта, который сессия уже имеет право читать. Чтобы запустить скрипт, находящийся вне вашего рабочего каталога, сначала добавьте его каталог с помощью [`/add-dir`](/docs/ru/permissions#working-directories) или [правила Read](/docs/ru/permissions#read-and-edit).

383 385 


400Среда выполнения применяет следующие ограничения:402Среда выполнения применяет следующие ограничения:

401 403 

402| Ограничение | Причина |404| Ограничение | Причина |

403| :--------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |405| :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

404| Нет ввода пользователя во время выполнения | Запуск приостанавливается самостоятельно только для запросов разрешения агента и [ожидания лимита использования](#when-a-run-hits-your-usage-limit). Для утверждения между этапами запустите каждый этап как отдельный workflow |406| Нет ввода пользователя во время выполнения | Запуск приостанавливается самостоятельно только для запросов разрешения агента и [ожидания лимита использования](#when-a-run-hits-your-usage-limit). Для утверждения между этапами запустите каждый этап как отдельный workflow |

405| Нет прямого доступа к файловой системе или shell из самого workflow | Агенты читают, записывают и выполняют команды. Скрипт координирует агентов |407| Нет прямого доступа к файловой системе или shell из самого workflow | Агенты читают, записывают и выполняют команды. Скрипт координирует агентов |

406| Нет загрузки модулей: скрипт, содержащий `import()`, не запускается до начала выполнения | Тело скрипта — это простой JavaScript. Поместите работу, которая требует библиотеки, в задачу агента |408| Нет загрузки модулей: скрипт, содержащий `import()`, не запускается до начала выполнения | Тело скрипта — это простой JavaScript. Поместите работу, которая требует библиотеки, в задачу агента |

407| До 16 одновременных агентов, меньше, когда Claude Code имеет меньше доступных процессоров, включая внутри контейнера с ограничением процессора | Ограничивает локальное использование ресурсов |409| До 16 одновременных агентов по умолчанию, меньше, когда Claude Code имеет меньше доступных процессоров, включая внутри контейнера с ограничением процессора. Чтобы изменить лимит, установите [`CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS`](/docs/ru/env-vars#variables) на значение от 1 до 256, что требует Claude Code v2.1.269 или позже | Ограничивает локальное использование ресурсов |

408| В fan-out агенты, которые совместно используют префикс prompt-cache первого агента, запускаются до 5 секунд после него по умолчанию | Все, кроме первого, читают [префикс, который кэшировал первый агент](#prompt-caching-in-a-fan-out) вместо того, чтобы каждый обрабатывал его без кэша |410| В fan-out агенты, которые совместно используют префикс prompt-cache первого агента, запускаются до 5 секунд после него по умолчанию | Все, кроме первого, читают [префикс, который кэшировал первый агент](#prompt-caching-in-a-fan-out), вместо того чтобы каждый обрабатывал его без кэша |

409| До 4096 элементов в одном вызове `parallel()` или `pipeline()`: среда выполнения отклоняет более длинный список с ошибкой | Молчаливое ограничение могло бы отбросить часть рабочей нагрузки без уведомления скрипта |411| До 4096 элементов в одном вызове `parallel()` или `pipeline()`: среда выполнения отклоняет более длинный список с ошибкой | Молчаливый лимит отбросил бы часть рабочей нагрузки без уведомления скрипта |

410| 1000 агентов всего за запуск | Предотвращает бесконечные циклы |412| 1000 агентов всего за запуск | Предотвращает бесконечные циклы |

411 413 

412<h2 id="manage-runs">414<h2 id="manage-runs">