AI 에이전트 할 일 목록 — 요즘 모델은 기본으로 안 만듭니다

AI가 할 일 목록을 만들어 하나씩 지워가는 모습, 내 화면에도 그리고 싶죠. 그런데 아무리 시켜도 목록이 안 나온다면 고장이 아닙니다 — 요즘 모델에서는 그 도구가 기본으로 빠져 있습니다. 글로 안 적어도 여러 단계를 알아서 챙기기 때문이에요. 켜야 나오는데, 문서는 "내 앱이 그걸 읽어서 쓸 때만 켜라"고 선을 긋습니다. 정리했습니다.

📌 30초 요약

• ★★요즘 모델은 기본으로 안 만듭니다 — 고장이 아닙니다.
• 글로 안 적어도 여러 단계를 알아서 챙깁니다.
• ★읽어서 쓸 때만 켜라고 문서가 선을 긋습니다.
• ★★번호가 만들 때 안 옵니다 — 결과 쪽에 실립니다.
• ⚠️ 흘러오는 이름이 틀릴 수 있습니다.
• 내 설치본을 가리키면 그쪽 기본값을 따릅니다.

요즘 모델은 기본으로 안 만듭니다

먼저 안심할 이야기부터. 최근 세대 모델들은 글로 된 목록 없이도 여러 단계짜리 일을 알아서 챙깁니다. 그래서 할 일을 만들고 고치는 도구들이 세션에 아예 안 실립니다. 목록이 안 보인다고 일을 대충 하는 게 아니에요.

그래서 따로 켜지 않으면 그 도구를 부르는 흔적이 흐름에 하나도 안 나옵니다. "왜 목록을 안 만들지" 하고 프롬프트를 아무리 고쳐도 소용이 없는 이유죠. 반대로 그보다 앞선 세대에서는 기본으로 실려 있습니다. 모델을 바꿨더니 목록이 사라진 경우라면 십중팔구 이것입니다.

🎚️ 읽어서 쓸 때만 켜세요

문서가 선을 분명히 긋습니다 — 내 프로그램이 그 호출을 실제로 읽어서 기록을 남기거나 진행 화면을 그릴 때만 켜라는 겁니다. "보기 좋으니까" 켜는 건 권하지 않아요. 켜면 그만큼 도구 정의가 자리를 차지하고, 정작 아무도 안 읽으면 일만 늘어납니다. 켜는 방법은 세 가지 — 허용 목록에 이름을 적거나, 쓸 도구 목록에 포함시키거나, 환경 값으로 지정하면 됩니다.

번호가 만들 때 안 옵니다

켜고 나면 두 번째 함정이 기다립니다. 새 할 일을 만드는 호출에는 그 항목에 붙는 번호가 들어 있지 않습니다. 제목만 있어요. 번호는 그 호출의 결과 쪽에 실려 옵니다.

문제는 나중에 상태를 바꾸는 호출은 번호로만 대상을 지목한다는 겁니다. 그래서 만들기 호출만 보고 로그를 찍으면 "어떤 항목이 끝났다"는 갱신을 원래 항목과 이을 수가 없습니다. 목록을 화면에 유지하려면 결과 메시지까지 붙잡아 번호를 꺼내 두고, 호출과 결과를 짝지어 관리해야 해요.

하려는 것	어디까지 읽어야 하나
활동 로그만 찍기	호출만 봐도 됨 — 단 갱신을 원래 항목과 못 이음
진행 화면 유지하기	결과까지 붙잡아 번호를 꺼내야
항목 지우기	별도 명령이 아니라 상태 값으로 표시됨
진행 중 표시 문구	제목과 별개로 진행형 문구가 따로 옴

흘러오는 이름이 틀릴 수 있습니다

이건 알아두지 않으면 원인을 못 찾는 유형입니다. 흐름으로 오는 호출 내용은 모델이 뱉은 날것 그대로예요. 그런데 실제로 도구를 돌리기 전에 비슷하지만 조금 틀린 항목 이름을 알아서 고쳐주는 보정이 들어갑니다.

함정은 그 보정이 흐름에는 반영되지 않는다는 겁니다. 즉 도구는 멀쩡히 도는데, 내가 흐름에서 읽는 값은 이름이 다를 수 있어요. 그래서 문서가 "방어적으로 읽으라"고 권하고, 공식 예제도 같은 뜻의 이름 여러 개를 순서대로 확인하는 모양으로 되어 있습니다. 하나만 보고 짜면 가끔 항목이 통째로 누락됩니다.

