Cómo usar Claude Code: Guía Completa

Claude Code es la herramienta de programación agencial de Anthropic. A diferencia de utilizar Claude desde un chat y copiar fragmentos de código, Claude Code puede trabajar directamente sobre un proyecto: leer la base de código, localizar archivos relacionados, modificar código, ejecutar comandos, lanzar pruebas y trabajar con Git desde el mismo flujo.

Eso cambia bastante la forma de programar con IA. Ya no se trata solo de pedir una función y pegar el resultado en el editor. Puedes abrir Claude Code dentro de un repositorio, pedirle que entienda cómo funciona, planificar una modificación, dejar que implemente los cambios y revisar después exactamente qué ha tocado antes de aceptarlo.

En esta guía aprenderás qué es Claude Code y cómo usarlo paso a paso, desde la instalación y tu primera sesión hasta un flujo de trabajo completo con Plan Mode, CLAUDE.md, Git, debugging, tests, MCP, Skills, Hooks y subagentes. También veremos cuándo conviene usar la terminal, VS Code, Cursor, la aplicación de escritorio o la versión web.

Qué es Claude Code y para qué sirve

Claude Code es un agente de programación de Anthropic pensado para trabajar directamente con proyectos de software. Puede inspeccionar la estructura de un repositorio, leer archivos cuando los necesita, editar varios archivos relacionados, ejecutar comandos en el entorno de desarrollo y utilizar herramientas como Git durante la misma sesión.

La diferencia respecto a utilizar Claude desde el chat es importante. En un chat tradicional normalmente eres tú quien selecciona el código que quiere enseñar, copia el error, pega la respuesta en el editor y ejecuta el resultado. Con Claude Code, el agente puede moverse por el proyecto y realizar una parte de ese proceso dentro del propio entorno de desarrollo.

Por eso, cuando hablamos de programar con Claude en un proyecto real, Claude Code es la herramienta que conviene conocer. Claude sigue siendo útil para aprender conceptos, resolver dudas o analizar código de forma puntual, pero Claude Code está diseñado para intervenir directamente en el flujo de desarrollo.

Qué puede hacer Claude Code en un proyecto real

Claude Code no se limita a generar funciones aisladas. Puede participar en distintas fases del desarrollo y encadenar varias acciones hasta completar una tarea. Entre los usos más habituales se encuentran los siguientes:

• Entender una base de código: localizar el punto de entrada, explicar la arquitectura, identificar dependencias y seguir el recorrido de una funcionalidad entre varios archivos.
• Crear funcionalidades: analizar dónde debe incorporarse un cambio, modificar los archivos necesarios y comprobar que el proyecto sigue funcionando.
• Corregir errores: investigar un síntoma o mensaje de error, localizar la causa y proponer o implementar una solución.
• Escribir y ejecutar tests: crear pruebas, ejecutarlas y utilizar los fallos para seguir iterando.
• Refactorizar: reorganizar código, reducir duplicaciones, actualizar patrones antiguos o modificar una funcionalidad que afecta a varios módulos.
• Trabajar con Git: consultar el estado del repositorio, revisar diferencias, crear ramas, preparar commits y ayudar con conflictos.
• Revisar código: analizar cambios pendientes antes de integrarlos y buscar problemas de legibilidad, mantenimiento, seguridad o rendimiento.
• Actualizar documentación: modificar README, instrucciones de instalación o documentación relacionada con los cambios realizados.
• Actualizar dependencias: investigar qué cambia entre versiones, modificar el proyecto y ejecutar las comprobaciones necesarias.
• Automatizar tareas: utilizar la CLI, Hooks, Skills, MCP o CI/CD para convertir procesos repetitivos en flujos reutilizables.

La clave está en que Claude Code puede combinar varias de estas capacidades. Puedes pedirle que investigue un bug, escriba el arreglo, ejecute la prueba relacionada, revise el diff y prepare un commit. Aun así, el programador sigue siendo responsable de definir el objetivo, revisar los cambios y decidir qué se integra en el proyecto.

Cómo instalar Claude Code

Puedes utilizar Claude Code desde distintas superficies, pero la terminal sigue siendo una de las formas más completas de aprender cómo funciona. La instalación depende del sistema operativo.

Requisitos antes de instalarlo

Para seguir esta guía te conviene tener:

• Una cuenta compatible con Claude Code o acceso mediante Claude Console
• Una terminal o PowerShell
• Un proyecto con el que practicar
• Git instalado si quieres seguir el flujo completo de control de versiones.

Instalar Claude Code en macOS, Linux o WSL

La instalación nativa recomendada se realiza desde la terminal:

curl -fsSL https://claude.ai/install.sh | bash

En macOS también puedes instalar la versión estable mediante Homebrew:

brew install --cask claude-code

