🤖 14. 치트시트로 끝내는 단축키·명령어·MCP

Claude Code를 오래 써도 이상하게 계속 헷갈리는 구간이 있다. 세션을 비워야 할 때는 언제인지, 어떤 키를 외워두면 작업 속도가 바로 올라가는지, MCP는 어느 scope에 넣어야 사고가 적은지 같은 것들이다. 이런 건 기능 하나를 깊게 파는 글보다 작업 도중 바로 다시 보는 한 장짜리 참조판이 더 쓸모 있다.

StoryFox의 Claude Code Cheat Sheet는 이 역할을 잘한다. 다만 실무에서는 커뮤니티 치트시트만 보고 끝내면 안 된다. 실제 동작 기준은 결국 공식 문서다. 그래서 여기서는 치트시트의 핵심을 가져오되, Overview, CLI reference, Settings, MCP 문서로 교차 확인해 바로 써먹는 운영 기준으로 다시 정리한다.

flowchart LR
  A["작업 중 막힘"] --> B{"무엇이 문제인가?"}
  B -->|손이 느림| C["단축키 기억"]
  B -->|세션이 꼬임| D["슬래시 명령 정리"]
  B -->|도구 연결 혼란| E["MCP transport · scope 정리"]
  C --> F["빠른 입력 · 중단 · 백그라운드"]
  D --> G["clear · compact · resume · permissions"]
  E --> H["http · stdio · local · project · user"]
  F --> I["실전 속도 상승"]
  G --> I
  H --> I

🧠 칠판 치트시트

매일 외울 건 전부가 아니라 자주 쓰는 10개다.

세션 정리는 /clear, /compact, /resume, /rewind 네 축으로 기억하면 된다.

MCP는 먼저 HTTP가 우선, 저장 범위는 local → project → user 순서로 판단한다.

치트시트는 커뮤니티 요약이고, 실제 운영 기준은 공식 문서로 재확인한다.

새 버전 메모는 “바뀐 키 1개, 바뀐 설정 1개, 바뀐 훅 1개”만 먼저 익혀도 충분하다.

이 글에서 먼저 챙길 핵심

이번 글의 결론은 단순하다. Claude Code에서 체감 속도를 가장 많이 바꾸는 건 거창한 프롬프트 재주가 아니라, 입력 속도·세션 정리·도구 연결 규칙 세 가지다. 치트시트는 이 세 가지를 한 화면에서 보게 해주는 지도에 가깝다.

공식 개요 문서가 말하듯 Claude Code는 단순 답변기가 아니라 코드를 읽고, 수정하고, 명령을 실행하고, 외부 도구까지 붙여 쓰는 agentic coding tool이다. 그래서 작업 병목도 “모델이 멍청해서”보다 “내가 세션과 도구를 어떻게 운용하느냐”에서 더 자주 생긴다. 바로 이 지점에서 치트시트가 힘을 발휘한다.

공식 개요: Claude Code overview

1) 먼저 외워두면 바로 체감되는 단축키 10개

치트시트에는 더 많은 키가 있지만, 실무에서는 다 외울 필요가 없다. 아래 10개만 손에 붙어도 체감이 확 달라진다. 운영체제별 실제 키 조합은 StoryFox 페이지에서 Mac/Windows 토글로 확인하면 되고, 여기서는 무슨 상황에서 왜 쓰는지에 집중하는 편이 더 중요하다.

입력을 멈추고 다시 잡는 키

Ctrl+C: 입력 또는 생성 중단
Esc → Esc: 되감기/undo 계열 작업
Ctrl+G 또는 Ctrl+X Ctrl+E: 프롬프트를 에디터에서 열기

긴 지시를 쓰다 보면, 중간에 생각이 바뀌거나 요구사항을 더 길게 정리해야 할 때가 자주 생긴다. 이때 한 줄 입력창 안에서 버티면 오히려 문장이 짧아지고, 중요한 조건을 빼먹기 쉽다. 에디터 열기 단축키는 “프롬프트를 한 문장으로 우겨 넣는 방식”에서 “짧은 스펙 문서처럼 쓰는 방식”으로 넘어가게 해준다.

미니 사례 A

