Qué es Claude Code y como usarlo

Qué es Claude Code

Claude Code es la herramienta de linea de comandos (CLI) oficial de Anthropic. No es un chatbot: es un agente de desarrollo que trabaja directamente en tu terminal, lee tu código, ejecuta comandos y modifica archivos.

A diferencia de usar Claude en el navegador, Claude Code tiene acceso a tu sistema de archivos, puede ejecutar scripts, conectarse a bases de datos y operar como un programador más en tu equipo. Para profundizar, consulta nuestra guía sobre Cómo instalar Claude Code paso a paso.

Arquitectura y como funciona

Claude Code funciona como un loop agentico: recibe tu instruccion, analiza el contexto (archivos, estructura del proyecto, historial), planifica acciones, las ejecuta y verifica el resultado. Si algo falla, itera automaticamente.

Componentes internos:

• Context engine: lee tu proyecto (CLAUDE.md, archivos abiertos, git history) y construye un contexto relevante para cada tarea.
• Tool system: herramientas internas (Read, Write, Edit, Bash, Glob, Grep) que el modelo invoca para interactuar con tu sistema.
• Permission layer: controla que puede hacer sin pedirte permiso (leer) vs que requiere aprobacion (escribir, ejecutar comandos).
• Memory system: CLAUDE.md a nivel de proyecto y ~/.claude/ a nivel global. Persiste entre sesiones.
• MCP layer: protocolo de conexión con herramientas externas (GitHub, DBs, APIs).

Flujo de una interacción tipica:

1. Tu escribes: "Anade tests para el módulo de autenticación"
2. Claude Code lee la estructura del proyecto, encuentra los archivos de auth
3. Analiza el código existente, identifica funciones sin tests
4. Genera los tests, los escribe en el archivo correspondiente
5. Ejecuta los tests para verificar que pasan
6. Si fallan, lee el error, corrige y re-ejecuta
7. Cuándo todo pasa: te muestra el resultado

Este loop de plan-execute-verify-iterate es lo que diferencia a Claude Code de un simple generador de texto. No para hasta completar la tarea o hasta que detecta que necesita tu input.

Instalacion paso a paso

Claude Code se instala con npm (Node.js). Si no tienes Node, instalalo primero desde nodejs.org.

# Instalar Claude Code globalmente
npm install -g @anthropic-ai/claude-code

# Verificar la instalación
claude --version

# Iniciar una sesion
claude

La primera vez te pedira autenticarte con tu cuenta de Anthropic. Necesitas un plan que incluya Claude Code (Max o Team). Para profundizar, consulta nuestra guía sobre CLAUDE.md: guía completa para configurar Claude Code.

Estructura del directorio .claude/

El directorio .claude/ es donde vive toda la configuración de tu proyecto. Es lo que convierte a Claude Code de un chat a un sistema configurado para tu caso de uso.

El archivo más importante es CLAUDE.md. Es donde le dices a Claude Code quien eres, que proyecto es este y como debe comportarse. Piensa en el como el README pero para la IA.

Funcionalidades clave

Claude Code tiene capacidades que van mucho más alla de generar código:

Memoria persistente: Claude Code recuerda entre sesiones. El archivo CLAUDE.md se carga automaticamente cada vez que abres una sesion en ese directorio. Puedes tener un CLAUDE.md global (~/.claude/CLAUDE.md) para preferencias personales y uno por proyecto para reglas especificas.

Hooks (automatización): scripts que se ejecutan automaticamente cuando ocurren eventos. Pre-commit, post-file-write, etc. Permiten que Claude Code sea proactivo sin que tengas que pedirle nada.

MCP (Model Context Protocol): protocolo que conecta Claude Code con herramientas externas. GitHub, Slack, bases de datos, APIs, navegador. Más de 100 servidores MCP disponibles en el ecosistema.

Subagentes: Claude Code puede lanzar agentes paralelos para tareas independientes. Por ejemplo: mientras un subagente escribe tests, otro refactoriza código, y otro actualiza documentación. Todo en paralelo.

Skills (habilidades): comandos reutilizables que encapsulan prompts complejos. Creas una skill una vez y la invocas con /nombre. Ejemplo: /commit genera commits semanticos, /review analiza PRs.

Worktrees: clona tu repositorio en ramas separadas para que agentes trabajen en paralelo sin conflictos. Ideal para tareas grandes que requieren multiples cambios independientes.

Hooks: acciones automaticas

