Cada tarea en este documento incluye instrucciones claras, comandos de ejemplo y mejores prácticas para ayudarte a obtener el máximo provecho de Claude Code.

​
Entender nuevas bases de código

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

Supongamos que acabas de unirte a un nuevo proyecto y necesitas entender su estructura rápidamente.

1

Navegar al directorio raíz del proyecto

cd /path/to/project
2

Iniciar Claude Code

claude
3

Pedir una visión general de alto nivel

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

Profundizar en componentes específicos

> 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 enfócate en áreas específicas
  • Pregunta sobre las convenciones de codificación y patrones utilizados en el proyecto
  • Solicita un glosario de términos específicos del proyecto

​
Encontrar código relevante

Supongamos que necesitas localizar código relacionado con una característica o funcionalidad específica.

1

Pedir a Claude que encuentre archivos relevantes

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

Obtener contexto sobre cómo interactúan los componentes

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

Entender el flujo de ejecució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 del dominio del proyecto

​
Corregir errores eficientemente

Supongamos que has encontrado un mensaje de error y necesitas encontrar y corregir su origen.

1

Compartir el error con Claude

> estoy viendo un error cuando ejecuto npm test
2

Pedir recomendaciones de corrección

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

Aplicar la corrección

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

Consejos:

  • Dile a Claude el comando para reproducir el problema y obtener un stack trace
  • Menciona cualquier paso para reproducir el error
  • Hazle saber a Claude si el error es intermitente o consistente

​
Refactorizar código

Supongamos que necesitas actualizar código antiguo para usar patrones y prácticas modernas.

1

Identificar código heredado para refactorizar

> encuentra el uso de API obsoletas en nuestra base de código
2

Obtener recomendaciones de refactorización

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

Aplicar los cambios de forma segura

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

Verificar la refactorización

> ejecuta las 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

Supongamos que necesitas agregar pruebas para código no cubierto.

1

Identificar código no probado

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

Generar estructura de pruebas

> agrega pruebas para el servicio de notificaciones
3

Agregar casos de prueba significativos

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

Ejecutar y verificar pruebas

> ejecuta las nuevas pruebas y corrige cualquier falla

Consejos:

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

Supongamos que necesitas crear un pull request bien documentado para tus cambios.

1

Resumir tus cambios

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

Generar un PR con Claude

> crea un pr
3

Revisar y refinar

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

Agregar detalles de pruebas

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

Consejos:

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

​
Manejar documentación

Supongamos que necesitas agregar o actualizar documentación para tu código.

1

Identificar código sin documentar

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

Generar documentación

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

Revisar y mejorar

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

Verificar documentación

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

Consejos:

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

​
Trabajar con imágenes

Supongamos que necesitas trabajar con imágenes en tu base de código, y quieres la ayuda de Claude analizando el contenido de las imágenes.

1

Agregar una imagen a la conversación

Puedes usar cualquiera de estos métodos:

  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 (No uses cmd+v)
  3. Proporciona una ruta de imagen a claude. Por ejemplo, “Analiza esta imagen: /path/to/your/image.png”
2

Pedir a Claude que analice la imagen

> ¿Qué muestra esta imagen?

> Describe los elementos de UI en esta captura de pantalla

> ¿Hay algún elemento problemático en este diagrama?
3

Usar imágenes para contexto

> 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?
4

Obtener sugerencias de código del contenido visual

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

Supongamos que estás trabajando en decisiones arquitectónicas complejas, errores desafiantes o planificando implementaciones de múltiples pasos que requieren razonamiento profundo.

1

Proporcionar contexto y pedir a Claude que piense

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

Claude recopilará información relevante de tu base de código y usará pensamiento extendido, que será visible en la interfaz.

2

Refinar el pensamiento con prompts de seguimiento

> 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 niveles variables de profundidad de pensamiento:

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

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

Claude mostrará su proceso de pensamiento como texto gris en cursiva arriba de la respuesta.

​
Reanudar conversaciones anteriores

Supongamos que 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
1

Continuar la conversación más reciente

claude --continue

Esto reanuda inmediatamente tu conversación más reciente sin ningún prompt.

2

Continuar en modo no interactivo

claude --continue --print "Continúa con mi tarea"

Usa --print con --continue para reanudar la conversación más reciente en modo no interactivo, perfecto para scripts o automatización.

3

Mostrar selector de conversaciones

claude --resume

Esto muestra un selector de conversaciones interactivo que muestra:

  • Hora de inicio de la conversación
  • Prompt inicial o resumen de la conversación
  • Conteo de mensajes

Usa las teclas de flecha para navegar y presiona Enter para seleccionar una conversación.

Consejos:

  • El historial de conversaciones se almacena localmente en tu máquina
  • Usa --continue para acceso rápido 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

