Anleitung

Claude Code in Telegram mit Chatcode nutzen

Claude Code mit Browser-Terminal und Telegram-Anbindung von Chatcode auf deinem Server einrichten: Kompromisse bei Host, Relay, Zugangsdaten und nativem Plugin.

Chatcode bietet ein Browser-Terminal und eine Telegram-Ergänzung für Coding-Agent-Sessions, die auf einem Server laufen, den du kontrollierst. Diese Anleitung richtet Claude Code ein und benennt die Grenze, auf die es am meisten ankommt: Repository und Agent-Prozess bleiben auf deinem Host, aber die Steuerungsebene von Chatcode leitet lesbaren Terminal-Datenverkehr zwischen diesem Host, dem Browser und Telegram weiter.

Wenn du nur einen Telegram-Bot für eine einzelne laufende Claude-Session brauchst, ist das offizielle Channels-Plugin von Anthropic der einfachere Einstieg. Nutze diesen Workflow, wenn das vollwertige Browser-Terminal, ein dauerhaft laufender Host oder die Unterstützung mehrerer Agenten zu den Anforderungen gehören.

Woraus das Setup besteht

Browser / Telegram
        ↕
Chatcode control plane
        ↕ outbound TLS WebSocket
Your server + gateway
        ↕
Claude Code session

Für den normalen Chatcode-Datenverkehr braucht das Gateway keinen eingehenden Port. Es startet Agent-Sessions auf dem verbundenen Rechner und hält eine ausgehende Verbindung zur Steuerungsebene. SSH lohnt sich trotzdem als separater Weg für Administration und Wiederherstellung.

1. Den Host wählen

Es gibt zwei gängige Varianten:

  • Ein ständig laufender Linux-Server. Verbinde einen vorhandenen VPS oder lass dir über den DigitalOcean-Ablauf einen einrichten.
  • Ein Mac, den du ohnehin nutzt. Das erspart einen weiteren Server, aber die Verfügbarkeit hängt von Stromversorgung, Netzwerk und Anmeldestatus des Macs ab.

Die Linux-Installation legt einen eigenen Benutzer vibe an und verwendet /home/vibe/workspace. Unter macOS läuft das Gateway als dein aktueller Benutzer und verwendet ~/workspace, erbt also die Dateiberechtigungen dieses Benutzers. Lies nach, wie das Gateway funktioniert, bevor du entscheidest, welches Vertrauensmodell zum Host passt.

2. Das Gateway verbinden

Melde dich bei app.chatcode.dev an, füge einen Server hinzu und verwende den generierten Installationsbefehl. Er enthält eine Gateway-Kennung und ein Authentifizierungs-Token, also füge ihn nicht in ein öffentliches Issue, einen Chat oder eine Shell-Aufzeichnung ein.

Das Installationsprogramm richtet das Gateway als Hintergrunddienst ein. Sobald es in der App als online angezeigt wird, prüfe Host und Workspace-Pfad, bevor du eine Agent-Session öffnest.

3. Einen Workspace öffnen und Claude Code authentifizieren

Wähle ein Projektverzeichnis unter dem konfigurierten Workspace-Stammverzeichnis, lege eine Session an und wähle Claude Code. Schließe die Authentifizierung von Claude im Terminal auf dem Host ab, genau wie du es außerhalb von Chatcode tun würdest.

Beschränke Zugangsdaten auf die jeweilige Arbeit:

  • verwende nach Möglichkeit ein projektspezifisches Repository-Token;
  • lege keine Produktions-Secrets im Home-Verzeichnis des Gateway-Benutzers ab;
  • beginne auf einem Branch oder Worktree, den du prüfen und verwerfen kannst;
  • lege die Sandbox-Einstellung der Session fest, bevor du um weitreichende Befehlsausführung bittest.

Unter Linux gibt es für den Gateway-Benutzer ein dokumentiertes Modell für unbeaufsichtigte Administration. Unter macOS brauchen optionales passwortloses sudo und die Datenschutzabfragen des Systems eine eigene Abwägung. Die Gateway-Dokumentation behandelt diese Details.

