Claude Code 치트시트 및 빠른 참고

설정 및 접속

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

macOS, Linux 또는 WSL에서 Claude Code를 기본적으로 설치하고 자동 백그라운드 업데이트를 실시합니다.

$irm https://claude.ai/install.ps1 | iex

Windows PowerShell에서 기본 설치 관리자를 사용하여 Claude Code를 설치하고 자동 백그라운드 업데이트를 실시합니다.

$curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Windows CMD에서 기본 설치 관리자를 사용하여 Claude Code를 설치하고 자동 백그라운드 업데이트를 실시합니다.

$brew install --cask claude-code

macOS에서 Homebrew로 Claude Code를 설치합니다.

$brew upgrade claude-code

Homebrew 설치본은 자동으로 업데이트되지 않습니다. 최신 기능과 보안 수정을 받으려면 이것을 실행하세요(해당 cask를 설치했다면 brew upgrade claude-code@latest 사용).

$winget install Anthropic.ClaudeCode

Windows에서 WinGet으로 Claude Code를 설치합니다.

$winget upgrade Anthropic.ClaudeCode

WinGet 설치는 자동 업데이트되지 않습니다. 최신 기능과 보안 수정을 받으려면 이 명령을 실행하세요.

$claude

현재 프로젝트에서 대화형 Claude Code 세션을 시작합니다.

$claude -v

설치된 Claude Code 버전을 표시합니다.

$claude update

Claude Code를 최신 버전으로 수동으로 업데이트합니다.

$claude -p --init "query"

세션 전에 init 매처로 Setup 훅을 실행합니다(인쇄 모드 전용).

$claude auth login

터미널에서 Claude 계정에 로그인합니다. --email로 이메일을 미리 채우고, --sso로 SSO를 강제하며, --console로 Console API 결제를 사용합니다.

$claude auth status
$claude auth status --text

인증 상태를 JSON으로 표시하거나 --text를 전달하여 읽기 쉬운 출력을 얻습니다. 로그인되어 있으면 코드 0, 아니면 1로 종료합니다.

$claude "explain this project"

초기 프롬프트로 대화형 세션을 시작합니다.

/init

현재 프로젝트에 대한 프로젝트 지침 파일을 초기화합니다.

/memory

세션 내부에서 Claude 메모리 관리를 엽니다.

/login

Anthropic 계정에 로그인합니다.

/logout

Anthropic 계정에서 로그아웃합니다.

/mobile
/ios
/android

Claude 모바일 앱을 다운로드할 QR 코드를 표시합니다.

/import codex
/import gemini
/import cursor

OpenAI Codex, Google Gemini CLI 또는 Cursor의 설정을 명령 파일, MCP 서버, 명령, 서브에이전트, 스킬을 포함하여 Claude Code로 가져옵니다.

$claude install stable

기본 Claude Code 바이너리를 설치하거나 다시 설치합니다. 버전 번호, stable 또는 latest를 전달합니다.

$claude doctor

세션을 시작하지 않고 읽기 전용 설치 및 설정 진단을 실행합니다.

$claude setup-token

CI 및 스크립트용 장기 OAuth 토큰을 생성합니다. Claude 구독이 필요합니다.

프롬프트 및 입력

$claude -p "explain this function"

Claude를 인쇄 모드에서 한 번 실행하고 단일 응답으로 종료합니다.

Ctrl + G
Ctrl + X then Ctrl + E

기본 텍스트 편집기에서 현재 프롬프트를 엽니다.

/btw what was the name of that config file again?

주 대화 기록에 추가하지 않고 부가 질문을 합니다. Claude가 작업 중일 때 실행 가능.

Ctrl + K

커서에서 줄의 끝까지 삭제합니다.

Ctrl + U

커서에서 현재 줄 시작까지 삭제합니다. 다시 누르면 여러 줄 입력에서 줄을 넘어 지웁니다.

Ctrl + Y

readline kill 명령으로 삭제한 텍스트를 붙여넣습니다.

Alt + Y

