대부분의 사람들은 Claude Code를 챗봇처럼 사용합니다. 나는 내 것을 24/7 데브 팀으로 전환했고, 모든 것을 기억하고 매 세션마다 더 똑똑해집니다. 잊지 마세요 — 나중에 잊어버리지 않도록 북마크하세요.
나도 3개월 동안 Claude Code를 틀리게 사용했음
매 세션이 동일하게 시작됨:
“나는 React 앱을 TypeScript로 빌드 중, Postgres 사용, Vercel 배포, 여기 폴더 구조…”
매일 같은 설명. 매일 같은 프롬프트. 터미널이 기억하지 못하는 것을 매번 다시 설명.
1주일 추적해보니: 하루 47분을 도구에게 내 자신을 다시 설명하는 데 낭비했음.
그래서 전체 설정을 처음부터 다시 구축했음.
이제 Claude Code는 내가 내린 모든 결정을 기억. 자는 동안 5개 에이전트 병렬 실행. 내 코딩 표준이 자동으로 적용됨. 매 세션마다 더 똑똑해짐. 리셋되지 않음.
전체는 $20/월 구독으로 돌아감.
단계별 구축 방법:
/part 1 - CLAUDE.md: 모든 것을 바꾸는 기초
사람들의 90%가 건너뛰거나 틀리 작성하는 파일입니다.
CLAUDE.md는 프로젝트 루트에 있습니다. Claude Code는 매 세션 시작 시 이걸 읽습니다. 누구인지, 무엇을 빌드 중인지, 어떻게 하길 원하는지 한 번에 영구적으로 알려주는 방법입니다.
대부분: “이건 React 앱이에요, 도와주세요” — 쓸없음.
실제로 작동하는 것:
# CLAUDE.md
## project
- stack: next.js 14, typescript, tailwind, postgres via prisma
- deployed on vercel, staging branch auto-deploys
- monorepo: /apps/web, /apps/api, /packages/shared
## conventions
- all components in PascalCase
- API routes return { data, error } format
- no default exports except pages
- tests live next to source files, named *.test.ts
- commits follow conventional commits (feat:, fix:, chore:)
## architecture decisions
- chose prisma over drizzle (dec 2024): type safety priority
- chose zustand over redux (jan 2025): less boilerplate
- auth via clerk, not next-auth: better DX for our team size
## current focus
- migrating payment system from stripe checkout to stripe elements
- performance audit on /dashboard (target: LCP < 2s)
## rules
- never mass edit more than 3 files without showing me the plan first
- always run existing tests before writing new ones
- if a task takes more than 5 steps, create a plan document first차이가 낮과 밤. 매 세션 첫 5분을 프로젝트 설명하는 대신, Claude가 이미 스택, 컨벤션, 아키텍처 결정, 현재 작업 중인 것을 알고 있음.
하지만 이건 시작일 뿐. CLAUDE.md는 정적임. 학습하지 않음. 기억하지 않음. 그걸 위해 다음 레이어가 필요함.
/part 2 - 지속적 메모리: 잊지 않는 설정
기본적으로 Claude Code는 세션 간 메모리가 0입니다. 매 대화가 처음부터 시작됨. 같은 컨텍스트 설명하고, 같은 수정하고, 같은 해결책 다시 발견.
세 가지 도구를 함께 사용해 해결:
📚 Obsidian을 지식 베이스로
개발 작업용으로 Obsidian 볼트를 설정했습니다. 노트가 아닙니다. Claude Code가 읽고 쓰는 구조화된 위키입니다.
구조:
/vault
/decisions — 컨텍스트가 포함된 모든 아키텍처 결정
/errors — 우리가 겪은 버그와 해결법
/patterns — 우리 코드베이스에서 작동하는 코드 패턴
/sessions — 매일 무슨 일이 일어났는지 요약
/stack — 우리가 사용하는 모든 도구의 문서
Memory.md — 내가 누구인지, 무엇을 빌드 중인지, 선호도
index.md — 볼트 내 모든 것의 마스터 인덱스아이디어는 Andrej Karpathy의 LLM Wiki 컨셉에서 왔습니다 — 매 세션마다 지식을 처음부터 다시 발견하는 대신, 시간이 지남에 따라 복리되는 영구 위키를 읽음.
🧠 claude-mem으로 세션 지속성
claude-mem은 압축을 통해 장기 기억을 추가합니다. 매 세션 종료 시, 주요 결정과 컨텍스트를 다음 세션으로 넘어가는 영구 저장소로 압축합니다.
🌑 subconscious 에이전트
이것은 야생적입니다. claude-subconscious는 백그라운드에서 실행되며, 세션을 지켜보고, 파일을 읽고, 아무것도 하지 않아도 시간이 지남에 따라 메모리를 구축합니다.
마치 주니어 개발자가 뒤에서 모든 것을 메모하는 것과 같습니다.
결과: 월요일 아침에 Claude Code를 열면, 금요일에 결제 웹훅에서 레이스 컨디션을 디버깅했고, 폴링에서 웹소켓으로 전환하기로 결정했으며, 테스트를 업데이트해야 한다는 것을 이미 알고 있습니다.
설명 불필요. 그냥 앎.
/part 3 - 스킬: 제너럴리스트를 스페셜리스트로
기본적으로 Claude Code는 제너럴리스트입니다. 모든 것을 할 수 있지만, 아무것도 특별히 잘하지 못합니다.
스킬이 바꿉니다. 특정 작업을 당신이 원하는 방식으로 수행하는 방법을 Claude에게 가르치는 마크다운 파일입니다.
⚡ 가장 먼저 설치해야 할 것: superpowers
170k+ GitHub 스타. Anthropic 플러그인 마켓플레이스에 공식 등록됨. Claude Code를 “코드 작성”에서 완전한 개발 방법론으로 변환합니다.
/plugin install superpowers@claude-plugins-official실제 작동: Claude가 코드 작성을 바로 시작하는 대신, superpowers가 워크플로우를 강제합니다 — 브레인스토밍 → 스펙 → 계획 → TDD → 구현 → 리뷰. Claude가 정말로 무엇을 빌드하려는지 묻고, 승인받을 스펙을 작성하고, 주니어 개발자가 따를 수 있을 정도로 상세한 계획을 세운 후, 테스트 주도 개발로 실행합니다.
🔒 superpowers 이후 추가한 전문 스킬:
trailofbits security skills - 실제 보안 엔지니어가 빌드한 보안 감사 워크플로우
모든 PR이 내가 보기 전에 취약점 스캔.
Anthropic 공식 스킬 - PDF, DOCX, XLSX 생성, 데이터 분석
모든 것이 빌드하는 표준 레퍼런스.
tdd-guard - 테스트를 건너뛴 커밋을 자동 차단
Claude가 테스트되지 않은 코드를 배포할 수 없게 만듭니다. 차단 이유와 필요한 테스트를 설명합니다.
원하는 만큼 스킬을 쌓을 수 있습니다. 충돌하지 않습니다. 각각 Claude를 하나의 특정 작업에 더 능숙하게 만들고, 함께 모이면 당신의 정확한 워크플로우를 아는 스페셜리스트를 생성합니다.
/part 4 - 서브에이전트: 하나의 Claude가 다섯 개가 됨
여기가 진지해지는 지점입니다.
단일 Claude Code 세션은 한 번에 하나의 일만 할 수 있습니다. 기능을 작성하라고 하면, 코드 리뷰하고, 버그 수정하고, 문서 작성 — 각각 순차적으로 수행하고, 4번째 작업에 도달할 때쯤 컨텍스트가 오염됨.
서브에이전트가 작업을 분할합니다. 오버로드된 Claude 하나 대신, 각각 고유한 컨텍스트와 단일 책임을 가진 스페셜리스트 팀을 갖게 됨.
내 설정의 5개 에이전트:
- architect (아키텍트) — 높은 수준 설계 결정, 스펙 작성, 구현 계획. 코드에 직접 손대지 않음.
- coder (코더) — 아키텍트의 계획에 따라 실제 코드 작성. 모든 도구 접근 권한 보유.
- reviewer (리뷰어) — 보안 우선 마인드로 모든 PR을 읽음. 이슈 플래그, 개선 제안, 테스트 커버리지 체크.
- tester (테스터) — 테스트 작성 및 실행. TDD 강제. tdd-guard와 긴밀히 작동해 커버리지 없이는 배포되지 않도록.
- ops (옵스) — 배포, CI/CD, 인프라 처리. 빌드 모니터링, 실패 수정.
각 에이전트는 고유한 CLAUDE.md를 가집니다 — 특정 지시사항, 도구 권한, 컨텍스트 경계. 코더는 배포 설정을 보지 못함. 리뷰어는 코드를 작성하지 않음. 깨끗한 분리.
준비된 에이전트 컬렉션:
https://github.com/wshobson/agents — 25k+ 스타, 전략/개발/보안/디자인 전반의 프로덕션 서브에이전트
https://github.com/davepoon/claude-code-subagents-collection — 100+ 에이전트, 모든 워크플로우에 드롭인 가능
/part 5 - 훅과 슬래시 명령: 반복 작업 자동화
같은 지시사항을 세 번째 치고 있다면, 그건 슬래시 명령이 되기를 기다리는 중입니다.
매일 사용하는 설정:
/fix-issue 456 - GitHub 이슈 읽기, 브랜치 생성, 테스트와 함께 수정사항 작성, PR 오픈
10분 워크플로우 → 한 번의 명령.
/review - 보안 체크, 테스트 커버리지 분석, 코드 품질 스코어링과 함께 현재 PR에서 리뷰어 에이전트 트리거
/deploy staging - 옵스 에이전트를 통한 전체 배포 파이프라인 실행
더 고급진 오케스트레이션:
https://github.com/wshobson/commands — 1.7k+ 스타, 15개 워크플로우 + 42개 도구
훅은 더 나아갑니다. 특정 순간에 자동으로 트리거됨:
- pre-commit hook — tdd-guard가 커밋 전 테스트 존재 및 통과 확인
- session start hook — Obsidian에서 메모리 로드, 최근 세션 로그 읽기, 컨텍스트 프라이밍
- pre-push hook — 코드가 리모트에 닿기 전 보안 리뷰 자동 실행
규칙을 스스로 강제하기 때문에 규칙을 상기시킬 필요가 없어짐.
/part 6 - 오케스트레이션: 자는 동안 에이전트 작업
마지막 조각. $20/월 구독을 데브 팀이 있는 것처럼 느껴지게 만드는 것.
claude-squad: 병렬로 여러 AI 에이전트 실행
claude-squad는 병렬로 여러 AI 에이전트를 실행하도록 특별히 빌드된 터미널 멀티플렉서입니다. 각 에이전트는 git worktree를 통해 고유한 격리된 작업공간을 가지므로, 별도 브랜치에서 충돌 없이 작업합니다.
brew install claude-squad
cs그게 전부입니다. TUI가 표시되어 에이전트를 시작, 모니터링, 일시정지, 재개할 수 있습니다. 터미널을 닫아도 계속 작업합니다. 아침에 일어나면 완료된 풀 리퀘스트가 기다리고 있음.
나의 밤새 워크플로우:
잠자리에 들기 전 Claude-squad를 열고 3개 세션 스폰:
- agent 1: “repo에서 ‘bug’ 라벨이 붙은 모든 오픈 이슈 수정”
- agent 2: “/apps/api/src/services/에 누락된 테스트 작성”
- agent 3: “새 디자인 토큰을 사용해 대시보드 컴포넌트 리팩터링”
신뢰할 수 있는 작업에는 auto-accept mode 활성화 (cs -y), 위험한 것은 plan mode로 전환.
노트북을 닫고 잠듭.
아침: 리뷰 대기 중인 3개 PR. 각각 별도 브랜치, 충돌 없음, 테스트 통과.
더 고급 오케스트레이션:
2026-05-02-ruflo — Claude Flow의 후속으로 보이는 ruvnet/ruflo, Claude Code용 멀티 에이전트 오케스트레이션
/part 7 - 전체 스택과 비용
모든 것이 함께 실행되는 방식:
layer 1: CLAUDE.md — 무료 (그냥 파일)
layer 2: obsidian + claude-mem — 무료 (obsidian 무료, 레포 오픈소스)
layer 3: superpowers + skills — 무료 (모두 오픈소스, MIT 라이선스)
layer 4: subagents — 무료 (마크다운 파일)
layer 5: hooks + commands — 무료 (모두 오픈소스)
layer 6: claude-squad — 무료 (오픈소스)
총 인프라 비용: $0
Claude Code 구독: $20/월 (Pro 플랜)이 목록의 모든 것이 오픈소스입니다. 지불하는 유일한 것은 Claude 구독 그 자체입니다.
ROI는 비교할 수 없을 정도:
전환 전후 2주간 생산성을 추적:
하루 47분 낭비? 사라짐. 더 중요한 것은, 에이전트들이 이제 내가 오후 3시에 하던 일을 오전 3시에 하고 있다는 점입니다.
/bonus - 시작할 곳
오늘 이 6개 레이어를 모두 빌드할 필요는 없습니다.
이 세 가지부터 시작하세요. 한 오후면 충분합니다:
한 오후 설정:
- CLAUDE.md 작성 (30분)
- Obsidian 볼트 + claude-mem 설정 (1시간)
- superpowers 설치 + 기본 스킬 2-3개 (30분)
이 설정은 나오는데 3개월 걸렸습니다.
당신은 한 오후에 빌드할 수 있습니다.
결론
지금 당신의 Claude Code 설정은 어떤가요?
나를 팔로우하세요 @regent0x_ — 연구 및 리서치용, 항상 신선한 알파 텍스트 읽기. 북마크 잊지 마세요!