10년 차 개발자의 Claude Code 활용기: 코드 안 읽고 '바이브 코딩'으로 사이드 프로젝트 완성하기
핵심 요약
코드 한 줄 안 읽고 Claude Code로 사이드 프로젝트를 완성하는 15가지 실전 팁.
- 계획 모드 활용 — 에이전트가 세운 계획을 철저히 검토하고 이해해야 함.
- 테스트 코드 작성 — 코드의 동작을 검증하고 변경 시 안정성을 확보함.
- 점진적 개발 — 복잡한 작업은 작은 단위로 쪼개어 에이전트와 소통함.
- 자동화와 백업 — 자동 모드 사용 전 데이터 백업과 테스트 환경을 구축함.
-
계획 모드에서 시작하세요.
-
계획을 읽으세요.
-
다시 말할게요. 계획을 읽으세요.
-
계획을 최대한 이해하세요. 불분명하거나 말이 안 되는 부분이 있으면 물어보세요. Claude Code에서는
4. Tell Claude what to change를 항상 사용해서 "<section>이 무엇에 관한 건가요? 무슨 뜻인가요?"라고 물어봅니다. 소프트웨어 엔지니어가 아니더라도, 에이전트가 무엇을 하는지 더 많이 이해할수록 더 나은 결정을 내릴 수 있습니다. 코드를 전혀 보지 않더라도, 최대한 높은 수준에서 모든 것을 이해하려고 노력하세요. -
에이전트와 최대한 많이 소통하세요. 계획 모드에서의 단계가 가장 중요합니다. 좋고 나쁜 결정들은 연쇄적으로 일어나고 증폭되기 때문입니다.
-
계획이 너무 복잡해서 머릿속에 쉽게 들어오지 않는다면, 너무 큰 것입니다. 에이전트에게 계획을 더 작고 이해하기 쉬운 단위로 쪼개달라고 요청하고, 한 번에 하나씩 이 단계를 따르세요.
-
계획이 완료된 후 모든 것을 git에 커밋하는 기술이나 메모리를 만드세요. 로컬이어도 상관없습니다. git이 무엇일까요? 본질적으로 특정 시점의 코드를 저장하는 방법입니다. 이렇게 하면 무언가 고장 났을 때 과거로 돌아갈 수 있다는 확신을 가지고 앞으로 나아갈 수 있습니다. 참고: 데이터베이스 관련 작업은 별개입니다. 이는 코드 자체에만 적용됩니다. 하지만 핵심은 계획을 완료하면 코드 상태를 저장한다는 것입니다. 과거의 특정 시점으로 돌아가고 싶다면, 이제 아주 쉽게 할 수 있습니다. Claude나 에이전트에게 설정해달라고 하세요. 후회하지 않을 겁니다.
-
테스트. 테스트란 무엇일까요? 테스트는 코드가 의도한 대로 작동하는지 검증하는 데 도움을 주는 코드입니다.
-
예시: 두 숫자 a와 b를 더해 결과를 반환하는 함수를 작성한다고 해봅시다. 1과 2를 넣으면 3이 나오길 기대할 것입니다. 하지만 음수를 넣으면 어떻게 될까요? 값을 넣지 않으면 어떻게 될까요? 이런 모든 상황을 검증하는 테스트를 작성할 수 있습니다.
-
테스트는 두 가지 주요 방식으로 도움을 줍니다:
-
- 바이브 코딩을 할 때, 코드가 예상대로 작동하는지 확인하고 올바르게 완료되었다는 확신을 줍니다.
-
- 나중에 변경 사항을 만들 때 기존 기능이 깨지지 않도록 보장해 줍니다.
-
참고: 이것들이 완벽하거나 100% 신뢰할 수 있는 것은 아니지만, 반드시 갖춰야 할 필수 요소입니다.
-
에이전트가 계획에서 읽을 수 있는 테스트 케이스를 생성하게 하세요. 테스트 코드를 읽거나 이해할 필요는 없지만, 위 예시를 사용하면 다음과 같은 내용을 보는 것이 유용할 것입니다:
-
- 테스트 케이스:
-
- 두 개의 양의 정수를 확인
-
- 음수 값을 전달하는 경우를 확인
-
- 값을 전달하지 않는 경우를 확인
-
변경 사항이 복잡하다면, 세 개의 하위 에이전트를 가동하세요:
-
- 계획을 비판적으로 검토
-
- 보안 검토 수행
-
- 테스트 감사 수행


