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 플래그

v2.1.212에서 추가된 하위 명령어: claude auto-mode reset은 터미널에서 auto-mode 상태를 초기화합니다. 확인 메시지를 건너뛰려면 --yes를 전달하세요.⁷

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. 설정 파일

우선순위 체계(높은 순서부터)

가장 먼저 일치하는 설정이 적용됩니다. 엔터프라이즈 설정은 우회할 수 없습니다.

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.214부터 단일 세그먼트 dir/** 허용 규칙은 <cwd>/dir만 일치하며, 트리 내 모든 dir/과 일치하지 않아요. 깊이에 관계없이 일치시키려면 Edit(**/src/**)를 작성하세요. deny/ask 규칙은 깊이에 관계없이 일치하며, hook의 if: 조건에도 같은 cwd 범위가 적용돼요.

새 키(v2.1.118+):

전체 설정 스키마은 전체 가이드의 설정 심층 분석을 참고하세요.

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

빠르게 훑어볼 수 있도록 작성하세요. 빽빽한 산문은 세션마다 컨텍스트 토큰을 낭비해요. 글머리 기호, 표, 짧은 코드 블록을 사용하세요. 긴 문단은 피하세요. Claude은 모든 세션이 시작될 때 CLAUDE.md를 읽으므로 단어 하나하나가 컨텍스트를 차지해요.

유용한 팁: - CLAUDE.md를 편집하지 않고 REPL에서 # 접두사를 사용해 자동 메모리에 내용을 추가하세요: # Always use TypeScript strict mode - 하위 디렉터리의 CLAUDE.md는 Claude이 해당 디렉터리의 파일을 읽을 때 불러와요 - 팀 공유 규칙은 모듈식으로 구성할 수 있도록 .claude/rules/*.md에 저장하세요

8. 권한 모드

Auto Mode(v2.1.85+)는 --dangerously-skip-permissions 대신 사용하도록 권장되는 모드예요. 읽기 전용 작업과 파일 편집은 자동 승인돼요. 사용자 지정 허용 및 거부 규칙이 먼저 적용되고, 나머지는 모두 안전 분류기로 전달돼요. 기본적으로 자동 차단되는 작업은 curl | bash, main으로 강제 푸시, 프로덕션 배포, 대규모 클라우드 삭제, IAM 변경, 민감한 데이터의 외부 전송이에요.¹

회로 차단기: 연속 3회 또는 한 세션에서 총 20회 차단되면 수동 확인 모드로 일시 전환돼요.

# Enable at startup (--enable-auto-mode was removed in v2.1.111)
claude --permission-mode auto

# Cycle during session
Shift+Tab    # Manual (aka default) -> acceptEdits -> auto -> plan

PowerShell 자동 승인(v2.1.119+): 권한 모드에서 PowerShell 도구 명령은 Bash 명령과 같은 방식으로 자동 승인돼요. PowerShell(Get-*:*) 같은 허용 규칙을 사용하면 읽기 전용 작업에서 확인을 건너뛸 수 있어요. PowerShell을 많이 사용하는 워크플로에서는 v2.1.149 이상을 사용하세요. 기본 제공 cd의 권한 우회, 접두사 및 와일드카드 허용 규칙 일치, 오래된 디렉터리 변수 추적 문제가 수정되었어요.

9. Hook 이벤트

| InstructionsLoaded | CLAUDE.md를 불러왔을 때 | 아니요 | | ConfigChange | 세션 도중 설정 파일이 변경될 때 | 예 | | DirectoryAdded | /add-dir 또는 SDK register_repo_root가 세션 도중 작업 디렉터리를 추가할 때(v2.1.219+) | 아니요 | | WorktreeCreate | Worktree가 생성될 때 | 예 | | WorktreeRemove | Worktree가 제거될 때 | 아니요 | | PreCompact | 컨텍스트 압축 전 | 아니요 | | PostCompact | 컨텍스트 압축 후 | 아니요 | | Elicitation | MCP이 구조화된 입력을 요청할 때 | 예 | | ElicitationResult | 사용자가 MCP 대화 상자에 응답할 때 | 예 | | StopFailure | API 오류로 턴이 종료될 때 | 아니요 | | PermissionRequest | 권한 대화 상자가 표시될 때 | 예 | | PermissionDenied | Auto mode가 작업을 거부할 때(v2.1.88+) | 아니요 | | CwdChanged | 작업 디렉터리가 변경될 때(v2.1.83+) | 아니요 | | FileChanged | 감시 중인 파일이 외부에서 수정될 때(v2.1.83+) | 아니요 | | TaskCreated | 새 작업이 생성될 때(v2.1.84+) | 아니요 | | TeammateIdle | Agent 팀 구성원이 유휴 상태가 될 때 | 예 | | TaskCompleted | 작업이 완료로 표시될 때 | 예 |

전체 hook 프로토콜(입출력 JSON, 매처, 종료 코드)은 전체 가이드의 Hooks 심층 분석을 참고하세요.

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"
          }
        ]
      }
    ]
  }
}

매처 구문:

종료 코드:

비동기 hooks는 작업을 차단하지 않고 백그라운드에서 실행돼요. hook 객체에 "async": true를 추가하세요.²

Hook 출력 및 입력 필드:

• PostToolUse / PostToolUseFailure hook 입력의 duration_ms(v2.1.119+) — 권한 확인과 PreToolUse hooks를 제외한 도구 실행 시간이에요.
• hookSpecificOutput.updatedToolOutput(v2.1.121+) — 모든 도구의 출력을 대체해요. v2.1.118에서는 MCP에만 도입되었고, v2.1.121부터 모든 도구로 확장되었어요.
• hookSpecificOutput.sessionTitle(v2.1.96+) — UserPromptSubmit hook에서 세션 제목을 설정해요.
• 명령 hooks의 args: string[](v2.1.139+) — 셸 인용 없이 구조화된 argv를 전달해요.
• PostToolUse hooks의 continueOnBlock(v2.1.139+) — 차단 사유를 Claude에 다시 전달하고 턴을 계속 진행해요.
• Agent hook 입력의 subagent_type(v2.1.140+) — 실행 중인 agent 유형을 식별해요.
• Hook JSON 출력의 terminalSequence(v2.1.141+) — 알림, 창 제목, 벨을 위한 터미널 제어 시퀀스를 출력해요.

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, 도구 검색 설정에 관한 자세한 내용은 전체 가이드의 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 커넥터 흐름에 사용됩니다.

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

사용자 지정 subagents는 YAML frontmatter가 포함된 markdown 파일로 정의하며, 프로젝트에서는 .claude/agents/, 개인 설정에서는 ~/.claude/agents/에 저장합니다. 최대 10개의 subagents를 병렬로 실행할 수 있습니다.⁴

현재 릴리스에서 claude agents를 실행하면 Agent View가 열립니다. Agent View는 실행 중이거나 차단되었거나 완료된 Claude Code 세션을 관리하는 연구 프리뷰 화면입니다. claude agents --cwd <path>를 사용하면 하나의 디렉터리로 보기 범위를 제한할 수 있습니다 (v2.1.141+). v2.1.142에서는 백그라운드 세션용 디스패치 플래그가 추가되었고, v2.1.143에서는 --add-dir, --settings, --mcp-config, --plugin-dir, --permission-mode, --model, --effort, --dangerously-skip-permissions 플래그가 대시보드와 백그라운드 세션에 일관되게 적용됩니다. v2.1.144에서는 백그라운드 세션의 /resume 지원이 추가되고 해당 세션에 bg가 표시됩니다. v2.1.145에서는 claude agents --json, 입력 대기 중인 세션의 탭 개수 표시, Agent View 답장 창 수정이 추가됩니다. v2.1.147에서는 유휴 상태에서도 계속 실행되며 업데이트 시 같은 위치에서 다시 시작되는 고정 백그라운드 세션이 추가됩니다. Agent View는 모니터링 용도로 사용하되, 작업이 품질 기준을 통과했다는 증거로 간주하지 마세요.⁶

사용자 지정 agent frontmatter 필드:

사용자 지정 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

모델 설정

클라우드 제공업체

동작 제어

도구 설정

네트워크 및 프록시

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

14. 비용 참고 자료

토큰 100만 개당 가격이에요(2026년 7월 기준).⁵

일반적인 세션은 입력 토큰 50K-200K와 출력 토큰 10K-50K를 사용해요. Haiku 세션 비용은 $0.10-$0.45이고, Opus 세션 비용은 $0.50-$2.25예요.

Claude Code의 기본 모델(v2.1.197, 2026년 6월 30일 기준): 모든 새 세션에서 Sonnet 5를 사용해요. 네이티브 1M 컨텍스트를 제공하고 8월 31일까지 $2/$10 출시 특가가 적용되며, /model opus 한 번이면 Opus로 전환할 수 있어요(v2.1.219부터 이 별칭은 Opus 5를 선택해요). 관리자는 조직 전체의 기본값을 설정할 수 있으며, 이 값은 /model에 “조직 기본값”으로 표시돼요(v2.1.196+). Bedrock/Vertex/Foundry에서는 ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODEL을 사용해 특정 모델을 고정하세요.

Sonnet 5, Opus 5, Opus 4.8, Fable 5는 적응형 추론만 사용하며 고정된 사고 예산은 지원하지 않아요. 모든 모델에서 effort의 기본값은 high이며, 가장 어려운 코딩 및 에이전트 작업에는 /effort xhigh를 사용하세요. Opus 4.8과 비교한 Opus 5의 호환성을 깨뜨리는 변경 사항: 요청에서 thinking 필드를 생략하면 사고 기능이 기본적으로 활성화되며, 노력 수준이 xhigh 또는 max일 때 thinking: {type: "disabled"}를 지정하면 400 오류가 반환돼요.

빠른 모드(/fast)는 v2.1.219 기준으로 Opus 5와 Opus 4.8에만 적용돼요. 가격은 MTok당 $10 / $50로 기본 가격의 2배이며, 초당 출력 토큰 수는 최대 2.5배예요. Opus 4.7은 제거됐어요. 이제 claude-opus-4-7 + speed: "fast"는 표준 속도로 대체되지 않고 오류를 반환해요. 연구 미리 보기로 제공되며 Claude API에서만 사용할 수 있어요(Bedrock/Vertex/Foundry에서는 사용할 수 없어요). 속도를 전환하면 프롬프트 캐시가 무효화돼요.

세션 도중 모델 전환하기:

/model opus       # Switch to Opus 5 (v2.1.219+)
/model sonnet     # Switch to Sonnet 5 (the default)
/model haiku      # Switch to Haiku 4.5
/model fable      # Switch to Fable 5 (tier above Opus)
/effort xhigh     # Recommended for the hardest coding/agentic work

선택 기준: 간단한 탐색에는 Haiku를 사용하세요. 비용을 고려한 일상적인 코딩에는 Sonnet을 사용하세요. 어려운 추론, 아키텍처, 에이전트 루프, 보안 분석에는 Opus를 사용하세요. 복잡한 리팩터링에는 opusplan을 사용하세요(Opus가 계획하고 Sonnet이 실행해요).

15. 주요 파일 위치

16. 변경 내역

17. 참고 자료

이 치트 시트는 전체 Claude Code CLI 가이드와 함께 빠르게 찾아볼 수 있도록 만든 자료입니다. 설정 과정을 단계별로 알아보려면 Claude Code 빠른 시작 가이드를 참고하세요. 특히 iOS 및 macOS 프로젝트를 다룬다면 iOS Agent 개발 가이드, XcodeBuildMCP 통합 패턴, Apple 생태계 시리즈를 참고하세요. 마지막 업데이트: 2026년 7월 17일.