The Claude Code setup that won a hackathon

해당 블로그 글은 Anthropic x Forum Ventures 해커톤에서 zenith.chat이라는 프로젝트로 우승을 차지한 개발자(Affaan 및 JP Caparas 등 관련 커뮤니티에서 공유된 내용)의 'Claude Code' 최적화 설정을 다루고 있다.

• 핵심 철학: Claude를 단순한 챗봇이 아닌, 다역할을 수행하는 '에이전트 팀'으로 운영하라

1. 핵심 요약 (Core Summary)

이 프로젝트의 성공 비결은 Claude Code를 고도로 구조화된 워크플로우와 결합하여 완전한 개발 파이프라인을 구축한 데 있습니다.

• 에이전트 팀 구성: 메인 세션을 '프로젝트 매니저(PM)'로 두고, 세부 작업은 병렬로 실행되는 '서브 에이전트'들에게 위임합니다.
• 표준화된 프로세스: /plan, /tdd, /code-review 등의 커스텀 명령어를 통해 개발 루틴을 자동화했습니다.
• 품질 가드레일: 코드 스타일, 보안, 테스트 통과 여부를 강제하는 Rules와 Hooks를 설정하여 AI가 실수를 줄이도록 설계했습니다.

2. 중요 부분 상세 설명 및 기술적 분석

① MCP (Model Context Protocol) - AI의 'USB-C 포트'

이 설정에서 가장 중요한 기술적 기반은 Anthropic이 발표한 MCP입니다.

• 상세 내용: MCP는 AI 모델이 외부 데이터 소스(GitHub, Google Drive, 데이터베이스 등)나 로컬 도구와 통신하기 위한 공개 표준 프로토콜입니다.
• 활용법: 우승자는 GitHub, Supabase, Vercel 등을 MCP로 연결하여 Claude가 직접 이슈를 읽고, DB 스키마를 확인하며, 배포 상태를 체크하게 했습니다.
• 주의점: MCP 서버를 너무 많이 활성화(20개 이상)하면 컨텍스트 윈도우가 급격히 줄어들 수 있으므로, 프로젝트당 10개 미만으로 제한하여 토큰 효율을 높이는 것이 중요합니다.

② Skills & Slash Commands (커스텀 명령어 자동화)

Claude Code의 기능을 확장하는 핵심 수단입니다.

• Skills: 특정 작업(예: API 문서 작성, 보안 리뷰)에 대한 전문 지식을 담은 Markdown 파일(.claude/skills/)입니다. Claude가 필요할 때 자동으로 호출합니다.