Claude Code 커맨드 완전 가이드【2026년 7월판】슬래시 커맨드·CLI 커맨드 목록
요약
2026년 7월 기준 Claude Code v2.1.2xx 버전에 최적화된 슬래시 및 CLI 커맨드 가이드입니다. 세션 관리, 계획 및 리뷰, 자율 실행 기능인 /goal 커맨드 등 핵심 사용법을 상세히 다룹니다.
핵심 포인트
- 세션 관리: /branch, /compact 등을 통한 컨텍스트 제어
- 코드 품질: /plan, /diff, /code-review를 활용한 구현 및 검증
- 자율 실행: /goal 커맨드로 조건 충족 시까지 자율 작업 수행
- 최신 업데이트 반영: 구 버전 커맨드( /fork, /cost)의 변경 사항 안내
머리말
Claude Code는 빈번하게 업데이트되는 도구로, 커맨드 명칭이나 에일리어스(Alias)가 변경될 수 있습니다 (예: /fork
→ /branch
, /cost
→ /usage
).
본 기사는 2026년 7월 시점의 정보 (Claude Code v2.1.2xx 계열, 기본 모델은 Sonnet 5)를 바탕으로 합니다. 최신 정보는 세션 내에서 /help
를 실행하거나 공식 문서를 확인해 주세요.
목차
세션 관리·컨텍스트 (Context)
| 커맨드 | 설명 | 사용 예시 |
|---|---|---|
/clear | 대화 이력을 완전히 리셋 | /clear |
/compact | 대화 이력을 요약 압축 | /compact /compact 에러 핸들링 부분은 남겨줘 |
/context | 현재 컨텍스트 사용 현황을 표시 | /context |
/resume | 과거 세션을 재개 | /resume |
/branch (구 /fork) | 현재 대화를 해당 시점에서 분기·복제 | /branch |
/rewind | 과거 체크포인트로 되돌리기 | /rewind |
/cd | 세션의 작업 디렉토리를 프롬프트 캐시를 깨뜨리지 않고 이동 | /cd ../other-project |
/status | 현재 세션 상태를 표시 | /status |
계획·리뷰
| 커맨드 | 설명 | 사용 예시 |
|---|---|---|
/plan | 구현 전에 플랜을 세우게 함 (Plan Mode) | /plan 인증 버그를 수정해 |
/diff | Claude가 수행한 변경 차분(Difference)을 인터랙티브하게 표시 | /diff |
/code-review | 현재 차분을 버그 검출 중심으로 리뷰 | /code-review /code-review --fix |
/simplify | 리팩터링(Refactoring)·간결화에 특화된 리뷰 | /simplify src/auth/ |
/security-review | 커밋되지 않은 변경 사항의 보안 감사 | /security-review |
/review <PR 번호> | GitHub PR을 리뷰 (gh CLI 연동) | /review 42 |
/pr-comments | 현재 브랜치의 PR 코멘트를 표시 | /pr-comments |
/autofix-pr | PR 자동 수정 기능을 켬 | /autofix-pr |
자율 실행계
Claude Code 중에서도 비교적 최신 기능으로, 여러 턴(Turn)에 걸쳐 자율적으로 작업하게 하는 기능입니다.
| 커맨드 | 설명 | 사용 예시 |
|---|---|---|
/goal <조건> | 완료 조건을 설정하고, 조건을 만족할 때까지 턴을 넘나들며 자율적으로 작업을 지속. 각 턴 종료 후 다른 고속 모델이 조건 충족 여부를 판정 (v2.1.139 이후) | /goal test/auth의 모든 테스트가 pass하고 lint도 클린한 상태 |
/goal (인자 없음) | 현재 goal의 진행 상황 (턴 수·토큰 소비)을 표시 | /goal |
/goal clear | 활성화된 goal을 해제 (stop / off / reset / none / cancel 도 동일) | /goal clear |
보충
- 조건은 최대 4,000자. "
npm test가 exit 0이 된다"와 같이, Claude의 출력으로부터 검증 가능한 형태로 작성해야 합니다 (평가 모델은 스스로 커맨드를 실행하거나 파일을 읽지 않습니다). - "20턴 내에 종료"와 같이, 턴 수나 시간 상한을 조건에 포함해 두면 폭주를 방지할 수 있습니다.
/loop(일정한 간격으로 반복)와는 보완 관계에 있으며,/loop는 시간 간격 기반,/goal은 조건 기반으로 동작합니다.disableAllHooks설정 시나, 신뢰 다이얼로그 미승인 워크스페이스에서는 사용할 수 없습니다.
모델·퍼포먼스 (Performance)
| 커맨드 |
설명 |
사용 예 |
| /model | 사용 모델 전환 |
| /model opus /model sonnet /model haiku |
| /effort | 추론의 깊이 (reasoning effort) 조정 |
| /effort high /effort xhigh |
| /usage (구 /cost) | 토큰 사용량·비용 표시 (무엇이 한도를 압박하고 있는지 확인 가능) |
| /usage |
설정·권한·환경
| 커맨드 |
설명 |
사용 예 |
| /permissions | 도구 실행 허가/거부 규칙 관리 |
| /permissions |
| /config | Claude Code의 각종 설정 변경 (key=value 형식으로 프롬프트에서도 설정 가능) |
| /config |
| /add-dir | 세션에 추가 디렉토리 마운트 |
| /add-dir ../shared-lib |
| /memory | CLAUDE.md 등의 메모리 파일을 직접 편집 |
| /memory |
| /vim | Vim 키 바인딩 (keybindings) 활성화 |
| /vim |
| /doctor | 설치·설정 진단 |
| /doctor |
| /bug | Anthropic에 버그 보고 전송 |
| /bug |
| /export | 대화를 파일로 내보내기 |
| /export |
연동·확장
| 커맨드 |
설명 |
사용 예 |
| /mcp | MCP 서버의 접속 관리·OAuth 인증 |
| /mcp |
| /agents | 서브 에이전트 (Explore/Plan/general-purpose 등) 관리 |
| /agents |
| /install-github-app | GitHub App을 설정하여 PR 워크플로우와 연동 |
| /install-github-app |
| /plugin | 플러그인 마켓플레이스 추가·설치 (zip 아카이브나 URL로부터의 로드도 지원) |
| /plugin install claude-code-essentials |
| /skills | 설치된 Skills 목록·디버깅 |
| /skills |
자동화·백그라운드 작업
| 커맨드 |
설명 |
사용 예 |
| /loop [간격] | 프롬프트를 일정 간격으로 반복 실행. 간격을 생략하면 스스로 판단하여 속도 조절 (self-paced mode) |
| /loop 5m CI 상태 확인 /loop 20m /review-pr 1234 |
| /batch <지시> | 대규모 변경을 태스크 단위로 분해하여, 병렬 백그라운드 에이전트로 실시 |
| /batch 모든 API 엔드포인트에 속도 제한(rate limit) 추가 |
| /debug | 세션의 디버그 로그 활성화·분석 |
| /debug /debug MCP 접속이 실패함 |
| /team-onboarding | 프로젝트의 CLAUDE.md·skills·subagents·hooks로부터 온보딩 자료를 자동 생성 |
| /team-onboarding |
기타
| 커맨드 |
설명 |
사용 예 |
| /help | 사용 가능한 모든 커맨드 표시 |
| /help |
| /init | 프로젝트 초기화·CLAUDE.md 생성 |
| /init |
| /copy [N] | 직전(또는 N번째) 응답을 클립보드에 복사 |
| /copy /copy 2 |
| /btw | 메인 대화를 방해하지 않고 옆길로 질문하기 |
| /btw 이 config 파일 이름이 뭐였지 |
CLI (터미널) 커맨드
| 커맨드 | 설명 | 사용 예시 |
|---|---|---|
claude | 현재 디렉토리에서 대화형 세션 (Interactive Session) 시작 | cd my-project && claude |
claude -p "<prompt>" | 비대화형 (One-shot) 모드. CI/CD용 | claude -p "README를 요약해줘" |
claude -p ... --output-format json | 기계 판독 가능한 JSON 출력 (스크립트 연동용) | claude -p "테스트 실행" --output-format json |
claude --continue / -c | 직전 세션 계속하기 | claude -c |
claude --resume <id> | 세션 ID를 지정하여 재개 | claude --resume abc123 |
claude --model <name> | 실행 시 모델 지정 | claude --model opus |
claude --dangerously-skip-permissions | 모든 작업을 자동 승인 (CI 전용, 대화형 개발 시 비권장) | claude --dangerously-skip-permissions -p "lint 수정" |
claude --safe-mode | 모든 커스터마이징을 무효화하고 실행 (트러블슈팅용) | claude --safe-mode |
claude auth login | 구독/콘솔 인증으로 로그인 | claude auth login |
claude mcp add | MCP 서버를 CLI에서 추가 | claude mcp add github |
claude mcp login / claude mcp logout | 대화형 메뉴를 사용하지 않고 셸에서 MCP 서버 인증/인증 정보 삭제 | claude mcp login github |
claude --version | 설치된 버전 확인 | claude --version |
커스텀 슬래시 커맨드 (Custom Slash Commands)
.claude/commands/*.md (레거시) 또는 .claude/skills/<name>/SKILL.md (권장) 위치에 Markdown 파일을 두면 독자적인 커맨드를 만들 수 있습니다.
---
allowed-tools: Bash, Read, Edit
argument-hint: [test-pattern]
...
→ /test auth와 같이 호출할 수 있습니다.
마치며
Claude Code는 매주 업데이트되며, 커맨드의 추가 및 변경 (/fork → /branch, /cost → /usage 등)이 빈번하게 발생합니다. 이 기사의 내용도 작성 시점(2026년 7월)의 스냅샷입니다. 최신 동작은 반드시 /help나 공식 문서, Weekly What's New를 통해 확인하시기 바랍니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Qiita AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기