코드 맥락 그래프로 AI 코딩 에이전트 성능 높이기 — 실험 결과 공유
AI 코딩 에이전트에게 코드 전체를 던져주는 대신, 코드 간 관계를 그래프 형태로 정리해 필요한 부분만 전달하는 방식을 실험했습니다. 파일을 무작정 넣을 때보다 에이전트가 더 정확하게 수정 위치를 찾고, 불필요한 토큰(비용)도 줄었습니다. 대형 코드베이스에서 AI 에이전트를 쓸 때 실질적으로 참고할 수 있는 접근법입니다.
코드베이스가 커지면 AI 에이전트에게 '어떤 파일을 보여줄지' 결정하는 것 자체가 어려워집니다. 이 실험에서는 '코드 컨텍스트 그래프'라는 방법을 사용했는데, 함수가 어디서 호출되는지, 어떤 모듈이 어디에 의존하는지 같은 관계를 먼저 그래프로 만들어두고, 에이전트가 작업할 때 전체 파일 대신 관련 노드(연결된 코드 조각)만 골라 전달하는 방식입니다.
결과적으로 에이전트가 수정해야 할 위치를 더 빠르게 파악했고, 컨텍스트 창에 넣는 코드 양이 줄어 토큰 비용도 낮아졌다고 보고합니다. 아직 초기 실험 수준이지만, AI 에이전트로 실제 규모의 프로젝트를 다루는 사람이라면 바로 적용을 검토해볼 만한 아이디어입니다.
핵심 포인트
- 코드 파일 전체 대신 함수·모듈 간 관계를 그래프로 정리해 에이전트에게 전달
- 필요한 코드 조각만 선별해 주기 때문에 토큰(비용) 절감 효과
- 에이전트가 수정 위치를 더 정확하게 찾는 경향 확인
- 대형 프로젝트에서 '어떤 파일을 컨텍스트로 줄지' 고민하는 사람에게 유용
- 아직 초기 실험 단계이며 커뮤니티에서 방법론 검증 중
용어 한 줄 설명
- AI 코딩 에이전트
- 사람의 지시를 받아 코드 작성이나 수정 작업을 도와주는 AI 도구입니다.
- 코딩 에이전트
- 사람의 요청을 받아 코드를 작성하거나 고치는 AI 도구입니다.
- 코드베이스
- 한 소프트웨어를 이루는 전체 코드 묶음입니다.
- AI 에이전트
- 사람 대신 정보를 찾거나 작업을 처리하도록 만든 AI 프로그램입니다.
- 코드 컨텍스트 그래프
- 코드 안에서 함수·파일·모듈이 서로 어떻게 연결되어 있는지 관계도로 나타낸 것.
- 컨텍스트
- AI가 현재 대화에서 기억하고 있는 모든 내용으로, 길어질수록 더 많은 토큰을 소모한다
- 컨텍스트 창
- AI 모델이 한 번에 읽고 처리할 수 있는 텍스트의 최대 분량.
- 토큰 비용
- AI가 글을 읽고 답할 때 처리한 글자 조각 수에 따라 드는 비용입니다.