Mejores prácticas para Claude Code

​

Dé a Claude una forma de verificar su trabajo

• En un solo mensaje: pida a Claude que ejecute la verificación e itere en el mismo mensaje, como en la tabla anterior.
• En toda una sesión: establezca la verificación como una condición /goal. Un evaluador separado la vuelve a verificar después de cada turno y Claude continúa trabajando hasta que se cumpla el objetivo. Si Claude se estanca, Claude Code eventualmente detiene la ejecución con el objetivo aún establecido — vea cómo funciona la evaluación de /goal.
• Como una puerta determinista: un hook Stop ejecuta su verificación como un script y bloquea el final del turno hasta que pase. Stop input cubre el límite en bloqueos consecutivos.
• Por una segunda opinión: un subagente de verificación o un flujo de trabajo dinámico que verifica sus propios hallazgos tiene un modelo fresco que intenta refutar el resultado, por lo que el agente que realiza el trabajo no es el que lo califica.

​

Explore primero, luego planifique, luego codifique

read /src/auth and understand how we handle sessions and login.
also look at how we manage environment variables for secrets.

I want to add Google OAuth. What files need to change?
What's the session flow? Create a plan.

implement the OAuth flow from your plan. write tests for the
callback handler, run the test suite and fix any failures.

commit with a descriptive message and open a PR

​

Proporcione contexto específico en sus indicaciones

​

Proporcionar contenido enriquecido

• Haga referencia a archivos con @ en lugar de describir dónde vive el código. Claude lee el archivo antes de responder.
• Pegue imágenes directamente. Copie/pegue o arrastre y suelte imágenes en la indicación.
• Proporcione URLs para documentación y referencias de API. Use /permissions para permitir dominios de uso frecuente.
• Canalice datos ejecutando cat error.log | claude para enviar contenidos de archivo directamente.
• Deje que Claude obtenga lo que necesita. Diga a Claude que extraiga contexto por sí mismo usando comandos Bash, herramientas MCP o leyendo archivos.

​

Configura tu entorno

​

Escribe un CLAUDE.md efectivo

# Code style
- Use ES modules (import/export) syntax, not CommonJS (require)
- Destructure imports when possible (eg. import { foo } from 'bar')

# Workflow
- Be sure to typecheck when you're done making a series of code changes
- Prefer running single tests, and not the whole test suite, for performance

​

Configura permisos

• Listas de permisos: permiten herramientas específicas que sabes que son seguras, como npm run lint o git commit
• Sandboxing: habilita aislamiento a nivel del SO que restringe el acceso al sistema de archivos y red, permitiendo que Claude trabaje más libremente dentro de límites definidos

​

Usa herramientas CLI

​

Conecta servidores MCP

​

Configura hooks

​

Crea skills

---
name: api-conventions
description: REST API design conventions for our services
---
# API Conventions
- Use kebab-case for URL paths
- Use camelCase for JSON properties
- Always include pagination for list endpoints
- Version APIs in the URL path (/v1/, /v2/)

---
name: fix-issue
description: Fix a GitHub issue
disable-model-invocation: true
---
Analyze and fix the GitHub issue: $ARGUMENTS.

1. Use `gh issue view` to get the issue details
2. Understand the problem described in the issue
3. Search the codebase for relevant files
4. Implement the necessary changes to fix the issue
5. Write and run tests to verify the fix
6. Ensure code passes linting and type checking
7. Create a descriptive commit message
8. Push and create a PR

​

Crea subagentes personalizados

---
name: security-reviewer
description: Reviews code for security vulnerabilities
tools: Read, Grep, Glob, Bash
model: opus
---
You are a senior security engineer. Review code for:
- Injection vulnerabilities (SQL, XSS, command injection)
- Authentication and authorization flaws
- Secrets or credentials in code
- Insecure data handling

Provide specific line references and suggested fixes.

​

Instala plugins

​

Comuníquese efectivamente

​

Haga preguntas sobre el código base

• ¿Cómo funciona el registro?
• ¿Cómo hago un nuevo punto final de API?
• ¿Qué hace async move { ... } en la línea 134 de foo.rs?
• ¿Qué casos extremos maneja CustomerOnboardingFlowImpl?
• ¿Por qué este código llama a foo() en lugar de bar() en la línea 333?

​

Deje que Claude lo entreviste

I want to build [brief description]. Interview me in detail using the AskUserQuestion tool.

Ask about technical implementation, UI/UX, edge cases, concerns, and tradeoffs. Don't ask obvious questions, dig into the hard parts I might not have considered.

Keep interviewing until we've covered everything, then write a complete spec to SPEC.md.

​

Gestione su sesión

​

Corrija el curso temprano y a menudo

• Esc: detener a Claude a mitad de acción con la tecla Esc. El contexto se preserva, para que pueda redirigir.
• Esc + Esc o /rewind: presione Esc dos veces o ejecute /rewind para abrir el menú de rebobinado y restaurar la conversación anterior y el estado del código, o resumir desde un mensaje seleccionado.
• "Undo that": haga que Claude revierta sus cambios.
• /clear: restablecer contexto entre tareas no relacionadas. Las sesiones largas con contexto irrelevante pueden reducir el rendimiento.

