내 대규모 리포지토리에서 Claude Code를 마침내 신뢰할 수 있게 만든 습관은 먼저 기록하는 것이었습니다

저는 Claude Code를 사용한 첫 한 달 동안 그것을 마치 지니(genie)처럼 대했습니다. 무언가를 설명하면, 열두 개의 파일에 걸쳐 변경 사항을 뿌려대는 것을 지켜보다가, 오후 내내 그중 절반을 되돌리는 데 시간을 보냈습니다. 그것은 제가 문제를 해결하는 것보다 문제를 만드는 속도가 더 빨랐습니다.

상황을 반전시킨 것은 지루한 일이었습니다. 저는 프로젝트가 실제로 어떻게 작동하는지 설명하는 짧은 파일을 루트(root) 디렉토리에 작성하기 시작했습니다. 인증(auth)이 어디에 있는지, 무엇을 건드리면 안 되는지, 우리가 사용하는 명명 규칙(naming), 테스트를 실행하는 명령어가 무엇인지 등을 적었습니다. 이제 Claude Code는 무엇인가를 수행하기 전에 그것을 읽으며, 알 방법이 없는 컨벤션(conventions)을 추측하는 것을 멈춥니다.

두 번째는 코드를 작성하기 전에 계획을 세우게 하는 것이었습니다. 저는 먼저 접근 방식(approach)을 일반 텍스트로 요청하고, 그것을 읽습니다. 만약 계획이 틀렸다면 코드는 항상 틀렸을 것이며, 계획 단계에서 이를 잡아내는 것은 한 시간 대신 30초의 비용만 들게 합니다. 작은 커밋(commits)도 도움이 됩니다. 무언가 깨졌을 때 실제로 무엇이 변경되었는지 확인할 수 있기 때문입니다.

이 중 어떤 것도 영리한 기술이 아닙니다. 단지 도구는 제가 제공하는 컨텍스트(context)만큼만 유능할 뿐이며, 한동안 저는 컨텍스트를 거의 제공하지 않으면서 모델을 탓하고 있었을 뿐입니다. 여러분의 설정 중에서 첫날에 했더라면 좋았을 것이라고 생각하는 것은 무엇인가요?
submitted by /u/Technical_Car_9617
[link] [comments]