---
title: Usa la console sul tuo server
url: https://platform.claude.com/docs/it/managed-agents/self-hosted/console
description: Configura l'accesso alla console sul tuo server Claude Managed Agents self-hosted, quindi crea agenti ed esegui sessioni in un browser.
---

<Note>
  Per richiedere l’accesso a Claude Managed Agents self-hosted, contatta il tuo team di riferimento Anthropic.
</Note>

La console sul tuo server è una pagina web che un server Claude Managed Agents self-hosted serve allo stesso indirizzo della sua API. In essa crei agenti, esegui sessioni e gestisci ambienti, vault delle credenziali, archivi di memoria e skill, senza SDK né CLI.

Non è la Claude Console su platform.claude.com. Mostra solo ciò che si trova sul tuo server.

## Configura l’accesso

Un amministratore configura l’accesso una sola volta. Per provare invece la console su una sola macchina, segui [Provare la console sul tuo server](https://platform.claude.com/docs/it/managed-agents/self-hosted/quickstart#try-the-console-on-your-server), che usa il provider di accesso fittizio della release.

<Steps>
  <Step title="Configura il single sign-on e l’accesso da terminale">
    Segui [Single sign-on](https://platform.claude.com/docs/it/managed-agents/self-hosted/configure#single-sign-on), incluso [Consentire agli sviluppatori di accedere da un terminale](https://platform.claude.com/docs/it/managed-agents/self-hosted/configure#let-developers-log-in-from-a-terminal). La console fa accedere le persone tramite l’applicazione che hai registrato per l’accesso da terminale. Verifica ogni token rispetto alla prima voce di `audiences` nella voce dell’emittente, quindi elenca per prima l’audience di quell’applicazione.
  </Step>

  <Step title="Servi la console tramite HTTPS">
    Posiziona un proxy che termini TLS davanti alla porta 8400. [Metti TLS davanti al server](https://platform.claude.com/docs/it/managed-agents/self-hosted/kubernetes#put-tls-in-front-of-the-server) elenca cosa deve fare il proxy. Con HTTP semplice, l’accesso funziona solo su `localhost` o `127.0.0.1`.
  </Step>

  <Step title="Aggiungi l’indirizzo della console all’applicazione">
    Nel tuo provider di identità, aggiungi l’indirizzo HTTPS del tuo server come secondo redirect URI di quell’applicazione, con una barra finale: `https://cma.example.com/`. Consenti inoltre la sua origine, `https://cma.example.com`, per le richieste cross-origin (CORS).
  </Step>
</Steps>

Per verificare la configurazione, [apri la console](https://platform.claude.com/docs/it/managed-agents/self-hosted/console#open-the-console) ed effettua l’accesso.

## Apri la console

Se le tue applicazioni chiamano `https://cma.example.com`, apri `https://cma.example.com/` in un browser e fai clic su **Continue with SSO**.

Accedi tramite il tuo “identity provider” (provider di identità). La console non accetta la chiave API del server. Se la console indica che l’accesso non è configurato su questo server, un amministratore deve [configurare l’accesso](https://platform.claude.com/docs/it/managed-agents/self-hosted/console#set-up-sign-in).

## Esegui un agente dalla console

Gli strumenti integrati di un agente vuoto, come `bash`, vengono eseguiti su un worker, quindi seleziona un ambiente interrogato da un worker. [Cosa viene eseguito dove](https://platform.claude.com/docs/it/managed-agents/self-hosted#what-runs-where) spiega cos’è un worker. Senza un worker, la prima chiamata a uno strumento attende finché un worker non la esegue. Gli amministratori creano gli ambienti e possono vedere i worker di un ambiente nella sua scheda **Workers**.

<Steps>
  <Step title="Crea un agente">
    Nella barra laterale, seleziona **Agents** e fai clic su **Create agent**. Seleziona un punto di partenza, come **Blank agent**, e inserisci un nome.

    Fai clic su **Create agent**. Si apre la pagina dell’agente.
  </Step>

  <Step title="Avvia una sessione">
    Nella pagina dell’agente, fai clic su **Start session**. Seleziona un ambiente e fai clic su **Create session**. Si apre la pagina della sessione.
  </Step>

  <Step title="Invia un messaggio">
    Inserisci un messaggio nella casella in fondo alla pagina e invialo. La pagina si aggiorna mentre l’agente lavora. Se una chiamata a uno strumento attende te, la sua scheda mostra **Approve** e **Deny**.
  </Step>
</Steps>

Mentre una chiamata a uno strumento attende te, il badge della sessione indica **Idle**.

Per aprire qualsiasi altra sessione, ad esempio una avviata da un’applicazione tramite l’API, seleziona **Sessions** nella barra laterale, quindi seleziona la sessione.

## Chi vede cosa

Il tuo ruolo determina ciò che la console mostra, come avviene nell’API:

* **Gli amministratori** vedono e modificano tutto sul server.
* **Le persone con il ruolo `developer` o `user`** vedono ogni ambiente. Degli agenti, delle sessioni, dei vault, degli archivi di memoria e delle skill, vedono solo ciò che hanno creato con il proprio accesso.

Un agente o una sessione creati con la chiave API del server, come quelli della guida rapida, sono visibili solo agli amministratori. Per la tabella completa, vedi [Cosa può fare ciascun ruolo](https://platform.claude.com/docs/it/managed-agents/self-hosted/configure#what-each-role-can-do).

## Disattiva la console

Il server serve la console per impostazione predefinita. Per disattivarla, imposta `console.serve: false` nel [file delle impostazioni](https://platform.claude.com/docs/it/managed-agents/self-hosted/configuration-reference#where-settings-go) e riavvia il server. Il server smette quindi di servire la console. Agenti e sessioni continuano a funzionare tramite l’API.

## Passaggi successivi

* [Chiama l’API su un server self-hosted](https://platform.claude.com/docs/it/managed-agents/self-hosted/call-the-api): svolgi lo stesso lavoro dal tuo codice o dalla CLI `ant`.
* [Dati e accesso in Claude Managed Agents self-hosted](https://platform.claude.com/docs/it/managed-agents/self-hosted-data-and-access#who-can-reach-the-server): scopri chi può raggiungere il server e la sua console.
