Hoja de referencia de Claude Code: comandos, configuración y atajos

Todos los flags de CLI, comandos de barra, atajos de teclado, claves de configuración, eventos de hooks y variables de entorno en un solo lugar. Para explicaciones detalladas, consulta la guía completa de Claude Code. Para la configuración inicial, consulta el inicio rápido.

1. Instalación

Hay 3 métodos de instalación, en orden de preferencia.

# Native binary (recommended)
curl -fsSL https://claude.ai/install.sh | bash

# Homebrew (macOS)
brew install --cask claude-code

# NPM (deprecated — migrate with `claude install`)
npm install -g @anthropic-ai/claude-code

Instala una versión específica:

curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

Verifica la instalación:

claude doctor
claude --version

Autentícate:

claude auth login       # Log in or switch accounts
claude auth status      # Check current auth state
claude auth logout      # Clear stored credentials

2. Flags de CLI

Subcomando agregado en v2.1.212: claude auto-mode reset restablece el estado de auto-mode desde la terminal; pasa --yes para omitir la solicitud de confirmación.⁷

3. Slash Commands

Comandos personalizados: Crea .claude/commands/my-command.md (proyecto) o ~/.claude/commands/my-command.md (personal) e invócalo con /my-command. Los comandos admiten frontmatter de YAML para la descripción, las herramientas permitidas, la sustitución del modelo y la interpolación de argumentos mediante $ARGUMENTS o los parámetros posicionales $1, $2.

---
description: Fix a GitHub issue
allowed-tools: Read, Edit, Bash(git:*)
model: opus
argument-hint: [issue-number]
---

Fix GitHub issue #$ARGUMENTS following our coding standards.

Uso: /fix-issue 123

4. Atajos de teclado

Controles generales

Prefijos rápidos

Entrada multilínea

Puedes personalizar las combinaciones de teclas mediante /keybindings (se almacenan en ~/.claude/keybindings.json).

5. Archivos de configuración

Jerarquía de precedencia (de mayor a menor)

Se aplica la primera coincidencia. La configuración empresarial no puede eludirse.

6. Referencia de Settings.json

Configuraciones clave con tipos y ejemplos. Colócalas en cualquier archivo de configuración de la jerarquía anterior.

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "claude-sonnet-4-6",
  "permissions": {
    "allow": ["Read", "Glob", "Grep", "Bash(npm run:*)", "Bash(git:*)", "Edit(src/**)"],
    "deny": ["Read(.env*)", "Bash(rm -rf:*)", "Bash(sudo:*)"],
    "ask": ["WebFetch", "Bash(docker:*)"],
    "defaultMode": "acceptEdits",
    "additionalDirectories": ["../shared-lib"]
  },
  "env": {
    "NODE_ENV": "development"
  },
  "hooks": {},
  "sandbox": {
    "enabled": false,
    "autoAllowBashIfSandboxed": true
  },
  "includeCoAuthoredBy": true,
  "cleanupPeriodDays": 30,
  "respectGitignore": true,
  "showTurnDuration": true,
  "language": "en",
  "autoMemoryDirectory": ".claude/memory",
  "plansDirectory": ".claude/plans"
}

