CodeGraph의 개요
CodeGraph는 저장소를 파싱해 심볼, 호출, import, 상속의 로컬 SQLite 그래프를 만들고, 이를 MCP로 코딩 에이전트에 제공합니다. 기본적으로 서버는 codegraph_explore라는 도구 하나만 등록하며, 이 도구는 한 번의 호출로 관련 소스를 파일별로 묶어, 심볼 사이의 호출 경로와 영향 범위 요약과 함께 돌려줍니다. 더 좁은 도구 7개(node, search, callers, callees, impact, files, status)는 CODEGRAPH_MCP_TOOLS 환경 변수나 CLI 명령으로 계속 쓸 수 있고, codegraph affected는 diff가 건드리는 테스트 파일을 나열합니다.
파싱은 20개 언어에 대해 Rust 커널에서 실행되며, 목록에 오른 언어는 TypeScript와 Python부터 COBOL, Terraform, Nix까지 모두 34개입니다. 17개 웹 프레임워크의 라우트 탐지도 지원합니다. 파일 감시기가 저장할 때마다 약 2초 후 그래프를 갱신하며, LLM이나 API 키는 쓰지 않습니다. codegraph install은 Claude Code, Cursor, Codex CLI, Gemini CLI, GitHub Copilot을 포함한 9개 에이전트를 연결하고, codegraph init이 프로젝트마다 색인을 만듭니다.
2026년 1월에 만들어진 저장소는 스타가 약 75,400개이며 MIT 라이선스입니다. 최신 릴리스는 2026년 10월 3일의 v1.6.2이고, npm 패키지는 10월 22일까지 일주일 동안 약 77,000회 다운로드되었습니다. 호스팅 풀 리퀘스트 분석 제품은 getcodegraph.com에서 대기 명단을 받고 있으며 가격은 공개되지 않았습니다.
CodeGraph 설치 방법
npx @colbymchenry/codegraph && codegraph initCodeGraph, 쓸 만한 가치가 있습니까?
CodeGraph는 대부분의 코드 그래프를 무력하게 만드는 문제, 즉 그래프가 낡는 문제를 해결합니다. 감시기는 저장 후 약 2초 만에 바뀐 파일을 다시 동기화하고, 도구 응답은 아직 동기화를 기다리는 파일을 표시하며, 다시 연결된 서버는 꺼져 있는 동안 생긴 git pull 같은 수정을 따라잡습니다. GitNexus는 이를 위해 --watch나 엔터프라이즈 등급이 필요하고, 저장소 항목에서 리뷰한 Graphify는 pull 이후 업데이트를 실행할 때까지 낡은 상태로 남습니다.
유지보수자의 벤치마크는 자체 보고치고는 보기 드물게 신중합니다. Claude Opus 4.8이 오픈소스 저장소 7곳에서 각각 아키텍처 질문 하나에 답했고, 비교군마다 4회씩 실행했습니다. 이전 테스트 환경에서는 대조군이 28회 중 26회 codegraph CLI에 접근했기 때문에, 이번에는 양쪽 모두에서 CLI를 막았습니다. 중앙값은 도구 호출 88% 감소, 토큰 62% 감소, 비용 44% 감소입니다. 평균보다 편차가 더 중요합니다. VS Code에서는 에이전트가 28번 대신 2번 호출했고 $1.80 대신 $0.53를 썼지만, 작은 Go 프로젝트인 Gin에서는 비용이 $0.31로 같았습니다. README는 반대 효과도 인정합니다. CodeGraph의 밀도 높은 답 때문에 세션이 끝날 무렵 컨텍스트 창에 남는 검색 텍스트가 약 80% 더 많으며, VS Code에서는 18,000 토큰에 비해 67,000 토큰이었습니다.
좁은 범위는 의도된 것입니다. 유지보수자는 등록된 도구 하나가 메뉴보다 에이전트를 더 잘 이끈다고 주장하며, 그 도구는 읽기 전용이어서 MCP 서버의 어떤 것도 코드를 수정하지 않습니다. 이는 이름 변경 미리 보기, 원시 그래프 쿼리, 문장 단위 데이터 흐름이 없다는 뜻이기도 하며, 이는 모두 GitNexus가 제공합니다. GitNexus가 더 깊이 읽지만, CodeGraph는 MIT 라이선스여서 회사가 오늘 바로 쓸 수 있습니다. GitNexus는 시범 도입에도 상업 계약이 필요합니다.
두 가지 기본값에 주의해야 합니다. 익명 사용 텔레메트리는 설치 프로그램에서 끄거나, codegraph telemetry off나 DO_NOT_TRACK=1을 쓰지 않으면 켜져 있습니다. 문서에 나온 필드에는 코드, 경로, 쿼리가 포함되지 않습니다. 설치 프로그램은 MCP 설정, Claude Code용 자동 허용 권한, 그리고 CLAUDE.md나 AGENTS.md에 마커로 구분된 섹션도 씁니다. 에이전트가 늘 이를 쓰는 것은 아닙니다. 7월의 issue는 Claude Code가 그래도 grep을 쓴다고 보고하며, 해결책은 지금 README에 있는 alwaysLoad 설정입니다.
프로젝트는 빠르게 출시하고 그만큼 밀린 일도 많습니다. 열린 issue가 약 140개, 열린 풀 리퀘스트가 약 400개입니다. codegraph ui 뷰어는 문서에 나오지만, 1.6.0 사용자들은 9월부터 열려 있는 issue에서 "unknown command"가 뜬다고 보고합니다. 공식 MCP 레지스트리를 검색하면 CodeGraph라는 이름의 다른 프로젝트들은 나오지만 이 저장소의 것은 없으므로, 설치 전에 npm 이름 @colbymchenry/codegraph를 확인하십시오.
제 역할을 하는 곳
11,000개 파일 규모 TypeScript 모노레포의 백엔드 개발자
에이전트가 흐름 하나를 설명하기 전에 수십 개의 파일을 grep하지 않게 하기
npx @colbymchenry/codegraph를 한 번 실행하고 저장소에서 codegraph init을 실행한 뒤, Claude Code가 첫 프롬프트부터 codegraph_explore를 보도록 alwaysLoad를 설정합니다. README의 VS Code 벤치마크에서는 질문 하나의 도구 호출이 28번에서 2번으로 줄었습니다. 긴 세션에서는 더 커지는 컨텍스트 사용량을 감안하십시오.
개발자 30명 규모 SaaS 회사의 플랫폼 엔지니어
CI에서 변경의 영향을 받을 수 있는 테스트만 실행하기
git diff --name-only의 출력을 codegraph affected --stdin --quiet에 넘기고, 그 결과를 테스트 러너에 전달합니다. 기본으로 import를 깊이 5까지 따라가므로, 의존성 주입이나 리플렉션으로 닿는 테스트는 빠질 수 있습니다. 야간 전체 실행은 유지하십시오.
팀 전체에 에이전트를 도입하는 엔지니어링 매니저
라이선스 협상 없이 모든 개발자에게 같은 코드 컨텍스트를 주기
GitNexus와 달리 MIT이므로 상업 계약이 필요 없습니다. 개발 컨테이너 이미지에서 codegraph install --yes를 쓰고, 사용 통계가 회사 컴퓨터 밖으로 나가는 것이 우려된다면 그곳에 CODEGRAPH_TELEMETRY=0을 설정합니다. 호스팅 PR 제품은 대기 명단뿐이므로, 서명할 업체 계약도 비교할 가격도 없습니다.
도입 전 확인할 점
- 설정
- 셸이나 PowerShell 설치 프로그램이 자체 런타임을 포함하며, npm i -g @colbymchenry/codegraph로도 설치할 수 있습니다. codegraph install이 Claude Code, Cursor, Codex CLI, opencode, Hermes Agent, Gemini CLI, Antigravity, Kiro, GitHub Copilot을 설정하고, codegraph init이 프로젝트마다 그래프를 만듭니다. README에 따르면 27,000개 파일의 Swift 컴파일러 저장소를 처음 색인하는 데 약 100초가 걸립니다.
- 연동
- 기본으로 stdio를 통한 MCP 도구 하나(codegraph_explore)가 있습니다. node, search, callers, callees, impact, files, status는 CODEGRAPH_MCP_TOOLS로 다시 켭니다. 모두 읽기 전용입니다. 같은 기능을 CLI 명령과 Node API(임베드 시 Node 22.5+)로도 씁니다.
- 데이터와 개인정보
- 코드, 그래프, 검색은 .codegraph/codegraph.db에 로컬로 남습니다. 텔레메트리는 끄지 않으면 명령, 에이전트, 색인된 언어의 일일 집계를 보내며, 서버는 하루에 한 번 GitHub에서 새 버전을 확인합니다. 공개된 보안 권고는 없습니다. npm 패키지와 릴리스 번들에는 2026년 7월부터 출처 증명(provenance attestation)이 붙어 있습니다.
- 대규모 사용 시 비용
- 무료이며, 비용은 컴퓨터 시간입니다. README에 따르면 Linux 커널(70,000개 파일)은 2코어, 6 GB VPS에서 12분 안에 색인되고, Swift 저장소에서 파일 하나를 고친 뒤의 재동기화는 약 4초입니다. 대기 명단의 플랫폼이 가격을 정하기 전까지 호스팅 요금은 없습니다.
- 제한
- 1 MB가 넘는 파일과 gitignore된 경로는 건너뜁니다. 정적 분석은 런타임 디스패치와 리플렉션을 놓칩니다. 파일 간 커버리지는 Liquid에서 73.8%, Spring 라우트에서 83.3%입니다. /mnt 드라이브에 있는 WSL2 프로젝트는 소켓과 잠금 문제가 있으며, 프로젝트당 쓰기 프로세스는 하나만 허용됩니다.
좋은 점
- 저장할 때마다 약 2초 후 그래프가 다시 동기화됩니다
- MIT 라이선스이며, 색인에 LLM, API 키, 네트워크 서비스가 필요 없습니다
- 기본으로 도구 하나만 있는 읽기 전용 MCP 범위입니다
- 컨텍스트가 더 드는 경우까지 포함한 신중한 자체 벤치마크입니다
아쉬운 점
- 익명 텔레메트리가 기본으로 켜져 있습니다
- GitNexus와 달리 이름 변경, 원시 쿼리, 데이터 흐름 분석이 없습니다
- 긴 세션에서는 답이 컨텍스트 창에 더 많은 텍스트를 남깁니다
- 열린 풀 리퀘스트가 약 400개이고, 문서에 나온 ui 명령이 릴리스에 없습니다
추천 대상
고용주가 받아들일 라이선스 아래에서, 늘 최신 상태인 로컬 코드 그래프를 바탕으로 코딩 에이전트가 답하게 하고 싶은 팀입니다.
CodeGraph 대안
일대일 비교
CodeGraph: 자주 묻는 질문
- CodeGraph, 쓸 만한 가치가 있습니까?
- 스스로 최신 상태를 유지하고 회사가 MIT로 도입할 수 있는 코드 그래프입니다. 다만 GitNexus보다 분석이 얕고, 끄지 않으면 사용 데이터를 외부로 보냅니다. 평점은 5점 만점에 4.1점입니다.
- CodeGraph의 가격은 얼마입니까?
- 무료이며 MIT 라이선스입니다. 호스팅 풀 리퀘스트 분석 플랫폼은 getcodegraph.com에서 대기 명단 방식의 베타이며, 가격은 공개되지 않았습니다.
- CodeGraph의 단점은 무엇입니까?
- 익명 텔레메트리가 기본으로 켜져 있습니다; GitNexus와 달리 이름 변경, 원시 쿼리, 데이터 흐름 분석이 없습니다; 긴 세션에서는 답이 컨텍스트 창에 더 많은 텍스트를 남깁니다; 열린 풀 리퀘스트가 약 400개이고, 문서에 나온 ui 명령이 릴리스에 없습니다.
- CodeGraph에 적합한 사람은 누구입니까?
- 고용주가 받아들일 라이선스 아래에서, 늘 최신 상태인 로컬 코드 그래프를 바탕으로 코딩 에이전트가 답하게 하고 싶은 팀입니다.
- 팀이나 프로덕션 환경에서 CodeGraph의 비용은 얼마입니까?
- 무료이며, 비용은 컴퓨터 시간입니다. README에 따르면 Linux 커널(70,000개 파일)은 2코어, 6 GB VPS에서 12분 안에 색인되고, Swift 저장소에서 파일 하나를 고친 뒤의 재동기화는 약 4초입니다. 대기 명단의 플랫폼이 가격을 정하기 전까지 호스팅 요금은 없습니다.
- CodeGraph에 회사 데이터를 맡겨도 안전합니까?
- 코드, 그래프, 검색은 .codegraph/codegraph.db에 로컬로 남습니다. 텔레메트리는 끄지 않으면 명령, 에이전트, 색인된 언어의 일일 집계를 보내며, 서버는 하루에 한 번 GitHub에서 새 버전을 확인합니다. 공개된 보안 권고는 없습니다. npm 패키지와 릴리스 번들에는 2026년 7월부터 출처 증명(provenance attestation)이 붙어 있습니다.
- CodeGraph의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 GitNexus, code-review-graph, Serena, Semble 및 Project RAG입니다.
답변 확인일: 2026년 10월 26일.
CodeGraph 개발사입니까? 이 평점을 사이트에 표시하십시오
