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

> Verknüpft ein bestehendes lokales Base44-Projekt mit einer Base44-App in der Cloud. Verwende dies, wenn du eine base44/config.jsonc hast, sie aber noch nicht mit einer Base44-App verbunden hast.

<Warning>
  Diese Seite ist Teil eines KI-Coding-Agent-Skills und für Agenten geschrieben, nicht für Menschen. Für die menschenlesbare Base44-Dokumentation siehe die [Entwicklerdokumentation](/developers).
</Warning>

# base44 link

Verknüpft ein bestehendes lokales Base44-Projekt mit einer Base44-App in der Cloud. Verwende dies, wenn du eine `base44/config.jsonc` hast, sie aber noch nicht mit einer Base44-App verbunden hast.

## Kritisch: Wann Link vs Create verwenden

| Szenario                                                | Befehl                            |
| ------------------------------------------------------- | --------------------------------- |
| Von vorne beginnen, kein `base44/`-Ordner               | `npx base44 create`               |
| `base44/config.jsonc` vorhanden, aber kein `.app.jsonc` | `npx base44 link`                 |
| Projekt bereits verknüpft (hat `.app.jsonc`)            | Schon erledigt, verwende `deploy` |

## Syntax

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

## Optionen

| Option                            | Beschreibung                                                                                    | Erforderlich   |
| --------------------------------- | ----------------------------------------------------------------------------------------------- | -------------- |
| `-c, --create`                    | Ein neues Projekt erstellen (Auswahlprompt überspringen)                                        | Nein           |
| `-n, --name <name>`               | Projektname (erforderlich bei `--create`)                                                       | Mit `--create` |
| `-d, --description <description>` | Projektbeschreibung                                                                             | Nein           |
| `--app-id <id>`                   | App-ID zur Verknüpfung mit einem bestehenden Projekt (globales Flag, überspringt Auswahlprompt) | Nein           |

## Nicht-interaktiver Modus

Für CI/CD oder Agent-Nutzung:

**Ein neues Projekt erstellen:**

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

**Mit einer bestehenden App verknüpfen:**

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

FALSCH: `npx base44 link --create` (fehlendes --name)
FALSCH: `npx base44 link --create --app-id <id>` (kann nicht beides verwenden)
RICHTIG: `npx base44 link --create --name my-app`
RICHTIG: `npx base44 link --app-id <id>`

## Beispiele

```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
```

## Was der Befehl tut

1. Findet die `base44/config.jsonc` im aktuellen Verzeichnis (oder in Elternverzeichnissen)
2. Prüft, dass keine `.app.jsonc` existiert (Projekt noch nicht verknüpft)
3. Entweder:
   * Erstellt eine neue Base44-App in der Cloud (mit `--create`) ODER
   * Verknüpft mit einer bestehenden App (mit `--app-id` oder interaktiver Auswahl)
4. Schreibt die App-ID in `base44/.app.jsonc`

## Voraussetzungen

* Muss `base44/config.jsonc` im Projekt haben
* Darf KEINE `base44/.app.jsonc` haben (verwende `deploy`, wenn bereits verknüpft)
* Muss authentifiziert sein (führe zuerst `npx base44 login` aus)

## Hinweise

* Nach dem Verknüpfen kannst du Ressourcen mit `npx base44 deploy` deployen
* Die Datei `.app.jsonc` sollte in `.gitignore` stehen (enthält deine App-ID)

<Note>Diese Seite wurde mit KI übersetzt. Für die genauesten und aktuellsten Informationen siehe die [englische Version](/). </Note>