Claude Code: La Guía Completa de Desarrollo con AI

Claude Code es la herramienta CLI oficial de Anthropic para desarrollo de software con AI. A diferencia de los asistentes de codificación basados en chat, Claude Code opera como una herramienta agéntica que puede leer tu codebase completo, ejecutar comandos en terminal, editar archivos y orquestar workflows complejos de múltiples pasos — todo desde una sola sesión de terminal.

Se instala como un paquete npm y se ejecuta dentro de tu terminal, conectando directamente con la API de Claude. El diferenciador clave es que entiende tu proyecto holísticamente: lee tu configuración CLAUDE.md, respeta tus estándares de código y aprende de la arquitectura de tu proyecto para entregar cambios contextualmente precisos.

Claude Code soporta múltiples modos de operación: chat interactivo, modo headless para CI/CD, modo plan para revisión de arquitectura, y orquestación multi-agente para tareas de desarrollo en paralelo. Se integra con VS Code y JetBrains IDEs manteniendo la terminal como interfaz principal.

El método de instalación recomendado desde octubre 2025 es el instalador nativo. Ya no se necesita Node.js:

En el primer arranque, Claude Code se autentica vía tu cuenta Anthropic o API key. Crea un directorio ~/.claude/ para configuración global y memoria. Para organizaciones, la autenticación gestionada vía SSO está disponible a través de la Consola de Anthropic.

CLAUDE.md es el archivo más importante en cualquier proyecto con Claude Code. Funciona como el conjunto de instrucciones persistente que define cómo Claude interactúa con tu codebase. Piénsalo como un documento vivo que codifica los estándares de tu equipo, decisiones de arquitectura y preferencias de workflow.

Claude Code lee archivos CLAUDE.md desde múltiples niveles en una jerarquía estricta: organización (~/.claude/org/CLAUDE.md, gestionado por admins), usuario (~/.claude/CLAUDE.md), raíz del proyecto, y subdirectorios anidados. Cada subdirectorio puede tener su propio CLAUDE.md que agrega contexto para ese módulo. Además, un directorio .claude/rules/ puede contener múltiples archivos .md que se cargan como instrucciones suplementarias, habilitando organización modular de reglas.

Un buen CLAUDE.md debería incluir:

• Resumen del proyecto y arquitectura
• Stack tecnológico y restricciones de versión
• Estándares de código (convenciones de nombres, estructura de archivos, patrones de manejo de errores)
• Requisitos de testing (expectativas TDD, umbrales de cobertura, estructura de tests)
• Workflow de Git (nombres de ramas, formato de mensajes de commit, template de PR)
• Definiciones de skills personalizados y cuándo usarlos
• Patrones prohibidos (cosas que Claude nunca debe hacer)
• Instrucciones específicas por ambiente (dev, staging, producción)

Los skills son plantillas de prompts reutilizables almacenadas como archivos Markdown en .claude/skills/. Cuando se invocan vía comandos slash (ej: /skill:deploy), inyectan instrucciones especializadas en el contexto de Claude. Los skills convierten workflows repetitivos de múltiples pasos en operaciones de un solo comando.

Cada skill es un archivo Markdown con frontmatter YAML opcional para metadatos como description, args (parámetros tipados que el usuario pasa al invocar), y allowed-tools. Los skills soportan estructuras de directorios anidados para organización (ej: .claude/skills/deploy/staging.md) y pueden tener tres alcances: usuario (~/.claude/skills/), proyecto (.claude/skills/), y organización (gestionado vía configuraciones enterprise).

Claude Code viene con skills integrados que puedes usar inmediatamente: /simplify (reducir complejidad de código), /batch (aplicar cambios en múltiples archivos), /debug (debugging sistemático con prueba de hipótesis), /loop (ejecutar tareas recurrentes), y /review (revisión de código estructurada). Sirven tanto como herramientas útiles como plantillas para crear tus propios skills.

Los hooks son comandos shell o scripts que se ejecutan automáticamente en puntos específicos durante la operación de Claude Code. Permiten puertas de calidad automatizadas sin intervención manual. Se configuran en .claude/settings.json y se ejecutan antes o después de llamadas a herramientas.

Claude Code soporta 24+ puntos de eventos de hooks organizados en categorías:

