claudekit / updates / claude-code-2-1-145
[ PATCH · ]

Claude Code 2.1.145

`claude agents --json`이 추가돼 라이브 세션 목록을 스크립트로 다룰 수 있게 됐고, `claude_code.tool` OTEL 스팬의 `agent_id`·`parent_agent_id` 속성으로 백그라운드 서브에이전트 trace가 올바르게 중첩됩니다. 상태 바 JSON에 GitHub 리포·PR 정보가 포함되고, `/plugin` Discover·Browse 화면이 설치 전 플러그인의 commands·agents·skills·hooks·MCP/LSP 서버를 미리 보여줍니다. 보안 관련으로 Bash 단독 변수 할당의 권한 프롬프트 우회가 막혔고, MCP 슬래시 명령 검증, 터미널 리사이즈 후 스피너 멈춤, Read 도구의 토큰 한도 초과 처리 등이 정리됐습니다.

Claude Code
공식 발표 →

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

무엇이 바뀌었나?

Claude Code 2.1.145는 2026년 5월 19일에 출시됐습니다. 추가된 기능은 외부 스크립트가 라이브 세션 상태를 읽을 수 있게 해주는 claude agents --json, OTEL 스팬에 agent_id·parent_agent_id를 더해 서브에이전트 트레이스 부모-자식 관계를 바로잡은 것, 상태 바 JSON에 GitHub 리포·PR 정보가 들어간 것, /plugin Discover·Browse가 설치 전에 플러그인 구성요소(commands·agents·skills·hooks·MCP/LSP)를 미리 보여주는 것, 그리고 Stop·SubagentStop 훅 입력에 background_tasks·session_crons 필드가 추가된 것 5가지입니다. 나머지는 Bash 환경변수 단독 할당의 권한 프롬프트 우회 차단(보안), MCP 슬래시 명령 오류 메시지 정리, 터미널·/plugin·claude agents UI 회복성 개선, 동시 생성 태스크 정렬, Agent Teams 비-ASCII 이름 헤더 인코딩, /review의 deprecated GraphQL 쿼리, context: fork 스킬 무한 재호출 등 다수의 버그 수정과 Read 도구의 PARTIAL view 처리 개선입니다.

새 기능

  • claude agents --json — 라이브 세션 목록을 JSON으로 출력

    지금까지 라이브 세션 목록은 인터랙티브 픽커에서만 볼 수 있어, tmux-resurrect 복구·상태 바·외부 세션 픽커 같은 도구에서 세션 상태를 활용하기 어려웠습니다. claude agents --json이 추가되어 스크립트에서 라이브 세션 목록을 구조화된 JSON으로 받아 가공할 수 있습니다.

  • claude_code.tool OTEL 스팬에 agent_id·parent_agent_id 추가, 트레이스 부모-자식 관계 수정

    백그라운드 서브에이전트가 띄운 스팬이 호출자(Agent tool 스팬) 아래로 들어가지 않아 트레이스에서 관계가 끊겨 보였습니다. 이번 릴리스에서 스팬에 agent_id·parent_agent_id 속성이 더해지고 트레이스 부모 지정 로직이 수정돼, 서브에이전트 스팬이 디스패치한 Agent tool 스팬 아래로 정상 중첩됩니다.

  • 상태 바 JSON 입력에 GitHub 리포·PR 정보 포함

    GitHub 리포·PR 컨텍스트가 감지되더라도 상태 바 JSON 입력에는 노출되지 않아, 커스텀 상태 바에서 같은 정보를 별도로 수집해야 했습니다. 이제 감지된 GitHub 리포·PR 정보가 상태 바 JSON 입력에 포함됩니다.

  • /plugin Discover·Browse — 설치 전에 commands·agents·skills·hooks·MCP/LSP 서버 노출

    설치 전에는 플러그인이 어떤 명령·에이전트·스킬·훅·MCP/LSP 서버를 포함하는지 알 수 없어, 일단 설치한 뒤 확인해야 했습니다. 이제 Discover·Browse 화면이 플러그인 구성요소를 설치 전에 미리 보여줍니다.

  • Stop·SubagentStop 훅 입력에 background_tasks·session_crons 필드 추가

    Stop·SubagentStop 훅 입력에는 종료 시점 컨텍스트가 부족해, 백그라운드 태스크·세션 cron이 살아 있는지 훅 안에서 판단하기 어려웠습니다. 이번 릴리스부터 두 훅 입력에 background_tasks·session_crons 필드가 포함됩니다.

