Módulo 2: Instalación y setup profesional

Módulo 2: Instalación y Setup Profesional

Siguiente →

Módulo 2: Instalación y Setup Profesional

Descripción

Ya entiendes qué es Claude Code. Sabes que es el agente de código de Anthropic para terminal, que lidera los benchmarks de SWE-bench, y que opera como un developer senior con acceso completo a tu filesystem. Eso fue el Módulo 01. Ahora viene lo que importa: ponerlo a funcionar.

Este módulo es enteramente práctico. No hay teoría abstracta — cada sección te lleva a una acción concreta. Al terminar las 5 cápsulas, vas a tener Claude Code instalado, autenticado, configurado con el modelo correcto, y optimizado para tu flujo de trabajo. Es la diferencia entre "saber qué es Claude Code" y "tener Claude Code trabajando para ti."

Un setup bien hecho es invisible: no piensas en él, simplemente funciona. Un setup mal hecho es un obstáculo constante — errores de autenticación, el modelo equivocado para la tarea, costos innecesarios, o peor: no saber que existe una plataforma que se adapta mejor a tu workflow. Este módulo elimina esos problemas desde la raíz.

Dónde Estamos en la Guía

Módulo 01: Qué es Claude Code ✅
Módulo 02: Instalación y setup ← ESTÁS AQUÍ
Módulo 03: CLAUDE.md y memoria
Módulo 04: Workflow agentic
Módulo 05: Skills y Hooks
Módulo 06: Subagents
Módulo 07: Integraciones (Git, SDK, Remote Control)
Módulo 08: Proyecto integrador

En el Módulo 01 aprendiste qué es Claude Code, por qué lidera el espacio, y cómo se diferencia de otros agentes. Ahora, en el Módulo 02, pasamos de entender a instalar y configurar. Todo lo que viene después — CLAUDE.md, workflows, skills, subagents — requiere que este paso esté bien resuelto.

El Mental Model Fundamental

La instalación de Claude Code es como configurar tu entorno de desarrollo.

Cuando empiezas un proyecto nuevo, no saltas directo a escribir código. Primero instalas el runtime, configuras el editor, verificas que el linter funciona, confirmas que los tests pasan, y te aseguras de que el build pipeline está limpio. Solo entonces empiezas a trabajar.

Con Claude Code es exactamente lo mismo:

1. Instalar Claude Code (instalador nativo, Homebrew, o WinGet)
2. Autenticarte (OAuth o API key)
3. Verificar que funciona (/doctor)
4. Elegir la plataforma adecuada (terminal, VS Code, JetBrains...)
5. Seleccionar el plan correcto (Pro, Max 5x, Max 20x)
6. Configurar modelo y esfuerzo (Opus 5, Sonnet 5, /effort)

Cada paso construye sobre el anterior. Si te saltas la verificación con /doctor, puede que tengas un problema latente que aparece cuando más necesitas a Claude. Si eliges el modelo equivocado, desperdicias tokens en tareas simples o te quedas corto en tareas complejas.

El error más común

La mayoría de usuarios hacen esto:

curl -fsSL https://claude.ai/install.sh | bash
claude
# "funciona, listo"

Instalan, confirman que abre, y empiezan a trabajar. No verifican con /doctor, no entienden los planes, no saben que pueden cambiar de modelo en medio de una sesión, no conocen /effort. Funcionan al 40% de la capacidad de Claude Code.

Un profesional hace esto:

curl -fsSL https://claude.ai/install.sh | bash
claude doctor
claude --version
# Configura el plan adecuado
# Conoce los atajos de modelo y effort
# Sabe en qué plataforma trabajar según la tarea

Los 30 minutos que inviertes en este módulo se pagan con creces en cada sesión posterior.

Prerequisitos

Conocimiento requerido:

  • ✅ Módulo 01 completado (entiendes qué es Claude Code)
  • ✅ Familiaridad básica con terminal/línea de comandos

Software necesario:

  • ✅ Terminal — macOS Terminal, iTerm2, Windows Terminal, PowerShell, CMD, o cualquier terminal Linux
  • ✅ En Windows: Git for Windows instalado (requerido)

Cuenta requerida:

Si estás en Windows:

Claude Code tiene soporte nativo para Windows. Necesitas Git for Windows instalado. Puedes lanzar claude desde PowerShell, CMD, o Git Bash. Opcionalmente, también puedes usar WSL2 (que además soporta sandboxing para seguridad adicional).

Roadmap del Módulo

Este módulo tiene 5 cápsulas progresivas:

Cápsula 01 — Introducción al módulo (esta cápsula)

Contexto, mental model, prerequisitos, y roadmap. Entiendes qué vas a hacer y qué necesitas antes de empezar.

Cápsula 02 — Instalación y autenticación

El paso técnico central: instalar Claude Code con el instalador nativo, autenticarte, verificar con /doctor, y resolver los problemas más comunes. Al final tienes Claude Code funcionando.

Cápsula 03 — Plataformas disponibles

Claude Code no vive solo en la terminal. Existe en VS Code, JetBrains, desktop app, web, y hasta en tu teléfono. Cada plataforma tiene ventajas y limitaciones — aquí aprendes cuándo usar cuál.

Cápsula 04 — Planes, pricing y modelos

Pro ($20/mes), Max 5x ($100/mes), Max 20x ($200/mes) — cuándo vale la pena cada uno. Estrategias de optimización de costos. Qué pasa cuando llegas al límite de uso.

Cápsula 05 — Model selection y effort level

Opus 5 vs Sonnet 5: cuándo usar cada uno. Effort levels (low, medium, high, max): cómo ajustar la profundidad de razonamiento. El alias opusplan. Combinaciones óptimas para cada tipo de tarea.

Mapa de progresión

Cápsula 01 (esta)     → Contexto y prerequisitos
Cápsula 02            → Instalación: de cero a primer "hola"
Cápsula 03            → Plataformas: dónde usar Claude Code
Cápsula 04            → Planes: cuánto cuesta y cómo optimizar
Cápsula 05            → Modelos y effort: la configuración inteligente

Dificultad: ⭐ ──────────────────────────▶ ⭐⭐

Las cápsulas 02 y 05 son las más importantes: sin instalación no hay nada, y sin buena selección de modelo desperdicias recursos. Las cápsulas 03 y 04 son contexto estratégico que informa decisiones del día a día.

Qué Lograrás en Este Módulo

A lo largo de las 5 cápsulas, producirás:

  1. Claude Code instalado y verificado con /doctor dando todo en verde
  2. Autenticación configurada — API key u OAuth según tu caso de uso
  3. Decisión de plataforma informada — sabrás en qué entorno trabajar
  4. Plan seleccionado — Pro, Max 5x, o Max 20x según tu perfil
  5. Configuración de modelo — cuándo usar Opus, cuándo Sonnet, y a qué nivel de effort

El antes y después

ANTES del módulo:
→ "¿Cómo instalo Claude Code?"
→ "¿Por qué me da error de autenticación?"
→ "¿Cuánto cuesta esto?"
→ "¿Qué modelo debería usar?"

DESPUÉS del módulo:
→ Claude Code instalado y verificado
→ Autenticación sólida sin errores
→ Plan optimizado para tu perfil de uso
→ Modelo y effort configurados por tipo de tarea
→ Plataforma elegida según tu workflow

Qué NO Cubre Este Módulo

Para mantener el foco, estas cosas se cubren en módulos posteriores:

TemaDónde se cubre
CLAUDE.md y sistema de memoriaMódulo 03
Workflow agentic (explore → plan → code)Módulo 04
Skills y HooksMódulo 05
SubagentsMódulo 06
Integración con GitHub, SDK, CI/CDMódulo 07
Proyecto integrador completoMódulo 08

Este módulo es puro setup. Es la base sobre la que todo lo demás se construye.

Conexión con el Proyecto Integrador

En el Módulo 08, construirás una herramienta completa usando Claude Code. Para ese proyecto necesitas:

  1. Claude Code instalado — obvio, pero necesitas que esté actualizado y funcionando
  2. Autenticación sin fricciones — no quieres que expire tu token a mitad de una sesión de desarrollo
  3. El plan correcto — el proyecto integrador requiere interacciones largas, y un plan inadecuado te limita
  4. El modelo correcto — para arquitectura usarás Opus + high effort, para implementación quizás Sonnet + medium
  5. La plataforma correcta — probablemente terminal para la mayoría, pero VS Code puede ayudar para debugging visual

