≡En resumen
- Claude Code no solo sugiere código: lo escribe, lo ejecuta, lo prueba y lo versiona en tu proyecto.
- Se instala con un comando y se usa en la terminal, en el IDE, en la app de escritorio o en claude.ai/code.
- CLAUDE.md, skills, hooks, subagentes y servidores MCP permiten adaptarlo a las normas de tu equipo.
- Los modos de permisos deciden qué puede hacer sin preguntarte; empieza siempre por los más restrictivos.
- También sirve para automatizar: modo no interactivo, GitHub Actions, rutinas programadas y el Agent SDK.
01 ¿Qué es Claude Code?
Claude Code es la herramienta de Anthropic para programar con Claude como agente. A diferencia de un autocompletado, no se limita a proponer líneas: entiende el repositorio entero, decide qué archivos leer, edita varios a la vez, lanza los tests, interpreta los errores y vuelve a intentarlo hasta que la tarea funciona.
Se presentó como vista previa en febrero de 2025 y está disponible de forma general desde mayo de ese año. Hoy es una de las herramientas de programación con IA más usadas, tanto por desarrolladores individuales como por equipos que la integran en su flujo de trabajo y en su integración continua.
02 Dónde funciona Claude Code: terminal, IDE, escritorio y web
| Superficie | Qué ofrece | Cuándo usarla |
|---|---|---|
| Terminal (CLI) | La versión más completa, con todos los comandos y opciones | Trabajo diario y automatización con scripts |
| VS Code y Cursor | Extensión con diffs en línea, menciones con @ y revisión del plan | Si prefieres no salir del editor |
| JetBrains | Plugin para IntelliJ, PyCharm, WebStorm y otros IDE | Equipos que trabajan con IDE de JetBrains |
| App de escritorio | Pestaña Code con diffs visuales y varias sesiones en paralelo | Revisar cambios con comodidad y programar tareas |
| Web y móvil | Sesiones en la nube desde claude.ai/code o la app de Claude | Tareas largas o repos que no tienes en local |
03 Cómo instalar Claude Code
-
1
Instala con el instalador nativo
En macOS, Linux o WSL ejecuta curl -fsSL https://claude.ai/install.sh | bash. En Windows PowerShell usa irm https://claude.ai/install.ps1 | iex.
-
2
O usa un gestor de paquetes
brew install --cask claude-code en macOS o winget install Anthropic.ClaudeCode en Windows. Estas vías no se actualizan solas.
-
3
Comprueba la instalación
Abre una terminal nueva y ejecuta claude --version. Si no encuentra el comando, revisa el PATH.
-
4
Arranca en tu proyecto
Entra en la carpeta del proyecto y escribe claude. La primera vez te pedirá iniciar sesión con tu cuenta.
-
5
Genera tu CLAUDE.md
Ejecuta /init para que Claude analice el proyecto y cree un archivo con sus convenciones.
04 Cómo trabaja Claude Code: el bucle agéntico y los permisos
Claude Code funciona en un bucle: recibe tu petición, reúne contexto leyendo archivos, planifica, actúa con sus herramientas y comprueba el resultado. Si un test falla, lee el error y corrige. Ese ciclo se repite hasta terminar o hasta que necesita tu aprobación.
Leer y buscar
Explora el repositorio, busca símbolos y entiende la arquitectura antes de tocar nada.
Editar
Modifica varios archivos en un mismo cambio y te muestra el diff.
Ejecutar
Lanza tests, linters, builds o cualquier comando de la terminal.
Git
Crea ramas, escribe mensajes de commit y abre pull requests.
Dos detalles ayudan a trabajar con tranquilidad. El primero son los puntos de control: Claude Code guarda el estado antes de cada cambio y puedes volver atrás si una edición no te convence. El segundo es la gestión del contexto: en sesiones largas resume la conversación para no perder el hilo, y con /model eliges qué modelo de Claude usa según la dificultad de la tarea.
05 Personalizar Claude Code: CLAUDE.md, skills, hooks y subagentes
| Pieza | Qué es | Ejemplo |
|---|---|---|
| CLAUDE.md | Archivo Markdown con instrucciones que se lee al iniciar cada sesión | Normas de código, comandos de test, decisiones de arquitectura |
| Skills | Flujos reutilizables empaquetados que puedes invocar como comando | /review-pr o /deploy-staging |
| Hooks | Comandos que se ejecutan antes o después de acciones de Claude | Formatear cada archivo tras editarlo |
| Subagentes | Agentes especializados con su propio contexto que trabajan en paralelo | Uno revisa seguridad mientras otro escribe tests |
| Servidores MCP | Conexiones con herramientas y datos externos | Leer tickets de Jira o diseños de Figma |
| Plugins | Paquetes que agrupan skills, hooks, subagentes y servidores MCP | Instalar el kit de tu equipo con un comando |
Los hooks de Claude Code son la pieza que garantiza que algo ocurra siempre, sin depender de que el modelo lo recuerde. El resto orienta su comportamiento. Si necesitas ir más allá y construir tu propio agente con las mismas herramientas, existe el Claude Agent SDK.
06 Automatizar con Claude Code: CI, rutinas y trabajo remoto
Modo no interactivo
claude -p "instrucción" ejecuta una tarea y devuelve el resultado, ideal para scripts y tuberías.
GitHub Actions y GitLab
Revisión de pull requests y triaje de incidencias dentro de tu integración continua.
Rutinas
Tareas programadas que se ejecutan en la nube aunque tu ordenador esté apagado; se crean con /schedule.
Remote Control
Continúa una sesión local desde el móvil o desde otro navegador.
Navegador y escritorio
Con Claude en Chrome prueba tu web en el navegador; con computer use maneja apps nativas.
Combinado con Claude en Chrome, el flujo completo queda en una sola conversación: escribe el código, abre localhost, rellena el formulario y lee los errores de la consola. Para apps de escritorio o simuladores entra en juego computer use.
07 Casos de uso reales para equipos de desarrollo
Un equipo necesita renombrar un campo en veinte endpoints. Activa plan mode, Claude Code analiza rutas, controladores y tests y propone un plan. Tras aprobarlo, hace los cambios, ejecuta la suite completa, corrige dos tests rotos y abre una pull request con la descripción del cambio. La revisión humana sigue siendo obligatoria, pero el trabajo mecánico desaparece.
Es la forma en que trabajamos hoy en proyectos de desarrollo web a medida y en plataformas de desarrollo de software SaaS: la IA acelera la parte repetitiva y el equipo se concentra en la arquitectura, la seguridad y la revisión.
08 Buenas prácticas para sacarle partido
- ✓Escribe un CLAUDE.md corto y concreto: comandos, convenciones y lo que nunca debe hacer.
- ✓Pide primero un plan en tareas grandes y apruébalo antes de que toque el código.
- ✓Dale una forma de verificar su trabajo: tests, linter o una URL que pueda abrir.
- ✓Trabaja en ramas y revisa cada diff antes de fusionar.
- ✓Limpia el contexto con /clear entre tareas que no tienen relación.
- ✓No le des acceso a secretos de producción ni uses el modo sin permisos fuera de un entorno aislado.
La comunidad ha publicado cientos de skills, plugins y servidores MCP para Claude Code. Tienes una selección comentada en nuestro directorio de herramientas para Claude Code.
Preguntas frecuentes sobre Claude Code
Es la herramienta agéntica de programación de Anthropic. Lee tu código, edita archivos, ejecuta comandos y trabaja con git a partir de instrucciones en lenguaje natural.
No. Necesitas un plan de pago de Claude (Pro, Max, Team o Enterprise) o una cuenta de la Claude Console con pago por uso de la API.
En macOS, Linux y WSL con curl -fsSL https://claude.ai/install.sh | bash; en Windows con el script de PowerShell, WinGet o la app de escritorio. Después ejecutas claude dentro de tu proyecto.
Sí, de forma nativa con PowerShell o dentro de WSL. Se recomienda instalar Git for Windows para que pueda usar Bash.
El chat responde y genera contenido en la conversación. Claude Code actúa directamente sobre tu proyecto: lee y modifica archivos, ejecuta comandos y hace commits.
Usa los modelos actuales de Claude y puedes cambiar entre ellos con el comando /model. Los más capaces rinden mejor en tareas largas, pero consumen más uso.
Por defecto pide permiso antes de editar o ejecutar. Usa modos restrictivos, trabaja en ramas y reserva los modos sin confirmación para entornos aislados.
Un archivo Markdown en la raíz del proyecto que Claude Code lee al empezar cada sesión. Sirve para fijar normas de código, comandos y decisiones del equipo.
Fuentes consultadas
Sobre el autor
Germán Gutiérrez
Development Manager en appyweb
Dirige el equipo de desarrollo de appyweb: aplicaciones web y móviles, SaaS, integraciones y arquitectura de software.
Ver perfil en LinkedIn ↗