Saltar al contenido principal
La herramienta advisor es experimental y requiere la API de Anthropic. No está disponible en Amazon Bedrock, Claude Platform en AWS, Google Cloud’s Agent Platform o Microsoft Foundry. El comportamiento, los precios y la disponibilidad pueden cambiar.
La herramienta advisor permite que Claude consulte un segundo modelo, típicamente más fuerte, en momentos clave durante una tarea, como antes de comprometerse con un enfoque, cuando se atasca en un error recurrente, o antes de declarar una tarea completada. El advisor recibe la conversación completa, incluidas todas las llamadas a herramientas y resultados, y devuelve orientación que Claude aplica antes de continuar. El advisor se ejecuta del lado del servidor en la infraestructura de Anthropic como una herramienta de servidor, disponible tanto para cuentas de suscripción como para cuentas facturadas por API. Usted elige qué modelo actúa como advisor, y Claude decide cuándo llamarlo. Esta página cubre cómo habilitar el advisor, qué emparejamientos de modelos se aceptan, qué muestra Claude durante una consulta, y cómo se factura el uso del advisor.

​
Cuándo usar el advisor

El advisor se ajusta a tareas largas y multietapa donde la mayoría de los turnos son rutinarios pero la calidad del plan determina el resultado. Los ejemplos incluyen refactorizaciones grandes, sesiones de depuración donde un error sigue repitiéndose, y tareas que desea que se verifiquen de forma independiente antes de que Claude las declare completadas. Añade menos valor en tareas cortas donde hay poco que planificar, o en trabajo donde cada turno necesita el modelo más fuerte. Para esos casos, cambie el modelo principal en su lugar, o vea cómo se compara el advisor con opusplan y subagents para otras formas de obtener una segunda opinión.

​
Habilitar el advisor

Puedes configurar el modelo advisor de tres formas:
  • Comando /advisor: establece o cambia el advisor a mitad de sesión y guárdalo como tu predeterminado
  • Ajuste advisorModel: configura un predeterminado persistente en tu archivo de configuración
  • Bandera --advisor: establece el advisor para una única sesión al iniciar
Cada una de estas opciones habilita el advisor para sesiones cuyo modelo principal lo admite. Después de que la sesión comience, Claude Code muestra una notificación Advisor Tool (experimental) is on and may use more tokens · /advisor. Para dejar de usar el advisor, consulta Desactivar el advisor. En algunos planes, Fable como advisor también necesita tu consentimiento único para facturar el uso de Fable a créditos de uso. Para saber qué sucede antes de que hayas dado ese consentimiento, consulta Advisor de Fable y créditos de uso.

​
Usar el comando /advisor

Ejecuta /advisor sin argumentos para abrir un selector que enumere los modelos advisor disponibles, o pasa el modelo directamente:
El comando confirma con Advisor set to seguido del nombre del modelo advisor. Tu selección se guarda en advisorModel en tu configuración de usuario y persiste entre sesiones, excepto en los casos que la entrada advisorModel enumera como aplicables solo a la sesión actual. El comando también funciona donde no hay un selector de terminal: en modo no interactivo con -p, en el Agent SDK, en la aplicación de escritorio y a través de Remote Control. Esto requiere Claude Code v2.1.260 o posterior. En esas superficies:
  • Ejecuta /advisor sin argumento para imprimir el modelo advisor actual y los alias que acepta.
  • Ejecuta /advisor con un modelo, como /advisor opus, para establecerlo.
  • Ejecuta /advisor off para desactivarlo.
Claude Code no invoca un advisor guardado que la lista de permitidos availableModels de tu organización excluya. Para usar el advisor, selecciona un modelo permitido con /advisor. Claude Code aún guarda un advisor que tu modelo principal actual no admite. Ese advisor se activa después de que cambies a un modelo principal compatible con /model. Si la API ya rechazó el advisor guardado en la conversación actual, permanece desactivado hasta /clear o /compact, incluso después de cambiar de modelo. En algunos planes, Fable como advisor también necesita tu consentimiento único para facturar el uso de Fable a créditos de uso. Para saber qué hace /advisor fable antes de que hayas dado ese consentimiento, consulta Advisor de Fable y créditos de uso.

​
Establecer advisorModel en la configuración

Para configurar el advisor como predeterminado sin abrir una sesión, establécelo en tu archivo de configuración:

​
Usar la bandera --advisor

