Lección 02: Setup, Autenticación y Primer Proyecto
- Claude Code se instala vía npm (global) o como binario nativo sin dependencias de Node.js.
- La autenticación soporta Claude Pro/Team/Enterprise (OAuth) o API key directa de Anthropic.
- El archivo CLAUDE.md funciona como memoria persistente: convenciones, comandos y reglas que Claude lee al inicio de cada sesión.
- La jerarquía de configuración es: global (~/.claude/) → proyecto (./CLAUDE.md) → sesión (instrucciones en el chat).
Antes de que Claude Code pueda leer tu codebase o ejecutar un solo comando, necesitas tres cosas: instalarlo, autenticarte y configurar el contexto de tu proyecto. Este proceso toma menos de 5 minutos, pero hacerlo correctamente marca la diferencia entre un agente que entiende tu proyecto desde el primer prompt y uno que necesita que le expliques todo cada vez.
Requisitos del Sistema
Claude Code es una herramienta de terminal. No necesitas ningún IDE específico, pero sí necesitas un entorno compatible:
- Sistema operativo: macOS 12+, Ubuntu 20.04+ / Debian 11+, o Windows vía WSL2.
- Node.js: Versión 18 o superior (solo si instalas vía npm).
- Terminal: Cualquier emulador moderno. iTerm2, Warp, Alacritty, Windows Terminal o la terminal integrada de VS Code.
- Git: Recomendado. Claude Code lo detecta automáticamente para commits y diffs.
- Conexión a internet: Obligatoria. El modelo se ejecuta en los servidores de Anthropic.
Instalación
Hay dos métodos de instalación. Elige el que mejor se adapte a tu entorno.
Requisito: Node.js 18+ instalado en tu sistema.
Este es el método recomendado porque se actualiza fácilmente con npm update -g.
Sin dependencias. No necesitas Node.js. Ideal para entornos minimalistas o contenedores.
El script detecta automáticamente tu arquitectura (ARM64 / x86_64) y descarga el binario correspondiente.
Autenticación
Una vez instalado, necesitas conectar Claude Code con tu cuenta. Hay dos vías:
Opción A: Cuenta Claude Pro / Team / Enterprise
El método más sencillo. Al ejecutar claude por primera vez, se abre un flujo OAuth en tu navegador:
$ claude > No authentication found. > Opening browser for login... > Waiting for authentication... # Se abre claude.ai en tu navegador # Inicias sesión y autorizas Claude Code > Authenticated as david@m8d.io > Plan: Claude Pro > Ready.
Opción B: API Key Directa
Si prefieres pagar por tokens o necesitas control granular del gasto:
# Exportar la API key como variable de entorno export ANTHROPIC_API_KEY="sk-ant-api03-xxxxxxxxxxxx" # Opcional: añadir al perfil para persistencia echo 'export ANTHROPIC_API_KEY="sk-ant-api03-xxxx"' >> ~/.zshrc # Iniciar Claude Code (detecta la key automáticamente) $ claude > Authenticated via API key > Model: claude-opus-4-6 > Ready.
Coste Estimado
Un uso intensivo de Claude Code consume entre 5 y 20 USD diarios en tokens vía API. Con Claude Pro (20 USD/mes) tienes un uso limitado pero predecible. Para equipos, Claude Team ofrece límites más altos por usuario.
Tu Primer Proyecto con Claude Code
Con la instalación y autenticación completadas, el siguiente paso es iniciar Claude Code dentro de un proyecto real.
Paso 1: Navegar al proyecto
cd ~/projects/mi-app-nextjs $ claude > Scanning project structure... > Detected: Next.js 15 + TypeScript + Prisma + Tailwind > Git: main branch, 3 uncommitted changes > CLAUDE.md: found (project root) > Ready.
Paso 2: Crear tu CLAUDE.md
Si tu proyecto no tiene un CLAUDE.md, puedes pedirle a Claude que lo genere:
Tu: Analiza este proyecto y genera un CLAUDE.md con el stack, convenciones, comandos y reglas. > [Read] package.json > [Read] tsconfig.json > [Glob] src/**/*.ts (247 files) > [Read] .eslintrc.js > [Read] prisma/schema.prisma > [Think] Analyzing conventions... > [Write] CLAUDE.md > Created CLAUDE.md with project conventions.
Paso 3: Jerarquía de Configuración
Claude Code lee configuración de tres niveles, en orden de prioridad:
- Global (
~/.claude/CLAUDE.md): Preferencias personales para todos tus proyectos. - Proyecto (
./CLAUDE.mden la raíz): Convenciones específicas. Se commitea al repo. - Sesión (instrucciones en el chat): Contexto temporal para la tarea actual.
Paso 4: Elegir Modo de Permisos
# Modo Default: pide permiso para editar y ejecutar $ claude # Modo Auto-edit: edita libre, bash pide permiso $ claude --allowedTools "Edit,Write,Glob,Grep,Read" # Modo no interactivo (scripts/CI) $ claude -p "Ejecuta los tests" --allowedTools "Bash(npm test)"
Recomendación de Seguridad
Nunca uses el modo completamente autónomo en máquinas de producción. El modo Default es correcto para el 90% de los casos.
Preguntas Frecuentes
Sobre instalación y configuración de Claude Code
CLAUDE.md del proyecto se commitea al repo para que el equipo comparta convenciones. Para preferencias personales, usa ~/.claude/CLAUDE.md que es local.