Sintaxis de las reglas de permisos: Tool(pattern:*) proporciona coincidencia por prefijo. Bash(npm run test:*) permite npm run test, npm run test:unit, etc. Los patrones de archivos usan la sintaxis glob: Edit(src/**). A partir de la versión v2.1.214, una regla allow dir/** de un solo segmento coincide únicamente con <cwd>/dir, ya no con cualquier dir/ del árbol; escribe Edit(**/src/**) para que coincida a cualquier profundidad. Las reglas deny/ask conservan la coincidencia a cualquier profundidad, y las condiciones if: de los hooks reciben el mismo ámbito de cwd.

Claves nuevas (v2.1.118+):

Para consultar el esquema completo de configuración, revisa el análisis detallado de la configuración en la guía completa.

7. Referencia rápida de CLAUDE.md

CLAUDE.md es el archivo de instrucciones de tu proyecto. Claude lo lee al comienzo de cada sesión.

Dónde se encuentra:

Qué incluir:

# Project Name

## Stack
- Backend: FastAPI, Python 3.11+
- Frontend: HTMX + Alpine.js + Bootstrap 5

## Commands
- Dev: `uvicorn app.main:app --reload --port 8000`
- Test: `python -m pytest -v`
- Lint: `ruff check .`

## Conventions
- Conventional commits: feat:, fix:, docs:, refactor:
- Never force push to main
- Always activate venv before Python commands

## Key Files
- app/main.py — FastAPI app and routes
- app/models.py — SQLAlchemy models

Procura que sea fácil de consultar. La prosa densa consume tokens de contexto en cada sesión. Usa viñetas, tablas y bloques de código breves. Evita los párrafos largos: Claude lee CLAUDE.md al comienzo de cada sesión, por lo que cada palabra consume contexto.

Consejos avanzados: - Usa el prefijo # en el REPL para agregar elementos a la memoria automática sin editar CLAUDE.md: # Always use TypeScript strict mode - El CLAUDE.md de un subdirectorio se carga cuando Claude lee archivos de ese directorio - Coloca las reglas compartidas por el equipo en .claude/rules/*.md para mantener una organización modular

8. Modos de permisos

Auto Mode (v2.1.85+) es el reemplazo recomendado para --dangerously-skip-permissions. Las operaciones de solo lectura y las ediciones de archivos se aprueban automáticamente. Las reglas personalizadas de allow/deny se resuelven primero. Todo lo demás pasa al clasificador de seguridad. De forma predeterminada, se bloquean automáticamente: curl | bash, los force-push a main, los despliegues en producción, las eliminaciones masivas en la nube, los cambios de IAM y el envío externo de datos confidenciales.¹

Interruptor de seguridad: 3 bloqueos consecutivos o 20 en total durante una sesión hacen que el sistema vuelva a solicitar confirmación manual.

# Enable at startup (--enable-auto-mode was removed in v2.1.111)
claude --permission-mode auto

# Cycle during session
Shift+Tab    # Manual (aka default) -> acceptEdits -> auto -> plan

Aprobación automática en PowerShell (v2.1.119+): los comandos de la herramienta PowerShell se aprueban automáticamente según el modo de permisos, igual que los comandos Bash. Las reglas allow como PowerShell(Get-*:*) omiten las solicitudes de confirmación en operaciones de solo lectura. Usa la versión v2.1.149 o posterior en flujos de trabajo que dependan mucho de PowerShell; corrige la omisión de permisos del comando integrado cd, la coincidencia de reglas allow mediante prefijos y comodines, y el seguimiento obsoleto de variables de directorio.

9. Eventos de hooks

| InstructionsLoaded | Cuando se carga CLAUDE.md | No | | ConfigChange | Cuando cambia un archivo de configuración durante la sesión | Sí | | DirectoryAdded | Cuando /add-dir o register_repo_root de SDK agrega un directorio de trabajo durante la sesión (v2.1.219+) | No | | WorktreeCreate | Cuando se está creando un worktree | Sí | | WorktreeRemove | Cuando se está eliminando un worktree | No | | PreCompact | Antes de compactar el contexto | No | | PostCompact | Después de compactar el contexto | No | | Elicitation | Cuando MCP solicita datos estructurados | Sí | | ElicitationResult | Cuando el usuario responde al diálogo de MCP | Sí | | StopFailure | Cuando el turno termina debido a un error de API | No | | PermissionRequest | Cuando se muestra el diálogo de permisos | Sí | | PermissionDenied | Cuando Auto mode rechaza una acción (v2.1.88+) | No | | CwdChanged | Cuando cambia el directorio de trabajo (v2.1.83+) | No | | FileChanged | Cuando un archivo supervisado se modifica externamente (v2.1.83+) | No | | TaskCreated | Cuando se crea una tarea nueva (v2.1.84+) | No | | TeammateIdle | Cuando un integrante del equipo de agents queda inactivo | Sí | | TaskCompleted | Cuando una tarea se marca como completada | Sí |

Para consultar el protocolo completo de hooks (JSON de entrada/salida, matchers y códigos de salida), revisa el análisis detallado de hooks en la guía completa.

10. Configuración de hooks

Los hooks se encuentran en settings.json o en un archivo hooks.json específico. Ejemplo mínimo:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write \"$FILE_PATH\""
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/validate-bash.sh"
          }
        ]
      }
    ]
  }
}

Sintaxis de los matchers:

Códigos de salida:

Los hooks asíncronos se ejecutan en segundo plano sin bloquear: agrega "async": true al objeto del hook.²

Campos de entrada/salida de hooks:

• duration_ms en la entrada de los hooks PostToolUse / PostToolUseFailure (v2.1.119+): tiempo de ejecución de la herramienta, sin contar las solicitudes de permisos ni los hooks PreToolUse.
• hookSpecificOutput.updatedToolOutput (v2.1.121+): reemplaza la salida de cualquier herramienta (v2.1.118 incorporó esta función únicamente para MCP; v2.1.121 la amplía a todas las herramientas).
• hookSpecificOutput.sessionTitle (v2.1.96+): establece el título de la sesión desde un hook UserPromptSubmit.
• args: string[] en los hooks de comandos (v2.1.139+): pasa un argv estructurado sin entrecomillado del shell.
• continueOnBlock en los hooks PostToolUse (v2.1.139+): devuelve el motivo del bloqueo a Claude y continúa el turno.
• subagent_type en la entrada del hook del agent (v2.1.140+): identifica qué tipo de agent se está ejecutando.
• terminalSequence en la salida JSON del hook (v2.1.141+): emite secuencias de control de la terminal para notificaciones, títulos de ventana y alertas sonoras.

11. Configuración rápida de MCP

Agrega un servidor MCP con un solo comando:

# Remote HTTP server (recommended)
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

# Remote with auth header
claude mcp add --transport http api https://api.example.com/mcp \
  --header "Authorization: Bearer $TOKEN"

# Local stdio server
claude mcp add --transport stdio postgres \
  --env "DATABASE_URL=postgresql://user:pass@localhost/db" \
  -- npx -y @anthropic-ai/mcp-server-postgres

Control del alcance:

claude mcp add --scope project ...   # Team-shared (.mcp.json)
claude mcp add --scope user ...      # Personal (~/.claude.json)

Ejemplo de .mcp.json del proyecto:

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "database": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-server-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@localhost/db"
      }
    }
  }
}

MCP ahora registra 100 millones de descargas mensuales y más de 3.000 servidores indexados.³ Para conocer los tipos de transporte, la elicitación y la configuración de búsqueda de herramientas, consulta la sección sobre MCP en la guía completa.

alwaysLoad (v2.1.121+): Excluye un servidor de confianza del aplazamiento de Tool Search. Todas sus herramientas se cargan al iniciar la sesión, sin ningún recorrido de ida y vuelta de ToolSearch:

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "alwaysLoad": true
    }
  }
}

Reintento automático (v2.1.121+): Los servidores MCP que generan errores durante el inicio vuelven a intentarlo hasta 3 veces antes de marcarse como desconectados.

SDK mcp_authenticate redirectUri (v2.1.121+): Es obligatorio para completar OAuth en esquemas de URI personalizados, como los flujos de conectores de aplicaciones de escritorio y claude.ai.

11.5. Comandos de CLI para plugins

12. Tipos de subagents

Claude delega automáticamente en subagents. También puedes solicitarlos de forma explícita:

> Use the explore agent to find all auth-related files
> Have a subagent analyze the database schema

Los subagents personalizados se definen en .claude/agents/ (proyecto) o ~/.claude/agents/ (personal) como archivos markdown con frontmatter de YAML. Pueden ejecutarse hasta 10 subagents en paralelo.⁴

claude agents abre Agent View en las versiones actuales: una pantalla operativa en versión preliminar de investigación para las sesiones de Claude Code en ejecución, bloqueadas y completadas. claude agents --cwd <path> limita la vista a un directorio (v2.1.141+), v2.1.142 agrega indicadores de despacho para las sesiones en segundo plano y v2.1.143 aplica esos indicadores de forma coherente tanto al panel como a las sesiones en segundo plano: --add-dir, --settings, --mcp-config, --plugin-dir, --permission-mode, --model, --effort y --dangerously-skip-permissions. v2.1.144 agrega compatibilidad con /resume para las sesiones en segundo plano y las marca con bg; v2.1.145 incorpora claude agents --json, conteos de pestañas que esperan entradas y correcciones en el panel de respuestas de Agent View; v2.1.147 agrega sesiones en segundo plano fijadas que permanecen activas cuando están inactivas y se reinician en el mismo lugar para aplicar actualizaciones. Usa Agent View para supervisar, no como prueba de que el trabajo superó los controles de calidad.⁶

Campos del frontmatter de un agente personalizado:

Ejemplo de agente personalizado (.claude/agents/security-reviewer.md):

---
name: security-reviewer
description: Expert security code reviewer. Use PROACTIVELY after code changes to auth or data handling.
tools: Read, Grep, Glob, Bash
model: opus
permissionMode: plan
---

You are a senior security engineer. Analyze for OWASP Top 10 vulnerabilities,
secrets, hardcoded credentials, and SQL injection. Report findings with severity
levels and remediation steps.

13. Variables de entorno

Autenticación y API

Configuración del modelo

Proveedores de nube

Control del comportamiento

Configuración de herramientas

Red y proxy

Para consultar la lista completa, consulta Variables de entorno en la guía completa.

14. Referencia de costos

Precios por 1 millón de tokens (a julio de 2026).⁵

Una sesión típica consume entre 50K y 200K tokens de entrada y entre 10K y 50K tokens de salida. Sesión con Haiku: $0.10-$0.45. Sesión con Opus: $0.50-$2.25.

Modelo predeterminado en Claude Code (desde v2.1.197, 30 de junio de 2026): Sonnet 5 para todas las sesiones nuevas, con contexto nativo de 1M y precios de lanzamiento de $2/$10 hasta el 31 de agosto; Opus queda a un solo /model opus de distancia (desde v2.1.219, ese alias selecciona Opus 5). Los administradores pueden establecer un valor predeterminado para toda la organización, que aparece como «Org default» en /model (v2.1.196+); en Bedrock/Vertex/Foundry, fija un modelo específico mediante ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODEL.

Sonnet 5, Opus 5, Opus 4.8 y Fable 5 solo usan razonamiento adaptativo, sin presupuestos fijos de razonamiento. En todos ellos, effort tiene como valor predeterminado high, y puedes usar /effort xhigh para los trabajos de programación o agentes más exigentes. Cambios incompatibles de Opus 5 respecto de Opus 4.8: el razonamiento se activa de forma predeterminada en las solicitudes que omiten el campo thinking, mientras que thinking: {type: "disabled"} con el nivel de esfuerzo xhigh o max devuelve un error 400.

El modo rápido (/fast) solo se aplica a Opus 5 y Opus 4.8 desde v2.1.219: $10/$50 por MTok (el doble del precio base) para obtener hasta 2,5 veces más tokens de salida por segundo. Opus 4.7 fue eliminado: claude-opus-4-7 + speed: "fast" ahora genera un error en lugar de recurrir a la velocidad estándar. Es una versión preliminar de investigación disponible solo mediante Claude API (no en Bedrock/Vertex/Foundry); cambiar de velocidad invalida la caché del prompt.

Cambiar de modelo durante una sesión:

/model opus       # Switch to Opus 5 (v2.1.219+)
/model sonnet     # Switch to Sonnet 5 (the default)
/model haiku      # Switch to Haiku 4.5
/model fable      # Switch to Fable 5 (tier above Opus)
/effort xhigh     # Recommended for the hardest coding/agentic work

Regla práctica: usa Haiku para exploraciones sencillas; Sonnet para la programación cotidiana cuando el costo importe; y Opus para razonamiento complejo, arquitectura, ciclos de agentes y análisis de seguridad. Usa opusplan para refactorizaciones complejas (Opus planifica y Sonnet ejecuta).

15. Ubicaciones de archivos clave

16. Registro de cambios

17. Referencias

Esta hoja de referencia rápida complementa la guía completa de Claude Code CLI. Para consultar instrucciones detalladas de configuración, consulta la guía de inicio rápido de Claude Code. Para proyectos de iOS y macOS en particular, consulta la guía de desarrollo de agentes para iOS, los patrones de integración de XcodeBuildMCP y la serie sobre el ecosistema de Apple. Última actualización: 17 de julio de 2026.