Guía de Claude Code CLI: instalación, configuración, comandos y variables de entorno

TL;DR: Claude Code es una CLI agéntica que lee tu base de código, ejecuta comandos y edita archivos, regida por cinco sistemas: configuración, permisos, hooks, MCP y subagents. Usa hooks, no prompts, para cualquier acción que deba ejecutarse siempre.

Estado actual (CLI v2.1.292, 6 de octubre de 2026; las versiones latest y next de npm son la 2.1.292, mientras que stable es la 2.1.285):²³⁴

• Modelo predeterminado: Claude Opus 5.5 (claude-opus-5-5) en Pro, Max, Team, Enterprise y Anthropic API, así como en Claude Platform en AWS, Amazon Bedrock y Agent Platform de Google Cloud. Microsoft Foundry es la excepción: utiliza Sonnet 4.5 de forma predeterminada y su alias opus corresponde a Opus 4.6.²²¹
• Opus 5.5 de un vistazo: $4/$20 por millón de tokens, con lecturas de caché a $0,20; contexto de 1M de forma predeterminada en Anthropic API y, desde la versión 2.1.287, en Bedrock, Agent Platform y Foundry; esfuerzo medium predeterminado; y un proceso de razonamiento que no puede desactivarse. El modo rápido lo ejecuta a $8/$40. Sonnet 5.5 ($2/$10; sonnet en Anthropic API desde la versión 2.1.284) es la opción más económica cuando una tarea no requiere Opus.^{220222223228232}
• El modo Auto es el modo de permisos inicial para las sesiones interactivas de terminal y VS Code en todos los planes y proveedores (v2.1.283-284), mientras que las sesiones de claude -p y Agent SDK comienzan en Manual, salvo que se especifique --permission-mode auto (la versión 2.1.302 revirtió el inicio automático que la versión 2.1.285 había introducido para proveedores externos y cuando la telemetría estaba desactivada).²⁷⁵ Sus comprobaciones de seguridad se ejecutan en el servidor sin costo para las cuentas Enterprise y Claude API, en Claude Platform en AWS, Bedrock, Agent Platform y Foundry, y mediante gateways; si esto no es posible, se recurre a comprobaciones locales facturadas.^{219227228229230}
• AGENTS.md: desde la versión 2.1.277, AGENTS.md se lee como instrucciones del proyecto cuando este no tiene un archivo CLAUDE.md, excepto cuando no se obtienen los feature flags —como ocurre con Bedrock— y durante la primera sesión posterior a una instalación o actualización.²¹⁹²²³

El historial de cada versión está disponible en el registro de cambios.

Claude Code funciona como un sistema agéntico, no como una interfaz de chat con conocimientos de programación. La CLI lee tu base de código, ejecuta comandos, modifica archivos, administra flujos de trabajo de git, se conecta con servicios externos mediante MCP y delega tareas complejas a subagents especializados. Todo se lleva a cabo mediante una interfaz de línea de comandos que se integra en la forma de trabajar real de los desarrolladores. En febrero de 2026, el 4 % de los commits públicos de GitHub (unos 135.000 al día) son creados por Claude Code, lo que representa un crecimiento de 42.896 veces en los 13 meses transcurridos desde la versión preliminar de investigación; además, el 90 % del código de Anthropic está escrito por IA.¹⁰³

La diferencia entre un uso ocasional y uno eficaz de Claude Code se reduce a cinco sistemas fundamentales. Domínalos y Claude Code se convertirá en un multiplicador de fuerza:

1. Jerarquía de configuración: controla el comportamiento
2. Sistema de permisos: controla el acceso a las operaciones
3. Sistema de hooks: permite una automatización determinista
4. Protocolo MCP: amplía las capacidades
5. Sistema de subagents: gestiona tareas complejas de varios pasos

Puntos clave

• Cinco sistemas determinan tu eficacia: la jerarquía de configuración, los permisos, los hooks, MCP y los subagents controlan todo, desde el comportamiento hasta la automatización.
• Envía el trabajo a la capa de delegación: los subagents evitan que el contexto se sature al aislar la exploración en ventanas de contexto limpias y devolver únicamente resúmenes.
• Los hooks garantizan la ejecución; los prompts no: usa hooks para las comprobaciones de linting, formato y seguridad que deban ejecutarse siempre, independientemente del comportamiento del modelo.
• La asignación de modelos por niveles reduce costos sin sacrificar calidad: dirige la exploración de los subagents hacia modelos más económicos y reserva Opus para razonamientos arquitectónicos que realmente lo requieran, o estandariza el uso de Opus si la calidad es tu única variable.
• MCP conecta Claude con tu cadena de herramientas: las bases de datos, GitHub, Sentry y más de 3.000 integraciones amplían las capacidades de Claude más allá de la lectura de archivos y los comandos de Bash.

Pasé meses llevando Claude Code al límite en bases de código de producción, pipelines de CI/CD e implementaciones empresariales. Esta guía condensa esa experiencia en la referencia completa que me habría gustado tener cuando empecé. Cada función incluye la sintaxis exacta, ejemplos reales de configuración y los casos límite que sorprenden incluso a usuarios experimentados.

Elige tu ruta

Cómo usar esta guía

Esta es una referencia de más de 5.000 líneas; no necesitas leerla de principio a fin. Empieza por la sección que corresponda a tu nivel de experiencia:

Usa Ctrl+F / Cmd+F en tu navegador para buscar flags, comandos o claves de configuración específicos. La tarjeta de referencia rápida que aparece al final ofrece un resumen fácil de consultar de todos los comandos principales.

Análisis relacionados en profundidad

Estas publicaciones del blog exploran en detalle aspectos específicos de Claude Code:

Inicio rápido en 60 segundos

Si solo quieres ejecutar Claude Code y ver el resultado, sigue estos pasos en orden:

# 1. Install (pick one)
npm install -g @anthropic-ai/claude-code          # npm users
brew install anthropic/claude/claude              # macOS + Homebrew
curl -sL claude.ai/install.sh | sh                # native installer

# 2. Launch in any project directory
cd ~/your-project && claude

# 3. Authenticate (browser opens automatically on first run)
/login

# 4. Ask your first question
> What does this repo do? Read the key files and summarize.

Eso es todo. El contenido que aparece después de esta sección amplía las opciones de instalación, configura permisos y hooks, conecta servidores MCP y aborda la implementación empresarial, pero nada de eso es necesario para comenzar.

Requisitos previos: Node 22+ solo para el método heredado mediante npm (el requisito aumentó desde la versión 18 con v2.1.198; la documentación de instalación vigente indica «Node.js 22 o posterior», verificado el 7 de agosto de 2026); el instalador nativo recomendado no depende de Node. Se admiten macOS, Linux y Windows 10+. El uso está cubierto por una suscripción Pro, Max, Team o Enterprise de Claude, o por una clave de API de Anthropic con pago por token. Consulta ¿Cómo instalo Claude Code? para conocer los detalles específicos de cada plataforma, solucionar problemas y usar el binario nativo (la opción predeterminada desde v2.1.113). La evidencia de la versión más reciente incluida en esta guía se actualiza con cada lanzamiento; consulta la fila más reciente del registro de cambios para ver la fecha de verificación actual.²⁶⁷

Cómo funciona Claude Code: el modelo mental

Antes de profundizar en sus funciones, conviene entender cómo la arquitectura de Claude Code determina todo lo que haces con esta herramienta. El sistema opera en tres capas:

┌─────────────────────────────────────────────────────────┐
│                    CLAUDE CODE LAYERS                    │
├─────────────────────────────────────────────────────────┤
│  EXTENSION LAYER                                         │
│  ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────┐    │
│  │   MCP   │  │  Hooks  │  │ Skills  │  │ Plugins │    │
│  └─────────┘  └─────────┘  └─────────┘  └─────────┘    │
│  External tools, deterministic automation, domain       │
│  expertise, packaged extensions                          │
├─────────────────────────────────────────────────────────┤
│  DELEGATION LAYER                                        │
│  ┌─────────────────────────────────────────────────┐    │
│  │           Subagents (20 concurrent default)      │    │
│  │   Explore | Plan | General-purpose | Custom      │    │
│  └─────────────────────────────────────────────────┘    │
│  Isolated contexts for focused work, returns summaries  │
├─────────────────────────────────────────────────────────┤
│  CORE LAYER                                              │
│  ┌─────────────────────────────────────────────────┐    │
│  │         Main Conversation Context                │    │
│  │   Tools: Read, Edit, Bash, Glob, Grep, etc.     │    │
│  └─────────────────────────────────────────────────┘    │
│  Your primary interaction; limited context; costs money │
└─────────────────────────────────────────────────────────┘

Capa central: Tu conversación principal. Cada mensaje, lectura de archivos y resultado de herramientas consume contexto de una ventana compartida (200.000 tokens de forma estándar⁹¹ y 1 millón de tokens con Opus 4.6 o modelos de contexto ampliado). Cuando el contexto se llena, Claude pierde el hilo de las decisiones anteriores y la calidad disminuye. Esta capa genera costos por token.

Capa de delegación: Los subagents se inician con contextos limpios, realizan tareas específicas y devuelven resúmenes. Los resultados de la exploración no saturan tu conversación principal; solo regresan las conclusiones. Asigna los subagents a niveles de modelos más económicos para las tareas de exploración, o utiliza tu modelo principal en todo momento si la calidad te importa más que el costo.

Capa de extensión: MCP conecta servicios externos (bases de datos, GitHub, Sentry). Los hooks garantizan la ejecución de comandos del shell independientemente del comportamiento del modelo. Las skills codifican conocimientos especializados que Claude aplica automáticamente. Los plugins agrupan todos estos elementos para distribuirlos.

La idea clave: La mayoría de los usuarios trabaja exclusivamente en la capa central y observa cómo aumentan el contexto y los costos. Los usuarios avanzados trasladan la exploración y el trabajo especializado a la capa de delegación, mantienen la capa de extensión configurada para su flujo de trabajo y reservan la capa central para la coordinación y las decisiones finales.

Tabla de contenido

1. ¿Cómo instalo Claude Code?
2. Inicio rápido: tu primera sesión
3. Modos principales de interacción
4. Análisis detallado del sistema de configuración
5. ¿Qué modelo debo elegir?
6. ¿Cuánto cuesta Claude Code?
7. Marcos para la toma de decisiones
8. ¿Cómo funciona el sistema de permisos?
9. ¿Cómo funcionan los hooks?
10. ¿Qué es MCP (Model Context Protocol)?
11. ¿Qué son los subagents?
12. ¿Qué es el modo de pensamiento ampliado?
13. Estilos de salida
14. Comandos con barra diagonal
15. ¿Cómo funcionan las skills?
16. Sistema de plugins
17. ¿Cómo funciona la memoria?
18. Entrada de imágenes y contenido multimodal
19. Modo de voz
20. ¿Cómo funciona la integración con Git?
21. ¿Cómo uso Claude Code en mi IDE?
22. Patrones de uso avanzado
23. Agentes remotos y en segundo plano [VERSIÓN PRELIMINAR DE INVESTIGACIÓN]
24. Claude en Chrome
25. Claude Code en Slack [VERSIÓN PRELIMINAR DE INVESTIGACIÓN]
26. Claude Code en la web [VERSIÓN PRELIMINAR DE INVESTIGACIÓN]
27. Claude en Microsoft 365 (mayo de 2026)
28. Optimización del rendimiento
29. ¿Cómo depuro problemas?
30. Implementación empresarial
31. Referencia de atajos de teclado
32. Prácticas recomendadas
33. Recetas de flujos de trabajo
34. Guía de migración
35. Orientación para públicos específicos
36. Tarjeta de referencia rápida
37. Registro de cambios
38. Referencias

¿Cómo instalo Claude Code?

Requisitos del sistema

Claude Code funciona en macOS 13+, Ubuntu 20.04+/Debian 10+ y Windows 10+ (de forma nativa o mediante WSL). El sistema requiere al menos 4 GB de RAM y una conexión activa a internet.⁹² La compatibilidad con el shell es mejor con Bash, Zsh o Fish.

En Windows, funcionan tanto WSL 1 como WSL 2. Git Bash también funciona si prefieres usar Windows de forma nativa. Alpine Linux y otros sistemas basados en musl requieren paquetes adicionales:

apk add libgcc libstdc++ ripgrep
export USE_BUILTIN_RIPGREP=0

Matriz de compatibilidad de plataformas

Instalación, actualización y desinstalación de un vistazo

Referencia rápida: todos los métodos, comandos y formas de comprobar la versión en una sola pantalla. Las subsecciones siguientes explican los detalles de cada método y la solución de problemas.

Desde la v2.1.113, el CLI canónico ejecuta un binario nativo de Claude Code mediante una dependencia opcional específica de cada plataforma, en lugar del JavaScript incluido; usa el instalador nativo para obtener la distribución probada. La opción de npm sigue funcionando, pero muestra el aviso de obsolescencia que se agregó por primera vez en v2.1.15.

Métodos de instalación

Instalación nativa (recomendada)

El binario nativo ofrece la experiencia más sencilla, sin depender de Node.js:

# macOS and Linux
curl -fsSL https://claude.ai/install.sh | bash

# Homebrew alternative
brew install --cask claude-code

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Para instalar una versión específica:

# Install specific version
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

# Install latest explicitly
curl -fsSL https://claude.ai/install.sh | bash -s latest

# Windows PowerShell - specific version
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58

Una versión que nunca debes fijar detrás de un proxy o gateway: 2.1.275. En esa compilación, todas las solicitudes fallan con 400 ... Input tag 'advisor_20260301' cuando ANTHROPIC_BASE_URL apunta a un proxy o gateway; la versión 2.1.276 corrige la regresión.²¹⁸

Instalación mediante NPM (obsoleta)

Nota: Desde v2.1.15, las instalaciones mediante npm muestran un aviso de obsolescencia. El binario nativo es ahora el método de instalación recomendado. Migra con claude install.

Para entornos heredados en los que npm todavía sea necesario:

npm install -g @anthropic-ai/claude-code

Nunca uses sudo para instalar mediante npm. Crea problemas de permisos que complican todo lo que viene después.

Migración desde una instalación existente

Si tienes una instalación anterior basada en npm, migra al binario nativo:

claude install

Opciones de autenticación

Claude Code admite tres métodos de autenticación, cada uno con ventajas y desventajas diferentes:

Console de Claude (facturación de API)

Conéctate directamente al API de Anthropic mediante platform.claude.com (antes console.anthropic.com). Crea una cuenta, configura la facturación y autentícate mediante el CLI. Console ofrece facturación basada en el uso con acceso completo al API. Se crea automáticamente un espacio de trabajo específico para «Claude Code»; no puedes crear claves de API para este espacio de trabajo, pero sí supervisar el uso. Desde v2.1.243, /login → Console de Anthropic ofrece una opción sin claves, «Sign in with your Console account» (recomendada), además de la opción de crear una clave de API, por lo que las organizaciones que no permiten claves de API pueden iniciar sesión con las credenciales de Console.²⁵⁰

Suscripción Pro o Max de Claude

Usa las credenciales de tu cuenta de claude.ai. La suscripción cubre tanto la interfaz web como el uso del CLI mediante un único plan mensual. La suscripción simplifica la facturación para los usuarios individuales que buscan costos predecibles.

Plataformas empresariales

AWS Bedrock, Google Vertex AI y Microsoft Foundry ofrecen acceso de nivel empresarial mediante las relaciones de facturación existentes con los proveedores de servicios en la nube. Asistente de configuración de Bedrock (v2.1.92+): Un asistente interactivo en la pantalla de inicio de sesión te guía por la autenticación de AWS, la selección de región, la verificación de credenciales y la fijación de modelos.¹³⁷ Asistente de configuración de Vertex AI (v2.1.98+): Un asistente equivalente para Google Cloud que te guía por la autenticación de GCP, la configuración del proyecto y la región, la verificación de credenciales y la fijación de modelos.¹⁴² Workload Identity Federation con mTLS de Vertex AI (v2.1.121+): Vertex AI ahora acepta Workload Identity Federation basada en certificados X.509 (Application Default Credentials con mTLS): tokens de GCP de corta duración generados a partir de un certificado de cliente, sin necesidad de un JSON de cuenta de servicio.¹⁵⁴ Confianza en los certificados de CA del sistema operativo (v2.1.101+): Los proxies TLS empresariales ahora funcionan de forma predeterminada, ya que Claude Code confía en el almacén de certificados del sistema operativo. Configura CLAUDE_CODE_CERT_STORE=bundled para usar únicamente las CA incluidas.¹⁴³

# AWS Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1
export AWS_PROFILE=your-profile

# Google Vertex AI
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5
export ANTHROPIC_VERTEX_PROJECT_ID=your-project

# Microsoft Foundry
export CLAUDE_CODE_USE_FOUNDRY=1
export ANTHROPIC_FOUNDRY_RESOURCE=your-resource-name
# Optional: API key auth (otherwise uses Entra ID)
export ANTHROPIC_FOUNDRY_API_KEY=your-key

# Amazon Bedrock via Mantle (v2.1.94+)
export CLAUDE_CODE_USE_MANTLE=1

Para implementaciones empresariales detrás de proxies o mediante gateways de LLM:

# Corporate proxy
export HTTPS_PROXY='https://proxy.example.com:8080'

# LLM gateway (skip native auth)
export CLAUDE_CODE_USE_BEDROCK=1
export ANTHROPIC_BEDROCK_BASE_URL='https://your-gateway.com/bedrock'
export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1

Encabezados de indicaciones para gateways (v2.1.273): Claude Code puede agregar encabezados de solicitud que un gateway de LLM puede usar para enrutar y observar: x-claude-code-request-class, x-claude-code-agent-type, x-claude-code-prev-tool-durations, x-claude-code-compaction, x-claude-code-context-compacted y, desde v2.1.283, x-claude-code-prompt-id, un UUID aleatorio compartido por todas las solicitudes que atienden una misma instrucción del usuario, incluidos los turnos de los subagents.²¹⁷²²⁶ Cuando se usa una URL base personalizada o un proveedor externo como Bedrock, los encabezados permanecen desactivados hasta que configuras CLAUDE_CODE_GATEWAY_HINT_HEADERS=1. La documentación del protocolo de gateway agrega que una conexión directa al API de Anthropic los envía de forma predeterminada y que CLAUDE_CODE_GATEWAY_HINT_HEADERS=0 los desactiva en todas las conexiones.²²⁷

Verificación

claude doctor

El comando informa el tipo de instalación, la versión, la configuración del sistema y cualquier problema detectado.

Gestión de la autenticación (v2.1.41+)

Gestiona la autenticación sin entrar en el REPL:⁹⁰

claude auth login          # Log in or switch accounts
claude auth status         # Check current auth state (account, plan, expiry)
claude auth logout         # Clear stored credentials

Desde la v2.1.268, claude auth status --json incluye configDirectory, el directorio de configuración que el CLI realmente está leyendo, lo cual resulta útil cuando la indirección de CLAUDE_CONFIG_DIR genera ambigüedad.²¹⁶

Desde la v2.1.273, el inicio de sesión con una cuenta de Claude también solicita acceso a tus plugins de claude.ai.²¹⁷

Desde la v2.1.286, claude auth status identifica la clave de API almacenada al iniciar sesión en Console como api_key en lugar de claude.ai.²³¹

Flujo de trabajo habitual para cambiar entre cuentas u organizaciones:

claude auth logout && claude auth login

Consulta también: ¿Cómo depuro problemas? para solucionar errores de autenticación.

Actualizaciones

Claude Code se actualiza automáticamente de forma predeterminada: busca actualizaciones al iniciarse y, periódicamente, durante las sesiones. Las actualizaciones se descargan en segundo plano y se aplican en el siguiente inicio.

Para desactivar las actualizaciones automáticas:

export DISABLE_AUTOUPDATER=1

O en settings.json:

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

Actualización manual:

claude update

Desinstalación

Instalación nativa (macOS/Linux/WSL):

rm -f ~/.local/bin/claude
rm -rf ~/.claude-code

Instalación nativa (Windows PowerShell):

Remove-Item -Path "$env:LOCALAPPDATA\Programs\claude-code" -Recurse -Force
Remove-Item -Path "$env:LOCALAPPDATA\Microsoft\WindowsApps\claude.exe" -Force

Limpiar la configuración (elimina todos los ajustes):

rm -rf ~/.claude
rm ~/.claude.json
rm -rf .claude
rm -f .mcp.json

Inicio rápido: tu primera sesión

1. Instala e inicia:

claude                           # Launch in current directory

2. Ve a un proyecto:

cd ~/my-project && claude        # Or launch from any git repo

3. Pídele a Claude que haga algo:

> "Explain the architecture of this project"
> "Find all TODO comments and create a summary"
> "Add input validation to the signup form"

4. Usa atajos de teclado durante la sesión:

/cost                            # Check token usage and cost
/compact                         # Free up context when it gets large
Alt+T                            # Toggle extended thinking for hard problems
Ctrl+C                           # Cancel current response

5. Retoma la sesión más adelante:

claude -c                        # Resume your most recent session
claude --resume                  # Pick from session list

Consejo experto: Crea un archivo CLAUDE.md en la raíz de tu proyecto con los comandos de compilación, las convenciones de código y las notas de arquitectura. Claude lo lee en cada sesión; es lo que más puede mejorar la calidad con el menor esfuerzo.

Modos principales de interacción

REPL interactivo

Inicia Claude Code sin argumentos para entrar en el bucle interactivo de lectura, evaluación e impresión:

cd your-project
claude

El REPL mantiene el contexto de la conversación entre turnos. Escribe tus consultas directamente, recibe respuestas y continúa hasta salir con /exit o Ctrl+D.

Comienza con un prompt inicial para centrar la sesión:

claude "explain the authentication flow in this project"

Consejo experto: El REPL conserva el estado durante los eventos de compactación. Cuando el contexto crece demasiado, Claude resume automáticamente la conversación anterior, pero conserva las decisiones clave y los fragmentos de código. Puedes activar este proceso manualmente con /compact o agregar instrucciones personalizadas sobre qué debe conservarse.

Modo no interactivo

El modo de impresión (-p) ejecuta una sola consulta y finaliza:

# Direct query
claude -p "list all TODO comments in this project"

# Process piped input
cat error.log | claude -p "identify the root cause of these failures"

# Chain with other tools
claude -p "generate a README" > README.md

Para obtener una salida estructurada que pueda analizarse en scripts:

claude -p "count lines by file type" --output-format json

La salida de JSON incluye todo lo necesario para la automatización:

{
  "type": "result",
  "subtype": "success",
  "total_cost_usd": 0.0034,
  "is_error": false,
  "duration_ms": 2847,
  "duration_api_ms": 1923,
  "num_turns": 4,
  "result": "Response text here...",
  "session_id": "abc-123-def"
}

Para procesar en tiempo real una salida transmitida:

claude -p "build the application" --output-format stream-json | while read line; do
  echo "$line" | jq -r 'select(.result) | .result'
done

Opciones de formato de salida:

Texto de subagents en stream-json (v2.1.211+): De forma predeterminada, la salida stream-json solo contiene los eventos de la sesión principal; el trabajo realizado dentro de los subagents aparece como un resumen. El indicador --forward-subagent-text (o CLAUDE_CODE_FORWARD_SUBAGENT_TEXT=1) también reenvía al flujo el texto y el razonamiento de los subagents, de modo que los sistemas de ejecución y las canalizaciones de registros puedan observar el trabajo delegado mientras se lleva a cabo, en lugar de ver únicamente el informe final.¹⁸⁸

Los subagents anidados ahora también se reenvían (v2.1.219). Originalmente, solo aparecían los subagents de profundidad 1. Ahora los subagents creados en la profundidad 2 y posteriores también aparecen en el flujo reenviado, cada uno identificado con el id de tool_use de la llamada a Agent que lo creó. Esto permite que una canalización reconstruya el árbol de delegación en lugar de ver una lista plana de texto. Esta mejora complementa directamente la restauración, en la misma versión, de la creación anidada hasta la profundidad 3 de forma predeterminada: sin ella, 2 de los 3 niveles habrían permanecido invisibles.¹⁹⁶

Los subagents en segundo plano ya no quedan incomunicados (v2.1.273): La salida de SDK y stream-json dejó de omitir los mensajes restantes y el informe final de un subagent cuando este se mueve a segundo plano en plena ejecución (por ejemplo, mediante CLAUDE_AUTO_BACKGROUND_TASKS).²¹⁷

Una ejecución bloqueada de -p ahora genera un error (v2.1.277): Las sesiones de claude -p y Agent SDK que encontraban un error interno antes podían quedar bloqueadas sin producir ningún resultado, el peor tipo de fallo para una canalización, ya que solo un tiempo de espera externo podía finalizar la ejecución. Ahora informan el error y terminan con el código 1, por lo que la siguiente tabla de códigos de salida vuelve a constituir el contrato completo. La misma versión también hace que las sesiones sin interfaz guarden sus totales de costo y uso al finalizar: al reanudar una sesión sin interfaz (claude -p --resume, SDK o la recarga de una ventana de la extensión de VS Code), los totales de la sesión ya no comienzan desde cero, por lo que la contabilidad de costos deja de subestimar las ejecuciones sin interfaz reanudadas.²¹⁹

Códigos de salida:

Control del comportamiento autónomo en el modo -p:

# Limit autonomous turns (prevents runaway loops)
claude -p "refactor the auth module" --max-turns 10

# Allow specific tools without prompting
claude -p "fix lint errors" --allowedTools "Edit,Bash(npm run lint)"

# Use with a specific model
claude -p "explain this code" --model claude-sonnet-5

# Bare mode: skip hooks, LSP, plugin sync, skill walks (v2.1.81+); only CLI-named MCP servers (v2.1.286)
claude -p "count files" --bare

# Channel permission relay: send approval prompts to Telegram/Discord (v2.1.81+)
claude --channels

# Restricted mode for eval harnesses and shared machines (v2.1.248+)
claude --restricted -p "query" --tools "Read,Grep,Glob"

# Unattended hosts: deny anything that would prompt (v2.1.259+)
claude -p "run the nightly checks" --permission-prompts none

Modo restringido (v2.1.248+): --restricted (o CLAUDE_CODE_RESTRICTED=1) está diseñado para sistemas de evaluación que ejecutan claude en una máquina compartida. Elimina las herramientas integradas que ejecutan comandos o código, así como WebFetch, salvo que las indiques individualmente en --tools —la configuración predefinida default no cuenta—; limita las herramientas de archivos integradas a los directorios de trabajo; carga únicamente la configuración administrada y --settings (se ignoran los archivos de configuración del usuario, del proyecto y locales); rechaza bypassPermissions y se niega a crear sesiones en la nube.²⁰⁶²⁰⁹

--permission-prompts none (v2.1.259): el complemento para hosts sin supervisión. Todo lo que generaría una solicitud de permiso se rechaza automáticamente, mientras que el modo de permisos activo —incluido el modo automático— continúa tomando todas las decisiones que puede resolver sin tu intervención. No lo confundas con --permission-prompt-tool, que delega las solicitudes a una herramienta MCP en lugar de rechazarlas. La referencia de CLI aún no incluye el nuevo indicador; el CHANGELOG es la fuente.²¹¹

cd persiste entre turnos en las sesiones no interactivas (v2.1.265): Las sesiones -p que reciben entradas stream-json, las sesiones Agent SDK y las sesiones en la nube ya no restablecen el directorio de trabajo del shell con cada nuevo mensaje del usuario: un cd ejecutado en un turno se mantiene en el siguiente.²¹⁵

--system-prompt-snapshot off (v2.1.267): De forma predeterminada, una conversación reutiliza en cada solicitud el prompt del sistema que quedó registrado. Este indicador vuelve a generar el prompt del sistema en cada solicitud; es la opción indicada para iterar sobre el texto del prompt, cuando cada ejecución debe incorporar tu edición más reciente en lugar de la instantánea, a costa de la estabilidad de la caché del prompt que la instantánea busca proteger.²¹⁶

--bare respeta sus límites (v2.1.286): --bare ahora solo se conecta a los servidores MCP indicados en la línea de comandos, no envía recordatorios del sistema al modelo y no inicia tareas en segundo plano; si un comando del shell alcanza su tiempo de espera, se detiene en lugar de pasar a segundo plano. La documentación sobre el modo sin interfaz indica que, antes de la versión v2.1.286, estos límites solo se respetaban parcialmente y recomienda --bare para llamadas mediante scripts y SDK.²³¹²³³

Patrón de integración con CI/CD:

# In a GitHub Action or CI pipeline
result=$(claude -p "review this diff for security issues" --output-format json 2>/dev/null)
is_error=$(echo "$result" | jq -r '.is_error')
if [ "$is_error" = "true" ]; then
  echo "Review failed"
  exit 1
