Terminal · SSH · SFTP

Das Terminal von Blyck basiert auf xterm.js und behandelt lokale Shell · SSH-Remote-Sessions · Dateibaum · SFTP-Remote-Baum in Panels gleicher Art. Teile Panels, um mehrere Server gleichzeitig zu verwalten, und bearbeite Remote-Dateien per SFTP wie lokale.

Zero-Install-Remote

Wenn du mit Blyck einen Remote-Server bedienst, installierst du auf dem Server nichts. Die einzige Anforderung am Remote-Ende ist ein einziges sshd.

Um mit VS Code Remote-SSH KI zu nutzen, musst du auf jeder Remote-Maschine ein KI-CLI wie Claude Code · Codex sowie Erweiterung und Laufzeit (Node) installieren und bei jedem Serverwechsel Installation·Login wiederholen. In geschlossenen Netzen oder auf Servern ohne Installationsrechte stößt das an Grenzen. Blyck führt Claude Code · Codex lokal (auf deinem PC) aus und leitet Dateioperationen per SFTP und Befehle per SSH weiter.

• Keine KI-CLI-Installation nötig — Claude Code · Codex laufen auf deinem PC. Auf dem Remote-Server werden sie nicht installiert.
• Geschlossene Netze · Server ohne Rechte OK — funktioniert, solange nur sshd offen ist.
• Schlüssel·Authentifizierung an einem lokalen Ort — keine API-Schlüssel oder Login-Sessions pro Server nötig.
• Keine Spuren auf dem Server — keine Agentenprozesse oder Caches auf dem Remote-Ende. Trennst du die Verbindung, ist Schluss.

Trade-off

Schwere Arbeiten wie große Codesuchen·Builds werden ausgeführt, indem Befehle über SSH gesendet werden (in Remote-Ordnern ist die RAG-Code-Suche deaktiviert, die KI durchsucht direkt mit file_list_dir·file_read). Für übliche Bearbeitungs-·Betriebsaufgaben ist dieses Verfahren deutlich leichtgewichtiger.

Lokales Terminal

Automatische Shell-Erkennung

Auch ohne Konfiguration wird automatisch die zum OS passende Shell ausgewählt.

Umgebung	Reihenfolge der automatischen Auswahl
Windows	PowerShell 7+ → PowerShell 5.1 → cmd.exe
macOS / WSL	bash · zsh (LANG=en_US.UTF-8 automatisch angewendet)

Scrollback-Suche · Schrift

• Scrollback-Puffer 10.000 Zeilen — Suche mit Ctrl+F (Regex-Unterstützung).
• Ctrl+= / Ctrl+- / Ctrl+0 — Schriftgröße anpassen. Wird je nach Bereich Terminal · Dateibaum · Editor · Chat separat gespeichert.

Smarte Ausgabe — per Klick aktiv

• URL — per Klick im Standardbrowser geöffnet.
• Doppelklick auf Dateinamen — doppelklickst du in einer ls-Ausgabe usw. eine Datei, öffnet sie sich im Editor; bei einem Ordner wird nach cd die Liste angezeigt.
• Verfolgung des aktuellen Verzeichnisses — die von der Shell gemeldete Position (OSC 7) wird stets in der Panel-Kopfzeile angezeigt.
• edit <Datei> — gibst du dies im Terminal ein, wechselt das Panel zum Editor dieser Datei.

Warum Sonderzeichen nicht zerbrechen

Hinweis

In der Windows-Umgebung werden ohne separate Konfiguration auch Sonderzeichen korrekt dargestellt.

• D2Coding-Schrift gebündelt — auch wenn die Schrift im OS fehlt, werden Koreanisch·CJK korrekt dargestellt.
• Windows-UTF-8-Initialisierung — die Ausgabekodierung von PowerShell wird automatisch auf UTF-8 (65001) gesetzt.
• Sichere Übergabe von Nicht-ASCII-Befehlen — per -EncodedCommand (Base64 UTF-16LE) übergeben, sodass sie auch auf CP949-Firmen-PCs nicht zerbrechen.

Zerbrechen auf dem Remote-Server Sonderzeichen, prüfe mit dem locale-Befehl, ob die LANG-Umgebungsvariable des Servers *.UTF-8 ist.

KI direkt im Terminal — /claude

Rufe die KI am Shell-Prompt per Slash-Befehl spontan auf.

