Claude Code의 코드 검색 한계: '명확한' 함수만 찾고 '관련' 함수를 놓치는 문제

주요 논점

01중립분열

검색 알고리즘 개선보다 에이전트에게 정보를 제시하는 프레이밍(framing) 전략이 더 효과적일 수 있다.

실용적 조언

구현 전 피어 함수 후보를 명시적으로 제시하는 프롬프트 전략 사용
단순 검색 지시보다 관련 소스 본문을 미리 읽도록 유도

섹션별 상세

Claude Code는 'import_single_file'처럼 행동 중심의 함수는 5/5로 찾았으나, 'ingest_file'처럼 트리거 중심의 함수는 0/5로 놓쳤다. 이는 에이전트가 검색을 안 하는 것이 아니라, 명명 규칙(naming shape)에 따라 검색 결과의 우선순위가 결정되기 때문이다.

단순히 '기존 코드를 확인하라'는 식의 CLAUDE.md 규칙은 에이전트가 이미 찾은 함수에서 멈추기 때문에 효과가 제한적이다. 에이전트가 구현을 확정하기 전에 잠재적인 피어 후보를 먼저 제시하는 방식의 개입이 필요하다.

그래프 기반의 도구 호출을 시도했으나, 'ingest_file'이 흐름상 경유 노드(transit node)로 인식되어 에이전트가 해당 본문을 열어보지 않는 문제가 발생했다. 검색 성능 향상보다 에이전트에게 정보를 제시하는 프레이밍(framing) 전략이 더 중요할 수 있다.

용어 해설

Claude Code: — Anthropic에서 개발한 자율 코딩 에이전트로, 코드베이스를 분석하고 수정하는 작업을 수행한다. 사용자의 지시를 받아 파일 시스템을 탐색하고 코드를 작성하며, 개발 워크플로를 자동화하는 데 중점을 둔다.
Model Context Protocol(MCP): — AI 모델이 외부 데이터나 도구와 안전하게 상호작용할 수 있도록 돕는 표준 프로토콜이다. 에이전트가 코드베이스나 데이터베이스 같은 외부 컨텍스트를 더 정확하게 참조하도록 지원하여, 모델의 문맥 이해도를 높이는 역할을 한다.
코딩 에이전트(Coding Agent): — 스스로 코드를 작성, 실행, 수정하는 AI 시스템으로, 단순한 코드 완성을 넘어 복잡한 리팩터링이나 기능 구현을 수행한다. 개발자의 의도를 파악하여 코드베이스 전체를 이해하고 최적의 솔루션을 제안하는 역할을 한다.

언급된 도구

Claude Code추천

코딩 에이전트

MCP중립

에이전트 컨텍스트 프로토콜