Overview

명령어 표처럼 찾고, 실전 루틴처럼 읽는 구조

Claude Code 공식 문서는 built-in commands와 bundled skills를 한 명령 체계로 설명합니다. 이 페이지는 “지금 뭘 쳐야 하는지”, “어디서 확장하는지”, “언제 백그라운드로 넘기는지”를 먼저 보여줍니다.

30+ 핵심 명령 맥락 4 작업 카테고리 공식 문서 바로가기

최근 확인한 핵심

먼저 기억하면 좋은 변화와 포인트

Commands

공식 기준은 이제 commands 중심입니다

공식 Commands 문서는 /clear, /compact 같은 built-in commands와 /run, /verify, /simplify 같은 bundled skills를 한 표에서 설명합니다.

Run / Verify

실행 중인 앱을 직접 검증하는 스킬이 생겼습니다

/run, /verify, /run-skill-generator는 테스트만 돌리는 대신 앱을 띄우고 관찰하는 흐름을 표준화합니다.

Skills

커스텀 커맨드는 skills 흐름으로 보는 게 맞습니다

.claude/commands/deploy.md도 계속 동작하지만, 새로 만들 때는 .claude/skills/deploy/SKILL.md 구조가 더 확장성이 좋습니다.

Background

병렬 작업은 agents, tasks, background, batch로 나뉩니다

/agents는 agent manager, /tasks는 백그라운드 작업 목록, /background는 현재 세션 분리, /batch는 대규모 변경 분해에 가깝습니다.

MCP / Hooks

외부 도구와 정책 자동화는 분리해서 관리합니다

MCP 서버 프롬프트는 /mcp__server__prompt 형식으로 실행되고, hooks는 세션·턴·도구 호출 이벤트에서 자동 실행됩니다.

Command Reference

명령어 검색

명령어, 목적, 키워드를 입력하거나 카테고리 버튼을 누르면 바로 좁혀집니다.

/clear세션

대화를 비우고 새 흐름으로 시작

이전 대화는 /resume에서 다시 찾을 수 있고, 같은 프로젝트 안에서 새 맥락으로 시작할 때 씁니다.

/compact [instructions]세션

긴 대화를 요약해 컨텍스트 확보

계속 이어가야 하지만 맥락이 너무 길어진 경우 사용합니다. 선택 지시문으로 요약 초점을 줄 수 있습니다.

/context세션

컨텍스트 창이 어디에 쓰이는지 확인

대화가 길어질 때 어떤 정보가 컨텍스트를 차지하는지 확인하고, /compact를 쓸 시점을 판단합니다.

/btw / /side세션

메인 흐름을 더럽히지 않는 짧은 곁가지 질문

현재 작업 히스토리에 크게 남길 필요 없는 확인이나 보조 질문을 분리해서 처리할 때 씁니다.

/resume [session]세션

이전 세션을 다시 이어가기

세션 ID나 이름을 지정하거나 피커에서 골라 끊긴 작업으로 돌아갑니다. 별칭은 /continue입니다.

/rewind세션

대화나 변경을 이전 지점으로 되돌림

체크포인트 기반으로 이전 상태를 복구해야 할 때 씁니다. 별칭으로 /checkpoint, /undo가 있습니다.

/usage세션

사용량, 비용, 플랜 한도 확인

/cost, /stats는 사용량 화면으로 이어지는 별칭입니다.

/config설정

Claude Code 설정 화면 열기

테마, 모델, 출력 스타일 등 인터랙티브 설정을 바꿀 때 시작점으로 쓰입니다.

/effort설정

현재 작업의 사고 강도 조정

모델이 지원하는 범위 안에서 reasoning effort를 낮추거나 높여 속도와 깊이의 균형을 맞춥니다.

/model [model]설정

현재 세션 모델 변경

모델 선택 피커를 열거나 모델 이름을 지정합니다. 지원 모델에서는 effort 조정도 함께 다룹니다.

/permissions설정

도구 권한 규칙 관리

읽기, 쓰기, Bash, MCP 도구의 allow, ask, deny 규칙을 관리합니다. 별칭은 /allowed-tools입니다.

/doctor설정

설치와 설정 상태 진단

Claude Code 환경이 이상할 때 먼저 돌려볼 건강검진 명령입니다.

/init / /memory설정

프로젝트 기억 파일 만들고 관리

/initCLAUDE.md 초안을 만들고, /memory는 메모리 파일과 자동 메모리를 관리합니다.

/review [PR]워크플로

현재 세션에서 PR이나 변경 리뷰

로컬 컨텍스트를 기준으로 코드 리뷰 관점의 피드백을 받을 때 씁니다.

/code-review / /ultrareview워크플로

더 깊은 PR 리뷰 흐름

