La herramienta advisor es experimental y requiere Claude Code v2.1.98 o posterior con la API de Anthropic. No está disponible en Amazon Bedrock, Google Vertex AI o Microsoft Foundry. El comportamiento, los precios y la disponibilidad pueden cambiar.
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
Puede configurar el modelo advisor de tres formas:
- Comando
/advisor: establezca o cambie el advisor a mitad de sesión y guárdelo como su predeterminado
- Configuración
advisorModel: configure un predeterminado persistente en su archivo de configuración
- Bandera
--advisor: establezca el advisor para una única sesión al iniciar
Si alguno de estos establece un modelo advisor, el advisor se habilita para sesiones cuyo modelo principal lo admite. Para dejar de usarlo, vea Desactivar el advisor.
Para usar Fable 5 como advisor, necesita Claude Code v2.1.170 o posterior y acceso a Fable 5 para su organización. Usar el comando /advisor
Ejecute /advisor sin argumentos para abrir un selector que enumere los modelos advisor disponibles, o pase el modelo directamente:
Su selección se guarda en advisorModel en su configuración de usuario y persiste entre sesiones. Si su modelo principal actual no admite el advisor, la selección aún se guarda y se activa cuando cambia a un modelo principal compatible con /model.
Establecer advisorModel en la configuración
Para configurar el advisor como predeterminado sin abrir una sesión, establézcalo en su archivo de configuración:
{
"advisorModel": "opus"
}
Usar la bandera --advisor
Para establecer el advisor para una única sesión sin cambiar su configuración guardada, inicie con la bandera:
La bandera tiene prioridad sobre la configuración advisorModel para esa sesión. A diferencia de /advisor, que guarda una selección inactiva, la bandera sale con un error si el modelo principal de la sesión no admite el advisor.
Elegir un modelo advisor
El advisor debe ser al menos tan capaz como el modelo principal. Los advisors aceptados para cada modelo principal son:
| Modelo principal | Advisors aceptados | Notas |
|---|
| Haiku 4.5 | Fable, Opus, Sonnet | Haiku puede llamar al advisor pero no puede actuar como uno |
| Sonnet 4.6 | Fable, Opus, Sonnet | |
| Opus 4.6 o posterior | Fable, Opus en o por encima de la versión del modelo principal | Un Opus 4.7 principal con un advisor Opus 4.6 se rechaza |
| Fable 5 (v2.1.170+) | Fable | Un advisor Opus o Sonnet se rechaza |
opus, sonnet, o fable. Estos alias se resuelven a la versión más reciente de cada modelo. También puede pasar un ID de modelo completo como claude-opus-4-8.
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:
- Si el advisor es menos capaz que el modelo principal, el advisor no se adjunta a las solicitudes del modelo principal. La salida del comando
/advisor y una notificación muestran esto. Los subagentes cuyo propio modelo satisface el emparejamiento aún pueden usar el advisor.
- Si el modelo principal o el advisor es un modelo que Claude Code no reconoce, el advisor no se adjunta.
Emparejamientos de modelos comunes
Cualquier emparejamiento aceptado funciona. Estas combinaciones equilibran el costo contra la capacidad de diferentes formas:
| Emparejamiento | Cuándo usar |
|---|
| Sonnet principal + advisor Opus | Sonnet maneja el trabajo rutinario y escala la planificación, fallos ambiguos y verificaciones de finalización a Opus |
| Sonnet principal + advisor Fable | Orientación de Fable 5 en puntos de decisión sin ejecutar Fable 5 en todo. Requiere v2.1.170 o posterior y acceso a Fable 5 |
| Haiku principal + advisor Opus | Modelo principal de menor costo con planificación fuerte. Espere un costo más alto que Haiku solo pero menor que cambiar el modelo principal a Sonnet u Opus |
| Opus principal + advisor Opus | Un segundo Opus revisa el primero. Útil para tareas de alto riesgo donde una verificación independiente importa más que el costo |
| Fable principal + advisor Fable | Emparejamiento de mayor capacidad cuando Fable 5 está disponible (v2.1.170+). Fable es un nivel superior a Opus y Sonnet, por lo que es el único advisor aceptado para un modelo principal Fable |
| Sonnet principal + advisor Sonnet | Una segunda opinión de menor costo para detectar descuidos rutinarios |
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 confirma que el advisor ha revisado la conversación. Presione Ctrl+O para expandirla y leer la orientación completa del advisor.
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
Cada llamada al advisor envía la conversación al modelo advisor, por lo que consume tokens a las tasas del modelo advisor además del uso de su modelo principal. Con facturación por API, los tokens del advisor se cobran a las tasas de entrada y salida del modelo advisor. En planes de suscripción, el uso del advisor cuenta hacia los límites de uso de su plan.
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 modelo o nivel de esfuerzo, 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:
- Claude Code v2.1.98 o posterior: ejecute
claude update para actualizar.
- Solo API de Anthropic: el advisor es una herramienta ejecutada por servidor. No está disponible en Amazon Bedrock, Google Vertex AI 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.
- Modelo principal admitido: Opus 4.6 o posterior, Sonnet 4.6, o Haiku 4.5. Fable 5 también califica en Claude Code v2.1.170 o posterior.
Desactivar el advisor
Para dejar de usar el advisor y borrar su advisorModel guardado, ejecute /advisor off o elija No advisor en el selector /advisor:
Para deshabilitar la herramienta advisor completamente, incluido el comando /advisor y la bandera --advisor, establezca CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1. 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.
| Enfoque | Cuándo se ejecuta el modelo más fuerte | Cómo comienza |
|---|
| Herramienta advisor | En puntos de decisión a mitad de tarea | Claude la llama cuando necesita orientación |
opusplan | Durante el modo plan, luego cambia a Sonnet para ejecución | Usted entra en modo plan |
Subagents con model establecido | Para toda la subtarea delegada | Claude delega, o usted invoca el subagent |
/model | Para todos los turnos posteriores | Usted cambia modelos |
Ver también
