Tutoriales

Esta guía proporciona tutoriales paso a paso para flujos de trabajo comunes con Claude Code. Cada tutorial incluye instrucciones claras, comandos de ejemplo y mejores prácticas para ayudarte a obtener el máximo provecho de Claude Code.

​

Tabla de contenidos

• Reanudar conversaciones anteriores
• Entender nuevas bases de código
• Corregir errores eficientemente
• Refactorizar código
• Trabajar con pruebas
• Crear solicitudes de extracción
• Manejar documentación
• Trabajar con imágenes
• Usar pensamiento extendido
• Configurar memoria del proyecto
• Configurar el Protocolo de Contexto del Modelo (MCP)
• Usar Claude como una utilidad de estilo unix
• Crear comandos personalizados con barra diagonal
• Ejecutar sesiones paralelas de Claude Code con Git worktrees

​

Reanudar conversaciones anteriores

​

Continúa tu trabajo sin problemas

Cuándo usar: Has estado trabajando en una tarea con Claude Code y necesitas continuar donde lo dejaste en una sesión posterior.

Claude Code proporciona dos opciones para reanudar conversaciones anteriores:

• --continue para continuar automáticamente la conversación más reciente
• --resume para mostrar un selector de conversaciones

claude --continue

claude --continue --print "Continuar con mi tarea"

claude --resume

Cómo funciona:

1. Almacenamiento de conversaciones: Todas las conversaciones se guardan automáticamente de forma local con su historial completo de mensajes
2. Deserialización de mensajes: Al reanudar, se restaura todo el historial de mensajes para mantener el contexto
3. Estado de las herramientas: Se conservan el uso de herramientas y los resultados de la conversación anterior
4. Restauración del contexto: La conversación se reanuda con todo el contexto anterior intacto

Consejos:

• El historial de conversaciones se almacena localmente en tu máquina
• Usa --continue para acceder rápidamente a tu conversación más reciente
• Usa --resume cuando necesites seleccionar una conversación específica anterior
• Al reanudar, verás todo el historial de la conversación antes de continuar
• La conversación reanudada comienza con el mismo modelo y configuración que la original

Ejemplos:

# Continuar la conversación más reciente
claude --continue

# Continuar la conversación más reciente con un prompt específico
claude --continue --print "Muéstrame nuestro progreso"

# Mostrar selector de conversaciones
claude --resume

# Continuar la conversación más reciente en modo no interactivo
claude --continue --print "Ejecutar las pruebas de nuevo"

​

Entender nuevas bases de código

​

Obtener una visión general rápida de la base de código

Cuándo usar: Te acabas de unir a un nuevo proyecto y necesitas entender rápidamente su estructura.

cd /ruta/al/proyecto 

claude 

> dame una visión general de esta base de código 

> explica los principales patrones de arquitectura utilizados aquí 

> ¿cuáles son los modelos de datos clave?

> ¿cómo se maneja la autenticación?

Consejos:

• Comienza con preguntas amplias, luego concéntrate en áreas específicas
• Pregunta sobre convenciones de codificación y patrones utilizados en el proyecto
• Solicita un glosario de términos específicos del proyecto

​

Encontrar código relevante

Cuándo usar: Necesitas localizar código relacionado con una característica o funcionalidad específica.

> encuentra los archivos que manejan la autenticación de usuarios 

> ¿cómo trabajan juntos estos archivos de autenticación? 

> rastrea el proceso de inicio de sesión desde el front-end hasta la base de datos 

Consejos:

• Sé específico sobre lo que estás buscando
• Usa el lenguaje de dominio del proyecto

​

Corregir errores eficientemente

​

Diagnosticar mensajes de error

Cuándo usar: Has encontrado un mensaje de error y necesitas encontrar y corregir su origen.

> Estoy viendo un error cuando ejecuto npm test 

> sugiere algunas formas de corregir el @ts-ignore en user.ts 

> actualiza user.ts para agregar la verificación de nulos que sugeriste 

Consejos:

• Dile a Claude el comando para reproducir el problema y obtener un rastreo de pila
• Menciona los pasos para reproducir el error
• Hazle saber a Claude si el error es intermitente o consistente

​

Refactorizar código

​

Modernizar código heredado

Cuándo usar: Necesitas actualizar código antiguo para usar patrones y prácticas modernas.

> encuentra uso de API obsoleta en nuestra base de código 

> sugiere cómo refactorizar utils.js para usar características modernas de JavaScript 

> refactoriza utils.js para usar características de ES2024 manteniendo el mismo comportamiento 

