← AI Projects

CLI Tool

Context Doctor

Claude Code 설정 최적화 도구

Claude Code 설정을 분석하고 컨텍스트 토큰 사용량을 최적화합니다.
대용량 CLAUDE.md 임포트를 온디맨드 Skills와 이벤트 기반 Hooks로 분리하여
불필요한 토큰 소모를 줄입니다.

주요 기능

🔍

Context Analysis

CLAUDE.md, MCP 서버, 플러그인, Hooks를 스캔하고 파일별 토큰 사용량을 계산합니다.

💡

최적화 제안

대용량 임포트를 온디맨드 Skills 또는 이벤트 기반 Hooks로 분리하도록 제안합니다.

⚙️

Project Setup

기술 스택을 자동 감지하여 맞춤 CLAUDE.md, Skills, Hooks를 생성합니다.

🛡️

Safe by Design

모든 변경은 사용자 승인 필요. 자동 백업과 원커맨드 롤백을 지원합니다.

📦

Zero Dependencies

외부 패키지 없이 Node.js 18+만으로 동작. 공급망 리스크가 없습니다.

🎯

스택 자동 감지

JS/TS, Python, Go, Java, React, Next.js, Vue, Django, Spring Boot 등 다양한 스택을 지원합니다.

Quick Start

설치

npm install -g claude-context-doctor

또는 npx claude-context-doctor로 설치 없이 실행

설정 분석 & 최적화

ccd

현재 설정을 스캔하고 최적화를 제안합니다

프로젝트 맞춤 설정 생성

ccd setup

기술 스택 자동 감지 → CLAUDE.md, Skills, Hooks 생성

어떻게 동작하나요?

Scan
~/.claude/ 및 .claude/ 디렉토리를 읽습니다

→

Analyze
파일별 토큰 수를 추정합니다

→

Recommend
Skills/Hooks로 이동 가능한 파일을 식별합니다

→

Apply
승인 후 설정을 재구성합니다

분석 결과 예시

━━━ 분석 결과 ━━━

  글로벌 설정 (~/.claude/)
    CLAUDE.md: 309 tokens
    Import 파일: 20개
    전체 로드 크기: 22,269 tokens

    HIGH RULES.md: 3,475 tokens ███░░░░░░░
    HIGH MODE_Business_Panel.md: 2,937 tokens ███░░░░░░░

━━━ 최적화 제안 ━━━

  총 10개 제안 | 예상 절감: 16,633 tokens

명령어

명령어	설명
`ccd`	설정 분석 및 최적화 제안
`ccd setup`	프로젝트 맞춤 설정 자동 생성
`ccd rollback`	백업 목록 확인
`ccd rollback <id>`	특정 백업으로 복원
`ccd --project-dir <path>`	프로젝트 디렉토리 지정
`ccd help`	도움말 보기

Setup 기능

ccd setup 명령으로 프로젝트에 맞는 설정을 자동 생성합니다.

📋

CLAUDE.md 자동 생성

프로젝트 구조, 기술 스택, 컨벤션을 분석하여 맞춤형 CLAUDE.md를 생성합니다.

🎯

Skills 자동 생성

반복적인 워크플로우를 온디맨드 Skills로 변환하여 필요할 때만 로드합니다.

🔗

Hooks 자동 생성

품질 검사를 이벤트 기반 Hooks로 자동화하여 일관된 코드 품질을 유지합니다.

Requirements

Node.js >= 18
Claude Code CLI 설치 (claude 명령어 사용 가능)
Active Claude Code subscription (setup 기능)

Safety

모든 변경은 사용자 승인 필요
변경 전 자동 백업
원커맨드 롤백: ccd rollback
기본 읽기 전용 분석
외부 API 호출 없음
Zero dependencies = 공급망 리스크 없음