agent:~/.claude$ cat claude-code-cheatsheet.md

Guía rápida de Claude Code: comandos, configuración y atajos

# Guía rápida de Claude Code para la v2.1.317: flags de la CLI, comandos slash, atajos de teclado, modos de permisos, modelos (Opus 5.5 predeterminado en todos los planes), hooks, plugins, Workflow y variables de entorno.

author: words: 14830 read_time: 69m updated: 2026-11-03 18:40

Part 2 of New to Claude Code

$ less claude-code-cheatsheet.md

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

Si estás en 2.1.288 a 2.1.290, actualiza a 2.1.291 o posterior: corrige una regresión de 2.1.288 que podía perder los últimos mensajes de una sesión al salir y una regresión de 2.1.290 por la que las sesiones en la nube podían descartar las respuestas a las solicitudes de permiso.

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

Flag Descripción Ejemplo
-p Modo print — una sola consulta y luego sale claude -p "list TODOs"
-c Continúa la sesión más reciente claude -c
-r, --resume Reanuda una sesión por nombre o por número claude -r "auth-refactor"
-n, --name Asigna el nombre visible de la sesión al iniciar claude -n "feature-x"
--model Sobrescribe el modelo para esta sesión claude --model opus
--advisor <model> Activa la herramienta advisor del lado del servidor para una sesión (fable, opus, sonnet o un ID completo); no aparece en --help; tiene prioridad sobre el ajuste advisorModel claude --advisor opus
--max-turns Limita los turnos autónomos claude -p "fix lint" --max-turns 10
--output-format Salida como text, json o stream-json claude -p "count files" --output-format json
--allowedTools Restringe las herramientas disponibles claude -p "fix" --allowedTools "Edit,Bash(npm:*)"
--permission-mode Establece el modo de permisos claude --permission-mode auto
--permission-mode auto Inicia con el Auto Mode activado (reemplazó a --enable-auto-mode, eliminado en v2.1.111); desde v2.1.302, una sesión de claude -p o del Agent SDK arranca en Manual a menos que lo pases claude --permission-mode auto
--dangerously-skip-permissions Modo YOLO — omite todas las solicitudes claude --dangerously-skip-permissions
--from-pr Inicia una sesión vinculada a un PR (v2.1.27+); acepta URLs de GitHub, GHE, MR de GitLab y PR de Bitbucket (v2.1.119+) claude --from-pr 123
--fork-session Bifurca a partir de una sesión reanudada claude -r base --fork-session
-w Inicia en un worktree de git aislado claude -w
--bare Modo para scripts — omite hooks, LSP y plugins; desde v2.1.286 solo conecta los servidores MCP indicados en la línea de comandos, no envía recordatorios del sistema y no inicia tareas en segundo plano claude -p "count files" --bare
--plugin-url <url> Descarga un archivo .zip de plugin para la sesión actual (v2.1.129+) claude --plugin-url https://example.com/plugin.zip
--plugin-dir <path> Carga un directorio de plugin, un archivo .zip o una carpeta de plugins – cada subcarpeta con manifiesto se carga, y los cambios se detectan en vivo (.zip v2.1.128+, modo carpeta v2.1.265+) claude --plugin-dir ./my-plugin.zip
--channels Reenvía las solicitudes de aprobación a Telegram/Discord claude --channels
--forward-subagent-text Incluye el texto y el razonamiento de los subagents en la salida stream-json (v2.1.211+); env: CLAUDE_CODE_FORWARD_SUBAGENT_TEXT=1 claude -p "audit" --output-format stream-json --forward-subagent-text
--ax-screen-reader Activa el modo de lector de pantalla (v2.1.208+); también CLAUDE_AX_SCREEN_READER=1 o "axScreenReader": true claude --ax-screen-reader
--desktop Abre la app de escritorio de Claude en el directorio actual, o en una sesión con --continue / --resume <id> (v2.1.285+) claude --desktop --continue
--cloud Inicia una sesión en la nube para el repositorio actual desde la terminal (--remote es el alias obsoleto); con -p y un ID de sesión o una URL de claude.ai/code, encola un mensaje en una sesión en la nube en ejecución y sale claude --cloud "Fix the flaky login test"
--debug Activa el registro de depuración claude --debug
--init Inicializa el proyecto con CLAUDE.md claude --init

Subcomando añadido en v2.1.212: claude auto-mode reset restablece el estado de tu Auto Mode desde la terminal; pasa --yes para omitir la solicitud de confirmación.7

Subcomandos de sesión y datos: claude attach <name> y claude logs <name> aceptan parte del nombre de una sesión en segundo plano en lugar de su id (v2.1.290+). claude purge [path] elimina el estado local de Claude Code de un proyecto (--dry-run muestra una vista previa); antes de v2.1.288 era claude project purge, y el nombre antiguo sigue funcionando con un aviso. Desde v2.1.300, claude remote-control ya no acepta --sandbox ni --no-sandbox (no tenían efecto; define sandbox.enabled en la configuración). Desde v2.1.309, claude ultrareview requiere confianza en el espacio de trabajo: la pide en una terminal y, de lo contrario, se niega; los scripts pasan --trust-workspace (sin valor; coloca antes el número de PR o la rama base) o definen CLAUDE_CODE_DISABLE_ULTRAREVIEW_TRUST_CHECK=1.14 claude self-hosted-runner --hold-idle-file <path> --max-hold-min <n> mantiene una sesión inactiva mientras tu host siga modificando el archivo, y la libera de todos modos después de n minutos (predeterminado 1440; v2.1.311+).


3. Comandos slash

Comando Qué hace
/init Inicializa el proyecto con CLAUDE.md
/compact Condensa el historial de la conversación. Añade un enfoque: /compact focus on tests
/autocompact Define qué tan llena puede estar la ventana de contexto antes de la compactación automática: /autocompact 500k, o auto para el valor predeterminado ajustado. Se guarda por modelo desde la v2.1.288, así que cada modelo conserva su propia ventana
/context Muestra el uso de la ventana de contexto con sugerencias prácticas
/diff Panel de diff a pantalla completa junto a la conversación que muestra en vivo tus cambios sin confirmar a medida que Claude edita; se activa y desactiva con /diff (v2.1.260)
/usage Uso de tokens, costo, uso del plan; diálogo unificado (v2.1.118+: /cost y /stats son atajos de escritura que abren pestañas de /usage); la v2.1.149+ añade el uso de los límites por categoría para skills, subagents, plugins y el costo por servidor MCP; la v2.1.299 añade advertencias por esfuerzo máximo, workflows, contexto siempre activo y resultados de herramientas grandes; la v2.1.305 convierte cada advertencia en una corrección de una línea que nombra su origen, y f aplica las correcciones (también en VS Code y /doctor)
/cost Atajo de escritura → abre la pestaña de costo de /usage (v2.1.118+)
/model Cambia el modelo. /model opus, /model sonnet; los nombres omiten el sufijo [1m] donde no tiene efecto, y el sufijo se sigue aceptando (v2.1.311+)
/advisor Define, muestra o desactiva el modelo asesor que Claude consulta en los puntos de decisión (herramienta de servidor experimental). /advisor opus, /advisor off; forma de texto en sesiones headless y de escritorio desde la v2.1.260; en Claude Platform en AWS desde la v2.1.300
/fast Activa o desactiva el modo de salida rápida – Opus 5.5 (el predeterminado desde la v2.1.280, $8/$40 por MTok), Opus 5 u Opus 4.8 ($10/$50; el modo rápido de Opus 4.8 quedó obsoleto el 30 de octubre de 2026 y se elimina el 30 de noviembre); la v2.1.219 eliminó Opus 4.7; ~2,5× la velocidad de salida; funciona en sesiones Remote (runners en la nube y autoalojados) desde la v2.1.271; enviado desde la vista de agente define con qué arrancan las sesiones nuevas, y un /fast a secas ahí abre un selector (v2.1.299+)
/effort Define el nivel de esfuerzo: low, medium, high, xhigh, max (predeterminado medium en Opus 5.5 y Sonnet 5.5, high en la mayoría de los demás modelos). Ultracode es un interruptor propio desde la v2.1.284: Tab en el deslizador, o /effort ultracode on / /effort ultracode off; ya no fuerza xhigh y permanece activo en cualquier nivel; en la vista de agente un /effort a secas abre un selector y el nivel se aplica a las sesiones nuevas (v2.1.299+). Escribir ultrathink en un prompt de terminal ejecuta ese turno en xhigh en Opus 5.5, Sonnet 5.5, Haiku 5.5 y Fable 5.1 (v2.1.311+; CLAUDE_CODE_DISABLE_ULTRATHINK=1 lo desactiva)
/status Muestra el estado de la sesión, el modelo y la configuración
/permissions Gestiona la configuración de permisos de forma interactiva
/auto-mode-setup Configuración guiada que redacta entradas de autoMode.environment (los campos de confianza y sensibilidad) a partir de tu proyecto y tus sesiones recientes; también en Bedrock, Vertex, Foundry, gateways y con la telemetría desactivada (v2.1.304+)
/config Abre la interfaz completa de configuración; una fila Idle compaction desactiva o vuelve a activar la compactación en reposo (v2.1.302+)
/mcp Configura los servidores MCP. /mcp enable, /mcp disable; /mcp reconnect all reintenta con todos los servidores que no lograron conectarse o que necesitan autenticación (v2.1.284+)
/hooks Muestra la configuración de hooks; se abre en una sola lista de tus hooks configurados agrupados por evento (v2.1.286+)
/memory Muestra y gestiona los archivos de memoria automática
/copy Copia bloques de código. /copy N para la N-ésima respuesta más reciente; el texto citado se copia sin sus marcadores > (v2.1.295+)
/resume Reanuda una sesión con nombre. /resume 1 o /resume name; en Pro y Max aparece una advertencia cuando reanudar una conversación inactiva consumiría una parte apreciable del límite de 5 horas (v2.1.304+)
/rename Asigna un nombre a la sesión actual. /rename feature-auth
/branch Ramifica la conversación para explorar en paralelo
/fork Copia la conversación en una nueva sesión en segundo plano — con fila propia en claude agents (reasignado en la v2.1.212); la copia obtiene su propio worktree desde la v2.1.221
/subtask Fork dentro de la sesión — el antiguo comportamiento de /fork con su nuevo nombre (v2.1.212)
/list-agents Lista todos los agentes a los que Claude puede enviar mensajes: subagents, tus otras sesiones locales y (con Remote Control) sesiones en otras máquinas (v2.1.224)
/peers Alias de /list-agents (v2.1.224)
/clear Borra el historial de la conversación
/plan Entra en modo plan. /plan refactor the auth module
/powerup Lecciones interactivas sobre funciones con demostraciones animadas (v2.1.90+)
/voice Activa o desactiva el modo de voz push-to-talk
/loop Tareas recurrentes. /loop 5m /foo se ejecuta cada 5 min
/schedule Crea una tarea programada en la nube (antes llamada rutina): de forma conversacional, o /schedule daily PR review at 9am; alias /routines; requiere iniciar sesión en claude.ai con las sesiones en la nube habilitadas
/slides Crea una presentación de Claude Slides como artefacto a partir de un brief; la beta de plantillas está activada de forma predeterminada en Pro, Max y Team
/rewind Vuelve a un punto de control (o pulsa Esc dos veces)
/export Exporta la transcripción de la conversación
/add-dir Añade directorios de trabajo para ampliar el acceso a archivos
/agents Eliminado en la v2.1.198 – pídele a Claude que cree o gestione subagents, o edita .claude/agents/ directamente; al escribir /agents se explica adónde fue el asistente
/goal Define una condición de finalización; Claude continúa hasta cumplir el objetivo (v2.1.139+)
/skills Lista los skills instalados; cuadro de búsqueda que filtra al escribir (v2.1.121+)
/skill-doctor Muestra qué skills cargados no se usan y cuánto contexto cuestan (v2.1.261+)
/bashes Lista las tareas de bash en segundo plano
/tasks Lista los agentes en segundo plano
/theme Gestiona temas con nombre (v2.1.118+); los plugins incluyen un directorio themes/
/output-style [name] Lista y cambia los estilos de salida; obsoleto de la v2.1.73 a la v2.1.268 en favor de /config, recuperado en la v2.1.269 – funciona mediante Remote Control y en sesiones en la nube/headless
/color Define el color de la barra del prompt. /color default para restablecerlo
/code-review [effort] Busca errores de corrección con un nivel de esfuerzo opcional; --comment publica comentarios en línea en el PR de GitHub (renombrado desde /simplify en la v2.1.147). Se ejecuta como subagent en segundo plano desde la v2.1.218. Desde la v2.1.223, /review es un alias de este comando, un /code-review a secas reutiliza el último nivel de esfuerzo que escribiste, y /code-review ultra es la revisión profunda en la nube. --max-findings <n> o --max-findings all reporta más o menos hallazgos que el límite habitual y se reutiliza hasta --max-findings default (v2.1.288+)
/batch Operaciones por lotes
/security-review Revisa el código en busca de vulnerabilidades
/claude-api Crea aplicaciones con la API de Claude y el SDK de Anthropic. /claude-api managed-agents-onboard <url> convierte el patrón de Managed Agents de una página en archivos ant apply; pasa en su lugar el nombre de un quickstart de la Console, como deep-researcher, para construir esa plantilla con la CLI ant (v2.1.290+); /claude-api api-version migra el código de la API a la versión 2026-10-21 de la API (v2.1.307+); managed-agents-secure [<agent-id>] comprueba la configuración de un Managed Agent contra la guía de despliegue seguro (v2.1.304+)
/doctor Revisión completa de la instalación — diagnostica y corrige problemas (v2.1.205; /checkup es un alias). /doctor prompt-audit (v2.1.283+) audita tus archivos CLAUDE.md, skills, agentes y comandos en busca de patrones de prompting escritos para modelos anteriores
/bug Reporta un error a Anthropic
/release-notes Selector interactivo de versiones con sus changelogs (v2.1.92+)
/buddy Mascota de compañía en la terminal — 18 especies, 5 niveles de rareza, determinista a partir del ID de la cuenta
/login / /logout Autentícate o cierra sesión desde la sesión en curso

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 la descripción, las herramientas permitidas, la anulación del modelo y la interpolación de argumentos mediante $ARGUMENTS o los 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

