Qué es Claude Code: guía del agente de programación de Anthropic

Claude Code es el agente de programación de Anthropic. No es un autocompletado ni un chat al que se le pega código: es una herramienta que lee el repositorio, edita archivos, ejecuta comandos y se integra con las herramientas de desarrollo que ya usa el equipo. Se le describe una tarea en lenguaje natural y él planifica, toca los ficheros necesarios, lanza los tests y propone el resultado para que lo revisemos.

En esta guía explicamos qué es exactamente, dónde se puede usar, qué modelo hay detrás, cómo se controla lo que hace y en qué se diferencia de otras herramientas como Cursor. Los datos están verificados en la documentación oficial a fecha de octubre de 2026.

¿Qué es Claude Code y en qué se diferencia de un chat con IA?

La diferencia clave es la autonomía. En un chat, el desarrollador copia un fragmento, recibe una respuesta y la pega a mano. Claude Code trabaja directamente sobre el proyecto: abre los archivos que necesita, busca referencias, modifica varios ficheros a la vez, ejecuta el linter o la batería de tests y corrige lo que falle. La propia documentación de Anthropic lo define como una herramienta agéntica que entiende el código base completo y puede trabajar con varios archivos y herramientas para terminar una tarea.

En la práctica, eso permite encargos como estos:

claude "escribe tests para el módulo de autenticación, ejecútalos y corrige los fallos"
claude "haz commit de mis cambios con un mensaje descriptivo"

También sigue la filosofía Unix: se le puede pasar la salida de otro comando. Por ejemplo, git diff main --name-only | claude -p "revisa estos archivos en busca de problemas de seguridad" analiza solo lo que ha cambiado respecto a la rama principal.

¿Dónde se puede usar Claude Code?

Aunque nació como herramienta de terminal, hoy funciona en varias «superficies» que comparten el mismo motor. Según la documentación oficial:

Terminal (CLI): la versión más completa, para macOS, Linux, Windows y WSL.
VS Code: extensión con diffs en línea, menciones con @ y revisión de planes. Se instala también en Cursor y otros forks de VS Code.
JetBrains: plugin para IntelliJ IDEA, PyCharm, WebStorm, PhpStorm, GoLand o Android Studio, que usa el CLI por debajo.
App de escritorio: pestaña Code de la aplicación de Claude, con sesiones en paralelo y revisión visual de cambios.
Web y móvil: en claude.ai/code y en la app de Claude para iOS y Android, con sesiones que se ejecutan en la nube.
Integraciones: GitHub Actions, GitLab CI/CD, Slack (mencionando a @Claude) y Chrome para depurar aplicaciones web.

Lo interesante para un equipo es que los archivos CLAUDE.md, la configuración y los servidores MCP del repositorio funcionan igual en todas ellas.

¿Qué modelo de IA usa Claude Code?

A fecha de octubre de 2026, la documentación indica que el modelo por defecto para cuentas Pro, Max, Team, Enterprise y API de Anthropic es Claude Opus 5.5. Con la API de Anthropic, los alias se resuelven así: opus apunta a Opus 5.5, sonnet a Sonnet 5.5 y haiku a Haiku 5.5. Existe además el alias opusplan, que usa Opus durante el modo plan y cambia a Sonnet para ejecutar.

Lee también: Code Review de Claude Code llega a disponibilidad general para equipos

El modelo se cambia en mitad de la sesión con /model sonnet o al arrancar con claude --model opus. También se puede ajustar el nivel de esfuerzo con /effort: en Opus 5.5, Sonnet 5.5 y Haiku 5.5 el valor por defecto es medium. Si se usa Amazon Bedrock, Google Cloud o Microsoft Foundry, los alias pueden apuntar a versiones distintas, así que conviene comprobarlo.

¿Cómo se controla lo que hace Claude Code?

Darle acceso a la terminal a una IA exige límites claros. Claude Code los gestiona con modos de permisos, que se alternan con Shift+Tab en el CLI:

Manual (valor de configuración default): solo lee sin preguntar; pide permiso para editar o ejecutar.
acceptEdits: aprueba ediciones y comandos básicos de sistema de archivos.
plan: explora y propone un plan sin modificar el código.
auto: un segundo modelo, el clasificador, revisa las acciones en lugar del usuario. Desde la versión 2.1.283 es el modo inicial en terminal y VS Code.
dontAsk y bypassPermissions: pensados para CI bloqueados o para contenedores y máquinas virtuales aislados.

Encima de los modos se pueden definir reglas de permiso. Las reglas de denegación bloquean en cualquier modo, incluso en bypassPermissions, lo que permite vetar, por ejemplo, la lectura de un .env.

¿Cómo aprende Claude Code las normas de mi proyecto?

Mediante el archivo CLAUDE.md, un Markdown en la raíz del repositorio que se carga al inicio de cada sesión. Ahí van los comandos de build y test, las convenciones de código y las decisiones de arquitectura. El comando /init genera un primer borrador analizando el código. Anthropic recomienda mantener cada archivo por debajo de 200 líneas, porque los archivos largos consumen contexto y reducen la adherencia a las instrucciones.

Hay variantes útiles: ~/.claude/CLAUDE.md para preferencias personales en todos los proyectos y CLAUDE.local.md para notas propias que no se suben al repositorio. Si el proyecto ya tiene un AGENTS.md para otros agentes, Claude Code puede leerlo en su lugar. Y además existe la auto memory: notas que el propio Claude guarda a partir de las correcciones que le hacemos.

¿Claude Code es gratis?

No. La documentación es explícita: hace falta una cuenta Pro, Max, Team, Enterprise o de Claude Console (API). El plan gratuito de claude.ai no incluye Claude Code. También se puede usar a través de Amazon Bedrock, Google Cloud o Microsoft Foundry, pagando por tokens en la factura del proveedor. Hemos desglosado planes y costes en nuestra guía de precios.

¿Claude Code o Cursor? ¿Son incompatibles?

Es una de las comparativas más buscadas, pero no son excluyentes. Cursor es un editor de código basado en VS Code con su propio agente integrado; Claude Code es un agente que vive en la terminal y en otras superficies, y su extensión oficial se instala dentro de Cursor. Muchos equipos usan el editor que prefieren y lanzan Claude Code para las tareas largas: migraciones, refactorizaciones en muchos archivos o corrección de tests en bloque.

Para decidir, nuestra recomendación es fijarse en tres cosas: dónde pasa más tiempo el equipo (editor o terminal), si se necesitan automatizaciones en CI y tareas programadas, y qué plan de pago se tiene ya contratado. Si la empresa ya paga Claude Team o Enterprise, Claude Code está incluido en el asiento.

Primeros pasos recomendados

Instala el CLI y entra en un proyecto: cd mi-proyecto y claude.
Ejecuta /init y revisa el CLAUDE.md que genera.
Para tareas grandes, empieza en modo plan y aprueba el enfoque antes de que edite.
Sé específico: «añade validación al login en auth.ts» gasta mucho menos que «mejora el código».
Usa /clear al cambiar de tarea para no arrastrar contexto innecesario.

Con esa base, el siguiente paso es extenderlo con skills, subagentes, hooks y servidores MCP, que convierten a Claude Code en una herramienta adaptada a los flujos de cada equipo.