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

Claude Code 2.1.198

Claude in Chrome이 정식 출시(GA)됐고, 입력이 필요하거나 완료된 백그라운드 에이전트가 Notification 훅을 발생시키며, 차트와 대시보드 디자인을 돕는 `/dataviz` 스킬이 추가됐습니다. `claude agents`로 실행한 백그라운드 에이전트는 worktree 작업을 마치면 커밋, 푸시, 드래프트 PR까지 스스로 진행하고, 내장 Explore 에이전트가 haiku 대신 메인 세션 모델(opus 상한)을 상속합니다. 응답 도중 짧은 네트워크 끊김이 턴을 중단시키던 문제, 백그라운드 작업이 완료 후에도 'Running'에 멈춰 있던 문제 등 다수의 버그가 수정됐습니다.

Claude Code
공식 발표 →

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

무엇이 바뀌었나?

Claude Code 2.1.198이 2026년 7월 1일 출시됐습니다. Claude in Chrome 정식 출시, 백그라운드 에이전트 알림, /dataviz 스킬 같은 새 기능이 추가됐고, 백그라운드 에이전트가 worktree 작업을 마치면 커밋, 푸시, 드래프트 PR까지 진행하도록 개선됐습니다. 네트워크 끊김 복구, 백그라운드 작업 상태 표시, 에이전트 팀 등 여러 영역의 버그가 정리됐습니다.

새 기능

  • Claude in Chrome 정식 출시(GA)

    Claude in Chrome이 정식 출시됐습니다. 브라우저에서 Claude가 페이지를 읽고 조작하는 기능을 프리뷰 단계를 지나 정식으로 사용할 수 있습니다.

  • 백그라운드 에이전트 알림

    claude agents로 실행한 백그라운드 에이전트는 입력이 필요하거나 작업을 끝내도 사용자가 직접 창을 열어 확인해야 알 수 있었습니다. 이제 이런 상황에서 Notification 훅이 발생하며(agent_needs_input / agent_completed), 훅으로 알림을 받을 수 있습니다.

  • /dataviz 스킬

    차트와 대시보드를 디자인할 때 색상, 구성 같은 판단을 사용자가 직접 해야 했습니다. /dataviz 스킬이 추가돼 차트와 대시보드 디자인 안내를 제공하며, 실행 가능한 색상 팔레트 검증기(color-palette validator)가 함께 들어갑니다.

  • Gateway: Claude Platform on AWS 업스트림 프로바이더

    Gateway에 업스트림 프로바이더로 Claude Platform on AWS(anthropicAws)가 추가됐습니다. 또한 model-not-found 응답이 나오면 다음 프로바이더로 failover 체인이 진행됩니다.

주요 개선

  • 백그라운드 에이전트의 자동 커밋, 푸시, 드래프트 PR

    claude agents로 실행한 백그라운드 에이전트는 worktree에서 코드 작업을 끝낸 뒤 멈춰서 사용자에게 다음 동작을 물었습니다. 이제 작업을 마치면 커밋, 푸시, 드래프트 PR 생성까지 스스로 진행합니다.

  • Explore 에이전트가 메인 세션 모델 상속

    내장 Explore 에이전트가 haiku에서 동작해 탐색 품질이 제한됐습니다. 이제 메인 세션의 모델을 상속하며(opus 상한), 위임된 탐색 작업의 품질이 개선됩니다.

  • 서브에이전트, 컨텍스트 압축이 확장 사고 설정 상속

    서브에이전트와 컨텍스트 압축(compaction)은 세션의 확장 사고(extended thinking) 설정을 반영하지 않았습니다. 이제 이 설정을 상속해, 위임된 작업의 출력 품질이 개선됩니다.

  • /agents 마법사 제거

    서브에이전트 생성, 관리를 별도의 /agents 마법사로 진행했습니다. 이 마법사는 제거됐으며, 이제 Claude에게 서브에이전트 생성, 관리를 요청하거나 .claude/agents/를 직접 편집합니다.

  • 하이라이팅, 재시도 UX 개선

    코드 블록, diff, 파일 미리보기의 구문 하이라이팅이 highlight.js 11로 업그레이드돼 정확도가 높아졌습니다. API 재시도 시에는 두 번째 시도 이후 오류 원인이 표시되고, API 과부하 시 스피너 팁 대신 상태 페이지 링크가 나옵니다.

