What's New

종합

Claude Code 공식 CHANGELOG 기반 최신 업데이트

20분 소요마지막 수정: 2026-03-10

v2.1.226

버그 수정 및 안정성 개선

v2.1.225

게이트웨이 지출 한도 지원 추가 — Claude Code의 사용량 경고에 게이트웨이 지출 한도 지원 추가. 한도 도달 메시지에 상한선, 재설정 시간, 운영자 메시지가 표시됨 (게이트웨이 2.1.225 필요)
claude agents에 워크스페이스 신뢰 프롬프트 추가 — 신뢰할 수 없는 디렉토리에 대해 claude의 동작과 일치하도록 claude agents에 워크스페이스 신뢰 프롬프트 추가
401 오류 수정 — 장기 CLAUDE_CODE_OAUTH_TOKEN이 저장된 로그인 세션의 단기 토큰으로 교체될 때 발생하던 일시적인 401 오류 수정. 재시작 전까지 헤드리스 세션이 중단되던 문제 해결
macOS MCP OAuth 서버 오류 수정 — macOS에서 MCP OAuth 서버가 키체인 읽기 시간 초과 후 인증되지 않은 것처럼 401 오류가 간헐적으로 발생하던 문제 수정
자동 모드 안전 필터 수정 — 자동 모드가 자체 권한 확인에 대한 안전 필터 거부를 연속 차단 한도에 포함시키던 문제 수정. 작업은 여전히 거부되지만, 모델은 이제 재시도 대신 다음으로 진행하도록 지시받음
크로스 세션 메시지 수정 — 헤드리스 세션 및 시작 시 크로스 세션 메시지가 알림이나 만료 없이 유지되던 문제 수정
원격 제어 대화 기록 수정 — 매우 큰 대화가 압축된 후 원격 제어 세션 재개 시 대화 기록이 깨지던 문제 수정
에이전트 목록 호버링 수정 — 에이전트 목록에서 다른 프로젝트의 세션 위로 마우스를 올리면 다음 에이전트가 시작되는 디렉토리가 변경되던 문제 수정
claude self-hosted-runner 오류 수정 — --base-dir을 생성하거나 쓸 수 없을 때 claude self-hosted-runner가 등록 후 모든 세션에서 실패하던 문제 수정. 이제 시작 시 명확한 오류와 함께 종료됨
웹 세션 오보고 수정 — 웹에서 Claude Code 세션이 멈춘 것으로 잘못 보고되고, 재연결 시 증가하는 이벤트 백로그를 재전송하던 문제 수정
원격 제어 개선 — Claude 앱에서 첨부된 사진이 별도의 도구 호출로 디스크에서 읽는 대신 Claude에 직접 표시됨
[VSCode] 포커스 뷰 수정 — 포커스 뷰가 최신 할 일 목록, 보류 중인 질문의 컨텍스트, 확정된 답변을 접어버리던 문제 수정. 생각 중인 폴드만 "Thought for Ns"를 표시하고 턴이 완료되면 다시 접힘
SendMessage 개선 — 이제 SendMessage를 사용하여 다른 기기의 원격 제어 세션과 이름으로 대화를 시작할 수 있음 (ListAgents는 name [ref]로 표시). 이전에는 먼저 메시지를 보내야만 답장할 수 있었음
SendMessage 수신자 확인 개선 — 이미 확인한 원격 제어 수신자가 자체 목록을 확인할 수 없을 때 이 기기의 동일한 이름의 세션으로 교체되지 않음

v2.1.224

