변경 이력 확인법

기준일: 2026-07-26
난이도: 초급
공식 기준: Claude Code changelog, What's new

Claude Code는 자주 배포됩니다. 전체 버전 노트를 이 페이지에 복제하면 곧 낡습니다. 아래는 문서화 기준 구간(2.1.145 → 2.1.220) 의 고신호 변경과, 이후에도 쓰는 확인 절차입니다.

검증 시점(2026-07-26) 공식 changelog 최상단은 2.1.220 (2026-07-25) 입니다. 이 값은 사이트가 영구 보장하는 최신이 아니라 당시 확인한 기준점입니다.

버전 대조 절차

claude --version
claude doctor
# 또는
claude /doctor

질문	확인할 곳
내 CLI 버전	claude --version
버전 단위 변경	Changelog
제품 표면 주간 흐름	What's new
설치/채널 문제	claude doctor, Setup 문서

업데이트 후 우선 볼 항목:

1. 권한, sandbox, auto mode, hooks, MCP 보안 변경
2. 설정 키·명령 제거/이름 변경
3. session, subagent, agent view, workflows 동작 변경
4. 기본 모델·fast mode 대상 변경
5. IDE/OS/cloud provider별 회귀 수정

2.1.145 → 2.1.220 고신호 변경 (주제별)

아래는 공식 changelog와 What's new(Week 21–29 및 인접 주차)에서 학습·운영 영향이 큰 항목만 묶은 요약입니다. 버그 픽스 전량은 공식 changelog를 보세요.

모델과 기본값

버전대	변경
2.1.219	Claude Opus 5 (claude-opus-5) 추가, 기본 Opus 모델. 1M context, fast mode 단가 표기 $10/$50 per MTok. /fast 대상에서 Opus 4.7 제거 → Opus 5·Opus 4.8
2.1.197~201 (W27)	Claude Sonnet 5가 Pro / Team Standard / Enterprise subscription seat 기본 모델. 네이티브 1M context
2.1.154~157 (W22)	Claude Opus 4.8 도입·일부 플랜 기본값. fast mode on Opus 4.8
2.1.170+	Fable 5 선택 가능 (기본값 아님). /model fable 또는 best

Anthropic API 기준 별칭 해석(2.1.219 이후): opus → Opus 5, sonnet → Sonnet 5. provider·조직 정책에 따라 다를 수 있으므로 /model이 최종 기준입니다. 상세: 모델 설정.

병렬 세션 · Agent view · 백그라운드

버전대	변경
2.1.139~142 (W20)	Agent view (claude agents): 여러 백그라운드 세션을 한 화면에서 디스패치·모니터링
2.1.205~212	agent view 행 요약 개선, PR 링크, /fork가 백그라운드 세션 복사(구 subagent fork는 /subtask), /doctor 풀 체크업(/checkup 별칭)
2.1.217	동시 subagent 상한(기본 20, CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS)
2.1.219	nested subagent 기본 깊이 3 (CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH)

로컬 가이드: Agent view.

목표 유지 · 스케줄 · 클라우드 자동화

버전대	변경
2.1.139+	/goal: 완료 조건이 만족될 때까지 턴 자동 연속
W16+	Routines (web): 스케줄·API·GitHub 이벤트로 클라우드 세션 자동 실행
기존	세션 내 /loop·cron vs cloud routines vs Desktop scheduled tasks 구분

로컬 가이드: Goal, Routines, 스케줄 작업.

Dynamic workflows · Ultracode

버전대	변경
2.1.154+	Dynamic workflows: 스크립트가 다수 subagent를 오케스트레이션. /deep-research, ultracode 키워드
2.1.202+	Dynamic workflow size 가이드라인 (/config)
2.1.203+	/effort ultracode, claude --effort ultracode
2.1.218	/deep-research는 수동 호출만 (자동 기동 중단)
2.1.219	기본 workflow size 가이드라인 medium(<15 agents). workflowSizeGuideline 설정 키

로컬 가이드: Dynamic workflows.

클라우드 계획 · 리뷰 · 아티팩트

