📖 빠른 참조

Claude Code 사용 시 가장 자주 찾는 명령어와 설정을 한 곳에 모았습니다.

---

기본 실행

claude                    # 대화형 모드 시작
claude "작업 내용"         # 단일 프롬프트 실행
claude -p "프롬프트"       # --print 모드 (결과만 출력)
claude --continue         # 마지막 대화 이어서
claude --resume           # 세션 선택 후 재개
claude --model sonnet     # 모델 지정 (sonnet, opus, 또는 전체 모델명)
claude update             # 최신 버전으로 업데이트
claude auth login         # Anthropic 계정 로그인
claude auth status        # 인증 상태 확인 (JSON)
claude agents             # 설정된 서브에이전트 목록
claude mcp                # MCP 서버 설정

---

슬래시 커맨드

커맨드	설명
/help	도움말 표시
/clear	현재 대화 내용 초기화 (별칭: /reset, /new)
/compact [지침]	대화 요약 후 컨텍스트 절약 (선택 요약 지침)
/memory	CLAUDE.md 파일 편집, 자동 메모리 설정
/cost	현재 세션 누적 비용 확인
/model [모델명]	사용 모델 변경 (좌우 화살표로 Effort Level 조절)
/permissions	도구 권한 설정 확인 (별칭: /allowed-tools)
/status	버전, 모델, 계정, 연결 상태 확인
/config	설정 인터페이스 열기 (별칭: /settings)
/init	CLAUDE.md 초기 생성
/fast [on|off]	Fast Mode 토글
/diff	커밋 안 된 변경사항 인터랙티브 diff 뷰어
/context	현재 컨텍스트 사용량 시각화
/copy	마지막 응답을 클립보드에 복사
/doctor	설치 및 설정 진단
/export [파일명]	현재 대화를 텍스트로 내보내기
/fork [이름]	현재 대화 분기(fork) 생성
/hooks	Hook 설정 관리
/plugin	플러그인 관리
/pr-comments [PR]	GitHub PR 코멘트 가져오기
/rename [이름]	현재 세션 이름 변경
/resume [세션]	세션 재개 (별칭: /continue)
/rewind	이전 시점으로 되돌리기 (별칭: /checkpoint)
/sandbox	샌드박스 모드 토글
/skills	사용 가능한 Skills 목록
/stats	일일 사용량, 세션 히스토리 시각화
/theme	컬러 테마 변경
/vim	Vim/Normal 편집 모드 전환

팁

/review는 deprecated 되었습니다. 대신 claude plugin install code-review@claude-code-marketplace로 플러그인을 설치하세요.

---

주요 CLI 플래그

플래그	설명
--print, -p	결과만 출력 (비대화형 모드)
--continue, -c	현재 디렉토리의 최근 대화 이어서
--resume, -r	세션 ID 또는 이름으로 재개
--model	모델 지정 (sonnet, opus, 또는 전체 모델명)
--permission-mode	권한 모드 지정 (default, plan, acceptEdits, bypassPermissions)
--allowedTools	자동 승인할 도구 목록
--disallowedTools	사용 금지할 도구 목록
--tools	사용 가능한 도구 제한 ("Bash,Edit,Read")
--add-dir	추가 작업 디렉토리 지정
--system-prompt	전체 시스템 프롬프트 교체
--append-system-prompt	기본 프롬프트에 지침 추가
--max-turns	에이전틱 루프 최대 턴 수 (print 모드)
--max-budget-usd	API 비용 한도 (print 모드)
--output-format	출력 형식 (text, json, stream-json)
--mcp-config	MCP 서버 설정 JSON 파일 로드
--worktree, -w	격리된 git worktree에서 실행
--chrome / --no-chrome	Chrome 브라우저 통합 활성화/비활성화
--agent	세션에 사용할 에이전트 지정
--agents	커스텀 서브에이전트 JSON 정의
--plugin-dir	플러그인 디렉토리 로드
--dangerously-skip-permissions	모든 권한 검사 건너뜀 (주의!)
--verbose	상세 로깅 (턴별 출력)
--debug	디버그 모드 (카테고리 필터 가능)
--json-schema	JSON Schema에 맞는 구조화된 출력 (print 모드)
--fallback-model	기본 모델 과부하 시 대체 모델 (print 모드)
--fork-session	세션 재개 시 새 세션 ID로 분기
--from-pr	GitHub PR에 연결된 세션 재개
--remote	claude.ai에서 웹 세션 생성
--teleport	웹 세션을 로컬 터미널로 가져오기
--teammate-mode	Agent Team 표시 방식 (auto, in-process, tmux)

팁

--append-system-prompt은 기본 Claude Code 기능을 유지하면서 추가 지침만 붙이므로 대부분의 경우 권장됩니다. --system-prompt은 전체 교체이므로 주의가 필요합니다.

---

권한 모드

Shift+Tab으로 전환하거나, --permission-mode 플래그로 시작 시 지정합니다:

모드	값	설명
Default	default	각 작업마다 승인 요청
Auto-accept Edits	acceptEdits	파일 편집 자동 승인, Bash는 확인
Plan Mode	plan	읽기 전용 탐색, 파일 수정 안 함
Bypass	bypassPermissions	모든 권한 검사 건너뜀

주의

--dangerously-skip-permissions (Bypass 모드)는 격리된 환경(Docker, VM)에서만 사용하세요.

---

CLAUDE.md 템플릿

# 프로젝트명

## 기술 스택
- 언어: TypeScript
- 프레임워크: Next.js
- 패키지 매니저: npm