Atajo Acción
Ctrl+C Cancelar la operación actual o limpiar el prompt; Up sobre el prompt vacío recupera el borrador, incluidos los pegados y las imágenes (v2.1.288+), incluso después de un comando slash o de un mensaje enviado (v2.1.292+)
Ctrl+D Salir de la sesión (EOF)
Ctrl+L Limpiar la pantalla (conserva el historial)
Ctrl+O Alternar la salida detallada
Ctrl+R Buscar en el historial de comandos
Ctrl+V Pegar una imagen desde el portapapeles
Ctrl+B Enviar la operación actual a segundo plano
Ctrl+Enter (o Ctrl+X Ctrl+S) Enviar ahora: envía todos los mensajes en cola de una vez; el texto en cola se muestra en gris hasta que se recibe (v2.1.275+). Desde v2.1.281, las herramientas en ejecución pasan a segundo plano en lugar de cancelarse el turno
Ctrl+X Ctrl+K Detener todos los agentes (cambió desde Ctrl+F en v2.1.83; la segunda tecla tiene una ventana de 3 segundos con un aviso de tiempo agotado, v2.1.265+)
Ctrl+S Guardar temporalmente el borrador del prompt
Ctrl+G Abrir el editor externo; los editores que aceptan un número de línea se abren en la línea donde está el cursor (v2.1.286+)
Esc Esc Revertir el último cambio
Tab Aceptar la sugerencia del prompt
! Tab Autocompletar desde el historial de Bash
Shift+Tab Alternar entre los modos de permisos
Alt+P / Option+P Cambiar de modelo mientras escribes
Alt+T Alternar el modo de pensamiento
Ctrl+T Alternar el resaltado de sintaxis
Shift+Down Alternar entre los compañeros del equipo de agentes
Up/Down Navegar por el historial de comandos
v Modo visual de Vim — selección por caracteres (v2.1.118+; solo en modo vim)
V Modo visual por líneas de Vim (v2.1.118+; solo en modo vim)
% Vim: saltar al paréntesis (), corchete [] o llave {} correspondiente; d%, c% y y% operan a través de él (v2.1.301+; solo en modo vim)
? Mostrar los atajos

Prefijos rápidos

Prefijo Acción Ejemplo
# Añadir a la memoria persistente # Always use TypeScript
/ Comando slash /review
! Ejecutar bash directamente ! git status
@ Referenciar un archivo @src/index.ts
& Enviar una tarea a la nube & Build the API

Entrada multilínea

Método Teclas
Escapar el salto de línea \ y luego Enter
macOS Option+Enter
iTerm2/WezTerm/Ghostty/Kitty Shift+Enter
Otras terminales Shift+Enter (ejecuta /terminal-setup primero)
Carácter de control Ctrl+J

Las combinaciones de teclas se pueden personalizar con /keybindings (se guardan en ~/.claude/keybindings.json). Desde v2.1.284, las acciones effortSlider:decreaseEffort, increaseEffort y toggleUltracode reasignan las teclas de flecha y Tab del deslizador de /effort.


5. Archivos de configuración

Jerarquía de precedencia (de mayor a menor)

Nivel Ubicación Alcance
Empresarial (bloqueado) /Library/Application Support/ClaudeCode/managed-settings.json (macOS) Todos los usuarios, no se puede anular
Flags de CLI Argumentos de línea de comandos Sesión actual
Proyecto local .claude/settings.local.json Personal, proyecto actual (ignorado por git)
Proyecto compartido .claude/settings.json Equipo, versionado en git
Usuario global ~/.claude/settings.json Todos tus proyectos
Estado de ejecución ~/.claude.json Tokens de OAuth, configuración de MCP

La primera coincidencia gana. La configuración empresarial no se puede eludir.


6. Referencia de settings.json

Configuraciones clave con sus 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
  },
  "cleanupPeriodDays": 30,
  "respectGitignore": true,
  "showTurnDuration": true,
  "language": "en",
  "autoMemoryDirectory": ".claude/memory",
  "plansDirectory": ".claude/plans"
}

