Claude Code 2.1.0 업데이트: 새로운 자동화 기능

Claude Code가 2.1.0으로 메이저 업데이트되며 개발 워크플로우 자동화와 편의성을 대폭 향상시켰습니다.

🚀 주요 신기능

1. Skill Hot-Reload (자동 스킬 재로딩)

~/.claude/skills 또는 .claude/skills 디렉토리에 스킬 파일을 생성하거나 수정하면 세션 재시작 없이 즉시 반영됩니다.


# 스킬 생성 예제

mkdir -p ~/.claude/skills

cat > ~/.claude/skills/deploy.md << 'EOF'

---

title: Deploy to Production

description: Deploy application with safety checks

---

Run tests, build, and deploy to production with rollback capability

EOF

# Claude Code 실행 중에도 즉시 사용 가능

claude

# 프롬프트에서 /deploy 명령 바로 사용 가능

2. Forked Sub-Agent Support

스킬과 슬래시 커맨드를 독립된 sub-agent 컨텍스트에서 실행할 수 있습니다.


# 스킬 frontmatter에 context 설정

cat > ~/.claude/skills/analyze.md << 'EOF'

---

title: Code Analysis

context: fork

---

Perform deep code analysis in isolated context

EOF

3. Improved Shift+Enter Support

iTerm2, WezTerm, Ghostty, Kitty에서 터미널 설정 수정 없이 Shift+Enter가 즉시 작동합니다.


# 멀티라인 입력 예제

claude

# Shift+Enter로 줄바꿈, Enter로 전송

4. Per-Project Gitignore Control

프로젝트별로 @-mention 파일 픽커의 gitignore 동작을 제어할 수 있습니다.


// .claude/settings.json

{

"respectGitignore": false

}

5. Privacy Mode

스트리밍이나 녹화 시 계정 정보를 숨길 수 있습니다.


# 계정 정보 숨김 모드로 실행

export CLAUDE_CODE_HIDE_ACCOUNT_INFO=true

claude

🔒 보안 개선

민감 데이터 로그 노출 방지

디버그 로그에서 OAuth 토큰, API 키, 패스워드 등 민감 정보 노출이 차단되었습니다.


# 디버그 로그 확인 시 민감 정보 자동 마스킹

claude --debug

🐛 주요 버그 수정

1. Bash 명령어 카운팅 수정

ls, cat 등의 Bash read 명령이 collapsed 그룹에 올바르게 카운트됩니다.


# 이전: "Read 0 files" 표시

# 현재: 실제 파일 수 정확히 표시

claude "read all config files"

2. 세션 재개 시 파일/스킬 발견 개선

-c 또는 --resume 옵션으로 세션을 재개할 때 파일과 스킬이 올바르게 로드됩니다.


# 세션 재개

claude --resume

claude -c

3. 플러그인 Tool 승인 변수 대체 수정

플러그인의 allowed-tools frontmatter에서 ${CLAUDE_PLUGIN_ROOT} 변수가 올바르게 치환됩니다.

4. Write Tool 파일 권한 수정

Write tool이 시스템 umask를 존중하여 파일을 생성합니다 (이전: 하드코딩된 0o600).


# 시스템 umask 설정 확인

umask

# 0022

# Write tool 사용 시 올바른 권한 적용

claude "create a new config file"

5. 멀티라인 Bash 명령어 처리 개선

백슬래시 연속 문자가 포함된 멀티라인 명령어가 올바르게 처리됩니다.


claude "run this command:

docker run \\

-e API_KEY=secret \\

-p 8080:8080 \\

myapp"

6. Git 서브커맨드 인식 개선

글로벌 옵션 후의 서브커맨드가 올바르게 매칭됩니다.


# 이전: git -C /path log가 올바르게 인식 안됨

# 현재: Bash(git log:*) 규칙에 정확히 매칭

claude "show git log in /path directory"

7. CLI 슬래시 커맨드 실행 수정

CLI 인자로 전달된 슬래시 커맨드가 올바르게 실행됩니다.


# 슬래시 커맨드 직접 실행

claude /context

claude /model

claude /permissions

8. Tab 자동완성 버그 수정

Tab으로 슬래시 커맨드를 자동완성한 후 Enter를 누르면 완성된 명령이 올바르게 선택됩니다.

