Manual del usuario

Ajustes y atajos

Los ajustes se abren con el botón del engranaje de la barra de título. En macOS, el menú de la aplicación también incluye «Settings…» (⌘,); en Windows y Linux, pulse Alt y elija Archivo ▸ Ajustes… La ventana de ajustes tiene ocho categorías: General, Apariencia, Terminal, Vista de conversación, Comportamiento, Avanzado, Agentes y Atajos. Este capítulo describe cada elemento y termina con las combinaciones de teclas predeterminadas. Los ajustes se comparten entre la aplicación de escritorio y los clientes de navegador conectados a ella.

Ajustes · Apariencia

1. General

ElementoDescripción
IdiomaIdioma de la interfaz. «Auto (sistema)» sigue el idioma del sistema; hay once idiomas disponibles
Sonido de notificaciónSonido de las notificaciones (activado de forma predeterminada)
System notificationsActiva o desactiva las notificaciones del sistema (activadas de forma predeterminada). Si el sistema aún no ha permitido las notificaciones, «Allow notifications» solicita el permiso; si están bloqueadas, se muestran los pasos que debe seguir en su sistema
Comando de shellSolo en la aplicación de escritorio para macOS: «Instalar el comando ‘vela’» añade a su shell vela <project-path>, que abre un proyecto en VelaTerm. «Desinstalar el comando ‘vela’» lo quita
Vela Skills«Install» (después, «Reinstall») instala las habilidades de VelaTerm para Claude Code y Codex, como /vspawn y $vspawn. Si Codex no las muestra, inicie una sesión nueva de Codex. Consulte Comandos de sesión §2

2. Apariencia

ElementoDescripción
AcentoColor de acento: «Seguir al tema» o uno de cuatro colores
Densidad«Compacta», «Normal» (predeterminado) o «Amplia»
PanelesEstilo de los paneles: «Sin borde» (predeterminado) o «Tarjeta»
Divisor«Sutil» (predeterminado) o «Visible»
Barra lateral«Árbol» (predeterminado) o «Compacta»
Interface fontFuente de la interfaz
Interface sizeTamaño de fuente de la interfaz; «Auto» sigue la densidad

Los temas claro y oscuro se cambian en la barra de título (seguir al sistema, oscuro, claro), no aquí. Las sesiones de Claude en ejecución en la vista de terminal aplican el cambio de tema sin necesidad de reiniciarlas.

3. Terminal

ElementoDescripción
Pegar imagen«Pegar ruta de archivo» (predeterminado) guarda una imagen pegada como archivo temporal e inserta su ruta. «Pegado nativo» permite que Claude Code o Codex lean la imagen del portapapeles; solo está disponible en la aplicación de escritorio local
Sugerencias de comandos«Automáticas», «Con Tab» o «Desactivadas». Se aplica de inmediato, también a los terminales abiertos; se oculta donde no es compatible. Consulte Sugerencias de comandos
Shell predeterminadaShell de los terminales nuevos. Se muestra en Windows, donde hay varias shells disponibles; macOS y Linux siempre usan la shell del sistema
Terminal fontFuente del terminal
Terminal sizeTamaño de fuente del terminal (13 de forma predeterminada). ⌘+ / ⌘- / ⌘0 lo cambian mientras trabaja
Interlineado del terminalEspaciado entre líneas del terminal (1,2× de forma predeterminada)

4. Vista de conversación

Estos ajustes se aplican a la vista de conversación de las sesiones de agente; consulte Vista de conversación.

ElementoDescripción
Fuente de la conversación, Tamaño de fuente de la conversación, Interlineado de la conversaciónTipografía de la conversación, independiente de los ajustes del terminal (tamaño predeterminado 13,5; interlineado 1,2×)
Barra de herramientas del editorQué controles aparecen junto al cuadro de mensaje y en qué orden: Modelo, Esfuerzo de razonamiento, Modo de colaboración, Modo de permisos, Modo rápido, Velocidad, Tono, Servidores MCP, Tareas en segundo plano, Cuenta y Créditos de restablecimiento de Codex. Cada control tiene un interruptor para activarlo o desactivarlo; las flechas reordenan los controles activados. Modelo, Esfuerzo de razonamiento, Modo de colaboración y Modo de permisos están activados de forma predeterminada

