> ## Documentation Index
> Fetch the complete documentation index at: https://platform.atlan.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Managed Agents

> Record and inspect externally run Claude Managed Agents in Atlan.

Register Claude Managed Agents and inspect the Agent, session, event, and trace
records reported from their external runtime. Atlan does not trigger or execute
Claude Managed Agent runs.

<Note>
  Run Claude Managed Agents in your configured Claude environment. Keep runtime
  credentials and execution controls there.
</Note>

## Prerequisites

* An Agent Registry agent ID for the runtime to report against.
* Access to the Claude environment where the Agent runs.
* OAuth access to the Atlan gateway.
* Permission to read the agent and create its sessions.

## Record a completed Claude run

1. Run the Claude Managed Agent in its configured external environment.
2. Create the Agent record if it does not already exist.
3. Upload the final session through the **Agent** category in the
   [API reference](/developers/api-reference), including the original execution
   timestamp, outcome, stop reason, and usage.
4. Retrieve session events to inspect provider-native activity. Upload
   `session_message` records only when your harness captures a transcript.

Keep credentials out of application source and request URLs.

## Expected result

Atlan stores the completed session and exposes its reported events and traces.
Creating that record does not cause the Claude Managed Agent to run.

## Verification

Retrieve the session and confirm its Agent, outcome, and execution timestamp
match the external run. Inspect its event stream and traces through the Agent
API reference before using its output downstream.

## Limitations

* Atlan does not start, execute, or stream Claude Managed Agent workloads.
* A session cannot be edited or deleted after creation.
* The documentation playground remains disabled; run requests from an approved
  environment.