Claude Code 실무 활용
KIST 연구원 핸드아웃 · A4 7쪽 · 2026-04-29

Claude Code 22가지 기능을
손에 익히기

Basic 12개 + Advanced 10개 · 모두 한국어 프롬프트로 · PowerShell 7+ 기준

강사. 황민호 수석
Forward Deployed Engineer
2026-04-29
슬라이드 96장

오늘 가져갈 산출물 세 개

  1. 본인 폴더 CLAUDE.md 한 개 (랩 톤 · 출력 규칙 5줄)
  2. .claude/settings.json의 deny 한 줄
  3. 호출 가능한 /<스킬-이름> 한 개 (SKILL.md 5줄)

덤. Advanced에서 한 번 더 — 본인 파이프라인에 끼울 후보 1~2개 머리에 담기.

오늘의 약속 세 가지

  1. 모든 명령은 PowerShell 7+. 한글 폴더 경로 피하고 ASCII (예. C:\work\demo)
  2. 막히면 손. 한 사람의 막힘은 다섯 사람의 막힘
  3. 22개 다 외우려 하지 않기. 와닿는 1~2개만 가져가기

UTF-8 한 줄. chcp 65001 · 한글 인코딩 깨질 때 첫 약

22기능 한눈에 보기

CLAUDE.md + @import
Auto Memory
Plan Mode
Permission Modes 6종
Skills (/스킬-이름)
Subagents
/agents Library/Running
/compact · /clear
/usage
--continue · --resume
Agent Teams (실험)
.claude/rules/ + paths
헤드리스 (-p + JSON)
Hooks (라이프사이클)
MCP
Plugins
Routines (클라우드 영구)
/ultrareview · /ultraplan
/loop
/schedule
/effort 5단계
UX 보조 5종

앞 12개는 Basic(일상). 회색 배경 10개는 Advanced(자동화).

