💻 Claude Code入門 📖 約16分で読めます

カスタムスラッシュコマンドの作り方 ― 自分だけのワークフローを構築

.claude/commands/ディレクトリで独自コマンドを定義する方法

クロガイド｜Claude＆Claude Codeを無料で学ぼう

AI基礎からプロンプト術、Claude Codeの使い方まで。知識レッスンとクイズ式トレーニングで、AIスキルを段階的にアップ。ユーザー登録不要、すべて無料で今すぐ始められます。

はじめに

Claude Codeのカスタムスラッシュコマンドは、よく使うワークフローを.claude/commands/ディレクトリ内のMarkdownファイルとして定義し、/コマンド名で呼び出せる機能です。チームの開発規約を標準化したり、繰り返しの作業を効率化したりするのに非常に有効です。

この記事では、カスタムコマンドの作り方から、実用的なコマンド例5選以上までを解説します。

.claude/commands/ディレクトリの構成
コマンドファイルの作り方
パラメータ付きコマンド
チームでのコマンド共有
実用コマンド例5選+
高度なテクニック
まとめ

.claude/commands/ディレクトリの構成

カスタムスラッシュコマンドは、特定のディレクトリにMarkdownファイルを配置することで定義します。

コマンドの配置場所

場所	スコープ	用途
`.claude/commands/` または `.claude/skills/`	プロジェクト単位	プロジェクト固有のコマンド（チーム共有可能）
`~/.claude/commands/` または `~/.claude/skills/`	ユーザー単位	全プロジェクトで使うグローバルなコマンド

ディレクトリ構成例

my-project/
├── .claude/
│   └── commands/
│       ├── deploy.md           → /deploy で呼び出し
│       ├── create-component.md → /create-component で呼び出し
│       ├── db-migrate.md       → /db-migrate で呼び出し
│       ├── generate-tests.md   → /generate-tests で呼び出し
│       └── update-docs.md      → /update-docs で呼び出し
├── src/
├── tests/
└── CLAUDE.md

命名ルール

ファイル名がそのままコマンド名になる（拡張子.mdを除く）
ケバブケース（ハイフン区切り）を推奨：create-component.md
サブディレクトリで分類も可能：commands/db/migrate.md → /db:migrate

コマンドファイルの作り方

コマンドファイルはMarkdown形式で、Claude Codeへの指示をそのまま記述します。

基本構造

.claude/commands/format.md

プロジェクト内の変更されたファイルをフォーマットしてください。

手順：
1. `git diff --name-only`で変更されたファイルを特定する
2. PHPファイルには`php-cs-fixer fix`を実行する
3. JavaScriptファイルには`npx prettier --write`を実行する
4. CSSファイルには`npx prettier --write`を実行する
5. フォーマット結果を報告する

このファイルを配置すると、Claude Codeのセッション中に/formatと入力するだけで上記の手順が実行されます。

効果的なコマンドファイルの書き方

ポイント

目的を明確に：最初の1〜2行で何をするコマンドかを説明
手順を具体的に：番号付きリストで手順を明確にする
条件分岐を含める：「もし〜なら」の条件も記述
エラーハンドリング：エラー時の対応も記述
出力形式を指定：結果をどう表示するか指定

パラメータ付きコマンド

コマンドに引数を渡すことで、柔軟な操作が可能です。

$ARGUMENTSの使い方

.claude/commands/create-component.md

以下の名前でコンポーネントを作成してください: $ARGUMENTS

作成するファイル：
1. `src/components/$ARGUMENTS/$ARGUMENTS.php` - メインコンポーネント
2. `src/components/$ARGUMENTS/$ARGUMENTS.css` - スタイルシート
3. `tests/components/$ARGUMENTS.test.php` - テストファイル

テンプレート要件：
- PHPファイルにはクラス定義とrender()メソッドを含める
- CSSファイルにはBEM命名規則でベースクラスを定義
- テストファイルにはrender、props、イベントの基本テストを含める
- コーディング規約はCLAUDE.mdに従うこと

