Claude Code Advisor: configura Sonnet + Opus y verifica llamadas

Usa advisor en Claude Code para que Sonnet haga el trabajo rutinario de programación y Opus revise las decisiones difíciles. Empieza con claude --model sonnet --advisor opus y comprueba la entrada Advising y su resultado antes de confiar en la revisión. El modelo decide cuándo consultar, las consultas consumen tokens adicionales y pueden desaparecer si el gateway rechaza la herramienta.

A fecha de 2026-11-06, la función advisor sigue siendo experimental. Los ejemplos requieren la CLI instalada, autenticación operativa y una solicitud normal que funcione directamente a través de Anthropic. Esta vía admite cuentas con suscripción y con facturación por API. La compatibilidad de los gateways requiere comprobaciones aparte.

¿Cuándo conviene usar advisor en lugar de otro modelo?

Elige advisor para una refactorización, un error recurrente o una implementación que presente decisiones difíciles de vez en cuando. Sonnet continúa la tarea mientras otro modelo revisa la conversación, incluidas las llamadas a herramientas y sus resultados.

Esta es la división que describe Anthropic en su estrategia con asesor. No garantiza resultados del nivel de Opus en todas las tareas ni un ahorro fijo.

Qué necesitas	Qué elegir	Qué cambia
Consejos ocasionales durante la ejecución	Advisor	Claude decide cuándo consultar a otro modelo
Planificación con Opus y posterior implementación con Sonnet	`opusplan`	El modo de planificación usa Opus, sujeto al acceso al modelo; la ejecución usa Sonnet
Una investigación o revisión independiente	Un subagente con un `model` seleccionado	El modelo elegido ejecuta la tarea delegada
Razonamiento más potente en las siguientes solicitudes de la sesión principal	`/model`	Cambias el modelo principal

Para una tarea corta que requiera poca planificación, empieza sin advisor. Si casi todos los pasos necesitan Opus, cambia la sesión principal a Opus 5.5.

El comando de inicio no crea tres subagentes Haiku para búsquedas, grep y documentación. Usa la configuración documentada del modelo de los subagentes para preparar ese flujo por separado. La opción documentada de la CLI es --agents, con JSON. No la sustituyas por el comando --subagents haiku que circula en algunos ejemplos.

Activa advisor de una de estas tres formas

Usa la opción de inicio para la primera prueba, porque no modifica la preferencia de asesor guardada. Primero comprueba la versión del cliente en Bash:

claude --version

Usa 2.1.284 o posterior para este ejemplo con Sonnet 5.5 y Opus 5.5. Los requisitos de los modelos establecen ese mínimo; no es la versión que introdujo advisor. El comando documentado para actualizar la CLI es claude update.

Para una sesión: usa —advisor

Ejecuta esto en Bash desde el directorio del proyecto:

claude --model sonnet --advisor opus

A fecha de 2026-11-06, estos alias corresponden a Sonnet 5.5 y Opus 5.5 en las configuraciones actuales con conexión directa a Anthropic. Las correspondencias pueden cambiar o quedar reemplazadas por otras configuraciones. Para indicar las versiones de forma explícita:

claude --model claude-sonnet-5-5 --advisor claude-opus-5-5

La opción tiene prioridad sobre advisorModel durante esta sesión. Según la documentación de advisor, es normal que no aparezca en claude --help.

Durante una sesión: usa /advisor

Introduce esto dentro de Claude Code:

/advisor opus

Debería aparecer Advisor set to seguido del nombre del modelo. Ejecutar /advisor sin argumentos abre el selector de modelos.

En una sesión de terminal local, la selección normalmente se guarda como opción predeterminada. La referencia de configuración establece reglas distintas para conservarla en sesiones remotas.

Para futuras sesiones: configura advisorModel

Añade esta propiedad a tu configuración de usuario en ~/.claude/settings.json:

{
  "advisorModel": "opus"
}

Conserva las demás opciones del archivo. Esta propiedad selecciona el asesor; no establece Sonnet como modelo principal.

Después de activar la función, busca este aviso:

Advisor Tool (experimental) is on and may use more tokens · /advisor

El aviso confirma la activación. No demuestra que haya ocurrido una consulta.

¿Qué combinaciones de modelos funcionan?

Elige un asesor con un rango al menos igual al del modelo principal según Claude Code. Estas combinaciones seleccionadas proceden de la tabla actual de compatibilidad, comprobada el 2026-11-06.

