Claude Code advisor vs kongming e /ak:advise: quando você precisa de uma segunda opinião de IA? (2026)

- Os nomes e o comportamento dos comandos (a ferramenta advisor, @kongming, --advice, /ak:advise) foram conferidos com a documentação do Claude Code e do AgentKit no momento em que escrevo; essas superfícies mudam rápido, então confira a documentação atual antes de depender delas.

O que é advisory supervision no Claude Code?

Advisory supervision é uma etapa em que você pede conselho num ponto de decisão difícil, separada de executar o trabalho. Em vez de deixar o agente decidir e aplaudir a própria escolha, você insere uma segunda voz para revisar a arquitetura, um trade-off ou uma decisão de go/no-go antes de seguir em frente.

O Claude Code traz um mecanismo para isso, e o AgentKit adiciona mais dois. As pessoas costumam misturar os três, mas eles se comportam de formas bem diferentes. Se você ainda não tem clareza sobre o que é um subagent, leia antes o guia prático de subagents, porque quase toda a diferença se resume a "ele tem o próprio contexto ou não". O conceito de advisory do AgentKit está descrito na documentação oficial de advisory-supervision.

"advisor" - três sentidos que as pessoas confundem

Antes de comparar, vamos desembaraçar a palavra "advisor", porque ela é usada para três coisas diferentes:

• ferramenta advisor - o recurso embutido do Claude Code, uma chamada de ferramenta em tempo de execução.
• advisor (agente) - um agente de aconselhamento do AgentKit, orientado a entrevista.
• /ak:advise - o comando que roda essa entrevista de aconselhamento.

E uma linha para evitar confusão de marca: AgentKit aqui é o kit para o Claude Code (agentkit.best, a CLI ak) - NÃO o OpenAI AgentKit (Agent Builder/ChatKit).

O advisor embutido do Claude Code: prático, mas compartilha contexto

O Claude Code tem uma ferramenta advisor embutida para escalar decisões difíceis (conforme a documentação do advisor do Claude Code). O mecanismo é simples: a sessão principal chama o advisor como um recurso nativo, o runtime entrega o contexto atual a um modelo advisor mais forte, esse modelo devolve um comentário, e a sessão principal lê e continua.

O ponto-chave: ele não tem um espaço de trabalho ou loop próprio como um subagent. É uma única rodada de consulta dentro do contexto da sessão principal.

As vantagens são reais: é rápido, gratuito (embutido no Claude Code) e vive dentro do seu fluxo, então não há troca de contexto. Para uma decisão leve - "essa abordagem está OK?" - já é mais que suficiente. A desvantagem é justamente esse contexto compartilhado: como o advisor enxerga todo o plano que você está seguindo, é fácil ele concordar com você e difícil dar uma visão de fato independente. É essa lacuna que o kongming foi feito para fechar.

Você pode ligar o advisor de três formas: rode /advisor <model> (deixe sem argumento para abrir um seletor, ex.: /advisor opus), defina advisorModel no seu arquivo de configurações, ou inicie com a flag --advisor <model> - só para uma sessão, e ela não aparece em claude --help. Desligue com /advisor off, ou desative de vez com a variável de ambiente CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1.

Um limite que vale saber: a ferramenta advisor ainda é experimental e exclusiva da API da Anthropic - não está disponível no Bedrock, no Claude Platform na AWS, no Agent Platform do Google Cloud nem no Microsoft Foundry.

Sobre o pareamento de modelos: o Claude Code tem uma tabela dedicada de pareamento main/advisor, e o Fable 5 (precisa do CC v2.1.170+) é uma escolha válida - em alguns planos, escolher o Fable como advisor pela primeira vez exige seu consentimento único para cobrar em créditos de uso via /model fable antes de ele realmente entrar em ação.

Uma confusão fácil: --advisor é a flag do próprio Claude Code (escolhe qual modelo faz o papel de advisor), enquanto --advice, mais adiante, é a flag do AgentKit (liga a supervisão do kongming dentro de uma skill de workflow). Uma letra de diferença, dois mecanismos completamente distintos - não troque um pelo outro na digitação.

