Buenas prácticas de Claude Code: menos correcciones y más control

Las buenas prácticas de Claude Code empiezan por hacer que el resultado se pueda comprobar, mantener cada sesión centrada en una tarea y automatizar las reglas que repites una y otra vez. Así conseguirás terminar más trabajo. Si llevas unas semanas usándolo, por tu cuenta o en un equipo pequeño, ese es el orden que conviene seguir. Incorpora agentes que trabajen en paralelo cuando una sola sesión ya sea capaz de completar una tarea acotada de forma fiable.

Las prácticas que siguen se apoyan en las recomendaciones de Anthropic para Claude Code y en la documentación del producto enlazada a lo largo del artículo. El orden, los ejemplos y el método para evaluar el ahorro son recomendaciones editoriales para equipos pequeños; no son resultados de una prueba de productividad de Anthropic.

Buenas prácticas de Claude Code: por dónde empezar

Empieza por el principio y deja de añadir mecanismos cuando hayas resuelto el problema. Cada hábito busca reducir un tipo de desperdicio distinto.

La última columna describe el beneficio que se busca. No garantiza una reducción fija de tokens, tiempo o gasto.

1. Dale a Claude una forma de demostrar que el cambio funciona

Define cómo comprobarás el resultado antes de pedir el cambio. Claude puede usar los resultados de las pruebas, la salida de la compilación o una comparación de capturas de pantalla para detectar errores y seguir trabajando. Pídele que muestre las evidencias al terminar. Anthropic: verificación.

Qué hacer: si vas a corregir envíos duplicados de un formulario, concreta el comportamiento esperado: varios clics deben crear un solo registro. Indica el archivo correspondiente, los pasos para reproducir el error y una comprobación que falle con la implementación actual.

Un ejemplo de encargo:

Corrige los envíos duplicados en el formulario de pago. Reproduce el fallo con una prueba, conserva el comportamiento de validación existente y ejecuta las pruebas pertinentes. Informa del comando, el resultado y cualquier aspecto que no hayas podido verificar.

Comando: npm test, si el repositorio tiene definido ese script. Sustitúyelo por el comando real de pruebas del proyecto e incluye la preparación necesaria. Si el comando falla porque faltan dependencias o datos de prueba, hay que resolver ese problema del entorno; el fallo no demuestra que el cambio sea incorrecto.

Para un cambio de interfaz, añade una captura de referencia y pide a Claude que capture el resultado en funcionamiento con una herramienta de navegador disponible. Revisa el diseño visualmente y el comportamiento con pruebas. Ninguna de las dos comprobaciones cubre por completo lo que revisa la otra.

Qué ahorras: dejas de hacer de intermediario entre cada intento fallido y la siguiente corrección. La revisión humana sigue siendo necesaria para valorar si los criterios de aceptación eran los adecuados.

2. Usa el modo Plan cuando no tengas claro el enfoque

Revisa la propuesta antes de invertir en una implementación grande. Inicia la sesión con claude --permission-mode plan o pulsa Shift+Tab hasta entrar en el modo Plan. Claude puede examinar el proyecto y proponer el trabajo antes de editar los archivos de código. Anthropic: planificar antes de editar.

Qué hacer: un equipo que vaya a incorporar un proveedor de autenticación podría pedir una lista de los archivos afectados, el flujo del callback, los casos de fallo, las necesidades de migración y los pasos de verificación. Así puede corregir el plan cuando resolver las diferencias todavía cuesta poco.

Comando: claude --permission-mode plan.

En ese cambio de autenticación, conviene revisar cuestiones concretas: ¿el plan reutiliza el código de sesiones existente, conserva los métodos de inicio de sesión actuales y prueba un callback caducado? Cuando tengas esas respuestas, aprueba el enfoque y pasa a la implementación.

No hace falta un plan formal para corregir una errata evidente o hacer una edición muy bien delimitada. Planificar también tiene un costo; hazlo cuando una decisión equivocada pueda obligarte a rehacer una cantidad considerable de trabajo. Anthropic: cuándo conviene planificar.

Qué ahorras: cambios que acabarías descartando y tiempo de revisión dedicado a descubrir que el código resolvió otro problema.

3. Mantén CLAUDE.md breve y concreto

Guarda las instrucciones duraderas del equipo en el archivo CLAUDE.md del proyecto. Incluye el comando de pruebas, la preparación del entorno que no resulte obvia, los límites de la arquitectura y las convenciones que se aparten de lo habitual. Claude carga estas instrucciones como contexto. Anthropic: memoria del proyecto.