주요 개선

  • claude agents 터미널 탭 제목에 입력 대기 카운트 표시

    탭이 백그라운드에 있을 때 어떤 에이전트가 입력을 기다리는지 확인하려면 직접 탭으로 전환해야 했습니다. 이제 탭 제목에 입력 대기 카운트가 표시돼, 다른 창으로 alt-tab한 상태에서도 어떤 에이전트가 주의를 요하는지 바로 확인할 수 있습니다.

  • 풀스크린 모드에서 슬래시 명령·@-멘션 제안 목록의 마우스 호버·클릭 지원

    풀스크린 모드에서는 제안 목록을 마우스로 호버·클릭할 수 없어 키보드로만 조작해야 했습니다. 이제 마우스 인터랙션이 지원됩니다.

  • Read 도구의 토큰 한도 초과 처리 — 치명적 오류 대신 “PARTIAL view” 알림과 함께 첫 페이지를 잘라서 반환

    파일 전체 읽기가 토큰 한도를 넘으면 치명적 오류로 작업이 끊겨, 같은 파일을 다시 읽기 위한 별도 호출이 필요했습니다. 이제 잘린 첫 페이지가 “PARTIAL view” 알림과 함께 반환돼, 후속 호출로 이어 읽기가 자연스럽습니다.

주요 버그 수정

보안

  • Bash 명령에서 허용되지 않은 환경변수에 대한 단독 변수 할당이 권한 프롬프트 없이 자동 승인되던 우회 — 권한 프롬프트가 정상적으로 노출됩니다.

MCP·플러그인·스킬

  • 필수 인자를 생략한 MCP 프롬프트 슬래시 명령이 서버의 검증 오류 원문을 그대로 보여주던 문제 — 누락된 인자 이름과 예상 사용법을 함께 안내.
  • claude plugin validate가 skills: 항목이 디렉토리가 아닌 파일을 가리켜도 잡아내지 못하던 문제 — 이제 오류로 보고하며 부모 디렉토리를 제안.
  • context: fork로 동작하는 스킬이 자신을 무한히 재호출하던 문제 — 정상 실행되도록 수정.

터미널·UI

  • 터미널 리사이즈·재포커스 후 스피너와 경과 시간 표시가 키 입력 전까지 멈춰 있던 문제 — 정상적으로 갱신.
  • Agent View 답변 패널에서 음성 push-to-talk가 동작하지 않던 문제 — 동작 복원.
  • 여러 태스크를 한꺼번에 생성할 때 태스크 목록이 무작위 순서로 렌더링되던 문제 — 정렬 일관성 회복.
  • 마켓플레이스가 이미 설치돼 있는데도 “Failed to install Anthropic marketplace” 배너가 오래 남아 표시되던 문제 — 정리.

Windows·플랫폼

  • 기본 Windows PowerShell 5.1에서 cross-project resume 힌트가 실패하던 문제 — Windows는 명령 구분자로 ;을 사용하도록 수정.

Git/PR·/review

  • gh pr create 등 PR 상태를 바꾸는 명령을 세션 안에서 실행해도 푸터 PR 배지가 즉시 갱신되지 않던 문제 — 즉시 반영.
  • /review가 Classic Projects를 사용하는 리포에서 deprecated projectCards GraphQL 쿼리로 오류를 내던 문제 — 정리.

Agent Teams·API

  • Agent Teams 팀원 이름에 비-ASCII 문자가 포함된 경우, 헤더 인코딩 문제로 모든 API 호출이 실패하던 문제 — 정상 인코딩으로 호출이 진행됩니다.

알아두면 좋은 점

  • 보안 우회 차단(Bash 환경변수 단독 할당): 권한 프롬프트가 노출되지 않은 채 진행되던 환경변수 단독 할당 케이스가 막혔습니다. 자동 승인되리라 기대했던 스크립트가 있다면 권한 정책에서 명시적으로 허용해야 합니다.
  • claude agents --json: 라이브 세션을 외부 도구로 다룰 수 있는 새 인터페이스입니다. tmux-resurrect, 상태 바, 세션 픽커 같은 도구와의 통합 지점으로 활용 가능.
  • OTEL 트레이스 부모-자식 관계 복원: 그간 백그라운드 서브에이전트 스팬이 호출자 Agent tool 스팬 아래로 들어가지 않아 트레이스 분석이 어려웠다면, 이번 버전부터 자연스럽게 중첩됩니다.
  • /plugin 사전 노출: 설치 전에 commands·agents·skills·hooks·MCP/LSP 서버를 미리 볼 수 있어, 도입 결정 단계에서 일단 설치하는 부담이 줄었습니다.
  • Read 도구 PARTIAL view: 전체 파일 읽기가 토큰 한도를 초과해도 작업이 끊기지 않습니다. 큰 파일을 다룰 때 치명적 오류 회피를 위한 사전 분할이 덜 필요합니다.