> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/devops/devops-de/code/devops-cli/flosum-devops-cli-erweiterung-installieren.md).

# Flosum DevOps-CLI-Erweiterung installieren

{% hint style="warning" %}

#### Bekannte Probleme: Erforderliches Update

**Ein Update ist erforderlich.** Die aktuelle Version von Flosum DevOps erfordert die neuesten Versionen der Flosum CLI (**@flosum/cli** Paket) und der **Flosum DevOps-CLI-Erweiterung**. Frühere CLI-Versionen unterstützen keine Topologien und können nicht mit einem DevOps-Tenant arbeiten, der sie verwendet, daher müssen vorhandene Installationen aktualisiert werden.

**Node.js 22 ist erforderlich.** Bei **Node.js 24**, scheinen die Installations- und Aktualisierungsbefehle zwar erfolgreich zu sein, belassen Sie jedoch auf einer früheren Version. Wechseln Sie vor der Installation oder Aktualisierung zu Node.js 22.
{% endhint %}

{% hint style="success" %}

#### Kompatibilität mit Betriebssystemen

**Flosum CLI** und **Flosum DevOps-CLI-Erweiterung** sind mit den folgenden Betriebssystemen kompatibel:

* **macOS**
* **Linux**

Diese Tools sind derzeit nicht für die Verwendung mit Windows vorgesehen.
{% endhint %}

## ![](https://578823411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FG5ZbxX918xOHwbAwAJ4n%2FSummary2-Small-Icon.svg?alt=media\&token=da26a67f-ff7f-47b3-8669-06be960dc2d7) Übersicht

Dieser Artikel erklärt, wie Sie die Flosum DevOps-CLI-Erweiterung für Visual Studio Code (VS Code) installieren. Die Erweiterung hilft Ihnen bei der Arbeit an DevOps-Projekten, indem sie über eine einfach zu bedienende Oberfläche direkten Zugriff auf Flosum-CLI-Befehle in VS Code bietet. Weitere Informationen zur DevOps-CLI und ihrer Verwendung finden Sie in den folgenden Artikeln.

* [Überblick über DevOps CLI in VS Code](/devops/devops-de/code/devops-cli/uberblick-uber-devops-cli-in-vs-code.md)
* [DevOps CLI in VS Code verwenden](/devops/devops-de/code/devops-cli/devops-cli-in-vs-code-verwenden.md)

Die Erweiterung führt die Flosum CLI aus, die separat installiert wird. Installieren Sie zuerst die Flosum CLI und dann die Erweiterung.

* [Flosum CLI Node.js-Paket installieren](/devops/devops-de/code/devops-cli/flosum-cli-node.js-paket-installieren.md)

## Voraussetzungen

{% stepper %}
{% step %}

### Flosum CLI

Die Flosum CLI muss installiert sein, bevor die Erweiterung verwendet werden kann. Sie hat ihre eigenen Voraussetzungen, darunter eine bestimmte Version von Node.js und eine C++-Build-Toolchain.

1. Führen Sie die im folgenden Artikel beschriebene Installation vollständig durch.
2. Bestätigen Sie, dass `flosum --version` eine Versionsnummer zurückgibt, und notieren Sie sie.

{% hint style="info" %}
Vollständige Anweisungen, Voraussetzungen und Fehlerbehebung für die CLI finden Sie in einem separaten Artikel.

* [Flosum CLI Node.js-Paket installieren](/devops/devops-de/code/devops-cli/flosum-cli-node.js-paket-installieren.md)
  {% endhint %}
  {% endstep %}

{% step %}

### Visual Studio Code

1. Bestätigen Sie, dass Sie **Visual Studio Code** Version **1.106.0** oder höher verwenden.
2. Wählen Sie **Hilfe > Nach Updates suchen** und installieren Sie alle verfügbaren Updates, bevor Sie fortfahren.
   {% endstep %}
   {% endstepper %}

## DevOps-CLI-Erweiterung installieren

{% stepper %}
{% step %}

### Flosum DevOps-CLI-Erweiterung installieren

1. Starten Sie VS Code.
2. Öffnen Sie die Erweiterungsansicht, indem Sie das **Erweiterungen** Symbol in der Aktivitätsleiste auswählen.
3. In das **Suchfeld** geben Sie **Flosum DevOps-CLI-Erweiterung**.

   <div align="left"><figure><img src="https://578823411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FjGR5xDyis5ezBylmvu49%2FInstallDevopsCli-S02-01.png?alt=media&amp;token=9f2911e4-f88b-4890-8bc5-1cf1e61f2a73" alt="" width="563"><figcaption></figcaption></figure></div>
4. Klicken Sie auf **Installieren** für die **Flosum DevOps-CLI-Erweiterung**.

   <div align="left"><figure><img src="https://578823411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FWw29sPdfHaWWqmyfwPXi%2FInstallDevopsCli-S02-02.png?alt=media&amp;token=5e02bec5-932c-4e71-96db-62088bec11df" alt="" width="563"><figcaption></figcaption></figure></div>
5. Klicken Sie auf **Herausgeber vertrauen und installieren** zum Bestätigen.

   <div align="left"><figure><img src="https://578823411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FMEithibOC6Vlb6T2MK18%2FInstallDevopsCli-S02-03.png?alt=media&amp;token=281575f9-9a20-4b0f-9f75-157e843808c2" alt="" width="563"><figcaption></figcaption></figure></div>
