Claude Code 2.1.0 대규모 업데이트 - Skill Hot-Reload부터 Vim 모션 강화까지

핵심 신기능

1. Skill Hot-Reload

1. ~/.claude/skills/my-skill/ 디렉토리 생성
2. SKILL.md 파일 작성 및 저장
3. Claude Code에서 즉시 사용 가능 (재시작 불필요)
4. 수정 시에도 실시간 반영

• YAML frontmatter 오류가 있으면 Skill 로딩 실패
• 파일명은 정확히 SKILL.md (대소문자 구분)
• 첫 줄에 --- 시작 필수 (빈 줄 없이)

2. Forked Sub-Agent Context

---
name: code-analysis
description: Analyze code quality in isolated context
context: fork
agent: Explore
---

• Explore: 코드베이스 탐색 및 분석
• Plan: 계획 수립 및 아키텍처 설계
• general-purpose: 범용 작업 (기본값)
• 커스텀: .claude/agents/에 정의된 에이전트

• 복잡한 멀티 스텝 작업을 메인 대화에 섞이지 않게 실행
• 전문화된 분석을 별도 컨텍스트에서 수행
• 서브에이전트별 독립적인 대화 히스토리 유지

3. Language Configuration

{
  "language": "Korean"
}

• Option+Arrow 단어 탐색이 CJK 텍스트를 전체 시퀀스가 아닌 단어 경계로 처리
• CJK 문자가 포함된 멀티라인 프롬프트의 여분의 빈 줄 제거
• IME (Input Method Editor) 지원 개선: 커서 위치에 정확한 조합 창 표시
• 단어 삭제(opt+delete) 및 단어 탐색이 키릴 문자, 그리스어, 아랍어, 히브리어, 태 국어, 중국어 등 비라틴 텍스트에서 정상 작동

4. 향상된 Vim Motions

5. 통합 백그라운딩

1. Claude Code에 백그라운드 실행 요청 또는 Ctrl+B 키 입력
2. 백그라운드 작업은 고유 ID를 가진 별도 셸에서 실행
3. 출력 모니터링, 상태 확인, 종료 가능
4. Tmux 사용자는 Ctrl+B를 두 번 눌러야 함 (tmux prefix 키 때문)

• 서버, 빌드, 기타 프로세스를 모니터링하면서 지속적인 개발
• 장시간 실행되는 테스트를 백그라운드로 보내고 다른 기능 작업
• 에이전트를 백그라운드에서 실행하고 다른 작업 수행

• 백그라운드 작업 완료 시 깔끔한 완료 메시지 표시 (noisy 출력 제거)
• 대량 출력 생성 시 30K 문자로 자동 truncate하여 API 컨텍스트 오버플로우 방지

6. MCP list_changed 알림

• notifications/tools/list_changed: 도구 목록 변경 알림
• notifications/prompts/list_changed: 프롬프트 목록 변경 알림
• notifications/resources/list_changed: 리소스 목록 변경 알림

1. MCP 서버가 도구 변경 알림을 보냄
2. Claude Code가 자동으로 해당 서버로부터 도구 목록 새로고침
3. /mcp 메뉴에 변경사항 즉시 반영

• 알림을 보내도 Claude Code가 응답하지 않음
• 동적 프롬프트 업데이트가 UI에 나타나지 않아 재시작 필요
• 커스텀 MCP 명령어가 .claude/commands/에 추가되어도 나타나지 않음

7. /plan 명령 단축키

8. 슬래시 명령 개선

claude --tools Read,Grep,Bash

9. Hook 기능 대폭 강화

• once: true 설정으로 세션당 한 번만 실행되는 Hook 지정
• frontmatter의 allowed-tools 필드에서 YAML 스타일 목록 지원
• 플러그인에서 prompt와 agent hook 타입 지원 (기존에는 command hook만 지원)
• 에이전트 frontmatter에서 PreToolUse, PostToolUse, Stop Hook 지원
• Skill 및 슬래시 명령어 frontmatter에서 Hook 지원

---
name: secure-operations
hooks:
  PreToolUse:
    - matcher: "Bash"
      hooks:
        - type: command
          command: "./scripts/security-check.sh"
---

hooks:
  - type: command
    command: "echo 'Session initialized'"
    once: true

• 알림: Claude Code가 입력 대기 시 커스텀 알림
• 자동 포맷팅: 파일 편집 후 prettier, gofmt 등 실행
• 로깅: 규정 준수/디버깅을 위한 실행 명령어 추적
• 피드백: 코드 규칙에 대한 자동 피드백 제공
• 커스텀 권한: 프로덕션 파일 또는 민감한 디렉토리 수정 차단

10. 에이전트 제어

{
  "permissions": {
    "deny": ["Task(Plan)", "Task(Explore)"]
  }
}

11. Bash 와일드카드 패턴

Bash(npm *)      # npm으로 시작하는 모든 명령어
Bash(* install)  # install로 끝나는 모든 명령어
Bash(git * main) # git과 main 사이에 임의 명령어

{
  "permissions": {
    "allow": [
      "Bash(npm:*)",
      "Bash(git status)",
      "Bash(git diff)",
      "Bash(git add *)",
      "Bash(git commit *)"
    ],
    "ask": ["Bash(npm install *)"]
  }
}

1. Deny 규칙: 도구 사용 완전 차단
2. Ask 규칙: Allow 규칙보다 우선
3. Allow 규칙: 자동 허용

• 제한적으로 시작하여 필요에 따라 권한 확대
• 프로젝트별 도구는 .claude/settings.local.json에 설정
• 공통 도구(npm, git, python 등)는 ~/.claude/settings.json에 설정

12. 원격 세션 지원