## 코딩 규칙
- 함수명: camelCase
- 파일명: kebab-case
- 들여쓰기: 2 스페이스

## 자주 쓰는 명령어
- 개발 서버: `npm run dev`
- 빌드: `npm run build`
- 테스트: `npm test`

## 현재 진행 상황
- ✅ 완료된 작업
- 🔄 진행 중
- ⬜ 예정

---

환경 변수

핵심 설정

변수	설명	기본값
ANTHROPIC_API_KEY	API 인증 키	—
ANTHROPIC_MODEL	기본 모델 설정	플랜별 상이
CLAUDE_CODE_MAX_OUTPUT_TOKENS	최대 출력 토큰 수	32,000
CLAUDE_CODE_EFFORT_LEVEL	Effort Level (low, medium, high)	—
CLAUDE_CODE_DISABLE_FAST_MODE	Fast Mode 비활성화 (1)	—
CLAUDE_CODE_SHELL	자동 셸 감지 재정의	—
CLAUDE_CONFIG_DIR	설정/데이터 파일 저장 위치 변경	—
HTTP_PROXY / HTTPS_PROXY	프록시 설정	—

기능 토글

변수	설명
CLAUDE_CODE_DISABLE_AUTO_MEMORY	자동 메모리 비활성화 (1) / 강제 활성화 (0)
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS	백그라운드 태스크 비활성화 (1)
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS	내장 커밋/PR 워크플로우 지침 제거 (1)
CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING	Opus/Sonnet 4.6 적응형 추론 비활성화 (1)
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION	프롬프트 제안 비활성화 (false)
CLAUDE_CODE_ENABLE_TASKS	태스크 추적 비활성화, 이전 TODO 목록으로 복원 (false)
DISABLE_AUTOUPDATER	자동 업데이트 비활성화 (1)
DISABLE_PROMPT_CACHING	프롬프트 캐싱 비활성화 (1)
DISABLE_COST_WARNINGS	비용 경고 메시지 비활성화 (1)
DISABLE_TELEMETRY	텔레메트리 비활성화 (1)

Bash 도구 설정

변수	설명
BASH_DEFAULT_TIMEOUT_MS	Bash 명령어 기본 타임아웃
BASH_MAX_TIMEOUT_MS	Bash 명령어 최대 타임아웃
BASH_MAX_OUTPUT_LENGTH	Bash 출력 최대 글자 수 (초과 시 중간 생략)

클라우드 제공자 (Bedrock / Vertex / Foundry)

변수	설명
CLAUDE_CODE_USE_BEDROCK	AWS Bedrock 사용
CLAUDE_CODE_USE_VERTEX	Google Vertex 사용
CLAUDE_CODE_USE_FOUNDRY	Microsoft Foundry 사용
ANTHROPIC_FOUNDRY_BASE_URL	Foundry 리소스 URL

팁

전체 환경 변수 목록은 공식 설정 문서를 참조하세요.

---

모델 선택 가이드

모델	용도	상대 비용
claude-haiku-4-5	빠른 작업, 대량 처리	저렴
claude-sonnet-4-6	일반 개발 (기본 권장)	중간
claude-opus-4-6	복잡한 설계, Extended Thinking	비쌈

---

Hooks 이벤트 종류 (18개)

이벤트	발생 시점
SessionStart	세션 시작 또는 재개 시
UserPromptSubmit	프롬프트 제출 후, Claude 처리 전
PreToolUse	도구 실행 직전 (차단 가능)
PermissionRequest	권한 다이얼로그 표시 시
PostToolUse	도구 실행 성공 후
PostToolUseFailure	도구 실행 실패 후
Notification	Claude가 알림 보낼 때
SubagentStart	서브에이전트 생성 시
SubagentStop	서브에이전트 완료 후
Stop	Claude 응답 완료 후
TeammateIdle	Agent Team 동료가 유휴 상태 진입 시
TaskCompleted	태스크 완료 표시 시
InstructionsLoaded	CLAUDE.md 또는 rules 파일 로드 시
ConfigChange	세션 중 설정 파일 변경 시
WorktreeCreate	Worktree 생성 시
WorktreeRemove	Worktree 제거 시
PreCompact	컨텍스트 압축 전
SessionEnd	세션 종료 시

팁

Hook 타입은 셸 커맨드(command), HTTP 엔드포인트, LLM 프롬프트, MCP 도구 4가지를 지원합니다. 자세한 설정법은 공식 Hooks 레퍼런스를 참조하세요.

---

Agent SDK 빠른 참조

import { query } from "@anthropic-ai/claude-agent-sdk";

// 기본 실행
const response = await query({
  prompt: "작업 내용",
  options: {
    maxTurns: 10,
    allowedTools: ["Read", "Write", "Bash"],
    systemPrompt: "당신은 전문가입니다."
  }
});

// 응답 텍스트 추출
const text = response
  .filter(m => m.type === "assistant")
  .flatMap(m => m.content)
  .filter(b => b.type === "text")
  .map(b => b.text)
  .join("\n");

---

자주 쓰는 프롬프트 패턴

# 코드 리뷰
"이 PR의 변경사항을 검토하고 버그, 보안 이슈, 개선 사항을 알려줘."

# 리팩토링
"이 함수를 읽기 쉽게 리팩토링해줘. 동작은 바꾸지 말고."

# 테스트 작성
"이 함수에 대한 단위 테스트를 Jest로 작성해줘. 엣지 케이스 포함."

# 문서화
"이 모듈의 JSDoc 주석을 작성해줘."

# 디버깅
"이 에러의 원인을 찾고 수정해줘: [에러 메시지]"