¿Qué es Claude Code?
Claude Code es el CLI oficial de Anthropic: un agente de programación que corre en tu terminal y puede leer, escribir y modificar código de manera autónoma. A diferencia de los asistentes integrados en editores, Claude Code no necesita que hagas copy-paste ni que le des contexto de a pedacitos — tiene acceso directo al sistema de archivos, puede ejecutar comandos y encadenar tareas largas sin que tengas que supervisar cada paso.
La diferencia fundamental respecto a "hablar con Claude en el chat" es que acá el modelo actúa: ejecuta git diff, corre los tests, lee los logs y ajusta el código según los resultados. Es la diferencia entre pedirle a alguien que te explique cómo arreglar un bug y pedirle que lo arregle directamente.
Claude Code está disponible como paquete npm y se instala con un solo comando. Funciona en cualquier proyecto, sin importar el lenguaje o el framework, porque no depende de plugins ni integraciones — solo necesita acceso a tu terminal y a la API de Anthropic.
Lo que hace especialmente poderoso a Claude Code es su capacidad de operar con contexto persistente. A través del archivo CLAUDE.md, podés definir las convenciones de tu proyecto, los comandos habituales y las restricciones del codebase. Eso significa que cada sesión empieza con el modelo ya orientado, sin necesidad de re-explicar el contexto desde cero.
Conceptos clave
Para sacarle el jugo real a Claude Code hay algunos conceptos que vale la pena entender bien. No son opcionales: son la diferencia entre usar Claude Code como un buscador glorificado y usarlo como un colega de ingeniería.
CLAUDE.md es el archivo de instrucciones del proyecto. Claude lo lee automáticamente al inicio de cada sesión. Ahí van las convenciones del codebase, los comandos de build y test, las restricciones de arquitectura y cualquier contexto que el modelo necesite para no cometer errores básicos. Hay una guía entera dedicada a cómo usarlo para ahorrar tokens y mejorar la consistencia.
Hooks son acciones que Claude ejecuta automáticamente antes o después de ciertos eventos. Por ejemplo: correr los linters antes de cada commit, formatear el código después de cada escritura, o enviar una notificación cuando termina una tarea larga. Los hooks se configuran en el archivo settings.json del proyecto.
Skills son instrucciones reutilizables escritas en Markdown que le enseñan a Claude cómo ejecutar tareas específicas. En vez de repetir el mismo prompt cada vez, definís el skill una vez y lo invocás con un slash command.
MCP (Model Context Protocol) es el protocolo estándar que permite a Claude conectarse con herramientas externas: bases de datos, APIs, servicios de terceros, editores. Si usás Claude Code con MCPs conectados, el agente puede, por ejemplo, leer registros de Supabase, deployar en Vercel o buscar en Notion — todo desde la misma sesión.
Subagentes es la capacidad de Claude Code de lanzar instancias paralelas de sí mismo para trabajar en tareas simultáneas. En vez de procesar todo en serie, podés dividir un problema grande en subtareas y dejar que múltiples subagentes trabajen al mismo tiempo.
Worktrees de Git permiten tener múltiples ramas del mismo repositorio en directorios separados. Combinado con subagentes, esto significa que Claude Code puede trabajar en varias features en paralelo sin que las ramas se pisen entre sí.
Si estos términos todavía suenan abstractos, el diccionario de Claude Code con 8 conceptos clave los explica uno a uno con ejemplos concretos.
Cómo configurar tu entorno
El primer paso es instalar Claude Code globalmente con npm. Después, crear el archivo CLAUDE.md en la raíz del proyecto es prácticamente obligatorio si querés que el agente trabaje con contexto real. Un buen CLAUDE.md tiene tres secciones mínimas: descripción del proyecto, comandos de build/test/deploy, y convenciones de código.
La configuración de cowork es otra pieza central para equipos. Claude cowork te permite compartir una sesión de Claude Code entre múltiples personas, lo que convierte al agente en un miembro real del equipo que puede recibir tareas de cualquier integrante. Hay una guía paso a paso para configurar Claude cowork en 8 pasos que cubre desde la instalación hasta los permisos por rol.
Para proyectos más grandes, también conviene configurar MCPs específicos del proyecto. Si tu stack incluye Supabase y Vercel, por ejemplo, conectar esos MCPs desde el inicio significa que Claude puede leer los logs de base de datos, aplicar migraciones y deployar — todo sin salir de la terminal.
La elección del modelo importa. Claude Opus 4.7 es el modelo más capaz de Anthropic para tareas de razonamiento complejo y programación. Para tareas de refactoring directo o generación de boilerplate, Sonnet es más rápido y económico. Boris Cherny, quien lideró el desarrollo de Claude Code en Anthropic, compartió 6 tips concretos sobre cómo elegir el modelo correcto para cada tarea.
Workflow recomendado
El workflow que mejor funciona para proyectos serios tiene tres fases bien diferenciadas.
Fase de contexto: Antes de pedirle cualquier tarea, dejá que Claude Code lea el codebase. Comandos como /init o simplemente pedirle que explore la estructura del proyecto sirven para que el modelo construya un mapa mental de la arquitectura. Si el CLAUDE.md ya está bien escrito, esta fase es casi instantánea.
Fase de ejecución: Acá es donde Claude trabaja solo. La clave es dar instrucciones completas y verificables: en vez de "arreglá el login", decí "el formulario de login en app/auth/login.tsx devuelve error 401 cuando el email tiene mayúsculas — arreglá la validación y agregá un test". Con contexto claro, Claude puede completar tareas end-to-end sin que tengas que intervenir.
Fase de revisión: Claude Code puede generar código funcional muy rápido, pero siempre hay que revisar los cambios antes de mergear. Usá /diff para ver qué cambió, corrí los tests y leé el código nuevo con ojo crítico. Claude no comete los mismos errores que un humano junior, pero tiene sus propios puntos ciegos — especialmente en arquitectura y en decisiones de diseño de largo plazo.
Una práctica que mejora mucho la calidad de los outputs es empezar cada sesión con un objetivo claro y un criterio de "done" explícito. Si Claude sabe exactamente cuándo terminó una tarea (tests en verde, build sin errores, PR listo), puede trabajar de manera más autónoma y hacer menos preguntas innecesarias.
Recursos para profundizar
Estas guías te van a llevar de los conceptos a la práctica concreta:
- Cómo ahorrar tokens en Claude Code con el archivo CLAUDE.md — El archivo más importante de cualquier proyecto en Claude Code.
- Cómo configurar Claude cowork en 8 pasos — Para equipos que quieren usar Claude Code de manera colaborativa.
- El diccionario de Claude Code: 8 conceptos clave — Glosario completo de los términos del ecosistema.
- 6 tips de Boris Cherny para dominar Claude Opus 4.7 — Consejos directamente del creador de Claude Code.
- Claude Opus 4.7: el nuevo modelo más fuerte del mundo — Qué cambió en la última versión y por qué importa para programación.