Todo lo que configuras en este módulo es exactamente lo que necesitas para el proyecto final.

Conceptos Clave que Verás

Instalador nativo

Claude Code se instala con un instalador nativo que no requiere Node.js ni npm. Se auto-actualiza en background para mantenerte en la última versión. También está disponible vía Homebrew (brew install --cask claude-code) y WinGet (winget install Anthropic.ClaudeCode).

# macOS, Linux, WSL:
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell:
irm https://claude.ai/install.ps1 | iex

# Ahora 'claude' está disponible en cualquier directorio

Autenticación OAuth vs API Key

Dos formas de autenticarte. OAuth es para uso interactivo (la experiencia "normal"). API key es para uso programático (SDK, headless, CI/CD). Cada una tiene su caso de uso.

OAuth:
→ Ejecutas 'claude', se abre el browser, te logueas
→ Para tu uso diario en terminal o IDE

API Key:
→ Configuras ANTHROPIC_API_KEY como variable de entorno
→ Para CI/CD, scripts, automatización

/doctor

Comando de diagnóstico de Claude Code. Verifica tu instalación: autenticación, conectividad, acceso a modelos. Es tu primera línea de defensa contra problemas. Se ejecuta como claude doctor desde la terminal.

claude doctor
# ✓ Authenticated
# ✓ Network OK
# ✓ Model access: Opus 5, Sonnet 5

Plataformas

Claude Code no es solo terminal. Tiene extensiones para VS Code y JetBrains, una app desktop standalone, versión web, e incluso acceso desde el móvil. Cada plataforma ofrece una experiencia diferente.

Terminal (CLI) ← experiencia completa
VS Code        ← integrado en el editor
JetBrains      ← IntelliJ, WebStorm, PyCharm...
Desktop App    ← aplicación standalone
Web            ← claude.ai/code, tareas que continúan sin tu laptop

Planes (Pro, Max 5x, Max 20x)

Niveles de suscripción que determinan cuánto puedes usar Claude Code, qué modelos están disponibles, y qué features adicionales tienes acceso.

PlanPrecioUsoOpus 5
Pro$20/mesBaseLimitado
Max 5x$100/mes5xCompleto
Max 20x$200/mes20xCompleto + prioridad

Modelos (Opus 5, Sonnet 5)

Dos modelos principales con perfiles diferentes. Opus es el más capaz (1M de contexto), Sonnet es el mejor balance velocidad/inteligencia (también 1M de contexto). Haiku es el más rápido (200K). La elección del modelo impacta directamente la calidad y velocidad de las respuestas.

Opus 5:   ████████████ capacidad   ████ velocidad
Sonnet 5: ████████ capacidad       ████████████ velocidad

Effort level

Controla cuánto razona el modelo antes de responder. Los niveles disponibles dependen del modelo:

  • Opus 5: 5 niveles — low, medium, high, xhigh, max. Default: xhigh
  • Opus 5, Sonnet 5 y Fable 5: 5 niveles — low, medium, high, xhigh, max. Default: high (xhigh recomendado para coding)

Se configura con /effort, en /model con las flechas, en settings, o por variable de entorno.

Effort low    → razonamiento ligero, respuesta rápida
Effort medium → reduce tokens para trabajo cost-sensitive
Effort high   → razonamiento profundo, mínimo para trabajo intelligence-sensitive
Effort xhigh  → muy profundo, recomendado para coding/agentic (default Opus 5)
Effort max    → máxima profundidad, sin límite de tokens de thinking (aplica solo a sesión actual)

Nota: Si configuras un nivel que el modelo activo no soporta (ej: xhigh en Sonnet 5), Claude Code cae al nivel más alto soportado (high en ese caso).

Preguntas Frecuentes Antes de Empezar

"¿Necesito saber programar para usar Claude Code?"

Sí. Claude Code es una herramienta para desarrolladores. No es un "crea mi app sin código" — es un agente que trabaja contigo, en tu código, con tus herramientas. Necesitas entender código para evaluar lo que produce, corregirlo cuando se equivoca, y darle instrucciones precisas.

"¿Claude Code funciona offline?"

