v2.1.306GitHub 릴리스
요약 준비 중
claude-code
Anthropic 의 터미널 코딩 에이전트. 설정 키와 슬래시 명령이 버전마다 늘어난다 anthropics/claude-code 의 릴리스를 따라가며 정식 버전마다 변경 사항을 한국어로 정리해요. 요약은 릴리스 노트에 있는 것만이고, 알파 · RC 는 제목만 남겨요. Atom 피드
v2.1.305GitHub 릴리스
- Vertex, Bedrock 등에서 엔드포인트나 게이트웨이가 tool search를 거부하거나 ToolSearch가 허용되지 않은 경우 모든 요청이 실패하던 문제가 수정되어, 이제 tool search 없이 재시도한다
- sandbox.allowNestedUserNamespaces가 추가돼 Linux 샌드박스 명령이 user namespace를 만들 수 있지만(Chromium, rootless podman), 샌드박스의 파일 보호를 우회할 수 있다
- CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS가 추가돼 무인 재시도 모드(CLAUDE_CODE_RETRY_WATCHDOG)가 리셋 전에 해제된 사용량 한도를 감지한다
- /usage의 경고가 출처를 밝힌 한 줄 해결책으로 바뀌었고 f로 적용할 수 있으며, 같은 해결책이 VS Code와 /doctor에도 표시된다
- allowedMcpServers가 env에서만 ${VAR}를 쓰는 managed-mcp.json stdio 서버를 더 이상 걸러내지 않아 허용 목록에 없던 서버도 업그레이드 시 로드되므로, 막으려면 deniedMcpServers를 써야 한다
- /artifacts 삭제 확인이 1 또는 Enter(유지), 2(삭제), Esc(취소)로 바뀌었고 y와 n은 더 이상 동작하지 않는다
v2.1.304GitHub 릴리스
- /auto-mode-setup이 추가돼 프로젝트와 최근 세션을 읽고 auto mode에 사용자 환경을 학습시키며, Bedrock·Vertex·Foundry·Claude apps gateway·텔레메트리 비활성 세션에서도 쓸 수 있다
- mod의 tool.check 응답에 decider: "person"이 추가돼 권한 대화상자나 호스트 콜백만 승인할 수 있고, 물어볼 사람이 없으면 mod가 지정한 사유로 거부된다
- mod의 tool.check 이벤트에 읽기 전용 호출일 때 설정되는 e.isReadOnly가 추가됐다
- /claude-api managed-agents-secure가 추가돼 Managed Agents 에이전트 설정을 Anthropic의 보안 가이드와 변경 없이 비교한다
- Pro·Max 플랜에서 비활성 대화를 재개할 때 5시간 사용 한도를 크게 쓰게 되면 경고하며, 그대로 재개하거나 새 대화를 시작할 수 있다
- sandbox.filesystem.denyRead 글로브의 대괄호로 인한 Linux 샌드박스 시작 실패, /Volumes·/media·/mnt/c 등에 대한 rm -r 안전 확인 누락, LLM 게이트웨이의 context_management 오류, --max-turns를 넘어 계속되는 플러그인 헤드리스 실행 등 여러 버그가 수정됐다
v2.1.303GitHub 릴리스
릴리스 노트 없음
v2.1.302GitHub 릴리스
- CLAUDE_CODE_AUTO_MODE_MODEL이 추가돼 클라이언트 측 auto mode 분류기가 쓰는 모델을 선택할 수 있으며, 서버 측 auto mode의 모델은 바뀌지 않는다
- /config에 Idle compaction 항목이 추가돼 유휴 compaction을 끄거나 다시 켤 수 있고, compaction 후 알림에도 끄는 방법이 표시된다
- /design-sync와 /design-login에 독립형 Claude Design(claude.ai/design)이 2026년 12월 14일에 종료된다는 안내가 추가됐다
- Read 도구가 이미지 파일이나 이미지 이름의 파이프·장치를 통째로 메모리에 올리던 문제가 고쳐졌고, 128MB를 넘는 이미지 소스는 거부된다
- compaction 중 턴 중단 시 "Prompt is too long" 오류, Vertex·Bedrock 전환 후 "diagnostics" 오류, MCP 프로토콜 2026-07-28 서버의 도구 미표시, reftable 형식 git 문제, exFAT·FAT32 드라이브의 파일 쓰기 거부 등 여러 버그가 수정됐다
- 플러그인이 많을 때 플러그인 command와 agent 파일 로딩에 필요한 파일 시스템 호출이 크게 줄어 시작 시간이 개선됐다
v2.1.301GitHub 릴리스
- 무인 재시도 모드(CLAUDE_CODE_RETRY_WATCHDOG)에서 사용량 한도 리셋이 너무 멀면 대기 대신 요청을 종료하도록 하는 CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS가 추가됐다
- vim 모드에 일치하는 괄호로 이동하는 % 모션이 추가됐고, d/c/y와 함께도 쓸 수 있다
- OpenTelemetry tool_decision 이벤트에 classifier_verdict와 permission_mode가 추가됐고, OTEL_LOG_TOOL_DETAILS=1일 때는 classifier_category도 포함된다
- claude-api 스킬에 OpenTelemetry 트레이싱 가이드가 추가됐고, ant CLI로 트레이스 대상을 설정하는 방법도 담겼다
- fable·best 모델 별칭이 최신 Fable 모델을 쓸 수 없을 때 오류를 내던 문제는 이전 Fable 모델로 한 번 재시도하도록 고쳐졌다. Read 도구가 .xlsm, .parquet, .epub, .heic 같은 바이너리를 텍스트로 읽던 문제 등 여러 버그도 수정됐다
v2.1.300GitHub 릴리스
- 모드용 프롬프트 장식에 virtualText가 추가돼, 초안이나 제출 프롬프트에 들어가지 않는 텍스트를 프롬프트 박스에 그릴 수 있다
- 모드에 $.ui.view({ agentId })로 에이전트 대화 기록을 메인 뷰에 표시하고 $.ui.view({})로 되돌리는 기능, 오른쪽에서 왼쪽 텍스트용 Text의 dir 속성이 추가됐다
- agent.spawn 모드 훅에서 워크플로 에이전트의 프롬프트와 모델을 바꿀 수 있고, 히스토리 호출·지우기·undo·플러그인 채우기처럼 입력 없이 텍스트가 바뀔 때 발생하는 prompt.change 훅이 추가됐다
- Claude Platform on AWS에서 /advisor를 쓸 수 있다. /advisor, advisorModel, --advisor로 고르기 전에는 실행되지 않으며 CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1로 끌 수 있다
- OpenTelemetry api_request 이벤트에 cache_creation_5m_tokens와 cache_creation_1h_tokens가 추가됐고, 트레이스 스팬에 gen_ai.provider.name, gen_ai.tool.name, error.type 등 GenAI 시맨틱 컨벤션 속성이 추가됐다
v2.1.299GitHub 릴리스
- 터미널에서 유휴 압축이 추가돼, 200K 토큰 이상 대화를 약 54분 방치하면 1시간 프롬프트 캐시가 만료되기 전에 압축되어 다음 메시지에서 전체를 다시 처리하지 않는다
- 유휴 압축의 최소 토큰(200K)은 CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS로 바꾸고 settings.json의 "idleCompaction": false로 끌 수 있으며, 둘 다 v2.1.290 이상이 필요하다
- CLAUDE_CODE_DISABLE_FILE_MENTIONS 환경 변수가 추가돼, @ 파일 멘션 시 내용 대신 경로만 전달되고 Claude가 파일 도구로 직접 읽는다
- agent view에서 /effort와 /fast로 새 세션의 시작 설정을 지정할 수 있고, 인자 없는 /model, /effort, /fast는 선택기를 연다
- mod에 $.prompt.media, $.session.identity(), Text의 size·weight·mono·tabular, Box의 간격 단계(xs~xl)가 추가됐고 bold는 weight로 대체되어 deprecated 됐다
- claude self-hosted-runner orchestrator에 --shutdown-drain-sec이 추가됐고, claude plugin eval에는 --disallow-tools와 disallowed_tools 필드가 추가됐다
v2.1.296GitHub 릴리스
- Claude apps gateway의 managed.policies[]에 code 키가 추가돼 cli와 같은 설정을 Claude Desktop의 Code 탭에도 적용하며, desktop과 함께 쓰면 Claude Desktop의 gateway 모드가 켜진다
- 서브에이전트 frontmatter와 --agents 정의에 autoCompactWindow를 쓸 수 있어 메인 대화보다 일찍 자동 압축하게 할 수 있다
- CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL로 모든 워크플로 에이전트를 한 모델에서 실행할 수 있고, CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS로 529 과부하 재시도 백오프의 최대 지연을 늘릴 수 있다
- Read 도구에 allow_large 옵션이 추가돼 컨텍스트 여유가 있을 때 일반 크기 제한을 넘는 텍스트 파일을 한 번에 읽을 수 있다
- /plugin이 같은 이름의 다른 활성 플러그인 때문에 hooks가 제외된 플러그인에 안내를 표시한다
- managed 설정의 PreToolUse·prompt hook 차단 시 턴이 끝나지 않던 문제, PostToolUse의 updatedMCPToolOutput 미적용, 2.1.295의 forceLoginMethod gateway 로그인 무시 회귀, --teleport 빈 대화 문제 등 다수 버그가 수정됐다
v2.1.295GitHub 릴리스
- command·HTTP 훅에 onFailure: "block"이 추가돼, 훅이 시작되지 못하거나 시간 초과 또는 예상 밖 코드로 종료되면 동작을 통과시키지 않고 차단한다
- 터미널이 Program Status Protocol(OSC 7501)을 구현하면 Claude Code의 작업 중·입력 대기·완료 상태를 표시할 수 있다
- Claude apps gateway의 모든 upstream에 models 목록을 둘 수 있고, timeouts.upstream_ttfb_ms가 Bedrock·Vertex·Foundry 등 클라우드 upstream에도 적용되며, 감사 이벤트에 upstream_request_id가, 성공 응답에 request-id 헤더가 추가됐다
- 머신에 관리형 설정이 없어도 사용자 설정의 forceLoginMethod: "gateway"와 forceLoginGatewayUrl을 지원하고, CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS로 무인 재시도 대기 시간을 제한할 수 있다
- [1m] 모델에서 context-1m 베타가 거부되면 베타 없이 재전송하고, MCP 연결 재시도 백오프, MCP 파일 확장자 저장, claude -p 출력 누락, Bash의 command_description 처리 등 여러 버그가 수정됐다
v2.1.294GitHub 릴리스
- "Block commands that..."처럼 지시문으로 작성한 prompt 훅과 agent 훅이 차단해야 할 동작을 허용하던 버그가 수정됐다
- "Carry on if the build is broken"처럼 지시문으로 작성한 Stop, SubagentStop의 prompt 훅 판단 방식이 개선돼 Claude가 일찍 멈출 가능성이 줄었다
v2.1.293GitHub 릴리스
- claude-haiku-5-5는 1M 컨텍스트를 지원하며, 가격은 Mtok당 $0.10/$0.50이고 100K를 넘는 프롬프트는 $0.50/$2.50이다
- subagentStatusLine 페이로드에 agentType이 추가돼 스크립트에서 커스텀 서브에이전트 유형을 구분할 수 있다
- mod용 $.tool.register에 isDeferred가 추가됐고, false로 두면 도구 스키마를 tool search 뒤가 아니라 처음부터 프롬프트에 포함한다
- 컨텍스트 압축 직전 작업을 완료된 것으로 오해해 되돌리거나 다시 하던 문제와, HTTP MCP 연결이 보낸 요청을 계속 쌓아 두던 메모리 누수가 수정됐다
- ← 백그라운드 전환 시 메시지 유실, /model effort 좌우 키 순환으로 Low가 기본값에 저장되던 문제, /tui가 Claude in Chrome 연결을 끊고 --no-chrome을 무시하던 문제를 포함해 다수의 버그가 수정됐다
v2.1.292GitHub 릴리스
- claude plugin install에 --marketplace 옵션이 추가돼, 필요하면 마켓플레이스를 marketplace add와 같은 정책 검사로 추가한 뒤 플러그인을 설치한다
- Agent 도구에 effort 파라미터가 추가돼 서브에이전트를 원하는 effort 수준으로 실행할 수 있다
- 과부하(529) 재시도 백오프의 기본 지연을 늘릴 수 있는 환경 변수 CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS가 추가됐다
- 모드용으로 prompt.autocomplete 이벤트, $.model.complete의 프롬프트 캐싱(cache: true), agent.spawn 훅의 워크플로 에이전트 지원이 추가됐다
- UNC 경로 파일 읽기의 권한 프롬프트 우회, 샌드박스 읽기 차단 및 심볼릭 링크 관련 문제, Windows rm -rf 대체 경로 판정, NO_PROXY 무시, 계획 모드 복원, 예약 작업 및 /loop 유실, 긴 이름의 MCP 도구로 인한 요청 실패 등 다수의 보안·안정성 버그가 수정됐다
v2.1.291GitHub 릴리스
- 클라우드 세션에서 권한 확인 프롬프트에 대한 응답이 누락될 수 있던 2.1.290의 회귀 버그가 수정됐다
- 종료할 때 세션의 마지막 메시지가 유실될 수 있던 2.1.288의 회귀 버그가 수정됐다
v2.1.290GitHub 릴리스
- mod의 turn.step 훅 결과에 serverToolUses가 추가돼 API가 직접 실행한 도구 호출(advisor)의 id, name, input, 시작·종료 정보를 볼 수 있다
- tool.check 이벤트에 agentId가, 훅이 읽는 질문과 판정에 ceiling이 추가돼 서브에이전트의 권한 확인과 조직이 요구하는 승인 수준을 구분할 수 있다
- claude plugin validate가 게이팅 지점에 등록된 각 훅과 .catch 여부를 보여주며, --json에서는 gatingHooks로 출력한다
- claude attach와 claude logs에서 세션 ID 대신 세션 이름의 일부를 쓸 수 있고, /claude-api managed-agents-onboard 명령이 추가됐다
- WebFetch가 100,000자를 넘는 페이지에서 읽지 못한 분량을 알려주고 offset으로 이어 읽을 수 있으며, 프록시의 beta 헤더 거부, 이미지가 많은 긴 세션 오류, 예약 작업 복원 누락 등 여러 버그가 수정됐다
- 관리형 설정 파일이 폴더 밖을 가리키는 링크이거나 사용자 sandbox allowRead 경로·허용 도메인이 무시될 때 /status와 doctor가 경고한다
v2.1.289GitHub 릴리스
- 관리형 환경에서 복합 셸 명령의 중첩 부분에 걸린 deny·ask 규칙이 사용자 설치 mod의 승인보다 우선하지 않던 문제가 수정됐다
- 샌드박스 자동 허용 시 환경 변수 접두사(예: TZ="$HOME" rm -rf build)나 단독 변수 할당 뒤의 명령을 Bash deny·ask 규칙이 놓치던 문제가 수정됐다
- IDE에서 @-멘션, 변경, 선택한 파일이 심볼릭 링크일 때 Read deny 규칙이 적용되지 않던 문제가 수정됐다
- 미닫힌 태그나 깊게 중첩된 ${ 치환이 많은 짧은 코드 블록에서 터미널과 공개 아티팩트 페이지가 멈추던 문제가 수정됐다
- teammate용 agent.spawn이 추가됐고, 플러그인 훅 이벤트 전반에서 에이전트 ID가 통일됐으며, $.agent.list()에 idle·waiting 상태가 표시된다
v2.1.288GitHub 릴리스
- Ctrl+C로 지운 프롬프트를 빈 프롬프트에서 Up을 눌러 붙여넣은 텍스트와 이미지까지 복구할 수 있다
- /code-review에 --max-findings |all 옵션이 추가돼 보고할 발견 항목 수를 조절할 수 있고, --max-findings default를 넘기기 전까지 선택이 유지된다
- 에이전트 뷰에서 Ctrl+F로 세션 이름 검색, Alt+↑/↓로 그룹 간 이동이 가능하며 둘 다 rename과 함께 keybindings.json에서 재지정할 수 있다
- MCP 서버가 도구 호출 중 OAuth 스코프를 추가로 요구하면 재인증 프롬프트가 표시되고, mod용 $.ui.selection()과 GitHub CLI가 없는 클라우드 세션용 내장 gh api도 추가됐다
- 응답 도중 API 타임아웃이 나면 비대화형 세션과 서브에이전트가 부분 응답에서 이어가고, 'Prompt is too long' 오류와 --resume 시 컨텍스트·응답 유실 문제가 수정됐다
- 구조화된 출력을 거부하는 Mantle이나 게이트웨이에서의 실패를 막기 위해 CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS로 구조화된 출력을 끌 수 있다
v2.1.287GitHub 릴리스
- 플러그인이 더 깊은 동작을 수정할 수 있는 Claude Mods 기능이 추가됐다
- 곁에서 놓친 부분을 짚어주는 옵트인 플러그인 'You should know'가 추가됐으며 /plugin enable cc-plugin-you-should-know@builtin으로 켤 수 있다
- agents 뷰에 세션 이름과 작업을 매칭하는 n: 필터가 추가되고 Enter로 첫 매치를 열 수 있게 됐다
- OpenTelemetry user_prompt 이벤트에 prompt_text 필드가 추가됐고, 2025-11-25 프로토콜의 MCP 서버 URL 프롬프트가 지원된다(기존 서버는 설정에 bareElicitationCapability 추가 필요)
- 모델 전환 시 MCP 도구 안내가 덮어써지던 문제, Bedrock/Vertex 모델 목록 제한 무시, rm 안전장치 누락 등 다수의 안정성 버그가 수정됐다
- 검색창과 /rewind 등에서 스크린 리더 모드의 커서 위치 및 입력 처리 문제가 수정됐다
v2.1.286GitHub 릴리스
- 권한 요청이 여러 개 쌓일 때 프롬프트에 「2 of 5」 같은 개수 표시가 추가됐고, 전체 화면 목록의 「N more」 행에 마우스 클릭·호버 지원이 추가됐다
- gcpAuthRefresh·awsAuthRefresh 자격 증명 만료 시 로그인 브라우저가 중복으로 열리던 문제, claude --resume/--continue가 세션 충돌 후 턴을 잃던 문제, 도구·훅이 텍스트가 아닌 값을 반환할 때 API 400 오류가 나던 문제 등이 수정됐다
- 대용량 히스토리를 가진 클라우드 세션이 깨어나지 못하던 문제와 Claude 앱 게이트웨이의 프롬프트 캐시·토큰 과금 오류가 수정됐다
- macOS에서 다른 창에서 로그인해도 「Not logged in」으로 남던 문제, 기본 모델이 거부될 때 동일 등급의 이전 모델로 한 번 재시도하도록 수정됐다
- 조직 정책으로 Remote Control이 꺼졌을 때 세션이 계속 연결된 상태로 남던 문제, 파일 전송 실패·지연 관련 문제 등 Remote Control 관련 여러 버그가 수정됐다
- MCP 인증 캐시, 에러 메시지의 자격 증명·비밀값 마스킹, 로그·트랜스크립트의 URL 비밀번호 노출 등 보안 및 로깅 관련 다수 버그가 수정됐다
v2.1.285GitHub 릴리스
- CLAUDE_CODE_DISABLE_WEB_FETCH 환경 변수가 추가돼 WebFetch 도구를 끌 수 있다
- claude --desktop, claude plugin configure, claude plugin install --config 등 플러그인·데스크톱 앱 연동 명령이 추가됐다
- allowedProviders 관리 설정으로 머신에서 사용할 수 있는 API 프로바이더를 제한할 수 있다
- CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES로 타임아웃된 비스트리밍 폴백 요청의 재전송 횟수를 제한할 수 있다
- 서브에이전트 권한·모델 전환·MCP 서버 관리·Remote Control 메시지 처리 등 다수의 버그가 수정됐다
- 플러그인 설치 시 ID가 대소문자나 특수문자만 다른 경우 다른 플러그인의 캐시/데이터 폴더에 잘못 설치되던 문제가 수정됐다
v2.1.284GitHub 릴리스
- Anthropic API에서 100만 컨텍스트를 지원하는 Claude Sonnet 5.5(claude-sonnet-5-5)가 새 기본 Sonnet 모델로 추가됐다
- auto 모드의 작업 디렉터리 외부 읽기 확인 프롬프트에 "Yes, but ask again next time" 응답이 추가됐고, /usage와 상태줄에 게이트웨이 지출 한도가 금액으로 표시되며 rate_limits.spend_limit에 used_usd·limit_usd·period가 추가됐다
- keybindings.json에서 /effort 슬라이더를 조작할 수 있는 effortSlider 관련 액션이 추가됐고, /rate-limit-options가 /help와 명령 메뉴에 노출되며 /mcp reconnect all로 연결 실패한 MCP 서버를 한번에 재시도할 수 있다
- 손상된 응답 스트림에서 원시 오류나 "undefined"가 표시되던 문제, thinking 블록 직후 오류로 턴이 종료되던 문제, 압축 후에도 "Prompt is too long"이 지속되던 문제가 수정됐다
- 모델 사용 불가 시 안내 메시지 누락, 잘못된 이미지로 인한 Agent SDK 세션 오류, 재개된 세션에서 MCP 도구 호출이 "No such tool available"로 실패하던 문제 등이 수정됐다
- 관리 설정으로 MCP 서버가 플러그인으로 제한된 경우 claude mcp add가 거부되도록 수정됐고, /plugin configure 화면의 입력 검증 및 Windows에서 다수 플러그인 사용 시 Bash 도구 오류 등이 개선됐다
v2.1.283GitHub 릴리스
- availableModelsMatch를 exact로 설정하면 명시된 모델 버전만 허용되고, deniedModels 설정으로 availableModels가 허용해도 특정 모델을 차단할 수 있게 됐다
- CLAUDE_CODE_GATEWAY_HINT_HEADERS=1로 x-claude-code-prompt-id 헤더를 추가해 LLM 게이트웨이가 같은 프롬프트의 요청을 그룹화할 수 있게 됐다
- /doctor prompt-audit(또는 /checkup prompt-audit) 명령으로 CLAUDE.md, 스킬, 에이전트, 커맨드의 오래된 프롬프팅 패턴을 점검할 수 있게 됐다
- MCP 진행 알림 유실, stdio MCP 서버 잔류 실행, 원격 MCP 서버 일시 404 오류 등 여러 MCP 관련 버그가 수정됐다
- claude plugin validate, details, uninstall, marketplace remove 등 플러그인 관리 명령의 다양한 버그가 수정됐다
- OTEL_LOG_TOOL_CONTENT=1 설정 시 MCP 도구, WebFetch, WebSearch 출력이 tool.output OpenTelemetry 스팬 이벤트에 포함되도록 추가됐다
v2.1.282GitHub 릴리스
- 넓은 터미널에서 표와 코드 블록은 전체 너비를 유지하면서 Claude 응답 텍스트 폭만 제한하는 maxProseWidth 설정이 추가됐다
- 프로젝트 설정 파일에서 무시되거나 텔레메트리를 끈 텔레메트리 변수를 알려주는 시작 알림과 /status, claude doctor 항목이 추가됐다
- claude --chrome를 독점적인 managed-mcp.json과 함께 실행할 수 있게 하는 allowClaudeInChromeWithManagedMcp 관리 설정이 추가됐고, Chrome 차단 오류 메시지에 원인이 명시된다
- --continue, --resume로 재개한 세션에서 이전 메시지 형식 변경이나 --tools 목록 누락 등으로 인해 이전 확장 사고(extended thinking)가 손실되던 여러 문제가 수정됐다
- redacted_thinking block 오류, 압축 실패, 모델 전환 관련 오류 등 다양한 API 오류 상황에서의 재시도 및 복구 로직이 개선됐다
- 권한 규칙의 mid-pattern :* 처리, managed settings의 잘못된 값 처리, 심볼릭 링크를 통한 CLAUDE.md 읽기 등 보안 및 설정 관련 버그가 다수 수정됐다
v2.1.281GitHub 릴리스
- Claude apps 게이트웨이에 blockReadsOutsideWorkingDirectories, disableBypassPermissionsMode 등 새로운 Desktop 정책 키와 Bedrock 업스트림용 assume_role, guardrail 설정, telemetry.resource_attributes가 추가됐다
- settings.json에 "attribution": false를 설정해 커밋과 PR 어트리뷰션 표시를 끌 수 있게 됐다
- MCP URL 모드 elicitation이 추가되어 서버가 브라우저 플로우를 열도록 요청할 수 있고, claude plugin validate가 .mcp.json 오류와 불안전한 URL을 검사하도록 개선됐다
- /insights에 auto mode 추천이 추가되고 /skills, /mcp, /plugin 목록에 스크롤바가 생겼다
- 세션 재개 시 대화 기록이 잘못 전송되거나 이전 추론이 손실되던 여러 버그, 프롬프트 캐시 손상, 스트리밍 중단 시 응답 누락 및 중복 실행 문제가 수정됐다
- CLAUDE_CODE_RETRY_WATCHDOG 및 fast mode의 재시도 로직과 오버사이즈 이미지 처리 시 응답이 멈추던 문제가 수정됐다
v2.1.280GitHub 릴리스
- 기본 Opus 모델이 claude-opus-5-5로 변경됐으며 100만 토큰 컨텍스트와 Mtok당 $4/$20, 캐시 읽기 $0.20/Mtok 요금이 적용된다
- 전체화면 모드에서 /skills 목록 마우스 휠 스크롤과 /plugin의 스킬 상태 옵션 클릭 등 마우스 지원이 확대됐다
- CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH 설정으로 MCP 도구 설명 및 서버 지침의 2,048자 제한을 변경할 수 있게 됐다
- hook_execution_complete OpenTelemetry 이벤트에 훅 출력 크기와 파일로 저장된 초과 크기 출력 개수가 추가됐다
- 심볼릭 링크 경로 쓰기 판정, auto mode의 안전 검사 재시도·거부 루프, Write 호출 검증, /model 등 다이얼로그의 Ctrl+C/D·클릭·키 입력 처리, Windows 터미널 프롬프트 표시, 음성 받아쓰기 중단, 모델 전환 시 프롬프트 캐시 미스, 서브에이전트 캐싱·표시, 플러그인 설치 기록, 스킬 삭제, /mcp 상태 아이콘 불일치 등 다수 버그가 수정됐다
v2.1.278GitHub 릴리스
- Claude API·Enterprise 사용자 및 Bedrock, Vertex, Foundry, 게이트웨이 환경에서 오토 모드가 기본적으로 서버 측 분류기를 사용해 분류기 오버헤드에 과금되지 않는다
- Bedrock, Vertex, Foundry, 게이트웨이 환경에서는 CLAUDE_CODE_AUTO_MODE_SERVER=0 설정으로 이 기능을 끌 수 있으며, 과금되는 폴백이 발생하면 경고가 표시된다
- /status에 이번 세션의 오토 모드 분류기가 서버에서 실행되는지 보여주는 Auto mode server 항목이 추가됐다
v2.1.277GitHub 릴리스
- CLAUDE.md가 없는 프로젝트에서는 AGENTS.md를 읽으며 /config의 "Project instructions"에서 변경할 수 있다(Bedrock, Vertex, Foundry는 아직 미지원)
- 포워드 프록시만 사용하는 Claude apps 게이트웨이를 위해 CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1과 upstream별 headers: 맵 설정이 추가됐다
- /tasks 같은 패널이 열려 있을 때 백그라운드 작업이 완료되면 업데이트 대기 중임을 알리는 줄이 표시된다
- claude -p 및 Agent SDK 세션이 내부 오류 시 결과 없이 멈추던 문제, 빈 텍스트 블록으로 인한 요청 실패, 다른 CLI 빌드와의 충돌로 인한 로그아웃 등 다수의 버그가 수정됐다
- Edit·Write·Grep·Glob 도구의 오류 처리 및 특수 문자·경로 관련 여러 문제가 수정됐다
- 세션 크래시, 렌더링 오류, /clear 후 프롬프트 캐시 미스, 다른 에이전트 메시지 표시 순서 등 다수의 안정성 문제가 수정됐다
v2.1.276GitHub 릴리스
- ANTHROPIC_BASE_URL이 프록시나 게이트웨이를 가리킬 때 'advisor_20260301' 태그로 인해 모든 요청이 400 오류로 실패하던 2.1.275 회귀 버그가 수정됐다
v2.1.275GitHub 릴리스
- Claude 앱 게이트웨이 로그인 시 계정 확인 절차가 추가됐고 /status에 계정 정보가 표시된다
- 현재 턴을 중단하고 대기 중인 메시지를 한번에 보내는 전송 단축키(ctrl+enter 또는 ctrl+x ctrl+s)가 추가됐다
- claude.ai 계정에 등록된 skills와 plugins가 터미널 세션에 동기화되며 syncClaudeAiSkills와 syncClaudeAiPlugins 설정으로 끌 수 있다
- /plugin install --marketplace 명령이 추가돼 마켓플레이스 추가와 플러그인 설치를 함께 제안한다
- otelHeadersHelper 설정 실패 시 시작 경고가 추가돼 텔레메트리 미전송을 알아챌 수 있다
- 세션 복원, 리와인드, 캐시 미스, Grep/Glob 검색 행업, 크래시 등 다수의 안정성 버그가 수정됐다
v2.1.274GitHub 릴리스
- 메모리 사용량이 위험 수준일 때 해제 및 재시작 방법을 안내하는 경고가 추가됐다
- CLAUDE_CODE_MCP_STARTUP_WAIT_MS로 첫 비대화형 턴이 MCP 서버 연결을 기다리는 시간을 조절할 수 있게 됐다
- claude_code.llm_request 트레이스에 effort 속성이, claude_code.managed_settings_resolved OTel 이벤트가 추가됐다
- legacy HTTP+SSE만 지원하는 MCP 서버 연결 실패, Streamable HTTP 도구 호출의 약 5분 타임아웃, listChanged 미선언 시 프롬프트·리소스 미갱신 등 MCP 관련 버그가 다수 수정됐다
- 'unexpected tool_use_id' 오류로 세션이 무한 재시도되던 문제와 컴팩션 중 /goal 유실, 자동 업데이트 후 --model 등 옵션 소실 문제가 수정됐다
- 전체화면 모드에서 접힌 팀원·에이전트 메시지를 클릭해 펼칠 수 있는 기능이 추가됐다
v2.1.273GitHub 릴리스
요약 없음
v2.1.272GitHub 릴리스
릴리스 노트 없음
v2.1.271GitHub 릴리스
요약 없음
v2.1.270GitHub 릴리스
- 세션이 오래 실행된 후 Bash에서 읽기 전용 git 명령이 예기치 않게 권한을 요청하던 문제가 수정됐다(2.1.269에서 발생한 회귀)
v2.1.269GitHub 릴리스
- claude plugin eval 명령으로 플러그인 평가 스위트를 실행해 JSON·HTML 리포트로 채점 결과를 받을 수 있다
- /output-style [name] 명령으로 Remote Control과 클라우드·헤드리스 세션에서도 출력 스타일을 조회하고 전환할 수 있다
- bashEditDiffEnabled 설정으로 Bash 명령이 변경한 파일의 diff를 결과에 표시하고, OTEL_METRICS_INCLUDE_REPOSITORY와 CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS, CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS 환경변수가 추가됐다
- 응답이 잘렸다가 자동 재개될 때와 중단 후 세션을 재개할 때 프롬프트 캐시가 불필요하게 무효화되던 문제가 수정됐다
- kitty·st·rxvt-unicode·WezTerm 등 다양한 터미널에서 특정 키 입력이 오작동하던 문제와 커서 표시 누락 문제가 수정됐다
- 동기화된 플러그인 MCP 서버 연결 실패, 헤드리스 세션의 턴 응답 유실, CMYK JPEG 첨부 실패 등 여러 안정성 버그가 수정됐다
v2.1.268GitHub 릴리스
- gateway.yaml의 pricing 설정을 Claude 앱 게이트웨이에 추가해 /cost와 사용량 집계가 실제 요금과 일치하도록 개선됐다
- access_control.allow_cidrs가 비어있을 때 시작 경고와 공인 IP 최초 요청 시 경고, gatewayInternalNetworks 관리 설정, claude self-hosted-runner --remove-session-state, claude auth status --json의 configDirectory, claude plugin 명령의 --json 옵션이 추가됐다
- ANTHROPIC_BASE_URL을 사용하는 서드파티 호환 엔드포인트에서 모든 턴이 HTTP 400으로 실패하던 문제와 WebFetch가 응답을 끝내지 않는 서버에서 무한 대기하던 문제(CLAUDE_CODE_WEBFETCH_DEADLINE_MS로 설정 가능)가 수정됐다
- 심볼릭 링크된 경로(/etc, /tmp, /var, /bin 등)에서 deny·ask 권한 규칙이 적용되지 않던 문제와 env -C, eval 등이 포함된 명령에서 Read/Edit deny 규칙이 무시되던 문제가 수정됐다
- 플러그인·마켓플레이스 오류나 MCP 서버 상세 정보에 git 소스 URL 토큰이나 ${VAR}로 치환된 비밀 값이 노출되던 문제가 수정됐다
- 장기 유휴 세션의 CPU 과다 사용, /compact 및 재개 시 대화 요약 손상과 순서 불일치, 모델 접근 권한 캐시 오류 등 다수의 세션 안정성 문제가 수정됐다
v2.1.267GitHub 릴리스
- maxEffortLevel 설정이 추가돼 top-level 또는 modelSettings 하위에서 Bedrock, Vertex, Foundry를 포함한 모든 provider의 effort level 상한을 지정할 수 있고 사용자는 더 낮은 값을 선택할 수 있다
- --system-prompt-snapshot off 옵션이 추가돼 매 요청마다 system prompt를 새로 렌더링할 수 있다
- /model로 모델 전환 시 모든 tool definition을 다시 보내던 prompt-cache miss 문제와 MCP·plugin 도구, EnterWorktree 등이 mid-session에 추가될 때 발생하던 여러 prompt-cache miss 문제가 수정됐다
- /context 등 로컬 명령 출력이 모바일 클라이언트에서 빈 화면으로 보이던 문제, tmux·ssh 재연결 후 shift+enter와 option+backspace가 동작하지 않던 문제가 수정됐다
- -p --resume으로 /compact 등 슬래시 명령 실행 후 세션 재개 시 불필요한 턴이 삽입되던 문제와 5MB 이상 대형 세션 재개 시 병렬 tool call과 hook 출력이 누락되던 문제가 수정됐다
- claude remote-control 서버 자격 증명 만료 시 연결이 끊기던 문제와 Remote Control 클라이언트의 권한 모드 표시가 갱신되지 않던 문제 등 다수 버그가 수정됐다
v2.1.266GitHub 릴리스
- CLAUDE_CODE_USE_GATEWAY 환경 변수가 단독으로 설정된 경우 Cloud gateway 로그인을 강제로 요구하던 회귀 버그가 수정됐다
- API 키, apiKeyHelper, 커스텀 인증 헤더와 함께 이 변수를 설정했을 때 모든 요청이 "Not signed in to the Cloud gateway" 오류로 실패하던 문제가 해결됐다
- 해당 변수는 다시 이전처럼 단독으로는 무시되며 별도 설정 변경은 필요하지 않다
v2.1.265GitHub 릴리스
- --plugin-dir로 여러 플러그인이 담긴 폴더를 지정할 수 있고 실행 중 추가·제거되는 하위 폴더도 자동 인식된다
- 디스크에 저장되는 도구 결과에 1GB 상한이 생겼고 저장 파일이 잘린 경우 대화 내 미리보기에 표시된다
- 포그라운드 서브에이전트 재개, 팀메이트·서브에이전트의 SubagentStart 훅 컨텍스트 및 선로드 스킬 처리에서 프롬프트 캐시 재사용이 깨지던 문제가 수정됐다
- 도구 실행 중 프로세스가 종료된 뒤 재개 시 마지막 프롬프트가 재작성되지 않고 중단된 도구 호출이 interrupted로 표시되도록 수정됐다
- /model opusplan[1m] 거부, /clear 지연, /config 탭 전환 시 높이 변경, 두 키 단축키 타임아웃 등 다수의 UI·명령 버그가 수정됐다
- Claude 앱 게이트웨이 텔레메트리에 user.email과 user.groups가 추가됐고 OTLP 릴레이의 전달 중단 문제가 수정됐다
v2.1.263GitHub 릴리스
릴리스 노트 없음
v2.1.261GitHub 릴리스
- /status와 claude doctor에 조직 정책을 불러오지 못한 이유를 보여주는 Organization policy 항목이 추가됐다
- bashOutputMaxChars와 taskOutputMaxChars 설정이 추가돼 명령 및 백그라운드 작업 출력이 파일로 저장되기 전 인라인으로 받을 수 있는 분량을 최대 128K자까지 늘릴 수 있다
- --append-subagent-system-prompt-file 옵션이 추가돼 너무 긴 서브에이전트 시스템 프롬프트를 파일로 읽어올 수 있다
- /skill-doctor 명령이 추가돼 사용되지 않는 스킬과 그 컨텍스트 비용을 확인해 정리할 수 있다
- 빠른 입력이나 키 반복 시 문자 순서가 뒤바뀌거나 누락되는 문제, /add-dir의 잘못된 오류 표시, Bedrock 설정 마법사 무응답 문제 등 다수의 버그가 수정됐다
- Remote Control과 관련해 권한 모드 표시 오류, 세션이 멈춘 것처럼 보이는 문제, 세션 업로드 중복, TLS 검사 프록시 환경에서의 이벤트 스트림 실패 등 여러 문제가 수정됐다
v2.1.260GitHub 릴리스
- 대화 화면 옆에 커밋되지 않은 변경 사항을 보여주는 diff 패널이 추가되어 /diff로 전환할 수 있다
- /cost와 상태줄의 prompt_cache 필드에 프롬프트 캐시 미스의 예상 원인이 표시된다
- 헤드리스 세션에 /reload-plugins가 추가됐고, 데스크톱 앱과 헤드리스 세션에서 텍스트 형태의 /advisor 명령을 사용할 수 있다
- 괄호가 포함된 경로의 권한 규칙이 무시되던 문제, 잘못된 정규식 패턴으로 모든 파일 편집이 실패하던 문제 등 권한·샌드박스 관련 버그가 다수 수정됐다
- Fable 5.1 모델 선택, 프롬프트 캐싱, 컨텍스트 창 설정과 관련된 여러 오류가 수정됐다
- /rewind, -p --resume/--continue, Remote Control의 모델 선택 검증 등 세션 복구 및 관리 관련 버그가 수정됐다
v2.1.259GitHub 릴리스
- organizations이 모든 사용자에게 HTTP/SSE MCP 서버를 배포할 수 있는 managedMcpServers 관리 설정과, 프롬프트를 자동으로 거부하는 --permission-prompts none 옵션이 추가됐다
- glab mr create/merge/close/reopen/note/update 명령을 인식해 도구 요약과 푸터에 MR 배지가 표시되고, claude plugin validate에 --json 출력이 추가됐다
- 여러 세션을 동시에 실행할 때 ~/.claude.json 변경 사항이 서로 덮어써지던 문제와 workspace trust 초기화 문제가 수정됐다
- Bash Read() 차단 규칙이 옵션 값, git diff/grep 대상, cd&&cat 조합의 파일을 놓치던 문제가 수정됐고 grep -r/cp -r 대상 디렉터리에 차단 파일이 있으면 확인을 요청한다
- 커스텀 명령·스킬의 frontmatter model 설정이 auto mode와 대화형 세션에서 무시되던 문제, --resume/--continue 실패 문제 등 다수 버그가 수정됐다
- 관리형 설정 파일이나 MDM plist를 파싱하지 못할 때 조용히 무시되던 대신 이제 실행을 거부하고 원인 소스를 표시한다
v2.1.258GitHub 릴리스
- macOS 12(Monterey)에서 실행이 안 되던 회귀 버그가 수정됐다
- 재전송된 권한 승인이 적용되지 않아 원격 및 예약된 세션이 실패하던 문제가 수정됐다
v2.1.257GitHub 릴리스
- Claude Fable 5.1이 기본 Fable 모델로 추가됐으며 100만 컨텍스트와 캐시 읽기 요금을 지원한다
- turn-end 시계와 트랜스크립트 타임스탬프에 12시간·24시간·UTC·strftime 패턴을 선택할 수 있는 timeFormat과 timeZone 설정이 추가됐다
- auto 모드에 클라우드 메타데이터 자격 증명 탈취 등을 자동 승인하지 않는 Containment Escape 규칙이 추가되고, 작업 디렉터리 밖 파일 읽기 시 최초 1회 확인 프롬프트와 permissions.blockReadsOutsideWorkingDirectories 옵션이 추가됐다
- CLAUDE_CODE_SUBAGENT_MODEL_FORCE로 모든 서브에이전트에 지정 모델을 강제 적용할 수 있고, /effort에 s 옵션으로 현재 세션에만 effort를 변경할 수 있다
- 백그라운드 세션 시작 실패, Remote Control 재연결 시 프롬프트 캐시 미스, Bedrock·Vertex·Foundry 등 인증 헤더 중복·오작동, 텔레메트리 설정 누락 등 다수의 안정성 버그가 수정됐다
v2.1.252GitHub 릴리스
- 일부 Mac에서 tasks 디렉터리 이동/링크로 인한 "task output swap refused" 오류로 Bash 명령이 실패하던 문제가 수정됐다
- .claude/settings.local.json 파일이 없는 프로젝트에서 "always allow" 설정이 저장되지 않던 문제가 수정됐다
- claude.ai 연결이 불안정할 때 Claude Desktop이나 VS Code가 호스팅하는 Remote Control 세션이 도구 실행 완료 후 수 분간 멈추던 문제가 수정됐다
- 디스크 가득 참으로 인한 git 오류 등 매우 큰 실패 출력이 포함된 백그라운드 작업 알림이 API 요청 크기 제한을 초과하던 문제가 수정됐다