기본 콘텐츠로 건너뛰기

클로드 코드 필수 명령어 5개 — 이것만 알면 됩니다 (왕초보 가이드 6편)

thumbnail

Photo by olivia kim on Unsplash

Claude Code 명령어는 5개만 알면 됩니다. /help, /cost, /compact, /clear, Esc — 매일 쓰는 건 이게 전부입니다.

수십 가지 명령어가 있다고 하니 겁부터 납니다. 처음 터미널을 켰을 때 저도 그랬습니다. 그런데 실제로 한 달 넘게 쓰면서 매일 손이 가는 건 딱 5개뿐이었습니다.


명령어 5개, 한눈에 보기

먼저 전체 그림부터 잡겠습니다. 아래 표 하나면 됩니다.

명령어 한 줄 설명 일상 비유
/help 명령어 목록 보기 회사 내선번호 목록표
/cost 사용 비용 확인 핸드폰 데이터 사용량 확인
/compact 대화 압축 정리 책상 위 서류 핵심만 남기고 정리
/clear 대화 전부 초기화 책상을 싹 치우고 새 일 시작
Esc 멈추기 / 되감기 급브레이크

나머지 명령어는 "이런 게 있구나" 정도만 알아두면 됩니다. 필요할 때 /help로 찾아보면 되니까요.


하나씩 살펴봅니다

1 /help — 모르겠으면 물어보기

일상 비유: 회사에서 내선번호 목록표를 펼치는 것과 같습니다. "이 부서 번호가 몇 번이지?" 할 때 목록표를 보듯이, "이 명령어가 뭐였지?" 할 때 /help를 입력합니다.

/help

사용 가능한 모든 명령어 목록이 한 번에 나옵니다. 각 명령어 옆에 짧은 설명도 붙어 있어서, 처음 보는 명령어도 대충 감이 잡힙니다.

팁: 대화창에서 /만 입력해도 명령어 목록이 자동으로 뜹니다. /help를 치는 것보다 더 빠릅니다.

2 /cost — 지금까지 얼마 썼지?

일상 비유: 핸드폰에서 "이번 달 데이터 얼마나 썼지?" 확인하는 것과 같습니다.

/cost

현재 대화에서 사용한 토큰(token) 양과 비용을 보여줍니다. 토큰은 AI가 읽고 쓰는 글자 수의 단위입니다. 한국어 한 글자가 대략 토큰 1~2개 정도라고 생각하면 됩니다.

  • 구독(Pro/Max) 사용자: 월정액이라 크게 신경 안 써도 됩니다
  • API(종량제) 사용자: 가끔 확인하는 습관을 들이면 좋습니다
참고: 2편에서 요금제를 정리했습니다. 구독과 API 차이가 헷갈리면 다시 확인해보세요.

3 /compact — 대화 정리하기

일상 비유: 책상 위에 서류가 잔뜩 쌓였을 때, 핵심 문서만 남기고 나머지는 치우는 것입니다.

/compact

지금까지의 대화 내용을 핵심만 남기고 압축합니다. AI가 기억하는 양에는 한계(컨텍스트 윈도우)가 있기 때문에, 대화가 길어지면 앞부분을 까먹기 시작합니다. 그때 /compact를 쓰면 됩니다.

언제 쓰면 좋을까요?

  • 대화를 20~30번 넘게 주고받았을 때
  • AI 응답 속도가 눈에 띄게 느려졌을 때
  • AI가 앞에서 말한 내용을 기억 못 할 때
주의: /compact는 요약이지 삭제가 아닙니다. 핵심 맥락은 유지됩니다. 다만 세부 디테일은 날아갈 수 있으니, 중요한 내용은 미리 파일로 저장해두는 게 안전합니다.

4 /clear — 완전히 새로 시작

일상 비유: 책상 위를 싹 치우고 백지 상태에서 새 업무를 시작하는 것입니다. /compact가 "정리"라면 /clear는 "초기화"입니다.

/clear

현재 대화를 완전히 비우고 새 세션을 시작합니다. 주제가 완전히 바뀔 때, 예를 들어 "보고서 작업"을 끝내고 "웹사이트 수정"을 시작할 때 씁니다.

/compact와 /clear, 뭐가 다른가요?

구분 /compact /clear
대화 내용 핵심만 남김 전부 사라짐
맥락 유지 O (요약 상태) X (완전 초기화)
쓰는 상황 같은 주제, 대화가 길어졌을 때 주제가 완전히 바뀔 때
안심 포인트: /clear를 해도 이전 세션이 삭제되는 건 아닙니다. 나중에 claude --resume 명령으로 이전 대화를 다시 이어갈 수 있습니다.

5 Esc 키 — 급할 때 브레이크

