Claude Code 2.1.323: corrige errores de contexto 1M en gateways

Claude Code 2.1.323 elevó de 200K a 1M el contexto que supone para los IDs de modelo desconocidos. Si el gateway admite menos tokens, las sesiones largas pueden fallar en cada turno. Revisa la corrección de 2.1.325, configura el límite real con CLAUDE_CODE_MAX_CONTEXT_TOKENS y ajusta la compactación automática. Incluye las reglas para [1m], una configuración de BetterToken con DeepSeek o Kimi y los pasos para recuperar una conversación bloqueada.

Índice
Claude Code 2.1.323: corrige errores de contexto 1M en gateways

Claude Code 2.1.323 cambió de 200K a 1M tokens el contexto que supone para los IDs de modelo que no reconoce. Si tu modelo externo o gateway admite menos tokens, Claude Code puede compactar demasiado tarde y empezar a fallar en cada turno. Actualiza a Claude Code 2.1.325 o posterior y configura la ventana real del modelo o un umbral de compactación más temprano.

No limites automáticamente todas las sesiones de DeepSeek, GLM o Kimi a 200K. Algunos modelos actuales admiten 1M tokens. Reducir esa capacidad sin necesidad hace que Claude Code descarte antes parte del contexto útil de tu proyecto.

Esta guía explica los cambios de las versiones 2.1.323 a 2.1.325, las tres opciones de configuración y cómo recuperar una sesión que ya falla.

¿Qué cambió en Claude Code 2.1.323, 2.1.324 y 2.1.325?

La versión 2.1.323 introdujo la nueva ventana supuesta. Las dos versiones siguientes corrigieron comportamientos relacionados con los IDs personalizados y los errores de contexto de los gateways.

El registro oficial de cambios de Claude Code documenta lo siguiente:

VersiónCambio relacionado con el contextoQué hacer
2.1.323Los IDs desconocidos pasan de una ventana supuesta de 200K a 1M tokens.Comprueba el límite real antes de iniciar una sesión larga.
2.1.323Con modelos externos de ventana menor, todos los turnos pueden fallar cuando se llena el contexto, hasta ejecutar /clear.Configura la ventana antes de alcanzar el límite.
2.1.324CLAUDE_CODE_MAX_CONTEXT_TOKENS también se aplica a IDs desconocidos que empiezan por claude-.Actualiza si tu gateway utiliza uno de esos alias.
2.1.325Se corrigió un fallo que hacía que las sesiones devolvieran errores de longitud de contexto en cada turno en vez de compactarse, en muchos gateways externos y despliegues de Foundry.Prueba la actualización antes de aplicar soluciones más invasivas.

A fecha de 2026-11-15, npm mostraba 2.1.325 como latest y 2.1.311 como stable para @anthropic-ai/claude-code.

La versión stable 2.1.311 todavía no incorpora el nuevo comportamiento de 2.1.323. Tampoco incluye las correcciones posteriores.

Comprueba la versión instalada en tu equipo:

claude --version

Si instalaste Claude Code mediante el instalador nativo, utiliza el comando de actualización documentado:

claude update
claude --version

Si sigues deliberadamente el canal stable, verifica primero el ejecutable que tienes instalado. No supongas que se comporta como el paquete marcado latest.

La corrección de 2.1.325 afecta a muchos gateways, no necesariamente a todos. Tampoco garantiza que Claude Code detecte una restricción menor impuesta por el gateway.

¿Por qué un ID de modelo desconocido puede bloquear una sesión larga?

Claude Code consulta los modelos que reconoce y su configuración local para decidir cuándo compactar una conversación.

La compactación resume los mensajes anteriores para que la siguiente petición quepa en la ventana de contexto. Un gateway puede exponer un ID personalizado que no permita a Claude Code identificar el modelo real.

Imagina un gateway que ofrece my-coding-model con un límite efectivo de 200,000 tokens.

Antes de 2.1.323, Claude Code suponía 200K para ese ID desconocido. Desde 2.1.323 supone 1M, salvo que una configuración cambie el valor.

Ni el modelo ni el gateway han aumentado su capacidad. Solo ha cambiado la estimación que hace Claude Code.

Si la conversación supera el contexto admitido por el gateway, la API puede rechazar la petición. La conversación demasiado larga sigue guardada en la sesión. Por eso la siguiente petición puede fallar de la misma forma.

