클로드 코드 명령어 사용법: /plan, /diff, /rewind로 안전하게 작업하는 팁

TL;DR

클로드 코드를 쓸 때 가장 먼저 익혀야 할 습관은 “바로 수정”이 아니라 “계획 확인, 변경 확인, 필요하면 되돌리기”입니다.

Anthropic 공식 문서 기준으로 Claude Code에는 /plan, /diff, /rewind, /permissions, /context, /compact 같은 세션 제어 명령이 있습니다.

초보자는 이 명령어를 작업 루틴으로 묶어두면 AI 코딩 에이전트를 더 빠르고 안전하게 쓸 수 있습니다.

핵심 3줄 요약

• 핵심 1
  /plan은 수정 전에 작업 계획을 세우게 하고, /diff는 바뀐 파일을 확인하게 해줍니다.
• 핵심 2
  /rewind는 대화와 작업 상태를 이전 체크포인트로 되돌리는 데 쓰는 명령입니다.
• 핵심 3
  /permissions, /status, /context, /compact까지 함께 쓰면 권한, 상태, 맥락 길이를 더 잘 통제할 수 있습니다.

이 글에서 다룰 내용

클로드 코드 명령어를 왜 먼저 익혀야 할까

클로드 코드는 단순히 코드를 물어보는 채팅창이 아니라, 프로젝트 파일을 읽고 수정하고 명령 실행까지 도와주는 코딩 에이전트입니다. 그래서 초보자가 가장 먼저 배워야 할 것은 복잡한 자동화가 아니라 “지금 AI가 무엇을 하려고 하는지 확인하는 방법”입니다.

AI 코딩 에이전트는 편하지만, 한 번에 너무 넓은 범위를 맡기면 수정 파일이 많아지고 검토가 어려워질 수 있습니다. 이때 Claude Code의 세션 명령어가 안전장치 역할을 합니다. /plan으로 먼저 계획을 만들고, /diff로 변경 사항을 확인하고, 이상하면 /rewind로 이전 상태로 돌아가는 식입니다.

한 줄 정리: 클로드 코드 명령어 사용법의 핵심은 AI를 더 세게 쓰는 것이 아니라, AI가 바꾸는 범위와 순서를 사람이 계속 확인하는 것입니다.

누가 쓰면 좋은가

이 루틴은 Claude Code를 막 시작한 초보자에게 특히 좋습니다. “고쳐줘”라고 한 번에 맡기기보다, 계획을 보고 승인한 뒤 작은 단위로 수정하는 습관을 만들 수 있기 때문입니다.

또한 기존 코드베이스를 자주 만지는 기획자, 마케터, 1인 창업자에게도 유용합니다. 개발자가 아니어도 문서, 랜딩페이지, 스크립트, 블로그 자동화 파일을 고칠 일이 많다면 변경 전후 확인이 필요합니다.

다음 상황에 해당하면 이 글의 루틴을 그대로 써볼 만합니다.

• Claude Code가 파일을 여러 개 고칠까 봐 불안한 사람
• 수정 전에 작업 계획을 먼저 보고 싶은 사람
• 바뀐 내용을 파일별로 확인한 뒤 커밋하고 싶은 사람
• 긴 대화가 흐려질 때 맥락을 정리하고 싶은 사람
• 실수했을 때 이전 체크포인트로 돌아가는 방법을 알고 싶은 사람

핵심 인사이트: 초보자에게 가장 좋은 Claude Code 습관은 “작게 맡기고, 자주 확인하고, 되돌릴 수 있게 남겨두기”입니다.

언제 쓰면 좋은가

/plan, /diff, /rewind 루틴은 새 기능 추가보다 기존 파일 수정에서 더 빛납니다. 특히 이미 작동하는 코드나 공개된 페이지를 고칠 때는 계획, 변경 확인, 되돌리기가 중요합니다.

예를 들어 블로그 발행 스크립트의 스타일을 조금 바꾸거나, 랜딩페이지 문구를 교체하거나, 자동화 스크립트의 예외 처리를 추가할 때 이 루틴을 쓰면 좋습니다. 변경 범위가 작더라도 실제 파일이 바뀌는 작업이라면 확인 단계를 생략하지 않는 편이 안전합니다.

반대로 단순 질문, 개념 설명, 코드 예시만 받는 상황에서는 굳이 모든 명령어를 쓸 필요가 없습니다. 파일을 실제로 고치거나 명령을 실행하는 순간부터 이 루틴을 켜면 됩니다.

실전 팁: “설명만 해줘” 단계에서는 자유롭게 묻고, “파일을 고쳐줘” 단계부터 /plan과 /diff를 습관처럼 붙이는 방식이 가장 부담이 적습니다.

