Claude Code 2.1.0 업데이트 주요 기능과 사용법 정리
요약
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#자동화#보안#개발툴#업데이트