일상 비유: 운전 중 급브레이크를 밟는 것입니다. AI가 엉뚱한 방향으로 달려갈 때, 일단 멈추게 하는 버튼입니다.

  • Esc 한 번 누르기: 현재 진행 중인 작업을 멈춥니다. AI가 파일을 수정하고 있는데 "잠깐, 그거 아닌데" 싶을 때 바로 누르면 됩니다.
  • Esc 두 번 누르기: 직전 턴의 변경사항이 되감기(undo)됩니다. AI가 변경한 코드와 대화를 이전 상태로 되돌릴 수 있습니다.
실전 팁: 처음엔 AI가 뭔가 하고 있을 때 멈추기가 좀 무섭습니다. "중간에 끊으면 뭔가 망가지지 않을까?" 걱정되는데, 전혀 그렇지 않습니다. Esc는 안전하게 설계돼 있으니 부담 없이 누르세요.

실전에서 이렇게 씁니다

5개 명령어가 실제로 어떤 흐름으로 쓰이는지, 하루를 예로 들어보겠습니다.

오전 — 보고서 작성 시작

Claude Code를 켜고 "월간 매출 보고서 만들어줘"라고 말합니다. 대화가 길어지면서 AI 응답이 느려집니다. /compact로 정리합니다.

오후 — 다른 작업으로 전환

보고서가 끝났습니다. 이제 웹사이트를 손봐야 합니다. /clear로 새 세션을 시작합니다.

작업 중 — 잘못된 방향

AI가 파일을 수정하기 시작했는데 원하는 방향이 아닙니다. Esc를 눌러 멈추고, 다시 지시합니다.

퇴근 전 — 비용 확인

/cost로 오늘 얼마나 썼는지 한 번 봅니다. API 사용자라면 예산 관리에 도움이 됩니다.


자주 묻는 질문 (FAQ)

Q. /compact를 너무 자주 쓰면 문제가 되나요?

문제는 없지만, 매번 압축할 때마다 세부 디테일이 조금씩 빠집니다. 대화 20~30회 정도를 기준으로, 응답이 느려졌거나 AI가 맥락을 놓쳤을 때 한 번 쓰는 게 적당합니다.

Q. /clear로 날린 대화를 정말 복구할 수 있나요?

네. 터미널에서 claude --resume을 입력하면 이전 세션 목록이 나옵니다. 거기서 원하는 대화를 선택해 이어갈 수 있습니다. 완전 삭제가 아니라 세션 전환에 가깝습니다.

Q. Esc를 눌렀는데 AI가 이미 파일을 바꿔버렸으면 어떡하나요?

Esc를 빠르게 두 번 누르면 직전 턴의 변경사항이 되감기(undo)됩니다. AI가 변경하기 전 상태로 되돌릴 수 있습니다. 4편에서 다룬 권한 설정과 함께 쓰면, AI가 함부로 파일을 바꾸는 일 자체를 줄일 수 있습니다.


정리하며

도구가 복잡해 보일수록, 자주 쓰는 기능 몇 개만 확실히 아는 게 중요합니다. 리모컨에 버튼이 30개 있어도 실제로 누르는 건 전원, 채널, 볼륨 3개뿐인 것처럼요. Claude Code도 마찬가지입니다. /help, /cost, /compact, /clear, Esc — 이 5개면 매일 쓰는 데 전혀 부족하지 않습니다.

여기까지 오셨으면, 5편에서 첫 번째 일을 시켜보고, 이번 편에서 일상적으로 쓰는 명령어까지 익힌 겁니다. 이제 "설치만 해놓고 안 쓰는 앱"이 아니라, 매일 꺼내 쓰는 도구가 됐습니다. 나머지 명령어는 쓰다 보면 자연스럽게 알게 됩니다. 굳이 외우려고 하지 마세요.

관점 한 스푼: AI 도구를 처음 배울 때 가장 큰 허들은 기술이 아니라 심리적 장벽입니다. "이거 잘못 누르면 어떡하지" "뭔가 망가지면 어떡하지." Esc 하나 알아두는 것만으로 그 불안이 절반은 사라집니다. 급브레이크가 있다는 걸 아니까, 이제 엑셀 밟을 수 있는 겁니다.


#멜론 AI 인사이트 #Claude Code #클로드 코드 #비개발자 #초보자 가이드

다음 편에서는 AI한테 업무 매뉴얼을 만들어주는 법을 알아봅니다

7편 — CLAUDE.md 작성법 (발행 시 링크 연결 예정)

참고 자료
· Anthropic 공식 문서 — Claude Code CLI Usage
· Anthropic 공식 문서 — Claude Code Overview

댓글

이 블로그의 인기 게시물

Opus 4.7 제대로 쓰는 법 — Claude Code 팀이 공유한 실전 팁 6가지 2026

