Claude Code가 레포지토리 문맥을 다 기억해주는데, 점점 머리가 나빠지는 기분이야.
Claude Code can keep the repo in context. I’m starting to lose it.
핵심 요약
Claude Code 사용으로 개발 속도는 빨라졌지만, 코드베이스에 대한 이해도가 낮아지는 것에 대한 고민과 해결책을 논의함.
- 코드 이해도 저하 — AI 의존으로 인해 직접 코드를 짤 때보다 시스템 구조 파악이 어려워짐
- 문서화의 중요성 — 아키텍처와 로드맵을 문서로 관리하여 코드베이스의 흐름을 유지함
- AI 활용 방식 — AI가 작성한 코드를 무조건 수용하기보다 직접 검토하고 테스트하는 과정이 필수적임
- 책임감 있는 개발 — AI를 도구로 활용하되 개발자로서 코드베이스의 전체적인 맥락을 놓치지 않으려 노력함
회사에서 Claude Code를 엄청나게 써대고 있는데, 정작 걱정되는 건 코드 결과물이 아니야. 내 머릿속에서 코드베이스를 쥐고 있는 감각이 너무 빨리 사라진다는 거지.
직접 기능을 구현할 때는 주변 시스템을 거의 반강제로 익히게 됐거든. 제어 흐름을 따라가고, 상태가 어디에 있는지 기억하고, 왜 이상한 우회 코드가 있는지 이해해야 했으니까.
이제는 그냥 동작을 설명하고, diff 확인하고, 테스트 돌리고 훨씬 빠르게 배포할 수 있어. 근데 몇 주 지나고 나면 코드의 실제 흐름보다는 제품 결정 사항만 기억에 남는 경우가 많아.
장애가 터지거나 코드 리뷰할 때 이게 좀 껄끄러워. Claude는 필요할 때마다 저장소를 다시 읽으면 그만이지만, 나는 멘탈 모델을 다시 구축해야 하거든.
그렇다고 다시 모든 걸 손으로 짜야 한다고 생각하진 않아. 큰 변경 사항이 있을 때 인간이 직접 마무리하는 과정을 추가해 볼까 고민 중이야. 뭐가 바뀌었고, 어떤 불변 조건이 변했고, 어디서 문제가 터질지 같은 것들 말이야. 그냥 읽지도 않을 자동 생성 요약본 말고, 채팅창 끄고도 내가 직접 설명할 수 있는 수준으로 말이지.
Claude Code가 구현 대부분을 처리하는 상황에서 코드베이스에 대한 실질적인 주도권을 유지할 수 있는 가벼운 방법 찾은 사람 있어? 아니면 이제는 저장소를 잘 안다는 게, 필요할 때 빠르게 재구성할 수 있는 능력을 의미한다고 받아들여야 하는 걸까?

