Cómo usar Claude Code: el agente de codificación de Anthropic

Aprender a usar Claude Code empieza por entender qué es realmente: la herramienta de codificación de agente de Anthropic, que se ejecuta en tu terminal, lee tu código base completo y ejecuta tareas de desarrollo a partir de instrucciones en lenguaje natural^[1]. Desde que estuvo disponible, ha acumulado 101.000 estrellas en GitHub y 15.500 bifurcaciones, lo que lo convierte en una de las herramientas de codificación con IA más adoptadas de 2026^[2].

La diferencia estructural con respecto a las herramientas anteriores vale la pena aclarar, porque determina si el flujo de trabajo te conviene. El autocompletado al estilo Copilot sugiere la siguiente línea basándose en lo que ya escribiste. Claude Code lee el proyecto completo, planifica un enfoque, edita en muchos archivos a la vez, ejecuta las pruebas, maneja los fallos, itera y confirma. No tienes que decirle qué archivos importan.

Esta guía cubre qué hace, dónde se ejecuta, cómo instalarlo, cinco trabajos en los que destaca especialmente, cómo se compara con Cursor y Copilot, y qué hacer cuando quieres ese comportamiento dentro de tu propio producto en lugar de en un terminal.

TL;DR

• Ventana de contexto de 1M tokens, aproximadamente 25.000 a 30.000 líneas de código en una sesión sin fragmentación^[1].
• 80,8% en SWE-bench Verified, la puntuación más alta reportada públicamente entre herramientas disponibles en el momento de escritura^[1].
• Plan Mode muestra el plan archivo por archivo antes de tocar nada, lo que hace que la operación autónoma sea aceptable en un repositorio de producción^[1].
• Se ejecuta en casi cualquier lugar: CLI terminal, VS Code, Cursor, Windsurf, JetBrains, app de escritorio, web y @claude en una incidencia de GitHub^[1].
• El acceso requiere una suscripción Claude Pro o Max, o una cuenta Claude Console con acceso API^[1].
• Compatibilidad MCP lo conecta a bases de datos, APIs internas, ticketing y observabilidad, para que razone sobre más allá del repositorio^[1].

Qué es Claude Code

Claude Code es un agente de codificación en lugar de un motor de completación. Señálalo a un proyecto y navega la estructura como lo haría un desarrollador sénior: comienza en los puntos de entrada, sigue el gráfico de dependencias, construye un modelo funcional de cómo interactúan los componentes, luego realiza cambios coherentes a nivel arquitectónico en lugar de localmente correctos y globalmente rotos.

Esa distinción importa más en las tareas que realmente consumen el tiempo de ingeniería. Depurar un problema de producción que se comporta diferente en ensayo. Implementar una función que necesita un cambio de ORM, tres actualizaciones de endpoint y una migración. Estos son problemas multi-archivo, y los problemas multi-archivo son donde un agente de contexto completo se separa del autocompletado.

Las capacidades que importan

Una ventana de contexto de 1M tokens

Claude Code lee hasta un millón de tokens en una ventana de contexto, aproximadamente 25.000 a 30.000 líneas de código en una sesión sin chunking o augmentación de recuperación^[1]. Cuando una refactorización toca 40 archivos en una base de código de 200.000 líneas, no tienes que pasarle una lista de archivos. Los encuentra por sí mismo.

80,8% en SWE-bench Verified

SWE-bench Verified evalúa un modelo contra problemas reales de GitHub de repositorios de código abierto, puntuado por si la corrección propuesta pasa la suite de pruebas del propio repositorio. Claude Code alcanza 80,8%, la cifra más alta reportada públicamente entre herramientas disponibles^[1]. El benchmark mide una comprensión genuina del código base en lugar de coincidencia de patrones en fragmentos aislados, por lo que se puede depender de él como una medida de usabilidad real mejor que la mayoría de las evaluaciones de codificación.

Plan Mode

Antes de ejecutar nada, Claude Code presenta un plan estructurado: qué archivos modificará, qué cambios hará, en qué orden. Lo revisas, lo cuestionas, lo ajustas y solo entonces apruebas^[1].

Esta es la función que hace el resto usable en un repositorio de producción. La autonomía supervisada mantiene al desarrollador en el bucle en el momento en que estar fuera del bucle es costoso.

Equipos de agentes

Múltiples instancias de Claude Code trabajan en diferentes partes de un problema simultáneamente, coordinadas por un agente líder que asigna subtareas y fusiona resultados^[1]. Para una función que se descompone en streams de trabajo independientes, un cambio backend, una actualización frontend y una actualización de documentos ejecutándose en paralelo, esto comprime tiempo de calendario en lugar de solo tiempo de token.

Dónde se ejecuta Claude Code

La adopción generalizada tiene una explicación aburrida: cumple a los desarrolladores donde ya están^[1].