fi
echo "$result" | jq -r '.result'

Administración de sesiones

Las sesiones conservan el historial de la conversación para poder continuarla. La persistencia de las sesiones es esencial para trabajos complejos que abarcan varias sesiones:

# Continue most recent session
claude -c

# Continue with additional prompt
claude -c -p "now add error handling"

# Resume specific session by ID
claude -r "abc123" "implement the remaining tests"

# Fork a session for parallel exploration
claude -r "base-session" --fork-session "try a different approach"

# Open the Claude desktop app on this directory, or on a session (v2.1.285)
claude --desktop
claude --desktop --continue

Mueve una sesión en ejecución con /cd (v2.1.169+; configuración inmediata desde v2.1.246): /cd path cambia el directorio de trabajo sin afectar la caché del prompt. Desde la versión v2.1.246, la configuración del proyecto, los hooks, los servidores de .mcp.json (sujetos a la solicitud de aprobación habitual), las skills y los agentes del nuevo directorio entran en vigor inmediatamente después del cambio, en lugar de esperar a --resume.²⁶²²⁴⁹

Sesiones vinculadas a PR (v2.1.27+, ampliadas en v2.1.119+): Inicia una sesión vinculada a una solicitud de extracción o fusión específica. Desde la versión v2.1.119, --from-pr acepta URL de MR de GitLab, PR de Bitbucket y PR de GitHub Enterprise, además de github.com:⁷⁴¹⁵²

claude --from-pr 123                                                # GitHub PR number (assumes current repo's remote)
claude --from-pr https://github.com/org/repo/pull/123               # GitHub URL
claude --from-pr https://gitlab.com/org/repo/-/merge_requests/45    # GitLab MR (v2.1.119+)
claude --from-pr https://bitbucket.org/org/repo/pull-requests/67    # Bitbucket PR (v2.1.119+)
claude --from-pr https://ghe.example.com/org/repo/pull/89           # GitHub Enterprise (v2.1.119+)

Las sesiones también se vinculan automáticamente a los PR cuando los creas mediante gh pr create durante una sesión. Esto facilita reanudar más adelante el trabajo en un PR específico. La insignia del PR en el pie puede dirigir a una URL personalizada de revisión de código mediante la configuración prUrlTemplate (v2.1.119+), lo que resulta útil cuando tu equipo enlaza los PR con una herramienta de revisión independiente.¹⁵²

/resume acepta URL de PR (v2.1.122+). Al pegar la URL de un PR en el cuadro de búsqueda de /resume, ahora se encuentra la sesión que creó originalmente ese PR. Funciona con github.com, GitHub Enterprise, gitlab.com (incluidas las instalaciones autohospedadas de GitLab) y bitbucket.org.¹⁵⁴

Sesiones con nombre: Asigna un nombre a las sesiones al iniciarlas o durante una sesión:

# Name session at startup (v2.1.76+)
claude -n "auth-refactor"                  # --name flag sets display name[^125]

# Name current session
> /rename auth-refactor

# Resume by name or number
> /resume 1                    # Resume first session
> /resume auth-refactor        # Resume by name
claude --resume auth-refactor  # Resume from terminal
claude -r 3                    # Resume by number from terminal

# Fork for parallel exploration
claude --resume auth-refactor --fork-session

Nota: --session-id requiere un UUID válido (por ejemplo, 550e8400-e29b-41d4-a716-446655440000). Para asignar nombres legibles a las sesiones, utiliza /rename y --resume.

/fork crea una sesión en segundo plano; /subtask es la bifurcación dentro de la sesión (v2.1.212). El comando /fork ahora copia la conversación actual en una nueva sesión en segundo plano; esta obtiene su propia fila en claude agents, por lo que puedes enviar la copia a explorar una alternativa mientras continúa tu sesión principal. El comportamiento anterior —bifurcar dentro de la sesión actual— se mantiene con el nuevo nombre /subtask.¹⁸⁹ Desde la versión v2.1.214, una sesión que comienza como bifurcación informa "fork" como origen del hook SessionStart (antes informaba "resume"), lo que permite que los hooks que filtran por origen distingan ambos casos.¹⁹⁰ La versión v2.1.216 reduce la confirmación de /fork a una sola línea que muestra el nombre de la nueva sesión y su id de claude attach.¹⁹² Desde la versión v2.1.221, una sesión bifurcada crea su propio worktree en lugar de trabajar en el checkout de la sesión original. De este modo, la bifurcación que explora una alternativa ya no puede interferir con los archivos sin confirmar de la sesión principal, que era el principal riesgo al enviar una copia a experimentar.¹⁹⁹ La versión v2.1.232 también convierte la bifurcación en el comportamiento predeterminado de los subagents: un subagent con subagent_type: "fork" hereda toda la conversación y la caché del prompt, y la creación de agentes que no sean compañeros de equipo en sesiones interactivas ahora se ejecuta en segundo plano de forma predeterminada.²⁵⁵

Claude Code almacena las sesiones como transcripciones JSONL. La ejecución de agentes asigna valores agentId únicos y almacena las transcripciones como agent-{agentId}.jsonl. Al reanudar una sesión, se conserva todo el contexto de las conversaciones anteriores.

Modo de planificación

El modo de planificación limita a Claude a una exploración de solo lectura: no permite editar archivos, ejecutar bash ni realizar acciones destructivas. Claude diseña un enfoque de implementación, lo escribe en un archivo de plan y espera tu aprobación antes de ejecutar cualquier acción.

Cómo entrar en el modo de planificación:

# Cycle through modes during a session
Shift+Tab           # Cycles: normal → plan → auto-accept

# Or use the /plan command with an optional description (v2.1.72+)
/plan                                     # Enter plan mode
/plan refactor the auth module            # Enter plan mode with a description

# Or ask Claude directly
"Plan how to refactor the auth module"   # Claude may enter plan mode automatically

Cómo funciona:

1. Claude entra en el modo de planificación (automáticamente para tareas complejas o mediante Shift+Tab)
2. Explora el código base con herramientas de solo lectura: Read, Glob, Grep, WebSearch, WebFetch
3. Escribe un plan en .claude/plans/{session-slug}.md
4. Sale del modo de planificación con ExitPlanMode y presenta el plan para que lo revises
5. Apruebas el plan, solicitas cambios o lo rechazas

Herramientas disponibles en el modo de planificación: Read, Glob, Grep, LS, WebSearch, WebFetch, AskUserQuestion. Las herramientas de edición (Edit, Write, Bash, NotebookEdit) están bloqueadas.

Después de aprobar el plan (v2.1.32+): Claude ofrece tres opciones: - «Sí, borrar el contexto y aceptar automáticamente las ediciones» (Shift+Tab): comienza desde cero con todo el contexto disponible para el plan - «Sí, y aprobar manualmente las ediciones»: conserva el contexto y tú apruebas cada cambio - «Sí, aceptar automáticamente las ediciones»: conserva el contexto y Claude ejecuta los cambios sin pedir aprobación para cada edición

Borrar automáticamente el contexto al aprobar es el flujo de trabajo recomendado. Proporciona al plan una ventana de contexto nueva, lo que mejora considerablemente su cumplimiento: Claude se mantiene encaminado durante más tiempo sin que la conversación anterior interfiera.

Cuándo utilizar el modo de planificación: - Implementaciones de funciones nuevas que requieran decisiones de arquitectura - Refactorizaciones de varios archivos en las que quieras revisar primero el enfoque - Código base desconocido, donde la exploración deba preceder a las modificaciones - Cualquier tarea con varios enfoques válidos sobre los que quieras opinar

Consejo experto: Cuanto más tiempo dediques al modo de planificación, más probabilidades tendrá Claude de implementar correctamente la solución. El modo de planificación ofrece una exploración prácticamente gratuita: no hay llamadas arriesgadas a herramientas ni ediciones desperdiciadas. Úsalo con frecuencia.

Modo de lector de pantalla (v2.1.208)

Claude Code incluye un modo específico de lector de pantalla que adapta la interfaz de la terminal para las tecnologías de asistencia. Puedes habilitarlo de tres maneras:¹⁸⁶

# Flag at launch
claude --ax-screen-reader

# Environment variable
export CLAUDE_AX_SCREEN_READER=1

# Or persistently in settings.json
{ "axScreenReader": true }

Anthropic documenta el modo —y sus patrones de interacción— en una nueva página de accesibilidad de la documentación oficial.¹⁸⁶

Sin pausa antes de cada línea (v2.1.287): El modo de lector de pantalla ahora escribe las líneas nuevas o modificadas sin hacer primero una pausa con el cursor al inicio de la línea. CLAUDE_AX_PREPARK_MS establece esa pausa en milisegundos; su valor predeterminado ahora es 0 (antes era 50), así que configura CLAUDE_AX_PREPARK_MS=50 para restaurarla. La misma versión corrige varios problemas del lector de pantalla, entre ellos que el cursor apareciera lejos del texto escrito en los cuadros de búsqueda y que las líneas modificadas no aparecieran en las solicitudes de aprobación de ediciones.²³²²³³

Análisis a fondo del sistema de configuración

Claude Code usa un sistema de configuración por capas. Es fundamental entender la jerarquía, porque los niveles superiores anulan a los inferiores y la configuración empresarial no se puede eludir de ninguna manera.

Jerarquía de configuración

Configurar desde el prompt: /config key=value (v2.1.181)

Desde la v2.1.181, /config key=value establece cualquier configuración en línea desde el prompt (por ejemplo, /config thinking=false) sin abrir la interfaz interactiva de /config, y funciona en sesiones interactivas, con -p y de Remote Control. /config --help (v2.1.183) lista las claves abreviadas disponibles. La v2.1.183 también cambió la interfaz interactiva de /config para que tanto Enter como Espacio activen o desactiven la opción seleccionada, y Esc guarde y cierre (antes revertía los cambios).¹⁷⁴

Referencia completa de settings.json

Una configuración completa que muestra todas las opciones principales:

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "claude-sonnet-5",
  "permissions": {
    "allow": [
      "Read",
      "Glob",
      "Grep",
      "Bash(npm run:*)",
      "Bash(git:*)",
      "Bash(make:*)",
      "Edit(src/**)",
      "mcp__github"
    ],
    "deny": [
      "Read(.env*)",
      "Read(secrets/**)",
      "Bash(rm -rf:*)",
      "Bash(sudo:*)",
      "Edit(package-lock.json)",
      "Edit(.git/**)"
    ],
    "ask": [
      "WebFetch",
      "Bash(curl:*)",
      "Bash(docker:*)"
    ],
    "additionalDirectories": [
      "../shared-lib",
      "../docs"
    ],
    "defaultMode": "acceptEdits"
  },
  "env": {
    "NODE_ENV": "development",
    "DEBUG": "app:*"
  },
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
          }
        ]
      }
    ]
  },
  "sandbox": {
    "enabled": false,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["git", "docker"]
  },
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh"
  },
  "cleanupPeriodDays": 30,
  "outputStyle": "Explanatory",
  "language": "en",
  "respectGitignore": true,
  "showTurnDuration": true,
  "plansDirectory": ".claude/plans",
  "spinnerVerbs": ["Thinking", "Processing", "Analyzing"],
  "spinnerTipsOverride": {
    "label": "Team tips",
    "tips": [
      "Custom tip 1",
      {"id": "tip-2", "text": "Custom tip 2", "cooldownSessions": 5, "priority": 1}
    ],
    "tipsFile": "~/.claude/team-tips.json",
    "excludeDefault": true
  },
  "skillOverrides": {
    "legacy-skill": "off",
    "manual-only-skill": "user-invocable-only",
    "compact-skill": "name-only"
  },
  "includeGitInstructions": false,
  "modelOverrides": {
    "claude-opus-5-5": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-prod",
    "claude-sonnet-5": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/sonnet-prod"
  },
  "autoMemoryDirectory": ".claude/memory",
  "sandbox": {
    "enableWeakerNetworkIsolation": true
  }
}

skillOverrides resulta útil cuando un equipo tiene una biblioteca de skills grande pero quiere limitar más lo que se expone en tiempo de ejecución. Usa off para ocultar una skill tanto al modelo como al selector de comandos slash, user-invocable-only para que siga siendo invocable por nombre pero quede fuera de la selección del modelo, y name-only para dejar visible solo el nombre de la skill, sin su descripción completa.¹⁵⁶

Configuraciones más recientes (v2.1.174–176):

• availableModels / enforceAvailableModels (administrada, v2.1.175+): la lista de permitidos availableModels restringe qué modelos puede seleccionar una sesión. Con enforceAvailableModels: true, la lista de permitidos también limita el modelo Default: un Default que se resolvería a un modelo no permitido recurre al primer modelo permitido, y la configuración de usuario o de proyecto ya no puede ampliar una lista availableModels administrada. Una corrección complementaria (v2.1.176) cierra el hueco por el que elegir un alias podía redirigir a un modelo bloqueado mediante ANTHROPIC_DEFAULT_*_MODEL, y /fast ahora se niega a cambiar a un modelo fuera de la lista de permitidos.¹⁷² Desde la v2.1.187, las organizaciones pueden aplicar restricciones de modelos directamente en el selector de /model, --model, /model y ANTHROPIC_MODEL: al seleccionar un modelo restringido aparece el mensaje “restricted by your organization’s settings”.¹⁷⁶
• language (ajuste de la v2.1.176): además de establecer el idioma de las respuestas, los títulos de sesión ahora se generan por defecto en el idioma de tu conversación; configura language para fijar un idioma específico para los títulos.¹⁷²
• footerLinksRegexes (v2.1.176): insignias de enlace que coinciden con expresiones regulares en la fila del pie, configurables mediante la configuración de usuario o administrada.¹⁷²
• wheelScrollAccelerationEnabled (v2.1.174): establécelo en false para desactivar la aceleración del desplazamiento con la rueda del mouse en modo de pantalla completa.¹⁷²

Configuraciones más recientes (v2.1.207–v2.1.212):

• vimInsertModeRemaps (v2.1.208): reasignaciones de teclas personalizadas para el modo de inserción de vim; el ejemplo clásico es asignar jj a Escape (consulta Modo Vim).¹⁸⁶
• axScreenReader (v2.1.208): activa el modo de lector de pantalla de forma persistente (consulta Modo de lector de pantalla).¹⁸⁶
• processWrapper (v2.1.208): enruta cada proceso que Claude Code genera para sí mismo a través de un ejecutable envoltorio, pensado para lanzadores corporativos (consulta Lanzador corporativo).¹⁸⁶
• Restricción de origen de autoMode (v2.1.207): la configuración autoMode ya no se lee del .claude/settings.local.json de un repositorio; configúrala en ~/.claude/settings.json. Así se cierra una vía por la que un repositorio clonado podía incluir configuración del modo automático.¹⁸⁵

Configuraciones más recientes (v2.1.217):

• emojiCompletionEnabled (v2.1.217): autocompletado de códigos cortos de emoji en el campo del prompt: escribe :heart: para insertar ❤️, o algo parcial como :hea para ver sugerencias. Está activado por defecto; establécelo en false para desactivarlo.¹⁹⁴

Configuraciones más recientes (v2.1.219):

• sandbox.network.strictAllowlist (v2.1.219): deniega los hosts que no están en la lista de permitidos para los comandos en sandbox sin preguntar, en lugar de mostrar un diálogo de permisos. Consulta Modo sandbox.¹⁹⁶
• workflowSizeGuideline (v2.1.219): establece la pauta orientativa de tamaño de los workflows dinámicos desde cualquier archivo de configuración (de usuario, de proyecto o administrado), en lugar de hacerlo solo mediante /config. Los workflows dinámicos usan por defecto una pauta media (“aim for fewer than 15 agents”); la fila de /config se oculta mientras un archivo de configuración proporcione el valor. Es orientativa, no un límite obligatorio. Consulta Subagents.¹⁹⁶

Configuraciones más recientes (v2.1.242–243):

• modelPicker (de usuario o administrada, v2.1.242+): organiza el selector de /model con una lista ordenada y etiquetada de modelos. Es un objeto con un arreglo options (cada fila lleva un model obligatorio y label y description opcionales; model se toma tal cual, así que funcionan los alias, los IDs de Anthropic y los IDs de Bedrock/Vertex/Foundry/gateway) y un Boolean opcional replaceBuiltInOptions (false, el valor por defecto, agrega las filas después de la lista integrada; true muestra solo tus filas, Default y el modelo que la sesión ya está usando). Claude Code lee la clave desde la configuración administrada, --settings y la configuración de usuario, y la ignora en la configuración de proyecto y local, de modo que un repositorio clonado no puede reetiquetar el selector; la fuente de mayor nivel que la define aporta la lista completa. La lista de permitidos availableModels sigue aplicándose a cada fila, y una etiqueta cambia lo que muestra el selector, no qué modelo se ejecuta.²⁵⁰²⁴⁸
• promptCacheTtl / subagentPromptCacheTtl (cualquier archivo, v2.1.242+): "5m" o "1h" por grupo de solicitudes, para que los usuarios con clave de API y de proveedores en la nube puedan mantener una caché de una hora en la conversación principal mientras los subagents se quedan en cinco minutos. Consulta Estrategias de caché.²⁵⁰²⁴⁸
• modelPricing (administrada, v2.1.243+): las tarifas contratadas por modelo y el multiplicador de descuento de una organización, que /cost, la línea de estado y las cifras de costo de la telemetría usan en lugar del precio de lista. Consulta Ver costos.²⁵⁰

Configuraciones más recientes (v2.1.247): - feedbackDrafts (v2.1.247): controla la nueva herramienta SendFeedback: cuando algo sale mal en una sesión, Claude puede redactar un informe de feedback para que lo revises y lo envíes desde /feedback; con esta configuración desactivas la redacción. Consulta la fila de /feedback en Slash Commands.²⁴⁵ - Ampliación del formato de spinnerTipsOverride (v2.1.247): las entradas de consejos ahora pueden ser objetos {id, text, cooldownSessions, priority} además de cadenas simples, y el objeto incorpora las claves tipsFile y label, de modo que las organizaciones pueden rotar sus propios consejos junto con los integrados (el ejemplo anterior muestra el formato ampliado). La referencia de configuración ya documenta las nuevas claves.²⁴⁵²²⁷

Configuraciones más recientes (v2.1.248–251):

• desktopSessionCleanupPeriodDays (v2.1.248): limita cuánto tiempo las sesiones escritas desde la app de escritorio quedan exentas de la limpieza de transcripciones. Más que el ajuste en sí, importa la corrección que lo acompaña: las sesiones de Claude Desktop y Cowork desaparecían después de cleanupPeriodDays (30 días por defecto); ahora la limpieza las conserva mientras estén en la app, salvo que una política de la organización gestione la retención.²⁰⁶
• Restricciones de env en el proyecto (v2.1.251): un bloque env de .claude/settings.json a nivel de proyecto ya no puede establecer CLAUDE_CONFIG_DIR, CLAUDE_CODE_TMPDIR ni TMPDIR/TMP/TEMP; defínelas en tu shell o en la configuración de usuario o administrada, para que un repositorio clonado no pueda redirigir el lugar donde Claude Code escribe su configuración y sus archivos temporales.²⁰⁶

Configuraciones más recientes (v2.1.257-259):

• timeFormat / timeZone (v2.1.257): controlan cómo Claude Code muestra las horas, tanto el reloj de finalización al cierre de cada turno como las marcas de tiempo de la transcripción. timeFormat acepta formato de 12 horas, 24 horas, 24 horas en UTC o un patrón strftime explícito; timeZone indica la zona horaria.²¹¹ La referencia de configuración ya documenta ambas claves.²²⁷
• permissions.blockReadsOutsideWorkingDirectories (v2.1.257): rechaza de plano las lecturas de archivos fuera de los directorios de trabajo de la sesión. Sin esta opción, el modo automático ahora pregunta una vez antes de la primera lectura de ese tipo en la sesión (consulta Auto Mode).²¹¹ La v2.1.273 cierra dos brechas: un comando de Bash que el verificador no puede analizar por completo ahora pide confirmación en lugar de saltarse la comprobación, y un directorio de memoria elegido por la configuración de un repositorio no se carga, no se recupera ni se indexa con esta opción activa.²¹⁷
• managedMcpServers / managedSourcesBehavior: claves de alcance administrado, tratadas en Enterprise Deployment: organizaciones que proporcionan servidores MCP a todos sus usuarios (v2.1.259) y la combinación opcional entre fuentes administradas (refinada en la v2.1.257).²¹¹²⁴⁴

Configuraciones más recientes (v2.1.261):

• bashOutputMaxChars / taskOutputMaxChars (v2.1.261): aumentan cuánta salida de comandos (y de tareas en segundo plano, respectivamente) recibe Claude en línea antes de que el resto se guarde en un archivo, hasta 128K caracteres. Es un mecanismo distinto de la variable de entorno BASH_MAX_OUTPUT_LENGTH, que define la ventana de relectura del archivo de salida de trabajo del comando (30.000 caracteres por defecto, con un máximo de 150.000): estas claves rigen el umbral entre salida en línea y archivo persistido; una vez superado, la salida va a parar a un archivo que Claude puede leer cuando lo necesite, en lugar de cortarse.²¹⁴ Desde la v2.1.265, el lado persistido también tiene un techo: los resultados de herramientas guardados en disco tienen un límite de 1 GB, y la vista previa dentro de la conversación indica cuándo se truncó un archivo guardado.²¹⁵ La mitad correspondiente a las tareas se retiró en la v2.1.277: se eliminó la herramienta obsoleta TaskOutput (Claude ahora lee el archivo de salida de una tarea en segundo plano con Read), y taskOutputMaxChars y TASK_MAX_OUTPUT_LENGTH ya no tienen ningún efecto. bashOutputMaxChars no se ve afectada.²¹⁹

Configuraciones más recientes (v2.1.267-269):

• maxEffortLevel (v2.1.267): limita el nivel de esfuerzo que pueden elegir los usuarios, ya sea a nivel general o por modelo dentro de modelSettings, y se aplica en todos los proveedores, incluidos Bedrock, Vertex y Foundry. Los usuarios aún pueden elegir un nivel por debajo del límite; es el complemento del lado del administrador para /effort.²¹⁶
• advisorModel: el modelo asesor guardado (fable, opus, sonnet o un ID completo) que /advisor escribe en la configuración de usuario; --advisor lo sobrescribe para una sesión y CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 desactiva la herramienta. Consulta The Advisor Tool.²⁷⁴
• sandbox.allowNestedUserNamespaces (v2.1.305): permite que los comandos en sandbox en Linux y WSL2 creen espacios de nombres de usuario (Chromium, podman sin root); como esto les permite eludir las protecciones de archivos del sandbox, solo se lee desde la configuración de usuario o administrada. Consulta Sandbox Mode.²⁷⁸²⁷⁹
• bashEditDiffEnabled (v2.1.269): cuando la herramienta Bash realiza una edición de archivos, el resultado de la herramienta incluye un diff de los archivos que modificó el comando, de modo que la conversación muestra lo que realmente hizo una edición al estilo de sed.²¹⁶

Configuraciones más recientes (v2.1.275):

• syncClaudeAiSkills / syncClaudeAiPlugins (v2.1.275): los skills y plugins habilitados en tu cuenta de claude.ai ahora se sincronizan con las sesiones de terminal iniciadas con esa cuenta. Establece cualquiera de las dos claves en false para que las sesiones de terminal usen solo skills y plugins locales. Consulta Skills y Plugin System.²¹⁸

Configuraciones más recientes (v2.1.282-283):

• maxProseWidth (v2.1.282): limita el ancho que ocupa la prosa de Claude en una terminal amplia. Los párrafos, encabezados, listas y citas se ajustan dentro de esa cantidad de columnas, mientras que las tablas y los bloques de código conservan el ancho completo. El valor es un número entero de columnas, con un mínimo de 40.²²⁵²²⁷
• deniedModels / availableModelsMatch (administrada, v2.1.283): deniedModels bloquea modelos específicos incluso cuando availableModels los permite. Un alias de familia como "opus" bloquea toda la familia, y "claude-opus-5" también bloquea Opus 5.5 (escribe "claude-opus-5-0" para bloquear solo Opus 5). Por defecto, una entrada de availableModels como "claude-opus-5" también permite las versiones posteriores que la extienden; availableModelsMatch: "exact" hace que cada entrada permita únicamente la versión que nombra, de modo que un nuevo lanzamiento permanece bloqueado hasta que lo incluyas en la lista. Claude Code lee ambas claves solo desde la configuración administrada.²²⁶²²⁷
• allowClaudeInChromeWithManagedMcp (administrada, v2.1.282): permite ejecutar claude --chrome junto con un managed-mcp.json exclusivo; el error que aparece cuando Chrome está bloqueado ahora menciona la clave.²²⁵ La referencia de configuración ya la documenta: la clave solo se lee desde la configuración administrada del propio dispositivo, y una entrada de deniedMcpServers para claude-in-chrome sigue bloqueando el servidor.²³³

Configuraciones más recientes (v2.1.285):

• allowedProviders (administrada, v2.1.285): limita qué proveedores de API puede usar una máquina: la API de Anthropic, un endpoint personalizado, Bedrock, Mantle, Vertex AI, Foundry, Claude Platform en AWS o un gateway en la nube.²²⁹ La referencia de configuración documenta la clave; una lista proveniente de las fuentes de administración propias de la máquina sigue aplicándose cuando la configuración administrada por el servidor también entrega una, de modo que una sesión solo puede usar los proveedores que aparecen en ambas listas.²³³

Búsqueda de configuraciones: las opciones más buscadas

Si llegaste aquí buscando una configuración específica por su nombre, este es el índice breve. Cada entrada indica la versión en la que se lanzó y, cuando un alcance es su dueño, cuál:

¿Dónde está la documentación oficial de cada tema?

Esta guía es un manual de campo, no la referencia oficial. Cuando necesites la página canónica de Anthropic sobre un subsistema, estas son las ubicaciones oficiales (cada sección de esta guía enlaza la suya):

Referencia de variables de entorno

Autenticación y API:

ANTHROPIC_API_KEY=sk-ant-...                    # Direct API authentication
ANTHROPIC_AUTH_TOKEN=token                      # Custom authorization header
ANTHROPIC_CUSTOM_HEADERS="X-Key: val"           # Additional request headers; credential/org/routing/API-behavior headers set from managed or project settings require approval (v2.1.251)[^238]

Configuración del modelo:

ANTHROPIC_MODEL=claude-opus-4-7                 # Override default model (Apr 16, 2026)
ANTHROPIC_DEFAULT_MODEL=claude-opus-5-5         # Model new sessions START on; a /model pick overrides + persists (v2.1.236)
ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5    # What the `opus` alias resolves to (Opus 5.5 since v2.1.280; Opus 5 v2.1.219-278)
ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-6
ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5-20251001  # pin the haiku alias; on the Anthropic API it resolves to Haiku 5.5 (claude-haiku-5-5) as of v2.1.293[^274][^275]
CLAUDE_CODE_SUBAGENT_MODEL=sonnet               # Default model for subagents; an agent's model: field and per-spawn picks win (v2.1.251 demoted it from override to default)[^238]
CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1             # Turn the advisor tool off: /advisor becomes unavailable, advisorModel is ignored, --advisor is accepted but does nothing[^282]
CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1              # Force every subagent onto CLAUDE_CODE_SUBAGENT_MODEL (or the main model), ignoring agent-definition and per-spawn overrides -- the pre-v2.1.251 behavior, opt-in (v2.1.257)[^243]
CLAUDE_CODE_DISABLE_WORKFLOWS=1                 # Turn dynamic workflows off for one session; same effect as "disableWorkflows": true, and whichever of the two turned them off, the other cannot turn them back on. Workflows are on by default except on Pro, where "enableWorkflows": true (the Dynamic workflows row in /config) turns them on; the v2.1.147 opt-in CLAUDE_CODE_WORKFLOWS=1 no longer appears in the env-vars reference[^291]
MAX_THINKING_TOKENS=10000                       # (Opus 4.6 and Sonnet 4.6 only — removed in Opus 4.7)
CLAUDE_CODE_MAX_OUTPUT_TOKENS=4000              # Limit output length
CLAUDE_CODE_MAX_TURNS=10                        # Cap agentic turns when no --max-turns is passed; the flag wins when both are set, and a value that is not a positive integer is rejected at startup[^291]
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1          # Enable agent teams (v2.1.32+)

Configuración del proveedor de nube:

CLAUDE_CODE_USE_BEDROCK=1                       # Use AWS Bedrock
CLAUDE_CODE_USE_VERTEX=1                        # Use Google Vertex AI
CLAUDE_CODE_USE_FOUNDRY=1                       # Use Microsoft Foundry
ANTHROPIC_BEDROCK_BASE_URL=https://...          # Custom Bedrock endpoint
ANTHROPIC_BEDROCK_SERVICE_TIER=priority         # Bedrock service tier (v2.1.122+): 'default', 'flex', or 'priority'; sent as X-Amzn-Bedrock-Service-Tier header[^162]
CLAUDE_CODE_SKIP_BEDROCK_AUTH=1                 # Skip Bedrock auth (for gateways)
CLAUDE_CODE_SKIP_VERTEX_AUTH=1                  # Skip Vertex auth
AWS_BEARER_TOKEN_BEDROCK=token                  # Bedrock bearer token
VERTEX_REGION_CLAUDE_3_7_SONNET=us-west1        # Override Vertex region
VERTEX_REGION_CLAUDE_HAIKU_5_5=us-east5          # Vertex region for Claude Haiku 5.5 (v2.1.293+)[^276]
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1    # Opt in gateway /v1/models discovery for /model picker (v2.1.129+)[^164]
CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS=3000  # Extend the LLM gateway /v1/models discovery timeout (default 3s; v2.1.269+)[^252]
CLAUDE_CODE_GATEWAY_HINT_HEADERS=1              # Send the x-claude-code-* hint headers (request-class, agent-type, prev-tool-durations, compaction, context-compacted, and prompt-id from v2.1.283) through a gateway or third-party provider; a direct Anthropic API connection sends them by default, and =0 stops them everywhere (v2.1.273+)[^253][^262][^263]
CLAUDE_CODE_AUTO_MODE_SERVER=0                  # Opt out of the server-side auto-mode checks, the default since v2.1.278 for Enterprise and Claude API accounts, Claude Platform on AWS, Bedrock, Agent Platform, Foundry, and gateways (not charged when the server performs them; =1 was the v2.1.273-277 opt-in); also applies on a direct Anthropic API connection since v2.1.281, where server-side is the default with telemetry off since v2.1.282; the docs call it temporary[^253][^255][^259][^260][^261]
CLAUDE_CODE_AUTO_MODE_MODEL=claude-sonnet-5-5   # Model the client-side auto mode classifier uses; no effect on server-side auto mode (v2.1.302+)[^283]

Control del comportamiento:

DISABLE_AUTOUPDATER=1                           # Prevent automatic background updates
DISABLE_UPDATES=1                               # Block ALL update paths including manual `claude update` (v2.1.118+, stricter than DISABLE_AUTOUPDATER)[^160]
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1       # Homebrew/WinGet installs run package-manager upgrade in background, then prompt restart (v2.1.129+)[^164]
DISABLE_TELEMETRY=1                             # Opt out of usage telemetry
DISABLE_ERROR_REPORTING=1                       # Disable Sentry
DISABLE_BUG_COMMAND=1                           # Disable /bug command
CLAUDE_CODE_DISABLE_WEB_FETCH=1                 # Turn off the WebFetch tool; WebSearch stays available (v2.1.285+)[^265][^269]
CLAUDE_CODE_DISABLE_ARTIFACT=1                  # Turn the Artifact tool off for one session; while it is set, no settings file turns artifacts back on[^291]
CLAUDE_CODE_ARTIFACT_AUTO_OPEN=0                # Do not open the browser when a new artifact is published[^291]
CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES=2      # Cap re-sends of a non-streaming fallback request that timed out (v2.1.285+)[^265]
CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS=5000 # Starting delay of the exponential backoff between retries of a 529 overloaded request, default 500; whole milliseconds from 500 to 32000; no effect with CLAUDE_CODE_RETRY_WATCHDOG=1 or in fast mode (v2.1.292+)[^272][^276]
CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS=60000 # Ceiling of that backoff, default 32000 ms (v2.1.296+; in the env-vars docs since October 14)[^274][^280]
CLAUDE_CODE_RETRY_WATCHDOG=1                     # Unattended sessions: retry 429 and 529 capacity errors indefinitely, backing off up to 5 minutes or until the limit resets (v2.1.186+)[^276]
CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS=1800000   # Cap, per request, on how long the watchdog waits out 429 and 529 errors; unset means no limit (v2.1.295+)[^274][^276]
CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS=3600000 # Under the watchdog, end a request at a usage limit that resets further away than this instead of waiting it out (v2.1.301+)[^283]
CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS=60000 # Minimum interval between checks that a usage limit was lifted before its reset, while the watchdog waits on it (v2.1.305+)[^286][^287]
CLAUDE_CODE_RESTRICTED=1                        # Restricted mode: no command/code tools or WebFetch unless named in --tools; only managed settings load (v2.1.248+)[^238]
CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT=1      # Keep the dangerous-rm prompt waiting in auto mode and --dangerously-skip-permissions instead of denying after 2 minutes (v2.1.281+)[^260]
CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT=1    # Skip the prompt for a recursive rm whose target is only command-substitution output, such as rm -rf "$(pwd)" (v2.1.281+)[^260]
CLAUDE_CODE_STRICT_INLINE_SHELL_RM_PROMPT=1     # Keep prompting for an rm built at run time inside a shell -c script Claude Code cannot read; such scripts no longer prompt by default (v2.1.299+; release-notes only as of 2026-10-14)[^279][^280]
DISABLE_COST_WARNINGS=1                         # Hide cost warnings
DISABLE_PROMPT_CACHING=1                        # Disable prompt caching globally
DISABLE_PROMPT_CACHING_SONNET=1                 # Disable for Sonnet only
DISABLE_PROMPT_CACHING_OPUS=1                   # Disable for Opus only
DISABLE_NON_ESSENTIAL_MODEL_CALLS=1             # Skip non-critical API calls
ENABLE_PROMPT_CACHING_1H=1                      # Opt into 1-hour prompt cache TTL (v2.1.108+, API/Bedrock/Vertex/Foundry)
ENABLE_PROMPT_CACHING_1H_BEDROCK=1              # Deprecated alias for the above; v2.1.108+ still honors it on Bedrock but logs a deprecation notice
FORCE_PROMPT_CACHING_5M=1                       # Force 5-minute cache TTL (v2.1.108+)
CLAUDE_CODE_PROMPT_CACHE_TTL=1h                 # Main-conversation cache TTL, 5m or 1h; beats the promptCacheTtl setting (v2.1.242+)[^234]
CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL=5m        # TTL for subagents, workflows, forks, compaction, titles; beats subagentPromptCacheTtl (v2.1.242+)[^234]
ENABLE_TOOL_SEARCH=true                         # Re-enable tool search on Vertex AI (disabled by default v2.1.119+ to avoid unsupported beta header). Valid values: true, false, auto, auto:N[^160]
CLAUDE_CODE_HIDE_CWD=1                          # Hide the working directory in the startup logo (v2.1.119+)[^160]
CLAUDE_CODE_FORK_SUBAGENT=0                     # Turn fork subagents off; on by default in the terminal and, since v2.1.302, in claude -p, the Agent SDK, the desktop app, and VS Code (=1 was the external-build opt-in from v2.1.117; claude mcp serve never offers them)[^160][^283]
CLAUDE_CODE_FORCE_SYNC_OUTPUT=1                 # Force synchronized terminal output when auto-detection misses it, such as Emacs eat (v2.1.129+)[^164]
CLAUDE_CODE_SESSION_ID=...                      # Read-only: present in the Bash tool subprocess; matches the session_id passed to hooks (v2.1.132+)[^168]
CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1          # Skip the fullscreen alternate-screen renderer; keep the conversation in the terminal's native scrollback (v2.1.132+)[^168]
CLAUDE_EFFORT=...                               # Read-only: current effort level inside hooks and Bash tool subprocess (v2.1.133+)[^169]
CLAUDE_CODE_FORWARD_SUBAGENT_TEXT=1             # Include subagent text + thinking in stream-json output; pairs with --forward-subagent-text (v2.1.211+). Covers depth-2+ nested subagents as of v2.1.219[^205][^213]
CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION=200    # Per-session WebSearch cap (default 200; v2.1.212+). Since v2.1.290 an interactive session's budget refills instead of ending at 200 (next line); the env-vars docs, fetched Oct 6, still describe the 200 cap[^206][^271][^273]
CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR=100     # WebSearch budget refill rate: 100 calls/hour by default in an interactive session, 0 (off) in a non-interactive one (v2.1.290+)[^271][^276]
CLAUDE_CODE_DISABLE_ATTACHMENTS=1               # Send @-mentions as plain text instead of expanding file content; a repo's .claude/settings.json or settings.local.json can no longer set it (v2.1.290)[^271][^273]
CLAUDE_CODE_DISABLE_FILE_MENTIONS=1             # Hand Claude the path of an @ mention to read with its file tools, not the file's contents, so PreToolUse hooks see the read; ignored in project and local settings (v2.1.299+)[^279][^280]
CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS=900000        # WebFetch per-URL session cache TTL (default 15 min; v2.1.233+)[^226]
CLAUDE_CODE_WEBFETCH_DEADLINE_MS=300000         # WebFetch hard deadline: a server that never finishes its response fails the fetch after 300s by default; 0 disables (v2.1.268+)[^252]
CLAUDE_CODE_PROJECT_DIR_NAME=myproj             # Short name for the per-project transcript directory, for hosts that give each session its own config dir (v2.1.234+)[^227]
CLAUDE_CODE_GOAL_CHECKIN_MINUTES=30             # How long background tasks may keep a /goal waiting before Claude checks in on them; 0 disables (v2.1.234+)[^227]
CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION=200       # Per-session subagent-spawn cap (default 200 in v2.1.212–223; the default cap was REMOVED in v2.1.224 — set this to reimpose one)[^206][^218]
CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS=20         # Cap on concurrently-RUNNING subagents (default 20; distinct from the per-session total above; v2.1.217+)[^211]
CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS=0        # Disable the v2.1.229 workflow fan-out stagger (same-prefix sibling agents launch staggered so they read the cached prompt prefix instead of re-paying it)[^224]
CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS=64   # Raise the Workflow tool's per-run concurrent agent limit, 1-256, for inference-bound fan-outs (v2.1.269+)[^252]
CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL=sonnet         # Run every workflow agent on one model while other subagents keep theirs (v2.1.296; release-notes only as of 2026-10-14)[^274][^280]
CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=3          # Nested subagent spawn depth. Default 3 as of v2.1.219; set 1 to disable nesting. Default history: 5 (v2.1.172–v2.1.216) → 1 (v2.1.217) → 3 (v2.1.219). Set it explicitly[^211][^213]

Configuración de herramientas:

BASH_DEFAULT_TIMEOUT_MS=30000                   # Bash command timeout (30s)
BASH_MAX_TIMEOUT_MS=600000                      # Maximum bash timeout (10min)
BASH_MAX_OUTPUT_LENGTH=50000                    # Read-back window from the Bash working output file (default 30,000 chars, hard ceiling 150,000)
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1     # Reset CWD after each bash
MCP_TIMEOUT=5000                                # MCP server startup timeout
MCP_TOOL_TIMEOUT=30000                          # MCP tool execution timeout
MAX_MCP_OUTPUT_TOKENS=25000                     # MCP output limit
CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH=8192     # Override the cap on MCP tool descriptions and server instructions, every server in the session: 4,096 chars since v2.1.296, 2,048 in v2.1.280-295; Anthropic's first-party servers at api.anthropic.com are uncut since v2.1.299[^279][^256][^274]
CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS=120000       # Threshold before a long MCP tool call moves to the background (default 2 min; v2.1.212+)[^206]
CLAUDE_CODE_MCP_STARTUP_WAIT_MS=10000           # Bound how long the FIRST non-interactive turn waits for still-connecting MCP servers; 0 = don't wait (v2.1.274+)[^254]
CLAUDE_CODE_TOOL_MEMORY_LIMIT=4096              # Opt-in Linux memory cgroup (MB) for Bash tool commands — a runaway build can't stall the session (v2.1.233+)[^226]
CLAUDE_CODE_ENABLE_TODO_TOOLS=1                 # Offer the TodoWrite/TaskCreate-family tools on models outside v2.1.268's allowlist (Claude 3.x, Opus 4.0-4.7, Sonnet 4.0-4.6, Haiku 4.5); elsewhere they are off unless set (first turned off on newer models in v2.1.233)[^226][^252]
SLASH_COMMAND_TOOL_CHAR_BUDGET=15000            # Slash command context limit

Límite de tiempo de los comandos en segundo plano (v2.1.285, acotado en v2.1.288): los comandos de Bash y PowerShell en segundo plano se detienen al alcanzar un límite de tiempo, que es su timeout cuando se ejecutan con run_in_background (30 minutos por defecto, 2 horas como máximo), y Claude recibe una notificación cada vez que se detiene uno.²²⁹ A partir de v2.1.288, el límite solo se aplica en sesiones desatendidas (-p, el Agent SDK, CI y sesiones en la nube); las sesiones de terminal, de la aplicación de escritorio y de VS Code no tienen límite para los comandos en segundo plano. La referencia de herramientas lo confirma: «Antes de v2.1.288, se aplicaba en todas las sesiones».²³⁴²³⁷

Red y proxy:

HTTP_PROXY=http://proxy:8080                    # HTTP proxy
HTTPS_PROXY=https://proxy:8080                  # HTTPS proxy
CLAUDE_CODE_GZIP_REQUEST_BODIES=0              # Turn off gzip compression of large request bodies sent to api.anthropic.com, on even with telemetry off since v2.1.300[^281][^282]
NO_PROXY=localhost,example.com                  # Bypass proxy for domains
CLAUDE_CODE_CLIENT_CERT=/path/to/cert           # mTLS certificate
CLAUDE_CODE_CLIENT_KEY=/path/to/key             # mTLS private key
CLAUDE_CODE_CLIENT_KEY_PASSPHRASE=pass          # mTLS passphrase

Interfaz y terminal:

CLAUDE_CODE_DISABLE_TERMINAL_TITLE=1            # Don't update terminal title
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL=1             # Skip IDE extension install
CLAUDE_CODE_SHELL=/bin/zsh                      # Override shell detection
USE_BUILTIN_RIPGREP=1                           # Use included ripgrep (default)
CLAUDE_CONFIG_DIR=~/.myconfig                   # Custom config directory; not settable from project-settings env (v2.1.251)[^238]
IS_DEMO=1                                       # Hide sensitive UI elements[^37]
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1          # Disable background tasks and Ctrl+B[^46]
CLAUDE_CODE_TMPDIR=/path/to/tmp                 # Override temp directory; not settable from project-settings env, nor are TMPDIR/TMP/TEMP (v2.1.251)[^50][^238]
CLAUDE_CODE_DISABLE_1M_CONTEXT=1               # Hold ALL native-1M models to 200K via auto-compaction (v2.1.223 widened scope); also the opt-out for the v2.1.287 1M default on Bedrock/Vertex/Foundry/Claude apps gateway[^103][^217][^268]
CLAUDE_CODE_AUTO_COMPACT_WINDOW=200k           # Auto-compact window, 100000 to 1000000 tokens; k and M suffixes since v2.1.304 (200k had set a 100K window), out-of-range values warn[^286][^287]
CLAUDE_CODE_DISABLE_ULTRAREVIEW_TRUST_CHECK=1  # Let claude ultrareview run in a folder you have not trusted where it cannot ask, such as CI; environment only, not a settings env block (v2.1.309+)[^286][^287]
CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS=150000     # Context size at which idle compaction applies, default 200000; values below 100000 are raised to 100000; "idleCompaction": false in settings.json turns the feature off (v2.1.299; the docs date both to v2.1.290+)[^279][^280]
CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1  # Let unrecognized model IDs exceed the assumed context window (v2.1.223)[^217]
CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS=120000       # Plugin marketplace git timeout (default 120s, was 30s)[^105]
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS=1        # Remove built-in commit/PR instructions[^117]
CLAUDE_CODE_DISABLE_CRON=1                    # Stop scheduled cron jobs mid-session[^121]
CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS=30000 # SessionEnd hooks timeout (default varies)[^123]
CLAUDE_CODE_USE_POWERSHELL_TOOL=1             # Enable Windows PowerShell tool on Linux/macOS (requires pwsh on PATH; v2.1.111+)[^153]
CLAUDE_CODE_DISABLE_MOUSE_CLICKS=1           # Disable mouse click/drag/hover in fullscreen mode; wheel scroll still works (v2.1.195+)[^196]
CLAUDE_ENABLE_STREAM_WATCHDOG=0              # Disable the streaming idle watchdog (on by default for all providers since v2.1.196: aborts+retries after 5 min of silence)[^198]
CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP=1 # Turn off automatic memory-pressure reaping of idle background shell commands (v2.1.193+)[^196]
CLAUDE_CODE_ENABLE_AWAY_SUMMARY=1             # Force Session Recap when telemetry disabled (v2.1.108+)[^153]
CLAUDE_CODE_BG_TASKS_REPORT_RUNNING=0         # Restore pre-v2.1.269 behavior: remote/headless sessions may report "waiting for your input" while background agents still run[^252]
CLAUDE_AX_SCREEN_READER=1                     # Enable screen reader mode; same as --ax-screen-reader or "axScreenReader": true (v2.1.208+)[^203]
CLAUDE_AX_PREPARK_MS=50                       # Screen reader mode: pause before writing a changed line; default 0 since v2.1.287 (was 50)[^268][^269]
OTEL_LOG_RAW_API_BODIES=1                     # Emit full API request/response bodies as OTel log events (v2.1.111+)[^153]
TRACEPARENT=00-...                            # W3C Trace Context parent (v2.1.110+, SDK/headless)[^153]
TRACESTATE=vendor=value                       # W3C Trace Context state (v2.1.110+, SDK/headless)[^153]

Exportadores de OpenTelemetry + control de campos sensibles:²⁶⁸

OTEL_LOGS_EXPORTER=none                       # OTel logs exporter (supports 'none' for disable; v2.1.85 fixed crash)
OTEL_METRICS_EXPORTER=none                    # OTel metrics exporter (supports 'none'; v2.1.85 fixed crash)
OTEL_TRACES_EXPORTER=none                     # OTel traces exporter (supports 'none'; v2.1.85 fixed crash)
OTEL_LOG_TOOL_CONTENT=1                       # Opt in to emitting tool content in OTel spans (v2.1.101+, sensitive by default)
OTEL_LOG_TOOL_DETAILS=1                       # Opt in to tool_parameters in OTel tool_result events (v2.1.85+); as of v2.1.273 also puts real agent, skill, plugin, and MCP server names on cost and token metrics[^253]
OTEL_LOG_USER_PROMPTS=1                       # Opt in to emitting user prompts in OTel traces (v2.1.101+, sensitive by default)
OTEL_LOG_ASSISTANT_RESPONSES=0                # Gate the claude_code.assistant_response log event holding the model's response text (v2.1.193+)
OTEL_METRICS_INCLUDE_REPOSITORY=1             # Tag OTel metrics and events with vcs.* repository attributes; with OTEL_LOG_TOOL_DETAILS, commit events carry vcs.ref.head.* (v2.1.269+)[^252]
CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH=60000     # Truncation limit for OTel content attributes (default 60 KB; v2.1.214+)[^207]
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1    # Disable release-notes fetch (v2.0.17+); v2.1.110 also stopped the auto-title Haiku request in headless/SDK when set; v2.1.290 also skips the startup connection warm-up[^271]
CLAUDE_CODE_ATTRIBUTION_HEADER=0              # Omit the system-prompt attribution block; behind a Claude apps gateway, set it in the env of the gateway's code or cli policy (v2.1.299+)[^279][^280]

La configuración del proyecto no puede activar la telemetría (v2.1.282): los archivos de configuración del proyecto y locales ahora ignoran las variables de OpenTelemetry que activan la exportación, definen su endpoint o capturan contenido, como CLAUDE_CODE_ENABLE_TELEMETRY, los selectores OTEL_*_EXPORTER y OTEL_LOG_*. Los valores que desactivan algo (none para un selector de exportador, 0 para un flag de contenido) siguen aplicándose desde esos archivos. Define el resto en tu shell, en la configuración de usuario o en la configuración administrada. Una sesión interactiva muestra un aviso al iniciar cuando un archivo del proyecto define una de estas variables, y /status y claude doctor listan los nombres ignorados; las sesiones con -p y del Agent SDK no muestran ningún aviso, así que comprueba que tu collector siga recibiendo datos después de actualizar.²²⁵²²⁷

Atributos de spans por solicitud a LLM en v2.1.121+: stop_reason, gen_ai.response.finish_reasons y user_system_prompt ahora se emiten en los spans de solicitud a LLM. user_system_prompt está condicionado a OTEL_LOG_USER_PROMPTS=1, ya que puede contener PII.¹⁵⁴

Cambios a nivel de evento en v2.1.122+: los atributos numéricos de los eventos de log api_request y api_error ahora se emiten como números (antes eran cadenas), lo que corrige los collectors de OTel posteriores que tipaban el esquema de forma estricta. El nuevo evento de log claude_code.at_mention se dispara cuando Claude Code resuelve una mención con @.¹⁵⁴

Atributos de v2.1.300: los eventos api_request dividen las escrituras de caché en cache_creation_5m_tokens y cache_creation_1h_tokens; los spans de traza llevan atributos de las convenciones semánticas de GenAI (gen_ai.provider.name, gen_ai.conversation.id, gen_ai.tool.name, error.type); los eventos user_prompt y los spans de interacción registran el prompt tal como lo reescribió el hook prompt.submit de un mod; y los eventos tool_result llevan git_commit_id después de git commit -q en repositorios reftable.²⁷³

Atributos de v2.1.301 y v2.1.302: los eventos tool_decision llevan classifier_verdict y permission_mode, de modo que se puede distinguir una decisión del clasificador del modo automático de una regla de permisos, y, con OTEL_LOG_TOOL_DETAILS=1, classifier_category, que nombra la regla integrada con la que coincidió un bloqueo del clasificador (v2.1.301); v2.1.302 completa classifier_category en la mayoría de los bloqueos del clasificador, donde faltaba, y conserva tool_use_id, tool_source y tool_parameters en el evento cuando OTEL_LOGRECORD_ATTRIBUTE_COUNT_LIMIT es bajo. La documentación de monitoreo todavía no lista los tres atributos.²⁷⁵²⁷⁶

Evento de v2.1.307: claude_code.safety_event se dispara por cada llamada a herramienta que una regla de permisos, el modo automático, una verificación de seguridad, un hook o el sandbox detuvo, sometió a confirmación o devolvió; incluye tool_use_id salvo en los eventos de fin de turno. La documentación de monitoreo lo lista y ahora también lista classifier_verdict (v2.1.301+).²⁷⁸²⁷⁹

Evento de log claude_code.assistant_response en v2.1.193+: Claude Code puede emitir el texto completo de la respuesta del modelo como un evento de log de OTel, condicionado por OTEL_LOG_ASSISTANT_RESPONSES. Este condicionamiento tiene una trampa al actualizar que conviene conocer: cuando OTEL_LOG_ASSISTANT_RESPONSES no está definida, sigue a OTEL_LOG_USER_PROMPTS, por lo que cualquier despliegue que ya registre el contenido de los prompts empezará a recibir el contenido de las respuestas del asistente al actualizar. Define OTEL_LOG_ASSISTANT_RESPONSES=0 para que la telemetría registre solo los prompts.¹⁷⁹

Novedades de telemetría en v2.1.214: los eventos de log de OTel ahora llevan los atributos message.uuid, client_request_id y tool_source para correlacionar a nivel de mensaje y conocer la procedencia de las herramientas; el payload de subagentStatusLine incluye el esfuerzo de razonamiento del subagente, de modo que las filas personalizadas de la línea de estado pueden mostrar juntos el modelo y el esfuerzo; y la nueva variable de entorno CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH configura el límite de truncamiento de 60 KB en los atributos de contenido de OTel.¹⁹⁰

Telemetría del gateway en v2.1.265: las sesiones del gateway de apps de Claude ahora exportan OpenTelemetry directamente a un collector cuando la configuración administrada del gateway nombra uno en OTEL_EXPORTER_OTLP_ENDPOINT, en lugar de pasar por el relay del gateway; las sesiones sin un collector definido siguen usando el relay. La misma versión agrega user.email y user.groups a la telemetría que Claude Desktop y Cowork envían a través de un gateway de apps de Claude, igual que en las sesiones de terminal.²¹⁵

Telemetría de hooks en v2.1.280: el evento de OTel hook_execution_complete ahora incluye el tamaño de la salida de los hooks y el número de salidas demasiado grandes que se guardaron en un archivo.²²⁰

prompt_text en v2.1.287: el evento user_prompt ahora lleva prompt_text, una copia de prompt para los backends que anidan las claves con puntos. Dondequiera que tu pipeline descarte o enmascare prompt, haz lo mismo con prompt_text.²³²

API / Control del modelo:²⁶⁸

CLAUDE_CODE_EXTRA_BODY='{...}'                # Inject extra body fields into API calls; v2.1.113 fixed 400 errors with output_config.effort on Vertex/subagent calls
CLAUDE_CODE_MAX_CONTEXT_TOKENS=200000         # Override max context tokens (pre-existing var; v2.1.98 fixed handling of DISABLE_COMPACT when both are set)
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS=25000 # Override default token limit for file read operations (v2.1.0+); a Read call with allow_large can pass it when the context has room (v2.1.296+)[^274][^276]
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK=1   # Do not fall back to non-streaming API on streaming failures (v2.1.83+)
CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS=1      # Stop sending structured outputs, for Mantle or gateways that reject them; session titles, memory recall, and prompt hooks failed there before (v2.1.288+)[^270][^273]
ANTHROPIC_BETAS=beta1,beta2                   # Enable beta API headers; v2.1.78 fixed silent ignore on Haiku models
ANTHROPIC_SMALL_FAST_MODEL=arn:...            # Fast model ID (Bedrock ARN supported; v0.2.125 stopped escaping slashes in ARN)

Plugins / MCP:²⁶⁸

CLAUDE_CODE_PLUGIN_CACHE_DIR=~/.claude/plugins # Plugin cache directory (v2.1.72 fixed literal '~' dir on some shells)
CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1 # Preserve plugin marketplace cache when git pull fails (offline-friendly; v2.1.90+)
CLAUDE_CODE_MCP_SERVER_NAME=server1           # Passed to MCP headersHelper scripts so one helper can serve multiple servers (v2.1.85+)
CLAUDE_CODE_MCP_SERVER_URL=https://...        # Passed to MCP headersHelper scripts alongside the name (v2.1.85+)
MCP_SDK_GENERATION=v1                         # Opt out of the v2 MCP client; v2.1.274 made v2 the default on the last holdouts (Bedrock/Vertex/Foundry + telemetry-disabled installs)[^254]
MCP_PROTOCOL_NEGOTIATION=legacy               # Opt out of MCP 2026-07-28 protocol negotiation: with direct HTTP servers (default everywhere as of v2.1.274) and, since v2.1.292, with local (stdio) servers on every install, Bedrock, Vertex, and Foundry included and, since v2.1.299, with cloud session and Remote Control connectors[^279][^254][^272]

Shell / IDE:²⁶⁸

CLAUDE_CODE_SHELL_PREFIX="time "              # Wrap every Claude-invoked shell command with a prefix (v1.0.61+)
CLAUDE_CODE_GIT_BASH_PATH=C:\Program\ Files\Git\bin\bash.exe  # Custom Git Bash path on Windows (v2.1.98+)
CLAUDE_CODE_EXIT_AFTER_STOP_DELAY=60000       # SDK: exit after N ms idle (v2.0.35+)
CLAUDE_CODE_AUTO_CONNECT_IDE=false            # Disable IDE auto-connection (v1.0.61+)

Empresas / autenticación:²⁶⁸

CLAUDE_CODE_PROXY_RESOLVES_HOSTS=1            # Opt into proxy-side DNS resolution (v2.0.55 moved this from default-on to opt-in)
CLAUDE_CODE_API_KEY_HELPER_TTL_MS=300000      # TTL for dynamically generated API keys via apiKeyHelper (apiKeyHelper refresh added v0.2.74 with 5-min default; env var added v0.2.117)
CLAUDE_CODE_PROCESS_WRAPPER=/path/to/wrapper  # Route all Claude Code self-spawned processes through a wrapper executable; same as the processWrapper setting (v2.1.208+)[^203]

Variables de skills (v2.1.69+):

${CLAUDE_SKILL_DIR}                            # Self-reference for skills to locate their own directory[^117]

Identidad del llamador del SDK (v2.1.51+):

CLAUDE_CODE_ACCOUNT_UUID=uuid                  # Provide account UUID synchronously for SDK callers
CLAUDE_CODE_USER_EMAIL=user@example.com        # Provide user email for SDK callers
CLAUDE_CODE_ORGANIZATION_UUID=uuid             # Provide organization UUID for SDK callers

Depuración:

ANTHROPIC_LOG=debug                             # Enable API request logging