붙여넣기 후 이전 kill-ring 항목을 순환합니다.

Alt + B

커서를 한 단어뒤로 이동합니다.

Alt + F

커서를 한 단어 앞으로 이동합니다.

Ctrl + V (or Cmd + V in iTerm2)Alt + VCtrl + V (or Alt + V on WSL)

클립보드의 이미지를 붙여넣습니다.

\ + Enter
Shift + Enter
Ctrl + J
Option + EnterShift + EnterShift + Enter

여러 줄 입력을 위해 줄 바꿈을 삽입합니다. Shift+Enter는 지원되는 터미널이 필요합니다(/terminal-setup 실행). macOS에서는 Option+Enter를 위해 Option을 Meta로 활성화하세요.

/

프롬프트의 시작부터 슬래시 명령 선택기를 엽니다.

!

프롬프트의 시작부터 bash 모드로 진입합니다.

@

파일 경로 자동완성을 트리거합니다.

Tab

편집할 프롬프트 제안을 수락합니다.

Enter

Tab 또는 오른쪽 화살표로 입력에 이미 배치된 프롬프트 제안을 제출합니다.

Escape
Backspace
Ctrl + U

프롬프트가 비어있을 때 bash 모드를 종료합니다.

/voice

음성 받아쓰기를 전환합니다(길게 누르기 또는 탭 모드).

Space
Enter
Escape

/btw 부가 질문 오버레이를 닫고 주 프롬프트로 돌아갑니다.

/goal all tests passing
/goal clear

목표를 설정합니다: 조건이 충족될 때까지 Claude가 여러 턴에 걸쳐 계속 작업합니다. clear를 전달하면 활성 목표를 조기에 제거합니다.

/loop 5m check if the deploy finished

세션이 열려 있는 동안 5m 같은 간격으로 프롬프트를 반복 실행하거나, Claude가 속도를 스스로 조절하도록 합니다. 별칭: /proactive.

/schedule

일정에 따라 클라우드에서 실행되는 루틴을 만들거나, 업데이트하거나, 나열하거나, 실행합니다. 별칭: /routines.

/deep-research compare state of the art RAG approaches

질문에 대해 여러 웹 검색을 수행하고, 출처를 가져와 교차 확인한 뒤, 인용이 포함된 보고서를 종합합니다.

Ctrl + S

현재 프롬프트를 나중을 위해 잠시 치워둡니다. 입력에 텍스트가 있으면 저장하고 입력을 지우며, 빈 입력에서 다시 누르면 저장해둔 텍스트를 복원합니다.

Ctrl + A

커서를 현재 줄의 시작으로 이동합니다. 여러 줄 입력에서는 현재 논리 줄의 시작으로 이동합니다.

Ctrl + E

커서를 현재 줄의 끝으로 이동합니다. 여러 줄 입력에서는 현재 논리 줄의 끝으로 이동합니다.

Ctrl + W

이전 공백까지 되돌아가며 삭제합니다. 한 번 누르면 전체 경로 또는 --flag=value를 제거합니다.

Alt + D

현재 단어의 끝까지 삭제하거나, 커서가 단어 사이에 있으면 다음 단어의 끝까지 삭제합니다.

Ctrl + _
Ctrl + Shift + -

마지막 입력 편집을 실행 취소하여 이전 입력 텍스트와 커서 위치를 복원합니다.

Ctrl + Enter
Ctrl + X then Ctrl + S

Claude가 아직 작업하는 동안 대기 중인 메시지와 초안을 함께 즉시 보냅니다.

$claude -p "query" --output-format json

스크립트와 자동화를 위해 print 모드에서 JSON 출력을 얻습니다.

$claude --fallback-model sonnet,haiku "query"

기본 모델이 과부하되었거나 사용할 수 없을 때 지정한 모델로 자동 폴백을 활성화합니다. 순서대로 시도할 쉼표로 구분된 목록을 받습니다.

$claude -p --max-turns 3 "query"
$claude -p --max-budget-usd 5.00 "query"

