Claude Code 셋업
명령어·모드·CLI 완전정복

Session 1 · Claude Code 셋업·명령어·모드·CLI

설치·인증 · 모드 5종 · 슬래시 20+ · CLI 인자 · @file·!cmd · 조합 매트릭스

강사 박수현 · 🚀 젠아이랩스(GenAI Labs)

🎨 이미지 프롬프트: "Editorial illustration on dark navy #0f1722 background showing a terminal window with a blinking caret next to a dollar-sign prompt. Around the terminal, four small icons float in orbit: a check mark labeled 'Install', a padlock labeled 'Auth', a slash labeled 'Slash', and a keyboard key labeled 'CLI'. Clean editorial illustration style, teal #00b894 and purple #6c5ce7 accents with warm orange highlights, 16:9. CRITICAL: All visible text MUST be in English ONLY (no Korean characters). Each label appears EXACTLY ONCE — no duplicates. No mirrored or reversed text."

Session 1 · Claude Code 셋업·명령어·모드·CLI

PART 1

셋업 — 설치·인증·모델 선택

설치 경로 3종 · 플랫폼별 유의점 · 첫 인증 · ~/.claude 구조 · 구독·요금 · 모델 3종 · 첫 대화 5분.

설치 경로 3종 — 무엇을 언제 쓰나

curl -fsSL https://claude.ai/install.sh | bash

brew install --cask claude-code

npm install -g @anthropic-ai/claude-code

플랫폼별 유의점 — macOS · Linux · WSL2 · Windows

Windows Native — PowerShell

irm https://claude.ai/install.ps1 | iex

데스크톱 앱 최근 변경 — Home 통합 · Cowork · Hyper-V

Chat·Cowork가 Home 탭 하나로 통합됐다. Cowork는 가상화 위에서 돌아 Windows는 별도 준비가 필요하다.

설치 확인 · 첫 인증

# 1. 설치 확인
claude --version

# 2. 환경 진단 (권장)
claude doctor

# 3. 첫 실행 · 인증 (브라우저가 열림)
claude

~/.claude 디렉토리 구조

~/.claude/
├── CLAUDE.md          # 전 프로젝트 공통 개인 지침 (선택)
├── settings.json      # 설정 · 권한 · 훅
├── projects/          # 프로젝트별 세션 로그
│   └── -home-user-repo/
├── skills/            # 개인 스킬 정의
├── plugins/           # 설치한 플러그인
├── statsig/           # 원격 설정 캐시
└── ...

~/.claude.json         # 프로젝트 인덱스 · 최근 세션

🎨 이미지 프롬프트: "Editorial illustration on dark navy #0f1722 background — directory tree with root folder labeled ~/.claude/ (with tilde and slashes visible). Six children stacked vertically: CLAUDE.md (teal) with right caption 'Context axis'; settings.json (purple) with right caption 'Harness axis'; projects/ (teal) with right caption 'Session logs'; skills/ (teal) with right caption 'Context axis'; plugins/ (gray) with right caption 'Later sessions'; statsig/ (gray) with right caption 'Later sessions'. Monospaced tree, teal #00b894 for Context, purple #6c5ce7 for Harness, gray for later. 16:9. CRITICAL: English text only, no Korean; each label EXACTLY ONCE; correct spelling of every word; no reversed/mirrored text."

구독·요금 — 2026년 6월 기준

모델별 API 요금 — Anthropic 공개, per MTok

모델 3종 실무 감각 — Opus · Sonnet · Haiku

🎨 이미지 프롬프트: "Editorial illustration on dark navy #0f1722 background of three cars parked side by side. From left to right: a sleek sports car labeled 'Opus' for hard refactoring, a comfortable sedan labeled 'Sonnet' for daily work, and a compact kei car labeled 'Haiku' for batch tasks. Each car has a small task icon above it — gear, laptop, and repeat arrow. Clean editorial illustration style, teal #00b894 and purple #6c5ce7 accents, 16:9. CRITICAL: All visible text MUST be in English ONLY (no Korean characters). Each label appears EXACTLY ONCE — no duplicates. No mirrored or reversed text."

모델 전환 두 가지 · Fallback chain

# 1. 세션 시작 시
claude --model sonnet          # 별칭: opus · sonnet · haiku
claude --model claude-sonnet-4-6   # 정식 모델 ID

# 2. 세션 안에서
/model sonnet

# 3. Fallback — 과부하 시 자동 전환
claude --fallback-model sonnet,haiku

첫 대화 5분

# 1. 리포 진입
cd ~/some-repo

# 2. Claude Code 시작
claude

# 3. 대화 (프롬프트가 뜨면 다음을 친다)
> @README.md 이 프로젝트를 3줄로 요약해줘

PART 2

실행 모드 — Shift+Tab으로 순환

모드 6종 개요 · Default(Manual) · Plan · acceptEdits · auto · dontAsk · bypassPermissions · 상황별 모드 선택.

실행 모드 6종 — 기본 순환 3 + 조건부 2 + 플래그 전용 1