¿Qué modelo debería elegir?

Elegir el modelo adecuado para cada tarea influye considerablemente tanto en el costo como en la calidad. Claude Code te permite cambiar de modelo con flexibilidad en varios niveles.

Modelos disponibles

Claude Sonnet 5.5 (28 de septiembre de 2026): El modelo Sonnet predeterminado en la API de Anthropic desde v2.1.284, que hace que el alias sonnet apunte a él; el modelo predeterminado en todos los planes sigue siendo Opus 5.5. ID del modelo: claude-sonnet-5-5 (Bedrock: anthropic.claude-sonnet-5-5). $2/MTok de entrada, $10/MTok de salida, igual que Sonnet 5, con lecturas de caché a $0,10/MTok (0,05 veces el precio de entrada según la página de precios, la misma proporción que en Opus 5.5; v2.1.296 corrige las cifras de costos de Claude Code, que usaban $0,20). Ventana de contexto de 1M de tokens, salida máxima de 128K (hasta 300K en la API de Batches con el encabezado beta output-300k-2026-03-24). Fecha de corte del conocimiento confiable: junio de 2026, igual que Opus 5.5 y Fable 5.1. Retiro no antes del 28 de septiembre de 2027. En Claude Code, effort tiene el valor predeterminado medium para Sonnet 5.5 (el valor predeterminado de la propia API de Claude es high), y el razonamiento no se puede desactivar. Modelo alternativo según el contenido: una solicitud marcada por ciberseguridad se vuelve a ejecutar en Sonnet 5, y una solicitud marcada por biología termina con un rechazo porque Sonnet 5.5 no tiene un modelo alternativo para biología. Requiere Claude Code v2.1.284 o posterior; para seguir usando Sonnet 5, fija ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5.²²⁸²³⁰

La página del modelo enumera cinco cambios incompatibles con versiones anteriores para el código de la API que migra desde Sonnet 5: el razonamiento inicial se desactiva con between_tools, el uso forzado de herramientas devuelve un error, los bloques de razonamiento están vinculados al modelo y a la conversación, computer_20251124 no se acepta en la API de Claude ni en Google Cloud, y la herramienta de asesoría rechaza a Opus 4.8, Opus 4.7 y Sonnet 5 como asesores. El texto entre llamadas a herramientas también se devuelve en bloques thinking, por lo que una interfaz que lo transmite en tiempo real deja de mostrarlo hasta que establezca un valor de display que devuelva el texto.²³⁰

Claude Opus 5.5 (22 de septiembre de 2026): El nuevo modelo Opus predeterminado en Claude Code desde v2.1.280 – y, según la tabla por plan de la documentación de configuración de modelos, el modelo predeterminado en todos los planes y proveedores propios: Pro, Max, Team, Enterprise, la API de Anthropic, Claude Platform on AWS, Amazon Bedrock y Agent Platform de Google Cloud (Microsoft Foundry sigue con Sonnet 4.5, y su alias opus apunta a Opus 4.6). La misma versión cambia el modelo predeterminado de Pro y Team Standard de Sonnet a Opus, “igualando a Max, Team Premium y Enterprise” – lo que pone fin a la diferencia entre planes que existía desde que el nivel prémium pasó a Opus. ID del modelo: claude-opus-5-5 (Bedrock: anthropic.claude-opus-5-5) – una versión fija sin fecha, con el mismo esquema que claude-opus-5. Los precios bajan respecto a Opus 5: $4/MTok de entrada, $20/MTok de salida (Opus 5: $5/$25), con lecturas de caché a $0,20/MTok – el 5% del precio de entrada, la mitad del 10% habitual (solo Fable 5.1 y Mythos 5.1 tienen una proporción menor, del 2,5%). Ventana de contexto de 1M de tokens, salida máxima de 128K (hasta 300K en la API de Batches con el encabezado beta output-300k-2026-03-24). Razonamiento adaptativo siempre activo – la tabla general de modelos le asigna la misma descripción, “Adaptativo (siempre activo)”, que a Fable, en lugar del funcionamiento de Opus 5, activo de forma predeterminada pero que se podía desactivar. effort tiene el valor predeterminado medium (en Opus 5 era high), y v2.1.280 ajusta la regla de conservación de valores para reflejarlo: un nivel de esfuerzo guardado antes de que /effort se configurara por modelo ya no se aplica a modelos recién lanzados como Opus 5.5 – el modelo comienza con su propio valor predeterminado hasta que elijas un nivel. Fecha de corte del conocimiento confiable: junio de 2026 (los datos de entrenamiento también llegan a junio de 2026), empatado con Fable 5.1 como el más reciente entre todos los modelos actuales. Retiro no antes del 22 de septiembre de 2027. Requiere Claude Code v2.1.280 o posterior.²²⁰²²¹

Cambios incompatibles con versiones anteriores al migrar código de la API de Opus 5 a Opus 5.5:²²²

1. El razonamiento no se puede desactivar. Tanto thinking: {type: "disabled"} como thinking: {type: "enabled", budget_tokens: N} devuelven un error 400. Elimina el campo thinking y elige un nivel de esfuerzo en su lugar.
2. El uso forzado de herramientas devuelve un error. tool_choice solo acepta auto y none; any y tool devuelven un error 400, incluso en el endpoint de recuento de tokens. Usa auto con uso estricto de herramientas o salidas estructuradas.
3. Los bloques de razonamiento están vinculados al modelo. Un enrutador o mecanismo de respaldo que traslada una conversación de Opus 5.5 a otro modelo ejecuta esos turnos sin los bloques de razonamiento de Opus 5.5 (Fable 5.1 y Mythos 5.1 en la API de Claude son la excepción).
4. computer_20251124 se rechaza en la API de Claude y en Google Cloud. Declara el conjunto de herramientas computer_toolset_20260801 en su lugar; Bedrock conserva la herramienta anterior. Otro cambio no provoca el fallo de ninguna solicitud, pero sí modifica la estructura de la respuesta: el texto que el modelo escribe entre llamadas a herramientas se devuelve en bloques thinking, vacíos con la configuración predeterminada de display. Una interfaz que transmite esa narración deja de mostrarla hasta que se configura display: "updates" (beta) o "summarized".²²²

Cambio a un modelo alternativo según el contenido en Claude Code. Opus 5.5 funciona con clasificadores de seguridad que señalan con mayor frecuencia contenido de biología y ciberseguridad. Cuando uno señala una solicitud, Claude Code vuelve a ejecutarla en otro modelo y muestra un aviso: las solicitudes señaladas por contenido de biología pasan a Opus 5, las de ciberseguridad a Opus 4.8, y la sesión permanece en el modelo alternativo hasta que vuelvas a cambiarlo con /model. Desactiva Cambiar de modelo cuando se señale un mensaje en /config (switchModelsOnFlag: false) para que te pregunte cada vez.²²³ A partir de v2.1.287, el cambio conserva tu nivel de esfuerzo actual en lugar de usar el predeterminado del modelo alternativo; así, una sesión con el valor predeterminado medium de Opus 5.5 permanece en medium al pasar a Opus 4.8, cuyo valor predeterminado es high.²³²²³³

Claude Opus 5 (julio de 2026; nivel Opus anterior): El nivel Opus y el modelo al que apuntaba el alias opus desde v2.1.219 (24 de julio de 2026) hasta que v2.1.280 convirtió a Opus 5.5 en el modelo Opus predeterminado; lo que sigue describe su situación en el lanzamiento de julio de 2026. Anthropic lo presenta como una actualización que puede sustituir directamente a Opus 4.8: los mismos $5/MTok de entrada y $25/MTok de salida, «un rendimiento mucho mayor por el mismo costo» y aproximadamente un 26% menos de tokens en promedio con el razonamiento al máximo que Opus 4.8. Era el modelo predeterminado en Claude Max y el más potente en Claude Pro. ID del modelo: claude-opus-5 — una versión fijada sin fecha, con el mismo esquema que claude-opus-4-8 y claude-sonnet-5, no una referencia que se actualiza continuamente. Ventana de contexto de 1M de tokens (sin encabezado beta, igual que en Opus 4.8), salida máxima de 128K (hasta 300K en la API de Batches con el encabezado beta output-300k-2026-03-24). Solo admite razonamiento adaptativo — no admite el razonamiento extendido con thinking.type: "enabled". Fecha de corte del conocimiento fiable: mayo de 2026 (los datos de entrenamiento también llegan hasta mayo de 2026) – la más reciente entre todos los modelos vigentes de Claude desde su lanzamiento hasta la llegada de Fable 5.1 (con fecha de corte en junio de 2026) el 1 de septiembre de 2026.²⁴¹ Con la llegada de Opus 5, Opus 4.8 pasa a la tabla de modelos anteriores de la documentación junto con 4.7 y 4.6 — sigue disponible, pero ya no es la opción predeterminada recomendada.¹⁹⁷

Dos cambios incompatibles al migrar un entorno de ejecución de Opus 4.8 a Opus 5:¹⁹⁷

1. El razonamiento está activado de forma predeterminada. En Opus 4.8, una solicitud sin el campo thinking se ejecutaba sin razonamiento; en Opus 5, la misma solicitud se ejecuta con razonamiento adaptativo. max_tokens sigue siendo un límite estricto para la salida total — razonamiento más texto de respuesta —, así que vuelve a comprobar el margen disponible en cualquier carga de trabajo que antes se ejecutara sin razonamiento. Envía thinking: {type: "disabled"} para restaurar el comportamiento anterior, sujeto a lo que se explica en el siguiente punto.
2. Con el razonamiento desactivado, el esfuerzo máximo permitido es high. Combinar thinking: {type: "disabled"} con el esfuerzo xhigh o max devuelve un 400. La comprobación se aplica a cada solicitud: aumentar el esfuerzo a xhigh mientras el razonamiento está desactivado provoca un rechazo, aunque se hayan aceptado turnos anteriores de la misma conversación.

En Claude Code en particular: effort tiene el valor predeterminado high en Opus 5 (al igual que en la API de Claude), y está disponible toda la escala — low, medium, high, xhigh, max. La propia guía de migración de Anthropic recomienda probar el esfuerzo max cuando la capacidad importe más que el gasto en tokens. El modo rápido admite Opus 5 a $10/$50 por MTok (consulta Modo rápido).¹⁹⁷¹⁹⁸

Claude Fable 5.1 (1 de septiembre de 2026): El nuevo modelo superior del nivel Fable y, a partir de v2.1.257, el modelo al que apunta el alias fable (a menos que ANTHROPIC_DEFAULT_FABLE_MODEL fije otro); best ahora significa «el modelo Fable más reciente al que tengas acceso». La versión mínima requiere una aclaración: la documentación de configuración de modelos dice que el alias cambió en v2.1.255, y la página del modelo indica que Fable 5.1 «requiere Claude Code v2.1.255 o posterior», pero las versiones 2.1.253-256 nunca se publicaron en npm – v2.1.257 (1 de septiembre) es la primera versión instalable que lo incluye. ID del modelo: claude-fable-5-1 (Bedrock: anthropic.claude-fable-5-1). Mismo nivel y precio por token que Fable 5 – $10/MTok de entrada, $50/MTok de salida, contexto de 1M, salida máxima de 128K, razonamiento adaptativo siempre activo, effort con valor predeterminado high – con un cambio de precio relevante para las sesiones largas con agentes: las lecturas de caché cuestan $0,25/MTok, 0,025 veces el precio de entrada (2,5%), frente al 10% estándar; solo Fable 5.1 y Mythos 5.1 tienen esa tarifa, y las escrituras en caché mantienen el precio estándar ($12,50 para 5 minutos, $20 para 1 hora). Fecha de corte del conocimiento fiable: junio de 2026 (los datos de entrenamiento también llegan hasta junio de 2026) – la más reciente entre todos los modelos vigentes de Claude, igualada por Opus 5.5 (con fecha de corte en junio de 2026) el 22 de septiembre de 2026 y por Sonnet 5.5 el 28 de septiembre. No se retirará antes del 1 de septiembre de 2027. Desde v2.1.301, cuando el modelo Fable más reciente no está disponible para tu organización, fable y best reintentan una vez con el modelo Fable anterior en lugar de devolver un error.²⁷⁵

Tres cambios incompatibles respecto de Fable 5: forzar el uso de herramientas devuelve un error, los modelos anteriores no pueden leer sus bloques de razonamiento y editar turnos anteriores invalida esos bloques. Cinco incorporaciones: esfuerzo por mensaje (beta), mensajes de sistema limitados a un turno (beta), actualizaciones de progreso entre llamadas a herramientas (display: "updates", beta), lecturas de caché más baratas y procedencia del contenido. Claude Mythos 5.1 es el mismo modelo con las mismas especificaciones, disponible solo por invitación a través de Project Glasswing. Con el lanzamiento, Fable 5 pasa a la tabla de modelos anteriores de la documentación junto con Opus 4.8/4.7/4.6/4.5 y Sonnet 4.6/4.5.

Una salvedad sobre la puerta de enlace en las notas de la versión: en las sesiones que pasan por la puerta de enlace de las aplicaciones de Claude, fable y best siguen apuntando a Fable 5 por ahora – una puerta de enlace que aún no está configurada para 5.1 lo rechaza –, así que selecciona Fable 5.1 explícitamente en /model en esas sesiones; ten en cuenta que, antes de v2.1.260, el selector /model no mostraba Fable 5.1, por lo que seleccionarlo explícitamente implicaba escribir el comando completo /model claude-fable-5-1 (consulta las correcciones posteriores al lanzamiento más abajo). Modelos predeterminados por plan en el momento del lanzamiento: Opus 5 en los planes prémium, Sonnet 5 en Pro y Team Standard – reemplazados por Opus 5.5 como modelo predeterminado en todos los planes en v2.1.280 (22 de septiembre de 2026).^211241242221

Correcciones posteriores al lanzamiento de Fable 5.1 (v2.1.260, 3 de septiembre): la primera versión posterior al lanzamiento corrige cuatro problemas. El selector /model ahora muestra Fable 5.1 para las organizaciones que pueden usarlo – antes de esta corrección, el modelo solo se aceptaba al escribir el comando completo /model claude-fable-5-1. El almacenamiento de prompts en caché de Fable 5.1 ahora incluye el contexto adjunto después de los resultados de las herramientas, que antes se reenviaba como entrada sin caché en cada turno con llamadas a herramientas – lo que reducía silenciosamente el ahorro de las lecturas de caché a 0,025 veces el precio de entrada, precisamente en las sesiones largas con agentes para las que está pensado. Cambiar /effort durante una sesión ya no invalida la caché de prompts. Además, los agentes con model: fable ahora respetan la etiqueta [1m] en un modelo fijado mediante ANTHROPIC_DEFAULT_FABLE_MODEL, en lugar de ejecutarse silenciosamente con una ventana de contexto de 200K.²¹²

Claude Fable 5 (9 de junio de 2026; modelo anterior desde el 1 de septiembre de 2026): Un nuevo nivel de modelo por encima de Opus — el modelo más potente e inteligente de Anthropic, con resultados de vanguardia en casi todas las pruebas de referencia en las que se ha evaluado y diseñado para mantener la coherencia a lo largo de millones de tokens de contexto. Fable 5 es el modelo de frontera de «clase Mythos» adaptado para un uso general seguro: incluye clasificadores de seguridad que recurren a Opus 4.8 ante consultas de ciberseguridad, biología y química, y destilación de modelos (Claude Mythos 5 es el mismo modelo con esas salvaguardas desactivadas para investigadores autorizados). Se pudo seleccionar en Claude Code a partir de v2.1.170 (9 de junio de 2026) — ejecuta claude update y luego /model fable (el alias corto, que desde v2.1.257 apunta a Fable 5.1 – hoy puedes seleccionar Fable 5 con /model claude-fable-5) — y su implementación en los planes de suscripción se completó el 22 de junio de 2026. ID del modelo: claude-fable-5. Fable 5 incluye una ventana de contexto de 1M de forma predeterminada, por lo que el sufijo [1m] es innecesario — y, a partir de v2.1.173 (11 de junio de 2026), el nombre de modelo claude-fable-5[1m] se normaliza automáticamente a claude-fable-5, eliminando el sufijo (este solo tenía sentido en Opus/Sonnet, que requieren [1m] para habilitar 1M); salida máxima de 128K. El precio es de $10/MTok de entrada y $50/MTok de salida — aproximadamente 2 veces el de Opus 4.8 —, así que resérvalo para razonamiento realmente difícil, no para ediciones rutinarias. Comparte los parámetros de solicitud de Opus 4.8 (solo razonamiento adaptativo; se eliminaron temperature/top_p/top_k y budget_tokens), con una nueva particularidad: enviar explícitamente thinking: {type: "disabled"} devuelve un 400, así que omite por completo el parámetro thinking para ejecutarlo sin razonamiento.²⁶¹ En Claude Code específicamente: Fable 5 admite toda la escala de esfuerzo (low/medium/high/xhigh/max, con high de forma predeterminada), al igual que Opus 5. El razonamiento no se puede desactivar en Fable 5 — el interruptor de razonamiento de la sesión, la opción alwaysThinkingEnabled y MAX_THINKING_TOKENS=0 no tienen ningún efecto; siempre razona de forma adaptativa. La familia fable cuenta con un conjunto completo de opciones de configuración equivalente al de Opus: ANTHROPIC_DEFAULT_FABLE_MODEL fija el modelo al que apunta el alias fable (útil en Bedrock/Vertex/Foundry), DISABLE_PROMPT_CACHING_FABLE excluye a Fable del almacenamiento de prompts en caché y, en las pasarelas empresariales, se aplica el cambio automático a un modelo alternativo según el contenido. /model opus ahora selecciona Opus 5.5 (v2.1.280; esfuerzo medium de forma predeterminada, /effort xhigh para las tareas más difíciles), y el modelo predeterminado inicial ya no depende de tu plan – Opus 5.5 es el predeterminado en todos los planes operados por Anthropic, con la excepción de Microsoft Foundry; elige expresamente la gama Fable mediante /model fable cuando quieras la máxima capacidad disponible – que, desde v2.1.257, corresponde a Fable 5.1.^{261197207242220221}

Opus 4.7 (16 de abril de 2026): El modelo insignia de la generación anterior, que sigue plenamente disponible. Ventana de contexto de 1M de tokens a precio estándar — sin recargo por contexto largo. Salida máxima de 128K, solo razonamiento adaptativo (se eliminó el razonamiento extendido) y un nuevo nivel de esfuerzo xhigh, recomendado como punto de partida para programación y cargas de trabajo con agentes.¹⁴⁵ Fecha límite de conocimiento confiable: enero de 2026. Fecha límite de los datos de entrenamiento: enero de 2026. ID del modelo: claude-opus-4-7. Los precios son los mismos que los de Opus 4.6: $5/$25 por MTok, con escritura en caché de 5 min a $6,25, escritura en caché de 1 h a $10 y lectura de caché a $0,50 por MTok.¹⁴⁴ Opus 4.7 resuelve 3× más tareas de producción en SWE-Bench que Opus 4.6, obtiene un 70% en CursorBench (frente al 58% de 4.6) y mejora la tasa de resolución un 13% en la evaluación interna de programación de Anthropic, que consta de 93 tareas.¹⁴⁴ Usa un nuevo tokenizador — calcula aproximadamente entre 1× y 1,35× más tokens para el mismo texto; aumenta el margen de max_tokens y los umbrales que activan la compactación.¹⁴⁵ La capacidad de visión admite imágenes de hasta 2.576 px / 3,75 MP con coordenadas de píxeles 1:1.¹⁴⁵

Evaluaciones de programación de Opus 4.7 (abril de 2026):¹⁵¹

Modelo predeterminado por plan (Claude Code):²⁰⁷²²¹

Desde v2.1.280 (22 de septiembre de 2026), desapareció la distinción por plan: todos los planes operados por Anthropic y los proveedores directos usan Opus 5.5 de forma predeterminada, y la única excepción que queda es Microsoft Foundry. La pregunta que antes más importaba aquí – «¿qué plan tengo?» – ya no cambia la respuesta.

Cambios incompatibles en la API de Messages para Opus 4.7 (visibles para quien realiza la llamada):¹⁴⁵

• Se eliminó budget_tokens del razonamiento extendido. Usa thinking: {type: "adaptive"} en su lugar. El razonamiento adaptativo está desactivado de forma predeterminada; las solicitudes sin el campo thinking se ejecutan sin razonamiento.
• Configurar temperature, top_p o top_k con un valor distinto del predeterminado devuelve HTTP 400. Omite estos parámetros y guía al modelo mediante prompts.
• El contenido del razonamiento se omite de las respuestas de forma predeterminada. Configura thinking.display: "summarized" para volver a mostrar el razonamiento (es necesario si tu producto transmite el razonamiento a los usuarios en tiempo real).

Los presupuestos de tareas (encabezado beta task-budgets-2026-03-13) te permiten indicarle al modelo un objetivo de tokens para un ciclo completo de agente mediante output_config.task_budget; el mínimo es de 20K tokens.¹⁴⁵

Opus 4.6 (versión anterior): Sigue disponible como claude-opus-4-6, con un contexto de 1M y una salida máxima de 128K. Considera migrar a Opus 4.7 para mejorar la programación con agentes. Opus 4.6 se lanzó originalmente el 5 de febrero de 2026.⁷⁹¹⁴⁴ Desde v2.1.117 (22 de abril de 2026), los suscriptores de Pro y Max usan el esfuerzo high de forma predeterminada en Opus 4.6 y Sonnet 4.6 (antes era medium); Opus 4.7 se mantiene en xhigh. Este cambio recuperó la capacidad de razonamiento tras la reducción de esfuerzo del 4 de marzo → 7 de abril, documentada en el análisis del incidente del 23 de abril.¹⁵²¹⁵³

Sonnet 5 (30 de junio de 2026; versión anterior de la gama Sonnet): El modelo que seleccionaba el alias sonnet en la API de Anthropic desde v2.1.197 hasta que v2.1.284 lo cambió a Sonnet 5.5. En su lanzamiento, Anthropic lo presentó como «la mejor combinación de velocidad e inteligencia». Anthropic afirma que su rendimiento es cercano al de Opus 4.8, pero a precios más bajos, y supone una mejora sustancial respecto de Sonnet 4.6 en razonamiento con agentes, uso de herramientas, programación y trabajo del conocimiento — a la vez que presenta una menor tasa general de comportamientos indeseables y una capacidad de ciberseguridad mucho menor que la de los modelos Opus (el equilibrio de seguridad que permitió lanzarlo sin bloqueos por controles de exportación). ID del modelo: claude-sonnet-5 (versión fija sin fecha). Ventana de contexto de 1M de tokens, salida máxima de 128K (hasta 300K en la API de Batches con el encabezado beta output-300k-2026-03-24), solo razonamiento adaptativo. Fecha límite de conocimiento confiable: enero de 2026. Precios: $2/$10 por MTok de entrada/salida, ahora el precio de lista estándar. Anthropic anunció $2/$10 en el lanzamiento como precio introductorio hasta el 31 de agosto de 2026 y luego lo mantuvo: la página de precios indica que el aumento a $3/$15 previsto para el 1 de septiembre «no se realizará», y v2.1.243 actualizó el selector /model y la skill claude-api incluida para mostrar $2/$10 como precio de lista en lugar de una promoción por tiempo limitado.²⁵¹ Es un 50% menos que los $4/$20 de Opus 5.5 (y un 60% menos que los $5/$25 que costaba Opus 5). En Claude Code, el parámetro effort usa high de forma predeterminada en Sonnet 5 (configúralo explícitamente para cambiarlo). Selecciónalo con /model claude-sonnet-5.¹⁸⁰²³⁰

v2.1.197 (30 de junio de 2026) convirtió a Sonnet 5 en el modelo predeterminado de Claude Code para las nuevas sesiones en ese momento, y siguió siéndolo en los planes estándar (Pro, Team Standard) hasta que v2.1.280 cambió esos planes a Opus el 22 de septiembre de 2026. Sonnet 5 ya no es el modelo predeterminado de ningún plan en Claude Code y, desde v2.1.284, /model sonnet selecciona Sonnet 5.5 en la API de Anthropic; /model claude-sonnet-5 o ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 te permiten seguir usando Sonnet 5. Consulta la tabla de planes anterior.^{181207220221228}

Sonnet 4.6 (17 de febrero de 2026, ahora reemplazado por Sonnet 5): Modelo equilibrado; reemplazó a Sonnet 4.5 como predeterminado en claude.ai y Claude Cowork.⁹³ Mismos precios que Sonnet 4.5 ($3/$15 por MTok). Mejoró el rendimiento de las búsquedas con agentes y redujo el consumo de tokens. Admite razonamiento extendido, razonamiento adaptativo y una ventana de contexto de 1M de tokens (beta). Salida máxima de 64K (límite superior de 128K en v2.1.77).¹¹⁹ Fecha límite de conocimiento: agosto de 2025 (confiable), enero de 2026 (datos de entrenamiento). ID del modelo: claude-sonnet-4-6. Claude Mythos Preview (7 de abril de 2026): Un modelo de frontera en versión preliminar de investigación para tareas de ciberseguridad defensiva, ofrecido bajo Project Glasswing.¹³⁹ Solo por invitación; no está disponible para el público general. Anthropic presenta Opus 4.7 como deliberadamente menos capaz que Mythos en ciberseguridad —una concesión en favor de la seguridad— y ha abierto un Cyber Verification Program en https://claude.com/form/cyber-use-case para investigadores de seguridad legítimos que necesitan acceso ampliado.¹⁴⁶

Por qué importan estas diferencias de precio: Una sesión típica de programación consume entre 50K y 200K tokens de entrada y entre 10K y 50K tokens de salida. Con Haiku 5.5 y las tarifas para prompts de hasta 100K tokens, eso equivale a unos $0,01-$0,05 por sesión. Con Opus 5.5 a $4/$20, la misma sesión cuesta $0,40-$1,80, unas 40 veces más (antes de los descuentos por almacenamiento de prompts en caché). Usa Sonnet o Haiku cuando una tarea no necesite Opus.¹²²²

Cuándo usar cada modelo

Haiku: Úsalo para subagents que exploran código, búsquedas sencillas de archivos y preguntas rápidas. Con las tarifas para prompts de hasta 100K tokens, cuesta aproximadamente 40 veces menos que Opus 5.5 (8 veces menos con un prompt de más de 100K) y responde más rápido. Ideal para tareas en segundo plano que no requieren razonamiento profundo.

Sonnet: El modelo de uso diario para desarrollar cuando el costo importa – Sonnet 5.5 en Anthropic API desde v2.1.284, al mismo precio de $2/$10 que Sonnet 5²²⁸ – y, desde que v2.1.280 cambió Pro y Team Standard a Opus, ya no es el modelo predeterminado de ningún plan (contexto nativo de 1M, precio de lista estándar de $2/$10 por MTok; el aumento previsto para el 1 de septiembre se canceló).^181251207220 Ese es el cambio que debes tener presente: Sonnet ahora es un modelo que eliges, y la razón para elegirlo es matemática – la mitad del costo por token de Opus 5.5 con el mismo contexto de 1M. Resuelve la mayoría de las tareas de programación: implementar funciones, corregir errores, escribir pruebas y revisar código. Antecedentes: durante mucho tiempo se afirmó –también aquí– que v2.1.197 (30 de junio de 2026) había convertido a Sonnet 5 en el modelo predeterminado en todos los casos, pero la documentación de configuración de modelos por plan indica que el modelo predeterminado de los planes premium/API correspondía a Opus 4.8 desde v2.1.154 y a Opus 5 desde v2.1.219, así que «en todos los casos» en realidad se refería al nivel estándar – y v2.1.280 puso fin incluso a eso. Sonnet 4.6 ocupó el lugar de Sonnet hasta junio de 2026.^93147207221 Usa Sonnet cuando necesites tokens más baratos, menor latencia o reducir el costo de los subagents.