• PreToolUse / PostToolUse — Se ejecutan antes/después de cualquier llamada a herramienta. Usa matchers para apuntar a herramientas específicas (ej: solo disparar en Edit o Bash). Soporta wildcards como mcp__* para todas las herramientas MCP.
• SessionStart — Se ejecuta cuando comienza una sesión. Ideal para validación de ambiente, chequeo de dependencias o carga de estado del proyecto.
• UserPromptSubmit — Se dispara después de enviar un prompt pero antes de que Claude lo procese. Permite modificación de input, enriquecimiento de prompts o filtrado de contenido.
• Stop — Se ejecuta cuando Claude termina su turno. Usa para validación final, notificaciones o generación de resumen.
• Notification — Triggers basados en eventos para integraciones externas (Slack, email, webhooks).
• SubagentStart — Se dispara cuando se genera un subagente. Usa para configurar permisos específicos del subagente o inyectar contexto.

Los hooks soportan cuatro tipos: shell (ejecutar comando bash), HTTP (llamar a un webhook), LLM (invocar otro modelo para validación), y agent (generar un subagente). Los códigos de salida controlan el comportamiento: 0 = proceder, 1 = bloquear la acción, 2 = modificar el input y reintentar. Los hooks asíncronos se ejecutan sin bloquear el flujo principal, útiles para logging y notificaciones.

Adiciones recientes al sistema de eventos de hooks incluyen: StopFailure (se dispara cuando el turno de Claude termina por un error), PostCompact (corre después de la compactación de contexto), Elicitation / ElicitationResult (se dispara alrededor de diálogos de elicitación MCP), y WorktreeCreate / WorktreeRemove (se dispara cuando se crean o eliminan worktrees). Los hooks HTTP son ahora un tipo de hook de primera clase junto con los hooks shell.

El Model Context Protocol (MCP) extiende las capacidades de Claude Code conectándose a fuentes de datos externas y herramientas a través de interfaces de servidor estandarizadas. Los servidores MCP exponen herramientas, recursos y prompts que Claude puede invocar durante su operación.

Los servidores MCP se conectan vía tres transportes: stdio (proceso local, el más común), SSE (server-sent events sobre HTTP), y HTTP streamable (streaming bidireccional). La configuración vive en .claude/settings.json a nivel proyecto, usuario u organización. Con 50+ servidores de la comunidad disponibles, Claude puede acceder prácticamente a cualquier servicio externo. Usa la búsqueda de herramientas integrada (ToolSearch) para descubrir herramientas MCP disponibles en tiempo de ejecución — Claude carga esquemas de herramientas bajo demanda en vez de cargar todas las herramientas de entrada.

Elicitación MCP: Los servidores MCP ahora pueden solicitar input estructurado del usuario durante una tarea vía diálogos interactivos. Dos modos soportados: campos de formulario (inputs de texto, dropdowns, checkboxes renderizados inline) y URL de navegador (abre una URL para flujos OAuth o formularios complejos). Esto permite que las herramientas MCP recolecten credenciales, confirmen acciones destructivas o recopilen parámetros sin romper el bucle agéntico.

MCP Apps, lanzada como GA en enero 2026, es la primera extensión oficial de MCP que permite a las herramientas devolver componentes de UI interactivos directamente dentro de la conversación. En vez de recibir solo respuestas de texto, Claude Code ahora puede renderizar dashboards, gráficos, formularios, visualizaciones 3D, mapas y visualizadores de documentos inline -- potenciado por servidores MCP que exponen recursos de UI vía el esquema URI ui://.

Cuando una herramienta MCP incluye un campo _meta.ui.resourceUri en su respuesta, Claude Code obtiene el recurso de UI referenciado y lo renderiza en un iframe sandboxeado. La app y el host se comunican bidireccionalmente vía JSON-RPC 2.0 sobre postMessage, permitiendo a la UI solicitar llamadas de herramientas, actualizar contexto y recibir datos en vivo. Toda la UI corre en un sandbox de seguridad -- sin acceso a la ventana padre y sin requests de red arbitrarios.

Esto cambia el modelo de interacción significativamente: en vez de que Claude describa datos en texto, puede mostrar un gráfico interactivo que el usuario manipula directamente. Un resultado de consulta de base de datos se convierte en una tabla ordenable. Un estado de deployment se convierte en un dashboard en vivo. La AI sigue orquestando el workflow, pero la experiencia de usuario gana una dimensión visual e interactiva.

Los subagentes son instancias independientes de Claude Code generadas por un agente padre para manejar subtareas específicas. Vienen en dos modos: foreground (bloquea al padre hasta completar, devuelve resultados inline) y background (corre independientemente, notifica al completar). Cada subagente opera en un contexto aislado con sus propios permisos de herramientas y ventana de contexto, previniendo interferencia entre tareas.

