⚙️Einstellungen und Schlüssel

Alles lässt sich in den Einstellungen konfigurieren; du musst keine Dateien bearbeiten.

Wenn du hier die Zeitzone änderst, ändert sich die Uhr des Servers nicht: Führe zusätzlich timedatectl set-timezone <Zone> && systemctl restart cron aus, damit geplante Jobs ihr folgen (siehe Crons).

Die App installieren

Harness Maxxing lässt sich wie eine App installieren (eigenes Fenster, ein Symbol im Dock, in der Taskleiste oder auf dem Home-Bildschirm, Vollbild auf dem Handy). Zwei Orte: App installieren im Kontomenü (das Personensymbol unten in der Seitenleiste; auf dem Handy im ⊞-Menü) und Einstellungen -> Allgemein -> App.

• Chrome, Edge (Computer oder Android): ein Klick, wenn der Browser es anbietet; sonst zeigt der Button die Schritte (das Installationssymbol am Ende der Adressleiste oder das Browsermenü).
• Safari auf einem Mac (macOS 14 oder neuer): Ablage -> Zum Dock hinzufügen.
• iPhone / iPad: Teilen-Button von Safari -> Zum Home-Bildschirm.
• Firefox kann auf einem Computer keine Web-Apps installieren: Nutze Chrome, Edge oder Safari.
• Die App-Karte zeigt einen QR-Code der Adresse: Scanne ihn mit dem Handy, melde dich an und füge sie dann zum Home-Bildschirm hinzu.
• Für die Installation braucht es die https-Adresse (Zugriff über eine Domain). Über Tailscale (http://100.x.y.z:8787) bieten Browser sie nicht an.

Auf einem Handy oder Tablet

Handys und Tablets bekommen das Touch-Layout (Einstellungen -> Allgemein -> Layout ändert es pro Gerät): keine Seitenleiste, keine Leiste unten, die Unterhaltung füllt den Bildschirm. Zwei Buttons befinden sich oben auf jedem Bildschirm: - ☰ (oben links) öffnet deine Sitzungen - siehe Sitzungen. Sein Zähler zeigt die ungelesenen Antworten. - ⊞ (oben rechts) öffnet alles andere: ein Suchfeld (dasselbe wie ⌘K), jede Seite (Dashboard, Sitzungen, Dateien, Aufgaben, Crons, Benachrichtigungen, Git und Infra, wenn aktiviert, Erweiterungen und angeheftete Seiten), das wartende Update, den Zustand des Servers, die Nutzung deines Claude-Tarifs, das Design, den Präsentationsmodus, die Einstellungen, Hilfe (Tour, Tutorial, Doku) und Abmelden. Ein Punkt auf ⊞ bedeutet, dass ein Update wartet oder der Server Aufmerksamkeit braucht.

Außerdem: - In der installierten App wischst du vom linken Rand, um die Sitzungen zu öffnen, und vom rechten Rand, um das Menü zu öffnen; wische eine Schublade zurück zu ihrem Rand, um sie zu schließen. - Panels, die von unten hochfahren, schließt du mit einem Wisch nach unten (an ihrem Griff, ihrem Titel oder ihrem Inhalt, wenn er ganz oben ist) oder mit einem Tipp auf den abgedunkelten Bereich darüber. - Die Buttons für Mikrofon und Senden sind größer; während du tippst, bleiben Panels über der Tastatur. - Die Seite zoomt nicht (kein Pinch, kein Doppeltippen), wie eine native App; Felder lassen das iPhone nie hineinzoomen.

Claude-Authentifizierung

Drei Wege, der beste zuerst: 1. Langlebiger Token: Führe claude setup-token auf einem beliebigen Computer mit Browser aus und füge den Token ein. 2. API-Schlüssel aus der Anthropic-Konsole (Abrechnung nach Nutzung). 3. CLI-Login auf dem Server (claude, dann /login): wird automatisch erkannt.

Test macht einen echten Aufruf mit einer Zeile und zeigt das Modell und die Latenz.

Durchgänge starten Claude ohne Update-Prüfung, Telemetrie und Feature-Flag-Download (schnellerer Start, kürzerer Prompt); "claude_quiet_start": false in config.json schaltet das ab.

Claude führt seine Hilfsagenten im Vordergrund aus: Du bekommst ihr Ergebnis im selben Durchgang (mehrere Agenten laufen weiterhin parallel). Claude Codes eigene Gewohnheit ist, sie in den Hintergrund zu schicken, wobei der Durchgang darauf wartet, dass sie sich zurückmelden, was langsamer ist; "background_agents": true in config.json stellt das wieder ein. Du kannst Claude in deiner Nachricht immer um einen Hintergrundagenten bitten.

Claude-Code-Updates

Claude Code automatisch aktualisieren (standardmäßig aus): Alle 6 Stunden sucht der Server nach einer neueren stabilen Claude-Code-Version (die Anthropic als stabil markiert: schon einige Tage im Einsatz, nicht die allerneueste). Wenn es eine gibt, installiert er diese Version selbst - aber nur, wenn nichts läuft: kein Unterhaltungsdurchgang, keine Nachricht in einer Warteschlange, kein geplanter Job und der letzte Durchgang endete vor mehr als 10 Minuten. Andernfalls wartet er und versucht es wenige Minuten später erneut, sodass ein Update nie einen Durchgang unterbricht, und ein Durchgang, der während des Updates startet, wartet darauf (die Unterhaltung sagt es; höchstens 7 Minuten). Nur der installierte Server tut das: Ein zweites Harness Maxxing, das auf derselben Maschine für Entwicklung oder Tests gestartet wird, aktualisiert nie das Claude Code der Maschine. Es funktioniert mit dem offiziellen Installer und mit einer globalen npm-Installation (andere Installationsarten werden in Ruhe gelassen). Wenn die neue Version nicht startet, wird die vorherige wiederhergestellt.

Jedes Update erscheint in den Benachrichtigungen („Claude Code auf 2.1.5 aktualisiert“), und der Schalter zeigt das letzte (2.1.4 -> 2.1.5 und sein Datum). Ein Fehler wird ebenfalls gemeldet, einmal pro Version, mit dem Grund; der Server versucht es 6 Stunden später erneut. Lass den Schalter aus, um von Hand zu aktualisieren (claude update in einem Terminal); maxxing doctor listet dann Claude Code unter claude_version auf, wenn es veraltet ist.

Berechtigungsmodus

Ein Thema kann seinen eigenen Modus haben (Sitzungsliste -> Themenmenü -> Berechtigungen), ebenso ein geplanter Claude-Job (Berechtigungsmodus im Job-Editor): Nutze einen strengeren Modus dort, wo Claude Inhalte von außen liest - Webseiten, E-Mails, weitergeleitete Nachrichten -, damit in diesen Inhalten versteckte Anweisungen ihn nicht beliebige Dinge tun lassen. Reihenfolge: der Modus des Jobs, sonst der des Themas, sonst dieser globale.

Geheimnisse schützen (standardmäßig an): In jedem Modus weigern sich die Werkzeuge von Claude, die Geheimnisse des Servers (secrets.json) und die SSH-Schlüssel (~/.ssh) zu lesen oder zu bearbeiten. Das verhindert, dass eine versteckte Anweisung sie einfach liest; ein absichtlich geschriebenes Skript, das die Datei öffnet, wird nicht gestoppt, es ersetzt also keinen strengeren Modus. Weitere Regeln: claude_deny in config.json (Regelsyntax von Claude Code, zum Beispiel "Bash(rm -rf:*)").

Siehe Sicherheit.

Schlüssel (Tresor für Geheimnisse)

Speichere API-Schlüssel und Tokens, die deine Projekte brauchen (zum Beispiel OPENAI_API_KEY, SHOP_TOKEN):

• Namen sind GROSSGESCHRIEBEN (A-Z, Ziffern, _), Werte sind verborgen und werden nur mit Anzeigen sichtbar;
• füge eine Notiz hinzu (wofür er gedacht ist, woher er stammt);
• Freigeben macht das Geheimnis als Umgebungsvariable für jede Claude-Sitzung und jeden Shell-Cron-Job verfügbar – praktisch für Skripte, und Claude muss den Wert nie in einem Chat sehen;
• einige Namen sind reserviert (Systemvariablen, Variablen, die Shells, Node, Python oder git Code laden lassen
• NODE_OPTIONS, BASH_ENV, GIT_SSH_COMMAND... -, ANTHROPIC_BASE_URL, alles, was mit MAXXING_ beginnt); ein vorhandener Schlüssel mit einem solchen Namen bleibt erhalten, wird aber nicht mehr freigegeben.

Aus Skripten und Sitzungen: maxxing keys list|get|set|delete (der Wert von set wird von stdin gelesen) - ein Skript, das einen Token erneuert, schreibt den neuen Wert auf diesem Weg zurück. Skripte lesen Schlüssel aus der Umgebung (os.environ["NAME"]), nie aus einer eigenen Datei.

Schreibe in Memory-Dateien nur den Namen des Schlüssels („Shop-API: Schlüssel SHOP_TOKEN“). Erweiterungen lesen Schlüssel mit ctx["secret"]("NAME").

Schlüssel liegen in /var/lib/claude-maxxing/secrets.json (Modus 600) und sind nicht im Backup enthalten.