Tutoriales

​

Tabla de contenidos

• Reanudar conversaciones anteriores
• Entender nuevas bases de código
• Solucionar 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

• --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

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 herramientas: El uso de herramientas y los resultados de la conversación anterior se conservan
4. Restauración de contexto: La conversación se reanuda con todo el contexto anterior intacto

• 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 pasada específica
• Al reanudar, verás todo el historial de conversación antes de continuar
• La conversación reanudada comienza con el mismo modelo y configuración que la original

# 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

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?

• 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

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

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

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

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

​

Solucionar errores eficientemente

​

Diagnosticar mensajes de error

> 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 

• Dile a Claude el comando para reproducir el problema y obtener un seguimiento de la pila
• Menciona cualquier paso para reproducir el error
• Hazle saber a Claude si el error es intermitente o constante

​

Refactorizar código

​

Modernizar código heredado

> 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 

• 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

​

Añadir cobertura de pruebas

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

> añade pruebas para el servicio de notificaciones 

> añade casos de prueba para condiciones límite en el servicio de notificaciones 

> ejecuta las nuevas pruebas y corrige cualquier fallo 

• 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 extracción

​

Generar PRs completas

> resume los cambios que he realizado en el módulo de autenticación 

> crear un pr 

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

> añade información sobre cómo se probaron estos cambios 

• 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

> encuentra funciones sin comentarios JSDoc adecuados en el módulo de autenticación 

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

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

> comprueba si la documentación sigue los estándares de nuestro proyecto 

• 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

> ¿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 de pantalla del error. ¿Qué lo está causando? 
> Este es nuestro esquema de base de datos actual. ¿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? 

• Usa imágenes cuando las descripciones de texto serían poco claras o engorrosas
• Incluye capturas de pantalla de errores, diseños de UI o diagramas para un 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

​

Aprovecha el pensamiento extendido de Claude para tareas complejas

> 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 en posibles vulnerabilidades de seguridad en este enfoque 
> piensa más profundamente sobre casos límite que deberíamos manejar 

• 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

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

​

Configurar memoria del proyecto

​

Crear un archivo CLAUDE.md efectivo

> /init 

• Incluye comandos de uso frecuente (compilar, probar, lint) para evitar búsquedas repetidas
• Documenta preferencias de estilo de código y convenciones de nomenclatura
• Añade 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)

​

Configurar servidores MCP

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

# Ejemplo: Añadir 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: Añadir 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

• 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 (p. ej., -e CLAVE=valor)
• Configura el tiempo de espera de inicio del servidor MCP usando la variable de entorno MCP_TIMEOUT (p. 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 ámbitos de los servidores MCP

# Añadir 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

# Añadir 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": {}
    }
  }
}

# Añadir un servidor de usuario
claude mcp add mi-servidor-usuario -s user /ruta/al/servidor

• 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 sobre 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

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

# 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

• 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 bases de datos en proyectos desconocidos
• Asegúrate de que tu cadena de conexión use credenciales apropiadas con los permisos mínimos requeridos

​

Añadir servidores MCP desde configuración JSON

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

# Ejemplo: Añadir 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

• 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 user para añadir el servidor a tu configuración de usuario en lugar de la específica del proyecto

​

Importar servidores MCP desde Claude Desktop

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

claude mcp list 

• 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 user para añadir servidores a tu configuración de usuario
• 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 (p. ej., servidor_1)

​

Usar Claude Code como un servidor MCP

# Sintaxis básica
claude mcp serve

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

• El servidor proporciona acceso a las herramientas de Claude como View, Edit, LS, etc.
• En Claude Desktop, intenta pedirle 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

​

Añadir Claude a tu proceso de verificación

// 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 el 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 por tubería, salida por tubería

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

​

Controlar el formato de salida

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

cat code.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

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

​

Crear comandos personalizados con barra diagonal

​

Crear comandos específicos del proyecto

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 

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

​

Añadir argumentos de comando con $ARGUMENTS

echo "Encuentra y soluciona 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. Añade
pruebas apropiadas 5. Prepara una descripción concisa para el PR" >
.claude/commands/fix-issue.md 

claude > /project:fix-issue 123 

• El marcador de posición $ARGUMENTS se reemplaza con cualquier texto que siga al comando
• Puedes posicionar $ARGUMENTS en cualquier lugar de 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

mkdir -p ~/.claude/commands 

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

claude > /user:security-review 

• 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

​

Ejecutar sesiones paralelas de Claude Code con Git worktrees

​

Usar worktrees para entornos de codificación aislados

# Crear un nuevo worktree con una nueva rama 
git worktree add ../proyecto-caracteristica-a -b 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 hayas terminado
git worktree remove ../proyecto-caracteristica-a

• Cada worktree tiene su propio estado de archivo independiente, lo que lo hace perfecto para sesiones paralelas de Claude Code
• Los cambios realizados 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 de configuración estándar de tu proyecto

​

Próximos pasos