Claude Code 셋업 공유 — CLAUDE.md·Skills·Subagents·claude-squad

요약

작성자가 자기 프로젝트(next.js + typescript + postgres 기반)에서 Claude Code Pro $20/월 플랜과 오픈소스 도구를 조합해 만든 6개 레이어 셋업을 공개한 글이다.

일반 결론이 아니라 작성자 개인 환경 기준 구성이고, 댓글에서는 $20 플랜으로 정말 가능한지에 대한 의문이 함께 나왔다.

6개 레이어 구성

레이어 1 — CLAUDE.md

프로젝트 루트에 두고 매 세션 시작 시 읽히는 파일. 다음 항목을 적어 둔다.

• 스택과 모노레포 구조
• 관례: 컴포넌트 PascalCase, API 응답은 { data, error }, 테스트는 소스 옆 *.test.ts, 커밋은 conventional commits
• 아키텍처 결정 근거 (prisma, zustand, clerk 선택 이유)
• 현재 작업 초점
• 규칙: 3개 이상 파일을 한 번에 수정하기 전에 계획 먼저 보여주기, 기존 테스트 먼저 실행, 5단계 이상 작업은 계획 문서부터 만들기

레이어 2 — 외부 메모리

세션을 넘어 남는 메모리를 위한 조합.

• Obsidian vault: /decisions, /errors, /patterns, /sessions, /stack, Memory.md, index.md. 구조는 Karpathy의 llm-wiki 개념에서 가져왔다.
• claude-mem: 세션을 압축해 다음 세션으로 넘기는 지속 저장소
• claude-subconscious: 백그라운드 에이전트가 세션을 보고 메모리를 수동 입력 없이 작성

레이어 3 — 스킬

Claude를 특정 작업에 특화시키는 마크다운 파일 모음.

• Superpowers (Anthropic 플러그인 마켓플레이스): brainstorm → spec → plan → TDD → 구현 → 리뷰 흐름을 강제
• Trail of Bits 보안 스킬: PR 단계 보안 점검
• Anthropic 공식 스킬: PDF, DOCX, XLSX, 데이터 분석
• tdd-guard: 테스트가 빠진 커밋 차단

레이어 4 — 서브에이전트 5종

각 에이전트는 컨텍스트 윈도우와 CLAUDE.md, 분리된 도구 권한을 갖는다.

에이전트	역할
architect	설계, 스펙, 플랜만 작성 (코드 안 씀)
coder	플랜대로 코드 작성, 도구 접근 가장 넓음
reviewer	security-first pr 리뷰, 커버리지 확인
tester	테스트 작성·실행, tdd-guard
ops	배포, CI/CD, 인프라

레이어 5 — 훅과 슬래시 명령

자주 반복하는 지시는 슬래시 명령으로 만든다.

• /fix-issue 456: GitHub 이슈를 읽고 브랜치 → 테스트 포함 수정 → PR
• /review: 리뷰어 에이전트로 현재 PR 리뷰
• /deploy staging: ops 에이전트로 배포 파이프라인 실행

훅은 정해진 시점에 자동 실행된다.

• pre-commit: tdd-guard로 테스트 존재·통과 확인
• session-start: Obsidian 메모리와 최근 세션 로그 로드
• pre-push: 보안 리뷰

레이어 6 — 병렬 오케스트레이션

claude-squad가 git worktree 단위로 에이전트를 띄워 브랜치 충돌 없이 병렬 실행한다. 자동 수락 모드(cs -y)로 야간에 3개 에이전트를 동시에 돌렸다고 작성자는 적었다.

댓글에서 나온 의문

• $20/월 플랜으로 15분 이상 일을 시키기 어렵다는 반박이 가장 많은 추천을 받았다.
• 본문이 또 하나의 CLAUDE.md 변형 글이고 마지막에 외부 링크가 있어 광고로 보인다는 지적이 있었다. 같은 댓글 작성자는 공유 메모리와 set-and-forget 방식의 자동화는 실제로는 잘 안 된다는 의견도 함께 남겼다.
• 한 댓글은 Claude 자체 리뷰가 코더 작업을 그냥 통과시키는 문제를 codex로 까다롭게 리뷰시켜 보완한다는 실사용 방식을 공유했다.