Claude Code를 잘 다루는 사람은 명령어를 많이 외우는 사람이 아닙니다.
프로젝트의 시작부터 검토와 복구까지, 명령어를 하나의 업무 흐름으로 연결해 사용하는 사람입니다.
반복 설명, 복잡해진 대화 맥락, 예상하지 못한 코드 변경을 줄이고 싶다면 다음 10가지 명령어를 단계별로 활용해 보세요.
1단계 — 프로젝트 기준 설정
/init
설명
프로젝트의 기술 스택, 디렉터리 구조, 실행 명령어, 코딩 규칙을 정리합니다.
사용 예시
/init 이 프로젝트의 기술 스택, 디렉터리 구조, 실행·테스트 명령어, 코딩 규칙을 분석해 CLAUDE.md 초안을 작성해줘. 추측한 내용은 별도로 표시해줘.
/memory
설명
여러 작업에서 계속 유지해야 할 원칙과 프로젝트 맥락을 관리합니다.
사용 예시
/memory 앞으로 모든 변경에서 TypeScript strict 모드를 유지하고, 테스트를 먼저 확인하며, 인증 관련 코드는 수정 전에 반드시 영향 범위를 설명해줘.
주의사항
일회성 작업 내용을 모두 저장하지 마세요.
프로젝트 전반에 지속해서 적용할 안정적인 규칙만 남기는 것이 좋습니다.
2단계 — 구현 전 계획 수립
/plan
설명
여러 파일을 수정하거나 보안, 데이터베이스, 배포에 영향을 주는 작업을 구현하기 전에 변경 범위와 순서를 설계합니다.
사용 예시
/plan 로그인 실패 횟수 제한 기능을 추가해줘. 수정 예상 파일, 데이터베이스 변경, 보안 영향, 테스트 계획, 롤백 방법을 먼저 제시하고 승인 전에는 코드를 수정하지 마.
/agents
설명
조사, 개발, 테스트, 보안 검토처럼 서로 다른 역할을 전문 Agent로 분리합니다.
사용 예시
/agents 다음 작업을 조사·구현·테스트·보안 검토 Agent로 나눠줘. 각 Agent의 역할, 입력 자료, 사용할 도구, 출력 형식, 검증 기준, 완료 조건을 명시해줘.
Agent별 필수 항목
* 담당 역할
* 사용할 도구
* 입력 자료
* 출력 형식
* 검증 기준
* 완료 조건
3단계 — 작업 실행과 맥락 관리
/batch
설명
규모가 큰 작업을 독립 작업과 선후행 작업으로 나누고, 완료 기준에 따라 조정합니다.
사용 예시
/batch 결제 모듈 리팩터링을 조사, 인터페이스 설계, 구현, 테스트, 문서화 작업으로 나눠줘. 서로 독립적인 작업은 병렬화하고, 의존 관계와 각 작업의 완료 조건을 표시해줘.
/compact
설명
대화가 길어졌을 때 핵심 결정, 수정 파일, 미해결 문제, 다음 작업을 중심으로 맥락을 정리합니다.
사용 예시
/compact 지금까지의 요구사항, 확정된 결정, 수정한 파일, 테스트 결과, 미해결 문제, 다음 작업을 10줄 이내로 요약해줘. 추측은 제외해줘.
주의사항
단순히 대화 내용을 줄이는 것이 목적은 아닙니다.
다음 작업에 꼭 필요한 정보가 남도록 압축해야 합니다.
4단계 — 변경 결과 검토
/diff
설명
Claude Code가 어떤 파일을 어떻게 변경했는지 확인합니다.
사용 예시
/diff 현재 변경사항을 파일별로 요약하고, 요구사항과 무관한 변경, 잠재적 버그, 보안 위험, 테스트 누락을 찾아줘. 승인하지 않은 변경은 별도로 표시해줘.
검토 항목
* 요구사항이 정확히 반영되었는가?
* 기존 기능에 영향을 주지 않는가?
* 테스트가 충분한가?
* 보안 취약점이 추가되지 않았는가?
* 요청하지 않은 파일까지 수정하지 않았는가?
/cost
설명
사용한 토큰과 비용을 확인하고, 많은 자원을 사용하면서도 작업이 진전되지 않는 구간을 찾습니다.
사용 예시
/cost 이번 작업의 토큰 사용량과 비용을 확인하고, 반복 설명이나 불필요한 탐색으로 비용이 증가한 구간과 개선 방법을 알려줘.
주의사항
비용 확인은 단순한 절약만을 위한 작업이 아닙니다.
반복 설명, 불필요한 탐색, 잘못된 작업 분할처럼 비효율적인 작업 방식을 발견하는 과정이기도 합니다.
5단계 — 복구와 최적화
/rewind
설명
작업 방향이나 코드 변경이 잘못되었을 때 이전의 안전한 지점으로 돌아갑니다.
사용 예시
/rewind 현재 변경사항을 되돌리기 전에 복구 대상 파일과 손실될 수 있는 변경을 먼저 보여줘. 확인되지 않은 파일은 자동으로 되돌리지 마.
주의사항
잘못된 결과 위에 계속 수정 사항을 덧붙이기보다, 검증된 지점에서 다시 시작하는 편이 안전할 수 있습니다.
/model
설명
작업의 난이도와 위험도에 맞게 모델을 선택합니다.
사용 예시
/model 현재 작업의 복잡도, 보안 위험, 필요한 추론 수준을 평가해 적합한 모델을 추천해줘. 모델을 변경하기 전에 예상 비용과 품질 차이도 설명해줘.
선택 기준
* 단순 정리·형식 변경 → 빠르고 경제적인 모델
* 복잡한 설계·리팩터링 → 추론 능력이 높은 모델
* 보안·권한·데이터 변경 → 충분한 검토 능력을 갖춘 모델
추천 운영 흐름
/init → /memory → /plan → /agents·/batch → /compact → /diff → /rewind → /cost → /model
모든 프로젝트에서 10개 명령어를 전부 사용할 필요는 없습니다.
가장 중요한 것은 프로젝트에 맞는 승인된 명령어 흐름을 정하고, 작은 작업부터 시험해 보는 것입니다.
시작 방법
1. 수정 범위를 한 가지 기능으로 제한합니다.
2. 구현 전에 완료 조건을 작성합니다.
3. /plan으로 변경 순서를 검토합니다.
4. 작업 후 /diff로 모든 변경을 확인합니다.
5. 테스트를 통과한 결과만 승인합니다.
반드시 기억해야 할 원칙
Claude Code의 명령어는 사람의 검토를 대신하지 않습니다.
특히 다음 작업은 실행 전에 반드시 확인해야 합니다.
* 파일 삭제
* 권한 변경
* 데이터베이스 마이그레이션
* 배포
* 외부 시스템으로의 데이터 전송
* 결제 관련 작업
실행 전 확인 항목
* 실행할 명령어
* 대상 파일과 경로
* 예상되는 영향 범위
* 백업 또는 복구 방법
* 테스트 및 검증 방법
* 승인되지 않은 변경 여부
Claude Code의 핵심 가치
Claude Code의 진정한 가치는 더 많은 명령어를 사용하는 데 있지 않습니다.
다음과 같은 신뢰할 수 있는 운영 체계를 만드는 데 있습니다.
명확한 의도
→ 구조화된 계획
→ 통제된 실행
→ 변경사항 검토
→ 테스트와 승인
→ 안전한 복구
여러분의 개발팀에서 반복 작업과 재작업을 가장 많이 줄여준 Claude Code 명령어는 무엇인가요?
※ 명령어의 제공 여부와 동작 방식은 Claude Code 버전 및 실행 환경에 따라 달라질 수 있습니다. 현재 설치된 버전에서 지원 여부와 사용법을 확인한 뒤 적용하세요.
ISCCERT.ORG
ISC.studio
— 이춘곤(Mark) · ISC.studio · ISC출판 도서 안내
이 글은 저자의 Facebook에 처음 게시한 글입니다. Facebook 원문 보기
💬 댓글 (0)