Claude Code en 2026: Configuración, Comandos Slash, MCP y Subagentes

Última actualización: June 28, 2026

He usado Claude Code todos los días laborables durante el último mes en un monorepo Next.js real. Esta publicación detalla la configuración, los comandos slash, CLAUDE.md, MCP, subagents, permisos y hooks que realmente ejecuto, además de dónde falla.

Respuesta rápida: ¿qué es Claude Code y vale la pena?

Claude Code es el CLI de codificación agentico de Anthropic. Lee tu repo, edita archivos, ejecuta comandos shell y encadena herramientas hasta completar una tarea. Lo uso para implementar funcionalidades, corregir errores y revisar diffs sin salir del terminal.

La configuración que me funciona: instalar el CLI, añadir un CLAUDE.md, conectar dos o tres servidores MCP y mantener los permisos ajustados. Esa combinación lo transforma de un juguete de chat en un compañero de equipo que conoce tu base de código.

No es magia. En un repo de 200k archivos, alucina APIs y rompe tests. La recompensa llega cuando acotas las tareas, revisas cada plan y haces commits con frecuencia. Más sobre los límites reales al final.

¿Cómo configuras Claude Code?

Instalé el instalador nativo en macOS y Node en Linux. Ambos son caminos oficiales documentados en el repositorio en github.com/anthropics/claude-code.

## Instalador nativo para macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash

## o vía npm
npm install -g @anthropic-ai/claude-code

## verificar
claude --version

Luego ejecuté claude dentro de mi repo e inicié sesión con mi cuenta de Anthropic. Al primer lanzamiento, escaneó el árbol y me pidió confirmar el acceso al directorio. Dije que sí solo para la raíz del proyecto, no para toda mi carpeta personal.

Algunas decisiones de configuración que tomé al principio y que no lamenté:

• Fijé la versión en CI para que los compañeros de equipo coincidan.
• Añadí .claude/ a .gitignore, excepto settings.json, el cual sí cometí.
• Escribí CLAUDE.md antes de cualquier prompt real, porque la calidad del contexto decide la calidad de la salida.
• Mantuve activado el modo predeterminado de "preguntar antes de acción destructiva" durante la primera semana.

La referencia oficial para instalación y configuración se encuentra en docs.claude.com/en/docs/claude-code, el cual mantengo abierto mientras configuro.

¿Qué comandos slash uso a diario?

Los comandos slash son la forma más rápida de dirigir una sesión. Los aprendí ejecutando /help y reduciendo la lista a los que realmente utilizo.

Ejecuto /clear más que cualquier otro comando. Cuando una sesión se confunde, un lienzo limpio más un prompt ajustado soluciona el 80 por ciento de los problemas. /compact es la versión más suave que uso cuando quiero mantener el impulso pero el contexto se está volviendo pesado.

¿Cómo escribir un CLAUDE.md que rinda frutos?

CLAUDE.md es un archivo markdown que Claude lee al comienzo de cada sesión. Trátalo como documentación de incorporación para un nuevo empleado que es rápido pero tiene cero memoria de tus decisiones.

Ejecuto /init para generar un primer borrador, y luego lo reescribo a mano. La versión generada es un punto de partida, no el archivo final. Mi CLAUDE.md cubre la pila tecnológica (stack), las convenciones, el diseño (layout), los comandos y los tres errores que nunca quiero que se vuelvan a introducir.

## Project

Next.js 14 App Router, TypeScript strict, Prisma + Postgres, pnpm workspaces.

## Layout
- App routes in app/
- Server actions in app/actions
- UI primitives in packages/ui

## Conventions
- Prefer async/await over .then chains
- Never use `any`; type unknown and narrow
- Keep components under 200 lines

## Commands
- Dev: pnpm dev
- Test: pnpm test
- Lint: pnpm lint

## Known traps
- Do not edit prisma/schema.prisma without running migrate
- rate-limit.ts is shared; changes affect all routes

Dos errores de CLAUDE.md que cometí y corregí. Primero, escribí párrafos en lugar de listas, lo cual diluyó la señal. Segundo, puse el historial del proyecto allí, lo cual consumió tokens sin beneficio. Mantenlo corto, imperativo y actual.

Para los patrones más profundos, mi Claude Code skills writeup desglosa fragmentos de prompt reutilizables que combinan bien con CLAUDE.md.

¿Cómo funcionan MCP y subagents en la práctica?

