업데이트 내역
Claude Code 고급 활용 핸드북 변경 로그
이 문서는 핸드북 내용 업데이트와 **근거(공식 Changelog/릴리스)**를 추적합니다. “제품 변화 → 핸드북 반영”의 연결성을 유지하기 위한 운영용 기록입니다.
최종 업데이트
2026년 4월 20일 기준
운영 원칙
- 근거 기반 반영: GitHub Changelog/릴리스 확인 후 문서 업데이트
- 영향 범위 명시: 어떤 챕터에 어떤 변화를 반영했는지 기록
- 신규 기능 우선: 기능 추가/워크플로우 변화/운영 영향이 큰 항목부터 반영
최근 업데이트
2026-04-20
반영한 공식 변경(요약)
- 최신 안정 버전 상향 (
v2.1.114): 최신 stable 기준을v2.1.114로 갱신하고, permission dialog crash fix를 최신 릴리즈로 기록 - 런처/설치 경로 정리 (
v2.1.113): CLI가 플랫폼별 네이티브 Claude Code binary를 실행하도록 바뀐 점을 반영하고, 네이티브 인스톨러/Homebrew/WinGet 우선 원칙을 강화 - 샌드박스 네트워크 예외 차단 (
v2.1.113):sandbox.network.deniedDomains와allowedDomains우선순위, 운영 활용 예시 반영 - 권한 프롬프트/명령 명칭 정리 (
v2.1.111~v2.1.113+ 현재 commands docs):/less-permission-prompts를 현재 공식 명칭/fewer-permission-prompts로 정리하고,cd <current-directory> && git ...no-op 패턴의 prompt 완화 반영 - Remote Control / loop / subagent 운영성 보강 (
v2.1.113): Remote Control의/extra-usage,@파일 자동완성 질의,/loopwakeup 취소 UX, subagent 10분 stall failover 반영
영향 챕터
index.mdx— 기준일을v2.1.114로 올리고 최신 운영/보안 하이라이트 추가setup.mdx— native binary 런처와sandbox.network.deniedDomains반영headless.mdx— Remote Control 보강,/loopwakeup UX, no-opcd && gitprompt 완화 반영subagents.mdx— stalled subagent 10분 failover 반영skills-commands.mdx—/fewer-permission-prompts현재 명칭 정리verification.mdx—v2.1.114,deniedDomains, native launcher, Remote Control 교차검증 추가updates.mdx— 본 기록 추가
근거 링크(공식/공개)
- https://github.com/anthropics/claude-code/releases/tag/v2.1.114
- https://github.com/anthropics/claude-code/releases/tag/v2.1.113
- https://code.claude.com/docs/en/commands
- https://code.claude.com/docs/en/configuration
2026-04-17
반영한 공식 변경(요약)
- Opus 4.7 / xhigh / Max Auto mode 경로 정리 (
v2.1.111):xhigheffort,/effort슬라이더, Max 사용자의 Opus 4.7 Auto mode 접근 경로 단순화 반영 - 신규 명령/스킬 반영 (
v2.1.101,v2.1.108,v2.1.110,v2.1.111):/team-onboarding,/recap,/focus,/tui,/less-permission-prompts,/ultrareview - 컨텍스트 복귀 UX 보강 (
v2.1.108~v2.1.110): session recap 기본화와/recap수동 호출 경로 반영 - 훅/워크트리 운영 보강 (
v2.1.105):PreCompactblock 지원,EnterWorktree(path)지원 반영 - 헤드리스/권한 운영 변경 (
v2.1.111):stream-jsoninitplugin_errors, 읽기 전용 glob Bash와cd <project-dir> && ...패턴의 권한 프롬프트 완화 반영 - 스킬 시스템 최신화 (
v2.1.105,v2.1.108): Skill tool이 내장 슬래시 명령을 호출할 수 있는 점, 스킬 description listing cap 확대(1,536자) 반영 - 설치 경로 정리 (
v2.1.111+ 최신 setup docs): 네이티브 인스톨러/Homebrew/WinGet 우선, npm deprecated 유지
영향 챕터
index.mdx— 기준일과 하이라이트를v2.1.112기준으로 갱신setup.mdx— 설치 경로, 업데이트 채널, Opus 4.7/xhigh, Auto mode 최신 조건 반영multi-session.mdx—EnterWorktree(path), scheduled task 복구 반영hooks.mdx—PreCompactblock 패턴 반영skills-commands.mdx— 신규 명령, Skill tool-내장 명령 연결, description 예산 최신화context.mdx—/recap, away summary/session recap 반영headless.mdx— PowerShell 프리뷰 롤아웃,stream-json plugin_errors, 권한 프롬프트 완화 반영ide.mdx— 이미지 첨부 UX 개선 반영subagents.mdx— 최신 운영 메모 범위를v2.1.112까지 확장verification.mdx— 최신 안정 버전과 교차검증 항목 갱신updates.mdx— 본 기록 추가
근거 링크(공식/공개)
- https://github.com/anthropics/claude-code/releases/tag/v2.1.112
- https://github.com/anthropics/claude-code/releases/tag/v2.1.111
- https://github.com/anthropics/claude-code/releases/tag/v2.1.110
- https://github.com/anthropics/claude-code/releases/tag/v2.1.108
- https://github.com/anthropics/claude-code/releases/tag/v2.1.105
- https://code.claude.com/docs/en/commands
- https://code.claude.com/docs/en/setup
- https://code.claude.com/docs/en/tools-reference
2026-04-12
반영한 공식 변경(요약)
/agents실행 가시성 강화 (v2.1.97~v2.1.98): agent type 옆● N running표시, Running/Library 탭, Library의Run agent/View running instance액션/claude-api의 Managed Agents 확장 (v2.1.91,v2.1.97~v2.1.98): Claude API/SDK 예제뿐 아니라 agent design patterns, tool surface, context management, caching strategy, Managed Agents 설계 출발점 반영- 권한/상태 전달 안정화 (
v2.1.98):--dangerously-skip-permissions에서 team agent가 leader permission mode를 상속하고, 실패한 background subagent도 partial progress를 부모에 보고 - 격리 실행 안정화 (
v2.1.97~v2.1.101): worktree isolation 또는cwd:override가 부모 Bash 작업 디렉토리를 오염시키지 않도록 수정되고, isolated worktree subagent가 자기 worktree 파일을 Read/Edit 가능하도록 보강 - 도구 상속/복구 보강 (
v2.1.101): 동적으로 주입된 MCP 서버의 도구가 subagent에도 상속되고,--resume복구 시 무관한 subagent 대화 체인으로 연결되는 문제 수정
영향 챕터
index.mdx— 기준일과 하이라이트를v2.1.101기준으로 갱신subagents.mdx— 최신 운영 메모(권한 전달, partial progress, MCP 상속, worktree 격리 안정화) 추가skills-commands.mdx—/claude-api설명을 Managed Agents까지 확장verification.mdx— 최신 안정 버전과 agent 관련 교차검증 항목 갱신updates.mdx— 본 기록 추가
근거 링크(공식/공개)
- https://github.com/anthropics/claude-code/releases/tag/v2.1.101
- https://github.com/anthropics/claude-code/releases/tag/v2.1.98
- https://github.com/anthropics/claude-code/releases/tag/v2.1.97
- https://github.com/anthropics/claude-code/releases/tag/v2.1.91
2026-04-08
반영한 공식 변경(요약)
forceRemoteSettingsRefresh정책 (v2.1.92): 원격 managed settings를 새로 받아오기 전까지 시작 차단, fetch 실패 시 종료하는 fail-closed 동작- Bedrock 로그인 마법사 (v2.1.92): 로그인 화면의 "3rd-party platform" 경로에서 AWS 인증/리전/모델 pinning 안내
/cost세분화 (v2.1.92): 구독 사용자에게 모델별 사용량과 cache-hit breakdown 제공/release-notes인터랙티브 버전 피커 (v2.1.92): 특정 버전 릴리스 노트 탐색 UX 개선/tag//vim제거 (v2.1.92): 각각 세션 태그 명령과 Vim 토글 명령 제거,vim은/config→ Editor mode로 대체/powerup(v2.1.90): 애니메이션 데모가 포함된 대화형 학습 명령disableSkillShellExecution(v2.1.91): skills/custom commands/plugin commands의 inline shell 실행 비활성화- 플러그인
bin/실행 파일 (v2.1.91): Bash 도구에서 bare command처럼 호출 가능 CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE(v2.1.90): 오프라인 환경에서 마켓플레이스 캐시 유지- MCP 결과 보존 override (v2.1.91):
_meta["anthropic/maxResultSizeChars"]로 최대 500K자까지 결과 유지 MCP_CONNECTION_NONBLOCKING=true(v2.1.89):-p실행에서 MCP 연결 대기 생략,--mcp-config연결 5초 상한- PreToolUse
defer결정 (v2.1.89): 헤드리스 세션을 도구 호출 시점에서 일시 정지 후-p --resume으로 재평가 - Remote Control hostname prefix (v2.1.92): 세션 이름 기본 prefix가 호스트명으로 변경, flag로 오버라이드 가능
- 멀티라인
claude-cli://open?q=딥링크 (v2.1.91):%0A줄바꿈 지원 - Linux
apply-seccomphelper (v2.1.92): npm/네이티브 설치 모두 unix-socket 차단 복구 - PowerShell 권한 검사 하드닝 (v2.1.90): background 우회, debugger hang, archive extraction 관련 보안 보강
영향 챕터
index.mdx— 기준일과 하이라이트를 v2.1.92 기준으로 갱신setup.mdx— Bedrock 마법사,forceRemoteSettingsRefresh, Auto 모드 Recent 재시도 반영hooks.mdx— PreToolUsedefer, 대용량 훅 출력 디스크 저장 반영mcp.mdx— nonblocking 연결, 결과 보존 크기 override 반영skills-commands.mdx—/powerup,disableSkillShellExecution, 플러그인bin//캐시 운영 반영context.mdx— Edit 도구 토큰 절감, prompt cache 만료 복귀 힌트 반영ide.mdx— 멀티라인 딥링크 반영headless.mdx— Linux 샌드박스 helper, PowerShell 하드닝, Remote Control prefix 반영verification.mdx— 최신 버전/교차검증 항목 갱신updates.mdx— 본 기록 추가
근거 링크(공식/공개)
- https://github.com/anthropics/claude-code/releases
- https://github.com/anthropics/claude-code/releases/tag/v2.1.92
- https://github.com/anthropics/claude-code/releases/tag/v2.1.91
- https://github.com/anthropics/claude-code/releases/tag/v2.1.90
- https://github.com/anthropics/claude-code/releases/tag/v2.1.89
2026-03-31
반영한 공식 변경(요약)
- Auto 모드 (2026-03-24): AI 분류기가 도구 호출 위험도를 평가, 안전 작업 자동 진행/위험 작업 차단.
default와bypassPermissions중간 지점 - Computer Use (2026-03-24, 연구 프리뷰): macOS 화면 제어(마우스/키보드). Pro/Max 전용, Desktop 앱에서 활성화
- Dispatch (2026-03-17): iPhone에서 작업 전송 → 데스크탑 자동 실행 → 완료 알림 수신. 전 플랜 사용 가능
- PowerShell 도구 (v2.1.84): Windows 네이티브 PowerShell 도구 opt-in 프리뷰
PermissionDenied훅 (v2.1.88): Auto 모드 분류기 거부 시 발생,{retry: true}응답으로 재시도 가능CwdChanged/FileChanged훅 (v2.1.83): 작업 디렉토리 변경 및 파일 변경 감지 이벤트TaskCreated훅 (v2.1.84): 태스크 생성 시 발생하는 이벤트- 조건부
if필드 (v2.1.85): 훅에 퍼미션 규칙 구문으로 실행 조건 세밀 제어 (예:Bash(git *)) initialPrompt에이전트 frontmatter (v2.1.83): 에이전트 생성 시 자동 프롬프트 제출- Named 서브에이전트
@타입어헤드 (v2.1.88): 이름 지정된 서브에이전트를 @ 멘션으로 빠르게 선택 - MCP OAuth RFC 9728 (v2.1.85): Protected Resource Metadata 디스커버리 지원
- MCP 서버 중복 제거 (v2.1.84): 로컬 설정이 claude.ai 커넥터보다 우선
- MCP 도구 설명 2KB 제한 (v2.1.84): 도구 설명/서버 지시문 크기 제한
- 스킬
paths:frontmatter (v2.1.84): YAML 리스트로 glob 패턴 지정, 경로 기반 활성화 - 스킬 설명 250자 제한 (v2.1.86):
/skills메뉴 알파벳순 정렬 - Thinking summaries 기본 비활성화 (v2.1.88):
showThinkingSummaries: true로 복원 가능 managed-settings.d/드롭인 디렉토리 (v2.1.83): JSON 파일 드롭인으로 managed settings 조합sandbox.failIfUnavailable(v2.1.83): 샌드박스 없는 환경에서 실행 거부 강제CLAUDE_CODE_SUBPROCESS_ENV_SCRUB=1(v2.1.83): 서브프로세스 자격증명 환경변수 제거CLAUDE_CODE_NO_FLICKER=1(v2.1.88): alt-screen 렌더링 깜빡임 제거- 트랜스크립트 검색 (v2.1.83):
Ctrl+O→/키로 대화 내용 검색,n/N으로 탐색 - Read 도구 압축 포맷 (v2.1.86): 압축된 줄번호 + 중복 읽기 제거
@멘션 토큰 오버헤드 감소 (v2.1.86): 파일 멘션 시 토큰 효율 향상X-Claude-Code-Session-Id헤더 (v2.1.86): API 요청에 세션 ID 자동 포함CLAUDE_STREAM_IDLE_TIMEOUT_MS(v2.1.84): 스트리밍 유휴 타임아웃 설정 (기본 90초)- PreToolUse
updatedInput응답 (v2.1.85): AskUserQuestion 입력 자동 대체 - PreToolUse/PostToolUse
file_path절대 경로 (v2.1.88): 훅 입력의 파일 경로 정규화 - 유휴 복귀 프롬프트 (v2.1.84): 75분 이상 유휴 시
/clear제안 .jj/.slVCS 제외 (v2.1.86): Jujutsu, Sapling VCS 지원- 프롬프트 캐시 미스 수정 (v2.1.88), 중첩 CLAUDE.md 중복 주입 수정 (v2.1.88), StructuredOutput 스키마 캐시 수정 (v2.1.88)
영향 챕터
index.mdx— updatedAt 갱신, 하이라이트에 Auto 모드/Dispatch/Computer Use/PowerShell 추가setup.mdx— Auto 모드, managed-settings.d/, sandbox.failIfUnavailable, thinking summaries, 렌더링 최적화hooks.mdx— PermissionDenied, CwdChanged, FileChanged, TaskCreated 이벤트, 조건부 if 필드, PreToolUse 고급 응답subagents.mdx— initialPrompt frontmatter, @ 멘션 타입어헤드mcp.mdx— RFC 9728 OAuth, 서버 중복 제거, 도구 설명 제한, headersHelper 환경변수skills-commands.mdx— paths: glob, 설명 250자 제한, 알파벳순 정렬context.mdx— thinking summaries 비활성화, Read 도구 압축, @ 멘션 토큰 감소, 메모리 인터랙션ide.mdx— Dispatch, Computer Use, Desktop 앱, 트랜스크립트 검색, 외부 에디터, 딥링크 개선headless.mdx— PowerShell 도구, 세션 추적 헤더, 스트림 타임아웃updates.mdx— 본 기록 추가
근거 링크(공식/공개)
- https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md
- https://www.anthropic.com/engineering/claude-code-auto-mode (Auto Mode 엔지니어링 블로그)
- https://claude.com/blog/dispatch-and-computer-use (Dispatch & Computer Use 블로그)
2026-03-25
반영한 공식 변경(요약)
- Opus 4.6 기본 최대 출력 64k (v2.1.77): 기본 출력 토큰이 64k로 증가, 상한 128k
--bare경량 실행 플래그 (v2.1.81): 스크립트용-p호출에서 hooks, LSP, 플러그인 동기화, 스킬 디렉토리 탐색을 건너뜀.ANTHROPIC_API_KEY또는apiKeyHelper필요--channels연구 프리뷰 (v2.1.80): MCP 서버가 세션에 메시지를 직접 푸시 가능--channels퍼미션 릴레이 (v2.1.81): 채널 서버가 도구 승인 프롬프트를 폰으로 전달- MCP OAuth CIMD (SEP-991) (v2.1.81): Client ID Metadata Document 지원
/fork→/branch이름 변경 (v2.1.77):/fork는 별칭으로 유지- Agent
resume파라미터 제거 (v2.1.77, Breaking):SendMessage({to: agentId})방식으로 대체 StopFailure훅 이벤트 (v2.1.78): API 에러로 턴이 종료될 때 발생effortfrontmatter (v2.1.80): 스킬/슬래시 커맨드/플러그인 에이전트에서 effort 레벨 오버라이드--console인증 (v2.1.79):claude auth login --console로 API 빌링 인증ANTHROPIC_CUSTOM_MODEL_OPTION(v2.1.78):/model피커에 커스텀 항목 추가source: 'settings'플러그인 (v2.1.80): settings.json에서 인라인 플러그인 선언- VS Code
/remote-control(v2.1.79): claude.ai/code에 브릿지 세션 - VS Code AI 세션 제목 (v2.1.79): 첫 메시지 기반 자동 제목 생성
rate_limits상태 표시줄 (v2.1.80): 5시간/7일 rate limit 사용량 표시- worktree 세션 재개 자동 전환 (v2.1.81):
--resume으로 worktree 세션 재개 시 자동 복귀 --resume성능 개선 (v2.1.77): 최대 45% 빠른 로딩, ~100-150MB 메모리 절감- macOS 시작 ~60ms 빠르게 (v2.1.77), 시작 시 ~80MB 메모리 절감 (v2.1.80)
- 줄단위 응답 스트리밍 (v2.1.78): 응답이 생성되는 대로 줄 단위 스트리밍
!bash 모드 발견성 개선 (v2.1.81)- Voice mode WebSocket 복구 (v2.1.81): 연결 끊김 시 자동 복구
- PreToolUse
"allow"보안 수정 (v2.1.77):deny퍼미션 규칙이 정상 적용 /copy N(v2.1.77): N번째 최근 응답 복사- "Show turn duration" 토글 (v2.1.79):
/config에서 턴 소요 시간 표시 - Plan 모드 "clear context" 기본 숨김 (v2.1.81)
영향 챕터
index.mdx— updatedAt 갱신, 하이라이트에 v2.1.77-81 주요 기능 추가setup.mdx— Opus 64k 출력, 커스텀 모델, effort auto 표시, rate_limits, --console, turn durationhooks.mdx— StopFailure 이벤트, CLAUDE_PLUGIN_DATA, PreToolUse 보안 수정mcp.mdx— Channels 신규 섹션, OAuth CIMD, 도구 호출 접기, deny 규칙multi-session.mdx— /branch 이름 변경, worktree 자동 전환, 세션 자동 이름, --resume 성능subagents.mdx— Agent resume 제거(Breaking), 플러그인 에이전트 frontmatterskills-commands.mdx— /copy N, /branch, effort frontmatter, 플러그인 관리headless.mdx— --bare 플래그, VS Code remote-control, Remote Control 안정성context.mdx— progress message compaction 개선, 백그라운드 bash 5GB 제한ide.mdx— VS Code remote-control, AI 세션 제목, 플랜 탭 제목, Windows 호환성vibe-coding.mdx— /branch, 줄단위 스트리밍, ! bash 모드, Voice 안정성plan-mode.mdx— clear context 기본 숨김verification.mdx— 검증일 갱신, 교차검증 테이블 보강updates.mdx— 본 기록 추가
근거 링크(공식/공개)
2026-03-17
반영한 공식 변경(요약)
- Opus 4.6 1M 컨텍스트 기본화 (v2.1.75): Max, Team, Enterprise 플랜에서 Opus 4.6의 1M 컨텍스트 윈도우가 기본 활성화. 기존 Fast mode 한정이었던 것이 모든 모드로 확대
- MCP elicitation 지원 (v2.1.76): MCP 서버가 작업 중간에 구조화된 입력을 사용자에게 요청 가능.
Elicitation/ElicitationResult훅 이벤트 추가 PostCompact훅 이벤트 (v2.1.76): compaction 완료 후 발생하는 훅으로 로깅/알림 자동화에 활용-n/--name세션 이름 플래그 (v2.1.76): CLI에서 세션 표시 이름을 부여 가능worktree.sparsePaths(v2.1.76): worktree 모드에서 git sparse-checkout 활성화, 대규모 모노레포에서 worktree 생성 속도 개선/color프롬프트 바 색상 (v2.1.75): 세션별 프롬프트 바 색상 커스터마이징- 메모리 파일 last-modified 타임스탬프 (v2.1.75): 메모리 파일에 마지막 수정 시각이 기록되어 오래된 메모리를 식별하기 쉬워짐
- 훅 출처 표시 (v2.1.75): 권한 프롬프트에서 훅이 어디에서 왔는지 표시
- Windows managed settings 경로 제거 (v2.1.75, Breaking): deprecated된
C:\ProgramData\ClaudeCode\경로가 제거됨 - deferred tools compaction 버그 수정 (v2.1.76): deferred tools가 compaction 후 스키마를 잃는 문제 수정
- 자동 compaction 회로 차단기 (v2.1.76): 자동 compaction이 3회 초과 시도되지 않도록 제한
- 세션 품질 설문 (v2.1.76): Enterprise 관리자용 세션 품질 피드백 메커니즘 추가
영향 챕터
index.mdx— updatedAt 갱신, 하이라이트에 1M 기본화/MCP elicitation 추가setup.mdx— 1M 컨텍스트 기본,-n플래그, Windows managed settings 제거mcp.mdx— MCP elicitation 신규 섹션hooks.mdx— PostCompact, Elicitation, ElicitationResult 훅 추가context.mdx— 1M 컨텍스트 기본화 문구 갱신multi-session.mdx— worktree.sparsePaths 섹션 추가updates.mdx— 본 기록 추가
근거 링크(공식/공개)
2026-03-14
반영한 공식 변경(요약)
- Sonnet 4.6 모델 출시(2026-02-17) 및 Sonnet 4.5→4.6 자동 마이그레이션 반영
- Enterprise 플랜 정보 추가 ($20/좌석 + 사용량 기반, SCIM, 감사 로그)
/model피커 읽기 좋은 라벨 표시 + 업그레이드 힌트 (v2.1.51) 반영/copy인터랙티브 피커 +w키 파일 쓰기 (v2.1.59, v2.1.72) 반영/color세션 색상 변경 (v2.1.70),/rename세션 이름 변경 (v2.1.70) 반영/output-styledeprecated 안내 추가 (v2.1.73,/config대체)- Voice STT 20개 언어 지원 (v2.1.69),
voice:pushToTalk키바인딩 커스터마이즈 (v2.1.71) 반영 - 음성 인식 정확도 개선: 레포명, 개발 용어 (v2.1.72) 반영
- effort 레벨 기호 표기 (○ ◐ ●) 명시
- 검증 리포트 교차검증 섹션 대폭 보강 (모델/버전 + 주요 기능 13개 항목)
- index.mdx 하이라이트에 Sonnet 4.6, Code Review, Remote Control 추가
- Code Review 연구 프리뷰 신규 섹션: 멀티에이전트 PR 리뷰, REVIEW.md 커스터마이즈, 심각도 레벨, 요금(25/리뷰)
- Remote Control 섹션 대폭 확장: 전 플랜 사용 가능, 보안 모델, 자동 활성화 설정
- REVIEW.md 개념 소개 (claude-md.mdx)
/security-review번들 커맨드 추가
영향 챕터
index.mdx— updatedAt 갱신, 하이라이트에 Code Review/Remote Control 추가setup.mdx— Sonnet 4.6, Enterprise 플랜, /model 피커 개선claude-md.mdx— REVIEW.md 섹션 추가skills-commands.mdx— /copy, /color, /rename, /security-review, /output-style deprecatedheadless.mdx— Code Review 신규 섹션, Remote Control 대폭 확장vibe-coding.mdx— Voice 20개 언어, pushToTalk, effort 기호verification.mdx— 교차검증 테이블 보강, 링크 추가, 검증일 갱신updates.mdx— 본 기록 추가
근거 링크(공식/공개)
- https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md
- https://github.com/anthropics/claude-code/releases
- https://code.claude.com/docs/en/code-review (Code Review 공식 문서)
- https://code.claude.com/docs/en/remote-control (Remote Control 공식 문서)
- https://www.anthropic.com/news (Sonnet 4.6, 2026-02-17)
- https://claude.com/ko-kr/pricing (Enterprise 플랜)
2026-03-13
반영한 공식 변경(요약)
- v2.1.74 기준 최신 반영 (기존 v2.1.39 → v2.1.74, 35개 버전)
- Worktree 격리 시스템:
--worktree플래그(v2.1.49),EnterWorktree/ExitWorktree(v2.1.72),isolation: "worktree"에이전트 정의(v2.1.50) - 추론 강도 제어:
/effort명령(v2.1.72), "ultrathink" 키워드(v2.1.68), Opus 4.6 medium 기본값(v2.1.68) - 자동화 확장:
/loop크론 스케줄(v2.1.71), HTTP hooks(v2.1.63), 신규 훅 이벤트 4종(ConfigChange,InstructionsLoaded,WorktreeCreate/Remove) - 컨텍스트 최적화:
/context액셔너블 제안(v2.1.74), 자동 메모리 기록(v2.1.59), 도구 결과 디스크 저장 임계값 50K(v2.1.51) - VS Code 강화: MCP 관리 다이얼로그(v2.1.70), 플랜 마크다운 뷰(v2.1.70), 스파크 아이콘 세션 목록(v2.1.70)
- MCP 고도화: OAuth step-up auth(v2.1.49), 바이너리 콘텐츠 처리(v2.1.69), claude.ai 커넥터(v2.1.63)
/fork(v2.1.71),/color(v2.1.70),/rename(v2.1.70), CLAUDE.md HTML 주석 숨김(v2.1.72) 등 다수 기능 반영
영향 챕터
- 전 챕터(Ch1~Ch12) 업데이트
index.mdx버전 기준일 및 하이라이트 갱신
근거 링크(공식/공개)
2026-02-11
반영한 공식 변경(요약)
v2.1.39기준 최신 안정화 반영- 중첩 Claude Code 세션 실행 방지 가드
- MCP 이미지 스트리밍 크래시 수정,
/resume미리보기 가독성 개선 - 터미널 렌더링 성능/안정성 개선
v2.1.36~v2.1.33큰 변화 반영- Opus 4.6 대상 Fast mode 지원
- Agent Teams 실험 기능 이후 다중 에이전트 운영 기능 확장
- 신규 Hook 이벤트
TeammateIdle,TaskCompleted - 에이전트
tools에서Task(agent_type)제한 지원 - 에이전트
memoryfrontmatter(user/project/local) 지원
v2.1.32반영- 자동 메모리 기록/재호출
- 메시지 선택기 “Summarize from here” 추가
--add-dir경로의.claude/skills/자동 로드
v2.1.30운영 기능 반영- Read 도구 PDF
pages파라미터 지원 - MCP OAuth 비DCR 서버용
--client-id,--client-secret지원 /debug명령 도입- Task 결과에 토큰/도구 사용 수/소요 시간 메트릭 추가
--resume메모리 사용량 개선(릴리스 노트 기준 68% 절감)
- Read 도구 PDF
v2.1.27반영--from-pr로 PR 기반 세션 재개gh pr create로 생성한 세션의 PR 자동 연결
v2.1.18반영/keybindings기반 단축키 커스터마이징
v2.1.15반영- npm 설치 경로 deprecation 안내(
claude install/공식 설치 스크립트 권장)
- npm 설치 경로 deprecation 안내(
사람들 반응이 큰 항목 (GitHub 공개 이슈 반응 기준)
- 단축키 커스터마이징 수요: #9177 (reactions 19), #5376 (reactions 34)
- Agent Teams 확장 수요: #23574 (reactions 18), #24122 (reactions 15)
참고: “반응”은 공개 이슈의 댓글/리액션 수로 간접 판단했습니다.
영향 챕터
index.mdxsubagents.mdxhooks.mdxmcp.mdxheadless.mdxmeta.json
근거 링크(공식/공개)
- https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md
- https://github.com/anthropics/claude-code/releases/tag/v2.1.39
- https://github.com/anthropics/claude-code/releases/tag/v2.1.33
- https://github.com/anthropics/claude-code/releases/tag/v2.1.32
- https://github.com/anthropics/claude-code/releases/tag/v2.1.30
- https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md#v2118
- https://code.claude.com/docs/en/keybindings
- https://code.claude.com/docs/en/fast-mode
- https://github.com/anthropics/claude-code/issues/9177
- https://github.com/anthropics/claude-code/issues/5376
- https://github.com/anthropics/claude-code/issues/23574
- https://github.com/anthropics/claude-code/issues/24122
업데이트 기록 템플릿
아래 형식을 복사해 새 기록을 추가하세요.
### YYYY-MM-DD
**반영한 공식 변경(요약)**
- ...
**사람들 반응이 큰 항목 (선택)**
- ...
**영향 챕터**
- ...
**근거 링크(공식/공개)**
- https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md