Claude Code es un agente de codificación que vive en tu terminal. Le dices qué quieres, él lee tu proyecto entero, edita archivos, ejecuta comandos, gestiona git y te devuelve el resultado. Tú revisas. Así de simple.
No es un chatbot. No es un autocompletado. No es un IDE. Es un proceso de terminal que entiende tu codebase completo — no solo el archivo abierto — y actúa sobre él.
Lo uso más de doce horas al día, todos los días, en una compañía de desarrollo de software profesional donde somos cientos de ingenieros. No para experimentar. Para entregar software en producción con specs, tests y deploys reales. Y lo llevo haciendo más de un año.
La mayoría de artículos que he leído sobre Claude Code los escribe gente que no lo usa profesionalmente en escenarios de alto riesgo. Y está bien — pero hay una diferencia sutil entre romper un deploy personal y romper un pipeline que cuesta miles de euros, con stakeholders reales, con clientes reales, con dinero real.
Este artículo lo escribe alguien con skin in the game.
Qué NO es Claude Code
La primera confusión que veo en gente que descubre Claude Code: confundirlo con Claude Desktop o con Claude.ai.
Claude.ai es la interfaz web donde chateas con Claude. Puedes pedirle que te ayude con código, pero no tiene acceso a tu proyecto, no edita archivos, no ejecuta comandos.
Claude Desktop es la aplicación de escritorio de Anthropic. Tiene varias pestañas: Chat, Cowork y Code. El tab de Code es una interfaz gráfica que ejecuta el mismo motor que Claude Code — con diffs visuales, sesiones paralelas, preview de tu app y conectores gráficos. Para quienes no son developers o prefieren interfaz gráfica, es un punto de entrada excelente. Tengo un tip dedicado a las 5 funciones exclusivas de Desktop.
Claude Code es el agente de terminal. Sin capas intermedias. Tú, el modelo, tu sistema de archivos. Es la fuente de origen del artefacto que es el código. Si ya usas un editor como Zed o Neovim y vives en el terminal, es la opción natural.
La diferencia de fondo — agente autónomo vs IDE asistido — la explico en profundidad en la comparativa Claude Code vs Cursor.
Qué puede hacer (con ejemplos reales)
Prácticamente lo que quieras. Con un buen prompt llegarás bastante lejos. Pero en el mundo profesional, donde yo puedo hablar, se utilizan especificaciones.
Cuando combinas la potencia de un modelo frontier como Claude Opus con un buen sistema de specs alineado con la realidad del proyecto, features que llevaban semanas se completan en horas manteniendo la calidad. Pero es un proceso continuo — no magia.
Capacidades concretas:
- Leer y entender código — analiza proyectos enteros, no solo archivos sueltos
- Editar múltiples archivos — refactoring cross-file con contexto completo
- Ejecutar comandos — build, test, lint, lo que necesites
- Gestionar git — commits, branches, PRs, resolución de conflictos, todo en lenguaje natural
- Escribir y ejecutar tests — genera tests unitarios y los corre
- Debugging — encuentra y corrige bugs que cruzan múltiples archivos
- Documentación — genera y actualiza docs
- Code review — revisa cambios y sugiere mejoras
La clave no es la lista de capacidades — cualquier artículo te da esa lista. La clave es que todo esto ocurre dentro de un proceso spec-driven donde cada paso es trazable. Frameworks como OpenSpec o metodologías como CRAFT existen exactamente para esto.
Dónde vive: 7 vías de acceso
Esto es algo que ningún otro artículo presenta completo. Claude Code no es solo "un terminal." Son 7 formas de acceso al mismo motor:
| Vía | Qué es | Para quién |
|---|---|---|
| Terminal (CLI) | La experiencia principal. claude en tu terminal |
Developers terminal-first |
| IDE extensions | Extensiones nativas para VS Code y JetBrains | Developers que prefieren IDE |
| ACP (Agent Client Protocol) | Estándar abierto de Zed Industries. Claude Code como agente first-class en Zed y JetBrains vía el ACP Registry | Usuarios de Zed o editores ACP-compatible |
| Claude Desktop (Code tab) | App gráfica con diff visual, sesiones paralelas, preview de app y conectores | PMs, perfiles no-terminal, onboarding |
| Web (claude.ai/code) | Sesiones persistentes en la nube | Cuando no tienes tu máquina |
| GitHub (@claude) | Menciona @claude en issues o PRs | Code review y automatización CI |
| Móvil | Dispatch, Remote Control, Channels (Telegram, Discord, iMessage) | Lanzar o monitorizar tareas desde el teléfono |
ACP merece mención especial: es como LSP (Language Server Protocol) pero para agentes AI. Zed lo creó como estándar abierto y JetBrains lo adoptó con su ACP Registry. Claude Code es uno de los agentes soportados. Esto significa que puedes usar Claude Code como agente de primera clase en cualquier editor compatible con ACP, sin depender de una extensión propietaria.
Para profundizar en las funciones exclusivas de Desktop, tengo un tip dedicado. Y para controlar Claude Code desde el móvil, otro sobre Remote Control y otro sobre Channels.
Cuánto cuesta (la realidad)
El plan gratuito de Claude.ai no incluye Claude Code. Necesitas un plan de pago.
| Plan | Precio | Para quién |
|---|---|---|
| Pro | $20/mes ($17/mes con pago anual) | Empezar, uso moderado |
| Max 5x | $100/mes | Uso intensivo diario |
| Max 20x | $200/mes | Uso profesional sin límites prácticos |
| API (BYOK) | Por token | Control total del coste |
| Team | Desde $25/puesto/mes | Equipos con billing centralizado |
Mi experiencia: uso el plan Max. El precio es transparente — sé lo que pago, sé lo que obtengo. Con Pro me quedaba al límite a veces. Con Max, usando una metodología spec-driven como CRAFT que optimiza el uso de tokens, rara vez agoto la cuota.
Mi consejo: si vas a invertir en un agente de codificación, hazlo con Claude. Estás más cerca del origen — el modelo estándar de facto para codificación. Dicho esto, no hay una opción mala. Si prefieres un IDE integrado, Cursor es excelente. Pruébalo y decide por ti mismo.
Para un análisis detallado de qué modelo elegir según tu plan, tengo un tip dedicado.
Empezar en 5 minutos
1. Instalar (NPM está deprecated — usa los instaladores nativos):
# macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash
# Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex
# macOS (Homebrew)
brew install --cask claude-code
2. Navegar a tu proyecto y ejecutar:
cd /ruta/a/tu/proyecto
claude
3. Autenticarte — se abre el navegador automáticamente. Inicia sesión con tu cuenta de Anthropic.
4. Tu primer prompt:
¿Qué hace este proyecto?
Claude analizará tu codebase y te dará un resumen. A partir de ahí, puedes pedir lo que necesites en lenguaje natural.
5. Entender los permisos — Shift+Tab para cambiar entre modos:
| Modo | Comportamiento |
|---|---|
| Default | Claude pide permiso antes de editar archivos o ejecutar comandos |
| Auto-accept edits | Edita sin preguntar; sigue pidiendo permiso para comandos |
| Plan mode | Solo lectura — crea un plan que tú apruebas antes de ejecutar |
Esto es lo primero que confunde a los principiantes: Claude te va a pedir permiso para todo. Es deliberado — es un sistema de seguridad. Con el tiempo, puedes configurar permisos granulares para automatizar lo que confías.
Y el mayor error que cometen los principiantes: no configurar la herramienta. Dedica tiempo de calidad a entender cómo funciona antes de lanzarte a producir. CLAUDE.md, hooks, contexto — todo eso existe para que Claude trabaje como tú quieres, no al revés. Claude Code tiene un tutorial interactivo que es un buen punto de partida.
El ecosistema de personalización (vista aérea)
Claude Code no es solo un agente que responde prompts. Es una plataforma extensible con 6 mecanismos:
| Mecanismo | Qué hace | Ejemplo |
|---|---|---|
| CLAUDE.md | Instrucciones persistentes que Claude lee en cada sesión | "Usa pnpm, no npm. Sigue los patrones de /src/composables" |
| Hooks | Automatizaciones deterministas que se ejecutan en eventos del ciclo de vida | Formatear después de cada edición, bloquear comandos destructivos |
| Skills | Comandos reutilizables invocables con /slash | /review-component, /deploy, /generate-tip |
| MCP | Conexión con servicios externos vía protocolo abierto | Notion, Playwright, bases de datos |
| Subagentes | Agentes especializados con su propio contexto y permisos | Investigación de codebase, tareas paralelas |
| Plugins | Paquetes que combinan skills, hooks y MCP en un solo instalable | Marketplace de la comunidad |
No necesitas aprender todo esto el primer día. Empieza con CLAUDE.md — es un archivo markdown con instrucciones para tu proyecto. Todo lo demás vendrá cuando lo necesites.
Para una vista completa de cómo se relacionan estos 6 mecanismos, tengo un tip dedicado.
Para quién es (y para quién no)
Claude Code es para ti si:
- Eres developer y quieres un agente que entienda tu proyecto completo
- Te sientes cómodo (o quieres sentirte cómodo) en un terminal
- Buscas control y predictibilidad, no autocompletado mágico
- Trabajas en un entorno profesional donde la calidad importa
Claude Code probablemente no es para ti si:
- Buscas una experiencia drag-and-drop o visual
- No estás dispuesto a invertir tiempo en configuración
- Quieres que la AI escriba todo sin supervisión
Si tu perfil es más visual y prefieres un IDE completo, Cursor es la mejor alternativa que conozco. Si lo tuyo es el terminal pero quieres explorar otras opciones, ACP te permite probar Claude Code dentro de Zed u otros editores compatibles.
Cierre
Claude Code es más que una herramienta. Tiene el potencial de cambiar tu vida profesional para mejor. Pero necesitas curiosidad y ganas de aprender.
No intentes dominarlo — cambia cada día. La herramienta que describo hoy será diferente mañana. El modelo cambia, los features cambian, el ecosistema cambia. Haz las paces con eso y disfruta del proceso.
Mi mayor error fue intentar promptear mi camino hacia la productividad en lugar de dedicar tiempo a una metodología sólida. Cuando adopté Spec Driven Development — primero con OpenSpec, luego con mi propia metodología CRAFT — todo cambió. Dejé de improvisar y empecé a construir con trazabilidad.
Y un último consejo: no busques gurús. Vete a la documentación oficial — es espectacular. Tenla abierta mientras trabajas. Cada vez que no sepas algo, busca, lee, vuelve. Es más que suficiente.
Pruébalo. De verdad.
Si quieres profundizar, la guía profesional de Claude Code es el siguiente paso natural. Desde ahí puedes explorar hooks, skills, subagentes, MCP y la comparativa con Cursor.