Claude Code: qué es y cómo funciona en 2026

En pocas palabras: Claude Code es la herramienta de línea de comandos de Anthropic para programar con agentes. Se presentó el 24 de febrero de 2025 junto a Claude 3.7 Sonnet: desde tu terminal lee código, edita archivos, corre tests y hace commits, mientras te mantiene al tanto de cada paso.

Para completar los siete pasos necesitás una cuenta, una terminal y un proyecto de prueba. Esta es la lista con cómo verificar cada cosa:

Una cuenta que Claude Code acepte. El curso Claude Code 101 pide plan Pro, Max o Enterprise, o una API key.
Una terminal. La de siempre en macOS y Linux; en Windows, una sesión de WSL. Si ya instalaste Claude Code antes, claude --version te lo confirma.
Git. Tener el proyecto bajo git te deja deshacer lo que haga el agente (consejo mío, no de la doc).
Un proyecto real y chico. Con un par de funciones y un README alcanza. Si podés, usá uno que no sea el de producción.
Nociones básicas de editor y línea de comandos. El curso las pide y aclara que no hace falta experiencia previa con herramientas de IA.
Node.js 18 o superior. Es lo que pide la guía de terceros para instalarlo con npm.

¿Cuánto cuesta? La documentación que usamos para esta nota no trae precios, así que no te fijo uno. La guía de terceros de Es la Hora de Aprender menciona unos US$20 mensuales para Pro y US$200 para Max, que según ella da uso “ilimitado” (las comillas son de la guía, y a mí también me hacen ruido), además de una capa gratuita con límites. Tomalo como referencia no confirmada. Y ojo: el curso oficial habla de Pro, Max, Enterprise o API key, no de plan gratuito, así que verificá en la página de planes de Anthropic antes de pagar o de contar con la capa gratis.

Paso 1: Abrí la terminal que corresponde a tu sistema

En macOS y Linux abrí tu terminal. En Windows abrí una sesión de WSL, y comprobá que tenés Git.

git --version

Resultado esperado: una línea con la versión de Git. Si el comando no se reconoce, instalá Git y volvé.

Paso 2: Instalá Claude Code

Instalalo con npm, que es la vía que muestra la guía de terceros.

# macOS y Linux
npm install -g @anthropic-ai/claude-code

# Windows (requiere WSL2): el mismo comando, dentro de la sesión WSL

La guía de terceros de mayo de 2026 indica Node.js 18 o superior, y dice que en Windows hace falta WSL2.

Resultado esperado: la instalación termina sin errores y vuelve al prompt. Todavía no ves nada de Claude.

Paso 3: Verificá que la instalación quedó bien

claude --version

Resultado esperado: un número de versión. Eso confirma que el ejecutable está en el PATH.

Ojo: si ves command not found: claude o The term 'claude' is not recognized, cerrá la terminal y abrí una nueva. Suele ser la causa, porque el PATH se carga al iniciar la sesión.

Paso 4: Entrá a tu proyecto y arrancá la primera sesión

cd tu-proyecto
claude

Resultado esperado: Claude Code abre una sesión interactiva en esa carpeta y, la primera vez, te pide iniciar sesión. Seguí el flujo con tu cuenta de Claude o de Anthropic Console. Relacionado: explicadores sencillos con la skill ELI5.

Dos comandos para tener a mano, según la guía de terceros: /help dentro de la sesión lista los comandos disponibles, y claude -p "instrucción" ejecuta una orden puntual sin abrir sesión interactiva.

Ojo con la carpeta: arrancá siempre dentro del proyecto. Si abrís claude en tu carpeta personal o en la raíz del disco, le estás dando un contexto enorme y sin sentido.

Paso 5: Hacé una primera pregunta exploratoria

La guía de Es la Hora de Aprender recomienda que la primera instrucción sea exploratoria y no destructiva: que Claude Code mapee el proyecto antes de cambiar algo. Probá alguna de estas:

