Cookie settings

We use cookies to deliver and improve our services, analyze site usage, and if you agree, to customize or personalize your experience and market our services to you. You can read our Cookie Policy here.

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
Availability requirements for Console agent builder are the same across all supported platforms.
Status
Beta
API
  • Managed Agents
Beta header
Requires
Models
  • All models

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?