Claude Code v2.1.292: 플러그인 설치와 서브에이전트 effort 지정

10월 07, 2026

글: MinoSui

v2.1.292는 플러그인 설치 절차와 서브에이전트 실행 옵션을 손보고, MCP 연결과 `claude -p` 시작 속도를 개선한 릴리스입니다. 모드 개발자를 위한 훅과 프롬프트 캐싱 항목도 함께 들어갔습니다.

핵심 요약

claude plugin install에 --marketplace <source> 옵션이 생겨 마켓플레이스 추가와 설치를 한 번에 처리합니다.
Agent 도구에 effort 파라미터가 추가되어 서브에이전트별로 effort 수준을 지정할 수 있습니다.
로컬(stdio) MCP 서버는 기본적으로 프로토콜 버전 2026-07-28을 협상하며, MCP_PROTOCOL_NEGOTIATION=legacy로 되돌릴 수 있습니다.
claude -p와 SDK 세션은 첫 턴이 HTTP·SSE MCP 서버의 resources/list 응답을 기다리지 않습니다.
529 과부하 재시도의 기본 대기 시간을 CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS로 늘릴 수 있습니다.

릴리스 노트 전체
새로 쓸 수 있게 된 기능
업데이트 효과 직접 재보기
업데이트하고 버전 확인하기

릴리스 노트 전체

공식 릴리스 노트의 92개 항목을 원문 순서대로 한 줄씩 옮겼습니다. 더하거나 뺀 항목은 없습니다.

