2026년 8월 3주차 Claude Code 업데이트 (v2.1.227 ~ v2.1.233)

v2.1.227: 세션·Bash·/tui 버그 수정 및 슬래시 메뉴·성능 개선 · v2.1.228: 세션·도구·자격 증명 처리와 안정성이 전반적으로 개선됨 · v2.1.231: 사전 등록 OAuth 서버의 리디렉션 URI 불일치 수정 · v2.1.232: 서브에이전트 포크 기본화와 원격 제어·보안 개선 · v2.1.233: GitLab MR 지원 추가와…

Claude Code release notes cover image

이번 주 요약

  • v2.1.227 — 세션·Bash·/tui 버그 수정 및 슬래시 메뉴·성능 개선
  • v2.1.228 — 세션·도구·자격 증명 처리와 안정성이 전반적으로 개선됨
  • v2.1.231 — 사전 등록 OAuth 서버의 리디렉션 URI 불일치 수정
  • v2.1.232 — 서브에이전트 포크 기본화와 원격 제어·보안 개선
  • v2.1.233 — GitLab MR 지원 추가와 주요 버그·도구 변경

v2.1.227 — v2.1.227

공개일: 2026-08-11 · 원문 보기

변경 사항

  • 만료된 로그인 토큰으로 세션이 시작될 때 사용자의 구독 등급 없이 기능 플래그가 평가되던 문제를 수정했습니다. 이로 인해 Max 플랜 사용자에게 Fable 사용 크레딧을 활성화하라는 잘못된 안내가 표시될 수 있었습니다.
  • GitHub 호스팅 러너에서 allowed_non_write_users가 설정된 claude-code-action 아래 모든 Bash 명령이 실패하던 문제를 수정했습니다.
  • 첫 메시지 이전으로 되감긴 대화를 /tui가 다시 불러오던 문제를 수정했습니다.
  • 슬래시 명령 메뉴를 개선했습니다. 이제 파란색은 선택된 행만 표시하고, 일치하는 문자는 색을 바꾸는 대신 굵게 표시되며, 이모지나 악센트가 있는 이름은 글리프를 유지합니다.
  • 성능을 개선했습니다. 파일 없음 제안과 @멘션 크기 검사에서 이벤트 루프 정지가 더 적어졌습니다.

v2.1.228 — v2.1.228

공개일: 2026-08-12 · 원문 보기

변경 사항

  • 드물게 발생하는 내부 레이아웃 오류 이후 프로세스는 계속 실행되는데 인터랙티브 세션의 다시 그리기가 완전히 멈출 수 있던 문제를 수정했습니다.
  • Claude Code를 git 설치 경로의 상위 폴더에서 실행할 때 Windows에서 git / Git Bash를 찾지 못하던 문제를 수정했습니다.
  • 마지막 응답 이후 /model이 변경된 상태에서 /tui를 실행하면 세션이 이전 모델로 되돌아가던 문제를 수정했습니다.
  • 설치 또는 업그레이드 후 첫 번째 세션에서 크로스 세션 메시징이 때때로 받은 편지함 없이 시작되던 문제를 수정했습니다.
  • 연결된 상태에서 Remote Control의 /resume를 사용하면 재개된 대화의 제목이나 기록이 연결된 세션으로 유출되던 문제를 수정했습니다.
  • 세션이 푸시하지 않는 저장소에서 checkout 훅이 실패할 때 모든 새 러너에서 claude self-hosted-runner 세션이 실패하던 문제를 수정했습니다. 이제 해당 저장소는 경고와 함께 건너뜁니다.
  • 백그라운드 작업이 완료된 뒤 후속 턴이 시작되기 전의 간격에서 self-hosted runner가 세션을 종료하던 문제를 수정했습니다.
  • 세션 정리가 프로젝트의 memory 폴더 내부 콘텐츠를 삭제하던 문제를 수정했습니다.
  • 백그라운드 plugin-cache 정리가 유일한 버전이 심볼릭 링크된 개발 체크아웃인 플러그인의 캐시를 삭제하던 문제를 수정했습니다.
  • 우선순위가 더 높은 settings 계층에서 다시 정의된 marketplace 항목이 다른 계층의 사용자 지정 헤더를 상속할 수 있던 settings 병합 문제를 수정했습니다. 이제 marketplace 항목은 전체 항목으로 병합됩니다.
  • 지연된 도구(deferred-tools) 알림이 skill 호출 후 때때로 모델에 두 번 전송되던 문제를 수정했습니다.
  • claude.ai에서 동기화된 skills를 강화했습니다. 이제 로컬 명령어나 MCP prompt를 가리지 않으며, 설명은 정제되고 라벨이 붙고, 사용자의 머신에서는 본문이 ! 명령을 실행하거나 @ 파일을 확장하지 않습니다.
  • 크로스 세션 메시지를 개선했습니다. 보낸 사람과 본문이 접힌 한 줄 대신 인라인으로 표시되며, 다른 머신의 Remote Control 세션으로 보내는 메시지는 보낸 사람으로 사용자의 Remote Control 세션 이름을 표시합니다.
  • Vertex AI 자격 증명 처리를 개선했습니다. 만료되었거나 누락된 Google Cloud 자격 증명은 이제 몇 분 동안 재시도하지 않고 몇 초 내에 실패합니다.
  • 컴팩션 진행 표시를 개선했습니다. 재시도 카운트다운과 정체 힌트가 이제 진행 바만이 아니라 컴팩션 중에도 표시됩니다.
  • 일부 터미널에서 탭 바의 흔들림을 줄이기 위해 터미널 제목의 busy-spinner glyph를 업데이트했습니다.
  • Write 도구를 변경하여 더 최신 모델은 이번 세션에서 읽지 않은 기존 파일도 덮어쓸 수 있게 했습니다. 이는 Edit 도구의 규칙과 일치합니다. 더 오래된 모델은 여전히 먼저 읽기가 필요합니다.
  • Pro, Max, Team 플랜의 첫 사용 안내에서 auto mode 세션이 약간 더 비용이 든다는 오래된 주석을 제거했습니다.

