Cómo Usar Claude Code en Terminal: Tutorial Paso a Paso [2026]

Claude Code es el agente de código de Anthropic que funciona directamente en tu terminal. Lanzado en febrero de 2025 y evolucionado significativamente en 2026, permite automatizar tareas de desarrollo complejas mediante lenguaje natural.

¿Qué es Claude Code y Por Qué Usarlo?

Claude Code es una herramienta CLI que conecta Claude directamente con tu sistema de archivos, terminal y repositorios Git. A diferencia de usar Claude en chat, Claude Code puede:

• Leer y escribir archivos en tu proyecto
• Ejecutar comandos de terminal
• Navegar repositorios completos
• Hacer commits y crear PRs automáticamente
• Conectarse a APIs externas vía MCP servers

Requisitos Previos

• Node.js 18+ instalado
• Cuenta de Anthropic con API key
• Terminal compatible (bash, zsh, PowerShell)
• macOS, Linux o Windows con WSL
• Un equipo con 16 GB de RAM mínimo — Claude Code funciona en cualquier portátil, pero si además quieres ejecutar modelos locales con Ollama, un Mac Mini M4 o un portátil con GPU como el Acer Nitro V 16 te abren muchas más posibilidades

Instalación de Claude Code

Paso 1: Instalar via npm

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

Paso 2: Configurar API Key

1export ANTHROPIC_API_KEY="tu-api-key-aqui"

Para hacerlo permanente, añade la línea a tu .bashrc o .zshrc.

Paso 3: Verificar Instalación

1claude --version

Primeros Comandos con Claude Code

Iniciar una Sesión

1cd tu-proyecto
2claude

Esto abre una sesión interactiva donde puedes escribir peticiones en lenguaje natural.

Ejemplos de Comandos Básicos

Explorar el proyecto:

1¿Qué hace este proyecto? Dame un resumen de la arquitectura.

Crear un archivo:

1Crea un componente React llamado UserProfile con TypeScript.

Refactorizar código:

1Refactoriza la función processData en utils.ts para usar async/await.

Corregir bugs:

1El test en user.test.js está fallando. Analiza y corrige el problema.

Configuración Avanzada: MCP Servers

MCP (Model Context Protocol) es el "USB-C de la IA" - un estándar que permite a Claude Code conectarse con herramientas externas.

Configurar MCP Servers

Crea el archivo ~/.claude/claude_desktop_config.json:

1{
2  "mcpServers": {
3    "filesystem": {
4      "command": "npx",
5      "args": ["-y", "@anthropic-ai/mcp-server-filesystem", "/ruta/proyectos"]
6    },
7    "github": {
8      "command": "npx",
9      "args": ["-y", "@anthropic-ai/mcp-server-github"],
10      "env": {
11        "GITHUB_TOKEN": "tu-token"
12      }
13    }
14  }
15}

MCP Servers Más Útiles

Flujos de Trabajo Reales

Flujo 1: Code Review Automático

1Revisa los cambios en el último commit. Busca bugs potenciales,
2problemas de seguridad y sugiere mejoras de rendimiento.

Flujo 2: Documentación Automática

1Genera documentación JSDoc para todas las funciones públicas
2en src/services/. Incluye ejemplos de uso.

Flujo 3: Tests Automáticos

1Crea tests unitarios con Jest para el módulo auth.ts.
2Cubre casos de éxito, error y edge cases.

Flujo 4: Migración de Código

1Migra este proyecto de JavaScript a TypeScript.
2Añade tipos estrictos y mantén la funcionalidad.

Mejores Prácticas

1. Sé Específico en tus Peticiones

Malo: "Arregla el código"

Bueno: "En src/api/users.ts, la función getUser no maneja el caso cuando el usuario no existe. Añade manejo de errores y retorna null."

2. Usa el Contexto del Proyecto

Claude Code lee automáticamente archivos relevantes. Aprovecha esto:

1Siguiendo el patrón de los otros servicios en src/services/,
2crea un nuevo servicio para gestionar notificaciones.

3. Itera en Pasos Pequeños

En lugar de pedir cambios masivos, divide en tareas:

1. "Primero, analiza la estructura actual"
2. "Ahora, crea el esqueleto del nuevo módulo"
3. "Finalmente, implementa la lógica de negocio"

4. Revisa Antes de Confirmar

Claude Code pide confirmación antes de cambios destructivos. Siempre revisa el diff antes de aceptar.

Comparativa: Claude Code vs Cursor vs Windsurf

Troubleshooting Común

Error: "Permission denied"

1chmod +x $(which claude)

Error: "API key invalid"

Verifica que la key esté correctamente exportada:

1echo $ANTHROPIC_API_KEY

Claude Code no encuentra archivos

Asegúrate de ejecutar claude desde la raíz del proyecto.

Conclusión

Claude Code transforma cómo los desarrolladores interactúan con su código. Con MCP servers y su comprensión profunda de proyectos completos, es una herramienta esencial para cualquier programador en 2026.

Próximos pasos recomendados:

1. Instala Claude Code siguiendo este tutorial
2. Configura al menos el MCP server de filesystem
3. Empieza con tareas pequeñas y ve aumentando complejidad
4. Explora la documentación oficial de MCP