언제 목록을 만드나

켜두면 웬만한 여러 단계 작업에서 알아서 만듭니다. 세 갈래 이상으로 나뉘는 일, 사용자가 여러 항목을 나열해 시킨 일, 오래 걸려서 진행 상황을 보여주면 좋은 일, 그리고 사람이 대놓고 정리해달라고 한 경우예요.

반대로 아주 짧거나 한 단계로 끝나는 요청에서는 그냥 건너뜁니다. 그러니 간단한 걸 시켜놓고 목록이 안 나온다고 걱정할 필요는 없어요. 상태는 대기 → 진행 중 → 완료 순으로 바뀌고, 필요 없어진 항목은 지움 표시로 정리됩니다. 도구를 붙여 에이전트 능력을 늘리는 방식과 같은 결이라, 필요한 것만 골라 켜는 게 원칙입니다.

자주 묻는 질문 (FAQ)

Q. 지금 어떤 도구가 실려 있는지 어떻게 보나요?

세션이 시작될 때 오는 첫 메시지에 목록이 들어 있습니다. 켜지 않았는데 목록이 안 보이는 게 정상인지, 켰는데도 안 실린 건지 여기서 갈라볼 수 있어요. 한 가지 주의할 게 있는데 — 내가 따로 설치한 실행 파일을 가리키도록 설정했다면 그쪽 기본값을 따릅니다. 개발 도구에 함께 담겨 오는 것과 다를 수 있으니, 팀원끼리 결과가 다르면 이걸 먼저 확인하세요.

Q. 배경에서 도는 작업 알림과는 다른 건가요?

네, 통로가 다릅니다. 배경으로 돌린 명령이나 하위 에이전트 같은 것들은 별도의 알림 메시지로 옵니다. 반면 할 일 활동은 AI가 도구를 부른 흔적으로 나타나요. 진행 화면을 만들 때 이 둘을 섞어 다루면 헷갈리니, 어느 통로에서 온 것인지 구분해 처리하세요.

Q. 켜면 비용이 늘어나나요?

도구 정의가 맥락을 차지하고, 목록을 만들고 고치는 호출도 차례를 씁니다. 큰 폭은 아니지만 공짜는 아니에요. 그래서 "읽어서 쓸 때만 켜라"는 권고가 나온 겁니다. 얼마나 늘었는지 재보고 싶다면 비용을 집계하는 방법을 참고하되, 그 숫자가 추정치라는 점도 함께 기억하세요.

🧾 정직하게 밝혀둘 것

• 제가 진행 화면을 만들어본 실측이 아닙니다. 공식 문서의 기본값·수명 주기·주의 사항을 우리말로 정리했습니다.
• ★도구 이름·설정 항목 이름·환경 변수·모델 목록·판올림 번호는 옮기지 않았습니다. 실제로 켤 때는 원문을 확인하세요.
• ★"모델을 바꿨더니 목록이 사라졌다면 이것"이라는 진단은 제 정리이고, 문서는 모델별 기본값 차이만 밝힙니다.
• 기본으로 실리는 모델의 범위는 판올림마다 바뀝니다. 지금 세션의 실제 목록을 확인하는 게 정확합니다.

✨ 정리하면

요즘 모델에서는 할 일 도구가 기본으로 빠져 있습니다 — 글로 안 적어도 알아서 챙기기 때문이에요. 목록을 화면에 그리고 싶다면 켜야 하는데, 문서는 내 앱이 실제로 읽어서 쓸 때만 켜라고 권합니다. 켠 뒤에는 번호가 만들 때 안 오고 결과 쪽에 실린다는 것과, 흘러오는 항목 이름이 보정 전 값이라 방어적으로 읽어야 한다는 것을 챙기세요. 비용을 재는 쪽은 비용 집계 정리, 배경 작업 알림과의 구분은 하위 에이전트 정리, 도구를 붙여 능력을 늘리는 이야기는 Serena MCP, 전체 비용 흐름은 AI 지출 관리 허브에 모아뒀습니다.

※ 출처: Claude 에이전트 개발 도구의 할 일 추적 공식 문서(2026년 8월 31일 열람). 모델별 기본값은 판올림마다 달라집니다.