TECH TALK / 2026.03

Claude Code
마스터하기

세션 관리부터 MCP 고도화까지,
Claude Code를 200% 활용하는 실전 가이드

Context Engineering Skills & Plugins Best Practices

오늘 다룰 내용

01

Core Concepts

세션, 컨텍스트 윈도우, 토큰의 핵심 개념

02

Context Engineering

CLAUDE.md, 프롬프팅, Plan Mode로 효과적인 컨텍스트 관리

03

Skills, Plugins & MCP

확장 시스템으로 Claude Code 고도화하기

04

Good vs Bad Cases

잘 쓰는 사례와 못 쓰는 사례 비교

05

비용 관리 & 실전 팁

토큰 절약 전략과 생산성 극대화 팁

PART 01 — Core Concepts

Claude Code란?

Anthropic이 만든 Agentic Coding Tool. 터미널에서 코드를 읽고, 편집하고, 실행합니다.

⌨

Built-in Tools

9가지 핵심 도구

Bash, Read, Edit, Write, Glob, Grep, WebFetch, WebSearch, Agent (서브에이전트)

🚀

Multi-Platform

어디서나 사용

Terminal, VS Code, JetBrains, Desktop App, Web, Mobile에서 동일한 경험

🧠

Agentic Workflow

자율적 코딩

파일 탐색 → 코드 분석 → 수정 → 테스트까지 자동 수행

🔒

Permission System

안전한 실행

도구별 허용/거부 규칙으로 위험한 작업을 사전 차단

PART 01 — Core Concepts

세션과 토큰 이해하기

Claude Code의 핵심 작동 원리

Session (세션)

• 대화 기록 전체를 담는 컨테이너
• 프롬프트 + 도구 호출 + 결과 + 응답 포함
• ~/.claude/projects/ 에 자동 저장
• --continue 로 이전 세션 이어가기
• /rename 으로 세션에 이름 부여

Context Window (컨텍스트 윈도우)

• Claude가 한 번에 볼 수 있는 200K 토큰
• 시스템 프롬프트 + CLAUDE.md + 대화 기록
• 가득 차면 Auto-Compaction 발동
• 오래된 기록을 요약하여 공간 확보
• 무한히 작업 가능하지만 요약 시 정보 손실 가능

200K

Context Window

Input Token = 보내는 것 (프롬프트, 파일 내용, 도구 결과) | Output Token = 받는 것 (응답, 도구 호출, 사고 과정)
→ /cost 명령으로 현재 세션의 토큰 사용량 확인

PART 01 — Core Concepts

컨텍스트 윈도우 생애주기

세션이 진행되면서 컨텍스트 윈도우는 이렇게 변합니다

1

세션 시작

CLAUDE.md 로드

→

2

작업 진행

토큰 누적

→

3

한계 도달

~200K 접근

→

4

Auto-Compact

이전 기록 요약

→

5

작업 계속

공간 확보됨

/clear

작업 전환 시 대화 초기화.
불필요한 토큰 낭비 방지

/compact

수동으로 컨텍스트 압축.
핵심 정보만 남기고 정리

/cost

현재 세션 토큰 사용량과
비용을 실시간 확인

Claude Code를
잘 쓰는 핵심은?

Context Engineering

올바른 컨텍스트를 올바른 시점에 제공하는 것이 핵심입니다

PART 02 — Context Engineering

CLAUDE.md — 프로젝트의 두뇌

모든 세션 시작 시 자동 로드되는 프로젝트 컨텍스트 파일

# CLAUDE.md
 
## 프로젝트 구조
Python 3.12+ / FastAPI / PostgreSQL
 
## 공통 명령어
npm run test  # 테스트 실행
npm run lint  # 린트 체크
 
## 코딩 규칙
- ES Modules 사용 (CommonJS X)
- 함수형 컴포넌트만 사용
- 테스트 파일 필수

담을 것

✓ 빌드/테스트 명령어
✓ 코딩 컨벤션
✓ 아키텍처 개요
✓ 파일 구조 설명

담지 말 것

✗ 특정 작업용 상세 지시
✗ 자주 바뀌는 임시 정보
✗ 너무 긴 문서 (토큰 낭비)
→ Skills로 분리!