• 브라우저 버전과 CLI 도구 간 seamless 이동
• 채팅 기록 및 컨텍스트가 함께 복사됨
• CLI에서 --teleport <session-id> 플래그 사용 가능

1. 웹에서 작업 시작
2. 작업을 백그라운드로 전환
3. CLI에서 세션 텔레포트하여 계속 작업

• 원격 세션 환경 구성
• 리포지토리의 .claude/settings.json에서 Hook 구성 가능
• 기본적으로 모든 Hook은 로컬 및 원격 환경에서 실행
• 특정 환경에서만 실행하려면 CLAUDE_CODE_REMOTE 환경 변수 확인

• 원격 환경은 보안을 위해 HTTP/HTTPS 네트워크 프록시 뒤에서 실행
• 기본적으로 네트워크 액세스는 허용 목록 도메인으로 제한

• 세션 텔레포트는 현재 한 방향만 가능: Claude Code on the web → 로컬 CLI
• 로컬 세션을 원격 머신(예: AWS 인스턴스)으로 계속할 방법 없음

터미널 개선사항

Shift+Enter 지원

키보드 수정

• Alt+B와 Alt+F(단어 이동)가 iTerm2, Ghostty, Kitty, WezTerm에서 정상 작동
• Ghostty, iTerm2, Kitty, WezTerm에서 종료 시 터미널 키보드 모드가 올바르게 리셋
• CJK 문자(한국어, 일본어, 중국어)를 포함하는 멀티라인 프롬프트에서 불필요한 빈 줄 제거

이미지 붙여넣기

보안 수정

성능 개선

시작 성능

터미널 렌더링

Jupyter 노트북

안정성 개선

• 파이프 입력(cat refactor.md | claude) 안정성 향상
• AskQuestion 도구 안정성 개선
• 컴팩션 안정성 개선
• sed in-place 편집 명령이 diff 미리보기와 함께 파일 편집으로 렌더링
• 응답이 출력 토큰 한도로 잘릴 때 자동으로 계속 (오류 메시지 대신)
• 권한 거부 후에도 서브에이전트(Task 도구)가 계속 작동하여 대체 접근 방식 시도가 능

주요 버그 수정

세션 관리

• -c 또는 --resume으로 세션 재개 시 파일과 Skill이 올바르게 발견됨
• 위쪽 화살표나 Ctrl+R 검색으로 기록에서 프롬프트 재생 시 붙여넣은 콘텐츠 손실수 정
• OAuth 토큰 갱신이 서버 보고와 로컬 만료 확인 불일치 시에도 트리거
• 세션 지속성 경합 조건 및 409 충돌 수정

파일 작업

• Write 도구가 하드코딩된 0o600 권한 대신 시스템 umask를 준수
• FIFO 파일 읽기 시 심볼릭 링크 해석을 건너뛰어 행 방지

명령 실행

• $() 명령 치환이 파싱 오류 없이 실행
• 백슬래시 연속이 포함된 멀티라인 bash 명령이 올바르게 처리
• 글로벌 옵션 뒤의 하위 명령이 올바르게 식별(git -C /path log 등)

이미지 처리

• 대용량 붙여넣기 이미지가 "Image was too large" 오류 없이 처리

AWS/클라우드

• AWS Bedrock 서브에이전트가 EU/APAC 교차 리전 추론 모델 구성을 상속하여 403 오 류 해결
• 백그라운드 태스크의 대용량 출력이 30K자로 잘리고 파일 경로 참조 제공

기타

• 이름에 점이 있는 리포지토리에서 백그라운드 작업이 'git repository not found' 오류로 실패하던 문제 수정
• WSL 환경에서 Chrome의 Claude Code 지원
• 플러그인의 allowed-tools frontmatter에서 ${CLAUDE_PLUGIN_ROOT} 치환 수정

SDK 및 확장 변경

SDK

• 최소 zod 피어 의존성이 ^4.0.0으로 변경 (⚠️ 주요 변경사항)

VSCode 확장

• 컨텍스트 메뉴에 현재 선택된 모델명 표시
• 자동 수락 권한 버튼에 설명 라벨 추가(예: "Yes, allow npm for this project")
• 마크다운 콘텐츠에서 단락 구분이 올바르게 렌더링
• 확장에서 스크롤 시 부모 iframe도 스크롤되는 문제 수정

Windows

• 부적절한 렌더링 문제 수정
• 실행 파일 생성 실패 시 네이티브 인스톨러가 조용히 실패하는 문제 수정

UI/UX 개선

• Skill 실행 시 진행 상황 표시(도구 사용이 발생할 때마다 표시)
• /skills/ 디렉토리의 Skill이 슬래시 명령 메뉴에 기본으로 표시 (user-invocable: false로 제외 가능)
• Skill 제안이 최근 및 자주 사용하는 Skill을 우선 표시
• 첫 응답 토큰 대기 시 스피너 피드백 개선
• 스피너의 토큰 카운트에 백그라운드 에이전트 토큰 포함
• 권한 프롬프트 UX 개선(Tab 힌트가 푸터로 이동, 깔끔한 Yes/No 라벨)
• plan 모드 진입 시 권한 프롬프트 제거
• "Interrupted" 메시지 색상이 덜 위협적으로 변경
• Skills가 컨텍스트 시각화에서 별도 카테고리로 표시

새로운 환경 변수 및 설정

주요 변경사항 및 제거

• 최소 zod peer dependency를 ^4.0.0으로 변경 (SDK)
• 계획 모드 진입 시 권한 프롬프트 제거
• 빠른 메모리 입력을 위한 # 단축키 제거 (대신 /edit CLAUDE.md 사용)

영향 및 예상 효과

업데이트 방법

claude update

# 또는 설치 스크립트 재실행
curl -fsSL https://claude.ai/install.sh | sh

참고 자료