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

Claude Code 2.1.202

동적 워크플로 크기를 `/config`에서 조절하는 설정과, 워크플로 실행을 OTel로 재구성할 수 있는 `workflow.run_id`, `workflow.name` 텔레메트리 속성이 추가됐습니다. Remote Control(모바일/웹)에서 보낸 명령이 "Unknown command"로 실패하거나 캡션 없는 이미지, 파일이 조용히 누락되던 문제, git worktree가 많은 리포에서 이름으로 세션을 재개할 때 수 분이 걸리고 메모리를 크게 쓰던 문제, 이미 로드된 스킬을 다시 호출하면 지침이 중복 추가되던 문제 등 원격 제어, 세션 재개, 네트워크 연결 관련 수정이 다수 포함됐습니다. `/review <pr>`는 다시 빠른 단일 패스 리뷰로 돌아갔습니다.

Claude Code
공식 발표 →

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

무엇이 바뀌었나?

Claude Code 2.1.202가 2026년 7월 6일 출시됐습니다. 동적 워크플로의 크기 조절 설정과 텔레메트리 속성이 새로 들어왔고, Remote Control(모바일/웹)에서 보낸 명령, 이미지, 파일 처리와 백그라운드 세션, 에이전트 관련 회귀가 정리됐습니다. git worktree가 많은 리포의 세션 재개 성능, mTLS 인증서 회전, 다운로드 재시도 등 네트워크와 성능 개선도 함께 포함됐습니다.

새 기능

  • /config의 동적 워크플로 크기 설정

    워크플로가 생성하는 서브에이전트 규모를 사용자가 조절할 방법이 없었습니다. 이제 /config에 “Dynamic workflow size” 설정이 추가되어, Claude가 동적 워크플로를 얼마나 크게(small/medium/large 에이전트 수) 만들지 조절할 수 있습니다. 강제 상한이 아니라 참고용 가이드라인입니다.

  • 워크플로 텔레메트리에 workflow.run_id, workflow.name 속성 추가

    워크플로가 생성한 에이전트가 남기는 텔레메트리만으로는 어떤 워크플로 실행에 속하는지 추적할 수 없었습니다. 이제 workflow.run_id와 workflow.name OpenTelemetry 속성이 추가되어, OTel 데이터만으로 워크플로 한 번의 실행 활동을 재구성할 수 있습니다.

주요 개선

  • /review <pr>를 다시 빠른 단일 패스 리뷰로 변경

    /review <pr>가 다중 에이전트 리뷰로 바뀌면서 간단히 훑어보고 싶을 때도 느리고 무거웠습니다. 이제 /review <pr>는 빠른 단일 패스 리뷰로 돌아갔고, 원하는 강도의 다중 에이전트 리뷰가 필요하면 /code-review <level> <pr#>를 사용합니다.

  • /workflows 에이전트 목록 레이아웃 개선

    에이전트 목록이 좁은 제목과 행마다 붙은 도구 호출 수 때문에 읽기 불편했습니다. 제목 열이 넓어지고 시간 전용 열이 생겼으며, 모델 이름은 짧아지고 행별 도구 호출 수는 제거됐습니다.

  • MCP 오류 메시지 개선

    서버 설정에 url은 있지만 type이 없으면 “command: expected string”이라는 엉뚱한 메시지가 떴습니다. 이제 "type": "http"를 제안하는 명확한 오류로 바뀌었습니다.

주요 버그 수정

워크플로

  • 워크플로 스크립트 문자열에 유니코드 따옴표 이스케이프가 있으면 파싱 전에 손상되던 문제 수정. 워크플로 파싱 오류도 이제 항상 TypeScript 탓으로 돌리는 대신 문제가 된 줄을 보여줍니다.

Remote Control과 모바일/웹

  • Remote Control(모바일/웹)에서 대화형 세션으로 보낸 명령이 “Unknown command”로 실패하던 문제 수정.
  • Remote Control 모바일/웹 앱에서 캡션 없이 보낸 이미지와 파일이 조용히 누락되던 문제 수정.
  • /remote-control 세션이 모바일과 웹 앱에서 잘못된 권한 모드를 표시하던 문제 수정.

백그라운드 세션과 에이전트

  • 백그라운드 세션의 /rename이 작업 재시작 시 되돌려져, 새 이름으로 세션을 지정할 수 없던 문제 수정.
  • claude agents에서 채팅을 열면 “currently running as a background agent” 오류와 함께 worker가 크래시, 재생성 루프에 빠지던 문제 수정.

세션 재개와 컨텍스트

  • git worktree가 많은 리포에서 이름으로 세션을 재개하거나 재개 피커를 여는 데 수 분이 걸리고 메모리를 크게 쓰던 문제 수정.
  • 이미 로드된 스킬을 다시 호출하면 그 지침이 컨텍스트에 중복으로 추가되던 문제 수정.

네트워크와 연결

  • 클라이언트 인증서를 무중단(in-place) 회전하는 중 설정이 다시 적용되면 mTLS 핸드셰이크가 일시적으로 실패하던 문제 수정.
  • claude auth login과 claude mcp login --no-browser가 출력하는 로그인 URL이 SSH에서 줄바꿈될 때 안정적으로 클릭되지 않던 문제 수정 — 이제 단일 하이퍼링크로 출력됩니다.
  • 프록시나 네트워크가 다운로드 도중 연결을 끊으면 설치, 업데이트 다운로드가 즉시 “aborted”로 실패하던 문제 수정. 일시적 연결 끊김은 이제 재시도합니다.

입력과 UI

  • 인라인 Ctrl+R 히스토리 검색에서 히스토리 파일을 스캔하는 도중 수락하거나 취소하면 크래시가 나던 문제 수정.
  • 마이크나 오디오 레코더가 실패할 때 음성 받아쓰기가 무한 루프로 재시도하던 문제 수정. 반복적인 캡처 실패 시 이제 음성 입력을 일시 중지합니다.

알아두면 좋은 점

  • 동적 워크플로 크기는 강제 상한이 아님 — small/medium/large 설정은 Claude가 워크플로를 얼마나 크게 만들지에 대한 참고용 가이드라인이며, 에이전트 수를 강제로 제한하지 않습니다.
  • PR 리뷰는 두 명령으로 분리 — 빠르게 훑을 때는 /review <pr>(단일 패스), 강도를 지정한 다중 에이전트 리뷰가 필요하면 /code-review <level> <pr#>를 사용합니다.
  • 스킬 중복 지침 수정으로 컨텍스트 절약 — 같은 스킬을 반복 호출해도 지침이 한 번만 유지되므로, 스킬을 자주 재호출하는 워크플로에서 컨텍스트 낭비가 줄어듭니다.