`claude plugin install`에 `--marketplace <source>`를 추가했습니다. 필요하면 `claude plugin marketplace add`와 같은 정책 검사를 거쳐 마켓플레이스를 추가한 뒤, 그곳에서 플러그인을 설치합니다
Agent 도구에 `effort` 매개변수를 추가했습니다. 이제 Claude가 요청한 effort 수준으로 서브에이전트를 실행합니다
과부하(529) 요청을 재시도할 때 백오프의 기본 지연 시간을 더 길게 설정할 수 있는 `CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS` 환경 변수를 추가했습니다
모드가 프롬프트 입력창의 자동 완성 목록에 자체 행을 추가하도록 연결할 수 있는 이벤트인 `prompt.autocomplete`를 추가했습니다
모드용 `$.model.complete`에 프롬프트 캐싱을 추가했습니다. `prompt`와 `system`은 텍스트 블록을 받으며, 블록에 `cache: true`를 지정하면 그 블록까지의 요청을 캐시합니다
`agent.spawn` 모드 훅에 워크플로 에이전트를 실행 및 인덱스 정보와 함께 추가하여, 모드가 이를 거부할 수 있습니다
자동 모드를 사용할 수 없을 때(설정으로 비활성화됨, 서킷 브레이커 작동, 모델이 지원하지 않음) `permissionMode: auto`가 지정된 서브에이전트 정의가 자동 모드에 진입하던 문제를 고쳤습니다
샌드박스된 명령이 `~/.claude/seed-admin` 아래에 있는 `/ultrareview` 업로드의 임시 파일 사본을 읽을 수 있던 문제를 고쳤습니다
세션 도중 관리형 샌드박스의 읽기 거부 경로(및 그 옆의 사용자 지정 경로)가 나타나거나 다른 곳을 가리키게 되었을 때, 그 안의 프로젝트 권한 부여를 해제하지 않고 해당 경로가 포함하는 파일의 자격 증명 주입도 끝내지 않던 문제를 고쳤습니다
macOS와 Windows에서 읽는 도중 링크를 바꿔치기하면 노트북 또는 PDF 읽기가 승인된 범위 밖의 파일을 반환할 수 있던 문제를 고쳤습니다
서버 관리형 설정의 디스크 캐시가 변조되었을 때, 설정 가져오기가 실패하는 동안 기본 제공 정책 플러그인을 끄거나 밀어낼 수 있던 문제를 고쳤습니다
홈 폴더나 드라이브의 8.3 단축 이름 또는 그 밖의 Windows 대체 표기에 대한 `rm -rf`가 해당 폴더를 삭제하는 것으로 취급되지 않던 문제를 고쳤습니다
Security: PreToolUse 훅 승인과 자동 모드가 네트워크(UNC) 경로의 파일 읽기에 대한 권한 확인 프롬프트를 건너뛰던 문제를 고쳤습니다
한 턴 도중에 자동 모드 또는 계획 모드를 벗어나면, 스킬이나 슬래시 명령의 `allowed-tools` 규칙이 이후 턴에 다시 적용되던 문제를 고쳤습니다
`HTTPS_PROXY`가 설정되어 있을 때 Claude Code 자체 API 요청(로그인, 정책, 피드백, 아티팩트)에서 `NO_PROXY`가 무시되던 문제를 고쳤습니다
이름이 128자보다 긴 MCP 도구 때문에 모든 요청이 실패하던 문제를 고쳤습니다. 이제 해당 도구는 제외되며 MCP 오류가 그 도구의 이름을 알려 줍니다
첫 실행 시 조직의 관리형 설정이 로드되기 전에 `marketplace add`, `install` 같은 `claude plugin` 명령이 실행되던 문제를 고쳤습니다
일회성 `claude -p` 및 Agent SDK 실행이 최종 결과 5초 뒤에 백그라운드 명령을 중지하던 문제와, 일회성 `claude -p` 실행이 예약된 깨우기를 버리던 문제를 고쳤습니다. 이제 둘 다 끝날 때까지 기다립니다
`claude --resume` 세션 선택기나 `/resume`으로 세션을 재개할 때 계획 모드가 복원되지 않던 문제를 고쳤습니다
`/resume`, `/branch`, `/clear` 이후에 만든 저장된 예약 작업이 실행되지 않던 문제와, 작업 파일에 몇 밀리초 간격으로 두 번 기록하면 저장된 작업이 이후의 생성과 삭제를 무시하던 문제를 고쳤습니다
백그라운드 세션의 프로세스가 (예: 충돌 후) 다시 시작될 때 대기 중이던 깨우기가 사라져 `/loop`가 조용히 멈추던 문제를 고쳤습니다
Grep과 Glob이 지정된 파일이나 폴더를 읽을 수 없을 때 일치 항목이 없다고 보고하던 문제를 고쳤습니다. 이제 Claude가 한 번 다시 시도하거나 사용자에게 알려 줍니다
PDF의 `pages`가 "6,9,15" 같은 목록일 때 Read 도구가 오류 없이 첫 항목만 반환하던 문제를 고쳤습니다. 이제 각 페이지나 범위를 따로 읽으라는 오류를 반환합니다
256KB를 넘는 @ 멘션 텍스트 파일이 조용히 누락되던 문제를 고쳤습니다. 이제 Claude에게 파일 크기와 나누어 읽으라는 안내가 전달됩니다
이미 메인 대화를 멈춘 사용량 한도 때문에 에이전트들이 실패했을 때, 사용량 한도 알림이 백그라운드 에이전트마다 한 번씩 반복되던 문제를 고쳤습니다
데스크톱 앱이나 IDE가 호스팅하는 세션에서 원격 제어 뷰어가 백그라운드 서브에이전트의 빈 서브에이전트 창을 보던 문제를 고쳤습니다
이름이 비슷한 두 세션이 세션 간 전달 알림에서 하나의 수신자로 표시되던 문제와, 터미널 세션에서 메시지가 만료되었는데도 만료 알림이 데스크톱 앱을 원인으로 지목하던 문제를 고쳤습니다
이미 다른 메시지가 대기열에 있을 때 데스크톱 앱에서 지금 보내기를 누르면 턴이 기다리던 서브에이전트가 종료되던 문제를 고쳤습니다
`/bug`, `/share`, `/feedback <text>`가 보고서를 보내는 중 Ctrl+O 또는 Ctrl+Z를 누르면 처음부터 다시 시작되던 문제와, 전송이 끝난 뒤 취소된 것으로 닫히던 문제를 고쳤습니다
Enter를 바로 누르면 `/remote-env`가 저장된 기본 환경을 바꿔 버리던 문제를 고쳤습니다. 이제 목록이 기본 환경에서 열리며, 적용 중인 기본값이 없으면 어떤 행에도 체크 표시가 없습니다
한 프롬프트에서 여러 붙여넣기가 겹칠 때 일부 붙여넣은 텍스트가 직접 입력한 텍스트로 Claude에 전달되던 문제를 고쳤습니다
vim 모드에서 커서가 줄 끝을 넘어가던 문제, j/k가 더 짧은 줄에서 열 위치를 잃던 문제, `f`/`t`/`F`/`T`/`;`/`,`가 프롬프트의 다른 줄에 있는 일치 항목으로 이동하거나 그곳까지 삭제하던 문제를 고쳤습니다
`/add-dir` 경로 입력란에서 Shift+Enter나 붙여넣기로 줄바꿈이 추가되던 문제와, 빠르게 입력한 "tab", "up", "down"을 해당 키로 처리하던 문제를 고쳤습니다
프롬프트 푸터 행이 선택된 동안 빠른 입력, 입력기 텍스트, 분해된 악센트 문자가 누락되던 문제와, `!`를 입력해도 행이 선택된 채로 남던 문제를 고쳤습니다
iTerm2가 감지되면 전체 화면 모드가 창 크기를 조절할 때마다, 그리고 Ctrl+L을 누를 때마다 전체 화면 지우기를 보내던 문제를 고쳤습니다. 이것이 iTerm2 스크롤백을 오래된 페이지로 채운 원인일 수 있습니다
Read 거부 규칙이 설정되어 있고 작업 디렉터리가 심볼릭 링크 아래에 있을 때, 파일 이름이 아닌 @ 단어에 대해 "could not be examined" 메모가 잘못 표시되던 문제를 고쳤습니다
`/cd`나 권한 변경 후 "instruction file not loaded" 줄이 오래된 상태로 남거나 누락되던 문제를 고쳤고, 중첩된 지침 파일이 로드되지 않을 때 대화 기록에 줄을 추가했습니다
`/name`을 반복한 압축 요약 때문에 Claude가 사용자 전용으로 예약된 스킬을 호출할 수 있던 문제를 고쳤습니다
Write, Edit, NotebookEdit, LSP 행과 단일 Read, Grep, Glob 행에서 모드가 호출을 거부한 이유가 숨겨지던 문제를 고쳤습니다. 이제 행에 이유가 표시됩니다
턴이 끝나는 바로 그 순간 워커가 중지되면 클라우드 세션에 끝나지 않은 턴이 표시되던 문제를 고쳤습니다
대용량 대화 기록이 있는 클라우드 세션에서 승인된 권한을 다시 요청하는 경우가 있던 문제를 고쳤습니다
Claude가 읽는 도중 메시지를 재시도하거나 수정하면 클라우드 세션에서 예약 작업과 그 밖의 대기 중인 알림이 사라지던 문제를 고쳤습니다
세션의 컨테이너가 다시 시작되면 클라우드 세션이 클라이언트에서 선택한 사고 설정을 잊어버리던 문제를 고쳤습니다
Anthropic이 조직의 설정을 확인할 수 없을 때 Cowork 클라우드 세션이 프록시가 아티팩트를 차단했다고 안내하던 문제를 고쳤습니다
훅 모듈이 하나의 const를 통해 `$.state`를 여러 번 호출하는 플러그인이 로드되거나 검증되는 데 몇 분씩 걸리던 문제를 고쳤습니다
`claude plugin validate`가 엔진이 다른 곳에서 읽는 훅 모듈의 matcher 또는 state 값을 나열하던 문제를 고쳤습니다
`claude plugin validate`가 다시 선언되거나 재할당된 최상위 `var`를 통해 읽는 `$.state` 값을 나열하던 문제를 고쳤습니다. 이제 이런 모듈은 거부됩니다
플러그인이 제공하는 `$` 메서드가 훅 오리진을 다시 시작시켜, 위에 `.catch`가 있는 가드 훅이 끝없이 다시 실행될 수 있던 문제를 고쳤습니다
플러그인 훅 워커가 다시 시작되는 동안 이루어진 플러그인 인터페이스 호출이 다른 플러그인이 거는 훅 없이 실행되던 문제를 고쳤습니다
`next(e)`를 호출한 뒤 거부하는 모드의 `config.set`, `state.set`, `env.set`, `agent.spawn` 훅이 거부 응답으로 처리되던 문제를 고쳤습니다. 이제 해당 훅이 이름과 함께 실패한 것으로 보고됩니다
`/theme`, `/config`의 Theme 메뉴, 첫 실행 테마 단계가 플러그인의 `config.set` 훅에 묻기 전에 테마를 저장하던 문제를 고쳤습니다
플러그인의 `tool.check` 훅이 허용으로 응답하면 사용자의 답이 필요한 도구(질문, 계획 승인)가 대화상자를 표시하지 않고 실행되던 문제를 고쳤습니다
훅 워커가 교체될 때 모드의 시작 프롬프트, 명령, 서브에이전트가 두 번째로 대기열에 들어가던 문제를 고쳤습니다
`next(e)`를 호출한 뒤 턴이 중단된 동안 실패한 모드의 훅이 호출을 통과시키던 문제를 고쳤습니다. 이제 해당 호출은 거부됩니다
플러그인의 프롬프트 삭제나 설정 거부의 사유가 4,096자보다 길면 무시되던 문제를 고쳤습니다
사용자가 설치한 모드가 추가한 `$` 이름을 조직의 플러그인이 반환할 때, 조직의 플러그인이 자체 리로드 시 또는 다른 플러그인이 충돌한 뒤에 언로드되던 문제를 고쳤습니다. 이제 대신 해당 모드가 언로드됩니다
플러그인 훅 워커가 다시 시작되는 동안 이루어진 도구 호출이 플러그인의 권한 훅 없이 응답되던 문제를 고쳤습니다
잘못 지정된 매개변수가 수정되기 전에 플러그인 `tool.call` 훅이 일부 도구 호출을 보던 문제를 고쳤습니다. 이제 훅은 도구가 실제로 실행될 인수를 봅니다
다른 모드의 훅이 가드 자체의 `$` 호출 아래에서 하는 호출에 대해, `.catch`가 있는 모드의 가드 훅이 조용히 건너뛰어지던 문제를 고쳤습니다. 이제 해당 `.catch`에 묻습니다
`claude -p` 및 SDK 세션의 시작을 개선했습니다. 이제 첫 턴이 HTTP 및 SSE MCP 서버가 `resources/list`에 응답하기를 기다리지 않습니다
길게 이어지는 글머리 기호 또는 번호 목록 응답의 렌더링 속도를 개선했습니다. 스트리밍, 크기 조절, 대화 기록(ctrl+o)에서 다시 열 때 훨씬 빨라졌습니다
Ctrl+C 초안 복구를 개선했습니다. 슬래시 명령어나 메시지를 보낸 뒤에도 비워진 프롬프트를 위쪽 화살표(Up)로 다시 불러올 수 있습니다
훅 출력 처리를 개선했습니다. 훅 출력에 쓰인 `<system-reminder>` 태그는 Claude에 전달되기 전에 이스케이프됩니다
도구 입력 처리를 개선했습니다. Grep은 `path` 대신 `file_path`를 받으며, Write, WebFetch, Read는 불필요한 매개변수 몇 개가 있어도 호출이 실패하지 않고 무시합니다
설정 파일에 선언된 마켓플레이스의 이름이 공식 Anthropic 마켓플레이스처럼 보일 때 표시되는 단계를 개선했습니다
샌드박스 자동 허용을 개선했습니다. 사용자, 관리형 또는 --settings 설정에서 엄격한 샌드박스 모드를 설정하면 `FOO=bar python3 app.py`처럼 환경 변수 접두사가 붙은 인터프리터 명령도 확인 없이 실행됩니다
Artifact 도구의 목록 기능을 개선했습니다. 이제 Claude가 게시된 아티팩트의 개수를 확인할 수 있으며, 한 번에 50개 대신 최대 200개까지 나열할 수 있습니다
재시작 후의 클라우드 세션을 개선했습니다. 이제 Claude가 id로 다시 시작할 수 있는 중지된 백그라운드 에이전트를 안내받습니다
claude.ai 클라우드 세션에서 브라우저에 연결할 수 없을 때 표시되는 Claude in Chrome 메시지를 개선했습니다. 사용자가 원하면 Claude가 대안으로 계속 진행할 수 있다는 안내를 받습니다
/focus 팁을 개선했습니다. 이제 턴 진행 중에 포커스 보기를 사용해 보도록 안내하고 다시 전환하는 방법을 보여 줍니다
새 프로토콜 확인을 무시하는 로컬(stdio) MCP 서버의 시작 과정을 개선했습니다. 연결이 한 번 느리게 이루어진 뒤에는 7일 동안 기억해 두었다가 기다림 없이 이전 방식으로 연결합니다
로컬(stdio) MCP 서버 연결이 Bedrock, Vertex, Foundry를 포함한 모든 설치 환경에서 기본적으로 프로토콜 버전 2026-07-28을 협상하도록 변경했습니다. `MCP_PROTOCOL_NEGOTIATION=legacy`로 이를 끌 수 있습니다
`claude plugin test`를 변경했습니다. 테스트가 등록한 훅 안에서 `expect`가 실패하거나 엔진이 거부하는 스텁 응답이 있으면, 이제 조용히 통과하지 않고 테스트가 실패합니다
사용량 한도 메시지에서 claude.ai 설정 링크를 https://로 시작하게 써서 터미널과 앱에서 클릭할 수 있도록 변경했습니다
예약 실행 및 Run now 루틴 실행이 승인을 요청하지 않고 본인만 볼 수 있는 새 아티팩트를 게시하도록 변경했습니다. 커넥터나 다른 접근 권한을 요청하는 아티팩트는 계속 승인을 요청합니다
에이전트 이름을 최대 256자까지만 허용하도록 변경했습니다. 더 긴 이름은 거부되며, 그보다 긴 스킬 또는 플러그인 파일의 `name`은 무시됩니다
[Cloud sessions] 루틴 실행이 끝난 뒤에도 몇 시간 동안 실행 중으로 표시되는 경우가 간혹 있던 문제를 고쳤습니다
[Cloud sessions] 저장된 알림 설정이 없는 루틴을 편집하거나 복제하면 푸시 알림이 꺼지던 문제를 고쳤습니다
[Cloud sessions] SVG, HEIC, TIFF 등 흔하지 않은 이미지 파일이 첨부되지 않던 문제를 고쳤습니다. 이제 일반 파일로 첨부됩니다
[Cloud sessions] 조직이 승인을 필수로 설정한 커넥터 도구에 대해 승인 프롬프트가 "Always allow"를 제안하던 문제를 고쳤습니다. 이 선택은 아무 효과가 없었습니다
[Remote Control] claude.ai/code에서 시작한 새 Remote Control 세션의 첫 메시지가 이미지만 허용하던 문제를 고쳤습니다. 이제 이후 메시지처럼 PDF와 다른 파일도 허용합니다
[Claude Tag] 채널의 Configure 페이지에 있는 Allowed domains 카드에 Edit 버튼을 추가했습니다. Enterprise 관리자가 채널의 도메인을 설정하는 액세스 번들을 열 수 있습니다
[Claude Tag] Claude가 Slack 스레드에서 첫 요청을 처리하는 동안 보낸 답글이 요청이 끝날 때까지 보류되거나, 몇 초 간격으로 보낸 경우 누락되던 문제를 고쳤습니다
[Claude Tag] 관리자가 채널 또는 워크스페이스 기본 모델을 변경한 뒤에도 GitHub 풀 리퀘스트 활동이나 루틴으로만 깨어난 Slack 스레드가 기존 모델을 계속 사용하던 문제를 고쳤습니다
[Claude Tag] 실제 원인은 조직의 사용량 크레딧 소진인데도 Claude가 Slack에 지출 한도 알림을 게시하는 경우가 있던 문제를 고쳤습니다
[Claude Tag] Slack에서 응답할 수 없는 권한 프롬프트가 자동으로 거부되었을 때 세션이 중단할 때까지 멈춰 있던 문제를 고쳤습니다
[Claude Tag] 채널의 `@Claude !status`를 개선했습니다. 이제 Claude가 태그되지 않은 메시지 읽기를 중단했는지, 그 이유, 그리고 @-멘션을 하면 다시 읽기 시작한다는 점을 알려 줍니다
[Claude Tag] `!fork`로 이어 간 Slack 스레드의 첫 메시지를 원본 스레드 링크와 함께 출처, 요청, 요청자를 보여 주는 카드로 변경했습니다
[Claude Tag] 관리자 설정의 Claude Tag 지출 한도 페이지에서 조직 전체 및 기본 지출 한도 입력란이 다른 곳을 클릭할 때가 아니라 Save 또는 Enter를 누를 때만 저장되도록 변경했습니다
[Code Review] Code Review 분석의 PRs reviewed 차트에 해당 기간의 합계와 이전 기간 대비 변화, 저장소별 내역을 추가했습니다
[Code Review] 풀 리퀘스트가 새 기준 브랜치로 옮겨지고 기존 브랜치가 삭제되었을 때 대기 중이던 리뷰가 실패하던 문제를 고쳤습니다. 이제 해당 커밋을 리뷰 대기열에 다시 넣습니다
[Code Review] 풀 리퀘스트가 CLAUDE.md 파일을 수정할 때 리뷰가 해당 파일의 규칙을 무시하던 문제를 고쳤습니다. 이제 리뷰는 기준 브랜치의 버전을 사용합니다