Si utilizas Homebrew, las actualizaciones se hacen manualmente:

brew upgrade claude-code

Instalar Claude Code en Windows con PowerShell

Abre PowerShell y ejecuta:

irm https://claude.ai/install.ps1 | iex

En Windows también puedes instalarlo con WinGet:

winget install Anthropic.ClaudeCode

Para actualizar una instalación realizada mediante WinGet:

winget upgrade Anthropic.ClaudeCode

En Windows nativo resulta recomendable tener Git for Windows. Claude Code puede utilizar Bash si está disponible y, si no lo está, trabajar con PowerShell.

Comprobar que Claude Code está instalado

Después de la instalación, comprueba la versión:

claude --version

Si la instalación es correcta, la terminal mostrará el número de versión de Claude Code.

Iniciar sesión

Ejecuta:

claude

La primera vez se abrirá el proceso de autenticación. Puedes utilizar una suscripción compatible de Claude, una cuenta de Claude Console con facturación por uso u otros métodos de acceso admitidos por Anthropic.

Si más adelante necesitas cambiar de cuenta, puedes utilizar dentro de Claude Code:

/login

También puedes consultar la guía oficial de instalación y primeros pasos de Claude Code para comprobar los requisitos y métodos de instalación vigentes.

Cómo empezar a usar Claude Code

Una vez instalado, lo más útil es abrirlo dentro de un proyecto real. Sitúate en la carpeta del repositorio:

cd ruta/al/proyecto  claude

A partir de ese momento Claude Code utiliza ese directorio como contexto de trabajo. No necesitas copiar cada archivo manualmente. Puede leer la base de código según lo que necesite para responder o ejecutar una tarea.

Empieza pidiéndole que entienda el proyecto

Antes de ordenar un cambio, prueba preguntas como estas:

¿Qué hace este proyecto y cuáles son sus partes principales?

¿Qué tecnologías utiliza y dónde está el punto de entrada?

Explícame la estructura de carpetas y cómo fluye una petición desde la interfaz hasta la base de datos.

Localiza dónde se gestiona la autenticación y explícame el flujo actual sin modificar nada.

Esta fase es especialmente importante cuando el proyecto no es tuyo o cuando la funcionalidad que quieres cambiar atraviesa varias capas. Primero necesitas que Claude localice el código relevante y entienda cómo se relaciona.

Comandos básicos que conviene conocer

Cómo programar con Claude Code paso a paso

El error más habitual al empezar es abrir Claude Code y pedir inmediatamente una funcionalidad grande. Para cambios pequeños puede funcionar, pero en tareas que afectan a varios archivos suele ser más fiable separar exploración, planificación, implementación y comprobación.

1. Deja que explore primero

Empieza describiendo el problema y pídele que localice las partes relevantes sin tocar el proyecto:

Necesitamos añadir inicio de sesión con Google.    Primero analiza cómo funciona la autenticación actual, dónde se crean las sesiones y qué archivos habría que modificar. No cambies código todavía.

Así puedes comprobar si ha entendido correctamente la arquitectura antes de permitir que empiece a editar.

2. Utiliza Plan Mode cuando el cambio sea complejo

Plan Mode permite que Claude investigue y diseñe el enfoque sin realizar cambios. Puedes activarlo desde los modos de permiso o iniciar una sesión específicamente en este modo:

claude --permission-mode plan

Después puedes pedir:

Prepara un plan detallado para implementar esta funcionalidad.    Indica:  - qué archivos habría que tocar,  - qué lógica cambiaría,  - qué riesgos ves,  - qué tests deberían añadirse,  - cómo comprobarías que no hemos roto el comportamiento actual.

La planificación añade trabajo extra, por lo que no hace falta utilizarla para cambiar un texto o renombrar una variable. Sí merece la pena cuando el alcance no está claro, el cambio afecta a múltiples archivos o estás trabajando sobre una base de código que todavía no conoces bien.

3. Revisa el plan antes de implementar

No mires solo si el plan parece ordenado. Comprueba si realmente respeta la arquitectura del proyecto, si propone dependencias nuevas sin necesidad o si intenta modificar partes que no deberían verse afectadas.

Si algo no encaja, corrígelo antes de generar código:

No quiero introducir una librería nueva para esto. Rehaz el plan utilizando las dependencias que ya existen en el proyecto.

4. Pide la implementación

Cuando el enfoque esté claro:

Implementa el plan acordado.    Mantén los cambios limitados a esta funcionalidad, respeta las convenciones actuales del proyecto y no modifiques código no relacionado.

Claude Code puede editar varios archivos en una misma tarea. Tu trabajo es vigilar que el alcance se mantenga controlado.

5. Dale una forma de verificar su trabajo

Una de las mejores formas de mejorar los resultados es definir cómo debe comprobarse que el cambio funciona.

