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. 슬래시 명령

사용자 지정 명령: .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
  },
  "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는 모든 세션을 시작할 때 이 파일을 읽습니다.

파일 위치:

AGENTS.md(v2.1.277+): CLAUDE.md가 없는 프로젝트에서는 Claude Code가 대신 AGENTS.md를 읽습니다. /config의 “프로젝트 지침”에서 이 동작을 변경할 수 있습니다(아직 Bedrock/Vertex/Foundry에서는 지원되지 않음).

포함할 내용:

# 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. 권한 모드

자동 모드(v2.1.85+)는 2026년 8월 14일부터 Pro, Max, Team 요금제에서 새 세션의 기본 권한 모드입니다(직접 설정한 defaultMode는 일회성 전환 메시지를 수락할 때까지 유지되며, disableAutoMode는 조직 전체에서 비활성화합니다). --dangerously-skip-permissions를 대체하는 권장 옵션입니다. 읽기 전용 작업과 파일 편집은 자동 승인됩니다. 분류기 검토가 서버 측에서 실행되는 v2.1.281부터는 읽기 전용 명령과 샌드박스 셸 명령도 검토를 기다리며, 분류기가 위험하다고 판단하면 차단됩니다. 사용자 지정 허용 및 거부 규칙이 먼저 적용됩니다. 나머지는 모두 안전 분류기로 전달됩니다. 기본적으로 자동 차단되는 작업은 curl | bash, main으로의 강제 푸시, 프로덕션 배포, 대규모 클라우드 삭제, IAM 변경, 민감한 데이터의 외부 전송입니다.¹

회로 차단기: 연속 3회 또는 한 세션에서 총 20회 차단되면 수동 확인 모드로 돌아갑니다.

무인 모드의 위험한 rm(v2.1.281): 자동 모드와 --dangerously-skip-permissions에서 위험한 rm 확인은 2분간 기다린 후 명령을 거부하고 재작성 안내를 표시하여 세션이 계속 진행되도록 합니다. rm -rf "$(pwd)"처럼 대상이 명령 치환의 출력으로만 이루어진 재귀적 rm은 이제 Bash 허용 규칙이 있어도 확인을 요청합니다.

# 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을 많이 사용하는 workflow에서는 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 | 자동 모드가 작업을 거부할 때(v2.1.88+) | 아니요 | | CwdChanged | 작업 디렉터리가 변경될 때(v2.1.83+) | 아니요 | | FileChanged | 감시 중인 파일이 외부에서 수정될 때(v2.1.83+) | 아니요 | | TaskCreated | 새 작업이 생성될 때(v2.1.84+) | 아니요 | | TeammateIdle | 에이전트 팀원이 유휴 상태가 될 때 | 예 | | 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에 다시 전달하고 턴을 계속 진행합니다.
• 에이전트 hook 입력의 subagent_type(v2.1.140+) — 실행 중인 에이전트 유형을 식별합니다.
• 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개 이상입니다.³ 전송 방식, 입력 요청, 도구 검색 설정은 전체 가이드의 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+): 데스크톱 앱과 claude.ai 커넥터 흐름처럼 사용자 지정 URI 스킴에서 OAuth을 완료하려면 필요합니다.

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는 .claude/agents/(프로젝트) 또는 ~/.claude/agents/(개인)에 YAML frontmatter가 포함된 markdown 파일로 정의합니다. 최대 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는 모니터링에만 사용하고, 작업이 품질 기준을 통과했다는 증거로 사용하지 마세요.⁶

사용자 지정 에이전트 frontmatter 필드:

사용자 지정 에이전트 예시 (.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년 9월 기준).⁵

일반적인 세션에서는 입력 토큰 50K~200K개와 출력 토큰 10K~50K개를 사용합니다. Haiku 세션 비용은 $0.10~$0.45이며, Opus 5.5 세션 비용은 $0.40~$1.80입니다.