Los hooks son scripts que se ejecutan automaticamente cuando ocurre un evento. Por ejemplo: antes de cada commit, despues de crear un archivo, o cuando Claude Code lee un fichero. Para profundizar, consulta nuestra guía sobre Claude Code vs Cursor vs Copilot: cual elegir.

// .claude/settings.json
{
 "hooks": {
 "PreCommit": [{
 "command": "npm run lint",
 "description": "Lint antes de commit"
 }],
 "PostFileWrite": [{
 "command": "prettier --write $FILE",
 "description": "Formatear archivo creado"
 }]
 }
}

Los hooks convierten a Claude Code en un sistema proactivo. No tienes que pedirle que formatee el código: lo hace solo.

Hooks disponibles:

• PreCommit: se ejecuta antes de cada git commit. Ideal para linting, tests rapidos.
• PostFileWrite: se ejecuta despues de crear o modificar un archivo. Ideal para formateo automático.
• PreToolExecution: se ejecuta antes de cualquier herramienta. Para logging o validación.
• PostToolExecution: se ejecuta despues de cualquier herramienta. Para notificaciones.

Agentes y subagentes

Un agente en Claude Code es una instruccion compleja que se ejecuta de forma autonoma. Puede leer archivos, ejecutar comandos, crear ficheros y tomar decisiones.

La diferencia con un prompt normal es que el agente itera: prueba, evalua, corrige y vuelve a intentar hasta completar la tarea.

Subagentes paralelos: Claude Code puede lanzar multiples agentes trabajando simultaneamente. Ejemplo real: "Refactoriza el módulo de auth, anade tests y actualiza el README". Claude Code lanza 3 subagentes: uno refactoriza, otro escribe tests (esperando al primero), otro actualiza docs. Resultado: tarea de 2 horas completada en 10 minutos.

MCP: conectar con herramientas

MCP (Model Context Protocol) permite a Claude Code conectarse con herramientas externas: GitHub, bases de datos, navegador, APIs, Slack y más.

Cada conexión MCP es un "servidor" que expone herramientas. Claude Code las descubre automaticamente y las usa cuando las necesita.

// Ejemplo: conectar con GitHub y PostgreSQL
{
 "mcpServers": {
 "github": {
 "command": "npx",
 "args": ["-y", "@modelcontextprotocol/server-github"]
 },
 "postgres": {
 "command": "npx",
 "args": ["-y", "@modelcontextprotocol/server-postgres"],
 "env": { "DATABASE_URL": "postgresql://..." }
 }
 }
}

Comparativa con otras herramientas

Claude Code no es la única herramienta de desarrollo con IA. Como se posiciona frente a las alternativas:

Claude Code vs GitHub Copilot:

• Copilot: autocompletado inline en el editor. Excelente para sugerencias linea a linea.
• Claude Code: agente autonomo. Ejecuta tareas completas (crear un módulo, refactorizar, deployar).
• Son complementarios. Copilot para el día a día de escribir código, Claude Code para tareas grandes.

Claude Code vs Cursor:

• Cursor: editor (fork de VS Code) con IA integrada. Buena experiencia visual, chat + inline edits.
• Claude Code: terminal puro. Más potente para tareas de sistema (git, deploy, scripts, DBs), menos visual.
• Cursor es mejor si prefieres GUI. Claude Code si prefieres terminal y necesitas acceso completo al sistema.

Claude Code vs Windsurf (Codeium):

• Windsurf: similar a Cursor, editor con IA. Modelo "flows" (tareas multi-paso).
• Claude Code: más flexible, más herramientas (MCP), mejor para proyectos grandes y automatización.

Claude Code vs Aider:

• Aider: herramienta CLI open-source para pair programming con LLMs.
• Claude Code: más integrado (hooks, MCP, subagentes, memoria), pero requiere suscripcion Anthropic.
• Aider es buena alternativa gratuita si usas modelos open-weight.

Ejemplo de workflow real

Workflow real de desarrollo de un endpoint API con Claude Code:

# Sesion real (simplificada)

> claude "Crea un endpoint POST /api/v1/alerts que reciba
  alertas de seguridad, las valide contra el schema de MITRE ATT&CK,
  las persista en Supabase y envie notificacion a Slack si la
  severidad es critica."