Qué hacer: si las sesiones de un equipo pequeño usan una y otra vez el gestor de paquetes equivocado, el equipo puede anotar el comando correcto y explicar por qué importa. Si trabaja con clientes de API generados, puede indicar dónde está el esquema fuente y cómo regenerar esos clientes.

Archivo: CLAUDE.md en la raíz del proyecto, revisado junto con el código que describe.

Deja los detalles temporales en el encargo de cada tarea. Elimina las reglas obsoletas cuando cambie el proyecto. Una línea útil evita un error recurrente; una instrucción genérica para producir código excelente aporta poca orientación.

Distingue este archivo de la memoria automática, las notas que Claude escribe a partir de su experiencia. Esa memoria es local a la máquina y se comparte entre los worktrees del repositorio. No se convierte automáticamente en un manual compartido con tus compañeros. Usa /memory para consultarla o editarla. Anthropic: memoria automática.

Qué ahorras: volver a explicar el proyecto en cada sesión. Nuestra guía de CLAUDE.md explica la estructura del archivo y cómo mantenerlo al día.

4. Limpia el contexto al cambiar de tarea y compáctalo si vas a continuar

Piensa en la ventana de contexto —el material que Claude puede usar en la conversación actual— como una mesa de trabajo. Deja sobre ella los documentos de la tarea que tienes entre manos. Una investigación de un incidente ya resuelto no tiene por qué acompañar al siguiente cambio de CSS.

Qué hacer: guarda las decisiones útiles y los detalles del trabajo pendiente; después, usa /clear antes de empezar una tarea que no esté relacionada. Si vas a continuar una tarea larga, /compact resume la conversación; puedes indicarle qué decisiones y resultados de pruebas debe conservar. Anthropic: comandos de contexto.

Comando: /clear al cambiar de tarea.

Si llevas varios intentos fallidos de corregir un error, empieza por preparar un encargo más preciso: qué falla exactamente, qué enfoques se han descartado y cuál será la siguiente comprobación. Reinicia con ese encargo. Limpiar el contexto sin guardar lo aprendido solo obliga a repetir la investigación.

Usa /context para ver qué está ocupando espacio. Una ventana de contexto grande ofrece capacidad; no justifica acumular material ajeno a la tarea. Anthropic: referencia de comandos.

Qué ahorras: contexto innecesario y razonamientos repetidos sobre enfoques ya descartados. La compactación conserva un resumen, así que guarda los requisitos y comandos exactos en un archivo cuando perder detalles pueda ser un problema.

5. Mide el costo por cambio aceptado

Registra si la tarea terminó correctamente junto con su consumo. /usage muestra el consumo de la sesión y, para los suscriptores, información sobre el uso del plan. Los importes de la API en dólares son estimaciones; consulta la consola de facturación para conocer el cargo definitivo. Anota el resultado antes de limpiar la sesión, porque las versiones actuales reinician sus totales con /clear. Anthropic: seguimiento de costos.

Qué hacer: quien dirige un equipo puede llevar un registro sencillo con el tipo de tarea, el modelo, el consumo, el tiempo de corrección humana y si se aceptó el cambio. Compara correcciones de errores similares entre sí, en lugar de enfrentar un simple cambio de nombre con una migración compleja.

Comando: /usage.

Para una prueba piloto, usa esta fórmula:

Costo por cambio aceptado = (costo de la herramienta asignado al trabajo + costo de revisión y corrección humana) ÷ cambios aceptados.

Registra ese punto de partida antes de adoptar estos hábitos. Después, incluye el tiempo dedicado a mantener las instrucciones y los hooks. Una factura del modelo más baja no supone un ahorro si un compañero tarda más en rescatar el resultado. Con una suscripción fija, consumir menos tokens puede dejar margen para hacer más trabajo sin cambiar la cuota mensual.

Puedes cambiar de modelo con /model. Anthropic propone Sonnet para programar a diario, Opus para razonamientos complejos y Haiku para tareas sencillas. Tómalo como punto de partida para tus propias comparaciones entre tareas. Anthropic: configuración de modelos.

Qué ahorras: ampliaciones de plan innecesarias y el uso por defecto de modelos costosos cuando la parte difícil ya terminó. Consulta nuestra guía de precios de Claude Code cuando quieras comparar las opciones de facturación.

6. Configura los permisos antes de cansarte de aprobar acciones

Decide qué acciones pueden ejecutarse sin intervención y cuáles requieren tu atención. /permissions permite gestionar reglas para permitir, preguntar o denegar; Claude Code las aplica de forma independiente a las instrucciones de tu prompt. Anthropic: permisos.

