Boris Cherny & el método Claude Code
Verificado may 2026 v2.1.145
Una metodología de ingeniería · Verificado hasta mayo 2026

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.

AutorBoris Cherny
RolResponsable de Claude Code
EmpresaAnthropic
StackTypeScript / React
20–30
PRs por día
5 + 10
Sesiones paralelas
2–3×
Calidad con bucle de retroalimentación
~2.5k
Tokens del CLAUDE.md interno
200%
Productividad por ingeniero
·
Resumen ejecutivo

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).

Principio rector
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.

Para automatizaciones / agentes que corren solos

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).

·
Los 10 puntos que tienes que entender antes de seguir

Hallazgos clave

Configuración "vainilla" deliberada. Boris escribió textualmente en X (2 ene 2026): "Mi configuración puede resultar sorprendentemente vainilla. Claude Code funciona genial nada más sacarlo de la caja, así que personalmente no lo customizo mucho." La regla de oro es invertir tiempo en CLAUDE.md, plan mode y verificación, no en frameworks externos.
Paralelismo masivo. 5 Claudes locales (cada uno en su propio 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."
Opus 4.5/4.7 con thinking para todo. "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." — @bcherny, 2 ene 2026.
CLAUDE.md compartido y editado semanalmente. El CLAUDE.md interno del equipo Claude Code mide ~2.5k tokens (Boris a InfoQ, ene 2026) y se actualiza vía @.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."
Flujo de trabajo canónico de 4 fases. Documentado por Boris en 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.
Verificación = la palanca n.º 1. Tip 13 del hilo del 2 ene 2026: "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."
Automatizaciones con headless mode. 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.
Slash commands antes que prompts repetidos. Regla: "si haces algo más de una vez al día, conviértelo en una skill o un command". Ejemplo emblemático: /commit-push-pr, usado "decenas de veces al día".
Hooks deterministas, no agénticos. PostToolUse con bun run format || true es prácticamente el único hook que el propio Boris corre por defecto.
MCP solo para lo que no es código. MCP de Slack, BigQuery (vía CLI bq), Sentry, GitHub Action. Para búsqueda de código usa búsqueda agéntica (grep + glob), no RAG.
❦ ❧ ❦
00
Quién dice qué

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:

Boris Cherny
@bcherny
Creador y responsable de Claude Code. Ex Principal Engineer durante 5 años en Meta. Autor de Programming TypeScript (O'Reilly).
Blog de Anthropic (18-abr-2025) · "Mastering Claude Code in 30 minutes" (AI Engineer World's Fair, jun 2025, YouTube 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).
Cat Wu
@_catwu
Responsable de producto de Claude Code y Cowork.
Latent Space (7-may-2025) · Lenny's Podcast (23-abr-2026) · hilo en X 16-abr-2026 (consejos para Opus 4.7).
Thariq Shihipar
@trq212
Líder técnico de Claude Code.
Hilos en X mar–abr 2026 (Opus 4.7, vista de agentes, gestión de sesiones).
Erik Schluntz
@ErikSchluntz
Ingeniero de Claude Code.
Construyó /btw como proyecto paralelo (lanzado 10-mar-2026).
Sid Bidasaria
Ingeniero fundador
Ingeniero fundador del equipo Claude Code.
Co-creador del prototipo inicial (Boris en Latent Space; agradecido en el post oficial).
Equipo CC
Cal Rueb · Drew Hodun · Daisy Hollman · Ashwin Bhat · Nodir Turakulov · Barry Zhang
Equipo de Claude Code agradecidos por Boris en el post oficial.
"Gracias especialmente también a Daisy Hollman, Ashwin Bhat, Cat Wu, Sid Bidasaria, Cal Rueb, Nodir Turakulov, Barry Zhang, Drew Hodun y a muchos otros ingenieros de Anthropic cuyas valiosas ideas y experiencia práctica con Claude Code ayudaron a dar forma a estas recomendaciones."
01
Día uno

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")

ComandoQué hace
/terminal-setupHabilita Shift+Enter para saltos de línea. Necesario en la terminal de VS Code, Apple Terminal, Warp, Alacritty.
/themeClaro / oscuro / Daltonize.
/install-github-app(o /install-github-action) — permite mencionar @claude en issues y PRs.
/configAlterna notificaciones y estilo de salida.
/permissionsPre-aprueba comandos bash seguros.
/vimBoris no lo usa, pero "a la gente le encanta el modo Vim" (Cat Wu, Latent Space).
Dictado en macOSTip 15 (hilo 29-mar-2026): "Boris escribe la mayoría de su código hablándole a Claude, en lugar de tecleando."
Modelo por defecto recomendado (2026)

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."

Terminal recomendada

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.

02
El archivo más importante del repo

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:
  • 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
Post oficial · Anthropic Engineering · 18 abr 2025
Regla de longitud

"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

— Dónde puede vivir un CLAUDE.md —
# Mayor prioridad → menor prioridad <enterprise root>/CLAUDE.md # política a nivel de organización (gestionada) │ ├── /repo-root/CLAUDE.md # commiteado a git (recomendado) │ │ o CLAUDE.local.md # en .gitignore (solo local) │ │ │ ├── /repo-root/foo/CLAUDE.md # bajo demanda al editar foo/ │ └── /repo-root/bar/CLAUDE.md │ └── ~/.claude/CLAUDE.md # tu home, todas las sesiones # /init genera el CLAUDE.md inicial del repo automáticamente.

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
Flujo de trabajo específico de Boris

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)."
Tip 3 del hilo 31-ene-2026

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."

Patrón alternativo de un ingeniero del equipo

"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.

03
El flujo de trabajo canónico

Plan mode, modos de pensamiento y Explorar → Planear → Codear → Commit

— Las 4 fases del flujo de trabajo canónico —
Fase i
Explorar
"Lee X, Y, Z pero aún no escribas código." Usa subagentes para investigar sin contaminar el contexto.
➤
Fase ii
Planear
"think hard" / "ultrathink" + plan mode (Shift+Tab×2). Itera el plan hasta que te guste.
➤
Fase iii
Codear
Auto-accept edits. Implementa y verifica la razonabilidad mientras avanza.
➤
Fase iv
Commit
Commit + PR + actualizar README/changelog. Boris usa /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.

Cuándo entrar a Plan mode · Boris, hilo 2-ene-2026, tip 6
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
Cuándo NO planificar (post oficial)

"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

(sin frase)
Tarea trivial — el modelo decide
medio por defecto
think
Preguntar opciones, comparar alternativas
bajo extra
think hard
Refactor multi-archivo
medio
think harder
Depuración compleja
alto
ultrathink
Decisiones arquitectónicas, migraciones grandes
~32k tokens (v1) / xhigh-max (v2.1.68+)
Desde v2 (Opus 4.6+) — comando /effort

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+).

04
El "mayor desbloqueo de productividad"

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
Detalle importante

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)

