> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Collega un progetto backend esistente

> Configura ed esegui codice di progetti backend Base44 esistenti, come le app di esempio

Puoi collegare codice di progetti backend Base44 esistenti, come quello di un'[app di esempio](https://github.com/base44/apps-examples), a un backend su Base44. Usa questa opzione quando hai già in locale i file di un progetto backend Base44.

Se non hai ancora alcun file di progetto, usa [`base44 create`](/developers/references/cli/commands/create) per generare un nuovo progetto.

<Note>
  * Questa guida serve a collegare codice di progetti backend Base44 esistenti, come app di esempio o progetti condivisi dai membri del team. Se hai creato un'app con l'[editor di app Base44](https://base44.com) e vuoi svilupparla in locale, configura l'[integrazione GitHub](/developers/app-code/local-development/github) per la sincronizzazione continua, oppure usa [`base44 eject`](/developers/backend/overview/start-from-existing-app) per una copia locale una tantum.
  * La CLI richiede Node.js 20.19.0 o superiore.
</Note>

## Comprendere il codice locale rispetto ai progetti backend

Quando lavori con Base44, ci sono due componenti separati:

* **Codice locale:** i file di progetto sul tuo computer, come il codice frontend, gli schemi delle entità e le funzioni backend.
* **Progetto backend Base44:** l'infrastruttura backend sui server di Base44, tra cui il database, gli endpoint, l'hosting e così via.

Il collegamento connette il tuo codice locale a un progetto backend in modo che la tua app possa usare l'infrastruttura di Base44. Durante il processo di collegamento, scegli una delle due opzioni:

* **Crea un nuovo progetto:** crea un backend nuovo su Base44 per il tuo codice. Scegli questa opzione se stai configurando questo codice per la prima volta.
* **Collega a un progetto esistente:** si connette a un backend già esistente su Base44. Scegli questa opzione se ti stai ricollegando a un backend configurato in precedenza o se ti stai unendo a un progetto di team in cui il backend è già stato creato.

## Collegare un progetto

<Steps>
  <Step title="Ottieni il codice del progetto">
    Clona un'app di esempio o scarica il codice di un progetto esistente, quindi vai nella directory del progetto.

    Il progetto deve già contenere una cartella `base44/` con un file `config.jsonc`.
  </Step>

  <Step title="Installa le dipendenze">
    Installa le dipendenze del progetto:

    ```bash theme={null}
    npm install
    ```
  </Step>

  <Step title="Installa la CLI di Base44">
    Installa la CLI di Base44 a livello globale:

    ```bash theme={null}
    npm install -g base44@latest
    ```
  </Step>

  <Step title="Autenticati">
    Accedi al tuo account Base44:

    ```bash theme={null}
    base44 login
    ```

    La CLI genera un codice dispositivo. Apri l'URL fornito, inserisci il codice e completa l'autenticazione nel browser.
  </Step>

  <Step title="Collega il progetto">
    Collega il tuo progetto locale a un backend Base44:

    ```bash theme={null}
    base44 link
    ```

    La CLI ti chiederà se creare un nuovo progetto backend o collegarti a uno esistente. Questo crea un file `.app.jsonc` nella tua directory `base44/` con l'ID della tua app:

    ```jsonc theme={null}
    {
      "id": "your-app-id"
    }
    ```

    <Warning>
      Il file `.app.jsonc` non deve mai essere sottoposto a versionamento. Viene aggiunto automaticamente a `.gitignore` ed è specifico per ogni sviluppatore e ambiente di distribuzione.
    </Warning>
  </Step>

  <Step title="Configura le variabili d'ambiente (se necessarie)">
    L'ID della tua app è richiesto durante la configurazione di un client SDK. I progetti in genere memorizzano l'ID dell'app in una variabile d'ambiente e lo recuperano per creare un client. Consulta la documentazione o i file di configurazione del progetto per istruzioni su come impostare le variabili d'ambiente richieste.
  </Step>

  <Step title="Compila il frontend se il progetto ne ha uno">
    Se il tuo progetto include un frontend, compilalo in modo che sia pronto per essere distribuito nel passaggio successivo.
  </Step>

  <Step title="Invia le risorse">
    Sincronizza le risorse del tuo progetto con il tuo backend Base44:

    ```bash theme={null}
    base44 deploy
    ```

    Questo invia entità, funzioni e il sito se il tuo progetto ne ha uno.

    Se il tuo progetto ha agenti, invia anche quelli:

    ```bash theme={null}
    base44 agents push
    ```
  </Step>
</Steps>

## Passaggi successivi

Ora che il tuo progetto è configurato e in esecuzione, puoi:

* Usare l'[SDK](/developers/references/sdk/getting-started/overview) per aggiungere più funzionalità al tuo frontend, se il progetto ne ha uno.
* Aggiungere [entità](/developers/backend/resources/entities/overview), [funzioni backend](/developers/backend/resources/backend-functions/overview) e [agenti](/developers/backend/resources/agents-config).
* Continuare a sviluppare e distribuire aggiornamenti con [`base44 deploy`](/developers/references/cli/commands/deploy).

## Vedi anche

* [Riferimento comandi CLI](/developers/references/cli/commands/introduction): tutti i comandi CLI disponibili
* [Struttura del progetto](/developers/backend/overview/project-structure): come sono organizzati i file di progetto
* [Documentazione JavaScript SDK](/developers/references/sdk/getting-started/overview): collega la tua app al backend
* [Skill Base44](/developers/backend/overview/base44-skills): insegna agli assistenti IA a lavorare con Base44
* [Repository di app di esempio](https://github.com/base44/apps-examples): progetti di esempio da cui imparare

<Note>Questa pagina è stata tradotta utilizzando l'IA. Per informazioni più accurate e aggiornate, consulta la [versione inglese](/). </Note>