Qué es Claude Code y cómo usarlo para programar con IA

Publicado el 3 de junio de 2026 · 13 min de lectura · Blog MasterEnClaude

Claude Code es el agente de programación en terminal de Anthropic. No es simplemente un asistente de chat que sugiere código: es un agente autónomo que puede leer tu base de código completa, editar ficheros, ejecutar comandos, correr tests y llevar a cabo tareas de programación de principio a fin, todo desde la línea de comandos de tu máquina.

Si has probado GitHub Copilot o ChatGPT para programar, Claude Code es un salto cualitativo diferente: en lugar de completar líneas o responder preguntas, puede tomar un objetivo en lenguaje natural y trabajar de forma autónoma hasta conseguirlo, pidiendo confirmación solo cuando hay acciones irreversibles.

¿Cómo funciona Claude Code internamente?

Claude Code es un agente construido sobre la API de Anthropic. En cada turno, Claude recibe el contexto de la conversación más una serie de tools integradas que le permiten interactuar con tu sistema:

• Read/Write de ficheros: puede leer cualquier fichero de tu proyecto y editar su contenido.
• Bash: puede ejecutar comandos de terminal (con tu permiso).
• Grep/Search: puede buscar patrones en el código de forma eficiente.
• Web fetch: puede consultar URLs y leer documentación en línea.
• Servidores MCP: puede conectarse a cualquier servidor MCP que tengas configurado.

El agente decide qué herramientas usar, en qué orden, y va refinando su trabajo en función de los resultados que obtiene. Es un bucle de razonamiento → acción → observación que continúa hasta completar la tarea.

Instalación en macOS, Linux y Windows

Claude Code se instala como un paquete npm global. Necesitas Node.js 18 o superior:

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

# Verifica la instalación
claude --version

# Configura tu API key (si no está ya en el entorno)
export ANTHROPIC_API_KEY="sk-ant-api03-XXXXXXXXXX"

Una vez instalado, navega a la carpeta de tu proyecto y ejecuta simplemente claude para abrir la sesión interactiva. Claude Code leerá automáticamente los ficheros relevantes de tu proyecto al inicio de la conversación.

El fichero CLAUDE.md: instrucciones para tu agente

Una de las características más potentes de Claude Code es el fichero CLAUDE.md. Cuando Claude Code arranca en un directorio, busca este fichero y carga su contenido como contexto persistente. Es como el system prompt de tu agente, pero versionado junto a tu código.

Un buen CLAUDE.md incluye:

# Mi Proyecto — Contexto para Claude Code

## Arquitectura
- Backend: FastAPI (Python 3.11)
- Base de datos: PostgreSQL 15 con SQLAlchemy
- Frontend: React 18 + TypeScript
- Deploy: Railway (backend) + Vercel (frontend)

## Convenciones de código
- Nombres de variables en snake_case (Python) y camelCase (TypeScript)
- Siempre añadir type hints en Python
- Los tests van en /tests con el prefijo test_
- Nunca hacer commits directamente a main

## Comandos frecuentes
- `make dev` — levanta el entorno de desarrollo
- `make test` — ejecuta la suite de tests
- `make lint` — flake8 + mypy

## Lo que NO debe hacer Claude
- Modificar ficheros de migraciones directamente
- Cambiar variables de entorno en producción
- Instalar dependencias sin preguntar

Con un CLAUDE.md bien escrito, puedes arrancar Claude Code en cualquier máquina o en cualquier contexto y el agente entenderá de inmediato las reglas del juego de tu proyecto.

Hooks: automatización en puntos clave del flujo

Claude Code soporta hooks: scripts o comandos que se ejecutan automáticamente en momentos concretos del flujo del agente. Se configuran en el fichero .claude/settings.json de tu proyecto (o en el settings global del usuario):

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "echo 'Comando bash a ejecutar: $CLAUDE_TOOL_INPUT'"
          }
        ]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Write",
        "hooks": [
          {
            "type": "command",
            "command": "prettier --write $CLAUDE_TOOL_OUTPUT_PATH 2>/dev/null || true"
          }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"Claude Code ha terminado\" with title \"Claude Code\"'"
          }
        ]
      }
    ]
  }
}

