Zvec-Grep (zg)의 개요
zg로 실행하는 Zvec-Grep은 작업 공간을 색인하고 정확 일치, BM25 키워드 순위, 벡터 유사도 또는 이를 합친 하이브리드로 검색에 답하며, 경로, 심볼, 줄 번호가 붙은 순위별 구절을 돌려줍니다. 벡터 데이터베이스 zvec 위에 만들어졌고 명령줄과 로컬 MCP 서버를 모두 제공합니다. 기본적으로 에이전트에 보이는 도구는 표현이나 위치를 모르는 질문을 위한 zvec_grep_search 하나뿐이며, 전체 도구 모음에는 rg, 색인 관리, 상태 도구가 더해집니다.
Apache-2.0 라이선스로 npm에 @zvec/zvec-grep으로 배포되며 macOS, Linux, Windows에서 동작합니다. 2026년 11월 3일 공개된 0.3.0 버전에서 핵심부를 Rust로 다시 작성했습니다. 저장소의 별은 약 4,260개, 열린 이슈와 풀 리퀘스트는 92개이며, npm 패키지는 최근 한 달 동안 약 12,189회 다운로드되었습니다.
Zvec-Grep (zg) 설치 방법
npm install -g @zvec/zvec-grep --allow-scripts=@zvec/zvec-grep && zg --install --target claudeZvec-Grep (zg), 쓸 만한 가치가 있습니까?
핵심 설계 판단은 절제입니다. 경쟁하는 코드 컨텍스트 서버 여럿이 많은 도구를 노출하는 반면, zg의 에이전트용 기본 도구 모음은 zvec_grep_search 하나이며, 문서는 정확한 단어, 파일 이름, 정규식에는 에이전트 자체의 grep을 계속 쓰라고 안내합니다. 검색은 의미를 잡는 벡터 유사도와 식별자를 고정하는 BM25를 결합하므로, 사용자 권한을 어디서 확인하는 가 같은 질문도 함수 이름을 아무도 모를 때 올바른 함수에 닿을 수 있습니다.
개인정보 기본값은 신중하게 정해져 있습니다. 색인은 프로젝트 안의 .zvec-grep에, 모델은 ~/.zvec-grep/models에 저장되고, 기본 임베딩 모델 potion-code-16m-v2는 로컬에서 실행됩니다. 로컬 모델은 16m 파라미터의 Model2Vec부터 GGUF 형식의 Qwen3 Embedding 0.6B까지 11종이 나열되어 있습니다. 원격 Qwen 모델 3종은 API 키와 별도의 동의 부여가 필요합니다. 키만으로는 작업 공간 내용을 보낼 권한이 생기지 않으며, --allow-remote나 작업 공간 범위의 허가가 있어야 합니다. 선택 사항인 HTTP 서버는 127.0.0.1:7999에서 수신하며 루프백에서는 기본적으로 인증이 꺼져 있고, 토큰 파일을 쓰면 bearer 인증이 켜집니다.
0.3.0의 Rust 재작성은 젊은 프로젝트에게 큰 변화입니다. 문서 75,128건을 대상으로 한 관리자 자체 테스트에서 패키지 크기는 167.5 MiB에서 34.3 MiB로, 전체 색인 시간은 219.13 s에서 77.84 s로 줄었고, 최대 메모리는 53.2% 낮아졌으며, MCP 검색 지연은 20.93 ms에서 14.88 ms가 되었습니다. 모두 개발사 수치이며 Claude Code와 Codex를 쓴 에이전트 A/B 벤치마크도 마찬가지이고, README도 결과가 모델과 실행에 따라 달라진다고 밝힙니다. 열린 이슈와 풀 리퀘스트가 92개이고 임베딩 모델을 바꿀 때마다 색인을 다시 만들어야 하므로, 팀 표준으로 삼기 전에 저장소 하나에서 시험해 볼 만합니다.
제 역할을 하는 곳
30만 줄짜리 Django 코드베이스에 새로 합류한 백엔드 개발자
함수 이름을 모른 채 비즈니스 규칙이 어디서 적용되는지 찾기
zg --index를 한 번 실행하고 zg --install --target claude로 Claude Code에 설치한 뒤, grep으로 넘어가기 전에 에이전트가 zvec_grep_search를 호출하게 합니다. 로컬 모델이면 무료이며 색인 시간은 저장소 크기에 따라 늘어납니다.
보고서와 메모 폴더를 가진 정책 분석가
에이전트 없이 터미널에서 문서를 의미로 검색
영어 문서는 local/potion-retrieval-32m으로 색인하고 zg --preview detail로 조회합니다. 결과는 파일과 줄 참조가 붙어 순위별로 나오며 아무것도 노트북 밖으로 나가지 않습니다.
엔지니어 20명에게 에이전트 도구를 배포하는 플랫폼 팀
편집기가 달라도 모두에게 같은 의미 검색 제공
팀 대상(codex, claude, cursor, vscode)에 맞춰 zg --install을 스크립트로 배포하고 도구 하나인 기본 도구 모음을 유지합니다. 공유 Qwen 모델을 쓰려면 원격 임베딩을 전역이 아니라 작업 공간 단위로 허가합니다.
도입 전 확인할 점
- 설정
- npm install -g @zvec/zvec-grep --allow-scripts=@zvec/zvec-grep을 실행하고 프 로젝트에서 zg --index, 이어서 zg --install --target <client>. 그다음 에이전트를 재시작합니다. 색인은 프로젝트 루트의 .zvec-grep에 저장됩니다.
- 연동
- 설치 대상에는 codex, claude, qwen, qoder, opencode, cursor, copilot, vscode, grok, pi가 있습니다. MCP는 기본적으로 stdio, 또는 zg --server on으로 HTTP. --mcp-toolset full은 rg, 색인, 상태 도구를 추가합니다.
- 데이터와 개인정보
- 파일, 색인, 로컬 모델은 기기에 남습니다. 원격 Qwen 임베딩은 --allow-remote나 작업 공간 허가가 있을 때만 허가된 작업 공간 내용과 쿼리를 제공자에게 보내며, 허가는 철회할 수 있습니다.
- 대규모 사용 시 비용
- 로컬 모델이면 무료입니다. 원격 Qwen 임베딩은 DashScope 가격에 따라 제공자가 청구하며, zg 문서에는 가격이 나와 있지 않습니다.
- 제한
- 멀티모달 임베딩 모델을 써도 텍스트만 지원합니다. 모델이나 엔드포인트를 바꾸면 색인을 다시 만들어야 합니다. 127.0.0.1:7999의 HTTP 서버는 루프백에서 기본적으로 인증이 꺼져 있습니다.
좋은 점
- 기본 MCP 도구가 하나라 에이전트 컨텍스트가 작게 유지됨
- 기본으로 로컬 임베딩 모델 사용, 아무것도 기기 밖으로 나가지 않음
- 원격 임베딩은 명시적 동의가 필요
- Claude, Codex, Cursor 등에 명령 하나로 설치
아쉬운 점
- 벤치마크는 관리자 자체 수치
- Rust 전면 재작성 후 열린 이슈와 PR 92개
- 임베딩 모델을 바꾸면 전체 재색인 필요
- 로컬 HTTP 서버는 기본적으로 인증 없음
추천 대상
저장소를 임베딩 API로 보내지 않고 코딩 에이전트가 코드와 문서를 의미로 찾게 하려는 개발자와 연구자.
Zvec-Grep (zg) 대안
Zvec-Grep (zg): 자주 묻는 질문
- Zvec-Grep (zg), 쓸 만한 가치가 있습니까?
- 에이전트를 위해 잘 설계된 로컬 검색 도구로, MCP 노출을 도구 하나로 줄이고 원격 임베딩을 기본값이 아닌 명시적 선택으로 만듭니다. 평점은 5점 만점에 4.0점입니다.
- Zvec-Grep (zg)의 가격은 얼마입니까?
- 무료 오픈 소스(Apache-2.0). 로컬 임베딩 모델은 무료이며, 선택 사항인 Qwen 원격 임베딩은 DashScope API 키가 필요하고 해당 제공자가 요금을 청구합니다.
- Zvec-Grep (zg)의 단점은 무엇입니까?
- 벤치마크는 관리자 자체 수치; Rust 전면 재작성 후 열린 이슈와 PR 92개; 임베딩 모델을 바꾸면 전체 재색인 필요; 로컬 HTTP 서버는 기본적으로 인증 없음.
- Zvec-Grep (zg)에 적합한 사람은 누구입니까?
- 저장소를 임베딩 API로 보내지 않고 코딩 에이전트가 코드와 문서를 의미로 찾게 하려는 개발자와 연구자.
- 팀이나 프로덕션 환경에서 Zvec-Grep (zg)의 비용은 얼마입니까?
- 로컬 모델이면 무료입니다. 원격 Qwen 임베딩은 DashScope 가격에 따라 제공자가 청구하며, zg 문서에는 가격이 나와 있지 않습니다.
- Zvec-Grep (zg)에 회사 데이터를 맡겨도 안전합니까?
- 파일, 색인, 로컬 모델은 기기에 남습니다. 원격 Qwen 임베딩은 --allow-remote나 작업 공간 허가가 있을 때만 허가된 작업 공간 내용과 쿼리를 제공자에게 보내며, 허가는 철회할 수 있습니다.
- Zvec-Grep (zg)의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Serena, CodeGraph, Semble 및 Project RAG입니다.
답변 확인일: 2026년 11월 6일.
Zvec-Grep (zg) 개발사입니까? 이 평점을 사이트에 표시하십시오
