🎓 유데미 강의 추천
Claude Code 실전 강의 — AI 코딩을 지금 시작하세요
설치부터 자동화·에이전트 활용까지, 실무에서 바로 쓰는 Claude Code 활용법을 단계별로 배울 수 있습니다.
강의 보러가기 →
Claude Code 가이드 #3 — CLI 명령어 총정리
Claude Code의 진짜 힘은 슬래시 명령어에 있습니다. 2026년 3월 기준 20개 이상의 명령어가 제공되며, 작업 계획부터 컨텍스트 압축, 원격 실행, 권한 관리까지 모든 워크플로우를 제어합니다. 🎓 유데미 강의 추천 Claude Code 실전 강의 — AI 코딩을 지금 시작하세요 설치부터 자동화·에이전트 활용까지, 실무에서 바로 쓰는 Claude Code 활용법을 단계별로 배울 수 있습니다.
by Lee
Claude Code의 진짜 힘은 슬래시 명령어에 있습니다. 2026년 3월 기준 20개 이상의 명령어가 제공되며, 작업 계획부터 컨텍스트 압축, 원격 실행, 권한 관리까지 모든 워크플로우를 제어합니다. 이 편에서는 전체 명령어를 기능별로 정리합니다.
강의 보러가기 →
/plan & /init — 작업 설계와 프로젝트 초기화
/plan은 코드를 바로 작성하지 않고 작업 계획을 먼저 세우는 모드입니다. 복잡한 작업일수록 /plan을 먼저 실행하면 결과가 좋습니다.
/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에 통합하는 방법을 알아봅니다.
자주 묻는 질문
/plan과 /tasks의 차이가 무엇인가요?
/plan은 작업 계획을 수립하고 승인을 받는 기능이고, /tasks는 백그라운드에서 실행 중인 작업 목록을 확인하는 기능입니다. 복잡한 작업 전에는 /plan으로 계획을 잡고, 병렬 작업 관리에는 /tasks를 씁니다.
/compact를 자주 실행하면 컨텍스트가 손실되지 않나요?
일부 손실이 있습니다. /compact는 대화 히스토리를 요약으로 압축하므로 세부 정보가 줄어들 수 있습니다. 중요한 작업 상태는 CLAUDE.md에 기록해 두면 compact 후에도 컨텍스트를 유지할 수 있습니다.
/loop는 언제 사용하나요?
주기적인 모니터링이나 반복 실행이 필요할 때 유용합니다. 예를 들어 빌드 상태를 5분마다 확인하거나, 특정 조건이 충족될 때까지 반복 검사하는 작업에 씁니다.
슬래시 명령어 입력 시 "unknown command" 오류가 나옵니다.
Claude Code 버전이 구버전인 경우입니다. npm update -g @anthropic-ai/claude-code로 업데이트하거나, 네이티브 인스톨러를 사용했다면 자동 업데이트 기능을 확인하세요.
키보드 단축키가 작동하지 않습니다.
터미널 에뮬레이터(iTerm2, Windows Terminal 등)가 단축키를 가로채는 경우입니다. 터미널 설정에서 단축키 충돌을 해제하거나, VS Code 내장 터미널을 사용해 보세요.
🎓 관련 강의
Claude Code 완전 정복 — 유데미 강의
이 글에서 다룬 내용을 더 체계적으로 배우고 싶다면 강의를 확인해보세요. 실전 예제 중심으로 구성되어 있습니다.
강의 살펴보기 →
claude-code클로드 코드cli명령어터미널
