Capitulo 12: Conectar Claude Code

< Volver al Indice del Tutorial

Conexion automatica

Para conectar Claude Code a Spacecake, simplemente ejecuta claude desde el terminal integrado de Spacecake. No necesitas configurar nada adicional ni instalar extensiones.

La conexion es automatica: Claude Code detecta que esta corriendo dentro de Spacecake y se conecta via WebSocket sin intervencion del usuario.

claude

Eso es todo. Al ejecutar el comando, Claude Code inicia una sesion y Spacecake establece la conexion de forma transparente.

Indicadores de conexion

Spacecake muestra el estado de la conexion de forma visual:

• Badge verde “claude” en el header: indica que hay una sesion activa de Claude Code conectada a Spacecake.
• Sin badge: la sesion no esta conectada. Claude Code puede estar corriendo pero no se ha establecido la comunicacion con Spacecake.

El badge verde es la confirmacion visual mas rapida de que todo funciona correctamente.

Verificar la conexion

Si necesitas verificar el estado de la conexion de forma explicita, ejecuta el comando /ide dentro de Claude Code:

/ide

Deberias ver “spacecake” en la lista de IDEs conectados. Si en lugar de eso aparece “IDE disconnected”, selecciona spacecake en la lista para forzar la reconexion.

Comunicacion tecnica

Spacecake ejecuta un servidor WebSocket que implementa el protocolo de IDE de Claude Code. La comunicacion entre ambos funciona asi:

• Protocolo: JSON-RPC para el intercambio de mensajes estructurados.
• Transporte: WebSocket para comunicacion bidireccional en tiempo real.
• Ubicacion del socket: el servidor escucha en ~/.claude/ide/.

Cada vez que Claude Code necesita informacion del editor o Spacecake necesita enviar contexto a Claude, los mensajes viajan por este canal.

Diferencia con VS Code

En VS Code, la integracion con Claude Code requiere instalar una extension separada desde el marketplace. Despues de instalarla, debes configurarla y asegurarte de que la version sea compatible.

En Spacecake la integracion es nativa y automatica. No hay extension que instalar ni configurar. Spacecake fue disenado desde el principio para trabajar con Claude Code, por lo que el protocolo de comunicacion esta integrado en el nucleo de la aplicacion.

Multiples sesiones

Puedes tener multiples terminales con Claude Code corriendo simultaneamente dentro de Spacecake. Cada terminal establece su propia conexion independiente con Spacecake.

Esto es util cuando trabajas en tareas paralelas: puedes tener una sesion de Claude Code explorando codigo en un terminal mientras otra sesion implementa cambios en otro terminal diferente.

Troubleshooting

”IDE disconnected”

Si Claude Code muestra que el IDE esta desconectado:

1. Ejecuta /ide dentro de Claude Code.
2. Selecciona “spacecake” en la lista para reconectar.
3. Verifica que el badge verde aparezca en el header de Spacecake.

El badge no aparece

Verifica que Claude Code esta corriendo en el terminal integrado de Spacecake y no en un terminal externo. La conexion solo funciona cuando claude se ejecuta dentro del terminal de Spacecake.

Si estas usando un terminal externo (iTerm, Terminal.app, Ghostty independiente, etc.), Spacecake no puede detectar la sesion.

Reconexion

Si nada de lo anterior funciona:

1. Cierra la sesion actual de Claude Code con Ctrl+C o escribiendo /exit.
2. Vuelve a ejecutar claude en el terminal integrado de Spacecake.
3. Espera a que aparezca el badge verde en el header.

Profundizar en Claude Code

Para aprender mas sobre Claude Code, sus comandos, configuracion y flujos de trabajo avanzados, consulta el tutorial de Claude Code.

---

Siguiente: Capitulo 13: Context Awareness —>