Claude Code의 실행 모드는 "승인을 어디까지 물어보나"를 정하는 스위치다. Shift+Tab 기본 순환은 default → acceptEdits → plan 셋이고, bypassPermissions·auto는 조건이 맞을 때 순환 뒤에 붙는다. dontAsk는 순환에 없이 플래그로만 켠다. 모두 합쳐 6모드다.

🎨 이미지 프롬프트: "Editorial illustration on dark navy #0f1722 background — four colored blocks arranged in a circular loop with clockwise curved arrow labeled 'Shift+Tab' between them. Blocks labeled EXACTLY (English only): 'Default' (blue) top, 'Plan' (purple) right, 'acceptEdits' (teal) bottom, 'auto' (amber) left. Only these four English labels — NO other text anywhere, no Korean, no captions, no arrow annotations except the single 'Shift+Tab' label. Clean editorial style, 16:9. CRITICAL: absolutely no Korean characters, no Hangul, no random glyphs. Only these five English strings: Default, Plan, acceptEdits, auto, Shift+Tab. Each EXACTLY ONCE."

실행 모드 — Shift+Tab으로 순환

Default 모드 — 안전 · 대화형

설치 직후 기본값이다. Claude가 파일을 수정하거나 셸을 실행하려 할 때마다 사용자에게 승인을 묻는다.

Plan 모드 — 읽기 전용 · 큰 리팩토링 전에

Plan 모드는 "연구하고 제안하되 손대지 않는" 상태다. Claude는 파일을 읽고, 셸 탐색 명령을 돌리고, 계획을 글로 쓴다. 실제 편집은 하지 않는다.

# 세션 시작 시
claude --permission-mode plan

# 세션 안에서
Shift+Tab (모드 순환)

acceptEdits 모드 — 편집 자동 · 셸은 승인

Claude를 며칠 써 보면 승인 프롬프트가 반복 노동이 된다. 신뢰가 쌓이면 자동화 모드로 넘어간다. 그 첫 단계가 acceptEdits — 공식 UI 명칭은 Auto-accept edits, CLI·설정 파일에서는 acceptEdits 키로 다룬다.

# 진입 방법
Shift+Tab (모드 순환)
# 또는
claude --permission-mode acceptEdits

bypassPermissions — ⚠️ 격리 환경 전용

claude --dangerously-skip-permissions

상황별 모드 선택 — 5개 시나리오

PART 3

슬래시 명령어 총정리 — 5개 그룹

슬래시 명령이 뭔가 · 그룹 A~E · 요약 카드. 20개 넘는 명령을 한꺼번에 외우지 않고 그룹별로 익힌다.

슬래시 명령이 뭔가

슬래시 명령은 세션 안에서 /로 시작하는 특수 명령이다. 자연어 대화와 별개로 세션 자체를 조작하는 데 쓴다.

그룹 A — 세션·컨텍스트 관리

그룹 B — 프로젝트·설정

그룹 C — 확장·통합

그룹 D — 진단·유틸

🎨 이미지 프롬프트: "Editorial illustration on dark navy #0f1722 background of a stylized terminal window mockup titled 'slash doctor'. Inside the terminal, three diagnostic lines stack vertically with clear status glyphs: a green teal check labeled 'npm install works', a red cross labeled 'Network reachable', and an amber warning triangle labeled 'Auto-update disabled'. Monospaced text feel, clean editorial illustration style, teal #00b894 and purple #6c5ce7 accents, 16:9. CRITICAL: All visible text MUST be in English ONLY (no Korean characters). Each label appears EXACTLY ONCE — no duplicates. No mirrored or reversed text."

그룹 E — Git · PR

슬래시 명령 요약 카드 — 벽에 붙이기

🎨 이미지 프롬프트: "Editorial illustration on dark navy #0f1722 background — printable cheat-sheet card pinned to wall. Nine rows, situation left / real slash command right, using ONLY these exact command strings: /doctor, /cost, /compact, /clear, /init, /model opus, /mcp, /review 123, /resume. Left labels: 'Something feels off', 'Cost worry', 'Context full', 'Different task', 'New repo', 'Switch model', 'MCP check', 'PR review', 'Resume yesterday'. Bottom caption 'Screenshot and pin to your wall'. Monospaced right column. 16:9. English only, each label EXACTLY ONCE, correct spelling."

PART 4

CLI 인자·특수 입력 — 세션 밖에서

claude 5개 형태 · 실전 플래그 7선 · @file · !command · Shift+Tab · Esc.

claude CLI 5개 핵심 형태

-p 실전 — 셸 파이프·CI·스크립트

# 셸 파이프 - 로그 파일 요약
cat production.log | claude -p "이 로그의 에러 패턴 5가지"

# @file 참조 - 배치
claude -p "@README.md 한 줄 요약해줘"

# CI 안에서 - PR 리뷰
claude -p "/review 123" --model haiku

# ~/.zshrc
claude-summary() {
  claude -p "$@ 요약해줘"
}

자주 쓰는 CLI 플래그 7선

서브커맨드 3 + MCP 관련 4

claude --version   # 설치 버전
claude doctor      # 환경 진단
claude update      # 최신 버전으로 업데이트

