SDK의 슬래시 명령어

슬래시 명령어는 /로 시작하는 특별한 명령어로 Claude Code 세션을 제어하는 방법을 제공합니다. 이러한 명령어는 SDK를 통해 전송되어 대화 기록 지우기, 메시지 압축, 도움말 가져오기 등의 작업을 수행할 수 있습니다.

사용 가능한 슬래시 명령어 찾기

Claude Agent SDK는 시스템 초기화 메시지에서 사용 가능한 슬래시 명령어에 대한 정보를 제공합니다. 세션이 시작될 때 이 정보에 액세스하세요:

import { query } from "@anthropic-ai/claude-agent-sdk";

for await (const message of query({
  prompt: "Hello Claude",
  options: { maxTurns: 1 }
})) {
  if (message.type === "system" && message.subtype === "init") {
    console.log("Available slash commands:", message.slash_commands);
    // 예시 출력: ["/compact", "/clear", "/help"]
  }
}

슬래시 명령어 전송

일반 텍스트와 마찬가지로 프롬프트 문자열에 슬래시 명령어를 포함하여 전송하세요:

일반적인 슬래시 명령어

`/compact` - 대화 기록 압축

/compact 명령어는 중요한 컨텍스트를 보존하면서 오래된 메시지를 요약하여 대화 기록의 크기를 줄입니다:

`/clear` - 대화 지우기

/clear 명령어는 모든 이전 기록을 지워서 새로운 대화를 시작합니다:

사용자 정의 슬래시 명령어 생성

내장 슬래시 명령어를 사용하는 것 외에도 SDK를 통해 사용할 수 있는 자신만의 사용자 정의 명령어를 생성할 수 있습니다. 사용자 정의 명령어는 서브에이전트가 구성되는 방식과 유사하게 특정 디렉토리의 마크다운 파일로 정의됩니다.

파일 위치

사용자 정의 슬래시 명령어는 범위에 따라 지정된 디렉토리에 저장됩니다:

프로젝트 명령어: .claude/commands/ - 현재 프로젝트에서만 사용 가능
개인 명령어: ~/.claude/commands/ - 모든 프로젝트에서 사용 가능

파일 형식

각 사용자 정의 명령어는 마크다운 파일입니다:

파일명(.md 확장자 제외)이 명령어 이름이 됩니다
파일 내용이 명령어가 수행하는 작업을 정의합니다
선택적 YAML 프론트매터가 구성을 제공합니다

기본 예시

.claude/commands/refactor.md 생성:

선택된 코드를 리팩토링하여 가독성과 유지보수성을 개선합니다.
클린 코드 원칙과 모범 사례에 중점을 둡니다.

이렇게 하면 SDK를 통해 사용할 수 있는 /refactor 명령어가 생성됩니다.

프론트매터 포함

.claude/commands/security-check.md 생성:

---
allowed-tools: Read, Grep, Glob
description: Run security vulnerability scan
model: claude-3-5-sonnet-20241022
---

다음을 포함한 보안 취약점에 대해 코드베이스를 분석합니다:
- SQL 인젝션 위험
- XSS 취약점
- 노출된 자격 증명
- 안전하지 않은 구성

SDK에서 사용자 정의 명령어 사용

파일 시스템에 정의되면 사용자 정의 명령어는 SDK를 통해 자동으로 사용할 수 있습니다:

고급 기능

인수 및 플레이스홀더

사용자 정의 명령어는 플레이스홀더를 사용하여 동적 인수를 지원합니다:

.claude/commands/fix-issue.md 생성:

---
argument-hint: [issue-number] [priority]
description: Fix a GitHub issue
---

우선순위 $2로 이슈 #$1을 수정합니다.
이슈 설명을 확인하고 필요한 변경사항을 구현합니다.

SDK에서 사용:

Bash 명령어 실행

사용자 정의 명령어는 bash 명령어를 실행하고 출력을 포함할 수 있습니다:

.claude/commands/git-commit.md 생성:

---
allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
description: Create a git commit
---

## 컨텍스트

- 현재 상태: !`git status`
- 현재 차이점: !`git diff HEAD`

## 작업

변경사항을 기반으로 적절한 메시지로 git 커밋을 생성합니다.

파일 참조

@ 접두사를 사용하여 파일 내용을 포함합니다:

.claude/commands/review-config.md 생성:

---
description: Review configuration files
---

다음 구성 파일의 문제점을 검토합니다:
- 패키지 구성: @package.json
- TypeScript 구성: @tsconfig.json
- 환경 구성: @.env

보안 문제, 오래된 종속성, 잘못된 구성을 확인합니다.

네임스페이싱을 통한 구성

더 나은 구조를 위해 하위 디렉토리에서 명령어를 구성합니다:

