Claude Code에 전체 프로젝트 컨텍스트를 제공하는 방법

Source: Dev.to

컨텍스트 격차

Claude Code에게 “이 티켓을 어떻게 구현해야 하나요?”라고 물을 때, 다음을 알아야 합니다:

• 어떤 파일이 관련 있는지 (열어본 파일만이 아니라)
• 그 파일들이 어떻게 연결되는지 (의존성 그래프, 호출 경로)
• 이전에 시도된 내용 (과거 PR, 되돌린 변경 사항)
• 이 영역을 아는 사람 (추가 질문을 위한 전문 지식)
• 무엇이 깨질 수 있는지 (영향 범위, 하위 소비자)

이 정보가 없으면 Claude Code는 합리적이지만 일반적인 답변을 제공합니다. 정보가 있으면 Claude Code는 구체적이고 추적 가능한 실행 가능한 계획을 제시합니다.

컨텍스트 제공 방법

방법 1: 수동 컨텍스트 수집

Claude Code에 질문하기 전에 30~60분을 투자하세요:

• 관련 파일을 식별하고 핵심 섹션을 붙여넣기.
• 관련 PR을 찾기 위해 git 로그를 검색하고 설명을 붙여넣기.
• 의존성 체인을 수동으로 매핑하기.

이 방법은 작동하지만 목적에 어긋납니다—‘이해 비용’을 수동으로 지불해 Claude Code에 컨텍스트를 제공하게 됩니다.

방법 2: MCP 도구

MCP를 통해 Claude Code를 코드 인텔리전스 도구에 연결합니다. 수동 수집 대신 Claude Code가 다음과 같은 명령을 실행할 수 있습니다:

> get_feature_files("authentication") → 14 files listed
> get_symbol_call_graph("validateSession", depth=3) → full call chain
> get_file_history("authMiddleware.ts") → last 5 PRs with descriptions
> get_blast_radius("validateSession") → 7 downstream consumers

수동으로 30~60분 걸리던 컨텍스트 수집이 도구 호출을 통해 약 10초면 완료됩니다.

방법 3: 사전 생성된 빌드 플랜

가장 효율적인 방법: Claude Code와 상호작용하기 전에 티켓에서 빌드 플랜을 생성합니다. 파일 매핑, 의존성 분석, 과거 컨텍스트를 포함한 플랜을 초기 컨텍스트로 제공하세요. 그러면 Claude Code는 코드베이스 전체를 인식한 상태에서 구현 전략을 고민합니다.

차이점

컨텍스트 없이

“사용자 세션 새로 고침을 구현하려면 토큰 만료를 확인하고 필요에 따라 새로 고치는 미들웨어를 만들어야 합니다.”

컨텍스트와 함께

“코드베이스 분석 결과: 세션 처리는 src/services/auth/sessionManager.ts에 있습니다. 현재 구현은 Redis 기반 세션을 사용합니다(redisClient.ts 참조). 최근 세션 TTL 변경(PR #412)으로 인해 websocketService.ts가 이전 TTL과 일치하는 하드코딩된 타이머를 가지고 있어 WebSocket 재연결 문제가 발생했습니다. 권장 방법: sessionManager.refreshToken()을 업데이트하고, 두 서비스가 읽는 TTL 구성 상수를 추가하며, WebSocket 타이머 정렬을 위한 테스트 케이스를 추가하세요.”

동일한 AI. 동일한 모델이지만 컨텍스트 때문에 유용성이 크게 달라집니다.

원본은 glue.tools에 게시되었습니다. Glue는 사전 코드 인텔리전스 플랫폼으로, 티켓을 붙여넣으면 전투 계획을 얻을 수 있습니다.