02
Nivel 02 · Intermedio

Flujo de trabajo

Decide cuánta autonomía darle, enséñale las reglas del proyecto, administra el contexto como el recurso más escaso y trabaja con método: explorar, planificar, implementar, verificar.

Lección 2.1

Modos de permiso

El modo define qué hace Claude sin preguntarte. Desde la versión 2.1.283, las sesiones interactivas de terminal y VS Code parten en modo auto (antes solo en planes Pro, Max y Team). Las corridas con claude -p y el Agent SDK parten en modo Manual. Cambia de modo con Shift+Tab: enfoca el widget y pruébalo.

Ciclo de modos

AcciónComportamiento

Cómo funciona el modo auto

Un modelo clasificador separado revisa las acciones antes de ejecutarlas y bloquea lo que escala más allá de tu pedido, apunta a infraestructura desconocida o parece motivado por contenido hostil. Lecturas y ediciones dentro del directorio de trabajo se aprueban sin pasar por el clasificador.

Bloqueado por defectocurl | bash, deploys y migraciones a producción, force push, git reset --hard, terraform destroy, mergear PRs sin aprobar, imprimir credenciales en el transcript.
Permitido por defectoOperaciones locales en el directorio de trabajo, instalar dependencias declaradas en lockfiles, requests HTTP de solo lectura, push a ramas del repo que no sean de deploy.
  • Si dices "no hagas push" en la conversación, se trata como un bloqueo hasta que lo levantes. Pero puede perderse al compactar: para una garantía real, usa una regla deny.
  • Tras 3 bloqueos seguidos o 20 en total, auto mode se pausa y vuelven los prompts. Las acciones bloqueadas aparecen en /permissions bajo "Recently denied"; con r reintentas con aprobación manual.
  • dontAsk no está en el ciclo: se activa con --permission-mode dontAsk y deniega todo lo que pediría permiso. Ideal para CI.
  • auto y bypassPermissions no se aceptan como defaultMode en settings del proyecto; ponlos en ~/.claude/settings.json.
bypassPermissionsSolo en contenedores o VMs aislados, idealmente sin internet. No protege contra prompt injection. En Linux y macOS, Claude Code se niega a arrancar como root en este modo salvo que detecte un sandbox reconocido. Las reglas deny siguen aplicando.
Lección 2.2

Reglas allow / ask / deny

Encima del modo defines reglas finas con la sintaxis Herramienta(especificador). Se evalúan en orden fijo: deny, luego ask, luego allow. Gana la primera coincidencia en ese orden; la especificidad no cambia el orden. deny bloquea en todos los modos, incluido bypass.

Probador de reglas Bashsimplificado según la documentación

Un * coincide con cualquier texto, espacios incluidos. Un ␣* final también coincide con el comando pelado (Bash(ls *) coincide con ls, no con lsof). En comandos compuestos con &&, ||, ; o |, cada subcomando debe coincidir con un allow; un deny o ask aplica si coincide con cualquiera.

Sintaxis por herramienta

