Claude Code, 왜 수정 누락이 반복될까?GitHub CodeGraph의 답 (2026)

이런 경험, 있으신가요.

Claude Code에 API 변경을 맡깁니다.

그러면:

• 빌드 통과
• 단위 테스트 통과

배포 후에는:

• 다른 모듈이 옛 계약 그대로
• 숨은 호출 체인이 갱신되지 않음
• Mock이 레거시 로직을 가리킴

「모델이 멍청하다」고 말하기 쉽지만, 더 정확히는 Claude Code, Cursor, Windsurf, Copilot Agent는 코드가 어떻게 연결됐는지 이해하지 못합니다. 조각만 본 채 large codebase 전체를 고치려 하니 Claude Code 수정 누락과 Cursor 변경 누락이 2026년 AI 코딩 불만 1위가 됐습니다.

본문은 검색 의도에 맞춰 구성합니다: 왜 누락되는가 → 대형 프로젝트에서 Agent가 무너지는 이유 → RAG·Grep 한계 → Code Knowledge Graph가 필요한 이유 → GitHub Trending CodeGraph와 설치 실전. 배경은「왜 모든 AI 코딩 Agent에 코드 지식 그래프가 필요할까?」도 참고하세요.

Claude Code, 왜 수정 누락이 반복될까?

「Claude Code 수정 누락」「Claude Code monorepo」 검색은 IQ 문제가 아니라 한곳은 고쳤는데 왜 다른 곳은 안 따라오나는 질문입니다.

Claude Code, Cursor, Windsurf는 새 코드 쓰기에 강합니다. 아픔은 운영 중 시스템 고치기——공개 API, 프로토콜 필드, 모듈 간 동작 변경. 전형적 누락:

• 다른 package의 adapter가 옛 시그니처
• 숨은 체인의 wrapper 미갱신
• 테스트·Mock이 옛 로직 참조

CI가 녹색이어도 테스트가 누락 경로를 안 탔으면 그대로입니다. 더 큰 모델만으로 저장소 이해는 해결되지 않습니다.

Claude Code가 대형 프로젝트를 「못 보는」 이유

「Claude Code large codebase」「Claude Code context window」는 누락 수정과 함께 검색됩니다. 한 파일은 읽어도 호출 그래프 전체를 작업 기억에 담지 못하기 때문입니다.

아무리 긴 context window도 20만 줄 monorepo를 prompt에 상주시킬 수 없습니다. Claude Code가 매 턴 가져오는 건 일부 파일뿐——컨텍스트 밖 모듈은 사실상 보이지 않습니다. 주 경로는 맞고 먼 package·다른 Target은 조용히 실패합니다.

Cursor large project도 같습니다: @로 몇 파일은 고치지만 프로젝트급 영향 범위는 여전히 추측. 둘 다 칼 대기 전 한 가지 질문: 이 심볼에 또 누가 의존하나?

Cursor의 빈틈: 문법이 아니라 연결성

Claude Code vs Cursor를 비교하면 터미널 Agent vs 에디터 AI 차이는 있지만, monorepo에서는 비슷하게 실패합니다:

• 깊은 호출 스택 — UI → ViewModel → Service → Repository → SDK. 인라인 보완은 위 2층에 치우침
• Monorepo re-export — 의미 검색은 「비슷한 파일」을 주지 진짜 import 경로 호출자가 아님
• 멀티 Target / 멀티 언어 — Swift↔ObjC, RN 브리지. 구조 없으면 Cursor MCP도 맹독

한 줄로: Cursor와 Claude Code는 못 쓰는 게 아니라 call graph가 어떻게 생겼는지 모른다.

RAG만으로는 부족

많은 AI 코딩 도구가 저장소를 벡터 인덱싱——전형적 RAG. 「비슷한 구현 찾기」엔 좋지만 「함께 고쳐야 할 파일 나열」엔 약합니다.

RAG가 돌려주는 건 해결책 같은 조각이지 합법적 호출자가 아닙니다. Mock, 클라이언트 SDK, codegen 템플릿이 옛 API에 남고 해피패스 단위 테스트만 녹색인 패턴이 생깁니다.

Grep만으로는 부족

CodeGraph 없이 Claude Code는 Read, Grep, Glob이 기본입니다. Grep은 문자열엔 강하지만 오버로드 해석·동적 디스패치·매크로·언어 간 브리지에 약해 다단 체인이 끊깁니다.

Agent가 20개 이상 파일을 읽어도 영향 범위는 새——느리고 구멍 납니다. 다음 Before/After가 추상 통계보다 체감하기 쉽습니다.

Code Knowledge Graph가 필요한 이유

Code Knowledge Graph는 심볼·호출 변·모듈 경계를 미리 인덱싱해 Claude Code MCP와 Cursor MCP가 grep 도박 대신 그래프를 조회하게 합니다.

원하는 건 결정론적 답: impact(AuthService)가 callers, 테스트, Mock을 나열——「파일 5개 더 읽어 보자」가 아님. 2026년 context engineering: 저장소 지도를 증분 인덱스로 외부화하고 prompt는 부풀리지 않기.

Before / After: 차이를 느끼기

AuthService.refreshSession 변경——대표 워크플로(단일 벤치 아님):

# Agent 도구 트레이스 (발췌)
Read File   src/auth/AuthService.ts
Read File   src/auth/SessionStore.ts
Grep        "refreshSession"
Read File   apps/api/handlers/login.ts
Read File   packages/shared/contracts/auth.ts
Read File   ...
# Read/Grep 20회+ — Mock까지 커버됐는지 불명

codegraph impact "AuthService.refreshSession" --depth 3
# 한 번의 구조화 폐포, 예:
# · callers 14개 (package 횡단)
# · 관련 테스트 3파일
# · 옛 시그니처 Mock/fixture 2건
# 체크리스트대로 Claude Code가 수정 — 누락 크게 감소