> ejecuta pruebas para el código refactorizado 

Consejos:

• Pide a Claude que explique los beneficios del enfoque moderno
• Solicita que los cambios mantengan la compatibilidad hacia atrás cuando sea necesario
• Haz la refactorización en incrementos pequeños y comprobables

​

Trabajar con pruebas

​

Agregar cobertura de pruebas

Cuándo usar: Necesitas agregar pruebas para código sin cobertura.

> encuentra funciones en NotificationsService.swift que no están cubiertas por pruebas 

> agrega pruebas para el servicio de notificaciones 

> agrega casos de prueba para condiciones límite en el servicio de notificaciones 

> ejecuta las nuevas pruebas y corrige cualquier fallo 

Consejos:

• Solicita pruebas que cubran casos límite y condiciones de error
• Solicita tanto pruebas unitarias como de integración cuando sea apropiado
• Haz que Claude explique la estrategia de pruebas

​

Crear solicitudes de extracción

​

Generar PRs completas

Cuándo usar: Necesitas crear una solicitud de extracción bien documentada para tus cambios.

> resume los cambios que he hecho al módulo de autenticación 

> crear un pr 

> mejora la descripción del PR con más contexto sobre las mejoras de seguridad 

> agrega información sobre cómo se probaron estos cambios 

Consejos:

• Pide directamente a Claude que haga un PR por ti
• Revisa el PR generado por Claude antes de enviarlo
• Pide a Claude que destaque riesgos potenciales o consideraciones

​

Manejar documentación

​

Generar documentación de código

Cuándo usar: Necesitas agregar o actualizar documentación para tu código.

> encuentra funciones sin comentarios JSDoc apropiados en el módulo auth 

> agrega comentarios JSDoc a las funciones sin documentar en auth.js 

> mejora la documentación generada con más contexto y ejemplos 

> verifica si la documentación sigue nuestros estándares del proyecto 

Consejos:

• Especifica el estilo de documentación que deseas (JSDoc, docstrings, etc.)
• Solicita ejemplos en la documentación
• Solicita documentación para APIs públicas, interfaces y lógica compleja

​

Trabajar con imágenes

​

Analizar imágenes y capturas de pantalla

Cuándo usar: Necesitas trabajar con imágenes en tu base de código u obtener ayuda de Claude para analizar el contenido de imágenes.

> ¿Qué muestra esta imagen? 
> Describe los elementos de UI en esta captura de pantalla 
> ¿Hay elementos problemáticos en este diagrama? 

> Aquí hay una captura del error. ¿Qué lo está causando? 
> Este es nuestro esquema actual de base de datos. ¿Cómo deberíamos modificarlo para la nueva característica? 

> Genera CSS para que coincida con este mockup de diseño 
> ¿Qué estructura HTML recrearía este componente? 

Consejos:

• Usa imágenes cuando las descripciones de texto serían poco claras o engorrosas
• Incluye capturas de errores, diseños de UI o diagramas para mejor contexto
• Puedes trabajar con múltiples imágenes en una conversación
• El análisis de imágenes funciona con diagramas, capturas de pantalla, mockups y más

​

Usar pensamiento extendido

​

Aprovechar el pensamiento extendido de Claude para tareas complejas

Cuándo usar: Cuando trabajas en decisiones arquitectónicas complejas, errores desafiantes o planificación de implementaciones de múltiples pasos que requieren razonamiento profundo.

> Necesito implementar un nuevo sistema de autenticación usando OAuth2 para nuestra API. Piensa profundamente sobre el mejor enfoque para implementar esto en nuestra base de código. 

> piensa sobre vulnerabilidades de seguridad potenciales en este enfoque 
> piensa más profundamente sobre casos límite que deberíamos manejar 

Consejos para obtener el máximo valor del pensamiento extendido:

El pensamiento extendido es más valioso para tareas complejas como:

• Planificar cambios arquitectónicos complejos
• Depurar problemas intrincados
• Crear planes de implementación para nuevas características
• Entender bases de código complejas
• Evaluar compensaciones entre diferentes enfoques

La forma en que solicitas el pensamiento resulta en diferentes niveles de profundidad de pensamiento:

• “piensa” activa el pensamiento extendido básico
• frases intensificadoras como “piensa más”, “piensa mucho”, “piensa más duro” o “piensa más tiempo” activan un pensamiento más profundo

Para más consejos sobre solicitar pensamiento extendido, consulta Consejos de pensamiento extendido.

​

Configurar memoria del proyecto

