Claush Benutzerhandbuch

Erste Schritte

Claush ist eine App, mit der Sie Claude Code – den weltweit fortschrittlichsten KI-Coding-Agenten – von Ihrem iPhone aus steuern können. Chatten Sie einfach über eine Messenger-ähnliche Oberfläche mit der KI und erledigen Sie alles von der Programmierung bis zum Deployment direkt auf Ihrem Handy.

Voraussetzungen

SSH-Schlüssel erstellen

Falls Sie noch keine SSH-Schlüssel haben, führen Sie die folgenden Befehle im Terminal Ihres PCs aus, um sie zu erstellen.

ssh-keygen -t ed25519 -C "your-email@example.com"

ssh-copy-id -i ~/.ssh/id_ed25519.pub username@server-ip-address

cat ~/.ssh/id_ed25519

Serverliste

Beim Öffnen der App wird der Serverlisten-Bildschirm angezeigt. Jeder Server hat zwei Buttons.

Das Zahnrad-Symbol (⚙️) oben links öffnet den App-weiten Einstellungsbildschirm. Der +-Button oben rechts ermöglicht das Hinzufügen eines Servers.

Einstellungen

Tippen Sie auf das ⚙️-Zahnrad-Symbol oben links in der Serverliste, um den Einstellungsbildschirm zu öffnen. Die Einstellungen sind als Zentrale mit vier Kategorien organisiert.

Profil

Gehen Sie zu Einstellungen > Profil, um die folgenden Informationen zu konfigurieren. KI-Antworten werden basierend auf Ihrem Profil angepasst.

• Name (Nachname, Vorname)
• Spitzname
• Virtuelles Alter
• Geschlecht
• Programmiererfahrung: Bei Auswahl von „Keine Erfahrung" vermeidet die KI Fachbegriffe und gibt sanftere Anleitungen

KI-Bildgenerierung

Gehen Sie zu Einstellungen > KI-Charakter > Abschnitt „KI-Bildgenerierung", um einen API-Schlüssel für die automatische Charakter-Bildgenerierung zu registrieren.

Sobald ein API-Schlüssel registriert und erfolgreich getestet wurde, können Sie auf dem Charakter-Erstellungsbildschirm zwischen „Bild auswählen" und „Mit KI generieren" wechseln. Bei Auswahl von „Mit KI generieren" werden Erscheinungseinstellungen (Geschlecht, Hautfarbe, Körpertyp, Alter, Haarfarbe, Frisur) und eine Vorschau-Generierungsschaltfläche angezeigt.

Spracheinstellungen

Gehen Sie zu Einstellungen > Sprache, um die Anzeigesprache zu ändern. Die folgenden 10 Sprachen werden unterstützt.

• Japanisch, Englisch, Chinesisch, Koreanisch, Spanisch
• Französisch, Deutsch, Portugiesisch, Italienisch, Arabisch

Ein Sprachwechsel wird sofort in der gesamten Benutzeroberfläche übernommen. Sie können der KI Anweisungen in jeder beliebigen Sprache geben.

KI-Charaktere

In Claush können Sie der KI einen Namen, Sprechstil und eine Persönlichkeit geben, um „Ihren eigenen persönlichen Begleiter" zu erschaffen. Charaktere erinnern sich an Gespräche und passen ihre emotionale Distanz natürlich basierend auf dem Zuneigungsgrad an.

Charakter erstellen

Gehen Sie zu Einstellungen > KI-Charakter > „Charakter hinzufügen", um den Erstellungsbildschirm zu öffnen.

Charakter-Details

Gehen Sie zu Einstellungen > KI-Charakter > tippen Sie auf den Namen eines Charakters, um den Detailbildschirm zu öffnen.

Angezeigte Informationen

