Claude Code CLI 치트시트

터미널에서 쓰는 본체. 설치·플래그·권한·훅·자동화. · 전체 내용은 https://github.com/bellx3/claude-code-cheat-sheet 배포본 /ref/cli/
생성 2026-08-20 · 3ac0537
항목 120 / 195
출력: A3 가로 · 여백 최소 · 배경 그래픽 켜기

설치

claude auth login로그인
claude auth status인증 상태 확인
claude auth logout로그아웃
claude doctor설정 진단·문제 해결

CLI 명령어 전체 참조

claude대화형 세션 시작
claude "query"프롬프트와 함께 시작
claude -p "query"프린트 모드: 실행 후 종료
cat f | claude -p "q"파이프 콘텐츠 처리
claude -c / --continue최근 대화 이어가기
claude -r "<s>" "query"세션 ID·이름으로 재개
claude -n <name>세션 표시 이름 지정
claude --from-pr <PR>PR 연결 세션 재개
claude update최신 버전 업데이트
claude install [version]네이티브 바이너리 설치
claude setup-token장기 OAuth 토큰 생성
claude mcpMCP 서버 구성

CLI 플래그 전체 참조

--model세션 모델 지정
--effort추론 강도 설정
--add-dir파일 접근용 작업 디렉토리 추가
--allowedTools확인 없이 도구 허용
--disallowedTools특정 도구 금지
--output-format출력 형식 지정
--input-format입력 형식 지정
--max-turns에이전트 턴 수 제한
--verbose상세 로그 활성화
--continue / --resume세션 이어가기 / 재개
--from-prPR 연결 세션 재개
--fork-session세션을 복사해 분기 후 재개
--dangerously-skip-permissions모든 권한 확인 생략

슬래시 명령어 전체 참조

/help도움말 표시
/init코드베이스 분석해 CLAUDE.md 생성/개선
/exitCLI 종료(별칭 /quit · 백그라운드는 분리)
/clear [name]새 대화 시작
/compact [지시]대화 요약, 컨텍스트 확보
/context [all]컨텍스트 사용량 표시
/config설정 패널 열기
/status세션 상태·진행 작업 표시
/doctor설정 진단 및 문제 해결
/usage, /cost토큰 사용량·비용 표시
/model [model]세션 내 모델 변경
/effort [level|auto]추론 강도 조정
/resume다른 대화로 돌아가기
/rename [name]현재 세션 이름 변경
/branch [name]현재 지점에서 대화 분기
/export [filename]대화를 텍스트로 내보내기
/diff변경사항 대화형 뷰어
/ideIDE 연동 관리·상태 표시
/mcpMCP 서버 연결 관리

키보드 단축키

Ctrl+C중단 (2회=종료)
Ctrl+DClaude Code 종료
Ctrl+O트랜스크립트 뷰어 토글
Ctrl+R명령어 히스토리 역검색
Ctrl+T작업(task) 목록 토글
Ctrl+B실행 중 작업을 백그라운드로 (tmux는 2회)
Ctrl+X Ctrl+K백그라운드 서브에이전트 전부 중단 (3초 내 2회)
Ctrl+S프롬프트 보관 · 빈 입력에서 다시 누르면 복원
Ctrl+V / Alt+V클립보드 이미지 붙여넣기
Ctrl+L화면 다시 그리기 (풀스크린에서 2회=/clear)
Ctrl+Z프로세스 일시 중지 (Unix, fg 로 복귀)
Ctrl+G프롬프트/응답을 기본 편집기로 열기
Esc응답·도구 호출 중단, 대화상자 닫기
Esc Esc초안 삭제, 비어있으면 되돌리기
Shift+Tab권한 모드 순환 전환
Alt+P / Option+P모델 전환
Alt+T / Option+T확장 사고 토글
Alt+O / Option+O패스트 모드 토글
@파일 경로 언급 자동완성
!셸 모드 진입

권한 모드 (Shift+Tab)

default (Manual)읽기만 자동 승인. 쓰기·실행은 매번 물어본다.
acceptEdits파일 편집·기본 파일시스템 명령을 자동 승인한다.
plan읽기 전용 탐색만 하고, 편집 전에 계획을 먼저 내놓는다.
auto분류기가 위험도를 판정해 대부분의 도구 호출을 자동 승인한다.
dontAsk사전 승인된 도구만 실행하고 나머지는 그냥 실패시킨다. CI용.
bypassPermissions모든 검사를 생략한다. 격리 환경 전용.
[주의] 2026-08-14부터 Pro/Max/Team 신규 세션 기본값이 auto 모드로 전환

샌드박싱

[주의] 네이티브 Windows 미지원 — WSL2 필요

신규 플래그 확장판

--permission-mode <mode>시작 권한 모드 지정
--agent / --agents세션 에이전트 지정/JSON 정의
--safe-mode커스터마이제이션 전체 비활성화
--bare훅·스킬·플러그인·MCP 생략
--settings <path|json>설정 파일/인라인 JSON 지정
--autocompact <auto|tokens>자동 컴팩트 기준 설정
--fallback-model <목록>과부하 시 폴백 모델
--max-budget-usd <금액>지출 상한 (프린트 모드)
--system-prompt[-file]시스템 프롬프트 교체/추가
--mcp-config / --plugin-dirMCP·플러그인 로컬 로드

신규/고급 슬래시 명령어

/rewind [turn#]코드+대화 체크포인트 롤백
/agents서브에이전트 관리
/sandbox격리 환경에서 실행
/permissions도구 권한 규칙 관리
/plan계획 모드 진입
/code-review, /review현재 diff·PR 검토
/security-reviewdiff 보안 취약점 검사
/background, /bg세션을 백그라운드로 분리
/tasks백그라운드 작업 목록
/fork대화를 새 백그라운드 세션으로 복사
/loop프롬프트 반복 실행
/goal완료 조건 설정 후 자동 진행
/recap세션 한 줄 요약
/insights세션 사용 패턴 분석

모델 & 추론 설정

--model sonnet/opus/haiku/fable별칭 전체: default, best, fable, sonnet, opus, haiku, sonnet[1m], opus[1m], opusplan
--model claude-sonnet-5특정 모델 버전 지정
--effort <level>low, medium, high, xhigh, max — 기본 high, max 는 세션 한정
--advisor opus어드바이저 모델 활성화
/model, /effort세션 내 변경

디렉토리 관리

--add-dir ../apps ../lib추가 작업 디렉토리 등록
--add-dir /path/to/project디렉토리 경로 유효성 확인
--add-dir ../fe ../be ../shared여러 디렉토리 동시 접근

출력/입력 형식

--output-format jsonJSON 출력 (스크립팅용)
--output-format stream-json실시간 처리용 스트림
--input-format stream-json프린트 모드 입력 형식
--json-schema '<schema>'스키마 검증된 JSON 출력
-p --max-turns 1 "질의"배치/1회성 처리

세션 제어 & 비용

-p --max-turns 3프린트 모드 턴 수 제한
--max-budget-usd 5.00지출 상한 설정
--verbose상세 로그 출력
/usage, /cost토큰 사용량·비용 표시

MCP & 고급 파이프라인

claude mcpMCP 서버 설정
claude mcp login/logout <s>MCP OAuth 로그인/해제
/mcpMCP 기능 접근