Imposta il tuo primo agente

Da una nuova installazione a un agente AI funzionante. Le due parti che sfuggono di più ai principianti sono in cima: come AgentsRoom si collega alle CLI AI, e come accedere.

Come funziona AgentsRoom (leggi questo primo)

AgentsRoom è il cockpit. Le CLI AI (Claude, Codex, GitHub Copilot CLI, Cursor e altre 15 CLI di agenti) sono i motori. Accedi ai motori una sola volta tramite il loro comando, poi AgentsRoom li pilota visivamente. AgentsRoom non memorizza né vede mai i tuoi token, le API key o la password di ChatGPT: restano nell'archivio sicuro di ogni CLI, sulla tua macchina.

Non c'è "Log in to ChatGPT" o "Log in to Anthropic" pulsante all'interno AgentsRoom per design. Il login vive nella CLI che si installa nel passaggio 0 qui sotto.

Prima di iniziare

✓Windows 10+, macOS 14+ (Sonoma) o una distribuzione Linux a 64 bit recente
✓
Almeno una CLI di programmazione AI installata (Claude, Codex, GitHub Copilot CLI, Cursor o una qualsiasi delle altre 15 CLI di agenti supportate da AgentsRoom)
curl -fsSL https://claude.ai/install.sh | bash
✓Un abbonamento attivo o API key per il tuo fornitore scelto

Passo 0: installa e accedi al tuo motore AI

Scegli un provider da avviare (puoi aggiungere più avanti). Per ciascuno: installare CLI, eseguirlo una volta per accedere, verificarlo funziona. Poi saltare al passo 1.

Fare clic su un provider per espandere i suoi passaggi di configurazione.

Claude (Anthropic)Consigliato per utenti di prima volta

Funziona con

Claude Pro, Claude Max, o Anthropic API key.

1. Installazione

curl -fsSL https://claude.ai/install.sh | bash

2. Accedi

Eseguire claude una volta in qualsiasi terminale. Una finestra del browser si apre per accedere al tuo account Anthropic.

3. Verifica

Esegui il comando di installazione qui sopra, poi esegui solo il nome della CLI nel terminale (ad esempio digita "claude" e premi Invio). Dovresti vedere un messaggio di benvenuto. Digita "ciao" e premi Invio: se ricevi una risposta, sei pronto a usarla dentro AgentsRoom.

Codex (OpenAI / ChatGPT)Usa il tuo account ChatGPT

Funziona con

ChatGPT Plus, Pro, Team o Enterprise, o una OpenAI API key.

1. Installazione

curl -fsSL https://chatgpt.com/codex/install.sh | sh

2. Accedi

Eseguire codex una volta in qualsiasi terminale. Si apre una finestra del browser. Accedi con il tuo account ChatGPT, la stessa che utilizzi su chatgpt.com.

3. Verifica

Antigravity CLI (Google)Piano gratuito disponibile

Funziona con

Un account Google (accesso dal browser). È disponibile un generoso piano gratuito.

1. Installazione

curl -fsSL https://antigravity.google/cli/install.sh | bash

2. Accedi

Esegui antigravity una volta in qualsiasi terminale. Si apre una finestra del browser per l'accesso con Google.

3. Verifica

OpenCodePorta il tuo fornitore

Funziona con

Qualsiasi provider configurato: Anthropic, OpenAI, OpenRouter e altro ancora.

1. Installazione

curl -fsSL https://opencode.ai/v2/install | bash

2. Accedi

Eseguire opencode, poi usare il comando /connect per aggiungere una chiave del provider o un abbonamento OpenCode Go.

3. Verifica

Grok Build (xAI)Contesto 256K

Funziona con

Un account xAI (accesso via browser) o una chiave Grok API per l'uso headless.

1. Installazione

curl -fsSL https://x.ai/cli/install.sh | bash

2. Accedi

Esegui grok una volta in qualsiasi terminale. Si apre una finestra del browser per l'accesso a xAI. Per l'uso headless, imposta invece la variabile di ambiente GROK_CODE_XAI_API_KEY.

3. Verifica

CursorIl tuo editor, nel terminale

Funziona con

Un account Cursor. Il tuo piano attuale copre la CLI; il piano gratuito arriva a meno modelli.

1. Installazione

curl https://cursor.com/install -fsS | bash

2. Accedi

Esegui cursor-agent login per accedere dal browser. La configurazione si trova in ~/.cursor.

3. Verifica

Kimi (Moonshot AI)Contesto fino a 1M

Funziona con

Un account Kimi (accesso dal browser) o una chiave API della Open Platform di Moonshot AI.

1. Installazione

curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

2. Accedi

Esegui kimi una volta in un terminale, poi digita /login per accedere con il tuo account Kimi. La configurazione si trova in ~/.kimi-code.

3. Verifica

FreebuffNessuna chiave richiesta

Funziona con

Nessuno. Il servizio è gratuito ed è finanziato da annunci testuali mostrati tra un turno e l'altro.

