Fuentes de Claude Code: Arquitectura CLI

Anatomía de Claude Code: Lo que revela el código fuente filtrado

El 31 de marzo de 2026, el código fuente de Claude Code se filtró a través de un sourcemap en un paquete npm. No es un checkout limpio de git, sino una instantánea recuperada de código del lado del cliente con transformaciones y archivos faltantes como assistant/index.ts o daemon/main.js. screens/REPL.tsx ya está compilado con React Compiler, y main.tsx conserva rastros de optimizaciones de lanzamiento: profileCheckpoint, precarga de keychain, lectura MDM en paralelo.

El código refleja una evolución desde una CLI simple a un sistema operativo de terminal. Las importaciones son dinámicas para carga diferida; --version se ejecuta sin dependencias. Pero la complejidad crece: daemon, control remoto, tmux, servidores MCP.

CLI como la fachada de un entorno de ejecución multimodal

entrypoints/cli.tsx es el centro de enrutamiento: --version, prompt del sistema, daemon, ejecutor de entorno, ejecutor autohospedado, ps/logs/attach/kill. Las importaciones dinámicas minimizan la evaluación: los workers son ligeros. Las rutas rápidas no cargan módulos pesados, reduciendo memoria y riesgos de fallos.

Ventaja: optimización de arranque. Desventaja: conocer todos los modos hace que la CLI parezca un aeropuerto. La carga diferida salva el día, pero la estructura es intimidante.

// Ejemplo de cli.tsx
if (fastPath) {
  // cero importaciones más allá de este archivo
  console.log(version);
  process.exit(0);
}

main.tsx: El centro de gravedad del sistema

main.tsx es el punto de convergencia: inicialización, selección de modo, pool de herramientas, flags de características, KAIROS/Proactivo, salida estructurada, recuperación de sesión. Ventaja: toda la lógica de ramificación en un solo lugar. Desventaja: compromisos como modo proactivo antes de getTools() para SleepTool.isEnabled().

La evolución es visible: de CLI a un sistema con flags y verificaciones. La escala engendra tales construcciones.

• Inicialización y selección de modo
• Prompt del sistema y pool de herramientas
• Flags de características y sesiones remotas
• Lanzamiento de UI y sesiones

React en la terminal: Ink y el frontend se combinan

Claude Code es una aplicación React sobre Ink. screens/REPL.tsx gestiona notificaciones, modales, integración con IDE, MCP, plugins, modo compañero de equipo, UI flotante, Buddy.

Sincroniza estado, filtra herramientas, mezcla plugins. No es un chat, sino un frontend en la terminal con hábitos similares a un navegador.

Orquestando agentes como infraestructura

No es un solo agente, sino un centro de control. AgentTool soporta:

• Lanzamiento síncrono/asíncrono
• Aislamiento en segundo plano y worktree
• Modos remoto y compañero de equipo
• Su propio pool de herramientas y modo de permisos
• Identidad de caché para prompt/herramientas

Agentes asíncronos con progreso, notificaciones. Worktree como parte de la ruta. Capacidades de agente maduras más allá de Promise.all.

El agente de exploración es limitado: solo lectura, sin escritura/eliminación/redirección/heredoc, enfocado en grep/lectura en paralelo. Un equilibrio entre autonomía y restricción.

Ejecución de herramientas: Concurrencia y tolerancia a fallos

Las herramientas se agrupan: solo lectura en paralelo, las arriesgadas—en serie. Un ejecutor de streaming con:

• Cancelación de hermanos en error
• user_interrupted vs sibling_error vs streaming_fallback
• Buffering para orden
• Manejo de interrupciones

El producto sobrevive a bloqueos y conflictos.

Bash sin autodestrucción: Paranoia de seguridad

bashPermissions y bashSecurity bloquean:

• Sustitución de comando/proceso
• Heredoc/iguales zsh
• zmodload/ztcp/zpty
• Flags ofuscados
• env/sudo/nice/timeout
• Espacios/escapado

Una capa madura contra mordeduras reales de shell desde LLMs.

El toque humano: Buddy y animaciones

buddy/ — sprites ASCII, bocadillos de diálogo, animaciones. Un compañero de terminal añade vida a la CLI.

Conclusiones clave:

• Importaciones dinámicas para arranque rápido de modos
• main.tsx como centro de orquestación con compromisos de escala
• Infraestructura de agente con aislamiento y ciclo de vida
• Llamadas a herramientas en paralelo/serie con manejo de errores
• Seguridad Bash contra ataques de shell
• React/Ink para UI de terminal con Buddy

— Editorial Team