Claude Code 자주 쓰는 명령어 총정리

Claude Code를 쓰다 보면 생각보다 많은 명령어를 만나게 됩니다. 하지만 처음부터 전부 외울 필요는 없습니다. 실제 작업에서 자주 쓰는 명령어는 어느 정도 정해져 있고, 몇 가지만 알아도 작업 흐름이 훨씬 안정적입니다.

특히 작업이 꼬였을 때 대화를 초기화하거나, 길어진 대화를 정리하거나, 이전 작업으로 되돌리고, 변경된 코드를 확인하고, 실제 결과물을 검증하는 명령어는 거의 매일 쓰게 됩니다. Claude Code 입력창 맨 앞에 /를 입력하면 현재 사용할 수 있는 명령어 목록을 직접 확인할 수 있습니다.

먼저 이것만 기억하세요

1. /clear — 완전히 다른 작업으로 넘어갈 때

/clear는 현재 대화 컨텍스트를 비우고 새로운 대화를 시작할 때 사용합니다. 지금까지 홈페이지 메인 디자인, 모바일 반응형, 애니메이션 수정을 하고 있었는데 갑자기 관리자 게시판 기능을 새로 개발해야 한다면 기존 대화 내용 대부분은 필요하지 않습니다.

중요한 점은 /clear를 입력해도 지금까지 만든 코드나 프로젝트 파일이 삭제되는 것은 아니라는 것입니다. Claude가 현재 들고 있던 대화 컨텍스트만 비워집니다. 작업 파일은 그대로 남습니다.

“작업 주제가 완전히 바뀌면 /clear로 컨텍스트를 비우는 편이 좋습니다.”

2. /compact — 같은 작업을 계속해야 하는데 대화가 길어졌을 때

/compact는 지금까지의 대화를 전부 없애는 것이 아니라 중요한 내용을 요약해서 컨텍스트를 줄여줍니다. 그래서 /clear와 목적이 다릅니다. /clear는 다른 작업을 시작할 때, /compact는 같은 작업을 계속 이어갈 때 사용합니다.

예를 들어 예약 시스템을 개발하면서 DB 설계, 예약 폼, 관리자 화면까지 이어지다 보면 대화가 길어집니다. 이때는 작업 자체가 바뀐 것이 아니므로 /compact가 적합합니다. 필요하면 '예약 DB 구조와 남은 오류를 중심으로 정리해줘'처럼 요약 기준을 직접 줄 수도 있습니다.

3. /context — Claude가 왜 답답해졌는지 확인할 때

/context는 현재 Claude의 컨텍스트가 어디에 얼마나 사용되고 있는지 확인할 때 씁니다. Claude Code의 컨텍스트에는 단순 채팅뿐 아니라 읽은 파일, 명령어 실행 결과, CLAUDE.md, 메모리, Skill, 시스템 지침 등이 함께 들어갑니다.

• Claude가 앞에서 말한 내용을 자꾸 놓칠 때
• 갑자기 이상한 방향으로 작업할 때
• 한 세션을 너무 오래 사용했을 때
• /compact를 해야 할지 고민될 때

4. /plan — 바로 코딩하지 말고 계획부터 만들 때

/plan은 Claude Code를 Plan Mode로 전환합니다. 큰 기능을 만들거나 여러 파일을 수정해야 할 때 바로 코딩시키기 전에 사용하면 좋습니다. 로그인, 예약, 결제, 관리자 페이지, 데이터베이스 구조 변경처럼 영향 범위가 큰 작업일수록 유용합니다.

1. 1./plan으로 구현 계획을 먼저 확인합니다.
2. 2.잘못된 방향이나 빠진 조건을 수정합니다.
3. 3.계획이 맞으면 그때 코딩을 시작합니다.

5. Esc — Claude가 이상한 방향으로 갈 때 즉시 멈추기

Claude가 작업 중인데 엉뚱한 파일을 수정하거나 필요 없는 작업을 계속하고 있다면 끝날 때까지 기다릴 필요가 없습니다. Esc를 누르면 현재 응답이나 작업을 중단할 수 있습니다. 지금까지 진행된 내용은 유지하면서 현재 동작만 멈춥니다.

