Claude Code advisor vs kongming & /ak:advise: AI 세컨드 오피니언이 언제 필요할까? (2026)

- 명령 이름과 동작(advisor 도구, @kongming, --advice, /ak:advise)은 작성 시점에 Claude Code와 AgentKit 문서와 대조했어요. 이런 기능은 빠르게 바뀌니, 의존하기 전에 최신 문서를 확인하세요.

Claude Code의 advisory supervision이란?

Advisory supervision은 어려운 의사결정 지점에서, 작업 자체와 분리해 조언을 구하는 단계예요. 에이전트가 결정과 자화자찬을 모두 하게 두는 대신, 다음으로 넘어가기 전에 아키텍처나 트레이드오프, 또는 go/no-go 판단을 다시 점검하는 두 번째 목소리를 끼워 넣는 거예요.

Claude Code는 이를 위한 메커니즘을 하나 제공하고, AgentKit은 여기에 두 가지를 더 추가해요. 사람들은 이 셋을 한데 묶어 생각하기 쉽지만, 동작 방식은 크게 달라요. subagent가 무엇인지 아직 확실하지 않다면, 먼저 subagent 실전 가이드를 읽어 보세요. 차이의 대부분은 "자기만의 컨텍스트가 있는지 없는지"로 귀결되니까요. AgentKit의 advisory 개념은 공식 advisory-supervision 문서에서 설명해요.

"advisor" — 사람들이 혼동하는 세 가지 의미

비교하기 전에 "advisor"라는 단어를 풀어 두죠. 세 가지 서로 다른 것을 가리키는 데 쓰이니까요.

• advisor 도구 — Claude Code의 내장 기능으로, 런타임 도구 호출.
• advisor(에이전트) — AgentKit의 조언 에이전트로, 인터뷰 지향.
• /ak:advise — 그 조언 인터뷰를 실행하는 명령.

그리고 브랜드 혼동을 피하기 위한 한마디: 여기서 AgentKit은 Claude Code를 위한 키트(agentkit.best, ak CLI)이지, OpenAI AgentKit(Agent Builder/ChatKit)이 아니에요.

Claude Code의 내장 advisor: 편리하지만 컨텍스트를 공유해요

Claude Code에는 어려운 결정을 에스컬레이션하는 내장 advisor 도구가 있어요(Claude Code advisor 문서 기준). 메커니즘은 단순해요. 메인 세션이 네이티브 기능처럼 advisor를 호출하고, 런타임이 현재 컨텍스트를 더 강력한 advisor 모델에 넘기고, 그 모델이 코멘트를 반환하면, 메인 세션이 그걸 읽고 계속 진행해요.

핵심은 subagent 같은 독립된 워크스페이스나 루프가 없다는 점이에요. 메인 세션 컨텍스트 안에서 이뤄지는 단 한 번의 상담이에요.

장점은 진짜예요. 빠르고, 무료이며(Claude Code에 내장), 작업 흐름 바로 옆에 있어서 컨텍스트 전환이 없어요. "이 접근이 괜찮을까?" 같은 가벼운 결정에는 차고 넘쳐요. 단점은 바로 그 컨텍스트 공유예요. advisor는 여러분이 따르는 계획 전체를 보고 있어서, 여러분에게 맞장구치기 쉽고 진정으로 독립적인 견해를 내기 어려워요. 바로 이 틈을 메우려고 만든 게 kongming이에요.

advisor는 세 가지 방법으로 켤 수 있어요. /advisor <model>를 실행하거나(인자 없이 두면 선택기가 열려요. 예: /advisor opus), 설정 파일에서 advisorModel을 지정하거나, --advisor <model> 플래그로 실행하는 방법이에요 — 이건 단일 세션 전용이고, claude --help에는 나오지 않아요. 끄려면 /advisor off를, 완전히 비활성화하려면 환경 변수 CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1을 쓰세요.

알아 둘 만한 제한이 하나 있어요. advisor 도구는 아직 실험적이고 Anthropic API 전용이에요 — Bedrock, AWS의 Claude Platform, Google Cloud의 Agent Platform, Microsoft Foundry에서는 쓸 수 없어요.

모델 페어링에 대해: Claude Code에는 전용 main/advisor 페어링 표가 있고, Fable 5(CC v2.1.170 이상 필요)도 유효한 선택지예요. 일부 플랜에서는 Fable을 advisor로 처음 고를 때, 실제로 작동하기 전에 /model fable로 사용 크레딧 청구에 한 번 동의해야 해요.

쉽게 헷갈리는 점 하나: --advisor는 Claude Code 자체의 플래그(어떤 모델이 advisor 역할을 할지 선택)이고, 아래의 --advice는 AgentKit의 플래그(워크플로 스킬 안에서 kongming supervision을 켬)예요. 한 글자 차이지만 완전히 다른 메커니즘이에요 — 하나를 다른 것으로 잘못 입력하지 마세요.

