¿Qué es opusplan en Claude Code? Opus para planificar y Sonnet para implementar: cómo configurarlo y qué vigilar

Quieres que un modelo inteligente se encargue solo de planificar y que el código en sí lo escriba un modelo más rápido y barato. Claude Code tiene un ajuste que lo hace de forma automática: opusplan.

La respuesta corta: opusplan es una forma de indicar el modelo que usa Opus mientras estás en el modo de planificación y Sonnet el resto del tiempo. Para usarlo, escribe /model opusplan o ponlo en model de settings.json. Eso sí, no aparece en la lista de /model, así que no lo encontrarás si no conoces el nombre. Además, como el modelo cambia cada vez que entras en el modo de planificación o sales de él, ten en cuenta que cada cambio vuelve a leer toda la conversación sin caché.

En este artículo, a partir de la documentación oficial a 15 de septiembre de 2026, el registro de cambios de Claude Code (CHANGELOG) y los issues de GitHub, repaso cómo configurarlo, cómo se usa paso a paso, por qué no aparece en la lista, qué vigilar con el precio y la caché, y en qué se diferencia de mecanismos parecidos (la herramienta advisor y los subagentes).

1. Qué es opusplan: Opus solo durante el modo de planificación

opusplan es un alias (nombre alternativo) de modelo que se puede indicar en /model, igual que sonnet u opus. La documentación oficial lo describe como un modo especial que usa opus en el modo de planificación y cambia a sonnet para la ejecución.

Lo único que decide el cambio es si estás o no en el modo de planificación. El modo de planificación es el estado en el que Claude lee archivos y ejecuta comandos para investigar, escribe un plan y no edita tu código fuente hasta que lo apruebas (el panorama de todos los modos de permisos se trata en Modos de permisos de Claude Code: los 5 modos y cuándo usar cada uno).

Fuente: documentación oficial de Claude Code, «Model configuration» (a 15 de septiembre de 2026). A dónde apuntan depende del proveedor: por ejemplo, en Amazon Bedrock y en Agent Platform de Google Cloud, sonnet es Sonnet 4.5

Hay otro mecanismo parecido. Una sesión que funciona con Haiku sube automáticamente a Sonnet, pero solo mientras está en el modo de planificación (se introdujo en la v2.0.17 junto con Haiku 4.5; en ese momento, en Amazon Bedrock y Google Vertex AI no subía automáticamente). Este funciona sin configurar nada.

2. Cómo configurarlo

Se indica igual que cualquier otro modelo. Estas son las formas, de mayor a menor prioridad según la documentación oficial.

Escribir /model opusplan no solo cambia la sesión actual: también lo guarda en model de tu configuración de usuario, así que pasa a ser el valor por defecto de las sesiones nuevas. Si solo quieres probarlo en una sesión, arranca con claude --model opusplan.

{
  "model": "opusplan"
}

Hay otros tres ajustes que conviene conocer.

• Fijar la versión de los modelos: el Opus que opusplan usa en el modo de planificación se decide con ANTHROPIC_DEFAULT_OPUS_MODEL, y el Sonnet que usa el resto del tiempo, con ANTHROPIC_DEFAULT_SONNET_MODEL. En Amazon Bedrock y proveedores similares, escribe aquí los ID de modelo de tu proveedor
• Usar un contexto de 1M de tokens: en los planes en los que Opus pasa automáticamente a 1M, como Max, Team y Enterprise, el lado de Opus de opusplan también tiene 1M. En los demás casos, para tener 1M en ambos, indica opusplan[1m]. Indicarlo con /model opusplan[1m] requiere la v2.1.265 o posterior; en versiones anteriores, usa --model o el archivo de configuración
• No sirve en la variable de entorno del modelo por defecto: si pones opusplan en ANTHROPIC_DEFAULT_MODEL, que decide el valor por defecto de las sesiones nuevas, se ignora. Para que sea tu modelo por defecto, escribe /model opusplan o ponlo en model de settings.json

Fuente: documentación oficial de Claude Code, «Model configuration» (Setting your model, Environment variables, Extended context, opusplan model setting), «Settings reference» (model)

3. Cómo se usa, paso a paso