Before: 긴 구현 지시를 입력창에서 적다가 중간에 끊기고, 핵심 검증 조건을 누락함
After: 에디터로 열어 목표 / 제약 / 검증 / 금지사항을 4줄로 적고 전송함
변화: Claude가 되묻는 횟수가 줄고 첫 시도 정확도가 올라감

작업 흐름을 끊지 않는 키

Ctrl+B: 오래 걸리는 작업을 백그라운드로 보내기
Ctrl+T: task list 토글
Ctrl+R: 히스토리 reverse search

긴 테스트나 빌드가 돌 때 Claude Code 전체를 같이 붙잡고 있으면 답답함이 커진다. 백그라운드 전환과 task list 확인은 “기다리는 작업”과 “지금 할 작업”을 분리해 준다. 이건 특히 프런트엔드 빌드, 대규모 테스트, 로그 확인 작업이 많은 사람에게 효과가 크다.

검증 포인트

긴 작업을 시작한 뒤 다음 질문을 자연스럽게 이어갈 수 있는가
task list를 보고 현재 진행 항목을 10초 안에 파악할 수 있는가

세션 관리용으로 꼭 기억할 키

Ctrl+L: 화면 정리
Ctrl+O: verbose 출력 토글
Ctrl+X Ctrl+K: 백그라운드 에이전트 종료
Shift+Tab: permission mode 순환

특히 Shift+Tab은 의외로 중요하다. 작업이 단순한데 승인 창이 너무 많이 뜨거나, 반대로 더 조심해야 할 작업인데 과하게 빠르게 진행되고 있다면 permission mode부터 점검해야 하기 때문이다. 공식 설정 문서는 권한과 설정이 어디에 저장되고 어떤 범위에 적용되는지 이해하는 데 꼭 필요하다.

공식 설정 문서: Claude Code settings

2) 슬래시 명령은 “기능 목록”보다 “상황별 묶음”으로 외워야 한다

치트시트에는 /clear, /compact, /resume, /rename, /branch, /cost, /context, /diff, /copy, /rewind, /export, /config, /model, /permissions, /mcp, /hooks, /skills, /agents, /doctor, /usage, /schedule 같은 명령이 한 번에 모여 있다. 문제는 이렇게 나열해두면 많이 보이지만, 막상 실전에서는 기억이 잘 안 난다는 점이다.

그래서 아래처럼 상황별 묶음으로 외우는 편이 낫다.

A. 세션이 꼬였을 때

/clear: 관련 없는 작업으로 넘어갈 때 세션을 비우기
/compact [focus]: 긴 세션을 압축하되 무엇을 남길지 지정하기
/resume: 이전 세션 이어가기
/rewind: 잘못 간 흐름 되감기
/branch: 다른 접근을 분기해서 살려두기

가장 많이 쓰게 되는 묶음은 이 구간이다. 세션 문제는 “Claude가 이상해졌다”보다 “다른 작업 맥락이 섞였다”에서 자주 생긴다. 특히 /clear와 /compact를 구분해서 쓰는 것이 중요하다. 완전히 새 일이라면 /clear, 같은 일인데 너무 길어졌다면 /compact가 더 맞다.

미니 사례 B

Before: 오전 배포 이슈를 보던 세션에서 오후 UI 개선 작업까지 이어감
증상: Claude가 자꾸 예전 로그와 배포 맥락을 끌고 와서 엉뚱한 제안을 함
After: /clear 후 새 목표 1문장만 다시 선언함
변화: 첫 답변의 초점이 바로 맞아짐

B. 세션을 더 잘 보이게 만들 때

/rename [name]: 세션 이름 붙이기
/context: 현재 컨텍스트 상태 보기
/diff: 변경 차이 보기
/copy [N]: 이전 응답 복사
/export: 대화 내보내기

병렬 세션을 2~3개만 열어도 헷갈리기 시작한다. 이때 /rename은 단순 꾸미기가 아니라 안전장치다. “auth-fix”, “review-pr”, “mcp-setup”처럼 이름을 붙여두면 잘못된 세션에 명령을 던지는 사고가 줄어든다.

C. 설정과 운영 규칙을 만질 때

/config: 설정 UI 열기
/permissions: 자주 승인하는 명령 허용/차단 관리
/model [model], /effort [level]: 모델/사고 깊이 조정
/memory, /hooks, /skills, /agents: 상시 규칙과 도구 묶음 관리

