Claude Code advisor vs kongming y /ak:advise: ¿cuándo necesitas una segunda opinión de IA? (2026)

- Los nombres y el comportamiento de los comandos (la herramienta advisor, @kongming, --advice, /ak:advise) se contrastaron con la documentación de Claude Code y AgentKit al momento de escribir; estas superficies cambian rápido, así que verifica la documentación vigente antes de depender de ellas.

¿Qué es la advisory supervision en Claude Code?

La advisory supervision es un paso en el que pides consejo en un punto de decisión difícil, separado de hacer el trabajo. En lugar de dejar que el agente decida y aplauda su propia elección, insertas una segunda voz para revisar la arquitectura, un trade-off o una decisión de go/no-go antes de seguir adelante.

Claude Code trae un mecanismo para esto, y AgentKit suma dos más. La gente tiende a mezclar los tres, pero se comportan de forma muy distinta. Si aún no tienes claro qué es un subagent, lee primero la guía práctica de subagents, porque casi toda la diferencia se reduce a "tiene su propio contexto o no". El concepto de advisory de AgentKit se describe en la documentación oficial de advisory-supervision.

"advisor": tres significados que la gente confunde

Antes de comparar, desenredemos la palabra "advisor", porque se usa para tres cosas distintas:

• herramienta advisor: la función integrada de Claude Code, una llamada de herramienta en tiempo de ejecución.
• advisor (agente): un agente de asesoría de AgentKit, orientado a entrevista.
• /ak:advise: el comando que ejecuta esa entrevista de asesoría.

Y una línea para evitar confusión de marca: AgentKit aquí es el kit para Claude Code (agentkit.best, la CLI ak), NO el OpenAI AgentKit (Agent Builder/ChatKit).

El advisor integrado de Claude Code: práctico, pero comparte contexto

Claude Code tiene una herramienta advisor integrada para escalar decisiones difíciles (según la documentación del advisor de Claude Code). Su mecanismo es sencillo: la sesión principal llama al advisor como una capacidad nativa, el runtime entrega el contexto actual a un modelo advisor más fuerte, ese modelo devuelve un comentario, y la sesión principal lo lee y continúa.

El punto clave: no tiene un espacio de trabajo ni un loop propio como un subagent. Es una única ronda de consulta dentro del contexto de la sesión principal.

Las ventajas son reales: es rápido, gratis (integrado en Claude Code) y vive dentro de tu flujo, así que no hay cambio de contexto. Para una decisión ligera —"¿esta aproximación está bien?"— sobra. La desventaja es justamente ese contexto compartido: como el advisor ve todo el plan que sigues, le resulta fácil darte la razón y difícil ofrecer una visión realmente independiente. Esa es la brecha que kongming viene a cerrar.

Puedes activar el advisor de tres maneras: ejecuta /advisor <model> (déjalo sin argumento para abrir un selector, p. ej. /advisor opus), define advisorModel en tu archivo de configuración, o inícialo con la flag --advisor <model> —solo para una sesión, y no aparece en claude --help—. Desactívalo con /advisor off, o deshabilítalo por completo con la variable de entorno CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1.

Un límite que conviene conocer: la herramienta advisor todavía es experimental y exclusiva de la API de Anthropic; no está disponible en Bedrock, en Claude Platform en AWS, en el Agent Platform de Google Cloud ni en Microsoft Foundry.

Sobre el emparejamiento de modelos: Claude Code tiene una tabla dedicada de emparejamiento main/advisor, y Fable 5 (requiere CC v2.1.170+) es una opción válida; en algunos planes, elegir Fable como advisor por primera vez requiere tu consentimiento único para cobrarlo a los créditos de uso vía /model fable antes de que entre en acción.

Una confusión fácil: --advisor es la flag propia de Claude Code (elige qué modelo hace de advisor), mientras que --advice, más abajo, es la flag de AgentKit (activa la supervisión de kongming dentro de una skill de workflow). Una letra de diferencia, dos mecanismos completamente distintos: no escribas uno por el otro.