Cómo funciona:

  1. Almacenamiento de Conversaciones: Todas las conversaciones se guardan automáticamente localmente con su historial completo de mensajes
  2. Deserialización de Mensajes: Al reanudar, todo el historial de mensajes se restaura para mantener el contexto
  3. Estado de Herramientas: El uso de herramientas y resultados de la conversación anterior se preservan
  4. Restauración de Contexto: La conversación se reanuda con todo el contexto anterior intacto

Ejemplos:

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

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

# Mostrar selector de conversaciones
claude --resume

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

​
Ejecutar sesiones paralelas de Claude Code con Git worktrees

Supongamos que necesitas trabajar en múltiples tareas simultáneamente con aislamiento completo de código entre instancias de Claude Code.

1

Entender Git worktrees

Los Git worktrees te permiten hacer checkout de múltiples ramas del mismo repositorio en directorios separados. Cada worktree tiene su propio directorio de trabajo con archivos aislados, mientras comparten la misma historia de Git. Aprende más en la documentación oficial de Git worktree .

2

Crear un nuevo worktree

# Crear un nuevo worktree con una nueva rama 
git worktree add ../project-feature-a -b feature-a

# O crear un worktree con una rama existente
git worktree add ../project-bugfix bugfix-123

Esto crea un nuevo directorio con una copia de trabajo separada de tu repositorio.

3

Ejecutar Claude Code en cada worktree

# Navegar a tu worktree 
cd ../project-feature-a

# Ejecutar Claude Code en este entorno aislado
claude
4

Ejecutar Claude en otro worktree

cd ../project-bugfix
claude
5

Gestionar tus worktrees

# Listar todos los worktrees
git worktree list

# Remover un worktree cuando termines
git worktree remove ../project-feature-a

Consejos:

  • Cada worktree tiene su propio estado de archivos 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 la misma historia 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

​
Usar Claude como una utilidad estilo unix

​
Agregar Claude a tu proceso de verificación

Supongamos que quieres usar Claude Code como un linter o revisor de código.

Agregar Claude a tu script de build:

// 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.'"
    }
}

Consejos:

  • Usa Claude para revisión automatizada de código en tu pipeline de CI/CD
  • Personaliza el prompt para verificar problemas específicos relevantes a tu proyecto
  • Considera crear múltiples scripts para diferentes tipos de verificación

​
Pipe in, pipe out

Supongamos que quieres canalizar datos hacia Claude, y obtener datos de vuelta en un formato estructurado.

Canalizar datos a través de Claude:

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

Consejos:

  • Usa pipes para integrar Claude en scripts de shell existentes
  • Combina con otras herramientas Unix para flujos de trabajo poderosos
  • Considera usar —output-format para salida estructurada

​
Controlar formato de salida

Supongamos que necesitas la salida de Claude en un formato específico, especialmente al integrar Claude Code en scripts u otras herramientas.

1

Usar formato de texto (predeterminado)

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

Esto produce solo la respuesta de texto plano de Claude (comportamiento predeterminado).

2

Usar formato JSON

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

Esto produce un array JSON de mensajes con metadatos incluyendo costo y duración.

3

Usar formato JSON de streaming

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

Esto produce una serie de objetos JSON en tiempo real mientras Claude procesa la solicitud. Cada mensaje es un objeto JSON válido, pero toda la salida no es JSON válido si se concatena.

Consejos:

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

​
Crear comandos slash personalizados

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

Para más detalles, consulta la página de referencia de Comandos slash.

​
Crear comandos específicos del proyecto

Supongamos que quieres crear comandos slash reutilizables para tu proyecto que todos los miembros del equipo puedan usar.

1

Crear un directorio de comandos en tu proyecto

mkdir -p .claude/commands
2

Crear un archivo Markdown para cada comando

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

Usar tu comando personalizado en Claude Code

> /project:optimize

Consejos:

  • Los nombres de comandos se derivan del nombre del archivo (ej., optimize.md se convierte en /project:optimize)
  • Puedes organizar comandos en subdirectorios (ej., .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

Supongamos que quieres crear comandos slash flexibles que puedan aceptar entrada adicional de los usuarios.

1

Crear un archivo de comando con el marcador de posición $ARGUMENTS

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 de PR" >
.claude/commands/fix-issue.md
2

Usar el comando con un número de problema

En tu sesión de Claude, usa el comando con argumentos.

> /project:fix-issue 123

Esto reemplazará $ARGUMENTS con “123” en el prompt.

Consejos:

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

​
Crear comandos slash personales

Supongamos que quieres crear comandos slash personales que funcionen en todos tus proyectos.

1

Crear un directorio de comandos en tu carpeta home

mkdir -p ~/.claude/commands
2

Crear un archivo Markdown para cada comando

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

Usar tu comando personalizado personal

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

​
Próximos pasos

Implementación de referencia de Claude Code

Clona nuestra implementación de referencia de contenedor de desarrollo.