따라 하는 순서 1: /status로 현재 세션 상태를 확인한다

작업을 시작하기 전에 먼저 현재 Claude Code 세션이 어떤 상태인지 확인합니다. 공식 명령어 목록에는 /status가 있고, 이 명령은 현재 상태 확인에 쓰입니다.

처음에는 이렇게 말하면 됩니다.

예시 프롬프트:

이번 작업 전에 현재 프로젝트 상태와 Claude Code 세션 상태를 확인해줘. 필요한 경우 /status로 확인한 뒤, 어떤 파일을 읽을지 먼저 말해줘.

이 단계에서 확인할 것은 세 가지입니다.

1. 현재 작업 폴더가 맞는가
2. 어떤 파일을 읽고 판단할 예정인가
3. 바로 수정하지 않고 먼저 계획을 보여줄 것인가

한 줄 정리: 시작 전 상태 확인은 작은 단계처럼 보이지만, 엉뚱한 폴더에서 작업하는 실수를 줄여줍니다.

따라 하는 순서 2: /plan으로 수정 전에 계획을 받는다

파일을 고치기 전에는 /plan을 먼저 사용합니다. 공식 명령어 목록에서 /plan은 계획 모드를 전환하는 명령으로 안내됩니다. 초보자 입장에서는 “수정 전에 생각을 정리해 보여달라”는 장치로 이해하면 쉽습니다.

좋은 요청은 이렇게 씁니다.

예시 프롬프트:

/plan을 사용해서 먼저 수정 계획만 보여줘. 어떤 파일을 읽고, 어떤 파일을 바꿀지, 테스트는 무엇을 실행할지 단계별로 정리해줘. 아직 파일은 수정하지 마.

계획을 볼 때는 다음 항목을 확인합니다.

1. 수정할 파일이 너무 많지 않은가
2. 요구하지 않은 리팩터링이 섞이지 않았는가
3. 테스트나 확인 방법이 포함되어 있는가
4. 되돌리기 어려운 작업이 있는가

핵심 인사이트: /plan은 AI에게 “생각을 멈추지 말라”가 아니라 “실행 전에 사람에게 보이게 하라”는 안전한 작업 계약입니다.

따라 하는 순서 3: 작은 단위로 수정하게 한다

계획이 괜찮으면 바로 전체를 맡기기보다 작은 단위로 진행합니다. Claude Code에게 “1단계만 먼저 수정해줘”라고 요청하면 검토 부담이 줄어듭니다.

예시 프롬프트:

좋아. 계획 중 1단계만 먼저 진행해줘. 완료하면 어떤 파일을 바꿨는지 요약하고, 다음 단계로 넘어가기 전에 멈춰줘.

이 방식은 특히 자동화 스크립트, 워드프레스 발행 도구, 데이터 처리 코드처럼 실수 비용이 있는 작업에서 좋습니다. 한 번에 끝내는 속도보다, 중간 확인 지점을 만드는 것이 더 중요합니다.

실전 팁: 수정 범위가 애매하면 “새 파일 생성 없이 기존 파일 한 개만 수정해줘”처럼 제한을 문장으로 명확히 쓰세요.

따라 하는 순서 4: /diff로 바뀐 내용을 확인한다

수정이 끝난 뒤에는 /diff로 변경 내용을 확인합니다. 공식 명령어 목록에서 /diff는 변경 사항을 보여주는 명령입니다.

초보자는 diff 화면이 어렵게 느껴질 수 있지만, 최소한 다음만 보면 됩니다.

1. 내가 요청한 파일만 바뀌었는가
2. 삭제된 줄이 너무 많지 않은가
3. 새로 추가된 코드가 비밀키나 개인 정보를 출력하지 않는가
4. 문서나 UI 문구가 의도와 맞는가
5. 테스트 명령 또는 확인 결과가 함께 있는가

예시 프롬프트:

/diff로 변경 내용을 보여줘. 그다음 파일별로 왜 바꿨는지, 위험한 변경은 없는지, 내가 직접 확인해야 할 부분을 세 줄로 요약해줘.

한 줄 정리: /diff는 개발자만 보는 화면이 아니라, AI가 실제로 무엇을 바꿨는지 확인하는 영수증입니다.

따라 하는 순서 5: 이상하면 /rewind로 되돌린다

수정 방향이 틀렸거나, 너무 넓게 바뀌었거나, 대화가 엉뚱한 방향으로 흘렀다면 /rewind를 검토합니다. 공식 문서에는 체크포인트와 되돌리기 흐름이 안내되어 있으며, 명령어 목록에도 /rewind가 있습니다.

