📋 Referencia Técnica — Claude Code

Búsqueda de Flags

A Fuente: code.claude.com/docs/en/cli-reference — --help no lista todos los flags.

Modos de Permiso

A Fuente: code.claude.com/docs/en/permission-modes · Shift+Tab cicla entre modos en sesión interactiva.

Sintaxis de Permission Rules

Variables de Entorno — Las Más Usadas

A 180+ variables disponibles (v2.1.139). Fuente: code.claude.com/docs/en/env-vars

Autenticación y modelo

Control de comportamiento

Features experimentales y debugging

settings.json — Esquema Completo

A Schema JSON en: https://json.schemastore.org/claude-code-settings.json

Ubicaciones y prioridad (mayor prioridad primero)

1. CLI flags (--settings, --model, --permission-mode, ...)      ← mayor prioridad
2. Variables de entorno (ANTHROPIC_MODEL, etc.)
3. .claude/settings.local.json   ← local, en .gitignore
4. .claude/settings.json         ← proyecto, en git
5. ~/.claude/settings.json       ← global del usuario           ← menor prioridad

Estructura completa anotada

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",

  // MODELO Y COMPORTAMIENTO
  "model": "claude-sonnet-4-6",
  "effortLevel": "medium",     // low, medium, high, xhigh, max
  "viewMode": "verbose",       // auto, verbose
  "defaultMode": "default",    // modos de permiso

  // PERMISOS
  "permissions": {
    "allow": [
      "Bash(git *)",      // git cualquier subcomando
      "Bash(npm test)",   // solo npm test
      "Read",             // leer cualquier archivo
      "Edit(*.md)"        // editar solo .md
    ],
    "deny": [
      "Bash(rm -rf *)",   // bloquear rm -rf
      "Write(/etc/*)"     // no escribir en /etc/
    ],
    "additionalDirectories": ["../shared-utils"]
  },

  // MCP SERVERS
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}" }
    },
    "servidor-remoto": {
      "transport": "sse",
      "url": "https://mi-servidor-mcp.com/sse",
      "headers": { "Authorization": "Bearer ${TOKEN}" }
    }
  },

  // HOOKS
  "hooks": {
    "PreToolUse": [{
      "matcher": "Bash(rm *)",
      "hooks": [{
        "type": "command",
        "command": "echo 'BLOCKED' >&2 && exit 2"
      }]
    }],
    "PostToolUse": [{
      "matcher": "Edit(*.py)",
      "hooks": [{
        "type": "command",
        "command": "ruff format ${file_path}"
      }]
    }]
  },

  // AGENTE Y EQUIPO
  "agent": "mi-agente-custom",
  "teammateMode": "auto",  // auto, in-process, tmux

  // VARIABLES DE ENTORNO PERSISTENTES
  "env": {
    "PYTHONPATH": "/workspace/src",
    "NODE_ENV": "development"
  }
}

Slash Commands Built-in

A Fuente: code.claude.com/docs/en/commands

Gestión de sesión y contexto

Memoria y configuración

Información y diagnóstico

Herramientas especiales

Skills bundled (Anthropic)

Atajos de teclado clave

Cheat Sheet — Referencia Rápida