Anthropic describió este problema expresamente en el registro de cambios de 2.1.323. La versión 2.1.325 mejora la recuperación en muchos gateways. Aun así, debes configurar una ventana menor cuando el límite efectivo lo requiera.

¿Qué IDs de modelo pueden verse afectados?

Existe riesgo cuando la ventana supuesta por Claude Code supera la capacidad real de la ruta de API.

Revisa estos casos:

  • Un modelo que no es Claude, como deepseek-v4.1-flash-1017 o kimi-k3.1-pro, si Claude Code no reconoce su ID.
  • Un alias del gateway, como my-coding-model, aunque el proveedor subyacente utilice realmente Claude.
  • Un ID desconocido que empiece por claude-, como claude-sonnet-latest. La versión 2.1.324 cambió cómo se aplica la configuración a estos nombres.
  • Un ID con el sufijo [1m], que sigue reglas específicas de anulación de la ventana.

Que Claude Code no reconozca un ID no significa, por sí solo, que exista un límite incorrecto.

Un modelo que realmente admita 1M tokens puede funcionar con el nuevo valor. El problema aparece si el modelo, el gateway o el despliegue impone un límite inferior.

También hay diferencias entre un alias desconocido y un ID que Claude Code resuelve como un modelo Claude conocido. En algunos casos reconoce el nombre de Anthropic incluido dentro del ID de otro proveedor. Las reglas de configuración dependen de cómo se resuelva ese nombre.

Consulta la documentación de Anthropic sobre ventanas de modelos personalizados antes de asumir que un patrón de ID funciona de una forma concreta.

¿Qué solución debes elegir para la ventana de contexto?

Utiliza CLAUDE_CODE_MAX_CONTEXT_TOKENS si conoces el límite efectivo y el ID admite esa configuración. Utiliza CLAUDE_CODE_DISABLE_1M_CONTEXT=1 si necesitas volver rápidamente a 200K. Ajusta la compactación automática si quieres dejar margen antes del límite.

SoluciónCuándo utilizarlaLimitación
CLAUDE_CODE_DISABLE_1M_CONTEXT=1El modelo admite al menos 200K y quieres recuperar la restricción anterior.Reduce a 200K algunos modelos que sí admiten 1M. No basta si la ventana real es inferior a 200K.
CLAUDE_CODE_MAX_CONTEXT_TOKENSConoces la ventana efectiva de un modelo desconocido o alias de gateway.Depende de cómo se reconozca el ID, de la versión y de [1m].
/autocompact, --autocompact o CLAUDE_CODE_AUTO_COMPACT_WINDOWQuieres compactar antes de alcanzar la ventana supuesta.El mínimo configurable documentado es 100K. El umbral debe caber en el límite real.

No son ajustes equivalentes. Uno establece una restricción general de 200K, otro cambia la capacidad que supone Claude Code y el tercero determina cuándo compacta la conversación.

Solución 1: volver a la restricción de 200K

Si tu modelo o gateway admite al menos 200K tokens, ejecuta Claude Code desde Bash con:

export CLAUDE_CODE_DISABLE_1M_CONTEXT=1
claude

Esta es la solución provisional mencionada en el registro de cambios de 2.1.323.

Para mantenerla entre sesiones, añade la variable bajo env en ~/.claude/settings.json:

{
  "env": {
    "CLAUDE_CODE_DISABLE_1M_CONTEXT": "1"
  }
}

Con esta variable activa, Claude Code también elimina las variantes [1m] del selector de modelos.

En modelos que normalmente tienen una ventana nativa de 1M, la compactación automática mantiene la sesión dentro de 200K. Si la compactación está desactivada, la sesión se detiene al llegar al límite aplicable.

Existe una excepción importante. Con un ID desconocido, otra configuración puede impedir que se aplique la restricción.

Si aparece este aviso:

CLAUDE_CODE_DISABLE_1M_CONTEXT is set, but the 200K limit isn't enforced for <model>, so this session can grow past it.

Comprueba si elevaste CLAUDE_CODE_MAX_CONTEXT_TOKENS por encima de 200K o si desactivaste la aplicación de la ventana para modelos desconocidos.

La referencia oficial de errores recomienda CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000 si necesitas garantizar que la compactación actúe en ese límite.

No utilices esta solución por sí sola cuando el gateway admita menos de 200K tokens.

Solución 2: declarar la ventana real con CLAUDE_CODE_MAX_CONTEXT_TOKENS