Con solo indicar opusplan, sigues con Sonnet. Solo pasa a Opus cuando entras tú en el modo de planificación.

1. Entra en el modo de planificación: en la terminal, cambia con Shift+Tab o empieza tu petición con /plan. Para empezar ya en él, usa claude --permission-mode plan. En la app de escritorio, elígelo en el selector de modos de permisos (el selector de modo)
2. Opus escribe el plan: lee archivos y ejecuta comandos para investigar, y reúne un plan sin editar nada. Con Ctrl+G también puedes abrir el plan en tu editor y modificarlo directamente
3. Aprueba el plan: elige entre seguir en modo automático («Yes, and use auto mode»), aprobar las ediciones una a una («Yes, manually approve edits») o seguir planificando («No, keep planning»); cuando el modo automático no está disponible, la primera opción pasa a ser aprobar las ediciones automáticamente («Yes, auto-accept edits»). Al aprobarlo sales del modo de planificación y, a partir de ahí, Sonnet se encarga de la implementación
4. Si quieres volver a planificar: vuelve al modo de planificación con Shift+Tab o empieza tu siguiente petición con /plan. Mientras estés ahí, vuelve a ser Opus

Si pones el ajuste showClearContextOnPlanAccept en true, arriba del todo de las opciones de aprobación se añade una para aprobar borrando el contexto («Yes, clear context and …», donde el resto indica el modo de permisos). Descarta cosas como el contenido de los archivos leídos al planificar y empieza la implementación solo con el plan (por defecto es false). Como explica la sección 5, con opusplan esto también influye en el coste.

Fuente: documentación oficial de Claude Code, «Choose a permission mode» (Analyze before you edit with plan mode, Review and approve a plan), «Settings reference» (showClearContextOnPlanAccept), «Desktop» (elegir el modo de permisos)

No le preguntes al modelo con qué modelo se está ejecutando. En una discusión de GitHub de septiembre de 2025, un empleado de Anthropic escribió que, en lugar de preguntarle al modelo qué es, hay que comprobarlo en lo que muestra la aplicación. Las formas de comprobarlo están en la Q3 de las preguntas frecuentes.

4. Por qué no aparece en la lista de /model

opusplan no es una función nueva. No aparece en la lista porque en su momento se retiró de la interfaz. Siguiendo el registro de cambios y los issues de GitHub, la historia es esta.

Fuente: CHANGELOG de Claude Code, issue de GitHub #8358, #26556, #27237 (todos consultados el 15 de septiembre de 2026)

🟡 Anthropic no ha vuelto a explicar por qué hoy no aparece en la lista. La explicación de septiembre de 2025 comparaba Sonnet 4.5 y Opus 4.1 tal como eran entonces. No se sabe si el mismo criterio sigue valiendo para la pareja Opus 5 y Sonnet 5. Por otro lado, la documentación oficial todavía tiene una sección sobre opusplan y el registro de cambios incluye correcciones de 2026, así que sigue siendo utilizable como ajuste.

También hay informes, como el issue #27237, de que las versiones elegidas no eran las esperadas. Sin embargo, el ID de modelo de ese informe tiene el formato de Google Cloud, y la documentación oficial actual sigue indicando que en Google Cloud sonnet apunta a Sonnet 4.5, así que es posible que funcionara según lo previsto (es mi propia interpretación). Si te preocupa, fija las versiones con las dos variables de entorno de arriba y comprueba qué modelo se ejecutó realmente.

5. Precio y caché: cada cambio obliga a releerlo todo

La mayoría usa opusplan para contener el uso o el coste. Si la implementación pasa a Sonnet, baja el precio por token.

Fuente: Claude Platform Docs, «Pricing» (por millón de tokens, a 15 de septiembre de 2026)

Sin embargo, hay un coste fácil de pasar por alto. La caché de prompts es independiente para cada modelo, y la documentación oficial dice que con opusplan cada entrada o salida del modo de planificación es un cambio de modelo y, cada vez, la caché se crea de nuevo. Es decir, la primera respuesta de Sonnet justo después de salir del modo de planificación y la primera de Opus justo después de volver leen toda la conversación hasta ese momento sin caché.