🛠️ CLI 사용 예제

설치 및 업데이트


# NPM으로 설치

npm install -g @anthropic-ai/claude-code

# 버전 확인

claude --version

# 자동 업데이트

claude update

기본 사용법


# 기본 실행

cd /path/to/project

claude

# 특정 프롬프트로 시작

claude "analyze this codebase"

# 세션 재개

claude --resume

claude -c

# 비대화식 모드 (파이프)

echo "refactor main.py" | claude

cat requirements.txt | claude "analyze dependencies"

스킬 관리


# 전역 스킬 생성

mkdir -p ~/.claude/skills

echo "---

title: Test Runner

---

Run all tests with coverage" > ~/.claude/skills/test.md

# 프로젝트별 스킬

mkdir -p .claude/skills

echo "---

title: Deploy

context: fork

---

Deploy with safety checks" > .claude/skills/deploy.md

# 스킬 사용 (세션 내)

/test

/deploy

설정 관리


# 프로젝트 설정 파일 생성

mkdir -p .claude

cat > .claude/settings.json << 'EOF'

{

"respectGitignore": false,

"defaultModel": "claude-sonnet-4-5"

}

EOF

# 환경 변수로 설정

export CLAUDE_CODE_HIDE_ACCOUNT_INFO=true

export CLAUDE_CODE_SHELL=/bin/zsh

claude

세션 및 컨텍스트


# 컨텍스트 확인

claude /context

# 권한 관리

claude /permissions

# 모델 전환

claude /model

# 세션 이름 지정 및 재개

claude --session-id my-feature

claude --resume my-feature

디버깅 및 진단


# 디버그 모드

claude --debug

# 진단 실행

claude /doctor

# 로그 확인

claude /logs

# 버그 리포트

claude /bug

MCP 서버 관리


# MCP 서버 추가

claude mcp add

# Claude Desktop에서 MCP 서버 가져오기

claude mcp add-from-claude-desktop

# JSON으로 MCP 서버 추가

claude mcp add-json myserver '{"command":"node","args":["server.js"]}'

# 복수 설정 파일 사용

claude --mcp-config server1.json server2.json

고급 워크플로우


# 파이프라인 예제: 리팩토링 요구사항 파일 전달

cat refactor-spec.md | claude

# 백그라운드 작업 (세션 내에서 Ctrl+B)

# dev server 실행 중 다른 작업 가능

# Forked sub-agent로 독립 작업

# .claude/skills/isolate.md에 context: fork 설정

claude

/isolate

터미널 통합


# 지원 터미널: iTerm2, WezTerm, Ghostty, Kitty, Alacritty, Zed, Warp

# 터미널 설정

claude /terminal-setup

# 커스텀 상태 라인

claude /statusline

VS Code 확장


# VS Code 마켓플레이스에서 설치

# 또는 명령어로 설치

code --install-extension anthropic.claude-code

# 세컨더리 사이드바 설정 (VS Code 1.97+)

# Settings > Claude Code > Preferred Location: sidebar

⚠️ Known Issues

버전 2.1.0 초기 문제 (2.1.1에서 수정됨)

일부 macOS 사용자에게서 “Invalid Version: 2.1.0” 오류가 보고되었으나 2.1.1 핫픽스에서 해결되었습니다.


# 최신 버전으로 업데이트

npm update -g @anthropic-ai/claude-code

claude --version  # 2.1.1 확인

📚 추가 리소스

🎯 마이그레이션 가이드

2.0.x → 2.1.0

2.1.0은 하위 호환성을 유지하며, 기존 설정과 워크플로우가 그대로 작동합니다.


# 안전한 업그레이드

npm update -g @anthropic-ai/claude-code

# 설정 백업 (선택사항)

cp -r ~/.claude ~/.claude.backup

# 업데이트 확인

claude --version

claude /doctor

신규 기능 활용


# 1. 기존 스킬을 자동 리로드 가능하도록 이동

mv old-scripts/*.sh ~/.claude/skills/

# 2. 프로젝트별 gitignore 설정

echo '{"respectGitignore":true}' > .claude/settings.json

# 3. 프라이버시 모드로 데모/스트리밍

export CLAUDE_CODE_HIDE_ACCOUNT_INFO=true

Claude Code 2.1.0 업데이트 주요 기능과 사용법 정리