Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Esta página recopila recetas cortas para el desarrollo cotidiano. Para orientación de nivel superior sobre indicaciones y gestión de contexto, consulte Mejores prácticas. Esta página cubre:

Recetas de indicaciones

Estos son patrones de indicaciones para tareas cotidianas como explorar código desconocido, depuración, refactorización, escritura de pruebas y creación de PRs. Cada uno funciona en cualquier superficie de Claude Code; adapte la redacción a su proyecto.

Comprender nuevas bases de código

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

Supongamos que acaba de unirse a un nuevo proyecto y necesita comprender su estructura rápidamente.
1

Navegue al directorio raíz del proyecto

cd /path/to/project 
2

Inicie Claude Code

claude 
3

Solicite una descripción general de alto nivel

dame una descripción general de esta base de código
4

Profundice en componentes específicos

explica los patrones de arquitectura principales utilizados aquí
¿cuáles son los modelos de datos clave?
¿cómo se maneja la autenticación?
Consejos:
  • Comience con preguntas amplias, luego reduzca a áreas específicas
  • Pregunte sobre convenciones de codificación y patrones utilizados en el proyecto
  • Solicite un glosario de términos específicos del proyecto

Encontrar código relevante

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

Pida a Claude que encuentre archivos relevantes

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

Obtenga contexto sobre cómo interactúan los componentes

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

Comprenda el flujo de ejecución

rastrear el proceso de inicio de sesión de front-end a base de datos
Consejos:
  • Sea específico sobre lo que está buscando
  • Utilice el lenguaje del dominio del proyecto
  • Instale un plugin de inteligencia de código para su lenguaje para dar a Claude una navegación precisa de “ir a definición” y “buscar referencias”

Corregir errores de manera eficiente

Supongamos que ha encontrado un mensaje de error y necesita encontrar y corregir su origen.
1

Comparta el error con Claude

estoy viendo un error cuando ejecuto npm test
2

Solicite recomendaciones de corrección

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

Aplique la corrección

actualiza user.ts para agregar la verificación nula que sugeriste
Consejos:
  • Dígale a Claude el comando para reproducir el problema y obtener un seguimiento de pila
  • Mencione cualquier paso para reproducir el error
  • Hágale saber a Claude si el error es intermitente o consistente

Refactorizar código

Supongamos que necesita actualizar código antiguo para utilizar patrones y prácticas modernas.
1

Identifique código heredado para refactorización

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

Obtenga recomendaciones de refactorización

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

Aplique los cambios de manera segura

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

Verifique la refactorización

ejecuta pruebas para el código refactorizado
Consejos:
  • Pida a Claude que explique los beneficios del enfoque moderno
  • Solicite que los cambios mantengan la compatibilidad hacia atrás cuando sea necesario
  • Realice la refactorización en incrementos pequeños y comprobables

Trabajar con pruebas

Supongamos que necesita agregar pruebas para código no cubierto.
1

Identifique código no probado

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

Genere andamiaje de prueba

agrega pruebas para el servicio de notificaciones
3

Agregue casos de prueba significativos

agrega casos de prueba para condiciones de borde en el servicio de notificaciones
4

Ejecute y verifique las pruebas

ejecuta las nuevas pruebas y corrige cualquier fallo
Claude puede generar pruebas que sigan los patrones y convenciones existentes de su proyecto. Al solicitar pruebas, sea específico sobre qué comportamiento desea verificar. Claude examina sus archivos de prueba existentes para coincidir con el estilo, marcos y patrones de afirmación ya en uso. Para una cobertura integral, pida a Claude que identifique casos extremos que podría haber perdido. Claude puede analizar sus rutas de código y sugerir pruebas para condiciones de error, valores límite e entradas inesperadas que son fáciles de pasar por alto.

Crear solicitudes de extracción

Puede crear solicitudes de extracción pidiendo a Claude directamente (“crear una pr para mis cambios”), o guiar a Claude a través de ella paso a paso:
1

Resuma sus cambios

resume los cambios que he hecho en el módulo de autenticación
2

Genere una solicitud de extracción

crear una pr
3

Revise y refine