kongming: 분리된 컨텍스트에서의 원샷 조언

kongming은 AgentKit의 체크포인트 조언 에이전트예요. 호출할 때마다 새로운 라운드예요. 작업, 근거, 구체적인 질문을 받아 한 번만 답하고 닫아요. 세션 모델을 바꾸도록 강요하지 않고 가장 강력한 모델로 자율 실행되며, 무엇보다 — 조언만 반환하고, 절대 코드를 쓰지 않아요.

정말로 사고가 필요한 지점을 위해 만들어졌어요. 아키텍처, 트레이드오프, 까다로운 디버깅 문제, go/no-go 판단, 또는 상충하는 여러 접근이 있을 때죠. 분리된 컨텍스트에서 실행되기 때문에, 여러분이 어느 선택지로 기울고 있는지 "미리 알지" 못해요 — 그래서 그 의견은 편향이 덜해요.

kongming을 호출하는 두 가지 방법

흔한 방법은 두 가지예요.

• @agent-kongming을 직접 호출 — 바로 그 자리에서 한 가지만 묻고 싶을 때(@를 입력하고 후보에서 kongming을 고르세요. Claude Code에서는 kongming (agent)로 표시돼요). 이건 더 수동적이라, 시점을 직접 고르고 컨텍스트/근거도 직접 제공해요.
• --advice 플래그 사용 — ak:plan, ak:cook, ak:fix, ak:vibe 같은 워크플로 스킬에서요. 그러면 워크플로가 스스로 체크포인트를 정하고, 작업/근거/시도/의사결정 지점을 모아 kongming에게 조언을 구해요.

요컨대 @agent-kongming은 여러분이 advisor를 불러들이는 것이고, --advice는 워크플로가 중요한 지점에서 advisor를 부르는 모드를 켜는 거예요. 길고 여러 단계인 작업에서는 멈춰서 물어봐야 한다는 걸 기억할 필요가 없으니 --advice가 더 편해요. 프로세스 안에 올바르게 배치하려면 brainstorm → plan → cook → ship 워크플로를 참고하세요.

AgentKit의 advisor: 먼저 질문하고, 그다음 조언해요

AgentKit의 advisor는 인터뷰 방식이라는 점에서 둘 다와 달라요. 한 번에 답하지 않고, 조언하기 전에 문제를 명확히 하려고 한 번에 한 가지씩 물을 수 있어요. 요구사항이 아직 모호해서 "내가 실제로 무엇을 만들고 있는가"를 대화로 짚어내야 할 때 적합해요.

쓰는 방법은 두 가지예요.

• /ak:advise: 인터뷰를 메인 세션 안에서 바로 실행해요 — 더 가볍고, 별도 에이전트를 생성하지 않아요.
• /ak:advise --agent: 별도의 advisor 에이전트에 위임해요 — 이 경우에도 한 번에 한 가지씩 묻지만, 조언 역할이 메인 워크플로에서 분리돼요.

흥미로운 기술적 세부 하나: Claude Code subagent는 스스로 사용자 프롬프트를 열 수 없어서, --agent 모드에서는 advisor가 각 질문을 오케스트레이션하는 세션에 되돌리고, 여러분의 답과 함께 다시 생성돼요. 이렇게 해서 조언이 별도 에이전트에서 실행돼도 인터뷰 경험을 그대로 얻는 거예요.

비교: advisor vs kongming vs /ak:advise

Claude Code에 이미 advisor가 있는데 왜 kongming + --advice를 더할까?

당연한 질문이에요. Claude Code에는 이미 "advisor"가 있는데 왜 kongming과 --advice 플래그를 더할까요? 이유는 두 가지로 요약돼요. 깊이와 분리된 컨텍스트예요.

Claude Code 자체 문서도 이 관점을 은근히 뒷받침해요. advisor를 모델 결합의 다른 방식들과 비교한 표에서 Anthropic은 advisor 도구를 "작업 중간의 의사결정 지점에서" 실행되는 것으로 설명하고, subagent(kongming이 속한 곳)는 "위임된 하위 작업 전체에 걸쳐" 실행된다 — 분리돼 있다고 말해요. 이 글이 이미 그은 것과 똑같은 "공유 대 분리"의 선을, Anthropic 자체 문서가 긋고 있는 셈이에요.

내장 advisor는 메인 세션과 컨텍스트를 공유해요. 즉, 여러분이 어떤 계획을 따르는지 이미 알고 있다는 뜻이에요. 여러분이 기대하는 답을 아는 advisor는 그쪽으로 맞장구치기 쉬워요 — 만든 사람에게 직접 테스트를 맡기는 것과 같죠. kongming은 분리된 컨텍스트에서 실행되고 작업과 질문만 받으므로, 처음부터 반론하며 편향이 덜해요. 트레이드오프는, 별도 에이전트라 토큰을 더 쓰고 키트에만 포함된다는 점이에요.

