본문으로 건너뛰기
콰이어트 노트QUIET NOTES

초보자가 꼭 알아야 할 Claude Code 단축키 TOP 10

콰이어트·약 9분 읽기
QUIET NOTES / AI

Claude Code를 처음 설치하고 터미널을 열었을 때, GUI 에디터에 익숙한 분들은 당황할 수 있습니다. 마우스 클릭 대신 키보드로 모든 걸 해야 하니까요. 하지만 걱정 마세요. 핵심 단축키 몇 가지만 익히면 오히려 GUI보다 훨씬 빠르게 작업할 수 있습니다.

이 글에서는 Claude Code 초보자가 꼭 알아야 할 단축키와 명령어를 실용적인 예시와 함께 정리했습니다.

1. 터미널 기본 제어 단축키

Ctrl+C: 실행 중단하기

Claude가 너무 긴 답변을 생성하거나, 원하지 않는 방향으로 코드를 작성할 때 즉시 중단할 수 있습니다.

# Claude가 긴 파일을 읽고 있을 때
Ctrl+C
# → 즉시 중단됨

팁: Ctrl+C를 두 번 연속 누르면 Claude Code 자체를 종료합니다.

Ctrl+D: 대화 종료하기

현재 대화를 깔끔하게 종료하고 새 세션을 시작할 때 사용합니다.

# 대화 중 Ctrl+D 입력
# → "Goodbye!" 메시지와 함께 종료

Ctrl+L: 화면 정리하기

터미널 화면이 너무 복잡해졌을 때 시원하게 정리할 수 있습니다. 대화 기록은 유지되고 화면만 깨끗해집니다.

Ctrl+L
# → 화면 클리어, 대화는 계속됨

2. 명령어 히스토리 탐색

Up/Down 화살표: 이전 명령어 다시 사용하기

이전에 입력했던 질문이나 명령어를 다시 사용할 때 편리합니다.

# 이전 질문: "이 함수 설명해줘"
Up 키 → 이전 명령어 표시
Down 키 → 다음 명령어 표시

Ctrl+R: 명령어 검색하기

과거에 입력했던 긴 명령어를 빠르게 찾을 때 사용합니다.

Ctrl+R
# "search:" 프롬프트 표시됨
# "함수" 입력 → 과거에 "함수"가 포함된 명령어 검색

3. 핵심 슬래시 명령어

Claude Code는 /로 시작하는 특수 명령어를 지원합니다. 메뉴나 설정 화면 없이 모든 걸 명령어로 제어합니다.

/help: 도움말 보기

모든 명령어 목록과 사용법을 확인할 수 있습니다.

/help
# → 사용 가능한 모든 명령어 목록 표시

/clear: 대화 내역 삭제하기

새로운 주제로 시작하거나, 컨텍스트를 리셋하고 싶을 때 사용합니다.

/clear
# → 이전 대화 모두 삭제, 새 세션 시작

/model: AI 모델 변경하기

작업에 따라 더 빠른 모델이나 더 강력한 모델로 전환할 수 있습니다.

/model
# → 사용 가능한 모델 목록 표시
# 선택: Opus 4.5, Sonnet 4.5 등

언제 바꾸나요?

  • 간단한 질문: Sonnet (빠르고 비용 효율적)
  • 복잡한 코드 리팩토링: Opus (더 정확하고 강력함)

/cost: 사용 비용 확인하기

현재 세션에서 사용한 API 비용을 실시간으로 확인할 수 있습니다.

/cost
# → Input tokens, Output tokens, 총 비용 표시

/compact: 간결한 응답 모드

Claude의 응답을 더 짧고 간결하게 받고 싶을 때 켭니다.

/compact on   # 간결 모드 켜기
/compact off  # 다시 상세 모드로

/init: 프로젝트 초기화

새 프로젝트를 시작할 때 Claude에게 프로젝트 구조를 설명합니다.

/init
# → 현재 디렉토리의 파일 구조 분석
# → 프로젝트 컨텍스트 자동 설정

/vim: Vim 모드 활성화

터미널 입력을 Vim 키바인딩으로 제어하고 싶은 분들을 위한 모드입니다.

/vim on   # Vim 모드 켜기
/vim off  # 일반 모드로

4. 특수 접두사: @, #, !

Claude Code는 특수 기호로 강력한 기능을 제공합니다.

@: 파일 참조하기

파일 내용을 Claude에게 전달할 때 사용합니다. 파일 경로를 직접 입력할 필요 없이 자동 완성됩니다.

@app.py 이 파일의 버그를 찾아줘

# 여러 파일 동시 참조도 가능
@utils.py @config.py 이 두 파일의 연관성을 설명해줘

자동 완성 팁: @를 입력하고 Tab 키를 누르면 현재 디렉토리의 파일 목록이 표시됩니다.

#: 메모리 기능

대화 중 중요한 정보를 저장하고 나중에 다시 불러올 수 있습니다.

# 정보 저장
#save API_KEY=abc123

# 나중에 불러오기
#recall API_KEY
# → "저장된 API_KEY: abc123"

