Documentation 2026-06-13 21:59 UTC to 2026-06-15 23:02 UTC

16 16 

17Каждая сессия агента следует одному и тому же циклу:17Каждая сессия агента следует одному и тому же циклу:

18 18 

19<img src="https://mintcdn.com/claude-code/gvy2DIUELtNA8qD3/images/agent-loop-diagram.svg?fit=max&auto=format&n=gvy2DIUELtNA8qD3&q=85&s=192e1bd6c8a2950a16e5ee0b94e27e26" alt="Цикл агента: запрос входит, Claude оценивает, ветвится на вызовы инструментов или финальный ответ" width="680" height="150" data-path="images/agent-loop-diagram.svg" />19<img src="https://mintcdn.com/claude-code/ikqp3_70mqIahteV/images/agent-loop-diagram.svg?fit=max&auto=format&n=ikqp3_70mqIahteV&q=85&s=1c6e8f28d80dba14a7287419656f1237" alt="Цикл агента: запрос входит, Claude оценивает, ветвится на вызовы инструментов или финальный ответ" width="720" height="212" data-path="images/agent-loop-diagram.svg" />

20 20 

211. **Получить запрос.** Claude получает ваш запрос вместе с системным запросом, определениями инструментов и историей разговора. SDK выдает [`SystemMessage`](#message-types) с подтипом `"init"`, содержащий метаданные сессии.211. **Получить запрос.** Claude получает ваш запрос вместе с системным запросом, определениями инструментов и историей разговора. SDK выдает [`SystemMessage`](#message-types) с подтипом `"init"`, содержащий метаданные сессии.

222. **Оценить и ответить.** Claude оценивает текущее состояние и определяет, как действовать дальше. Он может ответить текстом, запросить один или несколько вызовов инструментов или оба варианта. SDK выдает [`AssistantMessage`](#message-types), содержащее текст и любые запросы вызовов инструментов.222. **Оценить и ответить.** Claude оценивает текущее состояние и определяет, как действовать дальше. Он может ответить текстом, запросить один или несколько вызовов инструментов или оба варианта. SDK выдает [`AssistantMessage`](#message-types), содержащее текст и любые запросы вызовов инструментов.

39 39 

40На следующей диаграмме показан поток сообщений от одного вызова `query()` с использованием токенов, сообщаемым на каждом шаге и совокупной оценкой в конце:40На следующей диаграмме показан поток сообщений от одного вызова `query()` с использованием токенов, сообщаемым на каждом шаге и совокупной оценкой в конце:

41 41 

42<img src="https://mintcdn.com/claude-code/Dujg43sxTkuhSELI/images/agent-sdk/message-usage-flow.svg?fit=max&auto=format&n=Dujg43sxTkuhSELI&q=85&s=c542f51ff58547ef9c0e57b16d03f33c" alt="Диаграмма, показывающая запрос, создающий два шага сообщений. Шаг 1 имеет четыре сообщения помощника с одинаковым ID и использованием (считать один раз), Шаг 2 имеет одно сообщение помощника с новым ID, и финальное результирующее сообщение показывает предполагаемый total_cost_usd." width="760" height="520" data-path="images/agent-sdk/message-usage-flow.svg" />42<img src="https://mintcdn.com/claude-code/ikqp3_70mqIahteV/images/agent-sdk/message-usage-flow.svg?fit=max&auto=format&n=ikqp3_70mqIahteV&q=85&s=68497aee338e01cc745323af7aea378e" alt="Диаграмма, показывающая запрос, создающий два шага сообщений. Шаг 1 имеет четыре сообщения помощника с одинаковым ID и использованием (считать один раз), Шаг 2 имеет одно сообщение помощника с новым ID, и финальное результирующее сообщение показывает предполагаемый total_cost_usd." width="760" height="520" data-path="images/agent-sdk/message-usage-flow.svg" />

43 43 

44<Steps>44<Steps>

45 <Step title="Каждый шаг создаёт сообщения помощника">45 <Step title="Каждый шаг создаёт сообщения помощника">

22 22 

23Каждое решение о размещении на этой странице следует из того, как SDK запускает агента. Когда ваш код вызывает `query()`, SDK порождает отдельный процесс CLI `claude` и взаимодействует с ним через stdio. Этот подпроцесс владеет оболочкой, рабочей директорией и транскриптами сеанса JSONL на локальном диске.23Каждое решение о размещении на этой странице следует из того, как SDK запускает агента. Когда ваш код вызывает `query()`, SDK порождает отдельный процесс CLI `claude` и взаимодействует с ним через stdio. Этот подпроцесс владеет оболочкой, рабочей директорией и транскриптами сеанса JSONL на локальном диске.

24 24 

25<img src="https://mintcdn.com/claude-code/Akpoo6g0xDlAmvHv/images/agent-sdk/hosting-subprocess.svg?fit=max&auto=format&n=Akpoo6g0xDlAmvHv&q=85&s=d348cc9687d47e0bc954075fd88d0e60" alt="Поток запроса: от клиента к вашему приложению, которое порождает подпроцесс claude CLI через stdio внутри контейнера; подпроцесс записывает на локальный диск и вызывает api.anthropic.com через HTTPS" width="920" height="220" data-path="images/agent-sdk/hosting-subprocess.svg" />25<img src="https://mintcdn.com/claude-code/ikqp3_70mqIahteV/images/agent-sdk/hosting-subprocess.svg?fit=max&auto=format&n=ikqp3_70mqIahteV&q=85&s=9dac857ca9d3b1410c3734900c386004" alt="Поток запроса: от клиента к вашему приложению, которое порождает подпроцесс claude CLI через stdio внутри контейнера; подпроцесс записывает на локальный диск и вызывает api.anthropic.com через HTTPS" width="920" height="220" data-path="images/agent-sdk/hosting-subprocess.svg" />

26 26 

27Один сеанс агента соответствует одному подпроцессу. Запуск N одновременных сеансов означает N подпроцессов, каждый со своим деревом процессов и файлом транскрипта. По умолчанию они все наследуют рабочую директорию вашего приложения, поэтому передавайте `cwd` при каждом вызове `query()`, когда сеансам нужны отдельные файловые системы:27Один сеанс агента соответствует одному подпроцессу. Запуск N одновременных сеансов означает N подпроцессов, каждый со своим деревом процессов и файлом транскрипта. По умолчанию они все наследуют рабочую директорию вашего приложения, поэтому передавайте `cwd` при каждом вызове `query()`, когда сеансам нужны отдельные файловые системы:

28 28 

6 6 

7> Создавайте производственные AI-агентов с Claude Code как библиотеку7> Создавайте производственные AI-агентов с Claude Code как библиотеку

8 8 

9<Note>

10 Starting June 15, 2026, Agent SDK and `claude -p` usage on subscription plans will draw from a new monthly Agent SDK credit, separate from your interactive usage limits. See [Use the Claude Agent SDK with your Claude plan](https://support.claude.com/en/articles/15036540-use-the-claude-agent-sdk-with-your-claude-plan) for details.

11</Note>

12 

13Создавайте AI-агентов, которые автономно читают файлы, запускают команды, ищут в интернете, редактируют код и многое другое. Agent SDK предоставляет вам те же инструменты, цикл агента и управление контекстом, которые питают Claude Code, программируемые на Python и TypeScript.9Создавайте AI-агентов, которые автономно читают файлы, запускают команды, ищут в интернете, редактируют код и многое другое. Agent SDK предоставляет вам те же инструменты, цикл агента и управление контекстом, которые питают Claude Code, программируемые на Python и TypeScript.

14 10 

15<CodeGroup>11<CodeGroup>

40 </Step>40 </Step>

41</Steps>41</Steps>

42 42 

43<img src="https://mintcdn.com/claude-code/FEspvVUyRuaWjm0s/images/agent-sdk/permissions-flow.svg?fit=max&auto=format&n=FEspvVUyRuaWjm0s&q=85&s=a1759b0cf4541281a9fdd8f5348228e8" alt="Диаграмма потока оценки разрешений" width="920" height="260" data-path="images/agent-sdk/permissions-flow.svg" />43<img src="https://mintcdn.com/claude-code/ikqp3_70mqIahteV/images/agent-sdk/permissions-flow.svg?fit=max&auto=format&n=ikqp3_70mqIahteV&q=85&s=cc94220087262cd48c9b64a14c4e1c2c" alt="Диаграмма потока оценки разрешений" width="1024" height="260" data-path="images/agent-sdk/permissions-flow.svg" />

44 44 

45На этой странице основное внимание уделяется **правилам allow и deny** и **режимам разрешений**. Для других шагов:45На этой странице основное внимание уделяется **правилам allow и deny** и **режимам разрешений**. Для других шагов:

46 46 

159 Создание долгоживущего токена159 Создание долгоживущего токена

160</h3>160</h3>

161 161 

162<Note>

163 Starting June 15, 2026, Agent SDK and `claude -p` usage on subscription plans will draw from a new monthly Agent SDK credit, separate from your interactive usage limits. See [Use the Claude Agent SDK with your Claude plan](https://support.claude.com/en/articles/15036540-use-the-claude-agent-sdk-with-your-claude-plan) for details.

164</Note>

165 

166Для конвейеров CI, скриптов или других сред, где интерактивный вход через браузер недоступен, создайте однолетний токен OAuth с помощью `claude setup-token`:162Для конвейеров CI, скриптов или других сред, где интерактивный вход через браузер недоступен, создайте однолетний токен OAuth с помощью `claude setup-token`:

167 163 

168```bash theme={null}164```bash theme={null}

83 83 

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

85 85 

86<img src="https://mintcdn.com/claude-code/RcOyXc06Ja8cuvMZ/images/claude-code-data-flow.svg?fit=max&auto=format&n=RcOyXc06Ja8cuvMZ&q=85&s=b5be40abf333defe984993af89546c19" alt="Диаграмма, показывающая внешние соединения Claude Code: установка/обновление подключается к серверу распределения, а запросы пользователя подключаются к сервисам Anthropic, включая Console auth, public-api, и опционально metrics, Sentry и отчёты об ошибках" width="720" height="520" data-path="images/claude-code-data-flow.svg" />86<img src="https://mintcdn.com/claude-code/ikqp3_70mqIahteV/images/claude-code-data-flow.svg?fit=max&auto=format&n=ikqp3_70mqIahteV&q=85&s=5b1131530bdfdd415700a0cb4d4070c4" alt="Диаграмма, показывающая внешние соединения Claude Code: установка/обновление подключается к серверу распределения, а запросы пользователя подключаются к сервисам Anthropic, включая Console auth, public-api, и опционально metrics, Sentry и отчёты об ошибках" width="720" height="520" data-path="images/claude-code-data-flow.svg" />

87 87 

88Claude Code работает локально. Для взаимодействия с LLM Claude Code отправляет данные по сети. Эти данные включают все подсказки пользователя и выходные данные модели, зашифрованные при передаче через TLS 1.2+. Claude Code совместим с большинством популярных VPN и прокси LLM.88Claude Code работает локально. Для взаимодействия с LLM Claude Code отправляет данные по сети. Эти данные включают все подсказки пользователя и выходные данные модели, зашифрованные при передаче через TLS 1.2+. Claude Code совместим с большинством популярных VPN и прокси LLM.

89 89 

247 247 

248Каждая функция загружается в разные точки вашей сессии. Вкладки ниже объясняют, когда загружается каждая и что входит в контекст.248Каждая функция загружается в разные точки вашей сессии. Вкладки ниже объясняют, когда загружается каждая и что входит в контекст.

249 249 

250<img src="https://mintcdn.com/claude-code/6yTCYq1p37ZB8-CQ/images/context-loading.svg?fit=max&auto=format&n=6yTCYq1p37ZB8-CQ&q=85&s=5a58ce953a35a2412892015e2ad6cb67" alt="Загрузка контекста: CLAUDE.md загружается в начале сессии и остаётся в каждом запросе. Имена инструментов MCP загружаются в начале с полными схемами отложенными до использования. Skills загружают описания в начале, полный контент при вызове. Subagents получают изолированный контекст. Hooks работают внешне." width="720" height="410" data-path="images/context-loading.svg" />250<img src="https://mintcdn.com/claude-code/ikqp3_70mqIahteV/images/context-loading.svg?fit=max&auto=format&n=ikqp3_70mqIahteV&q=85&s=aab139e750494a237ae2e0c8f9139b0a" alt="Загрузка контекста: CLAUDE.md загружается в начале сессии и остаётся в каждом запросе. Имена инструментов MCP загружаются в начале с полными схемами отложенными до использования. Skills загружают описания в начале, полный контент при вызове. Subagents получают изолированный контекст. Hooks работают внешне." width="720" height="382" data-path="images/context-loading.svg" />

251 251 

252<Tabs>252<Tabs>

253 <Tab title="CLAUDE.md">253 <Tab title="CLAUDE.md">

6 6 

7> Используйте Agent SDK для программного запуска Claude Code из CLI, Python или TypeScript.7> Используйте Agent SDK для программного запуска Claude Code из CLI, Python или TypeScript.

8 8 

9<Note>

10 Starting June 15, 2026, Agent SDK and `claude -p` usage on subscription plans will draw from a new monthly Agent SDK credit, separate from your interactive usage limits. See [Use the Claude Agent SDK with your Claude plan](https://support.claude.com/en/articles/15036540-use-the-claude-agent-sdk-with-your-claude-plan) for details.

11</Note>

12 

13[Agent SDK](/ru/agent-sdk/overview) предоставляет вам те же инструменты, цикл агента и управление контекстом, которые питают Claude Code. Он доступен как CLI для скриптов и CI/CD, или как пакеты [Python](/ru/agent-sdk/python) и [TypeScript](/ru/agent-sdk/typescript) для полного программного управления.9[Agent SDK](/ru/agent-sdk/overview) предоставляет вам те же инструменты, цикл агента и управление контекстом, которые питают Claude Code. Он доступен как CLI для скриптов и CI/CD, или как пакеты [Python](/ru/agent-sdk/python) и [TypeScript](/ru/agent-sdk/typescript) для полного программного управления.

14 10 

15Чтобы запустить Claude Code в неинтерактивном режиме, передайте `-p` с вашим запросом и любыми [параметрами CLI](/ru/cli-reference):11Чтобы запустить Claude Code в неинтерактивном режиме, передайте `-p` с вашим запросом и любыми [параметрами CLI](/ru/cli-reference):

108Теперь предположим, что Claude Code решает запустить `Bash "rm -rf /tmp/build"`. Вот что происходит:108Теперь предположим, что Claude Code решает запустить `Bash "rm -rf /tmp/build"`. Вот что происходит:

109 109 

110<Frame>110<Frame>

111 <img src="https://mintcdn.com/claude-code/-tYw1BD_DEqfyyOZ/images/hook-resolution.svg?fit=max&auto=format&n=-tYw1BD_DEqfyyOZ&q=85&s=c73ebc1eeda2037570427d7af1e0a891" alt="Поток разрешения hook: срабатывает событие PreToolUse, фильтр проверяет совпадение Bash, условие if проверяет совпадение Bash(rm *), запускается обработчик hook, результат возвращается в Claude Code" width="930" height="290" data-path="images/hook-resolution.svg" />111 <img src="https://mintcdn.com/claude-code/ikqp3_70mqIahteV/images/hook-resolution.svg?fit=max&auto=format&n=ikqp3_70mqIahteV&q=85&s=be0bf3053550c26de5f54cd64674c197" alt="Поток разрешения hook: срабатывает событие PreToolUse, фильтр проверяет совпадение Bash, условие if проверяет совпадение Bash(rm *), запускается обработчик hook, результат возвращается в Claude Code" width="930" height="270" data-path="images/hook-resolution.svg" />

112</Frame>112</Frame>

113 113 

114<Steps>114<Steps>

16 16 

17Когда вы даёте Claude задачу, он работает через три фазы: **сбор контекста**, **выполнение действия** и **проверка результатов**. Эти фазы переплетаются. Claude использует инструменты на протяжении всего процесса, будь то поиск файлов для понимания вашего кода, редактирование для внесения изменений или запуск тестов для проверки своей работы.17Когда вы даёте Claude задачу, он работает через три фазы: **сбор контекста**, **выполнение действия** и **проверка результатов**. Эти фазы переплетаются. Claude использует инструменты на протяжении всего процесса, будь то поиск файлов для понимания вашего кода, редактирование для внесения изменений или запуск тестов для проверки своей работы.

18 18 

19<img src="https://mintcdn.com/claude-code/c5r9_6tjPMzFdDDT/images/agentic-loop.svg?fit=max&auto=format&n=c5r9_6tjPMzFdDDT&q=85&s=5f1827dec8539f38adee90ead3a85a38" alt="Агентивный цикл: ваш запрос приводит к тому, что Claude собирает контекст, выполняет действия, проверяет результаты и повторяет процесс до завершения задачи. Вы можете прервать процесс в любой момент." width="720" height="280" data-path="images/agentic-loop.svg" />19<img src="https://mintcdn.com/claude-code/ikqp3_70mqIahteV/images/agentic-loop.svg?fit=max&auto=format&n=ikqp3_70mqIahteV&q=85&s=4a30fb7ce2815012a9f27c955e2c6bb0" alt="Агентивный цикл: ваш запрос приводит к тому, что Claude собирает контекст, выполняет действия, проверяет результаты и повторяет процесс до завершения задачи. Вы можете прервать процесс в любой момент." width="720" height="280" data-path="images/agentic-loop.svg" />

20 20 

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

22 22 

130 130 

131Возобновление сеанса с помощью `claude --continue` или `claude --resume` открывает его повторно с тем же ID сеанса и добавляет новые сообщения к существующей беседе. Разветвление с помощью `--fork-session` или `/branch` копирует историю в новый ID сеанса, оставляя исходный неизменным.131Возобновление сеанса с помощью `claude --continue` или `claude --resume` открывает его повторно с тем же ID сеанса и добавляет новые сообщения к существующей беседе. Разветвление с помощью `--fork-session` или `/branch` копирует историю в новый ID сеанса, оставляя исходный неизменным.

132 132 

133<img src="https://mintcdn.com/claude-code/c5r9_6tjPMzFdDDT/images/session-continuity.svg?fit=max&auto=format&n=c5r9_6tjPMzFdDDT&q=85&s=fa41d12bfb57579cabfeece907151d30" alt="Непрерывность сеанса: возобновление продолжает тот же сеанс, разветвление создаёт новую ветвь с новым ID." width="560" height="280" data-path="images/session-continuity.svg" />133<img src="https://mintcdn.com/claude-code/ikqp3_70mqIahteV/images/session-continuity.svg?fit=max&auto=format&n=ikqp3_70mqIahteV&q=85&s=04ed0984a58e4127e05b3640265241a3" alt="Непрерывность сеанса: возобновление продолжает тот же сеанс, разветвление создаёт новую ветвь с новым ID." width="560" height="280" data-path="images/session-continuity.svg" />

134 134 

135Информацию о флагах возобновления, средстве выбора `/resume`, именовании и том, что происходит, когда один и тот же сеанс открыт в двух терминалах, см. в разделе [Управление сеансами](/ru/sessions).135Информацию о флагах возобновления, средстве выбора `/resume`, именовании и том, что происходит, когда один и тот же сеанс открыт в двух терминалах, см. в разделе [Управление сеансами](/ru/sessions).

136 136 

6 6 

7> Правовые соглашения, сертификаты соответствия и информация о безопасности для Claude Code.7> Правовые соглашения, сертификаты соответствия и информация о безопасности для Claude Code.

8 8 

9<Note>

10 Starting June 15, 2026, Agent SDK and `claude -p` usage on subscription plans will draw from a new monthly Agent SDK credit, separate from your interactive usage limits. See [Use the Claude Agent SDK with your Claude plan](https://support.claude.com/en/articles/15036540-use-the-claude-agent-sdk-with-your-claude-plan) for details.

11</Note>

12 

13<h2 id="legal-agreements">9<h2 id="legal-agreements">

14 Правовые соглашения10 Правовые соглашения

15</h2>11</h2>