Claude Code CLI 명령어: 전체 치트 시트 (2026)

Claude Code CLI 명령어: 2026년 필독 치트 시트

Claude Code는 터미널과 코드베이스 내에서 직접 Claude와 상호작용할 수 있는 Anthropic의 공식 명령줄 인터페이스(CLI)입니다. 코드 생성, 디버깅, 리팩토링, 또는 전체 기능 개발 등 어떤 용도로 사용하든, 생산성을 극대화하기 위해서는 CLI 명령어와 플래그를 숙지하는 것이 필수적입니다.

본 치트 시트는 2026년 초 기준으로 Claude Code에서 사용 가능한 모든 주요 명령어, 슬래시 명령어, 플래그 및 구성 옵션을 다룹니다.

설치 (Installation)

npm을 통해 Claude Code를 전역으로 설치합니다:

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

설치 확인:

claude --version

최신 버전으로 업데이트:

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

기본 사용법 (Basic Usage)

어느 디렉토리에서든 대화형(interactive) 모드로 Claude Code를 실행합니다:

claude

대화형 모드로 들어가지 않고 일회성 프롬프트를 보냅니다:

claude "explain what this project does"

입력을 Claude Code로 파이프(pipe) 전달합니다:

cat error.log | claude "explain this error and suggest a fix"

가장 최근 대화를 재개합니다:

claude --resume

CLI 플래그 참조 (CLI Flags Reference)

플래그	약축형	설명
--version	-v	설치된 버전 출력
--help	-h	도움말 정보 표시
--resume	-r	가장 최근 대화 재개
--continue	-c	마지막 대화 이어서 진행
--print	-p	출력 모드: 대화형 세션 없이 응답만 출력
--model	-m	사용할 모델 지정
--output-format		출력 형식 설정: text, json, stream-json
--max-turns		에이전트의 최대 턴(turn) 수 제한
--system-prompt		사용자 정의 시스템 프롬프트 제공
--allowedTools		사용 가능한 도구 제한
--disallowedTools		특정 도구 제외
--mcp-config		MCP 서버 설정 파일 경로
--permission-mode		권한 모드 설정: default, plan, auto-edit
--verbose		자세한 로깅 출력 활성화
--dangerously-skip-permissions		모든 권한 확인 프롬프트 건너뛰기 (주의해서 사용)

플래그 사용 예시

특정 모델을 사용하여 출력 모드로 Claude 실행:

claude -p -m claude-sonnet-4 "write a Python function to parse CSV files"

무한 루프 방지를 위해 에이전트 턴 제한:

claude --max-turns 5 "refactor the auth module"

스크립트 작업을 위해 JSON 출력 사용:

claude -p --output-format json "list all TODO comments in this project"

사용자 정의 시스템 프롬프트로 실행:

claude --system-prompt "You are a security auditor. Review code for vulnerabilities." "audit src/"

슬래시 명령어 (Interactive Mode)

대화형 Claude Code 세션 내부에서는 슬래시 명령어를 사용할 수 있습니다:

명령어	설명
/help	사용 가능한 명령어 및 사용법 정보 표시
/clear	대화 기록을 지우고 새로 시작
/compact	컨텍스트 창을 절약하기 위해 대화 요약/압축
/config	구성 설정 보기 또는 수정
/cost	현재 세션의 토큰 사용량 및 예상 비용 표시
/doctor	구성 문제를 확인하기 위한 진단 실행
/init	현재 프로젝트에 CLAUDE.md 파일 초기화
/login	Anthropic 계정으로 인증
/logout	현재 세션 로그아웃
/mcp	MCP 서버 연결 확인 또는 관리
/model	대화 도중 활성 모델 전환
/permissions	도구 권한 보기 또는 수정
/review	스테이징된 변경 사항에 대한 코드 리뷰 요청
/status	현재 세션 상태 및 구성 표시
/terminal-setup	터미널 통합 설정 (키 바인딩, 셸)
/vim	vim 키 바인딩 모드 토글

CLAUDE.md 파일

Claude Code는 프로젝트 루트의 CLAUDE.md 파일을 읽어 프로젝트 고유의 컨텍스트를 이해합니다. 다음 명령어로 초기화할 수 있습니다:

claude /init

또는 직접 생성할 수 있습니다. 일반적인 CLAUDE.md의 내용은 다음과 같습니다:

# Project Overview
이 프로젝트는 TypeScript와 Tailwind CSS를 사용하는 Next.js 14 애플리케이션입니다.

# Tech Stack
- Framework: Next.js 14 (App Router)
- Language: TypeScript
- Styling: Tailwind CSS + shadcn/ui
- Database: PostgreSQL via Prisma
- Auth: NextAuth.js v5

# Coding Conventions
- hook을 사용하는 함수형 컴포넌트 사용
- Named export 선호
- @/ 접두사를 사용한 절대 경로 import 사용
- Vitest로 테스트 작성

