---
title: Console에서 빌드하기
url: https://platform.claude.com/docs/ko/managed-agents/onboarding
description: 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
---

[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 도구를 사용하여 에이전트의 기능을 확장합니다.
* **스킬:** 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: 2023-06-01" \
    -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>