SpyBara
Go Premium

Documentation 2026-05-17 01:01 UTC to 2026-05-18 23:59 UTC

34 files changed +358 −167. View all changes and history on the product overview
2026
Sun 31 06:39 Sat 30 06:23 Fri 29 06:38 Thu 28 06:37 Wed 27 06:42 Tue 26 06:33 Sun 24 06:25 Sat 23 06:18 Fri 22 06:33 Thu 21 06:36 Wed 20 06:35 Tue 19 06:34 Mon 18 23:59 Sun 17 01:01 Fri 15 22:58 Thu 14 17:02 Wed 13 23:01 Tue 12 22:57 Mon 11 23:00 Sun 10 23:03 Sat 9 04:57 Fri 8 22:00 Thu 7 22:59 Tue 5 23:00 Mon 4 22:58 Sat 2 18:14 Fri 1 18:19
Details

111SDK включает те же инструменты, которые питают Claude Code:111SDK включает те же инструменты, которые питают Claude Code:

112 112 

113| Категория | Инструменты | Что они делают |113| Категория | Инструменты | Что они делают |

114| :--------------------- | :----------------------------------------------- | :---------------------------------------------------------------------------------------------- |114| :--------------------- | :-------------------------------------------------------------- | :---------------------------------------------------------------------------------------------- |

115| **Операции с файлами** | `Read`, `Edit`, `Write` | Читать, изменять и создавать файлы |115| **Операции с файлами** | `Read`, `Edit`, `Write` | Читать, изменять и создавать файлы |

116| **Поиск** | `Glob`, `Grep` | Найти файлы по шаблону, искать содержимое с помощью regex |116| **Поиск** | `Glob`, `Grep` | Найти файлы по шаблону, искать содержимое с помощью regex |

117| **Выполнение** | `Bash` | Запускать команды оболочки, скрипты, операции git |117| **Выполнение** | `Bash` | Запускать команды оболочки, скрипты, операции git |

118| **Веб** | `WebSearch`, `WebFetch` | Искать в веб, получать и анализировать страницы |118| **Веб** | `WebSearch`, `WebFetch` | Искать в веб, получать и анализировать страницы |

119| **Обнаружение** | `ToolSearch` | Динамически находить и загружать инструменты по требованию вместо предварительной загрузки всех |119| **Обнаружение** | `ToolSearch` | Динамически находить и загружать инструменты по требованию вместо предварительной загрузки всех |

120| **Оркестрация** | `Agent`, `Skill`, `AskUserQuestion`, `TodoWrite` | Порождать подагентов, вызывать skills, спрашивать пользователя, отслеживать задачи |120| **Оркестрация** | `Agent`, `Skill`, `AskUserQuestion`, `TaskCreate`, `TaskUpdate` | Порождать подагентов, вызывать skills, спрашивать пользователя, отслеживать задачи |

121 121 

122Помимо встроенных инструментов, вы можете:122Помимо встроенных инструментов, вы можете:

123 123 


204Вот как каждый компонент влияет на контекст в SDK:204Вот как каждый компонент влияет на контекст в SDK:

205 205 

206| Источник | Когда он загружается | Влияние |206| Источник | Когда он загружается | Влияние |

207| :--------------------------- | :-------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |207| :--------------------------- | :-------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

208| **Системный запрос** | Каждый запрос | Небольшая фиксированная стоимость, всегда присутствует |208| **Системный запрос** | Каждый запрос | Небольшая фиксированная стоимость, всегда присутствует |

209| **CLAUDE.md файлы** | Начало сессии, через [`settingSources`](/ru/agent-sdk/claude-code-features) | Полное содержимое в каждом запросе (но кэшировано в запросе, поэтому только первый запрос платит полную стоимость) |209| **CLAUDE.md файлы** | Начало сессии, через [`settingSources`](/ru/agent-sdk/claude-code-features) | Полное содержимое в каждом запросе (но кэшировано в запросе, поэтому только первый запрос платит полную стоимость) |

