SpyBara
Go Premium

Documentation 2026-10-29 23:57 UTC to 2026-10-30 23:01 UTC

90 files changed +4,591 −4,538. View all changes and history on the product overview
2026
Fri 30 23:01 Thu 29 23:57 Wed 28 23:57 Tue 27 22:59 Mon 26 22:57 Sun 25 23:58 Sat 24 22:59 Fri 23 22:59 Thu 22 22:58 Wed 21 23:02 Tue 20 23:00 Mon 19 23:58 Sat 17 23:57 Fri 16 22:59 Thu 15 23:58 Wed 14 22:58 Tue 13 23:57 Sun 11 23:57 Sat 10 23:01 Fri 9 23:02 Thu 8 22:58 Wed 7 23:59 Tue 6 23:59 Mon 5 23:58 Sun 4 23:58 Sat 3 23:57 Fri 2 22:59 Thu 1 23:59
Details

77* **Python:** проверьте типы сообщений с помощью `isinstance()` для классов, импортированных из `claude_agent_sdk` (например, `isinstance(message, ResultMessage)`).77* **Python:** проверьте типы сообщений с помощью `isinstance()` для классов, импортированных из `claude_agent_sdk` (например, `isinstance(message, ResultMessage)`).

78* **TypeScript:** проверьте строковое поле `type` (например, `message.type === "result"`). `AssistantMessage` и `UserMessage` оборачивают необработанное сообщение API в поле `.message`, поэтому блоки содержимого находятся в `message.message.content`, а не в `message.content`.78* **TypeScript:** проверьте строковое поле `type` (например, `message.type === "result"`). `AssistantMessage` и `UserMessage` оборачивают необработанное сообщение API в поле `.message`, поэтому блоки содержимого находятся в `message.message.content`, а не в `message.content`.

79 79 

80> **Пример: Проверить типы сообщений и обработать результаты**80> [accordion] Пример: Проверить типы сообщений и обработать результаты

81>81>

82> ```python Python theme={null}82> ```python Python theme={null}

83> import asyncio83> import asyncio

273* **Хук `PreCompact`:** запускайте пользовательскую логику перед сжатием контекста, например для архивирования полного транскрипта. Хук получает поле `trigger` (`manual` или `auto`). См. [хуки](https://code.claude.com/docs/ru/agent-sdk/hooks.md).273* **Хук `PreCompact`:** запускайте пользовательскую логику перед сжатием контекста, например для архивирования полного транскрипта. Хук получает поле `trigger` (`manual` или `auto`). См. [хуки](https://code.claude.com/docs/ru/agent-sdk/hooks.md).

274* **Ручное сжатие контекста:** отправьте `/compact` в качестве строки промпта, чтобы запустить сжатие по требованию. Команды, отправленные таким образом, — это обычные входные данные SDK. См. [отправка команд по имени](https://code.claude.com/docs/ru/agent-sdk/skills.md#dispatch-commands-by-name).274* **Ручное сжатие контекста:** отправьте `/compact` в качестве строки промпта, чтобы запустить сжатие по требованию. Команды, отправленные таким образом, — это обычные входные данные SDK. См. [отправка команд по имени](https://code.claude.com/docs/ru/agent-sdk/skills.md#dispatch-commands-by-name).

275 275 

276> **Пример: инструкции по резюмированию в CLAUDE.md**276> [accordion] Пример: инструкции по резюмированию в CLAUDE.md

277>277>

278> Добавьте в CLAUDE.md вашего проекта раздел, указывающий механизму сжатия, что сохранять. Название заголовка не имеет особого значения; используйте любую понятную метку.278> Добавьте в CLAUDE.md вашего проекта раздел, указывающий механизму сжатия, что сохранять. Название заголовка не имеет особого значения; используйте любую понятную метку.

279>279>

Details

42 42 

43Примеры на Python на этой странице, выполняющие HTTP-запросы, используют [httpx](https://www.python-httpx.org/). Добавьте его с помощью менеджера пакетов, который использует ваш проект:43Примеры на Python на этой странице, выполняющие HTTP-запросы, используют [httpx](https://www.python-httpx.org/). Добавьте его с помощью менеджера пакетов, который использует ваш проект:

44 44 

45**Python (uv)**45> [tab] Python (uv)

46 46>

47```bash theme={null}47> ```bash theme={null}

48uv add httpx48> uv add httpx

49```49> ```

50 

51**Python (pip)**

52 50 

53```bash theme={null}51> [tab] Python (pip)

54pip install httpx52>

55```53> ```bash theme={null}

54> pip install httpx

55> ```

56 56 

57### Пример инструмента Weather57### Пример инструмента Weather

58 58 

198 198 

199Объедините этот фрагмент с определениями инструмента и сервера из [примера инструмента Weather](#weather-tool-example) в одном файле, `weather.py` или `weather.ts`, затем запустите его из терминала:199Объедините этот фрагмент с определениями инструмента и сервера из [примера инструмента Weather](#weather-tool-example) в одном файле, `weather.py` или `weather.ts`, затем запустите его из терминала:

200 200 

201**TypeScript**201> [tab] TypeScript

202 202>

203```bash theme={null}203> ```bash theme={null}

204npx tsx weather.ts204> npx tsx weather.ts

205```205> ```

206 

207**Python (uv)**

208 

209```bash theme={null}

210uv run weather.py

211```

212 

213**Python (pip)**

214 206 

215Активируйте виртуальное окружение, в котором вы установили SDK, затем выполните:207> [tab] Python (uv)

208>

209> ```bash theme={null}

210> uv run weather.py

211> ```

216 212 

217```bash theme={null}213> [tab] Python (pip)

218python weather.py214>

219```215> Активируйте виртуальное окружение, в котором вы установили SDK, затем выполните:

216>

217> ```bash theme={null}

218> python weather.py

219> ```

220 220 

221Claude вызывает `get_temperature`, и скрипт выводит однострочный ответ с текущей температурой в Сан-Франциско.221Claude вызывает `get_temperature`, и скрипт выводит однострочный ответ с текущей температурой в Сан-Франциско.

222 222 

Details

585>585>

586> Откройте ваш служебный файл (`utils.py` или `utils.ts`) в вашей IDE или редакторе перед запуском скрипта. Вы увидите, как файл обновляется в реальном времени, когда агент добавляет комментарии к документации, затем вернётся к оригиналу, когда вы выберете отмотку.586> Откройте ваш служебный файл (`utils.py` или `utils.ts`) в вашей IDE или редакторе перед запуском скрипта. Вы увидите, как файл обновляется в реальном времени, когда агент добавляет комментарии к документации, затем вернётся к оригиналу, когда вы выберете отмотку.

587 587 

588**Python**588> [tab] Python

589 589>

590```bash theme={null}590> ```bash theme={null}

591python try_checkpointing.py591> python try_checkpointing.py

592```592> ```

593 

594**TypeScript**

595 593 

596```bash theme={null}594> [tab] TypeScript

597npx tsx try_checkpointing.ts595>

598```596> ```bash theme={null}

597> npx tsx try_checkpointing.ts

598> ```

599 599 

600Вы увидите, как агент добавляет комментарии к документации, затем появится приглашение, спрашивающее, хотите ли вы отмотать. Если вы выберете да, файл будет восстановлен в его исходное состояние.600Вы увидите, как агент добавляет комментарии к документации, затем появится приглашение, спрашивающее, хотите ли вы отмотать. Если вы выберете да, файл будет восстановлен в его исходное состояние.

601 601 

agent-sdk/mcp.md +98 −98

Details

386 386 

387Используйте поле `env` для передачи ключей API, токенов и других учетных данных на сервер MCP:387Используйте поле `env` для передачи ключей API, токенов и других учетных данных на сервер MCP:

388 388 

389**В коде**389> [tab] В коде

390 390>

391```typescript TypeScript hidelines={1,-1} theme={null}391> ```typescript TypeScript hidelines={1,-1} theme={null}

392const _ = {392> const _ = {

393 options: {393> options: {

394 mcpServers: {394> mcpServers: {

395 "api-server": {395> "api-server": {

396 command: "npx",396> command: "npx",

397 args: ["-y", "@your-org/api-mcp-server"],397> args: ["-y", "@your-org/api-mcp-server"],

398 env: {398> env: {

399 API_KEY: process.env.API_KEY399> API_KEY: process.env.API_KEY

400 }400> }

401 }401> }

402 },402> },

403 allowedTools: ["mcp__api-server__*"]403> allowedTools: ["mcp__api-server__*"]

404 }404> }

405};405> };

406```406> ```

407 407>

408```python Python theme={null}408> ```python Python theme={null}

409options = ClaudeAgentOptions(409> options = ClaudeAgentOptions(

410 mcp_servers={410> mcp_servers={

411 "api-server": {411> "api-server": {

412 "command": "npx",412> "command": "npx",

413 "args": ["-y", "@your-org/api-mcp-server"],413> "args": ["-y", "@your-org/api-mcp-server"],

414 "env": {"API_KEY": os.environ["API_KEY"]},414> "env": {"API_KEY": os.environ["API_KEY"]},

415 }415> }

416 },416> },

417 allowed_tools=["mcp__api-server__*"],417> allowed_tools=["mcp__api-server__*"],

418)418> )

419```419> ```

420 420 

421**.mcp.json**421> [tab] .mcp.json

422 422>

423```json theme={null}423> ```json theme={null}

424{424> {

425 "mcpServers": {425> "mcpServers": {

426 "api-server": {426> "api-server": {

427 "command": "npx",427> "command": "npx",

428 "args": ["-y", "@your-org/api-mcp-server"],428> "args": ["-y", "@your-org/api-mcp-server"],

429 "env": {429> "env": {

430 "API_KEY": "${API_KEY}"430> "API_KEY": "${API_KEY}"

431 }431> }

432 }432> }

433 }433> }

434}434> }

435```435> ```

436 436>

437Синтаксис `${API_KEY}` раскрывает переменные окружения во время выполнения.437> Синтаксис `${API_KEY}` раскрывает переменные окружения во время выполнения.

438 438 

439### HTTP-заголовки для удаленных серверов439### HTTP-заголовки для удаленных серверов

440 440 

441Для HTTP и SSE серверов передавайте заголовки аутентификации непосредственно в конфигурации сервера:441Для HTTP и SSE серверов передавайте заголовки аутентификации непосредственно в конфигурации сервера:

442 442 

443**В коде**443> [tab] В коде

444 444>

445```typescript TypeScript hidelines={1,-1} theme={null}445> ```typescript TypeScript hidelines={1,-1} theme={null}

446const _ = {446> const _ = {

447 options: {447> options: {

448 mcpServers: {448> mcpServers: {

449 "secure-api": {449> "secure-api": {

450 type: "http",450> type: "http",

451 url: "https://api.example.com/mcp",451> url: "https://api.example.com/mcp",

452 headers: {452> headers: {

453 Authorization: `Bearer ${process.env.API_TOKEN}`453> Authorization: `Bearer ${process.env.API_TOKEN}`

454 }454> }

455 }455> }

456 },456> },

457 allowedTools: ["mcp__secure-api__*"]457> allowedTools: ["mcp__secure-api__*"]

458 }458> }

459};459> };

460```460> ```

461 461>

462```python Python theme={null}462> ```python Python theme={null}

463options = ClaudeAgentOptions(463> options = ClaudeAgentOptions(

464 mcp_servers={464> mcp_servers={

465 "secure-api": {465> "secure-api": {

466 "type": "http",466> "type": "http",

467 "url": "https://api.example.com/mcp",467> "url": "https://api.example.com/mcp",

468 "headers": {"Authorization": f"Bearer {os.environ['API_TOKEN']}"},468> "headers": {"Authorization": f"Bearer {os.environ['API_TOKEN']}"},

469 }469> }

470 },470> },

471 allowed_tools=["mcp__secure-api__*"],471> allowed_tools=["mcp__secure-api__*"],

472)472> )

473```473> ```

474 474 

475**.mcp.json**475> [tab] .mcp.json

476 476>

477```json theme={null}477> ```json theme={null}

478{478> {

479 "mcpServers": {479> "mcpServers": {

480 "secure-api": {480> "secure-api": {

481 "type": "http",481> "type": "http",

482 "url": "https://api.example.com/mcp",482> "url": "https://api.example.com/mcp",

483 "headers": {483> "headers": {

484 "Authorization": "Bearer ${API_TOKEN}"484> "Authorization": "Bearer ${API_TOKEN}"

485 }485> }

486 }486> }

487 }487> }

488}488> }

489```489> ```

490 490>

491Синтаксис `${API_TOKEN}` раскрывает переменные окружения во время выполнения.491> Синтаксис `${API_TOKEN}` раскрывает переменные окружения во время выполнения.

492 492 

493Полный рабочий пример удаленного сервера с аутентификацией через заголовки см. в разделе [Список проблем из репозитория](#list-issues-from-a-repository).493Полный рабочий пример удаленного сервера с аутентификацией через заголовки см. в разделе [Список проблем из репозитория](#list-issues-from-a-repository).

494 494 

Details

163 163 

164Вы можете установить режим разрешений один раз при запуске запроса или изменить его динамически во время активного сеанса.164Вы можете установить режим разрешений один раз при запуске запроса или изменить его динамически во время активного сеанса.

165 165 

166**При запросе**166> [tab] При запросе

167 167>

168Передайте `permission_mode` (Python) или `permissionMode` (TypeScript) при создании запроса.168> Передайте `permission_mode` (Python) или `permissionMode` (TypeScript) при создании запроса.

169 169>

170```python Python theme={null}170> ```python Python theme={null}

171import asyncio171> import asyncio

172from claude_agent_sdk import query, ClaudeAgentOptions172> from claude_agent_sdk import query, ClaudeAgentOptions

173 173>

174 174>

175async def main():175> async def main():

176 async for message in query(176> async for message in query(

177 prompt="Help me refactor this code",177> prompt="Help me refactor this code",

178 options=ClaudeAgentOptions(178> options=ClaudeAgentOptions(

179 permission_mode="default", # Set the mode here179> permission_mode="default", # Set the mode here

180 ),180> ),

181 ):181> ):

182 if hasattr(message, "result"):182> if hasattr(message, "result"):

183 print(message.result)183> print(message.result)

184 184>

185 185>

186asyncio.run(main())186> asyncio.run(main())

187```187> ```

188 188>

189```typescript TypeScript theme={null}189> ```typescript TypeScript theme={null}

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

191 191>

192async function main() {192> async function main() {

193 for await (const message of query({193> for await (const message of query({

194 prompt: "Help me refactor this code",194> prompt: "Help me refactor this code",

195 options: {195> options: {

196 permissionMode: "default" // Set the mode here196> permissionMode: "default" // Set the mode here

197 }197> }

198 })) {198> })) {

199 if ("result" in message) {199> if ("result" in message) {

200 console.log(message.result);200> console.log(message.result);

201 }201> }

202 }202> }

203}203> }

204 204>

205main();205> main();

206```206> ```

207 

208**Во время потоковой передачи**

209 

210Вызовите `set_permission_mode()` (Python) или `setPermissionMode()` (TypeScript) для изменения режима в середине сеанса. Новый режим вступает в силу немедленно для всех последующих запросов инструментов. Это позволяет вам начать с ограничительного режима и ослабить разрешения по мере развития доверия, например переключиться на `acceptEdits` после проверки первоначального подхода Claude.

211 

212```python Python theme={null}

213import asyncio

214from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

215 

216 

217async def main():

218 async with ClaudeSDKClient(

219 options=ClaudeAgentOptions(

220 permission_mode="default", # Start in default mode

221 )

222 ) as client:

223 await client.query("Help me refactor this code")

224 

225 # Change mode dynamically mid-session

226 await client.set_permission_mode("acceptEdits")

227 

228 # Process messages with the new permission mode

229 async for message in client.receive_response():

230 if hasattr(message, "result"):

231 print(message.result)

232 

233 

234asyncio.run(main())

235```

236 207 

237```typescript TypeScript theme={null}208> [tab] Во время потоковой передачи

238import { query } from "@anthropic-ai/claude-agent-sdk";209>

239 210> Вызовите `set_permission_mode()` (Python) или `setPermissionMode()` (TypeScript) для изменения режима в середине сеанса. Новый режим вступает в силу немедленно для всех последующих запросов инструментов. Это позволяет вам начать с ограничительного режима и ослабить разрешения по мере развития доверия, например переключиться на `acceptEdits` после проверки первоначального подхода Claude.

240async function main() {211>

241 const q = query({212> ```python Python theme={null}

242 prompt: "Help me refactor this code",213> import asyncio

243 options: {214> from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

244 permissionMode: "default" // Start in default mode215>

245 }216>

246 });217> async def main():

247 218> async with ClaudeSDKClient(

248 // Change mode dynamically mid-session219> options=ClaudeAgentOptions(

249 await q.setPermissionMode("acceptEdits");220> permission_mode="default", # Start in default mode

250 221> )

251 // Process messages with the new permission mode222> ) as client:

252 for await (const message of q) {223> await client.query("Help me refactor this code")

253 if ("result" in message) {224>

254 console.log(message.result);225> # Change mode dynamically mid-session

255 }226> await client.set_permission_mode("acceptEdits")

256 }227>

257}228> # Process messages with the new permission mode

258 229> async for message in client.receive_response():

259main();230> if hasattr(message, "result"):

260```231> print(message.result)

232>

233>

234> asyncio.run(main())

235> ```

236>

237> ```typescript TypeScript theme={null}

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

239>

240> async function main() {

241> const q = query({

242> prompt: "Help me refactor this code",

243> options: {

244> permissionMode: "default" // Start in default mode

245> }

246> });

247>

248> // Change mode dynamically mid-session

249> await q.setPermissionMode("acceptEdits");

250>

251> // Process messages with the new permission mode

252> for await (const message of q) {

253> if ("result" in message) {

254> console.log(message.result);

255> }

256> }

257> }

258>

259> main();

260> ```

261 261 

262### Детали режимов262### Детали режимов

263 263 

Details

36 36 

37Установите пакет Agent SDK для вашего языка:37Установите пакет Agent SDK для вашего языка:

38 38 

39**TypeScript (новый проект)**39> [tab] TypeScript (новый проект)

40 40>

41```bash theme={null}41> ```bash theme={null}

42npm init -y42> npm init -y

43npm pkg set type=module43> npm pkg set type=module

44npm install @anthropic-ai/claude-agent-sdk44> npm install @anthropic-ai/claude-agent-sdk

45npm install --save-dev tsx45> npm install --save-dev tsx

46```46> ```

47 47>

48Установка `"type": "module"` в `package.json` позволяет вашему скрипту агента использовать верхнеуровневый `await`, а [tsx](https://tsx.hirok.io) запускает файлы TypeScript напрямую. npm выводит `added N packages` при успешной установке.48> Установка `"type": "module"` в `package.json` позволяет вашему скрипту агента использовать верхнеуровневый `await`, а [tsx](https://tsx.hirok.io) запускает файлы TypeScript напрямую. npm выводит `added N packages` при успешной установке.

49 

50**TypeScript (существующий проект)**

51 

52```bash theme={null}

53npm install @anthropic-ai/claude-agent-sdk

54npm install --save-dev tsx

55```

56 

57[tsx](https://tsx.hirok.io) запускает файлы TypeScript напрямую. Если ваш проект использует CommonJS, назовите ваш скрипт агента `agent.mts` вместо `agent.ts`. Расширение `.mts` заставляет tsx рассматривать файл как ES модуль, поэтому верхнеуровневый `await` работает без преобразования всего вашего проекта в ES модули. Используйте `agent.mts` вместо `agent.ts` на этапах создания и запуска далее в этом быстром старте.

58 

59**Python (uv)**

60 

61[Установите uv](https://docs.astral.sh/uv/), быстрый менеджер пакетов Python, который автоматически управляет виртуальными окружениями. Затем инициализируйте проект и добавьте SDK:

62 

63```bash theme={null}

64uv init

65uv add claude-agent-sdk

66```

67 

68**Python (pip)**

69 

70Создайте и активируйте виртуальное окружение, затем установите пакет.

71 

72На macOS или Linux:

73 

74```bash theme={null}

75python3 -m venv .venv

76source .venv/bin/activate

77pip install claude-agent-sdk

78```

79 49 

80На Windows:50> [tab] TypeScript (существующий проект)

51>

52> ```bash theme={null}

53> npm install @anthropic-ai/claude-agent-sdk

54> npm install --save-dev tsx

55> ```

56>

57> [tsx](https://tsx.hirok.io) запускает файлы TypeScript напрямую. Если ваш проект использует CommonJS, назовите ваш скрипт агента `agent.mts` вместо `agent.ts`. Расширение `.mts` заставляет tsx рассматривать файл как ES модуль, поэтому верхнеуровневый `await` работает без преобразования всего вашего проекта в ES модули. Используйте `agent.mts` вместо `agent.ts` на этапах создания и запуска далее в этом быстром старте.

81 58 

82```powershell theme={null}59> [tab] Python (uv)

83py -m venv .venv60>

84.venv\Scripts\Activate.ps161> [Установите uv](https://docs.astral.sh/uv/), быстрый менеджер пакетов Python, который автоматически управляет виртуальными окружениями. Затем инициализируйте проект и добавьте SDK:

85pip install claude-agent-sdk62>

86```63> ```bash theme={null}

64> uv init

65> uv add claude-agent-sdk

66> ```

87 67 

88Если PowerShell блокирует `Activate.ps1` с ошибкой политики выполнения, сначала выполните `Set-ExecutionPolicy -Scope Process RemoteSigned`.68> [tab] Python (pip)

69>

70> Создайте и активируйте виртуальное окружение, затем установите пакет.

71>

72> На macOS или Linux:

73>

74> ```bash theme={null}

75> python3 -m venv .venv

76> source .venv/bin/activate

77> pip install claude-agent-sdk

78> ```

79>

80> На Windows:

81>

82> ```powershell theme={null}

83> py -m venv .venv

84> .venv\Scripts\Activate.ps1

85> pip install claude-agent-sdk

86> ```

87>

88> Если PowerShell блокирует `Activate.ps1` с ошибкой политики выполнения, сначала выполните `Set-ExecutionPolicy -Scope Process RemoteSigned`.

89 89 

90> [!NOTE]90> [!NOTE]

91>91>

98 98 

99Получите API ключ из [Claude Console](https://platform.claude.com/), затем установите его как переменную окружения в оболочке, где вы будете запускать вашего агента:99Получите API ключ из [Claude Console](https://platform.claude.com/), затем установите его как переменную окружения в оболочке, где вы будете запускать вашего агента:

100 100 

101**macOS / Linux**101> [tab] macOS / Linux

102 102>

103```bash theme={null}103> ```bash theme={null}

104export ANTHROPIC_API_KEY=your-api-key104> export ANTHROPIC_API_KEY=your-api-key

105```105> ```

106 

107**Windows (PowerShell)**

108 106 

109```powershell theme={null}107> [tab] Windows (PowerShell)

110$env:ANTHROPIC_API_KEY = "your-api-key"108>

111```109> ```powershell theme={null}

110> $env:ANTHROPIC_API_KEY = "your-api-key"

111> ```

112 112 

113SDK читает ключ из окружения процесса, который запускает вашего агента; он не загружает файлы `.env` автоматически. Если вы храните ключ в файле `.env`, загрузите его самостоятельно, например с помощью пакета `dotenv`, перед вызовом SDK.113SDK читает ключ из окружения процесса, который запускает вашего агента; он не загружает файлы `.env` автоматически. Если вы храните ключ в файле `.env`, загрузите его самостоятельно, например с помощью пакета `dotenv`, перед вызовом SDK.

114 114 

224 224 

225Ваш агент готов. Запустите его с помощью следующей команды:225Ваш агент готов. Запустите его с помощью следующей команды:

226 226 

227**TypeScript**227> [tab] TypeScript

228 228>

229```bash theme={null}229> ```bash theme={null}

230npx tsx agent.ts230> npx tsx agent.ts

231```231> ```

232 232>

233Если вы назвали ваш скрипт `agent.mts`, запустите `npx tsx agent.mts` вместо этого.233> Если вы назвали ваш скрипт `agent.mts`, запустите `npx tsx agent.mts` вместо этого.

234 

235**Python (uv)**

236 

237```bash theme={null}

238uv run agent.py

239```

240 

241**Python (pip)**

242 234 

243С активированной виртуальной средой:235> [tab] Python (uv)

236>

237> ```bash theme={null}

238> uv run agent.py

239> ```

244 240 

245```bash theme={null}241> [tab] Python (pip)

246python agent.py242>

247```243> С активированной виртуальной средой:

244>

245> ```bash theme={null}

246> python agent.py

247> ```

248 248 

249По мере работы агент выводит своё рассуждение и каждый инструмент, который он вызывает, заканчивая с `Done: success`. После запуска проверьте `utils.py`. Вы увидите защитный код, обрабатывающий пустые списки и нулевых пользователей. Ваш агент автономно:249По мере работы агент выводит своё рассуждение и каждый инструмент, который он вызывает, заканчивая с `Done: success`. После запуска проверьте `utils.py`. Вы увидите защитный код, обрабатывающий пустые списки и нулевых пользователей. Ваш агент автономно:

250 250 

Details

470 470 

471Каждый SDK выводит отклонение по-разному:471Каждый SDK выводит отклонение по-разному:

472 472 

473**TypeScript**473> [tab] TypeScript

474 474>

475TypeScript SDK выдаёт `Error`, указывающую правило, которое нарушила запись. Например, `skills: ["docs:*"]` выдаёт:475> TypeScript SDK выдаёт `Error`, указывающую правило, которое нарушила запись. Например, `skills: ["docs:*"]` выдаёт:

476 476>

477```text theme={null}477> ```text theme={null}

478Invalid skill name "docs:*": wildcard-suffix names are not allowed; list each skill by its exact name.478> Invalid skill name "docs:*": wildcard-suffix names are not allowed; list each skill by its exact name.

479```479> ```

480 480>

481Пустое имя сообщает `Skill names must be non-empty strings.`481> Пустое имя сообщает `Skill names must be non-empty strings.`

482 482>

483До TypeScript Agent SDK 0.3.221 SDK не выполнял эту проверку.483> До TypeScript Agent SDK 0.3.221 SDK не выполнял эту проверку.

484 

485**Python**

486 

487Python SDK выдаёт `ValueError`, указывающую правило, которое нарушила запись. Например, `skills=["docs:*"]` выдаёт:

488 

489```text theme={null}

490ValueError: Invalid skill name 'docs:*': wildcard-suffix names are not allowed; list each skill by its exact name.

491```

492 

493Пустое имя сообщает `Skill names must be non-empty strings`.

494 484 

495До Python Agent SDK 0.2.129 SDK не выполнял эту проверку.485> [tab] Python

486>

487> Python SDK выдаёт `ValueError`, указывающую правило, которое нарушила запись. Например, `skills=["docs:*"]` выдаёт:

488>

489> ```text theme={null}

490> ValueError: Invalid skill name 'docs:*': wildcard-suffix names are not allowed; list each skill by its exact name.

491> ```

492>

493> Пустое имя сообщает `Skill names must be non-empty strings`.

494>

495> До Python Agent SDK 0.2.129 SDK не выполнял эту проверку.

496 496 

497### Дополнительное troubleshooting497### Дополнительное troubleshooting

498 498 

Details

16 16 

17Рассмотрим приложение рецептов, где агент ищет в интернете и приносит рецепты. Без структурированных выводов вы получаете свободный текст, который вам нужно было бы разбирать самостоятельно. Со структурированными выводами вы определяете нужную вам форму и получаете типизированные данные, которые можно использовать непосредственно в приложении.17Рассмотрим приложение рецептов, где агент ищет в интернете и приносит рецепты. Без структурированных выводов вы получаете свободный текст, который вам нужно было бы разбирать самостоятельно. Со структурированными выводами вы определяете нужную вам форму и получаете типизированные данные, которые можно использовать непосредственно в приложении.

18 18 

19> **Без структурированных выводов**19> [accordion] Без структурированных выводов

20>20>

21> ```text theme={null}21> ```text theme={null}

22> Вот классический рецепт печенья с шоколадной крошкой!22> Вот классический рецепт печенья с шоколадной крошкой!

32>32>

33> Чтобы использовать это в приложении, вам нужно было бы разобрать название, преобразовать "15 минут" в число, отделить ингредиенты от инструкций и справиться с несогласованным форматированием в разных ответах.33> Чтобы использовать это в приложении, вам нужно было бы разобрать название, преобразовать "15 минут" в число, отделить ингредиенты от инструкций и справиться с несогласованным форматированием в разных ответах.

34 34 

35> **Со структурированными выводами**35> [accordion] Со структурированными выводами

36>36>

37> ```jsonc theme={null}37> ```jsonc theme={null}

38> {38> {

Details

225 225 

226Вспомогательные функции `ask_user` и `askUser` в следующих фрагментах кода служат заменой для собственного пользовательского интерфейса запроса вашего приложения.226Вспомогательные функции `ask_user` и `askUser` в следующих фрагментах кода служат заменой для собственного пользовательского интерфейса запроса вашего приложения.

227 227 

228**Одобрить**228> [tab] Одобрить

229 229>

230Пользователь одобряет действие как есть. Пропустите `input` из вашего callback без изменений и инструмент выполнится ровно так, как запросил Claude.230> Пользователь одобряет действие как есть. Пропустите `input` из вашего callback без изменений и инструмент выполнится ровно так, как запросил Claude.

231 231>

232```python Python theme={null}232> ```python Python theme={null}

233async def can_use_tool(tool_name, input_data, context):233> async def can_use_tool(tool_name, input_data, context):

234 print(f"Claude wants to use {tool_name}")234> print(f"Claude wants to use {tool_name}")

235 approved = await ask_user("Allow this action?")235> approved = await ask_user("Allow this action?")

236 236>

237 if approved:237> if approved:

238 return PermissionResultAllow(updated_input=input_data)238> return PermissionResultAllow(updated_input=input_data)

239 return PermissionResultDeny(message="User declined")239> return PermissionResultDeny(message="User declined")

240```240> ```

241 241>

242```typescript TypeScript theme={null}242> ```typescript TypeScript theme={null}

243canUseTool: async (toolName, input) => {243> canUseTool: async (toolName, input) => {

244 console.log(`Claude wants to use ${toolName}`);244> console.log(`Claude wants to use ${toolName}`);

245 const approved = await askUser("Allow this action?");245> const approved = await askUser("Allow this action?");

246 246>

247 if (approved) {247> if (approved) {

248 return { behavior: "allow", updatedInput: input };248> return { behavior: "allow", updatedInput: input };

249 }249> }

250 return { behavior: "deny", message: "User declined" };250> return { behavior: "deny", message: "User declined" };

251};251> };

252```252> ```

253 253 

254**Одобрить с изменениями**254> [tab] Одобрить с изменениями

255 255>

256Пользователь одобряет, но хочет сначала изменить запрос. Вы можете изменить ввод перед выполнением инструмента. Claude видит результат, но не сообщается, что вы что-то изменили. Полезно для санитизации параметров, добавления ограничений или ограничения доступа.256> Пользователь одобряет, но хочет сначала изменить запрос. Вы можете изменить ввод перед выполнением инструмента. Claude видит результат, но не сообщается, что вы что-то изменили. Полезно для санитизации параметров, добавления ограничений или ограничения доступа.

257 257>

258```python Python theme={null}258> ```python Python theme={null}

259async def can_use_tool(tool_name, input_data, context):259> async def can_use_tool(tool_name, input_data, context):

260 if tool_name == "Bash":260> if tool_name == "Bash":

261 # Пользователь одобрил, но ограничить все команды песочницей261> # Пользователь одобрил, но ограничить все команды песочницей

262 sandboxed_input = {**input_data}262> sandboxed_input = {**input_data}

263 sandboxed_input["command"] = input_data["command"].replace(263> sandboxed_input["command"] = input_data["command"].replace(

264 "/tmp", "/tmp/sandbox"264> "/tmp", "/tmp/sandbox"

265 )265> )

266 return PermissionResultAllow(updated_input=sandboxed_input)266> return PermissionResultAllow(updated_input=sandboxed_input)

267 return PermissionResultAllow(updated_input=input_data)267> return PermissionResultAllow(updated_input=input_data)

268```268> ```

269 269>

270```typescript TypeScript theme={null}270> ```typescript TypeScript theme={null}

271canUseTool: async (toolName, input) => {271> canUseTool: async (toolName, input) => {

272 if (toolName === "Bash") {272> if (toolName === "Bash") {

273 // Пользователь одобрил, но ограничить все команды песочницей273> // Пользователь одобрил, но ограничить все команды песочницей

274 const sandboxedInput = {274> const sandboxedInput = {

275 ...input,275> ...input,

276 command: input.command.replace("/tmp", "/tmp/sandbox")276> command: input.command.replace("/tmp", "/tmp/sandbox")

277 };277> };

278 return { behavior: "allow", updatedInput: sandboxedInput };278> return { behavior: "allow", updatedInput: sandboxedInput };

279 }279> }

280 return { behavior: "allow", updatedInput: input };280> return { behavior: "allow", updatedInput: input };

281};281> };

282```282> ```

283 283 

284**Одобрить и запомнить**284> [tab] Одобрить и запомнить

285 285>

286Пользователь одобряет и не хочет, чтобы его спрашивали снова для этого вида вызова. Третий аргумент callback содержит `suggestions`, массив готовых записей [`PermissionUpdate`](https://code.claude.com/docs/ru/agent-sdk/typescript#permissionupdate). Отправьте одну обратно в `updatedPermissions` для её применения. Предложение с назначением `localSettings` записывает правило в `.claude/settings.local.json`, чтобы будущие сеансы пропускали запрос для совпадающих вызовов.286> Пользователь одобряет и не хочет, чтобы его спрашивали снова для этого вида вызова. Третий аргумент callback содержит `suggestions`, массив готовых записей [`PermissionUpdate`](https://code.claude.com/docs/ru/agent-sdk/typescript#permissionupdate). Отправьте одну обратно в `updatedPermissions` для её применения. Предложение с назначением `localSettings` записывает правило в `.claude/settings.local.json`, чтобы будущие сеансы пропускали запрос для совпадающих вызовов.

287 287>

288В TypeScript пропустите вариант всегда разрешить для запроса, параметры которого содержат [`suppressAlwaysAllowRule: true`](https://code.claude.com/docs/ru/agent-sdk/typescript#canusetool). Подсказка требует Agent SDK версии 0.3.268 или позже, и Python `context` её не содержит.288> В TypeScript пропустите вариант всегда разрешить для запроса, параметры которого содержат [`suppressAlwaysAllowRule: true`](https://code.claude.com/docs/ru/agent-sdk/typescript#canusetool). Подсказка требует Agent SDK версии 0.3.268 или позже, и Python `context` её не содержит.

289 289>

290Пример Python требует `claude-agent-sdk` версии 0.1.80 или позже.290> Пример Python требует `claude-agent-sdk` версии 0.1.80 или позже.

291 291>

292```python Python theme={null}292> ```python Python theme={null}

293async def can_use_tool(tool_name, input_data, context):293> async def can_use_tool(tool_name, input_data, context):

294 choice = await ask_user(f"Allow {tool_name}?", ["once", "always", "no"])294> choice = await ask_user(f"Allow {tool_name}?", ["once", "always", "no"])

295 295>

296 if choice == "always":296> if choice == "always":

297 persist = [297> persist = [

298 s for s in context.suggestions if s.destination == "localSettings"298> s for s in context.suggestions if s.destination == "localSettings"

299 ]299> ]

300 return PermissionResultAllow(300> return PermissionResultAllow(

301 updated_input=input_data, updated_permissions=persist301> updated_input=input_data, updated_permissions=persist

302 )302> )

303 if choice == "once":303> if choice == "once":

304 return PermissionResultAllow(updated_input=input_data)304> return PermissionResultAllow(updated_input=input_data)

305 return PermissionResultDeny(message="User declined")305> return PermissionResultDeny(message="User declined")

306```306> ```

307 307>

308```typescript TypeScript theme={null}308> ```typescript TypeScript theme={null}

309canUseTool: async (toolName, input, { suggestions = [] }) => {309> canUseTool: async (toolName, input, { suggestions = [] }) => {

310 const choice = await askUser(`Allow ${toolName}?`, ["once", "always", "no"]);310> const choice = await askUser(`Allow ${toolName}?`, ["once", "always", "no"]);

311 311>

312 if (choice === "always") {312> if (choice === "always") {

313 const persist = suggestions.filter(313> const persist = suggestions.filter(

314 (s) => s.destination === "localSettings"314> (s) => s.destination === "localSettings"

315 );315> );

316 return {316> return {

317 behavior: "allow",317> behavior: "allow",

318 updatedInput: input,318> updatedInput: input,

319 updatedPermissions: persist319> updatedPermissions: persist

320 };320> };

321 }321> }

322 if (choice === "once") {322> if (choice === "once") {

323 return { behavior: "allow", updatedInput: input };323> return { behavior: "allow", updatedInput: input };

324 }324> }

325 return { behavior: "deny", message: "User declined" };325> return { behavior: "deny", message: "User declined" };

326};326> };

327```327> ```

328 328 

329**Отклонить**329> [tab] Отклонить

330 330>

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

332 332>

333```python Python theme={null}333> ```python Python theme={null}

334async def can_use_tool(tool_name, input_data, context):334> async def can_use_tool(tool_name, input_data, context):

335 approved = await ask_user(f"Allow {tool_name}?")335> approved = await ask_user(f"Allow {tool_name}?")

336 336>

337 if not approved:337> if not approved:

338 return PermissionResultDeny(message="User rejected this action")338> return PermissionResultDeny(message="User rejected this action")

339 return PermissionResultAllow(updated_input=input_data)339> return PermissionResultAllow(updated_input=input_data)

340```340> ```

341 341>

342```typescript TypeScript theme={null}342> ```typescript TypeScript theme={null}

343canUseTool: async (toolName, input) => {343> canUseTool: async (toolName, input) => {

344 const approved = await askUser(`Allow ${toolName}?`);344> const approved = await askUser(`Allow ${toolName}?`);

345 345>

346 if (!approved) {346> if (!approved) {

347 return {347> return {

348 behavior: "deny",348> behavior: "deny",

349 message: "User rejected this action"349> message: "User rejected this action"

350 };350> };

351 }351> }

352 return { behavior: "allow", updatedInput: input };352> return { behavior: "allow", updatedInput: input };

353};353> };

354```354> ```

355 355 

356**Предложить альтернативу**356> [tab] Предложить альтернативу

357 357>

358Пользователь не хочет это конкретное действие, но имеет другую идею. Заблокируйте инструмент и включите рекомендацию в ваше сообщение. Claude прочитает это и решит, как действовать на основе вашей обратной связи.358> Пользователь не хочет это конкретное действие, но имеет другую идею. Заблокируйте инструмент и включите рекомендацию в ваше сообщение. Claude прочитает это и решит, как действовать на основе вашей обратной связи.

359 359>

360```python Python theme={null}360> ```python Python theme={null}

361async def can_use_tool(tool_name, input_data, context):361> async def can_use_tool(tool_name, input_data, context):

362 if tool_name == "Bash" and "rm" in input_data.get("command", ""):362> if tool_name == "Bash" and "rm" in input_data.get("command", ""):

363 # Пользователь не хочет удалять, предложить архивирование вместо этого363> # Пользователь не хочет удалять, предложить архивирование вместо этого

364 return PermissionResultDeny(364> return PermissionResultDeny(

365 message="User doesn't want to delete files. They asked if you could compress them into an archive instead."365> message="User doesn't want to delete files. They asked if you could compress them into an archive instead."

366 )366> )

367 return PermissionResultAllow(updated_input=input_data)367> return PermissionResultAllow(updated_input=input_data)

368```368> ```

369 369>

370```typescript TypeScript theme={null}370> ```typescript TypeScript theme={null}

371canUseTool: async (toolName, input) => {371> canUseTool: async (toolName, input) => {

372 if (toolName === "Bash" && input.command.includes("rm")) {372> if (toolName === "Bash" && input.command.includes("rm")) {

373 // Пользователь не хочет удалять, предложить архивирование вместо этого373> // Пользователь не хочет удалять, предложить архивирование вместо этого

374 return {374> return {

375 behavior: "deny",375> behavior: "deny",

376 message:376> message:

377 "User doesn't want to delete files. They asked if you could compress them into an archive instead."377> "User doesn't want to delete files. They asked if you could compress them into an archive instead."

378 };378> };

379 }379> }

380 return { behavior: "allow", updatedInput: input };380> return { behavior: "allow", updatedInput: input };

381};381> };

382```382> ```

383 383 

384**Полностью перенаправить**384> [tab] Полностью перенаправить

385 385>

386Для полного изменения направления (не просто подсказка), используйте [потоковый ввод](https://code.claude.com/docs/ru/agent-sdk/streaming-vs-single-mode.md) для отправки Claude новой инструкции напрямую. Это обходит текущий запрос инструмента и даёт Claude совершенно новые инструкции для следования.386> Для полного изменения направления (не просто подсказка), используйте [потоковый ввод](https://code.claude.com/docs/ru/agent-sdk/streaming-vs-single-mode.md) для отправки Claude новой инструкции напрямую. Это обходит текущий запрос инструмента и даёт Claude совершенно новые инструкции для следования.

387 387 

388## Обработка уточняющих вопросов388## Обработка уточняющих вопросов

389 389 

agents.md +1 −1

Details

13| [Subagents](https://code.claude.com/docs/ru/sub-agents.md) | Делегированные работники в одном сеансе, которые выполняют побочную задачу в своем собственном контексте и возвращают резюме | Побочная задача заполнит ваш основной разговор результатами поиска, логами или содержимым файлов, на которые вы больше не будете ссылаться |13| [Subagents](https://code.claude.com/docs/ru/sub-agents.md) | Делегированные работники в одном сеансе, которые выполняют побочную задачу в своем собственном контексте и возвращают резюме | Побочная задача заполнит ваш основной разговор результатами поиска, логами или содержимым файлов, на которые вы больше не будете ссылаться |

14| [Agent view](https://code.claude.com/docs/ru/agent-view.md) | Один экран для отправки и мониторинга сеансов, работающих в фоновом режиме, открывается с помощью `claude agents`. Предварительный просмотр исследования | У вас есть несколько независимых задач, и вы хотите их передать, проверить статус с первого взгляда и вмешаться только когда один из них нуждается в вас |14| [Agent view](https://code.claude.com/docs/ru/agent-view.md) | Один экран для отправки и мониторинга сеансов, работающих в фоновом режиме, открывается с помощью `claude agents`. Предварительный просмотр исследования | У вас есть несколько независимых задач, и вы хотите их передать, проверить статус с первого взгляда и вмешаться только когда один из них нуждается в вас |

15| [Agent teams](https://code.claude.com/docs/ru/agent-teams.md) | Несколько координируемых сеансов с общим списком задач и обменом сообщениями между агентами, управляемые лидером. Экспериментальная функция и отключена по умолчанию | Вы хотите, чтобы Claude разделил проект на части, назначил их и держал работников в синхронизации |15| [Agent teams](https://code.claude.com/docs/ru/agent-teams.md) | Несколько координируемых сеансов с общим списком задач и обменом сообщениями между агентами, управляемые лидером. Экспериментальная функция и отключена по умолчанию | Вы хотите, чтобы Claude разделил проект на части, назначил их и держал работников в синхронизации |

16| [Projects](https://code.claude.com/docs/ru/claude-projects.md) | Один текущий разговор на claude.ai/code или в приложении для рабочего стола. Claude запускает параллельные сеансы, называемые потоками, в облаке или, когда вы попросите, на вашем компьютере через Remote Control, дает каждому инструкции проекта и показывает вам, какие из них нуждаются в вас. Публичная бета на Pro и Max | Работа охватывает множество задач в течение дней или недель, должна продолжаться, когда ваша машина выключена, и вы предпочитаете описать это один раз, чем отправлять и отслеживать каждый сеанс |16| [Projects](https://code.claude.com/docs/ru/claude-projects.md) | Один текущий диалог на claude.ai/code или в приложении для рабочего стола. Claude запускает параллельные сессии, называемые потоками, в облаке или, когда вы попросите, на вашем компьютере через Remote Control. Он дает каждой из них инструкции проекта и показывает вам, какие из них нуждаются в вас. Публичная бета-версия на Pro, Max и Ultra | Работа охватывает множество задач в течение дней или недель, должна продолжаться, когда ваша машина выключена, и вы предпочитаете описать ее один раз, чем отправлять и отслеживать каждую сессию |

17| [Dynamic workflows](https://code.claude.com/docs/ru/workflows.md) | Скрипт, который запускает множество подагентов и проверяет их результаты, для работы, которая слишком велика для координации за один ход или которая требует более одного прохода | Задача слишком велика для нескольких подагентов, или вы хотите, чтобы результаты были проверены друг против друга: аудит всей кодовой базы, миграция 500 файлов, перепроверенное исследование или план, разработанный с нескольких углов |17| [Dynamic workflows](https://code.claude.com/docs/ru/workflows.md) | Скрипт, который запускает множество подагентов и проверяет их результаты, для работы, которая слишком велика для координации за один ход или которая требует более одного прохода | Задача слишком велика для нескольких подагентов, или вы хотите, чтобы результаты были проверены друг против друга: аудит всей кодовой базы, миграция 500 файлов, перепроверенное исследование или план, разработанный с нескольких углов |

18 18 

19В каждом подходе работники — это сеансы Claude. Чтобы задействовать другой инструмент, предоставьте его Claude как [MCP server](https://code.claude.com/docs/ru/mcp.md).19В каждом подходе работники — это сеансы Claude. Чтобы задействовать другой инструмент, предоставьте его Claude как [MCP server](https://code.claude.com/docs/ru/mcp.md).

artifacts.md +4 −4

Details

8 8 

9> [!NOTE]9> [!NOTE]

10>10>

11> Артефакты доступны в планах Pro, Max, Team и Enterprise и требуют сеанса, вошедшего в систему с помощью [`/login`](https://code.claude.com/docs/ru/setup#authenticate). Полный набор требований см. в разделе [Доступность](#availability).11> Артефакты доступны в планах Pro, Max, Ultra, Team и Enterprise и требуют сессии, вошедшей в систему с помощью [`/login`](https://code.claude.com/docs/ru/setup#authenticate). Полный набор требований см. в разделе [Доступность](#availability).

12 12 

13[Артефакт](https://claude.com/features/artifacts) — это живая интерактивная веб-страница, которую Claude Code публикует из вашего сеанса на приватный URL на claude.ai. Вы открываете её в браузере, и она обновляется на месте по мере продолжения сеанса. Поделитесь ею из заголовка страницы, когда захотите, чтобы кто-то ещё её увидел.13[Артефакт](https://claude.com/features/artifacts) — это живая интерактивная веб-страница, которую Claude Code публикует из вашего сеанса на приватный URL на claude.ai. Вы открываете её в браузере, и она обновляется на месте по мере продолжения сеанса. Поделитесь ею из заголовка страницы, когда захотите, чтобы кто-то ещё её увидел.

14 14 

197 197 

198## Получение актуальных данных с помощью коннекторов MCP198## Получение актуальных данных с помощью коннекторов MCP

199 199 

200Артефакт может вызывать [коннекторы MCP](https://code.claude.com/docs/ru/mcp.md#use-mcp-servers-from-claude-ai) каждый раз, когда кто-то его просматривает, поэтому страница отображает текущие данные, а не снимок из сеанса, в котором она была создана. Вызовы коннекторов из артефактов доступны в планах Pro, Max, Team и Enterprise и требуют Claude Code версии 2.1.209 или более поздней. В более ранних версиях Claude публикует страницу с теми данными, которые сеанс собрал во время её создания.200Артефакт может вызывать [коннекторы MCP](https://code.claude.com/docs/ru/mcp.md#use-mcp-servers-from-claude-ai) каждый раз, когда кто-то его просматривает, поэтому страница отображает текущие данные, а не снимок из сессии, в которой она была создана. Вызовы коннекторов из артефактов доступны в планах Pro, Max, Ultra, Team и Enterprise и требуют Claude Code версии 2.1.209 или более поздней. В более ранних версиях Claude публикует страницу с теми данными, которые сессия собрала во время её создания.

201 201 

202Чтобы создать страницу с поддержкой коннектора, назовите коннектор и данные, которые вам нужны, в вашем запросе:202Чтобы создать страницу с поддержкой коннектора, назовите коннектор и данные, которые вам нужны, в вашем запросе:

203 203 

314 314 

315> [!NOTE]315> [!NOTE]

316>316>

317> Шаблоны находятся в бета-версии. Они включены по умолчанию в планах Pro, Max и Team. В планах Enterprise владелец [включает каждый шаблон](https://support.claude.com/en/articles/16994751-artifacts-admin-guide-for-team-and-enterprise-plans) в разделе **Organization settings > Artifacts**. Если в вашей организации шаблон Slides отключен, `/slides` не отображается; если шаблон Design отключен, `/design` не создает дизайны. Обе команды требуют Claude Code версии 2.1.265 или более поздней и сеанса, где [артефакты доступны](#availability).317> Шаблоны находятся в бета-версии. Они включены по умолчанию в планах Pro, Max, Ultra и Team. В планах Enterprise владелец [включает каждый шаблон](https://support.claude.com/en/articles/16994751-artifacts-admin-guide-for-team-and-enterprise-plans) в разделе **Organization settings > Artifacts**. Если в вашей организации шаблон Slides отключен, `/slides` не отображается; если шаблон Design отключен, `/design` не создает дизайны. Обе команды требуют Claude Code версии 2.1.265 или более поздней и сессии, где [артефакты доступны](#availability).

318 318 

319### Создайте слайд-шоу319### Создайте слайд-шоу

320 320 

368 368 

369| Requirement | Available when |369| Requirement | Available when |

370| :- | :- |370| :- | :- |

371| Plan | Pro, Max, Team или Enterprise. На планах Pro и Max артефакты являются приватными для вас до тех пор, пока вы их не поделитесь, и управление администратором не применяется. На планах Team и Enterprise артефакты включены по умолчанию, и владелец может [отключить их для организации](#manage-artifacts-for-your-organization) в параметрах администратора claude.ai. |371| Plan | Pro, Max, Ultra, Team или Enterprise. На планах Pro, Max и Ultra артефакты являются приватными для вас до тех пор, пока вы ими не поделитесь, и управление администратором не применяется. На планах Team и Enterprise артефакты включены по умолчанию, и Owner может [отключить их для организации](#manage-artifacts-for-your-organization) в настройках администратора claude.ai. |

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

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

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

authentication.md +21 −21

Details

23 23 

24Вы можете пройти аутентификацию с любым из следующих типов учётных записей:24Вы можете пройти аутентификацию с любым из следующих типов учётных записей:

25 25 

26* **Подписка Claude Pro или Max**: войдите с помощью своей учётной записи claude.ai. Оформить подписку можно на [claude.com/pricing](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_pro_max).26* **Подписка Claude Pro, Max или Ultra**: войдите с помощью своей учётной записи claude.ai. Оформить подписку можно на [claude.com/pricing](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_pro_max).

27* **Claude for Teams или Enterprise**: войдите с помощью учётной записи claude.ai, на которую вас пригласил администратор вашей команды.27* **Claude for Teams или Enterprise**: войдите с помощью учётной записи claude.ai, на которую вас пригласил администратор вашей команды.

28* **Claude Console**: войдите с помощью своих учётных данных Console. Сначала администратор должен [пригласить вас](#claude-console-authentication). Вы можете войти как с [созданием API-ключа](#sign-in-without-an-api-key), так и без него.28* **Claude Console**: войдите с помощью своих учётных данных Console. Сначала администратор должен [пригласить вас](#claude-console-authentication). Вы можете войти как с [созданием API-ключа](#sign-in-without-an-api-key), так и без него.

29* **Облачные провайдеры**: если ваша организация использует [Amazon Bedrock](https://code.claude.com/docs/ru/amazon-bedrock.md), [Google Cloud's Agent Platform](https://code.claude.com/docs/ru/google-vertex-ai.md) или [Microsoft Foundry](https://code.claude.com/docs/ru/microsoft-foundry.md), задайте необходимые переменные окружения перед запуском `claude` или выберите **3rd-party platform** в запросе на вход — это запустит интерактивный мастер настройки для Bedrock и Vertex AI. Вход через браузер не требуется.29* **Облачные провайдеры**: если ваша организация использует [Amazon Bedrock](https://code.claude.com/docs/ru/amazon-bedrock.md), [Google Cloud's Agent Platform](https://code.claude.com/docs/ru/google-vertex-ai.md) или [Microsoft Foundry](https://code.claude.com/docs/ru/microsoft-foundry.md), задайте необходимые переменные окружения перед запуском `claude` или выберите **3rd-party platform** в запросе на вход — это запустит интерактивный мастер настройки для Bedrock и Vertex AI. Вход через браузер не требуется.

2534. Выход скрипта [`apiKeyHelper`](https://code.claude.com/docs/ru/settings-reference#apikeyhelper). Используйте это для динамических или ротирующихся учетных данных, таких как краткосрочные токены, полученные из хранилища.2534. Выход скрипта [`apiKeyHelper`](https://code.claude.com/docs/ru/settings-reference#apikeyhelper). Используйте это для динамических или ротирующихся учетных данных, таких как краткосрочные токены, полученные из хранилища.

2545. Переменная окружения `CLAUDE_CODE_OAUTH_TOKEN`. Долгоживущий токен OAuth, созданный [`claude setup-token`](#generate-a-long-lived-token). Используйте это для конвейеров CI и скриптов, где вход через браузер недоступен. Если вы запустите `/login` при установленной переменной, Claude Code переключит текущий сеанс на новый вход, но будет читать переменную снова в каждом новом сеансе, пока вы не удалите ее из профиля оболочки или блока `env` [файла параметров](https://code.claude.com/docs/ru/settings.md).2545. Переменная окружения `CLAUDE_CODE_OAUTH_TOKEN`. Долгоживущий токен OAuth, созданный [`claude setup-token`](#generate-a-long-lived-token). Используйте это для конвейеров CI и скриптов, где вход через браузер недоступен. Если вы запустите `/login` при установленной переменной, Claude Code переключит текущий сеанс на новый вход, но будет читать переменную снова в каждом новом сеансе, пока вы не удалите ее из профиля оболочки или блока `env` [файла параметров](https://code.claude.com/docs/ru/settings.md).

2556. Учетные данные профиля Anthropic и федерации, учетные данные, которые используют CLI `ant` и Workload Identity Federation. Профиль, который написал `ant auth login`, ранжируется здесь только когда вы называете его в `ANTHROPIC_PROFILE`; в противном случае он ранжируется ниже `/login`. Смотрите [Профили Anthropic и учетные данные федерации](#anthropic-profiles-and-federation-credentials).2556. Учетные данные профиля Anthropic и федерации, учетные данные, которые используют CLI `ant` и Workload Identity Federation. Профиль, который написал `ant auth login`, ранжируется здесь только когда вы называете его в `ANTHROPIC_PROFILE`; в противном случае он ранжируется ниже `/login`. Смотрите [Профили Anthropic и учетные данные федерации](#anthropic-profiles-and-federation-credentials).

2567. Учетные данные OAuth подписки из `/login`. Это значение по умолчанию для пользователей Claude Pro, Max, Team и Enterprise.2567. Учётные данные OAuth подписки из `/login`. Это значение по умолчанию для пользователей Claude Pro, Max, Ultra, Team и Enterprise.

257 257 

258Подписанный сеанс [Claude apps gateway](https://code.claude.com/docs/ru/claude-apps-gateway) находится вне этого списка: это выбор провайдера, как Amazon Bedrock или Google Cloud's Agent Platform, и он имеет приоритет над ними. Когда существует сеанс шлюза, CLI аутентифицируется с помощью токена шлюза, даже если установлены `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` или `CLAUDE_CODE_USE_FOUNDRY`, и источники учетных данных выше, такие как токен-носитель, ключ API, `apiKeyHelper` и профили, не используются.258Подписанный сеанс [Claude apps gateway](https://code.claude.com/docs/ru/claude-apps-gateway) находится вне этого списка: это выбор провайдера, как Amazon Bedrock или Google Cloud's Agent Platform, и он имеет приоритет над ними. Когда существует сеанс шлюза, CLI аутентифицируется с помощью токена шлюза, даже если установлены `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` или `CLAUDE_CODE_USE_FOUNDRY`, и источники учетных данных выше, такие как токен-носитель, ключ API, `apiKeyHelper` и профили, не используются.

259 259 

300 300 

301Команда открывает тот же поток авторизации браузера, что и `/login`, и токен выводится в терминал после того, как вы одобрите доступ в браузере. Она не сохраняет токен нигде; скопируйте его и установите его как переменную окружения `CLAUDE_CODE_OAUTH_TOKEN` везде, где вы хотите аутентифицироваться:301Команда открывает тот же поток авторизации браузера, что и `/login`, и токен выводится в терминал после того, как вы одобрите доступ в браузере. Она не сохраняет токен нигде; скопируйте его и установите его как переменную окружения `CLAUDE_CODE_OAUTH_TOKEN` везде, где вы хотите аутентифицироваться:

302 302 

303**macOS, Linux, WSL**303> [tab] macOS, Linux, WSL

304 304>

305```bash theme={null}305> ```bash theme={null}

306export CLAUDE_CODE_OAUTH_TOKEN=your-token306> export CLAUDE_CODE_OAUTH_TOKEN=your-token

307```307> ```

308 308 

309**Windows PowerShell**309> [tab] Windows PowerShell

310 310>

311```powershell theme={null}311> ```powershell theme={null}

312$env:CLAUDE_CODE_OAUTH_TOKEN = "your-token"312> $env:CLAUDE_CODE_OAUTH_TOKEN = "your-token"

313```313> ```

314 314 

315**Windows CMD**315> [tab] Windows CMD

316 316>

317```batch theme={null}317> ```batch theme={null}

318set CLAUDE_CODE_OAUTH_TOKEN=your-token318> set CLAUDE_CODE_OAUTH_TOKEN=your-token

319```319> ```

320 320 

321Этот токен аутентифицируется с помощью вашей подписки Claude и требует план Pro, Max, Team или Enterprise. Он может только выполнять запросы модели, поэтому он не может устанавливать сеансы [Remote Control](https://code.claude.com/docs/ru/remote-control.md) или получать [соединители claude.ai](https://code.claude.com/docs/ru/mcp.md#use-mcp-servers-from-claude-ai). Серверы MCP, которые вы настраиваете локально, все еще работают.321Этот токен аутентифицируется с помощью вашей подписки Claude и требует тариф Pro, Max, Ultra, Team или Enterprise. Он может только выполнять запросы к модели, поэтому не может устанавливать сессии [Remote Control](https://code.claude.com/docs/ru/remote-control.md) или получать [коннекторы claude.ai](https://code.claude.com/docs/ru/mcp.md#use-mcp-servers-from-claude-ai). MCP-серверы, которые вы настраиваете локально, по-прежнему работают.

322 322 

323[Bare mode](https://code.claude.com/docs/ru/headless.md#start-faster-with-bare-mode) не читает `CLAUDE_CODE_OAUTH_TOKEN`. Если ваш скрипт передает `--bare`, аутентифицируйтесь с помощью `ANTHROPIC_API_KEY` или `apiKeyHelper` вместо этого.323[Bare mode](https://code.claude.com/docs/ru/headless.md#start-faster-with-bare-mode) не читает `CLAUDE_CODE_OAUTH_TOKEN`. Если ваш скрипт передает `--bare`, аутентифицируйтесь с помощью `ANTHROPIC_API_KEY` или `apiKeyHelper` вместо этого.

Details

43 43 

44## Почему появляется уведомление44## Почему появляется уведомление

45 45 

46[Проверка классификатора на стороне сервера](https://code.claude.com/docs/ru/permission-modes.md#server-side-classifier-review) указывает, какие сеансы запрашивают у сервера проверки классификатора. Планы Pro, Max и Team никогда не показывают уведомление. Когда оно появляется, обычные причины следующие:46На планах Pro, Max, Ultra или Team вы никогда не увидите это уведомление. Чтобы узнать, какие сессии запрашивают у сервера проверки классификатора, см. [Проверка классификатора на стороне сервера](https://code.claude.com/docs/ru/permission-modes.md#server-side-classifier-review). Если вы видите уведомление, проверьте следующие распространённые причины:

47 47 

48* **На пути находится шлюз LLM или прокси**: тот, который удаляет или переписывает заголовки запроса, отбрасывает поля запроса, которые он не распознает, или редактирует ответы. Затем сервер никогда не получает запрос на проверки, или Claude Code никогда не получает результаты. Когда ваша конфигурация или ответы идентифицируют шлюз, уведомление его называет.48* **На пути находится шлюз LLM или прокси**: тот, который удаляет или переписывает заголовки запроса, отбрасывает поля запроса, которые он не распознает, или редактирует ответы. Затем сервер никогда не получает запрос на проверки, или Claude Code никогда не получает результаты. Когда ваша конфигурация или ответы идентифицируют шлюз, уведомление его называет.

49* **Проверки на стороне сервера еще не достигли вашей платформы, региона или учетных данных**: то, выполняет ли платформа или регион их, зависит от развертывания этой платформы. Если вы видите уведомление без шлюза или прокси на пути и оно продолжает появляться, это вероятная причина. Чтобы подтвердить, обратитесь в службу поддержки или администратора вашей компании, или сообщите об этом с помощью `/feedback`.49* **Проверки на стороне сервера еще не достигли вашей платформы, региона или учетных данных**: то, выполняет ли платформа или регион их, зависит от развертывания этой платформы. Если вы видите уведомление без шлюза или прокси на пути и оно продолжает появляться, это вероятная причина. Чтобы подтвердить, обратитесь в службу поддержки или администратора вашей компании, или сообщите об этом с помощью `/feedback`.

Details

161 161 

162> [!NOTE]162> [!NOTE]

163>163>

164> `/auto-mode-setup` доступна в планах Pro, Max, Team и Enterprise, а также с API-ключом Claude Console. В плане Pro, Max или Team требуется версия 2.1.228 или новее, а на нативной Windows — версия 2.1.233 или новее. В плане Enterprise или с API-ключом Claude Console требуется версия 2.1.283 или новее. Если команда отсутствует в вашей сессии, см. [`/auto-mode-setup` возвращает "Unknown command"](#auto-mode-setup-returns-unknown-command).164> `/auto-mode-setup` доступна в планах Pro, Max, Ultra, Team и Enterprise, а также с API-ключом Claude Console. В плане Pro, Max, Ultra или Team требуется версия 2.1.228 или новее, а на нативной Windows — версия 2.1.233 или новее. В плане Enterprise или с API-ключом Claude Console требуется версия 2.1.283 или новее. Если команда отсутствует в вашей сессии, см. [`/auto-mode-setup` возвращает "Unknown command"](#auto-mode-setup-returns-unknown-command).

165 165 

166### Что читает `/auto-mode-setup`166### Что читает `/auto-mode-setup`

167 167 

Details

489 489 

490При окне в 1M токенов у большинства современных моделей и сжатии вблизи его верхней границы контекст у вас будет заканчиваться редко. Но вы всё равно можете *платить* за контекст, который вам не нужен. Каждый запрос отправляет весь диалог, поэтому сессия, в которой накопились три несвязанные задачи, перечитывает все три на каждом ходу четвёртой. Это [стоит дешевле, пока кэш тёплый](https://code.claude.com/docs/ru/costs.md#why-usage-climbs-in-a-long-session), и по полной цене после его истечения.490При окне в 1M токенов у большинства современных моделей и сжатии вблизи его верхней границы контекст у вас будет заканчиваться редко. Но вы всё равно можете *платить* за контекст, который вам не нужен. Каждый запрос отправляет весь диалог, поэтому сессия, в которой накопились три несвязанные задачи, перечитывает все три на каждом ходу четвёртой. Это [стоит дешевле, пока кэш тёплый](https://code.claude.com/docs/ru/costs.md#why-usage-climbs-in-a-long-session), и по полной цене после его истечения.

491 491 

492[`/usage`](https://code.claude.com/docs/ru/costs) — первое место, куда стоит заглянуть. На Pro, Max, Team и Enterprise он разбивает ваше использование по скиллам, субагентам, плагинам и MCP-серверам. Он также помечает такие паттерны, как длинный контекст или частые промахи кэша, когда один из них превышает 10% вашего использования. Дальше — обычные способы исправления:492[`/usage`](https://code.claude.com/docs/ru/costs) — первое место, куда стоит заглянуть. На Pro, Max, Ultra, Team и Enterprise он разбивает ваше использование по скиллам, субагентам, плагинам и MCP-серверам. Он также помечает такие паттерны, как длинный контекст или частые промахи кэша, когда один из них превышает 10% вашего использования. Дальше — обычные способы исправления:

493 493 

494* `/clear` между несвязанными задачами. Это ничего не стоит и означает, что следующая задача не продолжает платить за историю предыдущей. `/clear oauth-migration` даёт имя сессии, которую вы покидаете, чтобы позже к ней можно было вернуться.494* `/clear` между несвязанными задачами. Это ничего не стоит и означает, что следующая задача не продолжает платить за историю предыдущей. `/clear oauth-migration` даёт имя сессии, которую вы покидаете, чтобы позже к ней можно было вернуться.

495* `/compact` с фокусом, например `/compact keep the API changes and the test commands`. В длинной сессии `/compact` сам по себе является большим запросом, поскольку читает весь диалог, чтобы его обобщить, и тем более после истечения кэша.495* `/compact` с фокусом, например `/compact keep the API changes and the test commands`. В длинной сессии `/compact` сам по себе является большим запросом, поскольку читает весь диалог, чтобы его обобщить, и тем более после истечения кэша.

channels.md +189 −189

Details

24 24 

25Каждый поддерживаемый канал — это плагин, который требует [Bun](https://bun.sh). Для практической демонстрации потока плагинов перед подключением реальной платформы попробуйте [быстрый старт fakechat](#quickstart).25Каждый поддерживаемый канал — это плагин, который требует [Bun](https://bun.sh). Для практической демонстрации потока плагинов перед подключением реальной платформы попробуйте [быстрый старт fakechat](#quickstart).

26 26 

27**Telegram**27> [tab] Telegram

28 

29Просмотрите полный [исходный код плагина Telegram](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/telegram).

30 

31**1. Создайте бота Telegram**

32 

33Откройте [BotFather](https://t.me/BotFather) в Telegram и отправьте `/newbot`. Дайте ему отображаемое имя и уникальное имя пользователя, заканчивающееся на `bot`. Скопируйте токен, который возвращает BotFather.

34 

35**2. Установите плагин**

36 

37Запустите Claude Code, выполнив `claude` в терминале, затем введите в его промпте:

38 

39```

40/plugin install telegram@claude-plugins-official

41```

42 

43Если установка не удалась, сопоставьте сообщение, которое сообщает Claude Code:

44 

45* `Marketplace "claude-plugins-official" not found`: добавьте маркетплейс с помощью `/plugin marketplace add anthropics/claude-plugins-official`, затем повторите попытку установки.

46* `Plugin "<name>" not found in marketplace "claude-plugins-official"`: ваша локальная копия каталога маркетплейса может быть устаревшей. Обновите её с помощью `/plugin marketplace update claude-plugins-official`, затем повторите попытку установки. Если повторная попытка выводит то же сообщение, см. [Плагин не найден в маркетплейсе](https://code.claude.com/docs/ru/plugins/troubleshooting.md#plugin-not-found-in-marketplace).

47 

48Когда установка запрашивает область действия установки, выберите опцию области действия пользователя, чтобы плагин был доступен во всех ваших проектах. Проверьте сводку установки: если она сообщает `Run /reload-plugins to apply.`, см. [Применение изменений плагина без перезагрузки](https://code.claude.com/docs/ru/plugins/cli-reference.md#reload-plugins), чтобы сделать команду настройки плагина доступной.

49 

50**3. Настройте ваш токен**

51 

52Выполните команду настройки с токеном от BotFather:

53 

54```

55/telegram:configure <token>

56```

57 

58Это сохранит его в `~/.claude/channels/telegram/.env`. Вы также можете установить `TELEGRAM_BOT_TOKEN` в переменной окружения вашей оболочки перед запуском Claude Code.

59 

60**4. Перезагрузитесь с включенными каналами**

61 

62Выйдите из Claude Code и перезагрузитесь с флагом канала. Это запустит плагин Telegram, который начнет опрашивать сообщения от вашего бота:

63 

64```bash theme={null}

65claude --channels plugin:telegram@claude-plugins-official

66```

67 

68**5. Выполните сопряжение вашей учетной записи**

69 

70Откройте Telegram и отправьте любое сообщение вашему боту. Бот ответит кодом сопряжения.

71 

72> [!NOTE]

73>28>

74> Если ваш бот не отвечает, убедитесь, что Claude Code работает с `--channels` из предыдущего шага. Бот может отвечать только пока канал активен.29> Просмотрите полный [исходный код плагина Telegram](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/telegram).

75 

76Вернитесь в Claude Code и выполните:

77 

78```

79/telegram:access pair <code>

80```

81 

82Затем заблокируйте доступ, чтобы только ваша учетная запись могла отправлять сообщения:

83 

84```

85/telegram:access policy allowlist

86```

87 

88**Discord**

89 

90Просмотрите полный [исходный код плагина Discord](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/discord).

91 

92**1. Создайте бота Discord**

93 

94Перейдите на [Discord Developer Portal](https://discord.com/developers/applications), нажмите **New Application** и назовите его. В разделе **Bot** создайте имя пользователя, затем нажмите **Reset Token** и скопируйте токен.

95 

96**2. Включите Message Content Intent**

97 

98В настройках вашего бота прокрутите до **Privileged Gateway Intents** и включите **Message Content Intent**.

99 

100**3. Пригласите бота на ваш сервер**

101 

102Перейдите в **OAuth2 > URL Generator**. Выберите область `bot` и включите эти разрешения:

103 

104* View Channels

105* Send Messages

106* Send Messages in Threads

107* Read Message History

108* Attach Files

109* Add Reactions

110 

111Откройте созданный URL для добавления бота на ваш сервер.

112 

113**4. Установите плагин**

114 

115Запустите Claude Code, выполнив `claude` в терминале, затем введите в его промпте:

116 

117```

118/plugin install discord@claude-plugins-official

119```

120 

121Если установка не удалась, сопоставьте сообщение, которое сообщает Claude Code:

122 

123* `Marketplace "claude-plugins-official" not found`: добавьте маркетплейс с помощью `/plugin marketplace add anthropics/claude-plugins-official`, затем повторите попытку установки.

124* `Plugin "<name>" not found in marketplace "claude-plugins-official"`: ваша локальная копия каталога маркетплейса может быть устаревшей. Обновите её с помощью `/plugin marketplace update claude-plugins-official`, затем повторите попытку установки. Если повторная попытка выводит то же сообщение, см. [Плагин не найден в маркетплейсе](https://code.claude.com/docs/ru/plugins/troubleshooting.md#plugin-not-found-in-marketplace).

125 

126Когда установка запрашивает область действия установки, выберите опцию области действия пользователя, чтобы плагин был доступен во всех ваших проектах. Проверьте сводку установки: если она сообщает `Run /reload-plugins to apply.`, см. [Применение изменений плагина без перезагрузки](https://code.claude.com/docs/ru/plugins/cli-reference.md#reload-plugins), чтобы сделать команду настройки плагина доступной.

127 

128**5. Настройте ваш токен**

129 

130Выполните команду настройки с токеном бота, который вы скопировали:

131 

132```

133/discord:configure <token>

134```

135 

136Это сохранит его в `~/.claude/channels/discord/.env`. Вы также можете установить `DISCORD_BOT_TOKEN` в переменной окружения вашей оболочки перед запуском Claude Code.

137 

138**6. Перезагрузитесь с включенными каналами**

139 

140Выйдите из Claude Code и перезагрузитесь с флагом канала. Это подключит плагин Discord, чтобы ваш бот мог получать и отвечать на сообщения:

141 

142```bash theme={null}

143claude --channels plugin:discord@claude-plugins-official

144```

145 

146**7. Выполните сопряжение вашей учетной записи**

147 

148Отправьте личное сообщение вашему боту в Discord. Бот ответит кодом сопряжения.

149 

150> [!NOTE]

151>30>

152> Если ваш бот не отвечает, убедитесь, что Claude Code работает с `--channels` из предыдущего шага. Бот может отвечать только пока канал активен.31> **1. Создайте бота Telegram**

153 

154Вернитесь в Claude Code и выполните:

155 

156```

157/discord:access pair <code>

158```

159 

160Затем заблокируйте доступ, чтобы только ваша учетная запись могла отправлять сообщения:

161 

162```

163/discord:access policy allowlist

164```

165 

166**iMessage**

167 

168Просмотрите полный [исходный код плагина iMessage](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/imessage).

169 

170Канал iMessage читает вашу базу данных Messages напрямую и отправляет ответы через AppleScript. Он требует macOS и не требует токена бота или внешнего сервиса.

171 

172**1. Предоставьте полный доступ к диску**

173 

174База данных Messages в `~/Library/Messages/chat.db` защищена macOS. При первом чтении сервером macOS запрашивает доступ: нажмите **Allow**. Запрос указывает приложение, которое запустило Bun, например Terminal, iTerm или вашу IDE.

175 

176Если запрос не появляется или вы нажали Don't Allow, предоставьте доступ вручную в **System Settings > Privacy & Security > Full Disk Access** и добавьте ваш терминал. Без этого сервер немедленно завершит работу с ошибкой `authorization denied`.

177 

178**2. Установите плагин**

179 

180Запустите Claude Code, выполнив `claude` в терминале, затем введите в его промпте:

181 

182```

183/plugin install imessage@claude-plugins-official

184```

185 

186Если установка не удалась, сопоставьте сообщение, которое сообщает Claude Code:

187 

188* `Marketplace "claude-plugins-official" not found`: добавьте маркетплейс с помощью `/plugin marketplace add anthropics/claude-plugins-official`, затем повторите попытку установки.

189* `Plugin "<name>" not found in marketplace "claude-plugins-official"`: ваша локальная копия каталога маркетплейса может быть устаревшей. Обновите её с помощью `/plugin marketplace update claude-plugins-official`, затем повторите попытку установки. Если повторная попытка выводит то же сообщение, см. [Плагин не найден в маркетплейсе](https://code.claude.com/docs/ru/plugins/troubleshooting.md#plugin-not-found-in-marketplace).

190 

191Когда установка запрашивает область установки, выберите опцию области пользователя, чтобы плагин был доступен во всех ваших проектах.

192 

193Если сводка установки сообщает `Run /reload-plugins to apply.`, здесь ничего делать не нужно, потому что перезагрузка на следующем шаге подхватит плагин.

194 

195**3. Перезагрузитесь с включенными каналами**

196 

197Выйдите из Claude Code и перезагрузитесь с флагом канала:

198 

199```bash theme={null}

200claude --channels plugin:imessage@claude-plugins-official

201```

202 

203**4. Напишите себе**

204 

205Откройте Messages на любом устройстве, вошедшем в вашу Apple ID, и отправьте сообщение себе. Оно сразу же достигает Claude: самочат обходит контроль доступа без настройки.

206 

207> [!NOTE]

208>32>

209> Первый ответ, который отправляет Claude, вызывает запрос macOS Automation, спрашивающий, может ли ваш терминал управлять Messages. Нажмите **OK**.33> Откройте [BotFather](https://t.me/BotFather) в Telegram и отправьте `/newbot`. Дайте ему отображаемое имя и уникальное имя пользователя, заканчивающееся на `bot`. Скопируйте токен, который возвращает BotFather.

210 34>

211**5. Разрешите другим отправителям**35> **2. Установите плагин**

212 36>

213По умолчанию проходят только ваши собственные сообщения. Чтобы позволить другому контакту достичь Claude, добавьте его дескриптор:37> Запустите Claude Code, выполнив `claude` в терминале, затем введите в его промпте:

38>

39> ```

40> /plugin install telegram@claude-plugins-official

41> ```

42>

43> Если установка не удалась, сопоставьте сообщение, которое сообщает Claude Code:

44>

45> * `Marketplace "claude-plugins-official" not found`: добавьте маркетплейс с помощью `/plugin marketplace add anthropics/claude-plugins-official`, затем повторите попытку установки.

46> * `Plugin "<name>" not found in marketplace "claude-plugins-official"`: ваша локальная копия каталога маркетплейса может быть устаревшей. Обновите её с помощью `/plugin marketplace update claude-plugins-official`, затем повторите попытку установки. Если повторная попытка выводит то же сообщение, см. [Плагин не найден в маркетплейсе](https://code.claude.com/docs/ru/plugins/troubleshooting.md#plugin-not-found-in-marketplace).

47>

48> Когда установка запрашивает область действия установки, выберите опцию области действия пользователя, чтобы плагин был доступен во всех ваших проектах. Проверьте сводку установки: если она сообщает `Run /reload-plugins to apply.`, см. [Применение изменений плагина без перезагрузки](https://code.claude.com/docs/ru/plugins/cli-reference.md#reload-plugins), чтобы сделать команду настройки плагина доступной.

49>

50> **3. Настройте ваш токен**

51>

52> Выполните команду настройки с токеном от BotFather:

53>

54> ```

55> /telegram:configure <token>

56> ```

57>

58> Это сохранит его в `~/.claude/channels/telegram/.env`. Вы также можете установить `TELEGRAM_BOT_TOKEN` в переменной окружения вашей оболочки перед запуском Claude Code.

59>

60> **4. Перезагрузитесь с включенными каналами**

61>

62> Выйдите из Claude Code и перезагрузитесь с флагом канала. Это запустит плагин Telegram, который начнет опрашивать сообщения от вашего бота:

63>

64> ```bash theme={null}

65> claude --channels plugin:telegram@claude-plugins-official

66> ```

67>

68> **5. Выполните сопряжение вашей учетной записи**

69>

70> Откройте Telegram и отправьте любое сообщение вашему боту. Бот ответит кодом сопряжения.

71>

72> > [!NOTE]

73> >

74> > Если ваш бот не отвечает, убедитесь, что Claude Code работает с `--channels` из предыдущего шага. Бот может отвечать только пока канал активен.

75>

76> Вернитесь в Claude Code и выполните:

77>

78> ```

79> /telegram:access pair <code>

80> ```

81>

82> Затем заблокируйте доступ, чтобы только ваша учетная запись могла отправлять сообщения:

83>

84> ```

85> /telegram:access policy allowlist

86> ```

214 87 

215```88> [tab] Discord

216/imessage:access allow +1555123456789>

217```90> Просмотрите полный [исходный код плагина Discord](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/discord).

91>

92> **1. Создайте бота Discord**

93>

94> Перейдите на [Discord Developer Portal](https://discord.com/developers/applications), нажмите **New Application** и назовите его. В разделе **Bot** создайте имя пользователя, затем нажмите **Reset Token** и скопируйте токен.

95>

96> **2. Включите Message Content Intent**

97>

98> В настройках вашего бота прокрутите до **Privileged Gateway Intents** и включите **Message Content Intent**.

99>

100> **3. Пригласите бота на ваш сервер**

101>

102> Перейдите в **OAuth2 > URL Generator**. Выберите область `bot` и включите эти разрешения:

103>

104> * View Channels

105> * Send Messages

106> * Send Messages in Threads

107> * Read Message History

108> * Attach Files

109> * Add Reactions

110>

111> Откройте созданный URL для добавления бота на ваш сервер.

112>

113> **4. Установите плагин**

114>

115> Запустите Claude Code, выполнив `claude` в терминале, затем введите в его промпте:

116>

117> ```

118> /plugin install discord@claude-plugins-official

119> ```

120>

121> Если установка не удалась, сопоставьте сообщение, которое сообщает Claude Code:

122>

123> * `Marketplace "claude-plugins-official" not found`: добавьте маркетплейс с помощью `/plugin marketplace add anthropics/claude-plugins-official`, затем повторите попытку установки.

124> * `Plugin "<name>" not found in marketplace "claude-plugins-official"`: ваша локальная копия каталога маркетплейса может быть устаревшей. Обновите её с помощью `/plugin marketplace update claude-plugins-official`, затем повторите попытку установки. Если повторная попытка выводит то же сообщение, см. [Плагин не найден в маркетплейсе](https://code.claude.com/docs/ru/plugins/troubleshooting.md#plugin-not-found-in-marketplace).

125>

126> Когда установка запрашивает область действия установки, выберите опцию области действия пользователя, чтобы плагин был доступен во всех ваших проектах. Проверьте сводку установки: если она сообщает `Run /reload-plugins to apply.`, см. [Применение изменений плагина без перезагрузки](https://code.claude.com/docs/ru/plugins/cli-reference.md#reload-plugins), чтобы сделать команду настройки плагина доступной.

127>

128> **5. Настройте ваш токен**

129>

130> Выполните команду настройки с токеном бота, который вы скопировали:

131>

132> ```

133> /discord:configure <token>

134> ```

135>

136> Это сохранит его в `~/.claude/channels/discord/.env`. Вы также можете установить `DISCORD_BOT_TOKEN` в переменной окружения вашей оболочки перед запуском Claude Code.

137>

138> **6. Перезагрузитесь с включенными каналами**

139>

140> Выйдите из Claude Code и перезагрузитесь с флагом канала. Это подключит плагин Discord, чтобы ваш бот мог получать и отвечать на сообщения:

141>

142> ```bash theme={null}

143> claude --channels plugin:discord@claude-plugins-official

144> ```

145>

146> **7. Выполните сопряжение вашей учетной записи**

147>

148> Отправьте личное сообщение вашему боту в Discord. Бот ответит кодом сопряжения.

149>

150> > [!NOTE]

151> >

152> > Если ваш бот не отвечает, убедитесь, что Claude Code работает с `--channels` из предыдущего шага. Бот может отвечать только пока канал активен.

153>

154> Вернитесь в Claude Code и выполните:

155>

156> ```

157> /discord:access pair <code>

158> ```

159>

160> Затем заблокируйте доступ, чтобы только ваша учетная запись могла отправлять сообщения:

161>

162> ```

163> /discord:access policy allowlist

164> ```

218 165 

219Дескрипторы — это номера телефонов в формате `+country` или адреса электронной почты Apple ID, такие как `user@example.com`.166> [tab] iMessage

167>

168> Просмотрите полный [исходный код плагина iMessage](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/imessage).

169>

170> Канал iMessage читает вашу базу данных Messages напрямую и отправляет ответы через AppleScript. Он требует macOS и не требует токена бота или внешнего сервиса.

171>

172> **1. Предоставьте полный доступ к диску**

173>

174> База данных Messages в `~/Library/Messages/chat.db` защищена macOS. При первом чтении сервером macOS запрашивает доступ: нажмите **Allow**. Запрос указывает приложение, которое запустило Bun, например Terminal, iTerm или вашу IDE.

175>

176> Если запрос не появляется или вы нажали Don't Allow, предоставьте доступ вручную в **System Settings > Privacy & Security > Full Disk Access** и добавьте ваш терминал. Без этого сервер немедленно завершит работу с ошибкой `authorization denied`.

177>

178> **2. Установите плагин**

179>

180> Запустите Claude Code, выполнив `claude` в терминале, затем введите в его промпте:

181>

182> ```

183> /plugin install imessage@claude-plugins-official

184> ```

185>

186> Если установка не удалась, сопоставьте сообщение, которое сообщает Claude Code:

187>

188> * `Marketplace "claude-plugins-official" not found`: добавьте маркетплейс с помощью `/plugin marketplace add anthropics/claude-plugins-official`, затем повторите попытку установки.

189> * `Plugin "<name>" not found in marketplace "claude-plugins-official"`: ваша локальная копия каталога маркетплейса может быть устаревшей. Обновите её с помощью `/plugin marketplace update claude-plugins-official`, затем повторите попытку установки. Если повторная попытка выводит то же сообщение, см. [Плагин не найден в маркетплейсе](https://code.claude.com/docs/ru/plugins/troubleshooting.md#plugin-not-found-in-marketplace).

190>

191> Когда установка запрашивает область установки, выберите опцию области пользователя, чтобы плагин был доступен во всех ваших проектах.

192>

193> Если сводка установки сообщает `Run /reload-plugins to apply.`, здесь ничего делать не нужно, потому что перезагрузка на следующем шаге подхватит плагин.

194>

195> **3. Перезагрузитесь с включенными каналами**

196>

197> Выйдите из Claude Code и перезагрузитесь с флагом канала:

198>

199> ```bash theme={null}

200> claude --channels plugin:imessage@claude-plugins-official

201> ```

202>

203> **4. Напишите себе**

204>

205> Откройте Messages на любом устройстве, вошедшем в вашу Apple ID, и отправьте сообщение себе. Оно сразу же достигает Claude: самочат обходит контроль доступа без настройки.

206>

207> > [!NOTE]

208> >

209> > Первый ответ, который отправляет Claude, вызывает запрос macOS Automation, спрашивающий, может ли ваш терминал управлять Messages. Нажмите **OK**.

210>

211> **5. Разрешите другим отправителям**

212>

213> По умолчанию проходят только ваши собственные сообщения. Чтобы позволить другому контакту достичь Claude, добавьте его дескриптор:

214>

215> ```

216> /imessage:access allow +15551234567

217> ```

218>

219> Дескрипторы — это номера телефонов в формате `+country` или адреса электронной почты Apple ID, такие как `user@example.com`.

220 220 

221## Быстрый старт221## Быстрый старт

222 222 

308| `channelsEnabled` | Главный переключатель. Должен быть `true` для доставки сообщений любым каналом. Блокирует все каналы, включая флаг разработки, когда отключен. См. [Включение каналов для вашей организации](#enable-channels-for-your-organization). | claude.ai Team и Enterprise: каналы заблокированы. Console: каналы разрешены, если ваша организация не развертывает управляемые параметры, в этом случае каналы заблокированы до установки этого ключа |308| `channelsEnabled` | Главный переключатель. Должен быть `true` для доставки сообщений любым каналом. Блокирует все каналы, включая флаг разработки, когда отключен. См. [Включение каналов для вашей организации](#enable-channels-for-your-organization). | claude.ai Team и Enterprise: каналы заблокированы. Console: каналы разрешены, если ваша организация не развертывает управляемые параметры, в этом случае каналы заблокированы до установки этого ключа |

309| `allowedChannelPlugins` | Какие плагины могут регистрироваться после включения каналов. Заменяет список, поддерживаемый Anthropic, когда установлен. | Применяется список по умолчанию Anthropic |309| `allowedChannelPlugins` | Какие плагины могут регистрироваться после включения каналов. Заменяет список, поддерживаемый Anthropic, когда установлен. | Применяется список по умолчанию Anthropic |

310 310 

311Пользователи Pro и Max без организации пропускают эти проверки полностью: каналы доступны и пользователи выбирают участие в каждом сеансе с помощью `--channels`.311Пользователи Pro, Max и Ultra без организации пропускают эти проверки полностью: каналы доступны и пользователи выбирают участие в каждой сессии с помощью `--channels`.

312 312 

313### Включение каналов для вашей организации313### Включение каналов для вашей организации

314 314 

chrome.md +1 −1

Details

39* [Google Chrome](https://www.google.com/chrome/), [Microsoft Edge](https://www.microsoft.com/edge) или другой браузер на основе Chromium, например Brave, Arc, Vivaldi или Opera39* [Google Chrome](https://www.google.com/chrome/), [Microsoft Edge](https://www.microsoft.com/edge) или другой браузер на основе Chromium, например Brave, Arc, Vivaldi или Opera

40* Расширение [Claude in Chrome](https://chromewebstore.google.com/detail/claude/fcoeoabgfenejglbffodgkkbkcdhcgfn) версии 1.0.36 или выше, доступное в Chrome Web Store40* Расширение [Claude in Chrome](https://chromewebstore.google.com/detail/claude/fcoeoabgfenejglbffodgkkbkcdhcgfn) версии 1.0.36 или выше, доступное в Chrome Web Store

41* [Claude Code](https://code.claude.com/docs/ru/quickstart.md#step-1-install-claude-code)41* [Claude Code](https://code.claude.com/docs/ru/quickstart.md#step-1-install-claude-code)

42* Прямой план Anthropic (Pro, Max, Team или Enterprise)42* Прямой план Anthropic (Pro, Max, Ultra, Team или Enterprise)

43 43 

44В организациях Enterprise, где включён HIPAA, Claude in Chrome по умолчанию отключён, и [Owner](https://code.claude.com/docs/ru/server-managed-settings.md#access-control) может включить его в [**Organization settings > Claude in Chrome**](https://claude.ai/admin-settings/browser-extension). Ваше соглашение с деловым партнёром (Business Associate Agreement, BAA) с Anthropic не распространяется на данные, отправляемые на сторонние сайты через Claude in Chrome. Список соответствующих требованиям сервисов (Eligible Services) см. в [руководстве по внедрению](https://trust.anthropic.com/resources?s=l1wrssd9hsbi4gak0tp5a6\&name=%5Banthropic%5D-hipaa-ready-offering-implementation-guide).44В организациях Enterprise, где включён HIPAA, Claude in Chrome по умолчанию отключён, и [Owner](https://code.claude.com/docs/ru/server-managed-settings.md#access-control) может включить его в [**Organization settings > Claude in Chrome**](https://claude.ai/admin-settings/browser-extension). Ваше соглашение с деловым партнёром (Business Associate Agreement, BAA) с Anthropic не распространяется на данные, отправляемые на сторонние сайты через Claude in Chrome. Список соответствующих требованиям сервисов (Eligible Services) см. в [руководстве по внедрению](https://trust.anthropic.com/resources?s=l1wrssd9hsbi4gak0tp5a6\&name=%5Banthropic%5D-hipaa-ready-offering-implementation-guide).

45 45 

Details

325 325 

326**7. Развёртывание**326**7. Развёртывание**

327 327 

328**ECS Fargate**328> [tab] ECS Fargate

329 329>

330Создайте кластер и группу журналов для stderr gateway, которая содержит как события аудита, так и операционные журналы. Удержание — это отдельный вызов, и без него CloudWatch хранит журналы вечно; выровняйте 90 дней с вашей политикой удержания аудита:330> Создайте кластер и группу журналов для stderr gateway, которая содержит как события аудита, так и операционные журналы. Удержание — это отдельный вызов, и без него CloudWatch хранит журналы вечно; выровняйте 90 дней с вашей политикой удержания аудита:

331 331>

332```bash theme={null}332> ```bash theme={null}

333aws ecs create-cluster --cluster-name claude-gateway333> aws ecs create-cluster --cluster-name claude-gateway

334aws logs create-log-group --log-group-name /ecs/claude-gateway334> aws logs create-log-group --log-group-name /ecs/claude-gateway

335aws logs put-retention-policy --log-group-name /ecs/claude-gateway \335> aws logs put-retention-policy --log-group-name /ecs/claude-gateway \

336 --retention-in-days 90336> --retention-in-days 90

337```337> ```

338 338>

339Напишите определение задачи. Роль задачи несёт разрешение Bedrock, а роль выполнения внедряет секреты; используйте ARN секретов из шага Secrets Manager:339> Напишите определение задачи. Роль задачи несёт разрешение Bedrock, а роль выполнения внедряет секреты; используйте ARN секретов из шага Secrets Manager:

340 340>

341```json claude-gateway-task.json theme={null}341> ```json claude-gateway-task.json theme={null}

342{342> {

343 "family": "claude-gateway",343> "family": "claude-gateway",

344 "networkMode": "awsvpc",344> "networkMode": "awsvpc",

345 "requiresCompatibilities": ["FARGATE"],345> "requiresCompatibilities": ["FARGATE"],

346 "cpu": "1024",346> "cpu": "1024",

347 "memory": "2048",347> "memory": "2048",

348 "runtimePlatform": { "cpuArchitecture": "X86_64", "operatingSystemFamily": "LINUX" },348> "runtimePlatform": { "cpuArchitecture": "X86_64", "operatingSystemFamily": "LINUX" },

349 "executionRoleArn": "arn:aws:iam::<account-id>:role/claude-gateway-execution",349> "executionRoleArn": "arn:aws:iam::<account-id>:role/claude-gateway-execution",

350 "taskRoleArn": "arn:aws:iam::<account-id>:role/claude-gateway-task",350> "taskRoleArn": "arn:aws:iam::<account-id>:role/claude-gateway-task",

351 "containerDefinitions": [351> "containerDefinitions": [

352 {352> {

353 "name": "gateway",353> "name": "gateway",

354 "image": "<account-id>.dkr.ecr.<region>.amazonaws.com/claude-gateway:<version>",354> "image": "<account-id>.dkr.ecr.<region>.amazonaws.com/claude-gateway:<version>",

355 "portMappings": [{ "containerPort": 8080 }],355> "portMappings": [{ "containerPort": 8080 }],

356 "secrets": [356> "secrets": [

357 { "name": "GATEWAY_JWT_SECRET", "valueFrom": "<gateway-jwt-secret ARN>" },357> { "name": "GATEWAY_JWT_SECRET", "valueFrom": "<gateway-jwt-secret ARN>" },

358 { "name": "OIDC_CLIENT_SECRET", "valueFrom": "<gateway-oidc-client-secret ARN>" },358> { "name": "OIDC_CLIENT_SECRET", "valueFrom": "<gateway-oidc-client-secret ARN>" },

359 { "name": "GATEWAY_POSTGRES_URL", "valueFrom": "<gateway-postgres-url ARN>" }359> { "name": "GATEWAY_POSTGRES_URL", "valueFrom": "<gateway-postgres-url ARN>" }

360 ],360> ],

361 "logConfiguration": {361> "logConfiguration": {

362 "logDriver": "awslogs",362> "logDriver": "awslogs",

363 "options": {363> "options": {

364 "awslogs-group": "/ecs/claude-gateway",364> "awslogs-group": "/ecs/claude-gateway",

365 "awslogs-region": "<region>",365> "awslogs-region": "<region>",

366 "awslogs-stream-prefix": "gateway"366> "awslogs-stream-prefix": "gateway"

367 }367> }

368 }368> }

369 }369> }

370 ]370> ]

371}371> }

372```372> ```

373 373>

374Зарегистрируйте его:374> Зарегистрируйте его:

375 375>

376```bash theme={null}376> ```bash theme={null}

377aws ecs register-task-definition --cli-input-json file://claude-gateway-task.json377> aws ecs register-task-definition --cli-input-json file://claude-gateway-task.json

378```378> ```

379 379>

380Поместите внутренний ALB впереди с целевой группой, которая проверяет здоровье gateway. `--ip-address-type ipv4` имеет значение: внутренний двойной стек ALB публикует записи AAAA общественного диапазона, которые проверка приватной сети `/login` отклоняет:380> Поместите внутренний ALB впереди с целевой группой, которая проверяет здоровье gateway. `--ip-address-type ipv4` имеет значение: внутренний двойной стек ALB публикует записи AAAA общественного диапазона, которые проверка приватной сети `/login` отклоняет:

381 381>

382```bash theme={null}382> ```bash theme={null}

383ALB_ARN="$(aws elbv2 create-load-balancer --name claude-gateway \383> ALB_ARN="$(aws elbv2 create-load-balancer --name claude-gateway \

384 --scheme internal --type application --ip-address-type ipv4 \384> --scheme internal --type application --ip-address-type ipv4 \

385 --subnets $PRIVATE_SUBNETS --security-groups "$ALB_SG" \385> --subnets $PRIVATE_SUBNETS --security-groups "$ALB_SG" \

386 --query 'LoadBalancers[0].LoadBalancerArn' --output text)"386> --query 'LoadBalancers[0].LoadBalancerArn' --output text)"

387 387>

388TG_ARN="$(aws elbv2 create-target-group --name claude-gateway \388> TG_ARN="$(aws elbv2 create-target-group --name claude-gateway \

389 --protocol HTTP --port 8080 --vpc-id "$VPC_ID" --target-type ip \389> --protocol HTTP --port 8080 --vpc-id "$VPC_ID" --target-type ip \

390 --health-check-path /readyz \390> --health-check-path /readyz \

391 --query 'TargetGroups[0].TargetGroupArn' --output text)"391> --query 'TargetGroups[0].TargetGroupArn' --output text)"

392```392> ```

393 393>

394Добавьте слушатель HTTPS. `--ssl-policy` закрепляет современный минимум TLS, так как его опущение возвращается к устаревшему значению по умолчанию `ELBSecurityPolicy-2016-08`, которое всё ещё принимает TLS 1.0/1.1.394> Добавьте слушатель HTTPS. `--ssl-policy` закрепляет современный минимум TLS, так как его опущение возвращается к устаревшему значению по умолчанию `ELBSecurityPolicy-2016-08`, которое всё ещё принимает TLS 1.0/1.1.

395 395>

396ALB закрывает соединение после 60 секунд без данных по умолчанию. Keepalive пинги gateway держат потоки внутри этого значения по умолчанию, поэтому повышение таймаута добавляет запас выше частоты пингов; строка [Устранение неполадок](#troubleshooting) о разорванных потоках охватывает механизм и более старые gateway. Команды ниже добавляют слушатель и повышают таймаут:396> ALB закрывает соединение после 60 секунд без данных по умолчанию. Keepalive пинги gateway держат потоки внутри этого значения по умолчанию, поэтому повышение таймаута добавляет запас выше частоты пингов; строка [Устранение неполадок](#troubleshooting) о разорванных потоках охватывает механизм и более старые gateway. Команды ниже добавляют слушатель и повышают таймаут:

397 397>

398```bash theme={null}398> ```bash theme={null}

399aws elbv2 create-listener --load-balancer-arn "$ALB_ARN" \399> aws elbv2 create-listener --load-balancer-arn "$ALB_ARN" \

400 --protocol HTTPS --port 443 \400> --protocol HTTPS --port 443 \

401 --ssl-policy ELBSecurityPolicy-TLS13-1-2-2021-06 \401> --ssl-policy ELBSecurityPolicy-TLS13-1-2-2021-06 \

402 --certificates CertificateArn=<your-acm-certificate-arn> \402> --certificates CertificateArn=<your-acm-certificate-arn> \

403 --default-actions Type=forward,TargetGroupArn="$TG_ARN"403> --default-actions Type=forward,TargetGroupArn="$TG_ARN"

404 404>

405aws elbv2 modify-load-balancer-attributes --load-balancer-arn "$ALB_ARN" \405> aws elbv2 modify-load-balancer-attributes --load-balancer-arn "$ALB_ARN" \

406 --attributes Key=idle_timeout.timeout_seconds,Value=3600406> --attributes Key=idle_timeout.timeout_seconds,Value=3600

407```407> ```

408 408>

409Создайте сервис. Выключатель развёртывания откатывает развёртывание, чьи задачи продолжают отказывать, из-за плохого образа или незагружаемой конфигурации, обратно к последнему стабильному состоянию вместо перезапуска отказывающих задач вечно:409> Создайте сервис. Выключатель развёртывания откатывает развёртывание, чьи задачи продолжают отказывать, из-за плохого образа или незагружаемой конфигурации, обратно к последнему стабильному состоянию вместо перезапуска отказывающих задач вечно:

410 410>

411```bash theme={null}411> ```bash theme={null}

412aws ecs create-service --cluster claude-gateway --service-name claude-gateway \412> aws ecs create-service --cluster claude-gateway --service-name claude-gateway \

413 --task-definition claude-gateway --desired-count 1 --launch-type FARGATE \413> --task-definition claude-gateway --desired-count 1 --launch-type FARGATE \

414 --deployment-configuration "deploymentCircuitBreaker={enable=true,rollback=true}" \414> --deployment-configuration "deploymentCircuitBreaker={enable=true,rollback=true}" \

415 --health-check-grace-period-seconds 60 \415> --health-check-grace-period-seconds 60 \

416 --network-configuration "awsvpcConfiguration={subnets=[$(echo $PRIVATE_SUBNETS | tr ' ' ',')],securityGroups=[$GW_SG],assignPublicIp=DISABLED}" \416> --network-configuration "awsvpcConfiguration={subnets=[$(echo $PRIVATE_SUBNETS | tr ' ' ',')],securityGroups=[$GW_SG],assignPublicIp=DISABLED}" \

417 --load-balancers "targetGroupArn=$TG_ARN,containerName=gateway,containerPort=8080"417> --load-balancers "targetGroupArn=$TG_ARN,containerName=gateway,containerPort=8080"

418```418> ```

419 419>

420Период благодати в 60 секунд даёт холодной задаче время на извлечение образа, подключение к хранилищу и ответ на первую проверку здоровья перед тем, как ECS начнёт считать отказы против развёртывания.420> Период благодати в 60 секунд даёт холодной задаче время на извлечение образа, подключение к хранилищу и ответ на первую проверку здоровья перед тем, как ECS начнёт считать отказы против развёртывания.

421 421>

422Проверка здоровья целевой группы на `GET /readyz` проверяет, что хранилище доступно, поэтому задача, которая не может достичь Postgres, никогда не входит в ротацию. Чтобы держать задачи проходящими проверку через короткий сбой базы данных, такой как отказ RDS, установите `store.readiness_grace_seconds`, как описано в [Поведение при сбое](https://code.claude.com/docs/ru/claude-apps-gateway-deploy.md#outage-behavior), которое также охватывает альтернативу `/healthz`.422> Проверка здоровья целевой группы на `GET /readyz` проверяет, что хранилище доступно, поэтому задача, которая не может достичь Postgres, никогда не входит в ротацию. Чтобы держать задачи проходящими проверку через короткий сбой базы данных, такой как отказ RDS, установите `store.readiness_grace_seconds`, как описано в [Поведение при сбое](https://code.claude.com/docs/ru/claude-apps-gateway-deploy.md#outage-behavior), которое также охватывает альтернативу `/healthz`.

423 423>

424Задачи работают в приватных подсетях без публичного IP, поэтому весь исходящий трафик (в Bedrock, ваш IdP, Secrets Manager, ECR и CloudWatch Logs) проходит через NAT gateway. Чтобы держать трафик Bedrock вне публичного пути, создайте интерфейсный эндпоинт VPC `bedrock-runtime` и укажите `base_url` upstream на него, как показано в [справочнике upstream Bedrock](https://code.claude.com/docs/ru/claude-apps-gateway-config.md#amazon-bedrock); IdP всё ещё нуждается в исходящем доступе в интернет.424> Задачи работают в приватных подсетях без публичного IP, поэтому весь исходящий трафик (в Bedrock, ваш IdP, Secrets Manager, ECR и CloudWatch Logs) проходит через NAT gateway. Чтобы держать трафик Bedrock вне публичного пути, создайте интерфейсный эндпоинт VPC `bedrock-runtime` и укажите `base_url` upstream на него, как показано в [справочнике upstream Bedrock](https://code.claude.com/docs/ru/claude-apps-gateway-config.md#amazon-bedrock); IdP всё ещё нуждается в исходящем доступе в интернет.

425 425>

426Завершите, дав разработчикам приватно разрешаемое имя хоста: в приватной зоне Route 53 создайте псевдоним внутреннего имени DNS gateway на ALB и установите `listen.public_url` на это имя хоста. Собственное имя `*.elb.amazonaws.com` ALB разрешается на приватные адреса на внутреннем ALB, но оно не может нести ваш сертификат ACM, поэтому используйте своё имя.426> Завершите, дав разработчикам приватно разрешаемое имя хоста: в приватной зоне Route 53 создайте псевдоним внутреннего имени DNS gateway на ALB и установите `listen.public_url` на это имя хоста. Собственное имя `*.elb.amazonaws.com` ALB разрешается на приватные адреса на внутреннем ALB, но оно не может нести ваш сертификат ACM, поэтому используйте своё имя.

427 427>

428Обновите URI перенаправления авторизованного клиента OAuth на `<public_url>/oauth/callback` перед первым входом. После изменения `public_url`, пересоберите и отправьте образ под новым тегом, зарегистрируйте новую редакцию определения задачи и переразвёртывайте. На ECS настройка живёт во встроенном `gateway.yaml` образа, и gateway строит свой публичный источник только из этой настройки, игнорируя `X-Forwarded-Host` и `X-Forwarded-Proto`. `X-Forwarded-For` соблюдается для IP клиентов только когда установлен `listen.trusted_proxies`.428> Обновите URI перенаправления авторизованного клиента OAuth на `<public_url>/oauth/callback` перед первым входом. После изменения `public_url`, пересоберите и отправьте образ под новым тегом, зарегистрируйте новую редакцию определения задачи и переразвёртывайте. На ECS настройка живёт во встроенном `gateway.yaml` образа, и gateway строит свой публичный источник только из этой настройки, игнорируя `X-Forwarded-Host` и `X-Forwarded-Proto`. `X-Forwarded-For` соблюдается для IP клиентов только когда установлен `listen.trusted_proxies`.

429 

430**EKS**

431 

432Этот трек нуждается в установленных `kubectl` и `eksctl` локально, и существующем кластере EKS с поставщиком IAM OIDC и установленным AWS Load Balancer Controller. Кластер должен быть на `$VPC_ID`, чтобы поды могли достичь приватного эндпоинта RDS, и группа безопасности `claude-gateway-db` должна допускать группу безопасности пода или узла кластера вместо `$GW_SG`.

433 

434На EKS gateway получает свои учётные данные Bedrock через IRSA, а не роли ECS. Политика доверия `ecs-tasks.amazonaws.com` из шага IAM не применяется здесь; IRSA нуждается в роли, чья политика доверия федерирует на поставщика OIDC кластера, ограниченной `system:serviceaccount:claude-gateway:gateway`. `eksctl create iamserviceaccount` создаёт эту роль, присоединяет политики и аннотирует учётную запись сервиса Kubernetes с ARN роли в один шаг. Превратите два документа политики из шага IAM в управляемые политики, которые он может присоединить:

435 

436```bash theme={null}

437BEDROCK_POLICY_ARN="$(aws iam create-policy --policy-name claude-gateway-bedrock-invoke \

438 --policy-document file://bedrock-invoke.json --query Policy.Arn --output text)"

439SECRETS_POLICY_ARN="$(aws iam create-policy --policy-name claude-gateway-secrets-read \

440 --policy-document file://secrets-read.json --query Policy.Arn --output text)"

441 

442kubectl create namespace claude-gateway

443eksctl create iamserviceaccount --cluster <your-cluster> --region "$AWS_REGION" \

444 --namespace claude-gateway --name gateway --role-name claude-gateway \

445 --attach-policy-arn "$BEDROCK_POLICY_ARN" \

446 --attach-policy-arn "$SECRETS_POLICY_ARN" \

447 --approve

448```

449 

450Политика секретов нужна только когда поды читают Secrets Manager сами, как поставщик AWS драйвера Secrets Store CSI делает, используя учётную запись сервиса монтирующего пода; удалите её, если вы создаёте Kubernetes Secrets другим способом. Поставщик нуждается в обоих действиях политики: он вызывает `DescribeSecret`, когда он согласует ротированные секреты, поэтому грант только `GetSecretValue` монтирует при первом развёртывании, но перестаёт подбирать ротации.

451 

452Развёртывайте gateway как стандартный Deployment плюс Service и Ingress, как описано в [развёртывании Kubernetes](https://code.claude.com/docs/ru/claude-apps-gateway-deploy.md#kubernetes), с:

453 

454* `serviceAccountName: gateway`

455* `gateway.yaml` смонтирован из ConfigMap и секреты смонтированы в `/secrets`

456* зонд готовности указан на `GET /readyz`

457 

458Для фронтенда, Ingress, управляемый AWS Load Balancer Controller, предусматривает внутренний ALB. Аннотируйте его с:

459 

460* `alb.ingress.kubernetes.io/scheme: internal` и `alb.ingress.kubernetes.io/target-type: ip`

461* `alb.ingress.kubernetes.io/ip-address-type: ipv4`, чтобы не публиковались записи AAAA общественного диапазона, которые [проверка приватной сети](https://code.claude.com/docs/ru/claude-apps-gateway#prerequisites) `/login` отклонила бы

462* `alb.ingress.kubernetes.io/inbound-cidrs: <your-corporate-cidr>`, поэтому контроллер-управляемая группа безопасности фронтенда допускает только вашу корпоративную сеть вместо значения по умолчанию `0.0.0.0/0`

463* `alb.ingress.kubernetes.io/certificate-arn` с сертификатом ACM

464* `alb.ingress.kubernetes.io/ssl-policy: ELBSecurityPolicy-TLS13-1-2-2021-06`, поэтому слушатель не возвращается к устаревшей политике по умолчанию, которая принимает TLS 1.0 и 1.1

465* `alb.ingress.kubernetes.io/load-balancer-attributes: idle_timeout.timeout_seconds=3600`, запас выше keepalive потоковой передачи gateway; см. [Устранение неполадок](#troubleshooting)

466 429 

467С IRSA, AWS SDK читает спроецированный токен учётной записи сервиса и обменивает его с AWS STS, поэтому под никогда не нуждается в сервисе метаданных экземпляра EC2; NetworkPolicy исходящего трафика может блокировать `169.254.169.254` для подов gateway. Проблема с лимитом переходов узла в разделе [Устранение неполадок](#troubleshooting) ниже применяется только к кластерам, которые пропускают IRSA и полагаются на роли экземпляра узла.430> [tab] EKS

431>

432> Этот трек нуждается в установленных `kubectl` и `eksctl` локально, и существующем кластере EKS с поставщиком IAM OIDC и установленным AWS Load Balancer Controller. Кластер должен быть на `$VPC_ID`, чтобы поды могли достичь приватного эндпоинта RDS, и группа безопасности `claude-gateway-db` должна допускать группу безопасности пода или узла кластера вместо `$GW_SG`.

433>

434> На EKS gateway получает свои учётные данные Bedrock через IRSA, а не роли ECS. Политика доверия `ecs-tasks.amazonaws.com` из шага IAM не применяется здесь; IRSA нуждается в роли, чья политика доверия федерирует на поставщика OIDC кластера, ограниченной `system:serviceaccount:claude-gateway:gateway`. `eksctl create iamserviceaccount` создаёт эту роль, присоединяет политики и аннотирует учётную запись сервиса Kubernetes с ARN роли в один шаг. Превратите два документа политики из шага IAM в управляемые политики, которые он может присоединить:

435>

436> ```bash theme={null}

437> BEDROCK_POLICY_ARN="$(aws iam create-policy --policy-name claude-gateway-bedrock-invoke \

438> --policy-document file://bedrock-invoke.json --query Policy.Arn --output text)"

439> SECRETS_POLICY_ARN="$(aws iam create-policy --policy-name claude-gateway-secrets-read \

440> --policy-document file://secrets-read.json --query Policy.Arn --output text)"

441>

442> kubectl create namespace claude-gateway

443> eksctl create iamserviceaccount --cluster <your-cluster> --region "$AWS_REGION" \

444> --namespace claude-gateway --name gateway --role-name claude-gateway \

445> --attach-policy-arn "$BEDROCK_POLICY_ARN" \

446> --attach-policy-arn "$SECRETS_POLICY_ARN" \

447> --approve

448> ```

449>

450> Политика секретов нужна только когда поды читают Secrets Manager сами, как поставщик AWS драйвера Secrets Store CSI делает, используя учётную запись сервиса монтирующего пода; удалите её, если вы создаёте Kubernetes Secrets другим способом. Поставщик нуждается в обоих действиях политики: он вызывает `DescribeSecret`, когда он согласует ротированные секреты, поэтому грант только `GetSecretValue` монтирует при первом развёртывании, но перестаёт подбирать ротации.

451>

452> Развёртывайте gateway как стандартный Deployment плюс Service и Ingress, как описано в [развёртывании Kubernetes](https://code.claude.com/docs/ru/claude-apps-gateway-deploy.md#kubernetes), с:

453>

454> * `serviceAccountName: gateway`

455> * `gateway.yaml` смонтирован из ConfigMap и секреты смонтированы в `/secrets`

456> * зонд готовности указан на `GET /readyz`

457>

458> Для фронтенда, Ingress, управляемый AWS Load Balancer Controller, предусматривает внутренний ALB. Аннотируйте его с:

459>

460> * `alb.ingress.kubernetes.io/scheme: internal` и `alb.ingress.kubernetes.io/target-type: ip`

461> * `alb.ingress.kubernetes.io/ip-address-type: ipv4`, чтобы не публиковались записи AAAA общественного диапазона, которые [проверка приватной сети](https://code.claude.com/docs/ru/claude-apps-gateway#prerequisites) `/login` отклонила бы

462> * `alb.ingress.kubernetes.io/inbound-cidrs: <your-corporate-cidr>`, поэтому контроллер-управляемая группа безопасности фронтенда допускает только вашу корпоративную сеть вместо значения по умолчанию `0.0.0.0/0`

463> * `alb.ingress.kubernetes.io/certificate-arn` с сертификатом ACM

464> * `alb.ingress.kubernetes.io/ssl-policy: ELBSecurityPolicy-TLS13-1-2-2021-06`, поэтому слушатель не возвращается к устаревшей политике по умолчанию, которая принимает TLS 1.0 и 1.1

465> * `alb.ingress.kubernetes.io/load-balancer-attributes: idle_timeout.timeout_seconds=3600`, запас выше keepalive потоковой передачи gateway; см. [Устранение неполадок](#troubleshooting)

466>

467> С IRSA, AWS SDK читает спроецированный токен учётной записи сервиса и обменивает его с AWS STS, поэтому под никогда не нуждается в сервисе метаданных экземпляра EC2; NetworkPolicy исходящего трафика может блокировать `169.254.169.254` для подов gateway. Проблема с лимитом переходов узла в разделе [Устранение неполадок](#troubleshooting) ниже применяется только к кластерам, которые пропускают IRSA и полагаются на роли экземпляра узла.

468 468 

469**8. Отправьте URL gateway на машины разработчиков**469**8. Отправьте URL gateway на машины разработчиков**

470 470 

Details

203 203 

204**7. Развертывание**204**7. Развертывание**

205 205 

206**Cloud Run**206> [tab] Cloud Run

207 

208Команда ниже развертывает для производства за внутренним балансировщиком нагрузки.

209 

210```bash theme={null}

211gcloud run deploy claude-gateway \

212 --image="${REGION}-docker.pkg.dev/${PROJECT_ID}/claude-gateway/gateway:<version>" \

213 --region="$REGION" \

214 --service-account="claude-gateway@${PROJECT_ID}.iam.gserviceaccount.com" \

215 --min-instances=1 \

216 --max-instances=8 \

217 --timeout=3600 \

218 --ingress=internal \

219 --network="$VPC" --subnet=cc-gateway-subnet --vpc-egress=private-ranges-only \

220 --set-secrets=/etc/claude/gateway.yaml=gateway-config:latest,GATEWAY_JWT_SECRET=gateway-jwt-secret:latest,OIDC_CLIENT_SECRET=gateway-oidc-client-secret:latest,GATEWAY_POSTGRES_URL=gateway-postgres-url:latest \

221 --no-invoker-iam-check

222```

223 

224Прямой исход VPC через `--network`, `--subnet` и `--vpc-egress=private-ranges-only` позволяет сервису достичь приватного IP Cloud SQL напрямую. Публичный исход к эндпоинтам Agent Platform в Google Cloud и `accounts.google.com` идёт непосредственно в интернет, а не через VPC, поэтому Cloud NAT не требуется.

225 

226> [!NOTE]

227>207>

228> Каждый экземпляр удерживает до [`store.max_connections`](https://code.claude.com/docs/ru/claude-apps-gateway-config#store) подключений к Postgres, по умолчанию пять. С помощью раздела [Определение размера пула подключений](https://code.claude.com/docs/ru/claude-apps-gateway-deploy.md#size-the-connection-pool) сверьте значение `--max-instances=8` с числом подключений, которые ваша база данных оставляет для шлюза, и учтите дополнительные экземпляры, которые запускает последовательное обновление.208> Команда ниже развертывает для производства за внутренним балансировщиком нагрузки.

229 209>

230Проверка IAM вызывающего должна быть открыта или отключена. Шлюз запускает свой собственный OIDC, и его клиенты не несут токен GCP, поэтому проверка вызывающего Cloud Run должна допускать неаутентифицированные запросы. Аутентификация запроса OIDC шлюза происходит после того, как он достигает контейнера, с `allowed_email_domains`, ограничивающим, какие домены могут входить.210> ```bash theme={null}

231 211> gcloud run deploy claude-gateway \

232Два флага допускают неаутентифицированные запросы:212> --image="${REGION}-docker.pkg.dev/${PROJECT_ID}/claude-gateway/gateway:<version>" \

233 213> --region="$REGION" \

234* `--no-invoker-iam-check`: отключает проверку без привязки `allUsers` для управления и работает в рамках Domain Restricted Sharing214> --service-account="claude-gateway@${PROJECT_ID}.iam.gserviceaccount.com" \

235* `--allow-unauthenticated`: предоставляет `allUsers` роль `run.invoker`; используйте, если ваша организация не позволяет `--no-invoker-iam-check`215> --min-instances=1 \

236 216> --max-instances=8 \

237Ограничение входа через `--ingress` — это отдельный, независимый слой от проверки вызывающего; держите его установленным, чтобы ограничить сервис вашей корпоративной сетью.217> --timeout=3600 \

238 218> --ingress=internal \

239По умолчанию URL Cloud Run `*.run.app` разрешается на публичный адрес, который проверка [приватной сети](https://code.claude.com/docs/ru/claude-apps-gateway#prerequisites) `/login` отклоняет. Две топологии дают разработчикам приватно разрешаемое имя хоста, и Cloud Run не подготавливает ни одну для вас:219> --network="$VPC" --subnet=cc-gateway-subnet --vpc-egress=private-ranges-only \

240 220> --set-secrets=/etc/claude/gateway.yaml=gateway-config:latest,GATEWAY_JWT_SECRET=gateway-jwt-secret:latest,OIDC_CLIENT_SECRET=gateway-oidc-client-secret:latest,GATEWAY_POSTGRES_URL=gateway-postgres-url:latest \

241* **Internal Application Load Balancer** — топология, которую предполагает `gateway.yaml` на этой странице: подготовьте внутренний Application Load Balancer перед сервисом с внутренним именем DNS и сертификатом и установите `listen.public_url` на это имя хоста. Настройка входа `internal` уже допускает трафик от внутренних Application Load Balancer; `internal-and-cloud-load-balancing` дополнительно допускает внешние Application Load Balancer, чьи публичные адреса отклоняет проверка приватной сети `/login`, поэтому ни одной топологии на этой странице этот вариант не нужен.221> --no-invoker-iam-check

242* **Внутренний вход только без балансировщика нагрузки**: оставьте команду развёртывания как есть и оставьте `listen.public_url` как URL `*.run.app`, значение по умолчанию в [эталонных активах](#terraform-reference) ниже. Чтобы `*.run.app` разрешался приватно, ваша команда сети должна уже работать с эндпоинтом Private Service Connect для Google APIs, приватной зоной Cloud DNS, разрешающей `*.run.app` в него, и маршрутизацией из локальной инфраструктуры к этому эндпоинту.222> ```

243 223>

244[Руководство Google по приватной сети для Cloud Run](https://cloud.google.com/run/docs/securing/private-networking) охватывает инфраструктуру, которая требуется обоим вариантам. Проверьте вход после того, как шлюз обслуживает приватное имя хоста; до этого подтвердите загрузку контейнера из его журналов в Cloud Run.224> Прямой исход VPC через `--network`, `--subnet` и `--vpc-egress=private-ranges-only` позволяет сервису достичь приватного IP Cloud SQL напрямую. Публичный исход к эндпоинтам Agent Platform в Google Cloud и `accounts.google.com` идёт непосредственно в интернет, а не через VPC, поэтому Cloud NAT не требуется.

245 225>

246Обновите URI перенаправления авторизации клиента OAuth на `<public_url>/oauth/callback` перед первым входом. Переразверните после изменения `public_url`, потому что шлюз строит свой публичный источник только из этого параметра и игнорирует `X-Forwarded-Host` и `X-Forwarded-Proto`. `X-Forwarded-For` соблюдается для IP-адресов клиентов только когда установлен `listen.trusted_proxies`.226> > [!NOTE]

247 227> >

248**GKE**228> > Каждый экземпляр удерживает до [`store.max_connections`](https://code.claude.com/docs/ru/claude-apps-gateway-config#store) подключений к Postgres, по умолчанию пять. С помощью раздела [Определение размера пула подключений](https://code.claude.com/docs/ru/claude-apps-gateway-deploy.md#size-the-connection-pool) сверьте значение `--max-instances=8` с числом подключений, которые ваша база данных оставляет для шлюза, и учтите дополнительные экземпляры, которые запускает последовательное обновление.

249 229>

250Кластер должен находиться на `$VPC`, созданном на шаге Cloud SQL, чтобы поды могли достичь приватного IP базы данных; одного пиринга VPC недостаточно, потому что приватный IP Cloud SQL сам по себе является пиринговой сетью, и пиринг не является транзитивным. Чтобы создать новый кластер на этом VPC, передайте `--network="$VPC" --subnetwork=cc-gateway-subnet` в `gcloud container clusters create`.230> Проверка IAM вызывающего должна быть открыта или отключена. Шлюз запускает свой собственный OIDC, и его клиенты не несут токен GCP, поэтому проверка вызывающего Cloud Run должна допускать неаутентифицированные запросы. Аутентификация запроса OIDC шлюза происходит после того, как он достигает контейнера, с `allowed_email_domains`, ограничивающим, какие домены могут входить.

251 231>

252Включите Workload Identity на кластере и его пулах узлов, затем привяжите сервисный аккаунт Google к сервисному аккаунту Kubernetes, чтобы поды наследовали его учётные данные:232> Два флага допускают неаутентифицированные запросы:

253 233>

254```bash theme={null}234> * `--no-invoker-iam-check`: отключает проверку без привязки `allUsers` для управления и работает в рамках Domain Restricted Sharing

255gcloud container clusters update <cluster> --region="$REGION" \235> * `--allow-unauthenticated`: предоставляет `allUsers` роль `run.invoker`; используйте, если ваша организация не позволяет `--no-invoker-iam-check`

256 --workload-pool="${PROJECT_ID}.svc.id.goog"236>

257# On a Standard cluster, existing node pools also need GKE_METADATA;237> Ограничение входа через `--ingress` — это отдельный, независимый слой от проверки вызывающего; держите его установленным, чтобы ограничить сервис вашей корпоративной сетью.

258# Autopilot enables this by default.238>

259gcloud container node-pools update <pool> --cluster=<cluster> \239> По умолчанию URL Cloud Run `*.run.app` разрешается на публичный адрес, который проверка [приватной сети](https://code.claude.com/docs/ru/claude-apps-gateway#prerequisites) `/login` отклоняет. Две топологии дают разработчикам приватно разрешаемое имя хоста, и Cloud Run не подготавливает ни одну для вас:

260 --region="$REGION" --workload-metadata=GKE_METADATA240>

261 241> * **Internal Application Load Balancer** — топология, которую предполагает `gateway.yaml` на этой странице: подготовьте внутренний Application Load Balancer перед сервисом с внутренним именем DNS и сертификатом и установите `listen.public_url` на это имя хоста. Настройка входа `internal` уже допускает трафик от внутренних Application Load Balancer; `internal-and-cloud-load-balancing` дополнительно допускает внешние Application Load Balancer, чьи публичные адреса отклоняет проверка приватной сети `/login`, поэтому ни одной топологии на этой странице этот вариант не нужен.

262kubectl create namespace claude-gateway242> * **Внутренний вход только без балансировщика нагрузки**: оставьте команду развёртывания как есть и оставьте `listen.public_url` как URL `*.run.app`, значение по умолчанию в [эталонных активах](#terraform-reference) ниже. Чтобы `*.run.app` разрешался приватно, ваша команда сети должна уже работать с эндпоинтом Private Service Connect для Google APIs, приватной зоной Cloud DNS, разрешающей `*.run.app` в него, и маршрутизацией из локальной инфраструктуры к этому эндпоинту.

263kubectl create serviceaccount gateway -n claude-gateway243>

264 244> [Руководство Google по приватной сети для Cloud Run](https://cloud.google.com/run/docs/securing/private-networking) охватывает инфраструктуру, которая требуется обоим вариантам. Проверьте вход после того, как шлюз обслуживает приватное имя хоста; до этого подтвердите загрузку контейнера из его журналов в Cloud Run.

265gcloud iam service-accounts add-iam-policy-binding \245>

266 "claude-gateway@${PROJECT_ID}.iam.gserviceaccount.com" \246> Обновите URI перенаправления авторизации клиента OAuth на `<public_url>/oauth/callback` перед первым входом. Переразверните после изменения `public_url`, потому что шлюз строит свой публичный источник только из этого параметра и игнорирует `X-Forwarded-Host` и `X-Forwarded-Proto`. `X-Forwarded-For` соблюдается для IP-адресов клиентов только когда установлен `listen.trusted_proxies`.

267 --role roles/iam.workloadIdentityUser \

268 --member "serviceAccount:${PROJECT_ID}.svc.id.goog[claude-gateway/gateway]"

269 

270kubectl annotate serviceaccount gateway -n claude-gateway \

271 iam.gke.io/gcp-service-account="claude-gateway@${PROJECT_ID}.iam.gserviceaccount.com"

272```

273 

274Развертывайте шлюз как стандартное развертывание плюс сервис и внутренний Ingress, класс `gce-internal`, как описано в [развертывании Kubernetes](https://code.claude.com/docs/ru/claude-apps-gateway-deploy.md#kubernetes), с:

275 

276* `serviceAccountName: gateway`

277* драйвер Secret Manager CSI, монтирующий секреты в `/secrets`

278* зонд готовности, указывающий на `GET /readyz`

279 

280Присоедините BackendConfig с повышенным `timeoutSec` к сервису шлюза: сервис бэкенда балансировщика нагрузки за GKE Ingress по умолчанию имеет тайм-аут 30 секунд, который отсекает длинные потоковые ответы.

281 

282Не применяйте исходящую NetworkPolicy, которая блокирует `169.254.169.254` на кластере Workload Identity; под должен достичь сервера метаданных для учётных данных. Встроенная [защита SSRF](https://code.claude.com/docs/ru/claude-apps-gateway-deploy.md#threat-model-summary) шлюза — это защита там.

283 247 

284Шлюз регистрирует предупреждение при загрузке о том, что конечная точка метаданных доступна и предлагает применить исходящую NetworkPolicy. При Workload Identity это предупреждение ожидается, потому что под нуждается в конечной точке.248> [tab] GKE

249>

250> Кластер должен находиться на `$VPC`, созданном на шаге Cloud SQL, чтобы поды могли достичь приватного IP базы данных; одного пиринга VPC недостаточно, потому что приватный IP Cloud SQL сам по себе является пиринговой сетью, и пиринг не является транзитивным. Чтобы создать новый кластер на этом VPC, передайте `--network="$VPC" --subnetwork=cc-gateway-subnet` в `gcloud container clusters create`.

251>

252> Включите Workload Identity на кластере и его пулах узлов, затем привяжите сервисный аккаунт Google к сервисному аккаунту Kubernetes, чтобы поды наследовали его учётные данные:

253>

254> ```bash theme={null}

255> gcloud container clusters update <cluster> --region="$REGION" \

256> --workload-pool="${PROJECT_ID}.svc.id.goog"

257> # On a Standard cluster, existing node pools also need GKE_METADATA;

258> # Autopilot enables this by default.

259> gcloud container node-pools update <pool> --cluster=<cluster> \

260> --region="$REGION" --workload-metadata=GKE_METADATA

261>

262> kubectl create namespace claude-gateway

263> kubectl create serviceaccount gateway -n claude-gateway

264>

265> gcloud iam service-accounts add-iam-policy-binding \

266> "claude-gateway@${PROJECT_ID}.iam.gserviceaccount.com" \

267> --role roles/iam.workloadIdentityUser \

268> --member "serviceAccount:${PROJECT_ID}.svc.id.goog[claude-gateway/gateway]"

269>

270> kubectl annotate serviceaccount gateway -n claude-gateway \

271> iam.gke.io/gcp-service-account="claude-gateway@${PROJECT_ID}.iam.gserviceaccount.com"

272> ```

273>

274> Развертывайте шлюз как стандартное развертывание плюс сервис и внутренний Ingress, класс `gce-internal`, как описано в [развертывании Kubernetes](https://code.claude.com/docs/ru/claude-apps-gateway-deploy.md#kubernetes), с:

275>

276> * `serviceAccountName: gateway`

277> * драйвер Secret Manager CSI, монтирующий секреты в `/secrets`

278> * зонд готовности, указывающий на `GET /readyz`

279>

280> Присоедините BackendConfig с повышенным `timeoutSec` к сервису шлюза: сервис бэкенда балансировщика нагрузки за GKE Ingress по умолчанию имеет тайм-аут 30 секунд, который отсекает длинные потоковые ответы.

281>

282> Не применяйте исходящую NetworkPolicy, которая блокирует `169.254.169.254` на кластере Workload Identity; под должен достичь сервера метаданных для учётных данных. Встроенная [защита SSRF](https://code.claude.com/docs/ru/claude-apps-gateway-deploy.md#threat-model-summary) шлюза — это защита там.

283>

284> Шлюз регистрирует предупреждение при загрузке о том, что конечная точка метаданных доступна и предлагает применить исходящую NetworkPolicy. При Workload Identity это предупреждение ожидается, потому что под нуждается в конечной точке.

285 285 

286**8. Отправка URL шлюза на машины разработчиков**286**8. Отправка URL шлюза на машины разработчиков**

287 287 

Details

8 8 

9> [!NOTE]9> [!NOTE]

10>10>

11> Облачные сессии доступны в планах Pro, Max и Team, а также для пользователей Enterprise с премиум-местами или местами Chat + Claude Code. Если вашим доступом управляют [пользовательские роли](https://support.claude.com/en/articles/13930452), вам также нужна роль с разрешением на облачные сессии, чтобы запускать сессии на инфраструктуре Anthropic из браузера, приложений или терминала. Попросите владельца (Owner) добавить это разрешение в одну из ваших ролей в [**Organization settings > Roles**](https://claude.ai/admin-settings/roles).11> Облачные сессии доступны в планах Pro, Max, Ultra и Team, а также для пользователей Enterprise с премиум-местами или местами Chat + Claude Code. Если вашим доступом управляют [пользовательские роли](https://support.claude.com/en/articles/13930452), вам также нужна роль с разрешением на облачные сессии, чтобы запускать сессии на инфраструктуре Anthropic из браузера, приложений или терминала. Попросите владельца (Owner) добавить это разрешение в одну из ваших ролей в [**Organization settings > Roles**](https://claude.ai/admin-settings/roles).

12 12 

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

14 14 

342* **Ваше имя**: отображаемое имя вашей учётной записи видно всем получателям с доступом342* **Ваше имя**: отображаемое имя вашей учётной записи видно всем получателям с доступом

343* **Сессии Slack**: сессии [Claude в Slack](https://code.claude.com/docs/ru/slack.md) автоматически становятся общими с видимостью Team343* **Сессии Slack**: сессии [Claude в Slack](https://code.claude.com/docs/ru/slack.md) автоматически становятся общими с видимостью Team

344 344 

345#### Совместное использование из учётной записи Max или Pro345#### Совместное использование из учётной записи Max, Ultra или Pro

346 

347Для учётных записей Max и Pro совместное использование работает следующим образом:

348 346 

349* **Варианты видимости**: **Private** и **Public**. Видимость Public делает сессию видимой для любого пользователя, вошедшего в claude.ai347* **Варианты видимости**: **Private** и **Public**. Видимость Public делает сессию видимой для любого пользователя, вошедшего в claude.ai

350* **Доступ к репозиторию**: проверка не включена по умолчанию348* **Доступ к репозиторию**: проверка не включена по умолчанию

Details

8 8 

9> [!NOTE]9> [!NOTE]

10>10>

11> Projects доступны в публичной бета-версии на планах Pro и Max и развертываются постепенно. Развертывание началось с аккаунтов, которые использовали [облачные сессии](https://code.claude.com/docs/ru/claude-code-on-the-web.md) и не имеют существующих проектов в чате claude.ai или Cowork. Projects пока недоступны на планах Team и Enterprise.11> Projects доступны в публичной бета-версии на планах Pro, Max и Ultra и развертываются постепенно. Развертывание началось с аккаунтов, которые использовали [облачные сессии](https://code.claude.com/docs/ru/claude-code-on-the-web.md) и не имеют существующих проектов в чате claude.ai или Cowork. Projects пока недоступны на планах Team и Enterprise.

12>12>

13> Если вы не видите **Projects** на боковой панели на [claude.ai/code](https://claude.ai/code) или на вкладке Code [настольного приложения](https://code.claude.com/docs/ru/desktop.md), проверьте раздел **More** там же. Если их нет и там, развертывание еще не достигло вашего аккаунта. Вы можете [присоединиться к списку ожидания](https://claude.com/form/projects), а в разделе [Запуск агентов параллельно](https://code.claude.com/docs/ru/agents.md) узнать, что можно использовать тем временем.13> Если вы не видите **Projects** на боковой панели на [claude.ai/code](https://claude.ai/code) или на вкладке Code [настольного приложения](https://code.claude.com/docs/ru/desktop.md), проверьте раздел **More** там же. Если их нет и там, развертывание еще не достигло вашего аккаунта. Вы можете [присоединиться к списку ожидания](https://claude.com/form/projects), а в разделе [Запуск агентов параллельно](https://code.claude.com/docs/ru/agents.md) узнать, что можно использовать тем временем.

14 14 

78 78 

79Перед созданием проекта проверьте ваш план, настройку GitHub и то, что нужно работе для достижения:79Перед созданием проекта проверьте ваш план, настройку GitHub и то, что нужно работе для достижения:

80 80 

81* **План**: вы на Pro или Max, и **Projects** отображается на вашей боковой панели — напрямую или в разделе **More**. Выберите **Projects** и убедитесь, что там предлагается **New project** или **Get started**.81* **План**: вы на Pro, Max или Ultra, и **Projects** отображается на вашей боковой панели — напрямую или в разделе **More**. Выберите **Projects** и убедитесь, что там предлагается **New project** или **Get started**.

82* **GitHub, если проект будет работать с кодом**: ваш код находится на github.com, а не на GitHub Enterprise Server, GitLab или Bitbucket, ваш подключенный аккаунт GitHub имеет доступ на push к нему, и Claude GitHub App установлено на нем. Если вы подключили GitHub с помощью [`/web-setup`](https://code.claude.com/docs/ru/web-quickstart#connect-from-your-terminal), этот токен позволяет вашим другим облачным сеансам достичь репозитория, но недостаточно для облачных потоков проекта, которым нужно Claude GitHub App. [Настройка доступа GitHub](#set-up-github-access) содержит шаги.82* **GitHub, если проект будет работать с кодом**: ваш код находится на github.com, а не на GitHub Enterprise Server, GitLab или Bitbucket, ваш подключенный аккаунт GitHub имеет доступ на push к нему, и Claude GitHub App установлено на нем. Если вы подключили GitHub с помощью [`/web-setup`](https://code.claude.com/docs/ru/web-quickstart#connect-from-your-terminal), этот токен позволяет вашим другим облачным сеансам достичь репозитория, но недостаточно для облачных потоков проекта, которым нужно Claude GitHub App. [Настройка доступа GitHub](#set-up-github-access) содержит шаги.

83* **Сеть, секреты и инструменты**: для облачных потоков они поступают из [облачной среды](#choose-an-environment-for-threads) проекта. Среда по умолчанию уже имеет доступ к [распространенным реестрам пакетов](https://code.claude.com/docs/ru/cloud-environments.md#default-allowed-domains), поэтому проверяйте это, только если работе нужны другие домены, секрет или инструмент, который не предустановлен. Если работе нужен MCP-сервер, проверьте, что он отображается как подключенный в ваших [коннекторах claude.ai](https://claude.ai/customize/connectors).83* **Сеть, секреты и инструменты**: для облачных потоков они поступают из [облачной среды](#choose-an-environment-for-threads) проекта. Среда по умолчанию уже имеет доступ к [распространенным реестрам пакетов](https://code.claude.com/docs/ru/cloud-environments.md#default-allowed-domains), поэтому проверяйте это, только если работе нужны другие домены, секрет или инструмент, который не предустановлен. Если работе нужен MCP-сервер, проверьте, что он отображается как подключенный в ваших [коннекторах claude.ai](https://claude.ai/customize/connectors).

84 84 

421 421 

422Откройте **Usage** в **Project settings**, чтобы увидеть использование токенов по потокам и по моделям, и сколько пошло в разговор проекта. Чтобы снизить его:422Откройте **Usage** в **Project settings**, чтобы увидеть использование токенов по потокам и по моделям, и сколько пошло в разговор проекта. Чтобы снизить его:

423 423 

424* Последующее сообщение, направленное в поток, который был неактивным дольше, чем [время жизни кэша](https://code.claude.com/docs/ru/prompt-caching.md#cache-lifetime), час на Pro и Max в пределах лимитов вашего плана, перечитывает весь разговор этого потока перед тем, как что-то делать. Для новой работы, просьба Claude запустить свежий поток может использовать меньше, чем возрождение большого старого.424* На Pro, Max и Ultra в пределах лимитов вашего плана [время жизни кэша](https://code.claude.com/docs/ru/prompt-caching.md#cache-lifetime) составляет один час. Поток, который был неактивен дольше этого времени, перечитывает весь свой диалог, прежде чем что-либо делать, когда до него доходит последующее сообщение. Для новой работы попросите Claude запустить свежий поток — это может использовать меньше, чем возрождение большого старого.

425* Для работы, которая не требует самую большую модель, [выберите меньшую модель или более низкий уровень интенсивности](#choose-models-and-let-claude-manage-context) для потоков, разговора или обоих.425* Для работы, которая не требует самую большую модель, [выберите меньшую модель или более низкий уровень интенсивности](#choose-models-and-let-claude-manage-context) для потоков, разговора или обоих.

426* Попросите Claude в разговоре проекта запускать меньше потоков одновременно или отвечать на маленькие вопросы самостоятельно вместо запуска потока.426* Попросите Claude в разговоре проекта запускать меньше потоков одновременно или отвечать на маленькие вопросы самостоятельно вместо запуска потока.

427 427 

429 429 

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

431 431 

432* **Claude Tag**: [Claude Tag](https://claude.com/docs/claude-tag/overview) — это Claude в каналах Slack вашей команды, на планах Team и Enterprise. Любой в канале может дать ему работу, все в канале видят и направляют его, и он использует соединения, которые администратор установил для этого канала. Проект — это только ваш: вы единственный, кто отправляет ему работу или видит его потоки, он использует ваш собственный доступ GitHub и connectors, и он на Pro и Max. [Как Claude Tag отличается от Cowork и Claude Code](https://claude.com/docs/claude-tag/concepts/how-it-works#how-claude-tag-differs-from-cowork-and-claude-code) имеет рядом.432* **Claude Tag**: [Claude Tag](https://claude.com/docs/claude-tag/overview) — это Claude в каналах Slack вашей команды, на планах Team и Enterprise. Любой в канале может дать ему работу, все в канале видят и направляют его, и он использует подключения, которые администратор настроил для этого канала.

433 

434 Проекты доступны на планах Pro, Max и Ultra. Проект принадлежит только вам: только вы отправляете ему работу и видите его потоки, и он использует ваш собственный доступ к GitHub и ваши коннекторы. Сравнение приведено в разделе [Как Claude Tag отличается от Cowork и Claude Code](https://claude.com/docs/claude-tag/concepts/how-it-works#how-claude-tag-differs-from-cowork-and-claude-code).

433* **Облачные сессии**: каждый поток — это [облачная сессия](https://code.claude.com/docs/ru/claude-code-on-the-web.md), если вы не попросите Claude запустить его на вашей машине. В любом случае Claude запускает и отслеживает его вместо вас. Вы также можете перенести в проект работу облачной сессии, которую запустили самостоятельно: выберите [**Continue in project**](#start-from-an-existing-cloud-session) в меню боковой панели этой сессии.435* **Облачные сессии**: каждый поток — это [облачная сессия](https://code.claude.com/docs/ru/claude-code-on-the-web.md), если вы не попросите Claude запустить его на вашей машине. В любом случае Claude запускает и отслеживает его вместо вас. Вы также можете перенести в проект работу облачной сессии, которую запустили самостоятельно: выберите [**Continue in project**](#start-from-an-existing-cloud-session) в меню боковой панели этой сессии.

434* **Scheduled tasks**: когда вы запрашиваете запланированную работу в проекте, Claude создает [облачную запланированную задачу](https://code.claude.com/docs/ru/routines.md), которая выполняется как потоки в этом проекте и отображается на его вкладке **Scheduled tasks**. Запланированные задачи, которые вы создаете вне проекта, продолжают работать самостоятельно.436* **Scheduled tasks**: когда вы запрашиваете запланированную работу в проекте, Claude создает [облачную запланированную задачу](https://code.claude.com/docs/ru/routines.md), которая выполняется как потоки в этом проекте и отображается на его вкладке **Scheduled tasks**. Запланированные задачи, которые вы создаете вне проекта, продолжают работать самостоятельно.

435* **Remote Control**: [Remote Control](https://code.claude.com/docs/ru/remote-control.md) соединяет claude.ai с сеансом Claude Code, работающим на вашей машине. Когда вы просите Claude в проекте запустить поток на вашем компьютере, проект [использует Remote Control для этого](#run-a-thread-on-your-own-computer).437* **Remote Control**: [Remote Control](https://code.claude.com/docs/ru/remote-control.md) соединяет claude.ai с сеансом Claude Code, работающим на вашей машине. Когда вы просите Claude в проекте запустить поток на вашем компьютере, проект [использует Remote Control для этого](#run-a-thread-on-your-own-computer).

Details

8 8 

9> [!NOTE]9> [!NOTE]

10>10>

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

12 12 

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

14 14 

32Если у вас ещё нет среды, подключение устанавливает среду **Default**. Как это происходит, зависит от того, где вы подключаетесь:32Если у вас ещё нет среды, подключение устанавливает среду **Default**. Как это происходит, зависит от того, где вы подключаетесь:

33 33 

34* **Потоки CLI, такие как `/web-setup`**: создают **Default** для вас34* **Потоки CLI, такие как `/web-setup`**: создают **Default** для вас

35* **Веб-подключение на Pro и Max**: создаёт **Default** для вас35* **Веб-подключение на Pro, Max и Ultra**: вы получаете **Default** автоматически

36* **Веб-подключение на Team и Enterprise**: показывает форму **Create your first cloud environment**, если владелец не включил [Quick setup](https://code.claude.com/docs/ru/claude-code-on-the-web.md#quick-setup-for-team-and-enterprise); сохраните значения по умолчанию в форме и нажмите **Create & finish**, чтобы получить ту же среду **Default**36* **Веб-подключение на Team и Enterprise**: показывает форму **Create your first cloud environment**, если владелец не включил [Quick setup](https://code.claude.com/docs/ru/claude-code-on-the-web.md#quick-setup-for-team-and-enterprise); сохраните значения по умолчанию в форме и нажмите **Create & finish**, чтобы получить ту же среду **Default**

37 37 

38**Default** не имеет собственной конфигурации:38**Default** не имеет собственной конфигурации:

93 93 

94Сетевой секрет — это API-ключ или токен, который вы сохраняете в облачной среде, чтобы Claude мог вызывать этот API из любой сессии в среде, не видя ключа. Прокси агента Anthropic добавляет ключ к запросам для перечисленных вами хостов после того, как каждый запрос покидает виртуальную машину сессии, поэтому сам ключ остаётся за пределами виртуальной машины.94Сетевой секрет — это API-ключ или токен, который вы сохраняете в облачной среде, чтобы Claude мог вызывать этот API из любой сессии в среде, не видя ключа. Прокси агента Anthropic добавляет ключ к запросам для перечисленных вами хостов после того, как каждый запрос покидает виртуальную машину сессии, поэтому сам ключ остаётся за пределами виртуальной машины.

95 95 

96Сетевые секреты доступны на планах Pro, Max, Team и Enterprise. Чтобы проверить, можете ли вы добавить секрет самостоятельно, смотрите [Требования](#requirements).96Сетевые секреты доступны на планах Pro, Max, Ultra, Team и Enterprise. Чтобы проверить, можете ли вы добавить секрет самостоятельно, смотрите [Требования](#requirements).

97 97 

98#### Требования98#### Требования

99 99 

552 552 

553С **Trusted** сетевым доступом сеансы могут достичь следующих доменов по умолчанию. Домены, отмеченные `*`, указывают на совпадение поддомена с подстановочным знаком, поэтому `*.gcr.io` разрешает любой поддомен `gcr.io`.553С **Trusted** сетевым доступом сеансы могут достичь следующих доменов по умолчанию. Домены, отмеченные `*`, указывают на совпадение поддомена с подстановочным знаком, поэтому `*.gcr.io` разрешает любой поддомен `gcr.io`.

554 554 

555> **Сервисы Anthropic**555> [accordion] Сервисы Anthropic

556>556>

557> * api.anthropic.com557> * api.anthropic.com

558> * docs.claude.com558> * docs.claude.com

564> * anthropic.com564> * anthropic.com

565> * [www.anthropic.com](http://www.anthropic.com)565> * [www.anthropic.com](http://www.anthropic.com)

566 566 

567> **Контроль версий**567> [accordion] Контроль версий

568>568>

569> * github.com569> * github.com

570> * [www.github.com](http://www.github.com)570> * [www.github.com](http://www.github.com)

585> * [www.bitbucket.org](http://www.bitbucket.org)585> * [www.bitbucket.org](http://www.bitbucket.org)

586> * api.bitbucket.org586> * api.bitbucket.org

587 587 

588> **Реестры контейнеров**588> [accordion] Реестры контейнеров

589>589>

590> * registry-1.docker.io590> * registry-1.docker.io

591> * auth.docker.io591> * auth.docker.io

602> * \*.data.mcr.microsoft.com602> * \*.data.mcr.microsoft.com

603> * public.ecr.aws603> * public.ecr.aws

604 604 

605> **Облачные платформы**605> [accordion] Облачные платформы

606>606>

607> * cloud.google.com607> * cloud.google.com

608> * accounts.google.com608> * accounts.google.com

633> * yum.oracle.com633> * yum.oracle.com

634> * \*.r2.cloudflarestorage.com634> * \*.r2.cloudflarestorage.com

635 635 

636> **Менеджеры пакетов JavaScript и Node**636> [accordion] Менеджеры пакетов JavaScript и Node

637>637>

638> * registry.npmjs.org638> * registry.npmjs.org

639> * [www.npmjs.com](http://www.npmjs.com)639> * [www.npmjs.com](http://www.npmjs.com)

645> * jsr.io645> * jsr.io

646> * npm.jsr.io646> * npm.jsr.io

647 647 

648> **Менеджеры пакетов Python**648> [accordion] Менеджеры пакетов Python

649>649>

650> * pypi.org650> * pypi.org

651> * [www.pypi.org](http://www.pypi.org)651> * [www.pypi.org](http://www.pypi.org)

656> * pypa.io656> * pypa.io

657> * [www.pypa.io](http://www.pypa.io)657> * [www.pypa.io](http://www.pypa.io)

658 658 

659> **Менеджеры пакетов Ruby**659> [accordion] Менеджеры пакетов Ruby

660>660>

661> * rubygems.org661> * rubygems.org

662> * [www.rubygems.org](http://www.rubygems.org)662> * [www.rubygems.org](http://www.rubygems.org)

671> * rvm.io671> * rvm.io

672> * get.rvm.io672> * get.rvm.io

673 673 

674> **Менеджеры пакетов Rust**674> [accordion] Менеджеры пакетов Rust

675>675>

676> * crates.io676> * crates.io

677> * [www.crates.io](http://www.crates.io)677> * [www.crates.io](http://www.crates.io)

681> * static.rust-lang.org681> * static.rust-lang.org

682> * [www.rust-lang.org](http://www.rust-lang.org)682> * [www.rust-lang.org](http://www.rust-lang.org)

683 683 

684> **Менеджеры пакетов Go**684> [accordion] Менеджеры пакетов Go

685>685>

686> * proxy.golang.org686> * proxy.golang.org

687> * sum.golang.org687> * sum.golang.org

691> * goproxy.io691> * goproxy.io

692> * pkg.go.dev692> * pkg.go.dev

693 693 

694> **Менеджеры пакетов JVM**694> [accordion] Менеджеры пакетов JVM

695>695>

696> * maven.org696> * maven.org

697> * repo.maven.org697> * repo.maven.org

710> * spring.io710> * spring.io

711> * repo.spring.io711> * repo.spring.io

712 712 

713> **Другие менеджеры пакетов**713> [accordion] Другие менеджеры пакетов

714>714>

715> * packagist.org (PHP Composer)715> * packagist.org (PHP Composer)

716> * [www.packagist.org](http://www.packagist.org)716> * [www.packagist.org](http://www.packagist.org)

736> * swift.org736> * swift.org

737> * [www.swift.org](http://www.swift.org)737> * [www.swift.org](http://www.swift.org)

738 738 

739> **Дистрибутивы Linux**739> [accordion] Дистрибутивы Linux

740>740>

741> * archive.ubuntu.com741> * archive.ubuntu.com

742> * security.ubuntu.com742> * security.ubuntu.com

748> * [www.launchpad.net](http://www.launchpad.net)748> * [www.launchpad.net](http://www.launchpad.net)

749> * \*.nixos.org749> * \*.nixos.org

750 750 

751> **Инструменты разработки и платформы**751> [accordion] Инструменты разработки и платформы

752>752>

753> * dl.k8s.io (Kubernetes)753> * dl.k8s.io (Kubernetes)

754> * pkgs.k8s.io754> * pkgs.k8s.io

780> * pkg.stainless.com780> * pkg.stainless.com

781> * binaries.prisma.sh781> * binaries.prisma.sh

782 782 

783> **Облачные сервисы и мониторинг**783> [accordion] Облачные сервисы и мониторинг

784>784>

785> * http-intake.logs.datadoghq.com785> * http-intake.logs.datadoghq.com

786> * \*.datadoghq.com786> * \*.datadoghq.com

787> * \*.datadoghq.eu787> * \*.datadoghq.eu

788> * api.honeycomb.io788> * api.honeycomb.io

789 789 

790> **Доставка контента и зеркала**790> [accordion] Доставка контента и зеркала

791>791>

792> * sourceforge.net792> * sourceforge.net

793> * \*.sourceforge.net793> * \*.sourceforge.net

796> * fonts.googleapis.com796> * fonts.googleapis.com

797> * fonts.gstatic.com797> * fonts.gstatic.com

798 798 

799> **Схема и конфигурация**799> [accordion] Схема и конфигурация

800>800>

801> * json-schema.org801> * json-schema.org

802> * [www.json-schema.org](http://www.json-schema.org)802> * [www.json-schema.org](http://www.json-schema.org)

803> * json.schemastore.org803> * json.schemastore.org

804> * [www.schemastore.org](http://www.schemastore.org)804> * [www.schemastore.org](http://www.schemastore.org)

805 805 

806> **Model Context Protocol**806> [accordion] Model Context Protocol

807>807>

808> * \*.modelcontextprotocol.io808> * \*.modelcontextprotocol.io

809 809 

code-review.md +5 −5

Details

32 32 

33Выберите страницу в зависимости от того, что вам нужно сделать:33Выберите страницу в зависимости от того, что вам нужно сделать:

34 34 

35> **[Настройка Code Review](https://code.claude.com/docs/ru/code-review-setup.md)**35> [card] [Настройка Code Review](https://code.claude.com/docs/ru/code-review-setup.md)

36>36>

37> Проверьте требования, установите Claude GitHub App и выберите репозитории, уровень ревью и момент запуска ревью37> Проверьте требования, установите Claude GitHub App и выберите репозитории, уровень ревью и момент запуска ревью

38 38 

39> **[Кастомизация Code Review](https://code.claude.com/docs/ru/code-review-customize.md)**39> [card] [Кастомизация Code Review](https://code.claude.com/docs/ru/code-review-customize.md)

40>40>

41> Настройте, что помечается, с помощью файлов `REVIEW.md` и `CLAUDE.md` в вашем репозитории41> Настройте, что помечается, с помощью файлов `REVIEW.md` и `CLAUDE.md` в вашем репозитории

42 42 

43> **[Чтение и запрос ревью на pull request](https://code.claude.com/docs/ru/code-review-pull-requests.md)**43> [card] [Чтение и запрос ревью на pull request](https://code.claude.com/docs/ru/code-review-pull-requests.md)

44>44>

45> Читайте результаты и их степени серьёзности и запрашивайте повторное ревью с помощью комментария45> Читайте результаты и их степени серьёзности и запрашивайте повторное ревью с помощью комментария

46 46 

47> **[Устранение неполадок Code Review](https://code.claude.com/docs/ru/code-review-troubleshooting.md)**47> [card] [Устранение неполадок Code Review](https://code.claude.com/docs/ru/code-review-troubleshooting.md)

48>48>

49> Исправьте ревью, которое не запустилось, завершилось сбоем или было пропущено из-за бюджета49> Исправьте ревью, которое не запустилось, завершилось сбоем или было пропущено из-за бюджета

50 50 

51> **[Стоимость и использование Code Review](https://code.claude.com/docs/ru/code-review-costs.md)**51> [card] [Стоимость и использование Code Review](https://code.claude.com/docs/ru/code-review-costs.md)

52>52>

53> Узнайте, как тарифицируются ревью, оцените расходы, установите ежемесячный лимит расходов и отслеживайте активность ревью53> Узнайте, как тарифицируются ревью, оцените расходы, установите ежемесячный лимит расходов и отслеживайте активность ревью

54 54 

commands.md +5 −5

Details

55| `/artifact-capabilities` | **[Скилл](https://code.claude.com/docs/ru/skills.md#bundled-skills).** Загрузить справочник по возможностям среды выполнения, которые может использовать опубликованный [артефакт](https://code.claude.com/docs/ru/artifacts.md), например [вызов ваших коннекторов](https://code.claude.com/docs/ru/artifacts.md#pull-live-data-with-mcp-connectors) или [предложение скачать файл](https://code.claude.com/docs/ru/artifacts.md#offer-a-file-download), включая информацию о том, какие из них доступны вашей учётной записи. Обычно Claude загружает его самостоятельно перед созданием страницы, использующей одну из них. Доступно там, где доступны [артефакты](https://code.claude.com/docs/ru/artifacts.md#availability) |55| `/artifact-capabilities` | **[Скилл](https://code.claude.com/docs/ru/skills.md#bundled-skills).** Загрузить справочник по возможностям среды выполнения, которые может использовать опубликованный [артефакт](https://code.claude.com/docs/ru/artifacts.md), например [вызов ваших коннекторов](https://code.claude.com/docs/ru/artifacts.md#pull-live-data-with-mcp-connectors) или [предложение скачать файл](https://code.claude.com/docs/ru/artifacts.md#offer-a-file-download), включая информацию о том, какие из них доступны вашей учётной записи. Обычно Claude загружает его самостоятельно перед созданием страницы, использующей одну из них. Доступно там, где доступны [артефакты](https://code.claude.com/docs/ru/artifacts.md#availability) |

56| `/artifact-diagramming` | **[Скилл](https://code.claude.com/docs/ru/skills.md#bundled-skills).** Загрузить рекомендации по созданию диаграмм, которым Claude следует в [артефактах](https://code.claude.com/docs/ru/artifacts.md): когда диаграмма полезна, что изображать и как писать встроенный SVG, остающийся читаемым в светлой и тёмной темах. Требуется Claude Code v2.1.221 или новее |56| `/artifact-diagramming` | **[Скилл](https://code.claude.com/docs/ru/skills.md#bundled-skills).** Загрузить рекомендации по созданию диаграмм, которым Claude следует в [артефактах](https://code.claude.com/docs/ru/artifacts.md): когда диаграмма полезна, что изображать и как писать встроенный SVG, остающийся читаемым в светлой и тёмной темах. Требуется Claude Code v2.1.221 или новее |

57| `/artifacts` | Показать список [артефактов](https://code.claude.com/docs/ru/artifacts.md#find-an-artifact-again), которыми вы владеете или которые вам предоставлены, затем прикрепить один из них к сессии, открыть его в браузере или скопировать ссылку на него. Доступно там, где доступны [артефакты](https://code.claude.com/docs/ru/artifacts.md#availability) |57| `/artifacts` | Показать список [артефактов](https://code.claude.com/docs/ru/artifacts.md#find-an-artifact-again), которыми вы владеете или которые вам предоставлены, затем прикрепить один из них к сессии, открыть его в браузере или скопировать ссылку на него. Доступно там, где доступны [артефакты](https://code.claude.com/docs/ru/artifacts.md#availability) |

58| `/auto-mode-setup` | [Составить черновик записей `autoMode.environment`](https://code.claude.com/docs/ru/auto-mode-config#generate-environment-entries) на основе вашего проекта и недавних сессий, затем просмотреть черновик и сохранить его в пользовательские настройки. На тарифе Pro, Max или Team требуется Claude Code v2.1.228 или новее либо v2.1.233 или новее в нативной Windows. На тарифе Enterprise или с API-ключом Claude Console требуется v2.1.283 или новее. Если команда отсутствует, см. [`/auto-mode-setup` возвращает "Unknown command"](https://code.claude.com/docs/ru/auto-mode-config#auto-mode-setup-returns-unknown-command) |58| `/auto-mode-setup` | [Составить черновик записей `autoMode.environment`](https://code.claude.com/docs/ru/auto-mode-config#generate-environment-entries) на основе вашего проекта и недавних сессий, затем просмотреть черновик и сохранить его в пользовательские настройки. На тарифе Pro, Max, Ultra или Team требуется Claude Code v2.1.228 или новее либо v2.1.233 или новее в нативной Windows. На тарифе Enterprise или с API-ключом Claude Console требуется v2.1.283 или новее. Если команда отсутствует, см. [`/auto-mode-setup` возвращает "Unknown command"](https://code.claude.com/docs/ru/auto-mode-config#auto-mode-setup-returns-unknown-command) |

59| `/autocompact [auto\|<tokens>]` | Задать окно автосжатия: насколько должно заполниться контекстное окно, прежде чем Claude Code автоматически выполнит сжатие контекста. Передайте размер, например `500k`, или `auto`, чтобы вернуться к окну, настроенному для вашей модели. Claude Code сохраняет значение в пользовательских настройках и применяет его к текущей сессии. Допустимые значения и то, что их переопределяет, см. в разделе [Настройка окна автосжатия](https://code.claude.com/docs/ru/model-config.md#set-the-auto-compact-window). Без аргумента открывает диалоговое окно, показывающее текущее окно. Требуется Claude Code v2.1.221 или новее |59| `/autocompact [auto\|<tokens>]` | Задать окно автосжатия: насколько должно заполниться контекстное окно, прежде чем Claude Code автоматически выполнит сжатие контекста. Передайте размер, например `500k`, или `auto`, чтобы вернуться к окну, настроенному для вашей модели. Claude Code сохраняет значение в пользовательских настройках и применяет его к текущей сессии. Допустимые значения и то, что их переопределяет, см. в разделе [Настройка окна автосжатия](https://code.claude.com/docs/ru/model-config.md#set-the-auto-compact-window). Без аргумента открывает диалоговое окно, показывающее текущее окно. Требуется Claude Code v2.1.221 или новее |

60| `/autofix-pr [prompt]` | Запустить [облачную сессию](https://code.claude.com/docs/ru/claude-code-on-the-web.md#auto-fix-pull-requests), которая отслеживает PR текущей ветки и отправляет исправления, когда CI завершается с ошибкой или ревьюеры оставляют комментарии. Определяет открытый PR по вашей текущей ветке с помощью `gh pr view`; чтобы отслеживать другой PR, сначала переключитесь на его ветку. По умолчанию облачной сессии поручено исправлять каждую ошибку CI и каждый комментарий ревью; передайте промпт, чтобы дать ей другие инструкции, например `/autofix-pr only fix lint and type errors`. Требуется CLI `gh` и доступ к [облачным сессиям](https://code.claude.com/docs/ru/claude-code-on-the-web.md) |60| `/autofix-pr [prompt]` | Запустить [облачную сессию](https://code.claude.com/docs/ru/claude-code-on-the-web.md#auto-fix-pull-requests), которая отслеживает PR текущей ветки и отправляет исправления, когда CI завершается с ошибкой или ревьюеры оставляют комментарии. Определяет открытый PR по вашей текущей ветке с помощью `gh pr view`; чтобы отслеживать другой PR, сначала переключитесь на его ветку. По умолчанию облачной сессии поручено исправлять каждую ошибку CI и каждый комментарий ревью; передайте промпт, чтобы дать ей другие инструкции, например `/autofix-pr only fix lint and type errors`. Требуется CLI `gh` и доступ к [облачным сессиям](https://code.claude.com/docs/ru/claude-code-on-the-web.md) |

61| `/background [prompt]` | Отсоединить текущую сессию, чтобы она работала как [фоновый агент](https://code.claude.com/docs/ru/agent-view.md), и освободить этот терминал. Передайте промпт, чтобы отправить ещё одну инструкцию перед отсоединением. Отслеживайте сессию с помощью `claude agents`. Чтобы скопировать диалог в новую фоновую сессию, пока эта продолжает работать, используйте `/fork`. Псевдоним: `/bg` |61| `/background [prompt]` | Отсоединить текущую сессию, чтобы она работала как [фоновый агент](https://code.claude.com/docs/ru/agent-view.md), и освободить этот терминал. Передайте промпт, чтобы отправить ещё одну инструкцию перед отсоединением. Отслеживайте сессию с помощью `claude agents`. Чтобы скопировать диалог в новую фоновую сессию, пока эта продолжает работать, используйте `/fork`. Псевдоним: `/bg` |

120| `/plugin-authoring` | Загрузить справочник, на основе которого Claude [пишет мод](https://code.claude.com/docs/ru/plugins/mods/create.md#ask-claude-for-a-mod). Claude может загрузить его самостоятельно, когда вы просите мод. Это скилл из [встроенного плагина](https://code.claude.com/docs/ru/plugins/mods/overview.md#mods-built-into-claude-code), который можно отключить в `/plugin`. Требуется Claude Code v2.1.287 или новее |120| `/plugin-authoring` | Загрузить справочник, на основе которого Claude [пишет мод](https://code.claude.com/docs/ru/plugins/mods/create.md#ask-claude-for-a-mod). Claude может загрузить его самостоятельно, когда вы просите мод. Это скилл из [встроенного плагина](https://code.claude.com/docs/ru/plugins/mods/overview.md#mods-built-into-claude-code), который можно отключить в `/plugin`. Требуется Claude Code v2.1.287 или новее |

121| `/powerup` | Знакомиться с функциями Claude Code с помощью коротких интерактивных уроков с анимированными демонстрациями |121| `/powerup` | Знакомиться с функциями Claude Code с помощью коротких интерактивных уроков с анимированными демонстрациями |

122| `/pr-comments [PR]` | Удалена в v2.1.91. Вместо этого попросите Claude напрямую просмотреть комментарии к pull request. В более ранних версиях получает и отображает комментарии из pull request на GitHub; автоматически определяет PR для текущей ветки, либо передайте URL или номер PR. Требуется CLI `gh` |122| `/pr-comments [PR]` | Удалена в v2.1.91. Вместо этого попросите Claude напрямую просмотреть комментарии к pull request. В более ранних версиях получает и отображает комментарии из pull request на GitHub; автоматически определяет PR для текущей ветки, либо передайте URL или номер PR. Требуется CLI `gh` |

123| `/privacy-settings` | Просмотреть и обновить настройки конфиденциальности. Доступно только подписчикам тарифов Pro и Max |123| `/privacy-settings` | Просмотреть и обновить настройки конфиденциальности. Доступно только подписчикам тарифов Pro, Max и Ultra |

124| `/radio` | Открыть lo-fi радио Claude FM в браузере. Выводит URL потока, если браузер недоступен |124| `/radio` | Открыть lo-fi радио Claude FM в браузере. Выводит URL потока, если браузер недоступен |

125| `/rate-limit-options` | Показать способы продолжить работу, когда лимит использования claude.ai блокирует запрос: подождать и [автоматически продолжить после сброса лимита](https://code.claude.com/docs/ru/interactive-mode.md#wait-for-a-usage-limit-to-reset), добавить [кредиты использования](https://code.claude.com/docs/ru/costs.md#add-usage-credits-to-your-subscription) или повысить тариф. Claude Code также может открыть это меню самостоятельно, когда вы достигаете лимита в своём терминале. См. [Отключение автоматического продолжения](https://code.claude.com/docs/ru/interactive-mode.md#turn-automatic-continue-off). Требуется подписка claude.ai. Для строк ожидания и продолжения требуется Claude Code v2.1.234 или новее |125| `/rate-limit-options` | Показать способы продолжить работу, когда лимит использования claude.ai блокирует запрос: подождать и [автоматически продолжить после сброса лимита](https://code.claude.com/docs/ru/interactive-mode.md#wait-for-a-usage-limit-to-reset), добавить [кредиты использования](https://code.claude.com/docs/ru/costs.md#add-usage-credits-to-your-subscription) или повысить тариф. Claude Code также может открыть это меню самостоятельно, когда вы достигаете лимита в своём терминале. См. [Отключение автоматического продолжения](https://code.claude.com/docs/ru/interactive-mode.md#turn-automatic-continue-off). Требуется подписка claude.ai. Для строк ожидания и продолжения требуется Claude Code v2.1.234 или новее |

126| `/recap` | Сгенерировать однострочную сводку текущей сессии по запросу. Об автоматической сводке, которая появляется после вашего отсутствия, см. [Сводка сессии](https://code.claude.com/docs/ru/interactive-mode.md#session-recap) |126| `/recap` | Сгенерировать однострочную сводку текущей сессии по запросу. Об автоматической сводке, которая появляется после вашего отсутствия, см. [Сводка сессии](https://code.claude.com/docs/ru/interactive-mode.md#session-recap) |

130| `/remote-control` | Сделать эту сессию доступной для [Remote Control](https://code.claude.com/docs/ru/remote-control.md) с claude.ai. При запуске без входа в систему выводит сообщение о том, что для Remote Control требуется подписка claude.ai, и объясняет, как войти. Псевдоним: `/rc` |130| `/remote-control` | Сделать эту сессию доступной для [Remote Control](https://code.claude.com/docs/ru/remote-control.md) с claude.ai. При запуске без входа в систему выводит сообщение о том, что для Remote Control требуется подписка claude.ai, и объясняет, как войти. Псевдоним: `/rc` |

131| `/remote-env` | Выбрать [облачное окружение](https://code.claude.com/docs/ru/cloud-environments.md#select-an-environment-from-the-cli) по умолчанию для облачных сессий, которые вы запускаете из CLI |131| `/remote-env` | Выбрать [облачное окружение](https://code.claude.com/docs/ru/cloud-environments.md#select-an-environment-from-the-cli) по умолчанию для облачных сессий, которые вы запускаете из CLI |

132| `/rename [name]` | Переименовать текущую сессию и показать имя в строке промпта. Без имени автоматически генерирует его из истории диалога. Также доступно в неинтерактивном режиме (`-p`). Во всех интерфейсах переименования, включая claude.ai и настольное приложение, Claude Code заменяет управляющие и невидимые символы в новом имени пробелами и ограничивает имя 200 символами. Если после удаления невидимых символов имя оказывается пустым, Claude Code отклоняет его и показывает `That name is empty once invisible characters are removed. Usage: /rename <name>`. Для замены символов и ограничения длины требуется Claude Code v2.1.221 или новее |132| `/rename [name]` | Переименовать текущую сессию и показать имя в строке промпта. Без имени автоматически генерирует его из истории диалога. Также доступно в неинтерактивном режиме (`-p`). Во всех интерфейсах переименования, включая claude.ai и настольное приложение, Claude Code заменяет управляющие и невидимые символы в новом имени пробелами и ограничивает имя 200 символами. Если после удаления невидимых символов имя оказывается пустым, Claude Code отклоняет его и показывает `That name is empty once invisible characters are removed. Usage: /rename <name>`. Для замены символов и ограничения длины требуется Claude Code v2.1.221 или новее |

133| `/restart` | Перезапустить Claude Code и возобновить эту сессию, что применяет установленное обновление. Запускайте команду, когда нижняя строка предлагает это после установки обновления. Требуется тариф Pro или Max и нативная установка на macOS или Linux, но не в WSL. Требуется Claude Code v2.1.288 или новее. Псевдоним: `/update` |133| `/restart` | Перезапустить Claude Code и возобновить эту сессию, что применяет установленное обновление. Запускайте команду, когда нижняя строка предлагает это после установки обновления. Требуется тариф Pro, Max или Ultra и нативная установка на macOS или Linux, но не в WSL. Требуется Claude Code v2.1.288 или новее. Псевдоним: `/update` |

134| `/resume [session]` | Возобновить диалог по ID или имени или открыть окно выбора сессий. [Фоновые сессии](https://code.claude.com/docs/ru/agent-view.md) отображаются в окне выбора с пометкой `bg`. Возобновление всё ещё работающей сессии из окна выбора или по ID или имени [открывает эту сессию](https://code.claude.com/docs/ru/sessions.md#resume-a-running-background-session): ваш текущий диалог переходит в фоновый режим, а этот терминал подключается к работающей сессии. Нажмите `←` в пустом промпте, чтобы вернуться в представление агентов, где также отображается покинутый вами диалог. До v2.1.285 Claude Code отказывал и предлагал открыть сессию с помощью `claude attach` или сначала остановить её. Псевдоним: `/continue` |134| `/resume [session]` | Возобновить диалог по ID или имени или открыть окно выбора сессий. [Фоновые сессии](https://code.claude.com/docs/ru/agent-view.md) отображаются в окне выбора с пометкой `bg`. Возобновление всё ещё работающей сессии из окна выбора или по ID или имени [открывает эту сессию](https://code.claude.com/docs/ru/sessions.md#resume-a-running-background-session): ваш текущий диалог переходит в фоновый режим, а этот терминал подключается к работающей сессии. Нажмите `←` в пустом промпте, чтобы вернуться в представление агентов, где также отображается покинутый вами диалог. До v2.1.285 Claude Code отказывал и предлагал открыть сессию с помощью `claude attach` или сначала остановить её. Псевдоним: `/continue` |

135| `/review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [--max-findings n\|all\|default] [pr#\|branch\|path]` | Псевдоним [`/code-review`](https://code.claude.com/docs/ru/code-review-local): проверяет текущий diff либо переданные номер PR, ветку или путь, например `/review 1234`, и принимает те же уровни effort и флаги. Если уровень не указан, ревью повторно использует последний введённый вами уровень от `low` до `max`; точные правила см. в разделе [Локальное код-ревью с помощью `/code-review`](https://code.claude.com/docs/ru/code-review-local). Для глубокого облачного ревью используйте [`/code-review ultra`](https://code.claude.com/docs/ru/ultrareview). До v2.1.223 `/review` была отдельной командой, которая выполняла однопроходное ревью pull request на GitHub по номеру в режиме только для чтения и при запуске без аргумента показывала список открытых PR для выбора; с v2.1.186 по v2.1.201 она использовала тот же мультиагентный движок, что и `/code-review medium` |135| `/review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [--max-findings n\|all\|default] [pr#\|branch\|path]` | Псевдоним [`/code-review`](https://code.claude.com/docs/ru/code-review-local): проверяет текущий diff либо переданные номер PR, ветку или путь, например `/review 1234`, и принимает те же уровни effort и флаги. Если уровень не указан, ревью повторно использует последний введённый вами уровень от `low` до `max`; точные правила см. в разделе [Локальное код-ревью с помощью `/code-review`](https://code.claude.com/docs/ru/code-review-local). Для глубокого облачного ревью используйте [`/code-review ultra`](https://code.claude.com/docs/ru/ultrareview). До v2.1.223 `/review` была отдельной командой, которая выполняла однопроходное ревью pull request на GitHub по номеру в режиме только для чтения и при запуске без аргумента показывала список открытых PR для выбора; с v2.1.186 по v2.1.201 она использовала тот же мультиагентный движок, что и `/code-review medium` |

136| `/rewind` | Откатить диалог и/или код к предыдущей точке или создать сводку начиная с выбранного сообщения. См. [чекпоинты](https://code.claude.com/docs/ru/checkpointing.md). Псевдонимы: `/checkpoint`, `/undo` |136| `/rewind` | Откатить диалог и/или код к предыдущей точке или создать сводку начиная с выбранного сообщения. См. [чекпоинты](https://code.claude.com/docs/ru/checkpointing.md). Псевдонимы: `/checkpoint`, `/undo` |

159| `/theme` | Изменить цветовую тему. Включает вариант `auto`, соответствующий светлому или тёмному фону вашего терминала, светлые и тёмные варианты, темы, доступные для людей с нарушениями цветовосприятия (daltonized), темы ANSI, использующие цветовую палитру вашего терминала, и любые [пользовательские темы](https://code.claude.com/docs/ru/terminal-config.md#create-a-custom-theme) из `~/.claude/themes/` или плагинов. Выберите **New custom theme…**, чтобы создать свою |159| `/theme` | Изменить цветовую тему. Включает вариант `auto`, соответствующий светлому или тёмному фону вашего терминала, светлые и тёмные варианты, темы, доступные для людей с нарушениями цветовосприятия (daltonized), темы ANSI, использующие цветовую палитру вашего терминала, и любые [пользовательские темы](https://code.claude.com/docs/ru/terminal-config.md#create-a-custom-theme) из `~/.claude/themes/` или плагинов. Выберите **New custom theme…**, чтобы создать свою |

160| `/tui [default\|fullscreen]` | Задать рендерер терминального интерфейса и перезапуститься в нём с сохранением диалога. `fullscreen` включает [рендерер альтернативного экрана без мерцания](https://code.claude.com/docs/ru/fullscreen.md). Без аргумента выводит активный рендерер |160| `/tui [default\|fullscreen]` | Задать рендерер терминального интерфейса и перезапуститься в нём с сохранением диалога. `fullscreen` включает [рендерер альтернативного экрана без мерцания](https://code.claude.com/docs/ru/fullscreen.md). Без аргумента выводит активный рендерер |

161| `/ultraplan <prompt>` | Удалена. Вместо неё используйте [режим планирования](https://code.claude.com/docs/ru/permission-modes.md#analyze-before-you-edit-with-plan-mode). Ранее отправляла задачу планирования в [облачную сессию](https://code.claude.com/docs/ru/claude-code-on-the-web.md) для просмотра в браузере |161| `/ultraplan <prompt>` | Удалена. Вместо неё используйте [режим планирования](https://code.claude.com/docs/ru/permission-modes.md#analyze-before-you-edit-with-plan-mode). Ранее отправляла задачу планирования в [облачную сессию](https://code.claude.com/docs/ru/claude-code-on-the-web.md) для просмотра в браузере |

162| `/ultrareview [PR or branch]` | Запустить глубокое мультиагентное код-ревью в облачной песочнице с помощью [ultrareview](https://code.claude.com/docs/ru/ultrareview.md). Передайте ссылку на PR, чтобы проверить этот pull request, либо базовую ветку или коммит, чтобы изменить базу сравнения. Предпочтительный способ вызова — `/code-review ultra`, а `/ultrareview` является псевдонимом. Включает 3 бесплатных запуска на Pro и Max, после чего требуются [кредиты использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |162| `/ultrareview [PR or branch]` | Запустить глубокое мультиагентное код-ревью в облачной песочнице с помощью [ultrareview](https://code.claude.com/docs/ru/ultrareview.md). Передайте ссылку на PR, чтобы проверить этот pull request, либо базовую ветку или коммит, чтобы изменить базу сравнения. Предпочтительный способ вызова — `/code-review ultra`, а `/ultrareview` является псевдонимом. Включает 3 бесплатных запуска на Pro, Max и Ultra, после чего требуются [кредиты использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |

163| `/update-config [request]` | **[Скилл](https://code.claude.com/docs/ru/skills.md#bundled-skills).** Опишите изменение настроек, например разрешение команды, задание переменной окружения или добавление [хука](https://code.claude.com/docs/ru/hooks.md), и Claude отредактирует соответствующий файл [`settings.json`](https://code.claude.com/docs/ru/settings). Для таких параметров, как тема и модель, используйте вместо этого `/config` |163| `/update-config [request]` | **[Скилл](https://code.claude.com/docs/ru/skills.md#bundled-skills).** Опишите изменение настроек, например разрешение команды, задание переменной окружения или добавление [хука](https://code.claude.com/docs/ru/hooks.md), и Claude отредактирует соответствующий файл [`settings.json`](https://code.claude.com/docs/ru/settings). Для таких параметров, как тема и модель, используйте вместо этого `/config` |

164| `/upgrade` | Открыть страницу повышения тарифа в браузере, чтобы перейти на более высокий тариф. Если браузер не открывается, команда показывает приглашение ко входу, не выводя URL |164| `/upgrade` | Открыть страницу повышения тарифа в браузере, чтобы перейти на более высокий тариф. Если браузер не открывается, команда показывает приглашение ко входу, не выводя URL |

165| `/usage` | Показать стоимость сессии, лимиты использования тарифа и статистику активности. На тарифе Pro, Max, Team или Enterprise включает [разбивку того, что учитывается в лимитах тарифа](https://code.claude.com/docs/ru/costs.md#plan-usage-breakdown). `/cost` и `/stats` — псевдонимы |165| `/usage` | Показать стоимость сессии, лимиты использования тарифа и статистику активности. На тарифе Pro, Max, Ultra, Team или Enterprise включает [разбивку того, что учитывается в лимитах тарифа](https://code.claude.com/docs/ru/costs.md#plan-usage-breakdown). `/cost` и `/stats` — псевдонимы |

166| `/usage-credits` | Настроить кредиты использования или запросить их у администратора, когда вы достигли лимита. Открывает [настройки биллинга кредитов использования](https://code.claude.com/docs/ru/costs.md#add-usage-credits-to-your-subscription) в браузере, за исключением случаев, когда участники Team и Enterprise без доступа к биллингу вместо этого отправляют запрос на кредиты своему администратору из CLI, предварительно подтвердив в диалоговом окне, что запрос уведомит их администраторов. Если ни один браузер не может открыть страницу биллинга, например при работе через SSH, команда вместо этого выводит URL для перехода; для этого требуется Claude Code v2.1.205 или новее, а более ранние версии в этом случае ничего не показывали. Ранее `/extra-usage` |166| `/usage-credits` | Настроить кредиты использования или запросить их у администратора, когда вы достигли лимита. Открывает [настройки биллинга кредитов использования](https://code.claude.com/docs/ru/costs.md#add-usage-credits-to-your-subscription) в браузере, за исключением случаев, когда участники Team и Enterprise без доступа к биллингу вместо этого отправляют запрос на кредиты своему администратору из CLI, предварительно подтвердив в диалоговом окне, что запрос уведомит их администраторов. Если ни один браузер не может открыть страницу биллинга, например при работе через SSH, команда вместо этого выводит URL для перехода; для этого требуется Claude Code v2.1.205 или новее, а более ранние версии в этом случае ничего не показывали. Ранее `/extra-usage` |

167| `/verify` | **[Скилл](https://code.claude.com/docs/ru/skills.md#bundled-skills).** Убедиться, что изменение кода делает то, что должно, собрав приложение вашего проекта, запустив его и наблюдая за результатом, а не полагаясь на тесты или проверки типов. См. [Запуск и проверка приложения](https://code.claude.com/docs/ru/skills.md#run-and-verify-your-app) |167| `/verify` | **[Скилл](https://code.claude.com/docs/ru/skills.md#bundled-skills).** Убедиться, что изменение кода делает то, что должно, собрав приложение вашего проекта, запустив его и наблюдая за результатом, а не полагаясь на тесты или проверки типов. См. [Запуск и проверка приложения](https://code.claude.com/docs/ru/skills.md#run-and-verify-your-app) |

168| `/vim` | Удалена в v2.1.92. Чтобы переключаться между режимами редактирования Vim и Normal, используйте `/config` → Editor mode |168| `/vim` | Удалена в v2.1.92. Чтобы переключаться между режимами редактирования Vim и Normal, используйте `/config` → Editor mode |

Details

500 500 

501## Следующие шаги501## Следующие шаги

502 502 

503> **[Лучшие практики](https://code.claude.com/docs/ru/best-practices.md)**503> [card] [Лучшие практики](https://code.claude.com/docs/ru/best-practices.md)

504>504>

505> Паттерны для получения максимума от Claude Code505> Паттерны для получения максимума от Claude Code

506 506 

507> **[Управление сеансами](https://code.claude.com/docs/ru/sessions.md)**507> [card] [Управление сеансами](https://code.claude.com/docs/ru/sessions.md)

508>508>

509> Возобновление, именование и ветвление разговоров509> Возобновление, именование и ветвление разговоров

510 510 

511> **[Worktrees](https://code.claude.com/docs/ru/worktrees.md)**511> [card] [Worktrees](https://code.claude.com/docs/ru/worktrees.md)

512>512>

513> Запуск изолированных параллельных сеансов513> Запуск изолированных параллельных сеансов

514 514 

515> **[Расширение Claude Code](https://code.claude.com/docs/ru/features-overview.md)**515> [card] [Расширение Claude Code](https://code.claude.com/docs/ru/features-overview.md)

516>516>

517> Добавление skills, hooks, MCP, subagents и plugins517> Добавление skills, hooks, MCP, subagents и plugins

communications-kit.md +105 −105

Details

33 33 

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

35 35 

36**Email**36> [tab] Email

37 37>

38```text theme={null}38> ```text theme={null}

39Тема: Claude Code доступен для [Engineering / вашей команды]39> Тема: Claude Code доступен для [Engineering / вашей команды]

40 40>

41Команда,41> Команда,

42 42>

43Начиная с сегодня у вас есть доступ к Claude Code, агенту AI для кодирования, который работает в43> Начиная с сегодня у вас есть доступ к Claude Code, агенту AI для кодирования, который работает в

44вашем терминале, читает вашу фактическую кодовую базу и выполняет реальные задачи от начала до конца:44> вашем терминале, читает вашу фактическую кодовую базу и выполняет реальные задачи от начала до конца:

45отладка, рефакторинг, тесты, PR. Это не автодополнение и не окно чата. Он редактирует файлы45> отладка, рефакторинг, тесты, PR. Это не автодополнение и не окно чата. Он редактирует файлы

46и запускает ваши команды.46> и запускает ваши команды.

47 47>

48Начните работу за две минуты:48> Начните работу за две минуты:

49 49>

50 curl -fsSL https://claude.ai/install.sh | bash50> curl -fsSL https://claude.ai/install.sh | bash

51 cd <your-repo>51> cd <your-repo>

52 claude52> claude

53 53>

54Затем запустите /init один раз. Claude читает ваш проект и пишет CLAUDE.md с54> Затем запустите /init один раз. Claude читает ваш проект и пишет CLAUDE.md с

55вашими командами сборки и соглашениями, поэтому вы перестанете переобъяснять основы.55> вашими командами сборки и соглашениями, поэтому вы перестанете переобъяснять основы.

56 56>

57Затем попробуйте одно из этих действий в репозитории, в котором вы уже находитесь:57> Затем попробуйте одно из этих действий в репозитории, в котором вы уже находитесь:

58 58>

59 - "Тест в [файл] нестабилен. Выясните почему и исправьте"59> - "Тест в [файл] нестабилен. Выясните почему и исправьте"

60 - "Расскажите мне, как [модуль] обрабатывает [X]"60> - "Расскажите мне, как [модуль] обрабатывает [X]"

61 - "Посмотрите на мой рабочий diff и скажите мне, что рискованно перед тем, как я отправлю"61> - "Посмотрите на мой рабочий diff и скажите мне, что рискованно перед тем, как я отправлю"

62 62>

63Куда идет ваш код: Claude Code работает в вашем терминале и обращается напрямую63> Куда идет ваш код: Claude Code работает в вашем терминале и обращается напрямую

64к API Anthropic. В соответствии с нашим планом Team или Enterprise64> к API Anthropic. В соответствии с нашим планом Team или Enterprise

65Anthropic не использует ваш код или промпты для обучения своих моделей.65> Anthropic не использует ваш код или промпты для обучения своих моделей.

66Подробности: https://code.claude.com/docs/en/data-usage66> Подробности: https://code.claude.com/docs/en/data-usage

67 https://code.claude.com/docs/en/security67> https://code.claude.com/docs/en/security

68 68>

69Куда обратиться с вопросами: #claude-code. [Имя владельца] следит за этим69> Куда обратиться с вопросами: #claude-code. [Имя владельца] следит за этим

70на этой неделе.70> на этой неделе.

71 71>

72- [Имя]72> - [Имя]

73 73>

74P.S. Предпочитаете свой редактор? Есть расширение VS Code и плагин JetBrains.74> P.S. Предпочитаете свой редактор? Есть расширение VS Code и плагин JetBrains.

75Тот же агент, без терминала.75> Тот же агент, без терминала.

76```76> ```

77 

78**Slack or Teams**

79 

80```markdown theme={null}

81🚀 *Claude Code доступен для [команды]*

82 

83Агент AI для кодирования, работает в вашем терминале, читает ваш репозиторий, выполняет реальную работу:

84ошибки, рефакторинг, тесты, PR.

85 

86`curl -fsSL https://claude.ai/install.sh | bash` → `cd your-repo` → `claude`

87 

88*Первое, что нужно попробовать* → запустите `/init`, затем: "тест в [файл] нестабилен,

89выясните почему и исправьте".

90 

91🔒 Работает в вашем терминале, обращается напрямую к API Anthropic. В соответствии с нашим

92планом Team или Enterprise ваш код и промпты не используются для обучения моделей.

93Использование данных → https://code.claude.com/docs/en/data-usage

94 

95📚 Quickstart · VS Code · Бесплатный курс на 1 час

96 https://code.claude.com/docs/en/quickstart

97 https://code.claude.com/docs/en/vs-code

98 https://academy.claude.com/courses/claude-code-in-action

99 77 

100Вопросы → в этой ветке. [Владелец] на точке.78> [tab] Slack or Teams

101```79>

80> ```markdown theme={null}

81> 🚀 *Claude Code доступен для [команды]*

82>

83> Агент AI для кодирования, работает в вашем терминале, читает ваш репозиторий, выполняет реальную работу:

84> ошибки, рефакторинг, тесты, PR.

85>

86> `curl -fsSL https://claude.ai/install.sh | bash` → `cd your-repo` → `claude`

87>

88> *Первое, что нужно попробовать* → запустите `/init`, затем: "тест в [файл] нестабилен,

89> выясните почему и исправьте".

90>

91> 🔒 Работает в вашем терминале, обращается напрямую к API Anthropic. В соответствии с нашим

92> планом Team или Enterprise ваш код и промпты не используются для обучения моделей.

93> Использование данных → https://code.claude.com/docs/en/data-usage

94>

95> 📚 Quickstart · VS Code · Бесплатный курс на 1 час

96> https://code.claude.com/docs/en/quickstart

97> https://code.claude.com/docs/en/vs-code

98> https://academy.claude.com/courses/claude-code-in-action

99>

100> Вопросы → в этой ветке. [Владелец] на точке.

101> ```

102 102 

103### Вариант спонсора из руководства103### Вариант спонсора из руководства

104 104 

106 106 

107Эта версия намеренно сокращена до одной просьбы: установить и запустить на одной реальной задаче. Работа руководителя — заставить просьбу приземлиться; стандартное объявление и `#claude-code` обрабатывают как.107Эта версия намеренно сокращена до одной просьбы: установить и запустить на одной реальной задаче. Работа руководителя — заставить просьбу приземлиться; стандартное объявление и `#claude-code` обрабатывают как.

108 108 

109**Email**109> [tab] Email

110 110>

111```text theme={null}111> ```text theme={null}

112Тема: Одно, что я хотел бы, чтобы каждый инженер попробовал на этой неделе112> Тема: Одно, что я хотел бы, чтобы каждый инженер попробовал на этой неделе

113 113>

114Команда,114> Команда,

115 115>

116Мы включили Claude Code для всей инженерии. Это агент AI116> Мы включили Claude Code для всей инженерии. Это агент AI

117который работает непосредственно в вашем терминале, на вашей фактической кодовой базе, и117> который работает непосредственно в вашем терминале, на вашей фактической кодовой базе, и

118ранние результаты от команд, которые уже его используют, достаточно сильны, чтобы я хотел118> ранние результаты от команд, которые уже его используют, достаточно сильны, чтобы я хотел

119чтобы все это использовали на этой неделе.119> чтобы все это использовали на этой неделе.

120 120>

121Я прошу десять минут:121> Я прошу десять минут:

122 122>

123 curl -fsSL https://claude.ai/install.sh | bash123> curl -fsSL https://claude.ai/install.sh | bash

124 cd <your-repo>124> cd <your-repo>

125 claude125> claude

126 126>

127Затем дайте ему одну реальную задачу: ошибку, которую вы откладывали, или "расскажите мне,127> Затем дайте ему одну реальную задачу: ошибку, которую вы откладывали, или "расскажите мне,

128как работает [модуль]".128> как работает [модуль]".

129 129>

130Это вся просьба. [Имя владельца] и команда находятся в #claude-code для130> Это вся просьба. [Имя владельца] и команда находятся в #claude-code для

131всего, что вы встретите на пути.131> всего, что вы встретите на пути.

132 132>

133- [Имя руководителя]133> - [Имя руководителя]

134 [Должность]134> [Должность]

135```135> ```

136 

137**Slack or Teams**

138 

139```markdown theme={null}

140📣 *От [Имя руководителя]: одно, что нужно попробовать на этой неделе*

141 

142Мы включили *Claude Code* для всей инженерии. Ранние результаты достаточно

143сильны, чтобы я просил всех дать ему десять минут на реальную работу на этой неделе.

144 

145`curl -fsSL https://claude.ai/install.sh | bash` → `cd your-repo` →

146`claude` → дайте ему одну реальную задачу.

147 136 

148Вот и все. Вопросы → #claude-code.137> [tab] Slack or Teams

149```138>

139> ```markdown theme={null}

140> 📣 *От [Имя руководителя]: одно, что нужно попробовать на этой неделе*

141>

142> Мы включили *Claude Code* для всей инженерии. Ранние результаты достаточно

143> сильны, чтобы я просил всех дать ему десять минут на реальную работу на этой неделе.

144>

145> `curl -fsSL https://claude.ai/install.sh | bash` → `cd your-repo` →

146> `claude` → дайте ему одну реальную задачу.

147>

148> Вот и все. Вопросы → #claude-code.

149> ```

150 150 

151### Вариант пилотной группы151### Вариант пилотной группы

152 152 

computer-use.md +2 −2

Details

8 8 

9> [!NOTE]9> [!NOTE]

10>10>

11> Computer use — это исследовательский предпросмотр на macOS, который требует план Pro или Max. Он недоступен для планов Team или Enterprise. Требуется интерактивный сеанс, поэтому он недоступен в неинтерактивном режиме с флагом `-p`.11> Computer use — это research preview на macOS, который требует план Pro, Max или Ultra. Он недоступен для планов Team или Enterprise. Требуется интерактивная сессия, поэтому он недоступен в неинтерактивном режиме с флагом `-p`.

12 12 

13Computer use позволяет Claude открывать приложения, управлять вашим экраном и работать на вашей машине так же, как вы. Из CLI Claude может скомпилировать приложение Swift, запустить его, кликнуть по каждой кнопке и сделать снимок экрана результата, всё в одном разговоре, где он писал код.13Computer use позволяет Claude открывать приложения, управлять вашим экраном и работать на вашей машине так же, как вы. Из CLI Claude может скомпилировать приложение Swift, запустить его, кликнуть по каждой кнопке и сделать снимок экрана результата, всё в одном разговоре, где он писал код.

14 14 

198Сервер появляется только на подходящих установках. Проверьте, что:198Сервер появляется только на подходящих установках. Проверьте, что:

199 199 

200* Вы на macOS. Computer use в CLI недоступен на Linux или Windows. На Windows используйте [computer use в Desktop](https://code.claude.com/docs/ru/desktop.md#let-claude-use-your-computer) вместо этого.200* Вы на macOS. Computer use в CLI недоступен на Linux или Windows. На Windows используйте [computer use в Desktop](https://code.claude.com/docs/ru/desktop.md#let-claude-use-your-computer) вместо этого.

201* Вы на плане Pro или Max. Запустите `/status` для подтверждения вашей подписки.201* Вы на плане Pro, Max или Ultra. Запустите `/status` для подтверждения вашей подписки.

202* Вы аутентифицированы через claude.ai. Computer use недоступен с поставщиками третьих сторон, такими как Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry. Если вы получаете доступ к Claude исключительно через поставщика третьей стороны, вам нужна отдельная учётная запись claude.ai для использования этой функции.202* Вы аутентифицированы через claude.ai. Computer use недоступен с поставщиками третьих сторон, такими как Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry. Если вы получаете доступ к Claude исключительно через поставщика третьей стороны, вам нужна отдельная учётная запись claude.ai для использования этой функции.

203* Вы в интерактивном сеансе. Computer use недоступен в неинтерактивном режиме с флагом `-p`.203* Вы в интерактивном сеансе. Computer use недоступен в неинтерактивном режиме с флагом `-p`.

204 204 

costs.md +50 −50

Details

6 6 

7> Отслеживайте использование токенов, устанавливайте лимиты расходов команды и снижайте затраты Claude Code с помощью управления контекстом, выбора модели, настроек расширенного мышления и предварительной обработки hooks.7> Отслеживайте использование токенов, устанавливайте лимиты расходов команды и снижайте затраты Claude Code с помощью управления контекстом, выбора модели, настроек расширенного мышления и предварительной обработки hooks.

8 8 

9Claude Code взимает плату в зависимости от потребления API токенов. Для информации о ценах плана подписки (Pro, Max, Team, Enterprise) см. [claude.com/pricing](https://claude.com/pricing). Затраты на разработчика сильно варьируются в зависимости от выбора модели, размера кодовой базы и паттернов использования, таких как запуск нескольких экземпляров или автоматизация.9Claude Code взимает плату в зависимости от потребления API токенов. Для информации о ценах плана подписки (Pro, Max, Ultra, Team, Enterprise) см. [claude.com/pricing](https://claude.com/pricing). Затраты на разработчика сильно варьируются в зависимости от выбора модели, размера кодовой базы и паттернов использования, таких как запуск нескольких экземпляров или автоматизация.

10 10 

11В масштабах корпоративных развёртываний средняя стоимость составляет около \$13 на разработчика в активный день и \$150-250 на разработчика в месяц, при этом затраты остаются ниже \$30 в активный день для 90% пользователей. Чтобы оценить расходы для вашей команды, начните с небольшой пилотной группы и используйте инструменты отслеживания ниже для установления базовой линии перед более широким развёртыванием.11В масштабах корпоративных развёртываний средняя стоимость составляет около \$13 на разработчика в активный день и \$150-250 на разработчика в месяц, при этом затраты остаются ниже \$30 в активный день для 90% пользователей. Чтобы оценить расходы для вашей команды, начните с небольшой пилотной группы и используйте инструменты отслеживания ниже для установления базовой линии перед более широким развёртыванием.

12 12 

18 18 

19> [!NOTE]19> [!NOTE]

20>20>

21> Блок Session в `/usage` показывает использование API токенов и предназначен для пользователей API. Подписчики Claude Max и Pro имеют использование, включённое в их подписку, поэтому цифра стоимости сессии не имеет отношения к целям выставления счётов. Подписчики видят полосы использования плана, статистику активности и разбивку использования на том же экране.21> Блок Session в `/usage` показывает использование токенов API и предназначен для пользователей API. Для подписчиков Claude Pro, Max и Ultra использование включено в подписку, поэтому цифра стоимости сессии не имеет значения для целей биллинга. Подписчики видят полосы использования плана, статистику активности и разбивку использования на том же экране.

22 22 

23Блок Session в верхней части `/usage` показывает подробную статистику использования токенов для вашей текущей сессии. Claude Code вычисляет цифру в долларах локально на основе количества токенов по цене списка, если только таблица [`modelPricing`](https://code.claude.com/docs/ru/settings-reference#modelpricing) не действует. Администратор устанавливает её в управляемых параметрах вашей организации, чтобы цифра использовала ваши договорные ставки, и пока таблица действует, строка `Total cost` содержит примечание `at your organization's configured rates`. Цифра является оценкой, поэтому для авторитетного выставления счётов см. страницу Usage в [Claude Console](https://platform.claude.com/usage).23Блок Session в верхней части `/usage` показывает подробную статистику использования токенов для вашей текущей сессии. Claude Code вычисляет цифру в долларах локально на основе количества токенов по цене списка, если только таблица [`modelPricing`](https://code.claude.com/docs/ru/settings-reference#modelpricing) не действует. Администратор устанавливает её в управляемых параметрах вашей организации, чтобы цифра использовала ваши договорные ставки, и пока таблица действует, строка `Total cost` содержит примечание `at your organization's configured rates`. Цифра является оценкой, поэтому для авторитетного выставления счётов см. страницу Usage в [Claude Console](https://platform.claude.com/usage).

24 24 

55 55 

56#### Разбивка использования плана56#### Разбивка использования плана

57 57 

58На плане Pro, Max, Team или Enterprise `/usage` также показывает разбивку того, что учитывается в пределах ваших лимитов плана, с рекомендациями:58На плане Pro, Max, Ultra, Team или Enterprise `/usage` также показывает разбивку того, что учитывается в пределах ваших лимитов плана, с рекомендациями:

59 59 

60* **Attribution**: недавнее использование, отнесённое к skills, subagents, plugins и отдельным MCP серверам, каждый показан в процентах от общего объёма. Доля MCP сервера учитывает только запросы, которые потребили один из результатов его инструментов. До версии v2.1.222 после одного вызова MCP сервера Claude Code относил каждый последующий запрос к этому серверу, завышая его долю.60* **Attribution**: недавнее использование, отнесённое к skills, subagents, plugins и отдельным MCP серверам, каждый показан в процентах от общего объёма. Доля MCP сервера учитывает только запросы, которые потребили один из результатов его инструментов. До версии v2.1.222 после одного вызова MCP сервера Claude Code относил каждый последующий запрос к этому серверу, завышая его долю.

61* **Recommendations**: предлагаемые изменения, по одному на строку. Каждая строка начинается с доли вашего недавнего использования, не менее 10%, как в `25% Trim ~/code/api/CLAUDE.md · 49k tokens per request`.61* **Recommendations**: предлагаемые изменения, по одному на строку. Каждая строка начинается с доли вашего недавнего использования, не менее 10%, как в `25% Trim ~/code/api/CLAUDE.md · 49k tokens per request`.

92 92 

93`/usage` также показывает строку кредитов использования, пока [кредиты использования](#add-usage-credits-to-your-subscription) включены. То, что показывает строка, зависит от вашего плана:93`/usage` также показывает строку кредитов использования, пока [кредиты использования](#add-usage-credits-to-your-subscription) включены. То, что показывает строка, зависит от вашего плана:

94 94 

95* **Pro and Max**: ваши расходы за текущий месяц, измеренные в сравнении с вашим ежемесячным лимитом расходов, когда вы установили один. Когда вы не установили лимит, строка показывает `Unlimited` и никакую цифру расходов.95* **Pro, Max и Ultra**: ваши расходы за текущий месяц в сравнении с вашим ежемесячным лимитом расходов, если вы его установили. Если вы не установили лимит, строка показывает `Unlimited` без цифры расходов.

96* **Team and Enterprise**: ваши собственные расходы за текущий месяц, измеренные в сравнении с любым [лимитом, установленным вашей организацией](#claude-for-teams-and-enterprise), который к вам применяется. Лимит, который охватывает всю организацию, не появляется в строке. Когда у вас нет собственного лимита, строка показывает ваши расходы без лимита рядом с ним. Пока кредиты использования отключены для вас, `/usage` не показывает строку кредитов использования.96* **Team and Enterprise**: ваши собственные расходы за текущий месяц, измеренные в сравнении с любым [лимитом, установленным вашей организацией](#claude-for-teams-and-enterprise), который к вам применяется. Лимит, который охватывает всю организацию, не появляется в строке. Когда у вас нет собственного лимита, строка показывает ваши расходы без лимита рядом с ним. Пока кредиты использования отключены для вас, `/usage` не показывает строку кредитов использования.

97 97 

98Когда у вас есть лимит расходов, строка появляется, как только кредиты использования включены, и показывает 0% до тех пор, пока вы не потратите кредиты использования в первый раз. До версии v2.1.236 `/usage` показывал строку только на планах Pro и Max, и строка с лимитом расходов оставалась скрытой до тех пор, пока вы не потратили что-то.98Когда у вас есть лимит расходов, строка появляется, как только кредиты использования включены, и показывает 0% до тех пор, пока вы не потратите кредиты использования в первый раз. До версии v2.1.236 `/usage` показывал строку только на планах Pro, Max и Ultra, и строка с лимитом расходов оставалась скрытой до тех пор, пока вы не потратили что-то.

99 99 

100#### Когда запрос использования не удаётся100#### Когда запрос использования не удаётся

101 101 

130 130 

131| Ваша роль | Что делает `/usage-credits` |131| Ваша роль | Что делает `/usage-credits` |

132| :- | :- |132| :- | :- |

133| Подписчик Pro или Max | Открывает [**Settings > Usage**](https://claude.ai/settings/usage) на claude.ai в браузере. В его разделе **Usage credits** вы можете включить или отключить кредиты использования и проверить баланс кредитов, расходы этого месяца и ежемесячный лимит расходов |133| Подписчик Pro, Max или Ultra | Открывает [**Settings > Usage**](https://claude.ai/settings/usage) на claude.ai в браузере. В его разделе **Usage credits** вы можете включить или отключить кредиты использования и проверить баланс кредитов, расходы этого месяца и ежемесячный лимит расходов |

134| Участник Team или Enterprise с доступом к биллингу | Открывает настройки использования вашей организации, [**Organization settings > Usage**](https://claude.ai/admin-settings/usage), в браузере |134| Участник Team или Enterprise с доступом к биллингу | Открывает настройки использования вашей организации, [**Organization settings > Usage**](https://claude.ai/admin-settings/usage), в браузере |

135| Член Team или Enterprise без доступа к выставлению счётов | Просит вас подтвердить, затем отправляет запрос администраторам вашей организации. До версии v2.1.211 Claude Code отправлял запрос без шага подтверждения |135| Член Team или Enterprise без доступа к выставлению счётов | Просит вас подтвердить, затем отправляет запрос администраторам вашей организации. До версии v2.1.211 Claude Code отправлял запрос без шага подтверждения |

136 136 

144 144 

145Какие элементы управления у вас есть, зависит от того, как ваша организация получает доступ к Claude Code: через план Claude for Teams или Enterprise, Claude Console или облачного провайдера. На планах Teams и Enterprise использование берётся из лимита каждого члена команды. На Console и у облачных провайдеров использование оплачивается за токен вашей организацией. Если ваша организация использует смешанные методы входа, каждый разработчик учитывается в соответствии с тем, с помощью которого он прошёл аутентификацию.145Какие элементы управления у вас есть, зависит от того, как ваша организация получает доступ к Claude Code: через план Claude for Teams или Enterprise, Claude Console или облачного провайдера. На планах Teams и Enterprise использование берётся из лимита каждого члена команды. На Console и у облачных провайдеров использование оплачивается за токен вашей организацией. Если ваша организация использует смешанные методы входа, каждый разработчик учитывается в соответствии с тем, с помощью которого он прошёл аутентификацию.

146 146 

147В таблице указано, где вы видите расходы, где их ограничиваете и как получить данные по пользователям для каждой конфигурации. На индивидуальном плане Pro или Max у вас нет организации для управления, поэтому отслеживайте собственные расходы на кредиты использования, включая [быстрый режим](https://code.claude.com/docs/ru/fast-mode.md#see-where-fast-mode-spend-appears), в разделе [Добавление кредитов использования в вашу подписку](#add-usage-credits-to-your-subscription).147В таблице указано, где вы видите расходы, где их ограничиваете и как получить данные по пользователям для каждой конфигурации. На индивидуальном плане Pro, Max или Ultra у вас нет организации для управления, поэтому отслеживайте собственные расходы на кредиты использования, включая [быстрый режим](https://code.claude.com/docs/ru/fast-mode.md#see-where-fast-mode-spend-appears), в разделе [Добавление кредитов использования в вашу подписку](#add-usage-credits-to-your-subscription).

148 148 

149| Ваша конфигурация | Просмотр расходов | Ограничение расходов | Отчётность по пользователям |149| Ваша конфигурация | Просмотр расходов | Ограничение расходов | Отчётность по пользователям |

150| :- | :- | :- | :- |150| :- | :- | :- | :- |

294 294 

295Например, этот хук PreToolUse фильтрует вывод тестов для отображения только сбоев:295Например, этот хук PreToolUse фильтрует вывод тестов для отображения только сбоев:

296 296 

297**settings.json**297> [tab] settings.json

298 298>

299Добавьте это в ваш [settings.json](https://code.claude.com/docs/ru/settings.md#where-settings-live) для запуска хука перед каждой командой Bash:299> Добавьте это в ваш [settings.json](https://code.claude.com/docs/ru/settings.md#where-settings-live) для запуска хука перед каждой командой Bash:

300 300>

301```json theme={null}301> ```json theme={null}

302{302> {

303 "hooks": {303> "hooks": {

304 "PreToolUse": [304> "PreToolUse": [

305 {305> {

306 "matcher": "Bash",306> "matcher": "Bash",

307 "hooks": [307> "hooks": [

308 {308> {

309 "type": "command",309> "type": "command",

310 "command": "~/.claude/hooks/filter-test-output.sh"310> "command": "~/.claude/hooks/filter-test-output.sh"

311 }311> }

312 ]312> ]

313 }313> }

314 ]314> ]

315 }315> }

316}316> }

317```317> ```

318 318 

319**filter-test-output.sh**319> [tab] filter-test-output.sh

320 320>

321Хук вызывает этот скрипт. Создайте папку с помощью `mkdir -p ~/.claude/hooks`, сохраните скрипт ниже как `~/.claude/hooks/filter-test-output.sh` и сделайте его исполняемым с помощью `chmod +x ~/.claude/hooks/filter-test-output.sh`. Он проверяет, является ли команда запуском тестов, и изменяет её для отображения только сбоев:321> Хук вызывает этот скрипт. Создайте папку с помощью `mkdir -p ~/.claude/hooks`, сохраните скрипт ниже как `~/.claude/hooks/filter-test-output.sh` и сделайте его исполняемым с помощью `chmod +x ~/.claude/hooks/filter-test-output.sh`. Он проверяет, является ли команда запуском тестов, и изменяет её для отображения только сбоев:

322 322>

323```bash theme={null}323> ```bash theme={null}

324#!/bin/bash324> #!/bin/bash

325input=$(cat)325> input=$(cat)

326cmd=$(echo "$input" | jq -r '.tool_input.command')326> cmd=$(echo "$input" | jq -r '.tool_input.command')

327 327>

328# If running tests, filter to show only failures328> # If running tests, filter to show only failures

329pattern='^(npm test|pytest|go test)( [^;&|<>`$#\\[:cntrl:]]*)?$'329> pattern='^(npm test|pytest|go test)( [^;&|<>`$#\\[:cntrl:]]*)?$'

330if [[ "$cmd" =~ $pattern ]]; then330> if [[ "$cmd" =~ $pattern ]]; then

331 filtered_cmd="$cmd 2>&1 | grep -A 5 -E '(FAIL|ERROR|error:)' | head -100"331> filtered_cmd="$cmd 2>&1 | grep -A 5 -E '(FAIL|ERROR|error:)' | head -100"

332 echo "$input" | jq --arg filtered "$filtered_cmd" \332> echo "$input" | jq --arg filtered "$filtered_cmd" \

333 '{hookSpecificOutput: {hookEventName: "PreToolUse", updatedInput: (.tool_input + {command: $filtered})}}'333> '{hookSpecificOutput: {hookEventName: "PreToolUse", updatedInput: (.tool_input + {command: $filtered})}}'

334else334> else

335 echo "{}"335> echo "{}"

336fi336> fi

337```337> ```

338 338 

339Для проверки настройки запустите `/hooks` и проверьте, что хук появляется под PreToolUse. Вы также можете запустить Claude Code с помощью `claude --debug-file ./claude-debug.txt` и попросить Claude запустить `npm test`. Когда хук переписывает команду, этот лог-файл содержит строку `modified tool input keys`, в которой указаны `command` и другие поля ввода Bash.339Для проверки настройки запустите `/hooks` и проверьте, что хук появляется под PreToolUse. Вы также можете запустить Claude Code с помощью `claude --debug-file ./claude-debug.txt` и попросить Claude запустить `npm test`. Когда хук переписывает команду, этот лог-файл содержит строку `modified tool input keys`, в которой указаны `command` и другие поля ввода Bash.

340 340 

392* **Товарищи-агенты**: каждый активный [товарищ](#agent-team-token-costs) продолжает потреблять токены до выхода392* **Товарищи-агенты**: каждый активный [товарищ](#agent-team-token-costs) продолжает потреблять токены до выхода

393* **Компактность**: `/compact` читает беседу, которую он суммирует, поэтому [компактирование большого контекста](https://code.claude.com/docs/ru/prompt-caching.md#compacting-the-conversation) само по себе является большим запросом. Когда вы хотите свежее начало вместо непрерывности, `/clear` ничего не стоит393* **Компактность**: `/compact` читает беседу, которую он суммирует, поэтому [компактирование большого контекста](https://code.claude.com/docs/ru/prompt-caching.md#compacting-the-conversation) само по себе является большим запросом. Когда вы хотите свежее начало вместо непрерывности, `/clear` ничего не стоит

394 394 

395На плане Pro, Max, Team или Enterprise [разбор `/usage`](#plan-usage-breakdown) рекомендует изменения для поведений, которые составляют 10% или более вашего недавнего использования, таких как длинный контекст или промахи кэша.395Чтобы узнать, что изменить на плане Pro, Max, Ultra, Team или Enterprise, выполните [`/usage`](#plan-usage-breakdown) в промпте Claude Code. Его разбор рекомендует изменения для поведений, которые составляют 10% или более вашего недавнего использования. К таким поведениям относятся длинный контекст и промахи кэша.

396 396 

397## Понимание изменений в поведении Claude Code397## Понимание изменений в поведении Claude Code

398 398 

400 400 

401По вопросам выставления счетов для вашего конкретного аккаунта обратитесь в службу поддержки Anthropic через встроенный мессенджер:401По вопросам выставления счетов для вашего конкретного аккаунта обратитесь в службу поддержки Anthropic через встроенный мессенджер:

402 402 

403* **Планы подписки** (Pro, Max, Team, Enterprise): войдите на [claude.ai](https://claude.ai), нажмите на ваши инициалы в нижнем левом углу и выберите **Get help**403* **Тарифы с подпиской** (Pro, Max, Ultra, Team, Enterprise): войдите на [claude.ai](https://claude.ai), нажмите на ваши инициалы в нижнем левом углу и выберите **Get help**

404* **Выставление счетов Console (API)**: войдите на [platform.claude.com](https://platform.claude.com), нажмите на ваши инициалы и выберите **Get help**404* **Выставление счетов Console (API)**: войдите на [platform.claude.com](https://platform.claude.com), нажмите на ваши инициалы и выберите **Get help**

405 405 

406См. [How to get support](https://support.claude.com/en/articles/9015913-how-to-get-support) для полного процесса, включая информацию о том, кто может связаться с представителем поддержки на каждом плане.406См. [How to get support](https://support.claude.com/en/articles/9015913-how-to-get-support) для полного процесса, включая информацию о том, кто может связаться с представителем поддержки на каждом плане.

data-usage.md +6 −6

Details

10 10 

11### Политика использования данных для обучения11### Политика использования данных для обучения

12 12 

13**Потребительские пользователи (планы Free, Pro и Max)**:13**Потребительские пользователи (планы Free, Pro, Max и Ultra)**:

14Мы даём вам возможность разрешить использование ваших данных для улучшения будущих моделей Claude. Мы будем обучать новые модели, используя данные из учётных записей Free, Pro и Max, когда этот параметр включен (включая случаи, когда вы используете Claude Code из этих учётных записей).14Мы даём вам возможность разрешить использование ваших данных для улучшения будущих моделей Claude. Мы будем обучать новые модели, используя данные из учётных записей Free, Pro, Max и Ultra, когда эта настройка включена (включая случаи, когда вы используете Claude Code из этих учётных записей).

15 15 

16**Коммерческие пользователи**: (планы Team и Enterprise, API, платформы третьих сторон и Claude Gov) сохраняют существующие политики: Anthropic не обучает генеративные модели, используя код или подсказки, отправленные в Claude Code на коммерческих условиях, если только клиент не выбрал предоставить нам свои данные для улучшения модели (например, [Developer Partner Program](https://support.claude.com/ru/articles/11174108-about-the-development-partner-program)).16**Коммерческие пользователи**: (планы Team и Enterprise, API, платформы третьих сторон и Claude Gov) сохраняют существующие политики: Anthropic не обучает генеративные модели, используя код или подсказки, отправленные в Claude Code на коммерческих условиях, если только клиент не выбрал предоставить нам свои данные для улучшения модели (например, [Developer Partner Program](https://support.claude.com/ru/articles/11174108-about-the-development-partner-program)).

17 17 

43 43 

44Anthropic сохраняет данные Claude Code в зависимости от типа вашей учётной записи и предпочтений.44Anthropic сохраняет данные Claude Code в зависимости от типа вашей учётной записи и предпочтений.

45 45 

46**Потребительские пользователи (планы Free, Pro и Max)**:46**Потребительские пользователи (планы Free, Pro, Max и Ultra)**:

47 47 

48* Пользователи, которые разрешают использование данных для улучшения модели: период хранения 5 лет для поддержки разработки модели и улучшения безопасности48* Пользователи, которые разрешают использование данных для улучшения модели: период хранения 5 лет для поддержки разработки модели и улучшения безопасности

49* Пользователи, которые не разрешают использование данных для улучшения модели: период хранения 30 дней49* Пользователи, которые не разрешают использование данных для улучшения модели: период хранения 30 дней

61 61 

62Узнайте больше о практике хранения данных в нашем [Privacy Center](https://privacy.anthropic.com/).62Узнайте больше о практике хранения данных в нашем [Privacy Center](https://privacy.anthropic.com/).

63 63 

64Для получения полной информации, пожалуйста, ознакомьтесь с нашими [Commercial Terms of Service](https://www.anthropic.com/legal/commercial-terms) (для пользователей Team, Enterprise и API) или [Consumer Terms](https://www.anthropic.com/legal/consumer-terms) (для пользователей Free, Pro и Max) и [Privacy Policy](https://www.anthropic.com/legal/privacy).64Для получения полной информации, пожалуйста, ознакомьтесь с нашими [Commercial Terms of Service](https://www.anthropic.com/legal/commercial-terms) (для пользователей Team, Enterprise и API) или [Consumer Terms](https://www.anthropic.com/legal/consumer-terms) (для пользователей Free, Pro, Max и Ultra) и [Privacy Policy](https://www.anthropic.com/legal/privacy).

65 65 

66## Доступ к данным66## Доступ к данным

67 67 

107 107 

108Отчёты об ошибках включены только когда выполняются все эти условия:108Отчёты об ошибках включены только когда выполняются все эти условия:

109 109 

110* вы входите с подпиской Claude Pro или Max110* вы входите с подпиской Claude Pro, Max или Ultra

111* вы используете Claude Code v2.1.198 или позже111* вы используете Claude Code v2.1.198 или позже

112* вы подключаетесь напрямую к Claude API112* вы подключаетесь напрямую к Claude API

113* ваша организация не имеет соглашения о нулевом сохранении данных или HIPAA113* ваша организация не имеет соглашения о нулевом сохранении данных или HIPAA

123| Сервис | Claude API | Google Cloud's Agent Platform API | Amazon Bedrock API | Microsoft Foundry API | Claude Platform on AWS |123| Сервис | Claude API | Google Cloud's Agent Platform API | Amazon Bedrock API | Microsoft Foundry API | Claude Platform on AWS |

124| - | - | - | - | - | - |124| - | - | - | - | - | - |

125| **Metrics** | По умолчанию включено. `DISABLE_TELEMETRY=1` для отключения. | По умолчанию отключено. `CLAUDE_CODE_USE_VERTEX` должен быть 1. | По умолчанию отключено. `CLAUDE_CODE_USE_BEDROCK` должен быть 1. | По умолчанию отключено. `CLAUDE_CODE_USE_FOUNDRY` должен быть 1. | По умолчанию отключено. `CLAUDE_CODE_USE_ANTHROPIC_AWS` должен быть 1. |125| **Metrics** | По умолчанию включено. `DISABLE_TELEMETRY=1` для отключения. | По умолчанию отключено. `CLAUDE_CODE_USE_VERTEX` должен быть 1. | По умолчанию отключено. `CLAUDE_CODE_USE_BEDROCK` должен быть 1. | По умолчанию отключено. `CLAUDE_CODE_USE_FOUNDRY` должен быть 1. | По умолчанию отключено. `CLAUDE_CODE_USE_ANTHROPIC_AWS` должен быть 1. |

126| **Error reports** | По умолчанию включено для подписок Pro и Max на v2.1.198+, в противном случае отключено. `DISABLE_ERROR_REPORTING=1` для отключения. | По умолчанию отключено. `CLAUDE_CODE_USE_VERTEX` должен быть 1. | По умолчанию отключено. `CLAUDE_CODE_USE_BEDROCK` должен быть 1. | По умолчанию отключено. `CLAUDE_CODE_USE_FOUNDRY` должен быть 1. | По умолчанию отключено. `CLAUDE_CODE_USE_ANTHROPIC_AWS` должен быть 1. |126| **Error reports** | Включено при входе с подписками Pro, Max и Ultra на v2.1.198+, в противном случае отключено. `DISABLE_ERROR_REPORTING=1` для отключения. | По умолчанию отключено. `CLAUDE_CODE_USE_VERTEX` должен быть 1. | По умолчанию отключено. `CLAUDE_CODE_USE_BEDROCK` должен быть 1. | По умолчанию отключено. `CLAUDE_CODE_USE_FOUNDRY` должен быть 1. | По умолчанию отключено. `CLAUDE_CODE_USE_ANTHROPIC_AWS` должен быть 1. |

127| **Claude API (`/feedback` reports)** | По умолчанию включено. `DISABLE_FEEDBACK_COMMAND=1` для отключения. | По умолчанию отключено. `CLAUDE_CODE_USE_VERTEX` должен быть 1. | По умолчанию отключено. `CLAUDE_CODE_USE_BEDROCK` должен быть 1. | По умолчанию отключено. `CLAUDE_CODE_USE_FOUNDRY` должен быть 1. | По умолчанию отключено. `CLAUDE_CODE_USE_ANTHROPIC_AWS` должен быть 1. |127| **Claude API (`/feedback` reports)** | По умолчанию включено. `DISABLE_FEEDBACK_COMMAND=1` для отключения. | По умолчанию отключено. `CLAUDE_CODE_USE_VERTEX` должен быть 1. | По умолчанию отключено. `CLAUDE_CODE_USE_BEDROCK` должен быть 1. | По умолчанию отключено. `CLAUDE_CODE_USE_FOUNDRY` должен быть 1. | По умолчанию отключено. `CLAUDE_CODE_USE_ANTHROPIC_AWS` должен быть 1. |

128| **Session quality surveys** | По умолчанию включено. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1` для отключения. | По умолчанию включено. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1` для отключения. | По умолчанию включено. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1` для отключения. | По умолчанию включено. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1` для отключения. | По умолчанию включено. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1` для отключения. |128| **Session quality surveys** | По умолчанию включено. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1` для отключения. | По умолчанию включено. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1` для отключения. | По умолчанию включено. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1` для отключения. | По умолчанию включено. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1` для отключения. | По умолчанию включено. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1` для отключения. |

129| **WebFetch domain safety check** | По умолчанию включено. `skipWebFetchPreflight: true` в [settings](https://code.claude.com/docs/ru/settings.md) для отключения. | По умолчанию включено. `skipWebFetchPreflight: true` в [settings](https://code.claude.com/docs/ru/settings.md) для отключения. | По умолчанию включено. `skipWebFetchPreflight: true` в [settings](https://code.claude.com/docs/ru/settings.md) для отключения. | По умолчанию включено. `skipWebFetchPreflight: true` в [settings](https://code.claude.com/docs/ru/settings.md) для отключения. | По умолчанию включено. `skipWebFetchPreflight: true` в [settings](https://code.claude.com/docs/ru/settings.md) для отключения. |129| **WebFetch domain safety check** | По умолчанию включено. `skipWebFetchPreflight: true` в [settings](https://code.claude.com/docs/ru/settings.md) для отключения. | По умолчанию включено. `skipWebFetchPreflight: true` в [settings](https://code.claude.com/docs/ru/settings.md) для отключения. | По умолчанию включено. `skipWebFetchPreflight: true` в [settings](https://code.claude.com/docs/ru/settings.md) для отключения. | По умолчанию включено. `skipWebFetchPreflight: true` в [settings](https://code.claude.com/docs/ru/settings.md) для отключения. | По умолчанию включено. `skipWebFetchPreflight: true` в [settings](https://code.claude.com/docs/ru/settings.md) для отключения. |

Details

95 95 

96В оболочке, когда ни одна сессия Claude Code не запущена, создайте каталог и перейдите в него:96В оболочке, когда ни одна сессия Claude Code не запущена, создайте каталог и перейдите в него:

97 97 

98**Bash или Zsh**98> [tab] Bash или Zsh

99 99>

100```bash theme={null}100> ```bash theme={null}

101mkdir -p ~/claude-clean/empty && cd ~/claude-clean/empty101> mkdir -p ~/claude-clean/empty && cd ~/claude-clean/empty

102```102> ```

103 

104**PowerShell**

105 103 

106```powershell theme={null}104> [tab] PowerShell

107New-Item -ItemType Directory -Force "$HOME/claude-clean/empty" | Out-Null105>

108Set-Location "$HOME/claude-clean/empty"106> ```powershell theme={null}

109```107> New-Item -ItemType Directory -Force "$HOME/claude-clean/empty" | Out-Null

108> Set-Location "$HOME/claude-clean/empty"

109> ```

110 110 

111**2. Запустите Claude Code с чистым каталогом конфигурации**111**2. Запустите Claude Code с чистым каталогом конфигурации**

112 112 

113В той же оболочке задайте [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/ru/env-vars) на новый каталог вместо `~/.claude` и передайте [`--setting-sources user`](https://code.claude.com/docs/ru/cli-reference#cli-flags), чтобы отключить конфигурацию проекта, такую как `.claude/settings.json`, `CLAUDE.md` и `.mcp.json`:113В той же оболочке задайте [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/ru/env-vars) на новый каталог вместо `~/.claude` и передайте [`--setting-sources user`](https://code.claude.com/docs/ru/cli-reference#cli-flags), чтобы отключить конфигурацию проекта, такую как `.claude/settings.json`, `CLAUDE.md` и `.mcp.json`:

114 114 

115**Bash или Zsh**115> [tab] Bash или Zsh

116 116>

117Переменная применяется только к этому запуску.117> Переменная применяется только к этому запуску.

118 118>

119```bash theme={null}119> ```bash theme={null}

120CLAUDE_CONFIG_DIR=~/claude-clean/config claude --setting-sources user120> CLAUDE_CONFIG_DIR=~/claude-clean/config claude --setting-sources user

121```121> ```

122 

123**PowerShell**

124 

125Переменная остаётся заданной до конца этой сессии PowerShell, поэтому последующие запуски `claude` в том же окне продолжат использовать чистый каталог. Чтобы вернуться к обычному каталогу, выполните `Remove-Item Env:CLAUDE_CONFIG_DIR` перед следующим запуском.

126 122 

127```powershell theme={null}123> [tab] PowerShell

128$env:CLAUDE_CONFIG_DIR = "$HOME/claude-clean/config"124>

129claude --setting-sources user125> Переменная остаётся заданной до конца этой сессии PowerShell, поэтому последующие запуски `claude` в том же окне продолжат использовать чистый каталог. Чтобы вернуться к обычному каталогу, выполните `Remove-Item Env:CLAUDE_CONFIG_DIR` перед следующим запуском.

130```126>

127> ```powershell theme={null}

128> $env:CLAUDE_CONFIG_DIR = "$HOME/claude-clean/config"

129> claude --setting-sources user

130> ```

131 131 

132При первом запуске вы снова пройдёте экраны первоначальной настройки — это признак того, что чистый каталог конфигурации действует. Управляемые настройки по-прежнему применяются, а [коннекторы](https://code.claude.com/docs/ru/mcp.md#use-mcp-servers-from-claude-ai) по-прежнему загружаются, если вы входите с учётной записью claude.ai.132При первом запуске вы снова пройдёте экраны первоначальной настройки — это признак того, что чистый каталог конфигурации действует. Управляемые настройки по-прежнему применяются, а [коннекторы](https://code.claude.com/docs/ru/mcp.md#use-mcp-servers-from-claude-ai) по-прежнему загружаются, если вы входите с учётной записью claude.ai.

133 133 

desktop.md +120 −90

Details

8 8 

9В приложении Claude Desktop Claude Code находится на вкладке **Code**. В приложении также есть чат и [Cowork](https://claude.com/product/cowork), который отвечает за Dispatch и более длительную агентную работу. Эта страница является справочником для вкладки Code.9В приложении Claude Desktop Claude Code находится на вкладке **Code**. В приложении также есть чат и [Cowork](https://claude.com/product/cowork), который отвечает за Dispatch и более длительную агентную работу. Эта страница является справочником для вкладки Code.

10 10 

11> **[Скачать для macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs)**11> [card] [Скачать для macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs)

12>12>

13> Универсальная сборка для Intel и Apple Silicon13> Универсальная сборка для Intel и Apple Silicon

14 14 

15> **[Скачать для Windows](https://claude.ai/api/desktop/win32/x64/setup/latest/redirect?utm_source=claude_code\&utm_medium=docs)**15> [card] [Скачать для Windows](https://claude.ai/api/desktop/win32/x64/setup/latest/redirect?utm_source=claude_code\&utm_medium=docs)

16>16>

17> Для процессоров x6417> Для процессоров x64

18 18 

19> **[Получить Claude для Linux (бета)](https://code.claude.com/docs/ru/desktop-linux.md)**19> [card] [Получить Claude для Linux (бета)](https://code.claude.com/docs/ru/desktop-linux.md)

20>20>

21> apt или .deb для Ubuntu и Debian21> apt или .deb для Ubuntu и Debian

22 22 

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

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

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

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

96 96 

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

98 98 

320 320 

321> [!NOTE]321> [!NOTE]

322>322>

323> Использование компьютера — это research preview на macOS и Windows, который требует плана Pro или Max. Он недоступен на планах Team или Enterprise. Приложение Claude Desktop должно быть запущено. На macOS для использования компьютера требуется macOS 14 или более поздней версии.323> Использование компьютера — это research preview на macOS и Windows, который требует плана Pro, Max или Ultra. Он недоступен на планах Team или Enterprise. Приложение Claude Desktop должно быть запущено. На macOS для использования компьютера требуется macOS 14 или более поздней версии.

324 324 

325Использование компьютера отключено по умолчанию. [Включите его в Settings](#enable-computer-use) перед тем, как Claude сможет управлять вашим экраном. На macOS вам также нужно предоставить разрешения Accessibility и Screen Recording.325Использование компьютера отключено по умолчанию. [Включите его в Settings](#enable-computer-use) перед тем, как Claude сможет управлять вашим экраном. На macOS вам также нужно предоставить разрешения Accessibility и Screen Recording.

326 326 

362* **Windows**: переключатель вступает в силу немедленно, и настройка завершена362* **Windows**: переключатель вступает в силу немедленно, и настройка завершена

363* **macOS**: перейдите к следующему шагу363* **macOS**: перейдите к следующему шагу

364 364 

365Если вы не видите переключатель, подтвердите, что вы на macOS или Windows с планом Pro или Max, затем обновите и перезагрузите приложение.365Если вы не видите переключатель, убедитесь, что вы на macOS или Windows с планом Pro, Max или Ultra, затем обновите и перезагрузите приложение.

366 366 

367**3. Предоставление разрешений macOS**367**3. Предоставление разрешений macOS**

368 368 

562 562 

563#### Настройка Dispatch563#### Настройка Dispatch

564 564 

565Сведения о настройке, сопряжении и параметрах Dispatch см. в [статье справки Dispatch](https://support.claude.com/en/articles/13947068). Dispatch требует плана Pro или Max и недоступен на планах Team или Enterprise.565* **Планы**: для Dispatch требуется план Pro, Max или Ultra; Dispatch недоступен на планах Team или Enterprise

566* **Настройка, сопряжение и параметры Dispatch**: см. [статью справки Dispatch](https://support.claude.com/en/articles/13947068)

566 567 

567Dispatch — это один из нескольких способов работы с Claude, когда вы находитесь вдали от своего терминала. Сравнение с другими вариантами см. в разделе [Платформы и интеграции](https://code.claude.com/docs/ru/platforms.md#work-when-you-are-away-from-your-terminal).568Dispatch — это один из нескольких способов работы с Claude, когда вы находитесь вдали от своего терминала. Сравнение с другими вариантами см. в разделе [Платформы и интеграции](https://code.claude.com/docs/ru/platforms.md#work-when-you-are-away-from-your-terminal).

568 569 

738 739 

739Эти конфигурации показывают общие установки для разных типов проектов:740Эти конфигурации показывают общие установки для разных типов проектов:

740 741 

741**Next.js**742> [tab] Next.js

742 743>

743Эта конфигурация запускает приложение Next.js, используя Yarn на порту 3000:744> Эта конфигурация запускает приложение Next.js, используя Yarn на порту 3000:

744 745>

745```json theme={null}746> ```json theme={null}

746{747> {

747 "version": "0.0.1",748> "version": "0.0.1",

748 "configurations": [749> "configurations": [

749 {750> {

750 "name": "web",751> "name": "web",

751 "runtimeExecutable": "yarn",752> "runtimeExecutable": "yarn",

752 "runtimeArgs": ["dev"],753> "runtimeArgs": ["dev"],

753 "port": 3000754> "port": 3000

754 }755> }

755 ]756> ]

756}757> }

757```758> ```

758 759 

759**Multiple servers**760> [tab] Multiple servers

760 761>

761Для монорепо с фронтенд и API-сервером определите несколько конфигураций. Фронтенд использует `autoPort: true`, поэтому он выбирает свободный порт, если 3000 занят, в то время как API-сервер требует порт 8080 точно:762> Для монорепо с фронтенд и API-сервером определите несколько конфигураций. Фронтенд использует `autoPort: true`, поэтому он выбирает свободный порт, если 3000 занят, в то время как API-сервер требует порт 8080 точно:

762 763>

763```json theme={null}764> ```json theme={null}

764{765> {

765 "version": "0.0.1",766> "version": "0.0.1",

766 "configurations": [767> "configurations": [

767 {768> {

768 "name": "frontend",769> "name": "frontend",

769 "runtimeExecutable": "npm",770> "runtimeExecutable": "npm",

770 "runtimeArgs": ["run", "dev"],771> "runtimeArgs": ["run", "dev"],

771 "cwd": "apps/web",772> "cwd": "apps/web",

772 "port": 3000,773> "port": 3000,

773 "autoPort": true774> "autoPort": true

774 },775> },

775 {776> {

776 "name": "api",777> "name": "api",

777 "runtimeExecutable": "npm",778> "runtimeExecutable": "npm",

778 "runtimeArgs": ["run", "start"],779> "runtimeArgs": ["run", "start"],

779 "cwd": "server",780> "cwd": "server",

780 "port": 8080,781> "port": 8080,

781 "env": { "NODE_ENV": "development" },782> "env": { "NODE_ENV": "development" },

782 "autoPort": false783> "autoPort": false

783 }784> }

784 ]785> ]

785}786> }

786```787> ```

787 788 

788**Node.js script**789> [tab] Node.js script

789 790>

790Чтобы запустить скрипт Node.js напрямую вместо использования команды менеджера пакетов, используйте поле `program`:791> Чтобы запустить скрипт Node.js напрямую вместо использования команды менеджера пакетов, используйте поле `program`:

791 792>

792```json theme={null}793> ```json theme={null}

793{794> {

794 "version": "0.0.1",795> "version": "0.0.1",

795 "configurations": [796> "configurations": [

796 {797> {

797 "name": "server",798> "name": "server",

798 "program": "server.js",799> "program": "server.js",

799 "args": ["--verbose"],800> "args": ["--verbose"],

800 "port": 4000801> "port": 4000

801 }802> }

802 ]803> ]

803}804> }

804```805> ```

805 806 

806## Конфигурация окружения807## Конфигурация окружения

807 808 

1327* **Workflows**: Desktop проверяет каждый новый [workflow](https://code.claude.com/docs/ru/workflows.md) перед его запуском, поэтому, пока Desktop отключён, новый workflow ожидает до 10 минут, а затем завершается ошибкой1328* **Workflows**: Desktop проверяет каждый новый [workflow](https://code.claude.com/docs/ru/workflows.md) перед его запуском, поэтому, пока Desktop отключён, новый workflow ожидает до 10 минут, а затем завершается ошибкой

1328* **MCP-серверы**: MCP-серверы, которые Claude Code запускает на удалённой машине, работают не через Desktop, поэтому Claude по-прежнему может вызывать их инструменты. Серверы из `claude_desktop_config.json` относятся к ним, только если Desktop не использует свой [встроенный SSH-клиент](#worktree-edits-while-disconnected). В противном случае, а также на [некоторых удалённых машинах с Windows](#windows-remote-machines), Claude не может вызывать их инструменты, пока Desktop отключён.1329* **MCP-серверы**: MCP-серверы, которые Claude Code запускает на удалённой машине, работают не через Desktop, поэтому Claude по-прежнему может вызывать их инструменты. Серверы из `claude_desktop_config.json` относятся к ним, только если Desktop не использует свой [встроенный SSH-клиент](#worktree-edits-while-disconnected). В противном случае, а также на [некоторых удалённых машинах с Windows](#windows-remote-machines), Claude не может вызывать их инструменты, пока Desktop отключён.

1329 1330 

1330> **Когда изменения в worktree продолжают работать**1331> [accordion] Когда изменения в worktree продолжают работать

1331>1332>

1332> На удалённой машине с Linux или macOS проверка не проходит через Desktop, поэтому изменения внутри worktree продолжают работать, пока Desktop отключён. До Claude Desktop v2.37337.0 это справедливо только для удалённой машины с Linux.1333> На удалённой машине с Linux или macOS проверка не проходит через Desktop, поэтому изменения внутри worktree продолжают работать, пока Desktop отключён. До Claude Desktop v2.37337.0 это справедливо только для удалённой машины с Linux.

1333>1334>

1368* **Запомненный пароль**: пароль, который вы разрешили Desktop запомнить, тоже работает без запроса, но для длительного отсутствия предпочтительнее ключ, хранящийся в вашем SSH-агенте. Если входы с этим паролем прерываются или зависают, Desktop может прекратить попытки переподключения и ждать вас.1369* **Запомненный пароль**: пароль, который вы разрешили Desktop запомнить, тоже работает без запроса, но для длительного отсутствия предпочтительнее ключ, хранящийся в вашем SSH-агенте. Если входы с этим паролем прерываются или зависают, Desktop может прекратить попытки переподключения и ждать вас.

1369* **Любой другой запрос**: если удалённая машина запрашивает что-то ещё, например одноразовый код, вы можете получить уведомление на компьютере. Нажмите на уведомление или отправьте сообщение в сессии, и Desktop покажет запрос.1370* **Любой другой запрос**: если удалённая машина запрашивает что-то ещё, например одноразовый код, вы можете получить уведомление на компьютере. Нажмите на уведомление или отправьте сообщение в сессии, и Desktop покажет запрос.

1370 1371 

1371> **Если jump-хост запрашивает вход, перебой длительный, часть вывода отсутствует или процесс исчез**1372> [accordion] Если jump-хост запрашивает вход, перебой длительный, часть вывода отсутствует или процесс исчез

1372>1373>

1373> * **Jump-хост, push-уведомления прекращаются в ваше отсутствие**: это может происходить с Desktop на macOS или Linux, когда никто не отвечает на запрос входа jump-хоста, например push-уведомление на телефон. Тогда Desktop прекращает попытки переподключения, пока за компьютером никого нет. Когда вы разблокируете компьютер или начнёте им пользоваться, вы можете получить ещё одно push-уведомление, потому что Desktop может повторить попытку. После трёх попыток без ответа он ждёт, пока вы не повторите попытку или не отправите сообщение.1374> * **Jump-хост, push-уведомления прекращаются в ваше отсутствие**: это может происходить с Desktop на macOS или Linux, когда никто не отвечает на запрос входа jump-хоста, например push-уведомление на телефон. Тогда Desktop прекращает попытки переподключения, пока за компьютером никого нет. Когда вы разблокируете компьютер или начнёте им пользоваться, вы можете получить ещё одно push-уведомление, потому что Desktop может повторить попытку. После трёх попыток без ответа он ждёт, пока вы не повторите попытку или не отправите сообщение.

1374> * **Jump-хост, push-уведомления продолжают приходить**: там, где Desktop не может определить, что никто не отвечает, как в случае Desktop на Windows, он продолжает попытки, пока у него есть процесс, к которому можно снова присоединиться, независимо от того, работает ли этот процесс. С каждой попыткой вы можете получать новое push-уведомление. Чтобы прекратить попытки, закройте Desktop, что [может стоить вам выполняющейся задачи](#reopen-a-session-after-you-quit-desktop).1375> * **Jump-хост, push-уведомления продолжают приходить**: там, где Desktop не может определить, что никто не отвечает, как в случае Desktop на Windows, он продолжает попытки, пока у него есть процесс, к которому можно снова присоединиться, независимо от того, работает ли этот процесс. С каждой попыткой вы можете получать новое push-уведомление. Чтобы прекратить попытки, закройте Desktop, что [может стоить вам выполняющейся задачи](#reopen-a-session-after-you-quit-desktop).

1592>1593>

1593> Для подключений с помощью команды требуется Claude Desktop v3.6556.0 или новее на macOS или Linux со входом через аккаунт Claude. Администраторы могут [распространять команды в команде](#distribute-commands-to-your-team).1594> Для подключений с помощью команды требуется Claude Desktop v3.6556.0 или новее на macOS или Linux со входом через аккаунт Claude. Администраторы могут [распространять команды в команде](#distribute-commands-to-your-team).

1594 1595 

1595Каждая запись — это одно подключение с одним хостом в каждый момент времени. Desktop запускает команду только при создании подключения или [замене его хоста](#replace-the-host), а не при каждом подключении. Чтобы одновременно держать две машины, добавьте вторую запись.1596Desktop выполняет команду только при создании подключения или при [создании другой машины](#create-another-machine), а не при каждом подключении. Каждая запись — это одно подключение, которое указывает на хост, последний раз сохранённый Desktop из команды этой записи.

1596 1597 

1597> [!WARNING]1598> [!WARNING]

1598>1599>

1599> Desktop не останавливает и не удаляет машины. Каждая из перечисленных ниже продолжает работать и может продолжать стоить денег, пока вы не удалите её с помощью своего инструмента:1600> Desktop не останавливает и не удаляет машины. Каждая из перечисленных ниже продолжает работать и может продолжать стоить денег, пока вы не удалите её с помощью своего инструмента:

1600>1601>

1601> * Хост, который вы заменили1602> * Машина, на которую указывала запись до того, как вы [создали другую](#create-another-machine)

1602> * Хост записи, которую вы удалили из файла или у которой изменили `id`1603> * Машины записи, которую вы удалили из файла или у которой изменили `id`

1603> * Машина, которую создала ваша команда, но хост которой Desktop не сохранил, например в следующих случаях:1604> * Машина, которую создала ваша команда, но хост которой Desktop не сохранил, например в следующих случаях:

1604> * Команда завершается с ошибкой или превышает лимит времени1605> * Команда завершается с ошибкой или превышает время ожидания

1605> * Desktop не может использовать выведенный хост, его уже использует другое подключение или ваша организация его не разрешает1606> * Desktop не может использовать выведенный хост, его уже использует другое подключение или ваша организация его не разрешает

1606> * Во время выполнения команды вы отменяете её, удаляете её запись, изменяете её `command` или `id` либо закрываете Desktop1607> * Пока команда выполняется, вы отменяете её, удаляете её запись, меняете её `command` или `id` либо закрываете Desktop

1607 1608 

1608Следующий пример добавляет подключение с именем Dev box. Если файла нет, создайте его. Если в нём уже есть настройки, добавьте ключ рядом с ними. Команда `acme-dev create` обозначает ваш собственный инструмент, а `~/project` — папка, которую Desktop выбирает на каждой машине, созданной вашей командой:1609Следующий пример добавляет подключение с именем Dev box. Если файла нет, создайте его. Если в нём уже есть настройки, добавьте ключ рядом с ними. Команда `acme-dev create` обозначает ваш собственный инструмент, а `~/project` — папка, которую Desktop выбирает на каждой машине, созданной вашей командой:

1609 1610 

1624 1625 

1625| Поле | Значение |1626| Поле | Значение |

1626| :- | :- |1627| :- | :- |

1627| `id` | До 64 символов: ASCII-буквы, цифры, `.`, `_` и `-`, начиная с буквы или цифры. Используйте `id`, которого нет ни у одной другой записи в `sshHostCommands` или [`sshConfigs`](#pre-configure-ssh-connections-for-your-team). Desktop хранит хост подключения под этим идентификатором, поэтому если вы его измените, подключение начнётся заново без хоста, а старая машина продолжит работать. |1628| `id` | До 64 ASCII-букв, цифр, `.`, `_` и `-`, начиная с буквы или цифры. Используйте `id`, которого нет ни у одной другой записи в `sshHostCommands` или [`sshConfigs`](#pre-configure-ssh-connections-for-your-team). Desktop хранит хост подключения под этим `id`, поэтому при его изменении подключение начинается заново без хоста, его машины продолжают работать, и Desktop [всё ещё может к ним подключаться](#remove-an-entry). |

1628| `name` | Имя подключения в селекторе окружения, до 200 символов в одну строку |1629| `name` | Имя подключения в селекторе окружения, до 200 символов в одну строку |

1629| `command` | Программа и её аргументы, как описано в разделе [Написание команды](#write-the-command) |1630| `command` | Программа и её аргументы, как описано в разделе [Написание команды](#write-the-command) |

1630| `sshIdentityFile` | Путь к вашему закрытому ключу, например `~/.ssh/id_ed25519`. Не указывайте его, чтобы использовать вашу конфигурацию SSH или SSH-агент. |1631| `sshIdentityFile` | Путь к вашему закрытому ключу, например `~/.ssh/id_ed25519`. Не указывайте его, чтобы использовать вашу конфигурацию SSH или SSH-агент. |

1677 1678 

1678Не отключайте проверку ключей для этих хостов и храните для них файл `known_hosts`. Если `StrictHostKeyChecking` имеет значение `no` или `accept-new`, а `UserKnownHostsFile` при этом — `/dev/null` или `none`, ключ нигде не записывается. Тогда, если ваш инструмент повторно использует имя, вы можете подключиться к другой машине без предупреждения.1679Не отключайте проверку ключей для этих хостов и храните для них файл `known_hosts`. Если `StrictHostKeyChecking` имеет значение `no` или `accept-new`, а `UserKnownHostsFile` при этом — `/dev/null` или `none`, ключ нигде не записывается. Тогда, если ваш инструмент повторно использует имя, вы можете подключиться к другой машине без предупреждения.

1679 1680 

1680##### Замена хоста1681Повторно использованное имя важно и тогда, когда за компьютером никого нет, потому что Desktop подключается к этим хостам сам. Например, он доставляет сообщение, отправленное, пока хост был недоступен, как только хост отвечает. Даже при включённой проверке ключей хоста сообщение в следующих случаях может попасть на новую машину с этим именем, поэтому [прекратите использование машины](#stop-using-a-machine) до её удаления:

1682 

1683* Вы, ваша команда или другая программа добавили новый ключ в `known_hosts` или удалили строку со старым ключом, как это делает ваша команда, если она добавляет ключи хоста

1684* Машины вашего инструмента используют общий ключ хоста

1685* Машины вашего инструмента используют общий центр сертификации, которому доверяет `known_hosts`

1686* Вы или ваш администратор задали `KnownHostsCommand` или `VerifyHostKeyDNS yes`, поэтому SSH принимает ключи не из `known_hosts`

1687 

1688##### Создание другой машины

1689 

1690Ваши сессии на прежних машинах продолжают работать после выбора **Create another Dev box**, а новые сессии используют новую машину. Выберите этот пункт в селекторе окружения, чтобы создать новую машину или заменить исчезнувшую. На странице новой сессии его также предлагает сообщение о том, что Desktop не может связаться с хостом.

1681 1691 

1682Как только у Dev box появляется хост, селектор показывает Dev box среди ваших SSH-подключений, а **Create Dev box** превращается в **Replace Dev box's host**. Если этого пункта нет в списке, загляните в **More**.1692* **Сессии на прежних машинах**: продолжайте их из боковой панели, потому что селектор показывает текущую машину Dev box, а не прежние. Desktop может подключаться к их машинам сам, например при запуске Desktop, поэтому [прекратите использование машины](#stop-using-a-machine), когда она вам больше не нужна.

1693* **Хост, заменённый до Claude Desktop v4.4212.0**: эти версии показывают **Replace Dev box's host** и перестают подключаться к заменённому хосту. Чтобы продолжить сессию на этом хосте, откройте сессию, выберите **Add SSH connection** и сохраните подключение, которое заполнит Desktop. Обновите Desktop, прежде чем заменять другой хост.

1694* **Новые сессии на двух машинах**: добавьте вторую запись в [`sshHostCommands`](#create-an-ssh-connection-from-a-command)

1695* **Новый хост, который ещё не отвечает**: оставьте страницу новой сессии открытой на срок до 10 минут, пока она продолжает пытаться подключиться. Если хост по-прежнему не отвечает, выберите **Create another Dev box** в сообщении на странице.

1696* **Ещё одна машина вскоре после этого**: после нескольких запусков команды в течение часа подтверждайте каждый следующий запуск в диалоге, который открывает Desktop и в котором показана команда

1683 1697 

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

1685 1699 

1686* **Новый хост**: пункт неактивен в течение 10 минут после того, как Desktop сохранит хост, потому что новой машине может потребоваться время на запуск. Пока новый хост не отвечает, страница новой сессии продолжает пытаться подключиться в течение этих 10 минут.1700Чтобы Desktop перестал сам подключаться к машине, созданной командой, архивируйте каждую сессию на этой машине:

1687* **Сессии на старом хосте**: они остаются на нём, и Desktop не подключается к этому хосту, пока вы не добавите его обратно. Чтобы продолжить такую сессию, откройте её и выберите **Add SSH connection**. Desktop подставит старый хост. Сохраните его как отдельное подключение.1701 

17021. Найдите сессии машины в боковой панели. [Панель сведений](#see-session-details) сессии показывает хост, на котором она выполняется.

17032. [Архивируйте каждую сессию](#archive-a-session) и не разархивируйте её.

17043. Если после создания этой машины вы не создавали другую машину из той же записи `sshHostCommands`, [создайте её](#create-another-machine) или [удалите запись](#remove-an-entry). До этого машина остаётся сохранённым подключением записи, и Desktop может подключиться к ней, когда вы открываете страницу новой сессии с выбранным этим подключением.

17054. Удалите в приложении любое другое SSH-подключение к этой машине или удалите её запись в [`sshConfigs`](#pre-configure-ssh-connections-for-your-team).

17065. Закройте и снова откройте Desktop — это закроет его подключение к машине и прекратит попытки связаться с ней.

17076. Удалите машину своим инструментом.

1708 

1709##### Удаление записи

1710 

1711После удаления записи из файла настроек или изменения её `id` сессии на её машинах остаются, поэтому Desktop всё ещё может подключаться к этим машинам. Он может делать это, даже когда за компьютером никого нет, например чтобы снова присоединиться к запущенному процессу сессии или доставить сообщение, ожидающее отправки. Чтобы это прекратить, архивируйте сессии, как описано в разделе [Прекращение использования машины](#stop-using-a-machine).

1712 

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

1688 1714 

1689##### Распространение команд в команде1715##### Распространение команд в команде

1690 1716 

1711* **`id`**: если у записи `sshHostCommands` пользователя ваш `id`, работает только ваша. Если он есть у любого другого SSH-подключения, например в `sshConfigs` пользователя, ваша запись неактивна. Выберите `id`, который пользователи вряд ли выберут.1737* **`id`**: если у записи `sshHostCommands` пользователя ваш `id`, работает только ваша. Если он есть у любого другого SSH-подключения, например в `sshConfigs` пользователя, ваша запись неактивна. Выберите `id`, который пользователи вряд ли выберут.

1712* **Программа**: укажите её полный путь, потому что голое имя Desktop ищет в собственном `PATH` каждого пользователя. Программа выполняется от имени пользователя с переменными, которые экспортирует его оболочка входа.1738* **Программа**: укажите её полный путь, потому что голое имя Desktop ищет в собственном `PATH` каждого пользователя. Программа выполняется от имени пользователя с переменными, которые экспортирует его оболочка входа.

1713* **Собственные записи пользователей**: Desktop обрабатывает запись пользователя как [хук](https://code.claude.com/docs/ru/hooks.md), потому что в обоих случаях на компьютере запускается программа. Чтобы разрешить только ваши записи, задайте для [`strictPluginOnlyCustomization`](https://code.claude.com/docs/ru/settings-reference#strictpluginonlycustomization) значение `["hooks"]` или добавьте `"hooks"` в его список. Это также отключает хуки Claude Code из пользовательских, проектных и локальных настроек без возможности их сохранить. Если вместо этого задать для этого ключа или для [`allowManagedHooksOnly`](https://code.claude.com/docs/ru/settings-reference#allowmanagedhooksonly) значение `true`, блокируется больше, как указано в описании каждого ключа.1739* **Собственные записи пользователей**: Desktop обрабатывает запись пользователя как [хук](https://code.claude.com/docs/ru/hooks.md), потому что в обоих случаях на компьютере запускается программа. Чтобы разрешить только ваши записи, задайте для [`strictPluginOnlyCustomization`](https://code.claude.com/docs/ru/settings-reference#strictpluginonlycustomization) значение `["hooks"]` или добавьте `"hooks"` в его список. Это также отключает хуки Claude Code из пользовательских, проектных и локальных настроек без возможности их сохранить. Если вместо этого задать для этого ключа или для [`allowManagedHooksOnly`](https://code.claude.com/docs/ru/settings-reference#allowmanagedhooksonly) значение `true`, блокируется больше, как указано в описании каждого ключа.

1714* **Все записи**: чтобы отключить и ваши записи, задайте [`disableAllHooks`](https://code.claude.com/docs/ru/settings-reference#disableallhooks) в управляемых настройках. Если вы задаёте [`disableDesktopLocalSessions`](https://code.claude.com/docs/ru/settings-reference#disabledesktoplocalsessions) или `sshHostAllowlist`, который не разрешает ни одного хоста, селектор не показывает пунктов **Create** и **Replace**.1740* **Все записи**: чтобы отключить и ваши записи, задайте [`disableAllHooks`](https://code.claude.com/docs/ru/settings-reference#disableallhooks) в управляемых настройках. Если вы задаёте [`disableDesktopLocalSessions`](https://code.claude.com/docs/ru/settings-reference#disabledesktoplocalsessions) или `sshHostAllowlist`, который не разрешает ни одного хоста, селектор не показывает пунктов **Create** или **Create another**.

1715* **Где учитываются блокировки**: для этих записей Desktop считывает `allowManagedHooksOnly`, `strictPluginOnlyCustomization` и `disableAllHooks` из серверных управляемых настроек и из собственного файла или политики компьютера и применяет более строгий результат. Все записи остаются неактивными, пока Desktop не проверит claude.ai на наличие серверных управляемых настроек, даже если у вашей организации их нет.1741* **Где учитываются блокировки**: для этих записей Desktop считывает `allowManagedHooksOnly`, `strictPluginOnlyCustomization` и `disableAllHooks` из серверных управляемых настроек и из собственного файла или политики компьютера и применяет более строгий результат. Все записи остаются неактивными, пока Desktop не проверит claude.ai на наличие серверных управляемых настроек, даже если у вашей организации их нет.

1716* **Разрешённые хосты**: если вы задаёте [`sshHostAllowlist`](#restrict-which-ssh-hosts-users-can-connect-to), убедитесь, что каждому имени хоста, которое выводит ваш инструмент, соответствует шаблон, и не включайте `user@` в шаблон. Desktop проверяет выведенное имя только после выполнения команды, поэтому машина, которую список отклоняет, уже существует, и пользователю приходится удалять её с помощью вашего инструмента. При каждом подключении разрешённый `HostName` также должен соответствовать.1742* **Разрешённые хосты**: если вы задаёте [`sshHostAllowlist`](#restrict-which-ssh-hosts-users-can-connect-to), убедитесь, что каждому имени хоста, которое выводит ваш инструмент, соответствует шаблон, и не включайте `user@` в шаблон. Desktop проверяет выведенное имя только после выполнения команды, поэтому машина, которую список отклоняет, уже существует, и пользователю приходится удалять её с помощью вашего инструмента. При каждом подключении разрешённый `HostName` также должен соответствовать.

1717 1743 

1719 1745 

1720##### Если команда отсутствует или неактивна1746##### Если команда отсутствует или неактивна

1721 1747 

1722Селектор окружения не показывает пунктов **Create** или **Replace** в следующих случаях:1748Селектор окружения не показывает пункт **Create** или **Create another** в следующих случаях:

1723 1749 

1724* **Файл**: `~/.claude/settings.json` содержит [недопустимый JSON или значение, которое отклоняет схема](https://code.claude.com/docs/ru/settings.md#fix-a-broken-settings-file), вы допустили опечатку в ключе или поместили его в настройки проекта. Исправьте файл.1750* **Файл**: `~/.claude/settings.json` содержит [недопустимый JSON или значение, которое отклоняет схема](https://code.claude.com/docs/ru/settings.md#fix-a-broken-settings-file), вы допустили опечатку в ключе или поместили его в настройки проекта. Исправьте файл.

1725* **Платформа и аккаунт**: вы используете Windows или [стороннего провайдера](https://code.claude.com/docs/ru/third-party-integrations.md) вместо аккаунта Claude. Добавьте каждый хост как [SSH-подключение](#ssh-sessions) самостоятельно.1751* **Платформа и аккаунт**: вы используете Windows или [стороннего провайдера](https://code.claude.com/docs/ru/third-party-integrations.md) вместо аккаунта Claude. Добавьте каждый хост как [SSH-подключение](#ssh-sessions) самостоятельно.

1730 1756 

1731* **Ошибка в записи**: исправьте поле или команду, указанные в сообщении. Если `id` уже используется, задайте записи другой.1757* **Ошибка в записи**: исправьте поле или команду, указанные в сообщении. Если `id` уже используется, задайте записи другой.

1732* **Повреждённый файл настроек**: пока ваш собственный файл настроек повреждён, записи администратора могут быть неактивны с сообщением, в котором указан файл. [Исправьте файл](https://code.claude.com/docs/ru/settings.md#fix-a-broken-settings-file).1758* **Повреждённый файл настроек**: пока ваш собственный файл настроек повреждён, записи администратора могут быть неактивны с сообщением, в котором указан файл. [Исправьте файл](https://code.claude.com/docs/ru/settings.md#fix-a-broken-settings-file).

1733* **Новый хост**: вы можете [заменить хост](#replace-the-host), когда ему исполнится 10 минут.1759* **Новый хост**: [**Create another**](#create-another-machine) неактивен в течение одной минуты после того, как Desktop сохраняет хост. Выберите его по прошествии этой минуты. До Claude Desktop v4.4212.0 **Replace Dev box's host** неактивен в течение 10 минут.

1734* **Хуки отключены или ограничены**: ваши собственные записи работают только там, где могут выполняться ваши собственные хуки. Удалите `disableAllHooks` из своих настроек или обратитесь к администратору.1760* **Хуки отключены или ограничены**: ваши собственные записи работают только там, где могут выполняться ваши собственные хуки. Удалите `disableAllHooks` из своих настроек или обратитесь к администратору.

1735* **Настройки ещё загружаются**: все записи неактивны, пока Desktop не загрузит [серверные управляемые настройки](https://code.claude.com/docs/ru/server-managed-settings.md) вашей организации, обычно через несколько секунд после запуска. Если записи остаются неактивными, проверьте подключение к claude.ai.1761* **Настройки ещё загружаются**: все записи неактивны, пока Desktop не загрузит [серверные управляемые настройки](https://code.claude.com/docs/ru/server-managed-settings.md) вашей организации, обычно через несколько секунд после запуска. Если записи остаются неактивными, проверьте подключение к claude.ai.

1736 1762 

1946 1972 

1947Замените заполнитель идентификатором вашей организации claude.ai, который отображается в [настройках администратора claude.ai](https://claude.ai/admin-settings/organization). Это тот же идентификатор, который принимает настройка [`forceLoginOrgUUID`](https://code.claude.com/docs/ru/settings-reference#forceloginorguuid) Claude Code. Примеры для macOS и Windows, задающие этот ключ, см. в разделе [Deploy the Claude Desktop policy](https://claude.com/docs/cowork/hipaa-setup#deploy-the-claude-desktop-policy) руководства по Cowork для организаций, готовых к HIPAA.1973Замените заполнитель идентификатором вашей организации claude.ai, который отображается в [настройках администратора claude.ai](https://claude.ai/admin-settings/organization). Это тот же идентификатор, который принимает настройка [`forceLoginOrgUUID`](https://code.claude.com/docs/ru/settings-reference#forceloginorguuid) Claude Code. Примеры для macOS и Windows, задающие этот ключ, см. в разделе [Deploy the Claude Desktop policy](https://claude.com/docs/cowork/hipaa-setup#deploy-the-claude-desktop-policy) руководства по Cowork для организаций, готовых к HIPAA.

1948 1974 

1975> [!WARNING]

1976>

1977> Проверьте значение `forceLoginOrgUUID` перед развёртыванием. Если этот идентификатор не принадлежит вашей организации, люди из вашей организации не смогут использовать Claude Desktop, если только они не состоят также в организации с этим идентификатором. Чтобы исправить ситуацию, разверните правильный идентификатор и попросите их перезапустить Claude Desktop.

1978 

1949Если вы задаёте `forceLoginMethod` и `forceLoginOrgUUID` в [управляемых настройках](https://code.claude.com/docs/ru/managed-settings.md) Claude Code, экран входа Claude Desktop от этого не меняется.1979Если вы задаёте `forceLoginMethod` и `forceLoginOrgUUID` в [управляемых настройках](https://code.claude.com/docs/ru/managed-settings.md) Claude Code, экран входа Claude Desktop от этого не меняется.

1950 1980 

1951### Требования к доступу к сети1981### Требования к доступу к сети

2055| `--model sonnet` | Выбор модели в строке под полем промпта |2085| `--model sonnet` | Выбор модели в строке под полем промпта |

2056| `--resume`, `--continue` | Нажмите на сессию в боковой панели или введите `/resume` в поле промпта, чтобы продолжить сессию, запущенную из CLI |2086| `--resume`, `--continue` | Нажмите на сессию в боковой панели или введите `/resume` в поле промпта, чтобы продолжить сессию, запущенную из CLI |

2057| `--permission-mode` | Выбор режима в строке под полем промпта |2087| `--permission-mode` | Выбор режима в строке под полем промпта |

2058| `--dangerously-skip-permissions` | Режим обхода разрешений. На тарифах Pro и Max включите «Allow bypass permissions mode» в **Settings > Code** или **Settings > Claude Code**; на тарифах Team и Enterprise им управляет политика организации |2088| `--dangerously-skip-permissions` | Режим обхода разрешений. На тарифах Pro, Max и Ultra включите «Allow bypass permissions mode» в **Settings > Code** или **Settings > Claude Code**; на тарифах Team и Enterprise им управляет политика организации |

2059| `--add-dir` | [Добавьте папки в сессию](#add-folders-to-a-session) в локальных сессиях и сессиях SSH или выберите [несколько репозиториев](#run-long-running-tasks-in-the-cloud) в облачной сессии |2089| `--add-dir` | [Добавьте папки в сессию](#add-folders-to-a-session) в локальных сессиях и сессиях SSH или выберите [несколько репозиториев](#run-long-running-tasks-in-the-cloud) в облачной сессии |

2060| `--allowedTools`, `--disallowedTools` | Эквивалента на уровне сессии нет. Правила разрешений в [файлах настроек](https://code.claude.com/docs/ru/settings.md) по-прежнему применяются. |2090| `--allowedTools`, `--disallowedTools` | Эквивалента на уровне сессии нет. Правила разрешений в [файлах настроек](https://code.claude.com/docs/ru/settings.md) по-прежнему применяются. |

2061| `--verbose` | [Подробный режим просмотра](#switch-view-modes) |2091| `--verbose` | [Подробный режим просмотра](#switch-view-modes) |

2091 2121 

2092| Возможность | CLI | Desktop |2122| Возможность | CLI | Desktop |

2093| - | - | - |2123| - | - | - |

2094| Режимы разрешений | Все режимы, включая `dontAsk` | Manual, Accept edits, Plan и Auto. Режим Bypass permissions появляется в выборе режима после включения: через переключатель в Settings на тарифах Pro и Max или через политику организации на тарифах Team и Enterprise |2124| Режимы разрешений | Все режимы, включая `dontAsk` | Manual, Accept edits, Plan и Auto. Режим Bypass permissions появляется в выборе режима после включения: через переключатель в Settings на тарифах Pro, Max и Ultra или через политику организации на тарифах Team и Enterprise |

2095| [Сторонние провайдеры](https://code.claude.com/docs/ru/third-party-integrations.md) | Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry | По умолчанию API Anthropic. О маршрутизации через шлюз см. [подключение настольного приложения к шлюзу](https://code.claude.com/docs/ru/llm-gateway-connect.md#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). |2125| [Сторонние провайдеры](https://code.claude.com/docs/ru/third-party-integrations.md) | Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry | По умолчанию API Anthropic. О маршрутизации через шлюз см. [подключение настольного приложения к шлюзу](https://code.claude.com/docs/ru/llm-gateway-connect.md#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). |

2096| [MCP-серверы](https://code.claude.com/docs/ru/mcp.md) | Настройка в файлах настроек | Интерфейс коннекторов для локальных сессий и сессий SSH или файлы настроек |2126| [MCP-серверы](https://code.claude.com/docs/ru/mcp.md) | Настройка в файлах настроек | Интерфейс коннекторов для локальных сессий и сессий SSH или файлы настроек |

2097| [Плагины](https://code.claude.com/docs/ru/plugins/overview.md) | Команда `/plugin` | Интерфейс менеджера плагинов |2127| [Плагины](https://code.claude.com/docs/ru/plugins/overview.md) | Команда `/plugin` | Интерфейс менеджера плагинов |

2153Если вы видите `Error 403: Forbidden` или другие сбои аутентификации при использовании вкладки Code:2183Если вы видите `Error 403: Forbidden` или другие сбои аутентификации при использовании вкладки Code:

2154 2184 

21551. Выйдите и снова войдите из меню приложения. Это наиболее частое исправление.21851. Выйдите и снова войдите из меню приложения. Это наиболее частое исправление.

21562. Проверьте, что у вас есть активная платная подписка: Pro, Max, Team или Enterprise.21862. Проверьте, что у вас есть активная платная подписка: Pro, Max, Ultra, Team или Enterprise.

21573. Если CLI работает, но Desktop нет, полностью закройте приложение desktop, не просто закрывайте окно, затем снова откройте и войдите.21873. Если CLI работает, но Desktop нет, полностью закройте приложение desktop, не просто закрывайте окно, затем снова откройте и войдите.

21584. Проверьте ваше интернет-соединение и параметры прокси.21884. Проверьте ваше интернет-соединение и параметры прокси.

2159 2189 

Details

8 8 

9> [!NOTE]9> [!NOTE]

10>10>

11> Панель iOS Simulator находится в публичной бета-версии в Claude Code Desktop на macOS. Она доступна в планах Pro, Max, Team и Enterprise, за исключением организаций Enterprise с включённой конфигурацией HIPAA.11> Панель iOS Simulator находится в публичной бета-версии в Claude Code Desktop на macOS. Она доступна в планах Pro, Max, Ultra, Team и Enterprise, за исключением организаций Enterprise с включённой конфигурацией HIPAA.

12 12 

13Панель iOS Simulator показывает ваше приложение, работающее в Apple iOS Simulator рядом с вашей беседой в Claude Code Desktop. Когда Claude собирает, устанавливает, запускает или проверяет ваше приложение в симуляторе, панель открывается автоматически и транслирует экран устройства в реальном времени. Используйте её, чтобы наблюдать, как Claude запускает и тестирует ваше приложение, или чтобы самостоятельно взаимодействовать с приложением, пока Claude продолжает работать.13Панель iOS Simulator показывает ваше приложение, работающее в Apple iOS Simulator рядом с вашей беседой в Claude Code Desktop. Когда Claude собирает, устанавливает, запускает или проверяет ваше приложение в симуляторе, панель открывается автоматически и транслирует экран устройства в реальном времени. Используйте её, чтобы наблюдать, как Claude запускает и тестирует ваше приложение, или чтобы самостоятельно взаимодействовать с приложением, пока Claude продолжает работать.

14 14 

Details

6 6 

7> Установите настольное приложение Claude, откройте вкладку Code и начните свой первый сеанс Claude Code в папке проекта на вашем компьютере.7> Установите настольное приложение Claude, откройте вкладку Code и начните свой первый сеанс Claude Code в папке проекта на вашем компьютере.

8 8 

9Настольное приложение предоставляет вам Claude Code с графическим интерфейсом. Вы можете попросить Claude работать с кодом в папке на вашем компьютере и просматривать его изменения без использования терминала.9Настольное приложение предоставляет вам Claude Code с графическим интерфейсом. Вы можете попросить Claude работать с кодом в папке на вашем компьютере, а затем самостоятельно просмотреть изменения без использования терминала.

10 10 

11Claude Code находится на вкладке **Code** в верхней части боковой панели приложения. На этой странице описывается установка приложения и начало вашей первой сессии на этой вкладке. Claude Code требует [подписку Pro, Max, Team или Enterprise](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=desktop_quickstart_pricing).11Claude Code находится на вкладке **Code** в верхней части боковой панели приложения. На этой странице описывается установка приложения и начало вашей первой сессии на этой вкладке. Claude Code требует [подписку Pro, Max, Ultra, Team или Enterprise](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=desktop_quickstart_pricing).

12 12 

13> **[Скачать для macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs)**13> [card] [Скачать для macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs)

14>14>

15> Универсальная сборка для Intel и Apple Silicon15> Универсальная сборка для Intel и Apple Silicon

16 16 

17> **[Скачать для Windows](https://claude.ai/api/desktop/win32/x64/setup/latest/redirect?utm_source=claude_code\&utm_medium=docs)**17> [card] [Скачать для Windows](https://claude.ai/api/desktop/win32/x64/setup/latest/redirect?utm_source=claude_code\&utm_medium=docs)

18>18>

19> Для процессоров x6419> Для процессоров x64

20 20 

21> **[Получить Claude для Linux (бета)](https://code.claude.com/docs/ru/desktop-linux.md)**21> [card] [Получить Claude для Linux (бета)](https://code.claude.com/docs/ru/desktop-linux.md)

22>22>

23> apt или .deb для Ubuntu и Debian23> apt или .deb для Ubuntu и Debian

24 24 

devcontainer.md +1 −1

Details

17> Используйте контейнеры разработки только при разработке с доверенными репозиториями и отслеживайте деятельность Claude.17> Используйте контейнеры разработки только при разработке с доверенными репозиториями и отслеживайте деятельность Claude.

18> Избегайте монтирования хост-секретов, таких как `~/.ssh` или файлы облачных учетных данных, в контейнер; предпочитайте токены с областью действия репозитория или краткосрочные токены.18> Избегайте монтирования хост-секретов, таких как `~/.ssh` или файлы облачных учетных данных, в контейнер; предпочитайте токены с областью действия репозитория или краткосрочные токены.

19 19 

20> **Как контейнеры разработки работают с вашим редактором**20> [accordion] Как контейнеры разработки работают с вашим редактором

21>21>

22> ![Диаграмма, показывающая редактор на хосте, подключающийся к Docker контейнеру разработки. Claude Code, терминал и инструменты сборки работают внутри контейнера. Репозиторий хоста привязан к контейнеру как рабочее пространство.](https://mintcdn.com/claude-code/YvJyjZfd9yMihr0i/images/devcontainer-architecture.svg?fit=max\&auto=format\&n=YvJyjZfd9yMihr0i\&q=85\&s=9017b1d16a446c6cc37ba562f35b9aae)22> ![Диаграмма, показывающая редактор на хосте, подключающийся к Docker контейнеру разработки. Claude Code, терминал и инструменты сборки работают внутри контейнера. Репозиторий хоста привязан к контейнеру как рабочее пространство.](https://mintcdn.com/claude-code/YvJyjZfd9yMihr0i/images/devcontainer-architecture.svg?fit=max\&auto=format\&n=YvJyjZfd9yMihr0i\&q=85\&s=9017b1d16a446c6cc37ba562f35b9aae)

23>23>

env-vars.md +41 −41

Details

23 23 

24Установите переменную перед запуском `claude`:24Установите переменную перед запуском `claude`:

25 25 

26**macOS, Linux, WSL**26> [tab] macOS, Linux, WSL

27 27>

28```bash theme={null}28> ```bash theme={null}

29export API_TIMEOUT_MS="1200000"29> export API_TIMEOUT_MS="1200000"

30claude30> claude

31```31> ```

32 32>

33Чтобы установить её для каждой сессии, добавьте строку `export` в `~/.bashrc`, `~/.zshrc` или файл профиля вашей оболочки.33> Чтобы установить её для каждой сессии, добавьте строку `export` в `~/.bashrc`, `~/.zshrc` или файл профиля вашей оболочки.

34 

35**Windows PowerShell**

36 

37```powershell theme={null}

38$env:API_TIMEOUT_MS = "1200000"

39claude

40```

41 

42Чтобы установить её для каждой сессии, выполните `[Environment]::SetEnvironmentVariable("API_TIMEOUT_MS", "1200000", "User")` и откройте новый терминал.

43 

44**Windows CMD**

45 34 

46```batch theme={null}35> [tab] Windows PowerShell

47set API_TIMEOUT_MS=120000036>

48claude37> ```powershell theme={null}

49```38> $env:API_TIMEOUT_MS = "1200000"

39> claude

40> ```

41>

42> Чтобы установить её для каждой сессии, выполните `[Environment]::SetEnvironmentVariable("API_TIMEOUT_MS", "1200000", "User")` и откройте новый терминал.

50 43 

51Чтобы установить её для каждой сессии, выполните `setx API_TIMEOUT_MS "1200000"` и откройте новый терминал.44> [tab] Windows CMD

45>

46> ```batch theme={null}

47> set API_TIMEOUT_MS=1200000

48> claude

49> ```

50>

51> Чтобы установить её для каждой сессии, выполните `setx API_TIMEOUT_MS "1200000"` и откройте новый терминал.

52 52 

53Строка присваивания ничего не выводит при успехе. Чтобы подтвердить, что переменная установлена, выведите её в той же оболочке:53Строка присваивания ничего не выводит при успехе. Чтобы подтвердить, что переменная установлена, выведите её в той же оболочке:

54 54 

55**macOS, Linux, WSL**55> [tab] macOS, Linux, WSL

56 56>

57```bash theme={null}57> ```bash theme={null}

58echo $API_TIMEOUT_MS58> echo $API_TIMEOUT_MS

59```59> ```

60 

61**Windows PowerShell**

62 

63```powershell theme={null}

64echo $env:API_TIMEOUT_MS

65```

66 60 

67**Windows CMD**61> [tab] Windows PowerShell

62>

63> ```powershell theme={null}

64> echo $env:API_TIMEOUT_MS

65> ```

68 66 

69```batch theme={null}67> [tab] Windows CMD

70echo %API_TIMEOUT_MS%68>

71```69> ```batch theme={null}

70> echo %API_TIMEOUT_MS%

71> ```

72 72 

73### Установка переменных в файлах настроек73### Установка переменных в файлах настроек

74 74 

130 130 

131| Переменная | Назначение |131| Переменная | Назначение |

132| :- | :- |132| :- | :- |

133| `ANTHROPIC_API_KEY` | API-ключ, отправляемый в заголовке `X-Api-Key`. Если он задан, этот ключ используется вместо вашей подписки Claude Pro, Max, Team или Enterprise, даже если вы вошли в систему. В неинтерактивном режиме (`-p`) ключ всегда используется, если он присутствует. В интерактивном режиме вам один раз будет предложено подтвердить ключ, прежде чем он переопределит вашу подписку. Чтобы вместо этого использовать подписку, выполните `unset ANTHROPIC_API_KEY` |133| `ANTHROPIC_API_KEY` | API-ключ, отправляемый в заголовке `X-Api-Key`. Если он задан, этот ключ используется вместо вашей подписки Claude Pro, Max, Ultra, Team или Enterprise, даже если вы вошли в систему. В неинтерактивном режиме (`-p`) ключ всегда используется, если он присутствует. В интерактивном режиме вам будет один раз предложено подтвердить ключ, прежде чем он переопределит вашу подписку. Чтобы вместо этого использовать подписку, выполните `unset ANTHROPIC_API_KEY` |

134| `ANTHROPIC_AUTH_TOKEN` | Пользовательское значение для заголовка `Authorization` (к заданному здесь значению будет добавлен префикс `Bearer `) |134| `ANTHROPIC_AUTH_TOKEN` | Пользовательское значение для заголовка `Authorization` (к заданному здесь значению будет добавлен префикс `Bearer `) |

135| `ANTHROPIC_AWS_API_KEY` | API-ключ рабочего пространства для [Claude Platform on AWS](https://code.claude.com/docs/ru/claude-platform-on-aws.md), созданный в AWS Console. Отправляется как `x-api-key` и имеет приоритет над AWS SigV4 |135| `ANTHROPIC_AWS_API_KEY` | API-ключ рабочего пространства для [Claude Platform on AWS](https://code.claude.com/docs/ru/claude-platform-on-aws.md), созданный в AWS Console. Отправляется как `x-api-key` и имеет приоритет над AWS SigV4 |

136| `ANTHROPIC_AWS_BASE_URL` | Переопределяет URL эндпоинта [Claude Platform on AWS](https://code.claude.com/docs/ru/claude-platform-on-aws.md). Используйте для пользовательских регионов или при маршрутизации через [LLM-шлюз](https://code.claude.com/docs/ru/llm-gateway). По умолчанию `https://aws-external-anthropic.{region}.api.aws`. Claude Code определяет регион с [тем же приоритетом, что и в Amazon Bedrock](https://code.claude.com/docs/ru/amazon-bedrock.md#3-configure-claude-code) |136| `ANTHROPIC_AWS_BASE_URL` | Переопределяет URL эндпоинта [Claude Platform on AWS](https://code.claude.com/docs/ru/claude-platform-on-aws.md). Используйте для пользовательских регионов или при маршрутизации через [LLM-шлюз](https://code.claude.com/docs/ru/llm-gateway). По умолчанию `https://aws-external-anthropic.{region}.api.aws`. Claude Code определяет регион с [тем же приоритетом, что и в Amazon Bedrock](https://code.claude.com/docs/ru/amazon-bedrock.md#3-configure-claude-code) |

575* [Отправлять сообщения в сессии за пределами этой машины](https://code.claude.com/docs/ru/cross-session-messaging.md#message-sessions-on-other-machines), когда [Remote Control](https://code.claude.com/docs/ru/remote-control.md#requirements) недоступен. Обмен сообщениями между сессиями на этой машине работает и при отключённой загрузке575* [Отправлять сообщения в сессии за пределами этой машины](https://code.claude.com/docs/ru/cross-session-messaging.md#message-sessions-on-other-machines), когда [Remote Control](https://code.claude.com/docs/ru/remote-control.md#requirements) недоступен. Обмен сообщениями между сессиями на этой машине работает и при отключённой загрузке

576* Запустить [`claude import` или команду `/import`](https://code.claude.com/docs/ru/cli-reference#cli-commands)576* Запустить [`claude import` или команду `/import`](https://code.claude.com/docs/ru/cli-reference#cli-commands)

577* Запустить [`/skill-doctor`](https://code.claude.com/docs/ru/skills#find-unused-skills) или открыть его отчёт на вкладке **Stats** в `/plugin`577* Запустить [`/skill-doctor`](https://code.claude.com/docs/ru/skills#find-unused-skills) или открыть его отчёт на вкладке **Stats** в `/plugin`

578* Запустить [`/restart`](https://code.claude.com/docs/ru/commands) на тарифах Pro и Max578* Запустить [`/restart`](https://code.claude.com/docs/ru/commands) на тарифах Pro, Max и Ultra

579* Синхронизировать [скиллы](https://code.claude.com/docs/ru/skills.md#where-synced-skills-load) и [плагины](https://code.claude.com/docs/ru/plugins/loading.md#synced-plugins), включённые для вашей учётной записи claude.ai, с вашими сессиями в терминале579* Синхронизировать [скиллы](https://code.claude.com/docs/ru/skills.md#where-synced-skills-load) и [плагины](https://code.claude.com/docs/ru/plugins/loading.md#synced-plugins), включённые для вашей учётной записи claude.ai, с вашими сессиями в терминале

580* Включить [мод You should know](https://code.claude.com/docs/ru/interactive-mode.md#you-should-know-suggestions)580* Включить [мод You should know](https://code.claude.com/docs/ru/interactive-mode.md#you-should-know-suggestions)

581* Использовать [инструмент-советник](https://code.claude.com/docs/ru/advisor.md#requirements)581* Использовать [инструмент-советник](https://code.claude.com/docs/ru/advisor.md#requirements)

errors.md +5 −5

Details

830* На вкладке Code в [Desktop app](https://code.claude.com/docs/ru/desktop.md) карточка session-limit предлагает флажок **Auto-continue when limits reset**. Карточка weekly-limit этого не предлагает. Когда он отмечен, Desktop app повторяет прерванный ход после сброса и показывает время повторной попытки на карточке. Флажок Desktop и настройка **Continue automatically at usage limit** в CLI в `/config` являются отдельными, поэтому отключайте каждую отдельно.830* На вкладке Code в [Desktop app](https://code.claude.com/docs/ru/desktop.md) карточка session-limit предлагает флажок **Auto-continue when limits reset**. Карточка weekly-limit этого не предлагает. Когда он отмечен, Desktop app повторяет прерванный ход после сброса и показывает время повторной попытки на карточке. Флажок Desktop и настройка **Continue automatically at usage limit** в CLI в `/config` являются отдельными, поэтому отключайте каждую отдельно.

831* Для лимита Opus или Sonnet запустите `/model` и переключитесь на модель вне этого семейства, чтобы продолжить работу. Каждая модель имеет свой собственный кэш промптов, поэтому следующий запрос повторно читает весь диалог без попаданий в кэш; см. [Switching models](https://code.claude.com/docs/ru/prompt-caching.md#switching-models)831* Для лимита Opus или Sonnet запустите `/model` и переключитесь на модель вне этого семейства, чтобы продолжить работу. Каждая модель имеет свой собственный кэш промптов, поэтому следующий запрос повторно читает весь диалог без попаданий в кэш; см. [Switching models](https://code.claude.com/docs/ru/prompt-caching.md#switching-models)

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

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

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

835 835 

836Перед тем как окно закончится, Claude Code может предупредить вас, что вы использовали большую его часть, сообщением, таким как `You've used 85% of your session limit · resets 3:45pm`. Чтобы непрерывно отслеживать оставшийся лимит, добавьте поля `rate_limits` в [custom status line](https://code.claude.com/docs/ru/statusline.md#rate-limit-usage), или в Desktop app нажмите [usage ring](https://code.claude.com/docs/ru/desktop.md#check-usage) рядом с выбором модели.836Перед тем как окно закончится, Claude Code может предупредить вас, что вы использовали большую его часть, сообщением, таким как `You've used 85% of your session limit · resets 3:45pm`. Чтобы непрерывно отслеживать оставшийся лимит, добавьте поля `rate_limits` в [custom status line](https://code.claude.com/docs/ru/statusline.md#rate-limit-usage), или в Desktop app нажмите [usage ring](https://code.claude.com/docs/ru/desktop.md#check-usage) рядом с выбором модели.

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

853 853 

854* Запустите `/model` и выберите вариант без суффикса `[1m]`, чтобы вернуться к стандартному контекстному окну854* Запустите `/model` и выберите вариант без суффикса `[1m]`, чтобы вернуться к стандартному контекстному окну

855* Если сообщение называет `/usage-credits`, запустите эту команду, чтобы включить биллинг по факту использования для варианта 1M на Pro и Max, или запросить кредиты использования у администратора на Team и Enterprise. После включения кредитов использования перезапустите Claude Code или начните новую сессию, в зависимости от того, что говорит сообщение. До этого сессия остаётся на стандартном лимите контекста.855* Если сообщение называет `/usage-credits`, запустите эту команду, чтобы включить биллинг по факту использования для варианта 1M на Pro, Max и Ultra, или запросить кредиты использования у администратора на Team и Enterprise. После включения кредитов использования перезапустите Claude Code или начните новую сессию, в зависимости от того, что говорит сообщение. До этого сессия остаётся на стандартном лимите контекста.

856* Если ошибка сохраняется после `/model`, ID модели 1M может быть задан в другом месте. См. [Setting your model](https://code.claude.com/docs/ru/model-config.md#setting-your-model), где перечислены места конфигурации для проверки в порядке приоритета.856* Если ошибка сохраняется после `/model`, ID модели 1M может быть задан в другом месте. См. [Setting your model](https://code.claude.com/docs/ru/model-config.md#setting-your-model), где перечислены места конфигурации для проверки в порядке приоритета.

857* Чтобы полностью удалить варианты 1M из выбора модели, установите [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](https://code.claude.com/docs/ru/env-vars)857* Чтобы полностью удалить варианты 1M из выбора модели, установите [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](https://code.claude.com/docs/ru/env-vars)

858 858 

933 933 

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

935 935 

936* На Pro и Max увеличьте ваш ежемесячный лимит расходов в [**Settings > Usage**](https://claude.ai/settings/usage) на claude.ai или запустите `/usage-credits`936* На Pro, Max и Ultra увеличьте ваш ежемесячный лимит расходов в [**Settings > Usage**](https://claude.ai/settings/usage) на claude.ai или запустите `/usage-credits`

937* На Team и Enterprise увеличьте лимит в [**Organization settings > Usage**](https://claude.ai/admin-settings/usage), если вы управляете биллингом, или попросите администратора. `/usage-credits` отправляет этот запрос вашему администратору за вас937* На Team и Enterprise увеличьте лимит в [**Organization settings > Usage**](https://claude.ai/admin-settings/usage), если вы управляете биллингом, или попросите администратора. `/usage-credits` отправляет этот запрос вашему администратору за вас

938* Для лимита канала попросите владельца организации или менеджера канала повысить его на claude.ai. См. [Per-channel limits](https://claude.com/docs/claude-tag/admins/set-spend-limit#per-channel-limits) в документации Claude Tag938* Для лимита канала попросите владельца организации или менеджера канала повысить его на claude.ai. См. [Per-channel limits](https://claude.com/docs/claude-tag/admins/set-spend-limit#per-channel-limits) в документации Claude Tag

939* Если сообщение называет время сброса окна вашего плана, вы можете вместо этого дождаться его939* Если сообщение называет время сброса окна вашего плана, вы можете вместо этого дождаться его

966 966 

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

968 968 

969* Если у вас план Pro, Max, Team или Enterprise и вы видите это сообщение, запустите `/status` и проверьте строку `API key`. Одобренный `ANTHROPIC_API_KEY` в вашей среде направляет запросы через этот ключ вместо вашей подписки. Удалите его из текущей оболочки и из профиля оболочки, затем перезапустите `claude`. Запустите `/login`, если вы ещё не вошли с вашей подпиской.969* Если у вас план Pro, Max, Ultra, Team или Enterprise и вы видите это сообщение, запустите `/status` и проверьте строку `API key`. Одобренный `ANTHROPIC_API_KEY` в вашей среде направляет запросы через этот ключ вместо вашей подписки. Удалите его из текущей оболочки и из профиля оболочки, затем перезапустите `claude`. Запустите `/login`, если вы ещё не вошли с вашей подпиской.

970* Пополните кредиты на [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing) и рассмотрите возможность включить там автоматическое пополнение, чтобы баланс пополнялся до того, как опустится до нуля970* Пополните кредиты на [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing) и рассмотрите возможность включить там автоматическое пополнение, чтобы баланс пополнялся до того, как опустится до нуля

971* Установите ограничения расходов для рабочих пространств в Console, чтобы один проект не исчерпал баланс организации. См. [Manage costs effectively](https://code.claude.com/docs/ru/costs.md).971* Установите ограничения расходов для рабочих пространств в Console, чтобы один проект не исчерпал баланс организации. См. [Manage costs effectively](https://code.claude.com/docs/ru/costs.md).

972 972 

1120 1120 

1121Подсказка после `·` зависит от ваших сохранённых учётных данных: первая форма появляется, когда сохранённый `/login` может взять управление на себя после сброса ключа, а вторая — когда ключ является вашими единственными учётными данными.1121Подсказка после `·` зависит от ваших сохранённых учётных данных: первая форма появляется, когда сохранённый `/login` может взять управление на себя после сброса ключа, а вторая — когда ключ является вашими единственными учётными данными.

1122 1122 

1123Переменные окружения имеют приоритет над `/login`, поэтому ключ, экспортированный в профиле оболочки или загруженный из файла `.env`, используется даже при наличии работающей подписки Pro или Max. В неинтерактивном режиме (`-p`) ключ всегда используется, если он задан.1123Если вы экспортируете ключ в профиле оболочки или загружаете его из `.env`, Claude Code использует его вместо `/login`, даже при действующей подписке Pro, Max или Ultra. В неинтерактивном режиме (`-p`) ключ всегда используется, если он присутствует.

1124 1124 

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

1126 1126 

fast-mode.md +5 −5

Details

20 20 

21* Используйте `/fast` для включения быстрого режима в Claude Code CLI. Расширение [VS Code](https://code.claude.com/docs/ru/vs-code.md) предлагает команду **Toggle fast mode** при выборе модели, которая поддерживает быстрый режим. Claude Code сохраняет этот переключатель в вашей настройке [`fastMode`](#toggle-fast-mode).21* Используйте `/fast` для включения быстрого режима в Claude Code CLI. Расширение [VS Code](https://code.claude.com/docs/ru/vs-code.md) предлагает команду **Toggle fast mode** при выборе модели, которая поддерживает быстрый режим. Claude Code сохраняет этот переключатель в вашей настройке [`fastMode`](#toggle-fast-mode).

22* Цены на быстрый режим составляют \$8/\$40 за MTok входа/выхода на Opus 5.5 и \$10/\$50 на Opus 5 и Opus 4.8.22* Цены на быстрый режим составляют \$8/\$40 за MTok входа/выхода на Opus 5.5 и \$10/\$50 на Opus 5 и Opus 4.8.

23* Доступно пользователям Claude Code на планах подписки (Pro/Max/Team/Enterprise) и на Claude Console. Организациям Team и Enterprise требуется, чтобы Owner сначала это включил, а организациям Console требуется сначала получить предоставленный доступ, чтобы использовать его с Opus 5 или Opus 4.8. Оба варианта описаны в разделе [Требования](#requirements).23* Доступно пользователям Claude Code на планах подписки (Pro/Max/Ultra/Team/Enterprise) и на Claude Console. Организациям Team и Enterprise требуется, чтобы Owner сначала это включил, а организациям Console требуется сначала получить предоставленный доступ, чтобы использовать его с Opus 5 или Opus 4.8. Оба варианта описаны в разделе [Требования](#requirements).

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

25 25 

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

27 27 

86 86 

87Вы видите расходы быстрого режима в разном месте в зависимости от того, как вы вошли, поэтому сначала запустите [`/status`](https://code.claude.com/docs/ru/commands) для проверки. Если это показывает строку `Login method` такую как `Claude Max account`, вы вошли с подпиской Claude. Если вместо этого это показывает строку `API key`, ваши запросы выставляются в счёт организации Claude Console.87Вы видите расходы быстрого режима в разном месте в зависимости от того, как вы вошли, поэтому сначала запустите [`/status`](https://code.claude.com/docs/ru/commands) для проверки. Если это показывает строку `Login method` такую как `Claude Max account`, вы вошли с подпиской Claude. Если вместо этого это показывает строку `API key`, ваши запросы выставляются в счёт организации Claude Console.

88 88 

89* **Pro и Max**: вы платите за быстрый режим из своих кредитов использования. Перейдите на [**Settings > Usage**](https://claude.ai/settings/usage) на claude.ai, где раздел **Usage credits** показывает, сколько вы потратили в кредитах использования в этом месяце. Эта цифра включает быстрый режим, но не разбивает его отдельно.89* **Pro, Max и Ultra**: вы платите за быстрый режим из своих кредитов использования. Перейдите на [**Settings > Usage**](https://claude.ai/settings/usage) на claude.ai, где раздел **Usage credits** показывает, сколько вы потратили в кредитах использования в этом месяце. Эта цифра включает быстрый режим, но не разбивает его отдельно.

90* **Team и Enterprise**: ваша организация платит за использование быстрого режима из своих кредитов использования. Чтобы увидеть свои расходы в кредитах использования, запустите [`/usage`](https://code.claude.com/docs/ru/costs#check-your-usage-credits-spend). Для того, где ваша организация видит эти расходы, см. [Claude для Teams и Enterprise](https://code.claude.com/docs/ru/costs.md#claude-for-teams-and-enterprise).90* **Team и Enterprise**: ваша организация платит за использование быстрого режима из своих кредитов использования. Чтобы увидеть свои расходы в кредитах использования, запустите [`/usage`](https://code.claude.com/docs/ru/costs#check-your-usage-credits-spend). Для того, где ваша организация видит эти расходы, см. [Claude для Teams и Enterprise](https://code.claude.com/docs/ru/costs.md#claude-for-teams-and-enterprise).

91* **Claude Console**: ваша организация платит за быстрый режим вместе с остальным использованием API. На страницах Console [Usage](https://platform.claude.com/usage) и [Cost](https://platform.claude.com/cost) выберите **Speed (Research Preview)** в меню **Group by** для отделения быстрого режима от использования стандартной скорости. Вы видите эту опцию только когда выбранный диапазон дат включает использование быстрого режима.91* **Claude Console**: ваша организация платит за быстрый режим вместе с остальным использованием API. На страницах Console [Usage](https://platform.claude.com/usage) и [Cost](https://platform.claude.com/cost) выберите **Speed (Research Preview)** в меню **Group by** для отделения быстрого режима от использования стандартной скорости. Вы видите эту опцию только когда выбранный диапазон дат включает использование быстрого режима.

92 92 

120Быстрый режим требует всех следующих условий:120Быстрый режим требует всех следующих условий:

121 121 

122* **Только Anthropic API или подписка**: быстрый режим доступен через Anthropic Console API и для планов подписки Claude с использованием кредитов. Он недоступен на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или Claude Platform на AWS. Организации Console также должны иметь [предоставленный доступ к быстрому режиму](#enable-fast-mode-for-your-organization), чтобы использовать его с Opus 5 или Opus 4.8.122* **Только Anthropic API или подписка**: быстрый режим доступен через Anthropic Console API и для планов подписки Claude с использованием кредитов. Он недоступен на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или Claude Platform на AWS. Организации Console также должны иметь [предоставленный доступ к быстрому режиму](#enable-fast-mode-for-your-organization), чтобы использовать его с Opus 5 или Opus 4.8.

123* **Кредиты использования включены для планов подписки**: на плане Pro, Max, Team или Enterprise в вашей учётной записи должны быть включены [кредиты использования](https://code.claude.com/docs/ru/costs.md#add-usage-credits-to-your-subscription), что позволяет оплату сверх включённого в ваш план использования. До их включения `/fast` сообщает "Fast mode requires usage credits". Способ их включения зависит от вашего плана:123* **Кредиты использования включены для планов подписки**: на плане Pro, Max, Ultra, Team или Enterprise в вашей учётной записи должны быть включены [кредиты использования](https://code.claude.com/docs/ru/costs.md#add-usage-credits-to-your-subscription), что позволяет оплату сверх включённого в ваш план использования. До их включения `/fast` сообщает "Fast mode requires usage credits". Чтобы включить их, выполните шаг для вашего плана:

124 * На Pro и Max включите их в разделе **Usage credits** на странице [**Settings > Usage**](https://claude.ai/settings/usage) на claude.ai или запустите `/usage-credits`, чтобы открыть эту страницу.124 * На Pro, Max и Ultra включите их в разделе **Usage credits** на странице [**Settings > Usage**](https://claude.ai/settings/usage) на claude.ai или запустите `/usage-credits`, чтобы открыть эту страницу.

125 * На Team и Enterprise участник с доступом к биллингу включает их для организации в [**Organization settings > Usage**](https://claude.ai/admin-settings/usage), а участник без такого доступа запускает `/usage-credits`, чтобы отправить запрос администраторам организации.125 * На Team и Enterprise участник с доступом к биллингу включает их для организации в [**Organization settings > Usage**](https://claude.ai/admin-settings/usage), а участник без такого доступа запускает `/usage-credits`, чтобы отправить запрос администраторам организации.

126 126 

127> [!NOTE]127> [!NOTE]

Details

14 14 

15Способ аутентификации определяет, какие функции может использовать Claude Code. Для единого списка того, что отсутствует у вашего поставщика, см. вкладки [сводки по поставщикам](#summary-by-provider). Чтобы найти свой столбец в таблицах:15Способ аутентификации определяет, какие функции может использовать Claude Code. Для единого списка того, что отсутствует у вашего поставщика, см. вкладки [сводки по поставщикам](#summary-by-provider). Чтобы найти свой столбец в таблицах:

16 16 

17* **Подписка Claude**: вы входите с учётной записью claude.ai в плане Pro, Max, Team или Enterprise17* **Подписка Claude**: вы входите с учётной записью claude.ai в плане Pro, Max, Ultra, Team или Enterprise

18* **Anthropic Console**: вы аутентифицируетесь с помощью ключа API Anthropic или [входите в учётную запись Console без ключа](https://code.claude.com/docs/ru/authentication.md#sign-in-without-an-api-key)18* **Anthropic Console**: вы аутентифицируетесь с помощью ключа API Anthropic или [входите в учётную запись Console без ключа](https://code.claude.com/docs/ru/authentication.md#sign-in-without-an-api-key)

19* **Amazon Bedrock**: вы используете модели Claude из каталога моделей Amazon Bedrock и устанавливаете `CLAUDE_CODE_USE_BEDROCK`. [Конечная точка Mantle](https://code.claude.com/docs/ru/amazon-bedrock.md#use-the-mantle-endpoint) (`CLAUDE_CODE_USE_MANTLE`) охватывается этим столбцом19* **Amazon Bedrock**: вы используете модели Claude из каталога моделей Amazon Bedrock и устанавливаете `CLAUDE_CODE_USE_BEDROCK`. [Конечная точка Mantle](https://code.claude.com/docs/ru/amazon-bedrock.md#use-the-mantle-endpoint) (`CLAUDE_CODE_USE_MANTLE`) охватывается этим столбцом

20* **Claude Platform на AWS**: вы приобрели Claude через AWS Marketplace, но вызываете API Anthropic и устанавливаете `CLAUDE_CODE_USE_ANTHROPIC_AWS`20* **Claude Platform на AWS**: вы приобрели Claude через AWS Marketplace, но вызываете API Anthropic и устанавливаете `CLAUDE_CODE_USE_ANTHROPIC_AWS`

46Они требуют входа с учётной записью claude.ai и недоступны с ключом API Anthropic Console или от поставщика третьей стороны:46Они требуют входа с учётной записью claude.ai и недоступны с ключом API Anthropic Console или от поставщика третьей стороны:

47 47 

48* [Облачные сессии](https://code.claude.com/docs/ru/claude-code-on-the-web.md) и Claude Code на мобильном устройстве48* [Облачные сессии](https://code.claude.com/docs/ru/claude-code-on-the-web.md) и Claude Code на мобильном устройстве

49* [Claude Code в Slack](https://code.claude.com/docs/ru/slack.md): планы Pro и Max49* [Claude Code в Slack](https://code.claude.com/docs/ru/slack.md): планы Pro, Max и Ultra

50* [Claude Code Desktop](https://code.claude.com/docs/ru/desktop.md)50* [Claude Code Desktop](https://code.claude.com/docs/ru/desktop.md)

51* [Облачные запланированные задачи](https://code.claude.com/docs/ru/routines.md) (`/schedule`)51* [Облачные запланированные задачи](https://code.claude.com/docs/ru/routines.md) (`/schedule`)

52* [Ultrareview](https://code.claude.com/docs/ru/ultrareview.md)52* [Ultrareview](https://code.claude.com/docs/ru/ultrareview.md)

53* [Code Review](https://code.claude.com/docs/ru/code-review.md): планы Team и Enterprise53* [Code Review](https://code.claude.com/docs/ru/code-review.md): планы Team и Enterprise

54* [Remote Control](https://code.claude.com/docs/ru/remote-control.md)54* [Remote Control](https://code.claude.com/docs/ru/remote-control.md)

55* [Расширение Chrome](https://code.claude.com/docs/ru/chrome.md)55* [Расширение Chrome](https://code.claude.com/docs/ru/chrome.md)

56* [Computer use](https://code.claude.com/docs/ru/computer-use.md): планы Pro и Max56* [Computer use](https://code.claude.com/docs/ru/computer-use.md): планы Pro, Max и Ultra

57* [Artifacts](https://code.claude.com/docs/ru/artifacts.md): планы Pro, Max, Team и Enterprise57* [Артефакты](https://code.claude.com/docs/ru/artifacts.md): планы Pro, Max, Ultra, Team и Enterprise

58* [Voice dictation](https://code.claude.com/docs/ru/voice-dictation.md)58* [Voice dictation](https://code.claude.com/docs/ru/voice-dictation.md)

59 59 

60Desktop — частичное исключение: [маршрутизация шлюза может быть настроена в приложении или администратором](https://code.claude.com/docs/ru/llm-gateway-connect.md#desktop-app). [Claude Desktop на 3P](https://claude.com/docs/third-party/claude-desktop/overview) также запускает вкладку Code на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или самостоятельно размещённом LLM-шлюзе. Он также запускает вкладку Code на [Claude API](https://claude.com/docs/third-party/claude-desktop/claude-api) с API-ключом Anthropic Console. Для доступности этих функций по плану см. [Доступность по плану подписки](#availability-by-subscription-plan).60Desktop — частичное исключение: [маршрутизация шлюза может быть настроена в приложении или администратором](https://code.claude.com/docs/ru/llm-gateway-connect.md#desktop-app). [Claude Desktop на 3P](https://claude.com/docs/third-party/claude-desktop/overview) также запускает вкладку Code на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или самостоятельно размещённом LLM-шлюзе. Он также запускает вкладку Code на [Claude API](https://claude.com/docs/third-party/claude-desktop/claude-api) с API-ключом Anthropic Console. Для доступности этих функций по плану см. [Доступность по плану подписки](#availability-by-subscription-plan).

229 229 

230Каждая вкладка содержит список того, что недоступно или частично поддерживается у этого поставщика, с альтернативами, где они существуют. Всё, что не указано, работает так же, как в подписке Claude, кроме [различий, зависящих от поставщика](#features-available-on-every-provider), отмеченных выше. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Claude Platform на AWS отчёты об ошибках и телеметрия для Anthropic отключены по умолчанию. См. [поведение по умолчанию по поставщику API](https://code.claude.com/docs/ru/data-usage.md#default-behaviors-by-api-provider) для информации о том, какой трафик всё ещё достигает Anthropic и как отказаться.230Каждая вкладка содержит список того, что недоступно или частично поддерживается у этого поставщика, с альтернативами, где они существуют. Всё, что не указано, работает так же, как в подписке Claude, кроме [различий, зависящих от поставщика](#features-available-on-every-provider), отмеченных выше. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Claude Platform на AWS отчёты об ошибках и телеметрия для Anthropic отключены по умолчанию. См. [поведение по умолчанию по поставщику API](https://code.claude.com/docs/ru/data-usage.md#default-behaviors-by-api-provider) для информации о том, какой трафик всё ещё достигает Anthropic и как отказаться.

231 231 

232**Amazon Bedrock**232> [tab] Amazon Bedrock

233 233>

234**Недоступно:** все [функции, требующие подписку Claude](#features-that-require-a-claude-subscription), плюс [веб-поиск](https://code.claude.com/docs/ru/tools-reference.md#websearch-tool-behavior), [fast mode](https://code.claude.com/docs/ru/fast-mode.md), [Advisor](https://code.claude.com/docs/ru/advisor.md), [Channels](https://code.claude.com/docs/ru/channels.md), [панель управления аналитики](https://code.claude.com/docs/ru/analytics.md), [server-managed settings](https://code.claude.com/docs/ru/server-managed-settings.md) и [команды `/design-sync` и `/import`](https://code.claude.com/docs/ru/commands#all-commands).234> **Недоступно:** все [функции, требующие подписку Claude](#features-that-require-a-claude-subscription), плюс [веб-поиск](https://code.claude.com/docs/ru/tools-reference.md#websearch-tool-behavior), [fast mode](https://code.claude.com/docs/ru/fast-mode.md), [Advisor](https://code.claude.com/docs/ru/advisor.md), [Channels](https://code.claude.com/docs/ru/channels.md), [панель управления аналитики](https://code.claude.com/docs/ru/analytics.md), [server-managed settings](https://code.claude.com/docs/ru/server-managed-settings.md) и [команды `/design-sync` и `/import`](https://code.claude.com/docs/ru/commands#all-commands).

235 235>

236**Частичная поддержка:**236> **Частичная поддержка:**

237 237>

238* [Desktop](https://code.claude.com/docs/ru/desktop.md): только через [Claude Desktop на 3P](https://claude.com/docs/third-party/claude-desktop/overview)238> * [Desktop](https://code.claude.com/docs/ru/desktop.md): только через [Claude Desktop на 3P](https://claude.com/docs/third-party/claude-desktop/overview)

239* [Авторежим](https://code.claude.com/docs/ru/auto-mode-config.md): только Sonnet 5 или более поздние версии, Opus 4.7 или более поздние версии, Haiku 5.5 и модели Fable239> * [Авторежим](https://code.claude.com/docs/ru/auto-mode-config.md): только Sonnet 5 или более поздние версии, Opus 4.7 или более поздние версии, Haiku 5.5 и модели Fable

240* [Cross-session messaging](https://code.claude.com/docs/ru/cross-session-messaging.md): между вашими сеансами на этой машине только <sup>[5](#fn5)</sup>240> * [Cross-session messaging](https://code.claude.com/docs/ru/cross-session-messaging.md): между вашими сеансами на этой машине только <sup>[5](#fn5)</sup>

241* [Zero Data Retention](https://code.claude.com/docs/ru/zero-data-retention.md): в соответствии с вашим соглашением AWS241> * [Zero Data Retention](https://code.claude.com/docs/ru/zero-data-retention.md): в соответствии с вашим соглашением AWS

242 242>

243**Альтернативы:** для планирования используйте [`/loop`](https://code.claude.com/docs/ru/scheduled-tasks) вместо `/schedule`. Для облачных сеансов используйте [GitHub Actions](https://code.claude.com/docs/ru/github-actions.md) или [GitLab CI/CD](https://code.claude.com/docs/ru/gitlab-ci-cd.md). Для веб-поиска используйте инструмент [WebFetch](https://code.claude.com/docs/ru/tools-reference.md#webfetch-tool-behavior) с конкретным URL.243> **Альтернативы:** для планирования используйте [`/loop`](https://code.claude.com/docs/ru/scheduled-tasks) вместо `/schedule`. Для облачных сеансов используйте [GitHub Actions](https://code.claude.com/docs/ru/github-actions.md) или [GitLab CI/CD](https://code.claude.com/docs/ru/gitlab-ci-cd.md). Для веб-поиска используйте инструмент [WebFetch](https://code.claude.com/docs/ru/tools-reference.md#webfetch-tool-behavior) с конкретным URL.

244 

245**Claude Platform на AWS**

246 

247**Недоступно:** все [функции, требующие подписку Claude](#features-that-require-a-claude-subscription), плюс [fast mode](https://code.claude.com/docs/ru/fast-mode.md), [Advisor](https://code.claude.com/docs/ru/advisor.md), [Channels](https://code.claude.com/docs/ru/channels.md), [GitHub Actions](https://code.claude.com/docs/ru/github-actions.md), [панель управления аналитики](https://code.claude.com/docs/ru/analytics.md), [server-managed settings](https://code.claude.com/docs/ru/server-managed-settings.md) и [команды `/design-sync` и `/import`](https://code.claude.com/docs/ru/commands#all-commands).

248 

249**Доступно** там, где Amazon Bedrock недоступен: [веб-поиск](https://code.claude.com/docs/ru/tools-reference.md#websearch-tool-behavior).

250 

251**Частичная поддержка:**

252 

253* [Cross-session messaging](https://code.claude.com/docs/ru/cross-session-messaging.md): между вашими сеансами на этой машине только <sup>[5](#fn5)</sup>

254 

255**Альтернативы:** для планирования используйте [`/loop`](https://code.claude.com/docs/ru/scheduled-tasks) вместо `/schedule`. Для облачных сеансов используйте [GitLab CI/CD](https://code.claude.com/docs/ru/gitlab-ci-cd.md).

256 

257**Google Cloud's Agent Platform**

258 

259**Недоступно:** все [функции, требующие подписку Claude](#features-that-require-a-claude-subscription), плюс [fast mode](https://code.claude.com/docs/ru/fast-mode.md), [Advisor](https://code.claude.com/docs/ru/advisor.md), [Channels](https://code.claude.com/docs/ru/channels.md), [панель управления аналитики](https://code.claude.com/docs/ru/analytics.md), [server-managed settings](https://code.claude.com/docs/ru/server-managed-settings.md) и [команды `/design-sync` и `/import`](https://code.claude.com/docs/ru/commands#all-commands).

260 

261**Частичная поддержка:**

262 

263* [Desktop](https://code.claude.com/docs/ru/desktop.md): через [управляемые параметры](https://claude.com/docs/third-party/claude-desktop/configuration) или [Claude Desktop на 3P](https://claude.com/docs/third-party/claude-desktop/overview)

264* [Веб-поиск](https://code.claude.com/docs/ru/tools-reference.md#websearch-tool-behavior): Opus 4, Sonnet 4, Haiku 4.5 и более поздние модели

265* [Авторежим](https://code.claude.com/docs/ru/auto-mode-config.md): только Sonnet 5 или более поздние версии, Opus 4.7 или более поздние версии, Haiku 5.5 и модели Fable

266* [Cross-session messaging](https://code.claude.com/docs/ru/cross-session-messaging.md): между вашими сеансами на этой машине только <sup>[5](#fn5)</sup>

267* [Zero Data Retention](https://code.claude.com/docs/ru/zero-data-retention.md): в соответствии с вашим соглашением Google Cloud

268 

269**Альтернативы:** для планирования используйте [`/loop`](https://code.claude.com/docs/ru/scheduled-tasks) вместо `/schedule`. Для облачных сеансов используйте [GitHub Actions](https://code.claude.com/docs/ru/github-actions.md) или [GitLab CI/CD](https://code.claude.com/docs/ru/gitlab-ci-cd.md).

270 

271**Microsoft Foundry**

272 

273**Недоступно:** все [функции, требующие подписку Claude](#features-that-require-a-claude-subscription), плюс [fast mode](https://code.claude.com/docs/ru/fast-mode.md), [Advisor](https://code.claude.com/docs/ru/advisor.md), [Channels](https://code.claude.com/docs/ru/channels.md), [GitLab CI/CD](https://code.claude.com/docs/ru/gitlab-ci-cd.md), [панель управления аналитики](https://code.claude.com/docs/ru/analytics.md), [server-managed settings](https://code.claude.com/docs/ru/server-managed-settings.md) и [команды `/design-sync` и `/import`](https://code.claude.com/docs/ru/commands#all-commands).

274 

275**Частичная поддержка:**

276 

277* [Desktop](https://code.claude.com/docs/ru/desktop.md): только через [Claude Desktop на 3P](https://claude.com/docs/third-party/claude-desktop/overview)

278* [Авторежим](https://code.claude.com/docs/ru/auto-mode-config.md): только Sonnet 5 или более поздние версии, Opus 4.7 или более поздние версии, Haiku 5.5 и модели Fable

279* [Cross-session messaging](https://code.claude.com/docs/ru/cross-session-messaging.md): между вашими сеансами на этой машине только <sup>[5](#fn5)</sup>

280* [Zero Data Retention](https://code.claude.com/docs/ru/zero-data-retention.md): в соответствии с вашим соглашением Azure

281 

282**Альтернативы:** для планирования используйте [`/loop`](https://code.claude.com/docs/ru/scheduled-tasks) вместо `/schedule`. Для облачных сеансов используйте [GitHub Actions](https://code.claude.com/docs/ru/github-actions.md).

283 

284**Anthropic Console**

285 244 

286**Недоступно:** все [функции, требующие подписку Claude](#features-that-require-a-claude-subscription).245> [tab] Claude Platform на AWS

246>

247> **Недоступно:** все [функции, требующие подписку Claude](#features-that-require-a-claude-subscription), плюс [fast mode](https://code.claude.com/docs/ru/fast-mode.md), [Advisor](https://code.claude.com/docs/ru/advisor.md), [Channels](https://code.claude.com/docs/ru/channels.md), [GitHub Actions](https://code.claude.com/docs/ru/github-actions.md), [панель управления аналитики](https://code.claude.com/docs/ru/analytics.md), [server-managed settings](https://code.claude.com/docs/ru/server-managed-settings.md) и [команды `/design-sync` и `/import`](https://code.claude.com/docs/ru/commands#all-commands).

248>

249> **Доступно** там, где Amazon Bedrock недоступен: [веб-поиск](https://code.claude.com/docs/ru/tools-reference.md#websearch-tool-behavior).

250>

251> **Частичная поддержка:**

252>

253> * [Cross-session messaging](https://code.claude.com/docs/ru/cross-session-messaging.md): между вашими сеансами на этой машине только <sup>[5](#fn5)</sup>

254>

255> **Альтернативы:** для планирования используйте [`/loop`](https://code.claude.com/docs/ru/scheduled-tasks) вместо `/schedule`. Для облачных сеансов используйте [GitLab CI/CD](https://code.claude.com/docs/ru/gitlab-ci-cd.md).

287 256 

288Всё в разделе [Возможности CLI, которые различаются по поставщикам](#cli-capabilities-that-vary-by-provider) доступно, за исключением того, что [быстрый режим](https://code.claude.com/docs/ru/fast-mode.md) с Claude Opus 5 или Claude Opus 4.8 требует [подготовленный доступ](https://code.claude.com/docs/ru/fast-mode.md#enable-fast-mode-for-your-organization). [Server-managed settings](https://code.claude.com/docs/ru/server-managed-settings.md), которые вы настраиваете в организации claude.ai Team или Enterprise, не применяются к сессии, которая аутентифицируется с помощью API-ключа Console. См. [Доступность платформы](https://code.claude.com/docs/ru/server-managed-settings.md#platform-availability), чтобы узнать, как охватить такие сессии.257> [tab] Google Cloud's Agent Platform

258>

259> **Недоступно:** все [функции, требующие подписку Claude](#features-that-require-a-claude-subscription), плюс [fast mode](https://code.claude.com/docs/ru/fast-mode.md), [Advisor](https://code.claude.com/docs/ru/advisor.md), [Channels](https://code.claude.com/docs/ru/channels.md), [панель управления аналитики](https://code.claude.com/docs/ru/analytics.md), [server-managed settings](https://code.claude.com/docs/ru/server-managed-settings.md) и [команды `/design-sync` и `/import`](https://code.claude.com/docs/ru/commands#all-commands).

260>

261> **Частичная поддержка:**

262>

263> * [Desktop](https://code.claude.com/docs/ru/desktop.md): через [управляемые параметры](https://claude.com/docs/third-party/claude-desktop/configuration) или [Claude Desktop на 3P](https://claude.com/docs/third-party/claude-desktop/overview)

264> * [Веб-поиск](https://code.claude.com/docs/ru/tools-reference.md#websearch-tool-behavior): Opus 4, Sonnet 4, Haiku 4.5 и более поздние модели

265> * [Авторежим](https://code.claude.com/docs/ru/auto-mode-config.md): только Sonnet 5 или более поздние версии, Opus 4.7 или более поздние версии, Haiku 5.5 и модели Fable

266> * [Cross-session messaging](https://code.claude.com/docs/ru/cross-session-messaging.md): между вашими сеансами на этой машине только <sup>[5](#fn5)</sup>

267> * [Zero Data Retention](https://code.claude.com/docs/ru/zero-data-retention.md): в соответствии с вашим соглашением Google Cloud

268>

269> **Альтернативы:** для планирования используйте [`/loop`](https://code.claude.com/docs/ru/scheduled-tasks) вместо `/schedule`. Для облачных сеансов используйте [GitHub Actions](https://code.claude.com/docs/ru/github-actions.md) или [GitLab CI/CD](https://code.claude.com/docs/ru/gitlab-ci-cd.md).

289 270 

290**Частичная поддержка:**271> [tab] Microsoft Foundry

272>

273> **Недоступно:** все [функции, требующие подписку Claude](#features-that-require-a-claude-subscription), плюс [fast mode](https://code.claude.com/docs/ru/fast-mode.md), [Advisor](https://code.claude.com/docs/ru/advisor.md), [Channels](https://code.claude.com/docs/ru/channels.md), [GitLab CI/CD](https://code.claude.com/docs/ru/gitlab-ci-cd.md), [панель управления аналитики](https://code.claude.com/docs/ru/analytics.md), [server-managed settings](https://code.claude.com/docs/ru/server-managed-settings.md) и [команды `/design-sync` и `/import`](https://code.claude.com/docs/ru/commands#all-commands).

274>

275> **Частичная поддержка:**

276>

277> * [Desktop](https://code.claude.com/docs/ru/desktop.md): только через [Claude Desktop на 3P](https://claude.com/docs/third-party/claude-desktop/overview)

278> * [Авторежим](https://code.claude.com/docs/ru/auto-mode-config.md): только Sonnet 5 или более поздние версии, Opus 4.7 или более поздние версии, Haiku 5.5 и модели Fable

279> * [Cross-session messaging](https://code.claude.com/docs/ru/cross-session-messaging.md): между вашими сеансами на этой машине только <sup>[5](#fn5)</sup>

280> * [Zero Data Retention](https://code.claude.com/docs/ru/zero-data-retention.md): в соответствии с вашим соглашением Azure

281>

282> **Альтернативы:** для планирования используйте [`/loop`](https://code.claude.com/docs/ru/scheduled-tasks) вместо `/schedule`. Для облачных сеансов используйте [GitHub Actions](https://code.claude.com/docs/ru/github-actions.md).

291 283 

292* [Desktop](https://code.claude.com/docs/ru/desktop.md): через [Claude Desktop на 3P с Claude API](https://claude.com/docs/third-party/claude-desktop/claude-api)284> [tab] Anthropic Console

285>

286> **Недоступно:** все [функции, требующие подписку Claude](#features-that-require-a-claude-subscription).

287>

288> Всё в разделе [Возможности CLI, которые различаются по поставщикам](#cli-capabilities-that-vary-by-provider) доступно, за исключением того, что [быстрый режим](https://code.claude.com/docs/ru/fast-mode.md) с Claude Opus 5 или Claude Opus 4.8 требует [подготовленный доступ](https://code.claude.com/docs/ru/fast-mode.md#enable-fast-mode-for-your-organization). [Server-managed settings](https://code.claude.com/docs/ru/server-managed-settings.md), которые вы настраиваете в организации claude.ai Team или Enterprise, не применяются к сессии, которая аутентифицируется с помощью API-ключа Console. См. [Доступность платформы](https://code.claude.com/docs/ru/server-managed-settings.md#platform-availability), чтобы узнать, как охватить такие сессии.

289>

290> **Частичная поддержка:**

291>

292> * [Desktop](https://code.claude.com/docs/ru/desktop.md): через [Claude Desktop на 3P с Claude API](https://claude.com/docs/third-party/claude-desktop/claude-api)

293 293 

294## Доступность по плану подписки294## Доступность по плану подписки

295 295 

297 297 

298В организациях Enterprise с применённой [конфигурацией HIPAA](https://code.claude.com/docs/ru/hipaa-setup.md) некоторые функции из этой таблицы отключены.298В организациях Enterprise с применённой [конфигурацией HIPAA](https://code.claude.com/docs/ru/hipaa-setup.md) некоторые функции из этой таблицы отключены.

299 299 

300| Функция | Pro | Max | Team | Enterprise |300| Функция | Pro | Max | Ultra | Team | Enterprise |

301| :- | :- | :- | :- | :- |301| :- | :- | :- | :- | :- | :- |

302| [Cloud sessions](https://code.claude.com/docs/ru/claude-code-on-the-web.md) | ✓ | ✓ | ✓ | ✓ <sup>[6](#fn6)</sup> |302| [Cloud sessions](https://code.claude.com/docs/ru/claude-code-on-the-web.md) | ✓ | ✓ | ✓ | ✓ | ✓ <sup>[6](#fn6)</sup> |

303| [Облачные запланированные задачи](https://code.claude.com/docs/ru/routines.md) | ✓ | ✓ | ✓ | ✓ |303| [Облачные запланированные задачи](https://code.claude.com/docs/ru/routines.md) | ✓ | ✓ | ✓ | ✓ | ✓ |

304| [Remote Control](https://code.claude.com/docs/ru/remote-control.md) | ✓ | ✓ | Admin-enabled | Admin-enabled |304| [Remote Control](https://code.claude.com/docs/ru/remote-control.md) | ✓ | ✓ | ✓ | Admin-enabled | Admin-enabled |

305| [Channels](https://code.claude.com/docs/ru/channels.md) | ✓ | ✓ | Admin-enabled | Admin-enabled |305| [Channels](https://code.claude.com/docs/ru/channels.md) | ✓ | ✓ | ✓ | Admin-enabled | Admin-enabled |

306| [Computer use](https://code.claude.com/docs/ru/computer-use.md) | ✓ | ✓ | ✗ | ✗ |306| [Computer use](https://code.claude.com/docs/ru/computer-use.md) | ✓ | ✓ | ✓ | ✗ | ✗ |

307| Dispatch ([Desktop](https://code.claude.com/docs/ru/desktop.md#sessions-from-dispatch)) | ✓ | ✓ | ✗ | ✗ |307| Dispatch ([Desktop](https://code.claude.com/docs/ru/desktop.md#sessions-from-dispatch)) | ✓ | ✓ | ✓ | ✗ | ✗ |

308| [Code Review](https://code.claude.com/docs/ru/code-review.md) | ✗ | ✗ | ✓ | ✓ |308| [Code Review](https://code.claude.com/docs/ru/code-review.md) | ✗ | ✗ | ✗ | ✓ | ✓ |

309| [Artifacts](https://code.claude.com/docs/ru/artifacts.md) | ✓ | ✓ | ✓ | ✓ |309| [Artifacts](https://code.claude.com/docs/ru/artifacts.md) | ✓ | ✓ | ✓ | ✓ | ✓ |

310| [Analytics dashboard and contribution metrics](https://code.claude.com/docs/ru/analytics.md) | ✗ | ✗ | ✓ | ✓ |310| [Analytics dashboard and contribution metrics](https://code.claude.com/docs/ru/analytics.md) | ✗ | ✗ | ✗ | ✓ | ✓ |

311| [Enterprise Analytics API](https://code.claude.com/docs/ru/analytics.md#access-data-programmatically) | ✗ | ✗ | ✗ | ✓ |311| [Enterprise Analytics API](https://code.claude.com/docs/ru/analytics.md#access-data-programmatically) | ✗ | ✗ | ✗ | ✗ | ✓ |

312| [Server-managed settings](https://code.claude.com/docs/ru/server-managed-settings.md) | ✗ | ✗ | ✓ | ✓ |312| [Server-managed settings](https://code.claude.com/docs/ru/server-managed-settings.md) | ✗ | ✗ | ✗ | ✓ | ✓ |

313| [SSO](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) | ✗ | ✗ | ✓ | ✓ |313| [SSO](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) | ✗ | ✗ | ✗ | ✓ | ✓ |

314| SCIM | ✗ | ✗ | ✗ | ✓ |314| SCIM | ✗ | ✗ | ✗ | ✗ | ✓ |

315| [Compliance API](https://platform.claude.com/docs/en/api/compliance) | ✗ | ✗ | ✗ | ✓ |315| [Compliance API](https://platform.claude.com/docs/en/api/compliance) | ✗ | ✗ | ✗ | ✗ | ✓ |

316| [Zero Data Retention](https://code.claude.com/docs/ru/zero-data-retention.md) | ✗ | ✗ | ✗ | ✓ <sup>[7](#fn7)</sup> |316| [Zero Data Retention](https://code.claude.com/docs/ru/zero-data-retention.md) | ✗ | ✗ | ✗ | ✗ | ✓ <sup>[7](#fn7)</sup> |

317 317 

318<sup>6</sup> На Enterprise требуется премиум-место или место Chat + Claude Code. См. [Cloud sessions](https://code.claude.com/docs/ru/claude-code-on-the-web.md).\318<sup>6</sup> На Enterprise требуется премиум-место или место Chat + Claude Code. См. [Cloud sessions](https://code.claude.com/docs/ru/claude-code-on-the-web.md).\

319 319 

321 321 

322Для информации о ценах и полного сравнения планов см. [Team plans](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) и [Enterprise plans](https://support.claude.com/en/articles/9797531-what-is-the-enterprise-plan).322Для информации о ценах и полного сравнения планов см. [Team plans](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) и [Enterprise plans](https://support.claude.com/en/articles/9797531-what-is-the-enterprise-plan).

323 323 

324### План Ultra

325 

326Ultra — это новое название плана Max 20x, а Max — новое название Max 5x. Чтобы узнать, какой у вас план, проверьте свою подписку на claude.ai.

327 

328В Claude Code планы Max и Ultra имеют одинаковые функции, указанные в столбцах Max и Ultra [таблицы доступности](#availability-by-subscription-plan). Информацию о лимитах использования и ценах см. на [странице цен Claude](https://claude.com/pricing).

329 

324## Доступность моделей330## Доступность моделей

325 331 

326Для информации о том, какие модели Claude и размеры контекстного окна доступны для каждого поставщика и региона, см. [Model configuration](https://code.claude.com/docs/ru/model-config.md) и [Models overview](https://platform.claude.com/docs/en/about-claude/models/overview). Vision, PDF input и extended thinking — это возможности модели, а не функции Claude Code, и работают у каждого поставщика, который предлагает модель. [Prompt caching](https://code.claude.com/docs/ru/prompt-caching.md) работает одинаково у большинства поставщиков; на Amazon Bedrock поддержка варьируется в зависимости от модели.332Для информации о том, какие модели Claude и размеры контекстного окна доступны для каждого поставщика и региона, см. [Model configuration](https://code.claude.com/docs/ru/model-config.md) и [Models overview](https://platform.claude.com/docs/en/about-claude/models/overview). Vision, PDF input и extended thinking — это возможности модели, а не функции Claude Code, и работают у каждого поставщика, который предлагает модель. [Prompt caching](https://code.claude.com/docs/ru/prompt-caching.md) работает одинаково у большинства поставщиков; на Amazon Bedrock поддержка варьируется в зависимости от модели.

features-overview.md +193 −193

Details

72 72 

73Некоторые функции могут казаться похожими. Для более глубокого разбора выбора между ними см. [Steering Claude Code: when to use CLAUDE.md, skills, hooks, and subagents](https://claude.com/blog/steering-claude-code-skills-hooks-rules-subagents-and-more) в блоге. Вот как их различить.73Некоторые функции могут казаться похожими. Для более глубокого разбора выбора между ними см. [Steering Claude Code: when to use CLAUDE.md, skills, hooks, and subagents](https://claude.com/blog/steering-claude-code-skills-hooks-rules-subagents-and-more) в блоге. Вот как их различить.

74 74 

75**Skill vs Subagent**75> [tab] Skill vs Subagent

76 76>

77Skills и subagent'ы решают разные проблемы:77> Skills и subagent'ы решают разные проблемы:

78 78>

79* **Skills** — это переиспользуемый контент, который ты можешь загрузить в любой контекст79> * **Skills** — это переиспользуемый контент, который ты можешь загрузить в любой контекст

80* **Subagent'ы** — это изолированные рабочие, которые запускаются отдельно от твоего основного разговора80> * **Subagent'ы** — это изолированные рабочие, которые запускаются отдельно от твоего основного разговора

81 81>

82| Аспект | Skill | Subagent |82> | Аспект | Skill | Subagent |

83| - | - | - |83> | - | - | - |

84| **Что это** | Переиспользуемые инструкции, знания или рабочие процессы | Изолированный рабочий со своим собственным контекстом |84> | **Что это** | Переиспользуемые инструкции, знания или рабочие процессы | Изолированный рабочий со своим собственным контекстом |

85| **Ключевое преимущество** | Поделись контентом между контекстами | Изоляция контекста. Работа происходит отдельно, возвращается только резюме |85> | **Ключевое преимущество** | Поделись контентом между контекстами | Изоляция контекста. Работа происходит отдельно, возвращается только резюме |

86| **Влияние на [context window](https://code.claude.com/docs/ru/context-window.md)** | Добавляется в твоё основное окно | Использует отдельное окно со своими входными и выходными токенами |86> | **Влияние на [context window](https://code.claude.com/docs/ru/context-window.md)** | Добавляется в твоё основное окно | Использует отдельное окно со своими входными и выходными токенами |

87| **Лучше всего для** | Справочный материал, вызываемые рабочие процессы | Задачи, которые читают много файлов, параллельная работа, специализированные рабочие |87> | **Лучше всего для** | Справочный материал, вызываемые рабочие процессы | Задачи, которые читают много файлов, параллельная работа, специализированные рабочие |

88 88>

89**Skills могут быть справочными или действенными.** Справочные skills предоставляют знания, которые Claude использует на протяжении твоей сессии (например, твой справочник стиля API). Action skills говорят Claude сделать что-то конкретное (например, `/deploy`, который запускает твой рабочий процесс развёртывания).89> **Skills могут быть справочными или действенными.** Справочные skills предоставляют знания, которые Claude использует на протяжении твоей сессии (например, твой справочник стиля API). Action skills говорят Claude сделать что-то конкретное (например, `/deploy`, который запускает твой рабочий процесс развёртывания).

90 90>

91**Используй subagent**, когда тебе нужна изоляция контекста или когда твоё окно контекста переполняется. Subagent может читать десятки файлов или запускать обширные поиски, но твой основной разговор получает только резюме. Поскольку работа subagent'а не потребляет твой основной контекст, это также полезно, когда тебе не нужна промежуточная работа, чтобы оставаться видимой. Пользовательские subagent'ы могут иметь свои собственные инструкции и могут предварительно загружать skills.91> **Используй subagent**, когда тебе нужна изоляция контекста или когда твоё окно контекста переполняется. Subagent может читать десятки файлов или запускать обширные поиски, но твой основной разговор получает только резюме. Поскольку работа subagent'а не потребляет твой основной контекст, это также полезно, когда тебе не нужна промежуточная работа, чтобы оставаться видимой. Пользовательские subagent'ы могут иметь свои собственные инструкции и могут предварительно загружать skills.

92 92>

93**Они могут объединяться.** Subagent может предварительно загружать определённые skills (поле `skills:`). Skill может запускаться в изолированном контексте, используя `context: fork`. Подробнее см. в [Skills](https://code.claude.com/docs/ru/skills.md).93> **Они могут объединяться.** Subagent может предварительно загружать определённые skills (поле `skills:`). Skill может запускаться в изолированном контексте, используя `context: fork`. Подробнее см. в [Skills](https://code.claude.com/docs/ru/skills.md).

94 

95**CLAUDE.md vs Skill**

96 

97Оба хранят инструкции, но они загружаются по-разному и служат разным целям.

98 

99| Аспект | CLAUDE.md | Skill |

100| - | - | - |

101| **Загружается** | Каждая сессия, автоматически | По требованию |

102| **Может включать файлы** | Да, с импортами `@path` | Да, с импортами `@path` |

103| **Может запускать рабочие процессы** | Нет | Да, с `/<name>` |

104| **Лучше всего для** | Правила «всегда делай X» | Справочный материал, вызываемые рабочие процессы |

105 

106**Поместите это в CLAUDE.md**, если Claude должен всегда это знать: соглашения кодирования, команды сборки, структура проекта, правила «никогда не делай X».

107 

108**Поместите это в skill**, если это справочный материал, который Claude иногда нужен (документация API, справочники стилей) или рабочий процесс, который ты запускаешь с `/<name>` (развёртывание, проверка, выпуск).

109 

110**Правило большого пальца:** Держите CLAUDE.md под 200 строк. Если он растёт, переместите справочный контент в skills или разделите на файлы [`.claude/rules/`](https://code.claude.com/docs/ru/memory#organize-rules-with-claude/rules/).

111 

112**CLAUDE.md vs Output style**

113 

114Оба дают Claude постоянные инструкции. CLAUDE.md содержит то, что Claude должен знать, и output style устанавливает, как Claude отвечает.

115 

116| Аспект | CLAUDE.md | Output style |

117| - | - | - |

118| **Содержит** | Факты и правила о вашем проекте | Роль, тон и формат ответа |

119| **Переключение** | Всегда загружается | Один активный одновременно; [переключайте стили](https://code.claude.com/docs/ru/output-styles.md#change-your-output-style) когда угодно |

120| **Лучше всего для** | Команды сборки, соглашения, правила «никогда не делай X» | Более короткие ответы, объяснения рядом с кодом, роль, отличная от инженера |

121 

122**Поместите это в CLAUDE.md**, если это верно для проекта в любом стиле: соглашения кодирования, команды сборки, структура проекта.

123 

124**Используйте output style**, если это о самом ответе и вы можете захотеть его отключить: длина, формат, сколько Claude объясняет, или другая роль, такая как помощник по письму. Claude Code включает [встроенные стили](https://code.claude.com/docs/ru/output-styles.md#built-in-output-styles), и вы можете написать свои собственные.

125 

126**Они объединяются.** CLAUDE.md остаётся загруженным, какой бы стиль вы ни выбрали. Claude следует обоим как инструкциям, поэтому ни один не применяется принудительно. Для чего-либо, что должно происходить каждый раз, используйте [hook](https://code.claude.com/docs/ru/hooks-guide.md).

127 

128**CLAUDE.md vs Rules vs Skills**

129 

130Все три хранят инструкции, но они загружаются по-разному:

131 

132| Аспект | CLAUDE.md | `.claude/rules/` | Skill |

133| - | - | - | - |

134| **Загружается** | Каждая сессия | Каждая сессия, или когда открываются совпадающие файлы | По требованию, когда вызывается или релевантно |

135| **Область** | Весь проект | Может быть ограничена путями файлов | Специфична для задачи |

136| **Лучше всего для** | Основные соглашения и команды сборки | Рекомендации, специфичные для языка или каталога | Справочный материал, повторяющиеся рабочие процессы |

137 

138**Используй CLAUDE.md** для инструкций, которые каждая сессия нуждается: команды сборки, соглашения тестирования, архитектура проекта.

139 

140**Используй rules**, чтобы держать CLAUDE.md сосредоточенным. Rules с [frontmatter `paths`](https://code.claude.com/docs/ru/memory#path-specific-rules) загружаются только когда Claude работает с совпадающими файлами, экономя контекст.

141 

142**Используй skills** для контента, который Claude нужен только иногда, например документация API или контрольный список развёртывания, который ты запускаешь с `/<name>`.

143 

144**Subagent vs Dynamic workflow**

145 

146Оба выполняют работу вне твоего основного разговора. С subagent'ами Claude решает поворот за поворотом, что запускается дальше. В рабочем процессе скрипт решает:

147 

148* **Subagent'ы** — это рабочие, которых Claude запускает, каждый возвращая резюме в разговор, который его запустил

149* **[Dynamic workflows](https://code.claude.com/docs/ru/workflows.md)** — это скрипты, которые пишет Claude и запускают много subagent'ов в фоне и возвращают один результат

150 

151**Используйте субагента**, когда вам нужен быстрый, сфокусированный исполнитель: изучить вопрос, проверить утверждение, просмотреть файл. Субагент выполняет работу и возвращает резюме, поэтому ваш основной диалог остаётся чистым. Субагенты, которым Claude [дал имена](https://code.claude.com/docs/ru/sub-agents.md#subagent-names) при запуске, также могут [обмениваться сообщениями друг с другом](https://code.claude.com/docs/ru/sub-agents.md#what-loads-at-startup).

152 

153**Используй dynamic workflow**, когда работа [переросла несколько subagent'ов](https://code.claude.com/docs/ru/workflows.md#when-to-use-a-workflow), или когда ты хочешь, чтобы выводы были перепроверены перед тем, как ты их увидишь, например аудит всей кодовой базы, крупная миграция или план, составленный с нескольких углов. Чтобы начать один, [попроси рабочий процесс в своей подсказке](https://code.claude.com/docs/ru/workflows.md#ask-for-a-workflow-in-your-prompt).

154 

155**Чтобы передать вывод из одной из твоих сессий в другую**, попроси Claude первой сессии отправить его. Claude доставляет его с помощью [cross-session messaging](https://code.claude.com/docs/ru/cross-session-messaging.md). [Run agents in parallel](https://code.claude.com/docs/ru/agents.md) сравнивает другие способы запуска более чем одного Claude одновременно, включая сессии, которые ты передаёшь и проверяешь позже.

156 

157**MCP vs Skill**

158 

159MCP подключает Claude к внешним сервисам. Skills расширяют то, что знает Claude, включая то, как эффективно использовать эти сервисы.

160 

161| Аспект | MCP | Skill |

162| - | - | - |

163| **Что это** | Протокол для подключения к внешним сервисам | Знания, рабочие процессы и справочный материал |

164| **Предоставляет** | Инструменты и доступ к данным | Знания, рабочие процессы, справочный материал |

165| **Примеры** | Интеграция Slack, запросы к базе данных, управление браузером | Контрольный список проверки кода, рабочий процесс развёртывания, справочник стиля API |

166 

167Они решают разные проблемы и хорошо работают вместе:

168 

169**MCP** даёт Claude специально разработанные инструменты для внешней системы, с подключением и аутентификацией, обработанными сервером.

170 

171**Skills** дают Claude знания о том, как эффективно использовать эти инструменты, плюс рабочие процессы, которые ты можешь запустить с `/<name>`. Skill может включать схему базы данных твоей команды и шаблоны запросов, или рабочий процесс `/post-to-slack` с правилами форматирования сообщений твоей команды.

172 

173**Hook vs Skill**

174 94 

175Claude Code запускает hook при событии жизненного цикла; он загружает skill в контекст для Claude, чтобы применить.95> [tab] CLAUDE.md vs Skill

96>

97> Оба хранят инструкции, но они загружаются по-разному и служат разным целям.

98>

99> | Аспект | CLAUDE.md | Skill |

100> | - | - | - |

101> | **Загружается** | Каждая сессия, автоматически | По требованию |

102> | **Может включать файлы** | Да, с импортами `@path` | Да, с импортами `@path` |

103> | **Может запускать рабочие процессы** | Нет | Да, с `/<name>` |

104> | **Лучше всего для** | Правила «всегда делай X» | Справочный материал, вызываемые рабочие процессы |

105>

106> **Поместите это в CLAUDE.md**, если Claude должен всегда это знать: соглашения кодирования, команды сборки, структура проекта, правила «никогда не делай X».

107>

108> **Поместите это в skill**, если это справочный материал, который Claude иногда нужен (документация API, справочники стилей) или рабочий процесс, который ты запускаешь с `/<name>` (развёртывание, проверка, выпуск).

109>

110> **Правило большого пальца:** Держите CLAUDE.md под 200 строк. Если он растёт, переместите справочный контент в skills или разделите на файлы [`.claude/rules/`](https://code.claude.com/docs/ru/memory#organize-rules-with-claude/rules/).

176 111 

177| Аспект | Hook | Skill |112> [tab] CLAUDE.md vs Output style

178| - | - | - |113>

179| **Запускает** | Команду shell, HTTP-запрос, вызов инструмента MCP, подсказку LLM или subagent'а | Инструкции, которые Claude читает и следует |114> Оба дают Claude постоянные инструкции. CLAUDE.md содержит то, что Claude должен знать, и output style устанавливает, как Claude отвечает.

180| **Запущено** | [События жизненного цикла](https://code.claude.com/docs/ru/hooks.md#hook-events), такие как `PostToolUse` или `SessionStart` | Ты печатаешь `/<name>`, или Claude соответствует описанию твоей задаче |115>

181| **Детерминированность** | Срабатывает при своём событии без решения со стороны Claude | Claude интерпретирует инструкции; результат может различаться |116> | Аспект | CLAUDE.md | Output style |

182| **Стоимость контекста** | Ноль, если hook не возвращает вывод | Описание загружается каждую сессию; полный контент загружается при использовании |117> | - | - | - |

183| **Лучше всего для** | Линтинг после редактирования, блокирование небезопасных команд, логирование, уведомления | Рабочие процессы, которые нуждаются в рассуждении, справочный материал, многошаговые задачи |118> | **Содержит** | Факты и правила о вашем проекте | Роль, тон и формат ответа |

119> | **Переключение** | Всегда загружается | Один активный одновременно; [переключайте стили](https://code.claude.com/docs/ru/output-styles.md#change-your-output-style) когда угодно |

120> | **Лучше всего для** | Команды сборки, соглашения, правила «никогда не делай X» | Более короткие ответы, объяснения рядом с кодом, роль, отличная от инженера |

121>

122> **Поместите это в CLAUDE.md**, если это верно для проекта в любом стиле: соглашения кодирования, команды сборки, структура проекта.

123>

124> **Используйте output style**, если это о самом ответе и вы можете захотеть его отключить: длина, формат, сколько Claude объясняет, или другая роль, такая как помощник по письму. Claude Code включает [встроенные стили](https://code.claude.com/docs/ru/output-styles.md#built-in-output-styles), и вы можете написать свои собственные.

125>

126> **Они объединяются.** CLAUDE.md остаётся загруженным, какой бы стиль вы ни выбрали. Claude следует обоим как инструкциям, поэтому ни один не применяется принудительно. Для чего-либо, что должно происходить каждый раз, используйте [hook](https://code.claude.com/docs/ru/hooks-guide.md).

184 127 

185**Используй hook**, когда действие должно происходить одинаково каждый раз и не нуждается в размышлении Claude. Например: форматирование при сохранении, отклонение `rm -rf /`, отправка сообщения Slack при завершении сессии.128> [tab] CLAUDE.md vs Rules vs Skills

129>

130> Все три хранят инструкции, но они загружаются по-разному:

131>

132> | Аспект | CLAUDE.md | `.claude/rules/` | Skill |

133> | - | - | - | - |

134> | **Загружается** | Каждая сессия | Каждая сессия, или когда открываются совпадающие файлы | По требованию, когда вызывается или релевантно |

135> | **Область** | Весь проект | Может быть ограничена путями файлов | Специфична для задачи |

136> | **Лучше всего для** | Основные соглашения и команды сборки | Рекомендации, специфичные для языка или каталога | Справочный материал, повторяющиеся рабочие процессы |

137>

138> **Используй CLAUDE.md** для инструкций, которые каждая сессия нуждается: команды сборки, соглашения тестирования, архитектура проекта.

139>

140> **Используй rules**, чтобы держать CLAUDE.md сосредоточенным. Rules с [frontmatter `paths`](https://code.claude.com/docs/ru/memory#path-specific-rules) загружаются только когда Claude работает с совпадающими файлами, экономя контекст.

141>

142> **Используй skills** для контента, который Claude нужен только иногда, например документация API или контрольный список развёртывания, который ты запускаешь с `/<name>`.

186 143 

187**Используй skill**, когда Claude должен решить, как применить шаги, или когда контент — это знание, а не скрипт. Например: контрольный список `/release`, твой справочник стиля API, сценарий отладки.144> [tab] Subagent vs Dynamic workflow

145>

146> Оба выполняют работу вне твоего основного разговора. С subagent'ами Claude решает поворот за поворотом, что запускается дальше. В рабочем процессе скрипт решает:

147>

148> * **Subagent'ы** — это рабочие, которых Claude запускает, каждый возвращая резюме в разговор, который его запустил

149> * **[Dynamic workflows](https://code.claude.com/docs/ru/workflows.md)** — это скрипты, которые пишет Claude и запускают много subagent'ов в фоне и возвращают один результат

150>

151> **Используйте субагента**, когда вам нужен быстрый, сфокусированный исполнитель: изучить вопрос, проверить утверждение, просмотреть файл. Субагент выполняет работу и возвращает резюме, поэтому ваш основной диалог остаётся чистым. Субагенты, которым Claude [дал имена](https://code.claude.com/docs/ru/sub-agents.md#subagent-names) при запуске, также могут [обмениваться сообщениями друг с другом](https://code.claude.com/docs/ru/sub-agents.md#what-loads-at-startup).

152>

153> **Используй dynamic workflow**, когда работа [переросла несколько subagent'ов](https://code.claude.com/docs/ru/workflows.md#when-to-use-a-workflow), или когда ты хочешь, чтобы выводы были перепроверены перед тем, как ты их увидишь, например аудит всей кодовой базы, крупная миграция или план, составленный с нескольких углов. Чтобы начать один, [попроси рабочий процесс в своей подсказке](https://code.claude.com/docs/ru/workflows.md#ask-for-a-workflow-in-your-prompt).

154>

155> **Чтобы передать вывод из одной из твоих сессий в другую**, попроси Claude первой сессии отправить его. Claude доставляет его с помощью [cross-session messaging](https://code.claude.com/docs/ru/cross-session-messaging.md). [Run agents in parallel](https://code.claude.com/docs/ru/agents.md) сравнивает другие способы запуска более чем одного Claude одновременно, включая сессии, которые ты передаёшь и проверяешь позже.

188 156 

189**Поместите guardrails в hooks.** Инструкция типа «никогда не редактируй `.env`» в CLAUDE.md или skill — это просьба, а не гарантия. Hook `PreToolUse`, который блокирует редактирование, — это принуждение. Если правило должно выполняться каждый раз, сделай его hook, а не инструкцию подсказки.157> [tab] MCP vs Skill

158>

159> MCP подключает Claude к внешним сервисам. Skills расширяют то, что знает Claude, включая то, как эффективно использовать эти сервисы.

160>

161> | Аспект | MCP | Skill |

162> | - | - | - |

163> | **Что это** | Протокол для подключения к внешним сервисам | Знания, рабочие процессы и справочный материал |

164> | **Предоставляет** | Инструменты и доступ к данным | Знания, рабочие процессы, справочный материал |

165> | **Примеры** | Интеграция Slack, запросы к базе данных, управление браузером | Контрольный список проверки кода, рабочий процесс развёртывания, справочник стиля API |

166>

167> Они решают разные проблемы и хорошо работают вместе:

168>

169> **MCP** даёт Claude специально разработанные инструменты для внешней системы, с подключением и аутентификацией, обработанными сервером.

170>

171> **Skills** дают Claude знания о том, как эффективно использовать эти инструменты, плюс рабочие процессы, которые ты можешь запустить с `/<name>`. Skill может включать схему базы данных твоей команды и шаблоны запросов, или рабочий процесс `/post-to-slack` с правилами форматирования сообщений твоей команды.

190 172 

191**Вывод Hook попадает в контекст.** Hook `PostToolUse`, который запускает твой линтер, возвращает результаты как текст, который читает Claude; skill `/fix-lint` говорит Claude, как их разрешить.173> [tab] Hook vs Skill

174>

175> Claude Code запускает hook при событии жизненного цикла; он загружает skill в контекст для Claude, чтобы применить.

176>

177> | Аспект | Hook | Skill |

178> | - | - | - |

179> | **Запускает** | Команду shell, HTTP-запрос, вызов инструмента MCP, подсказку LLM или subagent'а | Инструкции, которые Claude читает и следует |

180> | **Запущено** | [События жизненного цикла](https://code.claude.com/docs/ru/hooks.md#hook-events), такие как `PostToolUse` или `SessionStart` | Ты печатаешь `/<name>`, или Claude соответствует описанию твоей задаче |

181> | **Детерминированность** | Срабатывает при своём событии без решения со стороны Claude | Claude интерпретирует инструкции; результат может различаться |

182> | **Стоимость контекста** | Ноль, если hook не возвращает вывод | Описание загружается каждую сессию; полный контент загружается при использовании |

183> | **Лучше всего для** | Линтинг после редактирования, блокирование небезопасных команд, логирование, уведомления | Рабочие процессы, которые нуждаются в рассуждении, справочный материал, многошаговые задачи |

184>

185> **Используй hook**, когда действие должно происходить одинаково каждый раз и не нуждается в размышлении Claude. Например: форматирование при сохранении, отклонение `rm -rf /`, отправка сообщения Slack при завершении сессии.

186>

187> **Используй skill**, когда Claude должен решить, как применить шаги, или когда контент — это знание, а не скрипт. Например: контрольный список `/release`, твой справочник стиля API, сценарий отладки.

188>

189> **Поместите guardrails в hooks.** Инструкция типа «никогда не редактируй `.env`» в CLAUDE.md или skill — это просьба, а не гарантия. Hook `PreToolUse`, который блокирует редактирование, — это принуждение. Если правило должно выполняться каждый раз, сделай его hook, а не инструкцию подсказки.

190>

191> **Вывод Hook попадает в контекст.** Hook `PostToolUse`, который запускает твой линтер, возвращает результаты как текст, который читает Claude; skill `/fix-lint` говорит Claude, как их разрешить.

192 192 

193### Поймите, как функции слоятся193### Поймите, как функции слоятся

194 194 

238 238 

239![Загрузка контекста: CLAUDE.md загружается в начале сессии и остаётся в каждом запросе. Имена инструментов MCP загружаются в начале с полными схемами отложенными до использования. Skills загружают описания в начале, полный контент при вызове. Subagents получают изолированный контекст. Hooks работают внешне.](https://mintcdn.com/claude-code/ikqp3_70mqIahteV/images/context-loading.svg?fit=max\&auto=format\&n=ikqp3_70mqIahteV\&q=85\&s=aab139e750494a237ae2e0c8f9139b0a)239![Загрузка контекста: CLAUDE.md загружается в начале сессии и остаётся в каждом запросе. Имена инструментов MCP загружаются в начале с полными схемами отложенными до использования. Skills загружают описания в начале, полный контент при вызове. Subagents получают изолированный контекст. Hooks работают внешне.](https://mintcdn.com/claude-code/ikqp3_70mqIahteV/images/context-loading.svg?fit=max\&auto=format\&n=ikqp3_70mqIahteV\&q=85\&s=aab139e750494a237ae2e0c8f9139b0a)

240 240 

241**CLAUDE.md**241> [tab] CLAUDE.md

242 

243**Когда:** Начало сессии

244 

245**Что загружается:** Полный контент каждого файла CLAUDE.md, который загружается в начале сессии (управляемые, пользовательские и уровни проекта).

246 

247**Наследование:** Claude читает файлы CLAUDE.md из вашего рабочего каталога вверх до корня и обнаруживает вложенные в подкаталогах по мере доступа к этим файлам. Подробнее см. в разделе [How CLAUDE.md files load](https://code.claude.com/docs/ru/memory.md#how-claude-md-files-load). Если вложенный CLAUDE.md превышает [ограничение размера для одного файла](https://code.claude.com/docs/ru/memory.md#claude-ignores-the-end-of-my-subdirectory-claude-md), Claude получает только начало файла.

248 

249> [!TIP]

250>242>

251> Держите CLAUDE.md под 200 строк. Переместите справочный материал в skills, которые загружаются по требованию. Чтобы получить [предложения по сокращению зафиксированного в репозитории CLAUDE.md](https://code.claude.com/docs/ru/memory.md#my-claude-md-is-too-large), запустите `/doctor`.243> **Когда:** Начало сессии

252 

253**Skills**

254 

255Skills — это дополнительные возможности в наборе инструментов Claude. Они могут быть справочным материалом (например, руководство по стилю API) или вызываемыми рабочими процессами, которые вы запускаете с помощью `/<name>` (например, `/deploy`). Claude Code поставляется с [встроенными skills](https://code.claude.com/docs/ru/commands.md) типа `/code-review`, `/batch` и `/debug`, которые работают из коробки. Вы также можете создавать свои собственные.

256 

257**Когда:** Зависит от конфигурации skill. По умолчанию описания загружаются в начале сессии, а полный контент загружается при использовании. Для skills только пользователя (`disable-model-invocation: true`) ничего не загружается до тех пор, пока вы их не вызовете.

258 

259**Что загружается:** Для skills, вызываемых моделью, Claude видит имена и описания в каждом запросе. Когда вы вызываете skill с помощью `/<name>` или Claude загружает его автоматически, полный контент загружается в ваш разговор.

260 

261**Как Claude выбирает скиллы:** Claude сопоставляет вашу задачу с описаниями скиллов, чтобы решить, какие релевантны. Если описания расплывчаты или перекрываются, Claude может загрузить неправильный скилл или пропустить тот, который помог бы. Чтобы сказать Claude использовать определённый скилл, вызовите его с помощью `/<name>`.

262 

263**Стоимость контекста:** Низкая до использования. Skills только пользователя имеют нулевую стоимость до вызова.

264 

265**В субагентах:** Полный контент скиллов, указанных в поле `skills` субагента, [загружается в его контекст при запуске](https://code.claude.com/docs/ru/sub-agents.md#preload-skills-into-subagents), а не по требованию. Субагенты по-прежнему могут обнаруживать и вызывать не указанные в списке скиллы проекта, пользователя и плагинов через инструмент Skill.

266 

267> [!TIP]

268>244>

269> Используйте `disable-model-invocation: true` для скиллов с побочными эффектами. Это экономит контекст и гарантирует, что они запускаются только тогда, когда вы называете их.245> **Что загружается:** Полный контент каждого файла CLAUDE.md, который загружается в начале сессии (управляемые, пользовательские и уровни проекта).

270 

271**MCP servers**

272 

273**Когда:** Начало сессии.

274 

275**Что загружается:** Имена инструментов и инструкции сервера из подключённых серверов. Полные JSON схемы остаются отложенными до тех пор, пока Claude не нуждается в конкретном инструменте.

276 

277**Стоимость контекста:** [Tool search](https://code.claude.com/docs/ru/mcp.md#scale-with-mcp-tool-search) включён по умолчанию, поэтому неиспользуемые MCP инструменты потребляют минимальный контекст.

278 

279> [!TIP]

280>246>

281> Запустите `/mcp`, чтобы увидеть статус подключения каждого сервера. Запустите `/context all`, чтобы увидеть, сколько токенов использует каждый загруженный MCP инструмент. Claude Code [автоматически переподключается к удалённым серверам](https://code.claude.com/docs/ru/mcp.md#automatic-reconnection), если они отключатся, и вы можете отключить серверы, которые вы не активно используете.247> **Наследование:** Claude читает файлы CLAUDE.md из вашего рабочего каталога вверх до корня и обнаруживает вложенные в подкаталогах по мере доступа к этим файлам. Подробнее см. в разделе [How CLAUDE.md files load](https://code.claude.com/docs/ru/memory.md#how-claude-md-files-load). Если вложенный CLAUDE.md превышает [ограничение размера для одного файла](https://code.claude.com/docs/ru/memory.md#claude-ignores-the-end-of-my-subdirectory-claude-md), Claude получает только начало файла.

282 

283**Code intelligence**

284 

285**Когда:** После редактирования файлов и по требованию, когда Claude переходит по коду.

286 

287**Что загружается:** Ошибки типов и предупреждения после каждого редактирования файла. Информация об определении, ссылках и типах, когда Claude ищет символ.

288 

289**Стоимость контекста:** Низкая. Поиск символов часто заменяет широкое чтение файлов, поэтому общее использование контекста может снизиться.

290 

291> [!TIP]

292>248>

293> Инструмент LSP неактивен до тех пор, пока вы не установите [плагин code intelligence](https://code.claude.com/docs/ru/plugins/code-intelligence.md) для вашего языка.249> > [!TIP]

294 250> >

295**Subagents**251> > Держите CLAUDE.md под 200 строк. Переместите справочный материал в skills, которые загружаются по требованию. Чтобы получить [предложения по сокращению зафиксированного в репозитории CLAUDE.md](https://code.claude.com/docs/ru/memory.md#my-claude-md-is-too-large), запустите `/doctor`.

296 

297**Когда:** По требованию, когда вы или Claude запускаете один для задачи.

298 

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

300 

301* Собственный системный промпт агента, а не системный промпт Claude Code

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

303* CLAUDE.md и статус git. Встроенные агенты Explore и Plan [не получают ни того, ни другого](https://code.claude.com/docs/ru/sub-agents.md#what-loads-at-startup), а агент, чьё определение устанавливает [`omitClaudeMd`](https://code.claude.com/docs/ru/sub-agents#supported-frontmatter-fields), запускается без пользовательского, проектного и локального файлов CLAUDE.md.

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

305 

306Для [fork](https://code.claude.com/docs/ru/sub-agents.md#fork-the-current-conversation), Claude Code загружает разговор родителя до сих пор, системный prompt и инструменты вместо.

307 

308**Стоимость контекста:** Изолирована от основной сессии.

309 252 

310> [!TIP]253> [tab] Skills

311>254>

312> Используйте subagents для работы, которая не нуждается в вашем полном контексте разговора. Их изоляция предотвращает раздувание вашей основной сессии.255> Skills — это дополнительные возможности в наборе инструментов Claude. Они могут быть справочным материалом (например, руководство по стилю API) или вызываемыми рабочими процессами, которые вы запускаете с помощью `/<name>` (например, `/deploy`). Claude Code поставляется с [встроенными skills](https://code.claude.com/docs/ru/commands.md) типа `/code-review`, `/batch` и `/debug`, которые работают из коробки. Вы также можете создавать свои собственные.

313 256>

314**Hooks**257> **Когда:** Зависит от конфигурации skill. По умолчанию описания загружаются в начале сессии, а полный контент загружается при использовании. Для skills только пользователя (`disable-model-invocation: true`) ничего не загружается до тех пор, пока вы их не вызовете.

258>

259> **Что загружается:** Для skills, вызываемых моделью, Claude видит имена и описания в каждом запросе. Когда вы вызываете skill с помощью `/<name>` или Claude загружает его автоматически, полный контент загружается в ваш разговор.

260>

261> **Как Claude выбирает скиллы:** Claude сопоставляет вашу задачу с описаниями скиллов, чтобы решить, какие релевантны. Если описания расплывчаты или перекрываются, Claude может загрузить неправильный скилл или пропустить тот, который помог бы. Чтобы сказать Claude использовать определённый скилл, вызовите его с помощью `/<name>`.

262>

263> **Стоимость контекста:** Низкая до использования. Skills только пользователя имеют нулевую стоимость до вызова.

264>

265> **В субагентах:** Полный контент скиллов, указанных в поле `skills` субагента, [загружается в его контекст при запуске](https://code.claude.com/docs/ru/sub-agents.md#preload-skills-into-subagents), а не по требованию. Субагенты по-прежнему могут обнаруживать и вызывать не указанные в списке скиллы проекта, пользователя и плагинов через инструмент Skill.

266>

267> > [!TIP]

268> >

269> > Используйте `disable-model-invocation: true` для скиллов с побочными эффектами. Это экономит контекст и гарантирует, что они запускаются только тогда, когда вы называете их.

315 270 

316**Когда:** При срабатывании. Claude Code запускает hooks при определённых событиях жизненного цикла, таких как выполнение инструмента, границы сессии, отправка prompt, запросы разрешений и компактирование. Подробный список см. в разделе [Hooks](https://code.claude.com/docs/ru/hooks.md).271> [tab] MCP servers

272>

273> **Когда:** Начало сессии.

274>

275> **Что загружается:** Имена инструментов и инструкции сервера из подключённых серверов. Полные JSON схемы остаются отложенными до тех пор, пока Claude не нуждается в конкретном инструменте.

276>

277> **Стоимость контекста:** [Tool search](https://code.claude.com/docs/ru/mcp.md#scale-with-mcp-tool-search) включён по умолчанию, поэтому неиспользуемые MCP инструменты потребляют минимальный контекст.

278>

279> > [!TIP]

280> >

281> > Запустите `/mcp`, чтобы увидеть статус подключения каждого сервера. Запустите `/context all`, чтобы увидеть, сколько токенов использует каждый загруженный MCP инструмент. Claude Code [автоматически переподключается к удалённым серверам](https://code.claude.com/docs/ru/mcp.md#automatic-reconnection), если они отключатся, и вы можете отключить серверы, которые вы не активно используете.

317 282 

318**Что загружается:** Ничего по умолчанию. Hooks работают вне основного разговора.283> [tab] Code intelligence

284>

285> **Когда:** После редактирования файлов и по требованию, когда Claude переходит по коду.

286>

287> **Что загружается:** Ошибки типов и предупреждения после каждого редактирования файла. Информация об определении, ссылках и типах, когда Claude ищет символ.

288>

289> **Стоимость контекста:** Низкая. Поиск символов часто заменяет широкое чтение файлов, поэтому общее использование контекста может снизиться.

290>

291> > [!TIP]

292> >

293> > Инструмент LSP неактивен до тех пор, пока вы не установите [плагин code intelligence](https://code.claude.com/docs/ru/plugins/code-intelligence.md) для вашего языка.

319 294 

320**Стоимость контекста:** Ноль, если hook не возвращает вывод, который добавляется как сообщения в ваш разговор.295> [tab] Subagents

296>

297> **Когда:** По требованию, когда вы или Claude запускаете один для задачи.

298>

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

300>

301> * Собственный системный промпт агента, а не системный промпт Claude Code

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

303> * CLAUDE.md и статус git. Встроенные агенты Explore и Plan [не получают ни того, ни другого](https://code.claude.com/docs/ru/sub-agents.md#what-loads-at-startup), а агент, чьё определение устанавливает [`omitClaudeMd`](https://code.claude.com/docs/ru/sub-agents#supported-frontmatter-fields), запускается без пользовательского, проектного и локального файлов CLAUDE.md.

304> * Любой контекст, который основной агент передаёт в промпте

305>

306> Для [fork](https://code.claude.com/docs/ru/sub-agents.md#fork-the-current-conversation), Claude Code загружает разговор родителя до сих пор, системный prompt и инструменты вместо.

307>

308> **Стоимость контекста:** Изолирована от основной сессии.

309>

310> > [!TIP]

311> >

312> > Используйте subagents для работы, которая не нуждается в вашем полном контексте разговора. Их изоляция предотвращает раздувание вашей основной сессии.

321 313 

322> [!TIP]314> [tab] Hooks

315>

316> **Когда:** При срабатывании. Claude Code запускает hooks при определённых событиях жизненного цикла, таких как выполнение инструмента, границы сессии, отправка prompt, запросы разрешений и компактирование. Подробный список см. в разделе [Hooks](https://code.claude.com/docs/ru/hooks.md).

317>

318> **Что загружается:** Ничего по умолчанию. Hooks работают вне основного разговора.

319>

320> **Стоимость контекста:** Ноль, если hook не возвращает вывод, который добавляется как сообщения в ваш разговор.

323>321>

324> Hooks идеальны для побочных эффектов (линтинг, логирование), которые не должны влиять на контекст Claude.322> > [!TIP]

323> >

324> > Hooks идеальны для побочных эффектов (линтинг, логирование), которые не должны влиять на контекст Claude.

325 325 

326## Узнайте больше326## Узнайте больше

327 327 

328Каждая функция имеет своё собственное руководство с инструкциями по настройке, примерами и параметрами конфигурации.328Каждая функция имеет своё собственное руководство с инструкциями по настройке, примерами и параметрами конфигурации.

329 329 

330> **[CLAUDE.md](https://code.claude.com/docs/ru/memory.md)**330> [card] [CLAUDE.md](https://code.claude.com/docs/ru/memory.md)

331>331>

332> Сохраняйте контекст проекта, соглашения и инструкции332> Сохраняйте контекст проекта, соглашения и инструкции

333 333 

334> **[Skills](https://code.claude.com/docs/ru/skills.md)**334> [card] [Skills](https://code.claude.com/docs/ru/skills.md)

335>335>

336> Дайте Claude экспертизу в области и переиспользуемые рабочие процессы336> Дайте Claude экспертизу в области и переиспользуемые рабочие процессы

337 337 

338> **[Subagents](https://code.claude.com/docs/ru/sub-agents.md)**338> [card] [Subagents](https://code.claude.com/docs/ru/sub-agents.md)

339>339>

340> Перенесите работу в изолированный контекст340> Перенесите работу в изолированный контекст

341 341 

342> **[Dynamic workflows](https://code.claude.com/docs/ru/workflows.md)**342> [card] [Dynamic workflows](https://code.claude.com/docs/ru/workflows.md)

343>343>

344> Запустите много subagents из одного скрипта344> Запустите много subagents из одного скрипта

345 345 

346> **[Cross-session messaging](https://code.claude.com/docs/ru/cross-session-messaging.md)**346> [card] [Cross-session messaging](https://code.claude.com/docs/ru/cross-session-messaging.md)

347>347>

348> Позвольте Claude отправлять сообщения в ваши другие сессии348> Позвольте Claude отправлять сообщения в ваши другие сессии

349 349 

350> **[MCP](https://code.claude.com/docs/ru/mcp.md)**350> [card] [MCP](https://code.claude.com/docs/ru/mcp.md)

351>351>

352> Подключите Claude к внешним сервисам352> Подключите Claude к внешним сервисам

353 353 

354> **[Hooks](https://code.claude.com/docs/ru/hooks-guide.md)**354> [card] [Hooks](https://code.claude.com/docs/ru/hooks-guide.md)

355>355>

356> Автоматизируйте действия с помощью hooks356> Автоматизируйте действия с помощью hooks

357 357 

358> **[Plugins](https://code.claude.com/docs/ru/plugins/overview.md)**358> [card] [Plugins](https://code.claude.com/docs/ru/plugins/overview.md)

359>359>

360> Упакуйте и поделитесь наборами функций360> Упакуйте и поделитесь наборами функций

361 361 

362> **[Marketplaces](https://code.claude.com/docs/ru/plugins/create-marketplace.md)**362> [card] [Marketplaces](https://code.claude.com/docs/ru/plugins/create-marketplace.md)

363>363>

364> Размещайте и распространяйте коллекции plugins364> Размещайте и распространяйте коллекции plugins

Details

73 73 

74Добавьте один из следующих секретов в ваш репозиторий в зависимости от того, как вы аутентифицируетесь. См. руководство GitHub по [использованию секретов в GitHub Actions](https://docs.github.com/en/actions/security-guides/using-secrets-in-github-actions).74Добавьте один из следующих секретов в ваш репозиторий в зависимости от того, как вы аутентифицируетесь. См. руководство GitHub по [использованию секретов в GitHub Actions](https://docs.github.com/en/actions/security-guides/using-secrets-in-github-actions).

75 75 

76* `ANTHROPIC_API_KEY`: Claude API ключ из [Claude Console](https://platform.claude.com)76* `ANTHROPIC_API_KEY`: Claude API-ключ из [Claude Console](https://platform.claude.com)

77* `CLAUDE_CODE_OAUTH_TOKEN`: OAuth токен, который аутентифицируется с вашей подпиской Claude, доступный в планах Pro, Max, Team и Enterprise. Создайте его, запустив `claude setup-token` локально. См. [Создание долгоживущего токена](https://code.claude.com/docs/ru/authentication.md#generate-a-long-lived-token)77* `CLAUDE_CODE_OAUTH_TOKEN`: OAuth токен, который аутентифицируется с вашей подпиской Claude, доступный в планах Pro, Max, Ultra, Team и Enterprise. Создайте его, запустив `claude setup-token` локально. См. [Создание долгоживущего токена](https://code.claude.com/docs/ru/authentication.md#generate-a-long-lived-token)

78 78 

79В файлах рабочего процесса передайте секрет соответствующему входу: `anthropic_api_key` для API ключа или `claude_code_oauth_token` для OAuth токена.79В файлах рабочего процесса передайте секрет соответствующему входу: `anthropic_api_key` для API ключа или `claude_code_oauth_token` для OAuth токена.

80 80 

Details

59 59 

60Настройте облако на доверие токену OIDC, который GitHub выдает рабочему процессу, чтобы каждый запуск рабочего процесса получал краткосрочные облачные учетные данные. Маркеры в каждой вкладке суммируют то, что нужно создать, и каждая вкладка ссылается на собственное руководство облачного провайдера для шагов на уровне консоли.60Настройте облако на доверие токену OIDC, который GitHub выдает рабочему процессу, чтобы каждый запуск рабочего процесса получал краткосрочные облачные учетные данные. Маркеры в каждой вкладке суммируют то, что нужно создать, и каждая вкладка ссылается на собственное руководство облачного провайдера для шагов на уровне консоли.

61 61 

62**Amazon Bedrock**62> [tab] Amazon Bedrock

63 63>

64Создайте конфигурацию доверия в вашем аккаунте AWS, следуя [руководству AWS по созданию поставщиков идентификации OIDC](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_create_oidc.html):64> Создайте конфигурацию доверия в вашем аккаунте AWS, следуя [руководству AWS по созданию поставщиков идентификации OIDC](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_create_oidc.html):

65 65>

66* Добавьте поставщика идентификации GitHub OIDC с URL провайдера `https://token.actions.githubusercontent.com` и аудиторией `sts.amazonaws.com`66> * Добавьте поставщика идентификации GitHub OIDC с URL провайдера `https://token.actions.githubusercontent.com` и аудиторией `sts.amazonaws.com`

67* Создайте роль IAM, которой доверяет этот провайдер как веб-идентификация, и присоедините политику ограниченного вызова из [конфигурации IAM](https://code.claude.com/docs/ru/amazon-bedrock.md#iam-configuration), которая предоставляет `bedrock:InvokeModel`, `bedrock:InvokeModelWithResponseStream`, `bedrock:ListInferenceProfiles` и `bedrock:GetInferenceProfile`, а также два действия подписки `aws-marketplace`67> * Создайте роль IAM, которой доверяет этот провайдер как веб-идентификация, и присоедините политику ограниченного вызова из [конфигурации IAM](https://code.claude.com/docs/ru/amazon-bedrock.md#iam-configuration), которая предоставляет `bedrock:InvokeModel`, `bedrock:InvokeModelWithResponseStream`, `bedrock:ListInferenceProfiles` и `bedrock:GetInferenceProfile`, а также два действия подписки `aws-marketplace`

68* Ограничьте политику доверия роли вашим репозиторием с условием субъекта, таким как `repo:your-org/your-repo:*`. См. [руководство GitHub по усилению безопасности OIDC](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect) для формата утверждения68> * Ограничьте политику доверия роли вашим репозиторием с условием субъекта, таким как `repo:your-org/your-repo:*`. См. [руководство GitHub по усилению безопасности OIDC](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect) для формата утверждения

69 69>

70Запишите ARN роли. Вы добавляете его как секрет на следующем шаге.70> Запишите ARN роли. Вы добавляете его как секрет на следующем шаге.

71 

72**Google Cloud's Agent Platform**

73 

74Создайте ресурсы федерации в вашем проекте Google Cloud, следуя [документации Workload Identity Federation](https://cloud.google.com/iam/docs/workload-identity-federation):

75 

76* Включите три API: IAM Credentials, Security Token Service (STS) и Agent Platform API, имя сервиса которого `aiplatform.googleapis.com`

77* Создайте пул Workload Identity с поставщиком GitHub OIDC, издатель которого `https://token.actions.githubusercontent.com`, и добавьте условие атрибута, которое ограничивает пул вашим репозиторием

78* Создайте выделенный сервисный аккаунт только с ролью `Vertex AI User`, которая является `roles/aiplatform.user`, и разрешите пулу его олицетворять

79 

80Запишите полное имя ресурса провайдера и адрес электронной почты сервисного аккаунта. Вы добавляете их как секреты на следующем шаге.

81 

82**Microsoft Foundry**

83 

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

85 71 

86* Зарегистрируйте приложение Microsoft Entra и добавьте федеративное учетное дание идентификации, которое доверяет токенам, выданным GitHub вашему репозиторию. Управляемое удостоверение, назначенное пользователем, работает вместо приложения. Оба имеют ID клиента, который вы запишите ниже72> [tab] Google Cloud's Agent Platform

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

74> Создайте ресурсы федерации в вашем проекте Google Cloud, следуя [документации Workload Identity Federation](https://cloud.google.com/iam/docs/workload-identity-federation):

75>

76> * Включите три API: IAM Credentials, Security Token Service (STS) и Agent Platform API, имя сервиса которого `aiplatform.googleapis.com`

77> * Создайте пул Workload Identity с поставщиком GitHub OIDC, издатель которого `https://token.actions.githubusercontent.com`, и добавьте условие атрибута, которое ограничивает пул вашим репозиторием

78> * Создайте выделенный сервисный аккаунт только с ролью `Vertex AI User`, которая является `roles/aiplatform.user`, и разрешите пулу его олицетворять

79>

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

88 81 

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

83>

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

85>

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

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

88>

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

90 90 

91**3. Добавьте секреты репозитория**91**3. Добавьте секреты репозитория**

92 92 

116>116>

117> В публичных репозиториях комментарий, содержащий фразу триггера от любого пользователя, запускает этот рабочий процесс. Шаги учетных данных выполняются до того, как Claude Code GitHub Action проверит доступ на запись комментатора, поэтому действие отклоняет неавторизованных пользователей только после того, как рабочий процесс создал токен приложения и вошел в ваш облачный провайдер, что оставляет записи в журнале аудита и потребляет минуты Actions. Чтобы избежать таких запусков, добавьте шаг, который проверяет доступ на запись комментатора перед шагами учетных данных.117> В публичных репозиториях комментарий, содержащий фразу триггера от любого пользователя, запускает этот рабочий процесс. Шаги учетных данных выполняются до того, как Claude Code GitHub Action проверит доступ на запись комментатора, поэтому действие отклоняет неавторизованных пользователей только после того, как рабочий процесс создал токен приложения и вошел в ваш облачный провайдер, что оставляет записи в журнале аудита и потребляет минуты Actions. Чтобы избежать таких запусков, добавьте шаг, который проверяет доступ на запись комментатора перед шагами учетных данных.

118 118 

119**Amazon Bedrock**119> [tab] Amazon Bedrock

120 120>

121Замените значение `aws-region` на свое собственное. Шаг учетных данных экспортирует его как `AWS_REGION` для остальной части задания.121> Замените значение `aws-region` на свое собственное. Шаг учетных данных экспортирует его как `AWS_REGION` для остальной части задания.

122 122>

123```yaml theme={null}123> ```yaml theme={null}

124name: Claude PR Action124> name: Claude PR Action

125 125>

126permissions:126> permissions:

127 contents: write127> contents: write

128 pull-requests: write128> pull-requests: write

129 issues: write129> issues: write

130 id-token: write130> id-token: write

131 131>

132on:132> on:

133 issue_comment:133> issue_comment:

134 types: [created]134> types: [created]

135 pull_request_review_comment:135> pull_request_review_comment:

136 types: [created]136> types: [created]

137 issues:137> issues:

138 types: [opened]138> types: [opened]

139 139>

140jobs:140> jobs:

141 claude-pr:141> claude-pr:

142 if: |142> if: |

143 (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||143> (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||

144 (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||144> (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||

145 (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))145> (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))

146 runs-on: ubuntu-latest146> runs-on: ubuntu-latest

147 steps:147> steps:

148 - name: Checkout repository148> - name: Checkout repository

149 uses: actions/checkout@v6149> uses: actions/checkout@v6

150 150>

151 - name: Generate GitHub App token151> - name: Generate GitHub App token

152 id: app-token152> id: app-token

153 uses: actions/create-github-app-token@v2153> uses: actions/create-github-app-token@v2

154 with:154> with:

155 app-id: ${{ secrets.APP_ID }}155> app-id: ${{ secrets.APP_ID }}

156 private-key: ${{ secrets.APP_PRIVATE_KEY }}156> private-key: ${{ secrets.APP_PRIVATE_KEY }}

157 157>

158 - name: Configure AWS Credentials (OIDC)158> - name: Configure AWS Credentials (OIDC)

159 uses: aws-actions/configure-aws-credentials@v4159> uses: aws-actions/configure-aws-credentials@v4

160 with:160> with:

161 role-to-assume: ${{ secrets.AWS_ROLE_TO_ASSUME }}161> role-to-assume: ${{ secrets.AWS_ROLE_TO_ASSUME }}

162 aws-region: us-west-2162> aws-region: us-west-2

163 163>

164 - uses: anthropics/claude-code-action@v1164> - uses: anthropics/claude-code-action@v1

165 with:165> with:

166 github_token: ${{ steps.app-token.outputs.token }}166> github_token: ${{ steps.app-token.outputs.token }}

167 use_bedrock: "true"167> use_bedrock: "true"

168 claude_args: '--model us.anthropic.claude-sonnet-4-6'168> claude_args: '--model us.anthropic.claude-sonnet-4-6'

169```169> ```

170 170>

171> [!TIP]171> > [!TIP]

172>172> >

173> Идентификаторы моделей Bedrock включают префикс профиля кросс-региональной инференции, такой как `us.`. Используйте префикс для группы регионов, где вы предоставили доступ к модели.173> > Идентификаторы моделей Bedrock включают префикс профиля кросс-региональной инференции, такой как `us.`. Используйте префикс для группы регионов, где вы предоставили доступ к модели.

174 174 

175**Google Cloud's Agent Platform**175> [tab] Google Cloud's Agent Platform

176 176>

177Замените значение `CLOUD_ML_REGION` на свое собственное. Вам не нужно жестко кодировать ID проекта, потому что рабочий процесс читает его из выходных данных шага `auth`.177> Замените значение `CLOUD_ML_REGION` на свое собственное. Вам не нужно жестко кодировать ID проекта, потому что рабочий процесс читает его из выходных данных шага `auth`.

178 178>

179```yaml theme={null}179> ```yaml theme={null}

180name: Claude PR Action180> name: Claude PR Action

181 181>

182permissions:182> permissions:

183 contents: write183> contents: write

184 pull-requests: write184> pull-requests: write

185 issues: write185> issues: write

186 id-token: write186> id-token: write

187 187>

188on:188> on:

189 issue_comment:189> issue_comment:

190 types: [created]190> types: [created]

191 pull_request_review_comment:191> pull_request_review_comment:

192 types: [created]192> types: [created]

193 issues:193> issues:

194 types: [opened]194> types: [opened]

195 195>

196jobs:196> jobs:

197 claude-pr:197> claude-pr:

198 if: |198> if: |

199 (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||199> (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||

200 (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||200> (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||

201 (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))201> (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))

202 runs-on: ubuntu-latest202> runs-on: ubuntu-latest

203 steps:203> steps:

204 - name: Checkout repository204> - name: Checkout repository

205 uses: actions/checkout@v6205> uses: actions/checkout@v6

206 206>

207 - name: Generate GitHub App token207> - name: Generate GitHub App token

208 id: app-token208> id: app-token

209 uses: actions/create-github-app-token@v2209> uses: actions/create-github-app-token@v2

210 with:210> with:

211 app-id: ${{ secrets.APP_ID }}211> app-id: ${{ secrets.APP_ID }}

212 private-key: ${{ secrets.APP_PRIVATE_KEY }}212> private-key: ${{ secrets.APP_PRIVATE_KEY }}

213 213>

214 - name: Authenticate to Google Cloud214> - name: Authenticate to Google Cloud

215 id: auth215> id: auth

216 uses: google-github-actions/auth@v2216> uses: google-github-actions/auth@v2

217 with:217> with:

218 workload_identity_provider: ${{ secrets.GCP_WORKLOAD_IDENTITY_PROVIDER }}218> workload_identity_provider: ${{ secrets.GCP_WORKLOAD_IDENTITY_PROVIDER }}

219 service_account: ${{ secrets.GCP_SERVICE_ACCOUNT }}219> service_account: ${{ secrets.GCP_SERVICE_ACCOUNT }}

220 220>

221 - uses: anthropics/claude-code-action@v1221> - uses: anthropics/claude-code-action@v1

222 with:222> with:

223 github_token: ${{ steps.app-token.outputs.token }}223> github_token: ${{ steps.app-token.outputs.token }}

224 use_vertex: "true"224> use_vertex: "true"

225 claude_args: '--model claude-sonnet-5'225> claude_args: '--model claude-sonnet-5'

226 env:226> env:

227 ANTHROPIC_VERTEX_PROJECT_ID: ${{ steps.auth.outputs.project_id }}227> ANTHROPIC_VERTEX_PROJECT_ID: ${{ steps.auth.outputs.project_id }}

228 CLOUD_ML_REGION: us-east5228> CLOUD_ML_REGION: us-east5

229```229> ```

230 230 

231**Microsoft Foundry**231> [tab] Microsoft Foundry

232 232>

233Замените `your-resource-name` на имя вашего ресурса Foundry. Claude Code строит URL конечной точки из него. Шаг `azure/login` входит с помощью токена OIDC рабочего процесса, и Claude Code подхватывает учетные данные через цепь [учетных данных по умолчанию](https://learn.microsoft.com/en-us/azure/developer/javascript/sdk/authentication/credential-chains#defaultazurecredential-overview) Azure.233> Замените `your-resource-name` на имя вашего ресурса Foundry. Claude Code строит URL конечной точки из него. Шаг `azure/login` входит с помощью токена OIDC рабочего процесса, и Claude Code подхватывает учетные данные через цепь [учетных данных по умолчанию](https://learn.microsoft.com/en-us/azure/developer/javascript/sdk/authentication/credential-chains#defaultazurecredential-overview) Azure.

234 234>

235```yaml theme={null}235> ```yaml theme={null}

236name: Claude PR Action236> name: Claude PR Action

237 237>

238permissions:238> permissions:

239 contents: write239> contents: write

240 pull-requests: write240> pull-requests: write

241 issues: write241> issues: write

242 id-token: write242> id-token: write

243 243>

244on:244> on:

245 issue_comment:245> issue_comment:

246 types: [created]246> types: [created]

247 pull_request_review_comment:247> pull_request_review_comment:

248 types: [created]248> types: [created]

249 issues:249> issues:

250 types: [opened]250> types: [opened]

251 251>

252jobs:252> jobs:

253 claude-pr:253> claude-pr:

254 if: |254> if: |

255 (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||255> (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||

256 (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||256> (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||

257 (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))257> (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))

258 runs-on: ubuntu-latest258> runs-on: ubuntu-latest

259 steps:259> steps:

260 - name: Checkout repository260> - name: Checkout repository

261 uses: actions/checkout@v6261> uses: actions/checkout@v6

262 262>

263 - name: Generate GitHub App token263> - name: Generate GitHub App token

264 id: app-token264> id: app-token

265 uses: actions/create-github-app-token@v2265> uses: actions/create-github-app-token@v2

266 with:266> with:

267 app-id: ${{ secrets.APP_ID }}267> app-id: ${{ secrets.APP_ID }}

268 private-key: ${{ secrets.APP_PRIVATE_KEY }}268> private-key: ${{ secrets.APP_PRIVATE_KEY }}

269 269>

270 - name: Authenticate to Azure270> - name: Authenticate to Azure

271 uses: azure/login@v2271> uses: azure/login@v2

272 with:272> with:

273 client-id: ${{ secrets.AZURE_CLIENT_ID }}273> client-id: ${{ secrets.AZURE_CLIENT_ID }}

274 tenant-id: ${{ secrets.AZURE_TENANT_ID }}274> tenant-id: ${{ secrets.AZURE_TENANT_ID }}

275 subscription-id: ${{ secrets.AZURE_SUBSCRIPTION_ID }}275> subscription-id: ${{ secrets.AZURE_SUBSCRIPTION_ID }}

276 276>

277 - uses: anthropics/claude-code-action@v1277> - uses: anthropics/claude-code-action@v1

278 with:278> with:

279 github_token: ${{ steps.app-token.outputs.token }}279> github_token: ${{ steps.app-token.outputs.token }}

280 use_foundry: "true"280> use_foundry: "true"

281 claude_args: '--model claude-sonnet-5'281> claude_args: '--model claude-sonnet-5'

282 env:282> env:

283 ANTHROPIC_FOUNDRY_RESOURCE: your-resource-name283> ANTHROPIC_FOUNDRY_RESOURCE: your-resource-name

284```284> ```

285 285>

286> [!TIP]286> > [!TIP]

287>287> >

288> Используйте ID модели, который соответствует развертыванию Claude в вашем ресурсе Foundry. См. [Claude Code на Microsoft Foundry](https://code.claude.com/docs/ru/microsoft-foundry.md) для конфигурации модели и закрепления версии.288> > Используйте ID модели, который соответствует развертыванию Claude в вашем ресурсе Foundry. См. [Claude Code на Microsoft Foundry](https://code.claude.com/docs/ru/microsoft-foundry.md) для конфигурации модели и закрепления версии.

289 289 

290С любым провайдером вы можете ограничить длину запуска и стоимость, добавив `--max-turns` к `claude_args`. См. [Управление затратами](https://code.claude.com/docs/ru/github-actions.md#manage-costs).290С любым провайдером вы можете ограничить длину запуска и стоимость, добавив `--max-turns` к `claude_args`. См. [Управление затратами](https://code.claude.com/docs/ru/github-actions.md#manage-costs).

291 291 

gitlab-ci-cd.md +52 −52

Details

158 158 

159Для корпоративных сред вы можете запустить Claude Code полностью на инфраструктуре вашего облака с тем же опытом разработчика.159Для корпоративных сред вы можете запустить Claude Code полностью на инфраструктуре вашего облака с тем же опытом разработчика.

160 160 

161**Amazon Bedrock**161> [tab] Amazon Bedrock

162 162>

163### Предварительные требования163> ### Предварительные требования

164 164>

165Перед настройкой Claude Code с Amazon Bedrock вам потребуется:165> Перед настройкой Claude Code с Amazon Bedrock вам потребуется:

166 166>

1671. Учетная запись AWS с доступом к Amazon Bedrock для нужных моделей Claude167> 1. Учетная запись AWS с доступом к Amazon Bedrock для нужных моделей Claude

1682. GitLab, настроенный как поставщик идентификации OIDC в AWS IAM168> 2. GitLab, настроенный как поставщик идентификации OIDC в AWS IAM

1693. Роль IAM с разрешениями Amazon Bedrock и политикой доверия, ограниченной вашим проектом/ссылками GitLab169> 3. Роль IAM с разрешениями Amazon Bedrock и политикой доверия, ограниченной вашим проектом/ссылками GitLab

1704. Переменные GitLab CI/CD для предположения роли:170> 4. Переменные GitLab CI/CD для предположения роли:

171 * `AWS_ROLE_TO_ASSUME` (ARN роли)171> * `AWS_ROLE_TO_ASSUME` (ARN роли)

172 * `AWS_REGION` (регион Amazon Bedrock)172> * `AWS_REGION` (регион Amazon Bedrock)

173 173>

174### Инструкции по настройке174> ### Инструкции по настройке

175 175>

176Настройте AWS, чтобы разрешить заданиям GitLab CI предполагать роль IAM через OIDC (без статических ключей).176> Настройте AWS, чтобы разрешить заданиям GitLab CI предполагать роль IAM через OIDC (без статических ключей).

177 177>

178**Требуемая настройка:**178> **Требуемая настройка:**

179 179>

1801. Включите Amazon Bedrock и запросите доступ к целевым моделям Claude180> 1. Включите Amazon Bedrock и запросите доступ к целевым моделям Claude

1812. Создайте поставщика OIDC IAM для GitLab, если он еще не существует181> 2. Создайте поставщика OIDC IAM для GitLab, если он еще не существует

1823. Создайте роль IAM, доверяющую поставщику OIDC GitLab, ограниченную вашим проектом и защищенными ссылками182> 3. Создайте роль IAM, доверяющую поставщику OIDC GitLab, ограниченную вашим проектом и защищенными ссылками

1834. Присоедините разрешения с минимальными привилегиями для API вызова Amazon Bedrock183> 4. Присоедините разрешения с минимальными привилегиями для API вызова Amazon Bedrock

184 184>

185Используйте [пример задания Amazon Bedrock](#configuration-examples) для обмена токена OIDC задания на временные учетные данные AWS во время выполнения.185> Используйте [пример задания Amazon Bedrock](#configuration-examples) для обмена токена OIDC задания на временные учетные данные AWS во время выполнения.

186 

187**Google Cloud's Agent Platform**

188 

189### Предварительные требования

190 

191Перед настройкой Claude Code с Google Cloud's Agent Platform вам потребуется:

192 

1931. Проект Google Cloud с:

194 * включенным API Google Cloud's Agent Platform

195 * настроенной федерацией рабочей нагрузки для доверия OIDC GitLab

1962. Выделенная учетная запись службы только с требуемыми ролями Google Cloud's Agent Platform

1973. Переменные GitLab CI/CD:

198 * `GCP_WORKLOAD_IDENTITY_PROVIDER` (имя ресурса поставщика без префикса `//iam.googleapis.com/`, например `projects/123456789/locations/global/workloadIdentityPools/my-pool/providers/my-provider`)

199 * `GCP_SERVICE_ACCOUNT` (адрес электронной почты учетной записи службы)

200 * `GCP_PROJECT_ID` (идентификатор проекта Google Cloud)

201 

202### Инструкции по настройке

203 

204Настройте Google Cloud, чтобы разрешить заданиям GitLab CI олицетворять учетную запись службы через федерацию рабочей нагрузки.

205 

206**Требуемая настройка:**

207 

2081. Включите API учетных данных IAM, API STS и API Google Cloud's Agent Platform

2092. Создайте пул рабочей нагрузки и поставщика для OIDC GitLab

2103. Создайте выделенную учетную запись службы с ролями Google Cloud's Agent Platform

2114. Предоставьте субъекту WIF разрешение на олицетворение учетной записи службы

212 186 

213Используйте [пример задания Agent Platform](#configuration-examples) для аутентификации без сохранения ключей.187> [tab] Google Cloud's Agent Platform

188>

189> ### Предварительные требования

190>

191> Перед настройкой Claude Code с Google Cloud's Agent Platform вам потребуется:

192>

193> 1. Проект Google Cloud с:

194> * включенным API Google Cloud's Agent Platform

195> * настроенной федерацией рабочей нагрузки для доверия OIDC GitLab

196> 2. Выделенная учетная запись службы только с требуемыми ролями Google Cloud's Agent Platform

197> 3. Переменные GitLab CI/CD:

198> * `GCP_WORKLOAD_IDENTITY_PROVIDER` (имя ресурса поставщика без префикса `//iam.googleapis.com/`, например `projects/123456789/locations/global/workloadIdentityPools/my-pool/providers/my-provider`)

199> * `GCP_SERVICE_ACCOUNT` (адрес электронной почты учетной записи службы)

200> * `GCP_PROJECT_ID` (идентификатор проекта Google Cloud)

201>

202> ### Инструкции по настройке

203>

204> Настройте Google Cloud, чтобы разрешить заданиям GitLab CI олицетворять учетную запись службы через федерацию рабочей нагрузки.

205>

206> **Требуемая настройка:**

207>

208> 1. Включите API учетных данных IAM, API STS и API Google Cloud's Agent Platform

209> 2. Создайте пул рабочей нагрузки и поставщика для OIDC GitLab

210> 3. Создайте выделенную учетную запись службы с ролями Google Cloud's Agent Platform

211> 4. Предоставьте субъекту WIF разрешение на олицетворение учетной записи службы

212>

213> Используйте [пример задания Agent Platform](#configuration-examples) для аутентификации без сохранения ключей.

214 214 

215## Примеры конфигурации215## Примеры конфигурации

216 216 

glossary.md +5 −2

Details

54 54 

55### Auto mode55### Auto mode

56 56 

57[Permission mode](#permission-mode), в котором отдельная модель классификатора проверяет действия вместо вас, поэтому Claude Code выполняет большинство из них без вашего запроса. Claude Code по-прежнему просит вас перед действиями, которые соответствуют вашим явным правилам запроса. Начиная с Claude Code v2.1.283 или более поздней версии, auto mode является [встроенным начальным режимом разрешений](https://code.claude.com/docs/ru/permission-modes.md#which-mode-a-session-starts-in) для интерактивного терминала и сеансов VS Code, а в более ранних версиях только на планах Pro, Max и Team. Классификатор блокирует расширение области действия, ненадежную инфраструктуру и [prompt injection](#prompt-injection). Результаты инструментов удаляются из того, что он видит, поэтому враждебный контент в файле или веб-странице не может манипулировать им напрямую.57[Режим разрешений](#permission-mode), в котором отдельная модель-классификатор проверяет действия вместо вас, поэтому Claude Code выполняет большинство из них, не спрашивая вас. Claude Code по-прежнему спрашивает вас перед действиями, которым соответствуют ваши явные правила ask. Классификатор блокирует расширение области действия, ненадежную инфраструктуру и [промпт-инъекции](#prompt-injection). Результаты инструментов удаляются из того, что он видит, поэтому враждебный контент в файле или на веб-странице не может напрямую им манипулировать.

58 

59* **Claude Code v2.1.283 или более поздней версии**: авторежим является [встроенным начальным режимом разрешений](https://code.claude.com/docs/ru/permission-modes.md#which-mode-a-session-starts-in) для интерактивных сессий в терминале и VS Code

60* **Более ранние версии**: авторежим является встроенным начальным режимом разрешений только на планах Pro, Max, Ultra и Team

58 61 

59Подробнее: [Eliminate prompts with auto mode](https://code.claude.com/docs/ru/permission-modes.md#eliminate-prompts-with-auto-mode)62Подробнее: [Eliminate prompts with auto mode](https://code.claude.com/docs/ru/permission-modes.md#eliminate-prompts-with-auto-mode)

60 63 

140 143 

141### Dispatch144### Dispatch

142 145 

143Инициируемый телефоном маршрутизатор задач, который порождает сеанс Claude Code в приложении Desktop, когда вы отправляете задачу кодирования из мобильного приложения Claude. Ваш prompt маршрутизируется к правильному tool автоматически. Доступно на планах Pro и Max.146Инициируемый телефоном маршрутизатор задач, который запускает сессию Claude Code в приложении Desktop, когда вы отправляете задачу кодирования из мобильного приложения Claude. Ваш промпт автоматически направляется к нужному инструменту. Доступно на планах Pro, Max и Ultra.

144 147 

145Подробнее: [Sessions from Dispatch](https://code.claude.com/docs/ru/desktop.md#sessions-from-dispatch)148Подробнее: [Sessions from Dispatch](https://code.claude.com/docs/ru/desktop.md#sessions-from-dispatch)

146 149 

hooks.md +411 −411

Details

68 68 

69Чтобы увидеть, как событие, фильтр и обработчик работают вместе, рассмотрим этот hook `PreToolUse`, который блокирует деструктивные команды оболочки.69Чтобы увидеть, как событие, фильтр и обработчик работают вместе, рассмотрим этот hook `PreToolUse`, который блокирует деструктивные команды оболочки.

70 70 

71**macOS/Linux**71> [tab] macOS/Linux

72 72>

73Фильтр `matcher` сужает область до вызовов инструмента Bash, а условие `if` сужает её дальше до команд Bash, совпадающих с `rm *`, поэтому `block-rm.sh` запускается только когда оба фильтра совпадают:73> Фильтр `matcher` сужает область до вызовов инструмента Bash, а условие `if` сужает её дальше до команд Bash, совпадающих с `rm *`, поэтому `block-rm.sh` запускается только когда оба фильтра совпадают:

74 74>

75```json theme={null}75> ```json theme={null}

76{76> {

77 "hooks": {77> "hooks": {

78 "PreToolUse": [78> "PreToolUse": [

79 {79> {

80 "matcher": "Bash",80> "matcher": "Bash",

81 "hooks": [81> "hooks": [

82 {82> {

83 "type": "command",83> "type": "command",

84 "if": "Bash(rm *)",84> "if": "Bash(rm *)",

85 "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/block-rm.sh",85> "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/block-rm.sh",

86 "args": []86> "args": []

87 }87> }

88 ]88> ]

89 }89> }

90 ]90> ]

91 }91> }

92}92> }

93```93> ```

94 94>

95Скрипт читает JSON входные данные из stdin, извлекает команду и возвращает `permissionDecision` со значением `"deny"`, если она содержит `rm -rf`. Сохраните его в `.claude/hooks/block-rm.sh` в вашем проекте и сделайте его исполняемым с помощью `chmod +x .claude/hooks/block-rm.sh`, чтобы Claude Code мог его запустить:95> Скрипт читает JSON входные данные из stdin, извлекает команду и возвращает `permissionDecision` со значением `"deny"`, если она содержит `rm -rf`. Сохраните его в `.claude/hooks/block-rm.sh` в вашем проекте и сделайте его исполняемым с помощью `chmod +x .claude/hooks/block-rm.sh`, чтобы Claude Code мог его запустить:

96 96>

97```bash theme={null}97> ```bash theme={null}

98#!/bin/bash98> #!/bin/bash

99# .claude/hooks/block-rm.sh99> # .claude/hooks/block-rm.sh

100COMMAND=$(jq -r '.tool_input.command')100> COMMAND=$(jq -r '.tool_input.command')

101 101>

102if echo "$COMMAND" | grep -q 'rm -rf'; then102> if echo "$COMMAND" | grep -q 'rm -rf'; then

103 jq -n '{103> jq -n '{

104 hookSpecificOutput: {104> hookSpecificOutput: {

105 hookEventName: "PreToolUse",105> hookEventName: "PreToolUse",

106 permissionDecision: "deny",106> permissionDecision: "deny",

107 permissionDecisionReason: "Destructive command blocked by hook"107> permissionDecisionReason: "Destructive command blocked by hook"

108 }108> }

109 }'109> }'

110else110> else

111 exit 0 # no decision; normal permission flow applies111> exit 0 # no decision; normal permission flow applies

112fi112> fi

113```113> ```

114 114>

115Этот скрипт, как и другие примеры Bash на этой странице, которые анализируют JSON входные данные, использует `jq`, поэтому установите `jq` и убедитесь, что он находится в вашем `PATH` перед попыткой их использования.115> Этот скрипт, как и другие примеры Bash на этой странице, которые анализируют JSON входные данные, использует `jq`, поэтому установите `jq` и убедитесь, что он находится в вашем `PATH` перед попыткой их использования.

116 

117**Windows (PowerShell)**

118 

119Фильтр `Bash|PowerShell` охватывает [инструмент PowerShell](#powershell) а также Bash. Одно правило `if` совпадает только с вызовами одного инструмента, поэтому каждый инструмент получает свой обработчик: первый сужает область до команд Bash, совпадающих с `rm *`, второй — до команд PowerShell, совпадающих с `Remove-Item *`. Оба запускают один и тот же скрипт через `powershell.exe`:

120 

121```json theme={null}

122{

123 "hooks": {

124 "PreToolUse": [

125 {

126 "matcher": "Bash|PowerShell",

127 "hooks": [

128 {

129 "type": "command",

130 "if": "Bash(rm *)",

131 "command": "powershell.exe",

132 "args": [

133 "-NoProfile",

134 "-ExecutionPolicy",

135 "Bypass",

136 "-File",

137 "${CLAUDE_PROJECT_DIR}/.claude/hooks/block-rm.ps1"

138 ]

139 },

140 {

141 "type": "command",

142 "if": "PowerShell(Remove-Item *)",

143 "command": "powershell.exe",

144 "args": [

145 "-NoProfile",

146 "-ExecutionPolicy",

147 "Bypass",

148 "-File",

149 "${CLAUDE_PROJECT_DIR}/.claude/hooks/block-rm.ps1"

150 ]

151 }

152 ]

153 }

154 ]

155 }

156}

157```

158 

159Флаг `-NoProfile` пропускает загрузку вашего профиля PowerShell, чтобы hook запустился быстро, а `-ExecutionPolicy Bypass` позволяет PowerShell запустить локальный файл скрипта.

160 

161Скрипт читает JSON входные данные из stdin, извлекает команду и возвращает `permissionDecision` со значением `"deny"`, если она содержит `rm -rf` или `Remove-Item` с последующим `-Recurse`. Сохраните его в `.claude/hooks/block-rm.ps1` в вашем проекте:

162 

163```powershell theme={null}

164# .claude/hooks/block-rm.ps1

165$callInput = [Console]::In.ReadToEnd() | ConvertFrom-Json

166$command = $callInput.tool_input.command

167 116 

168if ($command -match 'rm -rf|Remove-Item.*-Recurse') {117> [tab] Windows (PowerShell)

169 @{118>

170 hookSpecificOutput = @{119> Фильтр `Bash|PowerShell` охватывает [инструмент PowerShell](#powershell) а также Bash. Одно правило `if` совпадает только с вызовами одного инструмента, поэтому каждый инструмент получает свой обработчик: первый сужает область до команд Bash, совпадающих с `rm *`, второй — до команд PowerShell, совпадающих с `Remove-Item *`. Оба запускают один и тот же скрипт через `powershell.exe`:

171 hookEventName = "PreToolUse"120>

172 permissionDecision = "deny"121> ```json theme={null}

173 permissionDecisionReason = "Destructive command blocked by hook"122> {

174 }123> "hooks": {

175 } | ConvertTo-Json124> "PreToolUse": [

176} else {125> {

177 exit 0 # no decision; normal permission flow applies126> "matcher": "Bash|PowerShell",

178}127> "hooks": [

179```128> {

129> "type": "command",

130> "if": "Bash(rm *)",

131> "command": "powershell.exe",

132> "args": [

133> "-NoProfile",

134> "-ExecutionPolicy",

135> "Bypass",

136> "-File",

137> "${CLAUDE_PROJECT_DIR}/.claude/hooks/block-rm.ps1"

138> ]

139> },

140> {

141> "type": "command",

142> "if": "PowerShell(Remove-Item *)",

143> "command": "powershell.exe",

144> "args": [

145> "-NoProfile",

146> "-ExecutionPolicy",

147> "Bypass",

148> "-File",

149> "${CLAUDE_PROJECT_DIR}/.claude/hooks/block-rm.ps1"

150> ]

151> }

152> ]

153> }

154> ]

155> }

156> }

157> ```

158>

159> Флаг `-NoProfile` пропускает загрузку вашего профиля PowerShell, чтобы hook запустился быстро, а `-ExecutionPolicy Bypass` позволяет PowerShell запустить локальный файл скрипта.

160>

161> Скрипт читает JSON входные данные из stdin, извлекает команду и возвращает `permissionDecision` со значением `"deny"`, если она содержит `rm -rf` или `Remove-Item` с последующим `-Recurse`. Сохраните его в `.claude/hooks/block-rm.ps1` в вашем проекте:

162>

163> ```powershell theme={null}

164> # .claude/hooks/block-rm.ps1

165> $callInput = [Console]::In.ReadToEnd() | ConvertFrom-Json

166> $command = $callInput.tool_input.command

167>

168> if ($command -match 'rm -rf|Remove-Item.*-Recurse') {

169> @{

170> hookSpecificOutput = @{

171> hookEventName = "PreToolUse"

172> permissionDecision = "deny"

173> permissionDecisionReason = "Destructive command blocked by hook"

174> }

175> } | ConvertTo-Json

176> } else {

177> exit 0 # no decision; normal permission flow applies

178> }

179> ```

180 180 

181Теперь предположим, что Claude Code решает запустить `Bash "rm -rf /tmp/build"` с конфигурацией macOS/Linux. Вот что происходит:181Теперь предположим, что Claude Code решает запустить `Bash "rm -rf /tmp/build"` с конфигурацией macOS/Linux. Вот что происходит:

182 182 

601 601 

602Предпочитайте [exec form](#exec-form-and-shell-form) для любого hook, который ссылается на path placeholder. В shell form оберните каждый заполнитель в двойные кавычки.602Предпочитайте [exec form](#exec-form-and-shell-form) для любого hook, который ссылается на path placeholder. В shell form оберните каждый заполнитель в двойные кавычки.

603 603 

604**Project scripts**604> [tab] Project scripts

605 605>

606Этот пример использует `${CLAUDE_PROJECT_DIR}` для запуска проверки стиля из каталога `.claude/hooks/` проекта после любого вызова инструмента `Write` или `Edit`:606> Этот пример использует `${CLAUDE_PROJECT_DIR}` для запуска проверки стиля из каталога `.claude/hooks/` проекта после любого вызова инструмента `Write` или `Edit`:

607 607>

608```json theme={null}608> ```json theme={null}

609{609> {

610 "hooks": {610> "hooks": {

611 "PostToolUse": [611> "PostToolUse": [

612 {612> {

613 "matcher": "Write|Edit",613> "matcher": "Write|Edit",

614 "hooks": [614> "hooks": [

615 {615> {

616 "type": "command",616> "type": "command",

617 "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/check-style.sh",617> "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/check-style.sh",

618 "args": []618> "args": []

619 }619> }

620 ]620> ]

621 }621> }

622 ]622> ]

623 }623> }

624}624> }

625```625> ```

626 626 

627**Plugin scripts**627> [tab] Plugin scripts

628 628>

629Определите plugin hooks в `hooks/hooks.json` с опциональным полем `description` верхнего уровня. Когда плагин включен, его hooks объединяются с вашими пользовательскими и проектными hooks.629> Определите plugin hooks в `hooks/hooks.json` с опциональным полем `description` верхнего уровня. Когда плагин включен, его hooks объединяются с вашими пользовательскими и проектными hooks.

630 630>

631Этот пример запускает скрипт форматирования, поставляемый с плагином:631> Этот пример запускает скрипт форматирования, поставляемый с плагином:

632 632>

633```json theme={null}633> ```json theme={null}

634{634> {

635 "description": "Automatic code formatting",635> "description": "Automatic code formatting",

636 "hooks": {636> "hooks": {

637 "PostToolUse": [637> "PostToolUse": [

638 {638> {

639 "matcher": "Write|Edit",639> "matcher": "Write|Edit",

640 "hooks": [640> "hooks": [

641 {641> {

642 "type": "command",642> "type": "command",

643 "command": "${CLAUDE_PLUGIN_ROOT}/scripts/format.sh",643> "command": "${CLAUDE_PLUGIN_ROOT}/scripts/format.sh",

644 "args": [],644> "args": [],

645 "timeout": 30645> "timeout": 30

646 }646> }

647 ]647> ]

648 }648> }

649 ]649> ]

650 }650> }

651}651> }

652```652> ```

653 653>

654См. [plugin components reference](https://code.claude.com/docs/ru/plugins/components.md#hooks) для получения подробной информации о создании plugin hooks.654> См. [plugin components reference](https://code.claude.com/docs/ru/plugins/components.md#hooks) для получения подробной информации о создании plugin hooks.

655 655 

656### Hooks in skills and agents656### Hooks in skills and agents

657 657 

1180 1180 

1181Вот примеры каждого шаблона в действии:1181Вот примеры каждого шаблона в действии:

1182 1182 

1183**decision верхнего уровня**1183> [tab] decision верхнего уровня

1184 1184>

1185Единственное значение для `decision` — `"block"`. Чтобы разрешить продолжение действия, не указывайте `decision` в вашем JSON или завершитесь с кодом 0 вообще без JSON:1185> Единственное значение для `decision` — `"block"`. Чтобы разрешить продолжение действия, не указывайте `decision` в вашем JSON или завершитесь с кодом 0 вообще без JSON:

1186 1186>

1187```json theme={null}1187> ```json theme={null}

1188{1188> {

1189 "decision": "block",1189> "decision": "block",

1190 "reason": "Test suite must pass before proceeding"1190> "reason": "Test suite must pass before proceeding"

1191}1191> }

1192```1192> ```

1193 1193 

1194**PreToolUse**1194> [tab] PreToolUse

1195 1195>

1196Использует `hookSpecificOutput` для более развитого управления: разрешить, отклонить или передать решение пользователю. Вы также можете изменить входные данные инструмента перед его запуском или внедрить дополнительный контекст для Claude. Смотрите [Управление решениями PreToolUse](#pretooluse-decision-control), чтобы узнать обо всех доступных параметрах.1196> Использует `hookSpecificOutput` для более развитого управления: разрешить, отклонить или передать решение пользователю. Вы также можете изменить входные данные инструмента перед его запуском или внедрить дополнительный контекст для Claude. Смотрите [Управление решениями PreToolUse](#pretooluse-decision-control), чтобы узнать обо всех доступных параметрах.

1197 1197>

1198```json theme={null}1198> ```json theme={null}

1199{1199> {

1200 "hookSpecificOutput": {1200> "hookSpecificOutput": {

1201 "hookEventName": "PreToolUse",1201> "hookEventName": "PreToolUse",

1202 "permissionDecision": "deny",1202> "permissionDecision": "deny",

1203 "permissionDecisionReason": "Database writes are not allowed"1203> "permissionDecisionReason": "Database writes are not allowed"

1204 }1204> }

1205}1205> }

1206```1206> ```

1207 1207 

1208**PermissionRequest**1208> [tab] PermissionRequest

1209 1209>

1210Использует `hookSpecificOutput`, чтобы разрешить или отклонить запрос разрешения от имени пользователя. При разрешении вы также можете изменить входные данные инструмента или применить правила разрешений, чтобы пользователю не пришлось подтверждать снова. Смотрите [Управление решениями PermissionRequest](#permissionrequest-decision-control), чтобы узнать обо всех доступных параметрах.1210> Использует `hookSpecificOutput`, чтобы разрешить или отклонить запрос разрешения от имени пользователя. При разрешении вы также можете изменить входные данные инструмента или применить правила разрешений, чтобы пользователю не пришлось подтверждать снова. Смотрите [Управление решениями PermissionRequest](#permissionrequest-decision-control), чтобы узнать обо всех доступных параметрах.

1211 1211>

1212```json theme={null}1212> ```json theme={null}

1213{1213> {

1214 "hookSpecificOutput": {1214> "hookSpecificOutput": {

1215 "hookEventName": "PermissionRequest",1215> "hookEventName": "PermissionRequest",

1216 "decision": {1216> "decision": {

1217 "behavior": "allow",1217> "behavior": "allow",

1218 "updatedInput": {1218> "updatedInput": {

1219 "command": "npm run lint"1219> "command": "npm run lint"

1220 }1220> }

1221 }1221> }

1222 }1222> }

1223}1223> }

1224```1224> ```

1225 1225 

1226Расширенные примеры, включая проверку команд Bash, фильтрацию промптов и скрипты автоматического одобрения, смотрите в разделе [Что можно автоматизировать](https://code.claude.com/docs/ru/hooks-guide.md#what-you-can-automate) руководства и в [эталонной реализации валидатора команд Bash](https://github.com/anthropics/claude-code/blob/main/examples/hooks/bash_command_validator_example.py).1226Расширенные примеры, включая проверку команд Bash, фильтрацию промптов и скрипты автоматического одобрения, смотрите в разделе [Что можно автоматизировать](https://code.claude.com/docs/ru/hooks-guide.md#what-you-can-automate) руководства и в [эталонной реализации валидатора команд Bash](https://github.com/anthropics/claude-code/blob/main/examples/hooks/bash_command_validator_example.py).

1227 1227 

1656 1656 

1657Этот пример убирает форматирование markdown из ответов Claude для отображения обычным текстом. Скрипт считывает каждую партию из stdin, удаляет из `delta` маркеры полужирного шрифта и обратные кавычки встроенного кода и возвращает результат как `displayContent`.1657Этот пример убирает форматирование markdown из ответов Claude для отображения обычным текстом. Скрипт считывает каждую партию из stdin, удаляет из `delta` маркеры полужирного шрифта и обратные кавычки встроенного кода и возвращает результат как `displayContent`.

1658 1658 

1659**macOS/Linux**1659> [tab] macOS/Linux

1660 1660>

1661Зарегистрируйте командный хук для события в файле настроек:1661> Зарегистрируйте командный хук для события в файле настроек:

1662 1662>

1663```json theme={null}1663> ```json theme={null}

1664{1664> {

1665 "hooks": {1665> "hooks": {

1666 "MessageDisplay": [1666> "MessageDisplay": [

1667 {1667> {

1668 "hooks": [1668> "hooks": [

1669 {1669> {

1670 "type": "command",1670> "type": "command",

1671 "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/plain-display.sh",1671> "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/plain-display.sh",

1672 "args": []1672> "args": []

1673 }1673> }

1674 ]1674> ]

1675 }1675> }

1676 ]1676> ]

1677 }1677> }

1678}1678> }

1679```1679> ```

1680 1680>

1681Сохраните этот скрипт в `.claude/hooks/plain-display.sh` в своём проекте и сделайте его исполняемым с помощью `chmod +x`:1681> Сохраните этот скрипт в `.claude/hooks/plain-display.sh` в своём проекте и сделайте его исполняемым с помощью `chmod +x`:

1682 1682>

1683```bash theme={null}1683> ```bash theme={null}

1684#!/bin/bash1684> #!/bin/bash

1685jq '{hookSpecificOutput: {hookEventName: "MessageDisplay", displayContent: (.delta | gsub("\\*\\*"; "") | gsub("`"; ""))}}'1685> jq '{hookSpecificOutput: {hookEventName: "MessageDisplay", displayContent: (.delta | gsub("\\*\\*"; "") | gsub("`"; ""))}}'

1686```1686> ```

1687 

1688**Windows (PowerShell)**

1689 

1690Зарегистрируйте командный хук, который запускает скрипт через PowerShell:

1691 

1692```json theme={null}

1693{

1694 "hooks": {

1695 "MessageDisplay": [

1696 {

1697 "hooks": [

1698 {

1699 "type": "command",

1700 "command": "powershell.exe",

1701 "args": [

1702 "-NoProfile",

1703 "-ExecutionPolicy",

1704 "Bypass",

1705 "-File",

1706 "${CLAUDE_PROJECT_DIR}/.claude/hooks/plain-display.ps1"

1707 ]

1708 }

1709 ]

1710 }

1711 ]

1712 }

1713}

1714```

1715 

1716Флаг `-NoProfile` пропускает загрузку вашего профиля PowerShell, чтобы хук запускался быстро, а `-ExecutionPolicy Bypass` позволяет PowerShell выполнить локальный файл скрипта.

1717 

1718Сохраните этот скрипт в `.claude/hooks/plain-display.ps1` в своём проекте:

1719 1687 

1720```powershell theme={null}1688> [tab] Windows (PowerShell)

1721$batch = [Console]::In.ReadToEnd() | ConvertFrom-Json1689>

1722$text = $batch.delta -replace '\*\*', '' -replace '`', ''1690> Зарегистрируйте командный хук, который запускает скрипт через PowerShell:

1723@{1691>

1724 hookSpecificOutput = @{1692> ```json theme={null}

1725 hookEventName = "MessageDisplay"1693> {

1726 displayContent = $text1694> "hooks": {

1727 }1695> "MessageDisplay": [

1728} | ConvertTo-Json1696> {

1729```1697> "hooks": [

1698> {

1699> "type": "command",

1700> "command": "powershell.exe",

1701> "args": [

1702> "-NoProfile",

1703> "-ExecutionPolicy",

1704> "Bypass",

1705> "-File",

1706> "${CLAUDE_PROJECT_DIR}/.claude/hooks/plain-display.ps1"

1707> ]

1708> }

1709> ]

1710> }

1711> ]

1712> }

1713> }

1714> ```

1715>

1716> Флаг `-NoProfile` пропускает загрузку вашего профиля PowerShell, чтобы хук запускался быстро, а `-ExecutionPolicy Bypass` позволяет PowerShell выполнить локальный файл скрипта.

1717>

1718> Сохраните этот скрипт в `.claude/hooks/plain-display.ps1` в своём проекте:

1719>

1720> ```powershell theme={null}

1721> $batch = [Console]::In.ReadToEnd() | ConvertFrom-Json

1722> $text = $batch.delta -replace '\*\*', '' -replace '`', ''

1723> @{

1724> hookSpecificOutput = @{

1725> hookEventName = "MessageDisplay"

1726> displayContent = $text

1727> }

1728> } | ConvertTo-Json

1729> ```

1730 1730 

1731Партии без markdown проходят без изменений. Если скрипт завершается с ошибкой, например из-за отсутствия `jq`, Claude Code отображает исходный текст и отмечает сбой только в [выводе отладки](#debug-hooks), а не в сессии.1731Партии без markdown проходят без изменений. Если скрипт завершается с ошибкой, например из-за отсутствия `jq`, Claude Code отображает исходный текст и отмечает сбой только в [выводе отладки](#debug-hooks), а не в сессии.

1732 1732 

3357 3357 

3358Записывайте matcher как точное имя, список через `|`, например `claude-opus-4-6|claude-opus-5`, или регулярное выражение, например `.*opus.*`. Этот пример использует matcher с точным именем и дополнительно проверяет `to_model` из входных данных хука, поэтому он отклоняет переключение на Opus 4.6, завершаясь с кодом 2, и пропускает любую другую целевую модель:3358Записывайте matcher как точное имя, список через `|`, например `claude-opus-4-6|claude-opus-5`, или регулярное выражение, например `.*opus.*`. Этот пример использует matcher с точным именем и дополнительно проверяет `to_model` из входных данных хука, поэтому он отклоняет переключение на Opus 4.6, завершаясь с кодом 2, и пропускает любую другую целевую модель:

3359 3359 

3360**macOS/Linux**3360> [tab] macOS/Linux

3361 3361>

3362Команда проверяет `to_model` с помощью `jq`:3362> Команда проверяет `to_model` с помощью `jq`:

3363 3363>

3364```json theme={null}3364> ```json theme={null}

3365{3365> {

3366 "hooks": {3366> "hooks": {

3367 "PreModelSwitch": [3367> "PreModelSwitch": [

3368 {3368> {

3369 "matcher": "claude-opus-4-6",3369> "matcher": "claude-opus-4-6",

3370 "hooks": [3370> "hooks": [

3371 {3371> {

3372 "type": "command",3372> "type": "command",

3373 "command": "jq -e '.to_model | test(\"opus-4-6\")' > /dev/null && { echo 'Opus 4.6 is retired for this project. Use a newer model.' >&2; exit 2; }; exit 0"3373> "command": "jq -e '.to_model | test(\"opus-4-6\")' > /dev/null && { echo 'Opus 4.6 is retired for this project. Use a newer model.' >&2; exit 2; }; exit 0"

3374 }3374> }

3375 ]3375> ]

3376 }3376> }

3377 ]3377> ]

3378 }3378> }

3379}3379> }

3380```3380> ```

3381 3381 

3382**Windows (PowerShell)**3382> [tab] Windows (PowerShell)

3383 3383>

3384Зарегистрируйте хук команды, который запускает скрипт через PowerShell:3384> Зарегистрируйте хук команды, который запускает скрипт через PowerShell:

3385 3385>

3386```json theme={null}3386> ```json theme={null}

3387{3387> {

3388 "hooks": {3388> "hooks": {

3389 "PreModelSwitch": [3389> "PreModelSwitch": [

3390 {3390> {

3391 "matcher": "claude-opus-4-6",3391> "matcher": "claude-opus-4-6",

3392 "hooks": [3392> "hooks": [

3393 {3393> {

3394 "type": "command",3394> "type": "command",

3395 "command": "powershell.exe",3395> "command": "powershell.exe",

3396 "args": [3396> "args": [

3397 "-NoProfile",3397> "-NoProfile",

3398 "-ExecutionPolicy",3398> "-ExecutionPolicy",

3399 "Bypass",3399> "Bypass",

3400 "-File",3400> "-File",

3401 "${CLAUDE_PROJECT_DIR}/.claude/hooks/block-opus-46.ps1"3401> "${CLAUDE_PROJECT_DIR}/.claude/hooks/block-opus-46.ps1"

3402 ]3402> ]

3403 }3403> }

3404 ]3404> ]

3405 }3405> }

3406 ]3406> ]

3407 }3407> }

3408}3408> }

3409```3409> ```

3410 3410>

3411Сохраните этот скрипт в `.claude/hooks/block-opus-46.ps1` в вашем проекте:3411> Сохраните этот скрипт в `.claude/hooks/block-opus-46.ps1` в вашем проекте:

3412 3412>

3413```powershell theme={null}3413> ```powershell theme={null}

3414$hookInput = [Console]::In.ReadToEnd() | ConvertFrom-Json3414> $hookInput = [Console]::In.ReadToEnd() | ConvertFrom-Json

3415if ($hookInput.to_model -match 'opus-4-6') {3415> if ($hookInput.to_model -match 'opus-4-6') {

3416 [Console]::Error.WriteLine('Opus 4.6 is retired for this project. Use a newer model.')3416> [Console]::Error.WriteLine('Opus 4.6 is retired for this project. Use a newer model.')

3417 exit 23417> exit 2

3418}3418> }

3419exit 03419> exit 0

3420```3420> ```

3421 3421 

3422Чтобы убедиться, что хук работает, выполните `/model claude-opus-4-6` в сессии с другой моделью. Claude Code сохранит текущую модель и сообщит, что хук PreModelSwitch заблокировал переключение, указав ваше сообщение в качестве причины.3422Чтобы убедиться, что хук работает, выполните `/model claude-opus-4-6` в сессии с другой моделью. Claude Code сохранит текущую модель и сообщит, что хук PreModelSwitch заблокировал переключение, указав ваше сообщение в качестве причины.

3423 3423 

3705 3705 

3706Этот пример отвечает на один повторяющийся вопрос вместо пользователя. MCP-сервер с именем `issue-tracker` запрашивает ключ проекта в форме, и хук подставляет `DOCS`. Скрипт принимает запрос, когда `project_key` — единственное поле формы. Для любого другого запроса он ничего не выводит, поэтому появляется диалоговое окно.3706Этот пример отвечает на один повторяющийся вопрос вместо пользователя. MCP-сервер с именем `issue-tracker` запрашивает ключ проекта в форме, и хук подставляет `DOCS`. Скрипт принимает запрос, когда `project_key` — единственное поле формы. Для любого другого запроса он ничего не выводит, поэтому появляется диалоговое окно.

3707 3707 

3708**macOS/Linux**3708> [tab] macOS/Linux

3709 3709>

3710Зарегистрируйте хук команды для этого события в файле настроек, указав имя сервера в качестве matcher:3710> Зарегистрируйте хук команды для этого события в файле настроек, указав имя сервера в качестве matcher:

3711 3711>

3712```json theme={null}3712> ```json theme={null}

3713{3713> {

3714 "hooks": {3714> "hooks": {

3715 "Elicitation": [3715> "Elicitation": [

3716 {3716> {

3717 "matcher": "issue-tracker",3717> "matcher": "issue-tracker",

3718 "hooks": [3718> "hooks": [

3719 {3719> {

3720 "type": "command",3720> "type": "command",

3721 "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/answer-project-key.sh",3721> "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/answer-project-key.sh",

3722 "args": []3722> "args": []

3723 }3723> }

3724 ]3724> ]

3725 }3725> }

3726 ]3726> ]

3727 }3727> }

3728}3728> }

3729```3729> ```

3730 3730>

3731Сохраните этот скрипт в `.claude/hooks/answer-project-key.sh` в вашем проекте и сделайте его исполняемым с помощью `chmod +x`:3731> Сохраните этот скрипт в `.claude/hooks/answer-project-key.sh` в вашем проекте и сделайте его исполняемым с помощью `chmod +x`:

3732 3732>

3733```bash theme={null}3733> ```bash theme={null}

3734#!/bin/bash3734> #!/bin/bash

3735input=$(cat)3735> input=$(cat)

3736fields=$(jq -c '.requested_schema.properties // {} | keys' <<<"$input")3736> fields=$(jq -c '.requested_schema.properties // {} | keys' <<<"$input")

3737 3737>

3738if [ "$fields" = '["project_key"]' ]; then3738> if [ "$fields" = '["project_key"]' ]; then

3739 jq -n '{hookSpecificOutput: {hookEventName: "Elicitation", action: "accept", content: {project_key: "DOCS"}}}'3739> jq -n '{hookSpecificOutput: {hookEventName: "Elicitation", action: "accept", content: {project_key: "DOCS"}}}'

3740fi3740> fi

3741```3741> ```

3742 

3743**Windows (PowerShell)**

3744 

3745Зарегистрируйте хук команды, который запускает скрипт через PowerShell, указав имя сервера в качестве matcher:

3746 

3747```json theme={null}

3748{

3749 "hooks": {

3750 "Elicitation": [

3751 {

3752 "matcher": "issue-tracker",

3753 "hooks": [

3754 {

3755 "type": "command",

3756 "command": "powershell.exe",

3757 "args": [

3758 "-NoProfile",

3759 "-ExecutionPolicy",

3760 "Bypass",

3761 "-File",

3762 "${CLAUDE_PROJECT_DIR}/.claude/hooks/answer-project-key.ps1"

3763 ]

3764 }

3765 ]

3766 }

3767 ]

3768 }

3769}

3770```

3771 

3772Сохраните этот скрипт в `.claude/hooks/answer-project-key.ps1` в вашем проекте:

3773 

3774```powershell theme={null}

3775$request = [Console]::In.ReadToEnd() | ConvertFrom-Json

3776$fields = @($request.requested_schema.properties.PSObject.Properties.Name)

3777 3742 

3778if ($fields.Count -eq 1 -and $fields[0] -eq 'project_key') {3743> [tab] Windows (PowerShell)

3779 @{3744>

3780 hookSpecificOutput = @{3745> Зарегистрируйте хук команды, который запускает скрипт через PowerShell, указав имя сервера в качестве matcher:

3781 hookEventName = "Elicitation"3746>

3782 action = "accept"3747> ```json theme={null}

3783 content = @{ project_key = "DOCS" }3748> {

3784 }3749> "hooks": {

3785 } | ConvertTo-Json -Depth 33750> "Elicitation": [

3786}3751> {

3787```3752> "matcher": "issue-tracker",

3753> "hooks": [

3754> {

3755> "type": "command",

3756> "command": "powershell.exe",

3757> "args": [

3758> "-NoProfile",

3759> "-ExecutionPolicy",

3760> "Bypass",

3761> "-File",

3762> "${CLAUDE_PROJECT_DIR}/.claude/hooks/answer-project-key.ps1"

3763> ]

3764> }

3765> ]

3766> }

3767> ]

3768> }

3769> }

3770> ```

3771>

3772> Сохраните этот скрипт в `.claude/hooks/answer-project-key.ps1` в вашем проекте:

3773>

3774> ```powershell theme={null}

3775> $request = [Console]::In.ReadToEnd() | ConvertFrom-Json

3776> $fields = @($request.requested_schema.properties.PSObject.Properties.Name)

3777>

3778> if ($fields.Count -eq 1 -and $fields[0] -eq 'project_key') {

3779> @{

3780> hookSpecificOutput = @{

3781> hookEventName = "Elicitation"

3782> action = "accept"

3783> content = @{ project_key = "DOCS" }

3784> }

3785> } | ConvertTo-Json -Depth 3

3786> }

3787> ```

3788 3788 

3789Чтобы убедиться, что хук работает, запустите Claude Code командой `claude --debug` и дайте Claude задачу, при которой сервер запросит ключ проекта. Диалоговое окно не появится, а в [отладочном логе](#debug-hooks) будет строка, заканчивающаяся на `Elicitation resolved by hook: {"action":"accept","content":{"project_key":"DOCS"}}`.3789Чтобы убедиться, что хук работает, запустите Claude Code командой `claude --debug` и дайте Claude задачу, при которой сервер запросит ключ проекта. Диалоговое окно не появится, а в [отладочном логе](#debug-hooks) будет строка, заканчивающаяся на `Elicitation resolved by hook: {"action":"accept","content":{"project_key":"DOCS"}}`.

3790 3790 

hooks-guide.md +144 −144

Details

89 89 

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

91 91 

92**macOS**92> [tab] macOS

93 

94```json theme={null}

95{

96 "hooks": {

97 "Notification": [

98 {

99 "matcher": "",

100 "hooks": [

101 {

102 "type": "command",

103 "command": "osascript -e 'display notification \"Claude Code needs your attention\" with title \"Claude Code\"'"

104 }

105 ]

106 }

107 ]

108 }

109}

110```

111 

112> **Если уведомление не появляется**

113>

114> `osascript` направляет уведомления через встроенное приложение Script Editor. Если у Script Editor нет разрешения на уведомления, команда молча завершается неудачей, и macOS не предложит вам предоставить его.

115>93>

116> Запустите это в Terminal один раз, чтобы Script Editor появился в ваших настройках уведомлений:94> ```json theme={null}

117>95> {

118> ```bash theme={null}96> "hooks": {

119> osascript -e 'display notification "test"'97> "Notification": [

98> {

99> "matcher": "",

100> "hooks": [

101> {

102> "type": "command",

103> "command": "osascript -e 'display notification \"Claude Code needs your attention\" with title \"Claude Code\"'"

104> }

105> ]

106> }

107> ]

108> }

109> }

120> ```110> ```

121>111>

122> Ничего не появится пока. Откройте **System Settings > Notifications**, найдите **Script Editor** в списке и включите **Allow Notifications**. Запустите команду снова, чтобы подтвердить, что тестовое уведомление появляется.112> > [accordion] Если уведомление не появляется

123 113> >

124**Linux**114> > `osascript` направляет уведомления через встроенное приложение Script Editor. Если у Script Editor нет разрешения на уведомления, команда молча завершается неудачей, и macOS не предложит вам предоставить его.

125 115> >

126```json theme={null}116> > Запустите это в Terminal один раз, чтобы Script Editor появился в ваших настройках уведомлений:

127{117> >

128 "hooks": {118> > ```bash theme={null}

129 "Notification": [119> > osascript -e 'display notification "test"'

130 {120> > ```

131 "matcher": "",121> >

132 "hooks": [122> > Ничего не появится пока. Откройте **System Settings > Notifications**, найдите **Script Editor** в списке и включите **Allow Notifications**. Запустите команду снова, чтобы подтвердить, что тестовое уведомление появляется.

133 {123 

134 "type": "command",124> [tab] Linux

135 "command": "notify-send 'Claude Code' 'Claude Code needs your attention'"

136 }

137 ]

138 }

139 ]

140 }

141}

142```

143 

144> **Если уведомление не появляется**

145>

146> `notify-send` требует демона уведомлений рабочего стола, который не имеют безголовые серверы, сеансы SSH и большинство контейнеров. Сначала протестируйте команду напрямую:

147>125>

148> ```bash theme={null}126> ```json theme={null}

149> notify-send 'Claude Code' 'test'127> {

128> "hooks": {

129> "Notification": [

130> {

131> "matcher": "",

132> "hooks": [

133> {

134> "type": "command",

135> "command": "notify-send 'Claude Code' 'Claude Code needs your attention'"

136> }

137> ]

138> }

139> ]

140> }

141> }

150> ```142> ```

151>143>

152> Если команда не найдена, установите пакет `libnotify-bin` на Debian и Ubuntu или эквивалент вашего дистрибутива.144> > [accordion] Если уведомление не появляется

153 145> >

154**Windows (PowerShell)**146> > `notify-send` требует демона уведомлений рабочего стола, который не имеют безголовые серверы, сеансы SSH и большинство контейнеров. Сначала протестируйте команду напрямую:

155 147> >

156```json theme={null}148> > ```bash theme={null}

157{149> > notify-send 'Claude Code' 'test'

158 "hooks": {150> > ```

159 "Notification": [151> >

160 {152> > Если команда не найдена, установите пакет `libnotify-bin` на Debian и Ubuntu или эквивалент вашего дистрибутива.

161 "matcher": "",153 

162 "hooks": [154> [tab] Windows (PowerShell)

163 {

164 "type": "command",

165 "command": "powershell.exe -Command \"[System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms'); [System.Windows.Forms.MessageBox]::Show('Claude Code needs your attention', 'Claude Code')\""

166 }

167 ]

168 }

169 ]

170 }

171}

172```

173 

174> **Если диалоговое окно не появляется**

175>155>

176> Эта команда открывает диалоговое окно, а не уведомление в углу экрана, поэтому окно может открыться позади окна терминала. Сначала протестируйте команду напрямую в PowerShell.156> ```json theme={null}

157> {

158> "hooks": {

159> "Notification": [

160> {

161> "matcher": "",

162> "hooks": [

163> {

164> "type": "command",

165> "command": "powershell.exe -Command \"[System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms'); [System.Windows.Forms.MessageBox]::Show('Claude Code needs your attention', 'Claude Code')\""

166> }

167> ]

168> }

169> ]

170> }

171> }

172> ```

177>173>

178> Если вы запускаете Claude Code внутри WSL, `powershell.exe` должен быть доступен в вашем `PATH` через Windows interop.174> > [accordion] Если диалоговое окно не появляется

175> >

176> > Эта команда открывает диалоговое окно, а не уведомление в углу экрана, поэтому окно может открыться позади окна терминала. Сначала протестируйте команду напрямую в PowerShell.

177> >

178> > Если вы запускаете Claude Code внутри WSL, `powershell.exe` должен быть доступен в вашем `PATH` через Windows interop.

179 179 

180Пустой `matcher` срабатывает на все типы уведомлений. Чтобы срабатывать только на определённые события, установите его на одно из этих значений:180Пустой `matcher` срабатывает на все типы уведомлений. Чтобы срабатывать только на определённые события, установите его на одно из этих значений:

181 181 

705 705 

706Вкладки ниже показывают несколько дополнительных matchers на разных типах событий.706Вкладки ниже показывают несколько дополнительных matchers на разных типах событий.

707 707 

708**Логирование каждой команды Bash**708> [tab] Логирование каждой команды Bash

709 709>

710Соответствуйте только вызовам инструмента `Bash` и логируйте каждую команду в файл. Событие `PostToolUse` срабатывает после завершения команды, поэтому `tool_input.command` содержит то, что запустилось. Hook получает данные события в виде JSON на stdin, и `jq -r '.tool_input.command'` извлекает только строку команды, которую `>>` добавляет в файл журнала:710> Соответствуйте только вызовам инструмента `Bash` и логируйте каждую команду в файл. Событие `PostToolUse` срабатывает после завершения команды, поэтому `tool_input.command` содержит то, что запустилось. Hook получает данные события в виде JSON на stdin, и `jq -r '.tool_input.command'` извлекает только строку команды, которую `>>` добавляет в файл журнала:

711 711>

712```json theme={null}712> ```json theme={null}

713{713> {

714 "hooks": {714> "hooks": {

715 "PostToolUse": [715> "PostToolUse": [

716 {716> {

717 "matcher": "Bash",717> "matcher": "Bash",

718 "hooks": [718> "hooks": [

719 {719> {

720 "type": "command",720> "type": "command",

721 "command": "jq -r '.tool_input.command' >> ~/.claude/command-log.txt"721> "command": "jq -r '.tool_input.command' >> ~/.claude/command-log.txt"

722 }722> }

723 ]723> ]

724 }724> }

725 ]725> ]

726 }726> }

727}727> }

728```728> ```

729 

730**Соответствие MCP инструментам**

731 

732MCP инструменты используют другое соглашение об именовании, чем встроенные инструменты: `mcp__<server>__<tool>`, где `<server>` — имя MCP сервера, а `<tool>` — инструмент, который он предоставляет. Например, `mcp__github__search_repositories` или `mcp__filesystem__read_file`. Инструменты из [plugin-bundled server](https://code.claude.com/docs/ru/mcp.md#plugin-provided-mcp-servers) используют вместо этого сегмент сервера с областью видимости, такой как `mcp__plugin_my-plugin_db__query`. Используйте matcher regex для нацеливания на все инструменты с определённого сервера, или соответствуйте серверам с шаблоном, таким как `mcp__.*__write.*`. См. [Match MCP tools](https://code.claude.com/docs/ru/hooks.md#match-mcp-tools) в справочнике для полного списка примеров.

733 

734Команда ниже извлекает имя инструмента из JSON ввода hook с помощью `jq` и записывает его в stderr. Запись в stderr сохраняет stdout чистым для вывода JSON и отправляет сообщение в [debug log](https://code.claude.com/docs/ru/hooks.md#debug-hooks):

735 

736```json theme={null}

737{

738 "hooks": {

739 "PreToolUse": [

740 {

741 "matcher": "mcp__github__.*",

742 "hooks": [

743 {

744 "type": "command",

745 "command": "echo \"GitHub tool called: $(jq -r '.tool_name')\" >&2"

746 }

747 ]

748 }

749 ]

750 }

751}

752```

753 

754**Очистка при завершении сеанса**

755 729 

756Событие `SessionEnd` поддерживает matchers на причину завершения сеанса. Этот hook срабатывает только на `clear` (когда вы запускаете `/clear`), а не на нормальные выходы:730> [tab] Соответствие MCP инструментам

731>

732> MCP инструменты используют другое соглашение об именовании, чем встроенные инструменты: `mcp__<server>__<tool>`, где `<server>` — имя MCP сервера, а `<tool>` — инструмент, который он предоставляет. Например, `mcp__github__search_repositories` или `mcp__filesystem__read_file`. Инструменты из [plugin-bundled server](https://code.claude.com/docs/ru/mcp.md#plugin-provided-mcp-servers) используют вместо этого сегмент сервера с областью видимости, такой как `mcp__plugin_my-plugin_db__query`. Используйте matcher regex для нацеливания на все инструменты с определённого сервера, или соответствуйте серверам с шаблоном, таким как `mcp__.*__write.*`. См. [Match MCP tools](https://code.claude.com/docs/ru/hooks.md#match-mcp-tools) в справочнике для полного списка примеров.

733>

734> Команда ниже извлекает имя инструмента из JSON ввода hook с помощью `jq` и записывает его в stderr. Запись в stderr сохраняет stdout чистым для вывода JSON и отправляет сообщение в [debug log](https://code.claude.com/docs/ru/hooks.md#debug-hooks):

735>

736> ```json theme={null}

737> {

738> "hooks": {

739> "PreToolUse": [

740> {

741> "matcher": "mcp__github__.*",

742> "hooks": [

743> {

744> "type": "command",

745> "command": "echo \"GitHub tool called: $(jq -r '.tool_name')\" >&2"

746> }

747> ]

748> }

749> ]

750> }

751> }

752> ```

757 753 

758```json theme={null}754> [tab] Очистка при завершении сеанса

759{755>

760 "hooks": {756> Событие `SessionEnd` поддерживает matchers на причину завершения сеанса. Этот hook срабатывает только на `clear` (когда вы запускаете `/clear`), а не на нормальные выходы:

761 "SessionEnd": [757>

762 {758> ```json theme={null}

763 "matcher": "clear",759> {

764 "hooks": [760> "hooks": {

765 {761> "SessionEnd": [

766 "type": "command",762> {

767 "command": "rm -f /tmp/claude-scratch-*.txt"763> "matcher": "clear",

768 }764> "hooks": [

769 ]765> {

770 }766> "type": "command",

771 ]767> "command": "rm -f /tmp/claude-scratch-*.txt"

772 }768> }

773}769> ]

774```770> }

771> ]

772> }

773> }

774> ```

775 775 

776#### Фильтрация по имени инструмента и аргументам с помощью поля `if`776#### Фильтрация по имени инструмента и аргументам с помощью поля `if`

777 777 

Details

163 163 

164Выберите режим разрешений, чтобы установить, что Claude может делать без запроса. Нажмите `Shift+Tab`, чтобы циклически переключаться между режимами разрешений:164Выберите режим разрешений, чтобы установить, что Claude может делать без запроса. Нажмите `Shift+Tab`, чтобы циклически переключаться между режимами разрешений:

165 165 

166* **Auto**: классификатор проверяет большинство действий в фоновом режиме и блокирует рискованные вместо того, чтобы спрашивать вас. На Claude Code v2.1.283 или позже это [встроенный начальный режим разрешений](https://code.claude.com/docs/ru/permission-modes.md#which-mode-a-session-starts-in) для интерактивных сеансов терминала и VS Code, а на более ранних версиях только на планах Pro, Max и Team166* **Auto**: классификатор проверяет большинство действий в фоновом режиме и блокирует рискованные вместо того, чтобы спрашивать вас. В Claude Code v2.1.283 или более поздней версии это [встроенный начальный режим разрешений](https://code.claude.com/docs/ru/permission-modes.md#which-mode-a-session-starts-in) для интерактивных сессий в терминале и VS Code. В более ранних версиях это встроенный начальный режим разрешений только на планах Pro, Max, Ultra и Team.

167* **Manual**: Claude спрашивает перед редактированием файлов и командами shell167* **Manual**: Claude спрашивает перед редактированием файлов и командами shell

168* **Accept edits**: Claude редактирует файлы и запускает общие команды файловой системы, такие как `mkdir` и `mv`, без запроса, всё ещё спрашивает для других команд168* **Accept edits**: Claude редактирует файлы и запускает общие команды файловой системы, такие как `mkdir` и `mv`, без запроса, всё ещё спрашивает для других команд

169* **Plan**: Claude исследует и предлагает план без редактирования ваших исходных файлов169* **Plan**: Claude исследует и предлагает план без редактирования ваших исходных файлов

223 223 

224## Что дальше224## Что дальше

225 225 

226> **[Расширение с функциями](https://code.claude.com/docs/ru/features-overview.md)**226> [card] [Расширение с функциями](https://code.claude.com/docs/ru/features-overview.md)

227>227>

228> Добавьте skills и подключения MCP228> Добавьте skills и подключения MCP

229 229 

230> **[Типичные рабочие процессы](https://code.claude.com/docs/ru/common-workflows.md)**230> [card] [Типичные рабочие процессы](https://code.claude.com/docs/ru/common-workflows.md)

231>231>

232> Пошаговые руководства для типичных задач232> Пошаговые руководства для типичных задач

Details

537 537 

538Claude Code читает параметр [`spellcheck`](https://code.claude.com/docs/ru/settings-reference#spellcheck) из трех мест и игнорирует его в файлах `.claude/settings.json` и `.claude/settings.local.json` проекта. Включите его в том месте, которое вы используете:538Claude Code читает параметр [`spellcheck`](https://code.claude.com/docs/ru/settings-reference#spellcheck) из трех мест и игнорирует его в файлах `.claude/settings.json` и `.claude/settings.local.json` проекта. Включите его в том месте, которое вы используете:

539 539 

540**User settings**540> [tab] User settings

541 541>

542Добавьте `spellcheck` в `~/.claude/settings.json`. Это применяется в каждом проекте, который вы открываете, как и остальные ваши [пользовательские параметры](https://code.claude.com/docs/ru/settings.md#where-settings-live):542> Добавьте `spellcheck` в `~/.claude/settings.json`. Это применяется в каждом проекте, который вы открываете, как и остальные ваши [пользовательские параметры](https://code.claude.com/docs/ru/settings.md#where-settings-live):

543 543>

544```json theme={null}544> ```json theme={null}

545{545> {

546 "spellcheck": { "enabled": true }546> "spellcheck": { "enabled": true }

547}547> }

548```548> ```

549 

550**Command line**

551 

552Сохраните `spellcheck` в JSON файл, например `spellcheck.json`:

553 

554```json theme={null}

555{

556 "spellcheck": { "enabled": true }

557}

558```

559 

560Затем передайте файл в `--settings`. Это применяется только к этому сеансу:

561 

562```bash theme={null}

563claude --settings spellcheck.json

564```

565 

566**Managed settings**

567 549 

568Добавьте `spellcheck` в один из [источников управляемых параметров](https://code.claude.com/docs/ru/permissions.md#managed-settings) вашей организации. Это применяется ко всем пользователям, которые получают эти параметры, и они не могут их отключить:550> [tab] Command line

551>

552> Сохраните `spellcheck` в JSON файл, например `spellcheck.json`:

553>

554> ```json theme={null}

555> {

556> "spellcheck": { "enabled": true }

557> }

558> ```

559>

560> Затем передайте файл в `--settings`. Это применяется только к этому сеансу:

561>

562> ```bash theme={null}

563> claude --settings spellcheck.json

564> ```

569 565 

570```json theme={null}566> [tab] Managed settings

571{567>

572 "spellcheck": { "enabled": true }568> Добавьте `spellcheck` в один из [источников управляемых параметров](https://code.claude.com/docs/ru/permissions.md#managed-settings) вашей организации. Это применяется ко всем пользователям, которые получают эти параметры, и они не могут их отключить:

573}569>

574```570> ```json theme={null}

571> {

572> "spellcheck": { "enabled": true }

573> }

574> ```

575 575 

576Чтобы проверить, включена ли проверка орфографии, введите неправильно написанное слово и пробел. Claude Code подчеркнет слово. Если этого не произойдет, см. [Когда Claude Code ничего не подчеркивает](#when-claude-code-underlines-nothing). Чтобы снова отключить проверку орфографии, установите `enabled` на `false` в том же месте или удалите `spellcheck`.576Чтобы проверить, включена ли проверка орфографии, введите неправильно написанное слово и пробел. Claude Code подчеркнет слово. Если этого не произойдет, см. [Когда Claude Code ничего не подчеркивает](#when-claude-code-underlines-nothing). Чтобы снова отключить проверку орфографии, установите `enabled` на `false` в том же месте или удалите `spellcheck`.

577 577 

jetbrains.md +1 −1

Details

41 41 

42Если `claude` установлен в месте, которое ваша IDE не может найти, установите полный путь в [параметре Claude command](#general-settings) плагина.42Если `claude` установлен в месте, которое ваша IDE не может найти, установите полный путь в [параметре Claude command](#general-settings) плагина.

43 43 

44Claude Code работает с любой платной подпиской Claude (Pro, Max, Team или Enterprise) или с учетной записью Claude Console, и API ключ не требуется. Вам будет предложено [войти](https://code.claude.com/docs/ru/authentication.md#log-in-to-claude-code) при первом запуске `claude`.44Claude Code работает с любой платной подпиской Claude (Pro, Max, Ultra, Team или Enterprise) или с учетной записью Claude Console, и API-ключ не требуется. Вам будет предложено [войти](https://code.claude.com/docs/ru/authentication.md#log-in-to-claude-code) при первом запуске `claude`.

45 45 

46## Использование46## Использование

47 47 

Details

73 73 

74Замените значения на те, которые вам дала команда шлюза:74Замените значения на те, которые вам дала команда шлюза:

75 75 

76**Bash или Zsh**76> [tab] Bash или Zsh

77 77>

78```bash theme={null}78> ```bash theme={null}

79export ANTHROPIC_BASE_URL=https://llm-gateway.example.com79> export ANTHROPIC_BASE_URL=https://llm-gateway.example.com

80export ANTHROPIC_AUTH_TOKEN=sk-gateway-key80> export ANTHROPIC_AUTH_TOKEN=sk-gateway-key

81```81> ```

82 

83**PowerShell**

84 82 

85```powershell theme={null}83> [tab] PowerShell

86$env:ANTHROPIC_BASE_URL = "https://llm-gateway.example.com"84>

87$env:ANTHROPIC_AUTH_TOKEN = "sk-gateway-key"85> ```powershell theme={null}

88```86> $env:ANTHROPIC_BASE_URL = "https://llm-gateway.example.com"

87> $env:ANTHROPIC_AUTH_TOKEN = "sk-gateway-key"

88> ```

89 89 

90Экспорты оболочки применяются только к этому сеансу терминала и программам, запущенным из него. Редактор, запущенный с док-станции или меню "Пуск", их не увидит. Чтобы они сохранялись в новых терминалах, добавьте те же строки в профиль вашей оболочки, такой как `~/.zshrc`, `~/.bashrc` или ваш PowerShell `$PROFILE`.90Экспорты оболочки применяются только к этому сеансу терминала и программам, запущенным из него. Редактор, запущенный с док-станции или меню "Пуск", их не увидит. Чтобы они сохранялись в новых терминалах, добавьте те же строки в профиль вашей оболочки, такой как `~/.zshrc`, `~/.bashrc` или ваш PowerShell `$PROFILE`.

91 91 

119 119 

120С переменными, экспортированными в вашей оболочке, отправьте однотокенный запрос на шлюз напрямую. Это подтверждает, что URL и учетные данные работают, прежде чем вы откроете Claude Code, поэтому сбой указывает на шлюз, а не на вашу конфигурацию. Команды ниже читают переменные оболочки, поэтому им нужны [экспорты оболочки](#set-as-shell-environment-variables) даже если вы также поместили значения в файл параметров.120С переменными, экспортированными в вашей оболочке, отправьте однотокенный запрос на шлюз напрямую. Это подтверждает, что URL и учетные данные работают, прежде чем вы откроете Claude Code, поэтому сбой указывает на шлюз, а не на вашу конфигурацию. Команды ниже читают переменные оболочки, поэтому им нужны [экспорты оболочки](#set-as-shell-environment-variables) даже если вы также поместили значения в файл параметров.

121 121 

122**Bash или Zsh**122> [tab] Bash или Zsh

123 123>

124```bash theme={null}124> ```bash theme={null}

125curl -sS -w '\n%{http_code}\n' -X POST "$ANTHROPIC_BASE_URL/v1/messages" \125> curl -sS -w '\n%{http_code}\n' -X POST "$ANTHROPIC_BASE_URL/v1/messages" \

126 -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \126> -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \

127 -H "anthropic-version: 2023-06-01" \127> -H "anthropic-version: 2023-06-01" \

128 -H "content-type: application/json" \128> -H "content-type: application/json" \

129 -d '{"model": "claude-sonnet-4-6", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'129> -d '{"model": "claude-sonnet-4-6", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

130```130> ```

131 131 

132**PowerShell**132> [tab] PowerShell

133 133>

134```powershell theme={null}134> ```powershell theme={null}

135Invoke-RestMethod -Method Post -Uri "$env:ANTHROPIC_BASE_URL/v1/messages" `135> Invoke-RestMethod -Method Post -Uri "$env:ANTHROPIC_BASE_URL/v1/messages" `

136 -Headers @{ "Authorization" = "Bearer $env:ANTHROPIC_AUTH_TOKEN"; "anthropic-version" = "2023-06-01" } `136> -Headers @{ "Authorization" = "Bearer $env:ANTHROPIC_AUTH_TOKEN"; "anthropic-version" = "2023-06-01" } `

137 -ContentType "application/json" `137> -ContentType "application/json" `

138 -Body '{"model": "claude-sonnet-4-6", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'138> -Body '{"model": "claude-sonnet-4-6", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

139```139> ```

140 140 

141Если ваш шлюз ожидает ключи в заголовке `x-api-key`, замените заголовок `Authorization` на `x-api-key: $ANTHROPIC_API_KEY` в команде Bash или запись таблицы хеша `"Authorization"` на `"x-api-key" = "$env:ANTHROPIC_API_KEY"` в команде PowerShell.141Если ваш шлюз ожидает ключи в заголовке `x-api-key`, замените заголовок `Authorization` на `x-api-key: $ANTHROPIC_API_KEY` в команде Bash или запись таблицы хеша `"Authorization"` на `"x-api-key" = "$env:ANTHROPIC_API_KEY"` в команде PowerShell.

142 142 

274 274 

275Некоторые шлюзы маршрутизируют или помечают запросы с помощью пользовательского заголовка в дополнение к учётным данным, например идентификатора арендатора или ключа маршрутизации. Чтобы отправить такой заголовок, задайте [`ANTHROPIC_CUSTOM_HEADERS`](https://code.claude.com/docs/ru/env-vars), указав по одной паре `Name: Value` на строку. В примере ниже добавляется заголовок маршрутизации с именем `X-Org-Route`:275Некоторые шлюзы маршрутизируют или помечают запросы с помощью пользовательского заголовка в дополнение к учётным данным, например идентификатора арендатора или ключа маршрутизации. Чтобы отправить такой заголовок, задайте [`ANTHROPIC_CUSTOM_HEADERS`](https://code.claude.com/docs/ru/env-vars), указав по одной паре `Name: Value` на строку. В примере ниже добавляется заголовок маршрутизации с именем `X-Org-Route`:

276 276 

277**Bash or Zsh**277> [tab] Bash or Zsh

278 278>

279```bash theme={null}279> ```bash theme={null}

280export ANTHROPIC_CUSTOM_HEADERS="X-Org-Route: prod"280> export ANTHROPIC_CUSTOM_HEADERS="X-Org-Route: prod"

281```281> ```

282 

283**PowerShell**

284 282 

285```powershell theme={null}283> [tab] PowerShell

286$env:ANTHROPIC_CUSTOM_HEADERS = "X-Org-Route: prod"284>

287```285> ```powershell theme={null}

286> $env:ANTHROPIC_CUSTOM_HEADERS = "X-Org-Route: prod"

287> ```

288 288 

289Вы также можете задать `ANTHROPIC_CUSTOM_HEADERS` в блоке `env` файла настроек. Используйте там `\n` между парами, поскольку строки JSON не могут занимать несколько строк:289Вы также можете задать `ANTHROPIC_CUSTOM_HEADERS` в блоке `env` файла настроек. Используйте там `\n` между парами, поскольку строки JSON не могут занимать несколько строк:

290 290 

318 318 

319Вспомогательная команда — это любая shell-команда, которая выводит текущие учётные данные в stdout. Claude Code запускает её через системную оболочку, поэтому в Windows это может быть исполняемый файл или вызов PowerShell. Команда должна выводить только учётные данные и ничего больше. В Claude Code v2.1.227 и более поздних версиях баннер или строка лога, выведенные вместе с ключом, приводят к [сбою вспомогательной команды](https://code.claude.com/docs/ru/errors.md#your-apikeyhelper-script-is-failing). Напишите скрипт, сделайте его исполняемым и укажите его в `apiKeyHelper` в вашем [файле настроек](https://code.claude.com/docs/ru/settings.md):319Вспомогательная команда — это любая shell-команда, которая выводит текущие учётные данные в stdout. Claude Code запускает её через системную оболочку, поэтому в Windows это может быть исполняемый файл или вызов PowerShell. Команда должна выводить только учётные данные и ничего больше. В Claude Code v2.1.227 и более поздних версиях баннер или строка лога, выведенные вместе с ключом, приводят к [сбою вспомогательной команды](https://code.claude.com/docs/ru/errors.md#your-apikeyhelper-script-is-failing). Напишите скрипт, сделайте его исполняемым и укажите его в `apiKeyHelper` в вашем [файле настроек](https://code.claude.com/docs/ru/settings.md):

320 320 

321**Bash or Zsh**321> [tab] Bash or Zsh

322 322>

323Например, скрипт, читающий из хранилища секретов:323> Например, скрипт, читающий из хранилища секретов:

324 324>

325```bash theme={null}325> ```bash theme={null}

326#!/bin/bash326> #!/bin/bash

327vault kv get -field=api_key secret/llm-gateway/claude-code327> vault kv get -field=api_key secret/llm-gateway/claude-code

328```328> ```

329 329>

330Укажите путь к нему в `~/.claude/settings.json`:330> Укажите путь к нему в `~/.claude/settings.json`:

331 331>

332```json theme={null}332> ```json theme={null}

333{333> {

334 "apiKeyHelper": "~/bin/get-gateway-key.sh"334> "apiKeyHelper": "~/bin/get-gateway-key.sh"

335}335> }

336```336> ```

337 

338**PowerShell**

339 

340Например, скрипт, читающий из хранилища секретов:

341 

342```powershell theme={null}

343vault kv get -field=api_key secret/llm-gateway/claude-code

344```

345 

346Укажите вызов PowerShell в `%USERPROFILE%\.claude\settings.json`, экранировав обратные косые черты в строке JSON:

347 337 

348```json theme={null}338> [tab] PowerShell

349{339>

350 "apiKeyHelper": "powershell -NoProfile -File C:\\scripts\\get-gateway-key.ps1"340> Например, скрипт, читающий из хранилища секретов:

351}341>

352```342> ```powershell theme={null}

343> vault kv get -field=api_key secret/llm-gateway/claude-code

344> ```

345>

346> Укажите вызов PowerShell в `%USERPROFILE%\.claude\settings.json`, экранировав обратные косые черты в строке JSON:

347>

348> ```json theme={null}

349> {

350> "apiKeyHelper": "powershell -NoProfile -File C:\\scripts\\get-gateway-key.ps1"

351> }

352> ```

353 353 

354По умолчанию Claude Code кэширует вывод вспомогательной команды на пять минут и снова запускает её по истечении срока жизни кэша. Чтобы изменить срок жизни, задайте `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` в миллисекундах, например `CLAUDE_CODE_API_KEY_HELPER_TTL_MS=900000` для 15 минут.354По умолчанию Claude Code кэширует вывод вспомогательной команды на пять минут и снова запускает её по истечении срока жизни кэша. Чтобы изменить срок жизни, задайте `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` в миллисекундах, например `CLAUDE_CODE_API_KEY_HELPER_TTL_MS=900000` для 15 минут.

355 355 

363 363 

364Чтобы отключить этот трафик, задайте `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1` вместе с переменными шлюза — в тех же экспортах оболочки или в блоке `env` файла настроек:364Чтобы отключить этот трафик, задайте `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1` вместе с переменными шлюза — в тех же экспортах оболочки или в блоке `env` файла настроек:

365 365 

366**Bash or Zsh**366> [tab] Bash or Zsh

367 367>

368```bash theme={null}368> ```bash theme={null}

369export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1369> export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

370```370> ```

371 

372**PowerShell**

373 371 

374```powershell theme={null}372> [tab] PowerShell

375$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"373>

376```374> ```powershell theme={null}

375> $env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"

376> ```

377 377 

378У этой переменной следующие эффекты и ограничения:378У этой переменной следующие эффекты и ограничения:

379 379 

398 398 

399Не задавайте `AWS_BEARER_TOKEN_BEDROCK`, если шлюз выдаёт собственные учётные данные. Если вы её зададите, Claude Code отправит этот [API-ключ Amazon Bedrock](https://code.claude.com/docs/ru/amazon-bedrock.md#2-configure-aws-credentials) в заголовке `Authorization` вместо токена вашего шлюза, даже если задана `CLAUDE_CODE_SKIP_BEDROCK_AUTH`.399Не задавайте `AWS_BEARER_TOKEN_BEDROCK`, если шлюз выдаёт собственные учётные данные. Если вы её зададите, Claude Code отправит этот [API-ключ Amazon Bedrock](https://code.claude.com/docs/ru/amazon-bedrock.md#2-configure-aws-credentials) в заголовке `Authorization` вместо токена вашего шлюза, даже если задана `CLAUDE_CODE_SKIP_BEDROCK_AUTH`.

400 400 

401**Bash or Zsh**401> [tab] Bash or Zsh

402 402>

403```bash theme={null}403> ```bash theme={null}

404export ANTHROPIC_BEDROCK_BASE_URL=https://llm-gateway.example.com/bedrock404> export ANTHROPIC_BEDROCK_BASE_URL=https://llm-gateway.example.com/bedrock

405export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1405> export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1

406export CLAUDE_CODE_USE_BEDROCK=1406> export CLAUDE_CODE_USE_BEDROCK=1

407```407> ```

408 

409**PowerShell**

410 408 

411```powershell theme={null}409> [tab] PowerShell

412$env:ANTHROPIC_BEDROCK_BASE_URL = "https://llm-gateway.example.com/bedrock"410>

413$env:CLAUDE_CODE_SKIP_BEDROCK_AUTH = "1"411> ```powershell theme={null}

414$env:CLAUDE_CODE_USE_BEDROCK = "1"412> $env:ANTHROPIC_BEDROCK_BASE_URL = "https://llm-gateway.example.com/bedrock"

415```413> $env:CLAUDE_CODE_SKIP_BEDROCK_AUTH = "1"

414> $env:CLAUDE_CODE_USE_BEDROCK = "1"

415> ```

416 416 

417#### Google Cloud's Agent Platform417#### Google Cloud's Agent Platform

418 418 

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

420 420 

421**Bash or Zsh**421> [tab] Bash or Zsh

422 422>

423```bash theme={null}423> ```bash theme={null}

424export ANTHROPIC_VERTEX_BASE_URL=https://llm-gateway.example.com/vertex424> export ANTHROPIC_VERTEX_BASE_URL=https://llm-gateway.example.com/vertex

425export ANTHROPIC_VERTEX_PROJECT_ID=your-gcp-project-id425> export ANTHROPIC_VERTEX_PROJECT_ID=your-gcp-project-id

426export CLAUDE_CODE_SKIP_VERTEX_AUTH=1426> export CLAUDE_CODE_SKIP_VERTEX_AUTH=1

427export CLAUDE_CODE_USE_VERTEX=1427> export CLAUDE_CODE_USE_VERTEX=1

428export CLOUD_ML_REGION=us-east5428> export CLOUD_ML_REGION=us-east5

429```429> ```

430 430 

431**PowerShell**431> [tab] PowerShell

432 432>

433```powershell theme={null}433> ```powershell theme={null}

434$env:ANTHROPIC_VERTEX_BASE_URL = "https://llm-gateway.example.com/vertex"434> $env:ANTHROPIC_VERTEX_BASE_URL = "https://llm-gateway.example.com/vertex"

435$env:ANTHROPIC_VERTEX_PROJECT_ID = "your-gcp-project-id"435> $env:ANTHROPIC_VERTEX_PROJECT_ID = "your-gcp-project-id"

436$env:CLAUDE_CODE_SKIP_VERTEX_AUTH = "1"436> $env:CLAUDE_CODE_SKIP_VERTEX_AUTH = "1"

437$env:CLAUDE_CODE_USE_VERTEX = "1"437> $env:CLAUDE_CODE_USE_VERTEX = "1"

438$env:CLOUD_ML_REGION = "us-east5"438> $env:CLOUD_ML_REGION = "us-east5"

439```439> ```

440 440 

441Этот блок охватывает маршрутизацию и аутентификацию. Переопределения регионов и закрепление моделей из [настройки Agent Platform](https://code.claude.com/docs/ru/google-vertex-ai.md#4-configure-claude-code) действуют и через шлюз:441Этот блок охватывает маршрутизацию и аутентификацию. Переопределения регионов и закрепление моделей из [настройки Agent Platform](https://code.claude.com/docs/ru/google-vertex-ai.md#4-configure-claude-code) действуют и через шлюз:

442 442 

450 450 

451Для шлюза, который подставляет собственный заголовок `Authorization`, задайте `CLAUDE_CODE_SKIP_FOUNDRY_AUTH=1` и оставьте обе переменные учётных данных незаданными. Тогда Claude Code отправляет запросы без учётных данных Azure и сохраняет заголовок `Authorization`, который вы передаёте, например через `ANTHROPIC_CUSTOM_HEADERS`.451Для шлюза, который подставляет собственный заголовок `Authorization`, задайте `CLAUDE_CODE_SKIP_FOUNDRY_AUTH=1` и оставьте обе переменные учётных данных незаданными. Тогда Claude Code отправляет запросы без учётных данных Azure и сохраняет заголовок `Authorization`, который вы передаёте, например через `ANTHROPIC_CUSTOM_HEADERS`.

452 452 

453**Bash or Zsh**453> [tab] Bash or Zsh

454 454>

455```bash theme={null}455> ```bash theme={null}

456export ANTHROPIC_FOUNDRY_BASE_URL=https://llm-gateway.example.com/foundry456> export ANTHROPIC_FOUNDRY_BASE_URL=https://llm-gateway.example.com/foundry

457export ANTHROPIC_FOUNDRY_API_KEY=sk-gateway-key457> export ANTHROPIC_FOUNDRY_API_KEY=sk-gateway-key

458export CLAUDE_CODE_USE_FOUNDRY=1458> export CLAUDE_CODE_USE_FOUNDRY=1

459```459> ```

460 

461**PowerShell**

462 460 

463```powershell theme={null}461> [tab] PowerShell

464$env:ANTHROPIC_FOUNDRY_BASE_URL = "https://llm-gateway.example.com/foundry"462>

465$env:ANTHROPIC_FOUNDRY_API_KEY = "sk-gateway-key"463> ```powershell theme={null}

466$env:CLAUDE_CODE_USE_FOUNDRY = "1"464> $env:ANTHROPIC_FOUNDRY_BASE_URL = "https://llm-gateway.example.com/foundry"

467```465> $env:ANTHROPIC_FOUNDRY_API_KEY = "sk-gateway-key"

466> $env:CLAUDE_CODE_USE_FOUNDRY = "1"

467> ```

468 468 

469#### Claude Platform on AWS469#### Claude Platform on AWS

470 470 

471Об идентификаторе рабочего пространства см. [Claude Platform on AWS](https://code.claude.com/docs/ru/claude-platform-on-aws.md).471Об идентификаторе рабочего пространства см. [Claude Platform on AWS](https://code.claude.com/docs/ru/claude-platform-on-aws.md).

472 472 

473**Bash or Zsh**473> [tab] Bash or Zsh

474 474>

475```bash theme={null}475> ```bash theme={null}

476export ANTHROPIC_AWS_BASE_URL=https://llm-gateway.example.com/anthropic-aws476> export ANTHROPIC_AWS_BASE_URL=https://llm-gateway.example.com/anthropic-aws

477export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN477> export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN

478export CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH=1478> export CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH=1

479export CLAUDE_CODE_USE_ANTHROPIC_AWS=1479> export CLAUDE_CODE_USE_ANTHROPIC_AWS=1

480```480> ```

481 481 

482**PowerShell**482> [tab] PowerShell

483 483>

484```powershell theme={null}484> ```powershell theme={null}

485$env:ANTHROPIC_AWS_BASE_URL = "https://llm-gateway.example.com/anthropic-aws"485> $env:ANTHROPIC_AWS_BASE_URL = "https://llm-gateway.example.com/anthropic-aws"

486$env:ANTHROPIC_AWS_WORKSPACE_ID = "wrkspc_01ABCDEFGHIJKLMN"486> $env:ANTHROPIC_AWS_WORKSPACE_ID = "wrkspc_01ABCDEFGHIJKLMN"

487$env:CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH = "1"487> $env:CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH = "1"

488$env:CLAUDE_CODE_USE_ANTHROPIC_AWS = "1"488> $env:CLAUDE_CODE_USE_ANTHROPIC_AWS = "1"

489```489> ```

490 490 

491#### Проверка маршрута провайдера491#### Проверка маршрута провайдера

492 492 

Details

62* `<gateway-key>` — это любые учетные данные, которые позволяют вам вызывать шлюз прямо сейчас: административный ключ, тестовый ключ или ваш собственный ключ разработчика, если вы уже выдали его. Не каждый продукт шлюза имеет отдельные административные учетные данные; если у вас их нет, сначала выдайте себе ключ разработчика в [Выдать учетные данные разработчика](#issue-developer-credentials)62* `<gateway-key>` — это любые учетные данные, которые позволяют вам вызывать шлюз прямо сейчас: административный ключ, тестовый ключ или ваш собственный ключ разработчика, если вы уже выдали его. Не каждый продукт шлюза имеет отдельные административные учетные данные; если у вас их нет, сначала выдайте себе ключ разработчика в [Выдать учетные данные разработчика](#issue-developer-credentials)

63* `model` — это имя модели Claude, которое ваш шлюз настроен маршрутизировать. В примере используется `claude-sonnet-4-6`; подставьте имя, которое вы настроили63* `model` — это имя модели Claude, которое ваш шлюз настроен маршрутизировать. В примере используется `claude-sonnet-4-6`; подставьте имя, которое вы настроили

64 64 

65**Bash или Zsh**65> [tab] Bash или Zsh

66 66>

67```bash theme={null}67> ```bash theme={null}

68curl -X POST "https://llm-gateway.example.com/v1/messages" \68> curl -X POST "https://llm-gateway.example.com/v1/messages" \

69 -H "Authorization: Bearer <gateway-key>" \69> -H "Authorization: Bearer <gateway-key>" \

70 -H "anthropic-version: 2023-06-01" \70> -H "anthropic-version: 2023-06-01" \

71 -H "content-type: application/json" \71> -H "content-type: application/json" \

72 -d '{"model": "claude-sonnet-4-6", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'72> -d '{"model": "claude-sonnet-4-6", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

73```73> ```

74 74 

75**PowerShell**75> [tab] PowerShell

76 76>

77```powershell theme={null}77> ```powershell theme={null}

78Invoke-RestMethod -Method Post -Uri "https://llm-gateway.example.com/v1/messages" `78> Invoke-RestMethod -Method Post -Uri "https://llm-gateway.example.com/v1/messages" `

79 -Headers @{ "Authorization" = "Bearer <gateway-key>"; "anthropic-version" = "2023-06-01" } `79> -Headers @{ "Authorization" = "Bearer <gateway-key>"; "anthropic-version" = "2023-06-01" } `

80 -ContentType "application/json" `80> -ContentType "application/json" `

81 -Body '{"model": "claude-sonnet-4-6", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'81> -Body '{"model": "claude-sonnet-4-6", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

82```82> ```

83 83 

84**Контрольная точка**: `200` с полем `content` означает, что шлюз достиг поставщика с этим именем модели. `404` означает, что это имя не маршрутизируется на шлюзе; `401` от поставщика означает, что учетные данные поставщика шлюза неправильные.84**Контрольная точка**: `200` с полем `content` означает, что шлюз достиг поставщика с этим именем модели. `404` означает, что это имя не маршрутизируется на шлюзе; `401` от поставщика означает, что учетные данные поставщика шлюза неправильные.

85 85 

95 95 

96Подтвердите, что недавно выданный ключ работает против шлюза с тем же запросом, что и [Подтвердить маршрутизацию моделей шлюзом](#confirm-the-gateway-routes-your-models), заменив `<gateway-key>` на новый `<developer-key>`:96Подтвердите, что недавно выданный ключ работает против шлюза с тем же запросом, что и [Подтвердить маршрутизацию моделей шлюзом](#confirm-the-gateway-routes-your-models), заменив `<gateway-key>` на новый `<developer-key>`:

97 97 

98**Bash или Zsh**98> [tab] Bash или Zsh

99 99>

100```bash theme={null}100> ```bash theme={null}

101curl -X POST "https://llm-gateway.example.com/v1/messages" \101> curl -X POST "https://llm-gateway.example.com/v1/messages" \

102 -H "Authorization: Bearer <developer-key>" \102> -H "Authorization: Bearer <developer-key>" \

103 -H "anthropic-version: 2023-06-01" \103> -H "anthropic-version: 2023-06-01" \

104 -H "content-type: application/json" \104> -H "content-type: application/json" \

105 -d '{"model": "claude-sonnet-4-6", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'105> -d '{"model": "claude-sonnet-4-6", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

106```106> ```

107 107 

108**PowerShell**108> [tab] PowerShell

109 109>

110```powershell theme={null}110> ```powershell theme={null}

111Invoke-RestMethod -Method Post -Uri "https://llm-gateway.example.com/v1/messages" `111> Invoke-RestMethod -Method Post -Uri "https://llm-gateway.example.com/v1/messages" `

112 -Headers @{ "Authorization" = "Bearer <developer-key>"; "anthropic-version" = "2023-06-01" } `112> -Headers @{ "Authorization" = "Bearer <developer-key>"; "anthropic-version" = "2023-06-01" } `

113 -ContentType "application/json" `113> -ContentType "application/json" `

114 -Body '{"model": "claude-sonnet-4-6", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'114> -Body '{"model": "claude-sonnet-4-6", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

115```115> ```

116 116 

117**Контрольная точка**: `200` с полем `content` означает, что ключ разработчика достигает шлюза и шлюз его перенаправляет. `401` здесь, когда [предыдущий шаг](#confirm-the-gateway-routes-your-models) был успешным, означает, что ключ разработчика неправильный или еще не вступил в силу на шлюзе.117**Контрольная точка**: `200` с полем `content` означает, что ключ разработчика достигает шлюза и шлюз его перенаправляет. `401` здесь, когда [предыдущий шаг](#confirm-the-gateway-routes-your-models) был успешным, означает, что ключ разработчика неправильный или еще не вступил в силу на шлюзе.

118 118 

122 122 

123Запустите Claude Code через шлюз самостоятельно перед распределением чего-либо, используя ту же конфигурацию, которую развертывание будет доставлять по всему парку. Введите их непосредственно в терминал, а не в файл `.env` или файл параметров; они действуют только для этого сеанса терминала, поэтому закрытие его возвращает вашу машину в нормальное состояние. Используйте `ANTHROPIC_API_KEY` вместо `ANTHROPIC_AUTH_TOKEN`, если ваш шлюз читает заголовок `x-api-key`:123Запустите Claude Code через шлюз самостоятельно перед распределением чего-либо, используя ту же конфигурацию, которую развертывание будет доставлять по всему парку. Введите их непосредственно в терминал, а не в файл `.env` или файл параметров; они действуют только для этого сеанса терминала, поэтому закрытие его возвращает вашу машину в нормальное состояние. Используйте `ANTHROPIC_API_KEY` вместо `ANTHROPIC_AUTH_TOKEN`, если ваш шлюз читает заголовок `x-api-key`:

124 124 

125**Bash или Zsh**125> [tab] Bash или Zsh

126 126>

127```bash theme={null}127> ```bash theme={null}

128export ANTHROPIC_BASE_URL=https://llm-gateway.example.com128> export ANTHROPIC_BASE_URL=https://llm-gateway.example.com

129export ANTHROPIC_AUTH_TOKEN="<developer-key>"129> export ANTHROPIC_AUTH_TOKEN="<developer-key>"

130```130> ```

131 

132**PowerShell**

133 131 

134```powershell theme={null}132> [tab] PowerShell

135$env:ANTHROPIC_BASE_URL = "https://llm-gateway.example.com"133>

136$env:ANTHROPIC_AUTH_TOKEN = "<developer-key>"134> ```powershell theme={null}

137```135> $env:ANTHROPIC_BASE_URL = "https://llm-gateway.example.com"

136> $env:ANTHROPIC_AUTH_TOKEN = "<developer-key>"

137> ```

138 138 

139Затем отправьте одноразовую подсказку через шлюз:139Затем отправьте одноразовую подсказку через шлюз:

140 140 

224 224 

225Подтвердите, что все работает с машины разработчика, а не хоста шлюза, чтобы тест охватывал сетевой путь, который используют разработчики. Отправьте потоковый запрос, который проверяет конечную точку, сквозную передачу потока и маршрутизацию модели одновременно:225Подтвердите, что все работает с машины разработчика, а не хоста шлюза, чтобы тест охватывал сетевой путь, который используют разработчики. Отправьте потоковый запрос, который проверяет конечную точку, сквозную передачу потока и маршрутизацию модели одновременно:

226 226 

227**Bash или Zsh**227> [tab] Bash или Zsh

228 228>

229```bash theme={null}229> ```bash theme={null}

230curl -N -X POST "https://llm-gateway.example.com/v1/messages" \230> curl -N -X POST "https://llm-gateway.example.com/v1/messages" \

231 -H "Authorization: Bearer <developer-key>" \231> -H "Authorization: Bearer <developer-key>" \

232 -H "anthropic-version: 2023-06-01" \232> -H "anthropic-version: 2023-06-01" \

233 -H "content-type: application/json" \233> -H "content-type: application/json" \

234 -d '{"model": "claude-sonnet-4-6", "max_tokens": 16, "stream": true, "messages": [{"role": "user", "content": "count to 3"}]}'234> -d '{"model": "claude-sonnet-4-6", "max_tokens": 16, "stream": true, "messages": [{"role": "user", "content": "count to 3"}]}'

235```235> ```

236 236 

237**PowerShell**237> [tab] PowerShell

238 238>

239```powershell theme={null}239> ```powershell theme={null}

240$body = '{"model": "claude-sonnet-4-6", "max_tokens": 16, "stream": true, "messages": [{"role": "user", "content": "count to 3"}]}'240> $body = '{"model": "claude-sonnet-4-6", "max_tokens": 16, "stream": true, "messages": [{"role": "user", "content": "count to 3"}]}'

241$body | curl.exe -N -X POST "https://llm-gateway.example.com/v1/messages" `241> $body | curl.exe -N -X POST "https://llm-gateway.example.com/v1/messages" `

242 -H "Authorization: Bearer <developer-key>" `242> -H "Authorization: Bearer <developer-key>" `

243 -H "anthropic-version: 2023-06-01" `243> -H "anthropic-version: 2023-06-01" `

244 -H "content-type: application/json" `244> -H "content-type: application/json" `

245 --data-binary '@-'245> --data-binary '@-'

246```246> ```

247 247 

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

249 249 

managed-mcp.md +5 −5

Details

403 403 

404Аккордеоны ниже проходят через то, как сервер оценивается в сравнении с другими комбинациями списков разрешений и запретов.404Аккордеоны ниже проходят через то, как сервер оценивается в сравнении с другими комбинациями списков разрешений и запретов.

405 405 

406> **Список разрешений только по URL**406> [accordion] Список разрешений только по URL

407>407>

408> ```json theme={null}408> ```json theme={null}

409> {409> {

421> | HTTP сервер в `https://external.example.com/mcp` | Заблокирован: не совпадает ни с одним шаблоном URL |421> | HTTP сервер в `https://external.example.com/mcp` | Заблокирован: не совпадает ни с одним шаблоном URL |

422> | Сервер stdio с любой командой | Заблокирован: нет записей имени или команды для совпадения |422> | Сервер stdio с любой командой | Заблокирован: нет записей имени или команды для совпадения |

423 423 

424> **Список разрешений только по команде**424> [accordion] Список разрешений только по команде

425>425>

426> ```json theme={null}426> ```json theme={null}

427> {427> {

437> | Сервер stdio с `["node", "server.js"]` | Заблокирован: не совпадает с командой |437> | Сервер stdio с `["node", "server.js"]` | Заблокирован: не совпадает с командой |

438> | HTTP сервер с именем `my-api` | Заблокирован: нет записей имени для совпадения |438> | HTTP сервер с именем `my-api` | Заблокирован: нет записей имени для совпадения |

439 439 

440> **Смешанный список разрешений имени и команды**440> [accordion] Смешанный список разрешений имени и команды

441>441>

442> ```json theme={null}442> ```json theme={null}

443> {443> {

456> | HTTP сервер с именем `github` | Разрешен: совпадает с именем |456> | HTTP сервер с именем `github` | Разрешен: совпадает с именем |

457> | HTTP сервер с именем `other-api` | Заблокирован: имя не совпадает |457> | HTTP сервер с именем `other-api` | Заблокирован: имя не совпадает |

458 458 

459> **Список разрешений только по имени**459> [accordion] Список разрешений только по имени

460>460>

461> ```json theme={null}461> ```json theme={null}

462> {462> {

474> | HTTP сервер с именем `github` | Разрешен: совпадает с именем |474> | HTTP сервер с именем `github` | Разрешен: совпадает с именем |

475> | Любой сервер с именем `other` | Заблокирован: имя не совпадает |475> | Любой сервер с именем `other` | Заблокирован: имя не совпадает |

476 476 

477> **Список разрешений с переопределением списка запретов**477> [accordion] Список разрешений с переопределением списка запретов

478>478>

479> ```json theme={null}479> ```json theme={null}

480> {480> {

mcp.md +35 −35

Details

1039 1039 

1040Вкладки охватывают обе команды: `claude mcp add` принимает ваш ID клиента и порт обратного вызова как флаги, а `claude mcp add-json` принимает их в объекте `oauth`. Если вы зарегистрировали URI перенаправления, установите порт обратного вызова на порт в этом URI.1040Вкладки охватывают обе команды: `claude mcp add` принимает ваш ID клиента и порт обратного вызова как флаги, а `claude mcp add-json` принимает их в объекте `oauth`. Если вы зарегистрировали URI перенаправления, установите порт обратного вызова на порт в этом URI.

1041 1041 

1042**claude mcp add**1042> [tab] claude mcp add

1043 1043>

1044Используйте `--client-id` для передачи ID клиента вашего приложения. Флаг `--client-secret` запрашивает секрет с замаскированным вводом:1044> Используйте `--client-id` для передачи ID клиента вашего приложения. Флаг `--client-secret` запрашивает секрет с замаскированным вводом:

1045 1045>

1046```bash theme={null}1046> ```bash theme={null}

1047claude mcp add --transport http \1047> claude mcp add --transport http \

1048 --client-id your-client-id --client-secret --callback-port 8080 \1048> --client-id your-client-id --client-secret --callback-port 8080 \

1049 my-server https://mcp.example.com/mcp1049> my-server https://mcp.example.com/mcp

1050```1050> ```

1051 

1052**claude mcp add-json**

1053 

1054Включите объект `oauth` в конфигурацию JSON и передайте `--client-secret` как отдельный флаг:

1055 

1056```bash theme={null}

1057claude mcp add-json my-server \

1058 '{"type":"http","url":"https://mcp.example.com/mcp","oauth":{"clientId":"your-client-id","callbackPort":8080}}' \

1059 --client-secret

1060```

1061 

1062**claude mcp add-json (только порт обратного вызова)**

1063 

1064Чтобы зафиксировать только порт обратного вызова и позволить Claude Code зарегистрировать клиента автоматически, установите `callbackPort` отдельно:

1065 

1066```bash theme={null}

1067claude mcp add-json my-server \

1068 '{"type":"http","url":"https://mcp.example.com/mcp","oauth":{"callbackPort":8080}}'

1069```

1070 1051 

1071**CI / переменная окружения**1052> [tab] claude mcp add-json

1053>

1054> Включите объект `oauth` в конфигурацию JSON и передайте `--client-secret` как отдельный флаг:

1055>

1056> ```bash theme={null}

1057> claude mcp add-json my-server \

1058> '{"type":"http","url":"https://mcp.example.com/mcp","oauth":{"clientId":"your-client-id","callbackPort":8080}}' \

1059> --client-secret

1060> ```

1072 1061 

1073Установите секрет через переменную окружения, чтобы пропустить интерактивный запрос:1062> [tab] claude mcp add-json (только порт обратного вызова)

1063>

1064> Чтобы зафиксировать только порт обратного вызова и позволить Claude Code зарегистрировать клиента автоматически, установите `callbackPort` отдельно:

1065>

1066> ```bash theme={null}

1067> claude mcp add-json my-server \

1068> '{"type":"http","url":"https://mcp.example.com/mcp","oauth":{"callbackPort":8080}}'

1069> ```

1074 1070 

1075```bash theme={null}1071> [tab] CI / переменная окружения

1076MCP_CLIENT_SECRET=your-secret claude mcp add --transport http \1072>

1077 --client-id your-client-id --client-secret --callback-port 8080 \1073> Установите секрет через переменную окружения, чтобы пропустить интерактивный запрос:

1078 my-server https://mcp.example.com/mcp1074>

1079```1075> ```bash theme={null}

1076> MCP_CLIENT_SECRET=your-secret claude mcp add --transport http \

1077> --client-id your-client-id --client-secret --callback-port 8080 \

1078> my-server https://mcp.example.com/mcp

1079> ```

1080 1080 

1081**3. Аутентификация в Claude Code**1081**3. Аутентификация в Claude Code**

1082 1082 

Details

286 286 

287Если сервер не подключается, проверьте его статус с `/mcp` внутри сеанса или `claude mcp list` из вашей оболочки, затем сопоставьте симптом ниже. Панель `/mcp` также позволяет вам переподключиться или аутентифицироваться без выхода из сеанса.287Если сервер не подключается, проверьте его статус с `/mcp` внутри сеанса или `claude mcp list` из вашей оболочки, затем сопоставьте симптом ниже. Панель `/mcp` также позволяет вам переподключиться или аутентифицироваться без выхода из сеанса.

288 288 

289> **/mcp shows No MCP servers configured**289> [accordion] /mcp shows No MCP servers configured

290>290>

291> Claude Code не нашёл никаких серверов для текущего каталога. Наиболее распространённые причины:291> Claude Code не нашёл никаких серверов для текущего каталога. Наиболее распространённые причины:

292>292>

294> * Вы отредактировали файл конфигурации по неправильному пути. Правильные файлы — это `~/.claude.json` и `<project>/.mcp.json`. Claude Code не читает пути, такие как `~/.claude/.mcp.json`, `~/.claude/config/mcp.json`, `~/.claude/mcp.json` или `%APPDATA%\Claude\mcp.json`. Для серверов в области user запустите `claude mcp add --scope user`, который записывает в ключ `mcpServers` в `~/.claude.json`; для серверов в области project отредактируйте `.mcp.json` в корне проекта.294> * Вы отредактировали файл конфигурации по неправильному пути. Правильные файлы — это `~/.claude.json` и `<project>/.mcp.json`. Claude Code не читает пути, такие как `~/.claude/.mcp.json`, `~/.claude/config/mcp.json`, `~/.claude/mcp.json` или `%APPDATA%\Claude\mcp.json`. Для серверов в области user запустите `claude mcp add --scope user`, который записывает в ключ `mcpServers` в `~/.claude.json`; для серверов в области project отредактируйте `.mcp.json` в корне проекта.

295> * Вы написали неправильную запись в `.mcp.json`. Claude Code пропускает эту запись и всё ещё загружает остальные. Запустите `claude mcp list` из вашей оболочки и ищите предупреждение о разборе, которое называет проблемное поле.295> * Вы написали неправильную запись в `.mcp.json`. Claude Code пропускает эту запись и всё ещё загружает остальные. Запустите `claude mcp list` из вашей оболочки и ищите предупреждение о разборе, которое называет проблемное поле.

296 296 

297> **Status shows Failed to connect or Connection error**297> [accordion] Status shows Failed to connect or Connection error

298>298>

299> Оба статуса означают, что сервер не запустился или URL не ответил. Они также могут появляться для HTTP-серверов, которые отклоняют токен, который вы настроили в `headers.Authorization`; сервер, который хочет токен, который вы не настроили, показывает `! Needs authentication` вместо этого, рассмотренный в [Подключение сервера, требующего входа](#connect-a-server-that-requires-sign-in).299> Оба статуса означают, что сервер не запустился или URL не ответил. Они также могут появляться для HTTP-серверов, которые отклоняют токен, который вы настроили в `headers.Authorization`; сервер, который хочет токен, который вы не настроили, показывает `! Needs authentication` вместо этого, рассмотренный в [Подключение сервера, требующего входа](#connect-a-server-that-requires-sign-in).

300>300>

334> Запустите `claude mcp get <name>` и подтвердите, что команда, показанная там, совпадает с тем, что вы только что запустили. Если показанная команда отличается от того, что вы набрали, вы, вероятно, пропустили разделитель `--` перед командой сервера. Удалите сервер и повторно добавьте его с `--` на месте. Если вы написали `.mcp.json` вручную, проверьте его синтаксис и местоположение. До версии 2.1.285 `claude mcp get` не печатал строку `Command` для записи stdio, сохранённой без поля `type`, такой как запись `.mcp.json`, написанная вручную. На этих версиях запустите `claude mcp list` вместо этого, который печатает командную строку в любом случае.334> Запустите `claude mcp get <name>` и подтвердите, что команда, показанная там, совпадает с тем, что вы только что запустили. Если показанная команда отличается от того, что вы набрали, вы, вероятно, пропустили разделитель `--` перед командой сервера. Удалите сервер и повторно добавьте его с `--` на месте. Если вы написали `.mcp.json` вручную, проверьте его синтаксис и местоположение. До версии 2.1.285 `claude mcp get` не печатал строку `Command` для записи stdio, сохранённой без поля `type`, такой как запись `.mcp.json`, написанная вручную. На этих версиях запустите `claude mcp list` вместо этого, который печатает командную строку в любом случае.

335> * Команда выдаёт ошибку: сообщение называет то, что отсутствует, такое как Node.js или браузер.335> * Команда выдаёт ошибку: сообщение называет то, что отсутствует, такое как Node.js или браузер.

336 336 

337> **Connection timed out at startup**337> [accordion] Connection timed out at startup

338>338>

339> Сервер занял больше времени, чем стандартное время ожидания запуска в 30 секунд. Первый запуск сервера stdio может быть медленным, пока `npx` загружает пакет. Увеличьте лимит с переменной окружения [`MCP_TIMEOUT`](https://code.claude.com/docs/ru/env-vars), в миллисекундах:339> Сервер занял больше времени, чем стандартное время ожидания запуска в 30 секунд. Первый запуск сервера stdio может быть медленным, пока `npx` загружает пакет. Увеличьте лимит с переменной окружения [`MCP_TIMEOUT`](https://code.claude.com/docs/ru/env-vars), в миллисекундах:

340>340>

350>350>

351> До версии 2.1.299 некоторые подключения к работающим HTTP-серверам завершались по таймауту при запуске независимо от `MCP_TIMEOUT`. Если вы используете одну из этих версий и работающий HTTP-сервер всё ещё завершается по таймауту после увеличения лимита, [обновите Claude Code](https://code.claude.com/docs/ru/setup.md#update-claude-code).351> До версии 2.1.299 некоторые подключения к работающим HTTP-серверам завершались по таймауту при запуске независимо от `MCP_TIMEOUT`. Если вы используете одну из этих версий и работающий HTTP-сервер всё ещё завершается по таймауту после увеличения лимита, [обновите Claude Code](https://code.claude.com/docs/ru/setup.md#update-claude-code).

352 352 

353> **Server already exists**353> [accordion] Server already exists

354>354>

355> Вы уже добавили сервер с этим именем в той же области. Либо удалите существующую запись сначала, либо выберите другое имя:355> Вы уже добавили сервер с этим именем в той же области. Либо удалите существующую запись сначала, либо выберите другое имя:

356>356>

360>360>

361> Если имя существует в более чем одной области, `remove` сообщает `exists in multiple scopes`. Передайте `--scope` для выбора того, какую копию удалить, например `claude mcp remove claude-code-docs --scope local`.361> Если имя существует в более чем одной области, `remove` сообщает `exists in multiple scopes`. Передайте `--scope` для выбора того, какую копию удалить, например `claude mcp remove claude-code-docs --scope local`.

362 362 

363> **Server connects but no tools appear**363> [accordion] Server connects but no tools appear

364>364>

365> Запустите `/mcp` внутри сеанса и выберите сервер, чтобы увидеть его список инструментов. Если список пуст, сервер запустился, но не зарегистрировал никаких инструментов, что обычно означает, что ему не хватает требуемой переменной окружения, такой как ключ API.365> Запустите `/mcp` внутри сеанса и выберите сервер, чтобы увидеть его список инструментов. Если список пуст, сервер запустился, но не зарегистрировал никаких инструментов, что обычно означает, что ему не хватает требуемой переменной окружения, такой как ключ API.

366>366>

368>368>

369> До версии 2.1.302 `/mcp` показывал статус `tools fetch failed` для сервера, использующего [ревизию протокола 2026-07-28](https://code.claude.com/docs/ru/mcp.md#mcp-client-runtimes), который не включал `resultType`, `ttlMs` или `cacheScope` в свои ответы. Если вы используете одну из этих версий и сервер показывает этот статус, [обновите Claude Code](https://code.claude.com/docs/ru/setup.md#update-claude-code).369> До версии 2.1.302 `/mcp` показывал статус `tools fetch failed` для сервера, использующего [ревизию протокола 2026-07-28](https://code.claude.com/docs/ru/mcp.md#mcp-client-runtimes), который не включал `resultType`, `ttlMs` или `cacheScope` в свои ответы. Если вы используете одну из этих версий и сервер показывает этот статус, [обновите Claude Code](https://code.claude.com/docs/ru/setup.md#update-claude-code).

370 370 

371> **Changes to .mcp.json don't take effect**371> [accordion] Changes to .mcp.json don't take effect

372>372>

373> Claude Code читает `.mcp.json` при запуске сеанса. Выйдите и перезапустите сеанс после редактирования файла.373> Claude Code читает `.mcp.json` при запуске сеанса. Выйдите и перезапустите сеанс после редактирования файла.

374>374>

380> claude mcp reset-project-choices380> claude mcp reset-project-choices

381> ```381> ```

382 382 

383> **OAuth sign-in fails or browser doesn't open**383> [accordion] OAuth sign-in fails or browser doesn't open

384>384>

385> Запустите `/mcp`, выберите сервер и выберите `Authenticate` снова. Если браузер не открывается автоматически, скопируйте URL, показанный в терминале, и откройте его вручную. См. [Аутентификация с удалёнными серверами MCP](https://code.claude.com/docs/ru/mcp.md#authenticate-with-remote-mcp-servers) для фиксированных портов обратного вызова и предварительно настроенных учётных данных.385> Запустите `/mcp`, выберите сервер и выберите `Authenticate` снова. Если браузер не открывается автоматически, скопируйте URL, показанный в терминале, и откройте его вручную. См. [Аутентификация с удалёнными серверами MCP](https://code.claude.com/docs/ru/mcp.md#authenticate-with-remote-mcp-servers) для фиксированных портов обратного вызова и предварительно настроенных учётных данных.

386 386 

mobile.md +2 −2

Details

39| [Cloud sessions](https://code.claude.com/docs/ru/claude-code-on-the-web.md) | Сеанс на облачной инфраструктуре, управляемой Anthropic по умолчанию | Ваш репозиторий находится на GitHub и задача должна продолжаться после того, как вы отложите телефон. См. [краткое руководство веб-версии](https://code.claude.com/docs/ru/web-quickstart.md) для настройки. |39| [Cloud sessions](https://code.claude.com/docs/ru/claude-code-on-the-web.md) | Сеанс на облачной инфраструктуре, управляемой Anthropic по умолчанию | Ваш репозиторий находится на GitHub и задача должна продолжаться после того, как вы отложите телефон. См. [краткое руководство веб-версии](https://code.claude.com/docs/ru/web-quickstart.md) для настройки. |

40| [Projects](https://code.claude.com/docs/ru/claude-projects.md) | Беседа, в которой Claude координирует параллельные потоки работы и отчитывается | У вас есть поток связанной работы, а не одна задача, и вы хотите увидеть, какие потоки завершены или требуют вас. |40| [Projects](https://code.claude.com/docs/ru/claude-projects.md) | Беседа, в которой Claude координирует параллельные потоки работы и отчитывается | У вас есть поток связанной работы, а не одна задача, и вы хотите увидеть, какие потоки завершены или требуют вас. |

41| [Remote Control](https://code.claude.com/docs/ru/remote-control.md) | Сеанс Claude Code, работающий на вашем компьютере | Работе нужна ваша локальная файловая система, инструменты или MCP серверы. |41| [Remote Control](https://code.claude.com/docs/ru/remote-control.md) | Сеанс Claude Code, работающий на вашем компьютере | Работе нужна ваша локальная файловая система, инструменты или MCP серверы. |

42| [Dispatch](https://code.claude.com/docs/ru/desktop.md#sessions-from-dispatch) | Приложение Desktop на вашем компьютере | Вы хотите отправить задачу и позволить Dispatch решить, как её запустить. Требуется план Pro или Max. |42| [Dispatch](https://code.claude.com/docs/ru/desktop.md#sessions-from-dispatch) | Приложение Desktop на вашем компьютере | Вы хотите отправить задачу и позволить Dispatch решить, как её запустить. Требуется план Pro, Max или Ultra. |

43 43 

44Если ваш компьютер будет выключен, используйте облачные сеансы или проект, которые работают в облаке и продолжают работу с закрытым ноутбуком. Remote Control и Dispatch управляют вашей собственной машиной, поэтому она должна оставаться включённой с запущенным Claude Code или приложением Desktop. Если ваша машина перейдёт в режим сна во время сеанса Remote Control, Claude Code переподключится, когда она вернётся в сеть.44Если ваш компьютер будет выключен, используйте облачные сеансы или проект, которые работают в облаке и продолжают работу с закрытым ноутбуком. Remote Control и Dispatch управляют вашей собственной машиной, поэтому она должна оставаться включённой с запущенным Claude Code или приложением Desktop. Если ваша машина перейдёт в режим сна во время сеанса Remote Control, Claude Code переподключится, когда она вернётся в сеть.

45 45 

76 76 

77* **Команды только для локального использования**: команды, которые работают только в интерфейсе терминала, такие как `/plugin` и `/resume`, не работают из приложения. [Ограничения Remote Control](https://code.claude.com/docs/ru/remote-control.md#limitations) перечисляют команды, которые работают с мобильного устройства, и как их поведение отличается.77* **Команды только для локального использования**: команды, которые работают только в интерфейсе терминала, такие как `/plugin` и `/resume`, не работают из приложения. [Ограничения Remote Control](https://code.claude.com/docs/ru/remote-control.md#limitations) перечисляют команды, которые работают с мобильного устройства, и как их поведение отличается.

78* **Режимы разрешений**: облачные сессии предлагают Accept edits, Plan и Auto, а сессии Remote Control предлагают Manual, Accept edits, Plan и Auto. Вы не можете выбрать Bypass permissions из приложения ни в одном случае. См. [переключение режимов разрешений](https://code.claude.com/docs/ru/permission-modes.md#switch-permission-modes), чтобы узнать, когда доступен Auto.78* **Режимы разрешений**: облачные сессии предлагают Accept edits, Plan и Auto, а сессии Remote Control предлагают Manual, Accept edits, Plan и Auto. Вы не можете выбрать Bypass permissions из приложения ни в одном случае. См. [переключение режимов разрешений](https://code.claude.com/docs/ru/permission-modes.md#switch-permission-modes), чтобы узнать, когда доступен Auto.

79* **Планы Dispatch**: Dispatch требует план Pro или Max и недоступен для Team или Enterprise.79* **Планы Dispatch**: Dispatch требует план Pro, Max или Ultra и недоступен для Team или Enterprise.

80 80 

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

82 82 

model-config.md +4 −4

Details

455 455 

456Поведение `default` зависит от типа вашей учётной записи:456Поведение `default` зависит от типа вашей учётной записи:

457 457 

458* **Pro, Max, Team, Enterprise и Anthropic API**: по умолчанию Opus 5.5458* **Pro, Max, Ultra, Team, Enterprise и Anthropic API**: по умолчанию Opus 5.5

459* **Claude Platform on AWS, Amazon Bedrock и Google Cloud's Agent Platform**: по умолчанию Opus 5.5459* **Claude Platform on AWS, Amazon Bedrock и Google Cloud's Agent Platform**: по умолчанию Opus 5.5

460* **Microsoft Foundry**: по умолчанию Sonnet 4.5460* **Microsoft Foundry**: по умолчанию Sonnet 4.5

461 461 

462До версии 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.462До версии 2.1.280 `default` разрешался в Sonnet 5 на Pro и Team Standard, а в Opus 5 на Max, Ultra, 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, Ultra, 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.

463 463 

464Когда администратор установил [модель по умолчанию организации](#organization-default-model), `default` разрешается в эту модель вместо стандартного значения для типа учётной записи выше. Требуется Claude Code версии 2.1.196 или позже. `default` также может разрешаться в модель, которую вы установили с помощью [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions), при условиях, указанных в его разделе, или в модель, [записанную в вашей учётной записи](#setting-your-model).464Когда администратор установил [модель по умолчанию организации](#organization-default-model), `default` разрешается в эту модель вместо стандартного значения для типа учётной записи выше. Требуется Claude Code версии 2.1.196 или позже. `default` также может разрешаться в модель, которую вы установили с помощью [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions), при условиях, указанных в его разделе, или в модель, [записанную в вашей учётной записи](#setting-your-model).

465 465 

758 758 

759Fable 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](https://code.claude.com/docs/ru/claude-apps-gateway). Чтобы вместо этого запускать их с окном 200K, см. [Отключение контекста 1M](#turn-off-1m-context).759Fable 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](https://code.claude.com/docs/ru/claude-apps-gateway). Чтобы вместо этого запускать их с окном 200K, см. [Отключение контекста 1M](#turn-off-1m-context).

760 760 

761Opus 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.761Opus 4.6 и Sonnet 4.6 получают 1M только через свой вариант `[1m]`, и доступ к этому варианту зависит от вашего тарифа. На тарифах Max, Ultra, 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 и Ultra.

762 762 

763| Тариф | Opus 4.6 с контекстом 1M | Sonnet 4.6 с контекстом 1M |763| Тариф | Opus 4.6 с контекстом 1M | Sonnet 4.6 с контекстом 1M |

764| - | - | - |764| - | - | - |

765| Max, Team и Enterprise | Входит в подписку | Требует [кредитов использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |765| Max, Ultra, Team и Enterprise | Входит в подписку | Требует [кредитов использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |

766| 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) |766| 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) |

767| API и оплата по мере использования | Полный доступ | Полный доступ |767| API и оплата по мере использования | Полный доступ | Полный доступ |

768 768 

overview.md +119 −119

Details

12 12 

13Claude Code работает на нескольких платформах: в терминале, расширениях IDE, настольном приложении и в веб-версии. Выберите одну из вкладок ниже, чтобы начать. Большинство платформ требуют [подписку Claude](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=overview_pricing) или учетную запись [Anthropic Console](https://platform.claude.com/). Terminal CLI, VS Code и JetBrains также поддерживают [сторонних поставщиков](https://code.claude.com/docs/ru/third-party-integrations.md).13Claude Code работает на нескольких платформах: в терминале, расширениях IDE, настольном приложении и в веб-версии. Выберите одну из вкладок ниже, чтобы начать. Большинство платформ требуют [подписку Claude](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=overview_pricing) или учетную запись [Anthropic Console](https://platform.claude.com/). Terminal CLI, VS Code и JetBrains также поддерживают [сторонних поставщиков](https://code.claude.com/docs/ru/third-party-integrations.md).

14 14 

15**Terminal**15> [tab] Terminal

16 16>

17Полнофункциональный CLI для работы с Claude Code прямо в вашем терминале. Редактируйте файлы, выполняйте команды и управляйте всем проектом из командной строки.17> Полнофункциональный CLI для работы с Claude Code прямо в вашем терминале. Редактируйте файлы, выполняйте команды и управляйте всем проектом из командной строки.

18 18>

19Для установки Claude Code откройте терминал и выполните команду для вашей системы. Если вы раньше не использовали терминал, [руководство по терминалу](https://code.claude.com/docs/ru/terminal-guide) показывает, как его открыть и вставить команду.19> Для установки Claude Code откройте терминал и выполните команду для вашей системы. Если вы раньше не использовали терминал, [руководство по терминалу](https://code.claude.com/docs/ru/terminal-guide) показывает, как его открыть и вставить команду.

20 20>

21**Встроенная установка (рекомендуется)**21> > [tab] Встроенная установка (рекомендуется)

22 22> >

23**macOS, Linux, WSL:**23> > **macOS, Linux, WSL:**

24 24> >

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

26curl -fsSL https://claude.ai/install.sh | bash26> > curl -fsSL https://claude.ai/install.sh | bash

27```27> > ```

28 28> >

29В Windows приглашение командной строки показывает `PS C:\`, когда вы находитесь в PowerShell, и `C:\` без `PS`, когда вы находитесь в CMD.29> > В Windows приглашение командной строки показывает `PS C:\`, когда вы находитесь в PowerShell, и `C:\` без `PS`, когда вы находитесь в CMD.

30 30> >

31**Windows PowerShell:**31> > **Windows PowerShell:**

32 32> >

33```powershell theme={null}33> > ```powershell theme={null}

34irm https://claude.ai/install.ps1 | iex34> > irm https://claude.ai/install.ps1 | iex

35```35> > ```

36 36> >

37**Windows CMD:**37> > **Windows CMD:**

38 38> >

39```batch theme={null}39> > ```batch theme={null}

40curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd40> > curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

41```41> > ```

42 42> >

43Команда установки не показывает прогресс во время загрузки Claude Code. Когда установщик завершит работу, откройте новое окно терминала и выполните `claude --version`. Работающая установка выводит номер версии. Если ваша оболочка говорит, что `claude` не найден или не распознан, каталог установки еще не находится в вашем PATH: см. [Исправьте ваш PATH](https://code.claude.com/docs/ru/troubleshoot-install.md#command-not-found-claude-after-installation).43> > Команда установки не показывает прогресс во время загрузки Claude Code. Когда установщик завершит работу, откройте новое окно терминала и выполните `claude --version`. Работающая установка выводит номер версии. Если ваша оболочка говорит, что `claude` не найден или не распознан, каталог установки еще не находится в вашем PATH: см. [Исправьте ваш PATH](https://code.claude.com/docs/ru/troubleshoot-install.md#command-not-found-claude-after-installation).

44 44> >

45Если вы видите `The token '&&' is not a valid statement separator`, вы находитесь в PowerShell, а не в CMD. Если вы видите `'irm' is not recognized as an internal or external command`, вы находитесь в CMD, а не в PowerShell.45> > Если вы видите `The token '&&' is not a valid statement separator`, вы находитесь в PowerShell, а не в CMD. Если вы видите `'irm' is not recognized as an internal or external command`, вы находитесь в CMD, а не в PowerShell.

46 46> >

47Если команда установки завершается с ошибкой `syntax error near unexpected token '<'`, `403` или любой другой ошибкой, см. [Устранение неполадок при установке](https://code.claude.com/docs/ru/troubleshoot-install.md#find-your-error), чтобы сопоставить ошибку с исправлением и для альтернативных методов установки.47> > Если команда установки завершается с ошибкой `syntax error near unexpected token '<'`, `403` или любой другой ошибкой, см. [Устранение неполадок при установке](https://code.claude.com/docs/ru/troubleshoot-install.md#find-your-error), чтобы сопоставить ошибку с исправлением и для альтернативных методов установки.

48 48> >

49[Git for Windows](https://git-scm.com/downloads/win) рекомендуется на встроенной Windows, чтобы Claude Code мог использовать инструмент Bash. Если Git for Windows не установлен, Claude Code использует PowerShell в качестве инструмента оболочки. Установки WSL не требуют Git for Windows.49> > [Git for Windows](https://git-scm.com/downloads/win) рекомендуется на встроенной Windows, чтобы Claude Code мог использовать инструмент Bash. Если Git for Windows не установлен, Claude Code использует PowerShell в качестве инструмента оболочки. Установки WSL не требуют Git for Windows.

50 50> >

51> [!NOTE]51> > > [!NOTE]

52> > >

53> > > Встроенные установки автоматически обновляются в фоновом режиме, чтобы вы всегда использовали последнюю версию.

54>

55> > [tab] Homebrew

56> >

57> > ```bash theme={null}

58> > brew install --cask claude-code

59> > ```

60> >

61> > Homebrew предлагает два пакета. `claude-code` отслеживает канал стабильного выпуска, который обычно отстает примерно на неделю и пропускает выпуски с серьезными регрессиями. `claude-code@latest` отслеживает последний канал и получает новые версии сразу после их выпуска.

62> >

63> > > [!NOTE]

64> > >

65> > > Установки Homebrew не обновляются автоматически. Запустите `brew upgrade claude-code` или `brew upgrade claude-code@latest`, в зависимости от того, какой пакет вы установили, чтобы получить последние функции и исправления безопасности.

66>

67> > [tab] WinGet

68> >

69> > ```powershell theme={null}

70> > winget install Anthropic.ClaudeCode

71> > ```

72> >

73> > > [!NOTE]

74> > >

75> > > Установки WinGet не обновляются автоматически. Периодически запускайте `winget upgrade Anthropic.ClaudeCode` чтобы получить последние функции и исправления безопасности.

76>

77> Вы также можете установить с помощью [apt, dnf или apk](https://code.claude.com/docs/ru/setup.md#install-with-linux-package-managers) на Debian, Fedora, RHEL и Alpine.

78>

79> Затем запустите Claude Code в любом проекте. Замените `your-project` на путь к каталогу проекта на вашей машине:

52>80>

53> Встроенные установки автоматически обновляются в фоновом режиме, чтобы вы всегда использовали последнюю версию.81> ```bash theme={null}

54 82> cd your-project

55**Homebrew**83> claude

56 84> ```

57```bash theme={null}

58brew install --cask claude-code

59```

60 

61Homebrew предлагает два пакета. `claude-code` отслеживает канал стабильного выпуска, который обычно отстает примерно на неделю и пропускает выпуски с серьезными регрессиями. `claude-code@latest` отслеживает последний канал и получает новые версии сразу после их выпуска.

62 

63> [!NOTE]

64>85>

65> Установки Homebrew не обновляются автоматически. Запустите `brew upgrade claude-code` или `brew upgrade claude-code@latest`, в зависимости от того, какой пакет вы установили, чтобы получить последние функции и исправления безопасности.86> При первом использовании Claude Code предложит вам войти. Если вы установили переменную окружения `ANTHROPIC_API_KEY` и одобрите ключ, когда Claude Code спросит, использовать ли его, Claude Code пропустит запрос на вход. [Перейти к быстрому старту →](https://code.claude.com/docs/ru/quickstart.md)

66 

67**WinGet**

68 

69```powershell theme={null}

70winget install Anthropic.ClaudeCode

71```

72 

73> [!NOTE]

74>87>

75> Установки WinGet не обновляются автоматически. Периодически запускайте `winget upgrade Anthropic.ClaudeCode` чтобы получить последние функции и исправления безопасности.88> > [!TIP]

76 89> >

77Вы также можете установить с помощью [apt, dnf или apk](https://code.claude.com/docs/ru/setup.md#install-with-linux-package-managers) на Debian, Fedora, RHEL и Alpine.90> > Смотрите [расширенную настройку](https://code.claude.com/docs/ru/setup.md) для опций установки, ручных обновлений или инструкций по удалению. Посетите [troubleshooting установки](https://code.claude.com/docs/ru/troubleshoot-install.md), если у вас возникли проблемы.

78 

79Затем запустите Claude Code в любом проекте. Замените `your-project` на путь к каталогу проекта на вашей машине:

80 91 

81```bash theme={null}92> [tab] VS Code

82cd your-project

83claude

84```

85 

86При первом использовании Claude Code предложит вам войти. Если вы установили переменную окружения `ANTHROPIC_API_KEY` и одобрите ключ, когда Claude Code спросит, использовать ли его, Claude Code пропустит запрос на вход. [Перейти к быстрому старту →](https://code.claude.com/docs/ru/quickstart.md)

87 

88> [!TIP]

89>93>

90> Смотрите [расширенную настройку](https://code.claude.com/docs/ru/setup.md) для опций установки, ручных обновлений или инструкций по удалению. Посетите [troubleshooting установки](https://code.claude.com/docs/ru/troubleshoot-install.md), если у вас возникли проблемы.94> Расширение VS Code предоставляет встроенные различия, @-упоминания, просмотр плана и историю разговоров прямо в вашем редакторе.

91 95>

92**VS Code**96> * [Установить для VS Code](vscode:extension/anthropic.claude-code)

93 97> * [Установить для Cursor](cursor:extension/anthropic.claude-code)

94Расширение VS Code предоставляет встроенные различия, @-упоминания, просмотр плана и историю разговоров прямо в вашем редакторе.98>

95 99> Или найдите "Claude Code" в представлении Extensions (`Cmd+Shift+X` на Mac, `Ctrl+Shift+X` на Windows/Linux). После установки откройте Command Palette (`Cmd+Shift+P` / `Ctrl+Shift+P`), введите "Claude Code" и выберите **Open in New Tab**.

96* [Установить для VS Code](vscode:extension/anthropic.claude-code)100>

97* [Установить для Cursor](cursor:extension/anthropic.claude-code)101> [Начните работу с VS Code →](https://code.claude.com/docs/ru/vs-code.md#get-started)

98 

99Или найдите "Claude Code" в представлении Extensions (`Cmd+Shift+X` на Mac, `Ctrl+Shift+X` на Windows/Linux). После установки откройте Command Palette (`Cmd+Shift+P` / `Ctrl+Shift+P`), введите "Claude Code" и выберите **Open in New Tab**.

100 

101[Начните работу с VS Code →](https://code.claude.com/docs/ru/vs-code.md#get-started)

102 

103**Desktop app**

104 

105Автономное приложение для запуска Claude Code вне вашей IDE или терминала. Просматривайте различия визуально, запускайте несколько сеансов рядом, планируйте повторяющиеся задачи и запускайте облачные сеансы.

106 

107Загрузите и установите:

108 

109* [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs) (Intel и Apple Silicon)

110* [Windows](https://claude.ai/api/desktop/win32/x64/setup/latest/redirect?utm_source=claude_code\&utm_medium=docs) (x64)

111* [Windows ARM64](https://claude.ai/api/desktop/win32/arm64/setup/latest/redirect?utm_source=claude_code\&utm_medium=docs)

112* На Ubuntu или Debian, где приложение находится в бета-версии, установите его с помощью apt, следуя [инструкциям по установке Linux](https://code.claude.com/docs/ru/desktop-linux.md)

113 

114После установки запустите Claude, войдите и нажмите вкладку **Code** для начала кодирования. Приложение включает Claude Code, поэтому вам не нужно устанавливать CLI отдельно. Требуется [платная подписка](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=overview_desktop_pricing).

115 

116[Узнайте больше о приложении для рабочего стола →](https://code.claude.com/docs/ru/desktop-quickstart.md)

117 

118**Web**

119 

120Запустите Claude Code в вашем браузере без локальной настройки. Запускайте долгоживущие задачи и возвращайтесь, когда они будут готовы, работайте с репозиториями, которые у вас нет локально, или запускайте несколько задач параллельно. Для более длительной работы создайте [проект](https://code.claude.com/docs/ru/claude-projects.md) и позвольте Claude координировать параллельные сеансы для вас. Доступно на настольных браузерах и [приложении Claude для iOS и Android](https://code.claude.com/docs/ru/mobile.md).

121 

122Начните кодирование на [claude.ai/code](https://claude.ai/code).

123 

124[Начните работу →](https://code.claude.com/docs/ru/web-quickstart.md)

125 

126**JetBrains**

127 102 

128Плагин для IntelliJ IDEA, PyCharm, WebStorm и других IDE JetBrains с интерактивным просмотром различий и совместным использованием контекста выделения.103> [tab] Desktop app

104>

105> Автономное приложение для запуска Claude Code вне вашей IDE или терминала. Просматривайте различия визуально, запускайте несколько сеансов рядом, планируйте повторяющиеся задачи и запускайте облачные сеансы.

106>

107> Загрузите и установите:

108>

109> * [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs) (Intel и Apple Silicon)

110> * [Windows](https://claude.ai/api/desktop/win32/x64/setup/latest/redirect?utm_source=claude_code\&utm_medium=docs) (x64)

111> * [Windows ARM64](https://claude.ai/api/desktop/win32/arm64/setup/latest/redirect?utm_source=claude_code\&utm_medium=docs)

112> * На Ubuntu или Debian, где приложение находится в бета-версии, установите его с помощью apt, следуя [инструкциям по установке Linux](https://code.claude.com/docs/ru/desktop-linux.md)

113>

114> После установки запустите Claude, войдите и нажмите вкладку **Code** для начала кодирования. Приложение включает Claude Code, поэтому вам не нужно устанавливать CLI отдельно. Требуется [платная подписка](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=overview_desktop_pricing).

115>

116> [Узнайте больше о приложении для рабочего стола →](https://code.claude.com/docs/ru/desktop-quickstart.md)

129 117 

130Установите [плагин Claude Code](https://plugins.jetbrains.com/plugin/27310-claude-code-beta-) из JetBrains Marketplace и перезагрузите вашу IDE. Плагин требует Claude Code CLI, установленный отдельно; см. [шаги настройки JetBrains](https://code.claude.com/docs/ru/jetbrains.md#installation).118> [tab] Web

119>

120> Запустите Claude Code в вашем браузере без локальной настройки. Запускайте долгоживущие задачи и возвращайтесь, когда они будут готовы, работайте с репозиториями, которые у вас нет локально, или запускайте несколько задач параллельно. Для более длительной работы создайте [проект](https://code.claude.com/docs/ru/claude-projects.md) и позвольте Claude координировать параллельные сеансы для вас. Доступно на настольных браузерах и [приложении Claude для iOS и Android](https://code.claude.com/docs/ru/mobile.md).

121>

122> Начните кодирование на [claude.ai/code](https://claude.ai/code).

123>

124> [Начните работу →](https://code.claude.com/docs/ru/web-quickstart.md)

131 125 

132[Начните работу с JetBrains →](https://code.claude.com/docs/ru/jetbrains.md)126> [tab] JetBrains

127>

128> Плагин для IntelliJ IDEA, PyCharm, WebStorm и других IDE JetBrains с интерактивным просмотром различий и совместным использованием контекста выделения.

129>

130> Установите [плагин Claude Code](https://plugins.jetbrains.com/plugin/27310-claude-code-beta-) из JetBrains Marketplace и перезагрузите вашу IDE. Плагин требует Claude Code CLI, установленный отдельно; см. [шаги настройки JetBrains](https://code.claude.com/docs/ru/jetbrains.md#installation).

131>

132> [Начните работу с JetBrains →](https://code.claude.com/docs/ru/jetbrains.md)

133 133 

134## Что вы можете делать134## Что вы можете делать

135 135 

136Вот некоторые способы использования Claude Code:136Вот некоторые способы использования Claude Code:

137 137 

138> **Автоматизируйте работу, которую вы постоянно откладываете**138> [accordion] Автоматизируйте работу, которую вы постоянно откладываете

139>139>

140> Claude Code справляется с утомительными задачами, которые съедают ваш день: написание тестов для непроверенного кода, исправление ошибок lint по всему проекту, разрешение конфликтов слияния, обновление зависимостей и написание заметок о выпуске.140> Claude Code справляется с утомительными задачами, которые съедают ваш день: написание тестов для непроверенного кода, исправление ошибок lint по всему проекту, разрешение конфликтов слияния, обновление зависимостей и написание заметок о выпуске.

141>141>

143> claude "write tests for the auth module, run them, and fix any failures"143> claude "write tests for the auth module, run them, and fix any failures"

144> ```144> ```

145 145 

146> **Создавайте функции и исправляйте ошибки**146> [accordion] Создавайте функции и исправляйте ошибки

147>147>

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

149>149>

150> Для ошибок вставьте сообщение об ошибке или опишите симптом. Claude Code отслеживает проблему через вашу кодовую базу, определяет основную причину и реализует исправление. Смотрите [common workflows](https://code.claude.com/docs/ru/common-workflows.md) для получения дополнительных примеров.150> Для ошибок вставьте сообщение об ошибке или опишите симптом. Claude Code отслеживает проблему через вашу кодовую базу, определяет основную причину и реализует исправление. Смотрите [common workflows](https://code.claude.com/docs/ru/common-workflows.md) для получения дополнительных примеров.

151 151 

152> **Создавайте коммиты и pull requests**152> [accordion] Создавайте коммиты и pull requests

153>153>

154> Claude Code работает непосредственно с git. Он подготавливает изменения, пишет сообщения коммитов, создает ветки и открывает pull requests.154> Claude Code работает непосредственно с git. Он подготавливает изменения, пишет сообщения коммитов, создает ветки и открывает pull requests.

155>155>

159>159>

160> В CI вы можете автоматизировать код-ревью и сортировку проблем с помощью [GitHub Actions](https://code.claude.com/docs/ru/github-actions.md) или [GitLab CI/CD](https://code.claude.com/docs/ru/gitlab-ci-cd.md).160> В CI вы можете автоматизировать код-ревью и сортировку проблем с помощью [GitHub Actions](https://code.claude.com/docs/ru/github-actions.md) или [GitLab CI/CD](https://code.claude.com/docs/ru/gitlab-ci-cd.md).

161 161 

162> **Подключите свои инструменты с помощью MCP**162> [accordion] Подключите свои инструменты с помощью MCP

163>163>

164> [Model Context Protocol (MCP)](https://code.claude.com/docs/ru/mcp.md) — это открытый стандарт для подключения инструментов AI к внешним источникам данных. С помощью MCP Claude Code может читать ваши документы дизайна в Google Drive, обновлять задачи в Jira, извлекать данные из Slack или использовать ваши собственные пользовательские инструменты. [Быстрый старт MCP](https://code.claude.com/docs/ru/mcp-quickstart.md) подключает ваш первый сервер от начала до конца.164> [Model Context Protocol (MCP)](https://code.claude.com/docs/ru/mcp.md) — это открытый стандарт для подключения инструментов AI к внешним источникам данных. С помощью MCP Claude Code может читать ваши документы дизайна в Google Drive, обновлять задачи в Jira, извлекать данные из Slack или использовать ваши собственные пользовательские инструменты. [Быстрый старт MCP](https://code.claude.com/docs/ru/mcp-quickstart.md) подключает ваш первый сервер от начала до конца.

165 165 

166> **Настройте с помощью инструкций, скиллов и хуков**166> [accordion] Настройте с помощью инструкций, скиллов и хуков

167>167>

168> [`CLAUDE.md`](https://code.claude.com/docs/ru/memory) — это файл markdown, который вы добавляете в корень вашего проекта, и Claude Code читает его в начале каждой сессии. Используйте его для установки стандартов кодирования, архитектурных решений, предпочитаемых библиотек и контрольных списков проверки. Если в вашем репозитории уже есть `AGENTS.md` для других агентов кодирования, Claude Code [может читать его](https://code.claude.com/docs/ru/memory.md#agents-md) вместо `CLAUDE.md`. Claude также создает [автоматическую память](https://code.claude.com/docs/ru/memory.md#auto-memory) по мере работы, сохраняя знания между сессиями без необходимости что-либо писать.168> [`CLAUDE.md`](https://code.claude.com/docs/ru/memory) — это файл markdown, который вы добавляете в корень вашего проекта, и Claude Code читает его в начале каждой сессии. Используйте его для установки стандартов кодирования, архитектурных решений, предпочитаемых библиотек и контрольных списков проверки. Если в вашем репозитории уже есть `AGENTS.md` для других агентов кодирования, Claude Code [может читать его](https://code.claude.com/docs/ru/memory.md#agents-md) вместо `CLAUDE.md`. Claude также создает [автоматическую память](https://code.claude.com/docs/ru/memory.md#auto-memory) по мере работы, сохраняя знания между сессиями без необходимости что-либо писать.

169>169>

171>171>

172> [Hooks](https://code.claude.com/docs/ru/hooks.md) позволяют вам запускать команды shell до или после действий Claude Code, например автоматическое форматирование после каждого редактирования файла или запуск lint перед коммитом.172> [Hooks](https://code.claude.com/docs/ru/hooks.md) позволяют вам запускать команды shell до или после действий Claude Code, например автоматическое форматирование после каждого редактирования файла или запуск lint перед коммитом.

173 173 

174> **Запустите агентов параллельно и создавайте пользовательских агентов**174> [accordion] Запустите агентов параллельно и создавайте пользовательских агентов

175>175>

176> Запустите [несколько агентов Claude Code](https://code.claude.com/docs/ru/sub-agents.md), которые работают над разными частями задачи одновременно. Главный агент координирует работу, назначает подзадачи и объединяет результаты.176> Запустите [несколько агентов Claude Code](https://code.claude.com/docs/ru/sub-agents.md), которые работают над разными частями задачи одновременно. Главный агент координирует работу, назначает подзадачи и объединяет результаты.

177>177>

178> Для запуска нескольких полных сеансов параллельно и наблюдения за ними с одного экрана используйте [background agents](https://code.claude.com/docs/ru/agent-view.md). Для полностью пользовательских рабочих процессов [Agent SDK](https://code.claude.com/docs/ru/agent-sdk/overview.md) позволяет вам создавать собственных агентов, работающих на инструментах и возможностях Claude Code, с полным контролем над оркестровкой, доступом к инструментам и разрешениями.178> Для запуска нескольких полных сеансов параллельно и наблюдения за ними с одного экрана используйте [background agents](https://code.claude.com/docs/ru/agent-view.md). Для полностью пользовательских рабочих процессов [Agent SDK](https://code.claude.com/docs/ru/agent-sdk/overview.md) позволяет вам создавать собственных агентов, работающих на инструментах и возможностях Claude Code, с полным контролем над оркестровкой, доступом к инструментам и разрешениями.

179 179 

180> **Передавайте, создавайте скрипты и автоматизируйте с помощью CLI**180> [accordion] Передавайте, создавайте скрипты и автоматизируйте с помощью CLI

181>181>

182> Claude Code является составным и следует философии Unix. Передавайте в него логи, запускайте его в CI или объединяйте его с другими инструментами:182> Claude Code является составным и следует философии Unix. Передавайте в него логи, запускайте его в CI или объединяйте его с другими инструментами:

183>183>

194>194>

195> Смотрите [CLI reference](https://code.claude.com/docs/ru/cli-reference.md) для полного набора команд и флагов.195> Смотрите [CLI reference](https://code.claude.com/docs/ru/cli-reference.md) для полного набора команд и флагов.

196 196 

197> **Планируйте повторяющиеся задачи**197> [accordion] Планируйте повторяющиеся задачи

198>198>

199> Запускайте Claude по расписанию для автоматизации работы, которая повторяется: утренние проверки PR, анализ сбоев CI в ночное время, еженедельные аудиты зависимостей или синхронизация документов после слияния PR.199> Запускайте Claude по расписанию для автоматизации работы, которая повторяется: утренние проверки PR, анализ сбоев CI в ночное время, еженедельные аудиты зависимостей или синхронизация документов после слияния PR.

200>200>

202> * [Запланированные задачи Desktop](https://code.claude.com/docs/ru/desktop-scheduled-tasks.md) работают на вашей машине с прямым доступом к вашим локальным файлам и инструментам202> * [Запланированные задачи Desktop](https://code.claude.com/docs/ru/desktop-scheduled-tasks.md) работают на вашей машине с прямым доступом к вашим локальным файлам и инструментам

203> * [`/loop`](https://code.claude.com/docs/ru/scheduled-tasks) повторяет промпт в сессии CLI для быстрого опроса203> * [`/loop`](https://code.claude.com/docs/ru/scheduled-tasks) повторяет промпт в сессии CLI для быстрого опроса

204 204 

205> **Работайте откуда угодно**205> [accordion] Работайте откуда угодно

206>206>

207> Сессии не привязаны к одному интерфейсу. Перемещайте работу между ними по мере изменения вашего контекста:207> Сессии не привязаны к одному интерфейсу. Перемещайте работу между ними по мере изменения вашего контекста:

208>208>

permission-modes.md +140 −135

Details

8 8 

9Режим разрешений определяет, какие действия Claude может выполнять в сеансе без предварительного запроса у вас. В режиме Manual Claude Code останавливается и просит вас перед большинством действий, которые редактируют файлы, запускают команды оболочки или обращаются в сеть. В [режиме auto](#eliminate-prompts-with-auto-mode) вторая модель, классификатор, проверяет действия вместо вас; [как классификатор оценивает действия](#how-the-classifier-evaluates-actions) перечисляет, какие действия он проверяет и какие его пропускают.9Режим разрешений определяет, какие действия Claude может выполнять в сеансе без предварительного запроса у вас. В режиме Manual Claude Code останавливается и просит вас перед большинством действий, которые редактируют файлы, запускают команды оболочки или обращаются в сеть. В [режиме auto](#eliminate-prompts-with-auto-mode) вторая модель, классификатор, проверяет действия вместо вас; [как классификатор оценивает действия](#how-the-classifier-evaluates-actions) перечисляет, какие действия он проверяет и какие его пропускают.

10 10 

11С Claude Code версии 2.1.283 или позже режим auto является встроенным начальным режимом разрешений для интерактивных сеансов терминала и VS Code. В более ранних версиях это встроенный начальный режим разрешений только на планах Pro, Max и Team. [Какой режим начинается в сеансе](#which-mode-a-session-starts-in) охватывает интерфейсы и параметры, которые изменяют начальный режим разрешений. Вы также можете изменить режим разрешений работающего сеанса в любое время.11Начиная с Claude Code версии 2.1.283, авторежим является встроенным начальным режимом разрешений для интерактивных сессий в терминале и VS Code. В более ранних версиях он является встроенным начальным режимом разрешений только на планах Pro, Max, Ultra и Team. В разделе [в каком режиме запускается сессия](#which-mode-a-session-starts-in) описаны интерфейсы и настройки, которые изменяют начальный режим разрешений. Вы также можете изменить режим разрешений запущенной сессии в любой момент.

12 12 

13## Доступные режимы13## Доступные режимы

14 14 

80| Любой файл настроек устанавливает `disableAutoMode` в значение `"disable"` | `default` |80| Любой файл настроек устанавливает `disableAutoMode` в значение `"disable"` | `default` |

81| `claude -p` или [Agent SDK](https://code.claude.com/docs/ru/agent-sdk/permissions.md#permission-modes) | `default` |81| `claude -p` или [Agent SDK](https://code.claude.com/docs/ru/agent-sdk/permissions.md#permission-modes) | `default` |

82| К вашей организации применена [конфигурация HIPAA](#hipaa-configuration), и сессия [подпадает под неё](https://code.claude.com/docs/ru/hipaa-setup.md#check-how-developers-sign-in-and-connect) | `default` с Claude Code v2.1.285 или новее; на авторежим по-прежнему можно переключиться |82| К вашей организации применена [конфигурация HIPAA](#hipaa-configuration), и сессия [подпадает под неё](https://code.claude.com/docs/ru/hipaa-setup.md#check-how-developers-sign-in-and-connect) | `default` с Claude Code v2.1.285 или новее; на авторежим по-прежнему можно переключиться |

83| В терминале или через [расширение VS Code](https://code.claude.com/docs/ru/vs-code.md) | `auto` с Claude Code v2.1.283 или новее; в более ранних версиях `auto` на планах Pro, Max или Team в сессиях, которые [получают флаги функций](https://code.claude.com/docs/ru/env-vars.md#features-that-need-feature-flag-fetching), и `default` в остальных случаях |83| В терминале или через [расширение VS Code](https://code.claude.com/docs/ru/vs-code.md) | `auto` с Claude Code v2.1.283 или новее; в более ранних версиях `auto` на планах Pro, Max, Ultra или Team в сессиях, которые [получают флаги функций](https://code.claude.com/docs/ru/env-vars.md#features-that-need-feature-flag-fetching), и `default` в остальных случаях |

84 84 

85Когда флаг, файл настроек или встроенное значение по умолчанию выбирает `auto`, но авторежим недоступен для сессии, Claude Code вместо этого запускает сессию в режиме Manual. Авторежим недоступен, когда сессия не соответствует [требованиям доступности](#eliminate-prompts-with-auto-mode), например если файл настроек отключает его или модель его не поддерживает, либо когда Anthropic временно отключила его на стороне сервера.85Когда флаг, файл настроек или встроенное значение по умолчанию выбирает `auto`, но авторежим недоступен для сессии, Claude Code вместо этого запускает сессию в режиме Manual. Авторежим недоступен, когда сессия не соответствует [требованиям доступности](#eliminate-prompts-with-auto-mode), например если файл настроек отключает его или модель его не поддерживает, либо когда Anthropic временно отключила его на стороне сервера.

86 86 

89* В терминале — один раз, в верхней части сессии89* В терминале — один раз, в верхней части сессии

90* В расширении VS Code — в виде карточки на экране нового диалога, которая остаётся, пока вы её не закроете90* В расширении VS Code — в виде карточки на экране нового диалога, которая остаётся, пока вы её не закроете

91 91 

92Если ваш `~/.claude/settings.json` устанавливает `defaultMode`, отличный от `auto`, и ни один другой файл настроек его не устанавливает, ваши сессии продолжают запускаться в этом режиме. На планах Pro, Max и Team, а также в сессиях, которые [не получают флаги функций](https://code.claude.com/docs/ru/env-vars.md#features-that-need-feature-flag-fetching), Claude Code один раз спрашивает в терминале или в расширении VS Code, следует ли изменить настройку на авторежим. Если вы откажетесь, ваша настройка останется без изменений.92Если ваш `~/.claude/settings.json` устанавливает `defaultMode`, отличный от `auto`, и ни один другой файл настроек его не устанавливает, ваши сессии продолжают запускаться в этом режиме.

93 

94На планах Pro, Max, Ultra и Team, а также в сессиях, которые [не получают флаги функций](https://code.claude.com/docs/ru/env-vars.md#features-that-need-feature-flag-fetching), Claude Code один раз спрашивает, следует ли изменить настройку на авторежим. Вопрос появляется в терминале или в расширении VS Code, и если вы откажетесь, ваша настройка останется без изменений.

93 95 

94### Вызовы инструментов отклоняются в запусках `claude -p` и Agent SDK96### Вызовы инструментов отклоняются в запусках `claude -p` и Agent SDK

95 97 

102 104 

103В этих примерах показан вариант с авторежимом для CLI и каждого SDK:105В этих примерах показан вариант с авторежимом для CLI и каждого SDK:

104 106 

105**CLI**107> [tab] CLI

106 108>

107```bash theme={null}109> ```bash theme={null}

108claude -p "Run the test suite and fix any failures" --permission-mode auto110> claude -p "Run the test suite and fix any failures" --permission-mode auto

109```111> ```

110 

111**TypeScript**

112 

113```typescript theme={null}

114const options = {

115 permissionMode: "auto"

116};

117```

118 

119**Python**

120 112 

121```python theme={null}113> [tab] TypeScript

122from claude_agent_sdk import ClaudeAgentOptions114>

115> ```typescript theme={null}

116> const options = {

117> permissionMode: "auto"

118> };

119> ```

123 120 

124options = ClaudeAgentOptions(permission_mode="auto")121> [tab] Python

125```122>

123> ```python theme={null}

124> from claude_agent_sdk import ClaudeAgentOptions

125>

126> options = ClaudeAgentOptions(permission_mode="auto")

127> ```

126 128 

127До v2.1.302 такие запуски могли начинаться в авторежиме, если они не [получали флаги функций](https://code.claude.com/docs/ru/env-vars.md#features-that-need-feature-flag-fetching), например при использовании [стороннего поставщика](https://code.claude.com/docs/ru/third-party-integrations.md) или с `DISABLE_TELEMETRY`.129До v2.1.302 такие запуски могли начинаться в авторежиме, если они не [получали флаги функций](https://code.claude.com/docs/ru/env-vars.md#features-that-need-feature-flag-fetching), например при использовании [стороннего поставщика](https://code.claude.com/docs/ru/third-party-integrations.md) или с `DISABLE_TELEMETRY`.

128 130 

166 168 

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

168 170 

169**CLI**171> [tab] CLI

170 172>

171**Во время сессии**: нажмите `Shift+Tab` для циклического переключения режимов разрешений. Из `auto` первое нажатие переключает на `default`, а затем цикл идёт `default` → `acceptEdits` → `plan`. Дополнительные режимы вставляются после `plan`. Строка состояния показывает активный режим как серый `⏸ manual mode on` для `default`, или как `⏵⏵ accept edits on`, `⏸ plan mode on`, `⏵⏵ auto mode on`, `⏵⏵ don't ask on` или `⏵⏵ bypass permissions on`.173> **Во время сессии**: нажмите `Shift+Tab` для циклического переключения режимов разрешений. Из `auto` первое нажатие переключает на `default`, а затем цикл идёт `default` → `acceptEdits` → `plan`. Дополнительные режимы вставляются после `plan`. Строка состояния показывает активный режим как серый `⏸ manual mode on` для `default`, или как `⏵⏵ accept edits on`, `⏸ plan mode on`, `⏵⏵ auto mode on`, `⏵⏵ don't ask on` или `⏵⏵ bypass permissions on`.

172 174>

173Следите за строкой состояния в этом ролике сессии, которая началась в авторежиме. При каждом нажатии `Shift+Tab` она меняется с `auto mode on` на `manual mode on`, `accept edits on`, `plan mode on` и обратно на `auto mode on`.175> Следите за строкой состояния в этом ролике сессии, которая началась в авторежиме. При каждом нажатии `Shift+Tab` она меняется с `auto mode on` на `manual mode on`, `accept edits on`, `plan mode on` и обратно на `auto mode on`.

174 176>

175<video autoPlay muted loop playsInline src="https://mintcdn.com/claude-code/tA-x-5L2YsYSVdee/images/permission-modes-cycle-light.mp4?fit=max&auto=format&n=tA-x-5L2YsYSVdee&q=85&s=3927dd62d59b01efd81b3578f2a6f971" aria-label="Строка состояния под промптом Claude Code меняется при каждом нажатии Shift+Tab: auto mode on, manual mode on, accept edits on, plan mode on, затем снова auto mode on." />177> <video autoPlay muted loop playsInline src="https://mintcdn.com/claude-code/tA-x-5L2YsYSVdee/images/permission-modes-cycle-light.mp4?fit=max&auto=format&n=tA-x-5L2YsYSVdee&q=85&s=3927dd62d59b01efd81b3578f2a6f971" aria-label="Строка состояния под промптом Claude Code меняется при каждом нажатии Shift+Tab: auto mode on, manual mode on, accept edits on, plan mode on, затем снова auto mode on." />

176 178>

177Не все режимы находятся в цикле по умолчанию:179> Не все режимы находятся в цикле по умолчанию:

178 180>

179* `auto`: появляется, когда [режим auto доступен](#eliminate-prompts-with-auto-mode); циклическое переключение на него переключает режимы без подтверждающего запроса181> * `auto`: появляется, когда [режим auto доступен](#eliminate-prompts-with-auto-mode); циклическое переключение на него переключает режимы без подтверждающего запроса

180* `bypassPermissions`: появляется после запуска с `--permission-mode bypassPermissions`, `--dangerously-skip-permissions`, `--allow-dangerously-skip-permissions` или `permissions.defaultMode: "bypassPermissions"` в [пользовательских, `--settings` или управляемых параметрах](https://code.claude.com/docs/ru/settings-reference#permissions-defaultmode). Вариант `--allow-` добавляет режим разрешений в цикл без активации182> * `bypassPermissions`: появляется после запуска с `--permission-mode bypassPermissions`, `--dangerously-skip-permissions`, `--allow-dangerously-skip-permissions` или `permissions.defaultMode: "bypassPermissions"` в [пользовательских, `--settings` или управляемых параметрах](https://code.claude.com/docs/ru/settings-reference#permissions-defaultmode). Вариант `--allow-` добавляет режим разрешений в цикл без активации

181* `dontAsk`: никогда не появляется в цикле; установите его с помощью `--permission-mode dontAsk`183> * `dontAsk`: никогда не появляется в цикле; установите его с помощью `--permission-mode dontAsk`

182 184>

183Включённые дополнительные режимы вставляются после `plan`, с `bypassPermissions` первым и `auto` последним. Если у вас включены оба, вы будете циклически переключаться через `bypassPermissions` на пути к `auto`.185> Включённые дополнительные режимы вставляются после `plan`, с `bypassPermissions` первым и `auto` последним. Если у вас включены оба, вы будете циклически переключаться через `bypassPermissions` на пути к `auto`.

184 186>

185**Из запроса разрешения Bash**: в режимах разрешений Manual и `acceptEdits`, когда [режим auto](#eliminate-prompts-with-auto-mode) доступен, Claude Code добавляет **Да, и переключиться на режим auto** к запросу разрешения команды Bash. Выберите его, чтобы одобрить команду и переключить сеанс на режим auto. Запросы инструмента [PowerShell](https://code.claude.com/docs/ru/tools-reference.md#powershell-tool) не предлагают опцию. Требует Claude Code v2.1.247 или позже.187> **Из запроса разрешения Bash**: в режимах разрешений Manual и `acceptEdits`, когда [режим auto](#eliminate-prompts-with-auto-mode) доступен, Claude Code добавляет **Да, и переключиться на режим auto** к запросу разрешения команды Bash. Выберите его, чтобы одобрить команду и переключить сеанс на режим auto. Запросы инструмента [PowerShell](https://code.claude.com/docs/ru/tools-reference.md#powershell-tool) не предлагают опцию. Требует Claude Code v2.1.247 или позже.

186 188>

187Claude Code не добавляет опцию к запросам, вынужденным одним из ваших [правил `ask`](https://code.claude.com/docs/ru/permissions#manage-permissions) или [hook](https://code.claude.com/docs/ru/hooks.md#pretooluse-decision-control), потому что режим auto по-прежнему показывает вам эти запросы, поэтому переключение их не удалит.189> Claude Code не добавляет опцию к запросам, вынужденным одним из ваших [правил `ask`](https://code.claude.com/docs/ru/permissions#manage-permissions) или [hook](https://code.claude.com/docs/ru/hooks.md#pretooluse-decision-control), потому что режим auto по-прежнему показывает вам эти запросы, поэтому переключение их не удалит.

188 190>

189**При запуске**: передайте режим разрешений как флаг.191> **При запуске**: передайте режим разрешений как флаг.

190 192>

191```bash theme={null}193> ```bash theme={null}

192claude --permission-mode plan194> claude --permission-mode plan

193```195> ```

194 196>

195**Как значение по умолчанию**: установите `permissions.defaultMode` в область, которую вы хотите, как описано в [Начните в другом режиме разрешений](#start-in-a-different-mode).197> **Как значение по умолчанию**: установите `permissions.defaultMode` в область, которую вы хотите, как описано в [Начните в другом режиме разрешений](#start-in-a-different-mode).

196 198>

197Тот же флаг `--permission-mode` работает с `-p` для [неинтерактивных запусков](https://code.claude.com/docs/ru/headless.md).199> Тот же флаг `--permission-mode` работает с `-p` для [неинтерактивных запусков](https://code.claude.com/docs/ru/headless.md).

198 

199**VS Code**

200 

201**Во время сеанса**: нажмите индикатор режима в нижней части поля подсказки. Он использует эти метки для режимов на этой странице:

202 

203| Метка пользовательского интерфейса | Режим |

204| :- | :- |

205| Manual | `default` |

206| Edit automatically | `acceptEdits` |

207| Plan | `plan` |

208| Auto | `auto` |

209| Bypass permissions | `bypassPermissions` |

210 

211**Как значение по умолчанию**: чтобы закрепить режим разрешений, в котором начинаются разговоры, установите `claudeCode.initialPermissionMode` в параметры пользователя VS Code на `default`, `manual`, `acceptEdits`, `plan` или `bypassPermissions`. Параметр не принимает `auto`; чтобы начать в режиме Auto, оставьте его неустановленным и выберите **Auto** из индикатора режима один раз, как описано в пункте 2 ниже. Расширение запускает каждый новый разговор в первом из них, который применяется:

212 

2131. `claudeCode.initialPermissionMode`

2142. Режим, который вы последний раз выбрали из индикатора режима, если это был Manual, Edit automatically или Auto. Выбор Plan или Bypass permissions применяется только к этому разговору

2153. `permissions.defaultMode` из [управляемых параметров](https://code.claude.com/docs/ru/managed-settings.md) или `~/.claude/settings.json`

2164. [Встроенное значение по умолчанию](#which-mode-a-session-starts-in) для вашего плана, поставщика и параметров организации

217 

218Расширение никогда не читает `.claude/settings.json` или `.claude/settings.local.json` проекта для начального режима разрешений. Когда установлен `claudeCode.claudeProcessWrapper`, пункты 3 и 4 не применяются: эти разговоры начинаются в режиме Manual, если пункт 1 или пункт 2 не устанавливает режим разрешений.

219 

220До v2.1.283 пункт 3 применялся только на планах Pro, Max и Team в сеансах, которые [получают флаги функций](https://code.claude.com/docs/ru/env-vars.md#features-that-need-feature-flag-fetching).

221 

222Auto появляется в индикаторе режима, когда [режим auto доступен](#eliminate-prompts-with-auto-mode).

223 

224Bypass permissions требует переключателя **Allow dangerously skip permissions** в параметрах расширения. Без него режим разрешений не появляется в индикаторе, и значение `bypassPermissions` из пункта 1 или пункта 3 запускает разговор в режиме Manual вместо этого. Auto из любого пункта аналогично запускает разговор в режиме Manual, когда режим auto недоступен.

225 

226Подробности, специфичные для расширения, см. в [руководстве VS Code](https://code.claude.com/docs/ru/vs-code.md).

227 

228**JetBrains**

229 

230Плагин JetBrains запускает Claude Code в терминале IDE, поэтому переключение режимов разрешений работает так же, как в CLI: нажмите `Shift+Tab` для циклического переключения или передайте `--permission-mode` при запуске.

231 

232**Desktop**

233 

234**Во время сессии**: на вкладке Code используйте селектор режима в строке под полем промпта. Не все режимы появляются в селекторе:

235 

236* **Auto**: появляется, когда [режим auto доступен](#eliminate-prompts-with-auto-mode)

237* **Bypass permissions**: требует переключателя **Allow bypass permissions mode** в параметрах Desktop на планах Pro и Max; на планах Team и Enterprise политика организации контролирует это вместо этого

238 

239Cowork не использует эти режимы. У него есть собственные режимы разрешений, которые включаются отдельно, и он вообще не показывает переключатель режимов, пока для вашей учётной записи не будет включён какой-либо режим помимо режима по умолчанию. См. [документацию Cowork](https://claude.com/docs/cowork/overview).

240 

241Для деталей, специфичных для desktop, см. [Выбор режима разрешений](https://code.claude.com/docs/ru/desktop.md#choose-a-permission-mode) в руководстве Desktop.

242 

243**Как значение по умолчанию**: установите `defaultMode` в [параметры](https://code.claude.com/docs/ru/settings.md#where-settings-live). Приложение desktop читает те же файлы параметров, что и CLI, и применяет режим разрешений к новым локальным сеансам.

244 

245Режим, который вы выбираете в селекторе режима, запоминается для каждой папки и имеет приоритет над `defaultMode` для этой папки. Plan является исключением: его выбор применяется только к текущему сеансу.

246 

247О том, куда помещается `defaultMode` в файле настроек, см. пример в [Начните в другом режиме разрешений](#start-in-a-different-mode).

248 

249**Web and mobile**

250 200 

251На [claude.ai/code](https://claude.ai/code) используйте раскрывающееся меню режима в строке под полем промпта. В мобильном приложении нажмите кнопку **+** в поле промпта, затем **Permission**. Облачные сессии и сессии Remote Control предлагают разные режимы разрешений:201> [tab] VS Code

202>

203> **Во время сеанса**: нажмите индикатор режима в нижней части поля подсказки. Он использует эти метки для режимов на этой странице:

204>

205> | Метка пользовательского интерфейса | Режим |

206> | :- | :- |

207> | Manual | `default` |

208> | Edit automatically | `acceptEdits` |

209> | Plan | `plan` |

210> | Auto | `auto` |

211> | Bypass permissions | `bypassPermissions` |

212>

213> **Как значение по умолчанию**: чтобы закрепить режим разрешений, в котором начинаются разговоры, установите `claudeCode.initialPermissionMode` в параметры пользователя VS Code на `default`, `manual`, `acceptEdits`, `plan` или `bypassPermissions`. Параметр не принимает `auto`; чтобы начать в режиме Auto, оставьте его неустановленным и выберите **Auto** из индикатора режима один раз, как описано в пункте 2 ниже. Расширение запускает каждый новый разговор в первом из них, который применяется:

214>

215> 1. `claudeCode.initialPermissionMode`

216> 2. Режим, который вы последний раз выбрали из индикатора режима, если это был Manual, Edit automatically или Auto. Выбор Plan или Bypass permissions применяется только к этому разговору

217> 3. `permissions.defaultMode` из [управляемых параметров](https://code.claude.com/docs/ru/managed-settings.md) или `~/.claude/settings.json`

218> 4. [Встроенное значение по умолчанию](#which-mode-a-session-starts-in) для вашего плана, поставщика и параметров организации

219>

220> Расширение никогда не читает `.claude/settings.json` или `.claude/settings.local.json` проекта для начального режима разрешений. Когда установлен `claudeCode.claudeProcessWrapper`, пункты 3 и 4 не применяются: эти разговоры начинаются в режиме Manual, если пункт 1 или пункт 2 не устанавливает режим разрешений.

221>

222> До v2.1.283 пункт 3 применялся только на планах Pro, Max, Ultra и Team в сессиях, которые [получают флаги функций](https://code.claude.com/docs/ru/env-vars.md#features-that-need-feature-flag-fetching).

223>

224> Auto появляется в индикаторе режима, когда [режим auto доступен](#eliminate-prompts-with-auto-mode).

225>

226> Bypass permissions требует переключателя **Allow dangerously skip permissions** в параметрах расширения. Без него режим разрешений не появляется в индикаторе, и значение `bypassPermissions` из пункта 1 или пункта 3 запускает разговор в режиме Manual вместо этого. Auto из любого пункта аналогично запускает разговор в режиме Manual, когда режим auto недоступен.

227>

228> Подробности, специфичные для расширения, см. в [руководстве VS Code](https://code.claude.com/docs/ru/vs-code.md).

252 229 

253* **[Облачные сессии](https://code.claude.com/docs/ru/claude-code-on-the-web.md)**: Accept edits, Plan и Auto. Accept edits соответствует режиму `default`: облачные сессии заранее разрешают редактирование файлов независимо от режима, поэтому раскрывающееся меню показывает Accept edits вместо Manual. Облачные сессии по-прежнему соблюдают `defaultMode: "acceptEdits"` из настроек. Авторежим появляется, только когда ваша организация это разрешает и выбранная модель это поддерживает. Bypass permissions недоступен.230> [tab] JetBrains

254* **Сессии [Remote Control](https://code.claude.com/docs/ru/remote-control.md)** на вашем локальном компьютере: Manual, Accept edits, Plan и Auto для сессии, которую вы запустили сами, и вы не можете выбрать Bypass permissions из приложения. Чтобы использовать Auto, сессия должна соответствовать [требованиям доступности](#eliminate-prompts-with-auto-mode) авторежима. Для потока проекта, работающего на вашем компьютере, см. [Запустить поток на вашем собственном компьютере](https://code.claude.com/docs/ru/claude-projects.md#run-a-thread-on-your-own-computer).231>

255 * За исключением Bypass permissions, раскрывающееся меню показывает режим разрешений, в котором находится локальная сессия, включая режим, установленный из терминала. Оно обновляется, когда режим разрешений изменяется в приложении или в терминале.232> Плагин JetBrains запускает Claude Code в терминале IDE, поэтому переключение режимов разрешений работает так же, как в CLI: нажмите `Shift+Tab` для циклического переключения или передайте `--permission-mode` при запуске.

256 * Сессии, размещённые [настольным приложением](https://code.claude.com/docs/ru/desktop.md) или [расширением VS Code](https://code.claude.com/docs/ru/vs-code.md), сообщают изменения режима разрешений в claude.ai по мере их возникновения, так же как сессии, размещённые в терминале.

257 233 

258Для Remote Control локальная машина, запускающая сеанс, должна быть подписана с вашей учётной записью claude.ai; ключи API не поддерживаются. Вы также можете установить начальный режим разрешений при запуске этого локального сеанса:234> [tab] Desktop

235>

236> **Во время сессии**: на вкладке Code используйте селектор режима в строке под полем промпта. Не все режимы появляются в селекторе:

237>

238> * **Auto**: появляется, когда [режим auto доступен](#eliminate-prompts-with-auto-mode)

239> * **Bypass permissions**: требует переключателя **Allow bypass permissions mode** в настройках Desktop на планах Pro, Max и Ultra; на планах Team и Enterprise это вместо этого контролирует политика организации

240>

241> Cowork не использует эти режимы. У него есть собственные режимы разрешений, которые включаются отдельно, и он вообще не показывает переключатель режимов, пока для вашей учётной записи не будет включён какой-либо режим помимо режима по умолчанию. См. [документацию Cowork](https://claude.com/docs/cowork/overview).

242>

243> Для деталей, специфичных для desktop, см. [Выбор режима разрешений](https://code.claude.com/docs/ru/desktop.md#choose-a-permission-mode) в руководстве Desktop.

244>

245> **Как значение по умолчанию**: установите `defaultMode` в [параметры](https://code.claude.com/docs/ru/settings.md#where-settings-live). Приложение desktop читает те же файлы параметров, что и CLI, и применяет режим разрешений к новым локальным сеансам.

246>

247> Режим, который вы выбираете в селекторе режима, запоминается для каждой папки и имеет приоритет над `defaultMode` для этой папки. Plan является исключением: его выбор применяется только к текущему сеансу.

248>

249> О том, куда помещается `defaultMode` в файле настроек, см. пример в [Начните в другом режиме разрешений](#start-in-a-different-mode).

259 250 

260```bash theme={null}251> [tab] Web and mobile

261claude remote-control --permission-mode acceptEdits252>

262```253> На [claude.ai/code](https://claude.ai/code) используйте раскрывающееся меню режима в строке под полем промпта. В мобильном приложении нажмите кнопку **+** в поле промпта, затем **Permission**. Облачные сессии и сессии Remote Control предлагают разные режимы разрешений:

254>

255> * **[Облачные сессии](https://code.claude.com/docs/ru/claude-code-on-the-web.md)**: Accept edits, Plan и Auto. Accept edits соответствует режиму `default`: облачные сессии заранее разрешают редактирование файлов независимо от режима, поэтому раскрывающееся меню показывает Accept edits вместо Manual. Облачные сессии по-прежнему соблюдают `defaultMode: "acceptEdits"` из настроек. Авторежим появляется, только когда ваша организация это разрешает и выбранная модель это поддерживает. Bypass permissions недоступен.

256> * **Сессии [Remote Control](https://code.claude.com/docs/ru/remote-control.md)** на вашем локальном компьютере: Manual, Accept edits, Plan и Auto для сессии, которую вы запустили сами, и вы не можете выбрать Bypass permissions из приложения. Чтобы использовать Auto, сессия должна соответствовать [требованиям доступности](#eliminate-prompts-with-auto-mode) авторежима. Для потока проекта, работающего на вашем компьютере, см. [Запустить поток на вашем собственном компьютере](https://code.claude.com/docs/ru/claude-projects.md#run-a-thread-on-your-own-computer).

257> * За исключением Bypass permissions, раскрывающееся меню показывает режим разрешений, в котором находится локальная сессия, включая режим, установленный из терминала. Оно обновляется, когда режим разрешений изменяется в приложении или в терминале.

258> * Сессии, размещённые [настольным приложением](https://code.claude.com/docs/ru/desktop.md) или [расширением VS Code](https://code.claude.com/docs/ru/vs-code.md), сообщают изменения режима разрешений в claude.ai по мере их возникновения, так же как сессии, размещённые в терминале.

259>

260> Для Remote Control локальная машина, запускающая сеанс, должна быть подписана с вашей учётной записью claude.ai; ключи API не поддерживаются. Вы также можете установить начальный режим разрешений при запуске этого локального сеанса:

261>

262> ```bash theme={null}

263> claude remote-control --permission-mode acceptEdits

264> ```

263 265 

264## Автоматическое одобрение редактирования файлов с режимом acceptEdits266## Автоматическое одобрение редактирования файлов с режимом acceptEdits

265 267 

327 329 

328Авторежим позволяет Claude выполнять действия без рутинных запросов разрешений. Отдельная модель-классификатор проверяет действия перед их выполнением и блокирует всё, что выходит за рамки вашего запроса, нацелено на нераспознанную инфраструктуру или выглядит как результат враждебного контента, который прочитал Claude. Явные [правила ask](https://code.claude.com/docs/ru/permissions.md#manage-permissions) по-прежнему вызывают запрос разрешения.330Авторежим позволяет Claude выполнять действия без рутинных запросов разрешений. Отдельная модель-классификатор проверяет действия перед их выполнением и блокирует всё, что выходит за рамки вашего запроса, нацелено на нераспознанную инфраструктуру или выглядит как результат враждебного контента, который прочитал Claude. Явные [правила ask](https://code.claude.com/docs/ru/permissions.md#manage-permissions) по-прежнему вызывают запрос разрешения.

329 331 

330В Claude Code v2.1.283 и более поздних версиях авторежим является [встроенным начальным режимом разрешений](#which-mode-a-session-starts-in) для интерактивных сессий в терминале и VS Code на всех планах и у всех провайдеров. В более ранних версиях он является встроенным начальным режимом разрешений только на планах Pro, Max и Team.332В Claude Code v2.1.283 и более поздних версиях авторежим является [встроенным начальным режимом разрешений](#which-mode-a-session-starts-in) для интерактивных сессий в терминале и VS Code на всех планах и у всех провайдеров. В более ранних версиях он является встроенным начальным режимом разрешений только на планах Pro, Max, Ultra и Team.

331 333 

332Классификатор также проверяет каждое сообщение, которое Claude отправляет другому агенту с помощью [`SendMessage`](https://code.claude.com/docs/ru/tools-reference), будь то простой текст или структурированное сообщение [команды агентов](https://code.claude.com/docs/ru/agent-teams.md), перед тем как Claude Code его доставит, как в авторежиме, так и в [режиме планирования, когда классификатор проверяет команды](#analyze-before-you-edit-with-plan-mode); проверка отправки требует Claude Code v2.1.222 или более поздней версии.334Классификатор также проверяет каждое сообщение, которое Claude отправляет другому агенту с помощью [`SendMessage`](https://code.claude.com/docs/ru/tools-reference), будь то простой текст или структурированное сообщение [команды агентов](https://code.claude.com/docs/ru/agent-teams.md), перед тем как Claude Code его доставит, как в авторежиме, так и в [режиме планирования, когда классификатор проверяет команды](#analyze-before-you-edit-with-plan-mode); проверка отправки требует Claude Code v2.1.222 или более поздней версии.

333 335 

367 369 

368В авторежиме Claude Code может попросить сервер проверить действия, которые [порядок принятия решений](#how-the-classifier-evaluates-actions) отправляет на проверку, в составе запросов к модели в рамках сессии, вместо отправки собственных запросов классификатора. Сервер запрашивают следующие сессии:370В авторежиме Claude Code может попросить сервер проверить действия, которые [порядок принятия решений](#how-the-classifier-evaluates-actions) отправляет на проверку, в составе запросов к модели в рамках сессии, вместо отправки собственных запросов классификатора. Сервер запрашивают следующие сессии:

369 371 

370* **Прямое подключение к Anthropic API**: в интерактивных сессиях в терминале, а также в сессиях `-p`, Agent SDK, [расширения VS Code](https://code.claude.com/docs/ru/vs-code.md) и [десктопного приложения](https://code.claude.com/docs/ru/desktop.md), независимо от вашего плана или типа учётной записи, по мере развёртывания функции Anthropic. В интерактивных сессиях в терминале требуется Claude Code v2.1.271 или новее на планах Pro, Max и Team и v2.1.278 или новее на планах Enterprise и в учётных записях Claude API. В сессиях `-p`, Agent SDK, расширения VS Code и десктопного приложения требуется Claude Code v2.1.281 или новее. Начиная с v2.1.282 сессия, которая [не получает флаги функций](https://code.claude.com/docs/ru/env-vars.md#features-that-need-feature-flag-fetching), например потому что вы отключили телеметрию, по умолчанию запрашивает сервер в сессии любого типа.372* **Прямое подключение к Anthropic API**: в интерактивных сессиях в терминале, а также в сессиях `-p`, Agent SDK, [расширения VS Code](https://code.claude.com/docs/ru/vs-code.md) и [десктопного приложения](https://code.claude.com/docs/ru/desktop.md), независимо от вашего плана или типа учётной записи, по мере развёртывания функции Anthropic. Сверьте тип своей сессии со следующими минимальными версиями Claude Code:

373 * В интерактивных сессиях в терминале запрос к серверу требует Claude Code v2.1.271 или новее на планах Pro, Max, Ultra и Team. На планах Enterprise и в учётных записях Claude API такие сессии требуют v2.1.278 или новее.

374 * В сессиях `-p`, Agent SDK, расширения VS Code и десктопного приложения запрос к серверу требует Claude Code v2.1.281 или новее

375 * Начиная с v2.1.282 сессия, которая [не получает флаги функций](https://code.claude.com/docs/ru/env-vars.md#features-that-need-feature-flag-fetching), например потому что вы отключили телеметрию, по умолчанию запрашивает сервер в сессии любого типа

371* **Облачный провайдер либо LLM-шлюз или прокси**: в [Claude Platform on AWS](https://code.claude.com/docs/ru/claude-platform-on-aws.md), Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, а также всякий раз, когда вы направляете `ANTHROPIC_BASE_URL` на [LLM-шлюз или прокси](https://code.claude.com/docs/ru/llm-gateway), независимо от вашего плана. Запрос к серверу по умолчанию требует Claude Code v2.1.278 или новее.376* **Облачный провайдер либо LLM-шлюз или прокси**: в [Claude Platform on AWS](https://code.claude.com/docs/ru/claude-platform-on-aws.md), Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, а также всякий раз, когда вы направляете `ANTHROPIC_BASE_URL` на [LLM-шлюз или прокси](https://code.claude.com/docs/ru/llm-gateway), независимо от вашего плана. Запрос к серверу по умолчанию требует Claude Code v2.1.278 или новее.

372* **Сессия [Claude apps gateway](https://code.claude.com/docs/ru/claude-apps-gateway) с выполненным входом**: требуется Claude Code v2.1.280 или новее377* **Сессия [Claude apps gateway](https://code.claude.com/docs/ru/claude-apps-gateway) с выполненным входом**: требуется Claude Code v2.1.280 или новее

373* **[Облачная сессия](https://code.claude.com/docs/ru/claude-code-on-the-web.md) в среде, размещённой Anthropic**: независимо от вашего плана, когда вы запускаете её из веба, мобильного приложения или десктопного приложения с выбранным вариантом **Cloud**. Сессии, запущенные [облачной запланированной задачей](https://code.claude.com/docs/ru/routines.md), запрашивают сервер по мере развёртывания функции Anthropic.378* **[Облачная сессия](https://code.claude.com/docs/ru/claude-code-on-the-web.md) в среде, размещённой Anthropic**: независимо от вашего плана, когда вы запускаете её из веба, мобильного приложения или десктопного приложения с выбранным вариантом **Cloud**. Сессии, запущенные [облачной запланированной задачей](https://code.claude.com/docs/ru/routines.md), запрашивают сервер по мере развёртывания функции Anthropic.

566 571 

567В следующих разделах описаны порядок, в котором Claude Code оценивает действие, то, как классификатор проверяет работу субагентов, и то, какие затраты и задержку добавляют вызовы классификатора.572В следующих разделах описаны порядок, в котором Claude Code оценивает действие, то, как классификатор проверяет работу субагентов, и то, какие затраты и задержку добавляют вызовы классификатора.

568 573 

569> **Как классификатор оценивает действия**574> [accordion] Как классификатор оценивает действия

570>575>

571> Каждое действие проходит через фиксированный порядок принятия решений. Срабатывает первый подходящий шаг:576> Каждое действие проходит через фиксированный порядок принятия решений. Срабатывает первый подходящий шаг:

572>577>

608>613>

609> Отдельный зонд на стороне сервера сканирует входящие результаты инструментов и помечает подозрительный контент до того, как Claude его прочитает. Подробнее о том, как эти уровни работают вместе, см. в [анонсе авторежима](https://claude.com/blog/auto-mode) и [подробном инженерном разборе](https://www.anthropic.com/engineering/claude-code-auto-mode).614> Отдельный зонд на стороне сервера сканирует входящие результаты инструментов и помечает подозрительный контент до того, как Claude его прочитает. Подробнее о том, как эти уровни работают вместе, см. в [анонсе авторежима](https://claude.com/blog/auto-mode) и [подробном инженерном разборе](https://www.anthropic.com/engineering/claude-code-auto-mode).

610 615 

611> **Как авторежим обрабатывает субагентов**616> [accordion] Как авторежим обрабатывает субагентов

612>617>

613> Классификатор проверяет работу [субагентов](https://code.claude.com/docs/ru/sub-agents.md) в трёх точках:618> Классификатор проверяет работу [субагентов](https://code.claude.com/docs/ru/sub-agents.md) в трёх точках:

614>619>

616> 2. Во время работы субагента каждое его действие проходит через тот же [порядок принятия решений](#how-the-classifier-evaluates-actions), что и в родительской сессии, с теми же правилами блокировки и разрешения. Любой `permissionMode` во frontmatter субагента игнорируется.621> 2. Во время работы субагента каждое его действие проходит через тот же [порядок принятия решений](#how-the-classifier-evaluates-actions), что и в родительской сессии, с теми же правилами блокировки и разрешения. Любой `permissionMode` во frontmatter субагента игнорируется.

617> 3. Когда субагент завершает работу, классификатор проверяет его работу и итоговый отчёт до того, как родитель прочитает отчёт. Если классификатор помечает работу или отчёт субагента либо отдельная проверка безопасности API отклоняет проверку, отчёт всё равно доставляется, но с предупреждением о безопасности в начале. Если классификатор недоступен для проверки, отчёт приходит с примечанием о том, что работу субагента нужно проверить, прежде чем на неё опираться.622> 3. Когда субагент завершает работу, классификатор проверяет его работу и итоговый отчёт до того, как родитель прочитает отчёт. Если классификатор помечает работу или отчёт субагента либо отдельная проверка безопасности API отклоняет проверку, отчёт всё равно доставляется, но с предупреждением о безопасности в начале. Если классификатор недоступен для проверки, отчёт приходит с примечанием о том, что работу субагента нужно проверить, прежде чем на неё опираться.

618 623 

619> **Стоимость и задержка**624> [accordion] Стоимость и задержка

620>625>

621> Запросы классификатора, которые отправляет Claude Code, могут выполняться на модели, отличной от выбранной через `/model`. См. [на какой модели они выполняются](#default-classifier-model).626> Запросы классификатора, которые отправляет Claude Code, могут выполняться на модели, отличной от выбранной через `/model`. См. [на какой модели они выполняются](#default-classifier-model).

622>627>

964 969 

965Чтобы команды Bash `rm` и `rmdir`, нацеленные на [критические пути](#critical-paths), выполнялись без запроса в режиме `bypassPermissions`, запустите Claude Code с [`CLAUDE_CODE_EVEN_MORE_DANGEROUSLY_SKIP_PERMISSIONS=1`](https://code.claude.com/docs/ru/env-vars#variables) в его окружении. Для этого требуется Claude Code v2.1.311 или позже. Claude Code читает переменную только из окружения запуска и [игнорирует её в блоке `env` файла настроек](https://code.claude.com/docs/ru/settings-reference#variables-claude-code-ignores-in-env). Например, установите её в [вашей оболочке](https://code.claude.com/docs/ru/env-vars.md#set-variables-in-your-shell) и запустите `claude` оттуда:970Чтобы команды Bash `rm` и `rmdir`, нацеленные на [критические пути](#critical-paths), выполнялись без запроса в режиме `bypassPermissions`, запустите Claude Code с [`CLAUDE_CODE_EVEN_MORE_DANGEROUSLY_SKIP_PERMISSIONS=1`](https://code.claude.com/docs/ru/env-vars#variables) в его окружении. Для этого требуется Claude Code v2.1.311 или позже. Claude Code читает переменную только из окружения запуска и [игнорирует её в блоке `env` файла настроек](https://code.claude.com/docs/ru/settings-reference#variables-claude-code-ignores-in-env). Например, установите её в [вашей оболочке](https://code.claude.com/docs/ru/env-vars.md#set-variables-in-your-shell) и запустите `claude` оттуда:

966 971 

967**macOS, Linux, WSL**972> [tab] macOS, Linux, WSL

968 973>

969```bash theme={null}974> ```bash theme={null}

970export CLAUDE_CODE_EVEN_MORE_DANGEROUSLY_SKIP_PERMISSIONS=1975> export CLAUDE_CODE_EVEN_MORE_DANGEROUSLY_SKIP_PERMISSIONS=1

971claude --permission-mode bypassPermissions976> claude --permission-mode bypassPermissions

972```977> ```

973 

974**Windows PowerShell**

975 

976```powershell theme={null}

977$env:CLAUDE_CODE_EVEN_MORE_DANGEROUSLY_SKIP_PERMISSIONS = "1"

978claude --permission-mode bypassPermissions

979```

980 978 

981**Windows CMD**979> [tab] Windows PowerShell

980>

981> ```powershell theme={null}

982> $env:CLAUDE_CODE_EVEN_MORE_DANGEROUSLY_SKIP_PERMISSIONS = "1"

983> claude --permission-mode bypassPermissions

984> ```

982 985 

983```batch theme={null}986> [tab] Windows CMD

984set CLAUDE_CODE_EVEN_MORE_DANGEROUSLY_SKIP_PERMISSIONS=1987>

985claude --permission-mode bypassPermissions988> ```batch theme={null}

986```989> set CLAUDE_CODE_EVEN_MORE_DANGEROUSLY_SKIP_PERMISSIONS=1

990> claude --permission-mode bypassPermissions

991> ```

987 992 

988> [!WARNING]993> [!WARNING]

989>994>

platforms.md +6 −6

Details

14 14 

15| Платформа | Лучше всего для | Что вы получаете |15| Платформа | Лучше всего для | Что вы получаете |

16| :- | :- | :- |16| :- | :- | :- |

17| [CLI](https://code.claude.com/docs/ru/quickstart.md) | Рабочие процессы терминала, скриптинг, удалённые серверы | Полный набор функций, [Agent SDK](https://code.claude.com/docs/ru/headless.md), [использование компьютера](https://code.claude.com/docs/ru/computer-use.md) на macOS (Pro и Max), сторонние поставщики |17| [CLI](https://code.claude.com/docs/ru/quickstart.md) | Рабочие процессы терминала, скриптинг, удалённые серверы | Полный набор функций, [Agent SDK](https://code.claude.com/docs/ru/headless.md), [использование компьютера](https://code.claude.com/docs/ru/computer-use.md) на macOS (Pro, Max и Ultra), сторонние поставщики |

18| [Desktop](https://code.claude.com/docs/ru/desktop.md) | Визуальный просмотр, параллельные сеансы, управляемая установка | Средство просмотра различий, предпросмотр приложения, [использование компьютера](https://code.claude.com/docs/ru/desktop.md#let-claude-use-your-computer) и [Dispatch](https://code.claude.com/docs/ru/desktop.md#sessions-from-dispatch) на Pro и Max |18| [Desktop](https://code.claude.com/docs/ru/desktop.md) | Визуальный просмотр, параллельные сессии, управляемая установка | Средство просмотра различий, предпросмотр приложения, [использование компьютера](https://code.claude.com/docs/ru/desktop.md#let-claude-use-your-computer) и [Dispatch](https://code.claude.com/docs/ru/desktop.md#sessions-from-dispatch) на Pro, Max и Ultra |

19| [VS Code](https://code.claude.com/docs/ru/vs-code.md) | Работа внутри VS Code без переключения на терминал | Встроенные различия, интегрированный терминал, контекст файла |19| [VS Code](https://code.claude.com/docs/ru/vs-code.md) | Работа внутри VS Code без переключения на терминал | Встроенные различия, интегрированный терминал, контекст файла |

20| [JetBrains](https://code.claude.com/docs/ru/jetbrains.md) | Работа внутри IntelliJ, PyCharm, WebStorm или других IDE JetBrains | Средство просмотра различий, совместное использование выделения, сеанс терминала |20| [JetBrains](https://code.claude.com/docs/ru/jetbrains.md) | Работа внутри IntelliJ, PyCharm, WebStorm или других IDE JetBrains | Средство просмотра различий, совместное использование выделения, сеанс терминала |

21| [Web](https://code.claude.com/docs/ru/claude-code-on-the-web.md) | Долгосрочные задачи, которые не требуют большого управления, или работа, которая должна продолжаться, когда вы не в сети | Облако, по умолчанию управляемое Anthropic; продолжается после отключения |21| [Web](https://code.claude.com/docs/ru/claude-code-on-the-web.md) | Долгосрочные задачи, которые не требуют большого управления, или работа, которая должна продолжаться, когда вы не в сети | Облако, по умолчанию управляемое Anthropic; продолжается после отключения |

22| [Mobile](https://code.claude.com/docs/ru/mobile.md) | Запуск и мониторинг задач вдали от вашего компьютера | Облачные сеансы из приложения Claude для iOS и Android, [Remote Control](https://code.claude.com/docs/ru/remote-control.md) для локальных сеансов, [Dispatch](https://code.claude.com/docs/ru/desktop.md#sessions-from-dispatch) на Desktop на Pro и Max |22| [Mobile](https://code.claude.com/docs/ru/mobile.md) | Запуск и мониторинг задач вдали от вашего компьютера | Облачные сессии из приложения Claude для iOS и Android, [Remote Control](https://code.claude.com/docs/ru/remote-control.md) для локальных сессий, [Dispatch](https://code.claude.com/docs/ru/desktop.md#sessions-from-dispatch) на Desktop на Pro, Max и Ultra |

23 23 

24CLI — это наиболее полная поверхность для работы, ориентированной на терминал: скриптинг и Agent SDK доступны только в CLI. Сторонние поставщики также работают в [VS Code](https://code.claude.com/docs/ru/vs-code.md#use-third-party-providers) и в [JetBrains](https://code.claude.com/docs/ru/feature-availability.md#features-available-on-every-provider), который запускает CLI в терминале вашей IDE. Корпоративные развёртывания [Desktop](https://code.claude.com/docs/ru/desktop.md) поддерживают Google Cloud's Agent Platform, и Desktop поддерживает [поставщиков шлюза](https://code.claude.com/docs/ru/llm-gateway-connect.md#desktop-app); для Amazon Bedrock или Microsoft Foundry используйте CLI или расширение IDE, или [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview), который запускает вкладку Code на этих поставщиках. Desktop и расширения IDE обменивают некоторые функции, доступные только в CLI, на визуальный просмотр и более тесную интеграцию с редактором. Веб работает в облаке, поэтому задачи продолжают выполняться после отключения. Mobile — это тонкий клиент для этих же облачных сеансов или для локального сеанса через Remote Control, и может отправлять задачи на Desktop с помощью Dispatch.24CLI — это наиболее полная поверхность для работы, ориентированной на терминал: скриптинг и Agent SDK доступны только в CLI. Сторонние поставщики также работают в [VS Code](https://code.claude.com/docs/ru/vs-code.md#use-third-party-providers) и в [JetBrains](https://code.claude.com/docs/ru/feature-availability.md#features-available-on-every-provider), который запускает CLI в терминале вашей IDE. Корпоративные развёртывания [Desktop](https://code.claude.com/docs/ru/desktop.md) поддерживают Google Cloud's Agent Platform, и Desktop поддерживает [поставщиков шлюза](https://code.claude.com/docs/ru/llm-gateway-connect.md#desktop-app); для Amazon Bedrock или Microsoft Foundry используйте CLI или расширение IDE, или [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview), который запускает вкладку Code на этих поставщиках. Desktop и расширения IDE обменивают некоторые функции, доступные только в CLI, на визуальный просмотр и более тесную интеграцию с редактором. Веб работает в облаке, поэтому задачи продолжают выполняться после отключения. Mobile — это тонкий клиент для этих же облачных сеансов или для локального сеанса через Remote Control, и может отправлять задачи на Desktop с помощью Dispatch.

25 25 

35| [GitHub Actions](https://code.claude.com/docs/ru/github-actions.md) | Запускает Claude в вашем конвейере CI | Автоматические проверки PR, сортировка проблем, запланированное обслуживание |35| [GitHub Actions](https://code.claude.com/docs/ru/github-actions.md) | Запускает Claude в вашем конвейере CI | Автоматические проверки PR, сортировка проблем, запланированное обслуживание |

36| [GitLab CI/CD](https://code.claude.com/docs/ru/gitlab-ci-cd.md) | То же самое, что GitHub Actions для GitLab | Автоматизация, управляемая CI на GitLab |36| [GitLab CI/CD](https://code.claude.com/docs/ru/gitlab-ci-cd.md) | То же самое, что GitHub Actions для GitLab | Автоматизация, управляемая CI на GitLab |

37| [Code Review](https://code.claude.com/docs/ru/code-review.md) | Автоматически проверяет каждый PR | Выявление ошибок перед проверкой человеком |37| [Code Review](https://code.claude.com/docs/ru/code-review.md) | Автоматически проверяет каждый PR | Выявление ошибок перед проверкой человеком |

38| [Slack](https://code.claude.com/docs/ru/slack.md) | Отвечает на упоминания `@Claude` в ваших каналах от имени вашей собственной учётной записи | Превращение отчётов об ошибках в pull requests из чата команды на планах Pro и Max |38| [Slack](https://code.claude.com/docs/ru/slack.md) | Отвечает на упоминания `@Claude` в ваших каналах от имени вашей собственной учётной записи | Превращение отчётов об ошибках в pull requests из чата команды на планах Pro, Max и Ultra |

39| [Claude Tag](https://claude.com/docs/claude-tag) | Запускает `@Claude` как общую идентификацию вашей организации с настроенным администратором доступом | Общий доступ команды на планах Team и Enterprise вместо сеансов Slack для каждого пользователя |39| [Claude Tag](https://claude.com/docs/claude-tag) | Запускает `@Claude` как общую идентификацию вашей организации с настроенным администратором доступом | Общий доступ команды на планах Team и Enterprise вместо сеансов Slack для каждого пользователя |

40 40 

41Для интеграций, не указанных здесь, [MCP серверы](https://code.claude.com/docs/ru/mcp.md) и [соединители](https://code.claude.com/docs/ru/desktop.md#connect-external-tools) позволяют подключить почти всё: Linear, Notion, Google Drive или ваши собственные внутренние API.41Для интеграций, не указанных здесь, [MCP серверы](https://code.claude.com/docs/ru/mcp.md) и [соединители](https://code.claude.com/docs/ru/desktop.md#connect-external-tools) позволяют подключить почти всё: Linear, Notion, Google Drive или ваши собственные внутренние API.

49| [Dispatch](https://code.claude.com/docs/ru/desktop.md#sessions-from-dispatch) | Отправьте задачу из мобильного приложения Claude | Ваша машина (Desktop) | [Свяжите мобильное приложение с Desktop](https://support.claude.com/en/articles/13947068) | Делегирование работы, когда вас нет, минимальная настройка |49| [Dispatch](https://code.claude.com/docs/ru/desktop.md#sessions-from-dispatch) | Отправьте задачу из мобильного приложения Claude | Ваша машина (Desktop) | [Свяжите мобильное приложение с Desktop](https://support.claude.com/en/articles/13947068) | Делегирование работы, когда вас нет, минимальная настройка |

50| [Remote Control](https://code.claude.com/docs/ru/remote-control.md) | Управляйте запущенной сессией из [claude.ai/code](https://claude.ai/code) или мобильного приложения Claude | Ваша машина (CLI, Desktop или VS Code) | Запустите [`claude remote-control` или `/remote-control`](https://code.claude.com/docs/ru/remote-control#start-a-remote-control-session) | Управление текущей работой с другого устройства |50| [Remote Control](https://code.claude.com/docs/ru/remote-control.md) | Управляйте запущенной сессией из [claude.ai/code](https://claude.ai/code) или мобильного приложения Claude | Ваша машина (CLI, Desktop или VS Code) | Запустите [`claude remote-control` или `/remote-control`](https://code.claude.com/docs/ru/remote-control#start-a-remote-control-session) | Управление текущей работой с другого устройства |

51| [Channels](https://code.claude.com/docs/ru/channels.md) | Отправляйте события из приложения чата, такого как Telegram или Discord, или с вашего собственного сервера | Ваша машина (CLI) | [Установите плагин канала](https://code.claude.com/docs/ru/channels.md#quickstart) или [создайте свой](https://code.claude.com/docs/ru/channels-reference.md) | Реагирование на внешние события, такие как сбои CI или сообщения в чате |51| [Channels](https://code.claude.com/docs/ru/channels.md) | Отправляйте события из приложения чата, такого как Telegram или Discord, или с вашего собственного сервера | Ваша машина (CLI) | [Установите плагин канала](https://code.claude.com/docs/ru/channels.md#quickstart) или [создайте свой](https://code.claude.com/docs/ru/channels-reference.md) | Реагирование на внешние события, такие как сбои CI или сообщения в чате |

52| [Slack](https://code.claude.com/docs/ru/slack.md) | Упомяните `@Claude` в канале команды | Облако Anthropic | [Установите приложение Slack](https://code.claude.com/docs/ru/slack.md#setting-up-claude-code-in-slack) с включенным [Claude Code в веб-версии](https://code.claude.com/docs/ru/claude-code-on-the-web.md), в планах Pro и Max | PR и рецензии из чата команды |52| [Slack](https://code.claude.com/docs/ru/slack.md) | Упомяните `@Claude` в канале команды | Облако Anthropic | [Установите приложение Slack](https://code.claude.com/docs/ru/slack.md#setting-up-claude-code-in-slack) с включенным [Claude Code в веб-версии](https://code.claude.com/docs/ru/claude-code-on-the-web.md), в планах Pro, Max и Ultra | PR и рецензии из чата команды |

53| [Self-hosted environments](https://code.claude.com/docs/ru/self-hosted-environments) | Запустите [облачную сессию](https://code.claude.com/docs/ru/claude-code-on-the-web.md) и выберите окружение вашей организации | Инфраструктура вашей организации | [Разверните runners](https://code.claude.com/docs/ru/self-hosted-environments-quickstart.md), в планах Team и Enterprise | Облачные сессии, которые должны работать внутри вашей сети |53| [Self-hosted environments](https://code.claude.com/docs/ru/self-hosted-environments) | Запустите [облачную сессию](https://code.claude.com/docs/ru/claude-code-on-the-web.md) и выберите окружение вашей организации | Инфраструктура вашей организации | [Разверните runners](https://code.claude.com/docs/ru/self-hosted-environments-quickstart.md), в планах Team и Enterprise | Облачные сессии, которые должны работать внутри вашей сети |

54| [Scheduled tasks](https://code.claude.com/docs/ru/scheduled-tasks.md) | Установите расписание | [CLI](https://code.claude.com/docs/ru/scheduled-tasks.md), [Desktop](https://code.claude.com/docs/ru/desktop-scheduled-tasks.md) или [облако](https://code.claude.com/docs/ru/routines.md) | Выберите частоту | Повторяющаяся автоматизация, такая как ежедневные проверки |54| [Scheduled tasks](https://code.claude.com/docs/ru/scheduled-tasks.md) | Установите расписание | [CLI](https://code.claude.com/docs/ru/scheduled-tasks.md), [Desktop](https://code.claude.com/docs/ru/desktop-scheduled-tasks.md) или [облако](https://code.claude.com/docs/ru/routines.md) | Выберите частоту | Повторяющаяся автоматизация, такая как ежедневные проверки |

55 55 

74* [GitHub Actions](https://code.claude.com/docs/ru/github-actions.md): запуск Claude в вашем конвейере CI74* [GitHub Actions](https://code.claude.com/docs/ru/github-actions.md): запуск Claude в вашем конвейере CI

75* [GitLab CI/CD](https://code.claude.com/docs/ru/gitlab-ci-cd.md): то же самое для GitLab75* [GitLab CI/CD](https://code.claude.com/docs/ru/gitlab-ci-cd.md): то же самое для GitLab

76* [Code Review](https://code.claude.com/docs/ru/code-review.md): автоматическая проверка при каждом pull request76* [Code Review](https://code.claude.com/docs/ru/code-review.md): автоматическая проверка при каждом pull request

77* [Slack](https://code.claude.com/docs/ru/slack.md): отправка задач из чата команды и получение PR обратно в планах Pro и Max77* [Slack](https://code.claude.com/docs/ru/slack.md): отправка задач из чата команды и получение PR обратно в планах Pro, Max и Ultra

78* [Claude Tag](https://claude.com/docs/claude-tag): запуск `@Claude` как общей идентификации вашей организации в планах Team и Enterprise78* [Claude Tag](https://claude.com/docs/claude-tag): запуск `@Claude` как общей идентификации вашей организации в планах Team и Enterprise

79 79 

80### Удалённый доступ80### Удалённый доступ

plugins/install.md +96 −96

Details

27 27 

28Выберите вкладку для того места, где вы запускаете Claude Code.28Выберите вкладку для того места, где вы запускаете Claude Code.

29 29 

30**Terminal**30> [tab] Terminal

31 31>

32Запустите Claude Code с помощью `claude` в вашем проекте, затем:32> Запустите Claude Code с помощью `claude` в вашем проекте, затем:

33 33>

34**1. Откройте детали плагина с помощью команды установки**34> **1. Откройте детали плагина с помощью команды установки**

35 35>

36Запустите `/plugin install` с именем плагина и маркетплейса. В сессии эта команда не устанавливает сразу: она открывает панель `/plugin` с деталями этого плагина, чтобы вы могли его просмотреть и сначала выбрать область.36> Запустите `/plugin install` с именем плагина и маркетплейса. В сессии эта команда не устанавливает сразу: она открывает панель `/plugin` с деталями этого плагина, чтобы вы могли его просмотреть и сначала выбрать область.

37 37>

38```text theme={null}38> ```text theme={null}

39/plugin install commit-commands@claude-plugins-official39> /plugin install commit-commands@claude-plugins-official

40```40> ```

41 41>

42Чтобы вместо этого просмотреть список, запустите `/plugin` без имени плагина: панель откроется на вкладке **Discover**, которая перечисляет плагины из ваших маркетплейсов, и вы можете вводить для поиска, затем нажать **Enter** на плагине, чтобы открыть его детали.42> Чтобы вместо этого просмотреть список, запустите `/plugin` без имени плагина: панель откроется на вкладке **Discover**, которая перечисляет плагины из ваших маркетплейсов, и вы можете вводить для поиска, затем нажать **Enter** на плагине, чтобы открыть его детали.

43 43>

44**2. Просмотрите, что добавляет плагин**44> **2. Просмотрите, что добавляет плагин**

45 45>

46Панель деталей показывает описание плагина. Она также может показывать:46> Панель деталей показывает описание плагина. Она также может показывать:

47 47>

48* **Will install**: команды, agents, skills, hooks и MCP и LSP серверы, которые добавляет плагин.48> * **Will install**: команды, agents, skills, hooks и MCP и LSP серверы, которые добавляет плагин.

49* **Last updated**: показывается для плагина в официальном маркетплейсе Anthropic.49> * **Last updated**: показывается для плагина в официальном маркетплейсе Anthropic.

50* **Context cost**: для плагина в официальном маркетплейсе Anthropic две оценки токенов. **Every turn** — это то, что плагин добавляет к каждому отправляемому вами сообщению, а **When invoked** — это то, что его skills и agents добавляют после того, как Claude их загружает. Оценки появляются, когда вы открываете плагин, назвав его маркетплейс, как это делает команда шага 1, или со вкладки **Marketplaces**. Панель деталей, которую вы достигаете из списка **Discover**, их не показывает.50> * **Context cost**: для плагина в официальном маркетплейсе Anthropic две оценки токенов. **Every turn** — это то, что плагин добавляет к каждому отправляемому вами сообщению, а **When invoked** — это то, что его skills и agents добавляют после того, как Claude их загружает. Оценки появляются, когда вы открываете плагин, назвав его маркетплейс, как это делает команда шага 1, или со вкладки **Marketplaces**. Панель деталей, которую вы достигаете из списка **Discover**, их не показывает.

51 51>

52Плагины из локального или пользовательского маркетплейса могут вместо этого показывать `Components will be discovered at installation`.52> Плагины из локального или пользовательского маркетплейса могут вместо этого показывать `Components will be discovered at installation`.

53 53>

54Плагин может запускать hooks и MCP серверы, поэтому прочитайте панель перед установкой. См. [Plugin security and trust](https://code.claude.com/docs/ru/plugins/security.md).54> Плагин может запускать hooks и MCP серверы, поэтому прочитайте панель перед установкой. См. [Plugin security and trust](https://code.claude.com/docs/ru/plugins/security.md).

55 55>

56**3. Выберите область**56> **3. Выберите область**

57 57>

58Выберите один из трёх вариантов установки:58> Выберите один из трёх вариантов установки:

59 59>

60* **Install for you (user scope)**: вы получаете плагин в каждом проекте на этой машине60> * **Install for you (user scope)**: вы получаете плагин в каждом проекте на этой машине

61* **Install for all collaborators on this repository (project scope)**: он включен для всех, кто работает в этом репозитории61> * **Install for all collaborators on this repository (project scope)**: он включен для всех, кто работает в этом репозитории

62* **Install for you, in this repo only (local scope)**: вы получаете его только в этом репозитории62> * **Install for you, in this repo only (local scope)**: вы получаете его только в этом репозитории

63 63>

64[Выберите область установки](#choose-an-install-scope) говорит, в какой файл настроек записывается каждый из них и какой применяется, когда один и тот же плагин установлен в нескольких местах.64> [Выберите область установки](#choose-an-install-scope) говорит, в какой файл настроек записывается каждый из них и какой применяется, когда один и тот же плагин установлен в нескольких местах.

65 65>

66После выбора области Claude Code устанавливает плагин вместе с любыми зависимостями, которые он объявляет, затем выводит сводку установки.66> После выбора области Claude Code устанавливает плагин вместе с любыми зависимостями, которые он объявляет, затем выводит сводку установки.

67 67>

68**4. Прочитайте сводку установки**68> **4. Прочитайте сводку установки**

69 69>

70Последнее предложение сводки говорит вам, доступен ли плагин в этой сессии прямо сейчас:70> Последнее предложение сводки говорит вам, доступен ли плагин в этой сессии прямо сейчас:

71 71>

72* **Active now**: `Plugin is now active.` Перезагрузка не требуется.72> * **Active now**: `Plugin is now active.` Перезагрузка не требуется.

73* **Active, but a server needs setup**: `Plugin is now active.` сопровождается `Its bundled MCP server needs configuration before it can start`. [Bundled MCP server](https://code.claude.com/docs/ru/plugins/components.md#include-a-packaged-mcpb-server) плагина не может запуститься, пока вы не зададите его параметры. Выберите плагин на вкладке **Installed** в `/plugin` и выберите **Configure**, чтобы задать параметры сервера.73> * **Active, but a server needs setup**: `Plugin is now active.` сопровождается `Its bundled MCP server needs configuration before it can start`. [Bundled MCP server](https://code.claude.com/docs/ru/plugins/components.md#include-a-packaged-mcpb-server) плагина не может запуститься, пока вы не зададите его параметры. Выберите плагин на вкладке **Installed** в `/plugin` и выберите **Configure**, чтобы задать параметры сервера.

74* **Reload needed**: `Run /reload-plugins to apply.` Панель закрывается, и Claude Code запускает эту перезагрузку для вас. Если перезагрузка [инвалидирует кэш промптов](https://code.claude.com/docs/ru/prompt-caching.md#enabling-or-disabling-a-plugin), она предупреждает и вместо этого оставляет плагин в ожидании. Запустите `/reload-plugins --force`, чтобы активировать его в любом случае, что стоит один некэшированный запрос.74> * **Reload needed**: `Run /reload-plugins to apply.` Панель закрывается, и Claude Code запускает эту перезагрузку для вас. Если перезагрузка [инвалидирует кэш промптов](https://code.claude.com/docs/ru/prompt-caching.md#enabling-or-disabling-a-plugin), она предупреждает и вместо этого оставляет плагин в ожидании. Запустите `/reload-plugins --force`, чтобы активировать его в любом случае, что стоит один некэшированный запрос.

75* **Load failed**: `The plugin couldn't be loaded`. Откройте вкладку **Errors** в `/plugin`, чтобы узнать причину, затем см. [After install: plugin not working](https://code.claude.com/docs/ru/plugins/troubleshooting.md#plugin-installed-but-not-working).75> * **Load failed**: `The plugin couldn't be loaded`. Откройте вкладку **Errors** в `/plugin`, чтобы узнать причину, затем см. [After install: plugin not working](https://code.claude.com/docs/ru/plugins/troubleshooting.md#plugin-installed-but-not-working).

76 76>

77**5. Подтвердите, что плагин работает**77> **5. Подтвердите, что плагин работает**

78 78>

79Введите `/` и найдите скиллы плагина под его именем в форме `/<plugin>:<skill>`. Для `commit-commands` появляется `/commit-commands:commit`. Два других места также перечисляют плагин:79> Введите `/` и найдите скиллы плагина под его именем в форме `/<plugin>:<skill>`. Для `commit-commands` появляется `/commit-commands:commit`. Два других места также перечисляют плагин:

80 80>

81* Откройте вкладку **Installed** в `/plugin`, которая перечисляет плагин с его областью.81> * Откройте вкладку **Installed** в `/plugin`, которая перечисляет плагин с его областью.

82* В вашей оболочке запустите `claude plugin list`, который выводит тот же список с строками `Version`, `Scope` и `Status`.82> * В вашей оболочке запустите `claude plugin list`, который выводит тот же список с строками `Version`, `Scope` и `Status`.

83 83>

84Если `/commit-commands:commit` не появляется, см. [After install: plugin not working](https://code.claude.com/docs/ru/plugins/troubleshooting.md#plugin-installed-but-not-working).84> Если `/commit-commands:commit` не появляется, см. [After install: plugin not working](https://code.claude.com/docs/ru/plugins/troubleshooting.md#plugin-installed-but-not-working).

85 85>

86Установка из любого другого маркетплейса требует одного дополнительного шага: [добавьте маркетплейс](#add-a-marketplace). Claude Code добавляет официальный маркетплейс Anthropic для вас в первый раз, когда вы запускаете интерактивную сессию терминала, поэтому пример пропускает этот шаг. Если вы нашли плагин на [claude.com/marketplace](https://claude.com/marketplace), его кнопка **Claude Code** копирует команду установки в её [форме оболочки](#install-from-your-shell), `claude plugin install <name>@claude-plugins-official`.86> Установка из любого другого маркетплейса требует одного дополнительного шага: [добавьте маркетплейс](#add-a-marketplace). Claude Code добавляет официальный маркетплейс Anthropic для вас в первый раз, когда вы запускаете интерактивную сессию терминала, поэтому пример пропускает этот шаг. Если вы нашли плагин на [claude.com/marketplace](https://claude.com/marketplace), его кнопка **Claude Code** копирует команду установки в её [форме оболочки](#install-from-your-shell), `claude plugin install <name>@claude-plugins-official`.

87 

88**Desktop app**

89 

90В локальной или SSH сессии на вкладке **Code** настольного приложения:

91 

92**1. Откройте браузер плагинов**

93 

94Нажмите кнопку **+** рядом с полем промпта и выберите **Add plugins**. Если в меню **+** отображается **Plugins** вместо **Add plugins**, выберите **Plugins**, затем **Browse plugins**. Браузер плагинов откроется с плагинами из ваших маркетплейсов.

95 

96**2. Выберите плагин**

97 

98Найдите `commit-commands` и выберите его.

99 

100**3. Выберите область действия**

101 

102Выберите [область действия](#choose-an-install-scope): ваш пользовательский аккаунт, этот проект или только локально.

103 

104Чтобы позже включить, отключить или удалить плагин, см. [Install plugins in the desktop app](https://code.claude.com/docs/ru/desktop.md#install-plugins).

105 

106**VS Code**

107 

108На панели Claude Code в VS Code:

109 

110**1. Откройте Manage plugins**

111 

112Введите `/plugins` в поле подсказки, чтобы открыть **Manage plugins**.

113 

114**2. Установите плагин**

115 

116На вкладке **Plugins** найдите `commit-commands` и нажмите **Install**. Если вкладка не перечисляет плагины, сначала добавьте `anthropics/claude-plugins-official` на вкладке **Marketplaces**.

117 

118**3. Выберите область**

119 

120Выберите [область](#choose-an-install-scope): **Install for you**, **Install for this project** или **Install locally**.

121 

122Ваши изменения применяются к открытым сессиям без перезагрузки. См. [Manage plugins in VS Code](https://code.claude.com/docs/ru/vs-code.md#manage-plugins).

123 87 

124**Cloud session**88> [tab] Desktop app

89>

90> В локальной или SSH сессии на вкладке **Code** настольного приложения:

91>

92> **1. Откройте браузер плагинов**

93>

94> Нажмите кнопку **+** рядом с полем промпта и выберите **Add plugins**. Если в меню **+** отображается **Plugins** вместо **Add plugins**, выберите **Plugins**, затем **Browse plugins**. Браузер плагинов откроется с плагинами из ваших маркетплейсов.

95>

96> **2. Выберите плагин**

97>

98> Найдите `commit-commands` и выберите его.

99>

100> **3. Выберите область действия**

101>

102> Выберите [область действия](#choose-an-install-scope): ваш пользовательский аккаунт, этот проект или только локально.

103>

104> Чтобы позже включить, отключить или удалить плагин, см. [Install plugins in the desktop app](https://code.claude.com/docs/ru/desktop.md#install-plugins).

125 105 

126[Облачная сессия](https://code.claude.com/docs/ru/cloud-environments.md), включая [браузер на claude.ai/code](https://code.claude.com/docs/ru/claude-code-on-the-web.md), не имеет браузера плагинов и не загружает плагины, которые вы установили на своей машине, или те, которые включены в `.claude/settings.json` вашего репозитория. Для плагинов, которые ваша организация распространяет через управляемые настройки, см. [Manage plugins for your organization](https://code.claude.com/docs/ru/plugins/org.md).106> [tab] VS Code

107>

108> На панели Claude Code в VS Code:

109>

110> **1. Откройте Manage plugins**

111>

112> Введите `/plugins` в поле подсказки, чтобы открыть **Manage plugins**.

113>

114> **2. Установите плагин**

115>

116> На вкладке **Plugins** найдите `commit-commands` и нажмите **Install**. Если вкладка не перечисляет плагины, сначала добавьте `anthropics/claude-plugins-official` на вкладке **Marketplaces**.

117>

118> **3. Выберите область**

119>

120> Выберите [область](#choose-an-install-scope): **Install for you**, **Install for this project** или **Install locally**.

121>

122> Ваши изменения применяются к открытым сессиям без перезагрузки. См. [Manage plugins in VS Code](https://code.claude.com/docs/ru/vs-code.md#manage-plugins).

127 123 

128См. [какие части вашей настройки также доступны в облачной сессии](https://code.claude.com/docs/ru/cloud-environments.md#what-carries-over-from-your-setup) для остальной части вашей настройки.124> [tab] Cloud session

125>

126> [Облачная сессия](https://code.claude.com/docs/ru/cloud-environments.md), включая [браузер на claude.ai/code](https://code.claude.com/docs/ru/claude-code-on-the-web.md), не имеет браузера плагинов и не загружает плагины, которые вы установили на своей машине, или те, которые включены в `.claude/settings.json` вашего репозитория. Для плагинов, которые ваша организация распространяет через управляемые настройки, см. [Manage plugins for your organization](https://code.claude.com/docs/ru/plugins/org.md).

127>

128> См. [какие части вашей настройки также доступны в облачной сессии](https://code.claude.com/docs/ru/cloud-environments.md#what-carries-over-from-your-setup) для остальной части вашей настройки.

129 129 

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

131 131 

Details

116 116 

117### Доля использования в `/usage`117### Доля использования в `/usage`

118 118 

119На плане Pro, Max, Team или Enterprise разбивка `/usage` приписывает недавнее использование skills, subagents, плагинам и MCP servers как доле от общего количества. См. [Использование команды `/usage`](https://code.claude.com/docs/ru/costs#using-the-/usage-command).119На плане Pro, Max, Ultra, Team или Enterprise разбивка `/usage` распределяет недавнее использование между скиллами, субагентами, плагинами и MCP-серверами в виде доли от общего объема. См. [Использование команды `/usage`](https://code.claude.com/docs/ru/costs#using-the-/usage-command).

120 120 

121## Измерение по всему парку121## Измерение по всему парку

122 122 

Details

92 92 

93Создайте два каталога, которые содержат файлы:93Создайте два каталога, которые содержат файлы:

94 94 

95**Bash или Zsh**95> [tab] Bash или Zsh

96 96>

97```bash theme={null}97> ```bash theme={null}

98mkdir -p first-mod/.claude-plugin first-mod/hooks98> mkdir -p first-mod/.claude-plugin first-mod/hooks

99```99> ```

100 

101**PowerShell**

102 100 

103```powershell theme={null}101> [tab] PowerShell

104New-Item -ItemType Directory -Force first-mod\.claude-plugin, first-mod\hooks102>

105```103> ```powershell theme={null}

104> New-Item -ItemType Directory -Force first-mod\.claude-plugin, first-mod\hooks

105> ```

106 106 

107**2. Напишите манифест**107**2. Напишите манифест**

108 108 

Details

181 181 

182Панель и полоса пусты, пока мод их не заполнит. Выберите вкладку, чтобы увидеть, что представляет собой каждая из них и как в ней рисовать:182Панель и полоса пусты, пока мод их не заполнит. Выберите вкладку, чтобы увидеть, что представляет собой каждая из них и как в ней рисовать:

183 183 

184**Pane**184> [tab] Pane

185 185>

186Панель — это боковая панель рядом с транскриптом в широком полноэкранном терминале или обрамленная область над промптом в противном случае. При открытии нескольких панелей каждая получает вкладку, которая показывает ее название.186> Панель — это боковая панель рядом с транскриптом в широком полноэкранном терминале или обрамленная область над промптом в противном случае. При открытии нескольких панелей каждая получает вкладку, которая показывает ее название.

187 187>

188Панель появляется, когда ваш мод вызывает `$.ui.open` с `id`, который вы выбираете, как в `$.ui.open({ id: 'hello-tabs' })`. [Открытие панели в нужное время](#open-a-pane-at-the-right-time) охватывает другие поля и случаи, когда панель ждет более широкого терминала.188> Панель появляется, когда ваш мод вызывает `$.ui.open` с `id`, который вы выбираете, как в `$.ui.open({ id: 'hello-tabs' })`. [Открытие панели в нужное время](#open-a-pane-at-the-right-time) охватывает другие поля и случаи, когда панель ждет более широкого терминала.

189 189>

190Чтобы рисовать в вашей панели, отфильтруйте по `{ component: 'Pane' }` и проверьте, что `e.requestId` — это ваш `id`.190> Чтобы рисовать в вашей панели, отфильтруйте по `{ component: 'Pane' }` и проверьте, что `e.requestId` — это ваш `id`.

191 

192**Band above the prompt**

193 

194Полоса — это полоса прямо над полем ввода промпта. Она присутствует всегда, и все моды используют ее совместно.

195 

196Ваш хук возвращает дерево, чтобы показать что-то в полосе, или `next(e)`, чтобы ничего не показывать. Дерево заменяет то, что моды [после вашего](https://code.claude.com/docs/ru/plugins/mods/events.md#the-order-mods-run-in) рисуют там. Чтобы сохранить их вывод, поместите результат `await next(e)` среди дочерних элементов [`Box`](#build-a-tree-from-elements) в вашем дереве.

197 191 

198Чтобы рисовать в полосе, отфильтруйте по `{ component: 'AbovePrompt' }`.192> [tab] Band above the prompt

193>

194> Полоса — это полоса прямо над полем ввода промпта. Она присутствует всегда, и все моды используют ее совместно.

195>

196> Ваш хук возвращает дерево, чтобы показать что-то в полосе, или `next(e)`, чтобы ничего не показывать. Дерево заменяет то, что моды [после вашего](https://code.claude.com/docs/ru/plugins/mods/events.md#the-order-mods-run-in) рисуют там. Чтобы сохранить их вывод, поместите результат `await next(e)` среди дочерних элементов [`Box`](#build-a-tree-from-elements) в вашем дереве.

197>

198> Чтобы рисовать в полосе, отфильтруйте по `{ component: 'AbovePrompt' }`.

199 199 

200### Изменение того, что уже рисует Claude Code200### Изменение того, что уже рисует Claude Code

201 201 

214 214 

215На сайте, который Claude Code уже рисует, ваш хук может изменить деталь, заменить рисование или оставить его в покое. Выберите вкладку, чтобы увидеть каждый из вариантов, применяемый к спиннеру. Примеры читают переменную `calls`, которую подсчитывает другой хук, как в [учебном моде](https://code.claude.com/docs/ru/plugins/mods/create.md#write-a-mod-yourself).215На сайте, который Claude Code уже рисует, ваш хук может изменить деталь, заменить рисование или оставить его в покое. Выберите вкладку, чтобы увидеть каждый из вариантов, применяемый к спиннеру. Примеры читают переменную `calls`, которую подсчитывает другой хук, как в [учебном моде](https://code.claude.com/docs/ru/plugins/mods/create.md#write-a-mod-yourself).

216 216 

217**Change a detail**217> [tab] Change a detail

218 218>

219Чтобы сохранить рисование Claude Code и изменить одну его часть, передайте `next` копию события с измененными `props`. Этот хук изменяет текст после слова спиннера:219> Чтобы сохранить рисование Claude Code и изменить одну его часть, передайте `next` копию события с измененными `props`. Этот хук изменяет текст после слова спиннера:

220 220>

221```javascript theme={null}221> ```javascript theme={null}

222on('ui.render', { component: 'Spinner' }, async ($, e, next) => {222> on('ui.render', { component: 'Spinner' }, async ($, e, next) => {

223 // Keep Claude Code's spinner, and change the text after its word223> // Keep Claude Code's spinner, and change the text after its word

224 return next({ ...e, props: { ...e.props, suffix: ' · tool calls: ' + calls + '…' } })224> return next({ ...e, props: { ...e.props, suffix: ' · tool calls: ' + calls + '…' } })

225})225> })

226```226> ```

227 227>

228Спиннер сохраняет свою анимацию и свое слово, и ваш текст следует за словом:228> Спиннер сохраняет свою анимацию и свое слово, и ваш текст следует за словом:

229 229>

230```text theme={null}230> ```text theme={null}

231Thinking · tool calls: 2…231> Thinking · tool calls: 2…

232```232> ```

233 

234**Replace the drawing**

235 

236Чтобы нарисовать что-то свое на месте сайта, верните дерево и не вызывайте `next`. Этот хук рисует одну строку текста там, где был бы спиннер:

237 

238```javascript theme={null}

239on('ui.render', { component: 'Spinner' }, async ($, e) => {

240 const { Text } = $.ui.resolve(e)

241 // No call to next, so this line is drawn in the spinner's place

242 return Text({ children: ['Claude has made ' + calls + ' tool calls'] })

243})

244```

245 

246Пока Claude работает, показывается ваша строка, а спиннер Claude Code не показывается:

247 

248```text theme={null}

249Claude has made 2 tool calls

250```

251 

252**Leave it alone**

253 

254Чтобы оставить сайт таким, каким его рисует Claude Code, верните `next(e)`. Хук часто делает это для одних событий и не делает для других. Этот хук оставляет спиннер в покое, пока нечего считать:

255 

256```javascript theme={null}

257on('ui.render', { component: 'Spinner' }, async ($, e, next) => {

258 // Nothing to show yet, so pass the event on unchanged

259 if (calls === 0) return next(e)

260 return next({ ...e, props: { ...e.props, suffix: ' · tool calls: ' + calls + '…' } })

261})

262```

263 233 

264До первого вызова инструмента спиннер выглядит так, как он выглядит без мода:234> [tab] Replace the drawing

235>

236> Чтобы нарисовать что-то свое на месте сайта, верните дерево и не вызывайте `next`. Этот хук рисует одну строку текста там, где был бы спиннер:

237>

238> ```javascript theme={null}

239> on('ui.render', { component: 'Spinner' }, async ($, e) => {

240> const { Text } = $.ui.resolve(e)

241> // No call to next, so this line is drawn in the spinner's place

242> return Text({ children: ['Claude has made ' + calls + ' tool calls'] })

243> })

244> ```

245>

246> Пока Claude работает, показывается ваша строка, а спиннер Claude Code не показывается:

247>

248> ```text theme={null}

249> Claude has made 2 tool calls

250> ```

265 251 

266```text theme={null}252> [tab] Leave it alone

267Thinking…253>

268```254> Чтобы оставить сайт таким, каким его рисует Claude Code, верните `next(e)`. Хук часто делает это для одних событий и не делает для других. Этот хук оставляет спиннер в покое, пока нечего считать:

255>

256> ```javascript theme={null}

257> on('ui.render', { component: 'Spinner' }, async ($, e, next) => {

258> // Nothing to show yet, so pass the event on unchanged

259> if (calls === 0) return next(e)

260> return next({ ...e, props: { ...e.props, suffix: ' · tool calls: ' + calls + '…' } })

261> })

262> ```

263>

264> До первого вызова инструмента спиннер выглядит так, как он выглядит без мода:

265>

266> ```text theme={null}

267> Thinking…

268> ```

269 269 

270На этих сайтах `next(e)` возвращает ссылку на рисование Claude Code, `{ type: 'engine', ref }`, если только мод, который запускается после вашего, не вернул собственное дерево. Чтобы изменить то, что находится в этом рисовании, передайте `next` копию события с другими props, как это сделано на вкладке **Change a detail**. Вы можете вернуть ссылку как есть или поместить ее в `Box` рядом с собственными элементами:270На этих сайтах `next(e)` возвращает ссылку на рисование Claude Code, `{ type: 'engine', ref }`, если только мод, который запускается после вашего, не вернул собственное дерево. Чтобы изменить то, что находится в этом рисовании, передайте `next` копию события с другими props, как это сделано на вкладке **Change a detail**. Вы можете вернуть ссылку как есть или поместить ее в `Box` рядом с собственными элементами:

271 271 

357 357 

358Выберите вкладку, чтобы увидеть каждый из самых распространенных элементов и то, как терминал его рисует:358Выберите вкладку, чтобы увидеть каждый из самых распространенных элементов и то, как терминал его рисует:

359 359 

360**Text**360> [tab] Text

361 361>

362`Text` рисует строку с необязательным стилем, таким как `bold` и `color`:362> `Text` рисует строку с необязательным стилем, таким как `bold` и `color`:

363 363>

364```javascript theme={null}364> ```javascript theme={null}

365Text({ children: ['This is the first tab.'] })365> Text({ children: ['This is the first tab.'] })

366```366> ```

367 367>

368```text theme={null}368> ```text theme={null}

369This is the first tab.369> This is the first tab.

370```370> ```

371 

372**Box**

373 

374`Box` расставляет то, что находится внутри него, в ряд или столбец. Этот помещает кнопку и строку текста рядом, два столбца отдельно:

375 

376```javascript theme={null}

377Box({

378 flexDirection: 'row',

379 columnGap: 2,

380 children: [

381 Button({ key: 'more', label: 'Add one', onPress: addOne }),

382 Text({ children: ['Count: 0'] }),

383 ],

384})

385```

386 

387```text theme={null}

388[ Add one ] Count: 0

389```

390 

391**Button**

392 

393`Button` — это элемент управления, который пользователь может нажать. Он запускает ваш обратный вызов `onPress`. С `plain: true` он не имеет скобок и показывает его горячую клавишу:

394 

395```javascript theme={null}

396Button({ key: 'more', label: 'Add one', onPress: addOne })

397Button({ key: 'tab-one', label: 'One', hotkey: '1', plain: true, onPress: showTabOne })

398```

399 

400```text theme={null}

401[ Add one ]

4021: One

403```

404 

405**Input**

406 

407`Input` — это текстовое поле. Он запускает ваш обратный вызов `onSubmit` с текстом, когда пользователь нажимает Enter:

408 371 

409```javascript theme={null}372> [tab] Box

410Input({373>

411 key: 'new-note',374> `Box` расставляет то, что находится внутри него, в ряд или столбец. Этот помещает кнопку и строку текста рядом, два столбца отдельно:

412 label: 'Note',375>

413 placeholder: 'Type a note and press Enter',376> ```javascript theme={null}

414 value: '',377> Box({

415 submitLabel: 'add',378> flexDirection: 'row',

416 onSubmit: addNote,379> columnGap: 2,

417})380> children: [

418```381> Button({ key: 'more', label: 'Add one', onPress: addOne }),

382> Text({ children: ['Count: 0'] }),

383> ],

384> })

385> ```

386>

387> ```text theme={null}

388> [ Add one ] Count: 0

389> ```

419 390 

420```text theme={null}391> [tab] Button

421Note: Type a note and press Enter392>

422```393> `Button` — это элемент управления, который пользователь может нажать. Он запускает ваш обратный вызов `onPress`. С `plain: true` он не имеет скобок и показывает его горячую клавишу:

394>

395> ```javascript theme={null}

396> Button({ key: 'more', label: 'Add one', onPress: addOne })

397> Button({ key: 'tab-one', label: 'One', hotkey: '1', plain: true, onPress: showTabOne })

398> ```

399>

400> ```text theme={null}

401> [ Add one ]

402> 1: One

403> ```

423 404 

424Задайте для `rows` значение 2 или больше, чтобы получить [поле, вмещающее несколько строк](https://code.claude.com/docs/ru/plugins/mods/gallery.md#input).405> [tab] Input

406>

407> `Input` — это текстовое поле. Он запускает ваш обратный вызов `onSubmit` с текстом, когда пользователь нажимает Enter:

408>

409> ```javascript theme={null}

410> Input({

411> key: 'new-note',

412> label: 'Note',

413> placeholder: 'Type a note and press Enter',

414> value: '',

415> submitLabel: 'add',

416> onSubmit: addNote,

417> })

418> ```

419>

420> ```text theme={null}

421> Note: Type a note and press Enter

422> ```

423>

424> Задайте для `rows` значение 2 или больше, чтобы получить [поле, вмещающее несколько строк](https://code.claude.com/docs/ru/plugins/mods/gallery.md#input).

425 425 

426В [галерее интерфейсов](https://code.claude.com/docs/ru/plugins/mods/gallery.md) есть примеры и снимки экрана большинства элементов. Эта таблица перечисляет каждый элемент:426В [галерее интерфейсов](https://code.claude.com/docs/ru/plugins/mods/gallery.md) есть примеры и снимки экрана большинства элементов. Эта таблица перечисляет каждый элемент:

427 427 

Details

132 132 

133**1. Убедитесь, что вы можете отправлять**133**1. Убедитесь, что вы можете отправлять**

134 134 

135Отправка требует платный план claude.ai. На Pro и Max вы отправляете со своего собственного аккаунта. На Team и Enterprise владелец может отправлять, а на Enterprise владелец также может предоставить разрешение **Directory** другим членам через пользовательскую роль в разделе **Organization settings > Roles**. См. [Подтвердите, что вы можете отправлять в справочник](https://claude.com/docs/directory/publish#confirm-you-can-submit-to-the-directory).135Отправка требует платный план claude.ai. На Pro, Max и Ultra вы отправляете со своего собственного аккаунта. На Team и Enterprise владелец может отправлять, а на Enterprise владелец также может предоставить разрешение **Directory** другим членам через пользовательскую роль в разделе **Organization settings > Roles**. См. [Подтвердите, что вы можете отправлять в справочник](https://claude.com/docs/directory/publish#confirm-you-can-submit-to-the-directory).

136 136 

137**2. Проверьте плагин локально**137**2. Проверьте плагин локально**

138 138 

Details

302 302 

303Клонирование маркетплейса и повторное клонирование для его обновления получает 120 секунд по умолчанию. Для большого репозитория или медленного соединения повысьте лимит. Значение указано в миллисекундах:303Клонирование маркетплейса и повторное клонирование для его обновления получает 120 секунд по умолчанию. Для большого репозитория или медленного соединения повысьте лимит. Значение указано в миллисекундах:

304 304 

305**Bash или Zsh**305> [tab] Bash или Zsh

306 306>

307```bash theme={null}307> ```bash theme={null}

308export CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS=300000308> export CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS=300000

309```309> ```

310 

311**PowerShell**

312 310 

313```powershell theme={null}311> [tab] PowerShell

314$env:CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS = "300000"312>

315```313> ```powershell theme={null}

314> $env:CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS = "300000"

315> ```

316 316 

317Затем повторите попытку в той же оболочке.317Затем повторите попытку в той же оболочке.

318 318 

328 328 

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

330 330 

331**Bash или Zsh**331> [tab] Bash или Zsh

332 332>

333```bash theme={null}333> ```bash theme={null}

334export CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1334> export CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1

335```335> ```

336 

337**PowerShell**

338 336 

339```powershell theme={null}337> [tab] PowerShell

340$env:CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE = "1"338>

341```339> ```powershell theme={null}

340> $env:CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE = "1"

341> ```

342 342 

343С установленной переменной Claude Code пропускает повторное клонирование только для копии, которая уже содержит `.claude-plugin/marketplace.json`. Маркетплейс, который никогда не был клонирован или чьё клонирование остановилось на полпути, всё ещё получает попытку клонирования, поэтому добавьте его один раз в сети.343С установленной переменной Claude Code пропускает повторное клонирование только для копии, которая уже содержит `.claude-plugin/marketplace.json`. Маркетплейс, который никогда не был клонирован или чьё клонирование остановилось на полпути, всё ещё получает попытку клонирования, поэтому добавьте его один раз в сети.

344 344 

quickstart.md +56 −56

Details

14 14 

15* Открытый терминал или командная строка15* Открытый терминал или командная строка

16* Проект кода для работы16* Проект кода для работы

17* [Подписка Claude](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_prereq) (Pro, Max, Team или Enterprise), учётная запись [Claude Console](https://platform.claude.com/) или доступ через [поддерживаемого облачного провайдера](https://code.claude.com/docs/ru/third-party-integrations.md)17* [Подписка Claude](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_prereq) (Pro, Max, Ultra, Team или Enterprise), учётная запись [Claude Console](https://platform.claude.com/) или доступ через [поддерживаемого облачного провайдера](https://code.claude.com/docs/ru/third-party-integrations.md)

18 18 

19> [!NOTE]19> [!NOTE]

20>20>

27 27 

28Для установки Claude Code откройте терминал и выполните команду для вашей системы. Если вы раньше не использовали терминал, [руководство по терминалу](https://code.claude.com/docs/ru/terminal-guide) показывает, как его открыть и вставить команду.28Для установки Claude Code откройте терминал и выполните команду для вашей системы. Если вы раньше не использовали терминал, [руководство по терминалу](https://code.claude.com/docs/ru/terminal-guide) показывает, как его открыть и вставить команду.

29 29 

30**Встроенная установка (рекомендуется)**30> [tab] Встроенная установка (рекомендуется)

31 

32**macOS, Linux, WSL:**

33 

34```bash theme={null}

35curl -fsSL https://claude.ai/install.sh | bash

36```

37 

38В Windows приглашение командной строки показывает `PS C:\`, когда вы находитесь в PowerShell, и `C:\` без `PS`, когда вы находитесь в CMD.

39 

40**Windows PowerShell:**

41 

42```powershell theme={null}

43irm https://claude.ai/install.ps1 | iex

44```

45 

46**Windows CMD:**

47 

48```batch theme={null}

49curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

50```

51 

52Команда установки не показывает прогресс во время загрузки Claude Code. Когда установщик завершит работу, откройте новое окно терминала и выполните `claude --version`. Работающая установка выводит номер версии. Если ваша оболочка говорит, что `claude` не найден или не распознан, каталог установки еще не находится в вашем PATH: см. [Исправьте ваш PATH](https://code.claude.com/docs/ru/troubleshoot-install.md#command-not-found-claude-after-installation).

53 

54Если вы видите `The token '&&' is not a valid statement separator`, вы находитесь в PowerShell, а не в CMD. Если вы видите `'irm' is not recognized as an internal or external command`, вы находитесь в CMD, а не в PowerShell.

55 

56Если команда установки завершается с ошибкой `syntax error near unexpected token '<'`, `403` или любой другой ошибкой, см. [Устранение неполадок при установке](https://code.claude.com/docs/ru/troubleshoot-install.md#find-your-error), чтобы сопоставить ошибку с исправлением и для альтернативных методов установки.

57 

58[Git for Windows](https://git-scm.com/downloads/win) рекомендуется на встроенной Windows, чтобы Claude Code мог использовать инструмент Bash. Если Git for Windows не установлен, Claude Code использует PowerShell в качестве инструмента оболочки. Установки WSL не требуют Git for Windows.

59 

60> [!NOTE]

61>31>

62> Встроенные установки автоматически обновляются в фоновом режиме, чтобы вы всегда использовали последнюю версию.32> **macOS, Linux, WSL:**

63 

64**Homebrew**

65 

66```bash theme={null}

67brew install --cask claude-code

68```

69 

70Homebrew предлагает два пакета. `claude-code` отслеживает канал стабильного выпуска, который обычно отстает примерно на неделю и пропускает выпуски с серьезными регрессиями. `claude-code@latest` отслеживает последний канал и получает новые версии сразу после их выпуска.

71 

72> [!NOTE]

73>33>

74> Установки Homebrew не обновляются автоматически. Запустите `brew upgrade claude-code` или `brew upgrade claude-code@latest`, в зависимости от того, какой пакет вы установили, чтобы получить последние функции и исправления безопасности.34> ```bash theme={null}

75 35> curl -fsSL https://claude.ai/install.sh | bash

76**WinGet**36> ```

37>

38> В Windows приглашение командной строки показывает `PS C:\`, когда вы находитесь в PowerShell, и `C:\` без `PS`, когда вы находитесь в CMD.

39>

40> **Windows PowerShell:**

41>

42> ```powershell theme={null}

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

44> ```

45>

46> **Windows CMD:**

47>

48> ```batch theme={null}

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

50> ```

51>

52> Команда установки не показывает прогресс во время загрузки Claude Code. Когда установщик завершит работу, откройте новое окно терминала и выполните `claude --version`. Работающая установка выводит номер версии. Если ваша оболочка говорит, что `claude` не найден или не распознан, каталог установки еще не находится в вашем PATH: см. [Исправьте ваш PATH](https://code.claude.com/docs/ru/troubleshoot-install.md#command-not-found-claude-after-installation).

53>

54> Если вы видите `The token '&&' is not a valid statement separator`, вы находитесь в PowerShell, а не в CMD. Если вы видите `'irm' is not recognized as an internal or external command`, вы находитесь в CMD, а не в PowerShell.

55>

56> Если команда установки завершается с ошибкой `syntax error near unexpected token '<'`, `403` или любой другой ошибкой, см. [Устранение неполадок при установке](https://code.claude.com/docs/ru/troubleshoot-install.md#find-your-error), чтобы сопоставить ошибку с исправлением и для альтернативных методов установки.

57>

58> [Git for Windows](https://git-scm.com/downloads/win) рекомендуется на встроенной Windows, чтобы Claude Code мог использовать инструмент Bash. Если Git for Windows не установлен, Claude Code использует PowerShell в качестве инструмента оболочки. Установки WSL не требуют Git for Windows.

59>

60> > [!NOTE]

61> >

62> > Встроенные установки автоматически обновляются в фоновом режиме, чтобы вы всегда использовали последнюю версию.

77 63 

78```powershell theme={null}64> [tab] Homebrew

79winget install Anthropic.ClaudeCode65>

80```66> ```bash theme={null}

67> brew install --cask claude-code

68> ```

69>

70> Homebrew предлагает два пакета. `claude-code` отслеживает канал стабильного выпуска, который обычно отстает примерно на неделю и пропускает выпуски с серьезными регрессиями. `claude-code@latest` отслеживает последний канал и получает новые версии сразу после их выпуска.

71>

72> > [!NOTE]

73> >

74> > Установки Homebrew не обновляются автоматически. Запустите `brew upgrade claude-code` или `brew upgrade claude-code@latest`, в зависимости от того, какой пакет вы установили, чтобы получить последние функции и исправления безопасности.

81 75 

82> [!NOTE]76> [tab] WinGet

77>

78> ```powershell theme={null}

79> winget install Anthropic.ClaudeCode

80> ```

83>81>

84> Установки WinGet не обновляются автоматически. Периодически запускайте `winget upgrade Anthropic.ClaudeCode` чтобы получить последние функции и исправления безопасности.82> > [!NOTE]

83> >

84> > Установки WinGet не обновляются автоматически. Периодически запускайте `winget upgrade Anthropic.ClaudeCode` чтобы получить последние функции и исправления безопасности.

85 85 

86Вы также можете установить с помощью [apt, dnf или apk](https://code.claude.com/docs/ru/setup.md#install-with-linux-package-managers) на Debian, Fedora, RHEL и Alpine.86Вы также можете установить с помощью [apt, dnf или apk](https://code.claude.com/docs/ru/setup.md#install-with-linux-package-managers) на Debian, Fedora, RHEL и Alpine.

87 87 

108 108 

109Вы можете войти, используя любой из следующих типов учётных записей:109Вы можете войти, используя любой из следующих типов учётных записей:

110 110 

111* [Claude Pro, Max, Team или Enterprise](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_login) (рекомендуется)111* [Claude Pro, Max, Ultra, Team или Enterprise](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_login) (рекомендуется)

112* [Claude Console](https://platform.claude.com/) (доступ к API с предоплаченными кредитами). При первом входе в Console автоматически создаётся рабочее пространство «Claude Code» для централизованного отслеживания расходов.112* [Claude Console](https://platform.claude.com/) (доступ к API с предоплаченными кредитами). При первом входе в Console автоматически создаётся рабочее пространство «Claude Code» для централизованного отслеживания расходов.

113* [Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry](https://code.claude.com/docs/ru/third-party-integrations.md) (корпоративные облачные провайдеры)113* [Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry](https://code.claude.com/docs/ru/third-party-integrations.md) (корпоративные облачные провайдеры)

114* Самостоятельно размещённый [шлюз приложений Claude](https://code.claude.com/docs/ru/claude-apps-gateway), если ваша организация его использует: администратор заранее настраивает URL шлюза, и `/login` сразу открывается на экране **Cloud gateway**, где вы можете войти с помощью корпоративного SSO114* Самостоятельно размещённый [шлюз приложений Claude](https://code.claude.com/docs/ru/claude-apps-gateway), если ваша организация его использует: администратор заранее настраивает URL шлюза, и `/login` сразу открывается на экране **Cloud gateway**, где вы можете войти с помощью корпоративного SSO

267 267 

268Для большего, смотрите [лучшие практики](https://code.claude.com/docs/ru/best-practices.md) и [типичные рабочие процессы](https://code.claude.com/docs/ru/common-workflows.md).268Для большего, смотрите [лучшие практики](https://code.claude.com/docs/ru/best-practices.md) и [типичные рабочие процессы](https://code.claude.com/docs/ru/common-workflows.md).

269 269 

270> **Будьте конкретны в своих запросах**270> [accordion] Будьте конкретны в своих запросах

271>271>

272> Вместо: "исправить ошибку"272> Вместо: "исправить ошибку"

273>273>

274> Попробуйте: "исправить ошибку входа, когда пользователи видят пустой экран после ввода неправильных учетных данных"274> Попробуйте: "исправить ошибку входа, когда пользователи видят пустой экран после ввода неправильных учетных данных"

275 275 

276> **Используйте пошаговые инструкции**276> [accordion] Используйте пошаговые инструкции

277>277>

278> Разбейте сложные задачи на этапы:278> Разбейте сложные задачи на этапы:

279>279>

283> 3. создать веб-страницу, которая позволяет пользователям просматривать и редактировать свою информацию283> 3. создать веб-страницу, которая позволяет пользователям просматривать и редактировать свою информацию

284> ```284> ```

285 285 

286> **Позвольте Claude сначала исследовать**286> [accordion] Позвольте Claude сначала исследовать

287>287>

288> Перед внесением изменений позвольте Claude понять ваш код:288> Перед внесением изменений позвольте Claude понять ваш код:

289>289>

295> создать панель управления, показывающую продукты, которые чаще всего возвращаются нашими клиентами из Великобритании295> создать панель управления, показывающую продукты, которые чаще всего возвращаются нашими клиентами из Великобритании

296> ```296> ```

297 297 

298> **Сэкономьте время с помощью ярлыков**298> [accordion] Сэкономьте время с помощью ярлыков

299>299>

300> * Введите `/` для просмотра всех команд и skills300> * Введите `/` для просмотра всех команд и skills

301> * Используйте Tab для завершения команды301> * Используйте Tab для завершения команды

remote-control.md +97 −97

Details

25 25 

26Перед использованием Remote Control убедитесь, что ваша среда соответствует этим условиям:26Перед использованием Remote Control убедитесь, что ваша среда соответствует этим условиям:

27 27 

28* **Подписка**: доступна на планах Pro, Max, Team и Enterprise. API ключи не поддерживаются. На планах Team и Enterprise владелец должен сначала включить переключатель Remote Control в [параметрах администратора Claude Code](https://claude.ai/admin-settings/claude-code).28* **Подписка**: доступна на планах Pro, Max, Ultra, Team и Enterprise. API-ключи не поддерживаются. На планах Team и Enterprise Owner должен сначала включить переключатель Remote Control в [настройках администратора Claude Code](https://claude.ai/admin-settings/claude-code).

29* **Пользовательские роли**: если ваша организация Enterprise управляет вашим доступом с помощью [пользовательских ролей](https://support.claude.com/en/articles/13930452), ваши роли должны предоставлять вам как разрешение на облачные сессии, так и разрешение **Claude Code remote control**. Если любого из них нет, при запуске Remote Control отображается [`Remote Control is disabled by your organization's policy`](#remote-control-is-disabled-by-your-organizations-policy). Попросите Owner проверить ваши роли и добавить недостающее в [**Organization settings > Roles**](https://claude.ai/admin-settings/roles).29* **Пользовательские роли**: если ваша организация Enterprise управляет вашим доступом с помощью [пользовательских ролей](https://support.claude.com/en/articles/13930452), ваши роли должны предоставлять вам как разрешение на облачные сессии, так и разрешение **Claude Code remote control**. Если любого из них нет, при запуске Remote Control отображается [`Remote Control is disabled by your organization's policy`](#remote-control-is-disabled-by-your-organizations-policy). Попросите Owner проверить ваши роли и добавить недостающее в [**Organization settings > Roles**](https://claude.ai/admin-settings/roles).

30* **Аутентификация**: запустите `claude` и используйте `/login` для входа через claude.ai, если вы ещё этого не сделали. Без подходящей учётной записи `claude remote-control` завершится с ошибкой, в то время как `claude --remote-control` всё ещё запустит интерактивный сеанс и покажет уведомление об ошибке Remote Control вскоре после запуска.30* **Аутентификация**: запустите `claude` и используйте `/login` для входа через claude.ai, если вы ещё этого не сделали. Без подходящей учётной записи `claude remote-control` завершится с ошибкой, в то время как `claude --remote-control` всё ещё запустит интерактивный сеанс и покажет уведомление об ошибке Remote Control вскоре после запуска.

31* **Конечная точка API**: недоступна в любой из этих конфигураций:31* **Конечная точка API**: недоступна в любой из этих конфигураций:

41 41 

42Вы можете запустить сеанс Remote Control из CLI, [приложения Claude Desktop](https://code.claude.com/docs/ru/desktop.md) или расширения VS Code. CLI предлагает три режима вызова; приложение Desktop и VS Code используют команду `/remote-control`.42Вы можете запустить сеанс Remote Control из CLI, [приложения Claude Desktop](https://code.claude.com/docs/ru/desktop.md) или расширения VS Code. CLI предлагает три режима вызова; приложение Desktop и VS Code используют команду `/remote-control`.

43 43 

44**Режим сервера**44> [tab] Режим сервера

45 45>

46В каталоге вашего проекта выполните:46> В каталоге вашего проекта выполните:

47 47>

48```bash theme={null}48> ```bash theme={null}

49claude remote-control49> claude remote-control

50```50> ```

51 51>

52До тех пор, пока вы не примете одноразовое подтверждение Remote Control, `claude remote-control` объясняет, что он делает, и спрашивает `Enable Remote Control? (y/n)` перед запуском сервера. Ответьте `y`, чтобы принять и запустить сервер. Если вы откажетесь, Claude Code завершит работу без запуска сервера и снова спросит при следующем запуске команды.52> До тех пор, пока вы не примете одноразовое подтверждение Remote Control, `claude remote-control` объясняет, что он делает, и спрашивает `Enable Remote Control? (y/n)` перед запуском сервера. Ответьте `y`, чтобы принять и запустить сервер. Если вы откажетесь, Claude Code завершит работу без запуска сервера и снова спросит при следующем запуске команды.

53 53>

54Процесс продолжает работать в вашем терминале в режиме сервера, ожидая удаленных подключений. Он отображает URL сеанса, который вы можете использовать для [подключения с другого устройства](#connect-from-another-device), и вы можете нажать пробел, чтобы показать QR-код для быстрого доступа с телефона. Пока активен удаленный сеанс, терминал показывает статус подключения и активность инструментов.54> Процесс продолжает работать в вашем терминале в режиме сервера, ожидая удаленных подключений. Он отображает URL сеанса, который вы можете использовать для [подключения с другого устройства](#connect-from-another-device), и вы можете нажать пробел, чтобы показать QR-код для быстрого доступа с телефона. Пока активен удаленный сеанс, терминал показывает статус подключения и активность инструментов.

55 55>

56Передавайте любые из этих флагов после `remote-control`:56> Передавайте любые из этих флагов после `remote-control`:

57 57>

58| Флаг | Описание |58> | Флаг | Описание |

59| - | - |59> | - | - |

60| `--name "My Project"` | Установите пользовательское название сеанса, видимое в списке сеансов на claude.ai/code. |60> | `--name "My Project"` | Установите пользовательское название сеанса, видимое в списке сеансов на claude.ai/code. |

61| `--remote-control-session-name-prefix <prefix>` | Префикс для автоматически генерируемых названий сеансов, когда явное имя не установлено. По умолчанию используется имя хоста вашей машины, создавая названия вроде `myhost-graceful-unicorn`. Установите `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` для того же эффекта. |61> | `--remote-control-session-name-prefix <prefix>` | Префикс для автоматически генерируемых названий сеансов, когда явное имя не установлено. По умолчанию используется имя хоста вашей машины, создавая названия вроде `myhost-graceful-unicorn`. Установите `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` для того же эффекта. |

62| `-c`, `--continue` | Восстановите сеанс, который последний сервер в этом каталоге запустил, вместо создания нового. См. [Возобновление сеансов после остановки сервера](#resume-sessions-after-stopping-the-server). Не может быть объединено с `--session-id`, `--spawn`, `--capacity` или `--create-session-in-dir`. Требуется Claude Code v2.1.200 или позже. |62> | `-c`, `--continue` | Восстановите сеанс, который последний сервер в этом каталоге запустил, вместо создания нового. См. [Возобновление сеансов после остановки сервера](#resume-sessions-after-stopping-the-server). Не может быть объединено с `--session-id`, `--spawn`, `--capacity` или `--create-session-in-dir`. Требуется Claude Code v2.1.200 или позже. |

63| `--session-id <id>` | Восстановите один сеанс по его ID. См. [Возобновление сеансов после остановки сервера](#resume-sessions-after-stopping-the-server). Не может быть объединено с `--continue`, `--spawn`, `--capacity` или `--create-session-in-dir`. Требуется Claude Code v2.1.200 или позже. |63> | `--session-id <id>` | Восстановите один сеанс по его ID. См. [Возобновление сеансов после остановки сервера](#resume-sessions-after-stopping-the-server). Не может быть объединено с `--continue`, `--spawn`, `--capacity` или `--create-session-in-dir`. Требуется Claude Code v2.1.200 или позже. |

64| `--spawn <mode>` | Как сервер создает сессии. • `same-dir` (по умолчанию, если режим не сохранен): все сессии используют текущий рабочий каталог, поэтому они могут конфликтовать при редактировании одних и тех же файлов. • `worktree`: каждая сессия по требованию получает собственный [git worktree](https://code.claude.com/docs/ru/worktrees.md). Требуется Git-репозиторий или [хук `WorktreeCreate`](https://code.claude.com/docs/ru/hooks#worktreecreate). • `session`: режим одной сессии. Обслуживает ровно одну сессию и отклоняет дополнительные подключения. Задается только при запуске. Нажмите `w` во время работы, чтобы переключаться между `same-dir` и `worktree`. Режим, на который вы переключились, становится [режимом по умолчанию для этого проекта](#set-the-default-spawn-mode-for-a-project). |64> | `--spawn <mode>` | Как сервер создает сессии. • `same-dir` (по умолчанию, если режим не сохранен): все сессии используют текущий рабочий каталог, поэтому они могут конфликтовать при редактировании одних и тех же файлов. • `worktree`: каждая сессия по требованию получает собственный [git worktree](https://code.claude.com/docs/ru/worktrees.md). Требуется Git-репозиторий или [хук `WorktreeCreate`](https://code.claude.com/docs/ru/hooks#worktreecreate). • `session`: режим одной сессии. Обслуживает ровно одну сессию и отклоняет дополнительные подключения. Задается только при запуске. Нажмите `w` во время работы, чтобы переключаться между `same-dir` и `worktree`. Режим, на который вы переключились, становится [режимом по умолчанию для этого проекта](#set-the-default-spawn-mode-for-a-project). |

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

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

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

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

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

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

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

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

73 73>

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

75 75>

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

77 77>

78Чтобы вывести флаги `remote-control` в терминале, выполните `claude remote-control --help`. До v2.1.302 без входа с подходящей учетной записью команда вместо этого возвращала одну из ошибок, описанных в разделе [Устранение неполадок](#troubleshooting).78> Чтобы вывести флаги `remote-control` в терминале, выполните `claude remote-control --help`. До v2.1.302 без входа с подходящей учетной записью команда вместо этого возвращала одну из ошибок, описанных в разделе [Устранение неполадок](#troubleshooting).

79 

80**Интерактивная сессия**

81 

82Чтобы запустить обычную интерактивную сессию Claude Code с включенным Remote Control, используйте флаг `--remote-control` (или `--rc`):

83 

84```bash theme={null}

85claude --remote-control

86```

87 

88Опционально передайте имя для сеанса:

89 

90```bash theme={null}

91claude --remote-control "My Project"

92```

93 

94Это дает вам полный интерактивный сеанс в вашем терминале, который вы также можете контролировать с claude.ai или приложения Claude. В отличие от `claude remote-control` (режим сервера), вы можете вводить сообщения локально, пока сеанс также доступен удаленно.

95 

96**Из существующего сеанса**

97 

98Если вы уже находитесь в сеансе Claude Code и хотите продолжить его удаленно, используйте команду `/remote-control` (или `/rc`):

99 

100```text theme={null}

101/remote-control

102```

103 

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

105 

106```text theme={null}

107/remote-control My Project

108```

109 

110Это запускает сеанс Remote Control, который переносит историю вашего текущего разговора.

111 

112До тех пор, пока вы не примете одноразовое подтверждение Remote Control, диалог появляется перед подключением `/remote-control`. Выберите **Enable Remote Control**, чтобы принять и подключиться. Если вы выберете **Never mind** или нажмете Esc, Claude Code не подключится и снова спросит при следующем запуске `/remote-control`.

113 

114Флаг `--verbose` недоступен с этой командой.

115 

116**VS Code**

117 

118В [расширении Claude Code VS Code](https://code.claude.com/docs/ru/vs-code.md) введите `/remote-control` или `/rc` в поле подсказки.

119 

120```text theme={null}

121/remote-control

122```

123 

124Пока Remote Control включен, Claude Code показывает индикатор **Remote Control** в нижней части поля подсказки. После подключения сеанса нажмите на индикатор, чтобы перейти непосредственно к сеансу, или найдите его в списке сеансов на [claude.ai/code](https://claude.ai/code). Claude Code также публикует URL сеанса в разговоре. Чтобы отключиться, запустите `/remote-control` снова.

125 

126В отличие от CLI, команда VS Code не принимает аргумент имени и не отображает QR-код. Название сеанса выводится из истории вашего разговора или первой подсказки.

127 

128**Приложение Desktop**

129 79 

130В локальном сеансе на вкладке Code [приложения Claude Desktop](https://code.claude.com/docs/ru/desktop.md) введите `/remote-control` или `/rc` в поле подсказки.80> [tab] Интерактивная сессия

81>

82> Чтобы запустить обычную интерактивную сессию Claude Code с включенным Remote Control, используйте флаг `--remote-control` (или `--rc`):

83>

84> ```bash theme={null}

85> claude --remote-control

86> ```

87>

88> Опционально передайте имя для сеанса:

89>

90> ```bash theme={null}

91> claude --remote-control "My Project"

92> ```

93>

94> Это дает вам полный интерактивный сеанс в вашем терминале, который вы также можете контролировать с claude.ai или приложения Claude. В отличие от `claude remote-control` (режим сервера), вы можете вводить сообщения локально, пока сеанс также доступен удаленно.

131 95 

132```text theme={null}96> [tab] Из существующего сеанса

133/remote-control97>

134```98> Если вы уже находитесь в сеансе Claude Code и хотите продолжить его удаленно, используйте команду `/remote-control` (или `/rc`):

99>

100> ```text theme={null}

101> /remote-control

102> ```

103>

104> Передайте имя в качестве аргумента, чтобы установить пользовательское название сеанса:

105>

106> ```text theme={null}

107> /remote-control My Project

108> ```

109>

110> Это запускает сеанс Remote Control, который переносит историю вашего текущего разговора.

111>

112> До тех пор, пока вы не примете одноразовое подтверждение Remote Control, диалог появляется перед подключением `/remote-control`. Выберите **Enable Remote Control**, чтобы принять и подключиться. Если вы выберете **Never mind** или нажмете Esc, Claude Code не подключится и снова спросит при следующем запуске `/remote-control`.

113>

114> Флаг `--verbose` недоступен с этой командой.

135 115 

136После подключения сеанса найдите его в списке сеансов на [claude.ai/code](https://claude.ai/code). Чтобы отключиться, запустите `/remote-control` снова.116> [tab] VS Code

117>

118> В [расширении Claude Code VS Code](https://code.claude.com/docs/ru/vs-code.md) введите `/remote-control` или `/rc` в поле подсказки.

119>

120> ```text theme={null}

121> /remote-control

122> ```

123>

124> Пока Remote Control включен, Claude Code показывает индикатор **Remote Control** в нижней части поля подсказки. После подключения сеанса нажмите на индикатор, чтобы перейти непосредственно к сеансу, или найдите его в списке сеансов на [claude.ai/code](https://claude.ai/code). Claude Code также публикует URL сеанса в разговоре. Чтобы отключиться, запустите `/remote-control` снова.

125>

126> В отличие от CLI, команда VS Code не принимает аргумент имени и не отображает QR-код. Название сеанса выводится из истории вашего разговора или первой подсказки.

137 127 

138Чтобы вместо этого включить Remote Control для каждого сеанса по умолчанию, см. [Включение Remote Control для всех сеансов](#enable-remote-control-for-all-sessions).128> [tab] Приложение Desktop

129>

130> В локальном сеансе на вкладке Code [приложения Claude Desktop](https://code.claude.com/docs/ru/desktop.md) введите `/remote-control` или `/rc` в поле подсказки.

131>

132> ```text theme={null}

133> /remote-control

134> ```

135>

136> После подключения сеанса найдите его в списке сеансов на [claude.ai/code](https://claude.ai/code). Чтобы отключиться, запустите `/remote-control` снова.

137>

138> Чтобы вместо этого включить Remote Control для каждого сеанса по умолчанию, см. [Включение Remote Control для всех сеансов](#enable-remote-control-for-all-sessions).

139 139 

140### Проверка статуса подключения140### Проверка статуса подключения

141 141 

250>250>

251> Доверенные устройства в настоящее время находятся в бета-версии. Функции и возможности могут развиваться по мере совершенствования опыта.251> Доверенные устройства в настоящее время находятся в бета-версии. Функции и возможности могут развиваться по мере совершенствования опыта.

252>252>

253> Доверенные устройства доступны на планах Pro, Max, Team и Enterprise и отключены по умолчанию. На планах Team и Enterprise владелец включает эту функцию для организации. На планах Pro и Max вы сами включаете **Require trusted devices** в своих параметрах на странице Cowork или Account.253> Доверенные устройства доступны на планах Pro, Max, Ultra, Team и Enterprise и отключены по умолчанию. На планах Team и Enterprise Owner включает эту функцию для организации. На планах Pro, Max и Ultra вы сами включаете **Require trusted devices** в своих настройках на странице Cowork или Account.

254 254 

255Доверенные устройства требуют от каждого члена вашей организации или только от вас на плане Pro или Max проверить своё устройство перед тем, как они смогут просматривать или управлять сеансами Remote Control из claude.ai, мобильных приложений Claude или Claude Desktop. Это связывает доступ Remote Control с известным устройством и недавней аутентификацией, а не просто с подписанной учётной записью.255Доверенные устройства требуют проверенного устройства, прежде чем вы сможете просматривать сессии Remote Control или управлять ими из claude.ai, мобильных приложений Claude или Claude Desktop. Это требование распространяется на каждого члена вашей организации или только на вас на плане Pro, Max или Ultra. Это связывает доступ Remote Control с известным устройством и недавней аутентификацией, а не просто с учётной записью, в которую выполнен вход.

256 256 

257Когда параметр включен, взаимодействие с сеансом Remote Control требует обоих следующих условий:257Когда параметр включен, взаимодействие с сеансом Remote Control требует обоих следующих условий:

258 258 

310| [Dispatch](https://code.claude.com/docs/ru/desktop.md#sessions-from-dispatch) | Отправьте задачу из мобильного приложения Claude | Ваша машина (Desktop) | [Свяжите мобильное приложение с Desktop](https://support.claude.com/en/articles/13947068) | Делегирование работы, когда вас нет, минимальная настройка |310| [Dispatch](https://code.claude.com/docs/ru/desktop.md#sessions-from-dispatch) | Отправьте задачу из мобильного приложения Claude | Ваша машина (Desktop) | [Свяжите мобильное приложение с Desktop](https://support.claude.com/en/articles/13947068) | Делегирование работы, когда вас нет, минимальная настройка |

311| [Remote Control](https://code.claude.com/docs/ru/remote-control.md) | Управляйте запущенной сессией из [claude.ai/code](https://claude.ai/code) или мобильного приложения Claude | Ваша машина (CLI, Desktop или VS Code) | Запустите [`claude remote-control` или `/remote-control`](https://code.claude.com/docs/ru/remote-control#start-a-remote-control-session) | Управление текущей работой с другого устройства |311| [Remote Control](https://code.claude.com/docs/ru/remote-control.md) | Управляйте запущенной сессией из [claude.ai/code](https://claude.ai/code) или мобильного приложения Claude | Ваша машина (CLI, Desktop или VS Code) | Запустите [`claude remote-control` или `/remote-control`](https://code.claude.com/docs/ru/remote-control#start-a-remote-control-session) | Управление текущей работой с другого устройства |

312| [Channels](https://code.claude.com/docs/ru/channels.md) | Отправляйте события из приложения чата, такого как Telegram или Discord, или с вашего собственного сервера | Ваша машина (CLI) | [Установите плагин канала](https://code.claude.com/docs/ru/channels.md#quickstart) или [создайте свой](https://code.claude.com/docs/ru/channels-reference.md) | Реагирование на внешние события, такие как сбои CI или сообщения в чате |312| [Channels](https://code.claude.com/docs/ru/channels.md) | Отправляйте события из приложения чата, такого как Telegram или Discord, или с вашего собственного сервера | Ваша машина (CLI) | [Установите плагин канала](https://code.claude.com/docs/ru/channels.md#quickstart) или [создайте свой](https://code.claude.com/docs/ru/channels-reference.md) | Реагирование на внешние события, такие как сбои CI или сообщения в чате |

313| [Slack](https://code.claude.com/docs/ru/slack.md) | Упомяните `@Claude` в канале команды | Облако Anthropic | [Установите приложение Slack](https://code.claude.com/docs/ru/slack.md#setting-up-claude-code-in-slack) с включенным [Claude Code в веб-версии](https://code.claude.com/docs/ru/claude-code-on-the-web.md), в планах Pro и Max | PR и рецензии из чата команды |313| [Slack](https://code.claude.com/docs/ru/slack.md) | Упомяните `@Claude` в канале команды | Облако Anthropic | [Установите приложение Slack](https://code.claude.com/docs/ru/slack.md#setting-up-claude-code-in-slack) с включенным [Claude Code в веб-версии](https://code.claude.com/docs/ru/claude-code-on-the-web.md), в планах Pro, Max и Ultra | PR и рецензии из чата команды |

314| [Self-hosted environments](https://code.claude.com/docs/ru/self-hosted-environments) | Запустите [облачную сессию](https://code.claude.com/docs/ru/claude-code-on-the-web.md) и выберите окружение вашей организации | Инфраструктура вашей организации | [Разверните runners](https://code.claude.com/docs/ru/self-hosted-environments-quickstart.md), в планах Team и Enterprise | Облачные сессии, которые должны работать внутри вашей сети |314| [Self-hosted environments](https://code.claude.com/docs/ru/self-hosted-environments) | Запустите [облачную сессию](https://code.claude.com/docs/ru/claude-code-on-the-web.md) и выберите окружение вашей организации | Инфраструктура вашей организации | [Разверните runners](https://code.claude.com/docs/ru/self-hosted-environments-quickstart.md), в планах Team и Enterprise | Облачные сессии, которые должны работать внутри вашей сети |

315| [Scheduled tasks](https://code.claude.com/docs/ru/scheduled-tasks.md) | Установите расписание | [CLI](https://code.claude.com/docs/ru/scheduled-tasks.md), [Desktop](https://code.claude.com/docs/ru/desktop-scheduled-tasks.md) или [облако](https://code.claude.com/docs/ru/routines.md) | Выберите частоту | Повторяющаяся автоматизация, такая как ежедневные проверки |315| [Scheduled tasks](https://code.claude.com/docs/ru/scheduled-tasks.md) | Установите расписание | [CLI](https://code.claude.com/docs/ru/scheduled-tasks.md), [Desktop](https://code.claude.com/docs/ru/desktop-scheduled-tasks.md) или [облако](https://code.claude.com/docs/ru/routines.md) | Выберите частоту | Повторяющаяся автоматизация, такая как ежедневные проверки |

316 316 

444Задана [переменная окружения](https://code.claude.com/docs/ru/env-vars.md#features-that-need-feature-flag-fetching), отключающая вычисление feature-флагов, и полное сообщение называет переменную, которую обнаружил Claude Code. В версиях до 2.1.154 та же конфигурация вместо этого выдаёт "Remote Control is not yet enabled for your account". Что делать, зависит от переменной, указанной в сообщении:444Задана [переменная окружения](https://code.claude.com/docs/ru/env-vars.md#features-that-need-feature-flag-fetching), отключающая вычисление feature-флагов, и полное сообщение называет переменную, которую обнаружил Claude Code. В версиях до 2.1.154 та же конфигурация вместо этого выдаёт "Remote Control is not yet enabled for your account". Что делать, зависит от переменной, указанной в сообщении:

445 445 

446* **`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` или `DISABLE_GROWTHBOOK`**: удалите (unset) переменную везде, где она задана, — в окружении вашей оболочки или в блоке `env` [файла `settings.json`](https://code.claude.com/docs/ru/settings-reference#all-settings).446* **`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` или `DISABLE_GROWTHBOOK`**: удалите (unset) переменную везде, где она задана, — в окружении вашей оболочки или в блоке `env` [файла `settings.json`](https://code.claude.com/docs/ru/settings-reference#all-settings).

447* **`DISABLE_TELEMETRY` или `DO_NOT_TRACK`**: на тарифе Pro, Max, Team или Enterprise при незаданной `DISABLE_GROWTHBOOK` эти переменные оставляют Remote Control доступным, если только ваша организация не требует [Trusted Devices](#trusted-devices). Если требует, удалите (unset) переменную везде, где она задана, чтобы использовать Remote Control. В версиях с v2.1.154 по v2.1.282 это сообщение появляется при заданной любой из этих переменных, поэтому обновите Claude Code до версии, соответствующей [требованию для этих переменных](#requirements).447* **`DISABLE_TELEMETRY` или `DO_NOT_TRACK`**: на тарифе Pro, Max, Ultra, Team или Enterprise при незаданной `DISABLE_GROWTHBOOK` эти переменные оставляют Remote Control доступным, если только ваша организация не требует [Trusted Devices](#trusted-devices). Если требует, удалите (unset) переменную везде, где она задана, чтобы использовать Remote Control. В версиях с v2.1.154 по v2.1.282 это сообщение появляется при заданной любой из этих переменных, поэтому обновите Claude Code до версии, соответствующей [требованию для этих переменных](#requirements).

448 448 

449### "Remote Control is only available when using Claude via api.anthropic.com"449### "Remote Control is only available when using Claude via api.anthropic.com"

450 450 

457Remote Control заблокирован политикой. Проверьте следующие причины по порядку:457Remote Control заблокирован политикой. Проверьте следующие причины по порядку:

458 458 

459* **В ошибке упоминается `disableRemoteControl`**: ваш ИТ-администратор отключил Remote Control на этом устройстве через [управляемые настройки](https://code.claude.com/docs/ru/managed-settings.md), независимо от переключателя на уровне организации и от того, как вы вошли.459* **В ошибке упоминается `disableRemoteControl`**: ваш ИТ-администратор отключил Remote Control на этом устройстве через [управляемые настройки](https://code.claude.com/docs/ru/managed-settings.md), независимо от переключателя на уровне организации и от того, как вы вошли.

460* **Ваш тариф claude.ai — Pro или Max**: Claude Code всё ещё авторизован под организацией Team или Enterprise после предыдущего входа, поэтому проверяет политику Remote Control этой организации. Выполните `/status`, чтобы увидеть, какой тариф и организацию использует ваш вход. Выполните `claude auth logout`, затем `claude auth login`, чтобы войти заново под текущим тарифом.460* **Ваш тариф claude.ai — Pro, Max или Ultra**: Claude Code всё ещё авторизован под организацией Team или Enterprise после предыдущего входа, поэтому проверяет политику Remote Control этой организации. Выполните `/status`, чтобы увидеть, какой тариф и организацию использует ваш вход. Выполните `claude auth logout`, затем `claude auth login`, чтобы войти заново под текущим тарифом.

461* **Сообщение не предлагает обратиться к администратору организации**: к вашей организации применена [конфигурация HIPAA](https://code.claude.com/docs/ru/hipaa-setup.md), которая отключает Remote Control. Чтобы убедиться в этом, выполните `/status` и найдите `HIPAA` в строке `Organization configuration`. Owner видит переключатель **Remote Control** неактивным в [настройках администратора](https://claude.ai/admin-settings/claude-code) и не может его включить. Если у вас есть вопросы о конфигурации, обратитесь к Owner, который может связаться с командой Anthropic, обслуживающей вашу организацию. До v2.1.267 в этом случае вместо этого показывалось "Remote Control isn't available for your organization due to its compliance policy".461* **Сообщение не предлагает обратиться к администратору организации**: к вашей организации применена [конфигурация HIPAA](https://code.claude.com/docs/ru/hipaa-setup.md), которая отключает Remote Control. Чтобы убедиться в этом, выполните `/status` и найдите `HIPAA` в строке `Organization configuration`. Owner видит переключатель **Remote Control** неактивным в [настройках администратора](https://claude.ai/admin-settings/claude-code) и не может его включить. Если у вас есть вопросы о конфигурации, обратитесь к Owner, который может связаться с командой Anthropic, обслуживающей вашу организацию. До v2.1.267 в этом случае вместо этого показывалось "Remote Control isn't available for your organization due to its compliance policy".

462* **Remote Control работает у других сотрудников вашей организации, но не у вас**: если ваша организация Enterprise управляет вашим доступом с помощью [пользовательских ролей](https://support.claude.com/en/articles/13930452), причиной могут быть ваши роли. Для Remote Control нужны и разрешение на облачные сессии, и разрешение **Claude Code remote control**. Попросите Owner проверить, включают ли ваши роли оба разрешения, и добавить недостающее в [**Organization settings > Roles**](https://claude.ai/admin-settings/roles).462* **Remote Control работает у других сотрудников вашей организации, но не у вас**: если ваша организация Enterprise управляет вашим доступом с помощью [пользовательских ролей](https://support.claude.com/en/articles/13930452), причиной могут быть ваши роли. Для Remote Control нужны и разрешение на облачные сессии, и разрешение **Claude Code remote control**. Попросите Owner проверить, включают ли ваши роли оба разрешения, и добавить недостающее в [**Organization settings > Roles**](https://claude.ai/admin-settings/roles).

463* **В остальных случаях Owner не включил его для вашей организации**: на тарифах Team и Enterprise Remote Control по умолчанию отключён. Owner может включить его на [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code), включив переключатель **Remote Control**. Этот переключатель — серверная настройка организации.463* **В остальных случаях Owner не включил его для вашей организации**: на тарифах Team и Enterprise Remote Control по умолчанию отключён. Owner может включить его на [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code), включив переключатель **Remote Control**. Этот переключатель — серверная настройка организации.

routines.md +11 −11

Details

25* Задача только с триггером API запускается, когда вы вызываете её эндпоинт.25* Задача только с триггером API запускается, когда вы вызываете её эндпоинт.

26* Задача только с триггером GitHub запускается, когда происходит соответствующее событие репозитория.26* Задача только с триггером GitHub запускается, когда происходит соответствующее событие репозитория.

27 27 

28Запланированные задачи доступны в планах Pro, Max, Team и Enterprise. Создавайте их и управляйте ими на [claude.ai/code/routines](https://claude.ai/code/routines) или из CLI с помощью `/schedule`. Прежнее название, routines, [по-прежнему встречается](#where-the-name-routines-still-appears).28Запланированные задачи доступны в планах Pro, Max, Ultra, Team и Enterprise. Создавайте их и управляйте ими на [claude.ai/code/routines](https://claude.ai/code/routines) или из CLI с помощью `/schedule`. Прежнее название, routines, [по-прежнему встречается](#where-the-name-routines-still-appears).

29 29 

30> [!NOTE]30> [!NOTE]

31>31>

85 85 

86В строке **Trigger** выберите, как запускается задача. Чтобы объединить несколько триггеров, нажмите **+** в конце строки.86В строке **Trigger** выберите, как запускается задача. Чтобы объединить несколько триггеров, нажмите **+** в конце строки.

87 87 

88**Schedule**88> [tab] Schedule

89 89>

90Выберите предустановленную частоту для повторяющегося запуска. См. [Добавление триггера расписания](#add-a-schedule-trigger), чтобы узнать об обработке часовых поясов, запоздалых запусках, пользовательских интервалах cron и однократных запусках.90> Выберите предустановленную частоту для повторяющегося запуска. См. [Добавление триггера расписания](#add-a-schedule-trigger), чтобы узнать об обработке часовых поясов, запоздалых запусках, пользовательских интервалах cron и однократных запусках.

91 

92**GitHub event**

93 

94Выберите репозиторий, событие, на которое нужно реагировать, и при необходимости фильтры. См. [Добавление триггера GitHub](#add-a-github-trigger) для полного списка поддерживаемых событий и полей фильтров.

95 91 

96**API**92> [tab] GitHub event

93>

94> Выберите репозиторий, событие, на которое нужно реагировать, и при необходимости фильтры. См. [Добавление триггера GitHub](#add-a-github-trigger) для полного списка поддерживаемых событий и полей фильтров.

97 95 

98Выберите здесь **API**. Когда вы нажмёте **Create**, диалоговое окно **API token** один раз покажет токен, поэтому скопируйте его, прежде чем закрыть окно. См. [Добавление триггера API](#add-an-api-trigger), чтобы скопировать URL или сгенерировать новый токен.96> [tab] API

97>

98> Выберите здесь **API**. Когда вы нажмёте **Create**, диалоговое окно **API token** один раз покажет токен, поэтому скопируйте его, прежде чем закрыть окно. См. [Добавление триггера API](#add-an-api-trigger), чтобы скопировать URL или сгенерировать новый токен.

99 99 

100**4. Выберите репозитории**100**4. Выберите репозитории**

101 101 

502* Owner [отключил запланированные задачи](#routines-are-disabled-by-your-organizations-policy) для вашей организации Team или Enterprise. До v2.1.227 в этом случае команда всё равно отображалась, а claude.ai отклонял задачу, когда Claude пытался создать или запустить её502* Owner [отключил запланированные задачи](#routines-are-disabled-by-your-organizations-policy) для вашей организации Team или Enterprise. До v2.1.227 в этом случае команда всё равно отображалась, а claude.ai отклонял задачу, когда Claude пытался создать или запустить её

503* Ваша организация Enterprise управляет вашим доступом с помощью [пользовательских ролей](https://support.claude.com/en/articles/13930452), и ни одна из ваших ролей не включает разрешение на запланированные задачи в разделе **Remote sessions**. Попросите Owner добавить его в одну из ваших ролей503* Ваша организация Enterprise управляет вашим доступом с помощью [пользовательских ролей](https://support.claude.com/en/articles/13930452), и ни одна из ваших ролей не включает разрешение на запланированные задачи в разделе **Remote sessions**. Попросите Owner добавить его в одну из ваших ролей

504 504 

505Если причина во входе в CLI или в том, что вы находитесь в облачной сессии, вы всё равно можете создавать запланированные задачи и управлять ими на [claude.ai/code/routines](https://claude.ai/code/routines). Для этого вам нужна учётная запись Pro, Max, Team или Enterprise. Если запланированные задачи или облачные сессии отключены для вашей организации или отсутствуют в ваших ролях, вы не сможете создать их и в веб-интерфейсе.505Если причина во входе в CLI или в том, что вы находитесь в облачной сессии, вы всё равно можете создавать запланированные задачи и управлять ими на [claude.ai/code/routines](https://claude.ai/code/routines). Для этого вам нужна учётная запись Pro, Max, Ultra, Team или Enterprise. Если запланированные задачи или облачные сессии отключены для вашей организации или отсутствуют в ваших ролях, вы не сможете создать их и в веб-интерфейсе.

506 506 

507### "Routines are disabled by your organization's policy"507### "Routines are disabled by your organization's policy"

508 508 

sandboxing.md +12 −12

Details

119 119 

120Установите их с помощью менеджера пакетов вашего дистрибутива:120Установите их с помощью менеджера пакетов вашего дистрибутива:

121 121 

122**Ubuntu/Debian**122> [tab] Ubuntu/Debian

123 123>

124```bash theme={null}124> ```bash theme={null}

125sudo apt-get install bubblewrap socat125> sudo apt-get install bubblewrap socat

126```126> ```

127 

128**Fedora**

129 127 

130```bash theme={null}128> [tab] Fedora

131sudo dnf install bubblewrap socat129>

132```130> ```bash theme={null}

131> sudo dnf install bubblewrap socat

132> ```

133 133 

134Когда зависимость отсутствует, вкладка Dependencies в `/sandbox` показывает, чего из `ripgrep`, `bubblewrap`, `socat` и фильтра seccomp не хватает на вашей платформе. Если после установки и перезапуска Claude Code вы не видите эту вкладку, все зависимости на месте.134Когда зависимость отсутствует, вкладка Dependencies в `/sandbox` показывает, чего из `ripgrep`, `bubblewrap`, `socat` и фильтра seccomp не хватает на вашей платформе. Если после установки и перезапуска Claude Code вы не видите эту вкладку, все зависимости на месте.

135 135 

137 137 

138Когда отсутствует обязательная зависимость, вкладка Dependencies остаётся единственной отображаемой вкладкой, пока вы её не установите. Когда отсутствует только необязательный фильтр seccomp, вкладка Dependencies отображается вместе с остальными вкладками. Проверка зависимостей выполняется при запуске, поэтому после установки пакетов перезапустите Claude Code, чтобы `/sandbox` их обнаружил.138Когда отсутствует обязательная зависимость, вкладка Dependencies остаётся единственной отображаемой вкладкой, пока вы её не установите. Когда отсутствует только необязательный фильтр seccomp, вкладка Dependencies отображается вместе с остальными вкладками. Проверка зависимостей выполняется при запуске, поэтому после установки пакетов перезапустите Claude Code, чтобы `/sandbox` их обнаружил.

139 139 

140> **Ubuntu 24.04 и новее: разрешите bubblewrap создавать пространства имён пользователей**140> [accordion] Ubuntu 24.04 и новее: разрешите bubblewrap создавать пространства имён пользователей

141>141>

142> В Ubuntu 24.04 и новее политика AppArmor по умолчанию не позволяет bubblewrap создавать пространства имён пользователей, необходимые ему для изоляции.142> В Ubuntu 24.04 и новее политика AppArmor по умолчанию не позволяет bubblewrap создавать пространства имён пользователей, необходимые ему для изоляции.

143>143>

161> sudo systemctl reload apparmor161> sudo systemctl reload apparmor

162> ```162> ```

163 163 

164> **Примечания для WSL2**164> [accordion] Примечания для WSL2

165>165>

166> Проверьте версию WSL с помощью `wsl -l -v` в PowerShell. Если вы видите `Sandboxing requires WSL2`, ваш дистрибутив работает на WSL1. Обновите его до WSL2 или запускайте Claude Code без изоляции в песочнице.166> Проверьте версию WSL с помощью `wsl -l -v` в PowerShell. Если вы видите `Sandboxing requires WSL2`, ваш дистрибутив работает на WSL1. Обновите его до WSL2 или запускайте Claude Code без изоляции в песочнице.

167>167>

security.md +1 −1

Details

53* Ограниченный доступ к данным сеанса пользователя53* Ограниченный доступ к данным сеанса пользователя

54* Контроль пользователя над предпочтениями обучения данных. Пользователи потребительских версий могут изменить свои [параметры конфиденциальности](https://claude.ai/settings/privacy) в любое время.54* Контроль пользователя над предпочтениями обучения данных. Пользователи потребительских версий могут изменить свои [параметры конфиденциальности](https://claude.ai/settings/privacy) в любое время.

55 55 

56Для полной информации, пожалуйста, ознакомьтесь с нашими [Коммерческими условиями обслуживания](https://www.anthropic.com/legal/commercial-terms) (для пользователей Team, Enterprise и API) или [Условиями для потребителей](https://www.anthropic.com/legal/consumer-terms) (для пользователей Free, Pro и Max) и [Политикой конфиденциальности](https://www.anthropic.com/legal/privacy).56Для полной информации, пожалуйста, ознакомьтесь с нашими [Коммерческими условиями обслуживания](https://www.anthropic.com/legal/commercial-terms) (для пользователей Team, Enterprise и API) или [Условиями для потребителей](https://www.anthropic.com/legal/consumer-terms) (для пользователей Free, Pro, Max и Ultra) и [Политикой конфиденциальности](https://www.anthropic.com/legal/privacy).

57 57 

58### Дополнительные защиты58### Дополнительные защиты

59 59 

Details

14 14 

15В самостоятельно размещаемом окружении эти же сессии выполняются внутри вашей сети. В остальном опыт разработчика остается прежним, за исключением различий, описанных в разделе [Доступность и ограничения](#availability-and-limitations), и [известных проблем](https://code.claude.com/docs/ru/self-hosted-environments-deploy.md#known-issues-and-limitations) на странице развертывания.15В самостоятельно размещаемом окружении эти же сессии выполняются внутри вашей сети. В остальном опыт разработчика остается прежним, за исключением различий, описанных в разделе [Доступность и ограничения](#availability-and-limitations), и [известных проблем](https://code.claude.com/docs/ru/self-hosted-environments-deploy.md#known-issues-and-limitations) на странице развертывания.

16 16 

17Если ваша команда не использует облачные сеансы, здесь нечего настраивать: сеансы в терминале или IDE всегда выполняются на собственной машине разработчика. Если вы хотите запустить Claude Code на собственной постоянно работающей машине и управлять ею с других устройств, используйте [Remote Control](https://code.claude.com/docs/ru/remote-control.md), который также доступен на планах Pro и Max. Когда вы будете готовы к настройке, переходите прямо к [быстрому старту](https://code.claude.com/docs/ru/self-hosted-environments-quickstart.md); чтобы сначала проверить позицию безопасности, начните с [Развертывание в production](https://code.claude.com/docs/ru/self-hosted-environments-deploy.md). Остальная часть этой страницы объясняет, как работает самостоятельное размещение и когда его выбирать.17* Если ваша команда не использует облачные сессии, здесь нечего настраивать: сессии в терминале или IDE всегда выполняются на собственной машине разработчика

18* Чтобы запустить Claude Code на собственной постоянно работающей машине и управлять ею с других устройств, используйте [Remote Control](https://code.claude.com/docs/ru/remote-control.md), который также доступен на планах Pro, Max и Ultra

19* Когда вы будете готовы к настройке, переходите прямо к [быстрому старту](https://code.claude.com/docs/ru/self-hosted-environments-quickstart.md); чтобы сначала проверить позицию безопасности, начните с [Развертывание в production](https://code.claude.com/docs/ru/self-hosted-environments-deploy.md)

20 

21Чтобы узнать, как работает самостоятельное размещение и когда его выбирать, прочитайте разделы [Как работают самостоятельно размещаемые окружения](#how-self-hosted-environments-work) и [Зачем использовать самостоятельное размещение](#why-self-host).

18 22 

19## Как работают самостоятельно размещаемые окружения23## Как работают самостоятельно размещаемые окружения

20 24 

Details

531 531 

532Запускайте эти runner с [`--confine-repo-settings enforce`](https://code.claude.com/docs/ru/self-hosted-environments-deploy#harden-your-deployment). Этот режим отклоняет сессии в репозиториях, закоммиченные настройки которых он помечает, поэтому сначала запустите runner в режиме по умолчанию `warn` и устраните то, что он записывает в лог.532Запускайте эти runner с [`--confine-repo-settings enforce`](https://code.claude.com/docs/ru/self-hosted-environments-deploy#harden-your-deployment). Этот режим отклоняет сессии в репозиториях, закоммиченные настройки которых он помечает, поэтому сначала запустите runner в режиме по умолчанию `warn` и устраните то, что он записывает в лог.

533 533 

534**Amazon Bedrock**534> [tab] Amazon Bedrock

535 535>

536Замените регион на свой:536> Замените регион на свой:

537 537>

538```bash theme={null}538> ```bash theme={null}

539export CLAUDE_CODE_USE_BEDROCK=1539> export CLAUDE_CODE_USE_BEDROCK=1

540export AWS_REGION=us-east-1540> export AWS_REGION=us-east-1

541```541> ```

542 542>

543О том, как Claude Code определяет регион, см. [Настройка Claude Code](https://code.claude.com/docs/ru/amazon-bedrock.md#3-configure-claude-code). О том, какой префикс профиля инференса Claude Code использует для вашего региона, см. [Префиксы межрегиональных профилей инференса](https://code.claude.com/docs/ru/amazon-bedrock.md#cross-region-inference-profile-prefixes).543> О том, как Claude Code определяет регион, см. [Настройка Claude Code](https://code.claude.com/docs/ru/amazon-bedrock.md#3-configure-claude-code). О том, какой префикс профиля инференса Claude Code использует для вашего региона, см. [Префиксы межрегиональных профилей инференса](https://code.claude.com/docs/ru/amazon-bedrock.md#cross-region-inference-profile-prefixes).

544 

545**Google Cloud's Agent Platform**

546 

547Замените регион и идентификатор проекта на свои:

548 

549```bash theme={null}

550export CLAUDE_CODE_USE_VERTEX=1

551export CLOUD_ML_REGION=global

552export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-ID

553```

554 544 

555О выборе региона см. [Конфигурация региона](https://code.claude.com/docs/ru/google-vertex-ai.md#region-configuration).545> [tab] Google Cloud's Agent Platform

546>

547> Замените регион и идентификатор проекта на свои:

548>

549> ```bash theme={null}

550> export CLAUDE_CODE_USE_VERTEX=1

551> export CLOUD_ML_REGION=global

552> export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-ID

553> ```

554>

555> О выборе региона см. [Конфигурация региона](https://code.claude.com/docs/ru/google-vertex-ai.md#region-configuration).

556 556 

557**4. Убедитесь, что переменные дошли до сессии**557**4. Убедитесь, что переменные дошли до сессии**

558 558 

Details

90 90 

91Проверки напрямую соответствуют стандартным библиотекам JWT. Примеры ниже реализуют полную последовательность в Node.js с [`jose`](https://www.npmjs.com/package/jose), которая обрабатывает получение JWKS, кэширование и выбор `kid`, и в Python с [`PyJWT`](https://pyjwt.readthedocs.io/) и его встроенным клиентом JWKS.91Проверки напрямую соответствуют стандартным библиотекам JWT. Примеры ниже реализуют полную последовательность в Node.js с [`jose`](https://www.npmjs.com/package/jose), которая обрабатывает получение JWKS, кэширование и выбор `kid`, и в Python с [`PyJWT`](https://pyjwt.readthedocs.io/) и его встроенным клиентом JWKS.

92 92 

93**Node.js (jose)**93> [tab] Node.js (jose)

94 94>

95```typescript theme={null}95> ```typescript theme={null}

96import { createRemoteJWKSet, jwtVerify } from "jose";96> import { createRemoteJWKSet, jwtVerify } from "jose";

97 97>

98const JWKS = createRemoteJWKSet(98> const JWKS = createRemoteJWKSet(

99 new URL("https://api.anthropic.com/v1/code/.well-known/jwks.json")99> new URL("https://api.anthropic.com/v1/code/.well-known/jwks.json")

100);100> );

101 101>

102const PREFIX = "sk-ant-cc-";102> const PREFIX = "sk-ant-cc-";

103const EXPECTED_POOL_ID = "ccpool_...";103> const EXPECTED_POOL_ID = "ccpool_...";

104 104>

105export async function verifySessionToken(raw: string) {105> export async function verifySessionToken(raw: string) {

106 if (!raw.startsWith(PREFIX)) {106> if (!raw.startsWith(PREFIX)) {

107 throw new Error("not a self-hosted runner session token");107> throw new Error("not a self-hosted runner session token");

108 }108> }

109 const jwt = raw.slice(PREFIX.length);109> const jwt = raw.slice(PREFIX.length);

110 110>

111 const { payload } = await jwtVerify(jwt, JWKS, {111> const { payload } = await jwtVerify(jwt, JWKS, {

112 issuer: "ccr",112> issuer: "ccr",

113 audience: EXPECTED_POOL_ID,113> audience: EXPECTED_POOL_ID,

114 algorithms: ["ES256"],114> algorithms: ["ES256"],

115 });115> });

116 116>

117 if (payload["ccr:role"] !== "session_worker") {117> if (payload["ccr:role"] !== "session_worker") {

118 throw new Error("token is not a session_worker token");118> throw new Error("token is not a session_worker token");

119 }119> }

120 120>

121 const act = payload.act as { email?: string; sub?: string };121> const act = payload.act as { email?: string; sub?: string };

122 return {122> return {

123 sessionId: payload["ccr:session_id"] as string,123> sessionId: payload["ccr:session_id"] as string,

124 poolId: payload["ccr:pool_id"] as string,124> poolId: payload["ccr:pool_id"] as string,

125 orgId: payload["ccr:org_id"] as string,125> orgId: payload["ccr:org_id"] as string,

126 creatorEmail: act?.email,126> creatorEmail: act?.email,

127 creatorSub: act?.sub,127> creatorSub: act?.sub,

128 };128> };

129}129> }

130```130> ```

131 131 

132**Python (PyJWT)**132> [tab] Python (PyJWT)

133 133>

134```python theme={null}134> ```python theme={null}

135import jwt135> import jwt

136from jwt import PyJWKClient136> from jwt import PyJWKClient

137 137>

138JWKS_URL = "https://api.anthropic.com/v1/code/.well-known/jwks.json"138> JWKS_URL = "https://api.anthropic.com/v1/code/.well-known/jwks.json"

139PREFIX = "sk-ant-cc-"139> PREFIX = "sk-ant-cc-"

140EXPECTED_POOL_ID = "ccpool_..."140> EXPECTED_POOL_ID = "ccpool_..."

141 141>

142jwks = PyJWKClient(JWKS_URL)142> jwks = PyJWKClient(JWKS_URL)

143 143>

144 144>

145def verify_session_token(raw: str) -> dict:145> def verify_session_token(raw: str) -> dict:

146 if not raw.startswith(PREFIX):146> if not raw.startswith(PREFIX):

147 raise ValueError("not a self-hosted runner session token")147> raise ValueError("not a self-hosted runner session token")

148 token = raw.removeprefix(PREFIX)148> token = raw.removeprefix(PREFIX)

149 149>

150 signing_key = jwks.get_signing_key_from_jwt(token)150> signing_key = jwks.get_signing_key_from_jwt(token)

151 payload = jwt.decode(151> payload = jwt.decode(

152 token,152> token,

153 signing_key.key,153> signing_key.key,

154 algorithms=["ES256"],154> algorithms=["ES256"],

155 issuer="ccr",155> issuer="ccr",

156 audience=EXPECTED_POOL_ID,156> audience=EXPECTED_POOL_ID,

157 )157> )

158 158>

159 if payload.get("ccr:role") != "session_worker":159> if payload.get("ccr:role") != "session_worker":

160 raise ValueError("token is not a session_worker token")160> raise ValueError("token is not a session_worker token")

161 161>

162 act = payload.get("act") or {}162> act = payload.get("act") or {}

163 return {163> return {

164 "session_id": payload["ccr:session_id"],164> "session_id": payload["ccr:session_id"],

165 "pool_id": payload["ccr:pool_id"],165> "pool_id": payload["ccr:pool_id"],

166 "org_id": payload["ccr:org_id"],166> "org_id": payload["ccr:org_id"],

167 "creator_email": act.get("email"),167> "creator_email": act.get("email"),

168 "creator_sub": act.get("sub"),168> "creator_sub": act.get("sub"),

169 }169> }

170```170> ```

171 171 

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

173 173 

sessions.md +1 −1

Details

95 95 

96Если при возобновлении сессии вы видите диалоговое окно «Resume this conversation?», его оценка показывает долю вашего 5-часового лимита использования, которую израсходует один только сохранённый диалог. Оценка не учитывает то, что вы уже использовали.96Если при возобновлении сессии вы видите диалоговое окно «Resume this conversation?», его оценка показывает долю вашего 5-часового лимита использования, которую израсходует один только сохранённый диалог. Оценка не учитывает то, что вы уже использовали.

97 97 

98На планах Pro и Max это диалоговое окно может появиться, когда вы возобновляете длинный диалог [после длительного перерыва](https://code.claude.com/docs/ru/prompt-caching.md#resuming-a-session) или на другой модели. Расчётный расход происходит, когда вы отправляете первое сообщение после **Resume**, а не в момент выбора этого варианта. Выбирайте в зависимости от того, нужен ли вашей следующей задаче сохранённый диалог:98На планах Pro, Max и Ultra это диалоговое окно может появиться, когда вы возобновляете длинный диалог [после длительного перерыва](https://code.claude.com/docs/ru/prompt-caching.md#resuming-a-session) или на другой модели. Расчётный расход происходит, когда вы отправляете первое сообщение после **Resume**, а не в момент выбора этого варианта. Выбирайте в зависимости от того, нужен ли вашей следующей задаче сохранённый диалог:

99 99 

100* **Resume**: продолжить работу в сохранённом диалоге.100* **Resume**: продолжить работу в сохранённом диалоге.

101* **Start a new conversation**: переключиться на работу, которой не нужен сохранённый диалог. Чтобы позже снова открыть его, выполните [`/resume`](#use-the-session-picker) в промпте. Оценка не применяется к вашему первому сообщению в новом диалоге. Если в этом варианте указано, что Claude может найти этот диалог, вы всё равно можете ссылаться на предыдущую работу в новом диалоге.101* **Start a new conversation**: переключиться на работу, которой не нужен сохранённый диалог. Чтобы позже снова открыть его, выполните [`/resume`](#use-the-session-picker) в промпте. Оценка не применяется к вашему первому сообщению в новом диалоге. Если в этом варианте указано, что Claude может найти этот диалог, вы всё равно можете ссылаться на предыдущую работу в новом диалоге.

settings-example.md +325 −325

Details

20 20 

21Личные параметры одного разработчика. Он выбирает модель и уровень усилий, настраивает терминал и предварительно одобряет команду только для чтения и одно чтение файла. Все остальное сохраняет значения по умолчанию. Файл, подобный этому, находится в `~/.claude/settings.json`, где он применяется к каждому проекту, который вы открываете.21Личные параметры одного разработчика. Он выбирает модель и уровень усилий, настраивает терминал и предварительно одобряет команду только для чтения и одно чтение файла. Все остальное сохраняет значения по умолчанию. Файл, подобный этому, находится в `~/.claude/settings.json`, где он применяется к каждому проекту, который вы открываете.

22 22 

23**Copyable settings file**23> [tab] Copyable settings file

24 24>

25Сохраните это как `~/.claude/settings.json`. Это корректный JSON без комментариев, поэтому вы можете вставить его как есть и удалить ненужные ключи.25> Сохраните это как `~/.claude/settings.json`. Это корректный JSON без комментариев, поэтому вы можете вставить его как есть и удалить ненужные ключи.

26 26>

27```json ~/.claude/settings.json theme={null}27> ```json ~/.claude/settings.json theme={null}

28{28> {

29 "model": "claude-sonnet-5",29> "model": "claude-sonnet-5",

30 "modelSettings": {30> "modelSettings": {

31 "claude-sonnet-5": { "effortLevel": "xhigh" }31> "claude-sonnet-5": { "effortLevel": "xhigh" }

32 },32> },

33 "editorMode": "vim",33> "editorMode": "vim",

34 "theme": "light-daltonized",34> "theme": "light-daltonized",

35 "statusLine": {35> "statusLine": {

36 "type": "command",36> "type": "command",

37 "command": "jq -r '\"[\\(.model.display_name)] \\(.context_window.used_percentage // 0)% context\"'",37> "command": "jq -r '\"[\\(.model.display_name)] \\(.context_window.used_percentage // 0)% context\"'",

38 "padding": 238> "padding": 2

39 },39> },

40 "spinnerTipsEnabled": false,40> "spinnerTipsEnabled": false,

41 "preferredNotifChannel": "terminal_bell",41> "preferredNotifChannel": "terminal_bell",

42 "permissions": {42> "permissions": {

43 "allow": [43> "allow": [

44 "Bash(git diff *)",44> "Bash(git diff *)",

45 "Read(~/.zshrc)"45> "Read(~/.zshrc)"

46 ]46> ]

47 },47> },

48 "autoUpdatesChannel": "stable",48> "autoUpdatesChannel": "stable",

49 "cleanupPeriodDays": 2049> "cleanupPeriodDays": 20

50}50> }

51```51> ```

52 52 

53**What each key does**53> [tab] What each key does

54 54>

55Тот же файл с комментарием над каждым ключом. Прочитайте его здесь; копируйте с другой вкладки, потому что Claude Code не принимает комментарии в файле параметров.55> Тот же файл с комментарием над каждым ключом. Прочитайте его здесь; копируйте с другой вкладки, потому что Claude Code не принимает комментарии в файле параметров.

56 56>

57```jsonc ~/.claude/settings.json theme={null}57> ```jsonc ~/.claude/settings.json theme={null}

58{58> {

59 // Начинайте каждый сеанс на Sonnet 559> // Начинайте каждый сеанс на Sonnet 5

60 "model": "claude-sonnet-5",60> "model": "claude-sonnet-5",

61 // Запускайте Sonnet 5 выше его уровня по умолчанию; /effort сохраняет уровень для каждой модели, а --effort устанавливает уровень для одного сеанса61> // Запускайте Sonnet 5 выше его уровня по умолчанию; /effort сохраняет уровень для каждой модели, а --effort устанавливает уровень для одного сеанса

62 "modelSettings": {62> "modelSettings": {

63 "claude-sonnet-5": { "effortLevel": "xhigh" }63> "claude-sonnet-5": { "effortLevel": "xhigh" }

64 },64> },

65 // Сочетания клавиш Vim в приглашении65> // Сочетания клавиш Vim в приглашении

66 "editorMode": "vim",66> "editorMode": "vim",

67 // Светлая тема, удобная для дальтоников67> // Светлая тема, удобная для дальтоников

68 "theme": "light-daltonized",68> "theme": "light-daltonized",

69 // Строка состояния под приглашением: имя модели и использованный контекст69> // Строка состояния под приглашением: имя модели и использованный контекст

70 "statusLine": {70> "statusLine": {

71 "type": "command",71> "type": "command",

72 "command": "jq -r '\"[\\(.model.display_name)] \\(.context_window.used_percentage // 0)% context\"'",72> "command": "jq -r '\"[\\(.model.display_name)] \\(.context_window.used_percentage // 0)% context\"'",

73 "padding": 273> "padding": 2

74 },74> },

75 // Скройте советы, которые вращаются под спиннером75> // Скройте советы, которые вращаются под спиннером

76 "spinnerTipsEnabled": false,76> "spinnerTipsEnabled": false,

77 // Звоните в колокольчик терминала для уведомлений, таких как завершенная задача или ожидающее приглашение разрешения77> // Звоните в колокольчик терминала для уведомлений, таких как завершенная задача или ожидающее приглашение разрешения

78 "preferredNotifChannel": "terminal_bell",78> "preferredNotifChannel": "terminal_bell",

79 // Позвольте Claude Code запускать git diff и читать ваш .zshrc без запроса79> // Позвольте Claude Code запускать git diff и читать ваш .zshrc без запроса

80 "permissions": {80> "permissions": {

81 "allow": [81> "allow": [

82 "Bash(git diff *)",82> "Bash(git diff *)",

83 "Read(~/.zshrc)"83> "Read(~/.zshrc)"

84 ]84> ]

85 },85> },

86 // Получайте обновления из стабильного канала86> // Получайте обновления из стабильного канала

87 "autoUpdatesChannel": "stable",87> "autoUpdatesChannel": "stable",

88 // Удалите стенограммы сеансов и другие локальные данные сеансов старше 20 дней88> // Удалите стенограммы сеансов и другие локальные данные сеансов старше 20 дней

89 "cleanupPeriodDays": 2089> "cleanupPeriodDays": 20

90}90> }

91```91> ```

92 92 

93## Общие параметры команды93## Общие параметры команды

94 94 

100* **Hook — это скрипт в репозитории.** Hook этого файла запускает `.claude/hooks/block-rm.sh`; [How a hook resolves](https://code.claude.com/docs/ru/hooks.md#how-a-hook-resolves) описывает, как его написать.100* **Hook — это скрипт в репозитории.** Hook этого файла запускает `.claude/hooks/block-rm.sh`; [How a hook resolves](https://code.claude.com/docs/ru/hooks.md#how-a-hook-resolves) описывает, как его написать.

101* **Правила соответствуют команде и пути в том виде, в котором они написаны.** `Bash(git push *)` не соответствует [`git -C . push`](https://code.claude.com/docs/ru/permissions#bash-rule-limits). `Read(./.env)` само по себе останавливает инструменты файлов и команды, которые называют файл, такие как `cat .env`, но не [`grep -r`, запущенный по каталогу](https://code.claude.com/docs/ru/permissions#read-and-edit); блок `sandbox` в этом файле закрывает этот пробел, потому что sandbox [добавляет ваши пути `Read` deny](https://code.claude.com/docs/ru/settings-reference#sandbox-filesystem-denyread) к тому, что не может читать каждая команда в sandbox.101* **Правила соответствуют команде и пути в том виде, в котором они написаны.** `Bash(git push *)` не соответствует [`git -C . push`](https://code.claude.com/docs/ru/permissions#bash-rule-limits). `Read(./.env)` само по себе останавливает инструменты файлов и команды, которые называют файл, такие как `cat .env`, но не [`grep -r`, запущенный по каталогу](https://code.claude.com/docs/ru/permissions#read-and-edit); блок `sandbox` в этом файле закрывает этот пробел, потому что sandbox [добавляет ваши пути `Read` deny](https://code.claude.com/docs/ru/settings-reference#sandbox-filesystem-denyread) к тому, что не может читать каждая команда в sandbox.

102 102 

103**Copyable settings file**103> [tab] Copyable settings file

104 104>

105Сохраните это как `.claude/settings.json` в верхней части репозитория и зафиксируйте. Это корректный JSON без комментариев, поэтому вы можете вставить его как есть и удалить ненужные ключи.105> Сохраните это как `.claude/settings.json` в верхней части репозитория и зафиксируйте. Это корректный JSON без комментариев, поэтому вы можете вставить его как есть и удалить ненужные ключи.

106 106>

107```json .claude/settings.json theme={null}107> ```json .claude/settings.json theme={null}

108{108> {

109 "permissions": {109> "permissions": {

110 "allow": [110> "allow": [

111 "Bash(npm run *)"111> "Bash(npm run *)"

112 ],112> ],

113 "ask": [113> "ask": [

114 "Bash(git push *)"114> "Bash(git push *)"

115 ],115> ],

116 "deny": [116> "deny": [

117 "Read(./.env)",117> "Read(./.env)",

118 "Read(./.env.*)",118> "Read(./.env.*)",

119 "Read(./secrets/**)"119> "Read(./secrets/**)"

120 ]120> ]

121 },121> },

122 "hooks": {122> "hooks": {

123 "PreToolUse": [123> "PreToolUse": [

124 {124> {

125 "matcher": "Bash",125> "matcher": "Bash",

126 "hooks": [126> "hooks": [

127 {127> {

128 "type": "command",128> "type": "command",

129 "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/block-rm.sh"129> "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/block-rm.sh"

130 }130> }

131 ]131> ]

132 }132> }

133 ]133> ]

134 },134> },

135 "extraKnownMarketplaces": {135> "extraKnownMarketplaces": {

136 "acme-tools": {136> "acme-tools": {

137 "source": {137> "source": {

138 "source": "github",138> "source": "github",

139 "repo": "acme-corp/claude-plugins"139> "repo": "acme-corp/claude-plugins"

140 }140> }

141 }141> }

142 },142> },

143 "enabledPlugins": {143> "enabledPlugins": {

144 "code-formatter@acme-tools": true144> "code-formatter@acme-tools": true

145 },145> },

146 "sandbox": {146> "sandbox": {

147 "enabled": true,147> "enabled": true,

148 "filesystem": {148> "filesystem": {

149 "allowWrite": [149> "allowWrite": [

150 "/tmp/build"150> "/tmp/build"

151 ]151> ]

152 },152> },

153 "network": {153> "network": {

154 "allowedDomains": [154> "allowedDomains": [

155 "registry.npmjs.org",155> "registry.npmjs.org",

156 "*.example.com"156> "*.example.com"

157 ]157> ]

158 }158> }

159 },159> },

160 "plansDirectory": "./plans"160> "plansDirectory": "./plans"

161}161> }

162```162> ```

163 163 

164**What each key does**164> [tab] What each key does

165 165>

166Тот же файл с комментарием над каждым ключом. Прочитайте его здесь; копируйте с другой вкладки, потому что Claude Code не принимает комментарии в файле параметров.166> Тот же файл с комментарием над каждым ключом. Прочитайте его здесь; копируйте с другой вкладки, потому что Claude Code не принимает комментарии в файле параметров.

167 167>

168```jsonc .claude/settings.json theme={null}168> ```jsonc .claude/settings.json theme={null}

169{169> {

170 "permissions": {170> "permissions": {

171 // Запускайте скрипты npm без запроса171> // Запускайте скрипты npm без запроса

172 "allow": [172> "allow": [

173 "Bash(npm run *)"173> "Bash(npm run *)"

174 ],174> ],

175 // Подтвердите перед командами git push175> // Подтвердите перед командами git push

176 "ask": [176> "ask": [

177 "Bash(git push *)"177> "Bash(git push *)"

178 ],178> ],

179 // Запретите чтение файлов env и папки secrets инструментами файлов и командами чтения файлов179> // Запретите чтение файлов env и папки secrets инструментами файлов и командами чтения файлов

180 "deny": [180> "deny": [

181 "Read(./.env)",181> "Read(./.env)",

182 "Read(./.env.*)",182> "Read(./.env.*)",

183 "Read(./secrets/**)"183> "Read(./secrets/**)"

184 ]184> ]

185 },185> },

186 // Перед каждой командой Bash запустите скрипт в репозитории, который может ее заблокировать186> // Перед каждой командой Bash запустите скрипт в репозитории, который может ее заблокировать

187 "hooks": {187> "hooks": {

188 "PreToolUse": [188> "PreToolUse": [

189 {189> {

190 "matcher": "Bash",190> "matcher": "Bash",

191 "hooks": [191> "hooks": [

192 {192> {

193 "type": "command",193> "type": "command",

194 "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/block-rm.sh"194> "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/block-rm.sh"

195 }195> }

196 ]196> ]

197 }197> }

198 ]198> ]

199 },199> },

200 // Зарегистрируйте маркетплейс плагинов команды при каждом клонировании200> // Зарегистрируйте маркетплейс плагинов команды при каждом клонировании

201 "extraKnownMarketplaces": {201> "extraKnownMarketplaces": {

202 "acme-tools": {202> "acme-tools": {

203 "source": {203> "source": {

204 "source": "github",204> "source": "github",

205 "repo": "acme-corp/claude-plugins"205> "repo": "acme-corp/claude-plugins"

206 }206> }

207 }207> }

208 },208> },

209 // Включите один плагин из этого маркетплейса; плагин из внешнего источника, такого как репозиторий GitHub, все еще требует, чтобы каждый человек установил его один раз209> // Включите один плагин из этого маркетплейса; плагин из внешнего источника, такого как репозиторий GitHub, все еще требует, чтобы каждый человек установил его один раз

210 "enabledPlugins": {210> "enabledPlugins": {

211 "code-formatter@acme-tools": true211> "code-formatter@acme-tools": true

212 },212> },

213 // Команды в песочнице: папка сборки с правом записи; npm и example.com предварительно разрешены213> // Команды в песочнице: папка сборки с правом записи; npm и example.com предварительно разрешены

214 "sandbox": {214> "sandbox": {

215 "enabled": true,215> "enabled": true,

216 "filesystem": {216> "filesystem": {

217 "allowWrite": [217> "allowWrite": [

218 "/tmp/build"218> "/tmp/build"

219 ]219> ]

220 },220> },

221 "network": {221> "network": {

222 "allowedDomains": [222> "allowedDomains": [

223 "registry.npmjs.org",223> "registry.npmjs.org",

224 "*.example.com"224> "*.example.com"

225 ]225> ]

226 }226> }

227 },227> },

228 // Держите файлы плана внутри репозитория228> // Держите файлы плана внутри репозитория

229 "plansDirectory": "./plans"229> "plansDirectory": "./plans"

230}230> }

231```231> ```

232 232 

233## Управляемые параметры организации233## Управляемые параметры организации

234 234 

247 247 

248Администраторы развертывают файл, подобный этому, как `managed-settings.json`, или тот же JSON через MDM или [параметры, управляемые сервером](https://code.claude.com/docs/ru/server-managed-settings.md). Один развернутый файл применяется к каждой машине или учетной записи, которую он достигает. Чтобы дать группе разные значения, разверните другой файл или профиль для этой группы, так как [параметры, управляемые сервером, еще не поддерживают политику для каждой группы](https://code.claude.com/docs/ru/server-managed-settings.md#current-limitations).248Администраторы развертывают файл, подобный этому, как `managed-settings.json`, или тот же JSON через MDM или [параметры, управляемые сервером](https://code.claude.com/docs/ru/server-managed-settings.md). Один развернутый файл применяется к каждой машине или учетной записи, которую он достигает. Чтобы дать группе разные значения, разверните другой файл или профиль для этой группы, так как [параметры, управляемые сервером, еще не поддерживают политику для каждой группы](https://code.claude.com/docs/ru/server-managed-settings.md#current-limitations).

249 249 

250**Copyable settings file**250> [tab] Copyable settings file

251 251>

252Разверните это как `managed-settings.json`, или тот же JSON через MDM или консоль claude.ai. Это корректный JSON без комментариев; замените пример UUID организации, URL сервера и marketplace на свои и удалите ненужные ключи.252> Разверните это как `managed-settings.json`, или тот же JSON через MDM или консоль claude.ai. Это корректный JSON без комментариев; замените пример UUID организации, URL сервера и marketplace на свои и удалите ненужные ключи.

253 253>

254```json managed-settings.json theme={null}254> ```json managed-settings.json theme={null}

255{255> {

256 "forceLoginMethod": "claudeai",256> "forceLoginMethod": "claudeai",

257 "forceLoginOrgUUID": [257> "forceLoginOrgUUID": [

258 "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"258> "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

259 ],259> ],

260 "availableModels": [260> "availableModels": [

261 "opus",261> "opus",

262 "sonnet"262> "sonnet"

263 ],263> ],

264 "enforceAvailableModels": true,264> "enforceAvailableModels": true,

265 "permissions": {265> "permissions": {

266 "deny": [266> "deny": [

267 "Bash(curl *)",267> "Bash(curl *)",

268 "Read(./.env)",268> "Read(./.env)",

269 "Read(./secrets/**)"269> "Read(./secrets/**)"

270 ],270> ],

271 "disableBypassPermissionsMode": "disable"271> "disableBypassPermissionsMode": "disable"

272 },272> },

273 "allowManagedPermissionRulesOnly": true,273> "allowManagedPermissionRulesOnly": true,

274 "allowedMcpServers": [274> "allowedMcpServers": [

275 {275> {

276 "serverUrl": "https://api.githubcopilot.com/*"276> "serverUrl": "https://api.githubcopilot.com/*"

277 }277> }

278 ],278> ],

279 "allowManagedMcpServersOnly": true,279> "allowManagedMcpServersOnly": true,

280 "strictKnownMarketplaces": [280> "strictKnownMarketplaces": [

281 {281> {

282 "source": "github",282> "source": "github",

283 "repo": "acme-corp/approved-plugins"283> "repo": "acme-corp/approved-plugins"

284 }284> }

285 ],285> ],

286 "sandbox": {286> "sandbox": {

287 "enabled": true,287> "enabled": true,

288 "failIfUnavailable": true,288> "failIfUnavailable": true,

289 "allowUnsandboxedCommands": false,289> "allowUnsandboxedCommands": false,

290 "network": {290> "network": {

291 "allowedDomains": [291> "allowedDomains": [

292 "registry.npmjs.org",292> "registry.npmjs.org",

293 "github.com"293> "github.com"

294 ],294> ],

295 "allowManagedDomainsOnly": true295> "allowManagedDomainsOnly": true

296 }296> }

297 },297> },

298 "requiredMinimumVersion": "2.1.150",298> "requiredMinimumVersion": "2.1.150",

299 "cleanupPeriodDays": 7,299> "cleanupPeriodDays": 7,

300 "companyAnnouncements": [300> "companyAnnouncements": [

301 "Welcome to Acme Corp! Review our code guidelines at docs.example.com"301> "Welcome to Acme Corp! Review our code guidelines at docs.example.com"

302 ]302> ]

303}303> }

304```304> ```

305 305 

306**What each key does**306> [tab] What each key does

307 307>

308Тот же файл с комментарием над каждым ключом. Прочитайте его здесь; копируйте с другой вкладки, потому что Claude Code не принимает комментарии в файле параметров.308> Тот же файл с комментарием над каждым ключом. Прочитайте его здесь; копируйте с другой вкладки, потому что Claude Code не принимает комментарии в файле параметров.

309 309>

310```jsonc managed-settings.json theme={null}310> ```jsonc managed-settings.json theme={null}

311{311> {

312 // Только входы claude.ai и только в этой организации312> // Только входы claude.ai и только в этой организации

313 "forceLoginMethod": "claudeai",313> "forceLoginMethod": "claudeai",

314 "forceLoginOrgUUID": [314> "forceLoginOrgUUID": [

315 "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"315> "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

316 ],316> ],

317 // Только модели Opus и Sonnet; с enforceAvailableModels опция Default также соблюдает список317> // Только модели Opus и Sonnet; с enforceAvailableModels опция Default также соблюдает список

318 "availableModels": [318> "availableModels": [

319 "opus",319> "opus",

320 "sonnet"320> "sonnet"

321 ],321> ],

322 "enforceAvailableModels": true,322> "enforceAvailableModels": true,

323 "permissions": {323> "permissions": {

324 // Запретите команды curl и чтение файла .env проекта и папки secrets на каждой машине324> // Запретите команды curl и чтение файла .env проекта и папки secrets на каждой машине

325 "deny": [325> "deny": [

326 "Bash(curl *)",326> "Bash(curl *)",

327 "Read(./.env)",327> "Read(./.env)",

328 "Read(./secrets/**)"328> "Read(./secrets/**)"

329 ],329> ],

330 // Удалите режим обхода разрешений из каждого сеанса330> // Удалите режим обхода разрешений из каждого сеанса

331 "disableBypassPermissionsMode": "disable"331> "disableBypassPermissionsMode": "disable"

332 },332> },

333 // Игнорируйте правила разрешений из параметров пользователя, проекта и локальных параметров333> // Игнорируйте правила разрешений из параметров пользователя, проекта и локальных параметров

334 "allowManagedPermissionRulesOnly": true,334> "allowManagedPermissionRulesOnly": true,

335 // Только MCP сервер GitHub, сопоставленный по URL, а не по имени, так как пользователь может335> // Только MCP сервер GitHub, сопоставленный по URL, а не по имени, так как пользователь может

336 // назвать любой сервер "github". Добавленные пользователем серверы, которые не совпадают, не загружаются, включая336> // назвать любой сервер "github". Добавленные пользователем серверы, которые не совпадают, не загружаются, включая

337 // каждый stdio сервер, когда список содержит только записи URL. Ключ allowManagedMcpServersOnly337> // каждый stdio сервер, когда список содержит только записи URL. Ключ allowManagedMcpServersOnly

338 // ниже делает этот управляемый список единственным применяемым списком разрешений338> // ниже делает этот управляемый список единственным применяемым списком разрешений

339 "allowedMcpServers": [339> "allowedMcpServers": [

340 {340> {

341 "serverUrl": "https://api.githubcopilot.com/*"341> "serverUrl": "https://api.githubcopilot.com/*"

342 }342> }

343 ],343> ],

344 "allowManagedMcpServersOnly": true,344> "allowManagedMcpServersOnly": true,

345 // Плагины могут поступать только из этого marketplace345> // Плагины могут поступать только из этого marketplace

346 "strictKnownMarketplaces": [346> "strictKnownMarketplaces": [

347 {347> {

348 "source": "github",348> "source": "github",

349 "repo": "acme-corp/approved-plugins"349> "repo": "acme-corp/approved-plugins"

350 }350> }

351 ],351> ],

352 // Поместите каждую команду Claude в sandbox, откажитесь запускаться, если sandbox не может быть352> // Поместите каждую команду Claude в sandbox, откажитесь запускаться, если sandbox не может быть

353 // установлен, и никогда не позволяйте заблокированной команде повторить попытку вне sandbox; сеть353> // установлен, и никогда не позволяйте заблокированной команде повторить попытку вне sandbox; сеть

354 // ограничена npm и GitHub, и пользователи не могут добавлять домены354> // ограничена npm и GitHub, и пользователи не могут добавлять домены

355 "sandbox": {355> "sandbox": {

356 "enabled": true,356> "enabled": true,

357 "failIfUnavailable": true,357> "failIfUnavailable": true,

358 "allowUnsandboxedCommands": false,358> "allowUnsandboxedCommands": false,

359 "network": {359> "network": {

360 "allowedDomains": [360> "allowedDomains": [

361 "registry.npmjs.org",361> "registry.npmjs.org",

362 "github.com"362> "github.com"

363 ],363> ],

364 "allowManagedDomainsOnly": true364> "allowManagedDomainsOnly": true

365 }365> }

366 },366> },

367 // Откажитесь запускаться на версиях старше 2.1.150367> // Откажитесь запускаться на версиях старше 2.1.150

368 "requiredMinimumVersion": "2.1.150",368> "requiredMinimumVersion": "2.1.150",

369 // Удалите стенограммы сеансов и другие локальные данные сеансов через 7 дней369> // Удалите стенограммы сеансов и другие локальные данные сеансов через 7 дней

370 "cleanupPeriodDays": 7,370> "cleanupPeriodDays": 7,

371 // Сообщение, которое видит каждый пользователь при запуске371> // Сообщение, которое видит каждый пользователь при запуске

372 "companyAnnouncements": [372> "companyAnnouncements": [

373 "Welcome to Acme Corp! Review our code guidelines at docs.example.com"373> "Welcome to Acme Corp! Review our code guidelines at docs.example.com"

374 ]374> ]

375}375> }

376```376> ```

Details

3865* **Type**: Boolean3865* **Type**: Boolean

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

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

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

3869 3869 

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

3871{3871{

setup.md +251 −251

Details

35 35 

36Для установки Claude Code откройте терминал и выполните команду для вашей системы. Если вы раньше не использовали терминал, [руководство по терминалу](https://code.claude.com/docs/ru/terminal-guide) показывает, как его открыть и вставить команду.36Для установки Claude Code откройте терминал и выполните команду для вашей системы. Если вы раньше не использовали терминал, [руководство по терминалу](https://code.claude.com/docs/ru/terminal-guide) показывает, как его открыть и вставить команду.

37 37 

38**Встроенная установка (рекомендуется)**38> [tab] Встроенная установка (рекомендуется)

39 

40**macOS, Linux, WSL:**

41 

42```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

43curl -fsSL https://claude.ai/install.sh | bash

44```

45 

46В Windows приглашение командной строки показывает `PS C:\`, когда вы находитесь в PowerShell, и `C:\` без `PS`, когда вы находитесь в CMD.

47 

48**Windows PowerShell:**

49 

50```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

51irm https://claude.ai/install.ps1 | iex

52```

53 

54**Windows CMD:**

55 

56```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

57curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

58```

59 

60Команда установки не показывает прогресс во время загрузки Claude Code. Когда установщик завершит работу, откройте новое окно терминала и выполните `claude --version`. Работающая установка выводит номер версии. Если ваша оболочка говорит, что `claude` не найден или не распознан, каталог установки еще не находится в вашем PATH: см. [Исправьте ваш PATH](https://code.claude.com/docs/ru/troubleshoot-install.md#command-not-found-claude-after-installation).

61 

62Если вы видите `The token '&&' is not a valid statement separator`, вы находитесь в PowerShell, а не в CMD. Если вы видите `'irm' is not recognized as an internal or external command`, вы находитесь в CMD, а не в PowerShell.

63 

64Если команда установки завершается с ошибкой `syntax error near unexpected token '<'`, `403` или любой другой ошибкой, см. [Устранение неполадок при установке](https://code.claude.com/docs/ru/troubleshoot-install.md#find-your-error), чтобы сопоставить ошибку с исправлением и для альтернативных методов установки.

65 

66[Git for Windows](https://git-scm.com/downloads/win) рекомендуется на встроенной Windows, чтобы Claude Code мог использовать инструмент Bash. Если Git for Windows не установлен, Claude Code использует PowerShell в качестве инструмента оболочки. Установки WSL не требуют Git for Windows.

67 

68> [!NOTE]

69>39>

70> Встроенные установки автоматически обновляются в фоновом режиме, чтобы вы всегда использовали последнюю версию.40> **macOS, Linux, WSL:**

71 

72**Homebrew**

73 

74```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

75brew install --cask claude-code

76```

77 

78Homebrew предлагает два пакета. `claude-code` отслеживает канал стабильного выпуска, который обычно отстает примерно на неделю и пропускает выпуски с серьезными регрессиями. `claude-code@latest` отслеживает последний канал и получает новые версии сразу после их выпуска.

79 

80> [!NOTE]

81>41>

82> Установки Homebrew не обновляются автоматически. Запустите `brew upgrade claude-code` или `brew upgrade claude-code@latest`, в зависимости от того, какой пакет вы установили, чтобы получить последние функции и исправления безопасности.42> ```bash theme={null}

83 43> curl -fsSL https://claude.ai/install.sh | bash

84**WinGet**44> ```

45>

46> В Windows приглашение командной строки показывает `PS C:\`, когда вы находитесь в PowerShell, и `C:\` без `PS`, когда вы находитесь в CMD.

47>

48> **Windows PowerShell:**

49>

50> ```powershell theme={null}

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

52> ```

53>

54> **Windows CMD:**

55>

56> ```batch theme={null}

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

58> ```

59>

60> Команда установки не показывает прогресс во время загрузки Claude Code. Когда установщик завершит работу, откройте новое окно терминала и выполните `claude --version`. Работающая установка выводит номер версии. Если ваша оболочка говорит, что `claude` не найден или не распознан, каталог установки еще не находится в вашем PATH: см. [Исправьте ваш PATH](https://code.claude.com/docs/ru/troubleshoot-install.md#command-not-found-claude-after-installation).

61>

62> Если вы видите `The token '&&' is not a valid statement separator`, вы находитесь в PowerShell, а не в CMD. Если вы видите `'irm' is not recognized as an internal or external command`, вы находитесь в CMD, а не в PowerShell.

63>

64> Если команда установки завершается с ошибкой `syntax error near unexpected token '<'`, `403` или любой другой ошибкой, см. [Устранение неполадок при установке](https://code.claude.com/docs/ru/troubleshoot-install.md#find-your-error), чтобы сопоставить ошибку с исправлением и для альтернативных методов установки.

65>

66> [Git for Windows](https://git-scm.com/downloads/win) рекомендуется на встроенной Windows, чтобы Claude Code мог использовать инструмент Bash. Если Git for Windows не установлен, Claude Code использует PowerShell в качестве инструмента оболочки. Установки WSL не требуют Git for Windows.

67>

68> > [!NOTE]

69> >

70> > Встроенные установки автоматически обновляются в фоновом режиме, чтобы вы всегда использовали последнюю версию.

85 71 

86```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}72> [tab] Homebrew

87winget install Anthropic.ClaudeCode73>

88```74> ```bash theme={null}

75> brew install --cask claude-code

76> ```

77>

78> Homebrew предлагает два пакета. `claude-code` отслеживает канал стабильного выпуска, который обычно отстает примерно на неделю и пропускает выпуски с серьезными регрессиями. `claude-code@latest` отслеживает последний канал и получает новые версии сразу после их выпуска.

79>

80> > [!NOTE]

81> >

82> > Установки Homebrew не обновляются автоматически. Запустите `brew upgrade claude-code` или `brew upgrade claude-code@latest`, в зависимости от того, какой пакет вы установили, чтобы получить последние функции и исправления безопасности.

89 83 

90> [!NOTE]84> [tab] WinGet

85>

86> ```powershell theme={null}

87> winget install Anthropic.ClaudeCode

88> ```

91>89>

92> Установки WinGet не обновляются автоматически. Периодически запускайте `winget upgrade Anthropic.ClaudeCode` чтобы получить последние функции и исправления безопасности.90> > [!NOTE]

91> >

92> > Установки WinGet не обновляются автоматически. Периодически запускайте `winget upgrade Anthropic.ClaudeCode` чтобы получить последние функции и исправления безопасности.

93 93 

94Вы также можете установить с помощью [apt, dnf или apk](https://code.claude.com/docs/ru/setup.md#install-with-linux-package-managers) на Debian, Fedora, RHEL и Alpine.94Вы также можете установить с помощью [apt, dnf или apk](https://code.claude.com/docs/ru/setup.md#install-with-linux-package-managers) на Debian, Fedora, RHEL и Alpine.

95 95 

188 188 

189## Аутентификация189## Аутентификация

190 190 

191Claude Code требует учетную запись Pro, Max, Team, Enterprise или Console. Бесплатный план claude.ai не включает доступ к Claude Code. Вы также можете использовать Claude Code с поставщиком API третьей стороны, таким как [Amazon Bedrock](https://code.claude.com/docs/ru/amazon-bedrock.md), [Google Cloud's Agent Platform](https://code.claude.com/docs/ru/google-vertex-ai.md) или [Microsoft Foundry](https://code.claude.com/docs/ru/microsoft-foundry.md).191Claude Code требует учетную запись Pro, Max, Ultra, Team, Enterprise или Console. Бесплатный план claude.ai не включает доступ к Claude Code. Вы также можете использовать Claude Code с поставщиком API третьей стороны, таким как [Amazon Bedrock](https://code.claude.com/docs/ru/amazon-bedrock.md), [Google Cloud's Agent Platform](https://code.claude.com/docs/ru/google-vertex-ai.md) или [Microsoft Foundry](https://code.claude.com/docs/ru/microsoft-foundry.md).

192 192 

193После установки войдите, выполнив `claude` и следуя инструкциям в браузере. Если вы установили переменную окружения `ANTHROPIC_API_KEY` и одобрите ключ, когда Claude Code спросит, использовать ли его, Claude Code пропустит запрос на вход. См. [Аутентификация](https://code.claude.com/docs/ru/authentication.md) для всех типов учетных записей и параметров настройки команды.193После установки войдите, выполнив `claude` и следуя инструкциям в браузере. Если вы установили переменную окружения `ANTHROPIC_API_KEY` и одобрите ключ, когда Claude Code спросит, использовать ли его, Claude Code пропустит запрос на вход. См. [Аутентификация](https://code.claude.com/docs/ru/authentication.md) для всех типов учетных записей и параметров настройки команды.

194 194 

300 300 

301Для установки последней версии (по умолчанию):301Для установки последней версии (по умолчанию):

302 302 

303**macOS, Linux, WSL**303> [tab] macOS, Linux, WSL

304 304>

305```bash theme={null}305> ```bash theme={null}

306curl -fsSL https://claude.ai/install.sh | bash306> curl -fsSL https://claude.ai/install.sh | bash

307```307> ```

308 

309**Windows PowerShell**

310 

311```powershell theme={null}

312irm https://claude.ai/install.ps1 | iex

313```

314 308 

315**Windows CMD**309> [tab] Windows PowerShell

310>

311> ```powershell theme={null}

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

313> ```

316 314 

317```batch theme={null}315> [tab] Windows CMD

318curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd316>

319```317> ```batch theme={null}

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

319> ```

320 320 

321Для установки стабильной версии:321Для установки стабильной версии:

322 322 

323**macOS, Linux, WSL**323> [tab] macOS, Linux, WSL

324 324>

325```bash theme={null}325> ```bash theme={null}

326curl -fsSL https://claude.ai/install.sh | bash -s stable326> curl -fsSL https://claude.ai/install.sh | bash -s stable

327```327> ```

328 

329**Windows PowerShell**

330 

331```powershell theme={null}

332& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable

333```

334 328 

335**Windows CMD**329> [tab] Windows PowerShell

330>

331> ```powershell theme={null}

332> & ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable

333> ```

336 334 

337```batch theme={null}335> [tab] Windows CMD

338curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd stable && del install.cmd336>

339```337> ```batch theme={null}

338> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd stable && del install.cmd

339> ```

340 340 

341Для установки определенного номера версии:341Для установки определенного номера версии:

342 342 

343**macOS, Linux, WSL**343> [tab] macOS, Linux, WSL

344 344>

345```bash theme={null}345> ```bash theme={null}

346curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89346> curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89

347```347> ```

348 

349**Windows PowerShell**

350 

351```powershell theme={null}

352& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89

353```

354 348 

355**Windows CMD**349> [tab] Windows PowerShell

350>

351> ```powershell theme={null}

352> & ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89

353> ```

356 354 

357```batch theme={null}355> [tab] Windows CMD

358curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd 2.1.89 && del install.cmd356>

359```357> ```batch theme={null}

358> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd 2.1.89 && del install.cmd

359> ```

360 360 

361Чтобы подтвердить установленную версию, выполните `claude --version`: команда выводит точную версию, которую вы передали, например `2.1.89 (Claude Code)`.361Чтобы подтвердить установленную версию, выполните `claude --version`: команда выводит точную версию, которую вы передали, например `2.1.89 (Claude Code)`.

362 362 

366 366 

367Все репозитории подписаны с помощью [ключа подписи выпуска Claude Code](#binary-integrity-and-code-signing). Перед доверием к ключу проверьте его, как описано в каждой вкладке.367Все репозитории подписаны с помощью [ключа подписи выпуска Claude Code](#binary-integrity-and-code-signing). Перед доверием к ключу проверьте его, как описано в каждой вкладке.

368 368 

369**apt**369> [tab] apt

370 370>

371Для Debian и Ubuntu. Команды установки ниже загружают ключ подписи с помощью `curl` и проверяют его с помощью `gpg`, которые свежие установки Debian и Ubuntu могут не включать. Если любая команда сообщает `command not found`, сначала установите оба:371> Для Debian и Ubuntu. Команды установки ниже загружают ключ подписи с помощью `curl` и проверяют его с помощью `gpg`, которые свежие установки Debian и Ubuntu могут не включать. Если любая команда сообщает `command not found`, сначала установите оба:

372 372>

373```bash theme={null}373> ```bash theme={null}

374sudo apt install curl gnupg374> sudo apt install curl gnupg

375```375> ```

376 376>

377Загрузите ключ подписи:377> Загрузите ключ подписи:

378 378>

379```bash theme={null}379> ```bash theme={null}

380sudo install -d -m 0755 /etc/apt/keyrings380> sudo install -d -m 0755 /etc/apt/keyrings

381sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc \381> sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc \

382 -o /etc/apt/keyrings/claude-code.asc382> -o /etc/apt/keyrings/claude-code.asc

383```383> ```

384 384>

385Если эта загрузка не удается, `apt update` позже не удается с `NO_PUBKEY BAA929FF1A7ECACE`. Подтвердите, что ключ загружен и принадлежит Anthropic перед продолжением:385> Если эта загрузка не удается, `apt update` позже не удается с `NO_PUBKEY BAA929FF1A7ECACE`. Подтвердите, что ключ загружен и принадлежит Anthropic перед продолжением:

386 386>

387```bash theme={null}387> ```bash theme={null}

388gpg --show-keys /etc/apt/keyrings/claude-code.asc388> gpg --show-keys /etc/apt/keyrings/claude-code.asc

389```389> ```

390 390>

391Отпечаток, который выводит gpg, должен быть `31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE`. Если gpg сообщает, что файл не может быть открыт или не содержит действительных данных OpenPGP, загрузка не удалась или вернула неправильное содержимое: подтвердите, что ваша сеть может достичь `downloads.claude.ai`, затем повторно выполните команду загрузки.391> Отпечаток, который выводит gpg, должен быть `31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE`. Если gpg сообщает, что файл не может быть открыт или не содержит действительных данных OpenPGP, загрузка не удалась или вернула неправильное содержимое: подтвердите, что ваша сеть может достичь `downloads.claude.ai`, затем повторно выполните команду загрузки.

392 392>

393Зарегистрируйте репозиторий на канале `stable` и установите:393> Зарегистрируйте репозиторий на канале `stable` и установите:

394 394>

395```bash theme={null}395> ```bash theme={null}

396echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" \396> echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" \

397 | sudo tee /etc/apt/sources.list.d/claude-code.list397> | sudo tee /etc/apt/sources.list.d/claude-code.list

398sudo apt update398> sudo apt update

399sudo apt install claude-code399> sudo apt install claude-code

400```400> ```

401 401>

402Чтобы вместо этого использовать канал `latest`, оба пути URL и имя suite изменяются. Используйте эту строку `deb`:402> Чтобы вместо этого использовать канал `latest`, оба пути URL и имя suite изменяются. Используйте эту строку `deb`:

403 403>

404```bash theme={null}404> ```bash theme={null}

405echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/latest latest main" \405> echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/latest latest main" \

406 | sudo tee /etc/apt/sources.list.d/claude-code.list406> | sudo tee /etc/apt/sources.list.d/claude-code.list

407```407> ```

408 408>

409Для обновления позже выполните `sudo apt update && sudo apt upgrade claude-code`.409> Для обновления позже выполните `sudo apt update && sudo apt upgrade claude-code`.

410 

411**dnf**

412 

413Для Fedora и RHEL. Следующие команды настраивают канал `stable`:

414 

415```bash theme={null}

416sudo tee /etc/yum.repos.d/claude-code.repo <<'EOF'

417[claude-code]

418name=Claude Code

419baseurl=https://downloads.claude.ai/claude-code/rpm/stable

420enabled=1

421gpgcheck=1

422gpgkey=https://downloads.claude.ai/keys/claude-code.asc

423EOF

424sudo dnf install claude-code

425```

426 

427Чтобы вместо этого использовать канал `latest`, установите `baseurl` на репозиторий `latest`:

428 

429```ini theme={null}

430baseurl=https://downloads.claude.ai/claude-code/rpm/latest

431```

432 

433dnf загружает ключ при первой установке и предлагает вам подтвердить отпечаток. Проверьте, что он совпадает с `31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE` перед принятием.

434 

435Для обновления позже выполните `sudo dnf upgrade claude-code`.

436 

437**apk**

438 

439Для Alpine Linux. Следующие команды настраивают канал `stable`:

440 

441```sh theme={null}

442wget -O /etc/apk/keys/claude-code.rsa.pub \

443 https://downloads.claude.ai/keys/claude-code.rsa.pub

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

445apk add claude-code

446```

447 

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

449 

450```sh theme={null}

451sed -i '\|downloads.claude.ai/claude-code/apk/stable|d' /etc/apk/repositories

452echo "https://downloads.claude.ai/claude-code/apk/latest" >> /etc/apk/repositories

453```

454 410 

455Проверьте загруженный ключ с помощью `sha256sum /etc/apk/keys/claude-code.rsa.pub`, который должен сообщить `395759c1f7449ef4cdef305a42e820f3c766d6090d142634ebdb049f113168b6`.411> [tab] dnf

412>

413> Для Fedora и RHEL. Следующие команды настраивают канал `stable`:

414>

415> ```bash theme={null}

416> sudo tee /etc/yum.repos.d/claude-code.repo <<'EOF'

417> [claude-code]

418> name=Claude Code

419> baseurl=https://downloads.claude.ai/claude-code/rpm/stable

420> enabled=1

421> gpgcheck=1

422> gpgkey=https://downloads.claude.ai/keys/claude-code.asc

423> EOF

424> sudo dnf install claude-code

425> ```

426>

427> Чтобы вместо этого использовать канал `latest`, установите `baseurl` на репозиторий `latest`:

428>

429> ```ini theme={null}

430> baseurl=https://downloads.claude.ai/claude-code/rpm/latest

431> ```

432>

433> dnf загружает ключ при первой установке и предлагает вам подтвердить отпечаток. Проверьте, что он совпадает с `31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE` перед принятием.

434>

435> Для обновления позже выполните `sudo dnf upgrade claude-code`.

456 436 

457Для обновления позже выполните `apk update && apk upgrade claude-code`.437> [tab] apk

438>

439> Для Alpine Linux. Следующие команды настраивают канал `stable`:

440>

441> ```sh theme={null}

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

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

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

445> apk add claude-code

446> ```

447>

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

449>

450> ```sh theme={null}

451> sed -i '\|downloads.claude.ai/claude-code/apk/stable|d' /etc/apk/repositories

452> echo "https://downloads.claude.ai/claude-code/apk/latest" >> /etc/apk/repositories

453> ```

454>

455> Проверьте загруженный ключ с помощью `sha256sum /etc/apk/keys/claude-code.rsa.pub`, который должен сообщить `395759c1f7449ef4cdef305a42e820f3c766d6090d142634ebdb049f113168b6`.

456>

457> Для обновления позже выполните `apk update && apk upgrade claude-code`.

458 458 

459### Установка с npm459### Установка с npm

460 460 

546 546 

547Сравните контрольную сумму SHA256 двоичного файла со значением, указанным в `platforms.<platform>.checksum` в `manifest.json`. Приведенные ниже команды предполагают двоичный файл `claude` в текущем каталоге. Чтобы вместо этого проверить установленный встроенный двоичный файл, выполните команду для `~/.local/share/claude/versions/VERSION`, заменив VERSION на выпуск, который вы установили на шаге 2.547Сравните контрольную сумму SHA256 двоичного файла со значением, указанным в `platforms.<platform>.checksum` в `manifest.json`. Приведенные ниже команды предполагают двоичный файл `claude` в текущем каталоге. Чтобы вместо этого проверить установленный встроенный двоичный файл, выполните команду для `~/.local/share/claude/versions/VERSION`, заменив VERSION на выпуск, который вы установили на шаге 2.

548 548 

549**Linux**549> [tab] Linux

550 550>

551```bash theme={null}551> ```bash theme={null}

552sha256sum claude552> sha256sum claude

553```553> ```

554 

555**macOS**

556 

557```bash theme={null}

558shasum -a 256 claude

559```

560 554 

561**Windows PowerShell**555> [tab] macOS

556>

557> ```bash theme={null}

558> shasum -a 256 claude

559> ```

562 560 

563```powershell theme={null}561> [tab] Windows PowerShell

564(Get-FileHash claude.exe -Algorithm SHA256).Hash.ToLower()562>

565```563> ```powershell theme={null}

564> (Get-FileHash claude.exe -Algorithm SHA256).Hash.ToLower()

565> ```

566 566 

567> [!NOTE]567> [!NOTE]

568>568>

584 584 

585Удалите двоичный файл Claude Code и файлы версии:585Удалите двоичный файл Claude Code и файлы версии:

586 586 

587**macOS, Linux, WSL**587> [tab] macOS, Linux, WSL

588 588>

589```bash theme={null}589> ```bash theme={null}

590rm -f ~/.local/bin/claude590> rm -f ~/.local/bin/claude

591rm -rf ~/.local/share/claude591> rm -rf ~/.local/share/claude

592```592> ```

593 

594**Windows PowerShell**

595 593 

596```powershell theme={null}594> [tab] Windows PowerShell

597Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force595>

598Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force596> ```powershell theme={null}

599```597> Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force

598> Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

599> ```

600 600 

601### Удаление с помощью Homebrew601### Удаление с помощью Homebrew

602 602 

624 624 

625Удалите пакет и конфигурацию репозитория:625Удалите пакет и конфигурацию репозитория:

626 626 

627**apt**627> [tab] apt

628 628>

629```bash theme={null}629> ```bash theme={null}

630sudo apt remove claude-code630> sudo apt remove claude-code

631sudo rm /etc/apt/sources.list.d/claude-code.list /etc/apt/keyrings/claude-code.asc631> sudo rm /etc/apt/sources.list.d/claude-code.list /etc/apt/keyrings/claude-code.asc

632```632> ```

633 

634**dnf**

635 

636```bash theme={null}

637sudo dnf remove claude-code

638sudo rm /etc/yum.repos.d/claude-code.repo

639```

640 633 

641**apk**634> [tab] dnf

635>

636> ```bash theme={null}

637> sudo dnf remove claude-code

638> sudo rm /etc/yum.repos.d/claude-code.repo

639> ```

642 640 

643```sh theme={null}641> [tab] apk

644apk del claude-code642>

645sed -i '\|downloads.claude.ai/claude-code/apk|d' /etc/apk/repositories643> ```sh theme={null}

646rm /etc/apk/keys/claude-code.rsa.pub644> apk del claude-code

647```645> sed -i '\|downloads.claude.ai/claude-code/apk|d' /etc/apk/repositories

646> rm /etc/apk/keys/claude-code.rsa.pub

647> ```

648 648 

649### Удаление с помощью npm649### Удаление с помощью npm

650 650 

664 664 

665Чтобы удалить параметры Claude Code и кэшированные данные:665Чтобы удалить параметры Claude Code и кэшированные данные:

666 666 

667**macOS, Linux, WSL**667> [tab] macOS, Linux, WSL

668 668>

669```bash theme={null}669> ```bash theme={null}

670# Удаление пользовательских параметров и состояния670> # Удаление пользовательских параметров и состояния

671rm -rf ~/.claude671> rm -rf ~/.claude

672rm ~/.claude.json672> rm ~/.claude.json

673 673>

674# Удаление параметров для конкретного проекта (выполните из каталога вашего проекта)674> # Удаление параметров для конкретного проекта (выполните из каталога вашего проекта)

675rm -rf .claude675> rm -rf .claude

676rm -f .mcp.json676> rm -f .mcp.json

677```677> ```

678 

679**Windows PowerShell**

680 

681```powershell theme={null}

682# Удаление пользовательских параметров и состояния

683Remove-Item -Path "$env:USERPROFILE\.claude" -Recurse -Force

684Remove-Item -Path "$env:USERPROFILE\.claude.json" -Force

685 678 

686# Удаление параметров для конкретного проекта (выполните из каталога вашего проекта)679> [tab] Windows PowerShell

687Remove-Item -Path ".claude" -Recurse -Force680>

688Remove-Item -Path ".mcp.json" -Force681> ```powershell theme={null}

689```682> # Удаление пользовательских параметров и состояния

683> Remove-Item -Path "$env:USERPROFILE\.claude" -Recurse -Force

684> Remove-Item -Path "$env:USERPROFILE\.claude.json" -Force

685>

686> # Удаление параметров для конкретного проекта (выполните из каталога вашего проекта)

687> Remove-Item -Path ".claude" -Recurse -Force

688> Remove-Item -Path ".mcp.json" -Force

689> ```

skills.md +1 −1

Details

42* **Расширения**: неиспользуемые skills, MCP-серверы и плагины в сравнении с их затратами контекста, а также медленные [хуки](https://code.claude.com/docs/ru/hooks.md)42* **Расширения**: неиспользуемые skills, MCP-серверы и плагины в сравнении с их затратами контекста, а также медленные [хуки](https://code.claude.com/docs/ru/hooks.md)

43* **Файлы `CLAUDE.md`**: локальные файлы `CLAUDE.md`, дублирующие файлы из репозитория, [содержимое `CLAUDE.md` в репозитории, которое Claude мог бы вывести из кодовой базы](https://code.claude.com/docs/ru/memory#my-claude-md-is-too-large), а также оставшиеся всегда загружаемые указания, которые Claude предлагает перенести в skills и вложенные файлы `CLAUDE.md`, загружаемые по требованию43* **Файлы `CLAUDE.md`**: локальные файлы `CLAUDE.md`, дублирующие файлы из репозитория, [содержимое `CLAUDE.md` в репозитории, которое Claude мог бы вывести из кодовой базы](https://code.claude.com/docs/ru/memory#my-claude-md-is-too-large), а также оставшиеся всегда загружаемые указания, которые Claude предлагает перенести в skills и вложенные файлы `CLAUDE.md`, загружаемые по требованию

44* **Разрешения**: предложение сделать [авторежим](https://code.claude.com/docs/ru/permissions.md#permission-modes) вашим режимом разрешений по умолчанию и [заранее одобрить](https://code.claude.com/docs/ru/permissions.md) команды только для чтения, которые вы часто отклоняете44* **Разрешения**: предложение сделать [авторежим](https://code.claude.com/docs/ru/permissions.md#permission-modes) вашим режимом разрешений по умолчанию и [заранее одобрить](https://code.claude.com/docs/ru/permissions.md) команды только для чтения, которые вы часто отклоняете

45* **Использование**: на тарифах Pro, Max, Team или Enterprise — [изменения, которые рекомендует `/usage`](https://code.claude.com/docs/ru/costs#plan-usage-breakdown), чтобы снизить использование вашего тарифа, измеренное за последние 7 дней. Claude предлагает изменения, которые может внести сам, а остальное сообщает в виде советов, например команды, которую нужно выполнить вам. Проверка использования требует Claude Code v2.1.305 или позже, и `/doctor` пропускает её, пока подключен [Remote Control](https://code.claude.com/docs/ru/remote-control.md).45* **Использование**: на тарифах Pro, Max, Ultra, Team или Enterprise — [изменения, которые рекомендует `/usage`](https://code.claude.com/docs/ru/costs#plan-usage-breakdown), чтобы снизить использование вашего тарифа, измеренное за последние 7 дней. Claude предлагает изменения, которые может внести сам, а остальное сообщает в виде советов, например команды, которую нужно выполнить вам. Проверка использования требует Claude Code v2.1.305 или позже, и `/doctor` пропускает её, пока подключен [Remote Control](https://code.claude.com/docs/ru/remote-control.md).

46 46 

47Для диагностики установки только для чтения без запуска сессии выполните вместо этого `claude doctor` в терминале.47Для диагностики установки только для чтения без запуска сессии выполните вместо этого `claude doctor` в терминале.

48 48 

slack.md +11 −11

Details

4 4 

5# Claude Code в Slack5# Claude Code в Slack

6 6 

7> Делегируйте задачи кодирования из Slack. Эта более ранняя версия отвечает на упоминания в каналах только от учетных записей Pro и Max в рабочих пространствах, не подключенных к Claude Tag.7> Делегируйте задачи кодирования из Slack. Эта более ранняя версия отвечает на упоминания только от учетных записей Pro, Max и Ultra в рабочих пространствах, не подключенных к Claude Tag.

8 8 

9> [!WARNING]9> [!WARNING]

10>10>

11> На этой странице документируется более ранняя версия Claude Code в Slack, которая запускает каждую сессию под учетной записью отдельного пользователя. Она отвечает на @упоминания в каналах только от учетных записей Pro и Max и только в рабочем пространстве Slack, которое ни одна организация не подключила к [Claude Tag](https://claude.com/product/tag). Claude Tag запускает @Claude как общую идентичность вашей организации с доступом, настроенным администратором.11> Эта более ранняя версия Claude Code в Slack отвечает на @упоминания в каналах только от учетных записей Pro, Max и Ultra и только в рабочем пространстве Slack, которое ни одна организация не подключила к [Claude Tag](https://claude.com/product/tag). Каждая сессия запускается под учетной записью отдельного пользователя. Claude Tag запускает @Claude как общую идентичность вашей организации с доступом, настроенным администратором.

12>12>

13> * **Планы Pro и Max:** Claude Tag недоступен в индивидуальных планах, поэтому эта страница остается путем настройки в рабочем пространстве, не подключенном к Claude Tag.13> * **Планы Pro, Max и Ultra:** Claude Tag недоступен в индивидуальных планах, поэтому [настройте эту версию](#setting-up-claude-code-in-slack) в рабочем пространстве, не подключенном к Claude Tag.

14> * **Планы Team и Enterprise:** ваше существующее приложение Slack и дескриптор @Claude сохраняются. [Настройте Claude Tag](https://claude.com/docs/claude-tag/overview) для нового рабочего пространства; чтобы перенести то, которое уже использует эту версию, см. [Миграция с более ранней версии Claude в Slack](https://claude.com/docs/claude-tag/admins/migrate-from-earlier).14> * **Планы Team и Enterprise:** ваше существующее приложение Slack и дескриптор @Claude сохраняются. [Настройте Claude Tag](https://claude.com/docs/claude-tag/overview) для нового рабочего пространства; чтобы перенести то, которое уже использует эту версию, см. [Миграция с более ранней версии Claude в Slack](https://claude.com/docs/claude-tag/admins/migrate-from-earlier).

15> * **Уведомление вместо ответа:** найдите [уведомление о настройке](#this-workspace-isnt-set-up-for-claude-tag-yet) или [уведомление о прекращении работы](#the-legacy-claude-in-slack-bot-is-retired), которым ответил @Claude.15> * **Уведомление вместо ответа:** найдите [уведомление о настройке](#this-workspace-isnt-set-up-for-claude-tag-yet) или [уведомление о прекращении работы](#the-legacy-claude-in-slack-bot-is-retired), которым ответил @Claude.

16 16 

31 31 

32| Требование | Детали |32| Требование | Детали |

33| :- | :- |33| :- | :- |

34| План Claude | Pro или Max |34| План Claude | Pro, Max или Ultra |

35| Рабочее пространство Slack | Не подключено к [Claude Tag](https://claude.com/docs/claude-tag/overview) ни одной организацией. Если @Claude отвечает [уведомлением о выводе из эксплуатации](#the-legacy-claude-in-slack-bot-is-retired), значит, рабочее пространство подключено |35| Рабочее пространство Slack | Не подключено к [Claude Tag](https://claude.com/docs/claude-tag/overview) ни одной организацией. Если @Claude отвечает [уведомлением о выводе из эксплуатации](#the-legacy-claude-in-slack-bot-is-retired), значит, рабочее пространство подключено |

36| Облачные сессии | [Облачные сессии](https://code.claude.com/docs/ru/claude-code-on-the-web.md) включены для вашей учетной записи |36| Облачные сессии | [Облачные сессии](https://code.claude.com/docs/ru/claude-code-on-the-web.md) включены для вашей учетной записи |

37| Учетная запись GitHub | Подключена к [claude.ai/code](https://claude.ai/code) с по крайней мере одним аутентифицированным репозиторием |37| Учетная запись GitHub | Подключена к [claude.ai/code](https://claude.ai/code) с по крайней мере одним аутентифицированным репозиторием |

178@Claude отвечает в ветке этим уведомлением вместо ответа, когда выполняются оба условия:178@Claude отвечает в ветке этим уведомлением вместо ответа, когда выполняются оба условия:

179 179 

180* Ни одна организация не подключила ваше рабочее пространство Slack к [Claude Tag](https://claude.com/docs/claude-tag/overview).180* Ни одна организация не подключила ваше рабочее пространство Slack к [Claude Tag](https://claude.com/docs/claude-tag/overview).

181* Учетная запись Claude, которую вы привязали в Slack, не использует план Pro или Max.181* Учетная запись Claude, которую вы привязали в Slack, не использует план Pro, Max или Ultra.

182 182 

183Claude Tag доступен на планах Team и Enterprise. Чтобы подключить рабочее пространство, начните с команды `@Claude connect`, указанной в уведомлении, а затем следуйте инструкциям в разделе [Настройка Claude Tag](https://claude.com/docs/claude-tag/overview).183Claude Tag доступен на планах Team и Enterprise. Чтобы подключить рабочее пространство, начните с команды `@Claude connect`, указанной в уведомлении, а затем следуйте инструкциям в разделе [Настройка Claude Tag](https://claude.com/docs/claude-tag/overview).

184 184 

185### "The legacy Claude in Slack bot is retired"185### "The legacy Claude in Slack bot is retired"

186 186 

187Уведомление начинается с `The legacy Claude in Slack bot is retired effective October 5, 2026 and no longer responds in channels.` Ваше рабочее пространство Slack подключено к организации Claude, а в настройках Claude Tag этой организации для канала, рабочего пространства или значения по умолчанию организации по-прежнему выбрана предыдущая версия. Уведомление не зависит от вашего собственного плана, поэтому его получают и учетные записи Pro и Max.187Уведомление начинается с `The legacy Claude in Slack bot is retired effective October 5, 2026 and no longer responds in channels.` Ваше рабочее пространство Slack подключено к организации Claude, а в настройках Claude Tag этой организации для канала, рабочего пространства или значения по умолчанию организации по-прежнему выбрана предыдущая версия. Уведомление не зависит от вашего собственного плана, поэтому его получают и учетные записи Pro, Max и Ultra.

188 188 

189Если вы являетесь Owner этой организации, откройте [настройки администратора Claude](https://claude.ai/admin-settings/claude-tag) и включите Claude Tag для канала. Чтобы исправить все каналы, наследующие эту настройку, измените ее на уровне рабочего пространства или значения по умолчанию организации. Полное описание перехода см. в разделе [Миграция с предыдущей версии Claude in Slack](https://claude.com/docs/claude-tag/admins/migrate-from-earlier). Если вы не являетесь Owner, отправьте эту запись одному из них.189Если вы являетесь Owner этой организации, откройте [настройки администратора Claude](https://claude.ai/admin-settings/claude-tag) и включите Claude Tag для канала. Чтобы исправить все каналы, наследующие эту настройку, измените ее на уровне рабочего пространства или значения по умолчанию организации. Полное описание перехода см. в разделе [Миграция с предыдущей версии Claude in Slack](https://claude.com/docs/claude-tag/admins/migrate-from-earlier). Если вы не являетесь Owner, отправьте эту запись одному из них.

190 190 

235 235 

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

237 237 

238> **[Claude Code в облаке](https://code.claude.com/docs/ru/claude-code-on-the-web.md)**238> [card] [Claude Code в облаке](https://code.claude.com/docs/ru/claude-code-on-the-web.md)

239>239>

240> Узнайте больше о облачных сеансах240> Узнайте больше о облачных сеансах

241 241 

242> **[Claude для Slack](https://claude.com/claude-and-slack)**242> [card] [Claude для Slack](https://claude.com/claude-and-slack)

243>243>

244> Общая документация Claude для Slack244> Общая документация Claude для Slack

245 245 

246> **[Claude Tag](https://claude.com/docs/claude-tag/overview)**246> [card] [Claude Tag](https://claude.com/docs/claude-tag/overview)

247>247>

248> Управляемый организацией @Claude в Slack с настраиваемым администратором доступом248> Управляемый организацией @Claude в Slack с настраиваемым администратором доступом

249 249 

250> **[Slack App Marketplace](https://slack.com/marketplace/A08SF47R6P4)**250> [card] [Slack App Marketplace](https://slack.com/marketplace/A08SF47R6P4)

251>251>

252> Установите приложение Claude из Slack Marketplace252> Установите приложение Claude из Slack Marketplace

253 253 

254> **[Центр помощи Claude](https://support.claude.com)**254> [card] [Центр помощи Claude](https://support.claude.com)

255>255>

256> Получите дополнительную поддержку256> Получите дополнительную поддержку

statusline.md +4 −4

Details

212| `worktree.original_cwd` | Каталог, в котором находился Claude перед входом в worktree |212| `worktree.original_cwd` | Каталог, в котором находился Claude перед входом в worktree |

213| `worktree.original_branch` | Ветка Git, проверенная перед входом в worktree. Отсутствует для worktrees на основе hooks |213| `worktree.original_branch` | Ветка Git, проверенная перед входом в worktree. Отсутствует для worktrees на основе hooks |

214 214 

215> **Полная схема JSON**215> [accordion] Полная схема JSON

216>216>

217> Ваша команда строки состояния получает эту структуру JSON через stdin:217> Ваша команда строки состояния получает эту структуру JSON через stdin:

218>218>

341> * `agent`: появляется только при запуске с флагом `--agent` или настроенными параметрами агента341> * `agent`: появляется только при запуске с флагом `--agent` или настроенными параметрами агента

342> * `pr`: появляется только пока открытый PR или GitLab merge request найден для текущей ветки, и удаляется после того как он будет объединён или закрыт. `pr.review_state` и `pr.kind` могут быть независимо отсутствующими342> * `pr`: появляется только пока открытый PR или GitLab merge request найден для текущей ветки, и удаляется после того как он будет объединён или закрыт. `pr.review_state` и `pr.kind` могут быть независимо отсутствующими

343> * `worktree`: появляется только во время сеанса в [worktree сеансе](https://code.claude.com/docs/ru/worktrees.md). Когда присутствует, `branch` и `original_branch` также могут отсутствовать для worktrees на основе hooks343> * `worktree`: появляется только во время сеанса в [worktree сеансе](https://code.claude.com/docs/ru/worktrees.md). Когда присутствует, `branch` и `original_branch` также могут отсутствовать для worktrees на основе hooks

344> * `rate_limits`: появляется только для подписчиков Claude.ai Pro и Max, или за шлюзом Claude apps, который устанавливает лимит расходов для вас, и только после первого ответа API в сеансе. Каждое окно (`five_hour`, `seven_day`, `spend_limit`) может быть независимо отсутствующим, и Claude Code удаляет окно после того как его время `resets_at` пройдёт. Используйте `jq -r '.rate_limits.five_hour.used_percentage // empty'` для корректной обработки отсутствия.344> * `rate_limits`: появляется только для подписчиков claude.ai Pro, Max и Ultra или за шлюзом Claude apps, который устанавливает лимит расходов для вас. Даже в этом случае поле появляется только после первого ответа API в сессии. Каждое окно (`five_hour`, `seven_day`, `spend_limit`) может быть независимо отсутствующим, и Claude Code удаляет окно после того как его время `resets_at` пройдёт. Используйте `jq -r '.rate_limits.five_hour.used_percentage // empty'` для корректной обработки отсутствия.

345> * `prompt_cache`: появляется после первого ответа API основного разговора. Смотрите [поля prompt cache](#prompt-cache-fields)345> * `prompt_cache`: появляется после первого ответа API основного разговора. Смотрите [поля prompt cache](#prompt-cache-fields)

346>346>

347> **Поля, которые могут быть `null`**:347> **Поля, которые могут быть `null`**:

819 819 

820### Использование лимита скорости820### Использование лимита скорости

821 821 

822Отобразите в строке состояния использование ограничения частоты запросов подписки claude.ai или ваши расходы относительно лимита расходов шлюза приложений Claude. Для подписчиков объект `rate_limits` содержит скользящее окно `five_hour` и еженедельное окно `seven_day`. Каждое окно предоставляет `used_percentage` (от 0 до 100) и `resets_at` (секунды эпохи Unix, когда окно сбрасывается). За шлюзом считывайте объект `spend_limit`, описанный в разделе [поля лимита расходов](#spend-limit-fields).822Отобразите в строке состояния использование ограничения частоты запросов подписки claude.ai или ваши расходы относительно лимита расходов шлюза приложений Claude. Для подписчиков объект `rate_limits` может содержать скользящее окно `five_hour` и еженедельное окно `seven_day`. Каждое окно предоставляет `used_percentage` (от 0 до 100) и `resets_at` (секунды эпохи Unix, когда окно сбрасывается). За шлюзом считывайте объект `spend_limit`, описанный в разделе [поля лимита расходов](#spend-limit-fields).

823 823 

824Объект `rate_limits` присутствует только для подписчиков claude.ai Pro и Max или за шлюзом приложений Claude с лимитами расходов, и только после первого ответа API. Каждый скрипт корректно обрабатывает отсутствующие поля, а за шлюзом выводит `spend: $314.12 / $500` или `spend: 63%`, пока поля в долларах отсутствуют:824Объект `rate_limits` присутствует только для подписчиков claude.ai Pro, Max и Ultra или за шлюзом приложений Claude с лимитами расходов, и только после первого ответа API. Каждый скрипт корректно обрабатывает отсутствующие поля, а за шлюзом выводит `spend: $314.12 / $500` или `spend: 63%`, пока поля в долларах отсутствуют:

825 825 

826```bash Bash theme={null}826```bash Bash theme={null}

827#!/bin/bash827#!/bin/bash

sub-agents.md +77 −77

Details

32 32 

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

34 34 

35**Explore**35> [tab] Explore

36 36>

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

38 38>

39* **Model**: модель основного диалога. Когда основной диалог работает на Fable, модель Explore зависит от способа подключения:39> * **Model**: модель основного диалога. Когда основной диалог работает на Fable, модель Explore зависит от способа подключения:

40 * С подпиской Claude, учётной записью Anthropic Console или [LLM-шлюзом](https://code.claude.com/docs/ru/llm-gateway), доступным через `ANTHROPIC_BASE_URL`, Explore работает на модели Opus, в которую разрешается [псевдоним `opus`](https://code.claude.com/docs/ru/model-config#model-aliases).40> * С подпиской Claude, учётной записью Anthropic Console или [LLM-шлюзом](https://code.claude.com/docs/ru/llm-gateway), доступным через `ANTHROPIC_BASE_URL`, Explore работает на модели Opus, в которую разрешается [псевдоним `opus`](https://code.claude.com/docs/ru/model-config#model-aliases).

41 * На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](https://code.claude.com/docs/ru/claude-platform-on-aws.md) или [шлюзе Claude apps](https://code.claude.com/docs/ru/claude-apps-gateway) Explore остаётся на модели основного диалога.41> * На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](https://code.claude.com/docs/ru/claude-platform-on-aws.md) или [шлюзе Claude apps](https://code.claude.com/docs/ru/claude-apps-gateway) Explore остаётся на модели основного диалога.

42* **Tools**: инструменты только для чтения; Write и Edit запрещены42> * **Tools**: инструменты только для чтения; Write и Edit запрещены

43* **Purpose**: обнаружение файлов, поиск кода, исследование кодовой базы43> * **Purpose**: обнаружение файлов, поиск кода, исследование кодовой базы

44 44>

45[Пользовательский или проектный субагент](#choose-the-subagent-scope) с именем `Explore` переопределяет встроенный и сохраняет собственное поле `model`, поэтому определите его с `model: haiku`, чтобы запускать исследование на модели с более низкой стоимостью. Чтобы принудительно назначить одну модель каждому субагенту, включая Explore, см. [Запуск каждого субагента на одной модели](#run-every-subagent-on-one-model).45> [Пользовательский или проектный субагент](#choose-the-subagent-scope) с именем `Explore` переопределяет встроенный и сохраняет собственное поле `model`, поэтому определите его с `model: haiku`, чтобы запускать исследование на модели с более низкой стоимостью. Чтобы принудительно назначить одну модель каждому субагенту, включая Explore, см. [Запуск каждого субагента на одной модели](#run-every-subagent-on-one-model).

46 46>

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

48 48>

49При вызове Explore Claude указывает уровень тщательности: **quick** для целевых поисков, **medium** для сбалансированного исследования или **very thorough** для комплексного анализа.49> При вызове Explore Claude указывает уровень тщательности: **quick** для целевых поисков, **medium** для сбалансированного исследования или **very thorough** для комплексного анализа.

50 

51**Plan**

52 

53Исследовательский агент, используемый во время [plan mode](https://code.claude.com/docs/ru/permission-modes.md#analyze-before-you-edit-with-plan-mode) для сбора контекста перед представлением плана.

54 

55* **Model**: наследуется из основного разговора, если только вы не установите `CLAUDE_CODE_SUBAGENT_MODEL` и не [заставите его работать на каждом subagent](#run-every-subagent-on-one-model)

56* **Tools**: инструменты только для чтения; Write и Edit запрещены

57* **Purpose**: исследование кодовой базы для планирования

58 

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

60 

61**General-purpose**

62 

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

64 

65* **Model**: модель [`CLAUDE_CODE_SUBAGENT_MODEL`](#choose-a-model), если вы её установили и ничто не назначает модель другим способом, иначе модель основного разговора; [Выбор модели](#choose-a-model) указывает полный порядок, и [Запуск каждого subagent на одной модели](#run-every-subagent-on-one-model) показывает, как сделать переменную переопределением этих источников

66* **Tools**: каждый инструмент [доступный для subagents](#available-tools)

67* **Purpose**: сложное исследование, многошаговые операции, модификация кода

68 

69Claude делегирует general-purpose, когда задача требует как исследования, так и модификации, сложного рассуждения для интерпретации результатов или нескольких зависимых шагов.

70 50 

71**Other**51> [tab] Plan

52>

53> Исследовательский агент, используемый во время [plan mode](https://code.claude.com/docs/ru/permission-modes.md#analyze-before-you-edit-with-plan-mode) для сбора контекста перед представлением плана.

54>

55> * **Model**: наследуется из основного разговора, если только вы не установите `CLAUDE_CODE_SUBAGENT_MODEL` и не [заставите его работать на каждом subagent](#run-every-subagent-on-one-model)

56> * **Tools**: инструменты только для чтения; Write и Edit запрещены

57> * **Purpose**: исследование кодовой базы для планирования

58>

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

72 60 

73Claude Code включает дополнительные вспомогательные агенты для конкретных задач. Обычно они вызываются автоматически, поэтому вам не нужно использовать их напрямую.61> [tab] General-purpose

62>

63> Способный агент для сложных многошаговых задач, требующих как исследования, так и действия.

64>

65> * **Model**: модель [`CLAUDE_CODE_SUBAGENT_MODEL`](#choose-a-model), если вы её установили и ничто не назначает модель другим способом, иначе модель основного разговора; [Выбор модели](#choose-a-model) указывает полный порядок, и [Запуск каждого subagent на одной модели](#run-every-subagent-on-one-model) показывает, как сделать переменную переопределением этих источников

66> * **Tools**: каждый инструмент [доступный для subagents](#available-tools)

67> * **Purpose**: сложное исследование, многошаговые операции, модификация кода

68>

69> Claude делегирует general-purpose, когда задача требует как исследования, так и модификации, сложного рассуждения для интерпретации результатов или нескольких зависимых шагов.

74 70 

75| Agent | Model | Когда Claude его использует |71> [tab] Other

76| :- | :- | :- |72>

77| claude | Нет собственной; следует [порядку моделей](#choose-a-model), когда Claude порождает его как subagent | Когда задача не подходит более специализированному агенту. Универсальный агент со всеми инструментами [доступными для subagents](#available-tools). Также агент по умолчанию для отправленной [фоновой сессии](https://code.claude.com/docs/ru/agent-view.md); [в каком режиме разрешений он запускается](https://code.claude.com/docs/ru/agent-view.md#permission-mode-model-and-effort) зависит от того, как была запущена сессия |73> Claude Code включает дополнительные вспомогательные агенты для конкретных задач. Обычно они вызываются автоматически, поэтому вам не нужно использовать их напрямую.

78| statusline-setup | Sonnet | Когда вы запускаете `/statusline` для настройки строки состояния |74>

79| claude-code-guide | Haiku | Когда вы задаёте вопросы о функциях Claude Code |75> | Agent | Model | Когда Claude его использует |

76> | :- | :- | :- |

77> | claude | Нет собственной; следует [порядку моделей](#choose-a-model), когда Claude порождает его как subagent | Когда задача не подходит более специализированному агенту. Универсальный агент со всеми инструментами [доступными для subagents](#available-tools). Также агент по умолчанию для отправленной [фоновой сессии](https://code.claude.com/docs/ru/agent-view.md); [в каком режиме разрешений он запускается](https://code.claude.com/docs/ru/agent-view.md#permission-mode-model-and-effort) зависит от того, как была запущена сессия |

78> | statusline-setup | Sonnet | Когда вы запускаете `/statusline` для настройки строки состояния |

79> | claude-code-guide | Haiku | Когда вы задаёте вопросы о функциях Claude Code |

80 80 

81Встроенные subagents регистрируются по умолчанию в интерактивных сессиях. Чтобы ограничить их:81Встроенные subagents регистрируются по умолчанию в интерактивных сессиях. Чтобы ограничить их:

82 82 

179 179 

180**CLI-определённые subagents** передаются как JSON при запуске Claude Code. Они существуют только для этой сессии и не сохраняются на диск, что делает их полезными для быстрого тестирования или скриптов автоматизации. Вы можете определить несколько subagents в одном вызове `--agents`:180**CLI-определённые subagents** передаются как JSON при запуске Claude Code. Они существуют только для этой сессии и не сохраняются на диск, что делает их полезными для быстрого тестирования или скриптов автоматизации. Вы можете определить несколько subagents в одном вызове `--agents`:

181 181 

182**macOS, Linux, WSL**182> [tab] macOS, Linux, WSL

183 183>

184```bash theme={null}184> ```bash theme={null}

185claude --agents '{185> claude --agents '{

186 "code-reviewer": {186> "code-reviewer": {

187 "description": "Expert code reviewer. Use proactively after code changes.",187> "description": "Expert code reviewer. Use proactively after code changes.",

188 "prompt": "You are a senior code reviewer. Focus on code quality, security, and best practices.",188> "prompt": "You are a senior code reviewer. Focus on code quality, security, and best practices.",

189 "tools": ["Read", "Grep", "Glob", "Bash"],189> "tools": ["Read", "Grep", "Glob", "Bash"],

190 "model": "sonnet"190> "model": "sonnet"

191 },191> },

192 "debugger": {192> "debugger": {

193 "description": "Debugging specialist for errors and test failures.",193> "description": "Debugging specialist for errors and test failures.",

194 "prompt": "You are an expert debugger. Analyze errors, identify root causes, and provide fixes."194> "prompt": "You are an expert debugger. Analyze errors, identify root causes, and provide fixes."

195 }195> }

196}'196> }'

197```197> ```

198 198 

199**Windows PowerShell**199> [tab] Windows PowerShell

200 200>

201```powershell theme={null}201> ```powershell theme={null}

202claude --agents @'202> claude --agents @'

203{203> {

204 "code-reviewer": {204> "code-reviewer": {

205 "description": "Expert code reviewer. Use proactively after code changes.",205> "description": "Expert code reviewer. Use proactively after code changes.",

206 "prompt": "You are a senior code reviewer. Focus on code quality, security, and best practices.",206> "prompt": "You are a senior code reviewer. Focus on code quality, security, and best practices.",

207 "tools": ["Read", "Grep", "Glob", "Bash"],207> "tools": ["Read", "Grep", "Glob", "Bash"],

208 "model": "sonnet"208> "model": "sonnet"

209 },209> },

210 "debugger": {210> "debugger": {

211 "description": "Debugging specialist for errors and test failures.",211> "description": "Debugging specialist for errors and test failures.",

212 "prompt": "You are an expert debugger. Analyze errors, identify root causes, and provide fixes."212> "prompt": "You are an expert debugger. Analyze errors, identify root causes, and provide fixes."

213 }213> }

214}214> }

215'@215> '@

216```216> ```

217 217 

218В [non-interactive mode](https://code.claude.com/docs/ru/headless.md) `--agents` также принимает путь к файлу JSON, содержащему тот же объект, для определений, слишком больших для передачи в командной строке. Например, `claude -p --agents ./agents.json "Review my changes"` читает определения из этого файла. В интерактивной сессии Claude Code отказывает в пути к файлу. Форма файла требует Claude Code v2.1.281 или позже.218В [non-interactive mode](https://code.claude.com/docs/ru/headless.md) `--agents` также принимает путь к файлу JSON, содержащему тот же объект, для определений, слишком больших для передачи в командной строке. Например, `claude -p --agents ./agents.json "Review my changes"` читает определения из этого файла. В интерактивной сессии Claude Code отказывает в пути к файлу. Форма файла требует Claude Code v2.1.281 или позже.

219 219 

terminal-config.md +16 −16

Details

48 48 

49Некоторые сочетания клавиш Claude Code используют клавишу Option, например Option+Enter для новой строки или Option+P для переключения моделей. На macOS большинство терминалов по умолчанию не отправляют Option в качестве модификатора, поэтому эти сочетания клавиш не работают, пока вы их не включите. Параметр терминала для этого обычно называется "Use Option as Meta Key"; Meta — это историческое название Unix для клавиши, которая теперь называется Option или Alt.49Некоторые сочетания клавиш Claude Code используют клавишу Option, например Option+Enter для новой строки или Option+P для переключения моделей. На macOS большинство терминалов по умолчанию не отправляют Option в качестве модификатора, поэтому эти сочетания клавиш не работают, пока вы их не включите. Параметр терминала для этого обычно называется "Use Option as Meta Key"; Meta — это историческое название Unix для клавиши, которая теперь называется Option или Alt.

50 50 

51**Apple Terminal**51> [tab] Apple Terminal

52 52>

53Откройте Settings → Profiles → Keyboard и установите флажок "Use Option as Meta Key".53> Откройте Settings → Profiles → Keyboard и установите флажок "Use Option as Meta Key".

54 54>

55Если вы приняли приглашение Claude Code для первоначальной настройки терминала, это уже сделано. Это приглашение запускает `/terminal-setup` для вас, что включает Option как Meta и отключает звуковой сигнал в вашем профиле Apple Terminal.55> Если вы приняли приглашение Claude Code для первоначальной настройки терминала, это уже сделано. Это приглашение запускает `/terminal-setup` для вас, что включает Option как Meta и отключает звуковой сигнал в вашем профиле Apple Terminal.

56 56>

57В [режиме чтения с экрана](https://code.claude.com/docs/ru/accessibility.md) `/terminal-setup` оставляет параметр звонка без изменений, чтобы звонок терминала оставался слышимым. Если более ранний запуск отключил звонок, включите его снова в Settings → Profiles → Advanced → "Audible bell".57> В [режиме чтения с экрана](https://code.claude.com/docs/ru/accessibility.md) `/terminal-setup` оставляет параметр звонка без изменений, чтобы звонок терминала оставался слышимым. Если более ранний запуск отключил звонок, включите его снова в Settings → Profiles → Advanced → "Audible bell".

58 

59**iTerm2**

60 

61Откройте Settings → Profiles → Keys → General и установите Left Option key и Right Option key на "Esc+".

62 

63Запуск `/terminal-setup` в iTerm2 включает "Applications in terminal may access clipboard" в Settings → General → Selection, чтобы команда `/copy` могла писать в буфер обмена вашей системы. Команда обнаруживает iTerm2 даже при запуске изнутри tmux. Перезагрузите iTerm2, чтобы изменение вступило в силу.

64 58 

65**VS Code**59> [tab] iTerm2

60>

61> Откройте Settings → Profiles → Keys → General и установите Left Option key и Right Option key на "Esc+".

62>

63> Запуск `/terminal-setup` в iTerm2 включает "Applications in terminal may access clipboard" в Settings → General → Selection, чтобы команда `/copy` могла писать в буфер обмена вашей системы. Команда обнаруживает iTerm2 даже при запуске изнутри tmux. Перезагрузите iTerm2, чтобы изменение вступило в силу.

66 64 

67Добавьте `"terminal.integrated.macOptionIsMeta": true` в ваши параметры VS Code.65> [tab] VS Code

66>

67> Добавьте `"terminal.integrated.macOptionIsMeta": true` в ваши параметры VS Code.

68 68 

69Для Ghostty, Kitty и других терминалов ищите параметр Option-as-Alt или Option-as-Meta в файле конфигурации терминала.69Для Ghostty, Kitty и других терминалов ищите параметр Option-as-Alt или Option-as-Meta в файле конфигурации терминала.

70 70 

188 188 

189Справочник ниже охватывает токены, которые вы можете установить в `overrides`. Интерактивный редактор в `/theme` показывает те же токены с живым предпросмотром, плюс несколько специализированных акцентов, таких как цвета экрана адаптации, которые здесь опущены.189Справочник ниже охватывает токены, которые вы можете установить в `overrides`. Интерактивный редактор в `/theme` показывает те же токены с живым предпросмотром, плюс несколько специализированных акцентов, таких как цвета экрана адаптации, которые здесь опущены.

190 190 

191> **Справочник цветовых токенов**191> [accordion] Справочник цветовых токенов

192>192>

193> Следующий пример объединяет токены из нескольких групп ниже: фирменный акцент, границу режима плана, фоны diff и фон сообщения.193> Следующий пример объединяет токены из нескольких групп ниже: фирменный акцент, границу режима плана, фоны diff и фон сообщения.

194>194>

Details

19| Инструмент | Описание | Требуется разрешение |19| Инструмент | Описание | Требуется разрешение |

20| :- | :- | :- |20| :- | :- | :- |

21| `Agent` | Создает [подагента](https://code.claude.com/docs/ru/sub-agents.md) с собственным окном контекста для выполнения задачи. С включенными [командами агентов](https://code.claude.com/docs/ru/agent-teams.md) вызов, содержащий `name`, может запустить [товарища по команде](https://code.claude.com/docs/ru/agent-teams.md#how-claude-starts-agent-teams) вместо этого. См. [Поведение инструмента Agent](#agent-tool-behavior) | No |21| `Agent` | Создает [подагента](https://code.claude.com/docs/ru/sub-agents.md) с собственным окном контекста для выполнения задачи. С включенными [командами агентов](https://code.claude.com/docs/ru/agent-teams.md) вызов, содержащий `name`, может запустить [товарища по команде](https://code.claude.com/docs/ru/agent-teams.md#how-claude-starts-agent-teams) вместо этого. См. [Поведение инструмента Agent](#agent-tool-behavior) | No |

22| `Artifact` | Публикует HTML или Markdown файл как [артефакт](https://code.claude.com/docs/ru/artifacts.md): приватную интерактивную страницу на claude.ai. Вы можете поделиться ею по публичной ссылке или внутри вашей организации в планах Team и Enterprise, где публичный доступ требует, чтобы Owner [включил его](https://code.claude.com/docs/ru/artifacts.md#control-public-sharing). Требует план Pro, Max, Team или Enterprise и аутентификацию `/login`; см. [Доступность](https://code.claude.com/docs/ru/artifacts.md#availability) | Yes |22| `Artifact` | Публикует HTML- или Markdown-файл на claude.ai как [артефакт](https://code.claude.com/docs/ru/artifacts.md): приватную интерактивную страницу. Вы можете поделиться ею по публичной ссылке или внутри вашей организации в планах Team и Enterprise, где публичный доступ требует, чтобы Owner [включил его](https://code.claude.com/docs/ru/artifacts.md#control-public-sharing). Требует план Pro, Max, Ultra, Team или Enterprise и аутентификацию `/login`; см. [Доступность](https://code.claude.com/docs/ru/artifacts.md#availability) | Yes |

23| `AskUserQuestion` | Задает вопросы с несколькими вариантами ответов для сбора требований или уточнения неоднозначности. Вопросы остаются открытыми до тех пор, пока вы на них не ответите по умолчанию. См. [Поведение инструмента AskUserQuestion](#askuserquestion-tool-behavior) | No |23| `AskUserQuestion` | Задает вопросы с несколькими вариантами ответов для сбора требований или уточнения неоднозначности. Вопросы остаются открытыми до тех пор, пока вы на них не ответите по умолчанию. См. [Поведение инструмента AskUserQuestion](#askuserquestion-tool-behavior) | No |

24| `Bash` | Выполняет команды shell в вашей среде. См. [Поведение инструмента Bash](#bash-tool-behavior) | Yes |24| `Bash` | Выполняет команды shell в вашей среде. См. [Поведение инструмента Bash](#bash-tool-behavior) | Yes |

25| `CronCreate` | Планирует повторяющийся или одноразовый промпт в текущей сессии. Задачи привязаны к сессии и восстанавливаются при `--resume` или `--continue`, если не истекли. См. [запланированные задачи в рамках сессии](https://code.claude.com/docs/ru/scheduled-tasks.md) | No |25| `CronCreate` | Планирует повторяющийся или одноразовый промпт в текущей сессии. Задачи привязаны к сессии и восстанавливаются при `--resume` или `--continue`, если не истекли. См. [запланированные задачи в рамках сессии](https://code.claude.com/docs/ru/scheduled-tasks.md) | No |

42| `PushNotification` | Отправляет уведомление на рабочий стол и push-уведомление на телефон, когда подключен [Remote Control](https://code.claude.com/docs/ru/remote-control.md), чтобы долгоживущая задача или [запланированная задача в рамках сессии](https://code.claude.com/docs/ru/scheduled-tasks.md) могла вас достичь, когда вы отойдете. Доставка push-уведомлений осуществляется через инфраструктуру, размещенную Anthropic, которая недоступна из Amazon Bedrock, Claude Platform на AWS, Agent Platform Google Cloud или Microsoft Foundry | No |42| `PushNotification` | Отправляет уведомление на рабочий стол и push-уведомление на телефон, когда подключен [Remote Control](https://code.claude.com/docs/ru/remote-control.md), чтобы долгоживущая задача или [запланированная задача в рамках сессии](https://code.claude.com/docs/ru/scheduled-tasks.md) могла вас достичь, когда вы отойдете. Доставка push-уведомлений осуществляется через инфраструктуру, размещенную Anthropic, которая недоступна из Amazon Bedrock, Claude Platform на AWS, Agent Platform Google Cloud или Microsoft Foundry | No |

43| `Read` | Читает содержимое файлов. См. [Поведение инструмента Read](#read-tool-behavior) | No |43| `Read` | Читает содержимое файлов. См. [Поведение инструмента Read](#read-tool-behavior) | No |

44| `ReadMcpResourceTool` | Читает конкретный MCP ресурс по URI | No |44| `ReadMcpResourceTool` | Читает конкретный MCP ресурс по URI | No |

45| `RemoteTrigger` | Создает, обновляет, запускает и выводит список [облачных запланированных задач](https://code.claude.com/docs/ru/routines.md) (ранее — routines) на claude.ai. Поддерживает команду `/schedule`. [Справочник входных данных `RemoteTrigger`](https://code.claude.com/docs/ru/agent-sdk/typescript#remotetrigger) документирует каждое действие и политики организации, которые удаляют инструмент. Облачные запланированные задачи находятся на claude.ai и требуют план Pro, Max, Team или Enterprise. Поэтому этот инструмент недоступен из Amazon Bedrock, Claude Platform на AWS, Agent Platform Google Cloud или Microsoft Foundry | No |45| `RemoteTrigger` | Создает, обновляет, запускает и выводит список [облачных запланированных задач](https://code.claude.com/docs/ru/routines.md) (ранее — routines) на claude.ai. Поддерживает команду `/schedule`. [Справочник входных данных `RemoteTrigger`](https://code.claude.com/docs/ru/agent-sdk/typescript#remotetrigger) документирует каждое действие и политики организации, которые удаляют инструмент. Облачные запланированные задачи находятся на claude.ai и требуют план Pro, Max, Ultra, Team или Enterprise. Поэтому этот инструмент недоступен из Amazon Bedrock, Claude Platform на AWS, Agent Platform Google Cloud или Microsoft Foundry | No |

46| `ReportFindings` | Сообщает о результатах код-ревью в виде структурированного списка с файлом, кратким описанием и сценарием сбоя для каждого результата, чтобы Claude Code мог их отобразить вместо вывода в виде текста. Claude вызывает его, когда активные инструкции код-ревью предписывают ему это. Результат также может содержать необязательный слаг `category`, например `correctness` или `test-coverage`, который показывается рядом с местоположением файла в отображаемом списке | No |46| `ReportFindings` | Сообщает о результатах код-ревью в виде структурированного списка с файлом, кратким описанием и сценарием сбоя для каждого результата, чтобы Claude Code мог их отобразить вместо вывода в виде текста. Claude вызывает его, когда активные инструкции код-ревью предписывают ему это. Результат также может содержать необязательный слаг `category`, например `correctness` или `test-coverage`, который показывается рядом с местоположением файла в отображаемом списке | No |

47| `ScheduleWakeup` | Переносит следующую итерацию [самостоятельного `/loop`](https://code.claude.com/docs/ru/scheduled-tasks#let-claude-choose-the-interval). Claude вызывает это в конце каждой итерации, чтобы выбрать, когда запустится следующая, между одной минутой и одним часом; вы не вызываете это напрямую. Чтобы вместо этого завершить цикл, Claude вызывает его с `stop: true`, что отменяет ожидающее пробуждение. Ожидающее пробуждение появляется в `session_crons` во [входных данных хука Stop](https://code.claude.com/docs/ru/hooks.md#stop-input) | No |47| `ScheduleWakeup` | Переносит следующую итерацию [самостоятельного `/loop`](https://code.claude.com/docs/ru/scheduled-tasks#let-claude-choose-the-interval). Claude вызывает это в конце каждой итерации, чтобы выбрать, когда запустится следующая, между одной минутой и одним часом; вы не вызываете это напрямую. Чтобы вместо этого завершить цикл, Claude вызывает его с `stop: true`, что отменяет ожидающее пробуждение. Ожидающее пробуждение появляется в `session_crons` во [входных данных хука Stop](https://code.claude.com/docs/ru/hooks.md#stop-input) | No |

48| `SendFeedback` | Составляет отчет об обратной связи о Claude Code, охватывающий проблему продукта или поведение Claude в сеансе, и ставит его в очередь на вашей машине для вашего просмотра. Claude Code ничего не отправляет, пока вы не выберете отправить черновик. См. [Поведение инструмента SendFeedback](#sendfeedback-tool-behavior). Требует Claude Code v2.1.238 или позже | No |48| `SendFeedback` | Составляет отчет об обратной связи о Claude Code, охватывающий проблему продукта или поведение Claude в сеансе, и ставит его в очередь на вашей машине для вашего просмотра. Claude Code ничего не отправляет, пока вы не выберете отправить черновик. См. [Поведение инструмента SendFeedback](#sendfeedback-tool-behavior). Требует Claude Code v2.1.238 или позже | No |

Details

75 75 

76Установщик загружает с `downloads.claude.ai`. Убедитесь, что вы можете его достичь:76Установщик загружает с `downloads.claude.ai`. Убедитесь, что вы можете его достичь:

77 77 

78**macOS/Linux**78> [tab] macOS/Linux

79 79>

80```bash theme={null}80> ```bash theme={null}

81curl -sI https://downloads.claude.ai/claude-code-releases/latest81> curl -sI https://downloads.claude.ai/claude-code-releases/latest

82```82> ```

83 

84**Windows PowerShell**

85 

86```powershell theme={null}

87curl.exe -sI https://downloads.claude.ai/claude-code-releases/latest

88```

89 83 

90PowerShell создаёт псевдоним `curl` на `Invoke-WebRequest`, который отклоняет флаги `-sI`, поэтому вызовите `curl.exe` явно.84> [tab] Windows PowerShell

85>

86> ```powershell theme={null}

87> curl.exe -sI https://downloads.claude.ai/claude-code-releases/latest

88> ```

89>

90> PowerShell создаёт псевдоним `curl` на `Invoke-WebRequest`, который отклоняет флаги `-sI`, поэтому вызовите `curl.exe` явно.

91 91 

92Вы достигли сервера, если первая строка показывает статус `200`. Вы видите `HTTP/2 200` на macOS и Linux, и `HTTP/1.1 200 OK` из `curl.exe`, включённого в Windows. Другие результаты указывают на причину:92Вы достигли сервера, если первая строка показывает статус `200`. Вы видите `HTTP/2 200` на macOS и Linux, и `HTTP/1.1 200 OK` из `curl.exe`, включённого в Windows. Другие результаты указывают на причину:

93 93 

104 104 

105Этот пример устанавливает обе переменные прокси, а затем запускает установщик через ваш прокси:105Этот пример устанавливает обе переменные прокси, а затем запускает установщик через ваш прокси:

106 106 

107**macOS/Linux**107> [tab] macOS/Linux

108 108>

109```bash theme={null}109> ```bash theme={null}

110export HTTP_PROXY=http://proxy.example.com:8080110> export HTTP_PROXY=http://proxy.example.com:8080

111export HTTPS_PROXY=http://proxy.example.com:8080111> export HTTPS_PROXY=http://proxy.example.com:8080

112curl -fsSL https://claude.ai/install.sh | bash112> curl -fsSL https://claude.ai/install.sh | bash

113```113> ```

114 

115**Windows PowerShell**

116 114 

117```powershell theme={null}115> [tab] Windows PowerShell

118$env:HTTP_PROXY = 'http://proxy.example.com:8080'116>

119$env:HTTPS_PROXY = 'http://proxy.example.com:8080'117> ```powershell theme={null}

120irm https://claude.ai/install.ps1 | iex118> $env:HTTP_PROXY = 'http://proxy.example.com:8080'

121```119> $env:HTTPS_PROXY = 'http://proxy.example.com:8080'

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

121> ```

122 122 

123### Проверьте ваш PATH123### Проверьте ваш PATH

124 124 

132 132 

133Сначала проверьте, что программа вообще существует, затем проверьте, находится ли её папка в вашем PATH. Исправление PATH постоянное, поэтому его достаточно применить один раз. Выберите вкладку вашей платформы и выполните её команды там: в терминале на macOS и Linux или в PowerShell или Command Prompt на Windows.133Сначала проверьте, что программа вообще существует, затем проверьте, находится ли её папка в вашем PATH. Исправление PATH постоянное, поэтому его достаточно применить один раз. Выберите вкладку вашей платформы и выполните её команды там: в терминале на macOS и Linux или в PowerShell или Command Prompt на Windows.

134 134 

135**macOS/Linux**135> [tab] macOS/Linux

136 136>

137Проверьте, что установщик разместил программу на месте:137> Проверьте, что установщик разместил программу на месте:

138 138>

139```bash theme={null}139> ```bash theme={null}

140ls -la ~/.local/bin/claude140> ls -la ~/.local/bin/claude

141```141> ```

142 142>

143* **`No such file or directory`**: встроенной установки нет. Если вы не устанавливали Claude Code другим способом, например через npm, Homebrew или менеджер пакетов Linux, [установите Claude Code](https://code.claude.com/docs/ru/setup.md#install-claude-code). Если вы установили его другим способом, см. [Проверьте наличие конфликтующих установок](#check-for-conflicting-installations).143> * **`No such file or directory`**: встроенной установки нет. Если вы не устанавливали Claude Code другим способом, например через npm, Homebrew или менеджер пакетов Linux, [установите Claude Code](https://code.claude.com/docs/ru/setup.md#install-claude-code). Если вы установили его другим способом, см. [Проверьте наличие конфликтующих установок](#check-for-conflicting-installations).

144* **Информация о файле**: программа на месте. Далее проверьте ваш PATH.144> * **Информация о файле**: программа на месте. Далее проверьте ваш PATH.

145 145>

146Перечислите записи PATH и отфильтруйте по папке установки:146> Перечислите записи PATH и отфильтруйте по папке установки:

147 147>

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

149echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"149> echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"

150```150> ```

151 151>

152Если это выводит `/Users/you/.local/bin` или `/home/you/.local/bin`, директория находится в вашем PATH и вы можете перейти к [Проверьте наличие конфликтующих установок](#check-for-conflicting-installations). Если вывода нет, добавьте её в конфигурацию вашей оболочки с помощью двух команд для вашей оболочки. Команда `echo` сохраняет настройку для каждого нового терминала, а `source` применяет её к текущему окну. Команда `echo` ничего не выводит при успешном выполнении.152> Если это выводит `/Users/you/.local/bin` или `/home/you/.local/bin`, директория находится в вашем PATH и вы можете перейти к [Проверьте наличие конфликтующих установок](#check-for-conflicting-installations). Если вывода нет, добавьте её в конфигурацию вашей оболочки с помощью двух команд для вашей оболочки. Команда `echo` сохраняет настройку для каждого нового терминала, а `source` применяет её к текущему окну. Команда `echo` ничего не выводит при успешном выполнении.

153 153>

154Для Zsh, по умолчанию на macOS:154> Для Zsh, по умолчанию на macOS:

155 155>

156```bash theme={null}156> ```bash theme={null}

157echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc157> echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc

158source ~/.zshrc158> source ~/.zshrc

159```159> ```

160 160>

161Для Bash на Linux, где это по умолчанию на большинстве дистрибутивов:161> Для Bash на Linux, где это по умолчанию на большинстве дистрибутивов:

162 162>

163```bash theme={null}163> ```bash theme={null}

164echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc164> echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

165source ~/.bashrc165> source ~/.bashrc

166```166> ```

167 167>

168Для Bash на macOS добавьте строку в `~/.bash_profile` вместо этого. Terminal на macOS запускает Bash как оболочку входа, которая игнорирует `~/.bashrc` и читает только первый из `~/.bash_profile`, `~/.bash_login` или `~/.profile`, который существует. Если у вас уже есть `~/.bash_login` или `~/.profile` и нет `~/.bash_profile`, поместите строку в этот файл, а не создавайте `~/.bash_profile`:168> Для Bash на macOS добавьте строку в `~/.bash_profile` вместо этого. Terminal на macOS запускает Bash как оболочку входа, которая игнорирует `~/.bashrc` и читает только первый из `~/.bash_profile`, `~/.bash_login` или `~/.profile`, который существует. Если у вас уже есть `~/.bash_login` или `~/.profile` и нет `~/.bash_profile`, поместите строку в этот файл, а не создавайте `~/.bash_profile`:

169 169>

170```bash theme={null}170> ```bash theme={null}

171echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bash_profile171> echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bash_profile

172source ~/.bash_profile172> source ~/.bash_profile

173```173> ```

174 174>

175Или закройте и снова откройте ваш терминал.175> Или закройте и снова откройте ваш терминал.

176 176>

177Если команда `echo` выводит `permission denied`, см. [`permission denied` при добавлении в PATH](#permission-denied-when-adding-to-your-path).177> Если команда `echo` выводит `permission denied`, см. [`permission denied` при добавлении в PATH](#permission-denied-when-adding-to-your-path).

178 178>

179Для других оболочек, таких как fish или Nushell, добавьте `~/.local/bin` в ваш PATH, используя синтаксис конфигурации вашей оболочки, а затем перезагрузите ваш терминал.179> Для других оболочек, таких как fish или Nushell, добавьте `~/.local/bin` в ваш PATH, используя синтаксис конфигурации вашей оболочки, а затем перезагрузите ваш терминал.

180 180>

181Проверьте, что исправление сработало:181> Проверьте, что исправление сработало:

182 182>

183```bash theme={null}183> ```bash theme={null}

184claude --version184> claude --version

185```185> ```

186 186>

187Если `claude` по-прежнему не найден, проверьте следующие причины:187> Если `claude` по-прежнему не найден, проверьте следующие причины:

188 188>

189* **Терминал был открыт до изменения**: уже открытое окно сохраняет старый PATH, а терминал внутри редактора получает PATH от редактора. Откройте новое окно или закройте и снова откройте редактор.189> * **Терминал был открыт до изменения**: уже открытое окно сохраняет старый PATH, а терминал внутри редактора получает PATH от редактора. Откройте новое окно или закройте и снова откройте редактор.

190* **Строка не была сохранена**: выполните `grep -n '.local/bin' ~/.zshrc`, подставив имя файла вашей оболочки. Если строка есть, команда выведет её вместе с номером строки. Если ничего не выводится, снова выполните две команды для PATH.190> * **Строка не была сохранена**: выполните `grep -n '.local/bin' ~/.zshrc`, подставив имя файла вашей оболочки. Если строка есть, команда выведет её вместе с номером строки. Если ничего не выводится, снова выполните две команды для PATH.

191* **Строка попала в файл другой оболочки**: выполните `echo $0`, чтобы узнать вашу оболочку, затем выполните две команды для PATH для этой оболочки.191> * **Строка попала в файл другой оболочки**: выполните `echo $0`, чтобы узнать вашу оболочку, затем выполните две команды для PATH для этой оболочки.

192 

193**Windows PowerShell**

194 

195Проверьте, что установщик разместил программу на месте:

196 

197```powershell theme={null}

198Test-Path "$env:USERPROFILE\.local\bin\claude.exe"

199```

200 

201* **`False`**: встроенной установки нет. Если вы не устанавливали Claude Code другим способом, например через npm или WinGet, [установите Claude Code](https://code.claude.com/docs/ru/setup.md#install-claude-code). Если вы установили его другим способом, см. [Проверьте наличие конфликтующих установок](#check-for-conflicting-installations).

202* **`True`**: программа на месте. Далее проверьте ваш PATH.

203 

204Перечислите записи PATH и отфильтруйте по папке установки:

205 

206```powershell theme={null}

207$env:PATH -split ';' | Select-String '\.local\\bin'

208```

209 

210Если это выводит `C:\Users\you\.local\bin`, директория находится в вашем PATH и вы можете перейти к [Проверьте наличие конфликтующих установок](#check-for-conflicting-installations). Если вывода нет, добавьте директорию установки в ваш User PATH:

211 

212```powershell theme={null}

213$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')

214[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

215```

216 

217Перезагрузите ваш терминал, чтобы изменение вступило в силу.

218 

219Проверьте, что исправление сработало:

220 

221```powershell theme={null}

222claude --version

223```

224 

225Если `claude` по-прежнему не найден в новом терминале, проверьте следующие причины:

226 

227* **Терминал работает внутри редактора**: он получает PATH от редактора, поэтому закройте и снова откройте редактор.

228* **Изменение не было сохранено**: выполните `[Environment]::GetEnvironmentVariable('PATH', 'User')` и найдите `.local\bin` в выведенном PATH. Если его нет, снова выполните две команды.

229 

230**Windows CMD**

231 

232Проверьте, что установщик разместил программу на месте:

233 

234```batch theme={null}

235dir "%USERPROFILE%\.local\bin\claude.exe"

236```

237 

238* **`File Not Found` или `The system cannot find the path specified.`**: встроенной установки нет. Если вы не устанавливали Claude Code другим способом, например через npm или WinGet, [установите Claude Code](https://code.claude.com/docs/ru/setup.md#install-claude-code). Если вы установили его другим способом, см. [Проверьте наличие конфликтующих установок](#check-for-conflicting-installations).

239* **Информация о `claude.exe`**: программа на месте. Далее проверьте ваш PATH.

240 

241Перечислите записи PATH и отфильтруйте по папке установки:

242 

243```batch theme={null}

244echo %PATH% | findstr /i "local\bin"

245```

246 

247Если вывода нет, откройте System Settings, перейдите в Environment Variables и добавьте `%USERPROFILE%\.local\bin` в вашу переменную User PATH. Перезагрузите ваш терминал.

248 

249Проверьте, что исправление сработало:

250 192 

251```batch theme={null}193> [tab] Windows PowerShell

252claude --version194>

253```195> Проверьте, что установщик разместил программу на месте:

196>

197> ```powershell theme={null}

198> Test-Path "$env:USERPROFILE\.local\bin\claude.exe"

199> ```

200>

201> * **`False`**: встроенной установки нет. Если вы не устанавливали Claude Code другим способом, например через npm или WinGet, [установите Claude Code](https://code.claude.com/docs/ru/setup.md#install-claude-code). Если вы установили его другим способом, см. [Проверьте наличие конфликтующих установок](#check-for-conflicting-installations).

202> * **`True`**: программа на месте. Далее проверьте ваш PATH.

203>

204> Перечислите записи PATH и отфильтруйте по папке установки:

205>

206> ```powershell theme={null}

207> $env:PATH -split ';' | Select-String '\.local\\bin'

208> ```

209>

210> Если это выводит `C:\Users\you\.local\bin`, директория находится в вашем PATH и вы можете перейти к [Проверьте наличие конфликтующих установок](#check-for-conflicting-installations). Если вывода нет, добавьте директорию установки в ваш User PATH:

211>

212> ```powershell theme={null}

213> $currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')

214> [Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

215> ```

216>

217> Перезагрузите ваш терминал, чтобы изменение вступило в силу.

218>

219> Проверьте, что исправление сработало:

220>

221> ```powershell theme={null}

222> claude --version

223> ```

224>

225> Если `claude` по-прежнему не найден в новом терминале, проверьте следующие причины:

226>

227> * **Терминал работает внутри редактора**: он получает PATH от редактора, поэтому закройте и снова откройте редактор.

228> * **Изменение не было сохранено**: выполните `[Environment]::GetEnvironmentVariable('PATH', 'User')` и найдите `.local\bin` в выведенном PATH. Если его нет, снова выполните две команды.

254 229 

255Если `claude` по-прежнему не найден в новом терминале, учтите, что терминал внутри редактора получает PATH от редактора, поэтому также закройте и снова откройте редактор.230> [tab] Windows CMD

231>

232> Проверьте, что установщик разместил программу на месте:

233>

234> ```batch theme={null}

235> dir "%USERPROFILE%\.local\bin\claude.exe"

236> ```

237>

238> * **`File Not Found` или `The system cannot find the path specified.`**: встроенной установки нет. Если вы не устанавливали Claude Code другим способом, например через npm или WinGet, [установите Claude Code](https://code.claude.com/docs/ru/setup.md#install-claude-code). Если вы установили его другим способом, см. [Проверьте наличие конфликтующих установок](#check-for-conflicting-installations).

239> * **Информация о `claude.exe`**: программа на месте. Далее проверьте ваш PATH.

240>

241> Перечислите записи PATH и отфильтруйте по папке установки:

242>

243> ```batch theme={null}

244> echo %PATH% | findstr /i "local\bin"

245> ```

246>

247> Если вывода нет, откройте System Settings, перейдите в Environment Variables и добавьте `%USERPROFILE%\.local\bin` в вашу переменную User PATH. Перезагрузите ваш терминал.

248>

249> Проверьте, что исправление сработало:

250>

251> ```batch theme={null}

252> claude --version

253> ```

254>

255> Если `claude` по-прежнему не найден в новом терминале, учтите, что терминал внутри редактора получает PATH от редактора, поэтому также закройте и снова откройте редактор.

256 256 

257### Проверьте наличие конфликтующих установок257### Проверьте наличие конфликтующих установок

258 258 

259Несколько установок Claude Code могут вызвать несоответствия версий или неожиданное поведение. Проверьте, что установлено:259Несколько установок Claude Code могут вызвать несоответствия версий или неожиданное поведение. Проверьте, что установлено:

260 260 

261**macOS/Linux**261> [tab] macOS/Linux

262 262>

263Перечислите все бинарные файлы `claude`, найденные в вашем PATH:263> Перечислите все бинарные файлы `claude`, найденные в вашем PATH:

264 264>

265```bash theme={null}265> ```bash theme={null}

266which -a claude266> which -a claude

267```267> ```

268 268>

269Если это выводит `claude not found`, строку `no claude in` или ничего, значит `claude` нет в вашем PATH. Следующие проверки покажут, установлен ли он вообще.269> Если это выводит `claude not found`, строку `no claude in` или ничего, значит `claude` нет в вашем PATH. Следующие проверки покажут, установлен ли он вообще.

270 270>

271Проверьте три места, откуда может поступить бинарный файл `claude`. `~/.local/bin/claude` — это встроенный установщик, `~/.claude/local/` — это устаревшая локальная установка npm, созданная старыми версиями Claude Code, и список глобального npm показывает установку `-g`:271> Проверьте три места, откуда может поступить бинарный файл `claude`. `~/.local/bin/claude` — это встроенный установщик, `~/.claude/local/` — это устаревшая локальная установка npm, созданная старыми версиями Claude Code, и список глобального npm показывает установку `-g`:

272 272>

273```bash theme={null}273> ```bash theme={null}

274ls -la ~/.local/bin/claude274> ls -la ~/.local/bin/claude

275```275> ```

276 276>

277Встроенная установка показывает символическую ссылку в `~/.local/share/claude/versions/`. Скрипт или символическая ссылка, которую вы создали сами в этом пути, — это пользовательский запускатель, который [автоматическое обновление оставляет на месте](https://code.claude.com/docs/ru/setup.md#auto-updates).277> Встроенная установка показывает символическую ссылку в `~/.local/share/claude/versions/`. Скрипт или символическая ссылка, которую вы создали сами в этом пути, — это пользовательский запускатель, который [автоматическое обновление оставляет на месте](https://code.claude.com/docs/ru/setup.md#auto-updates).

278 278>

279Если какая-либо команда `ls` выводит `No such file or directory`, это не ошибка. Это означает, что ничего не установлено в этом месте, поэтому переходите к следующей проверке.279> Если какая-либо команда `ls` выводит `No such file or directory`, это не ошибка. Это означает, что ничего не установлено в этом месте, поэтому переходите к следующей проверке.

280 280>

281```bash theme={null}281> ```bash theme={null}

282ls -la ~/.claude/local/282> ls -la ~/.claude/local/

283```283> ```

284 284>

285```bash theme={null}285> ```bash theme={null}

286npm -g ls @anthropic-ai/claude-code 2>/dev/null286> npm -g ls @anthropic-ai/claude-code 2>/dev/null

287```287> ```

288 288>

289Если `ls -la ~/.local/bin/claude` вывела `No such file or directory`, встроенной установки нет. Если вы не устанавливали Claude Code другим способом, например через npm, Homebrew или менеджер пакетов Linux, [установите Claude Code](https://code.claude.com/docs/ru/setup.md#install-claude-code). Если `~/.local/bin/claude` существует, но `which -a claude` его не показала, папка не находится в вашем PATH: см. [Проверьте ваш PATH](#verify-your-path).289> Если `ls -la ~/.local/bin/claude` вывела `No such file or directory`, встроенной установки нет. Если вы не устанавливали Claude Code другим способом, например через npm, Homebrew или менеджер пакетов Linux, [установите Claude Code](https://code.claude.com/docs/ru/setup.md#install-claude-code). Если `~/.local/bin/claude` существует, но `which -a claude` его не показала, папка не находится в вашем PATH: см. [Проверьте ваш PATH](#verify-your-path).

290 

291**Windows PowerShell**

292 

293Перечислите все бинарные файлы `claude`, найденные в вашем PATH:

294 

295```powershell theme={null}

296where.exe claude

297```

298 

299Если это выводит `INFO: Could not find files for the given pattern(s).`, значит `claude` нет в вашем PATH.

300 

301Проверьте, разместил ли встроенный установщик бинарный файл:

302 

303```powershell theme={null}

304Test-Path "$env:USERPROFILE\.local\bin\claude.exe"

305```

306 290 

307* **`True`**: встроенная установка на месте. Если `where.exe` ничего не нашла, её папка не находится в вашем PATH: см. [Проверьте ваш PATH](#verify-your-path).291> [tab] Windows PowerShell

308* **`False`**: встроенной установки нет. Если вы не устанавливали Claude Code другим способом, например через npm или WinGet, [установите Claude Code](https://code.claude.com/docs/ru/setup.md#install-claude-code).292>

293> Перечислите все бинарные файлы `claude`, найденные в вашем PATH:

294>

295> ```powershell theme={null}

296> where.exe claude

297> ```

298>

299> Если это выводит `INFO: Could not find files for the given pattern(s).`, значит `claude` нет в вашем PATH.

300>

301> Проверьте, разместил ли встроенный установщик бинарный файл:

302>

303> ```powershell theme={null}

304> Test-Path "$env:USERPROFILE\.local\bin\claude.exe"

305> ```

306>

307> * **`True`**: встроенная установка на месте. Если `where.exe` ничего не нашла, её папка не находится в вашем PATH: см. [Проверьте ваш PATH](#verify-your-path).

308> * **`False`**: встроенной установки нет. Если вы не устанавливали Claude Code другим способом, например через npm или WinGet, [установите Claude Code](https://code.claude.com/docs/ru/setup.md#install-claude-code).

309 309 

310Если вы найдёте несколько установок, оставьте только одну. Встроенная установка в `~/.local/bin/claude` на macOS/Linux или `%USERPROFILE%\.local\bin\claude.exe` на Windows рекомендуется. Удалите лишние:310Если вы найдёте несколько установок, оставьте только одну. Встроенная установка в `~/.local/bin/claude` на macOS/Linux или `%USERPROFILE%\.local\bin\claude.exe` на Windows рекомендуется. Удалите лишние:

311 311 

317 317 

318Удалите устаревшую локальную установку npm:318Удалите устаревшую локальную установку npm:

319 319 

320**macOS/Linux**320> [tab] macOS/Linux

321 321>

322```bash theme={null}322> ```bash theme={null}

323rm -rf ~/.claude/local323> rm -rf ~/.claude/local

324```324> ```

325 

326**Windows PowerShell**

327 325 

328```powershell theme={null}326> [tab] Windows PowerShell

329Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\local"327>

330```328> ```powershell theme={null}

329> Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\local"

330> ```

331 331 

332Удалите установку Homebrew на macOS. Если вы установили cask `claude-code@latest`, замените это имя:332Удалите установку Homebrew на macOS. Если вы установили cask `claude-code@latest`, замените это имя:

333 333 

376 376 

377Подтвердите, что бинарный файл существует и исполняемый:377Подтвердите, что бинарный файл существует и исполняемый:

378 378 

379**macOS/Linux**379> [tab] macOS/Linux

380 380>

381```bash theme={null}381> ```bash theme={null}

382ls -la "$(command -v claude)"382> ls -la "$(command -v claude)"

383```383> ```

384 

385**Windows PowerShell**

386 384 

387```powershell theme={null}385> [tab] Windows PowerShell

388Get-Command claude | Select-Object Source386>

389```387> ```powershell theme={null}

388> Get-Command claude | Select-Object Source

389> ```

390 390 

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

392 392 

568 568 

5693. **Проверьте помехи прокси или брандмауэра**: корпоративные прокси, выполняющие TLS inspection, могут вызвать эти ошибки, включая `unable to get local issuer certificate` и `SELF_SIGNED_CERT_IN_CHAIN`. Для шага установки настройте загрузку установщика так, чтобы она доверяла CA вашего корпоративного прокси:5693. **Проверьте помехи прокси или брандмауэра**: корпоративные прокси, выполняющие TLS inspection, могут вызвать эти ошибки, включая `unable to get local issuer certificate` и `SELF_SIGNED_CERT_IN_CHAIN`. Для шага установки настройте загрузку установщика так, чтобы она доверяла CA вашего корпоративного прокси:

570 570 

571 **macOS/Linux**571 > [tab] macOS/Linux

572 >

573 > ```bash theme={null}

574 > curl --cacert /path/to/corporate-ca.pem -fsSL https://claude.ai/install.sh | bash

575 > ```

572 576 

573 ```bash theme={null}577 > [tab] Windows PowerShell

574 curl --cacert /path/to/corporate-ca.pem -fsSL https://claude.ai/install.sh | bash578 >

575 ```579 > Установщик PowerShell загружается через .NET, который проверяет TLS в хранилище сертификатов Windows. Попросите вашу IT-команду добавить сертификат CA прокси в хранилище Windows, если его там ещё нет, затем запустите установщик:

576 580 >

577 **Windows PowerShell**581 > ```powershell theme={null}

578 582 > irm https://claude.ai/install.ps1 | iex

579 Установщик PowerShell загружается через .NET, который проверяет TLS в хранилище сертификатов Windows. Попросите вашу IT-команду добавить сертификат CA прокси в хранилище Windows, если его там ещё нет, затем запустите установщик:583 > ```

580 

581 ```powershell theme={null}

582 irm https://claude.ai/install.ps1 | iex

583 ```

584 584 

585 Для самого Claude Code после установки установите `NODE_EXTRA_CA_CERTS` так, чтобы запросы API доверяли тому же пакету:585 Для самого Claude Code после установки установите `NODE_EXTRA_CA_CERTS` так, чтобы запросы API доверяли тому же пакету:

586 586 

587 **macOS/Linux**587 > [tab] macOS/Linux

588 588 >

589 ```bash theme={null}589 > ```bash theme={null}

590 export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca.pem590 > export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca.pem

591 ```591 > ```

592 

593 **Windows PowerShell**

594 592 

595 ```powershell theme={null}593 > [tab] Windows PowerShell

596 $env:NODE_EXTRA_CA_CERTS = 'C:\path\to\corporate-ca.pem'594 >

597 ```595 > ```powershell theme={null}

596 > $env:NODE_EXTRA_CA_CERTS = 'C:\path\to\corporate-ca.pem'

597 > ```

598 598 

599 Попросите файл сертификата у вашей IT-команды, если у вас его нет. Вы также можете попробовать на прямом соединении, чтобы подтвердить, что прокси является причиной.599 Попросите файл сертификата у вашей IT-команды, если у вас его нет. Вы также можете попробовать на прямом соединении, чтобы подтвердить, что прокси является причиной.

600 600 

827 827 

828В любой другой конфигурации повторный запуск установщика позволяет обойти эту ошибку, потому что скрипт запускает команду `install` последнего выпуска, даже когда вы просите его установить более старую версию. Снова запустите команду для вашей платформы:828В любой другой конфигурации повторный запуск установщика позволяет обойти эту ошибку, потому что скрипт запускает команду `install` последнего выпуска, даже когда вы просите его установить более старую версию. Снова запустите команду для вашей платформы:

829 829 

830**macOS/Linux**830> [tab] macOS/Linux

831 831>

832```bash theme={null}832> ```bash theme={null}

833curl -fsSL https://claude.ai/install.sh | bash833> curl -fsSL https://claude.ai/install.sh | bash

834```834> ```

835 

836**Windows PowerShell**

837 835 

838```powershell theme={null}836> [tab] Windows PowerShell

839irm https://claude.ai/install.ps1 | iex837>

840```838> ```powershell theme={null}

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

840> ```

841 841 

842`claude --version` выводит версию, установленную при повторном запуске.842`claude --version` выводит версию, установленную при повторном запуске.

843 843 

1108 1108 

1109Строка `npm error path` называет каталог, который npm не смог переместить. Удалите этот каталог и все оставшиеся рядом с ним каталоги `.claude-code-*`, которые могли остаться после ранее прерванных запусков. Команды ниже находят ваш глобальный каталог пакетов с помощью `npm root -g`; если каталог, который называет строка `npm error path`, не находится внутри каталога, который выводит `npm root -g`, например потому что вы переключили версии Node с помощью nvm, удалите вместо этого каталоги, которые называет ошибка:1109Строка `npm error path` называет каталог, который npm не смог переместить. Удалите этот каталог и все оставшиеся рядом с ним каталоги `.claude-code-*`, которые могли остаться после ранее прерванных запусков. Команды ниже находят ваш глобальный каталог пакетов с помощью `npm root -g`; если каталог, который называет строка `npm error path`, не находится внутри каталога, который выводит `npm root -g`, например потому что вы переключили версии Node с помощью nvm, удалите вместо этого каталоги, которые называет ошибка:

1110 1110 

1111**macOS/Linux**1111> [tab] macOS/Linux

1112 1112>

1113```bash theme={null}1113> ```bash theme={null}

1114rm -rf "$(npm root -g)/@anthropic-ai/claude-code"1114> rm -rf "$(npm root -g)/@anthropic-ai/claude-code"

1115```1115> ```

1116 1116>

1117Затем удалите все оставшиеся временные каталоги. Если Zsh выводит `no matches found`, удалять было нечего:1117> Затем удалите все оставшиеся временные каталоги. Если Zsh выводит `no matches found`, удалять было нечего:

1118 1118>

1119```bash theme={null}1119> ```bash theme={null}

1120rm -rf "$(npm root -g)/@anthropic-ai/.claude-code-"*1120> rm -rf "$(npm root -g)/@anthropic-ai/.claude-code-"*

1121```1121> ```

1122 

1123**Windows PowerShell**

1124 1122 

1125```powershell theme={null}1123> [tab] Windows PowerShell

1126Remove-Item -Recurse -Force "$(npm root -g)/@anthropic-ai/claude-code", "$(npm root -g)/@anthropic-ai/.claude-code-*"1124>

1127```1125> ```powershell theme={null}

1126> Remove-Item -Recurse -Force "$(npm root -g)/@anthropic-ai/claude-code", "$(npm root -g)/@anthropic-ai/.claude-code-*"

1127> ```

1128 1128 

1129Затем переустановите. На npm 12 следуйте инструкциям из раздела [Исправление установки через npm 12](#fix-an-npm-12-install). В противном случае выполните:1129Затем переустановите. На npm 12 следуйте инструкциям из раздела [Исправление установки через npm 12](#fix-an-npm-12-install). В противном случае выполните:

1130 1130 

1162 1162 

1163Если вы видите `API Error: 403 Request not allowed` после входа:1163Если вы видите `API Error: 403 Request not allowed` после входа:

1164 1164 

1165* **Пользователи Claude Pro/Max**: проверьте, что ваша подписка активна на [claude.ai/settings](https://claude.ai/settings)1165* **Пользователи Claude Pro/Max/Ultra**: проверьте, что ваша подписка активна на [claude.ai/settings](https://claude.ai/settings)

1166* **Пользователи Anthropic Console**: подтвердите, что ваша учётная запись имеет роль "Claude Code" или "Developer". Администраторы назначают её на странице Members в Console по адресу [platform.claude.com/settings/members](https://platform.claude.com/settings/members).1166* **Пользователи Anthropic Console**: подтвердите, что ваша учётная запись имеет роль "Claude Code" или "Developer". Администраторы назначают её на странице Members в Console по адресу [platform.claude.com/settings/members](https://platform.claude.com/settings/members).

1167* **За прокси**: корпоративные прокси могут помешать запросам API. См. [network configuration](https://code.claude.com/docs/ru/network-config.md) для настройки прокси.1167* **За прокси**: корпоративные прокси могут помешать запросам API. См. [network configuration](https://code.claude.com/docs/ru/network-config.md) для настройки прокси.

1168 1168 

1183 1183 

1184Чтобы использовать вашу подписку вместо этого, отмените установку переменной окружения и удалите её из вашего профиля оболочки:1184Чтобы использовать вашу подписку вместо этого, отмените установку переменной окружения и удалите её из вашего профиля оболочки:

1185 1185 

1186**macOS/Linux**1186> [tab] macOS/Linux

1187 1187>

1188```bash theme={null}1188> ```bash theme={null}

1189unset ANTHROPIC_API_KEY1189> unset ANTHROPIC_API_KEY

1190claude1190> claude

1191```1191> ```

1192 

1193**Windows PowerShell**

1194 1192 

1195```powershell theme={null}1193> [tab] Windows PowerShell

1196Remove-Item Env:ANTHROPIC_API_KEY1194>

1197claude1195> ```powershell theme={null}

1198```1196> Remove-Item Env:ANTHROPIC_API_KEY

1197> claude

1198> ```

1199 1199 

1200Проверьте `~/.zshrc`, `~/.bashrc` или `~/.profile` на строки `export ANTHROPIC_API_KEY=...` и удалите их, чтобы сделать изменение постоянным. На Windows проверьте ваш профиль PowerShell в `$PROFILE` и ваши переменные окружения User на `ANTHROPIC_API_KEY`. Запустите `/status` внутри Claude Code, чтобы подтвердить, какой метод аутентификации активен.1200Проверьте `~/.zshrc`, `~/.bashrc` или `~/.profile` на строки `export ANTHROPIC_API_KEY=...` и удалите их, чтобы сделать изменение постоянным. На Windows проверьте ваш профиль PowerShell в `$PROFILE` и ваши переменные окружения User на `ANTHROPIC_API_KEY`. Запустите `/status` внутри Claude Code, чтобы подтвердить, какой метод аутентификации активен.

1201 1201 

troubleshooting.md +27 −27

Details

134 134 

135Если инструмент Search, упоминания `@file`, пользовательские агенты или пользовательские skills не находят файлы, встроенный двоичный файл `ripgrep` может не работать на вашей системе. Установите пакет `ripgrep` вашей платформы и скажите Claude Code использовать его вместо этого:135Если инструмент Search, упоминания `@file`, пользовательские агенты или пользовательские skills не находят файлы, встроенный двоичный файл `ripgrep` может не работать на вашей системе. Установите пакет `ripgrep` вашей платформы и скажите Claude Code использовать его вместо этого:

136 136 

137**macOS**137> [tab] macOS

138 138>

139```bash theme={null}139> ```bash theme={null}

140brew install ripgrep140> brew install ripgrep

141```141> ```

142 

143**Ubuntu/Debian**

144 

145```bash theme={null}

146sudo apt install ripgrep

147```

148 

149**Alpine**

150 

151```bash theme={null}

152apk add ripgrep

153```

154 

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

156 142 

157**Arch**143> [tab] Ubuntu/Debian

144>

145> ```bash theme={null}

146> sudo apt install ripgrep

147> ```

158 148 

159```bash theme={null}149> [tab] Alpine

160pacman -S ripgrep150>

161```151> ```bash theme={null}

152> apk add ripgrep

153> ```

154>

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

162 156 

163**Windows**157> [tab] Arch

158>

159> ```bash theme={null}

160> pacman -S ripgrep

161> ```

164 162 

165```powershell theme={null}163> [tab] Windows

166winget install BurntSushi.ripgrep.MSVC164>

167```165> ```powershell theme={null}

166> winget install BurntSushi.ripgrep.MSVC

167> ```

168 168 

169Затем установите `USE_BUILTIN_RIPGREP` на `0`, либо в вашем [окружении](https://code.claude.com/docs/ru/env-vars.md), либо в блоке `env` вашего [`settings.json`](https://code.claude.com/docs/ru/settings-reference#all-settings):169Затем установите `USE_BUILTIN_RIPGREP` на `0`, либо в вашем [окружении](https://code.claude.com/docs/ru/env-vars.md), либо в блоке `env` вашего [`settings.json`](https://code.claude.com/docs/ru/settings-reference#all-settings):

170 170 

ultrareview.md +2 −1

Details

120| - | - | - |120| - | - | - |

121| Pro | 3 бесплатных запуска | выставляется счет как [дополнительное использование](https://support.claude.com/ru/articles/12429409-extra-usage-for-paid-claude-plans) |121| Pro | 3 бесплатных запуска | выставляется счет как [дополнительное использование](https://support.claude.com/ru/articles/12429409-extra-usage-for-paid-claude-plans) |

122| Max | 3 бесплатных запуска | выставляется счет как [дополнительное использование](https://support.claude.com/ru/articles/12429409-extra-usage-for-paid-claude-plans) |122| Max | 3 бесплатных запуска | выставляется счет как [дополнительное использование](https://support.claude.com/ru/articles/12429409-extra-usage-for-paid-claude-plans) |

123| Ultra | 3 бесплатных запуска | оплачивается как [кредиты использования](https://support.claude.com/ru/articles/12429409-extra-usage-for-paid-claude-plans) |

123 124 

124* **Бесплатные запуски**: три запуска Pro и Max — это одноразовое выделение на учетную запись и не обновляются.125* **Бесплатные запуски**: три запуска Pro, Max и Ultra — это одноразовое выделение на учетную запись и не обновляются.

125* **Стоимость одного анализа**: после использования бесплатных запусков обычно от 5 до 25 долларов в дополнительном использовании в зависимости от размера изменения, что соответствует оценке, которую показывает диалоговое окно запуска перед каждым запуском.126* **Стоимость одного анализа**: после использования бесплатных запусков обычно от 5 до 25 долларов в дополнительном использовании в зависимости от размера изменения, что соответствует оценке, которую показывает диалоговое окно запуска перед каждым запуском.

126* **Когда запуск считается начатым**: после запуска облачной сессии. Анализ, который вы остановили рано или который не завершился, все равно использует бесплатный запуск; платный анализ выставляет счет только за ту часть, которая была выполнена.127* **Когда запуск считается начатым**: после запуска облачной сессии. Анализ, который вы остановили рано или который не завершился, все равно использует бесплатный запуск; платный анализ выставляет счет только за ту часть, которая была выполнена.

127 128 

Details

105 105 

106Голосовой ввод использует тот же [параметр `language`](https://code.claude.com/docs/ru/settings-reference#language), который управляет языком ответов Claude. Если этот параметр пуст, диктовка по умолчанию использует английский язык. В расширении VS Code, если `language` пуст, диктовка использует параметр `accessibility.voice.speechLanguage` VS Code перед переходом на английский язык по умолчанию.106Голосовой ввод использует тот же [параметр `language`](https://code.claude.com/docs/ru/settings-reference#language), который управляет языком ответов Claude. Если этот параметр пуст, диктовка по умолчанию использует английский язык. В расширении VS Code, если `language` пуст, диктовка использует параметр `accessibility.voice.speechLanguage` VS Code перед переходом на английский язык по умолчанию.

107 107 

108> **Поддерживаемые языки диктовки**108> [accordion] Поддерживаемые языки диктовки

109>109>

110> | Язык | Код |110> | Язык | Код |

111> | :- | :- |111> | :- | :- |

vs-code.md +34 −30

Details

23Перед установкой убедитесь, что у вас есть:23Перед установкой убедитесь, что у вас есть:

24 24 

25* VS Code версии 1.94.0 или выше25* VS Code версии 1.94.0 или выше

26* Учётная запись Anthropic: подойдёт любая платная подписка Claude (Pro, Max, Team или Enterprise) или учётная запись Claude Console, API ключ не требуется. Вы [войдёте](https://code.claude.com/docs/ru/authentication.md#log-in-to-claude-code) с помощью этой учётной записи при первом открытии расширения. Если вы получаете доступ к Claude через поставщика услуг третьей стороны, такого как Amazon Bedrock или Google Cloud's Agent Platform, см. [Использование поставщиков третьей стороны](#use-third-party-providers) для инструкций по настройке.26* Учётная запись Anthropic: подойдёт любая платная подписка Claude (Pro, Max, Ultra, Team или Enterprise) или учётная запись Claude Console, API-ключ не требуется. Вы [войдёте](https://code.claude.com/docs/ru/authentication.md#log-in-to-claude-code) с помощью этой учётной записи при первом открытии расширения. Если вы получаете доступ к Claude через поставщика услуг третьей стороны, такого как Amazon Bedrock или Google Cloud's Agent Platform, см. [Использование поставщиков третьей стороны](#use-third-party-providers) для инструкций по настройке.

27 27 

28> [!TIP]28> [!TIP]

29>29>

38 38 

39Или в VS Code нажмите `Cmd+Shift+X` (Mac) или `Ctrl+Shift+X` (Windows/Linux), чтобы открыть представление Extensions, найдите «Claude Code» и нажмите **Install**.39Или в VS Code нажмите `Cmd+Shift+X` (Mac) или `Ctrl+Shift+X` (Windows/Linux), чтобы открыть представление Extensions, найдите «Claude Code» и нажмите **Install**.

40 40 

41> [!NOTE]

42>

43> Маркетплейсы расширений — это стороннее программное обеспечение, которое Anthropic не одобряет, не поддерживает и не проверяет. Anthropic отправляет расширения для публикации в Visual Studio Marketplace и Open VSX Registry.

44 

41Номер версии расширения соответствует версии Claude Code, которая в него входит. Например, для функции, требующей Claude Code v2.1.286 или новее, нужна версия расширения 2.1.286 или новее; её можно увидеть в представлении Extensions.45Номер версии расширения соответствует версии Claude Code, которая в него входит. Например, для функции, требующей Claude Code v2.1.286 или новее, нужна версия расширения 2.1.286 или новее; её можно увидеть в представлении Extensions.

42 46 

43Claude Code также работает в других редакторах и контейнерах:47Claude Code также работает в других редакторах и контейнерах:

44 48 

45* **Другие форки VS Code**: расширение также устанавливается в форках, таких как Devin Desktop или Kiro. Найдите «Claude Code» в представлении Extensions редактора или установите его из [реестра Open VSX](https://open-vsx.org/extension/Anthropic/claude-code).49* **Другие форки VS Code**: расширение также устанавливается в форках, таких как Devin Desktop или Kiro. Найдите «Claude Code» в представлении Extensions редактора или установите его из [Open VSX Registry](https://open-vsx.org/extension/Anthropic/claude-code).

46* **Редакторы, в которые нельзя установить расширение**: [установите CLI](https://code.claude.com/docs/ru/quickstart.md) и запускайте `claude` во встроенном терминале редактора. CLI работает в любом терминале.50* **Редакторы, в которые нельзя установить расширение**: [установите CLI](https://code.claude.com/docs/ru/quickstart.md) и запускайте `claude` во встроенном терминале редактора. CLI работает в любом терминале.

47* **Dev-контейнеры**: чтобы запустить Claude Code внутри dev-контейнера, см. раздел [Контейнеры для разработки](https://code.claude.com/docs/ru/devcontainer.md).51* **Dev-контейнеры**: чтобы запустить Claude Code внутри dev-контейнера, см. раздел [Контейнеры для разработки](https://code.claude.com/docs/ru/devcontainer.md).

48 52 

117 121 

118Поле ввода промпта поддерживает несколько функций:122Поле ввода промпта поддерживает несколько функций:

119 123 

120* **Режимы разрешений**: нажмите на индикатор режима внизу поля ввода промпта, чтобы переключить режим разрешений. В Claude Code v2.1.283 и более поздних версиях Auto является встроенным начальным режимом разрешений, а в более ранних версиях — только на тарифах Pro, Max и Team. О том, что на это влияет, и обо всех режимах разрешений, которые предлагает индикатор, см. в разделе [как расширение выбирает начальный режим разрешений](https://code.claude.com/docs/ru/permission-modes.md#switch-permission-modes).124* **Режимы разрешений**: нажмите на индикатор режима внизу поля ввода промпта, чтобы переключить режим разрешений. В Claude Code v2.1.283 и более поздних версиях Auto является встроенным начальным режимом разрешений, а в более ранних версиях — только на тарифах Pro, Max, Ultra и Team. О том, что на это влияет, и обо всех режимах разрешений, которые предлагает индикатор, см. в разделе [как расширение выбирает начальный режим разрешений](https://code.claude.com/docs/ru/permission-modes.md#switch-permission-modes).

121 * **Auto**: классификатор проверяет большинство действий вместо того, чтобы спрашивать вас. О том, что он проверяет и блокирует, см. в разделе [авторежим](https://code.claude.com/docs/ru/permission-modes.md#eliminate-prompts-with-auto-mode).125 * **Auto**: классификатор проверяет большинство действий вместо того, чтобы спрашивать вас. О том, что он проверяет и блокирует, см. в разделе [авторежим](https://code.claude.com/docs/ru/permission-modes.md#eliminate-prompts-with-auto-mode).

122 * **Manual**: Claude запрашивает разрешение перед редактированием файлов и большинством shell-команд.126 * **Manual**: Claude запрашивает разрешение перед редактированием файлов и большинством shell-команд.

123 * **Plan**: Claude описывает, что собирается сделать, и ждёт подтверждения, прежде чем вносить изменения. VS Code автоматически открывает план как полноценный документ Markdown, в котором можно добавлять встроенные комментарии, чтобы дать обратную связь до того, как Claude начнёт работу.127 * **Plan**: Claude описывает, что собирается сделать, и ждёт подтверждения, прежде чем вносить изменения. VS Code автоматически открывает план как полноценный документ Markdown, в котором можно добавлять встроенные комментарии, чтобы дать обратную связь до того, как Claude начнёт работу.

656 660 

657Вызовите обработчик с помощью средства открытия URL вашей операционной системы.661Вызовите обработчик с помощью средства открытия URL вашей операционной системы.

658 662 

659**macOS**663> [tab] macOS

660 664>

661```bash theme={null}665> ```bash theme={null}

662open "vscode://anthropic.claude-code/open"666> open "vscode://anthropic.claude-code/open"

663```667> ```

664 

665**Linux**

666 

667```bash theme={null}

668xdg-open "vscode://anthropic.claude-code/open"

669```

670 

671Команда `xdg-open` входит в пакет `xdg-utils`. Если оболочка сообщает, что команда не найдена, см. раздел [xdg-open не найден в Linux](https://code.claude.com/docs/ru/deep-links.md#xdg-open-is-not-found-on-linux).

672 

673**Windows**

674 

675В PowerShell:

676 

677```powershell theme={null}

678Start-Process "vscode://anthropic.claude-code/open"

679```

680 668 

681В `cmd.exe` команда `start` воспринимает первый аргумент в кавычках как заголовок окна, поэтому передайте пустой заголовок перед URL:669> [tab] Linux

670>

671> ```bash theme={null}

672> xdg-open "vscode://anthropic.claude-code/open"

673> ```

674>

675> Команда `xdg-open` входит в пакет `xdg-utils`. Если оболочка сообщает, что команда не найдена, см. раздел [xdg-open не найден в Linux](https://code.claude.com/docs/ru/deep-links.md#xdg-open-is-not-found-on-linux).

682 676 

683```cmd theme={null}677> [tab] Windows

684start "" "vscode://anthropic.claude-code/open"678>

685```679> В PowerShell:

680>

681> ```powershell theme={null}

682> Start-Process "vscode://anthropic.claude-code/open"

683> ```

684>

685> В `cmd.exe` команда `start` воспринимает первый аргумент в кавычках как заголовок окна, поэтому передайте пустой заголовок перед URL:

686>

687> ```cmd theme={null}

688> start "" "vscode://anthropic.claude-code/open"

689> ```

686 690 

687Обработчик принимает два необязательных параметра запроса:691Обработчик принимает два необязательных параметра запроса:

688 692 

704Расширение настраивается в двух местах: в настройках расширения VS Code и в файле настроек Claude Code:708Расширение настраивается в двух местах: в настройках расширения VS Code и в файле настроек Claude Code:

705 709 

706* **Настройки расширения** в VS Code: управляют поведением расширения внутри VS Code. Откройте их с помощью `Cmd+,` (Mac) или `Ctrl+,` (Windows/Linux), затем перейдите в **Extensions > Claude Code**. Также можно ввести `/` и выбрать **General config…**, чтобы открыть настройки.710* **Настройки расширения** в VS Code: управляют поведением расширения внутри VS Code. Откройте их с помощью `Cmd+,` (Mac) или `Ctrl+,` (Windows/Linux), затем перейдите в **Extensions > Claude Code**. Также можно ввести `/` и выбрать **General config…**, чтобы открыть настройки.

707* **Настройки Claude Code** в `~/.claude/settings.json`: общие для расширения и CLI. Используйте их для разрешённых команд, переменных окружения, хуков и MCP-серверов. В Claude Code v2.1.283 и более поздних версиях они также являются одним из факторов, определяющих режим разрешений, в котором начинаются диалоги, а в более ранних версиях — только в планах Pro, Max и Team. Порядок приведён в разделе [Переключение режимов разрешений](https://code.claude.com/docs/ru/permission-modes.md#switch-permission-modes). Подробнее см. в разделе [Настройки](https://code.claude.com/docs/ru/settings.md).711* **Настройки Claude Code** в `~/.claude/settings.json`: общие для расширения и CLI. Используйте их для разрешённых команд, переменных окружения, хуков и MCP-серверов. В Claude Code v2.1.283 и более поздних версиях они также являются одним из факторов, определяющих режим разрешений, в котором начинаются диалоги, а в более ранних версиях — только в планах Pro, Max, Ultra и Team. Порядок приведён в разделе [Переключение режимов разрешений](https://code.claude.com/docs/ru/permission-modes.md#switch-permission-modes). Подробнее см. в разделе [Настройки](https://code.claude.com/docs/ru/settings.md).

708 712 

709> [!TIP]713> [!TIP]

710>714>

933 937 

934* Убедитесь, что у вас совместимая версия VS Code (1.94.0 или новее)938* Убедитесь, что у вас совместимая версия VS Code (1.94.0 или новее)

935* Проверьте, что у VS Code есть разрешение на установку расширений939* Проверьте, что у VS Code есть разрешение на установку расширений

936* Попробуйте установить расширение напрямую из [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code)940* Попробуйте установить расширение напрямую из [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code)

937 941 

938### Значок Spark не отображается942### Значок Spark не отображается

939 943 

Details

8 8 

9> [!NOTE]9> [!NOTE]

10>10>

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

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 

77 77 

78[Облачное окружение](https://code.claude.com/docs/ru/cloud-environments.md) — это сохраненная конфигурация, которая контролирует, какой доступ в сеть имеет Claude во время сеансов и что запускается при запуске сеанса. То, что происходит после подключения GitHub, зависит от вашего плана:78[Облачное окружение](https://code.claude.com/docs/ru/cloud-environments.md) — это сохраненная конфигурация, которая контролирует, какой доступ в сеть имеет Claude во время сеансов и что запускается при запуске сеанса. То, что происходит после подключения GitHub, зависит от вашего плана:

79 79 

80* **Pro и Max**: встроенная настройка создает для вас окружение с именем **Default**.80* **Pro, Max и Ultra**: вы автоматически получаете окружение с именем **Default**.

81* **Team и Enterprise**: встроенная настройка показывает форму **Create your first cloud environment**. Оставьте предзаполненное имя и доступ в сеть без изменений и нажмите **Create & finish**, чтобы создать окружение **Default**. Если Owner включил [Quick setup](https://code.claude.com/docs/ru/claude-code-on-the-web.md#quick-setup-for-team-and-enterprise), встроенная настройка создаёт **Default** для вас вместо этого.81* **Team и Enterprise**: встроенная настройка показывает форму **Create your first cloud environment**. Оставьте предзаполненное имя и доступ в сеть без изменений и нажмите **Create & finish**, чтобы создать окружение **Default**. Если Owner включил [Quick setup](https://code.claude.com/docs/ru/claude-code-on-the-web.md#quick-setup-for-team-and-enterprise), встроенная настройка создаёт **Default** для вас вместо этого.

82 82 

83**Default** использует [`Trusted` доступ в сеть](https://code.claude.com/docs/ru/cloud-environments#access-levels): сеансы получают доступ к [общим реестрам пакетов](https://code.claude.com/docs/ru/cloud-environments.md#default-allowed-domains) и другим доменам в списке разрешений, и ничему больше через сеть сеанса. Смотрите [Installed tools](https://code.claude.com/docs/ru/cloud-environments.md#installed-tools) для того, что доступно без какой-либо конфигурации.83**Default** использует [`Trusted` доступ в сеть](https://code.claude.com/docs/ru/cloud-environments#access-levels): сеансы получают доступ к [общим реестрам пакетов](https://code.claude.com/docs/ru/cloud-environments.md#default-allowed-domains) и другим доменам в списке разрешений, и ничему больше через сеть сеанса. Смотрите [Installed tools](https://code.claude.com/docs/ru/cloud-environments.md#installed-tools) для того, что доступно без какой-либо конфигурации.