Qué es la herramienta advisor
La documentación de Anthropic lo describe en una frase: "La herramienta advisor permite a Claude consultar a un segundo modelo, normalmente más potente, en momentos clave durante una tarea, como antes de comprometerse con un enfoque, cuando se queda atascado en un error recurrente o antes de declarar una tarea como completada".
Tres detalles definen su funcionamiento:
- Es un segundo modelo. Mantienes tu modelo principal para el trabajo rutinario y añades un advisor para las decisiones.
- Se ejecuta del lado de Anthropic. La documentación dice: "El advisor se ejecuta en el 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".
- Claude decide cuándo usarlo. "Tú eliges qué modelo actúa como advisor y Claude decide cuándo llamarlo".
La herramienta está etiquetada como experimental. Requiere la Anthropic API, Claude Platform en AWS o Claude Models en Google Cloud (gestionado por Anthropic), y no está disponible a través de Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry.
La documentación dice que el advisor encaja en "tareas largas de varios pasos donde la mayoría de los turnos son rutinarios pero la calidad de la planificación determina el resultado". Sus ejemplos son refactorizaciones grandes, sesiones de depuración donde un error se repite y tareas que quieres que se revisen antes de que Claude las dé por terminadas.
Qué ve el advisor de tu sesión
Esta es la parte que decide qué tan útil puede ser una consulta.
La documentación es explícita: "El advisor recibe la conversación completa, incluyendo cada llamada a herramientas y su resultado, y devuelve una guía que Claude aplica antes de continuar". Más adelante repite el punto: "El advisor siempre recibe la conversación completa, y Claude controla el tiempo".
Por lo tanto, la vista del advisor es la transcripción de la sesión. Ve lo que preguntaste, lo que Claude leyó, qué comandos se ejecutaron y qué ha concluido Claude hasta ahora. La documentación no describe ningún informe separado.
Esto tiene una consecuencia práctica. La documentación describe la entrada del advisor como la conversación. Una restricción que nunca surgió en la sesión, como una decisión que tu equipo tomó el mes pasado o una razón por la cual un módulo no debe cambiar, no forma parte de lo que la documentación dice que recibe el advisor. Si es importante para la decisión, debe estar en la conversación.
Claude también trata la guía con criterio. La documentación dice: "Claude generalmente sigue la guía del advisor, pero se adapta cuando su propia evidencia contradice una afirmación específica". Si un paso recomendado falla, o los archivos contradicen el consejo, Claude saca a la luz el conflicto en lugar de seguir el consejo a ciegas.
Cómo activar el advisor
La documentación enumera tres formas, y difieren en cuánto dura la elección.
El comando /advisor. Ejecútalo sin argumentos para elegir de una lista, o pasa un modelo, como /advisor opus. La documentación dice que tu selección "se guarda en advisorModel en tu configuración de usuario y persiste entre sesiones", con algunas excepciones que enumera en la referencia de configuración.
El ajuste advisorModel. Establécelo en tu archivo de configuración para definir un valor predeterminado sin abrir una sesión.
El flag --advisor. Inicia con claude --advisor opus para establecer el advisor para una sesión sin cambiar tu configuración guardada.
Después de que comienza la sesión, Claude Code muestra una notificación de que la herramienta advisor está activada y puede usar más tokens.
Qué emparejamientos funcionan
El advisor debe ser al menos tan capaz como tu modelo principal. La documentación dice que Claude Code clasifica los modelos para el rol de advisor, y "un advisor debe tener un rango igual o superior al modelo principal de tu sesión".
La tabla de emparejamientos aceptados de la documentación incluye estos ejemplos:
- Sonnet 5.5 como modelo principal acepta Fable, Opus 5 o posterior, o Sonnet 5.5 como advisor.
- Opus 5 u Opus 5.5 como modelo principal acepta Fable u Opus 5 o posterior.
- Fable 5.2 como modelo principal acepta solo Fable 5.2.
Configuras el advisor con un alias, fable, opus o sonnet, o un ID de modelo completo. La documentación señala que los alias "se resuelven a la versión predeterminada integrada de Claude Code para cada familia de modelos, que avanza con los nuevos lanzamientos de Claude Code".
También enumera emparejamientos comunes y cuándo encajan. Un modelo principal Sonnet con un advisor Opus maneja el trabajo rutinario en Sonnet y escala la planificación, los fallos ambiguos y las comprobaciones de finalización a Opus. Un modelo principal Opus con un advisor Opus ofrece una segunda revisión para tareas de alto riesgo.
Los subagentes siguen las mismas reglas. La documentación dice: "Los subagentes heredan el advisor configurado y aplican la misma comprobación de emparejamiento contra su propio modelo".
Cuándo llama Claude al advisor
No programas las consultas. La documentación dice que Claude "tiende a consultar antes de comprometerse con un enfoque, cuando un error se repite y antes de declarar una tarea como terminada, pero el tiempo se basa en el modelo y no en reglas fijas".
Aun así, puedes influir en ello. Puedes pedir una consulta en tu prompt; el ejemplo de la documentación es decirle a Claude que consulte al advisor antes de continuar. Sobre la frecuencia, añade: "No hay un ajuste para limitar o forzar las llamadas al advisor; si quieres que Claude consulte más o menos a menudo durante una tarea, dilo en tus instrucciones".
Durante una sesión, una consulta se muestra como una línea de "Advising" con el nombre del modelo advisor. Cuando regresa, la línea muestra uno de tres resultados:
- Reviewed: el advisor revisó la conversación. Presiona
Ctrl+Opara leer su guía. - Declined: el advisor declinó asesorar sobre la solicitud. Presiona
Ctrl+Opara ver cualquier motivo que haya dado. - Unavailable: la llamada falló y la línea muestra un código de error.
Por qué cada llamada vuelve a leer toda la transcripción
La visión del advisor sobre la sesión es nueva cada vez. La sección de la documentación sobre el almacenamiento en caché de prompts lo explica.
En tu modelo principal, el efecto es pequeño: "Activar o desactivar el advisor a mitad de la sesión no invalida el caché de prompts de tu modelo principal". Y la guía en sí se convierte en parte del registro: "la guía devuelta por el advisor se almacena en caché como parte de la transcripción en turnos posteriores".
En el lado del advisor, nada se transfiere: "La propia lectura de la conversación del modelo advisor no se almacena en caché. Cada llamada al advisor procesa la transcripción completa de nuevo, sin reutilización entre llamadas".
Se derivan dos consecuencias:
- Las sesiones largas hacen que cada consulta sea más grande. El advisor lee toda la conversación cada vez, por lo que una llamada tardía en una sesión larga procesa más que una temprana.
- Nada se reutiliza entre llamadas en el lado del advisor. Lo que vincula una llamada con la siguiente es la transcripción, que incluye la guía que devolvió anteriormente.
Esta es también la razón por la que activar el advisor es diferente de cambiar de modelo. La documentación contrasta ambos directamente: a diferencia de cambiar de modelo, alternar /advisor mantiene intacto el prefijo almacenado en caché. Cubrimos lo que un cambio de modelo le hace al caché y al contexto de una sesión en nuestra guía sobre cambiar de modelo a mitad de sesión en Claude Code.
Qué cuesta
El advisor lee la conversación, por lo que cada llamada utiliza tokens a las tarifas del modelo advisor, además del uso de tu modelo principal. En la facturación por API, pagas las tarifas de entrada y salida del modelo advisor. En los planes de suscripción, el uso del advisor cuenta para los límites de uso de tu plan, con una regla separada para un advisor Fable en planes donde Fable se factura a créditos de uso.
El argumento de la documentación para este diseño es que Claude llama al advisor "en puntos de decisión en lugar de en cada turno", por lo que un modelo principal más rápido con un advisor más potente suele costar menos que ejecutar el modelo más potente en todo momento. El uso del advisor aparece en los totales de la sesión mostrados por /usage.
Cuándo Claude Code descarta silenciosamente el advisor
Este es el comportamiento del ejemplo inicial, y la documentación describe varios casos.
La API rechaza el emparejamiento. "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 recibes llamadas al advisor". Si luego eliges un advisor diferente con /advisor, la documentación dice que surte efecto después de /clear o /compact y en nuevas sesiones.
El advisor tiene un rango inferior al modelo principal. Claude Code no lo adjunta a las solicitudes del modelo principal. La salida de /advisor y una notificación muestran esto.
El advisor guardado no es compatible con tu modelo principal actual. La documentación dice: "Claude Code sigue guardando 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". Añade una advertencia: "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".
No se reconoce un modelo. "Si el modelo principal o el advisor es un modelo que Claude Code no reconoce, el advisor no se adjunta".
Tu organización restringe los modelos. Claude Code no invoca un advisor guardado que la lista de permitidos availableModels de tu organización excluya.
Los flags de funciones están desactivados. Fuera de Claude Platform en AWS y Claude Models en Google Cloud (gestionado por Anthropic), el advisor necesita un flag de función obtenido de Anthropic. Una sesión con una variable que desactiva la obtención, como DISABLE_TELEMETRY, no lo tiene.
El patrón es el mismo en cada caso: la sesión sigue funcionando, solo que sin consultas. Si confías en el advisor, busca las líneas de "Advising" durante tareas largas y ejecuta /advisor para ver qué está configurado.
Cómo se compara el advisor con otras opciones
La documentación compara cuatro formas de incorporar un modelo más potente:
- Herramienta Advisor: en puntos de decisión a mitad de la tarea, cuando Claude lo llama.
opusplan: durante el modo de plan, luego Sonnet para la ejecución.- Subagentes con un conjunto de modelos: para una subtarea delegada completa.
/model: a partir de la siguiente solicitud, cuando cambias.
El advisor es el único donde el modelo más potente revisa toda la conversación en los momentos que Claude elige. Los otros o bien entregan parte del trabajo o cambian el modelo para todo lo que sigue.
Cómo desactivarlo
Ejecuta /advisor off, o elige "No advisor" en el selector. Para desactivar la herramienta por completo, establece CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1. La documentación dice que el comando /advisor dejará de estar disponible y cualquier advisorModel configurado será ignorado.
Lo que la gente intenta primero
Esperar un error cuando el advisor deja de funcionar. Claude Code reenvía sin él y no muestra ningún error.
Asumir que el advisor conoce el historial de tu proyecto. Recibe la conversación.
Cambiar el advisor a mitad de la conversación después de un rechazo. La nueva elección surte efecto después de /clear o /compact.
Elegir un advisor más débil que el modelo principal. Debe tener un rango igual o superior al modelo principal.
Esperar un ajuste para forzar consultas. No existe. Pídelo en tus instrucciones.
La solución: Dale al advisor lo que necesita ver
Paso 1: Comprueba el emparejamiento
Ejecuta /advisor y confirma que el advisor tiene un rango igual o superior a tu modelo principal.
Paso 2: Vigila las líneas de Advising
En tareas largas, comprueba que las consultas sigan apareciendo y lee la guía con Ctrl+O.
Paso 3: Pon las restricciones clave en la conversación
Antes de una gran decisión, indica las restricciones que importan, para que formen parte de lo que lee el advisor.
Paso 4: Mantén las restricciones por escrito
Registra las decisiones y límites que deben dar forma a cada revisión, para que puedas llevarlos a cualquier sesión.
Configurando esto en MemoryLake
El advisor revisa lo que contiene la conversación. Las decisiones que deberían dar forma a su revisión, como por qué no se puede actualizar una dependencia, qué enfoque falló el trimestre pasado o qué módulo se está reemplazando, son contexto del proyecto que puede vivir fuera de una sola sesión.
MemoryLake es una capa de memoria para ese tipo de contexto de proyecto, como decisiones, restricciones y las razones detrás de ellas, mantenidas en un solo lugar que tú controlas y disponibles para los asistentes que conectes, como ChatGPT, Claude Code y Codex.
Tú mismo escribes las entradas, con tus propias palabras. No se lee nada de tus sesiones de Claude Code, ni se escribe ni se borra nada de ellas, ni de tus transcripciones, archivos de configuración, la guía del advisor o el almacén de cualquier proveedor. La herramienta advisor funciona de la manera que Anthropic describe.
Paso 1: Crea una clave API
Inicia sesión y genera una clave desde el panel de control. Guárdala fuera de tus repositorios, como cualquier otra credencial.