print 모드 실행에 대해 에이전트 턴을 제한하거나 지출 한도를 설정합니다.

세션 및 컨텍스트

$claude -c
$claude --continue

현재 디렉토리에서 가장 최근 대화를 계속합니다.

$claude --resume auth-refactor
$claude -r

ID 또는 이름으로 특정 세션을 재개하거나 세션을 선택하기 위한 대화형 선택기를 표시합니다.

/clear
/reset
/new

현재 세션을 지우고 새로운 대화를 시작합니다.

/compact "keep only the important parts"

현재 대화를 압축하여 중요한 컨텍스트만 유지합니다.

/resume

ID 또는 이름으로 대화를 재개하거나 세션 선택기를 엽니다. 백그라운드 세션은 bg로 표시됩니다.

/rename feature-auth

현재 대화의 이름을 바꿉니다.

/fork bug-investigation

현재 대화를 새로운 백그라운드 세션으로 복사하고 여기서 계속 작업합니다. 프롬프트를 전달하면 복사본을 즉시 해당 작업으로 시작합니다. 직접 분기로 전환하려면 /branch를, 결과를 보고하는 서브에이전트에게 작업을 넘기려면 /subtask를 사용하세요.

/context

현재 사용 중인 컨텍스트의 양을 표시합니다.

/plan fix the auth bug

플랜 모드로 전환하며, 작업 설명을 전달하여 즉시 계획을 시작할 수 있습니다.

/tasks

현재 세션의 백그라운드 작업(실행 중인 셸과 완료된 서브에이전트 포함)을 보고 관리합니다. Claude의 할 일 목록이 아니라 백그라운드 작업 보기입니다.

/copy

마지막 어시스턴트 응답을 클립보드에 복사합니다. 숫자 N을 전달하면 최신에서 N번째 응답을 복사하고, 대화형 선택기에서 개별 코드 블록을 고를 수 있습니다.

/export notes.txt

현재 대화를 일반 텍스트로 내보내며, 선택적으로 파일로 저장합니다.

/desktop
/app

Claude Code 데스크톱 앱(macOS 또는 x64 Windows)에서 현재 세션을 계속합니다.

/add-dir <path>

현재 세션에 새로운 작업 디렉토리를 추가합니다.

/branch feature-auth

이 시점에서 현재 대화의 분기를 생성합니다.

/remote-control
/rc

claude.ai에서 현재 세션의 원격 제어를 활성화합니다.

Esc + Esc

텍스트가 있을 때 입력 초안을 지웁니다(위쪽 화살표를 눌러 다시 불러옴). 빈 프롬프트에서는 되감기 메뉴를 열어 코드와 대화를 복원하거나 요약합니다.

/background

현재 세션을 백그라운드 에이전트로 실행되도록 분리하여 터미널을 비웁니다. 분리하기 전에 프롬프트를 전달하면 한 가지 지시를 더 보냅니다. 별칭: /bg.

/subtask refactor the auth module

전체 대화를 상속하여 작업을 수행하는 포크된 서브에이전트를 생성하며, 사용자는 계속 작업할 수 있습니다. 완료되면 결과가 이 대화로 돌아옵니다.

/cd ../other-project

대화를 유지한 채 세션을 새 작업 디렉터리로 이동합니다.

/recap

요청 시 현재 세션의 한 줄 요약을 생성합니다.

/teleport

claude.ai의 클라우드 세션을 이 터미널로 가져옵니다. 선택기를 연 뒤 분기와 대화를 가져옵니다. 별칭: /tp.

/autocompact 500k
/autocompact auto

자동 압축 시점을 설정합니다: Claude Code가 자동으로 압축하기 전 컨텍스트 창이 어느 정도 차야 하는지입니다. 500k 같은 크기나 모델에 맞춘 기본값인 auto를 전달하세요.

$claude -w feature-auth
$claude --worktree

병렬 세션이 충돌하지 않도록 .claude/worktrees/<name>의 격리된 git worktree에서 Claude를 시작합니다. 이름을 지정하지 않으면 자동 생성됩니다.

