Hoja de trucos 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
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

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 atajos de teclado se pueden personalizar mediante /keybindings (almacenado 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 empresa 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 el análisis detallado de 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 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

Haz que sea 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 consume contexto.

Consejos avanzados: - Usa el prefijo # en el REPL para agregar cosas 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

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

Interruptor de seguridad: 3 bloqueos consecutivos o 20 en total durante una sesión hacen que vuelva a las solicitudes manuales de confirmación.

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

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

Aprobación automática en 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 permitir como PowerShell(Get-*:*) omiten las solicitudes de confirmación para operaciones de solo lectura. Usa v2.1.149+ en workflows con mucho PowerShell; corrige omisiones de permisos del cd integrado, coincidencia de reglas de permitir por prefijo/comodín y seguimiento obsoleto de variables de directorio.

9. Eventos de hooks

| InstructionsLoaded | Se cargó CLAUDE.md | 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 cuadro de diálogo de MCP | Sí | | StopFailure | El turno termina por un error de API | No | | PermissionRequest | Se muestra el cuadro de diálogo de permisos | Sí | | PermissionDenied | Auto mode deniega una acción (v2.1.88+) | No | | CwdChanged | Cambia el directorio de trabajo (v2.1.83+) | No | | FileChanged | Un archivo vigilado se modifica externamente (v2.1.83+) | No | | TaskCreated | Se crea una nueva tarea (v2.1.84+) | No | | TeammateIdle | Un miembro del equipo de agentes queda inactivo | Sí | | TaskCompleted | La tarea se marca como completada | Sí |

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

10. Configuración de hooks

Los hooks viven 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 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 hooks PostToolUse / PostToolUseFailure (v2.1.119+) — tiempo de ejecución de la herramienta sin contar 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+) — establece el título de la sesión desde un hook UserPromptSubmit.
• args: string[] en hooks de comandos (v2.1.139+) — pasa argv estructurado sin escape 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 agentes (v2.1.140+) — identifica qué tipo de agente se está ejecutando.
• terminalSequence en la salida JSON de hooks (v2.1.141+) — emite secuencias de control de terminal para notificaciones, títulos de ventanas y campanas.

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 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 de confianza 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 generan 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: apps de escritorio y flujos de conectores de claude.ai.

11.5. Comandos CLI de 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 operativa en vista previa de investigación para sesiones 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 flags de despacho para sesiones en segundo plano, y v2.1.143 aplica esos flags de forma consistente al dashboard y 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 sesiones en segundo plano y las marca con bg; v2.1.145 agrega claude agents --json, conteos de pestañas awaiting-input y correcciones en el panel de respuesta 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 actualizaciones. Usa Agent View para monitorear, no como prueba de que el trabajo pasó los controles de calidad.⁶

Campos de frontmatter de agentes personalizados:

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 de modelos

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 50K-200K tokens de entrada y 10K-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 mediante ANTHROPIC_DEFAULT_OPUS_MODEL)

Opus 4.7 requiere Claude Code v2.1.111 o posterior. Usa solo razonamiento adaptativo (sin presupuestos fijos de pensamiento). El nuevo nivel de esfuerzo xhigh es el predeterminado para cargas de trabajo de programación/agentes en Opus 4.7.

Cambiar de modelo 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 de agentes 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 tutoriales de configuración paso a paso, 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 Apple Ecosystem Series. Última actualización: 24 de mayo de 2026.