[Claude Code 스킬] 할 일 목록(Tasks) — Claude의 계획을 실시간 체크리스트로 확인하기 | DAKER 커뮤니티

무엇

Claude Code는 3단계가 넘는 복잡한 작업을 받으면, 실행에 앞서 스스로 작업을 잘게 쪼개 터미널에 할 일 목록(체크리스트)으로 띄웁니다. 항공기 조종사가 이륙 전에 체크리스트를 소리 내어 읽는 것과 같은 원리입니다 — 계획을 눈에 보이게 만들어, 빠뜨림과 오해를 실행 전에 걸러냅니다. 각 항목은 pending(대기) → in_progress(진행 중) → completed(완료)의 세 상태를 거치며 실시간으로 갱신됩니다.

v2.1.142부터는 내부 구현이 바뀌었습니다. 목록 전체를 통째로 다시 쓰던 단일 TodoWrite 도구 대신, TaskCreate·TaskUpdate·TaskList·TaskGet 4개 도구가 항목을 하나씩 만들고 고칩니다. 덕분에 작업 간 의존성(addBlockedBy: "1번이 끝나야 2번 시작")과 담당자(owner) 개념이 생겨, 단순 메모장이 프로젝트 관리 보드에 가까워졌습니다.

언제 쓰나

목록은 대체로 자동으로 생깁니다. 3개 이상의 뚜렷한 단계가 필요한 작업, 여러 요청을 한 문장에 나열했을 때, 계획 없이 덤비면 빠뜨릴 게 있는 비자명한 작업이 트리거입니다. 반대로 한 번에 끝나는 단일 수정이나 순수 질문에는 생략됩니다. 가장 값진 순간은 첫 목록이 뜨는 순간입니다 — Claude가 내 요청을 어떻게 이해했는지가 항목으로 복명복창되므로, 코드가 한 줄도 바뀌기 전에 오해를 발견할 수 있습니다.

사용법

# 여러 항목을 한 번에 주면 목록이 자동 생성된다
> 다크모드 추가하고, 캐시 버그 고치고, README도 갱신해줘

# 명시적으로 요청할 수도 있다
> 이 리팩토링을 todo로 관리하면서 진행해줘

# 표시 토글 (터미널)
Ctrl+T          # 할 일 목록 접기/펴기

# 단축키가 충돌하면 재바인딩 (~/.claude/keybindings.json)
{ "keybindings": { "app:toggleTodos": "ctrl+shift+t" } }

# SDK 등에서 구형 TodoWrite 방식으로 되돌리기
CLAUDE_CODE_ENABLE_TASKS=0

팁

1) 목록이 뜨자마자 항목을 훑어보세요. 엉뚱한 항목이 보이면 Esc로 즉시 끊고 바로잡는 것이 코드 수정 후 되돌리는 것보다 훨씬 쌉니다(지난 '끼어들기' 글과 이어지는 습관입니다). 2) completed는 '실제로 끝났을 때만' 찍히도록 설계되어 있습니다 — 테스트가 실패하면 항목이 in_progress로 남으니, 목록이 안 닫히고 멈춰 있다면 무언가 막혀 있다는 신호로 읽으면 됩니다.

출처

공식 문서: Todo Lists / Task 도구 마이그레이션
공식 문서: 키보드 단축키 커스터마이징
Claude Code 치트시트 (지원 센터)