Claude Platform Docs
Managed AgentsFirst steps

Build in Console

Create, test, and iterate on agents visually in the Claude Console, then run them from your code with the API.

The Claude Console provides a visual interface for creating and configuring agents. It lets you iterate on configuration interactively before writing code.

How to build an agent

The visual interface in the Claude Console walks you through each field of an agent definition:

  • Model and system prompt: Pick a model and write the system prompt in a full-width editor.
  • MCP servers: Add remote MCP servers by URL and authenticate your agent to take action on your behalf.
  • Tools: Extend your agent’s capabilities using a pre-built agent toolset and MCP tools.
  • Skills: Attach Anthropic or custom skills from your organization’s library.

As you configure, Console shows the equivalent API request so you can copy it into your code once you’re satisfied.

Testing an agent

Console includes an inline session runner. After configuring your agent, you can start a test session directly, send messages, and watch the event stream without leaving the page. This is the fastest way to check that your system prompt and tool selection produce the behavior you expect.

From Console to your code base

Once your agent works as expected:

  1. Copy the agent ID and environment ID from Console.
  2. Reference them in your code when creating sessions:
session = client.beta.sessions.create(
    agent="agent_01J8XkN5uT3vHpLqRfWdY2",
    environment_id="env_01K2mPsT7hNwR4jXuLvCqD8",
    title="My first session",
)

Availability

Console agent builder is in beta on every model.

API support

StatusBeta
Cloud platforms

Required beta headers

Beta headers overview

Beta headers allow you to access experimental features and new model capabilities before they become part of the standard API.

Header
  • managed-agents-2026-04-01

Applicable endpoints

  • /v1/agents
  • /v1/sessions
  • /v1/environments
Zero data retentionNot eligible

Sessions are stateful resources; transcripts persist until you delete them. Applies to all Managed Agents sub-features, including Self-hosted sandboxes.

HIPAANot eligible

Applies to all Managed Agents sub-features, including Self-hosted sandboxes.

Was this page helpful?