Explicame qué hace este proyecto leyendo el README y los archivos principales
Encontrá y listá todas las funciones que no tienen tests

Resultado esperado: un resumen del proyecto o una lista de funciones, sin archivos modificados. Podés comprobarlo con git status.

Ojo: si Claude Code te pide aprobación para leer o ejecutar algo, leé qué quiere hacer antes de aceptar.

Paso 6: Creá el archivo CLAUDE.md (qué es y para qué sirve)

CLAUDE.md es un archivo markdown en la raíz del proyecto que Claude Code lee al inicio de cada sesión. Ahí ponés estándares de código, decisiones de arquitectura, librerías preferidas y checklists de revisión.

Ejemplo ilustrativo (inventado para esta guía, adaptalo a tu stack):

# Proyecto: tienda-api

Stack
- Node.js y TypeScript
- Tests con Vitest

Convenciones
- Las funciones puras van en src/lib
- Nada de any en TypeScript

Antes de dar una tarea por terminada
- Correr npm test
- Revisar que no queden console.log

Resultado esperado: en la próxima sesión, Claude Code ya conoce esas reglas sin que las repitas.

Ojo: mantenelo corto. Es mi criterio, no una cifra de la doc: cada línea compite por espacio en el contexto, y un CLAUDE.md de cuarenta páginas es peor que ninguno.

Paso 7: Pedile una tarea real y revisá los cambios

Creá una rama para no ensuciar la principal y pedí algo acotado, parecido al ejemplo oficial. Si querés ver el enfoque antes de que toque nada, pedile un plan primero o usá el Plan Mode que explica el curso. Complementá con cómo se comporta en codebases enormes.

git switch -c prueba-claude-code
claude

Escribí tests para src/utils.js, corrélos y arreglá lo que falle

Resultado esperado: Claude Code escribe los tests, los corre y corrige los que fallan. Después revisás todo con git status y git diff.

Ojo: adaptá el nombre del archivo a uno que exista en tu proyecto. Y no aceptes cambios que no entendés solo porque los tests pasan.

Resultado final

Al terminar tenés Claude Code instalado y verificado, una sesión andando dentro de tu proyecto, un CLAUDE.md con tus reglas y una primera tarea revisada en una rama aparte. Para comprobarlo, corré claude --version y mirá el git diff de la rama de prueba.

Lo que ahora podés hacer y antes no: delegar tareas acotadas (tests, refactors chicos, depuración) y revisarlas como si fueran un pull request.

¿Qué son MCP, skills, hooks y subagentes en Claude Code?

Son las piezas para extender Claude Code: MCP conecta herramientas externas, las skills guardan flujos repetibles, los hooks corren comandos antes o después de ciertas acciones y los subagentes reparten el trabajo. Según la documentación oficial y el curso de Anthropic, funcionan así:

MCP (Model Context Protocol): estándar abierto para conectar herramientas y sistemas externos.
Skills: flujos repetibles y compartibles, como /review-pr.
Hooks: comandos de shell antes o después de acciones, por ejemplo un autoformateo. El curso los presenta como guardrails deterministas.
Subagentes: agentes especializados que podés crear para tareas que repetís, y agentes en paralelo.
Agent SDK: para construir tus propios agentes.
Automatización: claude -p.

Un detalle de la guía de terceros que vale oro: conectar una API no es enseñarle al agente a usarla. Su conductor tuvo que crear una skill que explicara cómo trabaja él con HubSpot, porque darle el token no alcanzaba. La misma guía dice que en abril de 2026 Anthropic lanzó /goal para dejar un objetivo corriendo hasta completarlo. No lo encontré en las fuentes primarias, así que va como no confirmado.

Mi lectura sobre los hooks: un hook corre siempre, mientras que una instrucción en el prompt depende de que el modelo la respete. Si hay una regla que no podés negociar (formatear antes de guardar, por ejemplo), va en un hook. Y no arranques por acá: primero CLAUDE.md, después lo demás.

