Código Claude 2.1: Una guía con ejemplos prácticos

Claude Code es una herramienta de codificación agente desarrollada por Anthropic que se ejecuta directamente en tu terminal y también puede funcionar a través de una interfaz web conectada. En lugar de trabajar con indicaciones aisladas, Claude Code comprende todo el repositorio, puede razonar entre archivos, editar código y ejecutar herramientas. 

En comparación con versiones anteriores, que se centraban principalmente en la asistencia interactiva para la programación, Claude Code 2.1 ofrece compatibilidad adicional con agentes, ganchos y habilidades reutilizables que pueden configurar de forma activa cómo y cuándo se producen los cambios en el código.

Claude Code está diseñado para programadores que desean contar con asistencia de IA integrada directamente en los flujos de trabajo reales, en lugar de tener que alternar entre un editor y una interfaz de usuario de chat. Aunque todavía se encuentra en fase de investigación preliminar, ya demuestra una gran utilidad práctica en los flujos de trabajo de desarrollo reales. 

Si deseas obtener más información sobre los modelos Claude, te recomiendo que realices el curso curso Introducción a los modelos Claude. 

¿Qué hay de nuevo en Claude Code 2.1?

Claude Code 2.1 mejora la experiencia básica del terminal con una serie de actualizaciones que hacen que los flujos de trabajo impulsados por agentes sean más flexibles. Estos cambios amplían la forma en que Claude Code razona sobre un código base y cómo interactuáis con él durante las tareas de desarrollo reales.

Algunas de las novedades más destacadas de Claude Code 2.1 son:

• Ganchos de agente y habilidad en el prefacio, que permiten a los programadores aplicar comprobaciones y restricciones antes de que se apliquen las modificaciones del código.
• Soporte ampliado de habilidades con contexto bifurcado, recarga en caliente y definiciones de habilidades personalizadas, lo que hace que los flujos de trabajo reutilizables sean más flexibles y potentes.
• La invocación de la habilidad Slash (/) permite acceder rápidamente a las acciones que se utilizan con frecuencia durante las sesiones interactivas.
• Los agentes de Claude Code 2.1 ya no dejan de razonar cuando se deniega la invocación de una herramienta, lo que permite que los flujos de trabajo continúen sin interrupciones.
• La herramienta admite respuestas controladas por el idioma, lo que resulta especialmente útil para la documentación multilingüe, las revisiones y la colaboración en equipo.
• Los permisos de herramientas comodín, como Bash(*-h*), proporcionan controles de automatización más precisos.
• La CLI ahora admite Shift+Enter para entradas multilínea, lo que mejora la experiencia de creación interactiva sin necesidad de configuraciones adicionales.

En esta guía, nos centramos en una serie de experimentos prácticos que demuestran cómo se aplican estas nuevas capacidades en proyectos del mundo real.

Configuración de Claude Code Experiencia web basada en la nube

Claude Code 2.1 está disponible como una experiencia basada en la web que se ejecuta íntegramente en la nube. Este modo resulta especialmente útil para flujos de trabajo colaborativos, revisiones de solicitudes de extracción y automatización a nivel de repositorio sin necesidad de una configuración local.

Paso 1: Inicia sesión y accede a Claude Code.

Para empezar, ve a https://claude.ai/code y accederás a la interfaz de Claude Code (vista previa de investigación). 

Paso 2: Conecta Claude Code a GitHub

Para trabajar con repositorios reales, Claude Code necesita acceso a GitHub. Haz clic en Conectar con GitHub, lo que instalará la aplicación Claude GitHub. 

Durante la autorización, GitHub solicitará permiso para conectarse a los repositorios mediante:

• Verificación de tu identidad en GitHub
• Ver a qué repositorios puede acceder Claude
• Actuar en tu nombre (por ejemplo, crear ramas o confirmaciones).

Puedes elegir entre:

• Todos los repositorios, o
• Selecciona solo repositorios (recomendado para un control más estricto)

Los permisos típicos incluyen:

• Acceso de lectura a los metadatos y comprobaciones del repositorio.
• Acceso de lectura y escritura a código, incidencias, solicitudes de extracción y flujos de trabajo.

Haz clic en Instalar y autorizar, y podrás modificar o revocar el acceso más tarde directamente desde la configuración de la aplicación de GitHub. Este paso es necesario para que Claude Code pueda leer repositorios, abrir solicitudes de extracción y enviar confirmaciones cuando se trabaja en el entorno web.

Paso 3: Crear un entorno en la nube

Antes de iniciar tu primera sesión, Claude Code te solicita que crees un entorno en la nube. Este entorno controla el acceso a la red y los límites de ejecución de Claude.

Las opciones disponibles incluyen:

• Ninguno: Esta opción no tiene acceso a Internet, lo que resulta útil principalmente para garantizar la máxima seguridad.
• De confianza (recomendado): Proporciona acceso a fuentes de paquetes verificadas.
• Completo: Esta configuración proporciona acceso ilimitado a Internet.

En la mayoría de los casos, la opción « Trusted » (Aceptar todos los sitios) ofrece el mejor equilibrio entre seguridad y flexibilidad.

Paso 5: Iniciar una sesión web

Una vez completada la configuración, se te redirigirá al editor web de Claude Code, tal y como se muestra en la siguiente captura de pantalla.

Desde aquí, puedes:

• Selecciona un repositorio y una rama.
• Ejecutar refactorizaciones y revisiones
• Crear nuevas ramas y confirmaciones
• Reanudar sesiones anteriores (si las hay)
• Cambiar entre repositorios sin cambiar de entorno

Configuración de la experiencia CLI basada en terminal de Claude Code

La CLI es la forma más directa de trabajar con Claude Code 2.1. Es ideal para el desarrollo local, refactorizaciones paso a paso y situaciones en las que deseas un control minucioso sobre lo que Claude hace en tu repositorio.

Paso 1: Instalación

Claude Code se puede instalar directamente desde el terminal utilizando un instalador específico para cada plataforma.

macOS, Linux, WSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Una vez completada la instalación, deberías ver un mensaje de confirmación que indica la versión de Claude Code junto con la ruta de instalación. Para obtener más opciones de configuración, puedes consultar la guía de configuración oficial.

Paso 2: Primeros pasos

Después de la instalación, ve a la raíz de tu proyecto e inicia Claude Code:

cd your-project-directory
Claude Code

Cuando Claude Code se inicia, escanea inmediatamente el repositorio y crea una comprensión inicial del código base. 

Este contexto inicial permite a Claude Code razonar de forma más eficaz en pasos posteriores.

Experimentando con Claude Code 2.1

Para esta demostración, he utilizado uno de mis proyectos de GPT 5.2. Aquí tienes una breve descripción general del proyecto.

Una vez que Claude Code tenga acceso a todos los archivos y carpetas dentro de la carpeta, podremos empezar a experimentar.

Refactoriza utilizando habilidades de contexto bifurcadas. 

Como parte de la evaluación de Claude Code 2.1, realicé una refactorización de todo el repositorio para mejorar el proceso. Este experimento destaca las habilidades con contexto bifurcado, donde Claude puede razonar a través de múltiples archivos en lugar de realizar ediciones aisladas en un solo archivo.

Indicación:

Refactor the CSV parsing and slide generation logic across the repository.
Improve readability, split responsibilities, and avoid duplicated logic.

Claude primero genera un plan de refactorización detallado, que incluye la estructura del módulo propuesta, los puntos de duplicación y una secuencia de implementación, y luego solicita tu aprobación antes de realizar cualquier cambio. 

Una vez que lo apruebas, Claude aplica la refactorización de forma incremental, mostrando las diferencias y el progreso a medida que avanza.

Con Claude Code, logré las siguientes mejoras:

• Divide las responsabilidades entre los módulos: Claude separó la carga de CSV, las transformaciones, la creación de Excel, la generación de PowerPoint y la planificación de LLM (básicamente todos los módulos) en componentes específicos.
• Reducción de la lógica duplicada: Centralizó las utilidades repetidas (como la detección de columnas y el formato) y trasladó las constantes compartidas a una capa de configuración común.
• Mejora de la facilidad de mantenimiento: Claude también redujo el tamaño de app.py, manteniendo al mismo tiempo la coherencia del comportamiento externo de la aplicación.

A continuación se muestra una comparación de la estructura del proyecto y el resultado de la refactorización antes y después de los cambios.

Antes:

Después:

Finalmente, probé la misma refactorización en Claude Code Web. La diferencia clave es el flujo de trabajo:

• CLI avanza paso a paso con aprobaciones explícitas.
• La web puede enviar la refactorización directamente a una nueva rama, lo que resulta muy práctico para la colaboración y los flujos de trabajo basados en relaciones públicas.

Finalmente, Claude refactorizó y envió el código a una rama.

Gancho de validación previa a la edición

Los flujos de datos suelen fallar por una sencilla razón: el esquema CSV de entrada no coincide con lo que espera el código. En Claude Code 2.1, puedes reducir este tipo de fallos utilizando ganchos de preedición. Esta nueva función permite a un agente realizar comprobaciones de validación antes de que Claude pueda modificar el código.

En este ejemplo, le pedí a Claude Code que creara un agente que validara la estructura CSV antes de aplicar cualquier edición.

Prompt:

Create a Claude Code agent that validates the CSV schema before modifying any code. The agent should reject edits if the CSV schema is unclear.

Claude Code generó primero un agente de validación de esquemas CSV y lo conectó al flujo de trabajo para que pudiera actuar como guardián. La salida de la CLI muestra que Claude no solo creó un único script, sino que montó un pequeño sistema de validación que incluye:

• Módulo validador de esquemas básicos que comprueba las columnas obligatorias, los valores que faltan y la coherencia básica.
• Un gancho de control previo a la edición ejecuta automáticamente la validación antes de que se proceda a la edición.
• Por último, un conjunto de pruebas y algunos ejemplos de uso para verificar el validador en casos CSV válidos e inválidos.

En la práctica, el flujo de trabajo se simplifica:

• Claude ejecuta automáticamente comprobaciones de esquema antes de realizar cualquier cambio en el código, lo que garantiza una condición previa.
• Si el esquema no está claro o no es válido, el agente bloquea las ediciones y devuelve mensajes de error procesables para guiar la corrección.
• Una vez superada la validación, Claude procede con las modificaciones, manteniendo los cambios predecibles y basados en barreras de seguridad.

La salida web muestra un resultado similar, pero con una diferencia clave. Claude Code Web puede enviar los cambios directamente a una nueva rama, incluyendo el módulo de validación, la integración de hooks, la documentación y las pruebas. 

En general, Claude Code 2.1 aplica medidas de protección antes de que se realicen las ediciones mediante la incorporación de ganchos directamente en los agentes y las habilidades. Esto hace que los hooks sean especialmente valiosos en proyectos con gran volumen de datos, donde la corrección de las entradas suele ser una fuente de errores mayor que el propio código.

Habilidades de comandos de barra para tareas repetitivas

Claude Code 2.1 introdujo habilidades de comandos de barra reutilizables, que son flujos de trabajo autónomos que pueden invocarse de forma interactiva dentro de una sesión de Claude o ejecutarse directamente desde la línea de comandos. 

En este ejemplo, creamos una habilidad reutilizable de /generate-slides que convierte un archivo CSV en una presentación profesional de PowerPoint.

Prompt:

Create a reusable skill called /generate-slides that converts a CSV into a PPT.

Consejo: Utiliza /statusline para configurar una línea de estado personalizada que aparecerá debajo del indicador de entrada (útil para mostrar el repositorio, la rama o el modo).

Claude Code genera una definición completa de habilidades en .claude/skills/, incluyendo documentación, lógica de validación y un punto de entrada ejecutable en Python.

