Claude Code /tasks 명령어와 hooks 신뢰 경고 정리의 기준 버전은 **2.1.329(2026-11-19 릴리스)**다. 이 버전에서 /tasks는 예약 작업, /loop 웨이크업, goal, 대화 포크까지 보여 주고, 폴더 신뢰 대화상자는 그 폴더의 hooks가 어디에 선언됐는지 경고한다. 하위 호환에 영향을 주는 변경은 세 가지다. 이전 버전에서 저장한 예약 작업은 새 세션에서 다시 예약해야 할 수 있고, ‘Exit and stop tasks’로 나가면 예약 작업이 resume 때 돌지 않으며, Stop/SubagentStop hooks의 background_tasks에서 Monitor 표기가 shell에서 monitor로 바뀌었다.
이 글은 Claude Code 공식 changelog의 2.1.329 항목 원문과 Security·Commands 문서를 근거로 하며, 2026-11-22에 확인한 내용이다. 원문 문장은 영어 그대로 인용하고 의미를 함께 적는다.
목차
2.1.329에서 바뀐 /tasks와 hooks 변경 한눈에 보기
변경 사항은 /tasks 쪽과 hooks 쪽으로 나뉜다. 아래 표는 changelog의 Added·Changed 분류를 그대로 옮긴 것이다.
| 영역 | 분류 | changelog 원문 요지 | 영향 |
|---|---|---|---|
| /tasks | Added | 이 세션의 scheduled tasks, /loop wakeups, goal, 대화 forks 표시. x로 하나씩 중지 | 새 기능 |
| /tasks | Changed | 헤더와 footer의 background count를 숫자 하나로 통합 | 표시 변경 |
| 예약 작업 | Changed | 이전 버전이 저장한 예약 작업은 로그인한 새 세션에서 대부분 재예약 필요 | 하위 호환 |
| 예약 작업 | Changed | ‘Exit and stop tasks’가 이 세션의 예약 작업을 종료 | 하위 호환 |
| hooks | Added | 신뢰 대화상자에 폴더 hooks 선언 위치 경고 | 보안 |
| hooks | Changed | Stop/SubagentStop의 background_tasks에서 Monitor를 monitor로 표기 | 하위 호환 |
| hooks | Added | 비대화형 호스트에서 managed settings hooks 로드 실패 시 대화 안 경고 | 보안 |
2.1.328 이하에서 2.1.329로 올리는 경우 표의 ‘하위 호환’ 행 세 개가 동작 차이를 만든다. 나머지는 화면 표시나 경고가 추가된 변경이다.
/tasks 명령어에 새로 표시되는 항목

2.1.329의 Added 항목 원문은 다음과 같다.
“Added this session’s scheduled tasks,
/loopwakeups, the goal and this conversation’s forks to/tasks; x stops one after asking”
/tasks 목록에 들어오는 대상은 네 종류다. 현재 세션의 예약 작업, /loop가 걸어 둔 웨이크업, 세션의 goal, 그리고 이 대화에서 갈라져 나간 포크가 그것이다. 목록에서 항목을 고른 상태로 x를 누르면 Claude Code가 먼저 확인을 묻고, 승인하면 그 항목 하나만 멈춘다. 여러 항목을 한꺼번에 지우는 동작이 아니라 하나씩 중지하는 방식이다.
범위는 “this session”과 “this conversation”으로 한정돼 있다. 다른 세션에서 만든 예약 작업이나 다른 대화의 포크가 이 목록에 함께 나온다는 내용은 원문에 없으므로, 현재 세션 기준의 관리 화면으로 이해하는 편이 정확하다.
헤더와 하단 개수가 숫자 하나로 바뀐 점
같은 릴리스의 Changed 항목은 개수 표시를 다룬다.
“Changed the
/tasksheader and the footer’s background count to one number covering shells, monitors, MCP calls, agents, workflows and scheduled tasks”
/tasks 헤더와 화면 하단(footer)의 백그라운드 개수는 셸, 모니터, MCP 호출, 에이전트, 워크플로, 예약 작업을 모두 더한 값이다. 숫자가 예상보다 크게 보이면 셸 외에 MCP 호출이나 예약 작업이 함께 집계됐을 가능성부터 본다. 종류별 개수는 이 숫자만으로 구분되지 않으므로 /tasks 목록에서 항목을 직접 확인해야 한다.
응답 중에도 즉시 실행되는 명령
Claude Code 명령어 문서는 응답 중에 보낸 명령의 처리 방식을 이렇게 설명한다. “If you send a command while Claude is responding, Claude Code queues it and runs it after the current turn finishes.” 일반 명령은 현재 턴이 끝날 때까지 큐에서 기다린다.
예외로 문서는 /status, /tasks, /usage를 꼽는다. 이 명령들은 응답을 끊지 않고 바로 실행된다. 긴 작업이 진행되는 도중에 어떤 백그라운드 셸이나 예약 작업이 돌고 있는지 확인하려면 턴이 끝나기를 기다릴 필요 없이 /tasks를 입력하면 된다.
예약 작업 재예약과 ‘Exit and stop tasks’ 동작 변경

