Claude Code攻略#Claude Code#カスタムコマンド#自動化
カスタムスラッシュコマンドの作り方【Claude Code自動化】
Claude Codeでカスタムスラッシュコマンドを作成し、繰り返し作業を自動化する方法を解説。
カスタムコマンドとは
カスタムスラッシュコマンドは、よく使う操作を1つのコマンドにまとめる機能です。
# 組み込みコマンド
/plan
/compact
/clear
# カスタムコマンド（自分で作れる）
/deploy ← デプロイ一式を実行
/test-all ← 全テストを実行
/review ← コードレビューを依頼
カスタムコマンドの作成方法
設定ファイルの場所
プロジェクト固有:
.claude/commands/
グローバル（全プロジェクト共通）:
~/.claude/commands/
コマンドファイルの作成
.claude/commands/ ディレクトリにMarkdownファイルを作成します。
ファイル名がコマンド名になります:
deploy.md→/deploytest-all.md→/test-all
実践例
例1: デプロイコマンド
.claude/commands/deploy.md:
以下のデプロイ手順を実行して:
1. 全テストを実行して、全てパスすることを確認
2. TypeScript の型チェックを実行
3. ESLint でエラーがないことを確認
4. 本番用にビルド
5. Vercel にデプロイ
6. デプロイURLを報告
途中でエラーがあれば停止して報告して。
使い方:
/deploy
例2: コードレビューコマンド
.claude/commands/review.md:
現在の変更をレビューして:
## チェック項目
1. **セキュリティ**: 脆弱性がないか
2. **パフォーマンス**: 非効率な処理がないか
3. **可読性**: コードが理解しやすいか
4. **テスト**: テストが十分か
5. **型安全性**: 型定義が適切か
## 出力形式
- 問題点: 重要度（高/中/低）と詳細
- 改善提案: 具体的なコード例
- 良い点: 称賛すべきポイント
例3: 新機能テンプレートコマンド
.claude/commands/new-feature.md:
新機能「$ARGUMENTS」を作成して:
1. Plan Mode で設計
- 必要なファイルを洗い出し
- 実装手順を計画
2. 実装
- コンポーネント作成
- APIルート作成（必要なら）
- 型定義
3. テスト
- ユニットテスト作成
- 動作確認
4. ドキュメント
- 使い方をREADMEに追記
使い方:
/new-feature ユーザープロフィール編集
$ARGUMENTS が「ユーザープロフィール編集」に置き換わります。
例4: 朝の開発準備コマンド
.claude/commands/morning.md:
朝の開発準備をして:
1. git pull で最新を取得
2. npm install で依存関係を更新
3. 開発サーバーを起動
4. 昨日のコミットログを表示
5. 今日やるべきことを確認（Issue/TODO）
例5: コミット支援コマンド
.claude/commands/smart-commit.md:
変更をコミットして:
1. git diff で変更内容を確認
2. 変更内容を分析
3. 適切なコミットメッセージを生成
- Conventional Commits 形式
- 日本語で
4. コミット実行
5. コミットログを表示
引数の使い方
$ARGUMENTS
コマンド実行時の引数全体:
/new-feature ユーザー認証機能
$ARGUMENTS = ユーザー認証機能
複数引数の扱い
# 引数: 機能名 優先度
新機能「$ARGUMENTS」を作成して...
/new-feature ログイン機能 高
引数を分割したい場合は、コマンド内でClaudeに解釈させます:
引数を解析して:
- 最初の単語: 機能名
- 2番目の単語: 優先度
「$ARGUMENTS」
ベストプラクティス
1. 明確な手順を書く
❌ 曖昧
デプロイして。
✅ 明確
以下の順序でデプロイを実行:
1. テスト実行
2. ビルド
3. デプロイ
4. 動作確認
2. エラー処理を含める
各ステップで:
- 成功したら次へ進む
- 失敗したら停止して報告
- エラー内容を表示
3. 出力形式を指定
結果は以下の形式で報告:
- 実行ステップ
- 所要時間
- 成功/失敗
- エラーがあれば詳細
4. 確認を挟む
危険な操作は確認を挟む:
本番環境にデプロイする前に:
1. 変更内容のサマリを表示
2. 続行するか確認を求める
プロジェクト固有 vs グローバル
プロジェクト固有（推奨）
my-project/.claude/commands/deploy.md
- そのプロジェクトでのみ使える
- プロジェクト特有の手順を定義
- チームで共有可能（gitにコミット）
グローバル
~/.claude/commands/review.md
- 全プロジェクトで使える
- 汎用的なコマンド向け
- 個人の設定
チームでの活用
コマンドをgitで管理
.claude/
├── commands/
│ ├── deploy.md
│ ├── review.md
│ └── test-all.md
└── CLAUDE.md
.gitignore に含めないことで、チーム全員が同じコマンドを使えます。
チームのワークフローを標準化
# .claude/commands/pr.md
PRを作成して:
1. 変更内容をサマリ
2. テストを実行
3. PRを作成
- タイトル: 変更内容から生成
- 本文: テンプレートに従う
- レビュワー: @team-lead を指定
- ラベル: 適切なものを選択
次のステップ
カスタムコマンドをマスターしました！
次は、Hooksを使った自動化を学びましょう。
まとめ
- カスタムコマンド = よく使う操作を1コマンドに
.claude/commands/にMarkdownファイルを作成- ファイル名がコマンド名になる
$ARGUMENTSで引数を受け取れる- プロジェクト固有/グローバルを使い分け
- チームでgit管理して標準化
参考文献・引用元
- [1]Claude Code Custom Commands- Anthropic