claude mcp add --transport stdio \
    my-server -- python server.py
claude mcp list
claude mcp login sentry
claude mcp logout sentry

특수 입력 4종 — 세션 안에서

🎨 이미지 프롬프트: "Editorial illustration on dark navy #0f1722 background of a stylized Claude Code prompt window. Three example lines are stacked vertically inside the window: the first line reads '> @README.md summarize', the second line reads '> !git log --oneline -5', and the third line shows a small keyboard-key icon labeled 'Shift+Tab' next to the caption 'cycle modes'. A blinking caret sits at the bottom, indicating an active session. Monospaced typography, clean editorial illustration style, teal #00b894 and purple #6c5ce7 accents, 16:9. CRITICAL: All visible text MUST be in English ONLY (no Korean characters). Each label appears EXACTLY ONCE — no duplicates. No mirrored or reversed text."

나머지 유용한 단축키

PART 5

"언제 뭐 쓰나" 매트릭스 — 조합의 지도

상황별로 조합한 매트릭스. 이 세션의 최종 결과물이다.

상황·조합 매트릭스 ① — 셋업·개발 상황

상황·조합 매트릭스 ② — 자동화·비용·격리

cat log | claude -p "에러 패턴 분류"

🎨 이미지 프롬프트: "Editorial illustration on dark navy #0f1722 background — 3x2 grid of six distinct scenario cards. Each card: icon left, situation label top-right, real command bottom-right. Six DISTINCT cards (no duplicates): (1) magnifier + 'PR review CI' + -p /review 123; (2) chart bar + 'Cost worry' + /cost; (3) recycle arrow + 'Resume yesterday' + claude -c; (4) shield + 'Isolated batch' + --dangerously-skip-permissions; (5) pipe + 'Log analysis' + cat log | claude -p; (6) bug + 'Env broken' + /doctor. 16:9. English only, no duplicate labels, correct spelling, monospaced commands."

오답 노트 — 참여자가 잘 저지르는 실수 5선

PART 6

미니 실습·정리 — 손에 붙이기

실습 4개 (모드 순환 · /init · /doctor · -p 배치) · 세션 정리 한 문장.

🎨 이미지 프롬프트: "Editorial illustration on dark navy #0f1722 background — 2x2 grid of four hands-on lab cards. Each: icon, title, REAL command in monospace, observation caption, time badge. Card 1: Shift+Tab key icon, 'Lab 1 — Mode cycle', command Shift+Tab (in session), caption 'Approval UI', badge '2 min'. Card 2: folder icon, 'Lab 2 — /init', command > /init, caption 'Repo primer', badge '2 min'. Card 3: stethoscope icon, 'Lab 3 — /doctor', command > /doctor, caption 'Env check', badge '2 min'. Card 4: pipe icon, 'Lab 4 — -p batch', command claude -p \"@README.md summarize\", caption 'Automation gateway', badge '3 min'. 16:9. English only, each label EXACTLY ONCE, real commands only."

미니 실습·정리 — 손에 붙이기

실습 1 — 모드 4개 순환

# 1. 세션 시작
claude

# 2. Shift+Tab 을 4번 눌러 모드 순환 관찰
#    Default → acceptEdits → plan → (원래대로)
# 3. 각 모드에서 우상단 표시 확인

# 4. 각 모드에서 "test.txt 파일 만들어줘" 시도
#    - Default: 승인 요청 뜸
#    - Plan: "계획만 세우고 편집 안 함" 응답
#    - acceptEdits: 바로 만듦

실습 2 — /init 실행

# 1. 자기 사이드 프로젝트 리포로 이동
cd ~/my-project

# 2. Claude Code 시작
claude

# 3. 세션 안에서
> /init

실습 3 — /doctor 실행

# 세션 안에서
> /doctor

실습 4 — -p 배치 실행

# 셸에서 세션 없이 바로
claude -p "@README.md 한 줄로 요약해줘"

# 자기 셸 alias 만들기
alias summ='claude -p "요약해줘"'

# 로그 요약
cat /tmp/app.log | summ

마무리 — 한 문장으로

여기까지 마쳤다면 노트북에서 Claude Code가 뜨고, Shift+Tab으로 승인 모드를 오가며 6종 체계를 파악했고, 20개 넘는 슬래시 명령을 5개 그룹으로 파악했고, claude -p로 셸 파이프까지 붙인 상태다.

상황이 애매하면 세션 안인지 밖인지, 어떤 모드인지부터 자문한다.

🎨 이미지 프롬프트: "Editorial illustration on dark navy #0f1722 background of a stylized terminal window with a bright angle-bracket prompt at the bottom, indicating an active session. Above the prompt, a short English caption reads 'Setup complete'. Small orbiting icons around the terminal represent slash, at-sign, exclamation-mark, and Shift key. Clean editorial illustration style, teal #00b894 and purple #6c5ce7 accents, 16:9. CRITICAL: All visible text MUST be in English ONLY (no Korean characters). Each label appears EXACTLY ONCE — no duplicates. No mirrored or reversed text."