Opus: El nivel de razonamiento profundo —desde v2.1.280, el alias opus selecciona Claude Opus 5.5 ($4/$20 por MTok, contexto de 1M, effort en medium de forma predeterminada), y desde esa versión todos los planes también comienzan con Opus. Por lo tanto, la decisión es cuándo cambiar a otro modelo: mantén Opus para decisiones de arquitectura, depuración difícil, comprensión de sistemas complejos, análisis de seguridad y trabajo con agentes de largo alcance, y cambia con /model sonnet cuando la tarea sea lo bastante rutinaria como para que pagar la mitad por los tokens importe más que el razonamiento adicional.²²⁰²²¹ (El alias opus correspondía a Opus 5 a $5/$25 desde v2.1.219 hasta v2.1.278).¹⁹⁷ El resto de este párrafo describe Opus 4.7 en su lanzamiento del 16 de abril de 2026 y se conserva como referencia histórica.¹⁴⁴¹⁴⁷ Opus 4.7 resuelve 3× más tareas de producción en SWE-Bench que Opus 4.6, obtiene un 70% en CursorBench (frente al 58%) y mejora la resolución un 13% en una evaluación interna de 93 tareas de programación.¹⁴⁴ Claude Code usa de forma predeterminada el nivel de esfuerzo xhigh en Opus 4.7, ajustable mediante /effort (v2.1.111+).¹⁴⁶¹⁴⁷ Auto Mode está disponible para suscriptores de Max en Opus 4.7 a través de Anthropic API sin necesidad de --enable-auto-mode; en otros planes y proveedores, la disponibilidad depende del plan y de los controles del administrador.¹⁴⁶ Contexto de 1M a precio estándar —sin recargo por contexto largo. Cambios de comportamiento que conviene conocer: Opus 4.7 sigue las instrucciones de forma más literal, ajusta la extensión de las respuestas a la complejidad de la tarea, ejecuta menos subagents de forma predeterminada y adopta un tono más directo, con menos expresiones de reafirmación. Si tus prompts incluyen instrucciones auxiliares para forzar mensajes de progreso intermedios o comprobaciones adicionales, prueba a eliminarlas.¹⁴⁵

Opusplan: Un modo híbrido que usa Opus para planificar (donde más importa la calidad del razonamiento) y Sonnet para ejecutar (donde importa la velocidad). Excelente para refactorizaciones complejas en las que quieres el mejor plan, pero no necesitas el razonamiento de Opus para cada edición individual.

Cambiar de modelo

Durante la sesión:

> /model opus
> /model sonnet
> /model haiku

Al iniciar:

claude --model opus

Mediante variables de entorno:

export ANTHROPIC_MODEL=opus

En settings.json:

{
  "model": "claude-sonnet-5"
}

Personaliza el selector (modelPicker, v2.1.242+): un archivo de configuración de usuario o administrada puede definir los modelos que ofrece /model, en el orden y con las etiquetas que prefieras, en lugar de dejar la lista integrada como único menú. Cada fila especifica un model (cualquier formato que acepte --model, incluidos los ID de Vertex y Bedrock), con label y description opcionales; establece replaceBuiltInOptions en true para mostrar solo esas filas, además de Predeterminado y el modelo actual de la sesión. La configuración del proyecto y la configuración local se ignoran para esta clave, y la lista de modelos permitidos de availableModels sigue filtrando las filas. Claude Code elimina las filas de modelos que no puede ofrecer, muestra en gris las que todavía no puedes seleccionar e indica el motivo, y vuelve a la lista integrada si no queda ninguna fila.²⁵⁰²⁴⁸

{
  "modelPicker": {
    "options": [
      { "model": "us.anthropic.claude-opus-4-8", "label": "Opus (production)" },
      {
        "model": "us.anthropic.claude-sonnet-4-6",
        "label": "Sonnet (production)",
        "description": "Day-to-day work"
      }
    ]
  }
}

Específicamente para subagents:

export CLAUDE_CODE_SUBAGENT_MODEL=haiku

A partir de v2.1.251, CLAUDE_CODE_SUBAGENT_MODEL establece el modelo predeterminado de los subagents en lugar de imponerse a todas las demás opciones: el campo model: de la definición de un agente y un modelo explícito indicado al crear cada subagent tienen prioridad.²⁰⁶ A partir de v2.1.257, CLAUDE_CODE_SUBAGENT_MODEL_FORCE permite recuperar el comportamiento anterior de forma opcional: aplica CLAUDE_CODE_SUBAGENT_MODEL (o el modelo de la conversación principal si esa variable no está definida) a todos los subagents, ignorando los modelos elegidos al crearlos y el campo model: de las definiciones de agentes.²¹¹

Cadena de modelos de respaldo (v2.1.166+): la opción fallbackModel permite configurar hasta tres modelos de respaldo que se prueban en orden cuando el modelo principal está sobrecargado o no está disponible. La opción --fallback-model (que antes solo permitía cambiar a mitad de una sesión) ahora también se aplica a las sesiones interactivas desde el inicio.²⁶³

{
  "model": "claude-opus-4-8",
  "fallbackModel": ["claude-sonnet-4-6", "claude-haiku-4-5"]
}

Cuando API devuelve un error inesperado que no admite reintentos, Claude Code ahora también reintenta el turno una vez con el modelo de respaldo antes de mostrar el fallo, de modo que un problema transitorio del modelo principal permite continuar con el respaldo en lugar de perder el turno.²⁶³ A partir de v2.1.286, cuando Anthropic API rechaza el modelo al que corresponde tu opción predeterminada o un alias, Claude Code reintenta una vez con el modelo anterior del mismo nivel en lugar de fallar en cada turno; además, los reintentos por rechazo y por --fallback-model que recurren a un modelo sin compatibilidad con el modo rápido se ejecutan a velocidad estándar.²³¹

A partir de v2.1.178, la compactación también respeta la cadena de respaldo —si el modelo principal se sobrecarga o deja de estar disponible durante la compactación, ese paso recurre a la cadena configurada con fallbackModel/--fallback-model en lugar de hacer fallar el turno. En una ejecución autónoma prolongada, esto evita que un error transitorio del modelo interrumpa la sesión durante una compactación que podría haberse recuperado.¹⁷³

Contexto extendido

Para bases de código grandes o sesiones largas, activa el contexto de 1M de tokens:

claude --model sonnet[1m]
claude --model opus[1m]           # 1M for a model that reaches it only through [1m], such as Opus 4.6

O dentro de una sesión:

> /model sonnet[1m]
> /model opus[1m]

Dónde importa el sufijo (octubre de 2026): en Anthropic API, Fable 5.1, Fable 5, Sonnet 5.5, Sonnet 5 y Opus 4.7 y versiones posteriores (incluido Opus 5.5) funcionan con la ventana de 1M en todos los planes, así que [1m] no cambia nada en ese caso. A partir de v2.1.287, lo mismo ocurre en Amazon Bedrock, Agent Platform de Google Cloud, Microsoft Foundry y la puerta de enlace de aplicaciones de Claude: Opus 4.7 y versiones posteriores, así como Fable, usan la ventana de 1M de forma predeterminada sin el sufijo [1m], y CLAUDE_CODE_DISABLE_1M_CONTEXT=1 los mantiene en 200K. Antes de v2.1.287, Opus 4.8 y versiones posteriores funcionaban con 200K en esos proveedores, a menos que el ID del modelo fijado en ANTHROPIC_DEFAULT_OPUS_MODEL incluyera [1m]; las páginas de documentación de Bedrock y Agent Platform, consultadas el 1 de octubre, todavía describen el sufijo como la forma de obtener 1M en esos proveedores. Sonnet 5 tiene 1M en todos los proveedores. El sufijo sigue siendo necesario para Opus 4.6 y Sonnet 4.6, que solo alcanzan 1M mediante su variante [1m].^223232233

Opus 4.7, Opus 4.6 y Sonnet 4.6 incluyen la ventana de contexto completa de 1M de tokens a precio estándar —sin recargo por contexto largo.¹⁴⁸ Una solicitud de 900K tokens se factura con la misma tarifa por token que una de 9K tokens. Los descuentos por almacenamiento de prompts en caché y procesamiento por lotes se aplican a las tarifas estándar en toda la ventana de contexto. El acceso a las variantes [1m] depende del plan: Opus 4.6 con contexto de 1M está incluido en Max, Team y Enterprise, mientras que Sonnet 4.6 con contexto de 1M requiere créditos de uso en todos los planes de suscripción, incluido Max.²³³ (Opus con 1M pasó a ser la opción predeterminada en Max, Team y Enterprise en v2.1.75, el 13 de marzo de 2026).¹¹⁷¹⁴⁷ Los usuarios de API y de pago por uso tienen acceso completo a 1M con las tarifas estándar por token.¹⁴⁷

Para desactivar las variantes con contexto de 1M en el selector de modelos, configura CLAUDE_CODE_DISABLE_1M_CONTEXT=1. A partir de v2.1.223, cambió el alcance de la variable: limita todos los modelos con una ventana nativa de 1M a 200K mediante la compactación automática —ya no solo una lista fija de variantes conocidas— y muestra una advertencia al iniciar cuando la compactación automática no está manteniendo la sesión dentro de los 200K. Si la configuraste para mantener costos predecibles en una familia de modelos, ahora también limita los nuevos modelos de 1M desde el día de su lanzamiento, en lugar de dejar de aplicarse sin avisar. Esa misma versión hace que la compactación automática mantenga las sesiones con identificadores de modelo no reconocidos dentro de la ventana de contexto supuesta, en vez de permitir que la superen; CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1 restaura el comportamiento anterior para las puertas de enlace que registran identificadores personalizados con ventanas reales más grandes.²⁰⁰ A partir de v2.1.287, la variable también permite mantener Opus 4.7 y versiones posteriores, así como Fable, en 200K en Bedrock, Vertex, Foundry y la puerta de enlace de aplicaciones de Claude, donde 1M pasó a ser la opción predeterminada.²³²

A partir de v2.1.247, la ventana predeterminada de compactación automática de Sonnet 5 abarca todo su contexto de 1M: las sesiones con la ventana de 1M ahora se compactan automáticamente alrededor de los 967K tokens, en lugar de los 934K.²⁴⁵ v2.1.260 extiende la compactación automática cerca del límite al resto de los modelos de 1M: las sesiones de Opus y Fable ahora también se compactan poco antes del límite de 1M de tokens, y la compactación de recuperación en contextos muy grandes ya no agota el tiempo de espera a los 10 minutos.²¹²

Las URL base personalizadas obtienen la ventana de 1M (v2.1.285). Las sesiones que usan un ANTHROPIC_BASE_URL personalizado ahora utilizan la ventana de contexto de 1M de los modelos que cuentan con ella (Opus 4.7 y posteriores, Sonnet 5 y posteriores, Fable). Si tu puerta de enlace tiene un límite de 200K, ejecuta /autocompact 200k.²²⁹²³³

A partir de v2.1.271, --resume conserva la ventana [1m]: al reanudar una sesión cuya familia de modelos difiere del modelo predeterminado configurado, ya no se pierde el sufijo [1m].²¹⁶

v2.1.273 corrige el error por el que el medidor de contexto y la compactación automática contabilizaban los turnos de la herramienta de asesoría como aproximadamente el doble de su tamaño real en el contexto – la compactación automática se activaba aproximadamente a la mitad de la ventana real.²¹⁷

Consultar el modelo actual

> /status

El comando muestra el modelo actual, la información de la cuenta, la configuración aplicada y otros datos del estado de la sesión.

Etiquetas del selector de modelos (v2.1.51+): El selector /model ahora muestra etiquetas legibles (por ejemplo, “Sonnet 4.6”) en lugar de los identificadores de modelo sin procesar para las versiones fijadas, con sugerencias de actualización cuando hay versiones más recientes disponibles.⁹⁸ v2.1.219 corrige la fila unificada de Opus, que se mostraba simplemente como “Opus” en lugar de “Opus (contexto de 1M)”, y limita el resaltado de los nuevos lanzamientos al nombre del modelo más reciente, de modo que destaque lo que realmente se lanzó en vez de una parte arbitraria de la lista.¹⁹⁶ v2.1.283 elimina “(contexto de 1M)” de la fila de Opus y del nombre del modelo predeterminado cuando Opus ya tiene una ventana de contexto de 1M; la ventana en sí no cambia.²²⁶

Modo rápido (v2.1.36+)

El modo rápido ofrece una generación de salida considerablemente más rápida con el mismo modelo; no cambia a un modelo más económico. Actívalo o desactívalo durante una sesión con /fast.⁸⁶

> /fast            # Toggle fast mode on/off

Modelos compatibles (a partir de v2.1.280): el modo rápido se aplica a Claude Opus 5.5, Opus 5 y Opus 4.8, y Opus 5.5 es el modelo predeterminado del modo rápido desde v2.1.280 (Opus 5 lo era desde v2.1.219). v2.1.219 eliminó Opus 4.7 del modo rápido, y la función nunca estuvo disponible en Sonnet, Haiku ni Fable. Sigue siendo una versión preliminar de investigación disponible únicamente en Claude API (incluido Claude Managed Agents), no en Amazon Bedrock, Google Cloud, Microsoft Foundry ni Claude Platform on AWS. El acceso está restringido: contacta a tu gerente de cuenta o inscríbete en la lista de espera.^196198223

Sesiones remotas (v2.1.271): el modo rápido ahora está disponible en las sesiones de Claude Code Remote – tanto en sesiones en la nube como en ejecutores autohospedados. Se aplica la configuración del modo rápido del anfitrión, o puedes escribir /fast en la propia sesión; ambas opciones solo funcionan si tu organización permite el modo rápido. La misma versión corrige /fast off: ahora desactiva el modo rápido en lugar de responder “Modo rápido no disponible” cuando la organización lo tiene deshabilitado.²¹⁶

Precios (modo rápido):^198222223

La trampa de Opus 4.7 (v2.1.219). Los modelos no compatibles no se comportan de la misma manera. Una solicitud a claude-opus-4-7 con speed: "fast" ahora devuelve un error: no pasa silenciosamente a la velocidad estándar. Opus 4.6 es la excepción que conviene conocer: acepta speed: "fast", se ejecuta de todos modos a velocidad estándar, se factura con las tarifas estándar e informa usage.speed: "standard". Si tu entorno de ejecución tenía fijada la versión 4.7 y dependía de que las solicitudes en modo rápido pasaran silenciosamente a la velocidad estándar, ahora fallan directamente; cambia la versión fijada a Opus 5.5, Opus 5 u Opus 4.8.¹⁹⁸

Cuándo usar el modo rápido: - Al iterar rápidamente sobre cambios pequeños cuando la latencia es el cuello de botella - Al generar pruebas, código base o código repetitivo cuando la velocidad importa más que el costo - Al completar secuencialmente una lista de tareas similares

Cuándo NO usar el modo rápido: - En tareas prolongadas ejecutadas por agentes (el costo sigue duplicándose durante toda la ejecución) - En trabajo de subagents en segundo plano (nadie está esperando la salida) - En sesiones con un presupuesto ajustado

El modo rápido incluye la ventana de contexto completa de 1M (v2.1.50+). El precio aplica un multiplicador fijo a todo el contexto, incluidas las solicitudes de más de 200K tokens de entrada —sin recargo adicional por contexto largo—, y se acumula con los multiplicadores de almacenamiento de prompts en caché y de residencia de datos.⁹⁶¹⁹⁸

Notas operativas. El modo rápido tiene su propio límite de uso, independiente de los límites estándar de Opus; al superarlo, devuelve un 429 con retry-after (los encabezados de respuesta anthropic-fast-*-tokens-* indican la capacidad restante). Cambiar entre el modo rápido y el estándar invalida la caché de prompts: las solicitudes a distintas velocidades no comparten prefijos almacenados en caché, así que alternar /fast a mitad de una sesión implica perder un acierto de caché. El modo rápido no está disponible con Batch API ni con un compromiso de Priority Tier.¹⁹⁸

Consejo experto: El modo rápido no se combina con opusplan (opusplan ya mezcla Opus y Sonnet; el modo rápido solo afecta la parte de Opus). Úsalo cuando la latencia importe más que el costo y desactívalo para el trabajo autónomo o por lotes. /fast requiere uso adicional; es posible que los administradores de Team/Enterprise deban habilitarlo primero (corrección de v2.1.37). Desactívalo por completo con CLAUDE_CODE_DISABLE_FAST_MODE=1. A partir de v2.1.218, Claude Code avisa cuando un cambio de modelo mediante /config model=<x> o Remote Control modifica el estado del modo rápido, y v2.1.219 corrigió los clientes de Remote Control que conservaban un estado desactualizado del modo rápido tras un cambio, una reconexión o una comprobación fallida de la organización.^86149195196

La herramienta de asesoría (experimental)

La herramienta de asesoría permite a Claude consultar a un segundo modelo, generalmente más potente, en momentos clave de una tarea: antes de decidirse por un enfoque, cuando un error se repite o antes de dar el trabajo por terminado. El asesor se ejecuta del lado del servidor en la infraestructura de Anthropic como una herramienta de servidor, recibe la conversación completa, incluidas todas las llamadas a herramientas y sus resultados, y devuelve orientación que Claude aplica antes de continuar. Claude decide cuándo invocarlo; puedes solicitar una consulta en un prompt, y no hay ninguna configuración que limite u obligue a realizar llamadas. Es experimental, está disponible en Anthropic API para cuentas de suscripción y cuentas facturadas por API, y llegó a Claude Platform on AWS en v2.1.300 (la página de documentación todavía indica que esa plataforma no es compatible). Si se usa mediante una puerta de enlace, depende de que la solicitud llegue intacta a Anthropic API, y necesita obtener los indicadores de funciones, por lo que una variable como DISABLE_TELEMETRY la mantiene desactivada.²⁷³²⁷⁴ Cómo activarlo. Hay tres formas: /advisor <model> durante una sesión, que guarda la elección en advisorModel en tu configuración de usuario (si usas /advisor sin argumentos, se abre un selector en la terminal y se muestra el asesor actual en las sesiones de -p, SDK, escritorio y Remote Control, donde la forma textual funciona desde v2.1.260; /advisor off lo desactiva); "advisorModel": "opus" en un archivo de configuración; o claude --advisor <model> para una sola sesión, una opción que no aparece en --help, tiene prioridad sobre la configuración y provoca la salida al iniciar si la combinación no es válida. Los alias son fable, opus y sonnet, o puedes usar un ID de modelo completo. CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 elimina el comando, ignora la configuración y hace que la opción no tenga efecto.²⁷⁴

Combinaciones, costo y lo que ves. El asesor debe tener un nivel igual o superior al del modelo principal: Opus 4.7 y 4.8 aceptan Fable, Opus 4.7 o posterior y Sonnet 5.5 (desde v2.1.287); Sonnet 5.5 acepta Fable, Opus 5 o posterior y Sonnet 5.5; Opus 5 y 5.5 aceptan Fable y Opus 5 o posterior; Fable 5.1 solo acepta Fable 5.1; Haiku 4.5 puede llamar al asesor, pero no puede actuar como tal. Si el asesor tiene un nivel inferior al del modelo principal, no se incorpora y aparece una notificación que lo indica; si API lo rechaza, se descarta sin aviso durante el resto de la conversación. Los subagents heredan el asesor con la misma comprobación de compatibilidad, y se respeta la lista de modelos permitidos de availableModels. Cada llamada se cobra según las tarifas de entrada y salida del modelo asesor, o cuenta para los límites del plan, salvo que un asesor Fable se cobra mediante créditos de uso en los planes donde Fable funciona así, tras el consentimiento que se da una sola vez a través de /model fable. Activar o desactivar el asesor conserva la caché del prompt del modelo principal; la lectura que el propio asesor hace de la conversación nunca se almacena en caché. En la transcripción, una línea Advising indica Revisado, Rechazado o No disponible, y Ctrl+O muestra las recomendaciones. Los mods ven las llamadas al asesor como serverToolUses en turn.step (v2.1.290).²⁷⁴

Control del esfuerzo (v2.1.111+, Opus 4.7)

Opus 4.7 incorpora un nuevo control de esfuerzo que ajusta el equilibrio entre velocidad e inteligencia. Usa /effort durante una sesión:

> /effort              # opens an interactive slider (arrow keys + Enter)
> /effort xhigh        # set directly

Guardado por modelo (v2.1.251+): /effort ahora guarda tu nivel de esfuerzo predeterminado por modelo, de modo que cada uno conserva su propia configuración cuando cambias de modelo – si acostumbras usar xhigh en Opus, ese nivel ya no se traslada a Haiku (CHANGELOG: “Se cambió /effort para guardar tu nivel de esfuerzo predeterminado por modelo, de modo que cada modelo conserve su propia configuración cuando cambias”). La excepción de max, que solo se aplica a la sesión, sigue vigente.²⁰⁶ Teclas del control deslizante en v2.1.284: las acciones de asignación de teclas effortSlider:decreaseEffort, increaseEffort y toggleUltracode te permiten reasignar las flechas y la tecla Tab del control deslizante en keybindings.json.²²⁸ v2.1.257 ajusta ambos controles: /effort acepta s para una elección válida solo durante la sesión, siguiendo la convención de /model, y la opción --effort ahora se limita a la sesión – permite superar el nivel de esfuerzo predeterminado fijado para un modelo nuevo únicamente durante esa sesión, en lugar de hacerlo de forma permanente (la referencia de CLI indica que “Reemplaza” el valor predeterminado “para esta sesión y no se guarda”).²¹¹²⁴³

Modo automático en Max (v2.1.111+)

El modo automático es el modo de permisos inicial integrado para las sesiones interactivas de terminal y VS Code en todos los planes y proveedores (v2.1.283-284) y, desde v2.1.285 hasta que v2.1.302 revirtió el cambio, también lo fue para las sesiones de claude -p y Python Agent SDK con proveedores externos o con la telemetría desactivada; ya era el valor predeterminado en Pro, Max y Team desde el 14 de agosto de 2026 (anunciado el 7 de agosto). Consulta Modos de permisos para ver las cifras del estudio citado en el anuncio, las formas de desactivarlo y las sesiones que todavía se inician en modo manual.^{203226227228229}

Un modelo clasificador independiente, Claude Sonnet 5 desde v2.1.210, revisa cada acción antes de ejecutarla para comprobar que coincida con tu intención y sea segura.¹⁸⁷ Inicia una sesión en modo automático con --permission-mode auto; v2.1.111 eliminó la antigua opción --enable-auto-mode.

Cómo se amplió la disponibilidad:

• Desactivar la opción: CLAUDE_CODE_AUTO_MODE_SERVER=0 mantiene el clasificador local, cuyas solicitudes cuentan para el consumo, y 1 activa la opción. Antes de la v2.1.281, la variable no se leía en una conexión directa de Anthropic API; la v2.1.281 también la aplica allí, y la documentación de facturación del modo automático ahora indica que, en una conexión directa, requiere la v2.1.281 o posterior.²²⁴²²⁷ La documentación describe la variable como temporal. Establecer CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 mientras la variable no esté definida también detiene las comprobaciones del servidor.
• Cuando las comprobaciones del servidor no pueden llegar a una sesión: la causa más común es una pasarela o un proxy que elimina el campo safeguards de las solicitudes, quita safeguard_results de las respuestas o reescribe los ID de uso de herramientas. Claude Code muestra un aviso una sola vez («esta sesión no cumple los requisitos»), identifica la pasarela cuando puede y utiliza sus propias solicitudes facturadas al clasificador durante el resto de la sesión. En el modo -p, el aviso se envía a stderr y la salida stream-json emite una advertencia de tipo system. Las sesiones Pro, Max y Team nunca ven este aviso. La solución en una pasarela es transmitir los campos de las solicitudes y las claves de las respuestas sin modificarlos.
• Comprobar una sesión: /status muestra una fila Servidor del modo automático que indica Enabled mientras las comprobaciones del servidor deciden las acciones de la sesión y Disabled una vez que se ha recurrido al clasificador local.²¹⁹

Lo que el modo automático no es: una barrera de seguridad. La mayoría de las medidas que siguen refuerzan un clasificador, y un clasificador no es un entorno aislado. El 26 de agosto de 2026, Johann Rehberger, investigador de inyección de prompts, publicó una cadena de ataque funcional contra Claude Code Opus 5 en modo automático e informó una tasa de éxito del 60-80 % en muestras pequeñas: 3 de 5 ejecuciones para la cadena principal, que genera un proceso hijo aislado de python3, y 3 de 5 y 4 de 5 ejecuciones para dos configuraciones de una variante cuya carga útil genera una instancia de claude -p sin interfaz gráfica. Él mismo advirtió que se trata de muestras pequeñas, no de una medición universal de la tasa de éxito del ataque.²¹⁰ Conviene entender la cadena porque cada paso, por separado, parece razonable: un servidor responde a WebFetch con HTTP 415, por lo que el agente recurre a curl; el archivo descargado se descomprime en un directorio temporal que contiene un manifiesto, siete registros de datos codificados con Base85/zlib, un binario nativo y un struct.py; Claude se niega a ejecutar el binario no confiable y luego escribe su propio decodificador en Python y lo ejecuta desde ese directorio; el decodificador importa base64, base64 importa struct y Python encuentra primero el struct.py del atacante. Nada en la secuencia constituye una instrucción obviamente maliciosa: la inyección solo necesita convertir la ruta comprometida en la forma más razonable de terminar la tarea. Rehberger también informa que, en algunas ejecuciones, Claude intentó terminar el proceso del malware al detectar el ataque, pero el modo automático denegó el comando de limpieza.²¹⁰ Enmarca todo el hallazgo en relación con una cifra que Anthropic ha usado en su promoción: una evaluación encargada a un tercero informó una tasa de éxito del 0,00 % para ataques de inyección de prompts contra Opus 5 en modo automático, en 72 escenarios ejecutados diez veces cada uno. Su cadena no formaba parte de ese conjunto, lo que explica que un resultado del 0,00 % en una evaluación y una cadena funcional de ejecución de código puedan ser ciertos al mismo tiempo; él considera que ambos mensajes son incompatibles.²¹⁰ Presta atención también a la clasificación: la actualización de Simon Willison del 30 de agosto respalda la observación de un lector de que no se trata de una inyección de prompts clásica —el modelo nunca lee ni sigue instrucciones del atacante—, sino de un ataque de confusión del entorno.²¹⁰

Anthropic cerró el informe como Informativo —el comportamiento funcionaba según lo previsto—, y la postura que transmite Rehberger es la que debes tener en cuenta al diseñar: el modo automático es un clasificador que hace lo posible, no una garantía de seguridad; las cadenas de inyección elaboradas deliberadamente a partir de pasos que, por separado, son inofensivos quedan fuera de lo que se espera que detecte un clasificador; y la verdadera barrera de contención está en el aislamiento a nivel del sistema operativo y el control del tráfico de red saliente.²¹⁰ Esto no contradice las medidas de refuerzo que siguen: es el marco correcto para entenderlas. El modo automático reduce la cantidad de solicitudes de confirmación que debes responder y bloquea una lista documentada de operaciones destructivas; no hace que una sesión con entradas no confiables sea segura. Si una sesión va a interactuar con contenido que un atacante pueda manipular —páginas consultadas, archivos descargados, texto de incidencias, servidores MCP de terceros—, los controles que realmente limitan el daño están fuera del modelo: un contenedor o una máquina virtual, restricciones al tráfico de red saliente, supervisión de lo que el agente hace realmente y un directorio de inicio que no contenga las claves SSH ni las credenciales de la nube que no querrías perder. Una aprobación del modo automático no demuestra que una acción fuera segura.

Reglas personalizadas sin perder las predeterminadas (v2.1.118+). Las versiones anteriores obligaban a elegir entre las reglas propias y las integradas para autoMode.allow, autoMode.soft_deny y autoMode.environment: al definir tu propia lista, perdías las reglas de seguridad integradas. El marcador especial $defaults resuelve esto: se expande dentro de la lista e inserta las reglas integradas exactamente donde lo coloques, de modo que puedes añadir reglas personalizadas antes y después de ellas:¹⁵²

// .claude/settings.json
{
  "autoMode": {
    "allow": [
      "Bash(npm test:*)",        // your additions, prepended
      "$defaults",                // built-in allow list inserted here
      "Bash(git push:origin/feature/*)"  // appended after
    ]
  }
}

Edita las reglas del clasificador desde /permissions (v2.1.246). Ejecuta /permissions y abre la pestaña Modo automático, que solo aparece cuando el modo automático está disponible para la sesión. Enumera las entradas allow, soft_deny, hard_deny y environment de todos los ámbitos que lee el clasificador e indica si las reglas integradas están activas en cada sección; las entradas de la configuración administrada o de --settings son de solo lectura, y cada cambio se guarda en ~/.claude/settings.json. Al añadir la primera regla a una sección también se inserta "$defaults" para mantener activas las reglas integradas; puedes activar o desactivar las reglas integradas de cada sección (una sección necesita al menos una regla propia antes de poder desactivar las integradas), y environment se abre como un único documento en tu editor.²⁴⁹²⁴⁷

Opción «No volver a preguntar» al activar el modo automático (v2.1.118+). El mensaje de activación del modo automático ahora ofrece la opción «No volver a preguntar», para que quienes lo usan con frecuencia puedan ocultar la explicación sin tener que automatizar una opción de línea de comandos.¹⁵²

