Consejos de usuario avanzado de Claude Code

Este artículo recopila consejos de flujo de trabajo del equipo de Claude Code en Anthropic. Estas prácticas cubren ejecución paralela, planificación, automatización, verificación y personalización—los patrones que el equipo utiliza todos los días para enviar código más rápido. La configuración de cada persona es diferente, así que experimenta para ver qué funciona para ti.

El mayor desbloqueador de productividad es ejecutar 3–5 sesiones de Claude en paralelo, cada una en su propio worktree de git. Claude Code tiene soporte nativo de worktree integrado.

Para mantenerte orientado en muchas sesiones, nombra tus worktrees, configura alias de shell (za, zb, zc) para saltar entre ellos, codifica por colores tus pestañas de terminal y habilita notificaciones de terminal para que sepas cuándo algún Claude necesita tu atención. Muchos ingenieros mantienen un worktree de "análisis" dedicado solo para leer registros y ejecutar consultas.

Los subagentos también pueden ejecutarse en worktrees aislados, lo cual es especialmente poderoso para cambios por lotes grandes. Agrega isolation: worktree al frontmatter de tu agente:

Luego solicita naturalmente: "Migra toda la E/S de sincronización a asincronía. Agrupa los cambios e inicia 10 agentes paralelos con aislamiento de worktree. Cada agente debe probar sus cambios de extremo a extremo, luego crear un PR."

El comando /batch te entrevista sobre una migración, luego distribuye el trabajo entre tantos agentes de worktree como sea necesario — decenas, cientos o más. Cada agente trabaja de forma aislada, prueba sus propios cambios y crea un PR de forma independiente.

Presiona Shift+Tab para cambiar al modo de plan. Dedica tu esfuerzo a perfeccionar el plan para que Claude pueda implementarlo de una sola vez. El flujo típico es: entrar en modo de plan → refinar el plan → cambiar a aceptación automática de ediciones → Claude ejecuta.

Algunos patrones del equipo:

Razonamiento del equipo de Claude Code: "Es el mejor modelo de codificación que he usado, y aunque es más grande y lento que Sonnet, como tienes que dirigirlo menos y es mejor en el uso de herramientas, casi siempre es más rápido que usar un modelo más pequeño al final."

Las matemáticas: menos dirección + mejor uso de herramientas = resultados más rápidos en general, incluso con un modelo más grande.

Ejecuta /effort para elegir tu nivel de esfuerzo. Los niveles disponibles son low (menos tokens, más rápido), medium, high (más tokens, más inteligencia), max y auto (Claude elige por solicitud). El valor predeterminado es high en Team, Enterprise y acceso directo a API, y medium en otros planes. El equipo de Claude Code usa high para todo; cambia a /effort max para depuración difícil o decisiones de arquitectura donde quieras que Claude razone todo lo que necesite. Max consume los límites de uso más rápido, así que actívalo por sesión.

No aceptes la primera solución — presiona a Claude para que haga algo mejor. Algunas solicitudes que funcionan bien:

Escribe especificaciones detalladas para reducir la ambigüedad antes de delegar el trabajo. Cuanto más específico seas, mejor será el resultado.

Mientras Claude está trabajando activamente, usa /btw para hacer una pregunta rápida sin interrumpirlo. Es de una sola vuelta sin llamadas a herramientas, pero tiene contexto completo de la conversación.

Claude Code no es solo para escribir código — es una herramienta de aprendizaje poderosa cuando la configuras para explicar y enseñar.

Comparte un único archivo CLAUDE.md en la raíz de tu repositorio, registrado en git, con todo el equipo contribuyendo. La práctica clave: cada vez que Claude haga algo incorrectamente, agrégalo a CLAUDE.md para que sepa no repetir el error.

Después de cada corrección, termina con: "Actualiza tu CLAUDE.md para no cometer ese error de nuevo." Claude es muy bueno escribiendo reglas para sí mismo.

Instala la GitHub Action con /install-github-app, luego etiqueta @claude en comentarios de PR para agregar aprendizajes a CLAUDE.md como parte de la revisión:

Esto es "Ingeniería Compuesta" — cada corrección hace que cada sesión futura sea mejor.

Ejecuta /memory para configurar el sistema de memoria integrado de Claude Code.

Auto-memory guarda automáticamente preferencias, correcciones y patrones entre sesiones. Las memorias se escriben en ~/.claude/projects/<project>/memory/ (un directorio por raíz de repositorio git). Esto es separado de tus archivos ~/.claude/CLAUDE.md a nivel de usuario y ./CLAUDE.md a nivel de proyecto, que mantienes manualmente.

La nomenclatura se asigna a cómo el sueño REM consolida la memoria a corto plazo en almacenamiento a largo plazo.

Un ingeniero del equipo le dice a Claude que mantenga un directorio de notas para cada tarea y proyecto, actualizado después de cada PR — luego apunta CLAUDE.md a él.