En este ejemplo: el hook PostToolUse sobre Write ejecuta Prettier cada vez que Claude escribe un fichero, garantizando el formato correcto automáticamente. El hook Stop envía una notificación del sistema cuando el agente termina su tarea.

Subagentes: Claude Code orquestando Claude Code

Una de las capacidades más avanzadas es la posibilidad de lanzar subagentes: instancias de Claude Code que trabajan en paralelo sobre subtareas específicas, coordinadas por un agente orquestador. Esto permite dividir proyectos grandes en partes independientes y procesarlas simultáneamente.

Desde el código Python, puedes usar el SDK de Anthropic para implementar este patrón:

import anthropic
import subprocess
import json

def lanzar_subagente(tarea: str, directorio: str) -> str:
    """Lanza una instancia de Claude Code en modo no interactivo."""
    resultado = subprocess.run(
        ["claude", "--print", "--no-markdown", tarea],
        capture_output=True,
        text=True,
        cwd=directorio
    )
    return resultado.stdout

# Ejemplo: analizar dos módulos en paralelo
import concurrent.futures

tareas = [
    ("Revisa el módulo /src/auth.py y lista todos los posibles bugs de seguridad", "/mi-proyecto"),
    ("Revisa el módulo /src/payments.py y lista todos los posibles bugs de seguridad", "/mi-proyecto"),
]

with concurrent.futures.ThreadPoolExecutor(max_workers=2) as executor:
    futuros = [executor.submit(lanzar_subagente, tarea, directorio) for tarea, directorio in tareas]
    resultados = [f.result() for f in futuros]

for i, resultado in enumerate(resultados):
    print(f"--- Subagente {i+1} ---")
    print(resultado)

Integración con MCP: Claude Code con superpoderes

Claude Code soporta de forma nativa el Model Context Protocol (MCP). Puedes registrar servidores MCP que le dan a Claude Code acceso a sistemas externos: tu base de datos de producción en modo solo lectura, la API de GitHub para gestionar issues, Slack para notificar avances, o cualquier herramienta que tu equipo use.

# Registrar un servidor MCP en Claude Code
claude mcp add mi-servidor-github npx @modelcontextprotocol/server-github

# Listar los servidores MCP configurados
claude mcp list

# Usar Claude Code con acceso a GitHub
claude "Lista los últimos 5 issues abiertos del repo y propón un plan de priorización"

Para entender MCP en profundidad, lee nuestro artículo dedicado: ¿Qué es MCP (Model Context Protocol)? Guía en español.

Modo no interactivo y automatización en CI/CD

Claude Code no es solo para uso interactivo. Con el flag --print puedes usarlo en scripts y pipelines de CI/CD:

# Revisar un PR automáticamente
claude --print "Revisa el diff adjunto y devuelve una lista de posibles bugs" \
  --context "$(git diff main...HEAD)"

# Generar changelog automático
claude --print "Genera un CHANGELOG.md basado en los commits de esta semana" \
  --context "$(git log --since='1 week ago' --oneline)"

Cuándo usar Claude Code vs. la interfaz web de Claude

• Usa claude.ai (web): para conversaciones generales, preguntas puntuales, redacción, análisis de documentos.
• Usa Claude Code: cuando necesitas que el agente actúe sobre tu base de código, ejecute comandos, refactorice módulos, escriba tests o automatice cualquier flujo que requiera acceso al sistema de ficheros y la terminal.

La combinación más potente es usar la API de Claude para tus aplicaciones propias y Claude Code para tu flujo de desarrollo personal. Así tienes IA tanto en el producto que construyes como en el proceso de construcción.

Primeros pasos recomendados

1. Instala Claude Code con npm install -g @anthropic-ai/claude-code.
2. Crea un CLAUDE.md en tu proyecto más importante.
3. Prueba una tarea real: "Añade tests unitarios para el módulo X" o "Refactoriza esta función para que sea más legible".
4. Configura al menos un hook (el de notificación al terminar es muy útil para tareas largas).
5. Explora los servidores MCP disponibles para conectar Claude Code a tus herramientas.