Claude Code Cheat Sheet

설치 및 시작

설치 방법

npm 설치	`npm install -g @anthropic-ai/claude-code`
실행	`claude`
업데이트	`npm update -g @anthropic-ai/claude-code`
버전 확인	`claude --version`

Node.js 18+ 버전이 필요합니다. 처음 실행 시 Anthropic 계정 인증이 필요합니다.

인증 설정

로그인	`/login`
로그아웃	`/logout`
API 키 사용	`ANTHROPIC_API_KEY=sk-xxx claude`
계정 상태	`/status`

Anthropic Console에서 API 키를 발급받거나, Claude Pro/Max 구독으로 사용 가능합니다.

기본 사용법

대화형 모드

시작	`claude`
특정 디렉토리	`claude /path/to/project`
이전 대화 계속	`claude -c`
대화 이력 선택	`claude -r`

원라이너 모드

단일 명령	`claude -p "테스트 작성해줘"`
JSON 출력	`claude -p "설명해줘" --output-format json`
파이프 입력	`cat file.ts \| claude -p "리뷰해줘"`
스트리밍	`claude -p "코드 작성" --output-format stream-json`

출력 형식

`text`	기본 텍스트 출력 (기본값)
`json`	JSON 형식 (대화 완료 후)
`stream-json`	실시간 JSON 스트림

도구 권한 모드

`--allowedTools`	특정 도구만 허용
`--disallowedTools`	특정 도구 차단
`--dangerouslySkipPermissions`	모든 권한 검사 건너뛰기

--dangerouslySkipPermissions는 신뢰할 수 있는 환경에서만 사용하세요!

슬래시 명령어

세션 관리

`/clear`	대화 기록 초기화
`/compact`	대화 요약 및 컨텍스트 압축
`/status`	계정 및 세션 상태 확인
`/cost`	현재 세션 비용 확인

작업 명령어

`/init`	CLAUDE.md 프로젝트 설정 파일 생성
`/add-dir <path>`	추가 작업 디렉토리 지정
`/model`	사용할 모델 변경
`/permissions`	권한 설정 관리

파일 및 컨텍스트

`/context`	현재 컨텍스트 파일 확인
`/memory`	CLAUDE.md 메모리 파일 편집
`/review`	코드 리뷰 요청
`/pr-comments`	PR 코멘트 처리

시스템

`/help`	도움말 표시
`/config`	설정 열기
`/bug`	버그 리포트 제출
`/doctor`	설치 상태 진단
`/quit`	Claude Code 종료

MCP 관련

`/mcp`	MCP 서버 상태 확인
`/install-github-app`	GitHub 앱 설치
`/ide`	IDE 통합 설정
`/terminal-setup`	터미널 설정 도우미

개발자 도구

`/vim`	Vim 모드 토글
`/diff`	diff 보기 모드 변경
`/theme`	테마 변경

키보드 단축키

입력 및 탐색

macOS 🐧 Linux ⊞ Windows

단축키	설명	단축키	설명
Enter	메시지 전송	Ctrl+L	화면 지우기
Shift+Enter	줄바꿈	Ctrl+R	히스토리 검색
Ctrl+C	현재 작업 중단	Ctrl+U	현재 줄 전체 삭제
Ctrl+D	세션 종료	Ctrl+K	커서~줄 끝 삭제
↑ / ↓	이전/다음 메시지	Tab	자동완성
Esc	현재 입력 취소

단축키	설명	단축키	설명
Return	메시지 전송	⌘+K	화면 지우기
⇧+Return	줄바꿈	⌃+R	히스토리 검색
⌃+C	현재 작업 중단	⌃+U	현재 줄 전체 삭제
⌃+D	세션 종료	⌃+K	커서~줄 끝 삭제
↑ / ↓	이전/다음 메시지	Tab	자동완성
Esc	현재 입력 취소

단축키	설명	단축키	설명
Enter	메시지 전송	Ctrl+L	화면 지우기
Shift+Enter	줄바꿈	Ctrl+R	히스토리 검색
Ctrl+C	현재 작업 중단	Ctrl+U	현재 줄 전체 삭제
Ctrl+D	세션 종료	Ctrl+K	커서~줄 끝 삭제
↑ / ↓	이전/다음 메시지	Tab	자동완성
Esc	현재 입력 취소

권한 응답

y	이번만 허용
n	거부
a	항상 허용 (세션)
!	한 번만 허용 후 재시도 안 함

