Avvio rapido

Questo è il percorso completo più breve per passare da zero a un agente che lavora sul tuo codice. Seguilo nell’ordine; ogni passaggio dipende dal precedente.

Ti servono Git, un account GitHub e, a tua scelta, un account presso un fornitore di modelli (Anthropic, OpenAI, Codex, Cursor, Kimi Code o qualsiasi fornitore con una chiave API) oppure la CLI di Claude Code già installata. Tutto il resto si configura lungo il percorso.

Passaggio 1: installa e avvia

Installa Control Center come descritto in Installazione, quindi aprilo.

Al primo avvio l’app desktop chiede «Come eseguire Control Center?». Scegli Esegui in questa app. Control Center avvia un cc_server headless su questa macchina, che possiede i tuoi dati e fa tutto il lavoro. Non lo vedi mai; al suo posto si apre la schermata di onboarding.

Preferisci non installare nulla?

La stessa app gira nel browser su app.usectrl.dev con le stesse funzionalità. Una scheda del browser, però, non può ospitare il server: devi fornirne uno tu — esegui cc_server in locale e connettiti a ws://localhost:9030, oppure puntalo a un server su un’altra macchina. Questo avvio rapido segue la via dell’app desktop perché non richiede alcuna configurazione del server; per la via del browser vedi Installazione.

Passaggio 2: completa l’onboarding

L’onboarding prevede cinque passaggi che si susseguono nell’ordine indicato: non puoi saltarne nessuno.

1. Connetti: accedi con GitHub oppure incolla un token di accesso personale con repo e read:org. La credenziale è memorizzata sul server e associata al tuo account.
2. Spazio di lavoro: dai un nome al tuo primo spazio di lavoro e, facoltativamente, scegli un logo. Crearlo genera cinque agenti — un CEO più qa, architect, engineer e librarian — e i modelli di pipeline integrati.
3. Sandbox: registra una preferenza di sandboxing. In entrambi i casi puoi continuare.
4. Adattatore: scegli l’adattatore e il modello predefiniti per gli agenti. Seleziona Control Center (built-in), poi usa il selettore di fornitori che compare per accedere a un fornitore di modelli — l’elenco dei modelli resta vuoto finché non ne colleghi uno. Completare questo passaggio applica l’adattatore e il modello anche all’agente CEO dello spazio di lavoro.
5. Voce (opzionale): installa un modello vocale sul dispositivo per la dettatura, oppure salta questo passaggio.

Control Center apre quindi la posta in arrivo del tuo spazio di lavoro.

Cosa delimita l’esecuzione di un agente

I comandi di un agente vengono racchiusi nella sandbox nativa del sistema operativo dell’host, quando ne esiste una — Seatbelt su macOS, bubblewrap su Linux. Windows non ha alcun backend, quindi le esecuzioni su quella piattaforma sono delimitate solo dagli altri livelli: il worktree proprio della conversazione (git worktree su Windows; copy-on-write dove è disponibile rift), le credenziali intermediarie a ogni avvio e revocate allo smontaggio, e i guardrail delle azioni. Vedi Sandbox e sicurezza.

Passaggio 3: aggiungi un repository

Vai su Impostazioni → Spazio di lavoro → Repository e fai clic su Aggiungi repository.

La finestra di dialogo esplora le cartelle della macchina che esegue il server, non quelle del tuo client, e resta all’interno delle radici che quel server è configurato a esporre (la home del suo utente per impostazione predefinita). Solo i checkout git hanno una casella di controllo. Spunta il tuo e registralo.

Un checkout è accettato solo se si trova dentro un work tree git, ha un remote origin e quel remote punta a un forge supportato — github.com, gitlab.com o bitbucket.org. Qualsiasi altro caso viene rifiutato, con la motivazione.

I repo hanno come ambito lo spazio di lavoro: registrare un checkout qui lo inserisce in questo spazio di lavoro. Non esiste un passaggio di collegamento separato.

Passaggio 4: assegna a un agente un adattatore e un modello

Vai su Impostazioni → Spazio di lavoro → Agenti. Seleziona l’agente engineer nell’elenco.

Nella scheda Impostazioni, imposta:

• Adattatore: Control Center (built-in)
• Modello: scegline uno dal fornitore che hai collegato durante l’onboarding

Fai clic su Salva modifiche.

In pratica questo passaggio non è facoltativo. Solo l’agente CEO eredita l’adattatore scelto durante l’onboarding; i quattro specialisti vengono creati senza. Ripiegano su Control Center (built-in) con il modello predefinito di Anthropic, quindi si eseguono solo se hai collegato un account Anthropic — e su un modello che non hai scelto, se lo hai fatto.

Passaggio 5: invia un compito all’agente

1. Nella barra laterale, trova la sezione Spazi e fai clic sul pulsante +.
2. Dai un nome allo spazio, aggiungi l’agente engineer sotto Aggiungi agenti e crealo.
3. Scrivi un compito concreto e piccolo sul repo che hai registrato e premi Invio.

Control Center prepara un worktree copy-on-write dei repo dello spazio di lavoro per questa conversazione, compone un prompt dal ruolo, dalla persona e dalle skill dell’agente e dal contesto dello spazio, e invia l’esecuzione. Il tuo checkout di origine non viene mai toccato.

Passaggio 6: guardalo lavorare

Dovresti vedere, nell’ordine:

• Il pulsante di invio del compositore trasformarsi in un pulsante di arresto, perché un agente sta lavorando in questa conversazione
• Il ragionamento, le chiamate agli strumenti e il testo dell’agente che scorrono nel transcript
• Il pulsante di invio che ricompare quando l’esecuzione termina

Poi apri Impostazioni → Spazio di lavoro → Agenti, seleziona l’agente e controlla la scheda Log: una riga di esecuzione, con stato, durata, ora di avvio e di completamento e l’adattatore su cui è stata eseguita.

Questo è il ciclo. Tutto il resto di Control Center — revisione delle pull request, pipeline, ticket, riunioni, Slack — si fonda su di esso.

Passaggi successivi

• Il tuo primo spazio di lavoro: lo stesso terreno, con più calma e con il modello di isolamento spiegato
• Revisiona la tua prima pull request: porta il branch di un agente attraverso la revisione e l’unione
• Il modello degli agenti: di cosa è fatto un agente
• Crea e configura un agente: il resto del modulo dell’agente
• Esegui un’orchestrazione: un obiettivo, un’approvazione, una pipeline generata
• Associa un dispositivo: segui la flotta da qualsiasi luogo
• Deployment e client: come si rapportano al server i client desktop, web e mobile