Paso 2: Sube tus primeras memorias
Comienza con lo que escribiste en el Paso 4 de la solución: las restricciones que cada revisión debe respetar. Una decisión por entrada.

Paso 3: Conecta tu IA y agentes
Conecta Claude Code, Codex y los otros asistentes que utilices. Las mismas restricciones pueden incorporarse a cualquier sesión antes de una gran decisión.

Qué cambia esto en la práctica
La primera diferencia son revisiones mejor informadas. Las restricciones que importan están en la conversación que lee el advisor.
La segunda es la consistencia entre sesiones. Cada nueva sesión puede comenzar con las mismas decisiones.
La tercera es la consistencia entre herramientas. El mismo contexto está disponible en Claude Code y en otros asistentes.
Mejores prácticas para la herramienta advisor
Úsala para tareas largas y con muchas decisiones. Las tareas cortas ganan poco.
Empareja un modelo principal rápido con un advisor más potente. Esa es la combinación que la documentación describe como típicamente más barata que ejecutar el modelo más potente en todo momento.
Comprueba el emparejamiento después de cambios de modelo. Un advisor debe tener un rango igual o superior al modelo principal.
Vigila el silencio. La ausencia de la línea de Advising puede significar que el advisor fue descartado.
Usa /clear o /compact después de cambiar de advisor. Un advisor rechazado permanece desactivado hasta entonces.
Indica las restricciones antes de las grandes decisiones. El advisor lee la conversación.
Pide consultas en tu prompt. No hay un ajuste para forzarlas.
Conclusión
La herramienta advisor permite a Claude consultar a un modelo más potente en momentos clave: antes de comprometerse con un enfoque, cuando un error se repite o antes de declarar una tarea como terminada. El advisor recibe la conversación completa cada vez, y su propia lectura no se almacena en caché, por lo que cada llamada procesa toda la transcripción de nuevo. Activarlo o desactivarlo no invalida el caché de prompts de tu modelo principal, y su guía se convierte en parte de la transcripción.
Claude Code deja de usar el advisor en varios casos, y cuando la API rechaza un emparejamiento, lo hace sin mostrar un error. Comprueba tu emparejamiento, vigila las líneas de Advising y pon las restricciones que importan en la conversación, para que la revisión del advisor se base en lo que realmente necesitas que sepa.