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 solicitudes de cambios
• Manejar documentación
• Usar flujos de trabajo avanzados de git
• Trabajar con imágenes
• Configurar memoria del proyecto
• Usar Claude como utilidad estilo unix
• Configurar Model Context Protocol (MCP)

​

Entender nuevas bases de código

​

Obtener una vista rápida de la base de código

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

$ cd /path/to/project

$ claude

> dame una vista 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?

> 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 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
• Pide a Claude que explique la estrategia de pruebas

​

Crear solicitudes de cambios

​

Generar PRs completas

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

> 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: /path/to/your/image.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 coincidir 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

​

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 nombres
• Agrega patrones arquitectónicos importantes específicos de tu proyecto
• Puedes agregar archivos CLAUDE.md a la carpeta donde ejecutas Claude, directorios padre (Claude los lee automáticamente), o directorios hijo (Claude los incorpora bajo demanda)

​

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

​

Entrada y salida por tubería

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

$ cat build-error.txt | claude -p 'explica concisamente la causa raíz de este error de build' > output.txt

​

Configurar Model Context Protocol (MCP)

Model Context Protocol (MCP) es un protocolo abierto que permite a los LLMs acceder a herramientas externas y fuentes de datos. 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 Model Context Protocol.

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

# Ejemplo: Agregando un servidor local
$ claude mcp add mi-servidor -e API_KEY=123 -- /path/to/server 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 con project (por defecto) o global para especificar dónde se almacena la configuración
• Establece variables de entorno con banderas -e o --env (ej., -e KEY=value)
• MCP sigue una arquitectura cliente-servidor donde Claude Code (el cliente) puede conectarse a múltiples servidores especializados

​

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 postgres-server /path/to/postgres-mcp-server --connection-string "postgresql://user:pass@localhost:5432/mydb"

# En tu sesión de Claude, puedes preguntar sobre tu base de datos
$ claude
> 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 los permisos mínimos requeridos

​

Siguientes pasos