이 묶음은 “답변 하나 잘 받기”보다 “다음 세션부터 계속 편해지기”를 만드는 영역이다. 반복되는 마찰이 있다면 프롬프트를 더 잘 쓰기 전에 /permissions, CLAUDE.md, hooks, skills 중 어디로 옮길 수 있는지 먼저 봐야 한다.

D. 운영·분석·자동화용 묶음

/doctor: 설치/환경 진단
/usage: 사용량/제한 확인
/stats, /insights: 세션 패턴과 마찰 분석
/plan: 계획 중심 시작
/loop [interval]: 세션 안 반복 작업
/schedule: 스케줄 작업
/security-review: 변경 보안 리뷰
/desktop, /remote-control: 다른 표면으로 흐름 이어가기

이 구간은 고급 기능처럼 보이지만, 실제로는 “작업 운영”을 다루는 기본 도구에 가깝다. 예를 들어 /doctor는 뭔가 안 될 때만 쓰는 수리용 명령이 아니라, 플러그인·MCP·로그인 상태를 빠르게 점검하는 출발점으로도 좋다.

3) MCP는 transport보다 먼저 scope를 이해해야 사고가 줄어든다

치트시트 페이지가 좋은 이유 중 하나는 MCP를 단순히 “도구 연결 기능”이 아니라, transport와 scope를 같이 보는 구조로 정리해 둔 점이다. 실제 운영에서 더 헷갈리는 건 명령 문법보다 “이 설정을 어디에 저장할 것인가”다.

공식 MCP 문서는 HTTP, SSE, stdio 세 가지 연결 방식을 설명하는데, 현재 기준으로는 HTTP가 권장 경로이고 SSE는 deprecated 경고가 붙어 있다. 로컬 프로세스를 붙일 때는 stdio가 쓰인다.

공식 MCP 문서: Connect Claude Code to tools via MCP

transport는 이렇게 이해하면 쉽다

HTTP: 원격 서비스 연결 기본값. 공식 문서도 권장
SSE: 예전 방식. 아직 남아 있지만 새 셋업이라면 우선순위 낮음
stdio: 내 컴퓨터에서 프로세스를 직접 실행해야 할 때 사용

# HTTP
claude mcp add --transport http notion https://mcp.notion.com/mcp
 
# stdio
claude mcp add --transport stdio airtable -- npx -y airtable-mcp-server

scope는 이렇게 판단하면 실수가 적다

local: 이 저장소에서 나만 쓸 것
project: 팀 전체가 같이 써야 할 것
user: 여러 프로젝트에서 내가 공통으로 쓸 것

공식 settings 문서가 설명하듯 Claude Code는 Managed / User / Project / Local 범위를 구분한다. 팀 전체가 공유할 MCP라면 project가 맞고, 개인 토큰이나 실험성 셋업이면 local 또는 user가 더 안전하다.

미니 사례 C

실패 사례: 개인 토큰이 필요한 MCP 서버를 project 범위로 넣음
문제: 다른 협업자 환경에서 그대로 깨지고, 불필요한 설정 잡음이 생김
개선: 개인 인증이 필요한 서버는 local, 팀 공용 서버만 project로 분리
검증: 새 협업자가 저장소를 받았을 때 추가 오류 없이 실행되는지 확인

공식 scope 설명: Claude Code settings

MCP 관리용으로 기억할 최소 명령

claude mcp list
claude mcp get github
claude mcp remove github

그리고 인터랙티브 세션 안에서는 **/mcp**를 함께 기억해두면 좋다. OAuth가 필요한 서버 상태를 보거나, 연결 상태를 점검할 때 빠르게 들어갈 수 있다.

4) 치트시트가 강조한 최근 변경사항은 이렇게 읽으면 된다

StoryFox 치트시트는 Claude Code v2.1.83 기준으로 몇 가지 변경점을 따로 묶어 보여준다. 이런 “recent changes” 구역은 모든 항목을 외우기보다, 내 운영에 직접 닿는 것부터 확인하는 방식이 효율적이다.

치트시트 페이지 기준 눈에 띄는 항목은 아래다.