# 使い方
/create-component UserProfile

# $ARGUMENTSが "UserProfile" に置換される

複数パラメータの活用

.claude/commands/create-api.md

以下の仕様でREST APIエンドポイントを作成してください。

引数: $ARGUMENTS
（形式: リソース名 [オプション]）

例: /create-api products --with-auth --with-pagination

手順：
1. 引数からリソース名を解析する
2. 以下のファイルを作成する:
   - api/{リソース名}.php - APIエンドポイント
   - includes/{リソース名}_handler.php - ビジネスロジック
3. CRUDエンドポイント（GET一覧、GET単体、POST、PUT、DELETE）を実装
4. --with-authが指定されていれば認証チェックを追加
5. --with-paginationが指定されていればページネーションを追加
6. レスポンスはJSON形式
7. エラーハンドリングを含める

プロジェクトの.claude/commands/ディレクトリをGitで管理すれば、チーム全員が同じカスタムコマンドを使えます。

チーム共有の手順

.claude/commands/ディレクトリを作成
コマンドファイル（.md）を配置
Gitにコミット＆プッシュ
チームメンバーがプル後、すぐにコマンドが利用可能

# .gitignoreに.claudeを除外していないことを確認
# 以下のように設定を追加
# .gitignore
.claude/settings.json    # 個人設定は除外
!.claude/commands/       # コマンドは共有する

共有時のベストプラクティス

コマンドファイルの先頭にコメントで用途を説明する
チームのコーディング規約をコマンドに組み込む
プロジェクト固有の技術スタック情報を含める
新メンバーのオンボーディングにもなる

実用コマンド例5選+

コマンド1: /deploy（デプロイ）

.claude/commands/deploy.md

デプロイを実行してください。

対象環境: $ARGUMENTS（指定がなければ staging）

手順：
1. `git status`で未コミットの変更がないか確認する
   - 変更がある場合はデプロイを中止し、先にコミットするよう提案
2. `git log --oneline -5`で最近のコミットを表示して確認
3. 対象環境に応じたデプロイコマンドを実行：
   - staging: `./scripts/deploy-staging.sh`
   - production: 本番デプロイ前に変更内容のサマリーを表示し、確認を求める
4. デプロイ後に `curl -s -o /dev/null -w "%{http_code}" https://対象URL/health` でヘルスチェック
5. 結果を報告する

注意：
- productionデプロイ前には必ず確認を求めること
- エラーが発生した場合はログを表示して対処法を提案すること

コマンド2: /generate-tests（テスト生成）

.claude/commands/generate-tests.md

以下のファイルのテストを生成してください: $ARGUMENTS

手順：
1. 指定されたファイルを読み込む
2. ファイル内のすべてのパブリックメソッドを列挙する
3. 各メソッドに対して以下のテストケースを生成する:
   - 正常系（期待される入力での動作）
   - 異常系（不正な入力、エッジケース）
   - 境界値（最小値、最大値、空値）
4. テストファイルを tests/ ディレクトリに配置する
   - ファイルパスに対応する構造で配置
   - 例: src/Services/UserService.php → tests/Services/UserServiceTest.php
5. テストを実行して全てパスすることを確認する

テストの規約：
- PHPUnit使用
- テストメソッド名は test_メソッド名_条件_期待結果 形式
- 日本語コメントで各テストの目的を記述
- setUp()で共通の初期化処理をまとめる

コマンド3: /db-migrate（データベースマイグレーション）

.claude/commands/db-migrate.md

データベースマイグレーションを作成・実行してください。

操作: $ARGUMENTS
（例: /db-migrate create users_add_email, /db-migrate run, /db-migrate rollback）

引数の解析：
- "create [名前]": 新しいマイグレーションファイルを作成
- "run": 未実行のマイグレーションを実行
- "rollback": 最後のマイグレーションを取り消す
- "status": マイグレーションの状態を確認

マイグレーションファイルの配置先: db/migrations/
ファイル名形式: YYYYMMDD_HHMMSS_名前.sql

