Claude Code CLI: configuración paso a paso y los comandos que nadie te cuenta

El problema que nadie admite

Instalaste Claude Code, escribiste tu primer prompt y... funciona. Pero a los tres días sigues usándolo exactamente igual que el primer día. Sin atajos, sin flujos de trabajo reales, sin saber que hay comandos que te ahorran el 40% del tiempo de contexto. Este artículo cierra esa brecha.

Por qué Claude Code CLI merece tu atención técnica

Claude Code no es un wrapper de chat con acceso a tu terminal. Es un agente de codificación con acceso a herramientas reales: lectura y escritura de archivos, ejecución de comandos, búsqueda en el codebase y mantenimiento de contexto entre sesiones. La diferencia entre usarlo como chat y usarlo como agente es la diferencia entre un 10% y un 60% de productividad real.

La CLI está construida sobre la API de Anthropic y corre en Node.js. Eso significa que puedes integrarlo en pipelines CI/CD, scripts bash y flujos de revisión de código sin depender de ninguna interfaz gráfica.

Instalación limpia desde cero

Necesitas Node.js 18 o superior. Verifica tu versión antes de continuar:

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

Una vez instalado, configura tu API key. No la pongas directamente en el comando, usa variables de entorno para no exponerla en el historial de la shell:

export ANTHROPIC_API_KEY="sk-ant-..."
echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc

Verifica que la instalación funciona:

claude --version
claude "dime la versión de node que tengo instalada"

Si ves la respuesta del modelo, estás listo.

Los comandos que el tutorial oficial no enfatiza

Modo continuo vs. modo único

Por defecto, claude "tu prompt" ejecuta una consulta y termina. Para trabajar en sesiones largas donde el modelo mantiene contexto del proyecto, usa el modo interactivo:

claude

Esto abre una REPL donde el contexto persiste. Útil cuando estás refactorizando un módulo completo.

El flag --dangerously-skip-permissions

Por seguridad, Claude Code pide confirmación antes de escribir archivos o ejecutar comandos. En entornos controlados (contenedores Docker, CI/CD), puedes saltarte estas confirmaciones:

claude --dangerously-skip-permissions "refactoriza el módulo auth según el patrón repository"

Pasar contexto desde archivos directamente

En lugar de copiar y pegar código en el prompt, pásalo por stdin:

cat src/api/users.ts | claude "encuentra los posibles memory leaks en este código"

O combina múltiples archivos:

cat src/models/*.ts | claude "documenta cada función pública con JSDoc"

El archivo CLAUDE.md: contexto persistente del proyecto

Este es el truco más infrautilizado. Si colocas un archivo CLAUDE.md en la raíz de tu repositorio, Claude Code lo lee automáticamente en cada sesión como contexto del proyecto. Ejemplo de contenido:

# Contexto del proyecto
- Stack: Next.js 14, TypeScript, Prisma, PostgreSQL
- Convenciones: componentes en PascalCase, hooks en camelCase con prefijo "use"
- Tests: Vitest, archivos *.test.ts junto al módulo
- No usar any en TypeScript salvo excepciones justificadas
- El patrón de error handling es Result del módulo /lib/result.ts

Con esto, no tienes que repetir el stack y las convenciones en cada prompt. El modelo ya sabe dónde está parado.

Flujo de trabajo práctico: revisión de PR en 60 segundos

Este es un caso de uso real que puedes implementar hoy:

git diff main...feature/nueva-funcionalidad | claude "actúa como revisor de código senior. Identifica: 1) bugs potenciales, 2) violaciones de los principios SOLID, 3) ausencia de manejo de errores. Sé concreto, cita líneas."

El resultado es una revisión estructurada basada en el diff real, no en suposiciones.

Integración en scripts bash

Claude Code devuelve la respuesta a stdout, lo que lo hace composable con cualquier script:

#!/bin/bash
ERROR_LOG=$(cat logs/error.log | tail -100)
ANALISIS=$(echo "$ERROR_LOG" | claude "clasifica estos errores por severidad y sugiere las causas más probables")
echo "$ANALISIS" | mail -s "Análisis de errores automático" team@empresa.com

Límites que debes conocer

• Ventana de contexto: en sesiones largas, el contexto se trunca. Si trabajas con repositorios grandes, sé quirúrgico con los archivos que pasas.
• Coste por tokens: las sesiones interactivas consumen tokens de forma continua. Monitoriza tu uso desde el dashboard de Anthropic.
• No tiene acceso a internet: Claude Code no puede buscar documentación externa durante la sesión. Pégala tú si la necesitas.

Siguiente paso concreto

Crea el archivo CLAUDE.md en tu proyecto más activo esta semana. Documenta el stack, las convenciones y los patrones que usas. Luego ejecuta una revisión de código con el diff de tu último PR. Ese único cambio transforma Claude Code de chatbot a colega técnico que conoce tu codebase.

El resto de los comandos avanzados los descubrirás solos una vez que tengas esa base funcionando.