Qué hacer: si tienes que aprobar repetidamente el mismo comando local de lint, puedes autorizar ese comando concreto después de comprobar qué hace. Quien dirige el equipo puede mantener la aprobación explícita para publicar cambios. No concedas un permiso amplio de ejecución en la terminal solo para eliminar una solicitud repetitiva.

Comando: /permissions.

Comprueba en qué modo estás trabajando. El modo Manual pide aprobación para la mayoría de las ediciones y los comandos. acceptEdits aprueba las ediciones y las operaciones habituales del sistema de archivos. El modo Auto delega la revisión de acciones en un clasificador. El modo inicial depende de la versión, la configuración, la disponibilidad y las políticas de la organización; revisa el indicador de modo en lugar de dar por hecho que todas las instalaciones funcionan igual. Anthropic: modos de permisos.

Qué ahorras: la atención que dedicas a aprobar trabajo rutinario. Eso no demuestra que la implementación sea correcta. Nuestra guía del modo Auto de Claude Code explica esa decisión por separado.

7. Usa hooks para las acciones obligatorias

Convierte una regla repetible en configuración ejecutable cuando ya no baste con recordársela a Claude. Los hooks de comandos son scripts que Claude Code ejecuta en los eventos configurados. Pueden automatizar el formato del código o validar una acción propuesta. Anthropic: automatización con hooks.

Qué hacer: si un equipo detecta una y otra vez ediciones en archivos generados, puede implementar una comprobación PreToolUse para las herramientas de edición correspondientes. Esa comprobación debe rechazar la acción con una explicación útil e indicar qué archivo fuente hay que modificar.

Archivo: .claude/settings.json, con una configuración hooks para el proyecto. Consulta la configuración cargada con /hooks.

Elige bien el evento. Un hook PreToolUse puede detener una acción que coincida con sus criterios antes de que se ejecute. Un hook PostToolUse se ejecuta después, así que no puede impedir lo que ya ocurrió. Aplicar la regla a Edit y Write no cubre un comando de terminal que escriba en el mismo archivo. Anthropic: eventos de hooks y control de decisiones.

Prueba tanto una acción permitida como una rechazada antes de confiar en la regla. Limita el alcance de las comprobaciones para que una edición corriente no active un conjunto de pruebas lento y ajeno al cambio.

Qué ahorras: recordatorios repetidos y correcciones que podrían haberse evitado. La fiabilidad de un hook depende del script y de los eventos que cubra. Nuestra guía de configuración de hooks de Claude Code explica los detalles de configuración.

8. Delega investigaciones acotadas en subagentes

Delega una pregunta de investigación cuando los resultados intermedios vayan a saturar la conversación principal. Los subagentes trabajan en contextos separados y devuelven los resultados. Sus solicitudes también cuentan para tus límites de uso. Anthropic: subagentes.

Qué hacer: si investigas un fallo intermitente de inicio de sesión, puedes pedir a un subagente que revise el flujo de renovación y devuelva los archivos relevantes, las evidencias y las preguntas pendientes. Mantén la sesión principal centrada en elegir e implementar la solución.

Por ejemplo:

Usa un subagente para seguir el flujo de una sesión caducada. No edites archivos. Devuelve las ubicaciones de los archivos relevantes, las comprobaciones que ya existen y las carencias que encuentres.

Archivo: una definición en Markdown dentro de .claude/agents/ cuando se trate de una función recurrente. Configura las herramientas adecuadas para esa función, por ejemplo, herramientas de solo lectura para investigar. Una petición puntual no necesita un archivo de agente personalizado.

Qué ahorras: espacio en la conversación principal y tiempo de lectura de la exploración intermedia. La delegación y las investigaciones duplicadas pueden aumentar el consumo total, así que asigna una sola pregunta y delimita la respuesta. Nuestra guía de subagentes explica cuándo merece la pena crear un especialista reutilizable.

9. Añade worktrees solo para tareas independientes

Asigna directorios de trabajo separados a las sesiones que vayan a editar al mismo tiempo. Un worktree de Git es otra copia de trabajo con sus propios archivos y su propia rama, que comparte el historial del repositorio. Evita que las ediciones de una sesión aparezcan en los archivos sobre los que está trabajando otra. Anthropic: worktrees.

Qué hacer: un equipo pequeño puede desarrollar una funcionalidad en un entorno aislado mientras otra sesión corrige un error sin relación con ella. Delimita cada tarea y asigna a alguien la revisión e integración de los resultados.

Comando: claude --worktree feature-auth. Usa otro nombre de worktree en la segunda terminal.

Una copia de trabajo recién creada sigue necesitando dependencias y el entorno de desarrollo requerido. Comprueba que estén preparados antes de valorar los resultados de las pruebas. El repositorio también debe tener al menos un commit. Anthropic: preparación del entorno del worktree, flujo de sesiones paralelas.

