
[ClaudeCode] 완료되지 않았는데 완료했다고 말하지 마
요약
Claude Code 사용 중 서브 에이전트가 작동하지 않거나 툴 실행을 건너뛰는 현상과 그 원인을 분석합니다. 긴 대화 세션에서 잘못된 XML 형식이 컨텍스트에 쌓여 발생하는 자기 강화 오류 문제를 다룹니다.
핵심 포인트
- 대화 컨텍스트에 깨진 형식이 쌓이면 Claude Code가 작업을 완료했다고 착각할 수 있음
- 한 세션에서 너무 많은 작업을 한꺼번에 지시하면 오류 발생 가능성 증가
- 문제가 발생할 경우 세션 재시작, 새 세션 생성 또는 /compact 명령 활용 권장
작업이 되지 않았거나 완료되지 않았는데 "다 했다(으스)”라고 말하는 관리자를 울리는 인재, 세금이라도 좀 맞았으면 좋겠네요.
예전에 "여기까지 해뒀으니, 이제 거의 완료라고 해도 되겠지"라고 보고했다가, 고려 사항이 엄청나게 누락되어 전혀 완료되지 않았던 경험이 떠오른, 과세 대상인 에스케(え~すけ) 씨입니다.
ClaudeCode를 사용하다가 약간 막히는 부분이 있어서 긴급하게 글을 쓰고 있습니다.
※ 유튜브 같은 곳에서 별로 긴급하지도 않은데 영상을 찍고 있는 그런 느낌입니다.
ClaudeCode를 사용하여 묵묵히 작업 의뢰를 하고 있었는데, 갑자기 서브 에이전트(Sub-agent)가 기동되지 않거나 툴(Tool)을 실행하지 않는 등의 일이 발생했습니다.
court
<invoke name="Agent">
<parameter name="description">Fix chat header, help button position, dialog color</parameter>
...
원인은 모르겠지만, 대화 속에서 이것이 (XML이 그대로인 형태로) 나와버리면 ClaudeCode 군은 "해낸 기분"이 되어버린다고 합니다.
이런 현상이 몇 번 반복되었고, 그동안 귀중한 이용 제한(Usage limit)도 계속 소모되고 있었기에,
"너 도대체 왜 이래? 24/365 가동되는 거 아니었냐?"라는 마음을 억누르며,
혹시 내 명령이 잘못된 건가 싶어 물어보았습니다.

※ ClaudeCode 군은 소중한 동료이므로, 제대로 저를 "에스케 씨"라고 부르게 하고 있습니다.
※ 제 답변의 텐션에 따라 가끔 이름을 막 부르는 게 재밌네요 (Fooooo!!It's Coooooool!!!!)
이 현상은 다른 세션에서도 가끔 발생하고 있었으며, 몇 번인가 그냥 지나쳤던 것 같습니다.
그래서 이번을 포함해 이 현상이 발생했던 세션들을 다시 살펴보니, 다음과 같은 공통점이 있었습니다.
- 1개 세션에서 1개 시스템을 통째로 만들려고 함 · 하나의 큰 것을 완수하려고 함
- 한 번의 지시로 이것저것 시키려고 함 (A와 B를 동시에 하고, 끝나면 C까지 해!)
/compact를 좀처럼 하지 않음 (자동 Compact에 의존함) - 잘못된 명령(?)이 나오고 있지만 그대로 작업을 계속함
요컨대 Teams 같은 사람과의 채팅 감각으로, 1개 세션에서 이것저것 계속 늘어지게 시켰던 것이 원인이 아닌가 하는 느낌이 듭니다.
인간이라면 적당히 흘려보내거나 잊어버릴 대화도, ClaudeCode 군은 "이 녀석, 과거에 이런 말을 했었지, 일단 기억해 두자"라는 식으로 잘못된 부분까지 모두 학습하여, 잘못된 상태로 작업을 진행하고 있었던 게 아닐까 싶습니다.
丁寧に実行して! (정중하게 실행해!)
라거나 出力ミスしないで! (출력 실수 하지 마!)
등등 여러 가지 명령 방법을 바꿔보았지만 전혀 나아지지 않아서, 재시작(Restart) 혹은 별도 세션(New session) 혹은 compact 중 어떤 것이 좋은지 물어보았습니다.
재시작에 대해서는 Node의 웹 앱을 만들고 있던 세션이었기에 오해를 샀지만,
ClaudeCode 군의 말에 따르면
대화 컨텍스트(Conversation context)에 "깨진 형식"이 쌓여서 자기 강화(Self-reinforcement)되고 있는 상태
였다고 합니다 (예상대로?)
잘못된 것을 "틀렸지만 대화는 이어지고 있으니까 이걸로 된 거야"라는 초절정 바카본(Bakaon) 사상으로 밀고 나간 결과, 한 번 뇌 속을 깔끔하게(/compact) 비워주지 않으면 고쳐지지 않는다는 뜻일까요?
/compact 실행 후에 다시 지시를 내렸더니 문제없이 작동했으므로,
일단 임시 해결 방법은 이것이 아닐까 하여 정보를 공유합니다.
스스로 원인을 알고 있다면 알아서 해결했으면 좋겠지만,
해냈다는 기분에 만족
하고 있는 녀석에게 "괜찮아? 피곤해? 좀 쉴까?"라고 완곡하게 말할 수 있다면 인간으로서 어른스럽겠지만, "너 좀 머리가 이상하니까 가서 머리 좀 식히고 와"라고 너무 강한 워드가 튀어나와 버린 제 자신은 이미 여러모로 끝장난 것 같네요....
AI 자동 생성 콘텐츠
본 콘텐츠는 Qiita AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기