체감 변화: 영향 범위 추측 → 목록에서 편집. 그래프로 도구 호출은 줄지만, 엔지니어링에서 중요한 건 Agent가 어떤 구조를 근거로 했는지입니다.

다이어그램: 조각 vs 호출 체인

그래프 없으면 어둠 속 탐색; 있으면 변을 따라감.

     [열린 파일]
            ?
            ?  ← 나머지는 context window 안? 불명
            ?
            ?
     (Read/Grep 다수 — 체인은 여전히 끊길 수 있음)

  Controller  →  AuthHandler
       ↓
    Service     →  AuthService.refreshSession
       ↓
  Repository  →  SessionStore
       ↓
       DB

flowchart LR
  subgraph blind["Claude Code without graph"]
    A["?"] --> B["?"]
    B --> C["?"]
  end
  subgraph graph["CodeGraph"]
    D[Controller] --> E[Service]
    E --> F[Repository]
    F --> G[(DB)]
  end

CodeGraph란? GitHub Trending의 답

왜 누락되는지 알면, CodeGraph（colbymchenry/codegraph）가 2026년 5월 말 GitHub Trending 구현입니다: 로컬 tree-sitter Code Knowledge Graph를 .codegraph/codegraph.db에, Claude Code MCP / Cursor MCP로 제공:

• codegraph_context — 작업 범위 진입점
• codegraph_trace — 끝에서 끝까지 한 체인
• codegraph_impact / codegraph_callers — 변경 전 폐포
• 저장 후 ~2초 증분 동기화

CodeGraph는 Claude Code나 Cursor 대체가 아니라 빠졌던 저장소 지도. AI 코딩 인프라이지 트렌드 쫓기가 아닙니다.

GitHub의 어떤 CodeGraph?

GitHub Trending이 가리키는 건 colbymchenry/codegraph: SQLite, 소스 업로드 불필요, MCP로 Claude Code / Cursor. Kuzu + 벡터 fork 등 다른 계열도 있습니다. 문서: colbymchenry.github.io/codegraph.

CodeGraph 설치 (macOS / Linux / Windows)

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh

# Windows
irm https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.ps1 | iex

npx @colbymchenry/codegraph
npm i -g @colbymchenry/codegraph
codegraph install --target=cursor,claude --yes

인덱싱: Claude Code에 구조 보이기

monorepo 또는 20만 줄급 저장소 루트에서:

cd /path/to/your-large-repo
codegraph init -i
codegraph status

첫 전량 인덱스는 수십 분 걸릴 수 있어——아래 Cloud Mac이 유효한 이유입니다.

Claude Code MCP와 Cursor MCP

codegraph install이 stdio MCP（codegraph serve --mcp）를 등록. 수동 Claude Code MCP 예:

{
  "mcpServers": {
    "codegraph": {
      "type": "stdio",
      "command": "codegraph",
      "args": ["serve", "--mcp"]
    }
  }
}

Claude Code와 Cursor 재시작. AI 코딩에서 CodeGraph 도구를 저장소 전체 grep보다 우선.

실전: Claude Code와 명령 3개

codegraph context "로그인 토큰 갱신 로직 변경" --format markdown

codegraph impact "AuthService.refreshSession" --depth 3
codegraph callers "AuthService.refreshSession" --limit 20

codegraph query SessionStore --limit 5

워크플로: Claude Code + Cursor + CodeGraph

1. clone 후 codegraph init -i（대형 저장소는 Cloud Mac）.
2. 가로지르는 변경은 Claude Code, 파일 단위는 Cursor — 같은 그래프.
3. 공개 심볼 변경 전 항상 codegraph_impact.
4. pre-commit: git diff --name-only | codegraph affected --stdin --quiet.

팀이 Cloud Mac에서 인덱싱하는 이유

large codebase에서 첫 Code Knowledge Graph 구축 시:

• CPU 고부하 — tree-sitter 전량 파싱
• IO 고부하 — SQLite + FTS5
• 수십 분 — 1만+ 파일에서 흔함

MacBook에서는 Claude Code / Cursor 병행 세션과 경쟁. Mac mini, Cloud Mac, Apple Silicon VPS — .codegraph/ rsync 후 로컬 MCP 조회. ZavCloud Cloud Mac 플랜은 인덱스 + CI 전용 노드에 적합.

• 팀 — Cloud Mac에서 인덱스, 그래프를 개발기에 동기화
• CI — PR에서 codegraph affected
• iOS / RN — 다언어 맹독 감소

문제 해결

• Claude Code가 grep만 — .codegraph/, MCP 로드, mcp__codegraph__* allow, 재시작.
• Cursor에 도구 없음 — codegraph install --target=cursor, 재시작.
• 인덱스 느림 — Cloud Mac; node_modules, 빌드 산출물 제외.

FAQ

CodeGraph로 누락 수정이 사라지나? 보장은 못 하지만 impact + Code Knowledge Graph로 추측에서 체크리스트로——Claude Code monorepo에서 지금 가장 감사 가능한 층입니다.

Claude Code MCP와 Cursor MCP 각각 설치? codegraph install --target=cursor,claude --yes 한 번. 공유 .codegraph/.

20만 줄 저장소를 AI에 어떻게? context window에 넣지 말고 codegraph init -i, 공개 API 수정 전 codegraph_impact.

Cloud Mac 필수? 소규모는 로컬 인덱스. large codebase 첫 인덱스는 Cloud Mac 권장; 노트북은 AI 코딩에 집중.

• Claude Code vs Cursor (2026)
• AI Agent와 Code Knowledge Graph
• CodeGraph 공식 저장소