Vim 모드 (활성화 시)

i	삽입 모드
Esc	일반 모드
v	비주얼 모드
:	명령 모드

/vim 명령어로 Vim 모드를 토글할 수 있습니다.

CLI 옵션

주요 CLI 플래그

옵션	축약	설명
`--print`	`-p`	비대화형 모드로 단일 프롬프트 실행
`--continue`	`-c`	가장 최근 대화 계속하기
`--resume`	`-r`	대화 선택기로 이전 대화 재개
`--model`	`-m`	사용할 모델 지정 (예: claude-sonnet-4-20250514)
`--output-format`		출력 형식: text, json, stream-json
`--max-turns`		비대화형 모드에서 최대 턴 수 제한
`--system-prompt`		사용자 정의 시스템 프롬프트
`--allowedTools`		허용할 도구 목록 (쉼표 구분)
`--disallowedTools`		차단할 도구 목록 (쉼표 구분)
`--permission-mode`		권한 모드: default, plan, bypassPermissions
`--dangerously-skip-permissions`		⚠️ 모든 권한 확인 건너뛰기 (신뢰된 환경에서만 사용)
`--verbose`		상세 로그 출력

설정

설정 파일 위치

macOS 🐧 Linux ⊞ Windows

전역 설정	`%USERPROFILE%\.claude\settings.json`
프로젝트 설정	`.claude\settings.json`
로컬 설정	`.claude\settings.local.json`

전역 설정	`~/.claude/settings.json`
프로젝트 설정	`.claude/settings.json`
로컬 설정	`.claude/settings.local.json`

전역 설정	`~/.claude/settings.json`
프로젝트 설정	`.claude/settings.json`
로컬 설정	`.claude/settings.local.json`

우선순위: 로컬 > 프로젝트 > 전역. 로컬 설정은 .gitignore에 추가하세요.

설정 예시

{
  "model": "claude-sonnet-4-20250514",
  "permissions": {
    "allow": ["Bash(*)", "Read(*)", "Write(*)"],
    "deny": []
  }
}

환경 변수

`ANTHROPIC_API_KEY`	API 키 설정
`CLAUDE_MODEL`	기본 모델 설정
`CLAUDE_CONFIG_DIR`	설정 디렉토리 경로
`HTTP_PROXY`	프록시 서버 설정

권한 패턴

`Bash(*)`	모든 Bash 명령 허용
`Bash(npm:*)`	npm 명령만 허용
`Read(*)`	모든 파일 읽기 허용
`Write(src/*)`	src 폴더만 쓰기 허용
`mcp__서버명__도구명`	특정 MCP 도구 허용

MCP 서버

MCP 설정 파일

macOS 🐧 Linux ⊞ Windows

전역	`%USERPROFILE%\.claude\mcp_servers.json`
프로젝트	`.claude\mcp_servers.json`

전역	`~/.claude/mcp_servers.json`
프로젝트	`.claude/mcp_servers.json`

전역	`~/.claude/mcp_servers.json`
프로젝트	`.claude/mcp_servers.json`

MCP (Model Context Protocol)는 Claude Code의 기능을 확장하는 서버입니다.

MCP 설정 예시

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-server-github"],
      "env": { "GITHUB_TOKEN": "${GITHUB_TOKEN}" }
    }
  }
}

MCP 명령어

`/mcp`	연결된 MCP 서버 목록
`claude mcp add`	MCP 서버 추가
`claude mcp remove`	MCP 서버 제거
`claude mcp list`	설정된 서버 목록

훅 (Hooks)

훅 이벤트 종류

`PreToolUse`	도구 실행 전
`PostToolUse`	도구 실행 후
`Notification`	알림 발생 시
`Stop`	Claude 응답 완료 시

훅 설정 예시

{
  "hooks": {
    "PostToolUse": [{
      "matcher": "Write",
      "hooks": [{
        "type": "command",
        "command": "npm run lint --fix $CLAUDE_FILE_PATH"
      }]
    }]
  }
}

훅 환경 변수

`$CLAUDE_TOOL_NAME`	실행 중인 도구 이름
`$CLAUDE_TOOL_INPUT`	도구 입력 (JSON)
`$CLAUDE_FILE_PATH`	대상 파일 경로
`$CLAUDE_FILE_CONTENT`	파일 내용

훅 응답

Exit 0	성공, 계속 진행
Exit 2	도구 실행 차단
stdout JSON	Claude에게 피드백 전달