• CLI terminal es la experiencia central. Navega al proyecto, ejecuta claude, describe la tarea.
• Extensión de VS Code, con revisión de diff visual y selección de cambios interactiva. La misma extensión funciona en Cursor y Windsurf.
• Plugin JetBrains cubre IntelliJ IDEA, PyCharm, WebStorm y el resto.
• App de escritorio añade revisión de diff visual en sesiones paralelas, programación de sesiones y ejecución en la nube para trabajos de larga duración.
• Web en claude.ai/code, sin instalación local, plus la app Claude iOS.
• GitHub: etiqueta @claude en una incidencia y recibe una solicitud de extracción de vuelta, sin pedirle a los compañeros de equipo que cambien cómo trabajan.

Cómo usar Claude Code: instalación y primera ejecución

macOS y Linux:

curl -fsSL https://claude.ai/install.sh | bash

O con Homebrew:

brew install --cask claude-code

Windows:

irm https://claude.ai/install.ps1 | iex

O con WinGet:

winget install Anthropic.ClaudeCode

Luego navega a tu proyecto y ejecuta claude. Indexa la estructura del proyecto y pregunta qué quieres hacer.

Un paso importa más que el método de instalación. Crea un CLAUDE.md en la raíz del repositorio y pon tus convenciones en él: qué framework de pruebas usas, qué archivos nunca deben modificarse automáticamente, cómo nombras las cosas^[1]. Se lee al inicio de cada sesión. Los equipos lo usan para codificar el conocimiento institucional que un desarrollador sénior de otro modo transmitiría durante la incorporación, y es la configuración de mayor influencia en la herramienta.

Cinco trabajos en los que destaca especialmente

Refactorización de base de código grande. Cuando una refactorización toca docenas de archivos y necesita cambios consistentes en firmas, importaciones y pruebas a la vez, la coordinación es la parte difícil. Claude Code construye un mapa de dependencias, encuentra cada sitio de llamada, realiza cambios coordinados y ejecuta la suite antes de mostrarte el resultado. El equipo de Rakuten documentó su funcionamiento autónomo durante siete horas en un método de extracción de vector de activación dentro de una gran biblioteca multilingüe, produciendo una precisión numérica del 99,9% contra la implementación de referencia^[1].

Depuración entre archivos. Cuando un error se muestra en el comportamiento del usuario pero se origina en la interacción entre tres módulos escritos por diferentes personas en diferentes momentos, la navegación de contexto completo le permite seguir la ruta de ejecución, formular hipótesis de modos de fallo, escribir diagnósticos y solucionar todos los lugares donde se hace la suposición rota en lugar de solo el más obvio.

Generación de pruebas para código no probado. Lee la implementación, deduce el comportamiento deseado de la código y de cualquier documento que exista, y genera pruebas que cubren rutas normales, casos extremos y condiciones de error. Tiende a encontrar bugs mientras lo hace.

Automatización del flujo de trabajo Git. Describe el commit en lenguaje plano, incluido qué dejar fuera, y maneja el ensayado, el mensaje del commit, el empuje y una solicitud de extracción con una descripción estructurada. Con la integración MCP de GitHub puede leer problemas abiertos, implementar correcciones, ejecutar pruebas y abrir el PR con contexto completo.

Análisis de arquitectura. Señala una base de código desconocida y pídele que explique la arquitectura. Obtienes un recorrido estructurado de la organización, cada componente principal, el flujo de datos entre servicios y las rutas críticas. Útil para incorporación, diligencia debida técnica y escribir la documentación que nadie escribió.

Integración MCP

Claude Code admite el Protocolo de Contexto del Modelo, el estándar abierto de Anthropic para conectar modelos a herramientas y datos externos^[1]. Eso extiende su razonamiento más allá del repositorio: consulta la base de datos de producción para entender el modelo de datos antes de escribir una migración, lee la incidencia para entender los criterios de aceptación antes de implementar, revisa la plataforma de observabilidad para patrones de error antes de depurar.

El directorio de plugins lleva una creciente biblioteca de integraciones comunitarias, así que la mayoría de herramientas comunes ya están cubiertas.

Claude Code, Cursor o Copilot

La fuente de las filas de comparación es la misma guía referenciada en todo^[1].

La lectura honesta es que estos no están realmente compitiendo por los mismos minutos. Cursor es una bifurcación de VS Code con IA integrada en todo el editor: completación en línea rápida, soporte multi-modelo, IDE visual. Copilot es el más ampliamente desplegado porque se envía dentro de las suscripciones Microsoft empresariales, y maneja la completación rutinaria bien sin operar como un agente completo en trabajo complejo multi-archivo.

La mayoría de los desarrolladores que usan ambos usan Cursor para edición diaria y Claude Code para tareas que necesitan comprensión profunda del código base: refactorizaciones grandes, cambios de arquitectura, auditorías de seguridad, bugs sutiles entre archivos.

Cuando quieres este comportamiento dentro de tu propio producto

Claude Code es el agente de Anthropic, y es la herramienta correcta cuando el trabajo ocurre en tu terminal. Es la forma incorrecta para un trabajo diferente: poner el mismo comportamiento dentro del software que envías. Un bot de revisión de código en tu CI, un agente de migración para tus clientes, una herramienta interna que lee un repositorio y responde preguntas sobre él. Ninguno de esos es un CLI en el portátil de un desarrollador.