Qué ahorras: esperas cuando las tareas son independientes y trabajo de recuperación cuando varias sesiones interfieren en los mismos archivos. Los worktrees no eliminan la revisión de las fusiones, las pruebas de integración ni el costo de ejecutar otra sesión. Si ambas tareas rediseñan la misma interfaz, acuerda primero cómo será esa interfaz.

Dos herramientas pequeñas que vale la pena crear después de dominar lo básico

Construye una herramienta solo si responde a un problema que siga apareciendo en los registros del equipo. Estas son hipótesis de producto, no negocios demostrados.

Un registro de costos por sesión es la oportunidad más prometedora. Quien dirige el desarrollo puede usarlo para relacionar los resultados de cada tarea con el consumo y las correcciones humanas. Una consulta de DataForSEO realizada el 11 de octubre de 2026 estimó 4,400 búsquedas mensuales en Google en Estados Unidos de «claude code cost». Ese dato indica interés por los costos, no disposición a pagar. La API Keyword Overview describe la fuente de la métrica.

La versión mínima útil consiste en un formulario de tareas y datos de consumo importados o introducidos a mano, agrupados por tipo de tarea y modalidad de facturación. Un equipo podría pagar por tener informes consistentes entre proyectos. La dificultad está en atribuir los costos: el costo estimado de una sesión, una cuota de suscripción y el tiempo de una persona son medidas distintas. Mantenlas separadas antes de combinarlas para tomar una decisión.

Una revisión de la preparación del repositorio podría venderse como un servicio de puesta a punto y mantenimiento para equipos. La misma consulta de DataForSEO estimó 1,900 búsquedas mensuales en Estados Unidos de «claude code best practices». Una agencia pequeña o un equipo de ingeniería podría pagar por una revisión que detecte comandos de pruebas obsoletos, requisitos previos sin cumplir, instrucciones contradictorias y hooks que ya no funcionan.

Empieza con un repositorio y un informe que un desarrollador pueda verificar. La dificultad es que resulta fácil copiar una plantilla genérica; el trabajo valioso consiste en mantener la precisión de las comprobaciones a medida que cambia el repositorio. Ninguna de las dos estimaciones de búsquedas demuestra que haya demanda de estos productos concretos. Valida el problema con equipos reales antes de crear un panel.

Lo que estos hábitos no pueden resolver

No pueden suplir una decisión de producto pendiente, convertir un conjunto de pruebas insuficiente en uno completo ni garantizar que una acción permitida sea correcta. Una sesión puede producir con eficiencia la funcionalidad equivocada si el encargo nunca dejó claro qué necesitaba el usuario.

Mi recomendación es tomar los primeros cuatro hábitos como base. Empieza a medir de inmediato y después incorpora permisos, hooks, delegación y trabajo en paralelo donde los fallos recurrentes del equipo lo justifiquen. Cada nueva configuración también exige mantenimiento.

¿Estos hábitos reducirán mi factura mensual de Claude Code?

Pueden reducir el consumo evitable y el trabajo que hay que rehacer. Con una suscripción fija, eso puede traducirse en más trabajo útil dentro del mismo límite, en lugar de una factura más baja. Si pagas por consumo, compara los cargos reales de trabajos aceptados equivalentes. Incluye el tiempo de corrección humana en la comparación. Anthropic: costos.

¿El costo estimado de la sesión en dólares es lo que tengo que pagar?

No. El costo de sesión que muestra Claude Code es una estimación del consumo de la API, no una factura adicional para quien tiene una suscripción. Consulta la consola de facturación para conocer los cargos definitivos de la API y la vista de uso de tu plan para saber cuánto estás consumiendo de tu límite. Anthropic: informes de uso.

¿Conviene contratar un plan mayor antes de cambiar mi forma de trabajar?

Amplía el plan cuando el límite de uso frene de forma recurrente un trabajo útil y bien acotado, y la capacidad adicional justifique su precio. Antes, comprueba si los intentos fallidos, la preparación repetida o las sesiones simultáneas innecesarias están consumiendo ese límite. Un plan mayor te da más margen; no decide cómo aprovecharlo.

Por dónde empezar el lunes

Elige una tarea recurrente, como corregir un error pequeño, y ejecútala con un encargo preciso y una comprobación de aceptación por escrito. Registra el resultado, el consumo y el tiempo de corrección. Guarda en CLAUDE.md solo lo que pueda servir de nuevo. Repite ese flujo de trabajo antes de añadir otro agente.

Si tu equipo necesita integrar estas comprobaciones y flujos de trabajo en su proceso de desarrollo, creamos sistemas de IA para producción.