​

Gestione el contexto agresivamente

• Use /clear frecuentemente entre tareas para restablecer completamente la ventana de contexto
• Cuando se activa la compactación automática, Claude resume lo que más importa, incluyendo patrones de código, estados de archivo y decisiones clave
• Para más control, ejecute /compact <instructions>, como /compact Focus on the API changes
• Para compactar solo parte de la conversación, use Esc + Esc o /rewind, seleccione un punto de control de mensaje y elija Summarize from here o Summarize up to here. El primero condensa mensajes desde ese punto hacia adelante mientras mantiene el contexto anterior intacto; el segundo condensa mensajes anteriores mientras mantiene los recientes en su totalidad. Consulte las opciones de resumición del menú de rebobinado.
• Personalice el comportamiento de compactación en CLAUDE.md con instrucciones como "When compacting, always preserve the full list of modified files and any test commands" para asegurar que el contexto crítico sobreviva a la resumición
• Para preguntas que no necesitan permanecer en contexto, use /btw. La respuesta nunca entra en el historial de conversación, para que pueda verificar un detalle sin aumentar el contexto.

​

Use subagents para investigación

Use subagents to investigate how our authentication system handles token
refresh, and whether we have any existing OAuth utilities I should reuse.

​

Rebobine con puntos de control

​

Reanudar conversaciones

​

Automatizar y escalar

​

Ejecutar modo no interactivo

# Consultas puntuales
claude -p "Explain what this project does"

# Salida estructurada para scripts
claude -p "List all API endpoints" --output-format json

# Streaming para procesamiento en tiempo real
claude -p "Analyze this log file" --output-format stream-json --verbose

​

Ejecutar múltiples sesiones de Claude

• Git Worktrees: ejecute sesiones de CLI separadas en checkouts de git aislados para que las ediciones no choquen
• Mensajería entre sesiones: permita que las sesiones que ejecuta usted mismo pasen hallazgos entre sí
• Aplicación de escritorio: administre múltiples sesiones locales visualmente, opcionalmente cada una en su propio worktree
• Claude Code en la web: ejecute sesiones en la nube, en infraestructura administrada por Anthropic de forma predeterminada
• Vista de agente: vista previa de investigación. Ejecute claude agents para enviar sesiones que sigan ejecutándose en segundo plano y obsérvelas desde una pantalla
• Equipos de agentes: experimental y deshabilitado de forma predeterminada. Coordinación automatizada de múltiples sesiones con tareas compartidas, mensajería y un líder de equipo

​

Distribuir entre archivos

for file in $(cat files.txt); do
  claude -p "Migrate $file from Python 2 to Python 3. Return OK or FAIL." \
    --allowedTools "Edit,Bash(git commit *)"
done

claude -p "<your prompt>" --output-format json | your_command

​

Ejecutar de forma autónoma con modo automático

claude --permission-mode auto -p "fix all lint errors"

​

Agregar un paso de revisión adversarial

Use a subagent to review the rate limiter diff against PLAN.md. Check that
every requirement is implemented, the listed edge cases have tests, and
nothing outside the task's scope changed. Report gaps, not style preferences.

​

Evite patrones de falla comunes

• La sesión de todo incluido. Comienza con una tarea, luego pregunta a Claude algo no relacionado, luego vuelve a la primera tarea. El contexto está lleno de información irrelevante.

  Solución: /clear entre tareas no relacionadas.

• Corrección una y otra vez. Claude hace algo mal, lo corrige, sigue siendo incorrecto, lo corrige de nuevo. El contexto está contaminado con enfoques fallidos.

  Solución: Después de dos correcciones fallidas, /clear y escriba una indicación inicial mejor incorporando lo que aprendió.

• El CLAUDE.md sobre especificado. Si su CLAUDE.md es demasiado largo, Claude ignora la mitad porque las reglas importantes se pierden en el ruido.

  Solución: Elimine sin piedad. Si Claude ya hace algo correctamente sin la instrucción, elimínelo o conviértalo en un hook.

• La brecha de confianza-luego-verificación. Claude produce una implementación que se ve plausible pero no maneja casos extremos.

  Solución: Siempre proporcione verificación (pruebas, scripts, capturas de pantalla). Si no puede verificarlo, no lo envíe.

• La exploración infinita. Pide a Claude que “investigue” algo sin delimitarlo. Claude lee cientos de archivos, llenando el contexto.

  Solución: Delimite investigaciones estrechamente o use subagents para que la exploración no consuma su contexto principal.

​

Desarrolle su intuición

​

Recursos relacionados

• Cómo funciona Claude Code: el bucle agencial, herramientas y gestión de contexto
• Extender Claude Code: skills, hooks, MCP, subagents y plugins
• Flujos de trabajo comunes: recetas paso a paso para depuración, pruebas, PRs y más
• CLAUDE.md: almacenar convenciones de proyecto y contexto persistente