Para hacerme una idea de cuánto supone, calculé el caso de un cambio hecho cuando la conversación ya ha crecido hasta 100,000 tokens. Con suscripción, dentro del plan, la caché de la conversación principal dura 1 hora, así que las escrituras se cuentan al precio de 1 hora. Ten en cuenta que, con una clave de API o a través de un proveedor en la nube, también puedes dar 1 hora de caché a la conversación principal poniendo promptCacheTtl en 1h (v2.1.242 y posteriores) y que, al revés, con suscripción la caché baja a 5 minutos mientras pagas con créditos de uso adicionales (usage credits) por encima de tu plan.

Fuente: estimación propia a partir de los precios oficiales (100,000 tokens × precio). 🟡 No se ha publicado que los límites de la suscripción se reduzcan en la misma proporción que estos importes. La duración de la caché, según la documentación oficial de Claude Code, «How Claude Code uses prompt caching»

Si siguieras leyendo esos mismos 100,000 tokens con Opus, cada lectura de caché costaría unos $0.05. Si entras y sales del modo de planificación muchas veces mientras los intercambios de implementación todavía son cortos, las escrituras de los cambios pueden salir más caras. Hay tres formas de contener el coste.

• Planifica al principio de la conversación: si cambias mientras el contexto aún es pequeño, también es poco lo que se vuelve a escribir
• Borra el contexto al aprobar: activa showClearContextOnPlanAccept y elige la opción que aprueba borrando el contexto; Sonnet empieza solo con el plan y relee menos
• No vayas y vengas a menudo entre planificar e implementar: cada vuelta al modo de planificación provoca una relectura también en el lado de Opus

Una nota también sobre los límites de la suscripción. El límite de sesión y el límite semanal son comunes a todos los modelos y, aparte, hay límites por familia de modelos, como el «límite de Opus» y el «límite de Sonnet». Como opusplan usa Opus mientras estás en el modo de planificación, si has alcanzado el límite de Opus no podrás usar Opus en el modo de planificación. La página de precios indica que Opus está disponible incluso en el plan Pro, pero, según la documentación oficial, usar Opus con 1M de contexto en Pro requiere créditos de uso adicionales (usage credits).

Fuente: documentación oficial de Claude Code, «How Claude Code uses prompt caching» (Switching models, Changing permission mode, Which TTL each request gets), «Error reference» (límites comunes a todos los modelos y límites por familia de modelos), «Model configuration» (Extended context), página de precios de Claude (modelos por plan)

6. En qué se diferencia de la herramienta advisor y de los subagentes

opusplan no es la única forma de combinar un modelo potente con uno rápido. La documentación oficial compara las opciones según cuándo se ejecuta el modelo más potente.

Fuente: documentación oficial de Claude Code, «Escalate hard decisions with the advisor tool» (Compare with related features)

La herramienta advisor mantiene la sesión principal en un modelo rápido mientras Claude consulta a un modelo más potente a mitad del trabajo. A diferencia de opusplan, activarla o desactivarla no rompe la caché de la sesión principal. Eso sí, en cada consulta el advisor lee toda la conversación, y esa lectura no se guarda en caché. A 15 de septiembre de 2026 es una función experimental y solo está disponible en la API de Anthropic (no en Amazon Bedrock ni en proveedores similares).

Los subagentes ejecutan con otro modelo solo el trabajo delegado. La configuración y las mediciones se tratan en Cómo ejecutar los subagentes de Claude Code con otro modelo.

Fuente: documentación oficial de Claude Code, «Escalate hard decisions with the advisor tool» (Cost, Impact on prompt caching, Requirements)

7. Cuándo conviene y cuándo no

A partir de cómo funciona todo lo anterior, ordeno los criterios para decidir (no es una recomendación oficial, sino mi propio resumen deducido del mecanismo).

Si dudas, lo más seguro es hacer el mismo tipo de trabajo una vez con opusplan y otra con tu modelo habitual, y comparar las cifras de /usage y el resultado. Cómo ver el uso al detalle por sesión lo explico en Uso de Claude Code por sesión: cómo medirlo.

Preguntas frecuentes

