---
title: 서버에서 콘솔 사용하기
url: https://platform.claude.com/docs/ko/managed-agents/self-hosted/console
description: 자체 호스팅 Claude Managed Agents 서버에서 콘솔 로그인을 설정한 다음, 브라우저에서 에이전트를 만들고 세션을 실행하세요.
---

<Note>
  자체 호스팅 Claude Managed Agents에 대한 접근 권한을 요청하려면 Anthropic 계정 팀에 문의하세요.
</Note>

서버의 콘솔은 자체 호스팅 Claude Managed Agents 서버가 API와 동일한 주소에서 제공하는 웹페이지입니다. 콘솔에서는 SDK나 CLI 없이 에이전트를 만들고, 세션을 실행하고, 환경, 자격 증명 볼트, 메모리 저장소, 스킬을 관리할 수 있습니다.

platform.claude.com에 있는 Claude Console은 아닙니다. 콘솔에는 서버에 있는 내용만 표시됩니다.

## 로그인 설정하기

관리자가 로그인을 한 번 설정합니다. 대신 한 대의 머신에서 콘솔을 사용해 보려면 릴리스의 모의 로그인 공급자를 사용하는 [서버에서 콘솔 사용해 보기](https://platform.claude.com/docs/ko/managed-agents/self-hosted/quickstart#try-the-console-on-your-server)를 따르세요.

<Steps>
  <Step title="싱글 사인온과 터미널 로그인 설정하기">
    [싱글 사인온](https://platform.claude.com/docs/ko/managed-agents/self-hosted/configure#single-sign-on)을 따르세요. 여기에는 [개발자가 터미널에서 로그인하도록 허용](https://platform.claude.com/docs/ko/managed-agents/self-hosted/configure#let-developers-log-in-from-a-terminal)도 포함됩니다. 콘솔은 터미널 로그인용으로 등록한 애플리케이션을 통해 사용자를 로그인시킵니다. 콘솔은 각 토큰을 발급자 항목에 있는 `audiences`의 첫 번째 항목과 대조하여 확인하므로, 해당 애플리케이션의 audience를 맨 앞에 나열하세요.
  </Step>

  <Step title="HTTPS로 콘솔 제공하기">
    포트 8400 앞에 TLS를 종료하는 프록시를 두세요. [서버 앞에 TLS 배치하기](https://platform.claude.com/docs/ko/managed-agents/self-hosted/kubernetes#put-tls-in-front-of-the-server)에 프록시가 수행해야 하는 작업이 나열되어 있습니다. 일반 HTTP에서는 `localhost` 또는 `127.0.0.1`에서만 로그인이 작동합니다.
  </Step>

  <Step title="애플리케이션에 콘솔 주소 추가하기">
    ID 공급자에서 서버의 HTTPS 주소를 끝에 슬래시를 붙여 해당 애플리케이션의 두 번째 리디렉션 URI로 추가하세요: `https://cma.example.com/`. 또한 교차 출처(CORS) 요청에 대해 해당 출처인 `https://cma.example.com`을 허용하세요.
  </Step>
</Steps>

설정을 확인하려면 [콘솔을 열고](https://platform.claude.com/docs/ko/managed-agents/self-hosted/console#open-the-console) 로그인하세요.

## 콘솔 열기

애플리케이션이 `https://cma.example.com`을 호출하는 경우, 브라우저에서 `https://cma.example.com/`을 열고 **Continue with SSO**를 클릭하세요.

로그인은 ID 공급자를 통해 이루어집니다. 콘솔은 서버 API 키를 허용하지 않습니다. 콘솔에 이 서버에서 로그인이 설정되지 않았다고 표시되면, 관리자가 [로그인을 설정](https://platform.claude.com/docs/ko/managed-agents/self-hosted/console#set-up-sign-in)해야 합니다.

## 콘솔에서 에이전트 실행하기

빈 에이전트의 `bash`와 같은 기본 제공 도구는 워커에서 실행되므로, 워커가 폴링하고 있는 환경을 선택하세요. 워커가 무엇인지는 [무엇이 어디에서 실행되는지](https://platform.claude.com/docs/ko/managed-agents/self-hosted#what-runs-where)에서 설명합니다. 워커가 없으면 첫 번째 도구 호출은 워커가 이를 실행할 때까지 대기합니다. 환경은 관리자가 만들며, 관리자는 환경의 **Workers** 탭에서 해당 환경의 워커를 확인할 수 있습니다.

<Steps>
  <Step title="에이전트 만들기">
    사이드바에서 **Agents**를 선택하고 **Create agent**를 클릭하세요. **Blank agent**와 같은 시작점을 선택하고 이름을 입력하세요.

    **Create agent**를 클릭하세요. 에이전트 페이지가 열립니다.
  </Step>

  <Step title="세션 시작하기">
    에이전트 페이지에서 **Start session**을 클릭하세요. 환경을 선택하고 **Create session**을 클릭하세요. 세션 페이지가 열립니다.
  </Step>

  <Step title="메시지 보내기">
    페이지 하단의 입력란에 메시지를 입력하고 전송하세요. 에이전트가 작업하는 동안 페이지가 업데이트됩니다. 도구 호출이 사용자를 기다리는 경우, 해당 카드에 **Approve**와 **Deny**가 표시됩니다.
  </Step>
</Steps>

도구 호출이 사용자를 기다리는 동안에는 세션 배지에 **Idle**이 표시됩니다.

애플리케이션이 API를 통해 시작한 세션 등 다른 세션을 열려면, 사이드바에서 **Sessions**를 선택한 다음 해당 세션을 선택하세요.

## 누가 무엇을 볼 수 있는지

API에서와 마찬가지로, 콘솔에 표시되는 내용은 역할에 따라 결정됩니다:

* **관리자**는 서버의 모든 것을 보고 변경할 수 있습니다.
* **`developer` 또는 `user` 역할을 가진 사용자**는 모든 환경을 볼 수 있습니다. 에이전트, 세션, 볼트, 메모리 저장소, 스킬 중에서는 자신의 로그인으로 직접 만든 것만 볼 수 있습니다.

빠른 시작에서 만든 것처럼 서버 API 키로 만든 에이전트나 세션은 관리자에게만 표시됩니다. 전체 표는 [각 역할의 권한](https://platform.claude.com/docs/ko/managed-agents/self-hosted/configure#what-each-role-can-do)을 참조하세요.

## 콘솔 끄기

서버는 기본적으로 콘솔을 제공합니다. 콘솔을 끄려면 [설정 파일](https://platform.claude.com/docs/ko/managed-agents/self-hosted/configuration-reference#where-settings-go)에서 `console.serve: false`를 설정하고 서버를 다시 시작하세요. 그러면 서버가 콘솔 제공을 중단합니다. 에이전트와 세션은 API를 통해 계속 작동합니다.

## 다음 단계

* [자체 호스팅 서버에서 API 호출하기](https://platform.claude.com/docs/ko/managed-agents/self-hosted/call-the-api): 코드나 `ant` CLI에서 동일한 작업을 수행하세요.
* [자체 호스팅 Claude Managed Agents의 데이터 및 액세스](https://platform.claude.com/docs/ko/managed-agents/self-hosted-data-and-access#who-can-reach-the-server): 서버와 콘솔에 누가 접근할 수 있는지 확인하세요.