6. Esc + Esc 또는 /rewind — 이전 시점으로 되돌아가기

입력창이 비어 있을 때 Esc를 두 번 누르거나 /rewind를 입력하면 Rewind 메뉴가 열립니다. Claude Code는 작업 과정 중 체크포인트를 만들기 때문에 특정 시점으로 되돌아갈 수 있습니다.

Claude가 잘못된 방법을 시도한 뒤 '아니야, 다른 방식으로 다시 해줘'라고 계속 수정하면 실패했던 내용도 컨텍스트에 남습니다. 아예 실패 전 시점으로 되돌린 뒤 다시 시도하면 더 깨끗하게 진행할 수 있습니다.

7. /diff — 실제로 무엇을 바꿨는지 확인할 때

/diff는 현재 프로젝트에서 변경된 코드를 확인할 때 사용합니다. Claude에게 모바일 메뉴만 수정해달라고 했더라도 정말 그 파일만 수정했는지 확인하는 습관이 필요합니다.

• 수정된 파일
• 추가된 코드
• 삭제된 코드
• 각 작업 턴별 변경 내용

8. /review — Claude가 만든 코드를 다시 검토시키기

/review는 현재 변경된 코드를 다시 검토합니다. 코드의 정확성 문제, 누락된 예외 처리, 정리할 부분을 찾는 데 좋습니다. 구현 후 /diff로 변경 범위를 보고, /review로 문제를 찾은 뒤 수정하는 흐름을 추천합니다.

9. /verify — 테스트 통과가 아니라 실제 동작 확인

/verify는 프로젝트를 실행하고 결과를 관찰하는 방식으로 변경 사항을 검증할 때 사용합니다. 빌드가 성공해도 버튼 클릭, 화면 이동, 폼 제출, 모바일 화면이 실제로 정상 동작한다고 보장할 수는 없습니다.

• 버튼 클릭
• 페이지 이동
• 폼 작동
• 모바일 화면
• 실제 UI 동작

10. /resume — 이전 작업 다시 불러오기

/resume은 이전 세션 목록을 열거나 특정 세션을 다시 불러올 때 사용합니다. 작업 이름을 붙여두면 나중에 찾기 훨씬 쉽습니다. 예를 들어 /rename 예약시스템, /rename 모바일리뉴얼처럼 현재 작업에 이름을 달아두는 방식입니다.

11. /model, /usage, /memory, /permissions, /doctor

12. /init — 새 프로젝트에서 Claude Code를 처음 쓸 때

/init은 현재 프로젝트를 분석해서 기본 CLAUDE.md 파일을 만드는 데 사용합니다. CLAUDE.md는 이 프로젝트에서 Claude가 계속 기억해야 할 작업 규칙을 적어두는 파일입니다.

• Next.js 사용
• TypeScript 사용
• 모바일 우선
• 기존 디자인 시스템 유지
• 기존 API 구조 변경 금지

13. /btw, /copy, /tasks

/btw는 본 작업과 관계없는 질문을 잠깐 물어볼 때 유용합니다. 질문과 답변이 메인 대화 기록에 추가되지 않아 컨텍스트를 덜 어지럽힙니다. /copy는 최근 Claude 답변이나 코드 블록을 클립보드에 복사할 때, /tasks는 현재 세션에서 돌아가는 백그라운드 작업과 Subagent 작업을 확인할 때 씁니다.

명령어가 아니지만 꼭 알아둘 단축키

추천 사용 흐름

정말 7개만 외운다면

• /plan
• /clear
• /compact
• /context
• /rewind
• /diff
• /resume

이 7개에 익숙해진 뒤 /review, /verify, /memory, /doctor, /usage, /btw를 하나씩 추가하면 됩니다. Claude Code를 잘 쓰는 핵심은 명령어를 많이 아는 것이 아니라, 현재 작업의 컨텍스트를 깨끗하게 유지하고, 큰 작업은 계획부터 시작하고, 결과물을 반드시 확인하는 것입니다.

“작업 시작은 /plan, 작업이 길어지면 /compact, 다른 작업은 /clear, 잘못된 방향은 Esc 또는 /rewind, 완료 후에는 /diff → /review → /verify.”