Terminal · SSH · SFTP

El terminal de Blyck se basa en xterm.js y maneja shell local·sesiones remotas SSH·árbol de archivos·árbol remoto SFTP como paneles del mismo tipo. Divide paneles para gestionar varios servidores a la vez y edita archivos remotos como si fueran locales con SFTP.

Cero instalación en el remoto (zero-install remote)

Cuando manejas un servidor remoto con Blyck, no instalas nada en el servidor. El único requisito en el remoto es sshd.

Para usar IA con VS Code Remote-SSH, en cada máquina remota tienes que instalar una CLI de IA como Claude Code·Codex más extensiones·runtime (Node), y repetir la instalación·inicio de sesión cada vez que cambias de servidor. En redes cerradas o servidores sin permisos de instalación, a veces te bloquea. Blyck ejecuta Claude Code·Codex en local (tu PC) y transmite las operaciones de archivos por SFTP y los comandos por SSH.

• No requiere instalar la CLI de IA — Claude Code·Codex corren en tu PC. No se instalan en el servidor remoto.
• OK en redes cerradas·servidores sin permisos — funciona con que sshd esté abierto.
• Claves·autenticación en un único lugar local — no necesitas tener claves de API ni sesiones de inicio de sesión en cada servidor.
• Sin rastro en el servidor — no se crean procesos de agente ni cachés en el remoto. Cuando cortas la conexión, se acabó.

Compromiso

Las tareas pesadas como búsquedas de código a gran escala·builds se ejecutan enviando comandos al otro lado de SSH (en carpetas remotas la búsqueda RAG de código está desactivada, la IA explora directamente con file_list_dir·file_read). Para las tareas habituales de edición·operaciones, este enfoque es mucho más ligero.

Terminal local

Detección automática del shell

Sin configuración, selecciona automáticamente el shell acorde al SO.

Entorno	Orden de selección automática
Windows	PowerShell 7+ → PowerShell 5.1 → cmd.exe
macOS / WSL	bash · zsh (aplica LANG=en_US.UTF-8 automáticamente)

Búsqueda en el scrollback · fuente

• Buffer de scrollback de 10 000 líneas — busca con Ctrl+F (admite expresiones regulares).
• Ctrl+= / Ctrl+- / Ctrl+0 — ajuste del tamaño de fuente. Se guarda por separado para las áreas de terminal·árbol de archivos·editor·chat.

Salida inteligente — al hacer clic, actúa

• URL — al hacer clic se abre en el navegador predeterminado.
• Doble clic en nombre de archivo — al hacer doble clic en un archivo en la salida de ls, etc., se abre en el editor; si es una carpeta, hace cd y muestra el listado.
• Seguimiento del directorio actual — muestra siempre en la cabecera del panel la ubicación que indica el shell (OSC 7).
• edit <archivo> — al escribirlo en el terminal, ese panel cambia al editor de ese archivo.

Por qué el coreano no se corrompe

Nota

En el entorno de Windows, el coreano se muestra correctamente sin configuración adicional.

• Fuente D2Coding incluida — aunque el SO no tenga la fuente, el coreano·CJK se muestra correctamente.
• Inicialización UTF-8 en Windows — ajusta automáticamente la codificación de salida de PowerShell a UTF-8 (65001).
• Transmisión segura de comandos no ASCII — los transmite con -EncodedCommand (Base64 UTF-16LE), por lo que no se corrompen ni en un PC de empresa CP949.

Si el coreano se corrompe en el servidor remoto, comprueba con el comando locale si la variable de entorno LANG del servidor es *.UTF-8.

IA directa desde el terminal — /claude

Invoca la IA al instante con comandos de barra desde el prompt del shell.

Comando	Acción
/claude <pregunta>	Solo respuesta de texto (sin permisos de archivos·comandos)
/claude? <pregunta>	Pregunta incluyendo como contexto la salida reciente del terminal — para preguntar tal cual por el error que acaba de salir
/claude! <pregunta>	Concede permisos de archivos · ejecución de comandos
/claude!? <pregunta>	Contexto de salida + permisos de ejecución — “arregla este error” en una sola línea y listo

