통합 요약노트
Ch.5 Claude Code 핵심 기능
CLAUDE.md, 도구 시스템, 서브에이전트, MCP를 상황에 맞게 활용합니다.
이 챕터의 내용
CLAUDE.md — AI에게 주는 프로젝트 설명서
CLAUDE.md가 해답입니다. 한 번 작성하면 AI가 매 대화 시작 시 자동으로 읽어, 일관된 품질을 보장합니다.
CLAUDE.md = 프로젝트의 '사용설명서' AI가 대화를 시작할 때마다 자동으로 읽는 파일
비유하면 신입사원에게 주는 온보딩 문서입니다. 프로젝트 구조, 코딩 규칙, 주의사항이 적혀 있으면 매번 설명할 필요가 없습니다. AI도 마찬가지입니다.
CLAUDE.md가 있으면 모든 대화에서 일관된 품질
- CLAUDE.md = AI가 매 대화 시작 시 자동으로 읽는 프로젝트 설명서
- 핵심 4가지: 프로젝트 구조, 기술 스택, 코딩 컨벤션, 금지 사항
- 루트 CLAUDE.md(전체 규칙) + 하위 폴더 CLAUDE.md(영역 규칙) 조합
도구 시스템 — 파일 읽기·쓰기·검색·실행
Claude Code의 도구 시스템이 답입니다. AI가 직접 파일을 읽고, 수정하고, 실행하되, 매 단계를 사용자에게 보여줍니다.
Claude Code의 핵심 차별점: AI가 직접 도구를 사용합니다
다른 AI가 '이렇게 해보세요'라고 제안만 한다면, Claude Code는 직접 실행합니다. 비유하면 전화 상담(말로만 안내) vs 출장 기사(직접 와서 고침)의 차이입니다.
에이전틱 = AI가 스스로 도구를 선택하고 실행하는 방식
- 에이전틱 = AI가 스스로 도구를 선택하고 실행하는 방식
- 핵심 5도구: Read(읽기) · Edit(수정) · Write(생성) · Bash(실행) · Grep/Glob(검색)
- 도구 실행 전 항상 사용자에게 알림 → Default 모드에서 매번 승인
권한 관리 — 안전하게 도구를 허용하는 법
3가지 권한 모드를 상황에 맞게 전환하면 안전하면서도 효율적으로 작업할 수 있습니다.
Claude Code는 강력한 도구를 가지고 있습니다 파일 삭제, 명령어 실행 등. 그래서 '권한'이 중요합니다
비유하면 집 열쇠를 맡기는 것입니다. 믿을 수 있는 사람에게만, 필요한 범위만 맡기듯이 AI에게도 적절한 범위의 권한만 부여해야 합니다.
권한 = AI가 어떤 도구를 자동으로 쓸 수 있는지 설정
- 권한 = AI가 자동으로 사용할 수 있는 도구의 범위
- 3가지 모드: Default(매번 승인) · Auto(자동 허용) · Plan(계획만)
- 처음엔 Default → 익숙해지면 Auto → 큰 변경 전 Plan
서브에이전트 — 작업을 나눠서 병렬 처리
서브에이전트가 해답입니다. 메인 AI가 작업을 나눠서 각각의 독립된 AI에게 맡기면, 더 빠르고 효율적으로 처리됩니다.
서브에이전트 = AI 분신술 메인 AI가 작업을 나눠서 각각의 AI에게 맡김
비유하면 레스토랑에서 셰프 한 명이 10인분을 혼자 하는 것보다, 셰프 3명이 각자 역할을 맡으면 더 빠르고 정확합니다. 서브에이전트도 마찬가지로 작업을 분담합니다.
각 서브에이전트는 독립된 컨텍스트 → 메인 대화의 컨텍스트를 아낄 수 있음
- 서브에이전트 = 독립 컨텍스트에서 작업하는 AI 분신
- 3종 내장: Explore(탐색, Haiku) · Plan(설계) · General(범용)
- 서브에이전트는 메인 대화를 모름 → 필요한 정보 명시적 전달 필수
MCP — 외부 서비스와 연결하기
MCP가 그 다리 역할을 합니다. 앱스토어에 앱을 설치하듯, Claude Code에 MCP 서버를 추가하면 새로운 능력을 획득합니다.
MCP = Model Context Protocol AI가 외부 서비스의 도구를 사용할 수 있게 해주는 표준
비유하면 스마트폰의 앱스토어입니다. 기본 기능에 앱을 설치하듯, Claude Code에 MCP 서버를 추가하면 데이터베이스 조작, PR 생성, 웹 검색 등 새로운 능력을 얻습니다.
MCP = AI의 앱스토어
- MCP = AI의 앱스토어, 외부 서비스 도구를 추가하는 표준 프로토콜
- 인기 서버: Supabase(DB) · GitHub(PR/이슈) · Fetch(웹) · Filesystem(파일)
- MCP는 연결일 뿐 — CLAUDE.md에 스키마/규칙을 적어야 AI가 정확하게 사용
핵심 용어 모음
프로젝트 구조
주요 폴더와 각 폴더의 역할
기술 스택
사용 중인 프레임워크와 라이브러리
코딩 컨벤션
네이밍 규칙, 파일 구조 규칙
금지 사항
절대 하면 안 되는 것들
Read
파일 내용 읽기 — 코드를 분석하고 이해하는 첫 단계
Edit
파일 특정 부분 수정 — 기존 코드를 정밀하게 변경
Write
새 파일 생성 — 처음부터 새로운 파일을 만듦
Bash
터미널 명령 실행 — npm install, git commit 등
Grep / Glob
코드 검색 — 특정 함수나 패턴을 프로젝트 전체에서 찾기
Default
매번 허락 요청 — 가장 안전, 학습에 추천
Auto Accept
읽기·쓰기 자동 허용 — 신뢰할 때 사용
Plan Mode
계획만 세움, 실행 안 함 — 설계 단계에 유용
퀴즈와 인터랙션으로 더 깊이 학습하세요
play_circle인터랙티브 코스 시작하기