p.1 / 7Claude Code v2 · KIST
Basic 12 (1/2)
CLAUDE.md · Auto Memory · Plan · 권한 · Skills · Subagents
CLAUDE.md + @import Basic 1
프로젝트 루트의 마크다운 한 파일. 매 세션 자동 로드. 4계층(managed/user/project/local)이 cascade.
PS C:\work\my-project> claude # 현재 폴더에서 시작 > /init # CLAUDE.md 초안 자동 생성 > notepad CLAUDE.md # 메모장으로 5~10줄 다듬기 (@import로 공용 규칙 끌어쓰기)
이 폴더에 CLAUDE.md를 만들어 줘. 답변은 한국어로, 원본 데이터 파일은 절대 건드리지 말고, 본인 랩의 표기 규칙을 따르도록.
한 폴더에 한 개만 두면 매 세션 톤이 통일.
Auto Memory Basic 2
정정한 걸 자동 저장. 내 디스크에 마크다운으로 누적. ChatGPT 메모리와 달리 직접 열어 보고 지울 수 있어요.
> /memory # Auto Memory 토글 + MEMORY.md 폴더 열기 > /memory off # 이번 세션만 자동 누적 멈춤 (민감 정정 직전) PS> $env:CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 # 환경변수로 영구 비활성
앞으로 표는 항상 마크다운 표로 출력해 줘. 우리 랩 표기 규칙이야. 다음부터 그렇게 가 줘.
민감 정정(미공개 약어)은 off로. 내부 ON / 외부 OFF 분리 권장.
Plan Mode Basic 3
읽기만 + 변경 계획만. 승인 후 실행. AI가 멋대로 고치는 우려에 직접 답하는 모드.
PS> claude --permission-mode plan # Plan 모드로 시작 (실행 없이 계획만) > /plan # 세션 안에서 Plan 모드로 전환 키보드. Shift+Tab Shift+Tab # 모드 토글 (default → acceptEdits → plan)
이 보고서 12페이지를 8페이지로 줄여 줘. 어디를 어떻게 줄일지 먼저 계획만 보여 줘. 실행은 아직 하지 마.
Reviewer 2 응답 작성 전 Plan으로 구조부터 받기 — 본문 수정량 절반.
Permission Modes 6종 Basic 4
자율성 다이얼 — plan · default · acceptEdits · auto · dontAsk · bypass. 일상은 default · acceptEdits 둘만.
// .claude/settings.json { "defaultMode":"acceptEdits", // 기본 모드 (변경은 자동, 터미널은 묻기) "permissions":{ "deny":["Bash(Remove-Item *)"], // deny = 항상 거부 (위험 명령) "allow":["Bash(git status)"] // allow = 항상 허용 (안전·반복 명령) } }
내 .claude/settings.json을 만들어 줘. deny에 Bash(Remove-Item *)·Read(~/.ssh/**), ask에 Bash(git push *), allow에 Bash(git status)·Bash(Rscript *)·Read(./data/**). defaultMode는 acceptEdits. JSON으로 통째로.
bypass는 격리 환경(컨테이너·VM·일회용 폴더) 외 절대 금지.
Skills (/스킬-이름) Basic 5
절차를 SKILL.md 한 파일로. 매일 한 줄 호출. description만 평상시 색인 — 토큰 0 / 호출 시만 로드.
PS> mkdir ~/.claude/skills/pdf-요약 # 스킬 폴더 (이름 = 호출 명령어) PS> notepad ~/.claude/skills/pdf-요약/SKILL.md # 절차·도구·경로 정의 > /pdf-요약 ./이 문서.pdf # 슬래시 명령으로 호출 + 인자 전달
내 ~/.claude/skills/ 아래에 본인이 자주 하는 작업 이름으로 스킬을 만들어 줘. PDF 한 편을 받아 (1) 한 문장 요약 (2) 5단락 한국어 요약 (3) 핵심 인용 5개(페이지 포함) (4) 시사점 3개. allowed-tools=Read,Grep · paths=**/*.pdf · shell=powershell. SKILL.md 통째로 보여 줘.
자주 하는 작업을 스킬로 만들면 한 줄 호출로 끝나 매번 입력하던 시간이 줄어듭니다.
Subagents Basic 6
별도 컨텍스트에서 작업하고 요약만 메인에 돌려주는 전문 동료. 역할의 분리(스킬은 절차 재사용).
PS> mkdir .claude\agents # 프로젝트 전용 에이전트 폴더 PS> notepad .claude\agents\deep-reviewer.md # 에이전트 정의 (frontmatter + 본문) > @deep-reviewer 이 폴더의 초고를 검토해 줘 # @이름으로 서브에이전트 직접 호출
.claude/agents/ 아래에 'deep-reviewer'를 정의해 줘. 역할은 까다로운 심사 위원 시각으로 통계 가정·표본·인용·논리를 본다. tools=Read,Grep,Glob · model=opus · isolation=worktree. initialPrompt에 "이 폴더의 .md 초고를 찾아 검토 시작". 통째로.
tools 화이트리스트 + isolation: worktree 두 줄 잊지 말기.
p.2 / 7Basic 1–6
Basic 12 (2/2)
/agents · /compact · /usage · --resume · Teams · rules
/agents Library/Running Basic 7
정의된 에이전트 목록(Library)과 라이브 인스턴스(Running)를 한 화면에서. 동료들의 관제 화면.
> /agents # 에이전트 패널 열기 (Library = 정의 / Running = 진행 중) # Library ↔ Running Tab 키 # 두 탭을 키보드로 전환 # 같은 에이전트 다중 인스턴스 가능 # reviewer 다섯 명을 동시에 띄울 수 있음
code-reviewer 서브에이전트한테 이 폴더의 초고를 검토하라고 시켜 줘. 끝나면 결과만 메인 세션에 요약해 줘.
5명 reviewer를 한 화면에. Esc로 특정 인스턴스만 멈춤.
/compact · /clear Basic 8
컨텍스트 관리. /compact는 같은 일 이어가기(자동 재주입), /clear는 새 일 시작. 자동 임계 + 수동.
> /compact # 지금까지 대화를 요약·압축 (같은 일을 계속 이어갈 때) > /clear # 컨텍스트 완전 초기화 (전혀 다른 일로 넘어갈 때)
지금까지 분석 흐름을 5문장으로 요약하고 컨텍스트를 압축해 줘. 표·코드·이미지 경로는 그대로 남겨 두고.
자동 compact 직전에 핵심 보존 한 줄을 남겨 두기.
/usage Basic 9
토큰·비용·세션 통계. 영수증 역할. 단체 라이선스 환경에서 본인 페이스 잡는 용도.
> /usage # 이번 주 토큰·비용 요약 한 화면 (한도 대비 잔량) > /extra-usage # 세션·시간대별 상세 분석 (어디서 많이 썼는지 추적)
비용 많이 나간 세션 톱3이랑 그 이유를 같이 짚어 줘.
"회의록 8개 합치고 4달러" 같은 구체 감각.
--continue · --resume Basic 10
직전 세션 또는 이름·ID로 임의 세션 부활. --fork-session으로 분기. 회의·실험으로 끊겨도 한 줄로.
PS> claude -n 2026-Q2-paper # 새 세션에 이름 부여 (-n = name) PS> claude --continue # 직전 세션 맥락을 그대로 이어 시작 PS> claude --resume 2026-Q2-paper # 이름·ID로 임의 세션 부활 (며칠 전 것도 OK) PS> claude --fork-session # 같은 출발점에서 새 세션으로 분기 (다른 시도)
오전에 시작한 논문 요약 세션 이어서 가 줘.
오전 실험 → 오후 분석 재개. 끊긴 맥락을 한 줄로 이어 가서 다시 입력하는 부담이 사라집니다.
Agent Teams (실험) Basic 11
한 lead가 N teammates를 띄우고 공유 task list로 협업. 실험 기능 — 환경변수로 켜고 끔.
// settings.json { "env":{ "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS":"1" } } // 실험 기능 플래그 (팀 모드 활성) > /agents → spawn // 활성 후 lead가 자동 분배·spawn
통계·인용·영문 reviewer 세 명이 동시에 검토하도록 팀 짜 줘. lead는 통합 보고만 맡고.
Basic에서는 "있다는 것만". 토큰 소비 큼 — /usage로 모니터링.
.claude/rules/ + paths Basic 12
CLAUDE.md를 토픽별로 쪼개고 글롭 매칭 시점에만 로드. 토큰 0 / 정확도 1 — raw 데이터 만질 때만 떠 줌.
// .claude/rules/data-files.md --- paths: ["data/원본/**"] // 글롭 매칭될 때만 자동 로드 (토큰 0 / 정확도 1) --- - 원본 폴더 파일은 수정 금지 // 룰 본문 = 매칭 시 추가되는 시스템 규칙 - 정제 결과는 _clean 접미사로
이 .claude/rules/data-files.md 좀 짜 줘. 원본 데이터 폴더의 파일은 절대 수정 금지, 새 파일은 _clean 접미사로.
팀원이 실수로 원본을 건드릴 가능성 차단. 데이터 무결성 핵심.
p.3 / 7Basic 7–12
Advanced 10 (1/2)
헤드리스 · Hooks · MCP · Plugins · Routines
헤드리스 (-p + JSON) Adv 1
claude -p 비대화형. stdin 파이프 입력 + JSON 구조화 출력. 셸 한 줄로 AI를 파이프라인에 끼우기.
PS> Get-Content data.csv | claude -p ` # -p = 헤드리스 모드 (대화창 없이 stdin 입력) "표를 KIST 분기보고서 문체로" ` # 변환 지시 (한 줄 프롬프트) --output-format json --max-budget-usd 1.00 ` # JSON 출력 + 비용 상한 (넘으면 자동 중단) | Set-Content out.json # 결과를 새 파일로 저장
내 PowerShell에서 실행할 한 줄 명령을 만들어 줘. 이 CSV를 stdin으로 claude -p에 흘려보내서 "헤더를 본인 표준 컬럼명으로 통일하고 결측은 NA"로 변환, 결과를 data\clean.csv로 저장. --max-budget-usd 1.00 캡도. 한 줄로.
야간 잡 후처리 표준. --max-budget 캡 안전벨트.
Hooks (라이프사이클) Adv 2
30+ 라이프사이클 이벤트(PreToolUse·PostToolUse·Notification·PreCompact 등)에 핸들러를 붙임.
// .claude/settings.json "hooks":{ "PreToolUse":[{ // 도구 실행 직전에 가로채는 훅 "matcher":"Bash(Remove-Item *)", // 매처 = 이 패턴의 명령에만 발동 "command":"powershell -c exit 2" // 실행할 명령 (exit 2 = 차단 + 사용자 확인 강제) }] } # exit 2 = 차단
settings.json에 PowerShell Remove-Item * 명령을 PreToolUse에서 막는 hook 하나 넣어 줘. exit 2로 차단.
치명적 함정 둘. 무한 루프(같은 도구 재호출 금지)·외부 호출(기관 정책 검토).
MCP Adv 3
오픈 표준 외부 시스템 연결. 기관 위키·메신저·드라이브·LIMS·DB. 한 채팅에서 끌어와 요약하고 슬랙에 올리기 한 흐름.
PS> claude mcp add wiki ` # MCP 서버 등록 (이름 = wiki) --transport http --scope project ` # 통신 = http / 적용 범위 = 이 프로젝트만 --env WIKI_TOKEN=$env:WT ` # 서버에 전달할 환경변수 (토큰) -- https://wiki/.../mcp # 실제 MCP 엔드포인트 > /mcp # 현재 세션의 MCP 서버 연결 상태 확인
기관 위키에서 본인이 자주 보는 페이지를 가져와서 5줄로 요약해 줘. 그 요약을 기관 채널에 바로 올려 줘.
망분리 사전 검토 필수. 토큰은 환경변수로만 (settings.json 평문 금지).
Plugins Adv 4
스킬·서브에이전트·훅·MCP·LSP를 한 패키지로. plugin.json + 마켓플레이스. 랩 표준을 학생 5명에게 한 줄로 배포.
PS> claude plugin install kist-mh-lab@private-mp # <플러그인>@<마켓플레이스> 형태로 설치 PS> claude plugin validate # plugin.json·필수 파일 유효성 검사 PS> claude plugin list # 현재 설치된 플러그인과 그 안의 스킬·에이전트
내 ~/.claude/skills/ 랑 ~/.claude/agents/를 묶어서 'kist-mh-lab' 플러그인의 plugin.json을 작성해 줘.
새 학생 첫날 install 한 줄로 동일한 환경. 기관 마켓플레이스는 private repo로.
Routines (클라우드 영구 스케줄) Adv 5 · 베타
Anthropic 클라우드에서 노트북이 꺼져도 도는 영구 작업. cron + API endpoint + GitHub event 3종 트리거 조합. 베타 헤더 experimental-cc-routine-2026-04-01.
> /schedule weekdays 8am, 어제 부처 보도자료 5개 요약하고 기관 위키에 게시 # 자연어 cron + 작업 (클라우드 영구) > /schedule list # 등록된 routine 전체 + 다음 실행 시각 > /schedule update <id> # 기존 routine의 일정·지시문 갱신
# 외부 API 트리거 (스케줄 외에도 호출 가능) curl -X POST https://api.anthropic.com/v1/claude_code/routines/<id>/fire ` # routine을 즉시 실행 -H "Authorization: Bearer sk-ant-oat01-..." ` # 인증 헤더 (API 토큰) -H "anthropic-beta: experimental-cc-routine-2026-04-01" ` # 베타 헤더 (실험 기능 활성) -d '{"text":"Sentry alert"}' # 본문 = routine에 전달할 입력
/schedule을 써서 매주 월요일 오전 8시에 도는 routine을 등록해 줘. 작업은 (1) 지난주 부처 보도자료 5건을 기관 위키에서 찾아 (2) 각 1줄 + 우리 부서 시사점 1줄로 요약하고 (3) 결과를 기관 위키 '주간동향' 페이지에 새 항목으로 추가하는 거야. 노트북이 꺼져 있어도 돌아야 해.
행정 업무가 많은 분에게 결정타. AI 비서 주니어 — 출근 전에 보고서 초안. 망분리 환경이면 /loop 폴백.
p.4 / 7Advanced 1–5
Advanced 10 (2/2)
/ultrareview · /loop · /schedule · /effort · UX 보조
/ultrareview · /ultraplan Adv 6
클라우드에서 여러 서브에이전트가 병렬 PR 리뷰 또는 큰 계획 수립. Reviewer 2 시뮬레이션 — 의도적 다관점.
> /ultrareview # 지금 폴더의 변경분을 여러 reviewer 관점으로 동시 검토 > /ultrareview <PR#> # 특정 PR 번호를 다관점 검토 > /ultraplan <지시> --json --timeout # 큰 작업 다관점 계획 + JSON 출력 + 시간 제한
/ultraplan 본인 프로젝트의 다음 단계 작업을 단계별 계획으로 짜 줘. 보안·테스트·롤백 세 관점에서.
매주 한 번 — reviewer 코멘트 줄어듦. 망분리에서는 미작동.
/loop Adv 7
한 프롬프트를 인터벌마다 반복. fixed/dynamic/maintenance 3모드. 한 세션 50개 한도 · 7일 자동 만료.
> /loop 5m queue 상태 확인하고 끝났으면 후처리 # fixed = 5분마다 반복, 조건 충족 시 자동 종료 > /loop <프롬프트> # dynamic = 인터벌 생략 시 Claude가 작업 특성에 맞춰 결정 Esc # 다음 발화 전에 누르면 즉시 중단
/loop 10m queue 상태 확인해 주고, 끝났으면 후처리 시작해 줘. 다 되면 내가 Esc로 멈출게.
Routines가 클라우드 영구라면 /loop는 본인 노트북의 짧은 반복.
/schedule Adv 8
자연어로 cron 등록. Routines와 통합. 최소 1시간 단위. 분 단위는 /loop, 시간·일 단위는 /schedule.
> /schedule daily PR review at 9am # 자연어로 cron 등록 (매일 9시 routine) > /schedule list # 등록된 routine 전체 + 다음 실행 시각 > /schedule update <id> # 기존 routine의 일정·지시문 갱신
/schedule 매주 금요일 오후 5시에 이번 주 commit 5개를 요약해서 README에 붙여 줘.
"매주 월요일 9시" 한 마디면 끝.
/effort 5단계 Adv 9
추론 강도 다이얼 — low / medium / high / xhigh / max. xhigh는 Opus 4.7 전용. 단순은 빠르게, 복잡한 추론은 깊게.
> /effort xhigh # 추론 강도 즉시 지정 (xhigh = 가장 깊게 + 비용 큼) PS> claude --effort high # 시작 시점부터 강도 고정 (CLI 플래그) // 스킬 프론트매터 effort: high # 이 스킬 호출 시 항상 high로 (파일 단위 강제)
이건 심사 위원 통계 지적 반박이야. /effort xhigh로 깊게 가 줘. 핵심은 표본 크기 지적이야.
분류기 Auto가 일상 권장. 진짜 깊은 작업에서만 xhigh.
UX 보조 5종 Adv 10
/powerup(튜토리얼)·/focus(집중)·/copy(복사)·/terminal-setup(첫 세팅)·/less-permission-prompts(권한 정리).
> /powerup # 첫 사용자용 인터랙티브 가이드 (주요 기능 한 바퀴) > /focus # 사이드 패널 숨기고 본문만 (집중 발표·시연) > /copy # 직전 응답을 클립보드로 (붙여넣기 바로 가능) > /less-permission-prompts # 트랜스크립트 분석해 자주 거치는 명령 영구 허용
/less-permission-prompts 내 트랜스크립트 보고 자주 거치는 read-only 명령들 한 번에 영구 허용으로 바꿔 줘.
처음 쓰는 동료에게 /powerup 한 마디. 행정 업무가 많은 분에게 결정타는 /less-permission-prompts.
p.5 / 7Advanced 6–10
종합 · 회수 · 보안 한 컷
자기 점검

보안 · 재현성 · 환각 — 채택 장벽 세 가지에 한 줄씩

보안

API 모드는 데이터 학습을 하지 않습니다. 컨슈머 Pro와 다릅니다. 기관 망분리에서는 Bedrock·Vertex·Foundry 라우팅 가능. MCP 화이트리스트는 allowedMcpServers·allowManagedMcpServersOnly로.

재현성

permissions.deny + .claude/rules/ paths + git 세 겹으로 변경 추적. raw 데이터는 paths 글롭으로 자동 보호. CLAUDE.md·SKILL.md를 git에 같이 두면 환경 재현 가능.

환각

인용 검수 룰 + Plan 모드 + /ultrareview 다관점 세 가지로 완화. "검수하면 돼요"가 아니라 구체적 도구로 답. 한 사람 검수보다 단단함.

5문장 자기 점검 (LO 1~5)

  1. LO-1. 나는 PowerShell에서 claude를 열고 첫 응답을 받을 수 있다
  2. LO-2. 나는 내 폴더에 CLAUDE.md를 두고 효과 차이를 안다
  3. LO-3. 나는 Plan 모드와 deny 한 줄로 안전망을 갖췄다
  4. LO-4. 나는 내 시나리오 한 개를 Claude Code로 끝까지 수행할 수 있다
  5. LO-5. 나는 환각·재현성·보안 우려에 한 문장씩 답할 수 있다

다섯 개 중 네 개 이상이면 오늘 자리는 충분히 회수. 부족하면 다음 페이지 체크리스트로 한 주 안에 채우기.

p.6 / 7회수 · 보안 한 컷 · 자기 점검
체크리스트 · 22기능 자기 채택 추적
강사 연락처 · 더 알아볼 것

오늘 배운 22개 기능 체크리스트

한 주 안에 한 개씩 본인 일상에 끼워 보세요. □에 체크가 한두 개라도 채워지면 오늘 자리는 회수입니다.

Basic 12 — 일상

CLAUDE.md 5줄 만들기 — 본인 폴더에
Auto Memory 한 번 켜고 정정 1개 누적 확인
Plan Mode로 보고서 줄이기 1회
settings.json deny 한 줄 적기
SKILL.md 5줄짜리 1개 만들고 호출 확인
Subagent 1명 정의하고 한 번 호출
/agents 화면 한 번 띄워 보기
긴 세션에서 /compact 한 번 사용
/usage로 본인 한 주 비용 확인
--resume으로 어제 세션 부활
(욕심) Agent Teams 환경변수 켜기
.claude/rules/ paths 글롭 1줄 추가

Advanced 10 — 자동화

Get-Content | claude -p 한 줄 실행
PreToolUse hook 1개 (Remove-Item 차단)
MCP 서버 1개 등록 (위키 또는 Slack)
본인 환경을 plugin.json으로 묶기
/schedule로 routine 1개 등록 (베타)
/ultrareview 한 번 돌려 보기
/loop 5m로 큐 폴링 체험
/schedule list로 등록된 routine 확인
같은 질문을 /effort low·xhigh로 비교
/powerup·/focus·/copy 1번씩 사용

강사 연락처 · 후속 채널

황민호 수석

소속. Forward Deployed Engineer
이메일. robin.hwang@kakaocorp.com
기관 채널. 기관 위키·메신저 — KIST 도입 페어링 환영
강의 끝나고도 자리에 남아 1대1 질문을 받습니다.

더 알아볼 것

p.7 / 7Claude Code v2 핸드아웃 · 황민호 수석 · 2026-04-29