Documentation — Spybara

amazon-bedrock.md +8 −3

Details

349 349

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

351 351

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

353 353

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

355 355

356[Цепочка резервных моделей](https://code.claude.com/docs/ru/model-config.md#fallback-model-chains), которую вы настраиваете, заменяет переключение уровня: при этих отказах Claude Code переключается на ваш настроенный резервный вариант. Чтобы отклонённые запросы не выполнялись вместо переключения, установите [`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](https://code.claude.com/docs/ru/env-vars). Цепочка резервных моделей, которую вы настроили, всё ещё переключается при этих отказах; удалите цепочку также, если вы хотите, чтобы каждый отклонённый запрос не выполнялся.356* Ваша сессия работает на закреплённой модели, на выбранной вами конкретной версии или на [ARN профиля вывода приложения](#map-each-model-version-to-an-inference-profile)

357* Ни одна из [моделей, которые пробует Claude Code](#startup-model-checks), не доступна. В [авторежиме](https://code.claude.com/docs/ru/permission-modes.md#enable-auto-mode-on-bedrock-agent-platform-or-foundry) Claude Code переключается только на модель, которую авторежим поддерживает на Amazon Bedrock.

358

359Чтобы продолжить работу, выполните `/model` в сессии и нажмите `s` на модели, которую может использовать ваша учётная запись; при этом ваше значение по умолчанию не изменится. Ошибка `403` отображается как [AWS authentication failed](https://code.claude.com/docs/ru/errors.md#aws-authentication-failed).

360

361Чтобы отклонённые запросы завершались ошибкой вместо переключения, установите [`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](https://code.claude.com/docs/ru/env-vars). Если вы настроили цепочку резервных моделей, удалите и её, так как Claude Code всё равно переключится на этот резервный вариант.

357 362

358## Префиксы профилей кросс-региональной инференции363## Префиксы профилей кросс-региональной инференции

359 364

best-practices.md +1 −1

Details

315 {315 {

316 "matcher": "Edit|Write",316 "matcher": "Edit|Write",

317 "hooks": [317 "hooks": [

318 { "type": "command", "command": "npx prettier --write --ignore-unknown \"$(jq -r '.tool_input.file_path')\"" }318 { "type": "command", "command": "f=$(jq -r '.tool_input.file_path') && npx prettier --write --ignore-unknown \"$f\"" }

319 ]319 ]

320 }320 }

321 ]321 ]

claude-apps-gateway.md +3 −1

Details

74| PostgreSQL 11 или новее | Обеспечивает процесс входа с устройства и счётчики ограничений частоты запросов. Подойдёт управляемый сервис PostgreSQL, включая самый маленький тариф; см. [какие базы данных поддерживаются](https://code.claude.com/docs/ru/claude-apps-gateway-deploy.md#postgres). При использовании [лимитов расходов](https://code.claude.com/docs/ru/claude-apps-gateway-spend-limits.md) в нём также хранятся постоянные таблицы расходов, аудита и удостоверений, для которых следует делать резервные копии. Рекомендуется TLS через `?sslmode=require`. Для PostgreSQL 11, 12 и 13 на сервере шлюза требуется Claude Code v2.1.290 или новее. Проект PostgreSQL больше не поддерживает эти версии, поэтому по возможности используйте более новую. |74| PostgreSQL 11 или новее | Обеспечивает процесс входа с устройства и счётчики ограничений частоты запросов. Подойдёт управляемый сервис PostgreSQL, включая самый маленький тариф; см. [какие базы данных поддерживаются](https://code.claude.com/docs/ru/claude-apps-gateway-deploy.md#postgres). При использовании [лимитов расходов](https://code.claude.com/docs/ru/claude-apps-gateway-spend-limits.md) в нём также хранятся постоянные таблицы расходов, аудита и удостоверений, для которых следует делать резервные копии. Рекомендуется TLS через `?sslmode=require`. Для PostgreSQL 11, 12 и 13 на сервере шлюза требуется Claude Code v2.1.290 или новее. Проект PostgreSQL больше не поддерживает эти версии, поэтому по возможности используйте более новую. |

75| Вышестоящий провайдер моделей | Учётные данные Amazon Bedrock, учётные данные Claude Platform on AWS, учётные данные Google Cloud, ресурс Microsoft Foundry или API-ключ Anthropic. Поддерживается несколько вышестоящих провайдеров с переключением при отказе. |75| Вышестоящий провайдер моделей | Учётные данные Amazon Bedrock, учётные данные Claude Platform on AWS, учётные данные Google Cloud, ресурс Microsoft Foundry или API-ключ Anthropic. Поддерживается несколько вышестоящих провайдеров с переключением при отказе. |

76| HTTPS | Шлюз должен быть доступен по `https://` с ноутбуков разработчиков и из любого браузера, используемого для входа; шлюз отдаёт страницу проверки устройства на том же слушателе. Либо предоставьте TLS-сертификат через `listen.tls`, либо запустите шлюз за ingress с терминированием TLS, и в обоих случаях задайте в `listen.public_url` внешний origin. При `/login` Claude Code принимает обычный origin `http://` только в том случае, если хост шлюза — loopback: `localhost`, `127.0.0.1` или `::1`. |76| HTTPS | Шлюз должен быть доступен по `https://` с ноутбуков разработчиков и из любого браузера, используемого для входа; шлюз отдаёт страницу проверки устройства на том же слушателе. Либо предоставьте TLS-сертификат через `listen.tls`, либо запустите шлюз за ingress с терминированием TLS, и в обоих случаях задайте в `listen.public_url` внешний origin. При `/login` Claude Code принимает обычный origin `http://` только в том случае, если хост шлюза — loopback: `localhost`, `127.0.0.1` или `::1`. |

77| Адрес в частной сети | При `/login` Claude Code требует, чтобы имя хоста или IP-адрес шлюза разрешались только в частные адреса: RFC 1918, link-local, CGNAT `100.64.0.0/10`, IPv6 ULA `fc00::/7` или loopback. Для размещаемого вами шлюза любой публичный адрес вне объявленного вами блока отклоняется; см. [модель угроз](https://code.claude.com/docs/ru/claude-apps-gateway-deploy.md#threat-model-summary) в руководстве по развёртыванию. Если машины разработчиков направляют HTTPS через корпоративный прокси, для входа также требуется, чтобы хост прокси разрешался в частные адреса; если это не так, добавьте хост шлюза в `NO_PROXY`, чтобы CLI подключался напрямую. Если ваша внутренняя сеть использует публичное адресное пространство IPv4, принадлежащее вашей организации, [объявите эти блоки](#allow-a-gateway-on-public-address-space-you-own), чтобы `/login` принимал шлюз в них. |77| Адрес в частной сети | При `/login` Claude Code требует, чтобы имя хоста или IP-адрес шлюза разрешались только в частные адреса: диапазоны RFC 1918 и link-local, CGNAT `100.64.0.0/10`, IPv6 ULA `fc00::/7` и loopback. См. [модель угроз](https://code.claude.com/docs/ru/claude-apps-gateway-deploy.md#threat-model-summary). Если ваша внутренняя сеть использует публичное адресное пространство IPv4, принадлежащее вашей организации, [объявите эти блоки](#allow-a-gateway-on-public-address-space-you-own), чтобы `/login` принимал шлюз в них. |

78| Среда выполнения Linux | Сервер шлюза работает только как нативный бинарный файл Linux. macOS подходит для локальной разработки. Windows не поддерживается в качестве серверной платформы. |78| Среда выполнения Linux | Сервер шлюза работает только как нативный бинарный файл Linux. macOS подходит для локальной разработки. Windows не поддерживается в качестве серверной платформы. |

79 79

80Если к хосту шлюза применяется `HTTPS_PROXY` или `HTTP_PROXY`, для входа также требуется либо прокси, имя хоста которого разрешается в частные адреса, либо хост шлюза в `NO_PROXY` на машинах разработчиков. Если на этих машинах также задан `no_proxy`, добавьте хост шлюза и туда, иначе запросы к модели по-прежнему будут идти через прокси.

80### Шаги82### Шаги

81 83

82**1. Зарегистрируйте OAuth-клиент в вашем IdP**84**1. Зарегистрируйте OAuth-клиент в вашем IdP**

claude-apps-gateway-config.md +8 −2

Details

656 656

657| Настройка | Как |657| Настройка | Как |

658| - | - |658| - | - |

660| Развёртывания | Microsoft Foundry использует имена развёртываний, выбранные администратором, а не канонические ID моделей. Добавьте блок [`models:`](#models), сопоставляющий каждый канонический ID с именем вашего развёртывания. |660| Развёртывания | Microsoft Foundry использует имена развёртываний, выбранные администратором, а не канонические ID моделей. Добавьте блок [`models:`](#models), сопоставляющий каждый канонический ID с именем вашего развёртывания. |

661| AKS (workload identity) | Настройте федерацию User-Assigned Managed Identity с OIDC-издателем кластера и привяжите её к сервисному аккаунту шлюза. `use_azure_ad: true` подхватит её через `WorkloadIdentityCredential`. |661| AKS (workload identity) | Настройте федерацию User-Assigned Managed Identity с OIDC-издателем кластера и привяжите её к сервисному аккаунту шлюза. `use_azure_ad: true` подхватит её через `WorkloadIdentityCredential`. |

662| ACI / App Service | Включите для ресурса управляемую идентичность, назначаемую системой или пользователем. `use_azure_ad: true` подхватит её. |662| ACI / App Service | Включите для ресурса управляемую идентичность, назначаемую системой или пользователем. `use_azure_ad: true` подхватит её. |

1001 1001

1002Каждый ключ в `upstream_model` должен совпадать с `name` настроенного upstream, которое по умолчанию равно имени провайдера. Ключ, не совпадающий ни с одним upstream, приводит к ошибке при запуске, поэтому опустите строки для провайдеров, которые вы не используете.1002Каждый ключ в `upstream_model` должен совпадать с `name` настроенного upstream, которое по умолчанию равно имени провайдера. Ключ, не совпадающий ни с одним upstream, приводит к ошибке при запуске, поэтому опустите строки для провайдеров, которые вы не используете.

1003 1003

1004Чтобы разработчики могли использовать псевдоним `fable` при `auto_include_builtin_models: false`, добавьте запись `claude-fable-5` в `models`. Это ID, в который [псевдоним `fable`](https://code.claude.com/docs/ru/model-config#fable-alias-resolution) разрешается для разработчиков, вошедших через шлюз. Без неё их сообщения завершаются ошибкой, начинающейся с `API Error: 400 model claude-fable-5 is not in the operator's model allowlist`.

1005

1004### `managed`1006### `managed`

1005 1007

1006Блок `managed` определяет политики доступа на основе ролей, привязанные к группам IdP или домену email. Политики оцениваются по порядку; по умолчанию выбирается первое совпадение, которое затем объединяется с базовой политикой `match: {}`, охватывающей всех. Пользователь, подпадающий под две ролевые политики, получает только первую, поэтому правила запрета второй политики не применяются, если вы не [примените все подходящие политики](#apply-every-matching-policy). Политики обслуживаются для каждого пользователя по адресу `GET /managed/settings` с кэшированием ETag/304.1008Блок `managed` определяет политики доступа на основе ролей, привязанные к группам IdP или домену email. Политики оцениваются по порядку; по умолчанию выбирается первое совпадение, которое затем объединяется с базовой политикой `match: {}`, охватывающей всех. Пользователь, подпадающий под две ролевые политики, получает только первую, поэтому правила запрета второй политики не применяются, если вы не [примените все подходящие политики](#apply-every-matching-policy). Политики обслуживаются для каждого пользователя по адресу `GET /managed/settings` с кэшированием ETag/304.

1025Универсальная политика `match: {}`, которую по соглашению указывают последней, рассматривается как базовый слой. Любая другая политика наследует от неё каждый ключ, который сама не задаёт, поэтому в ролевых записях нужно перечислять только то, что отличается от значений по умолчанию для организации. Правила объединения зависят от типа ключа:1027Универсальная политика `match: {}`, которую по соглашению указывают последней, рассматривается как базовый слой. Любая другая политика наследует от неё каждый ключ, который сама не задаёт, поэтому в ролевых записях нужно перечислять только то, что отличается от значений по умолчанию для организации. Правила объединения зависят от типа ключа:

1026 1028

1027* **Списки разрешённых**: `availableModels` и `permissions.allow`. Список конкретной политики полностью заменяет базовый.1029* **Списки разрешённых**: `availableModels` и `permissions.allow`. Список конкретной политики полностью заменяет базовый.

1028* **Списки запрещённых и массивы хуков**: `permissions.deny`, `permissions.ask`, `disabledMcpjsonServers`, `deniedMcpServers`, `blockedMarketplaces`, `deniedModels` и каждый массив типа события `hooks`. Для них берётся объединение базы и политики, поэтому общеорганизационный запрет или хук аудита не может быть случайно потерян из-за ролевого переопределения.1030* **Списки запрещённых и массивы хуков**: берётся объединение базовой и конкретной политики:

1031 * `permissions.deny` и `permissions.ask`

1032 * `disabledMcpjsonServers` и `deniedMcpServers`

1033 * `blockedMarketplaces` и `deniedModels`

1034 * Массивы типов событий `hooks`

1029* **Ключи типа record**: `env`, `modelOverrides` и `skillOverrides`. Они объединяются поверхностно, поэтому ролевой блок `env` переопределяет заданные в нём ключи, а остальные наследует от базы.1035* **Ключи типа record**: `env`, `modelOverrides` и `skillOverrides`. Они объединяются поверхностно, поэтому ролевой блок `env` переопределяет заданные в нём ключи, а остальные наследует от базы.

1030 1036

1031`availableModels` также применяется на стороне сервера на `/v1/messages`, поэтому запрещённая модель возвращает `400` независимо от того, что отправляет клиент. Пустой список запрещает все модели. Проверка также охватывает модель, с которой сессия начинается до того, как разработчик выберет модель, поэтому [запускайте сессии на модели, разрешённой политикой](#start-sessions-on-a-model-the-policy-allows).1037`availableModels` также применяется на стороне сервера на `/v1/messages`, поэтому запрещённая модель возвращает `400` независимо от того, что отправляет клиент. Пустой список запрещает все модели. Проверка также охватывает модель, с которой сессия начинается до того, как разработчик выберет модель, поэтому [запускайте сессии на модели, разрешённой политикой](#start-sessions-on-a-model-the-policy-allows).

claude-apps-gateway-deploy.md +1 −1

Details

92 92

93Помимо бинарного файла, образу нужны:93Помимо бинарного файла, образу нужны:

94 94

95* **Образ на основе glibc**: единственные динамические зависимости сборки glibc — это библиотеки glibc. Образы на основе Musl нуждаются в сборке `linux-x64-musl` или `linux-arm64-musl` плюс дополнительные пакеты; см. [Настройка Alpine Linux](https://code.claude.com/docs/ru/setup.md#alpine-linux-and-musl-based-distributions).95* **Образ на основе glibc**: единственные динамические зависимости сборки glibc — это библиотеки glibc. Образам на основе Musl нужна сборка `linux-x64-musl` или `linux-arm64-musl`, единственной динамической зависимостью которой является musl.

96* **Записываемый каталог состояния**: шлюз работает как любой пользователь, но минимальные образы не имеют записываемого home. Установите `CLAUDE_CONFIG_DIR` на записываемый путь, такой как `/tmp/.claude`.96* **Записываемый каталог состояния**: шлюз работает как любой пользователь, но минимальные образы не имеют записываемого home. Установите `CLAUDE_CONFIG_DIR` на записываемый путь, такой как `/tmp/.claude`.

97* **Команда контейнера**: `claude gateway --config /etc/claude/gateway.yaml`, с файлом конфигурации, смонтированным только для чтения, и секретами, предоставленными как переменные окружения; шлюз слушает на `listen.port`, по умолчанию `8080`.97* **Команда контейнера**: `claude gateway --config /etc/claude/gateway.yaml`, с файлом конфигурации, смонтированным только для чтения, и секретами, предоставленными как переменные окружения; шлюз слушает на `listen.port`, по умолчанию `8080`.

98 98

claude-projects.md +2 −0

Details

274 274

275Тред работает в [авторежиме](https://code.claude.com/docs/ru/permission-modes.md#eliminate-prompts-with-auto-mode), поэтому Claude выполняет команды и редактирует файлы в этой папке, не спрашивая вас каждый раз. Если авторежим недоступен или отключён в Claude Code на этом компьютере, тред работает без него, и любой запрос разрешения, который он выдаёт, ожидает вашего ответа в треде, как описано в разделе [Разблокировка треда, ожидающего подтверждения](#unblock-a-thread-waiting-on-approval).275Тред работает в [авторежиме](https://code.claude.com/docs/ru/permission-modes.md#eliminate-prompts-with-auto-mode), поэтому Claude выполняет команды и редактирует файлы в этой папке, не спрашивая вас каждый раз. Если авторежим недоступен или отключён в Claude Code на этом компьютере, тред работает без него, и любой запрос разрешения, который он выдаёт, ожидает вашего ответа в треде, как описано в разделе [Разблокировка треда, ожидающего подтверждения](#unblock-a-thread-waiting-on-approval).

276 276

277Чтобы запустить тред в другом режиме, запустите `claude remote-control` с [`--settings`](https://code.claude.com/docs/ru/remote-control#start-a-remote-control-session). Тогда [`permissions.defaultMode`](https://code.claude.com/docs/ru/permission-modes#start-in-a-different-mode) в этом файле или в настройках этого компьютера может выбрать другой режим.

278

277Пока тред работает, значок ноутбука в его заголовке показывает, подключён ли ваш компьютер. Нажмите на него, чтобы увидеть, какую папку использует тред, или отключить соединение. Тред приостанавливается, пока этот компьютер находится в спящем режиме, и останавливается, если настольное приложение или `claude remote-control` завершает работу.279Пока тред работает, значок ноутбука в его заголовке показывает, подключён ли ваш компьютер. Нажмите на него, чтобы увидеть, какую папку использует тред, или отключить соединение. Тред приостанавливается, пока этот компьютер находится в спящем режиме, и останавливается, если настольное приложение или `claude remote-control` завершает работу.

278 280

279* **Чтобы снова запустить тред**: см. [Lost contact with your folder](#lost-contact-with-your-folder)281* **Чтобы снова запустить тред**: см. [Lost contact with your folder](#lost-contact-with-your-folder)

commands.md +0 −2

Details

35В таблице ниже перечислены все команды, входящие в Claude Code. Большинство из них — встроенные команды, поведение которых запрограммировано в CLI. Отмечены записи двух видов:35В таблице ниже перечислены все команды, входящие в Claude Code. Большинство из них — встроенные команды, поведение которых запрограммировано в CLI. Отмечены записи двух видов:

36 36

37* **[Скилл](https://code.claude.com/docs/ru/skills.md#bundled-skills)**: встроенный скилл. Он работает так же, как скиллы, которые вы пишете сами: это промпт, передаваемый Claude.37* **[Скилл](https://code.claude.com/docs/ru/skills.md#bundled-skills)**: встроенный скилл. Он работает так же, как скиллы, которые вы пишете сами: это промпт, передаваемый Claude.

~~38 * `/verify` запускается только по вашему вызову.~~

39* **[Рабочий процесс](https://code.claude.com/docs/ru/workflows.md#bundled-workflows)**: встроенный [динамический рабочий процесс](https://code.claude.com/docs/ru/workflows.md), который распределяет работу между множеством субагентов и выполняется в фоновом режиме.38* **[Рабочий процесс](https://code.claude.com/docs/ru/workflows.md#bundled-workflows)**: встроенный [динамический рабочий процесс](https://code.claude.com/docs/ru/workflows.md), который распределяет работу между множеством субагентов и выполняется в фоновом режиме.

~~40 * `/deep-research` запускается только по вашему вызову.~~

41 39

42Чтобы добавить собственные команды, см. [скиллы](https://code.claude.com/docs/ru/skills.md).40Чтобы добавить собственные команды, см. [скиллы](https://code.claude.com/docs/ru/skills.md).

43 41

desktop-linux.md +1 −1

Details

71 71

72Запустите **Claude** из вашего средства запуска приложений или выполните `claude-desktop` из терминала и войдите с помощью вашей учетной записи Anthropic.72Запустите **Claude** из вашего средства запуска приложений или выполните `claude-desktop` из терминала и войдите с помощью вашей учетной записи Anthropic.

73 73

74Приложение Linux входит так же, как на macOS и Windows: с подпиской claude.ai или через SSO вашей организации. Для аутентификации по API-ключу используйте [CLI](https://code.claude.com/docs/ru/quickstart.md). Чтобы вместо этого использовать Desktop с Amazon Bedrock, Agent Platform Google Cloud, Microsoft Foundry или LLM-шлюзом, см. [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview). Сведения о прокси-серверах и пользовательских центрах сертификации в таких развёртываниях см. в разделе [конфигурация сети](https://code.claude.com/docs/ru/network-config.md).74Приложение Linux входит так же, как на macOS и Windows: с подпиской claude.ai или через SSO вашей организации. Чтобы вместо этого использовать Desktop с API-ключом Claude, Amazon Bedrock, Agent Platform Google Cloud, Microsoft Foundry или LLM-шлюзом, см. [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview). Сведения о прокси-серверах и пользовательских центрах сертификации в таких развёртываниях см. в разделе [конфигурация сети](https://code.claude.com/docs/ru/network-config.md).

75 75

76### Установка из загруженного файла76### Установка из загруженного файла

77 77

desktop-scheduled-tasks.md +7 −2

Details

83 83

84**8. Выберите режим разрешений и модель**84**8. Выберите режим разрешений и модель**

85 85

86На панели инструментов поля инструкций выберите [режим разрешений](#permissions-for-scheduled-tasks) и модель. Если оставить их без изменений, запуски будут использовать ваши настройки Claude Code и модель по умолчанию.86На панели инструментов поля инструкций выберите [режим разрешений](#permissions-for-scheduled-tasks) и модель.

88* **Режим разрешений**: если оставить его без изменений, запуски будут использовать ваши настройки Claude Code.

89* **Модель**: если в меню модели указано **Default · Set by admin** и вы не выберете другую модель, запуски будут использовать модель, заданную вашей организацией в [управляемых настройках](https://code.claude.com/docs/ru/managed-settings.md). [Запуск для наверстывания](#missed-runs), который начинается при открытии приложения, может вместо этого использовать [модель по умолчанию для вашей учетной записи во время выполнения](https://code.claude.com/docs/ru/model-config.md#default-model-setting).

87 90

88**9. Создайте задачу**91**9. Создайте задачу**

89 92

90Нажмите **Create**. Если вы еще не доверили эту папку, Desktop предложит вам доверить ее на этом этапе. Откроется страница с подробностями задачи.93Нажмите **Create**. Если вы еще не доверили эту папку, Desktop предложит вам доверить ее на этом этапе. Откроется страница с подробностями задачи.

91 94

95Чтобы узнать, какой модели соответствует **Default · Set by admin**, нажмите **Run now** на странице с подробностями, чтобы сразу запустить задачу. Затем [откройте сессию этого запуска](#find-a-runs-session): в строке под полем промпта отображается название модели.

92На странице с подробностями нажмите значок карандаша, чтобы открыть [форму **Edit**](#manage-scheduled-tasks). В ней можно изменить **Description**, которое Desktop заполнил на основе ваших инструкций, выбрать **Worktree** или переключить расписание на **Manual** или **Custom**.97На странице с подробностями нажмите значок карандаша, чтобы открыть [форму **Edit**](#manage-scheduled-tasks). В ней можно изменить **Description**, которое Desktop заполнил на основе ваших инструкций, выбрать **Worktree** или переключить расписание на **Manual** или **Custom**.

93 98

94Вы также можете создать задачу, описав то, что вы хотите, в любой сессии. Например, "настрой ежедневное код-ревью, которое запускается каждое утро в 9:00" создает повторяющуюся задачу. Сообщение вроде "напомни мне завтра в 3 часа дня проверить развёртывание" создает одноразовую задачу, которая отключается после срабатывания.99Вы также можете создать задачу, описав то, что вы хотите, в любой сессии. Например, "настрой ежедневное код-ревью, которое запускается каждое утро в 9:00" создает повторяющуюся задачу. Сообщение вроде "напомни мне завтра в 3 часа дня проверить развёртывание" создает одноразовую задачу, которая отключается после срабатывания.

181 186

182Чтобы позволить задаче изменять свое собственное расписание или промпт с помощью инструмента MCP `update_scheduled_task`, нажимайте **Run now** и подтверждайте вызов каждый раз.187Чтобы позволить задаче изменять свое собственное расписание или промпт с помощью инструмента MCP `update_scheduled_task`, нажимайте **Run now** и подтверждайте вызов каждый раз.

183 188

184Чтобы отредактировать подсказку задачи на диске, откройте `~/.claude/scheduled-tasks/<task-name>/SKILL.md` (или под [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/ru/env-vars), если установлено). Файл использует YAML frontmatter для `name` и `description`, с подсказкой в качестве тела. Изменения вступают в силу при следующем запуске. Расписание, папка, модель и состояние включения не находятся в этом файле: измените их через форму Edit или попросите Claude.189Чтобы отредактировать промпт задачи на диске, откройте `~/.claude/scheduled-tasks/<task-name>/SKILL.md` (или под [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/ru/env-vars), если установлено). Файл использует YAML frontmatter для `name` и `description`, с промптом в качестве тела. Изменения вступают в силу при следующем запуске. Расписание, папка и состояние включения не находятся в этом файле: измените их через форму Edit или попросите Claude.

185 190

186## Связанные ресурсы191## Связанные ресурсы

187 192

errors.md +50 −7

Details

122| `A request to MCP server "<name>" was sent without your stored credentials` | [Authentication](#couldnt-read-the-stored-credentials-for-mcp-server) |122| `A request to MCP server "<name>" was sent without your stored credentials` | [Authentication](#couldnt-read-the-stored-credentials-for-mcp-server) |

123| `This server's URL is missing or not a valid URL, so sign-in can't start` | [Authentication](#mcp-server-url-is-missing-or-not-a-valid-url) |123| `This server's URL is missing or not a valid URL, so sign-in can't start` | [Authentication](#mcp-server-url-is-missing-or-not-a-valid-url) |

125| `Stopped an OAuth request` | [Аутентификация](#stopped-an-oauth-request) |

125| `Refusing to send credentials to non-https token endpoint` / `<short-name> from the MCP SDK for <server-url>` | [Authentication](#refusing-to-send-credentials-to-non-https-token-endpoint) |126| `Refusing to send credentials to non-https token endpoint` / `<short-name> from the MCP SDK for <server-url>` | [Authentication](#refusing-to-send-credentials-to-non-https-token-endpoint) |

252| `Remote Control did not start: "<question>" got no answer` | [Ошибки командной строки](#remote-control-did-not-start-got-no-answer) |253| `Remote Control did not start: "<question>" got no answer` | [Ошибки командной строки](#remote-control-did-not-start-got-no-answer) |

253| `` `<flag>` before `remote-control` is not carried over to the sessions Remote Control starts `` | [Command-line errors](#not-carried-over-to-the-sessions-remote-control-starts) |254| `` `<flag>` before `remote-control` is not carried over to the sessions Remote Control starts `` | [Command-line errors](#not-carried-over-to-the-sessions-remote-control-starts) |

255| `Remote Control did not start, because sessions would skip part or all of the --settings file` | [Ошибки командной строки](#remote-control-did-not-start-because-of-the-settings-file) |

256| `The settings file <file> has changed since Remote Control started, so this session did not start` | [Ошибки командной строки](#settings-file-changed-since-remote-control-started) |

254| `--sandbox is not supported by claude remote-control` / `--no-sandbox is not supported by claude remote-control` | [Command-line errors](#sandbox-is-not-supported-by-claude-remote-control) |257| `--sandbox is not supported by claude remote-control` / `--no-sandbox is not supported by claude remote-control` | [Command-line errors](#sandbox-is-not-supported-by-claude-remote-control) |

255| `` `claude import` is not yet available in this build `` | [Command-line errors](#claude-import-is-not-yet-available-in-this-build) |258| `` `claude import` is not yet available in this build `` | [Command-line errors](#claude-import-is-not-yet-available-in-this-build) |

825Последующие вызовы в том же ответе Claude могут быть отклонены по этой причине:828Последующие вызовы в том же ответе Claude могут быть отклонены по этой причине:

826 829

827```text theme={null}830```text theme={null}

828another call in this response was changed by a hook after auto mode reviewed it, or could not be confirmed unchanged831another call in this response was changed after auto mode reviewed it, or could not be confirmed unchanged

829```832```

830 833

831Затем Claude может повторно выполнить каждый отклоненный вызов, чтобы сервер его проверил. Если появится запрос разрешения, ответьте на него. Больше ничего делать не нужно, если только Claude не сообщит в своем ответе, что авторежим не смог проверить вызов. В этом случае остановите изменение или одобрите вызов самостоятельно и попросите Claude повторить вызов:834Затем Claude может повторно выполнить каждый отклоненный вызов, чтобы сервер его проверил. Если появится запрос разрешения, ответьте на него. Больше ничего делать не нужно, если только Claude не сообщит в своем ответе, что авторежим не смог проверить вызов. В этом случае остановите изменение или одобрите вызов самостоятельно и попросите Claude повторить вызов:

1822 1825

1823До версии v2.1.232 Claude Code использовал среду выполнения v2 только при постепенном развёртывании или когда вы задавали `MCP_SDK_GENERATION=v2`.1826До версии v2.1.232 Claude Code использовал среду выполнения v2 только при постепенном развёртывании или когда вы задавали `MCP_SDK_GENERATION=v2`.

1824 1827

1828### Stopped an OAuth request

1829

1830Это сообщение означает, что Claude Code остановил [запрос OAuth для MCP-сервера](https://code.claude.com/docs/ru/mcp.md#authenticate-with-remote-mcp-servers), потому что эндпоинт OAuth перенаправил его. В обеих формах сообщения первый адрес — тот, который отправил перенаправление:

1831

1832```text theme={null}

1833Stopped an OAuth request, which can hold secrets: https://auth.example.com redirected it to https://other.example.com. Ask the owner of https://auth.example.com to remove that redirect.

1834Stopped an OAuth request: https://auth.example.com redirected it more than 5 times. Ask the owner of https://auth.example.com to fix those redirects.

1835```

1836

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

1838

1839* Попросите того, кто обслуживает первый адрес, например оператора MCP-сервера, удалить или исправить перенаправление. Затем повторите попытку из `/mcp`.

1840

1825### Отказ отправлять учётные данные на эндпоинт токенов без https1841### Отказ отправлять учётные данные на эндпоинт токенов без https

1826 1842

1827В [среде выполнения v2](https://code.claude.com/docs/ru/mcp.md#mcp-client-runtimes) Claude Code отправляет запрос токена [MCP OAuth](https://code.claude.com/docs/ru/mcp.md#authenticate-with-remote-mcp-servers) только на эндпоинт токенов, обслуживаемый по HTTPS или по адресу `localhost`, `127.0.0.1` или `::1`. Это сообщение означает, что эндпоинт токенов сервера не удовлетворяет ни одному из этих условий, поэтому Claude Code остановился до отправки запроса. Это происходит после входа в браузере, поэтому сначала шаг в браузере завершается успешно, а затем снова — каждый раз, когда Claude Code обновляет токен сервера.1843В [среде выполнения v2](https://code.claude.com/docs/ru/mcp.md#mcp-client-runtimes) Claude Code отправляет запрос токена [MCP OAuth](https://code.claude.com/docs/ru/mcp.md#authenticate-with-remote-mcp-servers) только на эндпоинт токенов, обслуживаемый по HTTPS или по адресу `localhost`, `127.0.0.1` или `::1`. Это сообщение означает, что эндпоинт токенов сервера не удовлетворяет ни одному из этих условий, поэтому Claude Code остановился до отправки запроса. Это происходит после входа в браузере, поэтому сначала шаг в браузере завершается успешно, а затем снова — каждый раз, когда Claude Code обновляет токен сервера.

2207 2223

2208### Host not allowed in a cloud session2224### Host not allowed in a cloud session

2209 2225

2210Исходящий HTTP-запрос из облачной сессии или облачной запланированной задачи был заблокирован сетевой политикой среды.2226В облачной сессии или облачной запланированной задаче `403` или ошибка DNS, например `ENOTFOUND`, может означать, что запрошенного хоста нет в [списке разрешённых доменов облачной среды](https://code.claude.com/docs/ru/cloud-environments.md#access-levels). Чтобы убедиться в этом, сверьте хост с этим списком. `403` с этим заголовком подтверждает блокировку, но этот заголовок есть не у каждого `403` заблокированного запроса:

2211 2227

2212```text theme={null}2228```text theme={null}

2213HTTP 4032229HTTP 403

2565 2581

2566Обычно Claude Code автоматически уменьшает большие изображения. Эти ошибки означают, что изображение не удалось декодировать или уменьшить до размеров в пределах лимитов API.2582Обычно Claude Code автоматически уменьшает большие изображения. Эти ошибки означают, что изображение не удалось декодировать или уменьшить до размеров в пределах лимитов API.

2567 2583

2584Ошибка, которую вы видите, может называть другой пиксельный лимит, например `2576x2576px` там, где в этих примерах указано `2000x2000px`.

2585

2568**Что делать:**2586**Что делать:**

2569 2587

2570* Если сообщение просит преобразовать изображение, преобразуйте его в PNG, JPEG, GIF или WebP и прикрепите снова. Для этих форматов Claude Code может проверить размеры по заголовку файла, не декодируя изображение.2588* Если сообщение просит преобразовать изображение, преобразуйте его в PNG, JPEG, GIF или WebP и прикрепите снова. Для этих форматов Claude Code может проверить размеры по заголовку файла, не декодируя изображение.

2873* **Причина, написанная хуком**: хук PreModelSwitch указал эту причину, когда [отклонил переключение или запросил подтверждение](https://code.claude.com/docs/ru/hooks.md#premodelswitch-decision-control). Выполните то, что он требует, или выберите модель, разрешённую вашими хуками.2891* **Причина, написанная хуком**: хук PreModelSwitch указал эту причину, когда [отклонил переключение или запросил подтверждение](https://code.claude.com/docs/ru/hooks.md#premodelswitch-decision-control). Выполните то, что он требует, или выберите модель, разрешённую вашими хуками.

2874* **`PreModelSwitch hook <name> did not respond before its timeout`**: хук, не ответивший до истечения своего [таймаута](https://code.claude.com/docs/ru/hooks.md#timeouts), блокирует переключение. Исправьте зависающую команду или увеличьте `timeout` этого хука, затем переключитесь снова.2892* **`PreModelSwitch hook <name> did not respond before its timeout`**: хук, не ответивший до истечения своего [таймаута](https://code.claude.com/docs/ru/hooks.md#timeouts), блокирует переключение. Исправьте зависающую команду или увеличьте `timeout` этого хука, затем переключитесь снова.

2875* **`confirmation required, and this session cannot ask`**: хук ответил `ask` без причины, а у управляющего запроса нет способа показать запрос подтверждения. Команда `/model` в [запуске `-p`](https://code.claude.com/docs/ru/headless) сообщает о том же состоянии с `(run /model interactively to confirm)` после причины. Выполните переключение из интерактивной сессии или измените решение хука для этой модели.2893* **`confirmation required, and this session cannot ask`**: хук ответил `ask` без причины, а у управляющего запроса нет способа показать запрос подтверждения. Команда `/model` в [запуске `-p`](https://code.claude.com/docs/ru/headless) сообщает о том же состоянии с `(run /model interactively to confirm)` после причины. Выполните переключение из интерактивной сессии или измените решение хука для этой модели.

2876* **`so organization-managed PreModelSwitch hooks could not be checked`**: Claude Code не смог определить, какие хуки PreModelSwitch предоставляют [управляемые плагины](https://code.claude.com/docs/ru/settings-reference.md#enabledplugins) вашей организации, например потому что управляемый плагин не загрузился. Один из этих хуков мог бы заблокировать переключение, поэтому Claude Code отказывает, а не применяет переключение без проверки. Начало причины указывает, что именно не удалось. Claude Code проверяет заново при каждой попытке переключения, поэтому устранённый сбой перестаёт блокировать; если сбой повторяется, запустите `claude --debug` и снова переключитесь, чтобы получить подробности, затем исправьте плагин или попросите администратора его исправить.2894* **`so organization-managed PreModelSwitch hooks could not be checked`**: Claude Code до v2.1.323 отказывает, когда не может определить, какие хуки PreModelSwitch предоставляют ваши [управляемые плагины](https://code.claude.com/docs/ru/settings-reference.md#enabledplugins). Текст перед этой фразой называет то, что завершилось неудачей. Чтобы отказы прекратились, обновите Claude Code. Чтобы хуки неисправного плагина тоже заработали, исправьте плагин или обратитесь к администратору. Для подробностей запустите `claude --debug` в оболочке и переключите модель, затем прочитайте [отладочный лог](https://code.claude.com/docs/ru/hooks.md#debug-hooks).

2877* **`a PreModelSwitch hook failed before answering`** или **`PreModelSwitch hooks were cancelled (the control stream closed) before answering`**: выполнение хука завершилось без решения, и Claude Code не считает это подтверждением. Запустите `claude --debug`, чтобы увидеть, что не удалось, затем переключитесь снова.2895* **`a PreModelSwitch hook failed before answering`** или **`PreModelSwitch hooks were cancelled (the control stream closed) before answering`**: выполнение хука завершилось без решения, и Claude Code не считает это подтверждением. Запустите `claude --debug`, чтобы увидеть, что не удалось, затем переключитесь снова.

2878 2896

2879До версии 2.1.260 отказ из-за управляемого плагина звучал как `plugin hooks could not be loaded, so PreModelSwitch hooks could not be checked; see the debug log`. Claude Code один раз повторял загрузку плагина, а затем отклонял последующие переключения в сессии, даже если ваша организация не управляла никакими плагинами. В этих версиях перезапустите сессию, чтобы снова выполнить загрузку плагинов.2897До версии 2.1.260 отказ из-за управляемого плагина звучал как `plugin hooks could not be loaded, so PreModelSwitch hooks could not be checked; see the debug log`. Claude Code один раз повторял загрузку плагина, а затем отклонял последующие переключения в сессии, даже если ваша организация не управляла никакими плагинами. В этих версиях перезапустите сессию, чтобы снова выполнить загрузку плагинов.

3499* **`Error: Workspace not trusted. <folder> is your home directory`**: поскольку доверие для домашнего каталога никогда не сохраняется, предварительный запуск `claude` там не поможет. Вместо этого выполните `claude ultrareview` из каталога проекта, предварительно один раз запустив там `claude`, чтобы принять диалог доверия, или добавьте `--trust-workspace`.3517* **`Error: Workspace not trusted. <folder> is your home directory`**: поскольку доверие для домашнего каталога никогда не сохраняется, предварительный запуск `claude` там не поможет. Вместо этого выполните `claude ultrareview` из каталога проекта, предварительно один раз запустив там `claude`, чтобы принять диалог доверия, или добавьте `--trust-workspace`.

3500* **`No answer in time.` с последующим `Error: Workspace not trusted`**: на вопрос `Trust <folder>? [y/N]` не было ответа в течение 5 минут. Снова выполните `claude ultrareview` и ответьте на него.3518* **`No answer in time.` с последующим `Error: Workspace not trusted`**: на вопрос `Trust <folder>? [y/N]` не было ответа в течение 5 минут. Снова выполните `claude ultrareview` и ответьте на него.

3501* **`Ultrareview did not start: <folder> is not trusted`**: вы отказались на вопрос `Trust <folder>? [y/N]`, например ответив `n` или нажав Enter. Чтобы начать ревью, снова выполните `claude ultrareview` и ответьте `y`.3519* **`Ultrareview did not start: <folder> is not trusted`**: вы отказались на вопрос `Trust <folder>? [y/N]`, например ответив `n` или нажав Enter. Чтобы начать ревью, снова выполните `claude ultrareview` и ответьте `y`.

3502* **``Ultrareview did not start: `--trust-workspace` takes no value``**: после `--trust-workspace` следует что-то, кроме флага, например номер PR или `false`. Если вы не доверяете папке, не указывайте флаг. Чтобы доверять ей для этого запуска, поставьте номер PR или базовую ветку перед флагом: `claude ultrareview 1234 --trust-workspace`.3520* **``Ultrareview did not start: `--trust-workspace` takes no value``**: после `--trust-workspace` следует что-то, кроме флага, например номер PR или `false`. Если вы не доверяете папке, не указывайте флаг. Чтобы доверять ей в этом запуске, поставьте номер PR или базовую ветку перед флагом: `claude ultrareview 1234 --trust-workspace`.

3503 3521

3504До v2.1.309 `claude ultrareview` не принимал `--trust-workspace`.3522До v2.1.309 `claude ultrareview` не принимал `--trust-workspace`.

3505 3523

3522Вы запустили [Remote Control](https://code.claude.com/docs/ru/remote-control.md) с глобальным флагом `claude` перед глаголом `remote-control` — флагом, который ограничивал бы или настраивал сессии, запускаемые Remote Control, например `--settings`, `--setting-sources`, `--permission-mode`, `--disallowed-tools` или `--mcp-config`. Флаг, указанный перед глаголом, никогда не доходит до этих сессий. Вместо этого Claude Code отказывается запускаться и называет флаг:3540Вы запустили [Remote Control](https://code.claude.com/docs/ru/remote-control.md) с глобальным флагом `claude` перед глаголом `remote-control` — флагом, который ограничивал бы или настраивал сессии, запускаемые Remote Control, например `--settings`, `--setting-sources`, `--permission-mode`, `--disallowed-tools` или `--mcp-config`. Флаг, указанный перед глаголом, никогда не доходит до этих сессий. Вместо этого Claude Code отказывается запускаться и называет флаг:

3523 3541

3524```text theme={null}3542```text theme={null}

3525Error: `--settings` before `remote-control` is not carried over to the sessions Remote Control starts, so Remote Control refuses to start rather than drop it — remove it, and give Remote Control's own options after the verb (see `claude remote-control --help`).3543Error: `--settings` before `remote-control` is not carried over to the sessions Remote Control starts, so Remote Control refuses to start rather than drop it — remove it, and give Remote Control's own options after the verb (see `claude remote-control --help`). Pass settings with `claude remote-control --settings <file>`.

3526```3544```

3527 3545

3528Claude Code не отклоняет глобальные флаги, которые безопасно отбросить, например `--verbose`, `--model` или добавленные обёрткой `--session-id` или `--plugin-dir`: он их игнорирует, и Remote Control запускается.3546Claude Code не отклоняет глобальные флаги, которые безопасно отбросить, например `--verbose`, `--model` или добавленные обёрткой `--session-id` или `--plugin-dir`: он их игнорирует, и Remote Control запускается.

3536 3554

3537До v2.1.248 `claude remote-control` не принимал собственные флаги, если первым шёл глобальный флаг, и команда завершалась с ошибкой `unknown option`.3555До v2.1.248 `claude remote-control` не принимал собственные флаги, если первым шёл глобальный флаг, и команда завершалась с ошибкой `unknown option`.

3538 3556

3557### Remote Control не запустился из-за файла `--settings`

3558

3559В файле, переданном в [`claude remote-control --settings`](https://code.claude.com/docs/ru/remote-control#start-a-remote-control-session), есть проблема:

3560

3561```text theme={null}

3562Error: Remote Control did not start, because sessions would skip part or all of the --settings file ./rc-settings.json: Invalid or malformed JSON

3563```

3564

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

3566

3567* Исправьте проблему, указанную в сообщении, затем снова выполните команду `claude remote-control`

3568

3569### The settings file has changed since Remote Control started

3570

3571Это сообщение в терминале, где работает `claude remote-control`, означает, что сессии не будут запускаться из файла, переданного в [`--settings`](https://code.claude.com/docs/ru/remote-control#start-a-remote-control-session), в его текущем виде:

3572

3573```text theme={null}

3574Session failed: Error: The settings file /path/to/settings.json has changed since Remote Control started, so this session did not start. Restart `claude remote-control` to use it as it is now.

3575```

3576

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

3578

3579* Чтобы использовать файл в текущем виде, остановите `claude remote-control` и снова выполните ту же команду. Чтобы вернуть сессии, которые он обслуживал, см. [Возобновление сессий после остановки сервера](https://code.claude.com/docs/ru/remote-control.md#resume-sessions-after-stopping-the-server).

3580* Чтобы сохранить настройки, с которыми запустился Remote Control, верните содержимое файла в прежний вид, затем снова выполните команду, если `claude remote-control` завершился

3581

3539### `--sandbox` or `--no-sandbox` is not supported by claude remote-control3582### `--sandbox` or `--no-sandbox` is not supported by claude remote-control

3540 3583

3541Эта ошибка означает, что команда, запускающая ваш сервер [Remote Control](https://code.claude.com/docs/ru/remote-control.md), передаёт `--sandbox` или `--no-sandbox` после `remote-control`, а `claude remote-control` не принимает ни один из этих флагов. Сервер завершается с кодом выхода 1 вместо запуска:3584Эта ошибка означает, что команда, запускающая ваш сервер [Remote Control](https://code.claude.com/docs/ru/remote-control.md), передаёт `--sandbox` или `--no-sandbox` после `remote-control`, а `claude remote-control` не принимает ни один из этих флагов. Сервер завершается с кодом выхода 1 вместо запуска:

3806 3849

3807Родственные сообщения появляются ещё до запуска команды:3850Родственные сообщения появляются ещё до запуска команды:

3808 3851

3809* `Shell command permission check failed for pattern "..."`: проверка разрешений команды её не разрешила. В разделе [Проверки разрешений для внедрённых команд](https://code.claude.com/docs/ru/skills.md#permission-checks-on-injected-commands) описано, какие результаты прерывают выполнение в каждом режиме разрешений и как заранее разрешить команду с помощью `allowed-tools`3852* `Shell command permission check failed for pattern "..."`: проверка разрешений для команды не разрешила её. В разделе [Проверки разрешений для внедрённых команд](https://code.claude.com/docs/ru/skills.md#permission-checks-on-injected-commands) описано, какие результаты прерывают выполнение в каждом режиме разрешений и как заранее разрешить команду с помощью `allowed-tools`

3810* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: frontmatter скилла требует bash на компьютере, где его нет. Установите Git for Windows или измените frontmatter на `shell: powershell`. См. [Как выполняются внедрённые команды](https://code.claude.com/docs/ru/skills.md#how-injected-commands-run)3853* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: frontmatter скилла требует bash на компьютере, где его нет. Установите Git for Windows или измените frontmatter на `shell: powershell`. См. [Как выполняются внедрённые команды](https://code.claude.com/docs/ru/skills.md#how-injected-commands-run)

3811 3854

3812**Что делать:**3855**Что делать:**

3960 4003

3961* **Вы не передали базовую ветку**: Claude Code сравнивал с веткой репозитория по умолчанию и предлагает явно передать вашу базовую ветку, как в примере выше4004* **Вы не передали базовую ветку**: Claude Code сравнивал с веткой репозитория по умолчанию и предлагает явно передать вашу базовую ветку, как в примере выше

3962* **Вы передали базовую ветку, которая уже была в вашем клоне**: подсказка гласит ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``4005* **Вы передали базовую ветку, которая уже была в вашем клоне**: подсказка гласит ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``

3963* **Вы передали базовую ветку, которой не было в вашем клоне**: Claude Code получил её из origin перед сравнением. Подсказка гласит ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``; если Claude Code не может определить, является ли ваш клон поверхностным (shallow), он вместо этого предлагает `git fetch --unshallow origin`. До версии v2.1.221 подсказка предлагала `git fetch --unshallow origin` для каждой полученной базовой ветки, а на полном клоне эта команда завершается ошибкой `fatal: --unshallow on a complete repository does not make sense`.4006* **Вы передали базовую ветку, которой не было в вашем клоне**: Claude Code получил её из origin перед сравнением. Подсказка гласит ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``; когда Claude Code не может определить, является ли ваш клон поверхностным, он вместо этого предлагает `git fetch --unshallow origin`. До версии v2.1.221 подсказка предлагала `git fetch --unshallow origin` для каждой полученной базовой ветки, а в полном клоне эта команда завершается ошибкой `fatal: --unshallow on a complete repository does not make sense`.

3964 4007

3965**Что делать:**4008**Что делать:**

3966 4009

gateways.md +1 −1

Details

63* **Телеметрия клиента**: Claude Code отключает свою аналитику, связанную с Anthropic, когда сеанс входит в Claude apps gateway. Чтобы также отключить аналитику запуска перед входом, доставьте [`DISABLE_TELEMETRY`](https://code.claude.com/docs/ru/managed-settings#turn-telemetry-off-for-your-organization) в [управляемых параметрах на стороне клиента](https://code.claude.com/docs/ru/claude-apps-gateway-config.md#client-side-managed-settings) на каждом устройстве.63* **Телеметрия клиента**: Claude Code отключает свою аналитику, связанную с Anthropic, когда сеанс входит в Claude apps gateway. Чтобы также отключить аналитику запуска перед входом, доставьте [`DISABLE_TELEMETRY`](https://code.claude.com/docs/ru/managed-settings#turn-telemetry-off-for-your-organization) в [управляемых параметрах на стороне клиента](https://code.claude.com/docs/ru/claude-apps-gateway-config.md#client-side-managed-settings) на каждом устройстве.

64* **Телеметрия клиента на других шлюзах**: отправляет ли Claude Code дополнительный поток телеметрии клиента, зависит от вашего поставщика, и [таблица стандартных значений телеметрии](https://code.claude.com/docs/ru/data-usage.md#default-behaviors-by-api-provider) охватывает каждый случай.64* **Телеметрия клиента на других шлюзах**: отправляет ли Claude Code дополнительный поток телеметрии клиента, зависит от вашего поставщика, и [таблица стандартных значений телеметрии](https://code.claude.com/docs/ru/data-usage.md#default-behaviors-by-api-provider) охватывает каждый случай.

65* **Назначения телеметрии**: куда Claude Code отправляет телеметрию сеанса шлюза, зависит от того, как сеанс вошел, и [What's enforced on developers](https://code.claude.com/docs/ru/claude-apps-gateway#whats-enforced-on-developers) говорит, куда идут экспорты каждого вида сеанса.65* **Назначения телеметрии**: куда Claude Code отправляет телеметрию сеанса шлюза, зависит от того, как сеанс вошел, и [What's enforced on developers](https://code.claude.com/docs/ru/claude-apps-gateway#whats-enforced-on-developers) говорит, куда идут экспорты каждого вида сеанса.

66* **Корпоративные HTTP прокси**: `HTTPS_PROXY` находится между Claude Code и каждым сервером, с которым он разговаривает, включая шлюз. Если ваша сеть требует его, [настройте прокси](https://code.claude.com/docs/ru/network-config.md) в дополнение к шлюзу. Для Claude apps gateway, который вы размещаете, [вход проверяет, что хост прокси также находится в частной сети](https://code.claude.com/docs/ru/claude-apps-gateway#prerequisites); если это не так, добавьте хост шлюза в `NO_PROXY`, чтобы CLI подключался к нему напрямую.66* **Корпоративные HTTP прокси**: Claude Code отправляет свои запросы, включая запросы к шлюзу, через прокси, указанный в `HTTPS_PROXY`. Если ваша сеть требует прокси, [настройте его](https://code.claude.com/docs/ru/network-config.md). Если прокси применяется к Claude apps gateway, который вы размещаете, для [входа](https://code.claude.com/docs/ru/claude-apps-gateway#prerequisites) требуется, чтобы имя хоста прокси разрешалось в частные адреса, либо чтобы хост шлюза был указан в `NO_PROXY`.

67 67

68## Next steps68## Next steps

69 69

github-actions-cloud-providers.md +2 −2

Details

83>83>

84> Создайте приложение Microsoft Entra с федеративным учетным данием для вашего репозитория, следуя [руководству Microsoft по аутентификации из GitHub Actions](https://learn.microsoft.com/en-us/azure/developer/github/connect-from-azure-openid-connect):84> Создайте приложение Microsoft Entra с федеративным учетным данием для вашего репозитория, следуя [руководству Microsoft по аутентификации из GitHub Actions](https://learn.microsoft.com/en-us/azure/developer/github/connect-from-azure-openid-connect):

85>85>

86> * Зарегистрируйте приложение Microsoft Entra и добавьте федеративное учетное дание идентификации, которое доверяет токенам, выданным GitHub вашему репозиторию. Управляемое удостоверение, назначенное пользователем, работает вместо приложения. Оба имеют ID клиента, который вы запишите ниже86> * Зарегистрируйте приложение Microsoft Entra и добавьте федеративные учётные данные идентификации, которые доверяют токенам, выданным GitHub вашему репозиторию. Управляемое удостоверение, назначенное пользователем, работает вместо приложения. Оба имеют ID клиента, который вы запишите ниже

87> * Назначьте приложению роль `Azure AI User` на вашем ресурсе Foundry. См. [конфигурацию Azure RBAC](https://code.claude.com/docs/ru/microsoft-foundry.md#azure-rbac-configuration) для более узкой пользовательской роли87> * Назначьте приложению роль `Foundry User` на вашем ресурсе Foundry. См. [конфигурацию Azure RBAC](https://code.claude.com/docs/ru/microsoft-foundry.md#azure-rbac-configuration) для другой встроенной роли и пользовательских ролей

88>88>

89> Запишите ID клиента приложения, ID вашего тенанта и ID вашей подписки. Вы добавляете их как секреты на следующем шаге.89> Запишите ID клиента приложения, ID вашего тенанта и ID вашей подписки. Вы добавляете их как секреты на следующем шаге.

90 90

google-vertex-ai.md +8 −3

Details

228 228

229### Когда модель отключается во время сессии229### Когда модель отключается во время сессии

230 230

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

232 232

233Переключение применяется только к уровню, который вы не закрепили, — то же условие, что и для резервного варианта при запуске. Сессия на выбранной вами конкретной версии сохраняет свою модель, и без цепочки резервных моделей запрос вместо этого завершается ошибкой. В [авторежиме](https://code.claude.com/docs/ru/permission-modes.md#enable-auto-mode-on-bedrock-agent-platform-or-foundry) Claude Code переключается только на модель, которую авторежим поддерживает на Agent Platform. Если ни одна из этих моделей также не доступна, запрос завершается ошибкой.233Если вы настроили [цепочку резервных моделей](https://code.claude.com/docs/ru/model-config.md#fallback-model-chains), Claude Code вместо этого переключается на настроенную вами резервную модель. Без цепочки запрос завершается ошибкой, например в таких случаях:

234 234

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

236* Ни одна из [моделей, которые пробует Claude Code](#startup-model-checks), не доступна. В [авторежиме](https://code.claude.com/docs/ru/permission-modes.md#enable-auto-mode-on-bedrock-agent-platform-or-foundry) Claude Code переключается только на модель, которую авторежим поддерживает на Agent Platform.

237

238Чтобы продолжить работу, выполните `/model` в сессии и нажмите `s` на модели, доступной в вашем проекте и регионе; при этом ваша модель по умолчанию не изменится.

239

240Чтобы отклонённые запросы завершались ошибкой, а не приводили к переключению, установите [`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](https://code.claude.com/docs/ru/env-vars). Если вы настроили цепочку резервных моделей, удалите и её, поскольку Claude Code всё равно переключится на эту резервную модель.

236 241

237## Конфигурация IAM242## Конфигурация IAM

238 243

hooks.md +9 −3

Details

3000 3000

3001Запускается, когда файл конфигурации изменяется во время сессии. Используйте это для аудита изменений настроек, применения политик безопасности или блокировки несанкционированных изменений файлов конфигурации.3001Запускается, когда файл конфигурации изменяется во время сессии. Используйте это для аудита изменений настроек, применения политик безопасности или блокировки несанкционированных изменений файлов конфигурации.

3002 3002

3003Claude Code запускает хуки ConfigChange, когда изменяется файл настроек, файл управляемой политики или файл скилла. Для управляемой политики он запускает их, только когда изменяется `managed-settings.json` или файл в `managed-settings.d/`. [Настройки, управляемые сервером](https://code.claude.com/docs/ru/server-managed-settings.md), а также изменения управляемых настроек macOS или политики реестра Windows он применяет без запуска хуков. В WSL с [`wslInheritsWindowsSettings`](https://code.claude.com/docs/ru/settings-reference#wslinheritswindowssettings) он также применяет изменённый файл управляемых настроек на стороне Windows при опросе политики без запуска хуков.3003Claude Code запускает хуки ConfigChange, когда изменяется файл настроек, файл управляемой политики или файл скилла. Для управляемой политики он запускает их, только когда изменяется `managed-settings.json` или файл в `managed-settings.d/`.

3004 3004

3005Matcher фильтрует по источнику конфигурации:3005Matcher фильтрует по источнику конфигурации:

3006 3006

3014 3014

3015Этот пример записывает в лог все изменения конфигурации для аудита безопасности:3015Изменения, подобные перечисленным ниже, вступают в силу без запуска хуков:

3016

3017* Правила и настройки, которые вы сохраняете через **Yes, and don't ask again**, `/permissions` или `/model`, в той сессии, из которой вы их сохранили. Если другая открытая сессия загружает тот же файл, хуки запускаются в ней.

3018* Обновления [настроек, управляемых сервером](https://code.claude.com/docs/ru/server-managed-settings.md), управляемых настроек macOS или политик реестра Windows

3019* В WSL с [`wslInheritsWindowsSettings`](https://code.claude.com/docs/ru/settings-reference#wslinheritswindowssettings) — изменённый файл управляемых настроек на стороне Windows, который Claude Code подхватывает при опросе политик

3020

3021В этом примере изменения конфигурации записываются в журнал для аудита безопасности:

3016 3022

3017```json theme={null}3023```json theme={null}

3018{3024{

3335 "hooks": [3341 "hooks": [

3336 {3342 {

3337 "type": "command",3343 "type": "command",

3338 "command": "bash -c 'jq -r .worktree_path | xargs rm -rf'"3344 "command": "bash -c 'p=$(jq -er .worktree_path) && rm -rf -- \"$p\"'"

3339 }3345 }

3340 ]3346 ]

3341 }3347 }

hooks-guide.md +3 −3

Details

50 "PostToolUse": [50 "PostToolUse": [

51 {51 {

52 "matcher": "Edit|Write",52 "matcher": "Edit|Write",

~~53 "hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write" }]~~53 "hooks": [{ "type": "command", "command": "f=$(jq -r '.tool_input.file_path') && npx prettier --write --ignore-unknown \"$f\"" }]

54 }54 }

55 ],55 ],

56 "Notification": [56 "Notification": [

221 "hooks": [221 "hooks": [

222 {222 {

223 "type": "command",223 "type": "command",

224 "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"224 "command": "f=$(jq -r '.tool_input.file_path') && npx prettier --write --ignore-unknown \"$f\""

225 }225 }

226 ]226 ]

227 }227 }

336 336

337Отслеживайте, когда файлы параметров или skills изменяются во время сеанса. Событие `ConfigChange` срабатывает, когда внешний процесс или редактор изменяет файл конфигурации, поэтому вы можете регистрировать изменения для соответствия или блокировать несанкционированные изменения.337Отслеживайте, когда файлы параметров или skills изменяются во время сеанса. Событие `ConfigChange` срабатывает, когда внешний процесс или редактор изменяет файл конфигурации, поэтому вы можете регистрировать изменения для соответствия или блокировать несанкционированные изменения.

338 338

339Этот пример добавляет каждое изменение в журнал аудита. Добавьте это в `~/.claude/settings.json`:339Этот пример добавляет каждое событие в журнал аудита. Добавьте это в `~/.claude/settings.json`:

340 340

341```json theme={null}341```json theme={null}

342{342{

interactive-mode.md +3 −7

Details

36| `Esc` | Прерывание Claude или закрытие диалога | Остановить текущий ответ или вызов инструмента в середине хода, чтобы вы могли перенаправить. Claude сохраняет выполненную работу. Если у вас есть [очередные сообщения](#queue-messages-while-claude-works), Claude Code отправляет их дальше. Когда диалог открыт, `Esc` закрывает диалог. Пока элемент нижнего колонтитула выбран, такой как строка в [панели подагента](https://code.claude.com/docs/ru/sub-agents.md#run-subagents-in-foreground-or-background) ниже подсказки, `Esc` [отменяет его выбор](https://code.claude.com/docs/ru/keybindings.md#footer-actions) вместо прерывания. На подсказке разрешения `Esc` отклоняет действие, то же самое, что [**No** без комментария](https://code.claude.com/docs/ru/permissions.md#add-a-comment-when-you-answer-a-permission-prompt) |36| `Esc` | Прерывание Claude или закрытие диалога | Остановить текущий ответ или вызов инструмента в середине хода, чтобы вы могли перенаправить. Claude сохраняет выполненную работу. Если у вас есть [очередные сообщения](#queue-messages-while-claude-works), Claude Code отправляет их дальше. Когда диалог открыт, `Esc` закрывает диалог. Пока элемент нижнего колонтитула выбран, такой как строка в [панели подагента](https://code.claude.com/docs/ru/sub-agents.md#run-subagents-in-foreground-or-background) ниже подсказки, `Esc` [отменяет его выбор](https://code.claude.com/docs/ru/keybindings.md#footer-actions) вместо прерывания. На подсказке разрешения `Esc` отклоняет действие, то же самое, что [**No** без комментария](https://code.claude.com/docs/ru/permissions.md#add-a-comment-when-you-answer-a-permission-prompt) |

37| `Esc` + `Esc` | Очистить черновик ввода или перемотать | Когда ввод подсказки содержит текст, двойной `Esc` очищает его и сохраняет черновик в историю, чтобы `Up` его вспомнил. Когда ввод пуст, двойной `Esc` открывает [меню перемотки](https://code.claude.com/docs/ru/checkpointing.md) для восстановления или суммирования кода и разговора с предыдущей точки |37| `Esc` + `Esc` | Очистить черновик ввода или перемотать | Когда ввод подсказки содержит текст, двойной `Esc` очищает его и сохраняет черновик в историю, чтобы `Up` его вспомнил. Когда ввод пуст, двойной `Esc` открывает [меню перемотки](https://code.claude.com/docs/ru/checkpointing.md) для восстановления или суммирования кода и разговора с предыдущей точки |

38| `Ctrl+Enter` или `Ctrl+X Ctrl+S` | Отправить очередные сообщения сейчас | Отправляет ваши [очередные сообщения](#queue-messages-while-claude-works) и ваш черновик с ними прямо сейчас. [Когда Claude Code отправляет то, что вы поставили в очередь](#when-claude-code-sends-what-you-queued) охватывает то, что происходит с ходом, над которым работает Claude. В [режиме shell](#shell-mode-with-prefix) клавиша ставит вашу команду в очередь. В терминалах, которые не сообщают о расширенных клавишах, `Ctrl+Enter` приходит как простой `Enter`; `Ctrl+X Ctrl+S` работает в любом терминале. Требует Claude Code v2.1.275 или более поздней версии |38| `Ctrl+Enter` или `Ctrl+X Ctrl+S` | Отправить очередные сообщения сейчас | Отправляет ваши [очередные сообщения](#queue-messages-while-claude-works) и ваш черновик с ними прямо сейчас. [Когда Claude Code отправляет то, что вы поставили в очередь](#when-claude-code-sends-what-you-queued) охватывает то, что происходит с ходом, над которым работает Claude. В [режиме shell](#shell-mode-with-prefix) клавиша ставит вашу команду в очередь. В терминалах, которые не сообщают о расширенных клавишах, `Ctrl+Enter` приходит как простой `Enter`; `Ctrl+X Ctrl+S` работает в любом терминале. Требует Claude Code v2.1.275 или более поздней версии |

39| `Shift+Tab`, или `Alt+M` на Windows, когда среда выполнения Node или Bun не включает режим ввода VT | Циклический переход по режимам разрешений | Циклический переход через `default` (помечено как Manual в индикаторе режима), `acceptEdits`, `plan` и, если доступно, `bypassPermissions` и затем `auto`. Из `auto` первое нажатие переключается на `default`. См. [режимы разрешений](https://code.claude.com/docs/ru/permission-modes.md). На подсказке разрешения файла то же самое ключевое слово закрывает открытое [поле комментария](https://code.claude.com/docs/ru/permissions.md#add-a-comment-when-you-answer-a-permission-prompt). Без открытого поля выбирает параметр, который разрешает действие на остаток сеанса, когда подсказка предлагает этот параметр |39| `Shift+Tab`, или `Alt+M` на Windows, когда среда выполнения Node или Bun не включает режим ввода VT | Циклический переход по режимам разрешений | Циклический переход через `default` (помечен как Manual в индикаторе режима), `acceptEdits` и `plan`, а затем `bypassPermissions` и `auto`, если они доступны. См. [режимы разрешений](https://code.claude.com/docs/ru/permission-modes.md). В запросе разрешения для файла та же клавиша закрывает открытое [поле комментария](https://code.claude.com/docs/ru/permissions.md#add-a-comment-when-you-answer-a-permission-prompt). Если поле не открыто, она выбирает вариант, разрешающий действие до конца сессии, когда запрос предлагает такой вариант. В запросе на утверждение плана она утверждает план |

41| `Option+T` (macOS) или `Alt+T` (Windows/Linux) | Переключение расширенного мышления | Включение или отключение режима расширенного мышления. Не влияет на Opus 5.5, Sonnet 5.5, Haiku 5.5 или модели Fable, которые всегда используют расширенное мышление. Работает на macOS без настройки Option как Meta |41| `Option+T` (macOS) или `Alt+T` (Windows/Linux) | Переключение расширенного мышления | Включение или отключение режима расширенного мышления. Не влияет на Opus 5.5, Sonnet 5.5, Haiku 5.5 или модели Fable, которые всегда используют расширенное мышление. Работает на macOS без настройки Option как Meta |

42| `Option+O` (macOS) или `Alt+O` (Windows/Linux) | Переключение быстрого режима | Включение или отключение [быстрого режима](https://code.claude.com/docs/ru/fast-mode.md) |42| `Option+O` (macOS) или `Alt+O` (Windows/Linux) | Переключение быстрого режима | Включение или отключение [быстрого режима](https://code.claude.com/docs/ru/fast-mode.md) |

81| :- | :- | :- |81| :- | :- | :- |

84| Shift+Enter | `Shift+Enter` | Встроено в iTerm2, WezTerm, Ghostty, Kitty, Warp, Apple Terminal, Windows Terminal. Для других терминалов см. [Ввод многострочных подсказок](https://code.claude.com/docs/ru/terminal-config.md#enter-multiline-prompts) |84| Shift+Enter | `Shift+Enter` | Встроено в iTerm2, WezTerm, Ghostty, Kitty, Warp, Windows Terminal. Для других терминалов см. [Ввод многострочных промптов](https://code.claude.com/docs/ru/terminal-config.md#enter-multiline-prompts) |

87 87

137 137

138Включите редактирование в стиле vim через `/config` → Editor mode.138Включите редактирование в стиле vim через `/config` → Editor mode.

139 139

140Claude Code сохраняет ваш режим vim и позицию курсора при переключении [средства просмотра стенограммы](#transcript-viewer) с помощью `Ctrl+O` или при открытии и закрытии панели, такой как `/config`. Если вы оставите приглашение в режиме NORMAL, оно остаётся в режиме NORMAL при возврате, с курсором там, где вы его оставили.

~~141~~

142### Переключение режимов140### Переключение режимов

143 141

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

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

304 302

305Принятие совпадения или отмена поиска вступают в силу немедленно, даже если Claude Code всё ещё загружает историю.

~~306~~

307Чтобы найти более ранний промпт, когда вы помните только что-то длинное, что вставляли в него, например лог ошибок, нажмите `Ctrl+R` и введите слово из вставленного текста. Требуется Claude Code v2.1.314 или более поздней версии.303Чтобы найти более ранний промпт, когда вы помните только что-то длинное, что вставляли в него, например лог ошибок, нажмите `Ctrl+R` и введите слово из вставленного текста. Требуется Claude Code v2.1.314 или более поздней версии.

308 304

309## Фоновые команды Bash305## Фоновые команды Bash

600 596

601### Что Claude Code подчеркивает597### Что Claude Code подчеркивает

602 598

603Вскоре после того, как вы прекратите ввод, Claude Code подчеркивает слова, которые словарь не знает. Он оставляет слово, которое вы все еще вводите, в покое, пока вы не перейдете дальше, и никогда не изменяет ваш текст. Он также пропускает текст, который выглядит как код:599Вскоре после того, как вы прекратите ввод, Claude Code подчеркивает слова, которые словарь не знает. Он оставляет слово, которое вы все еще вводите, в покое, пока вы не перейдете дальше. Он также пропускает текст, который выглядит как код:

604 600

605* Команды, такие как `/help`, упоминания `@`, URL-адреса, пути к файлам и флаги, такие как `--verbose`601* Команды, такие как `/help`, упоминания `@`, URL-адреса, пути к файлам и флаги, такие как `--verbose`

606* Слова с цифрами, подчеркиваниями или заглавной буквой после первой, и текст в обратных кавычках602* Слова с цифрами, подчеркиваниями или заглавной буквой после первой, и текст в обратных кавычках

keybindings.md +6 −1

Details

581 581

582Claude Code привязывает следующие аккорды по умолчанию на префиксе `ctrl+x`, по контекстам:582Claude Code привязывает следующие аккорды по умолчанию на префиксе `ctrl+x`, по контекстам:

583 583

584* `Chat`: `ctrl+x ctrl+k`, `ctrl+x ctrl+e`, `ctrl+x enter`, `ctrl+x ctrl+a`, `ctrl+x ctrl+s` и `ctrl+x tab`584* `Chat`: `ctrl+x ctrl+k`, `ctrl+x ctrl+e`, `ctrl+x enter`, `ctrl+x ctrl+a`, `ctrl+x ctrl+s`, `ctrl+x tab`, `ctrl+x ctrl+=`, `ctrl+x ctrl+-`, `ctrl+x ctrl+_`, `ctrl+x =` и `ctrl+x -`

585* `Task`: `ctrl+x ctrl+b`585* `Task`: `ctrl+x ctrl+b`

586* `DiffPanel`: `ctrl+x b`586* `DiffPanel`: `ctrl+x b`

587* `Pane`: `ctrl+x left`, `ctrl+x right`, `ctrl+x up`, `ctrl+x down` и `ctrl+x x`587* `Pane`: `ctrl+x left`, `ctrl+x right`, `ctrl+x up`, `ctrl+x down` и `ctrl+x x`

631 "ctrl+x ctrl+a": null,631 "ctrl+x ctrl+a": null,

632 "ctrl+x ctrl+s": null,632 "ctrl+x ctrl+s": null,

633 "ctrl+x tab": null,633 "ctrl+x tab": null,

634 "ctrl+x ctrl+=": null,

635 "ctrl+x ctrl+-": null,

636 "ctrl+x ctrl+_": null,

637 "ctrl+x =": null,

638 "ctrl+x -": null,

634 "ctrl+x": "chat:newline"639 "ctrl+x": "chat:newline"

635 }640 }

636 }641 }

llm-gateway-connect.md +3 −2

Details

156 156

157### Конфликты с существующим входом157### Конфликты с существующим входом

158 158

159Переменная учётных данных шлюза имеет приоритет над сохранённым входом claude.ai или ключом Console. С `ANTHROPIC_AUTH_TOKEN` переменная имеет приоритет немедленно. С `ANTHROPIC_API_KEY` вам один раз в интерактивном режиме предлагается одобрить ключ, прежде чем он вступит в силу.159Ваши запросы используют переменную учётных данных шлюза, а не сохранённый вход claude.ai. С `ANTHROPIC_AUTH_TOKEN` переменная имеет приоритет немедленно. С `ANTHROPIC_API_KEY` вам один раз в интерактивном режиме предлагается одобрить ключ, прежде чем он вступит в силу.

160 160

161Запустите `/status`, чтобы подтвердить, какой источник учетных данных активен. Если при запуске показывается предупреждение о конфликте аутентификации, называющее два источника, см. первую строку [таблицы устранения неполадок](#troubleshoot-gateway-errors), чтобы узнать, какой из них отбросить. Чтобы очистить сохраненный вход, чтобы остались только учетные данные шлюза, запустите `/logout`.161Запустите `/status`, чтобы подтвердить, какой источник учетных данных активен. Если при запуске показывается предупреждение о конфликте аутентификации, называющее два источника, см. первую строку [таблицы устранения неполадок](#troubleshoot-gateway-errors), чтобы узнать, какой из них отбросить. Чтобы очистить сохраненный вход, чтобы остались только учетные данные шлюза, запустите `/logout`.

162 162

506 506

508| :- | :- | :- |508| :- | :- | :- |

509| Предупреждение при запуске, называющее два источника учетных данных и заканчивающееся на `auth may not work as expected`. Более старые версии показывают `Auth conflict: Both a token (SOURCE) and an API key (SOURCE) are set` вместо этого. | Учетные данные шлюза и сохраненный вход оба активны; переменная используется для запросов, но устаревший вход может вызвать неожиданное поведение аутентификации | Отмените установку переменной, чтобы использовать сохраненный вход, или запустите `/logout`, чтобы использовать учетные данные шлюза |509| Предупреждение при запуске, называющее два источника учётных данных и заканчивающееся на `auth may not work as expected`. Более старые версии показывают `Auth conflict: Both a token (SOURCE) and an API key (SOURCE) are set` вместо этого. | Учётные данные шлюза и сохраненный вход активны одновременно | Отмените установку переменной, чтобы использовать сохраненный вход, или запустите `/logout`, чтобы использовать учётные данные шлюза |

510| Ошибки `401`, называющие недействительный или неузнанный токен | Учетные данные не являются теми, которые выдал шлюз, или они находятся в заголовке, который шлюз не читает | Подтвердите, что переменная соответствует вашему типу учетных данных в [таблице учетных данных](#set-the-credential-variable), и перевыпустите ключ на шлюзе, если он был отозван |510| Ошибки `401`, называющие недействительный или неузнанный токен | Учетные данные не являются теми, которые выдал шлюз, или они находятся в заголовке, который шлюз не читает | Подтвердите, что переменная соответствует вашему типу учетных данных в [таблице учетных данных](#set-the-credential-variable), и перевыпустите ключ на шлюзе, если он был отозван |

511| `Your apiKeyHelper script is failing`, или `apiKeyHelper failed:` на stderr в неинтерактивном режиме | Команда в параметре [`apiKeyHelper`](https://code.claude.com/docs/ru/settings-reference#apikeyhelper) не выдала пригодный ключ, поэтому запросы содержат заполнитель ключа | Запустите команду напрямую, чтобы увидеть, почему она не работает, и повторно аутентифицируйтесь у поставщика учетных данных, если он сообщает об истекшем сеансе; см. [справочник по ошибкам](https://code.claude.com/docs/ru/errors.md#your-apikeyhelper-script-is-failing) |511| `Your apiKeyHelper script is failing`, или `apiKeyHelper failed:` на stderr в неинтерактивном режиме | Команда в параметре [`apiKeyHelper`](https://code.claude.com/docs/ru/settings-reference#apikeyhelper) не выдала пригодный ключ, поэтому запросы содержат заполнитель ключа | Запустите команду напрямую, чтобы увидеть, почему она не работает, и повторно аутентифицируйтесь у поставщика учетных данных, если он сообщает об истекшем сеансе; см. [справочник по ошибкам](https://code.claude.com/docs/ru/errors.md#your-apikeyhelper-script-is-failing) |

512| `Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)` когда ничто не отвечает по адресу, или `Can't reach the API server — check your internet or DNS (ENOTFOUND)` когда имя хоста не разрешается, часто после молчаливой паузы, пока Claude Code [повторяет с отступом](https://code.claude.com/docs/ru/errors.md#automatic-retries). Код в скобках варьируется; [Unable to connect to API](https://code.claude.com/docs/ru/errors.md#unable-to-connect-to-api) охватывает варианты кодов и более раннюю формулировку | Ничто не ответило на базовый URL: адрес неправильный, или VPN или брандмауэр блокирует путь к шлюзу | Запустите [тест curl выше](#verify-the-connection), который немедленно не проходит с той же причиной, и подтвердите URL и сетевой путь с командой шлюза |512| `Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)` когда ничто не отвечает по адресу, или `Can't reach the API server — check your internet or DNS (ENOTFOUND)` когда имя хоста не разрешается, часто после молчаливой паузы, пока Claude Code [повторяет с отступом](https://code.claude.com/docs/ru/errors.md#automatic-retries). Код в скобках варьируется; [Unable to connect to API](https://code.claude.com/docs/ru/errors.md#unable-to-connect-to-api) охватывает варианты кодов и более раннюю формулировку | Ничто не ответило на базовый URL: адрес неправильный, или VPN или брандмауэр блокирует путь к шлюзу | Запустите [тест curl выше](#verify-the-connection), который немедленно не проходит с той же причиной, и подтвердите URL и сетевой путь с командой шлюза |

520| `/fast` сообщает `Fast mode unavailable due to network connectivity issues`, в то время как запросы вывода работают | Проверка доступности [быстрого режима](https://code.claude.com/docs/ru/fast-mode.md) идёт непосредственно на `api.anthropic.com` и не следует `ANTHROPIC_BASE_URL`, поэтому заблокированный прямой исходящий трафик не проходит проверку | Добавьте `api.anthropic.com` в список разрешённых доменов, если исходящий трафик заблокирован, или установите переменную пропуска. См. [использование быстрого режима за прокси и LLM-шлюзами](https://code.claude.com/docs/ru/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) |520| `/fast` сообщает `Fast mode unavailable due to network connectivity issues`, в то время как запросы вывода работают | Проверка доступности [быстрого режима](https://code.claude.com/docs/ru/fast-mode.md) идёт непосредственно на `api.anthropic.com` и не следует `ANTHROPIC_BASE_URL`, поэтому заблокированный прямой исходящий трафик не проходит проверку | Добавьте `api.anthropic.com` в список разрешённых доменов, если исходящий трафик заблокирован, или установите переменную пропуска. См. [использование быстрого режима за прокси и LLM-шлюзами](https://code.claude.com/docs/ru/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) |

521| `/fast` сообщает `Fast mode is currently unavailable` в сессии, которая аутентифицируется с помощью выданного шлюзом ключа в `ANTHROPIC_API_KEY` | Пока `ANTHROPIC_BASE_URL` указывает на ваш шлюз, а ключ не соответствует формату API-ключа Anthropic, Claude Code не отправляет проверку доступности [быстрого режима](https://code.claude.com/docs/ru/fast-mode.md). При отсутствии закэшированной ранее успешной проверки он считает быстрый режим недоступным | Установите `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS=1`; см. [использование быстрого режима за прокси и LLM-шлюзами](https://code.claude.com/docs/ru/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) |521| `/fast` сообщает `Fast mode is currently unavailable` в сессии, которая аутентифицируется с помощью выданного шлюзом ключа в `ANTHROPIC_API_KEY` | Пока `ANTHROPIC_BASE_URL` указывает на ваш шлюз, а ключ не соответствует формату API-ключа Anthropic, Claude Code не отправляет проверку доступности [быстрого режима](https://code.claude.com/docs/ru/fast-mode.md). При отсутствии закэшированной ранее успешной проверки он считает быстрый режим недоступным | Установите `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS=1`; см. [использование быстрого режима за прокси и LLM-шлюзами](https://code.claude.com/docs/ru/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) |

522| `/fast` сообщает `Fast mode has been disabled by your organization` в сессии, аутентифицированной с помощью `ANTHROPIC_AUTH_TOKEN`, даже если в организации включён быстрый режим | Проверка доступности требует входа в claude.ai или API-ключа; при наличии только Bearer-токена Claude Code считает быстрый режим отключённым, не отправляя проверку | Установите `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1`; см. [использование быстрого режима за прокси и LLM-шлюзами](https://code.claude.com/docs/ru/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) |522| `/fast` сообщает `Fast mode has been disabled by your organization` в сессии, аутентифицированной с помощью `ANTHROPIC_AUTH_TOKEN`, даже если в организации включён быстрый режим | Проверка доступности требует входа в claude.ai или API-ключа; при наличии только Bearer-токена Claude Code считает быстрый режим отключённым, не отправляя проверку | Установите `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1`; см. [использование быстрого режима за прокси и LLM-шлюзами](https://code.claude.com/docs/ru/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) |

523| `/feedback` сохраняет локальный файл в сессии, которая использует `ANTHROPIC_BASE_URL` | За шлюзом `ANTHROPIC_AUTH_TOKEN` и ключ, не соответствующий формату API-ключа Anthropic, не являются учётными данными Anthropic. Без таких учётных данных Claude Code записывает отчёт в локальный архив в `~/.claude/feedback-bundles/` вместо того, чтобы отправить его | Отправьте файл представителю вашего аккаунта Anthropic или приложите его к запросу в службу поддержки. См. [сервисы телеметрии](https://code.claude.com/docs/ru/data-usage.md#telemetry-services) |

523| Claude Code просит вас войти, даже если [тест curl](#verify-the-connection) успешен | CLI не имеет собственных учетных данных: достижимый базовый URL не является одним, и в интерактивном сеансе блок `env` в `.claude/settings.json` или `.claude/settings.local.json` проекта применяется только после мастера первого запуска и [подсказки доверия](https://code.claude.com/docs/ru/permissions.md#what-runs-before-you-trust-a-folder) | Установите `ANTHROPIC_AUTH_TOKEN` где-то, где Claude Code читает перед первоначальной настройкой: экспорт оболочки, блок `env` в `~/.claude/settings.json` или управляемые параметры |524| Claude Code просит вас войти, даже если [тест curl](#verify-the-connection) успешен | CLI не имеет собственных учетных данных: достижимый базовый URL не является одним, и в интерактивном сеансе блок `env` в `.claude/settings.json` или `.claude/settings.local.json` проекта применяется только после мастера первого запуска и [подсказки доверия](https://code.claude.com/docs/ru/permissions.md#what-runs-before-you-trust-a-folder) | Установите `ANTHROPIC_AUTH_TOKEN` где-то, где Claude Code читает перед первоначальной настройкой: экспорт оболочки, блок `env` в `~/.claude/settings.json` или управляемые параметры |

524| `ANTHROPIC_API_KEY` установлен, но игнорируется, без подсказки | Ключ требует одобрения один раз в интерактивных сеансах, и ранее отклоненный ключ игнорируется без повторного запроса | Включите его под `/config` с опцией `Use custom API key` |525| `ANTHROPIC_API_KEY` установлен, но игнорируется, без подсказки | Ключ требует одобрения один раз в интерактивных сеансах, и ранее отклоненный ключ игнорируется без повторного запроса | Включите его под `/config` с опцией `Use custom API key` |

525| `This machine's managed settings require a first-party login`, или [`Administrator policy requires a Cloud gateway sign-in`](https://code.claude.com/docs/ru/errors#administrator-policy-requires-a-cloud-gateway-sign-in) когда управляемые параметры устанавливают `forceLoginMethod` на `"gateway"` или также устанавливают `forceLoginGatewayUrl` | Управляемые параметры включают `forceLoginMethod` или `forceLoginOrgUUID`, которые не могут сосуществовать с `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper` | Администратор должен удалить `forceLoginMethod`, `forceLoginOrgUUID` и `forceLoginGatewayUrl` из управляемых параметров, чтобы использовать учетные данные шлюза, или удалить учетные данные шлюза и использовать вход, который требуют управляемые параметры. Эти два не могут быть объединены |526| `This machine's managed settings require a first-party login`, или [`Administrator policy requires a Cloud gateway sign-in`](https://code.claude.com/docs/ru/errors#administrator-policy-requires-a-cloud-gateway-sign-in) когда управляемые параметры устанавливают `forceLoginMethod` на `"gateway"` или также устанавливают `forceLoginGatewayUrl` | Управляемые параметры включают `forceLoginMethod` или `forceLoginOrgUUID`, которые не могут сосуществовать с `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper` | Администратор должен удалить `forceLoginMethod`, `forceLoginOrgUUID` и `forceLoginGatewayUrl` из управляемых параметров, чтобы использовать учетные данные шлюза, или удалить учетные данные шлюза и использовать вход, который требуют управляемые параметры. Эти два не могут быть объединены |

llm-gateway-rollout.md +5 −5

Details

142claude -p "Reply with one word: connected"142claude -p "Reply with one word: connected"

143```143```

144 144

145**Контрольная точка**: подсказка возвращает ответ, и запрос появляется в журнале шлюза как `POST` к пути `/v1/messages` со статусом `200`. Claude Code добавляет строку запроса, такую как `?beta=true`, поэтому сопоставляйте по пути, а не по полному URL. Два сообщения об ошибке указывают в разные стороны:145**Контрольная точка**: промпт возвращает ответ, и запрос появляется в логе шлюза как `POST` к пути `/v1/messages` со статусом `200`. Claude Code добавляет строку запроса, такую как `?beta=true`, поэтому сопоставляйте по пути, а не по полному URL. Проверьте сообщение об ошибке:

146 146

147* `Not logged in`: проверьте журнал шлюза, чтобы различить две причины. Если он пуст, никакие учетные данные не достигли сеанса и никакой запрос не покинул машину; повторно запустите экспорты в оболочке, которую вы тестируете. Если он показывает отклоненный запрос с `x-api-key` в теле `401`, шлюз ожидает ключи в этом заголовке вместо этого; переключитесь на `ANTHROPIC_API_KEY`147* `Not logged in`: проверьте лог шлюза. Если он пуст, никакие учётные данные не достигли сессии и никакой запрос не покинул машину; повторно запустите экспорты в оболочке, из которой вы тестируете. Если он показывает `401` от шлюза с упоминанием `x-api-key`, шлюз ожидает ключи в этом заголовке; переключитесь на `ANTHROPIC_API_KEY`. Если он показывает `401` от `api.anthropic.com` или эндпоинта вашего поставщика, исправьте учётные данные поставщика, которые держит шлюз

148* `Failed to authenticate. API Error: 401` означает, что учетные данные были отправлены и отклонены, и журнал шлюза говорит где: `401`, называющий `api.anthropic.com` или конечную точку вашего поставщика, означает, что шлюз достиг восходящего потока, но его учетные данные поставщика были отклонены, поэтому ключ разработчика работал и учетные данные поставщика, которые держит шлюз, неправильные или заполнитель148* `Failed to authenticate. API Error: 401` означает, что учетные данные были отправлены и отклонены, и журнал шлюза говорит где: `401`, называющий `api.anthropic.com` или конечную точку вашего поставщика, означает, что шлюз достиг восходящего потока, но его учетные данные поставщика были отклонены, поэтому ключ разработчика работал и учетные данные поставщика, которые держит шлюз, неправильные или заполнитель

149 149

150Неправильный или недостижимый базовый URL производит другой симптом: Claude Code [повторяет попытку подключения с отступом](https://code.claude.com/docs/ru/errors.md#automatic-retries) и может сидеть без вывода в течение нескольких минут перед сообщением об ошибке. Если команда кажется зависшей, проверьте журнал шлюза вместо ожидания; отсутствие поступающего запроса означает, что `ANTHROPIC_BASE_URL` не указывает на шлюз.150Неправильный или недостижимый базовый URL производит другой симптом: Claude Code [повторяет попытку подключения с отступом](https://code.claude.com/docs/ru/errors.md#automatic-retries) и может сидеть без вывода в течение нескольких минут перед сообщением об ошибке. Если команда кажется зависшей, проверьте журнал шлюза вместо ожидания; отсутствие поступающего запроса означает, что `ANTHROPIC_BASE_URL` не указывает на шлюз.

247 247

248Вы должны видеть строки `data:`, поступающие постепенно. Весь ответ, поступающий сразу после паузы, означает, что шлюз буферизирует, что замораживает Claude Code; `404` означает, что имя модели не маршрутизируется. Повторите для каждого имени модели.248Вы должны видеть строки `data:`, поступающие постепенно. Весь ответ, поступающий сразу после паузы, означает, что шлюз буферизирует, что замораживает Claude Code; `404` означает, что имя модели не маршрутизируется. Повторите для каждого имени модели.

249 249

250Затем запустите `claude` и отправьте сообщение. Каждый симптом на этом шаге имеет одну причину:250Затем запустите `claude`, отправьте сообщение и сопоставьте то, что видите:

251 251

252* Приглашение входа означает пробел в учетных данных. Запустите `/status` и откройте вкладку **Status**: когда строка `Setting sources` не включает управляемые параметры, распределение не достигло машины; когда она включает, учетные данные разработчика не были доставлены, поэтому установите `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`252* Экран входа или `Not logged in` без новых записей в логе шлюза означает пробел в учётных данных. Запустите `/status` и откройте вкладку **Status**: когда строка `Setting sources` не включает управляемые настройки, распределение не достигло машины; когда включает, учётные данные разработчика не были доставлены, поэтому установите `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`

253* Ошибки `Failed to authenticate` означают, что шлюз отклоняет запросы; его журнал говорит, какие учетные данные не прошли. Отклонение, которое сам журнал шлюза регистрирует, называет ключ разработчика, в то время как `401` от `api.anthropic.com` или конечной точки вашего поставщика означает, что учетные данные поставщика, которые держит шлюз, были отклонены253* `Please run /login · API Error: 401`, `Not logged in` или `Invalid API key` с `401` в логе шлюза: проверьте, кто выдал `401`. Исправьте ключ разработчика или его заголовок, если его выдал шлюз, или учётные данные поставщика, которые держит шлюз, если он пришёл от `api.anthropic.com` или эндпоинта вашего поставщика

254* Одноразовый запрос подтверждения для ключа ожидается при первом использовании, когда шлюз ожидает ключи в заголовке `x-api-key`, установленном как `ANTHROPIC_API_KEY`254* Одноразовый запрос подтверждения для ключа ожидается при первом использовании, когда шлюз ожидает ключи в заголовке `x-api-key`, установленном как `ANTHROPIC_API_KEY`

255 255

256Если ваша организация использует [быстрый режим](https://code.claude.com/docs/ru/fast-mode.md), запустите `/fast` здесь тоже: проверка доступности вызывает `api.anthropic.com` напрямую, а не следует базовому URL шлюза, поэтому сеанс, маршрутизируемый через шлюз, может сообщить быстрый режим как недоступный или отключенный, даже если вывод работает. [Использовать быстрый режим за прокси и LLM шлюзами](https://code.claude.com/docs/ru/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) сопоставляет каждое сообщение с переменной, которая его восстанавливает, распределяемой с [остальной конфигурацией](#distribute-the-configuration).256Если ваша организация использует [быстрый режим](https://code.claude.com/docs/ru/fast-mode.md), запустите `/fast` здесь тоже: проверка доступности вызывает `api.anthropic.com` напрямую, а не следует базовому URL шлюза, поэтому сеанс, маршрутизируемый через шлюз, может сообщить быстрый режим как недоступный или отключенный, даже если вывод работает. [Использовать быстрый режим за прокси и LLM шлюзами](https://code.claude.com/docs/ru/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) сопоставляет каждое сообщение с переменной, которая его восстанавливает, распределяемой с [остальной конфигурацией](#distribute-the-configuration).

microsoft-foundry.md +2 −16

Details

147 147

148## Конфигурация Azure RBAC148## Конфигурация Azure RBAC

149 149

150Роли по умолчанию `Azure AI User` и `Cognitive Services User` включают все необходимые разрешения для вызова моделей Claude.150Если вы проходите аутентификацию с помощью Microsoft Entra ID или выданного им Bearer-токена, назначьте своему удостоверению роль `Foundry User` или `Cognitive Services User` в вашем ресурсе Foundry. Роль `Foundry User` может по-прежнему отображаться под своим прежним названием — `Azure AI User`.

151 151

152Для более ограничительных разрешений создайте пользовательскую роль со следующим содержимым:152Если эти роли не соответствуют вашим потребностям, см. [документацию Microsoft Foundry RBAC](https://learn.microsoft.com/en-us/azure/foundry/concepts/rbac-foundry), чтобы узнать о пользовательских ролях.

~~153~~

154```json theme={null}

155{

156 "permissions": [

157 {

158 "dataActions": [

159 "Microsoft.CognitiveServices/accounts/providers/*"

160 ]

161 }

162 ]

163}

164```

~~165~~

166Для получения дополнительной информации см. [документацию Microsoft Foundry RBAC](https://learn.microsoft.com/en-us/azure/ai-foundry/concepts/rbac-azure-ai-foundry).

167 153

168## Контекстное окно на 1M токенов154## Контекстное окно на 1M токенов

169 155

model-config.md +5 −3

Details

157 157

158Когда активная модель при запуске поступает из настроек проекта или управляемых настроек, а не из вашего собственного выбора, заголовок запуска показывает, какой файл настроек её установил. Запустите `/model` для переопределения; настройка проекта или управляемая настройка переприменяется при следующем запуске. На платформах, которые встраивают Claude Code и устанавливают [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](https://code.claude.com/docs/ru/env-vars), конфигурация модели хоста имеет приоритет над управляемыми настройками модели, в то время как управляемый список разрешённых моделей `availableModels` остаётся в силе, если только хост не предоставляет свой собственный; [Exceptions to managed settings precedence](https://code.claude.com/docs/ru/settings.md#exceptions-to-managed-settings-precedence) говорит, какие ключи и переменные переопределяет хост.158Когда активная модель при запуске поступает из настроек проекта или управляемых настроек, а не из вашего собственного выбора, заголовок запуска показывает, какой файл настроек её установил. Запустите `/model` для переопределения; настройка проекта или управляемая настройка переприменяется при следующем запуске. На платформах, которые встраивают Claude Code и устанавливают [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](https://code.claude.com/docs/ru/env-vars), конфигурация модели хоста имеет приоритет над управляемыми настройками модели, в то время как управляемый список разрешённых моделей `availableModels` остаётся в силе, если только хост не предоставляет свой собственный; [Exceptions to managed settings precedence](https://code.claude.com/docs/ru/settings.md#exceptions-to-managed-settings-precedence) говорит, какие ключи и переменные переопределяет хост.

159 159

160Если вы или ваша организация настроите [хуки PreModelSwitch](https://code.claude.com/docs/ru/hooks.md#premodelswitch), они запускаются перед применением запрошенного переключения и могут его заблокировать или попросить вас подтвердить.160Если вы или ваша организация настроите [хуки PreModelSwitch](https://code.claude.com/docs/ru/hooks.md#premodelswitch), они запускаются перед применением запрошенного переключения и могут его заблокировать или попросить вас подтвердить. Чтобы узнать, почему хук заблокировал переключение и что делать, см. [Model switch was blocked by a PreModelSwitch hook](https://code.claude.com/docs/ru/errors.md#model-switch-was-blocked-by-a-premodelswitch-hook).

161 161

162Когда Claude Code не может определить, какие хуки PreModelSwitch доставляют [управляемые плагины](https://code.claude.com/docs/ru/settings-reference.md#enabledplugins) вашей организации, например потому что управляемый плагин не загрузился, он отказывает в переключении вместо его применения без проверки, и он проверяет снова при каждой новой попытке. См. [Model switch was blocked by a PreModelSwitch hook](https://code.claude.com/docs/ru/errors.md#model-switch-was-blocked-by-a-premodelswitch-hook) для сообщения и восстановления.162Если [управляемый плагин](https://code.claude.com/docs/ru/settings-reference.md#enabledplugins) или его хуки не загрузились, вы всё равно можете переключать модели. Хуки PreModelSwitch этого плагина не запускаются, поэтому переключение, которое один из них заблокировал бы, может пройти. Другие хуки PreModelSwitch, которые загрузились, по-прежнему запускаются и могут его заблокировать. Если Claude Code версии до 2.1.323 отказывает в переключении с сообщением `so organization-managed PreModelSwitch hooks could not be checked`, обновите Claude Code.

163

164Чтобы увидеть, что не загрузилось, запустите `/plugin` в вашей сессии и откройте [вкладку **Errors**](https://code.claude.com/docs/ru/plugins/troubleshooting.md#failed-to-load-hooks-from-and-hooks-that-dont-fire). Если там ничего не указано, запустите новую сессию с помощью `claude --debug` из вашей оболочки и переключитесь на другую модель, затем прочитайте [лог отладки](https://code.claude.com/docs/ru/hooks.md#debug-hooks). После того как вы исправите плагин или [обновление плагина](https://code.claude.com/docs/ru/plugins/install.md#keep-plugins-updated) доставит исправление вашего администратора на ваш компьютер, запустите `/reload-plugins` в вашей сессии, чтобы его хуки заработали.

163 165

164Когда вы переключаете модели через метод [Agent SDK](https://code.claude.com/docs/ru/agent-sdk/overview.md) `setModel()`, через приложение, такое как [Desktop app](https://code.claude.com/docs/ru/desktop.md), или с устройства, подключённого через [Remote Control](https://code.claude.com/docs/ru/remote-control.md), Claude Code проверяет значение при переключении:166Когда вы переключаете модели через метод [Agent SDK](https://code.claude.com/docs/ru/agent-sdk/overview.md) `setModel()`, через приложение, такое как [Desktop app](https://code.claude.com/docs/ru/desktop.md), или с устройства, подключённого через [Remote Control](https://code.claude.com/docs/ru/remote-control.md), Claude Code проверяет значение при переключении:

165 167

903 905

904### Исправление окна для шлюза или пользовательского ID модели906### Исправление окна для шлюза или пользовательского ID модели

905 907

906Любое из этих предупреждений при запуске означает, что Claude Code не распознаёт ID модели вашей сессии, поэтому не может определить контекстное окно модели и предполагает 200K токенов:908Любое из этих предупреждений означает, что Claude Code не распознаёт ID модели вашей сессии, поэтому не может определить контекстное окно модели и предполагает 200K токенов:

907 909

908```text theme={null}910```text theme={null}

909⚠ Model "my-gateway-opus" isn't recognized · context assumed to be 200k tokens · ...911⚠ Model "my-gateway-opus" isn't recognized · context assumed to be 200k tokens · ...

monitoring-usage.md +1 −1

Details

431> * **Пробелы не допускаются**: значения не могут содержать пробелы. Например, `user.organizationName=My Company` недействительно431> * **Пробелы не допускаются**: значения не могут содержать пробелы. Например, `user.organizationName=My Company` недействительно

432> * **Формат**: должны быть пары ключ=значение, разделённые запятыми: `key1=value1,key2=value2`432> * **Формат**: должны быть пары ключ=значение, разделённые запятыми: `key1=value1,key2=value2`

433> * **Допустимые символы**: только символы US-ASCII, исключая управляющие символы, пробелы, двойные кавычки, запятые, точки с запятой и обратные косые черты433> * **Допустимые символы**: только символы US-ASCII, исключая управляющие символы, пробелы, двойные кавычки, запятые, точки с запятой и обратные косые черты

434> * **Специальные символы**: символы вне допустимого диапазона должны быть процентно-кодированы434> * **Специальные символы**: символы вне допустимого диапазона должны быть закодированы процентным кодированием, а `=` внутри значения должен быть записан как `%3D`

435>435>

436> Для значения, которому нужен пробел, используйте подчёркивания или camelCase вместо этого. Следующие примеры устанавливают `org.name` с каждой формой:436> Для значения, которому нужен пробел, используйте подчёркивания или camelCase вместо этого. Следующие примеры устанавливают `org.name` с каждой формой:

437>437>

permission-modes.md +1 −1

Details

304claude --permission-mode plan304claude --permission-mode plan

305```305```

306 306

307Нажмите `Shift+Tab` ещё раз, чтобы выйти из режима планирования, не утверждая план.307Если запрос на утверждение не открыт, нажмите `Shift+Tab` ещё раз, чтобы выйти из режима планирования. В запросе на утверждение сначала нажмите `Esc`, поскольку нажатие `Shift+Tab` там утверждает план.

308 308

309### Просмотр и утверждение плана309### Просмотр и утверждение плана

310 310

plugins/create.md +1 −1

Details

344 "PostToolUse": [344 "PostToolUse": [

345 {345 {

346 "matcher": "Write|Edit",346 "matcher": "Write|Edit",

347 "hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npm run lint:fix" }]347 "hooks": [{ "type": "command", "command": "f=$(jq -r '.tool_input.file_path') && npm run lint:fix -- \"$f\"" }]

348 }348 }

349 ]349 ]

350 }350 }

plugins/mods/test.md +1 −10

Details

196 196

197### Проверьте результат с помощью `expect`197### Проверьте результат с помощью `expect`

198 198

199В наборе есть следующие утверждения, и выбранное вами ставится после проверяемого значения, как в `expect(answer.text).toBe('ok')`:199У `expect` есть собственный набор утверждений, например `toEqual` и `toHaveLength`, которые ставятся после проверяемого значения, как в `expect(answer.text).toBe('ok')`. Полный список можно найти, поискав `type Matchers` в файле `claude-code/index.d.ts` среди [типов для вашей сборки](https://code.claude.com/docs/ru/plugins/mods/create.md#get-the-types-for-your-build). Поставьте `.not` перед утверждением, чтобы проверить обратное. Чтобы проверить, с чем завершается промис, поставьте `.resolves` или `.rejects` сразу после `expect(...)` и используйте `await` для этой строки, как в `await expect(promise).rejects.toThrow()`.

~~200~~

201* **Равенство**: `toBe` для того же значения или объекта, `toEqual` для структуры, `toStrictEqual` для структуры вместе с полями `undefined` и прототипом, и `toMatchObject` для указанных вами полей

202* **Текст**: `toMatch`, который принимает регулярное выражение или подстроку, `toStartWith` и `toEndWith`

203* **Числа**: `toBeGreaterThan`, `toBeGreaterThanOrEqual`, `toBeLessThan`, `toBeLessThanOrEqual`

204* **Содержимое**: `toContain` для подстроки или элемента, `toContainEqual` для элемента, сравниваемого по структуре, `toHaveLength` и `toHaveProperty`

205* **Наличие и тип**: `toBeDefined`, `toBeUndefined`, `toBeNull`, `toBeTruthy`, `toBeFalsy`, `toBeNaN`, `toBeInstanceOf`

206* **Выброс исключений**: `toThrow` — для функции, которую вызывает `expect`, или для промиса, который вы проверяете с помощью `.rejects`

~~207~~

208Поставьте `.not` перед утверждением, чтобы проверить обратное, а `.resolves` или `.rejects` — чтобы проверить, с чем завершается промис.

209 200

210Когда `expect` не выполняется внутри stub или хука, который вы передали в `on` как обычную функцию, а не как асинхронный генератор, тест не проходит. Движок пропускает этот хук, а вывод ошибки называет его, например `in the test's store.set hook`.201Когда `expect` не выполняется внутри stub или хука, который вы передали в `on` как обычную функцию, а не как асинхронный генератор, тест не проходит. Движок пропускает этот хук, а вывод ошибки называет его, например `in the test's store.set hook`.

211 202

remote-control.md +2 −1

Details

67> | `--capacity <N>` | Максимальное количество одновременных сеансов. По умолчанию 32. Не может использоваться с `--spawn=session`. |67> | `--capacity <N>` | Максимальное количество одновременных сеансов. По умолчанию 32. Не может использоваться с `--spawn=session`. |

68> | `--[no-]create-session-in-dir` | Предварительно создайте один сеанс в текущем каталоге при запуске сервера, чтобы у вас было место для ввода сразу. В режиме `worktree` этот сеанс остается в текущем каталоге, а сеансы по требованию получают изолированные worktrees. Включено по умолчанию. Если вы передадите `--no-create-session-in-dir` для запуска без него, Claude Code архивирует сеансы сервера при его остановке, поэтому нечего [возобновлять](#resume-sessions-after-stopping-the-server). |68> | `--[no-]create-session-in-dir` | Предварительно создайте один сеанс в текущем каталоге при запуске сервера, чтобы у вас было место для ввода сразу. В режиме `worktree` этот сеанс остается в текущем каталоге, а сеансы по требованию получают изолированные worktrees. Включено по умолчанию. Если вы передадите `--no-create-session-in-dir` для запуска без него, Claude Code архивирует сеансы сервера при его остановке, поэтому нечего [возобновлять](#resume-sessions-after-stopping-the-server). |

69> | `--permission-mode <mode>` | Установите начальный [режим разрешений](https://code.claude.com/docs/ru/permission-modes.md) для сеансов сервера, например `acceptEdits`. Принимает `manual` как псевдоним для `default`; неузнанный режим останавливает сервер при запуске и выводит список допустимых режимов. |69> | `--permission-mode <mode>` | Установите начальный [режим разрешений](https://code.claude.com/docs/ru/permission-modes.md) для сеансов сервера, например `acceptEdits`. Принимает `manual` как псевдоним для `default`; неузнанный режим останавливает сервер при запуске и выводит список допустимых режимов. |

70> | `--settings <file>` | Применяет JSON-файл настроек к сессиям сервера с тем же [приоритетом](https://code.claude.com/docs/ru/settings.md#settings-precedence), что и `claude --settings`. Укажите путь к файлу, а не JSON-строку. Требуется Claude Code v2.1.321 или новее. |

70> | `--chrome` / `--no-chrome` | Включите или отключите [интеграцию Chrome](https://code.claude.com/docs/ru/chrome.md) в сеансах, которые создает сервер, чтобы Claude мог использовать Chrome на вашей машине, пока вы работаете с другого устройства. Без любого из флагов сеанс, который сервер предварительно создает, и любой сеанс, который вы запускаете сами с claude.ai/code или приложения Claude, начинаются с отключенным Chrome, даже если вы [включили Chrome по умолчанию](https://code.claude.com/docs/ru/chrome.md#enable-chrome-by-default). Сеанс, который сервер запускает для одного из ваших потоков [проекта](https://code.claude.com/docs/ru/claude-projects.md), следует этому параметру вместо этого, за исключением режима `bypassPermissions`. Требуется Claude Code v2.1.273 или позже. |71> | `--chrome` / `--no-chrome` | Включите или отключите [интеграцию Chrome](https://code.claude.com/docs/ru/chrome.md) в сеансах, которые создает сервер, чтобы Claude мог использовать Chrome на вашей машине, пока вы работаете с другого устройства. Без любого из флагов сеанс, который сервер предварительно создает, и любой сеанс, который вы запускаете сами с claude.ai/code или приложения Claude, начинаются с отключенным Chrome, даже если вы [включили Chrome по умолчанию](https://code.claude.com/docs/ru/chrome.md#enable-chrome-by-default). Сеанс, который сервер запускает для одного из ваших потоков [проекта](https://code.claude.com/docs/ru/claude-projects.md), следует этому параметру вместо этого, за исключением режима `bypassPermissions`. Требуется Claude Code v2.1.273 или позже. |

71> | `-d`, `--debug[=<filter>]` | Включите отладочное логирование для сервера, опционально отфильтрованное по категориям. Передайте фильтр только в форме `=`, например `--debug=api,hooks`. Требуется Claude Code v2.1.282 или позже. |72> | `-d`, `--debug[=<filter>]` | Включите отладочное логирование для сервера, опционально отфильтрованное по категориям. Передайте фильтр только в форме `=`, например `--debug=api,hooks`. Требуется Claude Code v2.1.282 или позже. |

72> | `--debug-file <path>` | Запишите отладочные логи в указанный файл. |73> | `--debug-file <path>` | Запишите отладочные логи в указанный файл. |

73> | `--verbose` | Показывайте подробные логи подключения и сеанса. |74> | `--verbose` | Показывайте подробные логи подключения и сеанса. |

74> | `--sandbox`, `--no-sandbox` | Удалены в v2.1.300. Если вы передадите любой из этих флагов, сервер [завершится с ошибкой](https://code.claude.com/docs/ru/errors.md#sandbox-is-not-supported-by-claude-remote-control) вместо запуска. |75> | `--sandbox`, `--no-sandbox` | Удалены в v2.1.300. Если вы передадите любой из этих флагов, сервер [завершится с ошибкой](https://code.claude.com/docs/ru/errors.md#sandbox-is-not-supported-by-claude-remote-control) вместо запуска. |

75>76>

76> Если вы передадите глобальный флаг `claude` перед `remote-control`, или скрипт-обертка добавит его, Claude Code не переносит флаг в сеансы, которые создает сервер. Claude Code пропускает флаг только когда известно, что его удаление не изменит то, что могут делать эти сеансы, например `--verbose` или `--model`. Для любого другого флага, например `--settings`, Claude Code [отказывается запускаться](https://code.claude.com/docs/ru/errors.md#not-carried-over-to-the-sessions-remote-control-starts) и называет флаг для удаления.77> Если вы передадите глобальный флаг `claude` перед `remote-control` или его добавит скрипт-обертка, Claude Code не переносит этот флаг в сессии, которые создает сервер. С некоторыми флагами, например `--verbose` или `--model`, сервер все равно запускается. С любым другим флагом сервер [не запускается](https://code.claude.com/docs/ru/errors.md#not-carried-over-to-the-sessions-remote-control-starts). Чтобы передать файл настроек, укажите `--settings` после `remote-control`.

77>78>

78> Чтобы изолировать сеансы, которые запускает сервер, включите [изоляцию](https://code.claude.com/docs/ru/sandboxing.md) в файле параметров.79> Чтобы изолировать сеансы, которые запускает сервер, включите [изоляцию](https://code.claude.com/docs/ru/sandboxing.md) в файле параметров.

79>80>

routines.md +1 −1

Details

431 431

432Каждая запланированная задача использует [облачное окружение](https://code.claude.com/docs/ru/cloud-environments.md), которое определяет сетевой доступ, переменные окружения и скрипты настройки. Задача наследует сетевую политику окружения при каждом запуске.432Каждая запланированная задача использует [облачное окружение](https://code.claude.com/docs/ru/cloud-environments.md), которое определяет сетевой доступ, переменные окружения и скрипты настройки. Задача наследует сетевую политику окружения при каждом запуске.

433 433

434Окружение **Default** использует доступ **Limited** с установленным флажком **Allow package managers**, поэтому его запуски могут обращаться к доменам из [списка разрешённых доменов по умолчанию](https://code.claude.com/docs/ru/cloud-environments.md#default-allowed-domains). Запрос к заблокированному хосту завершается ошибкой `403` с `x-deny-reason: host_not_allowed`. Трафик MCP-коннекторов идёт через серверы Anthropic, поэтому добавленные в задачу коннекторы работают без добавления их хостов в **Allowed domains**. Удалите ненужные коннекторы, как описано в разделе [Коннекторы](#connectors).434Окружение **Default** использует доступ **Limited** с установленным флажком **Allow package managers**, поэтому его запуски могут обращаться к доменам из [списка разрешённых доменов по умолчанию](https://code.claude.com/docs/ru/cloud-environments.md#default-allowed-domains). Запрос к заблокированному хосту завершается [ошибкой, например `403` или `ENOTFOUND`](https://code.claude.com/docs/ru/errors#host-not-allowed-in-a-cloud-session). Трафик MCP-коннекторов идёт через серверы Anthropic, поэтому добавленные в задачу коннекторы работают без добавления их хостов в **Allowed domains**. Удалите ненужные коннекторы, как описано в разделе [Коннекторы](#connectors).

435 435

436Чтобы разрешить дополнительные домены в одном из ваших собственных окружений, выполните следующие шаги. [Общее окружение организации](https://code.claude.com/docs/ru/cloud-environments.md#organization-shared-environments) открывается здесь только для чтения, поэтому его сетевой доступ изменяет Owner на странице **Cloud environments** в [настройках администратора](https://claude.ai/admin-settings).436Чтобы разрешить дополнительные домены в одном из ваших собственных окружений, выполните следующие шаги. [Общее окружение организации](https://code.claude.com/docs/ru/cloud-environments.md#organization-shared-environments) открывается здесь только для чтения, поэтому его сетевой доступ изменяет Owner на странице **Cloud environments** в [настройках администратора](https://claude.ai/admin-settings).

437 437

sandboxing.md +5 −3

Details

276 276

277Эти пути применяются на уровне ОС, поэтому их соблюдают все команды, выполняемые внутри песочницы, включая их дочерние процессы. Это рекомендуемый подход, когда инструменту нужен доступ на запись к определённому расположению, вместо того чтобы полностью исключать инструмент из песочницы с помощью `excludedCommands`.277Эти пути применяются на уровне ОС, поэтому их соблюдают все команды, выполняемые внутри песочницы, включая их дочерние процессы. Это рекомендуемый подход, когда инструменту нужен доступ на запись к определённому расположению, вместо того чтобы полностью исключать инструмент из песочницы с помощью `excludedCommands`.

278 278

279В Linux и WSL2 запись для пути, который ещё не существует, не действует, поэтому сначала создайте этот путь.

280

279Если вы определяете один и тот же массив файловой системы в нескольких [областях действия настроек](https://code.claude.com/docs/ru/settings.md#settings-precedence), Claude Code объединяет их, собирая пути из всех областей действия, а не заменяя массив одной области действия массивом другой. Claude Code не включает запись в объединение, если на неё распространяется блокировка из раздела [Запрет разработчикам расширять политику](#keep-developers-from-widening-the-policy).281Если вы определяете один и тот же массив файловой системы в нескольких [областях действия настроек](https://code.claude.com/docs/ru/settings.md#settings-precedence), Claude Code объединяет их, собирая пути из всех областей действия, а не заменяя массив одной области действия массивом другой. Claude Code не включает запись в объединение, если на неё распространяется блокировка из раздела [Запрет разработчикам расширять политику](#keep-developers-from-widening-the-policy).

280 282

281Если вы исключаете источник с помощью [`--setting-sources`](https://code.claude.com/docs/ru/cli-reference) в CLI или [`settingSources`](https://code.claude.com/docs/ru/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources) в Agent SDK, Claude Code игнорирует его записи `sandbox.filesystem`, его правила разрешений `Edit` и его запрещающие правила `Read` при построении конфигурации песочницы. Требуется Claude Code v2.1.246 или новее.283Если вы исключаете источник с помощью [`--setting-sources`](https://code.claude.com/docs/ru/cli-reference) в CLI или [`settingSources`](https://code.claude.com/docs/ru/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources) в Agent SDK, Claude Code игнорирует его записи `sandbox.filesystem`, его правила разрешений `Edit` и его запрещающие правила `Read` при построении конфигурации песочницы. Требуется Claude Code v2.1.246 или новее.

376 378

377Поскольку отключение изоляции файловой системы расширяет возможности команд в песочнице, Claude Code учитывает `filesystem.disabled` только из следующих источников настроек:379Поскольку отключение изоляции файловой системы расширяет возможности команд в песочнице, Claude Code учитывает `filesystem.disabled` только из следующих источников настроек:

378 380

379* Пользовательские настройки, управляемые настройки и флаг CLI `--settings` могут её задавать. Настройки проекта в `.claude/settings.json` и `.claude/settings.local.json` не могут, поэтому извлечённый проект не может отключить изоляцию файловой системы.381* Пользовательские настройки, управляемые настройки и флаг CLI `--settings` могут её задавать. Настройки проекта в `.claude/settings.json` и `.claude/settings.local.json` не могут её задавать.

380* Если управляемые настройки вообще настраивают `sandbox.filesystem` или содержат какую-либо запись `sandbox.credentials.files` с `"mode": "deny"`, задать этот ключ могут только управляемые настройки. Это не позволяет разработчикам отключить изоляцию файловой системы в таком развёртывании; чтобы отключить её для всех, задайте `"disabled": true` в управляемых настройках.382* Если управляемые настройки вообще настраивают `sandbox.filesystem` или содержат какую-либо запись `sandbox.credentials.files` с `"mode": "deny"`, задать этот ключ могут только управляемые настройки. Чтобы отключить изоляцию файловой системы для всех, задайте `"disabled": true` в управляемых настройках.

381* Если задана [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](https://code.claude.com/docs/ru/env-vars), Claude Code игнорирует `filesystem.disabled` из любого источника, включая управляемые настройки, и оставляет изоляцию файловой системы включённой.383* Если задана [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](https://code.claude.com/docs/ru/env-vars), Claude Code игнорирует `filesystem.disabled` из любого источника, включая управляемые настройки.

382 384

383[Допустимая](https://code.claude.com/docs/ru/settings-reference.md#invalid-credential-entries-in-managed-settings) запись `mask` не закрепляет этот ключ, даже если Claude Code [переключается для неё на `deny`](#mask-credential-files) при запуске. Путь, который нельзя замаскировать, например каталог с учётными данными, укажите в управляемых настройках как явную запись `deny`, которая закрепляет ключ.385[Допустимая](https://code.claude.com/docs/ru/settings-reference.md#invalid-credential-entries-in-managed-settings) запись `mask` не закрепляет этот ключ, даже если Claude Code [переключается для неё на `deny`](#mask-credential-files) при запуске. Путь, который нельзя замаскировать, например каталог с учётными данными, укажите в управляемых настройках как явную запись `deny`, которая закрепляет ключ.

384 386

settings.md +1 −1

Details

177 177

178Claude Code отслеживает ваши файлы параметров и перезагружает их при изменении, поэтому он применяет большинство изменений к работающему сеансу без перезагрузки, включая изменения `permissions`, `hooks` и помощников учетных данных, таких как `apiKeyHelper`. Claude Code также загружает файл параметров, который вы создаете в середине сеанса, если его папка существовала при запуске сеанса. Для папки `.claude/` проекта он загружает файл даже когда вы создаете папку в том же сеансе.178Claude Code отслеживает ваши файлы параметров и перезагружает их при изменении, поэтому он применяет большинство изменений к работающему сеансу без перезагрузки, включая изменения `permissions`, `hooks` и помощников учетных данных, таких как `apiKeyHelper`. Claude Code также загружает файл параметров, который вы создаете в середине сеанса, если его папка существовала при запуске сеанса. Для папки `.claude/` проекта он загружает файл даже когда вы создаете папку в том же сеансе.

179 179

180Перезагрузка охватывает параметры пользователя, проекта, локальные и управляемые параметры, и Claude Code запускает hook [`ConfigChange`](https://code.claude.com/docs/ru/hooks#configchange) для каждого изменения файла параметров, которое он обнаруживает, не для управляемых параметров, которые поступают из MDM или консоли claude.ai. Управляемые параметры, которые поступают через MDM или из консоли claude.ai, достигают работающего сеанса по расписанию, а не при сохранении; [таблица доставки](https://code.claude.com/docs/ru/managed-settings.md#choose-a-delivery-mechanism) дает это для каждого источника.180Перезагрузка охватывает пользовательские, проектные, локальные и управляемые настройки. Claude Code запускает [хук `ConfigChange`](https://code.claude.com/docs/ru/hooks#configchange) при непосредственном редактировании файлов настроек, но не для управляемых настроек, поступающих из MDM или консоли claude.ai. Управляемые настройки, поступающие через MDM или из консоли claude.ai, доходят до работающей сессии по расписанию, а не при сохранении; [таблица способов доставки](https://code.claude.com/docs/ru/managed-settings.md#choose-a-delivery-mechanism) приводит его для каждого источника.

181 181

182Claude Code читает некоторые ключи только один раз при запуске сеанса, поэтому изменение одного из них не достигает работающего сеанса. Ключи на стороне администратора, которые также ждут перезагрузки, такие как `requiredMinimumVersion`, перечислены в [где и когда применяется политика](https://code.claude.com/docs/ru/managed-settings.md#where-and-when-a-policy-applies). Те, которые вы, скорее всего, будете редактировать в середине сеанса:182Claude Code читает некоторые ключи только один раз при запуске сеанса, поэтому изменение одного из них не достигает работающего сеанса. Ключи на стороне администратора, которые также ждут перезагрузки, такие как `requiredMinimumVersion`, перечислены в [где и когда применяется политика](https://code.claude.com/docs/ru/managed-settings.md#where-and-when-a-policy-applies). Те, которые вы, скорее всего, будете редактировать в середине сеанса:

183 183

settings-reference.md +2 −0

Details

1533}1533}

1534```1534```

1535 1535

1536В Linux и WSL2 запись для пути, который ещё не существует, не действует, поэтому сначала создайте путь.

1537

1536Claude Code объединяет записи `allowWrite` и пути из ваших правил разрешений `Edit(...)` allow во всех областях действия настроек, которые загружает сессия, исключая записи из настроек репозитория, пока включён [`permissions.blockReadsOutsideWorkingDirectories`](#sandboxed-commands-under-the-block). [Блокировки репозитория](https://code.claude.com/docs/ru/sandboxing.md#repository-settings-under-an-admin-required-sandbox) тоже могут исключать записи репозитория. Запись `allowWrite` не может снять защиту с [protected path](https://code.claude.com/docs/ru/sandboxing.md#protected-paths).1538Claude Code объединяет записи `allowWrite` и пути из ваших правил разрешений `Edit(...)` allow во всех областях действия настроек, которые загружает сессия, исключая записи из настроек репозитория, пока включён [`permissions.blockReadsOutsideWorkingDirectories`](#sandboxed-commands-under-the-block). [Блокировки репозитория](https://code.claude.com/docs/ru/sandboxing.md#repository-settings-under-an-admin-required-sandbox) тоже могут исключать записи репозитория. Запись `allowWrite` не может снять защиту с [protected path](https://code.claude.com/docs/ru/sandboxing.md#protected-paths).

1537 1539

1538### `sandbox.filesystem.denyWrite`1540### `sandbox.filesystem.denyWrite`

setup.md +8 −26

Details

40>40>

41> **macOS, Linux, WSL:**41> **macOS, Linux, WSL:**

42>42>

~~43> ```bash theme={null}~~43> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

44> curl -fsSL https://claude.ai/install.sh | bash44> curl -fsSL https://claude.ai/install.sh | bash

45> ```45> ```

46>46>

48>48>

49> **Windows PowerShell:**49> **Windows PowerShell:**

50>50>

~~51> ```powershell theme={null}~~51> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

52> irm https://claude.ai/install.ps1 | iex52> irm https://claude.ai/install.ps1 | iex

53> ```53> ```

54>54>

55> **Windows CMD:**55> **Windows CMD:**

56>56>

~~57> ```batch theme={null}~~57> ```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

58> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd58> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

59> ```59> ```

60>60>

72 72

73> [tab] Homebrew73> [tab] Homebrew

74>74>

~~75> ```bash theme={null}~~75> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

76> brew install --cask claude-code76> brew install --cask claude-code

77> ```77> ```

78>78>

84 84

85> [tab] WinGet85> [tab] WinGet

86>86>

~~87> ```powershell theme={null}~~87> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

88> winget install Anthropic.ClaudeCode88> winget install Anthropic.ClaudeCode

89> ```89> ```

90>90>

141 141

142### Alpine Linux и дистрибутивы на основе musl142### Alpine Linux и дистрибутивы на основе musl

143 143

144Установка Claude Code на Alpine и других дистрибутивах на основе musl/uClibc требует `bash` и `curl` для команды установки, а также `libgcc`, `libstdc++` и `ripgrep` во время выполнения. Alpine не включает `bash` или `curl` по умолчанию, поэтому документированная команда установки не работает с ошибкой `not found`, пока вы их не установите. Установите эти пакеты с помощью менеджера пакетов вашего дистрибутива, затем установите `USE_BUILTIN_RIPGREP=0`.144На Alpine и других дистрибутивах на основе musl [команда установки](#install-claude-code) требует `bash` и `curl`, а самому Claude Code требуется `bash` или `zsh`. Alpine не включает `bash` или `curl` по умолчанию, поэтому документированная команда установки завершается ошибкой `not found`, пока вы их не установите.

145 145

146Этот пример устанавливает необходимые пакеты на Alpine:146Этот пример устанавливает необходимые пакеты на Alpine:

147 147

148```bash theme={null}148```bash theme={null}

149apk add bash curl libgcc libstdc++ ripgrep149apk add bash curl

150```

~~151~~

152На Alpine `ripgrep` находится в репозитории community. Если `apk` сообщает, что пакет отсутствует, добавьте репозиторий community в `/etc/apk/repositories`, используя вашу версию Alpine:

~~153~~

154```bash theme={null}

155echo "https://dl-cdn.alpinelinux.org/alpine/v3.22/community" >> /etc/apk/repositories

156```

~~157~~

158Выполните `apk update`, чтобы обновить индекс пакетов, и повторите команду `apk add`.

~~159~~

160Затем установите `USE_BUILTIN_RIPGREP` на `0` в вашем файле [`settings.json`](https://code.claude.com/docs/ru/settings-reference#all-settings):

~~161~~

162```json theme={null}

163{

164 "env": {

165 "USE_BUILTIN_RIPGREP": "0"

166 }

167}

168```150```

169 151

170## Проверка установки152## Проверка установки

443> wget -O /etc/apk/keys/claude-code.rsa.pub \425> wget -O /etc/apk/keys/claude-code.rsa.pub \

444> https://downloads.claude.ai/keys/claude-code.rsa.pub426> https://downloads.claude.ai/keys/claude-code.rsa.pub

445> echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories427> echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories

446> apk add claude-code428> apk add bash claude-code

447> ```429> ```

448>430>

449> Чтобы переключиться на канал `latest`, удалите строку репозитория `stable` и добавьте репозиторий `latest`:431> Чтобы переключиться на канал `latest`, удалите строку репозитория `stable` и добавьте репозиторий `latest`:

terminal-config.md +1 −1

Details

26 26

27| Терминал | Shift+Enter для новой строки |27| Терминал | Shift+Enter для новой строки |

28| :- | :- |28| :- | :- |

~~29| Ghostty, Kitty, iTerm2, WezTerm, Warp, Apple Terminal, Windows Terminal | Работает без настройки |~~29| Ghostty, Kitty, iTerm2, WezTerm, Warp, Windows Terminal | Работает без настройки |

30| Другие терминалы, поддерживающие протокол клавиатуры kitty, такие как foot и Alacritty 0.16 или позже | Работает без настройки. Требуется Claude Code v2.1.269 или позже |30| Другие терминалы, поддерживающие протокол клавиатуры kitty, такие как foot и Alacritty 0.16 или позже | Работает без настройки. Требуется Claude Code v2.1.269 или позже |

31| VS Code, Cursor, Devin Desktop, Alacritty до версии 0.16, Zed | Запустите `/terminal-setup` один раз |31| VS Code, Cursor, Devin Desktop, Alacritty до версии 0.16, Zed | Запустите `/terminal-setup` один раз |

32| gnome-terminal, JetBrains IDEs такие как PyCharm и Android Studio | Недоступно; используйте Ctrl+J или `\` затем Enter |32| gnome-terminal, JetBrains IDEs такие как PyCharm и Android Studio | Недоступно; используйте Ctrl+J или `\` затем Enter |

tools-reference.md +1 −3

Details

127 127

128Claude использует `AskUserQuestion` для задания вам вопросов с несколькими вариантами ответов, когда ему требуется решение или уточнение. Ответьте, выбрав вариант, или введите свой текст через строку `Other` или поле примечаний.128Claude использует `AskUserQuestion` для задания вам вопросов с несколькими вариантами ответов, когда ему требуется решение или уточнение. Ответьте, выбрав вариант, или введите свой текст через строку `Other` или поле примечаний.

129 129

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

~~131~~

132### Таймаут автоматического продолжения вопроса130### Таймаут автоматического продолжения вопроса

133 131

134Вопросы остаются открытыми до тех пор, пока вы на них не ответите. Если вы хотите, чтобы оставленный без ответа вопрос в конечном итоге закрылся и позволил Claude продолжить без вас, установите параметр [`askUserQuestionTimeout`](https://code.claude.com/docs/ru/settings-reference#askuserquestiontimeout) на `60s`, `5m` или `10m` либо в вашем пользовательском файле `settings.json`, либо из строки **Question auto-continue timeout** в `/config`.132Вопросы остаются открытыми до тех пор, пока вы на них не ответите. Если вы хотите, чтобы оставленный без ответа вопрос в конечном итоге закрылся и позволил Claude продолжить без вас, установите параметр [`askUserQuestionTimeout`](https://code.claude.com/docs/ru/settings-reference#askuserquestiontimeout) на `60s`, `5m` или `10m` либо в вашем пользовательском файле `settings.json`, либо из строки **Question auto-continue timeout** в `/config`.

525 523

526## Поведение инструмента Read524## Поведение инструмента Read

527 525

528Инструмент Read принимает путь к файлу и возвращает его содержимое с номерами строк. Claude инструктирован всегда передавать абсолютные пути.526Инструмент Read принимает путь к файлу и возвращает его содержимое с номерами строк.

529 527

530Чтение пустого файла возвращает уведомление о том, что файл существует, но его содержимое пусто, а `offset` за последней строкой возвращает уведомление, дающее количество строк файла.528Чтение пустого файла возвращает уведомление о том, что файл существует, но его содержимое пусто, а `offset` за последней строкой возвращает уведомление, дающее количество строк файла.

531 529

troubleshoot-install.md +4 −10

Details

388> Get-Command claude | Select-Object Source388> Get-Command claude | Select-Object Source

389> ```389> ```

390 390

391На Linux проверьте отсутствующие общие библиотеки. Если `ldd` показывает отсутствующие библиотеки, вам может потребоваться установить системные пакеты. На Alpine Linux и других дистрибутивах на основе musl см. [Alpine Linux setup](https://code.claude.com/docs/ru/setup.md#alpine-linux-and-musl-based-distributions).391На Linux проверьте отсутствующие общие библиотеки. Если `ldd` показывает отсутствующие библиотеки, вам может потребоваться установить системные пакеты. На Alpine Linux и других дистрибутивах на основе musl см. [Несоответствие бинарного файла Linux musl или glibc](#linux-musl-or-glibc-binary-mismatch).

392 392

393```bash theme={null}393```bash theme={null}

394ldd "$(command -v claude)" | grep "not found"394ldd "$(command -v claude)" | grep "not found"

906 906

907### Linux musl or glibc binary mismatch907### Linux musl or glibc binary mismatch

908 908

909Если вы видите ошибки об отсутствующих общих библиотеках вроде `libstdc++.so.6` или `libgcc_s.so.1` после установки, установщик мог загрузить неправильный вариант бинарного файла для вашей системы.909Если вы видите ошибки об отсутствующих общих библиотеках вроде `ld-linux-x86-64.so.2` или `ld-linux-aarch64.so.1` после установки, установщик мог загрузить неправильный вариант бинарного файла для вашей системы.

910 910

911```text theme={null}911```text theme={null}

912Error loading shared library libstdc++.so.6: No such file or directory912Error loading shared library ld-linux-x86-64.so.2: No such file or directory

913```913```

914 914

915Это может произойти на системах на основе glibc, в которых установлены пакеты кросс-компиляции musl, из-за чего установщик ошибочно определяет систему как musl.

~~916~~

917**Решения:**915**Решения:**

918 916

9191. **Проверьте, какой libc использует ваша система**:9171. **Проверьте, какой libc использует ваша система**:

924 922

9252. **Если вы на glibc, но получили бинарный файл musl**, удалите установку и переустановите. Вы также можете вручную загрузить правильный бинарный файл, используя манифест в `https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.json`. Создайте [GitHub issue](https://github.com/anthropics/claude-code/issues) с выводом `ldd --version` и `ls /lib/libc.musl*`.9232. **Если вы на glibc, но получили бинарный файл musl**, удалите установку и переустановите. Вы также можете вручную загрузить правильный бинарный файл, используя манифест в `https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.json`. Создайте [GitHub issue](https://github.com/anthropics/claude-code/issues) с выводом `ldd --version` и `ls /lib/libc.musl*`.

926 924

9273. **Если вы действительно на musl**, например Alpine Linux, установите требуемые пакеты:9253. **Если вы на musl, но получили бинарный файл glibc**, [удалите установку](https://code.claude.com/docs/ru/setup.md#uninstall-claude-code). На Alpine Linux сначала установите пакеты, перечисленные в разделе [Alpine Linux setup](https://code.claude.com/docs/ru/setup.md#alpine-linux-and-musl-based-distributions). Затем выполните [команду установки](https://code.claude.com/docs/ru/setup.md#install-claude-code), которая установит бинарный файл musl.

928 ```bash theme={null}

929 apk add libgcc libstdc++ ripgrep

930 ```

931 На Alpine `ripgrep` находится в репозитории community. Если `apk` сообщает, что пакет отсутствует, см. [Alpine Linux setup](https://code.claude.com/docs/ru/setup.md#alpine-linux-and-musl-based-distributions).

932 926

933### `Illegal instruction`927### `Illegal instruction`

934 928

troubleshooting.md +1 −1

Details

152> apk add ripgrep152> apk add ripgrep

153> ```153> ```

154>154>

155> `ripgrep` находится в репозитории community Alpine. Если `apk` сообщает, что пакет отсутствует, смотрите [Alpine Linux setup](https://code.claude.com/docs/ru/setup.md#alpine-linux-and-musl-based-distributions).155> `ripgrep` находится в репозитории community Alpine.

156 156

157> [tab] Arch157> [tab] Arch

158>158>

workflows.md +0 −2

Details

75| :- | :- |75| :- | :- |

76| `/deep-research <question>` | Распределяет веб-поиски по вопросу по нескольким углам, получает и перекрёстно проверяет найденные источники, голосует по каждому утверждению и возвращает цитируемый отчёт с утверждениями, которые не пережили перекрёстную проверку, отфильтрованными. Требует, чтобы инструмент [WebSearch](https://code.claude.com/docs/ru/tools-reference.md#websearch-tool-behavior) был доступен |76| `/deep-research <question>` | Распределяет веб-поиски по вопросу по нескольким углам, получает и перекрёстно проверяет найденные источники, голосует по каждому утверждению и возвращает цитируемый отчёт с утверждениями, которые не пережили перекрёстную проверку, отфильтрованными. Требует, чтобы инструмент [WebSearch](https://code.claude.com/docs/ru/tools-reference.md#websearch-tool-behavior) был доступен |

77 77

~~78`/deep-research` запускается только при его вызове.~~

80[Workflows, которые вы сохраняете](#save-the-workflow-for-reuse) сами, становятся командами таким же образом и появляются в автодополнении `/` рядом с встроенными.78[Workflows, которые вы сохраняете](#save-the-workflow-for-reuse) сами, становятся командами таким же образом и появляются в автодополнении `/` рядом с встроенными.

81 79

82### Смотреть запуск80### Смотреть запуск

Documentation 2026-11-12 23:02 UTC to 2026-11-13 02:58 UTC