Cuando termines:  1. ejecuta los tests relacionados,  2. ejecuta el typecheck,  3. ejecuta el linter,  4. corrige únicamente los errores provocados por este cambio,  5. resume qué has modificado.

Cuando el proyecto tiene pruebas, compilación o validaciones automáticas, Claude dispone de señales objetivas para saber si su solución funciona.

6. Revisa el diff

No des por correcto un cambio porque las pruebas pasen. Revisa también qué archivos se han modificado y si el resultado es más amplio de lo necesario.

Puedes preguntar:

Revisa tu propio diff antes de continuar.    Busca:  - cambios innecesarios,  - código duplicado,  - casos límite no cubiertos,  - problemas de seguridad,  - dependencias nuevas que podamos evitar.

7. Comprueba Git antes de cerrar la tarea

Pregunta qué se ha cambiado:

¿Qué archivos has modificado y por qué?

También puedes pedir una revisión del estado del repositorio o del diff antes de preparar el commit.

8. Haz el commit cuando hayas revisado el resultado

Cuando el cambio esté validado:

Prepara un commit con un mensaje descriptivo que resuma la funcionalidad implementada.

La idea general es sencilla:

explorar → planificar → implementar → verificar → revisar → integrar.

Ese flujo suele ser más fiable que pedir a Claude Code una solución completa desde el primer mensaje.

Ejemplo práctico: crear una aplicación con Claude Code

Vamos a llevar el proceso a un proyecto sencillo. Imagina que quieres crear una pequeña aplicación de tareas con Node.js que permita crear, listar, completar y eliminar tareas. El objetivo del ejemplo no es generar aquí todo el código, sino mostrar cómo dirigir a Claude Code para que el proceso sea controlable.

1. Crea el directorio y el repositorio

mkdir gestor-tareas  cd gestor-tareas  git init  claude

2. Pide un diseño antes de generar archivos

Quiero construir una aplicación sencilla para gestionar tareas.    Requisitos:  - backend con Node.js,  - API para crear, listar, completar y eliminar tareas,  - persistencia sencilla,  - tests para las rutas principales.    Antes de escribir código:  1. propón la estructura mínima del proyecto,  2. explica las decisiones técnicas,  3. divide el desarrollo en fases,  4. no modifiques ningún archivo todavía.

Revisa que la propuesta no sea excesivamente compleja. Para un proyecto pequeño no necesitas microservicios, colas, múltiples capas de abstracción ni una arquitectura pensada para millones de usuarios.

3. Pide la primera implementación

Implementa la primera versión siguiendo el plan.    Empieza por la estructura mínima y las rutas de la API. No añadas funcionalidades que no estén en los requisitos.

4. Ejecuta el proyecto

Una vez creados los archivos:

Instala únicamente las dependencias necesarias y ejecuta la aplicación.    Si aparece un error, no lo ocultes. Identifica primero la causa antes de modificar código.

Claude puede utilizar la salida de la terminal para continuar investigando si algo falla.

5. Añade las pruebas

Ahora crea tests para:  - crear una tarea válida,  - rechazar una tarea sin título,  - marcar una tarea como completada,  - eliminar una tarea,  - solicitar una tarea que no existe.    Ejecuta los tests y corrige los fallos relacionados con nuestra implementación.

6. Provoca una revisión antes del commit

Antes de hacer commit, revisa todos los cambios como si fueras otro desarrollador del equipo.    No edites nada todavía. Señala:  - errores potenciales,  - código innecesario,  - casos límite,  - problemas de mantenimiento,  - decisiones que cambiarías.

Este paso es útil porque obliga al agente a cambiar de perspectiva antes de seguir modificando el proyecto.

7. Aplica únicamente las mejoras que tengan sentido

Aplica las mejoras 1 y 3 de tu revisión. No hagas el resto.    Después vuelve a ejecutar los tests y comprueba el estado del repositorio.

8. Cierra con Git

Muéstrame un resumen del diff y, si no detectas cambios fuera del alcance de esta tarea, prepara un commit descriptivo.

Con este método no necesitas aceptar una aplicación completa generada en un único turno. El proyecto crece mediante pasos que puedes entender, ejecutar y revisar.

Claude Code en terminal, VS Code, Cursor, JetBrains, escritorio y web

Claude Code no está limitado a la terminal. Puedes utilizar el mismo motor desde distintos entornos según el tipo de trabajo.

Usar Claude Code en VS Code

La extensión oficial de VS Code integra Claude Code dentro del editor y facilita revisar diffs, mencionar archivos y seguir planes sin cambiar continuamente entre ventanas. Puedes instalar Claude Code desde Visual Studio Marketplace.

Después de instalar la extensión, abre la paleta de comandos y busca Claude Code para iniciar una sesión.