Protecciones contra comandos destructivos (v2.1.183). El modo automático ahora bloquea de forma estricta un conjunto de comandos irreversibles, a menos que los hayas solicitado explícitamente en la sesión: operaciones destructivas de git (git reset --hard, git checkout -- ., git clean -fd, git stash drop) cuando no hayas pedido descartar el trabajo local; git commit --amend cuando el agente no haya creado el commit durante esta sesión; y la eliminación de infraestructura (terraform destroy, pulumi destroy, cdk destroy), a menos que hayas indicado la pila específica. Esto limita el alcance de los daños que puede permitir el clasificador precisamente en las operaciones que provocan la pérdida silenciosa de trabajo o eliminan entornos: el agente todavía puede ejecutarlas, pero solo por instrucción explícita tuya, no por iniciativa propia.¹⁷⁴

Clasificar cada comando de shell (v2.1.193). De forma predeterminada, el clasificador del modo automático solo revisa los comandos de shell que coinciden con patrones de ejecución de código arbitrario; los comandos rutinarios omiten esa revisión. La nueva opción autoMode.classifyAllShell envía todos los comandos de Bash/PowerShell al clasificador, a cambio de un pequeño aumento de latencia y con una protección más estricta cuando quieres que se revise cada llamada al shell. La misma versión también muestra los motivos de denegación del modo automático en el registro de la sesión, la notificación emergente de denegación y las denegaciones recientes de /permissions, de modo que ahora se explica por qué se bloqueó un comando.¹⁷⁹

Tres reglas de refuerzo adicionales (v2.1.205). El modo automático ahora bloquea la manipulación de los archivos de registro de la sesión —el agente no puede alterar el propio registro de auditoría—; pregunta antes de ejecutar rm -rf sobre una variable cuyo valor no pueda determinar a partir del contexto —lo que evita los accidentes del tipo rm -rf $DIR con un $DIR desconocido—; y las notificaciones de tareas en segundo plano ahora indican explícitamente que no ha habido intervención humana, de modo que una línea falsa de «el usuario aprobó» dentro de un registro no pueda hacerse pasar por una aprobación válida y dar lugar a una acción.¹⁸³ La tercera regla es una defensa contra la inyección de prompts que conviene tener presente: la aprobación debe llegar por el canal de aprobación, y el entorno de ejecución ahora hace explícito ese requisito. La sustitución de comandos no puede ocultar una catástrofe (v2.1.208). Las eliminaciones catastróficas, como rm -rf ~, ahora piden confirmación incluso cuando están ocultas dentro de $(...), comillas invertidas o una sustitución de procesos (<(...)), y la confirmación se solicita incluso con --dangerously-skip-permissions y en modo automático. Envolver un comando destructivo en una sustitución ya no permite eludir la red de seguridad.¹⁸⁶

Restablece el estado del modo automático: claude auto-mode reset (v2.1.212). Un nuevo subcomando restablece el estado del modo automático desde la terminal; pasa --yes para omitir la confirmación:¹⁸⁹

claude auto-mode reset          # Confirmation prompt
claude auto-mode reset --yes    # Skip confirmation (scripts)

Menos diálogos, el mismo rigor (v2.1.218). Tres comprobaciones que antes interrumpían el modo automático con un diálogo de permisos —rm peligroso, & en segundo plano y rutas sospechosas de Windows— ya no lo hacen; ahora las evalúa el clasificador del modo automático, por lo que la revisión de seguridad sigue realizándose sin requerir tu intervención cada vez que se activa una de ellas. La misma versión extiende este comportamiento al modo de planificación con modo automático: los comandos de Bash que el analizador estático no puede confirmar como de solo lectura ya no piden permiso; el clasificador los evalúa en lugar de recurrir a un diálogo.¹⁹⁵

Regla contra escapes del entorno de contención (v2.1.257). La lista del clasificador de acciones que nunca se aprueban automáticamente incorpora una regla de «escape del entorno de contención»: la obtención de credenciales desde metadatos de la nube, la evasión de controles de salida de red y el acceso entre entornos de distintos clientes ya no se aprueban automáticamente, a menos que el entorno los marque como esperados. Interprétalo en el contexto de la salvedad anterior: el clasificador sigue reforzándose – se documenta otra categoría de denegación, sin cambiar lo que es el modo automático.²¹¹

Confirmación única para lecturas fuera de los directorios de trabajo (v2.1.257). El modo automático ahora pide confirmación una vez antes de la primera lectura de un archivo fuera de los directorios de trabajo durante la sesión; desde v2.1.284, ese diálogo también ofrece Sí, pero vuelve a preguntar la próxima vez.²²⁸ La opción de configuración complementaria permissions.blockReadsOutsideWorkingDirectories convierte esa solicitud en una denegación – esas lecturas se bloquean directamente.²¹¹ v2.1.273 extiende ambos comportamientos a lo que el verificador no puede inspeccionar: un comando de Bash que no pueda analizar por completo pide confirmación en lugar de omitir la comprobación y, cuando está activada la opción de bloqueo, un directorio de memoria elegido por la configuración de un repositorio ya no se carga en el prompt, se consulta, se indexa ni se usa para extraer memoria.²¹⁷

Las URL de renderizadores de diagramas cuentan como cargas de datos (v2.1.261). Un enlace que incluye contenido en la URL de un renderizador público de diagramas – al estilo de mermaid.live, con los datos codificados en la propia URL – ya no se aprueba automáticamente, a menos que lo hayas solicitado. El clasificador trata ese enlace como una carga de datos: los datos incluidos viajan en la propia URL, donde los scripts del sitio del renderizador pueden leerlos al abrir la página – los enlaces al estilo de mermaid.live llevan los datos en el fragmento de la URL, que el navegador entrega al JavaScript de la página en lugar de enviarlo con la solicitud de red. Se aplica el mismo contexto de la salvedad anterior: se cierra otro canal de exfiltración al reforzar el clasificador; no se establece un límite nuevo.²¹⁴

Los dos modos de fallo del clasificador incorporan condiciones de detención (v2.1.280). Hasta esta versión, el modo automático no tenía una respuesta prevista para una comprobación de seguridad que no devolviera un dictamen utilizable, y ambos casos se manifestaban de la misma forma para quien operaba la sesión: un turno que se quedaba en un bucle, consumiendo tokens en una acción que nunca se iba a aprobar. v2.1.280 asigna a cada uno un estado final.

La revisión del servidor abarca más comandos (v2.1.281). Cuando la revisión del clasificador se ejecuta en el servidor, los comandos de shell de solo lectura y los ejecutados dentro del entorno aislado también esperan esa revisión y se bloquean cuando esta los señala. El mensaje de denegación también cambió, de modo que Claude interpreta que la denegación abarca el resultado, no solo el comando exacto. Al reanudar una sesión en un proceso nuevo, el clasificador puede reutilizar su caché de prompts anterior en lugar de volver a escribirla. Además, /insights incorpora una recomendación sobre el modo automático que estima cuántas solicitudes de permisos podría haber resuelto en tus sesiones recientes.²²⁴

Las sesiones sin supervisión dejan de esperar confirmaciones de rm (v2.1.281). En modo automático y con --dangerously-skip-permissions, la confirmación de un rm peligroso ahora espera 2 minutos por una respuesta y luego deniega el comando con una sugerencia para reformularlo, de modo que una sesión sin supervisión pueda continuar; CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT=1 desactiva el tiempo de espera. Un rm recursivo cuyo destino consiste únicamente en la salida de una sustitución de comandos, como rm -rf "$(pwd)", antes se ejecutaba sin pedir confirmación en ambos modos; ahora la pide incluso cuando coincide con una regla de autorización de Bash, a menos que se configure CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT=1. La comprobación de rm peligroso también detecta eliminaciones cuyo destino sea una variable de shell seguida del nombre de un directorio de nivel superior, una variable derivada del directorio de trabajo o un destino compuesto únicamente por barras invertidas.²²⁴ Desde v2.1.299, un script de shell con -c que no ejecuta rm ya no pide confirmación, y un rm construido durante la ejecución dentro de un script que Claude Code no puede leer solo pide confirmación cuando está configurado CLAUDE_CODE_STRICT_INLINE_SHELL_RM_PROMPT=1.²⁷¹

Los comandos de shell en línea con ! dejan de pasar por el clasificador; las devoluciones de los subagents empiezan a hacerlo (v2.1.271). Son dos cambios de funcionamiento, no nuevas categorías de denegación. Los comandos de shell en línea con ! de una skill o un comando de barra ahora siguen las reglas de permisos del modo predeterminado en lugar de pasar por el clasificador – un comando que ninguna regla resuelve se ejecuta como una llamada a herramienta sujeta a revisión. Además, un subagent ahora devuelve sus resultados a quien lo invocó mediante una llamada específica que revisa el clasificador de seguridad, en lugar de que su último mensaje se revise a posteriori – el punto de control pasó de estar después de la entrega a estar en la propia entrega.²¹⁶

Novedades de v2.1.309 y v2.1.310

Claude Code 2.1.309 se publicó el 22 de octubre de 2026 (npm a las 20:34 UTC; publicación en GitHub a las 22:18 UTC, 79 puntos) y 2.1.310 el 23 de octubre (npm a las 21:20 UTC; publicación en GitHub a las 23:39 UTC, 26 puntos), ambas con notas idénticas a las del CHANGELOG canónico. Las etiquetas latest y next de npm apuntan a 2.1.310, y stable pasó de 2.1.292 a 2.1.308, una versión cuya nota completa dice «Correcciones de errores y mejoras de fiabilidad»; 2.1.303 (18 de octubre) incluye esa misma línea. No se omitió ninguna versión entre 2.1.302 y 2.1.310.²⁷⁸

Correcciones del entorno aislado y los permisos (v2.1.309). Los comandos de Bash ejecutados en el entorno aislado en macOS y Linux ya no ejecutan los archivos de inicio del shell fuera de ese entorno antes de cada comando; los patrones glob de denyWrite en macOS se aplican a la ubicación real de una ruta cuando se llega a la carpeta del patrón mediante un enlace simbólico; los comandos ejecutados en el entorno aislado y las ediciones aceptadas automáticamente ya no pueden modificar el archivo de configuración de MCP indicado con --mcp-config; las denegaciones de escritura en Linux ya no se levantan cuando un comando en segundo plano sigue activo después de terminar la sesión; y los comandos que la configuración excluye del entorno aislado ahora piden confirmación antes de escribir en las rutas de su lista de escritura permitida cuando el entorno aislado está habilitado pero no puede ejecutarse, y en ese caso se rechaza la alternativa de ejecutarlos fuera de él. Las comprobaciones de permisos de Bash dejan de confiar en una variable definida por un comando cuya redirección puede fallar, piden confirmación para un cd envuelto en otro comando o precedido por un prefijo antes de git, y aplican una regla de denegación Edit(path) a una redirección de Bash dentro de un subshell; la protección de aislamiento de worktree rechaza más comandos con prefijos de configuración regional y comandos aritméticos de zsh; la protección contra escritura del almacén de perfiles se aplica incluso cuando se accede al directorio de configuración mediante un enlace simbólico. sed -i ahora muestra la solicitud de permisos estándar de Bash y se ejecuta tal como está escrito, en lugar de mostrar una vista previa simulada de edición del archivo, y, al igual que otras ediciones realizadas con Bash, /rewind ya no lo revierte. Consulta Modo de entorno aislado.²⁷⁸ Confianza, worktrees y skills (v2.1.309). claude ultrareview requiere que el espacio de trabajo sea de confianza: solicita confirmación en una terminal y, en cualquier otro caso, se niega a ejecutarse; los scripts pasan --trust-workspace, que no admite ningún valor, o establecen CLAUDE_CODE_DISABLE_ULTRAREVIEW_TRUST_CHECK=1. En el modo que omite los permisos de la aplicación de escritorio y VS Code, el aviso sobre comandos rm y rmdir peligrosos ahora rechaza el comando de inmediato e indica cómo reformularlo, para que las sesiones sin supervisión sigan adelante. La creación y reutilización de worktrees ya no descargan objetos de git bajo demanda (una clonación parcial con un sandbox de Bash los descarga primero), y los worktrees y los cambios de rama ignoran las referencias de reemplazo de git. Cuando un CLAUDE.md anidado supera el límite de tamaño, ahora solo se carga su inicio, lo que evita que las sesiones se compacten repetidamente después de leer archivos bajo su ámbito. Una skill en una carpeta de --add-dir cuyo nombre ya pertenece a otra skill se ofrece como <folder>:<name>, y /verify y /code-review encuentran la skill propia de un paquete anidado. Los agentes compañeros en paneles divididos heredan las reglas de denegación de herramientas y de --tools del líder, y /rewind muestra los turnos que modificaron archivos con puntos de control mediante /code-review --fix, un subagent o un comando de shell.²⁷⁸

v2.1.310. La herramienta Monitor y los monitores de plugins funcionan en Bedrock, Vertex y Foundry, así como cuando la telemetría o el tráfico no esencial están desactivados; en esos casos, ahora también se bloquean las esperas prolongadas en primer plano. Las solicitudes que pasan por puertas de enlace y servidores compatibles que rechazan el valor beta effort-2025-11-24 o los mensajes del sistema a mitad de conversación se reintentan sin ellos. La compactación después de un error «Prompt is too long» ya no conserva demasiado texto denso, como base64 o SVG; la limpieza en segundo plano ya no elimina archivos recientes, como imágenes pegadas, cuando cleanupPeriodDays es muy grande; los avisos de lectura de archivos muestran adónde apunta un enlace simbólico; el aviso del modo automático antes de la primera lectura fuera de los directorios de trabajo indica cuándo bloquear esas lecturas hace que los comandos de shell soliciten permiso; las sesiones no interactivas consumen menos memoria al compactar un registro de conversación muy grande; en Ubuntu, /sandbox y la advertencia de inicio indican la restricción de AppArmor sobre los espacios de nombres de usuario y cómo levantarla; el componente Image de un mod se dibuja dentro de tmux con allow-passthrough y focus-events activados, y en kitty, Ghostty e iTerm2 3.5+ con renderizado a pantalla completa; y una llamada a una herramienta de MCP que agota el tiempo de espera en una sesión no interactiva mientras la solicitud de información del servidor sigue sin respuesta le indica a Claude que no la repita. Los permisos de sesiones en la nube y de Remote Control se incorporan a los roles personalizados de Enterprise.²⁷⁸

Novedades de v2.1.307

Claude Code 2.1.307 se publicó el 21 de octubre de 2026 (npm a las 20:47 UTC; versión de GitHub a las 22:17 UTC; 43 puntos, idénticos al CHANGELOG canónico), después de 2.1.306 (21 de octubre, 02:28 UTC), cuyas dos correcciones son que claude -p dentro de sesiones en la nube ya no muestra «Not logged in» cuando faltan las variables de entorno de la sesión, y que un error de API ya no se sustituye por «prompt is too long» seguido de una compactación innecesaria en sesiones con muchas herramientas de MCP. La versión 2.1.308 (22 de octubre, 04:19 UTC) incluye una sola línea sobre mejoras de fiabilidad y pasó a ser stable.²⁷⁸

Telemetría y la skill de API. El evento de OpenTelemetry claude_code.safety_event se emite por cada llamada a una herramienta que una regla de permisos, el modo automático, una comprobación de seguridad, un hook o el sandbox haya detenido, sometido a confirmación o devuelto (consulta la Referencia de variables de entorno). /claude-api api-version migra el código de Claude que usa API a la versión 2026-10-21 de API, y /claude-api managed-agents-secure (v2.1.304) compara la configuración de un agente de Managed Agents con la guía de seguridad publicada por Anthropic, sin modificar nada; la skill ahora crea equipos de subagents de Managed Agents sobre multiagent_20261001, con flujos de trabajo dinámicos activados de forma predeterminada (v2.1.309).²⁷⁸²⁷⁹

Correcciones y comportamiento. CLAUDE_CODE_DISABLE_1M_CONTEXT con un alias que incluye el sufijo [1m], como opus[1m], ya no produce un error de modelo no encontrado; el encabezado beta prompt-caching-scope ya no se envía a través de puertas de enlace personalizadas de ANTHROPIC_BASE_URL ni en Foundry; los servidores de MCP que no eran accesibles mientras el llavero de inicio de sesión de macOS estaba bloqueado ahora indican el motivo, y la siguiente ejecución después de desbloquearlo se conecta sin volver a iniciar sesión; las llamadas HTTP a herramientas de MCP ya no se envían dos veces cuando la conexión se cierra a mitad de la llamada, ya que solo se reintentan las herramientas de solo lectura o idempotentes; se corrigen los errores «Autocompact is thrashing» en turnos que leen muchas páginas de PDF o imágenes; las llamadas a herramientas que no se pueden interpretar se reintentan hasta 2 veces antes de que el turno termine con un error; cada subagent de bifurcación que se inicia junto con otros recibe información sobre cuál de los inicios le corresponde; /permissions > Denegados recientemente muestra el comando de shell denegado; la opción axScreenReader y CLAUDE_AX_SCREEN_READER en un bloque env de configuración solo se aplican desde la configuración del usuario, la administrada o la de --settings (desde 2.1.305); y los hooks de checkout de ejecutores autohospedados se detienen después de 30 minutos de forma predeterminada (--checkout-hook-timeout-min, 0 para no establecer un límite). Code Review incorpora @claude review stop (también off y pause) para finalizar una suscripción de @claude review always.²⁷⁸

Novedades de v2.1.304 y v2.1.305

Claude Code 2.1.304 se publicó el 19 de octubre de 2026 (npm a las 19:47 UTC; versión de GitHub a las 21:34 UTC; 76 puntos) y 2.1.305 el 20 de octubre (npm a las 19:29 UTC; versión de GitHub a las 20:46 UTC; 38 puntos), ambas con notas idénticas al CHANGELOG canónico; 2.1.303 (18 de octubre) incluye una sola línea sobre mejoras de fiabilidad.²⁷⁸

Configuración del modo automático y correcciones de /usage. /auto-mode-setup (v2.1.304) ofrece una configuración guiada que lee tu proyecto y las sesiones recientes para proponer entradas de autoMode.environment; también está disponible en Bedrock, Vertex, Foundry, la puerta de enlace de aplicaciones de Claude y las sesiones con telemetría desactivada; la documentación de configuración del modo automático explica su uso. /usage (v2.1.305) convierte cada advertencia en una solución de una línea que identifica su origen, y f aplica las correcciones, que también aparecen en VS Code y /doctor; /usage también indica cuándo termina una limitación de frecuencia para consultar los datos de uso. En Pro y Max, reanudar una conversación inactiva que consumiría una parte considerable del límite de uso de 5 horas ahora muestra una advertencia con la opción de iniciar una conversación nueva (v2.1.304). Consulta Modo automático en Max y la fila de /usage en Comandos de barra diagonal.²⁷⁸²⁷⁹

Configuración y entorno. sandbox.allowNestedUserNamespaces (v2.1.305) permite que los comandos ejecutados en un sandbox en Linux creen espacios de nombres de usuario (Chromium, podman sin privilegios de root), a costa de permitirles eludir las protecciones de archivos del sandbox. CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS (v2.1.305) permite que el modo de reintento sin supervisión detecte un límite de uso que se haya levantado antes de su restablecimiento. CLAUDE_CODE_AUTO_COMPACT_WINDOW acepta los sufijos k y M, al igual que --autocompact, y advierte sobre los valores fuera de rango (200k había establecido silenciosamente una ventana de 100K). allowedMcpServers deja de filtrar los servidores stdio de managed-mcp.json que usan ${VAR} solo en env, por lo que un servidor que no figuraba en tu lista de permitidos se carga al actualizar (usa deniedMcpServers para mantenerlo desactivado). La búsqueda de herramientas está activada de forma predeterminada al usar un ANTHROPIC_BASE_URL personalizado (v2.1.304), y v2.1.305 corrigió la regresión de 2.1.304 que hacía fallar todas las solicitudes en Vertex, Bedrock y otros proveedores cuyo endpoint rechaza la búsqueda de herramientas: Claude Code ahora reintenta sin ella. Los plugins que Claude Desktop monta mediante una ruta pierden sus allowed-tools cuando se aplica allowManagedPermissionRulesOnly. Al 23 de octubre, todos estos cambios figuran en la documentación, excepto la activación predeterminada de la búsqueda de herramientas.²⁷⁸²⁷⁹

Mods, skills y hooks. El evento tool.check de un mod incluye e.isReadOnly, su respuesta puede establecer decider: "person" para que solo el diálogo de permisos o una función de retorno del entorno anfitrión puedan aprobarlo, los hooks de settings.read reciben cada capa de configuración y reescriben la configuración combinada, una línea del registro de conversación identifica al plugin que omitió uno de tus hooks, y un panel acoplado no supera el 45% del ancho de la terminal (v2.1.305). Después de la compactación, se vuelve a enviar a Claude la lista de skills, y /reload-skills solo envía las skills nuevas o modificadas; las skills de un mismo origen pueden registrar como máximo 1.024 hooks y 16.384 caracteres en patrones de coincidencia por sesión; el hook once de una skill ya no elimina el hook idéntico de otra skill. Al reanudar un flujo de trabajo, los resultados de los agentes de pipeline() y parallel() ya completados se recuperan del diario de la ejecución en lugar de volver a ejecutarlos (v2.1.305); las reactivaciones de /loop con intervalo autogestionado y un máximo de 1 hora ya no ocurren justo después de que venza la caché de prompts; claude --worktree ya no elimina el worktree y su rama sin preguntar al salir cuando HEAD estaba desacoplado o en otra rama; ejecutar rm -r sobre una unidad montada o una carpeta en su nivel superior muestra el aviso de seguridad; y Code Review incorpora niveles de revisión (Rápida, Estándar, Profunda) y una opción para revisar todos los repositorios de una organización de GitHub. El diálogo de /fast elimina la etiqueta «(versión preliminar de investigación)» en Opus 5.5.²⁷⁸

Novedades de v2.1.302

Claude Code 2.1.302 se lanzó el 16 de octubre de 2026: npm lo publicó a las 16:48 UTC, la versión de GitHub apareció a las 20:53 UTC con los mismos 63 puntos que el CHANGELOG canónico, y tanto latest como next en npm apuntan a esta versión, mientras que stable sigue en 2.1.292. Sucede a 2.1.301 (15 de octubre, 51 puntos); no se omitió ninguna versión. La documentación, consultada el 17 de octubre, incluye el movimiento de vim y la representación de fórmulas matemáticas en VS Code de 2.1.301, pero todavía ninguno de los cambios que se detallan a continuación, por lo que el CHANGELOG es la fuente de todos ellos.²⁷⁵²⁷⁶

claude -p y el SDK vuelven a iniciarse en Manual. Una sesión de claude -p o del Agent SDK sin un modo de permisos definido ahora se inicia en default (Manual) al usar proveedores externos, con la telemetría desactivada o en una instalación nueva; --permission-mode auto mantiene el modo automático. Esto revierte la regla de v2.1.285, según la cual esas sesiones se iniciaban en modo automático, y mantiene las sesiones interactivas de terminal y VS Code como estaban: en modo automático con todos los planes y proveedores. La documentación sobre modos de permisos todavía describe el comportamiento de v2.1.285. Consulta Modos de permisos.²⁷⁵²⁷⁶

Subagents de tipo fork y ejecución en segundo plano de forma predeterminada. Los subagents de tipo fork (subagent_type: "fork") están activados de forma predeterminada en claude -p, el Agent SDK, la aplicación de escritorio y VS Code, como ya lo estaban en la terminal; CLAUDE_CODE_FORK_SUBAGENT=0 los desactiva, y claude mcp serve nunca los ofrece. La aplicación de escritorio y VS Code ahora siempre ejecutan los subagents de la conversación principal en segundo plano, como lo hace la terminal, en lugar de dejar que Claude elija; en cambio, las llamadas a Agent que hace un subagent en claude -p, el SDK, la aplicación de escritorio y VS Code se ejecutan en primer plano de forma predeterminada. Los hooks de prompt y de agente ahora ejecutan como máximo 12 hooks de un mismo evento a la vez; los demás esperan su turno. La documentación sobre variables de entorno y subagents todavía indica que el modo fork solo está activado en sesiones interactivas. Consulta ¿Qué son los subagents?.²⁷⁵²⁷⁶

Modo automático y compactación. CLAUDE_CODE_AUTO_MODE_MODEL selecciona el modelo que usa el clasificador del modo automático del lado del cliente; no cambia el modelo del modo automático del lado del servidor. Con el clasificador del lado del servidor, una conversación demasiado larga para la comprobación de seguridad ahora se compacta, en lugar de que se deniegue cada llamada a una herramienta que se comprueba. /config incorpora una fila de Compactación por inactividad para desactivar o volver a activar esta función, y el aviso que aparece después de una compactación por inactividad explica cómo desactivarla. Se corrigió el error «El prompt es demasiado largo» que aparecía al detener un turno durante la compactación, y /autocompact y /effort guardan la configuración en el modelo correcto cuando una puerta de enlace identifica Opus 4 o 4.1 con un prefijo como anthropic/claude-opus-4-1.²⁷⁵

Claude Design cerrará a más tardar el 14 de diciembre de 2026. /design-sync y /design-login ahora muestran un aviso de que la versión independiente de Claude Design (claude.ai/design) cerrará a más tardar en esa fecha, y /design consent y /design revoke dirigen las sesiones en la nube a claude.ai/design/settings en lugar de /design-login. Consulta la fila de /design en Comandos de barra diagonal.²⁷⁵

Correcciones que conviene conocer. La herramienta Read ya no carga por completo en la memoria una imagen de cualquier tamaño, ni una tubería o un dispositivo cuyo nombre parezca el de una imagen: se rechazan las fuentes de imagen de más de 128 MB. Una herramienta agregada a mitad de una sesión y cargada de nuevo mediante ToolSearch o después de una compactación ya no provoca un fallo de caché del prompt. claude plugin y otros subcomandos esperan a que termine una escritura de configuración pendiente antes de salir, por lo que los cambios ya no se pierden ni quedan en un archivo .tmp. Los catálogos de plugins ya no se vuelven a clonar en cada actualización, y los plugins de git ya no muestran la versión «desconocida» cuando git usa de forma predeterminada el formato de referencias reftable; el aislamiento mediante worktrees funciona con git 2.56 o posterior cuando un archivo .git suelto apunta a un directorio inexistente. Los servidores MCP que negocian la versión de protocolo 2026-07-28 pero omiten resultType, ttlMs o cacheScope ahora muestran sus herramientas. Las sugerencias de prompts se omiten después de una respuesta cobrada con créditos de uso. Las solicitudes ya no fallan con «diagnostics: No se permiten entradas adicionales» después de cambiar a Vertex o Bedrock a mitad de una sesión. El inicio con muchos plugins es más rápido, sobre todo en Windows, y ya no se rechazan las escrituras de archivos en unidades exFAT o FAT32 en Windows.²⁷⁵

Sesiones en la nube y Claude Tag. La página de una rutina muestra un aviso que explica por qué no se inició su última ejecución, como el límite de sesiones simultáneas en la nube de la organización; «Rebobinar hasta aquí» funciona en todos los mensajes (los ejecutores autoalojados necesitan v2.1.246 o posterior); una ejecución que falló a mitad del proceso ya no se repite desde el principio una hora después; y el costo y el uso de una sesión en la nube ya no vuelven a cero cuando se reanuda en un proceso nuevo. La configuración de administración de Claude Tag se reorganizó en las pestañas Paquetes, Conectores, Skills y plugins, y Canales; las imágenes HEIC, SVG, TIFF y BMP adjuntas en Slack ahora llegan a Claude como archivos; y el rol de gestor ahora también da acceso a Claude Tag en Slack cuando las organizaciones lo restringen por rol.²⁷⁵

Novedades de v2.1.301

Claude Code 2.1.301 se lanzó el 15 de octubre de 2026 (npm a las 14:34 UTC; la versión de GitHub de las 19:22 UTC incluye los mismos 51 puntos que el CHANGELOG canónico). latest en npm pasó a 2.1.302 al día siguiente, por lo que aquí se cubren ambas versiones juntas.²⁷⁵

Los reintentos sin supervisión incorporan un tiempo máximo de espera ante límites de uso. CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS hace que el modo de reintento sin supervisión (CLAUDE_CODE_RETRY_WATCHDOG) termine una solicitud cuando se alcanza un límite de uso cuyo restablecimiento está demasiado lejos, en lugar de esperar; aparece junto a CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS en la Referencia de variables de entorno. También para quienes operan el sistema: al cambiar a un modelo con una ventana de contexto más pequeña, ahora el modelo anterior resume la conversación si es demasiado larga para el nuevo, en lugar de gastar créditos de uso en un resumen sin preguntar; los alias fable y best reintentan una vez con el modelo Fable anterior cuando el más reciente no está disponible para tu organización; y una conversación que pasa por una puerta de enlace LLM cuyas respuestas identifican un modelo distinto del solicitado ya no se compacta una y otra vez.²⁷⁵