MCP (Model Context Protocol) es cómo Claude Code se conecta fuera de tu repo: bases de datos, navegadores, GitHub, Linear. Ejecuto tres servidores MCP y eso es más que suficiente. Más servidores significan más tokens y más prompts de aprobación.

Mi configuración actual de MCP realiza trabajo real cada semana:

• El servidor GitHub abre PRs y lee comentarios de revisión.
• El servidor Postgres responde "¿cuántas filas coinciden?" sin que yo escriba SQL.
• El servidor Playwright verifica cambios de UI contra una URL de staging.

Los configuré en .claude/settings.json y verifiqué cada uno con un prompt de una línea antes de confiar en él en una tarea real. La configuración y la selección de servidores se cubren en detalle en la guía de integración MCP para Claude Code y el más amplio primer sobre contexto de modelo MCP.

Los subagents son el otro multiplicador. Para una funcionalidad con partes independientes, pido a Claude que despache subagents paralelos, cada uno limitado a un archivo o módulo, y deja que un agente líder fusione los resultados. Reduce el tiempo de reloj en cambios grandes.

Los subagents brillan cuando el trabajo es genuinamente paralelo. Fallan cuando las tareas comparten estado, porque el paso de fusión se vuelve desordenado. Para los patrones de paralelización en los que confío, ver Claude Code subagents and team automation.

¿Cómo funcionan permisos y hooks?

Los permisos deciden lo que Claude puede hacer sin preguntar. Mantengo los valores predeterminados conservadores y los expando por proyecto. El prompt de aprobación aparece antes de cualquier cosa destructiva, que es la red de seguridad que nunca desactivo.

Los hooks son scripts definidos por el usuario que se ejecutan ante eventos de Claude: antes de un comando, después de una edición, al iniciar una sesión. Utilizo un hook post-edit para ejecutar automáticamente el linter y el type-checker, para que Claude reciba retroalimentación rápida sin que yo tenga que ejecutar nada.

Un hook me salvó la semana pasada. Mi hook pre-command bloqueó un rm -rf contra una ruta fuera del proyecto, y Claude se ajustó a una eliminación limitada (scoped delete). Ese es exactamente el tipo de protección por la que vale la pena dedicar diez minutos a configurar.

¿Vale la pena Claude Code en 2026?

Sí, para los desarrolladores que ya viven en el terminal. El costo es real, medido en tokens, y vale la pena cuando tus tareas están acotadas y tu repo está bien descrito por CLAUDE.md.

Me reemplazó tres herramientas: un chat de IA separado, un asistente de búsqueda CLI, y la mayor parte de mi exploración manual de grep-y-leer. El ciclo nativo del terminal es más rápido que cambiar de pestaña a un navegador.

Donde todavía pierde: refactorizaciones grandes y ambiguas, frameworks totalmente nuevos con poca documentación, y cualquier cosa que requiera buen juicio en toda una base de código. Para eso, planifico primero en texto plano, y luego le doy a Claude una especificación precisa.

¿Deberías confiarlo con código de producción?

No sin supervisión. Trato la salida de Claude Code como trato un PR de un junior competente: reviso cada diff, ejecuto los tests y nunca fusiono por fe. La autonomía es un dial, no un interruptor.

La honesta advertencia: Claude Code producirá con confianza código que parece correcto y está sutilmente mal, especialmente en el manejo de errores y la limpieza asíncrona (async cleanup). Revisa tú mismo las rutas de fallo, mantén un rollback rápido, y obtienes un aumento serio de productividad sin los desastres. La documentación de Anthropic cubre la configuración que no repito aquí.

Conclusiones clave

• Instala el CLI, luego invierte en CLAUDE.md antes del primer prompt real.
• Domina /clear, /compact y /permissions; el resto son opcionales.
• Empieza con dos o tres servidores MCP y añade solo cuando un flujo de trabajo lo exija.
• Usa subagents para trabajo paralelo e independiente; mantén las tareas con estado compartido seriales.
• Mantén los permisos ajustados y añade hooks para lint, type-check y guardias contra comandos destructivos.
• Revisa cada diff como si fuera un PR. La autonomía sin revisión es donde sufren los proyectos.

Créditos de imágenes

• Código fuente colorido brillando en el monitor de un desarrollador — foto de Mikhail Nilov en Pexels
• Primer plano borroso de código de programación colorido mostrado en una pantalla — foto de Pixabay en Pexels
• Un programador usando auriculares codificando en un escritorio con monitores dobles — foto de Christina Morillo en Pexels
• Un ingeniero de software escribiendo y revisando código en una oficina moderna — foto de ThisIsEngineering en Pexels