공식 문서는 깊은 cloud 기반 리뷰의 선호 호출을 /code-review ultra로 안내하고, /ultrareview는 별칭으로 남겨둡니다.

/security-review워크플로

보안 관점의 변경 검토

현재 브랜치의 pending 변경에서 주입, 인증, 데이터 노출 같은 위험을 찾습니다.

/simplify워크플로

최근 변경을 단순화하고 품질 점검

최근 파일을 검토해 불필요한 복잡도, 품질 문제, 효율성 개선 지점을 정리하는 bundled skill입니다.

/diff워크플로

현재 변경과 턴별 diff 확인

전체 git diff와 Claude 턴별 변경을 훑으며 작업 흐름을 점검합니다.

/run / /verify워크플로

앱을 실행하고 실제 동작으로 검증

/run은 앱을 띄워 변경을 확인하고, /verify는 빌드·실행·관찰을 통해 코드 변경이 의도대로 동작하는지 확인합니다.

/run-skill-generator워크플로

프로젝트별 실행 레시피를 스킬로 저장

표준 실행만으로 부족한 프로젝트에서 설치, 환경변수, 실행 절차를 기록해 /run/verify가 다시 발견하지 않게 합니다.

/loop [interval] [prompt]워크플로

프롬프트 반복 실행

배포 완료 대기, 주기적 상태 확인처럼 같은 확인을 반복해야 할 때 유용합니다. 별칭은 /proactive입니다.

/schedule / /routines워크플로

Anthropic 관리형 클라우드에서 루틴 실행

정기적으로 실행할 설명을 주면 Claude가 대화형으로 루틴을 만들거나 수정하고 실행 흐름을 잡습니다.

/agents / /tasks / /background워크플로

병렬 에이전트와 백그라운드 작업 관리

agent view로 병렬 세션을 관리하고, tasks에서 실행 중인 작업을 보며, 현재 세션은 background로 떼어 둘 수 있습니다.

/batch <instruction>워크플로

대규모 변경을 병렬 작업으로 분해

코드베이스를 분석하고 독립 작업 단위로 나눈 뒤, 승인 후 여러 worktree 에이전트로 진행하는 번들 스킬입니다.

/skills / /skill-name확장

반복 절차를 스킬로 만들기

개인 스킬은 ~/.claude/skills/, 프로젝트 스킬은 .claude/skills/에 둡니다. 기존 .claude/commands/도 계속 동작하지만 새 workflow는 스킬이 더 확장성 좋습니다.

/plugin / /reload-plugins확장

플러그인 설치와 재로딩

플러그인은 skills, hooks, MCP 서버 등을 묶는 배포 단위입니다. 변경 후에는 /reload-plugins로 세션에 다시 반영합니다.

/reload-skills확장

스킬 목록 강제 새로고침

새 스킬이 감지되지 않거나 설명을 바꾼 직후 명령 목록을 갱신해야 할 때 사용합니다.

/mcp / /mcp__server__prompt확장

MCP 서버 관리와 프롬프트 실행

/mcp는 연결 상태와 OAuth를 관리하고, 서버 프롬프트는 /mcp__github__pr_review 456처럼 실행합니다.

/hooks확장

라이프사이클 훅 확인

PreToolUse, UserPromptSubmit, SessionStart 같은 이벤트에서 실행되는 훅 설정을 확인합니다.

Practical Routines

상황별로 이렇게 쓰면 빠릅니다

01

새 저장소를 Claude Code에 태울 때

/init으로 CLAUDE.md를 만들고, /permissions로 도구 권한을 확인한 뒤, 앱 실행 절차는 /run-skill-generator로 스킬화하세요.

02

긴 작업이 엉키기 시작할 때

/context/diff로 현재 상태를 확인하고, 계속 갈 작업이면 /compact, 방향이 틀렸으면 /rewind를 먼저 고려하세요.

03

PR 전에 한 번 더 보고 싶을 때

/code-review로 깊은 리뷰를 받고, 인증/권한/입력 처리 쪽 변경이면 /security-review, 품질 정리는 /simplify를 추가하세요.

04

병렬 작업과 반복 점검이 필요할 때

큰 작업은 /batch/agents로 나누고, 주기 점검은 /schedule, 외부 도구는 MCP, 강제 정책은 hooks로 분리하세요.

Official Sources

공식 문서로 바로 확인

Claude Code Skills

스킬 위치, SKILL.md 구조, 기존 .claude/commands/와의 관계를 확인합니다.

Claude Code MCP

MCP 서버 연결, 프롬프트 명령 실행, 관리형 MCP 구성을 확인합니다.

Claude Code Hooks

훅 이벤트, 설정 스키마, 입력/출력, 차단 동작을 확인합니다.