훅에서 {"decision": "block", "reason": "이유"}를 출력하면 도구 실행을 막을 수 있습니다.

메모리 관리 (CLAUDE.md)

CLAUDE.md 파일 위치

macOS 🐧 Linux ⊞ Windows

프로젝트 루트	`.\CLAUDE.md`
전역	`%USERPROFILE%\.claude\CLAUDE.md`
로컬 (gitignore)	`.\CLAUDE.local.md`

프로젝트 루트	`./CLAUDE.md`
전역	`~/.claude/CLAUDE.md`
로컬 (gitignore)	`./CLAUDE.local.md`

프로젝트 루트	`./CLAUDE.md`
전역	`~/.claude/CLAUDE.md`
로컬 (gitignore)	`./CLAUDE.local.md`

/init 명령어로 프로젝트 CLAUDE.md를 생성할 수 있습니다.

CLAUDE.md 내용 예시

# 프로젝트 정보
이 프로젝트는 React + TypeScript 웹앱입니다.

## 빌드 명령어
- 개발: `npm run dev`
- 테스트: `npm run test`

## 주의사항
- .env 파일 수정 금지

메모리 명령어

`/memory`	메모리 파일 편집
`/init`	프로젝트 CLAUDE.md 생성
"이것 기억해"	Claude가 CLAUDE.md에 저장

메모리 우선순위

1순위	현재 디렉토리 CLAUDE.md
2순위	상위 디렉토리 CLAUDE.md
3순위	홈 디렉토리 CLAUDE.md
병합	모든 파일 내용이 병합됨

팁과 트릭

효과적인 프롬프트

구체적으로	"로그인 함수에 에러 핸들링 추가해줘"
파일 지정	"src/auth.ts 파일을 수정해줘"
단계별 요청	"1. 먼저 분석하고 2. 수정해줘"
컨텍스트 제공	"이 프로젝트는 Express 서버야"

자주 쓰는 워크플로우

# 버그 수정
"이 에러를 수정해줘: [에러 메시지]"

# 코드 리뷰
"이 PR을 리뷰하고 개선점 알려줘"

# 테스트 작성
"이 함수에 대한 단위 테스트 작성해줘"

생산성 팁

이미지 첨부	스크린샷을 드래그하여 붙여넣기
URL 공유	웹페이지 URL을 직접 입력
컨텍스트 압축	`/compact`로 토큰 절약
대화 계속	`claude -c`로 빠르게 복귀

트러블슈팅

인증 오류	`/logout` 후 다시 로그인
느린 응답	`/compact`로 컨텍스트 정리
MCP 오류	`/mcp`로 서버 상태 확인
설정 문제	`/doctor`로 진단

CI/CD 통합

# GitHub Actions 예시
- name: Claude Code Review
  run: |
    npm i -g @anthropic-ai/claude-code
    claude -p "PR 리뷰해줘" --output-format json
  env:
    ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_KEY }}

보안 모범 사례

API 키	환경변수로만 관리
민감 파일	.env, credentials 제외
권한 검토	허용 전 명령어 확인
로컬 설정	settings.local.json 사용

`server-github`	GitHub API 통합
`server-filesystem`	파일시스템 확장 접근
`server-postgres`	PostgreSQL 데이터베이스
`server-puppeteer`	브라우저 자동화
`server-slack`	Slack 통합

설치 및 시작

설치 방법

인증 설정

기본 사용법

대화형 모드

원라이너 모드

출력 형식

도구 권한 모드

슬래시 명령어

세션 관리

작업 명령어

파일 및 컨텍스트

시스템

MCP 관련

개발자 도구

키보드 단축키

입력 및 탐색

권한 응답

Vim 모드 (활성화 시)

CLI 옵션

주요 CLI 플래그

설정

설정 파일 위치

설정 예시

환경 변수

권한 패턴

MCP 서버

MCP 설정 파일

MCP 설정 예시

인기 MCP 서버

MCP 명령어

훅 (Hooks)

훅 이벤트 종류

훅 설정 예시

훅 환경 변수

훅 응답

메모리 관리 (CLAUDE.md)

CLAUDE.md 파일 위치

CLAUDE.md 내용 예시

메모리 명령어

메모리 우선순위

팁과 트릭

효과적인 프롬프트

자주 쓰는 워크플로우

생산성 팁

트러블슈팅

CI/CD 통합

보안 모범 사례