Claude Code 치트시트: 명령어, 설정, 단축키

모든 CLI 플래그, 슬래시 명령어, 키보드 단축키, 설정 키, 훅 이벤트, 환경 변수를 한곳에 모았습니다. 자세한 설명은 Claude Code 전체 가이드를 참고하세요. 처음 설정하시는 경우 퀵스타트를 참고하세요.

1. 설치

선호 순서대로 3가지 설치 방법입니다.

# Native binary (recommended)
curl -fsSL https://claude.ai/install.sh | bash

# Homebrew (macOS)
brew install --cask claude-code

# NPM (deprecated — migrate with `claude install`)
npm install -g @anthropic-ai/claude-code

특정 버전을 설치하세요:

curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

설치를 확인하세요:

claude doctor

인증하세요:

claude auth login       # Log in or switch accounts
claude auth status      # Check current auth state
claude auth logout      # Clear stored credentials

2. CLI 플래그

3. Slash Commands

사용자 지정 명령: .claude/commands/my-command.md(프로젝트) 또는 ~/.claude/commands/my-command.md(개인)를 만들고 /my-command로 호출하세요. 명령은 설명, 허용 도구, 모델 재정의, $ARGUMENTS 또는 위치 기반 $1, $2를 통한 인수 보간을 위해 YAML frontmatter를 지원합니다.

---
description: Fix a GitHub issue
allowed-tools: Read, Edit, Bash(git:*)
model: opus
argument-hint: [issue-number]
---

Fix GitHub issue #$ARGUMENTS following our coding standards.

사용법: /fix-issue 123

4. 키보드 단축키

일반 제어

빠른 접두사

여러 줄 입력

키 바인딩은 /keybindings로 사용자 지정할 수 있습니다(~/.claude/keybindings.json에 저장됨).

5. 설정 파일

우선순위 계층(높음에서 낮음)

첫 번째로 일치하는 설정이 적용됩니다. Enterprise 설정은 우회할 수 없습니다.

6. Settings.json 참조

주요 설정의 타입과 예시입니다. 위 계층 구조에 있는 어떤 설정 파일에든 넣을 수 있습니다.

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "claude-sonnet-4-6",
  "permissions": {
    "allow": ["Read", "Glob", "Grep", "Bash(npm run:*)", "Bash(git:*)", "Edit(src/**)"],
    "deny": ["Read(.env*)", "Bash(rm -rf:*)", "Bash(sudo:*)"],
    "ask": ["WebFetch", "Bash(docker:*)"],
    "defaultMode": "acceptEdits",
    "additionalDirectories": ["../shared-lib"]
  },
  "env": {
    "NODE_ENV": "development"
  },
  "hooks": {},
  "sandbox": {
    "enabled": false,
    "autoAllowBashIfSandboxed": true
  },
  "includeCoAuthoredBy": true,
  "cleanupPeriodDays": 30,
  "respectGitignore": true,
  "showTurnDuration": true,
  "language": "en",
  "autoMemoryDirectory": ".claude/memory",
  "plansDirectory": ".claude/plans"
}

