Cómo instalar Claude Code (Anthropic CLI)

¿Qué es Claude Code?

Claude Code es una herramienta de línea de comandos desarrollada por Anthropic que permite a Claude trabajar directamente en tu terminal. A diferencia de los chatbots, Claude Code puede leer y editar archivos, ejecutar comandos, buscar en tu codebase y gestionar flujos de trabajo de Git de forma autónoma.

Requisitos previos

• Node.js 18 o superior
• Git instalado y configurado
• Cuenta de Anthropic con acceso a la API (plan Pro, Max o Team de Claude)
• Terminal con soporte UTF-8

Verifica tu versión de Node:

node --version  # Debe ser >= 18.0.0
npm --version   # Debe ser >= 9.0.0

Paso 1: Instalar Claude Code

La instalación se hace globalmente con npm:

npm install -g @anthropic-ai/claude-code

Verifica que se instaló correctamente:

claude --version

Paso 2: Autenticación

Al ejecutar Claude Code por primera vez, necesitas autenticarte:

# Navega a tu proyecto
cd tu-proyecto

# Inicia Claude Code
claude

# Se abrirá el navegador para autenticarte con tu cuenta de Anthropic

Si prefieres usar una API key directamente:

export ANTHROPIC_API_KEY="sk-ant-api03-..."
claude

Paso 3: Primeros comandos

Una vez dentro de la sesión interactiva de Claude Code:

# Pide que analice tu proyecto
> resume este proyecto y su arquitectura

# Haz cambios en el código
> añade validación de inputs en el formulario de contacto

# Ejecuta y depura
> ejecuta los tests y corrige los que fallen

# Gestión de Git
> haz commit de los cambios con un mensaje descriptivo

Paso 4: Configuración avanzada

Archivo CLAUDE.md

Crea un archivo CLAUDE.md en la raíz de tu repositorio con instrucciones para Claude Code:

# Instrucciones para Claude Code

## Stack
- Frontend: Astro + Tailwind CSS
- Lenguaje: TypeScript estricto
- Tests: Vitest

## Convenciones
- Componentes en PascalCase
- Commits en español, formato convencional
- No usar `any` en TypeScript

Configuración del modelo

# Usar un modelo específico
claude --model claude-sonnet-4-20250514

# Limitar el uso de tokens
claude --max-turns 10

Modos de uso

Modo interactivo (por defecto)

claude

Se abre una sesión REPL donde conversas con Claude en tiempo real.

Modo one-shot

claude -p "describe la estructura de este proyecto"

Ejecuta un prompt y devuelve la respuesta sin sesión interactiva.

Modo headless (para CI/CD)

claude -p "ejecuta el linter y corrige errores" --allowedTools "edit,bash" --json

Ideal para automatización en pipelines.

Permisos y seguridad

Claude Code pide confirmación antes de:

• Ejecutar comandos de terminal
• Modificar archivos fuera del directorio del proyecto
• Hacer operaciones destructivas de Git

Puedes preconfigurar permisos en .claude/settings.json:

{
  "permissions": {
    "allow": ["edit", "read", "bash"],
    "deny": ["rm -rf", "git push --force"]
  }
}

Solución de problemas

Problema	Solución
command not found: claude	Verifica que npm global bin está en tu PATH
Error de autenticación	Ejecuta claude auth logout y vuelve a autenticarte
Respuestas lentas	Comprueba tu conexión; Claude Code necesita acceso a la API
No lee archivos grandes	Usa @file.ts para referenciar archivos específicos

Claude Code es especialmente útil para refactorizaciones grandes, depuración guiada y automatización de tareas repetitivas de desarrollo.

Preguntas frecuentes

¿Claude Code es gratuito?

Claude Code requiere una API key de Anthropic, que funciona con un modelo de pago por uso. No hay un plan gratuito específico para Claude Code, pero Anthropic ofrece créditos iniciales para nuevos usuarios. Consulta los precios actualizados en la página oficial.

¿Puedo usar Claude Code con cualquier lenguaje de programación?

Sí. Claude Code funciona con cualquier lenguaje de programación y cualquier tipo de proyecto. Es especialmente fuerte en TypeScript, Python, Rust y Go, pero puede trabajar con cualquier código fuente.

¿Claude Code lee todo mi repositorio?

Claude Code analiza tu repositorio para entender la estructura y el contexto, pero solo envía a la API los fragmentos relevantes para tu consulta. Puedes configurar qué archivos se excluyen en .claude/settings.json.

¿Es seguro usar Claude Code con código privado?

Anthropic afirma que no utiliza el código enviado a la API para entrenar sus modelos. Para proyectos con requisitos de confidencialidad estrictos, revisa los términos de uso de la API y considera la configuración de permisos.

Fuentes y referencias

• Claude Code — Documentación oficial — Anthropic
• Precios de la API de Anthropic — Anthropic (consultado en abril 2026)
• Claude Code en GitHub — Repositorio oficial