managed-settings.d/ 드롭인 정책 조각
CwdChanged, FileChanged hook events
백그라운드 에이전트 종료 키 변경: Ctrl+X Ctrl+K
transcript search 관련 탐색 키
Ctrl+X Ctrl+E 에디터 열기 alias
agent frontmatter의 initialPrompt

이 중에서 공식 설정 문서로 바로 교차 확인되는 대표 항목은 managed-settings.d/다. settings 문서는 시스템 디렉터리 아래 managed-settings.json과 managed-settings.d/ 드롭인 병합 구조를 설명한다. 즉 조직 차원 정책을 한 파일이 아니라 조각 파일로 운영할 수 있다는 뜻이다. 팀 규모가 커질수록 이건 꽤 실전적인 변화다.

반대로 훅 이벤트 세부 동작, 단축키 alias 같은 것은 버전별 release 흐름을 같이 보는 편이 안전하다. 그래서 최근 변경사항은 “무조건 운영 규칙으로 즉시 채택”보다 “내가 자주 쓰는 기능인지 먼저 확인 → 관련 공식 문서로 재검토 → 그다음 도입” 순서가 맞다.

5) 실무자 기준으로 가장 쓸모 있는 15분 도입 루틴

치트시트를 봤다고 바로 생산성이 오르지는 않는다. 실제로는 아래처럼 행동 하나씩 고정해야 체감이 난다.

1단계: 오늘 외울 4개만 정하기

첫날에는 전부 외우지 말고 아래 4개만 손에 붙인다.

/clear
/compact
Ctrl+B
/permissions

이 4개만 익혀도 세션 정리, 긴 작업 처리, 반복 승인 감소까지 한 번에 건드릴 수 있다.

2단계: MCP scope 규칙 한 줄 적기

팀 문서나 CLAUDE.md에 아래처럼 한 줄을 남긴다.

개인 인증이 필요한 MCP는 local, 팀 공용 도구만 project 범위에 둔다.

이 한 줄이 생각보다 많은 삽질을 막는다.

3단계: 내 자주 쓰는 명령 허용목록 정리

공식 settings 문서처럼 반복 실행하고 안전한 명령만 /permissions 또는 설정 파일로 허용한다. 예를 들면 git status, npm test, npm run lint 같은 것들이다. 대신 삭제, 배포, DB 변경은 끝까지 사람 승인에 남겨둔다.

4단계: 치트시트 북마크 + 공식 문서 2개 같이 보관

커뮤니티 요약: https://cc.storyfox.cz/
공식 동작 기준: https://code.claude.com/docs/en/cli-reference
설정/MCP 기준: https://code.claude.com/docs/en/settings, https://code.claude.com/docs/en/mcp

운영 기준은 항상 공식 문서가 마지막 기준점이 되어야 한다.

6) 이 글을 읽고 나면 무엇을 기억하면 되나

정리하면 Claude Code 치트시트의 진짜 가치는 “명령이 많다”가 아니다. 손을 덜 움직이게 하는 키, 세션을 건강하게 유지하는 명령, MCP를 안전하게 저장하는 기준을 한꺼번에 붙여서 보는 데 있다.

그래서 실무에서는 아래만 기억하면 충분하다.

손이 느리면 단축키를 외운다.
세션이 꼬이면 /clear와 /compact부터 본다.
도구 연결이 불안하면 MCP transport보다 scope부터 점검한다.
커뮤니티 치트시트는 빠른 지도이고, 공식 문서는 최종 기준이다.

이 네 줄만 고정해도 Claude Code를 “가끔 잘 되는 도구”가 아니라 계속 안정적으로 쓰는 작업 환경으로 바꾸기 쉬워진다.

다음 읽기

참고 링크

StoryFox 치트시트: https://cc.storyfox.cz/
공식 문서 Overview: https://code.claude.com/docs/en/overview
공식 문서 CLI reference: https://code.claude.com/docs/en/cli-reference
공식 문서 Settings: https://code.claude.com/docs/en/settings
공식 문서 MCP: https://code.claude.com/docs/en/mcp

생성형 AI 활용 고지

이 문서는 공개된 커뮤니티 치트시트와 공식 문서를 교차 확인한 뒤 생성형 AI를 활용해 재구성했으며, 실무에서 바로 적용할 수 있도록 운영 기준과 미니 사례 중심으로 정리했다.

일하는 ai

탐색기