Puedes definir tipos de agentes personalizados como archivos Markdown en .claude/agents/. Cada archivo define la persona del agente, herramientas permitidas y restricciones de comportamiento. Los tipos de agentes integrados incluyen el agente de Tarea (propósito general), agente de Investigación (exploración solo lectura), y agente de Revisión (análisis de código). Los subagentes heredan la configuración CLAUDE.md y MCP del padre pero pueden sobrescribir configuraciones específicas.

Los equipos de agentes llevan esto más lejos con coordinación multi-sesión: múltiples agentes comparten una lista de tareas, envían mensajes entre pares, y pueden perseguir hipótesis competidoras. Por ejemplo, dos agentes podrían probar diferentes enfoques para una optimización de rendimiento; el padre evalúa ambos resultados y elige al ganador.

Patrones clave para workflows multi-agente:

• Fan-out / Fan-in — El padre genera N agentes para tareas paralelas, recolecta resultados y los sintetiza
• Pipeline — Los agentes trabajan secuencialmente, cada uno construyendo sobre la salida del anterior
• Equipos especialistas — Agente frontend, agente backend y agente de testing trabajan en paralelo en cambios relacionados
• Hipótesis competidoras — Múltiples agentes prueban diferentes soluciones; el mejor resultado gana

El modo plan (Shift+Tab para alternar) cambia Claude Code a un modo de análisis solo lectura con pensamiento extendido habilitado. Claude no puede editar archivos ni ejecutar comandos; solo puede leer, buscar y razonar. Esto fuerza un análisis más profundo y produce planes de implementación de mayor calidad. Tú revisas el plan y apruebas explícitamente antes de que Claude ejecute cambios.

Los worktrees proveen aislamiento a nivel git para trabajo paralelo. Cada worktree es un checkout separado de tu repositorio en una rama diferente, con su propio directorio de trabajo. Claude Code crea sesiones por rama vinculadas a cada worktree, así el contexto y el historial quedan aislados. Múltiples agentes pueden trabajar en diferentes features simultáneamente sin conflictos de merge durante el desarrollo.

La combinación de modo plan y worktrees crea un workflow poderoso: usa modo plan para descomponer una feature grande en tareas, luego genera agentes en worktrees separados para implementar cada tarea en paralelo. Mergea resultados cuando todos los agentes completen.

Mejoras recientes de worktrees incluyen: la flag CLI --worktree (-w) para lanzar directamente en un worktree, isolation: worktree en definiciones de agentes para creación automática de worktree por agente, y configuración worktree.sparsePaths para monorepos grandes para hacer checkout solo de los directorios que cada agente necesita.

Claude Code se integra con VS Code, JetBrains IDEs (IntelliJ, WebStorm, PyCharm), la app de Escritorio independiente, Slack y Chrome vía extensiones oficiales. Cada superficie de integración provee acceso context-aware a todas las capacidades de Claude Code.

En VS Code, la extensión agrega un panel lateral con chat, una integración de terminal que automáticamente provee contexto de archivos, y previews de diff inline para cambios propuestos. En JetBrains, una ventana de herramientas similar se integra con las funciones de refactoring y navegación del IDE. La app de Escritorio provee una interfaz independiente para usuarios que quieren Claude Code sin abrir terminal o IDE. La integración con Slack permite que miembros del equipo interactúen con Claude Code desde canales, disparando builds, revisiones o consultas. La extensión de Chrome conecta el contexto de navegación web a sesiones de Claude Code.

A pesar del soporte de IDE, muchos usuarios avanzados (incluyendo Jose) prefieren la experiencia pura de terminal. La terminal provee iteración más rápida, scripting más fácil y mejor compatibilidad con workflows headless y CI/CD.

Claude en GitHub Copilot: Desde el 26 de febrero de 2026, Claude está disponible como opción de modelo dentro de GitHub Copilot para usuarios Business y Pro. Funciona en github.com, GitHub Mobile y VS Code — dándole a los developers el razonamiento de Claude directamente dentro de la interfaz familiar de Copilot.

Claude Code ofrece tres modos de permisos que controlan qué operaciones puede realizar Claude sin aprobación explícita:

• Modo por defecto — Pide aprobación para editar archivos, ejecutar comandos y llamadas a herramientas MCP. El más seguro para aprender.
• Auto-aceptar ediciones — Permite modificaciones de archivos sin preguntar pero sigue pidiendo para ejecución de comandos. Buen balance para usuarios experimentados.
• YOLO / Saltear Permisos — Modo sin restricciones. Claude ejecuta todo sin preguntar. Solo recomendado en contenedores o ambientes sandboxed.

