Imposta il tuo primo agente

Da una nuova installazione a un agente AI funzionante. Le due parti più principianti sono in cima: come AgentsRoom si riferisce all'AI CLI, e come firmare.

Come funziona AgentsRoom (leggi questo primo)

AgentsRoom è il cockpit. L'AI CLIs (Claude Code, Codex, OpenCode, Gemini, Aider) sono i motori. Si accede ai motori una volta tramite il proprio comando, quindi AgentsRoom li guida visivamente. AgentsRoom non memorizza mai o visualizza i gettoni, API keys o ChatGPT password: quelli rimangono all'interno di ogni CLI proprio storage sicuro sulla vostra 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

✓macOS 14+ (Sonoma o versioni successive)
✓
Almeno una codifica AI CLI installata (Claude, Codex, OpenCode, Gemini CLI o Aider)
npm install -g @anthropic-ai/claude-code
✓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

Lavori con

Claude Pro, Claude Max, o Anthropic API key.

1. Installazione

npm install -g @anthropic-ai/claude-code

2. Accedi

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

3. Verifica

Eseguire il comando di installazione sopra, quindi eseguire il nome di CLI da solo nel terminale (ad esempio digitare "claude" e premere entrare). Si dovrebbe vedere un messaggio di benvenuto. Digitare "ciao" e premere entrare: se si ottiene una risposta, si è pronti ad usarlo all'interno AgentsRoom.

Codex (OpenAI / ChatGPT)Usa il tuo account ChatGPT

Lavori con

ChatGPT Inoltre, Pro, Team o Enterprise, o OpenAI API key.

1. Installazione

npm install -g @openai/codex

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

OpenCodePorta il tuo fornitore

Lavori con

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

1. Installazione

npm install -g opencode-ai

2. Accedi

Eseguire il login opencode auth e seguire le istruzioni per aggiungere una chiave del provider.

3. Verifica

Gemini CLI (Google)Tier gratuito disponibile

Lavori con

Un account Google (gratuito disponibile) o un Gemini API key.

1. Installazione

npm install -g @google/gemini-cli

2. Accedi

Gestisci i gemini una volta. Una finestra del browser si apre per Google sign-in.

3. Verifica

AiderUtenti di potenza

Lavori con

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

1. Installazione

pip install aider-chat

2. Accedi

Nessun comando di login. Impostare il vostro API key come una variabile di ambiente nel vostro profilo shell, per esempio: esportare ANTHROPIC API KEY=sk-...

3. Verifica

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

Scaricare e installare AgentsRoom

Scarica il file .dmg, aprilo e trascina AgentsRoom nella cartella Applicazioni. Lancialo da Spotlight o dalla cartella Applicazioni.

Tip: AgentsRoom auto-controlla per 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 mappa a una vera cartella. Gli agenti gestiscono l'CLI del vostro fornitore scelto in quella directory, proprio come si farebbe nel vostro 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 e gestisce l'CLI per voi.

Tip: Se il terminale sembra vuoto o mostra una schermata di login, CLI dal punto 0 non è ancora firmato. Aprire un terminale regolare, eseguire claude o codex (o il comando del provider) una volta, completare il sign-in, quindi tornare.

Guarda il lavoro

Il terminale mostra output live: ogni file letto, ogni modifica. Cambiamenti di stato: pensiero, codifica, fatto. Si ottiene una notifica macOS 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 i ganci. 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.Progetti di gruppo 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 macOS in modo da poter multitask 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

La maggior parte delle volte la CLI non è firmata. Aprire un terminale regolare (Terminal.app), eseguire il comando CLI da solo (claude, codex, gemini, opencode), completare il login del browser, quindi tornare a AgentsRoom e lanciare nuovamente l'agente. AgentsRoom non ha la sua schermata di login: l'auth vive nella CLI.

comando non trovato: claude (o codex, gemini, ecc.)

Il CLI non è installato, o il vostro guscio PATH non lo vede. Ripristina il comando di installazione dal punto 0 sopra. Se si utilizza nvm, installare CLI con la stessa versione Node si utilizza giorno per giorno, altrimenti il binario non sarà in PATH quando AgentsRoom lancia.

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

Per design. AgentsRoom è un UI in cima a CLIs e non gestisce mai le credenziali direttamente. Il sign-in viene fatto una volta all'interno dell'CLI (in esecuzione claude o codex in un terminale), quindi AgentsRoom utilizza quella sessione. Questo è ciò che rende AgentsRoom più sicuro degli strumenti che intercettano i gettoni.

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 rallentare o scadere le sessioni silenziosamente.

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 CLI ma AgentsRoom dice ancora "comand not found"

AgentsRoom eredita il suo PATH dal vostro guscio di login, non dal vostro terminale interattivo. Quit AgentsRoom completamente, aprire un nuovo terminale, verificare che CLI sia chiamato da una sessione di shell fresca (che claude), quindi rilanciare AgentsRoom.