Tutoriales de Claude Code

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

• Entender nuevas bases de código
• Corregir errores eficientemente
• Refactorizar código
• Trabajar con pruebas
• Crear pull requests
• 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 utilidad de unix
• Crear comandos slash personalizados

​

Entender nuevas bases de código

​

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

Cuándo usar: Te has unido a un nuevo proyecto y necesitas entender su estructura rápidamente.

cd /path/to/project

claude

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

> explica los principales patrones de arquitectura usados 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 código y patrones usados 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?

> traza 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 arreglar 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 APIs obsoletas 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 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 no cubierto.

> 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 pull requests

​

Generar PRs completos

Cuándo usar: Necesitas crear un pull request bien documentado 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 a Claude directamente 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 los estándares de nuestro 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 contenido de imágenes.

# 1. Arrastra y suelta una imagen en la ventana de Claude Code
# 2. Copia una imagen y pégala en la CLI con ctrl+v
# 3. Proporciona una ruta de imagen
claude "Analiza esta imagen: /ruta/a/tu/imagen.png"

> ¿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 igualar 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:

• “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, ver 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 usados.

> /init

Consejos:

• Incluye comandos frecuentemente usados (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
• Puedes agregar archivos CLAUDE.md a cualquiera de:
  • La carpeta donde ejecutas Claude: Automáticamente agregado a conversaciones que inicies en esa carpeta
  • Directorios hijos: Claude los incorpora bajo demanda
  • ~/.claude/CLAUDE.md: Preferencias específicas del usuario que no quieres registrar en el control de código fuente

​

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, ver 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

# 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 (por defecto): Disponible solo para ti en el proyecto actual (se llamaba project en versiones anteriores)
  • project: Compartido con todos en el proyecto vía archivo .mcp.json
  • user: Disponible para ti en todos los proyectos (se llamaba global en versiones anteriores)
• Establece variables de entorno con banderas -e o --env (ej., -e CLAVE=valor)
• Configura el tiempo de espera de inicio del servidor MCP usando la variable de entorno MCP_TIMEOUT (ej., 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 alcances de servidores MCP

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

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

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

# Agregar un servidor de alcance 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 alcance local tienen precedencia sobre los servidores de alcance de proyecto y usuario con el mismo nombre
• Los servidores de alcance de proyecto (en .mcp.json) tienen precedencia sobre los servidores de alcance de usuario con el mismo nombre
• Antes de usar servidores de alcance 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 alcance 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 alcance de proyecto están habilitados o deshabilitados, usa el comando claude mcp reset-project-choices

​

Conectar a un servidor MCP Postgres

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

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 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 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/a/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 (ej., servidor_1)

​

Usar Claude Code como 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 utilidad de 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.'"
    }
}

​

Entrada y salida por tubería

Cuándo usar: Quieres enviar datos a Claude por tubería 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

​

Crear comandos slash personalizados

Claude Code soporta comandos slash personalizados que puedes crear para ejecutar rápidamente prompts o tareas específicas.

​

Crear comandos específicos del proyecto

Cuándo usar: Quieres crear comandos slash 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/optimizar.md

claude
> /project:optimizar

Consejos:

• Los nombres de los comandos se derivan del nombre del archivo (ej., optimizar.md se convierte en /project:optimizar)
• Puedes organizar comandos en subdirectorios (ej., .claude/commands/frontend/componente.md se convierte en /project:frontend:componente)
• 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 slash flexibles que puedan aceptar entrada adicional de los usuarios.

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

claude
> /project:corregir-problema 123

Consejos:

• El marcador $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 slash personales

Cuándo usar: Quieres crear comandos slash personales 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/revision-seguridad.md

claude
> /user:revision-seguridad

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 todos tus proyectos
• Puedes usarlos para flujos de trabajo consistentes en diferentes bases de código

​

Siguientes pasos