$claude -n "my-feature-work"

/resume와 터미널 제목에 표시되는 세션 표시 이름을 설정합니다. 나중에 claude --resume <name>으로 재개할 수 있습니다.

$claude --resume abc123 --fork-session

재개할 때 원래 세션 ID를 재사용하지 않고 새 세션 ID를 만들어 원래 대화를 그대로 유지합니다.

$claude --from-pr 123

풀 리퀘스트와 연결된 세션으로 필터링된 세션 선택기를 엽니다. PR 번호 또는 GitHub/GitLab/Bitbucket URL을 받습니다. Claude가 PR을 만들면 세션이 자동으로 연결됩니다.

$claude --teleport

claude.ai의 웹 세션을 로컬 터미널에서 재개합니다.

$claude --cloud "Fix the login bug"

제공된 작업 설명으로 claude.ai에서 새 클라우드 세션을 만듭니다. --remote 별칭은 더 이상 사용되지 않습니다.

$claude --remote-control "My Project"
$claude --rc "My Project"

원격 제어를 활성화한 대화형 세션을 시작하여 claude.ai나 Claude 앱에서도 제어할 수 있도록 합니다.

$claude --bg "investigate the flaky test"
$claude --bg --exec 'pytest -x'

세션을 백그라운드 에이전트로 시작하고 즉시 반환합니다. --exec와 결합하여 셸 명령을 백그라운드 작업으로 실행합니다.

$claude agents

병렬 백그라운드 세션을 모니터링하고 디스패치하기 위해 에이전트 보기를 엽니다.

$claude logs 7c5dcf5d
$claude attach 7c5dcf5d

백그라운드 세션의 최근 출력을 인쇄하거나 이 터미널에서 해당 세션에 연결합니다.

$claude stop 7c5dcf5d
$claude respawn 7c5dcf5d
$claude rm 7c5dcf5d

셸에서 백그라운드 세션을 중지, 재시작 또는 제거합니다.

네비게이션 및 제어

Ctrl + C

현재 입력 또는 생성을 취소합니다.

Ctrl + X then Ctrl + K

이 세션에서 실행 중인 모든 백그라운드 서브에이전트를 중지합니다(확인하려면 3초 내에 두 번 누름).

Ctrl + D

Claude Code 세션을 종료합니다.

/exit
/quit

명령 프롬프트에서 Claude Code를 종료합니다.

Ctrl + L

입력과 대화 기록을 유지한 채 터미널 화면을 다시 그립니다.

Ctrl + O

자세한 도구 사용 및 실행을 검사하기 위해 기록 뷰어를 전환합니다.

Ctrl + B

백그라운드에서 작업을 실행합니다. Tmux 사용자는 Ctrl+B를 두 번 누르세요.

Ctrl + T

작업 목록을 표시하거나 숨깁니다.

대화 상자 및 메뉴의 탭을 순환합니다.

명령 기록을 탐색합니다.

Ctrl + Z

Claude Code를 셸에 일시 중지합니다(Unix 전용). fg를 실행하면 재개됩니다.

검토 및 진단

/diff

Claude 내부에서 현재 diff를 표시합니다.

/rewind
/checkpoint
/undo

대화 및/또는 코드를 이전 체크포인트로 되돌리거나 선택한 메시지부터 요약합니다.

/doctor
/checkup

설치, 설정, 확장, CLAUDE.md 문제를 진단하고 확인 후 Claude가 적용하는 수정 사항을 제안하는 설정 점검을 실행합니다.

/status

현재 Claude 세션 및 계정 상태를 표시합니다.

/stats

/usage의 별칭으로, 세션 비용, 플랜 사용 한도 및 활동 통계를 보여주는 통계 탭을 엽니다.

/insights

Claude Code 세션, 상호 작용 패턴 및 마찰 지점을 분석하는 보고서를 생성합니다.

/usage

현재 사용 정보를 표시합니다.

