Explicación de CLAUDE_CODE_MAX_OUTPUT_TOKENS: límites de salida y carpetas de plugins en Claude Code 2.1.265

Qué controla claude_code_max_output_tokens

La referencia de variables de entorno describe CLAUDE_CODE_MAX_OUTPUT_TOKENS como la variable que establece «el número máximo de tokens de salida para la mayoría de las solicitudes». Esa formulación importa: describe un presupuesto de salida por solicitud, con valores predeterminados y límites que varían según el modelo.

Por tanto, la variable es relevante al investigar un límite de salida de Claude Code. No debe tratarse como un límite universal para todos los tipos de datos que maneja Claude Code. La versión 2.1.265 también introduce un límite en disco para los resultados de herramientas guardados, pero ese límite mide los datos de herramientas almacenados en gigabytes, no la salida generada en tokens.

Hay una salvedad histórica respecto a la documentación de configuración. La referencia de variables de entorno se actualiza continuamente y no se recuperó su revisión exacta de septiembre de 10. Su descripción explica la finalidad de la variable, pero la página no establece todos los valores predeterminados que se aplicaban a Claude Code 2.1.265.

Para un artículo fechado, la evidencia numérica más sólida procede de las notas de versión etiquetadas por versión. Esas notas establecen cambios anteriores específicos sin necesidad de inferir una tabla completa de valores predeterminados a partir de la documentación actual.

Tres límites que deben distinguirse

Al diagnosticar un límite, primero identifique cuál de estos se aplica. Un ajuste del presupuesto de tokens y un límite de almacenamiento en disco requieren interpretaciones distintas, incluso cuando ambos aparecen durante la misma sesión de desarrollo.

Valores predeterminados y límites máximos de salida verificados

El Notas de la versión v2.1.77, fechadas el 17 de marzo de 2026, documentan dos cambios relevantes: el valor predeterminado de Claude Opus 4.6 aumentó a 64k tokens de salida y el límite superior para Opus 4.6 y Sonnet 4.6 aumentó a 128k tokens. Estos cambios también se conservan en el registro de cambios etiquetado como v2.1.265.

Esa evidencia descarta presentar «32,000 por defecto, 64,000 como máximo» como una regla universal de Claude Code. Tampoco justifica completar los valores predeterminados que faltan para otros modelos.

La distinción precisa es entre un cambio documentado y una referencia de configuración completa. La versión de marzo establece los cambios anteriores; las fuentes fechadas disponibles no establecen una tabla completa de valores predeterminados por modelo para v2.1.265.

Las especificaciones de los modelos más recientes no establecen los valores predeterminados de la CLI

El notas de lanzamiento de los modelos documentan una salida máxima de 128k y una ventana de contexto de 1 millones de tokens para Claude Sonnet 5, Claude Opus 5 y Claude Fable 5.1. Sus identificadores exactos de API son claude-sonnet-5, claude-opus-5y claude-fable-5-1, respectivamente.

Esos anuncios estaban disponibles antes de la fecha de corte de publicación: Sonnet 5 el 30 de junio, Opus 5 el 24 de julio y Fable 5.1 el 1 de septiembre de 2026. Sin embargo, sus especificaciones de modelo no constituyen evidencia del presupuesto predeterminado por solicitud de Claude Code.

Para los desarrolladores que estén eligiendo un modelo, la guía de modelos de Claude Code ofrece lecturas relacionadas. Mantenga separado el máximo publicado del modelo del presupuesto de salida predeterminado que utiliza la CLI.

Configurar la variable y comprender la compactación

La documentación actual permite establecer la variable antes de iniciar claude, o colocarla bajo la env clave en settings.json. Como no se recuperó la revisión exacta de la documentación disponible el 10 de septiembre, los ejemplos siguientes son patrones de configuración documentados sujetos a esa salvedad histórica.

Configuración en el shell

El ejemplo de shell proporcionado establece el presupuesto de salida en 64,000 tokens:

export CLAUDE_CODE_MAX_OUTPUT_TOKENS=64000

El patrón documentado consiste en establecer la variable antes de iniciar Claude Code. El número de este ejemplo es un valor de configuración elegido; no afirma que 64,000 sea el valor predeterminado o máximo para todos los modelos.

Al registrar la configuración de un proyecto o una sesión de resolución de problemas, identifique el modelo seleccionado junto con el presupuesto solicitado. Sin el modelo, un valor por sí solo no permite determinar si coincide con un valor predeterminado documentado o si se encuentra dentro de un límite superior documentado.