예약 작업에는 하위 호환에 영향을 주는 변경이 두 건 있다. 2.1.329로 올린 직후 “예약해 둔 작업이 안 돈다”거나 “종료했는데 다시 돈다”는 상황은 대부분 이 두 항목으로 설명된다.
이전 버전에서 저장한 예약 작업
"Changed saved scheduled tasks: in new signed-in sessions, most saved by earlier versions need scheduling again, though
--resumeof their own session still runs them"
조건은 두 갈래다.
- 로그인한 새 세션을 시작한 경우: 2.1.328 이하에서 저장한 예약 작업 대부분은 자동으로 이어지지 않으며 다시 예약해야 한다.
- 원래 세션을
--resume으로 이어 간 경우: 그 세션에 저장된 예약 작업은 그대로 실행된다.
원문은 “most”라고 적고 있다. 어떤 예약 작업이 예외로 남는지는 changelog에 구체적으로 나오지 않으므로, 새 세션에서 기존 예약 작업이 /tasks 목록에 보이는지 직접 확인하는 방식이 안전하다. 목록에 없으면 다시 예약하고, 원래 세션의 문맥이 필요한 작업이라면 그 세션을 --resume으로 여는 쪽을 택한다.
종료 방식에 따른 차이
"Changed ‘Exit and stop tasks’ to end this session’s scheduled tasks so they don’t run again on resume, unless you exit while Claude is responding"
‘Exit and stop tasks’를 선택해 세션을 나가면 그 세션의 예약 작업이 끝난다. 나중에 같은 세션을 resume해도 예약 작업은 다시 실행되지 않는다.
단서가 하나 붙어 있다. Claude가 응답하는 중에 이 방식으로 나가면 위 동작이 적용되지 않는다. 예약 작업을 확실히 정리하려면 응답이 끝난 뒤 종료하거나, 종료 전에 /tasks에서 x로 항목을 하나씩 중지해 두면 된다.
두 예약 작업 변경은 모두 2.1.329의 Changed 항목이다. 2.1.328 이하 동작과 비교하는 세부 설명은 changelog에 없으므로, 이전 동작은 각자 환경의 기록으로 확인해야 한다.
hooks 쪽의 핵심 변경은 한 줄이다.
"Added a trust dialog warning that says where a folder’s hooks are declared"
신뢰 대화상자(workspace trust dialog)는 Claude Code 보안 문서의 Trust verification 항목에서 다룬다. 원문은 “In an interactive session, Claude Code shows the workspace trust dialog when you start it in a folder you haven’t trusted.”다. 대화형 세션에서 아직 신뢰하지 않은 폴더로 시작할 때 이 대화상자가 뜬다.
신뢰 대화상자가 알려주는 hooks 선언 위치
2.1.329부터는 이 대화상자가 해당 폴더의 hooks가 어디에 선언돼 있는지 함께 알려 준다. hooks는 특정 이벤트에 맞춰 스크립트를 실행하는 기능이므로, 폴더를 신뢰하기 전에 어떤 설정 위치에서 hooks가 들어오는지 보는 것이 이번 경고의 용도다. hooks 이벤트와 설정 구조는 Hooks 레퍼런스 문서에 정리돼 있다.
경고의 실제 문구나 화면 예시는 changelog에 실려 있지 않다. 표시 형태는 2.1.329 이상에서 신뢰하지 않은 폴더를 열어 직접 확인해야 한다.
외부에서 받은 저장소를 신뢰하면 그 폴더에 선언된 hooks도 함께 받아들이는 셈이다. 대화상자의 경고가 가리키는 선언 위치를 열어 어떤 명령이 등록돼 있는지 읽은 뒤 신뢰 여부를 정한다. 출처를 모르는 hooks가 보이면 신뢰하지 않고 대화상자를 닫는다.
신뢰 경고 외에도 2.1.329에는 hooks 동작에 닿는 항목이 두 개 있다. 하나는 기존 스크립트를 깨뜨릴 수 있는 표기 변경이고, 다른 하나는 비대화형 환경용 경고다.
Stop/SubagentStop hooks의 background_tasks 표기
"Changed Stop and SubagentStop hooks to list a Monitor’s script as
monitor, notshell, inbackground_tasks"
Stop과 SubagentStop hooks는 입력으로 background_tasks를 받는다. 이 목록에서 Monitor 스크립트의 종류 값이 2.1.329부터 shell이 아니라 monitor다.
영향을 받는 경우는 명확하다. hook 스크립트가 종류 값이 shell인 항목을 골라 처리하면서 Monitor도 거기에 포함된다고 가정했다면, 업그레이드 뒤에는 Monitor 항목이 그 분기에서 빠진다. 스크립트의 판별 조건에 monitor 값을 추가하고, 셸과 Monitor를 구분해 처리할지 같은 분기로 묶을지 다시 정한다. 반대로 shell 개수를 세어 경고를 내던 hook이라면 집계 값이 줄어드는 쪽으로 달라진다.
비대화형 호스트의 managed settings hooks 경고
"Added a warning in the conversation, in Claude Desktop and other non-interactive hosts, when hooks in managed settings fail to load"
Claude Desktop을 비롯한 비대화형 호스트에서 managed settings에 정의된 hooks가 로드되지 않으면, 2.1.329부터 대화 안에 경고가 표시된다. 신뢰 대화상자처럼 별도 창으로 묻는 방식이 아니라 대화 흐름 속에 경고가 나타난다는 점이 다르다.
managed settings는 조직이 배포하는 설정이므로, 여기 정의된 hooks가 로드되지 않으면 그 정책 hook은 실행되지 않은 상태다. 대화 안에 이 경고가 보이면 해당 hook이 동작한다고 가정하지 말고 managed settings의 hooks 정의를 관리자 쪽에서 점검한다.
신뢰 대화상자는 조건이 맞을 때만 표시된다. 보안 문서는 -p 세션에 대해 “A -p session shows neither prompt.”라고 적고 있다. hooks 선언 위치 경고는 신뢰 대화상자에 추가된 항목이므로, 대화상자 자체가 뜨지 않는 -p 실행에서는 이 경고로 폴더 hooks를 확인할 수 없다. 스크립트나 CI에서 -p로 Claude Code를 돌리는 경우, 대상 폴더의 hooks는 실행 전에 별도로 검토해야 한다.
홈 디렉터리에서 바로 시작하는 경우도 다르다. 보안 문서에 따르면 이때 “trust acceptance is held for the current session only and is not written to disk”다. 신뢰 응답이 디스크에 기록되지 않아 실행할 때마다 프롬프트가 다시 뜨고, 이를 유지하는 설정은 없다. 매번 대화상자를 보게 되는 것이 정상 동작이다.
비대화형 호스트와 확인되지 않은 범위
비대화형 호스트에서는 경고 경로가 신뢰 대화상자가 아니다. managed settings hooks의 로드 실패는 앞 절처럼 대화 안 경고로 따로 표시된다. 그리고 ‘Exit and stop tasks’의 예약 작업 종료는 Claude가 응답하는 중에 나간 경우 적용되지 않는다는 예외가 원문에 명시돼 있다.
조사 시점 기준으로 확인하지 못한 부분도 있다. Commands 문서의 /tasks 행 설명과 interactive-mode 문서의 백그라운드 작업 키 조작은 이 글의 근거 범위에 들어 있지 않다. x 외의 키 조작이나 목록 정렬 방식은 공식 문서에서 따로 확인해야 한다.
2.1.329 업그레이드 뒤 점검 순서와 정리
Claude Code 2.1.329의 변화는 두 축으로 요약된다. /tasks는 현재 세션의 예약 작업·/loop 웨이크업·goal·포크를 한 화면에 모으고 백그라운드 개수를 숫자 하나로 합쳤으며, 응답 중에도 즉시 실행된다. hooks 쪽은 신뢰 대화상자가 선언 위치를 알려 주고, 비대화형 호스트가 managed settings hooks 로드 실패를 대화 안에서 경고하도록 바뀌었다. 하위 호환에 영향을 주는 지점은 예약 작업 재예약, ‘Exit and stop tasks’ 종료 동작, background_tasks의 monitor 표기다.
업그레이드 직후에는 다음 순서로 확인하면 빠짐이 적다.
- 새 세션에서
/tasks를 열어 기존 예약 작업이 남아 있는지 본다. 없으면 다시 예약하거나 원래 세션을--resume으로 연다. - 세션을 끝낼 때 ‘Exit and stop tasks’를 쓰는 습관이 있다면, 이후 resume에서 예약 작업이 돌지 않는다는 점을 전제로 운영한다. 응답 도중 종료는 예외로 남는다.
- Stop/SubagentStop hook 스크립트에서
background_tasks의 종류 값을shell로만 판별하는 분기를 찾아monitor를 반영한다. - 새 저장소를 열 때 신뢰 대화상자의 hooks 선언 위치를 읽고 나서 신뢰한다.
-p실행 경로는 대화상자가 없으므로 별도로 검토한다. - Claude Desktop 같은 비대화형 호스트를 쓰는 조직이라면 managed settings hooks 경고가 대화에 나타나는지 확인한다.
이 변경과 이어지는 주제로는 Stop·SubagentStop 등 hooks 이벤트별 입력 구조를 정리한 Claude Code hooks 보안 설정, /loop 예약 작업을 세션 단위로 운영하는 방법, 그리고 managed settings로 조직 단위 hooks 정책을 배포하는 구성이 있다. 세 주제 모두 Claude Code changelog의 후속 버전에서 동작이 다시 바뀔 수 있으므로, 업그레이드 때마다 해당 버전의 Changed 항목을 이 점검 목록과 대조하는 방식이 유지 비용이 낮다.
관련 글
- Claude Code settings.json 전체 옵션 50개 완전 정복 — 권한·샌드박스·hooks 가이드 – Claude Code settings.json 전체 옵션 가이드. 5단계 우선순위 체계, permissions allow/deny 규칙, …
- Claude Code 아티팩트 사용법: 게시·재게시 전 보안 점검 체크리스트 – Claude Code 아티팩트는 세션 결과를 claude.ai 페이지로 게시하는 기능이다. v2.1.275~v2.1.284 릴리스 노트에서…
- Claude Code 모노레포 토큰 최적화 — LSP 컨텍스트 폭발 방지 실전 설정법 – 모노레포에서 Claude Code 세션당 토큰 소비가 급증하는 원인과 해결법을 다룬다. CLAUDE.md 계층 설계, 경로 범위 규칙, L…