Claude Code CLI 완벽 레퍼런스
Claude Code의 모든 명령어, 플래그, 키보드 단축키, 인터랙티브 기능을 소개합니다.
CLI 명령어
터미널에서 Claude Code와 상호작용하기 위한 핵심 명령어.
인터랙티브 세션
claude — 대화형 세션 시작
원샷 쿼리
claude "질문" — 빠른 인라인 쿼리
출력 모드 (비대화형)
claude -p "쿼리" — 응답을 출력하고 종료. 스크립트와 파이핑에 적합.
인터랙티브 모드
Claude 세션 중 사용할 수 있는 키보드 단축키와 인터랙티브 기능.
플랜 모드 (Shift+Tab)
플랜 모드를 전환하여 Claude가 코드를 작성하기 전에 먼저 생각하고 계획하도록 합니다. Claude가 탐색하고, 분석하고, 승인을 위한 계획을 제안합니다.
음성 입력 & Bash 모드
Space 길게 누르기로 음성 입력. !를 입력하면 인라인 셸 명령어. @로 파일 참조.
키보드 단축키
Ctrl+C: 취소. Ctrl+G: 퍼지 검색. Ctrl+B: 백그라운드 에이전트. Ctrl+T: 태스크 리스트. Shift+Tab: 플랜 모드.
고급 기능
고급 워크플로우와 자동화를 위한 파워 기능.
확장 사고
'think', 'think hard', 'think harder', 또는 'ultrathink'를 사용하여 더 깊은 추론을 활성화합니다. 더 많은 사고 예산 = 복잡한 문제에 대한 더 철저한 분석.
프로젝트 메모리 (CLAUDE.md)
CLAUDE.md 파일을 만들어 프로젝트 규칙, 컨벤션, 컨텍스트를 저장하세요. Claude가 자동으로 읽습니다. 짧고, 구체적으로, 정기적으로 정리하세요.
체크포인트 & 되감기
Claude가 자동으로 체크포인트를 생성합니다. 문제가 발생하면 /rewind를 사용하여 이전 상태로 돌아가세요.
Claude Code 최신 기능
⚡에이전트 팀
공유 태스크 리스트와 메일박스로 병렬 에이전트 팀 실행
🔀백그라운드 서브에이전트
Ctrl+B로 백그라운드에서 에이전트 실행, 나중에 결과 확인
🎯MCP 도구 검색
자동 지연 MCP 도구로 컨텍스트 윈도우 공간 절약
⌨️커스텀 단축키
/keybindings로 모든 키보드 단축키 커스터마이즈
🌐데스크톱 & 웹
macOS/Windows용 데스크톱 앱과 claude.ai/code의 웹
📋Worktree 격리
--worktree 플래그로 격리된 git worktree에서 에이전트 실행
CLI 플래그 & 옵션
Claude Code 동작을 커스터마이즈하기 위한 CLI 플래그와 옵션 전체 목록.
모델 & 실행 플래그
--model (-m): 모델 선택. --effort: 사고 강도 설정. --max-turns: 턴 제한. --max-budget-usd: 비용 상한 설정. --agent: 서브에이전트 사용.
시스템 프롬프트 & 출력 플래그
--system-prompt: 프롬프트 오버라이드. --output-format (text/json/stream-json): 출력 제어. --json-schema: JSON 검증.
도구 & 세션 플래그
--allowedTools/--disallowedTools: 도구 제어. --worktree: Git 격리. --chrome: Chrome 통합. --plugin-dir: 플러그인 로드.
실전 명령어 예제
탐색
claude> 이 프로젝트의 전체 구조를 분석해줘claude> API 엔드포인트를 문서화해줘개발
claude> 사용자 프로필 편집 기능을 추가해줘claude> 모든 테스트를 실행하고 실패 원인을 분석해줘CLI 팁
구체적으로 요청하세요
'에러 수정해줘' 대신 'user.tsx의 handleSubmit 함수에서 발생하는 null 참조 에러를 수정해줘'라고 말하세요.
플랜 모드를 먼저 사용하세요
Shift+Tab을 눌러 플랜 모드를 활성화하세요. Claude가 변경하기 전에 먼저 탐색하고 계획하도록 하세요.
컨텍스트를 관리하세요
/clear로 새로 시작, /compact로 압축, /btw로 곁다리 질문. CLAUDE.md는 짧고 구체적으로 유지하세요.