Claude Code 실전 학습 가이드 — 설치부터 Supabase 백엔드리스 프로젝트 적용까지
Claude Code를 처음 접하는 개발자를 위한 실전 학습 레포입니다.
단순한 튜토리얼이 아니라, 실제 프로젝트(타이핑룸)를 만들면서 배운 것들을 함께 정리합니다.
🟢 입문 | 🟡 중급 | 🔴 고급
| 날짜 | 내용 |
|---|---|
| 2026.04.02 | 추천 스킬 카탈로그 추가 — 12개 카테고리 |
- 🟢 설치 방법
- 🟢 기본 명령어 & 단축키
- 🟢 CLAUDE.md 작성법
- 🟢 트러블슈팅 — 설치/로그인/실행 오류 해결
- 🟢 보이스모드 사용법 — 보이스 모드 사용법, 관련 트러블슈팅
- 🟡 CLAUDE.md 계층 구조 — 폴더별 분리, Lazy Loading
- 🟡 /memory 자동 메모리 — Claude가 학습한 내용 자동 저장·로드
- 🟢 TODO.md 활용 — 작업 연속성 유지 & 병렬 처리
- 🟡 스크립트 오프로드 — 무거운 처리는 스크립트로, 결과 요약만 Claude에게
- 🟢 메커니즘 비교 가이드 — rules vs hooks vs skills 한눈에 보기
- 🟡 rules — 경로별 규칙, 폴더마다 다른 행동 지침
- 🔴 Hooks — 이벤트 기반 자동화 엔진, 디버깅 가이드 포함
- 🟡 MCP 연동 & 토큰 관리 — MCP 비활성화, 커스텀 래핑
- 🟡 Skills — 재사용 가능한 AI 업무 매뉴얼, 2단계 로딩
- 🟢 스킬 찾기 & 설치 — Skills.sh·Skills.mcp 등 외부 플랫폼, 주의사항
- 🟢 커스텀 슬래시 명령어 —
.claude/commands/로 파이프라인 모듈화
- 🟢 추천 스킬 카탈로그 — 12개 카테고리별 스킬 모음
- 🟡 WAT 프레임워크 개요 — Workflows · Agents · Tools
- 🟡 Subagents — 역할 분리, 병렬 처리, 비용 최적화
- 🟢 잘 되는 것 / 안 되는 것
- 🟡 효과적인 지시 패턴 —
think hard활용법 - 🟡 비용 최적화 & 토큰 관리 — 어디서 토큰이 새는지 파악하기
- 🟡 다른 AI와 협업 —
/export로 ChatGPT·Gemini에게 피드백 받기
- 🟡 프론트엔드 훅 생성 —
@supabase/ssr미사용 수동 훅 패턴 - 🟡 Edge Function 생성 패턴 — Deno 환경 제약 조건 명시
- 🔴 RLS 정책 작성 패턴 — 보안 정책 자동화
- 🟢 CLAUDE.md 템플릿 — Next.js/Node.js/컴포넌트 라이브러리별
- 🟢 TODO.md 템플릿 — 세션 간 연속성 유지용
- 🟡 Subagent 템플릿 — 코드 리뷰/테스트/DB/문서화 에이전트
| 영역 | 도구 |
|---|---|
| AI 에이전트 | Claude Code |
| 백엔드 | Supabase (DB + Edge Functions) |
| 문장 생성 | OpenAI API |
- Claude Code를 처음 써보는 개발자
- Supabase 백엔드리스 프로젝트에 AI 에이전트를 붙여보고 싶은 분
- 직접 써보면서 배우고 싶은 분
처음 시작하는 경우 (🟢 입문): 설치 → 기본 명령어 → CLAUDE.md 작성법 → TODO.md 활용 → 잘 되는 것/안 되는 것
기본을 익혔다면 (🟡 중급): CLAUDE.md 계층 구조 → 스크립트 오프로드 → 메커니즘 비교 가이드 → rules → Skills → WAT 프레임워크 → Subagents
더 깊이 파고들기 (🔴 고급): Hooks → MCP → 비용 최적화 → RLS 패턴 → 다른 AI와 협업
- Claude Code 공식 문서
- sv.developer — Claude Code 학습 영상 참고
배우면서 발견한 내용을 자유롭게 추가해주세요. PR 환영합니다!