Installare e preparare l’app

Per iniziare, installa l’app desktop Noea e prepara almeno un coding Agent. L’app ti guida nell’installazione, nell’accesso e nella verifica della connessione.

Scegli un programma di installazione

Visita la sezione download di Noea e scegli la versione per il tuo sistema operativo e processore.

Su macOS, apri l’immagine disco e installa l’app. Su Windows, esegui il programma di installazione: installa per l’utente attuale senza richiedere privilegi di amministratore. Su Linux, usa AppImage o .deb secondo la distribuzione.

Prepara il tuo primo Agent

Se all’avvio di Noea non è pronto alcun Agent, si apre la guida alla configurazione.

1. Scegli un Agent dall’elenco e fai clic su Installa (Install).
2. Attendi il download, poi segui il pannello dei dettagli per accedere e autorizzare l’accesso.
3. Attendi che Noea verifichi la connessione. Solo lo stato Pronto (Ready) indica che la verifica è riuscita.
4. Scegli l’opzione per iniziare a usare Noea ed entra nell’ambiente di lavoro.

Noea supporta attualmente Codex, Claude Code, OpenCode e CodeBuddy Code. Per iniziare ne basta uno. Puoi aggiungerne altri in Impostazioni → Agent (Settings → Agent).

Noea scarica il runtime necessario all’Agent, quindi non devi installare Node.js in anticipo. L’app mostra l’avanzamento del download e della preparazione.

Accedi con il metodo dell’Agent

L’accesso può aprire un browser, un terminale interno o di sistema, oppure richiedere una chiave API. Segui le istruzioni dell’Agent selezionato.

Codex preferisce l’accesso via browser su macOS e Windows e tramite codice dispositivo su Linux. OpenCode si configura collegando un fornitore di modelli. Per account dei fornitori, chiavi API ed endpoint personalizzati, consulta Agent, modelli e utilizzo.

Noea verifica di nuovo la connessione dopo l’accesso. Se continua a chiedere di accedere o segnala un errore, apri il pannello dei dettagli dell’Agent per scoprirne il motivo.

Anche se usi già un Agent in un altro strumento da terminale, fa fede il suo stato nell’elenco di Noea per capire se è pronto qui.

Risolvi i problemi di download o verifica

I download e le richieste degli Agent usano le impostazioni proxy HTTP(S) del sistema. Le variabili d’ambiente del proxy, se impostate, hanno la precedenza. Questo meccanismo non supporta proxy SOCKS.

Se un download fallisce, controlla la rete e le impostazioni proxy, poi riprova dallo stesso punto. Uno stato di preparazione durante una breve pausa nella ricezione dei dati non significa necessariamente che il download sia fallito.

Se l’installazione riesce ma la verifica fallisce, usa il pannello dei dettagli dell’Agent per accedere di nuovo, correggere le impostazioni del fornitore o risolvere i problemi di rete. Puoi copiare la diagnostica quando chiedi aiuto; consulta Risoluzione dei problemi.

Apri il progetto

Nell’ambiente di lavoro, scegli Apri cartella… (Open Folder…) e seleziona la cartella del codice. Noea apre o crea un progetto collegato. Per seguire il primo tutorial non servono un documento completo dei requisiti, server MCP o Skills.

Continua con La tua prima revisione.