Es la opción más precisa cuando conoces el límite de la ruta utilizada.

Supongamos que el administrador del gateway confirma una ventana efectiva de 200,000 tokens para un modelo personalizado. Establece la variable en el shell Bash que inicia Claude Code:

export CLAUDE_CODE_MAX_CONTEXT_TOKENS=200000
claude

El valor 200,000 es un ejemplo hipotético. No es una recomendación general para todos los modelos ni un límite confirmado para DeepSeek o Kimi.

Para un ID desconocido que no empiece por claude- ni contenga [1m], la variable se aplica directamente. Claude Code mantiene la compactación preventiva usando la ventana declarada.

La referencia oficial sobre los IDs compatibles con esta variable documenta dos excepciones:

  • Si un ID desconocido contiene [1m], también necesitas CLAUDE_CODE_DISABLE_1M_CONTEXT=1 para corregir una ventana menor y conservar la compactación preventiva.
  • Si el ID se resuelve como un modelo Claude reconocido, la anulación solo funciona con DISABLE_COMPACT. Como esa variable desactiva toda la compactación, no es la opción preferida para sesiones largas normales.

Los IDs desconocidos que empiezan por claude- admiten la anulación directa desde 2.1.324. Las versiones anteriores pueden tratarlos de forma diferente.

Si el alias del gateway corresponde realmente a un modelo Claude conocido, puedes utilizar modelOverrides o modelPicker.behavesAs para establecer esa correspondencia.

No asignes a un modelo que no es Claude una identidad de Claude solo para quitar un aviso.

El valor correcto es el límite efectivo de la ruta de API seleccionada. Si el gateway impone una restricción menor, no uses la capacidad máxima anunciada del modelo en su lugar.

Solución 3: compactar antes con /autocompact

Un umbral más temprano deja espacio para resumir la conversación antes de que el gateway rechace la petición.

Para una ruta con límite real confirmado de 200K, puedes utilizar este ejemplo conservador:

/autocompact 150k

Ejecuta el comando dentro de Claude Code. Normalmente guarda el umbral para el modelo actual bajo modelSettings y lo aplica a la sesión en curso.

Lee la respuesta de /autocompact para comprobar qué umbral está utilizando realmente la sesión. Un ámbito de configuración con mayor prioridad, como los ajustes administrados, puede mantener otro valor incluso después de guardar el tuyo. El comando informa de ese conflicto.

Si la configuración administrada impide aplicar el umbral, pide al administrador que revise la política. Según la referencia de Anthropic sobre compactación automática, el indicador --autocompact de un solo inicio no queda anulado por los ajustes administrados.

Para iniciar una sola sesión:

claude --autocompact 150k

Para scripts, contenedores u otros entornos automatizados:

export CLAUDE_CODE_AUTO_COMPACT_WINDOW=150000
claude

El comando /autocompact y el indicador --autocompact admiten valores de 100K–1M tokens. La variable CLAUDE_CODE_AUTO_COMPACT_WINDOW acepta de 100000 a 1000000.

Si Claude Code acepta el valor de la variable, esta tiene prioridad sobre el comando, el indicador y las preferencias guardadas. En ese caso, /autocompact informa de la anulación y no guarda un valor nuevo.

También puedes establecer autoCompactWindow en ~/.claude/settings.json para varios modelos. Dentro del mismo ámbito de configuración, el valor guardado mediante /autocompact para un modelo tiene prioridad sobre la opción general.

150k solo es un ejemplo de margen para un gateway que admite 200K. No presupone que ese umbral sirva para cualquier modelo con una ventana inferior.

El mínimo configurable es 100K. Si el modelo admite menos, revisa las reglas de anulación y el comportamiento efectivo del cliente. No des por hecho que /autocompact 50k está permitido.

Ejemplo con BetterToken: configurar Claude Code con DeepSeek o Kimi

BetterToken ofrece una API compatible con Anthropic en https://bettertoken.ai para los modelos admitidos. La dirección ANTHROPIC_BASE_URL de Claude Code no lleva /v1.

Hay que distinguir la documentación de integración de BetterToken del soporte oficial de Anthropic. En su documentación de gateways LLM, Anthropic indica que no admite el uso de Claude Code con modelos que no sean Claude a través de ningún gateway.

BetterToken documenta su propia integración de terceros. Eso no convierte el uso de DeepSeek o Kimi en una configuración respaldada oficialmente por Anthropic. Debes comprobar la compatibilidad del modelo, las llamadas a herramientas y los límites de la ruta elegida.

