What's New

종합

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

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

v2.1.316

CLAUDE_CODE_DISABLE_ULTRATHINK 추가 — ultrathink 키워드를 끄는 CLAUDE_CODE_DISABLE_ULTRATHINK 추가
풀링된 그룹 예산 추가 — Claude 앱 게이트웨이에 풀링된 그룹 예산 추가: 그룹 구성원이 공유하는 월별 예산으로, 각 구성원 자신의 한도 외에 지출 한도 관리자 API에서 pooled_budget으로 설정
CLAUDE_CODE_DISABLE_LOOPED_CROSS_CERT_DROP 추가 — 개인 CA에 필요한 서버를 위해 서로를 인증하는 시스템 교차 인증서를 루프에 유지하는 CLAUDE_CODE_DISABLE_LOOPED_CROSS_CERT_DROP 추가
CLAUDE_CODE_SUBAGENT_EFFORT 추가 — 다른 어떤 것도 지정하지 않을 때 서브에이전트가 실행되는 노력 수준을 설정하는 CLAUDE_CODE_SUBAGENT_EFFORT 추가 (세션의 노력을 상속하는 대신)
managed.policy_mode: layered 추가 — Claude 앱 게이트웨이에 managed.policy_mode: layered 추가: 개발자와 일치하는 모든 정책이 적용되며, 각 정책은 아래 나열된 정책 위에 병합됨 (첫 번째 정책만 적용되는 것이 아님)
guardrail.input_tagging 추가 — Claude 앱 게이트웨이 Bedrock 업스트림에 guardrail.input_tagging 추가. 이는 Amazon Bedrock 가드레일의 프롬프트 공격 필터에 필요한 입력 태그로 프롬프트를 감쌈. all_messages_and_system은 시스템 프롬프트도 태그함
Opus 4.8 고속 모드 지원 중단 — 2026년 10월 30일부로 Opus 4.8의 고속 모드 지원 중단. 2026년 11월 30일에 제거될 예정. 제거 후 Opus 4.8의 고속 모드 요청은 오류를 반환하며 표준 Opus 4.8로 대체되지 않음. 속도 향상을 유지하려면 Opus 5.5로 마이그레이션하세요.
셸 명령 수정 — 자격 증명이 거부되거나 클라우드 세션이 보관되는 등 Claude Code가 자체적으로 종료될 때 macOS 및 Linux에서 셸 명령이 계속 실행되던 문제 수정
Bash 별칭 및 함수 수정 — 값에 줄 바꿈이 있는 Bash 별칭(Git Bash 제외)과 이름이 대시로 시작하는 함수가 Bash 도구의 셸에서 손상되거나 손실되던 문제 수정
Bash 스크립트 수정 — SHELLOPTS가 내보내질 때 Bash 도구에서 시작된 Bash 스크립트가 첫 번째 명령 후에 중지되던 문제 수정
PowerShell 훅 수정 — 명령이 타입 캐스트, param, using 또는 속성으로 시작할 때 PowerShell 훅이 종료 코드 2에서 차단되지 않던 문제 수정
네트워크 요청 수정 — 압축된 응답이 잘리거나 손상되었을 때 일부 네트워크 요청이 중단되던 문제 수정
모델 가용성 오류 수정 — Vertex AI 및 Amazon Bedrock에서 sonnet, opus, haiku가 최신 모델이 계정 또는 지역에서 아직 사용할 수 없을 때 이전 모델로 전환하는 대신 세션 중간에 오류를 표시하던 문제 수정
Claude 앱 게이트웨이 모델 검사 수정 — Claude 앱 게이트웨이가 요청에서 지정된 모든 모델을 availableModels, deniedModels, models에 대해 확인하지 않던 문제 수정. 이제 차단된 모델을 지정하는 요청은 필드 이름을 포함하는 400 오류를 반환함
claude auth login 수정 — 관리되는 설정이 Claude 앱 게이트웨이를 요구하는 경우 claude auth login이 실행을 거부하던 문제 수정. 터미널에서는 이제 게이트웨이 로그인 화면을 표시함
--restricted 세션 파일 업로드 수정 — 읽기 허용 규칙이 적용되는 경우 --restricted 세션이 작업 디렉토리 외부에서 파일을 업로드하던 문제 수정
프롬프트 전송 수정 — 보이지 않는 문자를 포함하는 프롬프트가 전송을 위해 두 번째 Enter를 필요로 하던 문제 수정. 이제 일반 프롬프트는 첫 번째 Enter에서 정리되어 전송되고, 명령은 여전히 검토를 기다림
서브에이전트 모델 상속 수정 — 부모 서브에이전트의 모델을 상속한 서브에이전트가 백그라운드 작업이나 메시지가 깨울 때 주 모델로 이동하던 문제 수정
관리되는 autoMode.allow 목록 수정 — "$defaults"가 없는 관리되는 autoMode.allow 목록이 호스트 앱의 --settings, /permissions에 추가된 첫 번째 규칙 또는 /auto-mode-setup에서 내장 예외를 다시 가져오던 문제 수정
클라우드 세션 및 예약된 작업 실패 수정 — 서버가 안전성 판단을 반환하지 않아 자동 모드가 턴을 중지했을 때 클라우드 세션 및 클라우드 예약된 작업이 실패로 표시되지 않던 문제 수정
claude -p 출력 수정 — 백그라운드 에이전트가 여전히 실행 중일 때 claude -p 텍스트 출력이 자동 모드가 턴을 중지한 이유를 때때로 설명하지 않던 문제 수정
CLAUDE_CODE_AUTO_MODE_SERVER=1 수정 — 실험적 베타가 꺼진 프록시 또는 LLM 게이트웨이 뒤의 호스트 애플리케이션(예: Claude Desktop)에서 시작된 세션에서 CLAUDE_CODE_AUTO_MODE_SERVER=1이 무시되던 문제 수정
플러그인 MCP headersHelper 스크립트 수정 — 자격 증명 이름의 환경 변수가 1과 같은 스위치 값으로 설정되었을 때 플러그인 MCP headersHelper 스크립트가 손상된 CLAUDE_PLUGIN_ROOT 및 서버 URL을 수신하던 문제 수정
SDK register_repo_root 수정 — SDK register_repo_root 제어 요청이 작업 디렉토리 외부의 디렉토리( CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 사용)의 CLAUDE.md를 로드하지 않던 문제 수정
Artifact 도구 수정 — Artifact 도구가 아티팩트 데이터베이스 접근 규칙에 대해 ?를 표시하고, 규칙을 삭제할 수 있는 재게시를 거부할 때 해당 규칙을 다시 인용하지 않던 문제 수정
/model <id> 경고 수정 — /model <id>가 모델이 이 버전에서 인식되지 않고 자동 압축이 200K 컨텍스트 창을 가정할 때 경고하지 않던 문제 수정
"말하려면 스페이스바를 누르세요" 힌트 수정 — "말하려면 스페이스바를 누르세요" 힌트가 한 세션에서 세 번 모두 표시되고, 푸시-투-톡이 바인딩되지 않았을 때 빈 키를 표시하던 문제 수정
Grep 및 Glob 수정 — 검색 프로세스가 시간 초과 시 종료되었지만 종료되지 않을 때 Grep 및 Glob이 반환되지 않던 드문 경우 수정 (Windows에서 발생)
대화 재개 수정 — 대화의 일부가 아직 저장 중일 때 /clear 또는 /resume이 실행되었을 경우, 대화를 재개해도 계획이 복원되지 않던 드문 경우 수정
첫 실행 설정 수정 — 첫 실행 설정이 좁은 터미널에서 보안 노트와 터미널 설정 설명에서 단어를 누락시키던 문제 수정
Enterprise 설문조사 카드 수정 — Enterprise 설문조사 카드가 짧은 일시 정지 후 입력된 1 또는 0을 받던 문제 수정. 이제 입력된 답변은 Enter를 필요로 함
자체 호스팅 러너 수정 (메시지 응답) — Claude가 작업 중일 때 전송된 메시지가 중지 후, 세션 프로세스가 교체된 후에 응답되던 문제 수정
자체 호스팅 러너 수정 (MCP 서버 스위치) — 세션이 새 머신으로 이동할 때 MCP 서버의 켜기/끄기 스위치가 때때로 손실되던 문제 수정
Windows Bash 도구 수정 — rc 파일이 errexit 및 pipefail을 설정하고 winpty 별칭만 정의되거나 아무것도 정의되지 않았을 때 Windows의 Git Bash에서 Bash 도구가 별칭과 함수를 손실하던 문제 수정
/code-review 개선 — Claude Desktop 또는 웹의 코드 탭에서 시작된 /code-review 개선: 클라우드 및 claude remote-control 세션은 이제 일반 텍스트 목록 대신 결과 카드를 표시함
/diff 개선 — 대규모 리포지토리의 /diff 개선: 각 새로 고침은 일반적으로 전체 리포지토리 git 명령을 하나 적게 실행하며, git이 느릴 때 새로 고침 간격이 벌어짐
SSL 인증서 오류 메시지 개선 — SSL 인증서 오류 메시지가 중간 인증서를 누락시키는 서버 등 예상되는 원인을 명시하도록 개선됨

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 인식 마스킹에 대한 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)" 메시지를 표시하던 문제 수정
원격 제어 세션 기록 업로드 수정 — 서버 세션이 만료된 후 다시 생성된 원격 제어 세션이 이전 로컬 대화 기록을 새 세션으로 업로드하던 문제 수정
전체 화면 모드 개선 — 전체 화면 모드가 반복적인 압축 전의 전체 기록을 스크롤백에 유지하여, 가장 최근 간격만 유지하던 이전 방식 개선

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 형식( 배열) 또는 사용. 모니터 및 headersHelper: 스크립트 내부에서 값 읽기 (구성 파일 또는 서버의 블록)

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 업데이트 직후 백그라운드에서 새 버전으로 업그레이드되어, 연결 시 느린 오래된 세션 업그레이드 비용을 지불하지 않음
**만료

도움이 되었나요?