v2.1.231 — v2.1.231

공개일: 2026-08-13 · 원문 보기

변경 사항

  • Slack과 같이 사전 등록된 OAuth 클라이언트를 사용하는 서버에서, 리디렉션 URI 불일치로 인해 실패하던 MCP OAuth 로그인 문제를 수정했습니다.

v2.1.232 — v2.1.232

공개일: 2026-08-14 · 원문 보기

변경 사항

  • 서브에이전트 포크가 이제 기본값입니다: subagent_type: "fork" 서브에이전트는 전체 대화와 프롬프트 캐시를 상속하며, 대화형 세션에서 팀원이 아닌 에이전트 생성은 이제 기본적으로 백그라운드에서 실행됩니다
  • 프롬프트에서 @를 입력해 다른 Claude 세션을 이름으로 멘션할 수 있습니다. 그러면 Claude가 SendMessage를 사용해 해당 세션에 직접 도달합니다
  • SendMessage는 이제 확인을 위해 ref를 묻는 대신, 하나의 활성 세션과 정확히 일치하는 bare name으로 전달합니다
  • 한 머신의 대화형 세션은 이제 고유한 이름을 유지합니다: 이미 다른 활성 세션이 사용 중인 이름으로 세션을 시작하거나 이름을 바꾸면 name-word-word 변형이 부여되고 이를 알려줍니다
  • /config에 “Dialog expiry”와 “Messages from your other sessions”(세션 간 수신 accept/hold/refuse) 행이 추가되었습니다
  • GitLab 토큰 계열(glrt-, gloas-, glptt-, glagent-, glimt-, glsoat-, glcbt-, glft-, glffct-)에 대한 비밀값 마스킹과, 라우팅 가능한 glpat-/gldt- 토큰의 전체 마스킹이 추가되었습니다. glab CLI 구성 저장소는 gh와 동일한 샌드박스 및 자격 증명 경로 보호를 받습니다
  • 플러그인 마켓플레이스에 GitLab 지원이 추가되었습니다: bare gitlab.com 저장소 URL(중첩된 서브그룹 포함)은 이제 github.com URL처럼 클론되며, 클론 인증 실패 힌트는 실제 git 호스트 이름을 표시합니다
  • 설정: additionalMarketplacesallowedMarketplaces가 이제 extraKnownMarketplacesstrictKnownMarketplaces의 더 친숙한 별칭으로 허용됩니다
  • 엔터프라이즈 정책: bare repo URL에 대한 url-typed blockedMarketplaces 항목은 CLI가 이를 git clone으로 분류할 때도 해당 URL 차단을 유지합니다
  • Gateway: desktop: 오버레이가 이제 출시된 모든 Desktop 설정을 허용합니다(기존에는 11개의 키를 수동으로 나열). 부팅 시 Desktop 자체 스키마로 검증되며, 알 수 없거나 유효하지 않은 키는 부팅 실패를 일으킵니다
  • Gateway: 비어 있는 managed.policies[].match.groups/admin.admin_groups 항목과 형식이 잘못된 email_domain 값(비어 있음, 또는 @, 공백, 쉼표 포함)은 이제 조용히 아무도 매치하지 않거나 관리자 권한을 부여하는 대신 부팅 실패를 일으킵니다
  • Fable 접근 권한이 있는 조직에서는 Fable 5가 /advisor에서 다시 advisor로 제공되며, 사용 크레딧 동의는 /model fable을 통해 설정됩니다
  • 변수 쓰기 매개변수가 조용히 $PSDefaultParameterValues를 덮어쓰고 이후 명령의 파일 접근을 다른 곳으로 돌릴 수 있던 PowerShell 권한 우회 문제가 수정되었습니다
  • 경로 검증에서는 일반 파일로 보이던 Cygwin 스타일 심볼릭 링크를 Git Bash가 따라가던 Windows 권한 우회 문제가 수정되었습니다. 이제 이를 통한 쓰기에는 권한 승인이 필요합니다
  • 상위 디렉터리로부터 신뢰를 상속하던 중첩 git 저장소 문제가 수정되었습니다. 각 저장소는 이제 자체 신뢰 확인이 필요합니다
  • 서버가 응답하지 않거나 프로토콜 버전 프로브에 잘못된 응답을 보낼 때 MCP 연결이 전체 30초 연결 타임아웃 동안 멈추던 문제가 수정되었습니다
  • 클라우드 세션 내부의 브리지에서 호스팅되는 Remote Control 세션이 해당 세션의 전사본(transcript)이나 자격 증명을 상속하던 문제가 수정되었습니다
  • Claude Desktop이나 IDE에서 시작된 Remote Control 세션이 로컬 세션이 재개될 때마다 새 claude.ai 세션처럼 보이던 문제가 수정되었습니다. 이제 기존 세션에 다시 연결됩니다
  • 유휴 상태인 새로 연결된 클라이언트에게 Remote Control 세션이 도달 불가한 것처럼 보이던 문제가 수정되었습니다
  • Remote Control 브리지 세션이 세션 워커 재시작 후 대화 기록을 복원하지 못하던 문제가 수정되었습니다
  • Remote Control: claude.ai 또는 앱에서 세션이 삭제된 대화를 재개할 때 이제 로그인에 관한 메시지로 실패하는 대신 대체 세션을 시작합니다(v2.1.227에서 회귀)
  • 관리 설정 로드에 실패했을 때 Cloud gateway /login이 조용히 종료되거나 “Press Enter to continue” 이후 응답 없는 터미널을 남기던 문제가 수정되었습니다. 이제 그 이유가 표시됩니다
  • 네이티브 빌드의 음성 모드가 음성 서비스가 연결을 거부했을 때 “listening…”에서 멈추던 문제가 수정되었습니다. 이제 거부가 즉시 표시됩니다
  • mTLS 클라이언트 인증서 교체에 재시작이 필요하던 문제가 수정되었습니다. 이제 Claude Code가 연결 오류 시 교체된 인증서와 키를 자동으로 다시 로드합니다
  • 잘못된 AWS 또는 Vertex 리전 값이 요청 URL을 구성하는 데 사용되던 문제가 수정되었습니다. 이제 기본 리전으로 되돌아갑니다
  • 스트림 유휴 타임아웃 오류가 Bedrock, Vertex, gateway 배포에서 요청을 실패시키던 문제가 수정되었습니다. 이제 복구합니다
  • 잘린 텍스트를 포함한 content-sized 오버레이가 한 컬럼 더 넓게 렌더링되고, 시작이 잘린 텍스트가 줄어들어 줄임표로 보이던 문제가 수정되었습니다
  • 긴 셸 명령 또는 에이전트 설명 미리보기가 이모지 중간에서 잘릴 때 남던 깨진 문자가 수정되었습니다
  • known_marketplaces.json에 대한 동시 쓰기 때문에 시작 시 경쟁 상태가 플러그인 마켓플레이스를 조용히 등록 해제할 수 있던 문제가 수정되었습니다
  • 다시 시작해도 유지되는 작업이 실행 중일 때 /update/tui가 재시작을 거부하던 문제가 수정되었습니다
  • SDK 및 원격 세션에서 사용할 수 없는 슬래시 명령을 제안하던 사용량 제한 안내가 수정되었습니다
  • 대화형 --advisor fable 시작의 동의 메시지가, 막 종료된 대화형 세션에서 /model fable을 실행하라고 안내하던 문제가 수정되었습니다
  • 전체 화면 스트리밍이 개선되었습니다: 긴 세션은 모든 업데이트마다 전체 대화가 다시 정규화되지 않으므로 더 반응성이 유지됩니다
  • 관리 설정 승인 대화상자가 개선되었습니다: 엔드포인트 URL을 표시하고, 텔레메트리 전용 변경에 대해 더 명확한 표현을 사용하며, 일반적인 OpenTelemetry 옵션은 건너뛰고, 서버가 관리하는 샌드박스 바이너리 오버라이드(sandbox.bwrapPath, sandbox.socatPath, sandbox.ripgrep)에는 승인이 필요합니다
  • Claude가 응답 중일 때 호출하면 /feedback/bug가 턴이 끝날 때까지 기다리지 않고 즉시 열립니다
  • /plugin install plugin@marketplace가 이제 먼저 마켓플레이스를 새로고침하므로, 새로 게시된 플러그인이 수동 마켓플레이스 업데이트 없이 설치됩니다
  • 높은, xhigh, max 노력 수준의 /code-review가 이제 다른 수준처럼 백그라운드 에이전트에서 실행됩니다
  • 붙여넣기 및 클립보드 이미지를 이벤트 루프를 막지 않고 읽습니다
  • Remote Control은 이제 네트워크 순간 끊김 후 약 30분 동안 재연결을 계속하며, 한 시간에 걸쳐 몇 번의 순간 끊김이 있어도 더 이상 끊어지지 않습니다
  • Remote Control: 대화를 재개해도 같은 머신의 다른 Claude Code가 이미 가지고 있던 Remote Control을 조용히 빼앗지 않습니다. 이를 옮기려면 그쪽에서 /remote-control을 실행하세요
  • 에이전트 패널이 업데이트되었습니다: 완료된 서브에이전트는 /tasks 바닥글 힌트와 함께 즉시 숨겨지며, “↓ N more” 오버플로 표시기는 가시성을 위해 왼쪽으로 이동했습니다
  • Remote Control: 이제 터미널에 세션이 다른 기기에 의해 인계되었는지, 다른 앱에서 종료되었는지, 또는 삭제되었는지를 표시하며, 이를 되돌릴 재연결을 더 이상 제안하지 않습니다
  • Bash 입력 리디렉션(`< file)은 이제 모든 플랫폼에서 인자 표기와 마찬가지로 권한 검사를 받습니다
  • 완료된 백그라운드 에이전트를 재개할 때 표시되는 메시지가 더 짧아졌습니다
  • Cowork 세션은 더 이상 사용자 범위 메모리 파일에서 외부 @-import를 인라인하지 않습니다
  • 공유 /tmp에서 자동 생성되는 세션 간 메시징 소켓 디렉터리가 강화되었습니다: 미리 심어진 심볼릭 링크나 다른 사용자의 디렉터리는 이제 사용하지 않고 거부합니다
  • Linux 파일시스템 샌드박스의 보호된 경로 우회가 강화되었습니다
  • sandbox.ripgrep은 이제 사용자, 관리, --settings 설정에서만 적용되도록 변경되었습니다. 프로젝트 설정은 더 이상 샌드박스의 ripgrep 바이너리를 덮어쓸 수 없습니다
  • 사용자 지정 서브에이전트를 만들라는 시작 팁과 /powerup 투어의 대응 안내를 제거했습니다

v2.1.233 — v2.1.233

공개일: 2026-08-15 · 원문 보기

변경 사항

  • --worktree 플래그와 claude agents 뷰에 GitLab merge request URL 지원을 추가함(MR은 !N으로 표시됨)
  • Anthropic 업스트림에 옵트인 forward_user_identity 앱 게이트웨이 설정을 추가함. 로그인한 사용자의 신원을 헤더로 보내므로, 게이트웨이 뒤의 프록시가 사용자별 지출을 귀속할 수 있음
  • Linux의 Bash 도구 명령에 대한 옵트인 메모리 cgroup 지원을 추가함(CLAUDE_CODE_TOOL_MEMORY_LIMIT). 따라서 폭주하는 빌드가 세션을 멈추게 하지 않음
  • WebFetch 세션 URL 캐시 TTL을 구성하는 CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS 환경 변수를 추가함(기본값은 변경 없음: 15분)
  • Claude가 권한 프롬프트를 기다리는 동안 환경이 종료될 때 클라우드 세션이 때때로 손실된 것으로 표시되던 문제를 수정함
  • 고정 시간 제한으로 장시간 유지되는 스트림을 종료하는 서버(예: 서버리스 호스트)를 상대로 MCP v2 연결이 subscriptions/listen 스트림을 끝없이 다시 열던 문제를 수정함
  • Claude Desktop 또는 VS Code에서 실행할 때 권한 프롬프트에 대해 Notification hooks가 실행되지 않던 문제를 수정함
  • 샌드박싱이 활성화된 경우 Linux의 유휴 세션이 때때로 CPU 코어 하나를 100%로 유지하던 문제를 수정함
  • 번들된 스킬 별칭(/checkup, /review 등)이 사용자 또는 프로젝트 스킬이 번들 스킬을 가릴 때 -p 모드나 플러그인/MCP 로드 상태에서 "Unknown command"를 보고하던 문제를 수정함
  • 스킬/명령 인자 대체를 수정하여 인자 값이 템플릿 마커로 다시 확장되지 않도록 함
  • NT \??\ 장치 접두사로 표기된 Windows 경로가 UNC 경로 검증을 우회하던 문제를 수정하여, NTLM 자격 증명 유출 벡터를 차단함
  • claude self-hosted-runner의 세션 시작 시간을 개선함: 이제 작업 트리를 다시 쓰지 않고 세션 브랜치가 생성되며, 서버 왕복 2번이 더 이상 에이전트 시작을 막지 않음
  • 앱 게이트웨이 오류 전달을 개선함: Vertex, Foundry, 그리고 Claude Platform on AWS 업스트림의 400/413 오류가 이제 업스트림 자체 메시지를 그대로 포함함. 앱 게이트웨이의 auto-compact 관련 버그를 수정함
  • .claude/skills의 bare 디렉터리를 검사하고, frontmatter 파싱에 실패한 SKILL.md 파일을 보고하도록 claude plugin validate를 개선함
  • 화면 읽기 모드를 개선함: /effort 선택기가 번호가 매겨진 목록과 숫자 입력 프롬프트로 렌더링되며, 힌트 및 대화 상자 텍스트가 더 이상 잘리지 않음
  • 출력 모드 진단을 개선함: Claude Code가 인식하지 못하는 모델 ID로 요청이 나갈 때 stderr에 [claude-code:unrecognized_model] 줄을 기록함. 이를 숨기려면 modelOverrides로 매핑할 것
  • GitHub 앱 설정 팁이 origin 원격이 gitlab.com 또는 bitbucket.org인 저장소에서는 더 이상 표시되지 않도록 변경함. 이제 enterprise marketplace 팁이 GitHub가 아닌 내부 git 호스트를 포함해 다룸
  • Todo/작업 추적 도구(TaskCreate/Get/Update/List, TodoWrite)는 더 이상 Opus 4.8, Sonnet 5, Fable 5, Mythos 5 및 그 이후 모델에서 사용할 수 없음. 다시 사용하려면 CLAUDE_CODE_ENABLE_TODO_TOOLS=1을 설정할 것
  • Windows: 일반적인 cd && > file Bash 명령에서 자동 모드가 수동 승인을 반복해서 멈추던 문제를 수정함(2.1.232 회귀)
  • Windows에서 Cygwin 스타일 심볼릭 링크와 입력 리디렉션( < file`)에 대한 2.1.232 Bash 권한 변경을 되돌림. 더 좁은 버전은 이후 릴리스에서 돌아올 예정임

이 글은 Claude Code 공식 릴리스 노트를 자동 번역·요약한 결과입니다. 원문은 GitHub releases에서 확인할 수 있습니다.

@robocom

정리를 위해 작성하는 개인노트