Telemetría, vim y mods. Los eventos tool_decision de OpenTelemetry incorporan classifier_verdict y permission_mode, lo que permite distinguir las decisiones del clasificador del modo automático de las reglas de permisos, así como classifier_category, que identifica la regla integrada que provocó un bloqueo del clasificador cuando OTEL_LOG_TOOL_DETAILS=1. El modo Vim incorpora el movimiento %: salta al delimitador correspondiente, por sí solo o junto con d, c o y (la documentación del modo interactivo ya lo incluye). Los mods incorporan rows en Input para crear un campo de texto de varias líneas en la terminal, donde Enter envía el texto y Shift+Enter, o una barra invertida antes de Enter, inicia una línea nueva; el manejador .catch del hook de un mod ahora se ejecuta solo cuando el hook lanza una excepción o agota el tiempo de espera; $.env.set se resuelve con {} una vez que se establece o elimina la variable, o con { deny } indicando el motivo; $.model.fork ya no devuelve nothing-to-fork antes de la primera respuesta de un proceso nuevo; y en VS Code y las aplicaciones de escritorio y móvil, un árbol dibujado encima del cuadro de diálogo de preguntas puede contener Markdown y hasta 48 filas. Consulta Mods y Modo Vim.²⁷⁵²⁷⁶

Correcciones que conviene conocer. Salir ya no elimina sin preguntar un worktree creado por un hook WorktreeCreate cuando puede contener commits que aún no se han enviado al repositorio remoto. Grep y Glob informan de un error cuando falla el programa de búsqueda, en lugar de indicar «sin coincidencias». Las skills y los comandos con demasiados nombres de argumentos o con nombres muy largos ya no se quedan detenidos durante segundos: solo se completan los primeros 64 nombres, de hasta 64 caracteres cada uno. La herramienta Read ya no lee como texto archivos binarios como .xlsm, .parquet, .epub y .heic. Las skills vuelven a incluirse en la lista que recibe el modelo después de /rewind. Una llamada a una herramienta interrumpida por un mensaje enviado a mitad de un turno durante la comprobación de permisos ya no se presenta al modelo como si la hubieras rechazado. Esc en modo vim ya no descarta una respuesta escrita en AskUserQuestion: el campo de texto libre admite el modo NORMAL, y Esc solo cancela desde ese modo. Un disco lleno ahora genera un error que identifica el disco, en lugar del engañoso «Ejecuta /login». Los ejecutores autoalojados iniciados desde Slack pueden adjuntar un repositorio cuando la configuración administrada restringe los servidores MCP (usa deniedMcpServers para mantener esas herramientas desactivadas). VS Code representa fórmulas matemáticas de LaTeX en las respuestas, incluidos los bloques $$ y \[ ... \], y muestra un enlace «Obtener más uso» en el aviso de límite de uso para Pro y Max.²⁷⁵

Novedades de v2.1.300

Claude Code 2.1.300 se lanzó el 14 de octubre de 2026, horas después de 2.1.299: npm lo publicó a las 14:27 UTC bajo next, la versión de GitHub apareció a las 18:24 UTC con los mismos 88 puntos que el CHANGELOG canónico y, para esa noche, tanto latest como next en npm apuntaban a 2.1.300, mientras que stable pasó de 2.1.287 a 2.1.292. No se omitió ninguna versión.²⁷³ La herramienta de asesor llega a Claude Platform on AWS. /advisor ahora funciona en Claude Platform on AWS; ningún asesor se ejecuta hasta que elijas uno con /advisor, advisorModel o --advisor, y CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 desactiva la herramienta. Al 14 de octubre, la página de documentación del asesor todavía incluye Claude Platform on AWS entre los proveedores no compatibles. La herramienta en sí, que permite a Claude consultar un segundo modelo en los puntos de decisión, es anterior a esta versión y se describe en La herramienta de asesor.²⁷³²⁷⁴

Mods y telemetría. Los mods incorporan decoraciones de prompt con virtualText (texto que se muestra en el cuadro del prompt, pero nunca se incorpora al borrador), $.ui.view({ agentId }) para mostrar la transcripción de un agente en la vista principal ($.ui.view({}) vuelve a la vista anterior), una propiedad dir en Text para filas de derecha a izquierda y el hook prompt.change para cambios en el cuadro del prompt que no provienen de la escritura (una entrada recuperada del historial, un borrado, una acción de deshacer o texto insertado por un plugin); agent.spawn ahora puede reescribir el prompt y el model de un agente de flujo de trabajo en lugar de limitarse a rechazarlo, y la referencia de mods sitúa la incorporación de la causa rewritten en next.error.cause en la v2.1.300. Los eventos api_request de OpenTelemetry desglosan las escrituras en caché en cache_creation_5m_tokens y cache_creation_1h_tokens, los spans de las trazas incluyen atributos de las convenciones semánticas de GenAI, como gen_ai.provider.name, gen_ai.conversation.id, gen_ai.tool.name y error.type, y un prompt que el hook prompt.submit de un mod haya reescrito o descartado ya no se registra como texto escrito por el usuario en el evento user_prompt. Las transcripciones locales ahora también registran el prompt del sistema, las herramientas y los parámetros de cada solicitud a API, de modo que una transcripción que compartas permita reproducir una solicitud con exactitud (consulta Mods y Telemetría).²⁷³²⁷⁴

Cambios operativos y de comportamiento. Las solicitudes grandes a api.anthropic.com usan gzip incluso con la telemetría desactivada; CLAUDE_CODE_GZIP_REQUEST_BODIES=0 lo desactiva. El valor updatedInput de los hooks PreToolUse y PermissionRequest se valida igual que la entrada del propio Claude: se descartan las claves desconocidas y, si la herramienta rechaza la entrada, se deniega la llamada. Al salir, se fuerza la terminación de los comandos en segundo plano que sigan ejecutándose 1,5 segundos después de haber recibido la orden de detenerse. claude remote-control elimina sus flags --sandbox y --no-sandbox, que no tenían efecto; pasar cualquiera de ellos provoca la salida con un error, y sandbox.enabled en la configuración es la forma de ejecutar esas sesiones en un entorno aislado. Las sesiones bajo CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST ignoran las variables de paquetes de certificados CA, proxy de herramientas, TLS de git y configuración de git, como SSL_CERT_FILE, definidas en la configuración. En las sesiones de Cowork en la nube, se ignora setMode de un hook PermissionRequest, pero se aplica el resto de su aprobación. La pestaña Code de Claude Desktop aplica la configuración administrada cuando forceLoginGatewayUrl indica una puerta de enlace operada por Anthropic que atiende el nombre de host de la sesión, y claude gateway se detiene al iniciar si encuentra una clave de política desktop: que no puede usar. Las opciones de /sandbox dicen «Ejecutar comandos en un entorno aislado». VS Code incorpora claudeCode.attachSelection para evitar que las selecciones del editor se incluyan en tus mensajes. En Slack, Claude Tag puede responder en canales de Slack Connect cuando un administrador lo permite.²⁷³

Correcciones que conviene conocer. Los hooks SessionEnd se ejecutan cuando sales mientras un comando sigue ejecutándose en segundo plano; ENABLE_TOOL_SEARCH=auto ya no se desactiva a mitad de una conversación; un inicio de sesión rechazado por forceLoginOrgUUID ya no deja almacenado el token de esa organización; las sesiones sin interfaz y de SDK que se reanudan después de una compactación conservan los mensajes preservados y el resumen; una conversación ya no falla en cada turno con un error 400 cuando API rechaza el esquema de entrada de una herramienta de MCP (en su lugar, la herramienta se envía sin parámetros); los hooks de agente respetan su model; las sesiones con --worktree parten del commit correcto cuando una etiqueta o rama tiene un nombre que parece un ID de commit y vuelven a abrirse en repositorios reftable; claude daemon stop --any espera, fuerza la terminación de un servicio bloqueado y sale con el código 1 si sigue presente; Write y Edit en sesiones de Cowork en la nube ya no indican que la operación se completó correctamente para una ruta de tu propia computadora; las sesiones en la nube ya no se quedan bloqueadas cinco minutos por turno cuando no se puede leer la política de la organización; y los ejecutores autoalojados ya no se congelan cuando nadie lee su salida.²⁷³

Novedades de la v2.1.299

Claude Code 2.1.299 se publicó el 14 de octubre de 2026 (npm a las 00:23 UTC; la versión de GitHub de las 02:49 UTC incluye los mismos 190 puntos que el CHANGELOG canónico). Las versiones 2.1.297 y 2.1.298 nunca se publicaron, así que no se omite ninguna. El valor de latest en npm fue 2.1.299 hasta que 2.1.300 se promovió más tarde ese día (consulta Novedades de la v2.1.300).²⁷¹²⁷³ Actualiza desde la 2.1.296: esta versión corrige dos regresiones introducidas en ella: los fallos de Edit y Reintentar en sesiones en la nube de Cowork y claude.ai al detener un mensaje mientras se ejecutaban sus hooks UserPromptSubmit o prompt.submit de mods, y la ejecución duplicada de una llamada a herramienta aprobada en sesiones en la nube o sin interfaz cuando llegaba un mensaje nuevo mientras la sesión se reanudaba tras un reinicio.

Compactación por inactividad (v2.1.299). Una conversación en la terminal con 200.000 tokens o más que permanezca inactiva durante unos 54 minutos ahora se compacta antes de que expire su caché de prompts de una hora, para que el siguiente mensaje no vuelva a procesar todo el contexto. CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS cambia el mínimo de 200.000 tokens (los valores inferiores a 100.000 se elevan a 100.000) y "idleCompaction": false en settings.json la desactiva; la referencia de configuración y la página de variables de entorno incluyen ambas opciones y las sitúan en la v2.1.290 o posterior. CLAUDE_CODE_DISABLE_FILE_MENTIONS=1 hace que una mención con @ entregue a Claude la ruta para que la lea con sus herramientas de archivos, en lugar del contenido del archivo, de modo que tus hooks PreToolUse se ejecuten durante la lectura; no se puede establecer desde la configuración del proyecto ni desde la configuración local (consulta Referencia de variables de entorno).²⁷¹²⁷² La v2.1.302 agrega una fila de Compactación por inactividad a /config para desactivarla o volver a activarla, y el aviso que aparece después de una compactación por inactividad explica cómo hacerlo.²⁷⁵

Permisos y MCP. Una regla de autorización como mcp__a ahora solo abarca el servidor llamado a, no a__b ni a_; escribe mcp__<server>__* con el nombre normalizado completo del servidor e incluye de la misma manera un servidor cuyo nombre contenga __ en la lista tools: de un agente, que ahora solo aporta las herramientas de ese servidor. Las reglas de denegación y solicitud de permiso para un servidor cuyo nombre normalizado contiene un guion bajo doble vuelven a aplicarse. Las descripciones de herramientas y las instrucciones de los servidores MCP propios de Anthropic en api.anthropic.com llegan completas a Claude, en lugar de truncarse a los 4.096 caracteres. Los conectores de sesiones en la nube y de Remote Control negocian de forma predeterminada el protocolo MCP 2026-07-28 en instalaciones que no obtienen flags (MCP_PROTOCOL_NEGOTIATION=legacy desactiva este comportamiento), las solicitudes al proxy de conectores de claude.ai y a los servidores MCP alojados por Anthropic ya no siguen redirecciones HTTP, MCP OAuth ahora envía los valores configurados de headers y headersHelper, un archivo .mcp.json vacío ya no se considera inválido y los servidores llamados constructor o prototype se conectan. Un comando ejecutado en un entorno aislado ya no puede escribir en una carpeta de --plugin-dir ni acceder a una ruta denegada mediante un enlace simbólico, las solicitudes de confirmación de rm ya no aparecen para un script de shell con -c que no ejecuta rm, y un rm construido durante la ejecución dentro de un script que Claude Code no puede leer solo solicita confirmación con CLAUDE_CODE_STRICT_INLINE_SHELL_RM_PROMPT=1.²⁷¹

Hooks y mods. Los hooks UserPromptSubmit se ejecutan antes de que se expanda una skill o un comando de barra personalizado, por lo que un hook que bloquea el prompt también detiene sus comandos de shell integrados, y el hook UserPromptSubmit del front matter de una skill se ejecuta por primera vez en el prompt posterior al que la invoca. Un hook de un plugin que no puede recibir una acción o devolver su respuesta ahora rechaza la acción en lugar de permitirla; si la herramienta ya se ejecutó, se retiene su resultado. En los mods, el hook turn.start también recibe los turnos de los subagents y de los compañeros de equipo (e.agentId permite distinguirlos), skill.prompt recibe el front matter, el origen, el nombre del plugin y la ruta del archivo de la skill (la referencia de mods sitúa estas incorporaciones en la v2.1.299), $.prompt.media permite que el hook prompt.submit de un mod de configuración administrada lea una imagen o un documento adjunto, $.session.identity() informa cómo se inició sesión, Text acepta size, weight, mono y tabular, y Box acepta niveles de espaciado con nombre (bold queda obsoleto en favor de weight), session.append incorpora una vía queue y agent.spawn se activa al reanudar un subagent o un compañero de equipo con resume establecido. Los mods desactivados de forma remota se descargan entre turnos, y /plugin y claude plugin validate identifican los hooks omitidos cuando una organización administra Claude Code (consulta Mods).²⁷¹²⁷² Comandos, interfaces y operaciones. /usage advierte sobre el esfuerzo máximo, los flujos de trabajo, el contexto permanente y los resultados extensos de herramientas. En la vista de agentes, /effort y /fast definen la configuración inicial de las sesiones nuevas; /model, /effort o /fast sin argumentos abre un selector, y el panel de vista previa muestra una línea de modo seguro para las sesiones iniciadas con --safe-mode. El modo de planificación muestra una nota una sola vez cuando no pedirá confirmación antes de la mayoría de las ediciones porque está disponible la opción de omitir permisos. claude plugin eval acepta --disallow-tools y el campo disallowed_tools en los casos de prueba; una ejecución que termina con un error de API recibe una puntuación de 0 y hace fallar la suite de pruebas. claude self-hosted-runner orchestrator --shutdown-drain-sec da tiempo a que las consultas y los hooks de creación en curso terminen al recibir SIGTERM. Cuando se usa una puerta de enlace de aplicaciones de Claude, CLAUDE_CODE_ATTRIBUTION_HEADER=0 en el env de una política code o cli elimina el bloque de atribución. En las sesiones en la nube de Cowork, un hook PermissionRequest ya no puede aprobar comandos de shell ni subagents en modo automático, y una acción de Claude in Chrome que el clasificador de seguridad marque en un sitio aprobado te pide confirmación en lugar de rechazarse. El comando para reanudar que se muestra al salir identifica la sesión por su ID; /btw en sesiones no interactivas agota el tiempo de espera después de 11 minutos; una sesión local puede supervisar 25 artefactos publicados, frente a los 10 anteriores; y el aviso de protección de ciberseguridad ya no te pide que solicites acceso al Cyber Verification Program.²⁷¹

Correcciones que conviene conocer. Las transmisiones a través de una ANTHROPIC_BASE_URL personalizada esperan 300 segundos a que lleguen datos en lugar de interrumpirse a los 180; las solicitudes a Anthropic de indicadores de funciones, inicio, modo rápido, perfil y configuración administrada por el servidor ya no incluyen la clave de API de una puerta de enlace de terceros; /usage y la línea de estado ya no muestran un uso superior al 100 %; las tareas programadas y los bucles ya no vuelven a ejecutarse después de cada turno durante la hora que se repite al finalizar el horario de verano; el uso de memoria ya no crece sin límite con --debug ni cuando un proceso padre deja de leer stderr; SendMessage encuentra un subagent por su nombre después de un reinicio; Read maneja archivos UTF-16LE con una marca de orden de bytes y Write se niega a convertir silenciosamente archivos Windows-1252, Shift-JIS, GBK o UTF-16BE a UTF-8; y, en Windows, los hooks PreToolUse y PermissionRequest que no especifican un shell bloquean la llamada cuando falta Git for Windows, en lugar de permitirla ante el fallo.²⁷¹

Novedades de v2.1.293-v2.1.296

Se publicaron cuatro versiones entre el 7 y el 9 de octubre de 2026. En npm, latest y next están en 2.1.296; stable pasa de 2.1.285 a 2.1.287.²³⁸ La principal novedad es un modelo nuevo: Claude Haiku 5.5 llega en v2.1.293 como el modelo que selecciona haiku en la API de Anthropic (consulta Modelos disponibles). Actualiza a v2.1.296 si inicias sesión en una puerta de enlace de aplicaciones de Claude mediante la configuración administrada: corrige una regresión de v2.1.295 que ignoraba un inicio de sesión guardado de la puerta de enlace cuando forceLoginMethod era gateway y no se había definido forceLoginGatewayUrl.

v2.1.296 (9 de octubre). Las lecturas de caché de Sonnet 5.5 se calculan a $0,10 por millón de tokens en /cost, la línea de estado, --max-budget-usd y las cifras de costos del SDK, que antes usaban $0,20. El límite predeterminado para las descripciones de herramientas de MCP enviadas al inicio y para las instrucciones de los servidores de MCP aumenta de 2.048 a 4.096 caracteres. Los metadatos de los subagents y las definiciones de --agents aceptan autoCompactWindow, de modo que un subagent puede compactar su contexto automáticamente antes que la conversación principal. CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL ejecuta todos los agentes de los flujos de trabajo con un mismo modelo, mientras los demás subagents conservan los suyos, y CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS establece un tiempo máximo de espera más largo entre reintentos ante errores 529. La herramienta Read acepta allow_large, para que Claude pueda leer en una sola llamada un archivo de texto que supere el límite de tamaño habitual cuando haya espacio en el contexto. Los hooks PreToolUse de la configuración administrada que deniegan una llamada a una herramienta con "continue": false, y los hooks prompt administrados que bloquean una, ahora también finalizan el turno además de rechazar la llamada. --debug identifica los campos de metadatos no reconocidos en los archivos de agentes personalizados y registra el comando, el plugin, el resultado y la duración de cada hook de comando. Las puertas de enlace de aplicaciones de Claude incorporan una clave code en managed.policies[], con la misma configuración que cli, que también se aplica en la pestaña Code de Claude Desktop. Ahora se detiene cualquier turno o comando ! iniciado mientras ← pasa la sesión a segundo plano, en lugar de dejar que termine fuera de la vista. La documentación ya se actualizó para reflejar dos de estos cambios: la referencia de hooks sitúa en v2.1.296 la incorporación de las líneas de --debug por hook, y la documentación de las puertas de enlace de aplicaciones de Claude describe la clave de política code; para el 14 de octubre, autoCompactWindow y CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS ya figuraban en la documentación de subagents y variables de entorno; al 14 de octubre de 2026, CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL seguía apareciendo únicamente en las notas de la versión.^238240270272

v2.1.295 (8 de octubre). Los hooks de comando y HTTP aceptan onFailure: "block": un hook que no puede iniciarse, agota el tiempo de espera o termina con un código inesperado bloquea la acción en lugar de permitirla (consulta Protocolo de entrada/salida de hooks). CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS limita cuánto tiempo espera el modo de reintentos desatendido ante errores 429 y 529. Los subagents precargan un máximo de 32 skills del campo skills, y las descripciones de herramientas de MCP cargadas mediante la búsqueda de herramientas se truncan a los 16.384 caracteres en lugar de 2.048. forceLoginMethod: "gateway" y forceLoginGatewayUrl ahora funcionan en tu propia configuración de usuario en una computadora sin configuración administrada, por lo que /login se abre en esa puerta de enlace, una configuración que ya describe la documentación; cada destino de la puerta de enlace acepta una lista opcional models, con * como comodín, y los destinos en la nube respetan timeouts.upstream_ttfb_ms. Las terminales que implementan Program Status Protocol (OSC 7501) pueden mostrar si Claude Code está trabajando, esperando tu respuesta o ha terminado. Las solicitudes en segundo plano que pasan por una puerta de enlace de aplicaciones de Claude usan Haiku 4.5 en lugar del modelo de la sesión cuando la puerta de enlace lo ofrece. Si una puerta de enlace, Bedrock, Vertex o Foundry rechaza la opción beta context-1m de un modelo [1m], la solicitud se reenvía sin esa opción en lugar de fallar. Ctrl+C en el indicador de entrada inactivo de una sesión en segundo plano a la que estás conectado no altera una activación pendiente de /loop, de modo que presionarlo dos veces te desconecta y el bucle sigue ejecutándose; Esc lo detiene. Los conectores de claude.ai negocian de forma predeterminada el protocolo MCP 2026-07-28 en instalaciones que no obtienen indicadores de funciones. /copy ofrece texto citado, claude -p indica en stderr qué está esperando después de su último turno, y los mods incorporan $.ui.notify. Las búsquedas web y las evaluaciones de hooks agent ya no tardan mucho más con los niveles de esfuerzo xhigh y max.²³⁸²⁴⁰

v2.1.294 (8 de octubre). Dos correcciones para los hooks prompt y agent redactados como instrucciones: un hook como «Bloquea los comandos que…» ya no permite lo que debería bloquear, y los hooks Stop y SubagentStop como «Continúa si la compilación falla» se evalúan de forma que Claude tenga menos probabilidades de detenerse antes de tiempo.²³⁸

v2.1.293 (7 de octubre). Claude Haiku 5.5 (claude-haiku-5-5) es el modelo Haiku predeterminado en la API de Anthropic: contexto de 1M, $0,10/$0,50 por millón de tokens y $0,50/$2,50 para prompts de más de 100K. Los datos de subagentStatusLine incorporan agentType, para que un script de la línea de estado pueda distinguir los tipos de subagents personalizados; los mods incorporan isDeferred en $.tool.register. Se revierten dos cambios: el mensaje de denegación del modo automático de v2.1.281, que indicaba a Claude que una denegación abarca el resultado y no solo el comando exacto, y la corrección de v2.1.290 para las sesiones en la nube que perdían una activación de /loop después de reiniciar el contenedor, por lo que esas sesiones vuelven a quedarse inactivas. Además, después de una compactación, Claude ya no da por completadas sus propias últimas acciones anteriores a ella; una conexión HTTP de MCP ya no conserva todas las solicitudes enviadas hasta que se cierra; claude purge enumera lo que no pudo eliminar y termina con el código 1 en lugar de detenerse en silencio; la sincronización de skills de claude.ai comprueba si hay cambios cada 40 minutos en lugar de cada 10 mientras no hay ninguna sesión en uso; y, al iniciarse, Team y Enterprise obtienen antes la política y la configuración administrada, con un nuevo intento tras 3 segundos si una solicitud se queda atascada.²³⁸²⁴⁰

Novedades de v2.1.288-v2.1.292

Se publicaron cinco versiones entre el 2 y el 6 de octubre de 2026. En npm, latest y next están en 2.1.292; stable se mantiene en 2.1.285.²³⁴ Actualiza si usas 2.1.288, 2.1.289 o 2.1.290: v2.1.291 corrige una regresión de 2.1.288 que podía provocar la pérdida de 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 perder las respuestas a las solicitudes de permisos.²³⁵ v2.1.292 (6 de octubre). Configurar CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS establece una demora base mayor para la espera entre reintentos de solicitudes rechazadas por sobrecarga (529); la documentación de variables de entorno ahora indica el valor predeterminado, 500 ms, y el rango aceptado, de 500 a 32000. La herramienta Agent acepta un parámetro effort, por lo que Claude puede ejecutar un subagent con el nivel de esfuerzo que le pidas; la documentación de subagents ahora describe este parámetro por invocación, que anula el campo del frontmatter y sigue vigente cuando se reanuda el subagent, mientras que CLAUDE_CODE_EFFORT_LEVEL tiene prioridad sobre ambos. claude plugin install --marketplace <source> agrega un marketplace e instala desde él con un solo comando de shell. Los servidores MCP locales (stdio) ahora negocian el protocolo 2026-07-28 de forma predeterminada en todas las instalaciones, incluidas las de Bedrock, Vertex y Foundry, con MCP_PROTOCOL_NEGOTIATION=legacy como opción para desactivar este comportamiento; la documentación de MCP ahora indica que se solicita esa revisión a los servidores stdio de forma predeterminada. Los nombres de agentes tienen un límite de 256 caracteres: los que lo superan se rechazan, los campos name más largos en archivos de skills o plugins se ignoran y la documentación de subagents ahora especifica el límite del campo name; si el nombre de un archivo de subagent lo supera, se omite el archivo y se registra un error en el registro de depuración. Una corrección de seguridad impide que las aprobaciones de hooks PreToolUse y el modo automático omitan la solicitud de permiso para leer archivos desde rutas de red (UNC). Mods incorpora prompt.autocomplete, almacenamiento en caché de prompts en $.model.complete y agentes de flujo de trabajo en agent.spawn; además, claude plugin test ahora falla si se rechaza una respuesta simulada. Al 6 de octubre de 2026, los demás cambios solo figuraban en las notas de la versión.^236237240

v2.1.290 (5 de octubre). La cuota de WebSearch interactivo se repone a razón de 100 llamadas por hora (CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR; 0 desactiva la reposición) en lugar de agotarse tras 200 llamadas. claude attach y claude logs aceptan parte del nombre de una sesión. /claude-api managed-agents-onboard <url> convierte una página que describe el patrón Managed Agents en archivos de ant apply, y /claude-api managed-agents-onboard <quickstart-name> crea una plantilla de inicio rápido de Console, como deep-researcher, con la CLI ant. Se vuelven más estrictos varios comportamientos predeterminados: la configuración de un proyecto ya no puede activar Claude en Chrome, los archivos .claude/settings.json o .claude/settings.local.json de un repositorio ya no pueden establecer CLAUDE_CODE_DISABLE_ATTACHMENTS, pyright y más variantes de ps solicitan permiso antes de ejecutarse, y un archivo de configuración administrada que enlaza fuera de la carpeta de configuración administrada genera una advertencia. WebFetch ahora indica cuánto contenido de una página quedó sin leer después de los 100.000 caracteres y acepta un offset para continuar la lectura, mientras que antes descartaba ese texto sin avisar. CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC también omite la preparación de la conexión al inicio, y CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS=5m ya no se interpreta como 5 ms: los valores con un sufijo de unidad hacen que se use la configuración dialogExpiry.²³⁵²³⁷

v2.1.290, equipos y puertas de enlace. La página de aprobación de inicio de sesión de la puerta de enlace de aplicaciones de Claude incorpora un botón Denegar, y su versión mínima compatible de PostgreSQL baja de 14 a 11. En ejecutores alojados en infraestructura propia, claude --environment <id> crea su sesión a través de la API actual de Sessions. claude --teleport y /teleport rechazan un stash que eliminaría archivos de una carpeta que reemplazó a un archivo bajo seguimiento con el mismo nombre, y el retransmisor de --channels ignora un ID de respuesta repetido en lugar de aprobar una solicitud de permiso distinta. En Slack, !fast cambia un hilo al modo rápido y !fast off vuelve al modo anterior. VS Code muestra las marcas de tiempo de los mensajes de forma predeterminada (la opción Claude Code: Mostrar marcas de tiempo de los mensajes las desactiva).²³⁵

v2.1.289 (3 de octubre). Mods incorpora agent.spawn para compañeros de equipo, un mismo ID de agente para todos los eventos de hooks de plugins y estados de inactividad y espera en $.agent.list(); claude plugin validate ya no omite un plugin cuya carpeta también contiene un manifiesto de marketplace; y se cierran dos brechas en las reglas de denegación de Bash cuando está activa la autorización automática del entorno aislado.²³⁵²³⁷

v2.1.288 (2 de octubre). claude project purge ahora se llama claude purge; el nombre anterior sigue funcionando y muestra un aviso. El límite de tiempo de los comandos en segundo plano solo se aplica en sesiones sin supervisión (-p, el SDK de Agent, CI y la nube). /code-review --max-findings <n>|all cambia el límite de hallazgos hasta que pases --max-findings default. /autocompact guarda su ventana por modelo. CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS desactiva las salidas estructuradas para Mantle o puertas de enlace que las rechacen. Las reglas con alcance por ruta y los archivos CLAUDE.md anidados se cargan al usar Write y Edit, no solo Read. Las solicitudes a los servidores de lenguaje agotan su tiempo de espera tras 60 segundos (requestTimeout por servidor) en lugar de quedarse bloqueadas. En modo automático, una conversación demasiado larga para el clasificador del lado del cliente se compacta en lugar de solicitar permiso para cada llamada a una herramienta, y el clasificador del lado del cliente ignora una selección fija mediante ANTHROPIC_DEFAULT_SONNET_MODEL que indique Claude Sonnet 5.5 u Opus 5.5 y usa Claude Sonnet 5 en su lugar. Mods incorpora $.ui.selection(), las sesiones en la nube sin la CLI de GitHub incluyen un gh api integrado, y presionar la flecha arriba en una entrada vacía restaura un borrador que Ctrl+C había borrado.²³⁴²³⁷