• Creación de habilidades: Claude escribe una habilidad generate-slides completamente documentada, en la que describe su finalidad, entradas, pasos de validación y flujo de ejecución.
• Validación del esquema: La habilidad valida el esquema CSV antes de cualquier procesamiento, lo que garantiza la calidad de los datos y mensajes de error claros.
• Ejecución: La habilidad se puede ejecutar directamente desde el terminal, comportándose como una herramienta de línea de comandos independiente.
• Gestión de errores: Los archivos que faltan, los esquemas no válidos o las claves API que faltan dan lugar a errores claros y susceptibles de ser corregidos.
• Automatización: Un solo comando genera artefactos de Excel, gráficos y una presentación de PowerPoint.

Puedes probar la habilidad localmente con:

python .claude/skills/generate-slides.py --csv-file kpis.csv

Nota: Asegúrate de añadir tu clave API antes de ejecutar esto. 

Las habilidades de comandos de barra inclinada convierten a Claude Code en un motor de flujo de trabajo, no solo en un asistente. En lugar de volver a solicitar la misma tarea repetidamente, la defines una vez y la reutilizas en diferentes proyectos, sesiones y entornos. A continuación, puedes observar la estructura actualizada del repositorio, que refleja la incorporación de la nueva habilidad.

Este ejemplo muestra cómo:

• Las habilidades se pueden invocar de forma interactiva desde la CLI.
• Las habilidades generadas por Claude se integran perfectamente con los códigos base existentes.

Salida controlada por el idioma 

Claude Code 2.1 se puede configurar para responder en un idioma específico, lo que resulta útil para equipos multilingües, documentación localizada y tutoriales de código que no estén en inglés. En este ejemplo, le pedimos a Claude que explicara el proceso de generación de diapositivas del repositorio íntegramente en japonés.

Prompt:

Explain the slide generation logic in Japanese.

Claude respondió en japonés y ofreció una explicación estructurada del flujo de principio a fin. Como se muestra en el resultado, no solo tradujo un resumen, sino que también dividió el proceso en fases claras y hizo referencia a los módulos relevantes involucrados en cada paso. La salida de la CLI muestra:

• De principio a fin en japonés: La respuesta se mantiene íntegramente en japonés, incluidos los títulos y las viñetas.
• Flujo paso a paso: Claude divide el proceso en etapas diferenciadas (validación CSV, procesamiento de datos, cuaderno de trabajo de Excel, planificación LLM y creación de diapositivas).
• Referencias conscientes del código base: Señala los archivos y directorios relevantes mientras explica lo que hace cada componente.
• Formato de estilo documental: El resultado se lee como documentos internos, lo que facilita su reutilización en un archivo README o en una guía de incorporación.

Nota: Solo he probado este comportamiento en la CLI para este ejemplo, pero la misma capacidad de control del lenguaje forma parte de Claude Code 2.1 en general.

Se trata de una pequeña función sobre el papel, pero en la práctica supone una gran ventaja en términos de productividad cuando la documentación y las revisiones deben realizarse en idiomas distintos del inglés.

Comandos de Claude Code 2.1

Aquí tienes algunos comandos para que pruebes con Claude Code.

Conclusión

En esta guía, hemos explorado Claude Code 2.1 mediante la realización de experimentos prácticos tanto en la CLI como en los flujos de trabajo web. Utilizamos Claude Code para refactorizar un repositorio existente utilizando habilidades de contexto bifurcadas, aplicar garantías de datos con ganchos de validación previos a la edición, crear habilidades de comandos de barra reutilizables y generar explicaciones controladas por el lenguaje directamente desde el código base.

Estos ejemplos ponen de relieve cómo Claude Code 2.1 va más allá de la simple edición asistida por IA hacia flujos de trabajo de desarrollo más impulsados por agentes. Aunque Claude Code 2.1 aún se encuentra en fase de investigación preliminar, ya ha demostrado tener un gran valor práctico en proyectos reales.