# File Structure
- src/app/ - Next.js app router 페이지
- src/components/ - 재사용 가능한 UI 컴포넌트
- src/lib/ - 유틸리티 함수 및 공통 로직
- prisma/ - 데이터베이스 스키마 및 마이그레이션

구성 (Configuration)

현재 구성을 확인합니다:

claude /config

설정은 ~/.claude/에 저장되며 다음을 포함합니다:

파일	용도
~/.claude/settings.json	글로벌 사용자 설정
~/.claude/mcp_servers.json	MCP 서버 구성
.claude/settings.json	프로젝트 레벨 설정 (저장소에 커밋 가능)
CLAUDE.md	프로젝트 컨텍스트 파일
~/.claude/CLAUDE.md	글로벌 컨텍스트 파일 (모든 프로젝트에 적용)

권한 모드 (Permission Modes)

Claude Code에는 AI의 자율성을 제어하는 세 가지 권한 모드가 있습니다:

모드	동작
default	파일 쓰기 및 명령어 실행 시 권한을 요청함
plan	읽기 전용 모드; Claude가 분석은 할 수 있지만 파일 수정은 불가
auto-edit	파일 수정은 자동으로 승인하되, 명령어 실행은 여전히 요청함

실행 시 모드를 설정할 수 있습니다:

claude --permission-mode plan "analyze the architecture of this project"

또는 .claude/settings.json에서 특정 도구 권한을 구성할 수 있습니다:

{
  "permissions": {
    "allow": [
      "Read",
      "Glob",
      "Grep",
      "Bash(npm test)",
      "Bash(npm run lint)"
    ],
    "deny": [
      "Bash(rm *)",
      "Bash(git push)"
    ]
  }
}

MCP 서버 관리

연결된 MCP 서버 목록 확인:

claude /mcp

~/.claude/mcp_servers.json 설정 파일을 통해 MCP 서버를 추가합니다:

{
  "github": {
    "command": "npx",
    "args": ["@anthropic/mcp-server-github"],
    "env": {
      "GITHUB_TOKEN": "ghp_xxxxxxxxxxxx"
    }
  }
}

유용한 패턴 및 워크플로우

커밋 전 빠른 코드 리뷰:

git diff --staged | claude -p "review these changes for bugs and suggest improvements"

커밋 메시지 생성:

git diff --staged | claude -p "write a concise commit message for these changes"

생소한 코드베이스 설명:

claude "give me a high-level overview of this project's architecture"

테스트 실행 및 오류 수정:

claude "run the test suite and fix any failing tests"

스크립트를 이용한 일괄 처리:

for file in src/components/*.tsx; do
  claude -p "add JSDoc comments to all exported functions" < "$file"
done

키보드 단축키 (Interactive Mode)

단축키	동작
Ctrl+C	현재 생성 취소
Ctrl+D	Claude Code 종료
Up Arrow	프롬프트 기록 탐색
Tab	자동 완성 제안 수락
Esc	한 줄 입력과 여러 줄 입력 모드 간 전환
Shift+Tab	현재 제안 거절

비용 모니터링

세션 동안의 지출을 추적합니다:

/cost

다음을 표시합니다:

• 소비된 총 입력 토큰
• 생성된 총 출력 토큰
• USD 환산 예상 비용
• 캐시 히트율 (반복되는 컨텍스트의 경우)

문제 해결 (Troubleshooting)

Claude Code가 CLAUDE.md를 읽지 못하는 경우: 파일이 작업 디렉토리의 루트에 있는지 확인하세요. Claude Code는 현재 디렉토리와 상위 디렉토리에서 CLAUDE.md를 찾습니다.

MCP 서버 연결 실패: MCP 설정에 지정된 명령어가 PATH에 있는지 확인하세요. 명령어를 수동으로 실행하여 작동 여부를 확인해 보세요.

높은 토큰 사용량: 대화 기록을 압축하려면 정기적으로 /compact를 사용하세요. 이는 컨텍스트 창 사용량과 비용을 줄여줍니다.

권한 거부 오류: .claude/settings.json의 권한 구성을 확인하세요. 허용 목록(allow list)에 특정 도구를 추가해야 할 수도 있습니다.

결론

Claude Code는 2026년 기준 가장 강력한 AI 코딩 어시스턴트 중 하나이며, CLI 명령어를 마스터하면 AI 기반 개발 워크플로우를 완벽하게 제어할 수 있습니다. 빠른 참조를 위해 이 치트 시트를 북마크해 두세요.

이미지, 비디오, 오디오 또는 말하는 아바타와 같은 AI 미디어 생성이 필요한 애플리케이션을 빌드하고 있다면 Hypereal AI를 확인해 보세요. Hypereal은 종량제 요금제, 빠른 생성 시간, 그리고 Flux, Kling, Wan 2.2와 같은 최신 모델에 대한 접근을 제공하는 통합 API를 지원합니다.