Human in the loop: 나만 할 수 있는 작업을 놓치지 않게 하는 Claude Code 휴먼 인 더 루프 모드

Human in the loop은 Tzafrir Rehan(tzafrir)이 만든 커뮤니티 모드로, Claude Code 휴먼 인 더 루프를 구현합니다. 다루는 상황은 Claude가 당신만 할 수 있는 일, 예를 들어 .env에 키 넣기, 스테이징 승인, 당신 컴퓨터에서 명령 실행, 결정 같은 것을 필요로 할 때입니다. 보통은 답변 중간에 한마디 하고 지나가며, 그 요청은 곧 스크롤 위로 사라집니다. 이 모드가 있으면 Claude는 요청을 작업으로 배정합니다.

모드는 assign_task, list_tasks, withdraw_task 세 도구를 등록하고, 당신만 할 수 있는 일(작업 결과 검토 포함)에는 assign_task를 쓰라고 시스템 프롬프트에 몇 줄을 더합니다. 작업에는 제목, 한 문장 이유, 선택 사항인 "완료 조건", 종류가 있습니다. 종류는 do(직접 하고 완료 표시), answer(Claude가 당신의 말을 필요로 함), choose(2~4개 선택지 중 하나 고르기)입니다. 열린 작업은 My tasks 창에서 기다리고, 프롬프트 아래 상태 줄에 ☐ 1 task for you · /my-tasks처럼 개수가 표시됩니다. 완료, 선택지, 답변, 이유를 단 거절로 응답할 수 있습니다.

작업은 Claude를 멈추지 않습니다. Claude는 다른 일을 계속하고, 응답은 당신이 보낼 때 메시지로 도착합니다. 코드상 한도는 열린 작업 최대 5개, 같은 요청은 하나로 처리, 작업 배정은 메인 에이전트만 가능하다는 것입니다.

녹화에서는 작은 데모 프로젝트에서 모드를 불러온 Claude Code를 시작하고, assign_task로 .env에 STRIPE_KEY를 넣는 작업을 하나 배정해 달라고 Claude에게 요청합니다. Claude가 도구를 호출하면 대화 기록에 노란색 ☐ Assigned you a task: Put your STRIPE_KEY in the .env file 줄이 나타나고, 이어서 작업이 #1이며 열린 작업이 5개 중 1개라는 도구 결과가 나옵니다. 프롬프트 아래 상태 줄에는 ☐ 1 task for you · /my-tasks가 표시되고, 푸터 오른쪽에는 토스트 human-in-the-loop: Claude assigned you a task: Put your STRIPE_KEY in the .env file. See /my-tasks가 나타납니다. 폭이 좁은 이 녹화에서는 창이 저절로 열리지 않았고(토스트가 그 때문에 있습니다), 창이나 작업에 답하는 장면은 영상에 없습니다.

설치 블록의 어떤 방법을 써도 작성자 본인의 마켓플레이스에서 바로 설치됩니다. 설치 후에는 새 세션을 시작하거나 /reload-plugins를 실행하세요. /my-tasks로 창을 엽니다.

훅 모듈은 hooks/register.tsx 하나입니다. assign_task 핸들러는 인자를 검사하고, 중복과 여섯 번째 열린 작업을 거부하며, 작업을 저장하고 창을 엽니다. hooks/register.tsx에서:

on('tool.call', { tool: ASSIGN }, async ($, e) => {
  if (e.agentId !== undefined) {
    return { deny: 'Only the main agent assigns tasks to the user. Say what you need from the user in your result instead.' }
  }
  const ask = parseAsk(e as unknown as Record<string, unknown>)
  if ('error' in ask) {
    return { deny: ask.error }
  }
  // ...
  return { result: assignedOf(task, active.length + 1) }
})

작업은 $.state와, 프로젝트 폴더 아래 세션마다 하나씩 있는 $.store 키에 저장됩니다. 60초 간격 하트비트로 기록되어, 끝났거나 응답이 없는 세션의 작업을 다음 세션이 이어받을 수 있습니다. 응답은 Claude가 쉬고 있으면 $.prompt.submit으로, 일하는 중이면 $.session.append로 한 줄 추가되어 전달됩니다. prompt.compose 훅이 안내 문구를 더하고, prompt.context 훅이 대화 시작과 압축 뒤에 열린 작업을 나열합니다.