Ese trabajo necesita los modelos directamente. El acceso a Claude Code mismo se ejecuta a través de una suscripción Claude Pro o Max, o una cuenta Claude Console con acceso API^[1], y cuando construyes tu propio agente estás trabajando en esa segunda capa.

reAPI expone los modelos Claude a través de un endpoint /v1/chat/completions compatible con OpenAI, así que un cliente y una clave cubren Claude junto a GPT y Gemini:

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_REAPI_KEY",
    base_url="https://api.reapi.ai/v1",
)

resp = client.chat.completions.create(
    model="claude-opus-5",
    messages=[{"role": "user", "content": "Review this diff and report issues with severity."}],
    max_tokens=16000,
    stream=True,
)

La superficie nativa de Anthropic /v1/messages también está disponible, así que los SDKs escritos para cualquier formato funcionan sin cambios. Las páginas de modelo y tarifas están en reapi.ai/models, y la referencia de endpoint para la generación Opus actual está en reapi.ai/docs/claude-opus-5.

Usa Claude Code para tu propio repositorio. Usa la API cuando el agente tiene que ejecutarse en el de alguien más.

FAQ

¿Qué modelo impulsa Claude Code?

Se ejecuta en los modelos Claude frontera actuales de Anthropic, y el predeterminado rastrea lo que Anthropic ha enviado más recientemente en lugar de permanecer fijo en una versión. Consulta la documentación de Anthropic para el modelo detrás de tu plan en cualquier momento.

¿Es Claude Code gratis?

No. Requiere una suscripción Claude Pro o Max, con precio entre $20 y $100 por mes, o una cuenta Claude Console con acceso API^[1].

¿Qué tan grande de una base de código puede manejar Claude Code?

La ventana de contexto es 1M tokens, aproximadamente 25.000 a 30.000 líneas en una sesión sin fragmentación^[1]. Los repositorios más grandes aún funcionan, porque navega el gráfico de dependencias en lugar de cargar todo a la vez.

¿Para qué sirve CLAUDE.md?

Instrucciones permanentes por proyecto leídas al inicio de cada sesión: convenciones de codificación, framework de pruebas, archivos que nunca deben modificarse automáticamente. Es donde los equipos codifican el conocimiento de incorporación^[1].

¿Es Claude Code mejor que Cursor?

Resuelven diferentes problemas. Cursor es una experiencia IDE completa con edición en línea rápida; Claude Code es un agente terminal con una ventana de contexto mucho más grande y operación plan-ejecuta-prueba-confirma completa. Muchos desarrolladores ejecutan ambos^[1].

¿Puede Claude Code abrir solicitudes de extracción?

Sí. Se integra directamente con git, y etiquetar @claude en una incidencia de GitHub devuelve una solicitud de extracción. Con la integración MCP de GitHub puede leer la incidencia, implementar, probar y enviar con contexto completo^[1].

¿Qué es Plan Mode?

Una puerta de revisión. Claude Code presenta el plan archivo por archivo antes de hacer cambios y espera aprobación^[1].

¿Cómo construyo mi propio agente de codificación?

Llama a los modelos a través de una API en lugar de la CLI. Señala un cliente compatible con OpenAI a https://api.reapi.ai/v1 y establece la cadena de modelo, o usa la superficie nativa /v1/messages de Anthropic.

Elegir la capa correcta

Claude Code gana su adopción en una propiedad: sostiene un proyecto completo en vista y actúa sobre él, en lugar de adivinar la siguiente línea. La ventana de millón de token, la puntuación 80,8% SWE-bench y Plan Mode son tres expresiones de la misma decisión de diseño, y caen más fuerte en refactorizaciones, depuración entre archivos y bases de código desconocidas.

Sabe en qué capa vive tu problema. Si el trabajo está en tu repositorio y terminal, instálalo y escribe un buen CLAUDE.md antes que cualquier otra cosa. Si el trabajo está dentro de un producto que envías a otras personas, quieres la API del modelo debajo, no la CLI arriba. Aprender a usar Claude Code bien significa principalmente reconocer cuál de esos dos en realidad estás haciendo.

Referencias

1. Anthropic. Claude Code — overview, capabilities, surfaces, and configuration. Consultado en julio de 2026 de platform.claude.com/docs/claude-code
2. Anthropic. Claude Code — official repository. Consultado en julio de 2026 de github.com/anthropics/claude-code
3. Anthropic. Claude Code documentation. Consultado en julio de 2026 de docs.claude.com/en/docs/claude-code/overview

Lecturas adicionales

• reAPI. How to use Claude Opus 5. reapi.ai/blog/how-to-use-claude-opus-5
• reAPI. How to use Claude Fable 5. reapi.ai/blog/how-to-use-claude-fable-5
• reAPI. Model catalog. reapi.ai/models