처음부터 되돌리기를 두려워할 필요는 없습니다. AI 작업에서 되돌리기는 실패가 아니라 정상적인 검토 과정입니다.

예시 프롬프트:

이번 변경은 범위가 너무 넓어. /rewind로 직전 체크포인트로 돌아갈 수 있는지 확인하고, 되돌린 뒤 더 작은 계획을 다시 제안해줘.

다만 되돌리기 전에는 현재 변경 요약을 받아두는 편이 좋습니다. 왜 되돌렸는지 기록해두면 다음 요청을 더 정확히 쓸 수 있습니다.

주의: 되돌리기는 작업 환경과 체크포인트 상태에 따라 기대와 다르게 느껴질 수 있습니다. 중요한 저장소라면 별도 백업, Git 상태 확인, 수동 리뷰를 함께 두세요.

따라 하는 순서 6: /permissions로 실행 권한을 점검한다

Claude Code는 파일 수정이나 명령 실행처럼 실제 행동을 할 수 있는 도구입니다. 그래서 권한 설정을 이해해야 합니다. 공식 명령어 목록에는 /permissions가 있고, 보안 문서는 권한과 안전한 사용 방식을 안내합니다.

처음에는 Claude Code에게 이렇게 요청하세요.

예시 프롬프트:

/permissions로 현재 허용된 작업 범위를 확인해줘. 파일 수정, 명령 실행, 외부 네트워크 접근이 필요한 작업이 있으면 실행 전에 반드시 멈추고 물어봐.

권한 확인이 필요한 대표 상황은 다음과 같습니다.

• 패키지 설치
• 테스트 실행이 아닌 배포 명령
• 파일 삭제나 대량 이동
• 외부 API 호출
• 비밀키, 토큰, 계정 정보가 포함된 파일 접근

핵심 인사이트: 권한 관리는 AI를 믿지 않는 절차가 아니라, AI가 더 정확한 범위 안에서 일하게 만드는 절차입니다.

따라 하는 순서 7: /context와 /compact로 긴 대화를 정리한다

긴 작업을 하다 보면 대화가 길어지고, Claude Code가 무엇을 우선해야 하는지 흐려질 수 있습니다. 공식 명령어 목록에는 /context와 /compact가 있습니다. /context는 현재 컨텍스트 사용량을 확인하는 데, /compact는 대화를 압축하는 데 쓰는 명령으로 이해하면 됩니다.

초보자는 다음 상황에서 이 두 명령을 생각하면 됩니다.

• 같은 세션에서 여러 작업을 이어서 했다
• 처음 요구사항과 현재 요구사항이 달라졌다
• Claude Code가 이전 결정을 자꾸 끌고 온다
• 파일을 많이 읽어서 대화가 무거워졌다

예시 프롬프트:

/context로 현재 맥락 상태를 확인해줘. 이어서 작업하기 전에 /compact가 필요하면, 남겨야 할 결정과 버려도 되는 대화를 구분해서 제안해줘.

실전 팁: 대화를 압축하기 전에는 “최종 목표, 수정 금지 파일, 이미 확인한 테스트, 남은 작업” 네 가지를 요약하게 하세요.

바로 쓰는 5단계 안전 루틴

처음에는 아래 순서만 외우면 됩니다.

1. /status로 현재 세션과 작업 폴더를 확인한다
2. /plan으로 수정 계획을 먼저 받는다
3. 작은 단위로 파일을 수정하게 한다
4. /diff로 변경 내용을 확인한다
5. 필요하면 /rewind로 되돌리고 계획을 줄인다

이 루틴은 빠른 작업에도 쓸 수 있고, 큰 작업의 첫 10분 점검에도 쓸 수 있습니다. 중요한 것은 명령어 자체가 아니라 “실행 전에 계획, 실행 후에 diff, 이상하면 rewind”라는 순서입니다.

예시 프롬프트:

이번 작업은 안전 루틴으로 진행해줘. 먼저 /status로 상태를 확인하고, /plan으로 계획만 보여줘. 내가 승인하면 한 단계만 수정하고, 끝나면 /diff 기준으로 변경 내용을 요약해줘. 범위가 커지면 멈춰줘.

실전 팁: 이 문장을 Claude Code 첫 요청에 붙여두면, 무작정 파일을 고치는 흐름을 줄일 수 있습니다.

실전 팁

첫째, “수정하지 말고 계획만”이라는 문장을 자주 쓰세요. /plan을 쓰더라도 요청 문장에 실행 금지를 함께 적으면 의도가 더 분명해집니다.