Befehl	Aktion
/claude <Frage>	Nur Textantwort (keine Datei-·Befehlsberechtigung)
/claude? <Frage>	Frage mit der letzten Terminalausgabe als Kontext — wenn du den gerade aufgetretenen Fehler direkt fragen willst
/claude! <Frage>	Mit Datei-·Befehlsausführungsberechtigung
/claude!? <Frage>	Ausgabekontext + Ausführungsberechtigung — „Behebe diesen Fehler” in einer Zeile erledigt

---

Panel · Registerkarte · Unter-Tab

Tastenkürzel	Aktion
Ctrl+Shift+T	Neue Registerkarte
Alt+1 ~ Alt+8	Registerkarte wechseln
Ctrl+\	Links/rechts teilen
Ctrl+Shift+-	Oben/unten teilen
Ctrl+Tab	Panel zyklisch
Ctrl+`	Unter-Tab zyklisch
Alt+Enter	Panel-Zoom

Ziehst du die Trennlinie, kannst du das Verhältnis frei anpassen. Auch die Sitzungen von Hintergrund-Unter-Tabs bleiben aktiv, sodass du mehrere Server in einem Panel überlagern und im Wechsel daran arbeiten kannst.

Tipp

Layout-Wiederherstellung — startest du die App neu, werden Registerkarten · Teilungsstruktur · Unter-Tabs unverändert wiederhergestellt, und SSH-Sessions versuchen eine automatische Wiederverbindung.

---

SSH

Verbinden

1. Ctrl+Shift+S oder +-Menü → SSH-Verbindung… wählen
2. Benutzername · Host · Port (Standard 22) eingeben und bei Bedarf das Passwort eingeben.
3. Wähle „in dieses Panel” oder „in neue Registerkarte”, um zu verbinden.

Authentifizierungsreihenfolge

Lässt du das Passwort leer, wird in folgender Reihenfolge automatisch versucht.

1. ssh-agent — SSH_AUTH_SOCK-Umgebungsvariable oder Windows-OpenSSH-Agent-Pipe
2. Standard-Schlüsseldatei — Reihenfolge ~/.ssh/id_ed25519 → id_rsa → id_ecdsa
3. Shell-Passwort-Prompt — wenn alle obigen fehlschlagen, fragt der Server direkt

Gibst du ein Passwort ein, wird es bei Erkennung des Prompts automatisch einmal eingegeben. Zudem verbindet sich SFTP desselben Hosts automatisch im Hintergrund.

Keepalive

Während der Verbindung werden Keepalive-Pakete im 30-Sekunden-Intervall gesendet, um Trennungen im Leerlauf zu verhindern.

Automatische Wiederverbindung

Wird eine SSH-Session unerwartet beendet, wird mit progressivem Warteintervall automatisch eine Wiederverbindung versucht.

1 Sek → 2 Sek → 4 Sek → 8 Sek → 16 Sek → 30 Sek → 30 Sek … (max. 10×)

• Drückst du während der Wartezeit eine beliebige Taste, wird die Wiederverbindung abgebrochen.
• Bei erfolgreicher Wiederverbindung wird die Session automatisch wiederhergestellt.

Achtung bei reinen Passwort-Servern

Bei der automatischen Wiederverbindung wird das Passwort nicht wiederverwendet. Für die automatische Wiederherstellung muss Schlüssel- oder ssh-agent-Authentifizierung funktionieren. Server, die nur Passwort unterstützen, verbinde mit Ctrl+Shift+S manuell neu.

---

Dateibaum

Öffnen

Ctrl+Shift+E oder +-Menü → Dateibaum

Tastatur-Kürzel

Taste	Aktion
↑ / ↓	Eintrag bewegen
→ / ←	Aufklappen / Einklappen
Enter	Betreten / Öffnen
Backspace	Zum übergeordneten Ordner
:	Zu beliebigem Pfad navigieren
Space	Auswählen (Mehrfachauswahl möglich)
y / x / p	Kopieren / Ausschneiden / Einfügen
d	Löschen
r oder F2	Umbenennen
n / N	Neue Datei / Neuer Ordner
R	Aktualisieren
c	Pfad an Terminal-Shell senden
a	@-Anhang an KI-Chat

Unterschied bei der Löschmethode

Löschst du eine lokale Datei, wird sie in den Papierkorb verschoben (wiederherstellbar).
Löschst du eine Remote- (SFTP) Datei, wird sie sofort dauerhaft gelöscht (rm -rf, nicht wiederherstellbar).
Lies im Bestätigungs-Prompt unbedingt die Warnung.

Größenrichtlinie beim Dateiöffnen

Dateigröße	Verhalten
≤ 2 MB	Öffnen im Monaco-Editor
2 MB ~ 32 MB	Nur-lesend öffnen (Anzeige [Nur Lesen] in der Registerkarte)
> 32 MB	Hinweis auf OS-Standard-App
Bild / PDF	Eingebauter Viewer
Office / Archivdatei	Öffnen mit OS-Standard-App

Git-Badges (lokaler Baum)

Im lokalen Dateibaum wird der Git-Status als Badge neben der Datei angezeigt.

Badge	Bedeutung
?	Untracked (nicht verfolgt)
+	Staged (gestaget)
-	Deleted (gelöscht)
!	Conflict (Konflikt)

Im Remote-SFTP-Baum werden keine Git-Badges angezeigt.

---

SFTP-Remote-Baum

Verbinden

Ctrl+Shift+F oder +-Menü → SFTP-Remote-Baum…

Gib Benutzer · Host (Pflicht) · Port (22) · Passwort (bei Schlüsselauthentifizierung leer lassen) · Schlüsselpfad · Schlüsselpassphrase · Speichername ein.

Authentifizierungsreihenfolge: angegebener Schlüssel → ssh-agent → ~/.ssh-Standardschlüssel → Passwort

Tipp

Gibst du im SSH-Dialog ein Passwort ein und verbindest dich, verbindet sich SFTP desselben Hosts automatisch im Hintergrund (Toast „✓ SFTP verbunden”). Bei Dateioperationen ist keine erneute Authentifizierung nötig.

Remote-Datei bearbeiten

Doppelklickst du im SFTP-Baum eine Textdatei, öffnet sie sich im Monaco-Editor. Speicherst du mit Ctrl+S, wird sie sofort remote hochgeladen, und die Änderung wird automatisch im ChangeSet protokolliert und ist rückgängig machbar.

Hinweis

Auf Remote-SFTP-Dateien wirken LSP-Autovervollständigung, ▶ Ausführen und Git-Diff nicht. Das Dateigrößenlimit beträgt 2 MB.

Symbolische Links werden im Baum in einer eigenen Farbe kenntlich gemacht.

---

Datei-Upload · Download

Hältst du im selben Tab lokalen Dateibaum und SFTP-Remote-Baum nebeneinander geöffnet, kannst du mit den Tasten u/g schnell übertragen.

Richtung	Methode
Upload (lokal → remote)	Im lokalen Baum mit Space auswählen → u
Download (remote → lokal)	Im SFTP-Baum mit Space auswählen → g

• Ordner werden rekursiv übertragen.
• Der Fortschritt wird in der Statusleiste als „N → user@host” angezeigt.
• Gibt es im selben Tab keinen Baum der jeweils anderen Art, wird ein Hinweis angezeigt.

Auch über das Rechtsklick-Menü kannst du Upload · Download · Neuer Ordner · Umbenennen · Löschen nutzen, und auch eine direkte Server-zu-Server-Übertragung (ohne Umweg über lokal) wird unterstützt.

---

Gespeicherte Verbindungen

Gibst du im SSH- oder SFTP-Dialog einen „Speichernamen” ein und verbindest dich, wird die Verbindung gespeichert. Ab dem nächsten Mal verbindest du dich mit einem Klick aus der Liste direkt.

Sichere Passwortspeicherung

Passwörter und Schlüsselpassphrasen werden mit dem OS-Schlüsselbund verschlüsselt gespeichert.

• Windows: DPAPI (an Benutzerkonto gebunden)
• macOS: Keychain

In connections.json werden nur die verschlüsselten Werte gespeichert; der Klartext existiert nur im Speicher.

Beim Kopieren auf einen anderen PC

Kopierst du die Konfigurationsdatei auf einen anderen PC oder in ein anderes Konto, lässt sich das Passwort nicht entschlüsseln. Beim Verbinden öffnet sich der Anmeldeinformations-Eingabedialog erneut.

Gespeicherte Verbindungen kannst du durch das Anlegen von Ordnern nach Team·Umgebung gruppieren.

---

Remote-Projektordner (KI-Chat-Integration)

Als Arbeitsordner des KI-Chats kannst du einen SSH/SFTP-Remote-Ordner festlegen.

Vorgehen zur Einrichtung

1. Klicke oben im KI-Chat-Panel den 📁-Ordner-Chip
2. Remote (SSH/SFTP) verbinden… wählen
3. Server wählen → Ordner wählen

Nach der Einrichtung wird der Chip als user@host:/path · Remote SFTP angezeigt.

Funktionsweise

Sobald festgelegt, werden die Datei-Tools der KI (file_read / file_write / file_list_dir) automatisch auf den SFTP-Pfad geroutet. Auch Remote-Dateiänderungen werden im ChangeSet protokolliert und sind rückgängig machbar.

Hinweis

In einem Remote-Projektordner ist die RAG-Code-Suche (Integrierte Suche) deaktiviert. Die KI durchsucht den Remote-Code mit den Tools file_list_dir und file_read.

---

VNC

Brauchst du einen Remote-Desktop, nutze den eingebauten VNC-Viewer.

• Verbindung per Host:Port-Eingabe, Unterstützung der VNC-Passwortauthentifizierung
• Automatische Bildschirmanpassung — der Remote-Bildschirm wird automatisch auf die Panel-Größe skaliert.
• Bidirektionale Zwischenablage — remote → lokal automatisch synchronisiert, lokal → remote per Ctrl+V oder Zwischenablage-Senden-Button
• SSH-Tunnel-Option — Zugriff auf internes VNC über einen Jump-Server (lokaler Port automatisch gemappt)
• Dateiübertragungs-Registerkarte — Up-/Download auf Basis des TightVNC-Protokolls. Die Dateinamenkodierung (UTF-8 · Windows-949 · Shift-JIS usw.) lässt sich in den Optionen wählen.

---

WinRM — Remote-Windows-Verwaltung

Windows-Server, bei denen sich SSH nicht öffnen lässt, verwaltest du über das WinRM-Panel.

• PowerShell-Befehle werden remote ausgeführt.
• Auch koreanische Befehle sind durch die -EncodedCommand-Behandlung sicher.
• Delegierst du an die KI, werden Abfragebefehle (Get-*) automatisch ausgeführt, und Änderungsbefehle (Set- / Remove- / Restart- usw.) durchlaufen eine Bestätigung.

---

Zusammen mit der KI

Der KI-Chat erkennt das aktive SSH-Panel. Delegierst du Befehle in natürlicher Sprache, führt die KI sie mit dem Tool ssh_exec aus, sammelt die Ausgabe und antwortet.

▸ Zeige die nginx-Konfigurationsdatei dieses Servers
▸ Finde die 5 größten Dateien in /var/log

Bevor die KI einen Befehl erstellt, erfasst sie mit ssh_probe_env die Serverumgebung (OS · init-System · Paketmanager · ob Container · Speicher · Festplatte · Versionen installierter Tools). So erstellt sie keine falschen Befehle aufgrund von Unterschieden wie apt/yum, systemd/sysvinit.

Lesebefehle werden automatisch ausgeführt, aber Schreib- · Risikobefehle (rm, chmod usw.) durchlaufen vor der Ausführung einen Bestätigungsdialog. Details siehe KI-Chat › Tool-Genehmigung.

---

FAQ

F. Die SSH-Verbindung funktioniert nicht.
Prüfe Host · Port (Standard 22) · Firewall · Benutzername. Bei Schlüsselauthentifizierung prüfe, ob die ~/.ssh-Schlüsseldatei existiert und in den authorized_keys des Servers registriert ist.

F. Die automatische Wiederverbindung schlägt ständig fehl.
Bei der automatischen Wiederverbindung wird das Passwort nicht wiederverwendet. Für die automatische Wiederherstellung muss Schlüssel- oder ssh-agent-Authentifizierung funktionieren. Server, die nur Passwort unterstützen, verbinde mit Ctrl+Shift+S manuell neu.

F. Auf dem Remote-Server zerbrechen Sonderzeichen.
Prüfe mit dem locale-Befehl, ob die LANG-Umgebungsvariable des Servers *.UTF-8 ist. Beim lokalen Windows-Terminal wendet Blyck UTF-8 automatisch an.

F. Die Dateiübertragung (u/g) funktioniert nicht.
Du musst im selben Tab sowohl den lokalen Dateibaum als auch den SFTP-Remote-Baum öffnen. Wähle für Upload im lokalen Baum, für Download im SFTP-Baum.

F. Ich habe gespeicherte Verbindungen auf einen anderen PC übertragen, jetzt wird das Passwort wieder abgefragt.
Das Passwort ist mit einem an das OS-Konto gebundenen Verschlüsselungsschlüssel geschützt. Kopierst du es auf einen anderen PC/in ein anderes Konto, lässt es sich nicht entschlüsseln und muss neu eingegeben werden. Das ist ein aus Sicherheitsgründen beabsichtigtes Verhalten.

F. Im Remote-Projektordner funktioniert die RAG-Suche nicht.
Remote-SFTP-Ordner sind derzeit kein RAG-Indizierungsziel. Die KI durchsucht den Remote-Code direkt mit den Tools file_list_dir und file_read. Bei einem lokalen Ordner probiere die Integrierte Suche.