CodeGraph 완벽 가이드 - 한 번 설정으로 AI 코딩 도구 전부 최적화

 

 

 

혹시 이런 경험 있으신가요?

 

Claude Code, Cursor, Codex CLI... 여러 AI 코딩 도구를 쓰다 보면

"왜 이렇게 파일을 많이 뒤지지? 토큰 소비가 너무 심한데..."

 

맞아요. 저도 똑같이 느꼈거든요.

그런데 이 문제를 한 방에 해결해 주는 도구가 나타났습니다!

 

바로 CodeGraph입니다!

 

출시 첫날 24시간 만에 GitHub 스타 2,434개를 받으며

GitHub 트렌딩 2위에 오른 바로 그 도구예요!

 

 

CodeGraph가 뭔가요?

 

 

한 마디로 설명하면...

 

"AI 코딩 에이전트에게 코드 전체 지도를 미리 건네주는 도구"

 

지도가 없을 때는요?

AI가 매번 골목골목을 직접 걸어 다니며 파일을 뒤집니다.

`grep`으로 검색하고, 파일 읽고, 또 검색하고, 또 읽고...

이게 토큰을 엄청나게 잡아먹는 주범이에요.

 

지도가 있으면요?

이미 모든 길이 정리되어 있으니 한눈에 딱 보고 바로 목적지로!

 

실제로 측정해보니 이런 결과가 나왔습니다.

항목	개선 효과
비용	35% 절감
토큰 사용량	59% 감소
응답 속도	49% 향상
도구 호출 횟수	70% 감소

 

숫자가 좀 믿기지 않으시죠?

이건 7개의 실제 오픈소스 프로젝트를 대상으로 측정한 결과라고 합니다!

 

 

5개 AI 도구를 모두 지원해요!

 

처음 공개됐을 때는 Claude Code 전용으로 알려졌는데요.

지금은 완전히 달라졌습니다!

 

현재 공식 지원하는 AI 코딩 도구는 무려 5개예요.

 

- Claude Code : Anthropic의 CLI 코딩 에이전트

- Cursor : 요즘 가장 인기 있는 AI 코드 에디터

- Codex CLI : OpenAI의 CLI 코딩 에이전트

- OpenCode : 오픈소스 AI 코딩 에이전트

- Hermes Agent : NousResearch의 코딩 에이전트

 

설치 프로그램이 여러분의 컴퓨터에 설치된 도구를 자동으로 감지해서 설정해 줍니다.

별도로 뭔가 알아서 할 필요가 없어요. 정말 편하죠!

 

 

어떻게 여러 도구를 동시에 지원할 수 있나요?

 

이게 CodeGraph의 핵심 아이디어인데요...

 

CodeGraph는 MCP(Model Context Protocol) 라는 공개 프로토콜 기반의 서버로 동작합니다.

MCP를 지원하는 도구라면 어느 것이든 연결할 수 있거든요.

 

그리고 프로젝트에 만들어지는 코드 지식 그래프(`.codegraph/codegraph.db`)는

어떤 도구를 쓰든 똑같이 공유해서 사용할 수 있습니다!

 

예를 들면 이런 거예요.

오전에는 Claude Code로 작업하고,
오후에는 Cursor로 바꿔서 작업해도...
코드 지도를 다시 만들 필요가 없어요!

 

한 번 만든 지도는 어느 도구에서든 그대로 쓸 수 있습니다.

 

 

설치 방법 - 딱 한 줄이면 됩니다!

 

 

1) 1단계 : 설치 프로그램 실행

 

[macOS, Linux]

npx @colbymchenry/codegraph

 

 

[Windows]

방법1 : PowerShell
irm https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.ps1 | iex

 

 

방법2 : npm으로 설치(Node.js가 이미 있다면)
npm install -g @colbymchenry/codegraph
codegraph install --yes

 

 

이 명령어 하나만 실행하면 설치 프로그램이 알아서...

 

- 현재 컴퓨터에 설치된 AI 코딩 도구들을 자동으로 감지

- 어떤 도구에 설정할지 물어봄

- MCP 서버 설정을 자동으로 완료

- 사용 지침도 자동으로 추가

 

