Tutorial 3: Trabajando desde tu teléfono
Objetivo: tu iPhone recibe un empujón cuando Claude necesita información; tócalo, adjunte, responda.
El diseño estrecho del ccmux se adapta a un terminal del ancho de un teléfono: el TUI completo se colapsa en una vista de una sola columna diseñada para pantallas pequeñas.
Configuración (una sola vez)
ccmux moshi-setup
Esto instala moshi-hook, luego ejecuta moshi-hook host setup. Aparece un código QR en tu terminal. Abra el Aplicación para iOS Moshi, toque Agregar host → Escanear QR, apunte su teléfono al terminal. Hecho.
El asistente también conecta las entradas de enlace de Claude Code para que las notificaciones se activen automáticamente.
Cómo funciona
Después del emparejamiento:
- La aplicación Moshi enumera todas las sesiones de tmux en tu Mac
- Cuando Claude hace una pausa (
needs_input), su teléfono vibra con un push categorizado:approval_requiredotask_complete - Toque la notificación → selector Moshi → adjuntar → responder → deslizar
Reserva de BEL (no Moshi)
Un cliente de terminal puede admitir notificaciones locales para timbres de terminal. La disponibilidad depende del cliente, su configuración y si la conexión permanece activa. Esto es independiente de las notificaciones push nativas de Moshi.
Suprimir notificaciones duplicadas
De forma predeterminada, el timbre del portátil suena incluso cuando el Moshi está emparejado (complementario, no duplicado). Para silenciar la campana cuando Moshi está informando:
# ~/.config/ccmux/config.toml
[notifications]
moshi_suppresses_bell = true
Configuración sin cabeza/con script
ccmux moshi-setup --token <token>
Omite el flujo QR: útil para máquinas remotas sin pantalla.
Crea tu propio cliente móvil
ccmuxd expone un HTTP API: enumerar sesiones, conectarse a un terminal en vivo (un PTY con puente WebSocket), enviar claves, transmitir eventos, leer notas y uso, además de un flujo de emparejamiento + inserción (APN/FCM). El Moshi la aplicación es el camino móvil hoy en día; el mismo API está abierto para que cualquier cliente lo integre. Ver el HTTP API referencia.
Ayuda a mejorar ccmux
¿Encontraste un error, una guía poco clara o una traducción mejorable? Todas las aportaciones son bienvenidas. Abre una incidencia o envía una solicitud de incorporación de cambios.
¿Detectó un error o algo desactualizado? Editar esta página en GitHub.
