
Usare Base Code
Prima di iniziare:
- Il tuo progetto deve essere un progetto web o full-stack in un repository GitHub. In un monorepo, deve essere idoneo il progetto nella radice del repository. Un’app mobile in una sottocartella va bene.
- Se crei la tua app in Base44, continua a lavorarci nell’editor dell’app e sincronizzala con un repository tramite l’integrazione GitHub.
- Devi collegare un account GitHub durante la configurazione.
Configurare Base Code
Collega un repository GitHub per fare modifiche con la chat AI in Base Code. Se il tuo account GitHub è già collegato, passa a scegliere un repository.Collegare il tuo account GitHub
Base Code lavora direttamente nei tuoi repository GitHub, quindi ha bisogno di accedere a quelli su cui vuoi lavorare. Il tuo account deve anche avere accesso in scrittura a ogni repository. Senza, il progetto mostra un badge Read only. Puoi discutere del progetto nella chat AI e cambiare branch, ma non puoi fare modifiche né creare un branch. Per collegare il tuo account:- Vai su Base Code.
- Clicca Connect GitHub.
- Accedi a GitHub se richiesto, poi autorizza Base44 Builder.
- Seleziona l’account o l’organizzazione GitHub. Poi segui le istruzioni per installare o configurare Base44 Builder e dargli accesso al repository. Se non sei proprietario dell’organizzazione GitHub, GitHub invia la tua richiesta ai proprietari dell’organizzazione e vedi Waiting for approval. Dopo che un proprietario l’ha approvata, clicca di nuovo Connect GitHub.
Correggere un progetto in sola lettura
Correggere un progetto in sola lettura
Per collegare il tuo account GitHub da un progetto:
- Apri il progetto.
- Clicca Connect account nel banner Connect your GitHub account.
- Autorizza Base44 Builder su GitHub.
Scegliere un repository
Scegli il codebase su cui vuoi lavorare, tra i tuoi repository o una copia di uno su cui non puoi fare push.- Dal tuo account
- Incolla un link
Per scegliere un repository dal tuo account:
- Clicca View more in Base Code.
- Seleziona un repository.
- Mantieni il Branch selezionato o scegline un altro.
- Clicca Connect.
Trovare un repository mancante
Trovare un repository mancante
Se il tuo repository non è elencato in Connect your repository, dai a Base44 l’accesso al repository su GitHub.Per aggiornare l’accesso al repository:
- Dai a Base44 Builder l’accesso al repository su GitHub.
- Riapri Connect your repository in Base Code.
Collegare un repository da un'organizzazione non approvata
Collegare un repository da un'organizzazione non approvata
Se vedi “Your workspace’s GitHub policy doesn’t allow this import”, oppure Base44 dice che il tuo repository non è in un’organizzazione GitHub approvata, il tuo workspace non consente repository di quell’organizzazione. Chiedi a chi gestisce le organizzazioni GitHub del workspace di collegare l’organizzazione e impostarla su Allowed, poi riprova.Se hai solo accesso in lettura, collega invece un fork o una copia privata. Quando il tuo workspace limita i repository alle organizzazioni approvate, ti serve l’accesso in scrittura a un repository di una di esse.
Lavorare sul tuo progetto
Usa la chat AI per fare modifiche al repository collegato e testarle in un’anteprima di sviluppo. Mentre chatti, Base Code fa il commit e il push delle modifiche sul tuo branch di lavoro su GitHub.Come viene eseguito il tuo progetto in Base Code:
- Base Code fornisce un’anteprima di sviluppo, non un hosting di produzione. Per rilasciare le modifiche o collegare un dominio personalizzato, usa il processo di deploy e il provider di hosting esistenti del tuo progetto.
- Il tuo progetto mantiene il proprio database, l’autenticazione e il routing. Collegare un repository non aggiunge le entità, il login o l’SDK di Base44. Per aggiungere un database, l’autenticazione o CI/CD, chiedi alla chat AI di aggiungerli con lo stack del tuo progetto, e aggiungi stringhe di connessione o chiavi API come secret.
- Quando torni in Base Code, l’ambiente del progetto si riavvia. Se va ricostruito, Base Code usa l’ultimo commit sul tuo branch GitHub. Prima di uscire, chiedi alla chat AI di confermare che le ultime modifiche sono su quel branch.
Fare la tua prima modifica
Quando colleghi un repository per la prima volta, la chat AI avvia il progetto prima che tu inizi un branch e mostra ogni passaggio della configurazione. Base Code avvia un nuovo branch dalla tua prima richiesta e gli dà un nome per te. Così la modifica resta separata finché non apri una pull request.La tua prima richiesta in un repository appena collegato è gratuita, inclusa la configurazione che avvia.
- Vai su Base Code.
- (Opzionale) Seleziona il branch da cui partire nel menu a tendina accanto a Create new branch from.
-
Descrivi la modifica che vuoi fare nella casella del prompt. Ad esempio:
-
Clicca Create branch. Se compare una di queste situazioni, fai quanto segue e clicca di nuovo Create branch:
- Connect to GitHub: autorizza l’app Base44 Builder su GitHub.
- “Your GitHub account can’t push to this repo”: chiedi a un admin del repository di dare al tuo account GitHub l’accesso in scrittura.

