Claude Code のカスタムスラッシュコマンドを作ったら、よく使う指示がかなり楽になった話

👀 結論から

Claude Code には .claude/commands/ ディレクトリにMarkdownファイルを置くだけで、独自のスラッシュコマンドを作れる機能があります！

/review や /gentest のような形で呼び出せるようになり、毎回同じ長いプロンプトを入力し直す手間がなくなりました。

実際に仕事で使い始めてから、よく使う指示の呼び出しがかなりスムーズになっています(^^)

Claude Code のカスタムスラッシュコマンドは、よく使うプロンプトをファイルに保存しておいて、/コマンド名 の形で素早く呼び出せる仕組みです。

設定方法はシンプルで、プロジェクト直下に .claude/commands/ ディレクトリを作って、その中にMarkdownファイルを置くだけです。

例えば .claude/commands/review.md というファイルを作ると、Claude Code 上で /review と入力するだけでその内容をプロンプトとして送れるようになります！

グローバルに使いたい場合は ~/.claude/commands/ に置けば、すべてのプロジェクトで共通して使えます。

プロジェクト単位の設定はバージョン管理に含められるので、チームで同じコマンドを共有できるのもかなり便利です(^_^)

私が実際によく使っているコマンドをいくつか紹介します。

コードレビューコマンド（/review）

PR に出す前に「潜在的な問題がないか確認して」という指示を毎回送っていたのをコマンド化しました。

レビュー観点（セキュリティ・パフォーマンス・可読性など）を具体的にファイルに書いておくことで、毎回同じ質のチェックが受けられるようになっています。

コマンド一発でレビュー依頼が飛ぶので、PR 前の確認がかなりスムーズになりました！

テスト生成コマンド（/gentest）

「このファイルのユニットテストをVitest形式で書いて」という指示をコマンドにしています。

プロジェクトのテストルール（モック方針・命名規則など）もファイルに含めておくので、生成されるテストの精度が上がりました(^^)

変更まとめコマンド（/summary）

コミット前に「このPRの変更内容をわかりやすくまとめて」と頼む用のコマンドです。

PR の説明文を書くときに呼び出すと、変更の概要をすっきり整理してもらえます。

一番変わったのは、毎回プロンプトを考える認知負荷が減ったことです。

「また同じこと聞くのか…」と思いながら入力していた時間がなくなって、コードに向き合う時間が相当増えた感じがします！

チームメンバーと共有したときも「コマンドが決まってると頼みやすい」と言ってもらえて、AI活用の第一歩として受け入れてもらいやすかったです(^o^)/

コマンドのMarkdownファイル自体も、使いながら少しずつ育てていけるのが気に入っています。

コマンドが増えてくると「どんなコマンドがあったっけ？」となることがありました(・_・;)

/ を入力すると一覧が出るので迷子にはなりませんが、定期的に使っていないコマンドを整理する習慣は持っておいたほうが良さそうです。

また、コマンドにプロジェクト固有の情報（ファイル名や規約など）を含めすぎると、他のプロジェクトで使い回しにくくなります。

汎用的な指示部分とプロジェクト固有の部分を分けて管理するのが、長く使ううえでのコツかもしれません(^^;)

最初は固定文言のコマンドだけ作っていたんですが、$ARGUMENTS という変数を使うとコマンドに引数を渡せることを知ってから、コマンドの使い勝手がかなり上がりました。

例えば /summary コマンドを、対象を指定できる形に書き換えました。

---
description: 変更内容を要約する
argument-hint: [対象範囲]
---

$ARGUMENTS の変更内容をわかりやすく要約してください。

こうしておくと、/summary このPR全体 のように呼び出したときに、$ARGUMENTS の部分が「このPR全体」に置き換わってプロンプトとして送られます。

argument-hint を設定しておくと、コマンド入力中に「どんな引数を渡せばいいか」がヒントとして表示されるので、自分でもしばらく経つと忘れがちなコマンドの使い方を思い出しやすくなりました(^^)

もうひとつ触ってみたのが、サブディレクトリでの名前空間化です。

.claude/commands/docker/ps.md のようにディレクトリを切って置くと、/docker:ps のようにカテゴリ分けした状態で呼び出せます。

コマンドが増えてきてから、この名前空間化のおかげで一覧が探しやすくなりました！

ちなみに2026年のアップデートでカスタムコマンドは Skills という仕組みに統合される流れになっていて、既存の .claude/commands/ のファイルは今もそのまま動きますが、これから新しく作るコマンドは Skills の書き方も一度確認しておくとよさそうです。

パパ系Webエンジニア〜愛用ガジェット一覧 🛍️

AI開発・執筆に使っている作業デスク環境を楽天ROOMにまとめています ✨ デスク周りの参考にどうぞ 🙌

Claude Code のカスタムスラッシュコマンドを使うと、よく使う指示をコマンド一発で呼び出せるようになります🙌

まずは1〜2個だけコマンドを作ってみると、便利さがすぐに実感できると思います！