Claude Code의 기본 모델(플랜별): v2.1.280(2026년 9월 22일)부터 모든 플랜에서 Opus가 기본입니다. Pro와 Team Standard가 Sonnet에서 Opus로 전환되어 Max, Team Premium, Enterprise와 동일해졌으며, 기본 Opus 모델은 Opus 5.5(claude-opus-5-5)입니다. 이제 opus 별칭도 이 모델을 가리킵니다. 프리미엄 플랜에는 Opus 5, Pro/Team Standard에는 Sonnet 5를 적용했던 v2.1.251의 구분과 모든 플랜에서 Sonnet 5를 기본으로 사용했던 v2.1.197의 설정은 이제 과거 방식입니다. 관리자는 조직 전체의 기본 모델을 설정할 수 있으며, 해당 모델은 /model에 “조직 기본값”으로 표시됩니다(v2.1.196 이상). AWS, Amazon Bedrock, Google Cloud의 Agent Platform에서 제공되는 Claude Platform도 기본으로 Opus 5.5를 사용합니다. Microsoft Foundry만 예외로, 기본 모델은 Sonnet 4.5이며 opus가 Opus 4.6을 가리키는 유일한 환경입니다. ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODEL을 사용하면 특정 모델로 고정할 수 있습니다.

Opus 5.5, Sonnet 5, Opus 5, Opus 4.8, Fable 5, Fable 5.1은 적응형 추론만 사용하며 고정된 thinking 예산은 지원하지 않습니다. 가장 어려운 코딩 및 에이전트 작업에는 /effort xhigh를 사용합니다. 이 모델들의 effort 기본값은 모두 high이지만, Opus 5.5만 medium이 기본값입니다. 또한 v2.1.280부터는 /effort 설정이 모델별로 분리되기 전에 저장한 effort 수준이 Opus 5.5와 같은 새 모델에 이어지지 않습니다. 따라서 새 모델은 사용자가 수준을 선택하기 전까지 자체 기본값으로 시작합니다. Opus 5.5와 Fable 모델에서는 thinking을 끌 수 없습니다(MAX_THINKING_TOKENS=0도 해당 모델에서는 효과가 없습니다). Opus 4.8과 비교한 Opus 5의 주요 변경 사항: thinking 필드를 생략한 요청에서는 thinking이 기본으로 활성화되며, effort가 xhigh 또는 max인 상태에서 thinking: {type: "disabled"}를 사용하면 400 오류가 반환됩니다.

Fast mode(/fast)는 Opus 5.5, Opus 5, Opus 4.8에 적용되며, v2.1.280부터 Opus 5.5가 기본 모델입니다. 비용은 Opus 5.5에서 MTok당 $8 / $40, Opus 5와 4.8에서 $10 / $50로 각각 기본 가격의 2배이며, 초당 출력 토큰 수는 최대 2.5배입니다. Opus 4.7은 제거되었습니다. 이제 claude-opus-4-7과 speed: "fast"를 함께 사용하면 표준 속도로 대체되지 않고 오류가 발생합니다. 리서치 프리뷰 기능으로, Claude API 및 구독에서만 사용할 수 있습니다(Bedrock/Vertex/Foundry 또는 AWS의 Claude Platform에서는 사용할 수 없습니다). 속도를 전환하면 프롬프트 캐시가 무효화됩니다. v2.1.271부터 fast mode는 Claude Code Remote 세션에서도 작동합니다(클라우드 및 자체 호스팅 러너). 조직에서 허용하는 경우 호스트의 fast mode 설정이나 세션에서 입력한 /fast가 적용됩니다.

세션 도중 모델 전환:

/model opus       # Switch to Opus 5.5 (v2.1.280+)
/model sonnet     # Switch to Sonnet 5
/model haiku      # Switch to Haiku 4.5
/model fable      # Switch to Fable 5.1 (tier above Opus, v2.1.257+)
/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일.