/cost

현재 지출 및 비용 정보를 표시합니다.

/security-review

보안 문제에 대해 현재 분기를 검토합니다.

Cmd + ClickCtrl + ClickCtrl + Click

바닥글에서 연결된 풀 요청을 엽니다.

/code-review
/code-review high 1234
/code-review ultra --fix
/review

현재 diff 또는 PR 번호, 분기, 경로를 검토하여 정확성 버그를 찾습니다. --fix를 전달하면 발견 사항을 적용하고, --comment는 PR에 게시하며, ultra는 심층 멀티 에이전트 클라우드 리뷰를 수행합니다. 별칭: /review.

/simplify

변경된 코드를 검토하여 정리 기회를 찾고 수정 사항을 적용합니다. 네 개의 에이전트가 재사용, 단순화, 효율성, 추상화 수준을 담당하여 병렬로 실행됩니다. 정확성 버그는 찾지 않으므로 그런 경우 /code-review를 사용하세요.

/verify

테스트나 타입 검사에 의존하는 대신 앱을 빌드하고 실행하여 결과를 관찰함으로써 코드 변경이 의도대로 동작하는지 확인합니다.

/debug login fails on safari

현재 세션의 디버그 로깅을 활성화하고 세션 디버그 로그를 읽어 문제를 해결합니다. 문제를 설명하면 분석이 집중됩니다.

$claude ultrareview 1234 --json

클라우드 호스팅 다중 에이전트 코드 검토를 비대화형으로 실행하고 결과를 인쇄합니다.

역방향 검색

Ctrl + R

명령 기록을 통해 역방향 검색을 시작하거나 이전 일치 항목을 순환합니다.

Tab
Esc

편집을 위해 현재 역방향 검색 일치를 수락합니다.

Enter

현재 역방향 검색 일치를 수락하고 실행합니다.

Backspace

쿼리가 비어있을 때 역방향 검색을 종료합니다.

Ctrl + C

역방향 검색을 취소하고 원래 입력을 복원합니다.

설정 및 통합

/config
/settings
/config theme=dark

설정 인터페이스를 열거나 /config thinking=false, /config model=sonnet처럼 key=value 쌍을 전달하여 설정을 직접 지정합니다.

/theme

테마 선택기를 엽니다.

/color orange

현재 세션의 프롬프트 표시줄 색상을 설정합니다.

/keybindings

키 바인딩 설정을 엽니다.

/terminal-setup

Shift+Enter 지원과 같은 터미널별 바인딩을 설치합니다.

/model

현재 세션 내부에서 모델을 전환합니다.

/effort high

현재 추론 노력 수준을 변경합니다.

/fast on

현재 세션에서 빠른 모드를 전환합니다.

/permissions
/allowed-tools

권한 설정을 엽니다.

/sandbox

샌드박스 모드를 전환합니다. 지원되는 플랫폼에서만 사용할 수 있습니다.

/mcp

MCP 서버 통합을 관리합니다.

/plugin

세션 내부에서 플러그인을 관리합니다.

/reload-plugins

설치된 플러그인을 다시 로드합니다.

/ide

IDE 통합을 관리하고 연결 상태를 표시합니다.

/agents

Claude에게 서브에이전트를 만들거나 관리하도록 요청하거나 .claude/agents/ 또는 ~/.claude/agents/를 직접 편집하라는 알림을 인쇄합니다.

/hooks

도구 이벤트 및 자동화에 대한 훅 구성을 봅니다.

/config

설정 인터페이스에서 Vim 편집 모드와 일반 모드를 전환합니다. v2.1.92에서 /vim 명령으로는 제거되었습니다.

/statusline

셸 프롬프트에서 Claude Code의 상태 줄 표시를 구성합니다.

Shift + TabShift + Tab or Alt + M (when VT input mode is unavailable)Shift + Tab

권한 모드를 전환합니다.

Option + PAlt + PAlt + P

현재 프롬프트를 지우지 않고 모델을 전환합니다.