bash
git 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

bash
claude --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)

— La configuración de pestañas numeradas de Boris —
iTerm2 · pestaña 1 · ~/repo-1
claude > refactor del middleware de auth
iTerm2 · pestaña 2 · ~/repo-2
claude > arregla test flaky de CI en user.spec
iTerm2 · pestaña 3 · ~/repo-3
claude > migra componente a React 19
iTerm2 · pestaña 4 · ~/repo-4
claude > escribe tests para el flujo de billing
iTerm2 · pestaña 5 · ~/repo-5
claude > /simplify tras el agente principal
claude.ai/code · web × 5–10 sesiones
browser › agentes en la nube de larga duración
app de Claude en iOS · sesiones móviles
mobile › arrancar AM · revisar PM
  • 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: & para mandar una sesión a segundo plano, --teleport y /teleport para mover sesiones entre local/web/móvil, claude remote-control para controlar sesiones locales desde el móvil (v2.1.74+).
Vista de agentes Lanzada 11-may-2026 · vista previa de investigación · v2.1.139+

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
05
Automatización del bucle interno

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

ComandoFunciónFuente
/commit-push-prFlujo de git completo, "decenas de veces al día".Boris X 2-ene-2026
/simplifySkill oficial (27-feb-2026): agentes paralelos mejoran calidad / deduplican.Boris X 27-feb-2026
/batchMigración masiva (Solid→React, etc.) repartida en docenas de worktrees.Boris X 27-feb-2026
/goCompuesto: testea de extremo a extremo → /simplify → abre PR.Boris X 16-abr-2026
/loopTarea recurrente hasta 3 días sin supervisión.Boris X 7-mar-2026
/scheduleCron en la infraestructura de Anthropic; sigue corriendo con el portátil cerrado.@noahzweben 23-mar-2026
/btwPregunta paralela de un turno sin llamadas a herramientas; mantiene el contexto principal.Erik Schluntz · @trq212 · 11-mar-2026
/rewindVolver a un mensaje previo (también doble-Esc).@trq212 15-abr-2026
/focusOcultar las salidas intermedias de herramientas, ver solo el resultado final.Boris X 16-abr-2026
/fewer-permission-promptsEscanea 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
Skill como alternativa a slash command

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."

