Instalar Claude Code: guía práctica paso a paso

Por qué usar Claude Code desde la terminal

Claude Code trae la experiencia de Claude al terminal: permite iterar con prompts desde proyectos locales, integrarlo en scripts y usarlo en servidores sin depender exclusivamente de la interfaz web. Muchos profesionales y equipos en Latinoamérica encuentran útil esta alternativa para automatizar tareas, prototipar y mantener auditoría de sesiones cuando trabajan con repositorios y entornos remotos.

En este artículo verán cómo instalar Claude Code, completar la configuración inicial y los pasos para comenzar a usarlo de forma segura en su equipo o servidor.

Requisitos y consideraciones previas

• No se requieren privilegios de administrador para la instalación nativa mostrada aquí.
• Claude Code consume cuota de uso asociada a la cuenta: presten atención a la pantalla de consentimiento que vincula el cliente de terminal con su suscripción o cuenta de facturación.
• Si van a instalarlo en servidores o desde sesiones SSH, sigan la sección del flujo manual para autenticarse desde otro equipo con navegador.

Instalación (comando único por plataforma)

Abrir una terminal y ejecutar la línea correspondiente a su sistema operativo.

• macOS, Linux, WSL

curl -fsSL https://claude.ai/install.sh | bash

• Windows PowerShell

irm https://claude.ai/install.ps1 | iex

• Windows CMD

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Si la instalación fue exitosa verán un mensaje final; si aparece una nota amarilla de configuración, sigan el siguiente paso.

(Opcional) Añadir el ejecutable al PATH

Si al ejecutar claude reciben “command not found”, es probable que el binario se haya instalado en ~/.local/bin. En Zsh (macOS por defecto):

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

En Bash reemplacen ~/.zshrc por ~/.bashrc.

Verificar la instalación

Ejecuten:

claude --version

Debería imprimir una versión similar a 2.1.226 (Claude Code). Para diagnósticos sin iniciar sesión, usen claude doctor.

Primer arranque: desde el proyecto

Muévanse al directorio de trabajo donde usarán Claude y lancen el comando:

cd ~/su-proyecto
claude

Esto inicia el asistente de configuración.

Tema y apariencia

La primera pantalla permite elegir un tema (flechas + Enter). Más adelante pueden cambiarlo con el comando /theme. Hay opciones pensadas para accesibilidad, como paletas aptas para daltónicos y una opción ANSI-only.

Método de inicio de sesión

El instalador preguntará cómo desean autenticar. Si tienen una suscripción de Claude, elijan la opción correspondiente (por ejemplo, opción 1). Las opciones disponibles suelen incluir suscripción, facturación por consola o plataformas de nube de terceros.

Autorizar en el navegador

La opción más común abre una pantalla de consentimiento en su navegador. Hagan clic en “Authorize” o el botón equivalente. Esta pantalla es importante porque vincula el CLI con su cuenta y la cuota de uso; léanla con atención.

Sin navegador en el host: flujo manual

Si están en un servidor, contenedor o sesión SSH sin entorno gráfico, Claude Code mostrará una URL y un código de un solo uso. Presionen c para copiar la URL (si está disponible), abranla desde cualquier equipo con navegador, acepten la autorización y copiarán el código que aparece.

Péguenlo en el terminal cuando se les solicite. La entrada se mostrará enmascarada mientras pegan el código.

Confirmar cuenta y ajustes del terminal

Tras la autorización verán la cuenta (email) que se asociará. Confirmen que es la cuenta deseada y presionen Enter.

El instalador sugerirá aceptar los ajustes recomendados del terminal (recomendado). Entre otras cosas, habilita Option+Enter para nuevas líneas; sin esto, enviar multi-línea podría cortar prompts incompletos.

Confiar en la carpeta de trabajo

Claude Code pedirá que confirmen la carpeta en la que trabajarán y si confían en ella. Lean la ruta y, si es la correcta, seleccionen “Yes, I trust this folder”. Este permiso da al cliente acceso a todo lo que haya en ese directorio, por lo que es clave mantener el alcance restringido a proyectos específicos.

Entrada al entorno y primeros comandos

Al entrar pueden aceptar el renderer en pantalla completa si se ofrece; ayuda a reducir parpadeos en respuestas largas y habilita soporte de mouse. Verán un panel de bienvenida con el modelo activo, la cuenta y el directorio de trabajo. Escriban una instrucción en lenguaje natural y presionen Enter para empezar. Tecleen ? para ver atajos.

Recomendación de uso: lancen Claude dentro del proyecto donde van a trabajar, ejecuten /init para crear un punto de partida reproducible y consulten /usage pronto para monitorear consumos.

Seguridad y buenas prácticas para equipos en Latinoamérica

• Mantengan instalaciones separadas por proyecto: evita dar acceso innecesario a repositorios o credenciales.
• En entornos compartidos o servidores, prefieran el flujo manual de autenticación desde una máquina con navegador y revisen la cuenta asociada.
• Revisen la pantalla de consentimiento: ahí se define qué cuota y facturación se utilizará. Esto es especialmente importante para equipos que manejan presupuestos centralizados.

Preguntas frecuentes (respuestas breves)

Q1. ¿Puedo usar Claude Code en el plan gratuito?

A. No: requiere Pro, Max, Team, Enterprise o una cuenta de Anthropic Console con facturación activa.

Q2. ¿Necesito Node.js?

A. El instalador nativo incluye su propio runtime. Sólo el paquete legacy via npm requeriría Node.js (versión 22 o superior).

Q3. ¿Cómo se actualiza?

A. Las instalaciones nativas suelen actualizarse automáticamente. Pueden forzar una actualización con claude update o usar el gestor de paquetes correspondiente si instalaron con Homebrew, WinGet, apt, dnf o apk.

Q4. ¿Hay forma de usarlo sin terminal?

A. Sí: la app de escritorio de Claude incluye Claude Code con interfaz gráfica para macOS, Windows y Linux.

Q5. ¿Cómo desinstalo Claude Code?

A. Eliminando ~/.local/bin/claude y ~/.local/share/claude. Si además quieren borrar configuraciones y el historial de sesiones, remuevan ~/.claude.

Conclusión

Instalar Claude Code es directo: un comando para bajar el instalador, una autorización en el navegador y un pequeño asistente de configuración. Los puntos que merecen lectura cuidadosa son la pantalla de consentimiento (que ata el CLI a su cuota/facturación) y la confirmación de confianza sobre la carpeta de trabajo. Si siguen la recomendación de iniciar Claude dentro de cada proyecto y usar /init y /usage temprano, tendrán una base limpia y controlada para aprovechar las capacidades del modelo en sus flujos de trabajo locales y de servidor.

Para documentación completa y opciones avanzadas consulten: https://docs.claude.com/en/docs/claude-code