Cómo utilizar Claude Code: guía completa 2026

Aprende a instalar y usar Claude Code paso a paso: instalación, primeros comandos, CLAUDE.md, MCP y trucos para programar más rápido.

Lo esencial en 30 segundos:

• Claude Code es la herramienta de programación agéntica de Anthropic: entiende tu código, edita archivos, ejecuta comandos y hace commits directamente desde tu terminal, tu IDE o el navegador.
• Se instala con una sola línea (curl -fsSL https://claude.ai/install.sh | bash en macOS/Linux) y se activa desde cualquier carpeta de proyecto con el comando claude.
• Está incluido en los planes Claude Pro, Max, Team y Enterprise, o se puede usar por consumo con una cuenta de la Consola de Anthropic.

Utilizar Claude Code consiste en instalar la herramienta, entrar en la carpeta de tu proyecto y escribirle en lenguaje natural lo que necesitas —”arregla este error”, “escribe tests para este módulo”, “crea una rama y abre un pull request”—, mientras Claude explora tu código, propone cambios y te pide confirmación antes de modificar nada o ejecutar comandos. No sustituye tu criterio como desarrollador, pero sí elimina buena parte del trabajo mecánico que consume más tiempo del que debería.

Qué es Claude Code

Claude Code es una herramienta de codificación agéntica desarrollada por Anthropic que vive en tu terminal, tu editor de código o tu navegador, y que entiende el contexto completo de tu proyecto sin que tengas que ir seleccionando archivos manualmente. A diferencia de un autocompletado tradicional, actúa como un agente: planifica los pasos necesarios para completar una tarea, los ejecuta (leer archivos, editar código, correr tests, hacer commits) y verifica el resultado antes de dártelo por terminado.

Funciona en local: se conecta directamente a los modelos de Claude sin depender de un servidor intermedio, y siempre pide tu permiso antes de modificar archivos o ejecutar comandos que puedan tener efectos en tu sistema.

Para qué sirve

• Automatizar tareas tediosas: escribir tests, corregir errores de lint en todo el proyecto, resolver conflictos de merge, actualizar dependencias.
• Construir funcionalidades y arreglar bugs describiendo lo que necesitas en lenguaje natural, en vez de escribir cada línea a mano.
• Entender un código que no escribiste tú: te explica la arquitectura de un proyecto entero en segundos.
• Gestionar todo el flujo de Git: crear ramas, redactar mensajes de commit y abrir pull requests directamente.
• Conectar con tus herramientas de trabajo (Jira, Google Drive, Slack) a través de MCP para que Claude use información real de tu equipo, no solo del código.
• Automatizar revisiones de código y triaje de incidencias en CI/CD mediante GitHub Actions o GitLab CI/CD.

Principales características

• Múltiples superficies de uso: terminal, extensión para VS Code (y Cursor), plugin para JetBrains, app de escritorio, navegador (claude.ai/code) e integración con Slack.
• Archivos CLAUDE.md: un archivo en la raíz del proyecto donde defines estándares de código, decisiones de arquitectura o librerías preferidas, que Claude lee al empezar cada sesión.
• Memoria automática: Claude guarda aprendizajes (comandos de build, notas de depuración) entre sesiones sin que tengas que escribirlos tú.
• Skills y comandos personalizados: puedes empaquetar flujos de trabajo repetibles como /review-pr o /deploy-staging para compartir con tu equipo.
• Hooks: comandos que se ejecutan automáticamente antes o después de una acción de Claude Code, como formatear código tras cada edición.
• Equipos de agentes (sub-agents): puedes lanzar varios agentes de Claude Code trabajando en paralelo sobre distintas partes de una misma tarea, coordinados por un agente principal.
• Rutinas programadas: tareas que se ejecutan en un horario fijo, en respuesta a eventos de GitHub, o mediante llamadas a la API, corriendo en infraestructura gestionada por Anthropic aunque tu ordenador esté apagado.
• Integración con MCP (Model Context Protocol): conecta Claude Code con fuentes de datos externas como Google Drive, Jira o Slack.
• Trabajo desde cualquier lugar: puedes empezar una tarea en el navegador o el móvil y continuarla en tu terminal con claude --teleport, o controlar una sesión local desde el móvil con Remote Control.

Cómo empezar

1. Abre tu terminal y ejecuta el instalador según tu sistema:
   • macOS, Linux o WSL: curl -fsSL https://claude.ai/install.sh | bash
   • Windows PowerShell: irm https://claude.ai/install.ps1 | iex
   • Windows CMD: curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
2. También puedes instalarlo con Homebrew (brew install --cask claude-code) o WinGet (winget install Anthropic.ClaudeCode) si prefieres gestionar las actualizaciones tú mismo.
3. Entra en la carpeta de tu proyecto (cd tu-proyecto) y ejecuta claude.
4. Inicia sesión la primera vez que lo uses, con tu cuenta de Claude o de la Consola de Anthropic.
5. Si prefieres trabajar desde tu editor, instala la extensión de VS Code o el plugin de JetBrains en lugar de (o además de) la terminal.

Tutorial completo paso a paso

Paso 1: Instala Claude Code con el método nativo. Es la opción recomendada porque se actualiza automáticamente en segundo plano. Consejo: si usas Windows de forma nativa (no WSL), instala también Git for Windows para que Claude Code pueda usar la herramienta Bash en vez de depender solo de PowerShell. Error frecuente: instalar vía npm, un método que ya está desaconsejado en favor del instalador nativo. Buena práctica: usa el instalador nativo salvo que necesites controlar tú mismo el momento de cada actualización, en cuyo caso usa Homebrew o WinGet.

Paso 2: Arranca tu primera sesión en un proyecto real. Ejecuta claude dentro de la carpeta de tu proyecto y pídele algo sencillo para familiarizarte, como “explícame la estructura de este proyecto”. Consejo: empieza con una tarea pequeña y bien delimitada antes de pedirle cambios grandes. Error frecuente: pedir una funcionalidad muy amplia y ambigua en la primera prueba, sin dar contexto suficiente. Buena práctica: deja que Claude explore el código primero; sus respuestas mejoran mucho cuando ya tiene contexto real del proyecto.

Paso 3: Crea un archivo CLAUDE.md en la raíz del proyecto. Anota ahí tus convenciones de código, librerías preferidas y cualquier decisión de arquitectura relevante. Consejo: no hace falta que sea exhaustivo desde el primer día; puedes ampliarlo a medida que detectas que Claude repite el mismo error de contexto. Error frecuente: no crear este archivo y repetir las mismas instrucciones en cada sesión nueva. Buena práctica: revisa y actualiza el archivo cuando cambien las convenciones del proyecto.

Paso 4: Pide tareas concretas en lenguaje natural. Por ejemplo: claude "escribe tests para el módulo de autenticación, ejecútalos y corrige los fallos". Consejo: si tienes un mensaje de error, pégaselo directamente en vez de describirlo de memoria. Error frecuente: no revisar el plan que propone Claude antes de que empiece a ejecutar cambios en tareas complejas. Buena práctica: para tareas grandes, pide primero que te explique el plan antes de darle luz verde a ejecutarlo.

Paso 5: Revisa cada cambio antes de aceptarlo. Claude Code te pide confirmación antes de modificar archivos o ejecutar comandos con efectos en tu sistema. Consejo: usa la extensión de VS Code o la app de escritorio si prefieres revisar los cambios como un diff visual en vez de en texto plano de terminal. Error frecuente: aceptar cambios en bloque sin revisarlos en proyectos críticos. Buena práctica: revisa con más atención los cambios que tocan lógica de negocio o seguridad, y de forma más rápida los puramente mecánicos (formateo, tests).

Paso 6: Automatiza tareas repetitivas con hooks y skills. Si te encuentras pidiendo lo mismo una y otra vez (formatear tras cada edición, ejecutar el linter antes de cada commit), conviértelo en un hook o en un comando personalizado. Consejo: empieza automatizando solo la tarea que más se repite, no todas a la vez. Error frecuente: configurar hooks muy agresivos que interrumpen el flujo de trabajo en vez de ayudarlo. Buena práctica: prueba cada hook nuevo en una tarea sin urgencia antes de dejarlo activo de forma permanente.

Paso 7: Conecta tus herramientas con MCP si las necesitas. Si Claude Code necesita leer un documento de Google Drive, actualizar un ticket de Jira o consultar un canal de Slack, conéctalo mediante un servidor MCP. Consejo: empieza conectando una sola herramienta y comprueba que funciona bien antes de añadir más. Error frecuente: conectar de golpe muchas integraciones sin verificar los permisos que estás concediendo. Buena práctica: revisa periódicamente qué servidores MCP tienes conectados y retira los que ya no uses.

Paso 8: Escala a tareas más grandes con sub-agentes o rutinas programadas. Para tareas que se benefician de trabajo en paralelo, lanza varios agentes coordinados; para tareas que se repiten en el tiempo (revisión de PRs cada mañana, auditoría semanal de dependencias), crea una rutina programada. Consejo: usa rutinas para tareas de bajo riesgo y alto valor repetitivo, no para cambios críticos sin supervisión. Error frecuente: automatizar con rutinas una tarea que todavía necesita revisión humana en cada ejecución. Buena práctica: revisa el resultado de una rutina nueva varias veces antes de confiar en ella sin supervisión.

Ejemplos reales

• Un equipo de ingeniería usa Claude Code para convertir código exploratorio de un notebook (carga de datos, entrenamiento de un modelo, evaluación de métricas) directamente en un pipeline de producción, ahorrando días de trabajo manual y repetitivo.
• Un desarrollador que se incorpora a un proyecto nuevo le pide a Claude Code que le explique la arquitectura completa del repositorio antes de tocar una sola línea, en lugar de leer la documentación durante horas.
• Un equipo conecta Claude Code a Slack para que, cuando alguien menciona @Claude con un bug reportado, la herramienta investigue el problema y devuelva un pull request listo para revisar.
• Un responsable técnico configura rutinas programadas para que Claude Code revise cada mañana el estado de las dependencias del proyecto y avise si hay vulnerabilidades conocidas.

Trucos

• Usa claude -p para ejecutar Claude Code de forma no interactiva dentro de scripts o pipelines, por ejemplo canalizando logs: tail -200 app.log | claude -p "avísame si ves alguna anomalía".
• Aprovecha claude --teleport para continuar en tu terminal una tarea que empezaste en el navegador o el móvil, sin perder el contexto.
• Si trabajas en varios frentes a la vez, usa la vista de agentes en segundo plano para lanzar varias sesiones completas y supervisarlas desde una sola pantalla.
• Deja que Claude Code construya memoria automática de tu proyecto en vez de repetir instrucciones básicas en cada sesión; con el tiempo necesitarás explicar cada vez menos contexto.
• Combina hooks con tu linter y formateador habituales para que el código que genera Claude Code cumpla automáticamente tus estándares de estilo.

Automatizaciones

• Con GitHub Actions o GitLab CI/CD: automatiza revisión de código y triaje de incidencias en cada pull request, sin intervención manual.
• Con MCP: conecta Claude Code a Jira, Google Drive o Slack para que trabaje con información real de tu organización, no solo con el código.
• Con Slack: menciona a @Claude con un bug o una tarea y recibe un pull request de vuelta sin salir del chat de equipo.
• Con rutinas programadas: automatiza tareas recurrentes como revisiones matutinas de pull requests o auditorías semanales de dependencias, ejecutándose en la infraestructura de Anthropic aunque tu equipo esté desconectado.

Comparativa

Preguntas frecuentes

¿Cuánto cuesta usar Claude Code? Está incluido en los planes Claude Pro, Max, Team y Enterprise (con precios que cambian según promociones vigentes, conviene revisarlos en claude.com/pricing), o se puede usar por consumo con una cuenta de la Consola de Anthropic sin necesidad de suscripción.

¿Necesito instalar algo en cada proyecto? No, Claude Code se instala una vez en tu sistema y luego lo ejecutas (claude) desde la carpeta de cualquier proyecto en el que quieras trabajar.

¿Puedo usar Claude Code sin salir de mi editor habitual? Sí, hay extensión nativa para VS Code (y Cursor) y plugin para JetBrains, además de la opción de terminal y la app de escritorio.

¿Claude Code puede modificar mi código sin que yo lo revise? Por defecto, siempre pide confirmación antes de modificar archivos o ejecutar comandos con efectos en tu sistema; solo actúa sin supervisión en tareas que tú configures explícitamente como automatizadas (por ejemplo, mediante rutinas programadas).

¿Qué es un archivo CLAUDE.md y por qué debería crearlo? Es un archivo en la raíz de tu proyecto donde defines convenciones de código y contexto relevante; Claude Code lo lee al empezar cada sesión, lo que reduce mucho la necesidad de repetir instrucciones básicas cada vez.