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

Claude Code 2.1.203

이번 릴리스는 백그라운드 에이전트와 세션 안정성에 집중했습니다. 데몬 세션 토큰이 만료되면 백그라운드 세션이 영구 응답 불능이 되던 문제가 자동 복구되도록 수정됐고, claude agents로 돌아갈 때 실행 중이던 서브에이전트가 조용히 중단되고 프롬프트가 처음부터 다시 실행되던 문제, 백그라운드 에이전트가 데몬의 오래된 PATH나 셸에서 export한 ANTHROPIC_BASE_URL을 누락해 도구 누락과 401 오류를 내던 문제가 정리됐습니다. git worktree 격리도 개선되어 worktree가 많은 리포에서 Bash가 실패하거나 격리된 서브에이전트가 부모 체크아웃에서 명령을 실행하던 문제가 수정됐고, 로그인 만료 경고와 수동 권한 모드 ⏸ 배지가 추가됐습니다.

공식 발표 →

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

무엇이 바뀌었나?

Claude Code 2.1.203이 2026년 7월 7일 출시됐습니다. 이번 릴리스는 대부분 백그라운드 에이전트와 세션의 안정성에 몰려 있습니다. 세션이 응답 불능이 되거나 실행 중이던 작업이 조용히 사라지던 문제, 데몬의 오래된 환경(PATH, ANTHROPIC_BASE_URL)을 물려받아 실패하던 문제가 대거 수정됐고, git worktree 격리 관련 회귀도 함께 정리됐습니다. 로그인 만료 경고와 수동 권한 모드 표시 같은 작은 편의 기능도 추가됐습니다.

새 기능

  • 로그인 만료 경고

    로그인 세션이 만료되면 백그라운드 세션이 예고 없이 중단됐습니다. 이제 로그인이 곧 만료될 때 경고가 표시되어, 백그라운드 세션이 끊기기 전에 다시 인증할 수 있습니다.

  • 수동 권한 모드 ⏸ 배지

    현재 수동 권한 모드인지 한눈에 알기 어려웠습니다. 이제 수동 권한 모드일 때 푸터에 회색 ⏸ 배지가 표시되어 활성 모드가 항상 보입니다.

  • MCP roots/list에 추가 작업 디렉토리 노출

    MCP 서버는 세션의 추가 작업 디렉토리를 알 수 없었습니다. 이제 세션의 추가 작업 디렉토리가 MCP roots/list에 포함되고, 디렉토리 집합이 바뀌면 notifications/roots/list_changed가 전송됩니다.

  • [VS Code] 모든 세션 Remote Control 토글

    VS Code에서 모든 세션에 Remote Control을 한 번에 켜는 설정이 없었습니다. 이제 설정에 “Enable Remote Control for all sessions” 토글이 추가됐습니다.

주요 개선

  • 긴 응답 스트리밍 중 반응성 개선

    긴 응답이 스트리밍되는 동안 live-preview 업데이트가 화면 전체를 다시 렌더링했습니다. 이제 전체 화면을 다시 그리지 않아 스트리밍 중 반응성이 개선됐습니다.

  • 컨텍스트 사용량 표시기 재분석 제거

    대화형 세션에서 컨텍스트 사용량 표시기가 매 턴마다 전체 transcript를 다시 분석해 메모리와 CPU를 낭비했습니다. 이제 매 턴 후 전체 transcript를 다시 분석하지 않습니다.

  • 서브에이전트 재위임 감소

    서브에이전트가 받은 작업 전체를 다시 다른 서브에이전트에 위임하는 경우가 있었습니다. 이제 작업 전체를 재위임할 가능성이 줄었습니다.

  • 바이너리 크기와 시작 메모리 약 7MB 감소

    큰 번들 의존성이 인라인으로 포함되어 바이너리와 시작 메모리를 키웠습니다. 이제 이 의존성을 지연 로딩해 바이너리 크기와 시작 메모리를 각각 약 7MB 줄였습니다.

  • 좌측 화살표 동작 변경

    좌측 화살표가 백그라운드 작업, diff, 워크플로 상세 뷰를 닫아 실수로 뷰를 벗어나기 쉬웠습니다. 이제 좌측 화살표로는 닫히지 않고 Esc를 눌러야 합니다.

  • claude agents 뷰 정리

    claude agents 뷰는 섹션 구분 없이 표시됐습니다. 이제 Needs input, Working, Completed 섹션을 설명과 함께 항상 보여줍니다.

  • 시작 경고를 /doctor, /status로 이동

    시작 시 “claude command missing or broken” 경고가 매번 표시됐습니다. 이제 이 경고는 시작 화면에서 제거되고 /doctor/status에서 확인합니다.

  • claude agents 푸터 중복 힌트 제거

    claude agents 푸터에 중복된 탐색 힌트가 있어 제거됐습니다.

