Documentación de la CLI de Claude Code — Comandos, opciones y modo sin interfaz interactiva (2026)

Inicio

claude                          # interactive session
claude "fix the failing test"   # start with a prompt
claude -p "summarise this repo"  # print mode: answer, then exit
claude -c                       # continue the most recent session
claude -r                       # pick a session to resume
claude --model claude-opus-5    # choose the model for this session

Opciones que conviene conocer

-p, --print — no interactivo; recibe la entrada por una tubería y devuelve la salida. La base de cualquier uso en scripts y CI.
--output-format text|json|stream-json — salida estructurada para el modo de impresión.
--model <id> — cualquier modelo que ofrezca el endpoint (/v1/models en esta pasarela los enumera).
--allowedTools "Read,Edit,Bash(git *)" — autoriza las herramientas de antemano para que el modo de impresión nunca se bloquee esperando confirmación.
--dangerously-skip-permissions — sin solicitudes de confirmación. Solo dentro de un contenedor o entorno aislado que puedas desechar.
--max-turns N — limita el bucle del agente en ejecuciones sin interfaz interactiva.
--add-dir <path> — permite que la sesión trabaje en más de un directorio.

Comandos con barra dentro de una sesión

/init — escribe un archivo CLAUDE.md para el proyecto (convenciones, comandos de compilación y qué evitar).
/compact [focus] — resume la conversación para liberar contexto; la medida más eficaz para controlar los costes.
/clear — empieza de nuevo con un contexto vacío.
/model — cambia de modelo durante la sesión; /cost — tokens y gasto acumulados; /status — endpoint, clave, modelo y versión.
/permissions — lo que el agente puede hacer sin preguntar; /config — configuración; /memory — edita los archivos de memoria.
/mcp — servidores MCP conectados; /agents — define y gestiona subagentes; /hooks — hooks de shell para eventos de herramientas.
/review — revisa una solicitud de incorporación de cambios; /doctor — diagnostica la instalación; /help — todo lo demás.

claude setup-token: autenticación de larga duración para CI con una suscripción

claude setup-token inicia sesión una vez en un navegador y muestra un token OAuth de larga duración para una suscripción Claude Pro/Max, pensado para entornos sin interfaz interactiva donde /login no es posible. Expórtalo como CLAUDE_CODE_OAUTH_TOKEN en CI y el modo de impresión consumirá la cuota de la suscripción. Es exclusivo para suscripciones; con una clave de API (de Anthropic o de una pasarela), este paso no es necesario: configura ANTHROPIC_API_KEY en su lugar.

Modo de impresión para scripts y CI

cat error.log | claude -p "explain the root cause in three lines"

claude -p "write a changelog entry for the staged diff" \
  --allowedTools "Read,Bash(git diff *)" \
  --output-format json

El modo de impresión es la forma en que la acción de GitHub, las integraciones con editores y el Agent SDK usan Claude Code. Con ANTHROPIC_BASE_URL configurado para apuntar a la pasarela, estas ejecuciones se facturan contra tu saldo de la pasarela o tu plan ilimitado en lugar de una cuenta de Anthropic.

Dónde se guarda la configuración

CLAUDE.md en la raíz del repositorio (y CLAUDE.local.md para notas personales) — memoria del proyecto, que se lee en cada sesión.
.claude/settings.json — permisos, hooks y variables de entorno por proyecto; ~/.claude/settings.json — configuración global.
~/.claude/skills/ y .claude/skills/ — habilidades; .claude/agents/ — definiciones de subagentes.
Entorno: ANTHROPIC_BASE_URL, ANTHROPIC_API_KEY / ANTHROPIC_AUTH_TOKEN, y las sustituciones de modelo por nivel descritas en la guía de modelos.

Pruébalo gratis primero

Las cuentas nuevas reciben $5 de crédito gratuito para la API con el código CLAUDECODE — suficiente para una tarde de Claude Code con Sonnet — y después créditos por 7.69231× su valor nominal.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Crea una cuenta con el código CLAUDECODE

Preguntas frecuentes

¿Cómo ejecuto Claude Code sin el prompt interactivo?

Usa el modo de impresión: claude -p "tu prompt". Combínalo con --allowedTools y --output-format json para scripts, y envía archivos por una tubería a stdin.

¿Qué hace /compact?

Pide al modelo que resuma la conversación hasta ese momento y sustituye el historial por ese resumen. El contexto se reduce, el coste por turno baja y la sesión puede continuar. Ejecútalo siempre que una tarea cambie de rumbo.

¿Puedo usar Claude Code con una URL base de API diferente?

Sí: configura ANTHROPIC_BASE_URL. /status confirma qué endpoint está usando la sesión.

Ejecuta Claude Code con la pasarela

Los mismos modelos, dos variables de entorno y créditos por 7.69231× su valor nominal, o un plan ilimitado de tarifa plana. Cuentas nuevas: $5 de crédito gratuito para la API con el código CLAUDECODE.

Obtener una clave de API Ver planes ilimitados

AI Prime Tech es una pasarela API independiente y no está afiliada a Anthropic, ni cuenta con su respaldo o patrocinio. «Claude» y «Claude Code» son marcas comerciales de Anthropic. Las funciones de Claude Code descritas aquí se basan en la documentación pública de Anthropic en el momento de la redacción y cambian con frecuencia; los precios y las listas de modelos de esta página se obtienen de la configuración actual de esta pasarela.

Documentación de la CLI de Claude Code: comandos y opciones

TLDR