--- title: Fehlerbehebung für die Archbee-CLI slug: docs/de/fehlerbehebung-fur-die-archbee-cli docTags: createdAt: 2026-08-25T09:37:14.629Z --- ## Fehlerbehebung für die Archbee CLI Diese Anleitung behandelt die häufigsten Probleme, auf die Benutzer bei der Arbeit mit der Archbee CLI stoßen. Verwenden Sie diese Schritte zur Fehlerbehebung, bevor Sie ein Support-Ticket eröffnen. Die meisten Probleme können durch Überprüfen Ihres Setups, Kontrollieren der Authentifizierung oder Prüfen der CLI-Befehlsoptionen behoben werden. :::::ExpandableHeading{isOpen="true"} ### CLI startet nicht **Problem** Das Ausführen von `archbee` schlägt fehl oder bewirkt nichts. **Empfohlene Schritte** ::::WorkflowBlock :::WorkflowBlockItem Führen Sie `Archbee-Version` aus, um zu überprüfen, ob die CLI installiert ist. ::: :::WorkflowBlockItem Installieren Sie die CLI global mit npm neu, falls der Befehl fehlt. ::: :::WorkflowBlockItem Starten Sie Ihre Terminalsitzung neu und versuchen Sie den Befehl erneut. ::: :::: **Installationsbefehl** ```bash npm install -g @archbee/cli ``` ::::: :::::ExpandableHeading ### Hot Reload funktioniert nicht **Problem** Änderungen werden in der lokalen Vorschau nicht aktualisiert. **Empfohlene Schritte** ::::WorkflowBlock :::WorkflowBlockItem Starten Sie den lokalen Entwicklungsserver mit `archbee Dev` neu. ::: :::WorkflowBlockItem Überprüfen Sie, ob Ihr Projekt eine unterstützte Konfigurationsdatei enthält. ::: :::WorkflowBlockItem Prüfen Sie, dass Ihr Dokumentationsordner nicht ignoriert oder ausgeschlossen wird. ::: :::: ::::: :::ExpandableHeading ### Defekte Links werden nicht erkannt Ausführen: ```bash archbee broken-links ``` Stellen Sie sicher, dass Ihre internen Links gültige relative Pfade verwenden. ::: :::ExpandableHeading ### OpenAPI-Synchronisierungsprobleme **Problem** `sync-openapi` schlägt während des Imports fehl. **Häufige Ursachen** - Ungültiges OpenAPI-Schema - Nicht unterstützte Referenzen - Falscher Dateipfad - Fehlende Authentifizierung **Empfohlener erster Schritt** Validieren Sie die OpenAPI-Datei vor der Synchronisierung. ::: :::ExpandableHeading ### Authentifizierungsfehler **401 Nicht autorisiert** Wird normalerweise verursacht durch: - Ungültiger API-Schlüssel - Abgelaufenes Token - Falsche Space-ID **403 Verboten** Wird normalerweise durch fehlende Berechtigungen oder einen schreibgeschützten Team-API-Schlüssel verursacht. ::: :::ExpandableHeading ### Probleme beim Veröffentlichen **Problem** `publish-space` schlägt fehl. **Lösung** Überprüfen Sie: - Sie verfügen über Schreibberechtigungen - Die Space-ID ist korrekt - Der API-Schlüssel gehört zur richtigen Organisation ::: :::::ExpandableHeading ### Empfohlener Debugging-Workflow ::::WorkflowBlock :::WorkflowBlockItem Führen Sie `archbee validieren` aus, um die Projektstruktur zu überprüfen. ::: :::WorkflowBlockItem Führen Sie `archbee defekte-links` aus, um interne Links zu scannen. ::: :::WorkflowBlockItem Verwenden Sie `archbee --help` , um die Befehlsverwendung und Argumente zu überprüfen. ::: :::: ::::: ## Zusätzliche Ressourcen - Hauptdokumentation: [https://archbee.com/docs](https://archbee.com/docs) - npm-Paket: [https://www.npmjs.com/package/@archbee/cli](https://www.npmjs.com/package/@archbee/cli) - CLI-Hilfe: `archbee --help`