Modelo principal	Asesor	Uso previsto
Sonnet 5.5	Opus 5.5	Implementación rutinaria con una revisión más potente
Haiku 5.5	Opus 5.5	Un modelo principal más ligero con consultas más profundas
Sonnet 5.5	Sonnet 5.5	Una segunda revisión con el mismo modelo
Opus 5.5	Opus 5.5	Una segunda revisión de Opus
Opus 4.7 o Opus 4.8	Sonnet 5.5	Una combinación documentada entre familias distintas

Haiku 5.5 como modelo principal o asesor requiere 2.1.293 o posterior. Usar Sonnet 5.5 como asesor de Opus 4.7 u Opus 4.8 requiere 2.1.287 o posterior. Haiku 4.5 puede pedir consejo, pero no actuar como asesor.

Son combinaciones admitidas, sin garantía de calidad relativa para tu repositorio. La lista de modelos permitidos availableModels de tu organización aún puede bloquear una selección. Un valor de --advisor prohibido o no apto puede detener el inicio interactivo con un error. Con un asesor de rango inferior o un ID de modelo desconocido, la sesión principal puede continuar sin advisor.

Los subagentes heredan la configuración de advisor y comprueban la combinación con sus propios modelos. Incluye sus posibles consultas cuando evalúes el consumo total.

¿Cómo compruebas que se llamó al asesor?

Usa el registro de herramientas como evidencia y después revisa el consumo. Un aviso al iniciar o una afirmación de Claude de que consultó a Opus no bastan.

Prueba este prompt de solo lectura en un repositorio que conozcas:

Inspect this repository's authentication flow without changing files.
Propose one small refactor and identify its main regression risk.
Consult the advisor before presenting the plan.
Include the tests that would check the proposed change.

Es una prueba sugerida, no una llamada garantizada. Claude elige el momento. La planificación, los errores recurrentes y las comprobaciones finales son ocasiones frecuentes, no tres desencadenantes fijos.

No hay una opción de advisor en Claude Code que fuerce las llamadas o limite su número. Las instrucciones de un prompt o de CLAUDE.md pueden pedir más consultas, pero no convierten la revisión en un paso obligatorio.

Busca Advising junto al nombre del modelo asesor. Interpreta el resultado:

Resultado	Qué demuestra	Siguiente acción
Reviewed	El asesor revisó la conversación	Pulsa `Ctrl+O` si devolvió recomendaciones legibles; examina el plan resultante
Declined	La llamada ocurrió, pero el asesor rechazó dar consejo	Lee el motivo, si está disponible, y reconsidera la solicitud
Unavailable	La llamada falló	Examina `Advisor unavailable (<error_code>)` y diagnostica ese fallo
Sin entrada `Advising`	No se observó ninguna consulta	Pide una explícitamente; si no aparece, comprueba la activación y la ruta de conexión

Ejecuta /usage después de la prueba. El consumo del asesor contribuye a los totales de la sesión, pero un aumento por sí solo no demuestra una revisión satisfactoria. Contrástalo con el resultado del registro.

¿Cuánto cuesta una consulta al asesor?

Incluye en el presupuesto la lectura de la conversación por otro modelo. Los tokens del asesor se suman a los del modelo principal.

Si pagas por API, los tokens de entrada y salida del asesor se cobran a las tarifas de ese modelo. Con una suscripción, este flujo Sonnet/Opus consume el uso permitido por el plan; no incluye revisiones ilimitadas por separado.

A fecha de 2026-11-06, las tarifas estándar de Anthropic para Opus 5.5 son $4 por millón de tokens de entrada y $20 por millón de tokens de salida.

Este cálculo hipotético incluye solo al asesor. Supone facturación directa de Anthropic API, tarifas globales estándar, 50,000 tokens de entrada sin caché y 2,000 tokens de salida facturados. La salida facturada incluye los tokens de razonamiento.

Advisor token cost
= (50,000 × $4 + 2,000 × $20) / 1,000,000
= $0.24

No es una tarifa fija por consulta. El cálculo excluye el trabajo del modelo principal y no cuantifica el consumo de la cuota de suscripción. Un historial más extenso o una respuesta más larga del asesor aumentan la estimación.

La documentación de Claude Code indica que cada consulta relee todo el historial sin reutilizar una caché del asesor. Activar o desactivar /advisor conserva la caché del prompt del modelo principal. Las recomendaciones recibidas pueden incorporarse a esa caché en turnos posteriores.

