claude/docs/guides/custom-commands.md

Claude Code カスタムコマンドガイド

概要

Claude Codeでは、プロジェクト固有またはユーザー固有のカスタムスラッシュコマンドを作成できます。

カスタムコマンドの種類

1. プロジェクトコマンド

• 場所: .claude/commands/
• プレフィックス: /project:
• スコープ: 現在のプロジェクト内

2. ユーザーコマンド

• 場所: ~/.claude/commands/
• プレフィックス: /user:
• スコープ: すべてのプロジェクト

作成したカスタムコマンド

基本ヘルプ

/project:help

Claude Codeの拡張ヘルプを表示します。

カテゴリ別ヘルプ

/project:help/shortcuts   # ショートカットキー詳細
/project:help/quickref    # クイックリファレンス
/project:help/safety      # 安全利用ガイド

カスタムコマンドの作成方法

基本構造

---
name: コマンド名
description: コマンドの説明
bash: 実行前のbashコマンド（オプション）
---

# コマンドの内容

ここにMarkdown形式でコマンドの内容を記述

例: 新しいコマンドの作成

# プロジェクトコマンドとして作成
mkdir -p .claude/commands
echo "プロジェクト固有の情報" > .claude/commands/project-info.md

# ユーザーコマンドとして作成
mkdir -p ~/.claude/commands
echo "個人的なスニペット" > ~/.claude/commands/snippets.md

高度な機能

1. 引数の使用

---
name: search
description: コードベースを検索
---

$ARGUMENTSを検索します。

使用例: /project:search TODO

2. bashコマンドの実行

---
bash: date +"%Y-%m-%d %H:%M:%S"
---

現在時刻: $BASH_OUTPUT

3. ファイル参照

---
name: readme
---

@README.md

上記はプロジェクトのREADMEです。

4. ネストされたコマンド

.claude/commands/
├── help.md           # /project:help
├── help/
│   ├── shortcuts.md  # /project:help/shortcuts
│   └── safety.md     # /project:help/safety

使用上のヒント

1. 命名規則

   • わかりやすい名前を使用
   • ハイフンまたはアンダースコアで単語を区切る
   • 短く覚えやすい名前を選ぶ

2. 説明の重要性

   • descriptionフィールドは必ず記入
   • コマンドの目的を明確に

3. 保守性

   • 定期的に使わないコマンドは削除
   • 類似コマンドは統合を検討

トラブルシューティング

コマンドが表示されない

• ファイルが.md拡張子であることを確認
• 正しいディレクトリに配置されているか確認
• YAMLフロントマターの構文を確認

bashコマンドが実行されない

• bash:フィールドの構文を確認
• コマンドの実行権限を確認

今後の拡張案

1. チームでの共有

   • .claude/commands/をGitで管理
   • チーム共通のコマンドセットを作成

2. テンプレート化

   • よく使うパターンをテンプレート化
   • プロジェクトタイプ別のコマンドセット

3. 自動化

   • プロジェクト初期化時にコマンドを自動生成
   • 使用頻度に基づく最適化