Progressive Disclosure:
"모든 정보를 넣지 말고,
정보를 찾는 방법을 알려주세요"

PART 02 — Context Engineering

CLAUDE.md 계층 구조

여러 위치에 CLAUDE.md를 두어 스코프별 컨텍스트를 제공할 수 있습니다

~/.claude/CLAUDE.md ← 전역 (모든 프로젝트)

└─ 개인 설정, 선호 스타일

project/CLAUDE.md ← 프로젝트 공통

└─ 빌드 명령, 아키텍처, 팀 규칙

project/.claude/CLAUDE.md

└─ 프로젝트 내부 설정

project/src/CLAUDE.md ← 하위 디렉토리

└─ 해당 폴더 진입 시 on-demand 로드

로딩 규칙

• 상위 디렉토리: 세션 시작 시 전체 로드
• 하위 디렉토리: 파일 접근 시 on-demand 로드
• 구체적 위치가 우선순위 높음

우선순위

Enterprise > User (개인) > Project (공유)
→ 같은 규칙이 충돌하면 상위가 이김

팀 활용 팁

프로젝트 CLAUDE.md는 git에 커밋하여
팀 전체가 동일한 컨텍스트를 공유!

PART 02 — Context Engineering

효과적인 프롬프팅

좋은 프롬프트의 5가지 요소: 목표, 컨텍스트, 제약, 검증, 다음 액션

BAD

# 모호한 프롬프트
 
버그 고쳐줘

✗ 어떤 버그인지 모름
✗ 파일 위치 불명
✗ Claude가 전체 코드베이스를 스캔
✗ 토큰 대량 낭비

GOOD

# 구체적인 프롬프트
 
src/components/LoginForm.tsx에서
빈 이메일 제출 시 null reference 에러 발생.
 
유효성 검증 로직을 수정해서
인라인 에러 메시지를 표시해줘.
 
API 계약 변경 금지. 새 의존성 추가 금지.
npm test -- --grep login 으로 검증.

Pro Tip: 프롬프트에 파일 경로를 탭 자동완성으로 입력하면 Claude가 정확한 파일을 바로 찾습니다. URL을 직접 붙여넣으면 Claude가 읽고 참고합니다.

PART 02 — Context Engineering

Plan Mode — 먼저 생각하고 실행하기

Shift+Tab 두 번으로 Plan Mode 진입. 코드 수정 없이 분석만 수행합니다.

1

Plan Mode 진입

Shift+Tab x2

→

2

분석 & 계획

코드 읽기 전용

→

3

계획 검토

사용자 확인

→

4

실행

Plan Mode 해제

왜 써야 할까?

• 잘못된 방향으로 코드 수정 방지
• 아키텍처 결정을 미리 검토
• 재작업 토큰 절약 (가장 큰 이점!)

언제 써야 할까?

• 멀티 파일 리팩토링
• 새로운 기능 설계
• 복잡한 버그 디버깅
• 확신이 없을 때는 항상!

기본기를 넘어서
고도화하기

Skills, Plugins & MCP

Claude Code의 능력을 확장하는 세 가지 메커니즘

PART 03 — 확장 시스템

Skills — 재사용 가능한 지시서

CLAUDE.md에 넣기 부담스러운 상세 지시를 슬래시 명령으로 분리

# .claude/skills/review/SKILL.md
---
name: review
description: "코드 리뷰 + 보안 체크"
---
 
# Code Review Skill
 
1. OWASP Top 10 체크
2. 타입 안전성 검증
3. 테스트 커버리지 확인
4. 성능 이슈 리뷰

→ /review 로 호출

Skills 위치