Esta descripción se limita a Claude Code. La API Messages directa ahora documenta una opción caching independiente para el asesor. No es un paso de configuración de este flujo con la CLI.

Compara el costo total de la misma tarea completada antes de adoptar la combinación. Usa las mismas comprobaciones de aceptación y cuenta los reintentos y los intentos fallidos. En sesiones con mucho contexto, mide la sobrecarga de contexto de MCP antes de atribuir cada aumento a advisor.

La cifra en dólares de /usage es una estimación. Comprueba los cargos en el registro de facturación del proveedor.

Soluciona errores 400 y desactivaciones silenciosas en gateways

Aplica la solución que corresponda al fallo. La función inactiva, una combinación rechazada y una herramienta de servidor no compatible se resuelven de formas distintas.

No aparece el aviso inicial ni hay actividad del asesor

Revisa las variables de entorno y la sección env de la configuración antes de cambiar de modelos. CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 desactiva la función por completo.

Comprueba también DISABLE_TELEMETRY y CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC. Pueden desactivar el mecanismo de flags de funciones que necesita advisor. Revisa sus efectos documentados, incluidas las condiciones de la primera sesión y de las credenciales usadas con gateways.

Si la organización ha fijado esos valores de forma intencional, usa una configuración aprobada u otro flujo de revisión. Si una opción local no obligatoria causó el problema, elimínala de donde se define y vuelve a iniciar el cliente. Repite la prueba y comprueba el registro; cambiar una variable de entorno no demuestra por sí solo que funcione.

La sesión funciona, pero se rechazó la combinación de modelos

Comprueba los ID resueltos de ambos modelos y availableModels. La selección guardada del asesor puede seguir inactiva si el modelo principal es incompatible.

Si la API rechaza la combinación enviada, Claude Code reintenta sin advisor y la conversación puede continuar sin error. Selecciona un asesor admitido y usa /clear, /compact o una sesión nueva antes de volver a comprobarlo.

Conserva el contexto de la tarea que necesites antes de vaciar la conversación. Este procedimiento corresponde al rechazo de la combinación, no a cualquier rechazo del gateway.

Aparece Input tag ‘advisor_20260301’

Un 400 o 422 que mencione Input tag 'advisor_20260301' indica que el gateway o la API que hay detrás rechazó el tipo de herramienta advisor.

A partir de 2.1.280, Claude Code reconoce este rechazo y reintenta una vez sin la entrada advisor ni su valor beta. La sesión puede volver a funcionar y seguir escribiendo código sin advisor.

La guía de compatibilidad de gateways precisa cuánto dura este estado: las solicitudes a esa URL base omiten advisor hasta que Claude Code termina. El comando /advisor no está disponible durante ese estado. Corrige la ruta, sal completamente de Claude Code y vuelve a iniciarlo. Usar solo /clear no restablece este estado según la documentación.

Si el cliente es antiguo, actualízalo primero. Si el error persiste con un cliente actual, pide al operador del gateway que compruebe la definición de la herramienta:

La entrada de tools con tipo advisor_20260301 llega a una API de Anthropic compatible con ese tipo.
El valor asociado de anthropic-beta, advisor-tool-2026-03-01, se transmite junto con la entrada.
Los cuerpos de error de la API de destino conservan el texto que Claude Code usa para reconocer el rechazo.

Si quitar la herramienta y su encabezado permite las solicitudes normales, eso demuestra la recuperación sin advisor. No confirma la compatibilidad con advisor.

BetterToken incluye claude-sonnet-5-5 y claude-opus-5-5 en su catálogo a fecha de 2026-11-06. Su configuración de Claude Code usa https://bettertoken.ai como ANTHROPIC_BASE_URL, sin /v1. La disponibilidad del modelo no confirma la compatibilidad con advisor: obtén confirmación para la ruta concreta y comprueba una consulta real.

Si las solicitudes normales de Messages también fallan, primero comprueba la conexión con la guía de solicitud mínima a Claude API. Después repite la prueba específica de advisor.

Desactiva advisor

Usa el comando de la sesión cuando quieras detener las consultas:

/advisor off

Para desactivarlo por completo, define esto en Bash antes de iniciar el cliente:

export CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1
claude

Con esa variable definida, /advisor no está disponible y Claude Code ignora advisorModel. Claude Code acepta --advisor, pero no tiene efecto.