함께 읽기: Claude Code v2.1.291 릴리스: 회귀 버그 2건 수정 · AstaBrief 8B 모델: 자체 호스팅 기반 3.5배 빠른 과학 문헌 인용 보고서 생성 · Claude Code v2.1.289: 권한 규칙 우회 수정과 플러그인 안정화

▲ 맨 위로

새로 쓸 수 있게 된 기능

이번 업데이트로 새로 쓸 수 있게 된 기능은 10가지입니다. 근거 항목은 위 릴리스 노트의 번호입니다.

기능	달라진 점	근거 항목
plugin install의 --marketplace 옵션	claude plugin install에 --marketplace <source>를 붙이면 필요할 때 마켓플레이스를 먼저 추가한 뒤 플러그인을 설치합니다. 추가 단계에는 marketplace add와 같은 정책 검사가 적용됩니다.	1번
Agent 도구의 effort 파라미터	서브에이전트를 실행할 때 원하는 effort 수준을 지정하면 Claude가 그 수준으로 서브에이전트를 돌립니다.	2번
과부하 재시도 대기 시간 설정	CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS 환경 변수로 529 과부하 응답 뒤 재시도 백오프의 기본 지연을 길게 잡을 수 있습니다.	3번
MCP 프로토콜 협상 변경	로컬(stdio) MCP 서버가 Bedrock, Vertex, Foundry를 포함해 기본으로 프로토콜 버전 2026-07-28을 협상합니다. 이전 방식이 필요하면 MCP_PROTOCOL_NEGOTIATION=legacy를 설정합니다. 새 검사를 무시하는 서버는 한 번 느리게 연결된 뒤 7일간 기억되어 대기 없이 이전 방식으로 연결됩니다.	72번, 71번
claude -p·SDK 시작 속도 개선	첫 턴이 HTTP와 SSE MCP 서버의 resources/list 응답을 더 이상 기다리지 않습니다.	60번
긴 목록 응답 렌더링 속도	글머리표나 번호 목록이 긴 응답을 스트리밍, 크기 조절, ctrl+o 트랜스크립트로 다시 열 때 훨씬 빠릅니다.	61번
strict 샌드박스의 환경 변수 접두 명령	user, managed, --settings 설정에서 strict 샌드박스 모드를 쓰면 FOO=bar python3 app.py 같은 환경 변수 접두 인터프리터 명령이 확인 없이 실행됩니다.	66번
모드 개발용 훅과 캐싱	모드는 prompt.autocomplete 이벤트로 자동완성 목록에 항목을 넣을 수 있고, $.model.complete에서 블록 단위 cache: true로 프롬프트 캐싱을 쓸 수 있습니다. agent.spawn 훅은 워크플로 에이전트도 받아 거부할 수 있습니다.	4번, 5번, 6번
입력과 도구 호출 관대화	Grep은 path 대신 file_path를 받고, Write, WebFetch, Read는 불필요한 파라미터가 있어도 호출이 실패하지 않습니다. Ctrl+C로 지운 초안은 슬래시 명령이나 메시지 전송 뒤에도 Up으로 불러옵니다.	64번, 62번
Artifact 목록 확대	Claude가 게시된 아티팩트 수를 파악하고 한 번에 최대 200개까지 나열합니다. 기존 한도는 50개였습니다.	67번