Darle a Claude una forma de verificar su trabajo mejorará notablemente la calidad del resultado final. Si Claude puede cerrar el bucle de retroalimentación por sí solo, iterará hasta que el resultado sea correcto.

La verificación se ve diferente por dominio — comandos bash, suites de pruebas, simuladores, pruebas de navegador — pero el principio es el mismo. Invierte en verificación específica del dominio.

Para trabajo frontend, instala la extensión de Chrome de Claude Code. Piénsalo como cualquier otro ingeniero: si le pides a alguien que construya un sitio web pero no le dejas usar un navegador, ¿se verá bien? Probablemente no. Con un navegador, iterarán hasta que se vea bien.

El equipo usa la extensión de Chrome cada vez que trabaja en código web. Descárgala para Chrome o Edge en code.claude.com/docs/en/chrome.

La aplicación Claude Desktop incluye la capacidad de iniciar y probar automáticamente servidores web en un navegador integrado. Puedes configurar algo similar en CLI o VS Code usando la extensión de Chrome, o simplemente usar la aplicación de escritorio directamente.

Añade /simplify a cualquier solicitud después de hacer cambios. Ejecuta agentes paralelos que revisan el código modificado para reutilización, calidad, eficiencia y cumplimiento de CLAUDE.md, todo en un solo paso.

Si haces algo más de una vez al día, conviértelo en una habilidad. Las habilidades se registran en .claude/skills/<name>/SKILL.md y se comparten con el equipo (la ruta heredada .claude/commands/ aún funciona, pero las habilidades son el enfoque recomendado). Algunas ideas:

Los comandos de barra diagonal pueden incluir Bash en línea para precomputar información (como git status) sin llamadas de modelo adicionales.

Piensa en los suagentes como automatizaciones para tus flujos de trabajo de PR más comunes. Coloca archivos .md en .claude/agents/:

Cada agente puede tener un nombre personalizado, color, conjunto de herramientas, herramientas permitidas/no permitidas, modo de permiso y modelo. Establece el agente predeterminado para tu conversación principal añadiendo "agent" a settings.json o usando claude --agent <name>. Ejecuta /agents para comenzar.

Los agentes personalizados son una primitiva poderosa que a menudo se pasa por alto. Define un nuevo agente en .claude/agents, luego ejecuta claude --agent=<name>. Ejemplo de un agente de solo lectura:

Cuando se abre un PR, Claude puede enviar un equipo de agentes que cada uno se enfoque en una preocupación diferente — errores lógicos, problemas de seguridad, regresiones de rendimiento — y publicar comentarios en línea. El equipo de Anthropic lo construyó primero para sí mismos; la salida de código por ingeniero aumentó significativamente y las revisiones fueron el cuello de botella.

Los ganchos te permiten ejecutar lógica de manera determinista en puntos del ciclo de vida del agente. Pídele a Claude que añada un gancho para comenzar.

Ejemplo de gancho PostToolUse para formateo automático:

Ejecuta /permissions para preautorizar comandos seguros comunes y registrarlos en el .claude/settings.json de tu equipo. Esta es la alternativa recomendada a omitir permisos completamente — obtienes menos solicitudes mientras mantienes una lista de permitidos auditable. Se admite sintaxis de comodín completo—intenta "Bash(bun run *)" o "Edit(/docs/**)".

El sistema de permisos de Claude Code superpone detección de inyección de solicitudes, análisis estático, aislamiento de espacio aislado y supervisión humana. Un pequeño conjunto de comandos seguros está preaprobado de fábrica; todo lo que añadas a través de /permissions es aditivo a esa línea base.

El modo automático permite que Claude tome decisiones de permiso en tu nombre. Los clasificadores evalúan cada acción antes de ejecutarse — las operaciones seguras se aprueban automáticamente, las arriesgadas aún se marcan. Actívalo con claude --enable-auto-mode; una vez habilitado, Shift+Tab cicla default → acceptEdits → plan → auto durante una sesión. Sin esa bandera, el ciclo es default → acceptEdits → plan.

Ejecuta /sandbox para optar por el tiempo de ejecución de espacio aislado de código abierto de Claude Code. Se ejecuta en tu máquina y admite aislamiento de archivo y red, mejorando la seguridad mientras reduce solicitudes de permiso. Hay tres modos disponibles:

Para tareas de muy larga duración, asegúrate de que Claude pueda trabajar sin interrupciones. Enfoques recomendados:

Para entornos aislados, usa --permission-mode=dontAsk o --dangerously-skip-permissions para evitar bloqueos.

/loop programa una tarea recurrente localmente durante hasta 3 días a la vez. Algunos ejemplos que ejecuta el equipo de Claude Code:

A diferencia de /loop, los trabajos programados se ejecutan en la nube — continúan funcionando incluso cuando tu portátil está cerrado.