​

Crear un archivo CLAUDE.md efectivo

Cuándo usar: Quieres configurar un archivo CLAUDE.md para almacenar información importante del proyecto, convenciones y comandos frecuentemente utilizados.

> /init 

Consejos:

• Incluye comandos frecuentemente utilizados (build, test, lint) para evitar búsquedas repetidas
• Documenta preferencias de estilo de código y convenciones de nomenclatura
• Agrega patrones arquitectónicos importantes específicos de tu proyecto
• Las memorias de CLAUDE.md pueden usarse tanto para instrucciones compartidas con tu equipo como para tus preferencias individuales. Para más detalles, consulta Administrar la memoria de Claude.

​

Configurar el Protocolo de Contexto del Modelo (MCP)

El Protocolo de Contexto del Modelo (MCP) es un protocolo abierto que permite a los LLMs acceder a herramientas y fuentes de datos externos. Para más detalles, consulta la documentación de MCP.

​

Configurar servidores MCP

Cuándo usar: Quieres mejorar las capacidades de Claude conectándolo a herramientas especializadas y servidores externos usando el Protocolo de Contexto del Modelo.

# Sintaxis básica
claude mcp add <nombre> <comando> [args...]

# Ejemplo: Agregar un servidor local
claude mcp add mi-servidor -e API_KEY=123 -- /ruta/al/servidor arg1 arg2

# Sintaxis básica
claude mcp add --transport sse <nombre> <url>

# Ejemplo: Agregar un servidor SSE
claude mcp add --transport sse servidor-sse https://ejemplo.com/endpoint-sse

# Listar todos los servidores configurados
claude mcp list

# Obtener detalles de un servidor específico
claude mcp get mi-servidor

# Eliminar un servidor
claude mcp remove mi-servidor

Consejos:

• Usa la bandera -s o --scope para especificar dónde se almacena la configuración:
  • local (predeterminado): Disponible solo para ti en el proyecto actual (se llamaba project en versiones anteriores)
  • project: Compartido con todos en el proyecto a través del archivo .mcp.json
  • user: Disponible para ti en todos los proyectos (se llamaba global en versiones anteriores)
• Establece variables de entorno con las banderas -e o --env (por ejemplo, -e CLAVE=valor)
• Configura el tiempo de espera de inicio del servidor MCP usando la variable de entorno MCP_TIMEOUT (por ejemplo, MCP_TIMEOUT=10000 claude establece un tiempo de espera de 10 segundos)
• Verifica el estado del servidor MCP en cualquier momento usando el comando /mcp dentro de Claude Code
• MCP sigue una arquitectura cliente-servidor donde Claude Code (el cliente) puede conectarse a múltiples servidores especializados

​

Entender los ámbitos de servidores MCP

Cuándo usar: Quieres entender cómo funcionan los diferentes ámbitos de MCP y cómo compartir servidores con tu equipo.

# Agregar un servidor de ámbito local (predeterminado)
claude mcp add mi-servidor-privado /ruta/al/servidor

# Especificar explícitamente el ámbito local
claude mcp add mi-servidor-privado -s local /ruta/al/servidor

# Agregar un servidor de ámbito de proyecto
claude mcp add servidor-compartido -s project /ruta/al/servidor

{
  "mcpServers": {
    "servidor-compartido": {
      "command": "/ruta/al/servidor",
      "args": [],
      "env": {}
    }
  }
}

# Agregar un servidor de usuario
claude mcp add mi-servidor-usuario -s user /ruta/al/servidor

Consejos:

• Los servidores de ámbito local tienen prioridad sobre los servidores de ámbito de proyecto y de usuario con el mismo nombre
• Los servidores de ámbito de proyecto (en .mcp.json) tienen prioridad sobre los servidores de ámbito de usuario con el mismo nombre
• Antes de usar servidores de ámbito de proyecto desde .mcp.json, Claude Code te pedirá que los apruebes por seguridad
• El archivo .mcp.json está destinado a ser registrado en el control de versiones para compartir servidores MCP con tu equipo
• Los servidores de ámbito de proyecto facilitan asegurar que todos en tu equipo tengan acceso a las mismas herramientas MCP
• Si necesitas restablecer tus elecciones de qué servidores de ámbito de proyecto están habilitados o deshabilitados, usa el comando claude mcp reset-project-choices

​

Conectar a un servidor MCP de Postgres

Cuándo usar: Quieres dar a Claude acceso de solo lectura a una base de datos PostgreSQL para consultas e inspección de esquemas.