Usar Claude Code en Cursor

Claude Code también puede utilizarse desde Cursor mediante la extensión compatible. Abre el panel de extensiones de Cursor y busca Claude Code. Como referencia, la extensión oficial de Anthropic para editores compatibles está publicada en Visual Studio Marketplace.

Esto permite mantener el editor como entorno principal mientras Claude trabaja sobre el proyecto.

Usar Claude Code en JetBrains

Existe una integración oficial para IDE como IntelliJ IDEA, PyCharm, WebStorm, PhpStorm o GoLand. Puedes instalar el plugin de Claude Code desde JetBrains Marketplace. El plugin trabaja junto con la CLI de Claude Code, por lo que conviene tenerla instalada previamente.

Cómo usar Claude Code desde la app de Claude

Claude Code también está integrado en Claude Desktop. Esta opción resulta especialmente interesante si prefieres una interfaz visual o quieres mantener varias tareas de programación abiertas a la vez sin trabajar únicamente desde la terminal.

La aplicación de escritorio está disponible para macOS y Windows, y Anthropic ofrece también una versión para Linux. El acceso a Claude Code dentro de la app depende del plan: está disponible en los planes de pago compatibles.

1. Instala y abre Claude Desktop

Entra en la página oficial de descarga de Claude, elige la versión para tu sistema operativo, instálala e inicia sesión con la cuenta que tenga acceso a Claude Code. Si ya utilizas Claude Desktop, actualízala antes de continuar para disponer de las funciones más recientes.

2. Entra en la pestaña Code

Dentro de la aplicación, abre Code. Desde ahí puedes iniciar una nueva sesión de Claude Code o recuperar sesiones anteriores.

La interfaz de escritorio está pensada para gestionar varias tareas simultáneamente. La barra lateral permite ver las sesiones activas y recientes, cambiar entre proyectos y volver a una tarea cuando Claude termina una parte del trabajo.

3. Abre el proyecto con el que quieres trabajar

Al iniciar una sesión local, selecciona el proyecto o carpeta sobre la que Claude debe trabajar. A partir de ahí puede explorar los archivos del proyecto igual que en la CLI, sujeto a los permisos que hayas configurado.

Una buena primera instrucción sería:

Analiza este proyecto y explícame:  - qué hace,  - qué tecnologías utiliza,  - cómo está organizado,  - cuáles son los puntos de entrada principales.    No modifiques ningún archivo todavía.

La idea es la misma que en terminal: primero entender el contexto y después pedir cambios.

4. Utiliza varias sesiones si las tareas son independientes

Una de las ventajas más claras de la aplicación es poder mantener varias sesiones de Claude Code en paralelo. Por ejemplo, puedes dejar una sesión trabajando en una refactorización, abrir otra para corregir un bug distinto y utilizar una tercera para preparar tests.

No conviene dividir artificialmente una tarea pequeña. El trabajo en paralelo tiene sentido cuando las tareas pueden avanzar de manera relativamente independiente y no van a modificar continuamente los mismos archivos.

5. Utiliza el terminal y el editor integrados

Claude Desktop incorpora herramientas para seguir el trabajo sin salir de la aplicación. Puedes abrir una terminal junto a la sesión para ejecutar comandos, tests o builds y también inspeccionar o realizar pequeños cambios sobre los archivos desde el editor integrado.

Esto resulta útil cuando quieres comprobar manualmente algo que Claude acaba de hacer:

npm test  npm run lint  git status

La ventaja no es que Claude deje de ejecutar estas acciones por sí mismo, sino que tú puedes observar el proyecto y realizar verificaciones adicionales sin cambiar continuamente de aplicación.

6. Revisa los cambios en el diff antes de aceptarlos

La aplicación incluye una vista de diferencias para revisar qué líneas se han añadido, eliminado o modificado. Antes de dar una tarea por terminada, comprueba que el cambio se limita al alcance previsto.

También puedes pedir una revisión adicional:

Revisa el diff actual antes de que integremos los cambios.    Busca errores funcionales, cambios fuera de alcance, problemas de seguridad y código innecesario. No modifiques nada hasta terminar la revisión.

7. Previsualiza la aplicación mientras Claude trabaja

Cuando trabajas con una aplicación web, Claude Code en escritorio puede iniciar el servidor de desarrollo y mostrar una previsualización de la aplicación dentro de la propia interfaz. Claude puede observar esa vista, leer los registros de la consola y seguir iterando si encuentra un error.

Esto permite trabajar sobre problemas visuales con instrucciones muy concretas. Por ejemplo:

Abre la vista de la aplicación y comprueba el formulario de registro.    El botón se sale del contenedor en pantallas pequeñas. Corrige únicamente ese problema y verifica el resultado en la previsualización.

En determinados flujos también puedes señalar elementos de la previsualización para contextualizar mejor lo que quieres cambiar.