kongming: consejo de una sola ronda en contexto aislado

kongming es el agente de asesoría de checkpoint de AgentKit. Cada llamada es una ronda nueva: toma la tarea, la evidencia y una pregunta concreta, responde una vez y cierra. Corre de forma autónoma en el modelo más fuerte sin obligarte a cambiar el modelo de tu sesión y, lo más importante, devuelve solo consejo, nunca código.

Está hecho para los puntos que exigen pensar de verdad: arquitectura, trade-offs, un problema de debugging difícil, una decisión de go/no-go, o cuando tienes varias aproximaciones en conflicto. Como corre en contexto aislado, no "sabe de antemano" hacia qué opción te inclinas, así que su opinión carga menos sesgo.

Dos maneras de llamar a kongming

Hay dos formas comunes:

• Llamar a @agent-kongming directamente cuando quieres hacer una pregunta ahí mismo (escribe @ y elige kongming en las sugerencias; Claude Code lo muestra como kongming (agent)). Esto es más manual: eliges el momento y aportas tú el contexto/la evidencia.
• Usar la flag --advice en skills de workflow como ak:plan, ak:cook, ak:fix, ak:vibe. Entonces el workflow fija el checkpoint por sí mismo, reúne la tarea/evidencia/intentos/punto de decisión y llama a kongming para el consejo.

En resumen: @agent-kongming eres tú invitando al advisor; --advice activa un modo en el que el workflow invita al advisor en los puntos importantes. En una tarea larga de varios pasos, --advice es más cómodo porque no tienes que acordarte de parar y preguntar. Para ubicarlo bien en tu proceso, mira el workflow brainstorm → plan → cook → ship.

El advisor de AgentKit: pregunta primero, luego asesora

El advisor de AgentKit se diferencia de ambos por ir guiado por entrevista: no responde de una sola vez, sino que puede hacerte una pregunta a la vez para aclarar el problema antes de asesorar. Encaja cuando los requisitos aún están difusos y necesitas un diálogo para clavar "qué estoy construyendo en realidad".

Hay dos maneras de usarlo:

• /ak:advise: ejecuta la entrevista dentro de la propia sesión principal; más ligero, sin generar un agente aparte.
• /ak:advise --agent: delega en un agente advisor separado; sigue preguntando una a una, pero el rol de asesoría se separa del workflow principal.

Un detalle técnico interesante: un subagent de Claude Code no puede abrir por sí mismo un prompt para el usuario, así que en el modo --agent el advisor devuelve cada pregunta a la sesión orquestadora y se vuelve a instanciar con tu respuesta. Así logras la experiencia de entrevista aunque la asesoría corra en un agente aparte.

Comparación: advisor vs kongming vs /ak:advise

¿Por qué añadir kongming + --advice si Claude Code ya tiene un advisor?

Pregunta justa: Claude Code ya tiene un "advisor", entonces ¿por qué añadir kongming y la flag --advice? Se reduce a dos cosas: profundidad y contexto aislado.

La propia documentación de Claude Code respalda en voz baja este enfoque: en su tabla que compara el advisor con otras formas de combinar modelos, Anthropic describe la herramienta advisor como algo que corre "en puntos de decisión a mitad de la tarea", mientras que los subagents (donde vive kongming) corren "durante toda la subtarea delegada", aislados. Es la propia documentación de Anthropic trazando la misma línea de compartido vs. aislado que este artículo ya plantea.

El advisor integrado comparte contexto con la sesión principal, lo que significa que ya sabe qué plan sigues. Un advisor que conoce la respuesta que esperas tiende a asentir, como pedirle al mismo dev que lo construyó que lo pruebe. kongming corre en contexto aislado, recibe solo la tarea y la pregunta, así que rebate desde cero y carga menos sesgo. El trade-off: es un agente aparte, así que consume más tokens y solo viene con el kit.

