Claude Code v2.1.202 — 워크플로우 크기 조절 + 원격 컨트롤 안정화

Claude Code v2.1.202에서 동적 워크플로우 규모를 직접 조절할 수 있게 됐고, Remote Control과 워크트리 관련 버그가 다수 수정됐습니다.

한마디로 요약

새 설정으로 워크플로우에서 에이전트를 몇 개 정도 띄울지 가이드를 줄 수 있고, 모바일/웹에서 원격 조종하던 중 겪던 각종 끊김·무시 현상이 잡혔습니다. 특히 워크트리가 많은 리포에서 세션 복귀가 느려지던 문제가 해결된 게 체감 포인트입니다.

워크플로우 크기 조절이란?

/config에 "Dynamic workflow size" 설정이 새로 생겼습니다. small / medium / large 중 하나를 고르면, Claude가 동적 워크플로우를 생성할 때 에이전트 개수를 대략 이 가이드에 맞춰서 배분합니다. 강제 제한은 아니고 어드바이저 역할이라, 너무 많이 뜨거나 너무 적게 뜨는 걸 방향성 차원에서 조절할 수 있어요.

또 OpenTelemetry에 workflow.run_id와 workflow.name 속성이 추가됐습니다. 이제 OTel 데이터만 봐도 어느 워크플로우 실행에서 어떤 에이전트가 돌았는지 추적할 수 있습니다. 분산 트레이싱이나 모니터링 대시보드를 운영 중이라면 바로 활용할 수 있겠네요.

Remote Control 버그 대정비

모바일 앱이나 웹에서 세션을 원격 조종할 때 빈번하게 겪던 문제들이 한 번에 수정됐습니다.

• 명령어 전송 실패 → 인터랙티브 세션에 명령을 보내면 "Unknown command" 에러가 뜨던 버그 수정
• 이미지·파일 무시 → 캡션 없이 보낸 이미지나 파일이 조용히 사라지던 현상 해결. 이제 정상적으로 전달됩니다.
• 권한 모드 표시 오류 → /remote-control 세션이 모바일/웹에 잘못된 권한 모드를 표시하던 문제 수정

추가로 SSH 환경에서 claude auth login 출력의 로그인 URL이 여러 줄로 wrapping되면서 클릭이 안 되던 문제도, 단일 하이퍼링크로 출력되도록 수정됐습니다. 터미널에서 작업하는 분들에게는 소소하지만 꽤 반가운 픽스네요.

워크트리 & 안정성

• 세션 복귀 지연 → worktree가 많은 리포에서 이름으로 세션을 재개하거나 resume picker를 열 때 몇 분씩 걸리고 메모리를 잔뜩 쓰던 현상을 수정했습니다.
• 백그라운드 세션 이름 롤백 → /rename으로 바꾼 이름이 잡 재시작 시 원래대로 돌아가버리는 버그도 잡았습니다.
• 음성 입력 무한 재시도 → 마이크 오류 시 무한 루프를 돌던 현상이 반복 실패 시 자동 정지로 변경됐습니다.
• mTLS 핸드셰이크 실패 → 인증서 로테이션 중 설정이 재적용될 때 일시적 연결 실패하던 문제도 해결.

마무리

기능 추가보다는 버그픽스 중심이지만, Remote Control과 워크트리를 실전에서 쓰는 분들에게는 체감 효과가 큰 릴리스입니다. 특히 OTel 속성 추가로 모니터링 환경을 갖춘 팀에게는 꽤 유용한 업데이트네요.

출처: https://github.com/anthropics/claude-code/releases/tag/v2.1.202