Manual de usuario de Claush

Primeros pasos

Claush es una aplicacion que te permite controlar Claude Code, el agente de codificacion IA mas avanzado del mundo, desde tu iPhone. Simplemente chatea con la IA usando una interfaz de mensajeria y gestiona todo, desde la codificacion hasta el despliegue, directamente desde tu telefono.

Requisitos

Como crear claves SSH

Si aun no tienes claves SSH, ejecuta los siguientes comandos en la terminal de tu PC para crearlas.

ssh-keygen -t ed25519 -C "your-email@example.com"

ssh-copy-id -i ~/.ssh/id_ed25519.pub username@server-ip-address

cat ~/.ssh/id_ed25519

Lista de servidores

Al abrir la aplicacion, se muestra la pantalla de lista de servidores. Cada servidor tiene dos botones.

El icono de engranaje (⚙️) en la parte superior izquierda abre la pantalla de ajustes generales de la aplicacion. El boton + en la parte superior derecha permite agregar un servidor.

Ajustes

Toca el icono de engranaje ⚙️ en la parte superior izquierda de la lista de servidores para abrir la pantalla de ajustes. Los ajustes estan organizados como un centro con cuatro categorias.

Perfil

Ve a Ajustes > Perfil para configurar la siguiente informacion. Las respuestas de la IA se adaptaran segun tu perfil.

• Nombre (apellido, nombre)
• Apodo
• Edad virtual
• Genero
• Experiencia en programacion: Seleccionar "Sin experiencia" hara que la IA evite la jerga tecnica y proporcione una guia mas amable

Generacion de imagenes IA

Ve a Ajustes > Personaje IA > seccion "Generacion de imagenes IA" para registrar una clave API para la generacion automatica de imagenes de personajes.

Una vez que la clave API este registrada y verificada correctamente, puedes alternar entre "Seleccionar imagen" y "Generar con IA" en la pantalla de creacion de personajes. Al elegir "Generar con IA" se muestran los ajustes de apariencia (genero, piel, tipo de cuerpo, edad, color de cabello, peinado) y un boton de vista previa.

Ajustes de idioma

Ve a Ajustes > Idioma para cambiar el idioma de la interfaz. Se admiten los siguientes 10 idiomas.

• Japones, Ingles, Chino, Coreano, Espanol
• Frances, Aleman, Portugues, Italiano, Arabe

El cambio de idioma se refleja inmediatamente en toda la interfaz. Puedes dar instrucciones a la IA en cualquier idioma.

Personajes IA

En Claush, puedes darle a la IA un nombre, estilo de habla y personalidad para crear "tu propio companero personal". Los personajes recuerdan las conversaciones y ajustan naturalmente su distancia emocional segun el nivel de afinidad.

Crear un personaje

Ve a Ajustes > Personaje IA > "Agregar personaje" para abrir la pantalla de creacion.

Detalles del personaje

Ve a Ajustes > Personaje IA > toca el nombre de un personaje para abrir la pantalla de detalles.

Informacion mostrada

• Imagen del personaje (subida manualmente / icono predeterminado. Se puede cambiar mediante "Cambiar imagen")
• Nombre y tipo
• Afinidad: 4 corazones (♡♡♡♡ a ❤️❤️❤️❤️) + puntuacion (0-100)
• Inventario: Objetos en posesion y un boton "Regalar"

Dar regalos

Selecciona un objeto del inventario y toca "Regalar" para regalarselo al personaje. Dar regalos aumenta la afinidad.

Tienda

Ve a Ajustes > Personaje IA > "Tienda" para abrir la pantalla de compra de objetos.

Puntos

Ganas 1 punto por cada mensaje de chat enviado. Los puntos son una moneda compartida entre todos los personajes. No hay compras dentro de la aplicacion.

Objetos

Hay 30 objetos en total en 6 categorias (5 por categoria). Los precios van de 10 a 100 puntos.

Sistema de afinidad

Dar objetos a un personaje aumenta su afinidad. A medida que la afinidad crece, la distancia emocional en las respuestas de Claude cambia naturalmente.