8. Utiliza la revisión de código antes de publicar los cambios

La aplicación permite lanzar una revisión sobre los cambios locales. Claude analiza el diff y puede dejar observaciones relacionadas con bugs, mantenibilidad u otros problemas detectados antes de que el código salga de tu equipo.

Después puedes revisar esos comentarios y decidir cuáles debe corregir:

Aplica únicamente las correcciones relacionadas con los comentarios 1 y 3. No cambies el resto.

9. Sigue el estado de una pull request desde la aplicación

Si el proyecto está alojado en GitHub y tienes configurado el flujo necesario, Claude Code puede seguir el estado de una pull request, incluidas las comprobaciones de integración continua. La aplicación puede mostrar si los checks pasan o fallan y ayudarte a investigar los fallos.

Anthropic también permite configurar automatizaciones para intentar corregir fallos de CI e incluso fusionar una pull request cuando todas las comprobaciones pasan. Estas opciones conviene utilizarlas con especial cuidado en repositorios importantes y de acuerdo con las reglas del equipo.

10. Continúa una sesión de terminal en Desktop

No tienes que elegir para siempre entre CLI y aplicación. Si has iniciado una sesión local desde la terminal, puedes llevar ese contexto a Claude Desktop mediante:

/desktop

Así puedes comenzar investigando en la CLI y continuar después en la interfaz visual para revisar cambios, trabajar con varias sesiones o utilizar la previsualización.

Cuándo elegir la app y cuándo la terminal

Ambas superficies utilizan Claude Code, por lo que no son dos herramientas diferentes. Puedes empezar en la terminal, continuar en Desktop y utilizar la web cuando necesites mover una sesión a otro entorno.

Claude Code en la web

Puedes abrir Claude Code directamente en la web. Esta versión permite ejecutar tareas sobre repositorios sin tener que mantener una sesión local abierta. Puede ser útil para trabajos largos o para ejecutar varias tareas en paralelo y volver a revisarlas después.

Para aprender bien la herramienta merece la pena entender primero el flujo de terminal o IDE. Después puedes elegir la superficie que encaje mejor con cada tarea.

CLAUDE.md: cómo darle contexto permanente a Claude Code

CLAUDE.md es uno de los archivos más importantes cuando utilizas Claude Code de forma habitual. Sirve para guardar instrucciones que deben estar disponibles al comenzar cada sesión, de modo que no tengas que repetirlas en cada prompt.

Puedes utilizarlo para documentar:

• Comandos de build, test y lint
• Convenciones de código específicas del proyecto
• Decisiones de arquitectura
• Reglas sobre dependencias
• Forma de nombrar ramas y commits
• Restricciones que Claude no puede deducir leyendo el código
• Comportamientos que quieres mantener en todas las tareas.

Crear el archivo inicial

Dentro de una sesión puedes utilizar:

/init

Claude Code puede analizar la estructura del proyecto y generar una primera versión de CLAUDE.md. Después conviene revisarla y eliminar cualquier información redundante.

Ejemplo de CLAUDE.md

# Proyecto    Aplicación web con React, TypeScript y Node.js.    ## Comandos  - Desarrollo: `npm run dev`  - Tests: `npm test`  - Typecheck: `npm run typecheck`  - Lint: `npm run lint`    ## Reglas  - Utiliza TypeScript estricto.  - No añadas dependencias nuevas sin justificarlo primero.  - Mantén los componentes pequeños y reutilizables.  - Respeta la estructura actual del proyecto.  - No modifiques archivos no relacionados con la tarea.    ## Validación  - Ejecuta los tests relacionados después de modificar lógica.  - Ejecuta typecheck antes de dar una tarea por terminada.  - Revisa el diff antes de preparar un commit.

No conviertas CLAUDE.md en un manual enorme

El archivo se carga de forma persistente, por lo que meter documentación irrelevante consume contexto y puede hacer que las instrucciones realmente importantes pierdan peso. Como regla práctica, guarda aquí aquello que Claude debería conocer siempre y mueve los procedimientos largos o específicos a Skills u otras reglas.

Si repites una corrección en varias sesiones, probablemente deba convertirse en una instrucción de CLAUDE.md. Si una instrucción solo sirve para una tarea concreta, probablemente no.

Prompts útiles para programar con Claude Code

Claude Code ya tiene acceso al proyecto, pero eso no significa que cualquier instrucción produzca un buen resultado. Los mejores prompts suelen definir el objetivo, el alcance, las restricciones y la forma de comprobar el trabajo.

Una buena práctica consiste en pedir primero análisis o plan cuando existe incertidumbre y reservar la edición para cuando el alcance esté suficientemente claro.

Cómo depurar errores con Claude Code