별도로 설정 파일을 건드릴 필요가 없습니다!

 

2) 특정 도구만 설정하고 싶다면?

# Cursor와 Claude Code만 설정
codegraph install --target=cursor,claude --yes

# 자동 감지 후 전부 설치
codegraph install --yes

 

 

3) 2단계 : AI 코딩 도구 재시작

 

설치 후 Claude Code, Cursor 등 사용 중인 도구를 재시작합니다.

 

4) 3단계 : 프로젝트 초기화

cd 내-프로젝트-폴더
codegraph init -i

 

이렇게 하면 `.codegraph/` 폴더가 생기고

AI 도구들이 자동으로 CodeGraph를 사용하기 시작합니다!

 

 

코드 지도는 어떻게 만들어지나요?

 

원리가 궁금하시죠? 생각보다 단순합니다.

 

1) 코드 파싱

`tree-sitter`라는 도구가 소스코드를 분석합니다.

함수, 클래스, 메서드 같은 요소들과

"이 함수가 저 함수를 호출한다", "이 클래스가 저 클래스를 상속한다" 같은

관계들을 모두 파악해요.

 

2) 지식 그래프 저장

파악한 정보를 로컬 SQLite 데이터베이스에 저장합니다.

이름으로 즉시 검색할 수 있는 전문 검색 기능(FTS5)도 내장!

 

3) 자동 업데이트

코드를 수정하면 파일 변경 감지 시스템이 자동으로 그래프를 업데이트합니다.

macOS, Linux, Windows 모두 지원하고, 설정 없이 자동으로 동작해요.

 

결국 AI 도구가 코드를 탐색할 때

파일을 직접 뒤지는 대신 이미 완성된 지도를 조회하기만 하면 됩니다.

당연히 빠르고, 토큰도 적게 쓰는 거죠!

 

 

지원하는 프로그래밍 언어도 다양해요!

 

TypeScript, JavaScript, Python, Go, Rust, Java, C#, PHP, Ruby, C, C++, Swift, Kotlin, **Dart**, Svelte, Liquid, Pascal/Delphi...

 

무려 19가지 언어를 지원합니다!

 

Flutter 개발자라면 Dart 지원이 눈에 들어오시죠?

Visual Studio 개발자라면 C/C++ 지원이 반가울 거예요.

레거시 시스템이라면 Pascal/Delphi까지 지원하니 걱정 없습니다.

 

 

100% 로컬 처리 - 보안 걱정 없어요

 

CodeGraph의 중요한 특징 중 하나입니다.

 

- 코드가 외부 서버로 전송되지 않아요

- 별도의 API 키가 필요 없어요

- 모든 데이터는 내 컴퓨터 안에서만 처리됩니다

 

회사 프로젝트나 비공개 코드를 다루는 분들도 안심하고 쓸 수 있죠!

 

 

언제 쓰면 가장 효과적인가요?

 

소규모 프로젝트(파일 1,000개 미만)는 없어도 큰 차이가 없을 수 있어요.

하지만 파일이 5,000개 이상인 중대형 프로젝트라면

토큰 절감 효과가 어마어마합니다.

 

실제로 Swift Compiler 같은 초대형 프로젝트(파일 25,874개!)를

4분 만에 인덱싱하고, 복잡한 질문에 35초 만에 답변한 사례도 있었거든요.

 

 

마무리하며...

 

AI 코딩 도구를 쓸 때마다 토큰 비용이 부담스러우셨나요?

CodeGraph 하나로 Claude Code, Cursor, Codex CLI 모두 한 번에 최적화할 수 있습니다!

 

설치도 `npx` 명령어 한 줄이면 되고,

프로젝트 초기화도 5분이면 충분해요.

 

여러 AI 코딩 도구를 오가며 사용하시는 분이라면

특히 강력 추천드립니다!

 

한 번 써보시면 "왜 이제야 알았지..." 하실 거예요.

 

 

 

#CodeGraph #ClaudeCode #Cursor #CodexCLI #AI코딩 #MCP #코드지식그래프 #토큰최적화 #개발자도구 #멀티에이전트 #AI개발도구 #개발생산성