> ## 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.

# base44 link

> Collega un progetto Base44 locale esistente a un'app Base44 nel cloud. Usa questo quando hai un base44/config.jsonc ma non l'hai ancora connesso a un'app Base44.

<Warning>
  Questa pagina fa parte di una skill per agenti IA di programmazione ed è scritta per gli agenti, non per gli umani. Per la documentazione Base44 leggibile dagli umani, consulta la [documentazione per sviluppatori](/developers).
</Warning>

# base44 link

Collega un progetto Base44 locale esistente a un'app Base44 nel cloud. Usa questo quando hai un `base44/config.jsonc` ma non l'hai ancora connesso a un'app Base44.

## Critico: quando usare Link vs Create

| Scenario                                         | Comando                 |
| ------------------------------------------------ | ----------------------- |
| Partenza da zero, nessuna cartella `base44/`     | `npx base44 create`     |
| Hai `base44/config.jsonc` ma nessun `.app.jsonc` | `npx base44 link`       |
| Progetto già collegato (ha `.app.jsonc`)         | Già fatto, usa `deploy` |

## Sintassi

```bash theme={null}
npx base44 link [options]
```

## Opzioni

| Opzione                           | Descrizione                                                                                       | Obbligatorio   |
| --------------------------------- | ------------------------------------------------------------------------------------------------- | -------------- |
| `-c, --create`                    | Crea un nuovo progetto (salta la richiesta di selezione)                                          | No             |
| `-n, --name <name>`               | Nome del progetto (richiesto quando viene usato `--create`)                                       | Con `--create` |
| `-d, --description <description>` | Descrizione del progetto                                                                          | No             |
| `--app-id <id>`                   | App ID a cui collegarsi per un progetto esistente (flag globale, salta la richiesta di selezione) | No             |

## Modalità non interattiva

Per uso in CI/CD o con agenti:

**Crea un nuovo progetto:**

```bash theme={null}
npx base44 link --create --name my-app
```

**Collega a un'app esistente:**

```bash theme={null}
npx base44 link --app-id <app-id>
```

SBAGLIATO: `npx base44 link --create` (manca --name)
SBAGLIATO: `npx base44 link --create --app-id <id>` (non si possono usare entrambi)
CORRETTO: `npx base44 link --create --name my-app`
CORRETTO: `npx base44 link --app-id <id>`

## Esempi

```bash theme={null}
# Interactive mode - prompts for project details
npx base44 link

# Non-interactive - create and link in one step
npx base44 link --create --name my-app

# With description
npx base44 link --create --name my-app --description "My awesome app"

# Link to a specific existing project by ID
npx base44 link --app-id abc123
```

## Cosa fa

1. Trova il `base44/config.jsonc` nella directory corrente (o nelle directory padre)
2. Verifica che non esista `.app.jsonc` (progetto non già collegato)
3. O:
   * Crea una nuova app Base44 nel cloud (con `--create`), OPPURE
   * Si collega a un'app esistente (con `--app-id` o selezione interattiva)
4. Scrive l'app ID in `base44/.app.jsonc`

## Requisiti

* Deve avere `base44/config.jsonc` nel progetto
* NON deve avere `base44/.app.jsonc` (usa `deploy` se già collegato)
* Devi essere autenticato (esegui prima `npx base44 login`)

## Note

* Dopo il collegamento, puoi distribuire le risorse con `npx base44 deploy`
* Il file `.app.jsonc` dovrebbe essere ignorato da git (contiene l'app ID)

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