Claude Code resulta especialmente útil para debugging porque puede relacionar el error con la base de código, ejecutar comandos y comprobar hipótesis sin que tengas que copiar cada archivo por separado.

1. Describe el comportamiento, no solo “no funciona”

Indica:

• Qué estabas intentando hacer
• Qué esperabas que ocurriera
• Qué sucede realmente
• El mensaje de error si existe
• Cómo reproducir el problema
• Qué cambios recientes podrían estar relacionados.

2. Pide diagnóstico antes que corrección

Investiga este fallo.    Primero reproduce el problema y localiza la causa raíz.  No modifiques código hasta que puedas explicar:  - qué está fallando,  - por qué,  - qué evidencia lo demuestra.

Esto reduce el riesgo de que Claude empiece a cambiar código basándose en una hipótesis incorrecta.

3. Corrige lo mínimo necesario

Aplica la corrección más pequeña que resuelva la causa raíz.    No refactorices otras partes del sistema y no cambies comportamiento no relacionado.

4. Añade una prueba de regresión

Si el proyecto tiene tests, el arreglo debería incluir una prueba que falle antes de la corrección y pase después cuando sea razonable hacerlo.

Añade una prueba que reproduzca este bug para evitar que vuelva a aparecer. Ejecuta esa prueba y las relacionadas.

5. Comprueba que no has introducido otro problema

Después del arreglo, ejecuta las validaciones relevantes y revisa el diff. Un error corregido con una modificación innecesariamente amplia puede acabar creando otros fallos.

Cómo trabajar con Git y GitHub en Claude Code

Claude Code puede utilizar Git como parte natural del flujo de desarrollo. Aun así, conviene mantener el mismo criterio que tendrías trabajando sin IA: ramas claras, commits revisados y cambios pequeños cuando sea posible.

Consultar cambios

¿Qué archivos están modificados y qué cambia en cada uno?

Revisar antes de hacer commit

Revisa el diff completo y señala cualquier cambio que no esté directamente relacionado con la tarea actual.

Crear una rama

Crea una rama llamada feature/nombre-descriptivo para esta tarea.

Preparar un commit

Prepara un commit únicamente con los cambios relacionados con esta funcionalidad y utiliza un mensaje descriptivo.

Resolver conflictos

Claude Code también puede ayudarte a interpretar conflictos de merge y entender qué intención tenía cada versión. En estos casos es especialmente importante que conozcas el comportamiento esperado antes de aceptar una resolución automática.

Pull requests y revisión

En flujos conectados con GitHub o GitLab, Claude Code puede colaborar con tareas como preparar cambios, abrir solicitudes de extracción y participar en procesos de revisión. Para equipos, esto permite incorporar la IA a procesos ya existentes en lugar de crear un flujo paralelo fuera del repositorio.

MCP: conectar Claude Code con otras herramientas

MCP, Model Context Protocol, permite conectar Claude Code con servicios y fuentes externas. La idea es que el agente no dependa únicamente de los archivos locales y pueda consultar o utilizar herramientas adicionales cuando una tarea lo requiera.

Por ejemplo, un servidor MCP puede permitir acceso a:

• Repositorios y plataformas de desarrollo
• Gestores de incidencias
• Bases de datos
• Documentación interna
• Servicios de comunicación
• Herramientas propias de una empresa.

Comprobar los servidores MCP configurados

Desde la terminal puedes consultar la configuración:

claude mcp list

Y dentro de Claude Code:

/mcp

Añadir un servidor MCP

La sintaxis dependerá del transporte y del servidor concreto. Como estructura general:

claude mcp add --transport http NOMBRE --scope project URL_DEL_SERVIDOR_MCP

Cuando utilizas alcance de proyecto, la configuración compartida puede almacenarse en .mcp.json en la raíz del repositorio.

Verificar una conexión

claude mcp get NOMBRE

Antes de incorporar un servidor MCP a un repositorio, revisa qué herramientas expone, qué datos puede consultar y qué acciones permite realizar. Conectar más servicios no siempre mejora el flujo. Añade únicamente aquellos que realmente necesita el proyecto.

Skills: guardar flujos de trabajo reutilizables

Las Skills sirven para convertir instrucciones, conocimientos o procedimientos repetitivos en capacidades reutilizables. Son especialmente útiles cuando te descubres escribiendo el mismo prompt de varios pasos una y otra vez.

Una Skill de proyecto puede vivir en una estructura como esta:

.claude/  └── skills/      └── review-pr/          └── SKILL.md

Por ejemplo, podrías crear una Skill para revisar una pull request siguiendo siempre los mismos criterios:

---  name: review-pr  description: Revisa los cambios de una rama antes de abrir una pull request  ---    Revisa el diff de la rama actual.    Comprueba:  1. errores funcionales,  2. cambios fuera de alcance,  3. cobertura de tests,  4. riesgos de seguridad,  5. código duplicado,  6. documentación que haya quedado desactualizada.    No modifiques archivos. Devuelve los hallazgos ordenados por importancia.

