봉로그

터미널 환경에서 클로드를 마치 내 손가락처럼 자유자재로 움직이게 만드는 기본 슬래시 명령어, 작업 효율을 극대화하는 특수 문법, 자동화를 위한 단일 명령 모드, 그리고 강력하지만 주의해야 할 YOLO 모드와 커스텀 명령어 제작법까지 낱낱이 파헤쳐 보겠습니다.

1. 터미널의 비서, 핵심 슬래시(/) 명령어 탑 14

클로드 코드는 터미널 창에서 슬래시(/)로 시작하는 강력한 커맨드 세트를 제공합니다.
각 명령어의 목적을 이해하면 작업 속도가 대폭 빨라집니다.

📁 프로젝트의 기억 장치 생성 (/init)

• 역할: 현재 디렉터리의 파일, 폴더 구조를 스캔하고 package.json 등을 읽어 기술 스택과 코딩 컨벤션을 파악한 뒤, 프로젝트 컨텍스트를 담은 CLAUDE.md 파일을 자동으로 생성합니다.
• 내용: 빌드/테스트/린트 명령어, 아키텍처 개요, 코딩 규칙이 환경에 맞게 담깁니다.
• 효과: 클로드에게 매번 프로젝트를 설명할 필요가 없어 일관된 응답을 얻고 팀원과 공유할 수 있습니다. 이미 파일이 있어도 실행 시 개선점을 제안합니다.

🧹 토큰 절약과 컨텍스트 관리 (/clear, /compact, /context)

• /clear: 대화 내용을 모두 지우고 완전히 새로 시작합니다. (새 주제 시작 시, 이전 대화가 방해될 때, 느려질 때 사용)
• /compact: 대화가 길어져 컨텍스트 윈도우가 가득 차면 오동작하거나 느려집니다. 이때 대화 내용을 요약/압축합니다.
  • 예시: $ /compact API 설계 관련 내용을 중심으로 컨텍스트를 요약해 (선택적 실행 가능)
  • 팁: “context window full” 경고가 뜨거나 특정 주제에 집중하고 싶을 때, 작업 단위가 바뀔 때마다 /clear나 /compact를 쓰는 것이 토큰을 아끼는 비결입니다.
• /context: 현재 사용 중인 모델 버전, 소비 토큰, 전체 가용 토큰, 자동 압축(auto-compact) 트리거까지 남은 양, MCP 호출 토큰량 등 현재 세션의 상태를 시각화하여 모니터링합니다.

🛠️ 기타 유용한 슬래시 명령어 모음

2. 생산성을 높이는 자주 쓰는 단축키