주요 버그 수정

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

  • 데몬 세션 토큰이 만료되면 백그라운드 세션이 attach, 응답, 중지에 영구 응답 불능이 되던 문제 — 이제 세션이 자동으로 복구됩니다.
  • claude agents로 돌아가면 실행 중이던 서브에이전트가 조용히 중지되고 프롬프트가 처음부터 다시 실행되던 문제 — 이제 진행하던 작업이 그대로 이어집니다.
  • macOS에서 백그라운드 에이전트 세션을 열거나 전환할 때 15~20초 멈추던 문제 — 잘못된 저메모리 감지가 원인이었습니다(2.1.196 회귀). 수정됨.
  • 백그라운드 에이전트가 디스패치한 셸 대신 데몬의 오래된 PATH를 물려받아 Windows에서 도구가 누락되던 문제 수정.
  • 백그라운드, 에이전트 뷰 세션이 셸에서 export한 ANTHROPIC_BASE_URL을 누락해 API 키를 기본 엔드포인트로 보내고 401로 실패하던 문제 수정.
  • 작업 디렉토리가 삭제되거나 파일로 교체되거나 잘못된 경로가 되면 백그라운드 에이전트가 crash 루프에 빠지던 문제 — 이제 명확한 오류와 함께 한 번만 실패합니다.
  • 백그라운드 데몬 자동 업그레이드 실패가 실행 중인 모든 백그라운드 세션을 조용히 종료하던 문제 수정.
  • 다른 에이전트가 생성한 백그라운드 에이전트를 TaskStop, TaskOutput이 찾지 못하던 문제 — 이제 오류에 실행 중인 에이전트를 id와 설명으로 나열합니다.
  • 데몬을 통해 fork된 백그라운드 세션이 settings.json의 effortLevel 변경을 무시하던 문제 수정.
  • attach된 백그라운드 세션이 CLAUDE_CODE_DISABLE_MOUSE, CLAUDE_CODE_DISABLE_MOUSE_CLICKS 비활성화 옵션을 무시하던 문제 수정.
  • claude agents 작성창에서 그곳에 없는 슬래시 명령을 입력하면 입력한 메시지가 사라지던 문제 수정.
  • 다른 세션에서 이미 대화가 열려 있는 중지된 세션을 열면 에이전트 목록이 crash하던 문제 수정.
  • 질문에 이미 답했는데도 에이전트 목록에 “Needs input”이 표시되던 문제 수정.
  • 백그라운드 에이전트 시작 실패가 실제 오류 대신 “exit_with_message”만 표시하던 문제 수정.
  • named 에이전트가 모두 끝난 뒤에도 /exit이 실행 중인 백그라운드 에이전트가 있다고 잘못 경고하던 문제 수정.
  • Windows에서 /clear 후 백그라운드 작업 출력이 빈 파일로 영구 대체되던 문제 수정.

git worktree 격리

  • worktree가 많은 리포에서 Bash가 “argument list too long”으로 실패하던 문제 수정.
  • worktree 격리 서브에이전트가 자기 worktree 대신 부모 체크아웃에서 셸 명령을 실행하던 문제 수정.
  • 다중 리포 워크스페이스에서 worktree 생성이 중첩 리포를 거부해 백그라운드 세션이 격리와 편집을 못 하던 문제 수정.
  • WorktreeCreate 훅이 설정된 상태에서 비-git 디렉토리에서 시작한 백그라운드 세션이 파일을 편집하지 못하던 문제 수정.
  • claude agents@ 디렉토리 선택기가 등록된 git worktree를 보여주지 않던 문제 수정.

터미널과 표시

  • 긴 transcript 히스토리를 위로 스크롤할 때 내용이 튀던 문제 수정.
  • bash 모드에서 셸 히스토리 제안이 표시된 채 입력하면 터미널이 깜빡이고 튀던 문제 수정.
  • 백그라운드 세션에 다시 연결할 때 리터럴 ^[[I / ^[[O escape 코드가 출력되던 문제 수정.

플러그인

  • LSP 전용 플러그인이 언어 서버가 진단을 제공하거나 탐색 요청에 응답하는데도 미사용으로 잘못 표시되던 문제 수정.

알아두면 좋은 점

  • 좌측 화살표 대신 Esc — 백그라운드 작업, diff, 워크플로 상세 뷰는 이제 좌측 화살표로 닫히지 않습니다. 뷰를 벗어나려면 Esc를 누릅니다.
  • 시작 경고 위치가 바뀜 — “claude command missing or broken” 경고는 시작 화면에서 사라지고 /doctor/status에서 확인합니다. 경고가 안 보인다고 문제가 없어진 것은 아니므로, 설치가 의심되면 /doctor를 확인하세요.
  • 로그인 만료 경고 활용 — 백그라운드 세션을 오래 돌린다면 로그인 만료 경고가 뜰 때 미리 다시 인증하면 세션이 끊기지 않습니다.
  • 셸 환경변수를 쓰는 백그라운드 세션 재확인ANTHROPIC_BASE_URL이나 PATH를 셸에서 export해 쓰던 환경이라면, 이번 수정으로 백그라운드 세션에도 올바르게 전달됩니다. 이전에 401 오류나 도구 누락을 겪었다면 업데이트 후 해소됩니다.