~/.claude/skills/ 개인용
.claude/skills/ 프로젝트용 (팀 공유)
packages/*/skills/ 모노레포용

CLAUDE.md vs Skills

CLAUDE.md: 매 세션마다 항상 로드
Skills: 호출할 때만 로드 (on-demand)
→ 토큰 절약의 핵심!

주요 내장 명령어

/clear /compact /cost /model
/effort /init /batch /voice

PART 03 — 확장 시스템

MCP — AI를 위한 USB 포트

Model Context Protocol: 외부 도구와 데이터를 Claude에 연결하는 표준 인터페이스

// .mcp.json (프로젝트 루트)
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@mcp/server-fs"],
      "env": {
        "API_KEY": "..."
      }
    }
  }
}

claude mcp add <name> -- <cmd> 으로 추가 가능

Transport 방식

stdio: 로컬 프로세스 (가장 일반적)
SSE: Server-Sent Events
HTTP: URL 기반 원격 서버

스코프

Project: .mcp.json (팀 공유)
User: 개인 설정
Local: 머신별 오버라이드

핵심 특징

Tool Search: MCP 도구는 지연 로딩
→ 필요할 때만 컨텍스트에 로드
→ 컨텍스트 윈도우 절약!

PART 03 — 확장 시스템

Hooks — 이벤트 기반 자동화

Claude Code의 생애주기 이벤트에 커스텀 스크립트를 연결

이벤트	시점
PreToolUse	도구 실행 전 (허용/거부 결정)
PostToolUse	도구 실행 후 (후처리)
SessionStart	세션 시작 시
SessionEnd	세션 종료 시
UserPromptSubmit	사용자 입력 시
Stop	Claude 응답 완료 시
Notification	알림 발생 시

활용 예시

• 코드 저장 시 자동 포맷팅 (Prettier)
• 위험한 명령 차단 (rm -rf 등)
• 세션 종료 시 Slack 알림
• 코드 변경 후 자동 테스트 실행

PreToolUse 특수 능력

allow deny escalate
도구 입력을 수정하거나
추가 컨텍스트를 주입 가능

실전에서는
어떻게 다를까?

Good vs Bad Cases

같은 도구, 다른 결과 — 사용법이 차이를 만듭니다

PART 04 — Good vs Bad Cases

못 쓰는 패턴 Top 6

이런 습관이 토큰을 낭비하고 결과 품질을 떨어뜨립니다

1. 모호한 프롬프트

"리팩토링 해줘" → Claude가 전체 코드를 스캔하며 토큰 대량 소비

2. /clear 안 하기

작업 전환 시 이전 컨텍스트가 매 메시지마다 토큰 차지

3. Plan Mode 무시

복잡한 작업을 바로 실행 → 잘못된 방향 → 되돌리기 → 2배 비용

4. CLAUDE.md 과부하

너무 긴 CLAUDE.md = 매 세션마다 불필요한 토큰 소비

5. 출력 검증 안 하기

AI 응답을 무비판적 수용 → 버그/보안 이슈 놓침

6. Permission 설정 안 하기

매번 허가 프롬프트 클릭 → 작업 흐름 중단, 생산성 하락

PART 04 — Good vs Bad Cases

잘 쓰는 패턴 Top 6

이렇게 하면 같은 비용으로 3-5배 더 많은 결과를 얻습니다

1. 구체적 프롬프트

파일 경로 + 기대 동작 + 제약 + 검증 명령을 한 프롬프트에

2. 작업별 /clear

30-45분 집중 세션 후 /clear. 관련 없는 컨텍스트 제거

3. Plan First, Code Later

Plan Mode로 분석 → 계획 확인 → 그다음 실행. 재작업 방지

4. Skills로 분리

반복 워크플로우를 Skill로 만들면 DRY + on-demand 로딩

5. Git Worktree 병렬 작업

독립적인 작업을 별도 worktree에서 병렬 실행 → 시간 단축

6. MCP로 도구 확장

Context7으로 최신 문서, Serena로 코드 분석. Claude의 한계 극복

PART 04 — Good vs Bad Cases

실전 비교: 리팩토링 요청

같은 요청이지만 결과가 완전히 달라집니다

BAD CASE

데이터베이스 코드 리팩토링 해줘

✗ 어떤 파일? 어떤 패턴?
✗ Claude가 추측하며 전체 탐색
✗ 기존 인터페이스 깨질 위험
✗ 예상 소요: ~$2-5 토큰

GOOD CASE

src/db/queries.ts를 repository 패턴으로
리팩토링해줘.
 
src/db/repositories/user.ts를
스타일 가이드로 참고해.
 
public 메서드 시그니처 유지 필수.
npm test 로 검증.

✓ 정확한 파일 & 패턴 지정
✓ 참조 예시 제공
✓ 제약 조건 명시
✓ 예상 소요: ~$0.3-0.5 토큰

비용을 줄이고
생산성을 높이기

실전 팁 & 비용 관리

PART 05 — 비용 & 팁

비용 관리 전략

평균 ~$6/일, 90th percentile ~$12/일. 최적화하면 절반 이하로 줄일 수 있습니다.

⚡

Prompt Caching

자동 적용, 최대 90% 절약

시스템 프롬프트, CLAUDE.md 등 반복 콘텐츠를 캐시. 캐시 히트 시 입력 가격의 10%만 청구.

📈

/effort 조절

작업 복잡도에 맞게

간단한 작업은 /effort low. 복잡한 분석은 /effort high. Thinking 토큰 비용 절감.

🕐

세션 위생

30-45분 집중 세션

하나의 작업에 집중 → /clear → 다음 작업. 마라톤 세션 지양.

💰

모니터링

실시간 추적

/cost 로 세션 비용, /stats 로 사용 패턴 확인. 상태줄에 토큰 카운트 표시 가능.

PART 05 — 비용 & 팁

생산성 극대화 치트시트

바로 적용할 수 있는 실전 팁

일상 워크플로우

Tab 자동완성

파일 경로를 탭으로 입력하여 정확한 컨텍스트 제공

URL 직접 붙여넣기

문서 URL을 채팅에 붙이면 Claude가 직접 읽고 참조

/rename으로 세션 이름 지정

나중에 --continue로 쉽게 찾아 이어가기

Few-shot 예시 제공

원하는 스타일의 코드 예시를 주면 일관성 ~65% 향상

고급 워크플로우

/batch 대량 변환

수백 파일 동시 변환. 워크트리 격리, 10x 속도 향상

Git Worktree 병렬 개발

각 Claude가 독립 브랜치에서 작업. 서로 간섭 없음

Headless Mode (CI/CD)

claude -p "..." 로 자동 PR 리뷰, 코드 생성, 마이그레이션

Cross-Platform 세션

/teleport로 웹/모바일 세션을 터미널로, /desktop으로 앱으로

핵심 정리

1

Context Engineering이 핵심 — CLAUDE.md로 프로젝트 컨텍스트를 관리하고, /clear와 /compact로 토큰을 절약하세요.

2

Skills + MCP로 고도화 — 반복 작업은 Skills로, 외부 도구는 MCP로 연결. Context7, Serena 추천!

3

구체적으로, 계획적으로 — 모호한 프롬프트 대신 파일+목표+제약+검증을 담고, Plan Mode를 활용하세요.

4

비용 관리는 습관 — /cost로 모니터링, /effort로 조절, 30-45분 집중 세션 유지.

Q & A

궁금한 점이 있으시면 질문해주세요!

Claude Code 마스터하기

오늘 다룰 내용

Claude Code란?

세션과 토큰 이해하기

컨텍스트 윈도우 생애주기

Claude Code를잘 쓰는 핵심은?

Context Engineering

CLAUDE.md — 프로젝트의 두뇌

CLAUDE.md 계층 구조

효과적인 프롬프팅

Plan Mode — 먼저 생각하고 실행하기

기본기를 넘어서고도화하기

Skills, Plugins & MCP

Skills — 재사용 가능한 지시서

MCP — AI를 위한 USB 포트

추천 MCP 서버 & 플러그인

Hooks — 이벤트 기반 자동화

실전에서는어떻게 다를까?

Good vs Bad Cases

못 쓰는 패턴 Top 6

잘 쓰는 패턴 Top 6

실전 비교: 리팩토링 요청

비용을 줄이고생산성을 높이기

실전 팁 & 비용 관리

비용 관리 전략

생산성 극대화 치트시트

일상 워크플로우

고급 워크플로우

핵심 정리

Q & A

Claude Code
마스터하기

Claude Code를
잘 쓰는 핵심은?

기본기를 넘어서
고도화하기

실전에서는
어떻게 다를까?

비용을 줄이고
생산성을 높이기