Claude Code 컨텍스트 관리 완전 가이드: Cursor처럼 파일과 폴더 추가하기

Claude Code 컨텍스트 관리 완전 가이드: Cursor처럼 파일과 폴더 추가하기

개요

Claude Code에서는 Cursor IDE처럼 특정 파일이나 폴더를 컨텍스트에 추가하여 AI와 대화할 수 있습니다. 이를 통해 코드베이스를 이해시키고 정확한 답변을 얻을 수 있습니다.

기본 파일 추가 방법

1. 단일 파일 추가

# 기본 문법
claude-code chat --add-file path/to/file.js "파일에 대한 질문"

# 예시: 특정 파일 분석
claude-code chat --add-file src/components/Header.jsx "이 컴포넌트의 성능을 개선할 방법은?"

# 짧은 문법 (별칭)
claude-code chat -f src/utils/api.js "API 함수들을 리팩토링해줘"

2. 여러 파일 동시 추가

# 여러 파일 추가
claude-code chat --add-files src/components/Header.jsx,src/components/Footer.jsx "헤더와 푸터 컴포넌트의 일관성을 검토해줘"

# 와일드카드 패턴 사용
claude-code chat --add-files "src/components/*.jsx" "모든 컴포넌트의 prop types를 검증해줘"

# 다양한 확장자
claude-code chat --add-files "src/**/*.{js,ts,jsx,tsx}" "TypeScript 마이그레이션 계획을 세워줘"

폴더 및 디렉토리 추가

1. 전체 폴더 추가

# 폴더 전체 추가
claude-code chat --add-dir src/components "컴포넌트 구조를 분석해줘"

# 재귀적 폴더 추가
claude-code chat --add-dir src/components --recursive "모든 하위 폴더까지 포함해서 분석해줘"

# 짧은 문법
claude-code chat -d src/utils "유틸리티 함수들의 중복을 찾아줘"

2. 선택적 폴더 내용 추가

# 특정 파일 타입만
claude-code chat --add-dir src/components --include "*.jsx,*.css" "컴포넌트와 스타일 파일만 검토해줘"

# 제외 패턴 사용
claude-code chat --add-dir src --exclude "*.test.js,*.spec.js" "테스트 파일을 제외하고 코드를 분석해줘"

# 깊이 제한
claude-code chat --add-dir src --max-depth 2 "2단계 깊이까지만 포함해서 구조를 보여줘"

고급 컨텍스트 관리

1. 컨텍스트 세션 관리

# 새 세션 시작
claude-code chat --new-session --session-name "refactoring-project"

# 기존 세션에 파일 추가
claude-code chat --session "refactoring-project" --add-file src/new-component.jsx "이 새 컴포넌트가 기존 구조와 잘 맞는지 확인해줘"

# 세션 컨텍스트 확인
claude-code chat --session "refactoring-project" --show-context

2. 동적 컨텍스트 추가

# Git 변경사항 기반 추가
claude-code chat --add-changed-files "최근 변경된 파일들의 문제점을 찾아줘"

# 특정 커밋 이후 변경사항
claude-code chat --add-changed-since "HEAD~5" "최근 5개 커밋에서 변경된 파일들을 리뷰해줘"

# 특정 브랜치와의 차이점
claude-code chat --add-diff-from "main" "main 브랜치와 다른 파일들을 분석해줘"

3. 스마트 컨텍스트 빌딩

# 의존성 기반 자동 추가
claude-code chat --add-file src/components/UserProfile.jsx --include-dependencies "이 컴포넌트와 관련된 모든 파일을 포함해서 분석해줘"

# 관련 파일 자동 탐지
claude-code chat --add-file src/api/users.js --auto-include-related "관련된 모델, 타입, 테스트 파일도 포함해줘"

# 임포트 체인 따라가기
claude-code chat --add-file src/main.js --follow-imports --max-depth 3 "3단계까지 임포트 체인을 따라가서 포함해줘"

실제 사용 시나리오

1. 버그 디버깅

# 에러가 발생하는 파일과 관련 파일들 추가
claude-code chat \
  --add-file src/components/UserForm.jsx \
  --add-file src/utils/validation.js \
  --add-file src/api/users.js \
  "사용자 폼에서 validation 에러가 발생하는데 원인을 찾아줘"

# 로그 파일과 함께 분석
claude-code chat \
  --add-file src/server.js \
  --add-file logs/error.log \
  "서버 에러의 원인을 찾아줘"

2. 코드 리뷰

# PR 관련 파일들 추가
claude-code chat \
  --add-changed-files \
  --add-file package.json \
  "이번 PR의 변경사항을 리뷰해줘"

# 특정 기능 전체 리뷰
claude-code chat \
  --add-dir src/features/authentication \
  --include-dependencies \
  "인증 기능 전체를 리뷰해줘"

3. 리팩토링 계획

# 리팩토링 대상 모듈들 추가
claude-code chat \
  --add-dir src/legacy \
  --add-dir src/new-architecture \
  "레거시 코드를 새 아키텍처로 마이그레이션하는 계획을 세워줘"

4. 아키텍처 분석

# 전체 프로젝트 구조 분석
claude-code chat \
  --add-dir src \
  --exclude "*.test.*,node_modules" \
  --max-size 50kb \
  "프로젝트 아키텍처를 분석하고 개선점을 제안해줘"

컨텍스트 최적화 전략

1. 점진적 컨텍스트 구축

# 1단계: 핵심 파일만
claude-code chat --add-file src/main.js "앱의 진입점을 분석해줘"