Para establecer el advisor para una única sesión sin cambiar tu ajuste guardado, inicia con la bandera:
Claude Code usa la bandera en lugar del ajuste advisorModel para esa sesión. No enumera --advisor en claude --help. Claude Code sale con un error al iniciar si:
  • El modelo principal de la sesión no admite el advisor
  • El modelo solicitado, como Haiku 4.5, no puede actuar como advisor
  • La lista de permitidos availableModels de tu organización excluye el modelo solicitado
  • Solicitaste Fable y tu cuenta aún requiere el consentimiento de créditos de uso
Si inicias una sesión en segundo plano con --advisor y se aplica uno de estos casos, Claude Code inicia la sesión sin el advisor en lugar de salir. Si el modelo que pasas puede actuar como advisor pero tiene un rango inferior al de tu modelo principal, la sesión se inicia sea o no una sesión en segundo plano. En ese caso, tu modelo principal se ejecuta sin el advisor.

​
Elegir un modelo advisor

Claude Code clasifica los modelos según su capacidad para el rol de advisor, y un advisor debe estar clasificado en el mismo nivel o por encima del modelo principal de tu sesión. Las filas van del modelo principal con la clasificación más baja al de la más alta: Fable 5.1 requiere Claude Code v2.1.257 o posterior. Los modelos Fable requieren acceso a Fable. Sonnet 5.5 como advisor de un modelo principal Opus 4.7 u Opus 4.8 requiere Claude Code v2.1.287 o posterior. Haiku 5.5 como modelo principal o como advisor requiere Claude Code v2.1.293 o posterior. Establece el advisor como fable, opus o sonnet. Estos alias se resuelven a la versión predeterminada integrada de Claude Code para cada familia de modelos, que avanza con nuevas versiones de Claude Code. También puedes pasar un ID de modelo completo como claude-opus-5-5 o claude-haiku-5-5. Haiku 4.5 puede llamar al advisor pero no puede actuar como uno. Los subagentes heredan el advisor configurado y aplican la misma verificación de emparejamiento contra su propio modelo. Claude Code valida el emparejamiento antes de enviar una solicitud, y la API lo valida de nuevo:
  • Para un advisor clasificado por debajo del modelo principal, Claude Code no lo adjunta a las solicitudes del modelo principal. La salida del comando /advisor y una notificación muestran esto; consulta Advisor is less capable than the current main model. Los subagentes cuyo propio modelo satisface el emparejamiento aún pueden usar el advisor.
  • Si la API rechaza el emparejamiento de un advisor que Claude Code adjuntó, Claude Code reenvía esa solicitud sin el advisor. La conversación continúa sin uno, por lo que no ves ningún error y no obtienes llamadas de advisor. Si luego eliges un advisor diferente con /advisor, el cambio entra en vigor después de /clear o /compact y en nuevas sesiones.
  • Si el modelo principal o el advisor es un modelo que Claude Code no reconoce, el advisor no se adjunta.

​
Advisor Fable y créditos de uso

En algunos planes, el uso de Fable se factura a créditos de uso, y Fable como advisor se factura de la misma manera. Si su cuenta requiere el consentimiento único para facturar el uso de Fable a créditos de uso, Claude Code lo solicita cuando selecciona un modelo Fable con /model y no aplica Fable como advisor hasta que haya aceptado ese consentimiento. Antes de haberlo aceptado, Claude Code no guarda Fable como advisor cuando escribe /advisor fable o elige Fable en el selector /advisor. En su lugar, le señala /model fable. Con claude --advisor fable, Claude Code sale al iniciar con un mensaje que señala /model fable. En una sesión en segundo plano, inicia la sesión sin el advisor en lugar de salir. Con Fable ya guardado como su advisorModel, Claude Code envía solicitudes sin el advisor. En una sesión interactiva cuyo modelo principal admite el advisor, también muestra una notificación que señala /model fable. Para aceptar el consentimiento, ejecute /model fable y elija continuar en Fable. Claude Code registra el consentimiento y guarda Fable como su modelo seleccionado. Luego seleccione Fable como advisor.

​
Emparejamientos de modelos comunes

Cualquier emparejamiento aceptado funciona. Estas combinaciones equilibran el costo contra la capacidad de diferentes formas:

​
Cuándo Claude consulta el advisor

Claude decide cuándo llamar al advisor. Tiende a consultar antes de comprometerse con un enfoque, cuando un error sigue repitiéndose, y antes de declarar una tarea completada, pero el tiempo es impulsado por el modelo en lugar de basarse en reglas. Puede solicitar una consulta en su indicación de la misma manera que solicitaría cualquier herramienta, por ejemplo consulta al advisor antes de continuar. No hay configuración para limitar o forzar llamadas al advisor; si desea que Claude consulte más o menos a menudo durante una tarea, dígalo en sus instrucciones.

