Cómo instalar Claude Code (Anthropic CLI)

📅 1 de marzo de 2026 ⏱ 3 min de lectura

Claude Code Anthropic Terminal Agentes IA

¿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.