¿Es seguro darle acceso a Claude Code a mi código y archivos?

Claude Code puede leer y editar archivos y ejecutar comandos, así que el riesgo existe y lo acotan los permisos y el modo de aprobación. El curso de Anthropic explica que las herramientas y los permisos determinan qué puede hacer, y que los hooks agregan guardrails deterministas. Los detalles del modelo de permisos están en la documentación oficial y conviene leerlos antes de abrir un repo con credenciales.

La guía de terceros cuenta que su autor pasó, en mayo de 2026, de aprobar cada paso a dejar que el agente ejecute y revisar el resultado al final. Para eso fijaron un objetivo claro, permisos explícitos de carpetas y comandos, y un aviso al terminar. Mi consejo es más conservador: trabajá en una rama, con git limpio, y sin secretos a la vista. Ya lo cubrimos antes en controlar tus sesiones de forma remota.

¿Se puede usar Claude Code sin saber programar?

Con poco alcanza para empezar, pero no con cero. El curso Claude Code 101 pide familiaridad básica con un editor de código y la línea de comandos. La guía de terceros sostiene que también sirve para operar un negocio sin escribir código (ordenar archivos, armar reportes) y menciona Claude Cowork, un modo agente dentro de Claude.ai que no exige abrir una terminal.

El tema es otro: si no entendés lo que el agente escribió, revisar se convierte en el cuello de botella. ¿Es un problema de la herramienta? No, es un problema de quien firma el cambio.

¿Y contra Cursor, Copilot o Codex CLI?

Con las fuentes de esta nota solo se puede comparar con Cursor, y la comparación es de una guía de terceros. Según Es la Hora de Aprender, Cursor es un IDE completo (un fork de VS Code con IA integrada) y Claude Code es un agente en la terminal pensado para trabajar con autonomía durante horas. Sobre GitHub Copilot y OpenAI Codex CLI no tenemos datos verificables, así que no los comparo.

La guía propone usar los dos: Cursor para el día a día interactivo, Claude Code para análisis y automatización. Tomalo con pinzas, porque es la opinión de un podcast que usa Claude Code en producción y no un benchmark. Nuestros colegas de donweb.news lo analizan en exponer tu localhost con Dev Tunnels.

¿Por qué se habla tanto de Claude Code?

Se habla tanto porque Anthropic lo presentó con una promesa concreta (delegar tareas de ingeniería desde la terminal) y hoy, según la documentación, está en terminal, IDEs, escritorio y web. Lo que no hay en las fuentes es un número de adopción, así que cualquier ranking de popularidad queda como contexto no confirmado.

Según el anuncio de Anthropic del 24 de febrero de 2025, en pruebas tempranas Claude Code completó en una sola pasada tareas que normalmente llevan más de 45 minutos de trabajo manual. El equipo lo consideraba indispensable para depurar problemas complejos y hacer refactors grandes. ¿Alguien verificó ese número de forma independiente? No en las fuentes que tenemos: es una medición del propio fabricante y el post no publica el método.

Mi lectura, y es opinión: engancha porque lo que configurás (CLAUDE.md, MCP, skills) viaja entre superficies. Ese es un argumento de flujo de trabajo, no de benchmark.

Confirmado vs. no confirmado

Los datos de esta guía vienen de las fuentes del final y reflejan lo que ellas decían al armar la nota, en octubre de 2026.

