Del creador de Kumamap (389K usuarios)

Domina Claude Code en Días, No Meses

Los flujos de trabajo, atajos y configuraciones que separan a los principiantes de los usuarios avanzados.

Empezar a Leer

¿Por qué confiar en esta guía?

Danyel Koca
"Descubrí lo que realmente funciona con Claude Code a través de cientos de horas de prueba y error. Esta guía es todo lo que aprendí."

Danyel Koca

Ingeniero de Investigación Aplicada en Sakana AI

Anteriormente Científico de Datos Senior en McKinsey & Company

¿Te suena familiar?

Estas frustraciones me llevaron a escribir esta guía

Claude ignora CLAUDE.md

Tus instrucciones personalizadas son ignoradas u olvidadas en medio de la conversación

Sobre-ingeniería todo

Pides una función simple, obtienes 500 líneas de abstracción

Resultados diferentes cada vez

El mismo prompt, calidad de salida muy diferente

Dice terminado pero está roto

Entrega código con confianza que en realidad no funciona

La Experiencia Detrás de Esta Guía

No solo leí sobre estos problemas, los viví.

Terminal
$ ccusage --total
Total Tokens: 2.772.274.103
Total Cost: $2.288,41
Period: 28 Nov 2025 - 5 Ene 2026

2.7 mil millones de tokens de lecciones aprendidas, condensadas en 51 consejos prácticos.

Prueba de que Funciona

Construí Kumamap — el rastreador de osos #1 de Japón — completamente con Claude Code. Esta guía te enseña los patrones exactos que usé.

389,000
usuarios
1.3 millones
vistas de página
3 meses
para construir
Ver el producto en vivo →
Kumamap

Que Incluye

51 consejos en 13 secciones

Configuración

Terminal, CLAUDE.md, atajos y comandos

3 consejos
1

Usa la Terminal

Usar Claude Code en la terminal es la forma más flexible de interactuar con él.

2

Crea CLAUDE.md

El manual de instrucciones de tu proyecto para Claude. El archivo más importante para un uso efectivo de Claude Code.

3

Atajos y Comandos

Atajos de teclado y comandos esenciales para un uso eficiente de Claude Code.

Seguridad

Git, permisos, protección de archivos sensibles

4 consejos
4

Usa Git Extensivamente

Git es tu red de seguridad cuando Claude hace cambios amplios. Haz commits frecuentes, revisa diffs y conoce tus comandos de recuperación.

5

Protege Archivos Sensibles

Claude Code lee automáticamente archivos .env sin preguntar. Añade reglas deny para proteger secretos.

6

Nunca Auto-Apruebes Comandos Bash

Auto-aprobar comandos bash es lo más peligroso que puedes hacer con Claude Code.

7

Auto-Aprueba Acciones Seguras

Acelera tu flujo de trabajo auto-aprobando acciones de bajo riesgo como lecturas y búsquedas.

Planificación

Modo plan, planes detallados, pensamiento end-to-end

4 consejos
8

Siempre Usa el Modo Plan

Presiona Shift+Tab dos veces para entrar en modo plan antes de tareas complejas. Claude piensa antes de codificar.

9

Nunca Aceptes Planes Genéricos

Siempre asegúrate de que el plan sea detallado a nivel de código y factual.

10

Valida Contra CLAUDE.md

Pide a Claude que valide su plan contra las reglas de CLAUDE.md. Claude olvida instrucciones a medida que las conversaciones crecen.

11

Fuerza el Pensamiento de Extremo a Extremo

Haz que Claude trace el camino completo desde la acción hasta el resultado.

Prompting

Ultrathink, ser directo, exagerar importancia

6 consejos
12

Ultrathink Siempre Activo

Nunca dejes que Claude diga lo primero que se le ocurra. Déjalo pensar. SIEMPRE.

13

Sé Directo

Sé explícito sobre cantidades. Claude tiende a elegir el camino fácil.

14

Di Qué Hacer, No Qué NO Hacer

Siempre proporciona una alternativa cuando le dices a Claude qué no hacer.

15

Exagera la Importancia

Claude calibra el esfuerzo según la importancia percibida. Alta importancia = trabajo exhaustivo.

16

Trata a Claude como Herramienta, No Persona

No te preocupes por ser cortés. Claude se comporta mejor cuando eres directo.

17

Claude Sobresale en Tareas de Asistente - Guíalo en Trabajos Estratégicos

Convierte tareas estratégicas en trabajos tipo asistente guiando a Claude a investigar primero.

Sesión

Gestión de contexto, reanudar, degradación de calidad

4 consejos
18

Una Tarea = Una Sesión

Cuando la tarea termine, ciérrala. Usa /clear para limpiar el contexto y empezar de nuevo.

19

La Calidad Degrada en Sesiones Largas

La ventana de contexto se llena. Claude se vuelve más torpe. Sabe cuándo compactar o limpiar.

20

Usa /resume para Continuar Sesiones

¿Claude se cayó? ¿Se cerró la terminal? Usa /resume para retomar donde lo dejaste.

21

Nunca Confíes en 'Todo Listo'

Claude a menudo omite casos límite o salta pasos silenciosamente. Siempre verifica.

Entrada

Imágenes, capturas de pantalla, mensajes de error