주요 버그 수정

네트워크와 연결

  • 응답 도중 짧은 네트워크 끊김이 턴을 중단시키던 문제 — ECONNRESET 같은 일시적 오류가 이제 백오프와 함께 재시도됩니다.
  • Claude Platform on AWS, Mantle 세션이 STS 토큰 만료 시 “Please run /login”으로 막히던 문제 수정 — awsAuthRefresh가 자동으로 실행됩니다.
  • macOS 백그라운드 에이전트 세션에서 로컬 네트워크 호스트에 “no route to host”가 나던 문제 수정 — Local Network 권한(entitlements)을 선언했습니다.
  • macOS에서 agents view를 열어둔 동안 백그라운드 에이전트가 약 52초마다 “Reconnecting…”을 반복 표시하던 문제 수정.
  • 샌드박스 프로세스가 같은 네트워크 호스트에 반복 접근할 때 백그라운드 분류기 요청이 과다 발생하던 문제 수정.

백그라운드 작업과 에이전트

  • 웹, 데스크톱, VS Code 작업 패널에서 백그라운드 작업이 완료 후나 세션 재개 후에도 “Running”에 멈춰 있던 문제 수정.
  • 에이전트 팀에서 팀원이 API 오류로 죽으면 리드에게 “failed”로 보고되고, 멈춘 팀원에게 메시지를 보내면 즉시 깨어나 재시도하도록 수정.
  • claude --bg를 --print/-p와 함께 쓰면 attach 불가능한 세션이 조용히 생성되던 문제 수정 — 충돌하는 플래그를 앞단에서 거부합니다.
  • SDK, 데스크톱 앱 세션에서 워크플로 진행 뷰가 가장 먼저 실행된 에이전트를 목록에서 누락하던 문제 수정(단계 카운터는 정상).
  • claude attach <id> 안에서 ←를 누르면 agent view가 아니라 셸로 빠져나가던 문제 수정.

UI와 렌더링

  • 풀스크린 모드에서 마크다운 테이블이 오른쪽 테두리를 넘쳐 줄바꿈되던 문제 수정.
  • /diff 패널이 브랜치를 바꾸거나 세션 밖에서 커밋해도 갱신되지 않던 문제 수정.
  • macOS Warp 풀스크린 모드에서 Cmd+클릭으로 URL이 열리지 않던 문제와 더블클릭 단어 선택이 스킴(scheme)을 포함한 전체 URL을 선택하도록 수정.

명령과 설정

  • plan mode로 시작한 세션에서 읽기 전용 도구 호출이 자동 허용되지 않던 문제 수정.
  • .claude/rules/의 조건부 규칙이 심볼릭 링크 경로로 도달한 파일에서는 로드되지 않던 문제 수정.
  • worktree에 들어갔다 나온 뒤 /desktop이 “Cannot determine working directory”로 실패하던 문제 수정.
  • /branch가 기본 fork 이름을 첫 실제 프롬프트가 아니라 압축 요약에서 가져오던 문제 수정.

알아두면 좋은 점

  • /agents 마법사 제거 — 서브에이전트는 Claude에게 생성, 관리를 요청하거나 .claude/agents/를 직접 편집합니다.
  • 서브에이전트의 메시지 처리 — 서브에이전트는 자신을 실행한 에이전트의 메시지를 일반 작업 지시로 취급합니다. 다만 에이전트의 메시지가 사용자의 승인으로 간주되지는 않습니다.
  • Mac SSH 접속 시 단축키 표기 — Mac에서 SSH로 접속하면 단축키 힌트가 alt/super 대신 opt/cmd로 표시됩니다.