🔧 스킬 & 에이전트
내장 스킬
/simplify코드 리뷰 (병렬 에이전트 3개)
/batch대규모 병렬 변경 (5-30 워크트리)
/debug [desc]디버그 로그로 문제 해결
/loop [interval]반복 예약 작업
/claude-apiAPI + SDK 참조 로드
커스텀 스킬 위치
.claude/skills/<n>/프로젝트 스킬
~/.claude/skills/<n>/개인 스킬
스킬 프론트매터
description자동 호출 트리거
allowed-tools권한 프롬프트 생략
model스킬용 모델 재정의
effort노력 수준 재정의
paths: [globs]경로별 적용 NEW
context: fork서브에이전트에서 실행
$ARGUMENTS사용자 입력 플레이스홀더
${CLAUDE_SKILL_DIR}스킬 자신의 디렉터리
!`cmd`동적 컨텍스트 주입
plugin bin/Bash 도구용 실행 파일 NEW
🖥️ CLI & 플래그
핵심 명령
claude대화형 시작
claude "q"프롬프트와 함께 시작
claude -p "q"헤드리스 (비대화형)
claude -c마지막 대화 이어가기
claude -r "n"이름으로 세션 재개
claude update업데이트
내장 에이전트
Explore빠른 읽기 전용 (Haiku)
Plan플랜 모드용 리서치
General전체 도구, 복잡한 태스크
Bash터미널 별도 컨텍스트
에이전트 프론트매터
permissionModedefault/acceptEdits/plan/dontAsk/bypass
isolation: worktreegit 워크트리에서 실행
memory:user|project|local 영구 메모리
background: true백그라운드 태스크
maxTurns에이전트 턴 제한
initialPrompt첫 턴 자동 제출
SendMessage에이전트 재개 (resume 대체)
@agent-name하위 에이전트 멘션 NEW
주요 플래그
--model모델 지정
-wGit 워크트리
-n / --name세션 이름 지정
--add-dir작업 디렉터리 추가
--agent에이전트 사용
--allowedTools도구 사전 승인
--output-formatjson/stream 출력
--json-schema구조화 출력 스키마
--max-turns최대 턴 수 제한
--max-budget-usd비용 상한
--consoleAnthropic Console 인증
--verbose상세 로그
--bare최소 헤드리스 (훅/LSP 없음)
--channels권한 릴레이 / MCP 푸시
--remote웹 세션 연결
--effortlow/medium/high/max
--permission-modeplan/default/acceptEdits…
--dangerously-skip-permissions모든 프롬프트 생략 ⚠️
--chromeChrome 연동
PowerShell toolWindows 옵트인 미리보기 NEW ⊞ WIN
⌨️ 키보드 단축키
일반 제어
Ctrl+C
입력/생성 취소
Ctrl+D
세션 종료
Ctrl+L
화면 지우기
Ctrl+O
상세 출력 전환
Ctrl+R
히스토리 검색
Ctrl+G
프롬프트 편집기 열기
Ctrl+XE
편집기 열기 (별칭)
Ctrl+B
백그라운드 실행
Ctrl+T
태스크 목록 전환
Ctrl+V
이미지 붙여넣기
Ctrl+XK
백그라운드 에이전트 종료
EscEsc
되감기 / 요약
모드 전환
Shift+Tab
권한 모드 순환
Alt+P
모델 전환
Alt+T
Thinking 모드
Alt+O
빠른 모드 NEW
입력
\Enter
줄바꿈 (빠른)
Ctrl+J
줄바꿈 (제어)
/
슬래시 명령어
!
직접 Bash 실행
@
파일 자동완성
세션 선택기
↑↓
탐색
←→
확장/축소
P
미리보기
R
이름 변경
/
검색
A
전체 프로젝트
B
현재 브랜치
트랜스크립트 (Ctrl+O)
/
검색
N / ⇧N
다음/이전
Ctrl+E
전체 보기 전환
Q / Esc
종료
⚡ 슬래시 명령어
세션 (Session)
/clear대화 내용 초기화
/compact [focus]컨텍스트 압축
/resume세션 재개/전환
/rename [name]현재 세션 이름 변경
/branch [name]대화 브랜치 생성 (/fork)
/cost토큰 사용량 통계
/context컨텍스트 시각화 (그리드)
/diff인터랙티브 diff 뷰어
/copy [N]마지막(N번째) 응답 복사
/rewind코드/체크포인트 되감기
/export대화 내보내기
설정 (Config)
/config설정 열기
/model [model]모델 전환 (←→ effort)
/fast [on|off]빠른 모드 전환
/vimVim 모드 전환
/theme컬러 테마 변경
/permissions권한 보기/수정
/effort [level]노력 수준 설정 (low/med/high/max/auto)
/color [color]프롬프트 바 색상 설정
/keybindings키보드 단축키 커스텀
/terminal-setup터미널 키바인딩 설정
도구 (Tools)
/initCLAUDE.md 생성
/memoryCLAUDE.md 파일 편집
/mcpMCP 서버 관리
/hooks훅 관리
/skills사용 가능한 스킬 목록
/agents에이전트 관리
/chromeChrome 연동
/reload-plugins플러그인 핫 리로드
/add-dir <path>작업 디렉터리 추가
특수 (Special)
/powerup인터랙티브 기능 학습 NEW
/btw <question>컨텍스트 없는 사이드 질문
/plan [desc]플랜 모드 (+ 자동 시작)
/loop [interval]반복 작업 스케줄링
/voice음성 입력 (20개 언어)
/doctor설치 상태 진단
/pr-comments [PR]GitHub PR 코멘트 가져오기
특수 (계속)
/stats사용량 스트릭 & 설정
/insights세션 분석 리포트
/desktop데스크탑 앱에서 계속
/remote-controlclaude.ai/code 브릿지 (/rc) NEW
/usage플랜 한도 & 상태
/schedule클라우드 예약 작업
/security-review변경사항 보안 분석
/help도움말 + 명령어 목록
/feedback피드백 제출 (별칭: /bug)
/release-notes전체 변경 내역 보기
/stickers스티커 주문 🎉
🔌 MCP 서버
서버 추가
--transport http원격 HTTP 권장
--transport stdio로컬 프로세스
--transport sse원격 SSE
스코프
~/.claude.json로컬 (본인만)
.mcp.json프로젝트 (VCS 공유)
~/.claude.json사용자 (전체 프로젝트)
관리
/mcp인터랙티브 UI
claude mcp list전체 서버 목록
claude mcp serveCC를 MCP 서버로 실행
추가 정보
Elicitation — 서버가 작업 중 입력 요청
도구 설명 + 서버 지침 2KB 제한
maxResultSizeChars _meta로 500K까지 NEW🧠 워크플로 & 팁
Plan Mode
Shift+Tab
일반 → 자동수락 → 계획 모드
--permission-mode plan플랜 모드로 시작
Thinking & Effort
Alt+T
사고 모드 켜기/끄기
ultrathink해당 턴 최대 노력 모드
Ctrl+O
사고 과정 보기 (verbose)
/effort○ low · ◐ medium · ● high · ★ max
Auto Mode Denied
/permissions → Recent NEW거부된 권한 재시도 (R)
Git Worktrees
--worktree name기능별 격리 브랜치
isolation: worktree에이전트 전용 워크트리
sparsePaths필요한 디렉터리만 체크아웃
/batch워크트리 자동 생성
Voice Mode
/voice음성 입력 활성화
Space (길게)
녹음 → 놓으면 전송
20개 언어 (EN, KO, ES, FR, DE…)
Context 관리
/context사용량 + 최적화 팁
/compact [focus]포커스 지정 압축
자동 압축 ~95% 시 NEW
Opus 4.6 — 1M 컨텍스트 지원
CLAUDE.md 압축 후에도 유지!
세션 파워 무브
claude -c마지막 대화 이어가기
claude -r "name"이름으로 세션 재개
/btw question컨텍스트 비용 없는 사이드 질문
SDK / Headless
claude -p "query"비대화형 실행
--output-format json구조화 출력
--max-budget-usd 5비용 상한 설정
cat file | claude -p파이프 입력
스케줄링 & 원격
/loop 5m msg반복 작업 예약
/rc원격 제어
--remoteclaude.ai 웹 세션 연결
📁 메모리 & 파일
CLAUDE.md 위치
./CLAUDE.md프로젝트 (팀 공유)
~/.claude/CLAUDE.md개인 (전체 프로젝트)
/etc/claude-code/조직 관리 (Managed)
규칙 & 임포트
.claude/rules/*.md프로젝트 규칙
~/.claude/rules/*.md사용자 규칙
paths:프론트매터 경로별 규칙
@path/to/fileCLAUDE.md에서 파일 임포트
자동 메모리
~/.claude/projects/<proj>/memory/MEMORY.md + 주제별 파일 자동 로드
최대 25KB / 200줄
⚙️ 설정 & 환경 변수
설정 파일
~/.claude/settings.json사용자 설정
.claude/settings.json프로젝트 (공유)
.claude/settings.local.json로컬 전용
~/.claude.jsonOAuth, MCP, 상태
.mcp.json프로젝트 MCP 서버
managed-settings.d/드롭인 정책 조각
핵심 설정 항목
modelOverrides모델 피커 → 커스텀 ID 매핑
autoMemoryDirectory커스텀 메모리 디렉터리
worktree.sparsePaths스파스 체크아웃 경로
sandbox.failIfUnavailable샌드박스 없으면 종료
hooks: if조건부 훅 (권한 규칙 문법)
PermissionDenied자동 모드 거부 훅 NEW
showThinkingSummaries사고 요약 표시 (기본 off) NEW
hooks: "defer"헤드리스 일시정지 → 나중에 재개
disableSkillShellExec스킬/플러그인 !`cmd` 차단 NEW
핵심 환경 변수
ANTHROPIC_API_KEYAPI 키
ANTHROPIC_MODEL모델 지정
CLAUDE_CODE_EFFORT_LEVELlow/medium/high/max/auto
MAX_THINKING_TOKENS0 = 사고 비활성화
ANTHROPIC_CUSTOM_MODEL_OPTION커스텀 /model 항목
CLAUDE_CODE_SUBPROCESS_ENV_SCRUB서브프로세스 크리덴셜 제거
CLAUDE_STREAM_IDLE_TIMEOUT_MS스트리밍 감시 (기본 90s)
CLAUDE_CODE_NO_FLICKER대체 화면 렌더링 (=1) NEW
MCP_CONNECTION_NONBLOCKING-p에서 MCP 대기 생략 NEWCLAUDECODECC 셸 감지 (=1)
CLAUDE_CODE_MAX_OUTPUT_TOKENS최대 출력 토큰 (기본 32K)
CLAUDE_CODE_DISABLE_CRON크론 비활성화