Option + TAlt + TAlt + T

확장 사고 모드를 전환합니다.

Ctrl + T

테마 선택기 내부에서 구문 강조를 전환합니다.

/usage-credits

요금 한도에 도달했을 때 사용 크레딧을 구성하거나 관리자에게 요청합니다. 이전 명령: /extra-usage.

/output-style concise

출력 스타일을 나열하거나 하나로 전환합니다.

/update-config allow npm test without prompting

명령 허용이나 hook 추가 같은 설정 변경을 설명하면 Claude가 해당 settings.json 파일을 편집합니다. 테마와 모델은 대신 /config를 사용하세요.

/fewer-permission-prompts

트랜스크립트를 훑어 일반적인 읽기 전용 Bash 및 MCP 도구 호출을 찾아, 프로젝트 설정에 우선순위가 정해진 허용 목록을 추가하여 권한 요청을 줄입니다.

/skill-doctor

각 스킬이 컨텍스트에서 얼마나 비용을 차지하고 얼마나 자주 사용되는지 표시하여 끌 스킬을 찾도록 돕습니다.

/list-agents
/peers

Claude가 메시지를 보낼 수 있는 서브에이전트, 에이전트 팀 동료, 다른 Claude Code 세션을 각각 사용할 이름과 함께 나열합니다. 별칭: /peers.

Option + OAlt + OAlt + O

빠른 모드를 켜거나 끕니다.

$claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'

시작 시 JSON을 통해 사용자 지정 서브에이전트를 동적으로 정의합니다. --print 사용 시 JSON 파일 경로도 허용합니다.

$claude --tools "Bash,Edit,Read"

Claude가 사용할 수 있는 기본 제공 도구를 제한합니다. ""는 모두 비활성화, "default"는 기본 집합, 또는 도구 이름을 나열하세요.

$claude --effort high

시작 시 세션의 노력 수준을 설정합니다: low, medium, high, xhigh, max 또는 ultracode(모델에 따라 다름).

$claude --add-dir ../apps ../lib

시작 시 Claude가 접근할 추가 작업 디렉터리를 지정합니다.

$claude --permission-mode plan

지정된 권한 모드(예: plan)로 세션을 시작합니다.

$claude --mcp-config ./mcp.json
$claude --strict-mcp-config --mcp-config ./mcp.json

JSON 파일이나 문자열에서 MCP 서버를 로드하며, 선택적으로 다른 모든 MCP 구성을 무시합니다.

$claude --safe-mode

손상된 구성을 문제 해결하기 위해 모든 사용자 지정을 비활성화한 상태로 시작합니다.

$claude --bare -p "query"

스크립트용 최소 모드로 시작합니다: 훅, 스킬, 플러그인, MCP 서버 및 CLAUDE.md 검색을 건너뜁니다.

$claude --chrome
$claude --no-chrome

웹 자동화 및 테스트를 위한 Chrome 브라우저 통합을 활성화하거나 비활성화합니다.

$claude --settings ./settings.json

이 세션의 설정을 JSON 파일 또는 인라인 JSON 문자열에서 로드합니다.

$claude --plugin-dir ./my-plugin

이 세션 전용으로 디렉터리 또는 .zip 아카이브에서 플러그인을 로드합니다.

$claude -p --json-schema '{"type":"object","properties":{...}}' "query"

에이전트가 워크플로를 완료한 후 JSON 스키마와 일치하는 유효성 검사된 JSON 출력을 얻습니다(인쇄 모드 전용).

도움말 및 발견

/help

기본 제공 슬래시 명령 도움말을 엽니다.

/skills

사용 가능한 기술 목록을 엽니다.

/release-notes

최근 버전 업데이트가 포함된 전체 변경 로그를 보세요.

/feedback
/bug

피드백을 제출하거나 버그를 보고합니다. /bug(별칭 /share)는 /feedback과 같은 대화 상자를 엽니다.

?

프롬프트가 비어 있을 때 키보드 단축키 도움말 패널을 전환합니다.