Claude Code でカスタムスラッシュコマンドを作成する

Claude Code では / で始まる文字列が組み込みのスラッシュコマンドとして定義されています。スラッシュコマンドを使用することであらかじめ割り当てられた操作を実行できます。よく使われるスラッシュコマンドには以下のようなものがあります。

• /add-dir: 現在のディレクトリに加えて、新しいワーキングディレクトリを追加する
• /clear: 会話履歴をクリアして、コンテキストウィンドウをリセットする
• /init: 現在のプロジェクトの構成を調査して、CLAUDE.md ファイルを生成する
• /release-notes: Claude Code のリリースノートを表示する
• /help: ヘルプと利用可能なスラッシュコマンドのリストを表示する

利用可能なすべてのスラッシュコマンドのリストは、/help コマンドを入力することで確認できます。（Anthropicのドキュメントにも記載されていますが、Claude Code の更新は頻繁に行われているため最新の情報が反映されていない場合があります）。

このスラッシュコマンドは、ユーザーが独自に定義することもできます。この記事では、Claude Code でカスタムスラッシュコマンドを作成する方法について説明します。

カスタムスラッシュコマンドの作成

カスタムスラッシュコマンドでは頻繁に使用するプロンプトをマークダウンファイルとして定義します。マークダウンファイルの名前から .md を除いた部分がスラッシュコマンドの名前になります。例えば、/my-command というスラッシュコマンドを作成する場合は、my-command.md というファイルを作成します。

カスタムスラッシュコマンドはプロジェクト単位もしくはユーザー単位で定義できます。

• プロジェクト単位: プロジェクトのルートディレクトリに .claude/commands ディレクトリを作成し、その中にマークダウンファイルを配置する
• ユーザー単位: ~/.claude/commands ディレクトリを作成し、その中にマークダウンファイルを配置する

試しに /article-review というスラッシュコマンドを作成してみましょう。このコマンドは、記事のレビューを行うためのプロンプトを定義します。

---
allowed-tools: Bash(git:*), Bash(npm:*), Read(*.md), Fetch(*)
description: "引数で指定した記事のレビューを行います。"
---
 
あなたはプロの編集者です。技術記事を読んで、誤字脱字、文法的な誤り、不自然な表現を指摘してください。
 
## 出力形式
 
```
【誤字脱字・表記ミス】
- 該当箇所：「〇〇〇」
  修正案：「×××」
  理由：[具体的な理由]
 
【文法的誤り】
- 該当箇所：「〇〇〇」
  修正案：「×××」
  理由：[具体的な理由]
 
【改善提案】
- より読みやすくするための提案があれば記載
```
 
### 注意事項
 
- 文体や表現の好みではなく、明確な誤りのみを指摘してください
- 修正案は必ず提示してください
- 記事の良い点にふれる必要はありません。指摘事項のみを出力してください
 
## コンテキスト
 
- 文書校正を行うコマンド: !`npx textlint blogPost/$ARGUMENTS.md`
- 筆者の文章のスタイルは @writing-style.md を参照
 
---
記事本文
 
@blogPost/$ARGUMENTS.md

カスタムスラッシュコマンドのファイルはマークダウン形式で記述します。ファイルの先頭には YAML フロントマターでコマンドのメタデータを定義できます。

• allowed-tools: このコマンドで使用できるツールを指定します
• description: コマンドの説明

またマークダウンファイル内ではいくつかの特別なキーワードを使用できます。

• $ARGUMENTS: コマンドの引数を参照するためのキーワード。コマンド実行時にユーザーが入力した引数がここに置き換えられます。
• ! で始まる行: スラッシュコマンドを実行する前に Bash コマンドを実行する。出力結果はスラッシュコマンドのコンテキストとして使用される
• @ で始まるファイル名: 指定されたファイルのパスを参照し、その内容をスラッシュコマンドのコンテキストとして使用する

カスタムスラッシュコマンドが正しく定義されている場合、Claude Code のチャットウィンドウで / を入力すると、定義したスラッシュコマンドが候補として表示されます。

カスタムコマンドを実行すると、引数で指定したファイルを読み込み、定義したプロンプトに基づいて処理が実行されました。

まとめ

• Claude Code では / で始まる文字列がスラッシュコマンドとして定義されている
• カスタムスラッシュコマンドはプロジェクト単位もしくはユーザー単位で定義できる
  • プロジェクト単位の場合は .claude/commands ディレクトリにマークダウンファイルを配置する
  • ユーザー単位の場合は ~/.claude/commands ディレクトリにマークダウンファイルを配置する
• マークダウンのファイル名から .md を除いた部分がスラッシュコマンドの名前になる
• スラッシュコマンドはマークダウンファイルとして定義し、YAML フロントマターで allowed-tools や description を指定できる
• スラッシュコマンド内では $ARGUMENTS を使用して引数を参照できる
• ! で始まる行はスラッシュコマンド実行前に Bash コマンドを実行し、出力結果をコンテキストとして使用できる
• @ で始まるファイル名は指定されたファイルの内容をコンテキストとして使用できる

参考

• Slash commands - Anthropic
• 【Claude Code】カスタムSlash Commandの作り方とコマンド例を紹介する