Instalación y Setup

# Instalación y Configuración Basta de teoría -- es hora de poner el Claude Code a funcionar en tu máquina. En menos de 10 minutos vas a tener la herramienta instalada, configurada y lista para revolucionar tu flujo de trabajo. Esta guía cubre la instalación en macOS, Linux y Windows (vía WSL), así que no importa cuál sistema uses. ## Pre-requisitos Antes de comenzar, necesitas tres cosas: 1. **Node.js 18 o superior** -- Claude Code es distribuido como un paquete npm global. Verifica tu versión con `node --version`. Si necesitas instalar o actualizar, usa el sitio oficial nodejs.org o un gestor de versiones como **nvm** (Node Version Manager). 2. **Una cuenta en Anthropic** -- Vas a necesitar una API key para autenticar el Claude Code. Crea tu cuenta en console.anthropic.com si aún no tienes una. 3. **Un terminal funcional** -- En macOS, usa el Terminal nativo o iTerm2. En Linux, cualquier emulador de terminal sirve. En Windows, **necesitas el WSL2** (Windows Subsystem for Linux) -- el Claude Code no corre nativamente en PowerShell o CMD. ## Instalación Paso a Paso La instalación se hace en tres comandos: 1. **Instala el Claude Code globalmente:** ```bash npm install -g @anthropic-ai/claude-code ``` 2. **Verifica la instalación:** ```bash claude --version ``` 3. **Inicia el Claude Code por primera vez:** ```bash claude ``` En la primera ejecución, el Claude Code va a pedir tu **API key de Anthropic**. Puedes obtenerla en console.anthropic.com en la sección "API Keys". Pega la clave cuando se te solicite y ella será almacenada de forma segura en tu sistema. **Alternativa con variable de entorno:** Si prefieres, puedes definir la clave como variable de entorno añadiendo a tu `.bashrc` o `.zshrc`: ```bash export ANTHROPIC_API_KEY="sk-ant-tu-clave-aqui" ``` ## Configuración del Ambiente Después de la instalación, existen algunas configuraciones opcionales que mejoran mucho la experiencia: **Modelo predeterminado:** Por defecto, Claude Code usa el Claude Sonnet. Para usar el Opus (más poderoso, más caro), puedes configurar: ```bash claude config set model claude-opus-4 ``` **Tema y apariencia:** El Claude Code se adapta al tema de tu terminal, pero puedes ajustar: ```bash claude config set theme dark ``` **Permisos automáticos:** Para evitar confirmaciones repetitivas en operaciones seguras: ```bash claude config set autoApprove read,write,bash ``` **Importante:** Solo activa `autoApprove` cuando estés cómodo con la herramienta. Al inicio, es mejor revisar cada acción que el Claude Code quiere ejecutar. ## Resolución de Problemas Comunes Si encuentras errores durante la instalación, aquí están las soluciones más comunes: - **"Permission denied" en el npm install:** Usa `sudo npm install -g @anthropic-ai/claude-code` en Linux/macOS, o mejor aún, corrige los permisos del npm con `npm config set prefix ~/.npm-global` - **"node: command not found":** Node.js no está instalado o no está en el PATH. Reinstala vía nvm - **"ANTHROPIC_API_KEY not set":** Verifica si la variable de entorno fue exportada correctamente. Ejecuta `echo $ANTHROPIC_API_KEY` para confirmar - **Error de SSL/TLS:** Común en redes corporativas con proxy. Configura el proxy con `export HTTPS_PROXY=http://tu-proxy:puerto` ## Consejo Practico Crea un alias en tu shell para iniciar el Claude Code ya en el directorio del proyecto. Añade a tu `.zshrc` o `.bashrc`: **alias cc="claude"**. Así, tú digitas apenas `cc` para iniciar una sesión. Otro consejo: usa `claude -p "tu pregunta"` para hacer preguntas rápidas sin entrar en el modo interactivo. ## Videos Recomendados ### PT-BR - [Como Instalar o Claude Code Passo a Passo](https://www.youtube.com/results?search_query=como+instalar+claude+code+terminal+2025) ### EN - [Claude Code Setup and Configuration Guide](https://www.youtube.com/results?search_query=claude+code+setup+install+configuration+2025) ## Lectura Recomendada - **"Getting Started with Claude Code"** -- Anthropic Docs. Guía oficial de instalación y primeros pasos. ## Podcasts - **Changelog Podcast** (changelog.com) -- Episodios sobre herramientas CLI y productividad para desarrolladores. ## Herramientas y Recursos - **nvm (Node Version Manager)** -- [https://github.com/nvm-sh/nvm](https://github.com/nvm-sh/nvm) -- Gestiona múltiples versiones de Node.js fácilmente. - **Anthropic Console** -- [https://console.anthropic.com](https://console.anthropic.com) -- Crea y gestiona tus API keys. - **WSL2** -- [https://learn.microsoft.com/windows/wsl](https://learn.microsoft.com/windows/wsl) -- Necesario para usuarios Windows. ## Puntos Clave - Claude Code requiere Node.js 18+ y una API key de Anthropic - La instalación se hace con un único comando npm install global - La API key puede ser configurada vía prompt interactivo o variable de entorno - Usuarios Windows necesitan el WSL2 para correr Claude Code - Configuraciones como modelo predeterminado y auto-aprobación pueden ser ajustadas con claude config