Startseite › Anleitungen › AlphaDesktop einrichten und verwenden
Beta macOS und Windows Version 0.1.0
AlphaDesktop einrichten und verwenden
AlphaDesktop ist eine eigene Desktop-Anwendung für Chat und Agenten. Sie beschreiben eine Aufgabe, die KI sortiert Dateien, wertet Dokumente aus, bearbeitet Code und nutzt Ihre Konnektoren. Im Datenschutz-Modus läuft jede Anfrage an das Cloud-Modell über den Pseudonymisierer: Das Modell arbeitet mit Ersatzdaten, in Ihrem Chat und in Ihren Dateien stehen die echten Werte.
Die Anleitung beschreibt Version 0.1.0 (Beta). Eine Fassung für Macs mit Intel-Prozessor folgt.
Voraussetzungen
- Rechner: Mac mit Apple Silicon und macOS 12 oder neuer, oder Windows 10/11 (64 Bit).
- Konto beim Pseudonymisierer mit API-Schlüssel: Testzugang erstellen oder im Konto unter „API-Schlüssel“ nachsehen.
- API-Schlüssel der Anthropic Console. AlphaDesktop arbeitet mit Claude-Modellen über die Anthropic-API; die Nutzung der Modelle rechnen Sie direkt mit Anthropic ab. Ein Claude-Abonnement (Pro, Max, Team) ersetzt den API-Schlüssel nicht.
- Nur Windows: Git for Windows, wenn die KI Befehle ausführen soll. AlphaDesktop findet die mitgelieferte Git Bash von selbst.
Installation
Die Pakete sind in der Beta-Phase noch nicht signiert. Das Betriebssystem fragt deshalb beim ersten Start nach.
macOS
- Die DMG-Datei öffnen und AlphaDesktop in den Ordner „Programme“ ziehen.
- Im Ordner „Programme“ mit der rechten Maustaste auf AlphaDesktop klicken und Öffnen wählen, im folgenden Dialog nochmals „Öffnen“.
- Ab macOS 15 gibt es diesen Weg nicht mehr: AlphaDesktop einmal per Doppelklick starten, die Meldung schließen, dann Systemeinstellungen → Datenschutz & Sicherheit öffnen und bei AlphaDesktop „Dennoch öffnen“ wählen.
Windows
- Den Installer starten. Meldet Windows „Der Computer wurde durch Windows geschützt“, auf Weitere Informationen und dann auf Trotzdem ausführen klicken.
- Installationsordner bestätigen. AlphaDesktop wird für Ihr Benutzerkonto eingerichtet, Administratorrechte sind nicht nötig.
Einrichtung in vier Schritten
Die Einstellungen öffnen Sie unten links über ⚙︎ Einstellungen. Jede Seite hat einen eigenen Knopf „Speichern“.
Schlüssel hinterlegen
Reiter Schlüssel: den API-Schlüssel des Pseudonymisierers unter „Pseudonymisierer“ einfügen und speichern, ebenso den Schlüssel der Anthropic Console. Neben dem Feld steht danach „hinterlegt“. AlphaDesktop speichert die Schlüssel verschlüsselt; den Schlüssel dazu verwaltet der Schlüsselbund des Betriebssystems.
Datenschutz-Modus prüfen
Reiter Datenschutz: Der Haken „Alle Modellanfragen über den Pseudonymisierer leiten“ ist ab Werk gesetzt, die Adresse lautet
https://pseudonymisierer.de. Setzen Sie zusätzlich den Haken „Eigenen Anthropic-Schlüssel mitschicken“ – der Pseudonymisierer ruft das Modell dann mit Ihrem Schlüssel auf.Beim Erkennungsmodus entscheiden Sie, wie gründlich gelesene Dateien geprüft werden:
Modus Ihre Eingaben Gelesene Dateien und Werkzeugergebnisse Auto (ab Werk) volle Erkennung Muster (E-Mail, Telefon, IBAN, Kennungen) und Namen, die die Unterhaltung schon kennt. Neue Namen bleiben im Klartext. Voll volle Erkennung volle Erkennung, auch für neue Namen. Langsamer. Schnell nur Muster und bekannte Namen nur Muster und bekannte Namen Empfehlung: Arbeitet die KI mit Dateien, in denen Namen von Kunden, Mitarbeitenden oder Patienten stehen, stellen Sie den Erkennungsmodus auf Voll.Ordner freigeben
Reiter Ordner: Wählen Sie den Standardordner, in dem neue Unterhaltungen beginnen, und fügen Sie bei Bedarf weitere Ordner hinzu. Das Modell liest und ändert Dateien nur in diesen Ordnern. Geben Sie einen Arbeitsordner frei, nicht den ganzen Benutzerordner.
Modell und Rückfragen wählen
Reiter Modell: Ab Werk arbeitet AlphaDesktop mit Claude Opus 5 und der Intelligenzstufe „Hoch“. Unter Werkzeug-Rückfragen legen Sie fest, wann die KI vor einer Aktion fragt:
Einstellung Verhalten Bei jedem heiklen Werkzeug nachfragen (ab Werk) Vor Dateiänderungen und Befehlen erscheint eine Rückfrage. Dateiänderungen automatisch, Rest nachfragen Dateien ändert die KI ohne Rückfrage, Befehle bestätigen Sie. Alles automatisch Keine Rückfragen. Nur für Ordner, deren Inhalt Sie wiederherstellen können. Nur planen, nichts ausführen Die KI beschreibt ihr Vorgehen und ändert nichts. „Max. Runden je Anfrage“ und „Budget je Anfrage“ begrenzen lange Läufe.
Arbeiten im Chat
- Auf + Neue Unterhaltung klicken. Oben rechts zeigt der Knopf mit dem Ordnersymbol den Arbeitsordner; ein Klick wählt einen anderen.
- Die Aufgabe beschreiben und mit der Eingabetaste senden (Umschalt + Eingabe für eine neue Zeile), zum Beispiel:
- „Sortiere die Dateien im Arbeitsordner nach Kunde und Jahr in Unterordner.“
- „Fasse alle PDF-Rechnungen im Ordner in einer Tabelle zusammen.“
- „Schreibe Frau Schmidt eine Antwort auf die Mail in
anfrage.emlund lege sie als Textdatei ab.“
- Fragt die KI „Darf das Werkzeug … ausgeführt werden?“, zeigt AlphaDesktop die geplante Aktion. Mit Erlauben läuft sie einmal, mit Für diese Sitzung immer ohne weitere Rückfrage in dieser Unterhaltung, mit Ablehnen gar nicht.
- ■ Stopp bricht einen Lauf ab. Die Unterhaltung bleibt erhalten und lässt sich fortsetzen.
Oben links zeigt AlphaDesktop den Zustand: Pseudonymisiert bedeutet, dass alle Modellanfragen über den Pseudonymisierer laufen. Steht dort Klartext, ist der Datenschutz-Modus ausgeschaltet.
Was das Modell sieht
| Inhalt | Im Datenschutz-Modus |
|---|---|
| Ihre Eingaben im Chat | pseudonymisiert |
| Gelesene Textdateien, Befehlsausgaben, Ergebnisse der Konnektoren | pseudonymisiert, Gründlichkeit je nach Erkennungsmodus |
| PDF- und Word-Dateien | nur als Text: Das Werkzeug dokument_text liest sie lokal aus, der Text wird pseudonymisiert |
| Bilder, Bildschirmfotos, andere Office-Dateien | gesperrt – sie lassen sich nicht pseudonymisieren |
| Antworten, geschriebene Dateien, ausgeführte Befehle | kommen mit den echten Werten bei Ihnen an |
Jede Unterhaltung führt eine eigene Sitzung beim Pseudonymisierer. Sie finden sie im Konto unter „Sitzungen“ und können sie dort löschen; ohne Nutzung läuft sie nach sieben Tagen ab. Fehlerberichte und Nutzungsstatistik an den Hersteller des Modells sind in AlphaDesktop abgeschaltet.
Konnektoren anbinden
Konnektoren geben der KI weitere Werkzeuge. Im Reiter Konnektoren wählen Sie unter „Hinzufügen“ eine Vorlage, prüfen die Angaben, klicken auf Verbindung testen und danach auf „Übernehmen und speichern“. Der Test nennt die Zahl der gefundenen Werkzeuge.
| Vorlage | Wofür |
|---|---|
| Pseudonymisierer (pseudonymisierer.de) | Texte und Dateien gezielt pseudonymisieren und personifizieren. Braucht keine weiteren Angaben. |
| Pseudonymisierer Desktop-Erweiterung (lokal) | Outlook-Postfach und OneDrive. Das Paket der Desktop-Erweiterung (macOS, Windows) entpacken und den Ordner angeben. Angaben aus Postfach und Ablage erscheinen im Chat mit Ersatzdaten; die echten Werte setzt die Erweiterung ein, wenn sie Mails verschiebt oder Antwortentwürfe anlegt. |
| Eigener MCP-Server | Beliebige Server per Startbefehl oder Adresse, zum Beispiel die Browser-Brücke AlphaChrome. |
| Microsoft 365, SISTRIX, Google Search Console, Screaming Frog, Ahrefs | Gerüste mit dem Hinweis „Vorlage – Angaben prüfen“: Startbefehl oder Adresse ergänzen Sie nach der Dokumentation des Anbieters. |
Unter „Import aus Claude Desktop“ fügen Sie den Inhalt einer claude_desktop_config.json ein; AlphaDesktop übernimmt die dort eingetragenen Server. Auch die Ergebnisse der Konnektoren laufen im Datenschutz-Modus durch den Pseudonymisierer.
Einsatz im Team: Admin-Passwort
Ohne Admin-Passwort kann jede Person an diesem Rechner Schlüssel und Konnektoren ändern. Im Reiter Schlüssel setzen Sie unter „Admin-Passwort“ ein Passwort mit mindestens sechs Zeichen. Die Reiter „Schlüssel“ und „Konnektoren“ öffnen sich danach nur noch mit diesem Passwort. Nach dem Setzen oder Entsperren bleibt der Bereich 20 Minuten offen; „Jetzt sperren“ schließt ihn sofort. Modell, Ordner und Datenschutz-Modus bleiben ohne Passwort einstellbar – prüfen Sie diese Einstellungen auf gemeinsam genutzten Rechnern regelmäßig.
Wenn etwas nicht klappt
| Meldung oder Beobachtung | Ursache und Abhilfe |
|---|---|
| „Kein Pseudonymisierer-Schlüssel hinterlegt“ | Schlüssel im Reiter „Schlüssel“ eintragen und speichern. |
| „Cloud-Schlüssel soll mitgeschickt werden, aber kein Anthropic-Schlüssel ist hinterlegt“ | Schlüssel der Anthropic Console im Reiter „Schlüssel“ eintragen. |
Antwort 401 | Der Schlüssel des Pseudonymisierers ist falsch oder wurde im Konto erneuert. |
Antwort 402 | Der Haken „Eigenen Anthropic-Schlüssel mitschicken“ fehlt – oder der Testzeitraum ist abgelaufen; dann im Konto einen Tarif wählen. |
Antwort 429 | Monatskontingent oder Aufrufe je Minute sind erreicht. Agenten schicken in jeder Runde den ganzen Verlauf; lange Unterhaltungen verbrauchen deshalb viele Zeichen. Eine neue Unterhaltung beginnt wieder klein. |
| Die erste Antwort einer Unterhaltung dauert lange | Die Anweisungen der Anwendung an das Modell werden einmal vollständig geprüft. Folgerunden sind schneller. Reicht die Zeit nicht, im Reiter „Datenschutz“ die „Wartezeit auf Antworten“ erhöhen. |
| Ein Konnektor startet nicht | Vorlagen mit npx brauchen Node.js auf dem Rechner. Server in JavaScript starten Sie mit dem Platzhalter {{node}} über die mitgelieferte Laufzeit. |
| Windows: Befehle schlagen fehl | Git for Windows installieren und AlphaDesktop neu starten. |
Das Protokoll liegt im Datenordner der Anwendung unter logs/alphadesktop.log. Den Ordner öffnet der Knopf „Datenordner zeigen“ im Reiter Info.
Grenzen der Beta
- AlphaDesktop arbeitet nur mit Claude-Modellen über die Anthropic-API.
- Bilder kann das Modell nicht auswerten – auch nicht, wenn sie keine personenbezogenen Daten zeigen.
- Erkennung ist nie vollständig. Namen, die das Modell in keinem Fall sehen darf, tragen Sie im Konto unter „Klartext-Regeln“ in die Sperrliste ein. Welche Angaben eine Sitzung ersetzt hat, liefert die Schnittstelle
GET /api/sitzungen/{id}?mit_originalen=true(Dokumentation). - Unterhaltungen speichert AlphaDesktop lokal mit den echten Werten. Schützen Sie den Rechner wie jeden Arbeitsplatz mit Kundendaten.
Weitere Anleitungen
- Claude Desktop über den Pseudonymisierer verwenden
- AlphaChrome für Chrome einrichten und verwenden
- Desktop-Erweiterung für macOS einrichten und verwenden
- Desktop-Erweiterung für Windows einrichten und verwenden
Fragen zur Einrichtung beantworten wir unter info@alpha-digital.de. Technische Einzelheiten zu allen Schnittstellen stehen in der Dokumentation.