← Volver al listado de tecnologías ← Índice de Spacecake

Capitulo 20: Troubleshooting y Tips

Por: Artiko
spacecaketroubleshootingtipsproductividad

Capitulo 20: Troubleshooting y Tips

< Volver al Indice del Tutorial

Problemas comunes y soluciones

”Permission denied” en macOS

Al abrir Spacecake por primera vez en macOS, el sistema puede bloquear la ejecucion por tratarse de una aplicacion descargada fuera de la App Store.

Solucion: ve a System Settings -> Privacy & Security. Busca el mensaje sobre Spacecake y haz click en “Allow Anyway” o “Open Anyway” para permitir que se ejecute.

Algo se ve mal en el editor

Si el editor muestra contenido con formato incorrecto, elementos desalineados o renderizado incompleto:

Solucion: presiona Cmd+R (macOS) o Ctrl+R (Windows/Linux) para refrescar la aplicacion completa. Esto recarga todos los componentes y resuelve la mayoria de problemas visuales.

Si el problema persiste en rich mode, cambia a source mode para ver el markdown crudo. Esto te permite identificar si el problema esta en el contenido del archivo o en el renderizado del editor.

Terminal no coincide con el tema

Despues de cambiar entre los temas light y dark, el terminal integrado puede mantener los colores del tema anterior.

Solucion: presiona Cmd+R (macOS) o Ctrl+R (Windows/Linux) para recargar la aplicacion. Alternativamente, cierra y reabre Spacecake. Este es un issue conocido que sera corregido en futuras versiones. El terminal usa Ghostty como motor de renderizado y la sincronizacion de temas entre el editor y el terminal requiere un reload completo.

File watching lento en Linux/Windows

Si Spacecake tarda en detectar cambios en archivos o no los detecta en proyectos grandes:

Solucion: instala watchman para mejorar el rendimiento del file watching. Consulta la guia de instalacion en https://facebook.github.io/watchman/docs/install.

Spacecake muestra un tip en el status bar cuando detecta que watchman no esta instalado y podria beneficiar tu proyecto. Si ves ese mensaje, sigue la recomendacion.

Claude Code “IDE disconnected”

Si Claude Code pierde la conexion con Spacecake y muestra “IDE disconnected”:

Solucion:

  1. Ejecuta /ide en el prompt de Claude Code.
  2. Verifica que spacecake aparece en la lista de IDEs disponibles.
  3. Selecciona spacecake para reconectar.

Si spacecake no aparece en la lista, verifica que la aplicacion esta corriendo y que la configuracion de IDE en ~/.claude/settings.json es correcta.

”No status line data”

Si el panel de tareas o el status line de Claude Code no muestran informacion:

Solucion:

  1. Verifica que Spacecake esta corriendo.
  2. Verifica que ~/.claude/settings.json tiene la configuracion correcta de statusLine (ver capitulo 15 para los detalles de configuracion).
  3. Reinicia Claude Code despues de cualquier cambio en la configuracion.

La conexion entre Claude Code y Spacecake depende de que ambos esten corriendo y configurados correctamente. Si cambiaste algo en la configuracion, el reinicio es necesario para que los cambios tomen efecto.

Debugging avanzado

Para diagnosticar problemas que no se resuelven con las soluciones anteriores, puedes abrir Chrome DevTools desde dentro de Spacecake. Esto te da acceso a:

Los console logs son especialmente utiles para reportar bugs. Si encuentras un error reproducible, copia los logs relevantes de la consola y adjuntalos al reporte de issue.

Tips de productividad

Usa Ctrl+G inmediatamente cuando Claude genera un plan

No esperes a que Claude termine de explicar. En cuanto genera el plan, abrelo con Ctrl+G en el editor visual. Ahi puedes leerlo con mejor formato, editarlo y aprobarlo mas rapido que leyendo texto plano en el terminal.

Manten un CLAUDE.md actualizado en cada proyecto

El archivo CLAUDE.md es lo primero que Claude lee en cada sesion. Un CLAUDE.md bien mantenido reduce la cantidad de instrucciones que necesitas repetir. Incluye comandos de desarrollo, convenciones de codigo, estructura del proyecto y cualquier regla que Claude deba seguir.

Usa autosave para no perder cambios

Activa autosave en los workspace settings si editas archivos frecuentemente. Evita la perdida accidental de cambios cuando cambias de pestaña o de contexto.

Usa quick open en lugar de navegar el arbol

Presiona Cmd+P (macOS) o Ctrl+P (Windows/Linux) para buscar archivos por nombre. Es significativamente mas rapido que expandir carpetas en el sidebar, especialmente en proyectos con muchos directorios anidados.

Aprovecha los slash commands del editor

Los comandos de barra (/) del editor WYSIWYG aceleran la escritura:

Escribe / en el editor para ver la lista completa de comandos disponibles.

Para profundizar en Claude Code

Este tutorial cubre Spacecake como herramienta de escritorio. Para profundizar en Claude Code como agente de desarrollo, consulta el tutorial completo de Claude Code que cubre permisos, hooks, MCP servers, skills, modelos y proveedores.

Recursos

< Volver al Indice del Tutorial

← Volver al listado de tecnologías ← Índice de Spacecake