Claude Code: qué es, cómo funciona y cómo usarlo desde cero
Claude Code es la herramienta de programación agéntica de Anthropic. Puede leer un proyecto completo, modificar archivos, ejecutar comandos, buscar errores, escribir pruebas, trabajar con Git y conectarse con herramientas externas mientras colaboras con Claude directamente sobre tu código.
¿Qué es Claude Code?
Claude Code es un agente de programación con IA desarrollado por Anthropic. A diferencia de un chatbot que solo responde preguntas, Claude Code puede explorar tu repositorio, leer varios archivos, editar código, ejecutar comandos, correr pruebas, usar Git y completar tareas de desarrollo de varios pasos. Puede utilizarse desde terminal, VS Code, otros entornos compatibles, escritorio y web.
Qué puede hacer Claude Code
Su principal diferencia frente a un asistente tradicional es que puede actuar directamente sobre un proyecto.
Escribir código
Crear nuevas funciones, componentes, endpoints y archivos completos dentro de un proyecto.
Corregir errores
Investigar un problema, localizar su causa y aplicar cambios en los archivos implicados.
Ejecutar pruebas
Crear tests, ejecutar suites existentes y corregir problemas encontrados durante la validación.
Trabajar con Git
Revisar cambios, preparar commits, crear ramas y colaborar con flujos basados en repositorios.
Conectar herramientas
Integrarse mediante MCP con servicios, bases de datos y herramientas externas utilizadas por tu equipo.
Delegar tareas
Ejecutar flujos de varios pasos y utilizar agentes especializados para dividir trabajos complejos.
Cómo funciona Claude Code
Claude Code no se limita a producir fragmentos de código: puede investigar el proyecto, decidir cómo abordar la tarea y verificar el resultado.
Entiende el proyecto
Lee archivos, estructura, dependencias, configuración e instrucciones del repositorio.
Realiza el trabajo
Modifica archivos, crea código y ejecuta herramientas necesarias para completar la tarea.
Comprueba el resultado
Puede ejecutar pruebas, revisar errores y continuar iterando antes de presentar el trabajo terminado.
Claude Code es más que un autocompletado de código
Un autocompletado tradicional predice o propone código dentro del archivo actual. Claude Code puede trabajar sobre tareas más amplias.
Puede trabajar en varios archivos y herramientas
Por ejemplo, puedes pedirle investigar cómo funciona un sistema de autenticación, encontrar un error, modificar los archivos necesarios, ejecutar las pruebas y comprobar si la solución funciona.
No necesitas copiar manualmente cada archivo al chat. Claude Code puede explorar directamente el proyecto al que le has dado acceso.
Claude Code no funciona solo en la terminal
Anthropic ofrece actualmente varias formas de trabajar con el mismo sistema de programación agéntica.
| Entorno | Uso principal |
|---|---|
| Terminal | CLI completa para trabajar directamente con proyectos locales |
| VS Code | Integración visual dentro del editor de código |
| JetBrains | Integración con IDE como IntelliJ, PyCharm y WebStorm |
| Desktop | Interfaz gráfica para ejecutar sesiones y revisar cambios |
| Web | Ejecutar tareas sin configurar localmente el entorno |
Cómo empezar con Claude Code
Para trabajar desde terminal primero debes instalar Claude Code y autenticar tu cuenta.
Instalación nativa
curl -fsSL https://claude.ai/install.sh | bashInstalación en Windows
irm https://claude.ai/install.ps1 | iexLa instalación, Windows, WSL, Homebrew, WinGet, actualizaciones y solución de errores tendrán su propia guía para evitar sobrecargar esta página pilar.
Cómo instalar Claude Code →Cómo abrir Claude Code en un proyecto
Después de instalarlo, entra al directorio del proyecto y ejecuta Claude.
Iniciar Claude Code
cd mi-proyecto
claudeSi todavía no estás autenticado, Claude Code inicia el proceso de acceso a tu cuenta antes de comenzar la sesión.
Qué puedes pedirle en tu primera sesión
Puedes empezar dejando que Claude conozca el proyecto antes de modificar nada.
Analizar el proyecto
Analiza este proyecto.
Explícame:
- qué arquitectura utiliza
- cuáles son los archivos principales
- cómo se ejecuta
- qué dependencias importantes tiene
- qué partes debería entender antes de modificarlo
No realices cambios todavía.Qué es CLAUDE.md
Uno de los archivos
más importantes
del ecosistema
de Claude Code
es CLAUDE.md.
Instrucciones persistentes para el proyecto
Puedes utilizar
CLAUDE.md
para indicar comandos
de compilación,
estándares de código,
decisiones arquitectónicas,
librerías preferidas,
convenciones
y reglas importantes
del repositorio.
# Proyecto
## Stack
- PHP 8+
- MySQL
- JavaScript
- Bootstrap
## Reglas
- Utilizar PDO para consultas SQL
- No modificar archivos del core
- Sanitizar toda entrada del usuario
- Mantener compatibilidad responsive
## Pruebas
Ejecutar las pruebas antes de finalizar cambios.
El comando
/init
analiza el repositorio
y propone un archivo
CLAUDE.md inicial.
Planificar antes de modificar el código
Claude Code dispone de un modo especialmente útil cuando quieres revisar una estrategia antes de permitir cambios.
Claude investiga pero no edita el proyecto
En Plan Mode, Claude puede leer archivos y explorar el proyecto para elaborar un plan, pero no modifica el código fuente hasta que apruebes continuar.
claude --permission-mode planEs especialmente recomendable para refactorizaciones, cambios arquitectónicos, migraciones o tareas donde primero quieras entender exactamente qué hará el agente.
Ver Plan Mode →Claude Code Skills: instrucciones reutilizables
Los Skills permiten convertir procedimientos repetitivos en capacidades reutilizables.
Crear procedimientos que Claude puede reutilizar
Un Skill puede contener instrucciones para revisar código, desplegar una aplicación, comprobar seguridad, preparar una release o realizar cualquier flujo repetitivo de tu equipo.
CLAUDE.md contiene contexto y reglas generales del proyecto. Un Skill está pensado para procedimientos o capacidades específicas que se cargan cuando son necesarias.
Claude Code puede delegar trabajo a otros agentes
Las tareas complejas no tienen por qué ejecutarse todas dentro del mismo contexto.
Explorar código
Un subagente puede investigar una parte concreta del proyecto y devolver conclusiones.
Revisar cambios
Puedes crear agentes especializados en seguridad, testing o revisión de código.
Trabajar en paralelo
Diferentes agentes pueden abordar distintas partes de una tarea de forma paralela.
Conectar Claude Code con herramientas externas
Claude Code soporta Model Context Protocol, conocido como MCP.
Ampliar el contexto más allá del repositorio
Mediante servidores MCP, Claude Code puede conectarse con herramientas externas autorizadas y utilizar datos o acciones relevantes para una tarea.
Sistemas de gestión de proyectos y tickets.
Repositorios y herramientas de desarrollo.
Bases de datos y servicios internos.
Documentación y otras fuentes de información.
Qué son los Hooks de Claude Code
Los Hooks permiten ejecutar acciones automáticas cuando se producen determinados eventos.
Automatizar reglas alrededor del agente
Puedes utilizarlos, por ejemplo, para ejecutar un formateador después de editar archivos, validar código o lanzar comprobaciones alrededor de acciones realizadas por Claude.
Extender Claude Code mediante plugins
Los plugins permiten empaquetar funcionalidades que pueden compartirse entre proyectos y equipos.
Skills, agentes, hooks y MCP en un paquete
Un plugin puede incluir Skills, agentes personalizados, Hooks y configuraciones MCP, facilitando su distribución y reutilización.
Claude Code puede trabajar directamente con Git
El agente puede utilizar el historial y los cambios del repositorio como parte de su trabajo.
Revisar cambios
Puede analizar diferencias entre archivos y explicar qué ha cambiado.
Preparar commits
Puede crear mensajes descriptivos basándose en los cambios realizados.
Pull requests
Puede integrarse en flujos de revisión y colaboración basados en Git.
Comandos útiles para empezar con Claude Code
No necesitas memorizar decenas de comandos, pero algunos aparecen constantemente en el flujo de trabajo.
| Comando | Función |
|---|---|
claude |
Iniciar una sesión en el proyecto actual |
claude --version |
Comprobar la versión instalada |
claude doctor |
Revisar instalación y configuración |
/help |
Mostrar ayuda y comandos disponibles |
/init |
Crear una base para CLAUDE.md |
/sandbox |
Configurar el entorno aislado para comandos |
Claude Code utiliza un sistema de permisos
Dar acceso a un agente al código y a la terminal requiere controles de seguridad claros.
Tú controlas las acciones sensibles
Claude Code utiliza permisos para controlar herramientas y acciones. Las operaciones que implican modificaciones o comandos pueden requerir aprobación según la configuración elegida.
Aunque Claude Code pueda completar tareas de forma autónoma, el desarrollador sigue siendo responsable de revisar código, comandos y cambios importantes antes de utilizarlos en producción.
Ejecutar comandos dentro de límites definidos
Claude Code dispone de capacidades de sandboxing para restringir el acceso de comandos al sistema de archivos y a la red.
Más autonomía dentro de un entorno limitado
El objetivo del sandbox es permitir que Claude ejecute más acciones dentro de límites previamente establecidos, reduciendo al mismo tiempo la necesidad de aprobar constantemente comandos seguros.
Claude vs Claude Code
Ambos utilizan modelos de Claude, pero la experiencia y las herramientas disponibles son diferentes.
| Aspecto | Claude | Claude Code |
|---|---|---|
| Chat general | Sí | Sí, orientado al trabajo técnico |
| Leer repositorio local | No de forma directa | Sí |
| Editar archivos del proyecto | No directamente | Sí |
| Ejecutar comandos | No como terminal local | Sí |
| Ejecutar tests del proyecto | No directamente | Sí |
| Git local | No directamente | Sí |
| CLAUDE.md | No es el flujo principal | Sí |
Casos de uso de Claude Code
Desarrollar funciones: implementar funcionalidades nuevas en proyectos existentes.
Corregir bugs: investigar errores y aplicar soluciones en varios archivos.
Refactorizar: reorganizar código manteniendo el comportamiento esperado.
Crear tests: detectar áreas sin cobertura y añadir pruebas.
Actualizar dependencias: investigar incompatibilidades y adaptar el proyecto.
Documentar: comprender código existente y generar documentación técnica.
Revisión: analizar cambios, riesgos y posibles errores.
Automatización: integrar tareas repetitivas dentro del flujo de desarrollo.
¿Se puede utilizar Claude Code con WordPress?
Sí. Si tienes acceso a los archivos de un proyecto WordPress, Claude Code puede trabajar sobre themes, plugins y código personalizado.
Desarrollar plugins
Crear estructuras, hooks, endpoints, shortcodes y funcionalidades personalizadas.
Investigar errores
Revisar logs, PHP, JavaScript y conflictos dentro del proyecto.
Mejorar código existente
Analizar plugins propios y reorganizar funcionalidades manteniendo buenas prácticas.
Requisitos básicos para utilizar Claude Code
Los requisitos dependen del entorno desde el que quieras trabajar.
| Requisito | Referencia |
|---|---|
| Sistema operativo | macOS, Windows o distribuciones Linux compatibles |
| Arquitectura | x64 o ARM64 |
| RAM | 4 GB o más |
| Internet | Requerido |
| Shell | Bash, Zsh, PowerShell o CMD |
Claude Code puede ejecutarse de forma nativa en Windows o dentro de WSL, dependiendo del proyecto y del entorno que necesites.
¿Claude Code es gratis?
Claude Code requiere actualmente una modalidad de acceso compatible.
Planes de pago o Anthropic Console
La documentación actual contempla acceso mediante cuentas Pro, Max, Team, Enterprise o Anthropic Console. El plan gratuito de Claude.ai no incluye actualmente Claude Code.
Por eso dedicaremos una guía independiente al precio, consumo, planes y diferencias entre suscripción y uso mediante API.
Cuándo conviene utilizar Claude Code
Trabajas con un proyecto real
Necesitas que la IA comprenda varios archivos y la estructura del repositorio.
Quieres delegar tareas
Prefieres describir el objetivo y permitir que el agente investigue cómo realizarlo.
Necesitas verificar resultados
El trabajo requiere modificar código, ejecutar tests y corregir fallos durante el proceso.
Cuándo un chat puede ser suficiente
No todas las consultas de programación necesitan un agente conectado al repositorio.
Pregunta conceptual
Si solo quieres entender una tecnología, un chat puede ser suficiente.
Fragmento pequeño
Para corregir unas pocas líneas quizás no necesites acceso completo al proyecto.
Planificación inicial
Puedes definir primero arquitectura, requisitos y enfoque antes de abrir el repositorio.
Cómo obtener mejores resultados con Claude Code
Explica claramente qué resultado necesitas.
Indica restricciones antes de comenzar.
Utiliza CLAUDE.md para reglas persistentes.
Usa Plan Mode antes de cambios importantes.
Pide ejecutar pruebas antes de dar una tarea por finalizada.
Revisa el diff antes de llevar cambios a producción.
Documentación oficial de Claude Code
Claude Code evoluciona rápidamente, por lo que conviene consultar la documentación oficial antes de configurar funciones avanzadas.
Claude Code Docs
Documentación sobre instalación, configuración, comandos y flujos de trabajo.
Ver documentación oficial →Configuración
Requisitos, instalación, autenticación y administración de Claude Code.
Ver configuración oficial →Continúa aprendiendo Claude Code
Esta guía funciona como página pilar. Puedes profundizar cada función en las siguientes guías.
FAQ sobre Claude Code
Respuestas sobre instalación, funcionamiento, programación, CLAUDE.md, Plan Mode, MCP, seguridad y acceso.
Claude Code es la herramienta de programación agéntica de Anthropic. Puede leer proyectos, editar archivos, ejecutar comandos y completar tareas de desarrollo de varios pasos.
No. Claude Code puede utilizarse desde terminal, extensiones para IDE, la aplicación de escritorio y la web.
Sí. Claude Code puede ejecutarse de forma nativa en Windows o utilizarse dentro de WSL.
CLAUDE.md es un archivo de instrucciones que permite proporcionar contexto persistente sobre estándares, arquitectura, comandos y convenciones de un proyecto.
Plan Mode permite que Claude investigue el proyecto y prepare un plan sin modificar el código fuente hasta que el usuario apruebe continuar.
Los Skills permiten guardar procedimientos e instrucciones reutilizables que Claude puede cargar cuando resultan relevantes para una tarea.
Sí. Claude Code soporta Model Context Protocol para conectarse con herramientas y fuentes externas mediante servidores MCP.
Sí. Claude Code puede utilizar herramientas de shell para ejecutar comandos, pruebas, scripts y otras tareas, sujeto a permisos y configuración.
El plan gratuito de Claude.ai no incluye actualmente Claude Code. El acceso está disponible mediante modalidades compatibles como Pro, Max, Team, Enterprise o Anthropic Console.
Sí. Claude Code puede trabajar con proyectos WordPress y ayudar a desarrollar o revisar themes, plugins, PHP, JavaScript y código personalizado.
Instala Claude Code paso a paso
Ya conoces qué es Claude Code, cómo funciona y las principales herramientas de su ecosistema. El siguiente paso es instalarlo correctamente en Windows, macOS, Linux o WSL y ejecutar tu primera sesión.
Cómo instalar Claude Code →