최신 업데이트

이 페이지는 Claude Code 공식 CHANGELOG를 기반으로 버전별 주요 변경사항을 정리합니다. 매일 자동으로 갱신됩니다.

---

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에 행이 다시 나타나던 문제 수정
• 로그인 안내 수정 — 이 로그아웃 상태일 때 "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를 참고하세요.