Verknüpfe das Telegram-Konto in Chatcode und öffne dann die Mini App oder einen verknüpften Session-Chat. Beginne mit einem harmlosen, rein lesenden Prompt und prüfe, dass er dieselbe Session erreicht, die im Browser angezeigt wird.

Die Oberflächen haben unterschiedliche Aufgaben:

  • Browser: vollständige Terminal-Interaktion, Befehle, umfangreiche Ausgaben und Session-Verwaltung.
  • Telegram: Kontinuität, Benachrichtigungen, kompakte Interaktion und unterstützte Datei- oder Session-Ansichten.

Wer diese Unterscheidung im Kopf behält, erwartet nicht, dass sich ein Telegram-Nachrichtenverlauf wie ein vollständiges Terminal-Transkript verhält.

5. Persistenz und Wiederherstellung testen

Bevor du dich unterwegs auf das Setup verlässt:

  1. Starte im Browser eine Aufgabe, die nichts zerstört.
  2. Schließe den Browser und prüfe, dass die serverseitige Session weiterläuft.
  3. Verfolge das Update in Telegram.
  4. Öffne den Browser erneut und prüfe, dass es dieselbe Session ist.
  5. Teste den SSH-Zugang und finde die Gateway-Logs, damit du einen Weg zur Wiederherstellung hast.

Ein ständig laufender Server verbessert die Verfügbarkeit, verlängert aber auch die Zeit, in der ein Agent und seine Zugangsdaten erreichbar sind. Halte den Host aktuell, überwache die Festplattenbelegung und entferne verwaiste Workspaces und Zugangsdaten.

Native Channels oder Chatcode?

Claude Code Channels Chatcode
Hauptoberfläche Telegram Browser-Terminal plus Telegram
Host-Prozess Claude Code mit aktiviertem Plugin Gateway-Dienst und Agent-Session
Berechtigungsabfragen Unterstützte Abfragen können an Telegram weitergeleitet werden Gesteuert über das Agent-Terminal und die Sicherheitseinstellungen der Session
Agenten Claude Code Claude Code, Codex, Gemini und OpenCode
Vertrauensabhängigkeiten Anthropic-Plugin und Telegram Chatcode-Gateway/Steuerungsebene und Telegram
Am besten geeignet für Eine laufende Claude-Session in Telegram Persistenter Terminal-Workflow über Geräte oder Agenten hinweg

Channels ist offiziell, enger gefasst und hat weniger bewegliche Teile. Chatcode bietet eine breitere Oberfläche, bringt aber eine Steuerungsebene mit, die weitergeleitete Terminal-Inhalte lesen kann. Entscheide nach Oberfläche und Vertrauensmodell, nicht nach der Annahme, dass verwaltet automatisch sicherer bedeutet.

Für den nativen Weg nutze Claude Code mit Telegram verbinden.

Häufige Fragen

Braucht Chatcode einen VPS?

Nein. Du kannst einen unterstützten Linux-Server oder Mac verbinden, den du bereits besitzt. Ein VPS ist nützlich, wenn die Session erreichbar bleiben muss, während dein eigener Computer im Ruhezustand ist.

Ist Telegram die vollständige Terminal-Oberfläche?

Nein. Das Haupt-Terminal ist der Browser. Telegram liefert verknüpfte Ansichten, Benachrichtigungen, Dateivorschauen und Kontinuität rund um dieselbe serverseitige Session.

Kann ich stattdessen das offizielle Telegram-Plugin von Claude Code nutzen?

Ja. Nutze das offizielle Channels-Plugin von Anthropic, wenn du nur Telegram-Zugriff auf eine laufende Claude-Session brauchst. Chatcode ist eher dann relevant, wenn du zusätzlich ein Browser-Terminal, einen verwalteten, ständig laufenden Host oder mehrere Coding-Agenten brauchst.

Kann Chatcode den Terminal-Datenverkehr lesen?

Ja. Verbindungen sind auf jeder Teilstrecke per TLS verschlüsselt, aber die Steuerungsebene von Chatcode ist ein vertrauenswürdiges Relay und keine Ende-zu-Ende-verschlüsselte Leitung. Sie verarbeitet Terminal-Inhalte für Telegram-Formatierung, Vorschauen, Transkription und Benachrichtigungen.

Diese Anleitung teilen