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

Tres 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

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

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 YAML para descripción, herramientas permitidas, sobrescritura de modelo e interpolación de argumentos mediante $ARGUMENTS o posiciones $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

Los keybindings se pueden personalizar mediante /keybindings (se almacenan en ~/.claude/keybindings.json).

5. Archivos de configuración

Jerarquía de precedencia (de mayor a menor)

La primera coincidencia gana. La configuración de Enterprise no se puede omitir.

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 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 archivo usan sintaxis glob: Edit(src/**).

Claves nuevas (v2.1.118+):

Para ver el esquema completo de configuración, consulta Configuration Deep Dive 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 inicio 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

Mantenlo fácil de escanear. La prosa densa desperdicia tokens de contexto en cada sesión. Usa viñetas, tablas y bloques de código cortos. Evita los párrafos largos: Claude lee CLAUDE.md al inicio de cada sesión, así que cada palabra cuesta contexto.

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

8. Modos de permisos

Modo Auto (v2.1.85+) es el reemplazo recomendado para --dangerously-skip-permissions. Las acciones de solo lectura y las ediciones de archivos se aprueban automáticamente. Las reglas personalizadas de permitir/denegar se aplican primero. Todo lo demás pasa al clasificador de seguridad. Bloqueado automáticamente por defecto: curl | bash, force-push a main, despliegues a producción, eliminaciones masivas en la nube, cambios de IAM, envío de datos sensibles a servicios externos.¹

Interruptor de seguridad: 3 bloqueos consecutivos o 20 en total dentro de una sesión devuelven el flujo a las confirmaciones manuales.

# Enable at startup
claude --enable-auto-mode

# Cycle during session
Shift+Tab    # default -> acceptEdits -> auto -> plan

Aprobación automática de PowerShell (v2.1.119+): los comandos de la herramienta PowerShell se aprueban automáticamente en el modo de permisos de la misma forma que los comandos Bash. Las reglas de autorización como PowerShell(Get-*:*) omiten las confirmaciones para operaciones de solo lectura.

9. Eventos de hooks

| InstructionsLoaded | CLAUDE.md cargado | No | | ConfigChange | El archivo de configuración cambia a mitad de sesión | Sí | | WorktreeCreate | Se está creando un worktree | Sí | | WorktreeRemove | Se está eliminando un worktree | No | | PreCompact | Antes de la compactación de contexto | No | | PostCompact | Después de la compactación de contexto | No | | Elicitation | MCP solicita entrada estructurada | Sí | | ElicitationResult | El usuario responde al diálogo de MCP | Sí | | StopFailure | El turno termina debido a un error de API | No | | PermissionRequest | Se muestra el diálogo de permisos | Sí | | PermissionDenied | El modo auto deniega una acción (v2.1.88+) | No | | CwdChanged | Cambia el directorio de trabajo (v2.1.83+) | No | | FileChanged | Un archivo observado se modificó externamente (v2.1.83+) | No | | TaskCreated | Se crea una nueva tarea (v2.1.84+) | No | | TeammateIdle | Un integrante del equipo de agentes queda inactivo | Sí | | TaskCompleted | La tarea se marca como completada | Sí |

Para ver el protocolo completo de hooks (entrada/salida JSON, matchers, códigos de salida), consulta 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 hooks.json dedicado. 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 matcher:

Códigos de salida:

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

Campos de salida / entrada de hooks:

• duration_ms en la entrada de hooks PostToolUse / PostToolUseFailure (v2.1.119+) — tiempo de ejecución de la herramienta, sin incluir solicitudes de permisos ni hooks PreToolUse.
• hookSpecificOutput.updatedToolOutput (v2.1.121+) — reemplaza la salida de cualquier herramienta (v2.1.118 introdujo esto solo para MCP; v2.1.121 lo extiende a todas las herramientas).
• hookSpecificOutput.sessionTitle (v2.1.96+) — define el título de sesión desde un hook UserPromptSubmit.
• args: string[] en hooks de comandos (v2.1.139+) — pasa argv estructurado sin comillas de shell.
• continueOnBlock en hooks PostToolUse (v2.1.139+) — devuelve el motivo del bloqueo a Claude y continúa el turno.
• subagent_type en la entrada de hooks de agente (v2.1.140+) — identifica qué tipo de agente se está ejecutando.

11. Configuración rápida de MCP

Agrega un servidor de 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 de alcance:

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

Ejemplo de .mcp.json de 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 tiene 100 millones de descargas mensuales y más de 3.000 servidores indexados.³ Para tipos de transporte, elicitation y configuración de búsqueda de herramientas, consulta la sección de MCP en la guía completa.

alwaysLoad (v2.1.121+): excluye un servidor confiable del aplazamiento de Tool Search. Todas sus herramientas se cargan al inicio de la sesión, sin 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 muestran errores durante el inicio se reintentan hasta 3 veces antes de marcarse como desconectados.

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

11.5. Comandos de CLI para plugins

12. Tipos de subagents

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

> 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 YAML. Pueden ejecutarse hasta 10 subagents en paralelo.⁴

claude agents abre Agent View en las versiones actuales: una pantalla de operaciones en vista previa de investigación para sesiones Claude Code en ejecución, bloqueadas y completadas. Úsala para monitorear, no como prueba de que el trabajo superó los controles de calidad.⁶

Campos de frontmatter de un agent personalizado:

Ejemplo de agent 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 cloud

Control de comportamiento

Configuración de herramientas

Red y proxy

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

14. Referencia de costos

Precios por 1 millón de tokens (a abril 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 por plan (Claude Code al 16 de abril de 2026):

• Max, Team Premium → Opus 4.7
• Pro, Team Standard, Enterprise, Anthropic API → Sonnet 4.6 (Enterprise + API cambian a Opus 4.7 el 23 de abril de 2026)
• Bedrock, Vertex, Foundry → Sonnet 4.5 (fija uno más reciente con ANTHROPIC_DEFAULT_OPUS_MODEL)

Opus 4.7 requiere Claude Code v2.1.111 o posterior. Usa solo razonamiento adaptativo (sin presupuestos fijos de thinking). El nuevo nivel de effort xhigh es el predeterminado para cargas de trabajo de coding/agénticas en Opus 4.7.

Cambiar modelos durante una sesión:

/model opus       # Switch to Opus (resolves to 4.7 on API, 4.6 on Bedrock/Vertex/Foundry)
/model sonnet     # Switch to Sonnet 4.6
/model haiku      # Switch to Haiku 4.5
/effort xhigh     # Opus 4.7 only — recommended for coding/agentic

Regla de decisión: La exploración simple va a Haiku. La programación diaria sensible al costo va a Sonnet. El razonamiento difícil, la arquitectura, los bucles agénticos y el análisis de seguridad van a Opus. Usa opusplan para refactorizaciones complejas (Opus planifica, Sonnet ejecuta).

15. Ubicaciones clave de archivos

16. Registro de cambios

17. Referencias

Esta hoja de referencia rápida es el complemento de consulta rápida de la guía completa de Claude Code CLI. Para recorridos de configuración, consulta el quickstart de Claude Code. Para proyectos de iOS y macOS específicamente, consulta la guía de desarrollo de agentes para iOS, los patrones de integración de XcodeBuildMCP y la serie del ecosistema Apple. Última actualización: 13 de mayo de 2026.