1. Installazione

npm install -g freebuff

2. Accedi

Esegui freebuff nel tuo progetto. Esiste un comando freebuff login se vuoi collegare un account Codebuff.

3. Verifica

oh-my-piOltre 60 backend

Funziona con

Quello che paghi già: accede ad Anthropic, OpenAI, Google, xAI, Z.ai, DeepSeek e altri, oppure accetta una semplice chiave API.

1. Installazione

curl -fsSL https://omp.sh/install | sh

2. Accedi

Esegui omp una volta, poi usa /login per collegare un provider. La configurazione si trova in ~/.omp.

3. Verifica

Pi (Earendil)Minimalista ed estensibile

Funziona con

Quello che paghi già: Pi accede ad Anthropic, OpenAI, Google, GitHub Copilot e molti altri provider, oppure accetta una semplice chiave API.

1. Installazione

curl -fsSL https://pi.dev/install.sh | sh

2. Accedi

Esegui pi una volta, poi usa /login per collegare un provider. La configurazione si trova in ~/.pi/agent.

3. Verifica

DevinUn piano, molti modelli

Funziona con

Un piano Devin o Windsurf, incluso quello gratuito. Lo stesso abbonamento copre Claude, GPT, Gemini e i modelli SWE di Cognition.

1. Installazione

curl -fsSL https://cli.devin.ai/install.sh | bash

2. Accedi

Esegui devin auth login per accedere dal browser. La configurazione si trova in ~/.config/devin.

3. Verifica

Command CodeScegli tra modelli aperti e proprietari

Funziona con

Un account Command Code o una chiave API in COMMAND_CODE_API_KEY. L’accesso ai modelli e i limiti di utilizzo dipendono dal tuo account presso il provider.

1. Installazione

npm install -g command-code@latest

2. Accedi

Esegui command-code login per accedere, oppure imposta COMMAND_CODE_API_KEY nel tuo ambiente. Poi esegui command-code nel tuo progetto.

3. Verifica

Mistral VibeModelli europei

Funziona con

Un account Mistral (Pro o Team) o una chiave API Mistral.

1. Installazione

command -v uv >/dev/null 2>&1 || curl -LsSf https://astral.sh/uv/install.sh | sh; . "$HOME/.local/bin/env" 2>/dev/null; uv tool install --python 3.12 mistral-vibe

2. Accedi

Esegui vibe --setup una volta per salvare la tua chiave API Mistral, poi avvia con vibe. La configurazione si trova in ~/.vibe/config.toml.

3. Verifica

Muse Code (Meta)Muse Spark nel tuo terminale

Funziona con

Un account Meta con accesso a Muse Code, oppure una chiave API in META_API_KEY. L’accesso e i limiti di utilizzo sono stabiliti da Meta.

1. Installazione

curl -fsSL https://dev.meta.ai/install.sh | sh

2. Accedi

Esegui muse login per accedere, oppure imposta META_API_KEY nel tuo ambiente. Poi esegui muse nel tuo progetto.

3. Verifica

AiderUtenti di potenza

Funziona con

Qualsiasi fornitore tramite API key (Anthropic, OpenAI, DeepSeek e altro ancora).

1. Installazione

command -v uv >/dev/null 2>&1 || curl -LsSf https://astral.sh/uv/install.sh | sh; . "$HOME/.local/bin/env" 2>/dev/null; uv tool install --python 3.12 aider-chat

2. Accedi

Nessun comando di login. Imposta la tua API key come variabile d'ambiente nel profilo della tua shell, per esempio: export ANTHROPIC_API_KEY=sk-...

3. Verifica

Amp (Sourcegraph)Modalità, non modelli

Funziona con

Un account Amp (accesso dal browser) o un token AMP_API_KEY.

1. Installazione

curl -fsSL https://ampcode.com/install.sh | bash

2. Accedi

Esegui amp login una volta in un terminale qualsiasi per accedere. Le impostazioni si trovano in ~/.config/amp.

3. Verifica

MiniMax Code (MiniMax)Modelli della serie M

Funziona con

Un account MiniMax (accesso dal browser) o una chiave API MiniMax.

1. Installazione

curl -fsSL https://filecdn.minimax.chat/public/install.sh | bash

2. Accedi

Esegui mcode login --region global (oppure mcode login per un account della Cina continentale) in un terminale. La configurazione si trova in ~/.minimax.

3. Verifica

ZCode (client della community)Modelli GLM, non di Z.ai

Funziona con

Un piano Z.ai o BigModel, oppure una chiave API. Questo client della community non è pubblicato né approvato da Z.ai.

1. Installazione

npm install -g zcode-app-cli@latest

2. Accedi

Esegui zcode una volta in un terminale, poi digita /login per accedere con il tuo account Z.ai o BigModel. Richiede Node.js 22.19 o successivo. La configurazione si trova in ~/.zcode.

3. Verifica

Bloccato a questo passo? Vedi la sezione risoluzione dei problemi in fondo a questa pagina.

