[Claude Code] 필수 명령어와 Mode 별 주요 특징 정리

클로드 코드(Claude Code)를 직접 사용해보면서 효율적으로 활용하기 위한 필수 명령어와 모드별 주요 특징을 잊지 않기 위해 핵심 위주로 정리해두자!

1. 세션 관리 및 컨텍스트 제어 명령어

컨텍스트와 작업 환경을 관리할 때 자주 쓰이는 필수 명령어들이다.

• /resume: 이전 세션 목록에서 작업 선택해 이어받기 (세션을 닫았다가 다시 시작할 때)
• /compact: 대화 기록을 핵심 위주로 압축 (예: /compact api 변경 사항에 집중해서 정리해줘 처럼 타겟 지정 가능)
• /clear: 대화 기록 전체 초기화 및 새 세션 시작 (대화가 꼬이거나 혼잡해질 때 유용, 단 기존 대화가 날아가므로 필요한 내용은 미리 CLAUDE.md에 정리 필수)
• /rewind: 여러 파일을 수정했는데 방향이 잘못되었을 때 이전으로 되돌리기
• /btw: 히스토리 컨텍스트를 오염시키지 않고 단발성 질문하기 (by the way)

2. 프로젝트 초기화 및 규칙 설정 명령어

프로젝트 설정 파악 및 가이드 라인을 지정할 때 사용한다.

• /init: 새 프로젝트 연동 시 기술 스택, 패키지, 디렉토리 구조 등을 분석해 CLAUDE.md 초안 자동 생성
• /memory: 클로드 코드가 항상 확인해야 하는 설정이나 규칙을 담은 CLAUDE.md 파일을 편집하거나 자동 메모리 기능 ON/OFF

3. 타겟팅 및 터미널 명령어 활용

명확한 경로 지정 방식과 터미널 커맨드 바로 실행 기능이다.

• 경로 지정 (@): 특정 파일이나 폴더를 지정하여 AI의 집중도를 확연히 높일 수 있다.
  • 예: @src/(경로).java 이 파일에서 토큰 검증 로직이 어디있는지 찾아줘.
  • 예: @src/(폴더) 이 폴더에서 무엇무엇 해줘
• Bash 커맨드 즉시 실행 (!): 세션을 나가지 않고 로컬 터미널 명령어를 바로 실행한다.
  • 예: !git status, !gradlew test

4. Shift + Tab 주요 실행 모드 비교

작업 상황과 안전성에 따라 모드를 적절히 전환하며 사용한다. 주로 Auto 모드를 사용할 것 같다.

모드	동작 특징
기본 모드 (Default)	파일 수정 및 명령 실행 전 매번 승인 요청
자동승인 모드 (Auto Accept)	파일 읽기/쓰기 권한 요청을 자동 승인
계획 모드 (Plan Mode)	수정 없이 구조 및 해결 전략 계획만 수립
자동 모드 (Auto Mode) 🌟	목표 기반 CLI 실행, 코드 수정, 에러 대응까지 자율 진행
권한 건너뛰기 (Bypass)	모든 사용자 승인 및 권한 체크 생략

정리

• 새로운 프로젝트는 /init으로 설정하고, 핵심 컨텍스트는 CLAUDE.md와 /memory로 관리한다.
• 작업이 길어지면 /compact나 /clear로 세션을 환기하고, 단순 질문은 /btw를 활용한다.
• 코드 수정과 에러 해결은 자율성이 높은 Auto 모드를 위주로 사용하며, 필요시 타겟 파일(@)을 명확히 지정해 정확도를 높인다.