※ Claude Code 초보자로, 유투브 내용을 참조하여 이해하려고 하고 있습니다.
원본의 게시 영상 및 Link 를 참조하시어 필요한 내용을 학습하시면 됩니다.
유투브에서 "세비아 AI" 님 게시 영상입니다.
1단계 : 기본기
① CLAUDE.md
한 줄 정의
프로젝트 전용 시스템 프롬프트 문서
역할
Claude가 프로젝트를 열 때 가장 먼저 읽는 문서다.
예를 들면:
# 프로젝트 규칙
- TypeScript만 사용
- any 금지
- 테스트 코드 반드시 작성
- React Query 사용
이후 Claude는 위 규칙을 기억한 채 작업한다.
왜 중요한가?
매번
"우리 프로젝트는 TypeScript 사용해"
"테스트 코드도 만들어줘"
라고 설명할 필요가 없다.
Claude Code에서는 CLAUDE.md가 세션 시작 시 로딩되고 이후 계속 참조된다.
비유
회사 신입사원에게 주는 업무 매뉴얼
② /init
한 줄 정의
현재 프로젝트용 CLAUDE.md 자동 생성 명령
역할
프로젝트 구조를 분석한 후
/init
실행 시 Claude가
- React 사용
- Next.js 사용
- Tailwind 사용
- 테스트는 Vitest
같은 내용을 자동 작성한다.
언제 사용?
새 프로젝트 시작 시
비유
회사 소개서를 자동 작성하는 기능
③ /context
한 줄 정의
현재 컨텍스트 상태 확인
역할
Claude가 지금 무엇을 기억하고 있는지 확인
예)
- 현재 로드된 파일
- 사용 가능한 도구
- MCP 상태
- 컨텍스트 사용량
등을 확인할 수 있다.
언제 사용?
Claude가 이상한 답변을 하기 시작할 때
비유
지금 머릿속에 뭐가 들어있는지 보는 기능
2단계 : 확장
④ Checkpoints
한 줄 정의
자동 저장 지점
역할
Claude Code는 작업 중 체크포인트를 생성한다.
실수로 이상하게 수정했을 경우
/rewind
등을 이용해 이전 상태로 돌아갈 수 있다.
장점
- AI가 코드 망쳐도 복구 가능
- 실험적인 수정 가능
비유
게임 저장 슬롯
⑤ Skills
한 줄 정의
재사용 가능한 프롬프트 패키지
역할
반복 작업을 명령어처럼 등록
예)
/deploy
실행 시
- 빌드
- 테스트
- 배포 체크
를 자동 수행
Skills는
.claude/skills/
폴더에 저장한다.
예시
/ship
/review
/api-doc
비유
회사 업무 매뉴얼 + 매크로
3단계 : 고급
⑥ MCP
한 줄 정의
Claude와 외부 도구를 연결하는 표준 프로토콜
(Model Context Protocol)
역할
Claude가 외부 시스템을 직접 사용할 수 있게 함
예)
- GitHub
- Slack
- Jira
- Notion
- PostgreSQL
- 사내 시스템
등
Claude는 MCP를 통해
GitHub 이슈 조회
DB 조회
Slack 메시지 확인
까지 수행 가능하다.
비유
AI용 USB 포트
⑦ Hooks
한 줄 정의
특정 이벤트 발생 시 자동 실행되는 스크립트
역할
Claude 행동 전후에 자동 처리
예)
파일 수정 전
PreToolUse
실행
파일 수정 후
PostToolUse
실행
활용 예:
- 자동 lint
- 자동 테스트
- Slack 알림
- 금지 파일 수정 차단
Hooks는 Claude 컨텍스트를 거의 사용하지 않고 외부에서 동작한다.
비유
자동 경비 시스템
⑧ Subagents
한 줄 정의
Claude가 생성하는 하위 전문가 AI
역할
큰 작업을 여러 AI에게 분산
예)
메인 에이전트:
프로젝트 분석해줘
↓
Subagent 1
백엔드 분석
Subagent 2
프론트 분석
Subagent 3
테스트 분석
↓
결과 취합
Subagent는 독립된 컨텍스트를 사용하므로 메인 대화가 비대해지지 않는다.
언제 사용?
- 대규모 프로젝트 분석
- 병렬 작업
- 코드 리뷰 분리
비유
팀장 아래 여러 명의 전문 팀원