Configuración en settings.json

El ejemplo equivalente de JSON proporcionado coloca la variable bajo env:

{"env":{"CLAUDE_CODE_MAX_OUTPUT_TOKENS":"64000"}}

El valor es una cadena en este ejemplo. Al igual que el ajuste en el shell, el fragmento expresa un presupuesto solicitado, sin demostrar un valor predeterminado específico de un modelo.

Para consultar información relacionada con el uso de la línea de comandos, consulte la referencia de la CLI de Claude Code. La evidencia histórica aquí respalda la función de la variable y los ejemplos de configuración proporcionados, mientras que los valores predeterminados completos de v2.1.265 siguen sin determinarse.

¿Qué se ha verificado sobre la compactación?

El registro de cambios etiquetado como v2.1.265 recoge una corrección anterior en v2.1.69 para CLAUDE_CODE_MAX_OUTPUT_TOKENS que se ignoraba durante la compactación de la conversación. Esa es una relación verificada entre este ajuste y el comportamiento de compactación.

La referencia actual de variables de entorno también explica que aumentar el ajuste reduce el contexto efectivo disponible antes de la compactación automática. La fecha de publicación de esa explicación es incierta, por lo que no puede presentarse como una descripción verificada de septiembre de 10.

Por tanto, no debe describirse el ajuste como una ampliación de la ventana de contexto publicada del modelo. La evidencia fechada establece un control del presupuesto de salida y una corrección relacionada con la compactación; no establece un umbral preciso de compactación para cada modelo en v2.1.265.

Cómo carga Claude Code 2.1.265 las carpetas de plugins

Claude Code v2.1.265 se lanzó el 8 de septiembre de 2026, con el commit de lanzamiento 8e02f6d. Su cambio en la carga de carpetas permite que --plugin-dir apunte a una carpeta que contenga varios plugins.

La invocación proporcionada es:

claude --plugin-dir ./plugins

La versión describe directamente la regla de detección: «se carga cada subcarpeta que tenga un manifiesto». También indica que las incorporaciones y eliminaciones se detectan mientras Claude Code está en ejecución.

Esto convierte a la carpeta principal en la unidad útil para gestionar varios plugins conjuntamente. El comportamiento documentado se refiere a las subcarpetas que contienen manifiestos; las notas de versión no especifican una detección recursiva. No dé por hecho que se explorará un árbol de directorios con un anidamiento arbitrario.

Estructura del manifiesto y salvedad histórica

La referencia actual de plugins sitúa el manifiesto en .claude-plugin/plugin.json y los directorios de componentes, como skills/, commands/y hooks/ en la raíz del plugin. No se recuperó esa referencia como una instantánea fechada de v2.1.265.

Para el artículo del 10 de septiembre, distinga esas indicaciones actuales sobre la estructura de la garantía explícita de la versión: se cargan las subcarpetas con manifiestos. La versión establece la detección de carpetas con varios plugins sin establecer todos los detalles de la documentación sobre la estructura disponible en aquel momento.

Correcciones de plugins incluidas en la versión

La versión 2.1.265 también corrige tres problemas de plugins:

• Una ruta de plugin que contuviera barras invertidas podía eludir la restricción de contención de enlaces simbólicos en macOS y Linux.
• Los directorios que comenzaban con dos puntos se rechazaban incorrectamente.
• Las carpetas de componentes predeterminadas que no podían leerse se omitían sin aviso; ahora aparecen en /plugin con un código de error.

Estas correcciones se refieren a las rutas de plugins y a la carga de componentes. Si una carpeta de plugin no se carga, aportan contexto relevante sobre la versión, pero el ajuste de tokens de salida no explica esos problemas de gestión de directorios.

El límite de 1 GB para resultados de herramientas guardados es un límite independiente

La versión 2.1.265 añade un límite de 1 GB para los resultados de herramientas guardados en disco. La vista previa de la conversación informa del truncamiento.

Este límite se refiere a los datos de herramientas almacenados. CLAUDE_CODE_MAX_OUTPUT_TOKENS se refiere al máximo de tokens de salida para la mayoría de las solicitudes. La versión no describe la variable de entorno como un control del límite en disco, por lo que aumentar su valor no debe presentarse como una solución al truncamiento de los resultados de herramientas guardados.

