---
title: "Claude Code in Telegram mit Chatcode nutzen"
seoTitle: "Claude Code in Telegram mit Chatcode: Einrichtung"
navTitle: "Claude Code in Telegram"
description: "Claude Code mit Browser-Terminal und Telegram-Anbindung von Chatcode auf deinem Server einrichten: Kompromisse bei Host, Relay, Zugangsdaten und nativem Plugin."
slug: claude-code-telegram-with-chatcode
lang: de
date: 2026-06-11
updated: 2026-07-30
author: "Chatcode"
category: guide
faq:
  - q: "Braucht Chatcode einen VPS?"
    a: "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."
  - q: "Ist Telegram die vollständige Terminal-Oberfläche?"
    a: "Nein. Das Haupt-Terminal ist der Browser. Telegram liefert verknüpfte Ansichten, Benachrichtigungen, Dateivorschauen und Kontinuität rund um dieselbe serverseitige Session."
  - q: "Kann ich stattdessen das offizielle Telegram-Plugin von Claude Code nutzen?"
    a: "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."
  - q: "Kann Chatcode den Terminal-Datenverkehr lesen?"
    a: "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."
---

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

```text
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](/docs/gateway), bevor du
entscheidest, welches Vertrauensmodell zum Host passt.

## 2. Das Gateway verbinden

Melde dich bei [app.chatcode.dev](https://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](/docs/gateway) behandelt diese Details.

## 4. Telegram verknüpfen

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](/articles/how-to-connect-claude-code-to-telegram).