06
Cuando un Claude no basta

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)

.claude/agents/ ├── build-validator.md ├── code-architect.md ├── code-simplifier.md ├── oncall-guide.md └── verify-app.md

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)

  1. Settings gestionados (empresa).
  2. Flag CLI --agents.
  3. .claude/agents/ (proyecto, commiteado a git).
  4. ~/.claude/agents/ (usuario, todos los proyectos).
  5. 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).
Construcción explícita en paralelo · Boris, hilo 31-ene-2026, tip 8
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
07
Eventos del ciclo de vida

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)

SessionStart
iniciar / reanudar / limpiar sesión
Inyectar contexto del día (feed de Slack, variables de entorno).
UserPromptSubmit
al enviar un prompt
Registro, redacción de secretos, renombrado automático de sesión.
PreToolUse
antes de una llamada a herramienta
Bloquear (exit 2) o modificar el input; sandboxing dinámico.
PermissionRequest
cuando se pide permiso
Enrutar a Opus / Slack / WhatsApp (Boris explícitamente lo recomienda).
PostToolUse
tras herramienta exitosa
Formatear, lintear, test rápido.
PostToolUseFailure
tras herramienta fallida
Diagnóstico, reintento.
SubagentStart / Stop
subagente arranca / termina
Limpieza, registro por agente.
Notification
Claude emite una notificación
Alerta en Slack o escritorio.
Stop
Claude termina un turno
"Empujar a Claude para que siga"; validación final.
StopFailure
Stop con error
Recuperación.
PostCompact
tras /compact
Re-inyectar instrucciones críticas perdidas al compactar (mar 2026).
WorktreeCreate / Remove
crear / borrar worktree
Soporte para jj / Mercurial / Perforce.
Setup
con --init / --maintenance
Inicialización del repo.
Elicitation / Result
elicitación de MCP
Interceptar diálogos.

Tipos 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 salidaEfecto
exit 0Permite y continúa.
exit 2 en PreToolUseBloquea la llamada a la herramienta.
exit 2 en StopFuerza 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.

Precedencia entre hooks y permissions

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.

08
Sin --dangerously-skip-permissions

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)

ModoComportamiento
defaultPregunta en cada herramienta nueva.
acceptEdits aceptación automáticaAuto-acepta las ediciones, sigue preguntando por bash.
planSolo lectura; no escribe nada.
bypassPermissionsEquivalente a --dangerously-skip-permissions; Boris solo lo usa dentro de un sandbox o contenedor para tareas largas no atendidas.
auto nuevo · mar 2026Anthropic 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.
Sandboxing

/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)

  1. Gestionado (organización) — managed-settings.json administrado.
  2. Flags de CLI.
  3. .claude/settings.local.json (ignorado por git por defecto).
  4. .claude/settings.json (compartido en el repo).
  5. ~/.claude/settings.json (usuario, todos los proyectos).

Boris deja casi todo en .claude/settings.json (compartido con el equipo) y casi nada en local.

09
Solo para herramientas no-código

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" } } }
Regla heurística · getpushtoprod.substack.com, mar 2026

"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).
Tool Search · se auto-activa cuando las definiciones de herramientas superan el 10% de la ventana de contexto

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).
10
Para CI, hooks, scripts y agentes

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
Flag --bare · hilo 29-mar-2026, tip 12

Aceleració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

bash
claude -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).

11
Mock visual → navegador → iterar

Patrones para apps web full-stack (Next.js / React)

Síntesis de Latent Space may-2025 + Lenny's Podcast feb-2026 + threads:

Paso 1
Arrancar con un mock visual

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
Paso 2
Verificación con un navegador real

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.
Paso 3
Auto-arranque de servidores web

La Claude Desktop app puede arrancar y testear servidores en un navegador embebido. En CLI/VSCode se hace con la extensión de Chrome.

Paso 4
Subagentes de verificación

verify-app corre tests E2E antes de cada merge a main.

Paso 5
Stack interno de Claude Code

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".

Diseñadores no técnicos en el producto Cowork

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.

Anti-patrón para web

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.

12
Scripts, cron, ralph-loops

Patrones para automatizaciones y agentes