Agregar un servidor

Toca el boton + en la parte superior derecha de la pantalla de lista de servidores para agregar un servidor.

Crear un usuario dedicado

Conectate por SSH a tu servidor como root desde la terminal de tu PC y ejecuta los siguientes comandos. (Realiza esto en tu PC, no a traves de Claush.)

adduser claude

usermod -aG sudo claude

mkdir -p /home/claude/.ssh
cp ~/.ssh/authorized_keys /home/claude/.ssh/
chown -R claude:claude /home/claude/.ssh
chmod 700 /home/claude/.ssh
chmod 600 /home/claude/.ssh/authorized_keys

echo 'claude ALL=(ALL) NOPASSWD:ALL' > /etc/sudoers.d/claude

Una vez completado, especifica claude (el nombre de usuario creado) como nombre de usuario en la pantalla de configuracion de servidor de Claush.

Ajustes del servidor

Toca el boton ⚙️ en la lista de servidores para abrir la pantalla de ajustes. Consta de 4 secciones tipo acordeon.

Toca el boton redondo en el lado derecho de cada seccion para expandirla o contraerla. Despues de hacer cambios, toca "Guardar" en la parte superior derecha para aplicarlos.

Ajustes de memoria

La funcion de memoria permite que la IA recuerde el contenido de las conversaciones entre sesiones. Permite solicitudes como "continua donde lo dejamos ayer".

Tipos de base de datos

Pasos de configuracion

Ajustes de Claude

Seleccion de modelo

Selecciona el modelo de Claude a utilizar. Cada modelo difiere en rendimiento, velocidad y costo. El modelo seleccionado actualmente se indica con una marca de verificacion.

Acceso a archivos sensibles

Usa el interruptor para controlar el acceso de la IA a archivos sensibles como .env. El valor predeterminado es DESACTIVADO (acceso denegado).

Asignacion de personaje IA

Si se han creado personajes personalizados, puedes seleccionar que personaje asignar a este servidor. Una vez asignado, Claude respondera con el estilo de habla y la personalidad de ese personaje.

Ajustes de notificaciones

Recibe notificaciones cuando Claude termine de responder a traves de servicios externos. Esto te permite cambiar a otras tareas mientras las operaciones de larga duracion estan en progreso.

Plataformas soportadas

Necesitas obtener una URL de Webhook de cada servicio de antemano.

Fundamentos de sesion

Al tocar el boton de chat se conecta al servidor y se abre una pantalla con tres pestanas.

Disposicion de tres pestanas

Cambiar de pestana

Toca el boton ◀ en la parte superior derecha para expandir el selector de pestanas. Selecciona Chat / Terminal / Claude para cambiar de pestana.

Toca el icono del servidor a la izquierda de las pestanas para volver a la lista de servidores. La sesion tmux en el servidor sigue ejecutandose en segundo plano, por lo que puedes retomar tu trabajo al reconectarte.

Estado de la conexion

Verifica el estado de la conexion mediante el indicador en la parte superior izquierda.

Pestana Chat

Esta es la pantalla principal de Claush. Envia un mensaje y Claude Code responde, mostrandose como burbujas de chat.

Enviar mensajes

Introduce un mensaje en el campo de entrada en la parte inferior de la pantalla y toca el boton de envio ✈ a la derecha. Un indicador animado aparece mientras Claude procesa.

Visualizacion de mensajes

• Mensajes del usuario: Burbujas azules alineadas a la derecha
• Respuestas de Claude: Burbujas grises alineadas a la izquierda (con avatar cuando se ha configurado un personaje IA)
• Soporte Markdown: Los bloques de codigo incluyen resaltado de sintaxis y botones de copia

Menu de adjuntos

Toca el boton de menu ≡ a la izquierda del campo de entrada para mostrar las siguientes opciones.

Mensajes anteriores

Desplazate hasta la parte superior del chat y aparecera un boton "Cargar mensajes anteriores". Al tocarlo se cargan mensajes anteriores en lotes de 30.

Pestana Terminal

