---
title: Use o console no seu servidor
url: https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted/console
description: Configure o login para o console no seu servidor auto-hospedado do Claude Managed Agents e, em seguida, crie agentes e execute sessões em um navegador.
---

<Note>
  Para solicitar acesso ao Claude Managed Agents auto-hospedado, entre em contato com a equipe da sua conta na Anthropic.
</Note>

O console no seu servidor é uma página da web que um servidor “self-hosted” (auto-hospedado) do Claude Managed Agents disponibiliza no mesmo endereço da sua API. Nele, você cria agentes, executa sessões e gerencia ambientes, cofres de credenciais, armazenamentos de memória e skills, sem SDK nem CLI.

Ele não é o Claude Console em platform.claude.com. Ele mostra apenas o que está no seu servidor.

## Configurar o login

Um administrador configura o login uma única vez. Para, em vez disso, experimentar o console em uma única máquina, siga [Experimente o console no seu servidor](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted/quickstart#try-the-console-on-your-server), que usa o provedor de login simulado da versão.

<Steps>
  <Step title="Configure o single sign-on e o login pelo terminal">
    Siga [Single sign-on](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted/configure#single-sign-on), incluindo [Permita que desenvolvedores façam login a partir de um terminal](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted/configure#let-developers-log-in-from-a-terminal). O console faz o login das pessoas por meio da aplicação que você registrou para o login pelo terminal. Ele verifica cada token em relação à primeira entrada de `audiences` na entrada do emissor, então liste primeiro a audiência dessa aplicação.
  </Step>

  <Step title="Disponibilize o console via HTTPS">
    Coloque um proxy que encerre o TLS na frente da porta 8400. [Coloque TLS na frente do servidor](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted/kubernetes#put-tls-in-front-of-the-server) lista o que o proxy deve fazer. Em HTTP simples, o login funciona apenas em `localhost` ou `127.0.0.1`.
  </Step>

  <Step title="Adicione o endereço do console à aplicação">
    No seu provedor de identidade, adicione o endereço HTTPS do seu servidor como um segundo “redirect URI” (URI de redirecionamento) dessa aplicação, com uma barra no final: `https://cma.example.com/`. Permita também sua origem, `https://cma.example.com`, para requisições entre origens (CORS).
  </Step>
</Steps>

Para verificar a configuração, [abra o console](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted/console#open-the-console) e faça login.

## Abrir o console

Se suas aplicações chamam `https://cma.example.com`, abra `https://cma.example.com/` em um navegador e clique em **Continue with SSO**.

Você faz login por meio do seu “identity provider” (provedor de identidade). O console não aceita a chave de API do servidor. Se o console informar que o login não está configurado neste servidor, um administrador precisa [configurar o login](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted/console#set-up-sign-in).

## Executar um agente a partir do console

As ferramentas integradas de um agente em branco, como `bash`, são executadas em um worker, então selecione um ambiente que um worker esteja consultando. [O que é executado onde](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted#what-runs-where) explica o que é um worker. Sem worker, a primeira chamada de ferramenta aguarda até que um a execute. Administradores criam ambientes e podem ver os workers de um ambiente na aba **Workers** dele.

<Steps>
  <Step title="Crie um agente">
    Na barra lateral, selecione **Agents** e clique em **Create agent**. Selecione um ponto de partida, como **Blank agent**, e insira um nome.

    Clique em **Create agent**. A página do agente é aberta.
  </Step>

  <Step title="Inicie uma sessão">
    Na página do agente, clique em **Start session**. Selecione um ambiente e clique em **Create session**. A página da sessão é aberta.
  </Step>

  <Step title="Envie uma mensagem">
    Insira uma mensagem na caixa na parte inferior da página e envie-a. A página é atualizada conforme o agente trabalha. Se uma chamada de ferramenta aguardar por você, seu cartão mostra **Approve** e **Deny**.
  </Step>
</Steps>

Enquanto uma chamada de ferramenta aguarda por você, o selo da sessão exibe **Idle**.

Para abrir qualquer outra sessão, como uma que uma aplicação iniciou por meio da API, selecione **Sessions** na barra lateral e, em seguida, selecione a sessão.

## Quem vê o quê

Sua função determina o que o console mostra, assim como acontece na API:

* **Administradores** veem e alteram tudo no servidor.
* **Pessoas com a função `developer` ou `user`** veem todos os ambientes. Dos agentes, sessões, cofres, armazenamentos de memória e skills, veem apenas o que criaram com o próprio login.

Um agente ou sessão criado com a chave de API do servidor, como os do início rápido, aparece apenas para administradores. Para a tabela completa, consulte [O que cada função pode fazer](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted/configure#what-each-role-can-do).

## Desativar o console

O servidor disponibiliza o console por padrão. Para desativá-lo, defina `console.serve: false` no [arquivo de configurações](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted/configuration-reference#where-settings-go) e reinicie o servidor. O servidor então deixa de disponibilizar o console. Agentes e sessões continuam funcionando por meio da API.

## Próximos passos

* [Chamar a API em um servidor auto-hospedado](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted/call-the-api): Faça o mesmo trabalho a partir do seu código ou da CLI `ant`.
* [Dados e acesso no Claude Managed Agents auto-hospedado](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted-data-and-access#who-can-reach-the-server): Veja quem pode acessar o servidor e seu console.