공정하게 말하면, 내장 advisor가 나쁜 건 아니에요. 매일의 가벼운 점검에는 빠르고 무료라 충분해요. 문제는 결정이 진정으로 독립적인 견해가 필요할 만큼 클 때만 드러나요. 도구 호출이 분리라는 점에서 subagent와 어떻게 다른지 이해하려면 skills vs subagents vs hooks vs MCP를 참고하세요.

어떤 걸, 언제(빠른 결정)

• CC advisor — 절대적 객관성까지는 필요 없는, 빠른 점검이 필요할 때. 코딩 도중 "이 방향 괜찮아?".
• kongming(또는 --advice) — 아키텍처 판단, go/no-go, 까다로운 디버깅, 또는 여러 접근이 상충해 객관적 의견이 필요할 때. 워크플로가 체크포인트에서 조언을 끼워 넣게 하려면 --advice를 쓰세요.
• /ak:advise — 요구사항이 모호해서, 시작 전에 질문으로 범위를 확정해야 할 때.

조언 에이전트를 미리 만들어진 상태로 원하세요? (AgentKit)

kongming, advisor, 그리고 --advice 플래그는 AgentKit(Engineer Kit, agentkit.best, ak CLI)에 포함돼 있어요. 제대로 판단하도록 솔직히 말하면: Claude Code의 내장 advisor는 여전히 무료이고 가벼운 작업에는 충분해요. 키트가 가치를 더하는 건 깊이, 분리된 컨텍스트, 그리고 워크플로 통합(체크포인트에서 조언 끼워 넣기)에서예요. 무엇이 들었는지 보려면 AgentKit 리뷰 또는 Engineer Kit 리뷰를 읽어 보세요.

자주 묻는 질문(FAQ)

Claude Code의 advisor란?

어려운 결정을 에스컬레이션하는 내장 도구 호출이에요. 메인 세션이 네이티브 기능처럼 호출하고, 런타임이 현재 컨텍스트를 더 강력한 advisor 모델에 넘기고, 그 모델이 코멘트를 반환하면, 메인 세션이 계속 진행해요. subagent 같은 독립 워크스페이스나 루프는 없어요.

kongming은 AgentKit의 advisor와 어떻게 다른가요?

kongming은 체크포인트에서 한 번에 답하고, 분리된 컨텍스트에서 가장 강력한 모델로 실행되며, 조언만 줘요 — 절대 코드를 편집하지 않아요. AgentKit의 advisor는 인터뷰 방식이라, 조언하기 전에 문제를 명확히 하려고 한 번에 한 가지씩 물어요. 하나는 빠르고 객관적으로 반론하고, 다른 하나는 대화로 요구사항을 명확히 해요.

@agent-kongming은 --advice 플래그와 어떻게 다른가요?

둘 다 kongming을 부르지만, 차이는 버튼을 누르는 사람이 누구냐예요. @agent-kongming은 여러분이 advisor를 불러들이고 컨텍스트를 제공하는 거예요. ak:plan/ak:cook/ak:fix/ak:vibe의 --advice 플래그는, 워크플로가 체크포인트를 정하고 근거를 모아 여러분 대신 kongming을 부르는 모드를 켜요.

/ak:advise는 /ak:advise --agent와 어떻게 다른가요?

/ak:advise는 인터뷰를 메인 세션 안에서 바로 실행해요 — 가볍고, 별도 에이전트 없이요. /ak:advise --agent는 별도의 advisor 에이전트에 위임해요 — 이 경우에도 한 번에 한 가지씩 묻지만, 조언 역할이 메인 워크플로에서 분리돼요.

왜 "분리된 컨텍스트" 조언이 필요한가요?

여러분의 계획을 이미 아는 advisor는 그쪽으로 편향되기 쉽기 때문이에요 — 자기 빌드를 자기가 테스트하라고 맡기는 것과 같죠. 분리된 컨텍스트라면 kongming은 편향 없이 처음부터 반론할 수 있어, 독립적 견해가 필요한 중요한 결정에 잘 맞아요.

kongming과 advisor는 코드를 편집하나요?

아니요. 둘 다 조언 역할이라, 코드 변경이 아니라 조언을 반환해요. 결정하고 실행하는 사람은 여전히 여러분이고, 둘은 행동하기 전에 더 명확히 보도록 도울 뿐이에요.

결론

결정이 얼마나 어려운지에 따라 골라요. 가벼운 작업엔 속도를 위해 내장 advisor를, 객관성이 필요한 정말 어려운 판단엔 kongming에 기대거나 --advice를 켜고, 요구사항이 모호할 땐 /ak:advise가 질문해 범위를 확정하게 하세요. 조언을 brainstorm → plan → cook → ship 워크플로 안에 올바르게 배치하고, kongming/advisor를 바로 쓸 수 있게 갖추고 싶다면 Engineer Kit 리뷰를 참고하세요.