자체 호스팅 환경 추가 — claude self-hosted-runner를 통해 팀 및 엔터프라이즈 플랜에서 자신의 머신 또는 컨테이너를 Claude Code 웹, 모바일, 데스크톱 세션을 실행할 수 있는 장소로 전환할 수 있음
archive 플러그인 소스 추가 — git 또는 npm 없이 HTTPS를 통해 zip 파일에서 플러그인을 설치할 수 있으며, 선택적으로 SHA-256 고정 가능
붙여넣기 제거 시 취소 및 확인 단계 추가 — 사용할 수 없는 붙여넣기를 제거하여 명령 텍스트가 변경될 때 취소 및 확인 단계 추가
ANTHROPIC_BEDROCK_REGION_PREFIX 환경 변수 추가 — Bedrock이 AWS_REGION에서 파생된 프로필보다 특정 교차 지역 추론 프로필을 선호하도록 ANTHROPIC_BEDROCK_REGION_PREFIX 환경 변수 추가
crossSessionInbound 및 dialogExpiry 설정 추가 — 권한이 우회된 세션으로 전송된 크로스 세션 메시지는 승인을 위해 보류되고, 다른 세션으로 전송된 메시지는 자동 전달됨
샌드박스 자격 증명 마스킹 옵션 추가 — 구조화된 환경 변수 값에 대한 extract 및 onExtractNoMatch, JWT 인식 마스킹에 대한 maskClaims가 있는 decode: "jwt", AWS SigV4 재서명에 대한 awsPairs/sigv4 추가. 이 옵션은 network.tlsTerminate가 필요하며 사용자, 관리 또는 --settings 설정에서만 적용됨
크로스 세션 SendMessage 추가 — Claude Code 세션은 이제 ListAgents를 사용하여 서로를 검색하고 메시지를 주고받을 수 있음 (macOS 및 Linux)
긴 프로젝트 경로 수정 — 200자 초과 프로젝트 경로가 공유된 정리된 접두사 아래 다른 프로젝트의 세션 디렉토리로 확인되던 문제 수정. 세션 목록, 이름 변경, 포크, 삭제 및 /resume은 더 이상 프로젝트를 교차하지 않음
SendMessage 보고 오류 수정 — SendMessage가 팀원의 받은 편지함에 쓰기 작업이 실제로 실패했을 때 "Message sent"를 보고하던 문제 수정. 실패한 전달은 이제 오류로 보고됨
샌드박스 파일 시스템 거부 항목 수정 — 후행 슬래시(예: denyRead: "~/.aws/")로 작성된 샌드박스 파일 시스템 거부 항목이 Linux 및 macOS에서 조용히 우회 가능하던 문제 수정
샌드박스 위반 세부 정보 수정 — Bash 도구 결과에 샌드박스 위반 세부 정보가 나타나지 않던 문제 수정. Claude는 이제 어떤 파일 또는 네트워크 액세스가 거부되었는지와 그 이유를 확인 가능
MCP 도구 지연 수정 — 턴 중간에 연결되는 MCP 도구가 모델에 이름이 발표되지 않은 채 도구 검색을 위해 지연되던 문제 수정
플러그인 설치 기록 수정 — 동일한 플러그인이 여러 프로젝트에 설치될 때 플러그인 설치 기록이 조용히 손상되던 문제 수정
붙여넣기 내용 복구 수정 — 붙여넣기가 만료되었거나 플레이스홀더 번호가 충돌했을 때, 회수되거나 복원된 붙여넣기 내용이 때때로 잘못된 데이터를 첨부하거나 텍스트를 조용히 손실하던 문제 수정
Wayland 복사-선택 수정 — Wayland에서 선택 시 복사가 때때로 클립보드에 도달하지 않던 문제 수정. 두 선택 쓰기 작업이 더 이상 경쟁하지 않음
피드백 설문조사 기록 공유 수정 — 긴 세션에서 피드백 설문조사의 기록 공유가 조용히 실패하던 문제 수정. 실패한 공유는 이제 성공 메시지 대신 오류를 표시함
원격 제어 자동 시작 수정 — 오래된 로그인 토큰으로 콜드 스타트 시 원격 제어 자동 시작이 간헐적으로 "Remote credentials fetch failed"와 함께 실패하던 문제 수정
원격 제어 및 SDK 클라이언트 메시지 수정 — /clear 및 기타 출력 없는 명령 후 원격 제어 및 SDK 클라이언트가 빈 "(no content)" 메시지를 표시하던 문제 수정
원격 제어 세션 기록 업로드 수정 — 서버 세션이 만료된 후 다시 생성된 원격 제어 세션이 이전 로컬 대화 기록을 새 세션으로 업로드하던 문제 수정
전체 화면 모드 개선 — 전체 화면 모드가 반복적인 압축 전의 전체 기록을 스크롤백에 유지하여, 가장 최근 간격만 유지하던 이전 방식 개선
원격 제어 압축 진행 상황 개선 — 원격 제어: 연결된 웹 및 모바일 클라이언트가 조용한 일시 중지 대신 압축 진행 상황과 압축 후 경계를 이제 확인 가능. /clear 재설정이 연결된 클라이언트로 전파됨
원격 제어 연결 실패 표시 개선 — 원격 제어: 연결 실패 시 8초 토스트 메시지 대신 세부 정보와 재연결 단축키가 있는 지속적인 실패 표시기가 표시됨
세션당 서브에이전트 생성 제한 제거 — 세션당 200개 서브에이전트 생성 제한이 제거됨. 장기 실행 세션이 더 이상 새 에이전트를 거부하지 않음 (동시성 및 깊이 제한은 여전히 적용됨)
관리되는 설정 변경 — 조직의 설정이 변경되지 않았을 때 재로그인 또는 조직 전환 후 승인 프롬프트가 다시 나타나지 않음
피드백 설문조사 기록 공유 변경