Scaricare e installare AgentsRoom

Scarica il programma di installazione per il tuo sistema operativo: il file .dmg su macOS, il file .exe su Windows o l'AppImage su Linux. Aprilo, segui i passaggi di installazione, quindi avvia AgentsRoom.

Tip: AgentsRoom controlla automaticamente gli aggiornamenti. Verrai notificato quando sarà disponibile una nuova versione.

Crea il tuo primo progetto

Fare clic sul pulsante + nella barra laterale. Selezionare qualsiasi cartella sulla macchina. Ecco dove lavoreranno i tuoi agenti dell'IA. Nomina il tuo progetto e assegnalo ad una zona.

Tip: Ogni progetto corrisponde a una vera cartella. Gli agenti eseguono la CLI del provider scelto in quella directory, proprio come faresti nel tuo terminale.

Aggiungi il tuo primo agente

All'interno del progetto, fare clic su Aggiungi agente. Scegli un ruolo (Fullstack è un buon inizio), poi un fornitore (il motore che hai impostato al passo 0), quindi un modello (Sonnet è consigliato per Claude). Opzionalmente scrivere un prompt iniziale e fare clic su Avvio. Il terminale si apre ed esegue la CLI al posto tuo.

Tip: Se il terminale sembra vuoto o mostra una schermata di login, la CLI del punto 0 non ha ancora eseguito l'accesso. Aprire un terminale regolare, eseguire claude o codex (o il comando del provider) una volta, completare l'accesso, quindi tornare.

Guardalo lavorare

Il terminale mostra output live: ogni file letto, ogni modifica. Lo stato cambia: al lavoro, poi completato. Si ottiene una notifica desktop quando finisce.

Tip: Puoi lanciare più agenti contemporaneamente. Ognuno ottiene il proprio terminale e funziona in modo indipendente.

Personalizza la configurazione

Modifica CLAUDE.md direttamente da AgentsRoom per dare agli agenti un contesto migliore. Cambia i modelli, regola le autorizzazioni, configura gli hook. Aggiungi altri agenti con ruoli o fornitori diversi.

Tip: Opus per l'architettura. Sonnet per dev. Haiku per compiti rapidi come test.

Consigli e trucchi

1.Utilizzare Opus per le decisioni di architettura, Sonnet per la codifica quotidiana, Haiku per compiti rapidi

2.Raggruppa i progetti per zona (Work, Personal, Side-projects) per una migliore organizzazione

3.Modifica CLAUDE.md da AgentsRoom per dare agli agenti un contesto di progetto migliore

4.Abilitare le notifiche desktop in modo da poter fare altro mentre gli agenti lavorano

5.Iniziare con un agente per progetto, aggiungere di più come si ottiene confortevole

Risoluzione dei problemi

Il mio terminale agente sembra vuoto o bloccato

Nella maggior parte dei casi la CLI non ha eseguito l'accesso. Apri il terminale (Terminal su macOS, PowerShell o Windows Terminal su Windows, il tuo emulatore di terminale su Linux), esegui il comando della CLI da solo (claude, codex, antigravity, opencode), completa l'accesso nel browser, quindi torna su AgentsRoom e avvia di nuovo l'agente. AgentsRoom non ha una propria schermata di accesso: l'autenticazione risiede nella CLI.

command not found: claude (o codex, antigravity, ecc.)

La CLI non è installata, oppure il PATH della tua shell non la vede. Riesegui il comando di installazione del punto 0 qui sopra. Se usi nvm, installa la CLI con la stessa versione di Node che usi ogni giorno, altrimenti il binario non sarà nel PATH all'avvio di AgentsRoom.

Non vedo un pulsante per accedere a ChatGPT o Claude all'interno AgentsRoom

Per scelta progettuale. AgentsRoom è un'interfaccia che si appoggia alle CLI e non gestisce mai direttamente le tue credenziali. L'accesso si fa una sola volta dentro la CLI (esegui claude o codex in un terminale), poi AgentsRoom usa quella sessione. È questo che rende AgentsRoom più sicuro degli strumenti che intercettano i tuoi token.

Agente bloccato su "pensare"

Controllare che l'abbonamento o API key sia attivo per il fornitore selezionato. Prova a eseguire il CLI direttamente nel tuo terminale per vedere il messaggio di errore reale: Claude o OpenAI a volte limitano o fanno scadere le sessioni senza avvisare.

Nessun progetto mostrato nella barra laterale

Assicurarsi di aver selezionato una cartella valida durante la creazione del progetto. La cartella deve esistere sul disco. Riavviare AgentsRoom se un progetto è stato aggiunto ma non ancora visibile.

Ho installato la CLI ma AgentsRoom dice ancora "command not found"

AgentsRoom eredita il suo PATH dalla tua shell di login, non dal tuo terminale interattivo. Chiudi completamente AgentsRoom, apri un nuovo terminale, verifica che la CLI sia richiamabile da una nuova sessione di shell (which claude), poi riavvia AgentsRoom.