CasoCómoFuente
Triaje automático de issues de GitHubGitHub Action + claude -pPost oficial
Linting semántico en PRsGitHub Action + slash command /lint + MCP de GitHub para commitear de vueltaBoris, Latent Space
Generación automática de changelogsclaude -p lee git log en cada releaseBoris, Latent Space
Fix automático de hilos de bugs en SlackMCP 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 micromanagementBoris, 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 PRsFuncionalidad de Code Review (mar 2026) — equipo de agentes para cazar bugsBoris, 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 SlackBoris, 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
Patrón de costo · Cat Wu en Latent Space (7-may-2025, verbatim)
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."

13
Cuándo /clear, cuándo /compact, cuándo /rewind

Manejo de contexto

Reglas operativas (post oficial + hilo de @trq212 15-abr-2026)

ComandoCuándo
/clearTarea genuinamente nueva. Brief escrito a mano, máximo control.
/compactTarea 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-EscCamino 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-sessionBifurcar una sesión existente.
Anti-patrón documentado por @trq212

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:

bash
CLAUDE_CODE_AUTO_COMPACT_WINDOW=400000 claude
Hook PostCompact · nuevo mar 2026

Re-inyecta las instrucciones críticas que se pierden al compactar.

Memoria automática · /memory, auto-dream, mar 2026

Subagente 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.

14
@claude en issues, PRs y CI

Integración con GitHub y CI/CD

Configuración base

  • /install-github-app o /install-github-action — instala la GitHub Action de Claude Code alojada por Anthropic.
  • Etiqueta @claude (o @.claude) en issues/PRs para invocarlo.
  • El CLI gh debería estar instalado (Boris pre-aprueba Bash(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.

Funcionalidad Code Review · lanzada 9-mar-2026 por Boris

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.
Routines · anunciado 14-abr-2026, vista previa de investigación

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.

15
Delegar antes que guiar

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
Patrón "delegar antes que guiar" para Opus 4.7 · Cat Wu, 16-abr-2026
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:

Objetivo
Qué significa "hecho" en lenguaje plano.
Restricciones
Anti-objetivos, qué no tocar, contratos de API / rendimiento.
Criterios de aceptación
Cómo se verifica.

Ejemplo

prompt
Objetivo: 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
Para tareas nuevas grandes

El post oficial recomienda "haz que Claude te entreviste primero":

"Quiero construir [descripción breve]. Entrevístame en detalle usando la herramienta AskUserQuestion."

Voz, no teclado · Tip 15, hilo 29-mar-2026
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
16
Atajos del teclado y prefijos mágicos

Feedback, interrupciones, correcciones

Atajo / PrefijoQué hace
EscCancela la operación actual.
Doble-Esc o /rewindVuelve a un mensaje previo y descarta lo posterior. Preferible a "no, hazlo así".
Ctrl+RMuestra salida verbosa (proceso de pensamiento).
Ctrl+OHabilita 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 promptAñade la línea como memoria → se inserta en el CLAUDE.md relevante.
! al inicio del promptModo bash — ejecuta un comando y mete la salida al contexto.
@filenameIncluye un archivo/carpeta en el contexto.
/btw Erik Schluntz, mar 2026Pregunta paralela mientras Claude trabaja. Un solo turno, sin llamadas a herramientas, no entra al historial.
17
Escribe los tests, commit; código, itera, commit

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
Boris en Latent Space
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
18
Screenshots, mocks, simulator

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).

19
La opinión de Boris

Cuándo NO usar Claude Code

Refactors de modelo de datos donde tienes opiniones fuertes
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
Tareas que se describen en una frase de diff

Post oficial: si describes el cambio en una frase, sáltate el plan mode (y a menudo sáltate Claude).

Lenguajes exóticos / monolitos legacy

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".

Cuando no hay forma de verificar

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.

20
Anti-patrones explícitos

Errores comunes que Boris menciona evitar

ErrorPor qué
Saltarse el plan mode en cambios multi-archivoBoris 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 inferirDrena la ventana de contexto en cada turno; las reglas con baja señal se ignoran.
Usar --dangerously-skip-permissions fuera de un sandboxBoris solo lo permite dentro de un contenedor.
RAG / almacenes vectoriales para buscar códigoBoris 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 hooksRompe 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 planCat Wu (Opus 4.7): "Trátalo como un ingeniero al que estás delegando, no como un pair programmer."
21
Tips poco conocidos

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).
Verbos del spinner personalizables — por ejemplo, con temática Star Trek (Boris).
--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.
Auto-mode + /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.
Plugin de iMessage (mar-2026): Claude Code como contacto en la app Messages.
Estilos de salida (/config → "Explanatory" o "Learning") — útil para incorporación a codebases nuevos.
/branch o claude --resume <id> --fork-session para bifurcar sesiones.
Más de 80 settings y más de 180 variables de entorno documentadas (v2.1.145); usa el campo "env" en settings.json en lugar de scripts wrapper.
22
Diez principios rectores