# Claude Code hace (automaticamente):
# 1. Lee la estructura del proyecto (fastapi, supabase client, etc.)
# 2. Lee el schema existente de alertas
# 3. Crea el endpoint en routes/alerts.py
# 4. Crea el modelo Pydantic con validación MITRE
# 5. Anade la funcion de persistencia en Supabase
# 6. Anade el webhook de Slack para criticas
# 7. Crea tests unitarios
# 8. Ejecuta los tests
# 9. Corrige un error en el schema de validación
# 10. Re-ejecuta tests: todos pasan
# 11. Te muestra el resultado

# Tiempo total: ~3 minutos
# Sin Claude Code: 45-90 minutos

La clave no es solo que genera código. Es que ejecuta, verifica, corrige y completa. No te entrega un borrador: te entrega una feature funcional.

Precios y planes

Claude Code esta incluido en ciertos planes de Anthropic. No tiene precio separado:

Plan Max (100 USD/mes): incluye Claude Code con uso generoso. Para la mayoria de desarrolladores individuales es suficiente. Incluye el modelo Opus 4 (1M context) y Sonnet 4.6.

Plan Max (200 USD/mes): 5x más uso que el plan de 100. Para power users que usan Claude Code 8+ horas diarias.

Plan Team (30 USD/usuario/mes + uso): para equipos. Cada miembro tiene acceso a Claude Code. Administracion centralizada, SSO, permisos por equipo.

API (pago por uso): puedes usar Claude Code con tu propia API key. Pagas por tokens consumidos. Modelos: Sonnet 4.6 (~3 USD/M input, ~15 USD/M output), Opus 4 (~15 USD/M input, ~75 USD/M output). Para uso intensivo puede ser más caro que Max.

Recomendacion:

• Uso casual (1-2 horas/día): Plan Max 100 USD
• Uso intensivo (4-8 horas/día): Plan Max 200 USD
• Equipo de 3+: Plan Team
• Automatización/CI (sin interacción humana): API

Guía de inicio rápido

En 10 minutos puedes tener Claude Code funcionando en tu proyecto:

Paso 1: Instalar

npm install -g @anthropic-ai/claude-code
claude --version

Paso 2: Autenticarse

claude
# Sigue las instrucciones de autenticación OAuth

Paso 3: Crear CLAUDE.md básico

# En la raiz de tu proyecto, crea CLAUDE.md:

# Mi Proyecto

## Stack
- Backend: FastAPI + Python 3.11
- DB: PostgreSQL via Supabase
- Frontend: Next.js 14

## Reglas
- Tests obligatorios para cada feature nueva
- Conventional commits (feat:, fix:, docs:)
- Tipado estricto (no Any en Python, no any en TypeScript)

Paso 4: Primera tarea

claude "Explica la estructura de este proyecto y sugiere mejoras"

Paso 5: Primera tarea real

claude "Anade validación de email al formulario de registro"

A partir de aqui, itera. Anade más reglas a CLAUDE.md cuando Claude Code haga algo que no quieres. Configura hooks para automatizar tareas repetitivas. Conecta MCPs segun los necesites.

Preguntas frecuentes

Qué es Claude Code?

Claude Code es la herramienta de linea de comandos (CLI) oficial de Anthropic. Es un agente de desarrollo que trabaja en tu terminal: lee código, ejecuta comandos, modifica archivos y se conecta con herramientas externas via MCP.

Claude Code es gratis?

Claude Code requiere un plan de Anthropic que lo incluya (Max o Team). No tiene coste adicional sobre el plan, pero necesitas suscripcion activa. Plan Max desde 100 USD/mes con uso incluido, o API con pago por uso.

Qué diferencia hay entre Claude Code y ChatGPT?

ChatGPT es un chat web. Claude Code es un agente en tu terminal que puede leer archivos, ejecutar comandos, hacer commits, conectarse a bases de datos y operar de forma autonoma en tu proyecto.

Cómo se instala Claude Code?

Se instala con npm: 'npm install -g @anthropic-ai/claude-code'. Requiere Node.js instalado previamente. La primera vez pide autenticación con tu cuenta de Anthropic.

Qué es MCP en Claude Code?

MCP (Model Context Protocol) es un protocolo que permite a Claude Code conectarse con herramientas externas como GitHub, bases de datos, Slack y más. Hay 100+ servidores MCP disponibles.

Siguiente paso

Ya sabes que es Claude Code. El siguiente paso es instalarlo y crear tu primer workflow. En el Módulo 03 de IAcademy te guiamos paso a paso: instalación, configuración de .claude/, tu primer hook, tu primer agente y tu primer comando reutilizable.