Creare il tuo primo branch
- Controlla la modifica in Preview quando appare, poi chiedi alla chat AI eventuali aggiustamenti. Su desktop, un nuovo branch si apre con la chat AI che occupa tutto l’editor. L’anteprima appare quando c’è una modifica da mostrare.
Se un passaggio della configurazione fallisce, clicca Fix setup per far trovare e correggere la causa all’AI.
Controllare le modifiche
Controlla esattamente cosa è cambiato prima di chiedere a qualcuno di revisionarlo. Per controllare le modifiche:- Apri le modifiche che vuoi controllare:
- Le modifiche di una risposta: usa l’elenco dei file sotto quella risposta nella chat AI.
- Tutte le modifiche sul branch: clicca Create PR nell’editor dell’app, o clicca il numero della PR se esiste già.
- Clicca il nome di un file per vederne il diff, con le righe aggiunte e rimosse.
Ripristinare un file
Annulla le modifiche che non vuoi in un file. Il ripristino viene salvato come nuovo commit sul tuo branch. Per ripristinare un file:- Apri il tuo branch in Base Code.
- Trova il file sotto la risposta della chat AI, o nell’elenco dei file del branch da Create PR o dal numero della PR.
- Clicca il file per espanderlo, poi clicca Revert file.
- Controlla che in Revert branch changes? appaia il file giusto, poi clicca Revert.
Aggiungere file da Google Drive
Quando inizi un branch, dai alla chat AI un brief, una specifica o un design dal tuo Google Drive. Per iniziare un branch da un file di Google Drive:- Vai su Base Code.
- Clicca l’icona Add nella casella del prompt.
- Clicca Upload from Google Drive.
- Se richiesto, clicca Connect Google Drive, poi consenti l’accesso in Google.
- Seleziona uno o più file da Il mio Drive o da un Drive condiviso. Puoi scegliere Documenti, Fogli e Presentazioni Google, file Word, Excel e PowerPoint, PDF, immagini e file di testo, CSV, HTML, XML e JSON.
- (Opzionale) Descrivi la modifica che vuoi fare nella casella del prompt.
- Clicca Create branch.
Fermare l’AI
Ferma la chat AI mentre lavora, poi invia un nuovo messaggio per cambiare direzione. Per fermare l’AI:- Clicca l’icona Stop generating nella casella del prompt.
- (Opzionale) Invia un nuovo messaggio con ciò che vuoi invece.
Cosa succede quando ti fermi:
- Le modifiche già salvate con commit sul tuo branch restano.
- Le modifiche che l’AI non aveva ancora salvato vengono scartate.
- Se fermi la creazione di un branch dalla schermata iniziale, Base Code ripristina il tuo prompt nella casella del prompt e rimuove il nuovo branch da Base Code.
Scegliere il modello AI
Base Code usa Auto per impostazione predefinita per scegliere un modello AI per ogni richiesta. Puoi scegliere tu un modello quando vuoi più controllo. Per scegliere un modello AI:- Apri il tuo branch in Base Code.
- Clicca il modello in fondo alla chat AI.
- Seleziona il modello con cui vuoi lavorare.
Usare le skill del repository
Insegna alla chat AI i flussi di lavoro del tuo team con le skill salvate nel tuo repository. Ogni skill ha un nome, una descrizione e delle istruzioni. La chat AI legge una skill quando è adatta alla tua richiesta. Le skill valgono per tutti quelli che lavorano al progetto, su ogni branch. Base Code trova le skill in questi punti, nella radice del repository o in una sottocartella:- Cartelle delle skill: un file
SKILL.mdin una cartella sotto.agents/skills,.claude/skillso.codex/skills. - Comandi di Claude Code: file Markdown in
.claude/commands. - Plugin locali: skill dei plugin di Claude Code o Codex salvati nel tuo repository.
- Clicca Dashboard nell’editor dell’app.
- Clicca Repository skills.
- Scegli cosa vuoi fare:
- Leggere una skill: clicca la skill per vederne le istruzioni.
- Attivare o disattivare una skill: clicca l’interruttore accanto alla skill. Le skill sono attive per impostazione predefinita, e solo il proprietario dell’app può attivarle o disattivarle.
- Mostrare una nuova skill: dopo aver aggiunto un file
SKILL.mdal repository, clicca Refresh.
Visualizzare l’anteprima delle app di un monorepo
Quando il tuo repository ha più app, come un sito web e un’API, ogni app in esecuzione ha una propria scheda sopra l’anteprima. Scegli quali app vengono eseguite su ogni branch. Per scegliere le app eseguite su un branch:- Apri il tuo branch in Base Code.
- Clicca l’icona Apps nella barra degli strumenti sopra l’anteprima, oppure clicca Add app alla fine della riga delle schede.
- Seleziona ogni app che vuoi eseguire in Apps to run on this branch.
- Clicca Done.
- Apri il tuo branch in Base Code.
- Clicca Split view alla fine della riga delle schede.
- Clicca Show o Start accanto all’app per il lato vuoto.
Espandere la chat
Nascondi l’anteprima così la chat AI occupa tutto l’editor, poi riporta l’anteprima quando vuoi controllare il tuo lavoro. La chat torna alla larghezza normale quando passi tra Preview, Dashboard e Code, o apri un altro file. Per espandere o ridurre la chat:- Apri il tuo branch in Base Code.
- Clicca l’icona Expand chat nella barra degli strumenti sopra la chat AI.
- Clicca l’icona Shrink chat per mostrare di nuovo l’anteprima.

