ここは仕組みから学ぶ「詳しい版」です。設定を終わらせたいだけなら 全10ステップの手順書 が近道です。

スラッシュコマンドを自作する

手順

1. 置き場所の型を覚える

拡張子を除いたファイル名がコマンド名です。matome.md なら /matome になります。

2. コマンドのファイルを作る

今回は、作業の区切りで使う「まとめ」コマンドを作ります。

mkdir -p ~/.claude/commands
touch ~/.claude/commands/matome.md
open -e ~/.claude/commands/matome.md

mkdir -Force $HOME.claudecommands
notepad $HOME.claudecommandsmatome.md

次を貼って ⌘S（Windowsは Ctrl + S） で保存します。中身は、Claudeに送りたい頼み事の文章そのものです。

ここまでの作業内容を、次の3項目で短くまとめてください。

1. やったこと
2. 決めたこと
3. 次にやること

専門用語には短い説明を添えてください。

3. 使ってみる

Claude Codeを起動して、何か少し作業した後に打ちます。

/matome

3項目のまとめが返ってくれば成功です。長い頼み事が1語になりました。

4. 引数つきのコマンドを作る

文中に $ARGUMENTS と書くと、コマンドの後ろに打った文字がそこに入ります。翻訳ならぬ「やさしい日本語化」コマンドを作ってみます。

touch ~/.claude/commands/yasashiku.md
open -e ~/.claude/commands/yasashiku.md

notepad $HOME.claudecommandsyasashiku.md

次の文章を、専門用語を知らない人にも分かる日本語に書き直してください。
元の意味は変えないでください。

$ARGUMENTS

使うときは、コマンドの後ろに文章を続けます。

/yasashiku デプロイが完了したのでキャッシュをパージしてください

後ろに書いた文章が $ARGUMENTS の位置に差し込まれて、Claudeに送られます。

5. Skillとの関係を知っておく

実は、カスタムコマンドは4-6のSkillと同じ仕組みに統合されています。commands/matome.md も skills/matome/SKILL.md も、同じ /matome を作ります。

使い分けの目安は次のとおりです。

• 短い定型文を1語で呼びたい → コマンド（ファイル1枚で済む）
• 手順書＋補助ファイルで育てたい → Skill（フォルダで持てる）