Los controles que el agente o el modelo actual no admiten no se muestran. Un control compatible sigue visible cuando su función no está disponible temporalmente; por ejemplo, Servidores MCP y Tareas en segundo plano mientras el proceso del agente está detenido.

Los controles desactivados, y los que no caben junto al cuadro de mensaje, están en el menú Más, de modo que puede usar cualquier control compatible sin activarlo antes aquí. Más no se muestra cuando todos los controles compatibles están activados y caben. Un control que se desactiva y se vuelve a activar pasa al final de la fila. En dispositivos móviles, los controles desactivados aparecen en una segunda fila.

5. Comportamiento

ElementoDescripción
Pestañas«Única» (predeterminado) reutiliza la pestaña actual al abrir una sesión de agente y mantiene la pestaña anterior en ejecución en segundo plano. «Múltiples» abre cada sesión en su propia pestaña
Incorporación dinámica al filtro de estadoCuando hay un filtro de estado activo en la barra lateral, se le añaden las sesiones que empiezan a coincidir (activado de forma predeterminada)
Background limitSe muestra en el modo Única: número máximo de pestañas en segundo plano (8, 16, 32 o 64; 32 de forma predeterminada). Cuando se supera el límite, se termina la pestaña en segundo plano inactiva más antigua
Confirm before spawnMuestra una tarjeta de confirmación antes de que se inicie una sesión hija (activado de forma predeterminada); consulte Creación de sesiones y colaboración en Git §4
Usage auto-refreshMantiene actualizado el uso de la cuenta en el panel Info (activado de forma predeterminada)
Usage refreshIntervalo de actualización: 30 s, 1 min, 2 min o 5 min (5 min de forma predeterminada)
Continuar tras el restablecimientoContinúa automáticamente una tarea de Claude o Codex cuando se restablece un límite de uso de cinco horas o semanal (activado de forma predeterminada)
Limpiar imágenes pegadas automáticamenteElimina los archivos temporales de las imágenes pegadas al salir de la aplicación y, al iniciarla, los de más de 24 horas (activado de forma predeterminada). «Limpiar ahora» los elimina de inmediato

Contexto de referencias de sesión determina cómo vrefer --ask (y la habilidad vask) entrega la conversación de otra sesión al agente que responde. «Transcripción completa» (predeterminado) pasa la conversación completa. «Resumir primero» la condensa antes con el «Agente de resumen», el modelo y el esfuerzo seleccionados aquí. Consulte Comandos de sesión §5.

6. Avanzado

ElementoDescripción
Renderizador del terminal«DOM» (predeterminado) o «WebGL». Mantenga el valor predeterminado salvo que tenga un motivo concreto para cambiarlo
Redibujar al cambiar de pestañaVuelve a dibujar un terminal por completo al regresar a su pestaña (desactivado de forma predeterminada). Actívelo si las interfaces de terminal se ven desordenadas en ocasiones después de cambiar de pestaña
Salida con prioridad en primer planoMantiene fluida la escritura mientras los agentes de otras pestañas generan mucha salida (activado de forma predeterminada)
Registrar registros de sesiónGuarda la salida de terminal de las sesiones de agente en un archivo de registro (desactivado de forma predeterminada). Cuando está activado, las sesiones archivadas se pueden reproducir y la búsqueda global incluye también la salida de los terminales. Las sesiones de terminal normales nunca se graban

7. Agentes

«Valores predeterminados de nuevas sesiones» se aplica a las sesiones recién creadas del agente seleccionado. Los ajustes definidos para una sesión concreta tienen prioridad, salvo la ruta del ejecutable, que siempre se aplica a todo el tipo de agente.

Ajustes · Agentes

ElementoDescripción
Tipo de agenteEl agente cuyos valores predeterminados está editando
Ruta del ejecutable (opcional)Ruta completa del ejecutable del agente. Si está vacía, el comando se busca en el PATH. Se rellena automáticamente después de una instalación correcta con un solo clic
Argumentos de inicio (opcional)Argumentos de línea de comandos predeterminados, por ejemplo --model opus
PermisoPermiso predeterminado para las sesiones nuevas. Claude, Codex y OpenCode ofrecen sus modos con nombre; la mayoría de los demás agentes ofrecen «Predeterminado» y «YOLO» (omite todas las confirmaciones de permiso); Pi no muestra solicitudes de permiso. Consulte Sesiones del agente de IA §6
Vista predeterminadaEn Claude, Codex, OpenCode, Pi y OMP: «Vista de conversación» (predeterminado) o «Vista de terminal» para las sesiones nuevas. Las sesiones existentes conservan su vista