Q1. Abro /model y no encuentro opusplan.
No se muestra en la lista, y es así por diseño (a 15 de septiembre de 2026). Indícalo escribiendo el nombre: /model opusplan. Escrito así, también se guarda como valor por defecto de las sesiones nuevas. Si solo lo quieres para esta vez, arranca con claude --model opusplan.

Q2. Puse opusplan, pero sigue todo el rato en Sonnet.
Es lo normal. opusplan solo usa Opus mientras estás en el modo de planificación, y no entra en él por sí solo. Cambia con Shift+Tab o empieza tu petición con /plan.

Q3. ¿Hay forma de comprobar con qué modelo se está ejecutando ahora?
Compruébalo en lo que muestra la aplicación, no preguntándole al modelo. /status muestra el modelo actual y, además, la línea de estado le pasa a tu script el modelo actual, así que puedes configurarla para que muestre el nombre del modelo. Cuando ya ha terminado, message.model de cada respuesta en los registros de conversación (los JSONL de ~/.claude/projects) guarda el modelo que respondió realmente.

Q4. ¿Funciona en Amazon Bedrock o Google Cloud?
Sí. Pon los ID de modelo de tu proveedor en ANTHROPIC_DEFAULT_OPUS_MODEL y ANTHROPIC_DEFAULT_SONNET_MODEL para indicar las versiones que usa opusplan. Si la configuración administrada de tu organización (availableModels) excluye el Opus más reciente, en la API de Anthropic y en Claude Platform on AWS planifica con el Opus más reciente entre los permitidos y, si se excluyen todos los Opus, sigue en Sonnet incluso en el modo de planificación. En Bedrock, Google Cloud, Microsoft Foundry y proveedores similares, si está excluido, planifica con el modelo original de la sesión incluso en el modo de planificación (ambos comportamientos, desde la v2.1.205).

Q5. ¿Qué es opusplan[1m]?
Es la forma de usar un contexto de 1 millón de tokens tanto para el Opus del modo de planificación como para el Sonnet de la ejecución. En los planes en los que Opus pasa automáticamente a 1M, como Max, Team y Enterprise, el lado de Opus tiene 1M aunque no lo añadas. Por cierto, en la API de Anthropic, Sonnet 5 funciona siempre con 1M aunque no lo indiques. /model acepta esta forma desde la v2.1.265.

Fuentes

• Claude Code Docs — Model configuration (qué es opusplan, a dónde apuntan los alias, formas de indicar el modelo y su prioridad, variables de entorno, contexto de 1M, availableModels y la subida de modelo en el modo de planificación)
• Claude Code Docs — Choose a permission mode (cómo entrar en el modo de planificación, aprobación del plan)
• Claude Code Docs — Settings reference (model, showClearContextOnPlanAccept)
• Claude Code Docs — How Claude Code uses prompt caching (cambio de modelo y caché, cambios del modo de planificación con opusplan, duración de la caché)
• Claude Code Docs — Escalate hard decisions with the advisor tool (comparación con funciones relacionadas, coste, efecto en la caché)
• Claude Code Docs — Error reference (límites de uso)
• Claude Code Docs — Desktop (elegir el modelo y el modo de permisos)
• Claude Code CHANGELOG (v1.0.77, v1.0.88, v2.0.17, v2.1.172, v2.1.265)
• GitHub issue #8358, #26556, #27237 (cómo se retiró del selector, la explicación del empleado de Anthropic, la petición de mostrarlo en la lista, el informe sobre las versiones elegidas)
• Claude Platform Docs — Pricing, página de precios de Claude (precios por modelo, modelos por plan)

Artículos relacionados

• Cómo ejecutar los subagentes de Claude Code con otro modelo: repartir modelos según el trabajo
• Modos de permisos de Claude Code: los 5 modos y cuándo usar cada uno: los modos de permisos, incluido el de planificación
• Uso de Claude Code por sesión: cómo medirlo: cómo comparar el uso
• ¿Qué se está comiendo el contexto de Claude Code?: por qué crece lo que se relee
• Ahorra tokens en Claude Code: 10 consejos y costes extra: otros sitios donde recortar