Documentation — Spybara

agent-sdk/modifying-system-prompts.md +2 −2

Details

126 126

127Стиль вывода — это файл markdown с [frontmatter](/docs/ru/output-styles#frontmatter) для метаданных, за которым следует содержимое подсказки. Сохраните его в `~/.claude/output-styles/` для стиля на уровне пользователя, доступного в каждом проекте, или `.claude/output-styles/` в вашем репозитории для стиля на уровне проекта, который вы можете зафиксировать и поделиться с вашей командой.127Стиль вывода — это файл markdown с [frontmatter](/docs/ru/output-styles#frontmatter) для метаданных, за которым следует содержимое подсказки. Сохраните его в `~/.claude/output-styles/` для стиля на уровне пользователя, доступного в каждом проекте, или `.claude/output-styles/` в вашем репозитории для стиля на уровне проекта, который вы можете зафиксировать и поделиться с вашей командой.

128 128

129Пользовательский стиль вывода опускает инструкции по разработке программного обеспечения предустановки `claude_code` и использует ваши собственные. Чтобы сохранить их и наложить ваши инструкции сверху, установите `keep-coding-instructions: true` в frontmatter. Эти инструкции находятся только в полной системной подсказке Claude Code, поэтому параметр не имеет эффекта в сеансе на более короткой системной подсказке, которую вы включаете или отключаете с помощью [`CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT`](/docs/ru/env-vars#variables). Сохраняйте их, когда ваш агент всё ещё выполняет работу по разработке программного обеспечения. Опускайте их, когда вы полностью заменяете роль.129Пользовательский стиль вывода исключает инструкции по разработке программного обеспечения из предустановки `claude_code` и использует ваши собственные. Чтобы сохранить их и наложить ваши инструкции поверх, задайте `keep-coding-instructions: true` во frontmatter. Эти инструкции есть только в полном системном промпте Claude Code, поэтому настройка не действует в сессии с более коротким системным промптом; задайте [`CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT`](/docs/ru/env-vars#variables) равным `0`, чтобы выбрать полный промпт на любой модели. Сохраняйте их, когда ваш агент всё ещё выполняет работу по разработке программного обеспечения. Исключайте их, когда вы полностью заменяете роль.

130 130

131Пример ниже определяет персону рецензента кода, которая сохраняет инструкции кодирования, поскольку проверка кода всё ещё выигрывает от руководства Claude Code по безопасности и качеству кода. Сохраните его как `~/.claude/output-styles/code-reviewer.md`, чтобы сделать его доступным во всех проектах:131Пример ниже определяет персону рецензента кода, которая сохраняет инструкции кодирования, поскольку проверка кода всё ещё выигрывает от руководства Claude Code по безопасности и качеству кода. Сохраните его как `~/.claude/output-styles/code-reviewer.md`, чтобы сделать его доступным во всех проектах:

132 132

553 553

agent-sdk/python.md +2 −1

Details

2786 "prompt": str, # Задача для выполнения агентом2786 "prompt": str, # Задача для выполнения агентом

2787 "subagent_type": str | None, # Тип специализированного агента для использования2787 "subagent_type": str | None, # Тип специализированного агента для использования

2789 "run_in_background": bool | None, # Агенты запускаются в фоне по умолчанию; установите значение False для синхронного выполнения2790 "run_in_background": bool | None, # Агенты запускаются в фоне по умолчанию; установите значение False для синхронного выполнения

2790 "name": str | None, # Имя для порожденного агента2791 "name": str | None, # Имя для порожденного агента

2791 "team_name": str | None, # Устарело; игнорируется2792 "team_name": str | None, # Устарело; игнорируется

2793 "isolation": "worktree" | "remote" | None, # Режим изоляции для изменений агента2794 "isolation": "worktree" | "remote" | None, # Режим изоляции для изменений агента

2794}2795}

2795```2796```

agent-sdk/typescript.md +192 −182

Details

88 88

89| Параметр | Тип | Описание |89| Параметр | Тип | Описание |

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

93 93

94<h4 id="returns">94<h4 id="returns">

101 `startup()`101 `startup()`

102</h3>102</h3>

103 103

104Предварительно разогревает подпроцесс CLI, запуская его и завершая инициализационное рукопожатие до того, как запрос будет доступен. Возвращённый дескриптор [`WarmQuery`](#warmquery) принимает запрос позже и записывает его в уже готовый процесс, поэтому первый вызов `query()` разрешается без затрат на запуск подпроцесса и инициализацию в строке. Если вы ещё не знаете рабочую директорию сессии, используйте [`prewarm()`](#prewarm) вместо этого.104Предварительно разогревает подпроцесс CLI, запуская его и завершая инициализационное рукопожатие до того, как промпт будет доступен. Возвращённый дескриптор [`WarmQuery`](#warmquery) принимает промпт позже и записывает его в уже готовый процесс, поэтому первый вызов `query()` разрешается без затрат на запуск подпроцесса и инициализацию в строке. Если вы ещё не знаете рабочий каталог сессии, используйте вместо этого [`prewarm()`](#prewarm).

105 105

106```typescript theme={null}106```typescript theme={null}

107function startup(params?: {107function startup(params?: {

117| Параметр | Тип | Описание |117| Параметр | Тип | Описание |

118| :- | :- | :- |118| :- | :- | :- |

120| `initializeTimeoutMs` | `number` | Максимальное время в миллисекундах для ожидания инициализации подпроцесса. По умолчанию `60000`. Если инициализация не завершится вовремя, промис отклонится с ошибкой timeout |120| `initializeTimeoutMs` | `number` | Максимальное время в миллисекундах для ожидания инициализации подпроцесса. По умолчанию `60000`. Если инициализация не завершится вовремя, промис отклонится с ошибкой таймаута |

121 121

122<h4 id="returns-2">122<h4 id="returns-2">

123 Возвращаемое значение123 Возвращаемое значение

129 Пример129 Пример

130</h4>130</h4>

131 131

132Вызовите `startup()` рано, например при загрузке приложения, затем вызовите `.query()` на возвращённом дескрипторе, когда запрос будет готов. Это перемещает запуск подпроцесса и инициализацию из критического пути.132Вызовите `startup()` рано, например при загрузке приложения, затем вызовите `.query()` на возвращённом дескрипторе, когда промпт будет готов. Это выносит запуск подпроцесса и инициализацию из критического пути.

133 133

134```typescript theme={null}134```typescript theme={null}

135import { startup } from "@anthropic-ai/claude-agent-sdk";135import { startup } from "@anthropic-ai/claude-agent-sdk";

137// Оплатите стоимость запуска заранее137// Оплатите стоимость запуска заранее

138const warm = await startup({ options: { maxTurns: 3 } });138const warm = await startup({ options: { maxTurns: 3 } });

139 139

140// Позже, когда запрос готов, это происходит мгновенно140// Позже, когда промпт готов, это происходит мгновенно

141for await (const message of warm.query("What files are here?")) {141for await (const message of warm.query("What files are here?")) {

142 console.log(message);142 console.log(message);

143}143}

149 149

150*Альфа.* Запускает процесс Claude Code как запасной до того, как вы узнаете, какую сессию он будет обслуживать, чтобы вы могли привязать его к сессии позже с помощью [`claim()`](#spareprocess). Используйте его в приложении, которое загружается до того, как пользователь выберет папку. Требуется TypeScript Agent SDK v0.3.282 или позже.150*Альфа.* Запускает процесс Claude Code как запасной до того, как вы узнаете, какую сессию он будет обслуживать, чтобы вы могли привязать его к сессии позже с помощью [`claim()`](#spareprocess). Используйте его в приложении, которое загружается до того, как пользователь выберет папку. Требуется TypeScript Agent SDK v0.3.282 или позже.

151 151

152`prewarm()` завершает то же инициализационное рукопожатие, что и [`startup()`](#startup), с процессом, ожидающим в `options.cwd`, когда вы его устанавливаете, и в противном случае в приватной временной директории под вашей директорией конфигурации Claude Code. Рабочая директория сессии, её hooks `SessionStart`, её stdio MCP серверы и её CLAUDE.md и контекст git ждут требования. Запасной процесс занимает примерно 230–260 МБ памяти во время ожидания. Если ваш [`spawnClaudeCodeProcess`](#options) запускает Claude Code на другой машине или в контейнере, установите `options.cwd` в директорию, которая там существует, чтобы запасной процесс ждал в ней.152`prewarm()` завершает то же инициализационное рукопожатие, что и [`startup()`](#startup), при этом процесс ожидает в `options.cwd`, если вы его задали, а в противном случае — в приватном временном каталоге внутри вашего каталога конфигурации Claude Code. Рабочий каталог сессии, её хуки `SessionStart`, её stdio MCP-серверы, а также её CLAUDE.md и контекст git ждут привязки. Запасной процесс занимает примерно 230–260 МБ памяти во время ожидания. Если ваш [`spawnClaudeCodeProcess`](#options) запускает Claude Code на другой машине или в контейнере, установите в `options.cwd` каталог, который там существует, чтобы запасной процесс ждал в нём.

153 153

154```typescript theme={null}154```typescript theme={null}

155function prewarm(params?: {155function prewarm(params?: {

158}): Promise<SpareProcess>;158}): Promise<SpareProcess>;

159```159```

160 160

161`options` и `initializeTimeoutMs` означают то же самое, что и для `startup()`, за исключением того, что `options.cwd` устанавливает только директорию, в которой запасной процесс ждёт. Промис разрешается с [`SpareProcess`](#spareprocess) после того, как процесс завершил инициализационное рукопожатие. `prewarm()` выбрасывает исключение, если `options` устанавливает `resume`, `continue` или `forkSession`, потому что запасной процесс ещё не имеет сессии. Всё, что требование не может установить, такое как `mcpServers`, `hooks`, `canUseTool`, `settingSources`, `systemPrompt` и `plugins`, зафиксировано на время жизни запасного процесса, поэтому держите один запасной процесс на каждый отдельный набор этих параметров и предварительно разогревайте снова, когда они изменяются.161`options` и `initializeTimeoutMs` означают то же самое, что и для `startup()`, за исключением того, что `options.cwd` задаёт только каталог, в котором ждёт запасной процесс. Промис разрешается с [`SpareProcess`](#spareprocess) после того, как процесс завершил инициализационное рукопожатие. `prewarm()` выбрасывает исключение, если `options` устанавливает `resume`, `continue` или `forkSession`, потому что у запасного процесса ещё нет сессии. Всё, что привязка не может установить, например `mcpServers`, `hooks`, `canUseTool`, `settingSources`, `systemPrompt` и `plugins`, зафиксировано на время жизни запасного процесса, поэтому держите один запасной процесс на каждый отдельный набор этих параметров и выполняйте предварительный разогрев снова, когда они изменяются.

162 162

163<h4 id="example-2">163<h4 id="example-2">

164 Пример164 Пример

165</h4>165</h4>

166 166

167Предварительно разогрейте при загрузке приложения, затем требуйте запасной процесс, когда пользователь начинает сессию:167Выполните предварительный разогрев при загрузке приложения, затем привяжите запасной процесс, когда пользователь начинает сессию:

168 168

169```typescript theme={null}169```typescript theme={null}

170import { prewarm } from "@anthropic-ai/claude-agent-sdk";170import { prewarm } from "@anthropic-ai/claude-agent-sdk";

179});179});

180 180

181spare.claimed.catch((error: Error) => {181spare.claimed.catch((error: Error) => {

182 // Если сообщение не начинается с "option_not_applied", запрос не выполнился:182 // Если сообщение не начинается с "option_not_applied", промпт не выполнился:

183 // начните эту сессию с query() вместо этого183 // начните эту сессию с query() вместо этого

184 console.error("Claim failed:", error.message);184 console.error("Claim failed:", error.message);

185});185});

189 console.log(message);189 console.log(message);

190 }190 }

191} catch (error) {191} catch (error) {

192 // После отклонённого требования затребованный запрос выбрасывает исключение, как только выдаст результат с ошибкой192 // После отклонённой привязки привязанный запрос выбрасывает исключение, как только выдаст результат с ошибкой

193 console.error(`Session ended with an error: ${error}`);193 console.error(`Session ended with an error: ${error}`);

194}194}

195```195```

198 `tool()`198 `tool()`

199</h3>199</h3>

200 200

201Создаёт определение типобезопасного MCP tool для использования с SDK MCP серверами.201Создаёт типобезопасное определение инструмента MCP для использования с MCP-серверами SDK.

202 202

203```typescript theme={null}203```typescript theme={null}

204function tool<Schema extends AnyZodRawShape>(204function tool<Schema extends AnyZodRawShape>(

216 216

217| Параметр | Тип | Описание |217| Параметр | Тип | Описание |

218| :- | :- | :- |218| :- | :- | :- |

223| `extras` | `{ annotations?: `[`ToolAnnotations`](#toolannotations)`; searchHint?: string; alwaysLoad?: boolean }` | Опциональные аннотации. `annotations` предоставляет поведенческие подсказки MCP клиентам. `searchHint` — это однострочная фраза возможностей, показываемая в списке отложенных tool, когда активен [поиск tool](/docs/ru/agent-sdk/tool-search). `alwaysLoad: true` сохраняет полную схему этого tool в начальном запросе вместо отложения |223| `extras` | `{ annotations?: `[`ToolAnnotations`](#toolannotations)`; searchHint?: string; alwaysLoad?: boolean }` | Опциональные дополнительные параметры. `annotations` предоставляет клиентам поведенческие подсказки MCP. `searchHint` — это однострочная фраза о возможностях, показываемая в списке отложенных инструментов, когда активен [поиск инструментов](/docs/ru/agent-sdk/tool-search). `alwaysLoad: true` сохраняет полную схему этого инструмента в начальном промпте вместо её откладывания |

224 224

225<h4 id="toolannotations">225<h4 id="toolannotations">

226 `ToolAnnotations`226 `ToolAnnotations`

227</h4>227</h4>

228 228

229Переэкспортировано из `@modelcontextprotocol/sdk/types.js`. Все поля являются опциональными подсказками; клиенты не должны полагаться на них для решений безопасности.229Определено в `@modelcontextprotocol/sdk/types.js`. Все поля являются опциональными подсказками; клиенты не должны полагаться на них при принятии решений, связанных с безопасностью.

230 230

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

232| :- | :- | :- | :- |232| :- | :- | :- | :- |

238 238

239```typescript theme={null}239```typescript theme={null}

240import { tool } from "@anthropic-ai/claude-agent-sdk";240import { tool } from "@anthropic-ai/claude-agent-sdk";

255 `createSdkMcpServer()`255 `createSdkMcpServer()`

256</h3>256</h3>

257 257

258Создаёт экземпляр MCP сервера, который работает в том же процессе, что и ваше приложение.258Создаёт экземпляр MCP-сервера, который работает в том же процессе, что и ваше приложение.

259 259

260```typescript theme={null}260```typescript theme={null}

261function createSdkMcpServer(options: {261function createSdkMcpServer(options: {

274 274

275| Параметр | Тип | Описание |275| Параметр | Тип | Описание |

276| :- | :- | :- |276| :- | :- | :- |

281| `options.alwaysLoad` | `boolean` | Когда `true`, каждый инструмент этого сервера остаётся в начальном промпте, а не откладывается за [поиском инструментов](/docs/ru/agent-sdk/tool-search). Сочетается с `alwaysLoad` для отдельного инструмента в [`tool()`](#tool) |281| `options.alwaysLoad` | `boolean` | Когда `true`, инструменты этого сервера остаются в начальном промпте, а не откладываются за [поиском инструментов](/docs/ru/agent-sdk/tool-search). Сочетается с `alwaysLoad` для отдельного инструмента в [`tool()`](#tool) |

282| `options.timeout` | `number` | Timeout в миллисекундах для вызовов tool этого сервера. Claude Code применяет его к этому серверу вместо [`MCP_TOOL_TIMEOUT`](/docs/ru/env-vars). Передайте целое число не менее 1000. Claude Code игнорирует другие значения. Требуется TypeScript Agent SDK v0.3.248 или позже |282| `options.timeout` | `number` | Таймаут в миллисекундах для вызовов инструментов этого сервера. Claude Code применяет его к этому серверу вместо [`MCP_TOOL_TIMEOUT`](/docs/ru/env-vars). Передайте целое число не менее 1000. Claude Code игнорирует другие значения. Требуется TypeScript Agent SDK v0.3.248 или позже |

283 283

284<h3 id="listsessions">284<h3 id="listsessions">

285 `listSessions()`285 `listSessions()`

286</h3>286</h3>

287 287

288Обнаруживает и перечисляет прошлые сессии с лёгкими метаданными. Фильтруйте по директории проекта или перечисляйте сессии во всех проектах.288Обнаруживает и перечисляет прошлые сессии с облегчёнными метаданными. Фильтруйте по каталогу проекта или перечисляйте сессии во всех проектах.

289 289

290```typescript theme={null}290```typescript theme={null}

291function listSessions(options?: ListSessionsOptions): Promise<SDKSessionInfo[]>;291function listSessions(options?: ListSessionsOptions): Promise<SDKSessionInfo[]>;

297 297

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

299| :- | :- | :- | :- |299| :- | :- | :- | :- |

303 303

304<h4 id="return-type-sdksessioninfo">304<h4 id="return-type-sdksessioninfo">

305 Тип возврата: `SDKSessionInfo`305 Тип возврата: `SDKSessionInfo`

308| Свойство | Тип | Описание |308| Свойство | Тип | Описание |

309| :- | :- | :- |309| :- | :- | :- |

314| `customTitle` | `string \| undefined` | Пользовательское название сессии, когда оно установлено, например с помощью `--name`, `/rename`, вывода hook `sessionTitle` или [`renameSession()`](#renamesession). В противном случае автоматически сгенерированное название сессии, если сессия его имеет |314| `customTitle` | `string \| undefined` | Пользовательское название сессии, если оно установлено, например с помощью `--name`, `/rename`, вывода `sessionTitle` хука или [`renameSession()`](#renamesession). В противном случае — сгенерированное ИИ название сессии, если оно у сессии есть |

320 320

321<h4 id="example-3">321<h4 id="example-3">

322 Пример322 Пример

338 `getSessionMessages()`338 `getSessionMessages()`

339</h3>339</h3>

340 340

341Читает сообщения пользователя и ассистента из прошлой сессии.341Читает сообщения пользователя и ассистента из транскрипта прошлой сессии.

342 342

343```typescript theme={null}343```typescript theme={null}

344function getSessionMessages(344function getSessionMessages(

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

355| :- | :- | :- | :- |355| :- | :- | :- | :- |

360 360

361<h4 id="return-type-sessionmessage">361<h4 id="return-type-sessionmessage">

362 Тип возврата: `SessionMessage`362 Тип возврата: `SessionMessage`

372| `parent_agent_id` | `string \| null` | Для сообщений от [вложенного подагента](/docs/ru/sub-agents#let-subagents-spawn-their-own-subagents), `agentId` подагента, который его запустил. `null` для сообщений основной сессии, сообщений от подагентов верхнего уровня и более старых сессий. Требуется Claude Code v2.1.202 или позже |372| `parent_agent_id` | `string \| null` | Для сообщений от [вложенного субагента](/docs/ru/sub-agents#let-subagents-spawn-their-own-subagents) — `agentId` субагента, который его запустил. `null` для сообщений основной сессии, сообщений от субагентов верхнего уровня и более старых сессий. Требуется Claude Code v2.1.202 или позже |

373 373

374<h4 id="example-4">374<h4 id="example-4">

375 Пример375 Пример

396 `getSessionInfo()`396 `getSessionInfo()`

397</h3>397</h3>

398 398

399Читает метаданные для одной сессии по ID без сканирования полной директории проекта.399Читает метаданные одной сессии по ID без сканирования всего каталога проекта.

400 400

401```typescript theme={null}401```typescript theme={null}

402function getSessionInfo(402function getSessionInfo(

411 411

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

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

416 416

417Возвращает [`SDKSessionInfo`](#return-type-sdksessioninfo) или `undefined`, если сессия не найдена.417Возвращает [`SDKSessionInfo`](#return-type-sdksessioninfo) или `undefined`, если сессия не найдена.

418 418

420 `renameSession()`420 `renameSession()`

421</h3>421</h3>

422 422

423Переименовывает сессию, добавляя запись пользовательского названия. Повторные вызовы безопасны; побеждает самое последнее название.423Переименовывает сессию, добавляя запись пользовательского названия. Повторные вызовы безопасны; действует самое последнее название.

424 424

425```typescript theme={null}425```typescript theme={null}

426function renameSession(426function renameSession(

438| :- | :- | :- | :- |438| :- | :- | :- | :- |

442 442

443<h3 id="tagsession">443<h3 id="tagsession">

444 `tagSession()`444 `tagSession()`

445</h3>445</h3>

446 446

447Помечает сессию. Передайте `null` для очистки тега. Повторные вызовы безопасны; побеждает самый последний тег.447Помечает сессию тегом. Передайте `null` для очистки тега. Повторные вызовы безопасны; действует самый последний тег.

448 448

449```typescript theme={null}449```typescript theme={null}

450function tagSession(450function tagSession(

462| :- | :- | :- | :- |462| :- | :- | :- | :- |

466 466

467<h3 id="resolvesettings">467<h3 id="resolvesettings">

468 `resolveSettings()`468 `resolveSettings()`

469</h3>469</h3>

470 470

471Разрешает эффективные параметры Claude Code для заданной директории, используя тот же механизм слияния, что и CLI, без запуска Claude CLI. Используйте его для проверки того, какую конфигурацию увидит вызов `query()` перед его вызовом.471Вычисляет действующие настройки Claude Code для заданного каталога, используя тот же механизм объединения, что и CLI, без запуска Claude CLI. Используйте эту функцию, чтобы проверить, какую конфигурацию увидит вызов `query()`, прежде чем его выполнять.

472 472

473<Note>473<Note>

474 Эта функция находится в альфа-версии и её API может измениться перед стабилизацией.474 Эта функция находится в альфа-версии, и её API может измениться до стабилизации.

475</Note>475</Note>

476 476

477Снимок отличается от того, что применяет живая сессия `query()`:477Снимок отличается от того, что применяет живая сессия `query()`:

478 478

479* **`policyHelper`**: `resolveSettings()` читает источники MDM, включая macOS plist и Windows HKLM/HKCU, но не выполняет настроенный администратором подпроцесс `policyHelper`.479* **`policyHelper`**: `resolveSettings()` читает источники MDM, включая macOS plist и Windows HKLM/HKCU, но не выполняет настроенный администратором подпроцесс `policyHelper`.

480* **Параметры, управляемые сервером**: `resolveSettings()` не загружает [параметры, управляемые сервером](/docs/ru/server-managed-settings#fetch-and-caching-behavior). Передайте их как `options.serverManagedSettings` для включения.480* **Настройки, управляемые сервером**: `resolveSettings()` не загружает [настройки, управляемые сервером](/docs/ru/server-managed-settings#fetch-and-caching-behavior). Передайте их как `options.serverManagedSettings`, чтобы включить их.

481* **`defaultMode`**: снимок возвращает `permissions.defaultMode` как есть из каждого уровня, поэтому он может включать значения `'auto'` и `'bypassPermissions'` из параметров проекта и локальных параметров, которые [живая сессия игнорирует](/docs/ru/permission-modes#which-mode-a-session-starts-in).481* **`defaultMode`**: снимок возвращает `permissions.defaultMode` как есть из каждого уровня, поэтому он может включать значения `'auto'` и `'bypassPermissions'` из настроек проекта и локальных настроек, которые [живая сессия игнорирует](/docs/ru/permission-modes#which-mode-a-session-starts-in).

482 482

483```typescript theme={null}483```typescript theme={null}

484function resolveSettings(484function resolveSettings(

494 494

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

496| :- | :- | :- | :- |496| :- | :- | :- | :- |

498| `options.settingSources` | [`SettingSource`](#settingsource)`[]` | Все источники | Какие источники файловой системы загружать. Передайте `[]` для пропуска пользовательских, проектных и локальных параметров. [Политика, управляемая конечной точкой](/docs/ru/managed-settings#delivery-mechanisms), загружается во всех случаях. `resolveSettings()` включает параметры, управляемые сервером, только когда вы передаёте `options.serverManagedSettings` |498| `options.settingSources` | [`SettingSource`](#settingsource)`[]` | Все источники | Какие источники файловой системы загружать. Передайте `[]`, чтобы пропустить пользовательские, проектные и локальные настройки. [Политика, управляемая на конечных устройствах](/docs/ru/managed-settings#delivery-mechanisms), загружается во всех случаях. `resolveSettings()` включает настройки, управляемые сервером, только когда вы передаёте `options.serverManagedSettings` |

499| `options.managedSettings` | `Settings` | `undefined` | Параметры уровня политики, предоставленные хостом встраивания. Следует тем же правилам, что и [`managedSettings` в `Options`](#options), за исключением того, что `resolveSettings()` не выполняет настроенный [`policyHelper`](/docs/ru/settings-reference#policyhelper), поэтому снимок может включать параметры, которые живая сессия отбрасывает |499| `options.managedSettings` | `Settings` | `undefined` | Настройки уровня политики, предоставленные встраивающим хостом. Следует тем же правилам, что и [`managedSettings` в `Options`](#options), за исключением того, что `resolveSettings()` не выполняет настроенный [`policyHelper`](/docs/ru/settings-reference#policyhelper), поэтому снимок может включать настройки, которые живая сессия отбрасывает |

501 501

502<h4 id="return-type-resolvedsettings">502<h4 id="return-type-resolvedsettings">

503 Тип возврата: `ResolvedSettings`503 Тип возврата: `ResolvedSettings`

504</h4>504</h4>

505 505

506`resolveSettings()` возвращает объект, описывающий объединённые параметры и источник, который внёс каждый ключ.506`resolveSettings()` возвращает объект, описывающий объединённые настройки и источник, который предоставил каждый ключ.

507 507

508| Свойство | Тип | Описание |508| Свойство | Тип | Описание |

509| :- | :- | :- |509| :- | :- | :- |

512| `sources` | `Array<{ source, settings, path?, policyOrigin? }>` | Необработанные параметры для каждого источника, упорядоченные от самого низкого к самому высокому приоритету |512| `sources` | `Array<{ source, settings, path?, policyOrigin? }>` | Необработанные настройки каждого источника, упорядоченные от самого низкого к самому высокому приоритету |

513 513

514<h4 id="example-5">514<h4 id="example-5">

515 Пример515 Пример

516</h4>516</h4>

517 517

518Пример ниже разрешает параметры для директории проекта и выводит источник, который контролирует период очистки. На машине, где ни один файл параметров не устанавливает `cleanupPeriodDays`, обе выведенные строки показывают `undefined` для значения, что является ожидаемым результатом, а не ошибкой.518Пример ниже вычисляет настройки для каталога проекта и выводит источник, который задаёт период очистки. На машине, где ни один файл настроек не устанавливает `cleanupPeriodDays`, обе выведенные строки показывают `undefined` в качестве значения, что является ожидаемым результатом, а не ошибкой.

519 519

520```typescript theme={null}520```typescript theme={null}

521import { resolveSettings } from "@anthropic-ai/claude-agent-sdk";521import { resolveSettings } from "@anthropic-ai/claude-agent-sdk";

1756* `ttft_stream_ms`: время в миллисекундах до первого события потока `message_start`, когда открывается поток ответа. Меньше, чем `ttft_ms`; разница между ними — это время, потраченное на потоковую передачу первого сообщения. Присутствует только в ветви успеха.1756* `ttft_stream_ms`: время в миллисекундах до первого события потока `message_start`, когда открывается поток ответа. Меньше, чем `ttft_ms`; разница между ними — это время, потраченное на потоковую передачу первого сообщения. Присутствует только в ветви успеха.

1757* `user_message_uuid`: `uuid` отправленного вами сообщения, на которое ответил этот ход. См. [`user_message_uuid`](#user_message_uuid), чтобы узнать, какие результаты его содержат.1757* `user_message_uuid`: `uuid` отправленного вами сообщения, на которое ответил этот ход. См. [`user_message_uuid`](#user_message_uuid), чтобы узнать, какие результаты его содержат.

1758* `user_message_uuids`: `uuid` каждого отправленного вами сообщения, на которое Claude Code ответил в этом ходе. См. [`user_message_uuids`](#user_message_uuids).1758* `user_message_uuids`: `uuid` каждого отправленного вами сообщения, на которое Claude Code ответил в этом ходе. См. [`user_message_uuids`](#user_message_uuids).

1759* `resume_reason`: почему Claude Code повторно запустил этот ход после того, как его прервал перезапуск. Присутствует в обеих ветвях и только при таком повторном запуске. См. [`resume_reason`](#resume_reason).1759* `resume_reason`: почему Claude Code повторно выполнил этот ход после того, как его прервал перезапуск. Присутствует в обоих вариантах. См. [`resume_reason`](#resume_reason).

1760* `local_command`: имя команды, которую выполнил ход, в результате успеха хода, завершённого командой без входа в цикл агента, например `/compact`. Имя приводится к строчным буквам и подчёркиваниям, поэтому `/reload-plugins` сообщает `reload_plugins`. Команда, которую предоставляет MCP-сервер, и встроенная `/mcp` сообщают `mcp`. Команда, которую вы определили сами, сообщает `custom`. Аргументы никогда не включаются. Отсутствует в каждом ходе, который вошёл в цикл агента, и при отправках, не запустивших команду. Требует Agent SDK v0.3.268 или позже.1760* `local_command`: имя команды, которую выполнил ход, в результате успеха хода, завершённого командой без входа в цикл агента, например `/compact`. Имя приводится к строчным буквам и подчёркиваниям, поэтому `/reload-plugins` сообщает `reload_plugins`. Команда, которую предоставляет MCP-сервер, и встроенная `/mcp` сообщают `mcp`. Команда, которую вы определили сами, сообщает `custom`. Аргументы никогда не включаются. Отсутствует в каждом ходе, который вошёл в цикл агента, и при отправках, не запустивших команду. Требует Agent SDK v0.3.268 или позже.

1761* `request_sent_wall_ms`: миллисекунды эпохи, в которые Claude Code отправил запрос API, для сопоставления с серверными временными метками. Присутствует только вместе с [`user_message_uuid`](#user_message_uuid), в результате успеха с `is_error` равным false, чей ход отправил запрос API.1761* `request_sent_wall_ms`: миллисекунды эпохи, в которые Claude Code отправил запрос API, для сопоставления с серверными временными метками. Присутствует только вместе с [`user_message_uuid`](#user_message_uuid), в результате успеха с `is_error` равным false, чей ход отправил запрос API.

1762* `first_content_frame_ms`: время в миллисекундах до первого события потока `content_block_start` или `content_block_delta`, считая блоки размышлений содержимым. Присутствует только в ветви успеха, когда `is_error` имеет значение false. Требует Agent SDK v0.3.260 или позже.1762* `first_content_frame_ms`: время в миллисекундах до первого события потока `content_block_start` или `content_block_delta`, считая блоки размышлений содержимым. Присутствует только в ветви успеха, когда `is_error` имеет значение false. Требует Agent SDK v0.3.260 или позже.

1845* **Результат повторного запуска**: как в ветви успеха, так и в ветви ошибки, независимо от того, содержит ли результат `user_message_uuid`.1845* **Результат повторного запуска**: как в ветви успеха, так и в ветви ошибки, независимо от того, содержит ли результат `user_message_uuid`.

1846* **Кадры ответа повторного запуска**: те, которые содержат [`user_message_uuid`](#user_message_uuid).1846* **Кадры ответа повторного запуска**: те, которые содержат [`user_message_uuid`](#user_message_uuid).

1847 1847

1848Значение — это короткий токен в нижнем регистре, называющий причину повторного запуска хода, например `interrupted_turn`. Во всех остальных ходах это поле отсутствует.1848Значение — короткий токен в нижнем регистре, называющий причину повторного выполнения хода, например `interrupted_turn`.

1849 1849

1850<h4 id="queued_turn_count">1850<h4 id="queued_turn_count">

1851 `queued_turn_count`1851 `queued_turn_count`

1887 | "worktree_resume_refused"1887 | "worktree_resume_refused"

1888 | "worktree_unverified"1888 | "worktree_unverified"

1889 | "cli_version_too_old"1889 | "cli_version_too_old"

1890 | "bypass_root";1890 | "bypass_root"

1891 | "org_config_required_unavailable"

1892 | "org_config_refused";

1891```1893```

1892 1894

1893Каждое значение называет один отказ:1895Каждое значение называет один отказ:

1916| `org_config_required_unavailable` | Сессии для запуска нужны политики и управляемые настройки организации, а их не удалось загрузить, например из-за сетевого сбоя или ошибки сервера Anthropic. Требуется Agent SDK v0.3.293 или новее |

1917| `org_config_refused` | Anthropic отказался предоставить политики и управляемые настройки организации для этого входа, например потому что срок действия входа истёк или он был отозван, или организация не разрешает Claude Code для этой учётной записи. Требуется Agent SDK v0.3.293 или новее |

1914 1918

1915<h3 id="sdksystemmessage">1919<h3 id="sdksystemmessage">

1916 `SDKSystemMessage`1920 `SDKSystemMessage`

3121```3125```

3122 3126

3123<h2 id="tool-input-types">3127<h2 id="tool-input-types">

3124 Типы входных данных tool3128 Типы входных данных инструментов

3125</h2>3129</h2>

3126 3130

3127Документация схем входных данных для всех встроенных tools Claude Code. Эти типы экспортируются из `@anthropic-ai/claude-agent-sdk/sdk-tools` и могут быть использованы для типобезопасного взаимодействия с tools.3131Документация схем входных данных для всех встроенных инструментов Claude Code. Эти типы экспортируются из `@anthropic-ai/claude-agent-sdk/sdk-tools` и могут быть использованы для типобезопасного взаимодействия с инструментами.

3128 3132

3129<h3 id="toolinputschemas">3133<h3 id="toolinputschemas">

3130 `ToolInputSchemas`3134 `ToolInputSchemas`

3131</h3>3135</h3>

3132 3136

3133Объединение типов входных данных tool, экспортируемое из `@anthropic-ai/claude-agent-sdk/sdk-tools`; члены включают:3137Объединение типов входных данных инструментов, экспортируемое из `@anthropic-ai/claude-agent-sdk/sdk-tools`; члены включают:

3134 3138

3135```typescript theme={null}3139```typescript theme={null}

3136type ToolInputSchemas =3140type ToolInputSchemas =

3178 Agent3182 Agent

3179</h3>3183</h3>

3180 3184

3181**Имя tool:** `Agent`. Предыдущее имя `Task` всё ещё принимается как псевдоним, и массив `tools` в сообщении инициализации [`SDKSystemMessage`](#sdksystemmessage) в настоящее время перечисляет этот tool как `Task` для обратной совместимости.3185**Имя инструмента:** `Agent`. Предыдущее имя `Task` всё ещё принимается как псевдоним, и массив `tools` в сообщении инициализации [`SDKSystemMessage`](#sdksystemmessage) в настоящее время перечисляет этот инструмент как `Task` для обратной совместимости.

3182 3186

3183<Note>3187<Note>

3184 Поле `mode` устарело и игнорируется в Claude Code v2.1.212 или позже. Подагент работает либо в режиме разрешений родительской сессии, либо в режиме его определения [`permissionMode`](#agentdefinition), и [правила наследования подагента](/docs/ru/agent-sdk/permissions#available-modes) решают, какой из них.3188 Поле `mode` объявлено устаревшим и игнорируется в Claude Code v2.1.212 или позже. Субагент работает либо в режиме разрешений родительской сессии, либо в режиме [`permissionMode`](#agentdefinition) из своего определения, а [правила наследования для субагентов](/docs/ru/agent-sdk/permissions#available-modes) решают, в каком из них.

3185</Note>3189</Note>

3186 3190

3187```typescript theme={null}3191```typescript theme={null}

3193 run_in_background?: boolean;3197 run_in_background?: boolean;

3194 name?: string;3198 name?: string;

3195 team_name?: string; // Устарело; игнорируется3199 team_name?: string; // Deprecated; ignored

3197 isolation?: "worktree" | "remote";3201 isolation?: "worktree" | "remote";

3198};3202};

3199```3203```

3204 AskUserQuestion3208 AskUserQuestion

3205</h3>3209</h3>

3206 3210

3207**Имя tool:** `AskUserQuestion`3211**Имя инструмента:** `AskUserQuestion`

3208 3212

3209```typescript theme={null}3213```typescript theme={null}

3210type AskUserQuestionInput = {3214type AskUserQuestionInput = {

3220};3224};

3221```3225```

3222 3226

3223Задаёт пользователю уточняющие вопросы во время выполнения. См. [Обработка одобрений и пользовательского ввода](/docs/ru/agent-sdk/user-input#handle-clarifying-questions) для деталей использования.3227Задаёт пользователю уточняющие вопросы во время выполнения. См. [Обработка подтверждений и пользовательского ввода](/docs/ru/agent-sdk/user-input#handle-clarifying-questions) для деталей использования.

3224 3228

3225<h3 id="bash">3229<h3 id="bash">

3226 Bash3230 Bash

3227</h3>3231</h3>

3228 3232

3229**Имя tool:** `Bash`3233**Имя инструмента:** `Bash`

3230 3234

3231```typescript theme={null}3235```typescript theme={null}

3232type BashInput = {3236type BashInput = {

3233 command: string;3237 command: string;

3234 timeout?: number; // миллисекунды. Foreground: ограничено 600000 по умолчанию, более высокие значения зажимаются. С run_in_background (Claude Code v2.1.285 или позже): лимит времени фона, 1800000 при пропуске, ограничено 7200000, если не повышено3238 timeout?: number; // milliseconds. Foreground: capped at 600000 by default, higher values are clamped. With run_in_background (Claude Code v2.1.285 or later): the background time limit, 1800000 when omitted, capped at 7200000 unless raised

3235 description?: string;3239 description?: string;

3236 run_in_background?: boolean;3240 run_in_background?: boolean;

3237 dangerouslyDisableSandbox?: boolean;3241 dangerouslyDisableSandbox?: boolean;

3238};3242};

3239```3243```

3240 3244

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

3242 3246

3243<h3 id="monitor">3247<h3 id="monitor">

3244 Monitor3248 Monitor

3245</h3>3249</h3>

3246 3250

3247**Имя tool:** `Monitor`3251**Имя инструмента:** `Monitor`

3248 3252

3249```typescript theme={null}3253```typescript theme={null}

3250type MonitorInput = {3254type MonitorInput = {

3258};3262};

3259```3263```

3260 3264

3261Запускает фоновый источник и доставляет каждое событие к Claude, чтобы он мог реагировать без опроса: `command` запускает скрипт и выдаёт одно событие на строку stdout, а `ws` открывает WebSocket и выдаёт одно событие на текстовый фрейм. Укажите ровно один из `command` или `ws`. Источник `ws` требует Claude Code v2.1.195 или позже.3265Запускает фоновый источник и доставляет каждое событие Claude, чтобы он мог реагировать без опроса: `command` запускает скрипт и выдаёт одно событие на строку stdout, а `ws` открывает WebSocket и выдаёт одно событие на текстовый фрейм. Укажите ровно один из `command` или `ws`. Источник `ws` требует Claude Code v2.1.195 или позже.

3262 3266

3263`timeout_ms` — это крайний срок наблюдения в миллисекундах. По умолчанию он равен 300000 и принимает значения до 3600000. Эффективный крайний срок составляет максимум 1800000, что составляет 30 минут, поэтому большее принятое значение сокращается до этого. В крайний срок наблюдение заканчивается и Claude получает одно уведомление, чтобы он мог начать новое наблюдение, если оно ему всё ещё нужно.3267`timeout_ms` — это крайний срок наблюдения в миллисекундах. По умолчанию он равен 300000 и принимает значения до 3600000. Эффективный крайний срок составляет максимум 1800000, то есть 30 минут, поэтому большее принятое значение сокращается до него. В крайний срок наблюдение заканчивается, и Claude получает одно уведомление, чтобы он мог начать новое наблюдение, если оно ему всё ещё нужно.

3264 3268

3265Экспортированный тип отмечает `timeout_ms` как обязательный, потому что схема заполняет значение по умолчанию; вызов, который его опускает, проходит валидацию.3269Экспортированный тип отмечает `timeout_ms` как обязательный, потому что схема заполняет значение по умолчанию; вызов, который его опускает, проходит валидацию.

3266 3270

3267Когда Monitor запускает команду, он следует тем же правилам разрешения, что и Bash; наблюдение WebSocket запрашивает одобрение отдельно. См. [справочник tool Monitor](/docs/ru/tools-reference#monitor-tool) для поведения и доступности провайдера.3271Когда Monitor запускает команду, он следует тем же правилам разрешений, что и Bash; наблюдение WebSocket запрашивает подтверждение отдельно. См. [справочник по инструменту Monitor](/docs/ru/tools-reference#monitor-tool) о поведении и доступности у провайдеров.

3268 3272

3269<h3 id="taskoutput">3273<h3 id="taskoutput">

3270 TaskOutput3274 TaskOutput

3271</h3>3275</h3>

3272 3276

3273Удалено в Claude Code v2.1.277 вместе с его типом `TaskOutputInput`. Ранее получало вывод из выполняющейся или завершённой фоновой задачи; Claude читает выходной файл фоновой задачи с помощью `Read` вместо этого.3277Удалён в Claude Code v2.1.277 вместе с его типом `TaskOutputInput`. Ранее получал вывод выполняющейся или завершённой фоновой задачи; теперь Claude читает выходной файл фоновой задачи с помощью `Read`.

3274 3278

3275Запись `disallowedTools` или правило отказа, которое всё ещё называет `TaskOutput`, игнорируется без предупреждения.3279Запись `disallowedTools` или правило запрета, которое всё ещё называет `TaskOutput`, игнорируется без предупреждения.

3276 3280

3277<h3 id="edit">3281<h3 id="edit">

3278 Edit3282 Edit

3279</h3>3283</h3>

3280 3284

3281**Имя tool:** `Edit`3285**Имя инструмента:** `Edit`

3282 3286

3283```typescript theme={null}3287```typescript theme={null}

3284type FileEditInput = {3288type FileEditInput = {

3295 Read3299 Read

3296</h3>3300</h3>

3297 3301

3298**Имя tool:** `Read`3302**Имя инструмента:** `Read`

3299 3303

3300```typescript theme={null}3304```typescript theme={null}

3301type FileReadInput = {3305type FileReadInput = {

3308 3312

3309Читает файлы из локальной файловой системы, включая текст, изображения, PDF и Jupyter notebooks. Используйте `pages` для диапазонов страниц PDF (например, `"1-5"`).3313Читает файлы из локальной файловой системы, включая текст, изображения, PDF и Jupyter notebooks. Используйте `pages` для диапазонов страниц PDF (например, `"1-5"`).

3310 3314

3311Для PDF Claude получает содержимое файла внутри `tool_result` вызова Read. Чтение, которое возвращает выход `pdf` [output](#tool-output-types), содержит блок сводки `text`, за которым следует блок `document`. Чтение, которое возвращает выход `parts`, содержит блок сводки `text`, за которым следует один блок на извлечённую страницу: блок `image` или блок `text`, называющий страницу, когда Claude Code не смог отобразить её как изображение. До Agent SDK v0.3.242 Claude Code доставлял содержимое файла как отдельное сообщение `user` после результата tool.3315Для PDF Claude получает содержимое файла внутри содержимого `tool_result` вызова Read. Чтение, которое возвращает [выход](#tool-output-types) `pdf`, содержит блок сводки `text`, за которым следует блок `document`. Чтение, которое возвращает выход `parts`, содержит блок сводки `text`, за которым следует один блок на каждую извлечённую страницу: блок `image` или блок `text`, называющий страницу, когда Claude Code не смог отобразить её как изображение. До Agent SDK v0.3.242 Claude Code доставлял содержимое файла как отдельное сообщение `user` после результата инструмента.

3312 3316

3313<h3 id="write">3317<h3 id="write">

3314 Write3318 Write

3315</h3>3319</h3>

3316 3320

3317**Имя tool:** `Write`3321**Имя инструмента:** `Write`

3318 3322

3319```typescript theme={null}3323```typescript theme={null}

3320type FileWriteInput = {3324type FileWriteInput = {

3323};3327};

3324```3328```

3325 3329

3326Записывает файл в локальную файловую систему, перезаписывая, если он существует.3330Записывает файл в локальную файловую систему, перезаписывая его, если он существует.

3327 3331

3328<h3 id="glob">3332<h3 id="glob">

3329 Glob3333 Glob

3330</h3>3334</h3>

3331 3335

3332**Имя tool:** `Glob`3336**Имя инструмента:** `Glob`

3333 3337

3334```typescript theme={null}3338```typescript theme={null}

3335type GlobInput = {3339type GlobInput = {

3338};3342};

3339```3343```

3340 3344

3341Быстрое сопоставление паттернов файлов, которое работает с любым размером кодовой базы.3345Быстрое сопоставление паттернов файлов, которое работает с кодовой базой любого размера.

3342 3346

3343<h3 id="grep">3347<h3 id="grep">

3344 Grep3348 Grep

3345</h3>3349</h3>

3346 3350

3347**Имя tool:** `Grep`3351**Имя инструмента:** `Grep`

3348 3352

3349```typescript theme={null}3353```typescript theme={null}

3350type GrepInput = {3354type GrepInput = {

3372 TaskStop3376 TaskStop

3373</h3>3377</h3>

3374 3378

3375**Имя tool:** `TaskStop`3379**Имя инструмента:** `TaskStop`

3376 3380

3377```typescript theme={null}3381```typescript theme={null}

3378type TaskStopInput = {3382type TaskStopInput = {

3379 task_id?: string;3383 task_id?: string;

3380 shell_id?: string; // Устарело: используйте task_id3384 shell_id?: string; // Deprecated: use task_id

3381};3385};

3382```3386```

3383 3387

3384Останавливает выполняющуюся фоновую задачу или shell по ID. Начиная с v2.1.198, `task_id` также принимает товарища по команде agent-team или именованного фонового агента по ID агента или имени.3388Останавливает выполняющуюся фоновую задачу или оболочку по ID. Начиная с v2.1.198, `task_id` также принимает участника команды агентов или именованного фонового агента по ID агента или имени.

3385 3389

3386<h3 id="notebookedit">3390<h3 id="notebookedit">

3387 NotebookEdit3391 NotebookEdit

3388</h3>3392</h3>

3389 3393

3390**Имя tool:** `NotebookEdit`3394**Имя инструмента:** `NotebookEdit`

3391 3395

3392```typescript theme={null}3396```typescript theme={null}

3393type NotebookEditInput = {3397type NotebookEditInput = {

3405 WebFetch3409 WebFetch

3406</h3>3410</h3>

3407 3411

3408**Имя tool:** `WebFetch`3412**Имя инструмента:** `WebFetch`

3409 3413

3410```typescript theme={null}3414```typescript theme={null}

3411type WebFetchInput = {3415type WebFetchInput = {

3414};3418};

3415```3419```

3416 3420

3417Получает содержимое с URL и обрабатывает его с помощью модели AI.3421Получает содержимое по URL и обрабатывает его с помощью модели AI.

3418 3422

3419<h3 id="websearch">3423<h3 id="websearch">

3420 WebSearch3424 WebSearch

3421</h3>3425</h3>

3422 3426

3423**Имя tool:** `WebSearch`3427**Имя инструмента:** `WebSearch`

3424 3428

3425```typescript theme={null}3429```typescript theme={null}

3426type WebSearchInput = {3430type WebSearchInput = {

3430};3434};

3431```3435```

3432 3436

3433Ищет в веб и возвращает отформатированные результаты.3437Выполняет поиск в вебе и возвращает отформатированные результаты.

3434 3438

3435<h3 id="workflow">3439<h3 id="workflow">

3436 Workflow3440 Workflow

3437</h3>3441</h3>

3438 3442

3439**Имя tool:** `Workflow`3443**Имя инструмента:** `Workflow`

3440 3444

3441```typescript theme={null}3445```typescript theme={null}

3442type WorkflowInput = {3446type WorkflowInput = {

3450};3454};

3451```3455```

3452 3456

3453Запускает [динамический workflow](/docs/ru/workflows): скрипт, который организует множество подагентов в фоне и возвращает один консолидированный результат. Tool `Workflow` доступен в Agent SDK v0.3.149 и позже. Требуется хотя бы один из `script`, `name` или `scriptPath`.3457Запускает [динамический workflow](/docs/ru/workflows): скрипт, который оркестрирует множество субагентов в фоне и возвращает один консолидированный результат. Инструмент `Workflow` доступен в Agent SDK v0.3.149 и позже. Требуется хотя бы один из `script`, `name` или `scriptPath`.

3454 3458

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

3456| - | - | - |3460| - | - | - |

3457| `script` | `string` | Встроенный скрипт workflow. Должен начинаться с `export const meta = { name, description }` как литерал, за которым следует тело скрипта с использованием `agent()`, `parallel()`, `pipeline()` и `phase()`. Опциональный массив `phases` в `meta` группирует агентов под названными этапами в представлении прогресса |3461| `script` | `string` | Встроенный скрипт workflow. Должен начинаться с `export const meta = { name, description }` как литерала, за которым следует тело скрипта с использованием `agent()`, `parallel()`, `pipeline()` и `phase()`. Опциональный массив `phases` в `meta` группирует агентов по именованным этапам в представлении прогресса |

3459| `scriptPath` | `string` | Путь к файлу скрипта workflow на диске. Имеет приоритет над `script` и `name`. Claude Code сохраняет скрипт каждого вызова и возвращает путь в результате, поэтому вы можете отредактировать этот файл и повторно вызвать с тем же `scriptPath` для итерации |3463| `scriptPath` | `string` | Путь к файлу скрипта workflow на диске. Имеет приоритет над `script` и `name`. Claude Code сохраняет скрипт каждого вызова и возвращает путь в результате, поэтому вы можете отредактировать этот файл и повторно вызвать с тем же `scriptPath` для итерации |

3460| `args` | `unknown` | Входное значение, доступное скрипту как глобальная переменная `args`, для параметризованных именованных workflows, таких как исследовательский вопрос или список путей файлов. Передавайте массивы и объекты как фактические значения JSON, а не как JSON-кодированную строку |3464| `args` | `unknown` | Входное значение, доступное скрипту как глобальная переменная `args`, для параметризованных именованных workflow, таких как исследовательский вопрос или список путей к файлам. Передавайте массивы и объекты как фактические значения JSON, а не как JSON-кодированную строку |

3461| `resumeFromRunId` | `string` | Run ID предыдущего вызова `Workflow` для возобновления. Завершённые вызовы `agent()` с неизменёнными входными данными обычно возвращают кэшированные результаты; остальные выполняются в реальном времени. [Возобновление после паузы](/docs/ru/workflows#resume-after-a-pause) охватывает, какие завершённые вызовы повторно выполняются. Только в одной сессии |3465| `resumeFromRunId` | `string` | Run ID предыдущего вызова `Workflow` для возобновления. Завершённые вызовы `agent()` с неизменёнными входными данными обычно возвращают кэшированные результаты; остальные выполняются заново. В разделе [Возобновление после паузы](/docs/ru/workflows#resume-after-a-pause) описано, какие завершённые вызовы выполняются повторно. Только в той же сессии |

3464 3468

3465<h3 id="todowrite">3469<h3 id="todowrite">

3466 TodoWrite3470 TodoWrite

3467</h3>3471</h3>

3468 3472

3469**Имя tool:** `TodoWrite`3473**Имя инструмента:** `TodoWrite`

3470 3474

3471```typescript theme={null}3475```typescript theme={null}

3472type TodoWriteInput = {3476type TodoWriteInput = {

3478};3482};

3479```3483```

3480 3484

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

3482 3486

3483<Note>3487<Note>

3484 Следующие инструменты доступны по умолчанию только на моделях Claude 3.x, Opus 4 через 4.7, Sonnet 4 через 4.6 и Haiku 4.5. На всех остальных моделях, включая идентификаторы моделей, которые Claude Code не распознает, они недоступны, если вы не согласитесь на их использование:3488 Следующие инструменты доступны по умолчанию только на моделях Claude 3.x, Opus 4 через 4.7, Sonnet 4 через 4.6 и Haiku 4.5. На всех остальных моделях, включая идентификаторы моделей, которые Claude Code не распознает, они недоступны, если вы не согласитесь на их использование:

3493 3497

3494 Этот набор по умолчанию применяется в Claude Code v2.1.268 и более поздних версиях, которые TypeScript Agent SDK поставляет начиная с версии v0.3.268.3498 Этот набор по умолчанию применяется в Claude Code v2.1.268 и более поздних версиях, которые TypeScript Agent SDK поставляет начиная с версии v0.3.268.

3495 3499

3496 См. [Доступность модели](/docs/ru/agent-sdk/todo-tracking#model-availability) для подключения.3500 См. [Доступность модели](/docs/ru/agent-sdk/todo-tracking#model-availability), чтобы включить эту возможность.

3497</Note>3501</Note>

3498 3502

3499<h3 id="taskcreate">3503<h3 id="taskcreate">

3500 TaskCreate3504 TaskCreate

3501</h3>3505</h3>

3502 3506

3503**Имя tool:** `TaskCreate`3507**Имя инструмента:** `TaskCreate`

3504 3508

3505```typescript theme={null}3509```typescript theme={null}

3506type TaskCreateInput = {3510type TaskCreateInput = {

3511};3515};

3512```3516```

3513 3517

3514Создаёт одну задачу и возвращает её назначенный ID.3518Создаёт одну задачу и возвращает назначенный ей ID.

3515 3519

3516<h3 id="taskupdate">3520<h3 id="taskupdate">

3517 TaskUpdate3521 TaskUpdate

3518</h3>3522</h3>

3519 3523

3520**Имя tool:** `TaskUpdate`3524**Имя инструмента:** `TaskUpdate`

3521 3525

3522```typescript theme={null}3526```typescript theme={null}

3523type TaskUpdateInput = {3527type TaskUpdateInput = {

3533};3537};

3534```3538```

3535 3539

3536Исправляет одну задачу по ID. Установите `status` на `"deleted"` для её удаления.3540Частично обновляет одну задачу по ID. Установите `status` в `"deleted"`, чтобы удалить её.

3537 3541

3538<h3 id="taskget">3542<h3 id="taskget">

3539 TaskGet3543 TaskGet

3540</h3>3544</h3>

3541 3545

3542**Имя tool:** `TaskGet`3546**Имя инструмента:** `TaskGet`

3543 3547

3544```typescript theme={null}3548```typescript theme={null}

3545type TaskGetInput = {3549type TaskGetInput = {

3547};3551};

3548```3552```

3549 3553

3550Возвращает полные детали для одной задачи или `null`, когда ID не найден.3554Возвращает полные сведения об одной задаче или `null`, если ID не найден.

3551 3555

3552<h3 id="tasklist">3556<h3 id="tasklist">

3553 TaskList3557 TaskList

3554</h3>3558</h3>

3555 3559

3556**Имя tool:** `TaskList`3560**Имя инструмента:** `TaskList`

3557 3561

3558```typescript theme={null}3562```typescript theme={null}

3559type TaskListInput = {};3563type TaskListInput = {};

3565 ExitPlanMode3569 ExitPlanMode

3566</h3>3570</h3>

3567 3571

3568**Имя tool:** `ExitPlanMode`3572**Имя инструмента:** `ExitPlanMode`

3569 3573

3570```typescript theme={null}3574```typescript theme={null}

3571type ExitPlanModeInput = {3575type ExitPlanModeInput = {

3572 /** Устарело: больше не используется. */3576 /** Deprecated: no longer used. */

3573 allowedPrompts?: Array<{3577 allowedPrompts?: Array<{

3574 tool: "Bash";3578 tool: "Bash";

3575 prompt: string;3579 prompt: string;

3578};3582};

3579```3583```

3580 3584

3581Выходит из режима планирования. Поле `allowedPrompts` устарело и игнорируется; Claude Code всё ещё принимает его, чтобы существующие вызывающие стороны и транскрипты проходили валидацию. До v2.1.205 он запрашивал разрешения Bash на основе запроса для реализации плана.3585Выходит из режима планирования. Поле `allowedPrompts` объявлено устаревшим и игнорируется; Claude Code всё ещё принимает его, чтобы существующие вызывающие стороны и транскрипты проходили валидацию. До v2.1.205 оно запрашивало разрешения Bash на основе промптов для реализации плана.

3582 3586

3583<h3 id="listmcpresources">3587<h3 id="listmcpresources">

3584 ListMcpResources3588 ListMcpResources

3585</h3>3589</h3>

3586 3590

3587**Имя tool:** `ListMcpResourcesTool`3591**Имя инструмента:** `ListMcpResourcesTool`

3588 3592

3589```typescript theme={null}3593```typescript theme={null}

3590type ListMcpResourcesInput = {3594type ListMcpResourcesInput = {

3592};3596};

3593```3597```

3594 3598

3595Перечисляет доступные MCP ресурсы из подключённых серверов.3599Перечисляет доступные ресурсы MCP с подключённых серверов.

3596 3600

3597<h3 id="readmcpresource">3601<h3 id="readmcpresource">

3598 ReadMcpResource3602 ReadMcpResource

3599</h3>3603</h3>

3600 3604

3601**Имя tool:** `ReadMcpResourceTool`3605**Имя инструмента:** `ReadMcpResourceTool`

3602 3606

3603```typescript theme={null}3607```typescript theme={null}

3604type ReadMcpResourceInput = {3608type ReadMcpResourceInput = {

3607};3611};

3608```3612```

3609 3613

3610Читает определённый MCP ресурс с сервера.3614Читает определённый ресурс MCP с сервера.

3611 3615

3612<h3 id="enterworktree">3616<h3 id="enterworktree">

3613 EnterWorktree3617 EnterWorktree

3614</h3>3618</h3>

3615 3619

3616**Имя tool:** `EnterWorktree`3620**Имя инструмента:** `EnterWorktree`

3617 3621

3618```typescript theme={null}3622```typescript theme={null}

3619type EnterWorktreeInput = {3623type EnterWorktreeInput = {

3622};3626};

3623```3627```

3624 3628

3625Создаёт и входит во временный git worktree для изолированной работы. Передайте `path` для переключения в существующий worktree вместо создания нового. На первом входе целевой объект должен быть зарегистрированным worktree текущего репозитория или, в многорепозиторном рабочем пространстве, репозитория, вложенного внутри него; из сессии worktree он должен находиться под `.claude/worktrees/` репозитория сессии. `name` и `path` являются взаимоисключающими.3629Создаёт временный git worktree для изолированной работы и входит в него. Передайте `path`, чтобы переключиться в существующий worktree вместо создания нового. При первом входе целевой каталог должен быть зарегистрированным worktree текущего репозитория или, в многорепозиторном рабочем пространстве, репозитория, вложенного в него; из сессии worktree он должен находиться в `.claude/worktrees/` репозитория сессии. `name` и `path` являются взаимоисключающими.

3626 3630

3627<h3 id="exitworktree">3631<h3 id="exitworktree">

3628 ExitWorktree3632 ExitWorktree

3629</h3>3633</h3>

3630 3634

3631**Имя tool:** `ExitWorktree`3635**Имя инструмента:** `ExitWorktree`

3632 3636

3633```typescript theme={null}3637```typescript theme={null}

3634type ExitWorktreeInput = {3638type ExitWorktreeInput = {

3637};3641};

3638```3642```

3639 3643

3640Выходит из текущего git worktree и возвращается в исходный рабочий каталог. Действие `keep` оставляет worktree и ветку на диске, а `remove` удаляет оба. `discard_changes` должно быть `true` при удалении worktree, который имеет незафиксированные файлы или неслитые коммиты.3644Выходит из текущего git worktree и возвращается в исходный рабочий каталог. Действие `keep` оставляет worktree и ветку на диске, а `remove` удаляет оба. `discard_changes` должно быть `true` при удалении worktree, в котором есть незафиксированные файлы или коммиты без слияния.

3641 3645

3642<h3 id="enterplanmode">3646<h3 id="enterplanmode">

3643 EnterPlanMode3647 EnterPlanMode

3644</h3>3648</h3>

3645 3649

3646**Имя tool:** `EnterPlanMode`3650**Имя инструмента:** `EnterPlanMode`

3647 3651

3648```typescript theme={null}3652```typescript theme={null}

3649type EnterPlanModeInput = {};3653type EnterPlanModeInput = {};

3650```3654```

3651 3655

3652Входит в режим планирования, где Claude исследует и представляет план перед внесением изменений.3656Входит в режим планирования, в котором Claude исследует задачу и представляет план перед внесением изменений.

3653 3657

3654<h3 id="croncreate">3658<h3 id="croncreate">

3655 CronCreate3659 CronCreate

3656</h3>3660</h3>

3657 3661

3658**Имя tool:** `CronCreate`3662**Имя инструмента:** `CronCreate`

3659 3663

3660```typescript theme={null}3664```typescript theme={null}

3661type CronCreateInput = {3665type CronCreateInput = {

3666};3670};

3667```3671```

3668 3672

3669Планирует запуск запроса по расписанию cron из 5 полей в локальном времени. Установите `recurring` на `false` для срабатывания один раз при следующем совпадении. Задачи по умолчанию ограничены сессией, и возобновление с `--resume` или `--continue` восстанавливает задачи, которые не истекли. См. [Запланированные задачи](/docs/ru/scheduled-tasks).3673Планирует запуск промпта по расписанию cron из 5 полей в локальном времени. Установите `recurring` в `false`, чтобы он сработал один раз при следующем совпадении. Задачи по умолчанию ограничены сессией, а возобновление с `--resume` или `--continue` восстанавливает задачи, срок действия которых не истёк. См. [Запланированные задачи](/docs/ru/scheduled-tasks).

3670 3674

3671Установка `durable` на `true` запрашивает сохранение в `.claude/scheduled_tasks.json`, чтобы задача пережила перезагрузки. Долговечное планирование доступно не в каждой сессии: когда оно недоступно, Claude Code принимает `durable: true`, но создаёт задачу только для сессии. Прочитайте поле `durable` в выводе, чтобы увидеть, сохранилась ли задача.3675Установка `durable` в `true` запрашивает сохранение в `.claude/scheduled_tasks.json`, чтобы задача пережила перезапуски. Долговременное планирование доступно не в каждой сессии: когда оно недоступно, Claude Code принимает `durable: true`, но создаёт задачу только для текущей сессии. Проверьте поле `durable` в выводе, чтобы узнать, была ли задача сохранена.

3672 3676

3673<h3 id="crondelete">3677<h3 id="crondelete">

3674 CronDelete3678 CronDelete

3675</h3>3679</h3>

3676 3680

3677**Имя tool:** `CronDelete`3681**Имя инструмента:** `CronDelete`

3678 3682

3679```typescript theme={null}3683```typescript theme={null}

3680type CronDeleteInput = {3684type CronDeleteInput = {

3682};3686};

3683```3687```

3684 3688

3685Удаляет запланированную задачу cron по ID, возвращённому из `CronCreate`.3689Удаляет запланированную задачу cron по ID, возвращённому `CronCreate`.

3686 3690

3687<h3 id="cronlist">3691<h3 id="cronlist">

3688 CronList3692 CronList

3689</h3>3693</h3>

3690 3694

3691**Имя tool:** `CronList`3695**Имя инструмента:** `CronList`

3692 3696

3693```typescript theme={null}3697```typescript theme={null}

3694type CronListInput = {};3698type CronListInput = {};

3695```3699```

3696 3700

3697Перечисляет запланированные задачи cron: долговечные задачи из `.claude/scheduled_tasks.json` и задачи только для сессии из текущей сессии.3701Перечисляет запланированные задачи cron: долговременные задачи из `.claude/scheduled_tasks.json` и задачи только для текущей сессии.

3698 3702

3699<h3 id="schedulewakeup">3703<h3 id="schedulewakeup">

3700 ScheduleWakeup3704 ScheduleWakeup

3701</h3>3705</h3>

3702 3706

3703**Имя tool:** `ScheduleWakeup`3707**Имя инструмента:** `ScheduleWakeup`

3704 3708

3705```typescript theme={null}3709```typescript theme={null}

3706type ScheduleWakeupInput = {3710type ScheduleWakeupInput = {

3712};3716};

3713```3717```

3714 3718

3715Планирует одноразовое пробуждение, которое срабатывает заданный запрос после задержки. Этот tool поддерживает команду `/loop` с собственным темпом. Среда выполнения зажимает `delaySeconds` между 60 и 3600 секундами. Поля `delaySeconds`, `reason`, `prompt` и `noop` обязательны, если `stop` не true. `noop: true` сообщает о пробуждении, где ничего не изменилось. Установка `stop: true` отменяет ожидающее пробуждение и завершает самостоятельный `/loop`. Поле `stop` требует Claude Code v2.1.202 или позже. См. [строку ScheduleWakeup в справочнике tools](/docs/ru/tools-reference).3719Планирует одноразовое пробуждение, которое запускает заданный промпт после задержки. Этот инструмент лежит в основе команды `/loop` с самостоятельным темпом. Среда выполнения ограничивает `delaySeconds` диапазоном от 60 до 3600 секунд. Поля `delaySeconds`, `reason`, `prompt` и `noop` обязательны, если `stop` не равно true. `noop: true` сообщает о пробуждении, при котором ничего не изменилось. Установка `stop: true` отменяет ожидающее пробуждение и завершает `/loop` с самостоятельным темпом. Поле `stop` требует Claude Code v2.1.202 или позже. См. [строку ScheduleWakeup в справочнике по инструментам](/docs/ru/tools-reference).

3716 3720

3717<h3 id="remotetrigger">3721<h3 id="remotetrigger">

3718 RemoteTrigger3722 RemoteTrigger

3719</h3>3723</h3>

3720 3724

3721**Имя tool:** `RemoteTrigger`3725**Имя инструмента:** `RemoteTrigger`

3722 3726

3723```typescript theme={null}3727```typescript theme={null}

3724type RemoteTriggerInput = {3728type RemoteTriggerInput = {

3740};3744};

3741```3745```

3742 3746

3743Управляет [Routines](/docs/ru/routines), запланированными и активируемыми запусками Claude Code, размещёнными в облаке. Этот tool поддерживает команду `/schedule`. `trigger_id` обязателен для действий `get`, `update`, `run` и `list_runs`. `body` обязателен для `create`, `update` и `create_webhook_trigger`, и опционален для `run`.3747Управляет [Routines](/docs/ru/routines) — запланированными и запускаемыми по триггеру сессиями Claude Code, размещёнными в облаке. Этот инструмент лежит в основе команды `/schedule`. `trigger_id` обязателен для действий `get`, `update`, `run` и `list_runs`. `body` обязателен для `create`, `update` и `create_webhook_trigger` и опционален для `run`.

3744 3748

3745`create_webhook_trigger` присоединяет источник событий к существующей routine, такой как [событие GitHub](/docs/ru/routines#add-a-github-trigger), которое её срабатывает. `body` называет источник, события и routine для срабатывания. Требует Claude Code v2.1.225 или позже.3749`create_webhook_trigger` присоединяет источник событий к существующей routine, например [событие GitHub](/docs/ru/routines#add-a-github-trigger), которое её запускает. `body` указывает источник, события и routine для запуска. Требует Claude Code v2.1.225 или позже.

3746 3750

3747`list_runs` перечисляет недавние запуски routine, а `get_run_log` читает журнал одного запуска. `session_id` называет запуск для чтения из результата `list_runs`, а `cursor` разбивает результаты любого действия на страницы. Оба действия требуют Claude Code v2.1.227 или позже.3751`list_runs` перечисляет недавние запуски routine, а `get_run_log` читает лог одного запуска. `session_id` указывает запуск для чтения из результата `list_runs`, а `cursor` позволяет постранично перебирать результаты любого из этих действий. Оба действия требуют Claude Code v2.1.227 или позже.

3748 3752

3749Этот tool доступен только когда сессия аутентифицирована с учётной записью claude.ai на плане с включённой функцией Routines, и отсутствует, когда политика вашей организации отключает [Claude Code в веб](/docs/ru/claude-code-on-the-web). В Claude Code v2.1.227 или позже tool также отсутствует, когда Owner [отключил routines для организации](/docs/ru/routines#routines-are-disabled-by-your-organizations-policy). До v2.1.227 сессия с отключённым только переключателем routines всё ещё показывала tool, и сервер отклонял его вызовы.3753Этот инструмент доступен, только когда сессия аутентифицирована с учётной записью claude.ai на плане с включёнными Routines, и отсутствует, когда политика вашей организации отключает [облачные сессии](/docs/ru/claude-code-on-the-web). В Claude Code v2.1.227 или позже инструмент также отсутствует, когда Owner [отключил routines для организации](/docs/ru/routines#routines-are-disabled-by-your-organizations-policy). До v2.1.227 сессия, в которой был отключён только переключатель routines, всё ещё показывала инструмент, а сервер отклонял его вызовы.

3750 3754

3751<h3 id="pushnotification">3755<h3 id="pushnotification">

3752 PushNotification3756 PushNotification

3753</h3>3757</h3>

3754 3758

3755**Имя tool:** `PushNotification`3759**Имя инструмента:** `PushNotification`

3756 3760

3757```typescript theme={null}3761```typescript theme={null}

3758type PushNotificationInput = {3762type PushNotificationInput = {

3761};3765};

3762```3766```

3763 3767

3764Отправляет проактивное push-уведомление пользователю. Держите `message` под 200 символами, потому что мобильные операционные системы обрезают более длинный текст. См. [строку PushNotification в справочнике tools](/docs/ru/tools-reference) для доступности провайдера; доставка push проходит через инфраструктуру, размещённую Anthropic, которая недоступна из Amazon Bedrock, Claude Platform на AWS, Google Cloud's Agent Platform или Microsoft Foundry.3768Отправляет пользователю проактивное push-уведомление. Держите `message` короче 200 символов, потому что мобильные операционные системы обрезают более длинный текст. См. [строку PushNotification в справочнике по инструментам](/docs/ru/tools-reference) о доступности у провайдеров; доставка push-уведомлений проходит через инфраструктуру, размещённую Anthropic, которая недоступна из Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform или Microsoft Foundry.

3765 3769

3766<h3 id="repl">3770<h3 id="repl">

3767 REPL3771 REPL

3768</h3>3772</h3>

3769 3773

3770Удалено в v2.1.275. До v2.1.274 экспериментальный tool `REPL` можно было включить с помощью `CLAUDE_CODE_REPL=1` в опции [`env`](#options).3774Удалён в v2.1.275. До v2.1.274 включительно экспериментальный инструмент `REPL` можно было включить с помощью `CLAUDE_CODE_REPL=1` в опции [`env`](#options).

3771 3775

3772<h3 id="reportfindings">3776<h3 id="reportfindings">

3773 ReportFindings3777 ReportFindings

3774</h3>3778</h3>

3775 3779

3776**Имя tool:** `ReportFindings`3780**Имя инструмента:** `ReportFindings`

3777 3781

3778```typescript theme={null}3782```typescript theme={null}

3779type ReportFindingsInput = {3783type ReportFindingsInput = {

3791};3795};

3792```3796```

3793 3797

3794Сообщает о результатах код-ревью как структурированный список, чтобы Claude Code мог их отобразить вместо вывода их как текст. Результаты упорядочены от наиболее серьёзных, максимум 32 на вызов, и массив пуст, когда ничего не выжило. Требует Claude Code v2.1.196 или позже.3798Сообщает о результатах код-ревью в виде структурированного списка, чтобы Claude Code мог отобразить их, а не выводить как текст. Результаты упорядочены от наиболее серьёзных, максимум 32 за вызов, и массив пуст, если ни один результат не остался после проверки. Требует Claude Code v2.1.196 или позже.

3795 3799

3796`level` опционален и содержит уровень effort, который Claude сообщает для ревью. Claude Code не сравнивает его с уровнем, на котором фактически выполнялось ревью, поэтому они могут различаться.3800`level` опционален и содержит уровень effort, который Claude сообщает для ревью. Claude Code не сравнивает его с уровнем, на котором выполнялось ревью, поэтому они могут различаться.

3797 3801

3798Каждый результат содержит эти поля:3802Каждый результат содержит следующие поля:

3799 3803

3800* `file`: путь, относительный к репозиторию, в котором находится результат. Опциональный `line` — это 1-индексированная строка, к которой он привязан.3804* `file`: путь относительно репозитория к файлу, в котором находится результат. Опциональный `line` — это строка (нумерация с 1), к которой он привязан.

3801* `summary`: однострочное утверждение дефекта. `failure_scenario` описывает конкретные входные данные и состояние, которые приводят к неправильному выводу или сбою.3805* `summary`: утверждение о дефекте в одно предложение. `failure_scenario` описывает конкретные входные данные и состояние, которые приводят к неправильному выводу или сбою.

3802* `short_summary`: опциональный сжатый ярлык максимум 60 символов для компактного отображения. Требует Claude Code v2.1.212 или позже.3806* `short_summary`: опциональная сжатая метка длиной не более 60 символов для компактного отображения. Требует Claude Code v2.1.212 или позже.

3803* `category`: опциональный короткий kebab-case слаг типа результата, такой как `correctness` или `test-coverage`. Требует Claude Code v2.1.199 или позже.3807* `category`: опциональный короткий слаг типа результата в формате kebab-case, например `correctness` или `test-coverage`. Требует Claude Code v2.1.199 или позже.

3804* `verdict`: устанавливается, когда выполнялся проход проверки; отсутствует при встроенных проверках.3808* `verdict`: устанавливается, когда выполнялся проход верификации; отсутствует при ревью только с встроенной проверкой.

3805* `outcome`: устанавливается только при повторном сообщении после применения исправлений.3809* `outcome`: устанавливается только при повторном сообщении после применения исправлений.

3806 3810

3807<h3 id="artifact">3811<h3 id="artifact">

3808 Artifact3812 Artifact

3809</h3>3813</h3>

3810 3814

3811**Имя tool:** `Artifact`3815**Имя инструмента:** `Artifact`

3812 3816

3813```typescript theme={null}3817```typescript theme={null}

3814type ArtifactInput = {3818type ArtifactInput = {

3828};3832};

3829```3833```

3830 3834

3831Публикует локальный файл `.html` или `.md` как размещённую страницу артефакта или перечисляет опубликованные артефакты пользователя. Опустите `action` или передайте `"publish"` для публикации `file_path`, который обязателен для действия публикации. Каждое поле ниже применяется к публикации:3835Публикует локальный файл `.html` или `.md` как размещённую страницу артефакта или перечисляет опубликованные артефакты пользователя. Опустите `action` или передайте `"publish"`, чтобы опубликовать `file_path`, который обязателен для действия публикации. Каждое поле ниже относится к публикации:

3836

3837* `icon`: одно короткое общее слово для значка артефакта на вкладке браузера, например `chart` или `map`. Claude включает его при первой публикации и опускает при обновлении, что сохраняет сохранённый значок артефакта.

3838* `favicon`: устаревшее, и Claude его опускает.

3839* `title`: задаёт название опубликованной страницы на вкладке браузера и в галерее, когда в HTML-файле нет тега `<title>`.

3840* `url`: указывает существующий артефакт, который нужно обновить на месте вместо создания нового.

3832 3841

3833* `icon`: одно короткое общее слово для значка артефакта на вкладке браузера, такое как `chart` или `map`. Claude включает его при первой публикации и опускает при обновлении, что сохраняет сохранённый значок артефакта.3842`force` — это крайняя мера перезаписи, которая отбрасывает более новую версию, опубликованную другой сессией. При конфликте неудачная публикация возвращает более новое содержимое; Claude переносит свои изменения на это содержимое или повторно читает артефакт и публикует снова. Передавайте `force`, только когда пользователь явно просит отбросить эту версию.

3834* `favicon`: устарело, и Claude его опускает.

3835* `title`: называет опубликованную страницу на вкладке браузера и в галерее, когда HTML файл не имеет тега `<title>`.

3836* `url`: нацеливается на существующий артефакт для обновления на месте вместо создания нового.

3837 3843

3838`force` — это последняя мера перезаписи, которая отбрасывает более новую версию, опубликованную другой сессией. При конфликте неудачная публикация возвращает более новое содержимое; Claude объединяет его изменения с этим содержимым или повторно читает артефакт и публикует снова. Передавайте `force` только, когда пользователь явно просит отбросить эту версию.3844Передайте `"list"`, чтобы перечислить опубликованные артефакты пользователя; его могут сопровождать только `limit` и `scope`. `scope` по умолчанию равен `"mine"`, что перечисляет артефакты, которыми владеет пользователь; `"shared"` перечисляет артефакты, которыми другие люди поделились с пользователем, а `"all"` перечисляет и те, и другие.

3839 3845

3840Передайте `"list"` для перечисления опубликованных артефактов пользователя; только `limit` и `scope` могут его сопровождать. `scope` по умолчанию `"mine"`, который перечисляет артефакты, которыми владеет пользователь; `"shared"` перечисляет артефакты, которыми другие люди поделились с пользователем, и `"all"` перечисляет оба.3846`limit` задаёт максимальное число артефактов, возвращаемых в списке, от 1 до 200. Значение `limit` больше 50 требует Agent SDK v0.3.292 или позже. Без `limit` список возвращает до 25 артефактов.

3841 3847

3842* `capabilities`: возможности среды выполнения, которые использует опубликованная страница, ключ по названию возможности, такой как [коннекторы, которые может вызывать страница](/docs/ru/artifacts#pull-live-data-with-mcp-connectors). Сервис артефактов проверяет объявление и отклоняет публикацию, которая называет возможность, которую учётная запись не может использовать, или даёт ей недействительную конфигурацию. Передайте `{}` для очистки сохранённого объявления и опустите поле при повторном развёртывании, чтобы сохранить его. Требует Agent SDK v0.3.235 или позже.3848* `capabilities`: возможности среды выполнения, которые использует опубликованная страница, с ключами по названию возможности, например [коннекторы, которые может вызывать страница](/docs/ru/artifacts#pull-live-data-with-mcp-connectors). Сервис артефактов проверяет объявление и отклоняет публикацию, которая указывает возможность, недоступную учётной записи, или задаёт для неё недопустимую конфигурацию. Передайте `{}`, чтобы очистить сохранённое объявление, и опустите поле при повторном развёртывании, чтобы сохранить его. Требует Agent SDK v0.3.235 или позже.

3843* `contract`: версия среды выполнения, на которой работает опубликованная страница. Опустите её, чтобы сохранить текущую версию артефакта, передайте `"latest"` для обновления или передайте конкретную версию для закрепления или отката. Требует Agent SDK v0.3.235 или позже.3849* `contract`: версия среды выполнения, с которой работает опубликованная страница. Опустите её, чтобы сохранить текущую версию артефакта, передайте `"latest"` для обновления или передайте конкретную версию для закрепления или отката. Требует Agent SDK v0.3.235 или позже.

3844 3850

3845Типы экспортируются, но tool отключён по умолчанию в сессиях Agent SDK. Публикация также требует каждого условия в [таблице доступности артефактов](/docs/ru/artifacts#availability), которые сессии, аутентифицированные с помощью ключа API, не удовлетворяют.3851Типы экспортируются, но в сессиях Agent SDK инструмент по умолчанию отключён. Публикация также требует выполнения всех условий из [таблицы доступности артефактов](/docs/ru/artifacts#availability), которым сессии, аутентифицированные с помощью API-ключа, не удовлетворяют.

3846 3852

3847<h3 id="projects">3853<h3 id="projects">

3848 Projects3854 Projects

3849</h3>3855</h3>

3850 3856

3851**Имя tool:** `Projects`3857**Имя инструмента:** `Projects`

3852 3858

3853```typescript theme={null}3859```typescript theme={null}

3854type ProjectsInput = {3860type ProjectsInput = {

3867};3873};

3868```3874```

3869 3875

3870Читает и записывает Project claude.ai, присоединённый к сессии. Отправляет по `method`:3876Читает и записывает Project claude.ai, присоединённый к сессии. Выбирает операцию по `method`:

3871 3877

3872* `project_info`: возвращает метаданные проекта и список документов.3878* `project_info`: возвращает метаданные проекта и список документов.

3873* `project_read`: читает один документ по `path`.3879* `project_read`: читает один документ по `path`.

3874* `project_search`: запрашивает базу знаний проекта с помощью `query`. `n` ограничивает совпадения и по умолчанию равно 5.3880* `project_search`: выполняет запрос к базе знаний проекта с помощью `query`. `n` ограничивает число совпадений и по умолчанию равно `5`.

3875* `project_write`: создаёт или заменяет документ по `path` из ровно одного из `content`, который содержит встроенный текст, или `local_path`, который называет файл внутри рабочего каталога. `present_to_user: true` отмечает написанный документ как доставляемый результат, который пользователю нужно увидеть.3881* `project_write`: создаёт или заменяет документ по `path` из ровно одного из источников: `content`, содержащего встроенный текст, или `local_path`, указывающего файл внутри рабочего каталога. `present_to_user: true` отмечает записанный документ как итоговый результат, который пользователю нужно увидеть.

3876* `project_delete`: удаляет документ по `path`.3882* `project_delete`: удаляет документ по `path`.

3877 3883

3878<h3 id="readmcpresourcedir">3884<h3 id="readmcpresourcedir">

3879 ReadMcpResourceDir3885 ReadMcpResourceDir

3880</h3>3886</h3>

3881 3887

3882**Имя tool:** `ReadMcpResourceDirTool`3888**Имя инструмента:** `ReadMcpResourceDirTool`

3883 3889

3884```typescript theme={null}3890```typescript theme={null}

3885type ReadMcpResourceDirInput = {3891type ReadMcpResourceDirInput = {

3888};3894};

3889```3895```

3890 3896

3891Перечисляет прямых потомков ресурса каталога на сервере MCP. Используется только для сервера, который объявил поддержку перечисления каталогов; перечисление не является рекурсивным. Перечисление каталогов не включено в каждой сессии: когда оно отключено, вызов возвращает пустой список `resources` и поле `error` сообщает, что перечисление каталогов не включено.3897Перечисляет непосредственных потомков ресурса-каталога на MCP-сервере. Можно использовать только с сервером, который объявил поддержку перечисления каталогов; перечисление не рекурсивное. Перечисление каталогов включено не в каждой сессии: когда оно отключено, вызов возвращает пустой список `resources`, а поле `error` сообщает, что перечисление каталогов не включено.

3892 3898

3893<h3 id="refreshmcptools">3899<h3 id="refreshmcptools">

3894 RefreshMcpTools3900 RefreshMcpTools

3895</h3>3901</h3>

3896 3902

3897**Имя tool:** `RefreshMcpTools`3903**Имя инструмента:** `RefreshMcpTools`

3898 3904

3899```typescript theme={null}3905```typescript theme={null}

3900type RefreshMcpToolsInput = {3906type RefreshMcpToolsInput = {

3902};3908};

3903```3909```

3904 3910

3905Повторно запрашивает список tools подключённых серверов MCP и применяет любые изменения. Типы экспортируются, но Claude Code регистрирует tool только, когда вы установите `CLAUDE_CODE_ENABLE_REFRESH_MCP_TOOLS=1` в опции [`env`](#options), и только в сессиях с хотя бы одним сервером MCP. Требует Claude Code v2.1.211 или позже.3911Повторно запрашивает список инструментов подключённых MCP-серверов и применяет любые изменения. Типы экспортируются, но Claude Code регистрирует инструмент, только когда вы устанавливаете `CLAUDE_CODE_ENABLE_REFRESH_MCP_TOOLS=1` в опции [`env`](#options), и только в сессиях хотя бы с одним MCP-сервером. Требует Claude Code v2.1.211 или позже.

3906 3912

3907<h3 id="showonboardingrolepicker">3913<h3 id="showonboardingrolepicker">

3908 ShowOnboardingRolePicker3914 ShowOnboardingRolePicker

3909</h3>3915</h3>

3910 3916

3911**Имя tool:** `ShowOnboardingRolePicker`3917**Имя инструмента:** `ShowOnboardingRolePicker`

3912 3918

3913```typescript theme={null}3919```typescript theme={null}

3914type ShowOnboardingRolePickerInput = {};3920type ShowOnboardingRolePickerInput = {};

3915```3921```

3916 3922

3917Отображает кликабельную строку выбора ролей во время адаптации Cowork, чтобы пользователь мог выбрать свою роль и получить установленный соответствующий плагин. Не принимает аргументы; список ролей определяется клиентом. Вызов блокируется до ответа пользователя.3923Отображает кликабельный ряд чипов выбора роли во время онбординга Cowork, чтобы пользователь мог выбрать свою роль и получить установленный соответствующий плагин. Не принимает аргументов; список ролей определяется клиентом. Вызов блокируется до ответа пользователя.

3918 3924

3919<h3 id="mcpinput">3925<h3 id="mcpinput">

3920 McpInput3926 McpInput

3921</h3>3927</h3>

3922 3928

3923**Имя tool:** динамические имена tools MCP формы `mcp__<server>__<tool>`3929**Имя инструмента:** динамические имена инструментов MCP вида `mcp__<server>__<tool>`

3924 3930

3925```typescript theme={null}3931```typescript theme={null}

3926type McpInput = {3932type McpInput = {

3928};3934};

3929```3935```

3930 3936

3931Аргументы tools MCP — это открытый объект: каждый сервер определяет свои собственные параметры, поэтому тип не накладывает ограничений на имена полей или значения. Обратитесь к собственной схеме tools сервера для полей, которые принимает конкретный tool.3937Аргументы инструментов MCP — это открытый объект: каждый сервер определяет собственные параметры, поэтому тип не накладывает ограничений на имена полей или значения. Поля, которые принимает конкретный инструмент, смотрите в собственной схеме инструментов сервера.

3932 3938

3933<h2 id="tool-output-types">3939<h2 id="tool-output-types">

3934 Типы вывода инструментов3940 Типы вывода инструментов

4876 rel?: "mine" | "shared";4882 rel?: "mine" | "shared";

4877 }>;4883 }>;

4878 truncated?: boolean;4884 truncated?: boolean;

4885 total?: number;

4886 total_at_least?: true;

4879 scope?: "shared" | "all";4887 scope?: "shared" | "all";

4880 };4888 };

4881```4889```

4882 4890

4883Для действия публикации возвращает `url` опубликованной страницы и локальный `path`, который был опубликован; `updated` равно true, если публикация повторно развернула существующий артефакт, а `warnings` содержит предупреждения, возникшие при публикации. Действие получения списка вместо этого возвращает строки `artifacts`, а `truncated` устанавливается, если артефактов больше, чем запрошенный лимит. В списках, область действия которых отличается от `"mine"`, каждая строка содержит `rel`, указывающее, принадлежит ли артефакт пользователю или им поделились с пользователем, а поле `scope` в выводе фиксирует, какая нестандартная область действия сформировала список; в списках по умолчанию оба поля отсутствуют.4891Для действия публикации возвращает `url` опубликованной страницы и локальный `path`, который был опубликован; `updated` равно true, если публикация повторно развернула существующий артефакт, а `warnings` содержит предупреждения, возникшие при публикации. Действие получения списка вместо этого возвращает строки `artifacts`, а `truncated` устанавливается, если артефактов больше, чем запрошенный лимит. В списках, область действия которых отличается от `"mine"`, каждая строка содержит `rel`, указывающее, принадлежит ли артефакт пользователю или им поделились с пользователем, а поле `scope` в выводе фиксирует, какая нестандартная область действия сформировала список; в списках по умолчанию оба поля отсутствуют.

4884 4892

4893Результат получения списка также сообщает `total` — количество артефактов, соответствующих области действия списка, включая те, что выходят за пределы `limit`. Если установлено `total_at_least`, это число является нижней границей, и артефактов может быть больше. Для обоих полей требуется Agent SDK v0.3.292 или новее.

4894

4885<h3 id="projects-2">4895<h3 id="projects-2">

4886 Projects4896 Projects

4887</h3>4897</h3>

agent-teams.md +2 −0

Details

1593. [`CLAUDE_CODE_SUBAGENT_MODEL`](/docs/ru/model-config#environment-variables), когда оно установлено на что-либо иное, чем `inherit`.1593. [`CLAUDE_CODE_SUBAGENT_MODEL`](/docs/ru/model-config#environment-variables), когда оно установлено на что-либо иное, чем `inherit`.

1604. Текущая модель лидера.1604. Текущая модель лидера.

161 161

162Если установленный [мод](/docs/ru/plugins/mods/overview) задаёт модель в своём хуке [`agent.spawn`](/docs/ru/plugins/mods/reference#subagents), Claude Code использует эту модель вместо первого источника.

163

162Если вы установите [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1`](/docs/ru/sub-agents#run-every-subagent-on-one-model), первые два источника не применяются. Claude Code выбирает модель каждого товарища по команде из `CLAUDE_CODE_SUBAGENT_MODEL`, когда оно установлено на что-либо иное, чем `inherit`, и из текущей модели лидера в противном случае. Требует Claude Code v2.1.257 или позже.164Если вы установите [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1`](/docs/ru/sub-agents#run-every-subagent-on-one-model), первые два источника не применяются. Claude Code выбирает модель каждого товарища по команде из `CLAUDE_CODE_SUBAGENT_MODEL`, когда оно установлено на что-либо иное, чем `inherit`, и из текущей модели лидера в противном случае. Требует Claude Code v2.1.257 или позже.

163 165

164До версии v2.1.251 `CLAUDE_CODE_SUBAGENT_MODEL` был первым в этом порядке.166До версии v2.1.251 `CLAUDE_CODE_SUBAGENT_MODEL` был первым в этом порядке.

agent-view.md +12 −7

Details

226 226

227Введите ответ на панели просмотра и нажмите `Enter`, чтобы отправить его этой сессии. Начните ответ с `!`, чтобы вместо этого отправить команду Bash. Что произойдёт с ответом, зависит от сессии и от того, что вы отправляете:227Введите ответ на панели просмотра и нажмите `Enter`, чтобы отправить его этой сессии. Начните ответ с `!`, чтобы вместо этого отправить команду Bash. Что произойдёт с ответом, зависит от сессии и от того, что вы отправляете:

228 228

229* Работающая сессия: ответ попадает в [очередь сообщений](/docs/ru/interactive-mode#queue-messages-while-claude-works) сессии, не прерывая ответ, и вступает в силу [тогда же, когда и ввод из очереди](/docs/ru/interactive-mode#when-claude-code-sends-what-you-queued). [Команда](/docs/ru/commands) ждёт окончания хода, даже та, которая выполняется сразу, если ввести её в промпте самой сессии229* Работающая сессия: `/model`, `/effort`, `/rename` и `/usage` выполняются сразу. Другие ответы попадают в [очередь сообщений](/docs/ru/interactive-mode#queue-messages-while-claude-works) сессии, не прерывая ответ, и вступают в силу [тогда же, когда и ввод из очереди](/docs/ru/interactive-mode#when-claude-code-sends-what-you-queued). Другие [команды](/docs/ru/commands) ждут окончания хода, даже те, которые выполняются сразу, если ввести их в промпте самой сессии

230* Ответ, состоящий ровно из `/stop`: немедленно останавливает сессию, а не доставляется ей, независимо от того, работает сессия или ждёт вас230* Ответ, состоящий ровно из `/stop`: немедленно останавливает сессию, а не доставляется ей, независимо от того, работает сессия или ждёт вас

231* [Shell-задача](#run-a-shell-command): ответ, включая `/stop`, передаётся в терминал команды как введённый текст231* [Shell-задача](#run-a-shell-command): ответ, включая `/stop`, передаётся в терминал команды как введённый текст

232 232

238 238

239Когда хук [`PermissionRequest`](/docs/ru/hooks#permissionrequest) или [`PreToolUse`](/docs/ru/hooks#pretooluse) возвращает вывод, который Claude Code не может проверить для вызова, о котором спрашивает сессия, строка показывает событие хука и `hook output invalid:` с ошибкой проверки перед текстом ожидающего запроса. Если хук завершается с ошибкой иным образом, строка сообщает, что хук завершился с ошибкой. Сессия по-прежнему ждёт того же запроса.239Когда хук [`PermissionRequest`](/docs/ru/hooks#permissionrequest) или [`PreToolUse`](/docs/ru/hooks#pretooluse) возвращает вывод, который Claude Code не может проверить для вызова, о котором спрашивает сессия, строка показывает событие хука и `hook output invalid:` с ошибкой проверки перед текстом ожидающего запроса. Если хук завершается с ошибкой иным образом, строка сообщает, что хук завершился с ошибкой. Сессия по-прежнему ждёт того же запроса.

240 240

241Ответ, который не удаётся доставить, потому что фоновая служба недоступна или отправка не удалась, сохраняется и отправляется сессии в качестве следующего промпта, когда её процесс снова запустится, а сообщение об ошибке сообщает, что ответ был сохранён. Ответ с префиксом `!` не сохраняется, потому что сохранённый текст дошёл бы до сессии как обычный промпт, а не выполнился бы как команда Bash.241Если ответ не удаётся доставить, сообщение об ошибке указывает, был ли он сохранён. Ответ с префиксом `!` или `/` никогда не сохраняется. Claude Code отправляет сохранённый ответ в качестве следующего промпта сессии при следующем перезапуске сессии; любой другой ответ отправьте снова.

242 242

243Если [голосовая диктовка](/docs/ru/voice-dictation) включена в [режиме удержания](/docs/ru/voice-dictation#hold-to-record), удерживайте клавишу push-to-talk, пока фокус находится в поле ответа, чтобы продиктовать ответ вместо ввода. То же работает в поле отправки внизу agent view.243Если [голосовая диктовка](/docs/ru/voice-dictation) включена в [режиме удержания](/docs/ru/voice-dictation#hold-to-record), удерживайте клавишу push-to-talk, пока фокус находится в поле ответа, чтобы продиктовать ответ вместо ввода. То же работает в поле отправки внизу agent view.

244 244

288 288

289Строка, из которой вы нажали `←`, также сохраняет жирное, неприглушённое имя после того, как вы переместите выделение клавишами со стрелками или мышью, так что вы видите, из какой сессии пришли.289Строка, из которой вы нажали `←`, также сохраняет жирное, неприглушённое имя после того, как вы переместите выделение клавишами со стрелками или мышью, так что вы видите, из какой сессии пришли.

290 290

291Если в момент нажатия `←` выполняется инструмент, Claude Code ждёт примерно до десяти секунд, пока он завершится, прежде чем отправить сессию в фон, и Claude продолжает ответ в фоновой сессии. Нажмите `←` ещё раз, чтобы отправить в фон немедленно, не дожидаясь. Если выполняющуюся работу нельзя перенести в фоновую сессию, Claude Code сначала показывает диалоговое окно `Background this session?`, как и при [`/background`](#from-inside-a-session).291Если в момент нажатия `←` выполняется инструмент, Claude Code ждёт его завершения, прежде чем отправить сессию в фон, и Claude продолжает ответ в фоновой сессии. Нажмите `←` ещё раз, чтобы отправить в фон немедленно, не дожидаясь. Если выполняющуюся работу нельзя перенести в фоновую сессию, Claude Code сначала показывает диалоговое окно `Background this session?`, как и при [`/background`](#from-inside-a-session).

292 292

293Ограничение в десять секунд не действует, пока ещё работают [субагенты переднего плана](/docs/ru/sub-agents#run-subagents-in-foreground-or-background), которых Claude запустил в диалоге. Claude Code продолжает ждать, чтобы их работа перешла в фон, и на время ожидания показывает уведомление `Still backgrounding after the current tool`. Нажмите `←` ещё раз, чтобы отправить в фон без ожидания; при этом эти субагенты перезапустятся с начала. Claude Code не ждёт субагентов, которых запускает [динамический рабочий процесс](/docs/ru/workflows). Когда у рабочего процесса есть работающие субагенты, Claude Code вместо этого показывает диалоговое окно `Background this session?`.293Примерно через десять секунд Claude Code отправляет сессию в фон, не дожидаясь дольше, за исключением, например, следующих случаев:

294 294

295Claude Code не отправляет сессию в фон, пока в поле ввода промпта есть неотправленный текст, потому что этот текст остаётся в поле ввода вашего терминала и не перейдёт в фоновую сессию. Если вы начнёте вводить текст, пока Claude Code ждёт, чтобы отправить сессию в фон, он отменит переключение с сообщением `Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.`295* **Ещё работают субагенты переднего плана**: Claude Code продолжает ждать, чтобы работа [субагентов переднего плана](/docs/ru/sub-agents#run-subagents-in-foreground-or-background), которых запустил Claude, перешла в фон, и показывает `Still backgrounding after the current tool`. Нажмите `←` ещё раз, чтобы отправить в фон без ожидания; при этом эти субагенты перезапустятся с начала.

296* **Запрос разрешения или вопрос ожидает вашего ответа**: пока ожидает запрос разрешения или вопрос, заданный Claude, Claude Code продолжает ждать и показывает `Still backgrounding after the current tool — a question is waiting for your answer.`

297* **Вы вводите текст в поле ввода промпта**: Claude Code отменяет переключение, потому что неотправленный текст остаётся в поле ввода вашего терминала и не перейдёт в фоновую сессию. Он показывает `Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.`

298* **Сообщение из очереди нельзя перенести**: сообщения, которые вы [поставили в очередь, пока Claude работал](/docs/ru/interactive-mode#queue-messages-while-claude-works), переходят в фоновую сессию вместе с диалогом. Если какое-либо из них перенести нельзя, сессия остаётся на переднем плане, и Claude Code показывает уведомление, например `Cannot open agents — 1 queued message can't move to the background. Press ← again once Claude has read it.`

296 299

297Нажатие `←` создаёт строку сессии, даже если в диалоге ещё нет сообщений, поэтому `→` по-прежнему возвращает к нему.300Нажатие `←` создаёт строку сессии, даже если в диалоге ещё нет сообщений, поэтому `→` по-прежнему возвращает к нему.

298 301

876 879

877Каждая сессия — это собственный процесс Claude Code под супервизором, и то, что происходит с этим процессом, зависит от состояния сессии:880Каждая сессия — это собственный процесс Claude Code под супервизором, и то, что происходит с этим процессом, зависит от состояния сессии:

878 881

879* **Работает, приостановлена на запросе разрешения или другом диалоговом окне, или подключена**: процесс продолжает работать. Работающий субагент, рабочий процесс или монитор считается работой.882* **Работает, приостановлена на запросе разрешения или другом диалоговом окне, или подключена**: процесс продолжает работать. Работающий субагент, рабочий процесс или монитор считается работой, как и ожидающая [запланированная задача в рамках сессии](/docs/ru/scheduled-tasks), например пробуждение `/loop`.

880* **Завершена или ожидает вашего следующего сообщения, и не подключена примерно час**: супервизор останавливает процесс для освобождения ресурсов. Сессия, которая завершила свой ход, задав вам вопрос, считается ожидающей вашего следующего сообщения. Диалог остаётся на диске, и в следующий раз, когда вы подключитесь или ответите, сессия возобновляется с того места, где она остановилась. Закрепите сессию с помощью `Ctrl+T`, чтобы её процесс продолжал работать.883* **Завершена или ожидает вашего следующего сообщения, и не подключена примерно час**: супервизор останавливает процесс для освобождения ресурсов. Сессия, которая завершила свой ход, задав вам вопрос, считается ожидающей вашего следующего сообщения. Диалог остаётся на диске, и в следующий раз, когда вы подключитесь или ответите, сессия возобновляется с того места, где она остановилась. Закрепите сессию с помощью `Ctrl+T`, чтобы её процесс продолжал работать.

881* **Неожиданно завершилась, пока супервизор работает**: супервизор перезапускает процесс. Завершение сессии, которую вы отправили в фон самостоятельно с помощью `←` или `/background`, например с помощью `kill`, отмечает её как остановленную вместо перезапуска. Для сессий, которые завершились при выключении, см. [Sessions show as failed or stopped after shutdown](#sessions-show-as-failed-after-shutdown).884* **Неожиданно завершилась, пока супервизор работает**: супервизор перезапускает процесс. Завершение сессии, которую вы отправили в фон самостоятельно с помощью `←` или `/background`, например с помощью `kill`, отмечает её как остановленную вместо перезапуска. Для сессий, которые завершились при выключении, см. [Sessions show as failed or stopped after shutdown](#sessions-show-as-failed-after-shutdown).

882* **После автоматического обновления**: супервизор перезапускает себя на новую версию и переносит неактивные сессии в фоновом режиме. Сессии, которые работают, ожидают вас или подключены, не прерываются.885* **После автоматического обновления**: супервизор перезапускает себя на новую версию и переносит неактивные сессии в фоновом режиме. Сессии, которые работают, ожидают вас или подключены, не прерываются.

970* Терминал, в котором вы возобновили диалог, например с помощью `claude --resume` или `/resume`: строка показывает `Open in a terminal` с подсказкой продолжить там, а при открытии строки отображается `Can't open — this session is running in another terminal`. Продолжайте в этом терминале или выйдите из него и снова откройте строку.973* Терминал, в котором вы возобновили диалог, например с помощью `claude --resume` или `/resume`: строка показывает `Open in a terminal` с подсказкой продолжить там, а при открытии строки отображается `Can't open — this session is running in another terminal`. Продолжайте в этом терминале или выйдите из него и снова откройте строку.

971* Другой неинтерактивный процесс Claude Code, например фоновый процесс сессии для того же диалога, который ещё не завершился: при открытии строки отображается `This conversation is already open in another running Claude session`. Используйте этот процесс или дождитесь его завершения и снова откройте строку.974* Другой неинтерактивный процесс Claude Code, например фоновый процесс сессии для того же диалога, который ещё не завершился: при открытии строки отображается `This conversation is already open in another running Claude session`. Используйте этот процесс или дождитесь его завершения и снова откройте строку.

972 975

973Claude Code сохраняет ответ, который вы ввели при отклонённой попытке, и отправляет его при следующем запуске сессии.976Claude Code сохраняет ответ, который вы ввели при отклонённой попытке, если только он не начинается с `!` или `/`, и отправляет его при следующем запуске сессии.

974 977

975<h3 id="opening-a-session-says-it-has-no-saved-transcript">978<h3 id="opening-a-session-says-it-has-no-saved-transcript">

976 При открытии сессии сообщается, что у неё нет сохранённого транскрипта979 При открытии сессии сообщается, что у неё нет сохранённого транскрипта

1093| Версия | Изменение |1096| Версия | Изменение |

1094| - | - |1097| - | - |

1095| v2.1.290 | [`claude attach` и `claude logs`](#manage-sessions-from-the-shell) могут принимать часть имени работающей сессии вместо ID. |1098| v2.1.290 | [`claude attach` и `claude logs`](#manage-sessions-from-the-shell) могут принимать часть имени работающей сессии вместо ID. |

1099| v2.1.290 | `/model`, `/effort`, `/rename` и `/usage`, отправленные как [ответ из панели просмотра](#peek-and-reply) работающей сессии, выполняются сразу. |

1100| v2.1.290 | [Ответ из панели просмотра](#peek-and-reply), который не удаётся доставить, больше не сохраняется до следующего перезапуска, если он начинается с `/` или если он отвечает на вопрос с предопределёнными вариантами, пока процесс сессии работает. |

1096| v2.1.288 | `Ctrl+F` находит сессии по имени, а `Alt+↑` / `Alt+↓` переходят между заголовками групп. Эти сочетания клавиш, а также `Ctrl+R`, можно [переназначить](/docs/ru/keybindings#agents-actions). |1101| v2.1.288 | `Ctrl+F` находит сессии по имени, а `Alt+↑` / `Alt+↓` переходят между заголовками групп. Эти сочетания клавиш, а также `Ctrl+R`, можно [переназначить](/docs/ru/keybindings#agents-actions). |

1097| v2.1.287 | [Фильтр `n:<text>`](#filter-sessions) находит сессии по имени или первому промпту. Пока активен любой фильтр, свёрнутые вами группы разворачиваются, показывая свои совпадения, и выбирается первое совпадение, поэтому `Enter` открывает его. |1102| v2.1.287 | [Фильтр `n:<text>`](#filter-sessions) находит сессии по имени или первому промпту. Пока активен любой фильтр, свёрнутые вами группы разворачиваются, показывая свои совпадения, и выбирается первое совпадение, поэтому `Enter` открывает его. |

1098| v2.1.287 | Команда, отправленная как [ответ из панели просмотра](#peek-and-reply), выполняется, когда завершается текущий ход сессии, включая команды, которые выполняются сразу при вводе в собственном промпте сессии. Ответ, состоящий ровно из `/stop`, немедленно останавливает сессию. |1103| v2.1.287 | Команда, отправленная как [ответ из панели просмотра](#peek-and-reply), выполняется, когда завершается текущий ход сессии, включая команды, которые выполняются сразу при вводе в собственном промпте сессии. Ответ, состоящий ровно из `/stop`, немедленно останавливает сессию. |

amazon-bedrock.md +49 −12

Details

136 2. Настройте учётные данные AWS136 2. Настройте учётные данные AWS

137</h3>137</h3>

138 138

139Claude Code использует цепочку учётных данных AWS SDK по умолчанию. Настройте учётные данные, используя один из этих методов:139Claude Code использует цепочку учётных данных AWS SDK по умолчанию. Если машина уже предоставляет учётные данные этой цепочке, например через профиль экземпляра Amazon EC2 или учётные данные задачи Amazon ECS, перейдите к [шагу 3](#3-configure-claude-code).

140 140

141**Вариант A: конфигурация AWS CLI**141AWS [не рекомендует использовать ключи доступа пользователя IAM](https://docs.aws.amazon.com/cli/latest/userguide/cli-authentication-user.html) при разработке специализированного программного обеспечения или работе с реальными данными. Настройте учётные данные одним из следующих способов:

142

143* [`aws configure`](#use-aws-configure): сохраните ключ доступа пользователя IAM в профиле в каталоге `~/.aws`

144* [Переменные окружения с ключом доступа](#export-an-access-key): задайте ключ доступа или временные учётные данные с токеном сессии только в текущей оболочке

145* [Профиль SSO](#use-an-sso-profile): войдите через IAM Identity Center в браузере и получите временные учётные данные. Используйте этот способ, если вы получаете доступ к аккаунту AWS через IAM Identity Center.

146* [Учётные данные AWS Management Console](#use-aws-management-console-credentials): войдите через браузер с учётными данными AWS Management Console и получите временные учётные данные. AWS [рекомендует этот способ](https://docs.aws.amazon.com/signin/latest/userguide/command-line-sign-in.html), если вы получаете доступ к аккаунту AWS как пользователь root, как пользователь IAM или через федерацию с IAM.

147* [API-ключ Amazon Bedrock](#use-an-amazon-bedrock-api-key): аутентифицируйтесь с помощью Bearer-токена, который работает только для Amazon Bedrock, вместо учётных данных AWS

148

149<h4 id="use-aws-configure">

150 Использование `aws configure`

151</h4>

152

153Выполните `aws configure` и введите идентификатор ключа доступа, секретный ключ доступа и регион по умолчанию, когда появится запрос:

142 154

143```bash theme={null}155```bash theme={null}

144aws configure156aws configure

145```157```

146 158

147**Вариант B: переменные окружения (ключ доступа)**159AWS CLI сохраняет ключ в профиль `default` в файле `~/.aws/credentials`, откуда его считывает цепочка учётных данных.

160

161<h4 id="export-an-access-key">

162 Экспорт ключа доступа

163</h4>

164

165Экспортируйте ключ доступа в виде переменных окружения. `AWS_SESSION_TOKEN` требуется только для временных учётных данных, поэтому опустите эту строку, если ваш ключ доступа принадлежит пользователю IAM:

148 166

149```bash theme={null}167```bash theme={null}

150export AWS_ACCESS_KEY_ID=your-access-key-id168export AWS_ACCESS_KEY_ID=your-access-key-id

152export AWS_SESSION_TOKEN=your-session-token170export AWS_SESSION_TOKEN=your-session-token

153```171```

154 172

155**Вариант C: переменные окружения (профиль SSO)**173<h4 id="use-an-sso-profile">

174 Использование профиля SSO

175</h4>

156 176

157Замените `your-profile-name` на имя вашего профиля AWS перед выполнением этих команд.177Создайте профиль с помощью `aws configure sso`, если у вас его нет. Затем войдите в IAM Identity Center и установите `AWS_PROFILE`, чтобы цепочка учётных данных использовала этот профиль. Замените `your-profile-name` на имя вашего профиля AWS перед выполнением этих команд.

158 178

159```bash theme={null}179```bash theme={null}

160aws sso login --profile=your-profile-name180aws sso login --profile=your-profile-name

164 184

165Claude Code запрашивает учётные данные роли из региона IAM Identity Center, указанного в параметре `sso_region` профиля, который не обязательно должен совпадать с регионом, в котором вы запускаете Amazon Bedrock. В v2.1.207 регион Amazon Bedrock переопределял `sso_region`, поэтому профиль, экземпляр IAM Identity Center которого находится в другом регионе, не мог пройти аутентификацию с ошибкой `Session token not found or invalid`.185Claude Code запрашивает учётные данные роли из региона IAM Identity Center, указанного в параметре `sso_region` профиля, который не обязательно должен совпадать с регионом, в котором вы запускаете Amazon Bedrock. В v2.1.207 регион Amazon Bedrock переопределял `sso_region`, поэтому профиль, экземпляр IAM Identity Center которого находится в другом регионе, не мог пройти аутентификацию с ошибкой `Session token not found or invalid`.

166 186

167**Вариант D: учётные данные AWS Management Console**187<h4 id="use-aws-management-console-credentials">

188 Использование учётных данных AWS Management Console

189</h4>

190

191Команда `aws login` требует AWS CLI 2.32.0 или более поздней версии. Политику IAM, необходимую вашему удостоверению, см. в [инструкциях AWS для `aws login`](https://docs.aws.amazon.com/signin/latest/userguide/command-line-sign-in.html).

192

193Выполните команду, чтобы войти через браузер с учётными данными AWS Management Console:

168 194

169```bash theme={null}195```bash theme={null}

170aws login196aws login

171```197```

172 198

173[Узнайте больше](https://docs.aws.amazon.com/signin/latest/userguide/command-line-sign-in.html) о `aws login`.199Сессия действует до 12 часов, после чего нужно снова выполнить `aws login`.

200

201<h4 id="use-an-amazon-bedrock-api-key">

202 Использование API-ключа Amazon Bedrock

203</h4>

204

205API-ключ Amazon Bedrock — это Bearer-токен, который аутентифицирует ваши запросы вместо учётных данных AWS. AWS выдаёт [два типа ключей](https://docs.aws.amazon.com/bedrock/latest/userguide/api-keys.html):

174 206

175**Вариант E: ключи API Amazon Bedrock**207* **Краткосрочные ключи**: действуют до 12 часов. Для производственных сред AWS предпочитает их долгосрочным ключам.

208* **Долгосрочные ключи**: действуют до заданной вами даты истечения. AWS рекомендует их только для ознакомления.

209

210Экспортируйте ключ как `AWS_BEARER_TOKEN_BEDROCK`:

176 211

177```bash theme={null}212```bash theme={null}

178export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key213export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key

179```214```

180 215

181Ключи API Amazon Bedrock предоставляют более простой метод аутентификации без необходимости полных учётных данных AWS. [Узнайте больше о ключах API Amazon Bedrock](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/).216Когда установлена `AWS_BEARER_TOKEN_BEDROCK`, Claude Code аутентифицируется с помощью ключа и не разрешает цепочку учётных данных, даже если присутствуют другие учётные данные AWS. [Узнайте больше об API-ключах Amazon Bedrock](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/).

182 217

183<h4 id="credential-caching-and-resolution-timeout">218<h4 id="credential-caching-and-resolution-timeout">

184 Кэширование учётных данных и время ожидания разрешения219 Кэширование учётных данных и время ожидания разрешения

186 221

187Claude Code разрешает цепочку поставщика учётных данных AWS по умолчанию один раз и сохраняет разрешённые учётные данные в памяти. Он повторно использует их до пяти минут перед истечением срока действия или в течение одного часа, когда у них нет срока действия, поэтому профиль на основе SSO запрашивает учётные данные из IAM Identity Center примерно один раз за время жизни учётных данных. Ошибка учётных данных из API очищает кэш, и повторная попытка разрешает свежие учётные данные. Требуется Claude Code v2.1.207 или позже.222Claude Code разрешает цепочку поставщика учётных данных AWS по умолчанию один раз и сохраняет разрешённые учётные данные в памяти. Он повторно использует их до пяти минут перед истечением срока действия или в течение одного часа, когда у них нет срока действия, поэтому профиль на основе SSO запрашивает учётные данные из IAM Identity Center примерно один раз за время жизни учётных данных. Ошибка учётных данных из API очищает кэш, и повторная попытка разрешает свежие учётные данные. Требуется Claude Code v2.1.207 или позже.

188 223

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

190 225

191Разрешение, которое заполняет кэш, прерывается по таймауту через 60 секунд. Если шаг в цепочке зависает, например вспомогательный процесс `credential_process`, который ожидает входных данных, которые он не может получить, запрос завершается с ошибкой [`AWS default-chain credential resolve timed out`](/docs/ru/errors#aws-default-chain-credential-resolve-timed-out). Если ваша цепочка запускает интерактивный вход, который законно требует больше времени, например браузерный SSO с MFA через оболочку типа `aws-vault`, повысьте лимит в миллисекундах с помощью [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/ru/env-vars). Если установлено `CLAUDE_CODE_SKIP_AWS_CRED_CACHE=1`, каждый запрос к API разрешает цепочку без этого лимита.226Разрешение, которое заполняет кэш, прерывается по таймауту через 60 секунд. Если шаг в цепочке зависает, например вспомогательный процесс `credential_process`, который ожидает входных данных, которые он не может получить, запрос завершается с ошибкой [`AWS default-chain credential resolve timed out`](/docs/ru/errors#aws-default-chain-credential-resolve-timed-out). Если ваша цепочка запускает интерактивный вход, который законно требует больше времени, например браузерный SSO с MFA через оболочку типа `aws-vault`, повысьте лимит в миллисекундах с помощью [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/ru/env-vars). Если установлено `CLAUDE_CODE_SKIP_AWS_CRED_CACHE=1`, каждый запрос к API разрешает цепочку без этого лимита.

192 227

509 Окно контекста 1M токенов544 Окно контекста 1M токенов

510</h2>545</h2>

511 546

512Claude Sonnet 5, Opus 4.6 и более поздние версии, а также Sonnet 4.6 поддерживают [окно контекста 1M токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) на Amazon Bedrock. Sonnet 5 всегда работает с окном 1M как на Invoke API, так и на [конечной точке Mantle](#use-the-mantle-endpoint), без варианта `[1m]` для выбора. Для других моделей на Invoke API Claude Code автоматически включает расширенное окно контекста при выборе варианта модели 1M.547Модели Fable, Sonnet 5 и более поздние версии, а также Opus 4.7 и более поздние версии по умолчанию работают с [контекстным окном 1M токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) на Amazon Bedrock как на Invoke API, так и на [эндпоинте Mantle](#use-the-mantle-endpoint), без необходимости в суффиксе `[1m]`. ARN профиля инференса приложения получает окно 1M, если запись [`modelOverrides`](#map-each-model-version-to-an-inference-profile) сопоставляет с ним его модель. Чтобы вместо этого сохранить окно 200K, установите [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/ru/model-config#turn-off-1m-context).

548

549Opus 4.6 и Sonnet 4.6 на Invoke API получают окно 1M, если вы выбираете их вариант `[1m]`. [Мастер установки](#sign-in-with-bedrock) предлагает опцию контекста 1M при закреплении моделей. Чтобы включить его для вручную закрепленной модели вместо этого, добавьте `[1m]` к ID модели. См. [Pin models for third-party deployments](/docs/ru/model-config#pin-models-for-third-party-deployments) для получения подробной информации, включая способы использования окна 1M без изменения закрепления.

513 550

514[Мастер установки](#sign-in-with-bedrock) предлагает опцию контекста 1M при закреплении моделей. Чтобы включить его для вручную закрепленной модели вместо этого, добавьте `[1m]` к ID модели. См. [Pin models for third-party deployments](/docs/ru/model-config#pin-models-for-third-party-deployments) для получения подробной информации, включая способы использования окна 1M без изменения закрепления.551До версии v2.1.287 модели Fable, а также Opus 4.7 и более поздние версии по умолчанию работали с окном 200K на Invoke API и получали там окно 1M с помощью суффикса `[1m]`.

515 552

516<h2 id="service-tiers">553<h2 id="service-tiers">

517 Уровни обслуживания554 Уровни обслуживания

artifacts.md +1 −1

Details

391| Authentication | Сеанс поддерживается учётной записью claude.ai: войдите с помощью `/login` в CLI или приложении для рабочего стола. Сеансы Claude Tag вошли через идентификацию агента, поэтому никаких шагов не требуется. Сеансы, использующие ключ API, [токен шлюза](/docs/ru/llm-gateway) или учётные данные поставщика облачных услуг, не могут публиковать. |391| Authentication | Сеанс поддерживается учётной записью claude.ai: войдите с помощью `/login` в CLI или приложении для рабочего стола. Сеансы Claude Tag вошли через идентификацию агента, поэтому никаких шагов не требуется. Сеансы, использующие ключ API, [токен шлюза](/docs/ru/llm-gateway) или учётные данные поставщика облачных услуг, не могут публиковать. |

392| Model provider | Anthropic API. Недоступно на [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) или [Microsoft Foundry](/docs/ru/microsoft-foundry). |392| Model provider | Anthropic API. Недоступно на [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) или [Microsoft Foundry](/docs/ru/microsoft-foundry). |

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

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

395 395

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

397 397

authentication.md +0 −2

Details

142* **Из чего он вас выходит**: Claude Code выходит из любого входа claude.ai, сохраненного на машине142* **Из чего он вас выходит**: Claude Code выходит из любого входа claude.ai, сохраненного на машине

143* **Как это отменить**: запустите `/logout`, который удаляет и отзывает учетные данные, которые этот вход записал143* **Как это отменить**: запустите `/logout`, который удаляет и отзывает учетные данные, которые этот вход записал

144 144

145Если ваша организация использует [параметры, управляемые сервером](/docs/ru/server-managed-settings), они применяются к этому входу на Claude Code v2.1.257 или позже.

~~146~~

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

148 146

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

claude-apps-gateway.md +2 −1

Details

305 Разрешение шлюза в принадлежащем вам публичном адресном пространстве305 Разрешение шлюза в принадлежащем вам публичном адресном пространстве

306</h3>306</h3>

307 307

308Некоторые организации нумеруют свою внутреннюю сеть из принадлежащего им публичного блока IPv4, например из собственного адресного пространства оператора связи или устаревшего `/8`, поэтому их шлюз не может иметь приватный адрес. Перечислите эти блоки в управляемой настройке `gatewayInternalNetworks`. Тогда `/login` принимает шлюз внутри перечисленного блока, если машина разработчика подключается к нему с адреса внутри того же блока. Для этого требуется Claude Code v2.1.268 или новее на машине разработчика; более ранние версии игнорируют ключ и применяют правило приватных адресов.308Некоторые организации нумеруют свою внутреннюю сеть из принадлежащего им публичного блока IPv4, например из собственного адресного пространства оператора связи или устаревшего `/8`, поэтому у их шлюза нет приватного адреса. Перечислите эти блоки в управляемой настройке `gatewayInternalNetworks`. Тогда `/login` принимает шлюз внутри перечисленного блока, если машина разработчика подключается к нему с адреса внутри того же блока. Для этого требуется Claude Code v2.1.268 или новее на машине разработчика; более ранние версии игнорируют ключ и применяют правило приватных адресов.

309 309

310<Warning>310<Warning>

311 `gatewayInternalNetworks` предназначен для внутренних сетей, которые просто нумеруются из публичного адресного пространства. Он не делает безопасным открытие шлюза в интернет: доверенный шлюз может передавать настройки, которые запускают команды на машинах разработчиков.311 `gatewayInternalNetworks` предназначен для внутренних сетей, которые просто нумеруются из публичного адресного пространства. Он не делает безопасным открытие шлюза в интернет: доверенный шлюз может передавать настройки, которые запускают команды на машинах разработчиков.

524| - | - | - |524| - | - | - |

525| Пересылка вывода (Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform, Microsoft Foundry, Anthropic) | Доступно | С переводом модели для каждого вышестоящего уровня и отказоустойчивостью. Вышестоящий уровень Amazon Bedrock использует эндпоинт `bedrock-runtime` и цепь учётных данных AWS по умолчанию. [Вышестоящий уровень Amazon Bedrock Mantle](/docs/ru/claude-apps-gateway-config#amazon-bedrock-mantle-endpoint) требует Claude Code v2.1.283 или более поздней версии на сервере шлюза, а [вышестоящий уровень Claude Platform on AWS](/docs/ru/claude-apps-gateway-config#claude-platform-on-aws) требует v2.1.198 или более поздней версии. |525| Пересылка вывода (Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform, Microsoft Foundry, Anthropic) | Доступно | С переводом модели для каждого вышестоящего уровня и отказоустойчивостью. Вышестоящий уровень Amazon Bedrock использует эндпоинт `bedrock-runtime` и цепь учётных данных AWS по умолчанию. [Вышестоящий уровень Amazon Bedrock Mantle](/docs/ru/claude-apps-gateway-config#amazon-bedrock-mantle-endpoint) требует Claude Code v2.1.283 или более поздней версии на сервере шлюза, а [вышестоящий уровень Claude Platform on AWS](/docs/ru/claude-apps-gateway-config#claude-platform-on-aws) требует v2.1.198 или более поздней версии. |

526| Контекстное окно на 1M токенов | Доступно | Модели Fable, Sonnet 5 и более поздние, а также Opus 4.7 и более поздние по умолчанию работают с контекстным окном 1M; см. [Расширенный контекст](/docs/ru/model-config#extended-context). Окно 1M по умолчанию для моделей Fable и Opus требует Claude Code v2.1.287 или более поздней версии на компьютере разработчика |

526| Доступ к модели и управляемые настройки по группе IdP | Доступно | Доступ к модели применяется на стороне сервера; управляемые настройки доставляются для каждой группы IdP и применяются CLI на [уровне управляемых настроек](/docs/ru/settings#settings-precedence) |527| Доступ к модели и управляемые настройки по группе IdP | Доступно | Доступ к модели применяется на стороне сервера; управляемые настройки доставляются для каждой группы IdP и применяются CLI на [уровне управляемых настроек](/docs/ru/settings#settings-precedence) |

527| Claude Desktop | Доступно с согласия | Шлюз обслуживает конфигурацию Claude Desktop по адресу `/user/bootstrap` после того, как политика [согласится с ключом `desktop`](/docs/ru/claude-apps-gateway-config#claude-desktop-overlay), и Claude Desktop отправляет запросы модели из своих вкладок Cowork и Code, а также из вкладки Chat, когда вы её включите, через шлюз. Чтобы включить вкладку Chat, см. [Подключение Claude Desktop](#connect-claude-desktop). Требует Claude Code v2.1.203 или более поздней версии на сервере шлюза. |528| Claude Desktop | Доступно с согласия | Шлюз обслуживает конфигурацию Claude Desktop по адресу `/user/bootstrap` после того, как политика [согласится с ключом `desktop`](/docs/ru/claude-apps-gateway-config#claude-desktop-overlay), и Claude Desktop отправляет запросы модели из своих вкладок Cowork и Code, а также из вкладки Chat, когда вы её включите, через шлюз. Чтобы включить вкладку Chat, см. [Подключение Claude Desktop](#connect-claude-desktop). Требует Claude Code v2.1.203 или более поздней версии на сервере шлюза. |

claude-apps-gateway-deploy.md +22 −7

Details

6 6

7> Зарегистрируйте шлюз в вашем поставщике идентификации, создайте контейнер, разверните на Kubernetes или Cloud Run и управляйте им: проверки здоровья, ротация секретов, обновления и безопасность.7> Зарегистрируйте шлюз в вашем поставщике идентификации, создайте контейнер, разверните на Kubernetes или Cloud Run и управляйте им: проверки здоровья, ротация секретов, обновления и безопасность.

8 8

9<Info>

10 **Сначала спланируйте сеть для шлюза.** При входе Claude Code отказывается подключаться к шлюзу Claude apps, имя хоста которого разрешается в публичный IP-адрес, даже если этот адрес недоступен из интернета.

12 Шлюз Claude apps может отправлять настройки на машины пользователей, включая хуки, которые запускают shell-команды. Эта проверка помогает не допустить, чтобы пользователи случайно вошли в вредоносный шлюз в публичном интернете. Держите и свой собственный шлюз вне интернета.

14 Выберите адрес шлюза до того, как выбирать, где он будет работать. Обычно это частный адрес, к которому пользователи обращаются во внутренней сети или через VPN. Если ваша внутренняя сеть использует публичные диапазоны IPv4, вы можете указать один диапазон, в который входят и шлюз, и машины ваших пользователей. Claude Code воспринимает такое совпадение как признак того, что шлюз находится в вашей внутренней сети. См. [Выбор адреса для шлюза](#choose-an-address-for-the-gateway). Если ни один из вариантов не подходит для вашей сети, обратитесь к вашей команде по работе с клиентами Anthropic.

15</Info>

9На этой странице рассматривается операционная сторона запуска [шлюза Claude apps](/docs/ru/claude-apps-gateway): регистрация клиента OAuth в вашем поставщике идентификации (IdP), развертывание шлюза как контейнера и его ежедневное управление. Для каждого параметра в файле `gateway.yaml`, который шлюз читает при загрузке, см. [Справочник по конфигурации](/docs/ru/claude-apps-gateway-config).17На этой странице рассматривается операционная сторона запуска [шлюза Claude apps](/docs/ru/claude-apps-gateway): регистрация клиента OAuth в вашем поставщике идентификации (IdP), развертывание шлюза как контейнера и его ежедневное управление. Для каждого параметра в файле `gateway.yaml`, который шлюз читает при загрузке, см. [Справочник по конфигурации](/docs/ru/claude-apps-gateway-config).

10 18

11Развертывание в производстве следует четырем этапам по порядку, и разделы ниже соответствуют им. Первые два — это места, где вы делаете выбор; вторые два — справочный материал, который следует консультировать после запуска.19Развертывание в производстве следует четырем этапам по порядку, и разделы ниже соответствуют им. Первые два — это места, где вы делаете выбор; вторые два — справочный материал, который следует консультировать после запуска.

17 25

18Если вход или загрузка не удаются, перейдите прямо к [Устранению неполадок](#troubleshooting), который организован по ошибкам, которые вы видите.26Если вход или загрузка не удаются, перейдите прямо к [Устранению неполадок](#troubleshooting), который организован по ошибкам, которые вы видите.

19 27

~~20<Note>~~

21 **Развертывайте в вашей частной сети.** Claude Code подключается только к шлюзу, адрес которого является приватным. Это защита безопасности, потому что доверенный шлюз может отправлять параметры, которые запускают команды на машинах разработчиков. Поместите шлюз за внутренним балансировщиком нагрузки или VPN и дайте ему имя хоста, которое разрешается только на приватные IP-адреса. Если ваша внутренняя сеть нумеруется из публичного пространства IPv4, которым владеет ваша организация, см. [Разрешить шлюз на публичном адресном пространстве, которым вы владеете](/docs/ru/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own).

~~22</Note>~~

24<h2 id="identity-provider-setup">28<h2 id="identity-provider-setup">

25 Настройка поставщика удостоверений29 Настройка поставщика удостоверений

26</h2>30</h2>

51 Развертывание55 Развертывание

52</h2>56</h2>

53 57

54Шлюз — это один stateless бинарный файл Linux, который координирует работу через Postgres, поэтому развертывайте его так же, как вы развертываете любой другой stateless сервис в вашей среде. Держите его внутри вашей сети, где ваши разработчики и IdP могут достичь его по HTTPS, и относитесь к нему как к любому сервису, содержащему production учетные данные.58Шлюз — это один stateless бинарный файл Linux, который координирует работу через Postgres, поэтому развёртывайте его так же, как вы развёртываете любой другой stateless сервис в вашей среде. Держите его внутри вашей сети, где ваши разработчики могут обращаться к нему по HTTPS, а он может обращаться к вашему IdP, и относитесь к нему как к любому сервису, содержащему production учётные данные.

55 59

56Несколько решений формируют развертывание помимо того, где оно работает:60Несколько решений формируют развертывание помимо того, где оно работает:

57 61

71 75

72Значение по умолчанию, такое как 60 секунд ALB, достаточно, чтобы держать тихий поток открытым. [Пример AWS](/docs/ru/claude-apps-gateway-on-aws#troubleshooting) поднимает его до часа в любом случае, и его строка troubleshooting охватывает шлюзы старше v2.1.229, которые не отправляли ничего во время тихих периодов на upstream'ах, которые теперь получают ping'и.76Значение по умолчанию, такое как 60 секунд ALB, достаточно, чтобы держать тихий поток открытым. [Пример AWS](/docs/ru/claude-apps-gateway-on-aws#troubleshooting) поднимает его до часа в любом случае, и его строка troubleshooting охватывает шлюзы старше v2.1.229, которые не отправляли ничего во время тихих периодов на upstream'ах, которые теперь получают ping'и.

73 77

78<h3 id="choose-an-address-for-the-gateway">

79 Выберите адрес для шлюза

80</h3>

82Claude Code принимает адрес шлюза одним из двух способов:

84* **Частный адрес**: разместите шлюз за внутренним балансировщиком нагрузки или VPN с именем хоста, которое разрешается только в частные адреса, такие как RFC 1918 или CGNAT `100.64.0.0/10`. Машины пользователей могут иметь любой адрес. [Предварительное требование о частной сети](/docs/ru/claude-apps-gateway#prerequisites) перечисляет допустимые диапазоны.

85* **Объявленный блок**: если ваша внутренняя сеть использует публичное пространство IPv4, принадлежащее вашей организации, укажите этот блок в управляемой настройке `gatewayInternalNetworks`. И шлюз, и машина пользователя должны находиться в этом блоке. См. [Разрешение шлюза в публичном адресном пространстве, которым вы владеете](/docs/ru/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own).

87Если ни один блок не содержит их обоих, вместо этого назначьте шлюзу частный адрес.

74<h3 id="container-image">89<h3 id="container-image">

75 Образ контейнера90 Образ контейнера

76</h3>91</h3>

375 Устранение неполадок390 Устранение неполадок

376</h2>391</h2>

377 392

378Для вопросов и обратной связи используйте [поддержку Claude Code](https://support.claude.com/en/collections/14445694-claude-code) или откройте issue в [репозитории Claude Code на GitHub](https://github.com/anthropics/claude-code/issues). При сообщении о проблеме включите:393Для вопросов и обратной связи используйте [поддержку Claude Code](https://support.claude.com/en/collections/14445694-claude-code) или откройте issue в [репозитории Claude Code на GitHub](https://github.com/anthropics/claude-code/issues). Вы также можете связаться с командой, обслуживающей ваш аккаунт в Anthropic. При сообщении о проблеме включите:

379 394

380* **Проблема шлюза**: stderr шлюза для соответствующего окна, ваш `gateway.yaml` с редактированными секретами, версию шлюза, показанную на целевой странице в `/` и в заголовке ответа `x-cc-gateway-version` на `/managed/settings`, и что недавно изменилось395* **Проблема шлюза**: stderr шлюза для соответствующего окна, ваш `gateway.yaml` с редактированными секретами, версию шлюза, показанную на целевой странице в `/` и в заголовке ответа `x-cc-gateway-version` на `/managed/settings`, и что недавно изменилось

381* **Проблема входа**: разработчик запускает `claude --debug-file ./claude-debug.txt`, воспроизводит и отправляет этот файл плюс журнал аудита шлюза для того же окна396* **Проблема входа**: разработчик запускает `claude --debug-file ./claude-debug.txt`, воспроизводит и отправляет этот файл плюс журнал аудита шлюза для того же окна

394| CLI `/login`: `The gateway is limiting sign-in attempts right now`, или `Request failed with status code 429` на более старых версиях. Страница `/device` может показывать `Too many attempts` разработчикам, которые раньше не пробовали | Было достигнуто ограничение частоты запросов на вход для каждого IP. Либо `listen.trusted_proxies` не охватывает балансировщик нагрузки, поэтому каждый разработчик использует его адрес, либо много разработчиков используют один адрес выхода NAT или VPN. События аудита с `result: rate_limited` показывают одно или несколько одинаковых значений `client_ip`. | Сначала установите `listen.trusted_proxies` на диапазоны источников балансировщика нагрузки, затем поднимите `rate_limits`, если разработчики всё ещё используют общие адреса. См. [Large rollouts](#large-rollouts). |409| CLI `/login`: `The gateway is limiting sign-in attempts right now`, или `Request failed with status code 429` на более старых версиях. Страница `/device` может показывать `Too many attempts` разработчикам, которые раньше не пробовали | Было достигнуто ограничение частоты запросов на вход для каждого IP. Либо `listen.trusted_proxies` не охватывает балансировщик нагрузки, поэтому каждый разработчик использует его адрес, либо много разработчиков используют один адрес выхода NAT или VPN. События аудита с `result: rate_limited` показывают одно или несколько одинаковых значений `client_ip`. | Сначала установите `listen.trusted_proxies` на диапазоны источников балансировщика нагрузки, затем поднимите `rate_limits`, если разработчики всё ещё используют общие адреса. См. [Large rollouts](#large-rollouts). |

395| CLI `/login`: `Gateway hosts must be on your organization's private network; <host> resolves to the public (or unrecognized) address <ip>` | Имя хоста шлюза разрешается по крайней мере в один публичный IP-адрес. Claude Code проверяет каждый разрешённый адрес и требует, чтобы каждый был приватным. Частая причина — dual-stack имя, где одно семейство разрешается в публичный адрес, включая внутренние dual-stack балансировщики нагрузки AWS, которые возвращают AAAA-адреса из публичного диапазона. | Сделайте так, чтобы имя шлюза разрешалось только в приватные адреса на машинах разработчиков. Для dual-stack имени удалите запись из публичного диапазона или обслуживайте отдельное внутреннее DNS-имя. См. [предварительное требование о приватной сети](/docs/ru/claude-apps-gateway#prerequisites). Если адрес находится в публичном пространстве, которым владеет и которое использует внутри ваша организация, вместо этого [объявите этот блок](/docs/ru/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own). |410| CLI `/login`: `Gateway hosts must be on your organization's private network; <host> resolves to the public (or unrecognized) address <ip>` | Имя хоста шлюза разрешается по крайней мере в один публичный IP-адрес. Claude Code проверяет каждый разрешённый адрес и требует, чтобы каждый был приватным. Частая причина — dual-stack имя, где одно семейство разрешается в публичный адрес, включая внутренние dual-stack балансировщики нагрузки AWS, которые возвращают AAAA-адреса из публичного диапазона. | Сделайте так, чтобы имя шлюза разрешалось только в приватные адреса на машинах разработчиков. Для dual-stack имени удалите запись из публичного диапазона или обслуживайте отдельное внутреннее DNS-имя. См. [предварительное требование о приватной сети](/docs/ru/claude-apps-gateway#prerequisites). Если адрес находится в публичном пространстве, которым владеет и которое использует внутри ваша организация, вместо этого [объявите этот блок](/docs/ru/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own). |

396| CLI `/login`: `Gateway login would go through proxy <proxy>, which is not on a private network` | `HTTPS_PROXY` или `HTTP_PROXY` применяется к хосту шлюза, и имя хоста прокси разрешается в публичный адрес. Прокси, чьё имя хоста разрешается только в приватные адреса, разрешён и не вызывает эту ошибку | Добавьте хост шлюза в `NO_PROXY` на машине разработчика, чтобы соединение было прямым, или используйте прокси, чьё имя хоста разрешается в приватные адреса. Сообщение называет точную запись `NO_PROXY` для добавления |411| CLI `/login`: `Gateway login would go through proxy <proxy>, which is not on a private network` | `HTTPS_PROXY` или `HTTP_PROXY` применяется к хосту шлюза, и имя хоста прокси разрешается в публичный адрес. Прокси, чьё имя хоста разрешается только в приватные адреса, разрешён и не вызывает эту ошибку | Добавьте хост шлюза в `NO_PROXY` на машине разработчика, чтобы соединение было прямым, или используйте прокси, чьё имя хоста разрешается в приватные адреса. Сообщение называет точную запись `NO_PROXY` для добавления |

397| CLI `/login`: `Claude Code only signs in to <host> from inside its declared network <block> (managed settings), and this machine is connecting from <ip>, outside it` | Шлюз находится в блоке, объявленном в [`gatewayInternalNetworks`](/docs/ru/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own), и машина разработчика достигла его с адреса вне этого блока: адрес из пула VPN, контейнер или сегмент NAT WSL2, или сеть, которая не ваша | Попросите разработчика запустить `/login` из хост-ОС в вашей сети. Если показанный адрес также является собственным публичным пространством вашей организации, замените запись шлюза на блок, который охватывает оба, вплоть до `/8`; вторая, перекрывающаяся запись отклоняется |412| CLI `/login`: `Claude Code only signs in to <host> from inside its declared network <block> (managed settings), and this machine is connecting from <ip>, outside it` | Шлюз находится в блоке, объявленном в [`gatewayInternalNetworks`](/docs/ru/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own), и машина разработчика достигла его с адреса вне этого блока: адрес из пула VPN, контейнер или сегмент NAT WSL2, или сеть, которая не ваша | Попросите разработчика запустить `/login` из хост-ОС в вашей сети. Если показанный адрес также является собственным публичным пространством вашей организации, замените запись шлюза на блок, который охватывает оба, вплоть до `/8`; вторая, перекрывающаяся запись отклоняется. Если ни один блок не охватывает оба, см. [Выбор адреса для шлюза](#choose-an-address-for-the-gateway) |

398| CLI `/login`: `Every address for gateway host <host> must be inside its declared network <block>, and it also resolves to <ip>` | Имя шлюза разрешается в адрес вне блока, объявленного в [`gatewayInternalNetworks`](/docs/ru/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own): второй сайт или запись IPv6 на dual-stack имени. При объявленном блоке каждая запись должна быть внутри этого одного IPv4-блока, включая приватные и IPv6-адреса | Публикуйте только записи внутри блока для имени шлюза на машинах разработчиков или обслуживайте отдельное внутреннее имя |413| CLI `/login`: `Every address for gateway host <host> must be inside its declared network <block>, and it also resolves to <ip>` | Имя шлюза разрешается в адрес вне блока, объявленного в [`gatewayInternalNetworks`](/docs/ru/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own): второй сайт или запись IPv6 на dual-stack имени. При объявленном блоке каждая запись должна быть внутри этого одного IPv4-блока, включая приватные и IPv6-адреса | Публикуйте только записи внутри блока для имени шлюза на машинах разработчиков или обслуживайте отдельное внутреннее имя |

399| CLI `/login`: `<host> is on the declared network <block>, which Claude Code checks over a direct connection, not through an HTTP proxy` | `HTTPS_PROXY` или `HTTP_PROXY` применяется к шлюзу в объявленном блоке | На машине разработчика добавьте запись `NO_PROXY`, которую называет сообщение |414| CLI `/login`: `<host> is on the declared network <block>, which Claude Code checks over a direct connection, not through an HTTP proxy` | `HTTPS_PROXY` или `HTTP_PROXY` применяется к шлюзу в объявленном блоке | На машине разработчика добавьте запись `NO_PROXY`, которую называет сообщение |

400| CLI `/login`: сообщение, начинающееся с `gatewayInternalNetworks in managed settings` | Значение нарушает одно из [правил валидации](/docs/ru/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own), и сообщение называет какое. До тех пор, пока вы его не исправите, Claude Code отклоняет каждый новый `/login` шлюза на машине, включая шлюзы на приватных адресах; существующие входы продолжают работать | В источнике управляемых настроек, который вы развёртываете, исправьте запись, которую называет сообщение, затем повторите `/login` |415| CLI `/login`: сообщение, начинающееся с `gatewayInternalNetworks in managed settings` | Значение нарушает одно из [правил валидации](/docs/ru/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own), и сообщение называет какое. До тех пор, пока вы его не исправите, Claude Code отклоняет каждый новый `/login` шлюза на машине, включая шлюзы на приватных адресах; существующие входы продолжают работать | В источнике управляемых настроек, который вы развёртываете, исправьте запись, которую называет сообщение, затем повторите `/login` |

claude-code-on-the-web.md +5 −5

Details

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

11</Note>11</Note>

12 12

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

14 14

15Чтобы облачные сессии могли клонировать ваш код из GitHub и отправлять ветки, подключите GitHub одним из [способов подключения GitHub](#github-authentication-options). Если ваш репозиторий размещён в GitLab, Bitbucket или на другом хостинге, см. раздел [Ограничения платформы](#limitations), чтобы узнать, что работает.15Чтобы облачные сессии могли клонировать ваш код из GitHub и отправлять ветки, подключите GitHub одним из [способов подключения GitHub](#github-authentication-options). Если ваш репозиторий размещён в GitLab, Bitbucket или на другом хостинге, см. раздел [Ограничения платформы](#limitations), чтобы узнать, что работает.

16 16

57Следующие функции зависят от того, установлено ли приложение Claude GitHub на репозитории:57Следующие функции зависят от того, установлено ли приложение Claude GitHub на репозитории:

58 58

59* **Auto-fix**: установка приложения Claude GitHub на репозиторий также включает [Auto-fix](#auto-fix-pull-requests) для pull request в нём59* **Auto-fix**: установка приложения Claude GitHub на репозиторий также включает [Auto-fix](#auto-fix-pull-requests) для pull request в нём

60* **Проекты**: потоки в [проекте](/docs/ru/claude-projects) требуют установки приложения Claude GitHub на каждом репозитории, который они клонируют, независимо от того, каким методом вы подключились. См. [Set up GitHub access](/docs/ru/claude-projects#set-up-github-access)60* **Проекты**: потоки в [проекте](/docs/ru/claude-projects) требуют установки приложения Claude GitHub на каждом репозитории, который они клонируют, независимо от того, каким методом вы подключились. См. [Настройка доступа GitHub](/docs/ru/claude-projects#set-up-github-access)

61 61

62В среде, размещённой на серверах Anthropic, ваши учётные данные GitHub остаются зашифрованными на серверах Anthropic и никогда не попадают в виртуальную машину сессии. Операции GitHub из виртуальной машины проходят через [GitHub proxy](/docs/ru/cloud-environments#github-proxy), который прикрепляет учётные данные на стороне сервера.62В среде, размещённой на серверах Anthropic, ваши учётные данные GitHub остаются зашифрованными на серверах Anthropic и никогда не попадают в виртуальную машину сессии. Операции GitHub из виртуальной машины проходят через [GitHub proxy](/docs/ru/cloud-environments#github-proxy), который прикрепляет учётные данные на стороне сервера.

63 63

64См. [Connect from your terminal](/docs/ru/web-quickstart#connect-from-your-terminal) для пошагового руководства `/web-setup`, включая то, что хранит `/web-setup` и как его удалить.64См. [Подключение из терминала](/docs/ru/web-quickstart#connect-from-your-terminal) для пошагового руководства `/web-setup`, включая то, что хранит `/web-setup` и как его удалить.

65 65

66<Note>66<Note>

67 Организации с включённым [Zero Data Retention](/docs/ru/zero-data-retention) или с применённой [конфигурацией HIPAA](/docs/ru/hipaa-setup) не могут использовать `/web-setup` или другие функции облачных сессий.67 Организации с включённым [Zero Data Retention](/docs/ru/zero-data-retention) или с применённой [конфигурацией HIPAA](/docs/ru/hipaa-setup) не могут использовать `/web-setup` или другие функции облачных сессий.

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

417* <span id="default-allowed-domains" />**Элементы управления сетевым доступом**: в окружениях, размещённых Anthropic, сетевой доступ ограничен по умолчанию и может быть отключен. См. [Сетевой доступ](/docs/ru/cloud-environments#network-access) для уровней доступа, [доменов, разрешённых по умолчанию](/docs/ru/cloud-environments#default-allowed-domains), и трафика, который не проходит через список разрешений. В самостоятельно размещённом окружении вы ограничиваете исходящий трафик сессии на вашей собственной границе сети. При запуске с отключённым сетевым доступом Claude Code всё ещё может общаться с API Anthropic, что может позволить данным выйти из виртуальной машины.417* <span id="default-allowed-domains" />**Элементы управления сетевым доступом**: в окружениях, размещённых Anthropic, сетевой доступ ограничен по умолчанию и может быть отключен. См. [Сетевой доступ](/docs/ru/cloud-environments#network-access) для уровней доступа, [доменов, разрешённых по умолчанию](/docs/ru/cloud-environments#default-allowed-domains), и трафика, который не проходит через список разрешений. В самостоятельно размещённом окружении вы ограничиваете исходящий трафик сессии на вашей собственной границе сети. При запуске с отключённым сетевым доступом Claude Code всё ещё может общаться с API Anthropic, что может позволить данным выйти из виртуальной машины.

418* **Защита учётных данных**: в окружениях, размещённых Anthropic, учётные данные git и ключи подписи остаются вне песочницы, и прокси аутентифицирует от имени сессии с ограниченными учётными данными. В самостоятельно размещённом окружении ваше развёртывание предоставляет учётные данные git; см. [Configure git](/docs/ru/self-hosted-environments-deploy#configure-git)418* **Защита учётных данных**: в окружениях, размещённых Anthropic, учётные данные git и ключи подписи остаются вне песочницы, и прокси аутентифицирует от имени сессии с ограниченными учётными данными. В самостоятельно размещённом окружении ваше развёртывание предоставляет учётные данные git; см. [Configure git](/docs/ru/self-hosted-environments-deploy#configure-git)

419* **Сетевые секреты**: в окружениях, размещённых Anthropic, на планах Pro и Max, ключи, которые вы [добавляете в облачное окружение](/docs/ru/cloud-environments#add-api-credentials), остаются вне песочницы так же, прикреплённые к совпадающим запросам после того, как они покидают сессию. Самостоятельно размещённое окружение не имеет сетевых секретов, и планы Team и Enterprise их ещё не имеют419* **Сетевые секреты**: в окружениях, размещённых Anthropic, на планах Pro и Max, ключи, которые вы [добавляете в облачное окружение](/docs/ru/cloud-environments#add-network-secrets), остаются вне песочницы так же, прикреплённые к совпадающим запросам после того, как они покидают сессию. Самостоятельно размещённое окружение не имеет сетевых секретов, и планы Team и Enterprise их ещё не имеют

420* **Безопасный анализ**: код анализируется и изменяется в изолированной среде сессии перед созданием PR420* **Безопасный анализ**: код анализируется и изменяется в изолированной среде сессии перед созданием PR

421 421

422<h2 id="troubleshooting">422<h2 id="troubleshooting">

491 491

492Перед использованием облачных сеансов в рабочем процессе учитывайте следующие ограничения:492Перед использованием облачных сеансов в рабочем процессе учитывайте следующие ограничения:

493 493

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

495* **Ограничения по времени**: команды, которые запускает Claude, и hooks SessionStart имеют стандартные тайм-ауты, которые вы можете изменить, а скрипт настройки кэшируется только при завершении примерно за пять минут. См. [Time limits](/docs/ru/cloud-environments#time-limits)495* **Ограничения по времени**: команды, которые запускает Claude, и hooks SessionStart имеют стандартные тайм-ауты, которые вы можете изменить, а скрипт настройки кэшируется только при завершении примерно за пять минут. См. [Time limits](/docs/ru/cloud-environments#time-limits)

496* **Аутентификация репозитория**: вы можете извлечь облачный сеанс в свой терминал только при аутентификации в одной и той же учётной записи496* **Аутентификация репозитория**: вы можете извлечь облачный сеанс в свой терминал только при аутентификации в одной и той же учётной записи

497* **Ограничения платформы**: клонирование репозитория и создание запросов на слияние требуют GitHub. Экземпляры [GitHub Enterprise Server](/docs/ru/github-enterprise-server) с собственным размещением поддерживаются для планов Team и Enterprise. Вы можете отправить репозиторий GitLab, Bitbucket или другой репозиторий, не являющийся GitHub, в облачный сеанс как [локальный пакет](#send-local-repositories-without-github), установив `CCR_FORCE_BUNDLE=1`, но сеанс не сможет отправить результаты обратно на этот удалённый сервер497* **Ограничения платформы**: клонирование репозитория и создание запросов на слияние требуют GitHub. Экземпляры [GitHub Enterprise Server](/docs/ru/github-enterprise-server) с собственным размещением поддерживаются для планов Team и Enterprise. Вы можете отправить репозиторий GitLab, Bitbucket или другой репозиторий, не являющийся GitHub, в облачный сеанс как [локальный пакет](#send-local-repositories-without-github), установив `CCR_FORCE_BUNDLE=1`, но сеанс не сможет отправить результаты обратно на этот удалённый сервер

claude-platform-on-aws.md +10 −3

Details

215 1. Настройте учетные данные AWS215 1. Настройте учетные данные AWS

216</h3>216</h3>

217 217

218Claude Code поддерживает два метода аутентификации для Claude Platform on AWS. Выберите метод, который соответствует тому, как ваша команда управляет доступом.218Claude Code поддерживает два метода аутентификации для Claude Platform on AWS. Выберите метод, который соответствует тому, как ваша команда управляет доступом:

219 219

220**Вариант A: учетные данные AWS с SigV4**220* [Учётные данные AWS с SigV4](#use-aws-credentials-with-sigv4): аутентификация в качестве субъекта IAM с учётными данными из стандартной цепочки учётных данных AWS

221* [API-ключ рабочего пространства](#use-a-workspace-api-key): аутентификация с помощью долгоживущего ключа, который вы создаёте в консоли AWS

222

223<h4 id="use-aws-credentials-with-sigv4">

224 Использование учётных данных AWS с SigV4

225</h4>

221 226

222Claude Code подписывает запросы с помощью SigV4, используя стандартную цепочку учетных данных AWS: переменные окружения, общие учетные данные в `~/.aws/credentials`, роли IAM, сеансы AWS SSO и любые другие источники, которые поддерживает AWS SDK.227Claude Code подписывает запросы с помощью SigV4, используя стандартную цепочку учетных данных AWS: переменные окружения, общие учетные данные в `~/.aws/credentials`, роли IAM, сеансы AWS SSO и любые другие источники, которые поддерживает AWS SDK.

223 228

242 247

243С настроенным `awsAuthRefresh` запустите `/login`, выберите **3rd-party platform**, затем выберите **Claude Platform on AWS · refresh credentials** в разделе **Using 3rd-party platforms**. Claude Code запускает настроенную команду и повторно читает ваши учетные данные AWS без перезагрузки.248С настроенным `awsAuthRefresh` запустите `/login`, выберите **3rd-party platform**, затем выберите **Claude Platform on AWS · refresh credentials** в разделе **Using 3rd-party platforms**. Claude Code запускает настроенную команду и повторно читает ваши учетные данные AWS без перезагрузки.

244 249

245**Вариант B: ключ API рабочей области**250<h4 id="use-a-workspace-api-key">

251 Использование API-ключа рабочего пространства

252</h4>

246 253

247Ключ API рабочей области — это долгоживущий секрет, полезный, когда вы не хотите управлять федеративными учетными данными AWS. Создайте его в консоли AWS в разделе **Claude Platform on AWS → API keys** и установите его как `ANTHROPIC_AWS_API_KEY`:254Ключ API рабочей области — это долгоживущий секрет, полезный, когда вы не хотите управлять федеративными учетными данными AWS. Создайте его в консоли AWS в разделе **Claude Platform on AWS → API keys** и установите его как `ANTHROPIC_AWS_API_KEY`:

248 255

claude-projects.md +42 −42

Details

316 Предоставление проекту постоянного контекста316 Предоставление проекту постоянного контекста

317</h2>317</h2>

318 318

319Память проекта, инструкции проекта и репозитории, файлы и среда проекта переносят контекст через потоки. Вы устанавливаете каждый один раз.319Память проекта, инструкции проекта, а также репозитории, файлы и среда проекта переносят контекст между потоками. Каждый из них вы настраиваете один раз.

320 320

322| :- | :- | :- |322| :- | :- | :- |

323| Память проекта | Заметки, которые Claude хранит о проекте, такие как требования, решения и ошибки, хранящиеся как файлы. Каждый облачный поток читает файл индекса `MEMORY.md` при запуске и открывает другие файлы, когда они ему нужны | Попросите Claude в разговоре проекта или любом облачном потоке запомнить требование, решение или ошибку, или забыть одно. Читайте, редактируйте и удаляйте файлы в **Project settings > Memory** |323| Память проекта | Заметки, которые Claude ведёт о проекте, такие как требования, решения и подводные камни, хранящиеся в виде файлов. Каждый облачный поток читает индексный файл `MEMORY.md` при запуске и открывает другие файлы, когда они ему нужны | Попросите Claude в диалоге проекта или в любом облачном потоке запомнить требование, решение или подводный камень либо забыть что-то из них. Читайте, редактируйте и удаляйте файлы в **Project settings > Memory** |

324| Инструкции проекта | Текст, отправляемый каждому новому потоку и Claude в разговоре проекта, до 16 000 символов. [Напишите инструкции проекта](#write-project-instructions) охватывает, что в него поместить | **Project settings > Memory > Project instructions**, или попросите Claude изменить инструкции |324| Инструкции проекта | Текст, отправляемый каждому новому потоку и Claude в диалоге проекта, до 16 000 символов. В разделе [Напишите инструкции проекта](#write-project-instructions) описано, что в него поместить | **Project settings > Memory > Project instructions**, или попросите Claude изменить инструкции |

325| Репозитории, файлы и среда | Репозитории, которые клонирует каждый облачный поток, папки и файлы, которые он может читать в `/mnt/project-files`, и облачная среда, в которой он работает | Репозитории и среда в **Project settings > Environment**, или попросите Claude в разговоре добавить репозиторий в проект. [Файлы и папки](#add-files-and-folders) из **Add** на вкладке **Library** в **Overview** |325| Репозитории, файлы и среда | Репозитории, которые клонирует каждый облачный поток, папки и файлы, которые он может читать в `/mnt/project-files`, и облачная среда, в которой он работает | Репозитории и среда в **Project settings > Environment**, или попросите Claude в диалоге добавить репозиторий в проект. [Файлы и папки](#add-files-and-folders) через **Add** на вкладке **Library** в **Overview** |

326 326

327**Project settings > Memory** перечисляет эти файлы в разделе **Auto memory**, потому что Claude пишет их сам, пока работает в проекте. Они отделены от [auto memory](/docs/ru/memory), которую Claude Code хранит на вашей машине, даже несмотря на то, что оба используют индекс `MEMORY.md`. Память проекта также отделена от файлов `CLAUDE.md` в репозиториях проекта. Каждый облачный поток все еще читает эти файлы `CLAUDE.md` из своего клона при запуске, поэтому поместите инструкции о репозитории в его `CLAUDE.md` и заметки о проекте в память проекта.327**Project settings > Memory** перечисляет эти файлы в разделе **Auto memory**, потому что Claude пишет их сам, пока работает в проекте. Они отделены от [автоматической памяти](/docs/ru/memory), которую Claude Code хранит на вашей машине, хотя обе используют индекс `MEMORY.md`. Память проекта также отделена от файлов `CLAUDE.md` в репозиториях проекта. Каждый облачный поток по-прежнему читает эти файлы `CLAUDE.md` из своего клона при запуске, поэтому помещайте инструкции о репозитории в его `CLAUDE.md`, а заметки о проекте — в память проекта.

328 328

329<h3 id="write-project-instructions">329<h3 id="write-project-instructions">

330 Напишите инструкции проекта330 Напишите инструкции проекта

331</h3>331</h3>

332 332

333Инструкции проекта — это краткое описание, с которого начинает каждый новый поток. Нажмите значок шестеренки в заголовке проекта, чтобы открыть **Project settings**, затем перейдите в **Memory > Project instructions**. Полезное краткое описание охватывает:333Инструкции проекта — это краткое описание, с которого начинает каждый новый поток. Нажмите значок шестерёнки в заголовке проекта, чтобы открыть **Project settings**, затем перейдите в **Memory > Project instructions**. Полезное краткое описание охватывает:

334 334

335* Для чего предназначен проект335* Для чего предназначен проект

336* Где происходит работа: какие репозитории, с какой ветки начинать, как называть pull requests336* Где происходит работа: какие репозитории, от какой ветки начинать, как называть pull requests

337* Как поток проверяет свою работу перед тем, как назвать это выполненным337* Как поток проверяет свою работу, прежде чем считать её выполненной

338* Что делать, когда что-то, что ему нужно, отсутствует338* Что делать, когда чего-то нужного не хватает

339* Что требует вашего одобрения в первую очередь339* Что сначала требует вашего одобрения

340 340

341Например:341Например:

342 342

343```text theme={null}343```text theme={null}

344Этот проект держит p95 задержку для API платежей ниже 200 мс: профилирование, исправления запросов и кэширования, и обновления зависимостей, которые с ними идут, в репозитории payments-api.344Этот проект удерживает задержку p95 для API платежей ниже 200 мс: профилирование, исправления запросов и кэширования, а также сопутствующие обновления зависимостей, в репозитории payments-api.

345 345

346- Ветвитесь от main и откройте один черновик pull request для каждого потока.346- Создавайте ветку от main и открывайте один черновой pull request на каждый поток.

347- Перед тем, как назвать работу выполненной, запустите `make test` и `make lint` и вставьте строки сводки в ваше финальное сообщение.347- Прежде чем считать работу выполненной, запустите `make test` и `make lint` и вставьте итоговые строки в ваше финальное сообщение.

348- Если вы не можете достичь чего-то, что вам нужно, например репозитория, секрета, API или connector, скажите в вашем первом сообщении, что именно отсутствует, и остановитесь. Не подменяйте, не имитируйте и не угадывайте.348- Если вы не можете получить доступ к чему-то нужному, например к репозиторию, секрету, API или коннектору, в первом же сообщении точно укажите, чего не хватает, и остановитесь. Не подменяйте, не имитируйте и не угадывайте.

349- Не объединяйте, не выполняйте force-push и не изменяйте конфигурацию CI без моего запроса в потоке.349- Не выполняйте слияние, force-push и не изменяйте конфигурацию CI, не спросив меня в потоке.

350```350```

351 351

352Правила об одном репозитории, такие как его команды сборки, принадлежат `CLAUDE.md` этого репозитория, который каждый облачный поток читает, когда репозиторий является частью проекта. Когда работа идет, когда вы исправляете поток, также скажите Claude запомнить исправление: оно идет в [память проекта](#give-a-project-standing-context) и более поздние облачные потоки начинают с ним.352Правила, касающиеся одного репозитория, например его команды сборки, следует размещать в `CLAUDE.md` этого репозитория, который каждый облачный поток читает, когда репозиторий входит в проект. Когда работа уже идёт и вы исправляете поток, также попросите Claude запомнить исправление: оно попадёт в [память проекта](#give-a-project-standing-context), и последующие облачные потоки будут начинать с ним.

353 353

354<h3 id="decide-which-repositories-to-add">354<h3 id="decide-which-repositories-to-add">

355 Решение, какие репозитории добавить355 Решение, какие репозитории добавить

356</h3>356</h3>

357 357

358Репозитории, которые вы добавляете в проект, поступают со всем в них, их код, `CLAUDE.md` и skills, в каждом облачном потоке. Репозитории, которые вы не добавляете, все еще в пределах досягаемости: облачный поток может добавить один к себе, когда его задача это требует. Большинство проектов используют оба:358Репозитории, которые вы добавляете в проект, попадают в каждый облачный поток со всем содержимым: кодом, `CLAUDE.md` и скиллами. Репозитории, которые вы не добавляете, всё равно остаются доступными: облачный поток может добавить такой репозиторий себе, когда это требуется для его задачи. Большинство проектов используют оба варианта:

359 359

360* **Добавьте его в проект**, в диалоге **New project**, в **Project settings > Environment**, или попросив Claude в разговоре добавить его в проект. Каждый облачный поток с этого момента клонирует его и начинает с его `CLAUDE.md` и skills загруженными, независимо от того, касается ли задача его. Переход от одного репозитория к нескольким также изменяет то, что потоки берут из `.claude/settings.json` каждого репозитория; см. [Что потоки берут из ваших репозиториев](#what-threads-pick-up-from-your-repositories).360* **Добавьте его в проект** в диалоговом окне **New project**, в **Project settings > Environment** или попросив Claude в диалоге добавить его в проект. Каждый облачный поток с этого момента клонирует его и начинает с загруженными `CLAUDE.md` и скиллами этого репозитория, независимо от того, затрагивает ли его задача. Переход от одного репозитория к нескольким также меняет то, что потоки берут из `.claude/settings.json` каждого репозитория; см. [Что потоки берут из ваших репозиториев](#what-threads-pick-up-from-your-repositories).

361* **Не добавляйте его в проект и позвольте потокам добавить его, когда это необходимо.** Облачный поток, чья задача требует репозитория, который проект не имеет, может добавить его к себе, и заметка в потоке говорит, что он был добавлен только в этот поток. Клон происходит в середине задачи, поэтому `CLAUDE.md` и skills этого репозитория не были там, когда поток начался. Следующий поток начинает без него. Репозиторий, добавленный таким образом, требует те же [предварительные условия](#check-the-prerequisites), что и репозиторий проекта: Claude GitHub App установлено на нем и доступ на push из вашего аккаунта GitHub.361* **Не добавляйте его и позвольте потокам добавлять его при необходимости.** Облачный поток, задаче которого нужен репозиторий, отсутствующий в проекте, может добавить его себе, и заметка в потоке сообщает, что он добавлен только в этот поток. Клонирование происходит в середине задачи, поэтому `CLAUDE.md` и скиллов этого репозитория не было, когда поток запускался. Следующий поток начинает без него. Репозиторию, добавленному таким образом, нужны те же [предварительные требования](#check-the-prerequisites), что и репозиторию проекта: установленное на нём Claude GitHub App и доступ на push из вашего аккаунта GitHub.

362 362

363Проект вообще не требует репозитория. Его облачные потоки все еще могут исследовать, писать документы и писать и запускать код в собственной песочнице, и они доставляют файлы на вкладку **Library**. Любой из его облачных потоков все еще может добавить репозиторий к себе, когда задача это требует.363Проекту вообще не обязателен репозиторий. Его облачные потоки всё равно могут проводить исследования, писать документы, а также писать и запускать код в собственной песочнице, и они доставляют файлы на вкладку **Library**. Любой из его облачных потоков по-прежнему может добавить себе репозиторий, когда этого требует задача.

364 364

365Когда проект имеет репозитории, Claude может добавлять только репозитории от владельца GitHub, который проект уже использует, независимо от того, добавляет ли он один в проект или поток добавляет один к себе. Чтобы привести репозиторий от другого владельца, добавьте его в проект самостоятельно в **Project settings > Environment**.365Когда у проекта есть репозитории, Claude может добавлять только репозитории того владельца GitHub, которого проект уже использует, — добавляет ли он репозиторий в проект или поток добавляет его себе. Чтобы подключить репозиторий другого владельца, добавьте его в проект самостоятельно в **Project settings > Environment**.

366 366

367Для проекта, охватывающего много репозиториев, например одну функцию с кодом сервера, веб, мобильного и рабочего стола, добавьте один или два репозитория, которые почти каждая задача касается, и назовите остальные в [инструкциях проекта](#write-project-instructions), чтобы Claude знал, где находится остальной код. Облачные потоки затем начинают маленькими и вытягивают другие репозитории только для задач, которые их требуют.367Для проекта, охватывающего много репозиториев, например одну функцию с серверным, веб-, мобильным и десктопным кодом, добавьте один или два репозитория, которые затрагивает почти каждая задача, и назовите остальные в [инструкциях проекта](#write-project-instructions), чтобы Claude знал, где находится остальной код. Тогда облачные потоки начинают с малого и подтягивают другие репозитории только для тех задач, которым они нужны.

368 368

369<h3 id="add-files-and-folders">369<h3 id="add-files-and-folders">

370 Добавьте файлы и папки370 Добавьте файлы и папки

371</h3>371</h3>

372 372

373Добавьте файлы и папки, которые вы хотите, чтобы потоки читали в поле **Context** диалога **New project**, или впоследствии с помощью **Add** на вкладке **Library** в **Overview**. Эти ограничения применяются к тому, что вы добавляете:373Добавьте файлы и папки, которые должны читать потоки, в поле **Context** диалогового окна **New project** или позже с помощью **Add** на вкладке **Library** в **Overview**. К добавляемому применяются следующие ограничения:

374 374

375* **Library tab**: до 100 файлов и 2 ГБ в одном выборе, с одним файлом до 480 МБ.375* **Вкладка Library**: до 100 файлов и 2 ГБ за один выбор, при этом один файл — до 480 МБ.

376* **New project dialog**: файлы размером более 30 МБ пропускаются, поэтому добавляйте большие файлы с вкладки **Library** после создания проекта.376* **Диалоговое окно New project**: файлы размером более 30 МБ пропускаются, поэтому добавляйте более крупные файлы с вкладки **Library** после создания проекта.

377* **Folders**: когда вы добавляете папку из любого места, проект получает копию его первых 100 файлов до 200 МБ, без каких-либо файлов размером более 30 МБ, скрытых файлов или `node_modules`. Проект содержит до 10 папок и папок Google Drive в сочетании, и отдельные файлы не учитываются в этом ограничении.377* **Папки**: когда вы добавляете папку из любого из этих мест, проект получает копию её первых 100 файлов объёмом до 200 МБ, без файлов размером более 30 МБ, скрытых файлов и `node_modules`. Проект может содержать до 10 папок и папок Google Drive в сумме, а отдельные файлы в это ограничение не засчитываются.

378* **Changes after upload**: загрузки — это копии, поэтому изменение, которое вы делаете на вашем компьютере впоследствии, не достигает проекта, пока вы не загрузите файл снова и не выберете **Replace** при вопросе об существующем имени.378* **Изменения после загрузки**: загрузки являются копиями, поэтому изменение, которое вы позже вносите на своём компьютере, не попадает в проект, пока вы снова не загрузите файл и не выберете **Replace** при запросе о существующем имени.

379 379

380<h3 id="what-threads-pick-up-from-your-repositories">380<h3 id="what-threads-pick-up-from-your-repositories">

381 Что потоки берут из ваших репозиториев381 Что потоки берут из ваших репозиториев

382</h3>382</h3>

383 383

384Каждый облачный поток клонирует каждый репозиторий в проекте и загружает `CLAUDE.md` и skills из всех них. Правила разрешений, hooks и `env` поступают только из `.claude/settings.json` в директории, где поток начинается: внутри репозитория, когда проект имеет один, и выше клонов, когда он имеет несколько, где файл ни одного репозитория не читается для них.384Каждый облачный поток клонирует каждый репозиторий проекта и загружает `CLAUDE.md` и скиллы из всех них. Правила разрешений, хуки и `env` берутся только из `.claude/settings.json` в директории, в которой запускается поток: внутри репозитория, если он в проекте один, и над клонами, если их несколько, — в этом случае файлы репозиториев для них не читаются.

385 385

387| :- | :- | :- |387| :- | :- | :- |

390| Plugins, включенные в `.claude/settings.json` | Не загружаются. Добавьте plugin в **Project settings > Plugins** вместо этого | Не загружаются. Добавьте plugin в **Project settings > Plugins** вместо этого |390| Плагины, включённые в `.claude/settings.json` | Не загружаются. Вместо этого добавьте плагин в **Project settings > Plugins** | Не загружаются. Вместо этого добавьте плагин в **Project settings > Plugins** |

391| Правила разрешений, hooks и `env`, определенные в `.claude/settings.json` | Применяются к потоку, кроме ключей `env`, которые [ни один облачный сеанс не соблюдает](/docs/ru/cloud-environments#what-carries-over-from-your-setup) | Не применяются |391| Правила разрешений, хуки и `env`, определённые в `.claude/settings.json` | Применяются к потоку, кроме ключей `env`, которые [не учитывает ни одна облачная сессия](/docs/ru/cloud-environments#what-carries-over-from-your-setup) | Не применяются |

392 392

393В проекте с несколькими репозиториями каждый клон прикреплен к потоку как [дополнительная директория](/docs/ru/memory#load-from-additional-directories) с включенной загрузкой `CLAUDE.md`, что является причиной того, что `CLAUDE.md` и skills каждого репозитория загружаются при запуске, даже несмотря на то, что поток начинается выше них. В таком проекте поместите постоянные правила в инструкции проекта и дайте потокам переменные окружения через [облачную среду](#choose-an-environment-for-threads).393В проекте с несколькими репозиториями каждый клон подключается к потоку как [дополнительная директория](/docs/ru/memory#load-from-additional-directories) с включённой загрузкой `CLAUDE.md`, поэтому `CLAUDE.md` и скиллы каждого репозитория загружаются при запуске, хотя поток запускается над ними. В таком проекте помещайте постоянные правила в инструкции проекта, а переменные окружения передавайте потокам через [облачную среду](#choose-an-environment-for-threads).

394 394

395<h3 id="choose-an-environment-for-threads">395<h3 id="choose-an-environment-for-threads">

396 Выбор среды для потоков396 Выбор среды для потоков

397</h3>397</h3>

398 398

399Каждый новый облачный поток начинается в [облачной среде](/docs/ru/cloud-environments) проекта. Среда определяет, к каким доменам могут обращаться потоки, какие переменные окружения у них есть, какие сетевые секреты добавляются в их запросы и что устанавливает скрипт настройки до запуска Claude. Облачные потоки используют среду по умолчанию, размещенную Anthropic, пока вы не выберете другую в **Project settings > Environment**.399Каждый новый облачный поток начинается в [облачной среде](/docs/ru/cloud-environments) проекта. Среда определяет, к каким доменам могут обращаться потоки, какие переменные окружения у них есть, какие сетевые секреты добавляются в их запросы и что устанавливает скрипт настройки до запуска Claude. Облачные потоки используют среду по умолчанию, размещённую Anthropic, пока вы не выберете другую в **Project settings > Environment**.

400 400

401Если облачным потокам нужно обращаться к внутреннему API или приватному реестру пакетов либо нужен токен, который обычно хранится на вашей машине, измените среду, а не проект: см. [Сетевой доступ](/docs/ru/cloud-environments#network-access), [Добавление сетевых секретов](/docs/ru/cloud-environments#add-api-credentials) и [Скрипты настройки](/docs/ru/cloud-environments#setup-scripts).401Если облачным потокам нужно обращаться к внутреннему API или приватному реестру пакетов либо нужен токен, который обычно хранится на вашей машине, измените среду, а не проект: см. [Сетевой доступ](/docs/ru/cloud-environments#network-access), [Добавление сетевых секретов](/docs/ru/cloud-environments#add-network-secrets) и [Скрипты настройки](/docs/ru/cloud-environments#setup-scripts).

402 402

403<h3 id="get-skills-plugins-connectors-and-tools-into-threads">403<h3 id="get-skills-plugins-connectors-and-tools-into-threads">

404 Получить skills, plugins, connectors и инструменты в потоки404 Передача скиллов, плагинов, коннекторов и инструментов в потоки

405</h3>405</h3>

406 406

407Облачные потоки не имеют skills, MCP servers, plugins и инструментов, установленных только на вашей машине. Поток, который Claude запускает на вашей машине через [Remote Control](/docs/ru/remote-control), использует то, что установлено там. Чтобы сделать каждый из них доступным для облачных потоков:407У облачных потоков нет скиллов, MCP-серверов, плагинов и инструментов, установленных только на вашей машине. Поток, который Claude запускает на вашей машине через [Remote Control](/docs/ru/remote-control), использует то, что установлено там. Чтобы сделать каждый из них доступным для облачных потоков:

408 408

409* Skills, subagents и команды: зафиксируйте их в репозитории, который вы добавили в проект, например skill в `.claude/skills/<skill-name>/SKILL.md`. Каждый облачный поток клонирует каждый репозиторий в проекте и загружает `.claude/skills/`, `.claude/agents/` и `.claude/commands/` из каждого из них, поэтому skill, зафиксированный в одном репозитории, доступен в каждом облачном потоке. Облачные потоки также загружают skills, которые вы включаете для вашего аккаунта claude.ai.409* Скиллы, субагенты и команды: добавьте их коммитом в репозиторий, который вы добавили в проект, например скилл в `.claude/skills/<skill-name>/SKILL.md`. Каждый облачный поток клонирует каждый репозиторий проекта и загружает `.claude/skills/`, `.claude/agents/` и `.claude/commands/` из каждого из них, поэтому скилл, добавленный коммитом в один репозиторий, доступен в каждом облачном потоке. Облачные потоки также загружают скиллы, которые вы включили для своего аккаунта claude.ai.

410* Plugins: добавьте их в **Project settings > Plugins**; они загружаются в каждый новый облачный поток. Plugins, которые репозиторий объявляет в его `.claude/settings.json`, [не загружаются в облачные потоки](/docs/ru/cloud-environments#what-carries-over-from-your-setup).410* Плагины: добавьте их в **Project settings > Plugins**; они загружаются в каждый новый облачный поток. Плагины, которые репозиторий объявляет в своём `.claude/settings.json`, [не загружаются в облачных потоках](/docs/ru/cloud-environments#what-carries-over-from-your-setup).

411* MCP servers: облачные потоки получают свои MCP инструменты из connectors на вашем аккаунте claude.ai, которые являются MCP servers, которые вы подключаете один раз в [claude.ai/customize/connectors](https://claude.ai/customize/connectors) или через ссылку **Manage connectors** в **Project settings > Environment**. Каждый облачный поток может использовать все их без настройки для каждого проекта. Разговор проекта сам по себе не имеет connectors, поэтому отправляйте работу, которая требует один, как задачу для облачного потока. В проекте с одним репозиторием облачные потоки также загружают MCP servers из [`.mcp.json`](/docs/ru/cloud-environments#what-carries-over-from-your-setup) этого репозитория. [Как connectors достигают Claude Code](/docs/ru/mcp#how-connectors-reach-claude-code) перечисляет правила для облачных сеансов и параметры, которые отключают connectors.411* MCP-серверы: облачные потоки получают свои инструменты MCP из коннекторов вашего аккаунта claude.ai — это MCP-серверы, которые вы один раз подключаете на [claude.ai/customize/connectors](https://claude.ai/customize/connectors) или через ссылку **Manage connectors** в **Project settings > Environment**. Каждый облачный поток может использовать их все без настройки для каждого проекта. У самого диалога проекта нет коннекторов, поэтому работу, требующую коннектора, отправляйте как задачу для облачного потока. В проекте с одним репозиторием облачные потоки также загружают MCP-серверы из [`.mcp.json`](/docs/ru/cloud-environments#what-carries-over-from-your-setup) этого репозитория. В разделе [Как коннекторы попадают в Claude Code](/docs/ru/mcp#how-connectors-reach-claude-code) перечислены правила для облачных сессий и настройки, отключающие коннекторы.

412* Инструменты командной строки и пакеты: установите их в [скрипт настройки](/docs/ru/cloud-environments#setup-scripts) среды.412* Инструменты командной строки и пакеты: установите их в [скрипте настройки](/docs/ru/cloud-environments#setup-scripts) среды.

413 413

414Чтобы увидеть, какие connectors имеет работающий облачный поток в claude.ai/code, откройте поток и выберите **Connectors** из меню **+** рядом с его полем сообщения. Отключение connector там удаляет его из этого потока и сохраняет это как ваше значение по умолчанию для аккаунта, поэтому новые облачные потоки и чаты claude.ai начинают без него, пока вы его не включите снова. Облачный поток подхватывает connector, который вы добавляете или переподключаете после следующего сообщения, которое вы ему отправляете.414Чтобы увидеть, какие коннекторы есть у работающего облачного потока в claude.ai/code, откройте поток и выберите **Connectors** в меню **+** рядом с его полем ввода сообщения. Отключение коннектора там удаляет его из этого потока и сохраняет это как значение по умолчанию для вашего аккаунта, поэтому новые потоки и чаты claude.ai начинаются без него, пока вы снова его не включите. Облачный поток подхватывает коннектор, который вы добавили или переподключили, после следующего отправленного ему сообщения.

415 415

416<h2 id="project-settings-reference">416<h2 id="project-settings-reference">

417 Справочник параметров проекта417 Справочник параметров проекта

cloud-environments.md +11 −9

Details

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

11</Note>11</Note>

12 12

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

14 14

15Одни и те же среды применяются везде, где вы запускаете облачный сеанс: [приложение Desktop](/docs/ru/desktop), [мобильное приложение Claude](/docs/ru/mobile), ваш браузер на [claude.ai/code](https://claude.ai/code), терминал с [`claude --cloud`](/docs/ru/claude-code-on-the-web#from-terminal-to-cloud), [процедуры](/docs/ru/routines) и [Claude Tag](https://claude.com/docs/claude-tag/overview). Каждая из этих поверхностей также может маршрутизировать в [самостоятельно размещённую среду](/docs/ru/self-hosted-environments). [Доступность и ограничения](/docs/ru/self-hosted-environments#availability-and-limitations) охватывает то, что Claude ещё не может использовать, когда сеанс Claude Tag работает в одной.15Одни и те же среды применяются везде, где вы запускаете облачный сеанс: [приложение Desktop](/docs/ru/desktop), [мобильное приложение Claude](/docs/ru/mobile), ваш браузер на [claude.ai/code](https://claude.ai/code), терминал с [`claude --cloud`](/docs/ru/claude-code-on-the-web#from-terminal-to-cloud), [процедуры](/docs/ru/routines) и [Claude Tag](https://claude.com/docs/claude-tag/overview). Каждая из этих поверхностей также может маршрутизировать в [самостоятельно размещённую среду](/docs/ru/self-hosted-environments). [Доступность и ограничения](/docs/ru/self-hosted-environments#availability-and-limitations) охватывает то, что Claude ещё не может использовать, когда сеанс Claude Tag работает в одной.

16 16

58 <Step title="Добавьте или отредактируйте среду">58 <Step title="Добавьте или отредактируйте среду">

59 Выберите **Cloud** для отображения ваших сред. Затем выберите **Add cloud environment** или наведите на существующую среду и выберите значок параметров, который появляется справа.59 Выберите **Cloud** для отображения ваших сред. Затем выберите **Add cloud environment** или наведите на существующую среду и выберите значок параметров, который появляется справа.

60 60

61 Диалог включает имя, уровень сетевого доступа, переменные окружения и скрипт установки. Когда вы редактируете существующую облачную среду на плане Pro или Max, диалог также включает [сетевые секреты](#add-api-credentials).61 Диалог включает имя, уровень сетевого доступа, переменные окружения и скрипт установки. Когда вы редактируете существующую облачную среду на плане Pro или Max, диалог также включает [сетевые секреты](#add-network-secrets).

62 62

63 <Frame>63 <Frame>

64 <img src="https://mintcdn.com/claude-code/ZFId6l95856c5LSw/images/cloud-environment-dialog.png?fit=max&auto=format&n=ZFId6l95856c5LSw&q=85&s=30d4478b31d1f879f7ee287ddab32505" alt="Диалог New cloud environment. Поле Name с заполнителем Default, селектор Network access установлен на Trusted со ссылками на политику сети и уровни доступа, поле Environment variables, показывающее текст-заполнитель в формате .env с примечанием, что значения видны всем, кто использует среду, поле Setup script, описанное как скрипт Bash, который запускается при запуске нового сеанса перед запуском Claude Code, и кнопки Cancel и Create environment." width="874" height="1372" data-path="images/cloud-environment-dialog.png" />64 <img src="https://mintcdn.com/claude-code/ZFId6l95856c5LSw/images/cloud-environment-dialog.png?fit=max&auto=format&n=ZFId6l95856c5LSw&q=85&s=30d4478b31d1f879f7ee287ddab32505" alt="Диалог New cloud environment. Поле Name с заполнителем Default, селектор Network access установлен на Trusted со ссылками на политику сети и уровни доступа, поле Environment variables, показывающее текст-заполнитель в формате .env с примечанием, что значения видны всем, кто использует среду, поле Setup script, описанное как скрипт Bash, который запускается при запуске нового сеанса перед запуском Claude Code, и кнопки Cancel и Create environment." width="874" height="1372" data-path="images/cloud-environment-dialog.png" />

91 91

92Облачный сеанс также устанавливает некоторые переменные сам, когда запускается. Для [`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`](/docs/ru/claude-code-on-the-web#manage-context) значение, которое устанавливает сеанс, переопределяет то, которое вы добавляете здесь, поэтому добавление этого ключа здесь не имеет эффекта.92Облачный сеанс также устанавливает некоторые переменные сам, когда запускается. Для [`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`](/docs/ru/claude-code-on-the-web#manage-context) значение, которое устанавливает сеанс, переопределяет то, которое вы добавляете здесь, поэтому добавление этого ключа здесь не имеет эффекта.

93 93

94Любой, кто использует среду, может читать значения. На планах Pro и Max вместо этого используйте [сетевой секрет](#add-api-credentials) для ключа, который прокси агента может прикрепить к запросу. [Запросы, которые никогда не получают секрет](#requests-that-never-get-the-credential), перечислены там.94Любой, кто использует среду, может читать значения. На планах Pro и Max вместо этого используйте [сетевой секрет](#add-network-secrets) для ключа, который прокси агента может прикрепить к запросу. [Запросы, которые никогда не получают секрет](#requests-that-never-get-the-credential), перечислены там.

95 95

~~96<h3 id="add-api-credentials">~~96<span id="add-api-credentials" />

98<h3 id="add-network-secrets">

97 Добавление сетевых секретов99 Добавление сетевых секретов

98</h3>100</h3>

99 101

197 199

198Владельцы выбирают [среду по умолчанию](#the-default-environment) организации отдельно на [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code).200Владельцы выбирают [среду по умолчанию](#the-default-environment) организации отдельно на [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code).

199 201

200Сессии каждого участника в общей среде считывают её переменные, поэтому не включайте в них секреты. [Сетевые секреты](#add-api-credentials), которые дают сессиям ключ, недоступный им для чтения, пока недоступны на планах Team и Enterprise.202Сессии каждого участника в общей среде считывают её переменные, поэтому не включайте в них секреты. [Сетевые секреты](#add-network-secrets), которые дают сессиям ключ, недоступный им для чтения, пока недоступны на планах Team и Enterprise.

201 203

202<h3 id="set-the-environment-a-claude-tag-channel-uses">204<h3 id="set-the-environment-a-claude-tag-channel-uses">

203 Установка среды, которую использует канал Claude Tag205 Установка среды, которую использует канал Claude Tag

239 241

240* GitHub, через его [отдельный прокси](#github-proxy)242* GitHub, через его [отдельный прокси](#github-proxy)

241* [Соединители MCP](#network-access), которые вы включаете, трафик которых проходит через серверы Anthropic243* [Соединители MCP](#network-access), которые вы включаете, трафик которых проходит через серверы Anthropic

242* Хосты, которые вы указали в [сетевых секретах](#add-api-credentials) среды, кроме [хостов, которые никогда не получают секрет](#requests-that-never-get-the-credential)244* Хосты, которые вы указали в [сетевых секретах](#add-network-secrets) среды, кроме [хостов, которые никогда не получают секрет](#requests-that-never-get-the-credential)

243* API Anthropic, для собственных запросов Claude Code, даже при **None**, как отмечено в разделе [Безопасность и изоляция](/docs/ru/claude-code-on-the-web#security-and-isolation)245* API Anthropic, для собственных запросов Claude Code, даже при **None**, как отмечено в разделе [Безопасность и изоляция](/docs/ru/claude-code-on-the-web#security-and-isolation)

244 246

245<h3 id="allow-specific-domains">247<h3 id="allow-specific-domains">

254registry.example.com256registry.example.com

255```257```

256 258

257Теперь сессии в этой среде могут обращаться к `api.example.com`, любому поддомену `internal.example.com` и `registry.example.com` и ни к каким другим доменам через сеть сессии. [Трафик GitHub](#github-proxy), [трафик коннекторов MCP](#network-access) и запросы к хостам [сетевых секретов](#add-api-credentials) среды, кроме [хостов, которые никогда не получают секрет](#requests-that-never-get-the-credential), не проходят через этот список разрешённых доменов. Ведущий `*.` соответствует любому поддомену. Чтобы также сохранить [домены Trusted](#default-allowed-domains), установите флажок **Also include default list of common package managers**; оставьте его снятым, чтобы разрешить только то, что вы указали.259Теперь сессии в этой среде могут обращаться к `api.example.com`, любому поддомену `internal.example.com` и `registry.example.com` и ни к каким другим доменам через сеть сессии. [Трафик GitHub](#github-proxy), [трафик коннекторов MCP](#network-access) и запросы к хостам [сетевых секретов](#add-network-secrets) среды, кроме [хостов, которые никогда не получают секрет](#requests-that-never-get-the-credential), не проходят через этот список разрешённых доменов. Ведущий `*.` соответствует любому поддомену. Чтобы также сохранить [домены Trusted](#default-allowed-domains), установите флажок **Also include default list of common package managers**; оставьте его снятым, чтобы разрешить только то, что вы указали.

258 260

259Если ваша организация использует [артефакты](/docs/ru/artifacts#availability), вам не нужно добавлять `*.frame.claudeusercontent.com` в список, чтобы сеансы могли их читать. Когда список исключает этот хост, Claude Code читает содержимое артефакта через соединение сеанса с Anthropic. Сохраняйте хост в списке разрешённых в двух ситуациях:261Если ваша организация использует [артефакты](/docs/ru/artifacts#availability), вам не нужно добавлять `*.frame.claudeusercontent.com` в список, чтобы сеансы могли их читать. Когда список исключает этот хост, Claude Code читает содержимое артефакта через соединение сеанса с Anthropic. Сохраняйте хост в списке разрешённых в двух ситуациях:

260 262

316| Плагины, включённые только в ваших пользовательских настройках | Нет | Пользовательский `enabledPlugins` находится в `~/.claude/settings.json` на вашей машине |318| Плагины, включённые только в ваших пользовательских настройках | Нет | Пользовательский `enabledPlugins` находится в `~/.claude/settings.json` на вашей машине |

317| MCP-серверы, которые вы добавили с помощью `claude mcp add` в области действия по умолчанию local или в области действия user | Нет | Они записываются в `~/.claude.json` на вашей машине, а не в репозиторий. Добавьте сервер с помощью `claude mcp add --scope project`, который записывает [`.mcp.json`](/docs/ru/mcp#project-scope) репозитория, и закоммитьте этот файл. Сессия с одним репозиторием загружает его |319| MCP-серверы, которые вы добавили с помощью `claude mcp add` в области действия по умолчанию local или в области действия user | Нет | Они записываются в `~/.claude.json` на вашей машине, а не в репозиторий. Добавьте сервер с помощью `claude mcp add --scope project`, который записывает [`.mcp.json`](/docs/ru/mcp#project-scope) репозитория, и закоммитьте этот файл. Сессия с одним репозиторием загружает его |

318| Транспортные переменные в блоке `env` файла `.claude/settings.json` вашего репозитория, такие как `NODE_EXTRA_CA_CERTS` и [переменные клиентского сертификата mTLS](/docs/ru/network-config#mtls-authentication) | Нет | Среда хостинга управляет API-соединением сессии, поэтому Claude Code игнорирует эти ключи и отмечает каждый проигнорированный ключ в отладочном логе сессии |320| Транспортные переменные в блоке `env` файла `.claude/settings.json` вашего репозитория, такие как `NODE_EXTRA_CA_CERTS` и [переменные клиентского сертификата mTLS](/docs/ru/network-config#mtls-authentication) | Нет | Среда хостинга управляет API-соединением сессии, поэтому Claude Code игнорирует эти ключи и отмечает каждый проигнорированный ключ в отладочном логе сессии |

319| API-ключи и токены для сервисов, которые вызывает Claude | На планах Pro и Max, как [сетевые секреты](#add-api-credentials) | Вы добавляете ключ один раз в среду, и прокси агента прикрепляет его к запросам к перечисленным вами хостам. Ключ, который прокси агента [не может прикрепить](#requests-that-never-get-the-credential), или любой ключ на плане Team или Enterprise остаётся в переменной окружения |321| API-ключи и токены для сервисов, которые вызывает Claude | На планах Pro и Max, как [сетевые секреты](#add-network-secrets) | Вы добавляете ключ один раз в среду, и прокси агента прикрепляет его к запросам к перечисленным вами хостам. Ключ, который прокси агента [не может прикрепить](#requests-that-never-get-the-credential), или любой ключ на плане Team или Enterprise остаётся в переменной окружения |

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

321 323

322Чтобы сделать вашу собственную конфигурацию доступной в облачных сессиях, закоммитьте её в репозиторий.324Чтобы сделать вашу собственную конфигурацию доступной в облачных сессиях, закоммитьте её в репозиторий.

323 325

324Любой, кто использует среду, может читать её переменные окружения и скрипт настройки. Об этом говорит примечание в диалоге под **Environment variables**, которое также предупреждает не размещать там секреты. На планах Pro и Max вместо этого храните ключ, который прокси агента может прикрепить, как [сетевой секрет](#add-api-credentials).326Любой, кто использует среду, может читать её переменные окружения и скрипт настройки. Об этом говорит примечание в диалоге под **Environment variables**, которое также предупреждает не размещать там секреты. На планах Pro и Max вместо этого храните ключ, который прокси агента может прикрепить, как [сетевой секрет](#add-network-secrets).

325 327

326<h4 id="add-personal-preferences-without-committing-to-the-repo">328<h4 id="add-personal-preferences-without-committing-to-the-repo">

327 Добавление личных предпочтений без коммита в репозиторий329 Добавление личных предпочтений без коммита в репозиторий

commands.md +1 −1

Details

87| `/design-sync [hint]` | **[Skill](/docs/ru/skills#bundled-skills).** Преобразовать систему дизайна React вашего репо и загрузить её в [Claude Design](https://claude.ai/design), чтобы дизайны, которые она производит, использовали ваши реальные компоненты. Опционально назовите систему дизайна, например `/design-sync Acme DS`. Первоначальная синхронизация проверяет каждый компонент и может занять несколько часов на большом репо. Доступно на Anthropic API. Ей нужен claude.ai, который CLI не контактирует на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или Claude Platform на AWS, или через [Claude apps gateway](/docs/ru/claude-apps-gateway#availability-and-limitations), поэтому команда недоступна там |87| `/design-sync [hint]` | **[Skill](/docs/ru/skills#bundled-skills).** Преобразовать систему дизайна React вашего репо и загрузить её в [Claude Design](https://claude.ai/design), чтобы дизайны, которые она производит, использовали ваши реальные компоненты. Опционально назовите систему дизайна, например `/design-sync Acme DS`. Первоначальная синхронизация проверяет каждый компонент и может занять несколько часов на большом репо. Доступно на Anthropic API. Ей нужен claude.ai, который CLI не контактирует на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или Claude Platform на AWS, или через [Claude apps gateway](/docs/ru/claude-apps-gateway#availability-and-limitations), поэтому команда недоступна там |

88| `/desktop` | Продолжить текущую сессию в приложении Claude Code Desktop. Требует macOS или x64 Windows и подписку Claude. Псевдоним: `/app` |88| `/desktop` | Продолжить текущую сессию в приложении Claude Code Desktop. Требует macOS или x64 Windows и подписку Claude. Псевдоним: `/app` |

89| `/diff` | Просмотреть изменения в вашем рабочем дереве, включая правки, которые Claude сделал до сих пор. См. [Просмотреть изменения с /diff](/docs/ru/interactive-mode#review-changes-with-%2Fdiff) |89| `/diff` | Просмотреть изменения в вашем рабочем дереве, включая правки, которые Claude сделал до сих пор. См. [Просмотреть изменения с /diff](/docs/ru/interactive-mode#review-changes-with-%2Fdiff) |

90| `/doctor [prompt-audit [path]]` | **[Skill](/docs/ru/skills#bundled-skills).** Запустить проверку настройки, которая диагностирует проблемы и может их исправить. Проверяет здоровье установки, включая дублирующиеся или оставшиеся установки, проблемы `PATH` и непарсируемые файлы настроек. Находит неиспользуемые skills, MCP-серверы и плагины в сравнении с их стоимостью контекста, отмечает медленные [hooks](/docs/ru/hooks) и проверяет наличие более новой версии на вашем [канале выпуска](/docs/ru/setup#configure-release-channel). Дедублирует локальные файлы `CLAUDE.md` против проверенных. Обрезает проверенные файлы [`CLAUDE.md`](/docs/ru/memory#my-claude-md-is-too-large) путём вырезания контента, который Claude мог бы вывести из кодовой базы, и переносит оставшееся всегда загружаемое руководство в [skills](/docs/ru/skills) и вложенные файлы `CLAUDE.md`, которые загружаются по требованию. Также предлагает сделать [auto mode](/docs/ru/permissions#permission-modes) вашим по умолчанию и [предварительно одобрить](/docs/ru/permissions) часто отклоняемые команды только для чтения. Сначала сообщает результаты и просит подтверждение перед изменением чего-либо. Из терминала `claude doctor` выводит диагностику установки только для чтения без запуска сессии. Псевдоним: `/checkup`. Запустите `/doctor prompt-audit` чтобы Claude [проверил ваши файлы `CLAUDE.md`, skills и другую конфигурацию](/docs/ru/memory#audit-your-instruction-files) на устаревшие или конфликтующие инструкции вместо запуска проверки. Подкоманда `prompt-audit` требует Claude Code v2.1.283 или позже. Проверка обрезки `CLAUDE.md` требует Claude Code v2.1.206 или позже. До версии 2.1.205 `/doctor` открывал экран диагностики только для чтения и нажатие `f` отправляло отчёт Claude |90| `/doctor [prompt-audit [path]]` | **[Skill](/docs/ru/skills#bundled-skills).** Запустить проверку настройки, которая диагностирует проблемы установки, настроек, расширений и `CLAUDE.md` и предлагает исправления, которые Claude применяет после вашего подтверждения. Чтобы узнать, что охватывает проверка, или вместо этого проверить ваши инструкции с помощью `prompt-audit`, см. [Проверка настройки с помощью `/doctor`](/docs/ru/skills#check-your-setup-with-/doctor). Подкоманда `prompt-audit` требует Claude Code v2.1.283 или позже. Псевдоним: `/checkup` |

91| `/effort [level\|auto\|status\|ultracode [on\|off]]` | Установить [уровень усилия](/docs/ru/model-config#adjust-effort-level): `low` до `xhigh`, `max`, или `auto`; `status` выводит его. `ultracode` или `ultracode on` включает [ultracode](/docs/ru/workflows#let-claude-decide-with-ultracode) для сессии на текущем уровне, и `ultracode off` выключает его; ключ [`ultracode`](/docs/ru/settings-reference#ultracode) сохраняется. `max` только для сессии. Аргументы `on` и `off` и сохранение текущего уровня требуют Claude Code v2.1.284 или позже. До версии 2.1.284 `/effort ultracode` устанавливал сессию на `xhigh`, и `/effort ultracode off` не удавался с `Invalid argument`. Запустите его во время ответа Claude и, после подтверждения [предупреждения о кэше](/docs/ru/prompt-caching#changing-effort-level), если Claude Code показывает его, Claude Code применяет новый уровень к следующему запросу в этом ходу. До версии 2.1.242 Claude Code решал из флага функции, который он получал от Anthropic, запускать ли команду в середине хода или ставить её в очередь до завершения хода, и всегда ставил её в очередь в сессии, которая не [получает флаги функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching), такой как на [поставщике третьей стороны](/docs/ru/third-party-integrations). Работает в `-p` |91| `/effort [level\|auto\|status\|ultracode [on\|off]]` | Установить [уровень усилия](/docs/ru/model-config#adjust-effort-level): `low` до `xhigh`, `max`, или `auto`; `status` выводит его. `ultracode` или `ultracode on` включает [ultracode](/docs/ru/workflows#let-claude-decide-with-ultracode) для сессии на текущем уровне, и `ultracode off` выключает его; ключ [`ultracode`](/docs/ru/settings-reference#ultracode) сохраняется. `max` только для сессии. Аргументы `on` и `off` и сохранение текущего уровня требуют Claude Code v2.1.284 или позже. До версии 2.1.284 `/effort ultracode` устанавливал сессию на `xhigh`, и `/effort ultracode off` не удавался с `Invalid argument`. Запустите его во время ответа Claude и, после подтверждения [предупреждения о кэше](/docs/ru/prompt-caching#changing-effort-level), если Claude Code показывает его, Claude Code применяет новый уровень к следующему запросу в этом ходу. До версии 2.1.242 Claude Code решал из флага функции, который он получал от Anthropic, запускать ли команду в середине хода или ставить её в очередь до завершения хода, и всегда ставил её в очередь в сессии, которая не [получает флаги функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching), такой как на [поставщике третьей стороны](/docs/ru/third-party-integrations). Работает в `-p` |

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

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

common-workflows.md +2 −3

Details

391 Explain the logic in @src/utils/auth.js391 Explain the logic in @src/utils/auth.js

392 ```392 ```

393 393

394 Это включает полное содержимое файла в разговор.394 Это включает содержимое файла в диалог, если оно укладывается в лимит токенов [инструмента Read](/docs/ru/tools-reference#read-tool-behavior), по умолчанию 25 000 токенов. Текстовый файл размером более 256 КБ не включается.

395 </Step>395 </Step>

396 396

397 <Step title="Ссылка на каталог">397 <Step title="Ссылка на каталог">

446 Спросите Claude о его возможностях446 Спросите Claude о его возможностях

447</h3>447</h3>

448 448

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

450 450

451<h4 id="example-questions">451<h4 id="example-questions">

452 Примеры вопросов452 Примеры вопросов

483<Tip>483<Tip>

484 Советы:484 Советы:

485 485

486 * Claude всегда имеет доступ к последней документации Claude Code, независимо от версии, которую вы используете

487 * Задавайте конкретные вопросы для получения подробных ответов486 * Задавайте конкретные вопросы для получения подробных ответов

488 * Claude может объяснить сложные функции, такие как интеграция MCP, конфигурации предприятия и продвинутые рабочие процессы487 * Claude может объяснить сложные функции, такие как интеграция MCP, конфигурации предприятия и продвинутые рабочие процессы

489</Tip>488</Tip>

context-window.md +0 −2

Details

1634 1634

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

1636 1636

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

~~1638~~

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

1640 1638

1641<h2 id="check-your-own-session">1639<h2 id="check-your-own-session">

corporate-launcher.md +1 −0

Details

128* **Достигните `exec` примерно за три секунды каждый раз, когда запускается launcher.** Холодная фоновая отправка запускает launcher дважды подряд перед первым байтом вывода, поэтому выполняйте медленную работу, такую как обмен единственным входом, лениво или из кэша.128* **Достигните `exec` примерно за три секунды каждый раз, когда запускается launcher.** Холодная фоновая отправка запускает launcher дважды подряд перед первым байтом вывода, поэтому выполняйте медленную работу, такую как обмен единственным входом, лениво или из кэша.

129* **Допускайте вызов изнутри себя.** Claude Code применяет launcher к каждому вложенному self-spawn, поэтому launcher, который получает исключительный ресурс, должен обнаружить, что он его уже держит.129* **Допускайте вызов изнутри себя.** Claude Code применяет launcher к каждому вложенному self-spawn, поэтому launcher, который получает исключительный ресурс, должен обнаружить, что он его уже держит.

130* **Не пишите в терминал перед запуском Claude Code.** Все, что напечатано перед `exec`, сообщается как причина сбоя, если сеанс умирает перед инициализацией.130* **Не пишите в терминал перед запуском Claude Code.** Все, что напечатано перед `exec`, сообщается как причина сбоя, если сеанс умирает перед инициализацией.

131* **Не полагайтесь на то, как записаны аргументы.** Значение флага может прийти как отдельный аргумент, `--flag value`, или вместе с флагом, `--flag=value`. Форма, которую использует флаг, может меняться от версии к версии.

131 132

132<h3 id="format-of-the-launcher-value">133<h3 id="format-of-the-launcher-value">

133 Формат значения launcher134 Формат значения launcher

debug-your-config.md +12 −1

Details

85 Протестируйте с чистой конфигурацией85 Протестируйте с чистой конфигурацией

86</h2>86</h2>

87 87

88Начните с [`claude --safe-mode`](/docs/ru/cli-reference#cli-flags), который запускает сессию со всеми отключёнными настройками, включая `CLAUDE.md`, skills, plugins, hooks, MCP серверы и пользовательские команды и агенты. Аутентификация, выбор модели, встроенные инструменты и разрешения работают нормально. Если проблема исчезает в безопасном режиме, одна из этих поверхностей является причиной; используйте целевые проверки выше, чтобы найти, какая именно. Безопасный режим по-прежнему применяет управляемые hooks и политику параметров от вашей организации. Управляемые plugins, skills, `CLAUDE.md` и MCP серверы отключены.88Начните с [`claude --safe-mode`](/docs/ru/cli-reference#cli-flags), который запускает сессию с отключёнными пользовательскими настройками, включая:

90* `CLAUDE.md`

91* Скиллы, плагины и хуки

92* MCP-серверы

93* Пользовательские команды и агенты

94* Пользовательские стили вывода

95* Пользовательские сочетания клавиш

97Аутентификация, выбор модели, встроенные инструменты и разрешения работают нормально. Если проблема исчезает в безопасном режиме, вы сузили круг причин до одного из отключённых элементов. Чтобы найти его, используйте проверку для соответствующего элемента, например [Посмотрите, что загружено в контекст](#see-what-loaded-into-context), [Проверьте MCP-серверы](#check-mcp-servers) или [Проверьте хуки](#check-hooks).

99Безопасный режим по-прежнему применяет управляемые хуки и политику настроек от вашей организации. Управляемые плагины, скиллы, `CLAUDE.md` и MCP-серверы отключены.

89 100

90Если проблема сохраняется в безопасном режиме или ваши параметры сами по себе вызывают подозрения, сравните с сессией, которая ничего не загружает из вашей обычной установки. Укажите [`CLAUDE_CONFIG_DIR`](/docs/ru/env-vars) на пустой каталог, чтобы обойти всё под `~/.claude`, и запустите из каталога, который не имеет папки `.claude`, файла `.mcp.json` или `CLAUDE.md`, чтобы конфигурация проекта также была пропущена.101Если проблема сохраняется в безопасном режиме или ваши параметры сами по себе вызывают подозрения, сравните с сессией, которая ничего не загружает из вашей обычной установки. Укажите [`CLAUDE_CONFIG_DIR`](/docs/ru/env-vars) на пустой каталог, чтобы обойти всё под `~/.claude`, и запустите из каталога, который не имеет папки `.claude`, файла `.mcp.json` или `CLAUDE.md`, чтобы конфигурация проекта также была пропущена.

91 102

desktop.md +132 −84

Details

60Предоставьте Claude правильный контекст, контролируйте, сколько он делает самостоятельно, и проверяйте внесённые им изменения.60Предоставьте Claude правильный контекст, контролируйте, сколько он делает самостоятельно, и проверяйте внесённые им изменения.

61 61

62<h3 id="use-the-prompt-box">62<h3 id="use-the-prompt-box">

~~63 Используйте поле подсказки~~63 Используйте поле промпта

64</h3>64</h3>

65 65

66Введите, что вы хотите, чтобы Claude сделал, и нажмите **Enter** для отправки. Claude читает файлы вашего проекта, вносит изменения и выполняет команды на основе вашего [режима разрешений](#choose-a-permission-mode). Вы можете изменить направление действий Claude в любой момент: нажмите кнопку остановки, чтобы прервать немедленно, или введите исправление и нажмите **Enter** для отправки без остановки выполняемого действия. Claude прочитает исправление, как только завершится текущее действие, и скорректирует свои действия перед следующим шагом.66Введите, что вы хотите, чтобы Claude сделал, и нажмите **Enter** для отправки. Claude читает файлы вашего проекта, вносит изменения и выполняет команды на основе вашего [режима разрешений](#choose-a-permission-mode). Вы можете изменить направление действий Claude в любой момент: нажмите кнопку остановки, чтобы прервать немедленно, или введите исправление и нажмите **Enter** для отправки без остановки выполняемого действия. Claude прочитает исправление, как только завершится текущее действие, и скорректирует свои действия перед следующим шагом.

67 67

68Кнопка **+** рядом с полем подсказки даёт вам доступ к вложениям файлов, [навыкам](#use-skills), [коннекторам](#connect-external-tools) и [плагинам](#install-plugins).68Кнопка **+** рядом с полем промпта даёт вам доступ к вложениям файлов, [скиллам](#use-skills), [коннекторам](#connect-external-tools) и [плагинам](#install-plugins).

70<h3 id="accept-a-suggested-prompt">

71 Примите предложенный промпт

72</h3>

74После ответа Claude вкладка Code может показать предложенный следующий промпт серым текстом в пустом поле промпта. Claude Code [генерирует каждое предложение](/docs/ru/interactive-mode#prompt-suggestions) на основе вашего диалога с помощью короткого фонового запроса, который учитывается в лимитах использования вашего плана или в ваших расходах на API.

76* **Использовать предложение**: нажмите **Tab** или **Стрелку вправо**, чтобы поместить его в поле промпта, при желании отредактируйте, затем нажмите **Enter** для отправки. Нажатие **Enter** до того, как вы примете предложение, не отправляет его.

77* **Написать собственный промпт**: начните вводить текст. Предложение отображается, только пока поле промпта пустое и в нём нет вложенных файлов.

79Перейдите в **Settings > Claude Code** и отключите **Prompt suggestions** в разделе **Sessions**, чтобы предложения перестали появляться в каждой сессии со следующего её запуска или возобновления.

69 80

70<h3 id="add-files-and-context-to-prompts">81<h3 id="add-files-and-context-to-prompts">

~~71 Добавляйте файлы и контекст в подсказки~~82 Добавляйте файлы и контекст в промпты

72</h3>83</h3>

73 84

~~74Поле подсказки поддерживает два способа добавления внешнего контекста:~~85Поле промпта поддерживает два способа добавления внешнего контекста:

75 86

76* **@mention файлов**: введите `@` и имя файла, чтобы добавить файл в контекст беседы. Claude сможет затем читать и ссылаться на этот файл. @mention недоступен в облачных сеансах и сеансах WSL.87* **@mention файлов**: введите `@` и имя файла, чтобы добавить файл в контекст диалога. Claude сможет затем читать и ссылаться на этот файл. @mention недоступен в облачных сессиях и сессиях WSL.

77* **Вложение файлов**: вложите изображения, PDF-файлы и другие файлы в вашу подсказку, используя кнопку вложения, или перетащите файлы прямо в поле подсказки. Это полезно для обмена скриншотами ошибок, макетами дизайна или справочными документами.88* **Вложение файлов**: вложите изображения, PDF-файлы и другие файлы в ваш промпт, используя кнопку вложения, или перетащите файлы прямо в поле промпта. Это полезно для обмена скриншотами ошибок, макетами дизайна или справочными документами.

78 89

79<h3 id="choose-a-permission-mode">90<h3 id="choose-a-permission-mode">

80 Выберите режим разрешений91 Выберите режим разрешений

81</h3>92</h3>

82 93

83Режимы разрешений контролируют, насколько автономно Claude действует во время сеанса: спрашивает ли он перед редактированием файлов, выполнением команд или обоим. Вы можете переключать режимы разрешений в любой момент, используя селектор режима рядом с кнопкой отправки. Чтобы одобрять каждое изменение самостоятельно, переключитесь на Manual.94Режимы разрешений контролируют, насколько автономно Claude действует во время сессии: спрашивает ли он перед редактированием файлов, выполнением команд или обоим. Вы можете переключать режимы разрешений в любой момент, используя селектор режима рядом с кнопкой отправки. Чтобы подтверждать каждое изменение самостоятельно, переключитесь на Manual.

84 95

85Чтобы установить режим по умолчанию для новых локальных сеансов, добавьте `permissions.defaultMode` в ваш [файл параметров](/docs/ru/settings#where-settings-live). Приложение для рабочего стола читает те же файлы параметров, что и CLI. Режим, который вы выбираете в селекторе, запоминается для каждой папки и имеет приоритет над `defaultMode` для этой папки, за исключением Plan, который применяется только к текущему сеансу.96Чтобы установить режим по умолчанию для новых локальных сессий, добавьте `permissions.defaultMode` в ваш [файл настроек](/docs/ru/settings#where-settings-live). Приложение для рабочего стола читает те же файлы настроек, что и CLI. Режим, который вы выбираете в селекторе, запоминается для каждой папки и имеет приоритет над `defaultMode` для этой папки, за исключением Plan, который применяется только к текущей сессии.

86 97

88| - | - | - |99| - | - | - |

90| **Accept edits** | `acceptEdits` | Claude автоматически принимает редактирование файлов и общие команды файловой системы, такие как `mkdir`, `touch` и `mv`, но всё ещё спрашивает перед выполнением других команд терминала. Используйте это, когда вы доверяете изменениям файлов и хотите более быструю итерацию. |101| **Accept edits** | `acceptEdits` | Claude автоматически принимает редактирование файлов и общие команды файловой системы, такие как `mkdir`, `touch` и `mv`, но всё ещё спрашивает перед выполнением других команд терминала. Используйте это, когда вы доверяете изменениям файлов и хотите более быструю итерацию. |

91| **Plan** | `plan` | Claude читает файлы и выполняет команды для исследования, затем предлагает план без редактирования вашего исходного кода. Хорошо подходит для сложных задач, когда вы хотите сначала проверить подход. |102| **Plan** | `plan` | Claude читает файлы и выполняет команды для исследования, затем предлагает план без редактирования вашего исходного кода. Хорошо подходит для сложных задач, когда вы хотите сначала проверить подход. |

92| **Auto** | `auto` | Claude работает без обычных подсказок; перед выполнением действий, таких как команды shell и сетевые запросы, фоновый классификатор проверяет, что они соответствуют вашему запросу. Появляется, когда [auto mode доступен](#auto-mode-availability); отдельного переключателя Settings для этого нет. |103| **Auto** | `auto` | Claude работает без рутинных запросов разрешения; перед выполнением действий, таких как shell-команды и сетевые запросы, фоновый классификатор проверяет, что они соответствуют вашему запросу. Появляется, когда [авторежим доступен](#auto-mode-availability); отдельного переключателя Settings для этого нет. |

93| **Bypass permissions** | `bypassPermissions` | Claude работает без подсказок разрешений, за исключением [действий, которые ни один режим не одобряет автоматически](/docs/ru/permission-modes#actions-no-mode-auto-approves), классификаторов безопасности, когда Claude [действует на внешних сайтах](#browse-external-sites), или действий рабочего стола, где Claude всегда спрашивает в первую очередь, таких как [архивирование сеанса](#work-across-sessions). Эквивалентно `--dangerously-skip-permissions` в CLI. На планах Pro и Max включите это в Settings → Claude Code в разделе "Allow bypass permissions mode"; на планах Team и Enterprise переключателя Settings нет, и вместо этого политика организации его контролирует. Используйте это только в sandboxed контейнерах или виртуальных машинах. |104| **Bypass permissions** | `bypassPermissions` | Claude работает без запросов разрешения, за исключением [действий, которые ни один режим не одобряет автоматически](/docs/ru/permission-modes#actions-no-mode-auto-approves), классификаторов безопасности, когда Claude [действует на внешних сайтах](#browse-external-sites), или действий рабочего стола, где Claude всегда спрашивает в первую очередь, таких как [архивирование сессии](#work-across-sessions). Эквивалентно `--dangerously-skip-permissions` в CLI. На планах Pro и Max включите это в Settings → Claude Code в разделе "Allow bypass permissions mode"; на планах Team и Enterprise переключателя Settings нет, и вместо этого политика организации его контролирует. Используйте это только в sandboxed контейнерах или виртуальных машинах. |

94 105

95Более ранние версии вкладки Code обозначали эти режимы как Ask permissions, Auto accept edits и Plan mode.106Более ранние версии вкладки Code обозначали эти режимы как Ask permissions, Auto accept edits и Plan mode.

96 107

97Режим разрешений `dontAsk` доступен только в [CLI](/docs/ru/permission-modes#allow-only-pre-approved-tools-with-dontask-mode).108Режим разрешений `dontAsk` доступен только в [CLI](/docs/ru/permission-modes#allow-only-pre-approved-tools-with-dontask-mode).

98 109

99<Tip title="Best practice">110<Tip title="Best practice">

100 Начните сложные задачи в Plan, чтобы Claude наметил подход перед внесением изменений. После того как вы одобрите план, переключитесь на Accept edits или Manual для его выполнения. См. [explore first, then plan, then code](/docs/ru/best-practices#explore-first-then-plan-then-code) для получения дополнительной информации об этом рабочем процессе.111 Начните сложные задачи в Plan, чтобы Claude наметил подход перед внесением изменений. После того как вы утвердите план, переключитесь на Accept edits или Manual для его выполнения. См. [explore first, then plan, then code](/docs/ru/best-practices#explore-first-then-plan-then-code) для получения дополнительной информации об этом рабочем процессе.

101</Tip>112</Tip>

102 113

103Облачные сеансы поддерживают Accept edits, Plan и Auto. Accept edits соответствует режиму `default`: облачные сеансы предварительно одобряют редактирование файлов, поэтому селектор показывает Accept edits вместо Manual. Bypass permissions недоступен в облачных сеансах, включая сеансы в [самостоятельно размещённой среде](/docs/ru/self-hosted-environments).114Облачные сессии поддерживают Accept edits, Plan и Auto. Accept edits соответствует режиму `default`: облачные сессии предварительно одобряют редактирование файлов, поэтому селектор показывает Accept edits вместо Manual. Bypass permissions недоступен в облачных сессиях, включая сессии в [самостоятельно размещённой среде](/docs/ru/self-hosted-environments).

104 115

105Администраторы Enterprise могут ограничить, какие режимы разрешений доступны. См. [конфигурация enterprise](#enterprise-configuration) для получения подробной информации.116Администраторы Enterprise могут ограничить, какие режимы разрешений доступны. См. [конфигурация enterprise](#enterprise-configuration) для получения подробной информации.

106 117

116 Предпросмотр вашего приложения127 Предпросмотр вашего приложения

117</h3>128</h3>

118 129

119Claude может запустить dev сервер и открыть его в панели Browser для проверки своих изменений. Это работает как для фронтенд веб-приложений, так и для бэкенд серверов: Claude может тестировать API endpoints, просматривать логи сервера и итерировать по найденным проблемам. В большинстве случаев Claude автоматически запускает сервер после редактирования файлов проекта. Вы также можете попросить Claude выполнить предпросмотр в любой момент. По умолчанию Claude [автоматически проверяет](#auto-verify-changes) изменения после каждого редактирования.130Claude может запустить dev сервер и открыть его в панели Browser для проверки своих изменений. Это работает как для фронтенд веб-приложений, так и для бэкенд серверов: Claude может тестировать API-эндпоинты, просматривать логи сервера и итерировать по найденным проблемам. В большинстве случаев Claude автоматически запускает сервер после редактирования файлов проекта. Вы также можете попросить Claude выполнить предпросмотр в любой момент. По умолчанию Claude [автоматически проверяет](#auto-verify-changes) изменения после каждого редактирования.

120 131

121Панель Browser также может открывать статические HTML файлы, PDF-файлы, изображения и видео из вашего проекта. Нажмите на путь HTML, PDF, изображения или видео в чате, чтобы открыть его там.132Панель Browser также может открывать статические HTML файлы, PDF-файлы, изображения и видео из вашего проекта. Нажмите на путь HTML, PDF, изображения или видео в чате, чтобы открыть его там.

122 133

127* Запускать или останавливать серверы либо останавливать все сразу из меню **Dev servers** в заголовке панели Browser138* Запускать или останавливать серверы либо останавливать все сразу из меню **Dev servers** в заголовке панели Browser

128* Выбирать, сохраняет ли Browser cookies после выхода из приложения, с помощью **Keep cookies** в меню **⋮** панели Browser, чтобы вам не приходилось повторно входить во время разработки139* Выбирать, сохраняет ли Browser cookies после выхода из приложения, с помощью **Keep cookies** в меню **⋮** панели Browser, чтобы вам не приходилось повторно входить во время разработки

129 140

130Claude создаёт начальную конфигурацию сервера на основе вашего проекта. Если ваше приложение использует пользовательскую команду dev, отредактируйте `.claude/launch.json` в соответствии с вашей установкой. См. [Configure preview servers](#configure-preview-servers) для полного справочника.141Claude создаёт начальную конфигурацию сервера на основе вашего проекта. Если ваше приложение использует пользовательскую команду dev, отредактируйте `.claude/launch.json` в соответствии с вашей конфигурацией. См. [Configure preview servers](#configure-preview-servers) для полного справочника.

131 142

132Чтобы очистить сохранённые данные Browser, выберите **Clear browsing data** в меню **⋮** панели Browser. Чтобы полностью отключить Browser, выключите **Browser tools** в **Settings > Claude Code**.143Чтобы очистить сохранённые данные Browser, выберите **Clear browsing data** в меню **⋮** панели Browser. Чтобы полностью отключить Browser, выключите **Browser tools** в **Settings > Claude Code**.

133 144

141 152

142Claude может читать и взаимодействовать с внешними страницами, используя те же инструменты, которые он использует для [проверки вашего приложения](#preview-your-app), с двумя дополнительными проверками безопасности:153Claude может читать и взаимодействовать с внешними страницами, используя те же инструменты, которые он использует для [проверки вашего приложения](#preview-your-app), с двумя дополнительными проверками безопасности:

143 154

144* Классификаторы безопасности проверяют действия Claude по записи на внешних страницах, такие как нажатие и ввод текста, в каждом режиме разрешений. Это те же классификаторы, которые использует [auto mode](#choose-a-permission-mode), и когда они отмечают действие, вы получаете подсказку разрешения независимо от режима.155* Классификаторы безопасности проверяют действия Claude по записи на внешних страницах, такие как нажатие и ввод текста, в каждом режиме разрешений. Это те же классификаторы, которые использует [авторежим](#choose-a-permission-mode), и когда они помечают действие, вы получаете запрос разрешения независимо от режима.

145* В режимах разрешений, отличных от Auto и Bypass permissions, проверка списка разрешённых доменов также применяется перед тем, как Claude переходит на новый сайт.156* В режимах разрешений, отличных от Auto и Bypass permissions, проверка списка разрешённых доменов также применяется перед тем, как Claude переходит на новый сайт.

146 157

147<h4 id="approve-claude’s-actions-on-a-site">158<h4 id="approve-claude’s-actions-on-a-site">

148 Одобрите действия Claude на сайте159 Подтвердите действия Claude на сайте

149</h4>160</h4>

150 161

151Когда Claude впервые действует на внешнем сайте, появляется карточка разрешения и Claude ждёт вашего выбора: **Allow once**, **Always allow** или **Deny**. **Allow once** одобряет действие без сохранения чего-либо. **Always allow** сохраняет одобрение для этого сайта на вашем устройстве, и вы можете отозвать его в Settings. Каждый сайт требует собственного одобрения, включая поддомены. Ваши локальные dev серверы и файлы проекта не требуют одобрения, поэтому [auto-verify](#auto-verify-changes) продолжает работать без подсказок.162Когда Claude впервые действует на внешнем сайте, появляется карточка разрешения и Claude ждёт вашего выбора: **Allow once**, **Always allow** или **Deny**. **Allow once** подтверждает действие без сохранения чего-либо. **Always allow** сохраняет подтверждение для этого сайта на вашем устройстве, и вы можете отозвать его в Settings. Каждый сайт требует собственного подтверждения, включая поддомены. Ваши локальные dev серверы и файлы проекта не требуют подтверждения, поэтому [auto-verify](#auto-verify-changes) продолжает работать без запросов разрешения.

152 163

153Даже на одобренном сайте Claude не будет покупать товары, создавать учётные записи или обходить CAPTCHA без вашего ввода. Просмотр в панели Browser использует ту же модель безопасности, что и [Claude в расширении Chrome](/docs/ru/chrome). См. [Using Claude in Chrome safely](https://support.claude.com/en/articles/12902428-using-claude-in-chrome-safely) для получения информации о том, как Claude обрабатывает чувствительные сайты и рискованные действия.164Даже на одобренном сайте Claude не будет покупать товары, создавать учётные записи или обходить CAPTCHA без вашего ввода. Просмотр в панели Browser использует ту же модель безопасности, что и [Claude в расширении Chrome](/docs/ru/chrome). См. [Using Claude in Chrome safely](https://support.claude.com/en/articles/12902428-using-claude-in-chrome-safely) для получения информации о том, как Claude обрабатывает чувствительные сайты и рискованные действия.

154 165

156 Выберите между Browser и расширением Chrome167 Выберите между Browser и расширением Chrome

157</h4>168</h4>

158 169

159Панель Browser использует чистый профиль браузера, отдельный от вашего личного браузера, без ваших сохранённых входов или истории. Используйте его для создания и тестирования вашего приложения и для сайтов, которые не требуют вашей личности. Когда вы хотите, чтобы Claude действовал как вы в ваших вошедших сеансах, используйте вместо этого [Claude в расширении Chrome](/docs/ru/chrome), которое делится состоянием входа вашего браузера.170Панель Browser использует чистый профиль браузера, отдельный от вашего личного браузера, без ваших сохранённых входов или истории. Используйте его для создания и тестирования вашего приложения и для сайтов, которые не требуют вашей личности. Когда вы хотите, чтобы Claude действовал как вы в ваших сессиях с выполненным входом, используйте вместо этого [Claude в расширении Chrome](/docs/ru/chrome), которое делится состоянием входа вашего браузера.

160 171

161<h4 id="restrict-external-browsing-for-your-organization">172<h4 id="restrict-external-browsing-for-your-organization">

162 Ограничьте внешний просмотр для вашей организации173 Ограничьте внешний просмотр для вашей организации

163</h4>174</h4>

164 175

165Browser следует тем же [элементам управления списком разрешённых и заблокированных сайтов](https://support.claude.com/en/articles/13065128-claude-in-chrome-admin-controls), что и расширение Claude в Chrome. Если ваша организация уже настроила эти списки для расширения, Browser их автоматически соблюдает. Администраторы также могут отключить инструменты Claude на внешних страницах с помощью управляемого параметра [`browserExternalPageTools`](#managed-settings). С отключёнными инструментами пользователи всё ещё могут посещать внешние сайты; инструменты Claude не могут их читать или действовать на них.176Browser следует тем же [элементам управления списком разрешённых и заблокированных сайтов](https://support.claude.com/en/articles/13065128-claude-in-chrome-admin-controls), что и расширение Claude в Chrome. Если ваша организация уже настроила эти списки для расширения, Browser их автоматически соблюдает. Администраторы также могут отключить инструменты Claude на внешних страницах с помощью управляемой настройки [`browserExternalPageTools`](#managed-settings). С отключёнными инструментами пользователи всё ещё могут посещать внешние сайты; инструменты Claude не могут их читать или действовать на них.

166 177

167Чтобы полностью отключить внешний просмотр, установите управляемый параметр [`disableBrowserExternalNavigation`](#managed-settings) на `true`. Это блокирует всю внешнюю навигацию в Browser, включая сайты в списке разрешённых вашей организации; локальные dev серверы и предпросмотры файлов продолжают работать. Используйте `browserExternalPageTools`, чтобы позволить пользователям продолжать просмотр внешних сайтов без инструментов Claude, и `disableBrowserExternalNavigation`, чтобы заблокировать внешние сайты как для пользователей, так и для Claude.178Чтобы полностью отключить внешний просмотр, установите управляемую настройку [`disableBrowserExternalNavigation`](#managed-settings) в `true`. Это блокирует всю внешнюю навигацию в Browser, включая сайты в списке разрешённых вашей организации; локальные dev серверы и предпросмотры файлов продолжают работать. Используйте `browserExternalPageTools`, чтобы позволить пользователям продолжать просмотр внешних сайтов без инструментов Claude, и `disableBrowserExternalNavigation`, чтобы заблокировать внешние сайты как для пользователей, так и для Claude.

168 179

169<h3 id="review-changes-with-diff-view">180<h3 id="review-changes-with-diff-view">

170 Проверьте изменения с помощью представления diff181 Проверьте изменения с помощью представления diff

198 Мониторьте статус pull request209 Мониторьте статус pull request

199</h3>210</h3>

200 211

201После того как вы откроете pull request, в сеансе появляется строка статуса CI. Claude Code использует GitHub CLI для опроса результатов проверок и выявления сбоев.212После того как вы откроете pull request, в сессии появляется строка статуса CI. Claude Code использует GitHub CLI для опроса результатов проверок и выявления сбоев.

202 213

203* **Auto-fix CI & address comments**: когда включено, Claude автоматически пытается исправить неудачные проверки CI, читая вывод ошибки и итерируя. В локальной сессии Claude также обрабатывает новые комментарии ревью, оставленные кем-то кроме вас, если автор является владельцем репозитория, членом организации, соавтором (collaborator) или GitHub App.214* **Auto-fix CI & address comments**: когда включено, Claude автоматически пытается исправить неудачные проверки CI, читая вывод ошибки и итерируя. В локальной сессии Claude также обрабатывает новые комментарии ревью, оставленные кем-то кроме вас, если автор является владельцем репозитория, членом организации, соавтором (collaborator) или GitHub App.

204* **Auto-merge when ready**: когда включено, Claude выполняет слияние PR после того, как все проверки пройдены. Метод слияния — squash. Сначала включите auto-merge в [настройках вашего репозитория GitHub](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-auto-merge-for-pull-requests-in-your-repository); без этого Claude не может выполнить слияние PR.215* **Auto-merge when ready**: когда включено, Claude выполняет слияние PR после того, как все проверки пройдены. Метод слияния — squash. Сначала включите auto-merge в [настройках вашего репозитория GitHub](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-auto-merge-for-pull-requests-in-your-repository); без этого Claude не может выполнить слияние PR.

233 244

234Нажмите на путь файла в чате или средстве просмотра различий, чтобы открыть его в панели файлов. HTML, PDF, пути изображений и видео открываются в [панели браузера](#preview-your-app) вместо этого. Сделайте точечные правки и нажмите **Save**, чтобы записать их обратно. Если файл изменился на диске с момента его открытия, панель предупредит вас и позволит вам переопределить или отклонить. Нажмите **Discard**, чтобы отменить ваши правки, или нажмите на путь в заголовке панели, чтобы скопировать абсолютный путь.245Нажмите на путь файла в чате или средстве просмотра различий, чтобы открыть его в панели файлов. HTML, PDF, пути изображений и видео открываются в [панели браузера](#preview-your-app) вместо этого. Сделайте точечные правки и нажмите **Save**, чтобы записать их обратно. Если файл изменился на диске с момента его открытия, панель предупредит вас и позволит вам переопределить или отклонить. Нажмите **Discard**, чтобы отменить ваши правки, или нажмите на путь в заголовке панели, чтобы скопировать абсолютный путь.

235 246

236Панель файлов доступна в локальных и SSH-сеансах. Для облачных сеансов попросите Claude сделать изменение.247Панель файлов доступна в локальных и SSH-сессиях. Для облачных сессий попросите Claude сделать изменение.

237 248

238<h3 id="open-files-in-other-apps">249<h3 id="open-files-in-other-apps">

239 Открытие файлов в других приложениях250 Открытие файлов в других приложениях

241 252

242Щелкните правой кнопкой мыши на любом пути файла в чате, средстве просмотра различий или панели файлов, чтобы открыть контекстное меню:253Щелкните правой кнопкой мыши на любом пути файла в чате, средстве просмотра различий или панели файлов, чтобы открыть контекстное меню:

243 254

244* **Attach as context**: добавьте файл к вашей следующей подсказке255* **Attach as context**: добавьте файл к вашему следующему промпту

245* **Open in**: откройте файл в установленном редакторе, таком как VS Code, Cursor или Zed256* **Open in**: откройте файл в установленном редакторе, таком как VS Code, Cursor или Zed

246* **Show in Finder** на macOS, **Show in Explorer** на Windows: откройте содержащую папку257* **Show in Finder** на macOS, **Show in Explorer** на Windows: откройте содержащую папку

247* **Copy path**: скопируйте абсолютный путь в буфер обмена258* **Copy path**: скопируйте абсолютный путь в буфер обмена

255| Режим | Что показывается |266| Режим | Что показывается |

256| - | - |267| - | - |

257| **Normal** | Вызовы инструментов свёрнуты в сводки, с полными текстовыми ответами |268| **Normal** | Вызовы инструментов свёрнуты в сводки, с полными текстовыми ответами |

258| **Thinking** | Вызовы инструментов свёрнуты в сводки, плюс thinking Claude |269| **Thinking** | Вызовы инструментов свёрнуты в сводки, плюс размышления Claude |

259| **Verbose** | Каждый вызов инструмента, чтение файла и промежуточный шаг, который делает Claude, плюс thinking Claude |270| **Verbose** | Каждый вызов инструмента, чтение файла и промежуточный шаг, который делает Claude, плюс размышления Claude |

260 271

261Используйте Thinking, чтобы следить за рассуждениями Claude с вызовами инструментов, всё ещё свёрнутыми. Используйте Verbose при отладке того, почему Claude предпринял конкретное действие. Версии Claude Desktop до 1.46388.1 также содержат режим Summary, и сеанс, всё ещё установленный на Summary, открывается в Normal после обновления.272Используйте Thinking, чтобы следить за рассуждениями Claude с вызовами инструментов, всё ещё свёрнутыми. Используйте Verbose при отладке того, почему Claude предпринял конкретное действие. Версии Claude Desktop до 1.46388.1 также содержат режим Summary, и сессия, всё ещё установленная на Summary, открывается в Normal после обновления.

262 273

263<h3 id="keyboard-shortcuts">274<h3 id="keyboard-shortcuts">

264 Сочетания клавиш275 Сочетания клавиш

265</h3>276</h3>

266 277

267Нажмите **Cmd+/** на macOS или **Ctrl+/** на Windows, чтобы увидеть все доступные сочетания клавиш на вкладке Code. На Windows используйте **Ctrl** вместо **Cmd** для сочетаний клавиш ниже. Циклирование сеансов, переключение терминала и переключение режима просмотра используют **Ctrl** на каждой платформе.278Нажмите **Cmd+/** на macOS или **Ctrl+/** на Windows, чтобы увидеть все доступные сочетания клавиш на вкладке Code. На Windows используйте **Ctrl** вместо **Cmd** для сочетаний клавиш ниже. Циклическое переключение сессий, переключение терминала и переключение режима просмотра используют **Ctrl** на каждой платформе.

268 279

269| Сочетание клавиш | Действие |280| Сочетание клавиш | Действие |

270| - | - |281| - | - |

271| `Cmd` `/` | Показать сочетания клавиш |282| `Cmd` `/` | Показать сочетания клавиш |

276| `Esc` | Остановить ответ Claude |287| `Esc` | Остановить ответ Claude |

288| `Tab` / `Right arrow` | [Принять предложенный промпт](#accept-a-suggested-prompt) в пустом поле ввода промпта |

287| `1`–`9` | Выбрать элемент в открытом меню |299| `1`–`9` | Выбрать элемент в открытом меню |

288 300

289Эти сочетания клавиш применяются только к вкладке Code. Сочетания клавиш [интерактивного режима](/docs/ru/interactive-mode#keyboard-shortcuts) на основе терминала, такие как `Shift+Tab` для циклирования режимов, не применяются в Desktop.301Эти сочетания клавиш применяются к вкладке Code. В Desktop `Shift+Tab` не переключает режимы разрешений по кругу, как это происходит в [интерактивном режиме](/docs/ru/interactive-mode#keyboard-shortcuts) терминала.

290 302

291<h3 id="check-usage">303<h3 id="check-usage">

292 Проверка использования304 Проверка использования

293</h3>305</h3>

294 306

295Нажмите на кольцо использования рядом с выбором модели, чтобы увидеть текущее использование окна контекста и использование вашего плана за период. Использование контекста — это за сеанс; использование плана — это общее для всех ваших поверхностей Claude Code.307Нажмите на кольцо использования рядом с выбором модели, чтобы увидеть текущее использование контекстного окна и использование вашего плана за период. Использование контекста считается для каждой сессии; использование плана — общее для всех ваших интерфейсов Claude Code.

296 308

297<h2 id="let-claude-use-your-computer">309<h2 id="let-claude-use-your-computer">

298 Позвольте Claude использовать ваш компьютер310 Позвольте Claude использовать ваш компьютер

458* Выберите **Cloud**, чтобы продолжить сессию как [облачную сессию](/docs/ru/claude-code-on-the-web), при этом ваш диалог будет перенесён в виде сводки. Перед подтверждением в диалоговом окне указано, будут ли перенесены и ваши файлы, и будет ли эта сессия архивирована, когда облачная будет готова. Таким способом нельзя перенести сессию, которая работает через [SSH](#ssh-sessions) или в [WSL](/docs/ru/desktop-wsl).470* Выберите **Cloud**, чтобы продолжить сессию как [облачную сессию](/docs/ru/claude-code-on-the-web), при этом ваш диалог будет перенесён в виде сводки. Перед подтверждением в диалоговом окне указано, будут ли перенесены и ваши файлы, и будет ли эта сессия архивирована, когда облачная будет готова. Таким способом нельзя перенести сессию, которая работает через [SSH](#ssh-sessions) или в [WSL](/docs/ru/desktop-wsl).

459* Выберите установленный редактор или файловый менеджер, чтобы открыть в нём папку сессии на диске.471* Выберите установленный редактор или файловый менеджер, чтобы открыть в нём папку сессии на диске.

460 472

473<h3 id="control-which-sessions-appear-on-your-other-devices">

474 Управление тем, какие сессии отображаются на других ваших устройствах

475</h3>

476

477Локальная сессия появляется на других ваших устройствах после того, как [Remote Control](/docs/ru/remote-control) подключит её. Подключённая сессия отображается в списке сессий на [claude.ai/code](https://claude.ai/code) и в приложениях Claude на устройствах, на которых выполнен вход в вашу учётную запись claude.ai.

478

479Локальная сессия подключается, когда вы включаете для неё Remote Control или когда она подключается автоматически при запуске:

480

481* **Вы включаете его для этой сессии**: с помощью переключателя **Remote Control** сессии или введя `/remote-control` в её поле промпта.

482* **Она подключается при запуске**: новые сессии подключаются автоматически, пока включён параметр **Connect new sessions to Remote Control** в **Settings > Claude Code**. Если вы никогда не меняли эту настройку, Desktop следует [`remoteControlAtStartup`](/docs/ru/settings-reference#remotecontrolatstartup) в ваших пользовательских или управляемых настройках, а затем значению по умолчанию вашей организации.

483

484Чтобы узнать, подключена ли сессия, посмотрите на значок ноутбука перед названием сессии в панели инструментов. Значок подсвечивается, пока сессия подключена или подключается. Нажмите на него, чтобы открыть переключатель **Remote Control** сессии.

485

486Чтобы сессии не появлялись на других ваших устройствах, отключите Remote Control на нужном уровне:

487

488* **Одна сессия**: отключите её переключатель **Remote Control**. В сессии, которая подключилась при запуске, ввод `/remote-control` оставляет Remote Control включённым и показывает `Remote Control is already on. This session connected automatically when it started.` Нажмите **Turn off** в этой строке, чтобы отключиться.

489* **Новые сессии Desktop на этом компьютере**: отключите **Connect new sessions to Remote Control** в **Settings > Claude Code**. Если параметр уже отображается отключённым, включите его, а затем отключите, чтобы Desktop сохранил ваш выбор. После сохранения он имеет приоритет над `remoteControlAtStartup` и значениями по умолчанию.

490* **Любая сессия на этом компьютере, включая CLI**: задайте для [`disableRemoteControl`](/docs/ru/settings-reference#disableremotecontrol) значение `true` в `~/.claude/settings.json`, чтобы сессии не подключались. Сессия, которая уже была подключена, когда вы сохранили файл, остаётся подключённой, пока вы не отключите для неё Remote Control.

491

492Чтобы скрыть сессию, которая уже отображается на других ваших устройствах, архивируйте её в Desktop. Desktop также архивирует копию сессии в Remote Control, поэтому она исчезает из списка сессий по умолчанию на этих устройствах. Чтобы просмотреть или удалить её там, см. [Архивирование сессий](/docs/ru/claude-code-on-the-web#archive-sessions).

493

461<h3 id="sessions-from-dispatch">494<h3 id="sessions-from-dispatch">

462 Сессии из Dispatch495 Сессии из Dispatch

463</h3>496</h3>

836 Предварительная конфигурация SSH-соединений для вашей команды869 Предварительная конфигурация SSH-соединений для вашей команды

837</h4>870</h4>

838 871

839Администраторы могут распространять SSH-соединения членам команды, добавляя `sshConfigs` в файл [управляемых параметров](/docs/ru/managed-settings). Соединения, определённые таким образом, появляются в раскрывающемся списке окружения каждого пользователя автоматически и отображаются как управляемые, поэтому пользователи могут выбирать их, но не могут редактировать или удалять их в приложении.872Администраторы могут распространять SSH-соединения членам команды, задавая `sshConfigs` в [управляемых настройках](/docs/ru/managed-settings). Соединения, определённые таким образом, появляются в раскрывающемся списке окружения каждого пользователя автоматически и отображаются как управляемые, поэтому пользователи могут выбирать их, но не могут редактировать или удалять их в приложении.

840 873

841Следующий пример предварительно конфигурирует одно соединение:874Следующий пример предварительно конфигурирует одно соединение:

842 875

860 Ограничение SSH-хостов, к которым могут подключаться пользователи893 Ограничение SSH-хостов, к которым могут подключаться пользователи

861</h4>894</h4>

862 895

863Администраторы могут ограничить SSH-сеансы Desktop утверждённым набором хостов, добавляя `sshHostAllowlist` в файл [управляемых параметров](/docs/ru/managed-settings). Когда это установлено, пользователи могут подключаться только к хостам, разрешённое имя хоста которых совпадает с одним из шаблонов. Установите его в пустой массив, чтобы полностью отключить SSH-сеансы.896Администраторы могут ограничить SSH-сессии Desktop утверждённым набором хостов, задавая `sshHostAllowlist` в [управляемых настройках](/docs/ru/managed-settings). Когда это задано, пользователи могут подключаться только к хостам, разрешённое имя хоста которых совпадает с одним из шаблонов. Установите его в пустой массив, чтобы отключить SSH-сессии. В [справочной записи `sshHostAllowlist`](/docs/ru/settings-reference#sshhostallowlist) описано, как пустой массив сочетается со списками из других управляемых источников.

864 897

865Следующий пример разрешает соединения с любым хостом под `devboxes.example.com` и с одним именованным хостом-бастионом:898Следующий пример разрешает соединения с любым хостом под `devboxes.example.com` и с одним именованным хостом-бастионом:

866 899

870}903}

871```904```

872 905

906<Warning>

907 Если ваша организация доставляет [серверные управляемые настройки](/docs/ru/server-managed-settings), задайте `sshHostAllowlist` там. По умолчанию Desktop читает этот ключ только из [управляемого источника с наивысшим приоритетом, который доставляет ключ политики](/docs/ru/managed-settings#how-claude-code-combines-managed-sources). Если в этом источнике ключ не задан, Desktop игнорирует список в политике MDM или файле управляемых настроек с более низким приоритетом и считает ключ [незаданным](/docs/ru/settings-reference#sshhostallowlist). Desktop не показывает никакого предупреждения.

908

909 Также храните тот же список на машине каждого пользователя — в политике MDM или файле управляемых настроек с наивысшим приоритетом на этой машине. Desktop получает серверные управляемые настройки при запуске и не хранит кэшированную копию, поэтому пока получение не завершится успешно, действует список, заданный на машине.

910</Warning>

911

873Шаблоны не чувствительны к регистру. `*` совпадает с любым хостом, и `*.example.com` совпадает с `example.com` и любым поддоменом. Всё остальное — это точное совпадение. Проверка выполняется для имени хоста после разрешения `~/.ssh/config` через `ssh -G`, поэтому псевдонимы `Host` и записи `ProxyCommand`/`ProxyJump` разрешены, пока разрешённое `HostName` совпадает.912Шаблоны не чувствительны к регистру. `*` совпадает с любым хостом, и `*.example.com` совпадает с `example.com` и любым поддоменом. Всё остальное — это точное совпадение. Проверка выполняется для имени хоста после разрешения `~/.ssh/config` через `ssh -G`, поэтому псевдонимы `Host` и записи `ProxyCommand`/`ProxyJump` разрешены, пока разрешённое `HostName` совпадает.

874 913

875`sshHostAllowlist` читается только из управляемых параметров; значения в параметрах пользователя или проекта игнорируются. Только приложение Claude Desktop соблюдает этот параметр; Claude Code CLI и расширения IDE не читают его, и он не ограничивает команды `ssh`, выполняемые через инструмент Bash. Он управляет тем, к каким хостам подключается приложение Desktop, а не сетевым исходящим трафиком, поэтому объедините его с сетевыми элементами управления вашей организации или элементами управления с нулевым доверием, если вам нужна жёсткая граница.914`sshHostAllowlist` читается только из управляемых параметров; значения в параметрах пользователя или проекта игнорируются. Только приложение Claude Desktop соблюдает этот параметр; Claude Code CLI и расширения IDE не читают его, и он не ограничивает команды `ssh`, выполняемые через инструмент Bash. Он управляет тем, к каким хостам подключается приложение Desktop, а не сетевым исходящим трафиком, поэтому объедините его с сетевыми элементами управления вашей организации или элементами управления с нулевым доверием, если вам нужна жёсткая граница.

913| `disableMobileSimulatorTools` | установите значение `true`, чтобы заблокировать инструменты Claude для управления устройствами и их захвата в [панели iOS Simulator](/docs/ru/desktop-ios-simulator#turn-off-simulator-access). Панель остаётся доступной для собственных касаний пользователя; убирается только доступ Claude. Значение должно быть логическим значением JSON `true`; строка `"true"` игнорируется. |952| `disableMobileSimulatorTools` | установите значение `true`, чтобы заблокировать инструменты Claude для управления устройствами и их захвата в [панели iOS Simulator](/docs/ru/desktop-ios-simulator#turn-off-simulator-access). Панель остаётся доступной для собственных касаний пользователя; убирается только доступ Claude. Значение должно быть логическим значением JSON `true`; строка `"true"` игнорируется. |

914| `disableBrowserExternalNavigation` | установите значение `true`, чтобы полностью отключить просмотр внешних сайтов в [панели браузера](#browse-external-sites). Ни пользователи, ни Claude не могут переходить на внешние сайты, а предпросмотр сервера разработки на localhost не затрагивается. Значение должно быть логическим значением JSON `true`; строка `"true"` игнорируется. |953| `disableBrowserExternalNavigation` | установите значение `true`, чтобы полностью отключить просмотр внешних сайтов в [панели браузера](#browse-external-sites). Ни пользователи, ни Claude не могут переходить на внешние сайты, а предпросмотр сервера разработки на localhost не затрагивается. Значение должно быть логическим значением JSON `true`; строка `"true"` игнорируется. |

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

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

917| `disableDesktopLocalSessions` | установите значение `true`, чтобы отключить [сессии Code, работающие на устройстве](#local-sessions-on-managed-devices), оставив доступными SSH-сессии на других хостах и облачные сессии. Значение должно быть логическим значением JSON `true`. Читается только из управляемых настроек. Требуется Claude Desktop v1.37937.0 или новее. |956| `disableDesktopLocalSessions` | установите значение `true`, чтобы отключить [сессии Code, работающие на устройстве](#local-sessions-on-managed-devices), оставив доступными SSH-сессии на других хостах и облачные сессии. Значение должно быть логическим значением JSON `true`. Читается только из управляемых настроек. Требуется Claude Desktop v1.37937.0 или новее. |

918| `disableSshSavedPasswords` | установите значение `true`, чтобы Desktop перестал предлагать запоминать пароли SSH, а также использовать или показывать ранее сохранённые пароли. Включение этого параметра не удаляет их. Читается только из управляемых настроек. Требуется Claude Desktop v1.49585.0 или новее. |957| `disableSshSavedPasswords` | установите значение `true`, чтобы Desktop перестал предлагать запоминать пароли SSH, а также использовать или показывать ранее сохранённые пароли. Включение этого параметра не удаляет их. Читается только из управляемых настроек. Требуется Claude Desktop v1.49585.0 или новее. |

919| `managedMcpServers` | отправьте конфигурации MCP-серверов всем пользователям. Доступно только в сторонних (3P) развёртываниях Desktop. В каждой записи укажите транспорт `"http"`, `"sse"` или `"stdio"`, параметры подключения и, при необходимости, карту `toolPolicy`, ограничивающую, какие инструменты этого сервера пользователи могут вызывать. Доставляйте её через файл управляемых настроек, MDM или [блок `desktop`](/docs/ru/claude-apps-gateway-config#claude-desktop-overlay) политики шлюза приложений Claude, поскольку развёртывания 3P не получают настройки консоли администратора. Для доставки через шлюз на сервере шлюза нужен Claude Code v2.1.232 или новее. Это собственный ключ приложения desktop; Claude Code читает собственную [одноимённую управляемую настройку](/docs/ru/managed-mcp#provide-servers-through-managed-settings) с другой структурой записи. |958| `managedMcpServers` | отправьте конфигурации MCP-серверов всем пользователям. Доступно только в сторонних (3P) развёртываниях Desktop. В каждой записи укажите транспорт `"http"`, `"sse"` или `"stdio"`, параметры подключения и, при необходимости, карту `toolPolicy`, ограничивающую, какие инструменты этого сервера пользователи могут вызывать. Доставляйте её через файл управляемых настроек, MDM или [блок `desktop`](/docs/ru/claude-apps-gateway-config#claude-desktop-overlay) политики шлюза приложений Claude, поскольку развёртывания 3P не получают настройки консоли администратора. Для доставки через шлюз на сервере шлюза нужен Claude Code v2.1.232 или новее. Это собственный ключ приложения desktop; Claude Code читает собственную [одноимённую управляемую настройку](/docs/ru/managed-mcp#provide-servers-through-managed-settings) с другой структурой записи. |

920 959

921Какие управляемые настройки доходят до сессии Desktop, зависит от того, где эта сессия выполняется. Ограничения моделей, такие как [`availableModels`](/docs/ru/model-config#restrict-model-selection), применяются в сессиях Claude Code в Desktop так же, как в CLI в терминале; см. [охват интерфейсов](/docs/ru/model-config#surface-coverage).960Какие управляемые настройки доходят до сессии Desktop, зависит от того, где эта сессия выполняется. Ограничения моделей, такие как [`availableModels`](/docs/ru/model-config#restrict-model-selection), применяются в сессиях Claude Code в Desktop так же, как в CLI в терминале; см. [охват интерфейсов](/docs/ru/model-config#surface-coverage).

922 961

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

924* **[Облачные сессии](#cloud-sessions)**: получают [настройки, управляемые сервером](/docs/ru/server-managed-settings); файлы, развёрнутые на устройстве, до них не доходят, поскольку такие сессии выполняются на виртуальных машинах под управлением Anthropic. Сессии, направленные в [самостоятельно размещённое окружение](/docs/ru/self-hosted-environments), также читают файл управляемых настроек в образе runner. В разделе [Как Claude Code объединяет управляемые источники](/docs/ru/managed-settings#how-claude-code-combines-managed-sources) описано, когда этот файл применяется.963* **[Облачные сессии](#cloud-sessions)**: получают [настройки, управляемые сервером](/docs/ru/server-managed-settings); файлы, развёрнутые на устройстве, до них не доходят, поскольку такие сессии выполняются на виртуальных машинах под управлением Anthropic. Сессии, направленные в [самостоятельно размещённое окружение](/docs/ru/self-hosted-environments), также читают файл управляемых настроек в образе runner. В разделе [Как Claude Code объединяет управляемые источники](/docs/ru/managed-settings#how-claude-code-combines-managed-sources) описано, когда этот файл применяется.

925* **[SSH-сессии](#ssh-sessions)**: сессия читает файл управляемых настроек с удалённого хоста. Сам Desktop читает `sshConfigs`, `sshHostAllowlist`, `disableSshSavedPasswords` и `disableDesktopLocalSessions` из управляемых настроек локальной машины.964* **[SSH-сессии](#ssh-sessions)**: сессия читает файл управляемых настроек с удалённого хоста. Сам Desktop читает `sshConfigs`, `sshHostAllowlist`, `disableSshSavedPasswords` и `disableDesktopLocalSessions` на локальной машине. Если вы доставляете более одного управляемого источника, он по умолчанию читает их [только из одного](/docs/ru/managed-settings#how-claude-code-combines-managed-sources).

926* **Сессии [Cowork](https://claude.com/docs/cowork/overview)**: в сессии Cowork на этой машине Claude Code никогда не получает настройки консоли администратора, даже если пользователь входит с учётной записью Team или Enterprise, и читает политику, развёрнутую на машине, если только ваша конфигурация Claude Desktop не задаёт `requireCoworkFullVmSandbox`. Удалённые сессии Cowork не получают ни то, ни другое. О том, какие файлы устройства доходят до Cowork, см. [где и когда применяется политика](/docs/ru/managed-settings#where-and-when-a-policy-applies), а о том, как правила `Bash` и `WebFetch` применяются к инструментам Cowork, — [правила разрешений MCP](/docs/ru/permissions#mcp).965* **Сессии [Cowork](https://claude.com/docs/cowork/overview)**: в сессии Cowork на этой машине Claude Code никогда не получает настройки консоли администратора, даже если пользователь входит с учётной записью Team или Enterprise, и читает политику, развёрнутую на машине, если только ваша конфигурация Claude Desktop не задаёт `requireCoworkFullVmSandbox`. Удалённые сессии Cowork не получают ни то, ни другое. О том, какие файлы устройства доходят до Cowork, см. [где и когда применяется политика](/docs/ru/managed-settings#where-and-when-a-policy-applies), а о том, как правила `Bash` и `WebFetch` применяются к инструментам Cowork, — [правила разрешений MCP](/docs/ru/permissions#mcp).

927 966

928В локальных и SSH-сессиях приложение desktop передаёт подключённые коннекторы claude.ai каждого пользователя напрямую в Claude Code. Ни одна настройка MCP и ни один `managed-mcp.json` не влияют на эти коннекторы, какой бы источник настроек или расположение файла вы ни использовали. Чтобы заблокировать инструменты коннектора в этих сессиях, используйте [элементы управления инструментами коннекторов](/docs/ru/mcp#organization-controls-on-connector-tools) вашей организации. В разделе [Как коннекторы попадают в Claude Code](/docs/ru/mcp#how-connectors-reach-claude-code) показано, какие настройки управляют коннекторами в каждом виде сессий.967В локальных и SSH-сессиях приложение desktop передаёт подключённые коннекторы claude.ai каждого пользователя напрямую в Claude Code. Ни одна настройка MCP и ни один `managed-mcp.json` не влияют на эти коннекторы, какой бы источник настроек или расположение файла вы ни использовали. Чтобы заблокировать инструменты коннектора в этих сессиях, используйте [элементы управления инструментами коннекторов](/docs/ru/mcp#organization-controls-on-connector-tools) вашей организации. В разделе [Как коннекторы попадают в Claude Code](/docs/ru/mcp#how-connectors-reach-claude-code) показано, какие настройки управляют коннекторами в каждом виде сессий.

975assets-proxy.anthropic.com1014assets-proxy.anthropic.com

976claude.ai1015claude.ai

977a.claude.ai1016a.claude.ai

978a-cdn.claude.ai

979assets.claude.ai1017assets.claude.ai

980downloads.claude.ai1018downloads.claude.ai

981*.livepreview.claude.ai1019*.livepreview.claude.ai

1023 Переход с CLI?1061 Переход с CLI?

1024</h2>1062</h2>

1025 1063

1026Если вы уже используете Claude Code CLI, Desktop запускает тот же базовый механизм с графическим интерфейсом. Вы можете запускать оба одновременно на одной машине, даже на одном проекте. Каждый поддерживает отдельную историю сеансов, и вы можете перенести сеанс CLI в Desktop. Они делят конфигурацию и память проекта через файлы CLAUDE.md.1064Если вы уже используете Claude Code CLI, Desktop запускает тот же базовый механизм с графическим интерфейсом. Вы можете запускать оба одновременно на одной машине, даже на одном проекте. Каждый поддерживает отдельный список сессий, и вы можете перенести сессию CLI в Desktop. Они делят конфигурацию и память проекта через файлы CLAUDE.md.

1027 1065

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

1029 1067

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

1031 1069

1032```bash theme={null}1070```bash theme={null}

1033claude --desktop --resume <session-id>1071claude --desktop --resume <session-id>

1034```1072```

1035 1073

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

1037 1075

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

1039 1077

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

1041 1079

10421. Закройте сеанс в терминале.10801. Закройте сессию в терминале.

10432. В поле подсказки Desktop введите `/resume`. Desktop выводит список сеансов, которые вы запустили из CLI на этом компьютере. Ищите по названию, папке или ветке и просмотрите, где каждый из них остановился.10812. В поле промпта Desktop введите `/resume`. Desktop выводит список сессий, которые вы запустили из CLI на этом компьютере. Ищите по названию, папке или ветке и просмотрите, где каждая из них остановилась.

10443. Выберите сеанс. Он продолжится в приложении с полной историей разговора и контекстом.10823. Выберите сессию. Она продолжится в приложении с полной историей диалога и контекстом.

1045 1083

1046Desktop продолжает тот же сеанс, а не копию, поэтому `claude --resume` в терминале по-прежнему находит его впоследствии.1084Desktop продолжает ту же сессию, а не копию, поэтому `claude --resume` в терминале по-прежнему находит её впоследствии.

1047 1085

1048<Tip>1086<Tip>

1049 Когда использовать Desktop vs CLI: используйте Desktop, когда вы хотите управлять параллельными сеансами в одном окне, организовать панели рядом или просмотреть изменения визуально. Используйте CLI, когда вам нужны скрипты, автоматизация или вы предпочитаете рабочий процесс терминала.1087 Когда использовать Desktop vs CLI: используйте Desktop, когда вы хотите управлять параллельными сессиями в одном окне, организовать панели рядом или просмотреть изменения визуально. Используйте CLI, когда вам нужны скрипты, автоматизация или вы предпочитаете рабочий процесс в терминале.

1050</Tip>1088</Tip>

1051 1089

1052<h3 id="cli-flag-equivalents">1090<h3 id="cli-flag-equivalents">

1053 Эквиваленты флагов CLI1091 Эквиваленты флагов CLI

1054</h3>1092</h3>

1055 1093

1056Эта таблица показывает эквивалент приложения desktop для общих флагов CLI. Флаги, не указанные, не имеют эквивалента desktop, потому что они предназначены для скриптов или автоматизации.1094Эта таблица показывает эквивалент в приложении desktop для распространённых флагов CLI. Флаги, не указанные в таблице, не имеют эквивалента в desktop, потому что они предназначены для скриптов или автоматизации.

1057 1095

1058| CLI | Эквивалент Desktop |1096| CLI | Эквивалент Desktop |

1059| - | - |1097| - | - |

1061| `--resume`, `--continue` | Нажмите на сеанс в боковой панели, или введите `/resume` в поле подсказки, чтобы продолжить сеанс, который вы запустили из CLI |1099| `--resume`, `--continue` | Нажмите на сессию в боковой панели или введите `/resume` в поле промпта, чтобы продолжить сессию, которую вы запустили из CLI |

1063| `--dangerously-skip-permissions` | Режим Bypass permissions. На планах Pro и Max включите его в Settings → Claude Code → "Allow bypass permissions mode"; на планах Team и Enterprise политика организации контролирует это |1101| `--dangerously-skip-permissions` | Режим Bypass permissions. На планах Pro и Max включите его в Settings → Claude Code → "Allow bypass permissions mode"; на планах Team и Enterprise это контролирует политика организации |

1065| `--allowedTools`, `--disallowedTools` | Нет эквивалента для каждого сеанса. Правила разрешений в [файлах параметров](/docs/ru/settings) по-прежнему применяются. |1103| `--allowedTools`, `--disallowedTools` | Нет эквивалента для отдельной сессии. Правила разрешений в [файлах настроек](/docs/ru/settings) по-прежнему применяются. |

1069| `MAX_THINKING_TOKENS` переменная окружения | Установите в локальном редакторе окружения. См. [конфигурация окружения](#environment-configuration). |1107| Переменная окружения `MAX_THINKING_TOKENS` | Задайте в редакторе локального окружения. См. [конфигурация окружения](#environment-configuration). |

1070 1108

1071<h3 id="shared-configuration">1109<h3 id="shared-configuration">

1072 Общая конфигурация1110 Общая конфигурация

1073</h3>1111</h3>

1074 1112

1075Desktop и CLI читают одни и те же файлы конфигурации, поэтому ваша установка переносится:1113Desktop и CLI читают одни и те же файлы конфигурации, поэтому ваша настройка переносится:

1076 1114

1077* **[CLAUDE.md](/docs/ru/memory)** и `CLAUDE.local.md` файлы в вашем проекте используются обоими1115* Файлы **[CLAUDE.md](/docs/ru/memory)** и `CLAUDE.local.md` в вашем проекте используются обоими

1078* **[MCP servers](/docs/ru/mcp)** настроенные в `~/.claude.json` или `.mcp.json` работают в обоих1116* **[MCP-серверы](/docs/ru/mcp)**, настроенные в `~/.claude.json` или `.mcp.json`, работают в обоих

1079* **[Hooks](/docs/ru/hooks)** и **[skills](/docs/ru/skills)** определённые в параметрах применяются к обоим1117* **[Хуки](/docs/ru/hooks)** и **[скиллы](/docs/ru/skills)**, определённые в настройках, применяются к обоим

1080* **[Settings](/docs/ru/settings)** в `~/.claude.json` и `~/.claude/settings.json` общие. Правила разрешений, разрешённые инструменты и другие параметры в `settings.json` применяются к сеансам Desktop.1118* **[Настройки](/docs/ru/settings)** в `~/.claude.json` и `~/.claude/settings.json` общие. Правила разрешений, разрешённые инструменты и другие настройки в `settings.json` применяются к сессиям Desktop.

1081* **Models**: те же [модели](/docs/ru/model-config#available-models) доступны в обоих. В Desktop выберите модель из раскрывающегося списка рядом с кнопкой отправки. Вы можете изменить модель во время сеанса из того же раскрывающегося списка.1119* **Модели**: те же [модели](/docs/ru/model-config#available-models) доступны в обоих. В Desktop выберите модель из раскрывающегося списка рядом с кнопкой отправки. Вы можете изменить модель во время сессии из того же раскрывающегося списка.

1082 1120

1083<h4 id="mcp-servers-from-the-claude-desktop-chat-app">1121<h4 id="mcp-servers-from-the-claude-desktop-chat-app">

1084 MCP servers из приложения Claude Desktop chat1122 MCP-серверы из приложения Claude Desktop chat

1085</h4>1123</h4>

1086 1124

1087Приложение Desktop загружает MCP servers из `claude_desktop_config.json` в сеансы вкладки Code, наряду с серверами из `~/.claude.json` и `.mcp.json`. Сервер, определённый в `claude_desktop_config.json`, доступен как в поверхности Desktop chat, так и в локальных сеансах вкладки Code.1125Приложение Desktop загружает MCP-серверы из `claude_desktop_config.json` в локальные сессии вкладки Code, наряду с серверами из `~/.claude.json` и `.mcp.json`. Сервер, определённый в `claude_desktop_config.json`, доступен как в интерфейсе Desktop chat, так и в локальных сессиях вкладки Code.

1088 1126

1089Если вы определяете одно и то же имя сервера в `claude_desktop_config.json` и в `~/.claude.json` или `.mcp.json`, вкладка Code в локальных сеансах подключается один раз и использует определение `claude_desktop_config.json`.1127Если вы определяете одно и то же имя сервера в `claude_desktop_config.json` и в `~/.claude.json` или `.mcp.json`, вкладка Code в локальных сессиях подключается один раз и использует определение из `claude_desktop_config.json`.

1090 1128

1091Приложение также повторно доставляет stdio серверы из `~/.claude.json` встроенному CLI в локальных сеансах. Когда верхний уровень `~/.claude.json` (область пользователя) и `.mcp.json` определяют одно и то же имя stdio сервера, вкладка Code использует определение `~/.claude.json`, отступая от [иерархии области видимости](/docs/ru/mcp#scope-hierarchy-and-precedence) CLI.1129Приложение также повторно передаёт stdio-серверы из `~/.claude.json` встроенному CLI в локальных сессиях. Когда верхний уровень `~/.claude.json` (область действия пользователя) и `.mcp.json` определяют одно и то же имя stdio-сервера, вкладка Code использует определение из `~/.claude.json`, отступая от [иерархии областей действия](/docs/ru/mcp#scope-hierarchy-and-precedence) CLI.

1092 1130

1093<Note>1131<Note>

1094 Автономный CLI не читает `claude_desktop_config.json`. На macOS и WSL запустите `claude mcp add-from-claude-desktop`, чтобы скопировать эти серверы в `~/.claude.json`. См. [Импорт MCP servers из Claude Desktop](/docs/ru/mcp#import-mcp-servers-from-claude-desktop) для потока импорта и опций области видимости.1132 Автономный CLI не читает `claude_desktop_config.json`. На macOS и WSL запустите `claude mcp add-from-claude-desktop`, чтобы скопировать эти серверы в `~/.claude.json`. См. [Импорт MCP-серверов из Claude Desktop](/docs/ru/mcp#import-mcp-servers-from-claude-desktop) для процесса импорта и вариантов области действия.

1095</Note>1133</Note>

1096 1134

1097<h3 id="feature-comparison">1135<h3 id="feature-comparison">

1098 Сравнение функций1136 Сравнение функций

1099</h3>1137</h3>

1100 1138

1101Эта таблица сравнивает основные возможности между CLI и Desktop. Для полного списка флагов CLI см. [справочник CLI](/docs/ru/cli-reference).1139Эта таблица сравнивает основные возможности CLI и Desktop. Для полного списка флагов CLI см. [справочник CLI](/docs/ru/cli-reference).

1102 1140

1103| Функция | CLI | Desktop |1141| Функция | CLI | Desktop |

1104| - | - | - |1142| - | - | - |

1105| Режимы разрешений | Все режимы, включая `dontAsk` | Manual, Accept edits, Plan и Auto. Bypass permissions появляется в селекторе режима после того, как вы включите его: через переключатель Settings на планах Pro и Max, или через политику организации на планах Team и Enterprise |1143| Режимы разрешений | Все режимы, включая `dontAsk` | Manual, Accept edits, Plan и Auto. Bypass permissions появляется в селекторе режима после включения: через переключатель в Settings на планах Pro и Max или через политику организации на планах Team и Enterprise |

1106| [Сторонние провайдеры](/docs/ru/third-party-integrations) | Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry | Anthropic's API по умолчанию. Для маршрутизации через шлюз см. [подключение приложения desktop к шлюзу](/docs/ru/llm-gateway-connect#desktop-app). Чтобы запустить вкладку Code на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или самостоятельно размещённом шлюзе LLM, см. [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview). |1144| [Сторонние провайдеры](/docs/ru/third-party-integrations) | Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry | API Anthropic по умолчанию. Для маршрутизации через шлюз см. [подключение приложения desktop к шлюзу](/docs/ru/llm-gateway-connect#desktop-app). Чтобы запустить вкладку Code на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или самостоятельно размещённом LLM-шлюзе, см. [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview). |

1114| Использование компьютера | [Включение через `/mcp`](/docs/ru/computer-use) на macOS | [Управление приложениями и экраном](#let-claude-use-your-computer) на macOS и Windows |1152| Использование компьютера | [Включение через `/mcp`](/docs/ru/computer-use) на macOS | [Управление приложениями и экраном](#let-claude-use-your-computer) на macOS и Windows |

1115| iOS simulator | Управление симулятором через [computer use](/docs/ru/computer-use#test-a-simulator-flow) | [Панель iOS Simulator](/docs/ru/desktop-ios-simulator) открывается автоматически |1153| iOS simulator | Управление симулятором через [computer use](/docs/ru/computer-use#test-a-simulator-flow) | [Панель iOS Simulator](/docs/ru/desktop-ios-simulator) открывается автоматически |

1118 1156

1119<h3 id="what’s-not-available-in-desktop">1157<h3 id="what’s-not-available-in-desktop">

1122 1160

1123Следующие функции недоступны в Desktop, кроме случаев, указанных ниже:1161Следующие функции недоступны в Desktop, кроме случаев, указанных ниже:

1124 1162

1125* **Сторонние провайдеры**: Desktop подключается к API Anthropic по умолчанию. Для маршрутизации Desktop через шлюз или для запуска вкладки Code на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или самостоятельно размещённом шлюзе LLM, следуйте ссылкам в [строке Third-party providers](#feature-comparison).1163* **Сторонние провайдеры**: Desktop по умолчанию подключается к API Anthropic. Для маршрутизации Desktop через шлюз или для запуска вкладки Code на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или самостоятельно размещённом LLM-шлюзе следуйте ссылкам в [строке Third-party providers](#feature-comparison).

1126* **Linux (бета)**: Computer Use ещё недоступна в приложении desktop Linux. См. [Claude Desktop на Linux](/docs/ru/desktop-linux).1164* **Linux (бета)**: Computer Use пока недоступен в приложении desktop для Linux. См. [Claude Desktop на Linux](/docs/ru/desktop-linux).

1127* **Встроенные предложения кода**: Desktop не предоставляет предложения в стиле автодополнения. Это работает через разговорные подсказки и явные изменения кода.1165* **Встроенные предложения кода**: Desktop не предоставляет дополнения кода в стиле автодополнения. Он работает через промпты в диалоге и явные изменения кода и может [предложить ваш следующий промпт](#accept-a-suggested-prompt) после ответа Claude.

1128* **Команды агентов**: координируемые команды, где Claude как лидер команды назначает задачи товарищам по команде из общего списка задач, доступны в [CLI](/docs/ru/agent-teams), а не в Desktop. Для многоагентной работы внутри одного сеанса используйте [динамические рабочие процессы](/docs/ru/workflows), которые работают в Desktop; Claude также может [отправлять сообщения и управлять вашими другими сеансами](#work-across-sessions) напрямую.1166* **Команды агентов**: координируемые команды, где Claude в роли лидера команды назначает задачи участникам команды из общего списка задач, доступны в [CLI](/docs/ru/agent-teams), а не в Desktop. Для многоагентной работы внутри одной сессии используйте [динамические рабочие процессы](/docs/ru/workflows), которые работают в Desktop; Claude также может [отправлять сообщения вашим другим сессиям и управлять ими](#work-across-sessions) напрямую.

1129* **Команды диалога терминала**: встроенные команды, которые открывают интерактивную панель в терминале, ведут себя иначе на вкладке Code. Отредактируйте [файлы параметров](/docs/ru/settings) напрямую, чтобы управлять правилами разрешений и конфигурацией, или запустите команды из автономного CLI.1167* **Команды с диалоговыми окнами терминала**: встроенные команды, которые открывают интерактивную панель в терминале, ведут себя иначе на вкладке Code. Редактируйте [файлы настроек](/docs/ru/settings) напрямую, чтобы управлять правилами разрешений и конфигурацией, или запускайте команды из автономного CLI.

1130 * Команды без формы аргумента, такие как `/permissions`, отвечают с `isn't available in this environment`.1168 * Команды без формы с аргументом, такие как `/permissions`, отвечают `isn't available in this environment`.

1131 * `/config` открывает Settings → Claude Code. Текст после команды игнорируется, поэтому `/config theme=dark` не устанавливает тему.1169 * `/config` открывает Settings → Claude Code. Текст после команды игнорируется, поэтому `/config theme=dark` не устанавливает тему.

1132 1170

1133<h2 id="troubleshooting">1171<h2 id="troubleshooting">

1147 1185

1148Нажмите на номер версии, чтобы скопировать его в буфер обмена.1186Нажмите на номер версии, чтобы скопировать его в буфер обмена.

1149 1187

1188<h4 id="claude-code-version-in-the-code-tab">

1189 Версия Claude Code на вкладке Code

1190</h4>

1191

1192Чтобы узнать, какую версию Claude Code запускает сессия, введите `/status` в локальной сессии на вкладке **Code** и посмотрите строку **Claude Code**, в которой отображается версия, например `2.1.286`.

1193

1194Чтобы получить более новую версию для локальных сессий, откройте **Claude → Check for Updates** на macOS или **Help → Check for Updates** на Windows, затем запустите новую сессию.

1195

1196В локальной сессии вкладка **Code** запускает собственную копию Claude Code, у которой свой номер версии. Приложение desktop загружает и обновляет эту копию, поэтому её версия может отличаться от команды `claude` в вашем терминале, и обновление одной не обновляет другую.

1197

1150<h3 id="403-or-authentication-errors-in-the-code-tab">1198<h3 id="403-or-authentication-errors-in-the-code-tab">

1151 Ошибки 403 или аутентификации на вкладке Code1199 Ошибки 403 или аутентификации на вкладке Code

1152</h3>1200</h3>

desktop-quickstart.md +1 −1

Details

135 135

136**Поставьте Claude по расписанию.** Установите [scheduled tasks](/docs/ru/desktop-scheduled-tasks) для автоматического запуска Claude на регулярной основе: ежедневная проверка кода каждое утро, еженедельный аудит зависимостей или брифинг, который извлекает данные из ваших подключенных инструментов.136**Поставьте Claude по расписанию.** Установите [scheduled tasks](/docs/ru/desktop-scheduled-tasks) для автоматического запуска Claude на регулярной основе: ежедневная проверка кода каждое утро, еженедельный аудит зависимостей или брифинг, который извлекает данные из ваших подключенных инструментов.

137 137

138**Масштабируйте, когда будете готовы.** Откройте [parallel sessions](/docs/ru/desktop#work-in-parallel-with-sessions) на боковой панели, чтобы работать над несколькими задачами одновременно, при желании каждая в своем Git worktree, и откройте [tasks pane](/docs/ru/desktop#watch-background-tasks), чтобы наблюдать за субагентами и фоновыми командами, которые запускает сессия. Откройте [side chat](/docs/ru/desktop#ask-a-side-question-without-derailing-the-session), чтобы задать вопрос без отвлечения основного потока. Отправьте [long-running work to the cloud](/docs/ru/desktop#run-long-running-tasks-in-the-cloud), чтобы работа продолжалась, даже если вы закроете приложение, или [перенесите уже начатую сессию в облако](/docs/ru/desktop#continue-in-another-surface), если задача займет больше времени, чем ожидалось. [Connect external tools](/docs/ru/desktop#extend-claude-code), такие как GitHub, Slack и Linear, чтобы объединить ваш рабочий процесс.138**Масштабируйте, когда будете готовы.** Откройте [параллельные сессии](/docs/ru/desktop#work-in-parallel-with-sessions) на боковой панели, чтобы работать над несколькими задачами одновременно, при желании каждая в своем Git worktree, и откройте [панель задач](/docs/ru/desktop#watch-background-tasks), чтобы наблюдать за субагентами и фоновыми командами, которые запускает сессия. Откройте [боковой чат](/docs/ru/desktop#ask-a-side-question-without-derailing-the-session), чтобы задать вопрос без отвлечения основного потока. Отправьте [долгие задачи в облако](/docs/ru/desktop#run-long-running-tasks-in-the-cloud), чтобы работа продолжалась, даже если вы закроете приложение, или [перенесите уже начатую сессию в облако](/docs/ru/desktop#continue-in-another-surface), если задача займет больше времени, чем ожидалось. [Подключите внешние инструменты](/docs/ru/desktop#extend-claude-code), такие как GitHub, Slack и Linear, чтобы объединить ваш рабочий процесс.

139 139

140<h2 id="what’s-next">140<h2 id="what’s-next">

141 Что дальше141 Что дальше

desktop-scheduled-tasks.md +4 −4

Details

51 51

52Папка требуется перед сохранением задачи. Если вы еще не доверили эту папку, Desktop предложит вам доверить ее перед сохранением.52Папка требуется перед сохранением задачи. Если вы еще не доверили эту папку, Desktop предложит вам доверить ее перед сохранением.

53 53

54Вы также можете создать задачу, описав то, что вы хотите, в любом сеансе. Например, "set up a daily code review that runs every morning at 9am" создает повторяющуюся задачу, а "remind me at 3pm tomorrow to check the deploy" создает одноразовую задачу, которая отключается после срабатывания.54Вы также можете создать задачу, описав то, что вы хотите, в любом сеансе. Например, "настрой ежедневную проверку кода, которая запускается каждое утро в 9:00" создает повторяющуюся задачу, а "напомни мне завтра в 3 часа дня проверить развёртывание" создает одноразовую задачу, которая отключается после срабатывания.

55 55

56<h2 id="schedule-options">56<h2 id="schedule-options">

57 Параметры расписания57 Параметры расписания

65* **Weekdays**: то же самое, что Daily, но пропускает субботу и воскресенье65* **Weekdays**: то же самое, что Daily, но пропускает субботу и воскресенье

66* **Weekly**: показывает средство выбора времени и средство выбора дня66* **Weekly**: показывает средство выбора времени и средство выбора дня

67 67

68Для интервалов, которые средство выбора не предлагает, таких как каждые 15 минут, первое число каждого месяца или одноразовый запуск в определенное будущее время, попросите Claude в любом сеансе Desktop установить расписание. Используйте простой язык; например, "schedule a task to run all the tests every 6 hours."68Для интервалов, которые средство выбора не предлагает, таких как каждые 15 минут, первое число каждого месяца или одноразовый запуск в определенное будущее время, попросите Claude в любом сеансе Desktop установить расписание. Используйте простой язык; например, "запланируй задачу, которая запускает все тесты каждые 6 часов."

69 69

70<h2 id="how-scheduled-tasks-run">70<h2 id="how-scheduled-tasks-run">

71 Как запускаются запланированные задачи71 Как запускаются запланированные задачи

83 83

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

85 85

86Помните об этом при написании промптов. Задача, запланированная на 9 утра, может запуститься в 11 вечера, если ваш компьютер спал весь день. Если время имеет значение, добавьте защиту в сам промпт, например: "Only review today's commits. If it's after 5pm, skip the review and post a summary of what was missed."86Помните об этом при написании промптов. Задача, запланированная на 9 утра, может запуститься в 11 вечера, если ваш компьютер спал весь день. Если время имеет значение, добавьте защиту в сам промпт, например: "Проверяй только сегодняшние коммиты. Если уже позже 5 вечера, пропусти проверку и опубликуй сводку того, что было пропущено."

87 87

88<h2 id="permissions-for-scheduled-tasks">88<h2 id="permissions-for-scheduled-tasks">

89 Разрешения для запланированных задач89 Разрешения для запланированных задач

108* **Review allowed permissions**: увидеть и отозвать сохраненные одобрения инструментов для этой задачи из панели **Always allowed**108* **Review allowed permissions**: увидеть и отозвать сохраненные одобрения инструментов для этой задачи из панели **Always allowed**

109* **Delete**: удалить задачу и архивировать все сеансы, которые она создала. В диалоговом окне подтверждения появляется флажок **Also delete files on disk**; отметьте его, чтобы также удалить файл `SKILL.md` задачи и связанные данные из `~/.claude/scheduled-tasks/`.109* **Delete**: удалить задачу и архивировать все сеансы, которые она создала. В диалоговом окне подтверждения появляется флажок **Also delete files on disk**; отметьте его, чтобы также удалить файл `SKILL.md` задачи и связанные данные из `~/.claude/scheduled-tasks/`.

110 110

111Вы также можете перечислять, создавать, редактировать и приостанавливать задачи, попросив Claude в любом сеансе Desktop. Например, "pause my dependency-audit task" или "show me my scheduled tasks." Чтобы удалить задачу, используйте кнопку **Delete** на ее странице деталей.111Вы также можете перечислять, создавать, редактировать и приостанавливать задачи, попросив Claude в любом сеансе Desktop. Например, "приостанови мою задачу dependency-audit" или "покажи мои запланированные задачи." Чтобы удалить задачу, используйте кнопку **Delete** на ее странице деталей.

112 112

113Запланированная задача также может изменять свое собственное расписание или подсказку в рамках запущенного сеанса, используя инструмент MCP `update_scheduled_task`. Это позволяет задаче перепланировать себя на основе того, что она находит, например, перепланировать проверку кода на более раннее время, когда она обнаруживает, что была создана ветка выпуска.113Запланированная задача также может изменять свое собственное расписание или подсказку в рамках запущенного сеанса, используя инструмент MCP `update_scheduled_task`. Это позволяет задаче перепланировать себя на основе того, что она находит, например, перепланировать проверку кода на более раннее время, когда она обнаруживает, что была создана ветка выпуска.

114 114

env-vars.md +279 −276

Details

126 Переменные126 Переменные

127</h2>127</h2>

128 128

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

130 130

131<Note>131<Note>

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

133 133

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

135 135

140 * `FALLBACK_FOR_ALL_PRIMARY_MODELS`140 * `FALLBACK_FOR_ALL_PRIMARY_MODELS`

141 * `IS_DEMO`141 * `IS_DEMO`

142 142

143 У ещё одной переменной своё правило: `FORCE_HYPERLINK` читает число, поэтому отключает её только `0`. В строке каждой переменной также указано её собственное правило.143 Ещё одна переменная подчиняется собственному правилу: `FORCE_HYPERLINK` читает число, поэтому отключает её только `0`. В строке каждой переменной также указано её собственное правило.

144</Note>144</Note>

145 145

146| Переменная | Назначение |146| Переменная | Назначение |

147| :- | :- |147| :- | :- |

148| `ANTHROPIC_API_KEY` | API-ключ, отправляемый в заголовке `X-Api-Key`. Если он задан, этот ключ используется вместо вашей подписки Claude Pro, Max, Team или Enterprise, даже если вы вошли в систему. В неинтерактивном режиме (`-p`) ключ всегда используется, если он присутствует. В интерактивном режиме вам один раз будет предложено подтвердить ключ, прежде чем он заменит вашу подписку. Чтобы вместо этого использовать подписку, выполните `unset ANTHROPIC_API_KEY` |148| `ANTHROPIC_API_KEY` | API-ключ, отправляемый в заголовке `X-Api-Key`. Если задан, этот ключ используется вместо вашей подписки Claude Pro, Max, Team или Enterprise, даже если вы вошли в систему. В неинтерактивном режиме (`-p`) ключ всегда используется, если он задан. В интерактивном режиме вам будет предложено один раз подтвердить ключ, прежде чем он переопределит вашу подписку. Чтобы вместо этого использовать подписку, выполните `unset ANTHROPIC_API_KEY` |

149| `ANTHROPIC_AUTH_TOKEN` | Пользовательское значение заголовка `Authorization` (к заданному здесь значению будет добавлен префикс `Bearer `) |149| `ANTHROPIC_AUTH_TOKEN` | Пользовательское значение заголовка `Authorization` (к заданному здесь значению будет добавлен префикс `Bearer `) |

150| `ANTHROPIC_AWS_API_KEY` | API-ключ рабочего пространства для [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), созданный в AWS Console. Отправляется как `x-api-key` и имеет приоритет над AWS SigV4 |150| `ANTHROPIC_AWS_API_KEY` | API-ключ рабочего пространства для [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), созданный в AWS Console. Отправляется как `x-api-key` и имеет приоритет над AWS SigV4 |

151| `ANTHROPIC_AWS_BASE_URL` | Переопределяет URL эндпоинта [Claude Platform on AWS](/docs/ru/claude-platform-on-aws). Используйте для пользовательских регионов или при маршрутизации через [LLM-шлюз](/docs/ru/llm-gateway). По умолчанию `https://aws-external-anthropic.{region}.api.aws`. Claude Code определяет регион [с тем же приоритетом, что и в Amazon Bedrock](/docs/ru/amazon-bedrock#3-configure-claude-code) |151| `ANTHROPIC_AWS_BASE_URL` | Переопределяет URL эндпоинта [Claude Platform on AWS](/docs/ru/claude-platform-on-aws). Используйте для пользовательских регионов или при маршрутизации через [LLM-шлюз](/docs/ru/llm-gateway). По умолчанию `https://aws-external-anthropic.{region}.api.aws`. Claude Code определяет регион с [тем же приоритетом, что и в Amazon Bedrock](/docs/ru/amazon-bedrock#3-configure-claude-code) |

152| `ANTHROPIC_AWS_WORKSPACE_ID` | Обязательна для [Claude Platform on AWS](/docs/ru/claude-platform-on-aws). Отправляется в каждом запросе в заголовке `anthropic-workspace-id` |152| `ANTHROPIC_AWS_WORKSPACE_ID` | Обязательна для [Claude Platform on AWS](/docs/ru/claude-platform-on-aws). Отправляется в каждом запросе в заголовке `anthropic-workspace-id` |

153| `ANTHROPIC_BASE_URL` | Переопределяет эндпоинт API, чтобы направлять запросы через прокси или шлюз. Если задан хост, не принадлежащий Anthropic, [MCP tool search](/docs/ru/mcp#scale-with-mcp-tool-search) по умолчанию отключается. Задайте `ENABLE_TOOL_SEARCH=true`, если ваш прокси пересылает блоки `tool_reference`. Начиная с v2.1.196 [Remote Control](/docs/ru/remote-control#requirements) отключается, когда эта переменная указывает на хост, отличный от `api.anthropic.com`, как и на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry |153| `ANTHROPIC_BASE_URL` | Переопределяет эндпоинт API, чтобы направлять запросы через прокси или шлюз. Если задан хост, не принадлежащий Anthropic, [MCP tool search](/docs/ru/mcp#scale-with-mcp-tool-search) по умолчанию отключён. Задайте `ENABLE_TOOL_SEARCH=true`, если ваш прокси пересылает блоки `tool_reference`. Начиная с v2.1.196, [Remote Control](/docs/ru/remote-control#requirements) отключается, если эта переменная указывает на хост, отличный от `api.anthropic.com`, — так же, как в Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry |

154| `ANTHROPIC_BEDROCK_BASE_URL` | Переопределяет URL эндпоинта Amazon Bedrock. Используйте для пользовательских эндпоинтов Amazon Bedrock или при маршрутизации через [LLM-шлюз](/docs/ru/llm-gateway). См. [Amazon Bedrock](/docs/ru/amazon-bedrock) |154| `ANTHROPIC_BEDROCK_BASE_URL` | Переопределяет URL эндпоинта Amazon Bedrock. Используйте для пользовательских эндпоинтов Amazon Bedrock или при маршрутизации через [LLM-шлюз](/docs/ru/llm-gateway). См. [Amazon Bedrock](/docs/ru/amazon-bedrock) |

155| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Переопределяет URL эндпоинта Amazon Bedrock Mantle. См. [Эндпоинт Mantle](/docs/ru/amazon-bedrock#use-the-mantle-endpoint) |155| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Переопределяет URL эндпоинта Amazon Bedrock Mantle. См. [эндпоинт Mantle](/docs/ru/amazon-bedrock#use-the-mantle-endpoint) |

156| `ANTHROPIC_BEDROCK_REGION_PREFIX` | Префикс профиля межрегионального инференса (`us`, `eu`, `apac`, `jp`, `au` или `global`), который Claude Code пробует первым вместо префикса, определённого по региону AWS. Игнорируется в регионах AWS GovCloud. Требуется Claude Code v2.1.224 или новее. См. [Amazon Bedrock](/docs/ru/amazon-bedrock#cross-region-inference-profile-prefixes) |156| `ANTHROPIC_BEDROCK_REGION_PREFIX` | Префикс профиля межрегионального инференса (`us`, `eu`, `apac`, `jp`, `au` или `global`), который Claude Code пробует первым вместо префикса, определённого по региону AWS. Игнорируется в регионах AWS GovCloud. Требуется Claude Code v2.1.224 или новее. См. [Amazon Bedrock](/docs/ru/amazon-bedrock#cross-region-inference-profile-prefixes) |

157| `ANTHROPIC_BEDROCK_SERVICE_TIER` | [Уровень обслуживания](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html) Amazon Bedrock (`default`, `flex` или `priority`). Отправляется в заголовке `X-Amzn-Bedrock-Service-Tier`. См. [Amazon Bedrock](/docs/ru/amazon-bedrock#service-tiers) |157| `ANTHROPIC_BEDROCK_SERVICE_TIER` | [Уровень обслуживания](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html) Amazon Bedrock (`default`, `flex` или `priority`). Отправляется в заголовке `X-Amzn-Bedrock-Service-Tier`. См. [Amazon Bedrock](/docs/ru/amazon-bedrock#service-tiers) |

158| `ANTHROPIC_BETAS` | Список дополнительных значений заголовка `anthropic-beta` через запятую для включения в запросы API. Claude Code уже отправляет нужные ему бета-заголовки; используйте эту переменную, чтобы подключить [бета-функцию Anthropic API](https://platform.claude.com/docs/en/api/beta-headers) до того, как Claude Code добавит её встроенную поддержку. В отличие от [флага `--betas`](/docs/ru/cli-reference#cli-flags), который требует аутентификации по API-ключу, эта переменная работает со всеми методами аутентификации, включая подписку Claude.ai |158| `ANTHROPIC_BETAS` | Разделённый запятыми список дополнительных значений заголовка `anthropic-beta`, включаемых в запросы API. Claude Code уже отправляет нужные ему бета-заголовки; используйте эту переменную, чтобы подключить [бета-функцию Anthropic API](https://platform.claude.com/docs/en/api/beta-headers) до того, как Claude Code добавит её встроенную поддержку. В отличие от [флага `--betas`](/docs/ru/cli-reference#cli-flags), который требует аутентификации по API-ключу, эта переменная работает со всеми методами аутентификации, включая подписку Claude.ai |

159| `ANTHROPIC_CUSTOM_HEADERS` | Пользовательские заголовки для добавления к запросам (формат `Name: Value`, несколько заголовков разделяются переводом строки). Если имя или значение содержит символ, который не может передаваться в HTTP-заголовке, например фигурную кавычку или пробел нулевой ширины, запрос завершается ошибкой, указывающей пару по её позиции. Требуется Claude Code v2.1.227 или новее. В разделе [Invalid request header value](/docs/ru/errors#invalid-request-header-value) перечислен точный набор символов и указано, где выполняется проверка. Значение, задающее заголовок учётных данных, организации или тенанта, маршрутизации или поведения API, например `Authorization` или `Host`, считается [настройкой, требующей подтверждения](/docs/ru/server-managed-settings#environment-variables-and-the-approval-dialog), когда его доставляют серверные управляемые настройки. Из настроек проекта или локальных настроек такое значение подчиняется [правилам применения значений `env`](/docs/ru/settings-reference#when-claude-code-applies-env-values) |159| `ANTHROPIC_CUSTOM_HEADERS` | Пользовательские заголовки, добавляемые к запросам (формат `Name: Value`, несколько заголовков разделяются переводом строки). Если имя или значение содержит символ, который нельзя передать в HTTP-заголовке, например фигурную кавычку или пробел нулевой ширины, запрос завершается ошибкой, указывающей пару по её позиции. Требуется Claude Code v2.1.227 или новее. В разделе [Invalid request header value](/docs/ru/errors#invalid-request-header-value) перечислен точный набор символов и указано, где выполняется проверка. Значение, задающее заголовок учётных данных, организации или тенанта, маршрутизации или поведения API, например `Authorization` или `Host`, считается [настройкой, требующей подтверждения](/docs/ru/server-managed-settings#environment-variables-and-the-approval-dialog), когда его доставляют настройки, управляемые сервером. Из настроек проекта или локальных настроек такое значение подчиняется [правилам применения значений `env`](/docs/ru/settings-reference#when-claude-code-applies-env-values) |

160| `ANTHROPIC_CUSTOM_MODEL_OPTION` | ID модели, добавляемый как пользовательский пункт в меню выбора `/model`. Используйте, чтобы сделать доступной для выбора нестандартную модель или модель, специфичную для шлюза, не заменяя встроенные псевдонимы. См. [Конфигурация модели](/docs/ru/model-config#add-a-custom-model-option) |160| `ANTHROPIC_CUSTOM_MODEL_OPTION` | ID модели, добавляемой как пользовательский пункт в меню выбора `/model`. Используйте, чтобы сделать нестандартную или специфичную для шлюза модель доступной для выбора, не заменяя встроенные псевдонимы. См. [Конфигурация модели](/docs/ru/model-config#add-a-custom-model-option) |

161| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | Отображаемое описание пользовательского пункта модели в меню выбора `/model`. Если не задано, по умолчанию используется `Custom model (<model-id>)` |161| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | Отображаемое описание пользовательского пункта модели в меню выбора `/model`. Если не задано, по умолчанию используется `Custom model (<model-id>)` |

162| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | Отображаемое имя пользовательского пункта модели в меню выбора `/model`. Если не задано, пункт показывает название модели, если Claude Code [распознаёт ID](/docs/ru/model-config#customize-pinned-model-display-and-capabilities), а в противном случае — ID модели |162| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | Отображаемое имя пользовательского пункта модели в меню выбора `/model`. Если не задано, пункт показывает название модели, если Claude Code [распознаёт ID](/docs/ru/model-config#customize-pinned-model-display-and-capabilities), а иначе — ID модели |

163| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | Список [возможностей](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) через запятую, которые поддерживает пользовательская модель, например `effort,thinking`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |163| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | Разделённый запятыми список [возможностей](/docs/ru/model-config#customize-pinned-model-display-and-capabilities), которые поддерживает пользовательская модель, например `effort,thinking`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

164| `ANTHROPIC_DEFAULT_FABLE_MODEL` | ID модели, в который разрешается псевдоним `fable`, а также ID, который Claude Code распознаёт как модель Fable для [автоматического переключения на резервную модель](/docs/ru/model-config#automatic-model-fallback) у сторонних провайдеров. См. [Конфигурация модели](/docs/ru/model-config#environment-variables) |164| `ANTHROPIC_DEFAULT_FABLE_MODEL` | ID модели, в который разрешается псевдоним `fable`, а также ID, который Claude Code распознаёт как модель Fable для [автоматического переключения на резервную модель](/docs/ru/model-config#automatic-model-fallback) у сторонних провайдеров. См. [Конфигурация модели](/docs/ru/model-config#environment-variables) |

165| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | Отображаемое описание закреплённой модели Fable в меню выбора `/model`. Если не задано, в строке отображается описание по умолчанию, начинающееся с `Custom Fable model`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |165| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | Отображаемое описание закреплённой модели Fable в меню выбора `/model`. Если не задано, строка показывает описание по умолчанию, начинающееся с `Custom Fable model`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

166| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | Отображаемое имя закреплённой модели Fable в меню выбора `/model`. Если не задано, в строке отображается название модели, если Claude Code распознаёт закреплённый ID, а в противном случае — сам закреплённый ID. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |166| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | Отображаемое имя закреплённой модели Fable в меню выбора `/model`. Если не задано, строка показывает название модели, если Claude Code распознаёт закреплённый ID, а иначе — сам закреплённый ID. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

167| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | Список [возможностей](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) через запятую, которые поддерживает закреплённая модель Fable, например `effort,thinking`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |167| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | Разделённый запятыми список [возможностей](/docs/ru/model-config#customize-pinned-model-display-and-capabilities), которые поддерживает закреплённая модель Fable, например `effort,thinking`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

168| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | ID модели, в который разрешается псевдоним `haiku`; также используется для [фоновых функций](/docs/ru/costs#background-token-usage). См. [Конфигурация модели](/docs/ru/model-config#environment-variables) |168| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | ID модели, в который разрешается псевдоним `haiku`; также используется для [фоновых функций](/docs/ru/costs#background-token-usage). См. [Конфигурация модели](/docs/ru/model-config#environment-variables) |

169| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | Отображаемое описание закреплённой модели Haiku в меню выбора `/model`. Если не задано, в строке отображается описание по умолчанию, начинающееся с `Custom Haiku model`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |169| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | Отображаемое описание закреплённой модели Haiku в меню выбора `/model`. Если не задано, строка показывает описание по умолчанию, начинающееся с `Custom Haiku model`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

170| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | Отображаемое имя закреплённой модели Haiku в меню выбора `/model`. Если не задано, в строке отображается название модели, если Claude Code распознаёт закреплённый ID, а в противном случае — сам закреплённый ID. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |170| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | Отображаемое имя закреплённой модели Haiku в меню выбора `/model`. Если не задано, строка показывает название модели, если Claude Code распознаёт закреплённый ID, а иначе — сам закреплённый ID. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

171| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | Список [возможностей](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) через запятую, которые поддерживает закреплённая модель Haiku, например `effort,thinking`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |171| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | Разделённый запятыми список [возможностей](/docs/ru/model-config#customize-pinned-model-display-and-capabilities), которые поддерживает закреплённая модель Haiku, например `effort,thinking`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

172| `ANTHROPIC_DEFAULT_MODEL` | Модель, с которой по умолчанию запускаются новые сессии. Требуется Claude Code v2.1.236 или новее. См. [Задание модели по умолчанию для новых сессий](/docs/ru/model-config#set-a-default-model-for-new-sessions) |172| `ANTHROPIC_DEFAULT_MODEL` | Модель, с которой по умолчанию начинаются новые сессии. Требуется Claude Code v2.1.236 или новее. См. [Задание модели по умолчанию для новых сессий](/docs/ru/model-config#set-a-default-model-for-new-sessions) |

173| `ANTHROPIC_DEFAULT_OPUS_MODEL` | ID модели, в который разрешается псевдоним `opus` и который `opusplan` использует, пока активен режим планирования. См. [Конфигурация модели](/docs/ru/model-config#environment-variables) |173| `ANTHROPIC_DEFAULT_OPUS_MODEL` | ID модели, в который разрешается псевдоним `opus` и который `opusplan` использует, пока активен режим планирования. См. [Конфигурация модели](/docs/ru/model-config#environment-variables) |

174| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | Отображаемое описание закреплённой модели Opus в меню выбора `/model`. Если не задано, в строке отображается описание по умолчанию, начинающееся с `Custom Opus model`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |174| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | Отображаемое описание закреплённой модели Opus в меню выбора `/model`. Если не задано, строка показывает описание по умолчанию, начинающееся с `Custom Opus model`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

175| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | Отображаемое имя закреплённой модели Opus в меню выбора `/model`. Если не задано, в строке отображается название модели, если Claude Code распознаёт закреплённый ID, а в противном случае — сам закреплённый ID. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |175| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | Отображаемое имя закреплённой модели Opus в меню выбора `/model`. Если не задано, строка показывает название модели, если Claude Code распознаёт закреплённый ID, а иначе — сам закреплённый ID. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

176| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | Список [возможностей](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) через запятую, которые поддерживает закреплённая модель Opus, например `effort,thinking`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |176| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | Разделённый запятыми список [возможностей](/docs/ru/model-config#customize-pinned-model-display-and-capabilities), которые поддерживает закреплённая модель Opus, например `effort,thinking`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

177| `ANTHROPIC_DEFAULT_SONNET_MODEL` | ID модели, в который разрешается псевдоним `sonnet` и который `opusplan` использует, когда режим планирования не активен. См. [Конфигурация модели](/docs/ru/model-config#environment-variables) |177| `ANTHROPIC_DEFAULT_SONNET_MODEL` | ID модели, в который разрешается псевдоним `sonnet` и который `opusplan` использует, когда режим планирования не активен. См. [Конфигурация модели](/docs/ru/model-config#environment-variables) |

178| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | Отображаемое описание закреплённой модели Sonnet в меню выбора `/model`. Если не задано, в строке отображается описание по умолчанию, начинающееся с `Custom Sonnet model`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |178| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | Отображаемое описание закреплённой модели Sonnet в меню выбора `/model`. Если не задано, строка показывает описание по умолчанию, начинающееся с `Custom Sonnet model`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

179| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | Отображаемое имя закреплённой модели Sonnet в меню выбора `/model`. Если не задано, в строке отображается название модели, если Claude Code распознаёт закреплённый ID, а в противном случае — сам закреплённый ID. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |179| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | Отображаемое имя закреплённой модели Sonnet в меню выбора `/model`. Если не задано, строка показывает название модели, если Claude Code распознаёт закреплённый ID, а иначе — сам закреплённый ID. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

180| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | Список [возможностей](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) через запятую, которые поддерживает закреплённая модель Sonnet, например `effort,thinking`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |180| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | Разделённый запятыми список [возможностей](/docs/ru/model-config#customize-pinned-model-display-and-capabilities), которые поддерживает закреплённая модель Sonnet, например `effort,thinking`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

181| `ANTHROPIC_FEDERATION_RULE_ID` | ID правила федерации для [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Если вы задаёте её вместе с `ANTHROPIC_ORGANIZATION_ID`, Claude Code выбирает учётные данные федерации, которые имеют более высокий приоритет, чем учётные данные `/login`. См. [приоритет аутентификации](/docs/ru/authentication#authentication-precedence) |181| `ANTHROPIC_FEDERATION_RULE_ID` | ID правила федерации для [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Если вы задаёте её вместе с `ANTHROPIC_ORGANIZATION_ID`, Claude Code выбирает учётные данные федерации, которые имеют более высокий приоритет, чем учётные данные `/login`. См. [приоритет аутентификации](/docs/ru/authentication#authentication-precedence) |

182| `ANTHROPIC_FOUNDRY_API_KEY` | API-ключ для аутентификации в Microsoft Foundry (см. [Microsoft Foundry](/docs/ru/microsoft-foundry)) |182| `ANTHROPIC_FOUNDRY_API_KEY` | API-ключ для аутентификации в Microsoft Foundry (см. [Microsoft Foundry](/docs/ru/microsoft-foundry)) |

183| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | Bearer-токен для аутентификации в Microsoft Foundry, например токен доступа Microsoft Entra. Claude Code отправляет его в заголовке `Authorization: Bearer`. Имеет приоритет над `ANTHROPIC_FOUNDRY_API_KEY` и над цепочкой учётных данных Azure по умолчанию. См. [Microsoft Foundry](/docs/ru/microsoft-foundry). Требуется Claude Code v2.1.203 или новее |183| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | Bearer-токен для аутентификации в Microsoft Foundry, например токен доступа Microsoft Entra. Claude Code отправляет его в заголовке `Authorization: Bearer`. Имеет приоритет над `ANTHROPIC_FOUNDRY_API_KEY` и над цепочкой учётных данных Azure по умолчанию. См. [Microsoft Foundry](/docs/ru/microsoft-foundry). Требуется Claude Code v2.1.203 или новее |

185| `ANTHROPIC_FOUNDRY_RESOURCE` | Имя ресурса Microsoft Foundry (например, `my-resource`). Claude Code [отклоняет URL или имя хоста](/docs/ru/errors#anthropic-foundry-resource-must-be-a-foundry-resource-name). Обязательна, если не задана `ANTHROPIC_FOUNDRY_BASE_URL` (см. [Microsoft Foundry](/docs/ru/microsoft-foundry)) |185| `ANTHROPIC_FOUNDRY_RESOURCE` | Имя ресурса Microsoft Foundry (например, `my-resource`). Claude Code [отклоняет URL или имя хоста](/docs/ru/errors#anthropic-foundry-resource-must-be-a-foundry-resource-name). Обязательна, если не задана `ANTHROPIC_FOUNDRY_BASE_URL` (см. [Microsoft Foundry](/docs/ru/microsoft-foundry)) |

186| `ANTHROPIC_MODEL` | Имя используемой настройки модели (см. [Конфигурация модели](/docs/ru/model-config#environment-variables)) |186| `ANTHROPIC_MODEL` | Имя используемой настройки модели (см. [Конфигурация модели](/docs/ru/model-config#environment-variables)) |

187| `ANTHROPIC_ORGANIZATION_ID` | ID организации для [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Задавайте её вместе с `ANTHROPIC_FEDERATION_RULE_ID`. См. [приоритет аутентификации](/docs/ru/authentication#authentication-precedence) |187| `ANTHROPIC_ORGANIZATION_ID` | ID организации для [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Задавайте её вместе с `ANTHROPIC_FEDERATION_RULE_ID`. См. [приоритет аутентификации](/docs/ru/authentication#authentication-precedence) |

188| `ANTHROPIC_PROFILE` | Имя профиля Anthropic для аутентификации, например созданного командой [`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) или [входом в учётную запись Console без API-ключа](/docs/ru/authentication#sign-in-without-an-api-key). См. [приоритет аутентификации](/docs/ru/authentication#authentication-precedence) |188| `ANTHROPIC_PROFILE` | Имя профиля Anthropic для аутентификации, например созданного командой [`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) или при [входе в учётную запись Console без API-ключа](/docs/ru/authentication#sign-in-without-an-api-key). См. [приоритет аутентификации](/docs/ru/authentication#authentication-precedence) |

190| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Переопределяет регион AWS для модели класса Haiku при использовании Amazon Bedrock или Amazon Bedrock Mantle. В Amazon Bedrock действует только в том случае, если также задана `ANTHROPIC_DEFAULT_HAIKU_MODEL` или устаревшая `ANTHROPIC_SMALL_FAST_MODEL`, поскольку в противном случае Amazon Bedrock выполняет фоновые задачи на [модели Sonnet по умолчанию или основной модели](/docs/ru/amazon-bedrock#4-pin-model-versions) в регионе сессии |190| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Переопределяет регион AWS для модели класса Haiku при использовании Amazon Bedrock или Amazon Bedrock Mantle. В Amazon Bedrock действует только в том случае, если также задана `ANTHROPIC_DEFAULT_HAIKU_MODEL` или устаревшая `ANTHROPIC_SMALL_FAST_MODEL`, поскольку в противном случае Amazon Bedrock выполняет фоновые задачи на [модели Sonnet по умолчанию или основной модели](/docs/ru/amazon-bedrock#4-pin-model-versions) в регионе сессии |

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

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

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

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

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

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

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

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

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

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

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

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

203| `CLAUDE_AFK_COUNTDOWN_MS` | За сколько миллисекунд до автопродолжения на экране появляется обратный отсчёт в оставшемся без ответа диалоговом окне [`AskUserQuestion`](/docs/ru/tools-reference). По умолчанию `20000` (20 секунд), но не больше таймаута автопродолжения. Не действует, если автопродолжение не включено; см. настройку [`askUserQuestionTimeout`](/docs/ru/settings-reference#askuserquestiontimeout) и `CLAUDE_AFK_TIMEOUT_MS`. Требуется Claude Code v2.1.198 или новее |203| `CLAUDE_AFK_COUNTDOWN_MS` | За сколько миллисекунд до автопродолжения на экране появляется обратный отсчёт в оставленном без ответа диалоговом окне [`AskUserQuestion`](/docs/ru/tools-reference). По умолчанию `20000` (20 секунд), но не больше таймаута автопродолжения. Не действует, если автопродолжение не включено; см. настройку [`askUserQuestionTimeout`](/docs/ru/settings-reference#askuserquestiontimeout) и `CLAUDE_AFK_TIMEOUT_MS`. Требуется Claude Code v2.1.198 или новее |

204| `CLAUDE_AFK_TIMEOUT_MS` | Через сколько миллисекунд простоя оставшееся без ответа диалоговое окно [`AskUserQuestion`](/docs/ru/tools-reference) автоматически продолжает работу без вас. Автопродолжение по умолчанию отключено; включите его настройкой [`askUserQuestionTimeout`](/docs/ru/settings-reference#askuserquestiontimeout). Эта переменная — переопределение для демонстраций и автоматизированных тестов: если она задана, она имеет приоритет над этой настройкой и включает автопродолжение, даже если настройка не задана или равна `never`. Значение `0` не отключает таймаут, а сразу закрывает диалоговое окно. В v2.1.198 и v2.1.199 автопродолжение было включено по умолчанию с таймаутом `60000` (60 секунд). Требуется Claude Code v2.1.198 или новее |204| `CLAUDE_AFK_TIMEOUT_MS` | Через сколько миллисекунд простоя оставленное без ответа диалоговое окно [`AskUserQuestion`](/docs/ru/tools-reference) автоматически продолжает работу без вас. Автопродолжение по умолчанию отключено; включите его настройкой [`askUserQuestionTimeout`](/docs/ru/settings-reference#askuserquestiontimeout). Эта переменная — переопределение для демонстраций и автоматических тестов: если она задана, она имеет приоритет над этой настройкой и включает автопродолжение, даже когда настройка не задана или равна `never`. Значение `0` не отключает таймаут, а немедленно закрывает диалоговое окно. В v2.1.198 и v2.1.199 автопродолжение было включено по умолчанию с таймаутом `60000` (60 секунд). Требуется Claude Code v2.1.198 или новее |

205| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Задайте `1`, чтобы отключить все встроенные типы [субагентов](/docs/ru/sub-agents), такие как Explore и Plan. Применяется только в неинтерактивном режиме (флаг `-p`). Полезно пользователям SDK, которым нужен чистый лист. Это также удаляет `general-purpose` — субагента, которого Claude Code запускает, когда в вызове инструмента Agent опущен `subagent_type`. Такой вызов тогда завершается ошибкой [`subagent_type is required`](/docs/ru/errors#subagent-type-is-required) |205| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Задайте `1`, чтобы отключить все встроенные типы [субагентов](/docs/ru/sub-agents), такие как Explore и Plan. Применяется только в неинтерактивном режиме (флаг `-p`). Полезно для пользователей SDK, которым нужен чистый лист. Это также удаляет `general-purpose` — субагента, которого Claude Code запускает, когда в вызове инструмента Agent не указан `subagent_type`. В этом случае такой вызов завершается ошибкой [`subagent_type is required`](/docs/ru/errors#subagent-type-is-required) |

206| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Задайте `1`, чтобы не добавлять префикс `mcp__<server>__` к именам инструментов из MCP-серверов, созданных через SDK. Инструменты используют свои исходные имена. Только для использования SDK |206| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Задайте `1`, чтобы не добавлять префикс `mcp__<server>__` к именам инструментов из MCP-серверов, созданных через SDK. Инструменты используют свои исходные имена. Только при использовании SDK |

207| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Таймаут зависания субагентов в миллисекундах. По умолчанию `600000` (10 минут); если вы увеличите `CLAUDE_STREAM_IDLE_TIMEOUT_MS` при включённом сторожевом таймере потока, значение по умолчанию увеличится вместе с ней, как описано в разделе [Обработка медленных или зависших ответов API](/docs/ru/agent-sdk/typescript#handle-slow-or-stalled-api-responses). Таймер сбрасывается при каждом событии прогресса потоковой передачи; если в течение этого окна прогресс не поступает, Claude Code прерывает субагента и сообщает о зависании родительскому агенту |207| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Таймаут зависания субагентов в миллисекундах. По умолчанию `600000` (10 минут); если вы увеличиваете `CLAUDE_STREAM_IDLE_TIMEOUT_MS` при включённом сторожевом таймере потока, значение по умолчанию растёт вместе с ней, как описано в разделе [Обработка медленных или зависших ответов API](/docs/ru/agent-sdk/typescript#handle-slow-or-stalled-api-responses). Таймер сбрасывается при каждом событии прогресса потоковой передачи; если в течение этого окна прогресс не поступает, Claude Code прерывает субагента и сообщает о зависании родительскому агенту |

208| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Задаёт процент (1-100) окна автосжатия, при котором срабатывает автосжатие. Используйте более низкие значения, например `50`, чтобы сжимать раньше; переменная не может повысить порог, поэтому значения выше процента по умолчанию игнорируются. Применяется только в сессиях, которые [сжимаются до достижения предела контекста модели](/docs/ru/model-config#context-window-and-auto-compaction). Применяется как к основным диалогам, так и к субагентам |208| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Задаёт процент (1-100) окна автосжатия, при достижении которого срабатывает автосжатие. Используйте меньшие значения, например `50`, чтобы сжимать контекст раньше; переменная не может повысить порог, поэтому значения выше процента по умолчанию игнорируются. Применяется только в сессиях, которые [сжимаются до достижения лимита контекста модели](/docs/ru/model-config#context-window-and-auto-compaction). Применяется как к основным диалогам, так и к субагентам |

209| `CLAUDE_AUTO_BACKGROUND_TASKS` | Задайте `1`, чтобы принудительно включить автоматический перевод длительных задач агентов в фоновый режим. Когда эта функция включена, субагенты переводятся в фон примерно через две минуты работы. Также включает [автоматический перевод длительных вызовов MCP-инструментов в фон](/docs/ru/mcp#automatic-backgrounding-of-long-tool-calls) в неинтерактивном режиме в Claude Code v2.1.212 или новее |209| `CLAUDE_AUTO_BACKGROUND_TASKS` | Задайте `1`, чтобы принудительно включить автоматический перевод длительных задач агентов в фон. Когда это включено, субагенты переводятся в фон примерно через две минуты работы. Также включает [автоматический перевод в фон длительных вызовов инструментов MCP](/docs/ru/mcp#automatic-backgrounding-of-long-tool-calls) в неинтерактивном режиме в Claude Code v2.1.212 или новее |

210| `CLAUDE_AX_PREPARK_MS` | В [режиме программы чтения с экрана](/docs/ru/accessibility) — сколько миллисекунд Claude Code ждёт, прежде чем вывести новую или изменённую строку. По умолчанию `0`, поэтому Claude Code не ждёт. До v2.1.287 значение по умолчанию было `50`. Claude Code ограничивает ожидание значением `5000`. Требуется Claude Code v2.1.233 или новее |210| `CLAUDE_AX_PREPARK_MS` | В [режиме программы чтения с экрана](/docs/ru/accessibility) — сколько миллисекунд Claude Code ждёт, прежде чем вывести новую или изменённую строку. По умолчанию `0`, то есть Claude Code не ждёт. До v2.1.287 значение по умолчанию было `50`. Claude Code ограничивает ожидание значением `5000`. Требуется Claude Code v2.1.233 или новее |

211| `CLAUDE_AX_SCREEN_READER` | Задайте `1`, чтобы выводить текст, удобный для программ чтения с экрана: простой текст без декоративных рамок и анимаций. Задайте `0`, чтобы принудительно отключить режим программы чтения с экрана, даже если [`axScreenReader`](/docs/ru/settings-reference#axscreenreader) равно `true`. Флаг [`--ax-screen-reader`](/docs/ru/cli-reference#cli-flags) имеет приоритет. Требуется Claude Code v2.1.181 или новее |211| `CLAUDE_AX_SCREEN_READER` | Задайте `1`, чтобы выводить текст, удобный для программ чтения с экрана: простой текст без декоративных рамок и анимаций. Задайте `0`, чтобы принудительно отключить режим программы чтения с экрана, даже если [`axScreenReader`](/docs/ru/settings-reference#axscreenreader) равна `true`. Флаг [`--ax-screen-reader`](/docs/ru/cli-reference#cli-flags) имеет приоритет. Требуется Claude Code v2.1.181 или новее |

212| `CLAUDE_AX_STARTUP_QUIET_MS` | В [режиме программы чтения с экрана](/docs/ru/accessibility) — сколько миллисекунд Claude Code задерживает первую отрисовку интерфейса после строки подтверждения запуска, чтобы программа чтения с экрана успела полностью произнести эту строку, прежде чем её прервёт новый вывод. По умолчанию `3000`. Задайте `0` для немедленной отрисовки. Claude Code ограничивает задержку значением `600000` (10 минут). Первое нажатие клавиши досрочно завершает задержку. Требуется Claude Code v2.1.217 или новее |212| `CLAUDE_AX_STARTUP_QUIET_MS` | В [режиме программы чтения с экрана](/docs/ru/accessibility) — на сколько миллисекунд Claude Code задерживает первую отрисовку интерфейса после строки подтверждения запуска, чтобы программа чтения с экрана успела полностью озвучить эту строку, прежде чем её прервёт новый вывод. По умолчанию `3000`. Задайте `0` для немедленной отрисовки. Claude Code ограничивает задержку значением `600000` (10 минут). Первое нажатие клавиши досрочно завершает задержку. Требуется Claude Code v2.1.217 или новее |

213| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | Возвращаться в исходный рабочий каталог после каждой команды Bash или PowerShell в основной сессии |213| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | Возвращаться в исходный рабочий каталог после каждой команды Bash или PowerShell в основной сессии |

214| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | Таймаут в миллисекундах для сторожевого таймера простоя потоковой передачи на уровне байтов; если переменная задана, она имеет приоритет над `CLAUDE_STREAM_IDLE_TIMEOUT_MS` для этого таймера и не меняет сторожевой таймер на уровне событий. Claude Code ограничивает значение этой переменной диапазоном от 10 секунд до 30 минут. Требуется Claude Code v2.1.210 или новее |214| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | Таймаут в миллисекундах для сторожевого таймера простоя потоковой передачи на уровне байтов; если задана, имеет приоритет над `CLAUDE_STREAM_IDLE_TIMEOUT_MS` для этого сторожевого таймера и не меняет сторожевой таймер на уровне событий. Claude Code ограничивает значение этой переменной диапазоном от 10 секунд до 30 минут. Требуется Claude Code v2.1.210 или новее |

215| `CLAUDE_CLIENT_PRESENCE_FILE` | Путь к файлу, который внешний инструмент, например обработчик блокировки экрана, создаёт при разблокировке экрана и удаляет при его блокировке. Пока файл существует, Claude Code пропускает [мобильные push-уведомления Remote Control](/docs/ru/remote-control#mobile-push-notifications), поэтому вы перестаёте получать уведомления, пока активно пользуетесь компьютером. Если файл отсутствует или недоступен для чтения, уведомления отправляются как обычно. Claude Code проверяет файл один раз при каждом событии, вызывающем уведомление, а не опрашивает его постоянно. Требуется Claude Code v2.1.181 или новее |215| `CLAUDE_CLIENT_PRESENCE_FILE` | Путь к файлу, который внешний инструмент, например обработчик блокировки экрана, создаёт при разблокировке экрана и удаляет при его блокировке. Пока файл существует, Claude Code пропускает [мобильные push-уведомления Remote Control](/docs/ru/remote-control#mobile-push-notifications), поэтому вы не получаете уведомлений, пока активно пользуетесь компьютером. Если файл отсутствует или недоступен для чтения, уведомления отправляются как обычно. Claude Code проверяет файл один раз при каждом событии, вызывающем уведомление, а не опрашивает его постоянно. Требуется Claude Code v2.1.181 или новее |

216| `CLAUDE_CODE_ACCESSIBILITY` | Задайте `1`, чтобы нативный курсор терминала оставался видимым, а индикатор курсора с инвертированным текстом был отключён. Позволяет экранным лупам, например macOS Zoom, отслеживать положение курсора |216| `CLAUDE_CODE_ACCESSIBILITY` | Задайте `1`, чтобы нативный курсор терминала оставался видимым, а индикатор курсора в виде инвертированного текста был отключён. Позволяет экранным лупам, таким как Zoom в macOS, отслеживать положение курсора |

217| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | Задайте `1`, чтобы загружать файлы памяти из каталогов, указанных с помощью `--add-dir`. Загружаются `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` и `CLAUDE.local.md`. По умолчанию из дополнительных каталогов файлы памяти не загружаются |217| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | Задайте `1`, чтобы загружать файлы памяти из каталогов, указанных через `--add-dir`. Загружаются `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` и `CLAUDE.local.md`. По умолчанию файлы памяти из дополнительных каталогов не загружаются |

218| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | Задайте `1`, чтобы перерисовывать весь экран на каждом кадре в [полноэкранной отрисовке](/docs/ru/fullscreen) вместо отправки инкрементальных обновлений. Используйте, если в полноэкранном режиме отображаются устаревшие или смещённые фрагменты текста. Claude Code включает это автоматически для фоновых сессий и [представления агентов](/docs/ru/agent-view) в Windows |218| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | Задайте `1`, чтобы в [полноэкранной отрисовке](/docs/ru/fullscreen) перерисовывать весь экран в каждом кадре вместо отправки инкрементальных обновлений. Используйте, если в полноэкранном режиме отображаются устаревшие или смещённые фрагменты текста. Claude Code включает это автоматически для фоновых сессий и [представления агентов](/docs/ru/agent-view) в Windows |

219| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Задайте `1`, чтобы отправлять параметр [effort](/docs/ru/model-config#adjust-effort-level) с каждым запросом, даже если Claude Code не распознаёт ID модели как поддерживающий effort. Используйте при маршрутизации через [LLM-шлюз](/docs/ru/llm-gateway) или стороннего провайдера, который предоставляет модели под пользовательскими идентификаторами. Модели, которые отклоняют параметр effort на уровне API, включая модели Claude 3, Sonnet 4.0 и 4.5, Opus 4.0 и 4.1 и Haiku 4.5, по-прежнему исключаются, чтобы запросы не завершались ошибкой |219| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Задайте `1`, чтобы отправлять параметр [effort](/docs/ru/model-config#adjust-effort-level) с каждым запросом, даже если Claude Code не распознаёт ID модели как поддерживающий effort. Используйте при маршрутизации через [LLM-шлюз](/docs/ru/llm-gateway) или стороннего провайдера, который предоставляет модели под пользовательскими идентификаторами. Модели, которые отклоняют параметр effort на уровне API, включая модели Claude 3, Sonnet 4.0 и 4.5, Opus 4.0 и 4.1, а также Haiku 4.5, по-прежнему исключаются, чтобы запросы не завершались ошибкой |

220| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | Интервал в миллисекундах, с которым следует обновлять учётные данные (при использовании [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper)) |220| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | Интервал в миллисекундах, с которым следует обновлять учётные данные (при использовании [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper)) |

221| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | Задайте `0`, чтобы Claude Code не открывал браузер автоматически при публикации нового [артефакта](/docs/ru/artifacts#create-an-artifact) |221| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | Задайте `0`, чтобы Claude Code не открывал браузер автоматически при публикации нового [артефакта](/docs/ru/artifacts#create-an-artifact) |

222| `CLAUDE_CODE_ARTIFACT_COMMENTS` | Задайте `0`, чтобы Claude не читал [комментарии к артефакту](/docs/ru/artifacts#collect-comments-on-an-artifact) и не отвечал на них. Не действует, если `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` [отключила артефакты](/docs/ru/artifacts#availability). Требуется Claude Code v2.1.221 или новее |222| `CLAUDE_CODE_ARTIFACT_COMMENTS` | Задайте `0`, чтобы Claude не читал [комментарии к артефакту](/docs/ru/artifacts#collect-comments-on-an-artifact) и не отвечал на них. Не действует, если `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` [отключила артефакты](/docs/ru/artifacts#availability). Требуется Claude Code v2.1.221 или новее |

223| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | Задайте `0`, чтобы Claude не [отвечал самостоятельно на отправленные ему комментарии](/docs/ru/artifacts#let-claude-reply-to-comments-on-its-own). Требуется Claude Code v2.1.228 или новее |223| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | Задайте `0`, чтобы Claude не [отвечал самостоятельно на отправленные ему комментарии](/docs/ru/artifacts#let-claude-reply-to-comments-on-its-own). Требуется Claude Code v2.1.228 или новее |

224| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Задайте `0`, чтобы убрать из начала системного промпта [блок атрибуции](/docs/ru/llm-gateway-protocol#system-prompt-attribution-block), содержащий версию клиента и отпечаток промпта. Кэширование при прямом подключении к Anthropic API в любом случае не затрагивается. В некоторых конфигурациях с прямым подключением Claude Code сохраняет блок в запросах классификатора [авторежима](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode), даже если вы задали `0`. В разделе [Блок атрибуции системного промпта](/docs/ru/llm-gateway-protocol#system-prompt-attribution-block) проверьте, какие подключения и учётные данные это охватывает. До v2.1.181 блок содержал отдельный токен для каждого запроса при пользовательских базовых URL и подключениях к Microsoft Foundry, поэтому в этих версиях задавайте `0`, если ваш LLM-шлюз кэширует по телу запроса или пересылает запросы стороннему провайдеру, либо если вы подключаетесь к Microsoft Foundry напрямую |224| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Задайте `0`, чтобы исключить из начала системного промпта [блок атрибуции](/docs/ru/llm-gateway-protocol#system-prompt-attribution-block), который содержит версию клиента и отпечаток промпта. Кэширование при прямом подключении к Anthropic API в любом случае не затрагивается. В некоторых конфигурациях с прямым подключением Claude Code сохраняет блок в запросах классификатора [авторежима](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode), даже если вы задали `0`. В разделе [Блок атрибуции системного промпта](/docs/ru/llm-gateway-protocol#system-prompt-attribution-block) проверьте, каких подключений и учётных данных это касается. До v2.1.181 блок содержал уникальный для каждого запроса токен при пользовательских базовых URL и подключениях к Microsoft Foundry, поэтому в этих версиях задавайте `0`, если ваш LLM-шлюз кэширует по телу запроса или пересылает запросы стороннему провайдеру, либо если вы подключаетесь к Microsoft Foundry напрямую |

225| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | Удалена в v2.1.283. Используйте вместо неё `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` |225| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | Удалена в v2.1.283. Используйте вместо неё `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` |

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

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

228| `CLAUDE_CODE_AUTO_MODE_SERVER` | Определяет, просит ли Claude Code сервер [проверять действия авторежима](/docs/ru/permission-modes#server-side-classifier-review). Задайте `0`, чтобы вместо этого использовать собственные запросы классификатора Claude Code. При прямом подключении к Anthropic API требуется v2.1.281 или новее. В указанном разделе перечислено, какие сессии обращаются к серверу, когда переменная не задана, и начиная с какой версии. Требуется Claude Code v2.1.271 или новее |228| `CLAUDE_CODE_AUTO_MODE_SERVER` | Определяет, просит ли Claude Code сервер [проверять действия авторежима](/docs/ru/permission-modes#server-side-classifier-review). Задайте `0`, чтобы вместо этого использовать собственные запросы классификатора Claude Code. При прямом подключении к Anthropic API требуется v2.1.281 или новее. В указанном разделе перечислено, какие сессии обращаются к серверу, когда переменная не задана, и начиная с какой версии. Требуется Claude Code v2.1.271 или новее |

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

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

231| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | Задайте `0`, чтобы неинтерактивная сессия сообщала своему хосту статус простоя в конце каждого хода, даже если фоновая работа ещё выполняется. По умолчанию сессия продолжает сообщать статус выполнения после окончания хода, пока ещё идёт фоновая работа, например фоновый агент или запуск [рабочего процесса](/docs/ru/workflows). Это не позволяет хосту, отслеживающему статус, например списку удалённых сессий, объявить посреди работы, что Claude ждёт вашего ввода. Фоновые shell-команды, например dev-сервер, не удерживают статус выполнения. Статус выполнения по умолчанию и отключение через `0` требуют Claude Code v2.1.269 или новее; в более ранних версиях задайте `1`, чтобы удерживать статус выполнения |231| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | Задайте `0`, чтобы неинтерактивная сессия сообщала своему хосту статус простоя в конце каждого хода, даже пока ещё выполняется фоновая работа. По умолчанию сессия продолжает сообщать статус выполнения после окончания хода, пока фоновая работа, например фоновый агент или запуск [рабочего процесса](/docs/ru/workflows), ещё активна. Благодаря этому хост, отслеживающий статус, например список удалённых сессий, не объявляет посреди работы, что Claude ждёт вашего ввода. Фоновые shell-команды, например dev-сервер, не удерживают статус выполнения. Статус выполнения по умолчанию и отказ от него через `0` требуют Claude Code v2.1.269 или новее; в более ранних версиях задайте `1`, чтобы удерживать статус выполнения |

232| `CLAUDE_CODE_BRIDGE_SESSION_ID` | Задаётся автоматически в подпроцессах инструмента Bash и [команд хуков](/docs/ru/hooks), пока у сессии есть активное подключение [Remote Control](/docs/ru/remote-control), и удаляется при завершении подключения. Значение — ID сессии в форме `session_`, тот же идентификатор, что отображается в URL сессии `claude.ai/code`, поэтому скрипт может сослаться на запустившую его сессию. Требуется Claude Code v2.1.199 или новее. В [облачных сессиях](/docs/ru/claude-code-on-the-web) вместо неё читайте `CLAUDE_CODE_REMOTE_SESSION_ID` |232| `CLAUDE_CODE_BRIDGE_SESSION_ID` | Задаётся автоматически в подпроцессах инструмента Bash и [команд хуков](/docs/ru/hooks), пока у сессии есть активное подключение [Remote Control](/docs/ru/remote-control), и удаляется при завершении подключения. Значение — ID сессии в формате `session_`, тот же идентификатор, что отображается в URL `claude.ai/code` сессии, поэтому скрипт может сослаться на сессию, которая его запустила. Требуется Claude Code v2.1.199 или новее. В [облачных сессиях](/docs/ru/claude-code-on-the-web) используйте вместо неё `CLAUDE_CODE_REMOTE_SESSION_ID` |

233| `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE` | Задайте `0`, чтобы Claude Code считывал байт `0x08`, также записываемый как `^H`, как обычный Backspace, или `1`, чтобы считывать его как Ctrl+Backspace. Любое из значений заменяет поведение платформы по умолчанию. По умолчанию Claude Code считывает его как Ctrl+Backspace в Windows, кроме случаев, когда `TERM_PROGRAM` равно `mintty` или `TERM` равно `cygwin`, и как обычный Backspace в macOS и Linux. Задайте `0` в терминале Windows, где [Backspace удаляет целое слово](/docs/ru/terminal-config#fix-backspace-deleting-a-whole-word-on-windows) |233| `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE` | Задайте `0`, чтобы Claude Code читал байт `0x08`, также записываемый как `^H`, как обычный Backspace, или `1`, чтобы читать его как Ctrl+Backspace. Любое из значений заменяет значение по умолчанию для платформы. По умолчанию Claude Code читает его как Ctrl+Backspace в Windows, кроме случаев, когда `TERM_PROGRAM` равна `mintty` или `TERM` равна `cygwin`, и как обычный Backspace в macOS и Linux. Задайте `0` в терминале Windows, где [Backspace удаляет целое слово](/docs/ru/terminal-config#fix-backspace-deleting-a-whole-word-on-windows) |

234| `CLAUDE_CODE_CERT_STORE` | Список источников сертификатов CA для TLS-подключений через запятую. `bundled` — набор CA Mozilla, поставляемый с Claude Code. `system` — хранилище доверенных сертификатов операционной системы, которое читается только в средах выполнения с `tls.getCACertificates`: в нативном бинарном файле или в Node 22.15 или новее для установок через npm. См. [Хранилище сертификатов CA](/docs/ru/network-config#ca-certificate-store). По умолчанию `bundled,system` |234| `CLAUDE_CODE_CERT_STORE` | Разделённый запятыми список источников сертификатов CA для TLS-подключений. `bundled` — набор CA от Mozilla, поставляемый с Claude Code. `system` — хранилище доверенных сертификатов операционной системы, которое читается только в средах выполнения с `tls.getCACertificates`: в нативном бинарном файле или в Node 22.15 или новее при установке через npm. См. [Хранилище сертификатов CA](/docs/ru/network-config#ca-certificate-store). По умолчанию `bundled,system` |

235| `CLAUDE_CODE_CHILD_SESSION` | Имеет значение `1` в подпроцессах, которые Claude Code запускает через инструменты Bash, PowerShell и Monitor, команды [хуков](/docs/ru/hooks) и команды [строки состояния](/docs/ru/statusline). Не задаётся для подпроцессов stdio [MCP-серверов](/docs/ru/mcp), которые работают долго и переживают запустившую их сессию. В отличие от `CLAUDECODE`, эту переменную задаёт только сам Claude Code при запуске подпроцесса, а не расширения IDE, поэтому она надёжно отличает вложенную сессию от `claude` верхнего уровня, запущенного во встроенном терминале IDE. Вложенный интерактивный TUI `claude`, запущенный таким образом, автоматически исключается из `--resume`, `--continue`, истории по стрелке вверх и списка `claude agents`. Неинтерактивные сессии `claude -p` по-прежнему сохраняются. Задайте `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1`, чтобы отменить это исключение. Требуется Claude Code v2.1.172 или новее |235| `CLAUDE_CODE_CHILD_SESSION` | Устанавливается в `1` в подпроцессах, которые Claude Code запускает через инструменты Bash, PowerShell и Monitor, команды [хуков](/docs/ru/hooks) и команды [строки состояния](/docs/ru/statusline). Не задаётся для подпроцессов stdio [MCP-серверов](/docs/ru/mcp), которые работают долго и продолжают работать после завершения запустившей их сессии. В отличие от `CLAUDECODE`, эту переменную задаёт только сам Claude Code при запуске подпроцесса, а не расширения IDE, поэтому она надёжно отличает вложенную сессию от `claude` верхнего уровня, запущенного во встроенном терминале IDE. Вложенный интерактивный TUI `claude`, запущенный таким образом, автоматически исключается из `--resume`, `--continue`, истории по стрелке вверх и списка `claude agents`. Неинтерактивные сессии `claude -p` по-прежнему сохраняются. Задайте `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1`, чтобы отменить это исключение. Требуется Claude Code v2.1.172 или новее |

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

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

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

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

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

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

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

246| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Задайте `1`, чтобы отключить [фоновых агентов и представление агентов](/docs/ru/agent-view): `claude agents`, `--bg`, `/background` и супервизор, запускаемый по требованию. Эквивалентно настройке [`disableAgentView`](/docs/ru/settings-reference#disableagentview) |246| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Задайте `1`, чтобы отключить [фоновых агентов и представление агентов](/docs/ru/agent-view): `claude agents`, `--bg`, `/background` и супервизор, запускаемый по требованию. Эквивалентно настройке [`disableAgentView`](/docs/ru/settings-reference#disableagentview) |

247| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Задайте `1`, чтобы отключить [полноэкранную отрисовку](/docs/ru/fullscreen) и использовать классический рендерер основного экрана. Диалог остаётся в нативной истории прокрутки терминала, поэтому `Cmd+f` и режим копирования tmux работают как обычно. Имеет приоритет над `CLAUDE_CODE_NO_FLICKER` и настройкой [`tui`](/docs/ru/settings-reference#tui). Также можно переключиться командой `/tui default`. Не применяется к фоновым сессиям, открытым из [представления агентов](/docs/ru/agent-view), которые всегда используют полноэкранную отрисовку |247| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Задайте `1`, чтобы отключить [полноэкранную отрисовку](/docs/ru/fullscreen) и использовать классический рендерер основного экрана. Диалог остаётся в нативной истории прокрутки терминала, поэтому `Cmd+f` и режим копирования tmux работают как обычно. Имеет приоритет над `CLAUDE_CODE_NO_FLICKER` и настройкой [`tui`](/docs/ru/settings-reference#tui). Переключиться также можно командой `/tui default`. Не применяется к фоновым сессиям, открытым из [представления агентов](/docs/ru/agent-view), которые всегда используют полноэкранную отрисовку |

248| `CLAUDE_CODE_DISABLE_ARTIFACT` | Задайте `1`, чтобы отключить инструмент [Artifact](/docs/ru/artifacts), который публикует вывод сессии как приватную веб-страницу на claude.ai. После того как вы её задали, никакой файл настроек не сможет снова включить инструмент. Чтобы вместо этого отключить инструмент из файла настроек, задайте для [`enableArtifact`](/docs/ru/settings-reference#enableartifact) значение `false`; устаревший ключ [`disableArtifact`](/docs/ru/settings-reference#disableartifact) также отключает его |248| `CLAUDE_CODE_DISABLE_ARTIFACT` | Задайте `1`, чтобы отключить инструмент [Artifact](/docs/ru/artifacts), который публикует вывод сессии как приватную веб-страницу на claude.ai. После того как вы её зададите, никакой файл настроек не включит инструмент снова. Чтобы вместо этого отключить инструмент из файла настроек, задайте [`enableArtifact`](/docs/ru/settings-reference#enableartifact) значение `false`; устаревший ключ [`disableArtifact`](/docs/ru/settings-reference#disableartifact) также отключает его |

249| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Задайте `1`, чтобы отключить обработку вложений. Упоминания файлов с синтаксисом `@` отправляются как обычный текст, а не разворачиваются в содержимое файла |249| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Задайте `1`, чтобы отключить обработку вложений. Упоминания файлов с синтаксисом `@` отправляются как обычный текст, а не раскрываются в содержимое файла |

250| `CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK` | Задайте `1`, чтобы процесс Claude Code сам выполнял команду [`gcpAuthRefresh`](/docs/ru/settings-reference#gcpauthrefresh) или [`awsAuthRefresh`](/docs/ru/settings-reference#awsauthrefresh), а не ждал, пока её выполнит другой процесс. Требуется Claude Code v2.1.286 или новее |250| `CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK` | Задайте `1`, чтобы процесс Claude Code сам выполнял свою команду [`gcpAuthRefresh`](/docs/ru/settings-reference#gcpauthrefresh) или [`awsAuthRefresh`](/docs/ru/settings-reference#awsauthrefresh), а не ждал, пока её выполнит другой процесс. Требуется Claude Code v2.1.286 или новее |

251| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Задайте `1`, чтобы отключить [автоматическую память](/docs/ru/memory#auto-memory). Задайте `0`, чтобы принудительно включить автоматическую память, даже если режим `--bare` или [`autoMemoryEnabled: false`](/docs/ru/settings-reference#automemoryenabled) иначе отключили бы её. Когда она отключена, Claude не создаёт и не загружает файлы автоматической памяти |251| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Задайте `1`, чтобы отключить [автоматическую память](/docs/ru/memory#auto-memory). Задайте `0`, чтобы принудительно включить автоматическую память, даже если режим `--bare` или [`autoMemoryEnabled: false`](/docs/ru/settings-reference#automemoryenabled) иначе отключили бы её. Когда она отключена, Claude не создаёт и не загружает файлы автоматической памяти |

252| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Задайте `1`, чтобы отключить всю функциональность фоновых задач, включая параметр `run_in_background` в инструментах Bash и субагентов, автоматический перевод в фон и сочетание клавиш Ctrl+B |252| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Задайте `1`, чтобы отключить всю функциональность фоновых задач, включая параметр `run_in_background` в инструментах Bash и субагентов, автоматический перевод в фон и сочетание клавиш Ctrl+B |

253| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Задайте `1`, чтобы Claude Code не считал потоковый ответ [Amazon Bedrock](/docs/ru/amazon-bedrock) с отсутствующим или пустым заголовком `Content-Type` бинарным потоком событий Amazon Bedrock. По умолчанию Claude Code предполагает, что шлюз удалил заголовок из в остальном неизменённого ответа, поэтому декодирует тело, и потоковая передача продолжает работать. Задавайте эту переменную только для шлюза, который также повторно передаёт поток как server-sent events; тогда Claude Code читает тело без заголовка как server-sent events. Требуется Claude Code v2.1.239 или новее |253| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Задайте `1`, чтобы Claude Code не считал потоковый ответ [Amazon Bedrock](/docs/ru/amazon-bedrock) с отсутствующим или пустым заголовком `Content-Type` бинарным потоком событий Amazon Bedrock. По умолчанию Claude Code предполагает, что шлюз удалил заголовок из ответа, в остальном не изменённого, поэтому декодирует тело, и потоковая передача продолжает работать. Задавайте её только для шлюза, который также повторно выдаёт поток в виде server-sent events; тогда Claude Code читает тело без заголовка как server-sent events. Требуется Claude Code v2.1.239 или новее |

254| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Задайте `1`, чтобы пропустить проверку того, что потоковый ответ [Amazon Bedrock](/docs/ru/amazon-bedrock) имеет content-type `application/vnd.amazon.eventstream`. Без этой переменной, если ответ имеет другой content-type, Claude Code завершает запрос ошибкой с указанием этого типа, что означает, что [шлюз или прокси преобразует ответ](/docs/ru/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Вместо того чтобы задавать эту переменную, настройте шлюз так, чтобы он пересылал заголовок `Content-Type` и тело без изменений. Требуется Claude Code v2.1.208 или новее |254| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Задайте `1`, чтобы пропустить проверку того, что потоковый ответ [Amazon Bedrock](/docs/ru/amazon-bedrock) имеет content-type `application/vnd.amazon.eventstream`. Без этой переменной, если ответ имеет другой content-type, Claude Code завершает запрос ошибкой с указанием этого типа, что означает, что [шлюз или прокси преобразует ответ](/docs/ru/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Вместо того чтобы задавать эту переменную, настройте шлюз так, чтобы он пересылал заголовок `Content-Type` и тело без изменений. Требуется Claude Code v2.1.208 или новее |

255| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Задайте `1`, чтобы останавливать выполняющиеся фоновые shell-команды, динамические рабочие процессы и, начиная с v2.1.198, фоновых субагентов [фоновой сессии](/docs/ru/agent-view), когда [супервизор](/docs/ru/agent-view#the-supervisor-process) останавливает, перезапускает или обновляет процесс этой сессии, вместо того чтобы передавать их следующему процессу сессии. Влияет только на эту передачу: перевод сессии в фон с помощью `←` или [`/background`](/docs/ru/agent-view#from-inside-a-session) по-прежнему переносит выполняющуюся работу, а `CLAUDE_DISABLE_ADOPT` отключает и то, и другое. Требуется Claude Code v2.1.196 или новее |255| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Задайте `1`, чтобы выполняющиеся фоновые shell-команды и динамические рабочие процессы [фоновой сессии](/docs/ru/agent-view), а начиная с v2.1.198 и фоновые субагенты, останавливались, когда [супервизор](/docs/ru/agent-view#the-supervisor-process) останавливает, перезапускает или обновляет процесс этой сессии, а не передавались следующему процессу сессии. Влияет только на эту передачу: перевод сессии в фон с помощью `←` или [`/background`](/docs/ru/agent-view#from-inside-a-session) по-прежнему переносит незавершённую работу, а `CLAUDE_DISABLE_ADOPT` отключает и то и другое. Требуется Claude Code v2.1.196 или новее |

256| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Задайте `1`, чтобы Claude Code не завершал [фоновые shell-команды](/docs/ru/interactive-mode#background-bash-commands) при нехватке памяти. По умолчанию в macOS и Linux Claude Code завершает фоновые оболочки, когда операционная система сообщает о критической нехватке памяти, а сессия простаивает 30 минут без выполняющегося хода или субагента. В Windows нет сигнала о нехватке памяти, поэтому там эта переменная ни на что не влияет. Требуется Claude Code v2.1.193 или новее |256| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Задайте `1`, чтобы Claude Code не завершал [фоновые shell-команды](/docs/ru/interactive-mode#background-bash-commands) при нехватке памяти. По умолчанию в macOS и Linux Claude Code завершает фоновые оболочки, когда операционная система сообщает о критической нехватке памяти, а сессия простаивает 30 минут без выполняющегося хода или субагента. В Windows нет сигнала о нехватке памяти, поэтому там эта переменная ни на что не влияет. Требуется Claude Code v2.1.193 или новее |

257| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Задайте `1`, чтобы отключить [скиллы](/docs/ru/skills) и рабочие процессы, входящие в состав Claude Code: встроенные скиллы и рабочие процессы полностью удаляются, а встроенные команды, такие как `/init`, остаются доступными для ввода, но скрываются от модели. `/doctor` остаётся доступной для ввода, как и встроенные команды; чтобы скрыть её, используйте `DISABLE_DOCTOR_COMMAND`. Скиллы из плагинов, `.claude/skills/` и `.claude/commands/` не затрагиваются. Эквивалентно настройке [`disableBundledSkills`](/docs/ru/settings-reference#disablebundledskills) |257| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Задайте `1`, чтобы отключить [скиллы](/docs/ru/skills) и рабочие процессы, поставляемые с Claude Code: встроенные скиллы и рабочие процессы удаляются полностью, а встроенные команды, такие как `/init`, по-прежнему можно ввести, но они скрыты от модели. `/doctor`, как и встроенные команды, по-прежнему можно ввести; чтобы скрыть её, используйте `DISABLE_DOCTOR_COMMAND`. Скиллы из плагинов, `.claude/skills/` и `.claude/commands/` не затрагиваются. Эквивалентно настройке [`disableBundledSkills`](/docs/ru/settings-reference#disablebundledskills) |

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

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

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

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

262| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Задайте `1`, чтобы удалять из запросов API предварительные заголовки запроса `anthropic-beta`, связанные с ними поля тела и бета-поля схемы инструментов, такие как `defer_loading` и `eager_input_streaming`. Используйте, если прокси-шлюз отклоняет запросы с ошибкой `Unexpected value(s)` для заголовка `anthropic-beta` или ошибкой `Extra inputs are not permitted`. В разделе [Отключение предварительных возможностей](/docs/ru/llm-gateway-protocol#disable-pre-release-capabilities) перечислено, что удаляет переменная, включая [MCP tool search](/docs/ru/mcp#scale-with-mcp-tool-search), и что Claude Code продолжает отправлять |262| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Задайте `1`, чтобы удалять из запросов API предварительные заголовки `anthropic-beta`, связанные с ними поля тела запроса и поля бета-схемы инструментов, такие как `defer_loading` и `eager_input_streaming`. Используйте, когда прокси-шлюз отклоняет запросы с ошибкой `Unexpected value(s)` для заголовка `anthropic-beta` или с ошибкой `Extra inputs are not permitted`. В разделе [Отключение предварительных возможностей](/docs/ru/llm-gateway-protocol#disable-pre-release-capabilities) перечислено, что удаляет переменная, включая [MCP tool search](/docs/ru/mcp#scale-with-mcp-tool-search), и что Claude Code продолжает отправлять |

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

265| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Задайте `1`, чтобы отключить опросы о качестве сессии «How is Claude doing?». Опросы также отключаются, если задана `DISABLE_TELEMETRY`, `DO_NOT_TRACK` или `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, если только `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` снова не включает их. Чтобы задать частоту показа вместо полного отключения, используйте настройку [`feedbackSurveyRate`](/docs/ru/settings-reference#feedbacksurveyrate). См. [Опросы о качестве сессий](/docs/ru/data-usage#session-quality-surveys) |265| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Задайте `1`, чтобы отключить опросы о качестве сессии «How is Claude doing?». Опросы также отключаются, когда задана `DISABLE_TELEMETRY`, `DO_NOT_TRACK` или `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, если только `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` не включает их снова. Чтобы задать частоту выборки вместо полного отключения, используйте настройку [`feedbackSurveyRate`](/docs/ru/settings-reference#feedbacksurveyrate). См. [Опросы о качестве сессий](/docs/ru/data-usage#session-quality-surveys) |

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

267| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Задайте `1`, чтобы удалить из контекста Claude встроенные инструкции по рабочим процессам коммитов и PR, а также снимок git status. Полезно при использовании собственных скиллов для рабочего процесса git. Если задана, имеет приоритет над настройкой [`includeGitInstructions`](/docs/ru/settings-reference#includegitinstructions) |267| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Задайте `1`, чтобы удалить из контекста Claude встроенные инструкции по рабочему процессу коммитов и PR, а также снимок статуса git. Полезно, если вы используете собственные скиллы для рабочего процесса git. Если задана, имеет приоритет над настройкой [`includeGitInstructions`](/docs/ru/settings-reference#includegitinstructions) |

268| `CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT` | Задайте `1`, чтобы Claude Code не анализировал скрипты, передаваемые оболочке с `-c`, например `bash -c 'rm -rf ~'`, на предмет удаления [критических путей](/docs/ru/permission-modes#removals-inside-nested-commands-and-inline-scripts). Claude Code по-прежнему проверяет цели в виде переменных оболочки и позиционных параметров в таких скриптах, а остальные проверки критических путей продолжают работать. Задавайте её в окружении, из которого запускается Claude Code, поскольку Claude Code игнорирует копию, переданную через блок `env` настроек. Требуется Claude Code v2.1.288 или новее |268| `CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT` | Задайте `1`, чтобы Claude Code не проверял скрипты, передаваемые оболочке через `-c`, например `bash -c 'rm -rf ~'`, на удаление [критических путей](/docs/ru/permission-modes#removals-inside-nested-commands-and-inline-scripts). Claude Code по-прежнему проверяет цели в виде переменных оболочки и позиционных параметров в этих скриптах, а остальные проверки критических путей продолжают работать. Задавайте её в окружении, из которого запускается Claude Code, поскольку Claude Code игнорирует копию, доставленную через блок `env` настроек. Требуется Claude Code v2.1.288 или новее |

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

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

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

272| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | Задайте `1`, чтобы отключить обработку щелчков, перетаскивания и наведения в [полноэкранной отрисовке](/docs/ru/fullscreen), сохранив прокрутку колесом мыши. Используйте, если хотите, чтобы прокрутка колесом работала внутри Claude Code, но не хотите, чтобы щелчки перемещали курсор, разворачивали вывод инструментов или открывали ссылки. Если заданы обе переменные, приоритет имеет `CLAUDE_CODE_DISABLE_MOUSE`. Требуется Claude Code v2.1.195 или новее |272| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | Задайте `1`, чтобы отключить обработку щелчков, перетаскивания и наведения в [полноэкранной отрисовке](/docs/ru/fullscreen), сохранив прокрутку колёсиком мыши. Используйте, если хотите, чтобы прокрутка колёсиком работала внутри Claude Code, но не хотите, чтобы щелчки перемещали курсор, разворачивали вывод инструментов или открывали ссылки. Если заданы обе переменные, `CLAUDE_CODE_DISABLE_MOUSE` имеет приоритет. Требуется Claude Code v2.1.195 или новее |

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

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

275| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Задайте `1`, чтобы отключить резервный непотоковый вариант, когда потоковый запрос завершается сбоем посреди потока. Вместо этого ошибки потоковой передачи передаются на уровень повторных попыток. Полезно, когда из-за прокси или шлюза резервный вариант приводит к повторному выполнению инструментов |275| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Задайте `1`, чтобы отключить резервный непотоковый режим, когда потоковый запрос завершается сбоем посреди потока. Вместо этого ошибки потоковой передачи передаются на уровень повторных попыток. Полезно, когда из-за прокси или шлюза резервный вариант приводит к повторному выполнению инструментов |

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

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

278| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Задайте `1`, чтобы Claude Code не запускал ваши [хуки `Notification` для оставшихся без ответа запросов разрешений](/docs/ru/hooks#notification) в сессиях, где Claude Code отправляет такие запросы в callback `canUseTool` Agent SDK — именно так Claude Desktop и расширение VS Code размещают Claude Code. Не действует в сессиях терминала. Требуется Claude Code v2.1.233 или новее |278| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Задайте `1`, чтобы Claude Code не запускал ваши [хуки `Notification` для оставленных без ответа запросов разрешений](/docs/ru/hooks#notification) в сессиях, где Claude Code отправляет такие запросы в callback `canUseTool` Agent SDK — именно так Claude Desktop и расширение VS Code размещают Claude Code. Не действует в сессиях терминала. Требуется Claude Code v2.1.233 или новее |

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

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

281| `CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK` | Задайте `1`, чтобы отключить [автоматическое переключение модели, когда классификатор безопасности помечает запрос](/docs/ru/model-config#automatic-model-fallback) — поведение, которым управляет настройка [`switchModelsOnFlag`](/docs/ru/settings-reference#switchmodelsonflag) |281| `CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK` | Задайте `1`, чтобы отключить [автоматическое переключение модели, когда классификатор безопасности помечает запрос](/docs/ru/model-config#automatic-model-fallback), — поведение, которым управляет настройка [`switchModelsOnFlag`](/docs/ru/settings-reference#switchmodelsonflag) |

282| `CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS` | Задайте `1`, чтобы Claude Code не отправлял поле структурированного вывода `output_config.format` и связанное с ним значение `anthropic-beta` для [LLM-шлюза](/docs/ru/llm-gateway-protocol#feature-pass-through), вышестоящий сервис которого их отклоняет. Остальные предварительные возможности, которые отключает [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/ru/llm-gateway-protocol#disable-pre-release-capabilities), при этом остаются включёнными. Требуется Claude Code v2.1.288 или новее |282| `CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS` | Задайте `1`, чтобы Claude Code не отправлял поле структурированного вывода `output_config.format` и связанное с ним значение `anthropic-beta`, — для [LLM-шлюза](/docs/ru/llm-gateway-protocol#feature-pass-through), вышестоящий сервис которого их отклоняет. При этом остаются включёнными другие предварительные возможности, которые отключает [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/ru/llm-gateway-protocol#disable-pre-release-capabilities). Требуется Claude Code v2.1.288 или новее |

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

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

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

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

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

288| `CLAUDE_CODE_DISABLE_WEB_FETCH` | Задайте `1`, чтобы отключить инструмент [WebFetch](/docs/ru/tools-reference#webfetch-tool-behavior). Инструмент [WebSearch](/docs/ru/tools-reference#websearch-tool-behavior) остаётся доступным. Требуется Claude Code v2.1.285 или новее |288| `CLAUDE_CODE_DISABLE_WEB_FETCH` | Задайте `1`, чтобы отключить инструмент [WebFetch](/docs/ru/tools-reference#webfetch-tool-behavior). Инструмент [WebSearch](/docs/ru/tools-reference#websearch-tool-behavior) остаётся доступным. Требуется Claude Code v2.1.285 или новее |

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

290| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Задайте `1`, чтобы отключить [рабочие процессы](/docs/ru/workflows#turn-workflows-off). Эквивалентно настройке [`disableWorkflows`](/docs/ru/settings-reference#disableworkflows) |290| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Задайте `1`, чтобы отключить [рабочие процессы](/docs/ru/workflows#turn-workflows-off). Эквивалентно настройке [`disableWorkflows`](/docs/ru/settings-reference#disableworkflows) |

291| `CLAUDE_CODE_EFFORT_LEVEL` | Задаёт уровень effort для поддерживаемых моделей. Значения: `low`, `medium`, `high`, `xhigh`, `max` или `auto` для использования значения модели по умолчанию. Доступные уровни зависят от модели. Имеет приоритет над `--effort`, `/effort` и настройками `modelSettings` и `effortLevel`. Ограничение [`maxEffortLevel`](/docs/ru/settings-reference#maxeffortlevel) по-прежнему применяется. См. [Настройка уровня effort](/docs/ru/model-config#adjust-effort-level) |291| `CLAUDE_CODE_EFFORT_LEVEL` | Задаёт уровень effort для поддерживаемых моделей. Значения: `low`, `medium`, `high`, `xhigh`, `max` или `auto`, чтобы использовать значение модели по умолчанию. Доступные уровни зависят от модели. Имеет приоритет над `--effort`, `/effort` и настройками `modelSettings` и `effortLevel`. Ограничение [`maxEffortLevel`](/docs/ru/settings-reference#maxeffortlevel) по-прежнему применяется. См. [Настройка уровня effort](/docs/ru/model-config#adjust-effort-level) |

292| `CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS` | Задайте `1`, чтобы добавлять в поток сообщений сообщения [`session_state_changed`](/docs/ru/agent-sdk/typescript#sdksessionstatechangedmessage), содержащие состояние сессии. Требуется либо [Agent SDK](/docs/ru/agent-sdk/overview), либо `--print`, `--output-format stream-json` и `--verbose` |292| `CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS` | Задайте `1`, чтобы добавлять в поток сообщений сообщения [`session_state_changed`](/docs/ru/agent-sdk/typescript#sdksessionstatechangedmessage), которые содержат состояние сессии. Требуется либо [Agent SDK](/docs/ru/agent-sdk/overview), либо `--print`, `--output-format stream-json` и `--verbose` |

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

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

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

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

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

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

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

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

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

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

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

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

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

306| `CLAUDE_CODE_EXTRA_BODY` | JSON-объект, который объединяется с верхним уровнем тела каждого запроса к API. Полезно для передачи параметров, специфичных для провайдера, которые Claude Code не предоставляет напрямую. Значение, экспортированное в вашей оболочке, также применяется к [фоновым сессиям](/docs/ru/agent-view), которые вы запускаете с помощью `claude agents` или `--bg`. До v2.1.206 фоновые сессии игнорировали значение, экспортированное в оболочке, и использовали ту копию, которую унаследовал фоновый процесс-супервизор |306| `CLAUDE_CODE_EXTRA_BODY` | JSON-объект, который объединяется с верхним уровнем тела каждого API-запроса. Полезно для передачи специфичных для провайдера параметров, которые Claude Code не предоставляет напрямую. Значение, экспортированное в вашей оболочке, также применяется к [фоновым сессиям](/docs/ru/agent-view), которые вы запускаете с помощью `claude agents` или `--bg`. До v2.1.206 фоновые сессии игнорировали значение, экспортированное в оболочке, и использовали ту копию, которую унаследовал фоновый процесс-супервизор |

307| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Переопределяет лимит токенов по умолчанию для чтения файлов. Полезно, когда нужно прочитать большие файлы целиком |307| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Переопределяет лимит токенов по умолчанию для чтения файлов. Полезно, когда нужно прочитать большие файлы целиком |

308| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | Установите `1`, чтобы принудительно включить сохранение транскрипта, историю промптов и регистрацию в `claude agents`, даже если этот `claude` был запущен изнутри другой сессии Claude Code. Используйте, когда унаследованное значение `CLAUDE_CODE_CHILD_SESSION`, например из сессии `screen` или из фонового лаунчера, впервые запущенного инструментом Bash в Claude Code, приводит к тому, что настоящая сессия верхнего уровня ошибочно классифицируется как вложенная. Начиная с v2.1.178 Claude Code автоматически распознаёт случай с tmux и игнорирует унаследованный маркер, поэтому для tmux эта переменная больше не нужна. Также учитывается в v2.1.169 и более ранних версиях; не влияет на v2.1.170 и v2.1.171, где обнаружение вложенных сессий, которое она переопределяет, было удалено |308| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | Установите `1`, чтобы принудительно включить сохранение транскриптов, истории промптов и регистрацию в `claude agents`, даже если этот `claude` запущен изнутри другой сессии Claude Code. Используйте, когда унаследованное значение `CLAUDE_CODE_CHILD_SESSION`, например из сессии `screen` или фонового лаунчера, впервые запущенного инструментом Bash в Claude Code, приводит к тому, что настоящая сессия верхнего уровня ошибочно классифицируется как вложенная. Начиная с v2.1.178 Claude Code автоматически распознаёт случай tmux и игнорирует унаследованный маркер, поэтому для tmux эта переменная больше не нужна. Также учитывается в v2.1.169 и более ранних версиях; не действует в v2.1.170 и v2.1.171, где обнаружение вложенных сессий, которое она переопределяет, было удалено |

309| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | Установите `1`, чтобы принудительно отображать `~~text~~` в ответах Claude зачёркнутым текстом, когда ваш терминал это поддерживает, но не определяется автоматически, например при работе через SSH без передачи `TERM_PROGRAM`. Без этого нераспознанные терминалы показывают буквальные маркеры `~~` вместо зачёркнутого текста. Требуется Claude Code v2.1.186 или новее |309| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | Установите `1`, чтобы принудительно отображать `~~text~~` в ответах Claude зачёркнутым текстом, когда ваш терминал это поддерживает, но не определяется автоматически, например при работе по SSH без пересылки `TERM_PROGRAM`. Без этого в неопределённых терминалах отображаются сами маркеры `~~` вместо зачёркнутого текста. Требуется Claude Code v2.1.186 или новее |

310| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Установите `1`, чтобы принудительно включить [синхронизированный вывод](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) DEC private mode 2026, когда ваш терминал его поддерживает, но не определяется автоматически. Полезно для эмуляторов, таких как Emacs `eat`, которые реализуют BSU/ESU, но не отвечают на проверку возможностей. Не действует под tmux. В отличие от `CLAUDE_CODE_NO_FLICKER`, которая переключает на [полноэкранную отрисовку](/docs/ru/fullscreen), эта переменная не меняет механизм отрисовки |310| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Установите `1`, чтобы принудительно включить [синхронизированный вывод](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) DEC private mode 2026, когда ваш терминал его поддерживает, но не определяется автоматически. Полезно для эмуляторов, таких как Emacs `eat`, которые реализуют BSU/ESU, но не отвечают на проверку возможностей. Не действует под tmux. В отличие от `CLAUDE_CODE_NO_FLICKER`, которая переключает на [полноэкранный рендеринг](/docs/ru/fullscreen), эта переменная не меняет средство отрисовки |

311| `CLAUDE_CODE_FORK_SUBAGENT` | Управляет [режимом ветвления](/docs/ru/sub-agents#turn-fork-mode-on-or-off), который позволяет Claude самостоятельно создавать [ответвлённых субагентов](/docs/ru/sub-agents#fork-the-current-conversation) и по умолчанию включён только в интерактивных сессиях. Установите `1`, чтобы включить его также в `claude -p` и Agent SDK, или `0`, чтобы отключить его во всех типах сессий. Вы можете выполнять `/subtask` независимо от того, включён ли режим ветвления. Значение по умолчанию для интерактивного режима требует Claude Code v2.1.232 или новее; в более ранних версиях установите переменную в `1`, чтобы включить режим ветвления |311| `CLAUDE_CODE_FORCE_TERMINAL_IMAGES` | Установите `1`, чтобы отрисовывать [элементы `Image` модов](/docs/ru/plugins/mods/reference#elements) как изображения, когда ваш терминал отображает изображения протокола графики kitty с Unicode-заполнителями, но не определяется автоматически. См. [какие терминалы определяет Claude Code](/docs/ru/plugins/mods/gallery#image-and-client) и почему это не помогает внутри tmux или screen |

312| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | Установите `1`, чтобы выводить текст и блоки размышлений [субагентов](/docs/ru/sub-agents) в выходных данных `claude -p --output-format stream-json` — то же поведение, что и у флага [`--forward-subagent-text`](/docs/ru/cli-reference#cli-flags). Используйте переменную, когда оболочка-обвязка вызывает `claude` и не может передать флаг самостоятельно. В отличие от флага, который завершается с ошибкой вне неинтерактивного режима с выводом stream-json, переменная в таких случаях игнорируется, чтобы вложенные вызовы продолжали работать, когда она задана для всего процесса. Требуется Claude Code v2.1.211 или новее |312| `CLAUDE_CODE_FORK_SUBAGENT` | Управляет [режимом форка](/docs/ru/sub-agents#turn-fork-mode-on-or-off), который позволяет Claude самостоятельно запускать [форкнутых субагентов](/docs/ru/sub-agents#fork-the-current-conversation) и по умолчанию включён только в интерактивных сессиях. Установите `1`, чтобы включить его также в `claude -p` и Agent SDK, или `0`, чтобы отключить его во всех видах сессий. Вы можете запускать `/subtask` независимо от того, включён ли режим форка. Значение по умолчанию для интерактивных сессий требует Claude Code v2.1.232 или новее; в более ранних версиях установите переменную в `1`, чтобы включить режим форка |

313| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | Установите `1`, чтобы отправлять [заголовки-подсказки для шлюза](/docs/ru/llm-gateway-protocol#gateway-hint-headers), такие как `x-claude-code-request-class` и `x-claude-code-compaction`, при использовании собственного прокси или стороннего провайдера, например Amazon Bedrock или Claude Platform on AWS. Установите `0`, чтобы прекратить их отправку при любом подключении, включая прямое подключение к Anthropic API, где Claude Code отправляет их по умолчанию. Требуется Claude Code v2.1.273 или новее |313| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | Установите `1`, чтобы выводить текст и блоки размышлений [субагентов](/docs/ru/sub-agents) в выводе `claude -p --output-format stream-json` — так же, как это делает флаг [`--forward-subagent-text`](/docs/ru/cli-reference#cli-flags). Используйте переменную, когда обвязка вызывает `claude` и не может сама передать флаг. В отличие от флага, который завершается с ошибкой вне неинтерактивного режима с выводом stream-json, переменная в таких случаях игнорируется, чтобы вложенные вызовы продолжали работать, когда она задана для всего процесса. Требуется Claude Code v2.1.211 или новее |

314| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | Таймаут в миллисекундах для запроса [обнаружения моделей шлюза](/docs/ru/llm-gateway-protocol#model-discovery), который включает `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` (по умолчанию: `3000`). Увеличьте его, если вашему шлюзу требуется больше трёх секунд, чтобы ответить на `/v1/models` при запуске. Принимаются только цифры; `0`, отрицательные значения и другие варианты записи оставляют значение по умолчанию. Требуется Claude Code v2.1.269 или новее |314| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | Установите `1`, чтобы отправлять [заголовки-подсказки для шлюза](/docs/ru/llm-gateway-protocol#gateway-hint-headers), такие как `x-claude-code-request-class` и `x-claude-code-compaction`, через пользовательский прокси или стороннего провайдера, например Amazon Bedrock или Claude Platform on AWS. Установите `0`, чтобы прекратить их отправку при любом подключении, включая прямое подключение к Anthropic API, где Claude Code отправляет их по умолчанию. Требуется Claude Code v2.1.273 или новее |

315| `CLAUDE_CODE_GIT_BASH_PATH` | Только для Windows: путь к исполняемому файлу Git Bash (`bash.exe`). Используйте, когда Git Bash установлен, но отсутствует в PATH. Если путь не существует или файл не называется `bash.exe`, `sh.exe`, `bash` или `sh`, Claude Code игнорирует переменную и определяет Git Bash автоматически, как если бы она не была задана, записывая в лог предупреждение, видимое с `--debug`. До v2.1.219 Claude Code завершал работу при запуске, если путь не существовал, и использовал любой существующий файл в качестве оболочки, не проверяя, является ли он bash или sh. См. [Настройка в Windows](/docs/ru/setup#set-up-on-windows) |315| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | Таймаут в миллисекундах для запроса [обнаружения моделей шлюза](/docs/ru/llm-gateway-protocol#model-discovery), который включает `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` (по умолчанию: `3000`). Увеличьте его, если вашему шлюзу требуется больше трёх секунд, чтобы ответить на `/v1/models` при запуске. Принимает только цифры; `0`, отрицательные значения и другие формы записи оставляют значение по умолчанию. Требуется Claude Code v2.1.269 или новее |

316| `CLAUDE_CODE_GLOB_HIDDEN` | Установите `false`, чтобы исключить dot-файлы из результатов, когда Claude вызывает [инструмент Glob](/docs/ru/tools-reference#glob-tool-behavior). По умолчанию они включаются. Не влияет на автодополнение файлов через `@`, `ls`, Grep или Read |316| `CLAUDE_CODE_GIT_BASH_PATH` | Только Windows: путь к исполняемому файлу Git Bash (`bash.exe`). Используйте, когда Git Bash установлен, но отсутствует в PATH. Если путь не существует или файл не называется `bash.exe`, `sh.exe`, `bash` или `sh`, Claude Code игнорирует переменную и автоматически определяет Git Bash, как если бы она не была задана, записывая в лог предупреждение, видимое с `--debug`. До v2.1.219 Claude Code завершал работу при запуске, если путь не существовал, и использовал любой существующий файл в качестве оболочки, не проверяя, что это bash или sh. См. [Настройка в Windows](/docs/ru/setup#set-up-on-windows) |

317| `CLAUDE_CODE_GLOB_NO_IGNORE` | Установите `false`, чтобы [инструмент Glob](/docs/ru/tools-reference#glob-tool-behavior) учитывал шаблоны `.gitignore`. По умолчанию Glob возвращает все подходящие файлы, включая игнорируемые Git. Не влияет на автодополнение файлов через `@`, у которого есть собственная [настройка `respectGitignore`](/docs/ru/settings-reference#respectgitignore) |317| `CLAUDE_CODE_GLOB_HIDDEN` | Установите `false`, чтобы исключать dot-файлы из результатов, когда Claude вызывает [инструмент Glob](/docs/ru/tools-reference#glob-tool-behavior). По умолчанию они включаются. Не влияет на автодополнение файлов через `@`, `ls`, Grep или Read |

318| `CLAUDE_CODE_GLOB_NO_IGNORE` | Установите `false`, чтобы [инструмент Glob](/docs/ru/tools-reference#glob-tool-behavior) учитывал шаблоны `.gitignore`. По умолчанию Glob возвращает все подходящие файлы, включая игнорируемые git. Не влияет на автодополнение файлов через `@`, у которого есть собственная [настройка `respectGitignore`](/docs/ru/settings-reference#respectgitignore) |

318| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Таймаут в секундах для поиска файлов инструментом Glob. По умолчанию 20 секунд на большинстве платформ и 60 секунд в WSL |319| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Таймаут в секундах для поиска файлов инструментом Glob. По умолчанию 20 секунд на большинстве платформ и 60 секунд в WSL |

319| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | Сколько минут фоновая работа может удерживать активную цель в ожидании, прежде чем Claude Code [попросит Claude проверить её](/docs/ru/goal#background-work-defers-evaluation). По умолчанию `30`. Установите `0`, чтобы отключить проверки. Указывайте целое число минут цифрами, не более `10080`, что соответствует одной неделе. Любое другое значение Claude Code считает незаданным и использует значение по умолчанию. Требуется Claude Code v2.1.234 или новее |320| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | Сколько минут фоновая работа может держать активную цель в ожидании, прежде чем Claude Code [попросит Claude проверить её](/docs/ru/goal#background-work-defers-evaluation). По умолчанию `30`. Установите `0`, чтобы отключить проверки. Указывайте целое число минут только цифрами, не более `10080`, что составляет одну неделю. Любое другое значение Claude Code считает незаданным и использует значение по умолчанию. Требуется Claude Code v2.1.234 или новее |

320| `CLAUDE_CODE_GZIP_REQUEST_BODIES` | Установите `0`, чтобы отключить gzip-сжатие тел запросов к Claude API, запросов телеметрии и запросов публикации [артефактов](/docs/ru/artifacts), отправляемых на `api.anthropic.com`. По умолчанию Claude Code сжимает большие тела запросов при прямых подключениях и пропускает сжатие, когда вы отправляете запросы через прокси, настраиваете клиентский сертификат или задаёте `NODE_EXTRA_CA_CERTS`. Используйте `0`, если [прокси с инспекцией TLS](/docs/ru/network-config#ca-certificate-store), который Claude Code не может обнаружить, неправильно обрабатывает сжатые запросы |321| `CLAUDE_CODE_GZIP_REQUEST_BODIES` | Установите `0`, чтобы отключить gzip-сжатие тел запросов к Claude API, запросов телеметрии и запросов публикации [артефактов](/docs/ru/artifacts), отправляемых на `api.anthropic.com`. По умолчанию Claude Code сжимает большие тела запросов при прямых подключениях и пропускает сжатие, когда вы отправляете запросы через прокси, настраиваете клиентский сертификат или задаёте `NODE_EXTRA_CA_CERTS`. Используйте `0`, если [прокси с инспекцией TLS](/docs/ru/network-config#ca-certificate-store), который Claude Code не может обнаружить, неправильно обрабатывает сжатые запросы |

321| `CLAUDE_CODE_HIDE_CWD` | Установите `1`, чтобы скрыть рабочий каталог в логотипе при запуске. Полезно при демонстрации экрана или записи, когда путь раскрывает имя пользователя ОС |322| `CLAUDE_CODE_HIDE_CWD` | Установите `1`, чтобы скрыть рабочий каталог на логотипе при запуске. Полезно при демонстрации экрана или записи, когда путь раскрывает имя пользователя ОС |

322| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Переопределяет адрес хоста, используемый для подключения к расширению IDE. По умолчанию Claude Code автоматически определяет правильный адрес, включая маршрутизацию из WSL в Windows |323| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Переопределяет адрес хоста, используемый для подключения к расширению IDE. По умолчанию Claude Code автоматически определяет правильный адрес, включая маршрутизацию из WSL в Windows |

323| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Установите `1`, чтобы пропустить автоматическую установку расширений IDE. Эквивалентно установке [`autoInstallIdeExtension`](/docs/ru/settings-reference#autoinstallideextension) в `false` |324| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Установите `1`, чтобы пропустить автоматическую установку расширений IDE. Эквивалентно установке [`autoInstallIdeExtension`](/docs/ru/settings-reference#autoinstallideextension) в `false` |

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

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

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

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

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

329| `CLAUDE_CODE_MAX_RETRIES` | Переопределяет количество повторных попыток для неудачных запросов к API (по умолчанию: 10). Начиная с v2.1.186 ограничено значением 15; начиная с v2.1.199 `CLAUDE_CODE_RETRY_WATCHDOG` повышает значение по умолчанию и снимает ограничение. Для автономных сессий, которым нужно переждать более длительные сбои, вместо этого задайте `CLAUDE_CODE_RETRY_WATCHDOG` |330| `CLAUDE_CODE_MAX_RETRIES` | Переопределяет количество повторных попыток для неудачных API-запросов (по умолчанию: 10). Начиная с v2.1.186 ограничено значением 15; начиная с v2.1.199 `CLAUDE_CODE_RETRY_WATCHDOG` повышает значение по умолчанию и снимает ограничение. Для автономных сессий, которым нужно переждать более длительные сбои, вместо этого задайте `CLAUDE_CODE_RETRY_WATCHDOG` |

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

331| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | Количество [уровней субагентов](/docs/ru/sub-agents#let-subagents-spawn-their-own-subagents), допустимых ниже основного диалога (по умолчанию: 3). При значении по умолчанию субагенты могут создавать собственных субагентов, а субагент на третьем уровне уже не может создавать новых; установите `1`, чтобы отключить вложенность. В версиях с v2.1.217 по v2.1.218 значение по умолчанию было 1, поэтому субагент не мог создать собственного, если вы не повышали ограничение; в v2.1.219 значение по умолчанию было повышено до 3. Принимает положительное целое число, записанное цифрами; всё остальное игнорируется, поэтому ограничение можно изменить, но нельзя снять. Требуется Claude Code v2.1.217 или новее |332| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | Количество [уровней субагентов](/docs/ru/sub-agents#let-subagents-spawn-their-own-subagents), разрешённых ниже основного диалога (по умолчанию: 3). При значении по умолчанию субагенты могут запускать собственных субагентов, а субагент на третьем уровне уже не может запускать новых; установите `1`, чтобы отключить вложенность. В версиях с v2.1.217 по v2.1.218 значение по умолчанию было 1, поэтому субагент не мог запускать собственных, если вы не повышали ограничение; в v2.1.219 значение по умолчанию повышено до 3. Принимает положительное целое число, записанное цифрами; всё остальное игнорируется, поэтому ограничение можно изменить, но нельзя снять. Требуется Claude Code v2.1.217 или новее |

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

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

334| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | Ограничение общего количества вызовов [WebSearch](/docs/ru/tools-reference#websearch-tool-behavior), которые может выполнить одна сессия (по умолчанию: 200). Когда Claude достигает ограничения, последующие вызовы WebSearch возвращают уведомление с указанием продолжить работу с уже собранной информацией. Принимает положительное целое число без верхней границы. Всё остальное игнорируется, и применяется значение по умолчанию, поэтому ограничение можно повысить, но нельзя отключить. Требуется Claude Code v2.1.212 или новее |335| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | Ограничение на количество вызовов [WebSearch](/docs/ru/tools-reference#session-search-limit) (по умолчанию: 200). Когда Claude достигает ограничения, последующие вызовы WebSearch возвращают уведомление с указанием продолжить работу с уже собранной информацией. Принимает положительное целое число без верхней границы. Всё остальное игнорируется, и применяется значение по умолчанию, поэтому ограничение можно повысить, но нельзя отключить. Требуется Claude Code v2.1.212 или новее |

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

336| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | Время в миллисекундах, по истечении которого всё ещё выполняющийся вызов инструмента MCP [переводится в фоновую задачу](/docs/ru/mcp#automatic-backgrounding-of-long-tool-calls) (по умолчанию: 120000, или 2 минуты). Установите `0`, чтобы отключить автоматический перевод в фон. Требуется Claude Code v2.1.212 или новее |337| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | Время в миллисекундах, по истечении которого всё ещё выполняющийся вызов инструмента MCP [переносится в фоновую задачу](/docs/ru/mcp#automatic-backgrounding-of-long-tool-calls) (по умолчанию: 120000, то есть 2 минуты). Установите `0`, чтобы отключить автоматический перенос в фон. Требуется Claude Code v2.1.212 или новее |

337| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | Сколько миллисекунд первый ход [неинтерактивной](/docs/ru/headless) сессии ждёт MCP-серверы, которые ещё подключаются, вместо стандартного [ожидания первого хода](/docs/ru/agent-sdk/mcp#connection-timing). Если переменная задана, ожидание распространяется на все ожидающие серверы. Установите `0`, чтобы пропустить ожидание. Сервер [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags) сохраняет собственное ожидание `MCP_TIMEOUT` независимо от значения. Требуется Claude Code v2.1.274 или новее |338| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | Сколько миллисекунд первый ход [неинтерактивной](/docs/ru/headless) сессии ждёт MCP-серверы, которые ещё подключаются, вместо стандартного [ожидания на первом ходу](/docs/ru/agent-sdk/mcp#connection-timing). Если переменная задана, ожидание распространяется на все ожидающие серверы. Установите `0`, чтобы пропустить ожидание. Сервер [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags) сохраняет собственное ожидание `MCP_TIMEOUT` независимо от значения. Требуется Claude Code v2.1.274 или новее |

338| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | Таймаут простоя в миллисекундах для вызовов инструментов MCP. Если MCP-сервер stdio, HTTP, SSE, WebSocket или [коннектор claude.ai](/docs/ru/mcp#use-mcp-servers-from-claude-ai) не отправляет ни ответа, ни уведомления о ходе выполнения в течение этого времени, вызов инструмента прерывается с ошибкой, не дожидаясь общего `MCP_TOOL_TIMEOUT`. Переопределяет значения по умолчанию для каждого транспорта: 300000 (5 минут) для сетевых серверов и 1800000 (30 минут) для stdio-серверов. Установите `0`, чтобы отключить проверку простоя. Значения меньше 1000 повышаются до одной секунды, а значение ограничено действующим `MCP_TOOL_TIMEOUT`. Параметр `timeout` для отдельного сервера в `.mcp.json` со значением не менее 1000 повышает окно простоя этого сервера как минимум до значения `timeout`. Не применяется к серверам IDE и внутрипроцессным серверам SDK. Требуется Claude Code v2.1.187 или новее. До v2.1.203 на stdio-серверы таймаут простоя не распространялся |339| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | Таймаут простоя в миллисекундах для вызовов инструментов MCP. Когда MCP-сервер stdio, HTTP, SSE, WebSocket или [коннектор claude.ai](/docs/ru/mcp#use-mcp-servers-from-claude-ai) в течение этого времени не отправляет ни ответа, ни уведомления о ходе выполнения, вызов инструмента прерывается с ошибкой, не дожидаясь общего `MCP_TOOL_TIMEOUT`. Переопределяет значения по умолчанию для каждого транспорта: 300000 (5 минут) для сетевых серверов и 1800000 (30 минут) для stdio-серверов. Установите `0`, чтобы отключить проверку простоя. Значения меньше 1000 повышаются до одной секунды, а значение ограничивается действующим `MCP_TOOL_TIMEOUT`. Заданный для отдельного сервера в `.mcp.json` `timeout`, равный как минимум 1000, повышает окно простоя этого сервера как минимум до значения `timeout`. Не применяется к серверам IDE и внутрипроцессным серверам SDK. Требуется Claude Code v2.1.187 или новее. До v2.1.203 таймаут простоя не распространялся на stdio-серверы |

339| `CLAUDE_CODE_MESSAGING_SOCKET` | Задаётся Claude Code, а не вами: в сессиях, которые привязывают [сокет входящих сообщений](/docs/ru/cross-session-messaging#the-sessions-inbox-socket), Claude Code при привязке сокета экспортирует его путь в хуки и команды Bash. В сессии, которая запускается с включённым обменом сообщениями, Claude Code привязывает сокет до выполнения каких-либо хуков. Другие сессии на этой машине доставляют сообщения по этому пути. Каждая сессия экспортирует собственный сокет, а не унаследованный от родительской, и поступающие на него сообщения проходят через [средства контроля входящих сообщений](/docs/ru/cross-session-messaging#control-inbound-messages) сессии. Блоки `env` в настройках не могут её задать. Требуется Claude Code v2.1.224 или новее |340| `CLAUDE_CODE_MESSAGING_SOCKET` | Задаётся Claude Code, а не вами: в сессиях, которые привязывают [входящий сокет](/docs/ru/cross-session-messaging#the-sessions-inbox-socket), Claude Code при привязке сокета экспортирует путь к нему в хуки и команды Bash. В сессии, которая запускается с включёнными сообщениями, Claude Code привязывает сокет до запуска любого хука. Другие сессии на этой машине доставляют сообщения по этому пути. Каждая сессия экспортирует собственный сокет, а не унаследованный от родительской, и поступающие на него сообщения проходят через [средства контроля входящих сообщений](/docs/ru/cross-session-messaging#control-inbound-messages) сессии. Блоки `env` в настройках не могут её задать. Требуется Claude Code v2.1.224 или новее |

340| `CLAUDE_CODE_MESSAGING_TOKEN` | Задаётся Claude Code, а не вами: в сессиях, которые привязывают [сокет входящих сообщений](/docs/ru/cross-session-messaging#the-sessions-inbox-socket), Claude Code экспортирует этот токен сессии в хуки и команды Bash вместе с `CLAUDE_CODE_MESSAGING_SOCKET`. Скрипт, отправляющий данные в сокет, может отправить `{"type":"auth","token":"<token>"}` первой строкой, чтобы подтвердить принадлежность к сессии. В нативной Windows Claude Code требует эту строку и закрывает любое соединение, которое не начинается с действительной строки. [Правила для собственных дочерних процессов](/docs/ru/cross-session-messaging#the-sessions-inbox-socket) определяют, когда Claude Code проверяет токен. Каждая сессия экспортирует собственный токен и никогда не использует унаследованный от родительской сессии. Блоки `env` в настройках не могут её задать. Требуется Claude Code v2.1.228 или новее |341| `CLAUDE_CODE_MESSAGING_TOKEN` | Задаётся Claude Code, а не вами: в сессиях, которые привязывают [входящий сокет](/docs/ru/cross-session-messaging#the-sessions-inbox-socket), Claude Code экспортирует этот токен сессии в хуки и команды Bash вместе с `CLAUDE_CODE_MESSAGING_SOCKET`. Скрипт, отправляющий данные в сокет, может отправить `{"type":"auth","token":"<token>"}` первой строкой, чтобы доказать свою принадлежность к сессии. В нативной Windows Claude Code требует эту строку и закрывает любое соединение, которое не начинается с действительной строки. [Правила для собственных дочерних процессов](/docs/ru/cross-session-messaging#the-sessions-inbox-socket) определяют, когда Claude Code проверяет токен. Каждая сессия экспортирует собственный токен и никогда не использует унаследованный от родительской сессии. Блоки `env` в настройках не могут её задать. Требуется Claude Code v2.1.228 или новее |

341| `CLAUDE_CODE_NATIVE_CURSOR` | Установите `1`, чтобы показывать собственный курсор терминала в позиции ввода вместо отрисованного блока. Курсор учитывает настройки мигания, формы и фокуса терминала. Значение `0` воспринимается так же, как незаданная переменная, поэтому оно не возвращает отрисованный блок в сессии, где собственный курсор терминала уже включён |342| `CLAUDE_CODE_NATIVE_CURSOR` | Установите `1`, чтобы показывать собственный курсор терминала в позиции ввода вместо нарисованного блока. Курсор учитывает настройки мигания, формы и фокуса терминала. Значение `0` воспринимается так же, как незаданная переменная, поэтому оно не возвращает нарисованный блок в сессии, где собственный курсор терминала уже включён |

342| `CLAUDE_CODE_NEW_INIT` | Установите `1`, чтобы `/init` запускал интерактивный процесс настройки. Этот процесс спрашивает, какие файлы сгенерировать, включая CLAUDE.md, скиллы и хуки, прежде чем исследовать кодовую базу и записать их. Без этой переменной `/init` генерирует CLAUDE.md автоматически, ничего не спрашивая |343| `CLAUDE_CODE_NEW_INIT` | Установите `1`, чтобы `/init` запускал интерактивный процесс настройки. Он спрашивает, какие файлы сгенерировать, включая CLAUDE.md, скиллы и хуки, прежде чем изучить кодовую базу и записать их. Без этой переменной `/init` генерирует CLAUDE.md автоматически, ничего не спрашивая |

343| `CLAUDE_CODE_NONBLOCKING_STDOUT` | Установите `1`, чтобы записывать вывод в терминал через второй неблокирующий файловый дескриптор, чтобы терминал, который перестал читать данные, например приостановленная панель tmux в режиме управления или зависшее SSH-соединение, не мог заморозить Claude Code посреди сессии. Применяется в macOS, Linux и WSL, когда stdout является терминалом. Требуется Claude Code v2.1.261 или новее |344| `CLAUDE_CODE_NONBLOCKING_STDOUT` | Установите `1`, чтобы записывать вывод в терминал через второй неблокирующий файловый дескриптор, чтобы терминал, который перестаёт читать, например приостановленная панель tmux в режиме control mode или зависшее SSH-соединение, не мог заморозить Claude Code посреди сессии. Применяется в macOS, Linux и WSL, когда stdout является терминалом. Требуется Claude Code v2.1.261 или новее |

344| `CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES` | Ограничивает количество повторных отправок Claude Code [непотокового запроса](/docs/ru/errors#streaming-response-ended-before-any-complete-data-was-received), завершившегося по таймауту. При значении `0` запрос завершается ошибкой при первом же таймауте. По умолчанию не задана, поэтому эти повторные отправки ограничивает `CLAUDE_CODE_MAX_RETRIES`. О таймауте см. [Настройка поведения повторных попыток](/docs/ru/errors#tune-retry-behavior). Требуется Claude Code v2.1.285 или новее |345| `CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES` | Ограничивает количество повторных отправок Claude Code [непотокового запроса](/docs/ru/errors#streaming-response-ended-before-any-complete-data-was-received), завершившегося по таймауту. При `0` запрос завершается ошибкой при первом таймауте. Сведения о таймауте см. в разделе [Настройка поведения повторных попыток](/docs/ru/errors#tune-retry-behavior). Требуется Claude Code v2.1.285 или новее |

345| `CLAUDE_CODE_NO_FLICKER` | Установите `1`, чтобы включить [полноэкранную отрисовку](/docs/ru/fullscreen) — research preview, который уменьшает мерцание и удерживает потребление памяти на постоянном уровне в длинных диалогах. Переопределяет настройку [`tui`](/docs/ru/settings-reference#tui); переключиться также можно с помощью `/tui fullscreen` |346| `CLAUDE_CODE_NO_FLICKER` | Установите `1`, чтобы включить [полноэкранный рендеринг](/docs/ru/fullscreen) — research preview, который уменьшает мерцание и сохраняет стабильное потребление памяти в длинных диалогах. Переопределяет настройку [`tui`](/docs/ru/settings-reference#tui); также можно переключиться с помощью `/tui fullscreen` |

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

347| `CLAUDE_CODE_OAUTH_SCOPES` | Разделённые пробелами OAuth scope, с которыми был выдан токен обновления, например `"user:profile user:inference user:sessions:claude_code"`. Обязательна, если задана `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` |348| `CLAUDE_CODE_OAUTH_SCOPES` | Разделённые пробелами scope OAuth, с которыми был выдан токен обновления, например `"user:profile user:inference user:sessions:claude_code"`. Обязательна, если задана `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` |

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

349| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Удалена в v2.1.160 и теперь ни на что не влияет. Ранее закрепляла [быстрый режим](/docs/ru/fast-mode) за Claude Opus 4.6 вместо текущей модели по умолчанию. Opus 4.6 больше не поддерживает быстрый режим |350| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Удалена в v2.1.160 и теперь ни на что не влияет. Ранее закрепляла [быстрый режим](/docs/ru/fast-mode) за Claude Opus 4.6 вместо текущего значения по умолчанию. Opus 4.6 больше не поддерживает быстрый режим |

350| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Максимальная длина атрибутов OpenTelemetry, содержащих контент (ответы модели, контент инструментов, системные промпты, необработанные тела API), включая маркер усечения, в кодовых единицах UTF-16 (по умолчанию: 61440, т. е. 60 КБ). Увеличивайте её, только если ваш бэкенд телеметрии принимает значения атрибутов больше 64 КБ, или уменьшайте, чтобы сократить объём телеметрии. Требуется Claude Code v2.1.214 или новее. См. [Мониторинг](/docs/ru/monitoring-usage) |351| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Максимальная длина атрибутов OpenTelemetry, содержащих контент (ответы модели, содержимое инструментов, системные промпты, необработанные тела API), включая маркер обрезки, в кодовых единицах UTF-16 (по умолчанию: 61440, то есть 60 КБ). Увеличивайте её, только если ваш бэкенд телеметрии принимает значения атрибутов больше 64 КБ, или уменьшите, чтобы сократить объём телеметрии. Требуется Claude Code v2.1.214 или новее. См. [Мониторинг](/docs/ru/monitoring-usage) |

351| `CLAUDE_CODE_OTEL_DIAG_STDERR` | Установите `1`, чтобы записывать диагностические ошибки экспортёра OpenTelemetry в stderr. По умолчанию эти ошибки появляются только с `--debug`, поэтому неправильно настроенный экспортёр, например при конфликте портов Prometheus, в противном случае отказывает без каких-либо сообщений. Требуется Claude Code v2.1.179 или новее. См. [Мониторинг](/docs/ru/monitoring-usage) |352| `CLAUDE_CODE_OTEL_DIAG_STDERR` | Установите `1`, чтобы записывать диагностические ошибки экспортёра OpenTelemetry в stderr. По умолчанию эти ошибки появляются только с `--debug`, поэтому неправильно настроенный экспортёр, например при конфликте портов Prometheus, в противном случае отказывает без каких-либо сообщений. Требуется Claude Code v2.1.179 или новее. См. [Мониторинг](/docs/ru/monitoring-usage) |

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

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

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

355| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Установите `1`, чтобы разрешить Claude Code выполнять команду обновления вашего менеджера пакетов в фоновом режиме, когда доступна новая версия. Применяется к установкам через Homebrew и WinGet. Другие менеджеры пакетов по-прежнему показывают команду обновления, не выполняя её. См. [Автоматические обновления](/docs/ru/setup#auto-updates) |356| `CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS` | Начальная задержка в миллисекундах (вместо стандартных 500) экспоненциальной задержки между [автоматическими повторными попытками](/docs/ru/errors#tune-retry-behavior) запроса, который API отклоняет с ошибкой перегрузки `529`. Увеличьте её, чтобы распределить повторные попытки на более длительный промежуток, когда API работает на пределе мощности. Указывайте целое число миллисекунд от 500 до 32000 цифрами; любое другое значение Claude Code считает незаданным. Не действует, если `CLAUDE_CODE_RETRY_WATCHDOG` установлена в `1` или если отклонённый запрос был отправлен в [быстром режиме](/docs/ru/fast-mode#handle-rate-limits). Требуется Claude Code v2.1.292 или новее |

356| `CLAUDE_CODE_PERFORCE_MODE` | Установите `1`, чтобы включить защиту от записи с учётом Perforce. Если задана, Edit, Write и NotebookEdit завершаются с ошибкой и подсказкой `p4 edit <file>`, если у целевого файла отсутствует бит записи для владельца, который Perforce снимает с синхронизированных файлов, пока `p4 edit` не откроет их. Это не даёт Claude Code обходить отслеживание изменений Perforce |357| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Установите `1`, чтобы Claude Code запускал команду обновления вашего пакетного менеджера в фоне, когда доступна новая версия. Применяется к установкам через Homebrew и WinGet. Другие пакетные менеджеры по-прежнему показывают команду обновления, не запуская её. См. [Автоматические обновления](/docs/ru/setup#auto-updates) |

357| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Переопределяет корневой каталог плагинов. Несмотря на название, она задаёт родительский каталог, а не сам кэш: маркетплейсы и кэш плагинов находятся в подкаталогах по этому пути. По умолчанию `~/.claude/plugins` |358| `CLAUDE_CODE_PERFORCE_MODE` | Установите `1`, чтобы включить защиту от записи с учётом Perforce. Если задано, Edit, Write и NotebookEdit завершаются ошибкой с подсказкой `p4 edit <file>`, если у целевого файла отсутствует бит записи для владельца, который Perforce снимает с синхронизированных файлов, пока `p4 edit` не откроет их. Это не позволяет Claude Code обходить отслеживание изменений Perforce |

358| `CLAUDE_CODE_PLUGIN_DIRS` | Каталоги плагинов для загрузки в сессии; каждый загружается так же, как его загрузил бы флаг [`--plugin-dir`](/docs/ru/plugins/cli-reference#flags-that-load-a-plugin-for-one-session). Разделяйте несколько путей символом `:` в Unix или `;` в Windows. Указывайте каждый путь как абсолютный или начинайте его с `~`, поскольку Claude Code пропускает относительные пути. Требуется Claude Code v2.1.280 или новее. См. [Загрузка плагина для одной сессии](/docs/ru/plugins/create#load-a-directory-or-archive-for-one-session) |359| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Переопределяет корневой каталог плагинов. Несмотря на название, задаёт родительский каталог, а не сам кэш: маркетплейсы и кэш плагинов находятся в подкаталогах этого пути. По умолчанию `~/.claude/plugins` |

359| `CLAUDE_CODE_PLUGIN_DIR_WATCH` | Управляет тем, перезагружает ли Claude Code [мод](/docs/ru/plugins/mods/overview) при изменении его файлов. Перезагрузка применяется к моду, загруженному из каталога с помощью `--plugin-dir`, и по умолчанию включена в интерактивных сессиях. Установите `1`, чтобы включить её также в неинтерактивных сессиях, или `0`, чтобы отключить её во всех сессиях. Требуется Claude Code v2.1.287 или новее. См. [настройки и переменные окружения модов](/docs/ru/plugins/mods/reference#settings-and-environment-variables) |360| `CLAUDE_CODE_PLUGIN_DIRS` | Каталоги плагинов для загрузки в сессию; каждый загружается так же, как его загрузил бы флаг [`--plugin-dir`](/docs/ru/plugins/cli-reference#flags-that-load-a-plugin-for-one-session). Разделяйте несколько путей символом `:` в Unix или `;` в Windows. Указывайте каждый путь как абсолютный или начинайте его с `~`, так как Claude Code пропускает относительные пути. Требуется Claude Code v2.1.280 или новее. См. [Загрузка плагина для одной сессии](/docs/ru/plugins/create#load-a-directory-or-archive-for-one-session) |

360| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Таймаут в миллисекундах для клонирования или обновления маркетплейса плагинов (по умолчанию: 120000). Увеличьте это значение для больших репозиториев или медленных сетевых подключений. См. [Истёк таймаут git clone](/docs/ru/plugins/troubleshooting#git-clone-timed-out-after-120s) |361| `CLAUDE_CODE_PLUGIN_DIR_WATCH` | Определяет, перезагружает ли Claude Code [мод](/docs/ru/plugins/mods/overview) при изменении его файлов. Перезагрузка применяется к моду, загружаемому из каталога с помощью `--plugin-dir`, и по умолчанию включена в интерактивных сессиях. Установите `1`, чтобы включить её также в неинтерактивных сессиях, или `0`, чтобы отключить её во всех сессиях. Требуется Claude Code v2.1.287 или новее. См. [настройки и переменные окружения модов](/docs/ru/plugins/mods/reference#settings-and-environment-variables) |

361| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Установите `1`, чтобы пропустить попытку повторного клонирования и продолжать использовать существующую копию маркетплейса, когда при обновлении маркетплейса не удаётся подключиться к удалённому репозиторию или пройти аутентификацию. Полезно в офлайн-средах или изолированных средах, где повторное клонирование завершилось бы ошибкой по той же причине. См. [Обновления маркетплейса завершаются ошибкой в офлайн-средах](/docs/ru/plugins/troubleshooting#marketplace-updates-keep-failing-offline) |362| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Таймаут в миллисекундах для клонирования или обновления маркетплейса плагинов (по умолчанию: 120000). Увеличьте это значение для больших репозиториев или медленных сетевых подключений. См. [Git clone timed out](/docs/ru/plugins/troubleshooting#git-clone-timed-out-after-120s) |

362| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Установите `1`, чтобы клонировать источники GitHub в сокращённой форме `owner/repo` по HTTPS вместо SSH. Применяется к установке и обновлению плагинов, а также к `/plugin marketplace add` и `update`. Полезно в CI-раннерах, контейнерах или любой среде без настроенного SSH-ключа для `github.com` |363| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Установите `1`, чтобы пропустить попытку повторного клонирования и продолжить использовать существующую копию маркетплейса, когда при обновлении маркетплейса не удаётся связаться с удалённым репозиторием или пройти на нём аутентификацию. Полезно в офлайн- или изолированных средах, где повторное клонирование завершилось бы такой же ошибкой. См. [Обновления маркетплейса не работают в офлайн-средах](/docs/ru/plugins/troubleshooting#marketplace-updates-keep-failing-offline) |

363| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Путь к одному или нескольким начальным каталогам плагинов только для чтения, разделённым символом `:` в Unix или `;` в Windows. Используйте для включения заранее заполненного каталога плагинов в образ контейнера. Claude Code регистрирует маркетплейсы из этих каталогов при запуске и использует предварительно кэшированные плагины без повторного клонирования. См. [Предварительное заполнение плагинов для контейнеров](/docs/ru/plugins/org#seed-containers-and-ci) |364| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Установите `1`, чтобы клонировать источники, заданные сокращённой формой GitHub `owner/repo`, по HTTPS вместо SSH. Применяется к установке и обновлению плагинов, а также к `/plugin marketplace add` и `update`. Полезно в CI-раннерах, контейнерах или любой среде без настроенного SSH-ключа для `github.com` |

364| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Установите `1`, чтобы Claude Code перестал передавать `-ExecutionPolicy Bypass` при запуске PowerShell для вызовов инструментов, хуков и команд строки состояния и вместо этого учитывал действующую на машине политику выполнения. По умолчанию Claude Code обходит политику выполнения на уровне процесса, чтобы скрипты `.ps1` и импорт модулей работали в установках Windows с политикой Restricted по умолчанию. Обход на уровне процесса никогда не переопределяет групповые политики `MachinePolicy` или `UserPolicy` независимо от этой настройки |365| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Путь к одному или нескольким начальным каталогам плагинов только для чтения, разделённым `:` в Unix или `;` в Windows. Используйте, чтобы включить предварительно заполненный каталог плагинов в образ контейнера. Claude Code регистрирует маркетплейсы из этих каталогов при запуске и использует предварительно кэшированные плагины без повторного клонирования. См. [Предварительное заполнение плагинов для контейнеров](/docs/ru/plugins/org#seed-containers-and-ci) |

365| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | Верхний предел в миллисекундах для ожидания в простое фоновой работы, такой как субагенты и рабочие процессы, после последнего хода в [неинтерактивном режиме](/docs/ru/headless#background-tasks-at-exit) с флагом `-p`. Ожидание в простое начинается заново каждый раз, когда Claude выполняет ход для обработки фонового результата. По умолчанию: `600000`, или 10 минут. Когда ожидание в простое достигает предела, Claude Code прекращает ожидать оставшиеся фоновые задачи и завершает работу. Установите `0`, чтобы ждать бесконечно. Этот предел не связан с пятисекундным льготным периодом, который применяется к обычным фоновым оболочкам. Требуется Claude Code v2.1.182 или новее |366| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Установите `1`, чтобы Claude Code не передавал `-ExecutionPolicy Bypass` при запуске PowerShell для вызовов инструментов, хуков и команд строки состояния, а вместо этого соблюдал действующую политику выполнения машины. По умолчанию Claude Code обходит политику выполнения на уровне процесса, чтобы скрипты `.ps1` и импорт модулей работали в установках Windows с политикой Restricted по умолчанию. Обход на уровне процесса никогда не переопределяет групповые политики `MachinePolicy` или `UserPolicy` независимо от этой настройки |

366| `CLAUDE_CODE_PROCESS_WRAPPER` | Запускает процессы, которые Claude Code стартует из собственного бинарного файла, например фоновую службу, в которой работают сессии [представления агентов](/docs/ru/agent-view), через корпоративный лаунчер, заданный как префикс argv, например `/opt/corp/launcher`. Задавайте её в блоке `env` пользовательских или [управляемых настроек](/docs/ru/managed-settings), а не через export в оболочке, чтобы отсоединённая фоновая служба её унаследовала; настройки проекта и локальные настройки не могут её задать. Эквивалентна [настройке `processWrapper`](/docs/ru/settings-reference#processwrapper), которая требует Claude Code v2.1.210 или новее; если заданы обе, приоритет имеет эта переменная. Расширение VS Code настраивает собственный лаунчер отдельно через свою настройку `claudeProcessWrapper`. Игнорируется в Windows. Формат значения, охват лаунчера и требования, которым он должен соответствовать, см. в разделе [Запуск Claude Code через корпоративный лаунчер](/docs/ru/corporate-launcher). Требуется Claude Code v2.1.208 или новее |367| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | Верхний предел в миллисекундах для ожидания в простое фоновой работы, например субагентов и рабочих процессов, после последнего хода в [неинтерактивном режиме](/docs/ru/headless#background-tasks-at-exit) с флагом `-p`. Отсчёт ожидания в простое начинается заново каждый раз, когда Claude выполняет ход для обработки фонового результата. По умолчанию: `600000`, то есть 10 минут. Когда ожидание в простое достигает предела, Claude Code перестаёт ждать оставшиеся фоновые задачи. Выполняющаяся фоновая команда, запущенная основным диалогом, удерживает выполнение открытым и после этого предела. Установите `0`, чтобы ждать бесконечно. Требуется Claude Code v2.1.182 или новее |

367| `CLAUDE_CODE_PROJECT_DIR_NAME` | Задайте вместе с `CLAUDE_CONFIG_DIR`, чтобы выбрать имя каталога в `projects/`, в котором Claude Code хранит транскрипты и автоматическую память этой сессии, вместо имени, производного от пути рабочего каталога. Например, запуск Claude Code с `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` сохраняет их в `/srv/tenant-a/projects/work/`. Claude Code игнорирует эту переменную, если `CLAUDE_CONFIG_DIR` не задана, и считывает её только из окружения, в котором вы запускаете `claude`, но никогда из [блока `env` файла настроек](#in-settings-files). См. [Самостоятельное задание имени каталога проекта](/docs/ru/sessions#name-the-project-directory-yourself). Требуется Claude Code v2.1.234 или новее |368| `CLAUDE_CODE_PROCESS_WRAPPER` | Запускает процессы, которые Claude Code стартует из собственного бинарного файла, например фоновую службу, на которой работают сессии [представления агентов](/docs/ru/agent-view), через корпоративный лаунчер, заданный как префикс argv, например `/opt/corp/launcher`. Задайте её в блоке `env` пользовательских или [управляемых настроек](/docs/ru/managed-settings), а не через export в оболочке, чтобы отсоединённая фоновая служба унаследовала её; настройки проекта и локальные настройки не могут её задать. Эквивалентна [настройке `processWrapper`](/docs/ru/settings-reference#processwrapper), которая требует Claude Code v2.1.210 или новее; эта переменная имеет приоритет, если заданы обе. Расширение VS Code настраивает собственный лаунчер отдельно через свою настройку `claudeProcessWrapper`. Игнорируется в Windows. Формат значения, то, что охватывает лаунчер, и требования, которым он должен соответствовать, описаны в разделе [Запуск Claude Code через корпоративный лаунчер](/docs/ru/corporate-launcher). Требуется Claude Code v2.1.208 или новее |

368| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Задайте `5m` или `1h` — единственные значения, которые принимает Claude Code, — чтобы выбрать [TTL кэша промптов](/docs/ru/prompt-caching#cache-lifetime) для основного диалога: ваших интерактивных ходов, ходов `-p` и SDK, а также вспомогательных процессов, выполняемых вместе с ними. Имеет приоритет над настройкой `promptCacheTtl` и над `ENABLE_PROMPT_CACHING_1H`, а `FORCE_PROMPT_CACHING_5M` переопределяет её. API тарифицирует запись в часовой кэш по более высокой ставке. Требуется Claude Code v2.1.242 или новее |369| `CLAUDE_CODE_PROJECT_DIR_NAME` | Задаётся вместе с `CLAUDE_CONFIG_DIR`, чтобы выбрать имя каталога в `projects/`, в котором Claude Code хранит транскрипты и автоматическую память этой сессии, вместо имени, производного от пути рабочего каталога. Например, запуск Claude Code с `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` сохраняет их в `/srv/tenant-a/projects/work/`. Claude Code игнорирует эту переменную, если `CLAUDE_CONFIG_DIR` не задана, и читает её только из окружения, в котором вы запускаете `claude`, но никогда из [блока `env` файла настроек](#in-settings-files). См. [Самостоятельное именование каталога проекта](/docs/ru/sessions#name-the-project-directory-yourself). Требуется Claude Code v2.1.234 или новее |

369| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Установите `1`, чтобы передавать контекст трассировки W3C, когда `ANTHROPIC_BASE_URL` указывает на собственный прокси. Передача охватывает заголовок `traceparent` в запросах к модели и HTTP-запросах MCP, а также переменную окружения `TRACEPARENT` для подпроцессов Bash, PowerShell и хуков. По умолчанию передача включена только при прямом подключении к Anthropic API. Добавлена в v2.1.152. См. [Трассировки (бета)](/docs/ru/monitoring-usage#traces-beta) |370| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Установите `5m` или `1h` — единственные значения, которые принимает Claude Code, — чтобы выбрать [TTL кэша промптов](/docs/ru/prompt-caching#cache-lifetime) для основного диалога: ваших интерактивных ходов, ходов `-p` и SDK, а также вспомогательных процессов, выполняющихся вместе с ними. Имеет приоритет над настройкой `promptCacheTtl` и над `ENABLE_PROMPT_CACHING_1H`, а `FORCE_PROMPT_CACHING_5M` переопределяет её. API тарифицирует запись в кэш на 1 час по более высокой ставке. Требуется Claude Code v2.1.242 или новее |

370| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Задаётся хост-платформами, которые встраивают Claude Code и управляют маршрутизацией к провайдеру модели от его имени. Если задана, Claude Code игнорирует переменные выбора провайдера, эндпоинта и аутентификации, такие как `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` и `ANTHROPIC_API_KEY`, в файлах настроек, поэтому пользовательские настройки не могут переопределить маршрутизацию хоста. Claude Code также игнорирует ключи выбора модели, такие как `model`, `fallbackModel` и `modelOverrides`, в [управляемых настройках](/docs/ru/managed-settings), из какого бы управляемого источника они ни поступали, поэтому конфигурация модели хоста имеет приоритет над устаревшим закреплением модели в управляемых настройках. Claude Code также игнорирует переменные выбора модели, такие как `ANTHROPIC_MODEL` и семейство `ANTHROPIC_DEFAULT_*_MODEL`, в управляемом блоке `env`; список разрешённых моделей [`availableModels`](/docs/ru/model-config#restrict-model-selection) в управляемых настройках по-прежнему применяется, если хост не предоставляет собственный. Claude Code также пропускает автоматический отказ от телеметрии, который в противном случае применяет у сторонних провайдеров, таких как Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform и Microsoft Foundry, поэтому телеметрия подчиняется стандартному отказу через `DISABLE_TELEMETRY`. См. [Поведение по умолчанию в зависимости от провайдера API](/docs/ru/data-usage#default-behaviors-by-api-provider) |371| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Установите `1`, чтобы передавать контекст трассировки W3C, когда `ANTHROPIC_BASE_URL` указывает на пользовательский прокси. Передача охватывает заголовок `traceparent` в запросах к модели и HTTP MCP, а также переменную окружения `TRACEPARENT` для подпроцессов Bash, PowerShell и хуков. По умолчанию передача включена только при прямом подключении к Anthropic API. Добавлено в v2.1.152. См. [Трассировки (бета)](/docs/ru/monitoring-usage#traces-beta) |

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

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

372| `CLAUDE_CODE_REMOTE` | Автоматически устанавливается в `true`, когда Claude Code работает как [облачная сессия](/docs/ru/claude-code-on-the-web). Считывайте её из хука или скрипта настройки, чтобы определить, находитесь ли вы в облачной сессии |374| `CLAUDE_CODE_REMOTE` | Автоматически устанавливается в `true`, когда Claude Code работает как [облачная сессия](/docs/ru/claude-code-on-the-web). Считывайте её из хука или скрипта настройки, чтобы определить, находитесь ли вы в облачной сессии |

373| `CLAUDE_CODE_REMOTE_SESSION_ID` | В [облачных сессиях](/docs/ru/claude-code-on-the-web) автоматически устанавливается в ID текущей сессии. Считывайте её, чтобы сформировать ссылку на транскрипт сессии. См. [Ссылка из вывода на сессию](/docs/ru/cloud-environments#link-output-back-to-the-session) |375| `CLAUDE_CODE_REMOTE_SESSION_ID` | В [облачных сессиях](/docs/ru/claude-code-on-the-web) автоматически устанавливается в ID текущей сессии. Считывайте её, чтобы сформировать ссылку на транскрипт сессии. См. [Ссылка из вывода на сессию](/docs/ru/cloud-environments#link-output-back-to-the-session) |

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

375| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Установите `1`, чтобы автоматически возобновлять работу, если предыдущая сессия завершилась посреди хода. Используется в режиме SDK, чтобы модель продолжала работу без повторной отправки промпта из SDK. Чтобы отключить это, удалите переменную или установите её в `0`. О панели чата VS Code см. [Продолжение диалогов после перезагрузки](/docs/ru/vs-code#continue-conversations-after-a-reload) |377| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Установите `1`, чтобы автоматически возобновлять работу, если предыдущая сессия завершилась посреди хода. Используется в режиме SDK, чтобы модель продолжала работу без необходимости повторной отправки промпта через SDK. Чтобы отключить это поведение, удалите переменную или установите её в `0`. О панели чата VS Code см. [Продолжение диалогов после перезагрузки](/docs/ru/vs-code#continue-conversations-after-a-reload) |

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

377| `CLAUDE_CODE_RESUME_PROMPT` | Переопределяет сообщение продолжения, которое Claude Code отправляет Claude, когда `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` продолжает прерванный ход вместо повторной отправки его промпта, или когда вы возобновляете [отложенный вызов инструмента](/docs/ru/hooks#defer-a-tool-call-for-later) с `-p`. По умолчанию `Continue from where you left off.`. Пустая строка означает использование значения по умолчанию |379| `CLAUDE_CODE_RESUME_PROMPT` | Переопределяет сообщение продолжения, которое Claude Code отправляет Claude, когда `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` продолжает прерванный ход вместо повторной отправки его промпта, или когда вы возобновляете [отложенный вызов инструмента](/docs/ru/hooks#defer-a-tool-call-for-later) с `-p`. По умолчанию `Continue from where you left off.`. Пустая строка означает использование значения по умолчанию |

378| `CLAUDE_CODE_RETRY_WATCHDOG` | Установите `1` для автономных сессий, таких как оценочные обвязки, задания CI или удалённые воркеры. Бесконечно повторяет попытки при ошибках нехватки мощностей `429` и `529` вместо завершения с ошибкой после `CLAUDE_CODE_MAX_RETRIES` попыток. Claude Code сразу завершается с ошибкой, когда запрос со стандартной скоростью получает `429`, сообщающий о лимите расходов или исчерпанных кредитах использования, даже если это [лимит расходов шлюза](/docs/ru/errors#spend-limit-reached), сбрасываемый по расписанию. До v2.1.239 watchdog бесконечно повторял попытки в таких случаях. О запросах в быстром режиме см. [Обработка ограничений частоты запросов](/docs/ru/fast-mode#handle-rate-limits). Watchdog увеличивает интервал между попытками до 5 минут или до сброса лимита, если ответ содержит время сброса ограничения частоты запросов, поэтому сессия, достигшая лимита использования, пережидает оставшееся окно. В v2.1.199 или новее она также повышает количество повторных попыток по умолчанию для других временных ошибок, таких как ошибки сервера, таймауты и разорванные соединения, до 300, что составляет примерно три часа ожидания, и снимает ограничение в 15 для `CLAUDE_CODE_MAX_RETRIES`, если вы задали эту переменную явно. Требуется Claude Code v2.1.186 или новее |380| `CLAUDE_CODE_RETRY_WATCHDOG` | Установите `1` для автономных сессий, таких как обвязки для оценки, задания CI или удалённые воркеры. Повторяет попытки при ошибках нехватки мощностей `429` и `529` бесконечно, вместо того чтобы завершаться ошибкой после `CLAUDE_CODE_MAX_RETRIES` попыток. Claude Code сразу завершается ошибкой, когда запрос со стандартной скоростью получает `429`, сообщающий о лимите расходов или исчерпанных кредитах использования, даже если это [лимит расходов шлюза](/docs/ru/errors#spend-limit-reached), который сбрасывается по расписанию. До v2.1.239 watchdog повторял такие запросы бесконечно. О запросах в быстром режиме см. [Обработка ограничений частоты запросов](/docs/ru/fast-mode#handle-rate-limits). Watchdog увеличивает паузу между попытками до 5 минут или до сброса лимита, если ответ содержит время сброса ограничения частоты запросов, поэтому сессия, достигшая лимита использования, дожидается окончания оставшегося окна. В v2.1.199 или новее он также повышает количество повторных попыток по умолчанию для других временных ошибок, таких как ошибки сервера, таймауты и разорванные соединения, до 300 — примерно три часа с увеличивающимися паузами — и снимает ограничение в 15 для `CLAUDE_CODE_MAX_RETRIES`, если вы задали эту переменную явно. Требуется Claude Code v2.1.186 или новее |

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

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

381| `CLAUDE_CODE_SCROLL_SPEED` | Задаёт множитель прокрутки колёсиком мыши при [полноэкранной отрисовке](/docs/ru/fullscreen#mouse-wheel-scrolling). Принимает любое положительное значение до 20, включая дробные значения меньше 1, например `0.5`, чтобы замедлить ускоренную прокрутку трекпадом и колёсиком в терминалах, которые уже усиливают события колёсика. Установите `3`, чтобы соответствовать `vim`, если ваш терминал отправляет одно событие колёсика на щелчок без усиления. Игнорируется в терминале JetBrains IDE, где Claude Code использует собственную обработку прокрутки |383| `CLAUDE_CODE_SCROLL_SPEED` | Задаёт множитель прокрутки колесом мыши в [полноэкранном рендеринге](/docs/ru/fullscreen#mouse-wheel-scrolling). Принимает любое положительное значение до 20, включая дробные значения меньше 1, например `0.5`, чтобы замедлить ускоренную прокрутку трекпадом и колесом в терминалах, которые уже усиливают события колеса. Установите `3`, чтобы соответствовать `vim`, если ваш терминал отправляет одно событие колеса на один щелчок без усиления. Игнорируется в терминале JetBrains IDE, где Claude Code использует собственную обработку прокрутки |

382| `CLAUDE_CODE_SEND_FEEDBACK` | Установите `0`, чтобы отключить [отзывы, составляемые Claude](/docs/ru/tools-reference#sendfeedback-tool-behavior), для сессии. Установите `1`, чтобы включить их там, где у вашей учётной записи уже есть доступ; сама переменная не может предоставить доступ, а другие переключатели, отключающие отзывы, такие как `DISABLE_FEEDBACK_COMMAND` и значение `off` настройки [`feedbackDrafts`](/docs/ru/settings-reference#feedbackdrafts), по-прежнему действуют |384| `CLAUDE_CODE_SEND_FEEDBACK` | Установите `0`, чтобы отключить [отзывы, составляемые Claude](/docs/ru/tools-reference#sendfeedback-tool-behavior), для сессии. Установите `1`, чтобы включить их там, где у вашего аккаунта уже есть доступ; сама переменная не может предоставить доступ, и другие переключатели, отключающие отзывы, такие как `DISABLE_FEEDBACK_COMMAND` и значение `off` настройки [`feedbackDrafts`](/docs/ru/settings-reference#feedbackdrafts), по-прежнему действуют |

383| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Переопределяет бюджет времени в миллисекундах для хуков [SessionEnd](/docs/ru/hooks#sessionend). Это значение также служит таймаутом для каждого хука, у которого не задан собственный `timeout`. Применяется при выходе из сессии, `/clear` и переключении сессий через интерактивный `/resume`. По умолчанию бюджет составляет 1,5 секунды и автоматически повышается до наибольшего `timeout` отдельного хука, настроенного в файлах настроек, но не более 60 секунд. Таймауты хуков, предоставляемых плагинами, не повышают бюджет |385| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Переопределяет бюджет времени в миллисекундах для хуков [SessionEnd](/docs/ru/hooks#sessionend). Это значение также служит таймаутом для каждого хука, у которого не задан собственный `timeout`. Применяется при выходе из сессии, `/clear` и переключении сессий через интерактивный `/resume`. По умолчанию бюджет составляет 1,5 секунды и автоматически повышается до наибольшего `timeout` отдельного хука, настроенного в файлах настроек, но не более чем до 60 секунд. Таймауты хуков, предоставляемых плагинами, бюджет не повышают |

384| `CLAUDE_CODE_SESSION_ID` | Автоматически устанавливается в ID текущей сессии в подпроцессах инструментов Bash и PowerShell, подпроцессах [команд хуков](/docs/ru/hooks) и подпроцессах stdio [MCP-серверов](/docs/ru/mcp). Для Bash, PowerShell и хуков совпадает с полем `session_id` во входных JSON-данных хука и обновляется при `/clear`. Подпроцесс MCP-сервера сохраняет ID, с которым он был запущен. При `--resume <session-id>` он получает ID возобновлённой сессии, совпадающий с хуками и Bash. При `--continue` или `--resume` без явного ID он может вместо этого получить исходный ID запуска. Используйте для сопоставления скриптов и внешних инструментов с сессией Claude Code, которая их запустила |386| `CLAUDE_CODE_SESSION_ID` | Автоматически устанавливается в ID текущей сессии в подпроцессах инструментов Bash и PowerShell, подпроцессах [команд хуков](/docs/ru/hooks) и подпроцессах stdio [MCP-серверов](/docs/ru/mcp). Для Bash, PowerShell и хуков совпадает с полем `session_id` во входных JSON-данных хука и обновляется при `/clear`. Подпроцесс MCP-сервера сохраняет ID, с которым был запущен. При `--resume <session-id>` он получает ID возобновлённой сессии, как хуки и Bash. При `--continue` или `--resume` без явного ID он может вместо этого получить исходный ID, присвоенный при запуске. Используйте для сопоставления скриптов и внешних инструментов с сессией Claude Code, которая их запустила |

385| `CLAUDE_CODE_SHELL` | Задаёт оболочку, которую Claude Code использует для выполнения команд инструмента Bash. Принимает путь к бинарному файлу `bash` или `zsh`, например `/opt/homebrew/bin/bash`. Другие оболочки, такие как `fish`, не поддерживаются. Если значение не является рабочим путём к `bash` или `zsh`, Claude Code игнорирует его и переключается на автоматическое определение. Автоматическое определение использует ваш `$SHELL`, если он указывает на `bash` или `zsh`, в противном случае выбирает первый рабочий `zsh`, а затем `bash`, найденный в вашем `PATH` и стандартных местах установки |387| `CLAUDE_CODE_SHELL` | Задаёт оболочку, которую Claude Code использует для выполнения команд инструмента Bash. Принимает путь к исполняемому файлу `bash` или `zsh`, например `/opt/homebrew/bin/bash`. Другие оболочки, такие как `fish`, не поддерживаются. Если значение не является рабочим путём к `bash` или `zsh`, Claude Code игнорирует его и переходит к автоматическому определению. Автоматическое определение использует ваш `$SHELL`, если он указывает на `bash` или `zsh`, в противном случае выбирается первый рабочий `zsh`, а затем `bash`, найденный в `PATH` и стандартных местах установки |

386| `CLAUDE_CODE_SHELL_PREFIX` | Префикс, оборачивающий shell-команды, которые запускает Claude Code: вызовы инструмента Bash, команды [хуков](/docs/ru/hooks), команды [строки состояния](/docs/ru/statusline) и команды запуска stdio [MCP-серверов](/docs/ru/mcp). Хуки PowerShell и хуки в exec-форме выполняются без префикса. Полезно для логирования или аудита. Если задать просто путь к исполняемому файлу, например `/path/to/logger.sh`, каждая команда будет выполняться как `/path/to/logger.sh '<command>'`. Обёртка получает командную строку как один аргумент в кавычках оболочки в `$1`, поэтому обёртка должна повторно вычислить `$1` с помощью оболочки, например `exec bash -c "$1"`. Если трактовать `$1` как простой путь к исполняемому файлу, перестанут работать stdio MCP-серверы, которые передают аргументы, например `npx -y <package>`. Для вызовов инструмента Bash `$1` содержит полный вызов оболочки, собранный Claude Code, включая настройку окружения, а не только команду, которую выполнил Claude |388| `CLAUDE_CODE_SHELL_PREFIX` | Префикс команды, оборачивающий shell-команды, которые запускает Claude Code: вызовы инструмента Bash, команды [хуков](/docs/ru/hooks), команды [строки состояния](/docs/ru/statusline) и команды запуска stdio [MCP-серверов](/docs/ru/mcp). Хуки PowerShell и хуки в exec-форме выполняются без префикса. Полезно для логирования или аудита. Если задать путь к исполняемому файлу без аргументов, например `/path/to/logger.sh`, каждая команда выполняется как `/path/to/logger.sh '<command>'`. Обёртка получает командную строку в виде одного экранированного для оболочки аргумента в `$1`, поэтому обёртка должна заново вычислить `$1` с помощью оболочки, например `exec bash -c "$1"`. Если трактовать `$1` как путь к исполняемому файлу, перестают работать stdio MCP-серверы, передающие аргументы, например `npx -y <package>`. Для вызовов инструмента Bash `$1` содержит полный вызов оболочки, который собирает Claude Code, включая настройку окружения, а не только команду, выполненную Claude |

387| `CLAUDE_CODE_SIMPLE` | Установите `1`, чтобы работать с минимальным системным промптом и только инструментами Bash, чтения файлов и редактирования файлов. Инструменты MCP из `--mcp-config` по-прежнему доступны. Отключает автоматическое обнаружение хуков, скиллов, пользовательских команд, субагентов, установленных плагинов, MCP-серверов, автоматической памяти и CLAUDE.md. Скиллы в каталоге, переданном через `--add-dir`, по-прежнему загружаются. OAuth-токены и учётные данные из связки ключей не считываются, поэтому аутентификация Anthropic должна осуществляться через `ANTHROPIC_API_KEY` или `apiKeyHelper` в `--settings`. Эквивалентно передаче [`--bare`](/docs/ru/headless#start-faster-with-bare-mode) |389| `CLAUDE_CODE_SIMPLE` | Установите `1`, чтобы работать с минимальным системным промптом и только инструментами Bash, чтения файлов и редактирования файлов. Инструменты MCP из `--mcp-config` по-прежнему доступны. Отключает автоматическое обнаружение хуков, скиллов, пользовательских команд, субагентов, установленных плагинов, MCP-серверов, автоматической памяти и CLAUDE.md. Скиллы в каталоге, переданном через `--add-dir`, по-прежнему загружаются. Токены OAuth и учётные данные из связки ключей не считываются, поэтому аутентификация Anthropic должна выполняться через `ANTHROPIC_API_KEY` или `apiKeyHelper` в `--settings`. Эквивалентно передаче [`--bare`](/docs/ru/headless#start-faster-with-bare-mode) |

388| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Установите `1`, чтобы использовать более короткий системный промпт и сокращённые описания инструментов на любой модели. Установите `0`, `false`, `no` или `off`, чтобы отказаться от этого даже на моделях, где эксперимент или конфигурация сервера иначе включили бы это. Полный набор инструментов, хуки, MCP-серверы и обнаружение CLAUDE.md остаются включёнными |390| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Позволяет выбрать между полным системным промптом Claude Code и более коротким с сокращёнными описаниями инструментов. Если не задана, Haiku 4.5, Sonnet 5, Opus 4.7 и более ранние модели этих семейств по умолчанию используют полный промпт, а более новые модели — короткий. Установите `1`, чтобы использовать короткий промпт на любой модели. Установите `0`, `false`, `no` или `off`, чтобы использовать полный промпт на любой модели, даже если эксперимент или конфигурация сервера в противном случае выбрали бы короткий. Любой из промптов сохраняет полный набор инструментов, хуки, MCP-серверы и обнаружение CLAUDE.md |

389| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Пропускает клиентскую аутентификацию для [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) — для шлюзов, которые сами подписывают запросы |391| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Пропускает аутентификацию на стороне клиента для [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) — для шлюзов, которые подписывают запросы самостоятельно |

390| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | Установите `1`, чтобы отключить внутрипроцессный кэш учётных данных, полученных из стандартной цепочки поставщиков учётных данных AWS, чтобы Claude Code разрешал цепочку при каждом запросе к API. При отключённом кэше профиль на основе SSO запрашивает учётные данные у IAM Identity Center при каждом запросе. См. [кэширование учётных данных и таймаут их получения](/docs/ru/amazon-bedrock#credential-caching-and-resolution-timeout). Требуется Claude Code v2.1.207 или новее |392| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | Установите `1`, чтобы отключить внутрипроцессный кэш учётных данных, полученных из цепочки провайдеров учётных данных AWS по умолчанию, чтобы Claude Code разрешал цепочку при каждом API-запросе. При отключённом кэше профиль на основе SSO запрашивает учётные данные у IAM Identity Center при каждом запросе. См. [кэширование учётных данных и таймаут их получения](/docs/ru/amazon-bedrock#credential-caching-and-resolution-timeout). Требуется Claude Code v2.1.207 или новее |

391| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Пропускает аутентификацию AWS для Amazon Bedrock (например, при использовании LLM-шлюза) |393| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Пропускает аутентификацию AWS для Amazon Bedrock (например, при использовании LLM-шлюза) |

392| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | Установите `1`, чтобы считать неудачную проверку доступности [быстрого режима](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) признаком доступности — для сетей, которые блокируют прямой запрос этой проверки к `api.anthropic.com`. Claude Code по-прежнему учитывает ответ «отключено вашей организацией» |394| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | Установите `1`, чтобы при неудачной проверке доступности [быстрого режима](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) считать его доступным — для сетей, которые блокируют прямой запрос проверки к `api.anthropic.com`. Claude Code по-прежнему учитывает ответ «disabled by your organization» |

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

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

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

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

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

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

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

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

401| `CLAUDE_CODE_SUBAGENT_MODEL` | Модель по умолчанию для [субагентов](/docs/ru/sub-agents#choose-a-model), участников [команд агентов](/docs/ru/agent-teams#specify-teammates-and-models) и агентов [рабочих процессов](/docs/ru/workflows), которым модель не назначена иным способом. Принимает псевдоним, например `haiku`, или полное имя модели. Два источника имеют приоритет над ней: модель, которую Claude передаёт при создании агента, и поле `model` в определении агента, включая `inherit`. Чтобы изменить это, задайте [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/ru/sub-agents#run-every-subagent-on-one-model). Полный порядок см. в разделе [Выбор модели](/docs/ru/sub-agents#choose-a-model). Значение `inherit` равносильно незаданной переменной. До v2.1.251 эта переменная переопределяла как модель, заданную при вызове, так и поле `model` в определении |403| `CLAUDE_CODE_SUBAGENT_MODEL` | Модель по умолчанию для [субагентов](/docs/ru/sub-agents#choose-a-model), участников [команды агентов](/docs/ru/agent-teams#specify-teammates-and-models) и агентов [рабочих процессов](/docs/ru/workflows), которым модель не назначена другим способом. Принимает псевдоним, например `haiku`, или полное имя модели. Над ней имеют приоритет два источника: модель, которую Claude передаёт при запуске агента, и поле `model` в определении агента, включая `inherit`. Чтобы это изменить, задайте [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/ru/sub-agents#run-every-subagent-on-one-model). Полный порядок см. в разделе [Выбор модели](/docs/ru/sub-agents#choose-a-model). Значение `inherit` равнозначно незаданной переменной. До v2.1.251 эта переменная переопределяла как модель, указанную при вызове, так и поле `model` определения |

402| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | Установите `1`, чтобы принудительно использовать одну модель для субагентов, участников команд и агентов рабочих процессов. Какая это модель, описано в разделе [Запуск всех субагентов на одной модели](/docs/ru/sub-agents#run-every-subagent-on-one-model). Требуется Claude Code v2.1.257 или новее |404| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | Установите `1`, чтобы принудительно использовать одну модель для субагентов, участников команды и агентов рабочих процессов. Какая это модель, описано в разделе [Запуск всех субагентов на одной модели](/docs/ru/sub-agents#run-every-subagent-on-one-model). Требуется Claude Code v2.1.257 или новее |

403| `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` | Задайте `5m` или `1h` — единственные значения, которые принимает Claude Code, — чтобы выбрать [TTL кэша промптов](/docs/ru/prompt-caching#cache-lifetime) для запросов вне основного диалога, таких как [субагенты](/docs/ru/sub-agents), рабочие процессы и фоновая работа. Имеет приоритет над настройкой `subagentPromptCacheTtl` и над `ENABLE_PROMPT_CACHING_1H`, а `FORCE_PROMPT_CACHING_5M` переопределяет её. API тарифицирует запись в часовой кэш по более высокой ставке. Требуется Claude Code v2.1.242 или новее |405| `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` | Установите `5m` или `1h` — единственные значения, которые принимает Claude Code, — чтобы выбрать [TTL кэша промптов](/docs/ru/prompt-caching#cache-lifetime) для запросов вне основного диалога, таких как [субагенты](/docs/ru/sub-agents), рабочие процессы и фоновая работа. Имеет приоритет над настройкой `subagentPromptCacheTtl` и над `ENABLE_PROMPT_CACHING_1H`, а `FORCE_PROMPT_CACHING_5M` переопределяет её. API тарифицирует запись в кэш на 1 час по более высокой ставке. Требуется Claude Code v2.1.242 или новее |

404| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Установите `1`, чтобы удалять учётные данные из окружения подпроцессов, которые запускает Claude Code, таких как команды Bash, хуки и stdio MCP-серверы. Очистка распознаёт учётные данные по имени переменной или по её значению и оставляет на месте токены GitHub и настройки прокси. См. [Что удаляет очистка окружения подпроцессов](#what-the-subprocess-environment-scrub-removes). `claude-code-action` задаёт её автоматически, когда настроен `allowed_non_write_users` |406| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Установите `1`, чтобы удалять учётные данные из окружения подпроцессов, которые запускает Claude Code, таких как команды Bash, хуки и stdio MCP-серверы. Очистка распознаёт учётные данные по имени переменной или по её значению и оставляет токены GitHub и настройки прокси. См. [Что удаляет очистка окружения подпроцессов](#what-the-subprocess-environment-scrub-removes). `claude-code-action` задаёт её автоматически, когда настроен `allowed_non_write_users` |

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

406| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | Таймаут в миллисекундах для синхронной установки плагинов. При его превышении Claude Code продолжает работу без плагинов и записывает ошибку в лог. Значения по умолчанию нет: без этой переменной синхронная установка ждёт завершения |408| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | Таймаут в миллисекундах для синхронной установки плагинов. При превышении Claude Code продолжает работу без плагинов и записывает ошибку в лог. Значения по умолчанию нет: без этой переменной синхронная установка ждёт завершения |

407| `CLAUDE_CODE_SYNC_SKILLS` | Установите `1` в неинтерактивном режиме с флагом `-p`, чтобы Claude Code в этом запуске загрузил скиллы, включённые для вашей учётной записи claude.ai, и дождался их списка (не дольше `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`), прежде чем выполнить первый запрос. Требует аутентификации claude.ai. Терминальные сессии, в которых вы входите с учётной записью claude.ai, [синхронизируют эти скиллы](/docs/ru/skills#where-synced-skills-load) без этой переменной, поэтому задавайте её, только когда запуску `-p` нужны ваши актуальные скиллы уже в первом запросе |409| `CLAUDE_CODE_SYNC_SKILLS` | Установите `1` в неинтерактивном режиме с флагом `-p`, чтобы Claude Code в этом запуске загрузил скиллы, включённые для вашего аккаунта claude.ai, и дождался их списка, но не дольше `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`, прежде чем выполнить первый запрос. Требует аутентификации через claude.ai. Терминальные сессии, в которых вы входите с аккаунтом claude.ai, [синхронизируют эти скиллы](/docs/ru/skills#where-synced-skills-load) без этой переменной, поэтому задавайте её, только когда запуску `-p` нужны ваши текущие скиллы уже при первом запросе |

408| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | Таймаут в миллисекундах для повторной синхронизации скиллов, которая выполняется посреди сессии, когда приложение на основе [Agent SDK](/docs/ru/agent-sdk/typescript#query-object) перезагружает скиллы (по умолчанию: 30000). При его превышении перезагрузка продолжается с теми скиллами, которые уже поступили, а оставшиеся загрузки завершаются в фоновом режиме |410| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | Таймаут в миллисекундах для повторной синхронизации скиллов, которая выполняется посреди сессии, когда приложение на основе [Agent SDK](/docs/ru/agent-sdk/typescript#query-object) перезагружает скиллы (по умолчанию: 30000). При превышении перезагрузка продолжается с теми скиллами, которые уже поступили, а оставшиеся загрузки завершаются в фоне |

409| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | Таймаут в миллисекундах, в течение которого первый запрос ждёт начальный список скиллов, когда задана `CLAUDE_CODE_SYNC_SKILLS` (по умолчанию: 5000). При его превышении первый запрос выполняется с теми скиллами, которые уже поступили. В любом случае загрузки завершаются в фоновом режиме, а Claude ожидает загрузки скилла, когда вызывает этот скилл |411| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | Таймаут в миллисекундах, в течение которого первый запрос ждёт исходный список скиллов, когда задана `CLAUDE_CODE_SYNC_SKILLS` (по умолчанию: 5000). При превышении первый запрос выполняется с теми скиллами, которые уже поступили. Загрузки в любом случае завершаются в фоне, и Claude ждёт загрузки скилла, когда вызывает этот скилл |

410| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | Установите `false`, чтобы отключить подсветку синтаксиса в выводе diff. Полезно, когда цвета мешают настройке вашего терминала. Чтобы также отключить подсветку в блоках кода и предпросмотре файлов, используйте настройку [`syntaxHighlightingDisabled`](/docs/ru/settings-reference#syntaxhighlightingdisabled) |412| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | Установите `false`, чтобы отключить подсветку синтаксиса в выводе diff. Полезно, когда цвета мешают настройке вашего терминала. Чтобы также отключить подсветку в блоках кода и предпросмотре файлов, используйте настройку [`syntaxHighlightingDisabled`](/docs/ru/settings-reference#syntaxhighlightingdisabled) |

411| `CLAUDE_CODE_TASK_LIST_ID` | Использует общий список задач в нескольких сессиях. Задайте одинаковый ID в нескольких экземплярах Claude Code, чтобы координировать работу через общий список задач, в [сессиях, где есть инструменты Task](/docs/ru/tools-reference#task-tool-availability). См. [Список задач](/docs/ru/interactive-mode#task-list) |413| `CLAUDE_CODE_TASK_LIST_ID` | Позволяет использовать один список задач в нескольких сессиях. Задайте одинаковый ID в нескольких экземплярах Claude Code, чтобы координировать работу над общим списком задач в [сессиях, где есть инструменты Task](/docs/ru/tools-reference#task-tool-availability). См. [Список задач](/docs/ru/interactive-mode#task-list) |

412| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | Переопределяет в миллисекундах, сколько неинтерактивная сессия ждёт при выходе, пока её [команда агентов](/docs/ru/agent-teams) завершит свёртывание. Принимает значения от 1000 до 60000; значение вне диапазона игнорируется, и применяется значение по умолчанию 10000. Требуется Claude Code v2.1.206 или новее |414| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | Переопределяет в миллисекундах, сколько неинтерактивная сессия ждёт при выходе, пока её [команда агентов](/docs/ru/agent-teams) завершит свёртывание. Принимает значения от 1000 до 60000; значение вне диапазона игнорируется, и применяется значение по умолчанию 10000. Требуется Claude Code v2.1.206 или новее |

413| `CLAUDE_CODE_TMPDIR` | Переопределяет каталог временных файлов, используемый для внутренних временных файлов. Claude Code добавляет к этому пути `/claude-{uid}/` в Unix или `/claude/` в Windows. По умолчанию: `/tmp` в macOS, `os.tmpdir()` в Linux и Windows. В macOS и Linux [изолированные в песочнице](/docs/ru/sandboxing) подпроцессы Bash получают короткий резервный `$TMPDIR` внутри системного каталога по умолчанию, если ваше переопределение является длинным путём, поскольку некоторые инструменты дают сбой при слишком длинных путях к временным файлам. Неизолированные команды Bash наследуют `$TMPDIR` вашей оболочки, если он задан. В нативной Windows, если ваша оболочка не задаёт `$TMPDIR`, команда Bash, ссылающаяся на `$TMPDIR`, получает ваше переопределение или `%TEMP%`, если вы его не задали. Собственные временные файлы Claude Code всегда используют ваше переопределение. Задайте её в оболочке, пользовательских настройках или управляемых настройках. Игнорируется в [настройках проекта и локальных настройках](/docs/ru/settings-reference#variables-claude-code-ignores-in-env) |415| `CLAUDE_CODE_TMPDIR` | Переопределяет временный каталог для внутренних временных файлов. Claude Code добавляет к этому пути `/claude-{uid}/` в Unix или `/claude/` в Windows. По умолчанию: `/tmp` в macOS, `os.tmpdir()` в Linux и Windows. В macOS и Linux подпроцессы Bash, работающие [в песочнице](/docs/ru/sandboxing), получают короткий резервный `$TMPDIR` в системном каталоге по умолчанию, если ваше переопределение — длинный путь, поскольку некоторые инструменты дают сбой при слишком длинных путях к временным файлам. Команды Bash вне песочницы наследуют `$TMPDIR` вашей оболочки, если она его задаёт. В нативной Windows, если ваша оболочка не задаёт `$TMPDIR`, команда Bash, ссылающаяся на `$TMPDIR`, получает ваше переопределение или `%TEMP%`, если вы его не задали. Собственные временные файлы Claude Code всегда используют ваше переопределение. Задайте её в оболочке, пользовательских или управляемых настройках. Игнорируется в [настройках проекта и локальных настройках](/docs/ru/settings-reference#variables-claude-code-ignores-in-env) |

414| `CLAUDE_CODE_TMUX_TRUECOLOR` | Установите любое непустое значение, например `1`, чтобы разрешить 24-битный вывод truecolor внутри tmux. **Значение `0` или `false` тоже разрешает truecolor**, в отличие от большинства переменных включения/выключения; удалите переменную, чтобы восстановить ограничение в 256 цветов. По умолчанию Claude Code ограничивается 256 цветами, когда задан `$TMUX`, поскольку tmux не пропускает escape-последовательности truecolor без соответствующей настройки. Задайте её после добавления `set -ga terminal-overrides ',*:Tc'` в ваш `~/.tmux.conf`. Другие настройки tmux см. в разделе [Настройка терминала](/docs/ru/terminal-config) |416| `CLAUDE_CODE_TMUX_TRUECOLOR` | Установите любое непустое значение, например `1`, чтобы разрешить 24-битный вывод truecolor внутри tmux. **Значение `0` или `false` по-прежнему разрешает truecolor**, в отличие от большинства переменных включения/отключения; удалите переменную, чтобы восстановить ограничение до 256 цветов. По умолчанию Claude Code ограничивает вывод 256 цветами, когда задана `$TMUX`, поскольку tmux не пропускает escape-последовательности truecolor, если это не настроено. Задайте эту переменную после добавления `set -ga terminal-overrides ',*:Tc'` в ваш `~/.tmux.conf`. Другие настройки tmux см. в разделе [Настройка терминала](/docs/ru/terminal-config) |

415| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | В Linux и WSL задайте список через запятую тех видов процессов, которые Claude Code [исключает из ограничения памяти для инструментов](/docs/ru/tools-reference#memory-limit-on-linux-and-wsl), например `mcp` или `lsp`. Задайте `none`, чтобы ограничить все виды, или `all-new`, чтобы ограничить только команды инструментов Bash, PowerShell и Monitor. Claude Code держит команды инструментов Bash, PowerShell и Monitor под ограничением независимо от того, что вы перечислите. Требуется Claude Code v2.1.246 или новее |417| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | В Linux и WSL задайте разделённый запятыми список видов процессов, которые Claude Code [исключает из ограничения памяти для инструментов](/docs/ru/tools-reference#memory-limit-on-linux-and-wsl), например `mcp` или `lsp`. Установите `none`, чтобы ограничивать все виды, или `all-new`, чтобы ограничивать только команды инструментов Bash, PowerShell и Monitor. Claude Code оставляет команды инструментов Bash, PowerShell и Monitor под ограничением независимо от того, что вы перечислите. Требуется Claude Code v2.1.246 или новее |

416| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | В Linux и WSL задайте размер, например `4G`, чтобы [ограничить память, которую могут использовать команды инструментов Bash и PowerShell](/docs/ru/tools-reference#memory-limit-on-linux-and-wsl), а в v2.1.246 или новее — и команды инструмента Monitor. Записывайте размер цифрами: без суффикса для количества байтов или с суффиксом `K`, `M`, `G` или `T`. Задайте `0` или `off`, чтобы отключить ограничение. После того как первый процесс, запущенный Claude Code, включил или отключил ограничение, изменённое значение вступает в силу при следующем запуске `claude`. Требуется Claude Code v2.1.233 или новее |418| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | В Linux и WSL задайте размер, например `4G`, чтобы [ограничить память, которую могут использовать команды инструментов Bash и PowerShell](/docs/ru/tools-reference#memory-limit-on-linux-and-wsl), а в v2.1.246 или новее — и команды инструмента Monitor. Записывайте размер цифрами: без суффикса для количества байтов или с суффиксом `K`, `M`, `G` или `T`. Установите `0` или `off`, чтобы отключить ограничение. После того как первый процесс, запущенный Claude Code, включил или отключил ограничение, изменённое значение вступает в силу при следующем запуске `claude`. Требуется Claude Code v2.1.233 или новее |

417| `CLAUDE_CODE_TRANSCRIPT_LOCAL_GC` | Установите `1`, чтобы ограничить рост [файла транскрипта](/docs/ru/sessions#where-transcripts-are-stored) длительной сессии `-p` или Agent SDK. После каждого сжатия контекста, как только файл превышает 5 МБ, Claude Code удаляет историю, предшествующую этому сжатию. При возобновлении сессии восстанавливается тот же диалог независимо от того, был ли файл урезан. Задайте её в окружении, из которого вы запускаете Claude Code, поскольку блок `env` в настройках не может её включить. Требуется Claude Code v2.1.287 или новее |419| `CLAUDE_CODE_TRANSCRIPT_LOCAL_GC` | Установите `1`, чтобы ограничить рост [файла транскрипта](/docs/ru/sessions#where-transcripts-are-stored) длительной сессии `-p` или Agent SDK. После каждого сжатия контекста, если файл больше 5 МБ, Claude Code удаляет историю, предшествующую этому сжатию. При возобновлении сессии восстанавливается тот же диалог независимо от того, был ли файл обрезан. Задайте её в окружении, из которого запускаете Claude Code, поскольку блок `env` в настройках не может её включить. Требуется Claude Code v2.1.287 или новее |

418| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Срок в миллисекундах, по истечении которого Claude Code отменяет диалоговое окно, пересылаемое удалённому клиенту, например хосту [Remote Control](/docs/ru/remote-control) или SDK, или диалоговое окно подтверждения для [задержанного межсессионного сообщения](/docs/ru/cross-session-messaging#control-inbound-messages); запросы разрешений и вопросы `AskUserQuestion` используют собственные механизмы и на них эта переменная не распространяется. В Claude Code v2.1.236 или новее она также ограничивает по времени появляющийся посреди сессии [запрос согласия на использование кредитов Fable](/docs/ru/model-config#fable-and-usage-credits) в сессии, которая может работать без присмотра. Полные правила истечения срока для задержанных сообщений, включая случаи, когда срок не применяется, описаны в разделах [Контроль входящих сообщений](/docs/ru/cross-session-messaging#control-inbound-messages) и [Неинтерактивные сессии](/docs/ru/cross-session-messaging#non-interactive-sessions). Переопределяет настройку [`dialogExpiry`](/docs/ru/settings-reference#dialogexpiry). `0` или отрицательное значение отключает срок |420| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Крайний срок в миллисекундах, по истечении которого Claude Code отменяет диалоговое окно, пересылаемое удалённому клиенту, например хосту [Remote Control](/docs/ru/remote-control) или SDK, или диалоговое окно подтверждения для [задержанного межсессионного сообщения](/docs/ru/cross-session-messaging#control-inbound-messages); запросы разрешений и вопросы `AskUserQuestion` используют собственные механизмы, и эта переменная на них не распространяется. В Claude Code v2.1.236 или новее она также ограничивает по времени появляющийся посреди сессии [запрос согласия на использование кредитов использования Fable](/docs/ru/model-config#fable-and-usage-credits) в сессии, которая может выполняться без присмотра. Полные правила истечения срока задержанных сообщений, включая случаи, когда крайний срок не применяется, описаны в разделах [Контроль входящих сообщений](/docs/ru/cross-session-messaging#control-inbound-messages) и [Неинтерактивные сессии](/docs/ru/cross-session-messaging#non-interactive-sessions). Переопределяет настройку [`dialogExpiry`](/docs/ru/settings-reference#dialogexpiry). `0` или отрицательное значение отключает крайний срок |

422| `CLAUDE_CODE_USE_MANTLE` | Использовать [эндпоинт Mantle](/docs/ru/amazon-bedrock#use-the-mantle-endpoint) Amazon Bedrock |424| `CLAUDE_CODE_USE_MANTLE` | Использовать [эндпоинт Mantle](/docs/ru/amazon-bedrock#use-the-mantle-endpoint) Amazon Bedrock |

423| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Установите `1`, чтобы обнаруживать пользовательские команды, субагентов и стили вывода с помощью файловых API Node.js вместо ripgrep. Задайте её, если встроенный бинарный файл ripgrep недоступен или заблокирован в вашей среде. Не влияет на Grep и инструменты поиска файлов |425| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Установите `1`, чтобы обнаруживать пользовательские команды, субагентов и стили вывода с помощью файловых API Node.js вместо ripgrep. Задайте это, если встроенный бинарный файл ripgrep недоступен или заблокирован в вашей среде. Не влияет на Grep и инструменты поиска файлов |

424| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Управляет инструментом PowerShell. В Windows без Git Bash инструмент включается автоматически; установите `0`, чтобы отключить его. В Windows с установленным Git Bash инструмент по умолчанию включён для аккаунтов claude.ai и Console; установите `1`, чтобы включить его в сессиях Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, или `0`, чтобы выключить его. В Linux, macOS и WSL установите `1`, чтобы включить его; для этого требуется `pwsh` в вашем `PATH`. Когда инструмент включён в Windows, Claude может выполнять команды PowerShell нативно, а не через Git Bash. См. [инструмент PowerShell](/docs/ru/tools-reference#powershell-tool) |426| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Управляет инструментом PowerShell. В Windows без Git Bash инструмент включается автоматически; установите `0`, чтобы отключить его. В Windows с установленным Git Bash инструмент по умолчанию включён для учётных записей claude.ai и Console; установите `1`, чтобы включить его в сессиях Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, или `0`, чтобы выключить его. В Linux, macOS и WSL установите `1`, чтобы включить его; для этого требуется `pwsh` в вашем `PATH`. Если инструмент включён в Windows, Claude может выполнять команды PowerShell нативно, а не через Git Bash. См. [инструмент PowerShell](/docs/ru/tools-reference#powershell-tool) |

426| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | Укажите количество миллисекунд, в течение которых [WebFetch](/docs/ru/tools-reference#webfetch-tool-behavior) хранит в кэше ответ для каждого загруженного URL. Значение по умолчанию — `900000`, то есть 15 минут. Принимаются только цифры; `0`, десятичная дробь или любая другая запись сохраняют значение по умолчанию. Claude Code считывает значение один раз при запуске, поэтому изменение в блоке `env` настроек вступает в силу при следующем запуске `claude`. Требуется Claude Code v2.1.233 или новее |428| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | Задаёт количество миллисекунд, в течение которых [WebFetch](/docs/ru/tools-reference#webfetch-tool-behavior) хранит в кэше ответ для каждого загруженного URL. Значение по умолчанию — `900000`, то есть 15 минут. Принимаются только цифры; `0`, десятичное число или любое другое написание сохраняют значение по умолчанию. Claude Code считывает значение один раз при запуске, поэтому изменение в блоке `env` настроек применяется при следующем запуске `claude`. Требуется Claude Code v2.1.233 или новее |

427| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | Верхний предел в миллисекундах для времени, в течение которого [WebFetch](/docs/ru/tools-reference#webfetch-tool-behavior) ожидает загрузки страницы, включая все выполняемые перенаправления. Загрузка, не завершившаяся к этому моменту, завершается ошибкой истечения срока. Значение по умолчанию — `300000`, то есть пять минут. Установите `0`, чтобы снять ограничение. Принимаются только цифры; десятичная дробь или любая другая запись сохраняют значение по умолчанию. Требуется Claude Code v2.1.268 или новее |429| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | Верхний предел в миллисекундах для времени, в течение которого [WebFetch](/docs/ru/tools-reference#webfetch-tool-behavior) ожидает загрузки страницы, включая все перенаправления, по которым он переходит. Загрузка, не завершившаяся к этому моменту, завершается ошибкой превышения дедлайна. Значение по умолчанию — `300000`, то есть пять минут. Установите `0`, чтобы снять ограничение. Принимаются только цифры; десятичное число или любое другое написание сохраняют значение по умолчанию. Требуется Claude Code v2.1.268 или новее |

428| `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` | Когда `CLAUDE_AUTO_BACKGROUND_TASKS` имеет значение `1`, определяет, сколько Claude Code ждёт перед каждым напоминанием Claude проверить [фоновые субагенты](/docs/ru/sub-agents#run-subagents-in-foreground-or-background), которые ещё выполняются. Принимает одно или несколько значений ожидания через запятую в целых секундах от `1` до `86400`, например `600` или `600,1800,3600`. Каждое значение — это время ожидания перед следующим напоминанием, а последнее значение повторяется. Принимаются только цифры; любое другое значение или запись считаются неустановленными. Если переменная не задана, напоминаний нет. Требуется Claude Code v2.1.283 или новее |430| `CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR` | Скорость пополнения [лимита WebSearch](/docs/ru/tools-reference#session-search-limit) сессии в вызовах в час. Значение по умолчанию — `100` в интерактивной сессии терминала. В [неинтерактивной](/docs/ru/headless) сессии значение по умолчанию — `0`, что отключает пополнение. Принимаются только цифры; любое другое написание считается незаданным значением. Требуется Claude Code v2.1.290 или новее |

429| `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` | Сколько агентов одновременно выполняет один запуск [workflow](/docs/ru/workflows), от `1` до `256`. По умолчанию запуск выполняет до 16 агентов одновременно, меньше — когда Claude Code доступно меньше CPU; вызовы `agent()` в очереди ждут освобождения слота. Транскрипт каждого выполняющегося агента хранится в памяти Claude Code, поэтому более высокие значения увеличивают потребление оперативной памяти. Принимаются только цифры; значения вне диапазона и другие записи сохраняют значение по умолчанию. Требуется Claude Code v2.1.269 или новее |431| `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` | Когда `CLAUDE_AUTO_BACKGROUND_TASKS` имеет значение `1`, задаёт, сколько Claude Code ждёт перед каждым напоминанием Claude проверить [фоновые субагенты](/docs/ru/sub-agents#run-subagents-in-foreground-or-background), которые всё ещё выполняются. Принимает одно или несколько значений ожидания через запятую в целых секундах от `1` до `86400`, например `600` или `600,1800,3600`. Каждое значение — это ожидание перед следующим напоминанием, а последнее значение повторяется. Принимаются только цифры; любое другое значение или написание считается незаданным. Если переменная не задана, напоминаний нет. Требуется Claude Code v2.1.283 или новее |

430| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | Верхний предел в миллисекундах для времени, в течение которого агент [workflow](/docs/ru/workflows) ожидает начала первого ответа соседнего агента с тем же префиксом, прежде чем отправить собственный первый запрос. Когда при распараллеливании запускается несколько агентов с общим [префиксом кэша промптов](/docs/ru/workflows#prompt-caching-in-a-fan-out), Claude Code задерживает всех агентов, кроме первого, не дольше этого времени, чтобы остальные читали префикс из кэша, а не обрабатывали его каждый без кэша. Значение по умолчанию — `5000`. Установите `0`, чтобы отключить ожидание. Когда задана `DISABLE_PROMPT_CACHING`, агенты никогда не ждут. Требуется Claude Code v2.1.229 или новее |432| `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` | Сколько агентов одновременно выполняет один запуск [рабочего процесса](/docs/ru/workflows), от `1` до `256`. По умолчанию запуск выполняет до 16 агентов одновременно или меньше, если Claude Code доступно меньше CPU; поставленные в очередь вызовы `agent()` ждут освобождения слота. Транскрипт каждого выполняющегося агента хранится в оперативной памяти Claude Code, поэтому более высокие значения увеличивают потребление памяти. Принимаются только цифры; значения вне диапазона и другие написания сохраняют значение по умолчанию. Требуется Claude Code v2.1.269 или новее |

431| `CLAUDE_CONFIG_DIR` | Переопределяет каталог конфигурации (по умолчанию: `~/.claude`). Все настройки, история сессий и плагины хранятся по этому пути. Об учётных данных см. [где Claude Code хранит учётные данные](/docs/ru/authentication#credential-management). Полезно для параллельной работы с несколькими аккаунтами: например, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`. Задайте её в оболочке, пользовательских настройках или управляемых настройках. В файле настроек укажите [абсолютный путь](#in-settings-files). Игнорируется в [настройках проекта и локальных настройках](/docs/ru/settings-reference#variables-claude-code-ignores-in-env) |433| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | Верхний предел в миллисекундах для времени, в течение которого агент [рабочего процесса](/docs/ru/workflows) ждёт начала первого ответа соседнего агента с тем же префиксом, прежде чем отправить свой первый запрос. Когда при распараллеливании (fan-out) запускается несколько агентов с общим [префиксом кэша промптов](/docs/ru/workflows#prompt-caching-in-a-fan-out), Claude Code задерживает всех агентов, кроме первого, не дольше этого времени, чтобы остальные читали кэшированный префикс, а не обрабатывали его каждый без кэша. По умолчанию `5000`. Установите `0`, чтобы отключить ожидание. Если задана `DISABLE_PROMPT_CACHING`, агенты никогда не ждут. Требуется Claude Code v2.1.229 или новее |

432| `CLAUDE_DISABLE_ADOPT` | Установите `1`, чтобы останавливать выполняющуюся фоновую работу вместо её переноса, когда вы переводите сессию в фон нажатием `←` или с помощью [`/background`](/docs/ru/agent-view#from-inside-a-session). Claude Code просит подтверждения перед переводом в фон, а затем останавливает задачи, которые иначе были бы перенесены. Требуется Claude Code v2.1.195 или новее |434| `CLAUDE_CONFIG_DIR` | Переопределяет каталог конфигурации (по умолчанию: `~/.claude`). Все настройки, история сессий и плагины хранятся по этому пути. Об учётных данных см. [где Claude Code хранит учётные данные](/docs/ru/authentication#credential-management). Полезно для параллельной работы с несколькими учётными записями: например, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`. Задайте её в оболочке, пользовательских настройках или управляемых настройках. В файле настроек укажите [абсолютный путь](#in-settings-files). Игнорируется в [настройках проекта и локальных настройках](/docs/ru/settings-reference#variables-claude-code-ignores-in-env) |

433| `CLAUDE_EFFORT` | Автоматически устанавливается в подпроцессах инструмента Bash и командах хуков равной [уровню effort](/docs/ru/model-config#adjust-effort-level), действующему на момент запуска подпроцесса: `low`, `medium`, `high`, `xhigh` или `max`. Совпадает с полем `effort.level`, передаваемым [хукам](/docs/ru/hooks). Устанавливается только тогда, когда текущая модель поддерживает параметр effort |435| `CLAUDE_DISABLE_ADOPT` | Установите `1`, чтобы останавливать выполняющуюся фоновую работу, а не переносить её, когда вы переводите сессию в фоновый режим нажатием `←` или с помощью [`/background`](/docs/ru/agent-view#from-inside-a-session). Claude Code просит подтвердить перевод в фоновый режим, а затем останавливает задачи, которые иначе были бы перенесены. Требуется Claude Code v2.1.195 или новее |

434| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Установите `1`, чтобы принудительно включить побайтовый сторожевой таймер простоя потоковой передачи, или `0`, чтобы принудительно отключить его. `0` также отключает [срок ожидания первого байта](/docs/ru/network-config#streaming-idle-watchdogs) на тех соединениях, где этот срок действует. Если переменная не задана, сторожевой таймер по умолчанию включён для прямых соединений с Anthropic API и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), а также для потоковых ответов на соединениях через [шлюз](/docs/ru/gateways), доступный через `ANTHROPIC_BASE_URL` или `ANTHROPIC_AWS_BASE_URL`; до v2.1.222 он не работал на этих соединениях через шлюз, поэтому сторожевой таймер уровня событий мог сообщать там о зависании даже при поступлении keep-alive-пингов. О таймаутах и взаимодействии таймеров см. [Сторожевые таймеры простоя потоковой передачи](/docs/ru/network-config#streaming-idle-watchdogs) |436| `CLAUDE_EFFORT` | Автоматически задаётся в подпроцессах инструмента Bash и командах хуков и равна [уровню effort](/docs/ru/model-config#adjust-effort-level), действующему на момент запуска подпроцесса: `low`, `medium`, `high`, `xhigh` или `max`. Совпадает с полем `effort.level`, передаваемым в [хуки](/docs/ru/hooks). Задаётся, только если текущая модель поддерживает параметр effort |

435| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Установите `1`, чтобы включить побайтовый сторожевой таймер простоя потоковой передачи для ответов Amazon Bedrock `vnd.amazon.eventstream`; это также включает [срок ожидания первого байта](/docs/ru/network-config#streaming-idle-watchdogs) для потоковых запросов Bedrock. По умолчанию выключено. Таймаут настраивается через `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |437| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Установите `1`, чтобы принудительно включить сторожевой таймер простоя потоковой передачи на уровне байтов, или `0`, чтобы принудительно отключить его. `0` также отключает [дедлайн первого байта](/docs/ru/network-config#streaming-idle-watchdogs) на тех подключениях, где этот дедлайн действует. Если переменная не задана, сторожевой таймер по умолчанию включён для прямых подключений к Anthropic API и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), а также для потоковых ответов на подключениях через [шлюз](/docs/ru/gateways), доступный через `ANTHROPIC_BASE_URL` или `ANTHROPIC_AWS_BASE_URL`; до v2.1.222 он не работал на этих подключениях через шлюз, поэтому сторожевой таймер на уровне событий мог сообщать о зависании, даже когда поступали keep-alive пинги. О таймаутах и взаимодействии таймеров см. [Сторожевые таймеры простоя потоковой передачи](/docs/ru/network-config#streaming-idle-watchdogs) |

436| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Установите `0`, чтобы принудительно отключить сторожевой таймер простоя потоковой передачи уровня событий, или `1`, чтобы принудительно включить его. Если переменная не задана, сторожевой таймер по умолчанию включён для всех провайдеров. До v2.1.196 значение по умолчанию управлялось сервером для прямого Anthropic API и было выключено для других провайдеров. Таймаут настраивается через `CLAUDE_STREAM_IDLE_TIMEOUT_MS`; о других таймерах зависания, работающих параллельно с этим, см. [Сторожевые таймеры простоя потоковой передачи](/docs/ru/network-config#streaming-idle-watchdogs) |438| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Установите `1`, чтобы включить сторожевой таймер простоя потоковой передачи на уровне байтов для ответов Amazon Bedrock `vnd.amazon.eventstream`; это также включает [дедлайн первого байта](/docs/ru/network-config#streaming-idle-watchdogs) для потоковых запросов Bedrock. По умолчанию отключено. Настройте таймаут с помощью `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |

437| `CLAUDE_ENV_FILE` | Путь к shell-скрипту, содержимое которого Claude Code выполняет перед каждой командой Bash в том же процессе оболочки, поэтому экспортированные в файле переменные видны команде. Используйте для сохранения активации virtualenv или conda между командами. Также заполняется динамически хуками [SessionStart](/docs/ru/hooks#persist-environment-variables), [Setup](/docs/ru/hooks#setup), [CwdChanged](/docs/ru/hooks#cwdchanged) и [FileChanged](/docs/ru/hooks#filechanged) |439| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Установите `0`, чтобы принудительно отключить сторожевой таймер простоя потоковой передачи на уровне событий, или `1`, чтобы принудительно включить его. Если переменная не задана, сторожевой таймер по умолчанию включён для всех провайдеров. До v2.1.196 поведение по умолчанию без этой переменной управлялось сервером для прямого Anthropic API и было отключено для других провайдеров. Настройте таймаут с помощью `CLAUDE_STREAM_IDLE_TIMEOUT_MS`; о других таймерах зависания, работающих вместе с этим, см. [Сторожевые таймеры простоя потоковой передачи](/docs/ru/network-config#streaming-idle-watchdogs) |

438| `CLAUDE_JOB_DIR` | Устанавливается Claude Code в каждой [фоновой сессии](/docs/ru/agent-view) равной каталогу `~/.claude/jobs/<id>` этой сессии. Shell-команды, выполняемые сессией, наследуют её. Записывайте временные файлы в [`$CLAUDE_JOB_DIR/tmp`](/docs/ru/agent-view#where-state-is-stored). Вызовы `Write` и `Edit` от Claude в этом каталоге не запрашивают разрешения, а сам каталог удаляется при удалении сессии |440| `CLAUDE_ENV_FILE` | Путь к shell-скрипту, содержимое которого Claude Code выполняет перед каждой командой Bash в том же процессе оболочки, поэтому экспортированные в файле переменные видны команде. Используйте для сохранения активации virtualenv или conda между командами. Также динамически заполняется хуками [SessionStart](/docs/ru/hooks#persist-environment-variables), [Setup](/docs/ru/hooks#setup), [CwdChanged](/docs/ru/hooks#cwdchanged) и [FileChanged](/docs/ru/hooks#filechanged) |

439| `CLAUDE_PID` | Claude Code устанавливает её равной идентификатору собственного процесса в порождаемых им подпроцессах: командах инструментов Bash и PowerShell и командах хуков. В Linux интеграция оболочки инструмента Bash использует её, чтобы отклонять шаблон `pkill`, который совпал бы с самим процессом Claude Code; см. [справочник по ошибкам](/docs/ru/errors#pkill-pattern-matches-the-claude-code-process). Считывайте её в собственных скриптах, чтобы намеренно идентифицировать родительский процесс Claude Code или отправить ему сигнал. Требуется Claude Code v2.1.214 или новее |441| `CLAUDE_JOB_DIR` | Задаётся Claude Code в каждой [фоновой сессии](/docs/ru/agent-view) как каталог `~/.claude/jobs/<id>` этой сессии. Shell-команды, которые выполняет сессия, наследуют её. Записывайте временные файлы в [`$CLAUDE_JOB_DIR/tmp`](/docs/ru/agent-view#where-state-is-stored). Вызовы `Write` и `Edit` от Claude в этом каталоге не запрашивают разрешения, а сам каталог удаляется при удалении сессии |

440| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Префикс для автоматически генерируемых имён сессий [Remote Control](/docs/ru/remote-control), когда явное имя не указано. По умолчанию — имя хоста вашей машины, что даёт имена вида `myhost-graceful-unicorn`. Флаг CLI `--remote-control-session-name-prefix` задаёт то же значение для одного вызова |442| `CLAUDE_PID` | Claude Code записывает в эту переменную идентификатор собственного процесса в порождаемых им подпроцессах: командах инструментов Bash и PowerShell и командах хуков. В Linux интеграция с оболочкой инструмента Bash использует её, чтобы отклонять шаблон `pkill`, который совпал бы с самим процессом Claude Code; см. [справочник по ошибкам](/docs/ru/errors#pkill-pattern-matches-the-claude-code-process). Считывайте её в собственных скриптах, чтобы намеренно идентифицировать родительский процесс Claude Code или отправлять ему сигналы. Требуется Claude Code v2.1.214 или новее |

441| `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` | Срок в миллисекундах для получения первого байта ответа на потоковый запрос на тех соединениях, где действует [срок ожидания первого байта](/docs/ru/network-config#streaming-idle-watchdogs). О том, как Claude Code ограничивает это значение, какое дополнительное время добавляет для больших тел запросов и как выбирает срок, если переменная не задана, см. [No response from API](/docs/ru/errors#no-response-from-api). Требуется Claude Code v2.1.242 или новее |443| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Префикс для автоматически генерируемых имён сессий [Remote Control](/docs/ru/remote-control), когда явное имя не указано. По умолчанию используется имя хоста вашего компьютера, что даёт имена вида `myhost-graceful-unicorn`. Флаг CLI `--remote-control-session-name-prefix` задаёт то же значение для одного вызова |

442| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Таймаут в миллисекундах, после которого сторожевые таймеры простоя потоковой передачи уровня событий и байтов закрывают зависшее соединение. Если вы задаёте эту переменную явно, минимальное значение — `300000` (5 минут); меньшие значения молча повышаются до минимума, чтобы учесть длительные паузы расширенного мышления и буферизацию прокси, а побайтовый сторожевой таймер ограничивает значение 30 минутами. `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` имеет приоритет над этой переменной для побайтового сторожевого таймера. О значениях по умолчанию для каждого сторожевого таймера см. [Сторожевые таймеры простоя потоковой передачи](/docs/ru/network-config#streaming-idle-watchdogs) |444| `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` | Дедлайн в миллисекундах для первого байта ответа на потоковый запрос на тех подключениях, где действует [дедлайн первого байта](/docs/ru/network-config#streaming-idle-watchdogs). О том, как Claude Code ограничивает это значение, какое дополнительное время он добавляет для больших тел запросов и как выбирает дедлайн, если переменная не задана, см. [No response from API](/docs/ru/errors#no-response-from-api). Требуется Claude Code v2.1.242 или новее |

443| `CLAUDE_SUBAGENT_BG_SHELL_MAX_MS` | Удалена в v2.1.260 и теперь ни на что не влияет. Ранее ограничивала время выполнения в миллисекундах для [фоновой shell-команды](/docs/ru/interactive-mode#background-bash-commands), запущенной [субагентом](/docs/ru/sub-agents), со значением по умолчанию 60 минут. См. [правила времени жизни фоновых команд](/docs/ru/tools-reference#background-commands) |445| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Таймаут в миллисекундах, по истечении которого сторожевые таймеры простоя потоковой передачи на уровне событий и байтов закрывают зависшее подключение. Если вы задаёте эту переменную явно, минимум составляет `300000` (5 минут); меньшие значения молча повышаются до минимума, чтобы учитывать длительные паузы расширенного мышления и буферизацию в прокси, а сторожевой таймер на уровне байтов ограничивает значение 30 минутами. `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` имеет приоритет над этой переменной для сторожевого таймера на уровне байтов. Значения по умолчанию для каждого сторожевого таймера, когда переменная не задана, см. в разделе [Сторожевые таймеры простоя потоковой передачи](/docs/ru/network-config#streaming-idle-watchdogs) |

446| `CLAUDE_SUBAGENT_BG_SHELL_MAX_MS` | Удалена в v2.1.260 и теперь ни на что не влияет. Ранее ограничивала в миллисекундах время выполнения [фоновой shell-команды](/docs/ru/interactive-mode#background-bash-commands), запущенной [субагентом](/docs/ru/sub-agents), со значением по умолчанию 60 минут. См. [правила времени жизни фоновых команд](/docs/ru/tools-reference#background-commands) |

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

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

446| `DISABLE_AUTO_COMPACT` | Установите `1`, чтобы отключить автоматическое сжатие контекста при приближении к лимиту контекста. Ручная команда `/compact` остаётся доступной. Используйте, когда хотите явно контролировать момент сжатия. Переопределяет настройку [`autoCompactEnabled`](/docs/ru/settings-reference#autocompactenabled) |449| `DISABLE_AUTO_COMPACT` | Установите `1`, чтобы отключить автоматическое сжатие контекста при приближении к пределу контекста. Ручная команда `/compact` остаётся доступной. Используйте, когда хотите явно контролировать момент сжатия контекста. Переопределяет настройку [`autoCompactEnabled`](/docs/ru/settings-reference#autocompactenabled) |

447| `DISABLE_COMPACT` | Установите `1`, чтобы отключить любое сжатие контекста: и автоматическое сжатие, и ручную команду `/compact` |450| `DISABLE_COMPACT` | Установите `1`, чтобы полностью отключить сжатие контекста: и автоматическое сжатие, и ручную команду `/compact` |

449| `DISABLE_DOCTOR_COMMAND` | Установите `1`, чтобы скрыть скилл проверки настройки [`/doctor`](/docs/ru/commands#all-commands) и его псевдоним `/checkup`. Полезно для управляемых развёртываний, где пользователям не следует запускать диагностику настройки из сессии. Не влияет на команду терминала `claude doctor`. До v2.1.205 эта переменная скрывала команду экрана диагностики `/doctor` |452| `DISABLE_DOCTOR_COMMAND` | Установите `1`, чтобы скрыть скилл проверки настройки [`/doctor`](/docs/ru/commands#all-commands) и его псевдоним `/checkup`. Полезно для управляемых развёртываний, где пользователям не следует запускать диагностику настройки из сессии. Не влияет на терминальную команду `claude doctor`. До v2.1.205 эта переменная скрывала команду экрана диагностики `/doctor` |

450| `DISABLE_ERROR_REPORTING` | Установите любое непустое значение, например `1`, чтобы отказаться от отправки отчётов об ошибках. **Значение `0` или `false` также означает отказ**, в отличие от большинства переменных включения/выключения; удалите переменную, чтобы снова включить отчёты об ошибках |453| `DISABLE_ERROR_REPORTING` | Установите любое непустое значение, например `1`, чтобы отказаться от отправки отчётов об ошибках. **Значение `0` или `false` также означает отказ**, в отличие от большинства переменных-переключателей; чтобы снова включить отправку отчётов об ошибках, удалите переменную |

451| `DISABLE_EXTRA_USAGE_COMMAND` | Установите `1`, чтобы скрыть команду `/usage-credits`, позволяющую пользователям приобретать дополнительное использование сверх ограничений частоты запросов |454| `DISABLE_EXTRA_USAGE_COMMAND` | Установите `1`, чтобы скрыть команду `/usage-credits`, позволяющую пользователям приобретать дополнительное использование сверх ограничений частоты запросов |

452| `DISABLE_FEEDBACK_COMMAND` | Установите `1`, чтобы отключить команду `/feedback` и [отзывы, составленные Claude](/docs/ru/tools-reference#sendfeedback-tool-behavior). Также отключает `/bug` и `/share`, которые отправляют отчёты тем же путём; до v2.1.212 они были псевдонимами `/feedback`, поэтому команда отключалась под любым именем. Также принимается старое имя `DISABLE_BUG_COMMAND` |455| `DISABLE_FEEDBACK_COMMAND` | Установите `1`, чтобы отключить команду `/feedback` и [отзывы, составленные Claude](/docs/ru/tools-reference#sendfeedback-tool-behavior). Также отключает `/bug` и `/share`, которые отправляют отчёты тем же путём; до v2.1.212 они были псевдонимами `/feedback`, поэтому команда отключалась под любым из имён. Также принимается старое имя `DISABLE_BUG_COMMAND` |

453| `DISABLE_GROWTHBOOK` | Установите `1` или `true`, чтобы отключить получение флагов функций GrowthBook и использовать значения по умолчанию из кода для каждого флага. Это делает недоступными [Remote Control](/docs/ru/remote-control#requirements) и другие [функции, которым нужно получение флагов функций](#features-that-need-feature-flag-fetching). Значение `0` или `false` оставляет получение включённым. Логирование событий телеметрии остаётся включённым, если не задана также `DISABLE_TELEMETRY` |456| `DISABLE_GROWTHBOOK` | Установите `1` или `true`, чтобы отключить получение флагов функций GrowthBook и использовать для всех флагов значения по умолчанию из кода. Это делает недоступными [Remote Control](/docs/ru/remote-control#requirements) и другие [функции, которым требуется получение флагов функций](#features-that-need-feature-flag-fetching). Значение `0` или `false` оставляет получение включённым. Запись событий телеметрии в лог остаётся включённой, если не задана также `DISABLE_TELEMETRY` |

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

455| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | Установите `1`, чтобы скрыть команду `/install-github-app`. Она уже скрыта при использовании сторонних провайдеров (Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry) |458| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | Установите `1`, чтобы скрыть команду `/install-github-app`. Она уже скрыта при использовании сторонних провайдеров (Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry) |

456| `DISABLE_INTERLEAVED_THINKING` | Установите `1`, чтобы не отправлять бета-заголовок interleaved-thinking. Полезно, когда ваш LLM-шлюз или провайдер не поддерживает [чередующееся мышление](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) |459| `DISABLE_INTERLEAVED_THINKING` | Установите `1`, чтобы не отправлять бета-заголовок interleaved-thinking. Полезно, когда ваш LLM-шлюз или провайдер не поддерживает [чередующееся мышление](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) |

457| `DISABLE_LOGIN_COMMAND` | Установите `1`, чтобы скрыть команду `/login`. Полезно, когда аутентификация выполняется внешними средствами через API-ключи или `apiKeyHelper` |460| `DISABLE_LOGIN_COMMAND` | Установите `1`, чтобы скрыть команду `/login`. Полезно, когда аутентификация выполняется внешними средствами через API-ключи или `apiKeyHelper` |

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

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

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

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

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

467| `DO_NOT_TRACK` | Установите `1`, чтобы отказаться от телеметрии, с тем же эффектом, что и у `DISABLE_TELEMETRY`, в том числе в отношении [получения флагов функций](#features-that-need-feature-flag-fetching). Claude Code считывает эту переменную как стандартное логическое значение, поэтому `0` оставляет телеметрию включённой, и учитывает её как общепринятое соглашение, распознаваемое многими CLI для разработчиков |470| `DO_NOT_TRACK` | Установите `1`, чтобы отказаться от телеметрии, с тем же эффектом, что и у `DISABLE_TELEMETRY`, в том числе в отношении [получения флагов функций](#features-that-need-feature-flag-fetching). Claude Code считывает эту переменную как стандартное логическое значение, поэтому `0` оставляет телеметрию включённой, и учитывает её как общепринятое соглашение, поддерживаемое многими CLI для разработчиков |

468| `ENABLE_BETA_TRACING_DETAILED` | Установите `1` и задайте в `BETA_TRACING_ENDPOINT` эндпоинт вашего коллектора OTLP/HTTP, чтобы включить [подробную бета-трассировку](/docs/ru/monitoring-usage#traces-beta), которая добавляет атрибуты span с содержимым и span `claude_code.hook`. Для интерактивных сессий CLI также требуется, чтобы ваша организация была в списке допущенных к бета-версии. Обе переменные игнорируются в [настройках проекта и локальных настройках](/docs/ru/settings-reference#variables-claude-code-ignores-in-env) |471| `ENABLE_BETA_TRACING_DETAILED` | Установите `1` и задайте в `BETA_TRACING_ENDPOINT` эндпоинт вашего коллектора OTLP/HTTP, чтобы включить [детальную бета-трассировку](/docs/ru/monitoring-usage#traces-beta), которая добавляет атрибуты спанов с содержимым и спан `claude_code.hook`. Для интерактивных сессий CLI также требуется, чтобы ваша организация была включена в список допущенных к бета-версии. Обе переменные игнорируются в [настройках проекта и локальных настройках](/docs/ru/settings-reference#variables-claude-code-ignores-in-env) |

469| `ENABLE_CLAUDEAI_MCP_SERVERS` | Установите `false`, чтобы Claude Code не получал [MCP-серверы claude.ai](/docs/ru/mcp#use-mcp-servers-from-claude-ai). По умолчанию включено для вошедших пользователей. Чтобы отключить это для проекта или организации, используйте вместо этого настройку [`disableClaudeAiConnectors`](/docs/ru/settings-reference#disableclaudeaiconnectors) |472| `ENABLE_CLAUDEAI_MCP_SERVERS` | Установите `false`, чтобы Claude Code не получал [MCP-серверы claude.ai](/docs/ru/mcp#use-mcp-servers-from-claude-ai). По умолчанию включено для вошедших пользователей. Чтобы отключить для отдельного проекта или организации, используйте вместо этого настройку [`disableClaudeAiConnectors`](/docs/ru/settings-reference#disableclaudeaiconnectors) |

470| `ENABLE_PROMPT_CACHING_1H` | Установите `1`, чтобы запрашивать [TTL кэша промптов](/docs/ru/prompt-caching#cache-lifetime) в 1 час вместо 5 минут по умолчанию. Предназначено для пользователей API-ключей, [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai), [Microsoft Foundry](/docs/ru/microsoft-foundry) и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws). Пользователи подписки в пределах включённого использования автоматически получают часовой TTL в [основном диалоге](/docs/ru/prompt-caching#which-ttl-each-request-gets). Пользователи подписки, расходующие [кредиты использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans), могут задать её, чтобы сохранить часовой TTL. Запись в часовой кэш тарифицируется по более высокой ставке. Чтобы вместо этого выбирать TTL для каждой группы запросов, используйте `CLAUDE_CODE_PROMPT_CACHE_TTL` и `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, которые имеют приоритет над этой переменной |473| `ENABLE_PROMPT_CACHING_1H` | Установите `1`, чтобы запрашивать 1-часовой [TTL кэша промптов](/docs/ru/prompt-caching#cache-lifetime) вместо 5 минут по умолчанию. Предназначено для пользователей API-ключей, [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai), [Microsoft Foundry](/docs/ru/microsoft-foundry) и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws). Пользователи подписки в рамках включённого использования автоматически получают 1-часовой TTL для [основного диалога](/docs/ru/prompt-caching#which-ttl-each-request-gets). Пользователи подписки, расходующие [кредиты использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans), могут задать эту переменную, чтобы сохранить 1-часовой TTL. Запись в 1-часовой кэш тарифицируется по более высокой ставке. Чтобы вместо этого выбирать TTL для каждой группы запросов, используйте `CLAUDE_CODE_PROMPT_CACHE_TTL` и `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, которые имеют приоритет над этой переменной |

472| `ENABLE_TOOL_SEARCH` | Управляет [поиском инструментов MCP](/docs/ru/mcp#scale-with-mcp-tool-search). Если переменная не задана, Claude Code по умолчанию откладывает загрузку всех инструментов MCP. При этом он всё же загружает их заранее на моделях Google Cloud's Agent Platform поколения старше Claude 4.5, на развёртывании Microsoft Foundry, размещённом в Azure, и когда `ANTHROPIC_BASE_URL` указывает на хост, не принадлежащий Anthropic. `true` всегда откладывает загрузку и отправляет бета-заголовок, кроме тех же моделей Agent Platform и развёртываний Microsoft Foundry; запросы завершаются ошибкой на прокси, не поддерживающих `tool_reference`. `auto` загружает заранее, когда определения инструментов умещаются в 10% контекста. `auto:N` задаёт собственный порог, например `auto:5` для 5%. `false` загружает все инструменты заранее. Заданное вами значение игнорируется, когда установлена `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`. До v2.1.221 Claude Code отключал поиск инструментов для всех моделей на Google Cloud's Agent Platform, если вы не задавали этой переменной значение `true` |475| `ENABLE_TOOL_SEARCH` | Управляет [MCP Tool Search](/docs/ru/mcp#scale-with-mcp-tool-search). Если переменная не задана, Claude Code по умолчанию откладывает загрузку всех инструментов MCP. При этом он всё же загружает их заранее для моделей на Google Cloud's Agent Platform, предшествующих поколению Claude 4.5, для развёртывания Microsoft Foundry, размещённого в Azure, и когда `ANTHROPIC_BASE_URL` указывает на хост, не принадлежащий Anthropic. `true` всегда откладывает загрузку и отправляет бета-заголовок, за исключением тех же моделей Agent Platform и развёртываний Microsoft Foundry; запросы завершаются ошибкой на прокси, не поддерживающих `tool_reference`. `auto` загружает инструменты заранее, если их определения умещаются в 10% контекста. `auto:N` задаёт пользовательский порог, например `auto:5` для 5%. `false` загружает все инструменты заранее. Значение, заданное вами, игнорируется, если задана `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`. До v2.1.221 Claude Code отключал поиск инструментов для всех моделей на Google Cloud's Agent Platform, если вы не задавали для этой переменной значение `true` |

473| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Установите любое непустое значение, например `1`, чтобы Claude Code прекращал повторные попытки при повторяющихся ошибках перегрузки для любой модели, когда резервная модель не настроена. **Значение `0` или `false` также включает это поведение**, в отличие от большинства переменных включения/выключения; удалите переменную, чтобы восстановить поведение повторных попыток по умолчанию. Без неё Claude Code прекращает повторные попытки таким образом для моделей, которые он распознаёт как модели Opus, Fable или Mythos, когда вы проходите аутентификацию с помощью API-ключа или [стороннего провайдера](/docs/ru/third-party-integrations), а не подписки Claude. В Claude Code v2.1.160 или новее Claude Code переключается на настроенную вами [цепочку резервных моделей](/docs/ru/model-config#fallback-model-chains) при повторяющихся ошибках перегрузки для любой основной модели, поэтому эта переменная не влияет на переключение на резервную модель |476| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Установите любое непустое значение, например `1`, чтобы Claude Code прекращал повторные попытки при повторяющихся ошибках перегрузки для любой модели, когда резервная модель не настроена. **Значение `0` или `false` также включает это поведение**, в отличие от большинства переменных-переключателей; чтобы восстановить поведение повторных попыток по умолчанию, удалите переменную. Без неё Claude Code прекращает повторные попытки таким образом только для моделей, которые он распознаёт как модели Opus, Fable или Mythos, когда вы проходите аутентификацию с помощью API-ключа или [стороннего провайдера](/docs/ru/third-party-integrations), а не подписки Claude. В Claude Code v2.1.160 или новее Claude Code при повторяющихся ошибках перегрузки любой основной модели переключается на настроенную вами [цепочку резервных моделей](/docs/ru/model-config#fallback-model-chains), поэтому эта переменная не влияет на переключение на резервную модель |

474| `FORCE_AUTOUPDATE_PLUGINS` | Установите `1`, чтобы принудительно включить автообновление плагинов, даже когда основной механизм автообновления отключён через `DISABLE_AUTOUPDATER` |477| `FORCE_AUTOUPDATE_PLUGINS` | Установите `1`, чтобы принудительно включить автообновление плагинов, даже когда основной механизм автообновления отключён через `DISABLE_AUTOUPDATER` |

475| `FORCE_HYPERLINK` | Установите `1`, чтобы включить кликабельные гиперссылки OSC 8, когда ваш терминал их поддерживает, но не определяется автоматически, или `0`, чтобы отключить их. Если переменная не задана, Claude Code включает гиперссылки, только когда обнаруживает их поддержку терминалом. Claude Code разбирает это значение как число, а не как логическое значение, поэтому такое значение, как `false`, `no` или `off`, включает гиперссылки, а не отключает их. [Значок PR или merge request](/docs/ru/interactive-mode#pr-review-status) в нижней строке отображается как гиперссылка, даже когда Claude Code не может обнаружить поддержку терминалом, например при работе через SSH. Установите `0`, чтобы отображать значок как обычный текст |478| `FORCE_HYPERLINK` | Установите `1`, чтобы включить кликабельные гиперссылки OSC 8, если ваш терминал их поддерживает, но поддержка не определяется автоматически, или `0`, чтобы отключить их. Если переменная не задана, Claude Code включает гиперссылки, только когда обнаруживает их поддержку терминалом. Claude Code разбирает это значение как число, а не как логическое значение, поэтому значение вроде `false`, `no` или `off` включает гиперссылки, а не отключает их. [Значок PR или merge request](/docs/ru/interactive-mode#pr-review-status) в нижней панели отображается как гиперссылка, даже когда Claude Code не может обнаружить поддержку терминалом, например при работе через SSH. Установите `0`, чтобы отображать значок как обычный текст |

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

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

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

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

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

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

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

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

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

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

488| `MCP_DISCOVERY_CACHE_STRIKES` | При запуске, когда запись [кэша обнаружения](/docs/ru/mcp#server-status-detail) старше `MCP_DISCOVERY_CACHE_TTL_S`, Claude Code обновляет её в фоне. Эта переменная задаёт, сколько обновлений подряд могут завершиться неудачей, прежде чем Claude Code отбросит запись и вместо этого подключит сервер при следующем запуске (по умолчанию: 1). Увеличьте значение, если ваше сетевое соединение иногда обрывается, чтобы одно неудачное обновление не приводило к отбрасыванию записи. Требуется Claude Code v2.1.238 или новее |491| `MCP_DISCOVERY_CACHE_STRIKES` | Если при запуске запись [кэша обнаружения](/docs/ru/mcp#server-status-detail) оказывается старше `MCP_DISCOVERY_CACHE_TTL_S`, Claude Code обновляет её в фоне. Эта переменная задаёт, сколько обновлений подряд могут завершиться неудачей, прежде чем Claude Code отбросит запись и вместо этого подключит сервер при следующем запуске (по умолчанию: 1). Увеличьте значение, если ваше сетевое подключение иногда обрывается, чтобы одно неудачное обновление не приводило к отбрасыванию записи. Требуется Claude Code v2.1.238 или новее |

489| `MCP_DISCOVERY_CACHE_TTL_S` | Количество секунд, в течение которых Claude Code использует запись [кэша обнаружения](/docs/ru/mcp#server-status-detail) без её обновления (по умолчанию: 900). При запуске, когда запись старше этого значения, Claude Code всё ещё использует её, но обновляет в фоне. Когда запись становится старше `MCP_DISCOVERY_CACHE_MAX_STALE_S`, Claude Code вместо этого отбрасывает её. Claude Code ограничивает значение величиной `MCP_DISCOVERY_CACHE_MAX_STALE_S`, которая по умолчанию составляет 4 часа. До v2.1.238 Claude Code не ограничивал значение |492| `MCP_DISCOVERY_CACHE_TTL_S` | Количество секунд, в течение которых Claude Code использует запись [кэша обнаружения](/docs/ru/mcp#server-status-detail) без обновления (по умолчанию: 900). Если при запуске запись оказывается старше этого значения, Claude Code всё равно использует её, но обновляет в фоне. Когда запись становится старше `MCP_DISCOVERY_CACHE_MAX_STALE_S`, Claude Code вместо этого отбрасывает её. Claude Code ограничивает значение величиной `MCP_DISCOVERY_CACHE_MAX_STALE_S`, которая по умолчанию составляет 4 часа. До v2.1.238 Claude Code не ограничивал значение |

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

491| `MCP_PROTOCOL_NEGOTIATION` | Только в [среде выполнения клиента MCP v2](/docs/ru/mcp#mcp-client-runtimes): определяет, проверяет ли Claude Code поддержку серверами ревизии протокола MCP 2026-07-28. Установите `auto`, чтобы проверять HTTP-серверы, коннекторы claude.ai и stdio-серверы, или `legacy`, чтобы не проверять ни один. Если переменная не задана, Claude Code проверяет серверы, описанные в разделе [Среды выполнения клиента MCP](/docs/ru/mcp#mcp-client-runtimes). Любое другое значение игнорируется с предупреждением в логе отладки. Требуется Claude Code v2.1.221 или новее |494| `MCP_PROTOCOL_NEGOTIATION` | Только в [среде выполнения клиента MCP v2](/docs/ru/mcp#mcp-client-runtimes): определяет, проверяет ли Claude Code поддержку серверами ревизии протокола MCP 2026-07-28. Установите `auto`, чтобы проверять HTTP-серверы, коннекторы claude.ai и stdio-серверы, или `legacy`, чтобы не проверять ни один из них. Если переменная не задана, Claude Code проверяет серверы, описанные в разделе [Среды выполнения клиента MCP](/docs/ru/mcp#mcp-client-runtimes). Любое другое значение игнорируется с предупреждением в логе отладки. Требуется Claude Code v2.1.221 или новее |

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

493| `MCP_SDK_GENERATION` | Закрепляет [среду выполнения клиента MCP](/docs/ru/mcp#mcp-client-runtimes), с помощью которой этот процесс подключается к MCP-серверам: `v1`, построенную на MCP TypeScript SDK 1.x, или `v2`, построенную на [MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/). Без этой переменной Claude Code использует v2, начиная с версий, перечисленных в том разделе. В Claude Code v2.1.221 или новее среда выполнения v2 проверяет издателя, которого сервер MCP OAuth возвращает в ответе авторизации, и завершает вход ошибкой, начинающейся с `Issuer mismatch in authorization response`, если он не совпадает. Среда выполнения v1 эту проверку не выполняет. Если вы зададите нераспознанное значение, Claude Code проигнорирует его и запишет предупреждение в лог отладки. Claude Code считывает значение один раз для каждого процесса. Требуется Claude Code v2.1.218 или новее |496| `MCP_SDK_GENERATION` | Закрепляет, с помощью какой [среды выполнения клиента MCP](/docs/ru/mcp#mcp-client-runtimes) этот процесс подключается к MCP-серверам: `v1`, построенной на MCP TypeScript SDK 1.x, или `v2`, построенной на [MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/). Без этой переменной Claude Code использует v2, начиная с версий, перечисленных в том разделе. В Claude Code v2.1.221 или новее среда выполнения v2 проверяет издателя (issuer), которого сервер OAuth для MCP возвращает в ответе авторизации, и при несовпадении завершает вход ошибкой, начинающейся с `Issuer mismatch in authorization response`. Среда выполнения v1 такую проверку не выполняет. Если вы зададите нераспознанное значение, Claude Code проигнорирует его и запишет предупреждение в лог отладки. Claude Code считывает значение один раз за процесс. Требуется Claude Code v2.1.218 или новее |

494| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Максимальное количество локальных MCP-серверов (stdio), подключаемых параллельно при запуске (по умолчанию: 3) |497| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Максимальное количество локальных MCP-серверов (stdio), подключаемых параллельно при запуске (по умолчанию: 3) |

496| `MCP_TOOL_TIMEOUT` | Таймаут в миллисекундах для выполнения инструмента MCP (по умолчанию: 100000000, около 28 часов). Для HTTP-сервера, SSE-сервера или коннектора claude.ai каждый запрос также по умолчанию прерывается по таймауту через 60 секунд; задайте этой переменной или параметру `timeout` для конкретного сервера значение больше 60000, чтобы увеличить этот лимит на запрос. Меньшее значение всё равно сокращает общий таймаут выполнения инструмента, но оставляет лимит на запрос равным 60 секундам. У stdio- и WebSocket-серверов нет таймера на запрос. Поле `timeout` для конкретного сервера в `.mcp.json` переопределяет это значение для данного сервера. Значение `timeout` для конкретного сервера не меньше 1000 также задаёт минимальное окно простоя для вызовов инструментов этого сервера, поэтому `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` никогда не прерывает их раньше; для этого нижнего предела требуется Claude Code v2.1.203 или новее. Для переменной окружения значения меньше 1000 повышаются до одной секунды; для поля конкретного сервера значения меньше 1000 игнорируются |499| `MCP_TOOL_TIMEOUT` | Таймаут в миллисекундах для выполнения инструмента MCP (по умолчанию: 100000000, около 28 часов). Для HTTP-, SSE-сервера или сервера коннектора claude.ai каждый запрос также по умолчанию завершается по таймауту через 60 секунд; задайте для этой переменной или для поля `timeout` отдельного сервера значение больше 60000, чтобы увеличить этот лимит на запрос. Меньшее значение всё равно сокращает общий таймаут выполнения инструмента, но оставляет лимит на запрос равным 60 секундам. У stdio- и WebSocket-серверов нет таймера на запрос. Поле `timeout` отдельного сервера в `.mcp.json` переопределяет это значение для данного сервера. Значение `timeout` отдельного сервера не менее 1000 также задаёт минимальное окно простоя для вызовов инструментов этого сервера, поэтому `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` никогда не прерывает их раньше; этот нижний предел требует Claude Code v2.1.203 или новее. Для переменной окружения значения ниже 1000 повышаются до одной секунды; для поля отдельного сервера значения ниже 1000 игнорируются |

498| `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` | Стандартное ограничение OpenTelemetry SDK на длину значения атрибута. Claude Code ограничивает атрибуты телеметрии с содержимым меньшим из этого значения и `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, чтобы маркер усечения оставался в пределах ограничения SDK. Claude Code так же считывает варианты `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT` и `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT`, и наименьшее заданное значение применяется ко всем сигналам. Требуется Claude Code v2.1.214 или новее. См. [Мониторинг](/docs/ru/monitoring-usage#common-configuration-variables) |501| `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` | Стандартное ограничение OpenTelemetry SDK на длину значения атрибута. Claude Code ограничивает атрибуты телеметрии с содержимым меньшим из этого значения и `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, чтобы маркер усечения оставался в пределах ограничения SDK. Claude Code так же считывает варианты `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT` и `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT`, и наименьшее заданное значение применяется ко всем сигналам. Требуется Claude Code v2.1.214 или новее. См. [Мониторинг](/docs/ru/monitoring-usage#common-configuration-variables) |

499| `OTEL_LOG_ASSISTANT_RESPONSES` | Установите `1`, чтобы включать текст ответа модели в события лога OpenTelemetry `assistant_response`. Если переменная не задана, Claude Code вместо этого использует значение `OTEL_LOG_USER_PROMPTS`. Установите `0`, чтобы ответы оставались скрытыми, даже когда задана `OTEL_LOG_USER_PROMPTS`. Задайте её в оболочке, пользовательских настройках или управляемых настройках. Игнорируется в [настройках проекта и локальных настройках](/docs/ru/settings-reference#variables-claude-code-ignores-in-env). Требуется Claude Code v2.1.193 или новее. См. [Мониторинг](/docs/ru/monitoring-usage#assistant-response-event) |502| `OTEL_LOG_ASSISTANT_RESPONSES` | Установите `1`, чтобы включать текст ответа модели в события лога OpenTelemetry `assistant_response`. Если переменная не задана, Claude Code использует вместо неё значение `OTEL_LOG_USER_PROMPTS`. Установите `0`, чтобы ответы оставались замаскированными, даже когда задана `OTEL_LOG_USER_PROMPTS`. Задайте её в оболочке, пользовательских настройках или управляемых настройках. Игнорируется в [настройках проекта и локальных настройках](/docs/ru/settings-reference#variables-claude-code-ignores-in-env). Требуется Claude Code v2.1.193 или новее. См. [Мониторинг](/docs/ru/monitoring-usage#assistant-response-event) |

500| `OTEL_LOG_MANAGED_SETTINGS` | Установите `1`, чтобы добавлять управляемые настройки со скрытыми данными и дайджест SHA-256 настроек до скрытия в события лога OpenTelemetry `managed_settings_resolved`. По умолчанию отключено. Задайте её в оболочке, пользовательских настройках или управляемых настройках; значение в настройках проекта или локальных настройках её не включает. Требуется Claude Code v2.1.274 или новее. См. [Мониторинг](/docs/ru/monitoring-usage#managed-settings-resolved-event) |503| `OTEL_LOG_MANAGED_SETTINGS` | Установите `1`, чтобы добавлять управляемые настройки с замаскированными конфиденциальными данными и дайджест SHA-256 настроек до маскирования в события лога OpenTelemetry `managed_settings_resolved`. По умолчанию отключено. Задайте её в оболочке, пользовательских настройках или управляемых настройках; значение в настройках проекта или локальных настройках её не включает. Требуется Claude Code v2.1.274 или новее. См. [Мониторинг](/docs/ru/monitoring-usage#managed-settings-resolved-event) |

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

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

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

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

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

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

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

508| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | Начиная с v2.1.161, Claude Code добавляет ключи `OTEL_RESOURCE_ATTRIBUTES` в метки точек данных метрик. Установите `false`, чтобы исключить их (по умолчанию: включены). См. [Мониторинг](/docs/ru/monitoring-usage#multi-team-organization-support) |511| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | Начиная с v2.1.161, Claude Code добавляет ключи `OTEL_RESOURCE_ATTRIBUTES` к меткам точек данных метрик. Установите `false`, чтобы исключить их (по умолчанию: включены). См. [Мониторинг](/docs/ru/monitoring-usage#multi-team-organization-support) |

509| `OTEL_METRICS_INCLUDE_SESSION_ID` | Установите `false`, чтобы исключить ID сессии из атрибутов метрик (по умолчанию: включён). См. [Мониторинг](/docs/ru/monitoring-usage) |512| `OTEL_METRICS_INCLUDE_SESSION_ID` | Установите `false`, чтобы исключить идентификатор сессии из атрибутов метрик (по умолчанию: включён). См. [Мониторинг](/docs/ru/monitoring-usage) |

510| `OTEL_METRICS_INCLUDE_VERSION` | Установите `true`, чтобы включить версию Claude Code в атрибуты метрик (по умолчанию: исключена). См. [Мониторинг](/docs/ru/monitoring-usage) |513| `OTEL_METRICS_INCLUDE_VERSION` | Установите `true`, чтобы включить версию Claude Code в атрибуты метрик (по умолчанию: исключена). См. [Мониторинг](/docs/ru/monitoring-usage) |

511| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Переопределяет бюджет символов для метаданных скиллов, показываемых [инструменту Skill](/docs/ru/skills#control-who-invokes-a-skill). Бюджет динамически масштабируется как 1% контекстного окна, с резервным значением 8000 символов. Устаревшее имя сохранено для обратной совместимости |514| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Переопределяет бюджет символов для метаданных скиллов, показываемых [инструменту Skill](/docs/ru/skills#control-who-invokes-a-skill). Бюджет динамически масштабируется и составляет 1% контекстного окна, с резервным значением 8 000 символов. Устаревшее имя сохранено для обратной совместимости |

512| `TASK_MAX_OUTPUT_LENGTH` | Удалена в v2.1.277 и теперь ни на что не влияет, вместе с инструментом `TaskOutput`, размер вывода которого она задавала. Ранее задавала максимальное количество символов вывода [фоновой задачи](/docs/ru/tools-reference#background-commands), которое сохранял инструмент `TaskOutput`. Теперь Claude вместо этого читает файл вывода фоновой задачи с помощью `Read` |515| `TASK_MAX_OUTPUT_LENGTH` | Удалена в v2.1.277 и теперь ни на что не влияет, вместе с инструментом `TaskOutput`, размер вывода которого она задавала. Ранее задавала максимальное количество символов вывода [фоновой задачи](/docs/ru/tools-reference#background-commands), которое сохранял инструмент `TaskOutput`. Вместо этого Claude читает файл вывода фоновой задачи с помощью `Read` |

513| `USE_BUILTIN_RIPGREP` | Установите `0`, чтобы использовать установленный в системе `rg` вместо `rg`, входящего в состав Claude Code |516| `USE_BUILTIN_RIPGREP` | Установите `0`, чтобы использовать установленный в системе `rg` вместо `rg`, входящего в состав Claude Code |

514| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Переопределяет регион для Claude 3.5 Haiku при использовании Google Cloud's Agent Platform |517| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Переопределяет регион для Claude 3.5 Haiku при использовании Google Cloud's Agent Platform |

515| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Переопределяет регион для Claude 3.5 Sonnet при использовании Google Cloud's Agent Platform |518| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Переопределяет регион для Claude 3.5 Sonnet при использовании Google Cloud's Agent Platform |

532| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Переопределяет регион для Claude Haiku 4.5 при использовании Google Cloud's Agent Platform |535| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Переопределяет регион для Claude Haiku 4.5 при использовании Google Cloud's Agent Platform |

533| `VERTEX_REGION_CLAUDE_HAIKU_5_5` | Переопределяет регион для Claude Haiku 5.5 при использовании Google Cloud's Agent Platform. Добавлено в v2.1.293 |536| `VERTEX_REGION_CLAUDE_HAIKU_5_5` | Переопределяет регион для Claude Haiku 5.5 при использовании Google Cloud's Agent Platform. Добавлено в v2.1.293 |

534 537

535Также поддерживаются стандартные переменные экспортёра OpenTelemetry (`OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER`, `OTEL_EXPORTER_OTLP_ENDPOINT`, `OTEL_EXPORTER_OTLP_PROTOCOL`, `OTEL_EXPORTER_OTLP_HEADERS`, `OTEL_METRIC_EXPORT_INTERVAL`, `OTEL_RESOURCE_ATTRIBUTES` и варианты для отдельных сигналов). Подробности конфигурации см. в разделе [Мониторинг](/docs/ru/monitoring-usage).538Также поддерживаются стандартные переменные экспортера OpenTelemetry (`OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER`, `OTEL_EXPORTER_OTLP_ENDPOINT`, `OTEL_EXPORTER_OTLP_PROTOCOL`, `OTEL_EXPORTER_OTLP_HEADERS`, `OTEL_METRIC_EXPORT_INTERVAL`, `OTEL_RESOURCE_ATTRIBUTES` и их варианты для отдельных сигналов). Подробности конфигурации см. в разделе [Мониторинг](/docs/ru/monitoring-usage).

536 539

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

538 541

539<h2 id="what-the-subprocess-environment-scrub-removes">542<h2 id="what-the-subprocess-environment-scrub-removes">

540 Что удаляет очистка окружения подпроцессов543 Что удаляет очистка окружения подпроцессов

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

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

589* Поручать Claude читать [публичный артефакт другой организации](/docs/ru/artifacts#read-an-artifact-shared-with-you)592* Поручать Claude читать [публичный артефакт другой организации](/docs/ru/artifacts#read-an-artifact-shared-with-you)

590* Поручать Claude Code проверять серверы коннекторов claude.ai или stdio-серверы на поддержку [ревизии протокола MCP 2026-07-28](/docs/ru/mcp#mcp-client-runtimes), если только вы не задали `MCP_PROTOCOL_NEGOTIATION=auto`593* Поручать Claude Code проверять серверы коннекторов claude.ai на поддержку [ревизии протокола MCP 2026-07-28](/docs/ru/mcp#mcp-client-runtimes), если только вы не задали `MCP_PROTOCOL_NEGOTIATION=auto`

591* Получать [инструмент PowerShell](/docs/ru/tools-reference#powershell-tool) по умолчанию для учётных записей claude.ai и Console в Windows с установленным Git Bash; Claude Code направляет shell-команды через Git Bash, если вы не задали `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. В Windows без Git Bash инструмент остаётся включённым594* Получать [инструмент PowerShell](/docs/ru/tools-reference#powershell-tool) по умолчанию для учётных записей claude.ai и Console в Windows с установленным Git Bash; Claude Code направляет shell-команды через Git Bash, если вы не задали `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. В Windows без Git Bash инструмент остаётся включённым

592* Получать [отзывы, составленные Claude](/docs/ru/tools-reference#sendfeedback-tool-behavior), которые Claude Code включает через загружаемый флаг595* Получать [отзывы, составленные Claude](/docs/ru/tools-reference#sendfeedback-tool-behavior), которые Claude Code включает через загружаемый флаг

593* Добиться того, чтобы Claude [воспринимал большие вставки как вставленный, а не набранный текст](/docs/ru/terminal-config#how-claude-treats-pasted-text); содержимое за заполнителем `[Pasted text #N]` поступает к Claude без пометки596* Добиться того, чтобы Claude [воспринимал большие вставки как вставленный, а не набранный текст](/docs/ru/terminal-config#how-claude-treats-pasted-text); содержимое за заполнителем `[Pasted text #N]` поступает к Claude без пометки

errors.md +60 −63

Details

436| :- | :- | :- |436| :- | :- | :- |

437| [`CLAUDE_CODE_MAX_RETRIES`](/docs/ru/env-vars) | 10 | Количество повторных попыток. Ограничено 15 начиная с v2.1.186; начиная с v2.1.199 `CLAUDE_CODE_RETRY_WATCHDOG` повышает значение по умолчанию и удаляет ограничение. Снизьте его, чтобы быстрее выявлять сбои в скриптах. |437| [`CLAUDE_CODE_MAX_RETRIES`](/docs/ru/env-vars) | 10 | Количество повторных попыток. Ограничено 15 начиная с v2.1.186; начиная с v2.1.199 `CLAUDE_CODE_RETRY_WATCHDOG` повышает значение по умолчанию и удаляет ограничение. Снизьте его, чтобы быстрее выявлять сбои в скриптах. |

438| [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/ru/env-vars) | не установлено | Установите значение `1` в автоматических сессиях, таких как задания CI, чтобы повторять ошибки пропускной способности `429` и `529` бесконечно вместо отказа после `CLAUDE_CODE_MAX_RETRIES` попыток. Claude Code сразу завершается с ошибкой, когда запрос со стандартной скоростью получает `429`, который сообщает о лимите расходов или исчерпанных кредитах использования, даже если это `429` от [gateway spend cap](#spend-limit-reached), который сбрасывается по расписанию. До v2.1.239 сторож повторял такие запросы бесконечно. Для запросов в быстром режиме см. [Handle rate limits](/docs/ru/fast-mode#handle-rate-limits). На v2.1.199 или позже он также повышает количество повторных попыток по умолчанию для других временных ошибок, таких как ошибки сервера, таймауты и разорванные соединения, до 300, примерно три часа задержки, и удаляет ограничение 15 на `CLAUDE_CODE_MAX_RETRIES`, если вы явно установите эту переменную. |438| [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/ru/env-vars) | не установлено | Установите значение `1` в автоматических сессиях, таких как задания CI, чтобы повторять ошибки пропускной способности `429` и `529` бесконечно вместо отказа после `CLAUDE_CODE_MAX_RETRIES` попыток. Claude Code сразу завершается с ошибкой, когда запрос со стандартной скоростью получает `429`, который сообщает о лимите расходов или исчерпанных кредитах использования, даже если это `429` от [gateway spend cap](#spend-limit-reached), который сбрасывается по расписанию. До v2.1.239 сторож повторял такие запросы бесконечно. Для запросов в быстром режиме см. [Handle rate limits](/docs/ru/fast-mode#handle-rate-limits). На v2.1.199 или позже он также повышает количество повторных попыток по умолчанию для других временных ошибок, таких как ошибки сервера, таймауты и разорванные соединения, до 300, примерно три часа задержки, и удаляет ограничение 15 на `CLAUDE_CODE_MAX_RETRIES`, если вы явно установите эту переменную. |

439| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](/docs/ru/env-vars) | 500 | Начальная задержка в миллисекундах для экспоненциальной задержки между повторными попытками запроса, который API отклоняет с ошибкой перегрузки `529`. Увеличьте её, вплоть до 32000, чтобы распределить повторные попытки на более длительный период, когда API работает на пределе пропускной способности. Не действует, если `CLAUDE_CODE_RETRY_WATCHDOG` установлена в `1` или если отклонённый запрос был отправлен в [быстром режиме](/docs/ru/fast-mode#handle-rate-limits). Требуется Claude Code v2.1.292 или позже. |

439| [`API_TIMEOUT_MS`](/docs/ru/env-vars) | 600000 | Таймаут для каждого запроса в миллисекундах. Повысьте его для медленных сетей или прокси. Он также ограничивает, как долго Claude Code ждёт заголовков ответа, как описано в [No response from API](#no-response-from-api). |440| [`API_TIMEOUT_MS`](/docs/ru/env-vars) | 600000 | Таймаут для каждого запроса в миллисекундах. Повысьте его для медленных сетей или прокси. Он также ограничивает, как долго Claude Code ждёт заголовков ответа, как описано в [No response from API](#no-response-from-api). |

440| [`CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES`](/docs/ru/env-vars) | не установлено | Лимит повторных отправок [непотокового запроса](#streaming-response-ended-before-any-complete-data-was-received), который завершается по таймауту. При достижении лимита запрос завершается с ошибкой. Ответ Claude, генерация которого занимает больше времени, чем таймаут, снова завершается по таймауту при каждой повторной отправке, поэтому установите небольшое число, например `0`, чтобы получить ошибку быстрее. Каждая непотоковая попытка завершается по таймауту через 300 секунд в локальной сессии или через `API_TIMEOUT_MS`, если вы задали положительное значение. Требуется Claude Code v2.1.285 или позже. |441| [`CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES`](/docs/ru/env-vars) | не установлено | Лимит повторных отправок [непотокового запроса](#streaming-response-ended-before-any-complete-data-was-received), который завершается по таймауту. При достижении лимита запрос завершается с ошибкой. Ответ Claude, генерация которого занимает больше времени, чем таймаут, снова завершается по таймауту при каждой повторной отправке, поэтому установите небольшое число, например `0`, чтобы получить ошибку быстрее. Каждая непотоковая попытка завершается по таймауту через 300 секунд в локальной сессии или через `API_TIMEOUT_MS`, если вы задали положительное значение. Требуется Claude Code v2.1.285 или позже. |

441| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/ru/env-vars) | не установлено | Дедлайн в миллисекундах для первого байта ответа потокового запроса. Требуется Claude Code v2.1.242 или позже. О том, как Claude Code выбирает дедлайн, когда эта переменная не установлена, см. [No response from API](#no-response-from-api). |442| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/ru/env-vars) | не установлено | Дедлайн в миллисекундах для первого байта ответа потокового запроса. Требуется Claude Code v2.1.242 или позже. О том, как Claude Code выбирает дедлайн, когда эта переменная не установлена, см. [No response from API](#no-response-from-api). |

703Когда ограничение частоты запросов, перегрузка или ошибка сервера прерывает субагента переднего плана, который уже сформировал текстовый вывод, Claude вместо этой ошибки получает этот частичный вывод с пометкой о неполноте. Субагент, весь вывод которого состоял из вызовов инструментов, тоже получает эту ошибку; в v2.1.199 в таком случае вместо этого возвращался пустой частичный результат. См. [Ошибки API в субагентах](/docs/ru/sub-agents#api-errors-in-subagents).704Когда ограничение частоты запросов, перегрузка или ошибка сервера прерывает субагента переднего плана, который уже сформировал текстовый вывод, Claude вместо этой ошибки получает этот частичный вывод с пометкой о неполноте. Субагент, весь вывод которого состоял из вызовов инструментов, тоже получает эту ошибку; в v2.1.199 в таком случае вместо этого возвращался пустой частичный результат. См. [Ошибки API в субагентах](/docs/ru/sub-agents#api-errors-in-subagents).

704 705

705<h2 id="usage-limits">706<h2 id="usage-limits">

706 Ограничения использования707 Лимиты использования

707</h2>708</h2>

708 709

709Большинство ошибок в этом разделе означают, что достигнута квота, привязанная к вашей учётной записи или плану. Три работают по-другому: [`Server is temporarily limiting requests`](#server-is-temporarily-limiting-requests) — это серверное ограничение скорости, не связанное с квотой вашего плана, [`Usage credits required for 1M context`](#usage-credits-required-for-1m-context) — это проверка прав доступа, а не исчерпанная квота, и [`The prompt to confirm went unanswered`](#the-prompt-to-confirm-went-unanswered) означает, что подтверждающий запрос на использование кредитов закрыт без ответа, независимо от того, была ли достигнута квота.710Большинство ошибок в этом разделе означают, что достигнута квота, привязанная к вашей учётной записи или плану. Три работают по-другому: [`Server is temporarily limiting requests`](#server-is-temporarily-limiting-requests) — это серверное ограничение частоты запросов, не связанное с квотой вашего плана, [`Usage credits required for 1M context`](#usage-credits-required-for-1m-context) — это проверка прав доступа, а не исчерпанная квота, и [`The prompt to confirm went unanswered`](#the-prompt-to-confirm-went-unanswered) означает, что запрос согласия на использование кредитов закрыт без ответа, независимо от того, была ли достигнута квота.

710 711

711<h3 id="youve-hit-your-session-limit">712<h3 id="youve-hit-your-session-limit">

712 You've hit your session limit713 You've hit your session limit

721You've hit your Sonnet limit · resets 3:45pm722You've hit your Sonnet limit · resets 3:45pm

722```723```

723 724

724Claude Code блокирует дальнейшие запросы до времени сброса, указанного в сообщении. Лимиты сеанса и недели являются общими для всех моделей, поэтому переключение моделей не восстанавливает доступ. Лимиты Opus и Sonnet применяются только к запросам к этому семейству моделей, поэтому переключение на модель вне семейства с помощью `/model` позволяет вам продолжить работу.725Claude Code блокирует дальнейшие запросы до времени сброса, указанного в сообщении. Лимиты сессии и недели являются общими для всех моделей, поэтому переключение моделей не восстанавливает доступ. Лимиты Opus и Sonnet применяются только к запросам к соответствующему семейству моделей, поэтому переключение на модель вне семейства с помощью `/model` позволяет вам продолжить работу.

725 726

726В интерактивной сессии, в которую выполнен вход с подпиской claude.ai, Claude Code также может ждать в открытой сессии и продолжить прерванную задачу вскоре после сброса. См. [Wait for a usage limit to reset](/docs/ru/interactive-mode#wait-for-a-usage-limit-to-reset), чтобы узнать, что вы увидите, как начать или отменить ожидание и как отключить автоматическое продолжение. До версии v2.1.234 Claude Code не предлагал это ожидание.727В интерактивной сессии, в которую выполнен вход с подпиской claude.ai, Claude Code также может ждать в открытой сессии и продолжить прерванную задачу вскоре после сброса. См. [Wait for a usage limit to reset](/docs/ru/interactive-mode#wait-for-a-usage-limit-to-reset), чтобы узнать, что вы увидите, как начать или отменить ожидание и как отключить автоматическое продолжение. До версии v2.1.234 Claude Code не предлагал это ожидание.

727 728

728Использование учитывается одновременно в лимитах сеанса и недели. Один всплеск интенсивной деятельности, такой как большой fanout рабочего процесса, может исчерпать недельный лимит до сброса окна сеанса.729Использование учитывается одновременно в лимитах сессии и недели. Один всплеск интенсивной активности, такой как большой fanout рабочего процесса, может исчерпать недельный лимит до сброса окна сессии.

729 730

730**Что делать:**731**Что делать:**

731 732

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

733* На вкладке Code в [Desktop app](/docs/ru/desktop) карточка session-limit предлагает флажок **Auto-continue when limits reset**. Карточка weekly-limit этого не предлагает. Когда он отмечен, Desktop app повторяет прерванный ход после сброса и показывает время повтора на карточке. Флажок Desktop и параметр **Continue automatically at usage limit** в CLI в `/config` являются отдельными, поэтому отключайте каждый отдельно.734* На вкладке Code в [Desktop app](/docs/ru/desktop) карточка session-limit предлагает флажок **Auto-continue when limits reset**. Карточка weekly-limit этого не предлагает. Когда он отмечен, Desktop app повторяет прерванный ход после сброса и показывает время повторной попытки на карточке. Флажок Desktop и настройка **Continue automatically at usage limit** в CLI в `/config` являются отдельными, поэтому отключайте каждую отдельно.

734* Для лимита Opus или Sonnet запустите `/model` и переключитесь на модель вне этого семейства, чтобы продолжить работу. Каждая модель имеет свой собственный кэш подсказок, поэтому следующий запрос повторно читает весь разговор без попаданий в кэш; см. [Switching models](/docs/ru/prompt-caching#switching-models)735* Для лимита Opus или Sonnet запустите `/model` и переключитесь на модель вне этого семейства, чтобы продолжить работу. Каждая модель имеет свой собственный кэш промптов, поэтому следующий запрос повторно читает весь диалог без попаданий в кэш; см. [Switching models](/docs/ru/prompt-caching#switching-models)

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

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

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

738 739

739Перед тем как окно закончится, Claude Code может предупредить вас, что вы использовали большую часть его, с сообщением, таким как `You've used 85% of your session limit · resets 3:45pm`. Чтобы непрерывно отслеживать оставшийся лимит, добавьте поля `rate_limits` в [custom status line](/docs/ru/statusline#rate-limit-usage), или в Desktop app нажмите [usage ring](/docs/ru/desktop#check-usage) рядом с выбором модели.740Перед тем как окно закончится, Claude Code может предупредить вас, что вы использовали большую его часть, сообщением, таким как `You've used 85% of your session limit · resets 3:45pm`. Чтобы непрерывно отслеживать оставшийся лимит, добавьте поля `rate_limits` в [custom status line](/docs/ru/statusline#rate-limit-usage), или в Desktop app нажмите [usage ring](/docs/ru/desktop#check-usage) рядом с выбором модели.

740 741

741<h3 id="usage-credits-required-for-1m-context">742<h3 id="usage-credits-required-for-1m-context">

742 Usage credits required for 1M context743 Usage credits required for 1M context

743</h3>744</h3>

744 745

745Выбранная модель использует расширенное окно контекста с расширением 1M-токена, и ваш план включает его только через кредиты использования.746Выбранная модель использует расширенное контекстное окно на 1M токенов, и ваш план включает его только через кредиты использования.

746 747

747```text theme={null}748```text theme={null}

748API Error: Usage credits required for 1M context · run /usage-credits to turn them on (they take effect after you restart Claude Code), or /model to switch to standard context749API Error: Usage credits required for 1M context · run /usage-credits to turn them on (they take effect after you restart Claude Code), or /model to switch to standard context

749```750```

750 751

751В сеансе, который запускает Claude Desktop app, подсказка не называет команды: она указывает на страницу параметров использования claude.ai, или на планах Team и Enterprise говорит включить кредиты использования на claude.ai/admin-settings/usage или попросить вашего администратора.752В сессии, которую запускает Claude Desktop app, подсказка не называет команды: она указывает на страницу настроек использования claude.ai, или на планах Team и Enterprise говорит включить кредиты использования на claude.ai/admin-settings/usage или попросить вашего администратора.

752 753

753Это проверка прав доступа, а не исчерпание квоты. Она срабатывает даже когда ваши лимиты сеанса и недели имеют оставшуюся ёмкость. См. [Extended context](/docs/ru/model-config#extended-context) для информации о том, какие планы включают контекст 1M напрямую и какие требуют кредитов использования.754Это проверка прав доступа, а не исчерпание квоты. Она срабатывает, даже когда в ваших лимитах сессии и недели остаётся запас. См. [Extended context](/docs/ru/model-config#extended-context), чтобы узнать, какие планы включают контекст 1M напрямую, а какие требуют кредитов использования.

754 755

755Когда эта ошибка появляется в середине разговора, потому что контекст вырос более чем на 200K токенов, Claude Code автоматически сжимает разговор обратно под стандартный лимит контекста и сохраняет сеанс на этом лимите впоследствии, поэтому никаких действий не требуется. В версиях до v2.1.172 ошибка повторялась при каждом последующем запросе, включая `/compact`; запустите `/clear` на этих версиях для восстановления. Приведённые ниже шаги применяются, когда вы явно выбрали модель `[1m]`.756Когда эта ошибка появляется в середине диалога, потому что контекст превысил 200K токенов, Claude Code автоматически сжимает диалог обратно под стандартный лимит контекста и в дальнейшем сохраняет сессию на этом лимите, поэтому никаких действий не требуется. В версиях до v2.1.172 ошибка повторялась при каждом последующем запросе, включая `/compact`; для восстановления на этих версиях запустите `/clear`. Приведённые ниже шаги применяются, когда вы явно выбрали модель `[1m]`.

756 757

757**Что делать:**758**Что делать:**

758 759

759* Запустите `/model` и выберите вариант без суффикса `[1m]`, чтобы вернуться к стандартному окну контекста760* Запустите `/model` и выберите вариант без суффикса `[1m]`, чтобы вернуться к стандартному контекстному окну

760* Где сообщение называет `/usage-credits`, запустите его, чтобы включить поэтапное выставление счётов для варианта 1M на Pro и Max, или запросить кредиты использования у администратора на Team и Enterprise. После включения кредитов использования перезагрузите Claude Code или начните новый сеанс, в зависимости от того, что говорит сообщение. До этого сеанс остаётся на стандартном лимите контекста.761* Если сообщение называет `/usage-credits`, запустите эту команду, чтобы включить биллинг по факту использования для варианта 1M на Pro и Max, или запросить кредиты использования у администратора на Team и Enterprise. После включения кредитов использования перезапустите Claude Code или начните новую сессию, в зависимости от того, что говорит сообщение. До этого сессия остаётся на стандартном лимите контекста.

761* Если ошибка сохраняется после `/model`, ID модели 1M может быть установлен в другом месте. См. [Setting your model](/docs/ru/model-config#setting-your-model) для проверки мест конфигурации в порядке приоритета.762* Если ошибка сохраняется после `/model`, ID модели 1M может быть задан в другом месте. См. [Setting your model](/docs/ru/model-config#setting-your-model), где перечислены места конфигурации для проверки в порядке приоритета.

762* Чтобы полностью удалить варианты 1M из выбора модели, установите [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/ru/env-vars)763* Чтобы полностью удалить варианты 1M из выбора модели, установите [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/ru/env-vars)

763 764

764До версии v2.1.268 сообщение заканчивалось на `run /usage-credits to turn them on, or /model to switch to standard context` и не упоминало перезагрузку.765До версии v2.1.268 сообщение заканчивалось на `run /usage-credits to turn them on, or /model to switch to standard context` и не упоминало перезапуск.

765 766

766<h3 id="the-prompt-to-confirm-went-unanswered">767<h3 id="the-prompt-to-confirm-went-unanswered">

767 The prompt to confirm went unanswered768 The prompt to confirm went unanswered

768</h3>769</h3>

769 770

770Если ваша учётная запись требует [Fable usage-credits consent](/docs/ru/model-config#fable-and-usage-credits), Claude Code просит вас подтвердить перед запросом Fable, который будет выставлять счёт за кредиты использования. Когда запрос согласия закрывается без ответа, Claude Code завершает ход одним из этих сообщений:771Если ваша учётная запись требует [Fable usage-credits consent](/docs/ru/model-config#fable-and-usage-credits), Claude Code просит вас подтвердить, прежде чем запрос Fable будет оплачен кредитами использования. Когда запрос согласия закрывается без ответа, Claude Code завершает ход одним из этих сообщений:

771 772

772```text theme={null}773```text theme={null}

773Fable limit reached · continuing on Fable 5.1 uses usage credits, and the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change774Fable limit reached · continuing on Fable 5.1 uses usage credits, and the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change

774Fable 5.1 now uses usage credits · the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change775Fable 5.1 now uses usage credits · the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change

775```776```

776 777

777Сообщения называют модель Fable сеанса, поэтому на Fable 5 они читают `continuing on Fable 5` и `Fable 5 now uses usage credits`. До версии v2.1.257 первое сообщение начиналось с `Fable 5 limit reached`.778Сообщения называют модель Fable сессии, поэтому на Fable 5 они гласят `continuing on Fable 5` и `Fable 5 now uses usage credits`. До версии v2.1.257 первое сообщение начиналось с `Fable 5 limit reached`.

778 779

779Это происходит в сеансах [Remote Control](/docs/ru/remote-control), [background sessions](/docs/ru/agent-view), [agent team](/docs/ru/agent-teams) товарищей и сеансах, которые другое приложение размещает через Agent SDK. Для информации о том, когда Claude Code закрывает запрос, см. [Fable and usage credits](/docs/ru/model-config#fable-and-usage-credits).780Это происходит в сессиях [Remote Control](/docs/ru/remote-control), [фоновых сессиях](/docs/ru/agent-view), сессиях участников [команды агентов](/docs/ru/agent-teams) и сессиях, которые другое приложение размещает через Agent SDK. О том, когда Claude Code закрывает запрос, см. [Fable and usage credits](/docs/ru/model-config#fable-and-usage-credits).

780 781

781**Что делать:**782**Что делать:**

782 783

783* Где работает сеанс, на терминале или в приложении, которое его размещает, отправьте другой запрос и ответьте на запрос согласия, когда он появится снова. Для фонового сеанса сначала подключитесь к нему из [agents view](/docs/ru/agent-view). Повторная отправка из клиента Remote Control показывает это сообщение снова, потому что клиент не может отобразить запрос.784* Там, где работает сессия, в терминале или в приложении, которое её размещает, отправьте ещё один промпт и ответьте на запрос согласия, когда он появится снова. Для фоновой сессии сначала подключитесь к ней из [agents view](/docs/ru/agent-view). Повторная отправка из клиента Remote Control снова показывает это сообщение, потому что клиент не может отобразить запрос.

784* Запустите `/model`, чтобы переключиться на модель, которая не выставляет счёт за кредиты использования785* Запустите `/model`, чтобы переключиться на модель, которая не оплачивается кредитами использования

785* Чтобы дать себе больше времени, установите [`dialogExpiry`](/docs/ru/settings-reference#dialogexpiry) на более длительное значение или `"never"`786* Чтобы дать себе больше времени, установите для [`dialogExpiry`](/docs/ru/settings-reference#dialogexpiry) более длительное значение или `"never"`

786 787

787До версии v2.1.236 это сообщение не появлялось: пока был подключен клиент Remote Control, Claude Code ждал 60 секунд ответа, а затем продолжал ход на вашей модели по умолчанию.788До версии v2.1.236 это сообщение не появлялось: пока был подключён клиент Remote Control, Claude Code ждал ответа 60 секунд, а затем продолжал ход на вашей модели по умолчанию.

788 789

789<h3 id="server-is-temporarily-limiting-requests">790<h3 id="server-is-temporarily-limiting-requests">

790 Server is temporarily limiting requests791 Server is temporarily limiting requests

791</h3>792</h3>

792 793

793API применил кратковременное ограничение скорости, которое не связано с квотой вашего плана.794API применил кратковременное ограничение частоты запросов, которое не связано с квотой вашего плана.

794 795

795```text theme={null}796```text theme={null}

796API Error: Server is temporarily limiting requests (not your usage limit)797API Error: Server is temporarily limiting requests (not your usage limit)

797```798```

798 799

799Claude Code различает их от лимита вашего плана по отсутствию унифицированных заголовков квоты, которые несёт реальный ответ лимита. Начиная с версии v2.1.199 это [retried automatically](#automatic-retries) с backoff перед отображением, независимо от того, как вы аутентифицируетесь. В более ранних версиях сеанс, вошедший с подпиской claude.ai, не прошёл ход при первом возникновении; только API key и Enterprise sign-ins повторили попытку.800Claude Code отличает это от лимита вашего плана по отсутствию унифицированных заголовков квоты, которые содержит ответ при реальном лимите. Начиная с версии v2.1.199 для этой ошибки [автоматически выполняются повторные попытки](#automatic-retries) с backoff перед отображением, независимо от способа аутентификации. В более ранних версиях сессия, в которую выполнен вход с подпиской claude.ai, завершала ход с ошибкой при первом же возникновении; повторные попытки выполнялись только при входе с API-ключом и через Enterprise.

800 801

801**Что делать:**802**Что делать:**

802 803

803* Подождите немного и попробуйте снова804* Подождите немного и попробуйте снова

804* Проверьте [status.claude.com](https://status.claude.com), если это сохраняется805* Проверьте [status.claude.com](https://status.claude.com), если проблема сохраняется

805 806

806<h3 id="request-rejected-429">807<h3 id="request-rejected-429">

807 Request rejected (429)808 Request rejected (429)

808</h3>809</h3>

809 810

810Вы достигли лимита скорости, настроенного для вашего API key, проекта Amazon Bedrock или проекта Google Cloud.811Вы достигли ограничения частоты запросов, настроенного для вашего API-ключа, проекта Amazon Bedrock или проекта Google Cloud.

811 812

812```text theme={null}813```text theme={null}

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

814```815```

815 816

816Завершающее предложение называет, где проверить здоровье сервиса, и варьируется в зависимости от поставщика. Конфигурации Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry называют страницу статуса этого поставщика вместо страницы статуса Anthropic. Пользовательский `ANTHROPIC_BASE_URL` называет хост шлюза.817Завершающее предложение указывает, где проверить состояние сервиса, и зависит от поставщика. Конфигурации Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry указывают страницу статуса соответствующего поставщика вместо страницы статуса Anthropic. Пользовательский `ANTHROPIC_BASE_URL` указывает хост шлюза.

817 818

818Когда прокси, балансировщик нагрузки или шлюз между Claude Code и API отвечает своей собственной HTML-страницей 429, текст после `·` — это название этой страницы, если оно есть, например `Too Many Requests`. До версии v2.1.281 вся разметка страницы была напечатана после `·`.819Когда прокси, балансировщик нагрузки или шлюз между Claude Code и API отвечает своей собственной HTML-страницей 429, текст после `·` — это заголовок этой страницы, если он есть, например `Too Many Requests`. До версии v2.1.281 после `·` выводилась вся разметка страницы.

819 820

820**Что делать:**821**Что делать:**

821 822

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

823* Проверьте консоль вашего поставщика для активных лимитов и запросите более высокий уровень, если необходимо824* Проверьте в консоли вашего поставщика действующие лимиты и при необходимости запросите более высокий уровень

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

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

826 827

827<h3 id="youve-hit-your-monthly-spend-limit">828<h3 id="youve-hit-your-monthly-spend-limit">

828 You've hit your monthly spend limit829 You've hit your monthly spend limit

829</h3>830</h3>

830 831

831Включённое использование вашего плана не может покрыть этот запрос, и [usage credits](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans), которые в противном случае оплатили бы его, достигли лимита расходов. Это происходит, когда одно из окон использования вашего плана закончилось, или когда запрос — это запрос, который оплачивают только кредиты использования, такой как запрос к модели, которая [bills to usage credits](/docs/ru/model-config#fable-and-usage-credits). Сообщение называет, чей лимит вас заблокировал. Текст после `·` говорит, как увеличить этот лимит, и варьируется в зависимости от вашего плана и того, управляете ли вы выставлением счётов:832Включённое в ваш план использование не может покрыть этот запрос, а [usage credits](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans), которые в противном случае оплатили бы его, достигли лимита расходов. Это происходит, когда одно из окон использования вашего плана закончилось, или когда запрос относится к тем, которые оплачиваются только кредитами использования, например запрос к модели, которая [оплачивается кредитами использования](/docs/ru/model-config#fable-and-usage-credits). Сообщение указывает, чей лимит вас заблокировал. Текст после `·` говорит, как увеличить этот лимит, и зависит от вашего плана и от того, управляете ли вы биллингом:

832 833

833```text theme={null}834```text theme={null}

834You've hit your monthly spend limit · raise it at claude.ai/settings/usage835You've hit your monthly spend limit · raise it at https://claude.ai/settings/usage?from=cc_cli_limit_message

835You've hit your individual spend limit · ask your admin for a higher limit836You've hit your individual spend limit · ask your admin for a higher limit

836You've hit your org's monthly spend limit · visit claude.ai/admin-settings/usage to raise it837You've hit your org's monthly spend limit · visit https://claude.ai/admin-settings/usage to raise it

837You've hit your team's shared budget · ask your admin to raise it at claude.ai/admin-settings/usage838You've hit your team's shared budget · ask your admin to raise it at https://claude.ai/admin-settings/usage

838You've hit your channel's monthly spend limit · an org owner or channel manager can raise it in the channel's Claude settings839You've hit your channel's monthly spend limit · an org owner or channel manager can raise it in the channel's Claude settings

839```840```

840 841

841`team's shared budget` — это объединённый бюджет, который администратор назначил группе, к которой вы принадлежите; сообщение не называет группу. `channel's monthly spend limit` — это бюджет одного канала Slack, в котором работает сеанс, поэтому ваша организация может иметь бюджет вне его.842`team's shared budget` — это общий бюджет, который администратор назначил группе, в которую вы входите; сообщение не называет группу. `channel's monthly spend limit` — это бюджет того канала Slack, в котором работает сессия, поэтому у вашей организации может оставаться бюджет за его пределами.

842 843

843Когда одно из окон вашего плана — это то, что закончилось, сообщение также говорит, когда это окно сбрасывается, например `· your session limit resets 3:45pm`, и доступ возвращается тогда без того, чтобы кто-либо повышал лимит. В организациях с выставлением счётов на основе использования сообщение говорит `usage limit` вместо `spend limit`, как в `You've hit your individual usage limit`.844Когда закончилось одно из окон вашего плана, сообщение также говорит, когда это окно сбрасывается, например `· your session limit resets 3:45pm`, и в это время доступ возвращается без повышения лимита. В организациях с биллингом на основе использования сообщение говорит `usage limit` вместо `spend limit`, как в `You've hit your individual usage limit`.

844 845

845До версии v2.1.239 сообщение не называло время сброса окна плана. До версии v2.1.268 объединённый бюджет группы производил сообщение `individual spend limit` вместо `team's shared budget`.846Если вы подключаетесь через шлюз приложений Claude и видите `spend limit reached` в нижнем регистре, это ограничение вашего оператора шлюза; см. [Spend limit reached](#spend-limit-reached).

~~846~~

847Если вы подключаетесь через шлюз приложений Claude и видите строчное `spend limit reached`, это ограничение вашего оператора шлюза; см. [Spend limit reached](#spend-limit-reached).

848 847

849**Что делать:**848**Что делать:**

850 849

851* На Pro и Max увеличьте ваш ежемесячный лимит расходов в [**Settings > Usage**](https://claude.ai/settings/usage) на claude.ai, или запустите `/usage-credits`850* На Pro и Max увеличьте ваш ежемесячный лимит расходов в [**Settings > Usage**](https://claude.ai/settings/usage) на claude.ai или запустите `/usage-credits`

852* На Team и Enterprise увеличьте лимит в [**Organization settings > Usage**](https://claude.ai/admin-settings/usage), если вы управляете биллингом, или попросите администратора. `/usage-credits` отправляет этот запрос вашему администратору за вас851* На Team и Enterprise увеличьте лимит в [**Organization settings > Usage**](https://claude.ai/admin-settings/usage), если вы управляете биллингом, или попросите администратора. `/usage-credits` отправляет этот запрос вашему администратору за вас

853* Для лимита канала попросите владельца организации или менеджера канала повысить его на claude.ai. См. [Per-channel limits](https://claude.com/docs/claude-tag/admins/set-spend-limit#per-channel-limits) в документации Claude Tag852* Для лимита канала попросите владельца организации или менеджера канала повысить его на claude.ai. См. [Per-channel limits](https://claude.com/docs/claude-tag/admins/set-spend-limit#per-channel-limits) в документации Claude Tag

854* Если сообщение называет время сброса для окна вашего плана, вы можете вместо этого дождаться его853* Если сообщение называет время сброса окна вашего плана, вы можете вместо этого дождаться его

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

856 855

857<h3 id="spend-limit-reached">856<h3 id="spend-limit-reached">

858 Spend limit reached857 Spend limit reached

859</h3>858</h3>

860 859

861Вы подключаетесь через [Claude apps gateway](/docs/ru/claude-apps-gateway) и прошли [spend cap](/docs/ru/claude-apps-gateway-spend-limits), который установил ваш оператор шлюза. Шлюз блокирует ваши запросы до сброса названного периода или пока оператор не повысит ограничение. Он отмечает каждый заблокированный ответ `429` как `x-should-retry: false`, поэтому Claude Code показывает это сообщение без повторных попыток.860Вы подключаетесь через [Claude apps gateway](/docs/ru/claude-apps-gateway) и превысили [spend cap](/docs/ru/claude-apps-gateway-spend-limits), установленный вашим оператором шлюза. Шлюз блокирует ваши запросы до сброса указанного периода или пока оператор не повысит ограничение. Он помечает каждый заблокированный ответ `429` как `x-should-retry: false`, поэтому Claude Code показывает это сообщение без повторных попыток.

862 861

863```text theme={null}862```text theme={null}

864spend limit reached (daily; resets 2026-08-09 00:00 UTC)863spend limit reached (daily; resets 2026-08-09 00:00 UTC)

865```864```

866 865

867Сообщение называет период ограничения и время сброса, и когда оператор настроил `blocked_message`, его инструкции следуют за ним. До версии v2.1.225 сообщение читалось только `spend limit reached`; шлюз на более старой версии всё ещё отправляет эту более короткую форму.866Сообщение указывает период ограничения и время сброса, а если оператор настроил `blocked_message`, за ним следуют его инструкции. До версии v2.1.225 сообщение гласило только `spend limit reached`; шлюз на более старой версии по-прежнему отправляет эту краткую форму.

868 867

869**Что делать:**868**Что делать:**

870 869

871* Дождитесь времени сброса, которое называет сообщение, или следуйте инструкциям оператора, если сообщение их содержит870* Дождитесь времени сброса, указанного в сообщении, или следуйте инструкциям оператора, если сообщение их содержит

872* Попросите вашего оператора шлюза повысить ограничение, если вы его часто достигаете871* Попросите вашего оператора шлюза повысить ограничение, если вы регулярно его достигаете

873 872

874Связанное сообщение, `spend limit unavailable`, означает, что шлюз не смог прочитать свои записи расходов и заблокировал запрос в качестве меры предосторожности, а не из-за вашего ограничения. Обычно это очищается само по себе; если это сохраняется, сообщите вашему оператору шлюза.873Связанное сообщение, `spend limit unavailable`, означает, что шлюз не смог прочитать свои записи о расходах и заблокировал запрос в качестве меры предосторожности, а не из-за превышения вашего ограничения. Обычно это проходит само; если проблема сохраняется, сообщите вашему оператору шлюза.

875 874

876<h3 id="credit-balance-is-too-low">875<h3 id="credit-balance-is-too-low">

877 Credit balance is too low876 Credit balance is too low

878</h3>877</h3>

879 878

880Ваша организация Console исчерпала предоплаченные кредиты, или Claude Code отправляет ваши запросы с помощью Console API key, когда вы имели в виду использовать вашу подписку.879В вашей организации Console закончились предоплаченные кредиты, или Claude Code отправляет ваши запросы с API-ключом Console, хотя вы собирались использовать вашу подписку.

881 880

882```text theme={null}881```text theme={null}

883Credit balance is too low882Credit balance is too low

885 884

886**Что делать:**885**Что делать:**

887 886

888* Если у вас есть план Pro, Max, Team или Enterprise и вы видите это, запустите `/status` и проверьте строку `API key`. Одобренный `ANTHROPIC_API_KEY` в вашей среде маршрутизирует запросы через этот ключ вместо вашей подписки. Отмените его в текущей оболочке и удалите из профиля оболочки, затем перезапустите `claude`. Запустите `/login`, если вы ещё не вошли с вашей подпиской.887* Если у вас план Pro, Max, Team или Enterprise и вы видите это сообщение, запустите `/status` и проверьте строку `API key`. Одобренный `ANTHROPIC_API_KEY` в вашей среде направляет запросы через этот ключ вместо вашей подписки. Удалите его из текущей оболочки и из профиля оболочки, затем перезапустите `claude`. Запустите `/login`, если вы ещё не вошли с вашей подпиской.

889* Добавьте кредиты на [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing) и рассмотрите возможность включения автоматической перезагрузки там, чтобы баланс пополнялся перед тем, как он упадёт до нуля888* Пополните кредиты на [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing) и рассмотрите возможность включить там автоматическое пополнение, чтобы баланс пополнялся до того, как опустится до нуля

890* Установите ограничения расходов на рабочее пространство в Console, чтобы предотвратить истощение баланса организации одним проектом. См. [Manage costs effectively](/docs/ru/costs).889* Установите ограничения расходов для рабочих пространств в Console, чтобы один проект не исчерпал баланс организации. См. [Manage costs effectively](/docs/ru/costs).

891 890

892<h3 id="could-not-update-your-spend-limit">891<h3 id="could-not-update-your-spend-limit">

893 Could not update your spend limit892 Could not update your spend limit

894</h3>893</h3>

895 894

896Сервер отклонил изменение лимита расходов, которое вы сделали из подсказки, которая появляется, когда вы достигаете лимита расходов.895Сервер отклонил изменение лимита расходов, которое вы внесли в окне запроса, появляющемся при достижении лимита расходов.

897 896

898```text theme={null}897```text theme={null}

899Could not update your spend limit: <reason from the server>898Could not update your spend limit: <reason from the server>

900```899```

901 900

902Когда сервер объясняет отклонение, сообщение заканчивается этой причиной, и повторная попытка того же значения снова не удаётся. Когда отказ не имеет предоставленной сервером причины, такой как разорванное соединение, сообщение читает `Could not update your spend limit. Press Enter to retry.` и повторная попытка может быть успешной. До версии v2.1.216 Claude Code показывал общую форму для каждого отказа.901Когда сервер объясняет отклонение, сообщение заканчивается этой причиной, и повторная попытка с тем же значением снова завершится неудачей. Когда у сбоя нет причины от сервера, например при разрыве соединения, сообщение гласит `Could not update your spend limit. Press Enter to retry.`, и повторная попытка может оказаться успешной. До версии v2.1.216 Claude Code показывал общую форму при любом сбое.

903 902

904**Что делать:**903**Что делать:**

905 904

906* Если сообщение включает причину, выберите лимит, который её удовлетворяет, например меньшую сумму905* Если сообщение содержит причину, выберите лимит, который ей удовлетворяет, например меньшую сумму

907* Если сообщение показывает только общую форму, повторите попытку; отказ может быть временным906* Если сообщение показывает только общую форму, повторите попытку; сбой может быть временным

908* Если изменение продолжает не удаваться, сделайте его из ваших [claude.ai billing settings](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) в браузере вместо этого907* Если изменение по-прежнему не удаётся, внесите его вместо этого в [claude.ai billing settings](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) в браузере

909 908

910<h2 id="authentication-errors">909<h2 id="authentication-errors">

911 Ошибки аутентификации910 Ошибки аутентификации

2861 2860

2862Если сообщение содержит строку `` Details: `[reasoning_extraction]` ``, см. раздел [Safeguards flagged a request for Claude's reasoning](#safeguards-flagged-a-request-for-claudes-reasoning).2861Если сообщение содержит строку `` Details: `[reasoning_extraction]` ``, см. раздел [Safeguards flagged a request for Claude's reasoning](#safeguards-flagged-a-request-for-claudes-reasoning).

2863 2862

2864Сообщение содержит ссылку на [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude), которая предоставляет доступ для легитимной работы в области кибербезопасности. На Opus 5.5 и Sonnet 5.5 сообщение вместо этого начинается с `<model>'s safeguards flagged this session`. Если для помеченной категории доступна резервная модель, Claude Code [переключает модель](/docs/ru/model-config#automatic-model-fallback), а не показывает эту ошибку.2863Это сообщение содержит ссылку на [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude), которая предоставляет доступ для легитимной работы в области кибербезопасности. Модели с [автоматическим переключением на резервную модель](/docs/ru/model-config#automatic-model-fallback) выводят другое сообщение, без этой ссылки; на Opus 5.5 и Sonnet 5.5 оно начинается с `<model>'s safeguards flagged this session`. В том разделе также описано, когда Claude Code вместо этого переключает модель.

2865 2864

2866В [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) и [Microsoft Foundry](/docs/ru/microsoft-foundry) пометка кибербезопасности вместо этого приводит к сообщению [Usage Policy refusal](#usage-policy-refusal).2865В [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) и [Microsoft Foundry](/docs/ru/microsoft-foundry) пометка кибербезопасности вместо этого приводит к сообщению [Usage Policy refusal](#usage-policy-refusal).

2867 2866

4824This session has no saved transcript — it was stopped before its first response finished. If it was backgrounded from another conversation, that one is still intact; `claude respawn <id>` starts this one fresh.4823This session has no saved transcript — it was stopped before its first response finished. If it was backgrounded from another conversation, that one is still intact; `claude respawn <id>` starts this one fresh.

4825```4824```

4826 4825

4827При открытии строки той же сессии в [представлении агента](/docs/ru/agent-view) вместо этого под списком показывается `Press enter again to restart this session fresh`, и повторное нажатие `Enter` на строке перезапускает сессию с пустым диалогом. До версии 2.1.212 при открытии строки показывалось сообщение об отказе без возможности перезапуска из представления агента. До версии 2.1.211 открытие остановленной сессии молча запускало пустой диалог и могло повторно выполнить исходный промпт сессии.4826При открытии строки той же сессии в [представлении агента](/docs/ru/agent-view) вместо этого под списком показывается `Press enter again to restart this session fresh`, и повторное нажатие `Enter` на строке перезапускает сессию с пустым диалогом.

4828 4827

4829**Что делать:**4828**Что делать:**

4830 4829

4846* **`running in another terminal`**: диалог удерживает терминал, например тот, в котором вы возобновили его с помощью `claude --resume` или `/resume`. В строке также показывается `Open in a terminal`.4845* **`running in another terminal`**: диалог удерживает терминал, например тот, в котором вы возобновили его с помощью `claude --resume` или `/resume`. В строке также показывается `Open in a terminal`.

4847* **`already open in another running Claude session`**: его удерживает другой неинтерактивный процесс Claude Code, например процесс [фоновой сессии](/docs/ru/agent-view#the-supervisor-process) для того же диалога, который ещё не завершился.4846* **`already open in another running Claude session`**: его удерживает другой неинтерактивный процесс Claude Code, например процесс [фоновой сессии](/docs/ru/agent-view#the-supervisor-process) для того же диалога, который ещё не завершился.

4848 4847

4849Claude Code сохраняет ответ, который вы ввели при открытии строки, и отправляет его как следующий промпт сессии при её следующем запуске.

~~4850~~

4851**Что делать:**4848**Что делать:**

4852 4849

4853* Продолжите диалог в процессе, в котором он открыт, или завершите этот процесс и снова откройте строку4850* Продолжите диалог в процессе, в котором он открыт, или завершите этот процесс и снова откройте строку

feature-availability.md +4 −5

Details

92 <td>✗</td>92 <td>✗</td>

93 <td>✓</td>93 <td>✓</td>

94 <td>См. примечание <sup><a href="#fn1">1</a></sup></td>94 <td>См. примечание <sup><a href="#fn1">1</a></sup></td>

~~95 <td>✓ ([развёртывания размещённые на Anthropic](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options))</td>~~95 <td>✓</td>

96 </tr>96 </tr>

97 97

98 <tr>98 <tr>

188 188

189 <tbody>189 <tbody>

190 <tr>190 <tr>

191 <td>[Analytics dashboard и API](/docs/ru/analytics)</td>191 <td>[Панель управления аналитики и API](/docs/ru/analytics)</td>

192 <td>✓ (панель управления: Team и Enterprise; API: Enterprise)</td>192 <td>✓ (панель управления: Team и Enterprise; API: Enterprise)</td>

193 <td>✓ <sup><a href="#fn4">4</a></sup></td>193 <td>✓ <sup><a href="#fn4">4</a></sup></td>

194 <td>✗</td>194 <td>✗</td>

200 <tr>200 <tr>

201 <td>[Server-managed settings](/docs/ru/server-managed-settings)</td>201 <td>[Server-managed settings](/docs/ru/server-managed-settings)</td>

202 <td>✓ (Team и Enterprise)</td>202 <td>✓ (Team и Enterprise)</td>

203 <td>✓ (Team и Enterprise)</td>203 <td>См. [Доступность платформы](/docs/ru/server-managed-settings#platform-availability)</td>

204 <td>✗</td>204 <td>✗</td>

205 <td>✗</td>205 <td>✗</td>

206 <td>✗</td>206 <td>✗</td>

283 **Частичная поддержка:**283 **Частичная поддержка:**

284 284

285 * [Desktop](/docs/ru/desktop): только через [Claude Desktop на 3P](https://claude.com/docs/third-party/claude-desktop/overview)285 * [Desktop](/docs/ru/desktop): только через [Claude Desktop на 3P](https://claude.com/docs/third-party/claude-desktop/overview)

286 * [Web search](/docs/ru/tools-reference#websearch-tool-behavior): [развёртывания размещённые на Anthropic](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options) только

287 * [Авторежим](/docs/ru/auto-mode-config): только Sonnet 5 или более поздние версии, Opus 4.7 или более поздние версии, Haiku 5.5 и модели Fable286 * [Авторежим](/docs/ru/auto-mode-config): только Sonnet 5 или более поздние версии, Opus 4.7 или более поздние версии, Haiku 5.5 и модели Fable

288 * [Cross-session messaging](/docs/ru/cross-session-messaging): между вашими сеансами на этой машине только <sup><a href="#fn5">5</a></sup>287 * [Cross-session messaging](/docs/ru/cross-session-messaging): между вашими сеансами на этой машине только <sup><a href="#fn5">5</a></sup>

289 * [Zero Data Retention](/docs/ru/zero-data-retention): в соответствии с вашим соглашением Azure288 * [Zero Data Retention](/docs/ru/zero-data-retention): в соответствии с вашим соглашением Azure

294 <Tab title="Anthropic Console">293 <Tab title="Anthropic Console">

295 **Недоступно:** все [функции, требующие подписку Claude](#features-that-require-a-claude-subscription).294 **Недоступно:** все [функции, требующие подписку Claude](#features-that-require-a-claude-subscription).

296 295

297 Всё в разделе [Возможности CLI, которые различаются по поставщикам](#cli-capabilities-that-vary-by-provider) доступно, за исключением того, что [fast mode](/docs/ru/fast-mode) требует [подготовленный доступ](/docs/ru/fast-mode#enable-fast-mode-for-your-organization). [Server-managed settings](/docs/ru/server-managed-settings) также доступны когда ваш ключ API принадлежит организации Team или Enterprise.296 Всё в разделе [Возможности CLI, которые различаются по поставщикам](#cli-capabilities-that-vary-by-provider) доступно, за исключением того, что [быстрый режим](/docs/ru/fast-mode) требует [подготовленный доступ](/docs/ru/fast-mode#enable-fast-mode-for-your-organization). [Server-managed settings](/docs/ru/server-managed-settings), которые вы настраиваете в организации claude.ai Team или Enterprise, не применяются к сессии, которая аутентифицируется с помощью API-ключа Console. См. [Доступность платформы](/docs/ru/server-managed-settings#platform-availability), чтобы узнать, как охватить такие сессии.

298 </Tab>297 </Tab>

299</Tabs>298</Tabs>

300 299

github-actions.md +2 −0

Details

140| Разрешение | Доступ |140| Разрешение | Доступ |

141| - | - |141| - | - |

142| Actions | Чтение и запись |142| Actions | Чтение и запись |

143| Administration | Чтение |

143| Checks | Чтение и запись |144| Checks | Чтение и запись |

144| Contents | Чтение и запись |145| Contents | Чтение и запись |

145| Discussions | Чтение и запись |146| Discussions | Чтение и запись |

146| Issues | Чтение и запись |147| Issues | Чтение и запись |

147| Members | Чтение |148| Members | Чтение |

149| Merge queues | Чтение |

148| Metadata | Чтение |150| Metadata | Чтение |

149| Pull requests | Чтение и запись |151| Pull requests | Чтение и запись |

150| Repository hooks | Чтение и запись |152| Repository hooks | Чтение и запись |

glossary.md +1 −1

Details

294 Output style294 Output style

295</h3>295</h3>

296 296

297Конфигурация, которая изменяет инструкции, которые Claude Code дает Claude, для установки поведения ответа, тона или формата. В отличие от [CLAUDE.md](#claude-md), который добавляет контекст проекта наряду с инструкциями Claude Code по умолчанию, пользовательский стиль вывода может заменить инструкции инженерии программного обеспечения по умолчанию.297Конфигурация, которая изменяет инструкции, которые Claude Code дает Claude, для установки поведения ответа, тона или формата. В отличие от [CLAUDE.md](#claude-md), который добавляет контекст проекта наряду с инструкциями Claude Code по умолчанию, пользовательский стиль вывода добавляет собственные инструкции и может исключить инструкции по разработке программного обеспечения по умолчанию.

298 298

299Подробнее: [Output styles](/docs/ru/output-styles)299Подробнее: [Output styles](/docs/ru/output-styles)

300 300

google-vertex-ai.md +4 −2

Details

342 Контекстное окно с 1M токенов342 Контекстное окно с 1M токенов

343</h2>343</h2>

344 344

345Claude Sonnet 5, Opus 4.6 и более поздние версии, а также Sonnet 4.6 поддерживают [контекстное окно с 1M токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) на платформе Agent Platform Google Cloud. Sonnet 5 всегда работает с окном 1M, без варианта `[1m]` для выбора. Для других моделей Claude Code автоматически включает расширенное контекстное окно при выборе варианта модели с 1M.345Модели Fable, Sonnet 5 и более поздние версии, а также Opus 4.7 и более поздние версии по умолчанию работают с [контекстным окном с 1M токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) на платформе Agent Platform Google Cloud, без необходимости добавлять суффикс `[1m]`. Чтобы вместо этого сохранить окно 200K, установите [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/ru/model-config#turn-off-1m-context).

346 346

347[Мастер установки](#sign-in-with-agent-platform) предлагает опцию контекстного окна с 1M при закреплении моделей. Чтобы включить его для вручную закрепленной модели, добавьте `[1m]` к ID модели. Подробности см. в разделе [Закрепите модели для развертываний третьих сторон](/docs/ru/model-config#pin-models-for-third-party-deployments), включая способы использования окна 1M без изменения закрепления.347Opus 4.6 и Sonnet 4.6 получают окно 1M при выборе их варианта `[1m]`. [Мастер установки](#sign-in-with-agent-platform) предлагает опцию контекстного окна с 1M при закреплении моделей. Чтобы вместо этого включить его для вручную закреплённой модели, добавьте `[1m]` к ID модели. Подробности см. в разделе [Закрепите модели для развёртываний третьих сторон](/docs/ru/model-config#pin-models-for-third-party-deployments), включая способы использования окна 1M без изменения закрепления.

348

349До версии v2.1.287 модели Fable, а также Opus 4.7 и более поздние версии по умолчанию работали с окном 200K на платформе Agent Platform Google Cloud и получали окно 1M через суффикс `[1m]`.

348 350

349<h2 id="troubleshooting">351<h2 id="troubleshooting">

350 Устранение неполадок352 Устранение неполадок

headless.md +9 −4

Details

78 Фоновые задачи при выходе78 Фоновые задачи при выходе

79</h3>79</h3>

80 80

81Если Claude запускает [фоновую задачу Bash](/docs/ru/tools-reference#bash-tool-behavior) во время выполнения `claude -p`, например сервер разработки или сборку с отслеживанием, эта оболочка завершается примерно через пять секунд после того, как Claude вернул свой окончательный результат и stdin закрыт. Период ожидания позволяет задаче, которая завершается сразу после результата, всё ещё доставить свой вывод.81После того как Claude завершит свой ход и stdin закроется, запуск `claude -p` может оставаться открытым, чтобы дождаться фоновой работы, которую запустил Claude.

82 82

83Если Claude запускает фоновый [подагент](/docs/ru/sub-agents) или рабочий процесс, `claude -p` вместо этого остаётся открытым до завершения этой работы, потому что её результат является частью окончательного вывода.83Если только не выполняется ещё фоновая команда, запущенная основным диалогом, Claude Code по умолчанию останавливает всё, что ещё выполняется, после 10 минут непрерывного ожидания в простое и отбрасывает частичный результат. Чтобы изменить 10-минутный лимит, установите [`CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS`](/docs/ru/env-vars) или установите его на `0` для ожидания без ограничений.

84 84

85По умолчанию ожидание заканчивается после 10 минут непрерывного простоя, поэтому застрявший подагент или рабочий процесс не может держать процесс открытым неопределённо долго. В этот момент Claude Code останавливает всё, что ещё выполняется, и отбрасывает его частичный результат. Чтобы изменить ограничение, установите [`CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS`](/docs/ru/env-vars) или установите его на `0` для ожидания без ограничений.85Запуск ожидает фоновую работу, такую как фоновые команды, субагенты и рабочие процессы, наблюдения Monitor и ожидающие пробуждения `/loop`:

86 86

87Если Claude запускает наблюдение [Monitor](/docs/ru/tools-reference#monitor-tool) во время выполнения `claude -p`, Claude Code ждёт наблюдения до истечения времени ожидания или до того, как десятиминутный лимит завершит ожидание, в зависимости от того, что произойдёт раньше. Пока он ждёт, Claude продолжает отвечать на то, что сообщает наблюдение. По умолчанию наблюдение истекает через пять минут после того, как Claude его запустит.87* **[Фоновые команды](/docs/ru/tools-reference#background-commands)**: для команды, запущенной основным диалогом, например сервера разработки или сборки с отслеживанием, запуск ждёт, пока команда не завершится или не достигнет своего [ограничения по времени](/docs/ru/tools-reference#time-limit-for-background-commands). Затем Claude делает ещё один ход с полученным результатом, и результат этого хода становится последним результатом запуска — именно его выводят форматы `text` и `json`. Пока команда выполняется, 10-минутный лимит не завершает ожидание.

88* **Фоновые [субагенты](/docs/ru/sub-agents) и рабочие процессы**: запуск остаётся открытым до завершения этой работы, потому что её результат является частью окончательного вывода.

89* **Наблюдения [Monitor](/docs/ru/tools-reference#monitor-tool)**: запуск ждёт, пока не истечёт время наблюдения или пока 10-минутный лимит не завершит ожидание, в зависимости от того, что произойдёт раньше. Пока запуск ждёт, Claude продолжает отвечать на то, что сообщает наблюдение. По умолчанию наблюдение истекает через пять минут после того, как Claude его запустит.

90* **Ожидающие пробуждения**: в запуске, промпт которого вы передали как текст, а не с помощью `--input-format stream-json`, если Claude запланировал [пробуждение `/loop` в собственном темпе](/docs/ru/scheduled-tasks#let-claude-choose-the-interval), запуск ждёт срабатывания каждого пробуждения и выполняет его итерацию, пока [цикл не завершится](/docs/ru/scheduled-tasks#stop-a-loop), даже после 10-минутного лимита.

92Если запуск достигает своего лимита [`--max-budget-usd`](/docs/ru/cli-reference#cli-flags), Claude Code останавливает оставшуюся фоновую работу вместо того, чтобы ждать.

88 93

89<h3 id="stop-a-run-with-sigterm">94<h3 id="stop-a-run-with-sigterm">

90 Остановите запуск с помощью SIGTERM95 Остановите запуск с помощью SIGTERM

hooks.md +575 −406

Details

938| `PostCompact` | Нет | Показывает stderr только пользователю |938| `PostCompact` | Нет | Показывает stderr только пользователю |

939| `PreModelSwitch` | Да | Блокирует переключение модели и показывает stderr пользователю |939| `PreModelSwitch` | Да | Блокирует переключение модели и показывает stderr пользователю |

940| `PostModelSwitch` | Нет | Показывает stderr только пользователю; модель уже переключена |940| `PostModelSwitch` | Нет | Показывает stderr только пользователю; модель уже переключена |

941| `Elicitation` | Да | Отклоняет запрос elicitation |941| `Elicitation` | Да | Отклоняет запрос, и диалоговое окно не появляется |

942| `ElicitationResult` | Да | Блокирует ответ (действие становится отказом) |942| `ElicitationResult` | Да | Блокирует ответ (действие становится отказом) |

943| `WorktreeCreate` | Да | Любой ненулевой код выхода приводит к ошибке создания worktree |943| `WorktreeCreate` | Да | Любой ненулевой код выхода приводит к ошибке создания worktree |

944| `WorktreeRemove` | Да | Любой ненулевой код выхода приводит к ошибке удаления worktree, если каталог после этого всё ещё существует. Смотрите [WorktreeRemove](#worktreeremove), чтобы узнать, что происходит с каталогом |944| `WorktreeRemove` | Да | Любой ненулевой код выхода приводит к ошибке удаления worktree, если каталог после этого всё ещё существует. Смотрите [WorktreeRemove](#worktreeremove), чтобы узнать, что происходит с каталогом |

1095| PermissionDenied | `hookSpecificOutput` | `retry: true` сообщает модели, что она может повторить попытку отклонённого вызова инструмента; Claude Code игнорирует его для [отказов без вердикта](#permissiondenied-decision-control) |1095| PermissionDenied | `hookSpecificOutput` | `retry: true` сообщает модели, что она может повторить попытку отклонённого вызова инструмента; Claude Code игнорирует его для [отказов без вердикта](#permissiondenied-decision-control) |

1096| WorktreeCreate | возврат пути | Командный хук выводит путь в stdout; HTTP-хук возвращает `hookSpecificOutput.worktreePath`. Сбой хука или отсутствие пути прерывает создание |1096| WorktreeCreate | возврат пути | Командный хук выводит путь в stdout; HTTP-хук возвращает `hookSpecificOutput.worktreePath`. Сбой хука или отсутствие пути прерывает создание |

1098| Elicitation | `hookSpecificOutput` | `action` (accept/decline/cancel), `content` (значения полей формы для accept) |1098| Elicitation, ElicitationResult | `hookSpecificOutput` или `decision` верхнего уровня | `action` (accept/decline/cancel), `content` (значения полей формы). `decision: "block"` также [отклоняет запрос](#other-ways-to-decline-an-elicitation) |

1099| ElicitationResult | `hookSpecificOutput` | `action` (accept/decline/cancel), `content` (переопределение значений полей формы) |

1100| MessageDisplay | `hookSpecificOutput` | `displayContent` заменяет отображаемый на экране текст. Только для отображения: транскрипт и то, что видит Claude, сохраняют оригинал |1099| MessageDisplay | `hookSpecificOutput` | `displayContent` заменяет отображаемый на экране текст. Только для отображения: транскрипт и то, что видит Claude, сохраняют оригинал |

1101| SessionStart, SubagentStart, PostModelSwitch | Только контекст | `hookSpecificOutput.additionalContext` добавляет контекст для Claude. SessionStart также принимает [`initialUserMessage`, `watchPaths`, `sessionTitle` и `reloadSkills`](#sessionstart-decision-control). Без блокировки и управления решениями |1100| SessionStart, SubagentStart, PostModelSwitch | Только контекст | `hookSpecificOutput.additionalContext` добавляет контекст для Claude. SessionStart также принимает [`initialUserMessage`, `watchPaths`, `sessionTitle` и `reloadSkills`](#sessionstart-decision-control). Без блокировки и управления решениями |

1102| Setup, Notification, SessionEnd, PostCompact, InstructionsLoaded, StopFailure, CwdChanged, DirectoryAdded, FileChanged | Нет | Без управления решениями. Используются для побочных эффектов, таких как логирование или очистка |1101| Setup, Notification, SessionEnd, PostCompact, InstructionsLoaded, StopFailure, CwdChanged, DirectoryAdded, FileChanged | Нет | Без управления решениями. Используются для побочных эффектов, таких как логирование или очистка |

1169 SessionStart1168 SessionStart

1170</h3>1169</h3>

1171 1170

1172Выполняется, когда Claude Code запускает новую сессию или возобновляет существующую. Полезно для загрузки контекста разработки, например существующих задач или недавних изменений в кодовой базе, или для настройки переменных окружения. Для статического контекста, которому не нужен скрипт, используйте вместо этого [CLAUDE.md](/docs/ru/memory).1171Выполняется, когда Claude Code начинает новую сессию или возобновляет существующую. Полезно для загрузки контекста разработки, например существующих задач или недавних изменений в вашей кодовой базе, или для настройки переменных окружения. Для статического контекста, которому не требуется скрипт, используйте вместо этого [CLAUDE.md](/docs/ru/memory).

1173 1172

1174SessionStart выполняется в каждой сессии, поэтому такие хуки должны работать быстро. Поддерживаются только хуки `type: "command"` и `type: "mcp_tool"`. О том, когда выполняются хуки `mcp_tool`, см. [Поля хуков MCP-инструментов](#mcp-tool-hook-fields).1173SessionStart выполняется в каждой сессии, поэтому такие хуки должны работать быстро. Поддерживаются только хуки `type: "command"` и `type: "mcp_tool"`. О том, когда выполняются хуки `mcp_tool`, см. [Поля хуков инструментов MCP](#mcp-tool-hook-fields).

1175 1174

1176Значение matcher соответствует тому, как была инициирована сессия:1175Значение matcher соответствует тому, как была запущена сессия:

1177 1176

1178| Matcher | Когда срабатывает |1177| Matcher | Когда срабатывает |

1179| :- | :- |1178| :- | :- |

1184| `fork` | Новая сессия, ответвлённая от существующей: `--fork-session` вместе с `--resume` или `--continue`, фоновая копия `/fork`, `/branch` или диалог, который вы [перевели в фон](/docs/ru/agent-view#from-inside-a-session) |1183| `fork` | Новая сессия, ответвлённая от существующей: `--fork-session` вместе с `--resume` или `--continue`, фоновая копия `/fork`, `/branch` или диалог, который вы [переводите в фон](/docs/ru/agent-view#from-inside-a-session) |

1185 1184

1186До v2.1.214 ответвлённые сессии сообщали источник `"resume"`.1185До версии v2.1.214 ответвлённые сессии сообщали источник `"resume"`.

1187 1186

1188Когда вы запускаете интерактивную сессию, возобновляете диалог при запуске с помощью `--continue` или `--resume` или выполняете `/clear`, хуки SessionStart выполняются в фоне. Вы можете сразу начать вводить текст, а возобновлённый диалог появляется, не дожидаясь хуков. Первый ответ Claude всё же ожидает завершения хуков, чтобы их контекст дошёл до Claude.1187Когда вы запускаете интерактивную сессию, возобновляете диалог при запуске с помощью `--continue` или `--resume` или выполняете `/clear`, хуки SessionStart выполняются в фоне. Вы можете сразу начать печатать, а возобновлённый диалог появляется, не дожидаясь хуков. Первый ответ Claude всё равно ждёт завершения хуков, чтобы их контекст дошёл до Claude.

1189 1188

1190Когда вы переключаете диалоги с помощью `/resume` внутри сессии, переключение, напротив, ожидает завершения хуков. Если вы выполните `/clear` или переключитесь на другой диалог, пока фоновые хуки ещё работают, ничто из возвращённого ими к сессии не применяется.1189Когда вы переключаетесь между диалогами с помощью `/resume` внутри сессии, переключение, наоборот, ждёт завершения хуков. Если вы выполните `/clear` или переключитесь на другой диалог, пока фоновые хуки ещё выполняются, ничего из того, что они вернут, не применяется к сессии.

1191 1190

1192То же ожидание действует при запуске, в том числе для возобновлённой сессии: промпт, отправленный, пока хуки SessionStart ещё выполняются, не дойдёт до Claude, пока они не завершатся.1191То же ожидание действует и при запуске, включая возобновлённую сессию: промпт, отправленный, пока хуки SessionStart ещё выполняются, не дойдёт до Claude, пока они не завершатся.

1193 1192

1194Во время любого из этих ожиданий нажмите `Esc`, чтобы вернуть промпт в поле ввода, не отправляя его. Хуки продолжат выполняться.1193Во время любого из этих ожиданий нажмите `Esc`, чтобы вернуть промпт в поле ввода, не отправляя его. Хуки продолжают выполняться.

1195 1194

1196<h4 id="sessionstart-input">1195<h4 id="sessionstart-input">

1197 Входные данные SessionStart1196 Входные данные SessionStart

1201 1200

1202| Поле | Описание |1201| Поле | Описание |

1203| :- | :- |1202| :- | :- |

1204| `source` | Как началась сессия: `"startup"` для новых сессий, `"resume"` для возобновлённых, `"clear"` после `/clear`, `"compact"` после сжатия контекста или `"fork"` для новой сессии, ответвлённой от существующей |1203| `source` | Как началась сессия: `"startup"` для новых сессий, `"resume"` для возобновлённых сессий, `"clear"` после `/clear`, `"compact"` после сжатия контекста или `"fork"` для новой сессии, ответвлённой от существующей |

1205| `model` | Идентификатор активной модели. Может отсутствовать, например после `/clear` или когда сессия восстановлена через восстановление диалога, поэтому проверяйте наличие поля перед чтением |1204| `model` | Идентификатор активной модели. Может отсутствовать, например после `/clear` или когда сессия восстановлена через восстановление диалога, поэтому проверяйте наличие поля перед его чтением |

1207| `session_title` | Пользовательское название сессии; присутствует, если оно задано, например через `--name`, `/rename`, вывод хука `sessionTitle` или `renameSession()` в Agent SDK. Хук, выдающий `sessionTitle`, может сначала проверить это поле, чтобы не перезаписать существующее пользовательское название |1206| `session_title` | Пользовательское название сессии; присутствует, если оно задано, например через `--name`, `/rename`, вывод `sessionTitle` хука или `renameSession()` в Agent SDK. Хук, который выдаёт `sessionTitle`, может сначала проверить это поле, чтобы не перезаписать существующее пользовательское название |

1208 1207

1209У сессии, которую вы не назвали, всё равно может быть [сгенерированное название](/docs/ru/sessions#name-your-sessions). Такое название не является пользовательским и не появляется в `session_title`.1208У сессии, которой вы не дали имя, всё равно может быть [сгенерированное название](/docs/ru/sessions#name-your-sessions). Такое название не является пользовательским и не появляется в `session_title`.

1210 1209

1211Когда `source` равно `"resume"` или `"fork"` и транскрипт содержит хотя бы один ответ от Claude, хуки SessionStart также получают четыре поля ниже. Ваш хук может использовать их, чтобы до первого запроса сообщить, во что обойдётся возобновление устаревшего диалога, например в [`systemMessage`](#json-output). Для этих полей требуется Claude Code v2.1.251 или новее.1210Когда `source` равен `"resume"` или `"fork"` и транскрипт содержит хотя бы один ответ Claude, хуки SessionStart также получают четыре поля, перечисленные ниже. Ваш хук может использовать их, чтобы до первого запроса сообщить, во что обойдётся возобновление устаревшего диалога, например в [`systemMessage`](#json-output). Для этих полей требуется Claude Code v2.1.251 или новее.

1212 1211

1213| Поле | Описание |1212| Поле | Описание |

1214| :- | :- |1213| :- | :- |

1217| `prompt_cache_likely_expired` | `true`, когда последний ответ старше [времени жизни кэша промптов](/docs/ru/prompt-caching#cache-lifetime) сессии или более позднее сжатие контекста заменило кэшированный диалог |1216| `prompt_cache_likely_expired` | `true`, когда последний ответ старше [срока жизни кэша промптов](/docs/ru/prompt-caching#cache-lifetime) сессии или когда последующее сжатие контекста заменило кэшированный диалог |

1218| `estimated_cache_write_usd` | Оценочная стоимость в долларах США записи `context_tokens` в кэш промптов на модели сессии, без учёта ответа |1217| `estimated_cache_write_usd` | Оценочная стоимость в долларах США записи `context_tokens` в кэш промптов на модели сессии, без учёта ответа |

1219 1218

1220В этом примере показаны входные данные для сессии, возобновлённой через 90 минут после последнего ответа:1219В этом примере показаны входные данные для сессии, возобновлённой через 90 минут после её последнего ответа:

1221 1220

1222```json theme={null}1221```json theme={null}

1223{1222{

1242 1241

1243| Поле | Описание |1242| Поле | Описание |

1244| :- | :- |1243| :- | :- |

1245| `additionalContext` | Строка, добавляемая в контекст Claude в начале диалога, перед первым промптом. О том, как доставляется текст и что в него включать, см. [Добавление контекста для Claude](#add-context-for-claude) |1244| `additionalContext` | Строка, добавляемая в контекст Claude в начале диалога, до первого промпта. О том, как доставляется текст и что в него помещать, см. [Добавление контекста для Claude](#add-context-for-claude) |

1246| `initialUserMessage` | Строка, используемая как первое пользовательское сообщение сессии. Применяется в [неинтерактивном режиме](/docs/ru/headless) с флагом `-p`, где она становится первым ходом, даже если промпт не передан. Если промпт передан, он следует как следующий ход. В отличие от `additionalContext`, который прикрепляется к существующему ходу, это поле создаёт ход |1245| `initialUserMessage` | Строка, используемая как первое пользовательское сообщение сессии. Применяется в [неинтерактивном режиме](/docs/ru/headless) с флагом `-p`, где она становится первым ходом, даже если промпт не передан. Если промпт передан, он следует за ней как следующий ход. В отличие от `additionalContext`, который прикрепляется к существующему ходу, это поле создаёт ход |

1247| `sessionTitle` | Задаёт название сессии с тем же эффектом, что и `/rename`. Используйте для автоматического именования сессий по каталогу запуска, ветке git или имени worktree. Применяется, когда `source` равно `"startup"`, `"resume"` или `"fork"`; игнорируется при `"clear"` и `"compact"` |1246| `sessionTitle` | Задаёт название сессии, с тем же эффектом, что и `/rename`. Используйте, чтобы автоматически именовать сессии по папке запуска, ветке git или имени worktree. Применяется, когда `source` равен `"startup"`, `"resume"` или `"fork"`; игнорируется для `"clear"` и `"compact"` |

1249| `reloadSkills` | Логическое значение. При `true` Claude Code повторно сканирует каталоги [скиллов](/docs/ru/skills) и команд после завершения хуков SessionStart, так что установленные хуком скиллы доступны в той же сессии, начиная с первого промпта |1248| `reloadSkills` | Логическое значение. При `true` Claude Code повторно сканирует каталоги [скиллов](/docs/ru/skills) и команд после завершения хуков SessionStart, чтобы скиллы, установленные хуком, были доступны в той же сессии, начиная с первого промпта |

1250 1249

1251```json theme={null}1250```json theme={null}

1252{1251{

1258}1257}

1259```1258```

1260 1259

1261Поскольку для этого события обычный stdout и так доходит до Claude, хук, который только загружает контекст, может выводить данные прямо в stdout, не формируя JSON. Используйте форму JSON, когда нужно совместить контекст с другими полями, например `sessionTitle`.1260Поскольку для этого события обычный stdout и так доходит до Claude, хук, который только загружает контекст, может выводить его прямо в stdout, не формируя JSON. Используйте форму JSON, когда нужно совместить контекст с другими полями, например `sessionTitle`.

1262 1261

1263Используйте `reloadSkills`, когда хук SessionStart устанавливает или обновляет скиллы. Обнаружение скиллов обычно выполняется до завершения хуков SessionStart, поэтому файлы, которые хук записывает в `~/.claude/skills/` или `.claude/skills/`, иначе появились бы только в следующей сессии. В этом примере синхронизируется общий репозиторий скиллов и запрашивается повторное сканирование:1262Используйте `reloadSkills`, когда хук SessionStart устанавливает или обновляет скиллы. Обнаружение скиллов обычно выполняется до завершения хуков SessionStart, поэтому файлы, которые хук записывает в `~/.claude/skills/` или `.claude/skills/`, иначе появились бы только в следующей сессии. Этот пример синхронизирует общий репозиторий скиллов и запрашивает повторное сканирование:

1264 1263

1265```bash theme={null}1264```bash theme={null}

1266#!/bin/bash1265#!/bin/bash

1271echo '{"hookSpecificOutput": {"hookEventName": "SessionStart", "reloadSkills": true}}'1270echo '{"hookSpecificOutput": {"hookEventName": "SessionStart", "reloadSkills": true}}'

1272```1271```

1273 1272

1274URL репозитория — это заполнитель; замените его на собственный репозиторий скиллов. С заполнителем клонирование завершится ошибкой и выведет сообщение `fatal:` в stderr. Stderr хука SessionStart, завершившегося с кодом 0, носит лишь информационный характер, поэтому запрос `reloadSkills` всё равно применяется.1273URL репозитория здесь — заглушка; замените его на собственный репозиторий скиллов. С заглушкой клонирование завершается ошибкой и выводит сообщение `fatal:` в stderr. Stderr хука SessionStart, завершившегося с кодом 0, носит лишь информационный характер, поэтому запрос `reloadSkills` всё равно применяется.

1275 1274

1276<h4 id="persist-environment-variables">1275<h4 id="persist-environment-variables">

1277 Сохранение переменных окружения1276 Сохранение переменных окружения

1278</h4>1277</h4>

1279 1278

1280Хукам SessionStart доступна переменная окружения `CLAUDE_ENV_FILE`, содержащая путь к файлу, в котором можно сохранять переменные окружения для последующих команд Bash.1279Хуки SessionStart имеют доступ к переменной окружения `CLAUDE_ENV_FILE`, которая содержит путь к файлу, где можно сохранить переменные окружения для последующих команд Bash.

1281 1280

1282Чтобы задать отдельные переменные окружения, запишите инструкции `export` в `CLAUDE_ENV_FILE`. Используйте дозапись (`>>`), чтобы сохранить переменные, заданные другими хуками:1281Чтобы задать отдельные переменные окружения, запишите инструкции `export` в `CLAUDE_ENV_FILE`. Используйте добавление (`>>`), чтобы сохранить переменные, заданные другими хуками:

1283 1282

1284```bash theme={null}1283```bash theme={null}

1285#!/bin/bash1284#!/bin/bash

1313```1312```

1314 1313

1315<Note>1314<Note>

1316 `CLAUDE_ENV_FILE` доступна для хуков SessionStart, [Setup](#setup), [CwdChanged](#cwdchanged) и [FileChanged](#filechanged). Хукам других типов эта переменная недоступна.1315 `CLAUDE_ENV_FILE` доступна для хуков SessionStart, [Setup](#setup), [CwdChanged](#cwdchanged) и [FileChanged](#filechanged). Другие типы хуков не имеют доступа к этой переменной.

1317</Note>1316</Note>

1318 1317

1319<h3 id="setup">1318<h3 id="setup">

1320 Setup1319 Setup

1321</h3>1320</h3>

1322 1321

1323Срабатывает, только когда вы запускаете Claude Code с `--init-only` либо с `--init` или `--maintenance` в [неинтерактивном режиме](/docs/ru/headless) с флагом `-p`. При обычном запуске не срабатывает. Используйте его для однократной установки зависимостей или плановой очистки, которую вы явно запускаете из CI или скриптов, отдельно от обычного запуска сессии. Для инициализации каждой сессии используйте вместо этого [SessionStart](#sessionstart).1322Срабатывает только при запуске Claude Code с `--init-only` либо с `--init` или `--maintenance` в [неинтерактивном режиме](/docs/ru/headless) с флагом `-p`. При обычном запуске не срабатывает. Используйте его для одноразовой установки зависимостей или плановой очистки, которую вы явно запускаете из CI или скриптов, отдельно от обычного запуска сессии. Для инициализации на уровне каждой сессии используйте вместо этого [SessionStart](#sessionstart).

1324 1323

1325Значение matcher соответствует флагу CLI, вызвавшему хук:1324Значение matcher соответствует флагу CLI, который вызвал хук:

1326 1325

1327| Matcher | Когда срабатывает |1326| Matcher | Когда срабатывает |

1328| :- | :- |1327| :- | :- |

1331 1330

1332Когда вы выполняете `claude --init-only`, Claude Code запускает хуки Setup и хуки `SessionStart` с matcher `startup`, а затем завершает работу, не начиная диалог.1331Когда вы выполняете `claude --init-only`, Claude Code запускает хуки Setup и хуки `SessionStart` с matcher `startup`, а затем завершает работу, не начиная диалог.

1333 1332

1334Когда вы начинаете или продолжаете диалог с `-p`, также нужно передать промпт — как аргумент или через stdin. Промпт можно не передавать, если хук `SessionStart` предоставляет [`initialUserMessage`](#sessionstart-decision-control) или если вы возобновляете сессию с [отложенным вызовом инструмента](#defer-a-tool-call-for-later).1333Когда вы начинаете или продолжаете диалог с `-p`, нужно также передать промпт — в качестве аргумента или через stdin. Промпт можно не передавать, если хук `SessionStart` предоставляет [`initialUserMessage`](#sessionstart-decision-control) или если вы возобновляете сессию с [отложенным вызовом инструмента](#defer-a-tool-call-for-later).

1335 1334

1336При успехе `--init-only` ничего не выводит в терминал. Чтобы убедиться, что хуки выполнились, запустите `claude --debug-file <path> --init-only`, заменив `<path>` на расположение файла лога, и проверьте в логе записи хуков Setup и SessionStart.1335При успешном выполнении `--init-only` ничего не выводит в терминал. Чтобы убедиться, что хуки выполнились, запустите `claude --debug-file <path> --init-only`, заменив `<path>` на расположение файла лога, и проверьте в логе записи хуков Setup и SessionStart.

1337 1336

1338Поскольку Setup срабатывает не при каждом запуске, плагин, которому нужна установленная зависимость, не может полагаться только на Setup. Практичный подход — проверять наличие зависимости при первом использовании и устанавливать её при отсутствии, например с помощью хука или скилла, который проверяет `${CLAUDE_PLUGIN_DATA}/node_modules` и выполняет `npm install`, если каталога нет. О том, где хранить установленные зависимости, см. [постоянный каталог данных](/docs/ru/plugins/components#path-variables-and-persistent-data). Если вы распространяете плагин через маркетплейс, этот подход может не понадобиться: Claude Code [автоматически устанавливает подходящие зависимости пакетов Node.js](/docs/ru/plugins/loading#node-js-package-dependencies) при кэшировании плагина.1337Поскольку Setup срабатывает не при каждом запуске, плагин, которому нужна установленная зависимость, не может полагаться только на Setup. Практичный подход — проверять наличие зависимости при первом использовании и устанавливать её при отсутствии, например хуком или скиллом, который проверяет наличие `${CLAUDE_PLUGIN_DATA}/node_modules` и выполняет `npm install`, если его нет. О том, где хранить установленные зависимости, см. [постоянный каталог данных](/docs/ru/plugins/components#path-variables-and-persistent-data). Если вы распространяете плагин через маркетплейс, этот подход может не понадобиться: Claude Code [автоматически устанавливает подходящие зависимости пакетов Node.js](/docs/ru/plugins/loading#node-js-package-dependencies) при кэшировании плагина.

1339 1338

1340<h4 id="setup-input">1339<h4 id="setup-input">

1341 Входные данные Setup1340 Входные данные Setup

1357 Управление решениями Setup1356 Управление решениями Setup

1358</h4>1357</h4>

1359 1358

1360Хуки Setup не могут блокировать; выполнение продолжается при любом коде выхода. При любом коде выхода Claude Code отбрасывает [поля вывода JSON](#json-output) хука Setup, такие как `systemMessage`, `continue` и `hookSpecificOutput.additionalContext`. С `-p` stdout, stderr и код выхода хука Setup появляются в выводе запуска только в виде [событий `hook_response`](/docs/ru/headless#read-session-metadata), когда вы запускаете с `--output-format stream-json --verbose`.1359Хуки Setup не могут блокировать; выполнение продолжается при любом коде выхода. При любом коде выхода Claude Code отбрасывает [поля вывода JSON](#json-output) хука Setup, такие как `systemMessage`, `continue` и `hookSpecificOutput.additionalContext`. С `-p` stdout, stderr и код выхода хука Setup появляются в выводе запуска только как [события `hook_response`](/docs/ru/headless#read-session-metadata), когда вы запускаете с `--output-format stream-json --verbose`.

1361 1360

1362Хуки Setup имеют доступ к `CLAUDE_ENV_FILE`. Переменные, записанные в этот файл, сохраняются для последующих команд Bash в сессии, как в [хуках SessionStart](#persist-environment-variables). На `Setup` выполняются только хуки `type: "command"`. Хук `type: "mcp_tool"` на `Setup` всегда пропускается, как описано в разделе [Поля хука MCP-инструмента](#mcp-tool-hook-fields).1361Хуки Setup имеют доступ к `CLAUDE_ENV_FILE`. Переменные, записанные в этот файл, сохраняются для последующих команд Bash в сессии, как и в [хуках SessionStart](#persist-environment-variables). Для `Setup` выполняются только хуки `type: "command"`. Хук `type: "mcp_tool"` для `Setup` всегда пропускается, как описано в разделе [Поля хуков инструментов MCP](#mcp-tool-hook-fields).

1363 1362

1364<h3 id="instructionsloaded">1363<h3 id="instructionsloaded">

1365 InstructionsLoaded1364 InstructionsLoaded

1366</h3>1365</h3>

1367 1366

1368Срабатывает, когда файл `CLAUDE.md` или `.claude/rules/*.md` загружается в контекст. Это событие срабатывает при старте сессии для файлов, загружаемых сразу, и позже при отложенной загрузке файлов, например когда Claude обращается к подкаталогу, содержащему вложенный `CLAUDE.md`, или когда срабатывают условные правила с frontmatter `paths:`. Хук не поддерживает блокировку или управление решениями. Он выполняется асинхронно в целях наблюдаемости.1367Срабатывает, когда файл `CLAUDE.md` или `.claude/rules/*.md` загружается в контекст. Это событие срабатывает при запуске сессии для файлов, загружаемых сразу, и повторно позже, когда файлы загружаются отложенно, например когда Claude обращается к подкаталогу, содержащему вложенный `CLAUDE.md`, или когда срабатывают условные правила с frontmatter `paths:`. Хук не поддерживает блокировку или управление решениями. Он выполняется асинхронно в целях наблюдаемости.

1369 1368

1370Это событие не срабатывает, когда Claude [читает `AGENTS.md` напрямую](/docs/ru/memory#agents-md) через настройку **Project instructions**. Оно срабатывает, когда `CLAUDE.md` импортирует ваш `AGENTS.md` — с `load_reason`, равным `include`, как для любого другого импортированного файла, — и когда `CLAUDE.md` является символической ссылкой на него — как обычная загрузка `CLAUDE.md`.1369Это событие не срабатывает, когда Claude [читает `AGENTS.md` напрямую](/docs/ru/memory#agents-md) через настройку **Project instructions**. Оно срабатывает, когда `CLAUDE.md` импортирует ваш `AGENTS.md` — с `load_reason`, равным `include`, как и для любого другого импортируемого файла, — а также когда `CLAUDE.md` является символической ссылкой на него, как при обычной загрузке `CLAUDE.md`.

1371 1370

1372Matcher сопоставляется с `load_reason`. Например, используйте `"matcher": "session_start"`, чтобы срабатывать только для файлов, загруженных при запуске сессии, или `"matcher": "path_glob_match|nested_traversal"`, чтобы срабатывать только при отложенных загрузках.1371Matcher сопоставляется с `load_reason`. Например, используйте `"matcher": "session_start"`, чтобы срабатывать только для файлов, загруженных при запуске сессии, или `"matcher": "path_glob_match|nested_traversal"`, чтобы срабатывать только при отложенной загрузке.

1373 1372

1374<h4 id="instructionsloaded-input">1373<h4 id="instructionsloaded-input">

1375 Входные данные InstructionsLoaded1374 Входные данные InstructionsLoaded

1381| :- | :- |1380| :- | :- |

1384| `load_reason` | Почему файл был загружен: `"session_start"`, `"nested_traversal"`, `"path_glob_match"`, `"include"` или `"compact"`. Значение `"compact"` срабатывает, когда файлы инструкций повторно загружаются после сжатия контекста |1383| `load_reason` | Почему файл был загружен: `"session_start"`, `"nested_traversal"`, `"path_glob_match"`, `"include"` или `"compact"`. Значение `"compact"` используется, когда файлы инструкций повторно загружаются после сжатия контекста |

1385| `globs` | Glob-шаблоны путей из frontmatter `paths:` файла, если есть. Присутствует только для загрузок `path_glob_match` |1384| `globs` | Glob-шаблоны путей из frontmatter `paths:` файла, если они есть. Присутствует только при загрузках `path_glob_match` |

1388 1387

1402 Управление решениями InstructionsLoaded1401 Управление решениями InstructionsLoaded

1403</h4>1402</h4>

1404 1403

1405У хуков InstructionsLoaded нет управления решениями. Они не могут блокировать или изменять загрузку инструкций. Claude Code отбрасывает их [поля вывода JSON](#json-output), такие как `systemMessage` и `continue`. Используйте это событие для журнала аудита, отслеживания соответствия требованиям или наблюдаемости.1404Хуки InstructionsLoaded не имеют управления решениями. Они не могут блокировать или изменять загрузку инструкций. Claude Code отбрасывает их [поля вывода JSON](#json-output), такие как `systemMessage` и `continue`. Используйте это событие для журнала аудита, отслеживания соответствия требованиям или наблюдаемости.

1406 1405

1407<h3 id="userpromptsubmit">1406<h3 id="userpromptsubmit">

1408 UserPromptSubmit1407 UserPromptSubmit

1409</h3>1408</h3>

1410 1409

1411Запускается при отправке промпта, до того как Claude его обработает. Это позволяет1410Выполняется при отправке промпта, до того как Claude его обработает. Это позволяет

1412добавлять дополнительный контекст на основе промпта/диалога, проверять промпты или1411добавлять дополнительный контекст на основе промпта или диалога, проверять промпты или

1413блокировать определённые типы промптов.1412блокировать определённые типы промптов.

1414 1413

1415Хуки `UserPromptSubmit` срабатывают не только на промпты, которые вы вводите. Claude Code также запускает их, когда:1414Хуки `UserPromptSubmit` срабатывают не только на промпты, которые вы вводите. Claude Code также запускает их, когда:

1416 1415

1417* срабатывает [запланированная задача](/docs/ru/scheduled-tasks), включая итерацию `/loop`1416* срабатывает [запланированная задача](/docs/ru/scheduled-tasks), включая итерацию `/loop`

1418* [фоновый субагент](/docs/ru/sub-agents#run-subagents-in-foreground-or-background) отчитывается сессии, которая его запустила1417* [фоновый субагент](/docs/ru/sub-agents#run-subagents-in-foreground-or-background) отчитывается перед сессией, которая его запустила

1419* [другая сессия отправляет сообщение](/docs/ru/cross-session-messaging) в ваш основной диалог1418* [другая сессия отправляет сообщение](/docs/ru/cross-session-messaging) в ваш основной диалог

1420 1419

1421У хуков `UserPromptSubmit` таймаут по умолчанию составляет 30 секунд для типов `command`, `http` и `mcp_tool` — меньше, чем 600 секунд по умолчанию для этих типов в большинстве других событий. Поскольку этот хук выполняется перед каждым промптом и блокирует обработку моделью до своего завершения, зависший хук останавливает сессию. Если вашему хуку нужно больше времени, задайте поле `timeout` в записи хука.1420Хуки `UserPromptSubmit` имеют таймаут по умолчанию 30 секунд для типов `command`, `http` и `mcp_tool` — меньше, чем стандартные 600 секунд для этих типов в большинстве других событий. Поскольку этот хук выполняется перед каждым промптом и блокирует обработку моделью до своего завершения, зависший хук останавливает сессию. Если вашему хуку нужно больше времени, задайте поле `timeout` в записи хука.

1422 1421

1423За исключением command-хука, запущенного с [`async: true`](#run-hooks-in-the-background), command-, HTTP- или MCP-хук `UserPromptSubmit`, достигший таймаута, отменяется, а его вывод, включая любой `additionalContext`, отбрасывается. Промпт всё равно доходит до Claude, но без этого контекста. В транскрипте отображается уведомление с именем хука, сработавшим таймаутом и указанием на то, что вывод был отброшен.1422За исключением командного хука, который вы запускаете с [`async: true`](#run-hooks-in-the-background), хук `UserPromptSubmit` типа command, HTTP или MCP tool, достигший таймаута, отменяется, а его вывод, включая `additionalContext`, отбрасывается. Промпт всё равно доходит до Claude, но без этого контекста. В транскрипте отображается уведомление с именем хука, сработавшим таймаутом и сообщением о том, что вывод был отброшен.

1424 1423

1425[Callback-хук Agent SDK](/docs/ru/agent-sdk/hooks) на `UserPromptSubmit`, достигший таймаута, блокирует промпт с сообщением, в котором указаны хук и таймаут, поскольку callback в этом месте может выступать шлюзом политики, который не должен при сбое пропускать запросы. Сессия продолжается. До v2.1.208 таймаут callback для этого события завершал ход с ошибкой выполнения.1424[Хук обратного вызова Agent SDK](/docs/ru/agent-sdk/hooks) для `UserPromptSubmit`, достигший таймаута, блокирует промпт с сообщением, в котором названы хук и таймаут, поскольку обратный вызов в этом месте может выступать в роли шлюза политики, который не должен при сбое пропускать всё подряд. Сессия продолжается. До версии v2.1.208 таймаут обратного вызова для этого события завершал ход с ошибкой выполнения.

1426 1425

1427<h4 id="userpromptsubmit-input">1426<h4 id="userpromptsubmit-input">

1428 Входные данные UserPromptSubmit1427 Входные данные UserPromptSubmit

1429</h4>1428</h4>

1430 1429

1431Помимо [общих входных полей](#common-input-fields), хуки UserPromptSubmit получают поле `prompt`, содержащее отправленный текст. Вставленное содержимое, свёрнутое в заглушку `[Pasted text #N]`, приходит развёрнутым на своём месте. В сессиях, где Claude Code [помечает вставленный текст для Claude](/docs/ru/terminal-config#how-claude-treats-pasted-text), это развёрнутое содержимое находится между строкой `<pasted_content id="…">` и строкой `</pasted_content id="…">`, поэтому учитывайте эти строки, если ваш хук разбирает промпт.1430Помимо [общих входных полей](#common-input-fields), хуки UserPromptSubmit получают поле `prompt`, содержащее отправленный текст. Вставленное содержимое, свёрнутое в заполнитель `[Pasted text #N]`, поступает развёрнутым на своём месте. В сессиях, где Claude Code [помечает вставленный текст для Claude](/docs/ru/terminal-config#how-claude-treats-pasted-text), это развёрнутое содержимое находится между строкой `<pasted_content id="…">` и строкой `</pasted_content id="…">`, поэтому учитывайте эти строки, если ваш хук разбирает промпт.

1432 1431

1433Хуки UserPromptSubmit также получают `session_title`, когда у сессии есть пользовательское название, с тем же значением, что и [поле `session_title` в SessionStart](#sessionstart-input).1432Хуки UserPromptSubmit также получают `session_title`, когда у сессии есть пользовательское название, с тем же значением, что и у [поля `session_title` в SessionStart](#sessionstart-input).

1434 1433

1435```json theme={null}1434```json theme={null}

1436{1435{

1447 Управление решениями UserPromptSubmit1446 Управление решениями UserPromptSubmit

1448</h4>1447</h4>

1449 1448

1450Хуки `UserPromptSubmit` могут управлять тем, обрабатывается ли отправленный промпт, и добавлять контекст. Доступны все [поля вывода JSON](#json-output).1449Хуки `UserPromptSubmit` могут управлять тем, будет ли обработан отправленный промпт, и добавлять контекст. Доступны все [поля вывода JSON](#json-output).

1451 1450

1452Есть два способа добавить контекст в диалог при коде выхода 0:1451Есть два способа добавить контекст в диалог при коде выхода 0:

1453 1452

1454* **stdout в виде обычного текста**: Claude Code добавляет в контекст Claude stdout, который он [обрабатывает как обычный текст](#exit-code-0)1453* **Обычный текст в stdout**: Claude Code добавляет в контекст Claude stdout, который он [обрабатывает как обычный текст](#exit-code-0)

1455* **JSON с `additionalContext`**: используйте формат JSON ниже для большего контроля. Поле `additionalContext` добавляется как контекст1454* **JSON с `additionalContext`**: используйте формат JSON ниже для более тонкого управления. Поле `additionalContext` добавляется как контекст

1456 1455

1457Ни один из каналов не создаёт видимой записи в транскрипте. Обычный stdout и значение `additionalContext` внедряются каждое как системное напоминание, начинающееся с имени хука; Claude читает оба. Чтобы подтвердить доставку, проверьте [отладочный лог](#debug-hooks).1456Ни один из каналов не создаёт видимой записи в транскрипте. Обычный stdout и значение `additionalContext` внедряются каждый как системное напоминание, начинающееся с имени хука; Claude читает оба. Чтобы убедиться в доставке, проверьте [лог отладки](#debug-hooks).

1458 1457

1459Чтобы заблокировать промпт, верните объект JSON с `decision`, равным `"block"`:1458Чтобы заблокировать промпт, верните объект JSON с `decision`, равным `"block"`:

1460 1459

1461| Поле | Описание |1460| Поле | Описание |

1462| :- | :- |1461| :- | :- |

1463| `decision` | `"block"` останавливает промпт до того, как он дойдёт до Claude. Не указывайте, чтобы разрешить промпту пройти |1462| `decision` | `"block"` останавливает промпт до того, как он дойдёт до Claude. Не указывайте, чтобы разрешить обработку промпта |

1465| `additionalContext` | Строка, добавляемая в контекст Claude вместе с отправленным промптом. См. [Добавление контекста для Claude](#add-context-for-claude) |1464| `additionalContext` | Строка, добавляемая в контекст Claude вместе с отправленным промптом. См. [Добавление контекста для Claude](#add-context-for-claude) |

1466| `sessionTitle` | Задаёт название сессии. Используйте для автоматического именования сессий на основе содержимого промпта |1465| `sessionTitle` | Задаёт название сессии. Используйте, чтобы автоматически именовать сессии на основе содержимого промпта |

1467| `suppressOriginalPrompt` | Если `true`, когда хук блокирует промпт, текст промпта не включается в сообщение о блокировке. См. [Что остаётся после заблокированного промпта](#what-a-blocked-prompt-leaves-behind) |1466| `suppressOriginalPrompt` | Если `true` и хук блокирует промпт, текст промпта не включается в сообщение о блокировке. См. [Что остаётся после заблокированного промпта](#what-a-blocked-prompt-leaves-behind) |

1468 1467

1469Хук, блокирующий с кодом выхода 2, обрабатывается так же, как `reason`: сообщение о блокировке показывает пользователю текст из stderr, и он не добавляется в контекст.1468Хук, который блокирует, завершаясь с кодом 2, обрабатывается так же, как `reason`: сообщение о блокировке показывает пользователю текст из stderr, и он не добавляется в контекст.

1470 1469

1471```json theme={null}1470```json theme={null}

1472{1471{

1485 Что остаётся после заблокированного промпта1484 Что остаётся после заблокированного промпта

1486</h4>1485</h4>

1487 1486

1488Заблокированный промпт никогда не доходит до Claude, но его текст удаляется не везде. По умолчанию сообщение о блокировке, показываемое пользователю, заканчивается строкой `Original prompt:`, за которой следует отправленный текст, и Claude Code записывает это сообщение в файл транскрипта сессии на диске. Чтобы исключить текст из сообщения, выведите JSON с `"suppressOriginalPrompt": true` внутри `hookSpecificOutput`. Это работает независимо от того, блокирует ли хук через `decision: "block"` или завершаясь с кодом 2.1487Заблокированный промпт никогда не доходит до Claude, но его текст удаляется не отовсюду. По умолчанию сообщение о блокировке, показываемое пользователю, заканчивается строкой `Original prompt:`, за которой следует отправленный текст, и Claude Code записывает это сообщение в файл транскрипта сессии на диске. Чтобы исключить текст из сообщения, выведите JSON с `"suppressOriginalPrompt": true` внутри `hookSpecificOutput`. Это работает независимо от того, блокирует ли хук через `decision: "block"` или завершением с кодом 2.

1489 1488

1490`suppressOriginalPrompt` изменяет только сообщение о блокировке. Отправленный текст всё равно может появиться в локальных файлах, таких как транскрипт сессии и история промптов, поэтому блокирующий хук не является способом не допустить попадания секрета на диск. Чтобы ограничить или удалить эти файлы, см. [Хранение в открытом виде](/docs/ru/claude-directory#plaintext-storage) и [Очистка локальных данных](/docs/ru/claude-directory#clear-local-data).1489`suppressOriginalPrompt` изменяет только сообщение о блокировке. Отправленный текст всё равно может оказаться в локальных файлах, таких как транскрипт сессии и история промптов, поэтому блокирующий хук — не способ уберечь секрет от записи на диск. Чтобы ограничить или удалить эти файлы, см. [Хранение в открытом виде](/docs/ru/claude-directory#plaintext-storage) и [Очистка локальных данных](/docs/ru/claude-directory#clear-local-data).

1491 1490

1492<h3 id="userpromptexpansion">1491<h3 id="userpromptexpansion">

1493 UserPromptExpansion1492 UserPromptExpansion

1494</h3>1493</h3>

1495 1494

1496Выполняется, когда введённая пользователем команда разворачивается в промпт до того, как дойти до Claude. Используйте его, чтобы запретить прямой вызов определённых команд, внедрить контекст для конкретного скилла или логировать, какие команды вызывают пользователи. Например, хук с matcher `deploy` может блокировать `/deploy`, если нет файла подтверждения, а хук, соответствующий скиллу ревью, может добавлять чек-лист ревью команды как `additionalContext`.1495Выполняется, когда введённая пользователем команда разворачивается в промпт до того, как дойти до Claude. Используйте его, чтобы блокировать прямой вызов определённых команд, внедрять контекст для конкретного скилла или логировать, какие команды вызывают пользователи. Например, хук с matcher `deploy` может блокировать `/deploy`, если нет файла одобрения, а хук с matcher для скилла ревью может добавлять чек-лист ревью команды в качестве `additionalContext`.

1497 1496

1498Это событие покрывает путь, который не покрывает `PreToolUse`: хук `PreToolUse`, соответствующий инструменту `Skill`, срабатывает только когда Claude вызывает этот инструмент, но прямой ввод `/skillname` обходит `PreToolUse`. `UserPromptExpansion` срабатывает на этом прямом пути.1497Это событие покрывает путь, который не покрывает `PreToolUse`: хук `PreToolUse`, сопоставленный с инструментом `Skill`, срабатывает только когда Claude вызывает инструмент, а прямой ввод `/skillname` обходит `PreToolUse`. `UserPromptExpansion` срабатывает на этом прямом пути.

1499 1498

1500Сопоставляется по `command_name`. Оставьте matcher пустым, чтобы срабатывать для каждой команды, разворачивающейся в промпт.1499Сопоставляется с `command_name`. Оставьте matcher пустым, чтобы срабатывать на каждую команду промптового типа.

1501 1500

1502<h4 id="userpromptexpansion-input">1501<h4 id="userpromptexpansion-input">

1503 Входные данные UserPromptExpansion1502 Входные данные UserPromptExpansion

1524 Управление решениями UserPromptExpansion1523 Управление решениями UserPromptExpansion

1525</h4>1524</h4>

1526 1525

1527Хуки `UserPromptExpansion` могут блокировать развёртывание или добавлять контекст. Доступны все [поля вывода JSON](#json-output).1526Хуки `UserPromptExpansion` могут блокировать разворачивание или добавлять контекст. Доступны все [поля вывода JSON](#json-output).

1528 1527

1529| Поле | Описание |1528| Поле | Описание |

1530| :- | :- |1529| :- | :- |

1533| `additionalContext` | Строка, добавляемая в контекст Claude вместе с развёрнутым промптом. См. [Добавление контекста для Claude](#add-context-for-claude) |1532| `additionalContext` | Строка, добавляемая в контекст Claude вместе с развёрнутым промптом. См. [Добавление контекста для Claude](#add-context-for-claude) |

1534 1533

1535Хук, блокирующий с кодом выхода 2, обрабатывается так же, как `reason`: сообщение о блокировке показывает пользователю текст из stderr.1534Хук, который блокирует, завершаясь с кодом 2, обрабатывается так же, как `reason`: сообщение о блокировке показывает пользователю текст из stderr.

1536 1535

1537```json theme={null}1536```json theme={null}

1538{1537{

1549 MessageDisplay1548 MessageDisplay

1550</h3>1549</h3>

1551 1550

1552Выполняется, пока сообщение ассистента потоково выводится на экран. Claude Code отображает сообщение частями: каждый раз, когда пакет только что завершённых строк готов к отрисовке, хук выполняется один раз с этими строками, и Claude Code отображает на их месте текст-замену, возвращённый хуком. Длинное сообщение порождает несколько вызовов; короткое может породить только один.1551Выполняется во время потокового вывода сообщения ассистента на экран. Claude Code отображает сообщение порциями: каждый раз, когда пакет новых завершённых строк готов к отрисовке, хук выполняется один раз с этими строками, и Claude Code отрисовывает на их месте текст замены, возвращённый хуком. Длинное сообщение порождает несколько вызовов; короткое может породить только один.

1553 1552

1554Используйте MessageDisplay, чтобы:1553Используйте MessageDisplay, чтобы:

1555 1554

1559 1558

1560Claude Code удерживает каждый пакет, пока ваш хук не вернёт результат, поэтому хук должен работать быстро. Если хук завершается ошибкой или по таймауту, Claude Code отображает исходный текст. Таймаут по умолчанию для этого события — 10 секунд; если вашему хуку нужно больше времени, задайте поле `timeout` в записи хука.1559Claude Code удерживает каждый пакет, пока ваш хук не вернёт результат, поэтому хук должен работать быстро. Если хук завершается ошибкой или по таймауту, Claude Code отображает исходный текст. Таймаут по умолчанию для этого события — 10 секунд; если вашему хуку нужно больше времени, задайте поле `timeout` в записи хука.

1561 1560

1562MessageDisplay влияет только на отображение: текст-замена меняет лишь то, что выводится на экран. Транскрипт и то, что видит Claude, сохраняют исходный текст, поэтому Claude никогда не видит замену, а подробный режим показывает оригинал. Хук получает только текст сообщений ассистента, поэтому результаты инструментов и вводимый вами текст отображаются без изменений.1561MessageDisplay влияет только на отображение: текст замены изменяет лишь то, что отрисовывается на экране. Транскрипт и то, что видит Claude, сохраняют исходный текст, поэтому Claude никогда не видит замену, а подробный режим показывает исходный текст. Хук получает только текст сообщений ассистента, поэтому результаты инструментов и вводимый вами текст отображаются без изменений.

1563 1562

1564MessageDisplay не поддерживает matcher и срабатывает для каждого сообщения ассистента, выводящего текст потоком; сообщения без текста, например ответы, содержащие только вызовы инструментов, его не вызывают.1563MessageDisplay не поддерживает matcher и срабатывает для каждого сообщения ассистента, которое выводит текст потоком; сообщения без текста, например ответы, состоящие только из вызовов инструментов, его не вызывают.

1565 1564

1566В неинтерактивных запусках, включая запросы Agent SDK и `claude -p`, MessageDisplay выполняется один раз на сообщение ассистента, а не один раз на пакет строк. Единственный вызов приходит после завершения сообщения и содержит полный текст сообщения: `index` равно `0`, `final` равно `true`, а `delta` содержит всё сообщение. Хук, собирающий текст `delta` для каждого сообщения, получает одинаковый итоговый текст в обоих режимах.1565В неинтерактивных запусках, включая запросы Agent SDK и `claude -p`, MessageDisplay выполняется один раз на сообщение ассистента, а не один раз на пакет строк. Единственный вызов приходит после завершения сообщения и содержит полный текст сообщения: `index` равен `0`, `final` равен `true`, а `delta` содержит всё сообщение. Хук, собирающий текст `delta` для каждого сообщения, получает один и тот же общий текст в обоих режимах.

1567 1566

1568<h4 id="messagedisplay-input">1567<h4 id="messagedisplay-input">

1569 Входные данные MessageDisplay1568 Входные данные MessageDisplay

1570</h4>1569</h4>

1571 1570

1572Помимо [общих входных полей](#common-input-fields), хуки MessageDisplay получают идентификаторы хода и сообщения, позицию этого вызова в сообщении и новый текст в `delta`. Границы пакетов зависят от того, как текст поступает потоком, поэтому используйте `index` и `final` для отслеживания прогресса по сообщению, а не рассчитывайте на определённую группировку строк.1571Помимо [общих входных полей](#common-input-fields), хуки MessageDisplay получают идентификаторы хода и сообщения, позицию этого вызова внутри сообщения и новый текст в `delta`. Границы пакетов зависят от того, как поступает поток текста, поэтому используйте `index` и `final` для отслеживания продвижения по сообщению, а не рассчитывайте на определённую группировку строк.

1573 1572

1574| Поле | Описание |1573| Поле | Описание |

1575| :- | :- |1574| :- | :- |

1577| `message_id` | UUID отображаемого сообщения ассистента. Неизменен во всех пакетах одного сообщения. Это не идентификатор API `msg_…`, поэтому его нельзя сопоставить с идентификаторами сообщений в транскрипте |1576| `message_id` | UUID отображаемого сообщения ассистента. Одинаков для всех пакетов одного сообщения. Это не идентификатор API `msg_…`, поэтому его нельзя сопоставить с идентификаторами сообщений в транскрипте |

1580| `delta` | Строки, завершённые после предыдущего пакета, включая завершающие символы новой строки. Всегда целые строки, кроме последнего пакета, который может закончиться посреди строки. В интерактивных запусках delta последнего пакета пуста, если сообщение заканчивается символом новой строки, поэтому считайте сигналом конца сообщения `final`, а не непустую delta. В запусках Agent SDK и `claude -p` единственный вызов содержит всё сообщение |1579| `delta` | Новые завершённые строки с момента предыдущего пакета, включая завершающие символы новой строки. Всегда целые строки, кроме финального пакета, который может заканчиваться посреди строки. В интерактивных запусках delta финального пакета пуста, если сообщение заканчивается символом новой строки, поэтому считайте сигналом конца сообщения `final`, а не непустую delta. В запусках Agent SDK и `claude -p` единственный вызов содержит всё сообщение |

1581 1580

1582```json theme={null}1581```json theme={null}

1583{1582{

1601 1600

1602| Поле | Описание |1601| Поле | Описание |

1603| :- | :- |1602| :- | :- |

1605 1604

1606У хуков MessageDisplay нет управления решениями. Они не могут блокировать сообщение или изменять то, что сохраняется в транскрипте или отправляется Claude. Claude Code учитывает `displayContent` из их вывода JSON и отбрасывает `systemMessage` и `continue`.1605Хуки MessageDisplay не имеют управления решениями. Они не могут заблокировать сообщение или изменить то, что хранится в транскрипте или отправляется Claude. Claude Code использует `displayContent` из их вывода JSON и отбрасывает `systemMessage` и `continue`.

1607 1606

1608В этом примере из ответов Claude удаляется форматирование markdown для отображения в виде обычного текста. Скрипт читает каждый пакет из stdin, удаляет маркеры жирного шрифта и обратные кавычки встроенного кода из `delta` и возвращает результат как `displayContent`.1607Этот пример удаляет форматирование markdown из ответов Claude для отображения обычным текстом. Скрипт читает каждый пакет из stdin, удаляет из `delta` маркеры полужирного начертания и обратные кавычки встроенного кода и возвращает результат в виде `displayContent`.

1609 1608

1610<Tabs>1609<Tabs>

1611 <Tab title="macOS/Linux">1610 <Tab title="macOS/Linux">

1612 Зарегистрируйте command-хук для события в файле настроек:1611 Зарегистрируйте командный хук для события в файле настроек:

1613 1612

1614 ```json theme={null}1613 ```json theme={null}

1615 {1614 {

1638 </Tab>1637 </Tab>

1639 1638

1640 <Tab title="Windows (PowerShell)">1639 <Tab title="Windows (PowerShell)">

1641 Зарегистрируйте command-хук, который запускает скрипт через PowerShell:1640 Зарегистрируйте командный хук, который запускает скрипт через PowerShell:

1642 1641

1643 ```json theme={null}1642 ```json theme={null}

1644 {1643 {

1681 </Tab>1680 </Tab>

1682</Tabs>1681</Tabs>

1683 1682

1684Пакеты без markdown проходят без изменений. Если скрипт завершается ошибкой, например из-за отсутствия `jq`, Claude Code отображает исходный текст и отмечает сбой только в [отладочном выводе](#debug-hooks), а не в сессии.1683Пакеты без разметки markdown проходят без изменений. Если скрипт завершается ошибкой, например из-за отсутствия `jq`, Claude Code отображает исходный текст и отмечает сбой только в [отладочном выводе](#debug-hooks), а не в сессии.

1685 1684

1686<h3 id="pretooluse">1685<h3 id="pretooluse">

1687 PreToolUse1686 PreToolUse

1688</h3>1687</h3>

1689 1688

1690Выполняется после того, как Claude создаёт параметры инструмента, и до обработки вызова инструмента. Сопоставляется с любым именем инструмента, кроме `EndConversation`: встроенными инструментами, такими как `Bash`, `PowerShell`, `Edit`, `Write`, `Read`, `Glob`, `Grep`, `Agent`, `Workflow`, `WebFetch`, `WebSearch`, `AskUserQuestion` и `ExitPlanMode`, а также любыми [именами MCP-инструментов](#match-mcp-tools).1689Выполняется после того, как Claude сформирует параметры инструмента, и до обработки вызова инструмента. Сопоставляется с любым именем инструмента, кроме `EndConversation`: со встроенными инструментами, такими как `Bash`, `PowerShell`, `Edit`, `Write`, `Read`, `Glob`, `Grep`, `Agent`, `Workflow`, `WebFetch`, `WebSearch`, `AskUserQuestion` и `ExitPlanMode`, а также с любыми [именами инструментов MCP](#match-mcp-tools).

1691 1690

1692Чтобы запускать хук при изменении определённого файла на диске, кто бы его ни записал, используйте [FileChanged](#filechanged) вместо сопоставления инструментов редактирования файлов по имени. В отличие от PreToolUse, Claude Code запускает хуки FileChanged после изменения, и у них нет управления решениями, поэтому они не могут блокировать запись.1691Чтобы запускать хук при изменении конкретного файла на диске, независимо от того, что его записало, используйте [FileChanged](#filechanged) вместо сопоставления инструментов редактирования файлов по имени. В отличие от PreToolUse, Claude Code запускает хуки FileChanged после изменения, и у них нет управления решениями, поэтому они не могут заблокировать запись.

1693 1692

1694<Warning>1693<Warning>

1695 PreToolUse выполняется только когда Claude вызывает инструмент. Файлы, на которые вы [ссылаетесь через `@` в промпте](/docs/ru/common-workflows#reference-files-and-directories), добавляются без какого-либо вызова инструмента: Claude Code вставляет их содержимое при построении промпта, поэтому для них не срабатывает ни один хук PreToolUse, включая хуки, соответствующие `Read`. Чтобы заблокировать определённые пути для ссылок через `@`, используйте вместо этого [правило запрета `Read`](/docs/ru/permissions#read-and-edit).1694 PreToolUse выполняется только когда Claude вызывает инструмент. Файлы, на которые вы [ссылаетесь с помощью `@` в промпте](/docs/ru/common-workflows#reference-files-and-directories), добавляются без вызова инструмента: Claude Code вставляет их содержимое при формировании промпта, поэтому для них не срабатывает ни один хук PreToolUse, включая хуки с matcher `Read`. Чтобы запретить определённые пути в ссылках `@`, используйте вместо этого [правило запрета `Read`](/docs/ru/permissions#read-and-edit).

1696 1695

1697 PreToolUse также не срабатывает для [`EndConversation`](/docs/ru/tools-reference#endconversation-tool-behavior).1696 PreToolUse также не срабатывает для [`EndConversation`](/docs/ru/tools-reference#endconversation-tool-behavior).

1698</Warning>1697</Warning>

1699 1698

1700Используйте [управление решениями PreToolUse](#pretooluse-decision-control), чтобы разрешить, запретить, запросить подтверждение или отложить вызов инструмента.1699Используйте [управление решениями PreToolUse](#pretooluse-decision-control), чтобы разрешить, запретить, запросить подтверждение или отложить вызов инструмента.

1701 1700

1702[Callback-хук Agent SDK](/docs/ru/agent-sdk/hooks) на `PreToolUse`, превысивший таймаут, блокирует вызов инструмента, и Claude получает результат с ошибкой, указывающей на таймаут. Явный запрет, возвращённый другим хуком, по-прежнему имеет приоритет.1701[Хук обратного вызова Agent SDK](/docs/ru/agent-sdk/hooks) для `PreToolUse`, превысивший свой таймаут, блокирует вызов инструмента, и Claude получает результат с ошибкой, в котором указан таймаут. Явный запрет, возвращённый другим хуком, по-прежнему имеет приоритет.

1703 1702

1704<h4 id="pretooluse-input">1703<h4 id="pretooluse-input">

1705 Входные данные PreToolUse1704 Входные данные PreToolUse

1707 1706

1708Помимо [общих входных полей](#common-input-fields), хуки PreToolUse получают `tool_name`, `tool_input` и `tool_use_id`.1707Помимо [общих входных полей](#common-input-fields), хуки PreToolUse получают `tool_name`, `tool_input` и `tool_use_id`.

1709 1708

1710Для [MCP-инструмента](#match-mcp-tools) входные данные также содержат `mcp_server` — объект с `name` сервера и `source`, указывающим, откуда взято определение сервера. Значения `source` включают `plugin`, `sdk` и области действия конфигурации, такие как `user` и `project`. [`McpServerProvenance`](/docs/ru/agent-sdk/typescript#mcpserverprovenance) в справочнике Agent SDK перечисляет их все и описывает, как обрабатывать незнакомое значение. Принимайте решения о доверии на основе `source`, а не `name` или префикса имени инструмента `mcp__<server>__`. Для поля `mcp_server` требуется Claude Code v2.1.274 или новее.1709Для [инструмента MCP](#match-mcp-tools) входные данные также содержат `mcp_server` — объект с `name` сервера и полем `source`, указывающим, откуда взято определение сервера. Значения `source` включают `plugin`, `sdk` и области действия конфигурации, такие как `user` и `project`. В [`McpServerProvenance`](/docs/ru/agent-sdk/typescript#mcpserverprovenance) в справочнике Agent SDK перечислены все значения и указано, как обращаться с незнакомым значением. Принимайте решения о доверии на основе `source`, а не `name` или префикса имени инструмента `mcp__<server>__`. Для поля `mcp_server` требуется Claude Code v2.1.274 или новее.

1711 1710

1712Для файловых инструментов `Write`, `Edit` и `Read` значение `tool_input.file_path` всегда абсолютное:1711Для файловых инструментов `Write`, `Edit` и `Read` значение `tool_input.file_path` всегда абсолютное:

1713 1712

1714* Claude Code раскрывает `~` и относительные пути до запуска хуков, поэтому хук, сопоставляющий пути, нельзя обойти через `~` или относительную запись того же пути1713* Claude Code разворачивает `~` и относительные пути до запуска хуков, поэтому хук, сопоставляющий пути, нельзя обойти через `~` или относительное написание того же пути

1715* В Windows путь приходит с разделителями-обратными слешами, даже если ваш хук работает в Git Bash, где `$PWD` выглядит как `/c/project`1714* В Windows путь приходит с разделителями-обратными слешами, даже если ваш хук выполняется в Git Bash, где `$PWD` выглядит как `/c/project`

1716* Сравнение, записанное с прямыми слешами, например проверка `/src/`, никогда не совпадёт с путём с обратными слешами, и вызов инструмента пройдёт так, будто хуку нечего блокировать1715* Сравнение, записанное с прямыми слешами, например проверка `/src/`, никогда не совпадёт с путём с обратными слешами, и вызов инструмента продолжится так, будто хуку нечего было блокировать

1717* Нормализуйте разделители перед сравнением: `FILE_PATH="${FILE_PATH//\\//}"` в Bash или `file_path.replace("\\", "/")` в Python, а затем сопоставляйте сегмент пути, например `/src/`, а не привязывайтесь к началу через `^`, поскольку путь абсолютный1716* Нормализуйте разделители перед сравнением: `FILE_PATH="${FILE_PATH//\\//}"` в Bash или `file_path.replace("\\", "/")` в Python, а затем сопоставляйте сегмент пути, например `/src/`, а не привязывайтесь к началу через `^`, поскольку путь абсолютный

1718 1717

1719Вызов `Write` в Windows передаёт:1718Вызов `Write` в Windows передаёт:

1749 1748

1750Когда команда Bash изменяет файлы в репозитории Git, Claude Code может записывать, что изменилось. Изменения записываются во всех режимах разрешений, когда настройка [`bashEditDiffEnabled`](/docs/ru/settings-reference#basheditdiffenabled) включает запись; в описании этой настройки указано, в каких файлах её можно задать. В противном случае изменения записываются только в авторежиме и режиме `bypassPermissions`, и только когда Claude Code поручает Claude редактировать файлы через Bash. Установите `bashEditDiffEnabled` в `false`, чтобы отключить запись. Фоновые команды и команды только для чтения не содержат diff.1749Когда команда Bash изменяет файлы в репозитории Git, Claude Code может записывать, что изменилось. Он записывает изменения во всех режимах разрешений, если запись включена настройкой [`bashEditDiffEnabled`](/docs/ru/settings-reference#basheditdiffenabled); в описании этой настройки указано, какие файлы могут её задавать. В противном случае он записывает их только в авторежиме и режиме `bypassPermissions`, и только когда Claude Code направляет Claude редактировать файлы через Bash. Задайте `bashEditDiffEnabled` значение `false`, чтобы отключить запись. Фоновые команды и команды только для чтения не содержат diff.

1751 1750

1752Затем ваш [хук PostToolUse](#posttooluse) получает изменённые файлы в `tool_response.bashEditDiff`. Список охватывает то, что изменилось в репозитории за время выполнения команды. Файлы, которые Git игнорирует, и файлы в подмодулях не включаются. Требуется Claude Code v2.1.269 или новее.1751Затем ваш [хук PostToolUse](#posttooluse) получает изменённые файлы в `tool_response.bashEditDiff`. Список охватывает то, что изменилось в репозитории во время выполнения команды. Файлы, игнорируемые Git, и файлы в подмодулях не перечисляются. Требуется Claude Code v2.1.269 или новее.

1753 1752

1754<Note>1753<Note>

1755 Список формируется по принципу «насколько возможно» и доступен в публичной бета-версии. Claude Code может пропустить изменение, включить файл, который одновременно изменил другой процесс, или остановиться на своих ограничениях размера. Структура поля может измениться. Используйте список, чтобы найти, что проверить, а не для применения политики.1754 Список формируется по возможности и находится в стадии публичной беты. Claude Code может пропустить изменение, включить файл, который одновременно изменил другой процесс, или остановиться на своих ограничениях размера. Структура поля может измениться. Используйте список, чтобы найти, что нужно проверить, а не для применения политики.

1756</Note>1755</Note>

1757 1756

1758`changedFiles` и `files` перечисляют, что изменила команда; остальные поля показывают, насколько этот список полон и надёжен.1757`changedFiles` и `files` перечисляют, что изменила команда; остальные поля сообщают, насколько полон и надёжен этот список.

1759 1758

1760| Поле | Тип | Пример | Описание |1759| Поле | Тип | Пример | Описание |

1761| :- | :- | :- | :- |1760| :- | :- | :- | :- |

1763| `files` | array | `[{"filePath": "/path/to/src/app.ts", "hunks": [...]}]` | Diff до 5 изменённых файлов для отображения. `created` или `deleted` равно `true` для файла, который команда добавила или удалила |1762| `files` | array | `[{"filePath": "/path/to/src/app.ts", "hunks": [...]}]` | Diff не более 5 изменённых файлов, для отображения. `created` или `deleted` равно `true` для файла, который команда добавила или удалила |

1767| `shared` | boolean | `true` | Устанавливается, когда другой вызов инструмента Bash, например субагента, выполнялся в том же репозитории в то же время, поэтому некоторые перечисленные изменения могут принадлежать той команде |1766| `shared` | boolean | `true` | Задаётся, когда другой вызов инструмента Bash, например вызов субагента, выполнялся в том же репозитории в то же время, поэтому некоторые перечисленные изменения могут относиться к той команде |

1768 1767

1769<a id="powershell" />1768<a id="powershell" />

1770 1769

1772 PowerShell1771 PowerShell

1773</h5>1772</h5>

1774 1773

1775Выполняет команды PowerShell. Доступность по платформам см. в разделе об [инструменте PowerShell](/docs/ru/tools-reference#powershell-tool).1774Выполняет команды PowerShell. Доступность по платформам см. в описании [инструмента PowerShell](/docs/ru/tools-reference#powershell-tool).

1776 1775

1777Поля совпадают с инструментом Bash, строка команды — в `command`:1776Поля совпадают с инструментом Bash, строка команды находится в `command`:

1778 1777

1779| Поле | Тип | Пример | Описание |1778| Поле | Тип | Пример | Описание |

1780| :- | :- | :- | :- |1779| :- | :- | :- | :- |

1785 1784

1786В хуках, проверяющих shell-команды, используйте matcher `Bash|PowerShell`, чтобы охватить оба инструмента:1785В хуках, которые проверяют shell-команды, используйте matcher `Bash|PowerShell`, чтобы охватить оба инструмента:

1787 1786

1788* В Windows, где бы ни был включён инструмент PowerShell, Claude считает PowerShell основной оболочкой и направляет через неё shell-команды.1787* В Windows везде, где включён инструмент PowerShell, Claude считает PowerShell основной оболочкой и направляет shell-команды через неё.

1789* В Windows без Git Bash инструмент включается автоматически, а Claude Code вообще не регистрирует инструмент Bash.1788* В Windows без Git Bash инструмент включается автоматически, и Claude Code вообще не регистрирует инструмент Bash.

1790* Хук, соответствующий только `Bash`, там никогда не срабатывает.1789* Хук, сопоставленный только с `Bash`, там никогда не сработает.

1791 1790

1792<h5 id="write">1791<h5 id="write">

1793 Write1792 Write

1822| Поле | Тип | Пример | Описание |1821| Поле | Тип | Пример | Описание |

1823| :- | :- | :- | :- |1822| :- | :- | :- | :- |

1827 1826

1828<h5 id="glob">1827<h5 id="glob">

1855 WebFetch1854 WebFetch

1856</h5>1855</h5>

1857 1856

1858Загружает и обрабатывает веб-контент.1857Загружает и обрабатывает веб-содержимое.

1859 1858

1860| Поле | Тип | Пример | Описание |1859| Поле | Тип | Пример | Описание |

1861| :- | :- | :- | :- |1860| :- | :- | :- | :- |

1864 1863

1865<h5 id="websearch">1864<h5 id="websearch">

1866 WebSearch1865 WebSearch

1871| Поле | Тип | Пример | Описание |1870| Поле | Тип | Пример | Описание |

1872| :- | :- | :- | :- |1871| :- | :- | :- | :- |

1876 1875

1877<h5 id="agent">1876<h5 id="agent">

1889 1888

1890Когда вызов Agent на переднем плане завершается, ваш [хук PostToolUse](#posttooluse) получает результат субагента и телеметрию запуска в `tool_response`. Читайте эти поля для анализа запуска; для сводных данных по токенам и стоимости по всем субагентам используйте [счётчики токенов и стоимости](/docs/ru/monitoring-usage#token-counter) с фильтром `query_source` `"subagent"`, поскольку `totalTokens` и `usage` охватывают только последний запрос:1889Когда вызов Agent на переднем плане завершается, ваш [хук PostToolUse](#posttooluse) получает результат субагента и телеметрию запуска в `tool_response`. Читайте эти поля, чтобы изучить запуск; для сводок по токенам и стоимости по всем субагентам используйте [счётчики токенов и стоимости](/docs/ru/monitoring-usage#token-counter) с фильтром `query_source` `"subagent"`, поскольку `totalTokens` и `usage` охватывают только последний запрос:

1891 1890

1892| Поле | Тип | Пример | Описание |1891| Поле | Тип | Пример | Описание |

1893| :- | :- | :- | :- |1892| :- | :- | :- | :- |

1894| `status` | string | `"completed"` | `"completed"` для субагентов на переднем плане, `"async_launched"` для фоновых субагентов. По умолчанию субагенты выполняются в фоне, поэтому вызов Agent без `run_in_background` также даёт `"async_launched"` |1893| `status` | string | `"completed"` | `"completed"` для субагентов на переднем плане, `"async_launched"` для фоновых субагентов. Субагенты по умолчанию выполняются в фоне, поэтому вызов Agent без `run_in_background` также даёт `"async_launched"` |

1896| `content` | array | `[{"type": "text", "text": "Found 12 endpoints..."}]` | Итоговые текстовые блоки субагента или, для субагента, чей отчёт передаётся через `SubagentHandback`, вместо них краткая заметка об этой передаче |1895| `content` | array | `[{"type": "text", "text": "Found 12 endpoints..."}]` | Финальные текстовые блоки субагента или, для субагента, чей отчёт передаётся через `SubagentHandback`, вместо них краткая заметка об этой передаче |

1898| `modelsUsed` | array | `["claude-sonnet-4-5", "claude-haiku-4-5"]` | Использованные модели по порядку, с объединением последовательных повторов; задаётся только если модель была заменена во время запуска. Требуется Claude Code v2.1.212 или новее |1897| `modelsUsed` | array | `["claude-sonnet-4-5", "claude-haiku-4-5"]` | Использованные модели по порядку, с объединением последовательных повторов; задаётся только когда модель сменилась во время запуска. Требуется Claude Code v2.1.212 или новее |

1902| `usage` | object | `{"input_tokens": 8320, ...}` | Разбивка токенов последнего запроса API по типам: `input_tokens`, `output_tokens`, `cache_creation_input_tokens`, `cache_read_input_tokens` |1901| `usage` | object | `{"input_tokens": 8320, ...}` | Разбивка токенов по типам для последнего запроса API: `input_tokens`, `output_tokens`, `cache_creation_input_tokens`, `cache_read_input_tokens` |

1903 1902

1904В Claude Code v2.1.271 или новее субагент, работающий с инструментом [`SubagentHandback`](/docs/ru/tools-reference), который Claude Code предоставляет в [авторежиме](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode), передаёт свой отчёт через этот инструмент, а не возвращает его текстом. Тогда поле `content` его результата `completed` содержит краткую заметку об этой передаче, а не сам отчёт. Чтобы прочитать отчёт, настройте хук `PreToolUse` или `PostToolUse` с matcher `SubagentHandback` и читайте `tool_input.message`.1903В Claude Code v2.1.271 или новее субагент, работающий с инструментом [`SubagentHandback`](/docs/ru/tools-reference), который Claude Code предоставляет в [авторежиме](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode), передаёт свой отчёт через этот инструмент, а не возвращает его текстом. Поле `content` его результата `completed` тогда содержит краткую заметку об этой передаче, а не сам отчёт. Чтобы прочитать отчёт, сопоставьте хук `PreToolUse` или `PostToolUse` с `SubagentHandback` и прочитайте `tool_input.message`.

1905 1904

1906Для фоновых субагентов инструмент возвращает результат, когда задача переходит в фон, поэтому `tool_response` не содержит полей использования: фоновый запуск возвращается сразу, а задача на переднем плане, которую Claude Code переводит в фон во время выполнения, возвращается в момент этого перехода. Ответ содержит `status: "async_launched"`, `agentId`, `description`, `prompt`, `outputFile` и `resolvedModel`.1905Для фоновых субагентов инструмент возвращает результат, когда задача переходит в фон, поэтому `tool_response` не содержит полей использования: фоновый запуск возвращается немедленно, а задача на переднем плане, которую Claude Code переводит в фон во время выполнения, возвращается в момент этого перехода. Он содержит `status: "async_launched"`, `agentId`, `description`, `prompt`, `outputFile` и `resolvedModel`.

1907 1906

1908В ответе `completed` поле `resolvedModel` указывает модель, с которой начал субагент; она может отличаться от значения `model` в `tool_input`, например когда применяется `availableModels` или другое переопределение. В ответе `async_launched` поле `resolvedModel` указывает модель, использовавшуюся в момент перехода агента в фон, поэтому замена, произошедшая до перевода в фон, в нём отражается. Для `modelsUsed` и поведения `resolvedModel` на момент перевода в фон требуется Claude Code v2.1.212 или новее.1907В ответе `completed` поле `resolvedModel` называет модель, на которой субагент начал работу; она может отличаться от значения `model` в `tool_input`, например когда применяется `availableModels` или другое переопределение. В ответе `async_launched` поле `resolvedModel` называет модель, использовавшуюся в момент перевода агента в фон, поэтому смена модели, произошедшая до перевода в фон, отражается там. Для `modelsUsed` и поведения `resolvedModel` на момент перевода в фон требуется Claude Code v2.1.212 или новее.

1909 1908

1910<a id="askuserquestion" />1909<a id="askuserquestion" />

1911 1910

1917 1916

1918| Поле | Тип | Пример | Описание |1917| Поле | Тип | Пример | Описание |

1919| :- | :- | :- | :- |1918| :- | :- | :- | :- |

1920| `questions` | array | `[{"question": "Which framework?", "header": "Framework", "options": [{"label": "React", "description": "Component library"}, {"label": "Vue", "description": "Progressive framework"}], "multiSelect": false}]` | Вопросы для показа, каждый со строкой `question`, коротким `header`, массивом `options` и необязательным флагом `multiSelect` |1919| `questions` | array | `[{"question": "Which framework?", "header": "Framework", "options": [{"label": "React", "description": "Component library"}, {"label": "Vue", "description": "Progressive framework"}], "multiSelect": false}]` | Вопросы для показа, каждый со строкой `question`, кратким `header`, массивом `options` и необязательным флагом `multiSelect` |

1921| `answers` | object | `{"Which framework?": "React"}` | Необязательно. Сопоставляет текст вопроса с меткой выбранного варианта. В ответах с множественным выбором метки объединяются через запятую. Claude не задаёт это поле; передайте его через `updatedInput`, чтобы ответить программно |1920| `answers` | object | `{"Which framework?": "React"}` | Необязательно. Сопоставляет текст вопроса с меткой выбранного варианта. В ответах с множественным выбором метки объединяются через запятые. Claude не задаёт это поле; передайте его через `updatedInput`, чтобы отвечать программно |

1922 1921

1923<h5 id="exitplanmode">1922<h5 id="exitplanmode">

1924 ExitPlanMode1923 ExitPlanMode

1930| :- | :- | :- | :- |1929| :- | :- | :- | :- |

1933| `allowedPrompts` | array | `[{"tool": "Bash", "prompt": "run tests"}]` | Устаревшее. Claude Code принимает поле, но игнорирует его. До v2.1.205 оно содержало разрешения на основе промптов, которые Claude запрашивал для реализации плана |1932| `allowedPrompts` | array | `[{"tool": "Bash", "prompt": "run tests"}]` | Устаревшее. Claude Code принимает это поле, но игнорирует его. До версии v2.1.205 оно содержало разрешения на основе промптов, которые Claude запрашивал для реализации плана |

1934 1933

1935В `PostToolUse` поле `tool_response` — это объект с полями `plan` и `filePath`, содержащими утверждённый план, а также внутренними флагами состояния. Читайте `tool_response.plan` для получения содержимого плана, а не перечитывайте файл с диска.1934В `PostToolUse` поле `tool_response` — это объект с полями `plan` и `filePath`, содержащими утверждённый план, а также внутренними флагами состояния. Читайте содержимое плана из `tool_response.plan`, а не перечитывайте файл с диска.

1936 1935

1937<h4 id="pretooluse-decision-control">1936<h4 id="pretooluse-decision-control">

1938 Управление решениями PreToolUse1937 Управление решениями PreToolUse

1939</h4>1938</h4>

1940 1939

1941Хуки `PreToolUse` могут управлять тем, выполняется ли вызов инструмента. В отличие от других хуков, использующих поле `decision` верхнего уровня, PreToolUse возвращает своё решение внутри объекта `hookSpecificOutput`. Это даёт ему более широкие возможности управления: четыре исхода (разрешить, запретить, запросить подтверждение или отложить) и возможность изменить входные данные инструмента перед выполнением.1940Хуки `PreToolUse` могут управлять тем, будет ли выполнен вызов инструмента. В отличие от других хуков, использующих поле `decision` верхнего уровня, PreToolUse возвращает своё решение внутри объекта `hookSpecificOutput`. Это даёт более богатые возможности управления: четыре исхода (разрешить, запретить, запросить подтверждение или отложить), а также возможность изменить входные данные инструмента перед выполнением.

1942 1941

1943| Поле | Описание |1942| Поле | Описание |

1944| :- | :- |1943| :- | :- |

1945| `permissionDecision` | `"allow"` пропускает запрос разрешения, кроме [действий, которые не подтверждает автоматически ни один режим](/docs/ru/permission-modes#actions-no-mode-auto-approves), и кроме `AskUserQuestion` и `ExitPlanMode`, которым нужен [`updatedInput` в паре с ним](#allow-with-updatedinput). `"deny"` предотвращает вызов инструмента. `"ask"` просит пользователя подтвердить. `"defer"` корректно завершает работу, чтобы инструмент можно было возобновить позже. [Правила запрета и запроса подтверждения](/docs/ru/permissions#manage-permissions) всё равно применяются независимо от того, что возвращает хук |1944| `permissionDecision` | `"allow"` пропускает запрос разрешения, за исключением [действий, которые не одобряются автоматически ни в одном режиме](/docs/ru/permission-modes#actions-no-mode-auto-approves), а также `AskUserQuestion` и `ExitPlanMode`, которым нужно [`updatedInput` в паре с ним](#allow-with-updatedinput). `"deny"` предотвращает вызов инструмента. `"ask"` просит пользователя подтвердить. `"defer"` корректно завершает работу, чтобы инструмент можно было возобновить позже. [Правила запрета и подтверждения](/docs/ru/permissions#manage-permissions) всё равно применяются независимо от того, что вернул хук |

1946| `permissionDecisionReason` | Для `"ask"` показывается пользователю в запросе разрешения. Когда Claude Code [отклоняет вызов](/docs/ru/headless#turn-off-permission-prompts-in-unattended-runs) в запуске с `-p`, где никто не может ответить на этот запрос, Claude вместо этого читает причину в результате инструмента. Для `"deny"` показывается Claude. Для `"allow"` и `"defer"` записывается только в [отладочный лог](#debug-hooks) |1945| `permissionDecisionReason` | Для `"ask"` показывается пользователю в запросе разрешения. Когда Claude Code [отклоняет вызов](/docs/ru/headless#turn-off-permission-prompts-in-unattended-runs) в запуске `-p`, где никто не может ответить на этот запрос, Claude вместо этого читает причину в результате инструмента. Для `"deny"` показывается Claude. Для `"allow"` и `"defer"` записывается только в [лог отладки](#debug-hooks) |

1947| `updatedInput` | Изменяет входные параметры инструмента перед выполнением. Заменяет весь объект входных данных, поэтому включайте неизменённые поля вместе с изменёнными. Claude Code проверяет правила разрешений и [возможность автоматического перевода в фон](/docs/ru/tools-reference#foreground-commands-that-move-to-the-background) команды Bash по входным данным, возвращённым вашим хуком, а не по тем, что отправил Claude. Используйте вместе с `"allow"` для автоматического подтверждения или с `"ask"`, чтобы показать пользователю изменённые входные данные. Для `"defer"` игнорируется |1946| `updatedInput` | Изменяет входные параметры инструмента перед выполнением. Заменяет весь объект входных данных, поэтому включайте неизменённые поля вместе с изменёнными. Claude Code проверяет правила разрешений и [пригодность к автоматическому переводу в фон](/docs/ru/tools-reference#foreground-commands-that-move-to-the-background) команды Bash по входным данным, которые возвращает ваш хук, а не по тем, что отправил Claude. Сочетайте с `"allow"` для автоматического одобрения или с `"ask"`, чтобы показать пользователю изменённые входные данные. Для `"defer"` игнорируется |

1948| `additionalContext` | Строка, добавляемая в контекст Claude вместе с результатом инструмента. Игнорируется, когда `permissionDecision` равно `"defer"`. См. [Добавление контекста для Claude](#add-context-for-claude) |1947| `additionalContext` | Строка, добавляемая в контекст Claude вместе с результатом инструмента. Игнорируется, когда `permissionDecision` равен `"defer"`. См. [Добавление контекста для Claude](#add-context-for-claude) |

1949 1948

1950Когда несколько хуков PreToolUse возвращают разные решения, приоритет таков: `deny` > `defer` > `ask` > `allow`.1949Когда несколько хуков PreToolUse возвращают разные решения, приоритет такой: `deny` > `defer` > `ask` > `allow`.

1951 1950

1952Хук, блокирующий с кодом выхода 2, обрабатывается так же, как `"deny"`: Claude видит сообщение из stderr как причину запрета.1951Хук, который блокирует, завершаясь с кодом 2, обрабатывается так же, как `"deny"`: Claude видит сообщение из stderr как причину отказа.

1953 1952

1954Когда хук возвращает `"ask"`, запрос разрешения, показываемый пользователю, содержит метку, указывающую, откуда взялся хук: `[settings]` для хука из любого файла настроек или из frontmatter агента, `[plugin:<name>]` для хука плагина или `[skill]` для хука из frontmatter скилла. Это помогает пользователям понять, какой источник конфигурации запрашивает подтверждение.1953Когда хук возвращает `"ask"`, запрос разрешения, показываемый пользователю, содержит метку, указывающую, откуда взялся хук: `[settings]` для хука из любого файла настроек или из frontmatter агента, `[plugin:<name>]` для хука плагина или `[skill]` для хука из frontmatter скилла. Это помогает пользователям понять, какой источник конфигурации запрашивает подтверждение.

1955 1954

1956`"ask"` от хука также принудительно вызывает запрос разрешения в [авторежиме](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode): классификатор по-прежнему может запретить вызов инструмента, но не может молча его одобрить. До v2.1.211 классификатор мог одобрить команду Bash, выполняемую вне [песочницы](/docs/ru/sandboxing), не показывая запрошенный хуком запрос; при этом классификатор всё равно применял к этой команде собственные правила безопасности, а `"deny"` от хука всегда соблюдался.1955`"ask"` от хука также принудительно вызывает запрос разрешения в [авторежиме](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode): классификатор по-прежнему может отклонить вызов инструмента, но не может одобрить его молча. До версии v2.1.211 классификатор мог одобрить команду Bash, выполняемую вне [песочницы](/docs/ru/sandboxing), не показывая запрос, затребованный хуком; при этом классификатор всё равно применял к этой команде собственные правила безопасности, а `"deny"` от хука всегда соблюдался.

1957 1956

1958```json theme={null}1957```json theme={null}

1959{1958{

1970```1969```

1971 1970

1972<Note>1971<Note>

1973 Ранее PreToolUse использовал поля `decision` и `reason` верхнего уровня, но для этого события они объявлены устаревшими. Используйте вместо них `hookSpecificOutput.permissionDecision` и `hookSpecificOutput.permissionDecisionReason`. Устаревшие значения `"approve"` и `"block"` соответствуют `"allow"` и `"deny"` соответственно. Другие события, такие как PostToolUse и Stop, продолжают использовать `decision` и `reason` верхнего уровня в качестве текущего формата.1972 Ранее PreToolUse использовал поля верхнего уровня `decision` и `reason`, но для этого события они объявлены устаревшими. Используйте вместо них `hookSpecificOutput.permissionDecision` и `hookSpecificOutput.permissionDecisionReason`. Устаревшие значения `"approve"` и `"block"` соответствуют `"allow"` и `"deny"`. Другие события, такие как PostToolUse и Stop, продолжают использовать поля верхнего уровня `decision` и `reason` в качестве текущего формата.

1974</Note>1973</Note>

1975 1974

1976<h4 id="allow-with-updatedinput">1975<h4 id="allow-with-updatedinput">

1977 Инструменты, требующие взаимодействия с пользователем1976 Инструменты, требующие взаимодействия с пользователем

1978</h4>1977</h4>

1979 1978

1980`AskUserQuestion` и `ExitPlanMode` требуют взаимодействия с пользователем. В [неинтерактивном режиме](/docs/ru/headless) с флагом `-p` Claude Code предлагает их, только когда у запуска есть [хост разрешений](/docs/ru/headless#turn-off-permission-prompts-in-unattended-runs), который получает запрос, например callback `canUseTool` в Agent SDK.1979`AskUserQuestion` и `ExitPlanMode` требуют взаимодействия с пользователем. В [неинтерактивном режиме](/docs/ru/headless) с флагом `-p` Claude Code предлагает их только когда у запуска есть [хост разрешений](/docs/ru/headless#turn-off-permission-prompts-in-unattended-runs), который принимает запрос, например обратный вызов `canUseTool` в Agent SDK.

1981 1980

1982Хук `PreToolUse` удовлетворяет этому требованию, если он делает следующее:1981Хук `PreToolUse` удовлетворяет этому требованию, если делает следующее:

1983 1982

19841. Читает входные данные инструмента из stdin19831. Читает входные данные инструмента из stdin

19852. Собирает ответ через ваш собственный интерфейс19842. Собирает ответ через ваш собственный интерфейс

2009}2008}

2010```2009```

2011 2010

2012MCP-инструмент, который его сервер помечает с помощью [`_meta["anthropic/requiresUserInteraction"]`](/docs/ru/mcp#require-approval-for-a-specific-tool), строже: хук не может пропустить его запрос подтверждения с помощью `"allow"`, с `updatedInput` или без него, потому что Claude Code не может убедиться, что хук получил необходимое инструменту взаимодействие.2011Инструмент MCP, который сервер помечает с помощью [`_meta["anthropic/requiresUserInteraction"]`](/docs/ru/mcp#require-approval-for-a-specific-tool), устроен строже: хук не может пропустить его запрос подтверждения с помощью `"allow"`, с `updatedInput` или без него, поскольку Claude Code не может убедиться, что хук провёл взаимодействие, необходимое инструменту.

2013 2012

2014<h4 id="defer-a-tool-call-for-later">2013<h4 id="defer-a-tool-call-for-later">

2015 Отложить вызов инструмента2014 Отложить вызов инструмента на потом

2016</h4>2015</h4>

2017 2016

2018`"defer"` предназначено для интеграций, которые запускают `claude -p` как подпроцесс и читают его вывод JSON, например приложения на Agent SDK или пользовательского интерфейса, построенного поверх Claude Code. Оно позволяет вызывающему процессу приостановить Claude на вызове инструмента, получить ввод через собственный интерфейс и продолжить с того же места. Claude Code учитывает это значение только в [неинтерактивном режиме](/docs/ru/headless) с флагом `-p`. В интерактивных сессиях он записывает в лог предупреждение и игнорирует результат хука.2017`"defer"` предназначен для интеграций, которые запускают `claude -p` как подпроцесс и читают его вывод JSON, например приложения на Agent SDK или пользовательского интерфейса, построенного поверх Claude Code. Он позволяет вызывающему процессу приостановить Claude на вызове инструмента, собрать входные данные через собственный интерфейс и продолжить с того же места. Claude Code учитывает это значение только в [неинтерактивном режиме](/docs/ru/headless) с флагом `-p`. В интерактивных сессиях он записывает в лог предупреждение и игнорирует результат хука.

2019 2018

2020Типичный случай — инструмент `AskUserQuestion`: Claude хочет что-то спросить у пользователя, но терминала для ответа нет. Запуск с `-p` предлагает `AskUserQuestion`, только если у него есть [хост разрешений](/docs/ru/headless#turn-off-permission-prompts-in-unattended-runs), например MCP-инструмент, переданный через `--permission-prompt-tool`, поэтому запускайте с ним. Цикл работает так:2019Типичный случай — инструмент `AskUserQuestion`: Claude хочет что-то спросить у пользователя, но нет терминала, в котором можно ответить. Запуск `-p` предлагает `AskUserQuestion` только когда у него есть [хост разрешений](/docs/ru/headless#turn-off-permission-prompts-in-unattended-runs), например инструмент MCP, передаваемый через `--permission-prompt-tool`, поэтому начинайте запуск с ним. Цикл работает так:

2021 2020

20221. Claude вызывает `AskUserQuestion`. Срабатывает хук `PreToolUse`.20211. Claude вызывает `AskUserQuestion`. Срабатывает хук `PreToolUse`.

20232. Хук возвращает `permissionDecision: "defer"`. Инструмент не выполняется. Процесс завершается с `stop_reason: "tool_deferred"`, а ожидающий вызов инструмента сохраняется в транскрипте.20222. Хук возвращает `permissionDecision: "defer"`. Инструмент не выполняется. Процесс завершается с `stop_reason: "tool_deferred"`, а ожидающий вызов инструмента сохраняется в транскрипте.

20243. Вызывающий процесс читает `deferred_tool_use` из результата SDK, показывает вопрос в своём интерфейсе и ждёт ответа.20233. Вызывающий процесс читает `deferred_tool_use` из результата SDK, показывает вопрос в собственном интерфейсе и ждёт ответа.

20254. Вызывающий процесс выполняет `claude -p --resume <session-id>` с тем же хостом разрешений. Тот же вызов инструмента снова запускает `PreToolUse`.20244. Вызывающий процесс выполняет `claude -p --resume <session-id>` с тем же хостом разрешений. Тот же вызов инструмента снова вызывает `PreToolUse`.

20265. Хук возвращает `permissionDecision: "allow"` с ответом в `updatedInput`. Инструмент выполняется, и Claude продолжает работу.20255. Хук возвращает `permissionDecision: "allow"` с ответом в `updatedInput`. Инструмент выполняется, и Claude продолжает работу.

2027 2026

2028Поле `deferred_tool_use` содержит `id`, `name` и `input` инструмента. `input` — это параметры, сгенерированные Claude для вызова инструмента и зафиксированные до выполнения:2027Поле `deferred_tool_use` содержит `id`, `name` и `input` инструмента. `input` — это параметры, которые Claude сформировал для вызова инструмента, зафиксированные до выполнения:

2029 2028

2030```json theme={null}2029```json theme={null}

2031{2030{

2041}2040}

2042```2041```

2043 2042

2044Ограничений по таймауту или количеству повторных попыток нет. Сессия остаётся на диске, пока вы её не возобновите, с учётом очистки по сроку хранения [`cleanupPeriodDays`](/docs/ru/settings-reference#cleanupperioddays), которая по умолчанию удаляет файлы сессий через 30 дней согласно [правилам очистки по сроку хранения](/docs/ru/claude-directory#cleaned-up-automatically). Если ответ не готов к моменту возобновления, хук может снова вернуть `"defer"`, и процесс завершится так же. Вызывающий процесс сам решает, когда выйти из цикла, в итоге возвращая из хука `"allow"` или `"deny"`.2043Ограничений по таймауту или количеству повторных попыток нет. Сессия хранится на диске, пока вы её не возобновите, с учётом очистки по сроку хранения [`cleanupPeriodDays`](/docs/ru/settings-reference#cleanupperioddays), которая по умолчанию удаляет файлы сессий через 30 дней в соответствии с [правилами очистки по сроку хранения](/docs/ru/claude-directory#cleaned-up-automatically). Если ответ не готов к моменту возобновления, хук может снова вернуть `"defer"`, и процесс завершится так же. Вызывающий процесс сам решает, когда выйти из цикла, в итоге вернув из хука `"allow"` или `"deny"`.

2045 2044

2046`"defer"` работает, только когда Claude делает в ходе один вызов инструмента. Если Claude делает несколько вызовов инструментов одновременно, `"defer"` игнорируется с предупреждением, и инструмент проходит обычный процесс проверки разрешений. Это ограничение существует потому, что при возобновлении можно повторно выполнить только один инструмент: нельзя отложить один вызов из пакета, не оставив остальные неразрешёнными.2045`"defer"` работает, только когда Claude делает в ходе один вызов инструмента. Если Claude делает несколько вызовов инструментов одновременно, `"defer"` игнорируется с предупреждением, и инструмент проходит обычный процесс проверки разрешений. Это ограничение существует потому, что при возобновлении можно повторно выполнить только один инструмент: нельзя отложить один вызов из пакета, не оставив остальные неразрешёнными.

2047 2046

2048Если отложенный инструмент при возобновлении больше недоступен, процесс завершается с `stop_reason: "tool_deferred_unavailable"` и `is_error: true` до срабатывания хука. Это происходит, когда MCP-сервер, предоставлявший инструмент, не подключён в возобновлённой сессии. Данные `deferred_tool_use` всё равно включаются, чтобы вы могли определить, какой инструмент пропал.2047Если отложенный инструмент больше недоступен при возобновлении, процесс завершается с `stop_reason: "tool_deferred_unavailable"` и `is_error: true` до срабатывания хука. Это происходит, когда MCP-сервер, предоставлявший инструмент, не подключён в возобновлённой сессии. Данные `deferred_tool_use` всё равно включаются, чтобы вы могли определить, какой инструмент пропал.

2049 2048

2050<Note>2049<Note>

2051 Чтобы возобновить отложенную сессию в режиме планирования, передайте [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags) вместе с `--resume`, чтобы Claude Code мог представить план на утверждение. Если вы передаёте некоторые другие флаги запуска, возобновлённый запуск не возвращается в режим планирования; см. [Возобновление в режиме планирования с `-p`](/docs/ru/sessions#resume-in-plan-mode-with-p). Требуется Claude Code v2.1.246 или новее.2050 Чтобы возобновить отложенную сессию в режиме планирования, передайте [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags) вместе с `--resume`, чтобы Claude Code мог представить план на утверждение. Если вы передаёте некоторые другие флаги запуска, возобновлённый запуск не возвращается в режим планирования; см. [Возобновление в режиме планирования с `-p`](/docs/ru/sessions#resume-in-plan-mode-with-p). Требуется Claude Code v2.1.246 или новее.

2052 2051

2053 При возобновлении с `-p` Claude Code не восстанавливает никакой другой сохранённый режим разрешений. Он запускает работу в том режиме разрешений, в котором запустился бы новый запуск `claude -p`, поэтому снова передайте `--permission-mode` или `--dangerously-skip-permissions`, если отложенная сессия их использовала. При возобновлении с `claude --resume <session-id>` без `-p` Claude Code восстанавливает сохранённый режим разрешений, за исключениями, перечисленными в разделе [режим разрешений при возобновлении](/docs/ru/sessions#permission-mode-on-resume).2052 При возобновлении с `-p` Claude Code не восстанавливает никакой другой сохранённый режим разрешений. Он запускается в том режиме разрешений, в котором запустился бы новый запуск `claude -p`, поэтому снова передайте `--permission-mode` или `--dangerously-skip-permissions`, если отложенная сессия их использовала. При возобновлении с `claude --resume <session-id>` без `-p` Claude Code восстанавливает сохранённый режим разрешений, за исключениями, перечисленными в разделе [режим разрешений при возобновлении](/docs/ru/sessions#permission-mode-on-resume).

2054</Note>2053</Note>

2055 2054

2056<h3 id="permissionrequest">2055<h3 id="permissionrequest">

2057 PermissionRequest2056 PermissionRequest

2058</h3>2057</h3>

2059 2058

2060Выполняется, когда Claude Code собирается запросить у вас разрешение на использование инструмента. В сессиях, которые не могут показать запрос, например у фоновых субагентов в [неинтерактивном режиме](/docs/ru/headless), Claude Code всё равно запускает эти хуки, и если ни один хук не вернёт решение, он запрещает вызов инструмента. Для вызова, который доходит до `--permission-prompt-tool` или [callback `canUseTool`](/docs/ru/agent-sdk/permissions) в Agent SDK, хуки выполняются параллельно с вашим хостом, и применяется то решение, которое принято первым.2059Выполняется, когда Claude Code собирается запросить у вас разрешение на использование инструмента. В сессиях, которые не могут показать запрос, например у фоновых субагентов в [неинтерактивном режиме](/docs/ru/headless), Claude Code всё равно запускает эти хуки, и если ни один хук не возвращает решение, он отклоняет вызов инструмента. Для вызова, который доходит до `--permission-prompt-tool` или [обратного вызова `canUseTool`](/docs/ru/agent-sdk/permissions) в Agent SDK, хуки выполняются параллельно с вашим хостом, и применяется решение того, кто решит первым.

2061Используйте [управление решениями PermissionRequest](#permissionrequest-decision-control), чтобы разрешать или запрещать от имени пользователя.2060Используйте [управление решениями PermissionRequest](#permissionrequest-decision-control), чтобы разрешать или запрещать от имени пользователя.

2062 2061

2063Используйте это событие, когда нужен сигнал в момент, когда Claude запрашивает разрешение на использование инструмента. Claude Code запускает хук [Notification](#notification) с типом `permission_prompt` только после того, как запрос прождёт около шести секунд.2062Используйте это событие, когда вам нужен сигнал в тот момент, когда Claude запрашивает разрешение на использование инструмента. Claude Code запускает хук [Notification](#notification) с типом `permission_prompt` только после того, как запрос прождёт около шести секунд.

2064 2063

2065Claude Code не запускает хуки PermissionRequest для [сетевого запроса](/docs/ru/sandboxing#network-isolation) команды, выполняемой в песочнице. Чтобы получить сигнал для такого запроса, используйте тип уведомления `permission_prompt`.2064Claude Code не запускает хуки PermissionRequest для [сетевого запроса](/docs/ru/sandboxing#network-isolation) команды в песочнице. Чтобы получить сигнал об этом запросе, используйте тип уведомления `permission_prompt`.

2066 2065

2067Сопоставляется по имени инструмента, с теми же значениями, что и PreToolUse.2066Сопоставляется с именем инструмента, с теми же значениями, что и PreToolUse.

2068 2067

2069<h4 id="permissionrequest-input">2068<h4 id="permissionrequest-input">

2070 Входные данные PermissionRequest2069 Входные данные PermissionRequest

2071</h4>2070</h4>

2072 2071

2073Хуки PermissionRequest получают поля `tool_name` и `tool_input`, как хуки PreToolUse, но без `tool_use_id`. Для MCP-инструмента они также получают объект [`mcp_server`](#pretooluse-input). Необязательный массив `permission_suggestions` содержит [обновления разрешений](#permission-update-entries), которые Claude Code предлагает для этого запроса, например добавление правила разрешения или смену режима разрешений.2072Хуки PermissionRequest получают поля `tool_name` и `tool_input`, как хуки PreToolUse, но без `tool_use_id`. Для инструмента MCP они также получают объект [`mcp_server`](#pretooluse-input). Необязательный массив `permission_suggestions` содержит [обновления разрешений](#permission-update-entries), которые Claude Code предлагает для этого запроса, например добавление правила разрешения или изменение режима разрешений.

2074 2073

2075Массив `permission_suggestions` не является точным списком вариантов, которые вы видите, поскольку каждое диалоговое окно разрешений формирует собственные варианты. Некоторые диалоговые окна, например для редактирования файлов, вообще не читают этот массив и выводят варианты из самого запроса. Диалоговое окно, которое его читает, всё равно может скрыть вариант, предложение для которого остаётся в массиве, например когда [`allowManagedPermissionRulesOnly`](/docs/ru/settings-reference#allowmanagedpermissionrulesonly) скрывает варианты сохранения правил. Оно также может предлагать варианты без соответствующей записи, например [**Yes, and switch to auto mode**](/docs/ru/permission-modes#switch-permission-modes), который меняет режим разрешений напрямую, а не через обновление разрешений.2074Массив `permission_suggestions` не является точным списком вариантов, которые вы видите, поскольку каждое диалоговое окно разрешения формирует собственные варианты. Некоторые диалоговые окна, например для редактирования файлов, вообще не читают этот массив и выводят варианты из самого запроса. Диалоговое окно, которое его читает, всё равно может скрыть вариант, предложение для которого остаётся в массиве, например когда [`allowManagedPermissionRulesOnly`](/docs/ru/settings-reference#allowmanagedpermissionrulesonly) скрывает варианты сохранения правил. Оно также может предлагать варианты без соответствующей записи предложения, например [**Yes, and switch to auto mode**](/docs/ru/permission-modes#switch-permission-modes), который меняет режим разрешений напрямую, а не через обновление разрешений.

2076 2075

2077Хуки PreToolUse выполняются перед каждым вызовом инструмента, независимо от того, нужно ли для него разрешение. Хуки PermissionRequest выполняются только когда Claude Code собирается запросить у вас разрешение или когда он иначе автоматически запретил бы вызов, который не может показать запрос. Ни одно из этих событий не срабатывает для [`EndConversation`](/docs/ru/tools-reference#endconversation-tool-behavior).2076Хуки PreToolUse выполняются перед каждым вызовом инструмента, независимо от того, требуется ли разрешение. Хуки PermissionRequest выполняются только когда Claude Code собирается запросить у вас разрешение или когда он иначе автоматически отклонил бы вызов, который не может показать запрос. Ни одно из этих событий не срабатывает для [`EndConversation`](/docs/ru/tools-reference#endconversation-tool-behavior).

2078 2077

2079```json theme={null}2078```json theme={null}

2080{2079{

2103 Управление решениями PermissionRequest2102 Управление решениями PermissionRequest

2104</h4>2103</h4>

2105 2104

2106Хуки `PermissionRequest` могут разрешать или запрещать запросы разрешений. Помимо [полей вывода JSON](#json-output), доступных всем хукам, ваш скрипт хука может вернуть объект `decision` со следующими полями, специфичными для события:2105Хуки `PermissionRequest` могут разрешать или отклонять запросы разрешений. Помимо [полей вывода JSON](#json-output), доступных всем хукам, скрипт хука может возвращать объект `decision` со следующими полями, специфичными для события:

2107 2106

2108| Поле | Описание |2107| Поле | Описание |

2109| :- | :- |2108| :- | :- |

2110| `behavior` | `"allow"` предоставляет разрешение, `"deny"` отклоняет его. [Правила запрета и запроса подтверждения](/docs/ru/permissions#manage-permissions) всё равно применяются, поэтому хук, возвращающий `"allow"`, не переопределяет соответствующее правило запрета |2109| `behavior` | `"allow"` предоставляет разрешение, `"deny"` отклоняет его. [Правила запрета и подтверждения](/docs/ru/permissions#manage-permissions) всё равно применяются, поэтому хук, вернувший `"allow"`, не переопределяет подходящее правило запрета |

2111| `updatedInput` | Только для `"allow"`: изменяет входные параметры инструмента перед выполнением. Заменяет весь объект входных данных, поэтому включайте неизменённые поля вместе с изменёнными. Изменённые входные данные повторно проверяются по правилам запрета и запроса подтверждения |2110| `updatedInput` | Только для `"allow"`: изменяет входные параметры инструмента перед выполнением. Заменяет весь объект входных данных, поэтому включайте неизменённые поля вместе с изменёнными. Изменённые входные данные повторно проверяются по правилам запрета и подтверждения |

2112| `updatedPermissions` | Только для `"allow"`: массив [записей обновления разрешений](#permission-update-entries) для применения, например добавление правила разрешения или смена режима разрешений сессии |2111| `updatedPermissions` | Только для `"allow"`: массив [записей обновления разрешений](#permission-update-entries) для применения, например добавление правила разрешения или изменение режима разрешений сессии |

2115 2114

2116Хук, завершившийся с кодом выхода 2 без объекта `decision`, оставляет процесс проверки разрешений без изменений, а его stderr отбрасывается. Предоставить или отклонить запрос может только объект `decision`.2115Хук, который завершается с кодом 2 без объекта `decision`, оставляет процесс проверки разрешений без изменений, а его stderr отбрасывается. Предоставить или отклонить запрос может только объект `decision`.

2117 2116

2118```json theme={null}2117```json theme={null}

2119{2118{

2133 Записи обновления разрешений2132 Записи обновления разрешений

2134</h4>2133</h4>

2135 2134

2136Поле вывода `updatedPermissions` и [входное поле `permission_suggestions`](#permissionrequest-input) используют один и тот же массив объектов-записей. У каждой записи есть `type`, определяющий её остальные поля, и `destination`, управляющий тем, куда записывается изменение.2135Выходное поле `updatedPermissions` и [входное поле `permission_suggestions`](#permissionrequest-input) используют один и тот же массив объектов-записей. У каждой записи есть поле `type`, которое определяет остальные её поля, и поле `destination`, которое определяет, куда записывается изменение.

2137 2136

2139| :- | :- | :- |2138| :- | :- | :- |

2140| `addRules` | `rules`, `behavior`, `destination` | Добавляет правила разрешений. `rules` — массив объектов `{toolName, ruleContent?}`. Не указывайте `ruleContent`, чтобы охватить весь инструмент. `behavior` — `"allow"`, `"deny"` или `"ask"` |2139| `addRules` | `rules`, `behavior`, `destination` | Добавляет правила разрешений. `rules` — это массив объектов `{toolName, ruleContent?}`. Опустите `ruleContent`, чтобы правило соответствовало всему инструменту. `behavior` принимает значение `"allow"`, `"deny"` или `"ask"` |

2143| `setMode` | `mode`, `destination` | Изменяет режим разрешений. Допустимые режимы: `default`, `auto`, `acceptEdits`, `dontAsk`, `bypassPermissions`, `plan`, а также `manual` как псевдоним для `default` |2142| `setMode` | `mode`, `destination` | Изменяет режим разрешений. Допустимые режимы: `default`, `auto`, `acceptEdits`, `dontAsk`, `bypassPermissions`, `plan`, а также `manual` как псевдоним для `default` |

2146 2145

2147<Note>2146<Note>

2148 `setMode` с `bypassPermissions` действует, только если вы запустили сессию с уже доступным режимом обхода: `--dangerously-skip-permissions`, `--permission-mode bypassPermissions`, `--allow-dangerously-skip-permissions` или `permissions.defaultMode: "bypassPermissions"` в [пользовательских настройках, `--settings` или управляемых настройках](/docs/ru/settings-reference#permissions-defaultmode). В противном случае обновление ничего не делает. Обновление также ничего не делает, когда [`permissions.disableBypassPermissionsMode`](/docs/ru/permissions#managed-settings) отключает этот режим или когда сессия запускается в [ограниченном режиме](/docs/ru/cli-reference#cli-flags).2147 `setMode` со значением `bypassPermissions` действует только в том случае, если вы запустили сессию с уже доступным режимом обхода: `--dangerously-skip-permissions`, `--permission-mode bypassPermissions`, `--allow-dangerously-skip-permissions` или `permissions.defaultMode: "bypassPermissions"` в [пользовательских настройках, `--settings` или управляемых настройках](/docs/ru/settings-reference#permissions-defaultmode). В противном случае обновление ничего не делает. Обновление также ничего не делает, когда [`permissions.disableBypassPermissionsMode`](/docs/ru/permissions#managed-settings) отключает этот режим или когда сессия запускается в [ограниченном режиме](/docs/ru/cli-reference#cli-flags).

2149 2148

2150 `bypassPermissions` никогда не сохраняется как `defaultMode` независимо от `destination`.2149 `bypassPermissions` никогда не сохраняется как `defaultMode`, независимо от `destination`.

2151</Note>2150</Note>

2152 2151

2153Поле `destination` в каждой записи определяет, остаётся ли изменение в памяти или сохраняется в файл настроек.2152Поле `destination` в каждой записи определяет, останется ли изменение только в памяти или будет сохранено в файл настроек.

2154 2153

2156| :- | :- |2155| :- | :- |

2161 2160

2162Хук может вернуть одно из полученных `permission_suggestions` в качестве собственного вывода `updatedPermissions`.2161Хук может вернуть одну из полученных `permission_suggestions` в качестве собственного вывода `updatedPermissions`.

2163 2162

2164<h3 id="posttooluse">2163<h3 id="posttooluse">

2165 PostToolUse2164 PostToolUse

2166</h3>2165</h3>

2167 2166

2168Запускается сразу после успешного завершения инструмента.2167Выполняется сразу после успешного завершения инструмента.

2169 2168

2170Сопоставляется по имени инструмента, значения те же, что и для PreToolUse.2169Сопоставляется по имени инструмента, значения те же, что и для PreToolUse.

2171 2170

2172Используйте более широкое сопоставление, когда имя инструмента не подходит в качестве фильтра:2171Используйте более широкое сопоставление, когда имя инструмента не подходит в качестве фильтра:

2173 2172

2174* Чтобы запускать хук после успешного завершения любого инструмента, опустите `matcher` или задайте ему значение `"*"`. Тогда ваш хук сможет сам определить, что изменилось, например выполнив `git status --porcelain`, который также показывает неотслеживаемые файлы, пропускаемые `git diff`. Для вызовов инструментов, завершившихся сбоем, добавьте тот же хук в [PostToolUseFailure](#posttoolusefailure).2173* Чтобы запускать хук после успешного завершения любого инструмента, опустите `matcher` или задайте ему значение `"*"`. Тогда ваш хук может сам определить, что изменилось, например выполнив `git status --porcelain`, который также выводит неотслеживаемые файлы, пропускаемые `git diff`. Для неудавшихся вызовов инструментов добавьте тот же хук в [PostToolUseFailure](#posttoolusefailure).

2175* Чтобы запускать хук при изменении определённого файла на диске, независимо от того, что его записало, используйте [FileChanged](#filechanged). Claude Code не запускает хук `PostToolUse`, сопоставленный с `Edit|Write`, когда тот же файл перезаписывает команда `Bash` или процесс вне Claude Code.2174* Чтобы запускать хук при изменении определённого файла на диске, независимо от того, что его записало, используйте [FileChanged](#filechanged). Claude Code не запускает хук `PostToolUse` с matcher `Edit|Write`, когда тот же файл перезаписывает команда `Bash` или процесс вне Claude Code.

2176 2175

2177<h4 id="posttooluse-input">2176<h4 id="posttooluse-input">

2178 Входные данные PostToolUse2177 Входные данные PostToolUse

2179</h4>2178</h4>

2180 2179

2181Хуки `PostToolUse` срабатывают после того, как инструмент уже успешно выполнился. Входные данные включают как `tool_input` — аргументы, переданные инструменту, так и `tool_response` — возвращённый им результат. Точная схема обоих зависит от инструмента. Пути в `tool_input` файловых инструментов поступают в том же формате, что и для [PreToolUse](#pretooluse-input): всегда абсолютные, с нативными разделителями платформы, то есть с обратными слешами в Windows. Для MCP-инструмента входные данные также содержат объект [`mcp_server`](#pretooluse-input).2180Хуки `PostToolUse` срабатывают после того, как инструмент уже успешно выполнился. Входные данные включают как `tool_input` — аргументы, переданные инструменту, — так и `tool_response` — возвращённый им результат. Точная схема обоих полей зависит от инструмента. Пути в `tool_input` для файловых инструментов приходят в том же формате, что и для [PreToolUse](#pretooluse-input): всегда абсолютные, с нативными разделителями платформы, то есть с обратными слешами в Windows. Для инструмента MCP входные данные также содержат объект [`mcp_server`](#pretooluse-input).

2182 2181

2183```json theme={null}2182```json theme={null}

2184{2183{

2203 2202

2204| Поле | Описание |2203| Поле | Описание |

2205| :- | :- |2204| :- | :- |

2206| `duration_ms` | Необязательное. Время выполнения инструмента в миллисекундах. Не включает время, проведённое в запросах разрешений и хуках PreToolUse |2205| `duration_ms` | Необязательное. Время выполнения инструмента в миллисекундах. Не включает время, проведённое в запросах разрешения и хуках PreToolUse |

2207 2206

2208<h4 id="posttooluse-decision-control">2207<h4 id="posttooluse-decision-control">

2209 Управление решениями PostToolUse2208 Управление решениями PostToolUse

2210</h4>2209</h4>

2211 2210

2212Хуки `PostToolUse` могут передавать Claude обратную связь после выполнения инструмента. Помимо [полей вывода JSON](#json-output), доступных всем хукам, ваш скрипт хука может возвращать следующие поля, специфичные для события:2211Хуки `PostToolUse` могут передавать Claude обратную связь после выполнения инструмента. Помимо [выходных полей JSON](#json-output), доступных всем хукам, ваш скрипт хука может возвращать следующие поля, специфичные для события:

2213 2212

2214| Поле | Описание |2213| Поле | Описание |

2215| :- | :- |2214| :- | :- |

2218| `additionalContext` | Строка, добавляемая в контекст Claude вместе с результатом инструмента. См. [Добавление контекста для Claude](#add-context-for-claude) |2217| `additionalContext` | Строка, добавляемая в контекст Claude вместе с результатом инструмента. См. [Добавление контекста для Claude](#add-context-for-claude) |

2219| `classifierContext` | Короткая заметка о результате этого вызова для классификатора [авторежима](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode), а не для Claude. См. [Аннотирование результата для классификатора авторежима](#annotate-a-result-for-the-auto-mode-classifier). Требуется Claude Code v2.1.236 или новее |2218| `classifierContext` | Короткая заметка о результате этого вызова для классификатора [авторежима](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode), а не для Claude. См. [Аннотирование результата для классификатора авторежима](#annotate-a-result-for-the-auto-mode-classifier). Требуется Claude Code v2.1.236 или новее |

2220| `updatedToolOutput` | Заменяет вывод инструмента указанным значением перед отправкой Claude. Значение должно соответствовать форме вывода инструмента |2219| `updatedToolOutput` | Заменяет вывод инструмента переданным значением до того, как он будет отправлен Claude. Значение должно соответствовать форме вывода инструмента |

2221| `updatedMCPToolOutput` | Заменяет вывод только для [MCP-инструментов](#match-mcp-tools). Предпочтительнее использовать `updatedToolOutput`, который работает для всех инструментов |2220| `updatedMCPToolOutput` | Заменяет вывод только для [инструментов MCP](#match-mcp-tools). Предпочтительнее использовать `updatedToolOutput`, который работает для всех инструментов |

2222 2221

2223Пример ниже заменяет вывод вызова `Bash`. Значение замены соответствует форме вывода инструмента `Bash`:2222В примере ниже заменяется вывод вызова `Bash`. Значение замены соответствует форме вывода инструмента `Bash`:

2224 2223

2225```json theme={null}2224```json theme={null}

2226{2225{

2238```2237```

2239 2238

2240<Warning>2239<Warning>

2241 `updatedToolOutput` изменяет только то, что видит Claude. К моменту срабатывания хука инструмент уже выполнился, поэтому все записанные файлы, выполненные команды или отправленные сетевые запросы уже вступили в силу. Телеметрия, например спаны инструментов OpenTelemetry и аналитические события, также фиксирует исходный вывод до запуска хука. Чтобы предотвратить или изменить вызов инструмента до его выполнения, используйте вместо этого хук [PreToolUse](#pretooluse).2240 `updatedToolOutput` меняет только то, что видит Claude. К моменту срабатывания хука инструмент уже выполнился, поэтому все записанные файлы, выполненные команды или отправленные сетевые запросы уже вступили в силу. Телеметрия, такая как спаны инструментов OpenTelemetry и аналитические события, также фиксирует исходный вывод до запуска хука. Чтобы предотвратить или изменить вызов инструмента до его выполнения, используйте вместо этого хук [PreToolUse](#pretooluse).

2242 2241

2243 Значение замены должно соответствовать форме вывода инструмента. Встроенные инструменты возвращают структурированные объекты, а не простые строки. Например, `Bash` возвращает объект с полями `stdout`, `stderr`, `interrupted` и `isImage`. Для встроенных инструментов значение, не соответствующее схеме вывода инструмента, игнорируется, и используется исходный вывод. Вывод MCP-инструментов передаётся без проверки схемы. Удаление сведений об ошибках, которые нужны Claude, может привести к тому, что он продолжит работу на основе ложного предположения.2242 Значение замены должно соответствовать форме вывода инструмента. Встроенные инструменты возвращают структурированные объекты, а не простые строки. Например, `Bash` возвращает объект с полями `stdout`, `stderr`, `interrupted` и `isImage`. Для встроенных инструментов значение, не соответствующее схеме вывода инструмента, игнорируется, и используется исходный вывод. Вывод инструментов MCP передаётся без проверки схемы. Удаление сведений об ошибках, которые нужны Claude, может привести к тому, что он продолжит работу на основе ложного предположения.

2244</Warning>2243</Warning>

2245 2244

2246<h4 id="annotate-a-result-for-the-auto-mode-classifier">2245<h4 id="annotate-a-result-for-the-auto-mode-classifier">

2247 Аннотирование результата для классификатора авторежима2246 Аннотирование результата для классификатора авторежима

2248</h4>2247</h4>

2249 2248

2250Верните `classifierContext`, чтобы отправить короткую заметку о результате вызова инструмента классификатору [авторежима](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode), а не Claude. Классификатор [никогда не получает сами результаты инструментов](/docs/ru/permission-modes#how-the-classifier-evaluates-actions), поэтому это поле — поддерживаемый способ сообщить ему что-либо о том, что вернул вызов, прежде чем он проверит последующие действия. Для этого поля требуется Claude Code v2.1.236 или новее.2249Верните `classifierContext`, чтобы отправить короткую заметку о результате вызова инструмента классификатору [авторежима](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode), а не Claude. Классификатор [никогда не получает сами результаты инструментов](/docs/ru/permission-modes#how-the-classifier-evaluates-actions), поэтому это поле — поддерживаемый способ сообщить ему что-либо о том, что вернул вызов, прежде чем он будет проверять последующие действия. Для этого поля требуется Claude Code v2.1.236 или новее.

2251 2250

2252Пример ниже сообщает классификатору, откуда взялся вывод запроса:2251В примере ниже классификатору сообщается, откуда получен вывод запроса:

2253 2252

2254```json theme={null}2253```json theme={null}

2255{2254{

2263Какой вес классификатор придаёт заметке, зависит от того, где вы настроили хук:2262Какой вес классификатор придаёт заметке, зависит от того, где вы настроили хук:

2264 2263

2265* **Хуки, настроенные в Claude Code**: для хуков из файлов настроек, плагинов, скиллов и frontmatter агентов классификатор рассматривает заметку как непроверенный контекст, предоставленный приложением. Заметка никогда не устанавливает намерение пользователя, и если в ней утверждается, что вы что-то одобрили или запросили, классификатор сверяет это утверждение с вашими собственными сообщениями в диалоге2264* **Хуки, настроенные в Claude Code**: для хуков из файлов настроек, плагинов, скиллов и frontmatter агентов классификатор рассматривает заметку как непроверенный контекст, предоставленный приложением. Заметка никогда не устанавливает намерение пользователя, и если в ней утверждается, что вы что-то одобрили или запросили, классификатор сверяет это утверждение с вашими собственными сообщениями в диалоге

2266* **Внутрипроцессные колбэки Agent SDK**: когда приложение, встраивающее Claude Code, регистрирует хук как [колбэк TypeScript SDK](/docs/ru/agent-sdk/hooks) и возвращает заметку во время активной сессии, классификатор может учитывать переданное в заметке утверждение пользователя как намерение пользователя. Такое утверждение может удовлетворить требование согласия, которое классификатор принял бы из отправленного вами сообщения, но оно никогда не снимает блокировку, которую не смогло бы снять и ваше собственное сообщение. После возобновления сессии Claude Code рассматривает восстановленные заметки как непроверенный контекст. Когда хуки из обеих групп аннотируют один и тот же вызов, классификатор рассматривает объединённую заметку как непроверенную2265* **Внутрипроцессные обратные вызовы Agent SDK**: когда приложение, встраивающее Claude Code, регистрирует хук как [обратный вызов TypeScript SDK](/docs/ru/agent-sdk/hooks) и возвращает заметку во время активной сессии, классификатор может рассматривать переданное в заметке утверждение пользователя как намерение пользователя. Такое утверждение может удовлетворить требование согласия, которое классификатор принял бы из отправленного вами сообщения, но оно никогда не снимает блокировку, которую не смогло бы снять и ваше собственное сообщение. После возобновления сессии Claude Code рассматривает восстановленные заметки как непроверенный контекст. Когда хуки из обеих групп аннотируют один и тот же вызов, классификатор рассматривает объединённую заметку как непроверенную

2267 2266

2268Claude Code применяет следующие ограничения при доставке заметки:2267Claude Code применяет следующие ограничения при доставке заметки:

2269 2268

2270* **Длина**: Claude Code ограничивает заметки для одного вызова инструмента 2 000 символами и обрезает остальное. Ограничение общее для всех хуков, отвечающих на этот вызов2269* **Длина**: Claude Code ограничивает заметки для одного вызова инструмента 2000 символами и обрезает остальное. Ограничение общее для всех хуков, отвечающих на этот вызов

2271* **Только синхронные ответы**: Claude Code игнорирует это поле в ответе хука, который [выполняется в фоне](#run-hooks-in-the-background), поскольку такой ответ приходит после того, как Claude Code записывает результат инструмента2270* **Только синхронные ответы**: Claude Code игнорирует это поле в ответе хука, который [выполняется в фоне](#run-hooks-in-the-background), потому что такой ответ приходит уже после того, как Claude Code зафиксирует результат инструмента

2272* **Вызовы, которые классификатор не записывает**: транскрипт классификатора не включает операции только для чтения, такие как чтение файлов и поиск. Claude Code отбрасывает заметку, прикреплённую к одному из таких вызовов2271* **Вызовы, которые классификатор не фиксирует**: транскрипт классификатора опускает поиск только для чтения, такой как чтение файлов и поиск. Claude Code отбрасывает заметку, прикреплённую к одному из таких вызовов

2273* **Взаимодействие с перезаписью**: когда заметка описывает вывод, который вы заменяете с помощью `updatedToolOutput`, верните оба поля в одном ответе хука. Claude Code отбрасывает заметку, если эта перезапись отклонена или её заменяет перезапись другого хука. Claude Code доставляет заметку, возвращённую без перезаписи, даже когда другой хук перезаписывает вывод2272* **Взаимодействие с перезаписью**: когда заметка описывает вывод, который вы заменяете с помощью `updatedToolOutput`, возвращайте оба поля в одном и том же ответе хука. Claude Code отбрасывает заметку, если эта перезапись отклонена или её заменяет перезапись другого хука. Claude Code доставляет заметку, возвращённую без перезаписи, даже если другой хук перезаписывает вывод

2274 2273

2275<Warning>2274<Warning>

2276 Классификатор воспринимает содержимое, которое вы помещаете в `classifierContext`, как информацию от приложения, в котором размещена сессия, поэтому не копируйте в него недоверенный вывод инструментов или сторонний текст. Ограничьте заметку коротким утверждением об этом конкретном вызове, например фактом о его происхождении или утверждением пользователя о нём; не используйте это поле для доставки несвязанных сообщений или потока событий.2275 Классификатор воспринимает содержимое, которое вы помещаете в `classifierContext`, как информацию от приложения, в котором размещена сессия, поэтому не копируйте туда недоверенный вывод инструментов или сторонний текст. Ограничьте заметку коротким утверждением об этом одном вызове, например фактом о его происхождении или утверждением пользователя о нём; не используйте это поле для доставки несвязанных сообщений или потока событий.

2277</Warning>2276</Warning>

2278 2277

2279<h3 id="posttoolusefailure">2278<h3 id="posttoolusefailure">

2280 PostToolUseFailure2279 PostToolUseFailure

2281</h3>2280</h3>

2282 2281

2283Запускается, когда инструмент, начавший выполнение, завершается сбоем: инструмент выбросил ошибку или MCP-инструмент вернул результат с ошибкой. Используйте его для записи сбоев в лог, отправки оповещений или передачи Claude корректирующей обратной связи.2282Выполняется, когда инструмент, начавший выполнение, завершается с ошибкой: инструмент выбросил ошибку или инструмент MCP вернул результат с ошибкой. Используйте его, чтобы логировать сбои, отправлять оповещения или давать Claude корректирующую обратную связь.

2284 2283

2285Сопоставляется по имени инструмента, значения те же, что и для PreToolUse.2284Сопоставляется по имени инструмента, значения те же, что и для PreToolUse.

2286 2285

2287<Note>2286<Note>

2288 Это событие не срабатывает для вызовов инструментов, отклонённых до выполнения: неизвестное имя инструмента, входные данные, не прошедшие проверку схемы или специфичную для инструмента проверку, или отказ в разрешении. Отклонения при проверке возвращаются как результаты `tool_use_error` и происходят до запуска хуков, поэтому они не вызывают ни `PreToolUse`, ни `PostToolUseFailure`. Отказы в разрешении вызывают `PreToolUse`, но не это событие; см. [PermissionDenied](#permissiondenied).2287 Это событие не срабатывает для вызовов инструментов, отклонённых до выполнения: неизвестное имя инструмента, входные данные, не прошедшие проверку схемы или специфичную для инструмента проверку, либо отказ в разрешении. Отклонения при проверке возвращаются как результаты `tool_use_error` и происходят до запуска хуков, поэтому они не вызывают ни `PreToolUse`, ни `PostToolUseFailure`. Отказы в разрешении вызывают `PreToolUse`, но не это событие; см. [PermissionDenied](#permissiondenied).

2289</Note>2288</Note>

2290 2289

2291<h4 id="posttoolusefailure-input">2290<h4 id="posttoolusefailure-input">

2292 Входные данные PostToolUseFailure2291 Входные данные PostToolUseFailure

2293</h4>2292</h4>

2294 2293

2295Хуки PostToolUseFailure получают те же поля `tool_name` и `tool_input`, что и PostToolUse, а также информацию об ошибке в виде полей верхнего уровня. Для MCP-инструмента они также получают объект [`mcp_server`](#pretooluse-input). Например, неудачная команда `npm test` может передать:2294Хуки PostToolUseFailure получают те же поля `tool_name` и `tool_input`, что и PostToolUse, а также информацию об ошибке в виде полей верхнего уровня. Для инструмента MCP они также получают объект [`mcp_server`](#pretooluse-input). Например, неудавшаяся команда `npm test` может передать:

2296 2295

2297```json theme={null}2296```json theme={null}

2298{2297{

2315 2314

2316| Поле | Описание |2315| Поле | Описание |

2317| :- | :- |2316| :- | :- |

2319| `is_interrupt` | Необязательное логическое значение. True, когда сбой достиг Claude Code как прерывание, а не как ошибка, о которой сообщил инструмент. Отмена выполняющегося инструмента не вызывает этот хук; вместо этого результат инструмента содержит сообщение о прерывании |2318| `is_interrupt` | Необязательное логическое значение. True, когда сбой дошёл до Claude Code как прерывание, а не как ошибка, о которой сообщил инструмент. Отмена работающего инструмента не вызывает этот хук; вместо этого результат инструмента содержит сообщение о прерывании |

2320| `duration_ms` | Необязательное. Время выполнения инструмента в миллисекундах. Не включает время, проведённое в запросах разрешений и хуках PreToolUse |2319| `duration_ms` | Необязательное. Время выполнения инструмента в миллисекундах. Не включает время, проведённое в запросах разрешения и хуках PreToolUse |

2321 2320

2322Строка `error` обычно совпадает с текстом, который Claude получает в качестве результата неудавшегося инструмента. Её формат зависит от инструмента и сбоя. Ориентируйте хук на `tool_name`, `is_interrupt` и первую строку `Exit code N`; остальную часть строки рассматривайте как отображаемый текст, а не как стабильный формат.2321Строка `error`, как правило, совпадает с текстом, который Claude получает в качестве результата неудавшегося инструмента. Её формат зависит от инструмента и типа сбоя. Ориентируйте логику хука на `tool_name`, `is_interrupt` и первую строку `Exit code N`; остальную часть строки рассматривайте как текст для отображения, а не как стабильный формат.

2323 2322

2324* Для Bash и PowerShell команда, которая выполнилась и завершилась, даёт первую строку `Exit code N`, а затем весь вывод команды одним блоком с чередующимися stdout и stderr2323* Для Bash и PowerShell команда, которая выполнилась и завершилась, даёт первую строку `Exit code N`, а затем весь вывод команды одним блоком, в котором stdout и stderr перемешаны

2325* Данные события также могут содержать простое сообщение о сбое без строки с кодом выхода, когда Claude Code не смог запустить сам процесс оболочки2324* Данные события также могут содержать просто сообщение о сбое без строки с кодом выхода, если Claude Code не смог запустить сам процесс оболочки

2326* Claude Code обрезает длинные строки посередине вокруг маркера `... [N characters truncated] ...` и может вставлять собственные строки, например `Command timed out after 2m 0s`2325* Claude Code обрезает середину длинных строк, вставляя маркер `... [N characters truncated] ...`, и может добавлять собственные строки, например `Command timed out after 2m 0s`

2327 2326

2328<h4 id="posttoolusefailure-decision-control">2327<h4 id="posttoolusefailure-decision-control">

2329 Управление решениями PostToolUseFailure2328 Управление решениями PostToolUseFailure

2330</h4>2329</h4>

2331 2330

2332Хуки `PostToolUseFailure` могут передавать Claude контекст после сбоя инструмента. Помимо [полей вывода JSON](#json-output), доступных всем хукам, ваш скрипт хука может возвращать следующие поля, специфичные для события:2331Хуки `PostToolUseFailure` могут передавать Claude контекст после сбоя инструмента. Помимо [выходных полей JSON](#json-output), доступных всем хукам, ваш скрипт хука может возвращать следующие поля, специфичные для события:

2333 2332

2334| Поле | Описание |2333| Поле | Описание |

2335| :- | :- |2334| :- | :- |

2348 PostToolBatch2347 PostToolBatch

2349</h3>2348</h3>

2350 2349

2351Запускается один раз после того, как разрешились все вызовы инструментов в пакете, до того как Claude Code отправит следующий запрос модели. `PostToolUse` срабатывает один раз для каждого инструмента, то есть срабатывает параллельно, когда Claude выполняет параллельные вызовы инструментов. `PostToolBatch` срабатывает ровно один раз с полным пакетом, поэтому это подходящее место для внедрения контекста, который зависит от набора выполненных инструментов, а не от какого-то одного инструмента. Для этого события matcher не поддерживается.2350Выполняется один раз после того, как все вызовы инструментов в пакете завершены, перед тем как Claude Code отправит следующий запрос модели. `PostToolUse` срабатывает один раз для каждого инструмента, а значит, срабатывает параллельно, когда Claude делает параллельные вызовы инструментов. `PostToolBatch` срабатывает ровно один раз с полным пакетом, поэтому это подходящее место для внедрения контекста, который зависит от набора выполненных инструментов, а не от какого-то одного инструмента. Для этого события нет matcher.

2352 2351

2353<h4 id="posttoolbatch-input">2352<h4 id="posttoolbatch-input">

2354 Входные данные PostToolBatch2353 Входные данные PostToolBatch

2380}2379}

2381```2380```

2382 2381

2383`tool_response` содержит то же содержимое, которое модель получает в соответствующем блоке `tool_result`. Значение — сериализованная строка или массив блоков содержимого, в точности как их выдал инструмент. Для `Read` это означает текст с префиксами номеров строк, а не необработанное содержимое файла. Ответы могут быть большими, поэтому разбирайте только нужные поля.2382`tool_response` содержит то же содержимое, которое модель получает в соответствующем блоке `tool_result`. Значение — это сериализованная строка или массив блоков содержимого, точно в том виде, в каком его выдал инструмент. Для `Read` это означает текст с префиксами номеров строк, а не сырое содержимое файла. Ответы могут быть большими, поэтому разбирайте только нужные вам поля.

2384 2383

2385<Note>2384<Note>

2386 Форма `tool_response` отличается от формы в `PostToolUse`. `PostToolUse` передаёт структурированный объект `Output` инструмента, например `{filePath: "...", type: "create"}` для `Write`; `PostToolBatch` передаёт сериализованное содержимое `tool_result`, которое видит модель.2385 Форма `tool_response` отличается от формы в `PostToolUse`. `PostToolUse` передаёт структурированный объект `Output` инструмента, например `{filePath: "...", type: "create"}` для `Write`; `PostToolBatch` передаёт сериализованное содержимое `tool_result`, которое видит модель.

2390 Управление решениями PostToolBatch2389 Управление решениями PostToolBatch

2391</h4>2390</h4>

2392 2391

2393Хуки `PostToolBatch` могут внедрять контекст для Claude. Помимо [полей вывода JSON](#json-output), доступных всем хукам, ваш скрипт хука может возвращать следующие поля, специфичные для события:2392Хуки `PostToolBatch` могут внедрять контекст для Claude. Помимо [выходных полей JSON](#json-output), доступных всем хукам, ваш скрипт хука может возвращать следующие поля, специфичные для события:

2394 2393

2395| Поле | Описание |2394| Поле | Описание |

2396| :- | :- |2395| :- | :- |

2411 PermissionDenied2410 PermissionDenied

2412</h3>2411</h3>

2413 2412

2414Запускается, когда [авторежим](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) отклоняет вызов инструмента, в том числе когда он отклоняет вызов без вердикта классификатора, потому что [проверка безопасности, отдельная от авторежима, отклонила собственный запрос классификатора](/docs/ru/errors#auto-mode-cannot-determine-the-safety-of-an-action) или его ответ не удалось разобрать. Этот хук срабатывает только в авторежиме: он не запускается, когда вы вручную отклоняете диалоговое окно разрешения, когда хук `PreToolUse` блокирует вызов или когда срабатывает правило `deny`. Используйте его для записи отказов в лог, корректировки конфигурации или сообщения модели, что она может повторить попытку вызова инструмента.2413Выполняется, когда [авторежим](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) отклоняет вызов инструмента, в том числе когда он отклоняет вызов без вердикта классификатора, потому что [проверка безопасности, отдельная от авторежима, отклонила собственный запрос классификатора](/docs/ru/errors#auto-mode-cannot-determine-the-safety-of-an-action) или его ответ не удалось разобрать. Этот хук срабатывает только в авторежиме: он не запускается, когда вы вручную отклоняете диалоговое окно разрешения, когда хук `PreToolUse` блокирует вызов или когда срабатывает правило `deny`. Используйте его, чтобы логировать отказы, корректировать конфигурацию или сообщать модели, что она может повторить попытку вызова инструмента.

2415 2414

2416Сопоставляется по имени инструмента, значения те же, что и для PreToolUse.2415Сопоставляется по имени инструмента, значения те же, что и для PreToolUse.

2417 2416

2419 Входные данные PermissionDenied2418 Входные данные PermissionDenied

2420</h4>2419</h4>

2421 2420

2422Помимо [общих входных полей](#common-input-fields), хуки PermissionDenied получают `tool_name`, `tool_input`, `tool_use_id` и `reason`. Для MCP-инструмента они также получают объект [`mcp_server`](#pretooluse-input).2421Помимо [общих входных полей](#common-input-fields), хуки PermissionDenied получают `tool_name`, `tool_input`, `tool_use_id` и `reason`. Для инструмента MCP они также получают объект [`mcp_server`](#pretooluse-input).

2423 2422

2424```json theme={null}2423```json theme={null}

2425{2424{

2440 2439

2441| Поле | Описание |2440| Поле | Описание |

2442| :- | :- |2441| :- | :- |

2443| `reason` | Причина отказа. Для вердикта классификатора в большинстве сессий она называет сработавшее правило в квадратных скобках, например `[Data Exfiltration]`; другие формы см. в разделе [Просмотр отказов](/docs/ru/auto-mode-config#review-denials). Для [отказа без вердикта](#permissiondenied-decision-control) она начинается с `Auto mode could not evaluate this action and is blocking it for safety`. Для отказа из-за недоступности модели классификатора это фиксированный текст `Classifier unavailable` |2442| `reason` | Причина отказа. Для вердикта классификатора в большинстве сессий в ней указывается сработавшее правило в квадратных скобках, например `[Data Exfiltration]`; другие формы см. в разделе [Просмотр отказов](/docs/ru/auto-mode-config#review-denials). Для [отказа без вердикта](#permissiondenied-decision-control) она начинается с `Auto mode could not evaluate this action and is blocking it for safety`. Для отказа из-за недоступности модели классификатора это фиксированный текст `Classifier unavailable` |

2444 2443

2445<h4 id="permissiondenied-decision-control">2444<h4 id="permissiondenied-decision-control">

2446 Управление решениями PermissionDenied2445 Управление решениями PermissionDenied

2459 2458

2460Когда `retry` равно `true`, Claude Code добавляет в диалог сообщение, сообщающее модели, что она может повторить попытку вызова инструмента. Сам отказ Claude Code не отменяет. Если ваш хук не возвращает JSON или возвращает `retry: false`, отказ остаётся в силе, и модель получает исходное сообщение об отклонении.2459Когда `retry` равно `true`, Claude Code добавляет в диалог сообщение, сообщающее модели, что она может повторить попытку вызова инструмента. Сам отказ Claude Code не отменяет. Если ваш хук не возвращает JSON или возвращает `retry: false`, отказ остаётся в силе, и модель получает исходное сообщение об отклонении.

2461 2460

2462Claude Code игнорирует `retry: true`, когда классификатор [не вынес вердикта по действию](/docs/ru/errors#auto-mode-cannot-determine-the-safety-of-an-action): его ответ не удалось разобрать, или проверка безопасности, отдельная от авторежима, отклонила собственный запрос классификатора. Для таких отказов Claude Code уже сообщает модели в сообщении об отклонении, следует ли повторить попытку позже или двигаться дальше.2461Claude Code игнорирует `retry: true`, когда классификатор не вынес [вердикта по действию](/docs/ru/errors#auto-mode-cannot-determine-the-safety-of-an-action): его ответ не удалось разобрать или проверка безопасности, отдельная от авторежима, отклонила собственный запрос классификатора. Для таких отказов Claude Code уже сообщает модели в сообщении об отклонении, следует ли повторить попытку позже или двигаться дальше.

2463 2462

2464<h3 id="notification">2463<h3 id="notification">

2465 Notification2464 Notification

2466</h3>2465</h3>

2467 2466

2468Запускается, когда Claude Code отправляет уведомления. Сопоставляется по типу уведомления. Опустите matcher, чтобы запускать хуки для всех типов уведомлений.2467Выполняется, когда Claude Code отправляет уведомления. Сопоставляется по типу уведомления. Опустите matcher, чтобы запускать хуки для всех типов уведомлений.

2469 2468

2470Вы получаете эти события хуков даже при отключённых уведомлениях рабочего стола: настройка `preferredNotifChannel`, включая `notifications_disabled`, меняет только способ оповещения, но не то, запускается ли ваш хук.2469Вы получаете эти события хуков даже при отключённых уведомлениях рабочего стола: настройка `preferredNotifChannel`, включая `notifications_disabled`, меняет только способ оповещения, а не то, запускается ли ваш хук.

2471 2470

2472| Matcher | Когда срабатывает |2471| Matcher | Когда срабатывает |

2473| :- | :- |2472| :- | :- |

2481| `agent_needs_input` | Фоновая сессия начинает ожидать вашего ввода, пока в терминале открыт [вид агентов](/docs/ru/agent-view). Также срабатывает, когда терминальная сессия показывает вам [вопрос участника команды агентов о настройке терминала](/docs/ru/agent-teams#choose-a-display-mode) или уведомление авторежима о [плате за запросы классификатора](/docs/ru/auto-mode-classifier-billing), и вы ничего не вводили около шести секунд |2480| `agent_needs_input` | Фоновая сессия начинает ждать вашего ввода, пока в терминале открыт [вид агентов](/docs/ru/agent-view). Также срабатывает, когда терминальная сессия показывает вам [вопрос о настройке терминала участника команды агентов](/docs/ru/agent-teams#choose-a-display-mode) или уведомление авторежима о [плате за запросы классификатора](/docs/ru/auto-mode-classifier-billing), и вы ничего не вводили около шести секунд |

2482| `agent_completed` | Фоновая сессия завершается или завершается сбоем. Срабатывает, только пока в терминале открыт [вид агентов](/docs/ru/agent-view) |2481| `agent_completed` | Фоновая сессия завершается или завершается со сбоем. Срабатывает только пока в терминале открыт [вид агентов](/docs/ru/agent-view) |

2483| `quota_auto_resume_fired` | Claude Code продолжает вашу задачу после того, как лимит использования claude.ai приостановил её: в момент сброса или раньше, когда что-то, что вы делаете в Claude Code во время ожидания, например добавление кредитов использования, повышение тарифного плана или смена модели, снова делает использование доступным, с [исключением для настройки модели](/docs/ru/interactive-mode#wait-for-a-usage-limit-to-reset) |2482| `quota_auto_resume_fired` | Claude Code продолжает вашу задачу после того, как её приостановил лимит использования claude.ai: в момент сброса или раньше, если какое-то ваше действие в Claude Code во время ожидания, например добавление кредитов использования, повышение тарифа или смена модели, снова делает использование доступным, с [исключением для настройки модели](/docs/ru/interactive-mode#wait-for-a-usage-limit-to-reset) |

2484| `quota_auto_resume_stale` | Лимит использования claude.ai сбросился, пока ваш компьютер находился в спящем режиме более 30 минут. Claude Code ждёт, пока вы нажмёте `Enter`, вместо того чтобы продолжить. После более короткого сна он продолжает работу и вместо этого вызывает `quota_auto_resume_fired` |2483| `quota_auto_resume_stale` | Лимит использования claude.ai сбросился, пока ваш компьютер находился в спящем режиме более 30 минут. Claude Code ждёт, пока вы нажмёте `Enter`, вместо того чтобы продолжить. После более короткого сна он продолжает работу и вместо этого вызывает `quota_auto_resume_fired` |

2485| `quota_auto_resume_disabled` | Claude Code завершает ожидание лимита использования claude.ai, не продолжая вашу задачу: [`autoContinueAtUsageLimit`](/docs/ru/settings-reference#autocontinueatusagelimit) отключена или сброс сместился более чем на 24 часа во время ожидания, которое Claude Code начал самостоятельно, продолженная задача продолжала упираться в лимит, или продолжение было заблокировано до того, как достигло модели. Не срабатывает, когда вы нажимаете `Esc` или `Ctrl+C` либо выбираете **Don't continue automatically** |2484| `quota_auto_resume_disabled` | Claude Code прекращает ожидание сброса лимита использования claude.ai, не продолжая вашу задачу: [`autoContinueAtUsageLimit`](/docs/ru/settings-reference#autocontinueatusagelimit) отключена или сброс сместился более чем на 24 часа вперёд во время ожидания, начатого Claude Code самостоятельно, продолженная задача снова и снова упиралась в лимит или продолжение было заблокировано до того, как дошло до модели. Не срабатывает, когда вы нажимаете `Esc` или `Ctrl+C` или выбираете **Don't continue automatically** |

2486 2485

2487Для типов `quota_auto_resume_fired`, `quota_auto_resume_stale` и `quota_auto_resume_disabled` требуется Claude Code v2.1.234 или новее.2486Для типов `quota_auto_resume_fired`, `quota_auto_resume_stale` и `quota_auto_resume_disabled` требуется Claude Code v2.1.234 или новее.

2488 2487

2489В терминальных сессиях для `permission_prompt` при сетевом запросе команды в песочнице требуется Claude Code v2.1.246 или новее.2488В терминальных сессиях для `permission_prompt` при сетевом запросе команды в песочнице требуется Claude Code v2.1.246 или новее.

2490 2489

2491Для `agent_needs_input` при вопросе участника команды о настройке терминала требуется Claude Code v2.1.248 или новее.2490Для `agent_needs_input` при вопросе о настройке терминала участника команды требуется Claude Code v2.1.248 или новее.

2492 2491

2493<Note>2492<Note>

2494 Типы `permission_prompt`, `idle_prompt`, `elicitation_dialog` и `elicitation_url_dialog` используют те же тайминги, что и уведомления рабочего стола, поэтому в терминальных сессиях вы видите их, только когда, судя по всему, отошли от терминала:2493 Типы `permission_prompt`, `idle_prompt`, `elicitation_dialog` и `elicitation_url_dialog` используют те же тайминги, что и уведомления рабочего стола, поэтому в терминальных сессиях вы увидите их, только если кажется, что вы отошли от терминала:

2495 2494

2496 * Ожидайте `permission_prompt`, когда вы ничего не вводили около шести секунд. Таймер запускается при появлении запроса разрешения, и каждое нажатие клавиши откладывает его. Чтобы запускать хук сразу, когда Claude запрашивает разрешение на использование инструмента, используйте вместо этого [PermissionRequest](#permissionrequest).2495 * Ожидайте `permission_prompt`, когда вы ничего не вводили около шести секунд. Таймер запускается при появлении запроса разрешения, и каждое нажатие клавиши откладывает его. Чтобы запускать хук сразу, когда Claude запрашивает разрешение на использование инструмента, используйте вместо этого [PermissionRequest](#permissionrequest).

2497 * Ожидайте `idle_prompt` примерно через 60 секунд после того, как Claude закончит отвечать, и только если с тех пор вы ничего не вводили и ни один фоновый агент, например фоновый [субагент](/docs/ru/sub-agents), ещё не работает. Claude Code не отправляет `idle_prompt`, пока ожидает сброса лимита использования claude.ai. Когда ожидание заканчивается само по себе, вместо этого срабатывает один из типов `quota_auto_resume_*`.2496 * Ожидайте `idle_prompt` примерно через 60 секунд после того, как Claude закончит отвечать, и только если вы с тех пор ничего не вводили и ни один фоновый агент, например фоновый [субагент](/docs/ru/sub-agents), больше не работает. Claude Code не отправляет `idle_prompt`, пока ждёт сброса лимита использования claude.ai. Когда ожидание заканчивается само, вместо этого срабатывает один из типов `quota_auto_resume_*`.

2498 * Ожидайте `elicitation_dialog` для формы запроса данных или `elicitation_url_dialog` для запроса URL в браузере, когда вы ничего не вводили около шести секунд. Оба используют тот же шестисекундный порог, что и `permission_prompt`: таймер запускается при появлении диалогового окна, и каждое нажатие клавиши откладывает его.2497 * Ожидайте `elicitation_dialog` для формы запроса данных или `elicitation_url_dialog` для запроса URL в браузере, когда вы ничего не вводили около шести секунд. Оба используют тот же шестисекундный порог, что и `permission_prompt`: таймер запускается при появлении диалогового окна, и каждое нажатие клавиши откладывает его.

2499 2498

2500 Запрос разрешения или запрос данных, поступивший, пока на экране открыто другое диалоговое окно, сохраняет тот же шестисекундный порог, отсчитываемый с момента поступления запроса. Уведомление о нём может дойти до вас, пока запрос всё ещё ожидает за открытым диалоговым окном.2499 Запрос разрешения или запрос данных, который поступает, пока на экране открыто другое диалоговое окно, сохраняет тот же шестисекундный порог, отсчитываемый с момента поступления запроса. Уведомление о нём может дойти до вас, пока запрос всё ещё ждёт за открытым диалоговым окном.

2501</Note>2500</Note>

2502 2501

2503Claude Code иначе рассчитывает время `permission_prompt` в сессиях, где он отправляет запросы разрешений в [колбэк `canUseTool`](/docs/ru/agent-sdk/user-input) Agent SDK — именно так Claude Desktop и расширение VS Code размещают Claude Code:2502Claude Code иначе рассчитывает время для `permission_prompt` в сессиях, где он отправляет запросы разрешения в [обратный вызов `canUseTool`](/docs/ru/agent-sdk/user-input) Agent SDK — именно так Claude Desktop и расширение VS Code размещают Claude Code:

2504 2503

2505* Ожидайте `permission_prompt` примерно через шесть секунд после того, как Claude запросит разрешение. Claude Code не откладывает его, пока вы вводите текст.2504* Ожидайте `permission_prompt` примерно через шесть секунд после того, как Claude запросит разрешение. Claude Code не откладывает его, пока вы вводите текст.

2506* Если вы или хук [PermissionRequest](#permissionrequest) ответите раньше, Claude Code не запускает `permission_prompt`.2505* Если вы или хук [PermissionRequest](#permissionrequest) ответите раньше, Claude Code не запускает `permission_prompt`.

2507* Установите [`CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS`](/docs/ru/env-vars) в `1`, чтобы отключить `permission_prompt` в таких сессиях.2506* Задайте [`CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS`](/docs/ru/env-vars) значение `1`, чтобы отключить `permission_prompt` в этих сессиях.

2508 2507

2509До v2.1.233 `permission_prompt` в таких сессиях не срабатывал.2508До v2.1.233 `permission_prompt` в этих сессиях не срабатывал.

2510 2509

2511Используйте отдельные matcher, чтобы запускать разные обработчики в зависимости от типа уведомления. Эта конфигурация запускает скрипт оповещения о разрешениях, когда Claude нужно подтверждение разрешения, и другое уведомление, когда Claude простаивает:2510Используйте отдельные matcher, чтобы запускать разные обработчики в зависимости от типа уведомления. Эта конфигурация запускает скрипт оповещения о разрешениях, когда Claude нужно подтверждение разрешения, и другое уведомление, когда Claude простаивает:

2512 2511

2541 Входные данные Notification2540 Входные данные Notification

2542</h4>2541</h4>

2543 2542

2544Помимо [общих входных полей](#common-input-fields), хуки Notification получают `message` с текстом уведомления, необязательное `title` и `notification_type`, указывающее, какой тип сработал.2543Помимо [общих входных полей](#common-input-fields), хуки Notification получают `message` с текстом уведомления, необязательный `title` и `notification_type`, указывающий, какой тип сработал.

2545 2544

2546```json theme={null}2545```json theme={null}

2547{2546{

2555}2554}

2556```2555```

2557 2556

2558Хуки Notification не могут блокировать или изменять уведомления. Claude Code отбрасывает их поля `systemMessage` и `continue`, но по-прежнему выводит [`terminalSequence`](#emit-terminal-notifications), на чём основан пример уведомления рабочего стола. Хуки Notification предназначены для побочных эффектов, например пересылки уведомления во внешний сервис.2557Хуки Notification не могут блокировать или изменять уведомления. Claude Code отбрасывает их поля `systemMessage` и `continue`, но по-прежнему выводит [`terminalSequence`](#emit-terminal-notifications), на чём основан пример с уведомлением рабочего стола. Хуки Notification предназначены для побочных действий, например для пересылки уведомления во внешний сервис.

2559 2558

2560<h3 id="subagentstart">2559<h3 id="subagentstart">

2561 SubagentStart2560 SubagentStart

2562</h3>2561</h3>

2563 2562

2564Запускается, когда Claude создаёт субагента с помощью инструмента Agent, когда Claude [возобновляет субагента](/docs/ru/sub-agents#resume-subagents), и каждый раз, когда внутрипроцессный участник [команды агентов](/docs/ru/agent-teams) обрабатывает новое сообщение. Поддерживает matcher для фильтрации по имени типа агента. Для встроенных агентов это имя агента, например `general-purpose`, `Explore` или `Plan`. Для [пользовательских субагентов](/docs/ru/sub-agents) это поле `name` из frontmatter агента, а не имя файла.2563Выполняется, когда Claude запускает субагента с помощью инструмента Agent, когда Claude [возобновляет субагента](/docs/ru/sub-agents#resume-subagents), а также каждый раз, когда внутрипроцессный участник [команды агентов](/docs/ru/agent-teams) обрабатывает новое сообщение. Поддерживает matcher для фильтрации по имени типа агента. Для встроенных агентов это имя агента, например `general-purpose`, `Explore` или `Plan`. Для [пользовательских субагентов](/docs/ru/sub-agents) это поле `name` из frontmatter агента, а не имя файла.

2565 2564

2566Для субагентов, поставляемых [плагином](/docs/ru/plugins/overview), тип агента — это идентификатор с областью плагина, например `my-plugin:reviewer`, а не просто имя из frontmatter. Двоеточие переводит имя с областью плагина на путь регулярных выражений, поэтому для точного совпадения закрепите matcher с помощью `^` и `$`: `^my-plugin:reviewer$`.2565Для субагентов, поставляемых [плагином](/docs/ru/plugins/overview), тип агента — это идентификатор в области плагина, например `my-plugin:reviewer`, а не просто имя из frontmatter. Двоеточие переводит имя в области плагина на путь регулярных выражений, поэтому для точного совпадения закрепите matcher с помощью `^` и `$`: `^my-plugin:reviewer$`.

2567 2566

2568<h4 id="subagentstart-input">2567<h4 id="subagentstart-input">

2569 Входные данные SubagentStart2568 Входные данные SubagentStart

2582}2581}

2583```2582```

2584 2583

2585Хуки SubagentStart не могут блокировать создание субагента, но могут внедрять в него контекст. Помимо [полей вывода JSON](#json-output), доступных всем хукам, вы можете вернуть:2584Хуки SubagentStart не могут блокировать создание субагента, но могут внедрять контекст в субагента. Помимо [выходных полей JSON](#json-output), доступных всем хукам, вы можете вернуть:

2586 2585

2587| Поле | Описание |2586| Поле | Описание |

2588| :- | :- |2587| :- | :- |

2589| `additionalContext` | Строка, добавляемая в контекст субагента в начале его диалога, перед первым промптом. См. [Добавление контекста для Claude](#add-context-for-claude) |2588| `additionalContext` | Строка, добавляемая в контекст субагента в начале его диалога, перед его первым промптом. См. [Добавление контекста для Claude](#add-context-for-claude) |

2590 2589

2591```json theme={null}2590```json theme={null}

2592{2591{

2597}2596}

2598```2597```

2599 2598

2600Когда хук снова запускается для того же субагента, Claude Code внедряет возвращённый контекст, только если контекст субагента ещё не содержит копию из предыдущего запуска. Копия, внедрённая при запуске, остаётся на месте, сохраняя [кэш промптов](/docs/ru/prompt-caching#subagents-and-the-cache) субагента нетронутым. После того как [автосжатие](/docs/ru/sub-agents#auto-compaction) отбрасывает эту копию, Claude Code снова внедряет контекст следующего запуска.2599Когда хук снова запускается для того же субагента, Claude Code внедряет возвращённый контекст только в том случае, если контекст субагента ещё не содержит копию из предыдущего запуска. Копия, внедрённая при запуске, остаётся на месте, сохраняя [кэш промптов](/docs/ru/prompt-caching#subagents-and-the-cache) субагента нетронутым. После того как [автосжатие](/docs/ru/sub-agents#auto-compaction) отбросит эту копию, Claude Code снова внедряет контекст следующего запуска.

2601 2600

2602<h3 id="subagentstop">2601<h3 id="subagentstop">

2603 SubagentStop2602 SubagentStop

2604</h3>2603</h3>

2605 2604

2606Запускается, когда субагент Claude Code закончил отвечать. Сопоставляется по типу агента, значения те же, что и для SubagentStart.2605Выполняется, когда субагент Claude Code закончил отвечать. Сопоставляется по типу агента, значения те же, что и для SubagentStart.

2607 2606

2608<h4 id="subagentstop-input">2607<h4 id="subagentstop-input">

2609 Входные данные SubagentStop2608 Входные данные SubagentStop

2610</h4>2609</h4>

2611 2610

2612Помимо [общих входных полей](#common-input-fields), хуки SubagentStop получают `stop_hook_active`, `agent_id`, `agent_type`, `agent_transcript_path` и `last_assistant_message`. Поле `agent_type` — это значение, используемое для фильтрации matcher. `transcript_path` — это транскрипт основной сессии, тогда как `agent_transcript_path` — собственный транскрипт субагента, хранящийся во вложенной папке `subagents/`. Поле `last_assistant_message` содержит текстовое содержимое последнего ответа субагента, поэтому хуки могут получить к нему доступ без разбора файла транскрипта.2611Помимо [общих входных полей](#common-input-fields), хуки SubagentStop получают `stop_hook_active`, `agent_id`, `agent_type`, `agent_transcript_path` и `last_assistant_message`. Поле `agent_type` — это значение, используемое для фильтрации matcher. `transcript_path` — это транскрипт основной сессии, а `agent_transcript_path` — собственный транскрипт субагента, хранящийся во вложенной папке `subagents/`. Поле `last_assistant_message` содержит текстовое содержимое финального ответа субагента, поэтому хуки могут получить к нему доступ без разбора файла транскрипта.

2613 2612

2614Не каждое событие SubagentStop исходит от субагента, созданного Claude. Claude Code также запускает внутренних агентов для некоторых собственных функций, таких как [предложения промптов](/docs/ru/interactive-mode#prompt-suggestions) и [побочные вопросы `/btw`](/docs/ru/interactive-mode#side-questions-with-%2Fbtw), и SubagentStop срабатывает, когда завершается и один из них. Для таких событий `agent_type` — это имя агента, от имени которого работает сама сессия, например заданное с помощью [`--agent`](/docs/ru/cli-reference#cli-flags) или [настройки `agent`](/docs/ru/settings-reference#agent), и пустая строка, когда сессия работает без него.2613Не каждое событие SubagentStop исходит от субагента, запущенного Claude. Claude Code также запускает внутренних агентов для некоторых собственных функций, таких как [предложения промптов](/docs/ru/interactive-mode#prompt-suggestions) и [побочные вопросы `/btw`](/docs/ru/interactive-mode#side-questions-with-%2Fbtw), и SubagentStop срабатывает и при завершении одного из них. Для таких событий `agent_type` — это имя агента, от имени которого работает сама сессия, например заданное с помощью [`--agent`](/docs/ru/cli-reference#cli-flags) или [настройки `agent`](/docs/ru/settings-reference#agent), и пустая строка, если сессия работает без него.

2615 2614

2616`matcher`, называющий типы агентов, не совпадает с пустым `agent_type`. Хук, у которого matcher опущен, равен `""` или `"*"` либо является регулярным выражением, совпадающим с пустой строкой, запускается и для событий с пустым `agent_type`.2615`matcher`, в котором указаны типы агентов, не соответствует пустому `agent_type`. Хук, у которого matcher опущен, равен `""` или `"*"` либо является регулярным выражением, соответствующим пустой строке, запускается и для событий с пустым `agent_type`.

2617 2616

2618В Claude Code v2.1.271 или новее субагент, работающий с инструментом [`SubagentHandback`](/docs/ru/tools-reference), доставляет свой отчёт через этот инструмент перед остановкой. Тогда поле `last_assistant_message` содержит заключительный текст субагента, если он есть, который не является доставленным отчётом. Отчёт — это входное значение `message` этого вызова, которое хук `PreToolUse` или `PostToolUse`, сопоставленный с `SubagentHandback`, получает как `tool_input.message`.2617В Claude Code v2.1.271 или новее субагент, работающий с инструментом [`SubagentHandback`](/docs/ru/tools-reference), доставляет свой отчёт через этот инструмент перед остановкой. Поле `last_assistant_message` в этом случае содержит заключительный текст субагента, если он есть, и это не доставленный отчёт. Отчёт — это входное поле `message` этого вызова, которое хук `PreToolUse` или `PostToolUse` с matcher `SubagentHandback` получает как `tool_input.message`.

2619 2618

2620Хуки SubagentStop также получают массивы `background_tasks` и `session_crons`, описанные в разделе [Входные данные Stop](#stop-input). Оба массива относятся к родительской сессии, а не к субагенту.2619Хуки SubagentStop также получают массивы `background_tasks` и `session_crons`, описанные в разделе [Входные данные Stop](#stop-input). Оба массива относятся к родительской сессии, а не к субагенту.

2621 2620

2636}2635}

2637```2636```

2638 2637

2639Хуки SubagentStop используют тот же формат управления решениями, что и [хуки Stop](#stop-decision-control), включая `hookSpecificOutput.additionalContext` с `hookEventName`, равным `"SubagentStop"`, для обратной связи без ошибки, которая продолжает работу субагента. Возврат `decision: "block"` с `reason` продолжает работу субагента и доставляет `reason` субагенту в качестве следующей инструкции. Хук, который блокирует с кодом выхода 2, доставляет своё сообщение stderr тем же способом. Чтобы внедрить контекст в родительскую сессию после возврата субагента, используйте вместо этого хук [`PostToolUse`](#posttooluse) для инструмента `Agent`.2638Хуки SubagentStop используют тот же формат управления решениями, что и [хуки Stop](#stop-decision-control), включая `hookSpecificOutput.additionalContext` с `hookEventName`, равным `"SubagentStop"`, для обратной связи без ошибки, которая продолжает работу субагента. Возврат `decision: "block"` с `reason` продолжает работу субагента и передаёт ему `reason` в качестве следующей инструкции. Хук, который блокирует, завершаясь с кодом 2, передаёт своё сообщение из stderr тем же способом. Чтобы внедрить контекст в родительскую сессию после возврата субагента, используйте вместо этого хук [`PostToolUse`](#posttooluse) для инструмента `Agent`.

2640 2639

2641<h3 id="taskcreated">2640<h3 id="taskcreated">

2642 TaskCreated2641 TaskCreated

2643</h3>2642</h3>

2644 2643

2645Запускается, когда задача создаётся с помощью инструмента `TaskCreate`. Используйте его для соблюдения соглашений об именовании, обязательного указания описаний задач или предотвращения создания определённых задач. В [сессии без инструментов Task](/docs/ru/tools-reference#task-tool-availability) это событие не срабатывает.2644Выполняется, когда задача создаётся с помощью инструмента `TaskCreate`. Используйте его, чтобы обеспечивать соблюдение соглашений об именовании, требовать описания задач или предотвращать создание определённых задач. В [сессии без инструментов Task](/docs/ru/tools-reference#task-tool-availability) это событие не срабатывает.

2646 2645

2647Хуки TaskCreated не поддерживают matcher и срабатывают при каждом возникновении события.2646Хуки TaskCreated не поддерживают matcher и срабатывают при каждом возникновении события.

2648 2647

2650 Входные данные TaskCreated2649 Входные данные TaskCreated

2651</h4>2650</h4>

2652 2651

2653Помимо [общих входных полей](#common-input-fields), хуки TaskCreated получают `task_id`, `task_subject` и, необязательно, `task_description`, `teammate_name` и `team_name`.2652Помимо [общих входных полей](#common-input-fields), хуки TaskCreated получают `task_id`, `task_subject` и, при наличии, `task_description`, `teammate_name` и `team_name`.

2654 2653

2655```json theme={null}2654```json theme={null}

2656{2655{

2675| `agent_id` | В этом событии [общее входное поле](#common-input-fields) идентифицирует субагента или [внутрипроцессного участника команды](/docs/ru/agent-teams#choose-a-display-mode), создающего задачу. Может отсутствовать. Требуется Claude Code v2.1.290 или новее |

2676 2676

2677<h4 id="taskcreated-decision-control">2677<h4 id="taskcreated-decision-control">

2678 Управление решениями TaskCreated2678 Управление решениями TaskCreated

2680 2680

2681Хук TaskCreated может заблокировать создание двумя способами. В любом случае Claude Code удаляет задачу и возвращает ваше сообщение Claude в качестве ошибки инструмента. Claude Code игнорирует `continue: false` от этого события, и Claude продолжает работу.2681Хук TaskCreated может заблокировать создание двумя способами. В любом случае Claude Code удаляет задачу и возвращает ваше сообщение Claude в качестве ошибки инструмента. Claude Code игнорирует `continue: false` от этого события, и Claude продолжает работу.

2682 2682

2683* **Код выхода 2**: Claude Code возвращает текст stderr в качестве сообщения.2683* **Код выхода 2**: Claude Code возвращает текст из stderr в качестве сообщения.

2684* **JSON `{"decision": "block", "reason": "..."}`**: Claude Code возвращает `reason` в качестве сообщения.2684* **JSON `{"decision": "block", "reason": "..."}`**: Claude Code возвращает `reason` в качестве сообщения.

2685 2685

2686Этот пример блокирует задачи, заголовки которых не соответствуют требуемому формату:2686В этом примере блокируются задачи, заголовки которых не соответствуют требуемому формату:

2687 2687

2688```bash theme={null}2688```bash theme={null}

2689#!/bin/bash2689#!/bin/bash

2702 TaskCompleted2702 TaskCompleted

2703</h3>2703</h3>

2704 2704

2705Запускается, когда задача помечается как выполненная. Это происходит в двух ситуациях: когда любой агент явно помечает задачу как выполненную с помощью инструмента TaskUpdate или когда участник [команды агентов](/docs/ru/agent-teams) завершает свой ход с задачами в процессе выполнения. Используйте его для соблюдения критериев завершения, таких как прохождение тестов или проверок линтера, прежде чем задачу можно будет закрыть.2705Выполняется, когда задача помечается как выполненная. Это происходит в двух ситуациях: когда любой агент явно помечает задачу как выполненную с помощью инструмента TaskUpdate или когда участник [команды агентов](/docs/ru/agent-teams) завершает свой ход с задачами в процессе выполнения. Используйте его, чтобы обеспечивать соблюдение критериев завершения, например прохождение тестов или проверок линтера, прежде чем задачу можно будет закрыть.

2706 2706

2707Хуки TaskCompleted не поддерживают matcher и срабатывают при каждом возникновении события.2707Хуки TaskCompleted не поддерживают matcher и срабатывают при каждом возникновении события.

2708 2708

2710 Входные данные TaskCompleted2710 Входные данные TaskCompleted

2711</h4>2711</h4>

2712 2712

2713Помимо [общих входных полей](#common-input-fields), хуки TaskCompleted получают `task_id`, `task_subject` и, необязательно, `task_description`, `teammate_name` и `team_name`.2713Помимо [общих входных полей](#common-input-fields), хуки TaskCompleted получают `task_id`, `task_subject` и, при наличии, `task_description`, `teammate_name` и `team_name`.

2714 2714

2715```json theme={null}2715```json theme={null}

2716{2716{

2737| `agent_id` | В этом событии [общее входное поле](#common-input-fields) идентифицирует субагента или [внутрипроцессного участника команды](/docs/ru/agent-teams#choose-a-display-mode), завершающего задачу. Может отсутствовать. Требуется Claude Code v2.1.290 или новее |

2737 2738

2738<h4 id="taskcompleted-decision-control">2739<h4 id="taskcompleted-decision-control">

2739 Управление решениями TaskCompleted2740 Управление решениями TaskCompleted

2741 2742

2742Хуки TaskCompleted поддерживают два способа управления завершением задачи:2743Хуки TaskCompleted поддерживают два способа управления завершением задачи:

2743 2744

2744* **Код выхода 2**: задача не помечается как выполненная, а сообщение stderr передаётся модели в качестве обратной связи.2745* **Код выхода 2**: задача не помечается как выполненная, а сообщение из stderr передаётся модели в качестве обратной связи.

2745* **JSON `{"continue": false, "stopReason": "..."}`**: когда событие вызвано завершением хода участника команды, полностью останавливает участника команды, аналогично поведению хука `Stop`. `stopReason` показывается пользователю. Когда событие вызвано инструментом `TaskUpdate`, Claude Code игнорирует `continue: false`; код выхода 2 по-прежнему блокирует завершение.2746* **JSON `{"continue": false, "stopReason": "..."}`**: когда событие вызвано завершением хода участника команды, полностью останавливает участника команды, аналогично поведению хука `Stop`. `stopReason` показывается пользователю. Когда событие вызвано инструментом `TaskUpdate`, Claude Code игнорирует `continue: false`; код выхода 2 по-прежнему блокирует завершение.

2746 2747

2747Этот пример запускает тесты и блокирует завершение задачи, если они не проходят:2748В этом примере запускаются тесты и блокируется завершение задачи, если они не проходят:

2748 2749

2749```bash theme={null}2750```bash theme={null}

2750#!/bin/bash2751#!/bin/bash

2764 Stop2765 Stop

2765</h3>2766</h3>

2766 2767

2767Запускается, когда основной агент Claude Code закончил отвечать. Не запускается, если2768Выполняется, когда основной агент Claude Code закончил отвечать. Не выполняется, если

2768остановка произошла из-за прерывания пользователем. При ошибках API вместо этого2769остановка произошла из-за прерывания пользователем. Ошибки API вместо этого вызывают

2769срабатывает [StopFailure](#stopfailure).2770[StopFailure](#stopfailure).

2770 2771

2771<Tip>2772<Tip>

2772 Команда [`/goal`](/docs/ru/goal) — встроенный ярлык для хука Stop на основе промпта с областью действия сессии. Используйте её, когда хотите, чтобы Claude продолжал работать над достижением условия, без написания конфигурации хука.2773 Команда [`/goal`](/docs/ru/goal) — это встроенное сокращение для хука Stop на основе промпта, действующего в рамках сессии. Используйте её, когда хотите, чтобы Claude продолжал работать до выполнения условия, не создавая конфигурацию хука.

2773</Tip>2774</Tip>

2774 2775

2775<h4 id="stop-input">2776<h4 id="stop-input">

2780 2781

2781Claude Code применяет ограничение в 8 последовательных продолжений: после того как хуки остановки продолжили ход восемь раз подряд, Claude Code переопределяет следующую блокировку и завершает ход. Счётчик последовательных продолжений сбрасывается каждый раз, когда Claude вызывает инструмент. Чтобы повысить ограничение, задайте [`CLAUDE_CODE_STOP_HOOK_BLOCK_CAP`](/docs/ru/env-vars).2782Claude Code применяет ограничение в 8 последовательных продолжений: после того как хуки остановки продолжили ход восемь раз подряд, Claude Code переопределяет следующую блокировку и завершает ход. Счётчик последовательных продолжений сбрасывается каждый раз, когда Claude вызывает инструмент. Чтобы повысить ограничение, задайте [`CLAUDE_CODE_STOP_HOOK_BLOCK_CAP`](/docs/ru/env-vars).

2782 2783

2783Поле `last_assistant_message` содержит текстовое содержимое последнего ответа Claude, поэтому хуки могут получить к нему доступ без разбора файла транскрипта. Для хуков, которые действуют по только что завершённому ходу, например хуков чтения вслух или уведомлений, используйте это поле, а не чтение `transcript_path`: не во всех версиях гарантируется, что файл транскрипта содержит последнее сообщение в момент Stop.2784Поле `last_assistant_message` содержит текстовое содержимое финального ответа Claude, поэтому хуки могут получить к нему доступ без разбора файла транскрипта. Для хуков, работающих с только что завершённым ходом, например хуков чтения вслух или уведомлений, используйте это поле, а не чтение `transcript_path`: не во всех версиях гарантируется, что файл транскрипта содержит финальное сообщение в момент Stop.

2784 2785

2785Массивы `background_tasks` и `session_crons` позволяют хукам отличать «сессия завершена» от «сессия приостановлена в ожидании, пока фоновая работа снова её разбудит». Оба массива присутствуют, когда реестр задач доступен, и пусты, когда ничего не выполняется и не запланировано.2786Массивы `background_tasks` и `session_crons` позволяют хукам отличать ситуацию «сессия завершена» от ситуации «сессия приостановлена в ожидании фоновой работы, которая её снова разбудит». Оба массива присутствуют, когда реестр задач доступен, и пусты, когда ничего не выполняется и не запланировано.

2786 2787

2787Каждая запись в `background_tasks` описывает одну выполняющуюся задачу и использует следующие поля:2788Каждая запись в `background_tasks` описывает одну выполняемую задачу и использует следующие поля:

2788 2789

2789| Поле | Описание |2790| Поле | Описание |

2790| :- | :- |2791| :- | :- |

2791| `id` | Идентификатор задачи |2792| `id` | Идентификатор задачи |

2792| `type` | Понятная метка типа задачи, например `shell`, `subagent`, `monitor`, `workflow`, `teammate`, `cloud session` или `MCP task`. Каждая метка указывает, какая функция Claude Code создала задачу. Для нераспознанных типов используется необработанный дискриминант |2793| `type` | Понятная метка типа задачи, например `shell`, `subagent`, `monitor`, `workflow`, `teammate`, `cloud session` или `MCP task`. Каждая метка указывает, какая функция Claude Code создала задачу. Для нераспознанных типов используется исходный дискриминант |

2794| `description` | Произвольное текстовое описание, ограниченное 1000 символами, с маркером `… [+N chars]` внутри строки при обрезке |2795| `description` | Описание в свободной форме, ограниченное 1000 символами, с маркером `… [+N chars]` внутри строки при обрезке |

2800 2801

2801Каждая запись в `session_crons` описывает одно запланированное пробуждение с областью действия сессии, полученное из `CronCreate`, `ScheduleWakeup` и `/loop`:2802Каждая запись в `session_crons` описывает одно запланированное пробуждение в рамках сессии, полученное из `CronCreate`, `ScheduleWakeup` и `/loop`:

2802 2803

2803| Поле | Описание |2804| Поле | Описание |

2804| :- | :- |2805| :- | :- |

2805| `id` | Идентификатор cron-задачи |2806| `id` | Идентификатор задачи cron |

2807| `recurring` | `false` для однократных пробуждений, расписание которых задаёт одно время срабатывания, `true` для задач, которые срабатывают повторно при каждом совпадении |2808| `recurring` | `false` для одноразовых пробуждений, расписание которых задаёт одно время срабатывания, `true` для задач, срабатывающих повторно при каждом совпадении |

2809 2810

2810Этот пример показывает входные данные Stop с одной выполняющейся задачей оболочки и одним повторяющимся cron:2811В этом примере показаны входные данные Stop с одной выполняемой задачей оболочки и одним повторяющимся cron:

2811 2812

2812```json theme={null}2813```json theme={null}

2813{2814{

2842 Управление решениями Stop2843 Управление решениями Stop

2843</h4>2844</h4>

2844 2845

2845Хуки `Stop` и `SubagentStop` могут управлять тем, продолжает ли Claude работу. Помимо [полей вывода JSON](#json-output), доступных всем хукам, ваш скрипт хука может возвращать следующие поля, специфичные для события:2846Хуки `Stop` и `SubagentStop` могут управлять тем, продолжит ли Claude работу. Помимо [выходных полей JSON](#json-output), доступных всем хукам, ваш скрипт хука может возвращать следующие поля, специфичные для события:

2846 2847

2847| Поле | Описание |2848| Поле | Описание |

2848| :- | :- |2849| :- | :- |

2851| `hookSpecificOutput.additionalContext` | Обратная связь для Claude без ошибки. Диалог продолжается, чтобы Claude мог действовать на её основе, но, в отличие от `decision: "block"`, она отображается в транскрипте как обратная связь хука, а не как ошибка хука |2852| `hookSpecificOutput.additionalContext` | Обратная связь для Claude, не являющаяся ошибкой. Диалог продолжается, чтобы Claude мог на неё отреагировать, но, в отличие от `decision: "block"`, в транскрипте она отображается как обратная связь хука, а не как ошибка хука |

2852 2853

2853Хук, который блокирует с кодом выхода 2, обрабатывается так же, как `reason`: Claude получает сообщение stderr в качестве объяснения, почему он должен продолжить.2854Хук, который блокирует, завершаясь с кодом 2, обрабатывается так же, как `reason`: Claude получает сообщение из stderr в качестве пояснения, почему ему следует продолжить.

2854 2855

2855```json theme={null}2856```json theme={null}

2856{2857{

2874 StopFailure2875 StopFailure

2875</h3>2876</h3>

2876 2877

2877Запускается вместо [Stop](#stop), когда ход завершается из-за ошибки API. Claude Code игнорирует вывод и код выхода хука, за исключением [`terminalSequence`](#emit-terminal-notifications). Используйте его для записи сбоев в лог, отправки оповещений или выполнения действий по восстановлению, когда Claude не может завершить ответ из-за ограничений частоты запросов, проблем с аутентификацией или других ошибок API.2878Выполняется вместо [Stop](#stop), когда ход завершается из-за ошибки API. Claude Code игнорирует вывод и код выхода хука, за исключением [`terminalSequence`](#emit-terminal-notifications). Используйте его, чтобы логировать сбои, отправлять оповещения или выполнять действия по восстановлению, когда Claude не может завершить ответ из-за ограничений частоты запросов, проблем с аутентификацией или других ошибок API.

2878 2879

2879<h4 id="stopfailure-input">2880<h4 id="stopfailure-input">

2880 Входные данные StopFailure2881 Входные данные StopFailure

2886| :- | :- |2887| :- | :- |

2887| `error` | Тип ошибки: `rate_limit`, `overloaded`, `authentication_failed`, `oauth_org_not_allowed`, `account_on_hold`, `billing_error`, `invalid_request`, `model_not_found`, `server_error`, `max_output_tokens`, `cloud_credential_error` или `unknown` |2888| `error` | Тип ошибки: `rate_limit`, `overloaded`, `authentication_failed`, `oauth_org_not_allowed`, `account_on_hold`, `billing_error`, `invalid_request`, `model_not_found`, `server_error`, `max_output_tokens`, `cloud_credential_error` или `unknown` |

2889| `last_assistant_message` | Отображаемый текст ошибки, показанный в диалоге. В отличие от `Stop` и `SubagentStop`, где это поле содержит разговорный вывод Claude, для `StopFailure` оно содержит саму строку ошибки API, например `"API Error: Rate limit reached"` |2890| `last_assistant_message` | Отрисованный текст ошибки, показанный в диалоге. В отличие от `Stop` и `SubagentStop`, где это поле содержит разговорный вывод Claude, для `StopFailure` оно содержит саму строку ошибки API, например `"API Error: Rate limit reached"` |

2890 2891

2891```json theme={null}2892```json theme={null}

2892{2893{

2900}2901}

2901```2902```

2902 2903

2903Хуки StopFailure не имеют управления решениями. Они запускаются только для уведомлений и логирования.2904У хуков StopFailure нет управления решениями. Они выполняются только для уведомлений и логирования.

2904 2905

2905<h3 id="teammateidle">2906<h3 id="teammateidle">

2906 TeammateIdle2907 TeammateIdle

2907</h3>2908</h3>

2908 2909

2909Запускается, когда участник [команды агентов](/docs/ru/agent-teams) собирается перейти в режим простоя после завершения своего хода. Используйте его для применения контроля качества до того, как участник команды прекратит работу, например требуя прохождения проверок линтера или проверяя наличие выходных файлов.2910Выполняется, когда участник [команды агентов](/docs/ru/agent-teams) вот-вот перейдёт в режим простоя после завершения своего хода. Используйте его, чтобы обеспечивать контроль качества до того, как участник команды прекратит работу, например требовать прохождения проверок линтера или проверять наличие выходных файлов.

2910 2911

2911Хуки TeammateIdle не поддерживают matcher и срабатывают при каждом возникновении события.2912Хуки TeammateIdle не поддерживают matcher и срабатывают при каждом возникновении события.

2912 2913

2930 2931

2931| Поле | Описание |2932| Поле | Описание |

2932| :- | :- |2933| :- | :- |

2936| `agent_id` | В этом событии [общее входное поле](#common-input-fields) идентифицирует [внутрипроцессного участника команды](/docs/ru/agent-teams#choose-a-display-mode), который вот-вот перейдёт в режим простоя. Может отсутствовать. Требуется Claude Code v2.1.290 или новее |

2935 2937

2936<h4 id="teammateidle-decision-control">2938<h4 id="teammateidle-decision-control">

2937 Управление решениями TeammateIdle2939 Управление решениями TeammateIdle

2939 2941

2940Хуки TeammateIdle поддерживают два способа управления поведением участника команды:2942Хуки TeammateIdle поддерживают два способа управления поведением участника команды:

2941 2943

2942* **Код выхода 2**: участник команды получает сообщение stderr в качестве обратной связи и продолжает работу вместо перехода в режим простоя.2944* **Код выхода 2**: участник команды получает сообщение из stderr в качестве обратной связи и продолжает работу вместо перехода в режим простоя.

2943* **JSON `{"continue": false, "stopReason": "..."}`**: полностью останавливает участника команды, аналогично поведению хука `Stop`. `stopReason` показывается пользователю.2945* **JSON `{"continue": false, "stopReason": "..."}`**: полностью останавливает участника команды, аналогично поведению хука `Stop`. `stopReason` показывается пользователю.

2944 2946

2945Этот пример проверяет наличие артефакта сборки, прежде чем разрешить участнику команды перейти в режим простоя:2947В этом примере проверяется наличие артефакта сборки, прежде чем разрешить участнику команды перейти в режим простоя:

2946 2948

2947```bash theme={null}2949```bash theme={null}

2948#!/bin/bash2950#!/bin/bash

2959 ConfigChange2961 ConfigChange

2960</h3>2962</h3>

2961 2963

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

2963 2965

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

2965 2967

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

2967 2969

2975 2977

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

2977 2979

2978```json theme={null}2980```json theme={null}

2979{2981{

2997 Входные данные ConfigChange2999 Входные данные ConfigChange

2998</h4>3000</h4>

2999 3001

3000Помимо [общих входных полей](#common-input-fields), хуки ConfigChange получают `source` и, необязательно, `file_path`. Поле `source` указывает, какой тип конфигурации изменился, а `file_path` содержит путь к конкретному изменённому файлу.3002Помимо [общих входных полей](#common-input-fields), хуки ConfigChange получают `source` и, при наличии, `file_path`. Поле `source` указывает, какой тип конфигурации изменился, а `file_path` содержит путь к конкретному изменённому файлу.

3001 3003

3002```json theme={null}3004```json theme={null}

3003{3005{

3014 Управление решениями ConfigChange3016 Управление решениями ConfigChange

3015</h4>3017</h4>

3016 3018

3017Хуки ConfigChange могут блокировать вступление изменений конфигурации в силу. Используйте код выхода 2 или JSON-поле `decision`, чтобы предотвратить изменение. При блокировке новые настройки не применяются к работающей сессии.3019Хуки ConfigChange могут блокировать вступление изменений конфигурации в силу. Используйте код выхода 2 или JSON-поле `decision`, чтобы предотвратить изменение. При блокировке новые настройки не применяются к текущей сессии.

3018 3020

3019| Поле | Описание |3021| Поле | Описание |

3020| :- | :- |3022| :- | :- |

3028}3030}

3029```3031```

3030 3032

3031Изменения `policy_settings` нельзя заблокировать. Хуки по-прежнему срабатывают для источников `policy_settings`, когда изменяется файл управляемых настроек на компьютере, поэтому вы можете использовать их для записи этих правок в лог, но любое решение о блокировке игнорируется. Это гарантирует, что настройки, управляемые организацией, всегда вступают в силу. Claude Code не запускает хуки `ConfigChange`, когда [настройки, управляемые сервером](/docs/ru/server-managed-settings), поступают или обновляются.3033Изменения `policy_settings` нельзя заблокировать. Хуки по-прежнему срабатывают для источников `policy_settings`, когда изменяется файл управляемых настроек на компьютере, поэтому вы можете использовать их для записи этих изменений в журнал, но любое решение о блокировке игнорируется. Это гарантирует, что настройки, управляемые организацией, всегда вступают в силу. Claude Code не запускает хуки `ConfigChange`, когда [настройки, управляемые сервером](/docs/ru/server-managed-settings), поступают или обновляются.

3032 3034

3033Claude Code учитывает решение о блокировке из JSON-вывода хука ConfigChange и отбрасывает `systemMessage` и `continue`. Заблокированное изменение не выводит никакого сообщения ни вам, ни Claude, независимо от того, блокируете ли вы с помощью `reason` или через stderr с кодом выхода 2. Claude Code лишь записывает строку в лог отладки.3035Claude Code учитывает решение о блокировке из JSON-вывода хука ConfigChange и отбрасывает `systemMessage` и `continue`. Заблокированное изменение не выводит никакого сообщения ни вам, ни Claude, независимо от того, блокируете ли вы с помощью `reason` или через stderr с кодом выхода 2. Claude Code лишь записывает строку в отладочный лог.

3034 3036

3035<h3 id="cwdchanged">3037<h3 id="cwdchanged">

3036 CwdChanged3038 CwdChanged

3037</h3>3039</h3>

3038 3040

3039Запускается, когда shell-команда в основном диалоге изменяет рабочий каталог, например когда Claude выполняет команду `cd`. Используйте его для реакции на смену каталога: перезагрузки переменных окружения, активации инструментальных цепочек проекта или автоматического запуска скриптов настройки. Работает в паре с [FileChanged](#filechanged) для таких инструментов, как [direnv](https://direnv.net/), которые управляют окружением для каждого каталога.3041Выполняется, когда shell-команда в основном диалоге изменяет рабочий каталог, например когда Claude выполняет команду `cd`. Используйте его, чтобы реагировать на смену каталога: перезагружать переменные окружения, активировать наборы инструментов для конкретного проекта или автоматически запускать скрипты настройки. Работает в паре с [FileChanged](#filechanged) для таких инструментов, как [direnv](https://direnv.net/), которые управляют окружением для каждого каталога.

3040 3042

3041Хуки CwdChanged имеют доступ к [`CLAUDE_ENV_FILE`](#persist-environment-variables). Переменные, записанные в этот файл, сохраняются для последующих команд Bash до следующего события CwdChanged, когда Claude Code их очищает.3043Хуки CwdChanged имеют доступ к [`CLAUDE_ENV_FILE`](#persist-environment-variables). Переменные, записанные в этот файл, сохраняются для последующих команд Bash до следующего события CwdChanged, когда Claude Code их очищает.

3042 3044

3063 Вывод CwdChanged3065 Вывод CwdChanged

3064</h4>3066</h4>

3065 3067

3066Помимо [полей вывода JSON](#json-output), доступных всем хукам, хуки CwdChanged могут возвращать `watchPaths`, чтобы динамически задавать, за какими путями файлов следит [FileChanged](#filechanged):3068Помимо [выходных полей JSON](#json-output), доступных всем хукам, хуки CwdChanged могут возвращать `watchPaths`, чтобы динамически задавать, за какими путями к файлам следит [FileChanged](#filechanged):

3067 3069

3068| Поле | Описание |3070| Поле | Описание |

3069| :- | :- |3071| :- | :- |

3070| `watchPaths` | Массив абсолютных путей. Заменяет текущий динамический список наблюдения. Пути из вашей конфигурации `matcher` отслеживаются всегда. Возврат пустого массива очищает динамический список, что типично при входе в новый каталог |3072| `watchPaths` | Массив абсолютных путей. Заменяет текущий динамический список наблюдения. За путями из вашей конфигурации `matcher` наблюдение ведётся всегда. Возврат пустого массива очищает динамический список, что типично при входе в новый каталог |

3071 3073

3072Хуки CwdChanged не имеют управления решениями. Они не могут заблокировать смену каталога.3074У хуков CwdChanged нет управления решениями. Они не могут заблокировать смену каталога.

3073 3075

3074Claude Code считывает `watchPaths` и `systemMessage` из их JSON-вывода и отбрасывает `continue`. В интерактивных сессиях он показывает `systemMessage` как краткое уведомление в терминале. Сообщение не попадает в поток сообщений SDK.3076Claude Code считывает `watchPaths` и `systemMessage` из их JSON-вывода и отбрасывает `continue`. В интерактивных сессиях он показывает `systemMessage` как короткое уведомление в терминале. Сообщение не попадает в поток сообщений SDK.

3075 3077

3076<h3 id="directoryadded">3078<h3 id="directoryadded">

3077 DirectoryAdded3079 DirectoryAdded

3078</h3>3080</h3>

3079 3081

3080Запускается после того, как вы добавляете рабочий каталог в середине сессии командой `/add-dir` или после того, как клиент SDK добавляет его управляющим запросом `register_repo_root`. Используйте его для подготовки только что добавленного репозитория, например для установки его зависимостей.3082Выполняется после того, как вы добавляете рабочий каталог посреди сессии с помощью команды `/add-dir` или после того, как клиент SDK добавляет его с помощью управляющего запроса `register_repo_root`. Используйте его, чтобы подготовить только что добавленный репозиторий, например установить его зависимости.

3081 3083

3082Claude Code не вызывает это событие, когда:3084Claude Code не вызывает это событие, когда:

3083 3085

3084* Вы передаёте каталог с помощью флага запуска `--add-dir`; такие каталоги охватывает [SessionStart](#sessionstart)3086* Вы передаёте каталог с помощью флага запуска `--add-dir`; такие каталоги покрывает [SessionStart](#sessionstart)

3085* Вы добавляете каталог на вкладке Workspace в `/permissions`3087* Вы добавляете каталог на вкладке Workspace в `/permissions`

3086* Вы добавляете каталог, который уже является рабочим каталогом или находится внутри него3088* Вы добавляете каталог, который уже является рабочим каталогом или находится внутри него

3087 3089

3088Claude Code вызывает DirectoryAdded после обновления состояния песочницы и разрешений, поэтому инструменты в песочнице уже видят новый каталог, когда запускается ваш хук. Сами команды хуков выполняются вне песочницы.3090Claude Code вызывает DirectoryAdded после обновления состояния песочницы и разрешений, поэтому инструменты в песочнице уже видят новый каталог, когда запускается ваш хук. Сами команды хуков выполняются вне песочницы.

3089 3091

3090Claude Code не ждёт хук: добавление завершается немедленно, а хук выполняется в фоне со стандартным таймаутом 600 секунд.3092Claude Code не ждёт хук: добавление завершается немедленно, а хук выполняется в фоне с таймаутом по умолчанию 600 секунд.

3091 3093

3092Matcher фильтрует по способу добавления каталога:3094Matcher фильтрует по способу добавления каталога:

3093 3095

3094| Matcher | Когда срабатывает |3096| Matcher | Когда срабатывает |

3095| :- | :- |3097| :- | :- |

3098 3100

3099<h4 id="directoryadded-input">3101<h4 id="directoryadded-input">

3100 Входные данные DirectoryAdded3102 Входные данные DirectoryAdded

3118}3120}

3119```3121```

3120 3122

3121Хуки DirectoryAdded не имеют управления решениями. Они не могут заблокировать добавление, которое уже завершено к моменту запуска хука. Claude Code отбрасывает поле `continue` из их JSON-вывода, а остальное обрабатывает по-разному в зависимости от источника:3123У хуков DirectoryAdded нет управления решениями. Они не могут заблокировать добавление, которое уже завершено к моменту запуска хука. Claude Code отбрасывает поле `continue` из их JSON-вывода, а остальное выводит по-разному в зависимости от источника:

3122 3124

3123* `slash_command`: Claude Code доставляет `systemMessage` хука Claude в качестве контекста на следующем ходе диалога, а не показывает его вам. Количество неудавшихся хуков отображается в транскрипте. Полный вывод сбоев записывается в лог отладки3125* `slash_command`: Claude Code передаёт `systemMessage` хука Claude в качестве контекста на следующем ходе диалога, а не показывает его вам. Количество неудавшихся хуков отображается в транскрипте. Полный вывод сбоев записывается в отладочный лог

3124* `register_repo_root`: Claude Code записывает вывод `systemMessage` и вывод сбоев только в лог отладки3126* `register_repo_root`: Claude Code записывает вывод `systemMessage` и вывод сбоев только в отладочный лог

3125 3127

3126<h3 id="filechanged">3128<h3 id="filechanged">

3127 FileChanged3129 FileChanged

3128</h3>3130</h3>

3129 3131

3130Запускается, когда отслеживаемый файл изменяется на диске. Claude Code обнаруживает изменения с помощью наблюдателя файловой системы, а не путём анализа вызовов инструментов, поэтому он запускает хук независимо от того, что изменило файл: вызов инструмента `Edit` или `Write`, скрипт, который Claude запускает через `Bash`, или процесс полностью вне Claude Code. Типичное применение — перезагрузка переменных окружения при изменении файлов конфигурации проекта.3132Выполняется, когда отслеживаемый файл изменяется на диске. Claude Code обнаруживает изменения с помощью наблюдателя файловой системы, а не путём проверки вызовов инструментов, поэтому он запускает хук независимо от того, что изменило файл: вызов инструмента `Edit` или `Write`, скрипт, который Claude запускает с помощью `Bash`, или процесс полностью вне Claude Code. Типичное применение — перезагрузка переменных окружения при изменении файлов конфигурации проекта.

3131 3133

3132`matcher` для этого события выполняет две роли:3134`matcher` для этого события выполняет две роли:

3133 3135

3134* **Построение списка наблюдения**: значение разбивается по `|`, и каждый сегмент регистрируется как буквальное имя файла в рабочем каталоге, поэтому `".envrc|.env"` отслеживает ровно эти два файла. Шаблоны регулярных выражений здесь бесполезны: значение вроде `^\.env` будет отслеживать файл с буквальным именем `^\.env`.3136* **Построение списка наблюдения**: значение разбивается по `|`, и каждый сегмент регистрируется как буквальное имя файла в рабочем каталоге, поэтому `".envrc|.env"` отслеживает ровно эти два файла. Шаблоны регулярных выражений здесь бесполезны: значение вроде `^\.env` будет отслеживать файл с буквальным именем `^\.env`.

3135* **Фильтрация запускаемых хуков**: когда отслеживаемый файл изменяется, то же значение фильтрует, какие группы хуков запускаются, по стандартным [правилам matcher](#matcher-patterns) применительно к базовому имени изменённого файла.3137* **Фильтрация запускаемых хуков**: когда отслеживаемый файл изменяется, то же значение фильтрует, какие группы хуков запускаются, по стандартным [правилам matcher](#matcher-patterns) относительно базового имени изменённого файла.

3136 3138

3137Этот пример нормализует окончания строк в `data.csv` после любого изменения, включая перезапись файла командой `Bash` или внешним скриптом:3139В этом примере нормализуются окончания строк в `data.csv` после любого изменения, включая перезапись файла командой `Bash` или внешним скриптом:

3138 3140

3139```json theme={null}3141```json theme={null}

3140{3142{

3154}3156}

3155```3157```

3156 3158

3157Хук считывает абсолютный путь изменённого файла из поля `file_path` [входных данных JSON](#filechanged-input) в stdin. Его защитная проверка `grep` ищет то же, что удаляет `perl`, — CR в конце строки, поэтому запуск после нормализации завершается, не трогая файл. Менее строгая проверка приводит к бесконечному циклу, потому что `perl -i` перезаписывает файл, даже если ничего не заменяет, а Claude Code снова запускает хук после каждой перезаписи. Сохраните этот скрипт по пути `/path/to/normalize-line-endings.sh` и сделайте его исполняемым:3159Хук считывает абсолютный путь к изменённому файлу из поля `file_path` [входных данных JSON](#filechanged-input) в stdin. Его проверка с помощью `grep` ищет то же, что удаляет `perl`, — CR в конце строки, поэтому запуск после нормализации завершается, не трогая файл. Менее строгая проверка приводит к бесконечному циклу, потому что `perl -i` перезаписывает файл, даже если ничего не заменяет, а Claude Code снова запускает хук после каждой перезаписи. Сохраните этот скрипт в `/path/to/normalize-line-endings.sh` и сделайте его исполняемым:

3158 3160

3159```bash theme={null}3161```bash theme={null}

3160#!/bin/bash3162#!/bin/bash

3164fi3166fi

3165```3167```

3166 3168

3167Чтобы убедиться, что хук работает, попросите Claude добавить строку с CRLF в `data.csv` с помощью команды `Bash`. Claude Code запускает хук, и в итоге файл получает окончания строк LF.3169Чтобы убедиться, что хук работает, попросите Claude дописать строку с CRLF в `data.csv` с помощью команды `Bash`. Claude Code запустит хук, и в итоге файл будет содержать окончания строк LF.

3168 3170

3169Чтобы отслеживать файлы, которые нельзя назвать заранее, возвращайте [`watchPaths`](#filechanged-output) из хука для динамического обновления списка наблюдения. Claude Code запускает наблюдатель, только когда что-то указывает файл для наблюдения, поэтому заполните список группой FileChanged, matcher которой называет хотя бы один файл, или хуком [SessionStart](#sessionstart-decision-control) либо [CwdChanged](#cwdchanged), возвращающим `watchPaths`. Matcher по-прежнему фильтрует, какие группы хуков запускаются при изменении отслеживаемого файла, поэтому для группы, обрабатывающей динамические пути, опустите matcher — тогда он совпадает с каждым отслеживаемым файлом и ничего не добавляет в список наблюдения. Matcher `"*"` тоже совпадает с каждым файлом, но Claude Code регистрирует его в списке наблюдения как любое другое значение — как буквальный файл с именем `*`.3171Чтобы отслеживать файлы, которые нельзя назвать заранее, возвращайте из хука [`watchPaths`](#filechanged-output) для динамического обновления списка наблюдения. Claude Code запускает наблюдателя только тогда, когда что-то называет файл для отслеживания, поэтому заполните список группой FileChanged, matcher которой называет хотя бы один файл, или хуком [SessionStart](#sessionstart-decision-control) либо [CwdChanged](#cwdchanged), который возвращает `watchPaths`. Matcher по-прежнему фильтрует, какие группы хуков запускаются при изменении отслеживаемого файла, поэтому для группы, обрабатывающей динамические пути, опустите matcher: такой matcher соответствует каждому отслеживаемому файлу и ничего не добавляет в список наблюдения. Matcher `"*"` также соответствует каждому файлу, но Claude Code регистрирует его в списке наблюдения, как и любое другое значение, — как буквальный файл с именем `*`.

3170 3172

3171Хуки FileChanged имеют доступ к [`CLAUDE_ENV_FILE`](#persist-environment-variables). Переменные, записанные в этот файл, сохраняются для последующих команд Bash до следующего события [CwdChanged](#cwdchanged), когда Claude Code их очищает.3173Хуки FileChanged имеют доступ к [`CLAUDE_ENV_FILE`](#persist-environment-variables). Переменные, записанные в этот файл, сохраняются для последующих команд Bash до следующего события [CwdChanged](#cwdchanged), когда Claude Code их очищает.

3172 3174

3196 Вывод FileChanged3198 Вывод FileChanged

3197</h4>3199</h4>

3198 3200

3199Помимо [полей вывода JSON](#json-output), доступных всем хукам, хуки FileChanged могут возвращать `watchPaths`, чтобы динамически обновлять отслеживаемые пути файлов:3201Помимо [выходных полей JSON](#json-output), доступных всем хукам, хуки FileChanged могут возвращать `watchPaths`, чтобы динамически обновлять, за какими путями к файлам ведётся наблюдение:

3200 3202

3201| Поле | Описание |3203| Поле | Описание |

3202| :- | :- |3204| :- | :- |

3203| `watchPaths` | Массив абсолютных путей. Заменяет текущий динамический список наблюдения. Пути из вашей конфигурации `matcher` отслеживаются всегда. Используйте это, когда ваш скрипт хука обнаруживает дополнительные файлы для наблюдения на основе изменённого файла |3205| `watchPaths` | Массив абсолютных путей. Заменяет текущий динамический список наблюдения. За путями из вашей конфигурации `matcher` наблюдение ведётся всегда. Используйте это, когда ваш скрипт хука обнаруживает дополнительные файлы для отслеживания на основе изменённого файла |

3204 3206

3205Хуки FileChanged не имеют управления решениями. Они не могут предотвратить изменение файла.3207У хуков FileChanged нет управления решениями. Они не могут предотвратить изменение файла.

3206 3208

3207Claude Code считывает `watchPaths` и `systemMessage` из их JSON-вывода и отбрасывает `continue`. В интерактивных сессиях он показывает `systemMessage` как краткое уведомление в терминале. Сообщение не попадает в поток сообщений SDK.3209Claude Code считывает `watchPaths` и `systemMessage` из их JSON-вывода и отбрасывает `continue`. В интерактивных сессиях он показывает `systemMessage` как короткое уведомление в терминале. Сообщение не попадает в поток сообщений SDK.

3208 3210

3209<h3 id="worktreecreate">3211<h3 id="worktreecreate">

3210 WorktreeCreate3212 WorktreeCreate

3211</h3>3213</h3>

3212 3214

3213Запускается при создании worktree — будь то из `claude --worktree`, из [субагента, использующего `isolation: "worktree"`](/docs/ru/sub-agents#choose-the-subagent-scope), или для [фоновой сессии](/docs/ru/agent-view#how-file-edits-are-isolated), которую Claude Code изолирует в собственном worktree. По умолчанию Claude Code создаёт изолированную рабочую копию с помощью `git worktree`. Настройка хука WorktreeCreate заменяет это стандартное поведение Git, позволяя использовать другую систему контроля версий, например SVN, Perforce или Mercurial.3215Запускается при создании worktree — будь то через `claude --worktree`, для [субагента, использующего `isolation: "worktree"`](/docs/ru/sub-agents#choose-the-subagent-scope), или для [фоновой сессии](/docs/ru/agent-view#how-file-edits-are-isolated), которую Claude Code изолирует в собственном worktree. По умолчанию Claude Code создаёт изолированную рабочую копию с помощью `git worktree`. Настройка хука WorktreeCreate заменяет это стандартное поведение Git, позволяя использовать другую систему контроля версий, например SVN, Perforce или Mercurial.

3214 3216

3215Поскольку хук полностью заменяет стандартное поведение, [`.worktreeinclude`](/docs/ru/worktrees#copy-gitignored-files-into-worktrees) не обрабатывается. Если вам нужно скопировать локальные файлы конфигурации, например `.env`, в новый worktree, сделайте это в своём скрипте хука.3217Поскольку хук полностью заменяет стандартное поведение, [`.worktreeinclude`](/docs/ru/worktrees#copy-gitignored-files-into-worktrees) не обрабатывается. Если вам нужно скопировать в новый worktree локальные файлы конфигурации, например `.env`, сделайте это внутри скрипта хука.

3216 3218

3217Хук должен вернуть путь к созданному каталогу worktree. Claude Code использует этот путь как рабочий каталог для изолированной сессии. О том, как каждый тип хука возвращает путь, см. в разделе [Вывод WorktreeCreate](#worktreecreate-output).3219Хук должен вернуть путь к каталогу созданного worktree. Claude Code использует этот путь как рабочий каталог изолированной сессии. О том, как каждый тип хука возвращает путь, см. в разделе [Вывод WorktreeCreate](#worktreecreate-output).

3218 3220

3219Claude Code учитывает успешность хука и возвращённый путь и отбрасывает `systemMessage` и `continue`.3221Claude Code учитывает успешность выполнения хука и возвращённый путь, а `systemMessage` и `continue` отбрасывает.

3220 3222

3221Этот пример создаёт рабочую копию SVN и выводит путь для использования Claude Code. Замените URL репозитория на свой:3223Этот пример создаёт рабочую копию SVN и выводит путь, который будет использовать Claude Code. Замените URL репозитория на свой:

3222 3224

3223```json theme={null}3225```json theme={null}

3224{3226{

3237}3239}

3238```3240```

3239 3241

3240Хук считывает `name` worktree из входных данных JSON в stdin, извлекает свежую копию в новый каталог и выводит путь к каталогу. `echo` в последней строке — это то, что Claude Code считывает как путь к worktree. Перенаправляйте любой другой вывод в stderr, чтобы он не мешал пути.3242Хук считывает `name` worktree из входных данных JSON в stdin, извлекает свежую копию в новый каталог и выводит путь к каталогу. Именно `echo` в последней строке Claude Code считывает как путь к worktree. Перенаправляйте любой другой вывод в stderr, чтобы он не мешал пути.

3241 3243

3242<h4 id="worktreecreate-input">3244<h4 id="worktreecreate-input">

3243 Входные данные WorktreeCreate3245 Входные данные WorktreeCreate

3244</h4>3246</h4>

3245 3247

3246Помимо [общих входных полей](#common-input-fields), хуки WorktreeCreate получают поле `name`. Это идентификатор-слаг для нового worktree, заданный пользователем или сгенерированный автоматически, например `bold-oak-a3f2`.3248Помимо [общих входных полей](#common-input-fields), хуки WorktreeCreate получают поле `name`. Это идентификатор-слаг нового worktree, заданный пользователем или сгенерированный автоматически, например `bold-oak-a3f2`.

3247 3249

3248```json theme={null}3250```json theme={null}

3249{3251{

3259 Вывод WorktreeCreate3261 Вывод WorktreeCreate

3260</h4>3262</h4>

3261 3263

3262Хуки WorktreeCreate не используют стандартную модель решений allow/block. Вместо этого результат определяется успехом или неудачей хука. Хук должен вернуть путь к созданному каталогу worktree:3264Хуки WorktreeCreate не используют стандартную модель решений «разрешить/заблокировать». Вместо этого результат определяется успехом или неудачей хука. Хук должен вернуть путь к каталогу созданного worktree:

3263 3265

3264* **Командные хуки** (`type: "command"`): выведите путь последней непустой строкой stdout. Claude Code удаляет escape-последовательности ANSI перед чтением этой строки, поэтому баннеры запуска оболочки, выведенные до вашего `echo`, игнорируются. Перенаправляйте любой другой вывод хука в stderr.3266* **Командные хуки** (`type: "command"`): выведите путь последней непустой строкой stdout. Claude Code удаляет управляющие последовательности ANSI перед чтением этой строки, поэтому баннеры запуска оболочки, выведенные до вашего `echo`, игнорируются. Перенаправляйте любой другой вывод хука в stderr.

3265* **HTTP-хуки** (`type: "http"`): верните `{ "hookSpecificOutput": { "hookEventName": "WorktreeCreate", "worktreePath": "/absolute/path" } }` в теле ответа.3267* **HTTP-хуки** (`type: "http"`): верните `{ "hookSpecificOutput": { "hookEventName": "WorktreeCreate", "worktreePath": "/absolute/path" } }` в теле ответа.

3266 3268

3267Если хук завершается с ошибкой или не возвращает путь, создание worktree завершается ошибкой.3269Если хук завершается с ошибкой или не выдаёт путь, создание worktree завершается ошибкой.

3268 3270

3269Claude Code разрешает относительный путь относительно каталога, в котором выполнялся хук, сворачивая все сегменты `.` или `..` в нём. Если полученный путь не является каталогом, в который Claude Code может перейти, сессия выводит ошибку с указанием пути и завершается с кодом 1.3271Claude Code разрешает относительный путь относительно каталога, в котором выполнялся хук, сворачивая в нём любые сегменты `.` или `..`. Если полученный путь не является каталогом, в который Claude Code может перейти, сессия выводит ошибку с указанием пути и завершается с кодом выхода 1.

3270 3272

3271Claude Code отклоняет абсолютный путь, содержащий сегменты `.` или `..`, а также любой путь, проходящий через символическую ссылку ниже корня репозитория, поскольку символическая ссылка, закоммиченная в репозиторий, могла бы перенаправить worktree за его пределы. В ошибке указывается отклонённый компонент. Возвращайте нормализованный путь, который не проходит через символическую ссылку внутри репозитория. До v2.1.216 создание worktree следовало по пути хука без этой проверки.3273Claude Code отклоняет абсолютный путь, содержащий сегменты `.` или `..`, а также любой путь, проходящий через символическую ссылку ниже корня репозитория, поскольку символическая ссылка, закоммиченная в репозиторий, может перенаправить worktree за его пределы. В ошибке указывается отклонённый компонент. Возвращайте нормализованный путь, который не проходит через символическую ссылку внутри репозитория. До v2.1.216 создание worktree следовало пути хука без такой проверки.

3272 3274

3273<h3 id="worktreeremove">3275<h3 id="worktreeremove">

3274 WorktreeRemove3276 WorktreeRemove

3275</h3>3277</h3>

3276 3278

3277Выполняется, когда Claude Code удаляет worktree, созданный вашим хуком [`WorktreeCreate`](#worktreecreate). Событие срабатывает, когда:3279Запускается, когда Claude Code очищает worktree, созданный вашим хуком [`WorktreeCreate`](#worktreecreate). Событие срабатывает, когда:

3278 3280

3279* Вы выходите из интерактивной [сессии worktree](/docs/ru/worktrees#start-claude-in-a-worktree) и выбираете удаление worktree, когда Claude Code предлагает это сделать3281* Вы выходите из интерактивной [сессии в worktree](/docs/ru/worktrees#start-claude-in-a-worktree) и соглашаетесь удалить worktree, когда Claude Code спрашивает об этом

3280* Вы выходите из интерактивной сессии worktree, которой не [присвоили имя](/docs/ru/sessions#name-your-sessions), Claude Code не находит изменённых или неотслеживаемых файлов и удаляет worktree без запроса3282* Вы выходите из интерактивной сессии в worktree, которой не [дали имя](/docs/ru/sessions#name-your-sessions), Claude Code не находит изменённых или неотслеживаемых файлов и удаляет worktree, не спрашивая вас

3281* Вы удаляете [фоновую сессию](/docs/ru/agent-view#what-deleting-a-session-removes), которая работает в этом worktree3283* Вы удаляете [фоновую сессию](/docs/ru/agent-view#what-deleting-a-session-removes), которая работает в этом worktree

3282 3284

3283Claude Code использует git для поиска изменённых или неотслеживаемых файлов, поэтому не находит их в worktree, который не является git checkout и не находится внутри него, даже если в каталоге есть незакоммиченная работа. Проверяйте наличие такой работы в вашем хуке WorktreeRemove, прежде чем он что-либо удалит.3285Claude Code ищет изменённые или неотслеживаемые файлы с помощью Git, поэтому не находит их в worktree, который не является Git-checkout и не находится внутри него, даже если в каталоге есть незакоммиченная работа. Проверяйте наличие такой работы в хуке WorktreeRemove, прежде чем он что-либо удалит.

3284 3286

3285Для worktree на основе git Claude Code выполняет очистку автоматически с помощью `git worktree remove`. Если вы настроили хук WorktreeCreate, добавьте к нему хук WorktreeRemove, чтобы управлять очисткой создаваемых им worktree:3287Для worktree на основе Git Claude Code выполняет очистку автоматически с помощью `git worktree remove`. Если вы настроили хук WorktreeCreate, используйте вместе с ним хук WorktreeRemove, чтобы управлять очисткой создаваемых им worktree:

3286 3288

3287* **Нет хука WorktreeRemove**: когда Claude Code удаляет worktree при выходе из сессии worktree, он использует как резервный вариант `git worktree remove --force` для пути, возвращённого вашим хуком WorktreeCreate, поэтому worktree, распознаваемый git, удаляется. Worktree, который git не распознаёт, например созданный вашим хуком с помощью системы контроля версий, отличной от git, остаётся на диске. О том, что происходит с созданным хуком worktree при удалении [фоновой сессии](/docs/ru/agent-view#what-deleting-a-session-removes), см. правила удаления в agent view.3289* **Нет хука WorktreeRemove**: когда Claude Code удаляет worktree при выходе из сессии в worktree, в качестве резервного варианта он выполняет `git worktree remove --force` для пути, возвращённого вашим хуком WorktreeCreate, поэтому worktree, который распознаёт Git, удаляется. Worktree, который Git не распознаёт, например созданный вашим хуком с помощью системы контроля версий, отличной от Git, остаётся на диске. О том, что удаление [фоновой сессии](/docs/ru/agent-view#what-deleting-a-session-removes) делает с worktree, созданным хуком, см. правила удаления в agent view.

3288* **Хук завершается с кодом 0**: worktree считается удалённым. Claude Code больше ничего не читает из хука, поэтому убедитесь, что ваш хук удалил каталог.3290* **Хук завершается с кодом 0**: worktree считается удалённым. Claude Code больше ничего не считывает из хука, поэтому убедитесь, что ваш хук удалил каталог.

3289* **Хук завершается с ненулевым кодом**: удаление завершается ошибкой, если каталог по пути `worktree_path` после этого всё ещё существует, и worktree остаётся на диске без резервного варианта через git. Хук, удаливший каталог перед завершением с ненулевым кодом, считается выполнившим удаление. О том, как сообщается об ошибке, см. [Входные данные WorktreeRemove](#worktreeremove-input).3291* **Хук завершается с ненулевым кодом**: удаление завершается неудачей, если каталог по пути `worktree_path` после этого всё ещё существует, и worktree остаётся на диске без резервного варианта через Git. Хук, который удалил каталог перед завершением с ненулевым кодом, считается успешно удалившим worktree. О том, как сообщается об ошибке, см. в разделе [Входные данные WorktreeRemove](#worktreeremove-input).

3290 3292

3291Claude Code никогда не удаляет ветку, принадлежащую созданному хуком worktree, поскольку ему известен только путь, который вернул ваш хук WorktreeCreate. Если ваш хук WorktreeCreate создаёт ветку, удаляйте её в хуке WorktreeRemove.3293Claude Code никогда не удаляет ветку, принадлежащую worktree, созданному хуком, поскольку знает только путь, возвращённый вашим хуком WorktreeCreate. Если ваш хук WorktreeCreate создаёт ветку, удаляйте её в хуке WorktreeRemove.

3292 3294

3293Claude Code отбрасывает [поля JSON-вывода](#json-output) хука WorktreeRemove, такие как `systemMessage` и `continue`.3295Claude Code отбрасывает [поля вывода JSON](#json-output) хука WorktreeRemove, такие как `systemMessage` и `continue`.

3294 3296

3295При удалении фоновой сессии Claude Code проверяет сохранённый путь worktree перед запуском хука и отклоняет путь, который является символической ссылкой или проходит через неё ниже корня репозитория. Для worktree, который всё ещё содержит файлы, хук выполняется только тогда, когда вы подтверждаете удаление в [agent view](/docs/ru/agent-view#what-deleting-a-session-removes); для такого worktree [`claude rm`](/docs/ru/agent-view#manage-sessions-from-the-shell) вместо этого сохраняет сессию и worktree. До v2.1.216 хук выполнялся для сохранённого пути без этих проверок.3297При удалении фоновой сессии Claude Code проверяет сохранённый путь worktree перед запуском хука и отклоняет путь, который является символической ссылкой или проходит через неё ниже корня репозитория. Для worktree, который всё ещё содержит файлы, хук запускается только при подтверждении удаления в [agent view](/docs/ru/agent-view#what-deleting-a-session-removes); для такого worktree [`claude rm`](/docs/ru/agent-view#manage-sessions-from-the-shell) вместо этого сохраняет сессию и worktree. До v2.1.216 хук запускался для сохранённого пути без этих проверок.

3296 3298

3297Claude Code передаёт путь, возвращённый WorktreeCreate, как `worktree_path` во входных данных хука. Этот пример считывает этот путь и удаляет каталог:3299Claude Code передаёт путь, возвращённый WorktreeCreate, как `worktree_path` во входных данных хука. Этот пример считывает этот путь и удаляет каталог:

3298 3300

3317 Входные данные WorktreeRemove3319 Входные данные WorktreeRemove

3318</h4>3320</h4>

3319 3321

3320Помимо [общих полей входных данных](#common-input-fields), хуки WorktreeRemove получают поле `worktree_path` — абсолютный путь к удаляемому worktree.3322Помимо [общих входных полей](#common-input-fields), хуки WorktreeRemove получают поле `worktree_path` — абсолютный путь к удаляемому worktree.

3321 3323

3322```json theme={null}3324```json theme={null}

3323{3325{

3329}3331}

3330```3332```

3331 3333

3332Результат определяется кодом выхода хука WorktreeRemove. Когда хук завершается с ненулевым кодом и каталог по пути `worktree_path` после этого всё ещё существует, удаление завершается ошибкой:3334Результат определяется кодом выхода хука WorktreeRemove. Когда хук завершается с ненулевым кодом и каталог по пути `worktree_path` после этого всё ещё существует, удаление завершается неудачей:

3333 3335

3334* Worktree остаётся на диске, а команда хука и stderr записываются в [отладочный лог](#debug-hooks).3336* Worktree остаётся на диске, а команда хука и его stderr попадают в [лог отладки](#debug-hooks).

3335* Если вы удаляли фоновую сессию, сессия тоже сохраняется. Сообщение об отказе в [agent view](/docs/ru/agent-view#what-deleting-a-session-removes) сообщает, как завершился хук, например `exited 1`, цитирует начало его stderr и указывает, удалит ли повторное удаление сессии каталог в любом случае.3337* Если вы удаляли фоновую сессию, сессия тоже остаётся. Сообщение об отказе в [agent view](/docs/ru/agent-view#what-deleting-a-session-removes) сообщает, как завершился хук, например `exited 1`, цитирует начало его stderr и указывает, удалит ли повторное удаление сессии каталог в любом случае.

3336 3338

3337<h3 id="precompact">3339<h3 id="precompact">

3338 PreCompact3340 PreCompact

3339</h3>3341</h3>

3340 3342

3341Выполняется перед тем, как Claude Code собирается выполнить операцию сжатия контекста.3343Запускается перед тем, как Claude Code выполнит операцию сжатия контекста.

3342 3344

3343Значение matcher указывает, было ли сжатие запущено вручную или автоматически:3345Значение matcher указывает, было ли сжатие запущено вручную или автоматически:

3344 3346

3349 3351

3350Завершитесь с кодом 2, чтобы заблокировать сжатие. Для ручного `/compact` сообщение stderr показывается пользователю. Также можно заблокировать, вернув JSON с `"decision": "block"`.3352Завершитесь с кодом 2, чтобы заблокировать сжатие. Для ручного `/compact` сообщение из stderr показывается пользователю. Также можно заблокировать сжатие, вернув JSON с `"decision": "block"`.

3351 3353

3352Блокировка автоматического сжатия даёт разный эффект в зависимости от того, когда она срабатывает. Если сжатие было запущено упреждающе до достижения лимита контекста, Claude Code пропускает его, и диалог продолжается без сжатия. Если сжатие было запущено для восстановления после ошибки лимита контекста, уже возвращённой API, исходная ошибка отображается, и текущий запрос завершается неудачей.3354Блокировка автоматического сжатия действует по-разному в зависимости от момента срабатывания. Если сжатие было запущено заранее, до достижения лимита контекста, Claude Code пропускает его, и диалог продолжается без сжатия. Если сжатие было запущено для восстановления после ошибки лимита контекста, уже возвращённой API, исходная ошибка отображается, и текущий запрос завершается неудачей.

3353 3355

3354Claude Code отбрасывает поля `systemMessage` и `continue` хука PreCompact.3356Claude Code отбрасывает поля `systemMessage` и `continue` хука PreCompact.

3355 3357

3357 Входные данные PreCompact3359 Входные данные PreCompact

3358</h4>3360</h4>

3359 3361

3360Помимо [общих полей входных данных](#common-input-fields), хуки PreCompact получают `trigger` и `custom_instructions`. Для `manual` поле `custom_instructions` содержит то, что пользователь передаёт в `/compact`, и равно `null`, если он ничего не передаёт. Для `auto` поле `custom_instructions` равно `null`.3362Помимо [общих входных полей](#common-input-fields), хуки PreCompact получают `trigger` и `custom_instructions`. Для `manual` поле `custom_instructions` содержит то, что пользователь передаёт в `/compact`, и равно `null`, если он ничего не передаёт. Для `auto` поле `custom_instructions` равно `null`.

3361 3363

3362```json theme={null}3364```json theme={null}

3363{3365{

3374 PostCompact3376 PostCompact

3375</h3>3377</h3>

3376 3378

3377Выполняется после того, как Claude Code завершает операцию сжатия контекста. Используйте это событие, чтобы реагировать на новое сжатое состояние, например записывать в лог сгенерированную сводку или обновлять внешнее состояние. Claude Code отбрасывает поля `systemMessage` и `continue` хука PostCompact.3379Запускается после того, как Claude Code завершает операцию сжатия контекста. Используйте это событие, чтобы реагировать на новое сжатое состояние, например чтобы записать сгенерированную сводку в лог или обновить внешнее состояние. Claude Code отбрасывает поля `systemMessage` и `continue` хука PostCompact.

3378 3380

3379Применяются те же значения matcher, что и для `PreCompact`:3381Применяются те же значения matcher, что и для `PreCompact`:

3380 3382

3387 Входные данные PostCompact3389 Входные данные PostCompact

3388</h4>3390</h4>

3389 3391

3390Помимо [общих полей входных данных](#common-input-fields), хуки PostCompact получают `trigger` и `compact_summary`. Поле `compact_summary` содержит сводку диалога, сгенерированную операцией сжатия.3392Помимо [общих входных полей](#common-input-fields), хуки PostCompact получают `trigger` и `compact_summary`. Поле `compact_summary` содержит сводку диалога, сгенерированную операцией сжатия.

3391 3393

3392```json theme={null}3394```json theme={null}

3393{3395{

3400}3402}

3401```3403```

3402 3404

3403Хуки PostCompact не имеют управления решениями. Они не могут повлиять на результат сжатия, но могут выполнять последующие задачи.3405Хуки PostCompact не управляют решениями. Они не могут повлиять на результат сжатия, но могут выполнять последующие задачи.

3404 3406

3405<h3 id="premodelswitch">3407<h3 id="premodelswitch">

3406 PreModelSwitch3408 PreModelSwitch

3407</h3>3409</h3>

3408 3410

3409Выполняется перед тем, как Claude Code применяет переключение модели, запрошенное вами или клиентом. Используйте его, чтобы заблокировать переключение, потребовать подтверждения или показать, во что обойдётся переключение, до того как оно произойдёт.3411Запускается до того, как Claude Code применит смену модели, запрошенную вами или клиентом. Используйте его, чтобы заблокировать смену, потребовать подтверждения или показать, во что обойдётся смена, до того как она произойдёт.

3410 3412

3411PreModelSwitch требует Claude Code v2.1.251 или новее. Claude Code запускает его для следующих запросов:3413PreModelSwitch требует Claude Code v2.1.251 или новее. Claude Code запускает его для следующих запросов:

3412 3414

3413* `/model <name>` и средство выбора `/model`3415* `/model <name>` и окно выбора `/model`

3414* Средство выбора модели `Option+P` или `Alt+P`3416* Окно выбора модели `Option+P` или `Alt+P`

3415* Настройка Model в `/config`3417* Настройка Model в `/config`

3416* Включение [быстрого режима](/docs/ru/fast-mode), если это меняет модель сессии3418* Включение [быстрого режима](/docs/ru/fast-mode), когда это меняет модель сессии

3417* Запрос `set_model` или смена модели в запросе `apply_flag_settings` от хоста [Agent SDK](/docs/ru/agent-sdk/typescript#query-object) или [Remote Control](/docs/ru/remote-control)3419* Запрос `set_model` или смена модели в запросе `apply_flag_settings` от хоста [Agent SDK](/docs/ru/agent-sdk/typescript#query-object) или [Remote Control](/docs/ru/remote-control)

3418 3420

3419Claude Code не запускает хуки PreModelSwitch для переключений, которые он выполняет самостоятельно, например при [автоматическом переключении на резервную модель](/docs/ru/model-config#automatic-model-fallback) или восстановлении модели при возобновлении сессии. Такие изменения доходят только до [PostModelSwitch](#postmodelswitch).3421Claude Code не запускает хуки PreModelSwitch для смен, которые выполняет самостоятельно, например при [автоматическом переключении на резервную модель](/docs/ru/model-config#automatic-model-fallback) или восстановлении модели при возобновлении сессии. Такие изменения доходят только до [PostModelSwitch](#postmodelswitch).

3420 3422

3421Claude Code сравнивает matcher с каноническим именем модели, на которую переключается сессия, игнорируя суффикс `[1m]`. Псевдоним, например `opus`, идентификатор модели с датой и идентификатор конкретного провайдера, например идентификатор модели Amazon Bedrock, — все соответствуют одному каноническому имени, в которое они разрешаются, поэтому `claude-opus-5` охватывает любое написание Opus 5.3423Claude Code сравнивает matcher с каноническим именем модели, на которую переключается сессия, игнорируя суффикс `[1m]`. Псевдоним, например `opus`, идентификатор модели с датой и идентификатор конкретного провайдера, например идентификатор модели Amazon Bedrock, — все соответствуют одному каноническому имени, к которому они разрешаются, поэтому `claude-opus-5` охватывает все варианты написания Opus 5.

3422 3424

3423Когда Claude Code не может определить каноническое имя целевой модели, например для пользовательского идентификатора модели, известного только вашему [LLM-шлюзу](/docs/ru/llm-gateway), он запускает каждый хук PreModelSwitch независимо от matcher. Поэтому блокирующий хук должен проверять `to_model` из своих входных данных, а не полагаться только на matcher.3425Когда Claude Code не может определить каноническое имя целевой модели, например для пользовательского идентификатора модели, который знает только ваш [LLM-шлюз](/docs/ru/llm-gateway), он запускает все хуки PreModelSwitch независимо от matcher. Поэтому блокирующий хук должен проверять `to_model` из своих входных данных, а не полагаться только на matcher.

3424 3426

3425Записывайте matcher как точное имя, список через `|`, например `claude-opus-4-6|claude-opus-5`, или регулярное выражение, например `.*opus.*`. Этот пример использует matcher с точным именем и также проверяет `to_model` из входных данных хука, поэтому он отклоняет переключение на Opus 4.6, завершаясь с кодом 2, и пропускает любую другую целевую модель:3427Записывайте matcher как точное имя, список через `|`, например `claude-opus-4-6|claude-opus-5`, или регулярное выражение, например `.*opus.*`. В этом примере используется matcher с точным именем, а также проверяется `to_model` из входных данных хука, поэтому он отклоняет переключение на Opus 4.6, завершаясь с кодом 2, и пропускает любую другую целевую модель:

3426 3428

3427<Tabs>3429<Tabs>

3428 <Tab title="macOS/Linux">3430 <Tab title="macOS/Linux">

3475 }3477 }

3476 ```3478 ```

3477 3479

3478 Сохраните этот скрипт в `.claude/hooks/block-opus-46.ps1` в вашем проекте:3480 Сохраните этот скрипт в файл `.claude/hooks/block-opus-46.ps1` в вашем проекте:

3479 3481

3480 ```powershell theme={null}3482 ```powershell theme={null}

3481 $hookInput = [Console]::In.ReadToEnd() | ConvertFrom-Json3483 $hookInput = [Console]::In.ReadToEnd() | ConvertFrom-Json

3488 </Tab>3490 </Tab>

3489</Tabs>3491</Tabs>

3490 3492

3491Чтобы убедиться, что хук работает, выполните `/model claude-opus-4-6` из сессии, использующей другую модель. Claude Code сохраняет текущую модель и сообщает, что хук PreModelSwitch заблокировал переключение, указывая ваше сообщение в качестве причины.3493Чтобы убедиться, что хук работает, выполните `/model claude-opus-4-6` в сессии, использующей другую модель. Claude Code сохранит текущую модель и сообщит, что хук PreModelSwitch заблокировал смену, указав ваше сообщение в качестве причины.

3492 3494

3493<h4 id="premodelswitch-input">3495<h4 id="premodelswitch-input">

3494 Входные данные PreModelSwitch3496 Входные данные PreModelSwitch

3495</h4>3497</h4>

3496 3498

3497Помимо [общих полей входных данных](#common-input-fields), хуки PreModelSwitch получают поля из этой таблицы. Последние пять описывают стоимость повторной отправки диалога новой модели, чтобы хук мог показать эту сумму до переключения.3499Помимо [общих входных полей](#common-input-fields), хуки PreModelSwitch получают поля из этой таблицы. Последние пять описывают стоимость повторной отправки диалога новой модели, чтобы хук мог показать эту сумму до смены.

3498 3500

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

3500| :- | :- | :- |3502| :- | :- | :- |

3503| `requested_model` | string или `null` | Модель, указанная в запросе: псевдоним, например `opus`, полный идентификатор модели или `null`, если запрос был для модели по умолчанию |3505| `requested_model` | string или `null` | Модель, указанная в запросе: псевдоним, например `opus`, полный идентификатор модели или `null`, если запрос был на модель по умолчанию |

3504| `source` | string | Откуда пришёл запрос: `"command"` для `/model <name>`, настройки Model в `/config` или включения быстрого режима; `"picker"` для средства выбора модели; `"sdk"` для запроса `set_model` или смены модели в запросе `apply_flag_settings` от хоста Agent SDK или Remote Control |3506| `source` | string | Откуда пришёл запрос: `"command"` для `/model <name>`, настройки Model в `/config` или включения быстрого режима; `"picker"` для окна выбора модели; `"sdk"` для запроса `set_model` или смены модели в запросе `apply_flag_settings` от хоста Agent SDK или Remote Control |

3505| `context_tokens` | number | Токены, которые следующий запрос повторно отправляет в качестве промпта: суммарно входные токены, токены чтения кэша, создания кэша и выходные токены последнего ответа в основном диалоге. `0` до первого ответа |3507| `context_tokens` | number | Токены, которые следующий запрос повторно отправит в качестве промпта: сумма входных токенов, токенов чтения кэша, создания кэша и выходных токенов последнего ответа в основном диалоге. `0` до первого ответа |

3508| `estimated_cache_write_usd` | number | Оценочная стоимость в долларах США записи `context_tokens` в кэш промптов на `to_model` по тарифу `cache_ttl`, без учёта следующего ответа. Серверу может не потребоваться повторно кэшировать весь контекст, поэтому рассматривайте это как оценку |3510| `estimated_cache_write_usd` | number | Оценочная стоимость в долларах США записи `context_tokens` в кэш промптов на `to_model` по тарифу `cache_ttl`, без учёта следующего ответа. Серверу может не понадобиться повторно кэшировать весь контекст, поэтому рассматривайте это значение как оценку |

3509| `pricing` | string | Как Claude Code рассчитал `estimated_cache_write_usd`: `"configured"` — по собственным тарифам вашей организации, если она их настроила, `"catalog"` — по прейскурантной цене, или `"default"`, если для `to_model` нет известной цены и Claude Code использовал тариф по умолчанию |3511| `pricing` | string | Как Claude Code рассчитал `estimated_cache_write_usd`: `"configured"` — по собственным тарифам вашей организации, если она их настроила, `"catalog"` — по прейскурантной цене, или `"default"`, когда цена `to_model` неизвестна и Claude Code принял тариф по умолчанию |

~~3510~~ 3512

3511Этот пример показывает входные данные для `/model opus` в сессии, использующей Sonnet 5:3513В этом примере показаны входные данные для `/model opus` в сессии, использующей Sonnet 5:

3512 3514

3513```json theme={null}3515```json theme={null}

3514{3516{

3532 Управление решениями PreModelSwitch3534 Управление решениями PreModelSwitch

3533</h4>3535</h4>

3534 3536

3535Хуки `PreModelSwitch` могут отменить переключение, попросить пользователя подтвердить его или разрешить его выполнение. Код выхода 2 или `decision: "block"` верхнего уровня отменяет переключение.3537Хуки `PreModelSwitch` могут отменить смену, попросить пользователя подтвердить её или позволить ей выполниться. Код выхода 2 или `decision: "block"` верхнего уровня отменяет смену.

3536 3538

3537Для более тонкого управления возвращайте `permissionDecision` и `permissionDecisionReason` в объекте `hookSpecificOutput`, как в [PreToolUse](#pretooluse-decision-control). `PreModelSwitch` принимает `"allow"`, `"deny"` и `"ask"`. Он не принимает `"defer"`, `updatedInput` или `additionalContext`. В таблице ниже описаны оба поля:3539Для более тонкого управления возвращайте `permissionDecision` и `permissionDecisionReason` в объекте `hookSpecificOutput`, как для [PreToolUse](#pretooluse-decision-control). `PreModelSwitch` принимает `"allow"`, `"deny"` и `"ask"`. Он не принимает `"defer"`, `updatedInput` или `additionalContext`. В таблице ниже описаны оба поля:

3538 3540

3539| Поле | Описание |3541| Поле | Описание |

3540| :- | :- |3542| :- | :- |

3541| `permissionDecision` | `"allow"` выполняет переключение и пропускает [подтверждение, которое Claude Code показывает, пока кэш промптов прогрет](/docs/ru/prompt-caching#switching-models). `"deny"` отменяет переключение. `"ask"` запрашивает у пользователя подтверждение |3543| `permissionDecision` | `"allow"` выполняет смену и пропускает [подтверждение, которое Claude Code показывает, пока кэш промптов «тёплый»](/docs/ru/prompt-caching#switching-models). `"deny"` отменяет смену. `"ask"` просит пользователя подтвердить её |

3542| `permissionDecisionReason` | Для `"deny"` показывается пользователю как причина блокировки переключения или возвращается как ошибка для запроса `set_model`. Для `"ask"` показывается в запросе подтверждения. Игнорируется для `"allow"` |3544| `permissionDecisionReason` | Для `"deny"` показывается пользователю как причина блокировки смены или возвращается как ошибка для запроса `set_model`. Для `"ask"` показывается в запросе подтверждения. Игнорируется для `"allow"` |

3543 3545

3544Только `/model` в интерактивной сессии может показать запрос `"ask"`. Во всех остальных интерфейсах, включая неинтерактивный режим с флагом `-p`, `/config` и запросы `set_model`, Claude Code рассматривает `"ask"` как отказ.3546Показать запрос `"ask"` может только `/model` в интерактивной сессии. На всех остальных интерфейсах, включая неинтерактивный режим с флагом `-p`, `/config` и запросы `set_model`, Claude Code рассматривает `"ask"` как отказ.

3545 3547

3546Этот пример просит пользователя подтвердить переключение и приводит количество токенов из `context_tokens`:3548Этот пример просит пользователя подтвердить смену и приводит количество токенов из `context_tokens`:

3547 3549

3548```json theme={null}3550```json theme={null}

3549{3551{

3557 3559

3558Когда несколько хуков PreModelSwitch возвращают разные решения, приоритет таков: `deny` > `ask` > `allow`.3560Когда несколько хуков PreModelSwitch возвращают разные решения, приоритет таков: `deny` > `ask` > `allow`.

3559 3561

3560Claude Code показывает пользователю любое `systemMessage`, которое возвращает ваш хук, независимо от решения, поэтому хук для отчёта о стоимости может вернуть `{"systemMessage": "..."}` и завершиться с кодом 0.3562Claude Code показывает пользователю любое `systemMessage`, возвращённое вашим хуком, независимо от решения, поэтому хук, сообщающий о стоимости, может вернуть `{"systemMessage": "..."}` и завершиться с кодом 0.

3561 3563

3562Хук PreModelSwitch, который не отвечает до истечения таймаута, блокирует переключение. В [PreToolUse](#timeouts), напротив, командный хук с истёкшим таймаутом позволяет вызову инструмента продолжиться. Таймаут по умолчанию для этого события — 30 секунд. `PreModelSwitch` запускает только хуки `command`, `http` и `mcp_tool`, поэтому значения по умолчанию для `prompt` и `agent` не применяются.3564Хук PreModelSwitch, который не ответил до истечения таймаута, блокирует смену. Для [PreToolUse](#timeouts), напротив, командный хук с истёкшим таймаутом позволяет вызову инструмента продолжиться. Таймаут по умолчанию для этого события — 30 секунд. `PreModelSwitch` запускает только хуки `command`, `http` и `mcp_tool`, поэтому значения по умолчанию для `prompt` и `agent` не применяются.

3563 3565

3564Хук, который завершается с кодом, отличным от 0 или 2, и не выводит JSON-решения, не блокирует переключение: Claude Code показывает его stderr и применяет переключение, как описано в разделе [Другие коды выхода](#other-exit-codes).3566Хук, который завершается с кодом, отличным от 0 или 2, и не выводит JSON-решение, не блокирует смену: Claude Code показывает его stderr и применяет смену, как описано в разделе [Другие коды выхода](#other-exit-codes).

3565 3567

3566<h3 id="postmodelswitch">3568<h3 id="postmodelswitch">

3567 PostModelSwitch3569 PostModelSwitch

3568</h3>3570</h3>

3569 3571

3570Выполняется после смены модели сессии. Используйте его, чтобы давать Claude указания, специфичные для модели, без редактирования каждого CLAUDE.md, например инструкцию для всей организации, которая применяется к определённым моделям.3572Запускается после смены модели сессии. Используйте его, чтобы давать Claude указания для конкретной модели, не редактируя каждый CLAUDE.md, например инструкцию для всей организации, действующую для определённых моделей.

3571 3573

3572PostModelSwitch требует Claude Code v2.1.251 или новее. Он не может блокировать, поскольку модель уже сменилась. Claude Code запускает хуки PostModelSwitch после любого из следующих изменений:3574PostModelSwitch требует Claude Code v2.1.251 или новее. Он не может блокировать, поскольку модель уже сменилась. Claude Code запускает хуки PostModelSwitch после любого из следующих изменений:

3573 3575

3574* Переключение, запрошенное вами или клиентом3576* Смена, запрошенная вами или клиентом

3575* [Автоматическое переключение на резервную модель](/docs/ru/model-config#automatic-model-fallback), которое меняет модель сессии3577* [Автоматическое переключение на резервную модель](/docs/ru/model-config#automatic-model-fallback), которое меняет модель сессии

3576* Настройка, например [`opusplan`](/docs/ru/model-config#opusplan-model-setting), при входе в режим планирования или выходе из него3578* Вход в режим планирования или выход из него при настройке, такой как [`opusplan`](/docs/ru/model-config#opusplan-model-setting)

3577* Восстановление модели Claude Code при возобновлении сессии3579* Восстановление модели Claude Code при возобновлении сессии

3578 3580

3579Claude Code не запускает хуки PostModelSwitch, когда ход обслуживает модель из [цепочки резервных моделей](/docs/ru/model-config#fallback-model-chains), поскольку такая замена длится один ход и оставляет модель сессии неизменной.3581Claude Code не запускает хуки PostModelSwitch, когда ход обслуживает модель из [цепочки резервных моделей](/docs/ru/model-config#fallback-model-chains), поскольку такая замена длится один ход и не меняет модель сессии.

3580 3582

3581Matcher подчиняется тем же правилам, что и в [PreModelSwitch](#premodelswitch): Claude Code сравнивает его с каноническим именем модели, на которую переключилась сессия.3583Matcher подчиняется тем же правилам, что и для [PreModelSwitch](#premodelswitch): Claude Code сравнивает его с каноническим именем модели, на которую переключилась сессия.

3582 3584

3583Этот пример добавляет указания всякий раз, когда модель сессии меняется на любую модель Opus:3585Этот пример добавляет указания всякий раз, когда модель сессии меняется на любую модель Opus:

3584 3586

3600}3602}

3601```3603```

3602 3604

3603Чтобы убедиться, что хук работает, переключитесь на модель Opus из сессии, использующей другую модель, например выполните `/model opus` из сессии Sonnet, а затем спросите Claude, какие у него есть указания относительно текущей модели.3605Чтобы убедиться, что хук работает, переключитесь на модель Opus в сессии, использующей другую модель, например выполните `/model opus` в сессии Sonnet, а затем спросите Claude, какие указания у него есть относительно текущей модели.

3604 3606

3605<h4 id="postmodelswitch-input">3607<h4 id="postmodelswitch-input">

3606 Входные данные PostModelSwitch3608 Входные данные PostModelSwitch

3607</h4>3609</h4>

3608 3610

3609Хуки PostModelSwitch получают те же поля, что и [PreModelSwitch](#premodelswitch-input), при этом `hook_event_name` имеет значение `"PostModelSwitch"`, а для `source` есть ещё два значения: `"auto"` для автоматического переключения на резервную модель или другого изменения, которое Claude Code выполнил самостоятельно, и `"resume"` для модели, восстановленной при возобновлении сессии.3611Хуки PostModelSwitch получают те же поля, что и [PreModelSwitch](#premodelswitch-input), с `hook_event_name`, равным `"PostModelSwitch"`, и двумя дополнительными значениями `source`: `"auto"` для автоматического переключения на резервную модель или другого изменения, которое Claude Code выполнил самостоятельно, и `"resume"` для модели, восстановленной при возобновлении сессии.

3610 3612

3611`requested_model` равно `null`, когда `source` равно `"auto"`. Когда `source` равно `"resume"`, это сохранённая настройка модели, которую восстановил Claude Code.3613`requested_model` равно `null`, когда `source` равно `"auto"`. Когда `source` равно `"resume"`, это сохранённая настройка модели, которую восстановил Claude Code.

3612 3614

3614 Управление решениями PostModelSwitch3616 Управление решениями PostModelSwitch

3615</h4>3617</h4>

3616 3618

3617Claude Code берёт [простой текстовый stdout](#exit-code-0) вашего хука при коде выхода 0 или `additionalContext` из JSON-вывода и передаёт его Claude со следующим запросом после переключения. Помимо [полей JSON-вывода](#json-output), доступных всем хукам, вы можете вернуть:3619Claude Code берёт [обычный текстовый stdout](#exit-code-0) вашего хука при коде выхода 0 или `additionalContext` из вывода JSON и передаёт его Claude вместе со следующим запросом после смены. Помимо [полей вывода JSON](#json-output), доступных всем хукам, можно вернуть:

3618 3620

3619| Поле | Описание |3621| Поле | Описание |

3620| :- | :- |3622| :- | :- |

3621| `additionalContext` | Строка, добавляемая в контекст Claude со следующим запросом. См. [Добавление контекста для Claude](#add-context-for-claude) |3623| `additionalContext` | Строка, добавляемая в контекст Claude со следующим запросом. См. [Добавление контекста для Claude](#add-context-for-claude) |

3622 3624

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

3624 3626

3625<h3 id="sessionend">3627<h3 id="sessionend">

3626 SessionEnd3628 SessionEnd

3627</h3>3629</h3>

3628 3630

3629Выполняется при завершении сессии Claude Code. Полезен для задач очистки, записи в лог статистики3631Запускается при завершении сессии Claude Code. Полезен для задач очистки, записи статистики

3630сессии или сохранения состояния сессии. Поддерживает matcher для фильтрации по причине выхода.3632сессии в лог или сохранения состояния сессии. Поддерживает matcher для фильтрации по причине выхода.

3631 3633

3632Поле `reason` во входных данных хука указывает, почему завершилась сессия:3634Поле `reason` во входных данных хука указывает, почему сессия завершилась:

3633 3635

3634| Причина | Описание |3636| Причина | Описание |

3635| :- | :- |3637| :- | :- |

3641| `bypass_permissions_disabled` | Удалено в v2.1.234; Claude Code его не отправляет. Уберите его из matcher ваших `SessionEnd` |3643| `bypass_permissions_disabled` | Удалено в v2.1.234; Claude Code его не отправляет. Уберите его из своих matcher для `SessionEnd` |

3642 3644

3643<h4 id="sessionend-input">3645<h4 id="sessionend-input">

3644 Входные данные SessionEnd3646 Входные данные SessionEnd

3645</h4>3647</h4>

3646 3648

3647Помимо [общих полей входных данных](#common-input-fields), хуки SessionEnd получают поле `reason`, указывающее, почему завершилась сессия. Все значения см. в [таблице причин](#sessionend) выше.3649Помимо [общих входных полей](#common-input-fields), хуки SessionEnd получают поле `reason`, указывающее, почему сессия завершилась. Все значения см. в [таблице причин](#sessionend) выше.

3648 3650

3649```json theme={null}3651```json theme={null}

3650{3652{

3656}3658}

3657```3659```

3658 3660

3659Хуки SessionEnd не имеют управления решениями. Они не могут заблокировать завершение сессии, но могут выполнять задачи очистки. Claude Code отбрасывает их [поля JSON-вывода](#json-output), такие как `systemMessage`.3661Хуки SessionEnd не управляют решениями. Они не могут заблокировать завершение сессии, но могут выполнять задачи очистки. Claude Code отбрасывает их [поля вывода JSON](#json-output), такие как `systemMessage`.

3660 3662

3661Хуки SessionEnd имеют таймаут по умолчанию 1,5 секунды. Он применяется, когда вы выходите, выполняете `/clear` или переключаете сессии с помощью интерактивной `/resume`. Дать хуку больше времени можно двумя способами:3663Таймаут по умолчанию для хуков SessionEnd — 1,5 секунды. Он применяется, когда вы выходите, выполняете `/clear` или переключаете сессии с помощью интерактивной команды `/resume`. Дать хуку больше времени можно двумя способами:

3662 3664

3663* **`timeout` для отдельного хука**: задайте `timeout` в конфигурации этого хука. Общий лимит времени автоматически повышается до наибольшего значения `timeout` среди хуков в ваших файлах настроек, но не более 60 секунд. Если вы повышаете лимит таким образом, хук без собственного `timeout` по-прежнему сохраняет значение по умолчанию. Таймауты, заданные для хуков из плагинов, не повышают лимит.3665* **`timeout` для отдельного хука**: задайте `timeout` в конфигурации этого хука. Общий лимит времени автоматически увеличивается до наибольшего значения `timeout` отдельного хука в ваших файлах настроек, но не более 60 секунд. Если вы увеличиваете лимит таким способом, хук без собственного `timeout` по-прежнему использует значение по умолчанию. Таймауты, заданные для хуков, предоставляемых плагинами, не увеличивают лимит.

3664* **`CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS`**: задайте эту переменную окружения в миллисекундах, чтобы явно переопределить лимит. Заданное значение также становится таймаутом для каждого хука без собственного `timeout`.3666* **`CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS`**: задайте эту переменную окружения в миллисекундах, чтобы явно переопределить лимит. Заданное значение также становится таймаутом для каждого хука без собственного `timeout`.

3665 3667

3666Этот пример устанавливает лимит в 5 секунд:3668Этот пример устанавливает лимит в 5 секунд:

3669CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS=5000 claude3671CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS=5000 claude

3670```3672```

3671 3673

3672До v2.1.268 `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` повышала только общий лимит, а хук без собственного `timeout` всё равно отменялся через 1,5 секунды.3674До v2.1.268 `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` увеличивала только общий лимит, а хук без собственного `timeout` всё равно прерывался через 1,5 секунды.

3673 3675

3674<h3 id="elicitation">3676<h3 id="elicitation">

3675 Elicitation3677 Elicitation

3676</h3>3678</h3>

3677 3679

3678Выполняется, когда MCP-сервер запрашивает ввод пользователя во время выполнения задачи. По умолчанию Claude Code показывает интерактивное диалоговое окно для ответа пользователя. Хуки могут перехватить этот запрос и ответить программно, полностью пропустив диалоговое окно.3680Запускается, когда MCP-сервер запрашивает ввод пользователя в процессе выполнения задачи. По умолчанию Claude Code показывает интерактивное диалоговое окно, в котором пользователь может ответить. Хуки могут перехватить этот запрос и ответить программно, полностью пропустив диалоговое окно.

3681

3682Полный пример хука с записью в настройках и скриптом см. в разделе [Ответ на запрос формы из скрипта](#answer-a-form-request-from-a-script).

3679 3683

3680Поле matcher сопоставляется с именем MCP-сервера.3684Поле matcher сопоставляется с именем MCP-сервера.

3681 3685

3683 Входные данные Elicitation3687 Входные данные Elicitation

3684</h4>3688</h4>

3685 3689

3686Помимо [общих полей входных данных](#common-input-fields), хуки Elicitation получают поля `mcp_server_name`, `message` и необязательные поля `mode`, `url`, `elicitation_id` и `requested_schema`.3690Помимо [общих входных полей](#common-input-fields), хуки Elicitation получают поля `mcp_server_name`, `message` и необязательные поля `mode`, `url`, `elicitation_id` и `requested_schema`.

3687 3691

3688Для elicitation в режиме формы, наиболее распространённого случая:3692Для запроса в режиме формы — самого распространённого случая:

3689 3693

3690```json theme={null}3694```json theme={null}

3691{3695{

3705}3709}

3706```3710```

3707 3711

3708Для elicitation в режиме URL, используемого для аутентификации через браузер:3712Для запроса в режиме URL, используемого для аутентификации через браузер:

3709 3713

3710```json theme={null}3714```json theme={null}

3711{3715{

3724 Вывод Elicitation3728 Вывод Elicitation

3725</h4>3729</h4>

3726 3730

3727Чтобы ответить программно без показа диалогового окна, верните JSON-объект с `hookSpecificOutput`:3731Хук Elicitation может ответить на запрос за пользователя, отклонить или отменить его либо оставить его диалоговому окну. Чтобы ответить, отклонить или отменить, завершитесь с кодом 0 и выведите объект `hookSpecificOutput` с `action`. Сервер получает ваш ответ, и диалоговое окно не появляется. Каждая строка этой таблицы показывает, что вернуть для одного исхода и что получает MCP-сервер:

3732

3733| Чтобы | Верните | Сервер получает |

3734| :- | :- | :- |

3735| Ответить за пользователя | `"action": "accept"` со значениями полей формы в `content` | `accept` с вашим `content` |

3736| Отклонить запрос | `"action": "decline"` | `decline` |

3737| Отменить запрос | `"action": "cancel"` | `cancel` |

3738| Оставить запрос пользователю | Нет вывода, код выхода 0 | Ответ пользователя из [диалогового окна](/docs/ru/mcp#respond-to-mcp-elicitation-requests) |

3739

3740Этот вывод отвечает на запрос в режиме формы, показанный в разделе [Входные данные Elicitation](#elicitation-input). Ключи в `content` — это имена свойств из `requested_schema` этого запроса:

3728 3741

3729```json theme={null}3742```json theme={null}

3730{3743{

3738}3751}

3739```3752```

3740 3753

3741| Поле | Значения | Описание |3754Этот вывод отклоняет запрос:

3742| :- | :- | :- |3755

3743| `action` | `accept`, `decline`, `cancel` | Принять, отклонить или отменить запрос |3756```json theme={null}

3744| `content` | object | Значения полей формы для отправки. Используется только когда `action` равно `accept` |3757{

3758 "hookSpecificOutput": {

3759 "hookEventName": "Elicitation",

3760 "action": "decline"

3761 }

3762}

3763```

3764

3765В диалоговом окне выбор **Decline** отправляет `decline`, а нажатие `Esc` отправляет `cancel`, поэтому возвращайте то, что вы хотите, чтобы увидел сервер.

3766

3767Для запроса в режиме URL хук, возвращающий `accept`, пропускает диалоговое окно, поэтому URL так и не открывается.

3768

3769Claude Code отбрасывает `reason`, `systemMessage` и `continue` из вывода JSON хука Elicitation, какое бы `action` вы ни вернули.

3770

3771<h4 id="other-ways-to-decline-an-elicitation">

3772 Другие способы отклонить запрос elicitation

3773</h4>

3774

3775Ваш хук также может отклонить запрос следующими способами. Сервер получает тот же `decline`, что и при `"action": "decline"`:

3776

3777* **Завершение с кодом 2**: Claude Code игнорирует `hookSpecificOutput`, выведенный тем же хуком

3778* **Вывод `"decision": "block"` верхнего уровня**: блокировка переопределяет `action` в том же выводе

3779

3780Когда одному запросу соответствует несколько хуков, отклонение от одного из них переопределяет `accept` или `cancel` от другого.

3781

3782Этот скрипт отклоняет запросы в режиме URL и оставляет запросы форм диалоговому окну:

3783

3784```bash theme={null}

3785#!/bin/bash

3786if [ "$(jq -r '.mode')" = "url" ]; then

3787 exit 2

3788fi

3789```

3790

3791Ни пользователь, ни сервер не видят, почему ваш хук отклонил запрос, поскольку Claude Code не показывает ваш stderr или ваш `reason`.

3792

3793Claude Code игнорировал `decision` верхнего уровня от хуков `Elicitation` и `ElicitationResult` начиная с v2.1.105 и до исправления в v2.1.284.

3794

3795<h4 id="answer-a-form-request-from-a-script">

3796 Ответ на запрос формы из скрипта

3797</h4>

3798

3799Этот пример отвечает за пользователя на один повторяющийся вопрос. MCP-сервер с именем `issue-tracker` запрашивает в форме ключ проекта, а хук подставляет `DOCS`. Скрипт принимает запрос, когда `project_key` — единственное поле формы. Для любого другого запроса он ничего не выводит, поэтому появляется диалоговое окно.

3800

3801<Tabs>

3802 <Tab title="macOS/Linux">

3803 Зарегистрируйте командный хук для события в файле настроек, указав имя сервера в качестве matcher:

3804

3805 ```json theme={null}

3806 {

3807 "hooks": {

3808 "Elicitation": [

3809 {

3810 "matcher": "issue-tracker",

3811 "hooks": [

3812 {

3813 "type": "command",

3814 "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/answer-project-key.sh",

3815 "args": []

3816 }

3817 ]

3818 }

3819 ]

3820 }

3821 }

3822 ```

3823

3824 Сохраните этот скрипт в файл `.claude/hooks/answer-project-key.sh` в вашем проекте и сделайте его исполняемым с помощью `chmod +x`:

3825

3826 ```bash theme={null}

3827 #!/bin/bash

3828 input=$(cat)

3829 fields=$(jq -c '.requested_schema.properties // {} | keys' <<<"$input")

3830

3831 if [ "$fields" = '["project_key"]' ]; then

3832 jq -n '{hookSpecificOutput: {hookEventName: "Elicitation", action: "accept", content: {project_key: "DOCS"}}}'

3833 fi

3834 ```

3835 </Tab>

3745 3836

3746Код выхода 2 отклоняет elicitation. Claude Code нигде не показывает ваше сообщение stderr.3837 <Tab title="Windows (PowerShell)">

3838 Зарегистрируйте командный хук, который запускает скрипт через PowerShell, указав имя сервера в качестве matcher:

3747 3839

3748Claude Code использует `hookSpecificOutput` из JSON-вывода хука Elicitation и отбрасывает `systemMessage` и `continue`.3840 ```json theme={null}

3841 {

3842 "hooks": {

3843 "Elicitation": [

3844 {

3845 "matcher": "issue-tracker",

3846 "hooks": [

3847 {

3848 "type": "command",

3849 "command": "powershell.exe",

3850 "args": [

3851 "-NoProfile",

3852 "-ExecutionPolicy",

3853 "Bypass",

3854 "-File",

3855 "${CLAUDE_PROJECT_DIR}/.claude/hooks/answer-project-key.ps1"

3856 ]

3857 }

3858 ]

3859 }

3860 ]

3861 }

3862 }

3863 ```

3864

3865 Сохраните этот скрипт в файл `.claude/hooks/answer-project-key.ps1` в вашем проекте:

3866

3867 ```powershell theme={null}

3868 $request = [Console]::In.ReadToEnd() | ConvertFrom-Json

3869 $fields = @($request.requested_schema.properties.PSObject.Properties.Name)

3870

3871 if ($fields.Count -eq 1 -and $fields[0] -eq 'project_key') {

3872 @{

3873 hookSpecificOutput = @{

3874 hookEventName = "Elicitation"

3875 action = "accept"

3876 content = @{ project_key = "DOCS" }

3877 }

3878 } | ConvertTo-Json -Depth 3

3879 }

3880 ```

3881 </Tab>

3882</Tabs>

3883

3884Чтобы убедиться, что хук работает, запустите Claude Code командой `claude --debug` и дайте Claude задачу, при которой сервер запросит ключ проекта. Диалоговое окно не появится, а в [логе отладки](#debug-hooks) будет строка, заканчивающаяся на `Elicitation resolved by hook: {"action":"accept","content":{"project_key":"DOCS"}}`.

3749 3885

3750<h3 id="elicitationresult">3886<h3 id="elicitationresult">

3751 ElicitationResult3887 ElicitationResult

3752</h3>3888</h3>

3753 3889

3754Выполняется после того, как пользователь отвечает на elicitation MCP. Хуки могут наблюдать, изменять или блокировать ответ до его отправки обратно MCP-серверу.3890Запускается после того, как пользователь ответил на запрос elicitation от MCP. Хуки могут просматривать, изменять или блокировать ответ до его отправки обратно MCP-серверу.

3891

3892Когда хук [Elicitation](#elicitation) отвечает на запрос, Claude Code отправляет этот ответ серверу без запуска хуков ElicitationResult.

3755 3893

3756Поле matcher сопоставляется с именем MCP-сервера.3894Поле matcher сопоставляется с именем MCP-сервера.

3757 3895

3759 Входные данные ElicitationResult3897 Входные данные ElicitationResult

3760</h4>3898</h4>

3761 3899

3762Помимо [общих полей входных данных](#common-input-fields), хуки ElicitationResult получают поля `mcp_server_name`, `action` и необязательные поля `mode`, `elicitation_id` и `content`.3900Помимо [общих входных полей](#common-input-fields), хуки ElicitationResult получают поля `mcp_server_name`, `action` и необязательные поля `mode`, `elicitation_id` и `content`.

3763 3901

3764```json theme={null}3902```json theme={null}

3765{3903{

3770 "mcp_server_name": "my-mcp-server",3908 "mcp_server_name": "my-mcp-server",

3771 "action": "accept",3909 "action": "accept",

3772 "content": { "username": "alice" },3910 "content": { "username": "alice" },

3773 "mode": "form",3911 "mode": "form"

3774 "elicitation_id": "elicit-123"

3775}3912}

3776```3913```

3777 3914

3779 Вывод ElicitationResult3916 Вывод ElicitationResult

3780</h4>3917</h4>

3781 3918

3782Чтобы переопределить ответ пользователя, верните JSON-объект с `hookSpecificOutput`:3919Хук ElicitationResult может пропустить ответ пользователя, изменить его значения или заблокировать его. Чтобы изменить или заблокировать ответ, завершитесь с кодом 0 и выведите объект `hookSpecificOutput` с `action`. Каждая строка этой таблицы показывает, что вернуть для одного исхода и что получает MCP-сервер:

3920

3921| Чтобы | Верните | Сервер получает |

3922| :- | :- | :- |

3923| Пропустить ответ | Нет вывода, код выхода 0 | Ответ пользователя без изменений |

3924| Изменить отправленные значения | `"action": "accept"` с новыми значениями в `content` | `accept` с вашим `content` вместо значений пользователя |

3925| Заблокировать ответ | `"action": "decline"` | `decline` без значений пользователя |

3926| Отменить запрос | `"action": "cancel"` | `cancel` вместе со значениями, отправленными пользователем. Чтобы скрыть их, верните `"decline"` |

3927

3928Этот вывод изменяет ответ, показанный в разделе [Входные данные ElicitationResult](#elicitationresult-input), так что сервер получает `alice@example.com` там, где пользователь отправил `alice`:

3783 3929

3784```json theme={null}3930```json theme={null}

3785{3931{

3786 "hookSpecificOutput": {3932 "hookSpecificOutput": {

3787 "hookEventName": "ElicitationResult",3933 "hookEventName": "ElicitationResult",

3788 "action": "decline",3934 "action": "accept",

3789 "content": {}3935 "content": {

3936 "username": "alice@example.com"

3937 }

3790 }3938 }

3791}3939}

3792```3940```

3793 3941

3794| Поле | Значения | Описание |3942Ваш `content` заменяет весь объект `content` пользователя, поэтому включайте поля, которые вы не меняете. Возвращайте вместе с ним `action`, поскольку Claude Code игнорирует `hookSpecificOutput` без `action`.

3795| :- | :- | :- |3943

3796| `action` | `accept`, `decline`, `cancel` | Переопределяет действие пользователя |3944Хуки ElicitationResult также запускаются, когда пользователь отклоняет или отменяет запрос, и ваше `action` заменяет его действие. Прежде чем вернуть `accept`, проверьте, что `action` во входных данных равно `accept`, иначе ваш хук превратит отклонённый запрос в принятый. Этот скрипт вносит то же изменение, когда пользователь принял запрос, сохраняет остальные поля и в противном случае ничего не выводит:

3797| `content` | object | Переопределяет значения полей формы. Имеет смысл только когда `action` равно `accept` |3945

3946```bash theme={null}

3947#!/bin/bash

3948input=$(cat)

3798 3949

3799Код выхода 2 блокирует ответ, меняя фактическое действие на `decline`. Claude Code нигде не показывает ваше сообщение stderr.3950if [ "$(jq -r '.action' <<<"$input")" = "accept" ]; then

3951 jq '{hookSpecificOutput: {hookEventName: "ElicitationResult", action: "accept", content: (.content + {username: (.content.username + "@example.com")})}}' <<<"$input"

3952fi

3953```

3800 3954

3801Claude Code использует `hookSpecificOutput` из JSON-вывода хука ElicitationResult и отбрасывает `systemMessage` и `continue`.3955Этот вывод блокирует ответ:

3956

3957```json theme={null}

3958{

3959 "hookSpecificOutput": {

3960 "hookEventName": "ElicitationResult",

3961 "action": "decline"

3962 }

3963}

3964```

3965

3966Код выхода 2 и `"decision": "block"` верхнего уровня также блокируют ответ. В разделе [Другие способы отклонить запрос elicitation](#other-ways-to-decline-an-elicitation) описано, какой из них действует, когда хук их сочетает, что видит пользователь и какие версии игнорировали `decision`.

3967

3968Claude Code отбрасывает `reason`, `systemMessage` и `continue` из вывода JSON хука ElicitationResult, какое бы `action` вы ни вернули.

3802 3969

3803<h2 id="prompt-based-hooks">3970<h2 id="prompt-based-hooks">

3804 Prompt-based hooks3971 Prompt-based hooks

3862 4029

3863Установите `type` на `"prompt"` и предоставьте строку `prompt` вместо `command`. Используйте заполнитель `$ARGUMENTS` для внедрения данных JSON входа hook в текст вашей подсказки.4030Установите `type` на `"prompt"` и предоставьте строку `prompt` вместо `command`. Используйте заполнитель `$ARGUMENTS` для внедрения данных JSON входа hook в текст вашей подсказки.

3864 4031

4032В prompt или [agent хуке](#agent-based-hooks) вы можете написать `prompt` как правило о том, что блокировать или разрешать, например «Блокировать любую команду Bash, которая читает файлы `.env`», или как условие, которое должно выполняться, например «Все модульные тесты проходят».

4033

3865Этот hook `Stop` просит LLM оценить, должен ли Claude остановиться перед разрешением Claude закончить:4034Этот hook `Stop` просит LLM оценить, должен ли Claude остановиться перед разрешением Claude закончить:

3866 4035

3867```json theme={null}4036```json theme={null}

keybindings.md +49 −0

Details

68| `EffortSlider` | Ползунок усилий, открытый с помощью `/effort` |68| `EffortSlider` | Ползунок усилий, открытый с помощью `/effort` |

69| `Select` | Универсальные компоненты выбора/списка |69| `Select` | Универсальные компоненты выбора/списка |

70| `Plugin` | Диалог плагина (обзор, обнаружение, управление) |70| `Plugin` | Диалог плагина (обзор, обнаружение, управление) |

71| `AbovePrompt` | [Полоса над промптом](#above-prompt-actions) или кнопка в ней находится в фокусе клавиатуры |

72| `AbovePromptInput` | Поле ввода в полосе над промптом или на панели мода находится в фокусе клавиатуры |

73| `AbovePromptSelect` | Список выбора в полосе над промптом или на панели мода находится в фокусе клавиатуры |

71| `Pane` | Панель, отрисованная [модом](/docs/ru/plugins/mods/interface#know-which-keys-your-mod-can-receive), находится в фокусе клавиатуры |74| `Pane` | Панель, отрисованная [модом](/docs/ru/plugins/mods/interface#know-which-keys-your-mod-can-receive), находится в фокусе клавиатуры |

72| `PaneField` | Поле ввода или список выбора на панели мода находится в фокусе клавиатуры |75| `PaneField` | Поле ввода или список выбора на панели мода находится в фокусе клавиатуры |

73| `Agents` | [Представление агента](/docs/ru/agent-view) (`claude agents`) |76| `Agents` | [Представление агента](/docs/ru/agent-view) (`claude agents`) |

442| `plugin:install` | I | Установить выбранные plugins |445| `plugin:install` | I | Установить выбранные plugins |

443| `plugin:favorite` | F | Добавить выбранный plugin в избранное, чтобы он сортировался ближе к верхней части вкладки Installed |446| `plugin:favorite` | F | Добавить выбранный plugin в избранное, чтобы он сортировался ближе к верхней части вкладки Installed |

444 447

448<h3 id="above-prompt-actions">

449 Действия полосы над промптом

450</h3>

451

452Действия для полосы над промптом — общей области, в которой [моды](/docs/ru/plugins/mods/interface#pick-where-to-draw) отрисовывают кнопки, поля ввода и списки выбора. `abovePrompt:toggle` и `abovePrompt:focus` применяются в контексте `Chat`. Остальные действия применяются в [контексте](#contexts) того элемента, который имеет фокус клавиатуры в полосе или на панели.

453

454| Действие | По умолчанию | Описание |

455| :- | :- | :- |

456| `abovePrompt:toggle` | Ctrl+X Ctrl+A | Свернуть полосу до однострочной подсказки или снова развернуть её |

457| `abovePrompt:focus` | Ctrl+X Tab | Переместить фокус клавиатуры в полосу, затем на каждую открытую [панель](#pane-actions), а с последней панели — обратно в промпт |

458| `abovePrompt:next` | Tab | Перевести фокус на следующий элемент управления |

459| `abovePrompt:previous` | Shift+Tab | Перевести фокус на предыдущий элемент управления |

460| `abovePrompt:press` | Enter | Нажать кнопку в фокусе, отправить поле ввода в фокусе или выбрать выделенный вариант в списке выбора |

461| `abovePrompt:leave` | Escape | Вернуть фокус клавиатуры в промпт |

462| `abovePrompt:highlightNext` | Down | Выделить следующий вариант в списке выбора, находящемся в фокусе |

463| `abovePrompt:highlightPrevious` | Up | Выделить предыдущий вариант в списке выбора, находящемся в фокусе |

464

465Два контекста по умолчанию привязывают к этим действиям дополнительные клавиши:

466

467* **`AbovePrompt`**: Right и Left также выполняют `abovePrompt:next` и `abovePrompt:previous`, а Space также выполняет `abovePrompt:press`

468* **`AbovePromptInput`**: Down и Up также выполняют `abovePrompt:next` и `abovePrompt:previous`

469

470Контекст `AbovePrompt` также привязывает Up, Down, PageUp, PageDown, Home и End к [действиям прокрутки панели](#pane-actions) от `pane:scrollUp` до `pane:bottom`, поэтому, чтобы изменить одну из этих клавиш для полосы, привяжите действие прокрутки в блоке `AbovePrompt`.

471

472<h3 id="pane-actions">

473 Действия панели

474</h3>

475

476Действия для панели, отрисованной [модом](/docs/ru/plugins/mods/interface#know-which-keys-your-mod-can-receive). Действия прокрутки, изменения размера и закрытия применяются в [контексте](#contexts) `Pane`. `pane:close` также применяется в контексте `PaneField`, поэтому оно работает, пока одно из полей панели имеет фокус. `pane:next` и `pane:previous` применяются в контексте `Global`, пока открыто более одной панели.

477

478| Действие | По умолчанию | Описание |

479| :- | :- | :- |

480| `pane:scrollUp` | Up | Прокрутить панель вверх, когда в ней больше строк, чем она может показать |

481| `pane:scrollDown` | Down | Прокрутить панель вниз, когда в ней больше строк, чем она может показать |

482| `pane:pageUp` | PageUp | Прокрутить панель вверх на страницу |

483| `pane:pageDown` | PageDown | Прокрутить панель вниз на страницу |

484| `pane:top` | Home | Перейти в начало панели |

485| `pane:bottom` | End | Перейти в конец панели |

486| `pane:grow` | Ctrl+X Left, Ctrl+X Up | Дать панели больше места: по ширине, когда она находится рядом с транскриптом, по высоте, когда она находится над промптом |

487| `pane:shrink` | Ctrl+X Right, Ctrl+X Down | Дать панели меньше места: по ширине, когда она находится рядом с транскриптом, по высоте, когда она находится над промптом |

488| `pane:close` | Ctrl+X X | Закрыть панель |

489| `pane:next` | (не привязано) | Показать следующую открытую панель |

490| `pane:previous` | (не привязано) | Показать предыдущую открытую панель |

491

492Контекст `Pane` также привязывает Tab, Shift+Tab, Enter и Escape к тем же [действиям полосы над промптом](#above-prompt-actions), что и полоса, а поля ввода и списки выбора панели используют контексты `AbovePromptInput` и `AbovePromptSelect`. В разделе [Фокус клавиатуры и горячие клавиши](/docs/ru/plugins/mods/interface#know-which-keys-your-mod-can-receive) указано, что делает каждая клавиша на панели.

493

445<h3 id="settings-actions">494<h3 id="settings-actions">

446 Действия параметров495 Действия параметров

447</h3>496</h3>

llm-gateway-protocol.md +7 −7

Details

65 65

66Шлюз также видит лучший трафик при запуске, который он может отклонить без нарушения чего-либо. Шлюз формата Anthropic Messages получает зонд `HEAD /api/hello` для прогрева соединения, который Claude Code пропускает, когда настроен HTTP-прокси или сертификат клиента. Шлюз формата Amazon Bedrock получает запрос `GET /inference-profiles?type=SYSTEM_DEFINED` и, когда настроенная модель является профилем вывода, поиски `GET /inference-profiles/{profile}`.66Шлюз также видит лучший трафик при запуске, который он может отклонить без нарушения чего-либо. Шлюз формата Anthropic Messages получает зонд `HEAD /api/hello` для прогрева соединения, который Claude Code пропускает, когда настроен HTTP-прокси или сертификат клиента. Шлюз формата Amazon Bedrock получает запрос `GET /inference-profiles?type=SYSTEM_DEFINED` и, когда настроенная модель является профилем вывода, поиски `GET /inference-profiles/{profile}`.

67 67

68Сессии, проходящие через шлюз, не подходят для конфигурации HIPAA. В разделе [Check how developers sign in and connect](/docs/ru/hipaa-setup#check-how-developers-sign-in-and-connect) перечислены методы входа и подключения, которые подходят. См. [The HIPAA configuration behind a gateway](/docs/ru/llm-gateway-rollout#the-hipaa-configuration-behind-a-gateway).68Сессии, проходящие через шлюз, не подходят для конфигурации HIPAA. В разделе [Проверьте, как разработчики входят в систему и подключаются](/docs/ru/hipaa-setup#check-how-developers-sign-in-and-connect) перечислены методы входа и подключения, которые подходят. См. [Конфигурация HIPAA за шлюзом](/docs/ru/llm-gateway-rollout#the-hipaa-configuration-behind-a-gateway).

69 69

70Проверка доступности [fast mode](/docs/ru/fast-mode) никогда не появляется в логах шлюза: она вызывает `api.anthropic.com` напрямую, а не следует `ANTHROPIC_BASE_URL`, поэтому в сети, которая блокирует прямой исходящий трафик на `api.anthropic.com`, fast mode может сообщить об ошибке подключения, в то время как вывод через шлюз продолжает работать. Проверка безопасности домена [WebFetch](/docs/ru/data-usage#webfetch-domain-safety-check) также вызывает `api.anthropic.com` напрямую. [Use fast mode behind proxies and LLM gateways](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) охватывает переменные, которые его восстанавливают.70Проверка доступности [быстрого режима](/docs/ru/fast-mode) никогда не появляется в логах шлюза: она вызывает `api.anthropic.com` напрямую, а не следует `ANTHROPIC_BASE_URL`, поэтому в сети, которая блокирует прямой исходящий трафик на `api.anthropic.com`, быстрый режим может сообщить об ошибке подключения, в то время как вывод через шлюз продолжает работать. Проверка безопасности домена [WebFetch](/docs/ru/data-usage#webfetch-domain-safety-check) также вызывает `api.anthropic.com` напрямую. Раздел [Использование быстрого режима за прокси и шлюзами LLM](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) охватывает переменные, которые его восстанавливают.

71 71

72<h3 id="streaming">72<h3 id="streaming">

73 Потоковая передача73 Потоковая передача

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

77 77

78* Если ваш шлюз буферизирует ответ до его завершения, Claude Code зависает.78* Если ваш шлюз буферизирует ответ до его завершения, Claude Code зависает.

79* Claude Code ожидает полную последовательность событий каждого ответа, по порядку, вплоть до финальных событий `message_delta` и `message_stop`. Если тело завершается чисто после начала блока контента, но до этого финального `message_delta`, Claude Code рассматривает ответ как разорванное соединение. [The response above may be incomplete](/docs/ru/errors#the-response-above-may-be-incomplete) описывает, что в этом случае видит пользователь, а [Automatic retries](/docs/ru/errors#automatic-retries) — когда Claude Code вместо этого повторно отправляет запрос.79* Claude Code ожидает полную последовательность событий каждого ответа, по порядку, вплоть до финальных событий `message_delta` и `message_stop`. Если тело завершается чисто после начала блока контента, но до этого финального `message_delta`, Claude Code рассматривает ответ как разорванное соединение. [The response above may be incomplete](/docs/ru/errors#the-response-above-may-be-incomplete) описывает, что в этом случае видит пользователь, а раздел [Автоматические повторные попытки](/docs/ru/errors#automatic-retries) — когда Claude Code вместо этого повторно отправляет запрос.

80* Когда guardrail Amazon Bedrock блокирует ответ, события, которые отправляет Bedrock, могут ссылаться на блок контента, чей `content_block_stop` уже прибыл, и Claude Code рассчитывает получить их в том виде, в каком они были отправлены. [AWS Guardrails](/docs/ru/amazon-bedrock#aws-guardrails) описывает, как завершается такой ответ.80* Когда guardrail Amazon Bedrock блокирует ответ, события, которые отправляет Bedrock, могут ссылаться на блок контента, чей `content_block_stop` уже прибыл, и Claude Code рассчитывает получить их в том виде, в каком они были отправлены. [AWS Guardrails](/docs/ru/amazon-bedrock#aws-guardrails) описывает, как завершается такой ответ.

81* Claude Code прерывает потоковый ответ, как только на него не поступают байты дольше, чем его [таймаут простоя потоковой передачи](/docs/ru/network-config#streaming-idle-watchdogs). Во время длительной паузы мышления SSE-события `ping` вышестоящего сервера могут быть единственными байтами в потоке, поэтому шлюз, который удаляет или буферизирует их, может вызвать срабатывание этого таймаута посреди ответа. У шлюза, который выполняет преобразование с вышестоящего сервера без пингов, такого как двоичный поток событий Amazon Bedrock, возникает тот же пробел, если только он не выдаёт собственные события `ping`.81* Claude Code прерывает потоковый ответ, как только на него не поступают байты дольше, чем его [таймаут простоя потоковой передачи](/docs/ru/network-config#streaming-idle-watchdogs). Во время длительной паузы мышления SSE-события `ping` вышестоящего сервера могут быть единственными байтами в потоке, поэтому шлюз, который удаляет или буферизирует их, может вызвать срабатывание этого таймаута посреди ответа. У шлюза, который выполняет преобразование с вышестоящего сервера без пингов, такого как двоичный поток событий Amazon Bedrock, возникает тот же пробел, если только он не выдаёт собственные события `ping`.

82* В [формате Amazon Bedrock InvokeModel](#api-formats) Claude Code читает ответ `/model/{model}/invoke-with-response-stream` как двоичное тело `application/vnd.amazon.eventstream`, которое возвращает Bedrock, и не может его разобрать, если шлюз преобразует его в server-sent events или переписывает этот заголовок `Content-Type`. [Streaming errors behind a gateway or proxy](/docs/ru/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy) описывает, что в этом случае видит пользователь.82* В [формате Amazon Bedrock InvokeModel](#api-formats) Claude Code читает ответ `/model/{model}/invoke-with-response-stream` как двоичное тело `application/vnd.amazon.eventstream`, которое возвращает Bedrock, и не может его разобрать, если шлюз преобразует его в server-sent events или переписывает этот заголовок `Content-Type`. Раздел [Ошибки потоковой передачи за шлюзом или прокси](/docs/ru/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy) описывает, что в этом случае видит пользователь.

83 83

84<h3 id="format-mismatch-with-the-upstream">84<h3 id="format-mismatch-with-the-upstream">

85 Несоответствие формата с вышестоящим сервером85 Несоответствие формата с вышестоящим сервером

90* Когда клиент использует формат Amazon Bedrock или Google Cloud's Agent Platform, Claude Code отправляет только подмножество своего полного набора возможностей, которое эти поставщики принимают90* Когда клиент использует формат Amazon Bedrock или Google Cloud's Agent Platform, Claude Code отправляет только подмножество своего полного набора возможностей, которое эти поставщики принимают

91* Когда клиент использует формат Anthropic Messages, Claude Code отправляет полный набор, даже если ваш шлюз пересылает на вышестоящий сервер Amazon Bedrock или Google Cloud's Agent Platform91* Когда клиент использует формат Anthropic Messages, Claude Code отправляет полный набор, даже если ваш шлюз пересылает на вышестоящий сервер Amazon Bedrock или Google Cloud's Agent Platform

92 92

93Преодоление этого различия — задача вашего шлюза. [Feature pass-through](#feature-pass-through) описывает, что ломается, когда это не происходит.93Преодоление этого различия — задача вашего шлюза. [Сквозная передача функций](#feature-pass-through) описывает, что ломается, когда это не происходит.

94 94

95Если ваш вышестоящий сервер — Amazon Bedrock или Google Cloud's Agent Platform, вы можете избежать преодоления, предоставив вместо этого формат этого поставщика. [Route to a cloud provider through a gateway](/docs/ru/llm-gateway-connect#route-to-a-cloud-provider-through-a-gateway) показывает конфигурацию клиента для этого формата.95Если ваш вышестоящий сервер — Amazon Bedrock или Google Cloud's Agent Platform, вы можете избежать преодоления, предоставив вместо этого формат этого поставщика. [Маршрутизация к облачному поставщику через шлюз](/docs/ru/llm-gateway-connect#route-to-a-cloud-provider-through-a-gateway) показывает конфигурацию клиента для этого формата.

96 96

97<h2 id="how-the-connection-method-changes-client-behavior">97<h2 id="how-the-connection-method-changes-client-behavior">

98 Как метод подключения изменяет поведение клиента98 Как метод подключения изменяет поведение клиента

200 200

201| Заголовок | Что возвращать и почему |201| Заголовок | Что возвращать и почему |

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

203| `content-type` | Возвращайте `text/event-stream` для потоковых ответов в формате Anthropic Messages и `application/vnd.amazon.eventstream` без изменений для ответов в формате Amazon Bedrock, где [другой тип приводит к сбою запроса](/docs/ru/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). [Streaming](#streaming) указывает, какие соединения выполняют обнаружение зависания на этих потоках |203| `content-type` | Возвращайте `text/event-stream` для потоковых ответов в формате Anthropic Messages и `application/vnd.amazon.eventstream` без изменений для ответов в формате Amazon Bedrock, где [другой тип приводит к сбою запроса](/docs/ru/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy) |

204| `retry-after` | Возвращайте целое число секунд вместо даты HTTP. Claude Code ждет по крайней мере столько времени перед следующей [автоматической повторной попыткой](/docs/ru/errors#automatic-retries), и вне сеансов [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/ru/env-vars) значение выше 60 останавливает повторные попытки и показывает ошибку сразу же |204| `retry-after` | Возвращайте целое число секунд вместо даты HTTP. Claude Code ждет по крайней мере столько времени перед следующей [автоматической повторной попыткой](/docs/ru/errors#automatic-retries), и вне сеансов [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/ru/env-vars) значение выше 60 останавливает повторные попытки и показывает ошибку сразу же |

205| `x-should-retry` | Пропускайте значение вышестоящего сервера без изменений. Claude Code читает этот заголовок как один из входных данных при решении о повторной попытке неудачного запроса: `true` отмечает ответ как подлежащий повторной попытке, а `false` отмечает его как не подлежащий повторной попытке. Для количества повторных попыток, отката и того, какие сбои Claude Code повторяет, см. [автоматические повторные попытки](/docs/ru/errors#automatic-retries) |205| `x-should-retry` | Пропускайте значение вышестоящего сервера без изменений. Claude Code читает этот заголовок как один из входных данных при решении о повторной попытке неудачного запроса: `true` отмечает ответ как подлежащий повторной попытке, а `false` отмечает его как не подлежащий повторной попытке. Для количества повторных попыток, отката и того, какие сбои Claude Code повторяет, см. [автоматические повторные попытки](/docs/ru/errors#automatic-retries) |

206| `anthropic-ratelimit-unified-*` | Пропускайте значения вышестоящего сервера без изменений при каждом ответе. Claude Code читает их при успешных ответах для отображения использования в соответствии с лимитами плана разработчикам, вошедшим в систему с помощью claude.ai, и при `429` для различения лимита плана или лимита расходов от временного дросселирования; см. [лимиты использования](/docs/ru/errors#usage-limits) |206| `anthropic-ratelimit-unified-*` | Пропускайте значения вышестоящего сервера без изменений при каждом ответе. Claude Code читает их при успешных ответах для отображения использования в соответствии с лимитами плана разработчикам, вошедшим в систему с помощью claude.ai, и при `429` для различения лимита плана или лимита расходов от временного дросселирования; см. [лимиты использования](/docs/ru/errors#usage-limits) |

managed-settings.md +1 −1

Details

154 154

155Claude Code проверяет источники в этом порядке, от наивысшего приоритета к наименьшему:155Claude Code проверяет источники в этом порядке, от наивысшего приоритета к наименьшему:

156 156

1571. Удалённые настройки, доставленные с claude.ai как [настройки, управляемые сервером](/docs/ru/server-managed-settings), или через [шлюз приложений Claude](/docs/ru/claude-apps-gateway). Claude Code получает этот источник только когда сессия аутентифицируется в API Anthropic напрямую с помощью [подходящего входа или ключа](/docs/ru/server-managed-settings#platform-availability) или входит в шлюз с помощью `/login`. На других поставщиках или когда `ANTHROPIC_BASE_URL` указывает на что-то другое, чем API Anthropic, он начинает со следующего источника1571. Удалённые настройки, доставленные с claude.ai как [настройки, управляемые сервером](/docs/ru/server-managed-settings), или через [шлюз приложений Claude](/docs/ru/claude-apps-gateway). Claude Code получает этот источник только когда сессия аутентифицируется в API Anthropic напрямую с помощью [подходящих учётных данных](/docs/ru/server-managed-settings#platform-availability) или входит в шлюз с помощью `/login`. На других поставщиках или когда `ANTHROPIC_BASE_URL` указывает на что-то другое, чем API Anthropic, он начинает со следующего источника

1582. Политики MDM или уровня ОС: plist macOS или ключ реестра HKLM1582. Политики MDM или уровня ОС: plist macOS или ключ реестра HKLM

1593. Файлы управляемых настроек, `managed-settings.d/*.json` и `managed-settings.json`, объединённые вместе1593. Файлы управляемых настроек, `managed-settings.d/*.json` и `managed-settings.json`, объединённые вместе

1604. Реестр HKCU в Windows, а также в WSL после того, как реестр HKLM или файл управляемых настроек Windows включит [`wslInheritsWindowsSettings`](/docs/ru/settings-reference#wslinheritswindowssettings) и значение HKCU тоже задаст его. Claude Code читает его, только когда [над ним нет присутствующего документа администратора](#present-admin-documents) и никакие [родительские настройки, предоставленные хостом](#let-an-embedding-host-add-policy), не задают ограничивающий ключ1604. Реестр HKCU в Windows, а также в WSL после того, как реестр HKLM или файл управляемых настроек Windows включит [`wslInheritsWindowsSettings`](/docs/ru/settings-reference#wslinheritswindowssettings) и значение HKCU тоже задаст его. Claude Code читает его, только когда [над ним нет присутствующего документа администратора](#present-admin-documents) и никакие [родительские настройки, предоставленные хостом](#let-an-embedding-host-add-policy), не задают ограничивающий ключ

mcp.md +54 −32

Details

50 Если установка не удается, сопоставьте сообщение, которое сообщает Claude Code:50 Если установка не удается, сопоставьте сообщение, которое сообщает Claude Code:

51 51

52 * `Marketplace "claude-plugins-official" not found`: добавьте marketplace с помощью `/plugin marketplace add anthropics/claude-plugins-official`, затем повторите попытку установки.52 * `Marketplace "claude-plugins-official" not found`: добавьте marketplace с помощью `/plugin marketplace add anthropics/claude-plugins-official`, затем повторите попытку установки.

~~53 * The plugin is [not found in the marketplace](/docs/ru/plugins/install#install-a-plugin): проверьте имя плагина.~~53 * Плагин [не найден в marketplace](/docs/ru/plugins/install#install-a-plugin): проверьте имя плагина.

54 54

55 Если в сводке установки указано `Run /reload-plugins to apply.`, Claude Code затем запустит эту перезагрузку для вас. Если перезагрузка предупреждает, что ваше следующее сообщение повторно прочитает диалог, выполните `/reload-plugins --force`.55 Если в сводке установки указано `Run /reload-plugins to apply.`, Claude Code затем запустит эту перезагрузку для вас. Если перезагрузка предупреждает, что ваше следующее сообщение повторно прочитает диалог, выполните `/reload-plugins --force`.

56 </Step>56 </Step>

142```142```

143 143

144<Note>144<Note>

~~145 **Важно: отделяйте аргументы сервера с помощью `--`**~~

~~146~~

147 Для stdio-серверов `--` (двойной дефис) отделяет собственные опции Claude, такие как `--transport`, `--env` и `--scope`, от команды и аргументов, которые запускают сервер. Всё после `--` передаётся серверу без изменений.145 Для stdio-серверов `--` (двойной дефис) отделяет собственные опции Claude, такие как `--transport`, `--env` и `--scope`, от команды и аргументов, которые запускают сервер. Всё после `--` передаётся серверу без изменений.

148 146

149 Например:147 Например:

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

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

277 275

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

~~279~~

280<h4 id="project-server-approvals-and-workspace-trust">276<h4 id="project-server-approvals-and-workspace-trust">

281 Одобрение серверов проекта и доверие к рабочему пространству277 Одобрение серверов проекта и доверие к рабочему пространству

282</h4>278</h4>

371 367

372В v2 Claude Code также:368В v2 Claude Code также:

373 369

374* Спрашивает HTTP-серверы, поддерживают ли они более новую ревизию, и использует её с теми, которые поддерживают. В сессиях, где он получает флаги функций, он также спрашивает серверы коннекторов claude.ai, а в Claude Code v2.1.285 или новее — stdio-серверы, по мере того как Anthropic развёртывает это изменение. Чтобы он спрашивал серверы коннекторов и stdio-серверы в каждой сессии, установите [`MCP_PROTOCOL_NEGOTIATION`](/docs/ru/env-vars) в `auto`. Ко всем остальным серверам он подключается так же, как v1.370* Спрашивает HTTP- и stdio-серверы, поддерживают ли они более новую ревизию, и использует её с теми, которые поддерживают. В сессиях, где он получает флаги функций, он также спрашивает серверы коннекторов claude.ai. Ко всем остальным серверам он подключается так же, как v1.

375* Получает уведомления `list_changed` от серверов на более новой ревизии через [поток, который держит открытым](#notification-streams-on-the-v2-runtime).371* Получает уведомления `list_changed` от серверов на более новой ревизии через [поток, который держит открытым](#notification-streams-on-the-v2-runtime).

376* Не регистрирует сервер [канала](#push-messages-with-channels), который подключается на более новой ревизии, потому что эта ревизия не может передавать сообщения канала.372* Не регистрирует сервер [канала](#push-messages-with-channels), который подключается на более новой ревизии, потому что эта ревизия не может передавать сообщения канала.

377* Прерывает [вход через MCP OAuth](#authenticate-with-remote-mcp-servers), если ответ авторизации указывает неожиданного издателя.373* Прерывает [вход через MCP OAuth](#authenticate-with-remote-mcp-servers), если ответ авторизации указывает неожиданного издателя.

458 454

459В [среде выполнения v2](#mcp-client-runtimes) сервер канала, который согласует ревизию протокола MCP 2026-07-28, не может доставлять сообщения канала, поэтому Claude Code не регистрирует его как канал. Сервер канала, который не поддерживает эту ревизию, подключается по более раннему рукопожатию и регистрируется как прежде.455В [среде выполнения v2](#mcp-client-runtimes) сервер канала, который согласует ревизию протокола MCP 2026-07-28, не может доставлять сообщения канала, поэтому Claude Code не регистрирует его как канал. Сервер канала, который не поддерживает эту ревизию, подключается по более раннему рукопожатию и регистрируется как прежде.

460 456

461Claude Code запрашивает эту ревизию у stdio-серверов, когда вы устанавливаете [`MCP_PROTOCOL_NEGOTIATION`](/docs/ru/env-vars) в `auto`. Anthropic также включает это по умолчанию для Claude Code v2.1.285 или новее в сессиях, где Claude Code [получает флаги функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching). Чтобы оставить stdio-сервер канала на более раннем рукопожатии, установите `MCP_PROTOCOL_NEGOTIATION` в `legacy`, что оставляет на нём все серверы.457Claude Code по умолчанию запрашивает эту ревизию у stdio-серверов. Чтобы оставить stdio-сервер канала на более раннем рукопожатии, установите [`MCP_PROTOCOL_NEGOTIATION`](/docs/ru/env-vars) в `legacy`, что оставляет на нём все серверы.

462 458

463<Tip>459<Tip>

464 Советы:460 Советы:

509 MCP-серверы, предоставляемые плагинами505 MCP-серверы, предоставляемые плагинами

510</h3>506</h3>

511 507

512[Плагины](/docs/ru/plugins/overview) могут включать MCP-серверы, которые предоставляют инструменты и интеграции при включении плагина. MCP-серверы плагинов работают так же, как серверы, настроенные пользователем.508[Плагины](/docs/ru/plugins/overview) могут включать MCP-серверы, которые предоставляют инструменты и интеграции при включении плагина.

513 509

514**Как работают MCP-серверы плагинов**:510**Как работают MCP-серверы плагинов**:

515 511

1400 Ограничения и предупреждения выходных данных MCP1396 Ограничения и предупреждения выходных данных MCP

1401</h2>1397</h2>

1402 1398

1403Когда инструменты MCP производят большие объемы выходных данных, Claude Code помогает управлять использованием токенов, чтобы не перегружать контекст вашего разговора:1399Когда инструменты MCP производят большие объемы выходных данных, Claude Code помогает управлять использованием токенов, чтобы не перегружать контекст вашего диалога:

1404 1400

1405* **Порог предупреждения выходных данных**: Claude Code отображает предупреждение, когда выходные данные любого инструмента MCP превышают 10 000 токенов1401* **Порог предупреждения выходных данных**: Claude Code отображает предупреждение, когда выходные данные любого инструмента MCP превышают 10 000 токенов

1406* **Настраиваемый лимит**: вы можете отрегулировать максимально допустимое количество токенов выходных данных MCP, используя переменную окружения `MAX_MCP_OUTPUT_TOKENS`1402* **Настраиваемый лимит**: вы можете отрегулировать максимально допустимое количество токенов выходных данных MCP, используя переменную окружения `MAX_MCP_OUTPUT_TOKENS`

1407* **Лимит по умолчанию**: максимум по умолчанию составляет 25 000 токенов1403* **Лимит по умолчанию**: максимум по умолчанию составляет 25 000 токенов

1408* **Область действия**: переменная окружения применяется к инструментам, которые не объявляют свой собственный лимит. Инструменты, которые устанавливают [`anthropic/maxResultSizeChars`](#raise-the-limit-for-a-specific-tool), используют это значение вместо этого для текстового содержимого, независимо от того, какое значение установлено для `MAX_MCP_OUTPUT_TOKENS`. Инструменты, которые возвращают данные изображений, по-прежнему подчиняются `MAX_MCP_OUTPUT_TOKENS`1404* **Область действия**: переменная окружения применяется к инструментам, которые не объявляют свой собственный лимит. Инструменты, которые устанавливают [`anthropic/maxResultSizeChars`](#raise-the-limit-for-a-specific-tool), используют это значение вместо этого для текстового содержимого, независимо от того, какое значение установлено для `MAX_MCP_OUTPUT_TOKENS`. Инструменты, которые возвращают данные изображений, по-прежнему подчиняются `MAX_MCP_OUTPUT_TOKENS`

1409* **Превышение лимита**: когда успешный результат без содержимого изображения превышает лимит токенов, Claude Code сохраняет его в файл и заменяет его в диалоге сообщением, которое указывает путь к файлу, чтобы Claude прочитал файл, когда ему нужно содержимое. Файл находится в директории `tool-results` сессии в [`~/.claude/projects/`](/docs/ru/claude-directory#cleaned-up-automatically).1405* **Превышение лимита**: когда успешный результат без содержимого изображения превышает лимит токенов, Claude Code сохраняет его в файл и заменяет его в диалоге сообщением, которое указывает путь к файлу, чтобы Claude прочитал файл, когда ему нужно содержимое. Файл находится в директории `tool-results` сессии в [`~/.claude/projects/`](/docs/ru/claude-directory#cleaned-up-automatically).

1406* **Размер ответа от серверов HTTP и SSE**: Claude Code прекращает чтение ответа от сервера [HTTP](#option-1-add-a-remote-http-server) или [SSE](#option-2-add-a-remote-sse-server), как только одно тело ответа JSON или одно событие потока событий превышает 16 МБ после распаковки. Запрос, на который отвечает этот ответ, завершается с ошибкой. Если вы поддерживаете сервер, возвращайте меньше данных в каждом ответе, чтобы оставаться в пределах лимита, например используя постраничную выдачу результатов

1410 1407

1411Вызов, который Claude Code [перевел в фоновую задачу](#automatic-backgrounding-of-long-tool-calls), сообщает свой результат через уведомление задачи. К вызову, который завершается на переднем плане, применяются еще два ограничения:1408Вызов, который Claude Code [перевел в фоновую задачу](#automatic-backgrounding-of-long-tool-calls), сообщает свой результат через уведомление задачи. К вызову, который завершается на переднем плане, применяются еще два ограничения:

1412 1409

1440 1437

1441Аннотация применяется независимо от `MAX_MCP_OUTPUT_TOKENS` для текстового содержимого, поэтому пользователям не нужно повышать переменную окружения для инструментов, которые ее объявляют. Инструменты, которые возвращают данные изображений, по-прежнему подчиняются лимиту токенов.1438Аннотация применяется независимо от `MAX_MCP_OUTPUT_TOKENS` для текстового содержимого, поэтому пользователям не нужно повышать переменную окружения для инструментов, которые ее объявляют. Инструменты, которые возвращают данные изображений, по-прежнему подчиняются лимиту токенов.

1442 1439

1443<Warning>

1444 Если вы часто сталкиваетесь с предупреждениями о выходных данных с конкретными серверами MCP, которыми вы не управляете, рассмотрите возможность увеличения лимита `MAX_MCP_OUTPUT_TOKENS`. Вы также можете попросить автора сервера добавить аннотацию `anthropic/maxResultSizeChars` или разбить свои ответы на страницы. Аннотация не влияет на инструменты, которые возвращают содержимое изображений; для них единственный вариант — повысить `MAX_MCP_OUTPUT_TOKENS`.

1445</Warning>

~~1446~~

1447<h3 id="images-in-tool-results">1440<h3 id="images-in-tool-results">

1448 Изображения в результатах инструментов1441 Изображения в результатах инструментов

1449</h3>1442</h3>

1450 1443

1451Когда инструмент MCP возвращает изображение PNG, JPEG, GIF или WebP, Claude видит изображение встроенным в разговор. Встроенная копия может быть уменьшена или сжата, чтобы соответствовать ограничениям размера изображения модели. Claude Code также сохраняет исходные байты в файл в директории `tool-results` сеанса в [`~/.claude/projects/`](/docs/ru/claude-directory#cleaned-up-automatically) и предоставляет Claude путь к файлу. Claude затем может обрезать, конвертировать или повторно использовать полнофункциональный файл с помощью инструментов, таких как Bash.1444Когда инструмент MCP возвращает изображение PNG, JPEG, GIF или WebP, Claude видит изображение встроенным в диалог. Встроенная копия может быть уменьшена или сжата, чтобы соответствовать ограничениям размера изображения модели. Claude Code также сохраняет исходные байты в файл в директории `tool-results` сессии в [`~/.claude/projects/`](/docs/ru/claude-directory#cleaned-up-automatically) и предоставляет Claude путь к файлу. Claude затем может обрезать, конвертировать или повторно использовать файл в полном разрешении с помощью инструментов, таких как Bash.

1452 1445

1453Если вы отключите сохранение сеанса с помощью [`--no-session-persistence`](/docs/ru/cli-reference#cli-flags) или [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/ru/env-vars), Claude Code не будет записывать файл изображения, и Claude получит только встроенную копию.1446Если вы отключите сохранение сессии с помощью [`--no-session-persistence`](/docs/ru/cli-reference#cli-flags) или [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/ru/env-vars), Claude Code не будет записывать файл изображения, и Claude получит только встроенную копию.

1454 1447

1455Сохранение результатов изображений MCP в файл требует Claude Code версии 2.1.283 или более поздней.1448Сохранение результатов изображений MCP в файл требует Claude Code версии 2.1.283 или более поздней.

1456 1449

1490 1483

1491Если вы создаёте MCP-сервер, вы можете отметить инструмент как требующий явного подтверждения при каждом вызове, установив `_meta["anthropic/requiresUserInteraction"]` в значение `true` в записи инструмента в ответе `tools/list`. Значение должно быть логическим значением JSON `true`; любое другое значение игнорируется.1484Если вы создаёте MCP-сервер, вы можете отметить инструмент как требующий явного подтверждения при каждом вызове, установив `_meta["anthropic/requiresUserInteraction"]` в значение `true` в записи инструмента в ответе `tools/list`. Значение должно быть логическим значением JSON `true`; любое другое значение игнорируется.

1492 1485

1493Claude Code показывает запрос разрешения этого инструмента при каждом вызове, даже в [режимах разрешений](/docs/ru/permissions#permission-modes) `acceptEdits`, `auto` и `bypassPermissions`, и не предлагает для него опцию «не спрашивать снова». [Правила разрешений](/docs/ru/permissions#permission-rule-syntax), которые соответствуют инструменту, также не позволяют пропустить запрос. В режиме `dontAsk`, который никогда не выводит запросы, Claude Code вместо этого отклоняет вызов.1486Claude Code показывает запрос разрешения этого инструмента при каждом вызове, даже в [режимах разрешений](/docs/ru/permissions#permission-modes) `acceptEdits`, `auto` и `bypassPermissions`, и не предлагает для него опцию «не спрашивать снова». [Разрешающие правила](/docs/ru/permissions#permission-rule-syntax), которые соответствуют инструменту, также не позволяют пропустить запрос. В режиме `dontAsk`, который никогда не выводит запросы, Claude Code вместо этого отклоняет вызов.

1494 1487

1495Запрос должен дойти до человека. В неинтерактивном режиме с [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags) результат `allow` из инструмента запроса разрешения для отмеченного инструмента преобразуется в отклонение с сообщением `MCP tool requires user interaction; not supported via --permission-prompt-tool`. Обратный вызов [`canUseTool`](/docs/ru/agent-sdk/permissions) Agent SDK получает эти вызовы и может их подтвердить, потому что ваше приложение SDK должно показывать их пользователю.1488Запрос должен дойти до человека. В неинтерактивном режиме с [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags) результат `allow` из инструмента запроса разрешения для отмеченного инструмента преобразуется в отклонение с сообщением `MCP tool requires user interaction; not supported via --permission-prompt-tool`. Обратный вызов [`canUseTool`](/docs/ru/agent-sdk/permissions) Agent SDK получает эти вызовы и может их подтвердить, потому что ваше приложение SDK должно показывать их пользователю.

1496 1489

1582 Масштабирование с помощью поиска инструментов MCP1575 Масштабирование с помощью поиска инструментов MCP

1583</h2>1576</h2>

1584 1577

1585Поиск инструментов снижает использование контекста MCP, отложив определения инструментов до момента, когда они понадобятся Claude. При запуске сеанса загружаются только имена инструментов и инструкции сервера, поэтому добавление дополнительных серверов MCP имеет минимальное влияние на окно контекста. Claude Code не устанавливает фиксированный лимит инструментов на сервер; практический лимит определяется бюджетом окна контекста.1578Поиск инструментов снижает использование контекста MCP, отложив определения инструментов до момента, когда они понадобятся Claude. При запуске сессии загружаются только имена инструментов и инструкции сервера, поэтому добавление дополнительных серверов MCP имеет минимальное влияние на контекстное окно. Claude Code не устанавливает фиксированный лимит инструментов на сервер; практический лимит определяется бюджетом контекстного окна.

1586 1579

1587<Note>1580<Note>

1588 Поиск инструментов не поддерживается на Microsoft Foundry [развертываниях, размещенных на Azure](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options), которые отклоняют его на стороне сервера: Claude Code обнаруживает отклонение и загружает инструменты MCP заранее для этого развертывания. [`ENABLE_TOOL_SEARCH`](#configure-tool-search) не может переопределить это, так как отклонение исходит от самого развертывания.1581 Поиск инструментов не поддерживается на Microsoft Foundry [развёртываниях, размещённых на Azure](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options), которые отклоняют его на стороне сервера: Claude Code обнаруживает отклонение и загружает инструменты MCP заранее для этого развёртывания. [`ENABLE_TOOL_SEARCH`](#configure-tool-search) не может переопределить это, так как отклонение исходит от самого развёртывания.

1589</Note>1582</Note>

1590 1583

1591<h3 id="for-mcp-server-authors">1584<h3 id="for-mcp-server-authors">

1592 Для авторов серверов MCP1585 Для авторов серверов MCP

1593</h3>1586</h3>

1594 1587

1595Если вы создаете сервер MCP, поле инструкций сервера становится более полезным при включенном поиске инструментов. Инструкции сервера помогают Claude понять, когда следует искать ваши инструменты, аналогично тому, как работают [skills](/docs/ru/skills).1588Если вы создаёте сервер MCP, поле инструкций сервера становится более полезным при включённом поиске инструментов. Инструкции сервера помогают Claude понять, когда следует искать ваши инструменты, аналогично тому, как работают [скиллы](/docs/ru/skills).

1596 1589

1597Добавьте четкие, описательные инструкции сервера, которые объясняют:1590Добавьте чёткие, описательные инструкции сервера, которые объясняют:

1598 1591

1599* Какую категорию задач обрабатывают ваши инструменты1592* Какую категорию задач обрабатывают ваши инструменты

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

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

1602 1595

1603Claude Code усекает описания инструментов и инструкции сервера на 2 048 символов по умолчанию. Держите их в краткой форме, и поместите критические детали в начало.1596По умолчанию Claude Code усекает описание каждого инструмента и инструкции каждого сервера до 2 048 символов. Держите их в краткой форме и помещайте критические детали в начало.

1597

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

1599

1600<h4 id="per-tool-alwaysload">

1601 Пометка инструмента для загрузки заранее или отложенной загрузки

1602</h4>

1603

1604Чтобы управлять тем, как загружается один из инструментов вашего сервера, задайте `"anthropic/alwaysLoad"` в объекте `_meta` этого инструмента. Человек, который добавляет ваш сервер в Claude Code, также может задать [`alwaysLoad`](#exempt-a-server-from-deferral) для всего сервера в своей конфигурации, и его настройка может переопределить вашу:

1605

1606| Значение вашего инструмента | Что происходит |

1607| :- | :- |

1608| `true` | Инструмент загружается заранее. Из-за этого значения запуск не ждёт вашего сервера. Человек, настраивающий ваш сервер, всё равно может [отложить все его инструменты](#defer-a-servers-tools) |

1609| `false` | Инструмент остаётся отложенным, когда в его конфигурации задано `"alwaysLoad": true`. Это применяется, когда ваш сервер передаётся через [`--mcp-config`](/docs/ru/cli-reference#cli-flags), предоставляется [приложением Agent SDK](/docs/ru/agent-sdk/mcp#in-code) или [плагином](#plugin-provided-mcp-servers). На других серверах инструмент загружается заранее. Требуется Claude Code v2.1.285 или позже |

1604 1610

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

1612

1613```json theme={null}

1614{

1615 "name": "search_tickets",

1616 "description": "Searches the ticket tracker by keyword",

1617 "_meta": {

1618 "anthropic/alwaysLoad": true

1619 }

1620}

1621```

1606 1622

1607<h3 id="configure-tool-search">1623<h3 id="configure-tool-search">

1608 Настройка поиска инструментов1624 Настройка поиска инструментов

1609</h3>1625</h3>

1610 1626

1611Поиск инструментов включен по умолчанию: инструменты MCP отложены и обнаруживаются по требованию. Claude Code отключает его, когда `ANTHROPIC_BASE_URL` указывает на хост, не принадлежащий первой стороне, так как большинство прокси не пересылают блоки `tool_reference`. Установите `ENABLE_TOOL_SEARCH` явно, чтобы переопределить этот резервный вариант.1627Поиск инструментов включён по умолчанию: инструменты MCP отложены и обнаруживаются по требованию. Claude Code отключает его, когда `ANTHROPIC_BASE_URL` указывает на хост, не принадлежащий первой стороне, так как большинство прокси не пересылают блоки `tool_reference`. Установите `ENABLE_TOOL_SEARCH` явно, чтобы переопределить этот резервный вариант.

1612 1628

1613Установка [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/ru/env-vars) отключает поиск инструментов. Вы не можете переопределить это, установив `ENABLE_TOOL_SEARCH` самостоятельно. Ваша организация может оставить поиск инструментов включенным через [управляемые параметры](/docs/ru/managed-settings), на Claude Code v2.1.227 или позже. [Отключение предварительных возможностей](/docs/ru/llm-gateway-protocol#disable-pre-release-capabilities) охватывает, где применяется переопределение и что переменная удаляет.1629Установка [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/ru/env-vars) отключает поиск инструментов. Вы не можете переопределить это, установив `ENABLE_TOOL_SEARCH` самостоятельно. Ваша организация может оставить поиск инструментов включённым через [управляемые настройки](/docs/ru/managed-settings), на Claude Code v2.1.227 или позже. [Отключение предварительных возможностей](/docs/ru/llm-gateway-protocol#disable-pre-release-capabilities) охватывает, где применяется переопределение и что переменная удаляет.

1614 1630

1615Поиск инструментов требует модель, которая поддерживает блоки `tool_reference`: Claude Sonnet 4.5, Claude Haiku 4.5, Claude Opus 4.5 и более поздние модели. См. [совместимость моделей в документации API](https://platform.claude.com/docs/en/agents-and-tools/tool-use/tool-search-tool#model-compatibility) для получения текущего списка.1631Поиск инструментов требует модель, которая поддерживает блоки `tool_reference`: Claude Sonnet 4.5, Claude Haiku 4.5, Claude Opus 4.5 и более поздние модели. См. [совместимость моделей в документации API](https://platform.claude.com/docs/en/agents-and-tools/tool-use/tool-search-tool#model-compatibility) для получения текущего списка.

1616 1632

1617На Agent Platform Google Cloud, Claude Code решает по поколению модели:1633На Agent Platform Google Cloud Claude Code решает по поколению модели:

1618 1634

1619* **Claude Opus 4.5, Sonnet 4.5, Haiku 4.5 и позже**: поиск инструментов включен по умолчанию, как и на API Anthropic.1635* **Claude Opus 4.5, Sonnet 4.5, Haiku 4.5 и позже**: поиск инструментов включён по умолчанию, как и на API Anthropic.

1620* **Более ранние модели Agent Platform**: Claude Code загружает все инструменты MCP заранее, потому что их стеки обслуживания отклоняют требуемый заголовок бета-версии. `ENABLE_TOOL_SEARCH=true` не переопределяет это.1636* **Более ранние модели Agent Platform**: Claude Code загружает все инструменты MCP заранее, потому что их стеки обслуживания отклоняют требуемый заголовок бета-версии. `ENABLE_TOOL_SEARCH=true` не переопределяет это.

1621 1637

1622До версии 2.1.221 Claude Code отключал поиск инструментов для всех моделей на Agent Platform Google Cloud, если вы не установили `ENABLE_TOOL_SEARCH=true`.1638До версии 2.1.221 Claude Code отключал поиск инструментов для всех моделей на Agent Platform Google Cloud, если вы не установили `ENABLE_TOOL_SEARCH=true`.

1625 1641

1626| Значение | Поведение |1642| Значение | Поведение |

1627| :- | :- |1643| :- | :- |

1628| (не установлено) | Все инструменты MCP отложены и загружаются по требованию. Переходит на загрузку заранее на моделях Agent Platform Google Cloud более ранних, чем поколение Claude 4.5, когда `ANTHROPIC_BASE_URL` является хостом, не принадлежащим первой стороне, или на развертывании Microsoft Foundry, размещенном на Azure |1644| (не установлено) | Все инструменты MCP отложены и загружаются по требованию. Переключается на загрузку заранее на моделях Agent Platform Google Cloud более ранних, чем поколение Claude 4.5, когда `ANTHROPIC_BASE_URL` является хостом, не принадлежащим первой стороне, или на развёртывании Microsoft Foundry, размещённом на Azure |

1629| `true` | Все инструменты MCP отложены, кроме развертывания Microsoft Foundry, размещенного на Azure, где отклонение на стороне сервера все еще вынуждает загрузку заранее, и на моделях Agent Platform Google Cloud более ранних, чем поколение Claude 4.5, где Claude Code продолжает загружать инструменты заранее. Claude Code отправляет заголовок бета-версии через прокси, и запросы не выполняются на прокси, которые не поддерживают блоки `tool_reference` |1645| `true` | Все инструменты MCP отложены, кроме развёртывания Microsoft Foundry, размещённого на Azure, где отклонение на стороне сервера всё ещё вынуждает загрузку заранее, и моделей Agent Platform Google Cloud более ранних, чем поколение Claude 4.5, где Claude Code продолжает загружать инструменты заранее. Claude Code отправляет заголовок бета-версии через прокси, и запросы не выполняются на прокси, которые не поддерживают блоки `tool_reference` |

1630| `auto` | Режим порога: Claude Code загружает инструменты, которые он иначе отложил бы, заранее, пока их определения составляют менее 10% окна контекста, и отложит все из них, как только определения достигнут 10% |1646| `auto` | Режим порога: Claude Code загружает инструменты, которые он иначе отложил бы, заранее, пока их определения составляют менее 10% контекстного окна, и откладывает все из них, как только определения достигнут 10% |

1633 1649

1655 Исключение сервера из отложения1671 Исключение сервера из отложения

1656</h3>1672</h3>

1657 1673

1658Если инструменты сервера всегда должны быть видны Claude без этапа поиска, установите `alwaysLoad` в значение `true` в конфигурации этого сервера. Каждый инструмент с этого сервера затем загружается в контекст при запуске сеанса независимо от параметра `ENABLE_TOOL_SEARCH`. Используйте это для небольшого количества инструментов, которые Claude нужны на каждом ходу, так как каждый заранее загруженный инструмент потребляет контекст, который иначе был бы доступен для вашего разговора.1674Если инструменты сервера всегда должны быть видны Claude без этапа поиска, установите `alwaysLoad` в значение `true` в конфигурации этого сервера. Инструменты сервера затем загружаются в контекст независимо от настройки `ENABLE_TOOL_SEARCH`. Используйте это для небольшого количества инструментов, которые Claude нужны на каждом ходу, так как каждый заранее загруженный инструмент потребляет контекст, который иначе был бы доступен для вашего диалога.

1659 1675

1660Следующая запись `.mcp.json` исключает один HTTP-сервер, оставляя другие серверы отложенными:1676Следующая запись `.mcp.json` исключает один HTTP-сервер, оставляя другие серверы отложенными:

1661 1677

1671}1687}

1672```1688```

1673 1689

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

1691

1692Установка `alwaysLoad: true` также заставляет запуск ждать инструментов сервера, ограниченных стандартным таймаутом подключения в 5 секунд, так как они должны присутствовать при построении первого промпта. Удалённый сервер с действительной записью [`cached`](#server-status-detail) предоставляет свои инструменты из кэша без подключения, поэтому он не задерживает запуск. Другие серверы подключаются в фоновом режиме по умолчанию; установите [`MCP_CONNECTION_NONBLOCKING=0`](/docs/ru/env-vars), чтобы запуск ждал и их тоже.

1693

1694<h3 id="defer-a-servers-tools">

1695 Отложение инструментов сервера

1696</h3>

1675 1697

1676Установка `alwaysLoad: true` также заставляет запуск ждать инструментов сервера, ограниченных стандартным тайм-аутом подключения в 5 секунд, так как они должны присутствовать при построении первого запроса. Удаленный сервер с действительной записью [`cached`](#server-status-detail) предоставляет свои инструменты из кэша без подключения, поэтому он не задерживает запуск. Другие серверы подключаются в фоновом режиме по умолчанию; установите [`MCP_CONNECTION_NONBLOCKING=0`](/docs/ru/env-vars), чтобы запуск ждал и их тоже.1698Чтобы все инструменты сервера оставались за поиском инструментов, задайте `"alwaysLoad": false` в записи этого сервера в вашей конфигурации MCP. Это относится и к инструментам, которые автор сервера [пометил для загрузки заранее](#per-tool-alwaysload). Если не указывать `alwaysLoad`, эти помеченные инструменты загружаются заранее. Требуется Claude Code v2.1.287 или позже.

1677 1699

1678<h2 id="use-mcp-prompts-as-commands">1700<h2 id="use-mcp-prompts-as-commands">

1679 Использование MCP prompts как команд1701 Использование MCP prompts как команд

memory.md +5 −3

Details

161 161

162Все обнаруженные файлы объединяются в контекст, а не переопределяют друг друга. По дереву каталогов содержимое упорядочено от корня файловой системы вниз к вашему рабочему каталогу. Для примера `foo/bar/`, `foo/CLAUDE.md` появляется в контексте перед `foo/bar/CLAUDE.md`, поэтому инструкции ближе к месту, где вы запустили Claude, читаются последними. В каждом каталоге `CLAUDE.local.md` добавляется после `CLAUDE.md`, поэтому ваши личные заметки — это последнее, что Claude читает на этом уровне.162Все обнаруженные файлы объединяются в контекст, а не переопределяют друг друга. По дереву каталогов содержимое упорядочено от корня файловой системы вниз к вашему рабочему каталогу. Для примера `foo/bar/`, `foo/CLAUDE.md` появляется в контексте перед `foo/bar/CLAUDE.md`, поэтому инструкции ближе к месту, где вы запустили Claude, читаются последними. В каждом каталоге `CLAUDE.local.md` добавляется после `CLAUDE.md`, поэтому ваши личные заметки — это последнее, что Claude читает на этом уровне.

163 163

164Claude также обнаруживает файлы `CLAUDE.md` и `CLAUDE.local.md` в подкаталогах под вашим текущим рабочим каталогом. Вместо загрузки их при запуске Claude Code включает их, когда Claude использует инструмент [Read](/docs/ru/tools-reference#read-tool-behavior), [Write](/docs/ru/tools-reference#write-tool-behavior) или [Edit](/docs/ru/tools-reference#edit-tool-behavior) для файла в этих подкаталогах. Если Claude уже использовал один из этих инструментов для самого `CLAUDE.md` подкаталога, этот файл таким образом не загружается, потому что Claude Code считает, что он уже находится в диалоге. Для файлов внутри worktree в `.claude/worktrees/` см. [Изоляция субагентов с помощью worktrees](/docs/ru/worktrees#isolate-subagents-with-worktrees).164Claude также обнаруживает файлы `CLAUDE.md` и `CLAUDE.local.md` в подкаталогах под вашим текущим рабочим каталогом. Вместо загрузки их при запуске Claude Code загружает каждый из них, как только Claude читает, записывает или редактирует другой файл в этом подкаталоге. Чтение включает просмотр файла с помощью команды Bash, которая [считается чтением](/docs/ru/tools-reference#edit-tool-behavior), например `cat` или `head` для одного файла. Для файлов внутри worktree в `.claude/worktrees/` см. [Изоляция субагентов с помощью worktrees](/docs/ru/worktrees#isolate-subagents-with-worktrees).

165 165

166Если вы работаете в большом монорепозитории, где подбираются файлы CLAUDE.md других команд, используйте [`claudeMdExcludes`](#exclude-specific-claude-md-files) для их пропуска. Для полного макета корневых и каталогов CLAUDE.md файлов и правил см. [Монорепозитории и большие репозитории](/docs/ru/large-codebases).166Если вы работаете в большом монорепозитории, где подбираются файлы CLAUDE.md других команд, используйте [`claudeMdExcludes`](#exclude-specific-claude-md-files) для их пропуска. Для полного макета корневых и каталогов CLAUDE.md файлов и правил см. [Монорепозитории и большие репозитории](/docs/ru/large-codebases).

167 167

232- Include OpenAPI documentation comments232- Include OpenAPI documentation comments

233```233```

234 234

235Правила без поля `paths` загружаются безусловно и применяются ко всем файлам. Path-scoped правила срабатывают, когда Claude использует инструмент Read, Write или Edit для файла, совпадающего с шаблоном, а не при каждом использовании инструмента. Сопоставление также работает, когда Claude достигает файла через символически связанный путь к каталогу проекта, например в символически связанном checkout.235Правила без поля `paths` загружаются безусловно и применяются ко всем файлам. Path-scoped правило загружается, когда Claude использует инструмент Read, Write или Edit для совпадающего файла. Оно также загружается, когда Claude просматривает совпадающий файл с помощью команды Bash, которая [считается чтением](/docs/ru/tools-reference#edit-tool-behavior), например `cat` или `head` для одного файла. Сопоставление также работает, когда Claude достигает файла через символически связанный путь к каталогу проекта, например в символически связанном checkout.

236 236

237Используйте glob шаблоны в поле `paths` для сопоставления файлов по расширению, каталогу или любой комбинации:237Используйте glob шаблоны в поле `paths` для сопоставления файлов по расширению, каталогу или любой комбинации:

238 238

278 278

279Каталог `.claude/rules/` поддерживает символические ссылки, поэтому вы можете поддерживать общий набор правил и связывать их в несколько проектов. Циклические символические ссылки обнаруживаются и обрабатываются корректно.279Каталог `.claude/rules/` поддерживает символические ссылки, поэтому вы можете поддерживать общий набор правил и связывать их в несколько проектов. Циклические символические ссылки обнаруживаются и обрабатываются корректно.

280 280

281Claude Code рассматривает символическую ссылку, цель которой находится вне вашего рабочего каталога, как [внешний импорт](#import-additional-files). Связанные правила не загружаются, пока вы не подтвердите внешние импорты для проекта, и после этого загружаются только те, которые не имеют [поля `paths`](#path-specific-rules). Claude Code запрашивает это подтверждение только когда файл памяти проекта импортирует файл вне рабочего каталога с `@path`, а не для самих символических ссылок. Чтобы загружать общие правила без этого подтверждения, держите их в [`~/.claude/rules/`](#user-level-rules), где они применяются к каждому проекту на вашей машине.281Claude Code рассматривает символическую ссылку, цель которой находится вне вашего рабочего каталога, как [внешний импорт](#import-additional-files). Связанные правила не загружаются, пока вы не подтвердите внешние импорты для проекта, и после этого загружаются только те, которые не имеют [поля `paths`](#path-specific-rules).

282

283Claude Code запрашивает это подтверждение один раз для каждого проекта в диалоговом окне в начале интерактивной сессии. В диалоговом окне перечислены связанные файлы правил вместе со всеми внешними импортами `@path`. Чтобы загружать общие правила без этого подтверждения, держите их в [`~/.claude/rules/`](#user-level-rules), где они применяются к каждому проекту на вашей машине.

282 284

283Этот пример связывает как общий каталог, так и отдельный файл:285Этот пример связывает как общий каталог, так и отдельный файл:

284 286

microsoft-foundry.md +45 −11

Details

116 2) Настройка учётных данных Azure116 2) Настройка учётных данных Azure

117</h3>117</h3>

118 118

119Claude Code поддерживает три метода аутентификации для Microsoft Foundry. Выберите метод, который лучше всего соответствует вашим требованиям безопасности.119Claude Code поддерживает три метода аутентификации для Microsoft Foundry. Выберите метод, который лучше всего соответствует вашим требованиям безопасности:

120 120

121**Вариант A: Аутентификация по API-ключу**121* [API-ключ](#use-an-api-key): вы копируете ключ на портале Microsoft Foundry и устанавливаете его как `ANTHROPIC_FOUNDRY_API_KEY`

122* [Microsoft Entra ID](#use-microsoft-entra-id): Claude Code получает токены через цепочку учётных данных по умолчанию Azure SDK, например из сессии `az login`, поэтому хранить API-ключ не нужно

123* [Bearer-токен](#use-a-bearer-token): другой процесс получает токен доступа Microsoft Entra ID, и вы передаёте его в `ANTHROPIC_FOUNDRY_AUTH_TOKEN`

124

125<Note>

126 При использовании Microsoft Foundry команда `/logout` недоступна, так как аутентификация обрабатывается через учётные данные Azure.

127</Note>

128

129<h4 id="use-an-api-key">

130 Использование API-ключа

131</h4>

132

133Скопируйте ключ на портале Microsoft Foundry, затем установите его как переменную окружения:

122 134

1231. Перейдите к вашему ресурсу на портале Microsoft Foundry1351. Перейдите к вашему ресурсу на портале Microsoft Foundry

1242. Перейдите в раздел **Endpoints and keys**1362. Откройте раздел **Endpoints and keys**

1253. Скопируйте **API Key**1373. Скопируйте **API Key**

1264. Установите переменную окружения, заменив `your-azure-api-key` на скопированный ключ:1384. Установите переменную окружения, заменив `your-azure-api-key` на скопированный ключ:

127 139

129export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key141export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key

130```142```

131 143

132**Вариант B: Аутентификация Microsoft Entra ID**144<h4 id="use-microsoft-entra-id">

145 Использование Microsoft Entra ID

146</h4>

133 147

134Когда ни `ANTHROPIC_FOUNDRY_API_KEY`, ни `ANTHROPIC_FOUNDRY_AUTH_TOKEN` не установлены, Claude Code автоматически использует Azure SDK [цепочку учётных данных по умолчанию](https://learn.microsoft.com/en-us/azure/developer/javascript/sdk/authentication/credential-chains#defaultazurecredential-overview).148Оставьте `ANTHROPIC_FOUNDRY_API_KEY` и `ANTHROPIC_FOUNDRY_AUTH_TOKEN` неустановленными. Тогда Claude Code использует Azure SDK [цепочку учётных данных по умолчанию](https://learn.microsoft.com/en-us/azure/developer/javascript/sdk/authentication/credential-chains#defaultazurecredential-overview).

135Это поддерживает различные методы аутентификации локальных и удалённых рабочих нагрузок.149Это поддерживает различные методы аутентификации локальных и удалённых рабочих нагрузок.

136 150

137В локальных средах вы обычно можете использовать Azure CLI:151На локальном компьютере войдите с помощью Azure CLI:

138 152

139```bash theme={null}153```bash theme={null}

140az login154az login

141```155```

142 156

143**Вариант C: Аутентификация с использованием токена Bearer**157О ролях, необходимых вашей учётной записи, см. [Конфигурация Azure RBAC](#azure-rbac-configuration).

158

159<h4 id="use-a-bearer-token">

160 Использование Bearer-токена

161</h4>

144 162

145Claude Code отправляет значение `ANTHROPIC_FOUNDRY_AUTH_TOKEN` в каждом запросе в качестве заголовка `Authorization: Bearer`. Используйте этот вариант, когда другой процесс, такой как хост-приложение или скрипт входа, уже получил для вас токен доступа. Требуется Claude Code версии 2.1.203 или позже.163Claude Code отправляет значение `ANTHROPIC_FOUNDRY_AUTH_TOKEN` в каждом запросе в качестве заголовка `Authorization: Bearer`. Используйте этот вариант, когда другой процесс, такой как хост-приложение или скрипт входа, уже получил для вас токен доступа. Требуется Claude Code версии 2.1.203 или позже.

146 164

152 170

153`ANTHROPIC_FOUNDRY_AUTH_TOKEN` имеет приоритет над `ANTHROPIC_FOUNDRY_API_KEY` и над цепочкой учётных данных по умолчанию.171`ANTHROPIC_FOUNDRY_AUTH_TOKEN` имеет приоритет над `ANTHROPIC_FOUNDRY_API_KEY` и над цепочкой учётных данных по умолчанию.

154 172

155<Note>

156 При использовании Microsoft Foundry команда `/logout` недоступна, так как аутентификация обрабатывается через учётные данные Azure.

157</Note>

~~158~~

159<h3 id="3-configure-claude-code">173<h3 id="3-configure-claude-code">

160 3. Настройка Claude Code174 3. Настройка Claude Code

161</h3>175</h3>

240 254

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

242 256

257<h2 id="1m-token-context-window">

258 Контекстное окно на 1M токенов

259</h2>

260

261В Microsoft Foundry, когда Claude Code может определить, какую модель обслуживает ваше развёртывание, модели Fable, Sonnet 5 и более поздние, а также Opus 4.7 и более поздние по умолчанию работают с [контекстным окном на 1M токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model), и суффикс `[1m]` не требуется. Claude Code определяет модель по имени развёртывания в ваших переменных модели. Назовите каждое развёртывание по идентификатору его модели, например `claude-opus-4-8`, или сопоставьте модель с именем вашего развёртывания с помощью [`modelOverrides`](/docs/ru/model-config#override-model-ids-per-version). Для имени развёртывания, которое не удаётся сопоставить с моделью, Claude Code предполагает окно размером 200K, если вы не [укажете другое](/docs/ru/model-config#correct-the-window-for-a-gateway-or-custom-model-id).

262

263Эта запись в `settings.json` сообщает Claude Code, что развёртывание с именем `team-opus-prod` обслуживает Opus 4.8:

264

265```json theme={null}

266{

267 "modelOverrides": {

268 "claude-opus-4-8": "team-opus-prod"

269 }

270}

271```

272

273Чтобы вместо этого сохранить окно размером 200K, задайте [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/ru/model-config#turn-off-1m-context).

274

275Opus 4.6 и Sonnet 4.6 получают окно на 1M, если добавить `[1m]` к имени развёртывания в `ANTHROPIC_DEFAULT_OPUS_MODEL` или `ANTHROPIC_DEFAULT_SONNET_MODEL`, как описано в разделе [Закрепление моделей для сторонних развёртываний](/docs/ru/model-config#pin-models-for-third-party-deployments). До версии v2.1.287 моделям Fable, а также Opus 4.7 и более поздним в Microsoft Foundry тоже требовался этот суффикс, а без него они по умолчанию работали с окном размером 200K.

276

243<h2 id="troubleshooting">277<h2 id="troubleshooting">

244 Устранение неполадок278 Устранение неполадок

245</h2>279</h2>

model-config.md +263 −253

Details

10 Доступные модели10 Доступные модели

11</h2>11</h2>

12 12

~~13Для параметра `model` в Claude Code вы можете настроить либо:~~13Для настройки `model` в Claude Code вы можете указать либо:

14 14

15* **Псевдоним модели**15* **Псевдоним модели**

16* **Имя модели**16* **Имя модели**

22Рекомендации по выбору модели и уровня усилий для различных типов работ см. в статье [Choosing a Claude model and effort level in Claude Code](https://claude.com/blog/claude-model-and-effort-level-in-claude-code) в блоге.22Рекомендации по выбору модели и уровня усилий для различных типов работ см. в статье [Choosing a Claude model and effort level in Claude Code](https://claude.com/blog/claude-model-and-effort-level-in-claude-code) в блоге.

23 23

24<Note>24<Note>

25 `ANTHROPIC_BASE_URL` изменяет, куда отправляются запросы, а не какая модель на них отвечает. Чтобы маршрутизировать Claude через шлюз LLM, см. [LLM gateways](/docs/ru/llm-gateway).25 `ANTHROPIC_BASE_URL` изменяет, куда отправляются запросы, а не какая модель на них отвечает. Чтобы маршрутизировать Claude через LLM-шлюз, см. [LLM gateways](/docs/ru/llm-gateway).

26</Note>26</Note>

27 27

28<h3 id="model-aliases">28<h3 id="model-aliases">

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

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

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

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

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

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

45 45

46Псевдонимы `opus`, `sonnet` и `haiku` разрешаются на новейшую версию в Anthropic API и на более раннюю версию у некоторых других поставщиков:46Псевдонимы `opus`, `sonnet` и `haiku` разрешаются на новейшую версию в Anthropic API и на более раннюю версию у некоторых других поставщиков:

47 47

54 54

55<span id="fable-alias-resolution" />55<span id="fable-alias-resolution" />

56 56

57Если вы не установили `ANTHROPIC_DEFAULT_FABLE_MODEL`, псевдоним `fable` разрешается на Fable 5.1, за исключением сеансов [Claude apps gateway](/docs/ru/claude-apps-gateway), где `fable` и `best` разрешаются на Fable 5.57Если вы не установили `ANTHROPIC_DEFAULT_FABLE_MODEL`, псевдоним `fable` разрешается на Fable 5.1, за исключением сессий [Claude apps gateway](/docs/ru/claude-apps-gateway), где `fable` и `best` разрешаются на Fable 5.

58 58

59Шлюз, который не настроен на обслуживание `claude-fable-5-1`, отклоняет запросы для этой модели. Чтобы использовать Fable 5.1 через шлюз, который его обслуживает, выберите его с помощью `/model claude-fable-5-1`.59Шлюз, который не настроен на обслуживание `claude-fable-5-1`, отклоняет запросы для этой модели. Чтобы использовать Fable 5.1 через шлюз, который его обслуживает, выберите его с помощью `/model claude-fable-5-1`.

60 60

72 Работа с Fable72 Работа с Fable

73</h3>73</h3>

74 74

75[Claude Fable 5.1](https://platform.claude.com/docs/en/about-claude/models/overview) и Claude Fable 5 — это наиболее мощные модели в Claude Code, подходящие для задач, требующих более одного сеанса. Они поддерживают длительные автономные сеансы, исследуют перед действием и проверяют свою работу чаще, чем меньшие модели. Fable 5.1 — это более новый выпуск.75[Claude Fable 5.1](https://platform.claude.com/docs/en/about-claude/models/overview) и Claude Fable 5 — это наиболее мощные модели в Claude Code, подходящие для задач, требующих более одной сессии. Они поддерживают длительные автономные сессии, исследуют перед действием и проверяют свою работу чаще, чем меньшие модели. Fable 5.1 — это более новый выпуск.

76 76

77Ни одна из моделей Fable не является стандартной для типа учётной записи ни на одном плане или поставщике. Выберите одну явно:77Ни одна из моделей Fable не является стандартной для типа учётной записи ни на одном плане или поставщике. Выберите одну явно:

78 78

79* **Fable 5.1**: запустите `/model fable` или запустите с помощью `claude --model fable`. В сеансах [Claude apps gateway](/docs/ru/claude-apps-gateway), где псевдоним разрешается на Fable 5, вместо этого запустите `/model claude-fable-5-1`.79* **Fable 5.1**: запустите `/model fable` или запустите с помощью `claude --model fable`. В сессиях [Claude apps gateway](/docs/ru/claude-apps-gateway), где псевдоним разрешается на Fable 5, вместо этого запустите `/model claude-fable-5-1`.

80* **Fable 5**: выберите её по ID модели. В Anthropic API запустите `/model claude-fable-5` или запустите с помощью `claude --model claude-fable-5`. На других поставщиках используйте ID модели Fable 5 вашего поставщика или [закрепите её](#pin-models-for-third-party-deployments) с помощью `ANTHROPIC_DEFAULT_FABLE_MODEL`.80* **Fable 5**: выберите её по ID модели. В Anthropic API запустите `/model claude-fable-5` или запустите с помощью `claude --model claude-fable-5`. На других поставщиках используйте ID модели Fable 5 вашего поставщика или [закрепите её](#pin-models-for-third-party-deployments) с помощью `ANTHROPIC_DEFAULT_FABLE_MODEL`.

81 81

82Если вы подключаетесь непосредственно к Anthropic API и ваши пользовательские параметры содержат `claude-fable-5` или `claude-fable-5[1m]` в качестве модели, например потому что вы выбрали Fable в средстве выбора `/model` до версии 2.1.257, Claude Code изменит это сохранённое значение на псевдоним `fable` или `fable[1m]` при первом запуске версии 2.1.257 или позже. Строка запуска модели показывает `(auto-updated)` один раз. Значение `claude-fable-5` в параметрах проекта, локальных или управляемых параметрах остаётся как есть.82Если вы подключаетесь непосредственно к Anthropic API и ваши пользовательские настройки содержат `claude-fable-5` или `claude-fable-5[1m]` в качестве модели, например потому что вы выбрали Fable в средстве выбора `/model` до версии 2.1.257, Claude Code изменит это сохранённое значение на псевдоним `fable` или `fable[1m]` при первом запуске версии 2.1.257 или позже. Строка запуска модели показывает `(auto-updated)` один раз. Значение `claude-fable-5` в настройках проекта, локальных или управляемых настройках остаётся как есть.

83 83

84Запросы, которые классификаторы безопасности модели Fable помечают, чаще всего в областях кибербезопасности и биологии, запускают [автоматический откат модели](#automatic-model-fallback).84Запросы, которые классификаторы безопасности модели Fable помечают, чаще всего в областях кибербезопасности и биологии, запускают [автоматическое переключение на резервную модель](#automatic-model-fallback).

85 85

86Чтобы получить максимум от Fable:86Чтобы получить максимум от Fable:

87 87

88* **Описывайте результат, а не шаги**: дайте ей результат, который вы хотите, и позвольте ей спланировать путь. Чтобы она продолжала работать над этим результатом, [установите цель](/docs/ru/goal).88* **Описывайте результат, а не шаги**: дайте ей результат, который вы хотите, и позвольте ей спланировать путь. Чтобы она продолжала работать над этим результатом, [установите цель](/docs/ru/goal).

89* **Дайте ей неоднозначные проблемы**: исследования коренных причин, отладка сбоев и решения по архитектуре — это то, где дополнительное исследование и проверка окупаются.89* **Дайте ей неоднозначные проблемы**: исследования коренных причин, отладка сбоев и решения по архитектуре — это то, где дополнительное исследование и проверка окупаются.

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

91* **Масштабируйте более крупные задачи**: дайте ей работу, которую вы обычно разбиваете на части. Она выдерживает длительные сеансы без потери нити.91* **Масштабируйте более крупные задачи**: дайте ей работу, которую вы обычно разбиваете на части. Она выдерживает длительные сессии без потери нити.

92 92

93<Note>93<Note>

94 Fable 5.1 требует Claude Code версии 2.1.257 или позже. Если запрос для неё из более старой версии не удаётся, см. [Claude Code does not support this model](/docs/ru/errors#claude-code-does-not-support-this-model). Запустите `claude update` для обновления. Для доступности при нулевом сохранении данных см. [Model availability under ZDR](/docs/ru/zero-data-retention#model-availability-under-zdr).94 Fable 5.1 требует Claude Code версии 2.1.257 или позже. Если запрос для неё из более старой версии не удаётся, см. [Claude Code does not support this model](/docs/ru/errors#claude-code-does-not-support-this-model). Запустите `claude update` для обновления. Для доступности при нулевом сохранении данных см. [Model availability under ZDR](/docs/ru/zero-data-retention#model-availability-under-zdr).

100 Fable и кредиты использования100 Fable и кредиты использования

101</h4>101</h4>

102 102

103В зависимости от вашего плана и уровня места, использование Fable может выставляться в счёт [кредитам использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) вместо использования включённых лимитов вашего плана. Когда это происходит, средство выбора `/model` показывает "Requires usage credits" в строке Fable. Для управления кредитами использования см. [Add usage credits to your subscription](/docs/ru/costs#add-usage-credits-to-your-subscription).103В зависимости от вашего плана и уровня места использование Fable может оплачиваться из [кредитов использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) вместо использования включённых лимитов вашего плана. Когда это происходит, средство выбора `/model` показывает "Requires usage credits" в строке Fable. Для управления кредитами использования см. [Add usage credits to your subscription](/docs/ru/costs#add-usage-credits-to-your-subscription).

104 104

105В интерактивных сеансах Claude Code показывает запрос согласия перед запросом Fable, который выставляет кредиты использования. Члены планов Enterprise с организационным выставлением счётов не видят запрос. Вы можете продолжить работу на Fable, используя кредиты использования, или переключиться на вашу модель по умолчанию. Вы также можете отклонить запрос:105В интерактивных сессиях Claude Code показывает запрос согласия перед запросом Fable, который оплачивается из кредитов использования. Члены планов Enterprise с организационным биллингом не видят запрос. Вы можете продолжить работу на Fable, используя кредиты использования, или переключиться на вашу модель по умолчанию. Вы также можете отклонить запрос:

106 106

107* Когда вы выбираете модель Fable с помощью `/model`, вы сохраняете вашу текущую модель.107* Когда вы выбираете модель Fable с помощью `/model`, вы сохраняете вашу текущую модель.

108* Во время сеанса Claude Code продолжает ход на вашей модели по умолчанию.108* Во время сессии Claude Code продолжает ход на вашей модели по умолчанию.

109 109

110После того как вы выберете продолжить работу на Fable, используя кредиты использования, Claude Code больше не показывает запрос.110После того как вы выберете продолжить работу на Fable, используя кредиты использования, Claude Code больше не показывает запрос.

111 111

112В сеансе с подключённым [Remote Control](/docs/ru/remote-control), [фоновом сеансе](/docs/ru/agent-view) или сеансе товарища по [команде агентов](/docs/ru/agent-teams), никто не может быть у терминала, поэтому Claude Code удерживает запрос согласия во время сеанса до крайнего срока [`dialogExpiry`](/docs/ru/settings-reference#dialogexpiry), пять минут по умолчанию. Если никто не ответил к крайнему сроку, Claude Code завершает ход без отправки запроса и добавляет примечание в стенограмму, которое также показывает клиент Remote Control. Ваш выбор модели не изменяется, и Claude Code снова запрашивает согласие при следующем сообщении.112В сессии с подключённым [Remote Control](/docs/ru/remote-control), [фоновой сессии](/docs/ru/agent-view) или сессии участника [команды агентов](/docs/ru/agent-teams) у терминала может никого не быть, поэтому Claude Code удерживает запрос согласия во время сессии до крайнего срока [`dialogExpiry`](/docs/ru/settings-reference#dialogexpiry), пять минут по умолчанию. Если никто не ответил к крайнему сроку, Claude Code завершает ход без отправки запроса и добавляет примечание в транскрипт, которое также показывает клиент Remote Control. Ваш выбор модели не изменяется, и Claude Code снова запрашивает согласие при следующем сообщении.

113 113

114То, что вы можете делать во время ожидания запроса, зависит от сеанса:114То, что вы можете делать во время ожидания запроса, зависит от сессии:

115 115

116* С подключённым Remote Control или в сеансе товарища нажмите любую клавишу у терминала, чтобы отменить крайний срок, и Claude Code будет ждать вашего ответа.116* С подключённым Remote Control или в сессии участника команды нажмите любую клавишу у терминала, чтобы отменить крайний срок, и Claude Code будет ждать вашего ответа.

117* В фоновом сеансе ответьте до крайнего срока.117* В фоновой сессии ответьте до крайнего срока.

118* Если вы отправите новое сообщение от удалённого клиента до того, как кто-нибудь напечатает у терминала, Claude Code завершит ход так же, и ваше новое сообщение начнёт следующий ход. После того как кто-нибудь напечатает у терминала, Claude Code продолжит ждать ответа и поставит ваше новое сообщение в очередь позади него.118* Если вы отправите новое сообщение от удалённого клиента до того, как кто-нибудь напечатает у терминала, Claude Code завершит ход так же, и ваше новое сообщение начнёт следующий ход. После того как кто-нибудь напечатает у терминала, Claude Code продолжит ждать ответа и поставит ваше новое сообщение в очередь позади него.

119 119

120В сеансе, размещённом другим приложением через [Agent SDK](/docs/ru/agent-sdk/overview), появляется ли запрос, зависит от этого приложения. Если он появляется и никто не ответит до того же крайнего срока [`dialogExpiry`](/docs/ru/settings-reference#dialogexpiry), Claude Code завершает ход без отправки запроса.120В сессии, размещённой другим приложением через [Agent SDK](/docs/ru/agent-sdk/overview), появляется ли запрос, зависит от этого приложения. Если он появляется и никто не ответит до того же крайнего срока [`dialogExpiry`](/docs/ru/settings-reference#dialogexpiry), Claude Code завершает ход без отправки запроса.

121 121

122В [неинтерактивном режиме](/docs/ru/headless) с флагом `-p` и в приложении Agent SDK, которое не показывает запрос, Claude Code никогда не запрашивает согласие. Когда запрос Fable там выставляет кредиты использования, Claude Code выставляет его без запроса.122В [неинтерактивном режиме](/docs/ru/headless) с флагом `-p` и в приложении Agent SDK, которое не показывает запрос, Claude Code никогда не запрашивает согласие. Когда запрос Fable там должен оплачиваться из кредитов использования, Claude Code оплачивает его без запроса.

123 123

124<h3 id="setting-your-model">124<h3 id="setting-your-model">

125 Установка вашей модели125 Установка вашей модели

127 127

128Вы можете настроить вашу модель несколькими способами, перечисленными в порядке приоритета:128Вы можете настроить вашу модель несколькими способами, перечисленными в порядке приоритета:

129 129

1301. **Во время сеанса**: используйте `/model <alias|name>` для немедленного переключения или запустите `/model` без аргумента, чтобы открыть средство выбора. См. [когда Claude Code просит вас подтвердить переключение](/docs/ru/prompt-caching#switching-models)1301. **Во время сессии**: используйте `/model <alias|name>` для немедленного переключения или запустите `/model` без аргумента, чтобы открыть средство выбора. См. [когда Claude Code просит вас подтвердить переключение](/docs/ru/prompt-caching#switching-models)

1312. **При запуске**: запустите с помощью `claude --model <alias|name>`1312. **При запуске**: запустите с помощью `claude --model <alias|name>`

1323. **Переменная окружения**: установите `ANTHROPIC_MODEL=<alias|name>`1323. **Переменная окружения**: установите `ANTHROPIC_MODEL=<alias|name>`

1334. **Параметры**: настройте постоянно в файле параметров, используя поле `model`1334. **Настройки**: настройте постоянно в файле настроек, используя поле `model`

1345. **[Стандартная для новых сеансов](#set-a-default-model-for-new-sessions)**: установите `ANTHROPIC_DEFAULT_MODEL=<alias|name>`1345. **[Стандартная для новых сессий](#set-a-default-model-for-new-sessions)**: установите `ANTHROPIC_DEFAULT_MODEL=<alias|name>`

135 135

136`/model` сохраняет ваш выбор как стандартный для новых сеансов, записывая поле `model` в ваши пользовательские параметры. В средстве выбора:136`/model` сохраняет ваш выбор как стандартный для новых сессий, записывая поле `model` в ваши пользовательские настройки. В средстве выбора:

137 137

138* `Enter`: переключить модель и сохранить как вашу стандартную138* `Enter`: переключить модель и сохранить как вашу стандартную

139* `s`: переключить модель только для этого сеанса и оставить вашу стандартную без изменений. Чтобы использовать другую клавишу, переназначьте [`modelPicker:thisSessionOnly`](/docs/ru/keybindings#model-picker-actions)139* `s`: переключить модель только для этой сессии и оставить вашу стандартную без изменений. Чтобы использовать другую клавишу, переназначьте [`modelPicker:thisSessionOnly`](/docs/ru/keybindings#model-picker-actions)

140 140

141Ввод `/model <name>` напрямую ведёт себя как `Enter`. Чтобы переключиться только для этого сеанса, откройте средство выбора с помощью `/model` и нажмите `s` в строке модели.141Ввод `/model <name>` напрямую ведёт себя как `Enter`. Чтобы переключиться только для этой сессии, откройте средство выбора с помощью `/model` и нажмите `s` в строке модели.

142 142

143На плане Enterprise, когда вы вошли в систему с помощью своей учётной записи claude.ai и сохранили стандартную с помощью `/model`, Claude Code также записывает выбор на эту учётную запись. Это требует Claude Code версии 2.1.280 или позже.143На плане Enterprise, когда вы вошли в систему с помощью своей учётной записи claude.ai и сохранили стандартную с помощью `/model`, Claude Code также записывает выбор на эту учётную запись. Это требует Claude Code версии 2.1.280 или позже.

144 144

146* Если [ограничения модели](#restrict-model-selection) исключают записанную модель или она недоступна для вашей учётной записи, и ваш администратор не установил стандартную модель организации, опция Default разрешается так, как если бы ничего не было записано.146* Если [ограничения модели](#restrict-model-selection) исключают записанную модель или она недоступна для вашей учётной записи, и ваш администратор не установил стандартную модель организации, опция Default разрешается так, как если бы ничего не было записано.

147* Если вы выберете Default или `opusplan` в `/model`, записанный выбор не изменяется.147* Если вы выберете Default или `opusplan` в `/model`, записанный выбор не изменяется.

148 148

149Если вы переключаете модели с помощью `/model`, переключение также достигает [подагентов, которые наследуют модель основного разговора](/docs/ru/sub-agents#choose-a-model), потому что Claude Code разрешает их модель из той, которую использует ваш сеанс, когда Claude их запускает. Переключитесь на Opus перед тем, как Claude делегирует исследование или тестовые запуски одному из них, и эта работа также будет выполняться на Opus. Чтобы сохранить пользовательского подагента на меньшей модели, установите `model` в его определении.149Если вы переключаете модели с помощью `/model`, переключение также достигает [субагентов, которые наследуют модель основного диалога](/docs/ru/sub-agents#choose-a-model), потому что Claude Code разрешает их модель из той, которую использует ваша сессия, когда Claude их запускает. Переключитесь на Opus перед тем, как Claude делегирует исследование или тестовые запуски одному из них, и эта работа также будет выполняться на Opus. Чтобы оставить пользовательского субагента на меньшей модели, установите `model` в его определении.

150 150

151Если вы установите модель с помощью `/model` в [неинтерактивном режиме](/docs/ru/headless), с флагом `-p`, ваш выбор применяется только к текущему сеансу и не сохраняется как ваша стандартная; `/model` в этом режиме требует Claude Code версии 2.1.205 или позже. Параметры проекта и управляемые параметры по-прежнему имеют приоритет и переприменяются при следующем запуске. [Стандартная модель организации](#organization-default-model), которую ваш администратор настроил для переопределения выбора пользователя, также переприменяется при следующем запуске.151Если вы установите модель с помощью `/model` в [неинтерактивном режиме](/docs/ru/headless), с флагом `-p`, ваш выбор применяется только к текущей сессии и не сохраняется как ваша стандартная; `/model` в этом режиме требует Claude Code версии 2.1.205 или позже. Настройки проекта и управляемые настройки по-прежнему имеют приоритет и переприменяются при следующем запуске. [Стандартная модель организации](#organization-default-model), которую ваш администратор настроил для переопределения выбора пользователя, также переприменяется при следующем запуске.

152 152

153В версиях 2.1.144 по 2.1.152 `/model` применялся только к текущему сеансу, а `d` в средстве выбора сохранял стандартную.153В версиях 2.1.144 по 2.1.152 `/model` применялся только к текущей сессии, а `d` в средстве выбора сохранял стандартную.

154 154

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

156 156

157Цены в средстве выбора `/model` появляются, когда Claude Code разговаривает с Anthropic API, напрямую или через [шлюз LLM](/docs/ru/llm-gateway), который его проксирует, и цена в строке — это цена модели, которую выбирает эта строка. На [поставщиках третьих сторон](/docs/ru/third-party-integrations), таких как Amazon Bedrock, и на [шлюзе Claude apps gateway](/docs/ru/claude-apps-gateway), ваш поставщик или шлюз определяет, что вы платите, поэтому строки средства выбора не показывают цену. Цена — это только метка отображения; она не влияет на то, какую модель выбирает строка, или что выставляет в счёт ваш поставщик. До версии 2.1.206 [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) и сеансы шлюза показывали цены списка Anthropic, и строка могла показывать цену другой модели, чем та, которую она выбирала.157Цены в средстве выбора `/model` появляются, когда Claude Code взаимодействует с Anthropic API, напрямую или через [LLM-шлюз](/docs/ru/llm-gateway), который его проксирует, и цена в строке — это цена модели, которую выбирает эта строка. На [поставщиках третьих сторон](/docs/ru/third-party-integrations), таких как Amazon Bedrock, и на [шлюзе Claude apps gateway](/docs/ru/claude-apps-gateway) ваш поставщик или шлюз определяет, что вы платите, поэтому строки средства выбора не показывают цену. Цена — это только метка отображения; она не влияет на то, какую модель выбирает строка, или что выставляет в счёт ваш поставщик. До версии 2.1.206 [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) и сессии шлюза показывали цены списка Anthropic, и строка могла показывать цену другой модели, чем та, которую она выбирала.

158 158

159Возобновлённые сессии, начатые с помощью `claude --resume`, `--continue` или средства выбора `/resume`, сохраняют модель, которую они использовали, когда транскрипт был сохранён. Если восстановленная модель была снята с производства или исключена [`availableModels`](#restrict-model-selection), сессия переходит к обычному порядку приоритета. У поставщиков, которые используют специфичные для поставщика ID развёртывания вместо ID моделей Anthropic, таких как Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, модель из транскрипта вообще не восстанавливается, и сессия разрешает свою модель через обычный порядок приоритета.159Возобновлённые сессии, начатые с помощью `claude --resume`, `--continue` или средства выбора `/resume`, сохраняют модель, которую они использовали, когда транскрипт был сохранён. Если восстановленная модель была снята с производства или исключена [`availableModels`](#restrict-model-selection), сессия переходит к обычному порядку приоритета. У поставщиков, которые используют специфичные для поставщика ID развёртывания вместо ID моделей Anthropic, таких как Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, модель из транскрипта вообще не восстанавливается, и сессия разрешает свою модель через обычный порядок приоритета.

160 160

162 162

163Модель, которую вы выбираете для нового запуска с помощью `--model` или `ANTHROPIC_MODEL`, по-прежнему имеет приоритет над восстановленной моделью. Начиная с версии 2.1.195, переменная семейства [`ANTHROPIC_DEFAULT_OPUS_MODEL`](#environment-variables) также имеет приоритет. [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions) может тоже, при условиях, перечисленных в её разделе.163Модель, которую вы выбираете для нового запуска с помощью `--model` или `ANTHROPIC_MODEL`, по-прежнему имеет приоритет над восстановленной моделью. Начиная с версии 2.1.195, переменная семейства [`ANTHROPIC_DEFAULT_OPUS_MODEL`](#environment-variables) также имеет приоритет. [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions) может тоже, при условиях, перечисленных в её разделе.

164 164

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

166 166

167Если вы или ваша организация настроите [PreModelSwitch hooks](/docs/ru/hooks#premodelswitch), они запускаются перед применением запрошенного переключения и могут его заблокировать или попросить вас подтвердить.167Если вы или ваша организация настроите [хуки PreModelSwitch](/docs/ru/hooks#premodelswitch), они запускаются перед применением запрошенного переключения и могут его заблокировать или попросить вас подтвердить.

168 168

169Когда Claude Code не может определить, какие PreModelSwitch hooks доставляют [управляемые плагины](/docs/ru/settings-reference#enabledplugins) вашей организации, например потому что управляемый плагин не загрузился, он отказывает в переключении вместо его применения, и он проверяет снова при каждой новой попытке. См. [Model switch was blocked by a PreModelSwitch hook](/docs/ru/errors#model-switch-was-blocked-by-a-premodelswitch-hook) для сообщения и восстановления.169Когда Claude Code не может определить, какие хуки PreModelSwitch доставляют [управляемые плагины](/docs/ru/settings-reference#enabledplugins) вашей организации, например потому что управляемый плагин не загрузился, он отказывает в переключении вместо его применения без проверки, и он проверяет снова при каждой новой попытке. См. [Model switch was blocked by a PreModelSwitch hook](/docs/ru/errors#model-switch-was-blocked-by-a-premodelswitch-hook) для сообщения и восстановления.

170 170

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

172 172

173* **Agent SDK или приложение**: с Claude Code версии 2.1.268 или позже, если Claude Code не принимает ID модели локально, как это происходит для вашего [пользовательского варианта модели](#add-a-custom-model-option), он подтверждает ID у вашего поставщика при первом переключении сеанса на него. Подтверждение выполняется на каждом поставщике, и ID, который ваш поставщик не предлагает, отклоняется при переключении вместо сбоя при следующем запросе.173* **Agent SDK или приложение**: с Claude Code версии 2.1.268 или позже, если Claude Code не принимает ID модели локально, как это происходит для вашего [пользовательского варианта модели](#add-a-custom-model-option), он подтверждает ID у вашего поставщика при первом переключении сессии на него. Подтверждение выполняется на каждом поставщике, и ID, который ваш поставщик не предлагает, отклоняется при переключении вместо сбоя при следующем запросе.

174* **Remote Control**: в Anthropic API Claude Code проверяет значение локально и не отправляет запрос.174* **Remote Control**: в Anthropic API Claude Code проверяет значение локально и не отправляет запрос.

175 175

176См. [Model is not a recognized model id](/docs/ru/errors#model-is-not-a-recognized-model-id) и [Model not found](/docs/ru/errors#model-not-found) для сообщений.176См. [Model is not a recognized model id](/docs/ru/errors#model-is-not-a-recognized-model-id) и [Model not found](/docs/ru/errors#model-not-found) для сообщений.

177 177

178Если вы установите модель с флагом `--model`, переменной окружения `ANTHROPIC_MODEL` или параметром `model`, Claude Code не проверяет её заранее, и неправильно введённое значение производит [There's an issue with the selected model](/docs/ru/errors#theres-an-issue-with-the-selected-model) при первом запросе.178Если вы установите модель с флагом `--model`, переменной окружения `ANTHROPIC_MODEL` или настройкой `model`, Claude Code не проверяет её заранее, и неправильно введённое значение приводит к [There's an issue with the selected model](/docs/ru/errors#theres-an-issue-with-the-selected-model) при первом запросе.

179 179

180Когда запрошенная модель имеет запланированную дату снятия с производства или автоматически переназначается на более новую версию, Claude Code показывает предупреждение, которое называет запрошенную модель. Интерактивные сеансы показывают его как уведомление при запуске. Начиная с версии 2.1.182, то же предупреждение записывается в stderr в [неинтерактивном режиме](/docs/ru/headless) при использовании формата вывода текста по умолчанию. Проверка также охватывает `model`, установленный в [фронтматтере подагента](/docs/ru/sub-agents). Предупреждение stderr подавляется для `--output-format json` и `stream-json`; прочитайте фактическую модель из поля `modelUsage` [результирующего сообщения](/docs/ru/headless#get-structured-output) вместо этого.180Когда запрошенная модель имеет запланированную дату снятия с производства или автоматически переназначается на более новую версию, Claude Code показывает предупреждение, которое называет запрошенную модель. Интерактивные сессии показывают его как уведомление при запуске. Начиная с версии 2.1.182, то же предупреждение записывается в stderr в [неинтерактивном режиме](/docs/ru/headless) при использовании формата вывода текста по умолчанию. Проверка также охватывает `model`, установленный во [frontmatter субагента](/docs/ru/sub-agents). Предупреждение stderr подавляется для `--output-format json` и `stream-json`; вместо этого прочитайте фактическую модель из поля `modelUsage` [результирующего сообщения](/docs/ru/headless#get-structured-output).

181 181

182Например, запустите сеанс на Opus:182Например, запустите сессию на Opus:

183 183

184```bash theme={null}184```bash theme={null}

185claude --model opus185claude --model opus

186```186```

187 187

188Затем переключайте модели из сеанса:188Затем переключайте модели из сессии:

189 189

190```text theme={null}190```text theme={null}

191/model sonnet191/model sonnet

192```192```

193 193

194Пример файла параметров:194Пример файла настроек:

195 195

196```json theme={null}196```json theme={null}

197{197{

203```203```

204 204

205<h4 id="set-a-default-model-for-new-sessions">205<h4 id="set-a-default-model-for-new-sessions">

206 Установка стандартной модели для новых сеансов206 Установка стандартной модели для новых сессий

207</h4>207</h4>

208 208

209Установите `ANTHROPIC_DEFAULT_MODEL=<alias|name>` для выбора модели, на которой ваши сеансы запускаются по умолчанию. Требует Claude Code версии 2.1.236 или позже.209Установите `ANTHROPIC_DEFAULT_MODEL=<alias|name>` для выбора модели, на которой ваши сессии запускаются по умолчанию. Требует Claude Code версии 2.1.236 или позже.

210 210

211Claude Code запускает новый сеанс на модели переменной только когда ни один из этих не выбирает модель:211Claude Code запускает новую сессию на модели переменной, только когда ни один из этих вариантов не выбирает модель:

212 212

213* Флаг `--model`213* Флаг `--model`

214* `ANTHROPIC_MODEL`214* `ANTHROPIC_MODEL`

215* Значение `model` в любом файле параметров, включая выбор, который вы сохраняете с помощью `/model`215* Значение `model` в любом файле настроек, включая выбор, который вы сохраняете с помощью `/model`

216* [Стандартная модель организации](#organization-default-model)216* [Стандартная модель организации](#organization-default-model)

217 217

218Выбор, который вы сохраняете с помощью `/model`, имеет приоритет над переменной при последующих запусках. С установленным `ANTHROPIC_MODEL` вместо этого Claude Code возвращается к модели этой переменной при следующем запуске, независимо от того, что вы сохранили с помощью `/model`.218Выбор, который вы сохраняете с помощью `/model`, имеет приоритет над переменной и при последующих запусках. Если же установлена `ANTHROPIC_MODEL`, Claude Code возвращается к модели этой переменной при следующем запуске, независимо от того, что вы сохранили с помощью `/model`.

219 219

220Claude Code также разрешает опцию Default на модель переменной, если не применяется стандартная модель организации. Когда опция Default разрешается на модель переменной, строка Default в средстве выбора `/model` показывает метку Set by ANTHROPIC\_DEFAULT\_MODEL.220Claude Code также разрешает опцию Default на модель переменной, если не применяется стандартная модель организации. Когда опция Default разрешается на модель переменной, строка Default в средстве выбора `/model` показывает метку Set by ANTHROPIC\_DEFAULT\_MODEL.

221 221

226* [Ограничения модели](#restrict-model-selection) вашей организации исключают модель226* [Ограничения модели](#restrict-model-selection) вашей организации исключают модель

227* Модель недоступна для вашей учётной записи227* Модель недоступна для вашей учётной записи

228 228

229Когда новый сеанс запустится на модели переменной, сеанс, который вы возобновляете с помощью `claude --resume`, `--continue` или средства выбора `/resume`, также запустится на ней. Claude Code не восстанавливает модель, сохранённую в стенограмме этого сеанса. В противном случае Claude Code не использует переменную, когда вы [возобновляете сеанс](#setting-your-model).229Когда новая сессия запустилась бы на модели переменной, сессия, которую вы возобновляете с помощью `claude --resume`, `--continue` или средства выбора `/resume`, также запускается на ней. Claude Code не восстанавливает модель, сохранённую в транскрипте этой сессии. В противном случае Claude Code не использует переменную, когда вы [возобновляете сессию](#setting-your-model).

230 230

231<h4 id="a-new-session-starts-on-a-different-model-than-you-picked">231<h4 id="a-new-session-starts-on-a-different-model-than-you-picked">

232 Новый сеанс запускается на другой модели, чем вы выбрали232 Новая сессия запускается на другой модели, чем вы выбрали

233</h4>233</h4>

234 234

235Когда вы выбираете модель с помощью `/model` и ваш следующий сеанс запускается на чём-то другом, это обычные причины:235Когда вы выбираете модель с помощью `/model`, а ваша следующая сессия запускается на чём-то другом, обычные причины таковы:

236 236

237* **Вы выбрали её для одного сеанса.** Нажатие `s` в средстве выбора, запуск с помощью `--model` и запуск `/model` в неинтерактивном режиме применяются только к текущему сеансу и оставляют вашу сохранённую стандартную без изменений.237* **Вы выбрали её для одной сессии.** Нажатие `s` в средстве выбора, запуск с помощью `--model` и запуск `/model` в неинтерактивном режиме применяются к текущей сессии и оставляют вашу сохранённую стандартную без изменений.

238* **Что-то с более высоким приоритетом устанавливает модель.** Значение `model` в параметрах проекта или управляемых параметрах, `ANTHROPIC_MODEL` в вашей оболочке или [стандартная модель организации](#organization-default-model), которую ваш администратор установил для переопределения выбора пользователя, применяется снова при каждом запуске. Ваш выбор `/model` по-прежнему сохранён; он превосходит. Когда параметры проекта или управляемые параметры устанавливают модель, заголовок запуска называет файл.238* **Что-то с более высоким приоритетом устанавливает модель.** Значение `model` в настройках проекта или управляемых настройках, `ANTHROPIC_MODEL` в вашей оболочке или [стандартная модель организации](#organization-default-model), которую ваш администратор установил для переопределения выбора пользователя, применяется снова при каждом запуске. Ваш выбор `/model` по-прежнему сохранён; просто у него более низкий приоритет. Когда настройки проекта или управляемые настройки устанавливают модель, заголовок запуска называет файл.

239* **Claude Code не смог сохранить ваш выбор.** `/model` записывает `model` в `~/.claude/settings.json`. Если вы не можете писать в этот файл, например потому что другой инструмент его генерирует или связывает его с копией только для чтения, модель, которую вы выбрали, длится для сеанса, и следующий запуск читает старое значение. Установите `model` в инструменте, который генерирует файл, или сделайте файл доступным для записи. См. [A change you made in Claude Code is lost in new sessions](/docs/ru/settings#a-change-you-made-in-claude-code-is-lost-in-new-sessions).239* **Claude Code не смог сохранить ваш выбор.** `/model` записывает `model` в `~/.claude/settings.json`. Если вы не можете писать в этот файл, например потому что другой инструмент его генерирует или связывает его с копией только для чтения, выбранная вами модель действует в течение сессии, а следующий запуск читает старое значение. Установите `model` в инструменте, который генерирует файл, или сделайте файл доступным для записи. См. [A change you made in Claude Code is lost in new sessions](/docs/ru/settings#a-change-you-made-in-claude-code-is-lost-in-new-sessions).

240* **Вы возобновили сеанс.** Сеанс, который вы возобновляете с помощью `claude --resume` или `--continue`, обычно [сохраняет модель, которую он использовал](#setting-your-model), вместо вашей текущей стандартной.240* **Вы возобновили сессию.** Сессия, которую вы возобновляете с помощью `claude --resume` или `--continue`, обычно [сохраняет модель, которую она использовала](#setting-your-model), вместо вашей текущей стандартной.

241 241

242<h2 id="restrict-model-selection">242<h2 id="restrict-model-selection">

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

310* Сессии [Claude Tag](https://claude.com/docs/claude-tag/overview) запускаются в облачных средах, но не получают управляемые параметры сервера; в [самостоятельно размещенной среде](/docs/ru/self-hosted-environments) они все еще читают файл управляемых параметров в образе runner. Чтобы установить модель для этих сессий, см. [Выбор модели для области](https://claude.com/docs/claude-tag/admins/customize#choose-the-model-for-a-scope) в руководстве администратора Claude Tag.310* Сессии [Claude Tag](https://claude.com/docs/claude-tag/overview) запускаются в облачных средах, но не получают управляемые параметры сервера; в [самостоятельно размещенной среде](/docs/ru/self-hosted-environments) они все еще читают файл управляемых параметров в образе runner. Чтобы установить модель для этих сессий, см. [Выбор модели для области](https://claude.com/docs/claude-tag/admins/customize#choose-the-model-for-a-scope) в руководстве администратора Claude Tag.

311* Cowork, вкладка агентской работы в приложении Claude Desktop, запускает свои сессии на Claude Code, но по замыслу не получает управляемые параметры сервера из консоли администратора claude.ai. Когда список `availableModels` в ваших управляемых параметрах сервера не пуст и пользователь выбирает модель вне него, сервер отклоняет эту модель для удаленной сессии Cowork. Файл управляемых параметров применяется к сессиям Cowork, когда он присутствует там, где запускается сессия; удаленные сессии Cowork запускаются на управляемых Anthropic виртуальных машинах, где развернутый на устройстве файл отсутствует.311* Cowork, вкладка агентской работы в приложении Claude Desktop, запускает свои сессии на Claude Code, но по замыслу не получает управляемые параметры сервера из консоли администратора claude.ai. Когда список `availableModels` в ваших управляемых параметрах сервера не пуст и пользователь выбирает модель вне него, сервер отклоняет эту модель для удаленной сессии Cowork. Файл управляемых параметров применяется к сессиям Cowork, когда он присутствует там, где запускается сессия; удаленные сессии Cowork запускаются на управляемых Anthropic виртуальных машинах, где развернутый на устройстве файл отсутствует.

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

313* Доставка, управляемая сервером, также требует, чтобы сессия аутентифицировалась с помощью [подходящего входа или ключа](/docs/ru/server-managed-settings#platform-availability). Флоты, которые генерируют ключи только через скрипт [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper), должны доставлять список разрешений через MDM или файлы управляемых параметров.313* Доставка из консоли администратора также требует, чтобы сессия получала настройки с [подходящим входом](/docs/ru/server-managed-settings#platform-availability) в вашу организацию или с OAuth-токеном, выданным для неё. Для парков устройств, которые аутентифицируются с помощью API-ключей — заданных напрямую или сгенерированных скриптом [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper), — доставляйте список разрешённых моделей через MDM или файлы управляемых настроек.

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

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

316 316

487</h2>487</h2>

488 488

489<h3 id="default-model-setting">489<h3 id="default-model-setting">

490 Параметр модели `default`490 Настройка модели `default`

491</h3>491</h3>

492 492

493Поведение `default` зависит от типа вашей учетной записи:493Поведение `default` зависит от типа вашей учётной записи:

494 494

495* **Pro, Max, Team, Enterprise и Anthropic API**: по умолчанию Opus 5.5495* **Pro, Max, Team, Enterprise и Anthropic API**: по умолчанию Opus 5.5

496* **Claude Platform on AWS, Amazon Bedrock и Google Cloud's Agent Platform**: по умолчанию Opus 5.5496* **Claude Platform on AWS, Amazon Bedrock и Google Cloud's Agent Platform**: по умолчанию Opus 5.5

498 498

499До версии 2.1.280 `default` разрешался в Sonnet 5 на Pro и Team Standard, а в Opus 5 на Max, Team Premium, Enterprise, Anthropic API, Claude Platform on AWS, Amazon Bedrock и Google Cloud's Agent Platform с версии 2.1.219. До версии 2.1.219 `default` разрешался в Opus 4.8 на Anthropic API, Max, Team Premium и Enterprise с оплатой по мере использования с версии 2.1.154, а также на Claude Platform on AWS, Amazon Bedrock и Google Cloud's Agent Platform с версии 2.1.207. До версии 2.1.207 `default` разрешался в Opus 4.7 на Claude Platform on AWS и в Sonnet 4.5 на Amazon Bedrock и Google Cloud's Agent Platform.499До версии 2.1.280 `default` разрешался в Sonnet 5 на Pro и Team Standard, а в Opus 5 на Max, Team Premium, Enterprise, Anthropic API, Claude Platform on AWS, Amazon Bedrock и Google Cloud's Agent Platform с версии 2.1.219. До версии 2.1.219 `default` разрешался в Opus 4.8 на Anthropic API, Max, Team Premium и Enterprise с оплатой по мере использования с версии 2.1.154, а также на Claude Platform on AWS, Amazon Bedrock и Google Cloud's Agent Platform с версии 2.1.207. До версии 2.1.207 `default` разрешался в Opus 4.7 на Claude Platform on AWS и в Sonnet 4.5 на Amazon Bedrock и Google Cloud's Agent Platform.

500 500

501Когда администратор установил [модель по умолчанию организации](#organization-default-model), `default` разрешается в эту модель вместо стандартного значения для типа учетной записи выше. Требуется Claude Code версии 2.1.196 или позже. `default` также может разрешаться в модель, которую вы установили с помощью [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions), при условиях, указанных в его разделе, или в модель, [записанную в вашей учетной записи](#setting-your-model).501Когда администратор установил [модель по умолчанию организации](#organization-default-model), `default` разрешается в эту модель вместо стандартного значения для типа учётной записи выше. Требуется Claude Code версии 2.1.196 или позже. `default` также может разрешаться в модель, которую вы установили с помощью [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions), при условиях, указанных в его разделе, или в модель, [записанную в вашей учётной записи](#setting-your-model).

502 502

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

504 504

505Модели Fable не являются стандартным значением для типа учетной записи ни на одном плане или поставщике. Выбор одной с помощью `/model` сохраняет ее как выбранную модель в параметрах пользователя, поэтому более поздние сеансы начинаются с нее. Для одноразового изменения, которое Claude Code вносит в сохраненный выбор Fable 5 в версии 2.1.257, см. [Работа с Fable](#work-with-fable).505Модели Fable не являются стандартным значением для типа учётной записи ни на одном тарифе или у одного поставщика. Выбор одной из них с помощью `/model` сохраняет её как выбранную модель в пользовательских настройках, поэтому последующие сессии начинаются с неё. Об одноразовом изменении, которое Claude Code вносит в сохранённый выбор Fable 5 в версии 2.1.257, см. [Работа с Fable](#work-with-fable).

506 506

507<h3 id="opusplan-model-setting">507<h3 id="opusplan-model-setting">

508 Параметр модели `opusplan`508 Настройка модели `opusplan`

509</h3>509</h3>

510 510

511Псевдоним модели `opusplan` обеспечивает автоматизированный гибридный подход:511Псевдоним модели `opusplan` обеспечивает автоматизированный гибридный подход:

512 512

513* **В Plan Mode**: использует `opus` для сложного рассуждения и решений по архитектуре513* **В режиме планирования**: использует `opus` для сложных рассуждений и решений по архитектуре

514* **В режиме выполнения**: автоматически переключается на `sonnet` для генерации кода и реализации514* **В режиме выполнения**: автоматически переключается на `sonnet` для генерации кода и реализации

515 515

516Это сочетает рассуждение Opus для планирования с эффективностью Sonnet для выполнения.516Это сочетает рассуждения Opus для планирования с эффективностью Sonnet для выполнения.

517 517

518Фаза Opus в Plan Mode использует то же окно контекста, что и параметр модели `opus`, а фаза выполнения использует то же окно, что и `sonnet`. Когда `opus` и `sonnet` разрешаются в модели, которые работают с [окном контекста 1M](#extended-context) по умолчанию, как это делают текущие модели на Anthropic API, обе фазы работают с ним. Чтобы запросить контекст 1M для обеих фаз, где они этого не делают, [установите модель](#setting-your-model) на `opusplan[1m]`, например с помощью `/model opusplan[1m]`. Установка с помощью `/model` требует Claude Code версии 2.1.265 или позже; в более ранних версиях используйте флаг `--model` или параметр `model` вместо этого.518Фаза Opus в режиме планирования использует то же контекстное окно, что и настройка модели `opus`, а фаза выполнения использует то же окно, что и `sonnet`. Когда `opus` и `sonnet` разрешаются в модели, которые по умолчанию работают с [контекстным окном 1M](#extended-context), как текущие модели на Anthropic API, обе фазы работают с ним. Чтобы запросить контекст 1M для обеих фаз там, где это не так, [установите модель](#setting-your-model) `opusplan[1m]`, например с помощью `/model opusplan[1m]`. Установка с помощью `/model` требует Claude Code версии 2.1.265 или позже; в более ранних версиях используйте вместо этого флаг `--model` или настройку `model`.

519 519

520Когда [`availableModels`](#restrict-model-selection) исключает новейший Opus, но разрешает более старую версию, например `["sonnet", "claude-opus-4-6"]`, `opusplan` использует новейший разрешенный Opus для планирования и остается только на Sonnet, когда исключены все версии Opus. Сеанс Haiku, который обычно обновляется до Sonnet в Plan Mode, аналогично использует новейший разрешенный Sonnet и остается на Haiku только когда исключены все версии Sonnet. До версии 2.1.205 Plan Mode оставался на модели сеанса всякий раз, когда исключалась новейшая версия семейства обновлений, даже когда список разрешений разрешал более старую версию.520Когда [`availableModels`](#restrict-model-selection) исключает новейший Opus, но разрешает более старую версию, например `["sonnet", "claude-opus-4-6"]`, `opusplan` использует для планирования новейший разрешённый Opus и остаётся на Sonnet, только когда исключены все версии Opus. Сессия Haiku, которая обычно переключается на Sonnet в режиме планирования, аналогично использует новейший разрешённый Sonnet и остаётся на Haiku, только когда исключены все версии Sonnet. До версии 2.1.205 режим планирования оставался на модели сессии всякий раз, когда исключалась новейшая версия семейства для переключения, даже если список разрешённых моделей разрешал более старую версию.

521 521

522Подстановка более старой разрешенной версии применяется на Anthropic API и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws). На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Mantle, развертывания которых используют специфичные для поставщика идентификаторы моделей, Plan Mode остается на модели сеанса всякий раз, когда модель обновления исключена.522Подстановка более старой разрешённой версии применяется на Anthropic API и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws). На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Mantle, развёртывания которых используют специфичные для поставщика идентификаторы моделей, режим планирования остаётся на модели сессии всякий раз, когда модель для переключения исключена.

523 523

524Для гибридного подхода, при котором Claude решает во время выполнения задачи, когда обратиться ко второй модели, а не переключаться на границе плана, см. [инструмент advisor](/docs/ru/advisor).524Для гибридного подхода, при котором Claude решает во время выполнения задачи, когда обратиться ко второй модели, а не переключаться на границе плана, см. [инструмент advisor](/docs/ru/advisor).

525 525

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

528</h3>528</h3>

529 529

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

531 531

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

533 533

534Установите цепочку для одного сеанса с флагом `--fallback-model`, который принимает список, разделенный запятыми:534Задайте цепочку для одной сессии с помощью флага `--fallback-model`, который принимает список, разделённый запятыми:

535 535

536```bash theme={null}536```bash theme={null}

537claude --fallback-model sonnet,haiku537claude --fallback-model sonnet,haiku

538```538```

539 539

540Чтобы сохранить цепочку между сеансами, установите `fallbackModel` в [параметрах](/docs/ru/settings) как массив:540Чтобы сохранить цепочку между сессиями, задайте `fallbackModel` в [настройках](/docs/ru/settings) как массив:

541 541

542```json theme={null}542```json theme={null}

543{543{

545}545}

546```546```

547 547

548Флаг `--fallback-model` имеет приоритет над параметром `fallbackModel`. Каждая запись принимает имя модели или псевдоним, и `"default"` расширяется до модели по умолчанию.548Флаг `--fallback-model` имеет приоритет над настройкой `fallbackModel`. Каждая запись принимает имя модели или псевдоним, а `"default"` раскрывается в модель по умолчанию.

549 549

550Claude Code не подтверждает цепочку при запуске, и `/status` не отображает ее. Уведомление, показываемое при переключении, является первым видимым признаком того, что резервная модель настроена.550Claude Code не подтверждает цепочку при запуске, и `/status` её не отображает. Уведомление, показываемое при переключении, — первый видимый признак того, что резервная модель настроена.

551 551

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

553 553

554* **Вне списка разрешений**: Claude Code удаляет любую запись, не разрешенную [`availableModels`](#restrict-model-selection), когда читает цепочку.554* **Вне списка разрешённых моделей**: Claude Code отбрасывает любую запись, не разрешённую [`availableModels`](#restrict-model-selection), при чтении цепочки.

555* **Меньшее окно контекста во время компактирования**: цепочка также охватывает [компактирование](/docs/ru/context-window#what-survives-compaction), но Claude Code не будет переходить в режим отказа на модель с меньшим окном контекста, чем у основной, так как суммирование там сначала отрежет часть разговора. Если все резервные модели меньше, компактирование показывает исходную ошибку и вы можете повторить попытку.555* **Меньшее контекстное окно при сжатии контекста**: цепочка также охватывает [сжатие контекста](/docs/ru/context-window#what-survives-compaction), но Claude Code не переключится на модель с меньшим контекстным окном, чем у основной, поскольку суммирование на ней сначала отрезало бы часть диалога. Если все резервные модели меньше, сжатие показывает исходную ошибку, и вы можете повторить попытку.

556 556

557Claude Code также применяет цепочку к [subagents](/docs/ru/sub-agents). Когда запрос subagent переходит в режим отказа, Claude Code пробует ваши настроенные резервные модели по порядку, и subagent продолжает работу на модели, которая принимает запрос. Модель вашего сеанса не изменяется. До версии 2.1.247 отказ, который охватывает цепочка, завершал subagent.557Claude Code также применяет цепочку к [субагентам](/docs/ru/sub-agents). Когда запрос субагента переключается на резервную модель, Claude Code пробует настроенные вами резервные модели по порядку, и субагент продолжает работу на модели, которая приняла запрос. Модель вашей сессии не изменяется. До версии 2.1.247 сбой, на который распространяется цепочка, вместо этого завершал работу субагента.

558 558

559<h3 id="automatic-model-fallback">559<h3 id="automatic-model-fallback">

560 Автоматический резервный вариант модели560 Автоматическое переключение на резервную модель

561</h3>561</h3>

562 562

563Этот раздел охватывает резервный вариант на основе содержимого из моделей Fable, Opus 5.5, Sonnet 5.5 и Opus 5. Для резервного варианта на основе доступности, когда модель перегружена или недоступна, см. [Цепочки резервных моделей](#fallback-model-chains).563Этот раздел описывает переключение на резервную модель на основе содержимого для моделей Fable, Opus 5.5, Sonnet 5.5 и Opus 5. О переключении на основе доступности, когда модель перегружена или недоступна, см. [Цепочки резервных моделей](#fallback-model-chains).

564 564

565Модели Fable, Opus 5.5, Sonnet 5.5 и Opus 5 работают с классификаторами безопасности, которые чаще всего отмечают содержимое кибербезопасности и биологии. Когда классификатор отмечает запрос и отмеченная категория имеет резервную модель, Claude Code повторно запускает запрос на этой модели и показывает уведомление в стенограмме. Для этих двух категорий резервная модель зависит от того, какая модель отказала:565Модели Fable, Opus 5.5, Sonnet 5.5 и Opus 5 работают с классификаторами безопасности, которые чаще всего помечают содержимое, связанное с кибербезопасностью и биологией. Для этих двух категорий резервная модель зависит от того, какая модель отказала:

566 566

567* **Fable 5.1, Fable 5 и Opus 5.5**: запросы, отмеченные биологией, повторно запускаются на Opus 5, а запросы, отмеченные кибербезопасностью, повторно запускаются на Opus 4.8.567* **Fable 5.1, Fable 5 и Opus 5.5**: запросы, помеченные как связанные с биологией, повторно выполняются на Opus 5, а запросы, помеченные как связанные с кибербезопасностью, — на Opus 4.8.

568* **Sonnet 5.5**: запросы, отмеченные кибербезопасностью, повторно запускаются на Sonnet 5. Запросы, отмеченные биологией, заканчиваются отказом, потому что Sonnet 5.5 не имеет резервной модели биологии.568* **Sonnet 5.5**: запросы, помеченные как связанные с кибербезопасностью, повторно выполняются на Sonnet 5. Запросы, помеченные как связанные с биологией, вместо этого завершаются отказом, потому что у Sonnet 5.5 нет резервной модели для биологии.

569* **Opus 5**: запросы, отмеченные кибербезопасностью, повторно запускаются на Opus 4.8. Запросы, отмеченные биологией, заканчиваются отказом, потому что Opus 5 запускает свои собственные классификаторы биологии без резервной модели.569* **Opus 5**: запросы, помеченные как связанные с кибербезопасностью, повторно выполняются на Opus 4.8. Запросы, помеченные как связанные с биологией, вместо этого завершаются отказом, потому что Opus 5 использует собственные классификаторы биологии без резервной модели.

570 570

571На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry Claude Code разрешает эти цели через идентификаторы моделей вашего развертывания. См. [Включение резервного варианта на Bedrock, Agent Platform и Foundry](#enable-fallback-on-bedrock-agent-platform-and-foundry).571На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry Claude Code вместо этого разрешает эти целевые модели через идентификаторы моделей вашего развёртывания. См. [Включение резервного варианта на Bedrock, Agent Platform и Foundry](#enable-fallback-on-bedrock-agent-platform-and-foundry).

572 572

573После резервного варианта сеанс продолжается на резервной модели. Чтобы вернуться к исходной модели, запустите [`/model`](#setting-your-model).573Когда Claude Code переключает помеченный запрос на резервную модель для его категории, он повторно выполняет запрос на этой модели. В основном диалоге он показывает уведомление в транскрипте. Чтобы получать вопрос перед переключением, см. [Запрос перед переключением](#ask-before-switching).

574 574

575Резервный вариант на основе категории требует Claude Code версии 2.1.219 или позже. До версии 2.1.219 каждый отмеченный запрос Fable 5 повторно запускался на модели Opus по умолчанию вашего поставщика, и Opus 5 не был источником резервного варианта.575После переключения на резервную модель сессия продолжается на ней. Чтобы вернуться к исходной модели, выполните [`/model`](#setting-your-model).

576 576

577Резервная модель проверяется против [`availableModels`](#restrict-model-selection). Когда она заблокирована, резервный вариант не происходит. Отказ показывается как обычная ошибка, и модель сеанса не изменяется.577Переключение на основе категории требует Claude Code версии 2.1.219 или позже. До версии 2.1.219 каждый помеченный запрос Fable 5 повторно выполнялся на модели Opus по умолчанию вашего поставщика, а Opus 5 не был источником переключения.

578

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

578 580

579<h4 id="effort-level-after-a-fallback">581<h4 id="effort-level-after-a-fallback">

580 Уровень усилий после переключения на резервную модель582 Уровень усилий после переключения на резервную модель

581</h4>583</h4>

582 584

583Когда Claude Code переключает вашу сессию на резервную модель, он сохраняет уровень усилий, с которым выполнялся помеченный запрос, вместо уровня усилий по умолчанию для этой модели. Например, сессия на Opus 5.5 с уровнем по умолчанию `medium`, переключившаяся на Opus 4.8, остаётся на `medium`, хотя Opus 4.8 по умолчанию использует `high`.585Когда Claude Code переключает вашу сессию на резервную модель, он сохраняет уровень усилий, с которым выполнялся помеченный запрос. Например, сессия на Opus 5.5 с уровнем по умолчанию `medium`, переключившаяся на Opus 4.8, остаётся на `medium`, хотя Opus 4.8 по умолчанию использует `high`.

584 586

585Другой уровень применяется, например, в следующих случаях:587Другой уровень применяется, например, в следующих случаях:

586 588

587* **Настройки или значение по умолчанию организации**: вместо этого применяется уровень в ваших настройках, который относится к резервной модели, или уровень усилий по умолчанию, заданный для неё вашей организацией.

588* **Ваше собственное изменение**: как только вы выбираете уровень усилий, выбираете модель в `/model` или позже возобновляете сессию, уровень помеченного запроса больше не переносится.589* **Ваше собственное изменение**: как только вы выбираете уровень усилий, выбираете модель в `/model` или позже возобновляете сессию, уровень помеченного запроса больше не переносится.

589* **Уровень усилий скилла**: уровень, который frontmatter `effort` скилла задал для помеченного запроса, применяется к этому ходу, а последующие ходы выполняются на уровне, который [порядок разрешения усилий](#adjust-effort-level) даёт резервной модели.590* **Уровень усилий скилла**: уровень, который frontmatter `effort` скилла задал для помеченного запроса, применяется к этому ходу, а последующие ходы выполняются на уровне, который [порядок разрешения усилий](#adjust-effort-level) даёт резервной модели.

590 591

591Заголовок сессии показывает действующий уровень рядом с именем модели. Чтобы изменить его, запустите `/effort` в сессии.592В сессии выполните `/effort status`, чтобы увидеть действующий уровень, или `/effort`, чтобы изменить его.

592 593

593<h4 id="check-what-triggered-fallback">594<h4 id="check-what-triggered-fallback">

594 Проверка того, что вызвало резервный вариант595 Проверка того, что вызвало переключение

595</h4>596</h4>

596 597

597Резервный вариант может быть вызван при первом запросе сеанса, прежде чем вы отправите что-либо необычное, потому что первый запрос содержит контекст рабочей области, такой как содержимое вашего CLAUDE.md и статус git. Репозиторий, содержащий материал по безопасности или биологии, может активировать классификатор только на этом контексте.598Переключение на резервную модель может произойти уже на первом запросе сессии, прежде чем вы отправите что-либо необычное, потому что первый запрос содержит контекст рабочего пространства, например содержимое вашего CLAUDE.md и статус git. Репозиторий, содержащий материалы по безопасности или биологии, может сработать на классификаторе только из-за этого контекста.

598 599

599Чтобы проверить, являются ли настройки триггером, запустите сеанс с `claude --safe-mode`, который отключает настройки, такие как CLAUDE.md, skills, MCP серверы и hooks. Статус Git и имена каталогов не являются настройками и по-прежнему включены.600Чтобы проверить, не являются ли причиной ваши настройки, запустите сессию с `claude --safe-mode`, что отключает такие настройки, как CLAUDE.md, скиллы, MCP-серверы и хуки. Статус Git и имена каталогов не являются настройками и по-прежнему включаются.

600 601

601<h4 id="ask-before-switching">602<h4 id="ask-before-switching">

602 Запрос перед переключением603 Запрос перед переключением

603</h4>604</h4>

604 605

605Чтобы решить, что происходит каждый раз, когда запрос отмечается, вместо автоматического переключения, запустите `/config` и отключите **Switch models when a message is flagged**, или установите [`switchModelsOnFlag`](/docs/ru/settings-reference#switchmodelsonflag) на `false` в файле параметров. Отмеченный запрос затем приостанавливает сеанс с двумя вариантами: переключиться на резервную модель или отредактировать подсказку и повторить попытку на текущей модели.606Чтобы самостоятельно решать, что происходит каждый раз, когда запрос помечен, выполните `/config`, выберите **Switch models when a message is flagged** и выберите **Ask each time**. Вы также можете установить [`switchModelsOnFlag`](/docs/ru/settings-reference#switchmodelsonflag) в `false` в файле настроек. Тогда Claude Code приостанавливается на помеченном запросе, который привёл бы к переключению моделей, и предлагает два варианта: переключиться на резервную модель или отредактировать промпт и повторить попытку.

607

608В первый раз, когда помеченный запрос в интерактивной сессии должен привести к переключению моделей, Claude Code может спросить, переключаться ли автоматически в дальнейшем. Он спрашивает, только если вы не установили `switchModelsOnFlag`, и сохраняет ваш выбор в этом ключе в пользовательских настройках.

609

610Если вы решите остаться на текущей модели, сохраняется значение `false`, так же как для **Ask each time**. Если вы закроете вопрос, Claude Code ничего не сохраняет и спросит снова в следующий раз, когда помеченный запрос должен будет привести к переключению моделей.

606 611

607Некоторые случаи ведут себя иначе:612Если вы выбрали **Ask each time**, некоторые случаи ведут себя иначе:

608 613

609* Когда отмеченная категория не имеет резервной модели, такой как флаг биологии на Opus 5 или Sonnet 5.5, Claude Code не показывает подсказку и запрос заканчивается отказом.614* Когда у помеченной категории нет резервной модели, например при пометке биологии на Opus 5 или Sonnet 5.5, Claude Code не показывает запрос, и запрос к модели завершается отказом.

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

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

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

613* Когда цель резервного варианта заблокирована [`availableModels`](#restrict-model-selection), Claude Code не показывает подсказку. Отмеченный запрос заканчивается отказом, так же как автоматический резервный вариант, когда цель заблокирована.618* В [субагенте](/docs/ru/sub-agents) Claude Code не показывает запрос, и помеченный запрос, который привёл бы к переключению моделей, повторно выполняется на резервной модели.

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

614 620

615<h4 id="enable-fallback-on-bedrock-agent-platform-and-foundry">621<h4 id="enable-fallback-on-bedrock-agent-platform-and-foundry">

616 Включение резервного варианта на Bedrock, Agent Platform и Foundry622 Включение резервного варианта на Bedrock, Agent Platform и Foundry

617</h4>623</h4>

618 624

619На [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) и [Microsoft Foundry](/docs/ru/microsoft-foundry) идентификаторы моделей специфичны для поставщика, поэтому автоматический резервный вариант работает только когда Claude Code может идентифицировать каждую задействованную модель:625На [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) и [Microsoft Foundry](/docs/ru/microsoft-foundry) идентификаторы моделей специфичны для поставщика, поэтому автоматическое переключение на резервную модель работает, только когда Claude Code может идентифицировать каждую задействованную модель:

620 626

621* Claude Code должен распознавать текущую модель как источник резервного варианта. Fable 5.1 и Fable 5 распознаются, когда идентификатор модели содержит `claude-fable-5`, соответствует значению `ANTHROPIC_DEFAULT_FABLE_MODEL` или сопоставляется с [`modelOverrides`](#override-model-ids-per-version). Opus 5.5, Sonnet 5.5 и Opus 5 распознаются по их идентификатору модели поставщика или сопоставлению [`modelOverrides`](#override-model-ids-per-version).627* Claude Code должен распознавать текущую модель как источник переключения. Fable 5.1 и Fable 5 распознаются, когда идентификатор модели содержит `claude-fable-5`, совпадает со значением `ANTHROPIC_DEFAULT_FABLE_MODEL` или сопоставлен через [`modelOverrides`](#override-model-ids-per-version). Opus 5.5, Sonnet 5.5 и Opus 5 распознаются по идентификатору модели поставщика или по сопоставлению в [`modelOverrides`](#override-model-ids-per-version).

622* Цель Opus должна разрешаться в вашем развертывании, независимо от того, какая модель отказала: установите `ANTHROPIC_DEFAULT_OPUS_MODEL` или сохраните запись Opus 4.8 в списке моделей поставщика. Без одной резервный вариант остается отключенным для каждой исходной модели, включая Sonnet 5.5, и отмеченные запросы заканчиваются отказом.628* Целевая модель Opus должна разрешаться в вашем развёртывании, независимо от того, какая модель отказала: установите `ANTHROPIC_DEFAULT_OPUS_MODEL` или сохраните запись Opus 4.8 в списке моделей поставщика. Без этого переключение остаётся отключённым для всех исходных моделей, включая Sonnet 5.5, и помеченные запросы завершаются отказом.

623* Резервная модель отмеченной категории должна разрешаться в вашем развертывании. Из модели Fable, Opus 5.5 или Opus 5, если вы установите `ANTHROPIC_DEFAULT_OPUS_MODEL`, отмеченные запросы повторно запускаются на этой модели для каждой категории, которая имеет резервный вариант; флаг биологии на Opus 5 по-прежнему заканчивается отказом. Если вы не установите его, запросы, отмеченные кибербезопасностью, повторно запускаются на записи Opus 4.8, а запросы, отмеченные биологией, из модели Fable или Opus 5.5 на записи Opus 5. Из Sonnet 5.5 запросы, отмеченные кибербезопасностью, повторно запускаются на модели, которую вы установили в `ANTHROPIC_DEFAULT_SONNET_MODEL`, или на записи Sonnet 5 в списке моделей поставщика, если вы не установите его.629* Резервная модель для помеченной категории должна разрешаться в вашем развёртывании. Для модели Fable, Opus 5.5 или Opus 5, если вы установите `ANTHROPIC_DEFAULT_OPUS_MODEL`, помеченные запросы повторно выполняются на этой модели для каждой категории, у которой есть резервная модель; пометка биологии на Opus 5 по-прежнему завершается отказом. Если вы его не установите, запросы, помеченные как связанные с кибербезопасностью, повторно выполняются на записи Opus 4.8, а запросы, помеченные как связанные с биологией, от модели Fable или Opus 5.5 — на записи Opus 5. Для Sonnet 5.5 запросы, помеченные как связанные с кибербезопасностью, повторно выполняются на модели, которую вы задали в `ANTHROPIC_DEFAULT_SONNET_MODEL`, или, если вы её не задали, на записи Sonnet 5 в списке моделей поставщика.

624 630

625Если какая-либо модель не может быть идентифицирована, Claude Code не переключается. Отмеченный запрос заканчивается сообщением об отказе, и вы можете переключить модели с помощью [`/model`](#setting-your-model) и повторить попытку. Чтобы сделать обе модели идентифицируемыми, установите закрепления для вашей исходной модели:631Если какую-либо из моделей не удаётся идентифицировать, Claude Code не переключается. Помеченный запрос завершается сообщением об отказе, и вы можете переключить модель с помощью [`/model`](#setting-your-model) и повторить попытку. Чтобы обе модели можно было идентифицировать, задайте закрепления для вашей исходной модели:

626 632

627* **Модели Fable**: установите `ANTHROPIC_DEFAULT_FABLE_MODEL` на идентификатор вашей модели Fable, чтобы Claude Code распознал ее как источник резервного варианта.633* **Модели Fable**: установите `ANTHROPIC_DEFAULT_FABLE_MODEL` в идентификатор вашей модели Fable, чтобы Claude Code распознавал её как источник переключения.

628* **Каждая исходная модель**: установите `ANTHROPIC_DEFAULT_OPUS_MODEL` на идентификатор модели Opus, чтобы включить резервный вариант и дать отмеченным категориям цель. Закрепление, которое называет модель вне семейства Opus или модель, которая отказала, оставляет отказ в силе.634* **Любая исходная модель**: установите `ANTHROPIC_DEFAULT_OPUS_MODEL` в идентификатор модели Opus, чтобы включить переключение и дать помеченным категориям целевую модель. Закрепление, указывающее модель вне семейства Opus или ту модель, которая отказала, оставляет отказ в силе.

629* **Sonnet 5.5**: в дополнение к закреплению Opus установите `ANTHROPIC_DEFAULT_SONNET_MODEL` или сохраните запись Sonnet 5 в списке моделей поставщика, чтобы предоставить модель, на которой запрос повторно запускается. Закрепление Sonnet, которое называет модель вне семейства Sonnet или Sonnet 5.5 само по себе, оставляет отказ в силе.635* **Sonnet 5.5**: помимо закрепления Opus установите `ANTHROPIC_DEFAULT_SONNET_MODEL` или сохраните запись Sonnet 5 в списке моделей поставщика, чтобы указать модель, на которой запрос будет выполнен повторно. Закрепление Sonnet, указывающее модель вне семейства Sonnet или саму Sonnet 5.5, оставляет отказ в силе.

636

637Резервная модель также должна иметь контекстное окно не меньше, чем у сессии, иначе Claude Code не переключается, и помеченный запрос завершается тем же отказом. У этих поставщиков исходные модели по умолчанию работают с [контекстным окном 1M](#extended-context). Закрепите модель, которая тоже работает с ним, например Opus 4.8 в `ANTHROPIC_DEFAULT_OPUS_MODEL` или Sonnet 5 в `ANTHROPIC_DEFAULT_SONNET_MODEL`, по идентификатору, который Claude Code [может сопоставить с этой моделью](#pin-models-for-third-party-deployments).

630 638

631<h4 id="security-research-and-biology-workloads">639<h4 id="security-research-and-biology-workloads">

632 Исследование безопасности и рабочие нагрузки биологии640 Исследования безопасности и рабочие нагрузки в области биологии

633</h4>641</h4>

634 642

635Рабочие нагрузки в наступательной безопасности или биологии, включая тестирование на проникновение, упражнения Capture the Flag (CTF) и кодовые базы, смежные с биологией, часто вызывают резервный вариант, часто при первом запросе. Для существенной работы по биологии на Fable 5.1, Fable 5 или Opus 5.5 Claude Code перемещает сеанс на Opus 5 при первом отмеченном запросе, и более поздние запросы, отмеченные биологией, заканчиваются отказами там, потому что Opus 5 не имеет резервного варианта биологии. На Opus 5 и Sonnet 5.5 вы получаете эти отказы с первого отмеченного запроса.643Рабочие нагрузки в наступательной безопасности или биологии, включая тестирование на проникновение, упражнения Capture the Flag (CTF) и кодовые базы, связанные с биологией, часто вызывают переключение на резервную модель, нередко уже при первом запросе. При серьёзной работе по биологии на Fable 5.1, Fable 5 или Opus 5.5 первый помеченный запрос, приводящий к переключению моделей, переводит сессию на Opus 5, и последующие запросы, помеченные как связанные с биологией, завершаются там отказами, потому что у Opus 5 нет резервной модели для биологии. На Opus 5 и Sonnet 5.5 вы получаете эти отказы начиная с первого помеченного запроса.

636 644

637Это ожидаемая маршрутизация для этих областей, а не флаг учетной записи. Если вашей организации требуется возможность класса Fable для этой работы, обратитесь к команде учетной записи Anthropic о программах доверенного доступа.645Это ожидаемая маршрутизация для этих областей, а не пометка учётной записи. Если вашей организации для этой работы нужны возможности класса Fable, обратитесь к своей команде по работе с клиентами Anthropic по поводу программ доверенного доступа.

638 646

639<h3 id="adjust-effort-level">647<h3 id="adjust-effort-level">

640 Регулировка уровня усилий648 Регулировка уровня усилий

641</h3>649</h3>

642 650

643[Уровни усилий](https://platform.claude.com/docs/en/build-with-claude/effort) управляют адаптивным рассуждением, которое позволяет модели решать, нужно ли и сколько думать на каждом шаге в зависимости от сложности задачи. Более низкие усилия быстрее и дешевле для простых задач, в то время как более высокие усилия обеспечивают более глубокое рассуждение для сложных проблем.651[Уровни усилий](https://platform.claude.com/docs/en/build-with-claude/effort) управляют адаптивными рассуждениями, которые позволяют модели решать, нужно ли и сколько думать на каждом шаге в зависимости от сложности задачи. Более низкий уровень быстрее и дешевле для простых задач, а более высокий обеспечивает более глубокие рассуждения для сложных проблем.

644 652

645Доступные уровни усилий зависят от модели. Модели, не указанные здесь, не поддерживают усилия:653Доступные уровни усилий зависят от модели. Модели, не указанные здесь, не поддерживают effort:

646 654

647| Модель | Уровни |655| Модель | Уровни |

648| :- | :- |656| :- | :- |

652 660

653Если вы установите уровень, который активная модель не поддерживает, Claude Code переходит на наивысший поддерживаемый уровень на или ниже установленного. Например, `xhigh` работает как `high` на Opus 4.6. Ваша организация или ваши собственные параметры также могут ограничивать уровни, которые предлагает модель; см. [Ограничения усилий организации](#organization-effort-limits).661Если вы установите уровень, который активная модель не поддерживает, Claude Code использует наивысший поддерживаемый уровень, не превышающий установленный. Например, `xhigh` работает как `high` на Opus 4.6. Ваша организация или ваши собственные настройки также могут ограничивать уровни, которые предлагает модель; см. [Ограничения усилий организации](#organization-effort-limits).

662

663Claude Code определяет уровень усилий сессии в следующем порядке, используя первый применимый:

654 664

655Claude Code разрешает уровень усилий сеанса в этом порядке, принимая первый применимый:6651. Явный выбор: переменная окружения [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/ru/env-vars#variables), запуск с `--effort` или `/effort` в сессии ([неинтерактивный `/effort` действует уже](#non-interactive-effort))

6662. Ваши настройки: уровень, сохранённый вами для модели, или ключ [`effortLevel`](/docs/ru/settings-reference#effortlevel); приоритет между ними и между файлами настроек описан в [`modelSettings`](/docs/ru/settings-reference#modelsettings)

6673. Уровень усилий модели по умолчанию: `high` на каждой модели, поддерживающей effort, за исключением того, что Opus 5.5, Sonnet 5.5 и Haiku 5.5 по умолчанию используют `medium`, Opus 4.7 по умолчанию использует `xhigh`, а когда ваша организация задаёт уровень усилий по умолчанию для своей [модели по умолчанию организации](#organization-default-model), этот уровень используется по умолчанию при работе с этой моделью

656 668

6571. Явный выбор: переменная окружения [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/ru/env-vars#variables), запуск с `--effort` или `/effort` в сеансе ([неинтерактивный `/effort` имеет более узкий эффект](#non-interactive-effort))669Об уровне, который применяется после автоматического переключения на резервную модель, см. [Уровень усилий после переключения на резервную модель](#effort-level-after-a-fallback).

6582. Ваши параметры: уровень, который вы сохранили для модели или ключ [`effortLevel`](/docs/ru/settings-reference#effortlevel), с приоритетом между ними и между файлами параметров, указанным в [`modelSettings`](/docs/ru/settings-reference#modelsettings)

6593. Уровень усилий модели по умолчанию: `high` на каждой модели, поддерживающей effort, за исключением того, что Opus 5.5, Sonnet 5.5 и Haiku 5.5 по умолчанию используют `medium`, Opus 4.7 по умолчанию использует `xhigh`, а когда ваша организация задаёт уровень усилий по умолчанию для своей [модели по умолчанию организации](#organization-default-model), этот уровень используется по умолчанию при работе с этой моделью. Об уровне, который применяется после автоматического переключения на резервную модель, см. [Уровень усилий после переключения на резервную модель](#effort-level-after-a-fallback).

660 670

661Opus 5.5 начинает с `medium`, если один из источников выше не устанавливает уровень для него, и верхний уровень `effortLevel` в файле параметров пользователя не считается для Opus 5.5. Этот ключ — это более старая форма, которую `/effort` писал перед тем, как Claude Code сохранял уровни для каждой модели: он продолжает применяться там, где применялся раньше, на Opus 5, Fable 5.1 и более ранних моделях, в то время как Opus 5.5 и модели, выпущенные после него, начинают со своего собственного стандарта, пока вы не выберете уровень для них с помощью `/effort` или средства выбора `/model`. Верхний уровень `effortLevel` в параметрах проекта, локальных или управляемых параметрах, или переданный с `--settings`, применяется к каждой модели.671Opus 5.5 начинает с `medium`, если ни один из перечисленных выше источников не задаёт для него уровень, а ключ `effortLevel` верхнего уровня в вашем файле пользовательских настроек для Opus 5.5 не учитывается. Этот ключ — старая форма, которую `/effort` записывал до того, как Claude Code стал сохранять уровни для каждой модели: он продолжает действовать там, где действовал раньше, — на Opus 5, Fable 5.1 и более ранних моделях, тогда как Opus 5.5 и модели, выпущенные после неё, начинают со своего собственного уровня по умолчанию, пока вы не выберете для них уровень с помощью `/effort` или средства выбора `/model`. Ключ `effortLevel` верхнего уровня в настройках проекта, локальных или управляемых настройках или переданный с `--settings` применяется ко всем моделям.

662 672

663Когда вы устанавливаете `low`, `medium`, `high` или `xhigh` в интерактивном сеансе на вашей машине, вы выбираете, как долго это длится, подтверждая это:673Когда вы устанавливаете `low`, `medium`, `high` или `xhigh` в интерактивной сессии на своём компьютере, срок действия уровня определяется тем, как вы его подтверждаете:

664 674

665* `Enter` в ползунке `/effort` или средстве выбора `/model`, или уровень, введенный после `/effort`: сохраните уровень как стандартный и примените его в более поздних сеансах675* `Enter` в ползунке `/effort` или средстве выбора `/model` либо уровень, введённый после `/effort`: уровень сохраняется как ваш уровень по умолчанию и применяется в последующих сессиях

666* `s` в ползунке `/effort` или средстве выбора `/model`: примените уровень только к этому сеансу. Требуется Claude Code версии 2.1.257 или позже676* `s` в ползунке `/effort` или средстве выбора `/model`: уровень применяется только к этой сессии. Требуется Claude Code версии 2.1.257 или позже

667 677

668Claude Code сохраняет уровень для каждой модели под ключом [`modelSettings`](/docs/ru/settings-reference#modelsettings) в параметрах пользователя, поэтому каждая модель сохраняет свой собственный уровень.678Claude Code сохраняет уровень для каждой модели в ключе [`modelSettings`](/docs/ru/settings-reference#modelsettings) в пользовательских настройках, поэтому у каждой модели свой сохранённый уровень.

669 679

670`max` — это самый глубокий уровень рассуждения. Если вы не установите его через переменную окружения `CLAUDE_CODE_EFFORT_LEVEL`, Claude Code применяет `max` только к текущему сеансу.680`max` — самый глубокий уровень рассуждений. Если вы не задаёте его через переменную окружения `CLAUDE_CODE_EFFORT_LEVEL`, Claude Code применяет `max` только к текущей сессии.

671 681

672<Note>682<Note>

673 Уровень, который вы выбираете из управления усилиями на телефоне или в браузере, подключенном через [Remote Control](/docs/ru/remote-control#what-connected-devices-see), применяется только к этому сеансу.683 Уровень, который вы выбираете в элементе управления усилиями на телефоне или в браузере, подключённом через [Remote Control](/docs/ru/remote-control#what-connected-devices-see), применяется только к этой сессии.

674</Note>684</Note>

675 685

676<span id="non-interactive-effort" />686<span id="non-interactive-effort" />

677 687

678Когда вы устанавливаете уровень с `/effort` в запуске [`-p`](/docs/ru/headless), Claude Code применяет его только к этому сеансу и не сохраняет его как стандартный.688Когда вы устанавливаете уровень с помощью `/effort` при [запуске с `-p`](/docs/ru/headless), Claude Code применяет его только к этой сессии и не сохраняет как уровень по умолчанию.

679 689

680Ползунок `/effort` также имеет переключатель **Ultracode**. Ultracode — это параметр Claude Code, а не уровень усилий модели: с его включением Claude организует [динамические рабочие процессы](/docs/ru/workflows) для существенных задач, на любом уровне усилий, на котором работает сеанс. Для того, где это можно установить постоянно, см. параметр [`ultracode`](/docs/ru/settings-reference#ultracode).690В ползунке `/effort` также есть переключатель **Ultracode**. Ultracode — это настройка Claude Code, а не уровень усилий модели: когда она включена, Claude организует [динамические рабочие процессы](/docs/ru/workflows) для существенных задач на любом уровне усилий, на котором работает сессия. О том, где её можно задать постоянно, см. настройку [`ultracode`](/docs/ru/settings-reference#ultracode).

681 691

682Включение или отключение ultracode с помощью `/effort` или параметра `ultracode` оставляет уровень усилий неизменным. Флаг `--effort ultracode` и значение Agent SDK `effortLevel: "ultracode"` включают его и также устанавливают уровень на `xhigh`. Выбор уровня в ползунке `/effort` или средстве выбора `/model` оставляет ultracode таким, как он был.692Включение или отключение ultracode с помощью `/effort` или настройки `ultracode` не меняет уровень усилий. Флаг `--effort ultracode` и значение Agent SDK `effortLevel: "ultracode"` включают его и также устанавливают уровень `xhigh`. Выбор уровня в ползунке `/effort` или средстве выбора `/model` оставляет ultracode в прежнем состоянии.

683 693

684Вы можете включить ultracode через любое из следующего:694Включить ultracode можно любым из следующих способов:

685 695

686* **`/effort`**: запустите `/effort ultracode`, чтобы включить его для текущего сеанса, или `/effort ultracode off`, чтобы отключить его. В ползунке `/effort` нажмите `Tab`, чтобы переключить переключатель **Ultracode**, затем `Enter`, чтобы применить его696* **`/effort`**: выполните `/effort ultracode`, чтобы включить его для текущей сессии, или `/effort ultracode off`, чтобы отключить. В ползунке `/effort` нажмите `Tab`, чтобы переключить **Ultracode**, затем `Enter`, чтобы применить

687* **Флаг `--effort`**: запустите с `claude --effort ultracode`, который запускает сеанс с усилиями `xhigh` и включенным ultracode697* **Флаг `--effort`**: запустите `claude --effort ultracode`, что начинает сессию с уровнем `xhigh` и включённым ultracode

688* **Параметр `ultracode`**: установите [`"ultracode": true`](/docs/ru/settings-reference#ultracode) в файле параметров, с `--settings` или в запросе управления Agent SDK. Запрос [`applyFlagSettings()`](/docs/ru/agent-sdk/typescript#applyflagsettings) также принимает `effortLevel: "ultracode"`, который включает его и устанавливает уровень усилий на `xhigh`698* **Настройка `ultracode`**: задайте [`"ultracode": true`](/docs/ru/settings-reference#ultracode) в файле настроек, с `--settings` или в управляющем запросе Agent SDK. Запрос [`applyFlagSettings()`](/docs/ru/agent-sdk/typescript#applyflagsettings) также принимает `effortLevel: "ultracode"`, что включает его и устанавливает уровень усилий `xhigh`

689 699

690Форма `/effort ultracode off`, переключатель ползунка и сохранение ultracode включенным на уровнях усилий, отличных от `xhigh`, требуют Claude Code версии 2.1.284 или позже. До версии 2.1.284 включение ultracode устанавливало сеанс на усилия `xhigh`, выбор другого уровня отключал его, и ограничение усилий ниже `xhigh` делало его недоступным.700Форма `/effort ultracode off`, переключатель в ползунке и сохранение ultracode включённым на уровнях усилий, отличных от `xhigh`, требуют Claude Code версии 2.1.284 или позже. До версии 2.1.284 включение ultracode устанавливало для сессии уровень `xhigh`, выбор другого уровня отключал его, а ограничение усилий ниже `xhigh` делало его недоступным.

691 701

692Передача `ultracode` флагу `--effort` или значению Agent SDK `effortLevel` требует Claude Code версии 2.1.203 или позже. До версии 2.1.203 `--effort ultracode` печатал `Unknown --effort value 'ultracode'` и сеанс начинался с усилиями по умолчанию.702Передача `ultracode` во флаг `--effort` или в значение Agent SDK `effortLevel` требует Claude Code версии 2.1.203 или позже. До версии 2.1.203 `--effort ultracode` выводил `Unknown --effort value 'ultracode'`, и сессия начиналась с уровнем усилий по умолчанию.

693 703

694Сохраненный параметр `effortLevel` и переменная окружения `CLAUDE_CODE_EFFORT_LEVEL` не принимают `ultracode`. Если `CLAUDE_CODE_EFFORT_LEVEL` или [ограничение усилий](#organization-effort-limits) устанавливает уровень сеанса, ultracode остается включенным на этом уровне.704Сохраняемая настройка `effortLevel` и переменная окружения `CLAUDE_CODE_EFFORT_LEVEL` не принимают `ultracode`. Если `CLAUDE_CODE_EFFORT_LEVEL` или [ограничение усилий](#organization-effort-limits) задаёт уровень сессии, ultracode остаётся включённым на этом уровне.

695 705

696<span id="when-ultracode-is-available" />706<span id="when-ultracode-is-available" />

697 707

698Ultracode недоступен, когда:708Ultracode недоступен, когда:

699 709

700* [Рабочие процессы отключены](/docs/ru/workflows#turn-workflows-off)710* [Рабочие процессы отключены](/docs/ru/workflows#turn-workflows-off)

701* Модель не поддерживает усилия `xhigh`711* Модель не поддерживает уровень `xhigh`

702 712

703В этих случаях `--effort ultracode` запускает сеанс с отключенным ultracode, на наивысшем уровне усилий, который модель и любое ограничение позволяют, вплоть до `xhigh`.713В этих случаях `--effort ultracode` запускает сессию с отключённым ultracode на наивысшем уровне усилий, который допускают модель и любое ограничение, но не выше `xhigh`.

704 714

705<h4 id="choose-an-effort-level">715<h4 id="choose-an-effort-level">

706 Выбор уровня усилий716 Выбор уровня усилий

707</h4>717</h4>

708 718

709Каждый уровень торгует расходом токенов против возможности. Стандартный уровень подходит для большинства задач кодирования; регулируйте, когда вы хотите другой баланс.719Каждый уровень — это компромисс между расходом токенов и возможностями. Уровень по умолчанию подходит для большинства задач программирования; меняйте его, когда вам нужен другой баланс.

710 720

711| Уровень | Когда его использовать |721| Уровень | Когда его использовать |

712| :- | :- |722| :- | :- |

713| `low` | Быстрые обмены, где вы проверяете каждый результат, такие как мозговой штурм, первый набросок или небольшое изменение, такое как переименование |723| `low` | Быстрые обмены, где вы проверяете каждый результат, например мозговой штурм, первый набросок или небольшое изменение вроде переименования |

714| `medium` | Уровень по умолчанию на Opus 5.5, Sonnet 5.5 и Haiku 5.5. На Opus 5.5 и Sonnet 5.5 подходит для повседневной инженерной работы с чётко определёнными рамками, например реализации новой функции. На моделях с более высоким уровнем по умолчанию снижает расход токенов для работы, чувствительной к затратам, где можно пожертвовать частью интеллекта |724| `medium` | Уровень по умолчанию на Opus 5.5, Sonnet 5.5 и Haiku 5.5. На Opus 5.5 и Sonnet 5.5 подходит для повседневной инженерной работы с чётко определёнными рамками, например реализации новой функции. На моделях с более высоким уровнем по умолчанию снижает расход токенов для работы, чувствительной к затратам, где можно пожертвовать частью интеллекта |

715| `high` | Работа, где важна проверка или вероятны граничные случаи, например исправление ошибки в существующей кодовой базе. Уровень по умолчанию на всех моделях, кроме Opus 5.5, Sonnet 5.5, Haiku 5.5 и Opus 4.7 |725| `high` | Работа, где важна проверка или вероятны граничные случаи, например исправление ошибки в существующей кодовой базе. Уровень по умолчанию на всех моделях, кроме Opus 5.5, Sonnet 5.5, Haiku 5.5 и Opus 4.7 |

717| `max` | Сложные проблемы, которые вы хотите, чтобы Claude решил без вас, такие как поиск уязвимостей безопасности. `max` может показать убывающую отдачу и склонен к чрезмерному размышлению, поэтому протестируйте перед широким внедрением |727| `max` | Сложные проблемы, которые вы хотите, чтобы Claude проработал без вас, например поиск уязвимостей безопасности. `max` может давать убывающую отдачу и склонен к чрезмерному обдумыванию, поэтому протестируйте его перед широким внедрением |

718| `ultracode` | Параметр Claude Code, а не уровень: планирует [динамический рабочий процесс](/docs/ru/workflows) для каждой существенной задачи на любом уровне усилий |728| `ultracode` | Настройка Claude Code, а не уровень: планирует [динамический рабочий процесс](/docs/ru/workflows) для каждой существенной задачи на любом уровне усилий |

719 729

720В тестах на Opus 5.5 и Fable 5.1 Claude на более высоком уровне протестировал больше граничных случаев и проверил больше своей работы перед ответом. Он также сделал больше выборов самостоятельно. На более низком уровне Claude вернул начальную точку быстрее, что подходит для работы, где вы проверяете каждый результат и направляете следующий шаг. Чтобы увидеть одни и те же задачи, выполняемые на каждом уровне, прочитайте [Using Claude Code: Spending your effort](https://claude.dev/blog/spending-your-effort/) в блоге.730В тестах на Opus 5.5 и Fable 5.1 Claude на более высоком уровне проверял больше граничных случаев и больше перепроверял свою работу перед ответом. Он также принимал больше решений самостоятельно. На более низком уровне Claude быстрее возвращал отправную точку, что подходит для работы, где вы проверяете каждый результат и направляете следующий шаг. Чтобы увидеть, как одни и те же задачи выполняются на каждом уровне, прочитайте [Using Claude Code: Spending your effort](https://claude.dev/blog/spending-your-effort/) в блоге.

721 731

722Шкала усилий откалибрована для каждой модели, поэтому одно и то же имя уровня не представляет одно и то же базовое значение между моделями.732Шкала усилий откалибрована для каждой модели отдельно, поэтому одно и то же имя уровня не соответствует одному и тому же базовому значению у разных моделей.

723 733

724Opus 5.5 [по умолчанию имеет `medium`](#adjust-effort-level), на один уровень ниже стандарта Opus 5 в `high`. В тестировании Anthropic Opus 5.5 на `medium` соответствует или превосходит Opus 5 на `high` при оценке кодирования и работы со знаниями. На заданном уровне Opus 5.5 имеет тенденцию думать больше за ход, чем Opus 5. Когда вы переходите с Opus 5 на Opus 5.5, начните с `medium` вместо того, чтобы переносить уровень, который вы использовали на Opus 5. Чтобы протестировать уровни на вашей собственной работе, см. [Calibrate effort](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#calibrate-effort) в руководстве по подсказкам Opus 5.5.734Opus 5.5 [по умолчанию использует `medium`](#adjust-effort-level) — на один уровень ниже, чем `high` по умолчанию у Opus 5. В тестировании Anthropic Opus 5.5 на `medium` не уступает или превосходит Opus 5 на `high` в оценках по программированию и работе со знаниями. На одном и том же уровне Opus 5.5 обычно думает за ход больше, чем Opus 5. При переходе с Opus 5 на Opus 5.5 начните с `medium`, а не переносите уровень, который вы использовали на Opus 5. Чтобы протестировать уровни на своей работе, см. [Calibrate effort](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#calibrate-effort) в руководстве по составлению промптов для Opus 5.5.

725 735

726<h4 id="use-ultrathink-for-one-off-deep-reasoning">736<h4 id="use-ultrathink-for-one-off-deep-reasoning">

727 Использование ultrathink для одноразового глубокого рассуждения737 Использование ultrathink для разовых глубоких рассуждений

728</h4>738</h4>

729 739

730Включите `ultrathink` в любое место вашей подсказки, чтобы запросить более глубокое рассуждение на этом ходе без изменения параметра усилий сеанса. Claude Code распознает ключевое слово и добавляет встроенную инструкцию. Уровень усилий, отправленный в API, не изменяется. Claude Code передает другие фразы, такие как "think", "think hard" и "think more", как обычный текст подсказки и не распознает их как ключевые слова.740Включите `ultrathink` в любое место промпта, чтобы запросить более глубокие рассуждения на этом ходе, не меняя настройку усилий сессии. Claude Code распознаёт ключевое слово и добавляет инструкцию в контекст. Уровень усилий, отправляемый в API, не меняется. Другие фразы, такие как "think", "think hard" и "think more", Claude Code передаёт как обычный текст промпта и не распознаёт как ключевые слова.

731 741

732<h4 id="set-the-effort-level">742<h4 id="set-the-effort-level">

733 Установка уровня усилий743 Установка уровня усилий

734</h4>744</h4>

735 745

736Вы можете изменить усилия через любое из следующего:746Изменить уровень усилий можно любым из следующих способов:

737 747

738* **`/effort`**: запустите `/effort` без аргументов, чтобы открыть интерактивный ползунок, `/effort`, за которым следует имя уровня, чтобы установить его напрямую, или `/effort auto`, чтобы очистить сохраненный уровень для активной модели. Вы можете запустить его, пока Claude работает, и после подтверждения [предупреждения о кэше](/docs/ru/prompt-caching#changing-effort-level), если Claude Code показывает его, Claude Code применяет новый уровень к следующему запросу в ходе748* **`/effort`**: выполните `/effort` без аргументов, чтобы открыть интерактивный ползунок, `/effort` с именем уровня, чтобы задать его напрямую, или `/effort auto`, чтобы сбросить сохранённый уровень для активной модели. Команду можно выполнять, пока Claude работает, и после подтверждения [предупреждения о кэше](/docs/ru/prompt-caching#changing-effort-level), если Claude Code его показывает, Claude Code применяет новый уровень к следующему запросу в ходе

739* **В `/model`**: используйте клавиши со стрелками влево/вправо, чтобы отрегулировать ползунок усилий при выборе модели749* **В `/model`**: при выборе модели используйте клавиши со стрелками влево/вправо, чтобы отрегулировать ползунок усилий

740* **Флаг `--effort`**: передайте имя уровня, чтобы установить его для одного сеанса при запуске Claude Code750* **Флаг `--effort`**: передайте имя уровня при запуске Claude Code, чтобы задать его для одной сессии

741* **Переменная окружения**: установите `CLAUDE_CODE_EFFORT_LEVEL` на имя уровня или `auto`751* **Переменная окружения**: установите `CLAUDE_CODE_EFFORT_LEVEL` в имя уровня или `auto`

742* **Параметры**: установите уровень для каждой модели в [`modelSettings`](/docs/ru/settings-reference#modelsettings) или установите [`effortLevel`](/docs/ru/settings-reference#effortlevel) на `low`, `medium`, `high` или `xhigh` как стандартный для моделей без одного. `max` не принимается как уровень ни в одном ключе, и `ultracode` имеет свой собственный ключ [`ultracode`](/docs/ru/settings-reference#ultracode)752* **Настройки**: задайте уровень для отдельной модели в [`modelSettings`](/docs/ru/settings-reference#modelsettings) или установите [`effortLevel`](/docs/ru/settings-reference#effortlevel) в `low`, `medium`, `high` или `xhigh` как уровень по умолчанию для моделей без собственного уровня. `max` не принимается как уровень ни в одном из этих ключей, а у `ultracode` есть собственный ключ [`ultracode`](/docs/ru/settings-reference#ultracode)

743* **С подключенного устройства**: в сеансе [Remote Control](/docs/ru/remote-control#what-connected-devices-see) выберите уровень из управления усилиями на вашем телефоне или в браузере. Уровень применяется только к текущему сеансу. Требуется Claude Code версии 2.1.234 или позже753* **С подключённого устройства**: в сессии [Remote Control](/docs/ru/remote-control#what-connected-devices-see) выберите уровень в элементе управления усилиями на телефоне или в браузере. Уровень применяется только к текущей сессии. Требуется Claude Code версии 2.1.234 или позже

744* **Frontmatter skill и subagent**: установите `effort` в файле markdown [skill](/docs/ru/skills#frontmatter-reference) или [subagent](/docs/ru/sub-agents#supported-frontmatter-fields), чтобы переопределить уровень усилий при запуске этого skill или subagent754* **Frontmatter скиллов и субагентов**: задайте `effort` в markdown-файле [скилла](/docs/ru/skills#frontmatter-reference) или [субагента](/docs/ru/sub-agents#supported-frontmatter-fields), чтобы переопределить уровень усилий при работе этого скилла или субагента

745 755

746Frontmatter усилия применяются, когда этот skill или subagent активен, переопределяя уровень сеанса, но не переменную окружения. [`maxEffortLevel`](/docs/ru/settings-reference#maxeffortlevel) или [ограничение усилий организации](#organization-effort-limits) по-прежнему ограничивает уровень, на котором работает skill или subagent.756Уровень усилий из frontmatter применяется, когда этот скилл или субагент активен, и переопределяет уровень сессии, но не переменную окружения. [`maxEffortLevel`](/docs/ru/settings-reference#maxeffortlevel) или [ограничение усилий организации](#organization-effort-limits) по-прежнему ограничивают уровень, на котором работает скилл или субагент.

747 757

748Если вы установите `effortLevel` в [управляемых параметрах](/docs/ru/managed-settings), Claude Code применяет его на этапе параметров [порядка разрешения усилий](#adjust-effort-level), и пользователи все еще могут изменять уровень с помощью `/effort` или `--effort`. Чтобы держать пользователей на или ниже уровня, установите [`maxEffortLevel`](/docs/ru/settings-reference#maxeffortlevel).758Если вы задаёте `effortLevel` в [управляемых настройках](/docs/ru/managed-settings), Claude Code применяет его на шаге настроек [порядка разрешения усилий](#adjust-effort-level), и пользователи по-прежнему могут менять уровень с помощью `/effort` или `--effort`. Чтобы пользователи не превышали определённый уровень, задайте [`maxEffortLevel`](/docs/ru/settings-reference#maxeffortlevel).

749 759

750Ползунок усилий появляется в `/model`, когда выбрана поддерживаемая модель. Текущий уровень усилий также показывается в заголовке сеанса рядом с именем модели, например "with low effort", поэтому вы можете подтвердить, какой параметр активен, без открытия `/model`. Нижний колонтитул также кратко показывает уровень усилий при запуске и при его изменении.760Ползунок усилий появляется в `/model`, когда выбрана поддерживаемая модель. Текущий уровень усилий также показывается в заголовке сессии рядом с именем модели, например "with low effort", поэтому вы можете проверить, какая настройка активна, не открывая `/model`. Нижняя строка также ненадолго показывает уровень усилий при запуске и при его изменении.

751 761

752<h4 id="adaptive-reasoning-and-fixed-thinking-budgets">762<h4 id="adaptive-reasoning-and-fixed-thinking-budgets">

753 Адаптивное рассуждение и фиксированные бюджеты размышления763 Адаптивные рассуждения и фиксированные бюджеты мышления

754</h4>764</h4>

755 765

756Адаптивное рассуждение делает размышление необязательным на каждом шаге, поэтому Claude может быстрее реагировать на обычные подсказки и зарезервировать более глубокое размышление для шагов, которые от него выигрывают. Если вы хотите, чтобы Claude думал чаще или реже, чем производит текущий уровень, вы можете сказать об этом прямо в своей подсказке или в `CLAUDE.md`; модель реагирует на это руководство в рамках своего параметра усилий.766Адаптивные рассуждения делают мышление необязательным на каждом шаге, поэтому Claude может быстрее отвечать на рутинные промпты и приберегать более глубокое мышление для шагов, которым оно полезно. Если вы хотите, чтобы Claude думал чаще или реже, чем при текущем уровне, можно сказать об этом прямо в промпте или в `CLAUDE.md`; модель учитывает такие указания в рамках своей настройки усилий.

757 767

758Модели Fable, Sonnet 5 и новее, Haiku 5.5, а также Opus 4.7 и новее всегда используют адаптивные рассуждения. Режим фиксированного бюджета мышления и `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` к ним не применяются.768Модели Fable, Sonnet 5 и новее, Haiku 5.5, а также Opus 4.7 и новее всегда используют адаптивные рассуждения. Режим фиксированного бюджета мышления и `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` к ним не применяются.

759 769

760На Opus 4.6 и Sonnet 4.6 вы можете установить `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1`, чтобы вернуться к предыдущему фиксированному бюджету размышления, контролируемому `MAX_THINKING_TOKENS`. См. [переменные окружения](/docs/ru/env-vars).770На Opus 4.6 и Sonnet 4.6 можно установить `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1`, чтобы вернуться к прежнему фиксированному бюджету мышления, управляемому `MAX_THINKING_TOKENS`. См. [переменные окружения](/docs/ru/env-vars).

761 771

762<h3 id="extended-thinking">772<h3 id="extended-thinking">

763 Extended thinking773 Расширенное мышление

764</h3>774</h3>

765 775

766Extended thinking — это рассуждение, которое Claude выдает перед ответом. На моделях, которые поддерживают [адаптивное рассуждение](#adjust-effort-level), уровень усилий является основным управлением тем, сколько размышления происходит; параметры ниже включают или отключают размышление и управляют тем, как оно отображается. С отключенным размышлением на Anthropic API Claude Code отправляет усилия `high` вместо более высокого уровня моделям, которые он знает [не принимают эту комбинацию](/docs/ru/errors#effort-isnt-available-with-thinking-turned-off), такие как Opus 5.776Расширенное мышление — это размышления, которые Claude выдаёт перед ответом. На моделях, поддерживающих [адаптивные рассуждения](#adjust-effort-level), основным регулятором объёма мышления является уровень усилий; настройки ниже включают или отключают мышление и управляют его отображением. Когда мышление отключено на Anthropic API, Claude Code отправляет уровень `high` вместо более высокого уровня моделям, которые, как ему известно, [не принимают такую комбинацию](/docs/ru/errors#effort-isnt-available-with-thinking-turned-off), например Opus 5.

767 777

768| Управление | Как его установить |778| Способ управления | Как его задать |

769| :- | :- |779| :- | :- |

771| Установка глобального стандартного | Запустите `/config` и переключите Thinking Mode. Сохранено как `alwaysThinkingEnabled` в `~/.claude/settings.json` |781| Установка глобального значения по умолчанию | Выполните `/config` и переключите режим мышления. Сохраняется как `alwaysThinkingEnabled` в `~/.claude/settings.json` |

772| Отключение через переменную окружения | Задайте [`MAX_THINKING_TOKENS=0`](/docs/ru/env-vars), что отключает мышление на Anthropic API, кроме Opus 5.5, Sonnet 5.5, Haiku 5.5 и моделей Fable. У [сторонних поставщиков](/docs/ru/third-party-integrations) Claude Code вместо этого опускает параметр `thinking`, и модели с адаптивными рассуждениями всё равно могут размышлять |782| Отключение через переменную окружения | Задайте [`MAX_THINKING_TOKENS=0`](/docs/ru/env-vars), что отключает мышление на Anthropic API, кроме Opus 5.5, Sonnet 5.5, Haiku 5.5 и моделей Fable. У [сторонних поставщиков](/docs/ru/third-party-integrations) Claude Code вместо этого опускает параметр `thinking`, и модели с адаптивными рассуждениями всё равно могут размышлять |

773 783

774Мышление нельзя отключить на Opus 5.5, Sonnet 5.5, Haiku 5.5 и моделях Fable. Переключатель сессии и строка в `/config` для этих моделей показывают `Thinking can't be turned off` вместо переключателя, а сохранённые `alwaysThinkingEnabled: false` или `MAX_THINKING_TOKENS=0` на них не действуют. На этих моделях модель сама решает на каждом шаге, сколько размышлять, исходя из уровня усилий. Сохранённая настройка снова начинает действовать, когда вы переключаетесь на модель, которая её поддерживает.784Мышление нельзя отключить на Opus 5.5, Sonnet 5.5, Haiku 5.5 и моделях Fable. Переключатель сессии и строка в `/config` для этих моделей показывают `Thinking can't be turned off` вместо переключателя, а сохранённые `alwaysThinkingEnabled: false` или `MAX_THINKING_TOKENS=0` на них не действуют. На этих моделях модель сама решает на каждом шаге, сколько размышлять, исходя из уровня усилий. Сохранённая настройка снова начинает действовать, когда вы переключаетесь на модель, которая её поддерживает.

775 785

776Claude Code сворачивает вывод размышления по умолчанию. Нажмите `Ctrl+O`, чтобы переключить подробный режим и увидеть рассуждение как серый курсивный текст. Интерактивные сеансы на Anthropic API получают отредактированные блоки размышления по умолчанию, поэтому установите `showThinkingSummaries: true` в [параметрах](/docs/ru/settings), если вы хотите, чтобы полные резюме были доступны при расширении. Вам выставляется счет за все сгенерированные токены размышления, даже когда они свернуты или отредактированы.786По умолчанию Claude Code сворачивает вывод размышлений. Нажмите `Ctrl+O`, чтобы переключить подробный режим и увидеть рассуждения серым курсивным текстом. Интерактивные сессии на Anthropic API по умолчанию получают скрытые блоки размышлений, поэтому установите `showThinkingSummaries: true` в [настройках](/docs/ru/settings), если хотите, чтобы при развороте были доступны полные резюме. Оплачиваются все сгенерированные токены мышления, даже если они свёрнуты или скрыты.

777 787

778<a id="extended-context-with-1m" />788<a id="extended-context-with-1m" />

779 789

790<span id="sonnet-5-5-and-sonnet-5-context-window" />

791

780<h3 id="extended-context">792<h3 id="extended-context">

781 Extended context793 Расширенный контекст

782</h3>794</h3>

783 795

784Fable 5.1, Fable 5, Sonnet 5 и новее, Haiku 5.5, Opus 4.6 и новее, а также Sonnet 4.6 поддерживают [контекстное окно в 1 миллион токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) для длительных сессий с большими кодовыми базами.796Fable 5.1, Fable 5, Sonnet 5 и новее, Haiku 5.5, Opus 4.6 и новее, а также Sonnet 4.6 поддерживают [контекстное окно в 1 миллион токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) для длительных сессий с большими кодовыми базами.

785 797

786На Anthropic API Fable 5.1, Fable 5, Sonnet 5 и новее, Haiku 5.5, а также Opus 4.7 и новее работают с окном 1M на любом тарифе, включая Pro. Для окна 1M на этих моделях не нужно выбирать вариант `[1m]` или включать кредиты использования. Само использование Fable на некоторых тарифах может оплачиваться из кредитов использования; см. [Fable и кредиты использования](#fable-and-usage-credits).798Fable 5.1, Fable 5, Sonnet 5 и новее, Haiku 5.5, а также Opus 4.7 и новее по умолчанию работают с окном 1M, и суффикс `[1m]` не нужен. Это относится и к сессиям на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, а также к сессиям [Claude apps gateway](/docs/ru/claude-apps-gateway). Чтобы вместо этого запускать их с окном 200K, см. [Отключение контекста 1M](#turn-off-1m-context).

787 799

788Opus 4.6 и Sonnet 4.6 достигают 1M только через их вариант `[1m]`, и доступ к этому варианту зависит от вашего плана. На планах Max, Team и Enterprise, включая как места Team Standard, так и Team Premium, Opus 4.6 с контекстом 1M включен в вашу подписку. Sonnet 4.6 с контекстом 1M требует [кредитов использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) на каждом плане подписки, включая Max.800Opus 4.6 и Sonnet 4.6 получают 1M только через свой вариант `[1m]`, и доступ к этому варианту зависит от вашего тарифа. На тарифах Max, Team и Enterprise, включая места как Team Standard, так и Team Premium, Opus 4.6 с контекстом 1M входит в вашу подписку. Sonnet 4.6 с контекстом 1M требует [кредитов использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) на любом тарифе подписки, включая Max.

789 801

791| - | - | - |803| - | - | - |

793| Pro | Требует [кредитов использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) | Требует [кредитов использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |805| Pro | Требует [кредитов использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) | Требует [кредитов использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |

795 807

796Claude Code проверяет эти требования плана только при прямом подключении к Anthropic API. Если вы указываете `ANTHROPIC_BASE_URL` на [LLM gateway](/docs/ru/llm-gateway#subscriptions-and-gateways) и ваш сохраненный вход claude.ai остается активным учетным данным, Claude Code не проверяет кредиты использования вашего плана. Параметры `[1m]` остаются доступными в `/model`, и шлюз решает, успешен ли запрос. До версии 2.1.229 Claude Code отклонял `/model sonnet[1m]` в этой конфигурации, когда не мог подтвердить кредиты использования на учетной записи.808Claude Code проверяет эти требования тарифа, только когда подключается к Anthropic API напрямую. Если вы направляете `ANTHROPIC_BASE_URL` на [LLM-шлюз](/docs/ru/llm-gateway#subscriptions-and-gateways), а ваш сохранённый вход в claude.ai остаётся активными учётными данными, Claude Code не проверяет кредиты использования вашего тарифа. Варианты `[1m]` остаются доступными в `/model`, и шлюз решает, будет ли запрос успешным. До версии 2.1.229 Claude Code в такой конфигурации отклонял `/model sonnet[1m]`, если не мог подтвердить наличие кредитов использования в учётной записи.

~~797~~

798<span id="context-window-behind-a-gateway" />

~~799~~

800Если вы установите `ANTHROPIC_BASE_URL` на [LLM-шлюз](/docs/ru/llm-gateway) или другой прокси, Claude Code даёт каждой распознанной модели то же контекстное окно, что и на Anthropic API. Fable 5.1, Fable 5, Sonnet 5 и новее, Haiku 5.5, а также Opus 4.7 и новее получают окно 1M без необходимости выбирать вариант `[1m]`, а модель, которая получает 1M только через свой вариант `[1m]`, например Opus 4.6, без него работает с 200K. Claude Code не может обнаружить более низкий предел, установленный шлюзом или сервером за ним. Если ваш шлюз отклоняет запросы свыше 200K токенов, установите [`CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000`](/docs/ru/env-vars) в окружении, из которого запускается Claude Code, чтобы сессии на всех моделях [сжимались на этой границе](#set-the-auto-compact-window).

~~801~~

802Чтобы отключить контекст 1M, установите `CLAUDE_CODE_DISABLE_1M_CONTEXT=1`. Claude Code удаляет варианты модели 1M из средства выбора модели. На моделях с собственным окном 1M, таких как Sonnet 5 и модели Fable, он также рассматривает модель как имеющую окно контекста 200K:

803 809

804* С включенным auto-compaction сеансы компактируются на границе 200K через [auto-compaction](#set-the-auto-compact-window). Установка окна auto-compact выше 200K не снимает удержание, потому что Claude Code ограничивает это окно окном контекста модели.810На Anthropic API контекстное окно 1M использует стандартные цены модели без надбавки за токены сверх 200K, за исключением Haiku 5.5, который [стоит дороже на промптах длиннее 100K токенов](#haiku-5-5-context-window-and-pricing). На тарифах, где расширенный контекст входит в подписку, использование по-прежнему покрывается подпиской. На тарифах, где доступ к расширенному контексту предоставляется через кредиты использования, токены оплачиваются из кредитов.

805* С отключенным auto-compaction сеансы останавливаются на границе 200K с [ошибкой ограничения контекста](/docs/ru/errors#prompt-is-too-long) вместо компактирования.

806 811

807До версии 2.1.223 Claude Code удерживал только сеансы Sonnet 5, Opus 4.8 и Opus 5 на 200K. См. [переменные окружения](/docs/ru/env-vars).812<h4 id="select-1m-context-for-opus-4-6-or-sonnet-4-6">

~~808~~ 813 Выбор контекста 1M для Opus 4.6 или Sonnet 4.6

809Контекстное окно 1M использует стандартные цены модели без надбавки за токены сверх 200K, за исключением Haiku 5.5, который [стоит дороже на промптах длиннее 100K токенов](#haiku-5-5-context-window-and-pricing). На тарифах, где расширенный контекст входит в подписку, использование по-прежнему покрывается подпиской. На тарифах, где доступ к расширенному контексту предоставляется через кредиты использования, токены оплачиваются из кредитов.814</h4>

~~810~~

811Если ваша учетная запись поддерживает контекст 1M, параметр появляется в средстве выбора `/model` в последних версиях Claude Code. Если вы его не видите, перезагрузите сеанс, и на сторонних поставщиках проверьте, [закрепила ли ваша развертывание модель](#pin-models-for-third-party-deployments) с переменной `ANTHROPIC_DEFAULT_*_MODEL`.

812 815

813Вы также можете использовать суффикс `[1m]` с псевдонимами моделей или полными именами моделей:816Чтобы выбрать вариант 1M по имени, добавьте суффикс `[1m]` к псевдониму модели или полному имени модели:

814 817

815```text theme={null}818```text theme={null}

816# Используйте псевдоним opus[1m] или sonnet[1m]819# Добавьте [1m] к полному имени модели

817/model opus[1m]820/model claude-opus-4-6[1m]

818/model sonnet[1m]821/model claude-sonnet-4-6[1m]

819 822

820# Или добавьте [1m] к полному имени модели823# Или к псевдониму: суффикс применяется к модели, в которую разрешается псевдоним

821/model claude-opus-4-8[1m]824/model opus[1m]

822```825```

823 826

824<h4 id="sonnet-5-5-and-sonnet-5-context-window">827<span id="context-window-behind-a-gateway" />

825 Окно контекста Sonnet 5.5 и Sonnet 5828

829<h4 id="context-window-behind-an-llm-gateway">

830 Контекстное окно за LLM-шлюзом

826</h4>831</h4>

827 832

828На Anthropic API Sonnet 5.5 и Sonnet 5 всегда работают с окном контекста 1M. Нет варианта 200K, нет суффикса `[1m]` для выбора и нет требуемых кредитов использования ни на одном плане. Сеансы автоматически компактируются перед заполнением окна, примерно на 967K токенов по умолчанию; установите [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/ru/env-vars), чтобы выбрать другой порог.833Если вы установите `ANTHROPIC_BASE_URL` на [LLM-шлюз](/docs/ru/llm-gateway) или другой прокси, Claude Code даёт каждой распознанной модели то же контекстное окно, что и на Anthropic API. Fable 5.1, Fable 5, Sonnet 5 и новее, Haiku 5.5, а также Opus 4.7 и новее получают окно 1M без необходимости выбирать вариант `[1m]`, а модель, которая получает 1M только через свой вариант `[1m]`, например Opus 4.6, без него работает с 200K. Claude Code не может обнаружить более низкий предел, установленный шлюзом или сервером за ним. Если ваш шлюз отклоняет запросы свыше 200K токенов, установите [`CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000`](/docs/ru/env-vars) в окружении, из которого запускается Claude Code, чтобы сессии на всех моделях [сжимались на этой границе](#set-the-auto-compact-window).

829 834

830Claude Code дает Sonnet 5.5 и Sonnet 5 то же окно 1M позади [LLM gateway](/docs/ru/llm-gateway) или другого пользовательского `ANTHROPIC_BASE_URL`. Если ваш шлюз применяет более низкий предел, см. [окно контекста позади шлюза](#context-window-behind-a-gateway).835<h4 id="turn-off-1m-context">

836 Отключение контекста 1M

837</h4>

831 838

832Этот параметр бюджетирует окно на 200K вместо этого:839Чтобы сессии оставались в окне 200K, установите `CLAUDE_CODE_DISABLE_1M_CONTEXT=1` в оболочке или в [файле настроек](/docs/ru/env-vars#set-environment-variables). Claude Code удаляет варианты моделей `[1m]` из средства выбора модели. На моделях, которые по умолчанию работают с окном 1M, таких как модели Fable, Sonnet 5 и новее, а также Opus 4.7 и новее, он также рассматривает модель как имеющую контекстное окно 200K:

833 840

834* **`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`**: удерживает сеансы на каждой модели с собственным окном 1M на окне 200K; см. [Extended context](#extended-context) для того, как удержание применяется. Полезно для развертываний, которым нужно ограничить контекст.841* При включённом автосжатии сессии сжимаются на границе 200K с помощью [автосжатия](#set-the-auto-compact-window). Установка окна автосжатия выше 200K не снимает это ограничение, потому что Claude Code ограничивает это окно контекстным окном модели.

842* При отключённом автосжатии сессии останавливаются на границе 200K с [ошибкой превышения контекста](/docs/ru/errors#prompt-is-too-long) вместо сжатия.

835 843

836<h4 id="haiku-5-5-context-window-and-pricing">844<h4 id="haiku-5-5-context-window-and-pricing">

837 Контекстное окно и цены Haiku 5.5845 Контекстное окно и цены Haiku 5.5

844По умолчанию сессии автоматически сжимаются примерно на 967K токенов. Чтобы сжатие происходило раньше, [задайте для модели меньшее окно автосжатия](#set-the-auto-compact-window).852По умолчанию сессии автоматически сжимаются примерно на 967K токенов. Чтобы сжатие происходило раньше, [задайте для модели меньшее окно автосжатия](#set-the-auto-compact-window).

845 853

846<h2 id="context-window-and-auto-compaction">854<h2 id="context-window-and-auto-compaction">

847 Контекстное окно и auto-compact855 Контекстное окно и автосжатие

848</h2>856</h2>

849 857

850Окно auto-compact определяет, насколько полным может быть контекстное окно перед тем, как Claude Code выполнит компактирование разговора. Информацию о том, что сохраняется и удаляется при каждом механизме компактирования, см. в разделе [What survives compaction](/docs/ru/context-window#what-survives-compaction).858Окно автосжатия определяет, насколько может заполниться контекстное окно, прежде чем Claude Code выполнит сжатие контекста диалога. Информацию о том, что сохраняется и что удаляется при каждом механизме, см. в разделе [Что сохраняется после сжатия контекста](/docs/ru/context-window#what-survives-compaction).

851 859

852<h3 id="set-the-auto-compact-window">860<h3 id="set-the-auto-compact-window">

853 Установка окна auto-compact861 Установка окна автосжатия

854</h3>862</h3>

855 863

856Задать окно автосжатия можно в следующих местах:864Задать окно автосжатия можно в следующих местах:

857 865

858* **Для текущей модели, в этой сессии и последующих**: выполните `/autocompact` со значением, например `/autocompact 500k`. Claude Code сохраняет его в ваших пользовательских настройках для текущей модели в [`modelSettings`](/docs/ru/settings-reference#modelsettings) и применяет к текущей сессии. Если [область действия настроек](/docs/ru/settings#settings-precedence) с более высоким приоритетом, например управляемые настройки, задаёт собственное окно для этой модели или для всех моделей, команда сохраняет ваше значение, но сессия использует окно этой области действия, и команда сообщает об этом. Выполните `/autocompact auto`, чтобы вернуться к окну, оптимизированному для вашей модели. До версии v2.1.288 команда сохраняла одно окно для всех моделей в виде ключа верхнего уровня `autoCompactWindow`.866* **Для текущей модели, в этой сессии и последующих**: выполните `/autocompact` со значением, например `/autocompact 500k`. Claude Code сохраняет его в ваших пользовательских настройках для текущей модели в [`modelSettings`](/docs/ru/settings-reference#modelsettings) и применяет к текущей сессии. Если [область действия настроек](/docs/ru/settings#settings-precedence) с более высоким приоритетом, например управляемые настройки, задаёт собственное окно для этой модели или для всех моделей, команда сохраняет ваше значение, но сессия использует окно этой области действия, и команда сообщает об этом. Выполните `/autocompact auto`, чтобы вернуться к окну, оптимизированному для вашей модели. До версии v2.1.288 команда сохраняла одно окно для всех моделей в виде ключа верхнего уровня `autoCompactWindow`.

859* **Для всех моделей**: задайте [`autoCompactWindow`](/docs/ru/settings-reference#autocompactwindow) в файле настроек, например `"autoCompactWindow": 200000` в `~/.claude/settings.json`. Окно, сохранённое для модели с помощью `/autocompact`, имеет приоритет над этим ключом в том же файле для этой модели.867* **Для всех моделей**: задайте [`autoCompactWindow`](/docs/ru/settings-reference#autocompactwindow) в файле настроек, например `"autoCompactWindow": 200000` в `~/.claude/settings.json`. Окно, сохранённое для модели с помощью `/autocompact`, имеет приоритет над этим ключом в том же файле для этой модели.

860* **Для одного запуска**: передайте [`--autocompact`](/docs/ru/cli-reference#cli-flags) при запуске Claude Code. Флаг переопределяет ваш сохранённый параметр для этого запуска без его изменения, и `claude --autocompact auto` запускает сеанс с оптимизированным окном, даже если ваш сохранённый параметр имеет значение. В отличие от `/autocompact`, флаг не переопределяется областью параметров с более высоким приоритетом, такой как управляемые параметры.868* **Для одного запуска**: передайте [`--autocompact`](/docs/ru/cli-reference#cli-flags) при запуске Claude Code. Флаг переопределяет вашу сохранённую настройку для этого запуска, не изменяя её, а `claude --autocompact auto` запускает сессию с оптимизированным окном, даже если в вашей сохранённой настройке задано значение. В отличие от `/autocompact`, флаг не вытесняется областью действия настроек с более высоким приоритетом, например управляемыми настройками.

861* **В скриптах и облачных окружениях**: установите [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/ru/env-vars). Пока она установлена, она имеет приоритет над командой, флагом и параметром, и `/autocompact` сообщает об переопределении вместо изменения окна.869* **В скриптах и облачных окружениях**: задайте [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/ru/env-vars). Пока эта переменная задана, она имеет приоритет над командой, флагом и настройкой, а `/autocompact` сообщает о переопределении вместо изменения окна.

862 870

863Команда и флаг принимают размер окна от 100K до 1M токенов в любой из этих форм:871Команда и флаг принимают размер окна от 100K до 1M токенов в любой из следующих форм:

864 872

865* Простой подсчёт токенов, например `200000`873* Простое количество токенов, например `200000`

866* Суффикс `k` или `M`, например `500k` или `1M`874* Суффикс `k` или `M`, например `500k` или `1M`

867* Простое число от 100 до 1000, означающее тысячи, поэтому `200` устанавливает 200 000875* Простое число от 100 до 1000, означающее тысячи, поэтому `200` задаёт 200 000

868 876

869Переменная окружения принимает только простой подсчёт токенов. Claude Code ограничивает окно контекстным окном модели.877Переменная окружения принимает только простое количество токенов. Claude Code ограничивает окно размером контекстного окна модели.

870 878

871<h3 id="default-auto-compact-thresholds">879<h3 id="default-auto-compact-thresholds">

872 Пороги auto-compact по умолчанию880 Пороги автосжатия по умолчанию

873</h3>881</h3>

874 882

875Если вы не установите окно auto-compact, Claude Code выполняет компактирование, когда разговор достигает предела контекста модели, за исключением этих сеансов:883Если вы не задали окно автосжатия, Claude Code выполняет сжатие контекста, когда диалог достигает предела контекста модели, за исключением следующих сессий:

876 884

877* [Cloud sessions](/docs/ru/claude-code-on-the-web) выполняют компактирование по мере приближения разговора к пределу модели885* [Облачные сессии](/docs/ru/claude-code-on-the-web) выполняют сжатие контекста по мере приближения диалога к пределу модели

878* Sonnet 4.6 и Opus 4.6 без [extended context](#extended-context) выполняют компактирование на границе 200K, как и Opus 4.8 и более поздние версии при работе с контекстным окном 200K, например на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry886* Sonnet 4.6 и Opus 4.6 без [расширенного контекста](#extended-context) выполняют сжатие контекста на границе 200K

879* Когда вы установите [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/ru/env-vars), модели с собственным окном 1M, такие как Sonnet 5 и модели Fable, выполняют компактирование на границе 200K887* Когда вы задаёте [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/ru/env-vars), модели с собственным окном 1M, такие как Sonnet 5 и модели Fable, выполняют сжатие контекста на границе 200K

880* Модели, работающие с собственным окном 1M, выполняют сжатие до заполнения окна, по умолчанию примерно на 967K токенов. В Anthropic API к ним относятся Sonnet 5, Haiku 5.5, модели Fable, а также Opus 4.7 и более поздние версии. Для Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry см. раздел [Закрепление моделей для сторонних развёртываний](#pin-models-for-third-party-deployments), чтобы узнать, какие модели работают с этим окном. При использовании пользовательского `ANTHROPIC_BASE_URL` см. раздел [контекстное окно за шлюзом](#context-window-behind-a-gateway)888* Модели, работающие с собственным окном 1M, выполняют сжатие контекста до заполнения окна, по умолчанию примерно на 967K токенов. К ним относятся модели Fable, Sonnet 5 и более поздние версии, Haiku 5.5, а также Opus 4.7 и более поздние версии. При использовании пользовательского `ANTHROPIC_BASE_URL` см. раздел [контекстное окно за шлюзом](#context-window-behind-a-gateway)

881* Сеансы на ID модели, которую Claude Code не распознаёт, такие как псевдоним [LLM gateway](/docs/ru/llm-gateway), выполняют компактирование при контекстном окне, которое Claude Code предполагает для ID; см. [Correct the window for a gateway or custom model ID](#correct-the-window-for-a-gateway-or-custom-model-id)889* Сессии с ID модели, который Claude Code не распознаёт, например псевдонимом [LLM-шлюза](/docs/ru/llm-gateway), выполняют сжатие контекста при контекстном окне, которое Claude Code предполагает для этого ID; см. [Исправление окна для шлюза или пользовательского ID модели](#correct-the-window-for-a-gateway-or-custom-model-id)

882 890

883<h3 id="correct-the-window-for-a-gateway-or-custom-model-id">891<h3 id="correct-the-window-for-a-gateway-or-custom-model-id">

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

885</h3>893</h3>

886 894

887На [LLM gateway](/docs/ru/llm-gateway) или другом пользовательском развёртывании Claude Code может предполагать контекстное окно для ID модели, которое отличается от реального окна модели, независимо от того, разрешает ли оно ID в модель Claude. Установите [`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](/docs/ru/env-vars) на окно, которое Claude Code должен предполагать вместо этого.895При использовании [LLM-шлюза](/docs/ru/llm-gateway) или другого пользовательского развёртывания Claude Code может предполагать для ID модели контекстное окно, которое отличается от реального окна модели, независимо от того, сопоставляет ли он ID с моделью Claude. Задайте в [`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](/docs/ru/env-vars) окно, которое Claude Code должен предполагать вместо этого.

888 896

889Применение переменной зависит от ID. Claude Code рассматривает ID как поставщика или пользовательское написание, когда оно не начинается с `claude-`, в любом регистре, или когда оно содержит суффикс, который Claude Code удаляет при чтении ID, например дату `@YYYYMMDD`, используемую на Google Cloud's Agent Platform. До версии 2.1.259 Claude Code не учитывал удалённый суффикс, поэтому нераспознанный ID `claude-` с суффиксом даты рассматривался как простое имя `claude-`.897Применение переменной зависит от ID. Claude Code рассматривает ID как написание поставщика или пользовательское написание, если он не начинается с `claude-` (в любом регистре) или если он содержит суффикс, который Claude Code удаляет при чтении ID, например дату `@YYYYMMDD`, используемую в Google Cloud's Agent Platform. До версии v2.1.259 Claude Code не учитывал удалённый суффикс, поэтому нераспознанный ID `claude-` с суффиксом даты рассматривался как простое имя `claude-`.

890 898

891Нераспознанный поставщик или пользовательское написание, то же написание с `[1m]` и все остальные ID — это три отдельных случая:899Нераспознанное написание поставщика или пользовательское написание, то же написание с `[1m]` и все остальные ID — это три отдельных случая:

892 900

893* Если Claude Code не может разрешить поставщика или пользовательское написание в модель, которую он распознаёт, и ID не содержит `[1m]`, переменная применяется напрямую и упреждающее компактирование продолжается при объявленном окне.901* Если Claude Code не может сопоставить написание поставщика или пользовательское написание с распознаваемой моделью и ID не содержит `[1m]`, переменная применяется напрямую, и упреждающее сжатие контекста продолжается при объявленном окне.

894* Если Claude Code не может разрешить поставщика или пользовательское написание в модель, которую он распознаёт, и ID содержит `[1m]`, в любом регистре, Claude Code предполагает окно 1M для него и переменная не применяется самостоятельно. Чтобы исправить окно, сохраняя упреждающее компактирование, также установите [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/ru/env-vars). С установленной переменной Claude Code размещает ID как то же написание без `[1m]`, поэтому `CLAUDE_CODE_MAX_CONTEXT_TOKENS` применяется, когда он применялся бы к этому неразмеченному написанию.902* Если Claude Code не может сопоставить написание поставщика или пользовательское написание с распознаваемой моделью и ID содержит `[1m]` (в любом регистре), Claude Code предполагает для него окно 1M, и переменная сама по себе не применяется. Чтобы исправить окно, сохранив упреждающее сжатие контекста, также задайте [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/ru/env-vars). Когда эта переменная задана, Claude Code определяет размер для ID так же, как для того же написания без `[1m]`, поэтому `CLAUDE_CODE_MAX_CONTEXT_TOKENS` применяется в тех случаях, когда она применялась бы к этому написанию без метки.

895 903

896 С объявленным окном выше 200K Claude Code затем показывает [startup warning](/docs/ru/errors#the-200k-limit-isnt-enforced), что предел 200K не применяется. Предупреждение ожидается в этой конфигурации.904 Если объявленное окно превышает 200K, Claude Code затем показывает [предупреждение при запуске](/docs/ru/errors#the-200k-limit-isnt-enforced) о том, что предел 200K не применяется. В этой конфигурации такое предупреждение ожидаемо.

897* Если ID разрешается в модель, которую Claude Code распознаёт, или ID является простым именем `claude-` без суффикса для Claude Code, чтобы удалить его, в любом регистре, переменная вступает в силу только когда вы также установите [`DISABLE_COMPACT`](/docs/ru/env-vars), что отключает все компактирование.905* Если ID сопоставляется с моделью, которую Claude Code распознаёт, или ID является простым именем `claude-` без суффикса, который Claude Code мог бы удалить (в любом регистре), переменная вступает в силу, только если вы также задаёте [`DISABLE_COMPACT`](/docs/ru/env-vars), что отключает любое сжатие контекста.

898 906

899 Например, ID, который содержит имя модели Claude, которое Claude Code знает, такое как `anthropic/claude-opus-4-8`, `us.anthropic.claude-…-v1:0` или датированный `claude-sonnet-4-5@20250929`, разрешается в эту модель. Это включает ID, которые также содержат `[1m]`: Claude Code разрешает `claude-opus-4-8[1m]` в Opus 4.8 даже с установленным `CLAUDE_CODE_DISABLE_1M_CONTEXT`.907 Например, ID, содержащий известное Claude Code имя модели Claude, такой как `anthropic/claude-opus-4-8`, `us.anthropic.claude-…-v1:0` или датированный `claude-sonnet-4-5@20250929`, сопоставляется с этой моделью. Это относится и к ID, которые также содержат `[1m]`: Claude Code сопоставляет `claude-opus-4-8[1m]` с Opus 4.8 даже при заданной `CLAUDE_CODE_DISABLE_1M_CONTEXT`.

900 908

901Для ID модели, которую Claude Code не распознаёт, установите [`CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1`](/docs/ru/env-vars), чтобы Claude Code выполнял компактирование только после того, как API отклонит разговор с [too-long error Claude Code recognizes](/docs/ru/errors#prompt-is-too-long). Claude Code не запускает это восстановление, когда шлюз [rewrites the error](/docs/ru/llm-gateway-connect#troubleshoot-gateway-errors) на формулировку, которую Claude Code не распознаёт.909Для ID модели, который Claude Code не распознаёт, задайте [`CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1`](/docs/ru/env-vars), чтобы Claude Code выполнял сжатие контекста только после того, как API отклонит диалог с [ошибкой превышения длины, которую распознаёт Claude Code](/docs/ru/errors#prompt-is-too-long). Claude Code не выполняет это восстановление, если шлюз [переписывает текст ошибки](/docs/ru/llm-gateway-connect#troubleshoot-gateway-errors) в формулировку, которую Claude Code не распознаёт.

902 910

903<h2 id="checking-your-current-model">911<h2 id="checking-your-current-model">

904 Проверка вашей текущей модели912 Проверка вашей текущей модели

942 Переменные окружения950 Переменные окружения

943</h2>951</h2>

944 952

945Используйте следующие переменные окружения для управления именами моделей, на которые отображаются псевдонимы. Каждое значение должно быть полным именем модели или эквивалентным идентификатором для вашего поставщика API. Чтобы выбрать модель, на которой начинаются ваши сеансы, установите [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions), которую эта таблица опускает.953Используйте следующие переменные окружения для управления именами моделей, на которые отображаются псевдонимы. Каждое значение должно быть полным именем модели или эквивалентным идентификатором для вашего поставщика API. Чтобы выбрать модель, на которой начинаются ваши сессии, установите [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions), которую эта таблица опускает.

946 954

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

948| - | - |956| - | - |

949| `ANTHROPIC_DEFAULT_FABLE_MODEL` | Модель для использования с `fable` и идентификатор модели, который Claude Code распознает как модель Fable для [автоматического переключения модели](#automatic-model-fallback) у сторонних поставщиков |957| `ANTHROPIC_DEFAULT_FABLE_MODEL` | Модель для использования с `fable` и идентификатор модели, который Claude Code распознаёт как модель Fable для [автоматического переключения на резервную модель](#automatic-model-fallback) у сторонних поставщиков |

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

953| `CLAUDE_CODE_SUBAGENT_MODEL` | Модель по умолчанию для [подагентов](/docs/ru/sub-agents#choose-a-model), товарищей по [команде агентов](/docs/ru/agent-teams#specify-teammates-and-models) и агентов [workflow](/docs/ru/workflows), которым не назначена модель другим способом. Принимает псевдоним, такой как `haiku`, или полное имя модели. Модель для каждого вызова или поле `model` определения, включая `inherit`, имеет приоритет. Чтобы изменить это, установите [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/ru/sub-agents#run-every-subagent-on-one-model) |961| `CLAUDE_CODE_SUBAGENT_MODEL` | Модель по умолчанию для [субагентов](/docs/ru/sub-agents#choose-a-model), участников [команды агентов](/docs/ru/agent-teams#specify-teammates-and-models) и агентов [workflow](/docs/ru/workflows), которым не назначена модель другим способом. Принимает псевдоним, такой как `haiku`, или полное имя модели. Модель для каждого вызова или поле `model` определения, включая `inherit`, имеет приоритет. Чтобы изменить это, установите [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/ru/sub-agents#run-every-subagent-on-one-model) |

954 962

955У сторонних поставщиков [Настройка отображения и возможностей закреплённой модели](#customize-pinned-model-display-and-capabilities) описывает, что показывает строка закреплённой модели в средстве выбора `/model`.963У сторонних поставщиков [Настройка отображения и возможностей закреплённой модели](#customize-pinned-model-display-and-capabilities) описывает, что показывает строка закреплённой модели в средстве выбора `/model`.

956 964

963 971

964При развёртывании Claude Code через [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai), [Microsoft Foundry](/docs/ru/microsoft-foundry) или [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) закрепите версии моделей перед развёртыванием для пользователей.972При развёртывании Claude Code через [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai), [Microsoft Foundry](/docs/ru/microsoft-foundry) или [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) закрепите версии моделей перед развёртыванием для пользователей.

965 973

966Без закрепления Claude Code использует псевдонимы моделей, такие как `fable`, `opus`, `sonnet` и `haiku`, которые разрешаются в встроенный идентификатор модели по умолчанию для каждого поставщика. Этот идентификатор по умолчанию может отставать от последнего выпуска Anthropic, и модель, на которую он указывает, может быть ещё не включена в учётной записи пользователя. Когда идентификатор по умолчанию недоступен, пользователи Amazon Bedrock и Google Cloud's Agent Platform видят уведомление, и сеанс переключается на более раннюю версию модели по умолчанию или на модель Sonnet по умолчанию, когда идентификатор по умолчанию является моделью Opus и нет доступной версии Opus. Пользователи Microsoft Foundry видят ошибки вместо этого, потому что Microsoft Foundry не имеет эквивалентной проверки при запуске.974Без закрепления Claude Code использует псевдонимы моделей, такие как `fable`, `opus`, `sonnet` и `haiku`, которые разрешаются во встроенный идентификатор модели по умолчанию для каждого поставщика. Этот идентификатор по умолчанию может отставать от последнего выпуска Anthropic, и модель, на которую он указывает, может быть ещё не включена в учётной записи пользователя. Когда идентификатор по умолчанию недоступен, пользователи Amazon Bedrock и Google Cloud's Agent Platform видят уведомление, и сессия переключается на более раннюю версию модели по умолчанию или на модель Sonnet по умолчанию, когда идентификатор по умолчанию является моделью Opus и нет доступной версии Opus. Пользователи Microsoft Foundry вместо этого видят ошибки, потому что Microsoft Foundry не имеет эквивалентной проверки при запуске.

967 975

968На Amazon Bedrock и Google Cloud's Agent Platform пользователь, который запускает сеанс на конкретной версии Sonnet или Opus, например с помощью `--model`, `ANTHROPIC_MODEL` или параметра `model`, закрепляет эту версию как идентификатор по умолчанию сеанса для соответствующего псевдонима: проверка при запуске пропускает встроенный идентификатор по умолчанию, который она заменяет, и не показывает уведомление о переключении. До версии 2.1.211 проверка выполнялась и могла показать уведомление даже когда модель сеанса была явно настроена.976На Amazon Bedrock и Google Cloud's Agent Platform пользователь, который запускает сессию на конкретной версии Sonnet или Opus, например с помощью `--model`, `ANTHROPIC_MODEL` или настройки `model`, закрепляет эту версию как идентификатор по умолчанию сессии для соответствующего псевдонима: проверка при запуске пропускает встроенный идентификатор по умолчанию, который она заменяет, и не показывает уведомление о переключении. До версии 2.1.211 проверка выполнялась и могла показать уведомление, даже когда модель сессии была явно настроена.

969 977

970<Warning>978<Warning>

971 Установите переменные окружения модели на конкретные идентификаторы версий как часть вашей начальной настройки. Закрепление позволяет вам контролировать, когда ваши пользователи переходят на новую модель.979 Установите переменные окружения модели на конкретные идентификаторы версий как часть вашей начальной настройки. Закрепление позволяет вам контролировать, когда ваши пользователи переходят на новую модель.

981 989

982Применяйте тот же шаблон для `ANTHROPIC_DEFAULT_FABLE_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL` и `ANTHROPIC_DEFAULT_HAIKU_MODEL`. Для текущих и устаревших идентификаторов моделей у всех поставщиков см. [Обзор моделей](https://platform.claude.com/docs/en/about-claude/models/overview). Чтобы обновить пользователей до новой версии модели, обновите эти переменные окружения и переразверните.990Применяйте тот же шаблон для `ANTHROPIC_DEFAULT_FABLE_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL` и `ANTHROPIC_DEFAULT_HAIKU_MODEL`. Для текущих и устаревших идентификаторов моделей у всех поставщиков см. [Обзор моделей](https://platform.claude.com/docs/en/about-claude/models/overview). Чтобы обновить пользователей до новой версии модели, обновите эти переменные окружения и переразверните.

983 991

984Чтобы включить [расширенный контекст](#extended-context) для закреплённой модели, добавьте `[1m]` к идентификатору модели в `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL` или `ANTHROPIC_DEFAULT_FABLE_MODEL`:992Закреплённая модель с нативным окном 1M, такая как Opus 4.8 или Sonnet 5, работает с [контекстным окном 1M](#extended-context) без какого-либо суффикса, когда Claude Code может сопоставить закреплённый идентификатор с этой моделью. Идентификатор совпадает, когда он содержит идентификатор модели в Anthropic API, как `us.anthropic.claude-opus-4-8` содержит `claude-opus-4-8`, или когда запись [`modelOverrides`](#override-model-ids-per-version) отображает модель на него. Для закреплённого идентификатора, который Claude Code не может сопоставить с моделью, сессии по умолчанию работают с окном 200K, если идентификатор не содержит суффикс `[1m]`.

993

994Для модели, которая достигает 1M через свой вариант `[1m]`, такой как Opus 4.6 или Sonnet 4.6, включите расширенный контекст, добавив `[1m]` к идентификатору модели в `ANTHROPIC_DEFAULT_OPUS_MODEL` или `ANTHROPIC_DEFAULT_SONNET_MODEL`:

985 995

986```bash theme={null}996```bash theme={null}

987export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8[1m]'997export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-6[1m]'

988```998```

989 999

990С суффиксом `[1m]` окно контекста 1M применяется ко всему использованию закреплённого псевдонима, включая фазу Opus в режиме плана [`opusplan`](#opusplan-model-setting) и [подагентов](/docs/ru/sub-agents#choose-a-model), чьё frontmatter `model` называет псевдоним.1000С суффиксом `[1m]` контекстное окно 1M применяется ко всему использованию закреплённого псевдонима, включая фазу Opus в режиме планирования [`opusplan`](#opusplan-model-setting) и [субагентов](/docs/ru/sub-agents#choose-a-model), чьё frontmatter `model` называет псевдоним.

991 1001

992* Claude Code удаляет суффикс перед отправкой идентификатора модели вашему поставщику.1002* Claude Code удаляет суффикс перед отправкой идентификатора модели вашему поставщику.

993* Добавляйте `[1m]` только когда базовая модель [поддерживает контекст 1M](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model).1003* Добавляйте `[1m]` только когда базовая модель [поддерживает контекст 1M](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model).

994* Суффикс читается для каждой переменной, а не для каждой модели. На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry идентификатор модели без `[1m]` в одной переменной использует контекст 200K даже если другая переменная устанавливает ту же модель с суффиксом. Sonnet 5 всегда работает с окном 1M на этих поставщиках и никогда не требует суффикса.1004* Суффикс читается для каждой переменной, а не для каждой модели. На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry идентификатор Opus 4.6 или Sonnet 4.6 без `[1m]` в одной переменной использует контекст 200K, даже если другая переменная устанавливает ту же модель с суффиксом.

995 1005

996Когда вы устанавливаете переменную `ANTHROPIC_DEFAULT_*_MODEL`, средство выбора `/model` показывает одну строку для этой модели вместо встроенных строк семейства, включая любые строки контекста 1M. Чтобы достичь окна 1M без добавления суффикса к этой переменной, ваши пользователи запускают `/model opus[1m]`, и Claude Code применяет суффикс к модели, которую называет переменная. `/model sonnet[1m]` работает так же.1006Когда вы устанавливаете переменную `ANTHROPIC_DEFAULT_*_MODEL`, средство выбора `/model` показывает одну строку для этой модели вместо встроенных строк семейства, включая любые строки контекста 1M. Чтобы достичь окна 1M без добавления суффикса к этой переменной, ваши пользователи запускают `/model opus[1m]`, и Claude Code применяет суффикс к модели, которую называет переменная. `/model sonnet[1m]` работает так же.

997 1007

998<Note>1008<Note>

999 Список разрешений `availableModels`, доставленный через [MDM или управляемый файл параметров](/docs/ru/managed-settings#delivery-mechanisms), по-прежнему применяется при использовании сторонних поставщиков; [параметры, управляемые сервером, не доставляются туда](/docs/ru/server-managed-settings#platform-availability).1009 Список разрешённых моделей `availableModels`, доставленный через [MDM или файл управляемых настроек](/docs/ru/managed-settings#delivery-mechanisms), по-прежнему применяется при использовании сторонних поставщиков; [настройки, управляемые сервером, туда не доставляются](/docs/ru/server-managed-settings#platform-availability).

1000 1010

1001 Фильтрация соответствует псевдониму модели, такому как `opus`, префиксу версии, такому как `claude-opus-4-8`, или полному идентификатору модели в форме поставщика. Префиксы, специфичные для поставщика, такие как `us.anthropic.`, не удаляются, поэтому чтобы разрешить конкретную модель, укажите её полный идентификатор в форме поставщика или отобразите её через [`modelOverrides`](#override-model-ids-per-version). Для закреплённой модели этот идентификатор является значением, которое вы установили в её переменной `ANTHROPIC_DEFAULT_*_MODEL`. Любой суффикс `[1m]` удаляется из записи списка разрешений и запрошенной модели перед сопоставлением.1011 Фильтрация соответствует псевдониму модели, такому как `opus`, префиксу версии, такому как `claude-opus-4-8`, или полному идентификатору модели в форме поставщика. Префиксы, специфичные для поставщика, такие как `us.anthropic.`, не удаляются, поэтому чтобы разрешить конкретную модель, укажите её полный идентификатор в форме поставщика или отобразите её через [`modelOverrides`](#override-model-ids-per-version). Для закреплённой модели этот идентификатор является значением, которое вы установили в её переменной `ANTHROPIC_DEFAULT_*_MODEL`. Любой суффикс `[1m]` удаляется из записи списка разрешённых моделей и запрошенной модели перед сопоставлением.

1002</Note>1012</Note>

1003 1013

1004<h3 id="customize-pinned-model-display-and-capabilities">1014<h3 id="customize-pinned-model-display-and-capabilities">

1007 1017

1008Когда вы закрепляете модель у стороннего поставщика, её строка в средстве выбора `/model` показывает имя модели по умолчанию, если Claude Code распознаёт закреплённый идентификатор, и необработанный идентификатор в противном случае:1018Когда вы закрепляете модель у стороннего поставщика, её строка в средстве выбора `/model` показывает имя модели по умолчанию, если Claude Code распознаёт закреплённый идентификатор, и необработанный идентификатор в противном случае:

1009 1019

1010* **Распознана**: точный идентификатор модели, которую Claude Code знает, такой как её идентификатор Anthropic API или форма вашего поставщика или шлюза, с суффиксом `[1m]` или без него. Закрепите `us.anthropic.claude-sonnet-4-5-20250929-v1:0` и строка будет читаться как `Sonnet 4.5`.1020* **Распознана**: точный идентификатор модели, которую Claude Code знает, такой как её идентификатор Anthropic API или форма вашего поставщика или шлюза, с суффиксом `[1m]` или без него. Закрепите `us.anthropic.claude-sonnet-4-5-20250929-v1:0`, и строка будет читаться как `Sonnet 4.5`.

1011* **Не распознана**: любой другой идентификатор, такой как ARN профиля вывода приложения или версия модели, которую Claude Code не знает, если только запись [`modelOverrides`](#override-model-ids-per-version) не отображает модель на эту точную строку. На Microsoft Foundry имена развёртываний определяются пользователем, поэтому Claude Code никогда не распознаёт закреплённый идентификатор там, отображённый или нет, и строка показывает имя развёртывания по умолчанию.1021* **Не распознана**: любой другой идентификатор, такой как ARN профиля вывода приложения или версия модели, которую Claude Code не знает, если только запись [`modelOverrides`](#override-model-ids-per-version) не отображает модель на эту точную строку. На Microsoft Foundry имена развёртываний определяются пользователем, поэтому Claude Code никогда не распознаёт закреплённый идентификатор там, отображённый или нет, и строка показывает имя развёртывания по умолчанию.

1012 1022

1013Когда строка показывает имя модели, её описание по умолчанию включает закреплённый идентификатор, чтобы вы всё ещё могли видеть, какой идентификатор закреплён.1023Когда строка показывает имя модели, её описание по умолчанию включает закреплённый идентификатор, чтобы вы всё ещё могли видеть, какой идентификатор закреплён.

1014 1024

1015Claude Code также может не распознать, какие функции поддерживает закреплённая модель. Вы можете установить имя отображения и описание самостоятельно и объявить возможности с помощью переменных окружения-спутников для каждой закреплённой модели.1025Claude Code также может не распознать, какие функции поддерживает закреплённая модель. Вы можете установить имя отображения и описание самостоятельно и объявить возможности с помощью переменных окружения-спутников для каждой закреплённой модели.

1016 1026

1017Эти переменные вступают в силу у сторонних поставщиков, таких как Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry. Переменные `_NAME` и `_DESCRIPTION` также вступают в силу, когда `ANTHROPIC_BASE_URL` указывает на [LLM gateway](/docs/ru/llm-gateway). Они не имеют эффекта при прямом подключении к `api.anthropic.com`.1027Эти переменные вступают в силу у сторонних поставщиков, таких как Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry. Переменные `_NAME` и `_DESCRIPTION` также вступают в силу, когда `ANTHROPIC_BASE_URL` указывает на [LLM-шлюз](/docs/ru/llm-gateway). Они не имеют эффекта при прямом подключении к `api.anthropic.com`.

1018 1028

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

1020| - | - |1030| - | - |

1037 1047

1038Когда `_SUPPORTED_CAPABILITIES` установлена, Claude Code включает перечисленные возможности и отключает неперечисленные для соответствующей закреплённой модели. Когда переменная не установлена, Claude Code возвращается к встроенному обнаружению на основе идентификатора модели.1048Когда `_SUPPORTED_CAPABILITIES` установлена, Claude Code включает перечисленные возможности и отключает неперечисленные для соответствующей закреплённой модели. Когда переменная не установлена, Claude Code использует как резервный вариант встроенное обнаружение на основе идентификатора модели.

1039 1049

1040Этот пример закрепляет Opus на пользовательский ARN модели Amazon Bedrock, устанавливает понятное имя и объявляет его возможности:1050Этот пример закрепляет Opus на пользовательский ARN модели Amazon Bedrock, устанавливает понятное имя и объявляет его возможности:

1041 1051

1050 Переопределение идентификаторов моделей для каждой версии1060 Переопределение идентификаторов моделей для каждой версии

1051</h3>1061</h3>

1052 1062

1053На платформах, которые встраивают Claude Code и устанавливают [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ru/env-vars), конфигурация модели хоста имеет приоритет над управляемыми параметрами модели, в то время как управляемый список разрешений `availableModels` остаётся в силе, если только хост не предоставляет свой собственный; [Исключения из приоритета управляемых параметров](/docs/ru/settings#exceptions-to-managed-settings-precedence) говорит, какие ключи и переменные переопределяет хост.1063На платформах, которые встраивают Claude Code и устанавливают [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ru/env-vars), конфигурация модели хоста имеет приоритет над управляемыми настройками модели, в то время как управляемый список разрешённых моделей `availableModels` остаётся в силе, если только хост не предоставляет свой собственный; [Исключения из приоритета управляемых настроек](/docs/ru/settings#exceptions-to-managed-settings-precedence) указывает, какие ключи и переменные переопределяет хост.

1054 1064

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

1056 1066

1057`modelOverrides` отображает отдельные идентификаторы моделей Anthropic на строки, специфичные для поставщика, которые Claude Code отправляет API вашего поставщика. Когда пользователь выбирает отображённую модель в средстве выбора `/model`, Claude Code использует ваше настроенное значение вместо встроенного значения по умолчанию.1067`modelOverrides` отображает отдельные идентификаторы моделей Anthropic на строки, специфичные для поставщика, которые Claude Code отправляет API вашего поставщика. Когда пользователь выбирает отображённую модель в средстве выбора `/model`, Claude Code использует ваше настроенное значение вместо встроенного значения по умолчанию.

1058 1068

1059Это позволяет администраторам предприятия маршрутизировать каждую версию модели на конкретный ARN профиля вывода приложения Amazon Bedrock, имя версии Google Cloud's Agent Platform или имя развёртывания Microsoft Foundry для управления, распределения затрат или региональной маршрутизации.1069Это позволяет администраторам предприятия маршрутизировать каждую версию модели на конкретный ARN профиля вывода приложения Amazon Bedrock, имя версии Google Cloud's Agent Platform или имя развёртывания Microsoft Foundry для управления, распределения затрат или региональной маршрутизации.

1060 1070

1061Установите `modelOverrides` в вашем [файле параметров](/docs/ru/settings#where-settings-live):1071Установите `modelOverrides` в вашем [файле настроек](/docs/ru/settings#where-settings-live):

1062 1072

1063```json theme={null}1073```json theme={null}

1064{1074{

1072 1082

1073Ключи должны быть идентификаторами моделей Anthropic, как указано в [Обзоре моделей](https://platform.claude.com/docs/en/about-claude/models/overview). Для датированных идентификаторов моделей включите суффикс даты точно так, как он там появляется. Неизвестные ключи игнорируются.1083Ключи должны быть идентификаторами моделей Anthropic, как указано в [Обзоре моделей](https://platform.claude.com/docs/en/about-claude/models/overview). Для датированных идентификаторов моделей включите суффикс даты точно так, как он там появляется. Неизвестные ключи игнорируются.

1074 1084

1075Чтобы остановить [диагностическую строку](/docs/ru/errors#unrecognized-model-id-on-a-request) `[claude-code:unrecognized_model]` для идентификатора, такого как псевдоним шлюза, добавьте запись с этим идентификатором в качестве его значения.1085Чтобы остановить [диагностическую строку](/docs/ru/errors#unrecognized-model-id-on-a-request) `[claude-code:unrecognized_model]` для идентификатора, такого как псевдоним шлюза, добавьте запись с этим идентификатором в качестве её значения.

1076 1086

1077Переопределения заменяют встроенные идентификаторы моделей, которые поддерживают каждую запись в средстве выбора `/model`. На Amazon Bedrock записи `modelOverrides` имеют приоритет над любыми профилями вывода, которые Claude Code автоматически обнаруживает при запуске. Claude Code передаёт значения, которые уже являются собственными для поставщика, такие как ARN профиля вывода приложения Amazon Bedrock или имена развёртываний Microsoft Foundry, поставщику как есть.1087Переопределения заменяют встроенные идентификаторы моделей, которые стоят за каждой записью в средстве выбора `/model`. На Amazon Bedrock записи `modelOverrides` имеют приоритет над любыми профилями вывода, которые Claude Code автоматически обнаруживает при запуске. Claude Code передаёт значения, которые уже являются собственными для поставщика, такие как ARN профиля вывода Amazon Bedrock или имена развёртываний Microsoft Foundry, поставщику как есть.

1078 1088

1079Переопределения также применяются, когда вы передаёте идентификатор модели Anthropic непосредственно через `--model`, переменную окружения `ANTHROPIC_MODEL` или переменную окружения `ANTHROPIC_DEFAULT_*_MODEL`. На Amazon Bedrock, Google Cloud's Agent Platform и [Mantle](/docs/ru/amazon-bedrock#use-the-mantle-endpoint), идентификатор модели Anthropic без записи `modelOverrides` разрешается на тот же идентификатор, специфичный для поставщика, что и строка средства выбора `/model` для этой версии, когда поставщик поддерживает эту версию. Mantle поддерживает подмножество версий. Для идентификатора модели Anthropic вне этого подмножества Claude Code отправляет необработанный идентификатор Mantle без отображения, если только запись `modelOverrides` не охватывает его. До версии 2.1.200 `--model` и значения переменных окружения достигали поставщика как есть без прохождения через карту переопределений.1089Переопределения также применяются, когда вы передаёте идентификатор модели Anthropic непосредственно через `--model`, переменную окружения `ANTHROPIC_MODEL` или переменную окружения `ANTHROPIC_DEFAULT_*_MODEL`. На Amazon Bedrock, Google Cloud's Agent Platform и [Mantle](/docs/ru/amazon-bedrock#use-the-mantle-endpoint) идентификатор модели Anthropic без записи `modelOverrides` разрешается в тот же идентификатор, специфичный для поставщика, что и строка средства выбора `/model` для этой версии, когда поставщик поддерживает эту версию. Mantle поддерживает подмножество версий. Для идентификатора модели Anthropic вне этого подмножества Claude Code отправляет необработанный идентификатор в Mantle без отображения, если только запись `modelOverrides` не охватывает его. До версии 2.1.200 `--model` и значения переменных окружения достигали поставщика как есть, без прохождения через карту переопределений.

1080 1090

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

1082 1092

1083Когда `availableModels` установлена в [управляемых параметрах](/docs/ru/managed-settings), только `modelOverrides` из управляемых параметров применяются к идентификатору модели Anthropic, переданному непосредственно через `--model` или переменные окружения выше. Claude Code игнорирует переопределения в параметрах пользователя или проекта для этих идентификаторов и никогда не разрешает идентификатор, который управляемый список исключает, через `modelOverrides` из любого источника параметров. Это ограничение источника управляемых параметров требует Claude Code версии 2.1.200 или позже. См. [Ограничение выбора модели](#restrict-model-selection) для того, как обрабатываются заблокированные идентификаторы.1093Когда `availableModels` установлена в [управляемых настройках](/docs/ru/managed-settings), к идентификатору модели Anthropic, переданному непосредственно через `--model` или переменные окружения выше, применяются только `modelOverrides` из управляемых настроек. Claude Code игнорирует переопределения в настройках пользователя или проекта для этих идентификаторов и никогда не разрешает идентификатор, который управляемый список исключает, через `modelOverrides` из любого источника настроек. Это ограничение источника управляемых настроек требует Claude Code версии 2.1.200 или более поздней. См. [Ограничение выбора модели](#restrict-model-selection), чтобы узнать, как обрабатываются заблокированные идентификаторы.

1084 1094

1085<h3 id="prompt-caching-configuration">1095<h3 id="prompt-caching-configuration">

1086 Конфигурация кэширования подсказок1096 Конфигурация кэширования промптов

1087</h3>1097</h3>

1088 1098

1089Claude Code автоматически использует [кэширование подсказок](/docs/ru/prompt-caching) для оптимизации производительности и снижения затрат. Вы можете отключить кэширование подсказок глобально или для конкретных уровней моделей:1099Claude Code автоматически использует [кэширование промптов](/docs/ru/prompt-caching) для оптимизации производительности и снижения затрат. Вы можете отключить кэширование промптов глобально или для конкретных уровней моделей:

1090 1100

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

1092| - | - |1102| - | - |

1093| `DISABLE_PROMPT_CACHING` | Установите на `1`, чтобы отключить кэширование подсказок для всех моделей. Имеет приоритет над параметрами для каждой модели |1103| `DISABLE_PROMPT_CACHING` | Установите на `1`, чтобы отключить кэширование промптов для всех моделей. Имеет приоритет над настройками для каждой модели |

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

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

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

1098 1108

1099Чтобы выбрать TTL кэша для основного разговора и для подагентов отдельно, см. [выберите TTL самостоятельно](/docs/ru/prompt-caching#choose-the-ttl-yourself). Для того, что вызывает промах кэша, см. [Как Claude Code использует кэширование подсказок](/docs/ru/prompt-caching).1109Чтобы выбрать TTL кэша для основного диалога и для субагентов отдельно, см. [выберите TTL самостоятельно](/docs/ru/prompt-caching#choose-the-ttl-yourself). О том, что вызывает промах кэша, см. [Как Claude Code использует кэширование промптов](/docs/ru/prompt-caching).

1100 1110

1101<h2 id="version-history">1111<h2 id="version-history">

1102 История версий1112 История версий

monitoring-usage.md +4 −4

Details

551* **Параметры, управляемые сервером**: добавьте их в блок `env` [параметров, управляемых сервером](/docs/ru/server-managed-settings) вашей организации. Claude Code получает эти параметры при запуске везде, где [применяются параметры, управляемые сервером](/docs/ru/model-config#surface-coverage), что включает машины ваших пользователей и облачные сеансы, кроме сеансов канала Claude Tag. Сеансы Claude Tag не получают ваши параметры, управляемые сервером, поэтому этот способ их не настраивает.551* **Параметры, управляемые сервером**: добавьте их в блок `env` [параметров, управляемых сервером](/docs/ru/server-managed-settings) вашей организации. Claude Code получает эти параметры при запуске везде, где [применяются параметры, управляемые сервером](/docs/ru/model-config#surface-coverage), что включает машины ваших пользователей и облачные сеансы, кроме сеансов канала Claude Tag. Сеансы Claude Tag не получают ваши параметры, управляемые сервером, поэтому этот способ их не настраивает.

552* **Переменные окружения**: добавьте их в [переменные окружения](/docs/ru/cloud-environments#set-environment-variables) облачного окружения, чтобы настроить только сеансы, работающие в этом окружении. Это способ, который достигает сеансов Claude Tag.552* **Переменные окружения**: добавьте их в [переменные окружения](/docs/ru/cloud-environments#set-environment-variables) облачного окружения, чтобы настроить только сеансы, работающие в этом окружении. Это способ, который достигает сеансов Claude Tag.

553 553

554Любой, кто использует окружение, может читать его переменные, поэтому не помещайте туда учётные данные, например токен сборщика в `OTEL_EXPORTER_OTLP_HEADERS`. [Сетевой секрет](/docs/ru/cloud-environments#add-api-credentials) в окружении тоже не поможет, потому что собственный экспорт телеметрии Claude Code — это один из [запросов, которые никогда не получают секрет](/docs/ru/cloud-environments#requests-that-never-get-the-credential). Если ваш сборщик требует учётные данные, вместо этого настройте весь экспорт через настройки, управляемые сервером, потому что когда вы задаёте учётные данные там, [Claude Code удаляет переменные эндпоинта, заданные вне управляемых настроек](#how-managed-settings-lock-the-otlp-destination).554Любой, кто использует окружение, может читать его переменные, поэтому не помещайте туда учётные данные, например токен сборщика в `OTEL_EXPORTER_OTLP_HEADERS`. [Сетевой секрет](/docs/ru/cloud-environments#add-network-secrets) в окружении тоже не поможет, потому что собственный экспорт телеметрии Claude Code — это один из [запросов, которые никогда не получают секрет](/docs/ru/cloud-environments#requests-that-never-get-the-credential). Если ваш сборщик требует учётные данные, вместо этого настройте весь экспорт через настройки, управляемые сервером, потому что когда вы задаёте учётные данные там, [Claude Code удаляет переменные эндпоинта, заданные вне управляемых настроек](#how-managed-settings-lock-the-otlp-destination).

555 555

556Помните об этих ограничениях при настройке телеметрии для облачных сеансов:556Помните об этих ограничениях при настройке телеметрии для облачных сеансов:

557 557

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

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

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

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

1318 1318

1319<h4 id="compaction-event">1319<h4 id="compaction-event">

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

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

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

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

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

1386 1386

1387<h4 id="retention-sweep-event">1387<h4 id="retention-sweep-event">

1388 Событие развёртки удержания1388 Событие развёртки удержания

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

1475 1475

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

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

1478 1478

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

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

network-config.md +1 −1

Details

209| :- | :- | :- | :- |209| :- | :- | :- | :- |

210| First-byte deadline | Заголовки ответа не поступают после отправки запроса Claude Code | Прямой API Anthropic и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), включая через HTTPS-прокси, но не когда `ANTHROPIC_BASE_URL` или `ANTHROPIC_AWS_BASE_URL` маршрутизируют их через [gateway](/docs/ru/gateways). Opt-in на Amazon Bedrock с `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`; не работает на Google Cloud's Agent Platform или Microsoft Foundry | 180 секунд на прямом API Anthropic, 300 секунд в других местах, плюс одна секунда на 32 КБ тела запроса |210| First-byte deadline | Заголовки ответа не поступают после отправки запроса Claude Code | Прямой API Anthropic и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), включая через HTTPS-прокси, но не когда `ANTHROPIC_BASE_URL` или `ANTHROPIC_AWS_BASE_URL` маршрутизируют их через [gateway](/docs/ru/gateways). Opt-in на Amazon Bedrock с `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`; не работает на Google Cloud's Agent Platform или Microsoft Foundry | 180 секунд на прямом API Anthropic, 300 секунд в других местах, плюс одна секунда на 32 КБ тела запроса |

211| Event-level watchdog | События ответа не анализируются. На соединениях, где работает byte-level watchdog, поступающие байты, включая keep-alive пинги, также сбрасывают этот watchdog, примерно на пять минут без анализируемого события | Каждый провайдер | 300 секунд |211| Event-level watchdog | События ответа не анализируются. На соединениях, где работает byte-level watchdog, поступающие байты, включая keep-alive пинги, также сбрасывают этот watchdog, примерно на пять минут без анализируемого события | Каждый провайдер | 300 секунд |

212| Byte-level watchdog | На проводе не поступают байты, включая SSE keep-alive пинги | Прямой API Anthropic, [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) и [gateway](/docs/ru/gateways) соединения, включая пользовательский `ANTHROPIC_BASE_URL`. Opt-in на Amazon Bedrock `vnd.amazon.eventstream` ответы с `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`; не работает на Google Cloud's Agent Platform или Microsoft Foundry | 180 секунд на прямом API Anthropic, 300 секунд в других местах |212| Byte-level watchdog | На проводе не поступают байты, включая SSE keep-alive пинги | Прямой API Anthropic, [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) и [шлюзовые](/docs/ru/gateways) соединения, включая пользовательский `ANTHROPIC_BASE_URL`. Opt-in на Amazon Bedrock `vnd.amazon.eventstream` ответы с `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`; не работает на Google Cloud's Agent Platform или Microsoft Foundry | 180 секунд на прямом API Anthropic. Через пользовательский `ANTHROPIC_BASE_URL` — 180 секунд, если Claude Code [получил флаги функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching), и 300 секунд, если нет. 300 секунд в других местах |

213| Body idle timeout | Байты не поступают в течение 5 минут | Провайдеры, отличные от прямого API Anthropic, Claude Platform on AWS и Amazon Bedrock с установленным `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`, если только [`API_FORCE_IDLE_TIMEOUT`](/docs/ru/env-vars) это не изменит | 5 минут |213| Body idle timeout | Байты не поступают в течение 5 минут | Провайдеры, отличные от прямого API Anthropic, Claude Platform on AWS и Amazon Bedrock с установленным `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`, если только [`API_FORCE_IDLE_TIMEOUT`](/docs/ru/env-vars) это не изменит | 5 минут |

214 214

215Если вы установите `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`, byte-level watchdog заменит body idle timeout на Bedrock вместо того, чтобы работать рядом с ним. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` затем также определяет, как долго поток Bedrock может оставаться молчаливым, прежде чем Claude Code будет рассматривать соединение как мёртвое, в пределах указанных ниже лимитов. Поступающие байты по-прежнему не сбрасывают event-level watchdog на Bedrock. При включённом debug logging каждый поток Bedrock затем регистрирует отладочное сообщение, которое начинается с `wire-heartbeat: _chunkTimes absent`.215Если вы установите `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`, byte-level watchdog заменит body idle timeout на Bedrock вместо того, чтобы работать рядом с ним. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` затем также определяет, как долго поток Bedrock может оставаться молчаливым, прежде чем Claude Code будет рассматривать соединение как мёртвое, в пределах указанных ниже лимитов. Поступающие байты по-прежнему не сбрасывают event-level watchdog на Bedrock. При включённом debug logging каждый поток Bedrock затем регистрирует отладочное сообщение, которое начинается с `wire-heartbeat: _chunkTimes absent`.

output-styles.md +3 −3

Details

183| :- | :- | :- |183| :- | :- | :- |

184| `name` | Нет | Имя output style, отображаемое в средстве выбора `/config`. По умолчанию: имя файла |184| `name` | Нет | Имя output style, отображаемое в средстве выбора `/config`. По умолчанию: имя файла |

185| `description` | Нет | Описание output style, отображаемое в средстве выбора `/config` |185| `description` | Нет | Описание output style, отображаемое в средстве выбора `/config` |

186| `keep-coding-instructions` | Нет | Установите значение `true`, чтобы сохранить встроенные инструкции Claude Code по разработке программного обеспечения вместе с вашим стилем. По умолчанию: `false` |186| `keep-coding-instructions` | Нет | Установите значение `true`, чтобы сохранить раздел встроенных инструкций Claude Code по разработке программного обеспечения, который включает только полный системный промпт, вместе с вашим стилем. См. [Как работают стили вывода](#how-output-styles-work). По умолчанию: `false` |

187| `force-for-plugin` | Нет | Только для output styles плагинов. Установите значение `true`, чтобы применить этот стиль автоматически всякий раз, когда плагин включен, без необходимости выбора пользователем. Переопределяет параметр `outputStyle` пользователя. Если несколько включенных плагинов установят это, Claude Code использует первый загруженный. По умолчанию: `false` |187| `force-for-plugin` | Нет | Только для output styles плагинов. Установите значение `true`, чтобы применить этот стиль автоматически всякий раз, когда плагин включен, без необходимости выбора пользователем. Переопределяет параметр `outputStyle` пользователя. Если несколько включенных плагинов установят это, Claude Code использует первый загруженный. По умолчанию: `false` |

188 188

189<span id="comparisons-to-related-features" />189<span id="comparisons-to-related-features" />

214Стиль вывода изменяет инструкции, которые Claude Code отправляет Claude.214Стиль вывода изменяет инструкции, которые Claude Code отправляет Claude.

215 215

216* Claude Code отправляет инструкции активного стиля с каждым запросом.216* Claude Code отправляет инструкции активного стиля с каждым запросом.

217* Пользовательские стили вывода исключают встроенные инструкции Claude Code по разработке программного обеспечения, такие как определение области изменений, написание комментариев и проверка работы, если только `keep-coding-instructions` не установлен на `true`.217* При полном системном промпте пользовательские стили вывода исключают раздел встроенных инструкций Claude Code по разработке программного обеспечения, таких как определение области изменений, написание комментариев и проверка работы, если только `keep-coding-instructions` не установлен на `true`. Сокращённый системный промпт не содержит этот раздел, поэтому там поле ни на что не влияет. Чтобы полагаться на это поле, установите [`CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT`](/docs/ru/env-vars#variables) в значение `0`, что выбирает полный промпт на любой модели.

218 218

219Стили вывода применяются к основному диалогу и к [форку](/docs/ru/sub-agents#fork-the-current-conversation), который наследует полный диалог и системный prompt родителя. Другие [подагенты запускают свой собственный системный prompt](/docs/ru/sub-agents#what-loads-at-startup), поэтому стили не изменяют способ их ответов.219Стили вывода применяются к основному диалогу и к [форку](/docs/ru/sub-agents#fork-the-current-conversation), который наследует полный диалог и системный промпт родителя. Другие [субагенты запускают свой собственный системный промпт](/docs/ru/sub-agents#what-loads-at-startup), поэтому стили не изменяют способ их ответов.

220 220

221Использование токенов зависит от стиля. Инструкции стиля добавляют входные токены, хотя кэширование prompt снижает эту стоимость после первого запроса в сеансе.221Использование токенов зависит от стиля. Инструкции стиля добавляют входные токены, хотя кэширование prompt снижает эту стоимость после первого запроса в сеансе.

222 222

overview.md +1 −1

Details

42 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd42 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

43 ```43 ```

44 44

45 Когда установщик завершит работу, откройте новое окно терминала и выполните `claude --version`. Работающая установка выводит номер версии. Если ваша оболочка говорит, что `claude` не найден или не распознан, каталог установки еще не находится в вашем PATH: см. [Исправьте ваш PATH](/docs/ru/troubleshoot-install#command-not-found-claude-after-installation).45 Команда установки не показывает прогресс во время загрузки Claude Code. Когда установщик завершит работу, откройте новое окно терминала и выполните `claude --version`. Работающая установка выводит номер версии. Если ваша оболочка говорит, что `claude` не найден или не распознан, каталог установки еще не находится в вашем PATH: см. [Исправьте ваш PATH](/docs/ru/troubleshoot-install#command-not-found-claude-after-installation).

46 46

47 Если вы видите `The token '&&' is not a valid statement separator`, вы находитесь в PowerShell, а не в CMD. Если вы видите `'irm' is not recognized as an internal or external command`, вы находитесь в CMD, а не в PowerShell.47 Если вы видите `The token '&&' is not a valid statement separator`, вы находитесь в PowerShell, а не в CMD. Если вы видите `'irm' is not recognized as an internal or external command`, вы находитесь в CMD, а не в PowerShell.

48 48

permission-modes.md +2 −2

Details

11С Claude Code версии 2.1.283 или позже режим auto является встроенным начальным режимом разрешений для интерактивных сеансов терминала и VS Code. В более ранних версиях это встроенный начальный режим разрешений только на планах Pro, Max и Team. [Какой режим начинается в сеансе](#which-mode-a-session-starts-in) охватывает интерфейсы и параметры, которые изменяют начальный режим разрешений. Вы также можете изменить режим разрешений работающего сеанса в любое время.11С Claude Code версии 2.1.283 или позже режим auto является встроенным начальным режимом разрешений для интерактивных сеансов терминала и VS Code. В более ранних версиях это встроенный начальный режим разрешений только на планах Pro, Max и Team. [Какой режим начинается в сеансе](#which-mode-a-session-starts-in) охватывает интерфейсы и параметры, которые изменяют начальный режим разрешений. Вы также можете изменить режим разрешений работающего сеанса в любое время.

12 12

13<h2 id="available-modes">13<h2 id="available-modes">

~~14 Available modes~~14 Доступные режимы

15</h2>15</h2>

16 16

17Каждый режим делает различный компромисс между удобством и контролем. В таблице ниже показано, что Claude может делать без запроса разрешения в каждом режиме. Manual режим отображается под его значением конфигурации, `default`.17Каждый режим делает различный компромисс между удобством и контролем. В таблице ниже показано, что Claude может делать без запроса разрешения в каждом режиме. Manual режим отображается под его значением конфигурации, `default`.

32Режимы устанавливают базовый уровень. Наложите [правила разрешений](/docs/ru/permissions#manage-permissions) сверху, чтобы предварительно одобрить или заблокировать определённые инструменты. Правила отказа блокируют в каждом режиме, включая `bypassPermissions`. Правила отказа и запроса не применяются к [`EndConversation`](/docs/ru/tools-reference#endconversation-tool-behavior), пока Claude всё ещё имеет хотя бы один другой инструмент, который он может вызвать. Правила разрешения не имеют эффекта в `bypassPermissions`.32Режимы устанавливают базовый уровень. Наложите [правила разрешений](/docs/ru/permissions#manage-permissions) сверху, чтобы предварительно одобрить или заблокировать определённые инструменты. Правила отказа блокируют в каждом режиме, включая `bypassPermissions`. Правила отказа и запроса не применяются к [`EndConversation`](/docs/ru/tools-reference#endconversation-tool-behavior), пока Claude всё ещё имеет хотя бы один другой инструмент, который он может вызвать. Правила разрешения не имеют эффекта в `bypassPermissions`.

33 33

34<h3 id="actions-no-mode-auto-approves">34<h3 id="actions-no-mode-auto-approves">

~~35 Actions no mode auto-approves~~35 Действия, которые ни один режим не одобряет автоматически

36</h3>36</h3>

37 37

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

permissions.md +1 −1

Details

700Разрешения и [песочница](/docs/ru/sandboxing) — это дополняющие друг друга уровни безопасности:700Разрешения и [песочница](/docs/ru/sandboxing) — это дополняющие друг друга уровни безопасности:

701 701

702* **Разрешения** контролируют, какие инструменты может использовать Claude Code и к каким файлам или доменам он может получить доступ. Они применяются к Bash, Read, Edit, WebFetch, MCP и всем остальным инструментам, за исключением того, что правило отказа или запроса не может заблокировать [`EndConversation`](/docs/ru/tools-reference#endconversation-tool-behavior), пока остаётся любой другой инструмент.702* **Разрешения** контролируют, какие инструменты может использовать Claude Code и к каким файлам или доменам он может получить доступ. Они применяются к Bash, Read, Edit, WebFetch, MCP и всем остальным инструментам, за исключением того, что правило отказа или запроса не может заблокировать [`EndConversation`](/docs/ru/tools-reference#endconversation-tool-behavior), пока остаётся любой другой инструмент.

703* **Песочница** обеспечивает принудительное применение на уровне ОС, которое ограничивает доступ инструмента Bash к файловой системе и сети. Она применяется только к командам Bash, PowerShell и [Monitor](/docs/ru/tools-reference#monitor-tool) и их дочерним процессам.703* **Изоляция в песочнице** обеспечивает принудительное применение на уровне ОС, которое ограничивает доступ shell-команд к файловой системе и сети. Она применяется к командам инструментов Bash, PowerShell и [Monitor](/docs/ru/tools-reference#monitor-tool) и их дочерним процессам.

704 704

705Используйте оба уровня для защиты в глубину, поскольку ограничения песочницы остаются в силе даже если инъекция в подсказку обойдёт принятие решений Claude. Пути и домены из параметров песочницы и правил разрешений [объединяются в финальную конфигурацию песочницы](/docs/ru/sandboxing#permission-rules).705Используйте оба уровня для защиты в глубину, поскольку ограничения песочницы остаются в силе даже если инъекция в подсказку обойдёт принятие решений Claude. Пути и домены из параметров песочницы и правил разрешений [объединяются в финальную конфигурацию песочницы](/docs/ru/sandboxing#permission-rules).

706 706

plugin-evals.md +26 −5

Details

335* **Подстановки**: вставьте поля из input вызова с `{{input.<field>}}` и содержимое файла fixture рядом с mock с `{{file:fixtures/{input.<field>}.json}}`.335* **Подстановки**: вставьте поля из input вызова с `{{input.<field>}}` и содержимое файла fixture рядом с mock с `{{file:fixtures/{input.<field>}.json}}`.

336* **`expect:`**: блок `expect:` охраняет input. Если вызов нарушает его, запуск прерывается с оценкой 0 и записывает почему, поэтому кейс может утверждать, что ваш plugin попросил сервер сделать.336* **`expect:`**: блок `expect:` охраняет input. Если вызов нарушает его, запуск прерывается с оценкой 0 и записывает почему, поэтому кейс может утверждать, что ваш plugin попросил сервер сделать.

337* **`error: true`**: установите `error: true`, чтобы вернуть body как ошибку инструмента вместо этого.337* **`error: true`**: установите `error: true`, чтобы вернуть body как ошибку инструмента вместо этого.

338* **`type: agent`**: задайте `type: agent`, чтобы модель-судья отвечала от имени сервера по инструкциям из тела.338* **`type: agent`**: задайте `type: agent`, чтобы модель-судья отвечала от имени сервера по инструкциям из тела. Вызовы agent mock используют общий [бюджет на запуск](#mock-call-budget-exceeded), равный четырёхкратному значению `max_turns` кейса, и вызов сверх него прерывает запуск с оценкой 0.

339 339

340Справочник [mock file reference](#mock-files) перечисляет каждый ключ и файлы `_server.md` и `_tools.json`.340Справочник [mock file reference](#mock-files) перечисляет каждый ключ и файлы `_server.md` и `_tools.json`.

341 341

370| :- | :- |370| :- | :- |

373| Установленный plugin по имени, `name` или `name@marketplace` | Кейсы в копии установленного plugin директории eval с установленной копией загруженной. Результаты записываются под `./evals/results/` в вашей текущей директории или `./<dir>/results/` с `--eval-dir` |373| Установленный плагин по имени, `name` или `name@marketplace` | Плагин и кейсы в его каталоге eval, прочитанные [на месте или из установленной копии](/docs/ru/plugins/loading#in-place-and-copied-plugins). Результаты записываются в `./evals/results/` в текущем каталоге или в `./<dir>/results/` при использовании `--eval-dir` |

374| `name@skills-dir` | То же самое для [skills-directory plugin](/docs/ru/plugins/loading#plugins-shared-through-a-repository) |374| `name@skills-dir` | То же самое для [skills-directory plugin](/docs/ru/plugins/loading#plugins-shared-through-a-repository) |

375| Опущено | Текущая директория как путь |375| Опущено | Текущая директория как путь |

376 376

503| `cases[].aggregates.delta` | Оценка with-arm минус оценка without-arm. Опущено, когда кейс запустил одну arm или arms не сравнимы |503| `cases[].aggregates.delta` | Оценка with-arm минус оценка without-arm. Опущено, когда кейс запустил одну arm или arms не сравнимы |

504| `cases[].arms.with[].error` | `null` или почему запуск закончился ненормально, такой как `timed out after 300s`. Запуск, который начался, но закончился плохо, все еще оценивается на том, что он произвел, поэтому non-null ошибка не подразумевает оценку 0 |504| `cases[].arms.with[].error` | `null` или почему запуск закончился ненормально, такой как `timed out after 300s`. Запуск, который начался, но закончился плохо, все еще оценивается на том, что он произвел, поэтому non-null ошибка не подразумевает оценку 0 |

505| `cases[].arms.with[].aborted` | Присутствует, когда [mock](#mock-mcp-servers) `expect:` или `abort_when` остановил запуск, с `server`, `tool` и `reason`. Запуск оценивается в 0 и `error` остается `null` |505| `cases[].arms.with[].aborted` | Присутствует, когда [mock](#mock-mcp-servers) остановил запуск через `expect:`, `abort_when` или [бюджет вызовов agent-mock](#mock-call-budget-exceeded), с `server`, `tool` и `reason`. Запуск оценивается в 0 и `error` остается `null` |

506| `cases[].arms.with[].skippedPaidGraders` | `true`, когда потолок стоимости пропустил judge graders этого запуска, поэтому его оценка не сравнима |506| `cases[].arms.with[].skippedPaidGraders` | `true`, когда потолок стоимости пропустил judge graders этого запуска, поэтому его оценка не сравнима |

507| `costUsd`, `durationSeconds`, `claudeVersion` | Оценка стоимости по прейскуранту, включая judge вызовы, wall-clock секунды и версия Claude Code, которая запустила suite |507| `costUsd`, `durationSeconds`, `claudeVersion` | Оценка стоимости по прейскуранту, включая judge вызовы, wall-clock секунды и версия Claude Code, которая запустила suite |

508 508

659| :- | :- | :- |659| :- | :- | :- |

660| `type` | `fixed` | `fixed` возвращает тело как написано. `agent` рассматривает тело как инструкции для [модели-судьи](#command-options), которая играет роль сервера для запуска и видит более ранние вызовы как историю |660| `type` | `fixed` | `fixed` возвращает тело как написано. `agent` рассматривает тело как инструкции для [модели-судьи](#command-options), которая играет роль сервера для запуска и видит более ранние вызовы как историю |

661| `expect` | не установлено | Карта от точечных путей входа к имени типа, такому как `string`, `number`, `boolean`, `array` или `object`, `/regex/`, литерал или список разрешённых литералов. Вызов, который нарушает это, прерывает запуск с оценкой 0 и сообщается как `aborted` с сервером, инструментом и причиной |661| `expect` | не установлено | Карта от точечных путей входа к имени типа, такому как `string`, `number`, `boolean`, `array` или `object`, [`/regex/`](#expect-patterns), литерал или список разрешённых литералов. Вызов, который нарушает это, прерывает запуск с оценкой 0 и сообщается как `aborted` с сервером, инструментом и причиной |

664 664

665Два опциональных файла находятся рядом с файлами инструментов в директории сервера:665Два опциональных файла находятся рядом с файлами инструментов в директории сервера:

666 666

667* **`_server.md`**: один мок `type: agent`, который отвечает на несколько инструментов, перечисленных в его ключе frontmatter `tools:`. `<tool>.md` для того же инструмента имеет приоритет. Поместите охрану `expect:` на отдельный `<tool>.md`, а не здесь667* **`_server.md`**: один мок `type: agent`, который отвечает на несколько инструментов, перечисленных в его ключе frontmatter `tools:`. `<tool>.md` для того же инструмента имеет приоритет. Охрана `expect:` здесь вызывает ошибку загрузки, если только `tools:` не перечисляет единственный инструмент, поэтому поместите охрану на отдельный `<tool>.md`

668* **`_tools.json`**: сохранённый ответ `tools/list` от реального сервера, поэтому мокированные инструменты несут свои реальные описания и входные схемы вместо разрешающего заполнителя668* **`_tools.json`**: сохранённый ответ `tools/list` от реального сервера, поэтому мокированные инструменты несут свои реальные описания и входные схемы вместо разрешающего заполнителя

669 669

670Собственная директория `mocks/` случая использует тот же макет и переопределяет файлы мока набора тестов файл за файлом.670Собственная директория `mocks/` случая использует тот же макет и переопределяет файлы мока набора тестов файл за файлом.

671 671

672<h4 id="expect-patterns">

673 Шаблоны регулярных выражений в expect

674</h4>

675

676Значение `/regex/` в `expect:` использует небольшой диалект, который Claude Code проверяет при загрузке набора тестов:

677

678* Литеральные символы, `.`, экранированные последовательности, такие как `\d`, и классы символов, такие как `[a-z]`

679* Квантификаторы `*`, `+`, `?` и формы `{m,n}`, каждый применительно к одному символу, экранированной последовательности или классу

680* Необязательный `^` в начале и `$` в конце

681* Только флаги `i` и `s`

682

683Шаблон за пределами диалекта, например с группой, альтернацией, обратной ссылкой, просмотром вперёд или назад или другим флагом, не даёт случаю загрузиться: случай получает оценку 0, а его ошибка называет шаблон. Чтобы разрешить несколько точных значений, напишите список литералов вместо альтернации.

684

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

686

672<h2 id="troubleshooting">687<h2 id="troubleshooting">

673 Troubleshooting688 Troubleshooting

674</h2>689</h2>

777 792

778Если ваш аккаунт достигает лимита использования плана или API лимита скорости, пока suite запускается, каждый более поздний запуск заканчивается этой ошибкой, оценивается на том, что он произвел, и обычно оценивается в 0. Suite все еще завершается и не отмечена `partial`, поэтому результат может выглядеть как регрессия. Проверьте столбец `NOTES` или `cases[].arms.with[].error` в JSON для сообщения лимита перед тем как доверять оценкам, затем перезапустите после того как лимит сбросится, с `--runs 1` или фильтром `--case`, если вам нужно остаться под ним.793Если ваш аккаунт достигает лимита использования плана или API лимита скорости, пока suite запускается, каждый более поздний запуск заканчивается этой ошибкой, оценивается на том, что он произвел, и обычно оценивается в 0. Suite все еще завершается и не отмечена `partial`, поэтому результат может выглядеть как регрессия. Проверьте столбец `NOTES` или `cases[].arms.with[].error` в JSON для сообщения лимита перед тем как доверять оценкам, затем перезапустите после того как лимит сбросится, с `--runs 1` или фильтром `--case`, если вам нужно остаться под ним.

779 794

795<h3 id="mock-call-budget-exceeded">

796 "mock call budget exceeded"

797</h3>

798

799Все [моки](#mock-mcp-servers) с `type: agent` в запуске расходуют общий бюджет вызовов, равный четырёхкратному значению `max_turns` кейса, то есть 40 вызовов при значении по умолчанию 10. Вызовы, на которые отвечают записи из `.replay/`, тоже учитываются, а строка прогресса `mock budget` кейса выводит бюджет. Вызов сверх него прерывает запуск с оценкой 0 и этой причиной, поэтому для скилла, который делает много вызовов к мокам агентов, увеличьте `max_turns` в кейсе.

800

780<h3 id="runs-time-out-or-hit-the-turn-cap">801<h3 id="runs-time-out-or-hit-the-turn-cap">

781 Runs time out or hit the turn cap802 Runs time out or hit the turn cap

782</h3>803</h3>

plugins/cli-reference.md +62 −40

Details

76 plugin install76 plugin install

77</h3>77</h3>

78 78

~~79Установите плагин из маркетплейса, который вы добавили. `i` — это псевдоним для `install`.~~79Установите плагин из одного из ваших маркетплейсов. `i` — это псевдоним для `install`.

80 80

81```bash theme={null}81```bash theme={null}

82claude plugin install <plugin> [options]82claude plugin install <plugin> [options]

129 129

130Ошибка использования, такая как неверный `--scope`, не выводит строку результата и выходит с кодом `1` с причиной на stderr.130Ошибка использования, такая как неверный `--scope`, не выводит строку результата и выходит с кодом `1` с причиной на stderr.

131 131

132<h4 id="json-result-for-marketplace-commands">

133 JSON-результат для команд маркетплейса

134</h4>

135

136Для `plugin marketplace add`, `plugin marketplace remove` и `plugin marketplace update` флаг `--json` выводит один JSON объект на последней строке stdout с полями `command`, `outcome` и `message`. Ниже приведён результат `claude plugin marketplace remove your-marketplace --json`:

137

138```json theme={null}

139{"command":"marketplace-remove","outcome":"ok","marketplace":"your-marketplace","message":"Successfully removed marketplace: your-marketplace"}

140```

141

142Значение `command` — это `marketplace-add`, `marketplace-remove` или `marketplace-update`. Поля ниже появляются только когда они применяются:

143

144* `marketplace`: имя маркетплейса, с которым работала команда

145* `failureCode`: код причины, по которой команда не выполнилась, например `invalid_source`

146

147`plugin marketplace add` и `plugin marketplace remove` могут не выводить строку результата, когда аргумент — это [зарезервированное имя](/docs/ru/plugins/marketplace-reference#reserved-names) `anthropic-plugin-directory`, поэтому для этого имени проверяйте код выхода.

148

132<h4 id="accept-a-displayed-install-command">149<h4 id="accept-a-displayed-install-command">

133 Принять отображаемую команду установки150 Принять отображаемую команду установки

134</h4>151</h4>

672* `target`: разрешённый путь, который Claude Code проверил689* `target`: разрешённый путь, который Claude Code проверил

673* `manifest`: собственный результат манифеста или `null` для запуска без манифеста690* `manifest`: собственный результат манифеста или `null` для запуска без манифеста

674* `contents`: результаты для каждого файла, каждый называет свой `file` и содержит массивы `errors`, `warnings` и `notes`691* `contents`: результаты для каждого файла, каждый называет свой `file` и содержит массивы `errors`, `warnings` и `notes`

692 * `gatingHooks`: есть ли у каждого хука [мода](/docs/ru/plugins/mods/overview), который может отклонить действие, например хука `tool.call`, [обработчик `.catch`](/docs/ru/plugins/mods/events#handle-a-hook-that-fails). Каждый элемент содержит `module`, `pattern`, `hook` и `hasCatch`. Требует Claude Code v2.1.290 или позже

675 693

676При выходе `2` команда ничего не записывает на stdout. Сообщение об ошибке идёт на stderr.694При выходе `2` команда ничего не записывает на stdout. Сообщение об ошибке идёт на stderr.

677 695

684* **Коды выхода**: эти подкоманды следуют [соглашению кода выхода](#claude-plugin-commands) команд плагина702* **Коды выхода**: эти подкоманды следуют [соглашению кода выхода](#claude-plugin-commands) команд плагина

685* **Области действия**: их флаг `--scope` не имеет короткой формы `-s`703* **Области действия**: их флаг `--scope` не имеет короткой формы `-s`

686 704

687Для того, что такое маркетплейс и как Claude Code его кэширует, см. [Справочник загрузки плагинов](/docs/ru/plugins/loading).705Чтобы узнать, что такое маркетплейс и как Claude Code его кэширует, см. [Справочник загрузки плагинов](/docs/ru/plugins/loading).

688 706

689<h3 id="plugin-marketplace-add">707<h3 id="plugin-marketplace-add">

690 plugin marketplace add708 plugin marketplace add

691</h3>709</h3>

692 710

693Добавьте маркетплейс из репозитория GitHub, URL git, размещённого `marketplace.json` или локального пути, и объявите его в файле параметров.711Добавьте маркетплейс из репозитория GitHub, URL git, размещённого `marketplace.json` или локального пути и объявите его в файле настроек.

694 712

695После добавления Claude Code устанавливает любые [зависимости](/docs/ru/plugins/dependencies), которые отсутствовали у ваших установленных плагинов.713После добавления Claude Code устанавливает любые [зависимости](/docs/ru/plugins/dependencies), которые отсутствовали у ваших установленных плагинов.

696 714

700 718

701| Флаг | Описание |719| Флаг | Описание |

702| :- | :- |720| :- | :- |

704| `--sparse <paths...>` | Ограничьте проверку git этими каталогами для монорепозиториев. Только источники `github` и `git` |722| `--sparse <paths...>` | Ограничить checkout git этими каталогами, для монорепозиториев. Только источники `github` и `git` |

705| `--claudeai` | Читайте аргумент как имя [маркетплейса, размещённого на claude.ai](/docs/ru/plugins/install#add-from-claude-ai). Требует Claude Code v2.1.273 или позже |723| `--claudeai` | Интерпретировать аргумент как имя [маркетплейса, размещённого на claude.ai](/docs/ru/plugins/install#add-from-claude-ai), а не как источник. Требует Claude Code v2.1.273 или позже |

724| `--json` | Вывести, успешно ли выполнена команда, и её сообщение в виде одного объекта JSON в последней строке stdout в [формате результата JSON](#plugin-json-result). Не действует вместе с `--claudeai`. Требует Claude Code v2.1.287 или позже |

706 725

707`<source>` принимает любую из форм в таблице ниже, и его форма решает тип источника и как Claude Code получает маркетплейс. Для результирующего объекта источника см. [справочник маркетплейса](/docs/ru/plugins/marketplace-reference).726`<source>` принимает любую из форм в таблице ниже, и его форма определяет тип источника и то, как Claude Code получает маркетплейс. Для результирующего объекта источника см. [справочник маркетплейса](/docs/ru/plugins/marketplace-reference).

708 727

710| :- | :- | :- |729| :- | :- | :- |

711| `owner/repo`, `owner/repo#ref` или `owner/repo@ref` | `github` | Клонирует репозиторий GitHub, закреплённый на `ref`, когда дан. Владелец и репо должны следовать правилам именования GitHub |730| `owner/repo`, `owner/repo#ref` или `owner/repo@ref` | `github` | Клонирует репозиторий GitHub, закреплённый на `ref`, если он указан. Владелец и репозиторий должны следовать правилам именования GitHub |

712| `user@host:path[.git][#ref]` | `git` | Клонирует по SSH |731| `user@host:path[.git][#ref]` | `git` | Клонирует по SSH |

713| URL `http://` или `https://`, заканчивающийся на `.git[#ref]` или содержащий `/_git/`, такой как `https://example.com/repo.git` | `git` | Клонирует URL, включая URL Azure DevOps |732| URL `http://` или `https://`, заканчивающийся на `.git[#ref]` или содержащий `/_git/`, например `https://example.com/repo.git` | `git` | Клонирует URL, включая URL Azure DevOps |

714| `https://github.com/owner/repo` или `https://gitlab.com/namespace/project`, или то же самое по `http://` | `git` | Клонирует URL после добавления `.git` |733| `https://github.com/owner/repo` или `https://gitlab.com/namespace/project`, или то же самое по `http://` | `git` | Клонирует URL после добавления `.git` |

715| Любой другой URL `http://` или `https://`, включая самостоятельно размещённый git хост без `.git` | `url` | Получает URL как `marketplace.json`. Чтобы клонировать репозиторий там вместо этого, добавьте `.git` |734| Любой другой URL `http://` или `https://`, включая самостоятельно размещённый git-хост без `.git` | `url` | Получает URL как `marketplace.json`. Чтобы вместо этого клонировать там репозиторий, добавьте `.git` |

718 737

719Для хоста, чьи URL клонирования не содержат суффикс `.git`, такого как AWS CodeCommit, добавьте маркетплейс как запись git в [`extraKnownMarketplaces`](/docs/ru/settings-reference#extraknownmarketplaces) вместо этого. Claude Code клонирует запись git независимо от того, заканчивается ли её URL на `.git`.738Для хоста, чьи URL клонирования не содержат суффикс `.git`, например AWS CodeCommit, добавьте маркетплейс как запись git в [`extraKnownMarketplaces`](/docs/ru/settings-reference#extraknownmarketplaces). Claude Code клонирует запись git независимо от того, заканчивается ли её URL на `.git`.

720 739

721Claude Code также клонирует URL `gitlab.com` с вложенными подгруппами, такой как `https://gitlab.com/group/subgroup/project`.740Claude Code также клонирует URL `gitlab.com` с вложенными подгруппами, например `https://gitlab.com/group/subgroup/project`.

722 741

723Добавьте маркетплейс и поделитесь им с проектом:742Добавьте маркетплейс и поделитесь им с проектом:

724 743

726claude plugin marketplace add your-org/your-marketplace --scope project745claude plugin marketplace add your-org/your-marketplace --scope project

727```746```

728 747

729Claude Code выводит `Successfully added marketplace: your-marketplace (declared in project settings)`, используя `name` из собственного манифеста маркетплейса. Повторное добавление или неверный источник выводит один из этих результатов вместо этого:748Claude Code выводит `Successfully added marketplace: your-marketplace (declared in project settings)`, используя `name` из собственного манифеста маркетплейса. Повторное добавление или неверный источник вместо этого выводит один из следующих результатов:

730 749

731* **Маркетплейс уже на диске**: выходные данные — `Marketplace 'your-marketplace' already on disk — declared in project settings` и код выхода — `0`750* **Маркетплейс уже на диске**: выходные данные — `Marketplace 'your-marketplace' already on disk — declared in project settings`, код выхода — `0`

732* **Нераспознанный источник**: выходные данные — `Invalid marketplace source format. Try: owner/repo, https://..., or ./path` и код выхода — `1`751* **Нераспознанный источник**: выходные данные — `Invalid marketplace source format. Try: owner/repo, https://..., or ./path`, код выхода — `1`

733* **Простой хост, такой как `gitlab.example.com/team/plugins`**: добавление не выполняется как неверный ярлык `owner/repo`, и сообщение говорит вам добавить `https://` или использовать локальный путь752* **Простой хост, например `gitlab.example.com/team/plugins`**: добавление завершается ошибкой как неверное сокращение `owner/repo`, и сообщение предлагает добавить `https://` или использовать локальный путь

734 753

735Добавьте [маркетплейс, размещённый на claude.ai](/docs/ru/plugins/install#add-from-claude-ai) по имени, выведённому в разделе `From claude.ai:` из `claude plugin marketplace list`:754Добавьте [маркетплейс, размещённый на claude.ai](/docs/ru/plugins/install#add-from-claude-ai), по имени, выведенному в разделе `From claude.ai:` команды `claude plugin marketplace list`:

736 755

737```bash theme={null}756```bash theme={null}

738claude plugin marketplace add --claudeai claudeai-organization-library757claude plugin marketplace add --claudeai claudeai-organization-library

739```758```

740 759

741С `--claudeai` команда отклоняет `--scope` и `--sparse`. Маркетплейс размещён для вашей учётной записи, не объявлен в файле параметров, поэтому вы не можете поделиться им через `.claude/settings.json` проекта.760С `--claudeai` команда отклоняет `--scope` и `--sparse`. Маркетплейс размещён для вашей учётной записи, а не объявлен в файле настроек, поэтому вы не можете поделиться им через `.claude/settings.json` проекта.

742 761

743<h3 id="plugin-marketplace-list">762<h3 id="plugin-marketplace-list">

744 plugin marketplace list763 plugin marketplace list

745</h3>764</h3>

746 765

747Выведите список каждого маркетплейса, который вы добавили, с его источником.766Выведите список всех добавленных вами маркетплейсов с их источниками.

748 767

749```bash theme={null}768```bash theme={null}

750claude plugin marketplace list [options]769claude plugin marketplace list [options]

752 771

753| Флаг | Описание |772| Флаг | Описание |

754| :- | :- |773| :- | :- |

756 775

757Claude Code выводит `Configured marketplaces:` и одну строку `Source:` на маркетплейс, или `No marketplaces configured`.776Claude Code выводит `Configured marketplaces:` и по одной строке `Source:` на маркетплейс, или `No marketplaces configured`.

758 777

759С `--json` Claude Code выводит массив с одним объектом на маркетплейс, содержащий поля ниже. Каждое поле — это строка.778С `--json` Claude Code выводит массив с одним объектом на маркетплейс, содержащим поля ниже. Каждое поле — строка.

760 779

761| Поле | Описание |780| Поле | Описание |

762| :- | :- |781| :- | :- |

766| `url` | URL клонирования или получения. Только источники `git` и `url` |785| `url` | URL клонирования или получения. Только источники `git` и `url` |

768| `ref` | Закреплённая ветвь или тег. Источники `github` и `git`, только когда закреплено |787| `ref` | Закреплённая ветка или тег. Источники `github` и `git`, только если закреплено |

770 789

771Добавленный [маркетплейс claude.ai](/docs/ru/plugins/install#add-from-claude-ai) не имеет локального клона, поэтому его запись содержит его идентификаторы claude.ai, `marketplaceId` и `organizationUuid`, вместо `installLocation`. Он также содержит `scope`, когда один записан, и `status`.790Добавленный [маркетплейс claude.ai](/docs/ru/plugins/install#add-from-claude-ai) не имеет локального клона, поэтому его запись вместо `installLocation` содержит его идентификаторы claude.ai — `marketplaceId` и `organizationUuid`. Она также содержит `scope`, если он записан, и `status`.

772 791

773Если ваши сеансы терминала [синхронизируют плагины с вашей учётной записью claude.ai](/docs/ru/plugins/loading#synced-plugins), текстовый список заканчивается разделом `From claude.ai:`. Этот раздел называет маркетплейсы, которые claude.ai выводит для вашей учётной записи, которые вы не добавили, как основанные на git, так и размещённые. Это требует Claude Code v2.1.273 или позже.792Если ваши сессии терминала [синхронизируют плагины с вашей учётной записью claude.ai](/docs/ru/plugins/loading#synced-plugins), текстовый список заканчивается разделом `From claude.ai:`. В этом разделе перечислены маркетплейсы, которые claude.ai указывает для вашей учётной записи, но которые вы не добавили, — как основанные на git, так и размещённые. Для этого требуется Claude Code v2.1.273 или позже.

774 793

775Чтобы добавить маркетплейс из этого раздела, см. [Добавление маркетплейса с claude.ai](/docs/ru/plugins/install#add-from-claude-ai).794Чтобы добавить маркетплейс из этого раздела, см. [Добавление маркетплейса с claude.ai](/docs/ru/plugins/install#add-from-claude-ai).

776 795

777Выход `--json` охватывает только настроенные маркетплейсы и оставляет раздел.796Вывод `--json` охватывает только настроенные маркетплейсы и не включает этот раздел.

778 797

779<h3 id="plugin-marketplace-remove">798<h3 id="plugin-marketplace-remove">

780 plugin marketplace remove799 plugin marketplace remove

781</h3>800</h3>

782 801

783Удалите объявление маркетплейса из ваших параметров. `rm` — это псевдоним для `remove`.802Удалите объявление маркетплейса из ваших настроек. `rm` — псевдоним для `remove`.

784 803

785<Warning>804<Warning>

786 Когда вы удаляете маркетплейс из последней области действия, которая его объявляет, Claude Code также удаляет его кэш и удаляет каждый плагин, который вы установили из него. Он также удаляет их сохранённые [параметры и секреты](/docs/ru/plugins/manifest-reference#user-configuration) и [данные](/docs/ru/plugins/components#path-variables-and-persistent-data), где это возможно.805 Когда вы удаляете маркетплейс из последней области действия, которая его объявляет, Claude Code также удаляет его кэш и удаляет каждый плагин, который вы из него установили. Он также удаляет их сохранённые [параметры и секреты](/docs/ru/plugins/manifest-reference#user-configuration) и [данные](/docs/ru/plugins/components#path-variables-and-persistent-data), где это возможно.

787 806

788 Чтобы обновить маркетплейс без потери его плагинов, запустите `plugin marketplace update` вместо этого.807 Чтобы обновить маркетплейс без потери его плагинов, вместо этого запустите `plugin marketplace update`.

789</Warning>808</Warning>

790 809

791```bash theme={null}810```bash theme={null}

792claude plugin marketplace remove <name> [options]811claude plugin marketplace remove <name> [options]

793```812```

794 813

795`<name>` — это имя маркетплейса, которое показывает `plugin marketplace list`, не источник, который вы передали в `add`.814`<name>` — это имя маркетплейса, которое показывает `plugin marketplace list`, а не источник, который вы передали в `add`.

796 815

797| Флаг | Описание |816| Флаг | Описание |

798| :- | :- |817| :- | :- |

799| `--scope <scope>` | Удалить объявление из одной области действия параметров: `user`, `project` или `local`. Без него Claude Code удаляет объявление из каждой области действия |818| `--scope <scope>` | Удалить объявление из одной области действия настроек: `user`, `project` или `local`. Без него Claude Code удаляет объявление из всех областей действия |

819| `--json` | Вывести, успешно ли выполнена команда, и её сообщение в виде одного объекта JSON в последней строке stdout в [формате результата JSON](#plugin-json-result). Требует Claude Code v2.1.287 или позже |

800 820

801Удалите маркетплейс из каждой области действия:821Удалите маркетплейс из всех областей действия:

802 822

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

804claude plugin marketplace remove your-marketplace824claude plugin marketplace remove your-marketplace

805```825```

806 826

807Claude Code выводит `Successfully removed marketplace: your-marketplace`. Когда команда удаляет плагины, выходные данные выводят их под строкой, такой как `Also uninstalled 2 plugins from this marketplace:`. Чтобы использовать один из них снова, добавьте маркетплейс обратно и переустановите плагин.827Claude Code выводит `Successfully removed marketplace: your-marketplace`. Когда команда удаляет плагины, выходные данные перечисляют их под строкой вроде `Also uninstalled 2 plugins from this marketplace:`. Чтобы снова использовать один из них, добавьте маркетплейс обратно и переустановите плагин.

808 828

809Если вы ограничиваете файл параметров, который не объявляет маркетплейс, команда не выполняется с `Marketplace 'your-marketplace' is not declared in project settings. Omit --scope to remove it from all scopes.`829Если вы ограничите команду файлом настроек, который не объявляет маркетплейс, команда завершится ошибкой `Marketplace 'your-marketplace' is not declared in project settings. Omit --scope to remove it from all scopes.`

810 830

811<h3 id="plugin-marketplace-update">831<h3 id="plugin-marketplace-update">

812 plugin marketplace update832 plugin marketplace update

813</h3>833</h3>

814 834

815Обновите один маркетплейс или каждый маркетплейс из его источника, чтобы получить новые плагины и версии. Маркетплейс, добавленный с ветвью или тегом `ref`, обновляется до последнего коммита этого ref, не ветви по умолчанию репозитория.835Обновите один маркетплейс или все маркетплейсы из их источника, чтобы получить новые плагины и версии. Маркетплейс, добавленный с веткой или тегом `ref`, обновляется до последнего коммита этого ref, а не ветки репозитория по умолчанию.

816 836

817```bash theme={null}837```bash theme={null}

818claude plugin marketplace update [name]838claude plugin marketplace update [name] [options]

819```839```

820 840

821Команда не принимает флаги кроме `--help`.841| Флаг | Описание |

842| :- | :- |

843| `--json` | Вывести, успешно ли выполнена команда, и её сообщение в виде одного объекта JSON в последней строке stdout в [формате результата JSON](#plugin-json-result). Без имени команда отклоняет `--json` и завершается с кодом `1`. Требует Claude Code v2.1.287 или позже |

822 844

823Обновите один маркетплейс:845Обновите один маркетплейс:

824 846

826claude plugin marketplace update your-marketplace848claude plugin marketplace update your-marketplace

827```849```

828 850

829Claude Code выводит `Successfully updated marketplace: your-marketplace`. Когда вы пропускаете имя, он выводит счёт, такой как `Successfully updated 2 marketplaces`. Без добавленных маркетплейсов он выводит `No marketplaces configured` и выходит с кодом `0`.851Claude Code выводит `Successfully updated marketplace: your-marketplace`. Если вы не указываете имя, он выводит количество, например `Successfully updated 2 marketplaces`.

830 852

831<h2 id="plugin-in-a-session">853<h2 id="plugin-in-a-session">

832 /plugin в сеансе854 /plugin в сеансе

plugins/components.md +1 −1

Details

1034]1034]

1035```1035```

1036 1036

1037Команда запускается в оболочке, в рабочей директории, в которой сессия началась.1037Команда запускается в оболочке, в текущем рабочем каталоге сессии. Она выполняется с полными правами вашего пользователя и вне [песочницы](/docs/ru/sandboxing).

1038 1038

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

1040 1040

plugins/marketplace-reference.md +11 −8

Details

27* **Вывод из [`claude plugin validate <path>`](/docs/ru/plugins/cli-reference)**: [Сообщения валидации](#validation-messages), которые сопоставляют каждое сообщение с полем, которое оно называет27* **Вывод из [`claude plugin validate <path>`](/docs/ru/plugins/cli-reference)**: [Сообщения валидации](#validation-messages), которые сопоставляют каждое сообщение с полем, которое оно называет

28 28

29<h2 id="marketplace-file">29<h2 id="marketplace-file">

~~30 Файл marketplace~~30 Файл маркетплейса

31</h2>31</h2>

32 32

33Сохраняйте файл marketplace в `.claude-plugin/marketplace.json` в директории вашего marketplace. Если вы храните файл в другом месте репозитория, пользователи должны объявить marketplace в [`extraKnownMarketplaces`](/docs/ru/settings-reference#extraknownmarketplaces) с установленным `path` на его источник, потому что `claude plugin marketplace add` не имеет для этого опции.33Сохраните файл маркетплейса по пути `.claude-plugin/marketplace.json` в каталоге вашего маркетплейса. Если вы храните файл в другом месте репозитория, пользователям придётся объявить маркетплейс в [`extraKnownMarketplaces`](/docs/ru/settings-reference#extraknownmarketplaces) с указанием `path` в его источнике, поскольку у `claude plugin marketplace add` нет такой опции.

34 34

35Директория, которая содержит `.claude-plugin/`, называется корневой директорией marketplace, и каждый относительный источник плагина разрешается из неё, а не из `.claude-plugin/`.35Каталог, содержащий `.claude-plugin/`, называется корнем маркетплейса, и все относительные источники плагинов разрешаются относительно него, а не относительно `.claude-plugin/`.

36 36

37Каждый пользователь регистрирует один marketplace на `name`, поэтому пользователь не может иметь два marketplace с одинаковым именем, зарегистрированные одновременно.37Каждый пользователь регистрирует один маркетплейс на одно значение `name`, поэтому у пользователя не может быть одновременно зарегистрировано два маркетплейса с одинаковым именем.

38 38

39Claude Code игнорирует неизвестный ключ верхнего уровня или ключ записи плагина, а не отклоняет его, поэтому опечатка загружается молча. `claude plugin validate` сообщает о каждом неизвестном ключе как о предупреждении.39Claude Code игнорирует неизвестный ключ верхнего уровня или ключ записи плагина, а не отклоняет его, поэтому опечатка загружается без каких-либо сообщений. `claude plugin validate` сообщает о каждом неизвестном ключе как о предупреждении.

40 40

41<h3 id="reserved-names">41<h3 id="reserved-names">

42 Зарезервированные имена42 Зарезервированные имена

43</h3>43</h3>

44 44

~~45Вы не можете дать вашему marketplace ни одно из следующих имён:~~45Вы не можете дать своему маркетплейсу ни одно из следующих имён:

46 46

47* **Имена официального marketplace**: `claude-code-marketplace`, `claude-code-plugins`, `claude-plugins-official`, `anthropic-marketplace`, `anthropic-plugins`, `agent-skills`, `anthropic-agent-skills`, `life-sciences`, `knowledge-work-plugins`, `claude-for-legal`, `claude-for-financial-services`, `financial-services-plugins`, `first-party-plugins` и `claude-tag-plugins`. Зарезервированы, если только marketplace не поступает из источника `github` или `git` [marketplace source](#marketplace-sources) под `github.com/anthropics/`.47* **Имена официального marketplace**: `claude-code-marketplace`, `claude-code-plugins`, `claude-plugins-official`, `anthropic-marketplace`, `anthropic-plugins`, `agent-skills`, `anthropic-agent-skills`, `life-sciences`, `knowledge-work-plugins`, `claude-for-legal`, `claude-for-financial-services`, `financial-services-plugins`, `first-party-plugins` и `claude-tag-plugins`. Зарезервированы, если только marketplace не поступает из источника `github` или `git` [marketplace source](#marketplace-sources) под `github.com/anthropics/`.

48* **Имена community marketplace**: `claude-community`, `claude-plugins-community` и `healthcare`. Зарезервированы по тому же правилу, что и официальные имена.48* **Имена community marketplace**: `claude-community`, `claude-plugins-community` и `healthcare`. Зарезервированы по тому же правилу, что и официальные имена.

52* **Имена, которые Claude Code использует для плагинов, которые не поступают из marketplace**: `inline` для плагинов, загруженных с [`--plugin-dir`](/docs/ru/cli-reference), `builtin` для встроенных плагинов, `skills-dir` для плагинов, автоматически загруженных из [`.claude/skills/`](/docs/ru/skills), и `synced` для плагинов, синхронизированных с вашего аккаунта claude.ai. `claude-plugin-test` также зарезервирован. `skills-dir` также появляется как `{"source": "skills-dir"}` в `strictKnownMarketplaces` и `blockedMarketplaces`, описанные в разделе [Source values valid only in policy lists](#source-values-valid-only-in-policy-lists).52* **Имена, которые Claude Code использует для плагинов, которые не поступают из marketplace**: `inline` для плагинов, загруженных с [`--plugin-dir`](/docs/ru/cli-reference), `builtin` для встроенных плагинов, `skills-dir` для плагинов, автоматически загруженных из [`.claude/skills/`](/docs/ru/skills), и `synced` для плагинов, синхронизированных с вашего аккаунта claude.ai. `claude-plugin-test` также зарезервирован. `skills-dir` также появляется как `{"source": "skills-dir"}` в `strictKnownMarketplaces` и `blockedMarketplaces`, описанные в разделе [Source values valid only in policy lists](#source-values-valid-only-in-policy-lists).

53* **`npm`, `pip`, `uv`, `cargo`, `github` и `gh`**: зарезервированы в любом регистре. Эта проверка требует Claude Code v2.1.275 или позже.53* **`npm`, `pip`, `uv`, `cargo`, `github` и `gh`**: зарезервированы в любом регистре. Эта проверка требует Claude Code v2.1.275 или позже.

54* **Имена, начинающиеся с `claudeai-`**: зарезервированы для marketplace, размещённых на claude.ai. `claude plugin marketplace add` отказывает любому другому marketplace, который использует один с `Cannot add marketplace "<name>": names starting with "claudeai-" are reserved for marketplaces hosted on claude.ai`.54* **Имена, начинающиеся с `claudeai-`**: зарезервированы для marketplace, размещённых на claude.ai. `claude plugin marketplace add` отказывает любому другому marketplace, который использует один с `Cannot add marketplace "<name>": names starting with "claudeai-" are reserved for marketplaces hosted on claude.ai`.

55* **Папка загрузки зарегистрированного GitHub marketplace, `<owner>-<repo>`**: Claude Code загружает marketplace, добавленный из источника `github`, например `acme/x-tools`, через папку с именем `acme-x-tools`, каким бы ни было собственное `name` этого marketplace. Пока этот marketplace зарегистрирован под именем, отличным от `acme-x-tools`, `claude plugin marketplace add` отказывает другому marketplace с именем `acme-x-tools` после его загрузки и сообщает `Can't use the marketplace name "acme-x-tools"`. Эта проверка требует Claude Code v2.1.290 или позже.

55 56

56Когда зарегистрированный marketplace перестаёт загружаться, потому что его имя имитирует официальное, `claude plugin list` и `/plugin` сообщают `Claude Code refuses the marketplace name "<name>"`. Сообщение говорит вам удалить marketplace. Удаление его также удаляет его плагины и удаляет их сохранённые данные. Это именованное сообщение об отказе требует Claude Code v2.1.282 или позже.57Когда зарегистрированный маркетплейс перестаёт загружаться из-за того, что его имя имитирует официальное, `claude plugin list` и `/plugin` сообщают `Claude Code refuses the marketplace name "<name>"`. Сообщение предлагает удалить маркетплейс. Удаление маркетплейса также деинсталлирует его плагины и стирает их сохранённые данные. Для этого именованного сообщения об отказе требуется Claude Code v2.1.282 или новее.

57 58

58<h2 id="top-level-fields">59<h2 id="top-level-fields">

59 Поля верхнего уровня60 Поля верхнего уровня

498| `Claude Code cannot install plugin "x". Each part of a plugin id (plugin@marketplace) may use only the letters a-z and A-Z, digits, ".", "_" and "-", and must start with a letter or digit. Change this entry's "name".` | Ошибка | `plugins[i].name` |499| `Claude Code cannot install plugin "x". Each part of a plugin id (plugin@marketplace) may use only the letters a-z and A-Z, digits, ".", "_" and "-", and must start with a letter or digit. Change this entry's "name".` | Ошибка | `plugins[i].name` |

502| `plugins.i.source: Invalid string: must start with "./"` | Ошибка | `source` с относительным путём без ведущего `./`. До v2.1.285 эта ошибка выводила вместо этого `Invalid input` |

524 526

525`Invalid input` на `source` означает, что объект не совпадал с типом источника. Проверьте эти причины:527`Invalid input` на `source` означает, что объект не совпадал с типом источника. Проверьте эти причины:

526 528

527* Относительный путь, который не начинается с `./`, кроме `"."` или [имени без префикса под `metadata.pluginRoot`](#relative-path-plugin-source)

528* `npm` `package`, содержащий `..`529* `npm` `package`, содержащий `..`

529* Тип `source`, который не является одним из [источников плагинов](#plugin-sources)530* Тип `source`, который не является одним из [источников плагинов](#plugin-sources)

530* Известный тип с отсутствующим обязательным полем или неправильного типа, такой как `github` без `repo`531* Известный тип с отсутствующим обязательным полем или неправильного типа, такой как `github` без `repo`

531 532

533Относительный путь, который не начинается с `./`, кроме `"."` или [имени без префикса под `metadata.pluginRoot`](#relative-path-plugin-source), завершается ошибкой `Invalid string: must start with "./"`. До v2.1.285 он выводил `Invalid input`, как и причины выше.

534

532<h3 id="failures-that-validation-doesn’t-catch">535<h3 id="failures-that-validation-doesn’t-catch">

533 Сбои, которые валидация не ловит536 Сбои, которые валидация не ловит

534</h3>537</h3>

plugins/mods/admin.md +57 −57

Details

25 Остановить загрузку установленных пользователем модов25 Остановить загрузку установленных пользователем модов

26</h2>26</h2>

27 27

28Чтобы предотвратить загрузку каждого мода, который приносят ваши пользователи, установите параметр `allowManagedModsOnly` на [встроенной защите](#know-what-happens-by-default), политическом моде, который Claude Code загружает перед каждым модом, установленным пользователем. Параметр находится в управляемых параметрах под `pluginConfigs`, с ключом `cc-plugin-sec-default@builtin`:28Чтобы ни один мод, который приносят ваши пользователи, не запускал свои хуки, установите параметр `allowManagedModsOnly` для [встроенного стража](#know-what-happens-by-default) — мода политики, который Claude Code загружает перед каждым модом, установленным пользователем. Параметр задаётся в управляемых настройках в `pluginConfigs` с ключом `cc-plugin-sec-default@builtin`:

29 29

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

31{31{

39}39}

40```40```

41 41

~~42С установленным параметром в управляемых параметрах:~~42Когда параметр установлен в управляемых настройках:

43 43

44* **Ни один мод, который приносит пользователь, не загружается**: это охватывает мод в плагине, установленном пользователем, мод, загруженный с помощью `--plugin-dir`, и мод, [который Claude написал во время сеанса](/docs/ru/plugins/mods/create#ask-claude-for-a-mod)44* **Ни один мод, который приносит пользователь, не запускает свои хуки**: это касается мода в плагине, установленном пользователем, мода, загруженного с помощью `--plugin-dir`, и мода, [который Claude написал во время сессии](/docs/ru/plugins/mods/create#ask-claude-for-a-mod)

45* **Моды вашей организации по-прежнему загружаются**: мод, который [считается модом вашей организации](#install-your-organizations-mods), не проверяется. Все остальные моды считаются модами пользователя и не загружаются. Это включает мод в плагине, который вы включаете из GitHub или другого удаленного маркетплейса, и мод, который ваша организация включает для своих членов на claude.ai. Если ни один не считается вашим, установленный мод не загружается.45* **Моды вашей организации по-прежнему работают**: мод, который [считается модом вашей организации](#install-your-organizations-mods), не проверяется. Все остальные моды считаются модами пользователя и отклоняются. Это включает мод в плагине, который вы включаете из GitHub или другого удаленного маркетплейса, и мод, который ваша организация включает для своих участников на claude.ai. Если ни один мод не считается вашим, ни один установленный мод не запускает свои хуки.

46* **Пользователи не могут это отменить**: защита читает параметр только из управляемых параметров, поэтому та же запись в файле параметров пользователя, проекта или локальных параметров или в файле, переданном с помощью `--settings`, ничего не меняет46* **Пользователи не могут это отменить**: страж читает параметр только из управляемых настроек, поэтому та же запись в файле настроек пользователя, проекта или локальных настроек или в файле, переданном с помощью `--settings`, ничего не меняет

47* **Файл или политика MDM охватывают каждого поставщика**: когда вы доставляете параметр в виде файла или через MDM, он работает одинаково на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry. Для доставки из консоли администратора claude.ai см. [Доступность платформы](/docs/ru/server-managed-settings#platform-availability)47* **Файл или политика MDM охватывают каждого поставщика**: когда вы доставляете параметр в виде файла или через MDM, он работает одинаково на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry. Для доставки из консоли администратора claude.ai см. [Доступность платформы](/docs/ru/server-managed-settings#platform-availability)

48* **Другие настройки пользователей продолжают работать**: их [hooks в файлах параметров](/docs/ru/hooks), строки состояния и `/goal` не затронуты48* **Другие настройки пользователей продолжают работать**: их [хуки в файлах настроек](/docs/ru/hooks) и в `hooks/hooks.json` плагинов, строки состояния и `/goal` не затрагиваются

49* **Встроенные моды продолжают работать**: моды, встроенные в Claude Code, такие как поддержка `AGENTS.md`, имеют [свой собственный переключатель](/docs/ru/plugins/mods/overview#mods-built-into-claude-code)49* **Встроенные моды продолжают работать**: у каждого из модов, встроенных в Claude Code, таких как поддержка `AGENTS.md`, есть [свой собственный переключатель](/docs/ru/plugins/mods/overview#mods-built-into-claude-code)

50 50

51Чтобы подтвердить параметр на машине пользователя, запустите Claude Code там с `--plugin-dir` и путем к каталогу, который содержит мод, например `claude --plugin-dir ./first-mod`. Hooks мода не запускаются, и транскрипт и журнал отладки содержат [сообщение защиты](/docs/ru/plugins/mods/troubleshoot#messages-from-the-built-in-guard), которое называет мод и `allowManagedModsOnly`. Если мод загружается, см. [Проверить, что политика действует](/docs/ru/managed-settings#check-that-a-policy-is-in-force) и [правила, которые определяют, вступает ли параметр в силу](#set-options-on-the-built-in-guard).51Чтобы проверить параметр на машине пользователя, запустите там Claude Code с `--plugin-dir` и путём к каталогу, который содержит мод, например `claude --plugin-dir ./first-mod`. Хуки мода не запускаются, а транскрипт и отладочный лог содержат [сообщение стража](/docs/ru/plugins/mods/troubleshoot#messages-from-the-built-in-guard), в котором указаны мод и `allowManagedModsOnly`. Если сообщения нет, см. [Проверить, что политика действует](/docs/ru/managed-settings#check-that-a-policy-is-in-force) и [правила, которые определяют, вступает ли параметр в силу](#set-options-on-the-built-in-guard).

52 52

53Если вы установили `CLAUDE_CODE_ENABLE_FUNCTION_HOOKS` на `0` во время раннего доступа, замените его этим параметром. Claude Code v2.1.287 и более поздние версии игнорируют переменную при любом значении, поэтому `0` там оставляет моды включенными.53Если вы установили `CLAUDE_CODE_ENABLE_FUNCTION_HOOKS` в `0` во время раннего доступа, замените его этим параметром. Claude Code v2.1.287 и более поздние версии игнорируют переменную при любом значении, поэтому `0` в ней оставляет моды включёнными.

54 54

55<h2 id="know-what-happens-by-default">55<h2 id="know-what-happens-by-default">

56 Узнать, что происходит по умолчанию56 Узнать, что происходит по умолчанию

117claude plugin validate ./some-mod117claude plugin validate ./some-mod

118```118```

119 119

120Две строки в выводе описывают код мода:120Строки `hooks:` и `calls:` в выводе описывают код мода:

121 121

122```text theme={null}122```text theme={null}

123 ❯ ./register.js hooks: session.start, tool.call, ui.render{component=Pane}123 ❯ ./register.js hooks: session.start, tool.call, ui.render{component=Pane}

146 Выбрать, сколько разрешить146 Выбрать, сколько разрешить

147</h2>147</h2>

148 148

149Политики модов варьируются от отсутствия установленных модов вообще до любого мода, который выбирает пользователь, с вашим собственным модом, проверяющим остальные, и каждая из них — это несколько управляемых параметров. Найдите политику, которую вы хотите, в первом столбце и установите то, что называет второй столбец. [Развертывание управляемых параметров](/docs/ru/managed-settings) охватывает, где находятся управляемые параметры.149Политики модов варьируются от полного отсутствия установленных модов до любого мода, который выбирает пользователь, при этом ваш собственный мод проверяет остальные, и каждая из них — это несколько управляемых настроек. Найдите нужную политику в первом столбце и задайте то, что указано во втором столбце. В разделе [Развертывание управляемых настроек](/docs/ru/managed-settings) описано, где находятся управляемые настройки.

150 150

151| Что вы хотите | Параметры |151| Что вы хотите | Настройки |

152| :- | :- |152| :- | :- |

153| Нет установленных модов, с hooks без изменений | Установите [`allowManagedModsOnly`](#set-options-on-the-built-in-guard) и не развертывайте моды вашей организации |153| Не выполняется ни один установленный мод, хуки настроек не затронуты | Задайте [`allowManagedModsOnly`](#set-options-on-the-built-in-guard) и не развертывайте собственных модов |

155| Только моды вашей организации | Установите параметр [`allowManagedModsOnly`](#stop-user-installed-mods-from-loading) защиты и [установите ваши моды](#install-your-organizations-mods), чтобы они считались вашими |155| Только моды вашей организации | Задайте [параметр стража `allowManagedModsOnly`](#stop-user-installed-mods-from-loading) и [установите ваши моды](#install-your-organizations-mods), чтобы они считались вашими |

156| Любой мод из маркетплейсов, которые вы одобряете | Сохраните ваши [ограничения маркетплейса](/docs/ru/plugins/org#restrict-what-users-can-install) и установите `disableSideloadFlags` на `true` |156| Любой мод из маркетплейсов, которые вы одобряете | Сохраните ваши [ограничения маркетплейсов](/docs/ru/plugins/org#restrict-what-users-can-install) и установите `disableSideloadFlags` в `true` |

157| Любой мод, с вашим собственным модом, проверяющим остальные | [Установите ваш мод](#install-your-organizations-mods) и перечислите его с `sec-default@builtin` в `prependPlugins` |157| Любой мод, при этом ваш собственный мод проверяет остальные | [Установите ваш мод](#install-your-organizations-mods) и перечислите его вместе с `sec-default@builtin` в `prependPlugins` |

158 158

159Что делает каждый параметр:159Что делает каждая настройка:

160 160

161* **`allowManagedModsOnly`**: параметр встроенной защиты. Моды пользователей не загружаются, и их hooks параметров, строки состояния и `/goal` продолжают работать. [Остановить загрузку установленных пользователем модов](#stop-user-installed-mods-from-loading) перечисляет, что он охватывает.161* **`allowManagedModsOnly`**: параметр встроенного стража. Claude Code отклоняет собственные моды пользователей, поэтому ни один из их хуков не выполняется. Хуки настроек пользователей, строки состояния и `/goal` продолжают работать. В разделе [Остановить загрузку установленных пользователем модов](#stop-user-installed-mods-from-loading) перечислено, что он охватывает.

162* **`allowManagedHooksOnly`**: более широкий параметр. Загружаются только [моды вашей организации](#install-your-organizations-mods) и моды, встроенные в Claude Code. Мод, который пользователь установил сам, не загружается. Параметр также блокирует hooks в собственных файлах параметров пользователей. Прочитайте [Что работает под `allowManagedHooksOnly`](/docs/ru/settings-reference#what-runs-under-allowmanagedhooksonly) перед тем, как установить его.162* **`allowManagedHooksOnly`**: более широкая настройка. Загружаются только [моды вашей организации](#install-your-organizations-mods) и моды, встроенные в Claude Code. Мод, который пользователь установил сам, не загружается. Настройка также блокирует хуки в собственных файлах настроек пользователей. Прочитайте [Что выполняется при `allowManagedHooksOnly`](/docs/ru/settings-reference#what-runs-under-allowmanagedhooksonly), прежде чем задавать её.

163* **`disableAllHooks`**: самый широкий параметр. В управляемых параметрах он останавливает моды в каждом установленном плагине, включая ваши, и отключает каждый hook в файлах параметров, поэтому hook `PreToolUse` в ваших управляемых параметрах больше ничего не блокирует. Пользовательские строки состояния и `/goal` также перестают работать. Прочитайте [`disableAllHooks`](/docs/ru/settings-reference#disableallhooks) перед тем, как установить его.163* **`disableAllHooks`**: самая широкая настройка. В управляемых настройках она останавливает моды в каждом установленном плагине, включая ваши, и отключает все хуки в файлах настроек, поэтому хук `PreToolUse` в ваших управляемых настройках больше ничего не блокирует. Пользовательские строки состояния и `/goal` также перестают работать. Прочитайте [`disableAllHooks`](/docs/ru/settings-reference#disableallhooks), прежде чем задавать её.

164* **`disableSideloadFlags`**: отклоняет `--plugin-dir` и `--plugin-url` при запуске и не позволяет загружаться модам, которые Claude пишет во время сессии. Настройка также отклоняет `--agents` и `--mcp-config`. Прочитайте [`disableSideloadFlags`](/docs/ru/settings-reference#disablesideloadflags), прежде чем задавать её.164* **`disableSideloadFlags`**: отклоняет `--plugin-dir` и `--plugin-url` при запуске и не позволяет загружаться модам, которые Claude пишет во время сессии. Настройка также отклоняет `--agents` и `--mcp-config`. Прочитайте [`disableSideloadFlags`](/docs/ru/settings-reference#disablesideloadflags), прежде чем задавать её.

165 165

166Моды, встроенные в Claude Code, такие как поддержка `AGENTS.md`, не затронуты этими параметрами. Каждый имеет [свой собственный переключатель](/docs/ru/plugins/mods/overview#mods-built-into-claude-code).166Моды, встроенные в Claude Code, такие как поддержка `AGENTS.md`, не затрагиваются этими настройками. У каждого из них есть [свой собственный переключатель](/docs/ru/plugins/mods/overview#mods-built-into-claude-code).

167 167

168Пользователь, чей мод не загрузился, найдет причину в своем журнале отладки. [Сообщения об отказе](/docs/ru/plugins/mods/troubleshoot#refusal-messages) перечисляет строки для `allowManagedHooksOnly` и `disableAllHooks`, и [Сообщения от встроенной защиты](/docs/ru/plugins/mods/troubleshoot#messages-from-the-built-in-guard) содержит строку для `allowManagedModsOnly`.168Пользователь, чей мод был отклонён или не загрузился, найдёт причину в своём логе отладки. В разделе [Сообщения об отказе](/docs/ru/plugins/mods/troubleshoot#refusal-messages) перечислены строки для `allowManagedHooksOnly` и `disableAllHooks`, а в разделе [Сообщения от встроенного стража](/docs/ru/plugins/mods/troubleshoot#messages-from-the-built-in-guard) приведена строка для `allowManagedModsOnly`.

169 169

170<h3 id="allow-only-your-organization’s-mods">170<h3 id="allow-only-your-organization’s-mods">

171 Разрешить только моды вашей организации171 Разрешить только моды вашей организации

193 193

194Каждая группа ключей выполняет одну задачу:194Каждая группа ключей выполняет одну задачу:

195 195

196* **`extraKnownMarketplaces`, `enabledPlugins` и `prependPlugins`**: устанавливают ваш мод так, чтобы он считался вашим, и запускают его первым, а защиту — после него. В разделе [Установить моды вашей организации и задать порядок](#install-your-organizations-mods) описан каталог, на который указывают эти ключи.196* **`extraKnownMarketplaces`, `enabledPlugins` и `prependPlugins`**: устанавливают ваш мод так, чтобы он считался вашим, и запускают его первым, а стража — после него. В разделе [Установить моды вашей организации и задать порядок](#install-your-organizations-mods) описан каталог, на который указывают эти ключи.

197* **`pluginConfigs`**: задаёт параметр защиты `allowManagedModsOnly`, поэтому Claude Code отклоняет собственные моды пользователей. Их хуки из настроек, строки состояния и `/goal` продолжают работать.197* **`pluginConfigs`**: задаёт параметр стража `allowManagedModsOnly`, поэтому Claude Code отклоняет собственные моды пользователей. Их хуки настроек, строки состояния и `/goal` продолжают работать.

198* **`disableSideloadFlags`**: см. [`disableSideloadFlags`](/docs/ru/settings-reference#disablesideloadflags), чтобы узнать, какие флаги она отклоняет при запуске198* **`disableSideloadFlags`**: см. [`disableSideloadFlags`](/docs/ru/settings-reference#disablesideloadflags), чтобы узнать, какие флаги она отклоняет при запуске

199 199

200Чтобы проверить политику на тестовой машине, запустите в оболочке сессию с `claude --debug` и прочитайте лог отладки:200Чтобы проверить политику на тестовой машине, запустите в оболочке сессию с `claude --debug` и прочитайте лог отладки:

219* **Предложить моды, которые могут устанавливать ваши пользователи**: [Размещение маркетплейса](/docs/ru/plugins/host-marketplace). Мод, который Claude Code копирует из источника GitHub, git, URL или npm, считается модом пользователя, а не [вашей организации](#install-your-organizations-mods).219* **Предложить моды, которые могут устанавливать ваши пользователи**: [Размещение маркетплейса](/docs/ru/plugins/host-marketplace). Мод, который Claude Code копирует из источника GitHub, git, URL или npm, считается модом пользователя, а не [вашей организации](#install-your-organizations-mods).

220 220

221<h3 id="set-options-on-the-built-in-guard">221<h3 id="set-options-on-the-built-in-guard">

222 Установить параметры на встроенной защите222 Задать параметры встроенного стража

223</h3>223</h3>

224 224

225Встроенная защита принимает параметры. Задайте их в управляемых настройках в `pluginConfigs` под ключом `cc-plugin-sec-default@builtin`, как это сделано в примере в разделе [Остановить загрузку установленных пользователем модов](#stop-user-installed-mods-from-loading).225Встроенный страж принимает параметры. Задайте их в управляемых настройках в `pluginConfigs` под ключом `cc-plugin-sec-default@builtin`, как это сделано в примере в разделе [Остановить загрузку установленных пользователем модов](#stop-user-installed-mods-from-loading).

226 226

227Таблица показывает, что получают ваши пользователи с каждым параметром не установленным и установленным на `true`:227В таблице показано, что получают ваши пользователи, когда каждый параметр не задан и когда он установлен в `true`:

228 228

230| :- | :- | :- |230| :- | :- | :- |

231| `allowManagedModsOnly` | Моды пользователей загружаются | Загружаются только [моды вашей организации](#install-your-organizations-mods) и моды, встроенные в Claude Code. Claude Code отказывает каждому другому моду, включая мод, установленный пользователем или названный с помощью `--plugin-dir`. |231| `allowManagedModsOnly` | Собственные моды пользователей выполняются | Только [моды вашей организации](#install-your-organizations-mods) и моды, встроенные в Claude Code, выполняют свои хуки. Claude Code отклоняет все остальные моды, включая мод, установленный пользователем или указанный с помощью `--plugin-dir`. |

232| `allowModsToOverrideDenyRules` | Правила отказа имеют приоритет над модами пользователей | Мод пользователя, который одобряет вызовы инструментов, может одобрить вызов, который правило `deny` отказывает |232| `allowModsToOverrideDenyRules` | Правила запрета имеют приоритет над модами пользователей | Мод пользователя, который одобряет вызовы инструментов, может одобрить вызов, отклоняемый правилом `deny` |

233 233

234Эти правила определяют, вступает ли параметр в силу:234Эти правила определяют, вступает ли параметр в силу:

235 235

236* **Здесь id имеет только одну форму**: Claude Code читает параметры только под `cc-plugin-sec-default@builtin`. `prependPlugins` также принимает `sec-default@builtin`, а `pluginConfigs` — нет.236* **Здесь id имеет только одну форму**: Claude Code читает параметры только под `cc-plugin-sec-default@builtin`. `prependPlugins` также принимает `sec-default@builtin`, а `pluginConfigs` — нет.

237* **Считаются только управляемые параметры**: та же запись в файле параметров пользователя, проекта или локальных параметров или в файле, переданном с помощью `--settings`, ни устанавливает параметр, ни ослабляет его237* **Учитываются только управляемые настройки**: та же запись в файле настроек пользователя, проекта или локальных настроек либо в файле, переданном с помощью `--settings`, не задаёт параметр и не ослабляет его

238* **Защита должна загружаться**: если вы установите `prependPlugins`, [назовите защиту в списке](#install-your-organizations-mods). Где защита не загружается, ни один параметр не применяется.238* **Страж должен загружаться**: если вы задаёте `prependPlugins`, [укажите стража в списке](#install-your-organizations-mods). Там, где страж не загружается, не применяется ни один из параметров.

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

240 240

241[Сообщения от встроенной защиты](/docs/ru/plugins/mods/troubleshoot#messages-from-the-built-in-guard) — это то, что видят ваши пользователи, когда применяется любой параметр.241[Сообщения от встроенного стража](/docs/ru/plugins/mods/troubleshoot#messages-from-the-built-in-guard) — это то, что видят ваши пользователи, когда применяется любой из параметров.

242 242

243<h2 id="run-your-organization’s-own-mods">243<h2 id="run-your-organization’s-own-mods">

244 Развертывание собственных модов вашей организации244 Развертывание собственных модов вашей организации

253Моды вашей организации загружаются там, где не загружаются моды пользователей, и могут выполняться перед ними, поэтому Claude Code должен иметь возможность определить, что мод поступил от вас. Он рассматривает мод как принадлежащий вашей организации только в том случае, если все следующие условия верны:253Моды вашей организации загружаются там, где не загружаются моды пользователей, и могут выполняться перед ними, поэтому Claude Code должен иметь возможность определить, что мод поступил от вас. Он рассматривает мод как принадлежащий вашей организации только в том случае, если все следующие условия верны:

254 254

255* Управляемый `enabledPlugins` устанавливает плагин мода в `true`255* Управляемый `enabledPlugins` устанавливает плагин мода в `true`

256* Управляемые параметры называют [marketplace](/docs/ru/plugins/create-marketplace) плагина как каталог на машине пользователя по абсолютному пути. Запись `extraKnownMarketplaces` делает это и также регистрирует marketplace для пользователя.256* Управляемые настройки называют [маркетплейс](/docs/ru/plugins/create-marketplace) плагина как каталог на машине пользователя по абсолютному пути. Запись `extraKnownMarketplaces` делает это и также регистрирует маркетплейс для пользователя.

257* Marketplace указывает плагин по относительному пути, поэтому Claude Code [загружает его на месте](/docs/ru/plugins/loading#in-place-and-copied-plugins) из этого каталога257* Маркетплейс указывает плагин по относительному пути, поэтому Claude Code [загружает его на месте](/docs/ru/plugins/loading#in-place-and-copied-plugins) из этого каталога

258 258

259Чтобы выполнить эти условия, скопируйте каталог marketplace на одинаковый путь на каждой машине с помощью управления устройствами. Сделайте каталог и каждый каталог выше него доступными для записи только администратором, как и файл управляемых параметров. Любой, кто может писать туда, может переписать ваш мод. Управляемые параметры, которые вы доставляете из консоли администратора claude.ai, могут содержать ключи, но они не могут поместить каталог на машину.259Чтобы выполнить эти условия, скопируйте каталог маркетплейса на одинаковый путь на каждой машине с помощью управления устройствами. Сделайте каталог и каждый каталог выше него доступными для записи только администратором, как и файл управляемых настроек. Любой, кто может писать туда, может переписать ваш мод. Управляемые настройки, которые вы доставляете из консоли администратора claude.ai, могут содержать ключи, но они не могут поместить каталог на машину.

260 260

261Каталог содержит манифест marketplace и плагин:261Каталог содержит манифест маркетплейса и плагин:

262 262

263```text theme={null}263```text theme={null}

264/opt/acme/claude-plugins/264/opt/acme/claude-plugins/

285}285}

286```286```

287 287

288Плагин, который Claude Code копирует в свой кэш, считается плагином пользователя, даже если управляемый `enabledPlugins` его включает. Это охватывает каждый плагин из источника GitHub, git, URL или npm. Его мод выполняется среди модов пользователей, `prependPlugins` и `appendPlugins` его пропускают, и он не загружается под `allowManagedModsOnly` или `allowManagedHooksOnly`. В журнале отладки пользователя есть строка, которая начинается с идентификатора плагина и `is enabled by managed settings, but`.288Плагин, который Claude Code копирует в свой кэш, считается плагином пользователя, даже если управляемый `enabledPlugins` его включает. Это охватывает каждый плагин из источника GitHub, git, URL или npm. Его мод выполняется среди модов пользователей, `prependPlugins` и `appendPlugins` его пропускают, `allowManagedModsOnly` отказывает ему, а `allowManagedHooksOnly` не дает ему загрузиться. В логе отладки пользователя есть строка, которая начинается с идентификатора плагина и `is enabled by managed settings, but`.

289 289

290Claude Code вызывает событие каждый раз, когда он собирается действовать, например запустить инструмент, и передает его каждому моду по очереди. Мод, который считается вашим, [выполняется перед модами пользователей](/docs/ru/plugins/mods/events#the-order-mods-run-in), даже если вы его нигде не указываете. Чтобы задать его место, укажите его идентификатор в одной из двух настроек. Идентификатор — это имя плагина, `@` и имя маркетплейса, например `acme-guard@acme-tools`.290Claude Code вызывает событие каждый раз, когда он собирается действовать, например запустить инструмент, и передает его каждому моду по очереди. Мод, который считается вашим, [выполняется перед модами пользователей](/docs/ru/plugins/mods/events#the-order-mods-run-in), даже если вы его нигде не указываете. Чтобы задать его место, укажите его идентификатор в одной из двух настроек. Идентификатор — это имя плагина, `@` и имя маркетплейса, например `acme-guard@acme-tools`.

291 291

292* **`prependPlugins`**: ваш мод видит каждое событие перед любым модом пользователя и каждый результат после. Он может изменить событие, отказать в нем или пропустить моды пользователей.292* **`prependPlugins`**: ваш мод видит каждое событие перед любым модом пользователя и каждый результат после. Он может изменить событие, отказать в нем или пропустить моды пользователей.

293* **`appendPlugins`**: ваш мод выполняется после каждого мода пользователя, поэтому он видит только события, которые эти моды передают, в форме, в которой они их передают293* **`appendPlugins`**: ваш мод выполняется после каждого мода пользователя, поэтому он видит только события, которые эти моды передают, в форме, в которой они их передают

294 294

295Этот пример объявляет marketplace `acme-tools` в `/opt/acme/claude-plugins`, включает `acme-guard` из него и запускает этот мод первым, со встроенной защитой после него:295Этот пример объявляет маркетплейс `acme-tools` в `/opt/acme/claude-plugins`, включает `acme-guard` из него и запускает этот мод первым, со встроенным стражем после него:

296 296

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

298{298{

308 308

309Каждый ключ выполняет одну работу:309Каждый ключ выполняет одну работу:

310 310

311* **`extraKnownMarketplaces`**: называет каталог, который содержит marketplace `acme-tools`. `path` — это абсолютный путь каталога, который содержит `.claude-plugin/marketplace.json`.311* **`extraKnownMarketplaces`**: называет каталог, который содержит маркетплейс `acme-tools`. `path` — это абсолютный путь каталога, который содержит `.claude-plugin/marketplace.json`.

312* **`enabledPlugins`**: включает `acme-guard` для каждого пользователя, который получает эти управляемые параметры312* **`enabledPlugins`**: включает `acme-guard` для каждого пользователя, который получает эти управляемые настройки

313* **`prependPlugins`**: ставит `acme-guard` первым и встроенную защиту второй, обе впереди любого мода, который устанавливает пользователь. Claude Code следует порядку, который вы указываете.313* **`prependPlugins`**: ставит `acme-guard` первым и встроенного стража вторым, оба впереди любого мода, который устанавливает пользователь. Claude Code следует порядку, который вы указываете.

314 314

315Чтобы подтвердить, что машина пользователя получила параметры, см. [Проверка того, что политика действует](/docs/ru/managed-settings#check-that-a-policy-is-in-force).315Чтобы подтвердить, что машина пользователя получила настройки, см. [Проверка того, что политика действует](/docs/ru/managed-settings#check-that-a-policy-is-in-force).

316 316

317Чтобы подтвердить, где выполняется мод, запустите сеанс на этой машине с `claude --debug` и найдите в [журнале отладки](/docs/ru/plugins/mods/troubleshoot#read-the-debug-log) идентификатор мода:317Чтобы подтвердить, где выполняется мод, запустите сессию на этой машине с `claude --debug` и найдите в [логе отладки](/docs/ru/plugins/mods/troubleshoot#read-the-debug-log) идентификатор мода:

318 318

319* **`hooks module acme-guard@acme-tools loaded`, с `tier prepend`**: мод считается принадлежащим вашей организации и выполняется первым319* **`hooks module acme-guard@acme-tools loaded`, с `tier prepend`**: мод считается принадлежащим вашей организации и выполняется первым

320* **Та же строка с `tier user`**: Claude Code рассматривает его как мод пользователя. Вторая строка, `prependPlugins names acme-guard@acme-tools, which is not an enabled managed plugin with a hooks module; skipped`, говорит, что список его пропустил.320* **Та же строка с `tier user`**: Claude Code рассматривает его как мод пользователя. Вторая строка, `prependPlugins names acme-guard@acme-tools, which is not an enabled managed plugin with a hooks module; skipped`, говорит, что список его пропустил.

321 321

322Эти правила определяют, какие идентификаторы в двух списках вступают в силу:322Эти правила определяют, какие идентификаторы в двух списках вступают в силу:

323 323

324* **Список заменяет значение по умолчанию**: когда вы устанавливаете `prependPlugins` в управляемых параметрах, назовите `sec-default@builtin` в нем, чтобы сохранить встроенную защиту. Защита встроена и не требует записи `enabledPlugins`.324* **Список заменяет значение по умолчанию**: когда вы задаете `prependPlugins` в управляемых настройках, укажите в нем `sec-default@builtin`, чтобы сохранить встроенного стража. Страж встроен и не требует записи `enabledPlugins`.

325* **Ваши собственные идентификаторы должны считаться вашими**: в управляемых настройках Claude Code пропускает идентификатор, чей плагин не соответствует условиям для мода организации325* **Ваши собственные идентификаторы должны считаться вашими**: в управляемых настройках Claude Code пропускает идентификатор, чей плагин не соответствует условиям для мода организации

326* **Репозитории не могут их устанавливать**: Claude Code читает оба параметра из управляемых параметров и никогда из файла параметров репозитория. Пользователь может установить их в `~/.claude/settings.json`, чтобы упорядочить только свои моды на машине без управляемых параметров, и только если они не вошли в систему с планом Team или Enterprise. В любом другом месте Claude Code игнорирует оба ключа в параметрах пользователя. Список там ни не добавляет, ни не удаляет встроенную защиту.326* **Репозитории не могут их задавать**: Claude Code читает обе настройки из управляемых настроек и никогда из файла настроек репозитория. Пользователь может задать их в `~/.claude/settings.json`, чтобы упорядочить только свои моды на машине без управляемых настроек, и только если он не вошел в систему с планом Team или Enterprise. В любом другом месте Claude Code игнорирует оба ключа в пользовательских настройках. Список там не добавляет и не удаляет встроенного стража.

327 327

328<h3 id="enforce-a-policy-with-a-mod-of-your-own">328<h3 id="enforce-a-policy-with-a-mod-of-your-own">

329 Обеспечение политики с помощью собственного мода329 Обеспечение политики с помощью собственного мода

333 333

334Каждый раз, когда другой мод собирается загрузиться, ваш мод получает список, который печатает `claude plugin validate`, в событии с именем [`plugin.register`](/docs/ru/plugins/mods/reference#other-mods). Мод в `prependPlugins` может прочитать этот список и отказать в загрузке мода. Он также может [обработать любой вызов API модов по имени](/docs/ru/plugins/mods/api#reach-files-processes-and-the-network), чтобы записать этот вызов или отказать в нем для каждого другого мода. Имя — это метод без `$.`, поэтому хук на `fs.write` видит каждый вызов `$.fs.write`.334Каждый раз, когда другой мод собирается загрузиться, ваш мод получает список, который печатает `claude plugin validate`, в событии с именем [`plugin.register`](/docs/ru/plugins/mods/reference#other-mods). Мод в `prependPlugins` может прочитать этот список и отказать в загрузке мода. Он также может [обработать любой вызов API модов по имени](/docs/ru/plugins/mods/api#reach-files-processes-and-the-network), чтобы записать этот вызов или отказать в нем для каждого другого мода. Имя — это метод без `$.`, поэтому хук на `fs.write` видит каждый вызов `$.fs.write`.

335 335

336Этот мод политики отказывает любому моду пользователя, чей собственный код вызывает `$.process.run` или `$.process.spawn`. Он также ведет журнал аудита, записывая каждый вызов инструмента и каждый файл, который мод записывает, в журнал отладки. Поскольку он выполняется первым, журнал записывает то, что было запрошено, перед тем как любой мод пользователя его изменит. Сохраните его как `acme-guard/hooks/register.js`:336Этот мод политики отказывает любому моду пользователя, чей собственный код вызывает `$.process.run` или `$.process.spawn`. Он также ведет журнал аудита, записывая каждый вызов инструмента и каждый файл, который мод записывает, в лог отладки. Поскольку он выполняется первым, лог записывает то, что было запрошено, перед тем как любой мод пользователя это изменит. Сохраните его как `acme-guard/hooks/register.js`:

337 337

338```javascript acme-guard/hooks/register.js theme={null}338```javascript acme-guard/hooks/register.js theme={null}

339// The methods no user's mod may call, each spelled namespace.method339// The methods no user's mod may call, each spelled namespace.method

366}366}

367```367```

368 368

369Файл регистрирует три перехвата:369Файл регистрирует три хука:

370 370

371* **`plugin.register`**: решает, загружается ли другой мод. Он отказывает моду пользователя, который вызывает заблокированный метод, и передает каждый другой мод дальше.371* **`plugin.register`**: решает, загружается ли другой мод. Он отказывает моду пользователя, который вызывает заблокированный метод, и передает каждый другой мод дальше.

372* **`tool.call`**: записывает строку, такую как `audit tool.call Bash`, в журнал отладки для каждого вызова инструмента и ничего не изменяет372* **`tool.call`**: записывает строку, такую как `audit tool.call Bash`, в лог отладки для каждого вызова инструмента и ничего не изменяет

373* **`fs.write`**: записывает строку, такую как `audit fs.write by reader "/tmp/notes.md"`, для каждого вызова `$.fs.write`, который делает другой мод, и ничего не изменяет. Имя мода идет первым, а путь заключен в кавычки, поэтому путь, который выбирает мод, не может выдать себя за другое поле строки.373* **`fs.write`**: записывает строку, такую как `audit fs.write by reader "/tmp/notes.md"`, для каждого вызова `$.fs.write`, который делает другой мод, и ничего не изменяет. Имя мода идет первым, а путь заключен в кавычки, поэтому путь, который выбирает мод, не может выдать себя за другое поле строки.

374 374

375Перехват `plugin.register` читает два поля события:375Хук `plugin.register` читает два поля события:

376 376

377* **`e.tier`**: где будет выполняться мод, один из `prepend`, `user`, `append` или `builtin`. Каждый мод, который устанавливает человек, — это `user`.377* **`e.tier`**: где будет выполняться мод, один из `prepend`, `user`, `append` или `builtin`. Каждый мод, который устанавливает человек, — это `user`.

378* **`e.uses.calls`**: методы API модов, которые вызывает мод, каждый записан как `namespace.method`, например `process.run`, без `$.`, который печатает `claude plugin validate`378* **`e.uses.calls`**: методы API модов, которые вызывает мод, каждый записан как `namespace.method`, например `process.run`, без `$.`, который печатает `claude plugin validate`

379 379

380Когда пользователь устанавливает мод, который вызывает `$.process.run`, мод не загружается, и в его журнале отладки есть строка, которая заканчивается на `refused by acme-guard:` и ваша причина. Отказ также достигает стенограммы в [сеансе, который горячо перезагружает каталог плагина](/docs/ru/plugins/mods/troubleshoot#find-out-why-a-mod-does-nothing). Чтобы заблокировать вызов без отказа всему моду, верните `{ deny: 'your reason' }` из перехвата на имя этого вызова.380Когда пользователь устанавливает мод, который вызывает `$.process.run`, мод не загружается, и в его логе отладки есть строка, которая заканчивается на `refused by acme-guard:` и вашу причину. Отказ также попадает в транскрипт в [сессии, которая выполняет горячую перезагрузку каталога плагина](/docs/ru/plugins/mods/troubleshoot#find-out-why-a-mod-does-nothing). Чтобы заблокировать вызов без отказа всему моду, верните `{ deny: 'your reason' }` из хука на имя этого вызова.

381 381

382Чтобы отправить строки аудита куда-то, кроме журнала отладки, вызовите `$.http.fetch` из тех же перехватов.382Чтобы отправить строки аудита куда-то, кроме лога отладки, вызовите `$.http.fetch` из тех же хуков.

383 383

384Сеанс может выполняться без вашего мода. Если рабочий поток, который запускает установленные моды, [падает три раза](/docs/ru/plugins/mods/troubleshoot#mods-that-run-in-the-hooks-worker-are-off-for-this-session), Claude Code выгружает каждый мод, который не встроен, включая ваш, пока пользователь не запустит `/reload-plugins` или не начнет новый сеанс. И пользователь, который запускает Claude Code с `--safe-mode`, выполняется без установленных модов, включая ваш.384Сессия может выполняться без вашего мода. Если рабочий поток, который запускает установленные моды, [падает три раза](/docs/ru/plugins/mods/troubleshoot#mods-that-run-in-the-hooks-worker-are-off-for-this-session), Claude Code выгружает каждый мод, который не встроен, включая ваш, пока пользователь не запустит `/reload-plugins` или не начнет новую сессию. А пользователь, который запускает Claude Code с `--safe-mode`, работает без установленных модов, включая ваш.

385 385

386[Создание мода](/docs/ru/plugins/mods/create) описывает файлы, которые нужны моду. [Тестирование мода политики](/docs/ru/plugins/mods/test#test-a-mod-that-judges-other-mods) содержит файл теста для этого мода политики.386[Создание мода](/docs/ru/plugins/mods/create) описывает файлы, которые нужны моду. [Тестирование мода политики](/docs/ru/plugins/mods/test#test-a-mod-that-judges-other-mods) содержит файл теста для этого мода политики.

387 387

388<h4 id="refuse-mods-when-your-check-fails">388<h4 id="refuse-mods-when-your-check-fails">

389 Отказ в загрузке модов, когда ваша проверка не удается389 Отказ в загрузке модов при сбое вашей проверки

390</h4>390</h4>

391 391

392Если ваш хук `plugin.register` выбросит исключение или превысит лимит времени, Claude Code пропускает хук, поэтому при сбое проверка остается открытой (fail open), и мод, который она проверяла, загружается. Чтобы при сбое закрывать доступ (fail closed) и отказывать в загрузке модов пользователей, переместите проверку в именованную функцию и добавьте обработчик `.catch`, который возвращает отказ. Эта версия файла показывает только хук `plugin.register`, поэтому сохраните два хука аудита из первой версии в `register`:392Если ваш хук `plugin.register` выбросит исключение или превысит лимит времени, Claude Code пропускает хук, поэтому при сбое проверка остается открытой (fail open), и мод, который она проверяла, загружается. Чтобы при сбое закрывать доступ (fail closed) и отказывать в загрузке модов пользователей, переместите проверку в именованную функцию и добавьте обработчик `.catch`, который возвращает отказ. Эта версия файла показывает только хук `plugin.register`, поэтому сохраните два хука аудита из первой версии в `register`:

414}414}

415```415```

416 416

417С обработчиком на месте мод, который проверялся, когда проверка выбросила исключение или истекло время, не загружается, и строка отказа содержит вторую причину, как в `refused by acme-guard: Acme policy check failed, so this mod was not loaded`. Обработчик передает каждый мод вне уровня `user` к `next(e)`, поэтому неудачная проверка не останавливает моды, которые указывает ваша организация. [Обработка перехвата, который не удается](/docs/ru/plugins/mods/events#handle-a-hook-that-fails) охватывает `.catch` для других событий.417С обработчиком на месте мод, который проверялся, когда проверка выбросила исключение или истекло время, не загружается, и строка отказа содержит вторую причину, как в `refused by acme-guard: Acme policy check failed, so this mod was not loaded`. Обработчик передает каждый мод вне уровня `user` в `next(e)`, поэтому неудачная проверка не останавливает моды, которые указывает ваша организация. [Обработка хука, завершившегося сбоем](/docs/ru/plugins/mods/events#handle-a-hook-that-fails) описывает `.catch` для других событий.

418 418

419<h2 id="next-steps">419<h2 id="next-steps">

420 Следующие шаги420 Следующие шаги

plugins/mods/api.md +15 −6

Details

71 71

72Когда вы спрашиваете о билете, Claude может вызвать `mcp__my-mod__ticket` с его id. Второй hook получает билет и возвращает тело ответа, которое Claude читает как результат инструмента. Когда сервер отвечает с кодом ошибки, Claude читает `Lookup failed with status` и номер.72Когда вы спрашиваете о билете, Claude может вызвать `mcp__my-mod__ticket` с его id. Второй hook получает билет и возвращает тело ответа, которое Claude читает как результат инструмента. Когда сервер отвечает с кодом ошибки, Claude читает `Lookup failed with status` и номер.

73 73

74<Tip>

75 Когда [MCP Tool Search](/docs/ru/mcp#scale-with-mcp-tool-search) откладывает зарегистрированный инструмент, Claude видит его имя, но не видит описание, пока не выполнит его поиск. Если Claude должен учитывать инструмент на каждом ходе, добавьте [`isDeferred: false`](/docs/ru/plugins/mods/reference#tools) к регистрации, чтобы [загружать полный инструмент заранее](/docs/ru/mcp#exempt-a-server-from-deferral). Это поле требует Claude Code v2.1.293 или более поздней версии, а более ранние версии его игнорируют.

76</Tip>

74<h2 id="call-a-model">78<h2 id="call-a-model">

75 Вызов модели79 Вызов модели

76</h2>80</h2>

187 Доступ к файлам, процессам и сети191 Доступ к файлам, процессам и сети

188</h2>192</h2>

189 193

190Mod получает доступ к файловой системе, процессам и сети через mods API с теми же разрешениями, что и пользователь, запускающий Claude Code. Сам модуль hooks не имеет API Node.js, нет глобальных таймеров, таких как `setTimeout`, и нет собственного доступа к сети или файлам. Доступны стандартный JavaScript и веб-API, такие как `URL`, `TextEncoder`, `AbortController` и `crypto.subtle`. Каждое пространство имён ниже охватывает один вид доступа:194Мод получает доступ к файловой системе, процессам и сети через API модов с теми же разрешениями, что и пользователь, запускающий Claude Code. Сам модуль хуков не имеет API Node.js, нет глобальных таймеров, таких как `setTimeout`, и нет собственного доступа к сети или файлам. Доступны стандартный JavaScript и веб-API, такие как `URL`, `TextEncoder`, `AbortController` и `crypto.subtle`. Каждое пространство имён ниже охватывает один вид доступа:

191 195

192| Пространство имён | Что оно делает |196| Пространство имён | Что оно делает |

193| :- | :- |197| :- | :- |

194| `$.fs` | `read(path)`, `write(path, text)`, `exists(path)`, `stat(path)` и `list(path)` работают с файлами и каталогами |198| `$.fs` | `read(path)`, `write(path, text)`, `exists(path)`, `stat(path)` и `list(path)` работают с файлами и каталогами |

195| `$.process` | `run(['git', 'status'])` запускает команду и разрешается при выходе. `spawn` потоком выводит долгоживущую команду. |199| `$.process` | `run(['git', 'status'])` запускает команду и разрешается при выходе. `spawn` потоком выводит долгоживущую команду. |

196| `$.http` | `fetch(url, init)` по `http` или `https`. Он разрешается в `{ status, ok, headers, text }` после прочтения тела. |200| `$.http` | `fetch(url, init)` по `http` или `https`. Он разрешается в `{ status, ok, headers, text }` после прочтения тела. |

198| `$.env` | `get` и `set` переменные окружения. Напишите имя как буквальную строку. |202| `$.env` | `get` и `set` переменные окружения. Напишите имя как буквальную строку. |

200| `$.session` | `messages()` возвращает стенограмму как список `{ role, text, toolUses }`. Также рабочий каталог, модель и многое другое. [`usage()`](/docs/ru/plugins/mods/reference#mods-api-methods) возвращает использование контекстного окна и ограничения плана. |204| `$.session` | `messages()` возвращает транскрипт как список `{ role, text, toolUses }`. Также рабочий каталог, модель и многое другое. [`usage()`](/docs/ru/plugins/mods/reference#mods-api-methods) возвращает использование контекстного окна и ограничения плана. |

201| `$.mcp` | `call` инструмент на подключённом MCP сервере |205| `$.mcp` | `call` инструмент на подключённом MCP-сервере |

202 206

203Файлы и процессы имеют несколько собственных правил:207Файлы и процессы имеют несколько собственных правил:

204 208

206* **`$.fs.list`**: возвращает записи одного каталога как `{ name, kind, size, isLink }` и не спускается в подкаталоги210* **`$.fs.list`**: возвращает записи одного каталога как `{ name, kind, size, isLink }` и не спускается в подкаталоги

207* **`$.process.run`**: принимает список аргументов и не использует оболочку. Он разрешается в `{ exitCode, stdout, stderr }` независимо от кода выхода. Он отклоняется, если программа не может запуститься или всё ещё выполняется при истечении времени ожидания, которое по умолчанию составляет 30 секунд, поэтому оберните его в `try` и `catch`.211* **`$.process.run`**: принимает список аргументов и не использует оболочку. Он разрешается в `{ exitCode, stdout, stderr }` независимо от кода выхода. Он отклоняется, если программа не может запуститься или всё ещё выполняется при истечении времени ожидания, которое по умолчанию составляет 30 секунд, поэтому оберните его в `try` и `catch`.

208 212

209Каждый из этих вызовов сам по себе является событием, названным по его пространству имён и методу без `$.`, например `fs.read` для `$.fs.read`. Mod [ранее в цепи](/docs/ru/plugins/mods/events#the-order-mods-run-in) может наблюдать, переписывать или отказывать ваш вызов, что является тем, как организация ограничивает то, что mods достигают.213Каждый из этих вызовов сам по себе является событием, названным по его пространству имён и методу без `$.`, например `fs.read` для `$.fs.read`. Мод [ранее в цепи](/docs/ru/plugins/mods/events#the-order-mods-run-in) может наблюдать, переписывать или отклонять ваш вызов — именно так организация ограничивает то, к чему моды получают доступ.

214

215Мод может отклонить ваш вызов `$.process.spawn` уже после того, как команда выдала вывод или завершилась, и ничего из сделанного командой не отменяется. В этом случае вызов отклоняется с сообщением, которое заканчивается одной из этих строк и причиной, указанной отклонившим модом:

216

217* **`$.process.spawn started, and a plugin withheld its result:`**: отклонивший мод не дочитал вывод команды до конца. Claude Code останавливает команду, если она всё ещё выполняется.

218* **`$.process.spawn ran, and a plugin withheld its result:`**: отклонивший мод дочитал вывод команды до конца, поэтому команда уже завершилась

210 219

211<h2 id="next-steps">220<h2 id="next-steps">

212 Следующие шаги221 Следующие шаги

plugins/mods/create.md +1 −1

Details

316✔ Validation passed316✔ Validation passed

317```317```

318 318

319Строка `hooks:` перечисляет события, которые ваш модуль hook, каждое с его фильтром в скобках. Строка `calls:` перечисляет каждый метод API модов, который он вызывает. Модуль, который читает или устанавливает переменные окружения, также получает строки `env reads:` и `env writes:`, и тот, который использует [`$.state`](/docs/ru/plugins/mods/interface#keep-state), получает `state reads:` и `state writes:`.319Найдите в строке `hooks:` события, на которые ваш модуль устанавливает хуки, каждое с его фильтром в фигурных скобках, а в строке `calls:` — каждый метод API модов, который он вызывает. Если ваш модуль читает или устанавливает переменные окружения, ищите также строки `env reads:` и `env writes:`, а если он использует [`$.state`](/docs/ru/plugins/mods/interface#keep-state) — строки `state reads:` и `state writes:`. Вы также видите по одной строке для каждого хука, который может отклонить действие, например `gating hook without .catch: tool.call`, которая сообщает, есть ли у этого хука [обработчик `.catch`](/docs/ru/plugins/mods/events#handle-a-hook-that-fails).

320 320

321Если событие, которое вы хотели обработать, отсутствует в первой строке, Claude Code также не будет вызывать этот хук. Обычная причина — неправильное написание имени события, которое команда сообщает как ошибку, такую как `"tool.calls" is not an event`.321Если событие, которое вы хотели обработать, отсутствует в первой строке, Claude Code также не будет вызывать этот хук. Обычная причина — неправильное написание имени события, которое команда сообщает как ошибку, такую как `"tool.calls" is not an event`.

322 322

plugins/mods/events.md +32 −16

Details

245 245

246Когда вы отправляете промпт, например `open a PR for this change`, ваше сообщение в транскрипте выглядит так же, а Claude после него также читает строку вида `Current branch: feature/auth`. Промпт, который не упоминает pull request, проходит без изменений, и `git` не запускается.246Когда вы отправляете промпт, например `open a PR for this change`, ваше сообщение в транскрипте выглядит так же, а Claude после него также читает строку вида `Current branch: feature/auth`. Промпт, который не упоминает pull request, проходит без изменений, и `git` не запускается.

247 247

248Чтобы остановить промпт, верните `{ drop: 'the reason' }`, не вызывая `next`. Если ваш хук возвращает `drop` после того, как его вызов `next(e)` уже пропустил промпт, ход всё равно выполняется, а хук [завершается ошибкой](#handle-a-hook-that-fails) с сообщением, содержащим `a drop after its next() was answered`.

249

248[Другие события](/docs/ru/plugins/mods/reference#prompts-and-what-claude-reads) охватывают остальное, что читает Claude: `prompt.section` для каждого раздела системного промпта, `prompt.context` для контекста, отправляемого с первым сообщением, и `skill.prompt` для текста скилла. Текст из этих хуков, меняющийся между запросами, [делает недействительным кэш промптов](/docs/ru/prompt-caching).250[Другие события](/docs/ru/plugins/mods/reference#prompts-and-what-claude-reads) охватывают остальное, что читает Claude: `prompt.section` для каждого раздела системного промпта, `prompt.context` для контекста, отправляемого с первым сообщением, и `skill.prompt` для текста скилла. Текст из этих хуков, меняющийся между запросами, [делает недействительным кэш промптов](/docs/ru/prompt-caching).

249 251

250<h3 id="follow-a-turn">252<h3 id="follow-a-turn">

308 Порядок, в котором запускаются моды310 Порядок, в котором запускаются моды

309</h3>311</h3>

310 312

311Hooks на одно и то же событие образуют одну цепочку middleware. Каждый `next` мода вызывает hook следующего мода, и последний `next` достигает собственного поведения Claude Code. Первый мод является самым внешним: он видит событие перед другими и результат после них, и он решает, запускаются ли другие вообще. Более поздний мод не может остановить более ранний от просмотра события.313Хуки на одно и то же событие образуют одну цепочку middleware. Каждый `next` мода вызывает хук следующего мода, и последний `next` достигает собственного поведения Claude Code. Первый мод является самым внешним: он видит событие перед другими и результат после них, и он решает, запускаются ли другие вообще. Более поздний мод не может остановить более ранний от просмотра события.

312 314

313Claude Code упорядочивает цепочку по тому, откуда берётся каждый мод:315Claude Code упорядочивает цепочку по тому, откуда берётся каждый мод:

314 316

3151. Встроенная защита `sec-default@builtin`, мод, встроенный в Claude Code, который `/plugin` перечисляет как `cc-plugin-sec-default`, где [он загружается](/docs/ru/plugins/mods/admin#know-what-happens-by-default), моды, которые ваша организация перечисляет в [`prependPlugins`](/docs/ru/plugins/mods/admin#install-your-organizations-mods), а затем любой другой мод, который считается модом вашей организации и не находится в `appendPlugins`3171. Встроенный страж `sec-default@builtin`, мод, встроенный в Claude Code, который `/plugin` перечисляет как `cc-plugin-sec-default`, где [он загружается](/docs/ru/plugins/mods/admin#know-what-happens-by-default), моды, которые ваша организация перечисляет в [`prependPlugins`](/docs/ru/plugins/mods/admin#install-your-organizations-mods), а затем любой другой мод, который считается модом вашей организации и не находится в `appendPlugins`

3162. Моды, которые вы устанавливаете3182. Моды, которые вы устанавливаете

3173. Моды, которые ваша организация перечисляет в `appendPlugins`3193. Моды, которые ваша организация перечисляет в `appendPlugins`

3184. Другие моды, встроенные в Claude Code3204. Другие моды, встроенные в Claude Code

319 321

320Среди модов, которые вы устанавливаете, мод запускается перед модами, которые он перечисляет в `dependencies` в своём манифесте. В одном модуле hooks запускаются в порядке, в котором `register` вызвал `on`.322Среди модов, которые вы устанавливаете, мод запускается перед модами, которые он перечисляет в `dependencies` в своём манифесте. В одном модуле хуки запускаются в порядке, в котором `register` вызвал `on`.

321 323

322<h4 id="where-settings-hooks-run-in-the-order">324<h4 id="where-settings-hooks-run-in-the-order">

323 Где hooks настроек запускаются в порядке325 Где хуки настроек запускаются в порядке

324</h4>326</h4>

325 327

326Hooks `PreToolUse`, настроенные в файлах настроек, также запускаются во время вызова инструмента в фиксированных точках цепочки модов:328Хуки `PreToolUse`, настроенные в файлах настроек, также запускаются во время вызова инструмента в фиксированных точках цепочки модов:

327 329

328* **Hooks `PreToolUse` из управляемых настроек**: запускаются перед hook `tool.call` первого мода, и блокировка от одного из них является окончательной, поэтому ни один мод не видит вызов.330* **Хуки `PreToolUse` из управляемых настроек**: запускаются перед хуком `tool.call` первого мода, и блокировка от одного из них является окончательной, поэтому ни один мод не видит вызов.

329* **Hooks `PreToolUse` из каждого другого файла настроек и из `hooks/hooks.json` плагинов**: запускаются после того, как последний мод вызовет `next`, как часть собственного поведения Claude Code. Мод, который отвечает на `tool.call` без вызова `next`, не позволяет им запускаться, и мод, который вызывает `next`, видит их решение в результате, который он возвращает.331* **Хуки `PreToolUse` из каждого другого файла настроек и из `hooks/hooks.json` плагинов**: запускаются после того, как последний мод вызовет `next`, как часть собственного поведения Claude Code. Мод, который отвечает на `tool.call` без вызова `next`, не позволяет им запускаться, и мод, который вызывает `next`, видит их решение в результате, который он возвращает.

330 332

331[`tool.check`](#approve-or-refuse-a-tool-call-before-the-user-is-asked) срабатывает после того, как эти хуки и правила разрешений приняли решение, поэтому хук на нём может одобрить вызов, который заблокировал хук из второй группы.333[`tool.check`](#approve-or-refuse-a-tool-call-before-the-user-is-asked) срабатывает после того, как эти хуки и правила разрешений приняли решение, поэтому хук на нём может одобрить вызов, который заблокировал хук из второй группы.

332 334

333<h3 id="handle-a-hook-that-fails">335<h3 id="handle-a-hook-that-fails">

334 Обработать hook, который не удаётся336 Обработать хук, который даёт сбой

335</h3>337</h3>

336 338

337Hook, который не удаётся, не нарушает сеанс, и вы можете решить, что происходит вместо этого. Когда hook без обработчика `.catch` выбрасывает исключение, истекает по времени или возвращает результат неправильной формы, что происходит дальше, зависит от того, вызвал ли он `next`:339Хук, который даёт сбой, не нарушает сессию, и вы можете решить, что происходит вместо этого. Когда хук без обработчика `.catch` выбрасывает исключение, превышает таймаут или возвращает результат неправильной формы, что происходит дальше, зависит от того, вызвал ли он `next`:

338 340

339* **Он не удался перед вызовом `next`**: Claude Code пропускает его, и следующий обработчик запускается на его месте341* **Он дал сбой перед вызовом `next`**: Claude Code пропускает его, и следующий обработчик запускается на его месте

340* **Он не удался после разрешения `next`**: этот результат стоит, и ничего не запускается второй раз342* **Он дал сбой после разрешения `next`**: этот результат остаётся в силе, и ничего не запускается второй раз

341 343

342Одна строка называет мод, событие и причину, такую как `my-mod: tool.call hook skipped: threw Error: boom`. Где вы это читаете, зависит от сеанса, как [Узнать, почему мод ничего не делает](/docs/ru/plugins/mods/troubleshoot#find-out-why-a-mod-does-nothing) перечисляет. Hook `ui.render`, чей рисунок не проходит валидацию, сообщается иначе, как [Построить дерево из элементов](/docs/ru/plugins/mods/interface#build-a-tree-from-elements) описывает.344Одна строка называет мод, событие и причину, такую как `my-mod: tool.call hook skipped: threw Error: boom`. Где вы это читаете, зависит от сессии, как перечислено в разделе [Узнать, почему мод ничего не делает](/docs/ru/plugins/mods/troubleshoot#find-out-why-a-mod-does-nothing). О хуке `ui.render`, чей рисунок не проходит валидацию, сообщается иначе, как описано в разделе [Создать дерево из элементов](/docs/ru/plugins/mods/interface#build-a-tree-from-elements).

343 345

344Чтобы сделать hook, который блокирует вызовы, не удаётся закрыто, добавьте обработчик ошибок `.catch`, который отвечает на его месте. Здесь `guard` — это ваша функция hook:346Чтобы хук, который блокирует вызовы, при сбое закрывал доступ (fail closed), добавьте обработчик ошибок `.catch`, который отвечает на его месте. Здесь `guard` — это ваша хук-функция, а обработчик проверяет [`next.called`](/docs/ru/plugins/mods/reference#the-hook-function), чтобы узнать, вызвал ли `guard` уже `next`, когда дал сбой:

345 347

346```javascript theme={null}348```javascript theme={null}

347// on возвращает регистрацию, и .catch присоединяет обработчик к этому одному hook349// on returns a registration, and .catch attaches a handler to that one hook

348on('tool.call', { tool: 'Bash' }, guard).catch(async ($, e, next) => {350on('tool.call', { tool: 'Bash' }, guard).catch(async ($, e, next) => {

349 // next.error.kind — это 'throw' или 'timeout', что говорит, как guard не удался351 // guard had already called next, so return what came back

352 if (next.called) return next(e)

353 // next.error.kind says why the handler was asked, such as 'throw' or 'timeout'

350 return { deny: 'The command guard failed, so this command was not run: ' + next.error.kind }354 return { deny: 'The command guard failed, so this command was not run: ' + next.error.kind }

351})355})

352```356```

353 357

354Пока `guard` работает, обработчик никогда не запускается. Когда `guard` выбрасывает исключение или превышает таймаут при вызове Bash, Claude Code вызывает обработчик с тем же событием. Обработчик возвращает `{ deny }`, поэтому команда не запускается, и Claude читает текст с `throw` или `timeout` в конце. Без обработчика Claude Code пропустил бы `guard` и запустил бы команду. У обработчика есть собственное, более короткое [ограничение по времени](/docs/ru/plugins/mods/reference#limits).358Когда `guard` выбрасывает исключение или превышает таймаут при вызове Bash, Claude Code вызывает обработчик с тем же событием:

359

360* **`guard` дал сбой до того, как вызвал `next`**: команда не запускается, и Claude читает текст `deny` с видом сбоя в конце

361* **`guard` дал сбой после того, как вызвал `next`**: `next(e)` обработчика разрешается в результат, который дал вызов `guard`, без повторного запуска команды, и Claude читает этот результат

362

363У обработчика есть собственное, более короткое [ограничение по времени](/docs/ru/plugins/mods/reference#limits). Если сам обработчик выбрасывает исключение или превышает таймаут, Claude Code пропускает хук так, как если бы у него не было обработчика. Если `guard` не вызывал `next`, команда затем выполняется так, как выполнялась бы без мода.

364

365Такая же форма обработчика подходит для стража на `prompt.submit` или `config.set`. Когда `next.called` равно false, верните отказ, который [справочник событий](/docs/ru/plugins/mods/reference#events) указывает для этого события: `{ drop: 'the reason' }` для `prompt.submit`, `{ deny: 'the reason' }` для `config.set`.

366

367На `tool.check` и `plugin.register` отказ, возвращённый после того, как `next` разрешился, всё равно действует, поэтому возвращайте его без проверки `next.called`:

368

369* **`tool.check`**: верните `{ decision: 'deny', reason: 'the reason' }`

370* **`plugin.register`**: верните `{ refuse: 'the reason' }`, как показано в разделе [Отклонять моды, когда ваша проверка даёт сбой](/docs/ru/plugins/mods/admin#refuse-mods-when-your-check-fails)

355 371

356<h2 id="next-steps">372<h2 id="next-steps">

357 Следующие шаги373 Следующие шаги

plugins/mods/gallery.md +8 −0

Details

415 415

416Для ещё двух элементов примеров здесь нет. `Image` отрисовывает PNG или необработанные пиксели в терминале. `Client` — это область, которую отрисовывает ваш второй файл, для анимации и ввода указателем. Их свойства перечислены в [справочнике по элементам](/docs/ru/plugins/mods/reference#elements).416Для ещё двух элементов примеров здесь нет. `Image` отрисовывает PNG или необработанные пиксели в терминале. `Client` — это область, которую отрисовывает ваш второй файл, для анимации и ввода указателем. Их свойства перечислены в [справочнике по элементам](/docs/ru/plugins/mods/reference#elements).

417 417

418Если Claude Code не обнаружит, что терминал отрисовывает изображения протокола графики kitty с плейсхолдерами Unicode, пользователь увидит вместо картинки приглушённый текст `alt` элемента `Image`. Пишите текст `alt`, который понятен сам по себе. Обнаружение выполняется при запуске: оно завершается успешно в kitty 0.28 или новее и в Ghostty, как только терминал ответит на графический запрос Claude Code, и не срабатывает в следующих случаях:

419

420* **Другие терминалы**: любой терминал, кроме этих двух, или терминал, который не отвечает на запрос.

421* **tmux и screen**: сессия, запущенная внутри tmux или screen, в любом терминале, включая kitty и Ghostty.

422* **Фоновые сессии**: любая [фоновая сессия](/docs/ru/agent-view), из какого бы терминала к ней ни подключались.

423

424Если пользователи вашего мода видят приглушённый текст в терминале, который всё же отрисовывает такие изображения с плейсхолдерами, они могут установить для [`CLAUDE_CODE_FORCE_TERMINAL_IMAGES`](/docs/ru/env-vars) значение `1`, чтобы пропустить обнаружение. Внутри tmux или screen это не помогает: текст `alt` пропадает, а Claude Code отправляет изображение, не оборачивая его для сквозной передачи через tmux или screen.

425

418<h2 id="see-where-a-mod-can-draw">426<h2 id="see-where-a-mod-can-draw">

419 Где ещё может отрисовывать мод427 Где ещё может отрисовывать мод

420</h2>428</h2>

plugins/mods/interface.md +21 −0

Details

443 443

444В сессии, запущенной с `--plugin-dir`, строка транскрипта говорит об этом, например `ui.render (Pane) refused: Text prop "bogusProp" is not allowed; the engine drew its own`. [Лог отладки](/docs/ru/plugins/mods/troubleshoot#read-the-debug-log) записывает это как `ui.render (Pane): a hook returned a tree that does not validate` с той же причиной. Ничего больше не появляется в сессии, поэтому когда рисование не показывается, проверьте эту строку или лог.444В сессии, запущенной с `--plugin-dir`, строка транскрипта говорит об этом, например `ui.render (Pane) refused: Text prop "bogusProp" is not allowed; the engine drew its own`. [Лог отладки](/docs/ru/plugins/mods/troubleshoot#read-the-debug-log) записывает это как `ui.render (Pane): a hook returned a tree that does not validate` с той же причиной. Ничего больше не появляется в сессии, поэтому когда рисование не показывается, проверьте эту строку или лог.

445 445

446<h3 id="link-in-the-desktop-app">

447 `Link` в приложении Desktop

448</h3>

449

450В приложении Desktop `Link` отображается как обычный текст, если его `href` не соответствует следующим требованиям:

451

452* **Схема и хост**: URL `https:` или URL `http://localhost`, например `http://localhost:3000`

453* **Без `@`**: записывайте `@` в пути или запросе как `%40`

454* **Написание**: то, что возвращает `new URL(href).href`, за исключением отсутствующего `/` после хоста. Это исключает хост в верхнем регистре, пробел и `:443` в URL `https:`.

455

456В терминале эти требования не действуют.

457

458<h3 id="when-a-client-fails">

459 Когда `Client` завершается сбоем

460</h3>

461

462В терминале, когда файл, который запускает `Client`, завершается сбоем, тусклая строка, например `my-mod: Client client/spinner.js: boom`, занимает место `Client`, а остальная часть вашего рисунка по-прежнему отображается.

463

464Если ваш мод обрабатывает [`ui.fault`](/docs/ru/plugins/mods/reference#interface), Claude Code затем [рисует сайт заново](#when-claude-code-redraws-without-being-asked).

465

446<h3 id="draw-a-grid-of-colored-cells">466<h3 id="draw-a-grid-of-colored-cells">

447 Рисование сетки цветных ячеек467 Рисование сетки цветных ячеек

448</h3>468</h3>

806К коду применяются следующие правила:826К коду применяются следующие правила:

807 827

808* **Пишите `plugin` и `key` как строковые литералы**: `claude plugin validate` читает их из вашего исходного кода828* **Пишите `plugin` и `key` как строковые литералы**: `claude plugin validate` читает их из вашего исходного кода

829* **Храните результат каждого вызова `atom` в `const`**: если вы объявите `count` с помощью `let`, валидация завершится ошибкой `takes a source the scan can read`

809* **Объявите каждое значение в файле объявления типов**: в противном случае валидация завершится ошибкой `hello-tabs.count is not declared`830* **Объявите каждое значение в файле объявления типов**: в противном случае валидация завершится ошибкой `hello-tabs.count is not declared`

810* **Записывайте из обратного вызова или хука другого события**: хук `ui.render` может читать состояние, но не может записывать его, поэтому записывайте из `onPress`, `onSubmit` или хука для другого события831* **Записывайте из обратного вызова или хука другого события**: хук `ui.render` может читать состояние, но не может записывать его, поэтому записывайте из `onPress`, `onSubmit` или хука для другого события

811 832

plugins/mods/overview.md +1 −1

Details

113Моды включены по умолчанию. В терминале используйте Claude Code v2.1.287 или позже. Приложение Desktop включает собственную копию Claude Code, и моды работают в нём начиная с v2.1.286. Проверьте версию там, где вы используете моды:113Моды включены по умолчанию. В терминале используйте Claude Code v2.1.287 или позже. Приложение Desktop включает собственную копию Claude Code, и моды работают в нём начиная с v2.1.286. Проверьте версию там, где вы используете моды:

114 114

115* **Терминал**: в вашей оболочке запустите `claude --version`. Если ваша версия старше, [обновите Claude Code](/docs/ru/setup#update-claude-code).115* **Терминал**: в вашей оболочке запустите `claude --version`. Если ваша версия старше, [обновите Claude Code](/docs/ru/setup#update-claude-code).

116* **Приложение Desktop**: в локальной сессии на вкладке Code введите `/status` и посмотрите строку **Claude Code**, в которой показана версия, например `2.1.286`. Если ваша версия старше, обновите приложение Desktop.116* **Приложение Desktop**: в локальной сессии на вкладке Code введите `/status` и посмотрите строку **Claude Code**, в которой показана версия, например `2.1.286`. Если ваша версия старше, [обновите приложение Desktop](/docs/ru/desktop#claude-code-version-in-the-code-tab).

117 117

118Чтобы отключить моды, выберите, сколько их остановить и на как долго. Чтобы включить их обратно, отмените то же изменение:118Чтобы отключить моды, выберите, сколько их остановить и на как долго. Чтобы включить их обратно, отмените то же изменение:

119 119

plugins/mods/reference.md +9 −6

Details

43| `next.origin` | `{ plugin, tier }` того, кто инициировал событие. Сам Claude Code — это `{ plugin: 'engine', tier: 'core' }`. `tier` мода — это его группа приоритета в [порядке запуска модов](/docs/ru/plugins/mods/events#the-order-mods-run-in): `prepend`, `user`, `append` или `builtin`. |43| `next.origin` | `{ plugin, tier }` того, кто инициировал событие. Сам Claude Code — это `{ plugin: 'engine', tier: 'core' }`. `tier` мода — это его группа приоритета в [порядке запуска модов](/docs/ru/plugins/mods/events#the-order-mods-run-in): `prepend`, `user`, `append` или `builtin`. |

44| `next.budget` | Ограничение времени хука в миллисекундах: `next.budget.ms` — всё ограничение, а `next.budget.remainingMs` — оставшееся на данный момент время |44| `next.budget` | Ограничение времени хука в миллисекундах: `next.budget.ms` — всё ограничение, а `next.budget.remainingMs` — оставшееся на данный момент время |

45| `next.to(e, tier)` | Переходит к более позднему уровню: `append`, `builtin` или `core`. `next.to(e, 'append')` пропускает моды, установленные пользователем. Вызвать его может только мод из `prependPlugins` или `appendPlugins`. |45| `next.to(e, tier)` | Переходит к более позднему уровню: `append`, `builtin` или `core`. `next.to(e, 'append')` пропускает моды, установленные пользователем. Вызвать его может только мод из `prependPlugins` или `appendPlugins`. |

46| `next.error`, `next.called` | Только в обработчике `.catch`. `next.error.kind` — это `throw` или `timeout`, `next.error.message` — текст ошибки, а `next.called` равно `true`, если упавший хук вызвал `next`. |46| `next.error` | Только в обработчике `.catch`. `kind` — это `throw` или `timeout`, если хук завершился сбоем, а `message` — текст ошибки. `kind` равно `re-entry`, если хук был пропущен, потому что событие возникло внутри одного из его собственных вызовов API модов, а `cause` равно `lent`, если это событие инициировал метод, который другой мод добавляет в API модов. Для `re-entry` и `cause` требуется Claude Code v2.1.292 или новее. |

47| `next.called` | Только в обработчике `.catch`. `true`, если хук вызвал `next`. |

47 48

48<h2 id="events">49<h2 id="events">

49 События50 События

258| [`Box`](/docs/ru/plugins/mods/interface#build-a-tree-from-elements) | `key`, flex-раскладка, `gap`, `padding`, `margin`, `width`, `height`, [`borderStyle`](#box-border-styles), `backgroundColor`, `position`, `hover` | ✓ | ✓ |259| [`Box`](/docs/ru/plugins/mods/interface#build-a-tree-from-elements) | `key`, flex-раскладка, `gap`, `padding`, `margin`, `width`, `height`, [`borderStyle`](#box-border-styles), `backgroundColor`, `position`, `hover` | ✓ | ✓ |

259| [`Text`](/docs/ru/plugins/mods/interface#build-a-tree-from-elements) | `color`, `backgroundColor`, `bold`, `italic`, `underline`, `dimColor`, `inverse`, `wrap` | ✓ | ✓ |260| [`Text`](/docs/ru/plugins/mods/interface#build-a-tree-from-elements) | `color`, `backgroundColor`, `bold`, `italic`, `underline`, `dimColor`, `inverse`, `wrap` | ✓ | ✓ |

260| [`Button`](/docs/ru/plugins/mods/interface#respond-to-presses-and-typing) | `key`, `label`, `onPress`, `hotkey`, `plain`, `dimColor`, `autoFocus`, `action` | ✓ | ✓ |261| [`Button`](/docs/ru/plugins/mods/interface#respond-to-presses-and-typing) | `key`, `label`, `onPress`, `hotkey`, `plain`, `dimColor`, `autoFocus`, `action` | ✓ | ✓ |

261| `Link` | `href`, `label` | ✓ | ✓ |262| [`Link`](/docs/ru/plugins/mods/interface#link-in-the-desktop-app) | `href`, `label`. См. [Ограничения](#limits). | ✓ | ✓ |

262| `Code` | Код | ✓ | ✓ |263| [`Code`](/docs/ru/plugins/mods/gallery#show-code-and-changes) | `source`, `language`, `path`, `startLine`, `format`, `wrap` | ✓ | ✓ |

263| `Markdown` | `text`, `key`, `dimColor`, `onLinkPress`, `pressableLinks` | ✓ | ✓ |264| `Markdown` | `text`, `key`, `dimColor`, `onLinkPress`, `pressableLinks` | ✓ | ✓ |

264| [`Input`](/docs/ru/plugins/mods/interface#take-typed-input-and-draw-a-row-for-each-item) | `key`, `label`, `placeholder`, `value`, `submitLabel`, `onSubmit`, `onInput`, `autoFocus` | ✓ | ✓ |265| [`Input`](/docs/ru/plugins/mods/interface#take-typed-input-and-draw-a-row-for-each-item) | `key`, `label`, `placeholder`, `value`, `submitLabel`, `onSubmit`, `onInput`, `autoFocus` | ✓ | ✓ |

265| `Select` | `key`, `label`, `options`, `value`, `onSelect`, `autoFocus` | ✓ | ✓ |266| `Select` | `key`, `label`, `options`, `value`, `onSelect`, `autoFocus` | ✓ | ✓ |

266| `Svg` | SVG-документ, до 131 072 символов | | ✓ |267| `Svg` | SVG-документ, до 131 072 символов | | ✓ |

267| [`Client`](/docs/ru/plugins/mods/interface#build-a-tree-from-elements) | `module`, `key` | ✓ | ✓ |268| [`Client`](/docs/ru/plugins/mods/interface#build-a-tree-from-elements) | `module`, `key` | ✓ | ✓ |

268| [`Raster`](/docs/ru/plugins/mods/interface#draw-a-grid-of-colored-cells) | `key`, `columns` до 512, `rows` до 256, `cells`. См. [Рисование сетки цветных ячеек](/docs/ru/plugins/mods/interface#draw-a-grid-of-colored-cells). | ✓ | |269| [`Raster`](/docs/ru/plugins/mods/interface#draw-a-grid-of-colored-cells) | `key`, `columns` до 512, `rows` до 256, `cells`. См. [Рисование сетки цветных ячеек](/docs/ru/plugins/mods/interface#draw-a-grid-of-colored-cells). | ✓ | |

269| `Image` | Байты PNG или RGBA до 2 МиБ либо путь к файлу | ✓ | |270| `Image` | Байты PNG или RGBA до 2 МиБ либо путь к файлу, `columns` и `rows` до 255, а также текст `alt`. | ✓ | |

270 271

271Дополнительные правила для `Button`: `action` указывает одно из собственных [действий сочетаний клавиш](/docs/ru/keybindings) Claude Code, и сочетание, назначенное пользователем для этого действия, нажимает кнопку, если это аккорд или клавиша с модификатором. Цифровой `hotkey` на кнопке в полосе также срабатывает, когда пользователь вводит только эту цифру в пустой промпт и делает паузу. Если две кнопки в одной отрисовке указывают один и тот же `hotkey`, он достаётся более поздней. `autoFocus` на любом элементе управления принимает только `true`, поэтому, чтобы отключить его, опустите этот проп.272Дополнительные правила для `Button`: `action` указывает одно из собственных [действий сочетаний клавиш](/docs/ru/keybindings) Claude Code, и сочетание, назначенное пользователем для этого действия, нажимает кнопку, если это аккорд или клавиша с модификатором. Цифровой `hotkey` на кнопке в полосе также срабатывает, когда пользователь вводит только эту цифру в пустой промпт и делает паузу. Если две кнопки в одной отрисовке указывают один и тот же `hotkey`, он достаётся более поздней. `autoFocus` на любом элементе управления принимает только `true`, поэтому, чтобы отключить его, опустите этот проп.

272 273

295 Ограничения296 Ограничения

296</h2>297</h2>

297 298

298Хуки и вызовы API модов выполняются с ограничениями по времени и размеру. Claude Code пропускает хук, превысивший ограничение по времени, и отклоняет вызов, превысивший ограничение по размеру.299Хуки и вызовы API модов выполняются с ограничениями по времени и размеру. Claude Code пропускает хук, превысивший ограничение по времени.

299 300

300| Ограничение | Значение |301| Ограничение | Значение |

301| :- | :- |302| :- | :- |

308| Текст в одном дереве | Отрисовываются первые 100 000 символов |309| Текст в одном дереве | Отрисовываются первые 100 000 символов |

310| `language` или `path` элемента `Code`, `value` варианта `Select` или `module` элемента `Client` | 10 000 символов. Если значение длиннее, Claude Code [отрисовывает собственную версию области](/docs/ru/plugins/mods/interface#build-a-tree-from-elements). |

311| `href` элемента `Link` | 2 048 символов. Более длинный `href` не даёт отрисовать всё дерево. |

311| Перерисовки `$.ui.invalidate('ui.render')` | Ограничены 10 в секунду или 30 в терминале для видимой панели, развёрнутой полосы и строки подсказки под промптом. Более частые вызовы объединяются. |314| Перерисовки `$.ui.invalidate('ui.render')` | Ограничены 10 в секунду или 30 в терминале для видимой панели, развёрнутой полосы и строки подсказки под промптом. Более частые вызовы объединяются. |

325| `CLAUDE_CODE_PLUGIN_DIRS` | Окружение или `env` в `~/.claude/settings.json` | Каталоги плагинов для загрузки так же, как это делает `--plugin-dir`, — для приложений, которым нельзя передать флаг. Абсолютные пути, разделённые `:`, или `;` в Windows. |328| `CLAUDE_CODE_PLUGIN_DIRS` | Окружение или `env` в `~/.claude/settings.json` | Каталоги плагинов для загрузки так же, как это делает `--plugin-dir`, — для приложений, которым нельзя передать флаг. Абсолютные пути, разделённые `:`, или `;` в Windows. |

327| `prependPlugins`, `appendPlugins` | Управляемые настройки. Пользовательские настройки — только на машине без управляемых настроек и для пользователя, не вошедшего с тарифом Team или Enterprise. | Списки id плагинов, например `acme-guard@acme-tools`. Моды из `prependPlugins` выполняются перед каждым модом, установленным пользователем, а моды из `appendPlugins` — после, в указанном порядке. См. [Порядок запуска модов](/docs/ru/plugins/mods/events#the-order-mods-run-in). |330| `prependPlugins`, `appendPlugins` | Управляемые настройки. Пользовательские настройки — только на машине без управляемых настроек и для пользователя, не вошедшего с тарифом Team или Enterprise. | Списки id плагинов, например `acme-guard@acme-tools`. Моды из `prependPlugins` выполняются перед каждым модом, установленным пользователем, а моды из `appendPlugins` — после, в указанном порядке. См. [Порядок запуска модов](/docs/ru/plugins/mods/events#the-order-mods-run-in). |

328| `allowManagedModsOnly` | Управляемые настройки, как [опция встроенного стража](/docs/ru/plugins/mods/admin#set-options-on-the-built-in-guard) | Загружаются только моды, которые [считаются модами вашей организации](/docs/ru/plugins/mods/admin#install-your-organizations-mods), и моды, встроенные в Claude Code. Хуки настроек пользователей продолжают работать. |331| `allowManagedModsOnly` | Управляемые настройки, как [опция встроенного стража](/docs/ru/plugins/mods/admin#set-options-on-the-built-in-guard) | Свои хуки запускают только моды, которые [считаются модами вашей организации](/docs/ru/plugins/mods/admin#install-your-organizations-mods), и моды, встроенные в Claude Code. Хуки настроек пользователей продолжают работать. |

329| `allowModsToOverrideDenyRules` | Управляемые настройки, как [опция встроенного стража](/docs/ru/plugins/mods/admin#set-options-on-the-built-in-guard) | Позволяет моду, установленному пользователем, одобрить вызов инструмента, который отклоняет правило `deny` |332| `allowModsToOverrideDenyRules` | Управляемые настройки, как [опция встроенного стража](/docs/ru/plugins/mods/admin#set-options-on-the-built-in-guard) | Позволяет моду, установленному пользователем, одобрить вызов инструмента, который отклоняет правило `deny` |

330| `allowManagedHooksOnly` | Управляемые настройки | Блокирует хуки и установленные моды, не принадлежащие вашей организации. См. [что продолжает работать](/docs/ru/settings-reference#what-runs-under-allowmanagedhooksonly). |333| `allowManagedHooksOnly` | Управляемые настройки | Блокирует хуки и установленные моды, не принадлежащие вашей организации. См. [что продолжает работать](/docs/ru/settings-reference#what-runs-under-allowmanagedhooksonly). |

331| `disableAllHooks` | Любой файл настроек | В управляемых настройках не выполняется ни один мод или хук из установленного плагина. В ваших собственных настройках то, чем управляет ваша организация, продолжает работать. См. [`disableAllHooks`](/docs/ru/settings-reference#disableallhooks). |334| `disableAllHooks` | Любой файл настроек | В управляемых настройках не выполняется ни один мод или хук из установленного плагина. В ваших собственных настройках то, чем управляет ваша организация, продолжает работать. См. [`disableAllHooks`](/docs/ru/settings-reference#disableallhooks). |

plugins/mods/test.md +3 −1

Details

107 107

108Stub для вызова mods API возвращает объект с полем `value`, которое содержит то, во что разрешается вызов в вашем моде: `{ value: 7 }` заставляет `$.store.get` разрешиться в `7`. Stub для одного из событий Claude Code, такого как [`turn.step`](/docs/ru/plugins/mods/reference#turns) или `tool.call`, возвращает собственный результат этого события, такой как `{ result: 'ok' }`. `$.session.send` и `$.prompt.fill` также принимают результат своего события, как показано в таблице. [Look up what a stub returns](#look-up-what-a-stub-returns) показывает, какую форму принимает каждое распространённое имя. Следующие ошибки означают, что stub неправильный или отсутствует. Вывод непройденного теста включает блок с заголовком `the engine reported:`, и каждая ошибка появляется там:108Stub для вызова mods API возвращает объект с полем `value`, которое содержит то, во что разрешается вызов в вашем моде: `{ value: 7 }` заставляет `$.store.get` разрешиться в `7`. Stub для одного из событий Claude Code, такого как [`turn.step`](/docs/ru/plugins/mods/reference#turns) или `tool.call`, возвращает собственный результат этого события, такой как `{ result: 'ok' }`. `$.session.send` и `$.prompt.fill` также принимают результат своего события, как показано в таблице. [Look up what a stub returns](#look-up-what-a-stub-returns) показывает, какую форму принимает каждое распространённое имя. Следующие ошибки означают, что stub неправильный или отсутствует. Вывод непройденного теста включает блок с заголовком `the engine reported:`, и каждая ошибка появляется там:

109 109

110* `returned neither { value } nor { deny }`: stub для вызова mods API вернул простое значение110* `returned neither { value } nor { deny }`: stub для вызова mods API вернул простое значение, из-за чего тест не проходит

111* `no implementation for` с последующим именем: ваш мод сделал этот вызов и никакой stub не отвечает на него111* `no implementation for` с последующим именем: ваш мод сделал этот вызов и никакой stub не отвечает на него

112 112

113Набор также экспортирует встроенные mock, которые отвечают за целое пространство имён для вас. `mock.clock(on)` отвечает на [`$.clock`](/docs/ru/plugins/mods/api#run-work-in-the-background), `mock.store(on, { count: 7 })` отвечает на `$.store` из хранилища, которое начинается с этих записей, и `mock.env(on, { CI: 'true' })` отвечает на `$.env.get` из этих переменных. `mock.clock` возвращает mock часы, которые ваш тест продвигает, поэтому тест таймера не ждёт. `mock.store` ничего не возвращает, поэтому чтобы проверить, что сохранил ваш мод, напишите два `store` stub сами, как это делает [drawing test](#test-a-drawing).113Набор также экспортирует встроенные mock, которые отвечают за целое пространство имён для вас. `mock.clock(on)` отвечает на [`$.clock`](/docs/ru/plugins/mods/api#run-work-in-the-background), `mock.store(on, { count: 7 })` отвечает на `$.store` из хранилища, которое начинается с этих записей, и `mock.env(on, { CI: 'true' })` отвечает на `$.env.get` из этих переменных. `mock.clock` возвращает mock часы, которые ваш тест продвигает, поэтому тест таймера не ждёт. `mock.store` ничего не возвращает, поэтому чтобы проверить, что сохранил ваш мод, напишите два `store` stub сами, как это делает [drawing test](#test-a-drawing).

198 198

199`expect` имеет утверждения `toBe`, `toEqual`, `toMatch`, `toMatchObject`, `toContain`, `toBeDefined`, `toBeUndefined` и `toThrow`, и `.not` перед любым из них.199`expect` имеет утверждения `toBe`, `toEqual`, `toMatch`, `toMatchObject`, `toContain`, `toBeDefined`, `toBeUndefined` и `toThrow`, и `.not` перед любым из них.

200 200

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

202

201<h2 id="test-a-timer">203<h2 id="test-a-timer">

202 Тестируйте таймер204 Тестируйте таймер

203</h2>205</h2>

plugins/mods/troubleshoot.md +46 −14

Details

4 4

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

6 6

7> Узнайте, почему мод Claude Code ничего не делает: сопоставьте симптом или сообщение с его причиной, посмотрите сообщения об отказе и прочитайте журнал отладки.7> Узнайте, почему мод Claude Code ничего не делает: сопоставьте симптом или сообщение с его причиной, посмотрите сообщения об отказе и прочитайте лог отладки.

8 8

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

10 10

11<h2 id="find-out-why-a-mod-does-nothing">11<h2 id="find-out-why-a-mod-does-nothing">

12 Узнайте, почему мод ничего не делает12 Узнайте, почему мод ничего не делает

30| :- | :- |30| :- | :- |

31| `no hooks module to load` | Моды могут загружаться. Команда не нашла мода для тестирования в этой директории. |31| `no hooks module to load` | Моды могут загружаться. Команда не нашла мода для тестирования в этой директории. |

32| `hooks modules are turned off here` | Настройка препятствует вашим модам: `disableAllHooks` в ваших собственных настройках или политика вашей организации |32| `hooks modules are turned off here` | Настройка препятствует вашим модам: `disableAllHooks` в ваших собственных настройках или политика вашей организации |

33| `hooks modules are turned off in this process` | Anthropic отключила установленные моды удаленно. Никакой параметр на вашей машине их не включит. |33| `hooks modules are turned off in this process: the rollout switch served off` | Anthropic отключила установленные моды удаленно. |

34| `hooks modules are turned off in this process: the rollout switch was saved off by an earlier session` | Команда использовала значение, сохраненное более ранней сессией, которое может быть устаревшим. Запустите `claude` один раз, чтобы обновить его, затем снова выполните команду. |

34 35

35Организация также может установить `allowManagedModsOnly`, чтобы разрешить только свои моды, что эта команда не сообщает. В этом случае мод, который вы устанавливаете, не загружается, и [сообщение говорит почему](/docs/ru/plugins/mods/troubleshoot#messages-from-the-built-in-guard).36Организация также может установить `allowManagedModsOnly`, чтобы разрешить только свои моды, что эта команда не сообщает. В этом случае Claude Code отклоняет мод, который вы устанавливаете, и [сообщение говорит почему](/docs/ru/plugins/mods/troubleshoot#messages-from-the-built-in-guard).

36 37

37<h2 id="the-mod-doesn’t-load">38<h2 id="the-mod-doesn’t-load">

38 Мод не загружается39 Мод не загружается

72 73

73| Сообщение начинается с | Что это означает |74| Сообщение начинается с | Что это означает |

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

75| `hooks modules are turned off for installed plugins in this process` | Anthropic отключила установленные моды удаленно. Никакой параметр на вашей машине их не включит. |76| `hooks modules are turned off for installed plugins in this process: the rollout switch served off` | Anthropic отключила установленные моды удаленно. |

77| `hooks modules are turned off for installed plugins in this process: the rollout switch was saved off by an earlier session` | Сессия использовала значение, сохраненное более ранней сессией, которое может быть устаревшим. Запустите Claude Code снова, чтобы обновить его. |

76| `disableAllHooks in managed settings` | Ваша организация отключила hooks из установленных плагинов |78| `disableAllHooks in managed settings` | Ваша организация отключила hooks из установленных плагинов |

77| `only managed plugins and built-in plugins run` | `allowManagedHooksOnly` установлен или `disableAllHooks` установлен в файле параметров, отличном от управляемых параметров |79| `only managed plugins and built-in plugins run` | `allowManagedHooksOnly` установлен или `disableAllHooks` установлен в файле параметров, отличном от управляемых параметров |

78| `installed plugins that are not managed load no hooks module in this mode (--bare)` | Вы запустили Claude Code с `--bare` |80| `installed plugins that are not managed load no hooks module in this mode (--bare)` | Вы запустили Claude Code с `--bare` |

86 88

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

89| `mods are limited to your organization's by policy (allowManagedModsOnly)` | Ваша организация разрешает только [свои моды](/docs/ru/plugins/mods/admin#install-your-organizations-mods), поэтому ваш не был загружен | Журнал отладки и стенограмма в [сеансе, который горячо перезагружает директорию плагина](#find-out-why-a-mod-does-nothing) |91| `mods are limited to your organization's by policy (allowManagedModsOnly)` | Ваша организация разрешает только [свои моды](/docs/ru/plugins/mods/admin#install-your-organizations-mods), поэтому ваш был отклонен | Лог отладки, а также транскрипт в [сессии, которая выполняет горячую перезагрузку директории плагина](#find-out-why-a-mod-does-nothing) |

90| `tried to lift a deny rule in your settings` | Hook вашего мода [`tool.check`](/docs/ru/plugins/mods/reference#tools) одобрил вызов, который правило `deny` отказывает. Вызов остается отказанным. | Стенограмма и журнал отладки, один раз для каждого мода в сеансе. В запуске `claude -p` только журнал отладки. |92| `tried to lift a deny rule in your settings` | Hook вашего мода [`tool.check`](/docs/ru/plugins/mods/reference#tools) одобрил вызов, который правило `deny` отказывает. Вызов остается отказанным. | Стенограмма и журнал отладки, один раз для каждого мода в сеансе. В запуске `claude -p` только журнал отладки. |

91| `the deny rules in your settings could not be checked for this call, so it is refused` | Защита не прошла при проверке вызова, который одобрил мод, поэтому она отказала вызову | Причина, которую Claude читает для отказанного вызова |93| `the deny rules in your settings could not be checked for this call, so it is refused` | Защита не прошла при проверке вызова, который одобрил мод, поэтому она отказала вызову | Причина, которую Claude читает для отказанного вызова |

92 94

163 165

164Исправьте hook.166Исправьте hook.

165 167

168<h3 id="its-session-start-ran-again-in-a-fresh-copy">

169 `its session.start ran again in a fresh copy`

170</h3>

171

172Строка начинается с имени мода и называет вызов `$.prompt.submit`, `$.command.run` или `$.agent.spawn`, как в `first-mod: its session.start ran again in a fresh copy; the $.prompt.submit call it had already made was not made again`. Claude Code снова загрузила модуль мода, например после того как рабочий поток хуков упал и был заменен, и в свежей копии выполнился хук [`session.start`](/docs/ru/plugins/mods/reference#session). Вызов, названный в строке, вернул результат своего первого выполнения вместо повторного выполнения, поэтому ваш мод не отправляет промпт, не запускает команду и не запускает субагента дважды. Остальная часть хука выполнилась как обычно.

173

174Исправлять ничего не нужно.

175

176До v2.1.292 вызов выполнялся второй раз, поэтому промпт отправлялся, команда запускалась или субагент запускался дважды.

177

166<h3 id="mods-that-run-in-the-hooks-worker-are-off-for-this-session">178<h3 id="mods-that-run-in-the-hooks-worker-are-off-for-this-session">

167 `mods that run in the hooks worker are off for this session`179 `mods that run in the hooks worker are off for this session`

168</h3>180</h3>

203 Панель или полоса пуста или показывает обычное содержимое Claude Code215 Панель или полоса пуста или показывает обычное содержимое Claude Code

204</h3>216</h3>

205 217

206[Дерево](/docs/ru/plugins/mods/interface#build-a-tree-from-elements), которое вернула ваша hook, не прошло валидацию. С `--plugin-dir` стенограмма говорит `ui.render (Pane) refused:` с причиной, как в `first-mod: ui.render (Pane) refused: Box prop "flexDirection" must be one of row, column, row-reverse, column-reverse; the engine drew its own`. Журнал отладки имеет `a hook returned a tree that does not validate` с той же причиной.218[Дерево](/docs/ru/plugins/mods/interface#build-a-tree-from-elements), которое вернул ваш хук, не прошло валидацию. С `--plugin-dir` транскрипт показывает `ui.render (Pane) refused:` с причиной, как в `first-mod: ui.render (Pane) refused: Box prop "flexDirection" must be one of row, column, row-reverse, column-reverse; the engine drew its own`. Лог отладки содержит `a hook returned a tree that does not validate` с той же причиной.

219

220Прочитайте причину на этой строке. Частые причины - это проп, который элемент не принимает, и элемент, которого нет в приложении.

221

222<h3 id="a-ui-render-line-says-threw-while-drawn">

223 Строка `ui.render` сообщает `threw while drawn`

224</h3>

225

226Строка называет [точку отрисовки](/docs/ru/plugins/mods/reference#render-sites), затем сообщает `threw while drawn:` и ошибку, как в `first-mod: ui.render (ToolUse) threw while drawn: <error>; the engine drew its own`. Claude Code столкнулся с этой ошибкой при отрисовке дерева, которое вернул ваш хук [`ui.render`](/docs/ru/plugins/mods/reference#interface), или при отрисовке точки из [`props`, которые ваш хук передал в `next`](/docs/ru/plugins/mods/interface#change-what-claude-code-already-draws). Окончание `the engine drew its own` означает, что точка показывает обычное содержимое Claude Code.

227

228Прочитайте ошибку и исправьте значение в вашем хуке, которое ее вызвало.

229

230До v2.1.289 эта ошибка в строке транскрипта завершала сессию с [`Claude Code exited after an unrecoverable interface error`](/docs/ru/errors#exited-after-an-unrecoverable-interface-error).

231

232<h3 id="the-module-failed-without-a-message">

233 `the module failed without a message`

234</h3>

235

236[`Client`](/docs/ru/plugins/mods/interface#when-a-client-fails) завершился с ошибкой без сообщения, например `throw new Error()`. Строка на его месте выглядит как `my-mod: Client client/spinner.js: the module failed without a message`.

237

238Найдите throw в коде вашего `Client` и задайте ошибке сообщение. Тогда строка покажет это сообщение.

207 239

208Прочитайте причину на этой строке. Частые причины - это свойство, которое элемент не принимает, и элемент, который приложение не имеет.240До v2.1.289 строка вместо этого показывала `Error` в качестве причины.

209 241

210<h3 id="$-ui-open-runs-and-no-pane-appears">242<h3 id="$-ui-open-runs-and-no-pane-appears">

211 `$.ui.open` работает и панель не появляется243 `$.ui.open` работает и панель не появляется

227 Рисунок работает в терминале и не в приложении Desktop259 Рисунок работает в терминале и не в приложении Desktop

228</h3>260</h3>

229 261

230Сайт или элемент там недоступны.262Точка отрисовки или элемент там недоступны.

231 263

232Проверьте таблицы [сайтов рендеринга](/docs/ru/plugins/mods/reference#render-sites) и [элементов](/docs/ru/plugins/mods/reference#elements).264Проверьте таблицы [точек отрисовки](/docs/ru/plugins/mods/reference#render-sites) и [элементов](/docs/ru/plugins/mods/reference#elements).

233 265

234<h2 id="an-edit-or-a-value-is-lost">266<h2 id="an-edit-or-a-value-is-lost">

235 Редактирование или значение потеряно267 Редактирование или значение потеряно

262[Загрузите сохраненное значение снова](/docs/ru/plugins/mods/interface#load-a-saved-value-again-after-clear) в hook `classic.SessionStart`.294[Загрузите сохраненное значение снова](/docs/ru/plugins/mods/interface#load-a-saved-value-again-after-clear) в hook `classic.SessionStart`.

263 295

264<h2 id="read-the-debug-log">296<h2 id="read-the-debug-log">

265 Прочитайте журнал отладки297 Прочитайте лог отладки

266</h2>298</h2>

267 299

268Журнал отладки имеет строку для каждого модуля, который Claude Code загружает или отказывает, каждого hook, который дает сбой, и каждого результата, который она отказывает, поэтому это место для поиска, когда стенограмма ничего не показывает. Чтобы написать один, в вашей оболочке запустите Claude Code с `--debug` или с `--debug-file <path>` для выбора места назначения:300В логе отладки есть строка для каждого модуля, который Claude Code загружает или отклоняет, для каждого хука, завершившегося сбоем, и для каждого отклонённого результата, поэтому именно туда стоит смотреть, когда транскрипт ничего не показывает. Чтобы записать лог, запустите Claude Code в оболочке с `--debug` или с `--debug-file <path>`, чтобы выбрать место назначения:

269 301

270```bash theme={null}302```bash theme={null}

271claude --debug-file ./mod-debug.log --plugin-dir ./first-mod303claude --debug-file ./mod-debug.log --plugin-dir ./first-mod

283hooks module first-mod@inline loaded (worker, environment 2, tier user); events: session.start,tool.call,command.run,ui.render315hooks module first-mod@inline loaded (worker, environment 2, tier user); events: session.start,tool.call,command.run,ui.render

284```316```

285 317

286Рисунок, который не прошел валидацию, считается отказанным результатом и получает строку тоже. Чтобы написать свои собственные строки в журнал, вызовите [`$.ui.log`](/docs/ru/plugins/mods/api#show-something-without-starting-a-turn) со вторым аргументом, как в `$.ui.log('message', { to: 'debug' })`. Без второго аргумента `$.ui.log` добавляет тусклую строку в стенограмму.318Рисунок, который не прошёл валидацию, считается отклонённым результатом и тоже получает строку. Чтобы записать собственные строки в лог, вызовите [`$.ui.log`](/docs/ru/plugins/mods/api#show-something-without-starting-a-turn) со вторым аргументом, как в `$.ui.log('message', { to: 'debug' })`. Без второго аргумента `$.ui.log` добавляет тусклую строку в транскрипт.

287 319

288Пока вы редактируете мод, загруженный с `--plugin-dir`, стенограмма показывает строку для каждой перезагрузки, которая называет мод и перечисляет его hooks. Если сохранение нарушает модуль, строка говорит `reload failed, the previous version stays loaded:` с причиной, и последняя рабочая версия продолжает работать.320Пока вы редактируете мод, загруженный с `--plugin-dir`, транскрипт показывает строку для каждой перезагрузки, в которой указано имя мода и перечислены его хуки. Если после сохранения модуль ломается, в строке выводится `reload failed, the previous version stays loaded:` с причиной, а последняя рабочая версия продолжает работать до следующей перезагрузки плагинов в Claude Code, например когда вы запускаете `/reload-plugins`.

289 321

290<h2 id="next-steps">322<h2 id="next-steps">

291 Следующие шаги323 Следующие шаги

plugins/org.md +1 −1

Details

212| `pluginTrustMessage` | Добавляет ваш текст к предупреждению доверия, которое `/plugin` показывает перед установкой плагина | Не изменяет собственный текст предупреждения |212| `pluginTrustMessage` | Добавляет ваш текст к предупреждению доверия, которое `/plugin` показывает перед установкой плагина | Не изменяет собственный текст предупреждения |

213| `allowedChannelPlugins` | Заменяет список плагинов по умолчанию, разрешенных для отправки сообщений канала. Требует `channelsEnabled: true` | См. [Ограничить, какие плагины канала могут работать](/docs/ru/channels#restrict-which-channel-plugins-can-run) |213| `allowedChannelPlugins` | Заменяет список плагинов по умолчанию, разрешенных для отправки сообщений канала. Требует `channelsEnabled: true` | См. [Ограничить, какие плагины канала могут работать](/docs/ru/channels#restrict-which-channel-plugins-can-run) |

214| [`CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL=1`](/docs/ru/env-vars) | Останавливает интерактивные сессии терминала от автоматической регистрации официального marketplace | Не удаляет marketplace, уже зарегистрированный. Allowlist и blocklist управляют той же автоматической регистрацией без него. Машина, которая запустилась один раз с установленным, не возобновляет автоматическую регистрацию после того, как вы его отключите |214| [`CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL=1`](/docs/ru/env-vars) | Останавливает интерактивные сессии терминала от автоматической регистрации официального marketplace | Не удаляет marketplace, уже зарегистрированный. Allowlist и blocklist управляют той же автоматической регистрацией без него. Машина, которая запустилась один раз с установленным, не возобновляет автоматическую регистрацию после того, как вы его отключите |

215| [`allowManagedModsOnly`](/docs/ru/plugins/mods/admin#stop-user-installed-mods-from-loading) | Останавливает каждый установленный [mod](/docs/ru/plugins/mods/overview), который не [считается модом вашей организации](/docs/ru/plugins/mods/admin#install-your-organizations-mods), от загрузки | Не останавливает плагин, содержащий mod, от установки. Для этого используйте ключи marketplace в этой таблице |215| [`allowManagedModsOnly`](/docs/ru/plugins/mods/admin#stop-user-installed-mods-from-loading) | Запрещает каждому установленному [моду](/docs/ru/plugins/mods/overview), который не [считается модом вашей организации](/docs/ru/plugins/mods/admin#install-your-organizations-mods), запускать свои хуки | Не препятствует установке плагина, содержащего мод. Для этого используйте ключи маркетплейсов из этой таблицы |

216 216

217Каждый ключ в таблице является управляемым параметром, кроме `enabledPlugins`, `syncClaudeAiPlugins`, `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` и `allowManagedModsOnly`:217Каждый ключ в таблице является управляемым параметром, кроме `enabledPlugins`, `syncClaudeAiPlugins`, `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` и `allowManagedModsOnly`:

218 218

plugins/security.md +2 −1

Details

29Плагин может содержать контент, который выполняет код на вашей машине с вашими привилегиями пользователя, и контент, который входит в контекст Claude в качестве инструкций, поэтому [перед установкой плагина его следует проверить](#review-a-plugin-before-you-install). Вот что может делать установленный плагин:29Плагин может содержать контент, который выполняет код на вашей машине с вашими привилегиями пользователя, и контент, который входит в контекст Claude в качестве инструкций, поэтому [перед установкой плагина его следует проверить](#review-a-plugin-before-you-install). Вот что может делать установленный плагин:

30 30

31* **Hooks**: [hooks](/docs/ru/hooks) плагина выполняются как команды shell в определённых точках жизненного цикла Claude Code, например до или после вызова инструмента.31* **Hooks**: [hooks](/docs/ru/hooks) плагина выполняются как команды shell в определённых точках жизненного цикла Claude Code, например до или после вызова инструмента.

32* **Мониторы**: [мониторы](/docs/ru/plugins/components#monitors) плагина выполняются как фоновые shell-команды, которые Claude Code запускает самостоятельно при запуске сессии, при перезагрузке плагинов или при первом запуске именованного скилла.

32* **Mods**: [mod](/docs/ru/plugins/mods/overview) плагина выполняет JavaScript внутри Claude Code с вашими разрешениями. Чтобы увидеть, что делает mod перед установкой, см. [Решите, доверять ли mod](/docs/ru/plugins/mods/overview#decide-whether-to-trust-a-mod).33* **Mods**: [mod](/docs/ru/plugins/mods/overview) плагина выполняет JavaScript внутри Claude Code с вашими разрешениями. Чтобы увидеть, что делает mod перед установкой, см. [Решите, доверять ли mod](/docs/ru/plugins/mods/overview#decide-whether-to-trust-a-mod).

33* **MCP и LSP серверы**: Claude Code подключается к [MCP серверам](/docs/ru/mcp), которые объявляет включённый плагин, и предоставляет Claude их инструменты. Stdio MCP сервер работает как процесс, который Claude Code запускает на вашей машине. Claude Code также запускает языковые серверы, которые объявляет плагин.34* **MCP и LSP серверы**: Claude Code подключается к [MCP серверам](/docs/ru/mcp), которые объявляет включённый плагин, и предоставляет Claude их инструменты. Stdio MCP сервер работает как процесс, который Claude Code запускает на вашей машине. Claude Code также запускает языковые серверы, которые объявляет плагин.

34* **`bin/` директория**: Claude Code добавляет директорию `bin/` каждого включённого плагина в `PATH` shell инструмента Bash, поэтому команды Bash от Claude могут запускать любой исполняемый файл там.35* **`bin/` директория**: Claude Code добавляет директорию `bin/` каждого включённого плагина в `PATH` shell инструмента Bash, поэтому команды Bash от Claude могут запускать любой исполняемый файл там.

37 38

38[Правила разрешений](/docs/ru/permissions) Claude Code и [sandbox](/docs/ru/sandboxing) охватывают вызовы инструментов, которые делает Claude, а не код, который плагин запускает самостоятельно:39[Правила разрешений](/docs/ru/permissions) Claude Code и [sandbox](/docs/ru/sandboxing) охватывают вызовы инструментов, которые делает Claude, а не код, который плагин запускает самостоятельно:

39 40

40* **Хуки и серверные процессы**: command-хуки выполняют shell-команды с вашими полными привилегиями пользователя. Claude Code запускает хуки, MCP-серверы и процессы, которые запускает [mod](/docs/ru/plugins/mods/overview#what-a-mod-can-reach), вне песочницы.41* **Хуки, мониторы и серверные процессы**: command-хуки и мониторы — это shell-команды, которые выполняются с вашими полными привилегиями пользователя. Claude Code запускает хуки, мониторы, MCP-серверы, LSP-серверы и процессы, которые запускает [мод](/docs/ru/plugins/mods/overview#what-a-mod-can-reach), вне песочницы.

41* **Вызовы инструментов Claude**: вызов одного из инструментов MCP плагина и команда Bash, которая запускает исполняемый файл из `bin/` плагина, являются вызовами инструментов, поэтому к ним применяются ваши правила разрешений. Чтобы узнать, что mod может делать с вызовом инструмента, см. [Решите, доверять ли mod](/docs/ru/plugins/mods/overview#decide-whether-to-trust-a-mod).42* **Вызовы инструментов Claude**: вызов одного из инструментов MCP плагина и команда Bash, которая запускает исполняемый файл из `bin/` плагина, являются вызовами инструментов, поэтому к ним применяются ваши правила разрешений. Чтобы узнать, что mod может делать с вызовом инструмента, см. [Решите, доверять ли mod](/docs/ru/plugins/mods/overview#decide-whether-to-trust-a-mod).

42 43

43Установка плагина также включает его, если только его манифест или запись маркетплейса не устанавливают [`defaultEnabled: false`](/docs/ru/plugins/install#choose-an-install-scope) и вы сами его не включили.44Установка плагина также включает его, если только его манифест или запись маркетплейса не устанавливают [`defaultEnabled: false`](/docs/ru/plugins/install#choose-an-install-scope) и вы сами его не включили.

quickstart.md +16 −14

Details

53 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd53 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

54 ```54 ```

55 55

56 Когда установщик завершит работу, откройте новое окно терминала и выполните `claude --version`. Работающая установка выводит номер версии. Если ваша оболочка говорит, что `claude` не найден или не распознан, каталог установки еще не находится в вашем PATH: см. [Исправьте ваш PATH](/docs/ru/troubleshoot-install#command-not-found-claude-after-installation).56 Команда установки не показывает прогресс во время загрузки Claude Code. Когда установщик завершит работу, откройте новое окно терминала и выполните `claude --version`. Работающая установка выводит номер версии. Если ваша оболочка говорит, что `claude` не найден или не распознан, каталог установки еще не находится в вашем PATH: см. [Исправьте ваш PATH](/docs/ru/troubleshoot-install#command-not-found-claude-after-installation).

57 57

58 Если вы видите `The token '&&' is not a valid statement separator`, вы находитесь в PowerShell, а не в CMD. Если вы видите `'irm' is not recognized as an internal or external command`, вы находитесь в CMD, а не в PowerShell.58 Если вы видите `The token '&&' is not a valid statement separator`, вы находитесь в PowerShell, а не в CMD. Если вы видите `'irm' is not recognized as an internal or external command`, вы находитесь в CMD, а не в PowerShell.

59 59

229 Шаг 7: Попробуйте другие распространённые рабочие процессы229 Шаг 7: Попробуйте другие распространённые рабочие процессы

230</h2>230</h2>

231 231

232Существует несколько способов работы с Claude:232Попробуйте ещё несколько промптов. Вы можете попросить Claude выполнить рефакторинг кода, написать тесты, обновить документацию или проверить ваши изменения:

~~233~~

234**Рефакторинг кода**

235 233

236```text wrap theme={null}234```text wrap theme={null}

237refactor the authentication module to use async/await instead of callbacks235refactor the authentication module to use async/await instead of callbacks

238```236```

239 237

240**Написание тестов**

~~241~~

242```text wrap theme={null}238```text wrap theme={null}

243write unit tests for the calculator functions239write unit tests for the calculator functions

244```240```

245 241

246**Обновление документации**

~~247~~

248```text wrap theme={null}242```text wrap theme={null}

249update the README with installation instructions243update the README with installation instructions

250```244```

251 245

252**Код-ревью**

~~253~~

254```text wrap theme={null}246```text wrap theme={null}

255review my changes and suggest improvements247review my changes and suggest improvements

256```248```

263 Основные команды255 Основные команды

264</h2>256</h2>

265 257

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

267 259

268**Команды оболочки**260<h3 id="shell-commands">

261 Команды оболочки

262</h3>

263

264Запускайте их из вашего терминала, чтобы запустить или возобновить Claude Code.

269 265

271| - | - | - |267| - | - | - |

277 273

278**Команды сеанса**274Смотрите [справочник CLI](/docs/ru/cli-reference) для полного списка команд оболочки.

275

276<h3 id="session-commands">

277 Команды сессии

278</h3>

279

280Запускайте их внутри Claude Code после его запуска.

279 281

281| - | - | - |283| - | - | - |

285 287

286Смотрите [справочник CLI](/docs/ru/cli-reference) для полного списка команд оболочки и [справочник команд](/docs/ru/commands) для полного списка команд сеанса.288Смотрите [справочник команд](/docs/ru/commands) для полного списка команд сессии.

287 289

288<h2 id="pro-tips-for-beginners">290<h2 id="pro-tips-for-beginners">

289 Советы для начинающих291 Советы для начинающих

remote-control.md +2 −2

Details

201* **`false`**: отключить автоподключение, хотя `true` из [управляемых параметров](/docs/ru/managed-settings) имеет приоритет, потому что Claude Code сохраняет выбор в ваши пользовательские параметры. `false` в параметрах проекта или локальных параметрах (`.claude/settings.json`, `.claude/settings.local.json`) отключает автоподключение даже над управляемым `true`.201* **`false`**: отключить автоподключение, хотя `true` из [управляемых параметров](/docs/ru/managed-settings) имеет приоритет, потому что Claude Code сохраняет выбор в ваши пользовательские параметры. `false` в параметрах проекта или локальных параметрах (`.claude/settings.json`, `.claude/settings.local.json`) отключает автоподключение даже над управляемым `true`.

202* **`default`**: очистить ваш выбор и следовать администраторскому значению по умолчанию вашей организации, если оно установлено, иначе текущему значению по умолчанию Claude Code.202* **`default`**: очистить ваш выбор и следовать администраторскому значению по умолчанию вашей организации, если оно установлено, иначе текущему значению по умолчанию Claude Code.

203 203

204Тот же переключатель появляется вне CLI:204Расширение VS Code и приложение Desktop также имеют переключатель автоподключения:

205 205

206* **Приложение Desktop**: **Settings > Claude Code > Connect new sessions to Remote Control**.

207* **Расширение VS Code**: **Enable Remote Control for all sessions** в разделе Settings [меню команд](/docs/ru/vs-code#use-the-prompt-box).206* **Расширение VS Code**: **Enable Remote Control for all sessions** в разделе Settings [меню команд](/docs/ru/vs-code#use-the-prompt-box).

207* **Приложение Desktop**: **Settings > Claude Code > Connect new sessions to Remote Control**. См. [Управление тем, какие сессии появляются на других ваших устройствах](/docs/ru/desktop#control-which-sessions-appear-on-your-other-devices).

208 208

209Чтобы вместо этого включить автоподключение из файла параметров, установите [`remoteControlAtStartup`](/docs/ru/settings-reference#remotecontrolatstartup) на `true` в ваш пользовательский файл `~/.claude/settings.json` или в [управляемые параметры](/docs/ru/managed-settings). В параметрах проекта или локальных параметрах (`.claude/settings.json`, `.claude/settings.local.json`), Claude Code соблюдает `false` и отключает автоподключение для этого репозитория, но игнорирует `true`, поэтому проверенный файл не может включить Remote Control для всех, кто открывает репозиторий.209Чтобы вместо этого включить автоподключение из файла параметров, установите [`remoteControlAtStartup`](/docs/ru/settings-reference#remotecontrolatstartup) на `true` в ваш пользовательский файл `~/.claude/settings.json` или в [управляемые параметры](/docs/ru/managed-settings). В параметрах проекта или локальных параметрах (`.claude/settings.json`, `.claude/settings.local.json`), Claude Code соблюдает `false` и отключает автоподключение для этого репозитория, но игнорирует `true`, поэтому проверенный файл не может включить Remote Control для всех, кто открывает репозиторий.

210 210

routines.md +1 −1

Details

93 Выберите [облачное окружение](/docs/ru/cloud-environments) для рутины. Окружения контролируют, к чему имеет доступ облачный сеанс:93 Выберите [облачное окружение](/docs/ru/cloud-environments) для рутины. Окружения контролируют, к чему имеет доступ облачный сеанс:

94 94

95 * **Network access**: установите уровень доступа в Интернет, доступный во время каждого запуска95 * **Network access**: установите уровень доступа в Интернет, доступный во время каждого запуска

96 * **Environment variables**: предоставьте значения, которые Claude может использовать во время каждого запуска. Они [видны всем, кто использует окружение](/docs/ru/cloud-environments#what-carries-over-from-your-setup), поэтому в планах Pro и Max храните ключи для API, которые Claude вызывает во время запуска, в виде [сетевых секретов](/docs/ru/cloud-environments#add-api-credentials). В этом разделе также перечислены запросы, которые никогда не получают секрет96 * **Environment variables**: предоставьте значения, которые Claude может использовать во время каждого запуска. Они [видны всем, кто использует окружение](/docs/ru/cloud-environments#what-carries-over-from-your-setup), поэтому в планах Pro и Max храните ключи для API, которые Claude вызывает во время запуска, в виде [сетевых секретов](/docs/ru/cloud-environments#add-network-secrets). В этом разделе также перечислены запросы, которые никогда не получают секрет

97 * **Setup script**: установите зависимости и инструменты, которые нужны рутине. Результат [кэшируется](/docs/ru/cloud-environments#environment-caching), поэтому скрипт не переустанавливается при каждом сеансе97 * **Setup script**: установите зависимости и инструменты, которые нужны рутине. Результат [кэшируется](/docs/ru/cloud-environments#environment-caching), поэтому скрипт не переустанавливается при каждом сеансе

98 98

99 Предоставляется окружение **Default** с доступом в сеть **Trusted**, который позволяет только [набор по умолчанию](/docs/ru/cloud-environments#default-allowed-domains) реестров пакетов, API облачных провайдеров, реестров контейнеров и распространенных доменов разработки через сеть сеанса. Коннекторы, которые вы добавляете к рутине, достигают своих сервисов через серверы Anthropic, поэтому им не нужны изменения списка разрешений. Если вашей рутине нужно достичь ваших собственных сервисов напрямую или домена вне этого списка, отредактируйте [сетевой доступ](/docs/ru/cloud-environments#network-access) окружения перед запуском. Чтобы использовать отдельное окружение, [создайте его](/docs/ru/cloud-environments#configure-your-environment) сначала.99 Предоставляется окружение **Default** с доступом в сеть **Trusted**, который позволяет только [набор по умолчанию](/docs/ru/cloud-environments#default-allowed-domains) реестров пакетов, API облачных провайдеров, реестров контейнеров и распространенных доменов разработки через сеть сеанса. Коннекторы, которые вы добавляете к рутине, достигают своих сервисов через серверы Anthropic, поэтому им не нужны изменения списка разрешений. Если вашей рутине нужно достичь ваших собственных сервисов напрямую или домена вне этого списка, отредактируйте [сетевой доступ](/docs/ru/cloud-environments#network-access) окружения перед запуском. Чтобы использовать отдельное окружение, [создайте его](/docs/ru/cloud-environments#configure-your-environment) сначала.

sandbox-environments.md +2 −2

Details

76 Этот вариант не поддерживает нативный Windows. На хостах Windows используйте WSL2 или один из подходов контейнера или VM ниже.76 Этот вариант не поддерживает нативный Windows. На хостах Windows используйте WSL2 или один из подходов контейнера или VM ниже.

77</Note>77</Note>

78 78

79Sandboxed Bash tool встроен в Claude Code. Он использует примитивы операционной системы для ограничения доступа к файловой системе и сети каждой команды Bash, PowerShell или Monitor, которую запускает Claude.79Sandboxed Bash tool встроен в Claude Code. Он использует примитивы операционной системы для ограничения доступа к файловой системе и сети для команд инструментов Bash, PowerShell и Monitor, которые запускает Claude.

80 80

81Запустите команду `/sandbox` для открытия панели песочницы и выберите режим. Руководство [Sandboxing](/docs/ru/sandboxing) охватывает режимы одобрения, границу по умолчанию и как расширить или сузить ее.81Запустите команду `/sandbox` для открытия панели песочницы и выберите режим. Руководство [Sandboxing](/docs/ru/sandboxing) охватывает режимы одобрения, границу по умолчанию и как расширить или сузить ее.

82 82

83Песочница для каждой команды не охватывает все, что работает в сеансе:83Песочница для каждой команды не охватывает все, что работает в сеансе:

84 84

85* Другие [встроенные инструменты](/docs/ru/tools-reference), такие как Read, Edit и WebFetch, работают внутри процесса Claude Code и не порождают произвольный код. [Правила разрешений](/docs/ru/permissions) для пути или домена управляют ими вместо этого.85* Другие [встроенные инструменты](/docs/ru/tools-reference), такие как Read, Edit и WebFetch, работают внутри процесса Claude Code и не порождают произвольный код. [Правила разрешений](/docs/ru/permissions) для пути или домена управляют ими вместо этого.

86* Серверы [MCP](/docs/ru/mcp) и [command hooks](/docs/ru/hooks#command-hook-fields) — это отдельные процессы, которые работают без ограничений на хосте.86* [MCP](/docs/ru/mcp)-серверы, [командные хуки](/docs/ru/hooks#command-hook-fields) и [мониторы плагинов](/docs/ru/plugins/components#monitors) — это отдельные процессы, которые работают без ограничений на хосте. О других процессах, работающих таким образом, см. [Что работает вне песочницы](/docs/ru/sandboxing#what-runs-outside-the-sandbox).

87 87

88Чтобы поместить встроенные инструменты, серверы MCP и hooks все позади одной границы ОС, запустите весь процесс Claude Code внутри [sandbox runtime](#sandbox-runtime), [dev container](#dev-containers) или [custom container](#custom-container).88Чтобы поместить встроенные инструменты, серверы MCP и hooks все позади одной границы ОС, запустите весь процесс Claude Code внутри [sandbox runtime](#sandbox-runtime), [dev container](#dev-containers) или [custom container](#custom-container).

89 89

sandboxing.md +1 −1

Details

698Правила разрешений и sandboxing контролируют разные вещи:698Правила разрешений и sandboxing контролируют разные вещи:

699 699

700* **Правила разрешений** контролируют, какие инструменты может использовать Claude Code, и оцениваются перед запуском любого инструмента. Они применяются ко всем инструментам: Bash, Read, Edit, WebFetch, MCP и другим, за исключением того, что правило deny или ask не может заблокировать [`EndConversation`](/docs/ru/tools-reference#endconversation-tool-behavior), пока остаётся любой другой инструмент.700* **Правила разрешений** контролируют, какие инструменты может использовать Claude Code, и оцениваются перед запуском любого инструмента. Они применяются ко всем инструментам: Bash, Read, Edit, WebFetch, MCP и другим, за исключением того, что правило deny или ask не может заблокировать [`EndConversation`](/docs/ru/tools-reference#endconversation-tool-behavior), пока остаётся любой другой инструмент.

701* **Sandboxing** обеспечивает применение на уровне ОС, которое ограничивает, к чему могут получить доступ команды Bash на уровне файловой системы и сети. Это применяется только к командам Bash, PowerShell и [Monitor](/docs/ru/tools-reference#monitor-tool) и их дочерним процессам.701* **Sandboxing** обеспечивает применение на уровне ОС, которое ограничивает, к чему могут получить доступ shell-команды на уровне файловой системы и сети. Это применяется к командам инструментов Bash, PowerShell и [Monitor](/docs/ru/tools-reference#monitor-tool) и их дочерним процессам.

702 702

703Два слоя также отличаются способом их применения. Claude Code оценивает решения разрешений перед запуском команды на основе строки команды и, в режиме auto, отдельного классификатора, который судит о безопасности команды. Операционная система применяет границу sandbox к работающему процессу, поэтому она действует независимо от того, что выбрала модель для запуска, и даже если разрешённая команда делает больше, чем предполагает её имя.703Два слоя также отличаются способом их применения. Claude Code оценивает решения разрешений перед запуском команды на основе строки команды и, в режиме auto, отдельного классификатора, который судит о безопасности команды. Операционная система применяет границу sandbox к работающему процессу, поэтому она действует независимо от того, что выбрала модель для запуска, и даже если разрешённая команда делает больше, чем предполагает её имя.

704 704

server-managed-settings.md +6 −1

Details

348 348

349Ни ключи, возвращаемые скриптом [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper), ни учетные данные [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) не запускают выборку параметров.349Ни ключи, возвращаемые скриптом [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper), ни учетные данные [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) не запускают выборку параметров.

350 350

351Сессия получает управляемые настройки той организации, которой принадлежат учётные данные, используемые ею для аутентификации. API-ключ из [Claude Console](https://platform.claude.com) принадлежит организации Console, в которой он был создан, и это отдельная организация, отличная от вашей организации Team или Enterprise на claude.ai. Поэтому настройки, которые вы задаёте в Admin Settings на claude.ai, не доходят до сессии, которая аутентифицируется с помощью этого ключа, например до задания CI, использующего API-ключ Console вашей компании. Чтобы применить их к такому заданию, используйте один из следующих вариантов. Вариант с токеном OAuth не подходит для задания, запускаемого с [`--bare`](/docs/ru/headless#start-faster-with-bare-mode), поскольку режим bare не читает `CLAUDE_CODE_OAUTH_TOKEN`.

352

353* **Токен OAuth**: сгенерируйте токен с помощью [`claude setup-token`](/docs/ru/authentication#generate-a-long-lived-token), авторизуйте его для вашей организации Team или Enterprise и задайте его как `CLAUDE_CODE_OAUTH_TOKEN` в окружении задания. Удалите из этого окружения все учётные данные, которые [имеют приоритет](/docs/ru/authentication#authentication-precedence) над токеном, например `ANTHROPIC_API_KEY`.

354* **Настройки, управляемые конечной точкой**: разверните [файл управляемых настроек](/docs/ru/managed-settings#delivery-mechanisms) на машине, на которой выполняется задание.

355

351В сеансе [Cowork](https://claude.com/docs/cowork/overview) в приложении Claude Desktop Claude Code не получает параметры, управляемые сервером, из консоли администратора claude.ai, даже если пользователь входит с учетной записью Team или Enterprise. [Где и когда применяется политика](/docs/ru/managed-settings#where-and-when-a-policy-applies) охватывает, какая политика достигает сеансов Cowork на машине пользователя и удаленных сеансов Cowork. claude.ai по-прежнему применяет ваши списки [`strictKnownMarketplaces`](/docs/ru/settings-reference#strictknownmarketplaces) и [`blockedMarketplaces`](/docs/ru/settings-reference#blockedmarketplaces) сам по себе, когда пользователь Cowork добавляет marketplace из репозитория git на claude.ai или из **Customize** на вкладке Cowork. [Как работают ограничения](/docs/ru/plugins/org#restrict-what-users-can-install) описывает эту проверку.356В сеансе [Cowork](https://claude.com/docs/cowork/overview) в приложении Claude Desktop Claude Code не получает параметры, управляемые сервером, из консоли администратора claude.ai, даже если пользователь входит с учетной записью Team или Enterprise. [Где и когда применяется политика](/docs/ru/managed-settings#where-and-when-a-policy-applies) охватывает, какая политика достигает сеансов Cowork на машине пользователя и удаленных сеансов Cowork. claude.ai по-прежнему применяет ваши списки [`strictKnownMarketplaces`](/docs/ru/settings-reference#strictknownmarketplaces) и [`blockedMarketplaces`](/docs/ru/settings-reference#blockedmarketplaces) сам по себе, когда пользователь Cowork добавляет marketplace из репозитория git на claude.ai или из **Customize** на вкладке Cowork. [Как работают ограничения](/docs/ru/plugins/org#restrict-what-users-can-install) описывает эту проверку.

352 357

353Если вы экспортируете переменную поставщика `CLAUDE_CODE_USE_*` или нестандартный `ANTHROPIC_BASE_URL` в вашей оболочке, Claude Code пропускает выборку параметров для ваших сеансов. [`claude doctor` и `/status` сообщают о пропущенной выборке и ее причине](#verify-settings-delivery).358Если вы экспортируете переменную поставщика `CLAUDE_CODE_USE_*` или нестандартный `ANTHROPIC_BASE_URL` в вашей оболочке, Claude Code пропускает выборку параметров для ваших сеансов. [`claude doctor` и `/status` сообщают о пропущенной выборке и ее причине](#verify-settings-delivery).

379| Пользователь запускает измененный двоичный файл Claude Code | Пользователь, который может запустить измененный клиент, может обойти любой элемент управления на стороне клиента |384| Пользователь запускает измененный двоичный файл Claude Code | Пользователь, который может запустить измененный клиент, может обойти любой элемент управления на стороне клиента |

380| Пользователь запускает более старую версию Claude Code | Версии, которые предшествуют параметрам, управляемым сервером, не выбирают и не применяют их |385| Пользователь запускает более старую версию Claude Code | Версии, которые предшествуют параметрам, управляемым сервером, не выбирают и не применяют их |

381| API недоступен | Кэшированные параметры применяются, если доступны, за исключением [значений, которые Claude Code удерживает](#fetch-and-caching-behavior) до успешной выборки. Без кэша Claude Code не применяет параметры, управляемые сервером, до следующей успешной выборки, и по-прежнему применяет любые [параметры, управляемые конечной точкой](/docs/ru/managed-settings#delivery-mechanisms) на устройстве. С `forceRemoteSettingsRefresh: true` CLI выходит вместо продолжения, за исключением [`claude auth` подкоманд](#enforce-fail-closed-startup). Клиенты, вошедшие через [шлюз приложений Claude](#platform-availability), выходят при запуске без этого параметра, с той же исключением `claude auth` |386| API недоступен | Кэшированные параметры применяются, если доступны, за исключением [значений, которые Claude Code удерживает](#fetch-and-caching-behavior) до успешной выборки. Без кэша Claude Code не применяет параметры, управляемые сервером, до следующей успешной выборки, и по-прежнему применяет любые [параметры, управляемые конечной точкой](/docs/ru/managed-settings#delivery-mechanisms) на устройстве. С `forceRemoteSettingsRefresh: true` CLI выходит вместо продолжения, за исключением [`claude auth` подкоманд](#enforce-fail-closed-startup). Клиенты, вошедшие через [шлюз приложений Claude](#platform-availability), выходят при запуске без этого параметра, с той же исключением `claude auth` |

382| Пользователь аутентифицируется с другой организацией | Параметры не доставляются для учетных записей вне управляемой организации |387| Пользователь аутентифицируется с другой организацией | Настройки не доставляются для учётных записей вне управляемой организации, включая сессию, которая аутентифицируется с помощью [API-ключа Console](#platform-availability) |

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

384| Сетевой трафик перехватывается или перенаправляется | Отключенная проверка TLS или перехваченный трафик могут изменить параметры, которые получает клиент |389| Сетевой трафик перехватывается или перенаправляется | Отключенная проверка TLS или перехваченный трафик могут изменить параметры, которые получает клиент |

385 390

settings-reference.md +15 −6

Details

1399 1399

1400Выберите, что происходит, когда [классификатор безопасности помечает запрос](/docs/ru/model-config#automatic-model-fallback): переключиться на резервную модель и продолжить, или приостановиться, чтобы вы могли выбрать между переключением и редактированием подсказки.1400Выберите, что происходит, когда [классификатор безопасности помечает запрос](/docs/ru/model-config#automatic-model-fallback): переключиться на резервную модель и продолжить, или приостановиться, чтобы вы могли выбрать между переключением и редактированием подсказки.

1401 1401

1402* **Область действия**: [`Any file`](#scopes). Появляется в `/config` как **Switch models when a message is flagged**.1402* **Область действия**: [`Any file`](#scopes). Отображается в `/config` как **Switch models when a message is flagged** с вариантами **Switch automatically** и **Ask each time**.

1403* **Тип**: Boolean1403* **Тип**: Boolean

1404 * `true`: Claude Code переключается на резервную модель и продолжает1404 * `true`: Claude Code переключается на резервную модель и продолжает

1405 * `false`: в интерактивном сеансе Claude Code приостанавливается, чтобы вы могли выбрать между переключением и редактированием подсказки; где диалог не может показаться, такой как запуск `-p`, помеченный запрос заканчивается как ошибка1405 * `false`: в интерактивном сеансе Claude Code приостанавливается, чтобы вы могли выбрать между переключением и редактированием подсказки; где диалог не может показаться, такой как запуск `-p`, помеченный запрос заканчивается как ошибка

1406* **По умолчанию**: `true`, переключаться автоматически1406* **По умолчанию**: не установлено. Claude Code переключается автоматически, хотя в интерактивной сессии может [сначала спросить](/docs/ru/model-config#ask-before-switching)

1407 1407

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

1409{1409{

3164 `plansDirectory`3164 `plansDirectory`

3165</h3>3165</h3>

3166 3166

3167Выберите, где Claude Code хранит файлы плана, которые он записывает в [режиме плана](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode). Claude Code разрешает путь относительно корня проекта и сохраняет значение по умолчанию, когда путь разрешается вне его.3167Выберите, где Claude Code хранит файлы плана, которые он записывает в [режиме планирования](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode). Claude Code разрешает путь относительно корня проекта.

3168 3168

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

3170* **Type**: строка, путь относительно корня проекта3170* **Type**: строка, путь относительно корня проекта

3176}3176}

3177```3177```

3178 3178

3179Claude Code хранит планы в `~/.claude/plans` вместо заданного вами каталога, например, в следующих случаях:

3180

3181* **Вне корня проекта**: путь разрешается за пределами корня проекта, как в случае `"../plans"`.

3182* **Обратная косая черта в macOS, Linux и WSL**: разрешённый путь содержит обратную косую черту, как в пути в стиле Windows `"docs\\plans"`. Пишите `"docs/plans"` — такой путь работает и в Windows.

3183

3179<h3 id="skilllistingbudgetfraction">3184<h3 id="skilllistingbudgetfraction">

3180 `skillListingBudgetFraction`3185 `skillListingBudgetFraction`

3181</h3>3186</h3>

5768 5773

5769Отключить сеансы Code, которые работают на устройстве в [настольном приложении](/docs/ru/desktop#local-sessions-on-managed-devices), для развёртываний, где разработчики должны работать на удалённых машинах через SSH. На вкладке Code окружение **Local** остаётся в раскрывающемся списке окружений, но отключено и не может быть выбрано, с подсказкой, что ваша организация его отключила; на Windows запись WSL отключена таким же образом, хотя то, работают ли сеансы WSL на управляемом устройстве вообще, [управляется отдельно](/docs/ru/admin-setup#wsl-sessions-in-claude-code-desktop). Новые сеансы по умолчанию используют первое [SSH-соединение](/docs/ru/desktop#ssh-sessions), если оно настроено, и приложение отказывается запускать или возобновлять сеанс на устройстве, включая SSH-соединение обратно на ту же машину. SSH-сеансы на другие хосты и облачные сеансы не затронуты. Настольное приложение читает этот ключ; терминальный CLI его игнорирует. Требуется Claude Desktop v1.37937.0 или позже.5774Отключить сеансы Code, которые работают на устройстве в [настольном приложении](/docs/ru/desktop#local-sessions-on-managed-devices), для развёртываний, где разработчики должны работать на удалённых машинах через SSH. На вкладке Code окружение **Local** остаётся в раскрывающемся списке окружений, но отключено и не может быть выбрано, с подсказкой, что ваша организация его отключила; на Windows запись WSL отключена таким же образом, хотя то, работают ли сеансы WSL на управляемом устройстве вообще, [управляется отдельно](/docs/ru/admin-setup#wsl-sessions-in-claude-code-desktop). Новые сеансы по умолчанию используют первое [SSH-соединение](/docs/ru/desktop#ssh-sessions), если оно настроено, и приложение отказывается запускать или возобновлять сеанс на устройстве, включая SSH-соединение обратно на ту же машину. SSH-сеансы на другие хосты и облачные сеансы не затронуты. Настольное приложение читает этот ключ; терминальный CLI его игнорирует. Требуется Claude Desktop v1.37937.0 или позже.

5770 5775

5771* **Scope**: [`Managed`](#scopes)5776* **Scope**: [`Managed`](#scopes). По умолчанию настольное приложение читает ключ из [одного управляемого источника](/docs/ru/managed-settings#how-claude-code-combines-managed-sources).

5772* **Type**: Boolean; только JSON Boolean `true` имеет эффект5777* **Type**: Boolean; только JSON Boolean `true` имеет эффект

5773 * `true`: настольное приложение не предлагает сеансы Code на устройстве; существующие локальные сеансы остаются в списке, но не могут продолжаться5778 * `true`: настольное приложение не предлагает сеансы Code на устройстве; существующие локальные сеансы остаются в списке, но не могут продолжаться

5774 * `false`: локальные сеансы остаются доступными5779 * `false`: локальные сеансы остаются доступными

5915 5920

5916Добавить SSH-соединения в раскрывающийся список окружения [Desktop](/docs/ru/desktop#pre-configure-ssh-connections-for-your-team). Администраторы используют это для распределения общих соединений команде. Соединения, которые вы определяете в управляемых настройках, отображаются как управляемые, поэтому пользователи могут их выбирать, но не могут редактировать или удалять их в приложении.5921Добавить SSH-соединения в раскрывающийся список окружения [Desktop](/docs/ru/desktop#pre-configure-ssh-connections-for-your-team). Администраторы используют это для распределения общих соединений команде. Соединения, которые вы определяете в управляемых настройках, отображаются как управляемые, поэтому пользователи могут их выбирать, но не могут редактировать или удалять их в приложении.

5917 5922

5918* **Scope**: [`User or managed`](#scopes). Настольное приложение читает этот ключ.5923* **Scope**: [`User or managed`](#scopes). Настольное приложение читает этот ключ. По умолчанию оно читает управляемые соединения из [одного управляемого источника](/docs/ru/managed-settings#how-claude-code-combines-managed-sources).

5919* **Type**: массив объектов, каждый с обязательными `id`, `name` и `sshHost` и опциональными `sshPort` и `sshIdentityFile`5924* **Type**: массив объектов, каждый с обязательными `id`, `name` и `sshHost` и опциональными `sshPort` и `sshIdentityFile`

5920* **Default**: не установлено5925* **Default**: не установлено

5921 5926

5939 5944

5940Ограничить хосты, к которым может подключиться [SSH-сеанс Desktop](/docs/ru/desktop#restrict-which-ssh-hosts-users-can-connect-to). Только приложение Desktop читает этот ключ; CLI не читает. Шаблоны нечувствительны к регистру: `*` соответствует любому хосту, `*.example.com` соответствует `example.com` и каждому поддомену, и всё остальное является точным совпадением с именем хоста после разрешения `~/.ssh/config`. Пустой массив отключает SSH-сеансы.5945Ограничить хосты, к которым может подключиться [SSH-сеанс Desktop](/docs/ru/desktop#restrict-which-ssh-hosts-users-can-connect-to). Только приложение Desktop читает этот ключ; CLI не читает. Шаблоны нечувствительны к регистру: `*` соответствует любому хосту, `*.example.com` соответствует `example.com` и каждому поддомену, и всё остальное является точным совпадением с именем хоста после разрешения `~/.ssh/config`. Пустой массив отключает SSH-сеансы.

5941 5946

5942* **Scope**: [`Managed`](#scopes)5947* **Scope**: [`Managed`](#scopes). По умолчанию Desktop читает ключ из [одного управляемого источника](/docs/ru/managed-settings#how-claude-code-combines-managed-sources).

5943* **Type**: массив шаблонов имён хостов5948* **Type**: массив шаблонов имён хостов

5944* **Default**: не установлено, поэтому разрешены любые хосты5949* **Default**: не установлено, поэтому разрешены любые хосты

5945 5950

5951}5956}

5952```5957```

5953 5958

5959Значение, которое Desktop не может прочитать как список хостов, например `true` или объект, считается пустым массивом, пока вы его не исправите, за исключением `null`, который считается неустановленным значением. Требуется Claude Desktop v2.26454.0 или позже.

5960

5961Если вы установите [`managedSourcesBehavior`](#managedsourcesbehavior) в `"merge"` в источнике с наивысшим приоритетом, Desktop объединяет списки из всех [источников администратора](/docs/ru/managed-settings#how-claude-code-combines-managed-sources) и разрешает хост, который соответствует любому из них. Если вы установите пустой массив в одном источнике, SSH-сессии остаются включёнными для хостов, перечисленных в другом источнике.

5962

5954<span id="authentication-and-login" />5963<span id="authentication-and-login" />

5955 5964

5956<h2 id="authentication-and-providers">5965<h2 id="authentication-and-providers">

setup.md +12 −8

Details

63 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd63 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

64 ```64 ```

65 65

66 Когда установщик завершит работу, откройте новое окно терминала и выполните `claude --version`. Работающая установка выводит номер версии. Если ваша оболочка говорит, что `claude` не найден или не распознан, каталог установки еще не находится в вашем PATH: см. [Исправьте ваш PATH](/docs/ru/troubleshoot-install#command-not-found-claude-after-installation).66 Команда установки не показывает прогресс во время загрузки Claude Code. Когда установщик завершит работу, откройте новое окно терминала и выполните `claude --version`. Работающая установка выводит номер версии. Если ваша оболочка говорит, что `claude` не найден или не распознан, каталог установки еще не находится в вашем PATH: см. [Исправьте ваш PATH](/docs/ru/troubleshoot-install#command-not-found-claude-after-installation).

67 67

68 Если вы видите `The token '&&' is not a valid statement separator`, вы находитесь в PowerShell, а не в CMD. Если вы видите `'irm' is not recognized as an internal or external command`, вы находитесь в CMD, а не в PowerShell.68 Если вы видите `The token '&&' is not a valid statement separator`, вы находитесь в PowerShell, а не в CMD. Если вы видите `'irm' is not recognized as an internal or external command`, вы находитесь в CMD, а не в PowerShell.

69 69

119 119

121| - | - | - | - |121| - | - | - | - |

125 125

126**Вариант 1: Native Windows**126<h4 id="install-on-native-windows">

127 Установка в нативной Windows

128</h4>

127 129

128Выполните команду установки из PowerShell или CMD. Вам не нужно запускать от имени администратора. Установка [Git for Windows](https://git-scm.com/downloads/win) опциональна. Она предоставляет Git Bash, который нужен [инструменту Bash](/docs/ru/tools-reference#bash-tool-behavior) и [инструменту Monitor](/docs/ru/tools-reference#monitor-tool).130Выполните [команду установки](#install-claude-code) из PowerShell или CMD. Вам не нужно запускать от имени администратора. Установка [Git for Windows](https://git-scm.com/downloads/win) опциональна. Она предоставляет Git Bash, который нужен [инструменту Bash](/docs/ru/tools-reference#bash-tool-behavior) и [инструменту Monitor](/docs/ru/tools-reference#monitor-tool).

129 131

130Независимо от того, устанавливаете ли вы из PowerShell или CMD, это влияет только на то, какую команду установки вы выполняете. Ваша подсказка показывает `PS C:\Users\YourName>` в PowerShell и `C:\Users\YourName>` без `PS` в CMD. Если вы новичок в терминале, [руководство по терминалу](/docs/ru/terminal-guide#windows) проходит через каждый шаг.132Независимо от того, устанавливаете ли вы из PowerShell или CMD, это влияет только на то, какую команду установки вы выполняете. Ваша подсказка показывает `PS C:\Users\YourName>` в PowerShell и `C:\Users\YourName>` без `PS` в CMD. Если вы новичок в терминале, [руководство по терминалу](/docs/ru/terminal-guide#windows) проходит через каждый шаг.

131 133

144 146

145Когда установлен Git for Windows, инструмент PowerShell доступен наряду с Bash: включен по умолчанию для учетных записей claude.ai и Console, и включен с помощью `CLAUDE_CODE_USE_POWERSHELL_TOOL=1` в сеансах Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry. Установите его на `0`, чтобы отключить инструмент. См. [инструмент PowerShell](/docs/ru/tools-reference#powershell-tool) для настройки и ограничений.147Когда установлен Git for Windows, инструмент PowerShell доступен наряду с Bash: включен по умолчанию для учетных записей claude.ai и Console, и включен с помощью `CLAUDE_CODE_USE_POWERSHELL_TOOL=1` в сеансах Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry. Установите его на `0`, чтобы отключить инструмент. См. [инструмент PowerShell](/docs/ru/tools-reference#powershell-tool) для настройки и ограничений.

146 148

147**Вариант 2: WSL**149<h4 id="install-in-wsl">

150 Установка в WSL

151</h4>

148 152

149Откройте ваше распределение WSL и выполните установщик Linux из [инструкций установки](#install-claude-code) выше. Вы устанавливаете и запускаете `claude` внутри терминала WSL, а не из PowerShell или CMD.153Откройте ваш дистрибутив WSL и выполните установщик Linux из [инструкций установки](#install-claude-code). Вы устанавливаете и запускаете `claude` внутри терминала WSL, а не из PowerShell или CMD.

150 154

151<h3 id="alpine-linux-and-musl-based-distributions">155<h3 id="alpine-linux-and-musl-based-distributions">

152 Alpine Linux и дистрибутивы на основе musl156 Alpine Linux и дистрибутивы на основе musl

skills.md +15 −0

Details

36 36

37Встроенные skills перечислены вместе со встроенными командами в [справочнике команд](/docs/ru/commands), отмечены как **Skill** в столбце Purpose.37Встроенные skills перечислены вместе со встроенными командами в [справочнике команд](/docs/ru/commands), отмечены как **Skill** в столбце Purpose.

38 38

39<h3 id="check-your-setup-with-/doctor">

40 Проверка настройки с помощью `/doctor`

41</h3>

43Запустите `/doctor` в промпте Claude Code, чтобы выполнить проверку настройки, которая диагностирует проблемы и может их исправить. Claude сначала сообщает о результатах и запрашивает подтверждение, прежде чем что-либо изменить. Проверка охватывает следующие области:

45* **Состояние установки**: дублирующиеся или оставшиеся установки, проблемы с `PATH`, файлы настроек, которые не удается разобрать, а также наличие более новой версии в вашем [канале выпусков](/docs/ru/setup#configure-release-channel)

46* **Расширения**: неиспользуемые skills, MCP-серверы и плагины в сравнении с их затратами контекста, а также медленные [хуки](/docs/ru/hooks)

47* **Файлы `CLAUDE.md`**: локальные файлы `CLAUDE.md`, дублирующие файлы из репозитория, [содержимое `CLAUDE.md` в репозитории, которое Claude мог бы вывести из кодовой базы](/docs/ru/memory#my-claude-md-is-too-large), а также оставшиеся всегда загружаемые указания, которые Claude предлагает перенести в skills и вложенные файлы `CLAUDE.md`, загружаемые по требованию

48* **Разрешения**: предложение сделать [авторежим](/docs/ru/permissions#permission-modes) вашим режимом разрешений по умолчанию и [заранее одобрить](/docs/ru/permissions) команды только для чтения, которые вы часто отклоняете

50Для диагностики установки только для чтения без запуска сессии выполните вместо этого `claude doctor` в терминале.

52Чтобы проверить ваши инструкции, а не настройку, запустите `/doctor prompt-audit` в промпте Claude Code. Вместо проверки настройки Claude [проверяет ваши файлы `CLAUDE.md`, skills и другую конфигурацию](/docs/ru/memory#audit-your-instruction-files) на наличие устаревших или противоречащих друг другу инструкций. Подкоманда `prompt-audit` требует Claude Code v2.1.283 или позже.

39<h3 id="run-and-verify-your-app">54<h3 id="run-and-verify-your-app">

40 Запуск и проверка вашего приложения55 Запуск и проверка вашего приложения

41</h3>56</h3>

statusline.md +87 −38

Details

146 Как работают строки состояния146 Как работают строки состояния

147</h2>147</h2>

148 148

149Claude Code запускает ваш скрипт с [данными сеанса JSON](#available-data) на stdin и отображает всё, что скрипт выводит в stdout.149Claude Code запускает ваш скрипт с [данными сессии JSON](#available-data) на stdin и отображает всё, что скрипт выводит в stdout.

150 150

151**Когда это обновляется**151<Note>Строка состояния работает локально и не потребляет токены API. Она временно скрывается во время определённых взаимодействий с пользовательским интерфейсом, включая меню справки и запросы разрешений.</Note>

152

153<h3 id="when-the-status-line-updates">

154 Когда обновляется строка состояния

155</h3>

152 156

153Ваш скрипт запускается один раз при запуске сеанса, включая случаи, когда вы возобновляете его. После этого он запускается снова, когда:157Ваш скрипт запускается один раз при запуске сессии, включая случаи, когда вы возобновляете её. После этого он запускается снова, когда:

154 158

155* Поступает новое сообщение ассистента159* Поступает новое сообщение ассистента

156* Завершается `/compact`160* Завершается `/compact`

157* Изменяется режим разрешений161* Изменяется режим разрешений

158* Переключается режим Vim162* Переключается режим Vim

159* Вы изменяете `command` в параметрах `statusLine`163* Вы изменяете `command` в настройках `statusLine`

160* Истекает таймер [`refreshInterval`](#manually-configure-a-status-line), если вы его установили164* Истекает таймер [`refreshInterval`](#manually-configure-a-status-line), если вы его установили

161* Окно [ограничения скорости](#rate-limit-usage) в данных, которые получил ваш скрипт, достигает времени `resets_at`165* Окно [ограничения частоты запросов](#rate-limit-usage) в данных, которые последними получил ваш скрипт, достигает времени `resets_at`

162* Тёплый [кэш подсказок](#prompt-cache-fields) в данных, которые получил ваш скрипт, достигает времени `expires_at`166* Тёплый [кэш промптов](#prompt-cache-fields) в данных, которые последними получил ваш скрипт, достигает времени `expires_at`

163 167

164Claude Code дебаунсит обновления на 300 мс, поэтому быстрые изменения объединяются вместе и ваш скрипт запускается один раз после того, как изменения прекратятся. Изменение самой `command` пропускает дебаунс: Claude Code запускает новую команду сразу же. Если новое обновление срабатывает, пока ваш скрипт всё ещё работает, Claude Code отменяет выполняющийся скрипт. Если вы отредактируете свой скрипт, изменения появятся в следующий раз, когда триггер обновления его повторно запустит.168Claude Code дебаунсит обновления на 300 мс, поэтому быстрые изменения объединяются вместе и ваш скрипт запускается один раз после того, как изменения прекратятся. Изменение самой `command` пропускает дебаунс: Claude Code запускает новую команду сразу же. Если новое обновление срабатывает, пока ваш скрипт всё ещё работает, Claude Code отменяет выполняющийся скрипт. Если вы отредактируете свой скрипт, изменения появятся в следующий раз, когда триггер обновления его повторно запустит.

165 169

166Триггеры, управляемые событиями, могут затихнуть, когда основной сеанс неактивен, например, пока координатор ждёт фоновых подагентов. Чтобы сохранить текущими сегменты на основе времени или из внешних источников во время периодов неактивности, установите [`refreshInterval`](#manually-configure-a-status-line) для также повторного запуска команды на фиксированный таймер.170Триггеры, управляемые событиями, могут затихнуть, когда основная сессия неактивна, например, пока координатор ждёт фоновых субагентов. Чтобы сегменты на основе времени или из внешних источников оставались актуальными во время периодов неактивности, установите [`refreshInterval`](#manually-configure-a-status-line), чтобы также повторно запускать команду по фиксированному таймеру.

167 171

168**Что может выводить ваш скрипт**172<h3 id="what-your-script-can-output">

173 Что может выводить ваш скрипт

174</h3>

175

176Ваш скрипт может выводить не только одну строку простого текста:

169 177

170* **Несколько строк**: каждый оператор `echo` или `print` отображается как отдельная строка. См. [пример многострочности](#display-multiple-lines).178* **Несколько строк**: каждый оператор `echo` или `print` отображается как отдельная строка. См. [пример многострочности](#display-multiple-lines).

171* **Цвета**: используйте [коды экранирования ANSI](https://en.wikipedia.org/wiki/ANSI_escape_code#Colors), такие как `\033[32m` для зелёного (терминал должен их поддерживать). См. [пример статуса git](#git-status-with-colors).179* **Цвета**: используйте [коды экранирования ANSI](https://en.wikipedia.org/wiki/ANSI_escape_code#Colors), такие как `\033[32m` для зелёного (терминал должен их поддерживать). См. [пример статуса git](#git-status-with-colors).

172* **Ссылки**: используйте [последовательности экранирования OSC 8](https://en.wikipedia.org/wiki/ANSI_escape_code#OSC) для создания кликабельного текста (Cmd+клик на macOS, Ctrl+клик на Windows/Linux). Требуется терминал, поддерживающий гиперссылки, такой как iTerm2, Kitty или WezTerm. См. [пример кликабельных ссылок](#clickable-links).180* **Ссылки**: используйте [последовательности экранирования OSC 8](https://en.wikipedia.org/wiki/ANSI_escape_code#OSC) для создания кликабельного текста (Cmd+клик на macOS, Ctrl+клик на Windows/Linux). Требуется терминал, поддерживающий гиперссылки, такой как iTerm2, Kitty или WezTerm. См. [пример кликабельных ссылок](#clickable-links).

173 181

174**Размер вывода в соответствии с терминалом**182<h3 id="size-output-to-the-terminal">

183 Размер вывода в соответствии с терминалом

184</h3>

175 185

176Claude Code захватывает вывод вашего скрипта вместо прямого подключения к терминалу, поэтому `tput cols` и определение ширины на уровне языка не могут прочитать размер терминала изнутри скрипта. Вместо этого читайте переменные окружения `COLUMNS` и `LINES`. Claude Code устанавливает эти значения в соответствии с текущими размерами терминала перед запуском вашего скрипта.186Claude Code захватывает вывод вашего скрипта вместо прямого подключения к терминалу, поэтому `tput cols` и определение ширины на уровне языка не могут прочитать размер терминала изнутри скрипта. Вместо этого читайте переменные окружения `COLUMNS` и `LINES`. Claude Code устанавливает эти значения в соответствии с текущими размерами терминала перед запуском вашего скрипта.

177 187

178<Note>Строка состояния работает локально и не потребляет токены API. Она временно скрывается во время определённых взаимодействий с пользовательским интерфейсом, включая меню справки и запросы разрешений.</Note>

~~179~~

180<h2 id="available-data">188<h2 id="available-data">

181 Доступные данные189 Доступные данные

182</h2>190</h2>

1168}1176}

1169```1177```

1170 1178

1171Команда запускается один раз за цикл обновления со всеми видимыми строками подагентов, переданными как один объект JSON на stdin. Входные данные включают [базовые поля hooks](/docs/ru/hooks#common-input-fields), поле `columns` с используемой шириной строки и массив `tasks`. Каждая задача имеет `id`, `name`, `type`, `status`, `description`, `label`, `startTime`, `model`, `effort`, `contextWindowSize`, `tokenCount`, `tokenSamples` и `cwd`.1179Команда запускается один раз за цикл обновления и получает все видимые строки субагентов как один объект JSON на stdin. Входные данные включают [базовые поля хуков](/docs/ru/hooks#common-input-fields), поле `columns` с используемой шириной строки и массив `tasks` с одной записью на строку, описанный в разделе [Поля задачи](#task-fields).

~~1172~~

1173Поле `model` для каждой задачи — это разрешённый ID модели, на которой выполняется задача. `contextWindowSize` — это контекстное окно этой модели в токенах, вычисляемое так же, как `context_window.context_window_size` в строке состояния основного интерфейса, поэтому вы можете отобразить процент для каждой строки из `tokenCount`. Оба поля требуют Claude Code v2.1.205 или более поздней версии и опускаются для задачи, модель которой ещё не разрешена.

~~1174~~

1175Поле `effort` для каждой задачи — это уровень усилий рассуждения, установленный для этого субагента, в его [frontmatter определения](/docs/ru/sub-agents#supported-frontmatter-fields) или при отдельном вызове. Значение — это либо одна из строк уровня усилий `low`, `medium`, `high`, `xhigh` или `max`, либо числовой бюджет токенов. Поле сообщает настроенное значение в том виде, в котором оно написано: если модель не поддерживает этот уровень, усилия, которые Claude Code фактически применяет, могут отличаться. Поле требует Claude Code v2.1.214 или более поздней версии и отсутствует, когда для субагента не задан уровень.

1176 1180

1177Напишите одну строку JSON в stdout для каждой строки, которую вы хотите переопределить, в форме `{"id": "<task id>", "content": "<row body>"}`. Строка `content` отображается как есть, включая цвета ANSI и гиперссылки OSC 8. Пропустите `id` задачи, чтобы сохранить отображение по умолчанию для этой строки; выведите пустую строку `content`, чтобы скрыть её.1181Напишите одну строку JSON в stdout для каждой строки, которую вы хотите переопределить, в форме `{"id": "<task id>", "content": "<row body>"}`. Строка `content` отображается как есть, включая цвета ANSI и гиперссылки OSC 8. Пропустите `id` задачи, чтобы сохранить отображение по умолчанию для этой строки; выведите пустую строку `content`, чтобы скрыть её.

1178 1182

1179Те же ворота доверия, `disableAllHooks` и [`allowManagedHooksOnly`](/docs/ru/settings-reference#allowmanagedhooksonly), которые применяются к `statusLine`, применяются здесь. Плагины могут поставлять `subagentStatusLine` по умолчанию в своём [`settings.json`](/docs/ru/plugins/manifest-reference#standard-layout), но в отличие от hooks, значения плагинов не запускаются под `allowManagedHooksOnly` даже когда плагин принудительно включен в управляемых параметрах `enabledPlugins`.1183Те же ворота доверия, `disableAllHooks` и [`allowManagedHooksOnly`](/docs/ru/settings-reference#allowmanagedhooksonly), которые применяются к `statusLine`, применяются здесь. Плагины могут поставлять `subagentStatusLine` по умолчанию в своём [`settings.json`](/docs/ru/plugins/manifest-reference#standard-layout), но в отличие от hooks, значения плагинов не запускаются под `allowManagedHooksOnly` даже когда плагин принудительно включен в управляемых параметрах `enabledPlugins`.

1180 1184

1185<h3 id="task-fields">

1186 Поля задачи

1187</h3>

1188

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

1190

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

1192| :- | :- | :- |

1193| `id` | string | Идентификатор задачи. Верните его как `id` в строке, которую вы пишете в ответ для этой строки |

1194| `name` | string, необязательное | Имя, по которому [обращаются](/docs/ru/sub-agents#subagent-names) к субагенту, если оно есть |

1195| `type` | string | Вид задачи: `local_agent` |

1196| `agentType` | string | Тип субагента, под которым выполняется задача, например встроенный [`Explore`](/docs/ru/sub-agents#built-in-subagents) или пользовательский `code-reviewer`. Содержит то же значение, которое хуки получают как [`agent_type`](/docs/ru/hooks#subagentstart). Требует Claude Code v2.1.293 или более поздней версии |

1197| `status` | string | Состояние задачи, например `running`, `completed`, `failed` или `killed` |

1198| `description` | string | Краткое описание задачи, например то, которое Claude дал при запуске субагента |

1199| `label` | string | Краткая сводка о ходе выполнения задачи, если она есть у Claude Code, иначе тот же текст, что и в `description` |

1200| `startTime` | number | Время начала задачи в миллисекундах с начала эпохи Unix |

1201| `model` | string, необязательное | ID разрешённой модели, на которой выполняется задача. Опускается, пока модель не разрешена. Требует Claude Code v2.1.205 или более поздней версии |

1202| `effort` | string или number, необязательное | Уровень усилий рассуждения, установленный для субагента в его [frontmatter определения](/docs/ru/sub-agents#supported-frontmatter-fields) или при отдельном вызове: `low`, `medium`, `high`, `xhigh`, `max` или числовой бюджет токенов. Это настроенное значение, и усилия, которые применяет Claude Code, могут отличаться, если модель не поддерживает этот уровень. Опускается, когда уровень усилий не задан. Требует Claude Code v2.1.213 или более поздней версии |

1203| `contextWindowSize` | number, необязательное | Контекстное окно `model` в токенах, вычисляемое так же, как [`context_window.context_window_size`](#context-window-fields) основной строки состояния, поэтому вы можете отобразить процент для каждой строки из `tokenCount`. Опускается, когда опущено `model`. Требует Claude Code v2.1.205 или более поздней версии |

1204| `tokenCount` | number | Текущее количество токенов субагента — значение, которое показывает строка по умолчанию |

1205| `tokenSamples` | array of numbers | До 16 последних значений `tokenCount`, по одному за цикл обновления, от самого старого к новому, заканчивая текущим |

1206| `cwd` | string | Рабочий каталог субагента: его собственный каталог, если он работает в отдельном каталоге, например в изолированном worktree, иначе рабочий каталог сессии |

1207

1181<h2 id="tips">1208<h2 id="tips">

1182 Советы1209 Советы

1183</h2>1210</h2>

1192 Устранение неполадок1219 Устранение неполадок

1193</h2>1220</h2>

1194 1221

1195**Строка состояния не отображается**1222Если строка состояния пустая, начните с раздела [Строка состояния не отображается](#status-line-not-appearing). Папка, которой вы не доверяете, и скрипт, завершающийся с ошибкой, также оставляют её пустой, как описано в разделах [Требуется доверие рабочего пространства](#workspace-trust-required) и [Ошибки скрипта или зависания](#script-errors-or-hangs).

1223

1224<h3 id="status-line-not-appearing">

1225 Строка состояния не отображается

1226</h3>

1227

1228Если вы настроили строку состояния, но внизу интерфейса ничего не отображается, выполните следующие проверки:

1196 1229

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

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

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

1201* Если `disableAllHooks` установлен на `true` вне управляемых настроек после применения [приоритета настроек](/docs/ru/hooks#disable-or-remove-hooks), Claude Code запускает только `statusLine` из управляемых настроек, и без управляемого `statusLine` строка состояния отключена. Удалите эту настройку или установите её на `false` в файле, который её устанавливает, чтобы повторно включить. См. [`disableAllHooks`](/docs/ru/settings-reference#disableallhooks).1234* Если `disableAllHooks` установлен на `true` вне управляемых настроек после применения [приоритета настроек](/docs/ru/hooks#disable-or-remove-hooks), Claude Code запускает только `statusLine` из управляемых настроек, и без управляемого `statusLine` строка состояния отключена. Удалите эту настройку или установите её на `false` в файле, который её устанавливает, чтобы повторно включить. См. [`disableAllHooks`](/docs/ru/settings-reference#disableallhooks).

1202* Если ваша организация устанавливает `allowManagedHooksOnly` в управляемых настройках, ваша пользовательская строка состояния исчезает без предупреждения: вы можете получить строку состояния только из значения `statusLine` в этих управляемых настройках. См. [что запускается под `allowManagedHooksOnly`](/docs/ru/settings-reference#what-runs-under-allowmanagedhooksonly) для полного поведения и спросите у вашего администратора, применяется ли эта настройка к вам.1235* Если ваша организация устанавливает `allowManagedHooksOnly` в управляемых настройках, ваша пользовательская строка состояния исчезает без предупреждения: вы можете получить строку состояния только из значения `statusLine` в этих управляемых настройках. См. [что запускается под `allowManagedHooksOnly`](/docs/ru/settings-reference#what-runs-under-allowmanagedhooksonly) для полного поведения и спросите у вашего администратора, применяется ли эта настройка к вам.

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

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

1205 1238

~~1206**Строка состояния показывает `--` или пустые значения**~~1239<h3 id="status-line-shows-or-empty-values">

1240 Строка состояния показывает `--` или пустые значения

1241</h3>

1207 1242

1208* Поля могут быть `null` перед завершением первого ответа API1243Поля могут быть `null` до завершения первого ответа API, поэтому обрабатывайте значения null в вашем скрипте с резервными вариантами, такими как `// 0` в jq. Перезапустите Claude Code, если значения остаются пустыми после нескольких сообщений.

1209* Обрабатывайте нулевые значения в вашем скрипте с резервными значениями, такими как `// 0` в jq

1210* Перезагрузите Claude Code, если значения остаются пустыми после нескольких сообщений

1211 1244

1212**Процент контекста показывает неожиданные значения**1245<h3 id="context-percentage-shows-unexpected-values">

1246 Процент контекста показывает неожиданные значения

1247</h3>

1213 1248

1214* Используйте `used_percentage` для простейшего точного состояния контекста1249Строка состояния сообщает количества из последнего ответа API, в то время как `/context` добавляет оценку для сообщений, добавленных с момента этого ответа, поэтому `/context` может показывать более высокие значения до следующего ответа. Используйте `used_percentage` для простейшего точного состояния контекста. Формулу, по которой вычисляется `used_percentage`, см. в разделе [Поля контекстного окна](#context-window-fields).

1215* Строка состояния сообщает количества из последнего ответа API, в то время как `/context` добавляет оценку для сообщений, добавленных с момента этого ответа, поэтому `/context` может показывать более высокие значения до следующего ответа

1216 1250

1217**Ссылки OSC 8 не кликабельны**1251<h3 id="osc-8-links-not-clickable">

1252 Ссылки OSC 8 не кликабельны

1253</h3>

1254

1255Будет ли ссылка кликабельной, зависит от вашего терминала, от того, обнаруживает ли Claude Code в нём поддержку гиперссылок, от того, удаляют ли SSH или tmux управляющую последовательность, и от того, как ваш скрипт её выводит:

1218 1256

1219* Убедитесь, что ваш терминал поддерживает гиперссылки OSC 8 (iTerm2, Kitty, WezTerm)1257* Убедитесь, что ваш терминал поддерживает гиперссылки OSC 8 (iTerm2, Kitty, WezTerm)

1220 1258

1226 FORCE_HYPERLINK=1 claude1264 FORCE_HYPERLINK=1 claude

1227 ```1265 ```

1228 1266

1229 В PowerShell сначала установите переменную в текущем сеансе:1267 В PowerShell сначала установите переменную в текущей сессии:

1230 1268

1231 ```powershell theme={null}1269 ```powershell theme={null}

1232 $env:FORCE_HYPERLINK = "1"; claude1270 $env:FORCE_HYPERLINK = "1"; claude

1233 ```1271 ```

1234 1272

1235* Сеансы SSH и tmux могут удалять последовательности OSC в зависимости от конфигурации1273* Сессии SSH и tmux могут удалять последовательности OSC в зависимости от конфигурации

1236 1274

1237* Если последовательности экранирования отображаются как буквальный текст, например `\e]8;;`, используйте `printf '%b'` вместо `echo -e` для более надёжной обработки экранирования1275* Если последовательности экранирования отображаются как буквальный текст, например `\e]8;;`, используйте `printf '%b'` вместо `echo -e` для более надёжной обработки экранирования

1238 1276

1239**Глюки отображения с последовательностями экранирования**1277<h3 id="display-glitches-with-escape-sequences">

1278 Глюки отображения с последовательностями экранирования

1279</h3>

1240 1280

1241* Сложные последовательности экранирования (цвета ANSI, ссылки OSC 8) могут иногда вызывать искажённый вывод, если они перекрываются с другими обновлениями пользовательского интерфейса1281Сложные последовательности экранирования (цвета ANSI, ссылки OSC 8) могут иногда вызывать искажённый вывод, если они перекрываются с другими обновлениями пользовательского интерфейса. Многострочные строки состояния с кодами экранирования более подвержены проблемам отображения, чем однострочный простой текст.

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

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

1244 1282

1245**Требуется доверие рабочей области**1283Если вы видите повреждённый текст, попробуйте упростить ваш скрипт до простого текстового вывода.

1246 1284

1247* Поскольку `statusLine` выполняет команду оболочки, Claude Code запускает её под тем же [правилом доверия рабочей области, что и hooks в файлах настроек](/docs/ru/permissions#what-runs-before-you-trust-a-folder). Принятие диалога для папки или для родительского каталога, чьё доверие распространяется на неё, достаточно.1285<h3 id="workspace-trust-required">

1248* До этого строка состояния остаётся пустой, и `claude --debug` записывает `Status line command skipped: workspace trust not accepted`. Перезагрузите Claude Code и примите диалог доверия, чтобы включить его.1286 Требуется доверие рабочего пространства

1287</h3>

1288

1289Пока вы не примете диалог доверия рабочего пространства, строка состояния остаётся пустой. Поскольку `statusLine` выполняет команду оболочки, Claude Code запускает её под тем же [правилом доверия рабочего пространства, что и хуки в файлах настроек](/docs/ru/permissions#what-runs-before-you-trust-a-folder). Достаточно принять диалог для папки или для родительского каталога, чьё доверие распространяется на неё.

1290

1291До этого `claude --debug` записывает в лог `Status line command skipped: workspace trust not accepted`. Перезапустите Claude Code и примите диалог доверия, чтобы включить её.

1249 1292

1250**Ошибки скрипта или зависания**1293<h3 id="script-errors-or-hangs">

1294 Ошибки скрипта или зависания

1295</h3>

1296

1297Claude Code отображает вывод вашего скрипта только после того, как скрипт завершится с кодом 0:

1251 1298

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

1253* Медленные скрипты блокируют обновление строки состояния до их завершения. Держите скрипты быстрыми, чтобы избежать устаревшего вывода.1300* Медленные скрипты блокируют обновление строки состояния до их завершения. Держите скрипты быстрыми, чтобы избежать устаревшего вывода.

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

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

1256 1303

1257**Уведомления делят строку состояния**1304<h3 id="notifications-share-the-status-line-row">

1305 Уведомления делят строку со строкой состояния

1306</h3>

1258 1307

1259Вне [полноэкранного отображения](/docs/ru/fullscreen) Claude Code показывает уведомления на той же строке, что и ваша строка состояния. При полноэкранном отображении Claude Code выделяет уведомлениям отдельную строку.1308Вне [полноэкранного отображения](/docs/ru/fullscreen) Claude Code показывает уведомления на той же строке, что и ваша строка состояния. При полноэкранном отображении Claude Code выделяет уведомлениям отдельную строку.

1260 1309

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

1262* Включение подробного режима добавляет счётчик токенов в эту область1311* Включение подробного режима добавляет счётчик токенов в эту область

1263* На узких терминалах эти уведомления могут обрезать вывод вашей строки состояния1312* На узких терминалах эти уведомления могут обрезать вывод вашей строки состояния

sub-agents.md +2 −0

Details

3793. Переменная окружения [`CLAUDE_CODE_SUBAGENT_MODEL`](/docs/ru/model-config#environment-variables), когда вы устанавливаете её на псевдоним модели или ID модели3793. Переменная окружения [`CLAUDE_CODE_SUBAGENT_MODEL`](/docs/ru/model-config#environment-variables), когда вы устанавливаете её на псевдоним модели или ID модели

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

381 381

382Если установленный [мод](/docs/ru/plugins/mods/overview) задаёт модель в своём хуке [`agent.spawn`](/docs/ru/plugins/mods/reference#subagents), Claude Code использует эту модель вместо параметра конкретного вызова.

383

382В двух случаях семейный псевдоним, такой как `opus`, в параметре для конкретного вызова или frontmatter разрешается в модель основного разговора вместо [версии, на которую указывает псевдоним](/docs/ru/model-config#model-aliases):384В двух случаях семейный псевдоним, такой как `opus`, в параметре для конкретного вызова или frontmatter разрешается в модель основного разговора вместо [версии, на которую указывает псевдоним](/docs/ru/model-config#model-aliases):

383 385

384* **Модель основного разговора принадлежит этому семейству**: subagent работает на точной модели основного разговора, включая любой суффикс `[1m]`, поэтому он получает то же [extended context](/docs/ru/model-config#extended-context) окно, что и основной разговор.386* **Модель основного разговора принадлежит этому семейству**: subagent работает на точной модели основного разговора, включая любой суффикс `[1m]`, поэтому он получает то же [extended context](/docs/ru/model-config#extended-context) окно, что и основной разговор.

tools-reference.md +38 −28

Details

154 Что сохраняется между командами154 Что сохраняется между командами

155</h3>155</h3>

156 156

157* Когда Claude выполняет `cd` в основной сессии, новый рабочий каталог переносится на более поздние команды Bash, пока он остаётся внутри каталога проекта или [дополнительного рабочего каталога](/docs/ru/permissions#working-directories), который вы добавили с помощью `--add-dir`, `/add-dir` или `additionalDirectories` в параметрах. Это включает команды, которые Claude выполняет в ответ на ваши более поздние сообщения.157* Когда Claude выполняет `cd` в основной сессии, новый рабочий каталог переносится на более поздние команды Bash, пока он остаётся внутри каталога проекта или [дополнительного рабочего каталога](/docs/ru/permissions#working-directories), который вы добавили с помощью `--add-dir`, `/add-dir` или `additionalDirectories` в настройках. Это включает команды, которые Claude выполняет в ответ на ваши более поздние сообщения.

158 * Сессии подагентов никогда не переносят изменения рабочего каталога.158 * Сессии субагентов никогда не переносят изменения рабочего каталога.

159 * Если `cd` приводит за пределы этих каталогов, Claude Code сбрасывает на каталог проекта и добавляет `Shell cwd was reset to <dir>` к результату инструмента.159 * Если `cd` приводит за пределы этих каталогов, Claude Code сбрасывает на каталог проекта и добавляет `Shell cwd was reset to <dir>` к результату инструмента.

160 * Чтобы отключить этот перенос, чтобы каждая команда Bash начиналась в каталоге проекта, установите `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1`.160 * Чтобы отключить этот перенос, чтобы каждая команда Bash начиналась в каталоге проекта, установите `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1`.

161* Переменные окружения не сохраняются. `export` в одной команде не будет доступен в следующей.161* Переменные окружения не сохраняются. `export` в одной команде не будет доступен в следующей.

162* Псевдонимы и функции оболочки, определённые в файле запуска оболочки, доступны. При запуске сессии Claude Code загружает `~/.zshrc`, `~/.bashrc` или `~/.profile` в зависимости от вашей оболочки, захватывает полученные псевдонимы, функции и параметры оболочки и применяет их к каждой команде Bash.162* Псевдонимы и функции оболочки, определённые в файле запуска оболочки, доступны. При запуске сессии Claude Code загружает `~/.zshrc`, `~/.bashrc` или `~/.profile` в зависимости от вашей оболочки, захватывает полученные псевдонимы, функции и параметры оболочки и применяет их к каждой команде Bash.

163 163

164Активируйте вашу virtualenv или conda окружение перед запуском Claude Code. Чтобы переменные окружения сохранялись между командами Bash, установите [`CLAUDE_ENV_FILE`](/docs/ru/env-vars) на скрипт оболочки перед запуском Claude Code или используйте [hook SessionStart](/docs/ru/hooks#persist-environment-variables) для его динамического заполнения.164Активируйте ваше окружение virtualenv или conda перед запуском Claude Code. Чтобы переменные окружения сохранялись между командами Bash, установите [`CLAUDE_ENV_FILE`](/docs/ru/env-vars) на скрипт оболочки перед запуском Claude Code или используйте [хук SessionStart](/docs/ru/hooks#persist-environment-variables) для его динамического заполнения.

165 165

166<h3 id="timeout-and-output-limits">166<h3 id="timeout-and-output-limits">

167 Ограничения по времени ожидания и выводу167 Ограничения по времени ожидания и выводу

168</h3>168</h3>

169 169

170Каждая команда выполняется с ограничением по времени, и Claude управляет им: когда ему требуется больше времени, чем по умолчанию для команды, он передаёт параметр `timeout` с этим вызовом. Вы никогда не устанавливаете ограничение по времени для отдельной команды.170Каждая команда выполняется с таймаутом, и Claude управляет им: когда ему требуется больше времени, чем по умолчанию для команды, он передаёт параметр `timeout` с этим вызовом. Вы никогда не устанавливаете таймаут для отдельной команды.

171 171

172Две [переменные окружения](/docs/ru/env-vars) контролируют, что Claude получает для команды, которая выполняется на переднем плане:172Две [переменные окружения](/docs/ru/env-vars) контролируют, что Claude получает для команды, которая выполняется на переднем плане:

173 173

174* `BASH_DEFAULT_TIMEOUT_MS` — значение по умолчанию, когда Claude не передаёт ограничение по времени; две минуты из коробки174* `BASH_DEFAULT_TIMEOUT_MS` — значение по умолчанию, когда Claude не передаёт таймаут; две минуты из коробки

175* `BASH_MAX_TIMEOUT_MS` — по умолчанию устанавливает потолок, который ограничивает всё, что запрашивает Claude: эффективный потолок — это больший из двух, десять минут из коробки175* `BASH_MAX_TIMEOUT_MS` — по умолчанию устанавливает потолок, который ограничивает всё, что запрашивает Claude: эффективный потолок — это больший из двух, десять минут из коробки

176 176

177В сессии, где действует [ограничение времени для фоновых команд](#time-limit-for-background-commands), `timeout` для команды, которую Claude запускает в фоновом режиме, вместо этого устанавливает, как долго команда может работать там, с отдельным значением по умолчанию и максимумом этого ограничения. Инструмент [PowerShell](#powershell-tool) следует тем же правилам таймаута и читает те же две переменные.177В сессии, где действует [ограничение времени для фоновых команд](#time-limit-for-background-commands), `timeout` для команды, которую Claude запускает в фоновом режиме, вместо этого устанавливает, как долго команда может работать там, с отдельным значением по умолчанию и максимумом этого ограничения. Инструмент [PowerShell](#powershell-tool) следует тем же правилам таймаута и читает те же две переменные.

180 Ограничения по выводу180 Ограничения по выводу

181</h4>181</h4>

182 182

183Claude Code передаёт вывод команды в рабочий файл по мере выполнения команды; команда, выход которой превышает 5 ГБ, прерывается. Когда команда завершается, Claude Code читает вывод обратно из этого файла, вплоть до окна обратного чтения, описанного ниже. Сколько вывода достигает Claude встроенно, зависит от того, рассматривает ли Claude Code результат как ошибку:183Claude Code передаёт вывод команды в рабочий файл по мере выполнения команды; команда, вывод которой превышает 5 ГБ, прерывается. Когда команда завершается, Claude Code читает вывод обратно из этого файла, вплоть до окна обратного чтения, описанного ниже. Сколько вывода достигает Claude встроенно, зависит от того, рассматривает ли Claude Code результат как ошибку:

184 184

185| Результат | Что получает Claude |185| Результат | Что получает Claude |

186| :- | :- |186| :- | :- |

189 189

190Команда, которая выходит с кодом 1, считается действительным результатом для инструмента Bash только когда Claude Code распознаёт код выхода 1 как благоприятный результат для этой команды: `grep`, `rg`, `egrep`, `fgrep`, `find`, `diff`, `test` и `[`, плюс `git diff` и `git grep`. Каждая другая команда, которая выходит с кодом 1, считается ошибкой, даже когда код выхода 1 — это благоприятный информационный результат: нет совпадений для `pgrep` и `jq -e`, файлы, которые отличаются для `cmp`.190Команда, которая выходит с кодом 1, считается действительным результатом для инструмента Bash только когда Claude Code распознаёт код выхода 1 как благоприятный результат для этой команды: `grep`, `rg`, `egrep`, `fgrep`, `find`, `diff`, `test` и `[`, плюс `git diff` и `git grep`. Каждая другая команда, которая выходит с кодом 1, считается ошибкой, даже когда код выхода 1 — это благоприятный информационный результат: нет совпадений для `pgrep` и `jq -e`, файлы, которые отличаются для `cmp`.

191 191

192[`BASH_MAX_OUTPUT_LENGTH`](/docs/ru/env-vars) устанавливает, сколько символов вывода Claude Code читает обратно из рабочего файла в результат команды: 30 000 по умолчанию, вплоть до жёсткого потолка в 150 000. Увеличьте его, когда ваши команды регулярно переполняют это окно, например подробная сборка или полный журнал набора тестов. Увеличение его расширяет окно обратного чтения, которое также является окном, из которого вырезается выдержка команды с ошибкой. Это не повышает встроенные потолки: действительный результат выше встроенного потолка поступает как путь файла плюс предпросмотр независимо от этой переменной.192[`BASH_MAX_OUTPUT_LENGTH`](/docs/ru/env-vars) устанавливает, сколько символов вывода Claude Code читает обратно из рабочего файла в результат команды: 30 000 по умолчанию, вплоть до жёсткого потолка в 150 000. Увеличьте его, когда ваши команды регулярно переполняют это окно, например подробная сборка или полный лог набора тестов. Увеличение его расширяет окно обратного чтения, которое также является окном, из которого вырезается выдержка команды с ошибкой. Это не повышает встроенные потолки: действительный результат выше встроенного потолка поступает как путь файла плюс предпросмотр независимо от этой переменной.

193 193

194Чтобы изменить, сколько действительного результата Claude получает встроенно, установите параметр [`bashOutputMaxChars`](/docs/ru/settings-reference#bashoutputmaxchars) вместо этого, вплоть до 128 000 символов. Он размеры встроенный потолок и окно обратного чтения вместе, и Claude Code затем игнорирует `BASH_MAX_OUTPUT_LENGTH`. Требует Claude Code v2.1.261 или позже.194Чтобы изменить, сколько действительного результата Claude получает встроенно, установите вместо этого параметр [`bashOutputMaxChars`](/docs/ru/settings-reference#bashoutputmaxchars), вплоть до 128 000 символов. Он задаёт размер встроенного потолка и окна обратного чтения вместе, и Claude Code затем игнорирует `BASH_MAX_OUTPUT_LENGTH`. Требует Claude Code v2.1.261 или новее.

195 195

196<h3 id="background-commands">196<h3 id="background-commands">

197 Фоновые команды197 Фоновые команды

198</h3>198</h3>

199 199

200Для долгоживущих процессов, таких как серверы разработки или сборки наблюдения, Claude может установить `run_in_background: true` для запуска команды как фоновой задачи и продолжения работы во время её выполнения. Перечислите и остановите фоновые задачи с помощью `/tasks`. После того как вы остановите одну там или из подключённого клиента, такого как настольное приложение, Claude переходит дальше вместо ожидания. Если подагент запустил команду, это подагент, который переходит дальше.200Для долгоживущих процессов, таких как серверы разработки или сборки в режиме наблюдения, Claude может установить `run_in_background: true` для запуска команды как фоновой задачи и продолжения работы во время её выполнения. Просматривайте и останавливайте фоновые задачи с помощью `/tasks`. После того как вы остановите одну там или из подключённого клиента, такого как настольное приложение, Claude переходит дальше вместо ожидания. Если команду запустил субагент, дальше переходит именно этот субагент.

201 201

202<h4 id="when-a-background-command-stops">202<h4 id="when-a-background-command-stops">

203 Когда фоновая команда останавливается203 Когда фоновая команда останавливается

204</h4>204</h4>

205 205

206Команда, которую запустил [подагент переднего плана](/docs/ru/sub-agents#run-subagents-in-foreground-or-background), останавливается, когда заканчивается запуск этого подагента, независимо от того, завершился ли он, не удался или был прерван. Команда, которую запустили основной разговор или фоновый подагент, продолжает работать после финального ответа, пока она не выйдет, не будет остановлена или не достигнет своего [ограничения по времени](#time-limit-for-background-commands). В неинтерактивном режиме с флагом `-p` [фоновые команды заканчиваются вскоре после финального результата запуска](/docs/ru/headless#background-tasks-at-exit).206Команда, которую запустил [субагент переднего плана](/docs/ru/sub-agents#run-subagents-in-foreground-or-background), останавливается, когда заканчивается запуск этого субагента, независимо от того, завершился ли он, не удался или был прерван. Команда, которую запустили основной диалог или фоновый субагент, продолжает работать после финального ответа, пока она не выйдет, не будет остановлена или не достигнет своего [ограничения по времени](#time-limit-for-background-commands).

207

208Пока команда, которую запустил основной диалог, ещё выполняется, запуск в неинтерактивном режиме с флагом `-p` [остаётся открытым после своего результата](/docs/ru/headless#background-tasks-at-exit), пока эта команда не выйдет или не достигнет своего ограничения по времени. Команда, которую запустил фоновый субагент, останавливается при выходе запуска.

207 209

208<h4 id="time-limit-for-background-commands">210<h4 id="time-limit-for-background-commands">

209 Ограничение времени для фоновых команд211 Ограничение времени для фоновых команд

218* Команда, которую Claude запускает в фоновом режиме, получает 30 минут или `timeout`, который Claude передаёт с `run_in_background`, вплоть до максимума в 2 часа220* Команда, которую Claude запускает в фоновом режиме, получает 30 минут или `timeout`, который Claude передаёт с `run_in_background`, вплоть до максимума в 2 часа

219* Команда, которая начинается на переднем плане и затем переходит в фоновый режим, например по истечении её таймаута, получает 30 минут с момента перехода221* Команда, которая начинается на переднем плане и затем переходит в фоновый режим, например по истечении её таймаута, получает 30 минут с момента перехода

220 222

223При запуске с флагом `-p`, промпт которого вы передаёте как текст, а не с помощью `--input-format stream-json`, оба значения по умолчанию составляют 10 минут вместо 30, потому что запуск [ожидает фоновые команды после своего результата](/docs/ru/headless#background-tasks-at-exit).

224

221Когда фоновая команда достигает своего ограничения по времени, Claude Code останавливает её и сообщает Claude, почему, и Claude может запустить команду снова с более длительным `timeout`, если работа всё ещё нужна. Уведомление об остановке гласит `Background command "<description>" was stopped after reaching its background time limit`.225Когда фоновая команда достигает своего ограничения по времени, Claude Code останавливает её и сообщает Claude, почему, и Claude может запустить команду снова с более длительным `timeout`, если работа всё ещё нужна. Уведомление об остановке гласит `Background command "<description>" was stopped after reaching its background time limit`.

222 226

223<h4 id="raise-the-time-limit-for-background-commands">227<h4 id="raise-the-time-limit-for-background-commands">

224 Повысьте ограничение времени для фоновых команд228 Повысьте ограничение времени для фоновых команд

225</h4>229</h4>

226 230

227Две [переменные окружения](/docs/ru/env-vars) повышают эти ограничения для команд Bash и PowerShell одинаково. Обе принимают миллисекунды, и ни одна не может сократить ограничение: более низкое значение оставляет 30-минутное значение по умолчанию и 2-часовой максимум на месте.231Две [переменные окружения](/docs/ru/env-vars) повышают эти ограничения для команд Bash и PowerShell одинаково. Обе принимают миллисекунды, и ни одна не может сократить ограничение: более низкое значение оставляет значения по умолчанию и 2-часовой максимум на месте.

228 232

229* Установите `BASH_DEFAULT_TIMEOUT_MS` выше `1800000`, чтобы заменить 30-минутное значение по умолчанию этим значением, как для команд, которые Claude запускает без `timeout`, так и для перемещённых команд233* Установите `BASH_DEFAULT_TIMEOUT_MS` выше `1800000`, чтобы заменить 30-минутное значение по умолчанию этим значением, как для команд, которые Claude запускает без `timeout`, так и для перемещённых команд. При запуске с `-p`, промпт которого вы передаёте как текст, любое значение выше `600000` заменяет его 10-минутное значение по умолчанию

230* Установите `BASH_MAX_TIMEOUT_MS` выше `7200000`, чтобы повысить 2-часовой максимум до этого значения. Установка `BASH_DEFAULT_TIMEOUT_MS` выше `7200000` повышает максимум таким же образом234* Установите `BASH_MAX_TIMEOUT_MS` выше `7200000`, чтобы повысить 2-часовой максимум до этого значения. Установка `BASH_DEFAULT_TIMEOUT_MS` выше `7200000` повышает максимум таким же образом

231 235

232<h4 id="foreground-commands-that-move-to-the-background">236<h4 id="foreground-commands-that-move-to-the-background">

233 Команды переднего плана, которые переходят в фоновый режим237 Команды переднего плана, которые переходят в фоновый режим

234</h4>238</h4>

235 239

236Когда команда переднего плана достигает своего ограничения по времени без завершения, Claude Code переводит её в фоновый режим вместо остановки, если только команда не начинается с `sleep`. Перемещённая команда имеет [ограничение по времени](#time-limit-for-background-commands), отсчитываемое с момента перемещения, и перемещённая команда подагента переднего плана всё ещё останавливается, когда заканчивается запуск этого подагента.240Когда команда переднего плана достигает своего таймаута без завершения, Claude Code переводит её в фоновый режим вместо остановки, если только команда не начинается с `sleep`. Перемещённая команда имеет [ограничение по времени](#time-limit-for-background-commands), отсчитываемое с момента перемещения, и перемещённая команда субагента переднего плана всё ещё останавливается, когда заканчивается запуск этого субагента.

237 241

238Установка [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1`](/docs/ru/env-vars#variables) или запуск в [режиме bare](/docs/ru/headless#start-faster-with-bare-mode) отключает автоматическое фоновое выполнение вместе с остальной функциональностью фоновых задач, поэтому команда, достигшая своего таймаута, вместо этого останавливается.242Установка [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1`](/docs/ru/env-vars#variables) или запуск в [режиме bare](/docs/ru/headless#start-faster-with-bare-mode) отключает автоматическое фоновое выполнение вместе с остальной функциональностью фоновых задач, поэтому команда, достигшая своего таймаута, вместо этого останавливается.

239 243

240Результат команды, перемещённой в фоновый режим, указывает, что произошло:244Результат команды, перемещённой в фоновый режим, указывает, что произошло:

241 245

242* Когда ограничение по времени запускает перемещение, результат сообщает об этом явно: `Command did not complete within its 120s timeout and was moved to the background`, с секундами, соответствующими применённому ограничению по времени, за которым следует ID задачи и путь файла, в который записывается вывод.246* Когда таймаут запускает перемещение, результат сообщает об этом явно: `Command did not complete within its 120s timeout and was moved to the background`, с секундами, соответствующими применённому таймауту, за которым следует ID задачи и путь файла, в который записывается вывод.

243* `cd`, `pushd`, `popd` или `chdir` внутри команды, которая перемещается в фоновый режим, никогда не переносится: результат гласит `Session cwd remains <dir>; directory changes made by the backgrounded command do not apply to subsequent commands.`, поэтому Claude не действует на изменение каталога, которое не произошло.247* `cd`, `pushd`, `popd` или `chdir` внутри команды, которая перемещается в фоновый режим, никогда не переносится: результат гласит `Session cwd remains <dir>; directory changes made by the backgrounded command do not apply to subsequent commands.`, поэтому Claude не действует на изменение каталога, которое не произошло.

244 248

245<h3 id="memory-limit-on-linux-and-wsl">249<h3 id="memory-limit-on-linux-and-wsl">

246 Ограничение памяти на Linux и WSL250 Ограничение памяти на Linux и WSL

247</h3>251</h3>

248 252

249На Linux и WSL установите [`CLAUDE_CODE_TOOL_MEMORY_LIMIT`](/docs/ru/env-vars#variables) на размер, такой как `4G`, чтобы ограничить память, которую могут использовать команды Bash, PowerShell и инструмента [Monitor](#monitor-tool), чтобы одна неконтролируемая сборка не могла занять память, которая нужна остальной сессии. Требует Claude Code v2.1.233 или позже. До v2.1.246 команды инструмента Monitor выполнялись вне ограничения.253На Linux и WSL установите [`CLAUDE_CODE_TOOL_MEMORY_LIMIT`](/docs/ru/env-vars#variables) на размер, такой как `4G`, чтобы ограничить память, которую могут использовать команды Bash, PowerShell и инструмента [Monitor](#monitor-tool), чтобы одна неконтролируемая сборка не могла занять память, которая нужна остальной сессии. Требует Claude Code v2.1.233 или новее. До v2.1.246 команды инструмента Monitor выполнялись вне ограничения.

250 254

251* Напишите размер как количество байтов или с суффиксом `K`, `M`, `G` или `T`. Установите `0`, `off`, `false`, `no` или `none`, чтобы отключить ограничение. Claude Code игнорирует любое другое значение, которое он не может прочитать как размер, например `4e9`.255* Укажите размер как количество байтов или с суффиксом `K`, `M`, `G` или `T`. Установите `0`, `off`, `false`, `no` или `none`, чтобы отключить ограничение. Claude Code игнорирует любое другое значение, которое он не может прочитать как размер, например `4e9`.

252* Claude Code считает все команды Bash, PowerShell и Monitor сессии по одному ограничению, а не каждую команду отдельно.256* Claude Code считает все команды Bash, PowerShell и Monitor сессии по одному ограничению, а не каждую команду отдельно.

253* Claude Code применяет ограничение с помощью cgroup памяти. Когда он не может установить cgroup, команды выполняются без ограничения, и журнал отладки из `claude --debug` говорит, почему.257* Claude Code применяет ограничение с помощью cgroup памяти. Когда он не может настроить cgroup, команды выполняются без ограничения, и лог отладки из `claude --debug` сообщает, почему.

254* После того как первый процесс, который Claude Code запускает, включил ограничение или отключил его из-за значения off или неудачной установки cgroup, Claude Code удерживает этот результат, пока вы не перезапустите. Чтобы применить изменённое или удалённое значение или исправленную установку, запустите `claude` снова.258* После того как первый процесс, который Claude Code запускает, включил ограничение или отключил его из-за значения off или неудачной настройки cgroup, Claude Code удерживает этот результат, пока вы не перезапустите. Чтобы применить изменённое или удалённое значение или исправленную настройку, запустите `claude` снова.

255* Когда команды не могут оставаться под ограничением, ядро убивает команду, и ничто в её результате не называет ограничение.259* Когда команды не могут оставаться под ограничением, ядро завершает команду, и ничто в её результате не называет ограничение.

256 260

257Claude Code также может считать другие виды процессов, которые он запускает, по тому же ограничению. Установите [`CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE`](/docs/ru/env-vars#variables) на список видов, разделённый запятыми, которые нужно исключить из ограничения; Claude Code применяет ограничение к каждому виду, который не в вашем списке. Установите его на `none`, чтобы ограничить каждый вид, или на `all-new`, чтобы ограничить только команды Bash, PowerShell и Monitor инструмента. Требует Claude Code v2.1.246 или позже. Виды, которые вы можете назвать:261Claude Code также может считать другие виды процессов, которые он запускает, по тому же ограничению. Установите [`CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE`](/docs/ru/env-vars#variables) на список видов, разделённый запятыми, которые нужно исключить из ограничения; Claude Code применяет ограничение к каждому виду, который не в вашем списке. Установите его на `none`, чтобы ограничить каждый вид, или на `all-new`, чтобы ограничить только команды инструментов Bash, PowerShell и Monitor. Требует Claude Code v2.1.246 или новее. Виды, которые вы можете назвать:

258 262

259* `mcp`: локальные [серверы MCP](/docs/ru/mcp)263* `mcp`: локальные [MCP-серверы](/docs/ru/mcp)

260* `lsp`: [языковые серверы](#lsp-tool-behavior)264* `lsp`: [языковые серверы](#lsp-tool-behavior)

261* `hooks`: команды [hook](/docs/ru/hooks)265* `hooks`: команды [хуков](/docs/ru/hooks)

262* `plugin`: команды, которые запускают [плагины](/docs/ru/plugins/overview)266* `plugin`: команды, которые запускают [плагины](/docs/ru/plugins/overview)

263* `helper`: собственные вспомогательные команды Claude Code, такие как `git`267* `helper`: собственные вспомогательные команды Claude Code, такие как `git`

264* `agent`: дочерние процессы Claude Code, такие как [товарищи агентов](/docs/ru/agent-teams)268* `agent`: дочерние процессы Claude Code, такие как [участники команды агентов](/docs/ru/agent-teams)

265 269

266Что бы вы ни указали, применяются эти правила:270Что бы вы ни указали, применяются эти правила:

267 271

268* **Неизвестные имена**: Claude Code игнорирует имена, которые он не распознаёт272* **Неизвестные имена**: Claude Code игнорирует имена, которые он не распознаёт

269* **Переменная не установлена**: Claude Code берёт набор других ограниченных видов из конфигурации, которую Anthropic доставляет с сервера, и этот набор может меняться со временем, поэтому установите переменную, когда вам нужен набор, который не меняется273* **Переменная не установлена**: Claude Code берёт набор других ограниченных видов из конфигурации, которую Anthropic доставляет с сервера, и этот набор может меняться со временем, поэтому установите переменную, когда вам нужен набор, который не меняется

270* **Hooks с ограничением разрешений**: даже со всеми видами ограниченными, Claude Code исключает из ограничения hook, который может заблокировать или изменить результат действия, и любой сервер MCP, который такой hook вызывает, поэтому ядро, убивающее hook с ограничением разрешений, не может разрешить действие, которое он блокировал274* **Хуки, контролирующие разрешения**: даже когда ограничены все виды, Claude Code исключает из ограничения хук, который может заблокировать или изменить результат действия, и любой MCP-сервер, который такой хук вызывает, поэтому завершение ядром хука, контролирующего разрешения, не может разрешить действие, которое он блокировал

271 275

272<h2 id="edit-tool-behavior">276<h2 id="edit-tool-behavior">

273 Поведение инструмента Edit277 Поведение инструмента Edit

285 289

286Просмотр файла с помощью Bash также удовлетворяет требованию read-before-edit, когда команда — это `cat`, `nl`, `bat`, `batcat`, `head`, `tail`, `sed -n 'X,Yp'`, `grep`, `egrep`, `fgrep` или `rg` на одном файле без конвейеров или перенаправлений. Выходные данные конвейера и другие команды Bash не учитываются при проверке read-before-edit.290Просмотр файла с помощью Bash также удовлетворяет требованию read-before-edit, когда команда — это `cat`, `nl`, `bat`, `batcat`, `head`, `tail`, `sed -n 'X,Yp'`, `grep`, `egrep`, `fgrep` или `rg` на одном файле без конвейеров или перенаправлений. Выходные данные конвейера и другие команды Bash не учитываются при проверке read-before-edit.

287 291

288Просмотр файла с помощью Bash влияет только на право редактирования, а не на разрешения. См. [Правила разрешений Read и Edit](/docs/ru/permissions#read-and-edit) для информации о том, какие команды Bash охватывают ваши правила отказа `Read` и `Edit`.292Когда Claude просматривает файл таким образом, Claude Code также загружает все [`CLAUDE.md` подкаталогов](/docs/ru/memory#how-claude-md-files-load) и [правила с областью действия по пути](/docs/ru/memory#path-specific-rules), которые применяются к этому файлу. См. [Правила разрешений Read и Edit](/docs/ru/permissions#read-and-edit) для информации о том, какие команды Bash охватывают ваши правила отказа `Read` и `Edit`.

289 293

290<h2 id="endconversation-tool-behavior">294<h2 id="endconversation-tool-behavior">

291 Поведение инструмента EndConversation295 Поведение инструмента EndConversation

709Серверная часть поиска не настраивается. Для поиска с использованием другого поставщика добавьте [MCP сервер](/docs/ru/mcp), который предоставляет инструмент поиска.713Серверная часть поиска не настраивается. Для поиска с использованием другого поставщика добавьте [MCP сервер](/docs/ru/mcp), который предоставляет инструмент поиска.

710 714

711<Note>715<Note>

712 WebSearch доступен в Claude API и [Claude Platform на AWS](/docs/ru/claude-platform-on-aws). На Microsoft Foundry требуется [развёртывание, размещённое на Anthropic](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options): развёртывания, размещённые на Azure, не поддерживают серверные инструменты, поэтому вызов WebSearch не удаётся. На Google Cloud's Agent Platform он работает с Claude 4 и более поздними моделями, включая Opus, Sonnet и Haiku. Amazon Bedrock не предоставляет серверный инструмент веб-поиска.716 WebSearch доступен в Claude API, [Claude Platform на AWS](/docs/ru/claude-platform-on-aws) и Microsoft Foundry. На Google Cloud's Agent Platform он работает с Claude 4 и более поздними моделями, включая Opus, Sonnet и Haiku. Amazon Bedrock не предоставляет серверный инструмент веб-поиска.

713</Note>717</Note>

714 718

715<h3 id="session-search-limit">719<h3 id="session-search-limit">

716 Лимит поиска сеанса720 Лимит поиска сеанса

717</h3>721</h3>

718 722

719Сеанс может выполнить максимум 200 вызовов WebSearch, подсчитанных во всей основной беседе и каждом [подагенте](/docs/ru/sub-agents), который он порождает, поэтому поиски, выполняемые параллельными веерообразными развёртываниями исследований, учитываются в одном и том же лимите. Лимит требует Claude Code версии 2.1.212 или позже. Когда Claude достигает лимита, дальнейшие вызовы возвращают уведомление, указывающее Claude продолжить с информацией, которую он уже собрал, вместо ошибки, которая могла бы пригласить повторную попытку. Вы не видите уведомление: ограниченный вызов отображается в беседе как поиск, который ничего не сделал, и если Claude нужны дополнительные поиски, уведомление указывает ему попросить вас повысить лимит.723Интерактивная сессия в терминале имеет лимит в 200 вызовов WebSearch. Поиски из основного диалога и из [субагентов](/docs/ru/sub-agents), например при параллельном веерообразном исследовании, учитываются в одном и том же лимите. Лимит требует Claude Code версии 2.1.212 или более поздней.

724

725Пока сессия находится на пределе лимита, поиски отображаются в диалоге как вызовы, которые ничего не сделали. Claude получает уведомление, указывающее ему продолжить с информацией, которую он уже собрал, а если ему нужны дополнительные поиски — попросить вас повысить лимит.

726

727Чтобы получить больше поисков, повысьте лимит, дождитесь его восполнения или начните новый диалог:

720 728

721Установите переменную окружения [`CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION`](/docs/ru/env-vars) для изменения лимита; она принимает положительное целое число, поэтому лимит можно повысить, но не отключить. Запуск [`/clear`](/docs/ru/commands#all-commands) сбрасывает счётчик. Если работа, которая всё ещё может порождать [подагентов](/docs/ru/sub-agents), сохраняется после очистки, например запущенный рабочий процесс, счётчик переносится вместо этого.729* **Повысьте лимит**: задайте переменной окружения [`CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION`](/docs/ru/env-vars#variables) положительное целое число, например `500`. Лимит можно повысить, но не отключить.

730* **Дождитесь восполнения**: в Claude Code версии 2.1.290 или более поздней лимит интерактивной сессии в терминале восполняется со скоростью около 100 вызовов в час. Чтобы изменить скорость, задайте [`CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR`](/docs/ru/env-vars#variables) равной количеству вызовов в час, например `50`.

731* **Начните новый диалог**: запуск [`/clear`](/docs/ru/commands#all-commands) в промпте Claude Code также сбрасывает счётчик. Если работа, которая всё ещё может порождать субагентов, сохраняется после очистки, например запущенный рабочий процесс, счётчик вместо этого переносится.

722 732

723<h2 id="write-tool-behavior">733<h2 id="write-tool-behavior">

724 Поведение инструмента Write734 Поведение инструмента Write

vs-code.md +1 −0

Details

623* **Ответы Claude**: расширение объявляет каждый ответ один раз, когда он завершен, и молчит во время потоковой передачи текста. Ваша программа чтения с экрана читает блоки кода как сводку по количеству строк, читает ссылки по их метке и читает таблицы ячейка за ячейкой; полный ответ остается читаемым в стенограмме.623* **Ответы Claude**: расширение объявляет каждый ответ один раз, когда он завершен, и молчит во время потоковой передачи текста. Ваша программа чтения с экрана читает блоки кода как сводку по количеству строк, читает ссылки по их метке и читает таблицы ячейка за ячейкой; полный ответ остается читаемым в стенограмме.

624* **Запросы разрешений и вопросы**: расширение объявляет запрос, когда появляется его диалоговое окно разрешения, называя инструмент, который Claude хочет использовать. Оно объявляет таким же образом, когда Claude задает вам вопрос и когда Claude завершает план и ждет вашего рассмотрения.624* **Запросы разрешений и вопросы**: расширение объявляет запрос, когда появляется его диалоговое окно разрешения, называя инструмент, который Claude хочет использовать. Оно объявляет таким же образом, когда Claude задает вам вопрос и когда Claude завершает план и ждет вашего рассмотрения.

625* **Изменения статуса**: расширение объявляет, когда Claude начинает работать, когда Claude готов к вашему вводу и когда Claude Code начинает сжимать разговор.625* **Изменения статуса**: расширение объявляет, когда Claude начинает работать, когда Claude готов к вашему вводу и когда Claude Code начинает сжимать разговор.

626* **Сообщения в очереди**: когда вы отправляете сообщение, пока Claude работает, расширение объявляет "Message queued." для этого сообщения.

626* **Ошибки и подсказки модели**: расширение объявляет об ошибках в разговоре и объявляет, когда появляется [диалоговое окно согласия на использование кредитов](/docs/ru/model-config#fable-and-usage-credits) или [диалоговое окно помеченного запроса](/docs/ru/model-config#ask-before-switching).627* **Ошибки и подсказки модели**: расширение объявляет об ошибках в разговоре и объявляет, когда появляется [диалоговое окно согласия на использование кредитов](/docs/ru/model-config#fable-and-usage-credits) или [диалоговое окно помеченного запроса](/docs/ru/model-config#ask-before-switching).

627 628

628Пока Claude работает, ваша программа чтения с экрана читает текстовую метку вместо анимации спиннера прогресса.629Пока Claude работает, ваша программа чтения с экрана читает текстовую метку вместо анимации спиннера прогресса.

web-quickstart.md +1 −1

Details

12 12

13Облачный сеанс запускает Claude Code на облачной инфраструктуре вместо вашей машины, управляемой Anthropic по умолчанию. Этот краткий старт запускает один с [claude.ai/code](https://claude.ai/code) в вашем браузере. Вы также можете запустить один из мобильного приложения Claude, приложения Desktop или вашего терминала с помощью `claude --cloud`.13Облачный сеанс запускает Claude Code на облачной инфраструктуре вместо вашей машины, управляемой Anthropic по умолчанию. Этот краткий старт запускает один с [claude.ai/code](https://claude.ai/code) в вашем браузере. Вы также можете запустить один из мобильного приложения Claude, приложения Desktop или вашего терминала с помощью `claude --cloud`.

14 14

15Вам потребуется репозиторий GitHub для [начала работы](#connect-github). Claude клонирует его в изолированную виртуальную машину, вносит изменения и отправляет ветку для вашего просмотра. Сеансы сохраняются на всех устройствах, поэтому задача, которую вы начали на ноутбуке, готова к просмотру с телефона позже.15Вам потребуется репозиторий GitHub для [начала работы](#connect-github). Claude клонирует его в изолированную виртуальную машину, вносит изменения и отправляет ветку для вашего просмотра. Сессии сохраняются на всех устройствах, поэтому задача, которую вы начали на ноутбуке, готова к просмотру с телефона позже. Каждая сессия учитывается в лимитах использования вашего плана наряду с остальным использованием Claude и Claude Code, а за облачную виртуальную машину отдельная плата не взимается.

16 16

17Облачные сеансы хорошо подходят для:17Облачные сеансы хорошо подходят для:

18 18

workflows.md +1 −1

Details

169 169

170Чтобы начать сессию с уже включённым ultracode, запустите с `claude --effort ultracode`, что также устанавливает уровень усилий на `xhigh`. Требуется Claude Code версии 2.1.203 или позже.170Чтобы начать сессию с уже включённым ultracode, запустите с `claude --effort ultracode`, что также устанавливает уровень усилий на `xhigh`. Требуется Claude Code версии 2.1.203 или позже.

171 171

172Чтобы включить его с помощью ползунка `/effort`, нажмите `Tab` для переключения переключателя **Ultracode**, затем `Enter` для применения. [Adjust effort level](/docs/ru/model-config#adjust-effort-level) перечисляет маршруты, которые включают ultracode.172Чтобы включить его с помощью ползунка `/effort`, нажмите `Tab` для переключения переключателя **Ultracode**, затем `Enter` для применения. Раздел [Регулировка уровня усилий](/docs/ru/model-config#adjust-effort-level) перечисляет маршруты, которые включают ultracode.

173 173

174С ultracode включённым, Claude решает, когда задача требует workflow. Один запрос может превратиться в несколько workflows подряд: один для понимания кода, один для внесения изменения и один для его проверки. Это применяется к каждой задаче в сессии, поэтому каждый запрос использует больше токенов и занимает больше времени, чем на более низких уровнях усилий. На плане подписки эти токены расходуют ваши лимиты использования, поэтому сессия с включённым ultracode достигает лимита сессии или недельного лимита раньше, чем та же работа с ним отключённым.174С ultracode включённым, Claude решает, когда задача требует workflow. Один запрос может превратиться в несколько workflows подряд: один для понимания кода, один для внесения изменения и один для его проверки. Это применяется к каждой задаче в сессии, поэтому каждый запрос использует больше токенов и занимает больше времени, чем на более низких уровнях усилий. На плане подписки эти токены расходуют ваши лимиты использования, поэтому сессия с включённым ultracode достигает лимита сессии или недельного лимита раньше, чем та же работа с ним отключённым.

175 175

worktrees.md +2 −2

Details

59 Очистка worktrees59 Очистка worktrees

60</h2>60</h2>

61 61

62Когда вы выходите из интерактивного сеанса worktree, Claude проверяет worktree на наличие работы, которая будет удалена при удалении: изменённые или неотслеживаемые файлы, незафиксированная работа внутри проверенных подмодулей и новые коммиты. Эти правила применяются к worktrees, которые Claude создал с помощью git. Для worktree, который создал ваш [WorktreeCreate hook](/docs/ru/hooks#worktreecreate), см. вместо этого [WorktreeRemove](/docs/ru/hooks#worktreeremove).62Когда вы выходите из интерактивного сеанса worktree, Claude проверяет worktree на наличие работы, которая будет удалена при удалении: изменённые или неотслеживаемые файлы, незафиксированная работа внутри извлечённых подмодулей и новые коммиты. Эти правила применяются к worktrees, которые Claude создал с помощью git. Для worktree, который создал ваш [WorktreeCreate hook](/docs/ru/hooks#worktreecreate), см. вместо этого [WorktreeRemove](/docs/ru/hooks#worktreeremove).

63 63

64* **Worktree чист**: для безымянного сеанса Claude автоматически удаляет worktree и его ветку. [Именованный](/docs/ru/sessions#name-your-sessions) сеанс сначала предлагает вам, чтобы вы могли сохранить worktree на потом64* **Worktree чист**: для безымянного сеанса Claude автоматически удаляет worktree и его ветку. [Именованный](/docs/ru/sessions#name-your-sessions) сеанс сначала предлагает вам, чтобы вы могли сохранить worktree на потом

65* **Worktree содержит работу**: Claude предлагает вам сохранить или удалить worktree. Сохранение сохраняет каталог и ветку. Чтобы вернуться позже, запустите команду `claude --worktree <name> --resume`, которую Claude Code выведет при выходе. Удаление удаляет каталог worktree и его ветку, вместе со всей работой в них65* **Worktree содержит работу**: Claude предлагает вам сохранить или удалить worktree. Сохранение сохраняет каталог и ветку. Чтобы вернуться позже, запустите команду `claude --worktree <name> --resume`, которую Claude Code выведет при выходе. Удаление удаляет каталог worktree и его ветку, вместе со всей работой в них

144Когда вы [отправляете в фон](/docs/ru/agent-view#send-the-session-to-the-background) сеанс `--worktree`, его worktree становится worktree фонового сеанса, который очистка может удалить. Очистка оставляет worktree на месте в этих случаях:144Когда вы [отправляете в фон](/docs/ru/agent-view#send-the-session-to-the-background) сеанс `--worktree`, его worktree становится worktree фонового сеанса, который очистка может удалить. Очистка оставляет worktree на месте в этих случаях:

145 145

146* Worktree по-прежнему содержит работу: изменённые или неотслеживаемые файлы или неотправленные коммиты.146* Worktree по-прежнему содержит работу: изменённые или неотслеживаемые файлы или неотправленные коммиты.

147* Проверенный submodule в worktree содержит изменённые или неотслеживаемые файлы, или Claude Code не может проверить submodules worktree. Эта проверка требует Claude Code v2.1.274 или более позднюю версию.147* Извлечённый submodule в worktree содержит изменённые или неотслеживаемые файлы, или Claude Code не может проверить submodules worktree. Эта проверка требует Claude Code v2.1.274 или более позднюю версию.

148* Один из [четырёх случаев, которые также блокируют создание worktree](#git-lfs-content-is-missing-from-a-worktree-claude-code-created) применяется: Claude Code не может определить, какие драйверы фильтров определяет конфигурация репозитория, или находит там параметр, который не может отключить.148* Один из [четырёх случаев, которые также блокируют создание worktree](#git-lfs-content-is-missing-from-a-worktree-claude-code-created) применяется: Claude Code не может определить, какие драйверы фильтров определяет конфигурация репозитория, или находит там параметр, который не может отключить.

149* Worktree принадлежит сеансу `--worktree`, который вы не отправили в фон, независимо от его возраста.149* Worktree принадлежит сеансу `--worktree`, который вы не отправили в фон, независимо от его возраста.

150* Вы создали worktree самостоятельно с `git worktree add`, даже если вы затем запустили сеанс `--worktree <name>` в нём и отправили этот сеанс в фон.150* Вы создали worktree самостоятельно с `git worktree add`, даже если вы затем запустили сеанс `--worktree <name>` в нём и отправили этот сеанс в фон.

Documentation 2026-10-07 23:59 UTC to 2026-10-08 21:58 UTC