kongming: conselho de uma rodada em contexto isolado

O kongming é o agente de aconselhamento de checkpoint do AgentKit. Cada chamada é uma rodada nova: ele recebe a tarefa, as evidências e uma pergunta específica, responde uma vez e encerra. Ele roda de forma autônoma no modelo mais forte sem obrigar você a trocar o modelo da sua sessão e, o mais importante - ele devolve só conselho, nunca código.

Ele foi feito para os pontos que exigem pensamento de verdade: arquitetura, trade-offs, um problema de debugging difícil, uma decisão de go/no-go, ou quando você tem várias abordagens conflitantes. Como roda em contexto isolado, ele não "sabe de antemão" para qual opção você está pendendo - então a opinião dele carrega menos viés.

Duas formas de chamar o kongming

Há duas formas comuns:

• Chamar @agent-kongming diretamente quando você quer fazer uma pergunta ali na hora (digite @ e escolha o kongming nas sugestões - o Claude Code o mostra como kongming (agent)). Isso é mais manual: você escolhe o momento e fornece o contexto/as evidências.
• Usar a flag --advice em skills de workflow como ak:plan, ak:cook, ak:fix, ak:vibe. Aí o workflow define o checkpoint sozinho, reúne a tarefa/evidências/tentativas/ponto de decisão e chama o kongming para o conselho.

Resumindo: @agent-kongming é você convidando o advisor; --advice liga um modo em que o workflow convida o advisor nos pontos importantes. Numa tarefa longa e de vários passos, --advice é mais prático porque você não precisa lembrar de parar e perguntar. Para posicioná-lo corretamente no seu processo, veja o workflow brainstorm → plan → cook → ship.

O advisor do AgentKit: pergunta primeiro, depois aconselha

O advisor do AgentKit difere dos dois por ser guiado por entrevista: ele não responde de uma vez, mas pode fazer uma pergunta de cada vez para esclarecer o problema antes de aconselhar. Encaixa quando os requisitos ainda estão nebulosos e você precisa de um diálogo para cravar "o que eu estou construindo, afinal".

Há duas formas de usar:

• /ak:advise: roda a entrevista dentro da própria sessão principal - mais leve, sem gerar um agente separado.
• /ak:advise --agent: delega a um agente advisor separado - ele ainda faz uma pergunta de cada vez, mas o papel de aconselhamento fica destacado do workflow principal.

Um detalhe técnico interessante: um subagent do Claude Code não consegue abrir um prompt para o usuário sozinho, então no modo --agent o advisor repassa cada pergunta de volta à sessão orquestradora e é reinstanciado com a sua resposta. É assim que você ainda tem a experiência de entrevista mesmo com o aconselhamento rodando num agente separado.

Comparação: advisor vs kongming vs /ak:advise

Por que adicionar kongming + --advice se o Claude Code já tem um advisor?

Pergunta justa: o Claude Code já tem um "advisor", então por que adicionar o kongming e a flag --advice? Resume-se a duas coisas: profundidade e contexto isolado.

A própria documentação do Claude Code sustenta discretamente essa leitura: na tabela que compara o advisor com outras formas de combinar modelos, a Anthropic descreve a ferramenta advisor como algo que roda "em pontos de decisão no meio da tarefa", enquanto os subagents (onde o kongming vive) rodam "durante toda a subtarefa delegada" - isolados. É a própria documentação da Anthropic traçando a mesma linha de compartilhado vs. isolado que este artigo já faz.

O advisor embutido compartilha contexto com a sessão principal, o que significa que ele já sabe qual plano você está seguindo. Um advisor que conhece a resposta que você espera tende a concordar - como pedir para o mesmo dev que construiu testar o próprio trabalho. O kongming roda em contexto isolado, recebe só a tarefa e a pergunta, então questiona do zero e carrega menos viés. O trade-off: é um agente separado, então custa mais tokens e só vem com o kit.

