スラッシュコマンド (slash command) は、セッション内で / から始まる 1 行によって Claude Code を直接操作する、最も速い方法です。

情報

ひとことで言うと: / で始まる 1 行の入力が、モデル切り替えからコンテキスト整理、そして自作ワークフローの実行まで、セッションを指先でコントロールします。

スラッシュコマンドはセッション内部で Claude Code を制御します。モデルを切り替える、権限を管理する、コンテキストをクリアする、ワークフローを実行する — こうしたことを 1 行で処理します。入力欄に / だけを入力すると使用可能なすべてのコマンドが列挙され、/ の後に文字を続けるとフィルタリングされます。

核心のルールはただ 1 つです。コマンドはメッセージの先頭でのみ 認識されます。コマンド名の後に続くテキストは、そのコマンドへ引数 (argument) として渡されます。

コマンドは大きく 3 種類に分かれます。

スラッシュコマンドは 3 つの種類で構成されます。よく使うコマンドを整理すると次のとおりです。全一覧は入力欄で / を打てば確認でき、公式コマンドリファレンスは code.claude.com/docs/en/commands を参照します。

• 同じ機能を複数の名前で呼べる場合が多くあります (別名)。
• 一部のコマンドはプラットフォーム、プラン、環境によって表示されるかどうかが変わります。
• ultracode は現在ワークフローのトリガーキーワード (v2.1.160 より前は workflow でした) であると同時に、/effort のレベルでもあります。

自作のコマンドはマークダウンファイルで定義します。.claude/commands/deploy.md ファイルは /deploy コマンドを作り、同じ作業を .claude/skills/deploy/SKILL.md のスキルとしても作れます。2 つの方式は同じコマンドを作り、同じように動作します。既存の .claude/commands/ ファイルはそのまま動作し、同名のスキルとコマンドが衝突した場合はスキルが優先されます。

カスタムコマンドはスキルへ統合されました。新しいコマンドを作るなら、補助ファイルを同梱できるスキル形式が推奨されますが、シンプルな 1 ファイルのコマンドなら .claude/commands/ でも十分です。

マークダウンファイル冒頭の YAML frontmatter で動作を調整します。すべてのフィールドは任意ですが、モデルが自動呼び出しの判断をできるよう description だけは推奨されます。

---
description: GitHub イシューを私たちのコーディング標準に従って修正します
argument-hint: [issue-number]
disable-model-invocation: true
allowed-tools: Bash(git add *) Bash(git commit *)
---

GitHub イシュー $ARGUMENTS を私たちのコーディング標準に従って修正してください。

1. イシューの説明を読みます
2. 修正を実装します
3. テストを作成します
4. コミットを生成します

disable-model-invocation: true は、デプロイやコミットのように副作用がありタイミングを自分で制御したいワークフローに有用です。コードが準備できたように見えるという理由でモデルが勝手にデプロイしないよう防いでくれます。

コマンド名の後に入力したテキストは $ARGUMENTS の位置に置換されます。上の例で /fix-issue 123 を実行すると $ARGUMENTS が 123 に変わります。コマンド本文に $ARGUMENTS がなければ、入力した内容が本文末尾に ARGUMENTS: <入力値> の形で追記されます。

位置引数も使えます。

たとえば本文に $0 コンポーネントを $1 から $2 へマイグレーション と書き、/migrate-component SearchBar React Vue を実行すると、$0 は SearchBar、$1 は React、$2 は Vue に置換されます。空白を含む値は引用符で囲んで 1 つの引数として渡します。

本文中の !`<コマンド>` 構文は、コマンド内容がモデルへ渡される 前に シェルコマンドを実行し、その出力で位置を埋めます。モデルはコマンドではなく実際のデータを受け取ります。

## 現在の変更内容

!`git diff HEAD`

## 指示

上記の変更内容を 2〜3 個の項目で要約し、リスク要素を列挙してください。

このインライン形式は、! が行頭または空白の直後に来るときにのみ認識されます。複数行のコマンドは ```! フェンスブロックを使います。また @ファイルパス の形式でファイル内容を本文へ参照として取り込めます。

コマンドとスキルをどこに置くかが、使用範囲を決めます。

同じ名前が複数レベルにある場合、個人がプロジェクトを上書きします (組織単位の enterprise 設定があればそれが最優先)。プロジェクトスコープのコマンドの allowed-tools は、そのフォルダのワークスペース信頼 (workspace trust) ダイアログを受け入れた後に適用されます。信頼できないリポジトリのコマンドは自らに広範なツール権限を与えられるため、使用前にレビューしましょう。

サブディレクトリを置けば自然に名前空間が生まれます。またプロジェクトスキルは、開始ディレクトリからリポジトリのルートまで上位パスの .claude/skills/ をすべて探索するため、サブフォルダから Claude Code を起動してもルートのコマンドをそのまま認識します。

flowchart TD
    A["入力: /コマンド 引数"] --> B{"コマンド名の
解決"}
    B --> C["組み込みコマンド
CLI ロジックを実行"]
    B --> D["バンドルスキル
モデルがツールで調律"]
    B --> E["カスタムコマンド
.claude/commands
または .claude/skills"]
    E --> F{"スコープ優先順位"}
    F --> G["個人
~/.claude"]
    F --> H["プロジェクト
.claude"]
    F --> I["プラグイン
名前空間で分離"]

プラグイン (plugin) は、自身の skills/ ディレクトリにコマンドを収めて配布できます。プラグインスキルは プラグイン名:スキル名 の名前空間を使うため、他のレベルのコマンドと名前が衝突しません。たとえば my-plugin/skills/review/SKILL.md は /my-plugin:review で呼び出します。プラグイン自体は /plugin コマンドで管理します。

MoAI-ADK が提供する /moai とそのサブコマンド (/moai plan、/moai run、/moai sync など) は、まさにこのスラッシュコマンドの仕組みの上にスキルとして実装されています。つまり MoAI-ADK は Claude Code のカスタムコマンド標準をそのまま使い、SPEC ベースのワークフローを 1 行のコマンドとして公開しています。サブコマンドなしで自然言語で /moai "ログインバグを直して" のように依頼すると、意図分析 (Analyze-First) を経て適切なワークフローへルーティングされます — 言語に依存しない意味ベースの分類です。

/moai コマンド自体の動作とサブコマンドは別のドキュメントで扱います。

• /moai コマンド
• ワークフローコマンド
• 対話モード

• Claude Code Commands (公式ドキュメント)
• Extend Claude with skills (公式ドキュメント)

ヒント

副作用のあるコマンド (デプロイ、コミット、外部送信など) には disable-model-invocation: true を入れて、モデルが勝手に実行できないようにし、実行タイミングを自分の手に握っておきましょう。