Más allá de los tres modos, los permisos se pueden configurar por herramienta usando reglas específicas con soporte de wildcards. Por ejemplo, permite Bash(git *) para auto-aprobar todos los comandos git mientras sigues pidiendo aprobación para otras operaciones shell. Usa wildcards mcp__* para permitir todas las herramientas de un servidor MCP específico. Los permisos gestionados permiten que admins de la organización apliquen políticas de permisos a todos los miembros del equipo, previniendo que developers escalen a modo YOLO en codebases de producción.

El sandbox agrega una segunda capa de defensa: restricciones de filesystem limitan acceso a directorios del proyecto, restricciones de red bloquean llamadas salientes no autorizadas, y restricciones de subprocesos previenen comandos de sistema peligrosos. Juntos, permisos y sandboxing aseguran que Claude opere dentro de límites seguros.

Claude Code incluye un marketplace de plugins con cientos de plugins comunitarios en múltiples marketplaces. Instala extensiones con /plugin install nombre@marketplace. Explora con /plugin. El marketplace incluye: plugins de Code Intelligence LSP, integraciones MCP preconfiguradas (GitHub, GitLab, Jira, Slack) y plugins de automatización de workflows. Los plugins se actualizan automáticamente y tienen tres alcances: usuario, proyecto y local. Gestiona agentes y plugins instalados con el comando CLI claude agents.

Los Canales de Claude Code te permiten controlar sesiones de Claude Code a través de servidores MCP conectados a plataformas de mensajería — empezando con Telegram y Discord. Claude lee eventos del canal y responde por el mismo canal, convirtiendo tu app de mensajería favorita en una interfaz de desarrollo.

Esto es un game-changer para workflows asíncronos. Puedes mantener el desarrollo avanzando mientras estás lejos de tu terminal: revisa diffs desde tu celular, aprueba deployments desde un servidor de Discord, o monitorea el progreso de agentes en background a través de notificaciones de Telegram. Los Canales conectan las sesiones de terminal con la movilidad de la mensajería moderna.

Canales es actualmente una función de Research Preview. Funciona conectando Claude Code a un servidor MCP que hace de puente con la API de la plataforma de mensajería. Los mensajes que envías en el canal se rutean a la sesión activa de Claude Code, y las respuestas de Claude se postean de vuelta en el mismo hilo.

Control Remoto (/remote-control o claude rc) conecta Claude Code con claude.ai/code para continuidad entre dispositivos. Inicia una sesión en tu terminal, luego controla sin problemas desde la interfaz web o la app móvil de Claude en iOS y Android. Pausa el trabajo en CLI, retoma en el navegador o en tu celular. Las ediciones de archivos se sincronizan automáticamente. Las sesiones se nombran automáticamente.

La app móvil de Claude (disponible en iOS y Android) lleva el control remoto al siguiente nivel. Revisa diffs, aprueba cambios de archivos y monitorea el progreso de agentes desde tu celular. Combinado con Canales, puedes gestionar todo tu workflow de desarrollo desde cualquier lugar — sin laptop.

Claude Opus 4.6 y Sonnet 4.6 soportan ventanas de contexto de 1M de tokens con pensamiento extendido. Opus 4.6: 64k de salida (128k máx), ideal para arquitectura compleja. Configura el esfuerzo con /effort: Bajo (○), Medio (◐), Alto (●). Selecciona tu modelo en cualquier momento con /model. El contexto de 1M permite cargar codebases completos simultáneamente.

Desde junio 2026, el contexto de 1M con los modelos Opus (4.6 a 4.8) y Claude Fable 5 está incluido sin costo adicional de uso en planes Max, Team y Enterprise — Opus se actualiza a contexto de 1M automáticamente, sin configuración requerida. Esto significa sesiones más largas, menos compactaciones y significativamente más espacio para contexto del codebase — todo sin preocuparte por cargos adicionales de tokens. Esto mejora dramáticamente la experiencia para sesiones largas de agentes y tareas de refactoring a gran escala.

Sonnet 4.6 (lanzado el 17 de febrero de 2026) entrega calidad de nivel flagship a 1/5 del costo de Opus, con pensamiento adaptativo y contexto de 1M. Es el modelo por defecto para la mayoría de tareas de Claude Code. Haiku 3 está deprecado y se retira el 19 de abril de 2026 — usa Haiku 4.5 en su lugar.

