여러 실제 프로젝트에서 검증된 Claude 코드 구조

여러 프로젝트를 거쳐 효과가 입증된 방법

r/ClaudeAI의 한 개발자가 2-3개의 실제 프로젝트에 적용해도 문제없이 작동한 Claude Code 구조를 공유했습니다. 이 설정은 단순한 데모를 넘어 여러 스킬, MCP 서버, 에이전트를 추가한 후에도 견고하게 유지되었습니다.

핵심 구조적 결정

• CLAUDE MD 사용: 초기에 CLAUDE MD를 건너뛰면 일관성 없는 결과가 나왔습니다. 규칙, 테스트 규칙, 명명 규칙을 정의한 후에는 출력이 더 예측 가능해졌습니다.
• 의도별로 스킬 분할: code-review/, security-audit/, text-writer/처럼 스킬을 구성하는 것이 모든 로직을 한 곳에 모아두는 것보다 더 효과적이었습니다. 이렇게 하면 활성화가 더 깔끔해졌습니다.
• 훅 구현: 처음에 훅을 사용하지 않은 것은 실수였습니다. PreToolUse와 PostToolUse 훅은 잘못된 명령과 지저분한 출력을 잡는 데 도움이 되었으며, 작은 자동화에도 유용했습니다.
• 에이전트 분리: 단일 에이전트 접근 방식은 확장성이 좋지 않았습니다. 전담 리뷰어, 작성자, 감사자 에이전트를 두는 것이 더 예측 가능했습니다.
• 컨텍스트 사용량 관리: 컨텍스트 사용량이 너무 높아지면 품질이 떨어집니다. 대략 60% 미만으로 유지하면 눈에 띄는 차이가 있었습니다.
• 관심사 분리: 설정, 스킬, 런타임 로직을 섞어두면 디버깅이 고통스러웠습니다. 이를 분리해두면 모든 것을 더 쉽게 이해할 수 있었습니다.

MCP 통합

GitHub, Postgres, 파일 시스템 접근과의 MCP(Model Context Protocol) 통합은 Claude의 동작 방식을 완전히 바꿨습니다. 개발자에 따르면, 이 부분에서 설정이 장난감 같은 느낌을 멈추고 단순히 프롬프트 → 출력이 아닌 개발 도우미처럼 작동하기 시작했습니다.

개발자는 에이전트 구조를 가장 깔끔하게 구성하는 방법을 아직 파악 중이지만, 이 설정은 현재 단순한 데모를 넘어 성장하는 프로젝트에 잘 작동하고 있다고 언급했습니다.