옵션은 없습니다. 창의 버튼과 키로 조작합니다. d는 완료, 1~4는 선택지, r은 답변, x는 거절이며, 전송 시점은 Save for later와 Send now로 정합니다. 긴 답변은 자신의 프롬프트 입력창을 거치며, Long answer…가 ↳ Answer to #3:로 시작하게 해 줍니다. 한도를 바꾸려면 MAX_OPEN과 MAX_TITLE은 hooks/tasks.ts에, BATCH_MS는 hooks/register.tsx에 있습니다.

아무것도 실행하기 전에 플러그인이 불러오는 모든 파일을 읽었습니다. .claude-plugin/plugin.json, hooks/hooks.json, hooks/register.tsx, pane.ts, project.ts, tasks.ts, text.ts, 타입 선언, 테스트입니다. package.json, 설치 스크립트, 번들되거나 minify된 코드는 없고, PNG와 GIF 이미지 외의 바이너리도 없습니다. LICENSE 파일(MIT)이 있습니다.

• 네트워크, 프로세스, 파일, 환경 변수: 모두 없음. 훅에서 fetch, child_process, $.process, $.http, eval, 동적 import()를 찾지 못했습니다. 저장소는 $.store와 $.state뿐이며 데이터 모델은 docs/privacy.md에 설명되어 있습니다. 텔레메트리는 없고, 작성자의 개인정보 처리방침은 어떤 것도 컴퓨터 밖으로 나가지 않는다고 밝힙니다.
• 데몬: 없음. $.clock.every 하트비트는 세션이 실행되는 동안에만 돕니다.
• 모델에 미치는 영향: 눈여겨볼 부분입니다. 모드는 도구 3개, 시스템 프롬프트 끝의 3줄(STEERING), 열린 작업을 나열하는 humanInTheLoop 컨텍스트 블록, 다음 프롬프트에 붙는 작업 업데이트 요약을 추가합니다. 또한 세 도구를 지연 로딩하지 않고 항상 보이게 합니다. 문구는 평범하고 README와 일치하며, 코드와 매니페스트에서 숨은 문자나 제로 폭 문자는 찾지 못했습니다(이모지 테스트 문자열에만 있음).
• 게이팅 훅: tool.call 훅은 모드 자신의 세 도구에만 응답합니다. prompt.submit은 프롬프트를 읽어 긴 답변(↳ Answer to #N:)을 인식하고 아직 보내지 않은 응답을 붙입니다. 비밀 값처럼 보이는 답변은 전송되지 않고 알림이 표시됩니다. 다른 모든 도구 호출은 그대로 통과합니다. validate는 이 훅들에 .catch가 없다고 알려 줍니다.
• 제출하는 프롬프트: 당신의 말로 쓰인 작업 응답과 고정된 한 줄 I answered a task while you were finishing your reply; my answer is above.뿐입니다.
• 요구 사항: Claude Code에서 function hooks가 켜져 있어야 합니다(README는 얼리 액세스라고 설명). 외부 바이너리나 계정은 필요 없습니다.

claude plugin validate는 오류와 경고 없이 통과했고, 작성자의 테스트도 Claude Code 2.1.310에서 모두 통과했습니다(192개 통과, 0개 실패).

macOS의 Claude Code 2.1.310에서 확인했습니다(validate, 테스트, 녹화). 아무 일도 일어나지 않는다면:

• function hooks가 켜져 있고 /plugin에서 플러그인이 불러와져 있는지 확인하세요.
• 설치 후 새 세션을 시작했거나 /reload-plugins를 실행했는지 확인하세요.
• Claude는 시스템 프롬프트에 안내 문구가 있을 때만 작업을 배정하며, -p(print) 또는 bare 모드에서는 추가되지 않습니다.
• 좁은 터미널에서는 창이 저절로 열리지 않습니다. /my-tasks를 실행한 뒤 클릭하거나 ctrl+x tab으로 키를 사용하세요.
• 모바일 앱에는 답변 입력란이 없어 완료, 선택지, 즉시 거절만 쓸 수 있습니다.