Cómo Boris Cherny construye con Claude Code.
Flujo de trabajo completo, configuración y filosofía del creador y responsable de Claude Code en Anthropic. Boris construye apps web full-stack y automatizaciones con una configuración deliberadamente "vainilla": Opus 4.5/4.7 con thinking, 5 Claudes en paralelo en terminal + 5–10 en claude.ai, CLAUDE.md compartido en git (~2.5k tokens), slash commands, subagentes, un único hook PostToolUse para formatear, permisos pre-aprobados, MCPs solo para herramientas no relacionadas con código, y el flujo de trabajo canónico Explorar → Planear → Codear → Commit.
TL;DR
Boris Cherny (creador y responsable de Claude Code en Anthropic) construye apps web full-stack y automatizaciones con una configuración deliberadamente "vainilla": Opus 4.5/4.7 con thinking, 5 Claudes en paralelo en terminal + 5–10 en claude.ai, CLAUDE.md compartido en git (~2.5k tokens), slash commands en .claude/commands/, subagentes en .claude/agents/, un único hook PostToolUse para formatear, permisos pre-aprobados en settings.json, MCPs solo para herramientas no relacionadas con código (Slack, BigQuery, Sentry), y el flujo de trabajo canónico Explorar → Planear → Codear → Commit iniciado siempre en plan mode (Shift+Tab×2).
Dale a Claude una forma de verificar su trabajo. Si Claude tiene ese bucle de retroalimentación, multiplicará por 2–3× la calidad del resultado final.Boris Cherny · X, 2 ene 2026
Repetido en el post oficial de Anthropic "Claude Code: Best practices for agentic coding" (18 abr 2025), en la charla "Mastering Claude Code in 30 minutes" (AI Engineer World's Fair 2025), Latent Space (7 may 2025), Lenny's Podcast (19 feb 2026), Pragmatic Engineer (4 mar 2026) y sus hilos en X. Verificación = navegador, tests, simulador.
Usa claude -p (headless, con --bare para 10× de aceleración), GitHub Actions, hooks (PreToolUse, PostToolUse, Stop, SessionStart, PostCompact, PermissionRequest), /loop y /schedule (cron en la nube), y sandboxing (/sandbox) cuando se combina con --dangerously-skip-permissions. Para web full-stack añade verificación por navegador (extensión de Chrome para Claude) y subagentes especializados (code-simplifier, verify-app).
Hallazgos clave
git checkout o worktree) + 5–10 en claude.ai + sesiones desde la app de iOS. Boris al podcast Pragmatic Engineer (mar 2026, minuto 38:33): "Hoy en día envío, ya sabes, 20–30 PRs todos los días, pero cada PR es completamente distinto."@.claude en revisión de código usando la GitHub Action de Claude Code. Regla canónica: "Siempre que vemos a Claude hacer algo incorrectamente, lo añadimos al CLAUDE.md."anthropic.com/engineering/claude-code-best-practices (18 abr 2025): Explorar → Planear → Codear → Commit, con plan mode (Shift+Tab×2) como punto de entrada para casi todo PR no trivial.claude -p "..." --output-format stream-json --bare --allowedTools .... Casos canónicos del post oficial: triaje de issues, linting semántico, generación de changelogs, migraciones masivas con /batch./commit-push-pr, usado "decenas de veces al día".PostToolUse con bun run format || true es prácticamente el único hook que el propio Boris corre por defecto.bq), Sentry, GitHub Action. Para búsqueda de código usa búsqueda agéntica (grep + glob), no RAG.Mapa de fuentes
Todo lo que sigue está atribuido a personas reales del equipo de Claude Code en Anthropic, citadas en posts oficiales, podcasts y threads públicos. Estas son las voces que aparecen en este documento:
6eBSHbLKuN0) · podcast Latent Space (7-may-2025) · hilos en X 2-ene / 31-ene / 11-feb / 20-feb / 27-feb / 9-mar / 29-mar / 16-abr-2026 · podcast Pragmatic Engineer (4-mar-2026) · Lenny's Podcast (19-feb-2026) · InfoQ (10-ene-2026) · VentureBeat (ene-2026)./btw como proyecto paralelo (lanzado 10-mar-2026).Instalación y configuración inicial
Instalación
bash# Instalar Claude Code global npm install -g @anthropic-ai/claude-code # Arrancar claude
Comandos del primer día (charla "Mastering Claude Code in 30 minutes")
| Comando | Qué hace |
|---|---|
/terminal-setup | Habilita Shift+Enter para saltos de línea. Necesario en la terminal de VS Code, Apple Terminal, Warp, Alacritty. |
/theme | Claro / oscuro / Daltonize. |
/install-github-app | (o /install-github-action) — permite mencionar @claude en issues y PRs. |
/config | Alterna notificaciones y estilo de salida. |
/permissions | Pre-aprueba comandos bash seguros. |
/vim | Boris no lo usa, pero "a la gente le encanta el modo Vim" (Cat Wu, Latent Space). |
| Dictado en macOS | Tip 15 (hilo 29-mar-2026): "Boris escribe la mayoría de su código hablándole a Claude, en lugar de tecleando." |
Opus 4.5/4.7 con thinking. Cámbialo con /model. Boris: "Es el mejor modelo de programación que he usado, y aunque es más grande y más lento que Sonnet, como hay que guiarlo menos y usa mejor las herramientas, casi siempre resulta más rápido que usar un modelo más pequeño al final."
El equipo de Claude Code es fan de Ghostty (Boris, hilo 31-ene-2026, tip 7) por su renderizado sincronizado, color de 24 bits y soporte correcto de Unicode.
CLAUDE.md: contenido, jerarquía y mantenimiento
Qué incluir (verbatim del post oficial de Boris, abr 2025)
CLAUDE.md es un archivo especial que Claude carga automáticamente al contexto cuando arranca una conversación. Esto lo convierte en el lugar ideal para documentar:Post oficial · Anthropic Engineering · 18 abr 2025
- Comandos bash comunes
- Archivos centrales y funciones utilitarias
- Pautas de estilo de código
- Instrucciones de testing
- Etiqueta del repositorio (p. ej., nomenclatura de ramas, merge vs. rebase, etc.)
- Configuración del entorno del desarrollador (p. ej., uso de pyenv, qué compiladores funcionan)
- Cualquier comportamiento inesperado o advertencia propia del proyecto
- Otra información que quieras que Claude recuerde
"No hay un formato obligatorio para los archivos CLAUDE.md. Recomendamos mantenerlos concisos y legibles para humanos." El CLAUDE.md del propio equipo Claude Code es de ~2.5k tokens (Boris a InfoQ, ene 2026); su ~/.claude/CLAUDE.md global es de 76 tokens (visible en la captura del hilo 31-ene-2026).
Qué NO incluir: Boris usa la filosofía "menos es más" — cada token cargado se mete en TODO prompt y compite con el código real. Anti-patrón: información que Claude puede inferir leyendo el repo (estructura obvia, README ya existente, etc.).
Ejemplo verbatim del CLAUDE.md de muestra del post oficial
CLAUDE.md# Comandos bash - npm run build: compila el proyecto - npm run typecheck: corre el typechecker # Estilo de código - Usa sintaxis de módulos ES (import/export), no CommonJS (require) - Desestructura los imports cuando sea posible (p. ej., import { foo } from 'bar') # Flujo de trabajo - Asegúrate de hacer typecheck cuando termines una serie de cambios de código - Prefiere correr tests individuales, no la suite completa, por rendimiento
En Anthropic, de vez en cuando pasamos los archivos CLAUDE.md por el prompt improver y solemos afinar las instrucciones (por ejemplo, añadiendo énfasis con 'IMPORTANT' o 'YOU MUST') para mejorar el cumplimiento.Post oficial
Jerarquía completa de ubicaciones
Verbatim del post oficial:
Puedes ubicar archivos CLAUDE.md en varias localizaciones: la raíz de tu repo, o donde sea que ejecutes claude (el uso más común). Llámalo CLAUDE.md y commitéalo a git para compartirlo entre sesiones y con tu equipo (recomendado), o llámalo CLAUDE.local.md y añádelo al .gitignore. Cualquier directorio padre del directorio donde ejecutas claude. Esto es lo más útil para monorepos. Cualquier directorio hijo del directorio donde ejecutas claude — Claude cargará los archivos CLAUDE.md bajo demanda cuando trabajes con archivos en directorios hijos. Tu carpeta home (~/.claude/CLAUDE.md), que se aplica a todas tus sesiones de claude. Cuando ejecutas el comando /init, Claude genera automáticamente un CLAUDE.md por ti.Post oficial
Cómo mantenerlo
Siempre que vemos a Claude hacer algo incorrectamente, lo añadimos al CLAUDE.md, para que Claude sepa no hacerlo la próxima vez. Otros equipos mantienen sus propios CLAUDE.md. Es responsabilidad de cada equipo mantener el suyo actualizado.Boris · hilo de X 2 ene 2026
Durante la revisión de código, etiquetar @.claude en un comentario de PR con la regla a aprender → la GitHub Action de Claude Code abre un PR sobre la misma rama añadiendo la regla al CLAUDE.md. Boris lo llama "su versión de Compounding Engineering" (referencia a Dan Shipper, Every).
Ejemplo real (del hilo)
Revisor: "nit: usa un string literal, no un ts enum. @claude añade al CLAUDE.md que nunca use enums, que prefiera siempre uniones literales"
Resultado en CLAUDE.md: "Prefiere `type` antes que `interface`; nunca uses `enum` (usa uniones de string literales en su lugar)."
Después de cualquier corrección manual, termina con: "Actualiza tu CLAUDE.md para que no vuelvas a cometer ese error."
Boris: "Claude es inquietantemente bueno escribiendo reglas para sí mismo."
"pídele a Claude mantener un directorio de notas para cada tarea/proyecto, actualizado después de cada PR. Después apuntan el CLAUDE.md hacia ahí." → CLAUDE.md como índice + carpeta notes/ con lecciones por feature.
Plan mode, modos de pensamiento y Explorar → Planear → Codear → Commit
/commit-push-pr.El flujo de trabajo canónico (verbatim del post oficial, sección "Explore, plan, code, commit")
Este flujo de trabajo versátil se ajusta a muchos problemas: 1. Pídele a Claude que lea los archivos, imágenes o URLs relevantes, dándole indicaciones generales ('lee el archivo que maneja el logging') o nombres específicos ('lee logging.py'), pero dile explícitamente que aún no escriba código. Esta es la parte del flujo de trabajo donde deberías considerar un uso fuerte de subagentes, especialmente para problemas complejos. 2. Pídele a Claude que haga un plan sobre cómo abordar un problema específico. Recomendamos usar la palabra 'think' para activar el modo de pensamiento extendido. Estas frases específicas se mapean directamente a niveles crecientes de presupuesto de pensamiento en el sistema: 'think' < 'think hard' < 'think harder' < 'ultrathink.' Cada nivel asigna progresivamente más presupuesto de pensamiento para que Claude lo use. Si los resultados de este paso parecen razonables, puedes pedirle a Claude que cree un documento o un issue de GitHub con su plan, para poder regresar a este punto si la implementación (paso 3) no es la que querías. 3. Pídele a Claude que implemente su solución en código. Este es también un buen momento para pedirle que verifique explícitamente la razonabilidad de su solución mientras va implementando piezas. 4. Pídele a Claude que commitee el resultado y cree un pull request. Este también es un buen momento para hacer que Claude actualice cualquier README o changelog con una explicación de lo que acaba de hacer.
Los pasos #1-#2 son cruciales — sin ellos, Claude tiende a saltar directamente a codificar una solución.Post oficial · Anthropic Engineering
Entrar a Plan Mode
Dos Shift+Tab (ciclo: normal → auto-accept → plan). Desde Claude Code v2.1.0+ también /plan. En Windows Terminal a veces hay que usar Alt+M.
La mayoría de sesiones arrancan en Plan mode (shift+tab dos veces). Si mi meta es escribir un Pull Request, uso Plan mode y voy de ida y vuelta con Claude hasta que me gusta su plan. De ahí, paso al modo auto-accept edits y Claude normalmente puede resolverlo de un tiro. ¡Un buen plan es realmente importante!Boris · X 2 ene 2026
"Planificar es más útil cuando no estás seguro del enfoque, cuando el cambio modifica múltiples archivos, o cuando no estás familiarizado con el código que se está modificando. Si pudieras describir el diff en una frase, sáltate el plan."
Patrones del equipo de Claude Code (hilo 31-ene-2026, tip 2)
- Un ingeniero anónimo del equipo tiene un Claude que escribe el plan + otro Claude que lo revisa "como un staff engineer".
- Otro: "en el momento en que algo se tuerce, vuelven a plan mode y replantean. No sigas empujando."
- También usan plan mode "para los pasos de verificación, no solo para la construcción".
Modos de pensamiento — escalado verbatim del post oficial
El sistema migró al comando /effort con niveles low | medium | high | xhigh | max. Boris (hilo 16-abr-2026, post Opus 4.7): "Uso xhigh effort para la mayoría de las tareas, y max effort para las más difíciles."max solo aplica a la sesión actual; los demás niveles son persistentes entre sesiones. La palabra ultrathink sigue funcionando como override por turno (v2.1.68+).
Multi-Claude: checkouts, worktrees y sesiones paralelas
Arranca 3–5 git worktrees a la vez, cada uno corriendo su propia sesión de Claude en paralelo. Es el mayor desbloqueo de productividad por sí solo, y el principal consejo del equipo. Personalmente, uso múltiples git checkouts, pero la mayoría del equipo de Claude Code prefiere worktrees — ¡es la razón por la que @amorriscode construyó soporte nativo para ellos en la Claude Desktop app!Boris · hilo 31-ene-2026, tip 1
Boris personalmente usa múltiples git checkouts separados, no worktrees — InfoQ ene 2026 lo confirma. El resto del equipo prefiere worktrees.
Mecánica de worktrees (post oficial)
bashgit worktree add ../project-feature-a feature-a cd ../project-feature-a && claude # repetir en otras pestañas para más worktrees independientes git worktree remove ../project-feature-a # limpieza
Consejos del post oficial
- Usa convenciones de nombrado consistentes
- Mantén una pestaña de terminal por cada worktree
- Si usas iTerm2 en Mac, configura notificaciones para cuando Claude necesite atención
- Usa ventanas de IDE separadas para diferentes worktrees
- Limpia cuando termines
Desde v2.1.29 (anuncio de Boris, 20-feb-2026): soporte nativo en CLI
bashclaude --worktree my_worktree # crea worktree y arranca sesión claude --worktree my_worktree --tmux # con sesión de tmux
En .claude/agents/<agent>.md se puede declarar isolation: worktree en el frontmatter para que un subagente siempre corra aislado. Para no-git (Mercurial, Perforce, SVN, jj) se definen los hooks WorktreeCreate y WorktreeRemove.
Configuración de Boris (hilo 2-ene-2026)
- 5 pestañas en iTerm2, numeradas 1–5, cada una con su propio checkout (NO worktrees).
- Notificaciones del sistema de iTerm2 activadas para saber cuándo un Claude pide input.
- 5–10 sesiones extra en claude.ai/code (web).
- Sesiones desde la app de Claude en iOS que arranca por la mañana y revisa por la tarde.
- Comandos de movilidad:
¶ mandar una sesión a segundo plano,--teleporty/teleportpara mover sesiones entre local/web/móvil,claude remote-controlpara controlar sesiones locales desde el móvil (v2.1.74+).
Ejecutar claude agents desde un directorio raíz que contenga todos los repos. Lista todas las sesiones agrupadas por necesita input / en progreso / completadas. Es el sucesor productizado de la configuración de pestañas numeradas de Boris.
La mejor forma de pasar de 1 agente a muchos agentes. Se acabó el ciclar entre pestañas de terminal.Boris Cherny
Slash commands personalizados
Filosofía (Boris, hilo 2-ene-2026, tip 7)
Uso slash commands para cada flujo de "inner loop" que termino haciendo muchas veces al día. Esto me ahorra el promptear repetidamente, y hace que Claude también pueda usar estos flujos. Los comandos están commiteados a git y viven en .claude/commands/. Por ejemplo, Claude y yo usamos un slash command /commit-push-pr decenas de veces cada día. El comando usa bash inline para pre-computar el git status y algunas otras piezas de información para que el comando se ejecute rápido y evite el ida-y-vuelta con el modelo.Boris · X 2-ene-2026 · tip 7
Estructura mínima de un slash command
.claude/commands/commit-push-pr.md<!-- .claude/commands/commit-push-pr.md --> --- description: Commitea los cambios actuales, hace push a origin, abre un PR --- !`git status -sb` !`git diff --stat HEAD` Basado en los cambios staged de arriba, haz lo siguiente: 1. Elige un mensaje de Conventional Commits que resuma el diff 2. `git add -A && git commit -m "<msg>"` 3. `git push -u origin HEAD` 4. `gh pr create --fill`
Las líneas que empiezan con ! ejecutan bash inline ANTES de mandar el prompt al modelo.
Los slash commands que Boris usa más a menudo
| Comando | Función | Fuente |
|---|---|---|
/commit-push-pr | Flujo de git completo, "decenas de veces al día". | Boris X 2-ene-2026 |
/simplify | Skill oficial (27-feb-2026): agentes paralelos mejoran calidad / deduplican. | Boris X 27-feb-2026 |
/batch | Migración masiva (Solid→React, etc.) repartida en docenas de worktrees. | Boris X 27-feb-2026 |
/go | Compuesto: testea de extremo a extremo → /simplify → abre PR. | Boris X 16-abr-2026 |
/loop | Tarea recurrente hasta 3 días sin supervisión. | Boris X 7-mar-2026 |
/schedule | Cron en la infraestructura de Anthropic; sigue corriendo con el portátil cerrado. | @noahzweben 23-mar-2026 |
/btw | Pregunta paralela de un turno sin llamadas a herramientas; mantiene el contexto principal. | Erik Schluntz · @trq212 · 11-mar-2026 |
/rewind | Volver a un mensaje previo (también doble-Esc). | @trq212 15-abr-2026 |
/focus | Ocultar las salidas intermedias de herramientas, ver solo el resultado final. | Boris X 16-abr-2026 |
/fewer-permission-prompts | Escanea el historial y recomienda una lista de permitidos. | Boris X 16-abr-2026 |
/goal <condición> | Ralph-loop nativo: Claude no para hasta cumplir la condición. | @ClaudeDevs 12-may-2026 |
Desde v2.1.x existen skills (.claude/skills/<nombre>/SKILL.md) que se auto-cargan por coincidencia semántica. Boris (hilo 31-ene-2026): "Si haces algo más de una vez al día, conviértelo en una skill o un command."
Subagentes personalizados · .claude/agents/
Cómo piensa Boris los subagentes (hilo 2-ene-2026, tip 8)
Uso unos cuantos subagentes regularmente: code-simplifier simplifica el código después de que Claude termina de trabajar, verify-app tiene instrucciones detalladas para testear Claude Code de extremo a extremo, y así. Similar a los slash commands, pienso en los subagentes como una forma de automatizar los flujos más comunes que hago para la mayoría de los PRs.Boris · X 2-ene-2026 · tip 8
Carpeta de Boris (visible en el hilo)
Anatomía de un subagente
.claude/agents/code-simplifier.md--- name: code-simplifier description: Úsalo proactivamente tras refactors grandes para eliminar duplicación y código muerto tools: Read, Edit, Grep, Glob, Bash(bun run lint:*) model: sonnet isolation: worktree # opcional, desde feb-2026 color: blue --- Eres un ingeniero senior enfocado en la simplificación. Después de que el agente principal termine: 1. Encuentra lógica duplicada introducida en esta sesión 2. Colápsala en utilidades compartidas solo si se usa ≥2 veces 3. Corre el linter y arregla las violaciones 4. Devuelve un resumen conciso del diff
Ubicaciones (precedencia de mayor a menor)
- Settings gestionados (empresa).
- Flag CLI
--agents. .claude/agents/(proyecto, commiteado a git).~/.claude/agents/(usuario, todos los proyectos).agents/dentro de los plugins instalados.
Crear uno interactivamente: /agents. Boris lo recomienda como punto de partida y luego edita el .md a mano.
Cuándo delegar a un subagente (post "How and when to use subagents in Claude Code")
- Investigación que ensucia el contexto (leer 30 archivos para entender algo).
- Pasos paralelizables (revisor de estilo + escáner de seguridad + cobertura de tests al mismo tiempo).
- Necesitar una "segunda opinión" con un prompt distinto.
- Restricción de permisos: subagente con
tools: Read, Grep, Glob(solo lectura).
Añade 'use subagents' a cualquier petición donde quieras que Claude lance más cómputo al problema. [...] Enruta las peticiones de permiso a Opus 4.5 vía un hook — déjalo escanear ataques y auto-aprobar los seguros.Boris
Hooks deterministas, no agénticos
Eventos del ciclo de vida: PreToolUse, PostToolUse, Stop, SessionStart, PostCompact, PermissionRequest, SubagentStop, WorktreeCreate/Remove y más (más de 12 eventos en v2.1.x; documentación canónica en code.claude.com/docs/en/hooks).
El único hook que Boris activa por defecto
settings.json{ "hooks": { "PostToolUse": [ { "matcher": "Write|Edit", "hooks": [ { "type": "command", "command": "bun run format || true" } ] } ] } }
Usamos un hook PostToolUse para formatear el código de Claude. Claude normalmente genera código bien formateado nada más sacarlo, y el hook se encarga del último 10% para evitar errores de formato en CI más adelante.Boris · X 2-ene-2026, tip 9 + InfoQ ene-2026
Eventos del ciclo de vida (más de 12 en v2.1.x)
exit 2) o modificar el input; sandboxing dinámico./compact--init / --maintenanceTipos de manejador
jsonc// command (shell) { "type": "command", "command": "python validator.py", "timeout": 30 } // http { "type": "http", "url": "https://hooks.example.com/pre", "timeout": 30, "headers": { "Authorization": "Bearer $TOKEN" }, "allowedEnvVars": ["TOKEN"] } // prompt (juez LLM de un turno, sin herramientas) { "type": "prompt", "prompt": "¿Debería permitirse este comando?" } // agent (subagente con herramientas) { "type": "agent", "prompt": "Verifica los cambios contra los documentos de arquitectura.", "timeout": 120 }
Códigos de salida que importan
| Código de salida | Efecto |
|---|---|
exit 0 | Permite y continúa. |
exit 2 en PreToolUse | Bloquea la llamada a la herramienta. |
exit 2 en Stop | Fuerza a Claude a seguir trabajando (útil para /loop y agentes que se rinden temprano). |
Flujo con Stop hook que Boris usa para tareas largas (hilo 2-ene-2026, tip 12)
Para tareas muy largas, hago una de tres: (a) le pido a Claude que verifique su trabajo con un agente en segundo plano cuando termine, (b) uso un agent Stop hook para hacerlo de forma más determinista, o (c) uso el plugin ralph-wiggum (originalmente concebido por @geoff).Boris
El plugin "ralph-wiggum" hace que Claude se auto-pinche ("¿ya terminaste?") repetidamente hasta cumplir un criterio — base del actual /goal.
Una regla deny en settings.json no se puede anular con un hook que retorne allow — las reglas deny siempre ganan. Pero un hook con exit 2 SÍ PUEDE bloquear una herramienta aunque exista una regla allow.
Permissions y settings.json
Filosofía de Boris (hilo 2-ene-2026, tip 10)
No uso --dangerously-skip-permissions. En su lugar, uso /permissions para pre-permitir comandos bash comunes que sé que son seguros en mi entorno, para evitar prompts de permiso innecesarios. La mayoría están commiteados en .claude/settings.json y compartidos con el equipo.Boris · X 2-ene-2026 · tip 10
Lista visible en su captura
Bash(bq query:*) Bash(bun run build:*) Bash(bun run lint:file:*) Bash(bun run test:*) Bash(bun run test:file:*) Bash(bun run typecheck:*) Bash(bun test:*) Bash(cc:*) Bash(comm:*) Bash(find:*) Bash(gh issue view:*) Bash(gh pr checks:*) Bash(gh pr comment:*) Bash(gh pr diff:*) Bash(gh pr list:*)
Estructura de permissions en settings.json
.claude/settings.json{ "permissions": { "allow": ["Read", "Edit", "Write", "Bash(bun run *)", "Bash(gh pr *)"], "deny": ["Bash(git push --force *)", "Bash(rm -rf *)", "Read(**/.env)"], "ask": ["WebFetch"], "defaultMode": "default", "additionalDirectories": ["/Users/me/shared-libs"] } }
Reglas de evaluación: deny → ask → allow → defaultMode. La primera regla que coincide gana; deny SIEMPRE supera a allow de cualquier ámbito.
Modos de permisos (ciclo con Shift+Tab)
| Modo | Comportamiento |
|---|---|
default | Pregunta en cada herramienta nueva. |
acceptEdits aceptación automática | Auto-acepta las ediciones, sigue preguntando por bash. |
plan | Solo lectura; no escribe nada. |
bypassPermissions | Equivalente a --dangerously-skip-permissions; Boris solo lo usa dentro de un sandbox o contenedor para tareas largas no atendidas. |
auto nuevo · mar 2026 | Anthropic entrena clasificadores que evalúan cada acción y aprueban automáticamente las seguras. Boris (16-abr-2026): "se 👏 acabaron 👏 los prompts de permisos 👏". Se activa con claude --enable-auto-mode o Shift+Tab. Disponible en Max, Teams y Enterprise. |
/sandbox activa el runtime de código abierto de Anthropic con aislamiento de sistema de archivos y red (todavía no en Windows). Modos: "Sandbox BashTool con auto-permitir" / "Sandbox BashTool con permisos normales" / "Sin Sandbox".
Ámbitos de settings.json (mayor → menor precedencia)
- Gestionado (organización) —
managed-settings.jsonadministrado. - Flags de CLI.
.claude/settings.local.json(ignorado por git por defecto)..claude/settings.json(compartido en el repo).~/.claude/settings.json(usuario, todos los proyectos).
Boris deja casi todo en .claude/settings.json (compartido con el equipo) y casi nada en local.
MCP servers que Boris realmente usa
Lo que Boris efectivamente usa (hilo 2-ene-2026, tip 11)
Claude Code usa todas mis herramientas por mí. Frecuentemente busca y publica en Slack (vía el servidor MCP), corre queries de BigQuery para responder preguntas de analítica (usando el CLI bq), agarra logs de error de Sentry, etc. La configuración del MCP de Slack está commiteada en nuestro .mcp.json y compartida con el equipo.Boris · X 2-ene-2026 · tip 11
Su .mcp.json de ejemplo
.mcp.json{ "mcpServers": { "slack": { "type": "http", "url": "https://slack.mcp.anthropic.com/mcp" } } }
"Ten cuidado con los MCPs. Pueden volar tu ventana de contexto. Úsalos solo para cosas específicas que están fuera del coding normal, como Slack, analítica y logs de error. Cuidado también con la inyección de prompts."
Para el coding mismo, NO usa MCPs
Ni RAG ni almacenes vectoriales. El sistema interno de "búsqueda agéntica" es solo glob y grep — el equipo probó varias alternativas (bases de datos vectoriales locales, indexación recursiva basada en modelo) y todas tenían contras (índices obsoletos, complejidad de permisos).
Glob y grep planos, conducidos por el modelo, le ganan a todo.Boris / Cat · resumido por The Pragmatic Engineer, mar 2026
Ámbitos de MCP (claude mcp add --scope ...)
local(por defecto): solo tú, en este proyecto.project: compartido vía.mcp.json(commiteado).user: todos tus proyectos (~/.claude.json).
Según anthropic.com/engineering/advanced-tool-use (24-nov-2025):
Enfoque tradicional: todas las definiciones de herramientas cargadas de entrada (~72K tokens para más de 50 herramientas de MCP) [...] Consumo total de contexto: ~77K tokens antes de empezar cualquier trabajo. Con la Tool Search Tool: consumo total de contexto: ~8.7K tokens, preservando el 95% de la ventana de contexto.Anthropic Engineering
MCPs comunes en el equipo
- MCP de Slack (alojado por Anthropic, HTTP).
- MCP de GitHub (
https://api.githubcopilot.com/mcp/). - MCP de Puppeteer / extensión de Chrome para Claude — Boris prefiere la extensión: "Tiende a funcionar de forma más confiable que otros MCPs similares" (hilo 29-mar-2026, tip 6).
- MCP de Sentry (OAuth).
- MCP del simulador de iOS (mencionado en el post oficial).
Headless mode · claude -p
Cita verbatim del post oficial
Claude Code incluye headless mode para contextos no interactivos como CI, pre-commit hooks, scripts de build y automatizaciones. Usa la flag -p con un prompt para habilitar headless mode, y --output-format stream-json para salida JSON en streaming. Ten en cuenta que el headless mode no persiste entre sesiones. Tienes que dispararlo en cada sesión.Post oficial
Casos canónicos del post oficial (verbatim)
a. Usa Claude para triaje de issues
El headless mode puede impulsar automatizaciones disparadas por eventos de GitHub, como cuando se crea un issue nuevo en tu repositorio. Por ejemplo, el repositorio público de Claude Code usa Claude para inspeccionar issues nuevos a medida que llegan y asignarles las etiquetas apropiadas.
b. Usa Claude como linter
Claude Code puede proporcionar revisiones de código subjetivas más allá de lo que las herramientas de linting tradicionales detectan, identificando problemas como erratas, comentarios obsoletos, nombres de función o variable engañosos, y más.
Patrones prácticos
bash# Triaje de issues (GitHub Action) claude -p "Inspecciona este issue nuevo y asigna las etiquetas apropiadas: $ISSUE_BODY" # Linter semántico claude -p "Revisa este PR buscando erratas y comentarios obsoletos" \ --allowedTools Read --output-format json | jq '.findings' # Migración masiva (ejemplo del post oficial) claude -p "migra foo.py de React a Vue. Cuando termines, DEBES devolver \ la cadena OK si lo lograste, o FAIL si la tarea falló." \ --allowedTools Edit "Bash(git commit:*)" # Pipeline al estilo Unix git status | claude -p "¿cuáles son mis cambios?" --output-format=json | jq '.result' # Pre-commit hook con Haiku (más barato) claude -p "Lintea este commit usando las reglas en .claude/lint.md" \ --model claude-haiku-4-5 --bare
--bare · hilo 29-mar-2026, tip 12Aceleración de hasta 10× porque se salta la búsqueda de CLAUDE.md, settings y MCPs locales:
Por defecto, cuando ejecutas claude -p (o los SDKs de TypeScript o Python) busca los CLAUDE.md, settings y MCPs locales. Pero para uso no interactivo, la mayoría de las veces quieres especificar explícitamente qué cargar. [...] En una versión futura, el valor por defecto cambiará a --bare.Boris
Caso real interno descrito en Latent Space (may 2025) por Boris y Cat Wu: GitHub Action que invoca claude -p con un slash command local (/lint) para linting semántico en cada PR; corrige errores y los commitea de vuelta vía el MCP de GitHub.
Caso "ralph loop" / agentes que corren solos
bashclaude -p "$PROMPT" \ --permission-mode=dontAsk \ --output-format=stream-json --verbose --bare
O dentro de un sandbox/contenedor, --dangerously-skip-permissions (Boris solo lo permite ahí).
/loop y /schedule (nuevos en mar 2026)
slash commands/loop 5m /babysit # cada 5 min: auto-rebase + manejar comentarios /loop 30m /slack-feedback # cada 30 min: abre PRs con feedback de Slack /loop /post-merge-sweeper # PRs para comentarios olvidados /loop 1h /pr-pruner # cierra PRs viejos /schedule un trabajo diario que resuma los PRs y avise en #docs-update vía el MCP de Slack
/loop corre localmente hasta 3 días; /schedule corre en la infraestructura de Anthropic (sirve aunque el portátil esté cerrado).
Patrones para apps web full-stack (Next.js / React)
Síntesis de Latent Space may-2025 + Lenny's Podcast feb-2026 + threads:
Arrastra y suelta un screenshot o un export de Figma a la terminal:
Estaba trabajando también en este, como, sitio web secundario la semana pasada. Y simplemente le mostré el mock a Claude Code. O sea, agarré el, ya sabes, el screenshot que tenía, lo arrastré y lo solté en la terminal. Y le dije, hey, Claude, aquí está el mock. ¿Puedes implementarlo? Y lo implementó. [...] Y le dije, vale, ahora míralo en Puppeteer y, como, itera hasta que se vea como el mock. Y lo hizo tres o cuatro veces. Y luego la cosa se veía como el mock.Boris · Latent Space
Usa la extensión de Chrome para Claude (code.claude.com/docs/en/chrome). El propio Boris lo describe como "el consejo más importante" para web (hilo 29-mar-2026, tip 6):
Uso la extensión de Chrome cada vez que trabajo con código web. Tiende a funcionar de forma más confiable que otros MCPs similares.
La Claude Desktop app puede arrancar y testear servidores en un navegador embebido. En CLI/VSCode se hace con la extensión de Chrome.
verify-app corre tests E2E antes de cada merge a main.
React Ink (React → códigos de escape ANSI), Commander.js, Bun para empaquetado y tests. Boris hizo que Claude escribiera un parser de Markdown desde cero la noche antes del lanzamiento porque ninguna librería funcionaba bien para la terminal — "y es el parser de markdown que está en code hoy".
Megan (diseñadora del equipo) "no es coder pero está mergeando PRs a nuestro producto console. Usa código para hacerlo. Diseña la UI." — Boris, Latent Space.
Mezclar frameworks a media migración. Boris al Pragmatic Engineer (mar 2026): "asegúrate siempre de que cuando empieces una migración, termines la migración" — los codebases parcialmente migrados confunden tanto a humanos como a modelos.
Patrones para automatizaciones y agentes
| Caso | Cómo | Fuente |
|---|---|---|
| Triaje automático de issues de GitHub | GitHub Action + claude -p | Post oficial |
| Linting semántico en PRs | GitHub Action + slash command /lint + MCP de GitHub para commitear de vuelta | Boris, Latent Space |
| Generación automática de changelogs | claude -p lee git log en cada release | Boris, Latent Space |
| Fix automático de hilos de bugs en Slack | MCP de Slack + "simplemente di 'fix'" | Boris, 31-ene-2026, tip 5 |
| Arreglo de tests de CI | "Anda arregla los tests de CI que están fallando" — sin micromanagement | Boris, 31-ene-2026 |
| Migración de 1000 archivos | /batch (entrevista → reparte en docenas de agentes en worktree) | Boris, 27-feb-2026 |
| Análisis de logs de Docker | "Apunta Claude a los logs de docker" | Boris, 31-ene-2026, tip 5 |
| Revisión de código automática en PRs | Funcionalidad de Code Review (mar 2026) — equipo de agentes para cazar bugs | Boris, 9-mar-2026 |
| Auto-resolución de fallos de CI | /schedule con prompt específico, corre en la nube | @noahzweben 23-mar-2026 |
| Resumen matutino de Slack | /schedule diario con el MCP de Slack | Boris, 29-mar-2026 |
/goal "all auth tests pass and lint clean" | Ralph-loop nativo: cada intento de Stop se intercepta y se re-evalúa la condición | @ClaudeDevs 12-may-2026 |
Script de inicialización para sesiones en la nube (anunciado 13-mar-2026)
En Claude Code Web/Desktop puedes definir un bash que se ejecuta al iniciar una nueva sesión en la nube:
setup.sh#!/bin/bash yarn install
Actualmente, estamos viendo costos como de $6 por día por usuario activo. Así que sí, sale un poco más caro a lo largo de un mes que Cursor. Pero no creo que esté fuera de lo razonable.Cat Wu
Es una cuestión de ROI, no una cuestión de costo. [...] los ingenieros son muy caros. Y si puedes hacer a un ingeniero un 50, 70% más productivo, eso vale mucho.Boris · mismo episodio
En Lenny's Podcast (feb 2026), Boris lo cuantificó: "la productividad por ingeniero ha crecido casi 70% por ingeniero gracias a Claude Code"; al Pragmatic Engineer (mar 2026) lo subió a "la productividad por ingeniero ha aumentado 200% desde que se lanzó Claude Code, incluso mientras Anthropic ha triplicado su plantilla."
Manejo de contexto
Reglas operativas (post oficial + hilo de @trq212 15-abr-2026)
| Comando | Cuándo |
|---|---|
/clear | Tarea genuinamente nueva. Brief escrito a mano, máximo control. |
/compact | Tarea relacionada que aún necesita contexto. Pista opcional: /compact enfócate en el refactor de auth, descarta la depuración de tests. Con pérdida. |
/rewind o doble-Esc | Camino fallido. Salta a un mensaje previo y descarta lo posterior. Más limpio que "esto no funcionó, intenta X". Thariq: "El único hábito que señala un buen manejo de contexto es rewind, no corrección." |
/resume <session-id> | Continuar una sesión previa. |
/branch o claude --resume <id> --fork-session | Bifurcar una sesión existente. |
Corregir manualmente deja el intento fallido DENTRO del contexto. La matemática:
corregir = lecturas de archivo + intento fallido + corrección + fix
rebobinar = lecturas de archivo + un solo prompt informado + fix
Auto-compact
Se dispara cerca del 95% de la ventana de contexto. Para evitar el "context rot" (degradación de rendimiento alrededor de los 300–400k tokens en el modelo de 1M), @trq212 recomienda:
bashCLAUDE_CODE_AUTO_COMPACT_WINDOW=400000 claude
PostCompact · nuevo mar 2026Re-inyecta las instrucciones críticas que se pierden al compactar.
/memory, auto-dream, mar 2026Subagente que periódicamente revisa sesiones pasadas, conserva lo importante, descarta el ruido y fusiona los insights al CLAUDE.md de usuario/proyecto. Análogo al sueño REM consolidando memoria a largo plazo.
Integración con GitHub y CI/CD
Configuración base
/install-github-appo/install-github-action— instala la GitHub Action de Claude Code alojada por Anthropic.- Etiqueta
@claude(o@.claude) en issues/PRs para invocarlo. - El CLI
ghdebería estar instalado (Boris pre-apruebaBash(gh ...)en sus settings).
Flujo de Boris para revisión de PR (hilo 2-ene-2026, tip 5)
.github/workflows/claude-lint.yml# esqueleto - uses: anthropic/claude-code-action@v1 with: prompt: "/project:lint" allowed-tools: "Read,Edit,Bash(bun run lint:*)"
El slash command /lint vive en .claude/commands/lint.md del repo, contiene reglas en markdown, y al ejecutarlo en CI Claude: (1) identifica errores (erratas, comentarios obsoletos, nombres engañosos), (2) aplica fixes, (3) los commitea de vuelta al PR vía el MCP de GitHub.
Al abrir un PR, Claude despacha un equipo de agentes especializados (errores de lógica, seguridad, regresiones de rendimiento).
Boris la usó personalmente durante semanas antes del lanzamiento. Atrapa bugs reales que de otra forma no habría notado.
Configurar una routine con un prompt + repo + conectores → se dispara por cronograma (cron) / webhook por API / evento de GitHub (PR abierto/mergeado, release publicada, issue abierto). Corre en la infraestructura de Anthropic.
Cómo Boris escribe prompts (vs Claude regular)
Estilo "agresivo, sin babysitting" (hilo 31-ene-2026, tip 6)
a. Reta a Claude. Di: 'Examíname a fondo sobre estos cambios y no hagas un PR hasta que apruebe tu test.' Haz que Claude sea tu revisor. O di: 'Demuéstrame que esto funciona' y haz que Claude compare el comportamiento entre main y tu rama de feature.
b. Después de un fix mediocre, di: 'Sabiendo todo lo que sabes ahora, descarta esto e implementa la solución elegante.'
c. Escribe specs detallados y reduce la ambigüedad antes de delegar el trabajo. Cuanto más específico seas, mejor la salida.Boris
El modelo funciona mejor si lo tratas como un ingeniero al que estás delegando, no como un pair programmer al que estás guiando línea por línea.Cat Wu
Contexto completo de la tarea desde el inicio (Cat Wu, mismo post)
Incluir en el primer turno los 3 elementos:
Ejemplo
promptObjetivo: añade rate limiting al endpoint /api/login Restricciones: - no modifiques el esquema de la base de datos - mantén el flujo de auth existente sin cambios - usa Redis (ya configurado) Criterios de aceptación: - 5 req/min por IP, devuelve 429 al alcanzar el límite - los tests existentes siguen pasando - nuevo test case para el comportamiento del rate-limit
El post oficial recomienda "haz que Claude te entreviste primero":
"Quiero construir [descripción breve]. Entrevístame en detalle usando la herramienta AskUserQuestion."
Boris escribe la mayoría de su código hablándole a Claude, en lugar de tecleando.
/voice + mantener la barra espaciadora en CLI; pulsar el botón de voz en Desktop; dictado en iOS.
Hablas 3× más rápido de lo que tecleas, y como resultado tus prompts se vuelven mucho más detallados.Boris
Feedback, interrupciones, correcciones
| Atajo / Prefijo | Qué hace |
|---|---|
Esc | Cancela la operación actual. |
Doble-Esc o /rewind | Vuelve a un mensaje previo y descarta lo posterior. Preferible a "no, hazlo así". |
Ctrl+R | Muestra salida verbosa (proceso de pensamiento). |
Ctrl+O | Habilita el modo verboso para ver los hooks ejecutándose. |
Ctrl+F (doble en 3s) | Mata todos los agentes en segundo plano al instante. |
# al inicio del prompt | Añade la línea como memoria → se inserta en el CLAUDE.md relevante. |
! al inicio del prompt | Modo bash — ejecuta un comando y mete la salida al contexto. |
@filename | Incluye un archivo/carpeta en el contexto. |
/btw Erik Schluntz, mar 2026 | Pregunta paralela mientras Claude trabaja. Un solo turno, sin llamadas a herramientas, no entra al historial. |
Desarrollo guiado por tests con Claude Code
Verbatim del post oficial (Boris lo llama "flujo favorito de Anthropic")
Este es un flujo favorito de Anthropic para cambios que son fácilmente verificables con tests unitarios, de integración o end-to-end. El test-driven development (TDD) se vuelve aún más poderoso con el agentic coding:
1. Pídele a Claude que escriba tests basados en pares esperados de input/output. Sé explícito sobre que estás haciendo test-driven development para que evite crear implementaciones mock, incluso para funcionalidad que aún no existe en el codebase.
2. Dile a Claude que corra los tests y confirme que fallan. Decirle explícitamente que no escriba código de implementación en esta etapa suele ser de ayuda.
3. Pídele a Claude que commitee los tests cuando estés satisfecho con ellos.
4. Pídele a Claude que escriba código que pase los tests, indicándole que no modifique los tests. Dile a Claude que siga hasta que todos los tests pasen. Normalmente tomará algunas iteraciones para que Claude escriba código, corra los tests, ajuste el código y vuelva a correr los tests. En esta etapa puede ayudar pedirle que verifique con subagentes independientes que la implementación no esté sobreajustada a los tests.
5. Pídele a Claude que commitee el código una vez estés satisfecho con los cambios.
Claude funciona mejor cuando tiene un objetivo claro contra el cual iterar — un mock visual, un test case, u otro tipo de salida.Post oficial
No he escrito manualmente un test unitario en muchos meses. [...] Claude escribe todos los tests. [...] Como escribir tests se vuelve más fácil y escribir reglas de lint también, en realidad es mucho más fácil tener código de alta calidad de lo que era antes.Boris Cherny
Multimodal: escribe código, captura el resultado, itera
Verbatim del post oficial
Similar al flujo de testing, puedes darle a Claude objetivos visuales:
1. Dale a Claude una forma de tomar screenshots del navegador (por ejemplo, con el servidor MCP de Puppeteer, un servidor MCP del simulador de iOS, o copiando/pegando screenshots manualmente a Claude).
2. Dale a Claude un mock visual copiando/pegando o arrastrando y soltando una imagen, o dándole la ruta del archivo de imagen.
3. Pídele a Claude que implemente el diseño en código, tome screenshots del resultado e itere hasta que el resultado coincida con el mock.
4. Pídele a Claude que commitee cuando estés satisfecho.
Como los humanos, las salidas de Claude tienden a mejorar significativamente con la iteración. Si bien la primera versión puede ser buena, después de 2-3 iteraciones normalmente se ve mucho mejor. Dale a Claude las herramientas para ver sus salidas para obtener los mejores resultados.Post oficial
Para web, Boris usa la extensión de Chrome para Claude (más confiable que el MCP de Puppeteer, según él).
Cuándo NO usar Claude Code
Hay también algunas cosas que en realidad prefiero hacer a mano. Tipo, ya sabes, refactoring intrincado de modelos de datos o algo así. No se lo dejaré a Claude porque tengo opiniones muy fuertes, y es más fácil simplemente hacerlo y experimentar que explicárselo a Claude.Boris · Latent Space
Post oficial: si describes el cambio en una frase, sáltate el plan mode (y a menudo sáltate Claude).
Lenny's Podcast feb-2026: el modelo "tiene dificultades, pero el arreglo usualmente es 'espera al siguiente modelo.'" Recomienda empezar limpio (TypeScript/React) para estar "dentro de la distribución".
Sin bucle de retroalimentación, la calidad cae. Boris invierte tiempo en hacer la verificación "sólida como una roca" antes que en el agente.
Errores comunes que Boris menciona evitar
| Error | Por qué |
|---|---|
| Saltarse el plan mode en cambios multi-archivo | Boris en el post oficial: "Los pasos #1-#2 son cruciales — sin ellos, Claude tiende a saltar directamente a codificar una solución." |
| CLAUDE.md de más de 800 líneas con info que Claude puede inferir | Drena la ventana de contexto en cada turno; las reglas con baja señal se ignoran. |
Usar --dangerously-skip-permissions fuera de un sandbox | Boris solo lo permite dentro de un contenedor. |
| RAG / almacenes vectoriales para buscar código | Boris en Pragmatic Engineer: "Glob y grep planos, conducidos por el modelo, le ganan a todo." "La búsqueda agéntica esquiva todo eso. Al costo de latencia y tokens, ahora tienes una búsqueda realmente excelente sin contras de seguridad." |
| Mezclar frameworks a media migración | "Asegúrate siempre de que cuando empieces una migración, termines la migración." |
| Bloquear Edit/Write a mitad del plan con hooks | Rompe el razonamiento multi-paso. Mejor validar en PostToolUse o pre-commit. |
| Pre-commit hooks lentos (>5s) | Bloquean tanto a humanos como a Claude. Boris (Latent Space): solo tipos + lint; los tests pesados al CI. |
| MCPs cargados "por si acaso" | "Pueden volar tu ventana de contexto." |
| Micromanagement del plan | Cat Wu (Opus 4.7): "Trátalo como un ingeniero al que estás delegando, no como un pair programmer." |
Hidden gems
--name para etiquetar sesiones (claude --name "auth-refactor"); también hay nombrado automático tras plan mode./color — color al input del prompt, para distinguir sesiones paralelas./statusline — barra de estado personalizada mostrando modelo, % de contexto, rama, costo. "Cada uno en el equipo de Claude Code tiene un statusline distinto."/keybindings — TODA tecla es remapeable (~/.claude/keybindings.json).--bare — arranque del SDK 10× más rápido.--add-dir — dar acceso a otro repo durante la sesión (o additionalDirectories en los settings).--agent <nombre> — ejecuta toda la sesión bajo un agent personalizado como prompt de sistema./focus + Stop hook con notificación — receta para autonomía: el agente corre, decide permisos solo, oculta los pasos intermedios, te avisa al terminar./dream — fuerza la consolidación de memoria./config → "Explanatory" o "Learning") — útil para incorporación a codebases nuevos./branch o claude --resume <id> --fork-session para bifurcar sesiones."env" en settings.json en lugar de scripts wrapper.Filosofía y principios que guían a Boris
Estos 10 principios aparecen repetidamente en sus apariciones públicas:
@.claude en PRs (Compounding Engineering).Recomendaciones staged
npm install -g @anthropic-ai/claude-codeclaude /initen tu repo principal → genera el CLAUDE.md base.- Edita CLAUDE.md a ≤150 líneas con los 7 bullets que Boris recomienda (bash, archivos centrales, estilo de código, tests, etiqueta, entorno, advertencias).
claude /permissions→ pre-aprueba tus comandos seguros (bun run *,gh pr *, tu test runner).- Activa notificaciones de iTerm2 o equivalente.
- Cambia a
/modelOpus (4.7 si tienes acceso) con/effort high.
- Adopta el ciclo Shift+Tab×2 (plan) → iterar el plan → Shift+Tab (auto-accept) → resolver de un tiro.
- Cuando algo falle dos veces, usa doble-Esc /
/rewinden vez de corregir verbalmente. - Tras cada corrección manual, pídele a Claude "Actualiza el CLAUDE.md para que no vuelvas a cometer ese error."
- Crea
.claude/commands/commit-push-pr.mdcon bash inline. - Crea un único hook
PostToolUseque ejecute tu formateador (bun run format || true,prettier --write, etc.). - Si trabajas en web full-stack: instala la extensión de Chrome para Claude y dile a Claude "testea en el navegador e itera hasta que la UX coincida con el mock."
- Aprende
git worktree addoclaude --worktree <nombre>. Empieza con 2 sesiones simultáneas, escala a 3–5. - Crea tu primer subagente:
code-simplifiercontools: Read, Edit, Grep, Glob.
/install-github-actiony prueba un linter semántico conclaude -p.- Identifica un flujo de trabajo que repites diariamente → conviértelo en slash command.
- Si tienes Slack / BigQuery / Sentry, añade un MCP server a la vez al
.mcp.jsony commitea.
Criterios para ajustar
- Si tu CLAUDE.md supera ~3k tokens → factoriza a
notes/y deja el CLAUDE.md apuntando ahí. - Si gastas más de $30/día en Claude Code → revisa los MCPs cargados (probablemente uno está inflando el contexto).
- Si Claude rompe los tests más del 30% del tiempo → falta verificación. Invierte en hacer el bucle de tests "sólido como una roca" antes de añadir más herramientas.
- Si ejecutas tareas de más de 30 min sin supervisión → muévete a
auto-mode(Max/Team/Enterprise) o a un--dangerously-skip-permissionsdentro de sandbox. - Si tu equipo migra a Opus 4.7+ → audita los prompts de sistema y el CLAUDE.md para quitar prompting que compensaba debilidades viejas (consejo explícito de Cat Wu en Lenny's, abr-2026).
Caveats
Las versiones, slash commands y funcionalidades nuevas (auto-mode, vista de agentes, routines, /goal, /loop) cambian rápido — Anthropic ha pasado de cadencias de meses a semanas y a días (Cat Wu, Lenny's abr-2026). Lo que aquí se reporta está verificado hasta principios de mayo 2026.
No hay una única forma correcta de usar Claude Code: lo construimos intencionalmente de manera que puedas usarlo, personalizarlo y hackearlo como quieras. Cada persona en el equipo de Claude Code lo usa de forma muy distinta.Boris · X 2-ene-2026
Por ejemplo: Boris usa múltiples git checkouts, pero la mayoría del equipo prefiere worktrees.
No son una recomendación universal: "100% de mi código escrito por Claude desde noviembre 2025", "20–30 PRs/día", "Opus para todo". Tus resultados pueden variar — especialmente fuera del stack TypeScript/React dentro de la distribución. Hay divergencia incluso entre fuentes: Boris en Lenny's (feb 2026) habla de un "70% de aumento de productividad por ingeniero"; al Pragmatic Engineer (mar 2026) lo subió a 200%. Las dos cifras son legítimas pero miden cosas distintas (por ingeniero vs. a nivel de equipo).
howborisusesclaudecode.com lo aclara como "hecho por fans, sin afiliación a Anthropic"; el sitio nibzard.com es una transcripción comunitaria de la charla. Cuando se citan, se han contrastado con fuentes primarias (hilos de @bcherny, post oficial, podcasts).
(anthropic.com/engineering/claude-code-best-practices, 18-abr-2025) firmado por Boris Cherny agradece explícitamente a Daisy Hollman, Ashwin Bhat, Cat Wu, Sid Bidasaria, Cal Rueb, Nodir Turakulov, Barry Zhang y Drew Hodun — algunos consejos en ese post reflejan prácticas del equipo en conjunto, no solo de Boris.
Su sitio es borischerny.com, que a mayo 2026 funciona principalmente como landing con biografía y enlaces; no hay posts técnicos detallados allí. Sus prácticas se documentan en X/Twitter (@bcherny), charlas y entrevistas.
deny en settings.jsonHay reportes públicos (Stack Overflow, Reddit) y un análisis de Pete Freitag (petefreitag.com/blog/claude-code-permissions/) que muestran que deny Read(**/.env) solo bloquea la herramienta Read, pero un Bash(cat .env) o diff puede burlar la regla. La capa robusta es sandboxing + settings gestionados, no solo permissions.
--dangerously-skip-permissionsDebe usarse SIEMPRE dentro de contenedor/sandbox. Es la posición de Anthropic y de Boris explícitamente.
auto-mode, /goal y la vista de agentes son vista previa de investigación a mayo 2026 (no son versión general). La disponibilidad puede variar por plan (Pro/Max/Team/Enterprise).
El post oficial de Anthropic devuelve HTTP 429 a los fetchers automatizados durante la investigación; las citas verbatim provienen de un PDF mirror público (datafinder.ru) verificado de forma cruzada con extractos de la página original de Anthropic en buscadores y con el enlace-post de Simon Willison (simonwillison.net/2025/Apr/19/claude-code-best-practices/).