Afirmación	Estado	Fuente
Presentación el 24/02/2025 como vista previa de investigación junto con Claude 3.7 Sonnet	Confirmado	Anuncio de Anthropic
Tareas de más de 45 minutos completadas en un paso en pruebas tempranas	Dato de Anthropic, sin método publicado	Anuncio de Anthropic
Disponible en terminal, VS Code, JetBrains, escritorio y web	Confirmado	Documentación oficial
Planes de unos US$20 (Pro) y US$200 (Max)	No confirmado	Guía de terceros
Existencia de una capa gratuita	Contradictorio: la guía de terceros la menciona, el curso oficial pide plan pago o API key	Verificar en Anthropic
Lanzamiento de `/goal` en abril de 2026	No confirmado en fuentes primarias	Guía de terceros
Claude Code rinde mejor que Cursor en tareas largas	Opinión sin benchmark	Guía de terceros
Adopción, cuota de mercado, popularidad	Sin datos en las fuentes	Ninguna

Errores comunes

command not found: claude / The term ‘claude’ is not recognized

Aparece en el Paso 3. Pasa porque la terminal abierta no recargó el PATH después de instalar. Cerrá la terminal, abrí otra y repetí claude --version. Si sigue igual, verificá que la instalación haya terminado sin errores y repetila. Sobre eso hablamos en la comparativa con Gemini 2.5.

Sesiones largas que pierden el hilo

Aparece entre los Pasos 5 y 7, cuando el contexto se llena. Usá /compact para resumir, /clear para empezar de cero o /context para ver cómo está, comandos que cubre el curso Claude Code 101. Mejor todavía: una tarea por sesión.

Instrucciones en español que se saltea

Puede pasar en cualquier flujo con herramientas. La guía de terceros dice que el uso de herramientas es menos confiable en español porque muchos modelos se entrenaron sobre todo en inglés, y que los modelos nuevos están mejorando. Si un flujo es crítico, escribí las descripciones de herramientas en inglés aunque el resultado sea en español. Es una recomendación de esa guía, sin medición propia.

Depender de un solo proveedor

Se nota cuando ya armaste todo sobre Claude Code y se cae el servicio. La guía de terceros dice que midieron 93,7% de uptime en GitHub durante un mes, unas 45 horas de caída, y lo usa como ejemplo de riesgo (el dato es de ellos y es sobre GitHub, no sobre Claude). Su recomendación es consumir Claude por AWS Bedrock o Azure y tener definido qué tareas hacés a mano.

Preguntas Frecuentes

¿Cómo se instala Claude Code en Windows?

Según la guía de terceros, en Windows hace falta WSL2: abrí una sesión WSL, ejecutá npm install -g @anthropic-ai/claude-code (requiere Node.js 18 o superior) y después verificá con claude --version.

¿Claude Code es lo mismo que Claude en el navegador?

No. Claude en el navegador es un chat que responde texto, mientras que Claude Code es un agente que lee y edita archivos de tu proyecto y ejecuta comandos. Hay una versión web del agente en claude.ai/code, que es otra superficie de Claude Code y no el chat.

¿Necesito saber programar para usar Claude Code?

Necesitás familiaridad básica con un editor y la línea de comandos, según el curso Claude Code 101 de Anthropic. Una guía de terceros sostiene que también sirve para tareas de negocio sin código, y menciona Claude Cowork como modo sin terminal.

¿Cuánto cuesta Claude Code?

No hay un precio confirmado en las fuentes oficiales de esta nota, que piden plan Pro, Max o Enterprise, o una API key. Una guía de terceros del 28 de mayo de 2026 habla de unos US$20 mensuales (Pro) y US$200 (Max), con pago por token en la API; verificalo en la página de planes de Anthropic.

Conclusión

Si seguiste los siete pasos, tenés Claude Code instalado, verificado y probado sobre un proyecto propio, con un CLAUDE.md que fija tus reglas. Repetilo con un proyecto más grande cuando la primera tarea te salga prolija, y sumá recién entonces hooks, skills o MCP, de a uno.

Lo que sigue lógicamente es automatizar lo repetitivo con claude -p y revisar los permisos antes de aflojar la aprobación. Mi postura: es una herramienta útil y todavía le falta evidencia independiente, así que desconfiá de las cifras que no traen método.

Claude Code: qué es y por qué todos hablan de él