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
$brew install --cask claude-code

Homebrew를 사용하여 Claude Code를 설치합니다.

$brew upgrade claude-code
$brew upgrade claude-code

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

$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 --init

초기화 훅을 실행하고 대화형 모드를 시작합니다.

$claude auth login

터미널에서 Claude 계정으로 로그인합니다. --email을 사용하여 이메일 미리 입력 또는 --sso로 SSO 인증 강제.

$claude auth status --text

인증 상태를 JSON으로 표시합니다. 사람이 읽을 수 있는 출력을 위해 --text 사용. 로그인된 경우 코드 0으로, 그렇지 않은 경우 1로 종료.

$claude "write a test for this function"

일회용 작업을 실행하고 대화형 세션을 시작하지 않고 응답을 받습니다.

$claude commit

Claude Code가 커밋 메시지를 작성하는 Git 커밋을 생성합니다.

/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 -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 + VAlt + VCtrl + V or Alt + V

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

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

여러 줄 입력을 위해 새 줄을 삽입합니다.

/

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

!

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

@

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

Tab

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

Enter

프롬프트 제안을 수락하고 즉시 제출합니다.

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 -p --fallback-model sonnet "query"

기본 모델이 과부하 상태일 때 지정된 모델로 자동 전환을 활성화합니다(print 모드 전용).

$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
/continue

현재 세션 내부에서 다른 대화를 재개합니다.

/rename feature-auth

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

/fork bug-investigation

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

/context

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

/plan fix the auth bug

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

/tasks

현재 세션의 작업 목록을 엽니다.

/copy

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

/export notes.txt

현재 응답을 파일로 내보냅니다.

/desktop
/app

터미널 세션을 데스크톱 앱 또는 웹으로 전송하여 시각적 diff 검토 및 계속 작업합니다.

/add-dir <path>

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

/branch feature-auth
/fork

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

/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

특정 GitHub PR에 연결된 세션을 재개합니다(gh pr create로 생성 시 자동 연결).

$claude --teleport

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

$claude --remote "Fix the login bug"

제공된 작업 설명으로 claude.ai에서 새 웹 세션을 만듭니다.

$claude --remote-control "My Project"

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

네비게이션 및 제어

Ctrl + C

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

Ctrl + F

모든 백그라운드 에이전트를 종료합니다.

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

세션 기록 및 연속 기록을 포함한 자세한 대화 및 사용 통계를 표시합니다.

/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

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

역방향 검색

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

Claude Code를 IDE에 연결합니다.

/agents

에이전트 및 팀원 옵션을 엽니다.

/hooks

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

/config

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

/statusline

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

Shift + Tab
Alt + M

권한 모드를 전환합니다.

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으로 서브에이전트 frontmatter와 동일한 필드에 prompt 필드를 더해 사용자 지정 서브에이전트를 동적으로 정의합니다.

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

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

$claude --effort high

시작 시 세션의 노력 수준을 설정합니다: low, medium, high 또는 max (Opus 전용, 세션 범위).

$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 구성을 무시합니다.

도움말 및 발견

/help

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

/skills

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

/release-notes

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

/feedback
/bug

Claude Code에 대한 피드백을 제출하거나 버그를 보고합니다.

?

현재 환경의 단축키 범례를 엽니다.