Filosofía y principios que guían a Boris

Estos 10 principios aparecen repetidamente en sus apariciones públicas:

"Haz primero lo simple." Principio explícito de Anthropic (Cat Wu, Latent Space). CLAUDE.md es un .md, no un almacén vectorial. Compactar = "pídele a Claude que resuma".
"Claude Code no es un producto, es una utilidad Unix." Boris, Latent Space. Stdin/stdout, pipes, componible.
"Construye para el modelo de 3–6 meses adelante." Cat Wu: "Desde el principio, apostamos por construir para el modelo de dentro de seis meses, no para el modelo de hoy."
"La Lección Amarga gana." Sutton; interno de Anthropic: "eventualmente el modelo manejará la memoria por sí mismo". Evita scaffolding complejo que el modelo absorberá.
"Dale a Claude una forma de verificar su trabajo." El único factor con mayor apalancamiento — 2–3× calidad. Repetido en cada aparición.
"Es una cuestión de ROI, no una cuestión de costo." Boris, Latent Space.
"Cada error se convierte en una regla." CLAUDE.md como organismo auto-correctivo vía @.claude en PRs (Compounding Engineering).
"Demanda latente." Observa cómo los usuarios hackean tu producto y construye para eso. Origen de Cowork.
"Sub-financia los equipos y dales tokens ilimitados." Lenny's Podcast feb-2026: equipo pequeño, operación austera, cómputo ilimitado hasta encontrar el product-market fit.
Ingenieros > PMs en velocidad. Cat Wu (Lenny's): "contrata ingenieros con gran gusto por el producto" — "Los PRDs están muertos en el equipo de Claude Code: los prototipos los reemplazaron."
❦ ❧ ❦
·
Para replicar el setup de Boris hoy

Recomendaciones staged

Día 1
Setup mínimo viable
  1. npm install -g @anthropic-ai/claude-code
  2. claude /init en tu repo principal → genera el CLAUDE.md base.
  3. 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).
  4. claude /permissions → pre-aprueba tus comandos seguros (bun run *, gh pr *, tu test runner).
  5. Activa notificaciones de iTerm2 o equivalente.
  6. Cambia a /model Opus (4.7 si tienes acceso) con /effort high.
Día 2–3
Flujo de trabajo
  1. Adopta el ciclo Shift+Tab×2 (plan) → iterar el plan → Shift+Tab (auto-accept) → resolver de un tiro.
  2. Cuando algo falle dos veces, usa doble-Esc / /rewind en vez de corregir verbalmente.
  3. Tras cada corrección manual, pídele a Claude "Actualiza el CLAUDE.md para que no vuelvas a cometer ese error."
Semana 1
Automatización del inner loop
  1. Crea .claude/commands/commit-push-pr.md con bash inline.
  2. Crea un único hook PostToolUse que ejecute tu formateador (bun run format || true, prettier --write, etc.).
  3. 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."
Semana 2
Paralelización
  1. Aprende git worktree add o claude --worktree <nombre>. Empieza con 2 sesiones simultáneas, escala a 3–5.
  2. Crea tu primer subagente: code-simplifier con tools: Read, Edit, Grep, Glob.
Semana 3
Automatizaciones
  1. /install-github-action y prueba un linter semántico con claude -p.
  2. Identifica un flujo de trabajo que repites diariamente → conviértelo en slash command.
  3. Si tienes Slack / BigQuery / Sentry, añade un MCP server a la vez al .mcp.json y 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-permissions dentro 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).
·
Lee antes de tomar nada como dogma

Caveats

El stack exacto que usa Boris evoluciona semanalmente

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.

Boris dice explícitamente que su setup NO es la única forma correcta
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.

Algunas afirmaciones de Boris son su experiencia personal

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).

Algunas fuentes secundarias están hechas por fans

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).

El post original "Claude Code: Best practices for agentic coding"

(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.

No se encontró evidencia pública de un blog técnico activo

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.

Sobre las reglas deny en settings.json

Hay 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-permissions

Debe usarse SIEMPRE dentro de contenedor/sandbox. Es la posición de Anthropic y de Boris explícitamente.

Versiones específicas de funcionalidades

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).

Nota metodológica sobre la obtención de fuentes

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/).