Cómo usar Claude Code: tutorial paso a paso desde cero
Aprende cómo usar Claude Code para analizar proyectos, encontrar código, modificar archivos, ejecutar comandos, corregir errores, crear tests, trabajar con Git y delegar tareas completas de programación sin perder el control sobre los cambios realizados por el agente.
¿Cómo se usa Claude Code?
Para usar Claude Code,
abre una terminal en la carpeta de tu proyecto
y ejecuta claude.
Después puedes pedirle que analice el repositorio,
encuentre archivos, explique cómo funciona una función,
prepare un plan, modifique código,
ejecute tests y compruebe el resultado.
Para cambios importantes conviene seguir el flujo
explorar → planificar → implementar → verificar.
Qué puedes hacer dentro de una sesión de Claude Code
Claude Code puede combinar comprensión del proyecto, edición y herramientas en una misma tarea.
Explorar código
Buscar archivos, entender arquitectura y seguir el flujo de una funcionalidad.
Modificar archivos
Implementar funciones, corregir errores y refactorizar código existente.
Ejecutar comandos
Utilizar herramientas del proyecto, scripts, build systems y comandos de terminal.
Ejecutar tests
Crear pruebas, ejecutarlas, interpretar errores y corregir fallos.
Trabajar con Git
Analizar diffs, preparar commits y participar en flujos de pull request.
Planificar cambios
Investigar primero y revisar una estrategia antes de tocar el código.
Explora, planifica, programa y verifica
Separar investigación de implementación reduce el riesgo de resolver el problema equivocado.
Entiende primero
Pide a Claude investigar los archivos, arquitectura y comportamiento relacionado con la tarea.
Realiza los cambios
Una vez definido el enfoque, permite que Claude implemente la solución.
Comprueba el resultado
Ejecuta tests, lint, build o cualquier comprobación que pueda confirmar que funciona.
Abrir un proyecto con Claude Code
La forma más habitual de utilizar Claude Code es iniciarlo desde la raíz del proyecto.
Entrar al proyecto
cd mi-proyecto
claudeEsto facilita que Claude encuentre estructura, configuración, documentación y archivos relevantes del proyecto.
Haz que Claude entienda el proyecto antes de editar
Una buena primera tarea consiste en pedir una visión general del repositorio.
Analizar el codebase
Analiza este proyecto.
Explícame:
- qué tecnologías utiliza
- cuál es su arquitectura
- cuáles son los directorios principales
- dónde comienza la ejecución
- cómo maneja autenticación
- cómo se ejecutan los tests
No realices cambios todavía.Puedes continuar preguntando específicamente por módulos, modelos, APIs, autenticación o cualquier parte del sistema.
Pedir a Claude que encuentre archivos relevantes
No necesitas conocer previamente dónde está implementada cada función.
Buscar autenticación
Encuentra todos los archivos relacionados con
el inicio de sesión de usuarios.
Explícame cómo trabajan juntos
y sigue el flujo desde el formulario
hasta la base de datos.Referenciar archivos con @ en Claude Code
Puedes indicar explícitamente qué archivo o directorio quieres utilizar como contexto.
Referenciar un archivo
Explícame cómo funciona @src/auth/login.phpReferenciar un directorio
¿Cómo está organizado @src/components?Referenciar directamente un archivo evita que Claude tenga que encontrar primero la ubicación relevante.
Cómo escribir mejores prompts para Claude Code
Cuanto más claramente defines el objetivo, las restricciones y la comprobación final, menos correcciones suelen ser necesarias.
Explica qué problema quieres resolver.
Indica dónde ocurre cuando conozcas los archivos afectados.
Describe restricciones técnicas que debe respetar.
Señala patrones existentes que debería imitar.
Define cómo comprobar que el resultado funciona.
Prompt genérico vs prompt útil
“Arregla el login”
Claude tendrá que inferir el problema, el alcance y qué significa que esté resuelto.
Describe síntoma + verificación
Indica qué falla, cómo reproducirlo, dónde investigar y qué test debe pasar al terminar.
Los usuarios dejan de poder iniciar sesión
cuando expira la sesión.
Investiga el flujo en src/auth/,
especialmente la renovación del token.
Primero reproduce el error con un test.
Después corrige la causa real.
Ejecuta los tests al terminar
y no ocultes el error con excepciones genéricas.Planificar antes de permitir cambios
Para tareas complejas, Plan Mode permite investigar el proyecto sin escribir archivos.
Iniciar directamente en Plan Mode
claude --permission-mode plan
Pulsa
Shift + Tab
hasta que Claude Code
indique que Plan Mode
está activo.
Cuándo usar Plan Mode
Cambio en varios archivos
Conviene entender todas las dependencias antes de modificar.
Arquitectura desconocida
Permite explorar primero un codebase que todavía no conoces bien.
Cambio trivial
Para corregir un typo o modificar una línea evidente, puede ser innecesario.
Pedir a Claude que modifique el código
Después de explorar y definir el enfoque, puedes autorizar la implementación.
Implementar desde el plan
Implementa la solución del plan.
Mantén la compatibilidad actual.
No modifiques APIs públicas innecesariamente.
Añade los tests necesarios.
Ejecuta la suite relacionada al terminar
y corrige cualquier fallo que aparezca.Cómo funcionan los permisos de Claude Code
Claude Code puede leer archivos, ejecutar comandos y modificar el sistema, por lo que dispone de controles de permisos.
| Acción | Comportamiento general |
|---|---|
| Leer archivos | Normalmente permitido dentro del directorio de trabajo |
| Buscar código | Normalmente permitido como operación de lectura |
| Modificar archivos | Depende del modo de permisos activo |
| Ejecutar comandos | Puede requerir aprobación según configuración |
| Herramientas MCP | Sujetos a reglas de permisos |
Administrar reglas
/permissionsClaude Code puede ejecutar comandos por ti
Esta capacidad permite cerrar el ciclo entre escribir código y comprobar si realmente funciona.
Ejecutar tests unitarios.
Ejecutar linters y formatters.
Compilar o construir el proyecto.
Consultar Git y revisar diffs.
Ejecutar herramientas CLI instaladas en tu entorno.
Siempre dale a Claude una forma de verificar su trabajo
Una de las prácticas más importantes consiste en definir una señal objetiva de éxito.
Tests
Ejecuta pruebas y corrige cualquier fallo antes de finalizar.
Compilación
Comprueba que el build termine correctamente.
Resultado visual
En interfaces, compara el resultado con capturas o diseños esperados.
Pide evidencia: tests ejecutados, build correcto, salida del comando o una comprobación equivalente.
Crear y ejecutar tests con Claude Code
Claude puede analizar las pruebas existentes para seguir las convenciones del proyecto.
Añadir cobertura
Encuentra funciones de este módulo
que no estén cubiertas por tests.
Sigue el estilo de las pruebas existentes.
Añade casos normales,
casos límite
y condiciones de error.
Ejecuta las pruebas nuevas
y corrige cualquier fallo.Cómo corregir un bug con Claude Code
Describe el error
Entrega mensaje, stack trace y pasos para reproducirlo.
Localiza la causa
Pide investigar el flujo antes de cambiar código.
Reproduce con un test
Siempre que sea posible, crea primero una comprobación que falle.
Corrige y verifica
Implementa la solución y confirma que el test ahora pasa.
Trabajar con Git desde Claude Code
Claude puede utilizar el historial y el estado del repositorio como parte de una tarea.
Revisar cambios
Pide a Claude revisar el diff antes de crear un commit.
Crear commits
Puede resumir los cambios y preparar un mensaje descriptivo.
Pull requests
Puede ayudar a crear y documentar pull requests.
Revisar antes de commit
Revisa el diff actual.
Busca:
- errores
- cambios accidentales
- problemas de seguridad
- código innecesario
- archivos que no deberían incluirse
Si todo está correcto,
propón un mensaje de commit descriptivo.Crear un pull request con Claude Code
Si tu entorno tiene configuradas las herramientas necesarias, puedes pedir la creación directamente.
Preparar PR
Resume los cambios realizados,
ejecuta las comprobaciones necesarias
y prepara un pull request
con una descripción clara
de la implementación,
riesgos y pruebas realizadas.Usa CLAUDE.md para no repetir instrucciones
Claude Code lee
las instrucciones
de CLAUDE.md
al comenzar
las conversaciones.
Crear una base de CLAUDE.md
/initIncluye comandos, convenciones, decisiones arquitectónicas y comportamientos que Claude no pueda deducir simplemente leyendo el código.
Guía completa de CLAUDE.md →Evita llenar innecesariamente el contexto
Cada conversación, lectura de archivos y salida de comandos consume espacio del contexto disponible.
No pidas leer todo el repositorio si solo necesitas investigar un módulo.
Utiliza subagentes para investigaciones que consuman muchos archivos.
Mantén
CLAUDE.md
conciso.
Inicia una sesión nueva cuando cambies completamente de tarea.
Utilizar subagentes para investigar
Una investigación muy grande puede llenar el contexto principal.
Delegar investigación
Usa un subagente para investigar
cómo funciona la renovación
de tokens de autenticación.
Devuélveme únicamente:
- archivos relevantes
- flujo actual
- problemas detectados
- recomendacionesContinuar una conversación anterior
Claude Code guarda las conversaciones para poder retomar trabajo anterior.
Retomar la sesión más reciente
claude --continueElegir una conversación
claude --resumeTrabajar en tareas paralelas con Git worktrees
Puedes ejecutar varias sesiones en copias aisladas del mismo repositorio para evitar conflictos.
Crear una sesión aislada
claude --worktree feature-authUna sesión puede desarrollar una funcionalidad mientras otra investiga un bug sin editar los mismos archivos.
Cómo utilizar Claude Code con un proyecto WordPress
El mismo flujo funciona con plugins, themes y aplicaciones PHP.
Analizar antes de modificar
Analiza este plugin de WordPress.
Antes de cambiar nada:
1. identifica todos los hooks utilizados
2. explica cómo accede a la base de datos
3. revisa sanitización y escaping
4. identifica llamadas AJAX
5. detecta posibles problemas de seguridad
6. propón un plan de mejoras
No modifiques archivos todavía.Errores al empezar a utilizar Claude Code
Pedir cambios sin explorar: Claude puede implementar una solución técnicamente válida que no encaje con la arquitectura existente.
Prompts demasiado vagos: “mejora este código” deja demasiadas decisiones abiertas.
No ejecutar tests: el código puede parecer correcto sin estar realmente verificado.
Aprobar todo automáticamente: revisa comandos y operaciones sensibles.
CLAUDE.md demasiado grande: las reglas importantes pueden perder peso dentro del contexto.
Una sesión para todo: separar tareas puede mantener el contexto más limpio.
Flujo recomendado para trabajar con Claude Code
Describe el objetivo
Explica el problema y qué resultado necesitas conseguir.
Deja que investigue
Pide encontrar los archivos y entender el flujo existente.
Planifica si es necesario
Para tareas complejas, revisa primero un plan de implementación.
Implementa
Permite modificar solo lo necesario para resolver la tarea.
Verifica
Ejecuta tests, build, lint o comprobaciones visuales.
Revisa el diff
Comprueba exactamente qué cambió antes de integrar el resultado.
Documentación para aprender a usar Claude Code
Anthropic mantiene documentación específica sobre workflows, prompts, permisos y prácticas recomendadas.
Common workflows
Codebases, bugs, refactoring, testing, PRs y sesiones.
Ver workflows oficiales →Best practices
Contexto, prompting, planificación, CLAUDE.md y verificación.
Ver buenas prácticas →Permissions
Reglas, modos y controles de herramientas.
Ver permisos →Continúa aprendiendo Claude Code
Profundiza en configuración, Windows, VS Code y funciones avanzadas.
FAQ sobre cómo usar Claude Code
Respuestas sobre proyectos, prompts, permisos, Plan Mode, Git, testing y sesiones.
Abre una terminal
en la carpeta raíz
de tu proyecto
y ejecuta
claude.
Después puedes pedir
una visión general
del codebase
antes de realizar cambios.
Claude Code puede leer archivos dentro de los directorios a los que tiene acceso, buscar código y relacionar información entre diferentes partes del proyecto.
Puedes utilizar
@
seguido de la ruta
para añadir rápidamente
un archivo
al contexto,
por ejemplo
@src/auth/login.js.
Plan Mode permite que Claude investigue archivos y prepare un plan sin modificar el código hasta que apruebes la implementación.
Sí. Puede ejecutar comandos de testing, analizar los resultados, corregir fallos y volver a ejecutar las pruebas.
El comportamiento depende del modo de permisos y de las reglas configuradas. Claude Code dispone de controles específicos para acciones y herramientas.
Dentro de una sesión
puedes utilizar
/permissions
para revisar
y administrar reglas
de herramientas.
Sí. Puede revisar diffs, consultar el repositorio, ayudar con commits y participar en flujos de pull requests.
Puedes utilizar
claude --continue
para retomar
la conversación más reciente
del directorio actual,
o
claude --resume
para seleccionar
una sesión anterior.
Para tareas importantes, un buen flujo consiste en explorar primero, preparar un plan, implementar los cambios, ejecutar una comprobación y revisar el diff antes de integrar el resultado.
Conoce cuánto cuesta Claude Code
Ya sabes instalar y utilizar Claude Code. Ahora podemos revisar planes, precios, límites, consumo y las diferencias entre utilizarlo mediante una suscripción de Claude o Anthropic API.
Ver precio de Claude Code →