Sintaxis de las reglas de permisos: Tool(pattern:*) ofrece coincidencia por prefijo. Bash(npm run test:*) permite npm run test, npm run test:unit, etc. Los patrones de archivos usan sintaxis glob: Edit(src/**). Desde v2.1.214, una regla allow de un solo segmento como dir/** coincide solo con <cwd>/dir — ya no con cualquier dir/ en cualquier parte del árbol; escribe Edit(**/src/**) para coincidir a cualquier profundidad. Las reglas deny/ask conservan la coincidencia a cualquier profundidad, y las condiciones if: de los hooks reciben el mismo alcance de cwd. Desde v2.1.299, una regla allow de MCP alcanza solo al servidor que nombra: mcp__a ya no cubre un servidor llamado a__b ni a_; escribe mcp__<server>__* con el nombre normalizado completo.

Claves nuevas (v2.1.118+):

Clave Comportamiento
autoMode.allow $defaults Centinela que añade reglas personalizadas junto a la lista integrada (también para soft_deny y environment) — v2.1.118+
prUrlTemplate Plantilla de URL para la insignia de PR del pie de página — v2.1.119+
wslInheritsWindowsSettings WSL hereda la configuración administrada del lado de Windows — v2.1.118+
skillOverrides Ocultar o contraer skills: off, user-invocable-only o name-only — v2.1.129+
allowAllClaudeAiMcps Configuración administrada empresarial para cargar los conectores MCP en la nube de claude.ai junto con managed-mcp.json — v2.1.149+
allowClaudeInChromeWithManagedMcp Configuración administrada que permite ejecutar claude --chrome junto a un managed-mcp.json exclusivo – v2.1.282+
sandbox.filesystem.disabled Omitir el aislamiento del sistema de archivos manteniendo el control de salida de red — v2.1.216+
emojiCompletionEnabled Autocompletado de códigos cortos de emoji en la entrada del prompt (:heart: → ❤️); ponlo en false para desactivarlo — v2.1.217+
sandbox.network.strictAllowlist Denegar los hosts que no estén en la lista de permitidos para los comandos en sandbox sin preguntar — v2.1.219+
sandbox.allowNestedUserNamespaces Permitir que los comandos en sandbox en Linux y WSL2 creen espacios de nombres de usuario (Chromium, podman sin root); esto también les permite sortear las protecciones de archivos del sandbox – configuración de usuario o administrada, v2.1.305+
workflowSizeGuideline Establecer la pauta orientativa de tamaño de workflow dinámico desde cualquier archivo de configuración; el valor predeterminado es medium (“apunta a menos de 15 agentes”), y la fila de /config se oculta mientras haya una establecida — v2.1.219+
enableWorkflows / disableWorkflows enableWorkflows activa o desactiva los workflows dinámicos para ti (el interruptor Dynamic workflows de /config lo escribe; activado de forma predeterminada salvo en Pro); disableWorkflows: true los desactiva para todos a quienes alcance tu configuración, como la configuración administrada
syncClaudeAiSkills / syncClaudeAiPlugins Los skills y plugins de la cuenta de claude.ai se sincronizan con las sesiones de terminal iniciadas con esa cuenta; ponlo en false para excluirte – v2.1.275+
attribution Atribución en commits y PR; reemplaza al obsoleto includeCoAuthoredBy. "attribution": false la oculta por completo (v2.1.281+), pero las versiones anteriores de CLI omiten cualquier archivo de configuración que la contenga, así que conserva la forma de objeto (commit, pr, sessionUrl) en los archivos compartidos entre versiones
maxProseWidth Limitar el ancho de la prosa de Claude en terminales anchas (número entero de columnas, mínimo 40); las tablas y los bloques de código conservan el ancho completo – v2.1.282+
deniedModels Administrada: bloquear modelos específicos incluso cuando availableModels los permite; un alias de familia como "opus" bloquea toda la familia – v2.1.283+
availableModelsMatch Administrada: "exact" hace que cada entrada de availableModels permita solo la versión que nombra, de modo que las nuevas versiones quedan bloqueadas hasta que se listen (predeterminado "prefix") – v2.1.283+
allowedProviders Administrada: limitar qué proveedores de API puede usar una máquina (Anthropic API, un endpoint personalizado, Bedrock, Mantle, Vertex AI, Foundry, Claude Platform en AWS o un gateway en la nube) – v2.1.285+
idleCompaction false detiene la compactación en reposo, que compacta una conversación de más de 200K tokens dejada inactiva unos 54 minutos, antes de que expire su caché de prompt de una hora (CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS mueve el umbral); desde v2.1.314 también se ejecuta en VS Code y en la pestaña Code de la app de escritorio, con la telemetría desactivada, y en Bedrock, Vertex, Foundry y gateways una vez que la caché de prompt de una hora está activa – incluida en v2.1.299; la documentación fecha la clave en v2.1.290+
advisorModel Modelo asesor guardado (fable, opus, sonnet o un ID completo); /advisor lo escribe en la configuración de usuario, --advisor lo anula por sesión y CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 desactiva la herramienta
permissions.blockWritesOutsideWorkingDirectories Write, Edit y NotebookEdit rechazan las rutas fuera de los directorios de trabajo en todos los modos de permisos, bypassPermissions incluido; los comandos de shell, las herramientas MCP y los hooks no están limitados, y las herramientas EnterWorktree y ExitWorktree desaparecen mientras está activa. Cualquier archivo de configuración puede activarla; ninguno puede levantarla – v2.1.314+
disableRemoteControl Rechazar claude remote-control, --remote-control, el inicio automático y el interruptor dentro de la sesión; cualquier archivo de configuración, configuración administrada para imponerlo por MDM. /remote-control nombra la configuración cuando está establecida (v2.1.317+)

Para el esquema completo de configuración, consulta la Inmersión profunda en 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 inicio de cada sesión.

Dónde se ubica:

Ubicación Alcance
CLAUDE.md (raíz del proyecto) Todos los usuarios, todas las sesiones de este proyecto
.claude/CLAUDE.md Lo mismo, ubicación alternativa
~/.claude/CLAUDE.md Personal, todos los proyectos

AGENTS.md (v2.1.277+): en un proyecto sin CLAUDE.md, Claude Code lee AGENTS.md en su lugar – cambia el comportamiento en “Project instructions” dentro de /config (todavía no disponible en Bedrock/Vertex/Foundry).

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 avanzados: - Usa el prefijo # en el REPL para agregar cosas a la memoria automática sin editar CLAUDE.md: # Always use TypeScript strict mode - El CLAUDE.md de los subdirectorios se carga cuando Claude lee archivos en ese directorio - Las reglas compartidas con el equipo van en .claude/rules/*.md para una organización modular


8. Modos de permisos

Modo Comportamiento Caso de uso
default / manual — etiquetado “Manual” (v2.1.200+) Pregunta en el primer uso de cada herramienta Desarrollo normal
acceptEdits Aprueba automáticamente las ediciones de archivos, pregunta para bash Proyectos de confianza
auto Un clasificador (Sonnet 5 desde v2.1.210, originalmente Sonnet 4.6) revisa la seguridad de cada acción Autónomo con salvaguardas
plan Solo lectura — no se permiten ediciones ni ejecución Solo análisis y planificación
bypassPermissions Omite todas las solicitudes Automatización CI/CD

El modo Auto (v2.1.85+) es el modo inicial integrado para las sesiones interactivas de terminal y VS Code en todos los planes y proveedores: v2.1.283 lo extendió a proveedores de terceros y a sesiones con la telemetría desactivada, y v2.1.284 a todos los planes y proveedores; antes de eso era el predeterminado solo en Pro, Max y Team (desde el 14 de agosto de 2026). De v2.1.285 a v2.1.301, las sesiones de claude -p y del Python Agent SDK en proveedores de terceros o con la telemetría desactivada también iniciaban en modo auto cuando no había ningún modo de permisos configurado; v2.1.302 revierte eso: una sesión de claude -p o del Agent SDK sin modo de permisos inicia en Manual en proveedores de terceros, con la telemetría desactivada y en una instalación nueva, como siempre lo hizo donde se obtienen los feature flags, y --permission-mode auto mantiene auto.13 permissions.defaultMode anula el valor predeterminado integrado ("default" fija Manual), y disableAutoMode lo desactiva en toda la organización. Es el reemplazo recomendado de --dangerously-skip-permissions. Las operaciones de solo lectura y las ediciones de archivos se aprueban automáticamente; desde v2.1.281, donde la revisión del clasificador se ejecuta del lado del servidor, los comandos de shell de solo lectura y en sandbox también la esperan y se bloquean cuando los marca. 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 de datos sensibles al exterior.1

Cortacircuitos: 3 bloqueos consecutivos o 20 en total en una sesión hacen una pausa y vuelven a las solicitudes manuales.

La solicitud del modo auto antes de una lectura fuera de los directorios de trabajo ofrece Yes, but ask again next time (v2.1.284+): permite esa única lectura y seguir recibiendo la pregunta en las siguientes.

rm peligroso en modos desatendidos (v2.1.281): en modo auto y con --dangerously-skip-permissions, la solicitud del rm peligroso espera 2 minutos y luego deniega el comando con una sugerencia de reescritura para que la sesión continúe. Un rm recursivo cuyo objetivo es únicamente la salida de una sustitución de comandos, como rm -rf "$(pwd)", ahora pregunta incluso con una regla de permiso para Bash.

# 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

Cambios de permisos (v2.1.288-290): pyright ya no se trata como de solo lectura y pregunta primero, al igual que más formas de ps (v2.1.290). Los archivos de configuración de un proyecto ya no pueden activar Claude in Chrome; usa --chrome, /chrome o tu configuración de usuario (v2.1.290). El clasificador del modo auto del lado del cliente ignora un ANTHROPIC_DEFAULT_SONNET_MODEL fijado en Sonnet 5.5 u Opus 5.5 y usa Claude Sonnet 5 (v2.1.288).

Aprobación automática de PowerShell (v2.1.119+): los comandos de la herramienta PowerShell se aprueban automáticamente en el modo de permisos igual que los comandos de Bash. Las reglas de permiso como PowerShell(Get-*:*) evitan las solicitudes para operaciones de solo lectura. Usa v2.1.149+ en flujos de trabajo con mucho PowerShell; corrige las evasiones de permisos del cd integrado, la coincidencia de reglas de permiso por prefijo/comodín y el seguimiento obsoleto de variables de directorio.


9. Eventos de hooks

Evento Cuándo se dispara ¿Puede bloquear?
PreToolUse Antes de que se ejecute la herramienta Sí
PostToolUse Después de que la herramienta termina No
PostToolUseFailure Después de que la herramienta falla No
UserPromptSubmit El usuario envía un prompt Sí
Stop Claude termina la respuesta Sí
SubagentStart Se lanza un subagente No
SubagentStop Un subagente termina Sí
SessionStart Comienza la sesión No
SessionEnd Se cierra la sesión No
Notification Se activa una alerta No

| InstructionsLoaded | CLAUDE.md cargado | No | | ConfigChange | El archivo de configuración cambia a mitad de sesión | Sí | | DirectoryAdded | /add-dir o register_repo_root del SDK agrega un directorio de trabajo a mitad de sesión (v2.1.219+) | No | | WorktreeCreate | Se está creando un worktree | Sí | | WorktreeRemove | Se está eliminando un worktree | No | | PreCompact | Antes de la compactación del contexto | No | | PostCompact | Después de la compactación del contexto | No | | Elicitation | MCP solicita una entrada estructurada | Sí | | ElicitationResult | El usuario responde al diálogo de MCP | Sí | | StopFailure | El turno termina por 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 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 | Una tarea se marca como completada | Sí |

Para el protocolo completo de hooks (JSON de entrada/salida, matchers, códigos de salida), consulta Hooks en profundidad 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:

Patrón Coincide con
* Todas las herramientas
Bash Solo Bash
Edit\|Write Edit o Write
mcp__github Herramientas del servidor MCP
"" (vacío) Eventos sin herramientas (p. ej., UserPromptSubmit)

Códigos de salida:

Código Significado
0 Éxito — la operación continúa
2 Bloqueo — la operación se detiene, stderr se envía a Claude
1, 3+ Advertencia no bloqueante; un hook con "onFailure": "block" (v2.1.295+) bloquea en su lugar, como lo hace el código de salida 2

Los hooks asíncronos se ejecutan en segundo plano sin bloquear: agrega "async": true al objeto del hook.2 Los hooks de prompt y de agente ejecutan como máximo 12 de un mismo evento a la vez desde v2.1.302; el resto espera su turno.13

Campos de salida / entrada 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 lo introdujo 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 comando (v2.1.139+) — pasa un argv estructurado sin entrecomillado de shell.
  • Límites de hooks de skills (v2.1.304+): las skills de una misma fuente (un repo, tu propia carpeta o un plugin) pueden registrar como máximo 1.024 hooks y 16.384 caracteres de matcher por sesión; el hook once de una skill ya no elimina el hook idéntico de otra skill.
  • 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 los hooks de agente (v2.1.140+) — identifica qué tipo de agente se está ejecutando.
  • terminalSequence en la salida JSON del hook (v2.1.141+) — emite secuencias de control de terminal para notificaciones, títulos de ventana y campanas.
  • onFailure: "block" en hooks de comando y HTTP (v2.1.295+) – un hook que no puede iniciarse, agota el tiempo de espera, sale con un código distinto de 0 o 2, recibe un error HTTP o imprime JSON inválido bloquea la acción (lo que hace el código de salida 2 en ese evento; una denegación en PermissionRequest). Predeterminado "continue"; se ignora en Stop, SubagentStop, TaskCompleted, TeammateIdle y en los hooks asíncronos.

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 ya alcanza 100 millones de descargas mensuales y más de 3.000 servidores indexados.3 Para conocer los tipos de transporte, la solicitud de información y la configuración de la búsqueda de herramientas, consulta la sección de MCP en la guía completa.

alwaysLoad (v2.1.121+): Excluye un servidor de confianza de la carga diferida de Tool Search. Todas sus herramientas se cargan al iniciar la sesión, sin una consulta adicional a ToolSearch:

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

alwaysLoad: false (v2.1.287+) hace lo contrario: todas las herramientas de ese servidor quedan pendientes hasta que se solicitan mediante la búsqueda de herramientas.

Reintentos automáticos (v2.1.121+): Si un servidor MCP presenta un error durante el inicio, se reintenta la conexión hasta 3 veces antes de marcarlo como desconectado.

Solicitudes mediante URL (v2.1.287+): Los servidores MCP que usan el protocolo 2025-11-25 pueden abrir solicitudes mediante URL, por ejemplo, para iniciar sesión. Si un servidor deja de conectarse después de la actualización, agrega "bareElicitationCapability": true a su entrada de configuración de MCP.

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


11.5. Comandos de CLI para plugins

Comando Comportamiento
claude --plugin-url <url> Descarga un archivo .zip de un plugin para la sesión actual (v2.1.129+)
claude --plugin-dir <path> Carga un directorio de un plugin, un archivo .zip o una carpeta de plugins – se carga cada subcarpeta que contenga un manifiesto (.zip desde v2.1.128+, modo de carpeta desde v2.1.265+)
claude plugin prune Elimina los plugins instalados automáticamente cuyo plugin principal ya no está presente (v2.1.121+)
claude plugin uninstall <name> --prune Desinstala y elimina en cascada las dependencias huérfanas instaladas automáticamente (v2.1.121+)
claude plugin tag Crea etiquetas de git para versiones publicadas, con validación de la versión (v2.1.118+)
claude plugin eval Ejecuta el conjunto de evaluaciones de un plugin: resultados con puntuación y reproducibles, e informe en JSON + HTML (v2.1.269+)
claude plugin eval --disallow-tools <names> Excluye de las evaluaciones las herramientas integradas especificadas, como Agent (también mediante disallowed_tools en un caso); una ejecución que termina con un error de API recibe una puntuación de 0 y hace que falle el conjunto de evaluaciones (v2.1.299+)
claude plugin configure <plugin> Muestra las opciones de un plugin e indica cuáles no están configuradas; --values-stdin guarda los nuevos valores leídos de stdin (v2.1.285+)
claude plugin install <plugin> --config <server>.<key>=<value> Define la configuración propia de un servidor MCP incluido en un .mcpb durante la instalación, para que se inicie sin tener que ir a /plugin → Configurar (v2.1.285+)
claude plugin install <plugin> --marketplace <source> Agrega el marketplace si es necesario, con las mismas comprobaciones de políticas que claude plugin marketplace add, y luego instala el plugin desde allí (v2.1.292+)
claude plugin validate Valida un plugin antes de publicarlo; v2.1.281 agrega comprobaciones de MCP (entradas de .mcp.json que se descartarían sin aviso al cargar, referencias a ${user_config.*} sin declarar y URL inseguras) y una advertencia cuando ${CLAUDE_PLUGIN_ROOT} aparece sin comillas en un hook escrito como comando de shell
/plugin install <plugin> --marketplace <source> Instala durante la sesión desde un marketplace que aún no has agregado – ofrece agregarlo primero (v2.1.275+)
/plugin enable cc-plugin-you-should-know@builtin Activa You should know, un mod integrado cuyo agente auxiliar señala cosas que tú o Claude podrían pasar por alto (v2.1.287+; sesiones propias de Anthropic con la telemetría activada)

Mods (v2.1.287+): un mod es un plugin cuyos controladores de JavaScript o TypeScript se ejecutan dentro de Claude Code: puede dibujar paneles, agregar comandos y observar o modificar llamadas a herramientas. Los mods están activados de forma predeterminada; --safe-mode los desactiva durante una sesión y "disableAllHooks": true durante todas las sesiones, pero ninguna de estas opciones desactiva los mods integrados.8

Servidores LSP (v2.1.288+): una entrada de servidor LSP admite requestTimeout en milisegundos (valor predeterminado: 60000), de modo que, si el servidor nunca responde, la solicitud falla después de 60 segundos en lugar de quedarse bloqueada.


12. Tipos de subagents

Tipo Modelo predeterminado Modo Uso
Explore Hereda el modelo de la sesión, con Opus como límite (v2.1.198+; antes usaba Haiku) Solo lectura Buscar en el código del proyecto, encontrar archivos y comprender la estructura
General-purpose Hereda el modelo principal Lectura y escritura completas Tareas complejas de investigación y modificación
Plan Hereda el modelo principal Solo lectura Planificar implementaciones antes de ejecutarlas
Custom Configurable Configurable Trabajo especializado (revisión de seguridad, pruebas, etc.)

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 metadatos de encabezado en YAML. De forma predeterminada, se ejecutan hasta 20 subagents simultáneamente; CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS modifica ese límite.4 Desde v2.1.292, la herramienta Agent acepta un parámetro effort, por lo que puedes pedirle a Claude que ejecute un subagent con un nivel de esfuerzo determinado, y los nombres de los agentes tienen un límite de 256 caracteres (se ignora un name más largo en un archivo de skill o plugin). Desde v2.1.302, los subagents de tipo fork (subagent_type: "fork") están activados de forma predeterminada en claude -p, el SDK de Agent, la aplicación de escritorio y VS Code, además de la terminal (CLAUDE_CODE_FORK_SUBAGENT=0 los desactiva; claude mcp serve nunca los ofrece), y la aplicación de escritorio y VS Code siempre ejecutan en segundo plano los subagents de la conversación principal.13

claude agents abre Agent View en las versiones actuales: una pantalla de operaciones en fase de vista previa 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 opciones de lanzamiento para sesiones en segundo plano y v2.1.143 aplica esas opciones de forma uniforme al panel 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, contadores en la pestaña de sesiones que esperan una respuesta y correcciones en el panel de respuesta de Agent View; v2.1.147 agrega sesiones fijadas en segundo plano que permanecen activas cuando están inactivas y se reinician en el mismo lugar para aplicar actualizaciones; v2.1.287 agrega un filtro n:<text> que busca coincidencias en los nombres y las tareas de las sesiones; v2.1.288 agrega Ctrl+F para buscar una sesión por nombre y Alt+Up / Alt+Down para saltar entre grupos, ambos reasignables en keybindings.json (agents:find para Ctrl+F). Usa Agent View para supervisar, no como prueba de que el trabajo superó los controles de calidad.6

Campos de metadatos del encabezado de un agente personalizado:

Campo Propósito
name Identificador único (minúsculas, guiones)
description Cuándo invocarlo (incluye “PROACTIVELY” para la delegación automática)
tools Lista de herramientas separadas por comas. Admite Agent(Explore) para restringir los tipos que se pueden crear
disallowedTools Herramientas que se deben bloquear del conjunto heredado
model opus, sonnet, haiku o inherit (predeterminado)
permissionMode default/manual, acceptEdits, plan, bypassPermissions, etc.
maxTurns Número máximo de turnos del agente
background true para ejecutar siempre como tarea en segundo plano
isolation worktree para una copia aislada en un worktree de git
skills Skills precargadas en el contexto al iniciar; los primeros 32 nombres distintos (v2.1.295+)
autoCompactWindow Compacta automáticamente este subagent antes de alcanzar el tamaño de la ventana de la conversación principal, expresado en tokens (v2.1.296+)

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

Variable Propósito
ANTHROPIC_API_KEY Autenticación directa mediante la API
ANTHROPIC_AUTH_TOKEN Encabezado de autorización personalizado
ANTHROPIC_CUSTOM_HEADERS Encabezados adicionales para las solicitudes
### Configuración del modelo
Variable Propósito
---------- ---------
ANTHROPIC_MODEL Reemplaza el modelo predeterminado
CLAUDE_CODE_SUBAGENT_MODEL Modelo para los subagents; la v2.1.147 corrige la propagación a los procesos de los compañeros de un equipo de agentes
CLAUDE_CODE_SUBAGENT_EFFORT Nivel de esfuerzo con el que se ejecutan los subagents cuando nada más especifica uno, en lugar de heredar el de la sesión (v2.1.316+); un subagent en otro modelo usa el esfuerzo guardado de ese modelo o su valor predeterminado (v2.1.317+)
CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 Desactiva la herramienta advisor: /advisor deja de estar disponible, advisorModel se ignora y --advisor se acepta pero no hace nada
CLAUDE_CODE_DISABLE_ULTRATHINK=1 Desactiva la palabra clave ultrathink; desde la v2.1.311 ejecuta un turno de terminal en xhigh (v2.1.316+)
CLAUDE_CODE_DISABLE_WORKFLOWS=1 Desactiva los workflows dinámicos durante una sesión; equivale a "disableWorkflows": true, y sea cual sea el que los desactivó, el otro no puede volver a activarlos. Los workflows están activados de forma predeterminada salvo en Pro, donde "enableWorkflows": true (el interruptor Dynamic workflows de /config) los activa; la activación opcional CLAUDE_CODE_WORKFLOWS=1 de la v2.1.147 ya no figura en la referencia de variables de entorno
MAX_THINKING_TOKENS Activa el pensamiento extendido
CLAUDE_CODE_MAX_OUTPUT_TOKENS Limita la longitud de la salida
### Proveedores en la nube
Variable Propósito
---------- ---------
CLAUDE_CODE_USE_BEDROCK=1 Usa AWS Bedrock
CLAUDE_CODE_USE_VERTEX=1 Usa Google Vertex AI
CLAUDE_CODE_USE_FOUNDRY=1 Usa Microsoft Foundry
VERTEX_REGION_CLAUDE_HAIKU_5_5 Región de Vertex para Claude Haiku 5.5 (v2.1.293+)
ANTHROPIC_BEDROCK_SERVICE_TIER=priority Nivel de servicio de Bedrock — default/flex/priority (v2.1.122+); se envía como X-Amzn-Bedrock-Service-Tier
ENABLE_TOOL_SEARCH=true Activa Tool Search en Vertex AI (v2.1.119+; allí está desactivado de forma predeterminada). Detrás de un ANTHROPIC_BASE_URL personalizado, la búsqueda de herramientas está activada de forma predeterminada desde la v2.1.304, y un 400 o 422 del gateway se reintenta sin ella (la v2.1.305 corrigió la regresión que hacía fallar todas las solicitudes en proveedores que la rechazan); un gateway que rechaza los bloques tool_reference recibe la solicitud de nuevo sin búsqueda de herramientas y la sesión lo recuerda (v2.1.314+)
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 Activa el descubrimiento de modelos del gateway mediante /v1/models para el selector /model (v2.1.129+)
CLAUDE_CODE_AUTO_MODE_SERVER=0 Desactiva el clasificador del modo automático del lado del servidor (el clasificador local entonces cuenta para el uso); =1 lo activa. El lado del servidor es el predeterminado en Bedrock/Vertex/Foundry y gateways desde la v2.1.278, sin cobrar la sobrecarga del clasificador, y en una conexión directa con la Anthropic API con la telemetría desactivada desde la v2.1.282; desde la v2.1.281 la variable también aplica en una conexión directa con la Anthropic API (=1 era la activación opcional de las v2.1.273-277 mientras el local era el predeterminado)
CLAUDE_CODE_AUTO_MODE_MODEL Modelo que usa el clasificador del modo automático del lado del cliente; no tiene efecto en el modo automático del lado del servidor (v2.1.302+)
CLAUDE_CODE_MODEL_CATALOG=off Impide que las sesiones de Bedrock, Mantle, Vertex AI y Foundry carguen la configuración de modelos desde el archivo firmado en downloads.claude.ai (v2.1.311+)
CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT=0 Conserva el prompt del sistema completo (=1 usa el más corto en cualquier modelo); desde la v2.1.312, Bedrock, Mantle, Vertex AI y Foundry usan el prompt más corto para nombres de modelo que Claude Code no reconoce, incluso cuando detrás hay un Sonnet o un Haiku
CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK=1 Desactiva el cambio automático de modelo después de que un clasificador de seguridad marque una solicitud (el ajuste switchModelsOnFlag); desde la v2.1.312 también cubre nombres de modelo que Claude Code no reconoce
CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS=1 Deja de enviar salidas estructuradas, para Mantle o un gateway que las rechace (antes fallaban allí los títulos de sesión, la recuperación de memoria y los hooks de prompt, v2.1.288+)
CLAUDE_CODE_GATEWAY_HINT_HEADERS=1 Envía los encabezados de sugerencia x-claude-code-* a un gateway LLM o a un proveedor externo (v2.1.273+; la v2.1.283 añade x-claude-code-prompt-id, que agrupa las solicitudes que atienden un mismo prompt). Una conexión directa con la Anthropic API los envía de forma predeterminada; =0 los detiene en todas partes
### Control del comportamiento
Variable Propósito
---------- ---------
DISABLE_AUTOUPDATER=1 Impide las actualizaciones automáticas
DISABLE_UPDATES=1 Bloquea todas las vías de actualización, incluida la manual con claude update (v2.1.118+, más estricta que DISABLE_AUTOUPDATER)
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 Las instalaciones con Homebrew/WinGet ejecutan las actualizaciones del gestor de paquetes en segundo plano y piden reiniciar (v2.1.129+)
CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1 Clona las fuentes de plugins de GitHub mediante HTTPS en lugar de SSH cuando no hay claves SSH disponibles (v2.1.141+)
CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE Eliminada — sin efecto desde la v2.1.160. El modo rápido ahora es /model <model> y luego /fast on
CLAUDE_CODE_STOP_HOOK_BLOCK_CAP Reemplaza el límite de la v2.1.143+ que termina un turno con una advertencia después de repetidos hooks de stop bloqueantes
CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY=1 Desactiva el comportamiento -ExecutionPolicy Bypass de PowerShell de la v2.1.143+
CLAUDE_CODE_USE_POWERSHELL_TOOL=0 Desactiva la herramienta PowerShell donde la v2.1.143 la activa de forma predeterminada para usuarios de Bedrock, Vertex y Foundry
DISABLE_TELEMETRY=1 Desactiva la telemetría de uso
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 Desactiva el tráfico no esencial: actualizaciones automáticas, telemetría, informes de errores, /feedback, notas de la versión, obtención de feature flags (lo que también desactiva Remote Control); desde la v2.1.290 omite también el precalentamiento de la conexión al inicio. 0 o false siguen desactivándolo; elimina la variable para permitirlo
CLAUDE_CODE_ATTRIBUTION_HEADER=0 Omite el bloque de atribución del prompt del sistema; detrás de un gateway de Claude apps, configúrala en el env de la política code o cli (v2.1.299+)
CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH Límite de truncamiento para los atributos de contenido de OTel (60 KB de forma predeterminada, v2.1.214+)
CLAUDE_CODE_ENABLE_TELEMETRY, las variables de exportador OTEL_* y las de contenido OTEL_LOG_* Se ignoran en la configuración de proyecto y local desde la v2.1.282, salvo los valores que desactivan la telemetría; configúralas en tu shell, en la configuración de usuario o en la configuración administrada. /status y claude doctor listan los nombres ignorados
DISABLE_COST_WARNINGS=1 Oculta las advertencias de costo
DISABLE_PROMPT_CACHING=1 Desactiva el almacenamiento en caché de prompts de forma global
CLAUDE_CODE_DISABLE_1M_CONTEXT=1 Mantiene todos los modelos con 1M nativo en 200K mediante la compactación automática (la v2.1.223 lo amplió más allá de una lista fija). Desde la v2.1.285, las sesiones detrás de un ANTHROPIC_BASE_URL personalizado usan la ventana de 1M de los modelos que la tienen (Opus 4.7+, Sonnet 5+, Fable); ejecuta /autocompact 200k si tu gateway se detiene en 200K. Desde la v2.1.287, Opus 4.7+ y Fable también se ejecutan con 1M de forma predeterminada en Bedrock, Vertex, Foundry y el gateway de Claude apps, sin el sufijo [1m]; esta variable los mantiene en 200K
CLAUDE_CODE_AUTO_COMPACT_WINDOW Ventana de compactación automática en tokens, de 100000 a 1000000; los sufijos k y M funcionan desde la v2.1.304 (200k establecía silenciosamente una ventana de 100K), los valores fuera de rango generan una advertencia
CLAUDE_CODE_DISABLE_ULTRAREVIEW_TRUST_CHECK=1 Permite que claude ultrareview se ejecute en una carpeta no confiable donde no puede preguntar, como en CI; configúrala en el entorno de lanzamiento, no en un bloque env de la configuración (v2.1.309+)
CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS Tamaño del contexto a partir del cual se aplica la compactación en reposo, 200000 de forma predeterminada; los valores por debajo de 100000 se elevan a 100000; "idleCompaction": false desactiva la función (v2.1.299; la documentación dice v2.1.290+)
CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1 Permite que los ID de modelo no reconocidos superen la ventana de contexto asumida (v2.1.223)
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS=1 Elimina las instrucciones integradas de commit/PR
CLAUDE_CODE_DISABLE_WEB_FETCH=1 Desactiva la herramienta WebFetch (v2.1.285+)
CLAUDE_CODE_DISABLE_ARTIFACT=1 Desactiva la herramienta Artifact durante una sesión; ningún archivo de configuración la vuelve a activar mientras esté definida ("enableArtifact": false hace lo mismo desde la configuración o la fila Artifacts de /config)
CLAUDE_CODE_ARTIFACT_AUTO_OPEN=0 No abre el navegador cuando se publica un nuevo artefacto
CLAUDE_CODE_MAX_TURNS Limita los turnos agénticos cuando no se pasa --max-turns; la opción de línea de comandos gana cuando ambos están definidos
CLAUDE_CODE_SKIP_PROMPT_HISTORY=1 No escribe historial de prompts ni transcripción; la sesión nunca aparece en --resume, --continue ni en el historial de la flecha arriba (ejecuciones efímeras por script)
CLAUDE_CODE_TRANSCRIPT_LOCAL_GC=1 En una sesión larga con -p o del Agent SDK, descarta el historial previo a la compactación de una transcripción de más de 5 MB después de cada compactación; reanudar sigue restaurando la conversación; solo por entorno (v2.1.287+)
CLAUDE_CODE_SYNC_SKILLS=1 Hace que una ejecución con -p descargue los skills habilitados para tu cuenta de claude.ai y espere la lista antes de su primera consulta; con la obtención de feature flags desactivada, reutiliza una lista de hasta 10 minutos de antigüedad que otra sesión haya obtenido (v2.1.311+)
CLAUDE_CODE_DISABLE_NESTED_SESSION_ID=1 En un runner autoalojado, permite que un claude -p ejecutado dentro de una sesión comparta el ID y la transcripción de esa sesión, como antes de v2.1.317 (v2.1.317+)
CLAUDE_CODE_DISABLE_CFC_PROMPT=1 Conserva las herramientas de Claude in Chrome pero deja la sección de Chrome fuera del system prompt; en VS Code (v2.1.314+) también fuera de los mensajes de la sesión (v2.1.257+)
FORCE_HYPERLINK 1 fuerza la activación de los enlaces de terminal OSC 8 donde la detección no los reconoce; 0, false, no u off los muestra como texto plano (antes de v2.1.314 las tres palabras activaban los enlaces)
CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES Limita los reenvíos de una solicitud de respaldo sin streaming que agotó su tiempo de espera (v2.1.285+)
CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS Retraso inicial del backoff para solicitudes con error 529 (sobrecarga), 500 ms por defecto, acepta 500-32000; sin efecto bajo el watchdog de reintentos ni en modo rápido (v2.1.292+)
CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS Tope de ese backoff en milisegundos, 32000 por defecto (v2.1.296+)
CLAUDE_CODE_RETRY_WATCHDOG=1 Sesiones desatendidas: reintenta indefinidamente los errores de capacidad 429 y 529, con esperas de hasta 5 minutos o hasta que el límite se restablezca (v2.1.186+)
CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS Tope por solicitud del tiempo que el watchdog espera ante errores 429 y 529; sin definir significa sin límite (v2.1.295+)
CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS Bajo el watchdog, termina una solicitud detenida por un límite de uso cuyo restablecimiento está más lejos que este valor, en lugar de esperar (v2.1.301+)
CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS Intervalo mínimo entre comprobaciones de si un límite de uso se levantó antes de su restablecimiento mientras el watchdog lo espera (v2.1.305+)
CLAUDE_CODE_DISABLE_ATTACHMENTS=1 Envía las menciones de archivo con @ como texto plano en lugar de expandirlas. Desde v2.1.290, el .claude/settings.json o .claude/settings.local.json de un repositorio ya no puede definirla; el shell, la configuración de usuario y la configuración administrada sí pueden
CLAUDE_CODE_DISABLE_FILE_MENTIONS=1 Entrega a Claude la ruta de una mención con @ para que la lea con sus herramientas de archivos, en lugar del contenido del archivo, de modo que los hooks PreToolUse vean la lectura; solo desde el shell, la configuración de usuario y la configuración administrada (v2.1.299+)
CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS Milisegundos antes de que se cancele un diálogo reenviado a un cliente remoto (Remote Control, un host del SDK); anula dialogExpiry, 0 lo desactiva. Un valor con sufijo de unidad como 5m recurre a dialogExpiry desde v2.1.290 (antes se leía como 5 ms)
CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT=1 Mantiene en espera la solicitud de confirmación de un rm peligroso en modo auto y con --dangerously-skip-permissions, en lugar de denegarla tras 2 minutos (v2.1.281+)
CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT=1 Omite la confirmación de un rm recursivo cuyo destino es solo la salida de una sustitución de comando, como rm -rf "$(pwd)" (v2.1.281+)
CLAUDE_CODE_STRICT_INLINE_SHELL_RM_PROMPT=1 Sigue pidiendo confirmación para un rm construido en tiempo de ejecución dentro de un script de shell -c que Claude Code no puede leer; por defecto esos scripts ya no piden confirmación (v2.1.299+)
CLAUDE_CODE_HIDE_CWD=1 Oculta el directorio de trabajo en el logo de inicio (v2.1.119+)
CLAUDE_CODE_FORK_SUBAGENT=0 Desactiva los subagentes fork; activados por defecto en la terminal y, desde v2.1.302, en claude -p, el Agent SDK, la app de escritorio y VS Code (=1 era la activación opcional en builds externas desde v2.1.117; claude mcp serve nunca los ofrece)
CLAUDE_CODE_FORCE_SYNC_OUTPUT=1 Fuerza la salida sincronizada de terminal cuando la detección automática no la reconoce (v2.1.129+)
CLAUDE_CODE_FORWARD_SUBAGENT_TEXT=1 Incluye el texto y el razonamiento de los subagentes en la salida stream-json; se combina con --forward-subagent-text (v2.1.211+)
CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION Tope de WebSearch por sesión (200 por defecto, v2.1.212+). Desde v2.1.290, las sesiones interactivas recargan su presupuesto de WebSearch con el tiempo en lugar de detenerse tras 200 llamadas
CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR Tasa de recarga del presupuesto de WebSearch de la sesión interactiva (100 llamadas por hora por defecto; 0 desactiva las recargas, v2.1.290+)
CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION Tope de subagentes lanzados por sesión (200 por defecto; /clear restablece el presupuesto, v2.1.212+)
CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS Tope de subagentes en ejecución simultánea (20 por defecto; distinto del total por sesión de arriba, v2.1.217+)
CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS Escalonamiento del fan-out de Workflow para reutilizar la caché de prompts; 0 lo desactiva (v2.1.229+)
CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL Ejecuta todos los agentes de un workflow en un mismo modelo mientras los demás subagentes conservan el suyo (v2.1.296+)
CLAUDE_CODE_TOOL_MEMORY_LIMIT Cgroup de memoria de Linux opcional (MB) para los comandos de la herramienta Bash (v2.1.233+)
CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS TTL de la caché de sesión por URL de WebFetch, 15 min por defecto (v2.1.233+)
CLAUDE_CODE_ENABLE_TODO_TOOLS Restaura las herramientas de todo/tareas en Opus 4.8+/Sonnet 5+/Fable 5+, desactivadas por defecto desde v2.1.233
CLAUDE_CODE_PROJECT_DIR_NAME Nombre corto por proyecto del directorio de transcripciones, para hosts con directorios de configuración por sesión (v2.1.234+)
CLAUDE_CODE_GOAL_CHECKIN_MINUTES Revisa las tareas en segundo plano que bloqueen un /goal durante este tiempo; 0 lo desactiva (v2.1.234+, 30 por defecto)
CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH Profundidad de anidamiento de subagentes — 3 por defecto desde v2.1.219; define 1 para desactivar el anidamiento. Historial del valor por defecto: 5 (v2.1.172–v2.1.216) → 1 (v2.1.217) → 3 (v2.1.219), así que defínelo explícitamente
CLAUDE_AX_SCREEN_READER=1 Activa el modo de lector de pantalla; equivale a --ax-screen-reader (v2.1.208+)
CLAUDE_AX_PREPARK_MS Milisegundos que el modo de lector de pantalla espera antes de escribir una línea nueva o modificada; 0 por defecto desde v2.1.287 (antes 50), así que define 50 para recuperar la pausa
### Configuración de herramientas
Variable Propósito
---------- ---------
BASH_DEFAULT_TIMEOUT_MS Tiempo de espera de los comandos Bash (30000 por defecto)
BASH_MAX_TIMEOUT_MS Tiempo de espera máximo de bash (600000 por defecto)
MCP_TIMEOUT Tiempo de espera de arranque de los servidores MCP (5000 por defecto)
MCP_TOOL_TIMEOUT Tiempo de espera de ejecución de las herramientas MCP (30000 por defecto); v2.1.142 corrige que las llamadas remotas HTTP/SSE ignoraran valores más altos
CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH Anula el tope de las descripciones de herramientas e instrucciones de servidor MCP, 4.096 caracteres desde v2.1.296 (2.048 en v2.1.280-295) – se aplica a todos los servidores MCP de la sesión (v2.1.280+); los servidores propios de Anthropic en api.anthropic.com no se recortan desde v2.1.299
MCP_PROTOCOL_NEGOTIATION legacy deja de sondear los servidores en busca del protocolo MCP 2026-07-28; auto sondea los servidores HTTP, de conector y stdio. Los servidores locales (stdio) negocian 2026-07-28 por defecto en todas las instalaciones, incluidas Bedrock, Vertex y Foundry, desde v2.1.292; los conectores de sesiones en la nube y de Remote Control lo negocian por defecto desde v2.1.299
CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS Umbral a partir del cual una llamada larga a una herramienta MCP pasa automáticamente a segundo plano (2 min por defecto, v2.1.212+)
Comandos en segundo plano (v2.1.285+): los comandos Bash y PowerShell en segundo plano se detienen tras un límite de tiempo – su timeout con run_in_background, 30 minutos por defecto, 2 horas como máximo – y Claude recibe una notificación cuando uno se detiene. Desde v2.1.288 el límite se aplica solo en sesiones desatendidas (-p, Agent SDK, CI, nube); las sesiones de terminal, de la app de escritorio y de VS Code no tienen límite.

Red y proxy

Variable Propósito
HTTP_PROXY / HTTPS_PROXY Configuración del proxy
NO_PROXY Omite el proxy para dominios específicos
CLAUDE_CODE_CLIENT_CERT Ruta del certificado mTLS
ANTHROPIC_WORKSPACE_ID Acota los tokens de federación de identidad de carga de trabajo cuando una regla abarca varios workspaces (v2.1.141+)
CLAUDE_CODE_GZIP_REQUEST_BODIES=0 Desactiva la compresión gzip de los cuerpos de solicitud grandes enviados a api.anthropic.com, activada incluso con la telemetría desactivada (v2.1.300+)
CLAUDE_CODE_DISABLE_LOOPED_CROSS_CERT_DROP=1 Conserva los certificados cruzados del sistema que se certifican mutuamente en bucle, para una CA privada que necesite uno (v2.1.316+)
OTEL_EXPORTER_OTLP_TIMEOUT Tiempo de espera de exportación estándar de OTel (milisegundos); una exportación OTLP detrás de un proxy que nunca responde se rinde tras 10 segundos, o tras este valor hasta un máximo de 30 segundos (v2.1.317+)
Para la lista completa, consulta Variables de entorno en la guía completa.

14. Referencia de costos

Precios por 1 millón de tokens (a octubre de 2026).510

Modelo Entrada Salida Notas
Sonnet 5.5 $2,00 $10,00 El modelo Sonnet predeterminado en la Anthropic API desde la v2.1.284 (28 de septiembre de 2026) – ID de modelo claude-sonnet-5-5, 1M de contexto / 128K de salida, lecturas de caché a $0,10/MTok (0,05x la entrada; la v2.1.296 corrige las cifras de costo de Claude Code, que usaban $0,20), fecha de corte de conocimiento junio de 2026. Programación diaria sensible al costo; effort usa medium de forma predeterminada en Claude Code. /model sonnet en la Anthropic API (Claude Platform en AWS resuelve sonnet a Sonnet 4.6; Bedrock, Agent Platform y Foundry a Sonnet 4.5).
Sonnet 5 (anterior) $2,00 $10,00 Lo que sonnet seleccionaba en la Anthropic API de la v2.1.197 a la v2.1.283, y el predeterminado de Pro/Team Standard hasta que la v2.1.280 pasó esos planes a Opus. Contexto nativo de 1M; $2/$10 es el precio de lista estándar (el aumento a $3/$15 programado para el 1 de septiembre se canceló; la v2.1.243 actualizó el selector de /model para reflejarlo). Fíjalo con ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5.
Opus 5.5 $4,00 $20,00 El modelo Opus predeterminado desde la v2.1.280 (22 de septiembre de 2026) – ID de modelo claude-opus-5-5, 1M de contexto, lecturas de caché a $0,20/MTok (0,05x la entrada, frente al 0,1x estándar). Más barato que Opus 5 en todas las posiciones, y el modelo predeterminado en todos los planes ahora que la v2.1.280 pasa Pro y Team Standard de Sonnet a Opus. /model opus.
Opus 5 (anterior) $5,00 $25,00 El nivel Opus de la v2.1.219 (24 de julio de 2026) a la v2.1.278 — ID de modelo claude-opus-5, 1M de contexto / 128K de salida, pensamiento activado de forma predeterminada, effort usa high de forma predeterminada, fecha de corte de conocimiento mayo de 2026. Fue el predeterminado de los planes premium – Max, Team Premium, Enterprise (asientos desde la v2.1.251) – y el de la Anthropic API, hasta que la v2.1.280 convirtió a Opus 5.5 en el modelo Opus predeterminado. Fíjalo con ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5.
Opus 4.8 (heredado) $5,00 $25,00 Mismo precio, ahora en la tabla de modelos heredados (Legacy) de la documentación; el predeterminado del nivel premium de la v2.1.154 a la v2.1.219. El modo rápido en él quedó obsoleto el 30 de octubre de 2026 y se elimina el 30 de noviembre de 2026. Fíjalo con ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-8.
Fable 5.1 $10,00 $50,00 Nivel por encima de Opus; /model fable lo selecciona desde la v2.1.257, la primera versión instalable que lo incluye (Fable 5, v2.1.170+, pasó a la tabla de modelos heredados de la documentación). ID de modelo claude-fable-5-1, 1M de contexto / 128K de salida, pensamiento adaptativo siempre activo, fecha de corte de conocimiento junio de 2026 (compartida con Opus 5.5 y Sonnet 5.5), lecturas de caché a $0,25/MTok (0,025x la entrada, frente al 0,1x estándar).
Haiku 5.5 $0,10 $0,50 Lo que haiku selecciona en la Anthropic API desde la v2.1.293 (7 de octubre de 2026) – ID de modelo claude-haiku-5-5, 1M de contexto / 128K de salida, pensamiento adaptativo que no se puede desactivar, fecha de corte de conocimiento junio de 2026. Un prompt de más de 100K tokens paga $0,50 / $2,50, con todos los tokens de esa solicitud incluidos; lecturas de caché a $0,01 (0,1x estándar). Exploración rápida, tareas simples, subagents. Sigue siendo Haiku 4.5 en Bedrock, Vertex, Foundry y Claude Platform en AWS. /model haiku.
Haiku 4.5 (anterior) $1,00 $5,00 Lo que haiku seleccionaba antes de la v2.1.293, y lo que sigue seleccionando en Bedrock, Vertex, Foundry y Claude Platform en AWS. Fíjalo con ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5-20251001.

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 5.5: alrededor de $0,01-$0,05 a las tarifas para prompts de hasta 100K tokens. Sesión con Opus 5.5: $0,40-$1,80.

Modelo predeterminado en Claude Code (por plan): Opus en todos los planes desde la v2.1.280 (22 de septiembre de 2026) – Pro y Team Standard pasaron de Sonnet a Opus, igualando a Max, Team Premium y Enterprise – y el modelo Opus predeterminado es Opus 5.5 (claude-opus-5-5), donde ahora aterriza el alias opus. La división de la v2.1.251 (Opus 5 en los planes premium, Sonnet 5 en Pro/Team Standard) y el predeterminado de Sonnet 5 en todas partes de la v2.1.197 son historia. Los administradores pueden establecer un predeterminado para toda la organización, que aparece como “Org default” en /model (v2.1.196+). Claude Platform en AWS, Amazon Bedrock y Agent Platform de Google Cloud también usan Opus 5.5 de forma predeterminada; Microsoft Foundry es la única excepción (Sonnet 4.5 predeterminado, y el único lugar donde opus resuelve a Opus 4.6) – fija un modelo específico con ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODEL.

Opus 5.5, Sonnet 5.5, Haiku 5.5, Sonnet 5, Opus 5, Opus 4.8, Fable 5 y Fable 5.1 usan solo razonamiento adaptativo (sin presupuestos fijos de pensamiento), con /effort xhigh para el trabajo de programación y agéntico más difícil. effort usa high de forma predeterminada en todos ellos excepto Opus 5.5 y Sonnet 5.5, que usan medium, como hace Haiku 5.5 en la Claude API – y desde la v2.1.280, un nivel de esfuerzo que guardaste antes de que /effort pasara a ser por modelo ya no se traslada a modelos recién lanzados como Opus 5.5, así que este arranca con su propio valor predeterminado hasta que elijas uno. El pensamiento no se puede desactivar en Opus 5.5, Sonnet 5.5 ni en los modelos Fable (MAX_THINKING_TOKENS=0 no tiene efecto ahí). Cambios incompatibles de Opus 5 frente a Opus 4.8: el pensamiento está activado de forma predeterminada en las solicitudes que omiten el campo thinking, y thinking: {type: "disabled"} con effort xhigh o max devuelve un 400.

El modo rápido (/fast) se aplica a Opus 5.5 y Opus 5, y a Opus 4.8 hasta el 30 de noviembre de 2026 (obsoleto desde el 30 de octubre; tras la eliminación, una solicitud en modo rápido en Opus 4.8 da error en lugar de ejecutarse a velocidad estándar), con Opus 5.5 como predeterminado desde la v2.1.280 – $8 / $40 por MTok en Opus 5.5, $10 / $50 en Opus 5 y 4.8 (2× el precio base en cada caso) a cambio de hasta 2,5× tokens de salida por segundo. Opus 4.7 fue eliminado: claude-opus-4-7 + speed: "fast" ahora da error en lugar de recurrir a la velocidad estándar. Vista previa de investigación, solo en la Claude API y las suscripciones (no en Bedrock/Vertex/Foundry ni en Claude Platform en AWS); cambiar de velocidad invalida la caché de prompts. Desde la v2.1.271, el modo rápido también funciona en las sesiones de Claude Code Remote (runners en la nube y autoalojados): la configuración de modo rápido del host, o /fast escrito en la sesión, se aplica donde tu organización lo permita.

Cambiar de modelo durante una sesión:

/model opus       # Switch to Opus 5.5 (v2.1.280+)
/model sonnet     # Switch to Sonnet 5.5 on the Anthropic API (v2.1.284+)
/model haiku      # Switch to Haiku 5.5 on the Anthropic API (v2.1.293+)
/model fable      # Switch to Fable 5.1 (tier above Opus, v2.1.257+)
/effort xhigh     # Recommended for the hardest coding/agentic work

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 de archivos clave

Ruta Propósito
~/.claude/settings.json Configuración global del usuario
~/.claude/keybindings.json Atajos de teclado personalizados
~/.claude/CLAUDE.md Instrucciones personales (todos los proyectos)
~/.claude/commands/ Comandos slash personales
~/.claude/skills/ Skills personales
~/.claude/agents/ Definiciones personales de subagents
~/.claude.json Estado de ejecución, tokens de OAuth, configuración de MCP
.claude/settings.json Configuración del proyecto (compartida vía git)
.claude/settings.local.json Configuración del proyecto (personal, ignorada por git)
.claude/CLAUDE.md Instrucciones del proyecto
.claude/commands/ Comandos slash del proyecto
.claude/agents/ Definiciones de subagents del proyecto
.claude/skills/ Skills del proyecto
.claude/plans/ Archivos de salida del modo plan
.claude/memory/ Archivos de memoria automática
.mcp.json Configuración de servidores MCP del proyecto
CLAUDE.md Instrucciones del proyecto (alternativa en la raíz)
AGENTS.md Se lee como instrucciones del proyecto cuando el proyecto no tiene CLAUDE.md (v2.1.277+)

16. Registro de cambios

Fecha Cambio
2026-11-02 Sincronización dirigida de v2.1.311-317 (26 de octubre al 2 de noviembre; npm latest y next en 2.1.317, stable pasa a 2.1.311; 2.1.313 nunca se publicó, 2.1.315 está en npm sin entrada en el changelog). El modo rápido en Opus 4.8 quedó obsoleto el 30 de octubre y se retira el 30 de noviembre. ultrathink ejecuta un turno de terminal en xhigh. Filas agregadas: permissions.blockWritesOutsideWorkingDirectories, disableRemoteControl, CLAUDE_CODE_SUBAGENT_EFFORT, CLAUDE_CODE_DISABLE_ULTRATHINK, CLAUDE_CODE_MODEL_CATALOG, CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT, CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK, CLAUDE_CODE_SKIP_PROMPT_HISTORY, CLAUDE_CODE_TRANSCRIPT_LOCAL_GC, CLAUDE_CODE_SYNC_SKILLS, CLAUDE_CODE_DISABLE_NESTED_SESSION_ID, CLAUDE_CODE_DISABLE_CFC_PROMPT, FORCE_HYPERLINK, CLAUDE_CODE_DISABLE_LOOPED_CROSS_CERT_DROP, OTEL_EXPORTER_OTLP_TIMEOUT. Filas actualizadas: /fast, /model (se quita [1m] donde no tiene efecto), /effort, idleCompaction (VS Code, escritorio y proveedores de terceros desde v2.1.314), ENABLE_TOOL_SEARCH, la tabla de costos y los subcomandos del runner.16
2026-10-26 Sincronización de documentación, sin nueva versión de CLI (npm latest 2.1.310, stable 2.1.308). Filas agregadas: --cloud (--remote es el alias obsoleto; -p "msg" --cloud <session-id> encola un mensaje en una sesión en la nube que ya está en ejecución), /schedule (tareas programadas en la nube, antes llamadas routines; alias /routines), /slides (beta de plantillas de artefactos), CLAUDE_CODE_DISABLE_ARTIFACT, CLAUDE_CODE_ARTIFACT_AUTO_OPEN, CLAUDE_CODE_MAX_TURNS, enableWorkflows / disableWorkflows. Fila reemplazada: CLAUDE_CODE_WORKFLOWS=1 (el opt-in de v2.1.147, que desapareció de la referencia de variables de entorno) por CLAUDE_CODE_DISABLE_WORKFLOWS=1; los workflows están activados de forma predeterminada salvo en Pro. La guía completa incorpora Projects (beta pública desde el 17 de septiembre de 2026).15
2026-10-23 Sincronización dirigida de v2.1.303-310 (18 al 23 de octubre; npm latest y next en 2.1.310, stable pasa a 2.1.308; 303 y 308 son versiones de confiabilidad de una sola línea). Filas agregadas: /auto-mode-setup, sandbox.allowNestedUserNamespaces, CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS, CLAUDE_CODE_AUTO_COMPACT_WINDOW (sufijos k/M), CLAUDE_CODE_DISABLE_ULTRAREVIEW_TRUST_CHECK. Filas actualizadas: las correcciones de una línea de /usage con f (v2.1.305), la advertencia de reanudación de 5 horas de Pro/Max en /resume (v2.1.304), /claude-api api-version y managed-agents-secure, la búsqueda de herramientas activada de forma predeterminada detrás de una URL base personalizada (v2.1.304) con la corrección de la regresión en v2.1.305, la confianza del espacio de trabajo en claude ultrareview (v2.1.309), los topes de hooks de skills (v2.1.304).14
2026-10-17 Sincronización dirigida de v2.1.301-302 (15 y 16 de octubre; npm latest y next en 2.1.302, stable se mantiene en 2.1.292; nada omitido). claude -p y el SDK vuelven a iniciar en Manual con proveedores de terceros, con la telemetría desactivada y en instalaciones nuevas (v2.1.302 revierte v2.1.285; --permission-mode auto conserva auto). Los subagentes fork quedan activados de forma predeterminada en -p, el SDK, el escritorio y VS Code (CLAUDE_CODE_FORK_SUBAGENT=0 los desactiva); el escritorio y VS Code siempre envían a segundo plano los subagentes de la conversación principal; los hooks de prompt y de agente tienen un tope de 12 por evento. Filas: CLAUDE_CODE_AUTO_MODE_MODEL, CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS, % de vim, la fila Idle compaction de /config.13
2026-10-14 Sincronización dirigida de v2.1.300 (14 de octubre; npm latest y next en 2.1.300, stable pasa a 2.1.292). Filas agregadas para la herramienta Advisor (/advisor, --advisor, advisorModel, CLAUDE_CODE_DISABLE_ADVISOR_TOOL): un segundo modelo del lado del servidor que Claude consulta en los puntos de decisión, disponible en Claude Platform en AWS a partir de esta versión. Fila CLAUDE_CODE_GZIP_REQUEST_BODIES; claude remote-control pierde --sandbox/--no-sandbox; el updatedInput de los hooks ahora se valida igual que la propia entrada de Claude.12
2026-10-14 Sincronización dirigida de v2.1.299 (14 de octubre; npm latest 2.1.299, next 2.1.300 todavía sin notas, stable se mantiene en 2.1.287; 2.1.297 y 2.1.298 nunca se publicaron). Compactación en inactividad: una conversación de más de 200K tokens inactiva unos 54 minutos se compacta antes de que expire su caché de prompts de una hora; nueva fila de configuración idleCompaction y fila de entorno CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS. Nuevas filas de entorno CLAUDE_CODE_DISABLE_FILE_MENTIONS, CLAUDE_CODE_STRICT_INLINE_SHELL_RM_PROMPT y CLAUDE_CODE_ATTRIBUTION_HEADER; CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS ya está documentada (techo, 32000 de forma predeterminada). Las reglas de MCP coinciden con nombres de servidor completos (mcp__a ya no cubre a__b; escribe mcp__<server>__*), anotado en la sintaxis de reglas de permisos; los servidores propios en api.anthropic.com quedan exentos del tope de descripción; los conectores de la nube y de Remote Control usan el protocolo 2026-07-28. Advertencias de /usage, /effort y /fast en la vista de agente, claude plugin eval --disallow-tools. Dos regresiones de 2.1.296 corregidas (Edit y Retry en sesiones en la nube; una llamada a herramienta aprobada que se ejecutaba dos veces tras un reinicio).11
2026-10-11 Sincronización dirigida de v2.1.293-296 (7 al 9 de octubre; npm latest y next en 2.1.296, stable pasa a 2.1.287). Claude Haiku 5.5 (claude-haiku-5-5, $0,10 / $0,50 por MTok para prompts de hasta 100K tokens, $0,50 / $2,50 por encima) es lo que selecciona haiku en la API de Anthropic (v2.1.293): nueva fila en la Referencia de costos, Haiku 4.5 reclasificado como modelo anterior, nota de /model haiku actualizada; las lecturas de caché de Sonnet 5.5 corregidas a $0,10. Hooks: onFailure: "block" (v2.1.295). Tope de descripción de MCP en 4.096 (v2.1.296). Nuevas filas: skills (32 precargadas), autoCompactWindow, CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS, CLAUDE_CODE_RETRY_WATCHDOG, CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS, CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL, VERTEX_REGION_CLAUDE_HAIKU_5_5; nota de /copy.10
2026-10-06 Sincronización dirigida de v2.1.288-292 (2 al 6 de octubre; npm latest y next en 2.1.292, stable se mantiene en 2.1.285). 2.1.291 corrige regresiones de 2.1.288 y 2.1.290, así que actualiza a una versión posterior a ambas. El presupuesto de WebSearch se recarga cada hora en las sesiones interactivas (v2.1.290); los límites de comandos en segundo plano solo aplican a sesiones sin supervisión (v2.1.288); claude project purge ahora es claude purge. Nuevas filas: /autocompact, plugin install --marketplace, CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS, CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR, MCP_PROTOCOL_NEGOTIATION y cuatro variables de entorno más; notas de permisos, Agent View, /code-review y /claude-api actualizadas.9
2026-10-01 Sincronización dirigida de v2.1.286-287 (30 de septiembre al 1 de octubre; npm latest y next en 2.1.287, stable pasa a 2.1.285; nada omitido desde 2.1.285). Contexto de 1M de forma predeterminada para Opus 4.7+ y Fable en Bedrock, Vertex, Foundry y el gateway de apps de Claude (v2.1.287): fila CLAUDE_CODE_DISABLE_1M_CONTEXT actualizada. Llegan los mods, con el mod integrado You should know (v2.1.287). --bare conecta solo los servidores MCP de línea de comandos y no inicia tareas en segundo plano (v2.1.286). Nuevas filas: CLAUDE_AX_PREPARK_MS (ahora 0 de forma predeterminada), /plugin enable cc-plugin-you-should-know@builtin; notas agregadas sobre alwaysLoad: false, los prompts por URL y bareElicitationCapability, el filtro de agentes n:<text>, /hooks y Ctrl+G. La nota del modo auto ahora coincide con la documentación de modos de permisos.
2026-09-29 Sincronización dirigida de v2.1.284-285 (28 y 29 de septiembre; npm latest y next en 2.1.285, stable pasa a 2.1.280; nada omitido desde 2.1.283). Claude Sonnet 5.5 (claude-sonnet-5-5, $2/$10 por MTok) es el modelo Sonnet predeterminado en la API de Anthropic (v2.1.284): nueva fila en la Referencia de costos, fila de Sonnet 5 reclasificada como modelo anterior, notas de esfuerzo y de pensamiento actualizadas. El modo auto ahora inicia las sesiones interactivas en todos los planes y proveedores (v2.1.284), y también las sesiones de claude -p / Python Agent SDK con proveedores de terceros o con la telemetría desactivada (v2.1.285). Ultracode tiene su propio interruptor en /effort (v2.1.284). Los comandos de shell en segundo plano se detienen al alcanzar su tiempo límite, 30 minutos de forma predeterminada (v2.1.285). Nuevas filas: --desktop, allowedProviders, claude plugin configure, plugin install --config, CLAUDE_CODE_DISABLE_WEB_FETCH, CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES; /mcp reconnect all, los atajos de teclado del deslizador y la ventana de 1M con URL base personalizada se agregan a filas existentes.
2026-09-26 Sincronización dirigida de v2.1.282-283 (24 y 25 de septiembre; npm latest y next en 2.1.283, stable pasa a 2.1.274; nada omitido desde 2.1.281). El modo auto es ahora el modo de inicio integrado para las sesiones interactivas de terminal y de VS Code en todos los planes y proveedores (v2.1.283), y usa el clasificador del lado del servidor de forma predeterminada en una conexión directa a la API con la telemetría desactivada (v2.1.282). Las variables de OTel en la configuración de proyecto y local se ignoran (v2.1.282). Nuevas filas: maxProseWidth, deniedModels, availableModelsMatch, allowClaudeInChromeWithManagedMcp, /doctor prompt-audit y las variables de OTel ignoradas; la fila de encabezados de sugerencia agrega x-claude-code-prompt-id y el valor predeterminado para la API directa.
2026-09-24 Sincronización puntual de la v2.1.281 (23 de septiembre; npm latest y next en 2.1.281, stable pasa a 2.1.273; ninguna versión omitida desde la 2.1.280). Enviar ahora (Ctrl+Enter) pasa las herramientas en ejecución a segundo plano en lugar de cancelar el turno. CLAUDE_CODE_AUTO_MODE_SERVER ahora también aplica en una conexión directa a la Anthropic API. Modo automático: los comandos de shell de solo lectura y en sandbox revisados por el servidor esperan esa revisión; el aviso del rm peligroso se deniega tras 2 minutos en los modos desatendidos. Filas nuevas: attribution (false oculta toda la atribución), las comprobaciones MCP de claude plugin validate y dos variables de entorno para rm. Corrección: la fila de /agents ahora indica que el asistente se eliminó en la v2.1.198.
2026-09-23 Correcciones, sin nueva versión de la CLI (npm latest sigue en 2.1.280). El modo rápido ahora muestra Opus 5.5 a $8/$40 por MTok, el predeterminado del modo rápido desde la v2.1.280 (Opus 5 y 4.8 se mantienen en $10/$50), en la fila de /fast y en la nota de la Referencia de costos. El costo de una sesión con Opus se recalculó con los $4/$20 de Opus 5.5: $0,40-$1,80. La fila de /effort enumera la escalera completa y el valor predeterminado medium de Opus 5.5; el pensamiento no se puede desactivar en Opus 5.5.
2026-09-22 Sincronización puntual de la v2.1.280 (22 de septiembre; npm latest 2.1.280, stable se mantiene en 2.1.267; la 2.1.279 nunca se publicó – sin versión en npm ni sección en el changelog). Claude Opus 5.5 (claude-opus-5-5) es el nuevo modelo Opus predeterminado – contexto de 1M, $4/$20 por MTok, lecturas de caché a $0,20/MTok – y el modelo predeterminado en Pro y Team Standard pasa de Sonnet a Opus, igual que en Max, Team Premium y Enterprise: nueva fila de Opus 5.5 en la Referencia de costos, filas de Opus 5 y Sonnet 5 reclasificadas como historial, nota del modelo predeterminado y comentario de /model actualizados. CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH – nueva fila de variable de entorno: anula el límite de 2.048 caracteres en las descripciones de herramientas MCP y en las instrucciones de servidor. También en la v2.1.280, sin afectar ninguna superficie de la cheatsheet: un nivel de esfuerzo guardado antes de que /effort pasara a ser por modelo ya no se aplica a los modelos recién lanzados como Opus 5.5 (arrancan en su valor predeterminado); las escrituras a través de rutas con symlinks ahora se juzgan por dónde aterriza la escritura, de modo que acceptEdits/las reglas allow/el modo automático ya no aprueban un destino fuera del árbol; el modo automático deniega una vez cuando una comprobación de seguridad se niega a revisar, y reduce el ritmo y luego detiene el turno tras diez comprobaciones sin respuesta.
2026-09-21 Sincronización puntual de las v2.1.277-278 (18-19 de septiembre; npm latest 2.1.278, stable se mantiene en 2.1.267). Compatibilidad con AGENTS.md (v2.1.277) – nueva nota en la sección de CLAUDE.md y una fila en Ubicaciones de archivos clave: en un proyecto sin CLAUDE.md, Claude Code lee AGENTS.md en su lugar, configurable en “Project instructions” dentro de /config, todavía no disponible en Bedrock/Vertex/Foundry. La semántica de CLAUDE_CODE_AUTO_MODE_SERVER se invirtió (v2.1.278) – fila actualizada: el clasificador del lado del servidor es ahora el PREDETERMINADO para los usuarios de Claude API y Enterprise y en Bedrock/Vertex/Foundry y gateways, sin cobrar la sobrecarga del clasificador, y =0 es la forma de desactivarlo ahí (la fila de la v2.1.273 documentaba =1 como la opción para activarlo cuando el predeterminado era el local); /status gana una fila “Auto mode server”. Ninguna otra superficie de la cheatsheet se ve afectada (la corrección del glob en comandos compuestos del sandbox de la v2.1.277, el comportamiento del código de salida en modo headless y la variable de entorno de salida por gateway viven en la guía completa).
2026-09-17 Sincronización puntual de las v2.1.274-276 (17 de septiembre; npm latest 2.1.276, stable se mantiene en 2.1.267; la 2.1.276 corrige una regresión de la 2.1.275 – todas las solicitudes devuelven 400 cuando ANTHROPIC_BASE_URL apunta a un proxy o gateway, así que nunca fijes la 2.1.275 detrás de uno). Tecla de enviar ahora (v2.1.275) – fila nueva: ctrl+enter (o ctrl+x ctrl+s) interrumpe el turno y envía todos los mensajes en cola. syncClaudeAiSkills / syncClaudeAiPlugins (v2.1.275) – nueva fila de configuración: las skills y plugins de la cuenta de claude.ai se sincronizan con las sesiones de terminal con sesión iniciada; false lo desactiva. /plugin install <plugin> --marketplace <source> (v2.1.275) – nueva fila de plugins: ofrece agregar primero el marketplace. Ninguna otra superficie de la cheatsheet se ve afectada (el cambio de nombre a “cloud session” de la v2.1.274 no toca ninguna fila de la cheatsheet, y las nuevas variables de entorno MCP viven en la tabla de variables de entorno de la guía completa).
2026-09-16 Sincronización puntual de la v2.1.273 (15 de septiembre; npm latest, lo que resuelve la vigilancia de la etiqueta next de más abajo; la dist-tag stable pasó a 2.1.267). Dos filas de variables de entorno agregadas: CLAUDE_CODE_AUTO_MODE_SERVER (el modo automático por gateway ahora usa por defecto el clasificador LOCAL en Bedrock/Vertex/Foundry) y CLAUDE_CODE_GATEWAY_HINT_HEADERS. Nota para quienes usan reglas de permisos: la v2.1.273 revierte de forma acotada la comprobación de denegación de líneas no analizables de la v2.1.268 (las líneas con eval y env -C vuelven a pedir confirmación en lugar de denegarse); las correcciones de estado y symlinks de la v2.1.260 se mantienen. Ninguna otra superficie de la cheatsheet se ve afectada.
2026-09-15 Sincronización puntual de las v2.1.266-272 (8-14 de septiembre; npm latest 2.1.272, la 2.1.273 solo en la etiqueta next y todavía sin notas de versión; la 266 y la 270 son correcciones de regresión de una línea y la 272 no tiene contenido). /output-style resucita (v2.1.269) – fila nueva: lista y cambia los estilos de salida, estuvo obsoleto de la v2.1.73 a la v2.1.268 en favor de /config, y ahora funciona por Remote Control y en sesiones en la nube o headless. El modo rápido llega a las sesiones remotas (v2.1.271) – fila de /fast y nota del modo rápido actualizadas: runners en la nube y autoalojados, configuración del host o /fast dentro de la sesión, donde la organización lo permita. claude plugin eval (v2.1.269) – nueva fila de Plugin CLI: suites de evaluación puntuadas y reproducibles con informes JSON + HTML. Ninguna otra superficie de la cheatsheet se ve afectada (verificado: las filas de /diff, /skill-doctor, --plugin-dir y los chords no cambian con estas versiones).
2026-09-08 Sincronización puntual de la v2.1.265 (8 de septiembre; las 2.1.262/2.1.264 nunca se publicaron, la 2.1.263 no tiene contenido). Filas de --plugin-dir: modo carpeta de plugins – se carga cada subcarpeta que tenga un manifiesto, y las subcarpetas agregadas o eliminadas durante la ejecución se detectan (v2.1.265+). Fila de Ctrl+X Ctrl+K: los chords de dos teclas ahora esperan 3 segundos la segunda tecla y muestran un aviso al agotarse el tiempo (antes era 1 segundo con cancelación silenciosa, lo que se comía los chords tecleados bajo tmux). Ninguna otra superficie de la cheatsheet se ve afectada.
2026-09-05 Sincronización puntual de la v2.1.261 (4 de septiembre). Se agregó la fila de /skill-doctor: muestra qué skills cargadas no se usan y cuánto contexto cuesta cada una, para que puedas podarlas. También de la v2.1.261, sin afectar ninguna superficie de la cheatsheet: la configuración keybindingFlavor se retira (la edición por palabras de readline es ahora el único dialecto del prompt) – la cheatsheet nunca la documentó.
2026-09-03 Sincronización puntual de la v2.1.260 (llegó horas después de la sincronización de las v2.1.257-259 del mismo día, más abajo). Se agregó la fila de /diff: panel de diff a pantalla completa junto a la conversación que muestra en vivo los cambios sin confirmar mientras Claude edita. Nota para quienes usan reglas de permisos: la v2.1.260 revierte la extensión de la v2.1.259 de las reglas de denegación Read() a los valores de opciones y operandos de Bash (denegaba npm run build bajo una regla de denegación del directorio de build en todos los modos); la cobertura de redirecciones de entrada y comandos lectores de la v2.1.257 se mantiene.
2026-09-03 Sincronización puntual de las v2.1.257-259 + el lanzamiento de Claude Fable 5.1 (1 de septiembre de 2026). El alias fable ahora selecciona Fable 5.1 (claude-fable-5-1) – mismos $10/$50 por MTok, fecha de corte de conocimiento junio de 2026 (la más reciente de todos los modelos actuales), lecturas de caché a $0,25/MTok (0,025x, frente al 0,1x estándar); Fable 5 pasa a la tabla de modelos heredados (Legacy models) de la documentación. La v2.1.257 es la primera versión instalable con Fable 5.1 (las 2.1.253-256 nunca se publicaron en npm). Fila de la Referencia de costos, nota de razonamiento adaptativo y comentario de /model actualizados.
2026-08-30 Corrección del modelo predeterminado a partir de la documentación de configuración de modelos + la CLI v2.1.251: Opus 5 es el predeterminado en los planes premium (Max, Team Premium, Enterprise con pago por uso, la Anthropic API, Bedrock / Agent Platform de Google Cloud / Claude Platform en AWS; Enterprise por asientos se suma en la v2.1.251) y Sonnet 5 en Pro/Team Standard (Foundry: Sonnet 4.5). Filas de Sonnet 5, Opus 5 y Opus 4.8, nota del modelo predeterminado y comentario de /model actualizados; el planteamiento “Sonnet 5 en todas partes” de la v2.1.197 queda retirado.
2026-08-26 Corrección de precios: los $2/$10 por MTok de Sonnet 5 son ahora el precio de lista estándar – la página de precios de Anthropic cancela el aumento a $3/$15 previsto para el 1 de septiembre, y la v2.1.243 actualizó el selector de /model y la skill claude-api en consecuencia. Fila de la Referencia de costos y nota del modelo predeterminado actualizadas; ningún otro contenido cambió.5
2026-08-17 Sincronización puntual de la v2.1.234. Las sesiones continúan automáticamente cuando se restablece un límite de uso de claude.ai (/config: “Continue automatically at usage limit”). Variables de entorno: CLAUDE_CODE_PROJECT_DIR_NAME, CLAUDE_CODE_GOAL_CHECKIN_MINUTES. /permissions y /add-dir ahora se abren a mitad de turno. Insignia del MR de GitLab (!N) en el pie de página mediante glab autenticado.
2026-08-15 Sincronización puntual de la v2.1.233. Variables de entorno: CLAUDE_CODE_TOOL_MEMORY_LIMIT (cgroup de Bash en Linux), CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS, CLAUDE_CODE_ENABLE_TODO_TOOLS (las herramientas de todo/task ahora están DESACTIVADAS por defecto en Opus 4.8/Sonnet 5/Fable 5+). Los MR de GitLab funcionan con --worktree (!N en claude agents). Se revirtieron los cambios de permisos de la v2.1.232 para symlinks de Cygwin y < file; se corrigió su regresión de aprobación del modo automático en Windows.
2026-08-14 Sincronización puntual de v2.1.231–232 + el cambio de valor predeterminado del 14 de agosto. El modo automático ahora es el predeterminado para sesiones nuevas en Pro/Max/Team (anotado en el bloque de Modo automático). v2.1.232: menciones con @ a sesiones en vivo (se enrutan mediante SendMessage; la coincidencia exacta del nombre simple entrega el mensaje), bifurcación de subagentes activada de forma predeterminada, filas de /config para la caducidad de diálogos + entrada entre sesiones, marketplaces de GitLab + redacción de tokens, alias de configuración additionalMarketplaces/allowedMarketplaces. v2.1.231: corrección del redirect-URI de MCP OAuth.
2026-08-12 Sincronización puntual de v2.1.228–229. Variables de entorno: se agregó CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS (escalonamiento del fan-out de workflows; 0 lo desactiva). Además: claude remote-control --continue reanuda la sesión más reciente de Remote Control; /commit-push-pr ya no aprueba automáticamente flags peligrosos de git; la herramienta Write sigue las mismas reglas de sobrescritura que Edit en los modelos más recientes.
2026-08-10 Reparación de un defecto arrastrado, detectado en la auditoría holística de la guía principal: la fila del clasificador del modo automático aún decía Sonnet 4.6; se corrigió a Sonnet 5 desde v2.1.210 (originalmente Sonnet 4.6).
2026-08-06 Sincronización puntual de los elementos de la superficie de comandos de v2.1.221–v2.1.223. /review vuelve a ser un alias de /code-review (v2.1.223) y recuerda el último nivel de esfuerzo escrito; las copias de /fork obtienen su propio worktree (v2.1.221); VSCode agrega la vista Focus (Ctrl+Alt+F, v2.1.221); CLAUDE_CODE_DISABLE_1M_CONTEXT ahora limita a 200K todos los modelos con 1M nativo mediante compactación automática, con CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT como vía de escape para modelos desconocidos (v2.1.223); strictKnownMarketplaces/blockedMarketplaces aceptan comodines de organización "owner/*" (v2.1.223).
2026-07-25 Sincronización puntual de los elementos de v2.1.219–v2.1.220. Modelos: Claude Opus 5 (claude-opus-5) reemplaza a Opus 4.8 como el nivel Opus y como lo que selecciona /model opus: mismo precio de $5/$25 por MTok, contexto de 1M / salida de 128K, razonamiento activado de forma predeterminada, effort con valor predeterminado high, fecha de corte de conocimiento en mayo de 2026, modelo predeterminado en Claude Max; Opus 4.8 se conserva como fila heredada. Cambios incompatibles respecto a 4.8: las solicitudes sin campo thinking ahora razonan, y thinking: {type: "disabled"} + esfuerzo xhigh/max devuelve un 400. Modo rápido corregido: /fast cubre solo Opus 5 y Opus 4.8 a $10/$50 por MTok (2× el precio base, ~2,5× la velocidad de salida); Opus 4.7 fue retirado y ahora devuelve error con speed: "fast" en lugar de recurrir al modo normal. Variables de entorno: CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH corregida: la generación anidada de subagentes está activada de forma predeterminada con profundidad 3 desde v2.1.219 (estaba desactivada en v2.1.217); establece 1 para desactivarla. Claves de configuración: se agregaron sandbox.network.strictAllowlist (rechaza hosts fuera de la lista de permitidos sin preguntar) y workflowSizeGuideline (tamaño orientativo de Dynamic workflow, predeterminado medium / menos de 15 agentes). Eventos de hook: se agregó DirectoryAdded (se dispara después de que /add-dir o el register_repo_root de SDK registra un directorio de trabajo a mitad de sesión). v2.1.220 solo contiene correcciones de errores y mejoras de fiabilidad.
2026-07-24 Sincronización puntual de los elementos de v2.1.218. Superficie de comandos: /code-review ahora se ejecuta como un subagente en segundo plano, de modo que el trabajo de revisión ya no llena tu conversación. También en v2.1.218: los skills con context: fork se ejecutan en segundo plano de forma predeterminada (exclusión por skill mediante la nueva clave de frontmatter background: false), /deep-research solo se inicia cuando se invoca manualmente, el clasificador del modo automático resuelve las comprobaciones de rm peligroso / & en segundo plano / rutas de Windows sospechosas en lugar de abrir diálogos de permisos, y los hooks del frontmatter de agentes requieren que la carpeta del archivo del agente haya aceptado la confianza del espacio de trabajo.
2026-07-22 Sincronización puntual de los elementos de v2.1.217. Variables de entorno: se agregaron CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS (límite de subagentes en ejecución simultánea, predeterminado 20) y CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH (la generación anidada de subagentes está desactivada de forma predeterminada desde v2.1.217; configúrala para volver a activarla; v2.1.172–v2.1.216 permitían 5 niveles). Claves de configuración: se agregó emojiCompletionEnabled (autocompletado de códigos cortos de emoji en la entrada del prompt, :heart: → ❤️; false lo desactiva). También en v2.1.217: --max-budget-usd ahora detiene los subagentes en segundo plano una vez alcanzado el límite.
2026-07-21 Sincronización puntual de los elementos de v2.1.214–v2.1.216 (v2.1.213 nunca se publicó). Sintaxis de reglas de permisos: las reglas de permiso dir/** de un solo segmento ahora coinciden únicamente con <cwd>/dir (v2.1.214); usa **/dir/** para cualquier profundidad; las reglas deny/ask conservan la coincidencia a cualquier profundidad; las condiciones if: de los hooks reciben el mismo alcance de cwd. Claves de configuración: se agregó sandbox.filesystem.disabled (omite el aislamiento del sistema de archivos y conserva el control de salida de red, v2.1.216+). Variables de entorno: se agregó CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH (límite de truncamiento de contenido de OTel, predeterminado 60 KB, v2.1.214+).
2026-07-17 Sincronizado hasta Claude Code v2.1.212. Superficie de comandos: /fork cambia de propósito: copia la conversación en una nueva sesión en segundo plano con su propia fila en claude agents; la bifurcación dentro de la sesión ahora es /subtask; nuevo subcomando claude auto-mode reset (--yes omite la confirmación); nuevos flags --forward-subagent-text (v2.1.211) y --ax-screen-reader (v2.1.208). Variables de entorno agregadas: CLAUDE_CODE_FORWARD_SUBAGENT_TEXT, CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION / CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION (valores predeterminados de 200 por sesión, v2.1.212), CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS (las llamadas a MCP de más de 2 min pasan automáticamente a segundo plano), CLAUDE_AX_SCREEN_READER.7
2026-07-07 Sincronizado hasta Claude Code v2.1.202. Modo de permisos default → “Manual” (v2.1.200; manual se acepta como alias). Tabla de modelos reconstruida con la alineación actual (Sonnet 5, el predeterminado de Claude Code desde v2.1.197; Opus 4.8; Fable 5; Haiku 4.5), en reemplazo de las filas obsoletas de Opus 4.7 como buque insignia / Sonnet 4.6; se actualizaron las notas de enrutamiento predeterminado y de /effort. El subagente Explore ahora hereda el modelo de la sesión (con tope en Opus, v2.1.198); antes era Haiku. Entradas obsoletas eliminadas: --enable-auto-mode (eliminado en v2.1.111 → usa --permission-mode auto) y CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE (sin efecto desde v2.1.160).
2026-05-24 Evidencia de la línea más reciente sincronizada hasta Claude Code v2.1.150. Se agregaron el uso de límites por categoría en /usage, la nota sobre desplazamiento con teclado en /diff vía changelog, la nota sobre el renderizado de casillas de listas de tareas GFM vía changelog, allowAllClaudeAiMcps para Enterprise, orientación sobre la corrección de permisos en PowerShell y notas de fiabilidad de Bash/git-worktree/configuración administrada/OTEL/Remote Control. v2.1.150 en sí no tiene cambios anunciados visibles para el usuario. Verificación local: claude --version local devolvió 2.1.144 (Claude Code) mientras que la última versión en npm era 2.1.150.6
2026-05-21 Evidencia de la línea más reciente sincronizada hasta Claude Code v2.1.147. Se agregaron la herramienta Workflow, desactivada de forma predeterminada (CLAUDE_CODE_WORKFLOWS=1), las sesiones en segundo plano fijadas en Agent View, /code-review [effort] --comment en reemplazo de /simplify, sandboxes de REPL/Workflow reforzados, mejoras del actualizador automático y de diffs grandes, supresión de prompts duplicados en el historial, y correcciones de inicio de sesión empresarial, PowerShell, paginación de MCP, Agent View, plugins, condiciones de hooks y texto pegado. Verificación local: claude --version local devolvió 2.1.144 (Claude Code) mientras que la última versión en npm era 2.1.147.6
2026-05-19 Evidencia de la línea más reciente sincronizada hasta Claude Code v2.1.145. Se agregaron claude agents --json, los recuentos de pestañas en espera de entrada en Agent View, los campos de JSON de repositorio/PR de GitHub en la línea de estado, un descubrimiento de plugins más completo antes de la instalación, la entrada de hooks background_tasks y session_crons en Stop/SubagentStop, agent_id/parent_agent_id en OTEL, y correcciones de permisos, MCP, spinner, Windows, Agent View, lista de tareas, validación de plugins, recursión de skills y la herramienta Read. Verificación local: claude --version local devolvió 2.1.144 (Claude Code) mientras que la última versión en npm era 2.1.145.6
2026-05-19 Evidencia de la línea más reciente sincronizada hasta Claude Code v2.1.144. Se agregaron compatibilidad de /resume con sesiones en segundo plano, el comportamiento de /model para sesión actual/predeterminado, /usage-credits, la visualización de la última actualización de plugins, notificaciones de duración de subagentes en segundo plano y correcciones de fiabilidad de terminal/sesiones en segundo plano. Verificación local: claude --version devolvió 2.1.144 (Claude Code) y la última versión en npm era 2.1.144.6
2026-05-18 Evidencia de la línea más reciente sincronizada hasta Claude Code v2.1.143. Se agregaron la consistencia de despacho en Agent View, el tope de bloqueos del hook Stop y las variables de entorno de política de PowerShell, y se anotaron la aplicación de dependencias de plugins, el costo de contexto proyectado de los plugins, worktree.bgIsolation: "none", la conservación de modelo/esfuerzo en sesiones en segundo plano y las correcciones de sincronización del evaluador de /goal. Verificación local: claude --version devolvió 2.1.142 (Claude Code) mientras que la última versión en npm era 2.1.143.6
2026-05-15 Evidencia de la línea más reciente sincronizada hasta Claude Code v2.1.142. Se agregaron terminalSequence, claude agents --cwd, los flags de despacho de sesiones en segundo plano de v2.1.142, la anulación predeterminada de Opus 4.7 en modo rápido, la variable de entorno de clonación de plugins de HTTPS, la variable de entorno de espacio de trabajo para identidad de carga de trabajo y la nota de corrección de MCP_TOOL_TIMEOUT para HTTP/SSE remotos. Verificación local: claude --version devolvió 2.1.141 (Claude Code) mientras que la última versión en npm era 2.1.142.6
2026-05-13 Se sincronizó la evidencia de la línea más reciente hasta Claude Code v2.1.140. Se agregaron /goal, la nota sobre Agent View, args en los hooks de comando, continueOnBlock en PostToolUse y subagent_type en la entrada de los hooks de agente. Se indicó que v2.1.140 corrige el comportamiento de ConfigChange, disableAllHooks y allowManagedHooksOnly. Verificación local: claude --version devolvió 2.1.140 (Claude Code).6
2026-05-06 Se sincronizó la evidencia de la línea más reciente hasta Claude Code v2.1.131. No hizo falta cambiar las tablas de comandos, configuración, atajos, hooks, plugins ni variables de entorno, porque v2.1.131 es una versión de corrección para la activación de VS Code en Windows y la autenticación del endpoint de Mantle.6
2026-05-05 Se sincronizó con la guía de CC v2.36 (CLI v2.1.126–v2.1.129). Se agregaron: --plugin-url para cargar plugins en formato zip, compatibilidad con .zip en --plugin-dir, skillOverrides, CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY, CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE, CLAUDE_CODE_FORCE_SYNC_OUTPUT y las indicaciones de v2.1.129 sobre el manifiesto de plugins para themes/monitors experimentales. Cobertura hasta v2.1.129.6
2026-04-29 Se sincronizó con la guía de CC v2.35 (CLI v2.1.117–v2.1.123). Se agregaron: la opción alwaysLoad de MCP + reintento automático al iniciar; claude plugin prune y la cascada de --prune; claude plugin tag; filtrado al escribir en /skills; temas con nombre en /theme; diálogo unificado de /usage; modos visuales de vim (v/V); aprobación automática de PowerShell; duration_ms en la entrada de los hooks + updatedToolOutput para todas las herramientas; prUrlTemplate, wslInheritsWindowsSettings, autoMode.allow $defaults; las variables de entorno ANTHROPIC_BEDROCK_SERVICE_TIER, ENABLE_TOOL_SEARCH, CLAUDE_CODE_HIDE_CWD, DISABLE_UPDATES, CLAUDE_CODE_FORK_SUBAGENT; --from-pr acepta URLs de PR de GitLab/Bitbucket/GHE. Cobertura hasta v2.1.123.
2026-04-19 Actualización: el contexto de 1M de Sonnet 4.6 ahora se muestra a la tarifa estándar de $3/$15 (sin recargo por contexto largo); la nota al pie de precios ahora apunta a platform.claude.com/docs/en/about-claude/pricing. Cobertura hasta v2.1.116.
2026-04-04 Se volvió a derivar de la guía de CC v2.26. Se agregó /powerup, se actualizó /release-notes y se eliminó /vim. Se actualizó el atajo Ctrl+X Ctrl+K. Se agregaron 4 eventos de hook (CwdChanged, FileChanged, TaskCreated, PermissionDenied). Se actualizó /cost con el desglose por modelo. Cobertura hasta v2.1.92.
2026-03-28 Publicación inicial de la hoja de referencia, que cubre Claude Code CLI hasta v2.1.85

17. Referencias


Esta hoja de referencia rápida es la compañera de consulta de la guía completa de la CLI de Claude Code. Para tutoriales de configuración, consulta el 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 Apple Ecosystem. Última actualización: 6 de octubre de 2026.


  1. Documentación del modo automático de Anthropic Claude Code (v2.1.85) ↩

  2. Documentación de hooks de Anthropic Claude Code ↩

  3. Ecosistema y registro de servidores de MCP ↩

  4. Documentación de subagents de Claude Code, “Límite de subagents concurrentes”: 20 subagents en ejecución de forma predeterminada, se cambia con CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS. Consultado el 6 de octubre de 2026. ↩

  5. Precios de la API de Claude ↩↩

  6. Notas de la versión v2.1.129 de Claude Code, notas de la versión v2.1.131 de Claude Code, notas de la versión v2.1.139 de Claude Code, notas de la versión v2.1.140 de Claude Code, notas de la versión v2.1.141 de Claude Code, notas de la versión v2.1.142 de Claude Code, notas de la versión v2.1.143 de Claude Code, notas de la versión v2.1.144 de Claude Code, notas de la versión v2.1.145 de Claude Code, notas de la versión v2.1.147 de Claude Code, notas de la versión v2.1.148 de Claude Code, notas de la versión v2.1.149 de Claude Code, notas de la versión v2.1.150 de Claude Code, documentación de Agent View de Claude Code, documentación de Goal de Claude Code y CHANGELOG de Claude Code ↩↩↩↩↩↩↩↩↩↩

  7. Notas de la versión v2.1.206 de Claude Code, v2.1.207, v2.1.208, v2.1.210, v2.1.211, v2.1.212 y la documentación de accesibilidad de Claude Code. Julio de 2026. ↩↩

  8. Notas de la versión v2.1.287 de Claude Code y la descripción general de Mods, octubre de 2026. ↩

  9. CHANGELOG de Claude Code, de v2.1.288 a v2.1.292, la referencia de la CLI y la referencia de variables de entorno, octubre de 2026. ↩

  10. CHANGELOG de Claude Code, de v2.1.293 a v2.1.296, la descripción general del modelo Claude Haiku 5.5, la página de precios, la referencia de hooks, la referencia de subagents y la referencia de variables de entorno, octubre de 2026. ↩↩

  11. CHANGELOG de Claude Code, v2.1.299, la referencia de configuración (idleCompaction, “Requiere Claude Code v2.1.290 o posterior”) y la página de variables de entorno (CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS, CLAUDE_CODE_DISABLE_FILE_MENTIONS, CLAUDE_CODE_ATTRIBUTION_HEADER, CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS), consultados el 14 de octubre de 2026; dist-tags de npm leídos el mismo día: latest 2.1.299 (publicada el 14 de octubre, 00:23 UTC), next 2.1.300 (14:27 UTC), stable 2.1.287. CLAUDE_CODE_STRICT_INLINE_SHELL_RM_PROMPT, --disallow-tools y el cambio de la regla de nombre completo de MCP solo aparecen en las notas de la versión a esa fecha. ↩

  12. CHANGELOG de Claude Code, v2.1.300, la página de la herramienta advisor, la referencia de la CLI (--advisor <model>), la referencia de configuración (advisorModel) y la página de variables de entorno (CLAUDE_CODE_DISABLE_ADVISOR_TOOL, CLAUDE_CODE_GZIP_REQUEST_BODIES), consultados el 14 de octubre de 2026; dist-tags de npm leídos esa misma tarde: latest y next 2.1.300 (publicada a las 14:27 UTC), stable 2.1.292. ↩

  13. CHANGELOG de Claude Code, v2.1.301 y v2.1.302 y la página del modo interactivo (el movimiento %, “Requiere Claude Code v2.1.301 o posterior”), consultados el 17 de octubre de 2026; dist-tags de npm leídos el mismo día: latest y next 2.1.302 (publicada el 16 de octubre, 16:48 UTC; 2.1.301 el 15 de octubre, 14:34 UTC), stable 2.1.292. Las páginas de modos de permisos, variables de entorno y subagents todavía describen las reglas de -p y del modo fork anteriores a 2.1.302, y CLAUDE_CODE_AUTO_MODE_MODEL, CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS y la fila de /config solo aparecen en las notas de la versión a esa fecha. ↩↩↩↩

  14. CHANGELOG de Claude Code, de v2.1.303 a v2.1.310, la página de variables de entorno (CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS, CLAUDE_CODE_DISABLE_ULTRAREVIEW_TRUST_CHECK, CLAUDE_CODE_AUTO_COMPACT_WINDOW “Los valores con sufijo como 200k requieren v2.1.304 o posterior”), la referencia de configuración (sandbox.allowNestedUserNamespaces, de usuario o administrada), la página de configuración del modo automático (/auto-mode-setup), la página de costos (“El atajo f requiere Claude Code v2.1.305 o posterior”) y la página de ultrareview (--trust-workspace), consultados el 23 de octubre de 2026; dist-tags de npm leídos el mismo día: latest y next 2.1.310 (publicada el 23 de octubre, 21:20 UTC), stable 2.1.308. El valor predeterminado de tool-search detrás de una base URL personalizada y la advertencia de reanudación en Pro/Max solo aparecen en las notas de la versión a esa fecha. ↩↩

  15. Usa Claude Code en la nube (“La forma anterior --remote sigue funcionando como alias obsoleto de --cloud”), Automatiza el trabajo con tareas programadas (“Crea tareas programadas, antes rutinas”; “el alias /routines de /schedule”), Comparte la salida de la sesión como artifacts (“Las plantillas están en beta. Están activadas de forma predeterminada en los planes Pro, Max y Team”; la tabla Disable artifacts), la página de variables de entorno (CLAUDE_CODE_ARTIFACT_AUTO_OPEN, CLAUDE_CODE_DISABLE_WORKFLOWS, CLAUDE_CODE_MAX_TURNS; CLAUDE_CODE_WORKFLOWS ya no aparece en la lista), la referencia de configuración (enableWorkflows: “los workflows están activados salvo que estés en el plan Pro, donde están desactivados”) y Deja que Claude coordine el trabajo en curso con Projects, toda la documentación de Claude Code consultada el 26 de octubre de 2026; claude --help en 2.1.310 muestra --cloud [description|session_id|url]. ↩

  16. CHANGELOG de Claude Code, de v2.1.311 a v2.1.317 y las versiones de GitHub de v2.1.311 (26 de octubre de 2026) a v2.1.317 (2 de noviembre de 2026; npm 23:57 UTC); Acelera las respuestas con el modo rápido (“El modo rápido para Opus 4.8 quedó obsoleto el 30 de octubre de 2026 y se eliminará el 30 de noviembre de 2026”); Configuración de modelos (“Escrita en el prompt de la terminal, la palabra también puede elevar ese turno al esfuerzo xhigh”; “Requiere Claude Code v2.1.311 o posterior”); Todas las configuraciones (permissions.blockWritesOutsideWorkingDirectories, idleCompaction, disableRemoteControl); Variables de entorno (CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT, CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK, CLAUDE_CODE_SYNC_SKILLS, CLAUDE_CODE_TRANSCRIPT_LOCAL_GC, CLAUDE_CODE_SKIP_PROMPT_HISTORY, CLAUDE_CODE_DISABLE_CFC_PROMPT, FORCE_HYPERLINK); Referencia de entornos autoalojados (--hold-idle-file, --max-hold-min). Todo consultado el 2 de noviembre de 2026. ↩