¿Qué es Claude Code? Guía completa desde la instalación hasta el primer uso

Qué es Claude Code

Claude Code es un asistente de programación con IA basado en terminal, desarrollado por Anthropic. A diferencia de las extensiones de VS Code, funciona como una herramienta CLI, y esa es su característica principal. Entiende toda tu base de código y puede editar archivos, crear nuevos, ejecutar comandos y manejar operaciones de Git, todo en un solo lugar.

Como no depende de ningún editor específico, puedes usarlo en cualquier entorno de desarrollo.

Instalación

Requisitos previos

• Node.js 18 o posterior instalado
• Una cuenta de Anthropic (plan Max o acceso a la API)

Instalar mediante npm

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

Una vez instalado, verifica la instalación:

claude --version

Autenticación inicial

La autenticación es necesaria en el primer inicio.

claude

Al ejecutar el comando, se abrirá tu navegador para autenticarte con tu cuenta de Anthropic. Una vez completada la autenticación, regresarás a la terminal y estarás listo para comenzar.

Uso básico

Modo interactivo

Solo escribe claude en el directorio raíz de tu proyecto para iniciar una sesión interactiva.

cd my-project
claude

Dentro de la sesión, puedes dar instrucciones en lenguaje natural:

> Explica la estructura de este proyecto
> Agrega una función de validación a src/utils/helper.ts
> Ejecuta los tests y asegúrate de que pasen

Modo de comando único

Para ejecutar un solo comando sin iniciar una sesión interactiva, usa la opción -p:

claude -p "Revisa las dependencias en package.json y lista las que no se usan"

Entrada por tubería (piping)

También puedes enviar datos a Claude Code mediante stdin:

cat error.log | claude -p "Analiza este log de errores y sugiere una solución"

git diff | claude -p "Revisa este diff"

Comandos útiles de barra (slash commands)

Estos son algunos comandos útiles que puedes usar durante una sesión:

Comando	Descripción
/help	Mostrar ayuda
/clear	Limpiar el historial de conversación
/compact	Resumir y comprimir la conversación
/init	Generar un archivo CLAUDE.md
/cost	Mostrar el uso de tokens de la sesión actual

Primeras cosas que probar

1. Comprende tu proyecto

> Explica la arquitectura de este proyecto

Claude Code lee todos los archivos y te da una visión general de la estructura.

2. Genera un CLAUDE.md

> /init

Esto genera automáticamente un archivo de configuración que le indica a Claude Code las reglas y convenciones de tu proyecto.

3. Corrige un bug

> Ejecuta npm test, encuentra los tests que fallan y corrígelos

Claude Code maneja todo el flujo: ejecutar tests, identificar errores y corregir el código.

Configuración de permisos

Dado que Claude Code puede editar archivos y ejecutar comandos, solicita confirmación para cada acción. Puedes pre-aprobar comandos de confianza en tu configuración:

// .claude/settings.json
{
  "permissions": {
    "allow": [
      "Read",
      "Bash(npm test)",
      "Bash(npm run lint)"
    ]
  }
}

Conclusión

Claude Code es fácil de instalar y te permite trabajar con un asistente de programación con IA directamente desde tu terminal. Comienza ejecutando claude en un directorio de proyecto y prueba cosas como explicaciones de código o refactorización. En próximos artículos, cubriremos comparaciones con otras herramientas de IA y flujos de trabajo más avanzados.