Claude Code 주요 명령어 & 단축키¶

한 줄 정의¶

Claude Code를 조종하는 리모컨 버튼 모음. 모드 전환, 설정, 세션 관리까지.

비유¶

TV 리모컨. 채널(모드)을 바꾸고, 볼륨(모델)을 조절하고, 설정 메뉴를 여는 버튼들. 자주 쓰는 버튼 몇 개만 알면 충분하다.

1. 모드 전환 (가장 중요)¶

3가지 모드¶

모드	뜻	뭘 자동으로	뭘 물어봄	비유
기본 (시작 상태)	전부 물어봄	없음	파일 수정 + Bash 전부	신입사원
Accept Edits ON	파일 수정만 자동	파일 읽기/수정/생성	Bash 명령 (python, git 등)	믿을 만한 직원
Plan	읽기만 가능	없음 (수정 불가)	-	컨설턴트

전환 방법¶

Shift + Tab ← 이것만 기억하면 된다

기본 → Accept Edits ON → Plan → 기본 → ...
(누를 때마다 순환)

또는 슬래시 명령어: - /plan - Plan Mode 직접 진입

시작할 때부터 모드 지정:

claude --permission-mode plan           # 계획 모드로 시작
claude --permission-mode auto-accept    # Accept Edits로 시작

언제 어떤 모드?¶

"뭘 해야 할지 먼저 파악하고 싶다"  → Plan Mode
"빨리빨리 작업 진행해"              → Accept Edits ON
"중요한 파일이라 하나하나 확인할래"  → 기본

Accept Edits + settings.json = 최적 조합¶

Accept Edits ON 상태에서 settings.json 퍼미션까지 설정하면:

파일 수정      → 자동 (Accept Edits가 처리)
python, node   → 자동 (settings.json이 처리)
git add/commit → 자동 (settings.json이 처리)
git push, rm   → 물어봄 (위험한 건 보호)

skip-permissions의 90% 편의성 + 위험 차단.

skip-permissions (비상용)¶

claude --dangerously-skip-permissions    # 전부 자동 (위험!)

- 모든 걸 묻지 않고 실행 - 파일 삭제, git push 포함 - 사용 시 반드시 git 세이브 포인트 먼저 만들기 - 일반적으로는 Accept Edits + settings.json이 더 안전한 대안

2. 슬래시 명령어 (자주 쓰는 것만)¶

명령어	기능	언제 쓰나
`/help`	도움말	뭔가 막힐 때
`/plan`	Plan Mode 진입	복잡한 작업 전 계획부터
`/model`	모델 변경 (Opus/Sonnet/Haiku)	비용 절약 or 더 강력한 모델 필요할 때
`/permissions`	권한 설정	특정 명령 자동 허용/차단
`/mcp`	MCP 서버 연결 상태 확인	노션 등 외부 서비스 쓰기 전
`/clear`	대화 초기화	컨텍스트가 꼬였을 때
`/compact`	대화 요약 압축	대화가 길어져서 느려질 때
`/status`	현재 상태 확인	모델/모드/설정 한눈에 보기
`/fast`	Fast Mode 토글	같은 Opus인데 출력 속도 빠르게

3. 키보드 단축키¶

단축키	기능	메모
`Shift + Tab`	모드 순환 (기본→Accept Edits→Plan)	가장 자주 씀
`Alt + P`	모델 변경	입력 중에도 바로 전환
`Alt + T`	Extended Thinking 토글	깊은 사고 켜기/끄기
`Ctrl + C`	현재 작업 중단	Claude가 너무 오래 걸릴 때
`Ctrl + O`	Thinking 내용 보기	Claude의 생각 과정 엿보기
`Esc`	입력 취소	쓰던 내용 지우기

4. CLI 시작 옵션 (터미널에서)¶

# 기본 실행
claude

# 특정 모델로 시작
claude --model opus
claude --model sonnet
claude --model haiku

# 모드 지정해서 시작
claude --permission-mode plan
claude --permission-mode auto-accept

# 한 줄 명령 실행 (대화 없이)
claude -p "이 폴더 구조 설명해줘"

# 이전 대화 이어서
claude --continue
claude -c

5. 실전 조합 패턴¶

패턴 A: 복잡한 작업 (안전하게)¶

1. Plan Mode로 시작 (Shift+Tab × 2)
2. "이 프로젝트 리팩토링 계획 세워줘"
3. 계획 확인 후 → Shift+Tab으로 기본 모드 전환
4. 하나씩 승인하며 진행

패턴 B: 반복 작업 (빠르게)¶

1. Accept Edits 전환 (Shift+Tab × 1)
2. "테스트 돌리고 에러 수정해줘"
3. 파일 수정은 자동, Bash만 확인

패턴 C: 비용 절약¶

1. /model → haiku 선택 (간단한 작업)
2. 복잡한 부분만 /model → opus 전환

6. 컨텍스트 관리 팁 (컴팩트 늦추기)¶

Claude Code는 대화 토큰이 쌓이면 자동으로 "컴팩트"(요약 압축)를 한다. 컴팩트가 되면 앞부분 대화 내용이 요약되어 디테일이 사라질 수 있다.

컴팩트를 빨리 일으키는 원인¶

원인	설명
VS Code 탭 많이 열어두기	열린 파일이 수정될 때마다 변경 diff가 매 턴 system-reminder로 붙음. 파일 2개만 열어도 매번 60~90줄씩 추가 소모
긴 파일 반복 수정	Read → Edit 할 때마다 파일 내용이 컨텍스트에 쌓임
한 세션에 너무 많은 작업	주제가 바뀌면 `/clear`로 새 세션 시작하는 게 효율적

컨텍스트 아끼는 방법¶

1. 수정 끝난 파일은 VS Code에서 탭 닫기 (X)
   → diff가 더 이상 안 붙어서 토큰 절약

2. 작업 중 아닌 파일도 탭 닫기
   → 열어만 놔도 매 턴 diff 발생

3. 주제 바뀌면 /clear 또는 새 세션
   → 이전 대화 토큰이 사라져서 여유 생김

4. 긴 파일은 필요한 부분만 Read (offset/limit)
   → 전체 읽기 대비 토큰 절약

5. CLAUDE.md에 핵심만 유지 (~10KB 이하)
   → 매 세션 시작 시 전부 읽히므로 가벼울수록 좋음

비유¶

토큰 = 회의실 화이트보드. 공간이 한정되어 있다. 열린 탭이 많으면 매번 "어제 바뀐 내용" 메모가 붙어서 화이트보드가 빨리 찬다. 안 쓰는 메모는 떼어놓고, 필요할 때 다시 붙이면 된다.

7. Windows Terminal 세팅 (바이브코딩 강의용)¶

Claude Code를 Windows Terminal에서 쓸 때 필요한 설정들.

Shift+Enter 줄바꿈 해결¶

문제: Windows Terminal에서 Shift+Enter가 줄바꿈 안 됨 (Enter와 동일하게 전송됨)
원인: Windows Terminal이 Enter와 Shift+Enter를 구분 못함 (XTerm 인코딩 한계)
해결: Windows Terminal settings.json의 actions 배열에 추가:

{
    "command": {
        "action": "sendInput",
        "input": "\u000A"
    },
    "keys": "shift+enter"
}

파일 위치: %LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json
대체 방법: Ctrl+Enter 또는 \ + Enter도 줄바꿈 가능

참고¶

공식 문서
/help 치면 전체 명령어 목록 나옴
모르겠으면 Shift+Tab과 슬래시(/) 두 가지만 기억