mejora la descripción de la PR con más contexto sobre las mejoras de seguridad
Cuando crea una PR usando gh pr create, la sesión se vincula automáticamente a esa PR. Para regresar a ella más tarde, ejecute claude --from-pr <number> o pegue la URL de la PR en el selector /resume.
Revise la PR generada por Claude antes de enviarla y pida a Claude que destaque los riesgos potenciales o consideraciones.

Manejar documentación

Supongamos que necesita agregar o actualizar documentación para su código.
1

Identifique código sin documentar

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

Genere documentación

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

Revise y mejore

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

Verifique la documentación

verifica si la documentación sigue nuestros estándares de proyecto
Consejos:
  • Especifique el estilo de documentación que desea (JSDoc, docstrings, etc.)
  • Solicite ejemplos en la documentación
  • Solicite documentación para API públicas, interfaces y lógica compleja

Trabajar en notas y carpetas que no son código

Claude Code funciona en cualquier directorio. Ejecútelo dentro de una bóveda de notas, una carpeta de documentación o cualquier colección de archivos markdown para buscar, editar y reorganizar contenido de la misma manera que lo haría con código. El directorio .claude/ y CLAUDE.md se encuentran junto a los directorios de configuración de otras herramientas sin conflicto. Claude lee archivos nuevos en cada llamada de herramienta, por lo que ve las ediciones que realiza en otra aplicación la próxima vez que lee ese archivo.

Trabajar con imágenes

Supongamos que necesita trabajar con imágenes en su base de código y desea la ayuda de Claude para analizar el contenido de la imagen.
1

Agregue una imagen a la conversación

Puede usar cualquiera de estos métodos:
  1. Arrastre y suelte una imagen en la ventana de Claude Code
  2. Copie una imagen y péguela en la CLI con ctrl+v (No use cmd+v)
  3. Proporcione una ruta de imagen a Claude. Por ejemplo, “Analiza esta imagen: /path/to/your/image.png”
2

Pida a Claude que analice la imagen

¿Qué muestra esta imagen?
Describe los elementos de la interfaz de usuario 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

Obtenga sugerencias de código del contenido visual