Nuevos comandos en v2.1.105–v2.1.114¹⁴⁶¹⁵⁰

Resumen de sesión (v2.1.108+)

Una nueva función a nivel de sesión que muestra el contexto cuando vuelves a una sesión pausada. Está activada de forma predeterminada y puedes desactivarla mediante /config o CLAUDE_CODE_ENABLE_AWAY_SUMMARY=0. El modelo también puede invocar comandos de barra integrados (/init, /review, /security-review) mediante la herramienta Skill, lo que amplía el patrón de subagents/skills.¹⁴⁶

Notificaciones push (v2.1.110+)

Cuando Remote Control tiene activada la opción «Enviar notificaciones push cuando Claude lo decida», Claude ahora puede enviar notificaciones push al móvil según su propio criterio mediante una nueva herramienta de notificaciones push. Se integra con la interfaz móvil/web existente de Remote Control.¹⁴⁶ /context, /exit y /reload-plugins ahora también funcionan desde los clientes de Remote Control.

Herramienta Windows PowerShell (v2.1.111+, implementación gradual)

Claude Code está implementando gradualmente una herramienta nativa de Windows PowerShell. En Linux/macOS, actívala con CLAUDE_CODE_USE_POWERSHELL_TOOL=1 (requiere pwsh en PATH). En Windows, la misma variable permite activarla o desactivarla durante la implementación gradual.¹⁴⁶

Aprobación automática en modo de permisos (v2.1.119+). Los comandos de la herramienta PowerShell ahora pueden recibir aprobación automática en modo de permisos, igual que los comandos de Bash. Las reglas de autorización como PowerShell(Get-*:*) y la sintaxis de patrones existente ahora omiten la solicitud de permiso para las operaciones de solo lectura, ofreciendo la misma comodidad de uso que los equipos ya tienen en Linux/macOS.¹⁵²

Reducción de solicitudes de permiso: Bash de solo lectura (v2.1.111+)

Los patrones de Bash de solo lectura con argumentos glob (p. ej., ls *.ts, cat src/*.md) y los comandos que empiezan con cd <project-dir> && ya no activan una solicitud de permiso.¹⁴⁶ En combinación con /less-permission-prompts, puedes esperar muchas menos interrupciones en tus flujos de trabajo cotidianos.

Trazado distribuido (v2.1.110+)

SDK y las sesiones sin interfaz ahora leen TRACEPARENT y TRACESTATE del entorno, lo que vincula las ejecuciones de Claude Code con trazas distribuidas. Combínalos con OTEL_LOG_RAW_API_BODIES=1 (v2.1.111+) para emitir los cuerpos completos de las solicitudes y respuestas de API como eventos de registro de OpenTelemetry para depuración.¹⁴⁶

Distribución de binarios nativos (v2.1.113+)¹⁵⁰

v2.1.113 cambia la forma en que se inicia CLI: claude ahora lanza un binario nativo de Claude Code mediante una dependencia opcional específica de cada plataforma, en lugar de ejecutar JavaScript incluido en el paquete. Los comandos de instalación y actualización siguen siendo los mismos, y los equipos no necesitan modificar sus scripts de despliegue.

Atajos del editor de prompts (v2.1.113+)¹⁵⁰

El editor de prompts incorpora navegación al estilo readline para entradas de varias líneas, además de desplazamiento del área visible en pantalla completa:

Tiempo de espera para subagents bloqueados (v2.1.113+)¹⁵⁰

Los subagents que se bloquean durante la transmisión ahora terminan con un error claro después de 10 minutos, en lugar de quedarse colgados sin avisar. Combina esta función con CLAUDE_STREAM_IDLE_TIMEOUT_MS (v2.1.84+) para cubrir más casos de procesos bloqueados en transmisiones de API.

Corrección de estabilidad en v2.1.114¹⁵⁰

v2.1.114 (18 de abril de 2026) incluye una sola corrección: el cuadro de diálogo de permisos podía fallar cuando un compañero de agent-teams solicitaba permiso para usar una herramienta. Actualiza si usas Agent Teams.

Marcado de contenido: marcas de agua en texto y metadatos C2PA en archivos (agosto de 2026)

Anthropic anunció un sistema de marcado legible por máquinas para el contenido generado por Claude, impulsado por el artículo 50 de la Ley de IA de la UE (exigible a partir del 2 de agosto de 2026 para los sistemas de IA recién lanzados). El sistema tiene dos componentes: una marca de agua estadística invisible en el texto generado y metadatos de procedencia firmados —según el estándar abierto C2PA— en archivos generados como .svg, .png y .jpg.²⁵²²⁰⁴ El detalle que los titulares no dejan claro: ambos componentes siguen el mismo calendario por modelo. Según la página de soporte, “los modelos de Claude lanzados a partir del 2 de agosto de 2026 admitirán el marcado legible por máquinas desde su lanzamiento”; los modelos lanzados antes de esa fecha, que constituyen toda la oferta actual (Fable 5, Opus 5, Sonnet 5, Haiku 4.5), están cubiertos por el período de transición de la legislación de la UE, y Anthropic está “trabajando para incorporar la compatibilidad con el marcado también en esos modelos”.²⁰⁴

Esa lista corresponde a agosto. Fable 5.1 (1 de septiembre), Opus 5.5 (22 de septiembre) y Sonnet 5.5 (28 de septiembre) se lanzaron después de la fecha límite, por lo que la regla los sitúa entre los que deben incorporar el marcado desde su lanzamiento; las notas de lanzamiento de Fable 5.1 incluyen la procedencia del contenido entre sus novedades, mientras que la página del modelo y la guía de migración de Opus 5.5, así como la página del modelo y la página de novedades de Sonnet 5.5, no mencionan el marcado.^241222230 Las salidas de los modelos anteriores a agosto no llevan ninguna marca, ni en texto ni en archivos; las de los modelos más recientes sí la llevarán, en todas las interfaces —Claude Platform (API), claude.ai, Claude Code, Claude Cowork, Claude Tag y las pasarelas en la nube—, ya que el marcado se aplica a nivel del modelo. Conviene explicitar una consecuencia, porque un hilo viral la interpretó al revés: cualquier cambio de estilo o comportamiento que percibas en uno de los modelos anteriores a agosto no puede deberse a las marcas de agua, porque el marcado no está activo en ellos.

Cómo funciona: es una variante de SynthID-Text de Google DeepMind. La marca de agua altera “la fuente de aleatoriedad utilizada para elegir entre palabras” cuando Claude elige entre opciones semánticamente equivalentes: no se añaden caracteres ni se realiza posprocesamiento y, según las pruebas internas de Anthropic, “la marca de agua no afecta al contenido, al nivel de creatividad ni a la legibilidad”.²⁵²

Lo que les interesará a los usuarios de Claude Code: el código lleva una marca de agua dispersa. El código funcional deja poco margen para decisiones arbitrarias, así que la marca se concentra donde hay libertad —comentarios, elección de nombres—, con lo que Anthropic describe como “un efecto insignificante en el código producido”.²⁵² Su persistencia es probabilística y varía según el componente: en el texto, una edición ligera “probablemente no elimine la marca de agua por completo”, una reescritura completa sí lo hará, y una traducción producida por Claude lleva su propia marca nueva; en los metadatos de archivos, la conversión de formato, volver a guardar el archivo y las capturas de pantalla pueden eliminar la firma C2PA.²⁰⁴ Está prevista una API de detección; un resultado positivo demuestra que “Claude probablemente intervino en el contenido en algún momento”, pero se aclara expresamente que no permite distinguir entre “Claude escribió esto” y “Claude editó esto en profundidad”; además, según la página de soporte, la ausencia de una marca tampoco demuestra nada. No se menciona ninguna opción para desactivar el marcado en ningún nivel de suscripción.²⁵²²⁰⁴

¿Cuánto cuesta Claude Code?

Comprender y controlar los costos es esencial para usar Claude Code de forma sostenible. Consulta también Selección de modelos para conocer las capacidades de cada modelo y Marcos de decisión para elegir el modelo adecuado para cada tarea.

Consulta de costos

> /cost

Salida:

Total cost:            $0.55
Total duration (API):  6m 19.7s
Total duration (wall): 6h 33m 10.2s
Total code changes:    247 lines added, 89 lines removed

Los usuarios con suscripción ven en /cost un desglose por modelo y aciertos de caché, que muestra exactamente qué modelos consumieron tokens y cuánto contenido se proporcionó desde la caché (v2.1.92+).¹³⁷

Tarifas contratadas en lugar del precio de lista (modelPricing, administrado, v2.1.243+): las organizaciones con tarifas negociadas por modelo o un multiplicador de descuento pueden implementarlos mediante la configuración administrada modelPricing; a partir de entonces, /cost, la línea de estado y las cifras de costos de telemetría usan esas tarifas en lugar del precio de lista, de modo que los números que ven los desarrolladores coinciden con lo que paga la organización.²⁵⁰ Desde la versión v2.1.271, el multiplicador también puede ser superior a 1 —hasta 10— para las organizaciones que cobran a sus equipos internos tarifas con margen adicional.²¹⁶

Línea de caché de prompts por sesión (v2.1.251+): /cost agrega una línea de caché de prompts para la sesión —proporción de aciertos, fallos, tokens almacenados nuevamente en caché y si la caché está activa o inactiva— junto con un objeto prompt_cache equivalente para los scripts de la línea de estado. El objeto aparece después de la primera respuesta de API de la conversación principal, no contabiliza las solicitudes de subagents y se calcula a partir de los recuentos de tokens de caché en las respuestas de API, por lo que funciona con todos los proveedores. /usage muestra las mismas estadísticas en su línea Prompt cache (main).²⁰⁶²⁰⁹ Desde la versión v2.1.260, la línea de /cost y el objeto prompt_cache de la línea de estado también indican una causa probable de los fallos de caché; por ejemplo, que cambiaron las definiciones de herramientas o el prompt del sistema, o que la sesión permaneció inactiva más allá del TTL de la caché.²¹²

El tráfico de agentes ya no rompe su propio prefijo de caché (v2.1.265): 2 correcciones eliminan fugas de la caché de prompts en el trabajo delegado. Reanudar un subagent iniciado en primer plano ya no cambia su lista de herramientas ni el prefijo del prompt del sistema; además, los agentes compañeros y los subagents reanudados ya no sacan del prefijo del prompt, en turnos posteriores, el contexto del hook SubagentStart ni las skills precargadas. Ambos errores impedían reutilizar la caché de prompts —el prefijo cambiaba, por lo que todo lo que aparecía después se volvía a enviar como entrada sin almacenar en caché— precisamente en las sesiones prolongadas con agentes donde más importa la economía de la caché (el mismo modo de fallo que v2.1.260 corrigió para los turnos con llamadas a herramientas de Fable 5.1).²¹⁵

El conjunto de mejoras de estabilidad de caché de v2.1.267: una versión, aproximadamente 10 correcciones, todas para el mismo modo de fallo: algo reescribía el prefijo del prompt a mitad de la conversación y todo lo posterior se volvía a enviar como entrada sin almacenar en caché. Las sesiones reanudadas ya no reescriben las listas de herramientas, vuelven a renderizar sus descripciones ni reescriben los anuncios anteriores de herramientas de MCP antes de que sus conectores se reconecten; cambiar de modelo con /model ya no vuelve a enviar todas las definiciones de herramientas (el texto de atribución de commits y PR ahora llega como una nota de la conversación que se actualiza cuando cambia el modelo); los subagents y las sesiones iniciadas con --system-prompt o --append-system-prompt registran una sola vez el prompt del sistema y las definiciones de herramientas; y las herramientas de MCP y los plugins que aparecen a mitad de la sesión llegan a las sesiones sin ToolSearch como definiciones diferidas, en lugar de hacerlo como una lista de herramientas reescrita. Este conjunto amplía las correcciones de v2.1.260 y v2.1.265 para abarcar la reanudación, el cambio de modelo y la reconexión de MCP.²¹⁶

v2.1.273 mantiene la continuidad: /login, /upgrade y /extra-usage descartaban el razonamiento anterior de la conversación, lo que obligaba a reescribir por completo la caché de prompts en la siguiente solicitud.²¹⁷

v2.1.277 cierra 3 fugas de prefijo adicionales: a las sesiones que continuaban después de /clear (reinicio, --continue, --resume) les faltaba parte del primer mensaje cuando un hook SessionStart generaba una salida, lo que provocaba un fallo completo de la caché de prompts; los subagents y compañeros reanudados volvían a renderizar las definiciones de herramientas de MCP que habían cargado, lo que impedía almacenar en caché los prompts de ese agente; y los archivos adjuntos registrados anteriormente en una conversación volvían a renderizarse después de reanudar o reiniciar, lo que eliminaba el razonamiento extendido y hacía que no se aprovechara la caché de prompts. Es el mismo modo de fallo que en los conjuntos de v2.1.265-267 —algo reescribía el prefijo y todo lo posterior se volvía a enviar sin almacenar en caché—, pero ahora abarca la salida de SessionStart, las definiciones de MCP de los agentes reanudados y los archivos adjuntos registrados.²¹⁹

v2.1.280 agrega 2 correcciones más: un cambio de modelo realizado desde una aplicación host (Claude Desktop, VS Code, SDK) mientras Claude está trabajando ya no provoca un fallo de la caché de prompts en el siguiente prompt; además, un subagent de bifurcación reanudado ahora vuelve a enviar la lista de herramientas que utilizó inicialmente en lugar de reconstruirla, lo que antes impedía almacenar en caché los prompts de ese agente.²²⁰

v2.1.281 agrega 3 correcciones más: una sesión reanudada después de un reinicio mientras había una solicitud de permiso pendiente ya no envía un historial distinto al anterior, algo que rompía la caché de prompts desde ese punto; un servidor MCP que se desconecta a mitad de una conversación, o que sigue conectándose después de reanudarla, ya no perjudica la caché cuando la búsqueda de herramientas está desactivada (por ejemplo, detrás de un proxy o una puerta de enlace); y las sesiones reanudadas ya no vuelven a enviar los turnos anteriores con un formato modificado, lo que podía hacer que API descartara el razonamiento previo de la conversación.²²⁴

Planes de suscripción

Límites de uso (agosto de 2025): Anthropic introdujo límites de uso semanales para los suscriptores de pago. Los suscriptores de Max pueden comprar uso adicional una vez superado el límite, a las tarifas estándar de API.¹⁴

Duplicación de los límites de uso (6 de mayo de 2026): durante el evento Code with Claude SF, Anthropic duplicó los límites de 5 horas de Claude Code en los planes Pro, Max, Team y Enterprise por licencia; eliminó la reducción durante las horas pico en las cuentas Pro y Max; y aumentó «considerablemente» los límites de uso de API para los modelos Claude Opus. El respaldo de capacidad es el acuerdo con SpaceX Colossus 1: «más de 300 megavatios de capacidad nueva (más de 220.000 GPU de NVIDIA) durante el mes».¹⁵⁷

Límites semanales a partir del 14 de septiembre de 2026 (anunciados el 29 de agosto): el aumento temporal del 50 % en los límites semanales, vigente desde el incremento de mayo, termina el 14 de septiembre y se sustituye por un aumento permanente del 25 % respecto del nivel de referencia anterior a dicho incremento para los planes Pro, Max, Team y Enterprise por licencia. Según los cálculos de Anthropic sobre el cambio: «En comparación con la situación actual, esto equivale a una reducción del 17 % en los límites semanales de Claude Code». Si tu límite semanal actual es de 150 unidades, pasará a ser de 125 el 14 de septiembre. Los límites de 5 horas no forman parte de este anuncio; la duplicación de mayo se mantiene. Si ejecutas sesiones prolongadas sin supervisión, planifica desde ahora teniendo en cuenta el límite inferior: el interruptor para continuar automáticamente tras el restablecimiento (v2.1.234) y /usage son los 2 controles relevantes.²¹³

Precios de tokens de API (octubre de 2026)^1144222239

Para los usuarios facturados mediante API, el precio por millón de tokens es el siguiente:

Precio del contexto de 1M (abril de 2026): Opus 4.7, Opus 4.6, Sonnet 4.6 y Mythos Preview incluyen 1M a las tarifas estándar por MTok, sin recargo por contexto largo.¹⁴⁸ Esta consolidación es reciente; las recomendaciones anteriores que indicaban que Opus 4.6 o Sonnet 4.6 costaban 2 veces más en la entrada y 1,5 veces más en la salida al superar los 200K tokens de entrada ya no están vigentes. Opus 4.5 y los modelos heredados anteriores conservan sus estructuras de precios originales.

Precio por residencia de datos: especificar que la inferencia se realice únicamente en EE. UU. mediante inference_geo agrega un multiplicador de 1,1 a todos los precios de tokens, incluidas las lecturas y escrituras de caché (modelos Opus 4.6 y posteriores).¹⁴⁸

El almacenamiento de prompts en caché reduce considerablemente los costos de entradas repetidas: las escrituras en caché cuestan 1,25 veces el precio base (caché de 5 minutos) o 2 veces (caché de 1 hora), pero las lecturas cuestan solo 0,1 veces, lo que supone un ahorro del 90 %. Hay 2 excepciones con precios aún más bajos: las lecturas de Claude Opus 5.5 cuestan 0,05 veces ($0.20/MTok, un ahorro del 95 %), mientras que las de Claude Fable 5.1 y Mythos 5.1 cuestan 0,025 veces ($0.25/MTok en Fable 5.1, un ahorro del 97,5 %).²⁴¹²²² En los sistemas RAG y los asistentes de programación con contexto repetido, el almacenamiento en caché puede reducir los costos entre un 88 % y un 95 %.

API por lotes ofrece descuentos del 50 % con un plazo de procesamiento de 24 horas para tareas que no son urgentes, como las suites de pruebas nocturnas.

Política sobre múltiples cuentas⁵²

¿Puedes tener varias cuentas de Claude? Sí, para casos de uso legítimos. Anthropic permite explícitamente varias cuentas cuando cumplen propósitos distintos.

Qué está permitido:

Límites técnicos: - Se pueden verificar hasta 3 cuentas con el mismo número telefónico - Se admiten explícitamente varias suscripciones de pago desde la misma IP o red - Las cuentas son completamente independientes; no se pueden transferir chats ni proyectos entre ellas

Qué está prohibido (según la Política de Uso): - Crear cuentas para evadir bloqueos después de recibir uno - Coordinar actividades maliciosas entre distintas cuentas para evitar su detección - Usar varias cuentas para eludir los límites de uso o los créditos del nivel gratuito

Nota sobre un caso real: en enero de 2026, el usuario avanzado Jeffrey Emanuel (@doodlestein) tenía 22 cuentas Max que fueron marcadas automáticamente y bloqueadas de forma temporal. Thariq (@trq212), empleado de Anthropic, resolvió el problema en menos de 4 horas tras confirmar que se trataba de un uso legítimo. Si utilizas Claude Code de forma intensiva para proyectos laborales y personales mediante varias cuentas, eso es exactamente para lo que está diseñado el servicio; pero no intentes manipular el sistema.

En caso de duda: comunícate con el equipo de soporte de Anthropic para obtener una confirmación por escrito sobre tu configuración específica.

Factores de costo

Ejemplos de costos reales

Costos según los precios de lista ($0.10/$0.50 para Haiku 5.5 en prompts de hasta 100K tokens, $2/$10 para Sonnet 5.5 y $4/$20 para Opus 5.5 por MTok), antes de aplicar los descuentos por caché de prompts.

Consejo para ahorrar costos: usar Haiku en los subagents de exploración y Sonnet para la implementación suele reducir los costos entre un 40 % y un 50 % frente a usar Sonnet para todo.

Gestión de costos para equipos

TPM/RPM recomendados según el tamaño del equipo:

Tarifas ocultas de las herramientas

Además del precio por token, algunas herramientas generan cargos independientes:⁹

Estos cargos se acumulan en los bucles de agentes. Un ciclo de depuración de 100 iteraciones con Bash cuesta aproximadamente 24,500 tokens de entrada adicionales solo por la sobrecarga.

Estrategias para ahorrar costos

1. Usa Haiku para los subagents: La mayoría de las tareas de exploración no necesitan Sonnet
2. Activa la caché de prompts: Está activada de forma predeterminada, pero verifica que no se haya desactivado
3. Establece un máximo de turnos: claude --max-turns 5 evita que las conversaciones se descontrolen
4. Establece un límite en dólares: claude --max-budget-usd 5 detiene por completo la sesión cuando alcanza el límite de gasto. Desde v2.1.217, el límite también se aplica a los subagents en segundo plano: una vez alcanzado, se rechazan las nuevas instancias y se detienen los agentes en segundo plano que estén ejecutándose (anteriormente, estos agentes no estaban sujetos al presupuesto)¹⁹⁴
5. Usa el modo de planificación para explorar: Sin ejecución, no hay operaciones costosas accidentales
6. Compacta de forma proactiva: Menos contexto = menos tokens
7. Limita la salida: export CLAUDE_CODE_MAX_OUTPUT_TOKENS=2000
8. Usa API por lotes para el trabajo que no sea urgente: 50 % de descuento tanto en los tokens de entrada como en los de salida
9. Analiza el gasto de API de Claude de un proyecto: /claude-api cost-optimize (v2.1.247+) analiza el gasto existente de API de Claude de un proyecto y aplica los mecanismos de ahorro (caché, uso eficiente de tokens, procesamiento por lotes, esfuerzo y elección de modelo), un cambio cuantificado a la vez, para las aplicaciones que desarrollas con API, no para la propia sesión de Claude Code²⁴⁵

Supervisión del uso

• Consola de Claude: platform.claude.com (requiere el rol Admin o Billing)
• Límites del espacio de trabajo: Establece límites de gasto por espacio de trabajo
• Bedrock/Vertex: Usa la supervisión de costos nativa de la nube
• LiteLLM: Para un seguimiento detallado por usuario con proveedores externos

Uso de tokens en segundo plano

Algunas operaciones consumen tokens en segundo plano: - Resumen de conversaciones para /resume - Comandos /cost y /status - Compactación automática

Por lo general, cuestan menos de $0.04 por sesión.

API de análisis de Claude Code (Team/Enterprise)⁴⁶

Accede mediante programación a los análisis de uso y las métricas de productividad de Claude Code de tu organización a través de API de administración.

Endpoint: GET /v1/organizations/usage_report/claude_code

Requisitos: - Clave de API de administración (sk-ant-admin...) - Plan Team o Enterprise - Rol Admin, Billing o Developer

Métricas disponibles:

Ejemplo de solicitud:

curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?starting_at=2026-01-15" \
  -H "x-api-key: sk-ant-admin..." \
  -H "anthropic-version: 2023-06-01"

Casos de uso: - Análisis de productividad de los desarrolladores (sesiones, commits, PR) - Métricas de uso de herramientas (tasas de aceptación/rechazo de Edit, Write, etc.) - Seguimiento y asignación de costos entre equipos - Justificación del ROI de las herramientas de programación con IA

Nota: los datos aparecen en el plazo de 1 hora tras finalizar la actividad. Para garantizar la coherencia, las respuestas solo incluyen datos con más de 1 hora de antigüedad.

Marcos de decisión

No basta con saber que las funciones existen. Necesitas saber cuándo usar cada una. Estos árboles de decisión convierten el conocimiento en acción.

¿Qué modelo debo usar?

START → Is the task simple? (file search, quick question, formatting)
         │
         ├── YES → Use Haiku
         │         Cost: ~$0.03/task
         │         Speed: Fastest
         │
         └── NO → Does it require deep reasoning?
                  (architecture, complex debugging, security analysis)
                  │
                  ├── YES → Use Opus 5.5 (medium effort default; /effort high or xhigh for harder)
                  │         Cost: ~$1.60/task
                  │         Quality: Highest (1M context at standard price, adaptive reasoning)
                  │
                  └── NO → Use Sonnet
                           Cost: ~$0.50/task
                           Balance: Best overall when cost matters

Regla general: desde la versión v2.1.280, el modelo predeterminado ya no depende de tu plan —cada sesión comienza con Opus 5.5, excepto en Microsoft Foundry—, por lo que la estrategia que antes consistía en «escalar a Opus» ahora se invierte: /model sonnet reduce el modelo para ahorrar la mitad del precio por token cuando una tarea no requiere ese nivel de razonamiento.^{181197207220221} Usa Haiku para los subagents. Mantén Opus cuando una respuesta generada con un modelo inferior parezca superficial. Con los agent teams (v2.1.32+), Opus puede coordinar varios agentes que trabajan en paralelo en distintas subtareas.⁷⁹

¿Comando, skill, subagent o agent team?

Do you want explicit control over when it runs?
│
├── YES → Use Slash Command
│         Example: /deploy, /test, /security-review
│         You invoke it. You control timing.
│
└── NO → Should the expertise apply automatically based on context?
         │
         ├── YES → Use Skill
         │         Example: Security patterns, domain rules, code standards
         │         Claude recognizes context and applies expertise.
         │
         └── NO → Does the work need isolated context?
                  │
                  ├── YES → Is there one subtask or many parallel subtasks?
                  │         │
                  │         ├── ONE → Use Subagent (Task tool)
                  │         │         Example: Deep exploration, parallel analysis
                  │         │         Prevents context bloat in main conversation.
                  │         │
                  │         └── MANY → Use Agent Team (v2.1.32+)
                  │                   Example: 5 agents reviewing different modules simultaneously
                  │                   Opus coordinates; each agent works independently.
                  │
                  └── NO → Just prompt directly
                           Not everything needs abstraction.

¿Hook o prompt?

Must the action ALWAYS happen, regardless of Claude's judgment?
│
├── YES → Use Hook (deterministic)
│         Examples:
│         - Format code after every edit
│         - Log all bash commands
│         - Block access to .env files
│         Claude cannot skip, forget, or decide otherwise.
│
└── NO → Use Prompt (probabilistic)
         Examples:
         - "Consider adding tests"
         - "Think about edge cases"
         - "Review for security if relevant"
         Claude decides based on context.

¿Cuándo usar el razonamiento extendido?

Is this a genuinely hard problem?
│
├── Architectural decision with many tradeoffs → YES, use thinking
├── Complex debugging with unclear root cause → YES, use thinking
├── Security analysis requiring careful reasoning → YES, use thinking
├── Understanding unfamiliar codebase → YES, use thinking
│
├── Routine bug fix → NO, skip thinking
├── Simple refactoring → NO, skip thinking
├── Code formatting → NO, skip thinking
└── Quick questions → NO, skip thinking

Actívalo o desactívalo con Alt+T durante la sesión. Los presupuestos de razonamiento más altos cuestan más; comienza con el mínimo y auméntalo solo si las respuestas parecen apresuradas.

Razonamiento adaptativo de Opus 4.6: Opus 4.6 ajusta automáticamente la profundidad del razonamiento según la complejidad del problema. Para la mayoría de las tareas, no es necesario controlar explícitamente el presupuesto de razonamiento: Opus lo aumenta ante problemas difíciles y mantiene la rapidez en los sencillos. Activar o desactivar manualmente el razonamiento resulta más útil con Sonnet cuando quieres forzar un análisis más profundo.

¿Qué superficie de ejecución usar?

Where should this work happen?
│
├── Requires YOUR local files and tools
│   │
│   ├── Interactive, iterative work → Main REPL session
│   ├── One-shot scripted task → claude -p "prompt" (print mode)
│   ├── CI/CD automation → claude -p --json (non-interactive + structured output)
│   └── Parallel isolated tasks → Subagents via Task tool
│
├── Requires SOMEONE ELSE'S environment
│   │
│   └── Remote codebase or server → Background agent (cloud)
│
└── Doesn't require any environment
    │
    ├── Research or analysis → Subagent with Explore type
    └── Web content extraction → WebFetch / WebSearch tools

Agent teams, subagents o sesiones paralelas

Do you need multiple agents working on related subtasks?
│
├── YES → Are the subtasks independent (no shared state)?
│         │
│         ├── YES → Can they share the same codebase?
│         │         │
│         │         ├── YES → Use Agent Team (v2.1.32+)
│         │         │         Opus coordinates. Agents share repo access.
│         │         │         Example: "Review auth, API, and DB modules in parallel"
│         │         │
│         │         └── NO → Use Parallel Sessions (separate terminals)
│         │                  Each has its own working directory.
│         │                  Example: "Fix repo-A and repo-B simultaneously"
│         │
│         └── NO → Use Sequential Subagents
│                  Results from one feed into the next.
│                  Example: "Explore → Plan → Implement"
│
└── NO → Use Single Subagent or Main REPL