Claude Code CLI

Claude Code es el agente de codificación de IA oficial de Anthropic — se ejecuta en tu terminal y te permite escribir, depurar y refactorizar código en lenguaje natural.

Paso 1 — Instalar Node.js

Omite esto si ya lo tienes; verifícalo con node -v.

Necesitas Node.js 18+ — descarga: https://nodejs.org/en/download

# Verify after installing
node -v
# A version number (e.g. v24.4.1) means it installed correctly

# During install, check "Automatically install the necessary tools"
# Reopen PowerShell after installing and verify
node -v

Paso 2 — Instalar Claude Code

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

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

Verifica la instalación:

claude --version

npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code

Paso 3 — Configurar la API de LMU AI

Claude Code configura un endpoint de API personalizado a través de settings.json.

Ubicación del archivo de configuración

~/.claude/settings.json

C:\Users\YourUsername\.claude\settings.json

Crear el archivo de configuración

mkdir -p ~/.claude && touch ~/.claude/settings.json

mkdir "$env:USERPROFILE\.claude" -Force
New-Item "$env:USERPROFILE\.claude\settings.json" -Force

Escribir la configuración

Abre settings.json en un editor de texto y agrega lo siguiente (reemplaza la clave por la tuya):

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.lmuai.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-lmu-ai-api-key",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

Habilitar el contexto de 1M en Claude Code (opcional)

Claude Opus 4.8 / Sonnet 5 admiten una ventana de contexto largo de 1M tokens (200K de forma predeterminada), útil para repositorios enormes, registros largos y refactorizaciones entre archivos. Agrega el sufijo [1M] al ID del modelo para habilitarla.

Opción A — cambio manual con /model (recomendado para uso ocasional)

Mantén un settings.json mínimo (solo ANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKEN), inicia Claude Code y escribe en el prompt:

/model claude-opus-5[1M]

o:

/model claude-sonnet-5[1M]

Esto cambia a la versión de 1M sin cambios de configuración. Se aplica a la sesión actual y se revierte al salir.

Opción B — un valor predeterminado permanente en settings.json (recomendado para uso diario de contexto largo)

Agrega dos líneas a la sección env de settings.json para que /model opus / /model sonnet usen de forma predeterminada la versión de 1M:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.lmuai.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-lmu-ai-api-key",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5[1M]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5[1M]",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

Guarda y reinicia Claude Code; al seleccionar opus / sonnet en el comando /model ahora se usa automáticamente la versión de 1M.

Referencia de campos

Usar modelos chinos (opcional)

LMU AI admite LLM chinos (por ejemplo, la serie Qwen). Al establecer model en settings.json, evitas el cambio manual con /model en cada inicio y usas directamente el modelo especificado.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.lmuai.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-lmu-ai-api-key",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  },
  "model": "qwen3.8-max-preview",
  "effortLevel": "medium"
}

Referencia de campos:

Paso 4 — Iniciar Claude Code

Abre una terminal en el directorio de tu proyecto y ejecuta:

claude

Modo sin aprobación (recomendado)

claude --dangerously-skip-permissions

En este modo, Claude Code ejecuta comandos automáticamente sin confirmar cada paso — práctico dentro de un directorio de proyecto.

Verificar la configuración

Después de iniciar, escribe en la interfaz de Claude Code:

/status

Muestra lo actual:

• Nombre del modelo
• Base URL de la API (debería mostrar https://api.lmuai.com)
• Estado de la clave de API

Si la Base URL es correcta, la configuración está funcionando.

Problemas comunes

401 Unauthorized

Causa: la clave de API es incorrecta, o la solicitud aún fue al endpoint oficial de Anthropic.

Solución:

1. Confirma que ANTHROPIC_AUTH_TOKEN en settings.json sea tu clave de LMU AI
2. Verifica si una variable de entorno del shell está anulando la configuración

echo $ANTHROPIC_BASE_URL

echo $env:ANTHROPIC_BASE_URL

3. Vuelve a abrir la terminal y luego inicia Claude Code de nuevo

stream disconnected

Causa: una red local inestable, o un VPN / proxy / proxy del sistema está activo — un proxy que rota la IP rompe la conexión.

Solución: desactiva el VPN / proxy / proxy del sistema y reintenta. LMU AI es una conexión nacional directa y no necesita VPN; una conexión directa es la más rápida y estable.

503 No available accounts

Causa: normalmente ~/.zshrc o ~/.bashrc establece variables de entorno globales como ANTHROPIC_AUTH_TOKEN / ANTHROPIC_BASE_URL, que anulan settings.json.

Solución: elimina esas líneas de la configuración de tu shell, o muévelas a un archivo separado que solo hagas source al iniciar Claude Code. Consulta FAQ · Problema 6.

Tiempos de espera de respuesta

Causa: el tiempo de espera predeterminado es corto.

Solución: confirma que API_TIMEOUT_MS esté establecido en 3000000 (50 minutos) para que las tareas largas no se corten.

Consejos

• Inicia Claude Code desde la raíz del proyecto para que capte automáticamente la estructura del proyecto
• Pasa una instrucción directamente, por ejemplo, claude "refactoriza esta función por mí"
• Ctrl+C interrumpe la tarea actual, /exit sale
• Escribe ? o /help para ver todos los comandos

Usar /goal para que Claude Code trabaje hasta cumplir el objetivo (opcional)

/goal es un comando de barra integrado de Claude Code (disponible desde la v2.1.139, mayo de 2026) que establece una condición de finalización para la sesión actual. Una vez establecida, Claude continúa por sí mismo a lo largo de los turnos hasta que se juzga que la condición se cumple, en lugar de detenerse cuando "parece que ya está". Es especialmente práctico en LMU AI para tareas largas de ejecución hasta el final (refactorizaciones de repositorios grandes, implementación según una especificación de aceptación, resolución de una acumulación de issues).

Las versiones más antiguas no tienen este comando. Si informa de un comando desconocido, primero actualiza Claude Code a la última versión.

Uso básico

Una sesión tiene solo un objetivo a la vez; establecer uno nuevo reemplaza el anterior e inicia un nuevo turno de inmediato.

Cómo juzga que se "cumplió"

Al final de cada turno, Claude Code entrega tu condición de finalización + la conversación de este turno a un modelo pequeño y rápido (Haiku de forma predeterminada) para que juzgue. El juez solo observa la evidencia ya presente en la conversación — resultado de pruebas, registros de compilación, diferencias de archivos — y no volverá a ejecutar todo tu CI a tus espaldas. Así que escribe la condición de una forma en la que Claude pueda "producir evidencia" en la conversación.

El objetivo se borra automáticamente en cualquiera de estos casos:

• se juzga que la condición se cumple;
• el modelo juzga que la condición es imposible de satisfacer;
• un turno encuentra un error que requiere tu intervención.

Cómo escribir una buena condición de objetivo

• Usa un estado final verificable: por ejemplo, "npm test sale con 0", "tsc --noEmit no reporta errores" — no descripciones subjetivas como "haz el código más bonito";
• Deja que la evidencia llegue a la conversación: imprime los resultados de las pruebas / compilación en cada turno para que el modelo juez pueda verlos;
• Delimita el alcance + limita los turnos: por ejemplo, "solo cambia archivos bajo src/auth/, detente después de un máximo de 20 turnos" para evitar que se quede dando vueltas;
• Requiere un espacio de trabajo de confianza (hooks habilitados) para que tenga efecto.

Última actualización: 2026-09-10