--- title: Получение стенограмм сеансов url: https://platform.claude.com/docs/ru/manage-claude/compliance-sessions description: Получайте список сеансов, которые ваши пользователи запускают в приложениях и агентах Claude, таких как Claude Cowork и Claude Code, и извлекайте их стенограммы через Compliance API. --- Конечные точки на этой странице доступны только организациям Claude Enterprise. Конечные точки локальных и удалённых сеансов стабильны для сеансов Cowork, Claude Code и Claude for Microsoft 365; поддержка сеансов Claude Science и Claude in Chrome находится в бета-версии. Эти конечные точки работают с тем же Compliance Access Key и областью `read:compliance_user_data`, что и [конечные точки чатов, файлов и проектов](https://platform.claude.com/docs/ru/manage-claude/compliance-content-data); новый ключ, область, настройка или обновление клиента не требуются. См. [Настройка Compliance API](https://platform.claude.com/docs/ru/manage-claude/compliance-api-access). **Требуемая область:** `read:compliance_user_data` для Compliance Access Key. **Предварительные условия:** для получения списка сеансов по всей организации — нет. Чтобы отфильтровать список удалённых сеансов (сеансов в облаке) по конкретным пользователям, вам понадобятся идентификаторы пользователей из [Список пользователей организации](https://platform.claude.com/docs/ru/manage-claude/compliance-org-data#list-organization-users); у списка локальных сеансов нет фильтра по пользователям. Конечные точки на этой странице предоставляют специалистам по проверке соответствия требованиям «transcripts» (стенограммы) сеансов, которые ваши пользователи запускают в приложениях и агентах Claude (на сегодняшний день: Cowork, Claude Code, Claude Science, Claude for Microsoft 365 и Claude in Chrome) в ваших организациях Claude Enterprise. Каждый «session» (сеанс) — это отдельный разговор с Claude; его стенограмма представляет собой последовательность пользовательских подсказок, ответов ассистента, а также вызовов инструментов и их результатов в этом разговоре. Конечные точки поддерживают экспорт для «eDiscovery» (электронного раскрытия информации) и применение политик «data loss prevention» (предотвращения утечки данных), или DLP. Compliance API группирует сеансы в два семейства конечных точек в зависимости от того, где они выполняются: конечные точки локальных сеансов — для сеансов на компьютерах пользователей, и конечные точки удалённых сеансов — для сеансов, которые выполняются в облаке в средах, управляемых Anthropic. Оба семейства доступны только для чтения, и ни одно из них не доступно для ключей Admin API (`sk-ant-admin01-...`): вызовы, аутентифицированные с помощью ключа Admin API, возвращают [403 Forbidden](https://platform.claude.com/docs/ru/manage-claude/compliance-errors#403-forbidden). В следующей таблице для каждого продукта и места его выполнения указано семейство конечных точек, которое возвращает его сеансы, и значение `product_surface`, которое идентифицирует их в ответах. Продукты добавляются в эту таблицу по мере расширения охвата. | Продукт и место выполнения | Семейство конечных точек | `product_surface` | | ---------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------- | | Cowork в Claude Desktop, выполняется на компьютере пользователя | Конечные точки локальных сеансов (`/v1/compliance/apps/sessions/local`) | `cowork` | | Claude Code в терминале, в Claude Desktop или в расширении IDE, выполняется на компьютере пользователя | Конечные точки локальных сеансов | `claude_code` | | Настольное приложение Claude Science, выполняется на компьютере пользователя | Конечные точки локальных сеансов | `claude_science` | | Claude for Microsoft 365 (надстройки Claude для Excel, PowerPoint, Word и Outlook), выполняется в настольных или веб-приложениях Microsoft 365 | Конечные точки локальных сеансов | `office_agents/excel`, `office_agents/powerpoint`, `office_agents/word` или `office_agents/outlook` (`office_agents`, если приложение не определено) | | Claude in Chrome (встроенный чат расширения браузера), выполняется на компьютере пользователя | Конечные точки локальных сеансов | `claude_in_chrome` | | Сеансы Cowork, запущенные в веб-версии или мобильном приложении claude.ai, выполняются в облаке в средах, управляемых Anthropic | Конечные точки удалённых сеансов (`/v1/compliance/apps/sessions/remote`) | `cowork_remote` | Сбор локальных сеансов привязан к тому, что Compliance API включён для вашей организации, и применяется, пока пользователи выполнили вход со своей учётной записью Claude Enterprise. Конечные точки сеансов не возвращают следующее: * Сеансы Claude Code, аутентифицированные с помощью ключа API Claude Console или запущенные через стороннюю облачную платформу, такую как Amazon Bedrock, Google Cloud или Microsoft Foundry. * [Облачные сеансы Claude Code](https://code.claude.com/docs/ru/claude-code-on-the-web) (включая процедуры Claude Code, выполняемые в облаке), которые выполняются в облачной инфраструктуре, а не на компьютере пользователя. Эти облачные сеансы не являются удалёнными сеансами, хотя и те и другие выполняются в облаке; конечные точки удалённых сеансов возвращают только сеансы Cowork. * Локальные сеансы продуктов, отличных от Cowork и Claude Code, в организациях с включённой [готовностью к HIPAA](https://platform.claude.com/docs/ru/manage-claude/api-and-data-retention#hipaa-readiness). В таких организациях конечные точки локальных сеансов возвращают только сеансы Cowork и Claude Code, а собранное содержимое сеансов хранится 30 дней. * Локальные сеансы, для которых действует [«zero data retention» (нулевое хранение данных), или ZDR](https://platform.claude.com/docs/ru/manage-claude/api-and-data-retention#zero-data-retention-zdr-scope). Эти сеансы исключаются из результатов списка, а конечные точки получения сеанса и сообщений возвращают для них 404. Anthropic рекомендует использовать Compliance API для получения содержимого сеансов. В следующей таблице [локальные сеансы](https://platform.claude.com/docs/ru/manage-claude/compliance-sessions#retrieve-local-sessions) и [удалённые сеансы](https://platform.claude.com/docs/ru/manage-claude/compliance-sessions#retrieve-remote-sessions) сравниваются с альтернативами на основе OpenTelemetry, доступными для Cowork и Claude Code: [журналированием OpenTelemetry в Cowork](https://support.claude.com/en/articles/14477985-monitor-claude-cowork-activity-with-opentelemetry) и [мониторингом Claude Code](https://code.claude.com/docs/ru/monitoring-usage). | | Локальные сеансы (на компьютерах пользователей) | Удалённые сеансы (в облаке) | Журналирование OpenTelemetry | | ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------ | | Доставка | Pull: запрос и экспорт по HTTPS | Pull: запрос и экспорт по HTTPS | Push: потоковая передача в ваш коллектор OTLP | | Настройка | Работает с вашим существующим Compliance Access Key | Работает с вашим существующим Compliance Access Key | Администратор настраивает конечную точку OTLP и параметры сбора содержимого | | Инфраструктура | Размещается Anthropic | Размещается Anthropic | Вы управляете коллектором и хранилищем | | Префикс ID | `clls_` | `cse_` | Н/Д | | Значения `product_surface` | `cowork`, `claude_code`, `claude_science`, `claude_in_chrome` и значения, начинающиеся с `office_agents` | `cowork_remote` | Н/Д | | Хранение | По умолчанию 6 лет или пользовательский период хранения разговоров вашей организации, если задан конечный период; 30 дней в организациях с включённой готовностью к HIPAA; хранится Anthropic | 6 лет, если пользователь не удалит сеанс раньше; хранится Anthropic | Ваша инфраструктура, ваши политики | | Пользовательские подсказки и ответы ассистента | Да | Да | Да, в зависимости от параметров сбора содержимого | | Входные данные инструментов | По умолчанию усекаются до 10 000 байт на каждый вход; по запросу — примерно до 1 МиБ | По умолчанию усекаются до 10 000 байт на каждый вход; по запросу — примерно до 1 МиБ | Усечённые сводки | | Содержимое результатов инструментов | Каждая текстовая запись по умолчанию усекается до 10 000 байт; по запросу — примерно до 1 МиБ | Каждая текстовая запись по умолчанию усекается до 10 000 байт; по запросу — примерно до 1 МиБ | Метаданные, такие как размер и успешность; Claude Code также может собирать содержимое с помощью необязательной настройки с ограничением размера | | Содержимое файлов | Да, через вызовы инструментов в стенограмме (только текст; прочее содержимое отображается как заполнитель) | Да, через вызовы инструментов в стенограмме (только текст; прочее содержимое опускается) | Пути к файлам; Claude Code также может собирать содержимое с помощью необязательной настройки с ограничением размера | | Метаданные хоста и устройства (тип терминала, пути рабочей области) | Нет | Нет | Да | | Использование токенов и стоимость | Нет; доступно через [Claude Enterprise Analytics API](https://platform.claude.com/docs/ru/manage-claude/analytics-api#get-access-to-the-claude-enterprise-analytics-api) | Нет; доступно через [Claude Enterprise Analytics API](https://platform.claude.com/docs/ru/manage-claude/analytics-api#get-access-to-the-claude-enterprise-analytics-api) | Да | ## Сеансы на компьютерах пользователей (локальные сеансы) Локальные сеансы выполняются на компьютерах пользователей, пока они выполнили вход со своей учётной записью Claude Enterprise: на сегодняшний день это Cowork в Claude Desktop, Claude Code (в терминале, в Claude Desktop или в расширении IDE), настольное приложение Claude Science, Claude for Microsoft 365 (в Excel, PowerPoint, Word и Outlook) и расширение браузера Claude in Chrome. Compliance API предоставляет локальные сеансы через три конечные точки: `GET /v1/compliance/apps/sessions/local` возвращает список метаданных сеансов, `GET /v1/compliance/apps/sessions/local/{session_id}` получает метаданные одного сеанса, а `GET /v1/compliance/apps/sessions/local/{session_id}/messages` возвращает стенограмму одного сеанса. Все три требуют области `read:compliance_user_data` и учитываются только в общем «rate limit» (ограничении скорости) Compliance API; на них не распространяется второй бюджет запросов, который применяется к конечным точкам удалённых сеансов. См. [429 Too Many Requests](https://platform.claude.com/docs/ru/manage-claude/compliance-errors#429-too-many-requests). Если локальные сеансы недоступны для вашей родительской организации, все три конечные точки возвращают 404 с сообщением `Local sessions are not available.` (см. [Локальная сессия не найдена](https://platform.claude.com/docs/ru/manage-claude/compliance-errors#local-session-not-found)); пока списки сеансов или собранное содержимое временно недоступны, они возвращают 503 (см. [Локальные сеансы временно недоступны](https://platform.claude.com/docs/ru/manage-claude/compliance-errors#local-sessions-temporarily-unavailable)). Для локальных сеансов Anthropic записывает каждый разговор на стороне сервера по мере того, как его запросы поступают в Claude API; на устройство ничего не устанавливается, и ничего не собирается сверх запросов, которые клиент уже отправляет в Claude API. Стенограммы локальных сеансов показывают, что Claude попросили сделать и что он вернул, а не то, что происходило на устройстве. Файловая и сетевая активность видна только через вызовы инструментов и результаты инструментов в стенограмме, поэтому активность, которая никогда не достигает API (например, локальные файлы, которые сеанс никогда не отправлял), не собирается. В организациях, использующих [ключи шифрования, управляемые клиентом](https://platform.claude.com/docs/ru/manage-claude/cmek), стенограммы локальных сеансов шифруются вашим ключом, управляемым клиентом, и возвращаются как обычно. Пока этот ключ невозможно использовать (например, потому что вы отключили или отозвали его, или потому что он недоступен), конечная точка сообщений возвращает [503 Service Unavailable](https://platform.claude.com/docs/ru/manage-claude/compliance-errors#local-sessions-temporarily-unavailable) для затронутых страниц вместо содержимого стенограммы. Такие сообщения никогда не помечаются как `not_captured` (см. [Получение стенограммы локального сеанса](https://platform.claude.com/docs/ru/manage-claude/compliance-sessions#retrieve-a-local-session-transcript)). Получение списка сеансов и метаданных сеансов это не затрагивает. Конечная точка списка возвращает метаданные сеансов без содержимого стенограмм для каждой связанной организации, которую может читать ваш ключ. В отличие от списка удалённых сеансов, у неё нет фильтров по организации или пользователю: ограничивайте результаты по времени с помощью параметров `created_at.gte`, `created_at.gt`, `created_at.lt` и `created_at.lte`. Каждый из них принимает метку времени RFC 3339 с обязательным смещением UTC. Если вы указываете и нижнюю, и верхнюю границу, верхняя граница должна быть позже нижней (или равна ей, если вы используете `created_at.gte` вместе с `created_at.lte`), иначе запрос возвращает [400 Bad Request](https://platform.claude.com/docs/ru/manage-claude/compliance-errors#400-bad-request). Отдельный фильтр по времени, `updated_at.gte`, ограничивает по последней активности, а не по первой: он возвращает сеансы, последний вызов инференса которых произошёл в указанное время или позже, и сочетается с фильтрами `created_at`, не меняя порядок сортировки и пагинацию. Используйте его для опроса сеансов, активных с момента предыдущего прохода, как описано далее в этом разделе. Новые сеансы и сообщения появляются в результатах после небольшой задержки обработки, обычно в течение нескольких минут; сеанс, отсутствующий сразу после запуска, не обязательно не был собран. Следующий запрос возвращает список сеансов, созданных начиная с указанной даты. ```bash cURL curl --fail-with-body -sS -G \ "https://api.anthropic.com/v1/compliance/apps/sessions/local" \ --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \ --header "anthropic-version: 2023-06-01" \ --data-urlencode "created_at.gte=2026-07-01T00:00:00Z" \ --data-urlencode "limit=100" ``` ```json Response { "data": [ { "type": "compliance_local_session", "id": "clls_01HxKpLmNoPqRsTuVwXyZaBc", "organization_uuid": "9a1e0000-0000-0000-0000-000000000000", "workspace_id": "wrkspc_01SvYKoWVRVHoEbwESNvzYdR", "user": { "id": "user_01GpKpLmNoPqRsTuVwXyZaBc", "email_address": "engineer@example.com" }, "product_surface": "cowork", "created_at": "2026-07-09T14:02:11Z", "updated_at": "2026-07-09T14:02:38Z" }, { "type": "compliance_local_session", "id": "clls_01HyLqMnOpQrStUvWxYzAbCd", "organization_uuid": "9a1e0000-0000-0000-0000-000000000000", "workspace_id": null, "user": { "id": "user_01HqRsTuVwXyZaBcDeFgHiJk", "email_address": null }, "product_surface": "claude_code", "created_at": "2026-07-08T09:15:43Z", "updated_at": "2026-07-08T09:52:10Z" } ], "next_page": "page_AAEfQx7mPdLkq9Rt2VwHbZk" } ``` Результаты сортируются в обратном хронологическом порядке (сначала новые) по `created_at`, при равенстве — в фиксированном порядке на стороне сервера, и ограничиваются `limit` результатами на ответ (по умолчанию 100, максимум 500). Конечная точка поддерживает пагинацию только вперёд с помощью токенов `page` и `next_page` (см. [Постраничная навигация по результатам](https://platform.claude.com/docs/ru/manage-claude/compliance-activity-feed#paginate-results)): передайте значение `next_page` из ответа в качестве параметра запроса `page` в следующем запросе и остановитесь, когда `next_page` будет `null`. В ответе нет поля `has_more`. Завершайте обход списка в течение 24 часов с момента его начала; более старый курсор списка по-прежнему принимается, но переоценивается относительно текущей границы хранения, поэтому сеансы, самая старая сохранённая активность которых вот-вот выйдет за пределы периода хранения, могут быть пропущены. В каждом объекте сеанса `user.id` всегда задан и сохраняется после удаления учётной записи; `user.email_address` равен `null`, если учётная запись пользователя была удалена или пользователь больше не является участником организации, которую может читать ваш ключ. `workspace_id` равен `null`, если сеанс не был связан с рабочим пространством. Локальный сеанс соответствует одному идентификатору клиентского сеанса: начало нового разговора в клиенте или очистка его контекста создаёт новую запись сеанса. Для Claude Science список также может включать отдельные сеансы для собственной фоновой работы приложения (например, присвоения названия разговору; в более новых версиях приложения также его треков проверки и делегирования), а в более старых версиях приложения часть этой фоновой работы отображается как дополнительные сообщения внутри собственной стенограммы разговора. Разговор Claude Science, который продолжается после некоторых обновлений приложения, отображается как два сеанса. Такое поведение ожидаемо. Рассматривайте значения `id` как непрозрачные строки; формат может измениться без уведомления. Для Claude for Microsoft 365 удаление разговора в надстройке происходит только на клиенте, поэтому оно не отражается в API: у локальных сеансов нет поля `deleted_at`, и сеанс остаётся в списке, пока его не удалит механизм хранения. Локальные сеансы имеют `updated_at`, но не имеют `status`: у локального сеанса нет статуса жизненного цикла на стороне сервера, и его видимость определяется сроком хранения. Локальный сеанс собирается как серия вызовов Claude API (вызовов инференса), которые клиент выполняет во время сеанса, и хранение применяется к каждому собранному вызову по отдельности. `created_at` — это метка времени самого раннего сохранённого вызова сеанса, а `updated_at` — метка времени последнего, обе в UTC. По мере того как более старые вызовы выходят за пределы периода хранения, `created_at` соответственно сдвигается вперёд, а когда все вызовы в сеансе выходят за пределы хранения, сеанс больше не возвращается; `updated_at` отслеживает самый последний вызов и до этого момента не меняется. Поскольку `created_at` может смещаться между запусками, выполняйте дедупликацию по `id` при повторном обходе списка с течением времени. Чтобы поддерживать стенограммы в актуальном состоянии по мере появления в сеансах новых сообщений, выполняйте опрос с фильтром `updated_at.gte`, перекрывая последовательные окна. В конечной точке списка `updated_at` является нижней границей: для сеанса, который всё ещё активен на границе страницы или на верхней границе окна `created_at`, он может на мгновение отставать от истинной последней активности сеанса, а новый вызов становится доступным для запросов только после упомянутой ранее небольшой задержки обработки. Из-за этого отставания устанавливайте `updated_at.gte` каждого запуска на несколько минут раньше времени начала предыдущего запуска, а не точно на время предыдущего запуска. Граница, установленная точно на предыдущее время, незаметно и безвозвратно теряет сеанс, последний вызов которого в тот момент ещё индексировался, потому что как только граница сдвигается за этот вызов, ни один последующий запуск его не вернёт. Выполняйте дедупликацию возвращённых сеансов по `id`, повторно получайте их стенограммы и выполняйте дедупликацию сообщений по `id`. Получение сеанса или его сообщений всегда отражает точный последний сохранённый вызов, поэтому периодический проход сверки по более старому окну — более тщательная альтернатива расширению перекрытия. Список строится на основе метаданных активности сеансов, поэтому он может включать сеансы, содержимое стенограмм которых не было собрано, например сеансы, выполнявшиеся до начала сбора для вашей организации (настолько давно, насколько позволяет ваш период хранения); стенограмма такого сеанса возвращает каждое сообщение с содержимым, помеченным как недоступное (см. [Получение стенограммы локального сеанса](https://platform.claude.com/docs/ru/manage-claude/compliance-sessions#retrieve-a-local-session-transcript)). Собранное содержимое локальных сеансов по умолчанию хранится 6 лет с момента сбора. Если организация, в которой выполнялся сеанс, задала конечный пользовательский период хранения разговоров в [claude.ai > Organization settings > Data and privacy](https://claude.ai/admin-settings/data-privacy-controls), вместо этого применяется этот период, независимо от того, короче он или длиннее значения по умолчанию; если в организации настроено более одного пользовательского периода хранения, применяется самый короткий. Изменение этой настройки вступает в силу двумя разными способами: конечные точки перестают возвращать активность старше текущего периода организации сразу после изменения настройки, тогда как каждое собранное сообщение хранится в течение периода, действовавшего на момент его сбора, поэтому последующее увеличение периода не восстанавливает уже истёкшее содержимое. В организациях с включённой [готовностью к HIPAA](https://platform.claude.com/docs/ru/manage-claude/api-and-data-retention#hipaa-readiness) собранное содержимое локальных сеансов хранится 30 дней с момента сбора или в течение пользовательского периода хранения разговоров организации, если он короче; значение по умолчанию в 6 лет не применяется. Чтобы напрямую получить метаданные одного сеанса, передайте его ID в `GET /v1/compliance/apps/sessions/local/{session_id}`. Ответ — это тот же объект сеанса, который возвращает конечная точка списка, без обёртки и без содержимого стенограммы. Некорректный ID сеанса возвращает [400 Bad Request](https://platform.claude.com/docs/ru/manage-claude/compliance-errors#400-bad-request). Единый ответ [404 Not Found](https://platform.claude.com/docs/ru/manage-claude/compliance-errors#404-not-found) охватывает четыре случая, которые ответ не различает: сеанс находится не в организации, которую может читать ваш ключ (включая сеансы в другой родительской организации), он не существует, для него действует нулевое хранение данных, или все вызовы в нём вышли за пределы периода хранения. `product_surface` (строка или `null`) идентифицирует продукт, создавший сеанс: `cowork` (Cowork в Claude Desktop на компьютере пользователя), `claude_code` (Claude Code), `claude_science` (Claude Science), `claude_in_chrome` (встроенный чат расширения браузера Claude in Chrome) или одно из значений `office_agents/excel`, `office_agents/powerpoint`, `office_agents/word` и `office_agents/outlook` (Claude for Microsoft 365, по приложению; просто `office_agents`, если приложение не определено). Новые значения появляются по мере расширения охвата. **Создавайте обработчики с прямой совместимостью.** Пропускайте нераспознанные значения `product_surface` и игнорируйте поля, которых ваш обработчик не ожидает, чтобы ваша интеграция продолжала работать по мере выпуска новых продуктов. ### Получение стенограммы локального сеанса Конечная точка сообщений возвращает стенограмму сеанса, восстановленную из собранных вызовов Claude API: пользовательские подсказки, текст ассистента, вызовы инструментов и текстовые части результатов инструментов — всё возвращается в том виде, в котором было отправлено, за исключением усечения по размеру. Ничто не маскирует URL-адреса, учётные данные или персональные данные в этом содержимом, поэтому обращайтесь со стенограммами как с конфиденциальными данными. Стенограмма опускает или заменяет следующее: * Блоки размышлений никогда не включаются. * «System prompt» (системная подсказка) запроса никогда не возвращается. Вместо неё используется сообщение-маркер с текстом `[system prompt content not shown]` (обычно один раз на сеанс; сеанс без собранного содержимого не содержит маркера). * Определения инструментов и конфигурация серверов MCP не входят в стенограмму. * Изображения, PDF и другие двоичные или структурированные блоки не возвращаются. Каждый из них отображается как блок `text` с текстом `[ content not shown]` (например, `[image content not shown]`) и значением `truncated`, равным `true`. Нетекстовые элементы внутри результата инструмента, такие как результаты [веб-поиска](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/web-search-tool) или вывод [инструмента выполнения кода](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/code-execution-tool), заменяются одной записью `[N non-text item(s) not shown]`, а `truncated` блока результата инструмента равен `true`. Соответствующий вызов инструмента с поисковым запросом или кодом в его `input` по-прежнему возвращается. * Метаданные цитирования в блоках `text`, такие как ссылки на источники в ответе, основанном на результатах веб-поиска, опускаются. Сам текст возвращается, а блок содержит `truncated` со значением `true`. Файлы инструкций проекта, такие как `CLAUDE.md`, отображаются как обычное содержимое с ролью пользователя. Содержимое навыков отображается, когда клиент отправляет его как содержимое сообщения, и не отличается от другого пользовательского текста. Сводку по охвату см. в [FAQ по Compliance API](https://platform.claude.com/docs/ru/manage-claude/compliance-faq#data-coverage-and-retention); таблицу сравнения локальных сеансов с удалёнными сеансами и журналированием OpenTelemetry см. во введении к этой странице. ```bash cURL session_id="clls_01HxKpLmNoPqRsTuVwXyZaBc" curl --fail-with-body -sS \ "https://api.anthropic.com/v1/compliance/apps/sessions/local/$session_id/messages" \ --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \ --header "anthropic-version: 2023-06-01" ``` ```json Response { "session": { "type": "compliance_local_session", "id": "clls_01HxKpLmNoPqRsTuVwXyZaBc", "organization_uuid": "9a1e0000-0000-0000-0000-000000000000", "workspace_id": "wrkspc_01SvYKoWVRVHoEbwESNvzYdR", "user": { "id": "user_01GpKpLmNoPqRsTuVwXyZaBc", "email_address": null }, "product_surface": "cowork", "created_at": "2026-07-09T14:02:11Z", "updated_at": "2026-07-09T14:02:38Z" }, "data": [ { "type": "compliance_local_session_message", "id": "clsm_01J4KpLmNoPqRsTuVwXyZaBa", "role": "user", "model": null, "created_at": "2026-07-09T14:02:11Z", "provenance": { "type": "synthetic_marker" }, "content": [ { "type": "text", "text": "[system prompt content not shown]", "truncated": true } ] }, { "type": "compliance_local_session_message", "id": "clsm_01J4KpLmNoPqRsTuVwXyZaBc", "role": "user", "model": null, "created_at": "2026-07-09T14:02:11Z", "provenance": null, "content": [ { "type": "text", "text": "Fix the failing test in tests/auth_test.py", "truncated": false } ] }, { "type": "compliance_local_session_message", "id": "clsm_01J4KpLmNoPqRsTuVwXyZaBd", "role": "assistant", "model": "claude-opus-5-5", "created_at": "2026-07-09T14:02:11Z", "provenance": null, "content": [ { "type": "text", "text": "I'll read the test file first.", "truncated": false }, { "type": "tool_use", "id": "toolu_01AbCdEfGhIjKlMnOpQrSt", "name": "Read", "input": "{\"file_path\":\"tests/auth_test.py\"}", "truncated": false } ] }, { "type": "compliance_local_session_message", "id": "clsm_01J4KpLmNoPqRsTuVwXyZaBe", "role": "user", "model": null, "created_at": "2026-07-09T14:02:38Z", "provenance": null, "content": [ { "type": "tool_result", "tool_use_id": "toolu_01AbCdEfGhIjKlMnOpQrSt", "name": "Read", "is_error": false, "content": [ { "type": "text", "text": "def test_login_expiry():\n ..." } ], "truncated": false } ] }, { "type": "compliance_local_session_message", "id": "clsm_01J4KpLmNoPqRsTuVwXyZaBf", "role": "assistant", "model": "claude-opus-5-5", "created_at": "2026-07-09T14:02:38Z", "provenance": null, "content": [ { "type": "text", "text": "The test was asserting on a stale expiry timestamp. I've updated it.", "truncated": false } ] } ], "next_page": null } ``` Ответ содержит обёртку `session` наряду с массивом `data` с пагинацией. Первая запись в этом примере — маркер, заменяющий системную подсказку запроса; его `provenance` описывается далее в этом разделе. В этой конечной точке `user.email_address` всегда равен `null`: конечная точка сообщений не разрешает адреса электронной почты, поэтому `null` здесь не означает, что учётная запись пользователя была удалена. Чтобы сопоставить сеанс с адресом электронной почты, соедините `user.id` с данными [конечной точки списка](https://platform.claude.com/docs/ru/manage-claude/compliance-sessions#retrieve-local-sessions) или конечной точки получения (`GET /v1/compliance/apps/sessions/local/{session_id}`). По умолчанию сообщения возвращаются начиная с самых старых; передайте `order=desc`, чтобы изменить порядок на обратный. Пагинация использует ту же схему `page`/`next_page`, что и конечная точка списка, со значением `limit` по умолчанию 100 и максимумом 1 000. Страница может закончиться раньше, когда ответ достигает своего ограничения по размеру, поэтому страница с количеством сообщений меньше `limit` не означает, что вы достигли конца; продолжайте пагинацию, пока `next_page` не станет `null`. Курсоры страниц привязаны к сеансу и порядку сортировки, для которых они были выданы, а курсоры обхода истекают через 24 часа после его первой страницы: истёкший курсор возвращает [400 Bad Request](https://platform.claude.com/docs/ru/manage-claude/compliance-errors#400-bad-request) с указанием начать заново без параметра `page`, и перезапущенный обход отражает текущую границу хранения. Курсор, выданный для другого сеанса или другого `order`, также возвращает 400 как недействительный курсор. Для очень большого сеанса конечная точка сообщений может вернуть 400 для страницы с сообщением о том, что страница слишком велика для чтения; см. [Страница расшифровки слишком велика](https://platform.claude.com/docs/ru/manage-claude/compliance-errors#transcript-page-too-large). Не повторяйте этот запрос. Если в нём использовался `order=desc`, вместо этого читайте этот сеанс начиная с самых старых сообщений с его первой страницы, без `order` и без `page`, и установите тайм-аут запроса вашего клиента не менее 5 минут. Если страница в порядке от старых к новым возвращает ту же ошибку, что делать, описано в соответствующей записи руководства по ошибкам. Для очень большого сеанса конечная точка сообщений также может вернуть 429, у которого `error.details.error_code` равен `transcript_read_server_busy`. Это не означает, что ваша организация превысила ограничение скорости. В отличие от 400, этот запрос следует повторить: подождите количество секунд, указанное в заголовке `retry-after`, затем отправьте тот же запрос снова без изменений (с тем же значением `page`, если оно было). См. [Сервер занят чтением больших расшифровок](https://platform.claude.com/docs/ru/manage-claude/compliance-errors#server-busy-reading-large-transcripts). Каждое сообщение содержит `role` (`user` или `assistant`) и массив `content` из блоков `text`, `tool_use` и `tool_result`. Оно также содержит `model`: для хода ассистента, собранного из Claude API, это модель, которая обслужила ход, а для пользовательских сообщений и любого сообщения ассистента с заданным `provenance` значение равно `null`, поскольку история, заявленная клиентом, и синтетические маркеры не были созданы моделью, а обслуживающая модель для недоступного содержимого неизвестна. Блок `text` содержит `text` и `truncated`. Блок `tool_use` содержит `id`, `name`, `input` и `truncated`, где `input` — это строка в кодировке JSON, а не объект. Блок `tool_result` содержит `tool_use_id`, `name`, `is_error`, массив `content` из записей `text` и `truncated`. Вызовы и результаты инструментов MCP, а также большинство вызовов и результатов серверных инструментов нормализуются в те же формы `tool_use` и `tool_result`; любой другой тип блока отображается как заполнитель `[ content not shown]`. `id` сообщения стабилен, пока ход хранится. Каждое сообщение, восстановленное из одного и того же вызова инференса, содержит метку времени этого вызова, поэтому последовательные сообщения часто имеют одинаковое значение `created_at`; сохраняйте возвращённый порядок, а не пересортировывайте по метке времени. Каждое сообщение также содержит поле `provenance`, описывающее, как было собрано его содержимое. `provenance` равно `null` для проверенного содержимого, собранного Claude API, что является обычным случаем. В противном случае это объект, `type` которого обозначает исключение: * `content_unavailable` означает, что содержимое не может быть возвращено. Массив `content` пуст, а `provenance.reason` указывает причину. `not_captured` означает, что для хода нет доступного содержимого. Это не доказывает, что запись не сохранялась: содержимое, которое политики обработки данных Anthropic не передают в Compliance API, сообщается с той же причиной, как и отдельные ходы, недоступные по таким причинам, в сеансе, который в остальном был собран. Единственное исключение — непригодный для использования ключ, управляемый клиентом: вместо этого возвращается [503 Service Unavailable](https://platform.claude.com/docs/ru/manage-claude/compliance-errors#local-sessions-temporarily-unavailable). `client_aborted` означает, что клиент закрыл соединение или отменил запрос до завершения ответа, поэтому ответ хода не был собран; любой частичный вывод, уже переданный клиенту в потоковом режиме, не включается, и эта причина применяется только к ходам с ролью ассистента. `cmek_key_revoked` зарезервировано для содержимого, зашифрованного ключом вашей организации, управляемым клиентом, когда этот ключ недоступен (например, отозван). В настоящее время оно не возвращается, поскольку непригодный ключ вместо этого приводит к 503, но обрабатывайте его для прямой совместимости. `retention_elapsed` означает, что содержимое вышло за пределы периода хранения. `oversize` означает, что отдельное сообщение превысило ограничение размера на сообщение; сообщение всё равно возвращается, но с пустым массивом `content`. * `client_asserted` помечает сообщения ассистента, которые клиент предоставил как историю разговора и которые не удалось сопоставить с собранным ответом; их авторство не проверено. * `synthetic_marker` помечает записи, созданные самой конечной точкой, например маркер, заменяющий системную подсказку. Когда клиент переписывает или сжимает историю разговора посреди сеанса (например, после «context compaction» (сжатия контекста)), стенограмма вставляет в этом месте сообщение-маркер и продолжается новым содержимым, отправленным клиентом. Если у вашей организации конечный период хранения и это новое содержимое включает сообщения ассистента, стенограмма скрывает новое содержимое вплоть до его последнего сообщения ассистента включительно (это отмечается вторым маркером) и показывает только пользовательские сообщения после этой точки, за которыми следует остальная часть сеанса. Сообщения-маркеры и сообщения, заявленные клиентом, начинаются с пояснительного блока `text` в квадратных скобках с флагом `truncated: true`, например `[system prompt content not shown]`. Рассматривайте такие записи как присутствующие, но недоступные или непроверенные, а не как отсутствующие, и допускайте нераспознанные типы и причины `provenance`. Два параметра ограничивают количество возвращаемых байтов каждого блока инструмента: `tool_use_input_max_bytes` и `tool_result_max_bytes`, оба по умолчанию равны 10 000 байт. Передайте `-1` для серверного максимума (около 1 МиБ на строку); `0` возвращает [400 Bad Request](https://platform.claude.com/docs/ru/manage-claude/compliance-errors#400-bad-request), а значения выше максимума приводятся к нему. Строка, обрезанная любым из ограничений, обрезается по границе символа, и к ней добавляется встроенный суффикс (например, `…[truncated; pass tool_result_max_bytes=-1 for the server max]`), а её блок содержит `"truncated": true`. Поэтому усечённый `input` блока `tool_use` больше не является допустимым JSON, так что разбирайте входные данные инструментов только из неусечённых блоков (или увеличьте ограничение и получите данные повторно). Блоки типа `text` всегда ограничены тем же серверным максимумом около 1 МиБ; никакой параметр его не увеличивает, и блок `text`, достигший этой границы, также содержит `"truncated": true`. Claude Science вызывает коннекторы (серверы MCP) из кода, который он выполняет через свой инструмент `repl`, а не как отдельно именованные инструменты, поэтому ни один блок в стенограмме Claude Science не назван по имени коннектора. Каждый вызов коннектора отображается в коде внутри `input` блока `tool_use` инструмента `repl` (например, вызов `host.mcp("", "", ...)`), а вывод коннектора отображается в соответствующем `tool_result` только там, где этот код его напечатал. Сеансы Cowork и Claude Code отличаются: они вызывают каждый инструмент коннектора под его собственным именем `mcp____`, которое является `name` блока `tool_use`. Чтобы отслеживать использование коннекторов в сеансах Claude Science, разбирайте строку `input` и сопоставляйте по содержащемуся в ней коду, а не по имени инструмента. Передавайте `tool_use_input_max_bytes=-1` для этих сеансов, чтобы длинный входной код возвращался вплоть до серверного максимума, а не обрезался на значении по умолчанию в 10 000 байт до того, как появится вызов коннектора. Содержимое стенограммы соблюдает период хранения, описанный в разделе [Сеансы на компьютерах пользователей](https://platform.claude.com/docs/ru/manage-claude/compliance-sessions#retrieve-local-sessions). Когда начало сеанса вышло за пределы этого периода, стенограмма начинается с одного заполнителя `content_unavailable` с `reason`, равным `retention_elapsed`, за которым следуют сохранённые сообщения. Когда все вызовы в сеансе вышли за пределы хранения, конечная точка сообщений возвращает [404 Not Found](https://platform.claude.com/docs/ru/manage-claude/compliance-errors#404-not-found), как и для сеансов в организациях, которые ваш ключ не может читать, несуществующих сеансов и сеансов, для которых действует нулевое хранение данных. Некорректный ID сеанса возвращает [400 Bad Request](https://platform.claude.com/docs/ru/manage-claude/compliance-errors#400-bad-request). ## Сеансы в облаке (удалённые сеансы) Сеансы Cowork, запущенные в веб-версии или мобильном приложении claude.ai, выполняются в облаке в средах, управляемых Anthropic. Compliance API предоставляет доступ к этим удалённым сеансам через две конечные точки: `GET /v1/compliance/apps/sessions/remote` возвращает список метаданных сеансов, а `GET /v1/compliance/apps/sessions/remote/{session_id}/messages` возвращает стенограмму одного сеанса. Обе требуют области `read:compliance_user_data`, и обе учитываются в общем ограничении скорости Compliance API, а также в отдельном бюджете запросов, специфичном для этих конечных точек; см. [429 Too Many Requests](https://platform.claude.com/docs/ru/manage-claude/compliance-errors#429-too-many-requests). Конечная точка списка по умолчанию охватывает всю организацию: не указывайте `organization_ids[]`, чтобы включить все организации claude.ai, доступные для чтения вашему ключу, или передайте до 500 значений, чтобы сузить охват. Чтобы вместо этого ограничить список конкретными пользователями, передайте от 1 до 10 значений `user_ids[]` (получите идентификаторы через [Список пользователей организации](https://platform.claude.com/docs/ru/manage-claude/compliance-org-data#list-organization-users)); фильтр сопоставляется с пользователем-владельцем сеанса, поэтому сеансы, принадлежащие агентам, исключаются всякий раз, когда задан `user_ids[]`. Ограничьте результаты по времени с помощью параметров диапазона `created_at` (`gte`, `gt`, `lt`, `lte` в формате RFC 3339). Фильтра `updated_at` нет. Следующий запрос возвращает список сеансов, созданных начиная с заданной даты. ```bash cURL curl --fail-with-body -sS -G \ "https://api.anthropic.com/v1/compliance/apps/sessions/remote" \ --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \ --header "anthropic-version: 2023-06-01" \ --data-urlencode "created_at.gte=2026-06-01T00:00:00Z" \ --data-urlencode "limit=100" ``` ```json Response { "data": [ { "id": "cse_01WpQrStUvXyZaBcDeFgHjK6", "organization_uuid": "91012d09-e48b-438e-a489-1bebfd8fa6f9", "user": { "id": "user_01XyDMpzjS89pFZXqSFUBDr6", "email_address": "user@example.com" }, "agent_id": null, "started_by_user": null, "status": "active", "created_at": "2026-07-01T17:04:05Z", "updated_at": "2026-07-01T18:00:41Z", "product_surface": "cowork_remote", "claude_project_id": "claude_proj_01KGp4eZNug9ri4kE35RSppq" }, { "id": "cse_01TkNpRsUvWxYzAbCdEfGhJ4", "organization_uuid": "91012d09-e48b-438e-a489-1bebfd8fa6f9", "user": null, "agent_id": "cagt_01MnPqRsTuVwXyZaBcDeFgH8", "started_by_user": { "id": "user_01XyDMpzjS89pFZXqSFUBDr6", "email_address": "user@example.com" }, "status": "archived", "created_at": "2026-06-28T09:15:22Z", "updated_at": "2026-06-28T09:47:10Z", "product_surface": "cowork_remote", "claude_project_id": null } ], "next_page": "page_AAEfMk93cXpYdGxrZXk" } ``` Результаты сортируются в обратном хронологическом порядке (сначала новые) по `created_at` и ограничиваются `limit` результатами на ответ (по умолчанию 100, максимум 500). Конечная точка использует пагинацию с токенами `page` и `next_page` (см. [Постраничная навигация по результатам](https://platform.claude.com/docs/ru/manage-claude/compliance-activity-feed#paginate-results)): передайте значение `next_page` из ответа в качестве параметра запроса `page` в следующем запросе и остановитесь, когда `next_page` будет равно `null`. Сеанс принадлежит либо пользователю, либо агенту, но никогда обоим одновременно. Для сеансов, принадлежащих пользователям, `user` содержит идентификатор и адрес электронной почты владельца (`email_address` равно `null`, если пользователь больше не является участником организации, доступной для чтения вашему ключу), а `agent_id` равно `null`. Для сеансов, принадлежащих агентам (например, запусков запланированной задачи Cowork в облаке), `user` равно `null`, `agent_id` содержит идентификатор агента (префикс `cagt_`), а `started_by_user` указывает человека, инициировавшего запуск; в сеансах, принадлежащих пользователям, `started_by_user` равно `null`. Каждый запуск запланированной задачи является отдельным сеансом, и ни одно поле сеанса не содержит название или расписание задачи. `claude_project_id` — это идентификатор [проекта](https://platform.claude.com/docs/ru/manage-claude/compliance-content-data#retrieve-projects-and-attachments) claude.ai, к которому относится сеанс (префикс `claude_proj_`), или `null`, если сеанс не входит в проект. `status` принимает одно из значений `pending`, `active`, `paused`, `archived` или `failed`. Сеанс находится в состоянии `pending`, пока он подготавливается; у сеанса в состоянии `pending` ещё нет стенограммы, и конечная точка сообщений возвращает для него 404, пока подготовка не завершится. Удалённые сеансы никогда не возвращаются. `product_surface` (строка или `null`) указывает продукт, создавший сеанс. В настоящее время конечная точка возвращает только сеансы с `product_surface`, равным `cowork_remote`: сеансы Cowork, запущенные в веб-версии или мобильном приложении claude.ai. Чтобы получить чат в едином интерфейсе Claude, включая часть, выполнявшуюся в облаке, используйте конечные точки чатов ([Получение сообщений чата](https://platform.claude.com/docs/ru/api/compliance/apps/chats/messages/list)), а не конечные точки удалённых сеансов. **Создавайте обработчики с прямой совместимостью.** Пропускайте нераспознанные значения `status` и `product_surface` и игнорируйте поля, которых ваш обработчик не ожидает, чтобы ваша интеграция продолжала работать по мере появления новых статусов и продуктов. ### Получение стенограммы удалённого сеанса Конечная точка сообщений возвращает стенограмму сеанса: подсказки пользователя, ответы ассистента, а также вызовы инструментов и их результаты. Блоки размышлений и изображения не включаются. Сводку о том, какие данные охватываются, см. в разделе [Часто задаваемые вопросы о Compliance API](https://platform.claude.com/docs/ru/manage-claude/compliance-faq#data-coverage-and-retention). Таблица, сравнивающая удалённые сеансы с локальными сеансами и журналированием OpenTelemetry в Cowork, приведена во введении к этой странице. ```bash cURL session_id="cse_01WpQrStUvXyZaBcDeFgHjK6" curl --fail-with-body -sS \ "https://api.anthropic.com/v1/compliance/apps/sessions/remote/$session_id/messages" \ --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \ --header "anthropic-version: 2023-06-01" ``` ```json Response { "session": { "id": "cse_01WpQrStUvXyZaBcDeFgHjK6", "organization_uuid": "91012d09-e48b-438e-a489-1bebfd8fa6f9", "user": { "id": "user_01XyDMpzjS89pFZXqSFUBDr6", "email_address": null }, "agent_id": null, "started_by_user": null, "status": "active", "created_at": "2026-07-01T17:04:05Z", "updated_at": "2026-07-01T18:00:41Z", "product_surface": "cowork_remote", "claude_project_id": null }, "data": [ { "id": "csev_01HjKmNpQrStUvWxYzAbCdE2", "role": "user", "created_at": "2026-07-01T17:04:05Z", "content": [ { "type": "text", "text": "Summarize the customer feedback in the attached spreadsheet.", "truncated": false } ], "sent_by_user_id": null, "content_unavailable": false }, { "id": "csev_01BcDeFgHjKmNpQrStUvWxY4", "role": "assistant", "created_at": "2026-07-01T17:04:06Z", "content": [ { "type": "text", "text": "I'll start by reading the spreadsheet...", "truncated": false } ], "sent_by_user_id": null, "content_unavailable": false } ], "next_page": null } ``` Помимо постраничного массива `data`, ответ содержит вложенный объект `session`. В этой конечной точке поля `user.email_address`, `started_by_user` и `claude_project_id` в этом объекте всегда равны `null`. Получайте эти значения через конечную точку списка. По умолчанию сообщения возвращаются начиная с самых старых; чтобы изменить порядок, передайте `order=desc`. Постраничная выдача работает по той же схеме `page`/`next_page`, что и в конечной точке списка. Значение `limit` по умолчанию равно 100, максимум — 1 000. Страница может закончиться раньше, если ответ достиг предельного размера. Поэтому страница, содержащая меньше `limit` сообщений, ещё не означает, что вы дошли до конца. Продолжайте запрашивать страницы, пока `next_page` не станет равным `null`. Каждое сообщение содержит поле `role` (`user` или `assistant`) и массив `content` из блоков `text`, `tool_use` и `tool_result`. Значения `created_at` у сообщений — это временные метки фиксации. У последовательных сообщений метки могут совпадать или идти в слегка обратном порядке, поэтому сохраняйте порядок из ответа, а не пересортировывайте сообщения по `created_at`. В сеансах, принадлежащих агенту, поле `sent_by_user_id` указывает пользователя, отправившего данное пользовательское сообщение, если его можно установить. В остальных случаях, в том числе во всех сообщениях ассистента, оно равно `null`. Если содержимое сообщения вообще невозможно вернуть (например, оно превышает допустимый размер), у сообщения поле `content_unavailable` равно `true`. Два параметра ограничивают число возвращаемых байтов каждого блока инструмента: `tool_use_input_max_bytes` и `tool_result_max_bytes`. По умолчанию оба равны 10 000 байтов. Передайте `-1`, чтобы использовать серверный максимум (около 1 МиБ на строку); значение `0` приводит к ошибке [400 Bad Request](https://platform.claude.com/docs/ru/manage-claude/compliance-errors#400-bad-request). Блок, обрезанный любым из этих ограничений, содержит `"truncated": true`. Обрезанные входные данные `tool_use` уже не являются корректным JSON. Поэтому разбирайте входные данные инструментов только из необрезанных блоков (или увеличьте ограничение и запросите данные повторно). Конечная точка сообщений возвращает [404 Not Found](https://platform.claude.com/docs/ru/manage-claude/compliance-errors#404-not-found) в следующих случаях: * сеанс находится в статусе `pending`; * сеанс не существует или был удалён; * сеанс относится к организации, недоступной вашему ключу для чтения. ## Хранение и удаление Конечные точки сеансов доступны только для чтения; локальные и удалённые сеансы нельзя удалить через Compliance API. Стенограммы локальных сеансов по умолчанию хранятся 6 лет, либо в течение пользовательского срока хранения разговоров вашей организации, если задан конечный срок, либо 30 дней в организациях с включённой готовностью к HIPAA, как описано в разделе [Сеансы на компьютерах пользователей](https://platform.claude.com/docs/ru/manage-claude/compliance-sessions#retrieve-local-sessions). Стенограммы удалённых сеансов хранятся 6 лет, если только пользователь не удалит сеанс раньше. После того как пользователь удаляет сеанс, конечные точки удалённых сеансов больше его не возвращают, и его стенограмму невозможно восстановить через Compliance API. Чтобы узнать, как эти сроки соотносятся с другими условиями хранения Anthropic, см. [API и хранение данных](https://platform.claude.com/docs/ru/manage-claude/api-and-data-retention). ## Дальнейшие шаги Получайте доступ к содержимому чатов claude.ai, вложенным файлам и проектам с помощью того же Compliance Access Key. Сводка по полям о том, что входит в стенограммы сеансов, и ответы на другие распространённые вопросы. Точные тексты ответов с ошибками и способы устранения каждой из них. Пути конечных точек, параметры и схемы ответов Compliance API.