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

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

1. 설치

세 가지 설치 방법을 선호 순서대로 소개합니다.

# 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

2.1.288부터 2.1.290까지의 버전을 사용 중이라면 2.1.291 이상으로 업데이트하세요. 종료 시 세션의 마지막 메시지가 유실될 수 있었던 2.1.288의 회귀 버그와, 클라우드 세션에서 권한 프롬프트에 대한 응답이 누락될 수 있었던 2.1.290의 회귀 버그가 수정되었습니다.

인증:

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를 전달하세요.⁷

세션 및 데이터 하위 명령: claude attach <name>과 claude logs <name>은 id 대신 백그라운드 세션 이름의 일부를 받습니다(v2.1.290+). claude purge [path]는 프로젝트의 로컬 Claude Code 상태를 삭제합니다(--dry-run으로 미리 확인할 수 있습니다). v2.1.288 이전에는 claude project purge였으며, 이전 이름도 안내 메시지와 함께 여전히 동작합니다. v2.1.300부터 claude remote-control은 --sandbox와 --no-sandbox를 더 이상 받지 않습니다(아무 효과가 없었던 옵션이므로, 설정에서 sandbox.enabled를 지정하세요). v2.1.309부터 claude ultrareview는 워크스페이스 신뢰를 요구합니다. 터미널에서는 확인을 요청하고, 그렇지 않으면 실행을 거부합니다. 스크립트에서는 --trust-workspace를 전달하거나(값 없음; PR 번호나 기준 브랜치를 그 앞에 지정합니다) CLAUDE_CODE_DISABLE_ULTRAREVIEW_TRUST_CHECK=1을 설정하세요.¹⁴ claude self-hosted-runner --hold-idle-file <path> --max-hold-min <n>은 호스트가 해당 파일을 계속 변경하는 동안 유휴 세션을 유지하다가, 어떤 경우든 n분이 지나면 해제합니다(기본값 1440; v2.1.311+).

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에 저장됨). v2.1.284부터 effortSlider:decreaseEffort, increaseEffort, toggleUltracode 동작으로 /effort 슬라이더의 화살표 키와 Tab 키를 다시 바인딩할 수 있습니다.

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/** allow 규칙은 <cwd>/dir에만 일치하며, 더 이상 트리 어디에나 있는 dir/에 일치하지 않습니다. 깊이와 무관하게 일치시키려면 Edit(**/src/**)로 작성하세요. deny/ask 규칙은 깊이와 무관한 일치를 유지하며, hook의 if: 조건에도 같은 cwd 범위 지정이 적용됩니다. v2.1.299부터 MCP allow 규칙은 이름을 지정한 서버에만 적용됩니다. mcp__a는 더 이상 a__b나 a_라는 이름의 서버를 포함하지 않으므로, 정규화된 전체 이름으로 mcp__<server>__*를 작성하세요.

새 키(v2.1.118+):

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

7. CLAUDE.md 빠른 참조

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

위치:

AGENTS.md (v2.1.277+): CLAUDE.md가 없는 프로젝트에서는 Claude Code가 대신 AGENTS.md를 읽습니다. 이 동작은 /config의 “Project instructions”에서 변경할 수 있습니다(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를 읽으므로 단어 하나하나가 컨텍스트를 소모합니다.

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

8. 권한 모드

Auto Mode(v2.1.85+)는 모든 플랜과 공급자에서 대화형 터미널 및 VS Code 세션의 기본 시작 모드입니다. v2.1.283에서 서드파티 공급자와 텔레메트리를 끈 세션으로, v2.1.284에서 모든 플랜과 공급자로 확대되었습니다. 그 이전에는 Pro, Max, Team 플랜에서만 기본값이었습니다(2026년 8월 14일부터). v2.1.285부터 v2.1.301까지는 서드파티 공급자를 사용하거나 텔레메트리를 끈 claude -p 및 Python Agent SDK 세션도 권한 모드가 설정되지 않은 경우 auto 모드로 시작했습니다. v2.1.302는 이를 되돌립니다: 권한 모드가 없는 claude -p 또는 Agent SDK 세션은 서드파티 공급자에서, 텔레메트리를 끈 상태에서, 그리고 새로 설치한 환경에서 Manual로 시작합니다. 기능 플래그를 가져오는 환경에서 늘 그래왔던 것과 같은 동작이며, --permission-mode auto를 지정하면 auto가 유지됩니다.¹³ permissions.defaultMode는 내장 기본값을 재정의하고("default"는 Manual로 고정), disableAutoMode는 조직 전체에서 이를 비활성화합니다. --dangerously-skip-permissions를 대체할 권장 방법입니다. 읽기 전용 작업과 파일 편집은 자동 승인됩니다. v2.1.281부터 분류기 검토가 서버 측에서 실행되는 환경에서는 읽기 전용 및 샌드박스 셸 명령도 검토를 기다리며, 분류기가 플래그를 지정하면 차단됩니다. 사용자 정의 allow/deny 규칙이 먼저 적용됩니다. 그 외 모든 작업은 안전 분류기로 넘어갑니다. 기본적으로 자동 차단되는 항목: curl | bash, main으로의 force-push, 프로덕션 배포, 대규모 클라우드 삭제, IAM 변경, 민감한 데이터의 외부 전송.¹

서킷 브레이커: 세션에서 3회 연속 차단되거나 총 20회 차단되면 수동 확인 요청으로 일시 전환됩니다.

작업 디렉터리 바깥을 읽기 전에 auto 모드가 띄우는 확인 요청에는 Yes, but ask again next time 옵션이 있습니다(v2.1.284+): 그 읽기 한 번만 허용하고 이후의 읽기에 대해서는 계속 확인을 받습니다.

무인 모드에서의 위험한 rm(v2.1.281): auto 모드와 --dangerously-skip-permissions에서는 위험한 rm 확인 요청이 2분간 대기한 뒤 재작성 힌트와 함께 명령을 거부하여 세션이 계속 진행되도록 합니다. rm -rf "$(pwd)"처럼 대상이 명령 치환 출력뿐인 재귀 rm은 이제 Bash allow 규칙이 있어도 확인을 요청합니다.

# 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

권한 변경 사항(v2.1.288-290): pyright는 더 이상 읽기 전용으로 취급되지 않고 먼저 확인을 요청하며, ps의 더 많은 형태도 마찬가지입니다(v2.1.290). 프로젝트의 설정 파일로는 더 이상 Claude in Chrome을 켤 수 없습니다. --chrome, /chrome 또는 사용자 설정을 사용하세요(v2.1.290). 클라이언트 측 auto 모드 분류기는 Sonnet 5.5나 Opus 5.5를 지정하는 ANTHROPIC_DEFAULT_SONNET_MODEL 고정값을 무시하고 Claude Sonnet 5를 사용합니다(v2.1.288).

PowerShell 자동 승인(v2.1.119+): PowerShell 도구 명령은 Bash 명령과 같은 방식으로 권한 모드에서 자동 승인됩니다. PowerShell(Get-*:*) 같은 allow 규칙은 읽기 전용 작업의 확인 요청을 건너뜁니다. PowerShell을 많이 쓰는 워크플로에서는 v2.1.149 이상을 사용하세요. 내장 cd 권한 우회, 접두사/와일드카드 allow 규칙 매칭, 오래된 디렉터리 변수 추적 문제를 수정했습니다.

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 모드가 작업을 거부할 때(v2.1.88+) | 아니요 | | CwdChanged | 작업 디렉터리 변경(v2.1.83+) | 아니요 | | FileChanged | 감시 중인 파일이 외부에서 수정됨(v2.1.83+) | 아니요 | | TaskCreated | 새 작업 생성(v2.1.84+) | 아니요 | | TeammateIdle | 에이전트 팀 구성원이 유휴 상태일 때 | 예 | | TaskCompleted | 작업이 완료로 표시될 때 | 예 |

전체 hook 프로토콜(입출력 JSON, matcher, 종료 코드)은 전체 가이드의 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"
          }
        ]
      }
    ]
  }
}

Matcher 문법:

종료 코드:

비동기 hook은 차단 없이 백그라운드에서 실행됩니다. hook 객체에 "async": true를 추가하세요.² v2.1.302부터 프롬프트 hook과 에이전트 hook은 한 이벤트당 한 번에 최대 12개까지만 실행되며, 나머지는 차례를 기다립니다.¹³

Hook 출력/입력 필드:

• PostToolUse / PostToolUseFailure hook 입력의 duration_ms(v2.1.119+) — 권한 확인 요청과 PreToolUse hook을 제외한 도구 실행 시간입니다.
• hookSpecificOutput.updatedToolOutput(v2.1.121+) — 모든 도구의 출력을 대체합니다(v2.1.118에서 MCP 전용으로 도입되었고, v2.1.121에서 모든 도구로 확대되었습니다).
• hookSpecificOutput.sessionTitle(v2.1.96+) — UserPromptSubmit hook에서 세션 제목을 설정합니다.
• 명령 hook의 args: string[](v2.1.139+) — 셸 인용 없이 구조화된 argv를 전달합니다.
• Skill hook 상한(v2.1.304+): 한 출처(저장소, 사용자 자신의 폴더 또는 plugin)의 skills는 세션당 최대 1,024개의 hook과 16,384자의 matcher 문자를 등록할 수 있습니다. 한 skill의 once hook이 다른 skill의 동일한 hook을 더 이상 제거하지 않습니다.
• PostToolUse hook의 continueOnBlock(v2.1.139+) — 차단 사유를 Claude에 되돌려 보내고 턴을 계속합니다.
• 에이전트 hook 입력의 subagent_type(v2.1.140+) — 어떤 에이전트 유형이 실행 중인지 식별합니다.
• hook JSON 출력의 terminalSequence(v2.1.141+) — 알림, 창 제목, 벨을 위한 터미널 제어 시퀀스를 내보냅니다.
• 명령 hook과 HTTP hook의 onFailure: "block"(v2.1.295+) – 시작할 수 없거나, 시간이 초과되거나, 0 또는 2 이외의 코드로 종료되거나, HTTP 오류를 받거나, 잘못된 JSON을 출력하는 hook이 작업을 차단합니다(해당 이벤트에서 종료 코드 2가 하는 동작이며, PermissionRequest에서는 거부). 기본값은 "continue"이며 Stop, SubagentStop, TaskCompleted, TeammateIdle 및 비동기 hook에서는 무시됩니다.

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

alwaysLoad: false(v2.1.287+)는 반대로 동작합니다. 해당 서버의 모든 도구는 도구 검색을 통해 로드될 때까지 대기합니다.

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

URL 프롬프트(v2.1.287+): 2025-11-25 프로토콜을 사용하는 MCP 서버는 로그인 등의 용도로 URL 프롬프트를 열 수 있습니다. 업데이트 후 서버가 연결되지 않으면 해당 MCP 설정 항목에 "bareElicitationCapability": true를 추가하세요.

SDK mcp_authenticate redirectUri (v2.1.121+): 데스크톱 앱과 claude.ai 커넥터 흐름에서 사용자 지정 URI 스킴으로 OAuth을 완료하는 데 필요합니다.

11.5. plugins CLI 명령어

모드(v2.1.287+): 모드는 JavaScript 또는 TypeScript 핸들러가 Claude Code 내부에서 실행되는 plugins입니다. 패널을 표시하고, 명령어를 추가하며, 도구 호출을 감시하거나 변경할 수 있습니다. 모드는 기본적으로 활성화됩니다. --safe-mode는 한 세션에서, "disableAllHooks": true는 모든 세션에서 모드를 중지하지만, 어느 쪽도 내장 모드를 중지하지는 않습니다.⁸

LSP 서버(v2.1.288+): LSP 서버 항목에는 밀리초 단위의 requestTimeout을 지정할 수 있습니다(기본값 60000). 서버가 응답하지 않으면 무한정 대기하지 않고 60초 후 요청을 실패 처리합니다.

12. subagents 유형

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 프런트매터가 포함된 마크다운 파일로 정의합니다. 기본적으로 최대 20개의 subagents가 동시에 실행되며, CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS로 상한을 변경할 수 있습니다.⁴ v2.1.292부터 Agent 도구는 effort 매개변수를 받으므로, Claude에 특정 추론 노력 수준으로 subagents를 실행하도록 요청할 수 있습니다. 에이전트 이름은 최대 256자로 제한됩니다(skills 또는 plugins 파일에서 이보다 긴 name은 무시됩니다). v2.1.302부터 포크 방식의 subagents(subagent_type: "fork")는 터미널뿐 아니라 claude -p, Agent SDK, 데스크톱 앱, VS Code에서도 기본적으로 활성화됩니다(CLAUDE_CODE_FORK_SUBAGENT=0으로 비활성화할 수 있으며, claude mcp serve에서는 제공되지 않습니다). 데스크톱 앱과 VS Code는 메인 대화의 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에서는 유휴 상태에서도 종료되지 않고 업데이트 시 같은 자리에서 다시 시작되는 고정 백그라운드 세션이 추가되었습니다. v2.1.287에서는 세션 이름과 작업을 검색하는 n:<text> 필터가 추가되었습니다. v2.1.288에서는 이름으로 세션을 찾는 Ctrl+F와 그룹 사이를 이동하는 Alt+Up / Alt+Down이 추가되었으며, 두 기능 모두 keybindings.json에서 키를 다시 지정할 수 있습니다(Ctrl+F의 동작은 agents:find). Agent View는 모니터링에 사용하세요. 작업이 품질 검증을 통과했다는 근거로 삼아서는 안 됩니다.⁶

사용자 지정 에이전트 프런트매터 필드:

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

일반적인 세션은 입력 토큰 50K-200K, 출력 토큰 10K-50K를 소비합니다. Haiku 5.5 세션: 100K 토큰 이하 프롬프트 요금 기준으로 약 $0.01-$0.05. Opus 5.5 세션: $0.40-$1.80.

Claude Code의 기본 모델(플랜별): v2.1.280(2026년 9월 22일)부터 모든 플랜에서 Opus입니다 – Pro와 Team Standard가 Max, Team Premium, Enterprise와 같이 Sonnet에서 Opus로 옮겨갔습니다 – 그리고 기본 Opus 모델은 Opus 5.5(claude-opus-5-5)로, 이제 opus 별칭이 가리키는 모델입니다. v2.1.251의 분리 구성(프리미엄 플랜은 Opus 5, Pro/Team Standard는 Sonnet 5)과 v2.1.197의 모든 플랜 Sonnet 5 기본값은 과거의 이야기입니다. 관리자는 조직 전체 기본값을 설정할 수 있으며, /model에 “Org default”로 표시됩니다(v2.1.196+). AWS의 Claude Platform, Amazon Bedrock, Google Cloud의 Agent 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.5, Haiku 5.5, Sonnet 5, Opus 5, Opus 4.8, Fable 5, Fable 5.1은 적응형 추론만 사용하며(고정 thinking 예산 없음), 가장 어려운 코딩/에이전트 작업에는 /effort xhigh를 씁니다. effort의 기본값은 모두 high이지만, Opus 5.5와 Sonnet 5.5는 예외로 기본값이 medium이며, Claude API에서의 Haiku 5.5도 마찬가지입니다 – 또한 v2.1.280부터는 /effort가 모델별 설정이 되기 전에 저장해 둔 effort 수준이 Opus 5.5 같은 새로 출시된 모델에는 더 이상 이어지지 않으므로, 직접 고르기 전까지는 해당 모델 고유의 기본값에서 시작합니다. Opus 5.5, Sonnet 5.5, Fable 모델에서는 thinking을 끌 수 없습니다(MAX_THINKING_TOKENS=0은 여기서 효과가 없습니다). Opus 4.8 대비 Opus 5의 호환성 변경 사항: thinking 필드를 생략한 요청에는 thinking이 기본적으로 켜지며, effort가 xhigh 또는 max일 때 thinking: {type: "disabled"}를 지정하면 400을 반환합니다.

고속 모드(/fast)는 Opus 5.5와 Opus 5, 그리고 2026년 11월 30일까지 Opus 4.8에 적용되며(10월 30일 지원 중단; 제거 이후에는 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부터는 Claude Code Remote 세션(클라우드 및 자체 호스팅 러너)에서도 고속 모드가 동작합니다. 호스트의 고속 모드 설정이나 세션에서 입력한 /fast가 조직에서 허용하는 범위 내에서 적용됩니다.

세션 중 모델 전환:

/model opus       # Switch to Opus 5.5 (v2.1.280+)
/model sonnet     # Switch to Sonnet 5.5 on the Anthropic API (v2.1.284+)
/model haiku      # Switch to Haiku 5.5 on the Anthropic API (v2.1.293+)
/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 에이전트 개발 가이드, XcodeBuildMCP 통합 패턴, 그리고 Apple 생태계 시리즈를 참고하세요. 최종 업데이트: 2026년 10월 6일.