둘째, 한 번에 한 목적만 맡기세요. 버그 수정, UI 개선, 리팩터링, 테스트 추가를 한 요청에 섞으면 /diff가 길어지고 검토가 어려워집니다.

셋째, /diff 요약을 한국어로 받으세요. 개발자가 아니어도 “무엇이 바뀌었고 왜 바뀌었는지”를 이해할 수 있어야 합니다.

넷째, /rewind를 너무 늦게 쓰지 마세요. 방향이 틀렸다고 느끼면 작은 시점에서 되돌리는 것이 전체 작업을 살리는 경우가 많습니다.

다섯째, 같은 루틴을 팀 문서나 프로젝트 지침에 넣어두세요. Claude Code를 여러 사람이 쓴다면 명령어보다 운영 규칙이 더 중요합니다.

주의할 점

첫째, /diff를 봤다고 검토가 끝난 것은 아닙니다. 실제 테스트, 화면 확인, 발행 전 검증은 별도로 필요합니다.

둘째, /rewind에만 의존하지 마세요. 중요한 프로젝트에서는 Git 커밋, 브랜치, 백업, 배포 전 확인을 함께 사용해야 합니다.

셋째, 권한을 넓게 열어두고 자동 실행을 맡기지 마세요. 패키지 설치, 파일 삭제, 배포, 외부 API 호출은 사람이 한 번 더 봐야 합니다.

넷째, 긴 대화를 계속 이어가면 이전 요구사항이 섞일 수 있습니다. 작업 단위가 바뀌면 /context와 /compact를 검토하고, 새 목표를 다시 적어주세요.

다섯째, 공식 문서에 없는 명령이나 서드파티 확장 설명은 그대로 믿지 마세요. Claude Code는 빠르게 업데이트되는 도구이므로, 실제 명령어 목록은 공식 문서를 기준으로 확인하는 편이 안전합니다.

자주 묻는 질문

Q1. /plan을 쓰면 Claude Code가 절대 파일을 수정하지 않나요?

/plan은 계획 모드와 관련된 명령이지만, 안전하게 쓰려면 요청 문장에도 “아직 수정하지 말고 계획만 보여줘”라고 함께 적는 것이 좋습니다. 도구의 동작과 사람의 의도를 함께 맞추는 방식입니다.

Q2. /diff는 개발자가 아니어도 봐야 하나요?

네. 모든 줄을 이해하지 못해도 “어떤 파일이 바뀌었는지”, “요청하지 않은 삭제가 있는지”, “비밀 정보가 출력되는지” 정도는 확인해야 합니다. Claude Code에게 diff를 한국어로 요약하게 하면 부담이 줄어듭니다.

Q3. /rewind와 Git 되돌리기는 같은 기능인가요?

같은 것으로 이해하면 위험합니다. /rewind는 Claude Code 세션과 체크포인트 흐름에서 되돌리는 기능이고, Git은 저장소의 버전 관리 도구입니다. 중요한 프로젝트에서는 둘을 함께 쓰는 것이 안전합니다.

Q4. /permissions는 언제 확인해야 하나요?

파일 수정, 명령 실행, 패키지 설치, 외부 연결, 배포처럼 실제 환경에 영향을 줄 수 있는 작업 전에 확인하는 것이 좋습니다. 특히 처음 쓰는 저장소나 업무용 저장소에서는 먼저 권한 범위를 확인하세요.

Q5. 이 루틴은 Claude Code Hooks나 Skills와 어떻게 다른가요?

Hooks는 특정 이벤트 뒤 자동으로 실행되는 규칙에 가깝고, Skills는 반복 지침과 절차를 파일로 묶어두는 방식입니다. 이 글의 /plan, /diff, /rewind 루틴은 그보다 앞단에서, 매 세션마다 사람이 작업을 통제하는 기본 습관에 가깝습니다.

출처

마무리

클로드 코드 명령어 사용법은 고급 개발자만의 기능이 아닙니다. 오히려 초보자일수록 /plan, /diff, /rewind를 먼저 익혀야 합니다. AI가 파일을 고치기 전에 계획을 보고, 고친 뒤에는 변경 내용을 확인하고, 방향이 틀리면 빨리 되돌릴 수 있어야 하기 때문입니다.

감자나라ai님이 Claude Code를 업무 자동화나 블로그 운영, 작은 코드 수정에 활용한다면 처음부터 큰 자동화를 만들기보다 이 루틴을 먼저 고정해보세요. “계획, 변경 확인, 되돌리기”만 습관화해도 AI 코딩 에이전트를 훨씬 덜 불안하게 쓸 수 있습니다.