​
Qué ve durante una sesión

Cuando Claude llama al advisor, la transcripción muestra una línea Advising con el nombre del modelo advisor mientras la llamada está en progreso. Cuando el resultado regresa, la línea informa si el advisor proporcionó orientación:
  • Reviewed: la línea confirma que el advisor ha revisado la conversación. Cuando el advisor devolvió orientación legible, presione Ctrl+O para leerla.
  • Declined: la línea lee Advisor declined to advise on this request. Si el advisor proporcionó una razón, presione Ctrl+O para leerla.
  • Unavailable: la llamada del advisor falló, y la línea lee Advisor unavailable (<error_code>), donde <error_code> es el código que devolvió la llamada.
Claude generalmente sigue la orientación del advisor, pero se adapta cuando su propia evidencia contradice una afirmación específica: si un paso recomendado falla cuando se intenta, o el contenido del archivo contradice el consejo, Claude expone el conflicto en lugar de seguir la orientación incondicionalmente. El advisor siempre recibe la conversación completa, y Claude controla el tiempo. Para más control o una configuración diferente, vea cómo se compara el advisor con subagents y opusplan.

​
Costo

Cuando Claude llama al advisor, el modelo advisor lee la conversación, por lo que cada llamada consume tokens a las tasas del modelo advisor además del uso de su modelo principal. La forma en que esos tokens del advisor se facturan depende de cómo pague:
  • Facturación por API: paga las tasas de entrada y salida del modelo advisor para los tokens del advisor
  • Planes de suscripción: el uso del advisor cuenta hacia los límites de uso de su plan, excepto que un advisor Fable se factura a créditos de uso en planes donde el uso de Fable lo hace
Si su cuenta requiere el consentimiento de créditos de uso, un advisor Fable no se factura nada antes de que lo otorgue, porque Claude Code no aplica la selección hasta entonces. Claude llama al advisor en puntos de decisión en lugar de en cada turno, por lo que emparejar un modelo principal más rápido con un advisor más fuerte típicamente cuesta menos que ejecutar el modelo más fuerte en todo. El uso del advisor cuenta hacia los totales de sesión mostrados por /usage. Para cómo se reportan los tokens del advisor en respuestas de API, vea Uso y facturación en la documentación de la API de Claude.

​
Impacto en el almacenamiento en caché de indicaciones

Habilitar o deshabilitar el advisor a mitad de sesión no invalida el caché de indicaciones de su modelo principal. A diferencia de cambiar modelos, alternar /advisor mantiene el prefijo en caché intacto, y la orientación devuelta por el advisor se almacena en caché como parte de la transcripción en turnos posteriores. La propia lectura del advisor de la conversación no se almacena en caché. Cada llamada al advisor procesa la transcripción completa de nuevo, sin reutilización entre llamadas.

​
Requisitos

La herramienta advisor requiere todo lo siguiente:
  • Solo API de Anthropic: el advisor es una herramienta ejecutada por servidor. No está disponible en Amazon Bedrock, Claude Platform en AWS, Google Cloud’s Agent Platform o Microsoft Foundry. A través de una puerta de enlace LLM configurada con ANTHROPIC_BASE_URL, la disponibilidad depende de si la puerta de enlace reenvía la solicitud intacta a la API de Anthropic. Si la puerta de enlace o su upstream no reconoce la herramienta advisor, consulte Reintento automático y reenvío de errores para ver cómo responde Claude Code.
  • Modelo principal admitido: Fable, Opus 4.6 o posterior, Sonnet 4.6 o posterior, Haiku 4.5 o Haiku 5.5. Consulta Elegir un modelo advisor para saber qué advisors acepta cada uno.
  • Obtención de indicadores de características: Claude Code activa el advisor a través de un indicador de características que obtiene de Anthropic. En una sesión donde se establece una variable que desactiva la obtención de indicadores, como DISABLE_TELEMETRY, el advisor permanece desactivado. Consulte Características que necesitan obtención de indicadores de características.

​
Desactivar el advisor

Para dejar de usar el advisor, ejecute /advisor off o elija No advisor en el selector /advisor:
Para deshabilitar la herramienta advisor completamente, establezca CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1. El comando /advisor se vuelve no disponible y cualquier advisorModel configurado se ignora. La bandera --advisor se acepta pero no tiene efecto. Vea Variables de entorno. El advisor es una de varias formas de combinar fortalezas de modelos. Elija según cuándo desee que un segundo modelo esté involucrado.

​
Ver también