탐색 → 계획 → 코드 작성 → 커밋 워크플로우

탐색과 계획

처음 두 단계를 처리하는 가장 빠른 방법은 Plan Mode를 사용하는 것입니다. Plan Mode에서는 Claude가 파일을 편집할 수 없습니다. 대신 파일을 읽고 셸 명령을 실행하여 탐색하면서, 구현을 어떻게 진행할지에 대한 정보를 수집합니다.

Plan Mode로 진입하려면 상태 표시줄에 plan mode on이 표시될 때까지 Shift + Tab을 누르세요. 그런 다음 다음과 같은 프롬프트를 작성합니다:



Claude는 관련 파일을 읽고 몇 가지 웹 검색을 수행한 다음 실행 계획을 제시합니다. 이를 검토하고 원하는 기준에 부합하는지 판단하세요. 그렇지 않다면 특정 부분을 수정해 달라고 요청하세요.



이 단계가 방향을 수정하기에 가장 좋은 시점인데, 아직 코드가 작성되기 전이기 때문입니다. 이후에 변경 작업을 할 의도가 없고 단순히 코드베이스에 대한 전반적인 요약만 원한다면, Plan Mode에 들어가지 않고도 탐색 서브에이전트를 실행할 수 있습니다.

코드 작성

계획이 만족스러우면 "승인"을 선택하여 이를 수락하고 Claude가 목록 항목들을 처리하도록 합니다. 권한 모드에 따라 Claude가 진행하는 방식이 결정됩니다. 단계마다 사용자에게 확인을 요청하거나, 파일 편집을 자동으로 수락하거나, 대부분의 작업을 백그라운드 안전 검사로 심사하는 자동 모드로 실행할 수 있습니다.

Claude는 계획을 "완료"로 간주하기 전에 최선을 다해 문제를 해결하려 하지만, 때로는 사용자가 직접 개입해야 할 때도 있습니다. 이것이 Plan Mode로 작업하는 이점입니다. 실행 후에도 결과에 도달한 과정에 대한 맥락을 가지고 있어, 이는 Claude의 다음 결정을 안내하는 데 도움이 됩니다.

코드 작성 단계를 더 원활하게 만드는 몇 가지 팁:

• 성공 기준을 정의하세요. Claude가 결과에 확신을 가지려면 "올바른" 것이 무엇인지 명확해야 합니다. 계획을 작성할 때 이를 명시적으로 밝히세요.

• 도구를 추가하세요. Claude가 목표를 달성하는 데 도움이 되는 도구는 많은 왕복 작업을 줄여줍니다. 예를 들어 웹 UI를 만들고 있다면, Claude Code가 브라우저 탭을 제어하고 UI를 직접 테스트할 수 있도록 Claude in Chrome 확장 프로그램을 설치하세요.

  

• 테스트 스위트를 포함하세요. Claude가 지속적으로 검증할 수 있는 테스트 스위트를 제공하세요. Claude가 직접 테스트를 작성해 줄 수도 있습니다. 이를 맡기기 전에, 거짓 양성을 피하기 위해 테스트가 신뢰할 수 있는 기준인지 확인하세요.

커밋

변경 사항을 직접 테스트해 보고 결과에 만족했다면, 이제 코드를 푸시할 차례입니다. 커밋하기 전에 서브에이전트 코드 리뷰어를 실행하여 작업을 검토하세요. 서브에이전트는 코드베이스를 새로운 시각으로 바라보므로, 메인 에이전트가 세션 중에 가질 수 있는 편향을 가지고 있지 않습니다.



그런 다음 Claude에게 사용자의 스타일에 맞는 커밋 메시지를 생성해 달라고 요청하세요. 이 과정을 반복하세요.

요약

Claude Code를 효과적으로 사용하려면 탐색, 계획, 코드 작성, 커밋 워크플로우를 따르세요:

• 탐색은 프로젝트에 필요한 관련 맥락을 Claude에게 제공합니다.
• 계획은 Claude가 성공을 측정하는 데 사용할 실행 계획을 만듭니다.
• 코드 작성은 최종 결과를 확정하기 전까지 사용자와 Claude 사이에서 오가는 왕복 작업입니다.
• 커밋은 코드를 검토하고 푸시하여 다음 기능 작업을 시작할 수 있도록 도와줍니다.