---

Paneles · pestañas · subpestañas

Atajo	Acción
Ctrl+Shift+T	Pestaña nueva
Alt+1 ~ Alt+8	Cambiar de pestaña
Ctrl+\	División izquierda/derecha
Ctrl+Shift+-	División arriba/abajo
Ctrl+Tab	Recorrer paneles
Ctrl+`	Recorrer subpestañas
Alt+Enter	Zoom del panel

Arrastrando el divisor puedes ajustar la proporción libremente. Las sesiones de las subpestañas en segundo plano siguen vivas, así que puedes tener varios servidores apilados en un panel y alternar entre ellos para trabajar.

Consejo

Restauración del diseño — al reiniciar la app, se restauran tal cual las pestañas·la estructura de división·las subpestañas, y las sesiones SSH intentan reconectarse automáticamente.

---

SSH

Conectar

1. Ctrl+Shift+S o menú + → selecciona Conexión SSH…
2. Introduce nombre de usuario·host·puerto (22 por defecto) y, si hace falta, la contraseña.
3. Elige “En este panel” o “En una pestaña nueva” para conectar.

Orden de autenticación

Si dejas la contraseña vacía, intenta automáticamente en el siguiente orden.

1. ssh-agent — la variable de entorno SSH_AUTH_SOCK o el pipe del agente OpenSSH de Windows
2. Archivo de clave predeterminado — en el orden ~/.ssh/id_ed25519 → id_rsa → id_ecdsa
3. Prompt de contraseña del shell — si todo lo anterior falla, el servidor la solicita directamente

Si introduces la contraseña, se escribe automáticamente una vez al detectar el prompt. Además, el SFTP del mismo host se conecta automáticamente en segundo plano.

Keepalive

Durante la conexión, envía paquetes keepalive cada 30 segundos para evitar la desconexión en estado inactivo.

Reconexión automática

Si la sesión SSH termina de forma anómala, intenta reconectarse automáticamente con intervalos de espera progresivos.

1 s → 2 s → 4 s → 8 s → 16 s → 30 s → 30 s … (hasta 10 veces)

• Si pulsas cualquier tecla durante la espera, se cancela la reconexión.
• Al reconectar con éxito, la sesión se recupera automáticamente.

Atención con servidores solo de contraseña

La reconexión automática no reutiliza la contraseña. Para la recuperación automática debe funcionar la autenticación por clave o ssh-agent. Para servidores que solo admiten contraseña, reconéctate manualmente con Ctrl+Shift+S.

---

Árbol de archivos

Abrir

Ctrl+Shift+E o menú + → Árbol de archivos

Atajos de teclado

Tecla	Acción
↑ / ↓	Mover entre elementos
→ / ←	Desplegar / plegar
Enter	Entrar / abrir
Backspace	A la carpeta superior
:	Ir a una ruta arbitraria
Space	Seleccionar (selección múltiple posible)
y / x / p	Copiar / cortar / pegar
d	Eliminar
r o F2	Renombrar
n / N	Archivo nuevo / carpeta nueva
R	Actualizar
c	Enviar la ruta al shell del terminal
a	Adjuntar con @ al Chat con IA

Diferencia en el método de eliminación

Si eliminas un archivo local, va a la papelera (recuperable).
Si eliminas un archivo remoto (SFTP), se elimina permanentemente al instante (rm -rf, irrecuperable).
Lee siempre la advertencia en el prompt de confirmación.

Política de tamaño al abrir archivos

Tamaño del archivo	Acción
≤ 2 MB	Abrir en el editor Monaco
2 MB ~ 32 MB	Abrir en solo lectura (se muestra [solo lectura] en la pestaña)
> 32 MB	Indicar la app predeterminada del SO
Imagen / PDF	Visor integrado
Office / archivos comprimidos	Abrir con la app predeterminada del SO

Insignia de Git (árbol local)

En el árbol de archivos local, el estado de Git se muestra como insignia junto al archivo.

Insignia	Significado
?	Untracked (sin seguimiento)
+	Staged (preparado)
-	Deleted (eliminado)
!	Conflict (conflicto)

En el árbol remoto SFTP no se muestran insignias de Git.

---

Árbol remoto SFTP

Conectar

Ctrl+Shift+F o menú + → Árbol remoto SFTP…

Introduce usuario·host (obligatorio)·puerto (22)·contraseña (déjala vacía si es autenticación por clave)·ruta de la clave·passphrase de la clave·nombre para guardar.

Orden de autenticación: clave especificada → ssh-agent → clave predeterminada de ~/.ssh → contraseña

Consejo

Si introduces la contraseña en el diálogo SSH y conectas, el SFTP del mismo host se conecta automáticamente en segundo plano (toast ”✓ SFTP conectado”). No hace falta reautenticarse al trabajar con archivos.

Edición de archivos remotos

Al hacer doble clic en un archivo de texto del árbol SFTP, se abre en el editor Monaco. Al guardar con Ctrl+S, se sube de inmediato al remoto y el cambio se registra automáticamente en ChangeSet para poder revertirlo.

Nota

A los archivos remotos SFTP no se les aplica el autocompletado LSP, el botón ▶ Ejecutar ni el diff de Git. El límite de tamaño de archivo es 2 MB.

Los enlaces simbólicos se distinguen en el árbol con un color aparte.

---

Subida · descarga de archivos

Si abres uno al lado del otro el árbol de archivos local y el árbol remoto SFTP en la misma pestaña, puedes transferir rápidamente con las teclas u/g.

Dirección	Método
Subida (local → remoto)	Selecciona con Space en el árbol local → u
Descarga (remoto → local)	Selecciona con Space en el árbol SFTP → g

• Las carpetas se transfieren de forma recursiva.
• El progreso se muestra en la barra de estado como “N elementos → user@host”.
• Si en la misma pestaña no hay un árbol del tipo opuesto, se muestra un mensaje informativo.

En el menú contextual también puedes usar subir·descargar·carpeta nueva·renombrar·eliminar, y se admite la transferencia directa entre servidores (sin pasar por el local).

---

Conexiones guardadas

Si introduces el “nombre para guardar” en el diálogo SSH o SFTP y conectas, la conexión se guarda. A partir de entonces puedes conectarte con un solo clic desde la lista.

Almacenamiento seguro de contraseñas

Las contraseñas y passphrases de clave se guardan cifradas con el llavero del SO.

• Windows: DPAPI (vinculado a la cuenta de usuario)
• macOS: Keychain

En connections.json solo se guardan los valores cifrados, y el texto plano solo existe en memoria.

Al copiar a otro PC

Si copias el archivo de configuración a otro PC o a otra cuenta, no se puede descifrar la contraseña. Al conectar, vuelve a abrirse el diálogo de introducción de credenciales.

Las conexiones guardadas se pueden agrupar por equipo·entorno creando carpetas.

---

Carpeta de proyecto remota (integración con el Chat con IA)

Puedes designar una carpeta remota SSH/SFTP como carpeta de trabajo del Chat con IA.

Cómo configurarlo

1. Clic en el chip de carpeta 📁 en la parte superior del panel de Chat con IA
2. Selecciona Conexión remota (SSH/SFTP)…
3. Selecciona el servidor → selecciona la carpeta

Tras configurarlo, el chip se muestra como user@host:/path · SFTP remoto.

Cómo funciona

Una vez designada, las herramientas de archivos de la IA (file_read / file_write / file_list_dir) se enrutan automáticamente a la ruta SFTP. Los cambios en archivos remotos también se registran en ChangeSet para poder revertirlos.

Nota

En las carpetas de proyecto remotas, la búsqueda RAG de código (Búsqueda unificada) está desactivada. La IA explora el código remoto con las herramientas file_list_dir y file_read.

---

VNC

Cuando necesitas un escritorio remoto, usa el visor VNC integrado.

• Conexión introduciendo host:puerto, admite autenticación por contraseña VNC
• Ajuste automático de pantalla — la pantalla remota se escala automáticamente al tamaño del panel.
• Portapapeles bidireccional — remoto → local se sincroniza automáticamente; local → remoto con Ctrl+V o el botón de envío al portapapeles
• Opción de túnel SSH — acceso a un VNC de red interna a través de un servidor de salto (mapeo automático de puerto local)
• Pestaña de transferencia de archivos — subida/descarga basada en el protocolo TightVNC. La codificación de los nombres de archivo (UTF-8·Windows-949·Shift-JIS, etc.) se puede elegir en las opciones.

---

WinRM — gestión de Windows remoto

Los servidores Windows en los que no puedes abrir SSH se gestionan con el panel WinRM.

• Los comandos de PowerShell se ejecutan en el remoto.
• Los comandos en coreano también son seguros gracias al procesamiento -EncodedCommand.
• Si lo delegas a la IA, los comandos de consulta (Get-*) se ejecutan automáticamente, y los comandos de modificación (Set- / Remove- / Restart-, etc.) pasan por una confirmación.

---

Junto con la IA

El Chat con IA reconoce el panel SSH activo. Si delegas comandos en lenguaje natural, la IA ejecuta con la herramienta ssh_exec, recoge la salida y responde.

▸ Muéstrame el archivo de configuración de nginx de este servidor
▸ Encuentra los 5 archivos más grandes en /var/log

Antes de crear el comando, la IA detecta el entorno del servidor con ssh_probe_env (SO·sistema init·gestor de paquetes·si es contenedor·memoria·disco·versiones de las herramientas instaladas). Así no crea comandos erróneos por diferencias entre apt/yum, systemd/sysvinit.

Los comandos de lectura se ejecutan automáticamente, pero los comandos de escritura·peligrosos (rm, chmod, etc.) pasan por un diálogo de confirmación antes de ejecutarse. Para más detalles consulta Chat con IA › Aprobación de herramientas.

---

Preguntas frecuentes

P. No consigo conectar por SSH.
Comprueba host·puerto (22 por defecto)·firewall·nombre de usuario. Si es autenticación por clave, comprueba que exista el archivo de clave en ~/.ssh y que esté registrado en authorized_keys del servidor.

P. La reconexión automática falla continuamente.
La reconexión automática no reutiliza la contraseña. Para la recuperación automática debe funcionar la autenticación por clave o ssh-agent. Para servidores que solo admiten contraseña, reconéctate manualmente con Ctrl+Shift+S.

P. El coreano se corrompe en el servidor remoto.
Comprueba con el comando locale si la variable de entorno LANG del servidor es *.UTF-8. En el terminal local de Windows, Blyck aplica UTF-8 automáticamente.

P. La transferencia de archivos (u/g) no funciona.
Debes abrir en la misma pestaña tanto el árbol de archivos local como el árbol remoto SFTP. La subida se selecciona en el árbol local, y la descarga en el árbol SFTP.

P. Moví las conexiones guardadas a otro PC y me vuelve a pedir la contraseña.
La contraseña se protege con una clave de cifrado vinculada a la cuenta del SO. Si la copias a otro PC/cuenta, no se descifra y hay que volver a introducirla. Es un comportamiento intencionado por seguridad.

P. La búsqueda RAG no funciona en la carpeta de proyecto remota.
Las carpetas remotas SFTP no son actualmente objeto de indexación RAG. La IA explora directamente el código remoto con las herramientas file_list_dir y file_read. Si es una carpeta local, prueba a usar la Búsqueda unificada.