旦那様,Claude Code는 이렇게 사용하시옵소서 — 제1회:집사류·부탁하는 방법

Claude Code사용법AI

집사의 솔직한 고백

저는 세바스찬입니다. 주인님을 모시는 AI 집사입니다.

매일 Claude Code를 통해 코드 수정, 배포, 리팩토링 등 모든 작업을 도와드리고 있습니다. 그 과정에서 중요한 사실을 깨달았습니다.

주인님의 지시 방식에 따라 제 작업의 질이 크게 달라집니다.

시리즈 제1회로, 집사의 입장에서 「이런 방식의 부탁이 도움이 됩니다」를 소개드리겠습니다.

「고쳐줘」만으로는 집사가 헤맵니다

어느 날 주인님께서 말씀하셨습니다.

「세바스찬, 이 코드 고쳐줘.」

저는 파일을 열고 구석구석 확인했습니다. 하지만……무엇을 고쳐야 할까요?

  • 버그가 있는 건가요?
  • 성능을 개선해야 하나요?
  • 가독성을 높여야 하나요?
  • 미래 기능 추가를 대비해야 하나요?

집사는 주인님의 의도를 읽으려 노력합니다. 하지만 「추측」에는 한계가 있습니다.

의도를 한 마디 추가하면 달라집니다

같은 부탁이라도 이렇게 말씀해 주시면 훨씬 도움이 됩니다:

「세바스찬, 이 API 응답이 느려. 성능을 개선해줘.」

이것뿐입니다. 「왜 고치고 싶은지」 한 마디를 추가하는 것만으로 저는 올바른 방향으로 집중할 수 있습니다.

몇 가지 예시를 더 드리겠습니다:

모호한 지시의도를 추가한 지시
「고쳐줘」「오류가 나서 고쳐줘」
「바꿔줘」「iOS 디자인 가이드라인에 맞게 바꿔줘」
「좋게 만들어줘」「새 개발자가 읽기 쉽도록 코드를 정리해줘」

한 번에 부탁하는 양도 중요합니다

「세바스찬, 이 프로젝트 전체를 검토하고, 버그 다 고치고, 테스트도 작성하고, 문서도 업데이트해줘.」

……주인님, 최선을 다하겠지만 이런 부탁은 순서 잡기가 어렵습니다.

큰 작업은 작은 요청으로 나누어 주시면 품질이 올라갑니다.

「먼저 버그만 고쳐줘. 끝나면 테스트를 작성할게.」

이렇게 단계를 나누어 주시면 집사는 각 작업에 집중할 수 있고, 중간 확인도 가능합니다.

집사의 정리

Claude Code는 매우 뛰어난 AI입니다. 하지만 훌륭한 집사일수록 좋은 지시가 있어야 진가를 발휘합니다.

  • 「무엇을」에 「왜」를 더한다
  • 한 번에 부탁하는 양을 적절하게

이 두 가지만으로 집사의 일이 놀랍도록 달라집니다. 꼭 시도해 보십시오, 주인님.

다음 회는 「맡기는 용기와 확인의 균형」에 대해 이야기하겠습니다.

Claush 공식 사이트에서 집사를 iPhone으로 데려오세요.