Kostenlos testen

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.
Verbrauch einplanen: Abgerechnet werden beim Pseudonymisierer die übermittelten Zeichen je Anfrage. AlphaDesktop überträgt mit jeder Anfrage die Anweisungen an das Modell und den gesamten Verlauf der Unterhaltung – schon die erste Nachricht umfasst rund 100.000 Zeichen. Das Kontingent des Testzugangs ist damit nach der ersten Anfrage aufgebraucht. Den Verbrauch sehen Sie im Konto; für den Einsatz mit AlphaDesktop stimmen wir das Kontingent mit Ihnen ab: info@alpha-digital.de.

Installation

Die Pakete sind in der Beta-Phase noch nicht signiert. Das Betriebssystem fragt deshalb beim ersten Start nach.

macOS

  1. Die DMG-Datei öffnen und AlphaDesktop in den Ordner „Programme“ ziehen.
  2. Im Ordner „Programme“ mit der rechten Maustaste auf AlphaDesktop klicken und Öffnen wählen, im folgenden Dialog nochmals „Öffnen“.
  3. 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

  1. Den Installer starten. Meldet Windows „Der Computer wurde durch Windows geschützt“, auf Weitere Informationen und dann auf Trotzdem ausführen klicken.
  2. 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“.

  1. 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.

  2. 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:

    ModusIhre EingabenGelesene Dateien und Werkzeugergebnisse
    Auto (ab Werk)volle ErkennungMuster (E-Mail, Telefon, IBAN, Kennungen) und Namen, die die Unterhaltung schon kennt. Neue Namen bleiben im Klartext.
    Vollvolle Erkennungvolle Erkennung, auch für neue Namen. Langsamer.
    Schnellnur Muster und bekannte Namennur 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.
  3. 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.

  4. 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:

    EinstellungVerhalten
    Bei jedem heiklen Werkzeug nachfragen (ab Werk)Vor Dateiänderungen und Befehlen erscheint eine Rückfrage.
    Dateiänderungen automatisch, Rest nachfragenDateien ändert die KI ohne Rückfrage, Befehle bestätigen Sie.
    Alles automatischKeine Rückfragen. Nur für Ordner, deren Inhalt Sie wiederherstellen können.
    Nur planen, nichts ausführenDie KI beschreibt ihr Vorgehen und ändert nichts.

    „Max. Runden je Anfrage“ und „Budget je Anfrage“ begrenzen lange Läufe.

Arbeiten im Chat

  1. Auf + Neue Unterhaltung klicken. Oben rechts zeigt der Knopf mit dem Ordnersymbol den Arbeitsordner; ein Klick wählt einen anderen.
  2. 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.eml und lege sie als Textdatei ab.“
  3. 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.
  4. ■ 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

InhaltIm Datenschutz-Modus
Ihre Eingaben im Chatpseudonymisiert
Gelesene Textdateien, Befehlsausgaben, Ergebnisse der Konnektorenpseudonymisiert, Gründlichkeit je nach Erkennungsmodus
PDF- und Word-Dateiennur als Text: Das Werkzeug dokument_text liest sie lokal aus, der Text wird pseudonymisiert
Bilder, Bildschirmfotos, andere Office-Dateiengesperrt – sie lassen sich nicht pseudonymisieren
Antworten, geschriebene Dateien, ausgeführte Befehlekommen 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.

VorlageWofü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-ServerBeliebige Server per Startbefehl oder Adresse, zum Beispiel die Browser-Brücke AlphaChrome.
Microsoft 365, SISTRIX, Google Search Console, Screaming Frog, AhrefsGerü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 BeobachtungUrsache 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 401Der Schlüssel des Pseudonymisierers ist falsch oder wurde im Konto erneuert.
Antwort 402Der Haken „Eigenen Anthropic-Schlüssel mitschicken“ fehlt – oder der Testzeitraum ist abgelaufen; dann im Konto einen Tarif wählen.
Antwort 429Monatskontingent 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 langeDie 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 nichtVorlagen mit npx brauchen Node.js auf dem Rechner. Server in JavaScript starten Sie mit dem Platzhalter {{node}} über die mitgelieferte Laufzeit.
Windows: Befehle schlagen fehlGit 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

Fragen zur Einrichtung beantworten wir unter info@alpha-digital.de. Technische Einzelheiten zu allen Schnittstellen stehen in der Dokumentation.