Después puedes invocarla desde Claude Code mediante el comando asociado a su nombre:

/review-pr

La diferencia respecto a CLAUDE.md es importante. CLAUDE.md contiene contexto que debe estar disponible en todas las sesiones. Las Skills son más adecuadas para procedimientos concretos que solo necesitas en determinados momentos.

Hooks: automatizar acciones de Claude Code

Los Hooks permiten ejecutar acciones cuando ocurre un evento determinado dentro de Claude Code. Pueden servir para aplicar controles, lanzar herramientas o automatizar tareas que quieres ejecutar siempre bajo unas condiciones concretas.

Algunos ejemplos:

• Ejecutar lint después de que Claude edite un archivo
• Aplicar un formateador
• Bloquear determinados comandos
• Registrar operaciones
• Lanzar comprobaciones antes de cerrar una tarea
• Mostrar una notificación cuando termina un proceso largo.

Ejemplo: ejecutar una comprobación después de editar archivos

En la configuración del proyecto puedes crear un Hook PostToolUse que se active después de operaciones de edición:

{    "hooks": {      "PostToolUse": [        {          "matcher": "Edit|Write",          "hooks": [            {              "type": "command",              "command": "npm run lint"            }          ]        }      ]    }  }

Este tipo de automatización es útil cuando una comprobación debe ejecutarse de forma consistente y no quieres depender de recordar el mismo prompt en cada sesión.

No conviertas todos los pasos del desarrollo en Hooks. Los Hooks encajan mejor con automatizaciones deterministas. Si el procedimiento necesita razonamiento, contexto o varias decisiones, probablemente una Skill o un subagente sea más apropiado.

Subagentes, agentes paralelos y worktrees

Cuando una tarea se vuelve grande, Claude Code puede dividir trabajo utilizando contextos separados. Esto permite investigar diferentes partes de un problema sin llenar la conversación principal con todos los detalles.

Subagentes

Un subagente es un trabajador especializado con su propio contexto. Puede encargarse, por ejemplo, de revisar seguridad, estudiar la arquitectura de un módulo o investigar un problema concreto y devolver después un resumen a la sesión principal.

Son útiles cuando:

• Una investigación exige leer muchos archivos
• Quieres separar la revisión de la implementación
• Necesitas un agente especializado con instrucciones propias
• Quieres evitar llenar el contexto principal con detalles intermedios.

Agentes en paralelo

Para tareas suficientemente grandes, diferentes agentes pueden trabajar en partes distintas. Por ejemplo, uno puede investigar el backend, otro revisar el frontend y otro analizar los tests.

El trabajo paralelo no mejora automáticamente cualquier tarea. Dividir un cambio pequeño entre varios agentes puede añadir coordinación innecesaria y hacer más difícil entender qué está ocurriendo.

Worktrees para aislar cambios

Git worktree permite disponer de varias copias de trabajo del mismo repositorio en ramas separadas. Claude Code puede aprovechar este enfoque para ejecutar sesiones paralelas sin que los cambios se pisen entre sí.

Por ejemplo:

claude --worktree feature-auth

Este patrón puede ser útil cuando quieres que una sesión trabaje en una funcionalidad mientras otra investiga un bug diferente.

Permisos y seguridad en Claude Code

Claude Code puede editar archivos y ejecutar comandos, por lo que merece la pena entender los permisos antes de utilizarlo con proyectos importantes.

Revisa el modo de permisos

Puedes consultar y modificar permisos con:

/permissions

También puedes cambiar de modo durante una sesión con Shift+Tab.

En determinadas suscripciones, el modo Auto puede gestionar muchas aprobaciones mediante un clasificador de seguridad. Eso reduce interrupciones, pero no convierte la revisión humana en innecesaria. Para tareas sensibles puedes utilizar un modo más restrictivo o Plan Mode antes de permitir modificaciones.

No compartas secretos innecesariamente

Evita incorporar contraseñas, tokens o claves directamente en archivos del repositorio. Utiliza variables de entorno y los mecanismos de secretos apropiados para el proyecto.

Ten especial cuidado con comandos destructivos

Operaciones sobre infraestructura, bases de datos, despliegues, eliminación de archivos o migraciones necesitan un nivel de revisión mayor que una modificación local de código.

Utiliza Git como red de seguridad

Trabajar sobre una rama limpia y revisar el diff antes de integrar cambios facilita revertir una decisión incorrecta. La IA acelera el desarrollo, pero también puede acelerar un error si le das demasiado alcance sin puntos de control.

No confundas una prueba que pasa con una solución correcta