버전대	변경
W15+	Ultraplan: CLI에서 계획 시작 → web plan mode 초안 → 로컬/원격 실행
W17+	Ultrareview (/code-review ultra, /ultrareview): 클라우드 multi-agent 리뷰
2.1.178~183 (W25)	Artifacts: 세션 출력을 claude.ai 공유 페이지로 게시
2.1.209+ (W29)	Artifact가 뷰어 MCP connector로 라이브 데이터 호출
2.1.218	/code-review 백그라운드 subagent 실행. ultrareview 인자·비대화형 동작 개선

로컬 가이드: Ultraplan·Ultrareview, Artifacts, 코드 리뷰.

권한 · Auto mode · 샌드박스

버전대	변경
W13+	Auto mode(리서치 → 확장): 분류기가 권한 프롬프트 대체
W21	Pro + Sonnet에서도 auto mode
W23	Bedrock / Agent Platform / Foundry에서 auto mode
2.1.207	위 third-party provider에서 auto mode opt-in 변수 불필요. disableAutoMode로 끔
2.1.205	transcript 변조 차단 규칙, 미해결 변수 대상 rm -rf 확인
2.1.216	sandbox.filesystem.disabled (파일 격리 off, 네트워크 제어 유지)
2.1.219	sandbox.network.strictAllowlist

상세: 권한 관리, 샌드박싱. Auto mode 조직 설정은 공식 auto-mode-config 확인.

접근성 · 입력 UX

버전대	변경
2.1.208	Screen reader mode: claude --ax-screen-reader, CLAUDE_AX_SCREEN_READER=1, "axScreenReader": true
2.1.217	emoji shortcode 자동완성 (:heart:), emojiCompletionEnabled
2.1.208	vimInsertModeRemaps (예: jj → Escape)

공식: Accessibility.

MCP · 플러그인 · 설정

버전대	변경
W26	claude mcp login / claude mcp logout
W25	/config key=value로 설정 직접 지정. deny/ask 규칙에 파라미터 매칭 Tool(param:value)
W24	/cd로 세션 작업 디렉터리 이동. --safe-mode 트러블슈팅
2.1.219	DirectoryAdded hook, headless init의 mcp_server_errors

플랫폼 · 브라우저 · Desktop

버전대	변경
W27	Claude in Chrome GA. Desktop Linux beta (Ubuntu/Debian). subagent 기본 백그라운드 실행
W28	Desktop 내장 브라우저. agent view·auto mode transcript 보호 강화
W18	Windows에서 Git Bash 없이 PowerShell 셸 도구 사용 가능

서브에이전트·워크플로 안전장치 (최근)

버전	변경
2.1.212	세션당 WebSearch·subagent spawn 상한. MCP 2분 초과 시 자동 백그라운드
2.1.214	EndConversation tool (남용/탈옥 시 세션 종료). 권한 검사 harden
2.1.215	Claude가 /verify, /code-review를 스스로 실행하지 않음 — 수동 호출
2.1.220	버그 픽스·안정성 (feature 없음)

실습

claude --version
# 예: 2.1.220 이하여야 이 문서 요약과 직접 대조 가능

공식 changelog에서 현재 버전 → 목표 버전만 읽고, 보안·모델·에이전트 관련 줄을 노트합니다.

이 프로젝트를 수정하지 말고 AGENTS.md와 주요 설정 파일을 읽어줘.
현재 세션에서 사용할 도구와 권한 경계를 요약해줘.

도구에 입력할 프롬프트

현재 claude --version과 공식 changelog의 해당 버전 항목을 대조해줘.
우리 프로젝트에 영향이 있을 수 있는 설정, 권한, hooks, MCP,
subagent, agent view, workflows, 기본 모델 변경만 추려서
근거 링크와 함께 정리해줘. 공식 문서에 없는 영향은 추정이라고 표시해줘.

체크리스트

• 설치 버전을 직접 확인했다.
• 공식 changelog에서 대상 버전 범위를 읽었다.
• 기본 모델·fast mode·auto mode 변경을 확인했다.
• agent view / workflows / goal 도입 여부를 팀 정책과 맞췄다.
• 업데이트 후 프로젝트 검증 명령을 실행했다.
• 특정 버전을 “영구 최신”처럼 단정하지 않았다.

다음 단계

• 최신 운영 기능 맵에서 제품 표면을 목적별로 고릅니다.
• 모델 설정에서 별칭·기본값·effort를 맞춥니다.
• What's new로 주간 제품 변화를 추적합니다.