Instalar Claude Code toma menos de cinco minutos. En esta guía te mostramos los pasos exactos, cómo hacer tu primera consulta y las configuraciones básicas que vale la pena conocer desde el inicio.
Si quieres primero entender qué es Claude Code y para qué sirve, está en nuestra guía general sobre Claude Code; aquí vamos directo a la instalación.
Requisitos previos
- Node.js 18 o superior. Puedes verificarlo con
node --versionen tu terminal. Si no lo tienes, descárgalo desde nodejs.org. - Una cuenta de Anthropic. Regístrate en claude.ai si aún no tienes una.
- Acceso a Claude Code. Disponible con suscripción a Claude Pro o Max, o con una API key de Anthropic.
Instalación en tres pasos
Paso 1: Instalar el paquete global
Abre tu terminal y ejecuta:
npm install -g @anthropic-ai/claude-codeEsto instala el comando claude de forma global en tu sistema.
Paso 2: Autenticarse
En tu terminal, ejecuta:
claudeLa primera vez te pedirá que inicies sesión con tu cuenta de Anthropic. El navegador se abre automáticamente, inicias sesión, autorizas el acceso y listo: vuelves a la terminal ya autenticado.
Paso 3: Tu primera prueba
Navega a cualquier proyecto tuyo con cd mi-proyecto y escribe algo como:
claude "explícame qué hace este proyecto"Claude Code va a leer los archivos del directorio y darte una explicación basada en el código real. Ya está listo para trabajar.
Formas de usar Claude Code
Una vez instalado, tienes dos modos principales:
- Modo interactivo. Escribe
claudey se abre una sesión conversacional donde puedes ir pidiendo tareas una tras otra, con contexto acumulado. Es el modo más potente para trabajo profundo. - Modo de un solo comando. Pasa la instrucción directamente:
claude "tarea que quieres hacer". Útil para tareas puntuales o para integrarlo en scripts.
Configuraciones básicas que vale la pena ajustar
Archivo CLAUDE.md
Crea un archivo CLAUDE.md en la raíz de tu proyecto. Claude Code lo lee automáticamente al inicio de cada sesión y sigue las instrucciones que pongas ahí: convenciones del proyecto, tecnologías usadas, qué no tocar, cómo nombrar variables. Es como darle un onboarding a tu nuevo colaborador IA.
Modos de permiso
Por defecto, Claude Code te pide confirmación antes de ejecutar comandos o editar archivos. Puedes ajustar este comportamiento:
- Modo cauteloso (por defecto): te pregunta antes de casi todo. Recomendado cuando estás empezando.
- Modo automático (
--dangerously-skip-permissions): actúa sin preguntar. Solo para entornos de prueba donde el riesgo es bajo.
Extensiones de IDE
Si usas VS Code o JetBrains, instala la extensión oficial de Claude Code. Tendrás el mismo poder del CLI integrado directamente en tu editor, con atajos de teclado y acceso al chat sin salir del IDE.
Comandos básicos para empezar
/help— muestra todos los comandos disponibles y cómo usarlos./clear— limpia el historial de conversación y empieza contexto fresco./compact— comprime el contexto de la conversación para liberar espacio sin perder el hilo.Ctrl+C(oCmd+Cen Mac) — interrumpe una acción en curso si la IA está haciendo algo que no quieres.
Primer flujo de trabajo recomendado
Para sacarle el jugo desde el primer día:
- Abre tu proyecto y escribe
claudepara entrar al modo interactivo. - Pídele que entienda el proyecto: "léete el proyecto y dime qué hace cada parte".
- Empieza con una tarea pequeña: corregir un bug, escribir un test, documentar una función.
- Revisa los cambios con
git diffantes de aceptarlos. - Crea tu
CLAUDE.mdcon las convenciones del proyecto para que no te explique lo básico cada vez.
En resumen
Instalar Claude Code es cuestión de un comando npm y un inicio de sesión. Lo que transforma tu flujo de trabajo no es la instalación: es aprender a darle las instrucciones correctas y entender qué puede hacer por ti en tu proyecto específico.
En Aldama usamos Claude Code en nuestros proyectos de desarrollo. Si quieres saber cómo integramos IA en flujos de desarrollo reales —no solo como experimento— es justo lo que hacemos. Sin humo.