3. 프롬프트 내 특수 문법 (@, !, #)

입력창에서 특수 기호를 사용하면 파일 참조와 시스템 명령을 기가 막히게 제어할 수 있습니다.

• @ (파일/폴더 참조): 컨텍스트에 특정 파일을 직접 포함합니다. @src/ 입력 후 [Tab] 키를 누르면 파일 목록이 표시됩니다.
  💡 @src/utils/auth.js 이 파일의 로직을 설명해줘 💡 @src/components/ 이 디렉토리 구조를 분석해줘
• ! (Bash 명령 직접 실행): 프롬프트 시작에 !를 붙이면 클로드를 거치지 않고 내 터미널 명령을 즉시 실행합니다. 클로드를 타지 않으므로 토큰(비용)이 전혀 들지 않습니다.
  💡 !git status | !npm test | !ls -la
• # (메모리에 즉시 기록): #으로 문장을 시작하면 대화 내용이 아니라 CLAUDE.md 파일에 해당 규칙이 즉시 추가됩니다.
  💡 # 이 프로젝트는 TypeScript strict 모드를 사용한다.

4. 대화 모드 vs 단일 명령 모드 (-p 플래그)

클로드 코드는 터미널 안에서 계속 대화하는 모드 외에도, 일회성 명령이나 자동화 스크립트에 이식할 수 있는 단일 명령 모드를 지원합니다.

• 대화 모드 ($ claude): 기본 모드로, 컨텍스트가 유지되어 이전 대화를 기반으로 꼬리 질문을 이어가며 작업할 수 있습니다.
• 단일 명령 모드 (-p 플래그): 한 번의 질의 후 작업을 완료하고 즉시 종료됩니다. 파이프라인 연동에 최적화되어 있습니다.Bash$ claude -p "이 프로젝트의 구조를 설명해줘" $ cat error.log | claude -p "이 에러의 원인을 분석해줘" $ git diff | claude -p "이 변경사항을 요약해줘"

🤖 응용: GitHub Actions에서 클로드로 코드 리뷰 자동화하기

CI/CD 빌드 시 YAML 파일에 다음과 같이 추가하여 자동 리뷰 리포트를 JSON으로 생성할 수 있습니다.

YAML

- name: Code Review
  run: |
    claude -p "이 코드의 품질을 분석하고 리포트를 생성해줘" \
    --output-format json > review.json

5. YOLO 모드와 정교한 권한 제어법

기본적으로 클로드 코드는 안전을 위해 파일 읽기/쓰기, 명령어 실행, 네트워크 요청 전에 매번 유저에게 확인 승인을 요청합니다.
하지만 완벽한 자율 주행을 원한다면 유저 허가 없이 달리는 YOLO 모드를 쓸 수 있습니다.

Bash

# 사용자 승인 단계를 완전히 건너뛰는 자율 모드
$ claude --dangerously-skip-permissions

⚠️ 주의: 파일을 잘못 삭제하거나 프로젝트 범위 외의 위험한 작업을 실행할 수 있으므로, 반드시 CLAUDE.md에 해야 할 일과 하지 말아야 할 규칙을 명시해야 합니다.

🔒 안전장치 ①: --allowedTools 옵션으로 실시간 권한 제한

명령어 뒤에 허용할 도구와 범위를 직접 지정하여 실행합니다.

Bash

# 파일 읽기, 쓰기 및 npm run lint 관련 bash 명령만 허용
$ claude -p "지금 작성한 코드에서 린트 에러 수정해줘" \
         --allowedTools "Read,Write,Bash(npm run lint:*)"

🔒 안전장치 ②: settings.json으로 상시 권한 통제

.claude/settings.json 파일에 퍼미션을 명시해 두면 안전합니다.
이때 deny(거부) 규칙이 allow(허용) 규칙보다 항상 우선순위가 높습니다.

JSON

{
  "permissions": {
    "allow": ["Read", "Edit", "Bash(git:*)", "Bash(npm:*)"],
    "deny": ["Read(.env)", "Bash(rm:*)", "Bash(sudo:*)"]
  }
}

6. 나만의 커스텀 슬래시 명령어 제작하기

자주 반복해서 쓰는 긴 프롬프트는 나만의 슬래시 명령어(예: /optimize)로 커스텀하여 보관할 수 있습니다.
마크다운 파일의 이름이 곧 명령어 이름이 됩니다.

🛠️ 프로젝트 전용 커스텀 명령어 만들기

Bash

# 1. 커맨드 저장용 디렉터리 생성
$ mkdir -p .claude/commands
# 2. 원하는 프롬프트 내용을 마크다운 파일로 저장
$ echo "이 코드의 성능 이슈를 분석하고 최적화 방안을 제안해줘:" > .claude/commands/optimize.md
# 3. 중요: 새로 만든 커맨드는 세션 시작 시 로드되므로, 클로드를 종료했다가 재시작해야 적용됩니다!
$ exit
$ claude
# 4. 이제 터미널에서 입력 가능!
$ /optimize

*(※ 모든 프로젝트에서 공통으로 사용하고 싶다면 프로젝트 폴더가 아닌 홈 디렉터리(~/.claude/commands/)*에 저장하면 됩니다.)

🚀 인자($ARGUMENTS)를 받는 고급 커스텀 명령어 작성법

마크다운 내부에 $ARGUMENTS 또는 $1, $2 같은 변수를 지정하면 명령어를 입력할 때 동적으로 값을 넘겨줄 수 있습니다.

예시 1: .claude/commands/fix-issue.md (이슈 자동 해결)

Markdown

Github Issue $ARGUMENTS를 분석하고 수정해줘
1. gh issue view로 이슈 내용 확인
2. 관련 코드 찾기
3. 수정 구현
4. 테스트 실행
5. 커밋하고 PR 생성
인자가 비어있으면 먼저 `gh issue list`로 열린 이슈 목록을 보여줘.

👉 실행 방법: $ /fix-issue 123

예시 2: .claude/commands/review-pr.md (다중 인자 활용 PR 리뷰)

Markdown

PR #$1을 리뷰해줘. 우선 순위는 $2이고, 담당자는 $3에게 할당해.

👉 실행 방법: $ /review-pr 456 high alice