6. Wenn die Flosum DevOps-CLI-Erweiterung erfolgreich installiert wurde, sehen Sie die **Flosum** Startschaltfläche der Befehlspalette auf der linken Seite der VS Code **Statusleiste**.&#x20;

   <div align="left"><figure><img src="https://578823411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FFDHpUxPYj3GCxrHvuaME%2FInstallDevopsCli-S02-04.png?alt=media&amp;token=cdbdbe71-40cc-43c3-9c74-2977691da516" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}

#### Flosum-Befehlspalette

Um auf die **Flosum-Befehlspalette**, stellen Sie sicher, dass die **Statusleiste** in VS Code sichtbar ist. Steuern Sie ihre Sichtbarkeit über **Ansicht** > **Darstellung** > **Statusleiste**.
{% endhint %}
{% endstep %}

{% step %}

### Überprüfen Sie, dass beide aktuell sind

1. In das **Erweiterungen** Ansicht und bestätigen Sie, dass die **Flosum DevOps-CLI-Erweiterung** keine verfügbaren Updates anzeigt.
2. Vergleichen Sie in einem Terminal die installierte Flosum CLI mit der zuletzt veröffentlichten Version:

   ```
   flosum --version
   npm view @flosum/cli version
   ```

{% hint style="warning" %}

#### Starten Sie Visual Studio Code neu, wenn flosum nicht gefunden wird

Wenn das Terminal meldet, dass `flosum` nicht gefunden wurde, schließen Sie **Visual Studio Code** es vollständig, öffnen Sie es erneut und versuchen Sie es dann noch einmal. Das Öffnen eines neuen Terminal-Tabs funktioniert nicht, weil **Visual Studio Code** nur Ihre **PATH** beim Start liest.
{% endhint %}

{% hint style="warning" %}

#### Halten Sie beide aktuell, vergleichen Sie ihre Versionen jedoch nicht miteinander

Die Erweiterung und die Flosum CLI werden unabhängig voneinander versioniert. Ihre Versionsnummern sind nicht gleich und sollen nicht übereinstimmen. Prüfen Sie daher jede einzelne anhand ihrer eigenen Quelle und nicht im Vergleich zueinander.

Die Flosum CLI aktualisiert sich nicht selbst und veraltet daher, während sich die Erweiterung automatisch über Visual Studio Code aktualisiert. Eine veraltete CLI wird meist dadurch verursacht, dass sie mit einer anderen Node.js-Version als 22 installiert wurde, wodurch eine ältere Version ohne Fehlermeldung installiert wird. Ältere Versionen unterstützen das aktuelle Flosum DevOps nicht und funktionieren nicht.
{% endhint %}
{% endstep %}
{% endstepper %}

## Fehlerbehebung

<details>

<summary>Der Flosum-Launcher erscheint nicht in der Statusleiste</summary>

1. Wählen Sie **Ansicht > Darstellung > Statusleiste** und bestätigen Sie, dass die **Statusleiste** aktiviert ist.
2. In das **Erweiterungen** Ansicht und bestätigen Sie, dass **Flosum DevOps-CLI-Erweiterung** installiert und aktiviert ist.
3. Laden Sie das Fenster neu, indem Sie **Entwickler: Fenster neu laden** in der Befehlspalette auswählen.

</details>

<details>

<summary>Die Flosum CLI ist eine ältere Version als die veröffentlichte</summary>

Die Erweiterung und die CLI werden unabhängig voneinander versioniert, daher ist ein Unterschied zwischen ihren Versionsnummern zu erwarten und kein Problem. Vergleichen Sie die CLI stattdessen mit der veröffentlichten Version:

```
flosum --version
npm view @flosum/cli version
```

Wenn `flosum --version` die niedrigere Nummer meldet, ist die CLI veraltet.

1. Führen Sie `node --version` aus und bestätigen Sie, dass **v22.x**.
2. Wenn nicht, installieren Sie **Node.js 22** wie im CLI-Artikel beschrieben.
3. Entfernen Sie die vorhandene CLI, installieren Sie sie erneut und vergleichen Sie dann die beiden Befehle erneut.

{% hint style="info" %}
Das Installieren der CLI unter **Node.js 24** installiert stillschweigend eine ältere Version, ohne einen Fehler zu melden. Das ist der häufigste Grund dafür, dass die CLI veraltet.

* [Flosum CLI Node.js-Paket installieren](/devops/devops-de/code/devops-cli/flosum-cli-node.js-paket-installieren.md)
  {% endhint %}

</details>

<details>

<summary>Befehle der Erweiterung schlagen fehl, obwohl die Erweiterung installiert ist</summary>

Die Erweiterung führt die Flosum CLI aus, daher zeigt sich ein Problem mit der CLI als fehlschlagender Befehl der Erweiterung.

1. Öffnen Sie ein Terminal in **Visual Studio Code** und führen Sie `flosum --version`.
2. Wenn der Befehl nicht gefunden wird, schließen Sie **Visual Studio Code** es vollständig, öffnen Sie es erneut und führen Sie den Befehl noch einmal aus. Das behebt das Problem in den meisten Fällen, da der Editor nur **PATH** Änderungen beim Start übernimmt.
3. Wenn der Befehl immer noch nicht gefunden wird, öffnen Sie ein Terminal außerhalb von **Visual Studio Code** und führen Sie denselben Befehl aus. Eine Versionsnummer dort bedeutet, dass der Editor mit einer veralteten Umgebung ausgeführt wird. Keine Versionsnummer bedeutet, dass die CLI nicht korrekt installiert ist.
4. Wenn der Befehl ein fehlendes Modul meldet, wurde die Installation der CLI nicht abgeschlossen. Befolgen Sie die Schritte zur Fehlerbehebung im CLI-Artikel.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.flosum.com/devops/devops-de/code/devops-cli/flosum-devops-cli-erweiterung-installieren.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.