▲ 맨 위로

업데이트 효과 직접 재보기

에이전트, effort, 속도, 재시도에 관한 변경이 내 작업에서 얼마나 차이 나는지는 직접 재 보면 숫자로 확인됩니다. claude -p를 JSON 출력으로 실행하면 걸린 시간과 턴 수, 서브에이전트 결과가 함께 나옵니다.

claude -p "<작업 지시>" \
  --output-format json < /dev/null

작업 지시는 옵션보다 앞에 둡니다. --allowedTools Agent "<작업 지시>"처럼 쓰면 --allowedTools가 값을 여러 개 받는 옵션이라 작업 지시까지 도구 이름으로 읽습니다. 옵션을 뒤에 쓰려면 --allowedTools=Agent처럼 =로 붙입니다. 아무것도 보내지 않는 파이프에 표준 입력이 연결돼 있으면 3초를 기다린 뒤 경고를 띄우고 진행하는데, < /dev/null로 표준 입력을 막아 두면 이 대기가 없습니다.

duration_ms: 실행 전체에 걸린 시간(밀리초)
num_turns: 결과가 나오기까지 걸린 턴 수
subagent_stats.completed / subagent_stats.failed: 서브에이전트가 끝까지 마친 수와 실패한 수

단순 조회 작업 하나(예: 어떤 함수가 어디서 호출되는지 찾기)와 코드 수정 작업 하나(예: 함수 하나에 테스트 추가)를 정해 둡니다. 같은 저장소에서 설정마다(업데이트 전후, effort 수준별) 두 작업을 각각 여러 번 실행하고, 조회와 수정의 기록을 따로 모아 비교합니다.

