Claude Codeで / を打つと、候補が何十個も並びます。公式の一覧表は121行あり、全部を覚える必要はありません。
会話の切り替え・文脈の整理・権限の設定あたりから覚えれば、日々の作業は回ります。残りは困ったときに探す索引です。
自作したいなら、.claude/skills/<名前>/SKILL.md を置けば /名前 で呼べます。以前の .claude/commands/ に置いたファイルも、そのまま動きます。
この記事では、組み込みコマンドを用途別に別名つきで並べます。自作の作り方は、手元の Claude Code v2.1.310 で動かした結果つきです。私のリポジトリにある自作コマンド14本・スキル18本の中身も出します。
この記事でわかること
- 組み込みコマンドの用途別一覧と、
/clearと/resetのような別名 .claude/commandsと Skills の関係(統合の経緯と、今の置き場所)- 引数
$ARGUMENTS・$0・$1の使い方と、実際に動かした結果 - 自作14本・スキル18本の中身と、ハマった2か所
PARTS LIST /目次
Claude Codeのスラッシュコマンドとは?3つの種類
スラッシュコマンドとは、メッセージの先頭に / を付けて Claude Code 自体を操作する入口です。モデルの切り替え、会話のリセット、権限の設定、定型作業の呼び出しまで、同じ書き方でそろっています。
由来で分けると3種類あります。CLI に内蔵された組み込み、Claude に渡すプロンプトとして動くバンドルスキル、自分で置く自作です。入力のルールは3種類とも共通なので、先にそちらを押さえます。
組み込み・バンドルスキル・自作の違い
組み込みコマンドは、動きが CLI の中にコードで書かれた処理です。/clear や /model がこれにあたります。
バンドルスキルは、最初から入っているスキルです。自分で書くスキルと同じく、実体は Claude に渡すプロンプトです。公式の一覧表では /code-review・/simplify・/loop・/batch などに印が付いています。
自作は、自分で置いた SKILL.md(または旧来の .claude/commands/ のファイル)です。MCP サーバーが公開するプロンプトも、同じ / のメニューにコマンドとして並びます。
入力のルール|先頭だけ有効・引数・連鎖
コマンドとして認識されるのは、メッセージの先頭にあるときだけです。コマンド名の後ろに書いた文字は、そのまま引数になります。
/に続けて文字を打つと候補が絞り込まれる。/adddirでも/add-dirに当たる(区切りの-_:は無視される)- 打ち間違えると、候補は並ぶのに Enter は入力した文字のまま送られ、
Unknown commandになる - Claude の応答中に送ったコマンドは待ち行列に入り、そのターンの後に動く。
/status・/tasks・/usageは割り込まずに即実行される - 端末では
/skill-a /skill-b 依頼文のように、1つのメッセージで最大6個のスキルを連鎖できる。後ろの文は各スキルに引数として渡る - プランや OS、環境によって、出ないコマンドがある(
/desktopは macOS と x64 Windows で Claude のサブスクにログインしているときだけ)。/heapdumpのように、メニューには出さず名前を最後まで打てば動くものもある
組み込みコマンド一覧|用途別に別名つきで整理
公式の一覧表(Commands)は121行あり、その3行は「削除済み」と明記されたコマンドです。この節では、日常の作業で出番がありそうなものを4つの用途に分けました。
別名は表の「別名」列に入れています。引数の <> は必須、[] は省略可です。全件が必要なときは、公式の表か、手元の /help を見てください。
作業の流れで見ると、この順番で使う
コマンドを用途ではなく流れで並べると、使う順番が見えてきます。計画から入り、文脈が重くなったら整理し、最後に差分を確かめる流れです。
flowchart TD
A["/init<br>CLAUDE.mdの雛形を作る"] --> B["/plan<br>実装前に計画だけ出す"]
B --> C["実装を任せる"]
C --> D{"文脈が重くなった?"}
D -->|"同じ作業を続ける"| E["/compact<br>要約して空ける"]
D -->|"別の作業へ移る"| F["/clear<br>空の会話で始める"]
E --> G["/diff<br>変更を確認"]
F --> G
G --> H["/code-review<br>バグを探す"]
文脈の重さは /context で見られます。/compact と /clear の使い分けは、同じ話題を続けるか、別の作業に移るかで決まります。会話を戻したり分岐したりする話は、Claude Codeセッション再開ガイドにまとめています。
会話そのものを操作するコマンド
会話の開始・要約・再開・分岐・巻き戻しを扱うグループです。長く使うほど出番が増えます。名前の違う別名がいちばん多いのも、このグループです。
/clear した会話は消えません。/resume で戻せるので、「リセットしたら全部消えた」という心配は要りません。
設定・権限・モデルを整えるコマンド
作業の前提を決めるグループです。初回のセットアップと、「なぜか承認を何度も求められる」といった違和感の調整で使います。
/permissions に足すルールの具体例は、Claude Codeおすすめ設定5選に載せています。/mcp の先はMCP設定ガイド、/hooks の先はhooksの使い方です。
計画・並列・自動実行に使うコマンド
「先に計画を出させる」「同時に何本も走らせる」「放っておいて任せる」を担当するグループです。バンドルスキル(表では「スキル」と記載)も混ざっています。
/plan は plan mode へ入る近道です。plan mode 自体の使い方はPlanモードの解説、並列に走らせる土台のサブエージェントはサブエージェントの使い方にあります。
レビュー・診断・使用量を見るコマンド
作業の結果を確かめるときと、おかしいときに使うグループです。同じ中身に複数の名前があるものが目立ちます。
/usage には別名が2つあります。/cost と /stats は、どちらも /usage を開くだけです。古い記事で /cost を見かけても、/usage で同じ画面に着きます。
使えなくなったコマンドと、残りのバンドルスキル
一覧表には、すでに削除されたコマンドが「Removed」と書かれたまま残っています。/vim は v2.1.92 で消え、今は /config の Editor mode で切り替えます。/pr-comments は v2.1.91 で消えました。
古い記事のコマンドは、今はないことがある/vim と /pr-comments は v2.1.9x 系で削除され、/ultraplan も表上は削除済みです(代わりは plan mode)。古い記事を見て打つと Unknown command で止まります。迷ったら /help か公式の一覧表で、今の版に残っているかを確かめるのが早いです。
公式の表でスキルの印が付いているのは20個です。うち7個(/batch・/code-review・/debug・/doctor・/loop・/simplify・/verify)は上の表に入れたので、残りの13個を並べます。
毎日使うものではないので、必要になった日に /help で探せば足ります。
自作コマンドの作り方|commandsとSkillsの関係
自作コマンドは、今は Skills の1機能として作ります。呼び出しは /名前 のまま、置き場所は .claude/skills/<名前>/SKILL.md です。
この節では、統合の経緯と置き場所の表、動く最小の例、引数の置き換え、frontmatter、シェル出力の差し込み、同名のときの優先順位を順に書きます。例はすべて、手元の Claude Code v2.1.310 で実行した結果です。
commandsがSkillsに統合された経緯と、今の置き場所
カスタムコマンドは、スキルに統合されました。既存の .claude/commands/ のファイルは、そのまま動きます。Claude が自分で呼び出せるようにもなりました(Skills のドキュメントに統合の説明があります)。
新しく作るなら、スキルが勧められています。理由は、スキルならスクリプトやテンプレートといった補助ファイルを同じフォルダに置けるからです。.claude/commands/deploy.md を .claude/skills/deploy/SKILL.md に移しても、フォルダ名がコマンド名になるので、/deploy の呼び方は変わりません。
スキル全般(Claude.ai での使い方や API 経由の組み込み)は、Claude Skillsの解説記事に書いています。この記事では、スラッシュコマンドとして呼ぶ側に絞ります。
最小の自作コマンドを作って呼ぶ
最初の1本は、名前と一言を受け取って挨拶を返す /greet にします。作業は3つです。
step
1フォルダを作る
プロジェクト直下に .claude/skills/greet/ を作ります。フォルダ名がそのままコマンド名になります。
step
2SKILL.md を書く
greet フォルダの中に SKILL.md を置きます。上の --- で囲んだ部分が frontmatter、下が Claude に渡る本文です。
---
description: 引数で受け取った名前に、あいさつの一文を返す
disable-model-invocation: true
argument-hint: "[名前] [ひとこと]"
---
$0 さんに、次のひとことを添えたあいさつを1文で返してください。
ひとこと: $1
受け取った引数の全体: $ARGUMENTS
step
3/greet で呼ぶ
端末から -p で動かすと、次の結果になりました。$0 が トム、$1 が おつかれさま です に置き換わってから Claude に渡っています。
claude -p --model haiku --add-dir ./demo -- "/greet トム 'おつかれさま です'"
トムさん、おつかれさまです。
--add-dir の後ろに -- を置く--add-dir は複数のパスを受け取る引数なので、そのままではプロンプトまで食べてしまい、Input must be provided と怒られます。-- で区切ると解決します。
セッションを開いたまま SKILL.md を足した場合は、/reload-skills を打てば再起動なしで拾われます。普段の対話では、/ に続けて greet と打てば候補に出ます。
引数の渡し方|$ARGUMENTS・$0・$1
引数の置き換えには4つの書き方があります。$ARGUMENTS は全部、$0 $1 は位置、名前付きの $name は frontmatter の arguments に宣言して使います。
どれも本文に書くだけで、呼び出し時に置き換わります。本文に引数の置き場所を1つも書かなかったときは、末尾に ARGUMENTS: <値> として自動で足されます。
位置引数はシェルと同じクォートの規則で分かれます。空白を含む値は、引用符で囲めば1つの引数になります。実際に確かめた結果が次です。
名前=$0
ひとこと=$1
全体=$ARGUMENTS
名前=トム
ひとこと=おつかれさま です
全体=トム 'おつかれさま です' 3つ目
/show トム 'おつかれさま です' 3つ目 と打ったとき、'おつかれさま です' は $1 に1つの値として入りました。$ARGUMENTS は入力したままの文字列です。
位置ではなく名前で受けたいときは、frontmatter の arguments に名前を宣言します。次のスキルを /named 東京 大阪 で呼ぶと、$from が 東京、$to が 大阪 に置き換わりました。
---
description: 名前付き引数の置き換えを確かめる
disable-model-invocation: true
arguments: [from, to]
---
出発=$from
到着=$to
出発=東京
到着=大阪
リストはカンマで区切る
最初に arguments: [from to] と書いたら、置き換えは起きず、$from が文字のまま出ました。YAML では、カンマのない [from to] が「from to という1つの名前」になるためです。空白区切りで書くなら arguments: from to、リストなら [from, to] にします。
ドル記号の後ろに数字が続く文章($1.00 のような金額)を本文に書きたいときは、\$1.00 と逆スラッシュで逃がします。
frontmatter の主な項目
frontmatter は、SKILL.md の先頭を --- で囲んだ部分です。全項目が省略可ですが、description だけは書いておくと、Claude がいつ使うかを判断できるようになります。
呼び出しの権限は、2つの項目の組み合わせで決まります。
/deploy や /commit のように、実行のタイミングを自分で握りたい作業は disable-model-invocation: true が向きます。作業の背景知識だけを持たせたいなら user-invocable: false です。
シェルの出力を本文に差し込む方法
本文に ! とバッククォートで囲んだコマンドを書くと、Claude に渡る前にシェルで実行され、出力が差し込まれます。Claude は、コマンドそのものではなく結果を受け取ります。
$0 の置き換えは、このコマンドの中でも効きます。ファイルの行数を数える /lines を作って、実際に動かしました。
---
description: 指定したファイルの行数を数えて、長さを一言で評価する
argument-hint: "[ファイルのパス]"
disable-model-invocation: true
---
## 行数
!`wc -l $0`
## 指示
上の結果を見て、そのファイルが長いか短いかを1文で答えてください。余計な説明は付けません。
594行ある自作コマンドのファイルを渡すと、こう返ってきました。
長い(594行)です。
複数行にするときは、```! で始まるコードフェンスで書けます。コマンドが失敗すると、スキルの呼び出しごと中断します。失敗しても進めたいコマンドは、末尾に || true を付けます。
最初に 差し込み=!`echo shell-output-ok` と書いたら、シェルは動かず、文字のまま Claude に渡りました。= の直後は対象外です。差し込み= !`echo shell-output-ok` のように空白を1つ入れると動き、shell-output-ok に置き換わりました。行頭に置くのが無難です。
引数が Claude に届くまでの流れは次の図のとおりです。置き換えは Claude に渡る前に済んでいます。
flowchart TD
A["入力<br>/greet トム 'おつかれさま です'"] --> B["Claude Codeが置き換え<br>$0=トム / $1=おつかれさま です"]
B --> C["行頭の ! 行はシェルで実行<br>出力を本文へ差し込む"]
C --> D["完成した本文をClaudeに渡す"]
D --> E["Claudeが実行して返答"]
同名のものがあるときの優先順位
同じ名前が複数の場所にあるとき、どれが動くかには決まりがあります。自作が組み込みを上書きできる点だけ、先に知っておくと混乱しません。
自分の ~/.claude/skills/deploy/ とプロジェクトの deploy があれば、/deploy は個人のほうが動きます。チームで共有したい名前は、個人側と重ならないようにするのが安全です。
自作を一時的に全部止めて調べたいときは、起動オプションを使います。claude --disable-slash-commands はすべてのスキルとコマンドを無効にします。claude --safe-mode は、CLAUDE.md・hooks・MCP・自作コマンドなどをまとめて無効にして起動します。
私の自作コマンド14本とスキル18本の中身
この節は、このリポジトリで実際に数えた値と中身です。.claude/commands/ には21ファイルがあり、18フォルダが .claude/skills/ にあります。
全部が同じ役割ではありません。呼ぶファイルと共通ルールを分け、フォルダには補助ファイルを置くものと置かないものがあります。数と置き場所の内訳から順に出します。
自作の数を書こうとして、フォルダを数え直しました。.claude/commands/ は21ファイルで、先頭が _ の7つは共通ルールの置き場です。呼び出して使うのは残りの14本。.claude/skills/ は18フォルダでした。
行数は、いちばん長いものが594行、リライト系は190〜353行です。
数と置き場所の内訳
置き場所ごとの数を表にまとめます。数は、書く前にファイルとフォルダを数えた値です。
.claude/commands/ の14本は、どれも $ARGUMENTS を本文で使っています。スキルの18本の中身は、おおまかに次の分け方です。
- ブログ記事の企画・執筆・補助(キーワード提案、書評、ポイ活アプリの紹介、絵本形式の解説、メタディスクリプション、図解): 8本
- 収益化とリライトの優先度づけ、商品リンクの挿入: 4本
- 文章の書き方の規範(緩急、技術文書の日本語): 2本
- 記事・SNSの下書き投稿: 2本
- 動画の自動編集: 1本
- スクリプトの実行方法の早見表: 1本
14本の役割
14本は、新規記事を書く、リライトする、内部リンクを足す、商品リンクを入れる、の4種類に分かれます。リライトは、1つの観点だけを直す単独版が8本、全部を順に回す版が1本、指示書に従って直す版が1本です。
14本とも、引数の形式は本文に書いています。$ARGUMENTS に入った「記事ID・キーワード・サイトの指定」を、文章で決めた形式のとおりに Claude が読み分ける作りです。$0 $1 のような位置引数は、14本のどこにも使っていません。
引数の数が固定なら、$0 $1 のほうが読み違えがなく、確実です。順番が変わったり省略されたりする引数は、文章で受け取るほうが書きやすい、というのが私の使い分けです。
実例から見る設計の型|分ける・まとめる・共通化する
14本を並べると、設計の型が3つ見えます。どれも、1本を大きくせず、役割で分ける方向です。コマンドを自作するときの参考になるので、中身を実例として挙げます。
- 提案版と自動版に分ける:内部リンクは、候補を見せて承認後に入れる版と、そのまま追記する版の2本にしている。確認したいときと、任せたいときで呼び分ける
- 単独版と一括版を持つ:リライトは、観点を1つだけ直す8本と、全観点を順に回す1本がある。一括版は、メインの会話を進行役にして各段階をサブエージェントに任せる作り
- 共通ルールを別ファイルに出す:先頭が
_のファイルに共通の手順を書き、リライト系の8本がその手順を読む。記事の書式の定義も同じ形で、新規作成やリライトから読ませている
共通ルールを _ のファイルにしたのは、同じ内容を複数のコマンドに書き写さないためです。ただし、先頭が _ のファイルも / のメニューには現れます。呼ぶものではないので、スキルにするなら references/ に置けば、メニューに出さずに済みます。
frontmatter なしで困ったこと
14本のコマンドには frontmatter が1つもありません。公式の仕様では、frontmatter がないと、description は本文の最初の空でない行になります。
私の14本は、1行目が全部「あなたは〜です」という役割指定でした。frontmatter を書かないと、この行がそのまま description になります。メニューの説明がどれも「あなたは」から始まり、見分けにくくなります。
直し方は簡単で、frontmatter に description を1行書くだけです。スキルの18本は、name と description を書いているので、この問題が起きません。
コマンドは自分で打って呼ぶもの、スキルは description の言い回しで Claude に拾わせるもの。そう考えて、スキルの description には「〜して」「〜を出して」といった依頼の言い回しも書いています。
14本は今も commands のままで、そのまま動いています。移す目安は、補助ファイルを置きたくなったとき、1本が長くなりすぎて参照資料に分けたくなったときだと考えています。
スラッシュコマンド・Skills・hooks・CLAUDE.mdの使い分け
4つとも「Claude に何かをさせる設定」ですが、動き出すきっかけが違います。迷ったら、「誰が・いつ起動するか」で選ぶと決まります。
「必ず実行したい」処理は hooks、「毎回読ませたい」前提は CLAUDE.md、「呼んだときだけ動かしたい」手順はスラッシュコマンドです。hooks はhooksの使い方、CLAUDE.md はCLAUDE.mdとrulesの解説で書いています。
全体の使い方は、先にClaude Codeの使い方まとめを読むと、全体像がつかめます。この記事は、そこで触れた / のコマンドと自作を、一覧と実装の側から掘り下げたものです。
自作コマンドが出ない・動かないときの確認ポイント
自作が呼べないときの原因は、名前・場所・書き方のどれかに収まります。上から順に確かめると早いです。
- セッション中に
SKILL.mdを足した:/reload-skillsで再走査する - フォルダ名とコマンド名が合っているか:
nameを省略するとフォルダ名が使われる /skillsに出るか: 出なければ置き場所(.claude/skills/<名前>/SKILL.md)が違う!のシェル実行が文字のままになる:!を行頭か空白の直後に置く- 引数が1つにまとまらない: 空白を含む値を引用符で囲む
- 同名の個人スキルが先に動いている: 優先順位の表を確認する
- すべて効かない:
--disable-slash-commandsや--safe-modeで起動していないか確認する - シェル実行をまるごと禁止している: 設定の
disableSkillShellExecutionがtrueになっていると、!は動かない
試すときは、まず description だけの最小のスキルで呼べるかを確かめ、そこから引数・シェル出力を1つずつ足すと、原因が切り分けやすくなります。
よくある質問
Q1. スラッシュコマンドの一覧はどこで見られますか?
A1. 起動中の Claude Code で / を打つと候補が出ます。/help でも見られます。全件は公式の Commands のページにあり、表は121行あります。プランや環境で出ないものがあるので、手元のメニューが正になります。
Q2. 自作のスラッシュコマンドはどこに置きますか?
A2. プロジェクトなら .claude/skills/ の下にコマンド名のフォルダを作り、その中に SKILL.md を置きます。全プロジェクトで使うなら ~/.claude/skills/ の下に同じ形で置きます。フォルダ名がコマンド名です。旧来の .claude/commands/ のファイルも今は動きますが、新しく作るならスキルが勧められています。
Q3. .claude/commands に置いたコマンドは使えなくなりますか?
A3. なくなりません。カスタムコマンドはスキルに統合されましたが、既存の .claude/commands/ のファイルは、そのまま動きます。同名のスキルがあるときだけ、スキルが優先されます。
Q4. 引数はどう受け取りますか?
A4. 本文に $ARGUMENTS と書けば、渡した引数の全部が入ります。位置で分けるなら $0・$1 です。空白を含む値は引用符で囲むと1つの引数になります。本文に置き場所がないときは、引数の値が末尾に ARGUMENTS: の行として足されます。
Q5. Claude が勝手に自作コマンドを実行しないようにするには?
A5. frontmatter に disable-model-invocation: true を書きます。Claude は自分では呼ばなくなり、/名前 で自分が打ったときだけ動きます。デプロイやコミットのように、実行の時機を自分で決めたい作業向けです。
Q6. /cost と /usage は何が違いますか?
A6. 同じです。/cost は /usage の別名で、/stats も別名です。セッションのコスト、プランの使用量上限、利用の統計をまとめて見られます。
Q7. 古い記事にある /vim が動きません。
A7. /vim は v2.1.92 で削除されました。今は /config を開き、Editor mode で Vim と通常の編集を切り替えます。コマンドは版で入れ替わるので、迷ったら /help か公式の一覧で現状を確かめてください。
Q8. スラッシュコマンドと Skills は何が違いますか?
A8. 作り方はほぼ同じです。/名前 で自分が呼ぶ使い方が「スラッシュコマンド」、Claude が description を見て自分で呼ぶ使い方が、Skills の本来の姿です。今は1つの仕組みで、disable-model-invocation と user-invocable で、どちらの呼び方を許すかを決めます。
Q9. 個人用とプロジェクト用のどちらに置くべきですか?
A9. 自分の癖に合わせた作業は ~/.claude/skills/、チームで共有したい手順は .claude/skills/ です。プロジェクト側はコミットすれば、同じリポジトリを使う人にも届きます。同名があると個人側が優先されるので、名前は重ならないようにします。
まとめ|まず1本、引数つきで作ってみる
組み込みは、会話の操作・設定・計画と並列・レビューの4グループで覚えると迷いません。名前が変わるものは別名の列で確かめられます。
自作は、スキルとして .claude/skills/<名前>/SKILL.md に置けば /名前 で呼べます。引数は $ARGUMENTS か $0、シェルの出力は行頭の !。この3つで、毎回同じ手順を打ち直す作業の大半は置き換えられます。
.claude/skills/名前/SKILL.md に description と本文だけ書き、/名前 で呼べるか試します。引数やシェル出力は、動いてから足せば十分です。
続きを追う:X(@Tom_Java_Tech) / RSS
途中経過は、また書きます。

