[Claude 가이드] 나만의 Claude 사용 팁

들어가며

최근 개발자들 사이에서 Claude 3.5 Sonnet이 압도적인 찬사를 받는 이유는 단순히 '코드를 잘 짜서'가 아닙니다. Claude를 진정으로 100% 활용하는 비결은 AI를 하나의 만능 비서로 부리는 것이 아니라, 역할을 분담하여 거대한 자동화 시스템을 구축하는 '에이전틱 워크플로우(Agentic Workflow)'에 있습니다.

이번 1부에서는 제가 실제로 Claude를 활용하면서 느낀 '코드 품질을 200% 끌어올리는 실전 세팅법과 프롬프트 팁'을 아낌없이 공유해보려 합니다.

 

1. 핵심 개념: 3개의 에이전트(Agent) 분업화

Claude에게 한 번에 완벽한 결과물을 기대하면 안 됩니다. 가장 이상적인 개발 방식은 프롬프트나 프로젝트 세팅을 통해 AI의 역할을 기획자, 개발자, 검토자 세 가지로 명확히 나누는 것입니다.

• Planner (설계자): "무엇을, 어떻게 만들 것인가?"
  • 코드 작성은 일절 하지 않고, 아키텍처 아웃라인, 사용할 라이브러리, 데이터 흐름도만 설계합니다.
• Coder (실행자): "설계도대로 코드를 구현하라"
  • Planner가 넘겨준 기획서를 바탕으로 오직 코드 작성에만 집중합니다.
• Reviewer (검토자): "보안과 성능을 점검하라"
  • 작성된 코드의 에러, API 키 노출 등의 보안 이슈, 엣지 케이스를 비판적으로 검토합니다.

이러한 멀티 에이전트 방식을 사용하면, AI가 스스로 환각에 빠지는 것을 막고 훨씬 견고한 파이프라인을 구축할 수 있습니다.

 

2. 프로젝트의 규칙: CLAUDE.md

Claude로 프로젝트를 시작할 때 가장 먼저, 그리고 가장 중요하게 챙겨야 할 것은 바로 CLAUDE.md 파일입니다.

단순히 지시사항 몇 개 적어두는 것이 아닙니다. 이 파일은 프로젝트의 '헌법'이자 '업무 매뉴얼'입니다. 여기에 코딩 컨벤션, 사용할 프레임워크의 버전, 디렉토리 구조, 그리고 AI가 지켜야 할 페르소나를 명시해 두세요. Claude가 이 파일을 읽고 시작하느냐 아니냐에 따라 결과물 코드의 품질 자체가 완전히 달라집니다.

 

3. 구현 전 필수 단계: "AI에게 역으로 인터뷰 당하기"

가장 많이 하는 실수 중 하나가 계획 없이 바로 코드를 짜게 만드는 것입니다. 코드부터 짜게 하지 말고, Claude가 나를 인터뷰하게 만드세요. 제가 실무에서 새로운 파이프라인의 뼈대를 잡을 때 무조건 복붙해서 사용하는 '마법의 프롬프트'를 공개합니다.

[실전 인터뷰 프롬프트]

"본격적인 구현을 시작하기 전에 나한테 먼저 인터뷰를 진행해 줘. 지속적으로 기능을 추가할 확장성 있는 '뼈대'를 만드는 것을 중심으로 할 거야.

1. 기술적 구현, UI/UX, 우려 사항, 트레이드오프(Trade-off) 등 모든 것을 심도 있고 뻔하지 않게 질문해 줘.
2. 전체 질문이 총 몇 개인지 처음에 알려주고, 질문은 '객관식 4개 + 주관식 1개' 형식으로 해줘.
3. 객관식 문항에는 네가 전문가로서 추천하는 옵션에 [추천] 마크를 표시해 줘.
4. 인터뷰가 모두 끝나면, 우리가 나눈 대화를 바탕으로 plan_spec.md 파일을 작성해 줘."

 

이렇게 지시하면 Claude는 마치 시니어 아키텍트처럼 날카로운 질문을 던집니다. 이 문답을 통해 요구사항이 완벽하게 정리되며, 마지막에 산출되는 plan_spec.md는 훌륭한 프로젝트 기획서가 됩니다.

 

3. 명시적 To-Do 리스트와 플랜 모드

인터뷰가 끝나고 스펙이 정해졌다면, 바로 개발에 들어갈까요? 아닙니다.

Claude에게 "앞으로 해야 할 일(To-Do) 목록을 먼저 만들어줘"라고 명시적으로 요구하세요. 단순히 "이거 해줘"라고 하는 것과, 체크리스트를 만들어 하나씩 완수해 나가는 것은 프로젝트의 안정성에서 엄청난 차이를 보입니다. 개발 중간중간 "지금 To-Do 리스트 어디까지 진행됐어?"라고 물어보며 진행 상황을 명확하게 트래킹할 수 있습니다.

 

4. hand-off.md와 기억 이어달리기

LLM의 가장 큰 적은 '컨텍스트 창 오버플로우'입니다. 대화가 너무 길어지면 AI가 앞의 내용을 잊어버리거나 엉뚱한 코드를 뱉기 시작합니다. 이때 필요한 것이 바로 '핸드오프' 기법입니다.

대화가 너무 길어졌다 싶으면 Claude에게 이렇게 지시하세요.

"지금까지의 작업 내용을 압축해서 hand-off.md 파일로 정리해 줘. 다음 에이전트가 이 파일만 읽고도 작업을 바로 이어갈 수 있도록 '시도한 것, 성공한 것, 실패한 것, 다음 단계'를 상세히 적어줘."

 

[마무리 및 이어가기 팁]

• /clear 명령어 활용: 채팅창 메모리를 싹 비우는 /clear를 사용한 뒤, 방금 만든 hand-off.md와 plan_spec.md를 다시 던져주면, Claude는 맑은 정신으로 이전 작업의 맥락을 완벽히 이어서 개발을 시작합니다.
• CLI 환경이라면? 터미널에서 Claude를 사용 중이라면 claude --resume 명령어를 통해 이전 대화 세션을 그대로 가져와서 작업을 끊김 없이 이어갈 수 있습니다.

 

마무리

이번 글에서는 Claude를 단순한 '코드 자판기'가 아니라, 기획부터 설계, 컨텍스트 관리까지 수행하는 완벽한 시스템 설계자로 활용하는 비법을 알아보았습니다.

CLAUDE.md로 룰을 세우고, 역방향 인터뷰로 뼈대를 잡은 뒤, hand-off.md로 컨텍스트를 유지하는 이 워크플로우를 익히신다면, 혼자서도 3~4인분의 개발 생산성을 낼 수 있을 거라 확신합니다.