¿Necesitas ayuda? Encuentra respuestas rápidas o contáctanos directamente.Need help? Find quick answers or contact us directly.Besoin d'aide ? Trouvez des réponses rapides ou contactez-nous directement.
Preguntas Frecuentes
Toca una pregunta para ver la respuesta.
No. ClaudeWatch es una herramienta local que no requiere cuenta, registro ni suscripción. Descarga la app, instala el servidor en tu Mac con un comando y empareja. Eso es todo.
No. ClaudeWatch establece una conexión directa entre tu iPhone y tu Mac dentro de tu red WiFi. No existe ningún servidor en la nube. Todo el tráfico de datos permanece en tu red local.
ClaudeWatch requiere iOS 16 o posterior. El Dynamic Island está disponible en iPhone 14 Pro, 14 Pro Max y todos los modelos posteriores con Dynamic Island.
El servidor de ClaudeWatch es un script de shell compatible con macOS 12 Monterey y posterior. Requiere que tengas Claude Code instalado en tu Mac. El servidor se instala en ~/Library/Application Support/ClaudeWatch/ y puede configurarse para iniciarse automáticamente con tu Mac.
Actualmente ClaudeWatch admite un dispositivo iPhone emparejado por Mac a la vez. El soporte para múltiples dispositivos está planificado para una versión futura.
Depende del tipo de VPN. Las VPN que enrutan todo el tráfico a través de un servidor remoto pueden interferir con la conexión local. Si tienes problemas, intenta desactivar la VPN mientras usas ClaudeWatch, o usa una VPN con split-tunneling que excluya el tráfico local.
Para desinstalar el servidor, ejecuta en Terminal:
Esto eliminará el servidor, el agente de LaunchAgent y todos los archivos de configuración.
Resolución de Problemas
Sigue estos pasos según el problema que experimentes.
🔍 El servidor no aparece en la app
Verifica que tu iPhone y tu Mac estén en la misma red WiFi.
En tu Mac ejecuta ~/Library/ClaudeWatch/claudewatch link. Ese comando levanta el servidor si hace falta y reabre la página de pairing.
Si ese comando no existe, vuelve a correr la instalación con curl -fsSL https://claudewatch-web.vercel.app/install.sh | bash. Pégalo completo y no uses sudo.
Revisa que el firewall de tu Mac no esté bloqueando el puerto 7432 (Preferencias del Sistema > Seguridad y Privacidad > Firewall).
Reinicia la búsqueda en la app arrastrando hacia abajo en la lista de dispositivos.
📡 La conexión se pierde frecuentemente
Asegúrate de que tu Mac no entre en modo de suspensión mientras usas la app (Ajustes del Sistema > Batería > Evitar suspensión).
Verifica que la señal WiFi sea estable en ambos dispositivos.
Si usas una red con bandas 2.4GHz y 5GHz separadas, conecta ambos dispositivos a la misma banda.
Reinicia el servidor con ~/Library/ClaudeWatch/claudewatch restart en Terminal.
📷 El código QR no se escanea
Verifica que hayas concedido permisos de cámara a ClaudeWatch en Ajustes > ClaudeWatch > Cámara.
Asegúrate de que haya buena iluminación y que el QR esté completamente visible en el visor.
Intenta limpiar la pantalla de tu Mac y alejar ligeramente el iPhone.
Como alternativa, usa la opción "Ingresar IP manualmente" en la pantalla de emparejamiento.
Si necesitas un QR nuevo, vuelve a abrir pairing con ~/Library/ClaudeWatch/claudewatch link.
🔔 No recibo notificaciones
Ve a Ajustes > Notificaciones > ClaudeWatch y asegúrate de que las notificaciones estén habilitadas.
Verifica que No Molestar o Enfoque no estén silenciando las notificaciones de ClaudeWatch.
En la app, revisa Ajustes > Notificaciones y asegúrate de que los tipos de alerta deseados estén activados.
Fuerza el cierre de la app y vuelve a abrirla para restablecer la conexión WebSocket.
⚡ El servidor no inicia al encender el Mac
Ejecuta claudewatch install-launchagent para instalar el inicio automático.
Verifica que el agente esté registrado: launchctl list | grep claudewatch.
Si ves un código de error diferente a 0, revisa los logs en ~/Library/Logs/ClaudeWatch/.
🔄 La app muestra datos desactualizados
Arrastra hacia abajo en la pantalla principal para forzar una actualización.
Verifica el indicador de estado en la esquina superior derecha — un punto rojo indica desconexión.
Si el indicador es verde pero los datos no se actualizan, toca el ícono de reconexión.
Reinicia tanto la app como el servidor y vuelve a conectar.
Contacto
Si los pasos anteriores no resuelven el problema, contáctanos. Respondemos en 24-48 horas hábiles.
No. ClaudeWatch is a local tool that requires no account, registration, or subscription. Download the app, install the server on your Mac with one command, and pair. That's it.
No. ClaudeWatch establishes a direct connection between your iPhone and your Mac within your WiFi network. There is no cloud server. All data traffic remains on your local network.
ClaudeWatch requires iOS 16 or later. The Dynamic Island feature is available on iPhone 14 Pro, 14 Pro Max, and all subsequent models with a Dynamic Island.
The ClaudeWatch server is a shell script compatible with macOS 12 Monterey and later. It requires Claude Code to be installed on your Mac. The server installs into ~/Library/Application Support/ClaudeWatch/ and can be configured to start automatically with your Mac.
Currently ClaudeWatch supports one paired iPhone per Mac at a time. Support for multiple devices is planned for a future release.
It depends on the VPN type. VPNs that route all traffic through a remote server can interfere with the local connection. If you experience issues, try disabling the VPN while using ClaudeWatch, or use a split-tunneling VPN that excludes local traffic.
This will remove the server, the LaunchAgent, and all configuration files.
Troubleshooting
Follow these steps based on the issue you're experiencing.
🔍 Server not appearing in app
Verify your iPhone and Mac are on the same WiFi network.
On your Mac run ~/Library/ClaudeWatch/claudewatch link. That command starts the server if needed and reopens the pairing page.
If that command is missing, rerun the installer with curl -fsSL https://claudewatch-web.vercel.app/install.sh | bash. Paste it exactly and do not use sudo.
Check that your Mac's firewall isn't blocking port 7432 (System Preferences > Security & Privacy > Firewall).
Restart the search in the app by pulling down on the device list.
📡 Connection drops frequently
Make sure your Mac doesn't sleep while using the app (System Settings > Battery > Prevent sleep).
Verify the WiFi signal is stable on both devices.
If using a network with separate 2.4GHz and 5GHz bands, connect both devices to the same band.
Restart the server with ~/Library/ClaudeWatch/claudewatch restart in Terminal.
📷 QR code won't scan
Check that you've granted camera permission to ClaudeWatch in Settings > ClaudeWatch > Camera.
Make sure there is good lighting and the QR is fully visible in the viewfinder.
Try cleaning your Mac screen and holding the iPhone slightly further away.
As an alternative, use the "Enter IP manually" option on the pairing screen.
If you need a fresh QR, reopen pairing with ~/Library/ClaudeWatch/claudewatch link.
🔔 Not receiving notifications
Go to Settings > Notifications > ClaudeWatch and make sure notifications are enabled.
Check that Focus or Do Not Disturb modes aren't silencing ClaudeWatch notifications.
In the app, check Settings > Notifications and make sure desired alert types are toggled on.
Force-quit the app and reopen it to reestablish the WebSocket connection.
⚡ Server doesn't start on Mac boot
Run claudewatch install-launchagent to install auto-start.
Verify the agent is registered: launchctl list | grep claudewatch.
If you see an error code other than 0, check logs at ~/Library/Logs/ClaudeWatch/.
🔄 App shows stale data
Pull down on the main screen to force a refresh.
Check the status indicator in the top right — a red dot means disconnected.
If the indicator is green but data isn't updating, tap the reconnect icon.
Restart both the app and the server and reconnect.
Contact
If the steps above don't resolve your issue, reach out. We respond within 24-48 business hours.
Non. ClaudeWatch est un outil local qui ne nécessite ni compte, ni inscription, ni abonnement. Téléchargez l'application, installez le serveur sur votre Mac avec une commande et associez. C'est tout.
Non. ClaudeWatch établit une connexion directe entre votre iPhone et votre Mac au sein de votre réseau WiFi. Il n'existe pas de serveur cloud. Tout le trafic de données reste sur votre réseau local.
ClaudeWatch nécessite iOS 16 ou ultérieur. La fonctionnalité Dynamic Island est disponible sur l'iPhone 14 Pro, 14 Pro Max et tous les modèles ultérieurs dotés d'un Dynamic Island.
Le serveur ClaudeWatch est un script shell compatible avec macOS 12 Monterey et ultérieur. Il nécessite que Claude Code soit installé sur votre Mac. Le serveur s'installe dans ~/Library/Application Support/ClaudeWatch/ et peut être configuré pour démarrer automatiquement avec votre Mac.
Actuellement, ClaudeWatch prend en charge un iPhone jumelé par Mac à la fois. Le support pour plusieurs appareils est prévu pour une version future.
Cela dépend du type de VPN. Les VPN qui acheminent tout le trafic via un serveur distant peuvent interférer avec la connexion locale. Si vous rencontrez des problèmes, essayez de désactiver le VPN pendant l'utilisation de ClaudeWatch, ou utilisez un VPN avec split-tunneling qui exclut le trafic local.
Pour désinstaller le serveur, exécutez dans Terminal :
Cela supprimera le serveur, le LaunchAgent et tous les fichiers de configuration.
Résolution de Problèmes
Suivez ces étapes selon le problème que vous rencontrez.
🔍 Le serveur n'apparaît pas
Vérifiez que votre iPhone et votre Mac sont sur le même réseau WiFi.
Sur votre Mac, exécutez ~/Library/ClaudeWatch/claudewatch link. Cette commande démarre le serveur si nécessaire et rouvre la page de jumelage.
Si cette commande n'existe pas, relancez l'installation avec curl -fsSL https://claudewatch-web.vercel.app/install.sh | bash. Collez-la entière et n'utilisez pas sudo.
Vérifiez que le pare-feu de votre Mac ne bloque pas le port 7432.
Relancez la recherche dans l'application en tirant vers le bas.
📡 La connexion se perd souvent
Assurez-vous que votre Mac ne se met pas en veille (Réglages Système > Batterie > Empêcher la veille).
Vérifiez que le signal WiFi est stable sur les deux appareils.
Connectez les deux appareils à la même bande (2.4GHz ou 5GHz).
Redémarrez le serveur avec ~/Library/ClaudeWatch/claudewatch restart.
📷 Le code QR ne se scanne pas
Vérifiez que vous avez accordé la permission d'accès à la caméra dans Réglages > ClaudeWatch > Caméra.
Assurez-vous d'une bonne luminosité et que le QR est entièrement visible.
Nettoyez l'écran de votre Mac et éloignez légèrement l'iPhone.
Utilisez l'option "Saisir l'IP manuellement" sur l'écran de jumelage.
Si vous avez besoin d'un nouveau QR, rouvrez le jumelage avec ~/Library/ClaudeWatch/claudewatch link.
🔔 Pas de notifications
Allez dans Réglages > Notifications > ClaudeWatch et activez les notifications.
Vérifiez que Concentration ou Ne pas déranger ne silencient pas ClaudeWatch.
Dans l'application, vérifiez Réglages > Notifications et activez les types d'alertes souhaités.
Forcez la fermeture de l'app et rouvrez-la.
Contact
Si les étapes ci-dessus ne résolvent pas votre problème, contactez-nous. Nous répondons sous 24 à 48 heures ouvrables.
✉️
Support par e-mail
Pour les bugs, questions techniques ou suggestions :