!: Bash 명령어 실행하기

Claude에게 묻지 않고 바로 셸 명령어를 실행합니다.

!ls -la
# → 현재 디렉토리 파일 목록 즉시 표시

!git status
# → git 상태 즉시 확인

주의: ! 없이 “ls 실행해줘”라고 하면 Claude가 설명과 함께 실행하지만, !ls는 즉시 실행됩니다.

5. 멀티라인 입력 방법

긴 코드 블록이나 여러 줄의 질문을 입력할 때 유용합니다.

방법 1: 백슬래시 + Enter

이 함수를 \
리팩토링해줘 \
더 읽기 쉽게

# → 세 줄이 하나의 입력으로 처리됨

방법 2: Option+Enter (Mac) / Alt+Enter (Windows/Linux)

# 첫 줄 입력 후 Option+Enter
def calculate():
    # Option+Enter로 줄바꿈
    return result
    # Option+Enter로 줄바꿈
# 마지막에 일반 Enter로 전송

방법 3: Shift+Enter

대부분의 터미널에서 Shift+Enter도 멀티라인 입력을 지원합니다.

6. 효율 높이는 조합 활용법

빠른 파일 수정 워크플로우

# 1. 파일 참조
@server.js 이 파일의 라우팅 로직을 분석해줘

# 2. 수정 요청
/compact on
여기서 /api/users 엔드포인트만 별도 파일로 분리해줘

# 3. 비용 확인
/cost

프로젝트 컨텍스트 설정

# 1. 프로젝트 초기화
/init

# 2. 주요 파일 참조
@package.json @README.md

# 3. 질문
이 프로젝트의 구조를 설명하고, 새로운 기능 추가를 위한 가이드라인을 알려줘

7. 실전 시나리오별 단축키 사용

시나리오 1: 버그 수정

# 에러 파일 빠르게 참조
@error.log @app.py

# 질문
이 에러의 원인을 찾아서 수정해줘

# 작업 중 화면이 복잡해지면
Ctrl+L

시나리오 2: 코드 리뷰

# 모델을 Opus로 변경 (더 정밀한 분석)
/model
# → Opus 4.5 선택

# 여러 파일 동시 참조
@src/main.py @src/utils.py @tests/test_main.py

# 리뷰 요청
코드 품질과 테스트 커버리지를 검토해줘

시나리오 3: 빠른 프로토타이핑

# 간결 모드로 전환
/compact on

# 이전 명령어 재활용
Up 키로 이전 요청 불러오기

# 즉시 실행 확인
!python prototype.py

8. 초보자가 자주 실수하는 것들

실수 1: Ctrl+C를 두 번 눌러서 종료

# 잘못된 사용
Ctrl+C Ctrl+C  # → Claude Code 종료됨

# 올바른 사용
Ctrl+C  # → 현재 작업만 중단

실수 2: @와 ! 혼동

# 파일 내용을 보여주기만 할 때
@config.py

# 명령어를 실행할 때
!cat config.py  # → 실제 파일 내용 출력

실수 3: /clear와 Ctrl+L 혼동

/clear    # → 대화 내역 삭제 (컨텍스트 리셋)
Ctrl+L    # → 화면만 정리 (대화는 유지)

9. 나만의 단축키 치트시트 만들기

자주 쓰는 명령어를 메모해두면 훨씬 효율적입니다.

# 내 작업 스타일에 맞는 세팅
/compact on          # 항상 간결 모드
/model → Sonnet 4.5  # 기본 모델

# 자주 쓰는 조합
@src/ 전체 프로젝트 분석
!pytest tests/       # 테스트 즉시 실행
/cost                # 비용 체크

10. 다음 단계: 고급 활용

기본 단축키에 익숙해졌다면 이런 것들도 시도해보세요:

  • MCP 서버 연동: Claude에게 외부 도구 접근 권한 부여
  • 커스텀 프롬프트: .clauderc 파일로 자동 설정
  • 워크플로우 자동화: Bash 스크립트와 Claude Code 연동

마무리

Claude Code의 단축키는 처음엔 낯설지만, 일주일만 사용하면 손에 익습니다. 이 글에서 소개한 TOP 10 단축키만 기억하세요:

  1. Ctrl+C – 중단
  2. Ctrl+L – 화면 정리
  3. Up/Down – 히스토리 탐색
  4. /help – 도움말
  5. /clear – 대화 리셋
  6. /model – 모델 변경
  7. /cost – 비용 확인
  8. @file – 파일 참조
  9. !command – 즉시 실행
  10. +Enter – 멀티라인 입력

하나씩 실습하다 보면, 어느새 마우스 없이도 더 빠르게 코딩하는 자신을 발견하게 될 겁니다.

다음 글 예고: “Claude Code로 10분 만에 풀스택 앱 만들기”에서는 실제 프로젝트를 처음부터 끝까지 만들어봅니다.

이해가 쌓이는 곳, 콰이어트 노트

궁금한 점이나 더 나은 설명이 있다면 알려주세요.

의견 보내기

KEEP EXPLORING