.claude/commands/
├── frontend/
│   ├── component.md      # /component (project:frontend) 생성
│   └── style-check.md     # /style-check (project:frontend) 생성
├── backend/
│   ├── api-test.md        # /api-test (project:backend) 생성
│   └── db-migrate.md      # /db-migrate (project:backend) 생성
└── review.md              # /review (project) 생성

하위 디렉토리는 명령어 설명에 나타나지만 명령어 이름 자체에는 영향을 주지 않습니다.

실용적인 예시

코드 리뷰 명령어

.claude/commands/code-review.md 생성:

---
allowed-tools: Read, Grep, Glob, Bash(git diff:*)
description: Comprehensive code review
---

## 변경된 파일
!`git diff --name-only HEAD~1`

## 상세 변경사항
!`git diff HEAD~1`

## 리뷰 체크리스트

위의 변경사항을 다음 항목에 대해 검토합니다:
1. 코드 품질 및 가독성
2. 보안 취약점
3. 성능 영향
4. 테스트 커버리지
5. 문서 완성도

우선순위별로 구성된 구체적이고 실행 가능한 피드백을 제공합니다.

테스트 실행 명령어

.claude/commands/test.md 생성:

---
allowed-tools: Bash, Read, Edit
argument-hint: [test-pattern]
description: Run tests with optional pattern
---

패턴과 일치하는 테스트 실행: $ARGUMENTS

1. 테스트 프레임워크 감지 (Jest, pytest 등)
2. 제공된 패턴으로 테스트 실행
3. 테스트가 실패하면 분석하고 수정
4. 수정 사항을 확인하기 위해 재실행

SDK를 통해 이러한 명령어를 사용합니다:

참고 자료

슬래시 명령어 - 완전한 슬래시 명령어 문서
SDK의 서브에이전트 - 서브에이전트를 위한 유사한 파일 시스템 기반 구성
TypeScript SDK 참조 - 완전한 API 문서
SDK 개요 - 일반적인 SDK 개념
CLI 참조 - 명령줄 인터페이스

import { query } from "@anthropic-ai/claude-agent-sdk";

// 슬래시 명령어 전송
for await (const message of query({
  prompt: "/compact",
  options: { maxTurns: 1 }
})) {
  if (message.type === "result") {
    console.log("Command executed:", message.result);
  }
}

import { query } from "@anthropic-ai/claude-agent-sdk";

for await (const message of query({
  prompt: "/compact",
  options: { maxTurns: 1 }
})) {
  if (message.type === "system" && message.subtype === "compact_boundary") {
    console.log("Compaction completed");
    console.log("Pre-compaction tokens:", message.compact_metadata.pre_tokens);
    console.log("Trigger:", message.compact_metadata.trigger);
  }
}

import { query } from "@anthropic-ai/claude-agent-sdk";

// 대화 지우기 및 새로 시작
for await (const message of query({
  prompt: "/clear",
  options: { maxTurns: 1 }
})) {
  if (message.type === "system" && message.subtype === "init") {
    console.log("Conversation cleared, new session started");
    console.log("Session ID:", message.session_id);
  }
}

import { query } from "@anthropic-ai/claude-agent-sdk";

// 사용자 정의 명령어 사용
for await (const message of query({
  prompt: "/refactor src/auth/login.ts",
  options: { maxTurns: 3 }
})) {
  if (message.type === "assistant") {
    console.log("Refactoring suggestions:", message.message);
  }
}

// 사용자 정의 명령어가 slash_commands 목록에 나타남
for await (const message of query({
  prompt: "Hello",
  options: { maxTurns: 1 }
})) {
  if (message.type === "system" && message.subtype === "init") {
    // 내장 명령어와 사용자 정의 명령어 모두 포함
    console.log("Available commands:", message.slash_commands);
    // 예시: ["/compact", "/clear", "/help", "/refactor", "/security-check"]
  }
}

import { query } from "@anthropic-ai/claude-agent-sdk";

// 사용자 정의 명령어에 인수 전달
for await (const message of query({
  prompt: "/fix-issue 123 high",
  options: { maxTurns: 5 }
})) {
  // 명령어는 $1="123" 및 $2="high"로 처리됩니다
  if (message.type === "result") {
    console.log("Issue fixed:", message.result);
  }
}

import { query } from "@anthropic-ai/claude-agent-sdk";

// 코드 리뷰 실행
for await (const message of query({
  prompt: "/code-review",
  options: { maxTurns: 3 }
})) {
  // 리뷰 피드백 처리
}

// 특정 테스트 실행
for await (const message of query({
  prompt: "/test auth",
  options: { maxTurns: 5 }
})) {
  // 테스트 결과 처리
}