No. Claude Code necesita conexión a internet para comunicarse con los servidores de Anthropic. Los modelos (Opus 5, Sonnet 5) corren en la nube, no en tu máquina local.

"¿Es seguro? ¿Lee todo mi código?"

Claude Code lee archivos de tu proyecto para darte respuestas contextuales. Los archivos se envían a los servidores de Anthropic para procesamiento. Anthropic tiene políticas de privacidad y no usa tus datos para entrenamiento (verifica en anthropic.com/privacy). Si trabajas con código sensible, revisa las políticas de tu empresa antes de usar herramientas de AI.

"¿Puedo usar Claude Code con cualquier lenguaje?"

Sí. Claude Code trabaja con cualquier lenguaje de programación: Python, JavaScript, TypeScript, Go, Rust, Java, C#, Ruby, PHP, Swift, Kotlin, y más. No hay restricción de lenguaje — si puedes trabajarlo en tu terminal, Claude Code puede ayudarte.

"¿Cuánto espacio ocupa la instalación?"

Claude Code es relativamente ligero. No requiere GPU ni hardware especial — solo 4 GB+ de RAM y conexión a internet. Los requisitos son mínimos: macOS 13+, Windows 10 1809+, o Ubuntu 20.04+.

Versiones y Compatibilidad

Este módulo cubre:

  • Opus 5 (1M token context window)
  • Sonnet 5 (1M token context window)
  • Haiku 4.5 (200K token context window)

Nota sobre actualizaciones:

Claude Code se actualiza con frecuencia. Los pasos de instalación y los conceptos de este módulo son estables — instalación nativa, autenticación, /doctor, plataformas, planes, y model selection son fundamentales a la arquitectura. Los detalles específicos (precios, límites exactos, features de cada plan) pueden evolucionar; los principios no.

Cuando veas información de pricing o límites, verifica en claude.ai/pricing para confirmar los valores actuales.

Cómo Trabajar Este Módulo

Recomendación:

  1. Lee la cápsula 02 con tu terminal abierta. Instala Claude Code mientras lees.
  2. La cápsula 03 es informativa. Léela para conocer opciones, pero no necesitas instalar todas las plataformas.
  3. La cápsula 04 requiere una decisión. Al terminarla, deberías saber qué plan necesitas.
  4. La cápsula 05 es práctica. Experimenta con /model y /effort en tu terminal.

Tiempo estimado:

Cápsula 01 (esta)  →  5 min lectura
Cápsula 02         → 15 min lectura + 10 min práctica
Cápsula 03         → 10 min lectura
Cápsula 04         →  8 min lectura + 5 min decisión
Cápsula 05         → 12 min lectura + 10 min práctica

Total: ~75 minutos (lectura + práctica)

No te apures. Es mejor invertir tiempo aquí y tener un setup sólido que correr hacia el Módulo 03 con una instalación frágil.

Resumen

Este módulo transforma "sé qué es Claude Code" en "tengo Claude Code funcionando de forma profesional."

Lo que cubre:

  • Instalación completa (nativa, Homebrew, WinGet) y autenticación
  • Verificación con /doctor y troubleshooting
  • Las 5 plataformas disponibles y cuándo usar cada una
  • Los 3 planes de suscripción y cómo elegir
  • Selección de modelo (Opus vs Sonnet) y el parámetro /effort

Lo que produce:

  • Claude Code instalado, autenticado, y verificado
  • Decisión informada de plataforma y plan
  • Configuración de modelo y effort lista para usar

Por qué importa:

  • Un setup sólido es invisible — simplemente funciona
  • Un setup débil genera fricción constante que reduce productividad
  • Las decisiones de este módulo afectan cada sesión futura con Claude Code

Siguiente cápsula: 02 - Instalación y autenticación — de cero a tu primera interacción con Claude Code.

Recursos Adicionales

Documentación oficial

Setup por plataforma

Pricing y planes

  • Claude Pricing — Precios actualizados de Pro, Max, Team, y Enterprise
  • Manage Costs — Guía de optimización de costos en Claude Code

Modelos

  • Model Configuration — Modelos disponibles, aliases, effort levels, y contexto extendido
  • Claude Models — Especificaciones de Opus 5, Sonnet 5, y otros modelos
← AnteriorLandscape de AI Coding ToolsSiguiente →Instalación y Autenticación de Claude Code