La chat AI espansa
Gestire i branch
Ogni branch ha il proprio ambiente di sviluppo in Base Code. Puoi aprire una pull request per le sue modifiche.Creare branch
Inizia ogni nuova modifica su un branch dedicato, dal branch predefinito o da un altro branch su cui stai lavorando. Base Code dà un nome al branch per te. Per creare un branch dalla barra laterale:- Clicca New branch nella barra laterale.
- Seleziona il branch di partenza dal menu a tendina accanto a Create new branch.
- Descrivi la modifica nella chat AI, poi clicca Create.

Avviare un branch dalla barra laterale
Lavorare dalla barra laterale
Vedi a che punto è ciascuno dei tuoi branch e vai direttamente a quello che ha bisogno di te. Your branches nella barra laterale elenca i branch che hai creato. I branch uniti passano in Merged in fondo all’elenco, così puoi ancora leggerne le chat. Ogni branch ha un’icona di stato. Passaci sopra il mouse per vedere l’etichetta, con il numero della pull request quando c’è.
Queued significa che la tua pull request è in attesa nella coda di merge del tuo repository su GitHub.
Mentre l’AI sta costruendo, l’icona è sostituita da Working, e da Merging durante un merge. Un punto a destra di un branch indica che l’AI ha finito lì e che non l’hai ancora riaperto.
Per aprire un branch:
- Clicca il branch in Your branches.
Organizzare i branch
Tieni a portata di mano i branch su cui ti concentri e porta in cima quelli che hanno bisogno di te.
Branch fissati e raggruppati
- Passa il mouse sul branch nella barra laterale, poi clicca la sua icona delle opzioni .
- Clicca Pin.
- Clicca l’icona New group accanto a Your branches.
- Inserisci un Group name, poi clicca Create group.
- Trascina un branch sul gruppo, oppure clicca l’icona delle opzioni del branch , clicca Move to group, poi seleziona il gruppo.
- Togliere un branch da un gruppo: trascinalo su Your branches, oppure clicca la sua icona delle opzioni , clicca Move to group, poi clicca Ungrouped.
- Rinominare o eliminare un gruppo: clicca l’icona delle opzioni del gruppo , poi clicca Rename group o Delete group. Quando elimini un gruppo, puoi archiviare anche i suoi branch.
- Riordinare i gruppi: trascina un gruppo in alto o in basso nell’elenco.
- Clicca l’icona Sort branches accanto a Your branches.
- Seleziona Status, Last activity o None in Group by.
- Seleziona Date created o Name in Sort by.
Archiviare un branch
Archivia i branch su cui non stai lavorando per mantenere corto l’elenco. Un branch archiviato passa in Archived in fondo a Your branches, fuori dal suo fissaggio o gruppo. L’archiviazione cambia solo la tua barra laterale: il branch, la sua chat e il suo branch GitHub restano come sono. Per archiviare un branch:- Passa il mouse sul branch nella barra laterale, poi clicca la sua icona delle opzioni .
- Clicca Archive.
Rimuovere un branch
Togli i branch con cui hai finito. Per conservare un branch senza che affolli l’elenco, archivialo. Per rimuovere un branch:- Passa il mouse sul branch nella barra laterale, poi clicca la sua icona delle opzioni .
- Clicca Remove branch.
- Conferma nella finestra di dialogo:
- Remove: appare per un branch unito, o per un branch su cui ci sono anche i tuoi compagni di team. Il branch esce dal tuo elenco e non viene eliminato nulla. I tuoi compagni lo conservano con la sua chat, e puoi riportare indietro un branch non unito inviando di nuovo un prompt su di esso.
- Delete branch: appare per un branch non unito su cui non c’è nessun altro. Il branch e la sua chat vengono eliminati definitivamente da Base Code. Il branch e i suoi commit restano su GitHub.
Lavorare con le pull request
Fai revisionare e unire le tue modifiche tramite pull request su GitHub. Base Code usa sempre la tua connessione GitHub personale, qualunque sia l’impostazione del workspace per le altre app. Il tuo account GitHub deve essere collegato e avere accesso in scrittura al repository. Base44 apre le pull request dal tuo account. Ogni commit dalla chat AI indica te come autore ebase44-builder[bot] come coautore.
Aprire una pull request
Dopo aver testato le modifiche, apri una pull request per la revisione. La pull request punta al branch da cui è stato creato il tuo branch di lavoro. La chat AI scrive il titolo e la descrizione a partire dalla conversazione e dalle modifiche salvate. Dopo che l’hai aperta, le nuove modifiche sul tuo branch di lavoro vengono aggiunte alla pull request e GitHub esegue i controlli configurati nel repository. Uniscila su GitHub, oppure chiedi alla chat AI di unirla. Create pull request elenca i file modificati dal tuo branch. Mostra solo le modifiche salvate con commit e inviate con push. Per escludere un file dalla pull request, annulla le modifiche al file prima di continuare.
Controllare il diff di un file
- Apri il tuo branch in Base Code.
- Clicca Create PR nell’editor dell’app.
- Clicca ogni file modificato in Create pull request per controllarne il diff.
- Clicca Continue in builder.
- Controlla e invia il messaggio precompilato nella chat AI.
Seguire il tuo lavoro
Vedi a che punto è ciascuna delle tue attività, dalle modifiche che Base Code sta ancora facendo alle pull request che stanno andando online. Your work nella schermata iniziale di Base Code divide le tue attività in colonne:- Base Code is working: l’AI sta ancora facendo modifiche.
- Needs you: Base Code ha una domanda, oppure la pull request ha conflitti, controlli non superati o modifiche richieste.
- Ready for review: il lavoro è finito e niente lo blocca.
- Done: attività unite, con risposta e archiviate.
- Vai su Base Code.
- In Your work, scegli cosa vuoi fare:
- Aprire un’attività: cliccala per aprirne il branch.
- Fare il passo successivo: clicca l’azione su un’attività, come Fix conflicts o Merge.
- Trovare un’attività: cercala per titolo in Search your work.
- Filtrare le attività: usa i filtri per tipo, stato e periodo. Ad esempio, filtra per Has a question o Failed checks.
- Ordinare le attività: seleziona Last updated o Date created.
- Vedere tutte le pull request: clicca See all pull requests per aprire le pull request del repository su GitHub.
Risolvere i conflitti tra branch
Se la tua pull request ha conflitti, la chat AI può risolverli per te. Risolvere i conflitti unisce il branch base della pull request nel tuo branch di lavoro. Per risolvere i conflitti:- Apri il tuo branch in Base Code.
- Clicca Resolve conflicts sopra la casella del prompt.
- Controlla e testa le modifiche dell’AI, soprattutto dove entrambi i branch hanno modificato la stessa funzionalità.
Rispondere ai commenti di revisione
Chiedi alla chat AI di gestire i thread di revisione non risolti sulla tua pull request. Risponde a ogni thread con ciò che ha cambiato. Dopo aver fatto il push delle modifiche, risolve i thread che ha corretto. Per rispondere ai commenti di revisione:- Apri il tuo branch in Base Code.
-
Chiedi alla chat AI di correggere i commenti sulla tua pull request. Ad esempio:
- Controlla le modifiche e le risposte riportate dalla chat AI.
Collaborare con i compagni di team
Il tuo team può contribuire allo stesso progetto e revisionare le modifiche degli altri tramite pull request.Chi può unirsi senza un invito:
- Membri del workspace: se un progetto Base Code consente ai membri del workspace di collaborare, chiunque nel tuo workspace può aprirlo nell’editor dell’app e unirsi senza un invito separato.
- Ospiti del workspace: gli ospiti hanno comunque bisogno di un invito.
- Persone fuori dal tuo workspace: per invitarle, aggiungile come collaboratori dall’editor dell’app.
Aggiungere secret
Dai al tuo progetto le chiavi API e le altre credenziali di cui ha bisogno senza inserirle nel repository. La chat AI te lo chiede quando serve un secret. I secret sono crittografati, condivisi tra i branch e conservati quando l’ambiente viene ricostruito. Le modifiche e le rimozioni si applicano automaticamente ai branch in esecuzione. I branch inattivi le recepiscono la prossima volta che li apri. Per aggiungere un secret:- Clicca Dashboard nell’editor dell’app.
- Clicca Secrets.
- Clicca Add Secret.
- Inserisci Secret Name e Secret Value, poi clicca Add Secret.
Gestire le organizzazioni GitHub
Le organizzazioni collegate appartengono al tuo workspace, quindi le app continuano a sincronizzarsi anche se chi ne ha collegata una se ne va. Chiunque nel workspace può usare un’organizzazione già collegata. L’impostazione Choose how your team writes to GitHub in questa pagina non si applica alle app Base Code, che usano sempre connessioni per utente. Per aggiungere un’organizzazione GitHub:- Vai alle impostazioni del workspace.
- Clicca GitHub in Build tools.
- Clicca Add organization in Connected organizations.
- Accedi a GitHub se richiesto, poi autorizza Base44 Builder.
- Scegli l’account o l’organizzazione, poi installa Base44 Builder. Se non sei proprietario dell’organizzazione GitHub, GitHub invia la tua richiesta ai proprietari dell’organizzazione. Dopo che un proprietario l’ha approvata, clicca di nuovo Add organization.
- Vai alle impostazioni del workspace.
- Clicca GitHub in Build tools.
- Scegli cosa vuoi fare:
- Filtrare le organizzazioni: usa il filtro in Connected organizations per mostrare le organizzazioni All, Active o Disconnected.
- Rendere disponibile un’organizzazione per le nuove app: proprietari e admin possono usare Allowed per controllare quali organizzazioni sono disponibili. Cambiare Allowed non influisce sulle app che usano già quell’organizzazione.
- Scollegare un’organizzazione: clicca l’icona Actions accanto all’organizzazione, clicca Disconnect organization, poi clicca Disconnect. Le app legate alla connessione del workspace di quell’organizzazione smettono di sincronizzarsi con GitHub, e la conferma le elenca. Base44 Builder resta installato su GitHub, quindi puoi ricollegare l’organizzazione in seguito.
Domande frequenti
Dove posso trovare informazioni su privacy e uso dei dati?
Dove posso trovare informazioni su privacy e uso dei dati?
La Privacy Policy di Base44 spiega come vengono raccolte e usate le informazioni personali. Privacy e sicurezza tratta l’addestramento dei modelli AI e i controlli sui tuoi dati.
Come applico un codice coupon?
Come applico un codice coupon?
Puoi applicare un coupon prima o dopo aver collegato un repository.Ogni codice coupon vale per un massimo di 10 persone nel tuo workspace.Per applicare un coupon:
- Vai su Base Code.
- Inserisci il tuo codice coupon:
- Prima di collegare un repository: clicca Have a coupon? in alto a destra, poi inserisci il codice nella finestra di dialogo.
- Dopo aver collegato un repository: inserisci il codice nel campo sotto Have a coupon?.
- Clicca Apply.
Questa pagina è stata tradotta con l’AI. Per le informazioni più accurate e aggiornate, consulta la versione inglese.