Claude Code에 코딩 전 불확실한 부분부터 묻게 하라

Claude Code를 수개월 동안 매일 써 본 경험에서 가장 도움이 된 습관은 코드를 만들기 전에 확신이 없는 부분과 추측한 내용을 먼저 밝히게 하는 것이었다. 결과물과 설명이 그럴듯해도, 특정 API가 예상대로 작동하거나 어떤 값이 항상 존재한다고 확인 없이 가정할 수 있다.

이런 가정은 나중에 실제 오류로 이어지기 쉽다. 불확실한 지점을 미리 표시하게 하면 검토할 부분이 분명해져 모든 코드를 똑같이 의심하며 읽을 필요가 줄어든다.

사소한 이름을 고치는 데 시간을 쓰는 대신 빈 값 처리처럼 실제 문제가 될 가능성이 큰 곳을 먼저 확인할 수 있다. 스스로 확신 정도를 하게 하는 것만으로도 Claude Code가 답을 다시 검토하고 불안한 부분을 먼저 수정하는 경우가 있었다.

핵심 포인트

  • 코드를 만들기 전에 확신이 없는 부분과 추측한 내용을 먼저 적게 한다.
  • API의 동작이나 값의 존재 여부를 확인 없이 가정했는지 살핀다.
  • 전체를 같은 강도로 검토하기보다 불확실하다고 표시된 부분부터 확인한다.
  • 확신 정도를 하게 하면 답을 다시 검토하고 문제를 선제적으로 고칠 때가 있다.
원문 보기