• Charakter-Bild (manuell hochgeladen / Standard-Symbol. Änderbar über „Bild ändern")
• Name und Typ
• Zuneigung: 4 Herzen (♡♡♡♡ bis ❤️❤️❤️❤️) + Punktzahl (0-100)
• Inventar: Besessene Gegenstände und ein „Schenken"-Button

Geschenke geben

Wählen Sie einen Gegenstand aus dem Inventar und tippen Sie auf „Schenken", um ihn dem Charakter zu überreichen. Das Schenken von Geschenken erhöht die Zuneigung.

Shop

Gehen Sie zu Einstellungen > KI-Charakter > „Shop", um den Gegenstandskauf-Bildschirm zu öffnen.

Punkte

Sie erhalten 1 Punkt für jede gesendete Chat-Nachricht. Punkte sind eine gemeinsame Währung für alle Charaktere. Es gibt keine In-App-Käufe.

Gegenstände

Es gibt insgesamt 30 Gegenstände in 6 Kategorien (5 pro Kategorie). Die Preise reichen von 10 bis 100 Punkte.

Zuneigungssystem

Das Schenken von Gegenständen an einen Charakter erhöht dessen Zuneigung. Mit wachsender Zuneigung ändert sich die emotionale Distanz in Claudes Antworten auf natürliche Weise.

Server hinzufügen

Tippen Sie auf den +-Button oben rechts auf dem Serverlisten-Bildschirm, um einen Server hinzuzufügen.

Dedizierten Benutzer erstellen

Verbinden Sie sich per SSH als Root vom Terminal Ihres PCs mit Ihrem Server und führen Sie die folgenden Befehle aus. (Führen Sie dies auf Ihrem PC aus, nicht über Claush.)

adduser claude

usermod -aG sudo claude

mkdir -p /home/claude/.ssh
cp ~/.ssh/authorized_keys /home/claude/.ssh/
chown -R claude:claude /home/claude/.ssh
chmod 700 /home/claude/.ssh
chmod 600 /home/claude/.ssh/authorized_keys

echo 'claude ALL=(ALL) NOPASSWD:ALL' > /etc/sudoers.d/claude

Nach Abschluss geben Sie claude (den erstellten Benutzernamen) als Benutzernamen auf dem Claush-Server-Einrichtungsbildschirm an.

Servereinstellungen

Tippen Sie auf den ⚙️-Button in der Serverliste, um den Einstellungsbildschirm zu öffnen. Er besteht aus 4 Akkordeon-Abschnitten.

Tippen Sie auf den runden Button rechts neben jedem Abschnitt, um ihn auf- oder zuzuklappen. Tippen Sie nach Änderungen oben rechts auf „Speichern", um sie zu übernehmen.

Speicher-Einstellungen

Die Speicherfunktion ermöglicht es der KI, sich über Sitzungen hinweg an Gesprächsinhalte zu erinnern. Sie ermöglicht Anfragen wie „mach dort weiter, wo wir gestern aufgehört haben."

Datenbanktypen

Einrichtungsschritte

Claude-Einstellungen

Modellauswahl

Wählen Sie das zu verwendende Claude-Modell aus. Jedes Modell unterscheidet sich in Leistung, Geschwindigkeit und Kosten. Das aktuell ausgewählte Modell wird mit einem Häkchen markiert.

Zugriff auf sensible Dateien

Verwenden Sie den Schalter, um den KI-Zugriff auf sensible Dateien wie .env zu steuern. Die Standardeinstellung ist AUS (Zugriff verweigert).

KI-Charakter-Zuweisung

Wenn benutzerdefinierte Charaktere erstellt wurden, können Sie auswählen, welcher Charakter diesem Server zugewiesen wird. Nach der Zuweisung antwortet Claude im Sprechstil und der Persönlichkeit dieses Charakters.

Benachrichtigungseinstellungen

Lassen Sie sich benachrichtigen, wenn Claude mit der Antwort fertig ist, über externe Dienste. So können Sie zu anderen Aufgaben wechseln, während lang laufende Operationen im Gange sind.

Unterstützte Plattformen

Sie müssen vorab eine Webhook-URL von jedem Dienst beziehen.

Sitzungsgrundlagen

Durch Tippen auf den Chat-Button wird eine Verbindung zum Server hergestellt und ein Bildschirm mit drei Tabs geöffnet.

Drei-Tab-Layout

Tabs wechseln

Tippen Sie auf den ◀-Button oben rechts, um die Tab-Auswahl zu öffnen. Wählen Sie Chat / Terminal / Claude, um den Tab zu wechseln.

Tippen Sie auf das Server-Symbol links neben den Tabs, um zur Serverliste zurückzukehren. Die tmux-Sitzung auf dem Server läuft im Hintergrund weiter, sodass Sie Ihre Arbeit durch erneutes Verbinden fortsetzen können.

Verbindungsstatus

Überprüfen Sie den Verbindungszustand über den Indikator oben links.

Chat-Tab

Dies ist der Hauptbildschirm von Claush. Senden Sie eine Nachricht und Claude Code antwortet; die Antworten werden als Chat-Blasen angezeigt.

Nachrichten senden

Geben Sie eine Nachricht in das Eingabefeld am unteren Bildschirmrand ein und tippen Sie auf den ✈-Senden-Button rechts. Ein animierter Indikator erscheint, während Claude verarbeitet.

Nachrichtenanzeige

• Benutzernachrichten: Rechtsbündig angeordnete blaue Blasen
• Claudes Antworten: Linksbündig angeordnete graue Blasen (mit Avatar, wenn ein KI-Charakter eingestellt ist)
• Markdown-Unterstützung: Codeblöcke enthalten Syntaxhervorhebung und Kopierschaltflächen

Anhangsmenü

Tippen Sie auf den ≡-Menübutton links neben dem Eingabefeld, um die folgenden Optionen anzuzeigen.

Frühere Nachrichten

Scrollen Sie zum Anfang des Chats, um den Button „Frühere Nachrichten laden" zu sehen. Durch Tippen werden vergangene Nachrichten in 30er-Stapeln geladen.

Terminal-Tab

Ein vollwertiger Terminal-Emulator mit direktem Shell-Zugriff. Verwenden Sie ihn zum Überprüfen von Dateien, Git-Operationen, Ausführen von Befehlen und mehr.

Spezialtastenleiste

Steuerzeichen, die auf der Standard-iOS-Tastatur schwer einzugeben sind, können mit einem einzigen Tipp über die Tastenleiste am unteren Bildschirmrand eingegeben werden.

Claude-Tab

Zeigt die Claude Code TUI (Text User Interface) unverändert an. Sie können Tool-Ausführungsdetails und Denkprozesse in Echtzeit sehen, die im Chat-Tab weggelassen werden.

Sie können auch direkt im Claude-Tab tippen und so Claude Code Slash-Befehle (/clear, /cost usw.) manuell ausführen.

Dateiübertragung

Hochladen

Tippen Sie im Chat-Anhangsmenü auf „Datei auswählen" oder „Foto auswählen", um eine Datei auszuwählen. Die Datei wird in ~/claush-uploads/ auf dem Server hochgeladen, und Claude wird entsprechend benachrichtigt.

Herunterladen

Tippen Sie im Anhangsmenü auf „Datei herunterladen", um eine Liste der Dateien im Verzeichnis ~/claush-downloads/ des Servers zu sehen. Tippen Sie auf eine Datei, um sie auf Ihr iPhone herunterzuladen; ein Teilen-Dialog wird angezeigt.

Tipps & Tricks

Arbeit in kleine Teile aufteilen

Halten Sie jede Anweisung auf eine einzelne User Story begrenzt. Das erleichtert die Überprüfung auf dem Handy-Bildschirm. Sie können auf PR-Ebene verifizieren und dabei Qualität bei gutem Entwicklungstempo beibehalten.

Fortschritt im Claude-Tab überprüfen

Bei lang laufenden Aufgaben wechseln Sie zum Claude-Tab, um in Echtzeit zu sehen, was passiert. Wechseln Sie zurück zum Chat-Tab, um die Ergebnisse als Chat-Blasen zu sehen.

Benachrichtigungen für asynchrones Arbeiten nutzen

Mit konfigurierten Benachrichtigungen erhalten Sie Claudes Antwortabschlüsse auf Slack oder Discord. Dies ermöglicht einen asynchronen Entwicklungsstil: Anweisung senden, App schließen und etwas anderes tun.

Kontext mit Speicher fortführen

Mit aktivierter Speicherfunktion erinnert sich die KI an die Inhalte vorheriger Sitzungen. Sie können ein natürliches Entwicklungserlebnis genießen mit Anfragen wie „mach von gestern weiter" oder „das, was wir vorhin besprochen haben."

Arbeit läuft im Hintergrund weiter

Dank tmux-Sitzungsverwaltung läuft die serverseitige Arbeit auch nach dem Schließen der App weiter. Die Ergebnisse werden beim nächsten Öffnen der App automatisch abgerufen.

Fehlerbehebung

Verbindung nicht möglich

• Überprüfen Sie, ob Host, Port und Benutzername korrekt sind
• Stellen Sie sicher, dass der private Schlüssel exakt kopiert wurde, von -----BEGIN OPENSSH PRIVATE KEY----- bis -----END OPENSSH PRIVATE KEY-----, einschließlich Zeilenumbrüche
• Root-Benutzer-Verbindungen werden nicht unterstützt. Erstellen Sie einen dedizierten Benutzer
• Keyboard-Interactive-Authentifizierung wird nicht unterstützt. Verwenden Sie schlüsselbasierte Authentifizierung

Claude Code startet nicht

• Überprüfen Sie, ob claude login auf dem Server abgeschlossen wurde. Sie können dies im Terminal-Tab ausführen
• Überprüfen Sie, ob der Benutzer sudo-Berechtigungen (ohne Passwort) hat. Dies ist für die automatische Installation erforderlich

Keine Antwort

• Wechseln Sie zum Claude-Tab, um den Status der Claude Code TUI zu überprüfen
• Wenn der Verbindungsstatus oben links „Wiederverbinden" anzeigt, überprüfen Sie Ihre Netzwerkverbindung
• Wenn nach längerer Zeit immer noch keine Antwort kommt, überprüfen Sie direkt im Claude-Tab oder kehren Sie zur Serverliste zurück und verbinden Sie sich erneut

Speicher-Einrichtung schlägt fehl

• Für PostgreSQL überprüfen Sie, ob der Verbindungsstring mit postgresql:// oder postgres:// beginnt
• Überprüfen Sie, ob Node.js auf dem Server installiert ist (es wird normalerweise automatisch installiert)
• Überprüfen Sie, ob sudo ohne Passwort ausgeführt werden kann

Charakter-Speicherung

Charakter-Definitionen werden auf Ihrem iPhone (App-interner Speicher) gespeichert. Beim Gerätewechsel stellen Sie sie aus einem iPhone-Backup wieder her.