Las notas de versión tampoco especifican si el límite de 1 GB se aplica por resultado, por sesión o a alguna otra agrupación. Mantenga esa incertidumbre al documentar el comportamiento: «límite de 1 GB para los resultados de herramientas guardados en disco» es la descripción verificada.

Una distinción útil para resolver problemas es la evidencia que se muestra al desarrollador. Una vista previa de la conversación que informa de un truncamiento está relacionada con el nuevo comportamiento de los resultados guardados. Una pregunta sobre el presupuesto de salida generada de un modelo corresponde al modelo seleccionado y al ajuste de tokens. Un código de error de plugin en /plugin corresponde a la carga de plugins.

Estos son controles y diagnósticos independientes introducidos o tratados en el contexto de la misma versión. Abordarlos por separado evita que un cambio en la configuración de tokens se use para explicar comportamientos no relacionados del almacenamiento o de las carpetas.

La versión de seguimiento de la pasarela disponible a fecha del 10 de septiembre

La versión 2.1.266 también se publicó el 8 de septiembre, por lo que queda dentro de la fecha de corte de este artículo. Las Notas de la versión v2.1.266 corrigen una regresión de autenticación de la pasarela en v2.1.265 relacionada con CLAUDE_CODE_USE_GATEWAY.

El error en cuestión es «No se ha iniciado sesión en la pasarela de la nube». Las notas de la versión indican que no es necesario cambiar la configuración.

Para un desarrollador que encuentre esa regresión concreta en v2.1.265, la versión de seguimiento es directamente pertinente. Aumentar el presupuesto de tokens de salida o reorganizar las carpetas de plugins no es la solución documentada.

Los mismos flujos de trabajo pueden ejecutarse a través de un gateway de API como AI Prime Tech; consulta cómo usar Claude Code con una clave de API para obtener orientación relacionada con la configuración. AI Prime Tech opera de forma independiente y no está afiliada a Anthropic ni a OpenAI.

Puntos clave

• CLAUDE_CODE_MAX_OUTPUT_TOKENS establece el máximo de tokens de salida para la mayoría de las solicitudes; los valores predeterminados y los límites varían según el modelo.
• v2.1.77 aumentó el valor predeterminado de Opus 4.6 a 64k y el límite superior de Opus 4.6/Sonnet 4.6 a 128k. Sigue sin verificarse una tabla completa de valores predeterminados de v2.1.265.
• El máximo de salida del modelo, la capacidad de contexto del modelo y el almacenamiento de resultados de herramientas son límites independientes.
• En v2.1.265, --plugin-dir puede cargar varios plugins desde carpetas secundarias con manifiestos y detectar adiciones y eliminaciones durante la ejecución.
• v2.1.265 introduce el límite de 1 GB para los resultados de herramientas guardados; v2.1.266 corrige la regresión de autenticación de la pasarela sin necesidad de cambiar la configuración.

Preguntas frecuentes

¿Qué controla CLAUDE_CODE_MAX_OUTPUT_TOKENS?

CLAUDE_CODE_MAX_OUTPUT_TOKENS establece el número máximo de tokens de salida para la mayoría de las solicitudes. Sus valores predeterminados y límites varían según el modelo, y es independiente del límite de 1 GB de v2.1.265 para los resultados de herramientas guardados en disco.

¿Cuáles son los límites de salida predeterminados y máximos?

v2.1.77 aumentó el valor predeterminado de Claude Opus 4.6 a 64k tokens de salida y el límite superior de Opus 4.6/Sonnet 4.6 a 128k. Las fuentes fechadas que se revisaron no establecen el valor predeterminado de Sonnet 4.6 ni una tabla completa de valores predeterminados por modelo para v2.1.265.

¿Aumentar este ajuste amplía la ventana de contexto?

Su finalidad documentada es establecer un presupuesto de tokens de salida, no ampliar la ventana de contexto publicada del modelo. v2.1.69 corrigió el problema por el que se ignoraba la variable durante la compactación, pero la explicación de su efecto sobre la compactación automática en la documentación actual tiene una fecha de publicación incierta.

¿Cómo descubre --plugin-dir varios plugins?

En Claude Code 2.1.265, --plugin-dir puede apuntar a una carpeta principal, y se carga cada carpeta secundaria que contiene un manifiesto. Las adiciones y eliminaciones se detectan mientras Claude Code está en ejecución; las notas de la versión no especifican el descubrimiento recursivo.