대규모 코드 검색이 단일 리포지토리를 넘어 성장할 때 필수적인 이유

섹션별 상세

AI 코딩 어시스턴트의 한계는 워크스페이스 중심의 컨텍스트에 국한된다는 점이다. Cursor, Claude Code 등은 로컬 디렉토리 내에서는 우수하지만, 수백 개의 리포지토리에 걸친 API 호출처나 의존성 파악을 위해서는 모든 코드를 로컬로 클론해야 하는 물리적 한계가 존재한다.

Sourcegraph는 Trigram 기반 검색 엔진인 Zoekt를 사용하여 GitHub, GitLab, Bitbucket 등 다양한 코드 호스트의 데이터를 통합 인덱싱한다. 이를 통해 수십억 줄의 코드에 대해 1초 미만의 쿼리 성능을 보장하며, 클론 없이도 조직 전체의 코드를 즉각적으로 탐색할 수 있게 한다.

정밀한 쿼리 언어를 통해 LLM 기반 시맨틱 검색이 제공하지 못하는 결정론적 결과를 보장한다. `repo:`, `file:`, `type:symbol`, `type:diff` 등 강력한 필터를 지원하여 보안 취약점이나 특정 패턴을 누락 없이 전수 조사할 수 있는 신뢰성을 제공한다.

text

repo:myorg/.* endpoint("/api/v2/payments") type:symbol

조직 내 모든 리포지토리에서 특정 결제 엔드포인트 심볼을 찾는 Sourcegraph 쿼리 예시

text

(repo:service-a OR repo:service-b) AND deprecated lang:python

특정 서비스들 내에서 파이썬 언어로 작성된 'deprecated' 키워드를 찾는 불리언 로직 쿼리

Deep Search 시스템은 자연어 탐색과 정밀 쿼리를 결합한다. 사용자가 '인증 흐름이 어떻게 되는가'와 같은 자연어 질문을 던지면, 시스템이 내부적으로 검색 도구를 사용하여 정보를 수집하고 최종적으로는 정확한 코드 위치를 특정할 수 있는 쿼리로 전환해준다.

MCP(Model Context Protocol) 통합을 통해 AI 에이전트의 능력을 확장한다. Claude나 Codex 같은 에이전트가 Sourcegraph의 검색 인덱스를 프로그래밍 방식으로 쿼리할 수 있게 함으로써, 에이전트가 생성하는 코드가 기존 시스템과 성공적으로 통합될 확률을 높인다.

Batch Changes 기능을 통해 검색된 문제점을 조직 전체에서 일괄 수정한다. 선언적인 배치 스펙을 작성하여 수백 개의 리포지토리에 대한 PR을 동시에 생성하고 관리할 수 있으며, 실제 사례에서 대규모 코드 변경 시간을 약 80% 단축하는 성과를 보였다.

용어 해설

조크트(Zoekt): — Trigram 기반의 고성능 코드 검색 엔진으로, 대규모 소스 코드 인덱싱과 빠른 정규식 검색에 최적화되어 있다. 수십억 줄의 코드를 1초 미만의 지연 시간으로 검색할 수 있게 하는 Sourcegraph의 핵심 인프라이다.
모델 컨텍스트 프로토콜(MCP): — Model Context Protocol의 약자로, AI 모델이 외부 도구나 데이터 소스에 표준화된 방식으로 접근할 수 있게 해주는 프로토콜이다. 이를 통해 AI 에이전트가 로컬 환경을 넘어 기업 전체의 코드 인덱스에 접근할 수 있다.
의미론적 검색(Semantic Search): — 단어의 단순한 문자 일치가 아닌, 문맥과 의미적 유사성을 바탕으로 정보를 찾는 검색 방식이다. LLM의 임베딩 기술을 활용하여 '인증 흐름'과 같은 추상적인 질문에 대한 답을 코드에서 찾아낼 수 있다.
결정론적 검색(Deterministic Search): — 입력된 쿼리에 대해 항상 명확하고 재현 가능한 결과를 반환하는 검색 방식이다. 정규 표현식이나 심볼 매칭을 사용하여 보안 취약점이나 특정 API 호출처를 누락 없이 전수 조사할 때 필수적이다.
일괄 변경(Batch Changes): — 수백 개의 리포지토리에 걸쳐 대규모 코드 수정을 자동화하고 추적하는 기능이다. 선언적인 스펙을 통해 풀 리퀘스트(PR)를 일괄 생성하고 CI 상태와 리뷰 과정을 통합 대시보드에서 관리할 수 있게 한다.

기술

Sourcegraph
Zoekt
MCP
Claude Code
Cursor
GitHub Code Search

활용 사례

보안 취약점 전수 조사
대규모 API 마이그레이션
신규 엔지니어 온보딩
영향도 분석

언급된 리소스

문서Sourcegraph Platform

문서Model Context Protocol (MCP)