> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/cli/de/anleitungen/understand/how-it-works.md).

# So funktioniert Devolutions CLI

Devolutions CLI ersetzt geheime Werte durch devo-Referenzen und löst sie aus Ihrem Workspace erst auf, wenn ein Befehl startet.

Devolutions CLI speichert Ihre Geheimnisse nicht. Es **zeigt auf sie**. Ihre Skripte, `.env`-Dateien und Agentenanweisungen enthalten eine Referenz `devo://`, und Devolutions CLI holt den Wert erst in dem Moment aus Ihrem Workspace, in dem ein Befehl ihn braucht. Diese eine Idee erklärt fast alles andere: was Sie sicher einchecken können, warum Sie sich einmal anmelden und welche Befehle ein Geheimnis verborgen halten.

## Vier Bausteine

<table><thead><tr><th width="190">BAUSTEIN</th><th>WAS ES IST</th><th>BEISPIEL</th></tr></thead><tbody><tr><td><strong>Workspace</strong></td><td>Wo Ihre Geheimnisse liegen: Devolutions Cloud, Devolutions Server oder ein lokales Profil von Devolutions Remote Desktop Manager. Darin liegen Geheimnisse in Feldern von Einträgen, gruppiert in Tresoren.</td><td>Das Feld <code>password</code> des Eintrags <em>Production database</em> im Tresor <em>Operations</em>.</td></tr><tr><td><strong>Kontext</strong></td><td>Eine gespeicherte Verbindung zu einem Workspace, mit einem Namen, den Sie wählen. Sie erstellen sie einmal mit <code>devo login</code>, und jeder Befehl danach verwendet den aktuellen Kontext.</td><td><code>my-cloud</code>, <code>work-server</code>, <code>my-local</code></td></tr><tr><td><strong>Referenz</strong></td><td>Die Adresse eines Felds, die mit <code>devo://</code> beginnt. Sie sagt, wo das Geheimnis ist, nie was es ist.</td><td><code>devo://&#x3C;workspace>/&#x3C;vault>/&#x3C;entry>/password</code></td></tr><tr><td><strong>Befehl</strong></td><td>Das Programm, das das Geheimnis braucht. <code>devo secret run</code> löst die Referenzen auf, gibt die Werte nur an dieses Programm und startet es.</td><td>Ein Bereitstellungsskript, ein Datenbankclient, ein KI-Agent.</td></tr></tbody></table>

## Was das für Sie bedeutet

**Referenzen können gefahrlos geteilt werden.** Eine Referenz enthält Namen oder IDs, keinen Wert. Sie können sie committen, in ein Ticket einfügen oder einem KI-Agenten geben. Ohne Zugriff auf den Tresor öffnet sie nichts. Siehe [Syntax der Geheimnisreferenz](/cli/de/referenz/secret-references.md).

**Sie melden sich einmal an und arbeiten dann.** `devo login` speichert den Kontext und macht ihn zum aktuellen, sodass spätere Befehle nicht erneut fragen. Um für einen einzelnen Befehl einen anderen Workspace zu verwenden, fügen Sie `--context <name>` hinzu. Siehe [Zwischen Workspaces wechseln](/cli/de/anleitungen/connect/switch-workspaces.md).

**Dieselben Befehle funktionieren überall.** Ein Geheimnis zu lesen oder einen Befehl auszuführen sieht auf Devolutions Cloud, Devolutions Server und einem lokalen Profil gleich aus. Wenn ein Workspace etwas nicht kann, sagt der Befehl das, statt still zu scheitern. Siehe [Workspace-Typen vergleichen](/cli/de/anleitungen/understand/workspace-types.md).

**Ein Geheimnis erreicht nur den Befehl, den Sie starten.** `devo secret run` setzt die Werte in die Umgebung genau dieses Programms, nicht in Ihre Shell. Devolutions CLI lehnt Referenzen ab, die als Befehlsargumente geschrieben sind, und verbirgt aufgelöste Werte in dem, was das Programm ausgibt. Siehe [Einen Befehl mit seinen Geheimnissen ausführen](/cli/de/anleitungen/secrets/run-with-secrets.md).

**Manche Befehle übergeben den Wert absichtlich.** Ein Geheimnis im Terminal zu lesen, eine Vorlagendatei zu füllen, Geheimnisse in Ihre aktuelle Shell zu laden oder einen KI-Client einen Eintrag lesen zu lassen, gibt Ihnen oder dem Modell den tatsächlichen Wert. Wählen Sie den Befehl, der dazu passt, wie viel Sie preisgeben wollen. Siehe [Was verborgen bleibt und was nicht](/cli/de/anleitungen/understand/security-model.md).

## Der Hintergrundprozess

Um schnell zu bleiben, startet `devo` beim ersten Befehl, der Ihren Workspace braucht, einen Hintergrundprozess und verwendet ihn danach wieder. Es ist dieselbe `devo`-Datei, die im Hintergrund unter Ihrem Benutzerkonto läuft und mit `devo` über einen lokalen Kanal auf Ihrem Computer spricht. Sie müssen keinen Dienst installieren und nichts selbst starten.

Wenn Sie ihn lieber selbst steuern, akzeptiert die Option `--daemon` `auto` (der Standard: bei Bedarf starten), `require` (einen verwenden, der schon läuft) oder `never`. Die Befehle `devo daemon` zeigen seinen Status, stoppen ihn oder starten ihn neu. Siehe [Der Hintergrundprozess startet nicht](/cli/de/hilfe/troubleshooting/daemon-wont-start.md).


---

# 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.devolutions.net/cli/de/anleitungen/understand/how-it-works.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.