Según los registros y la documentación de BetterToken consultados el 2026-11-15:

BetterToken Model IDContexto anunciado del modeloRuta Anthropic Messages
deepseek-v4.1-flash-10171M tokensIncluida
kimi-k3.1-pro1M tokensIncluida
glm-5.31M tokensNo incluida para este modelo; el registro indica acceso compatible con OpenAI
qwen3.8-max1,000,000 tokensNo incluida para este modelo; el registro indica acceso compatible con OpenAI

Estos contextos publicados no son necesariamente inferiores al nuevo valor de 1M de Claude Code. Sin embargo, la ventana efectiva puede cambiar según el proveedor o la ruta de API.

Que un modelo aparezca en BetterToken no demuestra que funcione con todos los protocolos. Consulta el catálogo de modelos actualizado antes de escoger una ruta para Claude Code.

El siguiente ejemplo Bash utiliza el ID de DeepSeek que tiene una ruta Anthropic documentada. Sigue la guía de integración de BetterToken con Claude Code.

Instala primero Claude Code y crea tu propia API Key de BetterToken. Después ejecuta estos comandos en un shell Bash dedicado:

read -rs BETTERTOKEN_API_KEY && export BETTERTOKEN_API_KEY

export ANTHROPIC_BASE_URL="https://bettertoken.ai"
export ANTHROPIC_AUTH_TOKEN="$BETTERTOKEN_API_KEY"
export ANTHROPIC_MODEL="deepseek-v4.1-flash-1017"

export ANTHROPIC_DEFAULT_HAIKU_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_SONNET_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_OPUS_MODEL="$ANTHROPIC_MODEL"

unset CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT

claude -p "Reply with only: OK"
claude

Cuando el primer comando espere entrada, pega la clave creada en tu consola. La clave no aparece en pantalla ni queda escrita como valor dentro del comando.

ANTHROPIC_AUTH_TOKEN proporciona la autenticación. Las tres variables ANTHROPIC_DEFAULT_*_MODEL asignan los roles internos Haiku, Sonnet y Opus al modelo seleccionado de BetterToken. Más adelante puedes elegir otros modelos compatibles para esos roles.

Para utilizar Kimi, cambia ANTHROPIC_MODEL a kimi-k3.1-pro antes de exportar las tres variables de rol.

Si ya ejecutaste la configuración de DeepSeek, repite las cuatro exportaciones en el mismo shell Bash. Después inicia un proceso nuevo de Claude Code:

export ANTHROPIC_MODEL="kimi-k3.1-pro"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_SONNET_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_OPUS_MODEL="$ANTHROPIC_MODEL"

Cambiar únicamente ANTHROPIC_MODEL no modifica las tres variables que exportaste previamente. Sus valores seguirían apuntando a DeepSeek. La documentación de BetterToken sobre Kimi K3.1 Pro confirma el ID y la ruta de integración con Claude Code.

Para un ID desconocido sin [1m], puedes declarar explícitamente la ventana verificada. Si la ruta admite realmente 1,000,000 tokens:

export CLAUDE_CODE_MAX_CONTEXT_TOKENS=1000000

Establece el valor antes de iniciar Claude Code. Si tu gateway tiene una restricción inferior, sustituye 1000000 por el límite confirmado. También puedes fijar un umbral de compactación anterior.

No apliques automáticamente el siguiente ejemplo a DeepSeek o Kimi:

# Example only: the gateway's verified limit is 200000 tokens.
export CLAUDE_CODE_MAX_CONTEXT_TOKENS=200000
export CLAUDE_CODE_AUTO_COMPACT_WINDOW=150000

La primera variable declara la ventana efectiva. La segunda deja margen antes de compactar. Para otro límite, verifica ambos valores por separado.

¿Cómo comprobar el modelo y la ruta del gateway?

Después de iniciar Claude Code, ejecuta:

/status

Comprueba que Anthropic base URL muestre https://bettertoken.ai y que la autenticación utilice ANTHROPIC_AUTH_TOKEN.

Revisa también el modelo activo. Si es necesario, utiliza /model para elegir el ID correcto. Si cambiaste las variables de rol, reinicia Claude Code para que el nuevo proceso las reciba.

