# Upgrade Claude Code > Claude Code 설정 업그레이드 Use when this capability is needed. - Skill: `tomevault-io/upgrade-claude-code` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/upgrade-claude-code` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/upgrade-claude-code/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/upgrade-claude-code --- # Claude Code 설정 업그레이드 현재 설정을 분석하고 **최신 트렌드를 반영**하여 업그레이드를 제안합니다. **어떤 프로젝트, 어떤 언어에서든** 동일하게 작동합니다. ## 사용법 ``` /upgrade-claude-code ``` ## 왜 이 커맨드가 필요한가? ``` 문제: AI 도구는 빠르게 변화하므로 설정이 금방 구식이 됨 해결: WebSearch로 최신 트렌드 조사 + 현재 설정 분석 + 개선 제안 결과: 항상 최신 베스트 프랙티스 유지 (정기적으로 실행 권장) ``` ## 수행 작업 ### 1단계: 마스터 가이드 참조 **반드시** 다음 문서를 먼저 읽습니다: ``` .claude/docs/CLAUDE-CODE-MASTERY.md # 목차 및 핵심 개념 .claude/docs/mastery/04-curriculum.md # 레벨 시스템 정의 (단일 소스) .claude/docs/mastery/05-advanced.md # 최신 트렌드 분석 방법 .claude/docs/mastery/01-settings-guide.md # 설정 요소별 상세 (MCP 추천 포함) ``` ### 2단계: 현재 설정 분석 ```bash # 분석 대상 1. CLAUDE.md - 규칙 수, 상세도 2. .claude/settings.local.json - 훅, 권한 설정 3. .claude/commands/ - 커맨드 수, 품질 4. .claude/agents/ - 에이전트 수, 전문성 5. .claude/skills/ - 스킬 수, 도메인 커버리지 6. .mcp.json - 연결된 외부 도구 7. .github/workflows/ - CI/CD 자동화 ``` ### 3단계: 레벨 및 체크리스트 평가 **중요**: 레벨 정의, 항목별 체크리스트, 대시보드 형식은 모두 `.claude/docs/mastery/04-curriculum.md`의 "4.0 Claude Code 설정 현황 시스템"을 참조합니다. 해당 문서에서 다음 내용을 확인: - 레벨 정의 (0-5) - 항목별 체크리스트 (8개 항목) - 대시보드 출력 형식 - 빠른 레벨업 가이드 ### 4단계: 시간대별 트렌드 조사 (WebSearch) AI 도구는 빠르게 변화하므로, 시간대별로 검색을 세분화합니다. #### 4.1 년도 트렌드 (연간 베스트 프랙티스) 검색어: ``` - "Claude Code best practices {current_year}" - "Claude Code setup guide {current_year}" - "Boris Cherny Claude Code tips" ``` #### 4.2 월간 트렌드 (최근 업데이트) 검색어: ``` - "Claude Code updates {current_month} {current_year}" - "Claude Code new features {current_month}" - "Anthropic Claude Code changelog {current_month}" ``` #### 4.3 주간 트렌드 (핫 토픽) 검색어: ``` - "Claude Code this week" - "Claude Code latest news" - "MCP servers new releases" ``` #### 4.4 카테고리별 검색 (선택적) | 카테고리 | 검색어 | 중요도 | |----------|--------|:------:| | Features | "Claude Code new feature" | 높음 | | Breaking | "Claude Code breaking change deprecated" | 높음 | | Integration | "Claude MCP server new {current_year}" | 중간 | #### 4.5 플랫폼별 검색 (선택적) | 플랫폼 | 검색어 | 특징 | |--------|--------|------| | Reddit | site:reddit.com Claude Code {current_month} | 실사용 리뷰, 팁 | | HN | site:news.ycombinator.com Claude Code | 기술적 토론, 비판적 시각 | | Discord | Anthropic Discord 채널 직접 확인 | 실시간 기술 지원 | | GitHub | "Claude Code" in:readme stars:>50 pushed:>{last_week} | 인기 프로젝트 | ### 5단계: 개선점 식별 ```markdown ## 개선점 우선순위 ### 높음 (레벨업 가능) - [x] CLAUDE.md 규칙 상세화 → 레벨 1 달성 - [x] Skills 폴더 추가 → 레벨 4 달성 - [x] 누락된 Agents 추가 → 레벨 3 달성 ### 중간 (체크리스트 완성) - [ ] 새로운 MCP 서버 연결 - [ ] 커맨드 추가 - [ ] 훅 고도화 ### 낮음 (세부 요소 보완) - [ ] 기존 설정 최적화 - [ ] 문서 개선 ``` ### 6단계: 사용자에게 제안 ```markdown ## 업그레이드 제안 ### 현재 레벨: {N} ({레벨명}) - {X}/8 항목 ### 권장 업그레이드 1. **[높음]** Skills 폴더 추가 - 효과: 레벨 4 달성 - 설명: 도메인별 전문 컨텍스트 제공 2. **[중간]** 새 MCP 서버 연결 - 효과: MCP 체크리스트 완성 - 설명: 프로젝트 의존성 기반 연동 3. **[낮음]** 커맨드 추가 - 효과: Commands 세부 요소 완성 - 설명: 추가 자동화 ### 트렌드 분석 결과 🔥 **년도 트렌드 ({current_year})**: | 트렌드 | 설명 | 적용 권장 | |--------|------|:--------:| | {트렌드 1} | {설명} | 높음/중간/낮음 | | {트렌드 2} | {설명} | 높음/중간/낮음 | ⚡ **월간 트렌드 ({current_month})**: | 업데이트 | 날짜 | 영향도 | |----------|------|:------:| | {업데이트 1} | {날짜} | 높음/중간/낮음 | 📢 **주간 핫토픽**: - 🔥 [높음] {핫토픽 1} - ⚡ [중간] {핫토픽 2} - 📢 [정보] {핫토픽 3} ``` ### 7단계: 사용자 승인 대기 ``` 업그레이드를 적용하시겠습니까? 1. 전체 적용 2. 선택적 적용 (번호 선택) 3. 취소 ``` ### 8단계: 업그레이드 적용 사용자 승인 시: 1. 백업 생성 (기존 파일) 2. 새 설정 적용 3. 변경 사항 요약 ### 9단계: 지속적 업데이트 알림 (선택) 프로젝트에 트렌드 체크 리마인더를 제안합니다: ```markdown ## CLAUDE.md에 추가할 내용 (선택) ## 트렌드 체크 일정 - 마지막 체크: {today} - 다음 체크 권장: {next_check_date} - 실행: /upgrade-claude-code ``` **권장 체크 주기**: | 프로젝트 유형 | 권장 주기 | 이유 | |--------------|:--------:|------| | 활발한 개발 | 주 1회 | AI 도구 변화가 빠름 | | 유지보수 | 월 1회 | 주요 업데이트만 확인 | | 안정화 단계 | 분기 1회 | Breaking Changes만 확인 | ## 결과 출력 ``` 🚀 Claude Code 업그레이드 완료! 📊 레벨 변화: {N} ({레벨명}) → {N+1} ({새레벨명}) 📈 진행 현황: {X}/8 → {Y}/8 항목 📝 적용된 변경: - Skills 폴더 생성 (4개) ✅ - 새 MCP 서버 연결 (MongoDB) ✅ - CLAUDE.md 규칙 추가 ✅ 🔥 반영된 최신 트렌드: - {트렌드 1} - {트렌드 2} 🎯 다음 단계: - 새로운 설정 테스트 - 팀원과 공유 - /learn-claude-code 로 새 기능 학습 ``` ## 롤백 방법 ```bash # 백업에서 복원 git checkout HEAD~1 -- .claude/ git checkout HEAD~1 -- CLAUDE.md git checkout HEAD~1 -- .mcp.json ``` ## 에러 처리 ### 마스터 가이드를 찾을 수 없는 경우 ``` ⚠️ 마스터 가이드 문서를 찾을 수 없습니다. 해결 방법: 1. bkit-starter 저장소에서 .claude/docs/ 폴더를 복사하세요 2. /learn-claude-code 로 현재 상태 확인 ``` ### WebSearch 실패 시 ``` ⚠️ 트렌드 검색에 실패했습니다. 가능한 원인: - 네트워크 연결 문제 - WebSearch 도구 사용 불가 대안: → 공식 채널에서 직접 확인 (아래 참고 문서 참조) → 트렌드 분석 없이 현재 설정만 평가: /learn-claude-code ``` ### 업그레이드 적용 실패 시 ``` ⚠️ 업그레이드 적용에 실패했습니다. 복구 방법: → git checkout HEAD~1 -- .claude/ (위 롤백 방법 참조) 수동 적용하려면: → 01-settings-guide.md 참조하여 직접 수정 ``` ## 참고 문서 ### 내부 문서 - .claude/docs/CLAUDE-CODE-MASTERY.md - .claude/docs/mastery/04-curriculum.md **(레벨 시스템 정의 - 단일 소스)** - .claude/docs/mastery/05-advanced.md (트렌드 분석) - .claude/docs/mastery/01-settings-guide.md (MCP 추천 전략 포함) ### 공식 채널 - [Anthropic Engineering Blog](https://www.anthropic.com/engineering) - [Claude Code Changelog](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md) - [MCP Registry](https://registry.modelcontextprotocol.io/) ### 커뮤니티 채널 - [Anthropic Discord](https://discord.gg/anthropic) - API 지원, MCP 논의 - [r/ClaudeAI](https://reddit.com/r/ClaudeAI) - Claude 관련 토론 - [Hacker News](https://news.ycombinator.com) - 기술적 토론 --- > Source: [popup-studio-ai/bkit-starter](https://github.com/popup-studio-ai/bkit-starter) — distributed by [TomeVault](https://tomevault.io).