아래는 Claude Code 2.1.292에서 서브에이전트 한 개를 띄운 실행의 실제 출력에서 위 네 값만 남긴 것입니다. 나머지 키는 ...로 줄였습니다.

{
  "duration_ms": 14271,
  "num_turns": 4,
  "subagent_stats": {
    "completed": 1,
    "failed": 0,
    ...
  },
  ...
}

기록표의 첫 줄은 이 실행을 옮긴 것입니다. 조회 작업과 코드 수정 작업을 나눠, 실행할 때마다 한 줄씩 더합니다.

작업	설정	시간(ms)	턴	완료/실패
예시	2.1.292	14271	4	1 / 0

▲ 맨 위로

업데이트하고 버전 확인하기

이 글의 변경을 모두 쓰려면 Claude Code 2.1.292 이상이 필요합니다. 터미널에서 claude update로 새 버전을 받고, claude --version으로 2.1.292 이상인지 확인합니다.

claude update
claude --version

▲ 맨 위로

글쓴이 MinoSui · 블로그 운영자·편집 책임

편집 방침. 오류 제보는 문의로 받습니다. 글쓴이·블로그 소개

출처

Claude Code v2.1.292 릴리스 노트 · github.com

#IT·AI#클로드AI#ClaudeCode

작성일 2026-10-07 06:18

오피셜메일2026년 10월 7일 오후 12:37
새 기능 표에 근거 항목 번호를 붙여 둔 덕분에 원문과 대조하기 쉽네요. 서브에이전트마다 작업 범위를 나눈 뒤 검토 수준도 따로 정한다는 관점이 흥미롭습니다. 실제 적용을 비교한다면 단순 조회와 코드 수정 작업의 완료 시간, 재시도 횟수를 따로 기록해 보면 차이를 더 잘 볼 수 있겠습니다.
답글삭제
답글

댓글 추가

이 블로그 검색

미노쓰의 글log