8. Atajos

Ajustes · Atajos

Haga clic en la combinación de teclas de una acción y pulse la nueva combinación; Escape cancela la operación. Una combinación consta de una letra con ⌘ (en la aplicación de escritorio para macOS) o Ctrl y, opcionalmente, Shift y Option/Alt. Si la combinación ya está en uso, el mensaje indica qué acción la utiliza. «Restaurar valores predeterminados» restablece todas las combinaciones.

AcciónAplicación de escritorio para macOSWindows, Linux
Abrir proyecto⌘OCtrl+Alt+O
Nueva terminal⌘TCtrl+Alt+T
Nueva sesión de agente⌘NCtrl+Alt+N
Nueva pestaña de navegador (solo en la aplicación de escritorio)⌘⇧BCtrl+Alt+B
Dividir a la derecha⌘DCtrl+Alt+D
Dividir abajo⌘⇧DCtrl+Alt+E
Cerrar panel / pestaña⌘WCtrl+Alt+W
Buscar en la terminal⌘FCtrl+Alt+F
Buscar en todas las sesiones⌘⇧FCtrl+Alt+G
Guardar documento⌘SCtrl+S

Navegadores convencionales. Cuando usa VelaTerm en un navegador convencional (acceso remoto mediante URL), el propio navegador usa muchas combinaciones con ⌘ y Ctrl, por lo que las combinaciones de Windows y Linux anteriores se aplican en todos los sistemas, y la página de ajustes las muestra así. La excepción es un navegador en macOS, donde dividir a la derecha y dividir abajo siguen siendo ⌘D y ⌘⇧D. Las ventanas de conexión remota de la aplicación de escritorio usan las combinaciones de escritorio.

Teclas fijas que no se pueden cambiar: ⌘1–9 cambia de pestaña, y ⌘+ / ⌘- / ⌘0 cambian o restablecen el tamaño de fuente del terminal (Ctrl en Windows, en Linux y en los navegadores).

9. Selector de nueva sesión de agente

«Nueva sesión de agente» abre una lista con búsqueda de tipos de agente y preajustes guardados («Buscar agentes y preajustes»). Las opciones usadas recientemente aparecen primero y llevan la marca «Último utilizado».

El selector muestra dónde se creará la sesión. Cuando hay una sesión guardada activa, elija «Mismo nivel» para crear la nueva sesión junto a ella o «Sesión secundaria» para crearla debajo. Mientras el campo de búsqueda tiene el foco:

  • Tab alterna entre «Mismo nivel» y «Sesión secundaria».
  • ↑ y ↓ seleccionan un resultado; Enter crea la sesión.
  • Shift+Tab mueve el foco al control anterior; Escape cierra el selector.

También puede hacer clic en un resultado y elegir «Crear». Si no hay ningún proyecto disponible, seleccione uno o use antes «Abrir proyecto».

El selector tiene su propia dirección, que conserva el destino, la posición, el texto de búsqueda y la selección. Al copiar el enlace, actualizar la página o ir atrás y adelante, el selector se restaura sin crear ninguna sesión. Si la creación falla, el selector permanece abierto para que pueda volver a intentarlo.

10. Otras teclas

DóndeTeclaAcción
Vista de conversaciónEnter / Shift+EnterEnviar / nueva línea
Vista de conversación, mientras el agente trabaja⌥Enter (Alt+Enter)Añadir el mensaje al turno en curso
Vista de conversación, mientras el agente trabaja⌘Enter (Ctrl+Enter)Detener el turno y enviar este mensaje
Vista de conversación, mientras el agente trabajaEscDetener el turno
Tarjeta de confirmación de sesión hija⌘Enter (Ctrl+Enter)Iniciar la sesión
Barra de pestañasClic con el botón centralCerrar la pestaña
Barra lateral⌘/Ctrl+clic, Shift+clicSeleccionar varias sesiones o un intervalo