Claude Code 2.1.140 업데이트

💡

Agent 툴의 `subagent_type` 매칭이 대소문자·구분자를 무시하도록 개선되고(예: "Code Reviewer" → `code-reviewer`), `plugin.json`이 기본 컴포넌트 폴더(`commands/` 등)와 충돌해 폴더가 조용히 무시되던 상황에서 경고를 띄우도록 보강되었습니다. `/goal`이 `disableAllHooks`/`allowManagedHooksOnly` 환경에서 조용히 멈추던 문제, 심링크된 설정 파일의 핫리로드 회귀, `claude --bg`의 연결 끊김, 401에서 재시도하지 않던 remote managed settings, `extraKnownMarketplaces` 자동 업데이트 정책 미반영, `Read` 툴의 공백 포함 `offset` 검증 실패 등 인증·세션·백그라운드·플러그인·UI 영역의 버그가 다수 수정되었습니다.

#Claude Code#업데이트
🔗 공식 발표 →

이 글은 공식 문서를 바탕으로 요약·정리한 내용입니다.

무엇이 바뀌었나?

Claude Code 2.1.140이 2026년 5월 12일(현지 시간) 릴리스되었습니다. 새 명령은 추가되지 않았지만 Agent 툴의 subagent_type 매칭이 대소문자·구분자에 관대해졌고(“Code Reviewer”가 code-reviewer로 자동 해석), agent 색상 팔레트가 갱신되었으며, 플러그인의 기본 컴포넌트 폴더가 plugin.json의 동일 키 설정 때문에 조용히 무시되는 경우 경고를 띄우도록 보강되었습니다. 동시에 /goal이 hook 비활성화 정책 환경에서 조용히 멈추던 문제, 심링크된 settings 파일의 핫리로드 회귀, claude --bg 연결 끊김, 401에서 한 번도 재시도하지 않던 remote managed settings, 관리형 extraKnownMarketplaces 자동 업데이트 정책 누락, /loop의 중복 wakeup, Windows에서 누락된 실행파일이 일으키던 이벤트 루프 stall, Read 툴 offset 문자열 검증, 포커스를 잃은 터미널의 커서 위치 등 인증·세션·백그라운드·플러그인·UI 영역의 자잘하지만 운영에 거슬리던 결함들이 한 번에 정리되었습니다.

주요 개선

  • Agent 툴 subagent_type 매칭 — 대소문자·구분자 무시

    서브에이전트를 호출할 때 등록명을 정확히 (kebab-case 그대로) 입력해야 인식되어, “Code Reviewer”처럼 사람이 자연스럽게 부르는 표기를 그대로 쓰면 매칭에 실패하곤 했습니다. 이제 대소문자와 공백·하이픈·언더스코어 같은 구분자를 무시한 매칭이 적용되어, 예를 들어 "Code Reviewer"가 code-reviewer로 자동 해석됩니다.

  • agent 색상 팔레트 갱신

    여러 서브에이전트가 동시에 떠 있을 때 서로 구분하기 어려운 색이 섞여 있던 문제를 줄이기 위해 agent 색상 팔레트가 갱신되었습니다.

  • 플러그인 — plugin.json 키와 기본 폴더 충돌 시 경고 표시

    plugin.json이 commands 같은 키를 직접 지정하면 같은 이름의 기본 폴더(commands/)가 조용히 무시되어, 플러그인 작성자가 컴포넌트가 왜 로드되지 않는지 추적하기 어려웠습니다. 이제 이런 상황이 발견되면 /doctor, claude plugin list, /plugin 출력에 경고가 함께 표시됩니다.

주요 버그 수정

/goal·자동화

  • /goal이 disableAllHooks/allowManagedHooksOnly가 설정된 환경에서 조용히 멈추던 문제 — 무한히 도는 인디케이터만 보이던 동작이, 이제 명확한 메시지로 사유를 알려줍니다.
  • /loop이 완료를 알리는 백그라운드 작업까지 폴링하느라 중복 wakeup을 예약하던 문제 수정.

설정·인증

  • 심링크된 settings 파일에서 핫리로드가 변경 이벤트를 잘못 귀속시키고 의도치 않은 ConfigChange 훅을 발생시키던 회귀 수정.
  • remote managed settings가 401 응답에서 한 번도 재시도하지 않던 문제 — 이제 토큰을 강제로 갱신해 한 번 재시도합니다.
  • 관리형 extraKnownMarketplaces 자동 업데이트 정책이 known_marketplaces.json에 저장되지 않던 문제 수정.

백그라운드 서비스

  • claude --bg가 백그라운드 서비스가 idle 종료 직전일 때 “connection dropped mid-request”로 실패하던 문제 수정.
  • 엔터프라이즈 엔드포인트 보안이 설치된 머신에서 백그라운드 서비스 기동이 실패하던 문제 — 시작 대기 시간이 더 늘어났습니다.

Tool·플랫폼

  • Read 툴 호출이 offset 인자에 앞뒤 공백 또는 + 접두 문자열을 받으면 검증 실패하던 문제 수정.
  • 누락된 실행파일(예: gh) 때문에 Windows에서 매 점검마다 동기 where.exe 재실행이 일어나 이벤트 루프가 주기적으로 멈추던 문제 수정.

UI·터미널

  • 네이티브 터미널이 포커스를 잃었을 때 커서가 입력 캐럿 위치에 머물지 않던 문제 수정.

알아두면 좋은 점

  • subagent_type 매칭의 관대한 해석 — "Code Reviewer"/"code_reviewer"/"code-reviewer"가 모두 동일 에이전트로 매칭됩니다. 자동화 스크립트에서 서브에이전트를 부르던 코드가 있다면 표기 다양성에 너그러워졌다는 점만 기억해 두면 됩니다.
  • 플러그인 컴포넌트가 누락되어 보일 때 — plugin.json에 직접 키를 지정하면 같은 이름의 기본 폴더가 무시됩니다. 컴포넌트가 안 보이면 /doctor·claude plugin list·/plugin의 경고를 먼저 확인하세요.
  • /goal을 hook 정책과 함께 쓰던 환경 — disableAllHooks/allowManagedHooksOnly 환경에서 인디케이터만 돌던 증상이 사라지고 명확한 메시지가 표시됩니다. 정책 충돌 디버깅이 한결 빨라집니다.
  • remote managed settings 401 재시도 — 한 번 강제 토큰 갱신 후 재시도가 들어가지만, 자격 증명 만료가 반복되는 환경이면 결국 재로그인이 필요합니다. 401이 잡혀도 무시되지 말고 원인을 확인하세요.
  • 백그라운드 서비스 기동 시간 증가 — 엔터프라이즈 보안 도구가 깔린 환경에서 시작이 더 오래 걸릴 수 있다는 의미이기도 합니다. 첫 실행 직후 짧은 대기는 정상 동작입니다.