/plan은 코드를 바로 작성하지 않고 작업 계획을 먼저 세우는 모드입니다. 복잡한 작업일수록 /plan을 먼저 실행하면 결과가 좋습니다.
Claude Code 가이드 #3 — CLI 명령어 총정리
/plan, /copy, /loop, /context 등 주요 슬래시 명령어와 활용법을 정리한다. 각 명령어의 용도, 인자, 조합 패턴과 자주 쓰는 단축키까지 실전 위주로 설명한다.
Claude Code의 진짜 힘은 슬래시 명령어에 있습니다. 2026년 3월 기준 20개 이상의 명령어가 제공되며, 작업 계획부터 컨텍스트 압축, 원격 실행, 권한 관리까지 모든 워크플로우를 제어합니다. 이 편에서는 전체 명령어를 기능별로 정리합니다.
/plan & /init — 작업 설계와 프로젝트 초기화
/plan 사용법/plan fix the auth bug /plan 데이터베이스 스키마를 리팩토링하는 계획을 세워줘
/init은 현재 프로젝트의 구조를 분석하여 CLAUDE.md 파일을 자동 생성합니다. 새 프로젝트에서 가장 먼저 실행할 명령어입니다.
/init 사용법/init
💡 팁: /init이 생성한 CLAUDE.md는 시작점입니다. 프로젝트 고유 규칙, 코딩 컨벤션, 테스트 명령어 등을 직접 추가하세요. 자동 생성 내용만으로는 부족합니다.
/compact & /context — 컨텍스트 관리
/compact는 대화 히스토리를 요약하여 컨텍스트 윈도우를 확보합니다. 장시간 세션에서 "컨텍스트 초과" 경고가 나타나기 전에 실행하세요.
/compact 사용법/compact /compact 인증 관련 변경사항만 유지해줘
/context는 현재 세션의 토큰 사용량을 확인하고 최적화 제안을 받습니다. status line에서도 실시간으로 토큰 사용량을 모니터링할 수 있습니다.
⚠️ 막히는 케이스: /compact 후 이전 대화 내용을 참조하면 정보가 누락될 수 있습니다. 중요한 결정사항은 CLAUDE.md나 코드 주석에 미리 기록해두세요.
/loop & /tasks — 반복 실행과 태스크 관리
/loop은 프롬프트나 슬래시 명령을 주기적으로 반복 실행합니다. 배포 모니터링, 테스트 반복, 상태 체크에 유용합니다.
/loop 사용법/loop 5m check the deploy status /loop 10m run tests and report failures
/tasks는 백그라운드에서 실행 중인 태스크 목록을 관리합니다. 웹 환경(claude.ai/code)에서 특히 유용하며, 여러 작업을 동시에 추적할 수 있습니다.
⚠️ 막히는 케이스: /loop이 DST(서머타임) 전환 시점에 무한 루프에 빠질 수 있습니다. 최신 버전으로 업데이트하거나, DST가 없는 UTC 시간대를 사용하세요.
/resume & /teleport — 세션 복원과 이동
/resume는 이전 세션을 이어서 작업합니다. 세션 ID를 지정하거나, 최근 세션 목록에서 선택할 수 있습니다.
/resume 사용법claude --resume claude --resume session_abc123
/teleport는 터미널 세션을 다른 환경(웹, 데스크톱 앱)으로 전송합니다. 터미널에서 작업하다가 데스크톱 앱의 diff view로 전환할 때 유용합니다.
/teleport 사용법/teleport
💡 팁: /resume은 세션의 전체 컨텍스트를 복원합니다. 오래된 세션은 컨텍스트가 클 수 있으므로, 필요시 /resume 후 /compact를 실행하세요.
/mcp & /permissions — 도구 연결과 권한 관리
/mcp는 MCP(Model Context Protocol) 서버를 관리합니다. 연결된 서버 목록 확인, 새 서버 추가, 기존 서버 재인증이 가능합니다.
/mcp 사용법/mcp /mcp add my-server
/permissions는 파일 수정, 명령어 실행 등의 권한 모드를 설정합니다. Auto accept, Ask every time, Deny 중 선택할 수 있습니다.
⚠️ 막히는 케이스: "파일 수정이 안 됩니다" — /permissions에서 권한 모드를 확인하세요. Ask every time 모드에서 실수로 Deny를 누르면 해당 세션에서 계속 차단됩니다. /permissions로 재설정하세요.
/agents, /copy 및 기타 명령어
- /agents — 사용 가능한 에이전트 목록을 표시합니다.
.claude/agents/디렉토리의 에이전트 파일을 스캔합니다. - /copy — 마지막 응답 또는 선택한 내용을 클립보드에 복사합니다.
- /help — 전체 명령어 도움말을 표시합니다.
- /clear — 현재 대화를 초기화합니다.
- /remote-control — 원격 세션 제어.
--name으로 세션 이름을 설정합니다.
키보드 단축키
- Ctrl+C — 현재 실행 중단
- Ctrl+U — 빈 프롬프트에서 bash 모드 탈출
- Esc — 현재 입력 취소 또는 도구 실행 중단
- Tab — 파일명/경로 자동완성
- 숫자키 — 선택 옵션 빠른 입력
명령어 치트시트
| 명령어 | 기능 | 핵심 사용 시점 |
|---|---|---|
/plan | 작업 계획 수립 | 복잡한 작업 시작 전 |
/init | CLAUDE.md 자동 생성 | 새 프로젝트 시작 |
/compact | 컨텍스트 압축 | 토큰 부족 시 |
/context | 토큰 사용량 확인 | 성능 저하 느낄 때 |
/loop | 반복 실행 | 모니터링, 주기적 체크 |
/tasks | 태스크 관리 | 백그라운드 작업 추적 |
/resume | 세션 복원 | 이전 작업 이어하기 |
/teleport | 환경 전송 | 터미널 → 데스크톱 전환 |
/mcp | MCP 서버 관리 | 외부 도구 연결 |
/permissions | 권한 설정 | 도구 실행 권한 변경 |
/agents | 에이전트 목록 | 사용 가능 에이전트 확인 |
/copy | 클립보드 복사 | 결과 추출 |
⚠️ 막히는 케이스: 명령어를 입력했는데 "unknown command"가 나온다면, Claude Code 버전이 오래된 것입니다. npm update -g @anthropic-ai/claude-code 또는 native installer의 자동 업데이트를 확인하세요.
다음 편에서는 MCP 서버 연결을 다룹니다. Google Drive, Jira, Slack 등 외부 도구를 Claude Code에 통합하는 방법을 알아봅니다.
claude-code클로드 코드cli명령어터미널