ReglaSignificado
Bash(npm run *)Cualquier script de npm. Pon el * después del subcomando, no antes.
Read(./.env)Ruta relativa al directorio actual
Edit(/src/**/*.ts)Ruta relativa al origen de la configuración (en settings del proyecto: la raíz del proyecto)
Read(~/.ssh/**)Desde tu home
Read(//etc/**)Ruta absoluta desde la raíz del sistema
WebFetch(domain:docs.stripe.com)Solo ese dominio; *.example.com cubre subdominios
mcp__github__*Todas las herramientas del servidor MCP github
Agent(Explore)Un subagente específico (útil en deny)
.claude/settings.json
{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "permissions": {
    "allow": ["Bash(pnpm run *)", "Bash(git diff *)", "Bash(git log *)"],
    "ask":   ["Bash(git push *)"],
    "deny":  ["Read(./.env)", "Read(./.env.*)", "Read(./secrets/**)"]
  }
}
Límite de las reglas BashUna regla coincide con el texto del comando tal como Claude lo escribe. Bash(curl *) no detiene /usr/bin/curl … ni sh -c 'curl …'. Para una barrera que no dependa del texto, usa el sandbox (Avanzado) o un hook PreToolUse.

/permissions abre un diálogo para ver reglas por scope, agregarlas o quitarlas. La skill incluida /fewer-permission-prompts revisa tus transcripts y propone una allowlist priorizada de comandos de solo lectura.

A fondoSettings a fondoDónde vive cada regla y cuál gana cuando chocan.→
Lección 2.3

CLAUDE.md: qué poner y qué no

CLAUDE.md es un Markdown que Claude lee al inicio de cada sesión. Escribe ahí lo que, de otro modo, tendrías que volver a explicar. /init genera uno inicial; si ya existe, sugiere mejoras en vez de sobrescribirlo.

Incluir Excluir
Comandos Bash que Claude no puede adivinarLo que Claude deduce leyendo el código
Reglas de estilo que difieren de lo estándarConvenciones del lenguaje que Claude ya conoce
Cómo correr tests y qué runner preferirDocumentación de API detallada (enlázala)
Etiqueta del repo: ramas, PRsInformación que cambia seguido
Decisiones de arquitectura propias del proyectoExplicaciones largas o tutoriales
Peculiaridades del entorno (variables requeridas)Descripciones archivo por archivo
Trampas y comportamientos no obviosObviedades como "escribe código limpio"
Constructor de CLAUDE.md
  • Tamaño: apunta a menos de 200 líneas por archivo. Archivos largos consumen contexto y bajan la adherencia.
  • Concreto y verificable: "usa indentación de 2 espacios" en vez de "formatea bien"; "corre npm test antes de commitear" en vez de "prueba tus cambios".
  • Para cada línea pregúntate: "¿quitarla haría que Claude se equivoque?". Si no, bórrala.
  • Énfasis: si ignora una instrucción, marca solo esa con "IMPORTANT". Si enfatizas muchas, ninguna destaca.
  • Auditoría: /doctor prompt-audit busca instrucciones obsoletas, referencias rotas y contradicciones, y propone ediciones.
  • Comentarios HTML (<!-- nota -->) se eliminan antes de inyectarse: notas para humanos que no cuestan tokens.
Cuándo agregar algoCuando Claude comete el mismo error por segunda vez, cuando un code review detecta algo que Claude debió saber, o cuando escribes la misma corrección que la sesión anterior. Trata CLAUDE.md como código: versiónalo, revísalo y pódalo.
Lección 2.4

Jerarquía de memoria, imports y rules

CLAUDE.md puede vivir en varios lugares. Todos se concatenan en el contexto (no se sobrescriben), de lo más amplio a lo más específico.

AlcanceUbicaciónCompartido con
Política gestionadamacOS /Library/Application Support/ClaudeCode/CLAUDE.md · Linux/WSL /etc/claude-code/CLAUDE.md · Windows C:\Program Files\ClaudeCode\CLAUDE.mdToda la organización
Usuario~/.claude/CLAUDE.mdSolo tú, todos los proyectos
Proyecto./CLAUDE.md o ./.claude/CLAUDE.mdEl equipo vía git
Local./CLAUDE.local.md (agrégalo a .gitignore)Solo tú, este proyecto
  • Carga por directorio: al lanzar en foo/bar/ se cargan foo/CLAUDE.md y foo/bar/CLAUDE.md. Los CLAUDE.md de subdirectorios se cargan bajo demanda cuando Claude toca archivos ahí.
  • Imports: @README o @docs/git.md dentro de CLAUDE.md expande ese archivo. Rutas relativas al archivo que importa, hasta cuatro saltos de profundidad. Envuelve en backticks para mencionar sin importar. Los imports organizan, pero no reducen el costo de contexto.
  • AGENTS.md: si el repo tiene AGENTS.md y no tiene CLAUDE.md, Claude lo lee directamente. Si tiene ambos, por defecto lee solo CLAUDE.md (configurable en /config → Project instructions).
  • Monorepos: claudeMdExcludes en settings omite CLAUDE.md de otros equipos por ruta o glob.

Rules con alcance por ruta

Archivos en .claude/rules/ (descubiertos recursivamente) modularizan instrucciones. Sin paths se cargan siempre; con paths solo cuando Claude lee o edita archivos que coinciden, lo que ahorra contexto.

.claude/rules/api.md
---
paths:
  - "src/app/api/**/*.ts"
  - "src/**/*.{ts,tsx}"
---
# Reglas de API
- Todo endpoint valida su input con zod
- Usa el formato estándar de respuesta de error
- Documenta con comentarios OpenAPI

Las rules personales en ~/.claude/rules/ aplican a todos tus proyectos. Para compartir rules entre repos, .claude/rules/ admite symlinks.

Lección 2.5

Auto memory

Además de lo que tú escribes, Claude guarda notas para sí mismo a medida que trabaja. Está activa por defecto en sesiones locales.

CLAUDE.mdAuto memory
Quién escribeTúClaude
ContieneInstrucciones y reglasAprendizajes y patrones
AlcanceProyecto, usuario u organizaciónPor repositorio, compartida entre worktrees
Se cargaCompleto, cada sesiónLas primeras 200 líneas o 25 KB de MEMORY.md
  • Tipos de nota: user (tu rol y preferencias), feedback (correcciones que le das), project (trabajo en curso y decisiones que no se deducen del código), reference (dónde está la información externa).
  • Qué no guarda: lo que se deduce del código (arquitectura, rutas) ni lo que ya dice tu CLAUDE.md.
  • Dónde vive: ~/.claude/projects/<proyecto>/memory/, con un índice MEMORY.md y un archivo por tema que se lee bajo demanda. Es local a tu máquina.
  • Controlarla: /memory lista archivos de memoria, permite editarlos y activar o desactivar la auto memory. También "autoMemoryEnabled": false o CLAUDE_CODE_DISABLE_AUTO_MEMORY=1.
"Recuerda que…" vs "agrega a CLAUDE.md"Si dices "recuerda que los tests de API necesitan Redis local", va a la auto memory (solo tuya). Si dices "agrega esto a CLAUDE.md", queda en el archivo del equipo.
Lección 2.6

Plan mode: explorar, planificar, implementar

Saltar directo a codificar puede producir código que resuelve el problema equivocado. En plan mode Claude lee, explora y escribe un plan, pero las ediciones quedan bloqueadas hasta que apruebes. Entra con Shift+Tab, con /plan arregla el bug de auth o con claude --permission-mode plan.

Flujo recomendado
Pulsa reproducir o haz clic en una etapa.

Al aprobar el plan

  • Yes, and use auto mode: aprueba y pasa a modo auto (o "auto-accept edits" si auto no está disponible).
  • Yes, manually approve edits: revisas cada edición.
  • No, keep planning: sigues en plan mode y das feedback.
  • Ctrl+G abre el plan en tu editor para modificarlo antes de aprobar. Aprobar un plan también le pone título a la sesión.

El patrón entrevista + spec

Para features grandes, deja que Claude te entreviste antes de escribir una línea:

prompt
Quiero construir [descripción breve]. Entrevístame en detalle usando la herramienta AskUserQuestion.
Pregunta sobre implementación técnica, UI/UX, casos borde, riesgos y tradeoffs. No hagas preguntas obvias;
profundiza en lo difícil que quizás no he considerado. Sigue hasta cubrir todo y escribe la spec completa en SPEC.md.

Luego abre una sesión nueva para ejecutar la spec: contexto limpio, enfocado solo en implementar.

Cuándo no planificarSi puedes describir el diff en una frase (un typo, un log, renombrar una variable), pídelo directo. El plan rinde cuando no estás seguro del enfoque, el cambio toca varios archivos o no conoces el código.
Lección 2.7

Contexto: el recurso más escaso

Casi todas las buenas prácticas nacen de una restricción: la ventana de contexto se llena rápido y el rendimiento baja a medida que se llena. Contiene toda la conversación, cada archivo leído y cada salida de comando. Este medidor usa los valores de ejemplo de la simulación oficial sobre una ventana de 200k tokens.

Medidor de contexto

Qué se carga al iniciar (valores de ejemplo)

ElementoTokens aprox.Nota
System prompt4.200Siempre primero; no lo ves
Auto memory (MEMORY.md)680Hasta 200 líneas o 25 KB
Info del entorno280Directorio, plataforma, shell; git va en otro bloque
Herramientas MCP120Solo nombres; los schemas se cargan bajo demanda (tool search)
Descripciones de skills450El contenido completo carga solo al usarse
~/.claude/CLAUDE.md + CLAUDE.md del proyecto320 + 1.800Completos, en cada request

Herramientas para administrarlo

  • /context muestra el uso como grilla de colores con sugerencias; /context all detalla el costo de cada herramienta MCP.
  • /clear entre tareas no relacionadas. Pasa /clear nombre para etiquetar la sesión que dejas y retomarla con /resume.
  • /compact concéntrate en los cambios de API resume con foco. También puedes agregar una sección "Compact Instructions" en CLAUDE.md.
  • Auto-compactación: al acercarse al límite, Claude Code primero limpia salidas viejas de herramientas y luego resume. Tus pedidos y el código clave se preservan; instrucciones tempranas pueden perderse. Ajusta el umbral con /autocompact.
  • /btw para preguntas al margen que no deben quedar en el historial.
  • Rewind → Summarize from here / up to here compacta solo una parte de la conversación.
Regla prácticaSi corregiste a Claude más de dos veces por lo mismo en una sesión, el contexto está lleno de intentos fallidos. Haz /clear y empieza con un prompt mejor que incorpore lo aprendido. Una sesión limpia con buen prompt casi siempre supera a una larga con correcciones acumuladas.
Lección 2.8

Tokens y prompt caching

Claude no lee palabras: lee tokens, trozos de texto que pueden ser una palabra corta, parte de una palabra larga o un símbolo. Todo se mide en tokens: lo que entra (tu prompt, los archivos, la conversación) y lo que sale (la respuesta y el razonamiento). Y todo se cobra en tokens, o se descuenta de los límites de tu plan.

Hay un detalle que cambia cómo conviene trabajar: el modelo no recuerda nada entre un mensaje y otro. En cada turno, Claude Code vuelve a enviar la conversación completa: instrucciones de sistema, herramientas, CLAUDE.md, cada archivo leído y cada respuesta anterior. Una sesión de 100k tokens envía esos 100k tokens otra vez con cada mensaje nuevo.

En simple

Sin caché, cada mensaje pagaría de nuevo toda la conversación. El prompt caching guarda el comienzo de lo que ya enviaste; mientras ese comienzo siga idéntico y el caché no haya expirado, se cobra a una fracción del precio. Claude Code lo usa solo, sin configurar nada. Tu trabajo es no romperlo sin darte cuenta.

Cuánto cuesta cada tipo de token

Precio de API por millón de tokens, noviembre de 2026. Con suscripción no pagas por token, pero las mismas proporciones definen cuánto de tu límite consume cada cosa.

ModeloEntradaSalidaLeído de cachéEscrito en caché (5 min / 1 h)
Opus 5.5US$4US$20US$0,20US$5 / US$8
Sonnet 5.5US$2US$10US$0,10US$2,50 / US$4
Haiku 5.5US$0,10US$0,50US$0,01US$0,125 / US$0,20
  • La salida cuesta 5 veces la entrada. El razonamiento (thinking) se cobra como salida, aunque no lo veas. Por eso el effort importa tanto como el modelo.
  • Leer del caché cuesta un 5% del precio de entrada en Opus 5.5 y Sonnet 5.5 (un 10% en la mayoría de los demás modelos).
  • Escribir en el caché cuesta un poco más que la entrada normal: 1,25 veces con duración de 5 minutos, 2 veces con duración de 1 hora. Se paga una vez y se recupera con la siguiente lectura.

Cómo funciona: un prefijo idéntico

El caché compara el comienzo exacto de cada petición con lo que ya guardó. Si un solo byte cambia en una posición, todo lo que viene después se vuelve a procesar a precio completo. Claude Code ordena lo que envía de lo más estable a lo más cambiante:

CapaQué contieneCuándo cambia
1. SistemaInstrucciones base y definiciones de herramientasSi cambia el conjunto de herramientas
2. ProyectoCLAUDE.md, auto memory y reglasAl iniciar, tras /clear o /compact
3. ConversaciónTus mensajes, las respuestas y los resultados de herramientasCrece en cada turno

Cada turno solo agrega al final, así que en una sesión sana casi todo se lee del caché y solo se escribe lo nuevo. Cada lectura además reinicia el reloj del caché.

Ahora pruébalo tú: el simulador te deja combinar acciones y ver el costo de cada petición.

Simulador de caché
leído de caché (barato)escrito en cachésalida

Montos con precios de API de Sonnet 5.5. Escribir en el caché cuesta más que la entrada normal (el doble con la duración de 1 hora), así que la primera petición, y cada vez que el caché se rompe, sale más cara que sin caché. Se recupera desde la siguiente lectura: en una sesión de varios mensajes, el caché ahorra la mayor parte del costo.

Qué rompe el caché y qué no

Lo rompe: la siguiente respuesta relee todo a precio completoNo lo rompe
Cambiar de modelo con /model: cada modelo tiene su propio cachéEditar archivos del repositorio
Activar o desactivar fast modeEditar CLAUDE.md: el cambio se aplica recién tras /clear, /compact o reiniciar
Cambiar el effort, en la mayoría de los modelos (no en Opus 5.5, Sonnet 5.5, Haiku 5.5 ni Fable 5.1+ con API key o suscripción)Cambiar el modo de permisos (salvo opusplan, que cambia de modelo)
Agregar o quitar herramientas cuando no hay tool search. Con tool search, que viene activo por defecto en los modelos compatibles, conectar un MCP no lo rompeCambiar el output style
Denegar una herramienta completa con una regla sin ámbito (Bash, WebFetch, mcp__*). Una regla con ámbito como Bash(rm *) no lo rompeUsar skills, comandos y /recap
/compact y la auto-compactación: reemplazan la conversación por un resumen/rewind: vuelve a un punto que ya está en caché
Una pausa más larga que la duración del cachéLanzar un subagente (tiene su propio caché)
Actualizar Claude Code: cambia el system prompt

Cuánto dura el caché

  • Con suscripción (Pro, Max, Team, Enterprise) dentro del uso incluido: la conversación principal usa caché de 1 hora.
  • Con API key, un proveedor cloud o créditos de uso extra: 5 minutos.
  • Subagentes, workflows, compactación y otras peticiones de apoyo: 5 minutos.
  • Puedes elegirlo con promptCacheTtl en settings o CLAUDE_CODE_PROMPT_CACHE_TTL (valores 5m o 1h; desde la v2.1.242). Con API key, 1h conviene si sueles hacer pausas de 5 a 60 minutos: la escritura cuesta el doble, pero evitas releer todo.

Cómo saber si está funcionando

  • /usage muestra el costo de la sesión con el desglose de entrada, salida, lectura y escritura de caché. Desde la v2.1.251 incluye una línea Prompt cache (main) con aciertos, fallos y si el caché sigue activo.
  • La statusline recibe el objeto prompt_cache (warm, ttl, hit_ratio, misses): puedes mostrar el caché en la barra inferior todo el tiempo.
  • Si ves que cada respuesta escribe casi toda la conversación en caché, algo lo está rompiendo en cada turno.
Errores que cuestan caro Cambiar de modelo a mitad de una sesión larga "para ahorrar". La primera respuesta en el modelo nuevo relee toda la conversación sin caché. Elige el modelo al empezar; para tareas baratas, usa un subagente con model: haiku.

Volver tras una pausa larga a una conversación enorme. Si el caché expiró, el siguiente mensaje procesa todo a precio completo. Si vas a seguir con otra tarea, /clear no cuesta nada.

Compactar después de la pausa. /compact lee la conversación que resume: con caché activo cuesta una fracción, con el caché expirado cuesta la conversación completa. Compacta antes de irte, en una pausa natural.

Dejar DISABLE_PROMPT_CACHING=1 activado después de depurar. Desactiva el caché en todos los modelos.
Lección 2.9

Hábitos que ahorran tokens

El gasto innecesario casi nunca viene de un prompt caro. Viene de hábitos: conversaciones que se arrastran entre tareas, salidas de comandos gigantes, capturas a resolución completa, instrucciones que se cargan en cada mensaje aunque no se usen. Esta es la lista de la documentación oficial, ordenada por dónde se va el consumo.

Qué consumeCómo bajarlo
Una conversación larga que ya no sirve/clear al cambiar de tarea. Si quieres volver después, nómbrala con /rename y retómala con /resume. Todo lo que queda en el contexto se reenvía en cada mensaje.
Salida y razonamientoSonnet para la mayoría de las tareas; Opus para arquitectura y razonamiento de varios pasos. Baja el effort con /effort en tareas simples: el razonamiento se cobra como salida.
Salidas de comandos enormesFiltra antes de que lleguen a Claude: un hook PreToolUse puede dejar solo las últimas 100 líneas de npm test. O delega tests, logs y búsquedas a un subagente: el ruido queda en su contexto y vuelve solo el resumen.
Un CLAUDE.md largoSe envía completo en cada mensaje. Mantenlo bajo 200 líneas y mueve los procedimientos largos a skills, que cargan solo cuando se usan.
Servidores MCPSus herramientas se cargan bajo demanda por defecto. Aun así, prefiere las CLI cuando existen (gh, aws, gcloud) y desactiva con /mcp los servidores que no usas.
Buscar a ciegas en el códigoUn plugin de code intelligence para lenguajes tipados deja navegar por símbolos en vez de hacer grep y leer archivo por archivo.
Imágenes y PDFUna imagen cuesta (ancho ÷ 28) × (alto ÷ 28) tokens, redondeando hacia arriba: una captura de 1000×1000 son unos 1.300 tokens. Recorta la captura a lo relevante. Un PDF cuesta entre 1.500 y 3.000 tokens de texto por página, más la imagen de cada página.
Subagentes y agent teamsCada subagente hace sus propias peticiones, que cuentan en los mismos límites que tu sesión. Los agent teams gastan bastante más que una sesión sola (un teammate en plan mode, unas 7 veces más). Úsalos para investigación, revisión o features nuevas; usa Sonnet en los teammates y ciérralos al terminar.
Prompts vagos"Agrega validación al login en auth.ts" gasta mucho menos que "mejora el código", porque Claude no tiene que explorar para adivinar qué quieres. Planifica con plan mode antes de implementar y corrige temprano con Esc.
Procesos de fondoLas sugerencias de prompt y la compactación en inactividad (idleCompaction) consumen poco, pero se pueden desactivar.

/clear o /compact

/clearNo cuesta nada. Úsalo al cambiar de tarea: empiezas con un contexto limpio y pequeño.
/compactEs una petición grande: lee toda la conversación para resumirla. Úsalo cuando necesitas seguir en la misma tarea y la conversación ya está larga, mejor con caché activo.
/rewindPara descartar un camino que no funcionó. Vuelve a un punto que ya está en caché, sin resumir nada.

Suscripción o API key

  • Con suscripción no pagas por token: tu uso se descuenta de una ventana de 5 horas y de una semanal, compartidas con claude.ai. /usage muestra ambas barras y cuándo se reinician. Al llegar al tope verás You've hit your session limit o You've hit your weekly limit.
  • Con API key pagas cada token según la tabla de la lección anterior. /usage estima el costo a precio de lista.
  • En ambos casos, los hábitos de esta lección rinden lo mismo: menos tokens enviados significa más trabajo antes del límite o una factura menor.

Mira el consumo mientras trabajas

La statusline recibe en JSON el costo y el contexto de la sesión. Con este script siempre ves cuánto llevas gastado y qué tan lleno está el contexto:

~/.claude/statusline.sh
#!/bin/bash
# Claude Code envía el estado de la sesión por stdin, en JSON
jq -r '"\(.model.display_name) · $\(.cost.total_cost_usd * 100 | round / 100) · contexto \(.context_window.used_percentage)%"'
~/.claude/settings.json
{
  "statusLine": { "type": "command", "command": "~/.claude/statusline.sh" }
}

El mismo JSON trae prompt_cache.hit_ratio y, en suscripciones, rate_limits.five_hour.used_percentage y rate_limits.seven_day.used_percentage, por si quieres agregarlos.

Lección 2.10

Checkpoints y rewind

Cada prompt que envías e inicia un turno crea un checkpoint del código. Abre el menú con Esc Esc (con el input vacío) o /rewind (alias /undo, /checkpoint). Haz clic en un checkpoint anterior:

Línea de tiempo de checkpoints

+ archivo nuevo · ~ archivo modificado

Opción del menúEfecto
Restore code and conversationVuelve ambos a ese punto
Restore conversationRebobina la conversación, mantiene el código actual
Restore codeRevierte archivos, mantiene la conversación
Summarize from hereComprime desde ese punto en adelante y libera contexto
Summarize up to hereComprime lo anterior y mantiene lo reciente completo
  • Se guardan snapshots de los 100 checkpoints más recientes, junto con la conversación: puedes cerrar la terminal, retomar y seguir rebobinando.
  • Cambios hechos con Bash (rm, mv, cp) no se rastrean; tampoco ediciones por shell como sed -i. Tampoco las ediciones de subagentes en segundo plano, ni efectos remotos (base de datos, APIs, deploys).
  • Permite experimentar: pide algo arriesgado y, si no funciona, rebobina y prueba otro enfoque.
No reemplaza a gitLos checkpoints son recuperación rápida dentro de la sesión. Para historia permanente y colaboración, sigue usando commits y ramas.
Lección 2.11

Sesiones: nombrar, retomar, bifurcar

Cada conversación es una sesión ligada a tu directorio y guardada localmente como JSONL en ~/.claude/projects/ (retención de 30 días por defecto, configurable con cleanupPeriodDays). Trata las sesiones como ramas: cada línea de trabajo con su propio contexto persistente.

QuieresCómo
Nombrar al iniciarclaude -n oauth-migration
Renombrar en curso/rename oauth-migration
Retomar por nombreclaude --resume oauth-migration o /resume oauth-migration
Retomar lo últimoclaude --continue
Retomar la sesión que creó un PRclaude --from-pr 123
Probar otro enfoque sin perder el actual/branch probar-streaming o claude --continue --fork-session
Exportar a texto/export archivo.txt
Mover la sesión a otro directorio/cd ../otro-repo

En el selector de /resume: Espacio previsualiza, Ctrl+R renombra, Ctrl+W amplía a todos los worktrees, Ctrl+A a todos los proyectos y Ctrl+B filtra por rama actual.

Qué se restaura al retomarEl historial completo, el modelo, el agente, el modo de permisos (desde la terminal), un /goal activo y las tareas programadas vigentes. Flags como --mcp-config, --settings o --add-dir hay que volver a pasarlos.
Lección 2.12

Modelos, effort y thinking

AliasPara qué
defaultEl default de tu cuenta (Opus 5.5 en Pro, Max, Team, Enterprise y API)
sonnetProgramación diaria
opusRazonamiento complejo, decisiones de arquitectura
haikuTareas simples y rápidas; subagentes de exploración
fableTus tareas más difíciles y largas. Desde la v2.1.321 apunta a Fable 5.2 (lanzado el 9 de noviembre de 2026), que en Claude Code arranca en esfuerzo medium; en versiones anteriores el alias sigue resolviendo a Fable 5.1. Actualiza con claude update.
bestLo que resuelva fable si está disponible; si no, opus
opusplanOpus en plan mode y Sonnet para ejecutar
opus[1m], sonnet[1m]Ventana de contexto de 1M de tokens
  • Cambiar: /model (guarda tu elección como default; s en el selector la aplica solo a esta sesión), claude --model opus, o Option/Alt+P sin perder tu prompt.
  • Precedencia: /model → --model → ANTHROPIC_MODEL → model en settings → ANTHROPIC_DEFAULT_MODEL.
  • Effort: low, medium, high, xhigh, max, vía /effort o --effort. El default es medium en los modelos 5.5 y en Fable 5.2, y high en la mayoría de los demás. Escribir ultrathink en un prompt pide razonamiento más profundo solo para ese turno.
  • Thinking: Option/Alt+T lo alterna. En Opus 5.5, Sonnet 5.5, Haiku 5.5 y Fable siempre está activo. Los tokens de thinking se facturan como salida.
  • Fast mode: /fast o Option/Alt+O para respuestas más rápidas.
  • Advisor: /advisor opus consulta a un segundo modelo en momentos clave de la tarea (lección siguiente).
CostoSonnet resuelve la mayoría de las tareas de código y cuesta menos que Opus. Reserva Opus para arquitectura y razonamiento de varios pasos, y usa model: haiku en subagentes de tareas simples. Elige el modelo al empezar: cambiarlo a mitad de una sesión larga relee toda la conversación sin caché (lección 2.8).
Lección 2.13

Advisor: un segundo modelo que revisa

El advisor es una función experimental que combina dos modelos en la misma sesión. El principal hace todo el trabajo: lee archivos, edita y corre comandos. El advisor, un modelo igual o más capaz, no toca nada: el principal lo consulta en los momentos en que un mal paso sale caro, y recibe un consejo antes de continuar.

En simple

Es como trabajar con un colega senior al lado. Haces la mayor parte solo y le preguntas antes de elegir un enfoque, cuando un error se repite y antes de entregar. Pagas al senior solo esos minutos, pero cada vez tiene que leer todo lo que hiciste.

Cómo activarlo

FormaQué hace
/advisorAbre un selector de modelos.
/advisor opusLo activa con Opus y lo guarda en tus ajustes (advisorModel).
/advisor offLo desactiva.
claude --advisor opusSolo para esa sesión; tiene prioridad sobre lo guardado.
"advisorModel": "opus"En settings, para dejarlo fijo.
CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1Lo apaga por completo: /advisor deja de existir.

Acepta los alias fable, opus y sonnet, o un ID completo como claude-opus-5-5. Al iniciar verás Advisor Tool (experimental) is on and may use more tokens.

Quién decide y qué viaja

  • Decide el principal, como con cualquier herramienta: suele consultar antes de elegir un enfoque, ante un error que se repite y antes de dar la tarea por terminada. No hay un ajuste para forzar consultas; si quieres una, pídelo en el prompt: "consulta al advisor antes de seguir".
  • Ida: el advisor recibe la conversación completa, con cada llamada a herramientas y su resultado.
  • Vuelta: solo un consejo en texto. El advisor no ejecuta herramientas.
  • En la terminal aparece Advising y luego Reviewed; Ctrl+O muestra el consejo. Si la evidencia del principal contradice el consejo, te lo dice.

Qué modelos se pueden combinar

El advisor tiene que ser igual o más capaz que el principal. Si eliges uno menos capaz, /advisor avisa Advisor is less capable than the current main model y no se usa. Las combinaciones más comunes:

PrincipalAdvisorPara qué
SonnetOpusEl equilibrio típico: rapidez para la rutina y Opus para las decisiones.
HaikuOpusTareas largas y mecánicas que igual necesitan un buen plan.
OpusOpusUna segunda opinión independiente sobre el propio trabajo.
FableFableLas tareas más difíciles (Fable 5.2 solo acepta Fable 5.2 como advisor).

Los subagentes heredan el advisor configurado, con la misma comprobación según su propio modelo.

Advisor, /model, opusplan o subagente

OpciónCómo reparte el trabajoConviene cuando
/model opusOpus hace todoCada paso necesita el modelo más fuerte
opusplanOpus planifica en plan mode y Sonnet ejecutaHay una fase clara de planificación antes de implementar
AdvisorSonnet trabaja y Opus revisa en momentos claveTareas largas de varios pasos donde la calidad del plan decide el resultado
SubagenteOtro modelo resuelve una parte aparte, con su propio contextoUna subtarea autocontenida y ruidosa (tests, búsquedas)
Lo que cuestaCada consulta relee toda la conversación, sin caché entre consultas, a la tarifa del advisor; con suscripción, cuenta en tus límites. Por eso no conviene en tareas cortas: ahí cambia el modelo con /model. A favor: activar o desactivar /advisor a mitad de sesión no rompe el caché del modelo principal, a diferencia de cambiar de modelo.
DisponibilidadEs experimental y su comportamiento puede cambiar. Funciona con la API de Anthropic, Claude Platform on AWS y Claude en Google Cloud gestionado por Anthropic, en planes de suscripción y API; no en Amazon Bedrock, Agent Platform de Google Cloud ni Microsoft Foundry.
Lección 2.14

Estilos de salida

Un output style fija el rol, tono y formato de todas las respuestas de la sesión. CLAUDE.md dice qué debe saber Claude; el estilo, cómo responde. Cambia con /output-style concise o desde /config.

EstiloQué cambiaÚsalo cuando
DefaultInstrucciones estándar de ingeniería de softwareTrabajo normal
ProactiveEmpieza de inmediato y asume decisiones rutinarias en vez de preguntarQuieres avance continuo y corriges si una suposición falla
ConciseParte por el resultado, sin preámbulo ni resumen finalLas respuestas te parecen largas
ExplanatoryAgrega bloques Insight que explican el porqué de sus decisionesEstás conociendo un código nuevo
LearningAdemás deja TODO(human) para que tú escribas las piezas con decisiones de diseñoQuieres practicar mientras avanza la tarea
.claude/output-styles/diagramas.md
---
name: Diagramas primero
description: Empieza cada explicación con un diagrama
keep-coding-instructions: true
---

Al explicar código, arquitectura o flujo de datos, empieza con un diagrama
Mermaid de la estructura y luego explica en prosa. Máximo 15 nodos.

keep-coding-instructions: true conserva las instrucciones de ingeniería de Claude Code; omítelo si Claude hará otra cosa (por ejemplo, un asistente de escritura). Proactive no cambia tu modo de permisos.

Lección 2.15

Patrones de falla y cómo evitarlos

Los cinco errores más comunes según la guía de buenas prácticas. Haz clic en cada uno para ver el arreglo.

Desarrolla intuiciónEstas reglas son puntos de partida. A veces conviene dejar que el contexto se acumule porque estás metido en un problema complejo; a veces un prompt vago es justo lo que necesitas. Cuando Claude rinde muy bien, fíjate qué hiciste: la estructura del prompt, el contexto, el modo.
Quiz final

Quiz · Nivel Intermedio

Responde todas correctamente para aprobar