210| **Определения инструментов** | Каждый запрос | Каждый инструмент добавляет свою схему; используйте [поиск инструментов MCP](/ru/agent-sdk/mcp#mcp-tool-search) для загрузки инструментов по требованию вместо всех сразу |210| **Определения инструментов** | Каждый запрос; схемы MCP отложены по умолчанию | Встроенные схемы инструментов загружаются в каждом запросе. [Поиск инструментов](/ru/agent-sdk/mcp#mcp-tool-search) отложит схемы инструментов MCP по умолчанию, возвращаясь к предварительной загрузке на Vertex AI или при использовании не первой стороной `ANTHROPIC_BASE_URL`. См. [Настройка поиска инструментов](/ru/agent-sdk/tool-search#configure-tool-search) для полной матрицы |

211| **История разговора** | Накапливается на протяжении ходов | Растет с каждым ходом: запросы, ответы, входные данные инструментов, выходные данные инструментов |211| **История разговора** | Накапливается на протяжении ходов | Растет с каждым ходом: запросы, ответы, входные данные инструментов, выходные данные инструментов |

212| **Описания skills** | Начало сессии, через источники настроек | Короткие резюме; полное содержимое загружается только при вызове |212| **Описания skills** | Начало сессии, через источники настроек | Короткие резюме; полное содержимое загружается только при вызове |

213 213 


244Несколько стратегий для долгоживущих агентов:244Несколько стратегий для долгоживущих агентов:

245 245 

246* **Используйте подагентов для подзадач.** Каждый подагент начинает со свежего разговора (без предыдущей истории сообщений, хотя он загружает свой собственный системный запрос и контекст уровня проекта, такой как CLAUDE.md). Он не видит ходы родителя, и только его финальный ответ возвращается родителю как результат инструмента. Контекст основного агента растет на эту резюме, а не на полную транскрипцию подзадачи. См. [Что наследуют подагенты](/ru/agent-sdk/subagents#what-subagents-inherit) для деталей.246* **Используйте подагентов для подзадач.** Каждый подагент начинает со свежего разговора (без предыдущей истории сообщений, хотя он загружает свой собственный системный запрос и контекст уровня проекта, такой как CLAUDE.md). Он не видит ходы родителя, и только его финальный ответ возвращается родителю как результат инструмента. Контекст основного агента растет на эту резюме, а не на полную транскрипцию подзадачи. См. [Что наследуют подагенты](/ru/agent-sdk/subagents#what-subagents-inherit) для деталей.

247* **Будьте избирательны с инструментами.** Каждое определение инструмента занимает место контекста. Используйте поле `tools` на [`AgentDefinition`](/ru/agent-sdk/subagents#agentdefinition-configuration) для ограничения подагентов минимальным набором, который им нужен, и используйте [поиск инструментов MCP](/ru/agent-sdk/mcp#mcp-tool-search) для загрузки инструментов по требованию вместо предварительной загрузки всех.247* **Будьте избирательны с инструментами.** Каждое определение инструмента занимает место контекста. Используйте поле `tools` на [`AgentDefinition`](/ru/agent-sdk/subagents#agentdefinition-configuration) для ограничения подагентов минимальным набором, который им нужен.

248* **Следите за стоимостью MCP сервера.** Каждый MCP сервер добавляет все свои схемы инструментов в каждый запрос. Несколько серверов с множеством инструментов могут потребить значительный контекст перед тем, как агент выполнит какую-либо работу. Инструмент `ToolSearch` может помочь, загружая инструменты по требованию вместо предварительной загрузки всех. См. [поиск инструментов MCP](/ru/agent-sdk/mcp#mcp-tool-search) для конфигурации.248* **Следите за стоимостью MCP сервера.** [Поиск инструментов MCP](/ru/agent-sdk/mcp#mcp-tool-search) отложит схемы инструментов MCP по умолчанию и загружает их по требованию. Когда поиск инструментов отключен, на Vertex AI или за не первой стороной `ANTHROPIC_BASE_URL`, каждый MCP сервер добавляет все свои схемы инструментов в каждый запрос, поэтому несколько серверов с множеством инструментов могут потребить значительный контекст перед тем, как агент выполнит какую-либо работу.

249* **Используйте более низкие усилия для обычных задач.** Установите [effort](#effort-level) на `"low"` для агентов, которым нужно только читать файлы или список каталогов. Это снижает использование токенов и стоимость.249* **Используйте более низкие усилия для обычных задач.** Установите [effort](#effort-level) на `"low"` для агентов, которым нужно только читать файлы или список каталогов. Это снижает использование токенов и стоимость.

250 250 

251Для подробного разбора стоимости контекста для каждой функции см. [Понять стоимость контекста](/ru/features-overview#understand-context-costs).251Для подробного разбора стоимости контекста для каждой функции см. [Понять стоимость контекста](/ru/features-overview#understand-context-costs).

Details

19### Быстрое сравнение19### Быстрое сравнение

20 20 

21| Функция | `query()` | `ClaudeSDKClient` |21| Функция | `query()` | `ClaudeSDKClient` |

22| :------------------------------- | :----------------------------- | :-------------------------------------- |22| :------------------------------- | :------------------------------------------------ | :-------------------------------------- |

23| **Сеанс** | Создает новый сеанс каждый раз | Повторно использует один и тот же сеанс |23| **Сеанс** | Создает новый сеанс по умолчанию | Повторно использует один и тот же сеанс |

24| **Разговор** | Один обмен | Несколько обменов в одном контексте |24| **Разговор** | Один обмен | Несколько обменов в одном контексте |

25| **Соединение** | Управляется автоматически | Ручное управление |25| **Соединение** | Управляется автоматически | Ручное управление |

26| **Потоковый ввод** | ✅ Поддерживается | ✅ Поддерживается |26| **Потоковый ввод** | ✅ Поддерживается | ✅ Поддерживается |

27| **Прерывания** | ❌ Не поддерживается | ✅ Поддерживается |27| **Прерывания** | ❌ Не поддерживается | ✅ Поддерживается |

28| **Hooks** | ✅ Поддерживается | ✅ Поддерживается |28| **Hooks** | ✅ Поддерживается | ✅ Поддерживается |

29| **Пользовательские инструменты** | ✅ Поддерживается | ✅ Поддерживается |29| **Пользовательские инструменты** | ✅ Поддерживается | ✅ Поддерживается |

30| **Продолжить чат** | Новый сеанс каждый раз | ✅ Сохраняет разговор |30| **Продолжить чат** | Ручное через `continue_conversation` или `resume` | ✅ Автоматическое |

31| **Вариант использования** | Одноразовые задачи | Непрерывные разговоры |31| **Вариант использования** | Одноразовые задачи | Непрерывные разговоры |

32 32 

33### Когда использовать `query()` (новый сеанс каждый раз)33### Когда использовать `query()` (одноразовые задачи)

34 34 

35**Лучше всего для:**35**Лучше всего для:**

36 36 


53 53 

54### `query()`54### `query()`

55 55 

56Создает новый сеанс для каждого взаимодействия с Claude Code. Возвращает асинхронный итератор, который выдает сообщения по мере их поступления. Каждый вызов `query()` начинается с нуля без памяти о предыдущих взаимодействиях.56Создает новый сеанс для каждого взаимодействия с Claude Code по умолчанию. Возвращает асинхронный итератор, который выдает сообщения по мере их поступления. Каждый вызов `query()` начинается с нуля без памяти о предыдущих взаимодействиях, если вы не передадите `continue_conversation=True` или `resume` в [`ClaudeAgentOptions`](#claudeagentoptions). См. [Sessions](/ru/agent-sdk/sessions).

57 57 

58```python theme={null}58```python theme={null}

59async def query(59async def query(


790 plugins: list[SdkPluginConfig] = field(default_factory=list)790 plugins: list[SdkPluginConfig] = field(default_factory=list)

791 max_thinking_tokens: int | None = None # Deprecated: use thinking instead791 max_thinking_tokens: int | None = None # Deprecated: use thinking instead

792 thinking: ThinkingConfig | None = None792 thinking: ThinkingConfig | None = None

793 effort: Literal["low", "medium", "high", "xhigh", "max"] | None = None793 effort: EffortLevel | None = None

794 enable_file_checkpointing: bool = False794 enable_file_checkpointing: bool = False

795 session_store: SessionStore | None = None795 session_store: SessionStore | None = None

796 session_store_flush: SessionStoreFlushMode = "batched"796 session_store_flush: SessionStoreFlushMode = "batched"


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

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

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

840| `effort` | `Literal["low", "medium", "high", "xhigh", "max"] \| None` | `None` | Уровень усилий для глубины мышления |840| `effort` | [`EffortLevel`](#effortlevel) ` \| None` | `None` | Уровень усилий для глубины мышления |

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

842| `session_store_flush` | `Literal["batched", "eager"]` | `"batched"` | Когда сбрасывать записи зеркальной стенограммы в `session_store`. `"batched"` сбрасывает один раз за ход или когда буфер заполняется; `"eager"` запускает фоновый сброс после каждого кадра. Игнорируется, когда `session_store` равен `None` |842| `session_store_flush` | `Literal["batched", "eager"]` | `"batched"` | Когда сбрасывать записи зеркальной стенограммы в `session_store`. `"batched"` сбрасывает один раз за ход или когда буфер заполняется; `"eager"` запускает фоновый сброс после каждого кадра. Игнорируется, когда `session_store` равен `None` |

843 843 


1039 initialPrompt: str | None = None1039 initialPrompt: str | None = None

1040 maxTurns: int | None = None1040 maxTurns: int | None = None

1041 background: bool | None = None1041 background: bool | None = None

1042 effort: Literal["low", "medium", "high", "xhigh", "max"] | int | None = None1042 effort: EffortLevel | int | None = None

1043 permissionMode: PermissionMode | None = None1043 permissionMode: PermissionMode | None = None

1044```1044```

1045 1045 


1056| `initialPrompt` | Нет | Автоматически отправляется как первый ход пользователя, когда этот агент работает как основной агент потока |1056| `initialPrompt` | Нет | Автоматически отправляется как первый ход пользователя, когда этот агент работает как основной агент потока |

1057| `maxTurns` | Нет | Максимальное количество агентских ходов перед остановкой агента |1057| `maxTurns` | Нет | Максимальное количество агентских ходов перед остановкой агента |

1058| `background` | Нет | Запустите этого агента как неблокирующую фоновую задачу при вызове |1058| `background` | Нет | Запустите этого агента как неблокирующую фоновую задачу при вызове |

1059| `effort` | Нет | Уровень усилий рассуждения для этого агента. Принимает именованный уровень или целое число |1059| `effort` | Нет | Уровень усилий рассуждения для этого агента. Принимает именованный уровень или целое число. См. [`EffortLevel`](#effortlevel) |

1060| `permissionMode` | Нет | Режим разрешений для выполнения инструментов в этом агенте. См. [`PermissionMode`](#permissionmode) |1060| `permissionMode` | Нет | Режим разрешений для выполнения инструментов в этом агенте. См. [`PermissionMode`](#permissionmode) |

1061 1061 

1062<Note>1062<Note>


1077]1077]

1078```1078```

1079 1079 

1080### `EffortLevel`

1081 

1082Уровни усилий для руководства глубиной мышления.

1083 

1084```python theme={null}

1085EffortLevel = Literal[

1086 "low", # Minimal thinking, fastest responses

1087 "medium", # Moderate thinking

1088 "high", # Deep reasoning

1089 "xhigh", # Extended reasoning (Opus 4.7 only; falls back to "high" on other models)

1090 "max", # Maximum effort

1091]

1092```

1093 

1080### `CanUseTool`1094### `CanUseTool`

1081 1095 

1082Псевдоним типа для функций обратного вызова разрешения инструмента.1096Псевдоним типа для функций обратного вызова разрешения инструмента.


1224Управляет поведением расширенного мышления. Объединение трех конфигураций:1238Управляет поведением расширенного мышления. Объединение трех конфигураций:

1225 1239 

1226```python theme={null}1240```python theme={null}

1241ThinkingDisplay = Literal["summarized", "omitted"]

1242 

1243 

1227class ThinkingConfigAdaptive(TypedDict):1244class ThinkingConfigAdaptive(TypedDict):

1228 type: Literal["adaptive"]1245 type: Literal["adaptive"]

1246 display: NotRequired[ThinkingDisplay]

1229 1247 

1230 1248 

1231class ThinkingConfigEnabled(TypedDict):1249class ThinkingConfigEnabled(TypedDict):

1232 type: Literal["enabled"]1250 type: Literal["enabled"]

1233 budget_tokens: int1251 budget_tokens: int

1252 display: NotRequired[ThinkingDisplay]

1234 1253 

1235 1254 

1236class ThinkingConfigDisabled(TypedDict):1255class ThinkingConfigDisabled(TypedDict):


1241```1260```

1242 1261 

1243| Вариант | Поля | Описание |1262| Вариант | Поля | Описание |

1244| :--------- | :---------------------- | :------------------------------------------------ |1263| :--------- | :--------------------------------- | :------------------------------------------------ |

1245| `adaptive` | `type` | Claude адаптивно решает, когда думать |1264| `adaptive` | `type`, `display` | Claude адаптивно решает, когда думать |

1246| `enabled` | `type`, `budget_tokens` | Включить мышление с определенным бюджетом токенов |1265| `enabled` | `type`, `budget_tokens`, `display` | Включить мышление с определенным бюджетом токенов |

1247| `disabled` | `type` | Отключить мышление |1266| `disabled` | `type` | Отключить мышление |

1248 1267 

1268Дополнительное поле `display` управляет тем, возвращается ли текст мышления `"summarized"` или `"omitted"`. На Claude Opus 4.7 и более поздних версиях API по умолчанию используется `"omitted"`, поэтому установите `"summarized"` для получения содержимого мышления в выводах [`ThinkingBlock`](#thinkingblock).

1269 

1249Поскольку это классы `TypedDict`, они являются простыми словарями во время выполнения. Либо создавайте их как литералы словарей, либо вызывайте класс как конструктор; оба создают `dict`. Получайте доступ к полям с помощью `config["budget_tokens"]`, а не `config.budget_tokens`:1270Поскольку это классы `TypedDict`, они являются простыми словарями во время выполнения. Либо создавайте их как литералы словарей, либо вызывайте класс как конструктор; оба создают `dict`. Получайте доступ к полям с помощью `config["budget_tokens"]`, а не `config.budget_tokens`:

1250 1271 

1251```python theme={null}1272```python theme={null}


2177 hookEventName: Literal["PostToolUse"]2198 hookEventName: Literal["PostToolUse"]

2178 additionalContext: NotRequired[str]2199 additionalContext: NotRequired[str]

2179 updatedToolOutput: NotRequired[Any]2200 updatedToolOutput: NotRequired[Any]

2180 updatedMCPToolOutput: NotRequired[Any]2201 updatedMCPToolOutput: NotRequired[Any] # Deprecated: use updatedToolOutput, which works for all tools

2181 2202 

2182 2203 

2183class PostToolUseFailureHookSpecificOutput(TypedDict):2204class PostToolUseFailureHookSpecificOutput(TypedDict):


2646**Имя инструмента:** `TodoWrite`2667**Имя инструмента:** `TodoWrite`

2647 2668 

2648<Note>2669<Note>

2649 `TodoWrite` устарел и будет удален в будущем выпуске. Используйте вместо этого `TaskCreate`, `TaskGet`, `TaskUpdate` и `TaskList`. Установите `CLAUDE_CODE_ENABLE_TASKS=1` для включения. См. [Миграция на инструменты Task](/ru/agent-sdk/todo-tracking#migrate-to-task-tools) для того, как отслеживать изменения кода.2670 Начиная с Claude Code v2.1.142, `TodoWrite` отключен по умолчанию. Используйте вместо этого `TaskCreate`, `TaskGet`, `TaskUpdate` и `TaskList`. См. [Миграция на инструменты Task](/ru/agent-sdk/todo-tracking#migrate-to-task-tools) для обновления кода мониторинга, или установите `CLAUDE_CODE_ENABLE_TASKS=0` для возврата к `TodoWrite`.

2650</Note>2671</Note>

2651 2672 

2652**Ввод:**2673**Ввод:**

Details

48 48 

49[`ClaudeSDKClient`](/ru/agent-sdk/python#claudesdkclient) обрабатывает ID сеансов внутри. Каждый вызов `client.query()` автоматически продолжает тот же сеанс. Вызовите [`client.receive_response()`](/ru/agent-sdk/python#claudesdkclient) для итерации по сообщениям для текущего запроса. Клиент должен использоваться как асинхронный контекстный менеджер.49[`ClaudeSDKClient`](/ru/agent-sdk/python#claudesdkclient) обрабатывает ID сеансов внутри. Каждый вызов `client.query()` автоматически продолжает тот же сеанс. Вызовите [`client.receive_response()`](/ru/agent-sdk/python#claudesdkclient) для итерации по сообщениям для текущего запроса. Клиент должен использоваться как асинхронный контекстный менеджер.

50 50 

51Этот пример запускает два запроса к одному и тому же `client`. Первый просит агента проанализировать модуль; второй просит её переделать эту модуль. Поскольку оба вызова проходят через один и тот же экземпляр клиента, второй запрос имеет полный контекст из первого без явного `resume` или ID сеанса:51Этот пример запускает два запроса к одному и тому же `client`. Первый просит агента проанализировать модуль; второй просит его переделать этот модуль. Поскольку оба вызова проходят через один и тот же экземпляр клиента, второй запрос имеет полный контекст из первого без явного `resume` или ID сеанса:

52 52 

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

54import asyncio54import asyncio


100 100 

101### TypeScript: `continue: true`101### TypeScript: `continue: true`

102 102 

103Стабильный TypeScript SDK (функция `query()`, используемая во всех этих документах, иногда называемая V1) не имеет объекта клиента, удерживающего сеанс, как Python's `ClaudeSDKClient`. Вместо этого передайте `continue: true` на каждом последующем вызове `query()` и SDK подхватит самый последний сеанс в текущем каталоге. Отслеживание ID не требуется.103TypeScript SDK не имеет объекта клиента, удерживающего сеанс, как Python's `ClaudeSDKClient`. Вместо этого передайте `continue: true` на каждом последующем вызове `query()` и SDK подхватит самый последний сеанс в текущем каталоге. Отслеживание ID не требуется.

104 104 

105Этот пример делает два отдельных вызова `query()`. Первый создаёт свежий сеанс; второй устанавливает `continue: true`, что говорит SDK найти и возобновить самый последний сеанс на диске. Агент имеет полный контекст из первого вызова:105Этот пример делает два отдельных вызова `query()`. Первый создаёт свежий сеанс; второй устанавливает `continue: true`, что говорит SDK найти и возобновить самый последний сеанс на диске. Агент имеет полный контекст из первого вызова:

106 106 


132```132```

133 133 

134<Note>134<Note>

135 Экспериментальный [V2 session API](/ru/agent-sdk/typescript-v2-preview), который предоставлял `createSession()` с паттерном `send` / `stream`, устарел. Используйте функцию V1 `query()` и параметры сеанса, описанные на этой странице.135 Экспериментальный [V2 session API](/ru/agent-sdk/typescript-v2-preview), который предоставлял `createSession()` с паттерном `send` / `stream`, был удален в TypeScript Agent SDK 0.3.142. Используйте функцию `query()` и параметры сеанса, описанные на этой странице.

136</Note>136</Note>

137 137 

138## Используйте параметры сеанса с `query()`138## Используйте параметры сеанса с `query()`

Details

8 8 

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

10 10 

11<Note>

12 Начиная с TypeScript Agent SDK 0.3.142 и Claude Code v2.1.142, сеансы используют структурированные инструменты Task `TaskCreate`, `TaskUpdate`, `TaskGet` и `TaskList` вместо `TodoWrite`. Смотрите [Миграция на инструменты Task](#migrate-to-task-tools) для информации о том, как отслеживать изменения кода. Примеры на этой странице устанавливают `CLAUDE_CODE_ENABLE_TASKS=0` для продолжения отображения `TodoWrite` для сеансов, которые еще не перешли на новую версию.

13</Note>

14 

11### Жизненный цикл задач15### Жизненный цикл задач

12 16 

13Задачи следуют предсказуемому жизненному циклу:17Задачи следуют предсказуемому жизненному циклу:


36 40 

37 for await (const message of query({41 for await (const message of query({

38 prompt: "Optimize my React app performance and track progress with todos",42 prompt: "Optimize my React app performance and track progress with todos",

39 options: { maxTurns: 15 }43 // Re-enable TodoWrite, which this example monitors. Without it, the SDK uses

44 // Task tools instead and these tool_use blocks never appear.

45 options: { maxTurns: 15, env: { ...process.env, CLAUDE_CODE_ENABLE_TASKS: "0" } }

40 })) {46 })) {

41 // Todo updates are reflected in the message stream47 // Todo updates are reflected in the message stream

42 if (message.type === "assistant") {48 if (message.type === "assistant") {


61 67 

62 async for message in query(68 async for message in query(

63 prompt="Optimize my React app performance and track progress with todos",69 prompt="Optimize my React app performance and track progress with todos",

64 options=ClaudeAgentOptions(max_turns=15),70 # Re-enable TodoWrite, which this example monitors. Without it, the SDK uses

71 # Task tools instead and these tool_use blocks never appear.

72 options=ClaudeAgentOptions(max_turns=15, env={"CLAUDE_CODE_ENABLE_TASKS": "0"}),

65 ):73 ):

66 # Todo updates are reflected in the message stream74 # Todo updates are reflected in the message stream

67 if isinstance(message, AssistantMessage):75 if isinstance(message, AssistantMessage):


112 async trackQuery(prompt: string) {120 async trackQuery(prompt: string) {

113 for await (const message of query({121 for await (const message of query({

114 prompt,122 prompt,

115 options: { maxTurns: 20 }123 // Re-enable TodoWrite, which this tracker watches for.

124 options: { maxTurns: 20, env: { ...process.env, CLAUDE_CODE_ENABLE_TASKS: "0" } }

116 })) {125 })) {

117 if (message.type === "assistant") {126 if (message.type === "assistant") {

118 for (const block of message.message.content) {127 for (const block of message.message.content) {


167 print(f"{i + 1}. {icon} {text}")176 print(f"{i + 1}. {icon} {text}")

168 177 

169 async def track_query(self, prompt: str):178 async def track_query(self, prompt: str):

170 async for message in query(prompt=prompt, options=ClaudeAgentOptions(max_turns=20)):179 async for message in query(

180 prompt=prompt,

181 # Re-enable TodoWrite, which this tracker watches for.

182 options=ClaudeAgentOptions(max_turns=20, env={"CLAUDE_CODE_ENABLE_TASKS": "0"}),

183 ):

171 if isinstance(message, AssistantMessage):184 if isinstance(message, AssistantMessage):

172 for block in message.content:185 for block in message.content:

173 if isinstance(block, ToolUseBlock) and block.name == "TodoWrite":186 if isinstance(block, ToolUseBlock) and block.name == "TodoWrite":


181 ```194 ```

182</CodeGroup>195</CodeGroup>

183 196 

197## Миграция на инструменты Task

198 

199Инструменты Task разделяют единый вызов `TodoWrite` на `TaskCreate` для каждого нового элемента и `TaskUpdate` для каждого изменения статуса, с `TaskList` и `TaskGet`, доступными для модели для чтения текущего списка. Ваш код мониторинга по-прежнему проверяет блоки `tool_use` в потоке помощника, но поддерживает карту, индексированную по ID задачи, вместо замены всего списка при каждом вызове. {/* min-version: 2.1.142 */}Инструменты Task являются стандартными начиная с TypeScript Agent SDK 0.3.142 и Claude Code v2.1.142, поэтому изменение `options.env` не требуется.

200 

201| С `TodoWrite` | С инструментами Task |

202| ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

203| Один вызов инструмента переписывает весь массив `todos` | `TaskCreate` добавляет один элемент, `TaskUpdate` исправляет один элемент по `taskId` |

204| Совпадение `block.name === "TodoWrite"` | Совпадение `block.name === "TaskCreate"` или `"TaskUpdate"` |

205| Форма элемента: `{ content, status, activeForm }` | Ввод `TaskCreate`: `{ subject, description, activeForm?, metadata? }`. Ввод `TaskUpdate`: `{ taskId, status?, subject?, description?, activeForm?, addBlocks?, addBlockedBy?, owner?, metadata? }`. `status` это `"pending"`, `"in_progress"` или `"completed"`; установите `status: "deleted"` для удаления |

206| Отобразить `block.input.todos` напрямую | Накопить элементы между вызовами или прочитать снимок из результата инструмента `TaskList` |

207 

208Назначенный ID задачи отсутствует во вводе `TaskCreate`. Он возвращается в соответствующем `tool_result` как `{ task: { id, subject } }`, поэтому захватите его из блока результата, чтобы индексировать вашу карту. Следующий пример показывает минимальное изменение цикла [Мониторинг изменений задач](#monitoring-todo-changes). Для отображения полного списка смотрите результат инструмента `TaskList` в потоке или накопите результаты `TaskCreate` и вводы `TaskUpdate` в карту:

209 

210<CodeGroup>

211 ```typescript TypeScript theme={null}

212 import { query } from "@anthropic-ai/claude-agent-sdk";

213 

214 for await (const message of query({

215 prompt: "Optimize my React app performance",

216 })) {

217 if (message.type !== "assistant") continue;

218 for (const block of message.message.content) {

219 if (block.type !== "tool_use") continue;

220 if (block.name === "TaskCreate") {

221 const input = block.input as { subject: string };

222 console.log(`+ ${input.subject}`);

223 } else if (block.name === "TaskUpdate") {

224 const input = block.input as { taskId: string; status?: string };

225 if (input.status) console.log(` ${input.taskId} -> ${input.status}`);

226 }

227 }

228 }

229 ```

230 

231 ```python Python theme={null}

232 from claude_agent_sdk import query, AssistantMessage, ToolUseBlock

233 

234 async for message in query(

235 prompt="Optimize my React app performance",

236 ):

237 if not isinstance(message, AssistantMessage):

238 continue

239 for block in message.content:

240 if not isinstance(block, ToolUseBlock):

241 continue

242 if block.name == "TaskCreate":

243 print(f"+ {block.input['subject']}")

244 elif block.name == "TaskUpdate" and block.input.get("status"):

245 print(f" {block.input['taskId']} -> {block.input['status']}")

246 ```

247</CodeGroup>

248 

184## Связанная документация249## Связанная документация

185 250 

186* [Справочник TypeScript SDK](/ru/agent-sdk/typescript)251* [Справочник TypeScript SDK](/ru/agent-sdk/typescript)

Details

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

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

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

417| `strictMcpConfig` | `boolean` | `false` | Принудительно применяйте строгую валидацию MCP |417| `strictMcpConfig` | `boolean` | `false` | Используйте только серверы, переданные в `mcpServers`, и игнорируйте проект `.mcp.json`, пользовательские настройки и MCP серверы, предоставленные plugins |

418| `systemPrompt` | `string \| { type: 'preset'; preset: 'claude_code'; append?: string; excludeDynamicSections?: boolean }` | `undefined` (минимальный запрос) | Конфигурация системного запроса. Передайте строку для пользовательского запроса или `{ type: 'preset', preset: 'claude_code' }` для использования системного запроса Claude Code. При использовании формы объекта preset добавьте `append` для расширения его дополнительными инструкциями и установите `excludeDynamicSections: true` для перемещения контекста для каждой сессии в первое пользовательское сообщение для [лучшего переиспользования prompt-cache на разных машинах](/ru/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) |418| `systemPrompt` | `string \| { type: 'preset'; preset: 'claude_code'; append?: string; excludeDynamicSections?: boolean }` | `undefined` (минимальный запрос) | Конфигурация системного запроса. Передайте строку для пользовательского запроса или `{ type: 'preset', preset: 'claude_code' }` для использования системного запроса Claude Code. При использовании формы объекта preset добавьте `append` для расширения его дополнительными инструкциями и установите `excludeDynamicSections: true` для перемещения контекста для каждой сессии в первое пользовательское сообщение для [лучшего переиспользования prompt-cache на разных машинах](/ru/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) |

419| `thinking` | [`ThinkingConfig`](#thinkingconfig) | `{ type: 'adaptive' }` для поддерживаемых моделей | Контролирует поведение мышления/рассуждения Claude. См. [`ThinkingConfig`](#thinkingconfig) для опций |419| `thinking` | [`ThinkingConfig`](#thinkingconfig) | `{ type: 'adaptive' }` для поддерживаемых моделей | Контролирует поведение мышления/рассуждения Claude. См. [`ThinkingConfig`](#thinkingconfig) для опций |

420| `toolConfig` | [`ToolConfig`](#toolconfig) | `undefined` | Конфигурация для встроенного поведения инструмента. См. [`ToolConfig`](#toolconfig) для деталей |420| `toolConfig` | [`ToolConfig`](#toolconfig) | `undefined` | Конфигурация для встроенного поведения инструмента. См. [`ToolConfig`](#toolconfig) для деталей |


1847Создаёт и управляет структурированным списком задач для отслеживания прогресса.1847Создаёт и управляет структурированным списком задач для отслеживания прогресса.

1848 1848 

1849<Note>1849<Note>

1850 `TodoWrite` устарел и будет удалён в будущем выпуске. Используйте вместо этого `TaskCreate`, `TaskGet`, `TaskUpdate` и `TaskList`. Установите `CLAUDE_CODE_ENABLE_TASKS=1` для включения. См. [Миграция на Task tools](/ru/agent-sdk/todo-tracking#migrate-to-task-tools) для того, как отслеживать изменения кода.1850 Начиная с TypeScript Agent SDK 0.3.142, `TodoWrite` отключён по умолчанию. Используйте вместо этого `TaskCreate`, `TaskGet`, `TaskUpdate` и `TaskList`. См. [Миграция на Task tools](/ru/agent-sdk/todo-tracking#migrate-to-task-tools) для обновления кода мониторинга, или установите `CLAUDE_CODE_ENABLE_TASKS=0` для возврата к `TodoWrite`.

1851</Note>1851</Note>

1852 1852 

1853### TaskCreate1853### TaskCreate


2344Возвращает предыдущие и обновлённые списки задач.2344Возвращает предыдущие и обновлённые списки задач.

2345 2345 

2346<Note>2346<Note>

2347 `TodoWrite` устарел и будет удалён в будущем выпуске. Используйте вместо этого `TaskCreate`, `TaskGet`, `TaskUpdate` и `TaskList`. Установите `CLAUDE_CODE_ENABLE_TASKS=1` для включения. Смотрите [Миграция на Task tools](/ru/agent-sdk/todo-tracking#migrate-to-task-tools) для информации о мониторинге изменений кода.2347 Начиная с TypeScript Agent SDK 0.3.142, `TodoWrite` отключён по умолчанию. Используйте вместо этого `TaskCreate`, `TaskGet`, `TaskUpdate` и `TaskList`. Смотрите [Миграция на Task tools](/ru/agent-sdk/todo-tracking#migrate-to-task-tools) для обновления кода мониторинга, или установите `CLAUDE_CODE_ENABLE_TASKS=0` для возврата к `TodoWrite`.

2348</Note>2348</Note>

2349 2349 

2350### TaskCreate2350### TaskCreate


2739Контролирует поведение мышления/рассуждения Claude. Имеет приоритет над устаревшим `maxThinkingTokens`.2739Контролирует поведение мышления/рассуждения Claude. Имеет приоритет над устаревшим `maxThinkingTokens`.

2740 2740 

2741```typescript theme={null}2741```typescript theme={null}

2742type ThinkingDisplay = "summarized" | "omitted";

2743 

2742type ThinkingConfig =2744type ThinkingConfig =

2743 | { type: "adaptive" } // Модель определяет, когда и сколько рассуждать (Opus 4.6+)2745 | { type: "adaptive"; display?: ThinkingDisplay } // Модель определяет, когда и сколько рассуждать (Opus 4.6+)

2744 | { type: "enabled"; budgetTokens?: number } // Фиксированный бюджет токенов мышления2746 | { type: "enabled"; budgetTokens?: number; display?: ThinkingDisplay } // Фиксированный бюджет токенов мышления

2745 | { type: "disabled" }; // Без расширенного мышления2747 | { type: "disabled" }; // Без расширенного мышления

2746```2748```

2747 2749 

2750Опциональное поле `display` контролирует, возвращается ли текст мышления `"summarized"` или `"omitted"`. На Claude Opus 4.7 и позже, значение по умолчанию API это `"omitted"`, поэтому установите `"summarized"` для получения содержимого мышления в блоках `thinking`.

2751 

2748### `SpawnedProcess`2752### `SpawnedProcess`

2749 2753 

2750Интерфейс для пользовательского запуска процесса (используется с опцией `spawnClaudeCodeProcess`). `ChildProcess` уже удовлетворяет этому интерфейсу.2754Интерфейс для пользовательского запуска процесса (используется с опцией `spawnClaudeCodeProcess`). `ChildProcess` уже удовлетворяет этому интерфейсу.


3158```3162```

3159 3163 

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

3161| :------------------------ | :--------- | :----------- | :--------------------------------------------------------------------------------------------------------- |3165| :------------------------ | :--------- | :----------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

3162| `allowedDomains` | `string[]` | `[]` | Имена доменов, к которым процессы в sandbox могут получить доступ |3166| `allowedDomains` | `string[]` | `[]` | Имена доменов, к которым процессы в sandbox могут получить доступ |

3163| `deniedDomains` | `string[]` | `[]` | Имена доменов, к которым процессы в sandbox не могут получить доступ. Имеет приоритет над `allowedDomains` |3167| `deniedDomains` | `string[]` | `[]` | Имена доменов, к которым процессы в sandbox не могут получить доступ. Имеет приоритет над `allowedDomains` |

3164| `allowManagedDomainsOnly` | `boolean` | `false` | Ограничьте доступ в сеть только доменами в `allowedDomains` |3168| `allowManagedDomainsOnly` | `boolean` | `false` | Только управляемые параметры. Когда установлено в [управляемых параметрах](/ru/permissions#managed-settings), только записи `allowedDomains` из управляемых параметров учитываются, а записи из пользовательских, проектных или локальных параметров игнорируются. Не имеет эффекта при установке через опции SDK |

3165| `allowLocalBinding` | `boolean` | `false` | Разрешите процессам привязываться к локальным портам (например, для dev серверов) |3169| `allowLocalBinding` | `boolean` | `false` | Разрешите процессам привязываться к локальным портам (например, для dev серверов) |

3166| `allowUnixSockets` | `string[]` | `[]` | Пути Unix socket, к которым процессы могут получить доступ (например, Docker socket) |3170| `allowUnixSockets` | `string[]` | `[]` | Пути Unix socket, к которым процессы могут получить доступ (например, Docker socket) |

3167| `allowAllUnixSockets` | `boolean` | `false` | Разрешите доступ ко всем Unix sockets |3171| `allowAllUnixSockets` | `boolean` | `false` | Разрешите доступ ко всем Unix sockets |

Details

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.3> Use this file to discover all available pages before exploring further.

4 4 

5# TypeScript SDK V2 session API (deprecated)5# TypeScript SDK V2 session API (removed)

6 6 

7> Справочник по устаревшему V2 TypeScript Agent SDK session API с паттернами отправки/потока на основе сессий для многооборотных разговоров.7> Справочник по удалённому V2 TypeScript Agent SDK session API с паттернами отправки/потока на основе сессий для многооборотных разговоров.

8 8 

9<Warning>9<Warning>

10 Функции V2 session API `unstable_v2_createSession`, `unstable_v2_resumeSession` и `unstable_v2_prompt` устарели и будут удалены в будущем выпуске. Используйте вместо этого [V1 `query()` API](/ru/agent-sdk/typescript).10 V2 session API больше не поддерживается. TypeScript Agent SDK 0.3.142 удаляет `unstable_v2_createSession`, `unstable_v2_resumeSession`, `unstable_v2_prompt` и типы `SDKSession` и `SDKSessionOptions`.

11 

12 Для миграции используйте [`query()` API](/ru/agent-sdk/typescript) и [параметры сессии](/ru/agent-sdk/sessions), которые он принимает. Передайте `AsyncIterable<SDKUserMessage>` для многооборотных разговоров или `options.resume` для продолжения сохранённой сессии. Эта страница сохранена для справки, если вы поддерживаете код на Agent SDK 0.2.x или более ранней версии.

11</Warning>13</Warning>

12 14 

13V2 был экспериментальным session API, который устранил необходимость в асинхронных генераторах и координации yield. Вместо управления состоянием генератора между оборотами, каждый оборот представлял собой отдельный цикл `send()`/`stream()`. Поверхность API сводилась к трём концепциям:15V2 был экспериментальным session API, который устранил необходимость в асинхронных генераторах и координации yield. Вместо управления состоянием генератора между оборотами, каждый оборот представлял собой отдельный цикл `send()`/`stream()`. Поверхность API сводилась к трём концепциям:


18 20 

19## Установка21## Установка

20 22 

21Интерфейс V2 включён в существующий пакет SDK:23Agent SDK версии 0.2.x — это последняя версия, которая включает интерфейс V2. Версия пакета перепрыгнула с 0.2.x прямо на 0.3.142, поэтому версия удаления выше и указание установки ниже описывают одну и ту же границу. Чтобы установить последний совместимый с V2 релиз, зафиксируйте основную и дополнительную версию:

22 24 

23```bash theme={null}25```bash theme={null}

24npm install @anthropic-ai/claude-agent-sdk26npm install @anthropic-ai/claude-agent-sdk@0.2

25```27```

26 28 

27<Note>29<Note>

agent-view.md +74 −23

Details

72 72 

73Запустите `claude agents` для открытия agent view. Он захватывает весь терминал и перечисляет каждый сеанс, сгруппированный по состоянию, с закреплёнными сеансами и теми, которые требуют вас в верхней части. Каждая строка показывает имя сеанса, текущую активность и как давно он в последний раз изменился.73Запустите `claude agents` для открытия agent view. Он захватывает весь терминал и перечисляет каждый сеанс, сгруппированный по состоянию, с закреплёнными сеансами и теми, которые требуют вас в верхней части. Каждая строка показывает имя сеанса, текущую активность и как давно он в последний раз изменился.

74 74 

75Список охватывает каждый фоновый сеанс, который вы запустили, во всех ваших проектах. Сеанс, работающий в одном репозитории, и другой в другом worktree, оба появляются здесь, независимо от того, из какого каталога вы открыли agent view. Интерактивные сеансы, открытые в других терминалах, не появляются до тех пор, пока вы не [отправите их в фон](#from-inside-a-session). [Subagents](/ru/sub-agents) и [teammates](/ru/agent-teams), которых порождает сеанс, не указаны как отдельные строки.75По умолчанию список показывает каждый фоновый сеанс, который вы запустили, во всех ваших проектах. Сеанс, работающий в одном репозитории, и другой в другом worktree, оба появляются здесь, независимо от того, из какого каталога вы открыли agent view. Чтобы ограничить список одним проектом, передайте `--cwd` (требуется Claude Code v2.1.141 или позже):

76 76 

77Чтобы ограничить представление одним проектом, запустите с помощью `claude agents --cwd <path>`. Только сеансы, запущенные в этом каталоге, появляются, включая любые работающие в [worktree](/ru/worktrees), отправленном из него.77```bash theme={null}

78claude agents --cwd ~/projects/my-app

79```

80 

81Это показывает только сеансы, запущенные в этом каталоге. Сеанс, который [переместился в worktree](#how-file-edits-are-isolated) под `~/projects/my-app/.claude/worktrees/`, всё ещё считается принадлежащим `~/projects/my-app`.

82 

83Интерактивные сеансы, открытые в других терминалах, не появляются до тех пор, пока вы не [отправите их в фон](#from-inside-a-session). [Subagents](/ru/sub-agents) и [teammates](/ru/agent-teams), которых порождает сеанс, не указаны как отдельные строки.

78 84 

79```text theme={null}85```text theme={null}

80Pinned86Pinned


117| `∙` | Процесс завершился. Вы всё ещё можете просмотреть, ответить или подключиться, и Claude перезапускается с того места, где он остановился |123| `∙` | Процесс завершился. Вы всё ещё можете просмотреть, ответить или подключиться, и Claude перезапускается с того места, где он остановился |

118| `✢` | Сеанс [`/loop`](/ru/scheduled-tasks), спящий между итерациями. Строка показывает количество запусков и обратный отсчёт |124| `✢` | Сеанс [`/loop`](/ru/scheduled-tasks), спящий между итерациями. Строка показывает количество запусков и обратный отсчёт |

119 125 

126`●`, который может появиться в правом краю строки, является индикатором [статуса pull request](#pull-request-status), а не частью значка состояния. Число перед ним — это количество pull request, которые открыл сеанс.

127 

120Фоновые сеансы не требуют открытого терминала для продолжения работы. Отдельный [процесс супервизора](#the-supervisor-process) их запускает, поэтому вы можете закрыть agent view, закрыть оболочку или запустить новый интерактивный сеанс, и ваша отправленная работа продолжает выполняться.128Фоновые сеансы не требуют открытого терминала для продолжения работы. Отдельный [процесс супервизора](#the-supervisor-process) их запускает, поэтому вы можете закрыть agent view, закрыть оболочку или запустить новый интерактивный сеанс, и ваша отправленная работа продолжает выполняться.

121 129 

122Состояние сеанса сохраняется на диск через автоматические обновления и перезапуски супервизора. Если ваша машина переходит в спящий режим или выключается, работающие сеансы останавливаются; перезапустите их с помощью `claude respawn --all`.130Состояние сеанса сохраняется на диск через автоматические обновления и перезапуски супервизора. Сеансы также сохраняются, когда ваша машина переходит в спящий режим. Их процессы возобновляются при пробуждении, и супервизор переподключается к ним вместо того, чтобы рассматривать временной разрыв как неактивность. Выключение всё ещё останавливает работающие сеансы; см. [Sessions show as failed after shutdown](#sessions-show-as-failed-after-shutdown) для того, как их восстановить.

123 131 

124### Row summaries132### Row summaries

125 133 


142 150 

143### Peek and reply151### Peek and reply

144 152 

145Нажмите `Space` на выбранной строке, чтобы открыть панель просмотра. Она показывает, что требуется сеансу от вас, его последний вывод и любые pull requests, которые он открыл. В большинстве случаев этого достаточно, и вам никогда не нужно открывать полную стенограмму.153Нажмите `Space` на выбранной строке, чтобы открыть панель просмотра. Она показывает, что требуется сеансу от вас, его последний вывод и любые pull request, которые он открыл. В большинстве случаев этого достаточно, и вам никогда не нужно открывать полную стенограмму.

146 154 

147Введите ответ в панель просмотра и нажмите `Enter`, чтобы отправить его этому сеансу. Когда сеанс задаёт вопрос с несколькими вариантами ответов, панель просмотра показывает варианты и вы можете нажать цифровую клавишу для выбора одного. Для других заблокированных сеансов нажмите `Tab`, чтобы заполнить ввод предложенным ответом, который вы можете отредактировать перед отправкой. Начните ответ с `!`, чтобы отправить команду Bash вместо этого.155Введите ответ в панель просмотра и нажмите `Enter`, чтобы отправить его этому сеансу. Когда сеанс задаёт вопрос с несколькими вариантами ответов, панель просмотра показывает варианты и вы можете нажать цифровую клавишу для выбора одного. Для других заблокированных сеансов нажмите `Tab`, чтобы заполнить ввод предложенным ответом, который вы можете отредактировать перед отправкой. Начните ответ с `!`, чтобы отправить команду Bash вместо этого.

148 156 


158 166 

159Отключение никогда не останавливает фоновый сеанс: `←`, `Ctrl+C`, `Ctrl+D`, `Ctrl+Z` и `/exit` оставляют его работающим. Чтобы завершить сеанс изнутри, запустите `/stop`.167Отключение никогда не останавливает фоновый сеанс: `←`, `Ctrl+C`, `Ctrl+D`, `Ctrl+Z` и `/exit` оставляют его работающим. Чтобы завершить сеанс изнутри, запустите `/stop`.

160 168 

161После того как вы отправили или отправили сеанс в фон, нажатие `←` на пустой подсказке работает из любого сеанса Claude Code, а не только из тех, к которым вы подключались из agent view. Он отправляет текущий сеанс в фон и открывает agent view с этим сеансом предварительно выбранным, поэтому вы можете переключаться между сеансами без выхода из терминала. Вы можете отключить это сочетание клавиш в `/config`.169После того как вы отправили или отправили сеанс в фон, нажатие `←` на пустой подсказке работает из любого сеанса Claude Code, а не только из тех, к которым вы подключались из agent view. Он отправляет текущий сеанс в фон и открывает agent view с этой строкой выбранной, поэтому вы можете переключаться между сеансами без выхода из терминала. Строка создаётся даже из свежего сеанса без истории разговора, поэтому `→` возвращает к ней. Когда эта строка единственная, agent view показывает подсказку адаптации ниже неё. Вы можете отключить это сочетание клавиш в `/config` (параметр `leftArrowOpensAgents`).

162 170 

163### Organize the list171### Organize the list

164 172 


173 181 

174Чтобы удалить сеанс из списка, нажмите `Ctrl+X` для его остановки и `Ctrl+X` снова в течение двух секунд для удаления. Нажатие `Ctrl+X` на заголовке группы удаляет каждый сеанс в этой группе после подтверждения.182Чтобы удалить сеанс из списка, нажмите `Ctrl+X` для его остановки и `Ctrl+X` снова в течение двух секунд для удаления. Нажатие `Ctrl+X` на заголовке группы удаляет каждый сеанс в этой группе после подтверждения.

175 183 

176Удаление удаляет сеанс из agent view и очищает его [worktree](#how-file-edits-are-isolated), включая любые незафиксированные изменения в нём, поэтому отправьте или зафиксируйте работу, которую вы хотите сохранить, перед удалением. Стенограмма разговора остаётся на диске и остаётся доступной через `claude --resume`.184Удаление удаляет сеанс из agent view и удаляет его стенограмму разговора. Если Claude [создал worktree](#how-file-edits-are-isolated) для сеанса, удаление удаляет этот worktree тоже, включая любые незафиксированные изменения в нём, поэтому отправьте или зафиксируйте работу, которую вы хотите сохранить, перед удалением. Worktree, который вы создали сами и запустили сеанс внутри, остаётся на месте.

177 185 

178Более старые завершённые сеансы складываются в строку `… N more` для сохранения списка коротким. Сбои и сеансы с открытым pull request всегда остаются видимыми.186Более старые завершённые сеансы складываются в строку `… N more` для сохранения списка коротким. Сбои и сеансы с открытым pull request всегда остаются видимыми.

179 187 


198| `Space` | Открытие или закрытие панели просмотра для выбранного сеанса |206| `Space` | Открытие или закрытие панели просмотра для выбранного сеанса |

199| `Shift+Enter` | Отправка и немедленное подключение |207| `Shift+Enter` | Отправка и немедленное подключение |

200| `→` | Подключение к выбранному сеансу |208| `→` | Подключение к выбранному сеансу |

201| `Alt+1`..`Alt+9` | Подключение к сеансу 1–9 в текущей группе |209| `Alt+1`..`Alt+9` | Подключение к сеансу 1–9 в текущем каталоге |

202| `Tab` | На пустом вводе просмотр всех subagents. В противном случае применение выделенного предложения |210| `Tab` | На пустом вводе просмотр всех subagents. В противном случае применение выделенного предложения |

203| `Ctrl+S` | Переключение группировки между состоянием и каталогом |211| `Ctrl+S` | Переключение группировки между состоянием и каталогом |

204| `Ctrl+T` | Закрепление или открепление выбранного сеанса |212| `Ctrl+T` | Закрепление или открепление выбранного сеанса |

205| `Ctrl+R` | Переименование выбранного сеанса |213| `Ctrl+R` | Переименование выбранного сеанса |

206| `Ctrl+G` | Открытие подсказки отправки в вашем `$EDITOR` |214| `Ctrl+G` | Открытие подсказки отправки в вашем `$VISUAL` или `$EDITOR` |

207| `Ctrl+X` | Остановка сеанса; нажмите снова в течение двух секунд для удаления |215| `Ctrl+X` | Остановка сеанса; нажмите снова в течение двух секунд для удаления |

208| `Shift+↑` / `Shift+↓` | Переупорядочение выбранного сеанса |216| `Shift+↑` / `Shift+↓` | Переупорядочение выбранного сеанса |

209| `Esc` | Закрытие панели просмотра, очистка ввода или выход |217| `Esc` | Закрытие панели просмотра, очистка ввода или выход |


251 259 

252Переведение в фон из интерактивного сеанса запускает свежий процесс, который возобновляется из сохранённой беседы, поэтому запуск subagent, [monitors](/ru/tools-reference#monitor-tool) и фоновых команд не переносится в него. Claude просит вас подтвердить перед переводом в фон, когда какие-либо из них работают. После перевода в фон сеанс может запускать новые subagent, monitors и фоновые команды, и они продолжают работать при последующем отключении и переподключении.260Переведение в фон из интерактивного сеанса запускает свежий процесс, который возобновляется из сохранённой беседы, поэтому запуск subagent, [monitors](/ru/tools-reference#monitor-tool) и фоновых команд не переносится в него. Claude просит вас подтвердить перед переводом в фон, когда какие-либо из них работают. После перевода в фон сеанс может запускать новые subagent, monitors и фоновые команды, и они продолжают работать при последующем отключении и переподключении.

253 261 

262Флаги конфигурации из исходного запуска переносятся в фоновый сеанс, поэтому его MCP servers, settings и резервная модель остаются в силе:

263 

264* `--mcp-config` и `--strict-mcp-config`

265* `--settings`

266* `--add-dir`

267* `--plugin-dir`

268* `--fallback-model`

269* `--allow-dangerously-skip-permissions`

270 

271Перенос `--allow-dangerously-skip-permissions` сохраняет `bypassPermissions` доступным в фоновом сеансе, но это не предоставляет ничего нового. Режим по-прежнему требует того же одноразового интерактивного принятия, описанного в [Permission mode, model, and effort](#permission-mode-model-and-effort), прежде чем любой сеанс сможет его использовать.

272 

254### From your shell273### From your shell

255 274 

256Передайте `--bg` для запуска сеанса, который идёт прямо в фон:275Передайте `--bg` для запуска сеанса, который идёт прямо в фон:


283 302 

284### How file edits are isolated303### How file edits are isolated

285 304 

286Каждый фоновый сеанс, запущенный ли из agent view, `/bg` или `claude --bg`, запускается в вашем рабочем каталоге. Перед редактированием файлов Claude перемещает сеанс в изолированный [git worktree](/ru/worktrees) под `.claude/worktrees/`, поэтому параллельные сеансы могут читать один и тот же checkout, но каждый пишет в свой собственный. Claude пропускает это, когда сеанс уже находится под `.claude/worktrees/`, когда рабочий каталог не является git репозиторием или для записей вне рабочего каталога.305Каждый фоновый сеанс, запущенный ли из agent view, `/bg` или `claude --bg`, запускается в вашем рабочем каталоге. Перед редактированием файлов Claude перемещает сеанс в изолированный [git worktree](/ru/worktrees) под `.claude/worktrees/`, поэтому параллельные сеансы могут читать один и тот же checkout, но каждый пишет в свой собственный.

306 

307Claude пропускает worktree когда:

308 

309* Сеанс уже находится внутри связанного git worktree, создан ли он Claude под `.claude/worktrees/` или вы создали его с помощью `git worktree add` где-то ещё

310* Рабочий каталог не является git репозиторием

311* Запись находится вне рабочего каталога

312 

313Чтобы отключить изоляцию worktree для репозитория, где git worktrees непрактичны, установите [`worktree.bgIsolation`](/ru/settings#worktree-settings) на `"none"`. Фоновые сеансы затем редактируют вашу рабочую копию напрямую без предварительного перемещения в worktree. Добавьте параметр в файл `.claude/settings.json` проекта:

314 

315```json theme={null}

316{

317 "worktree": {

318 "bgIsolation": "none"

319 }

320}

321```

322 

323<Note>

324 Параметр `worktree.bgIsolation` требует Claude Code v2.1.143 или позже.

325</Note>

287 326 

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

289 328 

290Worktree удаляется при удалении сеанса, поэтому объедините или отправьте изменения, которые вы хотите сохранить, перед удалением. Чтобы найти путь worktree сеанса, посмотрите сеанс или подключитесь и проверьте его рабочий каталог.329Удаление сеанса в agent view (`Ctrl+X` дважды) удаляет worktree, созданный Claude для него, включая любые незафиксированные изменения, поэтому объедините или отправьте изменения, которые вы хотите сохранить, перед удалением. Удаление из оболочки с помощью [`claude rm`](#manage-sessions-from-the-shell) сохраняет worktree, который имеет незафиксированные изменения, и выводит его путь, чтобы вы могли очистить его самостоятельно. Worktree, который вы создали сами и запустили сеанс внутри, остаётся на месте в любом случае.

330 

331Чтобы найти путь worktree сеанса, посмотрите сеанс или подключитесь и проверьте его рабочий каталог.

291 332 

292Чтобы сделать subagent всегда запускаемым в его собственном worktree независимо от того, как он был запущен, установите [`isolation: worktree`](/ru/sub-agents#supported-frontmatter-fields) в его frontmatter.333Чтобы сделать subagent всегда запускаемым в его собственном worktree независимо от того, как он был запущен, установите [`isolation: worktree`](/ru/sub-agents#supported-frontmatter-fields) в его frontmatter.

293 334 


303 344 

304### Permission mode, model, and effort345### Permission mode, model, and effort

305 346 

306Отправленный сеанс читает свои [settings](/ru/settings) из каталога, в котором он запускается, так же как если бы вы запустили `claude` там.347Фоновый сеанс читает свои [settings](/ru/settings) из каталога, в котором он запускается, так же как если бы вы запустили `claude` там.

307 348 

308[Permission mode](/ru/permissions) зависит от того, как вы запустили сеанс. Переведение существующего сеанса в фон с помощью `/bg` или `←` сохраняет текущий permission mode, поэтому сеанс, который вы переключили на `acceptEdits` или `auto`, остаётся в этом режиме после отключения. Отправка из входа agent view или запуск `claude --bg` из вашей оболочки использует `defaultMode` из settings этого каталога или `permissionMode` из frontmatter отправленного [subagent](/ru/sub-agents#supported-frontmatter-fields).349[Permission mode](/ru/permissions) зависит от того, как вы запустили сеанс. Переведение существующего сеанса в фон с помощью `/bg` или `←` сохраняет текущий permission mode, поэтому сеанс, который вы переключили на `acceptEdits` или `auto`, остаётся в этом режиме после отключения. Отправка из входа agent view или запуск `claude --bg` из вашей оболочки использует `defaultMode` из settings этого каталога или `permissionMode` из frontmatter отправленного [subagent](/ru/sub-agents#supported-frontmatter-fields).

309 350 

351Permission mode, с которым вы запускаете фоновый сеанс, сохраняется, когда supervisor позже [останавливает и перезапускает](#the-supervisor-process) процесс сеанса. Сеанс, который вы запустили с помощью `claude --bg --dangerously-skip-permissions` или `claude --bg --permission-mode bypassPermissions`, остаётся в `bypassPermissions` после этого перезапуска вместо возврата к `defaultMode` каталога.

352 

310Чтобы установить стандартные значения для каждого сеанса, который вы отправляете из agent view, передайте любой из `--permission-mode`, `--model` или `--effort` при открытии его:353Чтобы установить стандартные значения для каждого сеанса, который вы отправляете из agent view, передайте любой из `--permission-mode`, `--model` или `--effort` при открытии его:

311 354 

312```bash theme={null}355```bash theme={null}

313claude agents --permission-mode plan --model opus --effort high356claude agents --permission-mode plan --model opus --effort high

314```357```

315 358 

359`claude agents` также принимает `--dangerously-skip-permissions` как сокращение для `--permission-mode bypassPermissions` и `--allow-dangerously-skip-permissions` для того, чтобы сделать `bypassPermissions` доступным в цикле `Shift+Tab` каждого отправленного сеанса без запуска в этом режиме. Оба совпадают с [флагами CLI верхнего уровня](/ru/cli-reference).

360 

316<Note>361<Note>

317 Передача `--permission-mode`, `--model` или `--effort` в `claude agents` требует Claude Code v2.1.142 или позже. Более ранние версии отклоняют эти флаги с ошибкой unknown-option.362 Передача `--permission-mode`, `--model`, `--effort` или `--dangerously-skip-permissions` в `claude agents` требует Claude Code v2.1.142 или позже. {/* min-version: 2.1.143 */}`--allow-dangerously-skip-permissions` на `claude agents` требует v2.1.143 или позже. Более ранние версии отклоняют эти флаги с ошибкой unknown-option.

318</Note>363</Note>

319 364 

320Активные стандартные значения отображаются в нижнем колонтитуле под входом отправки.365Активные стандартные значения отображаются в нижнем колонтитуле под входом отправки.


325 370 

326### Settings, plugins, and MCP servers371### Settings, plugins, and MCP servers

327 372 

328Agent view принимает те же флаги конфигурации, что и `claude` для загрузки settings, plugins, MCP servers и дополнительных каталогов. Каждый флаг применяется к самому agent view и передаётся каждому сеансу, который вы отправляете из него, поэтому plugin или MCP server, который вы загружаете таким образом, доступен в этих сеансах тоже.373Agent view принимает те же флаги конфигурации, что и `claude` для загрузки settings, plugins, MCP servers и дополнительных каталогов. Эти флаги требуют Claude Code v2.1.142 или позже. Каждый флаг применяется к самому agent view и передаётся каждому сеансу, который вы отправляете из него, поэтому plugin или MCP server, который вы загружаете таким образом, доступен в этих сеансах тоже.

329 374 

330| Флаг | Эффект |375| Флаг | Эффект |

331| :----------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------- |376| :----------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------- |


348Каждый фоновый сеанс имеет короткий ID, который вы можете использовать из оболочки. ID выводится при запуске сеанса с помощью `claude --bg`, и ID каждого сеанса — это имя его каталога в `~/.claude/jobs/`. Эти команды полезны для написания скриптов или когда вы не хотите открывать agent view.393Каждый фоновый сеанс имеет короткий ID, который вы можете использовать из оболочки. ID выводится при запуске сеанса с помощью `claude --bg`, и ID каждого сеанса — это имя его каталога в `~/.claude/jobs/`. Эти команды полезны для написания скриптов или когда вы не хотите открывать agent view.

349 394 

350| Команда | Назначение |395| Команда | Назначение |

351| :--------------------- | :---------------------------------------------------------------------------------- |396| :--------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

352| `claude agents` | Открыть agent view |397| `claude agents` | Открыть agent view |

398| `claude agents --cwd <path>` | Открыть agent view с областью действия сеансов, запущенных в `<path>` |

353| `claude attach <id>` | Подключиться к сеансу в этом терминале |399| `claude attach <id>` | Подключиться к сеансу в этом терминале |

354| `claude logs <id>` | Вывести последний вывод сеанса |400| `claude logs <id>` | Вывести последний вывод сеанса |

355| `claude stop <id>` | Остановить сеанс. Также принимает `claude kill` |401| `claude stop <id>` | Остановить сеанс. Также принимает `claude kill` |

356| `claude respawn <id>` | Перезапустить остановленный сеанс с его беседой нетронутой |402| `claude respawn <id>` | Перезапустить сеанс, работающий или остановленный, с его беседой нетронутой, например, чтобы подобрать обновленный бинарный файл Claude Code |

357| `claude respawn --all` | Перезапустить каждый остановленный сеанс |403| `claude respawn --all` | Перезапустить каждый работающий сеанс, например, чтобы переместить все сеансы на обновленный бинарный файл Claude Code одновременно |

358| `claude rm <id>` | Удалить сеанс из списка. Очищает его worktree, если нет незафиксированных изменений |404| `claude rm <id>` | Удалить сеанс и его стенограмму. Удаляет worktree, созданный Claude для сеанса, если в нем нет незафиксированных изменений; в противном случае выводит путь worktree, чтобы вы могли его очистить. Оставляет на месте worktree, созданный вами самостоятельно |

405| `claude daemon status` | Вывести состояние [supervisor](#the-supervisor-process), версию, каталог сокета и количество рабочих процессов |

359 406 

360## Как размещаются фоновые сеансы407## Как размещаются фоновые сеансы

361 408 


383| `~/.claude/daemon/roster.json` | Список работающих фоновых сеансов, используется для переподключения после перезагрузки |430| `~/.claude/daemon/roster.json` | Список работающих фоновых сеансов, используется для переподключения после перезагрузки |

384| `~/.claude/jobs/<id>/state.json` | Состояние для каждого сеанса, показанное в представлении агента |431| `~/.claude/jobs/<id>/state.json` | Состояние для каждого сеанса, показанное в представлении агента |

385 432 

433Чтобы проверить это состояние без прямого чтения файлов, запустите `claude daemon status`. Он сообщает, доступен ли супервизор, его идентификатор процесса и версию, каталог сокета и сколько фоновых сеансов активны. `/doctor` включает сводку той же проверки. В Windows `claude daemon status` выводит основную ошибку файла, когда файл ключа pipe супервизора заблокирован или нечитаем, вместо того чтобы сообщать об общей ошибке подключения.

434 

386### Отключение представления агента435### Отключение представления агента

387 436 

388Чтобы полностью отключить фоновых агентов и представление агента, установите параметр `disableAgentView` [setting](/ru/settings) на `true` или установите переменную окружения `CLAUDE_CODE_DISABLE_AGENT_VIEW`. Администраторы могут применить это через [управляемые настройки](/ru/permissions#managed-settings).437Чтобы полностью отключить фоновых агентов и представление агента, установите параметр `disableAgentView` [setting](/ru/settings) на `true` или установите переменную окружения `CLAUDE_CODE_DISABLE_AGENT_VIEW`. Администраторы могут применить это через [управляемые настройки](/ru/permissions#managed-settings).


397 446 

398### Agent view открывается без сеансов447### Agent view открывается без сеансов

399 448 

400Представление агентов пусто до тех пор, пока вы не отправите свой первый сеанс. Введите подсказку в поле ввода внизу и нажмите `Enter`.449До отправки вашего первого сеанса представление агентов показывает краткую подсказку адаптации с примерами подсказок вместо списка сеансов. Введите подсказку в поле ввода внизу и нажмите `Enter`, чтобы отправить ваш первый сеанс.

401 450 

402### Невозможно открыть агентов, так как выполняются фоновые задачи451### Невозможно открыть агентов, так как выполняются фоновые задачи

403 452 


407 456 

408Поле ввода отправки ожидает описание задачи, а не разговорное начало. Подсказка короче четырёх символов отклоняется с подсказкой `Too short`, чтобы случайное нажатие клавиши не запустило сеанс. Опишите, что вы хотите, чтобы сеанс делал, например `investigate the flaky checkout test`.457Поле ввода отправки ожидает описание задачи, а не разговорное начало. Подсказка короче четырёх символов отклоняется с подсказкой `Too short`, чтобы случайное нажатие клавиши не запустило сеанс. Опишите, что вы хотите, чтобы сеанс делал, например `investigate the flaky checkout test`.

409 458 

410### Сеансы отображаются как неудачные после пробуждения вашей машины459### Сеансы отображаются как неудачные после выключения

460 

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

411 462 

412Фоновые сеансы не выживают при спящем режиме или выключении, поэтому сеансы, которые были запущены, отображаются как неудачные после пробуждения. Подключитесь, посмотрите или ответьте на любой из них, и сеанс перезапустится с того места, где он остановился. Чтобы перезапустить все сразу, запустите `claude respawn --all`.463Спящий режим сам по себе не вызывает это. Сеансы сохраняются во время спящего режима, и супервизор переподключается к ним при пробуждении.

413 464 

414### Сеанс медленно реагирует после подключения465### Сеанс медленно реагирует после подключения

415 466 


417 468 

418### `.claude/worktrees/` заполняется469### `.claude/worktrees/` заполняется

419 470 

420Worktrees удаляются при удалении сеанса, который их создал. Если сеанс завершился без очистки, перечислите оставшиеся записи с помощью `git worktree list` в каталоге проекта и удалите каждую с помощью `git worktree remove <path>`. См. [Clean up worktrees](/ru/worktrees#clean-up-worktrees).471Удаление сеанса в представлении агентов удаляет рабочее дерево, которое Claude создал для него. `claude rm` сохраняет рабочее дерево, которое имеет незафиксированные изменения, и выводит его путь. Перечислите оставшиеся записи с помощью `git worktree list` в каталоге проекта и удалите каждую с помощью `git worktree remove <path>`. См. [Clean up worktrees](/ru/worktrees#clean-up-worktrees).

421 472 

422## Ограничения473## Ограничения

423 474 

424Agent view находится в исследовательском предпросмотре со следующими ограничениями:475Agent view находится в исследовательском предпросмотре со следующими ограничениями:

425 476 

426* **Применяются ограничения скорости**: фоновые сеансы потребляют использование вашей подписки так же, как интерактивные сеансы, поэтому запуск десяти агентов параллельно использует квоту примерно в десять раз быстрее, чем запуск одного.477* **Применяются ограничения скорости**: фоновые сеансы потребляют использование вашей подписки так же, как интерактивные сеансы, поэтому запуск десяти агентов параллельно использует квоту примерно в десять раз быстрее, чем запуск одного.

427* **Сеансы локальны**: фоновые сеансы работают на вашей машине и останавливаются, если она переходит в спящий режим или выключается.478* **Сеансы локальны**: фоновые сеансы работают на вашей машине. Они сохраняются при переходе в спящий режим, но останавливаются при выключении машины.

428* **Worktrees удаляются с сеансом**: объедините или отправьте изменения перед удалением сеанса, который редактировал файлы в его собственном worktree.479* **Worktrees, созданные Claude, удаляются с сеансом в agent view**: объедините или отправьте изменения перед удалением сеанса, который редактировал файлы в его собственном worktree. `claude rm` сохраняет worktree, который имеет незафиксированные изменения; worktree, который вы создали сами, остаётся на месте.

429 480 

430## Связанные ресурсы481## Связанные ресурсы

431 482 

Details

11Вы можете запускать сеансы, передавать содержимое, возобновлять беседы и управлять обновлениями с помощью этих команд:11Вы можете запускать сеансы, передавать содержимое, возобновлять беседы и управлять обновлениями с помощью этих команд:

12 12 

13| Команда | Описание | Пример |13| Команда | Описание | Пример |

14| :------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------- |14| :------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------- |

15| `claude` | Запустить интерактивный сеанс | `claude` |15| `claude` | Запустить интерактивный сеанс | `claude` |

16| `claude "query"` | Запустить интерактивный сеанс с начальным запросом | `claude "explain this project"` |16| `claude "query"` | Запустить интерактивный сеанс с начальным запросом | `claude "explain this project"` |

17| `claude -p "query"` | Запрос через SDK, затем выход | `claude -p "explain this function"` |17| `claude -p "query"` | Запрос через SDK, затем выход | `claude -p "explain this function"` |


24| `claude auth login` | Войти в свою учетную запись Anthropic. Используйте `--email` для предварительного заполнения адреса электронной почты, `--sso` для принудительной аутентификации SSO и `--console` для входа с помощью Anthropic Console для выставления счетов за использование API вместо подписки Claude | `claude auth login --console` |24| `claude auth login` | Войти в свою учетную запись Anthropic. Используйте `--email` для предварительного заполнения адреса электронной почты, `--sso` для принудительной аутентификации SSO и `--console` для входа с помощью Anthropic Console для выставления счетов за использование API вместо подписки Claude | `claude auth login --console` |

25| `claude auth logout` | Выйти из своей учетной записи Anthropic | `claude auth logout` |25| `claude auth logout` | Выйти из своей учетной записи Anthropic | `claude auth logout` |

26| `claude auth status` | Показать статус аутентификации в формате JSON. Используйте `--text` для удобочитаемого вывода. Выходит с кодом 0, если вы вошли, 1, если нет | `claude auth status` |26| `claude auth status` | Показать статус аутентификации в формате JSON. Используйте `--text` для удобочитаемого вывода. Выходит с кодом 0, если вы вошли, 1, если нет | `claude auth status` |

27| `claude agents` | Открыть [представление агентов](/ru/agent-view) для мониторинга и отправки параллельных фоновых сеансов. Используйте `--cwd <path>` для отображения только сеансов, запущенных в этом каталоге | `claude agents` |27| `claude agents` | Открыть [представление агентов](/ru/agent-view) для мониторинга и отправки параллельных фоновых сеансов. Используйте `--cwd <path>` для отображения только сеансов, запущенных в этом каталоге. Передайте `--permission-mode`, `--model` или `--effort` для установки [значений по умолчанию для отправленных сеансов](/ru/agent-view#permission-mode-model-and-effort). Принимает `--settings`, `--add-dir`, `--plugin-dir` и `--mcp-config` как команда верхнего уровня `claude`. Требует интерактивный терминал | `claude agents --cwd ~/projects/my-app` |

28| `claude attach <id>` | Подключиться к [фоновому сеансу](/ru/agent-view#manage-sessions-from-the-shell) в этом терминале | `claude attach 7c5dcf5d` |28| `claude attach <id>` | Подключиться к [фоновому сеансу](/ru/agent-view#manage-sessions-from-the-shell) в этом терминале | `claude attach 7c5dcf5d` |

29| `claude auto-mode defaults` | Вывести встроенные правила классификатора [auto mode](/ru/permission-modes#eliminate-prompts-with-auto-mode) в формате JSON. Используйте `claude auto-mode config` для просмотра вашей эффективной конфигурации с применяемыми параметрами | `claude auto-mode defaults > rules.json` |29| `claude auto-mode defaults` | Вывести встроенные правила классификатора [auto mode](/ru/permission-modes#eliminate-prompts-with-auto-mode) в формате JSON. Используйте `claude auto-mode config` для просмотра вашей эффективной конфигурации с применяемыми параметрами | `claude auto-mode defaults > rules.json` |

30| `claude daemon status` | Вывести состояние [супервизора](/ru/agent-view#the-supervisor-process) фонового сеанса, версию, каталог сокета и количество рабочих процессов для диагностики. Выходит с кодом 1, если супервизор не запущен | `claude daemon status` |

30| `claude logs <id>` | Вывести недавний вывод из [фонового сеанса](/ru/agent-view#manage-sessions-from-the-shell) | `claude logs 7c5dcf5d` |31| `claude logs <id>` | Вывести недавний вывод из [фонового сеанса](/ru/agent-view#manage-sessions-from-the-shell) | `claude logs 7c5dcf5d` |

31| `claude mcp` | Настроить серверы Model Context Protocol (MCP) | См. [документацию Claude Code MCP](/ru/mcp). |32| `claude mcp` | Настроить серверы Model Context Protocol (MCP) | См. [документацию Claude Code MCP](/ru/mcp). |

32| `claude plugin` | Управлять Claude Code [plugins](/ru/plugins). Псевдоним: `claude plugins`. См. [справочник plugins](/ru/plugins-reference#cli-commands-reference) для подкоманд | `claude plugin install code-review@claude-plugins-official` |33| `claude plugin` | Управлять Claude Code [plugins](/ru/plugins). Псевдоним: `claude plugins`. См. [справочник plugins](/ru/plugins-reference#cli-commands-reference) для подкоманд | `claude plugin install code-review@claude-plugins-official` |

33| `claude project purge [path]` | Удалить все локальное состояние Claude Code для проекта: стенограммы, списки задач, журналы отладки, историю редактирования файлов, строки истории подсказок и запись проекта в `~/.claude.json`. Опустите `[path]` для выбора из интерактивного списка. Флаги: `--dry-run` для предпросмотра, `-y`/`--yes` для пропуска подтверждения, `-i`/`--interactive` для подтверждения каждого элемента, `--all` для каждого проекта. См. [Очистить локальные данные](/ru/claude-directory#clear-local-data) | `claude project purge ~/work/repo --dry-run` |34| `claude project purge [path]` | Удалить все локальное состояние Claude Code для проекта: стенограммы, списки задач, журналы отладки, историю редактирования файлов, строки истории подсказок и запись проекта в `~/.claude.json`. Опустите `[path]` для выбора из интерактивного списка. Флаги: `--dry-run` для предпросмотра, `-y`/`--yes` для пропуска подтверждения, `-i`/`--interactive` для подтверждения каждого элемента, `--all` для каждого проекта. См. [Очистить локальные данные](/ru/claude-directory#clear-local-data) | `claude project purge ~/work/repo --dry-run` |

34| `claude remote-control` | Запустить сервер [Remote Control](/ru/remote-control) для управления Claude Code из Claude.ai или приложения Claude. Работает в режиме сервера (без локального интерактивного сеанса). См. [флаги режима сервера](/ru/remote-control#start-a-remote-control-session) | `claude remote-control --name "My Project"` |35| `claude remote-control` | Запустить сервер [Remote Control](/ru/remote-control) для управления Claude Code из Claude.ai или приложения Claude. Работает в режиме сервера (без локального интерактивного сеанса). См. [флаги режима сервера](/ru/remote-control#start-a-remote-control-session) | `claude remote-control --name "My Project"` |

35| `claude respawn <id>` | Перезапустить остановленный [фоновый сеанс](/ru/agent-view#manage-sessions-from-the-shell) с сохранением его беседы. Используйте `--all` для перезапуска каждого остановленного сеанса | `claude respawn 7c5dcf5d` |36| `claude respawn <id>` | Перезапустить [фоновый сеанс](/ru/agent-view#manage-sessions-from-the-shell), работающий или остановленный, с сохранением его беседы. Используйте `--all` для перезапуска каждого работающего сеанса, например для применения обновленного двоичного файла Claude Code | `claude respawn 7c5dcf5d` |

36| `claude rm <id>` | Удалить [фоновый сеанс](/ru/agent-view#manage-sessions-from-the-shell) из списка | `claude rm 7c5dcf5d` |37| `claude rm <id>` | Удалить [фоновый сеанс](/ru/agent-view#manage-sessions-from-the-shell) из списка | `claude rm 7c5dcf5d` |

37| `claude setup-token` | Создать долгоживущий OAuth токен для CI и скриптов. Выводит токен в терминал без сохранения. Требует подписку Claude. См. [Создать долгоживущий токен](/ru/authentication#generate-a-long-lived-token) | `claude setup-token` |38| `claude setup-token` | Создать долгоживущий OAuth токен для CI и скриптов. Выводит токен в терминал без сохранения. Требует подписку Claude. См. [Создать долгоживущий токен](/ru/authentication#generate-a-long-lived-token) | `claude setup-token` |

38| `claude stop <id>` | Остановить [фоновый сеанс](/ru/agent-view#manage-sessions-from-the-shell). Также принимает `claude kill` | `claude stop 7c5dcf5d` |39| `claude stop <id>` | Остановить [фоновый сеанс](/ru/agent-view#manage-sessions-from-the-shell). Также принимает `claude kill` | `claude stop 7c5dcf5d` |


68| `--effort` | Установить [уровень усилий](/ru/model-config#adjust-effort-level) для текущего сеанса. Опции: `low`, `medium`, `high`, `xhigh`, `max`; доступные уровни зависят от модели. Переопределяет параметр [`effortLevel`](/ru/settings#available-settings) для этого сеанса и не сохраняется | `claude --effort high` |69| `--effort` | Установить [уровень усилий](/ru/model-config#adjust-effort-level) для текущего сеанса. Опции: `low`, `medium`, `high`, `xhigh`, `max`; доступные уровни зависят от модели. Переопределяет параметр [`effortLevel`](/ru/settings#available-settings) для этого сеанса и не сохраняется | `claude --effort high` |

69| `--enable-auto-mode` | {/* max-version: 2.1.110 */}Удалено в v2.1.111. Auto mode теперь находится в цикле `Shift+Tab` по умолчанию; используйте `--permission-mode auto` для запуска в нем | `claude --permission-mode auto` |70| `--enable-auto-mode` | {/* max-version: 2.1.110 */}Удалено в v2.1.111. Auto mode теперь находится в цикле `Shift+Tab` по умолчанию; используйте `--permission-mode auto` для запуска в нем | `claude --permission-mode auto` |

70| `--exclude-dynamic-system-prompt-sections` | Переместить разделы для каждой машины из системного приглашения (рабочий каталог, информация об окружении, пути памяти, статус git) в первое пользовательское сообщение. Улучшает повторное использование prompt-cache на разных пользователях и машинах, запускающих одну и ту же задачу. Применяется только с системным приглашением по умолчанию; игнорируется, когда установлены `--system-prompt` или `--system-prompt-file`. Используйте с `-p` для скриптовых многопользовательских рабочих нагрузок | `claude -p --exclude-dynamic-system-prompt-sections "query"` |71| `--exclude-dynamic-system-prompt-sections` | Переместить разделы для каждой машины из системного приглашения (рабочий каталог, информация об окружении, пути памяти, статус git) в первое пользовательское сообщение. Улучшает повторное использование prompt-cache на разных пользователях и машинах, запускающих одну и ту же задачу. Применяется только с системным приглашением по умолчанию; игнорируется, когда установлены `--system-prompt` или `--system-prompt-file`. Используйте с `-p` для скриптовых многопользовательских рабочих нагрузок | `claude -p --exclude-dynamic-system-prompt-sections "query"` |

71| `--fallback-model` | Включить автоматический переход на указанную модель, когда модель по умолчанию перегружена (только режим печати) | `claude -p --fallback-model sonnet "query"` |72| `--fallback-model` | Включить автоматический переход на указанную модель, когда модель по умолчанию перегружена. Вступает в силу в режиме печати (`-p`) и в [фоновых сеансах](/ru/agent-view), которые работают неинтерактивно; игнорируется в интерактивном сеансе | `claude -p --fallback-model sonnet "query"` |

72| `--fork-session` | При возобновлении создать новый ID сеанса вместо повторного использования исходного (используйте с `--resume` или `--continue`) | `claude --resume abc123 --fork-session` |73| `--fork-session` | При возобновлении создать новый ID сеанса вместо повторного использования исходного (используйте с `--resume` или `--continue`) | `claude --resume abc123 --fork-session` |

73| `--from-pr` | Возобновить сеансы, связанные с конкретным pull request. Принимает номер PR, URL GitHub или GitHub Enterprise PR, URL GitLab merge request или URL Bitbucket pull request. Сеансы автоматически связываются при создании Claude pull request | `claude --from-pr 123` |74| `--from-pr` | Возобновить сеансы, связанные с конкретным pull request. Принимает номер PR, URL GitHub или GitHub Enterprise PR, URL GitLab merge request или URL Bitbucket pull request. Сеансы автоматически связываются при создании Claude pull request | `claude --from-pr 123` |

74| `--ide` | Автоматически подключиться к IDE при запуске, если доступна ровно одна действительная IDE | `claude --ide` |75| `--ide` | Автоматически подключиться к IDE при запуске, если доступна ровно одна действительная IDE | `claude --ide` |

code-review.md +3 −3

Details

29 29 

30После того как администратор [включит Code Review](#set-up-code-review) для вашей организации, проверки запускаются при открытии PR, при каждом push или при ручном запросе в зависимости от настроенного поведения репозитория. Комментарий `@claude review` [запускает проверки на PR](#manually-trigger-reviews) в любом режиме.30После того как администратор [включит Code Review](#set-up-code-review) для вашей организации, проверки запускаются при открытии PR, при каждом push или при ручном запросе в зависимости от настроенного поведения репозитория. Комментарий `@claude review` [запускает проверки на PR](#manually-trigger-reviews) в любом режиме.

31 31 

32Когда запускается проверка, несколько агентов параллельно анализируют diff и окружающий код на инфраструктуре Anthropic. Каждый агент ищет другой класс проблем, затем этап проверки проверяет кандидатов на соответствие фактическому поведению кода, чтобы отфильтровать ложные срабатывания. Результаты дедублицируются, ранжируются по степени серьёзности и публикуются в виде встроенных комментариев на конкретных строках, где были обнаружены проблемы, с кратким резюме в теле проверки. Если проблемы не найдены, Claude публикует краткий подтверждающий комментарий на PR.32Когда запускается проверка, несколько агентов параллельно анализируют diff и окружающий код на инфраструктуре Anthropic. Каждый агент ищет другой класс проблем, затем этап проверки проверяет кандидатов на соответствие фактическому поведению кода, чтобы отфильтровать ложные срабатывания. Результаты дедублицируются, ранжируются по степени серьёзности и публикуются в виде встроенных комментариев на конкретных строках, где были обнаружены проблемы, с кратким резюме в теле проверки. Если проблемы не найдены, Code Review обновляет проверку GitHub, чтобы показать, что проблемы не обнаружены. Claude также может опубликовать краткий подтверждающий комментарий на PR.

33 33 

34Проверки масштабируются по стоимости в зависимости от размера и сложности PR, в среднем завершаясь за 20 минут. Администраторы могут отслеживать активность проверок и расходы через [панель аналитики](#view-usage).34Проверки масштабируются по стоимости в зависимости от размера и сложности PR, в среднем завершаясь за 20 минут. Администраторы могут отслеживать активность проверок и расходы через [панель аналитики](#view-usage).

35 35 


49 49 

50Каждый комментарий проверки от Claude поступает с уже прикреплёнными 👍 и 👎, поэтому обе кнопки появляются в пользовательском интерфейсе GitHub для одноклассного рейтинга. Нажмите 👍, если результат был полезен, или 👎, если он был неправильным или шумным. Anthropic собирает количество реакций после слияния PR и использует их для настройки рецензента. Реакции не запускают повторную проверку и не изменяют ничего на PR.50Каждый комментарий проверки от Claude поступает с уже прикреплёнными 👍 и 👎, поэтому обе кнопки появляются в пользовательском интерфейсе GitHub для одноклассного рейтинга. Нажмите 👍, если результат был полезен, или 👎, если он был неправильным или шумным. Anthropic собирает количество реакций после слияния PR и использует их для настройки рецензента. Реакции не запускают повторную проверку и не изменяют ничего на PR.

51 51 

52Ответ на встроенный комментарий не побуждает Claude ответить или обновить PR. Чтобы действовать на основе результата, исправьте код и push. Если PR подписан на проверки, запускаемые при push, следующий запуск разрешает поток при исправлении проблемы. Чтобы запросить свежую проверку без push, прокомментируйте `@claude review once` как [комментарий верхнего уровня PR](#manually-trigger-reviews).52Ответ на встроенный комментарий не побуждает Claude ответить или обновить PR. Чтобы действовать на основе результата, исправьте код и выполните push. Если PR подписан на проверки, запускаемые при push, следующий запуск разрешает поток при исправлении проблемы. Чтобы запросить свежую проверку без push, прокомментируйте `@claude review once` как [комментарий верхнего уровня PR](#manually-trigger-reviews).

53 53 

54### Вывод проверки54### Вывод проверки

55 55 


230 230 

231## Цены231## Цены

232 232 

233Code Review выставляется счёт на основе использования токенов. Каждая проверка в среднем стоит \$15-25, масштабируясь в зависимости от размера PR, сложности кодовой базы и количества проблем, требующих проверки. Использование Code Review выставляется отдельно через [дополнительное использование](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) и не учитывается в использовании, включённом в ваш план.233Code Review выставляется счёт на основе использования токенов. Каждая проверка в среднем стоит \$15-25, масштабируясь в зависимости от размера PR, сложности кодовой базы и количества проблем, требующих проверки. Использование Code Review выставляется отдельно через [дополнительное использование](https://support.claude.com/ru/articles/12429409-extra-usage-for-paid-claude-plans) и не учитывается в использовании, включённом в ваш план.

234 234 

235Выбранный вами триггер проверки влияет на общую стоимость:235Выбранный вами триггер проверки влияет на общую стоимость:

236 236 

commands.md +1 −1

Details

63| `/effort [level\|auto]` | Установить [уровень усилий](/ru/model-config#adjust-effort-level) модели. Принимает `low`, `medium`, `high`, `xhigh` или `max`; доступные уровни зависят от модели, и `max` применяется только к сеансу. `auto` сбрасывает значение по умолчанию модели. Без аргумента открывает интерактивный ползунок; используйте стрелки влево и вправо для выбора уровня и `Enter` для применения. Вступает в силу немедленно без ожидания завершения текущего ответа |63| `/effort [level\|auto]` | Установить [уровень усилий](/ru/model-config#adjust-effort-level) модели. Принимает `low`, `medium`, `high`, `xhigh` или `max`; доступные уровни зависят от модели, и `max` применяется только к сеансу. `auto` сбрасывает значение по умолчанию модели. Без аргумента открывает интерактивный ползунок; используйте стрелки влево и вправо для выбора уровня и `Enter` для применения. Вступает в силу немедленно без ожидания завершения текущего ответа |

64| `/exit` | Выход из CLI. В подключенном [фоновом сеансе](/ru/agent-view#attach-to-a-session) это отсоединяет и сеанс продолжает работать. Псевдоним: `/quit` |64| `/exit` | Выход из CLI. В подключенном [фоновом сеансе](/ru/agent-view#attach-to-a-session) это отсоединяет и сеанс продолжает работать. Псевдоним: `/quit` |

65| `/export [filename]` | Экспортировать текущую беседу как простой текст. С именем файла записывает непосредственно в этот файл. Без имени открывает диалог для копирования в буфер обмена или сохранения в файл |65| `/export [filename]` | Экспортировать текущую беседу как простой текст. С именем файла записывает непосредственно в этот файл. Без имени открывает диалог для копирования в буфер обмена или сохранения в файл |

66| `/extra-usage` | Настроить дополнительное использование для продолжения работы при достижении ограничений скорости |

67| `/fast [on\|off]` | Переключить [быстрый режим](/ru/fast-mode) включен или выключен |66| `/fast [on\|off]` | Переключить [быстрый режим](/ru/fast-mode) включен или выключен |

68| `/feedback [report]` | Отправить отзыв о Claude Code. Псевдоним: `/bug` |67| `/feedback [report]` | Отправить отзыв о Claude Code. Псевдоним: `/bug` |

69| `/fewer-permission-prompts` | **[Skill](/ru/skills#bundled-skills).** Сканировать ваши стенограммы на предмет распространенных вызовов инструментов Bash и MCP только для чтения, затем добавить приоритизированный список разрешений в проект `.claude/settings.json` для уменьшения запросов разрешений |68| `/fewer-permission-prompts` | **[Skill](/ru/skills#bundled-skills).** Сканировать ваши стенограммы на предмет распространенных вызовов инструментов Bash и MCP только для чтения, затем добавить приоритизированный список разрешений в проект `.claude/settings.json` для уменьшения запросов разрешений |


125| `/ultrareview [PR]` | Запустить глубокий многоагентный просмотр кода в облачной песочнице с [ultrareview](/ru/ultrareview). Включает 3 бесплатных запуска на Pro и Max, затем требует [дополнительное использование](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |124| `/ultrareview [PR]` | Запустить глубокий многоагентный просмотр кода в облачной песочнице с [ultrareview](/ru/ultrareview). Включает 3 бесплатных запуска на Pro и Max, затем требует [дополнительное использование](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |

126| `/upgrade` | Открыть страницу обновления для переключения на более высокий уровень плана |125| `/upgrade` | Открыть страницу обновления для переключения на более высокий уровень плана |

127| `/usage` | Показать стоимость сеанса, ограничения использования плана и статистику активности. См. [руководство по отслеживанию затрат](/ru/costs#using-the-%2Fusage-command) для деталей, специфичных для подписки. `/cost` и `/stats` являются псевдонимами |126| `/usage` | Показать стоимость сеанса, ограничения использования плана и статистику активности. См. [руководство по отслеживанию затрат](/ru/costs#using-the-%2Fusage-command) для деталей, специфичных для подписки. `/cost` и `/stats` являются псевдонимами |

127| `/usage-credits` | Настроить дополнительное использование для продолжения работы при достижении ограничений. Ранее `/extra-usage` |

128| `/vim` | {/* max-version: 2.1.91 */}Удалено в v2.1.92. Для переключения между режимами редактирования Vim и Normal используйте `/config` → Editor mode |128| `/vim` | {/* max-version: 2.1.91 */}Удалено в v2.1.92. Для переключения между режимами редактирования Vim и Normal используйте `/config` → Editor mode |

129| `/voice [hold\|tap\|off]` | Переключить [диктовку голосом](/ru/voice-dictation) или включить ее в определенном режиме. Требует учетную запись Claude.ai |129| `/voice [hold\|tap\|off]` | Переключить [диктовку голосом](/ru/voice-dictation) или включить ее в определенном режиме. Требует учетную запись Claude.ai |

130| `/web-setup` | Подключить вашу учетную запись GitHub к [Claude Code в веб-браузере](/ru/web-quickstart#connect-from-your-terminal) используя учетные данные вашего локального CLI `gh`. `/schedule` автоматически запрашивает это, если GitHub не подключен |130| `/web-setup` | Подключить вашу учетную запись GitHub к [Claude Code в веб-браузере](/ru/web-quickstart#connect-from-your-terminal) используя учетные данные вашего локального CLI `gh`. `/schedule` автоматически запрашивает это, если GitHub не подключен |

Details

87Большинство сюрпризов конфигурации восходят к небольшому набору правил расположения и синтаксиса. Проверьте их перед тем, как предположить ошибку:87Большинство сюрпризов конфигурации восходят к небольшому набору правил расположения и синтаксиса. Проверьте их перед тем, как предположить ошибку:

88 88 

89| Симптом | Причина | Исправление |89| Симптом | Причина | Исправление |

90| :--------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |90| :--------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

91| Hook никогда не срабатывает | `matcher` — это JSON массив вместо строки | Используйте одну строку с `\|` для соответствия нескольким tools, например `"Edit\|Write"`. См. [matcher patterns](/ru/hooks#matcher-patterns). |91| Hook никогда не срабатывает | `matcher` — это JSON массив вместо строки | Используйте одну строку с `\|` для соответствия нескольким tools, например `"Edit\|Write"`. См. [matcher patterns](/ru/hooks#matcher-patterns). |

92| Hook никогда не срабатывает | значение `matcher` в нижнем регистре, например `"bash"` | Соответствие чувствительно к регистру. Имена tools написаны с заглавной буквы: `Bash`, `Edit`, `Write`, `Read`. |92| Hook никогда не срабатывает | значение `matcher` в нижнем регистре, например `"bash"` | Соответствие чувствительно к регистру. Имена tools написаны с заглавной буквы: `Bash`, `Edit`, `Write`, `Read`. |

93| Hook никогда не срабатывает | Hooks находятся в отдельном файле `.claude/hooks.json` | Нет отдельного файла hooks. Определите hooks под ключом `"hooks"` в `settings.json`. См. [hook configuration](/ru/hooks). |93| Hook никогда не срабатывает | Hooks находятся в отдельном файле вместо `settings.json` | Нет отдельного файла hooks для конфигурации проекта или пользователя. Определите hooks под ключом `"hooks"` в `settings.json`. Только [plugins](/ru/plugins-reference#hooks) загружают отдельный `hooks/hooks.json`. См. [hook configuration](/ru/hooks). |

94| Permissions, hooks или env, установленные глобально, игнорируются | Конфигурация была добавлена в `~/.claude.json` | `~/.claude.json` содержит состояние приложения и переключатели UI. `permissions`, `hooks` и `env` принадлежат `~/.claude/settings.json`. Это два разных файла. |94| Permissions, hooks или env, установленные глобально, игнорируются | Конфигурация была добавлена в `~/.claude.json` | `~/.claude.json` содержит состояние приложения и переключатели UI. `permissions`, `hooks` и `env` принадлежат `~/.claude/settings.json`. Это два разных файла. |

95| Значение `settings.json` кажется игнорируемым | Тот же ключ установлен в `settings.local.json` | `settings.local.json` переопределяет `settings.json`, и оба переопределяют `~/.claude/settings.json`. См. [settings precedence](/ru/settings#how-scopes-interact). |95| Значение `settings.json` кажется игнорируемым | Тот же ключ установлен в `settings.local.json` | `settings.local.json` переопределяет `settings.json`, и оба переопределяют `~/.claude/settings.json`. См. [settings precedence](/ru/settings#how-scopes-interact). |

96| Skill не появляется в `/skills` | Файл skill находится в `.claude/skills/name.md` вместо папки | Используйте папку с `SKILL.md` внутри: `.claude/skills/name/SKILL.md`. |96| Skill не появляется в `/skills` | Файл skill находится в `.claude/skills/name.md` вместо папки | Используйте папку с `SKILL.md` внутри: `.claude/skills/name/SKILL.md`. |

97| Skill появляется в `/skills`, но Claude никогда его не вызывает | Skill имеет `disable-model-invocation: true` в своём frontmatter или его описание не совпадает с тем, как вы формулируете запрос | Проверьте значок в `/skills`: метка "user-only" означает, что Claude не будет его запускать самостоятельно. См. [skill invocation](/ru/skills). |97| Skill появляется в `/skills`, но Claude никогда его не вызывает | Skill имеет `disable-model-invocation: true` в своём frontmatter или его описание не совпадает с тем, как вы формулируете запрос | Проверьте значок в `/skills`: метка "user-only" означает, что Claude не будет его запускать самостоятельно. См. [skill invocation](/ru/skills). |

98| Инструкции в подпапке `CLAUDE.md` кажутся игнорируемыми | Файлы подпапок загружаются по требованию, а не при запуске сессии | Они загружаются, когда Claude читает файл в этой папке с помощью инструмента Read, а не при запуске и не при записи или создании файлов там. См. [как загружаются файлы CLAUDE.md](/ru/memory#how-claude-md-files-load). |98| Инструкции в подпапке `CLAUDE.md` кажутся игнорируемыми | Файлы подпапок загружаются по требованию, а не при запуске сессии | Они загружаются, когда Claude читает файл в этой папке с помощью инструмента Read, а не при запуске и не при записи или создании файлов там. См. [как загружаются файлы CLAUDE.md](/ru/memory#how-claude-md-files-load). |

99| Subagent игнорирует инструкции `CLAUDE.md` | Subagents не всегда наследуют память проекта | Поместите критические правила в тело файла агента, которое становится системным prompt subagent. См. [subagent configuration](/ru/sub-agents). |99| Subagent игнорирует инструкции `CLAUDE.md` | Встроенные агенты Explore и Plan пропускают `CLAUDE.md`. Пользовательские subagents загружают его так же, как основной диалог | Для Explore или Plan переформулируйте инструкцию в своём делегирующем prompt. Для пользовательского subagent поместите критические инструкции в тело файла агента, которое становится системным prompt агента. См. [что загружается при запуске](/ru/sub-agents#what-loads-at-startup). |

100| Логика очистки никогда не запускается в конце сессии | Нет настроенного `SessionEnd` hook | Добавьте `SessionEnd` hook в `settings.json`. См. [hook events list](/ru/hooks#hook-events). |100| Логика очистки никогда не запускается в конце сессии | Нет настроенного `SessionEnd` hook | Добавьте `SessionEnd` hook в `settings.json`. См. [hook events list](/ru/hooks#hook-events). |

101| MCP серверы в `.mcp.json` никогда не загружаются | Файл находится под `.claude/` или использует формат конфигурации Claude Desktop | Конфигурация MCP проекта находится в корне репозитория как `.mcp.json`, а не внутри `.claude/`. См. [MCP configuration](/ru/mcp). |101| MCP серверы в `.mcp.json` никогда не загружаются | Файл находится под `.claude/` или использует формат конфигурации Claude Desktop | Конфигурация MCP проекта находится в корне репозитория как `.mcp.json`, а не внутри `.claude/`. См. [MCP configuration](/ru/mcp). |

102| MCP серверы добавлены под `mcpServers` в `settings.json`, но никогда не появляются | `settings.json` не читает ключ `mcpServers` | Определите серверы проекта в `.mcp.json` в корне репозитория или запустите `claude mcp add --scope user` для серверов с областью пользователя. См. [MCP configuration](/ru/mcp). |102| MCP серверы добавлены под `mcpServers` в `settings.json`, но никогда не появляются | `settings.json` не читает ключ `mcpServers` | Определите серверы проекта в `.mcp.json` в корне репозитория или запустите `claude mcp add --scope user` для серверов с областью пользователя. См. [MCP configuration](/ru/mcp). |

desktop.md +2 −1

Details

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.3> Use this file to discover all available pages before exploring further.

4 4 

5# Использование Claude Code Desktop5# Настольное приложение

6 6 

7> Получите больше возможностей от Claude Code Desktop: параллельные сеансы с изоляцией Git, макет панелей с перетаскиванием, интегрированный терминал и редактор файлов, боковые чаты, использование компьютера, отправка сеансов со своего телефона, визуальный просмотр различий, предпросмотр приложений, мониторинг PR, коннекторы и конфигурация для предприятий.7> Получите больше возможностей от Claude Code Desktop: параллельные сеансы с изоляцией Git, макет панелей с перетаскиванием, интегрированный терминал и редактор файлов, боковые чаты, использование компьютера, отправка сеансов со своего телефона, визуальный просмотр различий, предпросмотр приложений, мониторинг PR, коннекторы и конфигурация для предприятий.

8 8 


707* **Linux**: приложение desktop доступно только на macOS и Windows. На Linux используйте [CLI](/ru/quickstart).707* **Linux**: приложение desktop доступно только на macOS и Windows. На Linux используйте [CLI](/ru/quickstart).

708* **Встроенные предложения кода**: Desktop не предоставляет предложения в стиле автодополнения. Это работает через разговорные подсказки и явные изменения кода.708* **Встроенные предложения кода**: Desktop не предоставляет предложения в стиле автодополнения. Это работает через разговорные подсказки и явные изменения кода.

709* **Команды агентов**: оркестровка мультиагентов доступна через [CLI](/ru/agent-teams) и [Agent SDK](/ru/headless), не в Desktop.709* **Команды агентов**: оркестровка мультиагентов доступна через [CLI](/ru/agent-teams) и [Agent SDK](/ru/headless), не в Desktop.

710* **Команды диалога терминала**: встроенные команды, которые открывают интерактивную панель в терминале, такие как `/permissions`, `/config`, `/agents` и `/doctor`, недоступны на вкладке Code и отвечают сообщением `isn't available in this environment`. Отредактируйте [файлы параметров](/ru/settings) напрямую, чтобы управлять правилами разрешений и конфигурацией, или запустите команду из автономного CLI.

710 711 

711## Устранение неполадок712## Устранение неполадок

712 713 

Details

138 </Step>138 </Step>

139 139 

140 <Step title="Установите плагин">140 <Step title="Установите плагин">

141 Выберите плагин для просмотра его деталей, затем выберите область установки:141 Выберите плагин для просмотра его деталей. {/* min-version: 2.1.143 */}На Claude Code v2.1.143 и более поздних версиях панель деталей включает оценку **Context cost**, чтобы вы могли увидеть, сколько токенов плагин добавит к вашему [окну контекста](/ru/features-overview#understand-context-costs) каждый ход перед установкой.

142 

143 Выберите область установки:

142 144 

143 * **User scope**: установите для себя во всех проектах145 * **User scope**: установите для себя во всех проектах

144 * **Project scope**: установите для всех сотрудников в этом репозитории146 * **Project scope**: установите для всех сотрудников в этом репозитории

env-vars.md +12 −9

Details

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

101| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Управляет потоковой передачей входных данных инструмента с тонкой зернистостью из API по мере их создания Claude. С этим отключением большой входной параметр инструмента, такой как длинная запись файла, поступает только после завершения создания Claude, что может выглядеть как зависание. Включено по умолчанию на Anthropic API. На Bedrock и Vertex включено для каждой модели, где развёрнутый контейнер это поддерживает. Установите на `0`, чтобы отказаться. Установите на `1`, чтобы принудительно включить при маршрутизации через прокси через `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` или `ANTHROPIC_BEDROCK_BASE_URL`. Отключено по умолчанию на Foundry и соединениях [шлюза](/ru/llm-gateway) |101| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Управляет потоковой передачей входных данных инструмента с тонкой зернистостью из API по мере их создания Claude. С этим отключением большой входной параметр инструмента, такой как длинная запись файла, поступает только после завершения создания Claude, что может выглядеть как зависание. Включено по умолчанию на Anthropic API. На Bedrock и Vertex включено для каждой модели, где развёрнутый контейнер это поддерживает. Установите на `0`, чтобы отказаться. Установите на `1`, чтобы принудительно включить при маршрутизации через прокси через `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` или `ANTHROPIC_BEDROCK_BASE_URL`. Отключено по умолчанию на Foundry и соединениях [шлюза](/ru/llm-gateway) |

102| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Установите на `1`, чтобы заполнить средство выбора `/model` из конечной точки `/v1/models` вашего шлюза, когда `ANTHROPIC_BASE_URL` указывает на совместимый с Anthropic шлюз, такой как LiteLLM, Kong или внутренний прокси. Отключено по умолчанию, потому что шлюзы, поддерживаемые общим ключом API, в противном случае показывали бы каждому пользователю каждую модель, к которой может получить доступ ключ. Обнаруженные модели по-прежнему фильтруются по списку разрешений [`availableModels`](/ru/settings#available-settings) |102| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Установите на `1`, чтобы заполнить средство выбора `/model` из конечной точки `/v1/models` вашего шлюза, когда `ANTHROPIC_BASE_URL` указывает на совместимый с Anthropic шлюз, такой как LiteLLM, Kong или внутренний прокси. Отключено по умолчанию, потому что шлюзы, поддерживаемые общим ключом API, в противном случае показывали бы каждому пользователю каждую модель, к которой может получить доступ ключ. Обнаруженные модели по-прежнему фильтруются по списку разрешений [`availableModels`](/ru/settings#available-settings) |

103| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | Установите на `1`, чтобы запустить [быстрый режим](/ru/fast-mode) на Claude Opus 4.7 вместо Opus 4.6. С установленной переменной `/fast` переключается на Opus 4.7; без неё `/fast` продолжает использовать Opus 4.6 |103| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | {/* max-version: 2.1.141 */}Удалено в v2.1.142. [Быстрый режим](/ru/fast-mode) по умолчанию использует Opus 4.7. Установите `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1`, чтобы сохранить Opus 4.6 вместо этого |

104| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Установите на `false`, чтобы отключить предложения приглашений (переключатель "Prompt suggestions" в `/config`). Это затемнённые предсказания, которые появляются в вашем вводе приглашения после ответа Claude. См. [Предложения приглашений](/ru/interactive-mode#prompt-suggestions) |104| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Установите на `false`, чтобы отключить предложения приглашений (переключатель "Prompt suggestions" в `/config`). Это затемнённые предсказания, которые появляются в вашем вводе приглашения после ответа Claude. См. [Предложения приглашений](/ru/interactive-mode#prompt-suggestions) |

105| `CLAUDE_CODE_ENABLE_TASKS` | Установите на `1`, чтобы включить систему отслеживания задач в неинтерактивном режиме (флаг `-p`). Задачи включены по умолчанию в интерактивном режиме. См. [Список задач](/ru/interactive-mode#task-list) |105| `CLAUDE_CODE_ENABLE_TASKS` | Управляет тем, используют ли сессии структурированные инструменты Task (`TaskCreate`, `TaskUpdate`, `TaskGet`, `TaskList`) или устаревший инструмент `TodoWrite`. {/* min-version: 2.1.142 */}Начиная с Claude Code v2.1.142, инструменты Task являются стандартом во всех режимах. Установите на `0`, чтобы вернуться к `TodoWrite`. См. [Список задач](/ru/interactive-mode#task-list) и [Миграция на инструменты Task](/ru/agent-sdk/todo-tracking#migrate-to-task-tools) |

106| `CLAUDE_CODE_ENABLE_TELEMETRY` | Установите на `1`, чтобы включить сбор данных OpenTelemetry для метрик и логирования. Требуется перед настройкой экспортёров OTel. См. [Мониторинг](/ru/monitoring-usage) |106| `CLAUDE_CODE_ENABLE_TELEMETRY` | Установите на `1`, чтобы включить сбор данных OpenTelemetry для метрик и логирования. Требуется перед настройкой экспортёров OTel. См. [Мониторинг](/ru/monitoring-usage) |

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

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


130| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | OAuth токен обновления для аутентификации Claude.ai. При установке `claude auth login` обменивает этот токен напрямую вместо открытия браузера. Требует `CLAUDE_CODE_OAUTH_SCOPES`. Полезно для предоставления аутентификации в автоматизированных сред |130| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | OAuth токен обновления для аутентификации Claude.ai. При установке `claude auth login` обменивает этот токен напрямую вместо открытия браузера. Требует `CLAUDE_CODE_OAUTH_SCOPES`. Полезно для предоставления аутентификации в автоматизированных сред |

131| `CLAUDE_CODE_OAUTH_SCOPES` | Разделённые пробелом OAuth области, с которыми был выдан токен обновления, такие как `"user:profile user:inference user:sessions:claude_code"`. Требуется, когда установлен `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` |131| `CLAUDE_CODE_OAUTH_SCOPES` | Разделённые пробелом OAuth области, с которыми был выдан токен обновления, такие как `"user:profile user:inference user:sessions:claude_code"`. Требуется, когда установлен `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` |

132| `CLAUDE_CODE_OAUTH_TOKEN` | OAuth токен доступа для аутентификации Claude.ai. Альтернатива `/login` для SDK и автоматизированных сред. Имеет приоритет над учётными данными, хранящимися в цепочке ключей. Создайте один с помощью [`claude setup-token`](/ru/authentication#generate-a-long-lived-token) |132| `CLAUDE_CODE_OAUTH_TOKEN` | OAuth токен доступа для аутентификации Claude.ai. Альтернатива `/login` для SDK и автоматизированных сред. Имеет приоритет над учётными данными, хранящимися в цепочке ключей. Создайте один с помощью [`claude setup-token`](/ru/authentication#generate-a-long-lived-token) |

133| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Установите на `1`, чтобы сохранить [быстрый режим](/ru/fast-mode) на Claude Opus 4.6. Имеет приоритет над `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE`, поэтому установите это, если вам нужно закрепить Opus 4.6 независимо от того, как изменяется значение по умолчанию |133| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Установите на `1`, чтобы сохранить [быстрый режим](/ru/fast-mode) на Claude Opus 4.6 вместо стандартного Opus 4.7. С установленной переменной `/fast` запускается на Opus 4.6. Без неё `/fast` запускается на Opus 4.7 |

134| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Тайм-аут в миллисекундах для очистки ожидающих spans OpenTelemetry (по умолчанию: 5000). См. [Мониторинг](/ru/monitoring-usage) |134| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Тайм-аут в миллисекундах для очистки ожидающих spans OpenTelemetry (по умолчанию: 5000). См. [Мониторинг](/ru/monitoring-usage) |

135| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Интервал для обновления динамических заголовков OpenTelemetry в миллисекундах (по умолчанию: 1740000 / 29 минут). См. [Динамические заголовки](/ru/monitoring-usage#dynamic-headers) |135| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Интервал для обновления динамических заголовков OpenTelemetry в миллисекундах (по умолчанию: 1740000 / 29 минут). См. [Динамические заголовки](/ru/monitoring-usage#dynamic-headers) |

136| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Тайм-аут в миллисекундах для экспортёра OpenTelemetry для завершения при выключении (по умолчанию: 2000). Увеличьте, если метрики отбрасываются при выходе. См. [Мониторинг](/ru/monitoring-usage) |136| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Тайм-аут в миллисекундах для экспортёра OpenTelemetry для завершения при выключении (по умолчанию: 2000). Увеличьте, если метрики отбрасываются при выходе. См. [Мониторинг](/ru/monitoring-usage) |


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

142| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Установите на `1`, чтобы клонировать источники plugin GitHub `owner/repo` через HTTPS вместо SSH. Полезно в CI runners, контейнерах или любой среде без настроенного ключа SSH для `github.com` |142| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Установите на `1`, чтобы клонировать источники plugin GitHub `owner/repo` через HTTPS вместо SSH. Полезно в CI runners, контейнерах или любой среде без настроенного ключа SSH для `github.com` |

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

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

144| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Установлено хост-платформами, которые встраивают Claude Code и управляют маршрутизацией поставщика модели от его имени. При установке переменные выбора поставщика, конечной точки и аутентификации, такие как `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` и `ANTHROPIC_API_KEY` в файлах параметров, игнорируются, поэтому параметры пользователя не могут переопределить маршрутизацию хоста. Автоматический отказ от телеметрии для Bedrock, Vertex и Foundry также пропускается, поэтому телеметрия следует стандартному отказу `DISABLE_TELEMETRY`. См. [Поведение по умолчанию по поставщику API](/ru/data-usage#default-behaviors-by-api-provider) |145| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Установлено хост-платформами, которые встраивают Claude Code и управляют маршрутизацией поставщика модели от его имени. При установке переменные выбора поставщика, конечной точки и аутентификации, такие как `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` и `ANTHROPIC_API_KEY` в файлах параметров, игнорируются, поэтому параметры пользователя не могут переопределить маршрутизацию хоста. Автоматический отказ от телеметрии для Bedrock, Vertex и Foundry также пропускается, поэтому телеметрия следует стандартному отказу `DISABLE_TELEMETRY`. См. [Поведение по умолчанию по поставщику API](/ru/data-usage#default-behaviors-by-api-provider) |

145| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Установите на `1`, чтобы позволить прокси выполнять разрешение DNS вместо вызывающей стороны. Согласитесь для сред, где прокси должен обрабатывать разрешение имён хостов |146| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Установите на `1`, чтобы позволить прокси выполнять разрешение DNS вместо вызывающей стороны. Согласитесь для сред, где прокси должен обрабатывать разрешение имён хостов |

146| `CLAUDE_CODE_REMOTE` | Установите автоматически на `true`, когда Claude Code работает как [облачная сессия](/ru/claude-code-on-the-web). Прочитайте это из hook или скрипта настройки, чтобы обнаружить, находитесь ли вы в облачной среде |147| `CLAUDE_CODE_REMOTE` | Установите автоматически на `true`, когда Claude Code работает как [облачная сессия](/ru/claude-code-on-the-web). Прочитайте это из hook или скрипта настройки, чтобы обнаружить, находитесь ли вы в облачной среде |


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

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

163| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Пропустить аутентификацию Google для Vertex (например, при использовании шлюза LLM) |164| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Пропустить аутентификацию Google для Vertex (например, при использовании шлюза LLM) |

165| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Максимальное количество последовательных раз, когда [Stop](/ru/hooks#stop) или [SubagentStop](/ru/hooks#subagentstop) hook может заблокировать завершение хода перед тем, как Claude Code переопределит его и завершит ход в любом случае (по умолчанию: 8). Установите на `0`, чтобы отключить лимит. Повысьте это, если ваш hook законно нуждается в большем количестве итераций для разрешения |

164| `CLAUDE_CODE_SUBAGENT_MODEL` | См. [Конфигурация модели](/ru/model-config) |166| `CLAUDE_CODE_SUBAGENT_MODEL` | См. [Конфигурация модели](/ru/model-config) |

165| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Установите на `1`, чтобы удалить учётные данные Anthropic и поставщика облачных услуг из сред подпроцессов (инструмент Bash, hooks, MCP stdio servers). Родительский процесс Claude сохраняет эти учётные данные для вызовов API, но дочерние процессы не могут их читать, снижая воздействие атак внедрения приглашений, которые пытаются экспортировать секреты через расширение оболочки. На Linux это также запускает подпроцессы Bash в изолированном пространстве имён PID, поэтому они не могут читать сред хост-процессов через `/proc`; как побочный эффект, `ps`, `pgrep` и `kill` не могут видеть или сигнализировать хост-процессам. `claude-code-action` устанавливает это автоматически, когда настроен `allowed_non_write_users` |167| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Установите на `1`, чтобы удалить учётные данные Anthropic и поставщика облачных услуг из сред подпроцессов (инструмент Bash, hooks, MCP stdio servers). Родительский процесс Claude сохраняет эти учётные данные для вызовов API, но дочерние процессы не могут их читать, снижая воздействие атак внедрения приглашений, которые пытаются экспортировать секреты через расширение оболочки. На Linux это также запускает подпроцессы Bash в изолированном пространстве имён PID, поэтому они не могут читать сред хост-процессов через `/proc`; как побочный эффект, `ps`, `pgrep` и `kill` не могут видеть или сигнализировать хост-процессам. `claude-code-action` устанавливает это автоматически, когда настроен `allowed_non_write_users` |

166| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Установите на `1` в неинтерактивном режиме (флаг `-p`), чтобы дождаться завершения установки plugin перед первым запросом. Без этого plugins устанавливаются в фоне и могут быть недоступны на первом ходу. Объедините с `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS`, чтобы ограничить ожидание |168| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Установите на `1` в неинтерактивном режиме (флаг `-p`), чтобы дождаться завершения установки plugin перед первым запросом. Без этого plugins устанавливаются в фоне и могут быть недоступны на первом ходу. Объедините с `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS`, чтобы ограничить ожидание |


180| `CLAUDE_CONFIG_DIR` | Переопределить каталог конфигурации (по умолчанию: `~/.claude`). Все параметры, учётные данные, история сессии и plugins хранятся под этим путём. Полезно для запуска нескольких учётных записей рядом: например, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` |182| `CLAUDE_CONFIG_DIR` | Переопределить каталог конфигурации (по умолчанию: `~/.claude`). Все параметры, учётные данные, история сессии и plugins хранятся под этим путём. Полезно для запуска нескольких учётных записей рядом: например, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` |

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

182| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Установите на `1`, чтобы принудительно включить сторож простоя на уровне байтов, или установите на `0`, чтобы принудительно отключить его. Если не установлено, сторож включен по умолчанию для соединений Anthropic API. Сторож байтов прерывает соединение, когда на проводе не поступают байты в течение времени, установленного `CLAUDE_STREAM_IDLE_TIMEOUT_MS`, с минимумом 5 минут, независимо от сторожа на уровне событий |184| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Установите на `1`, чтобы принудительно включить сторож простоя на уровне байтов, или установите на `0`, чтобы принудительно отключить его. Если не установлено, сторож включен по умолчанию для соединений Anthropic API. Сторож байтов прерывает соединение, когда на проводе не поступают байты в течение времени, установленного `CLAUDE_STREAM_IDLE_TIMEOUT_MS`, с минимумом 5 минут, независимо от сторожа на уровне событий |

183| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Установите на `1`, чтобы включить сторож простоя потока на уровне событий. Отключено по умолчанию. Для Bedrock, Vertex и Foundry это единственный доступный сторож простоя. Настройте тайм-аут с помощью `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |185| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Установите на `1`, чтобы включить сторож простоя на уровне байтов на ответах Amazon Bedrock `vnd.amazon.eventstream`. Отключено по умолчанию. Настройте тайм-аут с помощью `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |

186| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Установите на `1`, чтобы включить сторож простоя потока на уровне событий. Отключено по умолчанию. Применяется ко всем поставщикам, включая Bedrock. Для Vertex и Foundry это единственный доступный сторож простоя. На Bedrock вы также можете включить независимый сторож на уровне байтов с помощью `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK`; оба работают вместе, когда оба установлены. Настройте тайм-аут с помощью `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |

184| `CLAUDE_ENV_FILE` | Путь к скрипту оболочки, содержимое которого Claude Code запускает перед каждой командой Bash в том же процессе оболочки, поэтому экспорты в файле видны команде. Используйте для сохранения активации virtualenv или conda между командами. Также динамически заполняется [SessionStart](/ru/hooks#persist-environment-variables), [Setup](/ru/hooks#setup), [CwdChanged](/ru/hooks#cwdchanged) и [FileChanged](/ru/hooks#filechanged) hooks |187| `CLAUDE_ENV_FILE` | Путь к скрипту оболочки, содержимое которого Claude Code запускает перед каждой командой Bash в том же процессе оболочки, поэтому экспорты в файле видны команде. Используйте для сохранения активации virtualenv или conda между командами. Также динамически заполняется [SessionStart](/ru/hooks#persist-environment-variables), [Setup](/ru/hooks#setup), [CwdChanged](/ru/hooks#cwdchanged) и [FileChanged](/ru/hooks#filechanged) hooks |

185| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Префикс для автоматически сгенерированных имён сессий [Remote Control](/ru/remote-control), когда явное имя не предоставлено. По умолчанию имя хоста вашей машины, создавая имена, такие как `myhost-graceful-unicorn`. Флаг CLI `--remote-control-session-name-prefix` устанавливает то же значение для одного вызова |188| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Префикс для автоматически сгенерированных имён сессий [Remote Control](/ru/remote-control), когда явное имя не предоставлено. По умолчанию имя хоста вашей машины, создавая имена, такие как `myhost-graceful-unicorn`. Флаг CLI `--remote-control-session-name-prefix` устанавливает то же значение для одного вызова |

186| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Тайм-аут в миллисекундах перед тем, как сторож простоя потока закроет зависшее соединение. По умолчанию и минимум `300000` (5 минут) для сторожа на уровне байтов в Anthropic API; более низкие значения молча ограничиваются, чтобы поглотить паузы расширенного мышления и буферизацию прокси. Для сторожа на уровне событий: по умолчанию `90000` (90 секунд), нет минимума. Для сторонних поставщиков требуется `CLAUDE_ENABLE_STREAM_WATCHDOG=1` |189| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Тайм-аут в миллисекундах перед тем, как сторож простоя потока закроет зависшее соединение. По умолчанию и минимум `300000` (5 минут) для сторожа на уровне байтов в Anthropic API; более низкие значения молча ограничиваются, чтобы поглотить паузы расширенного мышления и буферизацию прокси. Для сторожа на уровне событий: по умолчанию `90000` (90 секунд), нет минимума. Для сторонних поставщиков требуется `CLAUDE_ENABLE_STREAM_WATCHDOG=1`. На Bedrock также применяется, когда `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` |

187| `DEBUG` | Установите на `1`, чтобы включить режим отладки, эквивалент запуска с [`--debug`](/ru/cli-reference#cli-flags). Журналы отладки записываются в `~/.claude/debug/<session-id>.txt`, или в путь, установленный `CLAUDE_CODE_DEBUG_LOGS_DIR`. Только истинные значения `1`, `true`, `yes` и `on` включают режим отладки, поэтому шаблоны пространства имён, такие как `DEBUG=express:*`, установленные для других инструментов, не запускают его |190| `DEBUG` | Установите на `1`, чтобы включить режим отладки, эквивалент запуска с [`--debug`](/ru/cli-reference#cli-flags). Журналы отладки записываются в `~/.claude/debug/<session-id>.txt`, или в путь, установленный `CLAUDE_CODE_DEBUG_LOGS_DIR`. Только истинные значения `1`, `true`, `yes` и `on` включают режим отладки, поэтому шаблоны пространства имён, такие как `DEBUG=express:*`, установленные для других инструментов, не запускают его |

188| `DISABLE_AUTOUPDATER` | Установите на `1`, чтобы отключить автоматические обновления в фоне. Ручная команда `claude update` по-прежнему работает. Используйте `DISABLE_UPDATES`, чтобы заблокировать оба |191| `DISABLE_AUTOUPDATER` | Установите на `1`, чтобы отключить автоматические обновления в фоне. Ручная команда `claude update` по-прежнему работает. Используйте `DISABLE_UPDATES`, чтобы заблокировать оба |

189| `DISABLE_AUTO_COMPACT` | Установите на `1`, чтобы отключить автоматическое сжатие при приближении к лимиту контекста. Команда `/compact` остаётся доступной. Используйте, когда вы хотите явный контроль над тем, когда происходит сжатие |192| `DISABLE_AUTO_COMPACT` | Установите на `1`, чтобы отключить автоматическое сжатие при приближении к лимиту контекста. Команда `/compact` остаётся доступной. Используйте, когда вы хотите явный контроль над тем, когда происходит сжатие |


191| `DISABLE_COST_WARNINGS` | Установите на `1`, чтобы отключить сообщения предупреждения о стоимости |194| `DISABLE_COST_WARNINGS` | Установите на `1`, чтобы отключить сообщения предупреждения о стоимости |

192| `DISABLE_DOCTOR_COMMAND` | Установите на `1`, чтобы скрыть команду `/doctor`. Полезно для управляемых развёртываний, где пользователи не должны запускать диагностику установки |195| `DISABLE_DOCTOR_COMMAND` | Установите на `1`, чтобы скрыть команду `/doctor`. Полезно для управляемых развёртываний, где пользователи не должны запускать диагностику установки |

193| `DISABLE_ERROR_REPORTING` | Установите на `1`, чтобы отказаться от отчётов об ошибках Sentry |196| `DISABLE_ERROR_REPORTING` | Установите на `1`, чтобы отказаться от отчётов об ошибках Sentry |

194| `DISABLE_EXTRA_USAGE_COMMAND` | Установите на `1`, чтобы скрыть команду `/extra-usage`, которая позволяет пользователям приобретать дополнительное использование сверх лимитов скорости |197| `DISABLE_EXTRA_USAGE_COMMAND` | Установите на `1`, чтобы скрыть команду `/usage-credits`, которая позволяет пользователям приобретать дополнительное использование сверх лимитов скорости |

195| `DISABLE_FEEDBACK_COMMAND` | Установите на `1`, чтобы отключить команду `/feedback`. Также принимается старое имя `DISABLE_BUG_COMMAND` |198| `DISABLE_FEEDBACK_COMMAND` | Установите на `1`, чтобы отключить команду `/feedback`. Также принимается старое имя `DISABLE_BUG_COMMAND` |

196| `DISABLE_GROWTHBOOK` | Установите на `1`, чтобы отключить получение флагов функций GrowthBook и использовать значения по умолчанию кода для каждого флага. Логирование событий телеметрии остаётся включённым, если также не установлена переменная `DISABLE_TELEMETRY` |199| `DISABLE_GROWTHBOOK` | Установите на `1`, чтобы отключить получение флагов функций GrowthBook и использовать значения по умолчанию кода для каждого флага. Логирование событий телеметрии остаётся включённым, если также не установлена переменная `DISABLE_TELEMETRY` |

197| `DISABLE_INSTALLATION_CHECKS` | Установите на `1`, чтобы отключить предупреждения об установке. Используйте только при ручном управлении местоположением установки, так как это может скрыть проблемы со стандартными установками |200| `DISABLE_INSTALLATION_CHECKS` | Установите на `1`, чтобы отключить предупреждения об установке. Используйте только при ручном управлении местоположением установки, так как это может скрыть проблемы со стандартными установками |


210| `ENABLE_CLAUDEAI_MCP_SERVERS` | Установите на `false`, чтобы отключить [MCP servers claude.ai](/ru/mcp#use-mcp-servers-from-claude-ai) в Claude Code. Включено по умолчанию для вошедших в систему пользователей |213| `ENABLE_CLAUDEAI_MCP_SERVERS` | Установите на `false`, чтобы отключить [MCP servers claude.ai](/ru/mcp#use-mcp-servers-from-claude-ai) в Claude Code. Включено по умолчанию для вошедших в систему пользователей |

211| `ENABLE_PROMPT_CACHING_1H` | Установите на `1`, чтобы запросить TTL кэша приглашений в 1 час вместо стандартных 5 минут. Предназначено для пользователей ключа API, [Bedrock](/ru/amazon-bedrock), [Vertex](/ru/google-vertex-ai), [Foundry](/ru/microsoft-foundry) и [Claude Platform on AWS](/ru/claude-platform-on-aws). Пользователи подписки получают TTL в 1 час автоматически. Записи кэша в 1 час выставляются по более высокой ставке |214| `ENABLE_PROMPT_CACHING_1H` | Установите на `1`, чтобы запросить TTL кэша приглашений в 1 час вместо стандартных 5 минут. Предназначено для пользователей ключа API, [Bedrock](/ru/amazon-bedrock), [Vertex](/ru/google-vertex-ai), [Foundry](/ru/microsoft-foundry) и [Claude Platform on AWS](/ru/claude-platform-on-aws). Пользователи подписки получают TTL в 1 час автоматически. Записи кэша в 1 час выставляются по более высокой ставке |

212| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Устарело. Используйте `ENABLE_PROMPT_CACHING_1H` вместо этого |215| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Устарело. Используйте `ENABLE_PROMPT_CACHING_1H` вместо этого |

213| `ENABLE_TOOL_SEARCH` | Управляет [поиском инструментов MCP](/ru/mcp#scale-with-mcp-tool-search). Не установлено: все инструменты MCP отложены по умолчанию, но загружены заранее на Vertex AI или когда `ANTHROPIC_BASE_URL` указывает на хост, не являющийся хостом первой стороны. Значения: `true` (всегда откладывать и отправлять заголовок beta; поддерживается на Vertex AI с Sonnet 4.5 и позже или Opus 4.5 и позже; запросы не удаются на более ранних моделях Vertex AI или на прокси, которые не поддерживают `tool_reference`), `auto` (режим порога: загружать заранее, если инструменты подходят в пределах 10% контекста), `auto:N` (пользовательский порог, например, `auto:5` для 5%), `false` (загружать все заранее) |216| `ENABLE_TOOL_SEARCH` | Управляет [поиском инструментов MCP](/ru/mcp#scale-with-mcp-tool-search). Не установлено: все инструменты MCP отложены по умолчанию, но загружены заранее на Vertex AI или когда `ANTHROPIC_BASE_URL` указывает на хост, не являющийся хостом первой стороны. Значения: `true` (всегда откладывать и отправлять заголовок beta, запросы не удаются на моделях Vertex AI ранее Sonnet 4.5 или Opus 4.5, или на прокси, которые не поддерживают `tool_reference`), `auto` (режим порога: загружать заранее, если инструменты подходят в пределах 10% контекста), `auto:N` (пользовательский порог, например, `auto:5` для 5%), `false` (загружать все заранее) |

214| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Установите на любое непустое значение, чтобы запустить резервный вариант на [`--fallback-model`](/ru/cli-reference#cli-flags) после повторных ошибок перегрузки на любой основной модели. По умолчанию только модели Opus запускают резервный вариант |217| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Установите на любое непустое значение, чтобы запустить резервный вариант на [`--fallback-model`](/ru/cli-reference#cli-flags) после повторных ошибок перегрузки на любой основной модели. По умолчанию только модели Opus запускают резервный вариант |

215| `FORCE_AUTOUPDATE_PLUGINS` | Установите на `1`, чтобы принудительно обновлять plugins автоматически, даже если основной автоматический обновитель отключен через `DISABLE_AUTOUPDATER` |218| `FORCE_AUTOUPDATE_PLUGINS` | Установите на `1`, чтобы принудительно обновлять plugins автоматически, даже если основной автоматический обновитель отключен через `DISABLE_AUTOUPDATER` |

216| `FORCE_PROMPT_CACHING_5M` | Установите на `1`, чтобы принудительно использовать TTL кэша приглашений в 5 минут, даже когда в противном случае применялся бы TTL в 1 час. Переопределяет `ENABLE_PROMPT_CACHING_1H` |219| `FORCE_PROMPT_CACHING_5M` | Установите на `1`, чтобы принудительно использовать TTL кэша приглашений в 5 минут, даже когда в противном случае применялся бы TTL в 1 час. Переопределяет `ENABLE_PROMPT_CACHING_1H` |


221| `MAX_STRUCTURED_OUTPUT_RETRIES` | Количество попыток повтора, когда ответ модели не проходит проверку по [`--json-schema`](/ru/cli-reference#cli-flags) в неинтерактивном режиме (флаг `-p`). По умолчанию 5 |224| `MAX_STRUCTURED_OUTPUT_RETRIES` | Количество попыток повтора, когда ответ модели не проходит проверку по [`--json-schema`](/ru/cli-reference#cli-flags) в неинтерактивном режиме (флаг `-p`). По умолчанию 5 |

222| `MAX_THINKING_TOKENS` | Переопределить бюджет токенов [расширенного мышления](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). Потолок — это [максимальное количество выходных токенов](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) модели минус один. Установите на `0`, чтобы полностью отключить мышление. На моделях с [адаптивным рассуждением](/ru/model-config#adjust-effort-level) бюджет игнорируется, если адаптивное рассуждение не отключено через `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` |225| `MAX_THINKING_TOKENS` | Переопределить бюджет токенов [расширенного мышления](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). Потолок — это [максимальное количество выходных токенов](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) модели минус один. Установите на `0`, чтобы полностью отключить мышление. На моделях с [адаптивным рассуждением](/ru/model-config#adjust-effort-level) бюджет игнорируется, если адаптивное рассуждение не отключено через `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` |

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

224| `MCP_CONNECTION_NONBLOCKING` | Установите на `true` в неинтерактивном режиме (`-p`), чтобы полностью пропустить ожидание подключения MCP. Полезно для скриптовых конвейеров, где инструменты MCP не требуются. Без этой переменной первый запрос ждёт до 5 секунд для подключения серверов `--mcp-config`. Серверы, настроенные с [`alwaysLoad: true`](/ru/mcp#exempt-a-server-from-deferral), всегда блокируют запуск независимо от этой переменной, так как их инструменты должны присутствовать при построении первого приглашения |227| `MCP_CONNECTION_NONBLOCKING` | Управляет тем, ждёт ли запуск подключения MCP servers перед первым запросом. {/* min-version: 2.1.142 */}Начиная с Claude Code v2.1.142, запуск MCP является неблокирующим по умолчанию: серверы подключаются в фоне и их инструменты становятся доступными по мере завершения. Установите на `0`, чтобы восстановить блокирующее ожидание в 5 секунд. Серверы, настроенные с [`alwaysLoad: true`](/ru/mcp#exempt-a-server-from-deferral), всегда блокируют запуск независимо, так как их инструменты должны присутствовать при построении первого приглашения |

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

226| `MCP_OAUTH_CALLBACK_PORT` | Фиксированный порт для обратного вызова перенаправления OAuth, как альтернатива `--callback-port` при добавлении MCP server с [предварительно настроенными учётными данными](/ru/mcp#use-pre-configured-oauth-credentials) |229| `MCP_OAUTH_CALLBACK_PORT` | Фиксированный порт для обратного вызова перенаправления OAuth, как альтернатива `--callback-port` при добавлении MCP server с [предварительно настроенными учётными данными](/ru/mcp#use-pre-configured-oauth-credentials) |

227| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Максимальное количество удалённых MCP servers (HTTP/SSE) для подключения параллельно при запуске (по умолчанию: 20) |230| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Максимальное количество удалённых MCP servers (HTTP/SSE) для подключения параллельно при запуске (по умолчанию: 20) |

228| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Максимальное количество локальных MCP servers (stdio) для подключения параллельно при запуске (по умолчанию: 3) |231| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Максимальное количество локальных MCP servers (stdio) для подключения параллельно при запуске (по умолчанию: 3) |

errors.md +5 −3

Details

178 178 

179* Дождитесь времени сброса, показанного в ошибке179* Дождитесь времени сброса, показанного в ошибке

180* Запустите `/usage`, чтобы увидеть лимиты вашего плана и когда они сбрасываются180* Запустите `/usage`, чтобы увидеть лимиты вашего плана и когда они сбрасываются

181* Запустите `/extra-usage`, чтобы купить дополнительное использование на Pro и Max, или запросить его у администратора на Team и Enterprise. См. [Extra usage for paid plans](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) для информации о том, как это выставляется счетом.181* Запустите `/usage-credits`, чтобы купить дополнительное использование на Pro и Max, или запросить его у администратора на Team и Enterprise. См. [usage credits for paid plans](https://support.claude.com/ru/articles/12429409-extra-usage-for-paid-claude-plans) для информации о том, как это выставляется счетом.

182* Чтобы обновить ваш план для более высоких базовых лимитов, см. [claude.com/pricing](https://claude.com/pricing)182* Чтобы обновить ваш план для более высоких базовых лимитов, см. [claude.com/pricing](https://claude.com/pricing)

183 183 

184Чтобы отслеживать оставшийся лимит перед его достижением, добавьте поля `rate_limits` в [custom status line](/ru/statusline#rate-limit-usage), или в Desktop app нажмите [usage ring](/ru/desktop#check-usage) рядом с выбором модели.184Чтобы отслеживать оставшийся лимит перед его достижением, добавьте поля `rate_limits` в [custom status line](/ru/statusline#rate-limit-usage), или в Desktop app нажмите [usage ring](/ru/desktop#check-usage) рядом с выбором модели.


203Вы достигли лимита скорости, настроенного для вашего ключа API, проекта Amazon Bedrock или проекта Google Vertex AI.203Вы достигли лимита скорости, настроенного для вашего ключа API, проекта Amazon Bedrock или проекта Google Vertex AI.

204 204 

205```text theme={null}205```text theme={null}

206API Error: Request rejected (429) · this may be a temporary capacity issue206API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check status.claude.com.

207```207```

208 208 

209Завершающее предложение указывает, где проверить состояние сервиса и варьируется в зависимости от провайдера. Конфигурации Bedrock и Vertex AI указывают на страницу состояния этого провайдера вместо страницы состояния Anthropic.

210 

209**Что делать:**211**Что делать:**

210 212 

211* Запустите `/status` и подтвердите, что активные учетные данные — это те, которые вы ожидаете. Случайный `ANTHROPIC_API_KEY` в вашей среде может маршрутизировать запросы через низкоуровневый ключ вместо вашей подписки.213* Запустите `/status` и подтвердите, что активные учетные данные — это те, которые вы ожидаете. Случайный `ANTHROPIC_API_KEY` в вашей среде может маршрутизировать запросы через низкоуровневый ключ вместо вашей подписки.

212* Проверьте консоль вашего провайдера на предмет активных лимитов и запросите более высокий уровень, если необходимо214* Проверьте консоль вашего провайдера на предмет активных лимитов и запросите более высокий уровень, если необходимо

213* Для ключей Anthropic API см. [rate limits reference](https://platform.claude.com/docs/en/api/rate-limits) для информации о том, как работают уровни и как установить лимиты для каждого рабочего пространства215* Для ключей Anthropic API см. [rate limits reference](https://platform.claude.com/docs/ru/api/rate-limits) для информации о том, как работают уровни и как установить лимиты для каждого рабочего пространства

214* Снизьте параллелизм: понизьте [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/ru/env-vars), избегайте запуска множества параллельных подагентов или переключитесь на меньшую модель с `/model` для высокообъемных скриптовых запусков216* Снизьте параллелизм: понизьте [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/ru/env-vars), избегайте запуска множества параллельных подагентов или переключитесь на меньшую модель с `/model` для высокообъемных скриптовых запусков

215 217 

216### Credit balance is too low218### Credit balance is too low

fast-mode.md +10 −44

Details

12 12 

13Быстрый режим — это высокоскоростная конфигурация для Claude Opus, которая делает модель в 2,5 раза быстрее при более высокой стоимости за токен. Включайте его с помощью `/fast`, когда вам нужна скорость для интерактивной работы, такой как быстрая итерация или живая отладка, и отключайте, когда стоимость важнее, чем задержка.13Быстрый режим — это высокоскоростная конфигурация для Claude Opus, которая делает модель в 2,5 раза быстрее при более высокой стоимости за токен. Включайте его с помощью `/fast`, когда вам нужна скорость для интерактивной работы, такой как быстрая итерация или живая отладка, и отключайте, когда стоимость важнее, чем задержка.

14 14 

15Быстрый режим — это не другая модель. Он использует Claude Opus с другой конфигурацией API, которая приоритизирует скорость над экономичностью. Вы получаете идентичное качество и возможности, просто более быстрые ответы. Быстрый режим поддерживается на Opus 4.6 и Opus 4.7. Он недоступен на Sonnet, Haiku или других моделях.15Быстрый режим — это не другая модель. Он использует Claude Opus с другой конфигурацией API, которая приоритизирует скорость над экономичностью. Вы получаете идентичное качество и возможности с более быстрыми ответами. Быстрый режим поддерживается на Opus 4.7 и Opus 4.6. Он недоступен на Sonnet, Haiku или других моделях.

16 16 

17<Note>17<Note>

18 Быстрый режим требует Claude Code v2.1.36 или позже. Проверьте вашу версию с помощью `claude --version`.18 Быстрый режим требует Claude Code v2.1.36 или позже. Проверьте вашу версию с помощью `claude --version`.


21Что нужно знать:21Что нужно знать:

22 22 

23* Используйте `/fast` для включения быстрого режима в Claude Code CLI. Также доступно через `/fast` в расширении Claude Code VS Code.23* Используйте `/fast` для включения быстрого режима в Claude Code CLI. Также доступно через `/fast` в расширении Claude Code VS Code.

24* По умолчанию `/fast` работает на Opus 4.6. Чтобы вместо этого запустить быстрый режим на Opus 4.7, установите переменную окружения [`CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE`](#use-fast-mode-on-opus-4-7).24* Цены на быстрый режим составляют $30/$150 MTok как на Opus 4.7, так и на Opus 4.6.

25* Цены на быстрый режим составляют \$30/150 MTok как на Opus 4.6, так и на Opus 4.7.

26* Доступно всем пользователям Claude Code на планах подписки (Pro/Max/Team/Enterprise) и Claude Console.25* Доступно всем пользователям Claude Code на планах подписки (Pro/Max/Team/Enterprise) и Claude Console.

27* Для пользователей Claude Code на планах подписки (Pro/Max/Team/Enterprise) быстрый режим доступен только через дополнительное использование и не включен в лимиты использования подписки.26* Для пользователей Claude Code на планах подписки (Pro/Max/Team/Enterprise) быстрый режим доступен только через дополнительное использование и не включен в лимиты использования подписки.

28 27 

29На этой странице рассматривается, как [включить быстрый режим](#toggle-fast-mode), [использовать быстрый режим на Opus 4.7](#use-fast-mode-on-opus-4-7), его [компромисс стоимости](#understand-the-cost-tradeoff), [когда его использовать](#decide-when-to-use-fast-mode), [требования](#requirements), [обязательное согласие за сеанс](#require-per-session-opt-in) и [поведение лимитов скорости](#handle-rate-limits).28На этой странице рассматривается, как [включить быстрый режим](#toggle-fast-mode), его [компромисс стоимости](#understand-the-cost-tradeoff), [когда его использовать](#decide-when-to-use-fast-mode), [требования](#requirements), [обязательное согласие за сеанс](#require-per-session-opt-in) и [поведение лимитов скорости](#handle-rate-limits).

30 29 

31## Включение быстрого режима30## Включение быстрого режима

32 31 


41 40 

42Когда вы включаете быстрый режим:41Когда вы включаете быстрый режим:

43 42 

44* Если вы используете другую модель, Claude Code автоматически переключается на модель быстрого режима: Opus 4.6 по умолчанию или Opus 4.7, когда установлена [`CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE`](#use-fast-mode-on-opus-4-7).43* Если вы используете другую модель, Claude Code автоматически переключается на Opus

45* Вы увидите сообщение подтверждения: "Fast mode ON"44* Вы увидите сообщение подтверждения: "Fast mode ON"

46* Рядом с приглашением появляется небольшой значок `↯` во время активного быстрого режима45* Рядом с приглашением появляется небольшой значок `↯` во время активного быстрого режима

47* Запустите `/fast` снова в любое время, чтобы проверить, включен или отключен быстрый режим46* Запустите `/fast` снова в любое время, чтобы проверить, включен или отключен быстрый режим

48 47 

49Когда вы отключаете быстрый режим с помощью `/fast` снова, вы остаетесь на той же версии Opus, на которой работал быстрый режим. Модель не возвращается к вашей предыдущей модели. Чтобы переключиться на другую модель, используйте `/model`.48Когда вы отключаете быстрый режим с помощью `/fast` снова, вы остаетесь на Opus. Модель не возвращается к вашей предыдущей модели. Чтобы переключиться на другую модель, используйте `/model`.

50 49 

51## Использование быстрого режима на Opus 4.750Opus 4.7 является стандартным режимом быстрого режима в Claude Code v2.1.142 и позже. Чтобы закрепить быстрый режим на Opus 4.6, установите `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1`.

52 

53<Note>

54 Быстрый режим на Opus 4.7 требует Claude Code v2.1.139 или позже.

55</Note>

56 

57Быстрый режим для Claude Opus 4.7 находится в исследовательском превью. Он работает с той же скоростью 2,5x и по той же цене, что и быстрый режим для Opus 4.6, без других изменений поведения.

58 

59<Note>

60 14 мая 2026 года Opus 4.7 станет моделью быстрого режима по умолчанию. До этого времени согласитесь, установив `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE=1`.

61</Note>

62 

63Чтобы согласиться, установите `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE=1` перед запуском Claude Code. С установленной переменной `/fast` работает на Opus 4.7. Без нее `/fast` продолжает работать на Opus 4.6.

64 

65Вы можете установить переменную как экспорт оболочки:

66 

67```bash theme={null}

68export CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE=1

69```

70 

71Или в любом [файле настроек](/ru/settings#settings-files) Claude Code, включая пользовательские, проектные и управляемые настройки, чтобы ограничить согласие:

72 

73```json theme={null}

74{

75 "env": {

76 "CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE": "1"

77 }

78}

79```

80 

81Быстрый режим для Opus 4.6 остается доступным наряду с Opus 4.7. Оба используют один и тот же пул лимитов быстрого режима: использование на любой модели берет из одних и тех же лимитов.

82 

83Чтобы явно закрепить быстрый режим на Opus 4.6, установите `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1`. Эта переменная имеет приоритет, поэтому быстрый режим работает на Opus 4.6 независимо от того, установлена ли `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE`.

84 51 

85## Понимание компромисса стоимости52## Понимание компромисса стоимости

86 53 

87Быстрый режим имеет более высокую цену за токен, чем стандартный Opus:54Быстрый режим имеет более высокую цену за токен, чем стандартный Opus:

88 55 

89| Режим | Входные данные (MTok) | Выходные данные (MTok) |56| Режим | Входные данные (MTok) | Выходные данные (MTok) |

90| ------------------------- | --------------------- | ---------------------- |57| ------------- | --------------------- | ---------------------- |

91| Быстрый режим на Opus 4.6 | \$30 | \$150 |58| Быстрый режим | \$30 | \$150 |

92| Быстрый режим на Opus 4.7 | \$30 | \$150 |

93 59 

94Цены на быстрый режим одинаковы по всему контекстному окну из 1M токенов.60Цены на быстрый режим одинаковы по всему контекстному окну из 1M токенов.

95 61 


160 126 

161## Обработка лимитов скорости127## Обработка лимитов скорости

162 128 

163Быстрый режим имеет отдельные лимиты скорости от стандартного Opus. Быстрый режим для Opus 4.6 и Opus 4.7 используют один и тот же пул лимитов скорости: использование на любой модели берет из одних и тех же лимитов. Когда вы достигаете лимита скорости быстрого режима или исчерпываете дополнительное использование:129Быстрый режим имеет отдельные лимиты скорости от стандартного Opus. Быстрый режим для Opus 4.7 и Opus 4.6 используют один и тот же пул лимитов скорости: использование на любой модели берет из одних и тех же лимитов. Когда вы достигаете лимита скорости быстрого режима или исчерпываете дополнительное использование:

164 130 

1651. Быстрый режим автоматически переключается на стандартную скорость на той же версии Opus1311. Быстрый режим автоматически переключается на стандартную скорость

1662. Значок `↯` становится серым, указывая на охлаждение1322. Значок `↯` становится серым, указывая на охлаждение

1673. Вы продолжаете работать со стандартной скоростью и ценами1333. Вы продолжаете работать со стандартной скоростью и ценами

1684. Когда охлаждение истекает, быстрый режим автоматически повторно включается1344. Когда охлаждение истекает, быстрый режим автоматически повторно включается

Details

271 271 

272 **Что загружается:** Свежий, изолированный контекст, содержащий:272 **Что загружается:** Свежий, изолированный контекст, содержащий:

273 273 

274 * Системный prompt (общий с родителем для эффективности кэша)274 * Системный prompt агента, а не полный системный prompt Claude Code

275 * Полный контент skills, указанных в поле `skills:` агента275 * Полный контент skills, указанных в поле `skills:` агента

276 * CLAUDE.md и статус git (унаследованы от родителя)276 * CLAUDE.md и статус git, за исключением встроенных агентов Explore и Plan [которые опускают оба](/ru/sub-agents#what-loads-at-startup)

277 * Любой контекст, который основной агент передаёт в prompt277 * Любой контекст, который основной агент передаёт в prompt

278 278 

279 **Стоимость контекста:** Изолирована от основной сессии. Subagents не наследуют историю вашего разговора или вызванные skills.279 **Стоимость контекста:** Изолирована от основной сессии. Subagents не наследуют историю вашего разговора или вызванные skills.

hooks.md +1 −1

Details

732# Notification hook: ping the desktop when Claude Code needs attention.732# Notification hook: ping the desktop when Claude Code needs attention.

733input=$(cat)733input=$(cat)

734title="Claude Code'734title="Claude Code'

735body=$(jq -r '.message // 'Needs your attention"' <<<"$input")735body=$(jq -r '.message // 'Needs your attention'' <<<"$input")

736seq=$(printf '\033]777;notify;%s;%s\007' "$title" "$body")736seq=$(printf '\033]777;notify;%s;%s\007' "$title" "$body")

737jq -nc --arg seq "$seq" '{terminalSequence: $seq}'737jq -nc --arg seq "$seq" '{terminalSequence: $seq}'

738```738```

hooks-guide.md +5 −3

Details

910* Убедитесь, что ваш JSON действителен (конечные запятые и комментарии не допускаются)910* Убедитесь, что ваш JSON действителен (конечные запятые и комментарии не допускаются)

911* Подтвердите, что файл параметров находится в правильном месте: `.claude/settings.json` для hooks проекта, `~/.claude/settings.json` для глобальных hooks911* Подтвердите, что файл параметров находится в правильном месте: `.claude/settings.json` для hooks проекта, `~/.claude/settings.json` для глобальных hooks

912 912 

913### Stop hook работает вечно913### Stop hook достигает предела блокировки

914 914 

915Claude продолжает работать в бесконечном цикле вместо остановки.915Claude продолжает работать вместо остановки, а затем завершает ход с предупреждением о том, что Stop hook заблокировал слишком много раз подряд без прогресса.

916 916 

917Ваш скрипт Stop hook должен проверить, не срабатывал ли он уже. Проанализируйте поле `stop_hook_active` из JSON ввода и выйдите рано, если оно `true`:917Claude Code переопределяет Stop hook после того, как он блокирует 8 раз подряд без прогресса. Ваш скрипт hook должен проверить, не срабатывал ли он уже. Проанализируйте поле `stop_hook_active` из JSON ввода и выйдите рано, если оно `true`:

918 918 

919```bash theme={null}919```bash theme={null}

920#!/bin/bash920#!/bin/bash


925# ... остальная логика вашего hook925# ... остальная логика вашего hook

926```926```

927 927 

928Если ваш hook законно нуждается в более чем восьми итерациях для сходимости, повысьте предел с помощью [`CLAUDE_CODE_STOP_HOOK_BLOCK_CAP`](/ru/env-vars).

929 

928### Ошибка валидации JSON930### Ошибка валидации JSON

929 931 

930Claude Code показывает ошибку анализа JSON, даже если ваш скрипт hook выводит действительный JSON.932Claude Code показывает ошибку анализа JSON, даже если ваш скрипт hook выводит действительный JSON.

mcp.md +3 −1

Details

143 143 

144Панель `/mcp` показывает количество инструментов рядом с каждым подключенным server и отмечает servers, которые объявляют возможность tools, но не предоставляют никаких инструментов.144Панель `/mcp` показывает количество инструментов рядом с каждым подключенным server и отмечает servers, которые объявляют возможность tools, но не предоставляют никаких инструментов.

145 145 

146Если ваш запрос требует инструментов от server, который все еще подключается в фоновом режиме, Claude ждет подключения этого server перед продолжением. С включенным [поиском инструментов](#scale-with-mcp-tool-search), который используется по умолчанию, ожидание происходит внутри вызова `ToolSearch`. В конфигурациях без поиска инструментов, таких как Vertex AI, пользовательский `ANTHROPIC_BASE_URL` или `ENABLE_TOOL_SEARCH=false`, Claude использует инструмент `WaitForMcpServers` вместо этого.

147 

146Имя server `workspace` зарезервировано для внутреннего использования. Если ваша конфигурация определяет server с этим именем, Claude Code пропускает его при загрузке и показывает предупреждение с просьбой переименовать его.148Имя server `workspace` зарезервировано для внутреннего использования. Если ваша конфигурация определяет server с этим именем, Claude Code пропускает его при загрузке и показывает предупреждение с просьбой переименовать его.

147 149 

148### Динамические обновления инструментов150### Динамические обновления инструментов


1007 1009 

1008Поле `alwaysLoad` доступно на всех типах server и требует Claude Code v2.1.121 или позже. MCP server также может отметить отдельные инструменты как всегда загружаемые, включив `"anthropic/alwaysLoad": true` в объект `_meta` инструмента, что имеет тот же эффект только для этого инструмента.1010Поле `alwaysLoad` доступно на всех типах server и требует Claude Code v2.1.121 или позже. MCP server также может отметить отдельные инструменты как всегда загружаемые, включив `"anthropic/alwaysLoad": true` в объект `_meta` инструмента, что имеет тот же эффект только для этого инструмента.

1009 1011 

1010Установка `alwaysLoad: true` также блокирует запуск до подключения server, ограничено стандартным тайм-аутом подключения в 5 секунд. Это применяется даже когда установлено [`MCP_CONNECTION_NONBLOCKING=1`](/ru/env-vars), так как инструменты должны присутствовать при построении первого приглашения. Другие servers по-прежнему подключаются в фоновом режиме, когда включен неблокирующий режим.1012Установка `alwaysLoad: true` также блокирует запуск до подключения server, ограничено стандартным тайм-аутом подключения в 5 секунд. Это применяется даже когда MCP startup является [неблокирующим по умолчанию](/ru/env-vars), так как инструменты должны присутствовать при построении первого приглашения. Другие servers продолжают подключаться в фоновом режиме.

1011 1013 

1012## Используйте MCP подсказки как команды1014## Используйте MCP подсказки как команды

1013 1015 

model-config.md +2 −2

Details

284Вы можете использовать следующие переменные окружения, которые должны быть полными **именами моделей** (или эквивалентом для вашего поставщика API), для управления именами моделей, на которые отображаются псевдонимы.284Вы можете использовать следующие переменные окружения, которые должны быть полными **именами моделей** (или эквивалентом для вашего поставщика API), для управления именами моделей, на которые отображаются псевдонимы.

285 285 

286| Переменная окружения | Описание |286| Переменная окружения | Описание |

287| -------------------------------- | ------------------------------------------------------------------------------------------------------ |287| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

288| `ANTHROPIC_DEFAULT_OPUS_MODEL` | Модель для использования для `opus`, или для `opusplan` при активном Plan Mode. |288| `ANTHROPIC_DEFAULT_OPUS_MODEL` | Модель для использования для `opus`, или для `opusplan` при активном Plan Mode. |

289| `ANTHROPIC_DEFAULT_SONNET_MODEL` | Модель для использования для `sonnet`, или для `opusplan` при неактивном Plan Mode. |289| `ANTHROPIC_DEFAULT_SONNET_MODEL` | Модель для использования для `sonnet`, или для `opusplan` при неактивном Plan Mode. |

290| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Модель для использования для `haiku`, или [фоновой функциональности](/ru/costs#background-token-usage) |290| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Модель для использования для `haiku`, или [фоновой функциональности](/ru/costs#background-token-usage) |

291| `CLAUDE_CODE_SUBAGENT_MODEL` | Модель для использования для [subagents](/ru/sub-agents) |291| `CLAUDE_CODE_SUBAGENT_MODEL` | Модель для использования для всех [subagents](/ru/sub-agents#choose-a-model). Переопределяет как параметр `model` для каждого вызова, так и frontmatter `model` определения subagent |

292 292 

293Примечание: `ANTHROPIC_SMALL_FAST_MODEL` устарел в пользу `ANTHROPIC_DEFAULT_HAIKU_MODEL`.293Примечание: `ANTHROPIC_SMALL_FAST_MODEL` устарел в пользу `ANTHROPIC_DEFAULT_HAIKU_MODEL`.

294 294 

overview.md +1 −1

Details

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.3> Use this file to discover all available pages before exploring further.

4 4 

5# Обзор Claude Code5# Обзор

6 6 

7> Claude Code — это агентский инструмент кодирования, который читает вашу кодовую базу, редактирует файлы, выполняет команды и интегрируется с вашими инструментами разработки. Доступен в вашем терминале, IDE, приложении для рабочего стола и браузере.7> Claude Code — это агентский инструмент кодирования, который читает вашу кодовую базу, редактирует файлы, выполняет команды и интегрируется с вашими инструментами разработки. Доступен в вашем терминале, IDE, приложении для рабочего стола и браузере.

8 8 

Details

73 | Auto mode | `auto` |73 | Auto mode | `auto` |

74 | Bypass permissions | `bypassPermissions` |74 | Bypass permissions | `bypassPermissions` |

75 75 

76 Auto mode появляется в индикаторе режима после того, как вы включите **Allow dangerously skip permissions** в настройках расширения, но остаётся недоступным до тех пор, пока ваша учётная запись не соответствует всем требованиям, перечисленным в [разделе режима auto](#eliminate-prompts-with-auto-mode). Параметр `claudeCode.initialPermissionMode` не принимает `auto`; чтобы запустить в режиме auto по умолчанию, установите `defaultMode` в вашем Claude Code [`settings.json`](/ru/settings#settings-files) вместо этого.76 Auto mode появляется в индикаторе режима после того, как вы включите **Allow dangerously skip permissions** в настройках расширения, но остаётся недоступным до тех пор, пока ваша учётная запись не соответствует всем требованиям, перечисленным в [разделе режима auto](#eliminate-prompts-with-auto-mode). Параметр `claudeCode.initialPermissionMode` не принимает `auto`. Чтобы запустить в режиме auto по умолчанию, установите `defaultMode` в вашем [пользовательском settings](/ru/settings#settings-files) вместо этого. Claude Code игнорирует `defaultMode: "auto"` в настройках проекта и локальных настройках.

77 77 

78 Bypass permissions также требует переключателя **Allow dangerously skip permissions** перед тем, как он появится в индикаторе режима.78 Bypass permissions также требует переключателя **Allow dangerously skip permissions** перед тем, как он появится в индикаторе режима.

79 79 


179 179 

180Если Claude Code сообщает, что режим auto недоступен, одно из этих требований не выполнено; это не временный сбой. Отдельное сообщение, которое называет модель и говорит, что режим auto "не может определить безопасность" действия, является временным сбоем классификатора; см. [справку по ошибкам](/ru/errors#auto-mode-cannot-determine-the-safety-of-an-action).180Если Claude Code сообщает, что режим auto недоступен, одно из этих требований не выполнено; это не временный сбой. Отдельное сообщение, которое называет модель и говорит, что режим auto "не может определить безопасность" действия, является временным сбоем классификатора; см. [справку по ошибкам](/ru/errors#auto-mode-cannot-determine-the-safety-of-an-action).

181 181 

182Если вы установили `defaultMode: "auto"` в [параметрах](/ru/settings#available-settings) и сеанс начинается в режиме `default` без ошибки, параметр, вероятно, находится в `.claude/settings.json` или `.claude/settings.local.json`. Claude Code игнорирует `auto` из этих файлов, поэтому репозиторий не может предоставить себе режим auto. Переместите его в `~/.claude/settings.json`.

183 

182### Что классификатор блокирует по умолчанию184### Что классификатор блокирует по умолчанию

183 185 

184Классификатор доверяет вашему рабочему каталогу и настроенным удалённым репозиториям вашего репо. Всё остальное рассматривается как внешнее до тех пор, пока вы не [настроите доверенную инфраструктуру](/ru/auto-mode-config).186Классификатор доверяет вашему рабочему каталогу и настроенным удалённым репозиториям вашего репо. Всё остальное рассматривается как внешнее до тех пор, пока вы не [настроите доверенную инфраструктуру](/ru/auto-mode-config).

Details

114 114 

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

116 116 

117## Включение или отключение плагина с зависимостями

118 

119Включение плагина также включает плагины, от которых он зависит, и отключение плагина блокируется, если другой включенный плагин все еще нуждается в нем. Оба поведения требуют Claude Code v2.1.143 или более поздней версии. Более ранние версии включают или отключают только названный плагин и выводят ошибку `dependency-unsatisfied` при следующей загрузке.

120 

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

122 

123| Условие | Результат |

124| :-------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------- |

125| Зависимость не установлена | Включение завершается с ошибкой и выводит команду `claude plugin install` для каждой отсутствующей зависимости. |

126| Зависимость заблокирована политикой плагинов вашей организации | Включение завершается с ошибкой и указывает на заблокированную зависимость. |

127| Зависимость установлена на `false` в области с более высоким приоритетом, чем целевая область | Включение завершается с ошибкой. Включите зависимость в этой области или передайте `--scope` для записи там. |

128| Все зависимости установлены и разрешены | Включение успешно и записывает `true` для плагина и каждой зависимости, которая еще не была включена в целевой области. |

129 

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

131 

132Например, если `deploy-kit` зависит от `secrets-vault`, отключение только `secrets-vault` завершается с ошибкой с выводом, похожим на следующий:

133 

134```text theme={null}

135secrets-vault is still required by deploy-kit. Disable that plugin first, or

136disable everything together: claude plugin disable deploy-kit@acme-tools && claude plugin disable secrets-vault@acme-tools

137```

138 

139Скопируйте цепную команду из ошибки, чтобы отключить полный набор за один шаг.

140 

117## Удаление осиротевших автоматически установленных зависимостей141## Удаление осиротевших автоматически установленных зависимостей

118 142 

119Автоматически установленные зависимости остаются на диске после удаления плагинов, которые их установили, на случай, если вы переустановите зависимый плагин или захотите продолжить использование зависимости напрямую. Чтобы очистить их, запустите `claude plugin prune` для вывода списка автоматически установленных зависимостей, которые больше не требуются ни одним установленным плагином, и удалите их после подтверждения. Это требует Claude Code v2.1.121 или более поздней версии.143Автоматически установленные зависимости остаются на диске после удаления плагинов, которые их установили, на случай, если вы переустановите зависимый плагин или захотите продолжить использование зависимости напрямую. Чтобы очистить их, запустите `claude plugin prune` для вывода списка автоматически установленных зависимостей, которые больше не требуются ни одним установленным плагином, и удалите их после подтверждения. Это требует Claude Code v2.1.121 или более поздней версии.

Details

161| `plugins` | array | Список доступных плагинов | См. ниже |161| `plugins` | array | Список доступных плагинов | См. ниже |

162 162 

163<Note>163<Note>

164 **Зарезервированные имена**: Следующие имена marketplace зарезервированы для официального использования Anthropic и не могут использоваться сторонними marketplace: `claude-code-marketplace`, `claude-code-plugins`, `claude-plugins-official`, `anthropic-marketplace`, `anthropic-plugins`, `agent-skills`, `knowledge-work-plugins`, `life-sciences`. Имена, которые выдают себя за официальные marketplace (например, `official-claude-plugins` или `anthropic-tools-v2`), также заблокированы.164 **Зарезервированные имена**: Следующие имена marketplace зарезервированы для официального использования Anthropic и не могут использоваться сторонними marketplace: `claude-code-marketplace`, `claude-code-plugins`, `claude-plugins-official`, `anthropic-marketplace`, `anthropic-plugins`, `agent-skills`, `anthropic-agent-skills`, `knowledge-work-plugins`, `life-sciences`. Имена, которые выдают себя за официальные marketplace, такие как `official-claude-plugins` или `anthropic-tools-v2`, также заблокированы.

165</Note>165</Note>

166 166 

167### Поля владельца167### Поля владельца


200 200 

201| Поле | Тип | Описание |201| Поле | Тип | Описание |

202| :------------ | :------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |202| :------------ | :------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

203| `displayName` | string | {/* min-version: 2.1.143 */}Удобочитаемое имя, отображаемое в интерфейсе. Возвращается к `name` при отсутствии. Может содержать пробелы и любой регистр. Не используется для пространства имён или поиска. Требуется Claude Code v2.1.143 или позже. |

203| `description` | string | Краткое описание плагина |204| `description` | string | Краткое описание плагина |

204| `version` | string | Версия плагина. Если установлено (здесь или в `plugin.json`), плагин закреплен на этой строке и пользователи получают обновления только при её изменении. Опустите, чтобы вернуться к SHA коммита git. См. [Разрешение версий](#version-resolution-and-release-channels). |205| `version` | string | Версия плагина. Если установлено (здесь или в `plugin.json`), плагин закреплен на этой строке и пользователи получают обновления только при её изменении. Опустите, чтобы вернуться к SHA коммита git. См. [Разрешение версий](#version-resolution-and-release-channels). |

205| `author` | object | Информация об авторе плагина (`name` обязательно, `email` опционально) |206| `author` | object | Информация об авторе плагина (`name` обязательно, `email` опционально) |

Details

20 20 

21Плагины добавляют skills в Claude Code, создавая сочетания клавиш `/name`, которые вы или Claude можете вызвать.21Плагины добавляют skills в Claude Code, создавая сочетания клавиш `/name`, которые вы или Claude можете вызвать.

22 22 

23**Расположение**: каталог `skills/` или `commands/` в корне плагина23**Расположение**: каталог `skills/` или `commands/` в корне плагина, или один файл `SKILL.md` в корне плагина

24 24 

25**Формат файла**: Skills — это каталоги с `SKILL.md`; команды — это простые файлы markdown25**Формат файла**: Skills — это каталоги с `SKILL.md`; команды — это простые файлы markdown

26 26 


367```json theme={null}367```json theme={null}

368{368{

369 "name": "plugin-name",369 "name": "plugin-name",

370 "displayName": "Plugin Name",

370 "version": "1.2.0",371 "version": "1.2.0",

371 "description": "Brief plugin description",372 "description": "Brief plugin description",

372 "author": {373 "author": {


411| Поле | Тип | Описание | Пример |412| Поле | Тип | Описание | Пример |

412| :------------ | :----- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------- |413| :------------ | :----- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------- |

413| `$schema` | string | URL JSON Schema для автодополнения и валидации редактора. Claude Code игнорирует это поле при загрузке. | `"https://json.schemastore.org/claude-code-plugin-manifest.json"` |414| `$schema` | string | URL JSON Schema для автодополнения и валидации редактора. Claude Code игнорирует это поле при загрузке. | `"https://json.schemastore.org/claude-code-plugin-manifest.json"` |

415| `displayName` | string | {/* min-version: 2.1.143 */}Удобочитаемое имя, отображаемое в средстве выбора `/plugin` и других поверхностях пользовательского интерфейса. Возвращается к `name` при опущении. В отличие от `name`, может содержать пробелы и любой регистр. Не используется для пространства имён или поиска. Требует Claude Code v2.1.143 или более поздней версии. | `"Deployment Tools"` |

414| `version` | string | Опционально. Семантическая версия. Установка этого параметра закрепляет плагин на этой строке версии, поэтому пользователи получают обновления только при её изменении. Если опущено, Claude Code использует SHA коммита git, поэтому каждый коммит рассматривается как новая версия. Если также установлено в записи маркетплейса, `plugin.json` имеет приоритет. Смотрите [Управление версиями](#version-management). | `"2.1.0"` |416| `version` | string | Опционально. Семантическая версия. Установка этого параметра закрепляет плагин на этой строке версии, поэтому пользователи получают обновления только при её изменении. Если опущено, Claude Code использует SHA коммита git, поэтому каждый коммит рассматривается как новая версия. Если также установлено в записи маркетплейса, `plugin.json` имеет приоритет. Смотрите [Управление версиями](#version-management). | `"2.1.0"` |

415| `description` | string | Краткое объяснение назначения плагина | `"Deployment automation tools"` |417| `description` | string | Краткое объяснение назначения плагина | `"Deployment automation tools"` |

416| `author` | object | Информация об авторе | `{"name": "Dev Team", "email": "dev@company.com"}` |418| `author` | object | Информация об авторе | `{"name": "Dev Team", "email": "dev@company.com"}` |


525* Несколько путей можно указать как массивы527* Несколько путей можно указать как массивы

526* Когда путь skill указывает на каталог, который содержит `SKILL.md` напрямую, например `"skills": ["./"]`, указывающий на корень плагина, поле frontmatter `name` в `SKILL.md` определяет имя вызова skill. Это обеспечивает стабильное имя независимо от каталога установки. Если `name` не установлен в frontmatter, в качестве резервного варианта используется имя каталога.528* Когда путь skill указывает на каталог, который содержит `SKILL.md` напрямую, например `"skills": ["./"]`, указывающий на корень плагина, поле frontmatter `name` в `SKILL.md` определяет имя вызова skill. Это обеспечивает стабильное имя независимо от каталога установки. Если `name` не установлен в frontmatter, в качестве резервного варианта используется имя каталога.

527 529 

530Плагин, который имеет `SKILL.md` в своём корне, не имеет подкаталога `skills/` и не имеет поля манифеста `skills`, автоматически загружается как плагин с одним skill в Claude Code v2.1.142 и более поздних версиях. Вам не нужно устанавливать `"skills": ["./"]` в `plugin.json` для этого макета. Имя вызова skill следует тому же правилу, что и выше: поле frontmatter `name` или имя каталога в качестве резервного варианта.

531 

528**Примеры путей**:532**Примеры путей**:

529 533 

530```json theme={null}534```json theme={null}


542 546 

543### Переменные окружения547### Переменные окружения

544 548 

545Claude Code предоставляет три переменные для ссылки на пути. Обе подставляются встроенно везде, где они появляются в содержимом skills, содержимом agents, командах hooks, командах monitors и конфигурациях серверов MCP или LSP. Обе также экспортируются как переменные окружения в процессы hooks и подпроцессы серверов MCP или LSP.549Claude Code предоставляет три переменные для ссылки на пути. Все они подставляются встроенно везде, где они появляются в содержимом skills, содержимом agents, командах hooks, командах monitors и конфигурациях серверов MCP или LSP. Все они также экспортируются как переменные окружения в процессы hooks и подпроцессы серверов MCP или LSP.

546 550 

547**`${CLAUDE_PLUGIN_ROOT}`**: абсолютный путь к каталогу установки вашего плагина. Используйте это для ссылки на скрипты, двоичные файлы и файлы конфигурации, поставляемые с плагином. В командах hooks используйте [форму exec](/ru/hooks#exec-form-and-shell-form) с `args`, чтобы путь передавался как один аргумент без кавычек. В hooks в форме shell и командах monitors оборачивайте его в двойные кавычки, как в `"${CLAUDE_PLUGIN_ROOT}"`. Этот путь изменяется при обновлении плагина. Каталог предыдущей версии остаётся на диске примерно семь дней после обновления перед очисткой, но рассматривайте его как временный и не записывайте состояние здесь.551**`${CLAUDE_PLUGIN_ROOT}`**: абсолютный путь к каталогу установки вашего плагина. Используйте это для ссылки на скрипты, двоичные файлы и файлы конфигурации, поставляемые с плагином. В командах hooks используйте [форму exec](/ru/hooks#exec-form-and-shell-form) с `args`, чтобы путь передавался как один аргумент без кавычек. В hooks в форме shell и командах monitors оборачивайте его в двойные кавычки, как в `"${CLAUDE_PLUGIN_ROOT}"`. Этот путь изменяется при обновлении плагина. Каталог предыдущей версии остаётся на диске примерно семь дней после обновления перед очисткой, но рассматривайте его как временный и не записывайте состояние здесь.

548 552 


814 818 

815### plugin enable819### plugin enable

816 820 

817Включите отключённый плагин.821Включите отключённый плагин. Если плагин объявляет [зависимости](/ru/plugin-dependencies), Claude Code включает их транзитивно в той же области, и команда завершается с ошибкой, когда зависимость не установлена.

818 822 

819```bash theme={null}823```bash theme={null}

820claude plugin enable <plugin> [options]824claude plugin enable <plugin> [options]


833 837 

834### plugin disable838### plugin disable

835 839 

836Отключите плагин без его удаления.840Отключите плагин без его удаления. Завершается с ошибкой, когда другой включённый плагин [зависит от](/ru/plugin-dependencies#enable-or-disable-a-plugin-with-dependencies) целевого плагина. Сообщение об ошибке включает цепочку команд, которая сначала отключает каждый зависимый плагин.

837 841 

838```bash theme={null}842```bash theme={null}

839claude plugin disable <plugin> [options]843claude plugin disable <plugin> [options]


889 893 

890### plugin details894### plugin details

891 895 

892Показать инвентарь компонентов плагина и прогнозируемую стоимость в токенах. Вывод содержит список всех компонентов, которые вносит плагин, сгруппированных как Skills (навыки и команды), Agents, Hooks и MCP серверы, вместе с оценкой того, сколько токенов он добавляет к каждой сессии.896Показать инвентарь компонентов плагина и прогнозируемую стоимость в токенах. Вывод содержит список всех компонентов, которые вносит плагин, сгруппированных как Skills, Agents, Hooks, MCP серверы и LSP серверы, вместе с оценкой того, сколько токенов он добавляет к каждой сессии. Группа Skills включает как записи `skills/`, так и `commands/`.

893 897 

894```bash theme={null}898```bash theme={null}

895claude plugin details <name>899claude plugin details <name>


922 Agents (0)926 Agents (0)

923 Hooks (1) (harness-only — no model context cost)927 Hooks (1) (harness-only — no model context cost)

924 MCP servers (0)928 MCP servers (0)

929 LSP servers (0)

925 930 

926Projected token cost931Projected token cost

927 Always-on: ~180 tok added to every session932 Always-on: ~180 tok added to every session

Details

188* **Локальный процесс должен продолжать работать**: Remote Control работает как локальный процесс. Если вы закроете терминал, выйдете из VS Code или иным образом остановите процесс `claude`, сеанс завершится.188* **Локальный процесс должен продолжать работать**: Remote Control работает как локальный процесс. Если вы закроете терминал, выйдете из VS Code или иным образом остановите процесс `claude`, сеанс завершится.

189* **Продолжительный сбой сети**: если ваш компьютер включен, но не может достичь сеть более чем примерно на 10 минут, сеанс истекает и процесс завершается. Запустите `claude remote-control` снова, чтобы начать новый сеанс.189* **Продолжительный сбой сети**: если ваш компьютер включен, но не может достичь сеть более чем примерно на 10 минут, сеанс истекает и процесс завершается. Запустите `claude remote-control` снова, чтобы начать новый сеанс.

190* **Ultraplan отключает Remote Control**: запуск сеанса [ultraplan](/ru/ultraplan) отключает любой активный сеанс Remote Control, потому что обе функции занимают интерфейс claude.ai/code и одновременно может быть подключена только одна.190* **Ultraplan отключает Remote Control**: запуск сеанса [ultraplan](/ru/ultraplan) отключает любой активный сеанс Remote Control, потому что обе функции занимают интерфейс claude.ai/code и одновременно может быть подключена только одна.

191* **Некоторые команды работают только локально**: команды, которые открывают интерактивный выбор в терминале, такие как `/mcp`, `/plugin` или `/resume`, работают только из локального CLI. Команды, которые выводят текстовый результат, включая `/compact`, `/clear`, `/context`, `/usage`, `/exit`, `/extra-usage`, `/recap` и `/reload-plugins`, работают с мобильных устройств и веб-браузеров.191* **Некоторые команды работают только локально**: команды, которые открывают интерактивный выбор в терминале, такие как `/mcp`, `/plugin` или `/resume`, работают только из локального CLI. Команды, которые выводят текстовый результат, включая `/compact`, `/clear`, `/context`, `/usage`, `/exit`, `/usage-credits`, `/recap` и `/reload-plugins`, работают с мобильных устройств и веб-браузеров.

192 192 

193## Устранение неполадок193## Устранение неполадок

194 194 

Details

12 12 

13Запланированные задачи позволяют Claude автоматически повторно запускать подсказку через определённый интервал. Используйте их для опроса развёртывания, контроля pull request, проверки долгоживущей сборки или напоминания себе о чём-то позже в сеансе. Чтобы реагировать на события по мере их возникновения вместо опроса, см. [Channels](/ru/channels): ваш CI может отправить сбой непосредственно в сеанс. Чтобы продолжить работу сеанса от одного хода к другому до выполнения условия, а не через интервал, см. [`/goal`](/ru/goal).13Запланированные задачи позволяют Claude автоматически повторно запускать подсказку через определённый интервал. Используйте их для опроса развёртывания, контроля pull request, проверки долгоживущей сборки или напоминания себе о чём-то позже в сеансе. Чтобы реагировать на события по мере их возникновения вместо опроса, см. [Channels](/ru/channels): ваш CI может отправить сбой непосредственно в сеанс. Чтобы продолжить работу сеанса от одного хода к другому до выполнения условия, а не через интервал, см. [`/goal`](/ru/goal).

14 14 

15Задачи привязаны к сеансу: они существуют в текущем разговоре и останавливаются при запуске нового. Возобновление с помощью `--resume` или `--continue` восстанавливает любую задачу, которая не [истекла](#seven-day-expiry): повторяющуюся задачу, созданную в течение последних 7 дней, или одноразовую, чьё запланированное время ещё не наступило. Для планирования, которое сохраняется независимо от любого сеанса, используйте [Routines](/ru/routines), [Desktop запланированные задачи](/ru/desktop-scheduled-tasks) или [GitHub Actions](/ru/github-actions).15Задачи привязаны к сеансу: они существуют в текущем разговоре и останавливаются при запуске нового. Возобновление с помощью `--resume` или `--continue` восстанавливает любую задачу, которая не [истекла](#seven-day-expiry): повторяющуюся задачу, созданную в течение последних 7 дней, или одноразовую, чьё запланированное время ещё не наступило. Для планирования, которое сохраняется независимо от любого сеанса, используйте [Routines](/ru/routines) для создания процедуры на управляемой Anthropic инфраструктуре, установите [Desktop запланированные задачи](/ru/desktop-scheduled-tasks) или используйте [GitHub Actions](/ru/github-actions).

16 16 

17## Сравните варианты планирования17## Сравните варианты планирования

18 18 

settings.md +4 −3

Details

224| `prUrlTemplate` | Шаблон URL для значка PR, показываемого в нижнем колонтитуле и в сводках результатов инструмента. Заменяет `{host}`, `{owner}`, `{repo}`, `{number}` и `{url}` из URL PR, сообщаемого `gh`. Используйте для указания ссылок PR на внутренний инструмент проверки кода вместо `github.com`. Не влияет на автоссылки `#123` в прозе Claude | `"https://reviews.example.com/{owner}/{repo}/pull/{number}"` |224| `prUrlTemplate` | Шаблон URL для значка PR, показываемого в нижнем колонтитуле и в сводках результатов инструмента. Заменяет `{host}`, `{owner}`, `{repo}`, `{number}` и `{url}` из URL PR, сообщаемого `gh`. Используйте для указания ссылок PR на внутренний инструмент проверки кода вместо `github.com`. Не влияет на автоссылки `#123` в прозе Claude | `"https://reviews.example.com/{owner}/{repo}/pull/{number}"` |

225| `respectGitignore` | Контролировать, соблюдает ли средство выбора файлов `@` шаблоны `.gitignore`. Когда `true` (по умолчанию), файлы, соответствующие шаблонам `.gitignore`, исключаются из предложений | `false` |225| `respectGitignore` | Контролировать, соблюдает ли средство выбора файлов `@` шаблоны `.gitignore`. Когда `true` (по умолчанию), файлы, соответствующие шаблонам `.gitignore`, исключаются из предложений | `false` |

226| `showClearContextOnPlanAccept` | Показать опцию "очистить контекст" на экране принятия плана. По умолчанию: `false`. Установите на `true`, чтобы восстановить опцию | `true` |226| `showClearContextOnPlanAccept` | Показать опцию "очистить контекст" на экране принятия плана. По умолчанию: `false`. Установите на `true`, чтобы восстановить опцию | `true` |

227| `showThinkingSummaries` | Показать [расширенное мышление](/ru/model-config#extended-thinking) резюме в интерактивных сеансах. Когда не установлено или `false` (по умолчанию в интерактивном режиме), блоки мышления редактируются API и показываются как свернутая заглушка. Редактирование изменяет только то, что вы видите, а не то, что генерирует модель: чтобы снизить расходы на мышление, [снизьте бюджет или отключите мышление](/ru/model-config#extended-thinking) вместо этого. Неинтерактивный режим (`-p`) и вызывающие SDK всегда получают резюме независимо от этого параметра | `true` |227| `showThinkingSummaries` | Показать [расширенное мышление](/ru/model-config#extended-thinking) резюме в интерактивных сеансах. Когда не установлено или `false` (по умолчанию в интерактивном режиме), блоки мышления редактируются API и показываются как свернутая заглушка. Редактирование изменяет только то, что вы видите, а не то, что генерирует модель: чтобы снизить расходы на мышление, [снизьте бюджет или отключите мышление](/ru/model-config#extended-thinking) вместо этого. Этот параметр не имеет эффекта в неинтерактивном режиме (`-p`), Agent SDK или расширениях IDE, таких как VS Code | `true` |

228| `showTurnDuration` | Показывать сообщения о продолжительности хода после ответов, например "Cooked for 1m 6s". По умолчанию: `true`. Появляется в `/config` как **Show turn duration** | `false` |228| `showTurnDuration` | Показывать сообщения о продолжительности хода после ответов, например "Cooked for 1m 6s". По умолчанию: `true`. Появляется в `/config` как **Show turn duration** | `false` |

229| `skillListingBudgetFraction` | {/* min-version: 2.1.105 */}Доля окна контекста модели, зарезервированная для [списка skills](/ru/skills#skill-descriptions-are-cut-short), который видит Claude каждый ход (по умолчанию: `0.01` = 1%). Когда список превышает бюджет, описания для наименее используемых skills сворачиваются до простых имен, чтобы Claude все еще мог их вызывать, но не видел бы, почему. Увеличьте, чтобы сохранить больше описаний видимыми за счет большего контекста за ход. `/doctor` показывает текущее количество усечений и какие skills затронуты. Требует Claude Code v2.1.105 или позже | `0.02` |229| `skillListingBudgetFraction` | {/* min-version: 2.1.105 */}Доля окна контекста модели, зарезервированная для [списка skills](/ru/skills#skill-descriptions-are-cut-short), который видит Claude каждый ход (по умолчанию: `0.01` = 1%). Когда список превышает бюджет, описания для наименее используемых skills сворачиваются до простых имен, чтобы Claude все еще мог их вызывать, но не видел бы, почему. Увеличьте, чтобы сохранить больше описаний видимыми за счет большего контекста за ход. `/doctor` показывает текущее количество усечений и какие skills затронуты. Требует Claude Code v2.1.105 или позже | `0.02` |

230| `skillOverrides` | {/* min-version: 2.1.129 */}Переопределения видимости для каждого skill, ключ которых - имя skill. Значение - `"on"`, `"name-only"`, `"user-invocable-only"` или `"off"`. Позволяет скрыть или свернуть skill без редактирования его SKILL.md. Не применяется к plugin skills, которые управляются через `/plugin`. Меню `/skills` записывает эти значения в `.claude/settings.local.json`. См. [Переопределить видимость skill из параметров](/ru/skills#override-skill-visibility-from-settings). Требует Claude Code v2.1.129 или позже | `{"legacy-context": "name-only", "deploy": "off"}` |230| `skillOverrides` | {/* min-version: 2.1.129 */}Переопределения видимости для каждого skill, ключ которых - имя skill. Значение - `"on"`, `"name-only"`, `"user-invocable-only"` или `"off"`. Позволяет скрыть или свернуть skill без редактирования его SKILL.md. Не применяется к plugin skills, которые управляются через `/plugin`. Меню `/skills` записывает эти значения в `.claude/settings.local.json`. См. [Переопределить видимость skill из параметров](/ru/skills#override-skill-visibility-from-settings). Требует Claude Code v2.1.129 или позже | `{"legacy-context": "name-only", "deploy": "off"}` |


269| `worktree.baseRef` | Какой ref новые worktrees ветвятся от. `"fresh"` (по умолчанию) ветвится от `origin/<default-branch>` для чистого дерева, соответствующего удаленному. `"head"` ветвится от вашего текущего локального `HEAD`, поэтому неотправленные коммиты и состояние ветки функции присутствуют в worktree. Применяется к `--worktree`, инструменту `EnterWorktree` и изоляции subagent | `"head"` |269| `worktree.baseRef` | Какой ref новые worktrees ветвятся от. `"fresh"` (по умолчанию) ветвится от `origin/<default-branch>` для чистого дерева, соответствующего удаленному. `"head"` ветвится от вашего текущего локального `HEAD`, поэтому неотправленные коммиты и состояние ветки функции присутствуют в worktree. Применяется к `--worktree`, инструменту `EnterWorktree` и изоляции subagent | `"head"` |

270| `worktree.symlinkDirectories` | Каталоги для создания символических ссылок из основного репозитория в каждый worktree, чтобы избежать дублирования больших каталогов на диске. По умолчанию никакие каталоги не создаются символическими ссылками | `["node_modules", ".cache"]` |270| `worktree.symlinkDirectories` | Каталоги для создания символических ссылок из основного репозитория в каждый worktree, чтобы избежать дублирования больших каталогов на диске. По умолчанию никакие каталоги не создаются символическими ссылками | `["node_modules", ".cache"]` |

271| `worktree.sparsePaths` | Каталоги для проверки в каждом worktree через git sparse-checkout. На диск записываются только перечисленные пути, что быстрее в больших монорепозиториях | `["packages/my-app", "shared/utils"]` |271| `worktree.sparsePaths` | Каталоги для проверки в каждом worktree через git sparse-checkout. На диск записываются только перечисленные пути, что быстрее в больших монорепозиториях | `["packages/my-app", "shared/utils"]` |

272| `worktree.bgIsolation` | {/* min-version: 2.1.143 */}Режим изоляции для [фоновых сеансов](/ru/agent-view#how-file-edits-are-isolated). `"worktree"` (по умолчанию) блокирует `Edit`/`Write` в основной проверке до вызова `EnterWorktree`. `"none"` позволяет фоновым заданиям редактировать рабочую копию напрямую. Требует Claude Code v2.1.143 или позже | `"none"` |

272 273 

273Чтобы скопировать файлы, игнорируемые gitignore, такие как `.env`, в новые worktrees, используйте [файл `.worktreeinclude`](/ru/worktrees#copy-gitignored-files-into-worktrees) в корне вашего проекта вместо параметра.274Чтобы скопировать файлы, игнорируемые gitignore, такие как `.env`, в новые worktrees, используйте [файл `.worktreeinclude`](/ru/worktrees#copy-gitignored-files-into-worktrees) в корне вашего проекта вместо параметра.

274 275 

275### Параметры разрешений276### Параметры разрешений

276 277 

277| Ключи | Описание | Пример |278| Ключи | Описание | Пример |

278| :---------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------- |279| :---------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------- |

279| `allow` | Массив правил разрешений для разрешения использования инструмента. См. [Синтаксис правила разрешения](#permission-rule-syntax) ниже для деталей сопоставления шаблонов | `[ "Bash(git diff *)" ]` |280| `allow` | Массив правил разрешений для разрешения использования инструмента. См. [Синтаксис правила разрешения](#permission-rule-syntax) ниже для деталей сопоставления шаблонов | `[ "Bash(git diff *)" ]` |

280| `ask` | Массив правил разрешений для запроса подтверждения при использовании инструмента. См. [Синтаксис правила разрешения](#permission-rule-syntax) ниже | `[ "Bash(git push *)" ]` |281| `ask` | Массив правил разрешений для запроса подтверждения при использовании инструмента. См. [Синтаксис правила разрешения](#permission-rule-syntax) ниже | `[ "Bash(git push *)" ]` |

281| `deny` | Массив правил разрешений для запрета использования инструмента. Используйте это для исключения чувствительных файлов из доступа Claude Code. См. [Синтаксис правила разрешения](#permission-rule-syntax) и [Ограничения разрешений Bash](/ru/permissions#tool-specific-permission-rules) | `[ "WebFetch", "Bash(curl *)", "Read(./.env)", "Read(./secrets/**)" ]` |282| `deny` | Массив правил разрешений для запрета использования инструмента. Используйте это для исключения чувствительных файлов из доступа Claude Code. См. [Синтаксис правила разрешения](#permission-rule-syntax) и [Ограничения разрешений Bash](/ru/permissions#tool-specific-permission-rules) | `[ "WebFetch", "Bash(curl *)", "Read(./.env)", "Read(./secrets/**)" ]` |

282| `additionalDirectories` | Дополнительные [рабочие каталоги](/ru/permissions#working-directories) для доступа к файлам. Большинство конфигурации `.claude/` [не обнаруживается](/ru/permissions#additional-directories-grant-file-access-not-configuration) из этих каталогов | `[ "../docs/" ]` |283| `additionalDirectories` | Дополнительные [рабочие каталоги](/ru/permissions#working-directories) для доступа к файлам. Большинство конфигурации `.claude/` [не обнаруживается](/ru/permissions#additional-directories-grant-file-access-not-configuration) из этих каталогов | `[ "../docs/" ]` |

283| `defaultMode` | Режим [разрешения](/ru/permission-modes) по умолчанию при открытии Claude Code. Допустимые значения: `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions`. Флаг CLI `--permission-mode` переопределяет этот параметр для одного сеанса | `"acceptEdits"` |284| `defaultMode` | Режим [разрешения](/ru/permission-modes) по умолчанию при открытии Claude Code. Допустимые значения: `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions`. {/* min-version: 2.1.142 */}Начиная с Claude Code v2.1.142, `auto` игнорируется при установке в параметрах проекта или локальных параметрах (`.claude/settings.json`, `.claude/settings.local.json`), поэтому репозиторий не может предоставить себе автоматический режим. Установите его в `~/.claude/settings.json` вместо этого. Флаг CLI `--permission-mode` переопределяет этот параметр для одного сеанса | `"acceptEdits"` |

284| `disableBypassPermissionsMode` | Установите на `"disable"`, чтобы предотвратить активацию режима `bypassPermissions`. Это отключает флаг командной строки `--dangerously-skip-permissions`. Обычно размещается в [управляемых параметрах](/ru/permissions#managed-settings) для применения организационной политики, но работает из любой области | `"disable"` |285| `disableBypassPermissionsMode` | Установите на `"disable"`, чтобы предотвратить активацию режима `bypassPermissions`. Это отключает флаг командной строки `--dangerously-skip-permissions`. Обычно размещается в [управляемых параметрах](/ru/permissions#managed-settings) для применения организационной политики, но работает из любой области | `"disable"` |

285| `skipDangerousModePermissionPrompt` | Пропустить подтверждение, показываемое перед входом в режим обхода разрешений через `--dangerously-skip-permissions` или `defaultMode: "bypassPermissions"`. Игнорируется при установке в параметрах проекта (`.claude/settings.json`) для предотвращения автоматического обхода подтверждения ненадежными репозиториями | `true` |286| `skipDangerousModePermissionPrompt` | Пропустить подтверждение, показываемое перед входом в режим обхода разрешений через `--dangerously-skip-permissions` или `defaultMode: "bypassPermissions"`. Игнорируется при установке в параметрах проекта (`.claude/settings.json`) для предотвращения автоматического обхода подтверждения ненадежными репозиториями | `true` |

286 287 

skills.md +3 −3

Details

437Skills и [subagents](/ru/sub-agents) работают вместе в двух направлениях:437Skills и [subagents](/ru/sub-agents) работают вместе в двух направлениях:

438 438 

439| Подход | Системная подсказка | Задача | Также загружает |439| Подход | Системная подсказка | Задача | Также загружает |

440| :------------------------ | :---------------------------------------- | :----------------------------- | :-------------------------------------------- |440| :------------------------ | :--------------------- | :----------------------------- | :-------------------------------------------------------------- |

441| Skill с `context: fork` | От типа агента (`Explore`, `Plan` и т.д.) | Содержимое SKILL.md | CLAUDE.md |441| Skill с `context: fork` | От типа агента | Содержимое SKILL.md | CLAUDE.md, кроме случаев, когда агент является Explore или Plan |

442| Subagent с полем `skills` | Тело markdown subagent | Сообщение делегирования Claude | Предварительно загруженные skills + CLAUDE.md |442| Subagent с полем `skills` | Тело markdown subagent | Сообщение делегирования Claude | Предварительно загруженные skills + CLAUDE.md |

443 443 

444С `context: fork` вы пишете задачу в своём skill и выбираете тип агента для её выполнения. Для обратного (определение пользовательского subagent, который использует skills как справочный материал), см. [Subagents](/ru/sub-agents#preload-skills-into-subagents).444С `context: fork` вы пишете задачу в своём skill и выбираете тип агента для её выполнения. Встроенные агенты Explore и Plan [пропускают CLAUDE.md и git status](/ru/sub-agents#what-loads-at-startup), чтобы сохранить их контекст небольшим, поэтому forked skill, использующий `agent: Explore`, видит только содержимое SKILL.md и собственную системную подсказку агента. Для обратного случая, где вы определяете пользовательский subagent, который использует skills как справочный материал, см. [Subagents](/ru/sub-agents#preload-skills-into-subagents).

445 445 

446#### Пример: Research skill, используя Explore agent446#### Пример: Research skill, используя Explore agent

447 447 

statusline.md +12 −7

Details

916 916 

917### Конфигурация Windows917### Конфигурация Windows

918 918 

919На Windows Claude Code запускает команды строки состояния через Git Bash, когда Git Bash установлен, или через PowerShell, когда Git Bash отсутствует. Чтобы запустить скрипт PowerShell как вашу строку состояния, вызовите его через `powershell`; это работает из любой оболочки:919На Windows Claude Code запускает команды строки состояния через Git Bash, когда Git Bash установлен, или через PowerShell, когда Git Bash отсутствует.

920 

921Git Bash обрабатывает неэкранированные обратные слэши как символы экранирования, поэтому путь в стиле Windows, такой как `C:\Users\username\script.mjs`, достигает средства запуска скрипта с удалёнными разделителями и команда не выполняется без видимой ошибки. Записывайте пути к файлам в строке `command` с прямыми слэшами, как показано в примерах ниже. Сокращение `~` также работает и расширяется до вашего домашнего каталога Windows.

922 

923Чтобы запустить скрипт PowerShell как вашу строку состояния, вызовите его через `powershell`. Это работает независимо от того, маршрутизирует ли Claude Code команду через Git Bash или PowerShell:

920 924 

921<CodeGroup>925<CodeGroup>

922 ```json settings.json theme={null}926 ```json settings.json theme={null}


943 ```947 ```

944</CodeGroup>948</CodeGroup>

945 949 

946Или запустите скрипт Bash напрямую:950Или запустите скрипт Bash напрямую, когда Git Bash установлен:

947 951 

948<CodeGroup>952<CodeGroup>

949 ```json settings.json theme={null}953 ```json settings.json theme={null}


999* Убедитесь, что ваш скрипт исполняемый: `chmod +x ~/.claude/statusline.sh`1003* Убедитесь, что ваш скрипт исполняемый: `chmod +x ~/.claude/statusline.sh`

1000* Проверьте, что ваш скрипт выводит в stdout, а не stderr1004* Проверьте, что ваш скрипт выводит в stdout, а не stderr

1001* Запустите ваш скрипт вручную, чтобы убедиться, что он выводит результат1005* Запустите ваш скрипт вручную, чтобы убедиться, что он выводит результат

1006* В Windows с установленным Git Bash обратные слэши в пути `command` вероятно будут использованы как символы экранирования перед запуском скрипта. Используйте прямые слэши в пути. См. [Конфигурация Windows](#windows-configuration).

1002* Если `disableAllHooks` установлен на `true` в ваших настройках, строка состояния также отключена. Удалите эту настройку или установите её на `false`, чтобы повторно включить.1007* Если `disableAllHooks` установлен на `true` в ваших настройках, строка состояния также отключена. Удалите эту настройку или установите её на `false`, чтобы повторно включить.

1003* Запустите `claude --debug`, чтобы записать код выхода и stderr из первого вызова строки состояния в сеансе1008* Запустите `claude --debug`, чтобы записать код выхода и stderr из первого вызова строки состояния в сеансе

1004* Попросите Claude прочитать ваш файл настроек и выполнить команду `statusLine` напрямую, чтобы выявить ошибки1009* Попросите Claude прочитать ваш файл настроек и выполнить команду `statusLine` напрямую, чтобы выявить ошибки


1042* Если вы видите повреждённый текст, попробуйте упростить ваш скрипт до простого текстового вывода1047* Если вы видите повреждённый текст, попробуйте упростить ваш скрипт до простого текстового вывода

1043* Многострочные строки состояния с кодами экранирования более подвержены проблемам отображения, чем однострочный простой текст1048* Многострочные строки состояния с кодами экранирования более подвержены проблемам отображения, чем однострочный простой текст

1044 1049 

1050**Требуется доверие рабочей области**

1051 

1052* Команда строки состояния запускается только если вы приняли диалог доверия рабочей области для текущего каталога. Поскольку `statusLine` выполняет команду оболочки, она требует того же принятия доверия, что и hooks и другие параметры, выполняющие оболочку.

1053* Если доверие не принято, вы увидите уведомление `statusline skipped · restart to fix` вместо вывода вашей строки состояния. Перезагрузите Claude Code и примите запрос доверия, чтобы включить его.

1054 

1045**Ошибки скрипта или зависания**1055**Ошибки скрипта или зависания**

1046 1056 

1047* Скрипты, которые выходят с ненулевыми кодами или не выводят результат, вызывают пустую строку состояния1057* Скрипты, которые выходят с ненулевыми кодами или не выводят результат, вызывают пустую строку состояния


1049* Если новое обновление срабатывает, пока медленный скрипт работает, выполнение скрипта отменяется1059* Если новое обновление срабатывает, пока медленный скрипт работает, выполнение скрипта отменяется

1050* Протестируйте ваш скрипт независимо с макетными входными данными перед его настройкой1060* Протестируйте ваш скрипт независимо с макетными входными данными перед его настройкой

1051 1061 

1052**Требуется доверие рабочей области**

1053 

1054* Команда строки состояния запускается только если вы приняли диалог доверия рабочей области для текущего каталога. Поскольку `statusLine` выполняет команду оболочки, она требует того же принятия доверия, что и hooks и другие параметры, выполняющие оболочку.

1055* Если доверие не принято, вы увидите уведомление `statusline skipped · restart to fix` вместо вывода вашей строки состояния. Перезагрузите Claude Code и примите запрос доверия, чтобы включить его.

1056 

1057**Уведомления делят строку состояния**1062**Уведомления делят строку состояния**

1058 1063 

1059* Системные уведомления, такие как ошибки MCP сервера и автоматические обновления, отображаются на правой стороне той же строки, что и ваша строка состояния. Временные уведомления, такие как предупреждение о низком контексте, также циклируют через эту область.1064* Системные уведомления, такие как ошибки MCP сервера и автоматические обновления, отображаются на правой стороне той же строки, что и ваша строка состояния. Временные уведомления, такие как предупреждение о низком контексте, также циклируют через эту область.

sub-agents.md +32 −2

Details

37 37 

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

39 39 

40Explore и Plan пропускают ваши файлы CLAUDE.md и статус git родительской сессии, чтобы исследование было быстрым и экономичным. Все остальные встроенные и [пользовательские subagents](#configure-subagents) загружают оба. Для полного разбора того, что достигает subagent, см. [что загружается при запуске](#what-loads-at-startup).

41 

40<Tabs>42<Tabs>

41 <Tab title="Explore">43 <Tab title="Explore">

42 Быстрый агент, доступный только для чтения, оптимизированный для поиска и анализа кодовых баз.44 Быстрый агент, доступный только для чтения, оптимизированный для поиска и анализа кодовых баз.


652 654 

653Это работает с встроенными и пользовательскими subagents, и выбор сохраняется при возобновлении сессии.655Это работает с встроенными и пользовательскими subagents, и выбор сохраняется при возобновлении сессии.

654 656 

655Для plugin-предоставленного subagent передайте имя с областью видимости: `claude --agent <plugin-name>:<agent-name>`. Если plugin размещает агента в подпапке своей директории `agents/`, включите подпапку в имя с областью видимости, например `claude --agent my-plugin:review:security`.657Для plugin-предоставленного subagent вы можете передать просто имя агента и Claude Code найдёт его:

658 

659```bash theme={null}

660claude --agent security-reviewer

661```

662 

663Если несколько plugins предоставляют агентов с одинаковым именем, передайте имя с областью видимости для уточнения:

664 

665```bash theme={null}

666claude --agent my-plugin:security-reviewer

667```

668 

669Если plugin размещает агента в подпапке своей директории `agents/`, включите подпапку в имя с областью видимости, например `claude --agent my-plugin:review:security`.

656 670 

657Чтобы сделать это по умолчанию для каждой сессии в проекте, установите `agent` в `.claude/settings.json`:671Чтобы сделать это по умолчанию для каждой сессии в проекте, установите `agent` в `.claude/settings.json`:

658 672 


686 700 

687#### Изолируйте высокообъёмные операции701#### Изолируйте высокообъёмные операции

688 702 

689Одно из наиболее эффективных применений subagents — изоляция операций, которые производят большой объём выходных данных. Запуск тестов, получение документации или обработка файлов журналов может потребить значительный контекст. Делегируя эти subagent, подробный выход остаётся в контексте subagent, пока только релевантное резюме возвращается в основной разговор.703Одно из наиболее эффективных применений subagents — изоляция операций, которые производят большой объём выходных данных. Запуск тестов, получение документации или обработка файлов журналов может потребить значительный контекст. Делегируя эти операции subagent, подробный выход остаётся в контексте subagent, пока только релевантное резюме возвращается в основной разговор.

690 704 

691```text theme={null}705```text theme={null}

692Use a subagent to run the test suite and report only the failing tests with their error messages706Use a subagent to run the test suite and report only the failing tests with their error messages


741 755 

742### Управляйте контекстом subagent756### Управляйте контекстом subagent

743 757 

758#### Что загружается при запуске

759 

760Каждый subagent начинает со свежего, изолированного контекстного окна. Он не видит историю вашего разговора, навыки, которые вы уже вызвали, или файлы, которые Claude уже прочитал. Claude составляет сообщение делегирования, которое резюмирует задачу, и subagent работает на основе этого. Исключением является [fork](#fork-the-current-conversation), который наследует родительский разговор вместо начала с нуля.

761 

762Начальный контекст non-fork subagent содержит:

763 

764* **System prompt**: собственное приглашение агента плюс детали окружения, которые добавляет Claude Code, а не полное системное приглашение Claude Code. Пользовательские subagents определяют свои в [markdown body](#write-subagent-files) или поле `prompt`. Встроенные агенты имеют предопределённые приглашения.

765* **Task message**: приглашение делегирования, которое Claude пишет при передаче работы.

766* **CLAUDE.md and memory**: каждый уровень [иерархии памяти](/ru/memory#how-claude-md-files-load), который загружает основной разговор, включая `~/.claude/CLAUDE.md`, правила проекта, `CLAUDE.local.md` и управляемые файлы политики. Встроенные агенты Explore и Plan пропускают это.

767* **Git status**: снимок, сделанный в начале родительской сессии. Отсутствует, когда рабочая директория не является Git репозиторием или когда [`includeGitInstructions`](/ru/settings#available-settings) имеет значение `false`. Explore и Plan пропускают это независимо.

768* **Preloaded skills**: полное содержание любого навыка, названного в поле [`skills`](#preload-skills-into-subagents) агента. Встроенные агенты не предзагружают навыки.

769 

770Explore и Plan — единственные subagents, которые опускают CLAUDE.md и git status. Нет поля frontmatter или параметра per-agent для изменения того, какие агенты их пропускают.

771 

772Основной разговор читает результаты Explore и Plan с полным контекстом CLAUDE.md, поэтому большинству правил не нужно достигать самого subagent. Если правило должно, например "ignore the `vendor/` directory," переформулируйте его в приглашении, которое вы даёте Claude при делегировании.

773 

744#### Возобновите subagents774#### Возобновите subagents

745 775 

746Каждый вызов subagent создаёт новый экземпляр со свежим контекстом. Чтобы продолжить работу существующего subagent вместо начала с нуля, попросите Claude возобновить его.776Каждый вызов subagent создаёт новый экземпляр со свежим контекстом. Чтобы продолжить работу существующего subagent вместо начала с нуля, попросите Claude возобновить его.

Details

45| `TaskUpdate` | Обновляет статус задачи, зависимости, сведения или удаляет задачи | Нет |45| `TaskUpdate` | Обновляет статус задачи, зависимости, сведения или удаляет задачи | Нет |

46| `TeamCreate` | Создает [команду агентов](/ru/agent-teams) с несколькими товарищами по команде. Доступно только при установке `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` | Нет |46| `TeamCreate` | Создает [команду агентов](/ru/agent-teams) с несколькими товарищами по команде. Доступно только при установке `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` | Нет |

47| `TeamDelete` | Распускает команду агентов и очищает процессы товарищей по команде. Доступно только при установке `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` | Нет |47| `TeamDelete` | Распускает команду агентов и очищает процессы товарищей по команде. Доступно только при установке `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` | Нет |

48| `TodoWrite` | Управляет контрольным списком задач сеанса. Доступно в неинтерактивном режиме и [Agent SDK](/ru/headless); интерактивные сеансы используют TaskCreate, TaskGet, TaskList и TaskUpdate вместо этого | Нет |48| `TodoWrite` | {/* min-version: 2.1.142 */}Управляет контрольным списком задач сеанса. Отключено по умолчанию начиная с версии 2.1.142 в пользу `TaskCreate`, `TaskGet`, `TaskList` и `TaskUpdate`. Установите `CLAUDE_CODE_ENABLE_TASKS=0` для повторного включения | Нет |

49| `ToolSearch` | Ищет и загружает отложенные инструменты, когда включен [поиск инструментов](/ru/mcp#scale-with-mcp-tool-search) | Нет |49| `ToolSearch` | Ищет и загружает отложенные инструменты, когда включен [поиск инструментов](/ru/mcp#scale-with-mcp-tool-search) | Нет |

50| `WaitForMcpServers` | {/* min-version: 2.1.142 */}Ожидает один или несколько [MCP servers](/ru/mcp), которые все еще подключаются в фоне, чтобы запрос мог использовать их инструменты без перезагрузки сеанса. Claude вызывает его, когда требуемый сервер еще не подключен. Появляется только когда [поиск инструментов](/ru/mcp#scale-with-mcp-tool-search) отключен, так как `ToolSearch` обрабатывает ожидание, когда он включен | Нет |

50| `WebFetch` | Получает содержимое с указанного URL. См. [поведение инструмента WebFetch](#webfetch-tool-behavior) | Да |51| `WebFetch` | Получает содержимое с указанного URL. См. [поведение инструмента WebFetch](#webfetch-tool-behavior) | Да |

51| `WebSearch` | Выполняет веб-поиск. См. [поведение инструмента WebSearch](#websearch-tool-behavior) | Да |52| `WebSearch` | Выполняет веб-поиск. См. [поведение инструмента WebSearch](#websearch-tool-behavior) | Да |

52| `Write` | Создает или перезаписывает файлы. См. [поведение инструмента Write](#write-tool-behavior) | Да |53| `Write` | Создает или перезаписывает файлы. См. [поведение инструмента Write](#write-tool-behavior) | Да |

ultrareview.md +1 −1

Details

56 56 

57Подписчики Pro и Max получают три бесплатных запуска ultrareview для пробы функции. Эти три запуска — это одноразовое выделение на учетную запись и не обновляются. После того как вы используете все три или после окончания периода бесплатных запусков, каждый анализ выставляется как дополнительное использование и обычно стоит от 5 до 20 долларов в зависимости от размера изменения. Запуск считается начатым после запуска удаленной сессии, поэтому анализ, который вы остановили рано или который не завершился, все равно использует бесплатный запуск. Для платного анализа дополнительное использование выставляется счет только за ту часть, которая была выполнена.57Подписчики Pro и Max получают три бесплатных запуска ultrareview для пробы функции. Эти три запуска — это одноразовое выделение на учетную запись и не обновляются. После того как вы используете все три или после окончания периода бесплатных запусков, каждый анализ выставляется как дополнительное использование и обычно стоит от 5 до 20 долларов в зависимости от размера изменения. Запуск считается начатым после запуска удаленной сессии, поэтому анализ, который вы остановили рано или который не завершился, все равно использует бесплатный запуск. Для платного анализа дополнительное использование выставляется счет только за ту часть, которая была выполнена.

58 58 

59Поскольку ultrareview всегда выставляет счет как дополнительное использование вне бесплатных запусков, ваша учетная запись или организация должны иметь включенное дополнительное использование перед запуском платного анализа. Если дополнительное использование не включено, Claude Code блокирует запуск и ссылает вас на параметры выставления счетов, где вы можете его включить. Вы также можете запустить `/extra-usage`, чтобы проверить или изменить текущий параметр.59Поскольку ultrareview всегда выставляет счет как дополнительное использование вне бесплатных запусков, ваша учетная запись или организация должны иметь включенное дополнительное использование перед запуском платного анализа. Если дополнительное использование не включено, Claude Code блокирует запуск и ссылает вас на параметры выставления счетов, где вы можете его включить. Вы также можете запустить `/usage-credits` для проверки или изменения текущего параметра.

60 60 

61## Отслеживание выполняемого анализа61## Отслеживание выполняемого анализа

62 62