Sendo justa: o advisor embutido não é ruim. Para checagens leves do dia a dia, rápido e gratuito basta. O problema só aparece quando a decisão é grande o bastante para exigir uma visão realmente independente. Para entender por que uma chamada de ferramenta difere de um subagent em termos de isolamento, veja skills vs subagents vs hooks vs MCP.

Qual usar, e quando (decisão rápida)

• advisor do CC - quando você precisa de uma checagem rápida que não exige objetividade absoluta. "Essa direção está OK?" no meio do código.
• kongming (ou --advice) - para decisões de arquitetura, go/no-go, debugging difícil, ou quando várias abordagens conflitam e você quer uma opinião objetiva. Use --advice se quiser que o workflow insira o conselho nos checkpoints por você.
• /ak:advise - quando os requisitos estão nebulosos e você precisa fazer perguntas para travar o escopo antes de começar.

Quer os agentes de aconselhamento prontos? (AgentKit)

kongming, advisor e a flag --advice vêm com o AgentKit (o Engineer Kit, agentkit.best, CLI ak). Para ser franca e você pesar direito: o advisor embutido do Claude Code continua gratuito e ótimo para trabalho leve; o kit agrega valor em profundidade, contexto isolado e integração de workflow (inserir o conselho nos checkpoints). Para ver o que tem dentro, leia a análise do AgentKit ou a análise do Engineer Kit.

Perguntas frequentes (FAQ)

O que é o advisor do Claude Code?

É uma chamada de ferramenta embutida para escalar decisões difíceis: a sessão principal a chama como um recurso nativo, o runtime passa o contexto atual a um modelo advisor mais forte, esse modelo devolve um comentário, e a sessão principal continua. Ele não tem espaço de trabalho ou loop próprio como um subagent.

Como o kongming difere do advisor do AgentKit?

O kongming responde de uma vez num checkpoint e roda em contexto isolado no modelo mais forte, dando só conselho - nunca editando código. O advisor do AgentKit é guiado por entrevista - ele faz uma pergunta de cada vez para esclarecer o problema antes de aconselhar. Um questiona rápido e com objetividade; o outro conduz um diálogo para esclarecer requisitos.

Como o @agent-kongming difere da flag --advice?

Os dois chamam o kongming; a diferença é quem aperta o botão. @agent-kongming é você convidando o advisor e fornecendo o contexto. A flag --advice em ak:plan/ak:cook/ak:fix/ak:vibe liga um modo em que o workflow define o checkpoint, reúne as evidências e chama o kongming por você.

Como o /ak:advise difere do /ak:advise --agent?

/ak:advise roda a entrevista dentro da própria sessão principal - leve, sem agente separado. /ak:advise --agent delega a um agente advisor separado - ele ainda faz uma pergunta de cada vez, mas o papel de aconselhamento fica destacado do workflow principal.

Por que você precisa de conselho em "contexto isolado"?

Porque um advisor que já conhece o seu plano tende a ficar enviesado a favor dele - como pedir para um dev testar a própria build. Um contexto isolado deixa o kongming questionar do zero com menos viés, o que combina com decisões importantes que precisam de uma visão independente.

O kongming e o advisor editam código?

Não. Ambos são papéis de aconselhamento - eles devolvem conselho, não mudanças de código. Você continua sendo quem decide e executa; eles só ajudam você a enxergar com mais clareza antes de agir.

Conclusão

Escolha pela dificuldade da decisão: para trabalho leve, use o advisor embutido pela velocidade; para decisões realmente difíceis que precisam de objetividade, recorra ao kongming ou ligue o --advice; e quando os requisitos estiverem nebulosos, deixe o /ak:advise fazer perguntas para travar o escopo. Posicione o conselho corretamente no workflow brainstorm → plan → cook → ship e, se quiser o kongming/advisor prontos para usar, veja a análise do Engineer Kit.