권한 규칙 구문: Tool(pattern:*)은 접두사 매칭을 제공합니다. Bash(npm run test:*)는 npm run test, npm run test:unit 등을 허용합니다. 파일 패턴은 glob 구문을 사용합니다: Edit(src/**).

새 키(v2.1.118+):

전체 설정 스키마는 전체 가이드의 Configuration Deep Dive를 참고하세요.

7. CLAUDE.md 빠른 참조

CLAUDE.md는 프로젝트의 지침 파일입니다. Claude는 모든 세션을 시작할 때 이 파일을 읽습니다.

위치:

포함할 내용:

# Project Name

## Stack
- Backend: FastAPI, Python 3.11+
- Frontend: HTMX + Alpine.js + Bootstrap 5

## Commands
- Dev: `uvicorn app.main:app --reload --port 8000`
- Test: `python -m pytest -v`
- Lint: `ruff check .`

## Conventions
- Conventional commits: feat:, fix:, docs:, refactor:
- Never force push to main
- Always activate venv before Python commands

## Key Files
- app/main.py — FastAPI app and routes
- app/models.py — SQLAlchemy models

훑어보기 쉽게 유지하세요. 빽빽한 설명문은 매 세션마다 context 토큰을 낭비합니다. 글머리 기호, 표, 짧은 코드 블록을 사용하세요. 긴 문단은 피하세요. Claude는 모든 세션을 시작할 때 CLAUDE.md를 읽기 때문에, 단어 하나하나가 context 비용이 됩니다.

전문가 팁: - CLAUDE.md를 직접 편집하지 않고 REPL에서 # 접두사를 사용해 auto-memory에 항목을 추가할 수 있습니다: # Always use TypeScript strict mode - 하위 디렉터리의 CLAUDE.md는 Claude가 해당 디렉터리의 파일을 읽을 때 로드됩니다 - 팀 공유 규칙은 모듈식 구성을 위해 .claude/rules/*.md에 넣으세요

8. 권한 모드

Auto Mode(v2.1.85+)는 --dangerously-skip-permissions를 대체하는 권장 방식입니다. 읽기 전용 작업과 파일 편집은 자동 승인됩니다. 사용자 지정 허용/거부 규칙이 먼저 적용됩니다. 그 밖의 모든 작업은 안전 분류기로 전달됩니다. 기본적으로 자동 차단되는 항목은 curl | bash, main으로 force-push, 프로덕션 배포, 대량 클라우드 삭제, IAM 변경, 민감한 데이터의 외부 전송입니다.¹

서킷 브레이커: 한 세션에서 연속 3회 차단되거나 총 20회 차단되면 수동 확인 모드로 일시 중지됩니다.

# Enable at startup
claude --enable-auto-mode

# Cycle during session
Shift+Tab    # default -> acceptEdits -> auto -> plan

PowerShell 자동 승인(v2.1.119+): PowerShell tool 명령은 Bash 명령과 같은 방식으로 permission mode에서 자동 승인됩니다. PowerShell(Get-*:*) 같은 허용 규칙은 읽기 전용 작업의 확인 요청을 건너뜁니다.

9. Hook 이벤트

| InstructionsLoaded | CLAUDE.md가 로드될 때 | 아니요 | | ConfigChange | 세션 중 config 파일이 변경될 때 | 예 | | WorktreeCreate | Worktree가 생성될 때 | 예 | | WorktreeRemove | Worktree가 제거될 때 | 아니요 | | PreCompact | context 압축 전 | 아니요 | | PostCompact | context 압축 후 | 아니요 | | Elicitation | MCP가 구조화된 입력을 요청할 때 | 예 | | ElicitationResult | 사용자가 MCP dialog에 응답할 때 | 예 | | StopFailure | API 오류로 turn이 끝날 때 | 아니요 | | PermissionRequest | 권한 dialog가 표시될 때 | 예 | | PermissionDenied | Auto mode가 작업을 거부할 때(v2.1.88+) | 아니요 | | CwdChanged | 작업 디렉터리가 변경될 때(v2.1.83+) | 아니요 | | FileChanged | 감시 중인 파일이 외부에서 수정될 때(v2.1.83+) | 아니요 | | TaskCreated | 새 task가 생성될 때(v2.1.84+) | 아니요 | | TeammateIdle | Agent 팀원이 유휴 상태가 될 때 | 예 | | TaskCompleted | Task가 완료로 표시될 때 | 예 |

전체 hook 프로토콜(입출력 JSON, matcher, exit code)은 전체 가이드의 Hooks Deep Dive를 참고하세요.

10. Hook 설정

Hook은 settings.json 또는 전용 hooks.json에 둡니다. 최소 예시는 다음과 같습니다.

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write \"$FILE_PATH\""
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/validate-bash.sh"
          }
        ]
      }
    ]
  }
}

Matcher 문법:

Exit code:

Async hook은 차단하지 않고 백그라운드에서 실행됩니다. hook 객체에 "async": true를 추가하세요.²

Hook 출력 / 입력 필드:

• PostToolUse / PostToolUseFailure hook 입력의 duration_ms(v2.1.119+) — 권한 확인 요청과 PreToolUse hook을 제외한 tool 실행 시간입니다.
• hookSpecificOutput.updatedToolOutput(v2.1.121+) — 모든 tool의 출력을 대체합니다(v2.1.118에서는 MCP 전용으로 도입되었고, v2.1.121에서 모든 tool로 확장되었습니다).
• hookSpecificOutput.sessionTitle(v2.1.96+) — UserPromptSubmit hook에서 세션 제목을 설정합니다.
• command hook의 args: string[](v2.1.139+) — shell quoting 없이 구조화된 argv를 전달합니다.
• PostToolUse hook의 continueOnBlock(v2.1.139+) — 차단 이유를 Claude에 다시 전달하고 turn을 계속 진행합니다.
• agent hook 입력의 subagent_type(v2.1.140+) — 실행 중인 agent type을 식별합니다.

11. MCP 빠른 설정

하나의 명령으로 MCP server를 추가하세요.

# Remote HTTP server (recommended)
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

# Remote with auth header
claude mcp add --transport http api https://api.example.com/mcp \
  --header "Authorization: Bearer $TOKEN"

# Local stdio server
claude mcp add --transport stdio postgres \
  --env "DATABASE_URL=postgresql://user:pass@localhost/db" \
  -- npx -y @anthropic-ai/mcp-server-postgres

범위 제어:

claude mcp add --scope project ...   # Team-shared (.mcp.json)
claude mcp add --scope user ...      # Personal (~/.claude.json)

Project .mcp.json 예시:

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "database": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-server-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@localhost/db"
      }
    }
  }
}

MCP는 이제 월간 다운로드 1억 건과 3,000개 이상의 색인된 server를 보유하고 있습니다.³ transport type, elicitation, tool search 설정은 전체 가이드의 MCP 섹션을 참고하세요.

alwaysLoad(v2.1.121+): 신뢰할 수 있는 server를 Tool Search 지연 로딩에서 제외합니다. 모든 tool이 세션 시작 시 로드되며 ToolSearch 왕복이 없습니다.

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "alwaysLoad": true
    }
  }
}

Auto-retry(v2.1.121+): 시작 중 오류가 발생한 MCP server는 연결 해제로 표시되기 전까지 최대 3번 재시도됩니다.

SDK mcp_authenticate redirectUri(v2.1.121+): 사용자 지정 URI scheme에서 OAuth를 완료하는 데 필요합니다. desktop app과 claude.ai connector flow에 해당합니다.

11.5. Plugin CLI 명령

12. Subagent 유형

Claude은 자동으로 subagents에 위임합니다. 직접 요청할 수도 있습니다:

> Use the explore agent to find all auth-related files
> Have a subagent analyze the database schema

Custom subagents는 .claude/agents/(프로젝트) 또는 ~/.claude/agents/(개인)에 YAML frontmatter가 포함된 markdown 파일로 정의합니다. 최대 10개의 subagents를 병렬로 실행할 수 있습니다.⁴

claude agents는 현재 릴리스에서 Agent View를 엽니다. 실행 중, 차단됨, 완료된 Claude Code 세션을 위한 research-preview 운영 화면입니다. 모니터링용으로 사용하고, 작업이 품질 기준을 통과했다는 증거로 보지는 마세요.⁶

Custom agent frontmatter 필드:

Custom agent 예시 (.claude/agents/security-reviewer.md):

---
name: security-reviewer
description: Expert security code reviewer. Use PROACTIVELY after code changes to auth or data handling.
tools: Read, Grep, Glob, Bash
model: opus
permissionMode: plan
---

You are a senior security engineer. Analyze for OWASP Top 10 vulnerabilities,
secrets, hardcoded credentials, and SQL injection. Report findings with severity
levels and remediation steps.

13. 환경 변수

인증 및 API

모델 설정

Cloud Providers

동작 제어

Tool 설정

네트워크 및 Proxy

전체 목록은 전체 가이드의 Environment Variables를 참고하세요.

14. 비용 참고 자료

1백만 tokens당 가격(2026년 4월 기준).⁵

일반적인 세션은 입력 tokens 50K-200K, 출력 tokens 10K-50K를 소비합니다. Haiku 세션: $0.10-$0.45. Opus 세션: $0.50-$2.25.

Plan별 기본 모델(2026년 4월 16일 기준 Claude Code):

• Max, Team Premium → Opus 4.7
• Pro, Team Standard, Enterprise, Anthropic API → Sonnet 4.6(Enterprise + API는 2026년 4월 23일에 Opus 4.7로 전환)
• Bedrock, Vertex, Foundry → Sonnet 4.5(ANTHROPIC_DEFAULT_OPUS_MODEL로 더 최신 버전 고정)

Opus 4.7에는 Claude Code v2.1.111 이상이 필요합니다. adaptive reasoning만 사용합니다(고정 thinking budgets 없음). 새로운 xhigh effort level은 Opus 4.7의 coding/agentic workloads에서 기본값입니다.

세션 중 모델 전환:

/model opus       # Switch to Opus (resolves to 4.7 on API, 4.6 on Bedrock/Vertex/Foundry)
/model sonnet     # Switch to Sonnet 4.6
/model haiku      # Switch to Haiku 4.5
/effort xhigh     # Opus 4.7 only — recommended for coding/agentic

판단 기준: 단순 탐색은 Haiku로 보냅니다. 비용에 민감한 일상 coding은 Sonnet을 사용합니다. 어려운 추론, 아키텍처, agentic loops, 보안 분석은 Opus를 사용합니다. 복잡한 refactoring에는 opusplan을 사용하세요(Opus가 계획하고, Sonnet이 실행).

15. 주요 파일 위치

16. 변경 기록

17. 참고 자료

이 cheat sheet는 전체 Claude Code CLI guide를 빠르게 찾아보기 위한 companion입니다. 설정 walkthrough는 Claude Code quickstart를 참고하세요. iOS 및 macOS 프로젝트의 경우 iOS Agent Development guide, XcodeBuildMCP integration patterns, Apple Ecosystem Series를 참고하세요. 마지막 업데이트: 2026년 5월 13일.