Un emulador de terminal completo que proporciona acceso directo al shell. Usalo para verificar archivos, operaciones Git, ejecutar comandos y mas.

Barra de teclas especiales

Los caracteres de control que son dificiles de escribir en el teclado estandar de iOS se pueden introducir con un solo toque desde la barra de teclas en la parte inferior de la pantalla.

Pestana Claude

Muestra la TUI (interfaz de usuario de texto) de Claude Code tal cual. Puedes ver los detalles de ejecucion de herramientas y los procesos de pensamiento en tiempo real que se omiten en la pestana Chat.

Tambien puedes escribir directamente en la pestana Claude, por lo que puedes ejecutar manualmente los comandos de barra de Claude Code (/clear, /cost, etc.).

Transferencia de archivos

Subida

Desde el menu de adjuntos del chat, toca "Seleccionar archivo" o "Seleccionar foto" para elegir un archivo. El archivo se sube a ~/claush-uploads/ en el servidor, y Claude recibe la notificacion correspondiente.

Descarga

Toca "Descargar archivo" en el menu de adjuntos para ver una lista de archivos en el directorio ~/claush-downloads/ del servidor. Toca un archivo para descargarlo a tu iPhone y aparecera una hoja para compartir.

Consejos y trucos

Divide el trabajo en piezas pequenas

Manten cada instruccion en una sola historia de usuario. Esto facilita la revision en la pantalla del telefono. Puedes verificar a nivel de PR, manteniendo la calidad mientras desarrollas a buen ritmo.

Verifica el progreso en la pestana Claude

Durante tareas de larga duracion, cambia a la pestana Claude para ver que esta sucediendo en tiempo real. Vuelve a la pestana Chat para ver los resultados como burbujas de chat.

Usa las notificaciones para trabajo asincrono

Con las notificaciones configuradas, las respuestas completadas de Claude llegan a Slack o Discord. Esto permite un estilo de desarrollo asincrono: envia una instruccion, cierra la aplicacion y haz otra cosa.

Lleva el contexto adelante con la memoria

Con la funcion de memoria activada, la IA recuerda el contenido de las sesiones anteriores. Puedes disfrutar de una experiencia de desarrollo natural con solicitudes como "continua desde ayer" o "lo que discutimos antes".

El trabajo continua en segundo plano

Gracias a la gestion de sesiones tmux, el trabajo del lado del servidor continua incluso despues de cerrar la aplicacion. Los resultados se recuperan automaticamente la proxima vez que abras la aplicacion.

Solucion de problemas

No se puede conectar

• Verifica que el host, puerto y nombre de usuario sean correctos
• Asegurate de que la clave privada se haya copiado exactamente desde -----BEGIN OPENSSH PRIVATE KEY----- hasta -----END OPENSSH PRIVATE KEY-----, incluyendo los saltos de linea
• Las conexiones con usuario root no estan soportadas. Crea un usuario dedicado
• La autenticacion keyboard-interactive no esta soportada. Usa autenticacion basada en claves

Claude Code no se inicia

• Verifica que se haya completado claude login en el servidor. Puedes ejecutarlo desde la pestana Terminal
• Verifica que el usuario tenga privilegios sudo (sin contrasena). Esto es necesario para la instalacion automatica

Sin respuesta

• Cambia a la pestana Claude para verificar el estado de la TUI de Claude Code
• Si el estado de conexion en la parte superior izquierda muestra "Reconectando", verifica tu conexion de red
• Si sigue sin haber respuesta despues de mucho tiempo, verifica directamente desde la pestana Claude o vuelve a la lista de servidores y reconectate

La configuracion de memoria falla

• Para PostgreSQL, verifica que la cadena de conexion comience con postgresql:// o postgres://
• Verifica que Node.js este instalado en el servidor (normalmente se instala automaticamente)
• Verifica que se pueda ejecutar sudo sin contrasena

Almacenamiento de personajes

Las definiciones de personajes se almacenan en tu iPhone (almacenamiento interno de la aplicacion). Al cambiar de dispositivo, restaura desde una copia de seguridad del iPhone.