2 consejos
22

Usa Imágenes/Capturas

Pega capturas directamente con Ctrl+V para bugs visuales. Una imagen vale mil tokens.

23

Copia Mensajes de Error Textualmente

No parafrasees. Stack trace completo con números de línea.

Multi-Agente

Agentes paralelos, worktrees, subagentes

5 consejos
24

No Esperes Perfecto a la Primera

Deja que un agente codifique, usa otro agente para revisar el código.

25

Múltiples Agentes para Trabajos Grandes

Lanza múltiples agentes con el mismo prompt. Para tareas grandes es raro que un agente lo haga bien.

26

Divide Problemas Complejos en Pasos

Mejor tener una sesión por sub-tarea que una sesión masiva.

27

Git Worktrees

Múltiples directorios de trabajo del mismo repo. Ejecuta Claude en cada uno.

28

Subagentes - Usa con Precaución

Los resúmenes de subagentes pierden detalle. Para código crítico, haz que el agente principal lea archivos directamente.

Personalización

Configuraciones jerárquicas, comandos, agentes personalizados

3 consejos
29

CLAUDE.md Jerárquico

CLAUDE.md en la raíz del proyecto + subdirectorios + global. Claude prioriza el más específico.

30

Comandos Slash Personalizados

Crea flujos de trabajo reutilizables en la carpeta .claude/commands/.

31

Agentes Personalizados

Crea agentes especializados con su propia ventana de contexto, prompt de sistema y restricciones de herramientas.

Trampas

Comportamientos comunes de Claude a vigilar

8 consejos
32

Claude Inventa URLs

Alucina URLs que no existen. Siempre verifica antes de confiar en enlaces externos.

33

Claude Sobre-Ingeniería

Pides una función simple, obtienes una clase abstracta con patrón factory.

34

Claude Crea Duplicados

Claude no busca en tu código. Solo escribe código nuevo.

35

Claude es Aditivo, Nunca Sustractivo

Claude solo añade código. Nunca elimina. Tienes que forzar la eliminación explícitamente.

36

Claude es un YES MAN

Claude está de acuerdo con todo lo que dices. Dile que cuestione tus suposiciones.

37

Claude Asume en Vez de Preguntar

¿Requisito ambiguo? Claude elige una interpretación y sigue adelante.

38

Claude Lee Archivos Parcialmente

Claude lee el primer fragmento y empieza a trabajar. ¿Función crítica en la línea 400? La perdió.

39

Claude Modifica Tests en Vez de Arreglar Código

Cuando el código está mal, Claude cambia las aserciones del test para que coincidan con el código malo.

Avanzado

Hooks, servidores MCP, skills, modo headless

5 consejos
40

Hooks

Comandos shell que se ejecutan en eventos específicos como ediciones, uso de herramientas o inicio de sesión.

41

Servidores MCP

Conecta herramientas externas - bases de datos, automatización de navegador, búsqueda de docs.

42

Skills

Comportamientos auto-activados que se cargan automáticamente cuando son relevantes.

43

GitHub Actions

Ejecuta /install-github-app para configurar Claude en tus repos.

44

Modo Headless

Ejecuta Claude sin sesión interactiva. Para automatización y scripts.

Casos de Uso

Verificaciones de calidad, POCs, aprendizaje, commits

5 consejos
45

Ejecuta Chequeos de Calidad Periódicamente

Cada consulta = 1 sesión. Revisa textos hardcodeados, consistencia de diseño, etc.

46

Aprovecha Claude Code para POCs

Perfecto para prototipado rápido. Para POCs, deja que Claude se desate.

47

Claude es Genial para Boilerplate

Operaciones CRUD, formularios, archivos de config, patrones repetitivos. Deja que Claude trabaje.

48

Usa Claude para Aprender

No solo dejes que Claude escriba código. Haz que explique.

49

Claude para Mensajes de Commit

Deja que Claude escriba commits desde tu diff. Formato consistente, captura el 'por qué'.

Cierre

Sabiduría final para encontrar tu flujo de trabajo

1 consejos
50

No Persigas Cada Nueva Característica

Claude Code tiene nuevas características cada semana. Enfócate en lo que funciona.

Bonus

CLAUDE.md probado en batalla de 6 meses de uso diario

1 consejos
51

CLAUDE.md Probado en Batalla

Un ejemplo real de CLAUDE.md destilado de 6 meses de lecciones, fallos y correcciones.

Featured Tips

Start with these popular tips

Crea CLAUDE.md
#2

Crea CLAUDE.md

El manual de instrucciones de tu proyecto para Claude. El archivo más importante para un uso efectivo de Claude Code.

Ultrathink Siempre Activo
#12

Ultrathink Siempre Activo

Nunca dejes que Claude diga lo primero que se le ocurra. Déjalo pensar. SIEMPRE.

La Calidad Degrada en Sesiones Largas
#19

La Calidad Degrada en Sesiones Largas

La ventana de contexto se llena. Claude se vuelve más torpe. Sabe cuándo compactar o limpiar.

Subagentes - Usa con Precaución
#28

Subagentes - Usa con Precaución

Los resúmenes de subagentes pierden detalle. Para código crítico, haz que el agente principal lea archivos directamente.