カスタムスラッシュコマンド繰り返す指示をMarkdownで登録して再利用する
カスタムスラッシュコマンドは、よく使う指示をMarkdownファイルとして保存し、「/名前」で呼び出せるようにする機能です。置き場所（プロジェクト用・個人用）、書き方、引数の受け渡し、例、スキルとの使い分け、チーム共有の考え方を整理します。
公的機関・公式資料などの一次情報と照合して作成しています。このサイトについて
カスタムスラッシュコマンドとは
Claude Codeでは、繰り返し使う指示（プロンプト）を、Markdownファイルとして保存し、/コマンド名で呼び出せるようにできます。これがカスタムスラッシュコマンドです。「コードレビューの依頼」「テストの実行と修正」「リリースノートの作成」のような、定型の作業を、1語で呼び出せるようになります（スラッシュコマンド、プロンプトテンプレートの作り方）。
ファイルの置き場所・書式・機能は、更新されることがあります。現行の公式ドキュメントでは、カスタムコマンドはスキルに統合されたと説明されており、.claude/commands/deploy.mdと.claude/skills/deploy/SKILL.mdは、どちらも/deployとして同じように動き、既存のコマンドファイルも引き続き使えるとされています。役割分担は今後も変わりうるため、公式ドキュメントで、最新の内容を確認してください（スキル（Skills））。
置き場所（スコープ）
| 場所 | 用途 |
|---|---|
プロジェクトのフォルダ内（.claude/commands/） |
そのプロジェクトで使うコマンド。Gitで共有し、チームで使える |
ユーザーのフォルダ内（~/.claude/commands/） |
自分用のコマンド。全プロジェクトで使える |
フォルダの中に、コマンド名.mdというファイルを置くと、/コマンド名で呼び出せます。サブフォルダで整理できる場合もあります（呼び出し名の付き方は、公式の仕様を確認）。
基本の書き方
ファイルの中身は、Claude Codeに渡す指示文（Markdown）です。
---
description: 変更内容をレビューして、問題点を指摘する
---
現在のブランチの、直近の変更（`git diff`）をレビューしてください。
観点：
- バグになりうる箇所
- 命名・可読性
- テストの不足
結果は、「重要度（高・中・低）」ごとに、箇条書きで報告してください。
| 要素 | 内容 |
|---|---|
| 先頭の設定部分（フロントマター） | 説明文（description）、許可するツール、使うモデルなどを指定できる（利用できる項目は、公式で確認） |
| 本文 | Claude Codeへの指示 |
引数を渡す
コマンドの後ろに書いた文字列を、指示文の中に埋め込むことができます（$ARGUMENTSなどの書き方。仕様は公式で確認）。
---
description: 指定したバグを調査して修正する
---
次の不具合を調査し、原因の特定と修正を行ってください。
不具合の内容：$ARGUMENTS
手順：
1. 再現する方法を確認する
2. 原因を特定する
3. 修正し、テストで確認する
呼び出し方の例：/fix-bug ログイン後に画面が真っ白になる
コマンドの例
| コマンド名 | 内容 |
|---|---|
/review |
差分のコードレビュー |
/test-fix |
テストを実行し、失敗を修正する |
/changelog |
前回のリリース以降の変更から、更新履歴を作る |
/explain |
指定したファイルや処理の、初心者向けの説明 |
/commit-msg |
変更内容から、コミットメッセージの案を作る |
作るときのコツ
| コツ | 内容 |
|---|---|
| 1コマンド1目的 | 目的を絞る |
| 手順と出力形式を書く | 結果の形が揃う（出力形式の指定） |
| 判断の基準を書く | 「重要度の定義」など |
| 引数を活用 | 毎回変わる部分だけを、引数にする |
| 名前を分かりやすく | 短く、意味が通る名前 |
| 実際に試して改善 | 使いながら、指示を調整する（プロンプトの改善サイクル） |
| 安全な範囲で | 破壊的な操作（削除・強制上書き）を、含めない |
チームでの共有
| 方法 | 内容 |
|---|---|
プロジェクトの.claude/commands/をGitで管理 |
チーム全員が、同じコマンドを使える |
| README等で一覧を共有 | 使い方を周知する |
| レビューして改善する | コードと同様に、変更をレビューする |
| 個人用と共有用の区別 | 個人の好みは、ユーザーのフォルダに |
コマンドは、実行時にコマンド内の指示が、そのままClaude Codeに渡されるため、他人が作ったコマンドを使う前に、中身を確認してください（安全に使うための設定）。
スキルとの使い分け
Claude Codeには、スキル（Skills）という、より構造化された、再利用の仕組みもあります（スキル（Skills））。
| 項目 | カスタムスラッシュコマンド | スキル |
|---|---|---|
| 呼び出し方 | 利用者が/名前で明示的に呼ぶ |
Claudeが、状況に応じて自動で使う。利用者が/名前で呼ぶこともでき、自動での使用を止める設定もある |
| 構成 | 1つのMarkdownファイルが基本 | フォルダ（指示＋補助ファイル・スクリプト） |
| 向く用途 | 定型の依頼を、手軽に呼び出す | 専門的な手順・知識を、まとまりとして持たせる |
両者の役割・統合の状況は、更新されることがあります。公式ドキュメントで、最新の位置づけを確認してください。
カスタムスラッシュコマンドの注意点
| 注意点 | 内容 |
|---|---|
| 仕様の変更 | 書式・機能が変わる可能性がある |
| 機密情報 | コマンドに、鍵・パスワードを書かない。Gitで共有される |
| コマンドの乱立 | 増えすぎると、管理が大変。定期的に整理する |
| 過信しない | コマンドを使っても、結果の確認は必要 |
カスタムスラッシュコマンドの具体例
レビュー用のコマンドを作り、チームで使うとします。観点（バグ・命名・テスト）と、出力の形式（重要度別の箇条書き）を、コマンドに書いておくと、誰が実行しても、同じ形式のレビューが得られます。レビューの観点が増えたら、コマンドを更新するだけで、チーム全体の運用が改善されます。
カスタムスラッシュコマンドのFAQ（よくある質問）
Q. コマンドファイルは、どこに置きますか？
A. プロジェクト用は.claude/commands/、個人用は~/.claude/commands/です。最新の仕様は、公式で確認してください。
Q. 引数は、複数渡せますか？
A. 渡せます。現行の公式ドキュメントでは、$ARGUMENTSで全体、$ARGUMENTS[0]や$0のように番号（0始まり）で個別の引数を参照する書き方が案内されています。仕様は更新されるため、公式ドキュメントを確認してください。
Q. 作ったコマンドが表示されません。
A. 置き場所、ファイル名、拡張子（.md）を確認し、Claude Codeを再起動してください。
筆者の見解（カスタムスラッシュコマンド）
カスタムコマンドは、「自分の仕事のやり方を、道具に変える」機能だと思います。同じ指示を3回書いたら、コマンドにする、という基準が実用的です。作って終わりではなく、使いながら磨くことで、自分専用の、頼れる道具になっていきます。
カスタムスラッシュコマンドの関連項目
出典（一次情報）
本記事は一般的な情報の提供を目的としています。AIのサービス・機能・料金・仕様は頻繁に更新されるため、最新の内容は各社の公式ドキュメントでご確認ください。「筆者の見解」は一つの考え方です。