Claude Code lidera SWE-bench con 80.8% — el mejor resultado de un agente de IA resolviendo issues reales de ingeniería de software en 2026. No es un autocomplete ni un plugin de IDE: es un programador autónomo que lee tu proyecto completo, planifica los cambios, escribe el código, ejecuta tests y corrige errores en cadena.
A diferencia de Cursor o GitHub Copilot, que operan dentro de un editor y sugieren código línea a línea, Claude Code se ejecuta en terminal y tiene acceso al contexto completo del repositorio. Puede leer 1 millón de tokens de código — el equivalente a varios proyectos medianos completos — antes de tocar un solo archivo.
Esta guía cubre todo lo necesario para empezar: instalación, comandos esenciales, el archivo CLAUDE.md que cambia cómo trabaja el agente, y flujos de trabajo reales para proyectos en producción. Para entender qué es Claude AI en general antes de entrar en Claude Code, la guía de qué es Claude AI cubre la plataforma completa.
¿Qué es Claude Code y para qué sirve?
Claude Code es el agente de codificación de Anthropic. Lanzado en 2025 y consolidado como estándar en 2026, funciona en terminal y puede:
- Leer proyectos enteros con hasta 1 millón de tokens de contexto
- Planificar cambios complejos antes de ejecutarlos
- Escribir código, ejecutar comandos de terminal y correr tests de forma autónoma
- Detectar y corregir errores en cadena sin intervención manual entre pasos
- Integrarse con Git para leer diffs, crear commits y revisar el historial
Lo usan principalmente desarrolladores backend, fullstack y DevOps para tareas que requieren entender la arquitectura completa antes de hacer un cambio: refactorizaciones, corrección de bugs en codebases grandes, migración de dependencias y revisión de código a nivel de repositorio.
La extensión oficial para VS Code y JetBrains, disponible desde 2026, permite usar Claude Code sin salir del editor. Para una comparativa directa con el ecosistema de Cursor y Windsurf, el artículo de Windsurf vs Cursor entra en ese detalle.
Requisitos para usar Claude Code
| Requisito | Detalle |
|---|---|
| Sistema operativo | macOS, Linux, Windows (con WSL2) |
| Node.js | Versión 18 o superior |
| Cuenta Anthropic | Claude Pro ($20/mes), Max, Teams o Enterprise |
| Alternativa sin suscripción | API key directa (pay-as-you-go por tokens) |
| Recomendado | Git + Ripgrep (mejora velocidad de búsqueda en proyectos grandes) |
En Windows, Claude Code requiere WSL2 (Windows Subsystem for Linux) para el terminal. La extensión de VS Code sí funciona en Windows nativo.
Cómo instalar Claude Code paso a paso
Paso 1 — Instalar con npm:
npm install -g @anthropic-ai/claude-code
Paso 2 — Verificar instalación:
claude --version
Si devuelve un número de versión, la instalación fue correcta.
Paso 3 — Autenticarse con tu cuenta Anthropic:
claude
Al ejecutarlo por primera vez, abre el navegador para autenticarse con tu cuenta de Claude.ai. Necesitas un plan Pro, Max, Teams o Enterprise activo, o una API key con crédito disponible.
Paso 4 — Abrir Claude Code dentro de tu proyecto:
cd mi-proyecto
claude
Desde ese momento Claude Code tiene acceso a todos los archivos del directorio y subdirectorios.
Comandos esenciales de Claude Code
| Comando | Para qué sirve |
|---|---|
claude | Iniciar sesión interactiva en el directorio actual |
claude -c | Retomar la última conversación sin abrir una nueva |
claude -p "tarea" | Ejecutar una tarea directa sin modo interactivo |
/plan | Activar Plan Mode — Claude planifica antes de actuar |
/clear | Limpiar el contexto de la sesión actual |
/help | Ver todos los comandos y atajos disponibles |
.claudeignore | Archivo para excluir rutas sensibles del contexto |
El comando más infravalorado es claude -c: retoma la sesión anterior con todo el contexto. Evita que Claude tenga que re-leer el proyecto desde cero cuando vuelves a trabajar en la misma tarea horas después.
El archivo .claudeignore funciona igual que .gitignore: define qué rutas debe ignorar Claude Code. Úsalo para excluir .env, carpetas de credenciales, logs pesados o cualquier archivo que no quieras que el agente lea.
El archivo CLAUDE.md — el elemento más importante
CLAUDE.md es el archivo de configuración que Claude Code lee automáticamente al iniciar cada sesión. Sin él, el agente trabaja sin contexto del proyecto y tiene que deducir el stack, las convenciones y las restricciones en cada conversación nueva.
Con un buen CLAUDE.md, Claude Code sabe desde el primer mensaje qué puede tocar, cómo está organizado el proyecto y qué patrones seguir.
Ejemplo de CLAUDE.md básico:
# Mi Proyecto
## Stack
- Frontend: Astro 4 + Tailwind CSS
- Backend: Firebase (Firestore + Hosting)
- Lenguaje: TypeScript
## Convenciones de código
- Nombres de archivos en kebab-case
- Componentes en PascalCase
- Variables y funciones en camelCase
- Tests con Vitest
## Estructura de carpetas clave
- src/content/blog/ — artículos en markdown
- src/components/ — componentes Astro reutilizables
- public/images/ — imágenes estáticas
## Restricciones
- No modificar archivos en /config/secrets/
- No tocar variables de entorno (.env)
- No crear archivos de configuración sin preguntar antes
Crea el CLAUDE.md en la raíz del proyecto antes de empezar cualquier sesión. Es el primer paso, no el último.
Comparativa — Claude Code vs alternativas
| Herramienta | Tipo | Precio | Contexto | Mejor para |
|---|---|---|---|---|
| Claude Code | Terminal + extensión IDE | Desde $20/mes | 1M tokens | Proyectos complejos, refactorizaciones grandes |
| Cursor | IDE propio (fork VS Code) | Desde $20/mes | ~200K tokens | Usuarios que prefieren GUI, equipos mixtos |
| GitHub Copilot | Plugin IDE | Desde $10/mes | Limitado | Autocompletado rápido, ecosistema GitHub |
| Windsurf | IDE propio | Gratis / $15/mes | 128K tokens | Principiantes en IA coding, presupuesto ajustado |
La diferencia principal no es de precio sino de profundidad de contexto y autonomía. Claude Code puede leer la arquitectura completa de un proyecto y tomar decisiones coherentes con ella; las otras herramientas trabajan principalmente con el archivo o los archivos abiertos. Para la comparativa directa de Claude con el plugin de Microsoft, el artículo de Claude vs Copilot entra en ese detalle.
Flujos de trabajo reales con Claude Code
Ejemplo 1 — Corregir un bug con contexto de error:
Tengo este error en consola al ejecutar npm run build:
[Error: Cannot read properties of undefined (reading 'slug')]
at BlogPost.getStaticPaths (src/pages/blog/[slug].astro:12)
Encuéntralo y corrígelo sin tocar otros archivos.
Claude Code lee el archivo, localiza el problema, propone la corrección y la aplica. No tienes que indicarle la línea exacta.
Ejemplo 2 — Añadir funcionalidad siguiendo el patrón existente:
Añade validación de email al formulario de registro
en src/components/ContactForm.astro.
Sigue el mismo patrón que usa el formulario de
suscripción en src/components/Newsletter.astro.
Al tener acceso a ambos archivos, Claude entiende las convenciones del proyecto antes de escribir una línea.
Ejemplo 3 — Entender un proyecto desconocido:
Lee el proyecto completo y explícame:
1. La arquitectura general y qué hace cada carpeta principal
2. El flujo de datos desde una petición HTTP hasta la respuesta
3. Las decisiones técnicas que parecen no obvias
No toques ningún archivo.
Útil cuando aterrizas en un repositorio nuevo o cuando retomas un proyecto después de meses. Claude Code lee todo y genera una explicación estructurada antes de actuar.
Integración con VS Code y JetBrains
La extensión oficial de Claude Code para VS Code y JetBrains, disponible desde 2026, permite usar el agente sin abrir una terminal separada.
Instalación en VS Code:
- Abre VS Code y ve al panel de extensiones (
Ctrl+Shift+X) - Busca “Claude Code” (publicada por Anthropic)
- Instala y recarga VS Code
- Autentícate con tu cuenta de Claude.ai desde el panel lateral
La extensión sincroniza el contexto con el workspace abierto: no tienes que navegar hasta la carpeta del proyecto, el agente ya sabe dónde está. Funciona en paralelo con la sesión de terminal — los cambios hechos desde la extensión son visibles inmediatamente en el terminal y viceversa.
Consejos para sacarle el máximo partido
-
Crea el CLAUDE.md antes de empezar. Es lo primero. Sin él, el agente dedica tokens en cada sesión a inferir lo que ya deberías haberle dicho.
-
Sé específico con el contexto: nombre de archivo y línea cuando sea posible. “El error está en la función
formatDateensrc/utils/dates.tslínea 34” es diez veces más eficiente que “hay un error en las fechas”. -
Usa
/planpara tareas grandes antes de ejecutar. Plan Mode hace que Claude describa lo que va a hacer antes de tocar un archivo. Revisa el plan, corrígelo si necesitas, y solo entonces aprueba la ejecución. -
Protege archivos sensibles con
.claudeignore. Añade.env, carpetas de credenciales, secretos de CI/CD y cualquier archivo que no debe salir del contexto local. -
Usa
claude -cpara retomar sesiones. Retomar una sesión existente es más eficiente que abrir una nueva: el agente ya tiene el contexto del proyecto indexado y puede continuar sin re-leer todo.
¿Cuánto cuesta Claude Code?
| Plan | Precio | Uso de Claude Code |
|---|---|---|
| Claude Pro | $20/mes | Incluido con uso razonable |
| Claude Max | $100/mes | Límite ampliado para uso intensivo |
| Claude Teams | $30/usuario/mes | SSO + gestión de equipo + uso razonable |
| Claude Enterprise | Precio personalizado | Residencia de datos + compliance + SLA |
| API key directa | Pay-as-you-go | Sin suscripción, pagas por tokens consumidos |
Para proyectos personales y uso moderado, Claude Pro ($20/mes) es suficiente. Para equipos de desarrollo que usan Claude Code durante horas cada día en codebases grandes, Claude Max elimina los límites que el Pro puede alcanzar en sesiones largas.
La API key directa es útil para integrar Claude Code en scripts de CI/CD o automatizaciones sin atar la facturación a una suscripción mensual. Para entender todos los planes de Claude en detalle, la guía de cómo usar Claude cubre la plataforma completa con comparativa de planes actualizada.
Conclusión
Claude Code es la herramienta de programación con IA más potente de 2026 para proyectos complejos. La curva de aprendizaje no está en la herramienta — está en crear buenos hábitos desde el primer día: el CLAUDE.md, el .claudeignore, el contexto específico en cada instrucción y el Plan Mode para cambios grandes.
Por dónde empezar esta semana:
- Instala Claude Code con
npm install -g @anthropic-ai/claude-code - Crea el CLAUDE.md en tu proyecto actual antes de abrir la primera sesión
- Prueba el flujo completo:
cd mi-proyecto && claude, haz una tarea real y revisa el resultado
El primer bug corregido de forma autónoma — sin que hayas señalado la línea exacta — es el momento en el que Claude Code cambia cómo trabajas.