v2.1.207

자동 모드 (Auto mode) 기본 활성화 — Bedrock, Vertex AI, Foundry에서 CLAUDE_CODE_ENABLE_AUTO_MODE 옵트인 없이 자동 모드 사용 가능. 설정에서 disableAutoMode로 비활성화 가능
터미널 안정성 개선 — 매우 긴 목록, 테이블, 단락 또는 코드 블록을 스트리밍할 때 터미널 멈춤 및 키 입력 지연 문제 수정
원격 관리 설정 보안 수정 — 비대화형 실행(claude -p, SDK)에서 원격 관리 설정이 보안 동의 대화 상자 없이 영구적으로 동의로 기록되던 문제 수정
프롬프트 인젝션 경고 수정 — 시스템 생성 대화 업데이트로 인한 잘못된 프롬프트 인젝션 경고 수정
자동 업데이트 수정 — 매 릴리스마다 ~/.local/bin/claude의 사용자 지정 런처 스크립트 또는 심볼릭 링크를 덮어쓰던 문제 수정. /doctor는 이제 외부 관리 런처를 보고함
cd 복합 명령 권한 수정 — 유일한 출력 리디렉션이 /dev/null일 때 cd가 포함된 복합 명령이 권한을 요청하던 문제 수정
스크롤 위치 수정 — 응답 스트리밍 완료 시 트랜스크립트가 답변 시작 부분 위로 점프하던 문제 수정
Git 워크트리 설정 수정 — 마지막 worktree.sparsePaths 워크트리가 제거된 후 extensions.worktreeConfig가 리포지토리의 .git/config에 남아있던 문제 수정
파일 경로 패턴 수정 — 규칙 globs, 스킬 경로, .ignore, .worktreeinclude의 잘못된 괄호 패턴으로 인해 파일 읽기, 파일 제안, 워크트리 생성이 중단되던 문제 수정
에이전트 팀 충돌 수정 — 잘못된 팀원 메일박스 메시지로 인해 메일박스 파일이 수동으로 삭제될 때까지 매초 오류가 반복되던 에이전트 팀의 충돌 루프 수정
백그라운드 세션 이름 수정 — 계획 수락으로 자동 이름이 지정된 백그라운드 세션이 에이전트 뷰 행에 해당 이름을 표시하지 않던 문제 수정
백그라운드 세션 재개 수정 — Git 워크트리에 진입한 백그라운드 세션이 에이전트 목록에서 콜드 리오픈 후 빈 화면으로 재개되던 문제 수정
원격 제어 작업 상태 업데이트 수정 — 네트워크 중단 또는 자격 증명 새로 고침에서 연결이 복구될 때 원격 제어 작업 상태 업데이트가 손실되던 문제 수정
원격 제어 진행 상황 표시 수정 — 데스크톱 앱에서 호스팅되는 원격 제어 세션이 모바일 및 웹에서 백그라운드 에이전트 및 워크플로 진행 상황을 표시하지 않던 문제 수정
심층 연구 에이전트 이름 수정 — 심층 연구 실행에서 모든 Fetch 단계 에이전트가 "unknown"으로 레이블링되던 문제 수정. 이제 칩에 소스 호스트 이름이 표시됨
Bedrock AWS SSO 자격 증명 수정 — Bedrock이 모든 API 요청에서 IAM Identity Center로부터 새로운 AWS SSO 자격 증명을 반복적으로 요청하던 문제 수정
에이전트 뷰 개선 — 동일한 텍스트를 다시 붙여넣으면 접힌 [Pasted text #N] 플레이스홀더가 확장되고, 두 번째 플레이스홀더가 추가되지 않음
에이전트 뷰 개선 — 차단된 세션 엿보기(peeks)가 질문으로 시작하고 동일한 타임스탬프를 두 번 표시하는 대신 "waiting 3m"과 같은 단어화된 지연 시계를 표시함
기본 모델 변경 — Bedrock, Vertex 및 AWS의 Claude Platform이 기본적으로 Claude Opus 4.8을 사용하도록 변경됨
자동 모드 설정 경로 변경 — 자동 모드가 더 이상 .claude/settings.local.json (리포지토리 상주)에서 autoMode를 읽지 않음. 대신 ~/.claude/settings.json 사용
Windows AWS 자격 증명 해결 수정 — AWS 자격 증명 해결이 중단될 때(예: credential_process 고착) Windows에서 무한정 멈추던 문제 수정. 60초 중단 방지 가드가 이제 작동함
플러그인 훅/모니터/MCP headersHelper 보안 강화 — 셸 형식 명령에서 ${user_config.*}가 거부됨 (셸 인젝션 수정). 훅: exec 형식(args 배열) 또는 $CLAUDE_PLUGIN_OPTION_<KEY> 사용. 모니터 및 headersHelper: 스크립트 내부에서 값 읽기 (구성 파일 또는 서버의 env 블록)
플러그인 옵션 값 읽기 변경 — pluginConfigs가 더 이상 프로젝트 수준 .claude/settings.json에서 읽히지 않음. 사용자, --settings, 관리되는 설정만 적용됨
/usage-credits 입력 유효성 검사 — /usage-credits 금액 입력이 잘못된 값(예: 붙여넣은 타임스탬프)을 자동으로 숫자로 변환하던 문제 수정. 이제 잘못된 금액은 오류와 함께 거부되며, $1,000를 초과하는 금액은 입력 확인이 필요함

v2.1.206

/cd 디렉토리 경로 제안 추가 — /add-dir 동작과 일치하도록 /cd에 디렉토리 경로 제안 추가
/doctor CLAUDE.md 검사 추가 — Claude가 코드베이스에서 파생할 수 있는 콘텐츠를 잘라내어 체크인된 CLAUDE.md 파일을 다듬을 것을 제안하는 /doctor 검사 추가
/commit-push-pr git push 자동 허용 개선 — /commit-push-pr이 이제 origin 외에도 리포지토리의 구성된 푸시 원격(remote.pushDefault 또는 하나만 구성된 경우 유일한 원격)으로 git push를 자동 허용함
게이트웨이 /login Anthropic 지원 — 게이트웨이: /login이 이제 Anthropic이 운영하는 공용 게이트웨이 엔드포인트를 지원함
EnterWorktree 확인 요청 — EnterWorktree가 이제 프로젝트의 .claude/worktrees/ 디렉토리 외부의 Git 워크트리에 진입하기 전에 확인을 요청함
백그라운드 에이전트 업데이트 개선 — 백그라운드 에이전트가 Claude Code 업데이트 직후 백그라운드에서 새 버전으로 업그레이드되어, 연결 시 느린 오래된 세션 업그레이드 비용을 지불하지 않음
만료된 로그인 오류 메시지 수정 — 만료된 로그인이 /login 실행을 요청하는 대신 "There's an issue with the selected model"이라는 오해의 소지가 있는 오류와 함께 모든 모델에서 실패하던 문제 수정
claude --resume 및 --continue 키보드 입력 수정 — claude --resume 및 --continue가 시작 시 키보드 입력에 응답하지 않던 문제 수정
MCP 서버 request_timeout_ms 수정 — --mcp-config 또는 .mcp.json을 통해 구성된 MCP 서버가 서버별 request_timeout_ms를 무시하여, 새로 시작된 세션에서 장기 실행 MCP 도구 호출이 기본 60초에서 시간 초과되던 문제 수정
CLAUDE_CODE_EXTRA_BODY 무시 수정 — CLAUDE_CODE_EXTRA_BODY가 claude agents / --bg 백그라운드 작업자에 의해 자동으로 무시되던 문제 수정. 이제 셸로 내보낸 재정의가 디스패칭 세션을 따름
OAuth MCP 서버 재인증 수정 — OAuth MCP 서버가 단일 토큰 새로 고침 실패 후 수동 재인증을 요구하던 문제 수정
--permission-prompt-tool 충돌 수정 — --permission-prompt-tool이 MCP 서버를 가리킬 때 서버 연결 완료 전에 콜드 스타트에서 "MCP tool not found"와 함께 충돌하던 문제 수정
/model 선택기 가격 표시 수정 — /model 선택기 행이 해당 행에 명명된 모델과 다른 모델의 가격을 인쇄하고, 청구하지 않는 공급자의 1차 목록 가격 인용을 중단함
/model 선택기 서버 제공 모델 위치 수정 — 권한 또는 허용 목록 제한으로 인해 행이 삭제될 때 /model 선택기에서 서버 제공 모델 행이 잘못 배치되던 문제 수정
데스크톱 세션 "running" 상태 수정 — 슬래시 명령이 턴 중간에 전송된 후 데스크톱 세션이 "running"으로 표시된 채 멈추던 문제 수정
Windows 에이전트 뷰 키보드 입력 수정 — Windows에서 claude --resume 전에 설정 프롬프트가 나타날 때 에이전트 뷰에서 키보드 입력이 무시되던 문제 수정
claude rm 작업 제거 수정 — claude rm이 제거된 작업을 데몬 로스터에 남겨두어 claude agents에 행이 다시 나타나던 문제 수정
/remote-control 로그인 안내 수정 — /remote-control이 로그아웃 상태일 때 "Unknown command"를 표시하던 문제 수정. 이제 로그인 방법을 설명함
워크플로 상세 뷰 탐색 수정 — 왼쪽 화살표가 워크플로 상세 뷰에서 단계 또는 에이전트 밖으로 나가지 않던 문제 수정

v2.1.181

새 기능

/config key=value 인라인 설정 — 프롬프트에서 바로 설정 변경 (예: /config thinking=false). 대화형·-p·Remote Control 모두 지원
CLAUDE_CLIENT_PRESENCE_FILE 환경변수 — 마커 파일을 지정하면 PC 앞에 있을 때 모바일 푸시 알림 억제
sandbox.allowAppleEvents 옵트인 설정 (macOS에서 샌드박스 명령이 Apple Events 전송 허용)
번들 Bun 런타임 1.4로 업그레이드

개선

긴 문단을 줄 단위로 스트리밍 (첫 줄바꿈을 기다리지 않음)
thinking 중 API 연결이 끊겨도 자동 재시도 ("Connection closed while thinking" 메시지 대신)
서브에이전트 패널 — 30초 후 유휴 항목 자동 숨김, 최대 5행 + 스크롤 힌트, 키보드 힌트 표시

주요 수정

네트워크 드라이브·클라우드 동기화 폴더에서 Write/Edit가 0바이트·잘린 파일을 만들던 문제
macOS에서 open/osascript/브라우저 인증이 -600 에러로 실패하던 문제 (Apple Events 권한 추가)
2.1.169에서 생긴 시작 지연(~120ms) 회귀, 느린 네트워크에서 최대 15초 빈 터미널 멈춤
서브에이전트 무한 중첩 체인 방지 (5단계 깊이 제한 적용)

v2.1.179

연결 끊김 복구 — 스트리밍 중 연결이 끊겨도 부분 응답을 보존(raw 에러 대신), 스피너가 "running tool"에 멈추지 않음
WSL2(Windows Terminal·VS Code)에서 마우스 휠 스크롤 수정 (2.1.172 회귀)
원격 세션 플러그인 로딩 성능 개선
환영 화면의 프로모 배너를 세션당 최대 1개로 정리

v2.1.178

에이전트 팀 단순화 — TeamCreate/TeamDelete 도구 제거. CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 설정 시 모든 세션에 암묵적 팀이 생겨, Agent 도구의 name 파라미터로 팀원을 바로 소환(설정 단계 불필요). team_name 파라미터는 여전히 허용되지만 무시됩니다.
Tool(param:value) 권한 규칙 문법 — 도구 입력 파라미터 매칭 (예: Agent(model:opus)로 Opus 서브에이전트 차단)
중첩 .claude/skills 디렉터리의 스킬 로딩 지원 (이름 충돌 시 <dir>:<name>로 둘 다 유지)
자동 모드 개선 — 서브에이전트 소환을 실행 전 분류기로 검토
/doctor 레이아웃·상태 아이콘 개선, /bug는 제출 전 설명 필수

더 이전 버전과 전체 상세 변경 내역은 공식 CHANGELOG를 참고하세요.

도움이 되었나요?