Generar CSS para coincidir con este mockup de diseño
¿Qué estructura HTML recrearía este componente?
Consejos:
  • Use imágenes cuando las descripciones de texto serían poco claras o engorrosas
  • Incluya capturas de pantalla de errores, diseños de interfaz de usuario o diagramas para mejor contexto
  • Puede 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
  • Cuando Claude hace referencia a imágenes (por ejemplo, [Image #1]), Cmd+Click (Mac) o Ctrl+Click (Windows/Linux) el enlace para abrir la imagen en su visor predeterminado

Archivos y directorios de referencia

Use @ para incluir rápidamente archivos o directorios sin esperar a que Claude los lea.
1

Haga referencia a un archivo único

Explica la lógica en @src/utils/auth.js
Esto incluye el contenido completo del archivo en la conversación.
2

Haga referencia a un directorio

¿Cuál es la estructura de @src/components?
Esto proporciona un listado de directorio con información de archivo.
3

Haga referencia a recursos MCP

Muéstrame los datos de @github:repos/owner/repo/issues
Esto obtiene datos de servidores MCP conectados usando el formato @server:resource. Consulte recursos MCP para más detalles.
Consejos:
  • Las rutas de archivo pueden ser relativas o absolutas
  • Las referencias de archivo @ agregan CLAUDE.md en el directorio del archivo y directorios principales al contexto
  • Las referencias de directorio muestran listados de archivos, no contenidos
  • Puede hacer referencia a múltiples archivos en un solo mensaje (por ejemplo, “@file1.js y @file2.js”)

Ejecutar Claude en un horario

Supongamos que desea que Claude maneje una tarea automáticamente de forma recurrente, como revisar PRs abiertas cada mañana, auditar dependencias semanalmente o verificar fallas de CI durante la noche. Elija una opción de programación según dónde desee que se ejecute la tarea:
OpciónDónde se ejecutaMejor para
RoutinesInfraestructura administrada por AnthropicTareas que deben ejecutarse incluso cuando su computadora está apagada. También puede activarse en llamadas API o eventos de GitHub además de un horario. Configure en claude.ai/code/routines.
Tareas programadas de escritorioSu máquina, a través de la aplicación de escritorioTareas que necesitan acceso directo a archivos locales, herramientas o cambios sin confirmar.
GitHub ActionsSu canalización de CITareas vinculadas a eventos de repositorio como PRs abiertos, o horarios cron que deben vivir junto con su configuración de flujo de trabajo.
/loopLa sesión CLI actualSondeo rápido mientras una sesión está abierta. Las tareas se cancelan cuando comienza una nueva conversación; --resume y --continue restauran las no expiradas.
Al escribir indicaciones para tareas programadas, sea explícito sobre qué se ve como éxito y qué hacer con los resultados. La tarea se ejecuta de forma autónoma, por lo que no puede hacer preguntas aclaratorias. Por ejemplo: “Revise PRs abiertas etiquetadas con needs-review, deje comentarios en línea sobre cualquier problema y publique un resumen en el canal #eng-reviews de Slack.”

Pregunte a Claude sobre sus capacidades

Claude tiene acceso integrado a su documentación y puede responder preguntas sobre sus propias características y limitaciones.

Preguntas de ejemplo

¿puede Claude Code crear solicitudes de extracción?
¿cómo maneja Claude Code los permisos?
¿qué skills están disponibles?
¿cómo uso MCP con Claude Code?
¿cómo configuro Claude Code para Amazon Bedrock?
¿cuáles son las limitaciones de Claude Code?
Claude proporciona respuestas basadas en documentación a estas preguntas. Para demostraciones prácticas, ejecute /powerup para lecciones interactivas con demostraciones animadas, o consulte las secciones de flujo de trabajo específicas anteriores.
Consejos:
  • Claude siempre tiene acceso a la documentación más reciente de Claude Code, independientemente de la versión que esté utilizando
  • Haga preguntas específicas para obtener respuestas detalladas
  • Claude puede explicar características complejas como integración MCP, configuraciones empresariales y flujos de trabajo avanzados

Reanudar conversaciones anteriores

Cuando una tarea abarca múltiples sesiones, continúe donde lo dejó en lugar de volver a explicar el contexto. Claude Code guarda cada conversación localmente.
claude --continue
Esto reanuda la sesión más reciente en el directorio actual; si aún no existe una, imprime No conversation found to continue y sale. Use claude --resume para elegir de una lista, o /resume desde dentro de una sesión en ejecución. Consulte Gestionar sesiones para nombrar, ramificar y la referencia completa del selector.

Ejecutar sesiones paralelas con worktrees

Trabaje en una característica en una terminal mientras Claude corrige un error en otra, sin que los cambios choquen. Cada worktree es un checkout separado en su propia rama.
claude --worktree feature-auth
Ejecute el mismo comando con un nombre diferente en una segunda terminal para iniciar una sesión paralela aislada. Consulte Worktrees para limpieza, .worktreeinclude y soporte de VCS que no sea git. Para monitorear sesiones paralelas desde una pantalla en lugar de terminales separadas, consulte agentes de fondo.

Planificar antes de editar

Para cambios que desea revisar antes de que toquen el disco, cambie al modo de plan. Claude lee archivos y propone un plan pero no realiza ediciones hasta que apruebe.
claude --permission-mode plan
También puede presionar Shift+Tab durante una sesión para cambiar al modo de plan. Consulte Plan mode para el flujo de aprobación y editar el plan en su editor de texto.

Delegar investigación a subagentes

Explorar una base de código grande llena su contexto con lecturas de archivos. Delegue la exploración para que solo los hallazgos regresen.
usa un subagente para investigar cómo nuestro sistema de autenticación maneja la actualización de tokens
El subagente lee archivos en su propia ventana de contexto e informa un resumen. Consulte Subagentes para definir agentes personalizados con sus propias herramientas e indicaciones.

Canalizar Claude en scripts

Ejecute Claude de forma no interactiva para CI, hooks de pre-commit o procesamiento por lotes. Stdin y stdout funcionan como cualquier herramienta Unix.
git log --oneline -20 | claude -p "summarize these recent commits"
Consulte Modo no interactivo para formatos de salida, banderas de permiso y patrones de distribución.

Próximos pasos

Mejores prácticas

Patrones para obtener lo máximo de Claude Code

Gestionar sesiones

Reanudar, nombrar y ramificar conversaciones

Worktrees

Ejecutar sesiones paralelas aisladas

Extender Claude Code

Agregar skills, hooks, MCP, subagentes y plugins