Claude Code tiene una aplicación móvil—descarga la aplicación Claude para iOS/Android y toca la pestaña Code. También está disponible un complemento de iMessage (/plugin install imessage@claude-plugins-official) para enviar tareas desde cualquier dispositivo Apple.

Mueve sesiones entre dispositivos móviles, web, escritorio y terminal:

También puedes habilitar "Habilitar Control Remoto para todas las sesiones" en /config.

Dispatch es un control remoto seguro para la aplicación Claude Desktop. Puede usar tus MCPs, navegador y computadora con tu permiso—útil para ponerte al día con Slack y correos electrónicos, gestionar archivos y hacer cosas en tu portátil cuando estés lejos.

Conecta Claude a tus herramientas existentes para que pueda buscar en Slack, ejecutar BigQuery, obtener registros de Sentry y más. Añade servidores MCP mediante claude mcp add o el bloque "mcpServers" en settings.json — consulta code.claude.com/docs/en/mcp para la configuración.

Pídele a Claude que use la CLI bq para extraer y analizar métricas sobre la marcha—mantén una habilidad de BigQuery registrada en tu base de código. La opinión del equipo de Claude Code: "Personalmente, no he escrito una línea de SQL en más de 6 meses." Esto funciona para cualquier base de datos que tenga una CLI, MCP o API.

Habilita el MCP de Slack, pega un hilo de error en Claude y simplemente di "fix"—sin cambio de contexto. O di "ve y corrige las pruebas de CI que fallan" sin microgestionar cómo. Apunta a Claude a docker logs para solucionar problemas de sistemas distribuidos—es sorprendentemente capaz en esto.

Los complementos agrupan LSPs (disponibles para todos los lenguajes principales), MCPs, habilidades, agentes y ganchos personalizados. Instala desde el mercado oficial de complementos de Anthropic, o configura un mercado interno para tu organización—luego registra la referencia del mercado en settings.json para que se añada automáticamente para cada desarrollador. Ejecuta /plugin para comenzar.

Ejecuta /config para establecer modo claro/oscuro y /terminal-setup para habilitar Shift+Enter para nuevas líneas en terminales IDE, Warp o Alacritty (Apple Terminal no es compatible con /terminal-setup). Para vinculaciones de teclas Vim, abre /config → Editor mode. El equipo recomienda Ghostty para renderizado sincronizado y color de 24 bits.

El modo de voz está disponible para todos los usuarios, incluidos Claude Code Desktop y Cowork. La mayoría de la codificación del equipo de Claude Code se realiza hablando—hablas aproximadamente 3× más rápido que escribes, y tus indicaciones se vuelven más detalladas como resultado.

Más allá del terminal, ejecuta sesiones adicionales en claude.ai/code. Usa el comando & para poner una sesión en segundo plano, o la bandera --teleport para cambiar contextos entre local y web.

Ejecuta /config y establece un estilo de salida. Explanatory hace que Claude explique marcos y patrones mientras trabaja (excelente para bases de código nuevas). Learning hace que Claude te guíe a través de cambios. También puedes crear estilos personalizados para ajustar la voz de Claude.

Son los pequeños detalles los que hacen que Claude Code se sienta personal. Pídele a Claude que personalice tus verbos de spinner para añadir o reemplazar la lista predeterminada. Registra el settings.json en el control de código fuente para compartir verbos con tu equipo.

Claude Code está diseñado para funcionar perfectamente desde el inicio, pero cuando personalices, guarda settings.json en git para que tu equipo también se beneficie. La configuración es compatible por base de código, por subcarpeta, por usuario o mediante políticas de toda la empresa.

Por los números: docenas de configuraciones y variables de entorno—consulta la referencia de configuración. Usa el campo "env" en settings.json para evitar scripts envolventes.

Por defecto, claude -p (y los SDKs de TypeScript/Python) busca archivos locales CLAUDE.md, configuraciones y MCPs. Para uso no interactivo, generalmente quieres especificar estos explícitamente mediante --system-prompt, --mcp-config, --settings, etc. Añade --bare para un inicio aproximadamente 10× más rápido:

Cuando trabajes en múltiples repositorios, usa --add-dir (o /add-dir) para dar a Claude acceso y permisos a carpetas adicionales. O añade "additionalDirectories" a settings.json de tu equipo para incluirlas siempre.

Para ramificar una sesión existente, ejecuta /branch desde dentro de ella, o claude --resume <session-id> --fork-session desde la CLI.

En Claude Code en web y escritorio, añade un script de configuración que se ejecute antes de cada nueva sesión en la nube—instala dependencias, configura ajustes, establece variables de entorno. El script se omite al reanudar.

Claude Code se actualiza frecuentemente. Verifica detalles específicos de la versión en code.claude.com/docs antes de distribuir internamente.