명령어 시스템

Claude Code의 명령어 시스템은 두 계층으로 구성됩니다. 세션 시작 전 에 동작을 구성하는 CLI 플래그 와, 세션 실행 중 에 사용하는 슬래시 명령어 입니다.

슬래시 명령어

대화형 REPL 세션에서 /로 시작하는 명령어입니다. 입력창에서 직접 타이핑합니다.

/help

/help

사용 가능한 모든 명령어 목록과 기본 사용법을 표시합니다. 처음 사용하거나 명령어가 기억나지 않을 때 첫 번째 참고점입니다.

/clear

/clear

현재 대화 컨텍스트를 초기화합니다. 이전 대화 내용과 도구 실행 결과가 모두 제거됩니다. 새로운 작업을 시작하거나 컨텍스트가 오염되었을 때 사용합니다.

/compact

/compact

현재 대화를 수동으로 컴팩션합니다. 긴 세션에서 오래된 메시지를 요약하여 컨텍스트 윈도우 공간을 확보합니다.

/memory

/memory

메모리 에디터를 엽니다. 현재 로드된 CLAUDE.md 파일 목록을 확인하고 직접 편집할 수 있습니다. 수정 후 컨텍스트가 즉시 다시 로드됩니다.

/permissions

/permissions

현재 권한 모드와 활성 규칙을 표시합니다. 세션 중에 권한 모드를 변경하거나 특정 도구에 대한 규칙을 추가/제거할 수 있습니다.

/tools

/tools

현재 세션에서 사용 가능한 도구 목록을 표시합니다. 각 도구의 이름, 설명, 현재 권한 상태를 확인할 수 있습니다.

/mcp

/mcp

연결된 MCP 서버 목록과 상태를 표시합니다. 서버별 연결 상태, 사용 가능한 도구, 오류 정보를 확인합니다.

/hooks

/hooks

설정된 훅 목록과 실행 상태를 표시합니다. 어떤 훅이 어떤 이벤트에 연결되어 있는지 확인합니다.

/skills (확장)

/skills
/skillname

설치된 스킬 목록을 보거나 특정 스킬을 실행합니다. oh-my-claudecode 같은 확장 시스템에서 추가되는 명령어입니다.

CLI 플래그

claude 명령어를 실행할 때 지정하는 옵션입니다. 세션 전체의 동작 방식을 구성합니다.

—print / -p

claude --print "질문"
claude -p "질문"

비대화형 모드로 실행합니다. UI 없이 stdout으로 응답을 출력하고 종료합니다.

—resume

claude --resume
claude --resume <session-id>

이전 세션을 재개합니다. ID를 지정하지 않으면 가장 최근 세션을 재개합니다.

—permission-mode

claude --permission-mode bypass-permissions
claude --permission-mode plan
claude --permission-mode accept-edits

세션의 권한 모드를 설정합니다.

—output-format

claude --print --output-format json "질문"
claude --print --output-format stream-json "질문"

비대화형 모드의 출력 형식을 지정합니다. text(기본), json, stream-json 중 선택합니다.

—verbose

claude --verbose

상세 로그 모드입니다. 도구 실행, API 호출, 내부 처리 과정을 상세히 출력합니다. 디버깅이나 동작 이해에 유용합니다.

—bare

claude --bare

최소 모드입니다. CLAUDE.md 파일과 기본 시스템 프롬프트를 로드하지 않습니다. 완전히 새로운 환경에서 테스트할 때 사용합니다.

—add-dir

claude --add-dir /path/to/extra/context
claude --add-dir ~/shared-docs

추가 디렉토리를 작업 컨텍스트에 포함합니다. 현재 프로젝트 외부의 파일도 Claude가 읽을 수 있게 됩니다.

주요 플래그 비교

플래그	적용 시점	용도
`--print`	시작 시	비대화형 모드 활성화
`--resume`	시작 시	이전 세션 재개
`--permission-mode`	시작 시	전체 세션 권한 설정
`--output-format`	시작 시	stdout 출력 형식 지정
`--verbose`	시작 시	상세 로그 출력
`--bare`	시작 시	CLAUDE.md 로딩 비활성화
`--add-dir`	시작 시	추가 컨텍스트 디렉토리

명령어 처리 파이프라인

슬래시 명령어가 처리되는 흐름입니다.

사용자 입력: "/compact"
        ↓
입력 파서: '/'로 시작하는지 확인
        ↓
명령어 라우터: "compact" 핸들러 찾기
        ↓
핸들러 실행:
  - 컨텍스트 저장
  - 요약 생성 요청
  - 메시지 교체
        ↓
UI 업데이트: 결과 표시

일반 대화 입력은 Claude API로 전송되지만, /로 시작하는 명령어는 Claude를 거치지 않고 직접 핸들러가 처리합니다.