# 2단계: 관련 파일 추가
claude-code chat --add-dependencies "관련된 라우터와 스토어 파일도 보여줘"

# 3단계: 특정 영역 심화
claude-code chat --add-dir src/store "상태 관리 구조를 자세히 분석해줘"

2. 컨텍스트 우선순위 설정

# 중요도 기반 파일 추가
claude-code chat \
  --add-file src/core/engine.js --priority high \
  --add-file src/utils/helpers.js --priority medium \
  --add-file src/config/settings.js --priority low \
  "핵심 엔진 코드를 중심으로 분석해줘"

3. 컨텍스트 크기 관리

# 파일 크기 제한
claude-code chat \
  --add-dir src \
  --max-file-size 10kb \
  --max-total-size 100kb \
  "큰 파일들은 제외하고 분석해줘"

# 라인 수 제한
claude-code chat \
  --add-file src/large-component.jsx \
  --lines 1-50,100-150 \
  "특정 부분만 포함해서 분석해줘"

대화형 컨텍스트 관리

1. 실시간 파일 추가/제거

# 대화 중 파일 추가
claude-code chat --interactive
> "컴포넌트를 분석해줘"
> /add-file src/components/NewComponent.jsx
> "이제 이 컴포넌트도 포함해서 다시 분석해줘"

# 대화 중 파일 제거
> /remove-file src/components/OldComponent.jsx
> "불필요한 파일을 제거했으니 다시 확인해줘"

2. 컨텍스트 미리보기

# 현재 컨텍스트 확인
claude-code chat --show-context

# 컨텍스트 통계
claude-code chat --context-stats
# 출력: Files: 15, Total lines: 1,247, Token estimate: 8,934

3. 컨텍스트 저장/로드

# 현재 컨텍스트 저장
claude-code chat --save-context bug-investigation

# 저장된 컨텍스트 로드
claude-code chat --load-context bug-investigation "저장된 컨텍스트로 계속 분석해줘"

프로젝트별 설정

1. 프로젝트 컨텍스트 프로필

# 프로젝트 프로필 생성
claude-code config create-profile frontend-project
claude-code config set-profile frontend-project include-patterns "src/**/*.{js,jsx,ts,tsx,css}"
claude-code config set-profile frontend-project exclude-patterns "*.test.*,*.spec.*"

# 프로필 사용
claude-code chat --profile frontend-project --add-dir src "프론트엔드 코드를 분석해줘"

2. 자동 컨텍스트 규칙

# .claude-context 파일 생성
cat > .claude-context << EOF
# 항상 포함할 파일들
always-include:
  - package.json
  - README.md
  - src/main.js

# 자동 포함 규칙
auto-include:
  - pattern: "src/**/*.js"
    when: "javascript"
  - pattern: "src/**/*.py" 
    when: "python"

# 제외 규칙
exclude:
  - node_modules/**
  - build/**
  - "*.log"
EOF

# 자동 규칙 적용
claude-code chat --auto-context "프로젝트 전체를 분석해줘"

고급 기능

1. 조건부 컨텍스트 추가

# 파일 존재 시만 추가
claude-code chat \
  --add-file-if-exists src/config/production.js \
  --add-file-if-exists src/config/development.js \
  "환경별 설정을 비교해줘"

# 패턴 매칭 시만 추가
claude-code chat \
  --add-if-pattern "export.*function" src/utils/*.js \
  "export된 함수들만 분석해줘"

2. 동적 컨텍스트 업데이트

# 파일 변경 감지하여 자동 업데이트
claude-code chat --watch-files "파일이 변경되면 자동으로 컨텍스트를 업데이트해줘"

# 주기적 컨텍스트 갱신
claude-code chat --refresh-context 30s "30초마다 컨텍스트를 갱신해줘"

3. 멀티 프로젝트 컨텍스트

# 여러 프로젝트 동시 참조
claude-code chat \
  --add-project /path/to/frontend \
  --add-project /path/to/backend \
  "프론트엔드와 백엔드의 API 호환성을 확인해줘"

팁과 모범 사례

1. 효율적인 컨텍스트 구성

• 핵심 파일 우선: 가장 중요한 파일부터 추가
• 점진적 확장: 필요에 따라 단계적으로 컨텍스트 확장
• 관련성 유지: 질문과 관련된 파일들만 포함

2. 성능 최적화

• 파일 크기 제한: 큰 파일은 필요한 부분만 포함
• 캐싱 활용: 자주 사용하는 컨텍스트는 저장해서 재사용
• 배치 추가: 관련 파일들을 한 번에 추가

3. 구조화된 질문

# 구체적인 범위 지정
claude-code chat \
  --add-file src/components/UserProfile.jsx \
  "이 컴포넌트의 성능 최적화 방법 3가지를 제안해줘"

# 비교 분석 요청
claude-code chat \
  --add-file src/old-implementation.js \
  --add-file src/new-implementation.js \
  "두 구현체의 장단점을 비교해줘"

문제 해결

일반적인 문제들

# 컨텍스트가 너무 클 때
claude-code chat --compress-context --add-dir src "압축해서 포함해줘"

# 파일을 찾을 수 없을 때
claude-code chat --verbose --add-file missing.js "파일 경로를 확인해줘"

# 권한 문제가 있을 때
claude-code chat --ignore-permissions --add-dir protected "권한 무시하고 접근해줘"

이러한 방법들을 통해 Claude Code에서 Cursor처럼 효율적으로 파일과 폴더를 컨텍스트에 추가하여 AI와 대화할 수 있습니다.