Claude Opus 4.7 (lanzado el 16 de abril de 2026) fue el modelo flagship hasta mayo de 2026. Alcanza 64.3% en SWE-bench Pro (frente al 53.4% de Opus 4.6), el puntaje verificado más alto para cualquier modelo en ese benchmark. Opus 4.7 introduce un nuevo nivel de esfuerzo de razonamiento xhigh entre high y max, dando control más fino sobre la profundidad de pensamiento sin pagar el costo total de max. La resolución de visión aumenta a 2,576px máximo (3x el límite anterior), mejorando dramáticamente el rendimiento en screenshots, diagramas y fotos de pizarras de arquitectura. Los precios se mantienen sin cambios en $5/$25 por MTok (entrada/salida). Opus 4.6 sigue disponible vía /model para sesiones donde prefieres su comportamiento.

Opus 4.7 está disponible en todos los canales de despliegue: la API de Anthropic, Amazon Bedrock, Google Cloud Vertex AI y el recién agregado Microsoft Foundry. Esto significa que organizaciones usando cualquiera de estos proveedores cloud pueden acceder a estos modelos a través de su infraestructura y facturación existente. Para usuarios de Claude Code en planes Max, Team y Enterprise, Opus 4.7 es accesible inmediatamente vía /model con la misma ventana de contexto de 1M sin costo adicional de uso.

Claude Opus 4.8 (lanzado el 28 de mayo de 2026) sucedió a 4.7 como el flagship Opus: misma superficie de API y precios, mejor ejecución agéntica de largo horizonte y code review, y ahora usa esfuerzo high por defecto en Claude Code (usa /effort xhigh para las tareas más difíciles). El modo Fast en Opus 4.8 cuesta 2x la tarifa estándar por aproximadamente 2.5x la velocidad. Claude Fable 5 (lanzado el 9 de junio de 2026, con Claude Code v2.1.170) es el nuevo modelo top-tier de clase Mythos por encima de Opus, con precio de $10/$50 por MTok y contexto de 1M incluido por defecto. Selecciona cualquiera de ellos con /model.

Precios de API: Los precios cambian frecuentemente. Consulta los precios actuales en anthropic.com/pricing.

v2.1.173 (11 de junio de 2026) es la versión actual. v2.1.170 (9 de junio) introdujo acceso a Claude Fable 5; v2.1.169 agregó --safe-mode y el comando /cd; v2.1.154 (28 de mayo) trajo soporte de Opus 4.8 con esfuerzo high por defecto y /effort xhigh. v2.1.119 (24 de abril): Agrega prUrlTemplate para URLs de code-review personalizadas y expande --from-pr para aceptar URLs de GitLab y Bitbucket además de GitHub. Corrige contenido CRLF insertando líneas en blanco extras y problemas de paste multilínea en kitty. v2.1.118 (23 de abril): Modo visual Vim (v) y modo visual-line (V) con selección, operadores y feedback visual. Crea y cambia entre temas personalizados desde /theme, o edita archivos JSON en ~/.claude/themes/. Unificó /cost y /stats en /usage. Los hooks ahora pueden invocar herramientas MCP directamente via type: "mcp_tool". Nueva variable DISABLE_UPDATES. v2.1.117 (22 de abril): /resume en sesiones grandes hasta 67% más rápido (sesiones de 40MB+). Subagentes forked vía CLAUDE_CODE_FORK_SUBAGENT=1. Mejor persistencia de modelo entre reinicios y arranque MCP acelerado. Hitos anteriores: v2.1.110 (22 de abril) hizo el modo Auto disponible para suscriptores Max sin --enable-auto-mode; v2.1.101 (10 de abril) agregó /team-onboarding; v2.1.98 (9 de abril) introdujo wizard de Vertex AI, herramienta Monitor y sandbox de procesos hijo; v2.1.92 (4 de abril) agregó wizard de Bedrock y selector de versión en /release-notes. Incluye lecciones interactivas /powerup y 60% más rápido en cómputo de diff del Write tool para archivos grandes.

Anthropic lanzó Anthropic Academy, una plataforma de formación oficial con cursos estructurados para herramientas Claude. El curso Claude Code in Action cubre gestión de contexto, comandos y skills personalizados, configuración de servidores MCP y automatización de workflows de GitHub. Es el punto de partida recomendado para developers nuevos en Claude Code.

Además, el programa Claude Community Ambassadors conecta una red global de usuarios avanzados de Claude que organizan eventos, comparten workflows y contribuyen al ecosistema. Los embajadores organizan meetups locales, workshops online y contribuyen skills y servidores MCP open-source que benefician a toda la comunidad de Claude Code.

Los costos de Claude Code escalan con el uso de tokens. Entender y optimizar el consumo de tokens es crítico para adopción sostenible. Acá van estrategias probadas en batalla:

La plataforma es un SaaS de gestión fitness con 26 microservicios, 41 apps Android de marca y facturación multi-país. Jose usa Claude Code como herramienta principal de desarrollo para esta plataforma, demostrando cómo se ve el desarrollo con AI a escala.

