---
title: Console에서 빌드하기
url: https://platform.claude.com/docs/ko/managed-agents/onboarding
description: Claude Console에서 에이전트를 시각적으로 생성, 테스트 및 반복 개선한 다음, API를 사용하여 코드에서 실행하세요.
featureMetadata:
  topic:
    title: Managed Agents
    url: https://platform.claude.com/docs/en/managed-agents/overview
  status: beta
  betaHeader: managed-agents-2026-04-01
  zdr:
    eligibility: not-eligible
    note: 자체 호스팅 Managed Agents를 제외하고 ZDR 적격 대상이 아닙니다. 세션은 상태를 유지하는 리소스이며, 트랜스크립트는 삭제할 때까지 유지됩니다.
  supportedModels:
    - claude-fable-5-2
    - claude-mythos-5-2
    - claude-fable-5-1
    - claude-mythos-5-1
    - claude-fable-5
    - claude-mythos-5
    - claude-mythos-preview
    - claude-opus-5-5
    - claude-opus-5
    - claude-sonnet-5-5
    - claude-sonnet-5
    - claude-haiku-5-5
    - claude-haiku-4-5-20251001
    - claude-opus-4-8
    - claude-opus-4-7
    - claude-opus-4-6
    - claude-sonnet-4-6
    - claude-opus-4-5-20251101
    - claude-sonnet-4-5-20250929
  supportedPlatforms:
    Claude API: beta
    Claude Platform on AWS: beta
---

