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 --version

인증합니다.

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 tokens를 낭비합니다. 글머리 기호, 표, 짧은 코드 블록을 사용하세요. 긴 문단은 피하세요. 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를 대체하는 권장 방식입니다. 읽기 전용 작업과 파일 편집은 자동 승인됩니다. 사용자 지정 allow/deny 규칙이 먼저 적용됩니다. 그 외 모든 작업은 safety classifier로 전달됩니다. 기본적으로 자동 차단되는 항목은 curl | bash, main에 force-push, production 배포, 대량 cloud 삭제, IAM 변경, 민감한 데이터의 외부 전송입니다.¹

Circuit breaker: 한 세션에서 연속 3회 차단되거나 총 20회 차단되면 수동 프롬프트로 되돌아갑니다.

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

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

PowerShell 자동 승인 (v2.1.119+): PowerShell tool commands는 Bash commands와 같은 방식으로 권한 모드에서 자동 승인됩니다. PowerShell(Get-*:*) 같은 allow 규칙은 읽기 전용 작업의 프롬프트를 우회합니다. PowerShell 중심 workflow에서는 v2.1.149+를 사용하세요. 이 버전은 기본 제공 cd 권한 우회, 접두사/와일드카드 allow-rule 매칭, 오래된 디렉터리 변수 추적 문제를 수정합니다.

9. Hook 이벤트

| InstructionsLoaded | CLAUDE.md가 로드될 때 | 아니요 | | ConfigChange | 세션 중간에 config 파일이 변경될 때 | 예 | | WorktreeCreate | worktree가 생성되는 중 | 예 | | WorktreeRemove | worktree가 제거되는 중 | 아니요 | | PreCompact | context compaction 전 | 아니요 | | PostCompact | context compaction 후 | 아니요 | | 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 protocol(input/output JSON, matchers, exit codes)은 전체 가이드의 Hooks Deep Dive를 참고하세요.

10. Hook 설정

Hooks는 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 codes:

Async hooks는 차단 없이 백그라운드에서 실행됩니다. hook object에 "async": true를 추가하세요.²

Hook output / input fields:

• duration_ms: PostToolUse / PostToolUseFailure hook input에 포함됩니다 (v2.1.119+) — 권한 프롬프트와 PreToolUse hooks를 제외한 tool 실행 시간입니다.
• hookSpecificOutput.updatedToolOutput (v2.1.121+) — 모든 tool의 tool output을 대체합니다 (v2.1.118에서는 MCP에만 도입되었고, v2.1.121에서 모든 tools로 확장되었습니다).
• hookSpecificOutput.sessionTitle (v2.1.96+) — UserPromptSubmit hook에서 session title을 설정합니다.
• args: string[]: command hooks에 포함됩니다 (v2.1.139+) — shell quoting 없이 구조화된 argv를 전달합니다.
• continueOnBlock: PostToolUse hooks에 포함됩니다 (v2.1.139+) — 차단 이유를 Claude에 다시 전달하고 turn을 계속합니다.
• subagent_type: agent hook input에 포함됩니다 (v2.1.140+) — 실행 중인 agent type을 식별합니다.
• terminalSequence: hook JSON output에 포함됩니다 (v2.1.141+) — 알림, 창 제목, 벨을 위한 terminal-control sequences를 내보냅니다.

11. MCP 빠른 설정

한 명령으로 MCP 서버를 추가하세요.

# 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)

프로젝트 .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개 이상의 색인된 서버를 보유하고 있습니다.³ 전송 유형, elicitation, tool search 설정은 전체 가이드의 MCP 섹션을 참고하세요.

alwaysLoad (v2.1.121+): 신뢰할 수 있는 서버를 Tool Search 지연 대상에서 제외합니다. 해당 서버의 모든 도구는 세션 시작 시 로드되며, ToolSearch 왕복이 필요 없습니다.

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

자동 재시도 (v2.1.121+): 시작 중 오류가 발생한 MCP 서버는 연결 해제로 표시되기 전에 최대 3번 재시도됩니다.

SDK mcp_authenticate redirectUri (v2.1.121+): 사용자 지정 URI 스킴에서 OAuth을 완료할 때 필요합니다. 데스크톱 앱과 claude.ai connector 흐름에 사용됩니다.

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를 엽니다. Agent View는 실행 중, 차단됨, 완료됨 상태의 Claude Code 세션을 다루는 research-preview 운영 화면입니다. claude agents --cwd <path>는 보기를 하나의 디렉터리로 제한합니다(v2.1.141+). v2.1.142는 background 세션용 dispatch flags를 추가하고, v2.1.143은 이 flags를 dashboard와 background 세션에 일관되게 적용합니다: --add-dir, --settings, --mcp-config, --plugin-dir, --permission-mode, --model, --effort, --dangerously-skip-permissions. v2.1.144는 background 세션에 /resume 지원을 추가하고 bg로 표시합니다. v2.1.145는 claude agents --json, 입력 대기 tab 수, Agent View reply-pane 수정을 추가합니다. v2.1.147은 유휴 상태에서도 유지되고 업데이트 시 제자리에서 다시 시작되는 pinned background 세션을 추가합니다. Agent View는 모니터링에 사용하세요. 작업이 품질 게이트를 통과했다는 증거로 사용해서는 안 됩니다.⁶

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

Model 설정

Cloud Providers

동작 제어

Tool 설정

네트워크 및 Proxy

전체 목록은 전체 가이드의 환경 변수를 참고하세요.

14. 비용 참고

토큰 100만 개당 가격입니다(2026년 4월 기준).⁵

일반적인 세션은 입력 토큰 50K-200K와 출력 토큰 10K-50K를 사용합니다. Haiku 세션: $0.10-$0.45. Opus 세션: $0.50-$2.25.

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

• 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 이상이 필요합니다. 고정 thinking budget 없이 adaptive reasoning만 사용합니다. 새로운 xhigh effort level은 Opus 4.7에서 코딩/agentic 워크로드의 기본값입니다.

세션 중 모델 전환:

/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를 사용하세요. 비용에 민감한 일상 코딩은 Sonnet을 사용하세요. 어려운 추론, 아키텍처, agentic loop, 보안 분석은 Opus를 사용하세요. 복잡한 리팩터링에는 opusplan을 사용하세요(Opus가 계획하고 Sonnet이 실행).

15. 주요 파일 위치

16. 변경 내역

17. 참고 자료

이 치트시트는 전체 Claude Code CLI 가이드의 빠른 조회용 보조 자료입니다. 설정 단계별 안내는 Claude Code 빠른 시작을 참고하세요. 특히 iOS와 macOS 프로젝트는 iOS Agent 개발 가이드, XcodeBuildMCP 통합 패턴, Apple Ecosystem Series를 참고하세요. 마지막 업데이트: 2026년 5월 24일.