Claude Code CLI 2.1.292 변경 로그
요약
Claude Code CLI 2.1.292 버전의 변경 로그를 통해 새로운 기능과 여러 보안 및 안정성 개선 사항을 확인할 수 있습니다. 주요 업데이트로는 마켓플레이스 기반 플러그인 설치, 에이전트 도구에 'effort' 매개변수 추가 등이 포함되었습니다. 또한, 다양한 환경에서의 권한 관리 취약점 수정 및 백오프 로직 강화가 이루어졌습니다.
핵심 포인트
- 마켓플레이스를 통한 claude plugin install 기능 추가
- Agent 도구 실행 시 effort 수준 지정 가능
- overloaded 요청 재시도 지연 시간 설정 옵션 제공
- 다양한 보안 취약점(권한 우회 등) 수정 및 강화
새로운 기능:
• claude plugin install에 --marketplace <source> 추가: 필요한 경우 마켓플레이스를 추가하며, 이는 claude plugin marketplace add의 정책 검사와 동일합니다. 그런 다음 해당 마켓플레이스에서 플러그인을 설치합니다.
• Agent 도구에 effort 매개변수 추가: 이제 Claude가 요청한 effort 수준에서 서브 에이전트를 실행합니다.
• overloaded (529) 요청을 재시도할 때 백오프(backoff)를 위한 더 긴 기본 지연 시간을 설정하는 환경 변수 CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS 추가
• prompt.autocomplete 추가: 모드가 프롬프트 상자 자동 완성 목록에 자체 행을 추가하도록 연결되는 이벤트입니다.
• mod용 $.model.complete에 프롬프트 캐싱 추가: 프롬프트와 시스템은 텍스트 블록을 가져가며, cache: true로 설정된 블록은 해당 지점까지의 요청을 캐시합니다.
• 모드에서 run과 index를 포함하여 workflow agents를 agent.spawn mod hook에 추가하여, 모드가 이들을 거부할 수 있게 합니다.
수정 사항:
• permissionMode가 있는 서브 에이전트 정의 수정: 자동 모드가 사용 불가능할 때(설정, 회로 차단기 또는 지원하지 않는 모델에 의해 비활성화된 경우) 자동으로 자동 모드로 진입하는 문제 수정
• sandboxed 명령어가 ~/.claude/seed-admin 아래의 /ultrareview 업로드 스테이징 파일 복사본을 읽을 수 있던 문제 수정
• 관리형 샌드박스 read-deny 경로(및 그 옆 사용자 경로)가 세션 중간에 나타나거나 재지정되면서 내부 프로젝트 권한을 삭제하거나 해당 파일을 포함하는 크리덴셜 주입을 종료시키던 문제 수정
• macOS 및 Windows에서 노트북 또는 PDF를 읽을 때, 읽기 도중에 링크로 교체되어 승인된 파일 외의 파일을 반환할 수 있던 문제 수정
• 서버 관리 설정의 변조된 온디스크 캐시가 설정 가져오기에 실패하는 동안 내장 정책 플러그인을 끄거나 자리에서 옮길 수 있던 문제 수정
• 홈 폴더 또는 드라이브의 8.3 단축 이름이나 다른 대체 Windows 철자로 rm -rf를 실행할 때 제거로 처리되지 않던 문제 수정
• 보안: PreToolUse hook 승인 및 자동 모드가 네트워크(UNC) 경로에서 파일 읽기에 대한 권한 프롬프트를 우회하던 문제 수정
• 자동 모드(auto mode) 또는 계획 모드(plan mode) 도중에 이탈했을 때, 스킬(skill)이나 슬래시 명령어(slash command)의 allowed-tools 규칙이 나중에 다시 적용되던 문제 수정
• HTTPS_PROXY가 설정된 경우, Claude Code 자체 API 요청(로그인, 정책, 피드백, 아티팩트 등)에 대해 NO_PROXY가 무시되던 문제 수정
• 이름 길이가 128자를 초과하는 MCP 도구를 사용하면 모든 요청이 실패하던 문제 수정; 해당 도구는 이제 제외되고 MCP 오류 메시지에 그 이름이 명시됨
• 조직의 관리 설정(managed settings)이 로드되기 전에 실행되는 marketplace add나 install 같은 claude 플러그인 명령어 수정
• 일회성 claude -p 및 Agent SDK 실행 시, 최종 결과가 나온 후 5초 뒤에 백그라운드 명령이 중단되던 문제와, 일회성 claude -p 실행 시 예약된 웨이크업(wakeup)이 사라지던 문제 수정; 이제 둘 다 대기함
• claude --resume 세션 선택기 또는 /resume으로 세션을 재개할 때 계획 모드가 복원되지 않던 문제 수정
• /resume, /branch 또는 /clear 이후에 생성된 저장된 예약 작업(saved scheduled tasks)이 작동하지 않거나, 작업 파일에 두 번의 쓰기가 밀리초 단위로 발생한 후 나중에 생성 및 삭제되는 작업을 무시하던 문제 수정
• 백그라운드 세션에서 프로세스가 재시작될 때(예: 충돌 후), 해당 세션의 보류 중인 웨이크업이 손실되어 /loop가 조용히 멈추던 문제 수정
• Grep 및 Glob이 주어진 파일이나 폴더를 읽을 수 없을 때 일치하는 항목이 없다고 보고하던 문제 수정; 이제 Claude는 한 번 다시 시도하거나 사용자에게 알려줌
• Read 도구가 PDF 페이지 목록이
• 수신자가 유사한 이름의 두 세션을 보여주는 크로스-세션 배달 알림 문제 수정; 그리고 터미널 세션에서 메시지가 만료되었을 때 데스크톱 앱이 책임을 지는 만료 알림 문제 수정
• 데스크톱 앱에서 '지금 보내기' 기능 사용 시, 다른 메시지가 이미 대기열에 있을 때 서브 에이전트가 기다리던 턴을 종료시키는 문제 수정
• /bug, /share 및 /feedback <text>를 보고하는 도중 Ctrl+O 또는 Ctrl+Z로 시작하면 재시작되고, 전송된 후 취소된 것으로 닫히는 버그 수정
• /remote-env에서 바로 Enter 키를 누를 때 저장된 기본 환경을 대체하던 문제 수정: 이제 목록은 기본값으로 열리고, 기본값이 적용되지 않은 경우 어떤 행에도 체크 표시가 없습니다
• 여러 붙여넣기가 하나의 프롬프트에 겹칠 때 일부 붙여넣기 텍스트가 Claude에게 입력된 텍스트로 전달되던 문제 수정
• vim 모드에서 커서가 줄 끝을 지나치게 남는 문제, j/k가 짧은 줄에서 열을 잃는 문제, 그리고 f/t/F/T/;/, 또는 다른 줄의 일치 항목으로 이동하거나 삭제하는 기능에 대한 버그 수정
• /add-dir 경로 상자에서 Shift+Enter 또는 붙여넣기가 줄 바꿈을 추가하게 하고, 빠르게 입력된 'tab', 'up' 또는 'down'을 해당 키로 처리하던 문제 수정
• 프롬프트 푸터 행이 선택되었을 때 빠른 타이핑, 입력기 텍스트 및 분해된 악센트가 누락되던 문제 수정
행을 선택한 상태에서
• iTerm2가 감지된 경우 창 크기 조정 시마다 전체 화면 클리어(full-screen clear)를 보내던 문제와 Ctrl+L이 실행되던 문제를 수정하여, 이로 인해 iTerm2의 스크롤백에 오래된 페이지가 채워지는 것을 방지했습니다.
• 읽기 거부 규칙(Read deny rule)이 설정되어 있고 작업 디렉터리(working directory)가 심볼릭 링크(symlink) 아래에 있을 때, 파일을 이름으로 지정하는 @-단어에 대해 '검사할 수 없음(could not be examined)'이라는 잘못된 알림을 수정했습니다.
• '/cd' 또는 권한 변경 후 '지침 파일 로드 안됨(instruction file not loaded)' 줄이 오래되거나 누락되는 문제를 수정하고, 중첩된 지침 파일이 로드되지 않았을 때 전사(transcript) 라인을 추가했습니다.
• /name으로 인해 Claude가 사용자에게 예약된 스킬을 호출하게 만드는 압축 요약(compaction summary)을 반복하던 문제를 수정했습니다.
• Write, Edit, NotebookEdit 및 LSP 행과 단일 Read, Grep 및 Glob 행에서 모드가 호출을 거부한 이유를 숨기던 문제를 수정하여, 이제 해당 행에 이유가 표시되도록 했습니다.
• 작업자가 종료되는 시점에 턴(turn)이 끝나지 않은 상태로 클라우드 세션이 표시되던 문제를 수정했습니다.
• 아티팩트(artifacts)의 승인이 완료된 후에도 큰 전사 기록을 가진 클라우드 세션에서 때때로 다시 권한을 요청하던 문제를 수정했습니다.
• Claude가 메시지를 재시도하거나 편집하는 동안 클라우드 세션에서 예약 작업 및 기타 대기 중인 알림이 손실되던 문제를 수정했습니다.
• 클라이언트에서 선택된 사고(thinking) 설정을 클라우드 세션의 컨테이너가 다시 시작할 때 잊어버리던 문제를 수정했습니다.
• Anthropic이 조직의 설정을 확인할 수 없었을 때 Cowork 클라우드 세션에서 프록시가 아티팩트를 차단했다고 표시하던 문제를 수정했습니다.
• 후크 모듈(hooks module)이 하나의 const를 통해 많은 $.state 호출을 수행하여 로드하거나 검증하는 데 몇 분이 걸리던 플러그인 문제를 수정했습니다.
• 엔진이 다른 곳에서 읽어오는 후크 모듈에 대해 claude plugin validate가 매처(matcher) 또는 상태 값(state value) 목록을 표시하던 문제를 수정했습니다.
• 최상위 변수(top-level var)를 다시 선언하거나 재할당하여 읽은 $.state 값을 나열하는 플러그인 문제가 발생하던 것을 수정했습니다. 해당 모듈은 이제 거부됩니다.
• 플러그인의 제공된 $ 메서드가 후크 원본을 재시작하여, 그 위에 .catch가 있는 가드 후크(guard hook)를 끝없이 다시 실행할 수 있게 하던 문제를 수정했습니다.
• 플러그인 후크가 워커를 재시작하는 동안, 해당 후크에 다른 플러그인이 설정한 후크 없이도 호출되는 인터페이스 호출 문제를 수정했습니다.
• 모드의 config.set, state.set, env.set 또는 agent.spawn 후크가 next(e) 호출 이후 거부 응답을 받은 경우 이를 거부로 처리하는 문제가 있었습니다: 이제 해당 후크는 이름과 함께 실패로 보고됩니다.
• /theme, /config Theme 메뉴 및 첫 실행 시 플러그인의 config.set 후크가 요청되기 전에 테마를 저장하던 문제를 수정했습니다.
• 플러그인의 tool.check 후크가 사용자의 답변(질문, 계획 승인)을 요구하는 도구를 허용하는 응답을 표시하지 않고도 반환하던 문제를 수정했습니다.
• 모드의 시작 프롬프트, 명령 또는 서브 에이전트가 후크 워커가 교체될 때 두 번 큐에 추가되던 문제를 수정했습니다.
• next(e)를 호출한 후 다음 턴이 중단되어 실패할 경우 해당 호출을 통과시키던 모드의 후크 문제가 있었습니다; 이제 해당 호출은 거부됩니다.
• 플러그인의 프롬프트 드롭 또는 설정 거부가 그 이유가 4,096자를 초과했을 때 무시되던 문제를 수정했습니다.
• 조직의 플러그인이 자체 재로드 시 또는 다른 플러그인이 충돌한 후에도 사용자 설치 모드가 추가한 $ name을 반환할 경우 언로드되던 문제가 있었습니다; 이제 해당 모드가 대신 언로드됩니다.
• 플러그인 후크 워커가 재시작되는 동안 이루어진 도구 호출이 플러그인의 권한 후크 없이 응답되던 문제를 수정했습니다.
• 플러그인 https://t.co/uU8vmRKtCl의 후크가 잘못된 매개변수가 수정되기 전에 일부 도구 호출을 보던 문제가 있었습니다; 이제 후크는 해당 도구가 실행될 인수를 볼 수 있습니다.
• 다른 모드의 후크 아래에서 작동하는 호출에 대해 .catch를 가진 모드의 가드 후크가 조용히 건너뛰어지던 문제: 이제 해당 .catch가 요청됩니다.
개선 사항 (Improvements):
• claude -p 및 SDK 세션 시작 개선: 첫 번째 턴에서 HTTP 및 SSE MCP 서버가 resources/list 응답을 기다리지 않게 되었습니다.
• 긴 글머리 기호 또는 번호 매겨진 답변의 렌더링 속도 개선: 이제 스크립트 내에서 스트리밍되고, 크기가 조정되며, 다시 열리는(ctrl+o) 것이 훨씬 빨라졌습니다.
• Ctrl+C 초안 복구 개선: 슬래시 명령어 또는 전송된 메시지 후 지워진 프롬프트가 Up 키로 여전히 접근 가능하게 유지됩니다.
• 훅 출력 처리 개선: 훅의 출력에 작성된 <system-reminder> 태그는 Claude에게 도달하기 전에 이스케이프(escape) 처리됩니다.
• 도구 입력 처리 개선: Grep은 path를 위해 file_path를 수락하며, Write, WebFetch 및 Read는 호출 실패 대신 몇 가지 잘못된 매개변수를 무시합니다.
• 설정 파일에 선언된 마켓플레이스가 공식 Anthropic 마켓플레이스처럼 보이는 경우 표시되는 단계 개선
• 샌드박스 자동 허용 개선: 사용자, 관리 또는 --settings settings에서 엄격한 샌드박스 모드가 설정된 경우, FOO=bar python3 https://t.co/KnoVqpa5FL과 같은 환경 변수 접두사가 있는 인터프리터 명령이 프롬프트 없이 실행됩니다.
• Artifact 도구 목록 개선: Claude는 이제 사용자가 게시한 아티팩트 개수를 파악하고 50개 대신 최대 200개를 한 번에 나열할 수 있습니다.
• 재시작 후 클라우드 세션 개선: Claude에게 중지된 백그라운드 에이전트를 ID별로 다시 시작할 수 있다는 정보가 제공됩니다.
• 브라우저에 도달할 수 없는 경우 https://t.co/ldz5BaC3j0의 클라우드 세션에서 표시되는 Claude in Chrome 메시지 개선: 이제 사용자가 선호하는 경우 대안으로 계속 진행할 수 있다는 정보가 제공됩니다.
• /focus 팁 개선: 이제 턴 중간에 포커스 보기(focus view)를 시도하도록 초대하고 다시 전환하는 방법을 보여줍니다.
• 최신 프로토콜 확인을 무시하는 로컬 (stdio) MCP 서버와의 시작 개선: 느린 연결 후 한 번만 발생하면 7일 동안 기억되며 기다림 없이 이전 방식으로 연결됩니다.
보안/안전 변경 사항 (Security/safety change):
• [Claude 태그] Slack에서 답변할 수 없는 권한 프롬프트가 거부되었을 때 세션이 중단되어 인터럽트될 때까지 멈추는 문제 수정
AI 자동 생성 콘텐츠
본 콘텐츠는 X Claude/Anthropic의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기