La petición claude -p "Reply with only: OK" anterior comprueba la conexión básica y el acceso al modelo. Una respuesta normal confirma que una petición breve funcionó. No verifica el comportamiento con contextos largos.

Para una comprobación relacionada con programación, pide a Claude Code que lea un archivo pequeño del repositorio y explique una función concreta sin modificar nada. Verifica que la respuesta mencione el archivo correcto.

Si falla la conexión o la autenticación, resuelve primero ese problema. La guía de diagnóstico de errores 403 en Claude Code explica esos fallos por separado.

Para configurar DeepSeek con más detalle y verificar los modelos, consulta la guía de integración de Claude Code con DeepSeek. Para el comportamiento específico de Kimi, utiliza la guía de programación con Kimi K3.1 Pro.

¿Qué hacer si todas las peticiones ya fallan?

Primero confirma que el rechazo se deba a la longitud del contexto. El registro de cambios de 2.1.323 describe errores repetidos, pero no publica un mensaje universal para este problema.

Los gateways pueden devolver errores diferentes. En la referencia de Anthropic para diagnosticar gateways aparecen ejemplos como:

ContextWindowExceededError

y:

prompt token count of N exceeds the limit of M

Son ejemplos de mensajes procedentes del gateway, no errores garantizados de la versión 2.1.323.

Intenta recuperar el trabajo sin borrar la conversación de entrada:

  1. Si todavía puedes consultar la sesión, guarda el estado del trabajo fuera de ella. Anota archivos modificados, resultados de pruebas y el siguiente paso.
  2. Actualiza Claude Code a 2.1.325 o posterior y verifica la versión instalada.
  3. Confirma la ventana real. Establece CLAUDE_CODE_MAX_CONTEXT_TOKENS o un umbral de compactación adecuado antes de volver a iniciar el cliente.
  4. Si la sesión aún admite comandos, prueba /compact manualmente.
  5. Si ya no puedes compactar ni continuar, utiliza /clear. Retoma el trabajo con el estado que guardaste.

Un gateway puede transformar el error por exceso de contexto en un mensaje que Claude Code no reconozca. En ese caso, la recuperación automática puede no activarse.

La versión 2.1.325 corrige muchos de esos fallos repetidos, pero el registro de cambios no identifica todas las rutas compatibles.

Para un procedimiento más detallado, incluidos los casos donde falla la compactación manual, consulta la guía para recuperar Claude Code y DeepSeek de errores de longitud de entrada.

No establezcas CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1 como solución general. Anthropic documenta que desactiva la compactación preventiva para IDs desconocidos y espera un error reconocible de la API. Si el gateway reescribe el error, recuperar la sesión puede ser menos fiable.

¿Por qué algunas guías todavía hablan de 200K para modelos desconocidos?

La documentación cambió durante estas versiones.

El texto de configuración consultado el 2026-11-13 todavía mencionaba 200K para los modelos desconocidos. Sin embargo, la página actual de configuración de modelos, revisada el 2026-11-15, ya mostraba context assumed to be 1m tokens en el aviso.

No utilices un mensaje antiguo de 200K como prueba del comportamiento actual. Comprueba tu versión instalada, el aviso que aparece realmente y la configuración efectiva.

Si Claude Code reconoce el modelo o acepta la ventana indicada, el aviso puede desaparecer. Eso confirma la configuración del cliente, pero no demuestra que el gateway admita peticiones de ese tamaño.

Configuración recomendada según el caso

Para un ID desconocido cuyo gateway acepta menos de 1M, utiliza Claude Code 2.1.325 o posterior y declara la ventana efectiva confirmada. Añade compactación temprana si necesitas margen para la salida del modelo.

Para un gateway con límite confirmado de 200K, CLAUDE_CODE_DISABLE_1M_CONTEXT=1 permite volver rápidamente al comportamiento anterior. Un límite preciso y un umbral más temprano ofrecen mayor control.

Si el modelo y la ruta admiten realmente 1M, conserva esa capacidad salvo que prefieras sesiones más cortas o el gateway aplique un límite inferior.

Para IDs desconocidos con [1m] y modelos Claude reconocidos, sigue las reglas específicas de Anthropic. No supongas que una única variable modifica todas las ventanas.

Configura Claude Code según el límite que acepta tu ruta de API real, no según su estimación predeterminada.

¿Quieres optimizar tu flujo de trabajo con LLM?

Conecta modelos mediante una API, gestiona claves y controla el gasto en IA.

Empezar gratis