[Claude Console](https://platform.claude.com/workspaces/default/agent-quickstart/)은 에이전트를 생성하고 구성하기 위한 시각적 인터페이스를 제공합니다. 이를 통해 코드를 작성하기 전에 대화형으로 구성을 반복 개선할 수 있습니다.

## 에이전트를 빌드하는 방법

Claude Console의 [시각적 인터페이스](https://platform.claude.com/workspaces/default/agent-quickstart/)는 에이전트 정의의 각 필드를 단계별로 안내합니다:

* **모델 및 시스템 프롬프트:** 모델을 선택하고 전체 너비 편집기에서 “system prompt”(시스템 프롬프트)를 작성합니다.
* **MCP 서버:** URL로 원격 MCP 서버를 추가하고, 에이전트가 사용자를 대신하여 작업을 수행할 수 있도록 인증합니다.
* **도구:** 사전 구축된 에이전트 도구 세트와 MCP 도구를 사용하여 에이전트의 기능을 확장합니다.
* **Skills:** Anthropic 스킬 또는 조직 라이브러리의 사용자 정의 스킬을 연결합니다.

구성하는 동안 Console은 이에 상응하는 API 요청을 표시하므로, 만족스러운 결과가 나오면 이를 코드에 복사할 수 있습니다.

## 에이전트 테스트하기

Console에는 인라인 세션 실행기가 포함되어 있습니다. 에이전트를 구성한 후 페이지를 벗어나지 않고 바로 테스트 세션을 시작하고, 메시지를 보내고, 이벤트 스트림을 확인할 수 있습니다. 이는 시스템 프롬프트와 도구 선택이 기대하는 동작을 만들어내는지 확인하는 가장 빠른 방법입니다.

## Console에서 코드베이스로

에이전트가 예상대로 작동하면:

1. Console에서 에이전트 ID와 [환경 ID](https://platform.claude.com/docs/ko/managed-agents/environments)를 복사합니다.
2. [세션을 생성](https://platform.claude.com/docs/ko/managed-agents/sessions)할 때 코드에서 이를 참조합니다:

<CodeGroup>
  ```bash cURL
  curl -fsSL https://api.anthropic.com/v1/sessions \
    -H "x-api-key: $ANTHROPIC_API_KEY" \
    -H "anthropic-version: 2026-10-21" \
    -H "anthropic-beta: managed-agents-2026-04-01" \
    -H "content-type: application/json" \
    -d '{
      "agent": "agent_01J8XkN5uT3vHpLqRfWdY2",
      "environment_id": "env_01K2mPsT7hNwR4jXuLvCqD8",
      "title": "My first session"
    }'
  ```

  ```bash CLI
  ant beta:sessions create \
    --agent agent_01J8XkN5uT3vHpLqRfWdY2 \
    --environment-id env_01K2mPsT7hNwR4jXuLvCqD8 \
    --title "My first session"
  ```

  ```python Python
  session = client.beta.sessions.create(
      agent="agent_01J8XkN5uT3vHpLqRfWdY2",
      environment_id="env_01K2mPsT7hNwR4jXuLvCqD8",
      title="My first session",
  )
  ```

  ```typescript TypeScript
  const session = await client.beta.sessions.create({
    agent: "agent_01J8XkN5uT3vHpLqRfWdY2",
    environment_id: "env_01K2mPsT7hNwR4jXuLvCqD8",
    title: "My first session"
  });
  ```

  ```csharp C#
  var session = await client.Beta.Sessions.Create(new()
  {
      Agent = "agent_01J8XkN5uT3vHpLqRfWdY2",
      EnvironmentID = "env_01K2mPsT7hNwR4jXuLvCqD8",
      Title = "My first session",
  });
  ```

  ```go Go
  session, err := client.Beta.Sessions.New(ctx, anthropic.BetaSessionNewParams{
  	Agent: anthropic.BetaSessionNewParamsAgentUnion{
  		OfString: anthropic.String("agent_01J8XkN5uT3vHpLqRfWdY2"),
  	},
  	EnvironmentID: "env_01K2mPsT7hNwR4jXuLvCqD8",
  	Title:         anthropic.String("My first session"),
  })
  if err != nil {
  	panic(err)
  }
  ```

  ```java Java
  var session = client.beta().sessions().create(
      SessionCreateParams.builder()
          .agent("agent_01J8XkN5uT3vHpLqRfWdY2")
          .environmentId("env_01K2mPsT7hNwR4jXuLvCqD8")
          .title("My first session")
          .build()
  );
  ```

  ```php PHP
  $session = $client->beta->sessions->create(
      agent: 'agent_01J8XkN5uT3vHpLqRfWdY2',
      environmentID: 'env_01K2mPsT7hNwR4jXuLvCqD8',
      title: 'My first session',
  );
  ```

  ```ruby Ruby
  session = client.beta.sessions.create(
    agent: "agent_01J8XkN5uT3vHpLqRfWdY2",
    environment_id: "env_01K2mPsT7hNwR4jXuLvCqD8",
    title: "My first session"
  )
  ```
</CodeGroup>

## 제공 여부

Console 에이전트 빌더은(는) 모든 모델에서 베타 상태입니다.

### API 지원

#### [Managed Agents](https://platform.claude.com/docs/ko/managed-agents/overview)

* 제공 여부: 사용 가능

| 상태 | 클라우드 플랫폼 |
| ----- | ----- |
| 베타 | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/ko/build-with-claude/claude-platform-on-aws) |

### 필수 베타 헤더

[베타 헤더 개요](https://platform.claude.com/docs/ko/api/beta-headers)

베타 헤더를 사용하면 실험적 기능과 새로운 모델 기능이 표준 API에 포함되기 전에 액세스할 수 있습니다.

* `managed-agents-2026-04-01`

### 데이터 처리

[데이터 처리 개요](https://platform.claude.com/docs/ko/manage-claude/api-and-data-retention#feature-eligibility)

| 항목 | 제로 데이터 보존 | HIPAA |
| ----- | ----- | ----- |
| 상태 | 적격 아님 | 적격 아님 |
| 세부 정보 | 자체 호스팅 Managed Agents를 제외하고 ZDR 적격 대상이 아닙니다. 세션은 상태를 유지하는 리소스이며, 트랜스크립트는 삭제할 때까지 유지됩니다. [자세히 알아보기](https://platform.claude.com/docs/ko/managed-agents/self-hosted-data-and-access#how-long-data-is-kept) | HIPAA 적격 대상이 아닙니다. 모든 Managed Agents 하위 기능에 적용됩니다. |

적용 엔드포인트:

* `/v1/agents`
* `/v1/sessions`
* `/v1/environments`