claude mcp add servidor-postgres /ruta/al/servidor-mcp-postgres --connection-string "postgresql://usuario:contraseña@localhost:5432/midb"

# En tu sesión de Claude, puedes preguntar sobre tu base de datos

> describe el esquema de nuestra tabla de usuarios
> ¿cuáles son los pedidos más recientes en el sistema?
> muéstrame la relación entre clientes y facturas

Consejos:

• El servidor MCP de Postgres proporciona acceso de solo lectura por seguridad
• Claude puede ayudarte a explorar la estructura de la base de datos y ejecutar consultas analíticas
• Puedes usar esto para entender rápidamente esquemas de base de datos en proyectos desconocidos
• Asegúrate de que tu cadena de conexión use credenciales apropiadas con los permisos mínimos requeridos

​

Agregar servidores MCP desde configuración JSON

Cuándo usar: Tienes una configuración JSON para un solo servidor MCP que quieres agregar a Claude Code.

# Sintaxis básica
claude mcp add-json <nombre> '<json>'

# Ejemplo: Agregar un servidor stdio con configuración JSON
claude mcp add-json api-clima '{"type":"stdio","command":"/ruta/al/cli-clima","args":["--api-key","abc123"],"env":{"CACHE_DIR":"/tmp"}}'

claude mcp get api-clima

Consejos:

• Asegúrate de que el JSON esté correctamente escapado en tu shell
• El JSON debe cumplir con el esquema de configuración del servidor MCP
• Puedes usar -s global para agregar el servidor a tu configuración global en lugar de la específica del proyecto

​

Importar servidores MCP desde Claude Desktop

Cuándo usar: Ya has configurado servidores MCP en Claude Desktop y quieres usar los mismos servidores en Claude Code sin reconfigurarlos manualmente.

# Sintaxis básica 
claude mcp add-from-claude-desktop 

claude mcp list 

Consejos:

• Esta característica solo funciona en macOS y Windows Subsystem for Linux (WSL)
• Lee el archivo de configuración de Claude Desktop desde su ubicación estándar en esas plataformas
• Usa la bandera -s global para agregar servidores a tu configuración global
• Los servidores importados tendrán los mismos nombres que en Claude Desktop
• Si ya existen servidores con los mismos nombres, obtendrán un sufijo numérico (por ejemplo, servidor_1)

​

Usar Claude Code como un servidor MCP

Cuándo usar: Quieres usar Claude Code mismo como un servidor MCP al que otras aplicaciones pueden conectarse, proporcionándoles las herramientas y capacidades de Claude.

# Sintaxis básica
claude mcp serve

{
  "command": "claude",
  "args": ["mcp", "serve"],
  "env": {}
}

Consejos:

• El servidor proporciona acceso a las herramientas de Claude como View, Edit, LS, etc.
• En Claude Desktop, intenta pedir a Claude que lea archivos en un directorio, haga ediciones y más.
• Ten en cuenta que este servidor MCP simplemente expone las herramientas de Claude Code a tu cliente MCP, por lo que tu propio cliente es responsable de implementar la confirmación del usuario para llamadas individuales a herramientas.

​

Usar Claude como una utilidad de estilo unix

​

Agregar Claude a tu proceso de verificación

Cuándo usar: Quieres usar Claude Code como un linter o revisor de código.

Pasos:

// package.json
{
    ...
    "scripts": {
        ...
        "lint:claude": "claude -p 'eres un linter. por favor mira los cambios vs. main y reporta cualquier problema relacionado con errores tipográficos. reporta el nombre del archivo y número de línea en una línea, y una descripción del problema en la segunda línea. no devuelvas ningún otro texto.'"
    }
}

​

Tubería de entrada, tubería de salida

Cuándo usar: Quieres canalizar datos hacia Claude y obtener datos de vuelta en un formato estructurado.

cat error-construccion.txt | claude -p 'explica concisamente la causa raíz de este error de construcción' > salida.txt

​

Controlar formato de salida

Cuándo usar: Necesitas la salida de Claude en un formato específico, especialmente cuando integras Claude Code en scripts u otras herramientas.

cat datos.txt | claude -p 'resume estos datos' --output-format text > resumen.txt

cat codigo.py | claude -p 'analiza este código en busca de errores' --output-format json > analisis.json

cat log.txt | claude -p 'analiza este archivo de registro en busca de errores' --output-format stream-json

Consejos:

• Usa --output-format text para integraciones simples donde solo necesitas la respuesta de Claude
• Usa --output-format json cuando necesitas el registro completo de la conversación
• Usa --output-format stream-json para salida en tiempo real de cada turno de conversación

​

Crear comandos personalizados con barra diagonal

Claude Code admite comandos personalizados con barra diagonal que puedes crear para ejecutar rápidamente prompts o tareas específicas.

​

Crear comandos específicos del proyecto

Cuándo usar: Quieres crear comandos con barra diagonal reutilizables para tu proyecto que todos los miembros del equipo puedan usar.

mkdir -p .claude/commands

echo "Analiza el rendimiento de este código y sugiere tres optimizaciones específicas:" > .claude/commands/optimize.md 

claude > /project:optimize 

Consejos:

• Los nombres de los comandos se derivan del nombre del archivo (por ejemplo, optimize.md se convierte en /project:optimize)
• Puedes organizar comandos en subdirectorios (por ejemplo, .claude/commands/frontend/component.md se convierte en /project:frontend:component)
• Los comandos del proyecto están disponibles para todos los que clonen el repositorio
• El contenido del archivo Markdown se convierte en el prompt enviado a Claude cuando se invoca el comando

​

Agregar argumentos de comando con $ARGUMENTS

Cuándo usar: Quieres crear comandos con barra diagonal flexibles que puedan aceptar entrada adicional de los usuarios.

echo "Encuentra y corrige el problema #$ARGUMENTS. Sigue estos pasos: 1.
Entiende el problema descrito en el ticket 2. Localiza el código relevante en
nuestra base de código 3. Implementa una solución que aborde la causa raíz 4. Agrega
pruebas apropiadas 5. Prepara una descripción concisa del PR" >
.claude/commands/fix-issue.md 

claude > /project:fix-issue 123 

Consejos:

• El marcador de posición $ARGUMENTS se reemplaza con cualquier texto que siga al comando
• Puedes posicionar $ARGUMENTS en cualquier lugar en tu plantilla de comando
• Otras aplicaciones útiles: generar casos de prueba para funciones específicas, crear documentación para componentes, revisar código en archivos particulares o traducir contenido a idiomas específicos

​

Crear comandos personales con barra diagonal

Cuándo usar: Quieres crear comandos personales con barra diagonal que funcionen en todos tus proyectos.

mkdir -p ~/.claude/commands 

echo "Revisa este código en busca de vulnerabilidades de seguridad, enfocándote en:" >
~/.claude/commands/security-review.md 

claude > /user:security-review 

Consejos:

• Los comandos personales tienen el prefijo /user: en lugar de /project:
• Los comandos personales solo están disponibles para ti y no se comparten con tu equipo
• Los comandos personales funcionan en todas tus bases de código
• Puedes usarlos para flujos de trabajo consistentes en diferentes bases de código

​

Ejecutar sesiones paralelas de Claude Code con Git worktrees

​

Usar worktrees para entornos de codificación aislados

Cuándo usar: Necesitas trabajar en múltiples tareas simultáneamente con aislamiento completo de código entre instancias de Claude Code.

# Crear un nuevo worktree con una nueva rama git worktree add
../proyecto-caracteristica-a caracteristica-a # O crear un worktree con una rama existente git worktree add ../proyecto-bugfix bugfix-123 

# Navegar a tu worktree 
cd ../proyecto-caracteristica-a # Ejecutar Claude Code en este entorno aislado claude 

cd ../proyecto-bugfix claude

# Listar todos los worktrees git worktree list # Eliminar un worktree cuando termines
git worktree remove ../proyecto-caracteristica-a 

Consejos:

• Cada worktree tiene su propio estado de archivo independiente, haciéndolo perfecto para sesiones paralelas de Claude Code
• Los cambios hechos en un worktree no afectarán a otros, evitando que las instancias de Claude interfieran entre sí
• Todos los worktrees comparten el mismo historial de Git y conexiones remotas
• Para tareas de larga duración, puedes tener a Claude trabajando en un worktree mientras continúas el desarrollo en otro
• Usa nombres de directorio descriptivos para identificar fácilmente para qué tarea es cada worktree
• Recuerda inicializar tu entorno de desarrollo en cada nuevo worktree según la configuración de tu proyecto. Dependiendo de tu stack, esto podría incluir:
  • Proyectos JavaScript: Ejecutar instalación de dependencias (npm install, yarn)
  • Proyectos Python: Configurar entornos virtuales o instalar con gestores de paquetes
  • Otros lenguajes: Seguir el proceso estándar de configuración de tu proyecto

​

Siguientes pasos