Quick Reference
slash command는 프롬프트를 줄이는 별칭이 아니라, 세션의 맥락·지침·권한·연결 상태를 바꾸거나 확인하는 제어 표면입니다. 대화 내용을 버릴지, 요약해 이어갈지, 다른 세션으로 바꿀지부터 고르고, 규칙이나 도구 문제가 의심될 때만 memory·permissions·MCP를 확인합니다.
| 지금 필요한 일 | 명령 | 남는 것과 사라지는 것 |
|---|---|---|
| 새 대화로 전환 | /clear | 기존 대화는 저장되어 재개 가능, 현재 context는 비웁니다. |
| 긴 대화를 요약해 계속 | /compact [지시] | 원문 history 대신 요약이 context에 남습니다. |
| context 사용량 확인 | /context | 내용을 바꾸지 않습니다. |
| 다른 저장 대화로 전환 | /resume | 선택한 session의 대화로 바뀌며 파일 상태는 자동 복원되지 않습니다. |
| 세션 이름 지정 | /rename 이름 | transcript 식별만 바뀝니다. |
| 지침·auto memory 점검 | /memory | 로드된 지침 파일과 memory 폴더를 봅니다. |
| 권한·MCP 점검 | /permissions, /mcp | 규칙 또는 연결 상태를 확인·변경할 수 있습니다. |
대화가 길지만 현재 판단을 이어야 한다 -> /compact
이전 대화와 완전히 다른 문제를 시작한다 -> /clear
같은 저장소의 다른 작업을 이어간다 -> /resume
규칙이나 도구가 예상과 다르게 적용된다 -> /memory, /permissions, /mcp맥락을 바꾸는 명령
/clear는 빈 context에서 새 대화를 시작합니다. 기존 transcript를 지우는 명령은 아니므로, 나중에 /resume이나 CLI claude --resume으로 다시 선택할 수 있습니다. 반대로 /compact는 대화를 요약으로 바꾸고 계속 작업하는 명령입니다. compact 뒤에는 이전 원문의 세부 표현·중간 도구 출력·암묵적 결정을 그대로 인용할 수 없으므로, 유지해야 할 파일·제약·검증 명령을 인수로 명시하는 편이 안전합니다.
/compact 현재 수정 파일, 하지 말아야 할 변경, 남은 테스트만 유지해 줘
/clear
새 작업: 현재 브랜치의 테스트 실패만 조사한다. 파일은 수정하지 않는다./resume은 저장된 대화를 고르는 picker를 열고, /resume 이름은 현재 세션 안에서 이름으로 특정 대화를 찾습니다. session은 파일 시스템의 snapshot이나 Git branch를 되돌리는 장치가 아닙니다. 다시 연 뒤에는 작업 디렉터리, branch, git status, 이전 대화의 전제를 먼저 대조합니다.
규칙과 연결을 점검하는 명령
/memory는 세션에 로드된 CLAUDE.md, CLAUDE.local.md, rules와 auto memory를 확인하고 편집하는 출발점입니다. 지침이 적용되지 않는 문제는 먼저 이 목록과 충돌하는 상위·하위 지침을 봅니다. /permissions는 자동 승인·질문·차단 규칙을, /mcp는 연결된 MCP 서버와 인증·도구 상태를 다룹니다.
| 증상 | 먼저 확인 | 흔한 원인 |
|---|---|---|
| 같은 규칙을 반복해 어김 | /memory | 파일이 로드되지 않았거나 지침이 모호·충돌합니다. |
| 파일·명령 실행에서 멈춤 | /permissions | allow/ask/deny, workspace trust, 보호 경로가 다릅니다. |
| MCP 도구가 보이지 않음 | /mcp | 서버 연결·OAuth·프로젝트 설정이 다릅니다. |
| 시작부터 설정 오류 | /status, /doctor | 설정 파일 문법·설치·환경 문제가 있습니다. |
| context가 빨리 찬다 | /context | 긴 지침·도구·history를 함께 싣고 있습니다. |
자주 틀리는 부분
/compact는 판단을 잇기 위한 요약이지, 원래 대화의 모든 사실과 도구 결과를 보존하는 감사 로그가 아닙니다. 배포·삭제·권한 변경처럼 근거를 다시 확인해야 하는 작업은 compact 뒤에 원본 파일과 Git 상태를 재검증합니다.
피해야 할 흐름
- 긴 대화를 끝내고 싶다는 이유만으로 /clear를 실행한다.
- /resume 뒤 이전 branch와 현재 파일 상태가 같다고 가정한다.
- 지침 문제를 매번 프롬프트로 덮고 /memory의 로드 상태는 보지 않는다.
권장 흐름
1. context를 유지할지 버릴지 먼저 결정한다.
2. 재개한 session에서는 작업 위치와 Git 상태를 확인한다.
3. 규칙·권한·연결 문제는 해당 제어 명령에서 원인을 좁힌다.참고 링크
3 sources