Cada interacción con Claude Code sigue un bucle agéntico de tres fases: Recopilar, Actuar y Verificar. Entender este bucle es clave para escribir prompts efectivos y obtener resultados consistentes.

En la fase de Recopilar, Claude lee tu CLAUDE.md, escanea archivos relevantes, busca en el codebase con Grep y Glob, y construye un modelo mental de la tarea. En la fase de Actuar, ejecuta cambios: edita archivos, corre comandos, genera subagentes o llama herramientas MCP. En la fase de Verificar, confirma que los cambios funcionan: ejecuta tests, revisa la salida del linter, revisa diffs y valida contra tus requisitos.

El bucle se autocorrige. Si la verificación falla, Claude vuelve a Actuar con el contexto del error y reintenta. Por eso los archivos CLAUDE.md bien estructurados con criterios de éxito claros importan: le dan a Claude objetivos de verificación precisos.

Claude Code mantiene un sistema de memoria persistente a través de archivos MEMORY.md. A diferencia del historial de chat por sesión, la memoria sobrevive entre sesiones y conversaciones. El índice de memoria en ~/.claude/projects/<proyecto>/memory/MEMORY.md sirve como referencia central.

La memoria se organiza en cuatro tipos:

• Memoria de usuario — Tu rol, preferencias y estilo de trabajo (ej: "prefiere terminal sobre IDE," "usa conjugación con vos en español")
• Memoria de feedback — Correcciones que le diste a Claude y persisten (ej: "nunca dejar trabajo incompleto," "probar manualmente antes de automatizar")
• Memoria de proyecto — Notas de arquitectura, pasos de troubleshooting y patrones específicos del proyecto aprendidos con el tiempo
• Memoria de referencia — Links, punteros a documentación y contexto externo que Claude debería recordar

La auto-memoria se activa cuando Claude aprende algo importante durante una sesión. Escribe un nuevo archivo .md en el subdirectorio de memoria apropiado y actualiza el índice MEMORY.md. También puedes agregar memorias manualmente con /memory.

Claude Code corre en un ambiente sandboxed que restringe acceso al filesystem, requests de red y ejecución de subprocesos. Esto previene daño accidental a tu sistema y limita el radio de impacto de cualquier error.

Tres capas de sandboxing protegen tu sistema:

• Sandbox de filesystem — Claude solo puede acceder archivos dentro del directorio del proyecto y paths explícitamente permitidos. No puede leer /etc/passwd, tus claves SSH u otros archivos sensibles del sistema.
• Sandbox de red — Los requests de red salientes están restringidos por defecto. Servidores MCP y dominios explícitamente permitidos pueden bypasear esto, pero Claude no puede hacer llamadas HTTP arbitrarias.
• Sandbox de subprocesos — Los comandos corren en un shell restringido. Operaciones peligrosas como rm -rf / están bloqueadas. El sistema de permisos gatea qué comandos puede ejecutar Claude.

Para máximo aislamiento, ejecuta Claude Code dentro de contenedores Docker o VMs. Los deployments enterprise frecuentemente usan contenedores efímeros que se destruyen después de cada sesión.

Claude Code puede ejecutar tareas en segundo plano mientras sigues trabajando. Los subagentes en background operan independientemente, y recibes notificaciones cuando completan. Es ideal para operaciones de larga duración como suites de tests, refactors grandes o tareas de generación de código.

El comando /loop habilita tareas programadas y recurrentes. Puedes configurar que Claude ejecute chequeos periódicos: lintear el codebase cada hora, ejecutar la suite de tests después de cada cambio de archivo, o monitorear logs por errores. Los loops corren como procesos en background y reportan resultados asíncronamente.

Desde junio 2026, las tareas programadas están disponibles en el CLI, la app de Escritorio de Claude, y como Routines en la nube en la web. En la app de escritorio, puedes configurar tareas recurrentes a través de una interfaz visual — sin necesidad de terminal. Las Routines en la nube corren en infraestructura gestionada por Anthropic y pueden activarse por horario, por llamadas API o por eventos de GitHub, así que siguen funcionando con la laptop cerrada. Ejemplos incluyen actualizar documentación semanalmente, resumir PRs abiertos todos los lunes por la mañana, o ejecutar escaneos de seguridad cada noche.

Las tareas en background comparten el mismo modelo de permisos que las operaciones en foreground. Respetan tu CLAUDE.md, usan los mismos servidores MCP y producen los mismos logs de auditoría. La única diferencia es que no bloquean tu terminal.