Los tests son una señal importante, no una garantía absoluta. Revisa comportamiento, seguridad, mantenibilidad y alcance igual que harías con código escrito por otra persona.

Errores habituales al usar Claude Code

• Pedir una tarea grande sin dejar que explore el proyecto. Claude puede implementar una solución correcta para una interpretación equivocada del problema.
• Aceptar el primer plan sin revisarlo. La planificación solo es útil si compruebas que respeta la arquitectura y las restricciones reales.
• Dar demasiado alcance. Si quieres corregir un bug, evita pedir a la vez que modernice, refactorice y reorganice todo el módulo.
• No definir cómo verificar el resultado. Siempre que sea posible, indica qué test, build, typecheck o comportamiento debe demostrar que la tarea está terminada.
• No revisar el diff. Un cambio puede funcionar y aun así tocar archivos innecesarios.
• Llenar CLAUDE.md de documentación. Las instrucciones persistentes deben ser cortas y relevantes para todas las sesiones.
• Instalar dependencias sin criterio. Antes de añadir una librería, comprueba si el proyecto ya tiene una forma de resolver el mismo problema.
• Guardar secretos en el repositorio. No utilices el contexto del proyecto como almacén de credenciales.
• Automatizar demasiado pronto. MCP, Hooks, Skills y subagentes son útiles cuando resuelven un problema real. No hace falta configurar todo el ecosistema el primer día.
• Utilizar varios agentes para tareas pequeñas. La coordinación tiene un coste. Empieza con una sola sesión y divide el trabajo únicamente cuando tenga sentido.
• No limpiar el contexto. Si una conversación muy larga ha acumulado decisiones que ya no son válidas, puede ser mejor resumir, limpiar o abrir una sesión nueva.
• Delegar decisiones que no has definido. Claude puede proponer una solución, pero debes decidir qué comportamiento quieres en los puntos donde los requisitos son ambiguos.

Cuánto cuesta Claude Code

A fecha de septiembre de 2026, Claude Code está incluido en los planes de pago individuales de Claude y también puede utilizarse mediante planes de equipo, empresa o una cuenta de Claude Console con facturación por uso.

Los límites y precios pueden cambiar, por lo que conviene comprobar las condiciones vigentes antes de contratar un plan. Para un uso ocasional o proyectos pequeños, Pro puede ser suficiente. Un uso intensivo sobre repositorios grandes consume más capacidad y puede requerir un plan superior o facturación por consumo.

Claude o Claude Code: cuál usar para programar

No son herramientas excluyentes. La elección depende de la tarea.

Para aprender programación, Claude puede ser un tutor muy útil. Para desarrollar sobre una base de código, Claude Code ofrece un flujo mucho más cercano al trabajo real de un desarrollador.

Estudiar Claude en FP oficial con XFP

En XFP, Claude forma parte de la especialización en inteligencia artificial aplicada a los ciclos tecnológicos. El objetivo no es utilizarlo como un simple generador de código, sino aprender a incorporarlo a tareas profesionales de desarrollo, sistemas, automatización y resolución de problemas.

Claude en Administración de Sistemas Informáticos en Red (ASIR)

En ASIR, Claude se aplica al diagnóstico de incidencias, el análisis de logs, la generación de scripts en PowerShell, Bash o Python y la automatización de tareas. También puede servir de apoyo en la configuración de sistemas, redes y servidores.

Puedes estudiar el Grado Superior en ASIR en Madrid o el Grado Superior en ASIR online.

Claude en Desarrollo de Aplicaciones Multiplataforma (DAM)

En DAM, Claude se integra en tareas como el análisis de arquitectura, la revisión de código, el pair programming, el desarrollo de aplicaciones y la generación de documentación técnica. Así, el alumnado aprende a combinar programación e IA dentro de un flujo de trabajo orientado al desarrollo de software.

Puedes cursar el Grado Superior en DAM en Madrid o el Grado Superior en DAM online.

Claude en Desarrollo de Aplicaciones Web (DAW)

En DAW, Claude se utiliza como apoyo en el desarrollo frontend y backend, la creación de APIs, el debugging y la revisión de la arquitectura de aplicaciones web. El objetivo es que el alumnado aprenda a utilizar la IA dentro de proyectos reales y con las tecnologías habituales del desarrollo web.

Puedes estudiar el Grado Superior en DAW en Madrid o el Grado Superior en DAW online.

En los ciclos tecnológicos de XFP, aprender a trabajar con Claude complementa la formación técnica con competencias de inteligencia artificial aplicadas al entorno profesional, preparando al alumnado para utilizar estas herramientas con criterio dentro de su futura profesión.

Si te ha gustado este artículo te interesará saber cómo se usa la IA en otros ámbitos formativos de XFP, como el marketing: Cómo usar Google Nano Banana para creatividad publicitaria