Referencia de la CLI

Introducción

El CLI (Interfaz de línea de comandos) es la forma principal de interactuar con Claude Code. Proporciona opciones poderosas para ejecutar consultas, gestionar sesiones, configurar modelos e integrar a Claude en sus flujos de trabajo de desarrollo.

Arquitectura

graph TD
    A["Terminal de usuario"] -->|"claude (opciones) (consulta)"| B["Claude Code CLI"]
    B -->|Interactive| C["Modo REPL"]
    B -->|"-print"| D["Modo de impresión (SDK)"]
    B -->|"-reanudar"| E["Continuación de la sesión"]
    C -->|Conversation| F["API de Claude"]
    D -->|Consulta única| F
    E -->|Contexto de carga| F
    F -->|Response| G["Output"]
    G -->|text/json/stream-json| H["Terminal/Pipe"]

Tiempo de ejecución y embalaje

Desde v2.1.113, Claude Code CLI lanza un binario nativo por plataforma (macOS, Linux, Windows) a través de dependencias opcionales npm. El binario se corresponde con su sistema operativo y arquitectura en el momento de instalación — el tiempo de ejecución más antiguo-JavaScript ya no es el predeterminado en macOS o Linux.

Los instalación recomendada es el instalador nativo (curl -fsSL https://claude.ai/install.sh | bash; en Windows irm https://claude.ai/install.ps1 | iex) la instalación de npm se despreca en el README oficial; prefiera el instalador nativo, Homebrew (brew install --cask claude-codeo WinGet (winget install Anthropic.ClaudeCode) Para consulta, npm install -g @anthropic-ai/claude-code (Node.js 22+) instala el mismo binario nativo a través de una dependencia opcional por plataforma.

Descarga del host (v2.1.116+): los artefactos de origen binario se sirven desde https://downloads.claude.ai/claude-code-releases.

Usuarios corporativos/proxy: Si su red requiere una lista de permisos explícita, añadir downloads.claude.ai (y https://downloads.claude.ai/claude-code-releases) a las reglas de salida del proxy. Entornos que anteriormente sólo permiten la lista storage.googleapis.com o el registro npm tendrá que ser actualizado o claude update y la instalación inicial fallará.

El paquete JavaScript anterior todavía se produce para Windows y para los entornos que se le clavan; esas instalaciones continúan enviando Glob y Grep como herramientas de primera clase (ver la nota de Glob/Grep en Herramientas).

Comandos CLI

Banderas básicas

Modo restringido (--restricted, v2.1.248+)

--restricted (o CLAUDE_CODE_RESTRICTED=1) es para correr claude en nombre de alguien cuya entrada no controla — un arnés de evaluación en una máquina compartida, un trabajo de CI activado por un colaborador externo, una caja de demostración. Aplica todo lo siguiente:

• Elimina las herramientas que ejecutan órdenes o código — Bash, PowerShell, y la REPL — además de WebFetch, a menos que --tools explícitamente los nombres.
• Ignora los archivos de configuración local, de proyecto y de usuario. Configuración administrada y una configuración explícita --settings todavía se aplica el archivo, por lo que un administrador mantiene el control mientras se registra .claude/settings.json no puede ensanchar la caja de arena.
• Confine las herramientas de archivo a los directorios de trabajo, así que lee y escribe no puede escapar de los caminos que comenzó en.
• Rechaza bypassPermissions, cualquiera que sea la forma que se solicite.
• Se niega a crear sesiones en la nube, por lo que una carrera restringida no puede empujar el trabajo fuera de la máquina.

# Evaluation harness: no shell, no network fetches, no settings inheritance
claude --restricted -p "summarize the architecture of this repo"

# Same lockdown, but deliberately re-enable one tool
claude --restricted --tools WebFetch -p "check the linked RFC"

Nota: --restricted es una cerradura más gruesa que --permission-mode. Elimina las herramientas de plano en lugar de impulsarlas, por lo que una sesión restringida no puede ampliarse desde el interior de la sesión.

Modo interactivo vs de impresión

graph LR
    A["claude"] -->|Default| B["REPL interactivo"]
    A -->|"-P flag"| C["Modo de impresión"]
    B -->|Features| D["Conversación multiturno<br>Terminación de pestañas<br>Histórico<br>Comandos de barra"]
    C -->|Features| E["Consulta única<br>Scriptable<br>Pipable<br>Salida JSON"]

Modo interactivo (por defecto):

# Start interactive session
claude

# Start with initial prompt
claude "explain the authentication flow"

Modo de impresión (no interactivo):

# Single query, then exit
claude -p "what does this function do?"

# Process file content
cat error.log | claude -p "explain this error"

# Chain with other tools
claude -p "list todos" | grep "URGENT"

& Configuración del modelo

Ejemplos de selección de modelos

# Use Opus 5.5 for complex tasks
claude --model opus "design a caching strategy"

# Use Haiku for quick tasks (Haiku 5.5 on the Anthropic API since v2.1.293; Haiku 4.5 on Bedrock, Vertex, and Foundry)
claude --model haiku -p "format this JSON"

# Full model name
claude --model claude-sonnet-4-6 "review this code"

# With fallback for reliability
claude -p --model opus --fallback-model sonnet "analyze architecture"

# Use opusplan (Opus plans, Sonnet executes)
claude --model opusplan "design and implement the caching layer"

Descubrimiento de modelos de pasarela (v2.1.129+, opt-in): Cuando ANTHROPIC_BASE_URL puntos en un portal compatible con Anthrópica, conjunto CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 para poblar /model de la puerta de entrada /v1/models sin el env var, /model La bandera está opt-in (cambiada en v2.1.129) porque la llamada de descubrimiento puede aparecer modelos que un usuario puede no tener derecho a usar; v2.1.126 lo hizo implícito y ese comportamiento fue revertido.

Contexto 1M detrás de una URL base personalizada (v2.1.285): Sesiones de los cuales ANTHROPIC_BASE_URL los puntos en un punto final personalizado ahora utilizan la ventana de contexto 1M de modelos que tienen uno (Opus 4.7+, Sonnet 5+, Fable). Si su puerta de enlace se detiene a 200K, ejecute /autocompact 200k.

Contexto de 1M por defecto en proveedores terceros (v2.1.287): El Opus 4.7+ y Fable ahora usan la ventana de contexto 1M por defecto en Amazon Bedrock, Google Vertex AI, Microsoft Foundry y el portal de aplicaciones de Claude, sin [1m] Sufijo. CLAUDE_CODE_DISABLE_1M_CONTEXT=1 para mantenerlos a 200K.

Modelo predeterminado de la organización (v2.1.196): Cuando un administrador de org establece un modelo predeterminado, /model lo etiqueta como "Org default" (o "Role default").

Personalización rápida del sistema

Ejemplos rápidos del sistema

# Complete custom persona
claude --system-prompt "You are a senior security engineer. Focus on vulnerabilities."

# Append specific instructions
claude --append-system-prompt "Always include unit tests with code examples"

# Load complex prompt from file
claude -p --system-prompt-file ./prompts/code-reviewer.txt "review main.py"

Comparación de banderas del sistema rápido

Todas las banderas del sistema funcionan tanto en modo interactivo como de impresión (los formularios de archivo desde v2.1.69). --system-prompt y --system-prompt-file reemplazar el prompt predeterminado; los indicadores de añadir añadir a él.

Administración de herramientas y permisos

Actualización v2.1.111: --enable-auto-mode se eliminó; el modo automático está ahora en el Shift+Tab ciclo por defecto — uso --permission-mode auto para empezar directamente en él.

Nota de Glob/Grep (v2.1.113+): En las construcciones nativas de macOS/Linux, Glob y Grep se proporcionan como el bfs y ugrep binarios invocados a través de la herramienta Bash en lugar de como herramientas separadas de primera clase. Windows y npm-bundled (JS) instala todavía exponerlos como herramientas independientes. allowedTools / disallowedTools listas la sustitución de backend es transparente — puede seguir refiriéndose a Glob / Grep en su configuración en cada plataforma.

Auto-aprobación de PowerShell (v2.1.119): Los comandos de herramienta PowerShell pueden ser aprobados automáticamente en modo de permiso exactamente de la misma manera que los comandos Bash. Utilice la misma sintaxis de emparejador que ya utiliza para Bash(...) reglas para ampliar los permisos PowerShell, por ejemplo, PowerShell(Get-ChildItem:*).

--permission-mode honrado en curriculum vitae (v2.1.132+): claude -p --continue --permission-mode plan (y --resume) ahora respeta la bandera. Versiones anteriores silenciosamente --permission-mode cuando se reanuda una sesión, así que una sesión de modo de plan se reanuda sin repasar la bandera se rebajaría silenciosamente, eso está arreglado.

Se endurece el permiso (v2.1.214): Comandos Docker/Podman usando banderas redirigidas por demonio (p. ej. --url, --connection, --identity) ahora requieren un aviso de permiso en lugar de ejecutarse automáticamente. file comandos usando -m/--magic-file o -f/--files-from ahora también requieren permiso. Los comandos de Bash de más de 10.000 caracteres siempre piden permiso, independientemente de las reglas de permisos.

Ejemplos de permisos

# Read-only mode for code review
claude --permission-mode plan "review this codebase"

# Restrict to safe tools only
claude --tools "Read,Grep,Glob" -p "find all TODO comments"

# Allow specific git commands without prompts
claude --allowedTools "Bash(git status:*)" "Bash(git log:*)"

# Block dangerous operations
claude --disallowedTools "Bash(rm -rf:*)" "Bash(git push --force:*)"

Coincidencia de parámetros Tool(param:value) (v2.1.178): Reglas de permiso siguen el formato Tool (cada uso) o Tool(specifier). A partir de v2.1.178, un especificador puede coincidir con la entrada de una herramienta parámetros, no sólo comandos o patrones de ruta — utilizando el Tool(param:value) forma con soporte comodín. Esto generaliza el emparejamiento que ya utiliza para Bash(...) prefijos de comandos (por ejemplo: Bash(npm run test *)) y Read(...) globs de camino (por ejemplo: Read(./.env.*)) por lo que otras herramientas pueden ser alcances por sus argumentos. Compruebe el referencia de permisos para las cadenas de ejemplo actuales por herramienta antes de escribir una regla, ya que los nombres exactos del parámetro difieren según la herramienta.

& Formato de salida

Ejemplos de formato de salida

# Plain text (default)
claude -p "explain this code"

# JSON for programmatic use
claude -p --output-format json "list all functions in main.py"

# Streaming JSON for real-time processing
claude -p --output-format stream-json "generate a long report"

# Structured output with schema validation
claude -p --json-schema '{"type":"object","properties":{"bugs":{"type":"array"}}}' \
  "find bugs in this code and return as JSON"

& Directorio de espacio de trabajo

/config persistencia (v2.1.119): Cambios realizados interactivamente a través de la /config comando ahora se escriben en ~/.claude/settings.json y participar en la cadena de precedencia normal (política → local → proyecto → usuario). Antes de v2.1.119, algunos /config los cambios fueron sólo de sesión. & Configuración de memoria para la orden de precedencia completa. --settingsLa configuración de carga del archivo o JSON. El archivo no debe ser mayor que 2 MiB (v2.1.214)claude --settings ./settings.json | | --plugin-dirCargar complementos desde el directorio (repetible). Desde v2.1.265 también acepta uncarpeta de complementos — cada carpeta infantil con una carga de manifiesto, y los niños añadidos o eliminados mientras se recoge la sesión claude --plugin-dir ./my-plugin |

Ejemplo multidirectorio

# Work across multiple project directories
claude --add-dir ../frontend ../backend ../shared "find all API endpoints"

# Load custom settings
claude --settings '{"model":"opus","verbose":true}' "complex task"

Configuración MCP

Ejemplos de MCP

# Load GitHub MCP server
claude --mcp-config ./github-mcp.json "list open PRs"

# Strict mode - only specified servers
claude --strict-mcp-config --mcp-config ./production-mcp.json "deploy to staging"

Gestión de las sesiones

Ejemplos de sesión

# Continue last conversation
claude -c

# Resume named session
claude -r "feature-auth" "continue implementing login"

# Fork session for experimentation
claude --resume feature-auth --fork-session "try alternative approach"

# Use specific session ID
claude --session-id "550e8400-e29b-41d4-a716-446655440000" "continue"

v2.1.299: El comando curriculum vitae impreso al salir nombra la sesión por su ID.

Horquilla de la sesión

Crear una rama desde una sesión de experimentación existente:

# Fork a session to try a different approach
claude --resume abc123 --fork-session "try alternative implementation"

# Fork with a custom message
claude -r "feature-auth" --fork-session "test with different architecture"

Casos de uso: - Probar implementaciones alternativas sin perder la sesión original - Experimentar con diferentes enfoques en paralelo - Crear ramas de trabajo exitoso para variaciones - Ensayo de cambios de ruptura sin afectar a la sesión principal

La sesión original no ha cambiado, y el tenedor se convierte en una nueva sesión independiente.

Limpieza del estado del proyecto (v2.1.126+)

claude purge elimina todos los estados locales de Claude Code para un proyecto — transcripciones, listas de tareas, registros de depuración, historial de edición de archivos, líneas de historial de notificaciones y el proyecto ~/.claude.json Se llamaba entrada claude project purge antes de v2.1.288; ese nombre todavía funciona e imprime un aviso. --dry-run primero para previsualizar la eliminación; --all camina cada proyecto en la máquina.

# Preview what would be deleted (safe)
claude purge ~/work/repo --dry-run

# Delete state for a specific project, no prompts
claude purge ~/work/repo --yes

# Walk every project interactively
claude purge --all --interactive

Funciones avanzadas

Notas sobre plataformas y temas (v2.1.112)

• Herramienta PowerShell en Windows: Una herramienta PowerShell dedicada se está implementando en Windows y es controlable a través de la variable de entorno.
• Tema automático (terminal de emparejamiento): El nuevo tema "Auto (terminal de partido)" sincroniza la apariencia ligera/oscura de Claude Code con su terminal.
• Solicitudes de permisos más silenciosas: Solo lectura Bash invocaciones e Glob los patrones ya no activan los avisos de permisos.

Ejemplos avanzados

# Limit autonomous actions
claude -p --max-turns 5 "refactor this module"

# Debug API calls
claude --debug=api "test query"

# Enable IDE integration
claude --ide "help me with this file"

Configuración de agentes

Los --agents flag acepta un objeto JSON que define subagentes personalizados para una sesión.

A partir de v2.1.243, --agents ya no ignora en silencio la definición de agente inválido JSON o una definición de agente inválida — sale con un error claro, emparejando cómo --mcp-config ya se comportó.

Agentes JSON Format

{
  "agent-name": {
    "description": "Required: when to invoke this agent",
    "prompt": "Required: system prompt for the agent",
    "tools": ["Optional", "array", "of", "tools"],
    "model": "optional: sonnet|opus|haiku"
  }
}

Campos requeridos: - description - Descripción del lenguaje natural de cuándo usar este agente - prompt - Sistema que define el papel y el comportamiento del agente

Campos opcionales: - tools - Array de herramientas disponibles (hereda todo si se omite) - Formato: ["Read", "Grep", "Glob", "Bash"] - model - Modelo a utilizar: sonnet, opuso bien haiku

Ejemplo de agentes completos

{
  "code-reviewer": {
    "description": "Expert code reviewer. Use proactively after code changes.",
    "prompt": "You are a senior code reviewer. Focus on code quality, security, and best practices.",
    "tools": ["Read", "Grep", "Glob", "Bash"],
    "model": "sonnet"
  },
  "debugger": {
    "description": "Debugging specialist for errors and test failures.",
    "prompt": "You are an expert debugger. Analyze errors, identify root causes, and provide fixes.",
    "tools": ["Read", "Edit", "Bash", "Grep"],
    "model": "opus"
  },
  "documenter": {
    "description": "Documentation specialist for generating guides.",
    "prompt": "You are a technical writer. Create clear, comprehensive documentation.",
    "tools": ["Read", "Write"],
    "model": "haiku"
  }
}

Ejemplos de comandos de agentes

# Define custom agents inline
claude --agents '{
  "security-auditor": {
    "description": "Security specialist for vulnerability analysis",
    "prompt": "You are a security expert. Find vulnerabilities and suggest fixes.",
    "tools": ["Read", "Grep", "Glob"],
    "model": "opus"
  }
}' "audit this codebase for security issues"

# Load agents from file
claude --agents "$(cat ~/.claude/agents.json)" "review the auth module"

# Combine with other flags
claude -p --agents "$(cat agents.json)" --model sonnet "analyze performance"

Prioridad del agente

Cuando existen definiciones de agentes múltiples, se cargan en este orden de prioridad: 1. CLI-definido (--agents bandera) - Específica de la sesión 2. Nivel del proyecto (.claude/agents/) - Proyecto actual 3. Nivel de usuario (~/.claude/agents/Todos los proyectos

Los agentes definidos por CLI anulan tanto los agentes de proyecto como los de usuario para la sesión. Los agentes a nivel de proyecto anulan los agentes a nivel de usuario cuando sus nombres chocan. Lección 04 — Subagentes para la tabla de prioridad completa incluyendo agentes de nivel de plugin.

Vista del agente (claude agents, v2.1.139+)

Vista previa de la investigación — la función es lo suficientemente estable para el uso diario, pero puede cambiar.

claude agents abre la Vista del agente — una lista única de todas las sesiones de Claude Code en la máquina con su estado actual (running, blocked on you, doneEs el reemplazo para hacer malabares con varias pestañas de terminal cuando ejecuta agentes de fondo, tareas programadas, o --bg-Sesiones lanzadas.

# Open the Agent View
claude agents

Cuando se envía una sesión desde la vista (o vía claude --bg <prompt>), puede pasar las mismas banderas de configuración que pasaría a claude banderas introducidas para la ruta de expedición de Agent View:

Las sesiones que terminan su trabajo pero dejan un shell de fondo abierto pasan de "Trabajar" a "Terminar" (v2.1.141 fix). Shift+Tab ciclos a través de los modos de permiso, incluyendo el modo automático (v2.1.143).

Solicitudes de fusión de GitLab (v2.1.233) — la vista de agente reconoce las URLs de GitLab MR junto a las URLs de GitHub PR, y muestra las solicitudes de fusión como !N (GitHub solicitudes de retiro quedarse #N). La misma versión enseñada --worktree aceptar una URL de GitLab MR.

Fijar una sesión — prensa Ctrl+T sobre un período de sesiones en claude agents para fijarlo (v2.1.147). Las sesiones de fondo pinnadas permanecen vivas cuando están inactivas, se reinician en su lugar para aplicar actualizaciones de Claude Code, y se eliminan bajo presión de memoria sólo después de las sesiones no ancladas. (Esto Ctrl+T se mira hacia la vista de agente; en la sesión principal se alterna la vista de lista de tareas.)

Predeterminados para nuevas sesiones (v2.1.299) — a la vista de los agentes, /effort y /fast establecer con qué nuevas sesiones comienzan; un desnudo /model, /effort o /fast abre un selector.

Casos de uso de alto valor

1. Integración CI/CD

Utilice Claude Code en sus tuberías CI/CD para la revisión, pruebas y documentación automatizadas de códigos.

Ejemplo de acciones de GitHub:

name: AI Code Review

on: [pull_request]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Install Claude Code
        run: npm install -g @anthropic-ai/claude-code

      - name: Run Code Review
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          claude -p --output-format json \
            --max-turns 1 \
            "Review the changes in this PR for:
            - Security vulnerabilities
            - Performance issues
            - Code quality
            Output as JSON with 'issues' array" > review.json

      - name: Post Review Comment
        uses: actions/github-script@v7
        with:
          script: |
            const fs = require('fs');
            const review = JSON.parse(fs.readFileSync('review.json', 'utf8'));
            // Process and post review comments

Jenkins Pipeline:

pipeline {
    agent any
    stages {
        stage('AI Review') {
            steps {
                sh '''
                    claude -p --output-format json \
                      --max-turns 3 \
                      "Analyze test coverage and suggest missing tests" \
                      > coverage-analysis.json
                '''
            }
        }
    }
}

Sin interfaz ultrareview (requiere v2.1.227+; --trust-workspace requiere v2.1.309+):

# .github/workflows/ultrareview.yml
# Check out a branch you trust, e.g. actions/checkout with `ref: ${{ github.base_ref }}`;
# ultrareview clones the pull request itself in the cloud.
- name: Claude ultrareview
  run: claude ultrareview ${{ github.event.pull_request.number }} --trust-workspace --json --no-post > review.json

claude ultrareview sale 0 cuando la revisión se completa, con o sin resultados, 1 cuando no se inicia, errores, tiempos de salida, o la carpeta no es de confianza, y 130 cuando presiona Ctrl-C mientras se lanza la revisión, espera a que los resultados, o publicar el --post comentario, por lo que puerta un PR sobre los hallazgos en review.json, no en el código de salida. En CI la carrera no puede preguntar si confía en la compra, por lo que desde v2.1.309 sale 1 con Error: Workspace not trusted a menos que pases --trust-workspace después del número PR o rama base (no toma valor) o conjunto CLAUDE_CODE_DISABLE_ULTRAREVIEW_TRUST_CHECK=1 en el entorno del trabajo. Utilice o bien sólo en una caja de su confianza. --timeout <minutes> para anular el valor predeterminado de 45 minutos (desde v2.1.260). --post publica los resultados finales a la solicitud de retirada; --no-post los mantiene en stdout solamente, que es lo que quieres cuando un paso posterior de CI formatea el informe mismo.

2. Tuberías de guiones

Procesar archivos, registros y datos a través de Claude para su análisis.

Análisis de registros:

# Analyze error logs
tail -1000 /var/log/app/error.log | claude -p "summarize these errors and suggest fixes"

# Find patterns in access logs
cat access.log | claude -p "identify suspicious access patterns"

# Analyze git history
git log --oneline -50 | claude -p "summarize recent development activity"

Procesamiento de códigos:

# Review a specific file
cat src/auth.ts | claude -p "review this authentication code for security issues"

# Generate documentation
cat src/api/*.ts | claude -p "generate API documentation in markdown"

# Find TODOs and prioritize
grep -r "TODO" src/ | claude -p "prioritize these TODOs by importance"

3. Flujos de trabajo multisesión

Gestionar proyectos complejos con múltiples hilos de conversación.

# Start a feature branch session
claude -r "feature-auth" "let's implement user authentication"

# Later, continue the session
claude -r "feature-auth" "add password reset functionality"

# Fork to try an alternative approach
claude --resume feature-auth --fork-session "try OAuth instead"

# Switch between different feature sessions
claude -r "feature-payments" "continue with Stripe integration"

4. Configuración del agente personalizado

Definir agentes especializados para los flujos de trabajo de su equipo.

# Save agents config to file
cat > ~/.claude/agents.json << 'EOF'
{
  "reviewer": {
    "description": "Code reviewer for PR reviews",
    "prompt": "Review code for quality, security, and maintainability.",
    "model": "opus"
  },
  "documenter": {
    "description": "Documentation specialist",
    "prompt": "Generate clear, comprehensive documentation.",
    "model": "sonnet"
  },
  "refactorer": {
    "description": "Code refactoring expert",
    "prompt": "Suggest and implement clean code refactoring.",
    "tools": ["Read", "Edit", "Glob"]
  }
}
EOF

# Use agents in session
claude --agents "$(cat ~/.claude/agents.json)" "review the auth module"

5. Procesamiento por lotes

Procesar múltiples consultas con ajustes consistentes.

# Process multiple files
for file in src/*.ts; do
  echo "Processing $file..."
  claude -p --model haiku "summarize this file: $(cat $file)" >> summaries.md
done

# Batch code review
find src -name "*.py" -exec sh -c '
  echo "## $1" >> review.md
  cat "$1" | claude -p "brief code review" >> review.md
' _ {} \;

# Generate tests for all modules
for module in $(ls src/modules/); do
  claude -p "generate unit tests for src/modules/$module" > "tests/$module.test.ts"
done

6. Desarrollo seguro y consciente

Utilice controles de permisos para una operación segura.

# Read-only security audit
claude --permission-mode plan \
  --tools "Read,Grep,Glob" \
  "audit this codebase for security vulnerabilities"

# Block dangerous commands
claude --disallowedTools "Bash(rm:*)" "Bash(curl:*)" "Bash(wget:*)" \
  "help me clean up this project"

# Restricted automation
claude -p --max-turns 2 \
  --allowedTools "Read" "Glob" \
  "find all hardcoded credentials"

7. Integración de API JSON

Utilice Claude como una API programable para sus herramientas con jq análisis.

# Get structured analysis
claude -p --output-format json \
  --json-schema '{"type":"object","properties":{"functions":{"type":"array"},"complexity":{"type":"string"}}}' \
  "analyze main.py and return function list with complexity rating"

# Integrate with jq for processing (schema output lands in .structured_output)
claude -p --output-format json \
  --json-schema '{"type":"object","properties":{"endpoints":{"type":"array"}}}' \
  "list all API endpoints" | jq '.structured_output.endpoints[]'

# Use in scripts
RESULT=$(claude -p --output-format json \
  --json-schema '{"type":"object","properties":{"secure":{"type":"boolean"},"issues":{"type":"array"}},"required":["secure","issues"]}' \
  "is this code secure?" < code.py)
if echo "$RESULT" | jq -e '.structured_output.secure == false' > /dev/null; then
  echo "Security issues found!"
  echo "$RESULT" | jq '.structured_output.issues[]'
fi

Ejemplos de análisis de jq

Analizar y procesar la salida JSON de Claude usando jq. El texto de la respuesta está en .result; con --json-schema, el objeto validado está en .structured_output ($SCHEMA A continuación se presenta un esquema que define los campos que lee cada filtro:

# Extract the response text
claude -p --output-format json "analyze this code" | jq -r '.result'

# Filter array elements
claude -p --output-format json --json-schema "$SCHEMA" "list issues" | jq -r '.structured_output.issues[] | select(.severity=="high")'

# Extract multiple fields
claude -p --output-format json --json-schema "$SCHEMA" "describe the project" | jq -r '.structured_output | {name, version, description}'

# Convert to CSV
claude -p --output-format json --json-schema "$SCHEMA" "list functions" | jq -r '.structured_output.functions[] | [.name, .lineCount] | @csv'

# Conditional processing
claude -p --output-format json --json-schema "$SCHEMA" "check security" | jq 'if (.structured_output.vulnerabilities | length) > 0 then "UNSAFE" else "SAFE" end'

# Extract nested values
claude -p --output-format json --json-schema "$SCHEMA" "analyze performance" | jq '.structured_output.metrics.cpu.usage'

# Process entire array
claude -p --output-format json --json-schema "$SCHEMA" "find todos" | jq '.structured_output.todos | length'

# Transform output
claude -p --output-format json --json-schema "$SCHEMA" "list improvements" | jq '.structured_output.improvements | map({title: .title, priority: .priority})'

Modelos

Claude Code admite múltiples modelos con diferentes capacidades:

Nota: Sonnet 4.5 se retira el 30 de noviembre de 2026 en la API de Claude, Claude Platform en AWS, Claude Models en Google Cloud (Administrado Antrópico) y Microsoft Foundry; Amazon Bedrock y Google Cloud's Agent Platform establecen sus propias fechas. default y sonnet todavía resolver a Sonnet 4.5, establecer un modelo más nuevo explícitamente.

Selección de modelos

# Use short names
claude --model opus "complex architectural review"
claude --model sonnet "implement this feature"
claude --model haiku -p "format this JSON"

# Use opusplan alias (Opus plans, Sonnet executes)
claude --model opusplan "design and implement the API"

# Toggle fast mode during session
/fast

fábula 5.1 y la fable alias (v2.1.257): Fábula 5.1 (claude-fable-5-1) buques en v2.1.257, y el fable alias ahora resuelve a él en lugar de a la Fable 5. La página oficial de configuración del modelo dice Fable 5.1 "requiere Claude Code v2.1.255 o posterior", pero 2.1.255 nunca fue publicado — v2.1.257 es la primera versión con la que los usuarios pueden instalarlo. fable y best todavía resuelven a Fábula 5; elegir 5.1 explícitamente en /model Si el nuevo modelo de Fable no está disponible para su organización, fable y best volver a probar una vez en el modelo anterior de Fable (v2.1.301).

Modo rápido se ejecuta en Opus 5.5, Opus 5, y Opus 4.8 (v2.1.280): A partir de v2.1.219, /fast se aplica a Opus 5 y Opus 4.8 — El Opus 4.7 fue eliminado del modo rápido. El modo rápido del Opus 5 se factura a $10/$50 por Mtok. El modo rápido se movió por primera vez al Opus 4.8 en v2.1.154 (aproximadamente 2× la tasa estándar para ~2,5× la velocidad de salida), habiendo pasado del Opus 4.6 al Opus 4.7 en v2.1.142. CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE env var fue Depreciado en v2.1.154 y retirado el 2026-06-01; el modo rápido ya no está disponible en el Opus 4.6 — seleccione Opus 5 o Opus 4.8 en su lugar. Desde v2.1.280, el modo rápido por defecto al Opus 5.5 ($8/$40 por Mtok); el Opus 5 y el Opus 4.8 permanecen soportados a $10/$50. El modo rápido y la velocidad estándar mantienen cachés prompt separados: el primer cambio al modo rápido relee la conversación desencajada a velocidades de modo rápido, y cada uno luego cambia, incluyendo el retroceso automático después de un límite de velocidad, relee lo que esa velocidad no ha cachéado, así que enciéndela al inicio de una sesión.

Niveles de esfuerzo (Opus 5 / Soneto 5 / Opus 4.8 / Opus 4.7)

El Opus 5, Sonnet 5, Opus 4.8 y el Opus 4.7 apoyan el razonamiento adaptativo con niveles de esfuerzo, ordenados de lo más ligero a lo más pesado: low (○), medium (◐), high (●), xhigh, y max. El Opus 5.5, Sonnet 5.5 y Haiku 5.5 también soportan los cinco niveles. predeterminado es medium en el Opus 5.5 (el modelo por defecto desde v2.1.280), Sonnet 5.5 y Haiku 5.5, high sobre el Opus 5, Sonnet 5, Opus 4.8 (desde v2.1.154), Opus 4.6, y Sonnet 4.6, y xhigh sobre el Opus 4.7. xhigh está disponible en Opus 5.5, Sonnet 5.5, Haiku 5.5, Opus 5, Sonnet 5, Opus 4.8 y Opus 4.7; max En el Opus 4.6 / Sonnet 4.6, el esfuerzo por defecto para los suscriptores Pro/Max se elevó desde medium a high en el punto 2.1.117.

# Set effort level via CLI flag
claude --effort high "complex review"

# Set effort level via slash command
/effort high

# Set effort level via environment variable
export CLAUDE_CODE_EFFORT_LEVEL=high   # low, medium, high, xhigh (Opus 5.5, Sonnet 5.5, Haiku 5.5, Opus 5, Sonnet 5, Opus 4.8/4.7), or max — default is high on Opus 5

La palabra clave "ultrathink" en los avisos activa el razonamiento profundo. /effort slider también tiene un Ultracode toggle (Tab, o /effort ultracode [on|off]), que es no un nivel de esfuerzo modelo - que tiene Claude orquestan flujos de trabajo dinámicos a cualquier nivel de esfuerzo que la sesión se ejecuta en. xhigh y se mantiene encendido cuando cambia el nivel; --effort ultracode y el agente SDK effortLevel: "ultracode" todavía set xhigh.

Variables clave del entorno

Estas ocho filas son fuente de cambios. La página de referencia de CLI no tiene sección dedicada al entorno variable, por lo que se documentan a partir de las entradas del registro de cambios v2.1.221–v2.1.234 en lugar de una página de referencia.

CLAUDE_CODE_DISABLE_1M_CONTEXT ampliación en v2.1.223: ahora se mantiene cada Modelo Claude con una ventana nativa de 1M-token a 200K mediante autocompactación, no sólo una lista fija de IDs de modelo.

ENABLE_TOOL_SEARCH en la Plataforma de Agentes (Vertex AI) y pasarelas: Antes de v2.1.221, la búsqueda de herramientas estaba desactivada en la plataforma de agentes de Google Cloud a menos que establezca ENABLE_TOOL_SEARCH=true; ahora está ahí para Claude Opus 4.5, Sonnet 4.5, Haiku 4.5 y modelos posteriores (los modelos anteriores cargan todas las herramientas MCP por adelantado, y true La búsqueda de herramientas está activada por defecto, incluso detrás de una costumbre ANTHROPIC_BASE_URL puerta de entrada desde v2.1.304 (desde v2.1.305 una puerta de entrada que la rechaza con un 400 o 422 se vuelve a juzgar sin ella); ENABLE_TOOL_SEARCH=false para cargar cada herramienta por adelantado.

Variables de OpenTelemetría en la configuración del proyecto (v2.1.282): los ajustes locales y de proyecto ignoran las variables OpenTelemetry que activan la exportación, establecen su punto final o capturan contenido, como CLAUDE_CODE_ENABLE_TELEMETRY y OTEL_LOG_*.

Settings.json Keys

Estas llaves viven en un settings.json archivo (~/.claude/settings.json para el alcance del usuario, .claude/settings.json para el alcance del proyecto) en lugar de pasar como banderas o env vars. La siguiente tabla cubre algunas claves de interfaz de usuario/UX recientemente añadidas; para la enforceAvailableModels key, ver Funciones avanzadas → Configuración administrada.

{
  "wheelScrollAccelerationEnabled": false,
  "language": "french",
  "footerLinksRegexes": ["https://jira\\.example\\.com/.*"]
}

Referencia rápida

Comandos más comunes

# Interactive session
claude

# Quick question
claude -p "how do I..."

# Continue conversation
claude -c

# Process a file
cat file.py | claude -p "review this"

# JSON output for scripts
claude -p --output-format json "query"

Combinaciones de banderas

Solución de problemas

Comando no encontrado

Problema: claude: command not found

Soluciones: - Instale Claude Code: curl -fsSL https://claude.ai/install.sh | bash (nativo, recomendado) o npm install -g @anthropic-ai/claude-code - Check PATH incluye ~/.local/bin (instalación nativa) o el directorio de bin global de npm - Ejecutar claude doctor

Cuestiones clave de la API

Problema: Ha fallado la autenticación

Soluciones: - Establecer la clave de API: export ANTHROPIC_API_KEY=your-key - La clave Check es válida y tiene suficientes créditos - Verificar permisos de claves para el modelo solicitado

Sesión no encontrada

Problema: No se puede reanudar la sesión

Soluciones: - Listar las sesiones disponibles para encontrar el nombre/ID correcto - Las sesiones pueden expirar después del período de inactividad - Uso -c para continuar con el período de sesiones más reciente

Cuestiones relativas al formato de los productos

Problema: La salida de JSON está mal formada

Soluciones: - Uso --json-schema para hacer cumplir la estructura - Añadir instrucciones JSON explícitas en prompt - Uso --output-format json (no sólo pidiendo JSON en el momento)

Permiso denegado

Problema: Ejecución de la herramienta bloqueada

Soluciones: - Comprobar --permission-mode configuración - Desde v2.1.302, a claude -p o el agente SDK ejecutar sin ningún modo de permiso se inicia en el modo Manual (valor de configuración default) y niega las llamadas de herramienta que necesitan aprobación; pase --permission-mode (por ejemplo: auto o acceptEdits) o --allowedTools- Examen --allowedTools y --disallowedTools banderas - Uso --dangerously-skip-permissions para la automatización (con precaución)

Recursos adicionales

• Referencia oficial del CLI - Referencia completa del comando
• Documentación de modo sin interfaz - Ejecución automatizada
• Comandos de barra - Accesos directos personalizados dentro de Claude
• Guía de memoria - Contexto persistente vía CLAUDE.md
• Protocolo MCP - Integraciones de herramientas externas
• Funciones avanzadas - Modo de planificación, pensamiento extendido
• Guía de subagentes - Ejecución de tareas delegadas

Parte de la Claude Cómo Serie de guías

Última actualización: 26 de octubre de 2026 Versión de Claude Code: 2.1.310 Fuentes: - https://raw.githubusercontent.com/anthropics/claude-code/main/CHANGELOG.md - https://code.claude.com/docs/en/workflows#set-a-size-guideline - https://code.claude.com/docs/en/tools-reference#task-tool-availability - https://code.claude.com/docs/en/cli-reference - https://code.claude.com/docs/en/env-vars - https://code.claude.com/docs/en/changelog#2-1-174 - https://code.claude.com/docs/en/changelog#2-1-176 - https://code.claude.com/docs/en/changelog - https://code.claude.com/docs/en/settings - https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md - https://code.claude.com/docs/en/troubleshooting - https://code.claude.com/docs/en/commands - https://code.claude.com/docs/en/model-config - https://platform.claude.com/docs/en/about-claude/models/overview - https://www.anthropic.com/news/claude-opus-4-8 - https://github.com/anthropics/claude-code/releases/tag/v2.1.117 - https://github.com/anthropics/claude-code/releases/tag/v2.1.139 - https://github.com/anthropics/claude-code/releases/tag/v2.1.142 - https://github.com/anthropics/claude-code/releases/tag/v2.1.154 - https://code.claude.com/docs/en/plugins - https://code.claude.com/docs/en/overview - https://code.claude.com/docs/en/sub-agents - https://code.claude.com/docs/en/headless - https://code.claude.com/docs/en/cli-reference.md - https://code.claude.com/docs/en/settings.md - https://code.claude.com/docs/en/settings-reference - https://code.claude.com/docs/en/fast-mode - https://github.com/anthropics/claude-code/releases/tag/v2.1.281 - https://github.com/anthropics/claude-code/releases/tag/v2.1.282 - https://github.com/anthropics/claude-code/releases/tag/v2.1.283 - https://code.claude.com/docs/en/settings-reference#ultracode - https://github.com/anthropics/claude-code/releases/tag/v2.1.284 - https://github.com/anthropics/claude-code/releases/tag/v2.1.285 - https://code.claude.com/docs/en/permission-modes - https://github.com/anthropics/claude-code/releases/tag/v2.1.287 - https://github.com/anthropics/claude-code/releases/tag/v2.1.288 - https://github.com/anthropics/claude-code/releases/tag/v2.1.290 - https://github.com/anthropics/claude-code/releases/tag/v2.1.293 - https://code.claude.com/docs/en/cli-reference#cli-commands - https://code.claude.com/docs/en/remote-control - https://code.claude.com/docs/en/setup - https://code.claude.com/docs/en/troubleshoot-install#command-not-found-claude-after-installation - https://code.claude.com/docs/en/self-hosted-environments-reference - https://code.claude.com/docs/en/settings-reference#idlecompaction - https://code.claude.com/docs/en/prompt-caching#compacting-the-conversation - https://code.claude.com/docs/en/agent-view - https://code.claude.com/docs/en/changelog#2-1-299 - https://code.claude.com/docs/en/changelog#2-1-300 - https://code.claude.com/docs/en/changelog#2-1-301 - https://code.claude.com/docs/en/changelog#2-1-302 - https://github.com/anthropics/claude-code - https://platform.claude.com/docs/en/about-claude/model-deprecations - https://code.claude.com/docs/en/changelog#2-1-309 - https://code.claude.com/docs/en/errors#workspace-not-trusted-when-running-claude-ultrareview - https://code.claude.com/docs/en/ultrareview#trust-the-folder-before-the-review-runs - https://code.claude.com/docs/en/env-vars#variables - https://code.claude.com/docs/en/ultrareview#run-ultrareview-non-interactively - https://code.claude.com/docs/en/settings-reference#axscreenreader - https://code.claude.com/docs/en/cli-reference#cli-flags - https://code.claude.com/docs/en/changelog#2-1-304 - https://code.claude.com/docs/en/mcp#configure-tool-search - https://code.claude.com/docs/en/mcp#tool-search-through-a-gateway - https://code.claude.com/docs/en/permission-modes#default-classifier-model - https://code.claude.com/docs/en/permission-modes#which-mode-a-non-interactive-run-starts-in - https://code.claude.com/docs/en/prompt-caching#turning-on-fast-mode - https://code.claude.com/docs/en/changelog#2-1-307 - https://code.claude.com/docs/en/scheduled-tasks Modelos compatibles: Claude Fable 5, Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5