Photo by Joshua Woroniecki on Unsplash Opus 4.7로 바꿨는데 "음... 좀 나아진 것 같기도?"로 끝났다면, 모델이 아니라 쓰는 방식이 문제입니다. Claude Code를 만든 팀이 직접 몇 주간 써보고 깨달은 것을 공유했습니다. 솔직히 저도 그랬습니다. Opus 4.7 나왔다길래 바로 써봤는데, 처음엔 "뭐가 달라졌지?" 싶었습니다. 그런데 Boris Cherny(Claude Code 팀)의 팁을 보고 워크플로우를 바꿨더니, 체감이 확 달라졌습니다. 매일 이 블로그를 Claude Code로 운영하면서 하나씩 적용해본 기록입니다. 광고 자리 (AdSense 승인 후 교체) 핵심 요약 — 6가지 팁 한눈에 팁 한줄 요약 적용 방법 Auto mode 권한 프롬프트 자동 판단 Shift+Tab /fewer-permission-prompts 반복 허락 묻기 제거 /fewer-permission-prompts 입력 Recaps 긴 작업 후 요약 자동 제공 자동 (Opus 4.7 기본 탑재) Focus mode 중간 과정 숨기고 결과만 /focus 입력 Effort level 생각 깊이 직접 조절 /effort 입력 검증 수단 제공 AI가 스스로 결과를 확인하게 테스트/브라우저/Computer use 연결 1. Auto mode — 옆에서 지켜보지 마세요 "이 명령어 실행해도 될까요?" — Cla...

클로드 코드 왕초보 가이드 11편 — Git으로 작업 안전하게 저장하기 2026

Photo by carmen dominguez on Unsplash 클로드 코드 왕초보 가이드 — 11편 전체 목차 보기 Claude Code로 파일을 수정하다가 "아, 아까 그 버전이 더 나았는데" 싶은 적 있으신가요? Ctrl+Z를 연타해도 돌아가지 않는 그 순간. Git을 쓰면 무한 Ctrl+Z가 됩니다. 비개발자도 세 마디면 끝납니다. AI한테 파일을 고치라고 시키면, 파일이 순식간에 바뀝니다. 한 번이면 괜찮은데 두세 번 고치다 보면 "처음 버전이 나았다"는 생각이 듭니다. 문제는 그때 이미 처음 버전이 사라져 있다는 겁니다. 광고 자리 (AdSense 승인 후 교체) 왜 저장이 따로 필요한가 일반적인 문서 작업이라면 Ctrl+S 하나로 충분합니다. 하지만 Claude Code와 함께 작업하면 상황이 다릅니다. AI가 한 번에 여러 파일을 동시에 수정합니다 "이것도 고쳐줘"를 3번 반복하면 원본이 어땠는지 기억이 안 납니다 Ctrl+Z는 현재 열려 있는 파일 하나만 되돌립니다 "2시간 전 상태로 통째로 돌아가고 싶다"는 불가능합니다 Git은 이 문제를 해결합니다. 작업 폴더 전체를 특정 시점으로 되돌리는 타임머신입니다. Google Drive vs Git — 뭐가 다른가요 "Google Drive도 버전 기록이 있잖아요?"라고 생각하실 수 있습니다. 맞습니다. 하지만 성격이 다릅니다. 항목 Google Drive Git 저장 방식 자동 저장 (알아서 됨) 직접 저장 (내가 "저장해줘"라고 해야 됨) 저장 단위 ...

클로드 코드 왕초보 가이드 15편 — AI한테 내 캘린더·파일을 연결하는 법 2026

Photo by Michael Pointner on Unsplash 클로드 코드 왕초보 가이드 — 15편 전체 목차 보기 14편 에서 Claude Code에 능력을 추가하는 개념을 배웠습니다. 이번에는 한 걸음 더 들어갑니다. 내 컴퓨터의 파일, 캘린더, 데이터베이스 같은 외부 서비스를 Claude Code에 실제로 연결하는 법입니다. 핵심은 MCP라는 기술이고, 설정 파일 하나만 수정하면 됩니다. 14편 까지 따라오셨다면 Claude Code가 파일을 읽고 수정하는 건 이미 해보셨을 겁니다. 그런데 "내 구글 캘린더 일정을 AI가 확인해주면 좋겠는데", "특정 폴더의 파일만 AI한테 보여주고 싶은데" 같은 생각이 드셨을 수 있습니다. 그 연결 통로가 바로 MCP입니다. 광고 자리 (AdSense 승인 후 교체) MCP가 뭔가요? (30초 복습) MCP는 Model Context Protocol의 약자입니다. 이름이 어려워 보이지만 하는 일은 단순합니다. AI와 외부 서비스 사이의 통역사 역할입니다. 스마트폰 비유로 설명하면 이렇습니다. 스마트폰(Claude Code)이 블루투스 이어폰(외부 서비스)과 대화하려면 블루투스라는 통신 규약이 필요합니다. MCP가 바로 그 블루투스입니다. Claude Code와 외부 서비스가 서로 대화할 수 있게 만들어주는 규약이에요. 스마트폰 세계 Claude Code 세계 블루투스 (통신 규약) MCP (Model Context Protocol) 블루투스 이어폰, 스피커 등 (기기) MCP 서버 (파일 시스템, 캘린더, DB 등) 블루투스 설정 화면에서 기기 페어링 settings.json 파일에서 MC...