50만 라인 레거시 코드 분석을 하루 만에 끝내고 퇴근하는 설정
TuBrief 편집팀
2026년 8월 12일
0
컴퓨터/소프트웨어원본 영상을 바탕으로 AI의 도움을 받아 작성했습니다. 원본 영상이 기준입니다.
커뮤니티의 다른 글
댓글 (0)
Log in to leave a comment
아직 작성된 글이 없습니다
원본 영상을 바탕으로 AI의 도움을 받아 작성했습니다. 원본 영상이 기준입니다.
Log in to leave a comment
아직 작성된 글이 없습니다
사내 방화벽과 프록시 환경에서 터미널 기반 개발 툴을 구동할 때 네트워크 차단 에러가 터진다. 사내 루트 인증서 검증 실패가 원인이다. 런타임 특성상 운영체제 기본 저장소를 우회하기 때문이다.
터미널 프로필에 직접 설정을 넣어야 한다. HTTP_PROXY 및 HTTPS_PROXY 변수에 사내 프록시 주소를 입력한다. NODE_EXTRA_CA_CERTS 변수에는 사내 루트 인증서 파일 경로를 지정한다. ANTHROPIC_BASE_URL을 로컬 Ollama 엔드포인트로 잡고 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 값을 1로 두면 외부 통신이 차단된다. 방화벽 규정을 지키면서 스캔 에러를 없애고 세팅 시간을 줄인다.
50만 라인이 넘는 모놀리식 저장소에서 전체 스캔을 돌리면 30분이 걸리거나 힙 메모리 에러로 멈춘다. 16GB RAM 환경에서는 14B나 20B 크기의 로컬 모델을 써야 스캐너가 버틴다. 프로젝트 루트에 .understandignore 파일을 만든다.
제외 패턴을 적용하는 방법은 간단하다. 최상위 디렉토리에 파일을 만들고 **/node_modules/, **/target/, **/build/, **/src/test/ 경로를 적어 넣는다. 터미널에 NODE_OPTIONS="--max-old-space-size=8192" 명령을 쳐서 Node.js 힙 메모리 한도를 늘린다. 분석 대상 파일이 줄어들면서 초기 스캔 완료 시간이 3분 이내로 떨어진다.
거대한 저장소 전체를 대상으로 질문을 던지면 지식 그래프에 있는 수만 개 노드가 한꺼번에 로드된다. 환각 현상이 터진다. 구버전 결제 클래스와 신규 결제 클래스를 헷갈려 실행되지 않는 메서드를 가져온다. 비즈니스 로직 영역을 좁혀야 한다.
특정 디렉토리로 질의 범위를 한정하는 절차는 이렇다. 단일 파일을 볼 때는 명령어 뒤에 타겟 파일의 상대 경로를 붙인다. 도메인 흐름을 파악할 때는 특정 도메인 경계 내의 노드만 추출하는 명령을 실행한다. 챗 명령어 쓸 때도 검토할 디렉토리 경로를 명시하고 테스트 폴더는 제외한다. 노드 수가 줄어들면서 코드 탐색 정확도가 올라간다.
AI가 준 결과물만 믿고 코드를 바로 고치면 위험하다. 지식 그래프 출력과 실제 소스 코드가 맞는지 직접 대조해야 한다. IDE 파일 탐색 기능을 열어 AI가 말한 메서드가 실제로 존재하는지 본다. 호출 관계를 검증하고 트랜잭션 범위와 매핑 파일을 확인한다. 코드를 수정하기 전에 파급 효과를 분석하는 명령을 실행한다.
담당자가 퇴사하고 문서가 없는 레거시 시스템에서는 API 하나를 파악하려 해도 수십 개 파일을 뒤져야 한다. Understand-Anything의 툴을 쓰면 엔트리 포인트부터 계층별 의존성 순서대로 시스템을 안내하는 투어가 만들어진다. 시니어 개발자에게 매번 물어볼 필요가 없다.
요청과 응답 흐름 그래프를 뽑아내는 방법은 이렇다. 지식 그래프 분석을 끝낸 뒤 대시보드 UI를 띄운다. 메뉴에서 투어 기능을 선택하거나 명령어를 직접 입력한다. API 엔트리 포인트부터 백엔드 서비스와 데이터베이스로 이어지는 노드를 순차적으로 따라가며 실행 흐름을 시각화한다.
레거시 코드를 건드릴 때는 사이드 이펙트를 미리 계산해야 한다. 코드를 편집한 뒤 커밋하기 전에 변경된 파일을 그래프 노드로 변환해 주는 명령을 돌린다. 연결된 노드들을 종합적으로 산출한다. 변경 사항이 기존 API나 배치 작업에 미칠 영향을 미리 파악한다.
분석된 자산은 마크다운으로 뽑아내 사내 위키에 등록한다. 스캔 완료 후 생성된 지식 그래프 파일을 커밋하여 문서화 부채를 털어낸다. 파일이 크면 Git LFS로 관리한다. 대용량 파일 추적을 설정하고 설정 파일을 저장소에 올린 뒤 온보딩 가이드로 활용한다. 커밋할 때마다 증분 파이프라인이 돌도록 걸어두면 매번 전체 스캔을 돌릴 필요 없이 최신 아키텍처 상태를 유지할 수 있다.