El modo no interactivo (headless) permite que Claude Code corra sin input humano, haciéndolo ideal para pipelines CI/CD, revisiones de código automatizadas y procesamiento en lote. Invócalo con claude --print para consultas de un solo disparo o pipea input vía stdin.

Patrones comunes de CI/CD incluyen:

• Revisiones automáticas de PR — Dispara Claude Code en cada pull request para revisar diffs, chequear problemas de seguridad y postear comentarios
• Generación de código — Generar boilerplate, clientes de API o documentación como parte de pipelines de build
• Scripts de migración — Ejecutar Claude en modo headless para aplicar transformaciones en todo el codebase (ej: actualizar todos los componentes React de clases a hooks)
• Generación de tests — Generar automáticamente tests unitarios para paths de código sin tests detectados por herramientas de cobertura

El modo headless respeta todos los permisos y sandboxing. Usa --dangerously-skip-permissions solo en ambientes confiables y aislados como contenedores CI efímeros.

La flag --bare provee un arranque mínimo para scripts CI/CD: saltea hooks, inicialización LSP y sincronización de plugins para arranques en frío más rápidos. Requiere que ANTHROPIC_API_KEY esté configurada. Combina con --print para integraciones livianas en pipelines.

Integración con GitHub Actions: La action oficial claude-code-action habilita revisión automatizada de PRs y manejo de issues directamente en workflows de GitHub. Configura rápidamente vía /install-github-app. Soporta autenticación con API de Anthropic, Amazon Bedrock, Google Vertex AI y Microsoft Foundry.

Las sesiones de Claude Code persisten tu historial de conversación, resultados de herramientas y contexto de trabajo. Puedes retomar sesiones anteriores, ramificarlas (/branch, antes /fork) en nuevas ramas de exploración y nombrarlas para fácil recuperación.

Operaciones clave de sesión:

• Retomar — claude --resume continúa tu sesión más reciente con todo el contexto intacto
• /branch (antes /fork) — Crea una nueva sesión ramificando desde cualquier punto de una sesión existente, preservando contexto hasta ese punto
• Sesiones con nombre — claude --session "feature-auth" crea o retoma una sesión nombrada para trabajo organizado de largo plazo
• Sincronización multiplataforma — Las sesiones almacenadas localmente se pueden referenciar desde terminal, VS Code e integraciones de JetBrains

Las sesiones se almacenan en ~/.claude/projects/<proyecto>/sessions/. Cada sesión trackea la conversación completa, snapshots de archivos y el historial de checkpoints para soporte de rebobinado.

La flag --from-pr te permite retomar una sesión vinculada a un pull request específico. Referencia por número de PR (claude --from-pr 123) o URL completa. Claude carga el contexto del PR — diff, comentarios y estado de revisión — directamente en la sesión.

Claude Code provee atajos de teclado personalizables para interacción eficiente en terminal. Los shortcuts aceleran operaciones comunes y reducen fricción durante sesiones largas de codificación.

Atajos esenciales:

• Shift+Tab — Alternar entre modo Plan y modo Acción
• Esc (simple) — Cancelar generación actual / interrumpir a Claude
• Esc+Esc (doble) — Rebobinar al último checkpoint, deshaciendo todos los cambios de archivos desde ese punto
• Ctrl+C — Salir de la operación actual gracefully
• Ctrl+L — Limpiar pantalla preservando la sesión

Claude Code soporta keybindings estilo chord (secuencias de múltiples teclas) y modo vim para usuarios que prefieren edición modal en el área de input. Personaliza los bindings en ~/.claude/settings.json bajo la clave keybindings.

Comandos interactivos adicionales agregados en releases recientes:

• /voice — Modo push-to-talk de voz (mantén presionada la barra espaciadora para hablar). El habla se transcribe en tiempo real. Disponible en planes Pro, Max, Team y Enterprise. Lanzado en marzo 2026.
• /btw — Pregunta rápida lateral sin interrumpir tu tarea principal. La respuesta aparece en un overlay y no se agrega al historial de conversación. Reutiliza el caché de prompt. Sin acceso a herramientas.
• /fast — Activa modo rápido para salida hasta 2.5x más veloz. Un ícono de rayo aparece cuando está activo. Desactiva ejecutando /fast de nuevo.

Claude Code opera dentro de una ventana de contexto finita (hasta 1M tokens dependiendo del modelo). Gestionar esta ventana es crítico para sesiones largas. Cuando el contexto se llena, Claude pierde acceso a partes anteriores de la conversación, llevando a errores repetidos o instrucciones olvidadas.

Estrategias de gestión de contexto:

