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

# VS Code-Erweiterung

> Installiere die Square Cloud-Erweiterung für VS Code, verbinde dein Konto und folge dem Walkthrough „Erste Schritte“.

Mit der Square Cloud-Erweiterung kannst du deine Anwendungen, Datenbanken und Workspaces deployen, verwalten und überwachen, ohne VS Code zu verlassen.

<Frame>
  <img src="https://raw.githubusercontent.com/squarecloudofc/vscode-extension/main/resources/readme/overview.png" alt="Die Square Cloud-Seitenleiste in VS Code mit allen Anwendungen, ihrem Live-Status und ihrer Auslastung" />
</Frame>

* **Verbindung im Browser:** Bestätigung mit einem achtstelligen Code, ganz ohne Schlüssel zum Kopieren oder Einfügen.
* **Alle Anwendungen auf einen Blick:** Live-Status, CPU und RAM, Starten, Stoppen, Neustarten und Logs mit einem Klick.
* **Deploy aus dem Editor:** Lade eine neue Anwendung hoch oder sende einen Commit an eine bestehende, wobei die Regeln deiner [`squarecloud.ignore`](/de/getting-started/squarecloud-ignore) angewendet werden.
* **Der komplette Werkzeugkasten:** Echtzeit-Logs, 24h-Metriken, Snapshots, Umgebungsvariablen, GitHub-Deploys, Edge-Analytics, Datenbanken und Workspaces.
* **Eine Konfigurationsdatei, die sich selbst prüft:** Autovervollständigung, Validierung und Schnellkorrekturen für [`squarecloud.app`](/de/getting-started/config-file).

## Installieren

<Steps>
  <Step title="Erweiterung installieren">
    Installiere **Square Cloud** aus dem [VS Marketplace](https://marketplace.visualstudio.com/items?itemName=squarecloud.squarecloud) oder aus [Open VSX](https://open-vsx.org/extension/squarecloud/squarecloud) in Editoren, die Open VSX nutzen, etwa VSCodium und Cursor. Du kannst auch in der Erweiterungsansicht nach "Square Cloud" suchen.
  </Step>

  <Step title="Konto verbinden">
    Klicke in der Aktivitätsleiste auf das **Square Cloud**-Symbol und dann auf **Konto verbinden**, oder führe `Square Cloud: Konto verbinden` über die Befehlspalette aus (`Ctrl+Shift+P` / `Cmd+Shift+P`).
  </Step>

  <Step title="Im Browser bestätigen">
    Die Seitenleiste zeigt einen achtstelligen Code an und kopiert ihn in deine Zwischenablage. Füge ihn auf der Bestätigungsseite ein, die sich in deinem Browser öffnet, und bestätige.
  </Step>

  <Step title="Fertig">
    Die Seitenleiste bestätigt, welches Konto du verbunden hast, und lädt dann deine Anwendungen, Datenbanken und Workspaces.
  </Step>
</Steps>

<Warning>Gib niemals einen Code ein, den dir jemand geschickt hat. Ein Code gehört nur dann auf die Bestätigungsseite, wenn dein eigenes VS Code ihn anzeigt: Wenn du den Code einer anderen Person bestätigst, verbindest du deren Editor mit deinem Konto.</Warning>

<Frame>
  <img src="https://raw.githubusercontent.com/squarecloudofc/vscode-extension/main/resources/readme/connect.png" alt="Verbinden in drei Schritten: VS Code zeigt einen Code an, du fügst ihn auf der Bestätigungsseite ein und bestätigst, und VS Code ist verbunden" />
</Frame>

VS Code erhält eine eigene Autorisierung: beschränkt auf das, was die Erweiterung nutzt, **90 Tage** gültig und jederzeit widerrufbar unter **Mein Konto → Authentifizierung** im [Dashboard](https://squarecloud.app/de/account/security). Dein Passwort läuft nie über VS Code. Wenn die Autorisierung abläuft, fordert dich die Erweiterung auf, dich erneut zu verbinden.

**Andere Möglichkeiten zum Verbinden** nimmt einen im Dashboard erstellten API-Schlüssel entgegen, zum Beispiel auf einem Rechner ohne Browser. In beiden Fällen werden die Zugangsdaten über den Secret Storage von VS Code im Schlüsselbund des Betriebssystems gespeichert, nie im Klartext auf der Festplatte. Das Verbinden oder Trennen in einem VS Code-Fenster gilt für alle geöffneten Fenster.

## Walkthrough „Erste Schritte“

`Square Cloud: Erste Schritte` öffnet einen geführten Walkthrough auf der Willkommensseite von VS Code. Er öffnet sich von selbst, wenn die Erweiterung zum ersten Mal ohne verbundenes Konto läuft, und ist außerdem in der Anmeldeansicht und im `...`-Menü der Seitenleiste verlinkt.

Jeder Schritt erklärt eine Idee in einfachen Worten, mit einer animierten Illustration und Schaltflächen, die den echten Befehl ausführen:

1. **Konto verbinden**
2. **Anwendung in `squarecloud.app` beschreiben**
3. **Anwendung hochladen**
4. **Starten, stoppen und neu starten**
5. **Logs und Metriken verfolgen**
6. **Mit Snapshots sichern**
7. **Datenbank erstellen**
8. **Im Team arbeiten** mit Workspaces
9. **Deploy bei jedem git push** mit der GitHub App
10. **Traffic verstehen** mit Edge-Analytics

Die Schritte haken sich von selbst ab, sobald du die Funktionen nutzt.

## Sprachen

Die Erweiterung spricht die acht Sprachen der Square Cloud-Website: Englisch, Portugiesisch, Spanisch, Deutsch, Französisch, Italienisch, Japanisch und Chinesisch. Sie folgt der Anzeigesprache von VS Code, und Links zur Website öffnen sich in derselben Sprache.

## Voraussetzungen

* **VS Code 1.125** oder neuer.
* **Ein Square Cloud-Konto.** Einige Funktionen (Datenbanken, Workspaces, Edge-Analytics, die Verknüpfung mit der GitHub App und die Snapshot-Liste) erfordern einen kostenpflichtigen Plan; die Erweiterung weist darauf hin, wenn dein Plan eine Aktion nicht enthält.

## Datenschutz

* Die Erweiterung kommuniziert nur mit Square Cloud, über das offizielle [JavaScript-SDK](/de/sdks/js/client). Es gibt keine Telemetrie und keinen Drittanbieterdienst.
* Wenn du eine Datenbank erstellst, wird ihre Verbindungs-URL einmalig in deine Zwischenablage kopiert, das Passwort nur über **Passwort kopieren**. Die Erweiterung speichert keines von beiden.

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="Funktionen" icon="grid-2" href="/de/vscode-extension/features">
    Deploys sowie die Verwaltung von Anwendungen, Datenbanken und Workspaces über die Seitenleiste.
  </Card>

  <Card title="Befehle und Einstellungen" icon="terminal" href="/de/vscode-extension/commands">
    Alle Befehle, die Einstellungen und Lösungen für häufige Probleme.
  </Card>
</CardGroup>