Para ser justa: el advisor integrado no es malo. Para comprobaciones ligeras del día a día, rápido y gratis basta. El problema solo aparece cuando la decisión es lo bastante grande como para exigir una visión de verdad independiente. Para entender por qué una llamada de herramienta difiere de un subagent en cuanto a aislamiento, mira skills vs subagents vs hooks vs MCP.

Cuál usar, y cuándo (decisión rápida)

• advisor de CC: cuando necesitas una comprobación rápida que no exige objetividad absoluta. "¿Va bien esta dirección?" a mitad del código.
• kongming (o --advice): para decisiones de arquitectura, go/no-go, debugging difícil, o cuando varias aproximaciones chocan y quieres una opinión objetiva. Usa --advice si quieres que el workflow inserte el consejo en los checkpoints por ti.
• /ak:advise: cuando los requisitos están difusos y necesitas preguntar para fijar el alcance antes de empezar.

¿Quieres los agentes de asesoría ya listos? (AgentKit)

kongming, advisor y la flag --advice vienen con AgentKit (el Engineer Kit, agentkit.best, CLI ak). Para ser franca y que lo sopeses bien: el advisor integrado de Claude Code sigue siendo gratis y suficiente para trabajo ligero; el kit aporta valor en profundidad, contexto aislado e integración con el workflow (insertar el consejo en los checkpoints). Para ver qué trae, lee la reseña de AgentKit o la reseña del Engineer Kit.

Preguntas frecuentes (FAQ)

¿Qué es el advisor de Claude Code?

Es una llamada de herramienta integrada para escalar decisiones difíciles: la sesión principal la llama como una capacidad nativa, el runtime pasa el contexto actual a un modelo advisor más fuerte, ese modelo devuelve un comentario, y la sesión principal continúa. No tiene un espacio de trabajo ni un loop propio como un subagent.

¿En qué se diferencia kongming del advisor de AgentKit?

kongming responde de una sola vez en un checkpoint y corre en contexto aislado en el modelo más fuerte, dando solo consejo, sin editar código nunca. El advisor de AgentKit va guiado por entrevista: te hace una pregunta a la vez para aclarar el problema antes de asesorar. Uno rebate rápido y con objetividad; el otro sostiene un diálogo para aclarar requisitos.

¿En qué se diferencia @agent-kongming de la flag --advice?

Ambos llaman a kongming; la diferencia es quién aprieta el botón. @agent-kongming eres tú invitando al advisor y aportando el contexto. La flag --advice en ak:plan/ak:cook/ak:fix/ak:vibe activa un modo en el que el workflow fija el checkpoint, reúne la evidencia y llama a kongming por ti.

¿En qué se diferencia /ak:advise de /ak:advise --agent?

/ak:advise ejecuta la entrevista dentro de la propia sesión principal: ligero, sin agente aparte. /ak:advise --agent delega en un agente advisor separado: sigue preguntando una a una, pero el rol de asesoría se separa del workflow principal.

¿Por qué necesitas consejo en "contexto aislado"?

Porque un advisor que ya conoce tu plan tiende a inclinarse a su favor, como pedirle a un dev que pruebe su propia build. Un contexto aislado deja que kongming rebata desde cero con menos sesgo, lo que conviene a decisiones importantes que necesitan una visión independiente.

¿kongming y advisor editan código?

No. Ambos son roles de asesoría: devuelven consejo, no cambios de código. Sigues siendo tú quien decide y ejecuta; ellos solo te ayudan a ver con más claridad antes de actuar.

Conclusión

Elige según lo difícil que sea la decisión: para trabajo ligero, usa el advisor integrado por rapidez; para decisiones de verdad difíciles que necesitan objetividad, recurre a kongming o activa --advice; y cuando los requisitos estén difusos, deja que /ak:advise haga preguntas para fijar el alcance. Ubica el consejo correctamente en el workflow brainstorm → plan → cook → ship y, si quieres kongming/advisor listos para usar, mira la reseña del Engineer Kit.