• /compact — Comprime el historial de conversación resumiendo intercambios anteriores, liberando espacio de contexto
• /context — Muestra el uso actual de contexto como porcentaje, ayudándote a decidir cuándo compactar o empezar de nuevo
• Auto-compactación — Claude compacta automáticamente cuando el contexto excede un umbral, preservando la información más relevante
• Subagentes enfocados — Delega tareas específicas a subagentes con ventanas de contexto limpias en vez de cargar todo en una sola conversación

El archivo CLAUDE.md siempre se inyecta al inicio de cada ventana de contexto, por eso mantenerlo conciso pero comprehensivo importa. Un CLAUDE.md de 500 líneas consume contexto en cada interacción.

Claude Code crea automáticamente snapshots de archivos (checkpoints) antes de hacer cambios. Estos checkpoints habilitan rollback instantáneo a cualquier estado previo sin depender de Git. Piénsalos como puntos de guardado automáticos durante tu sesión de codificación.

Operaciones de checkpoint:

• Creación automática — Se guarda un checkpoint antes de cada edición de archivo, ejecución de comando o lote de cambios
• Rebobinado Esc+Esc — Revertir instantáneamente todos los archivos al estado del checkpoint anterior
• Rollback selectivo — Elige a qué checkpoint específico rebobinar desde el historial de la sesión
• Preview de diff — Revisa qué cambió entre checkpoints antes de decidir si mantener o revertir

Los checkpoints se almacenan en el directorio de sesión y persisten al retomar sesiones. Son separados de los commits de Git, dándote una red de seguridad incluso para cambios experimentales no commiteados.

Claude Code incluye un sistema automatizado de revisión de código que analiza diffs, detecta problemas y genera feedback estructurado. Las revisiones pueden ejecutarse en cambios locales, commits staged o diffs de pull requests de GitHub y GitLab.

Las revisiones usan niveles de severidad:

• Crítico — Vulnerabilidades de seguridad, riesgos de pérdida de datos o cambios que rompen cosas y deben arreglarse antes del merge
• Advertencia — Problemas de rendimiento, code smells o preocupaciones de mantenibilidad que deberían abordarse
• Info — Sugerencias de estilo, mejoras de documentación o mejoras opcionales

Configura el comportamiento de revisión en un archivo REVIEW.md en la raíz del proyecto. Define qué debe verificar Claude: patrones de seguridad, antipatrones de rendimiento, cumplimiento de accesibilidad o mejores prácticas específicas del framework. Las revisiones se pueden disparar automáticamente vía hooks o CI/CD.

Anthropic ofrece VMs alojadas en la nube para ejecutar Claude Code sin restricciones de recursos locales. La ejecución en la nube provee cómputo dedicado, ambientes preconfigurados y aislamiento de red para workloads enterprise.

Características de ejecución en la nube:

• VMs de Anthropic — Máquinas virtuales gestionadas con Claude Code preinstalado, optimizadas para workflows de desarrollo con AI
• Scripts de setup — Define scripts de inicialización que se ejecutan cuando las VMs arrancan, instalando dependencias y configurando el ambiente
• Política de red — Controles de acceso de red granulares que permiten conexiones salientes específicas (ej: registro npm, Docker Hub) mientras bloquean todo lo demás
• Ambientes efímeros — Las VMs se crean por tarea y se destruyen al completar, asegurando estado limpio y cero persistencia de datos

La ejecución en la nube es particularmente útil para equipos de agentes paralelos: levanta 5 VMs, cada una ejecutando un agente especializado en un microservicio diferente, y mergea resultados cuando todos completen.

Mientras Claude Code se conecta a la API de Anthropic por defecto, también soporta proveedores de modelos de terceros para organizaciones con requisitos específicos de compliance, latencia o costos.

Proveedores soportados:

• Amazon Bedrock — Ejecuta modelos Claude a través de infraestructura AWS con aislamiento VPC, roles IAM y consolidación de facturación AWS
• Google Vertex AI — Accede a Claude vía Google Cloud con integración en el stack de seguridad y monitoreo de GCP
• Microsoft Foundry — Deploya Claude a través de Azure con integración de Active Directory y certificaciones de compliance de Azure. Usa CLAUDE_CODE_USE_FOUNDRY=1 y ANTHROPIC_FOUNDRY_RESOURCE para configurar.
• LiteLLM — Usa LiteLLM como proxy para rutear requests a través de cualquier endpoint compatible con OpenAI, habilitando routing personalizado, caching y estrategias de fallback

Configura proveedores con claude config set provider bedrock o vía variables de entorno. Cada proveedor soporta las mismas funciones de Claude Code; solo cambian la capa de transporte y la facturación.