マイグレーションファイルには以下を含める：
- -- UP: セクション（適用するSQL）
- -- DOWN: セクション（取り消すSQL）

データベースはSQLite3を使用。
既存のスキーマはdb/schema.sqlを参照すること。

コマンド4: /update-docs（ドキュメント更新）

.claude/commands/update-docs.md

コードの変更に合わせてドキュメントを更新してください。

対象: $ARGUMENTS（指定がなければ直近のコミット）

手順：
1. 対象のコード変更を確認する
   - 指定がなければ `git diff HEAD~1` で確認
   - ファイルパスが指定されていればそのファイルを確認
2. 変更に関連するドキュメントを特定する:
   - CLAUDE.md内の関連セクション
   - API仕様に関わる場合はAPI docを更新
   - 設定変更の場合はセットアップ手順を更新
3. ドキュメントを更新する
4. 変更箇所の差分を表示して確認を求める

注意：
- 既存のドキュメントスタイルに合わせること
- 日本語で記述すること
- コードブロックには適切な言語指定を付けること

コマンド5: /security-check（セキュリティチェック）

.claude/commands/security-check.md

プロジェクトのセキュリティチェックを実行してください。

対象: $ARGUMENTS（指定がなければプロジェクト全体）

チェック項目：
1. **SQLインジェクション**: プリペアドステートメントを使用していないクエリを検出
2. **XSS**: htmlspecialchars()なしの出力を検出
3. **CSRF**: フォームにCSRFトークンが含まれているか確認
4. **認証**: 管理画面のルートに認証チェックがあるか確認
5. **機密情報**: ハードコードされたパスワードやAPIキーを検出
6. **ファイルパーミッション**: 設定ファイルへのアクセス制御を確認
7. **入力バリデーション**: ユーザー入力の検証が適切か確認

出力形式：
- 各チェック項目ごとに結果を表示
- 問題が見つかった場合はファイル名と行番号を表示
- 重大度を「高」「中」「低」で分類
- 各問題に対する修正案を提示

注意：
- 誤検知の可能性がある場合はその旨を記載すること
- CLAUDE.mdのセキュリティ要件も参照すること

コマンド6: /create-page（ページ生成）

.claude/commands/create-page.md

新しいページを作成してください: $ARGUMENTS

作成するファイル：
1. ページ本体のPHPファイル
2. 必要に応じてCSSの追記
3. ナビゲーションへのリンク追加

テンプレートに含める要素：
- 共通ヘッダー（includes/header.php）
- 共通フッター（includes/footer.php）
- メタタグ（title, description, OGP）
- パンくずリスト
- レスポンシブ対応のレイアウト

CLAUDE.mdのデザイン要件に従うこと。
既存ページのスタイルと一貫性を保つこと。

高度なテクニック

コンテキスト情報の活用

コマンドファイル内でプロジェクトの情報を参照するよう指示できます。

# コマンド内でCLAUDE.mdを参照させる
CLAUDE.mdのコーディング規約に従って作業してください。

# Git情報を活用させる
git logから最近のコミットスタイルを参照して、
同じ形式でコミットメッセージを生成してください。

条件分岐を含むコマンド

# ファイルの種類に応じた処理
引数で指定されたファイルの拡張子に応じて以下を実行：
- .php → PHPUnitテストを生成
- .js → Jestテストを生成
- .py → pytestテストを生成
- それ以外 → 対応していない旨を通知

まとめ

カスタムスラッシュコマンドのポイントを振り返ります。

配置場所：.claude/commands/（プロジェクト）または~/.claude/commands/（グローバル）にMarkdownファイルを配置
命名：ファイル名がコマンド名になる。ケバブケースを推奨
パラメータ：$ARGUMENTSプレースホルダーで引数を受け取れる
チーム共有：.claude/commands/をGitで管理すれば全員が使える
実用例：deploy、テスト生成、DBマイグレーション、ドキュメント更新、セキュリティチェック等
コツ：目的・手順・条件・エラーハンドリングを明確に記述する