Claude Codeのスラッシュコマンドに関する完全ガイド

Kenneth Pangan
Written by

Kenneth Pangan

Last edited 2025 9月 16

正直に言うと、開発者の一日はループに陥っているように感じることが多いです。同じgitコマンドを実行し、同じコンポーネントをスキャフォールディングし、同じリンティングエラーを何度も確認しています。AIコーディングアシスタントは確かに助けになっていますが、長い指示を何度も入力することがよくあります。もし、これらの複数ステップのワークフローをパッケージ化して、シンプルなコマンド一つで実行できたらどうでしょうか?

それがまさにClaude Codeのスラッシュコマンドの背後にあるアイデアです。これらはAnthropicのエージェンティックコーディングのためのコマンドラインインターフェースの重要な部分であり、日々の生産性に大きな違いをもたらします。最も一般的な開発タスクのためのカスタム呪文のようなものだと考えてください。

このガイドでは、Claude Codeのスラッシュコマンドについて知っておくべきすべてのことを説明します。スラッシュコマンドとは何か、ゼロから自分のカスタムコマンドを作成する方法、そして今日から使い始められる実用的な例を見ていきます。また、その限界についても触れ、コマンドラインツールから完全な自動化プラットフォームに移行する時期を見極めます。

Claude Codeのスラッシュコマンドとは?

Claude Codeでは、スラッシュコマンドは基本的にショートカットで、チャットに/で始まる特定の事前定義されたタスクを実行するために入力します。毎回コードのセキュリティフローをチェックしたり、新しいコンポーネントを作成したりするために長いプロンプトを書く代わりに、すべてを一度に処理するコマンドを作成できます。

これらの主な目的は、次のようにあなたの生活を楽にすることです:

  • 一般的なタスクを自動化する: 新しいプルリクエストを作成するための5ステップのプロセスがありますか?それを一行の/create-prコマンドに変えることができます。

  • プロセスを一貫させる: プロジェクト固有のコマンドを作成することで、チーム全員がデプロイメント、テスト、コードレビューのために同じ手順を確実に守ることができます。

  • トークンを節約する: 複雑な指示はコンテキストウィンドウのスペースを多く消費します。外部コマンドファイルに保存することでトークンを節約し、Claudeとのメインチャットをクリーンで集中した状態に保ちます。

これらのコマンドは、ビルトインとカスタムの2つの主要なフレーバーがあります。ビルトインのものは、セッションを管理するためにClaude Codeに付属している標準ツールです。カスタムコマンドは、本当に楽しい部分であり、自分の自動化を構築することができます。

機能ビルトインコマンドカスタムコマンド
目的Claude Codeセッションと設定を管理します。プロジェクト固有または個人的なワークフローを自動化します。
作成Claude Codeにデフォルトで含まれています。ユーザーがMarkdown(.md)ファイルとして作成します。
/clear, /help, /permissions/deploy, /run-tests, /new-component
カスタマイズカスタマイズ不可。プロンプトとロジックを完全にカスタマイズ可能。

カスタムスラッシュコマンドの構成要素

自分のスラッシュコマンドを作成することは、思ったほど難しくありません。基本的にはシンプルなMarkdownファイルを作成し、正しいフォルダに配置することに尽きます。役立つ動的な自動化を構築するために使用する主要な部分を分解してみましょう。

プロジェクト対個人のコマンドスコープ

まず最初に、コマンドがどこに存在するかを決定する必要があります。これにより、誰がどのコンテキストで使用できるかが決まります。

  • プロジェクトコマンド: これらはプロジェクトのリポジトリ内の.claude/commands/ディレクトリに保存します。これの素晴らしい点は、バージョン管理にチェックインされるため、リポジトリをクローンする人は誰でも同じ標準コマンドセットを取得できることです。統合テストの実行やステージング環境へのデプロイなど、チーム全体のワークフローに最適です。

  • 個人コマンド: これらはホームディレクトリの中央~/.claude/commands/フォルダに存在します。これらは個人的な生産性のショートカットであり、作業している任意のプロジェクトで利用可能です。たとえば、個人的なチェックリストを反映した/security-reviewコマンドを持っていて、どのプロジェクトでもファイルをコピーせずに使用できます。

引数を使ってスラッシュコマンドを動的にする

毎回同じことをするコマンドは便利ですが、異なる入力に適応できるコマンドは本当の力を持っています。Claude Codeでは、引数を使用してコマンドに情報を渡すことができます。

最も一般的な方法は、$ARGUMENTSプレースホルダーを使用することです。この特別な変数は、コマンド自体の後に入力したすべてのテキストを取得します。たとえば、/fix-issue.mdのコマンドファイルを作成し、プロンプトに「GitHubの問題#$ARGUMENTSに記載されたバグをレビューして修正してください。」と記載することができます。

ターミナルで/fix-issue 123を実行すると、Claudeは$ARGUMENTSを「123」に置き換え、AIに必要な具体的なコンテキストを提供します。また、$1$2などの位置引数を使用して、複数の異なる情報を渡す必要があるより構造化されたコマンドを作成することもできます。

フロントマターによる高度な制御

さらに細かい制御を行うために、コマンドのMarkdownファイルの最上部にYAMLブロック、いわゆる「フロントマター」を追加することができます。これにより、コマンドの動作に関するメタデータを設定できます。

最も役立つフロントマターフィールドのいくつかは次のとおりです:

  • description: コマンドが何をするかの簡単でシンプルな説明。/helpを実行したときに表示され、利用可能なものを思い出しやすくします。

  • argument-hint: コマンドがどのような引数を期待しているかについてのヒントをユーザーに提供します(例:[issue-number] [priority])。

  • model: 特定のモデルでコマンドを実行するように強制するために使用できます。例えば、claude-3-5-sonnet-20240620のように、特定のモデルの強みが必要なタスクに最適です。

スラッシュコマンドの実用例

理論は一つのことですが、実際にこれがどのように機能するかを見てみましょう。日常の作業を減らすためにスラッシュコマンドをどのように使用できるかの実際の例をいくつか紹介します。

gitとデプロイメントワークフローの効率化

バージョン管理とデプロイメントは、繰り返しのコマンドシーケンスでいっぱいです。カスタムスラッシュコマンドは、それらを単一の覚えやすいアクションにまとめることができます。

たとえば、/commitコマンドは、コミットプロセス全体を自動化できます。ステータスを手動で確認し、ファイルをステージングし、メッセージを書き、プッシュする代わりに、commit.mdファイルを作成して、Claudeにすべてを実行させることができます。おそらく、従来のコミット標準に従うこともできます。

同様に、/deploy-checkコマンドは、コードを出荷する前の最終的な品質チェックとして機能できます。リンターを実行し、完全なテストスイートを実行し、プロダクションビルドを実行して、より大きな問題になる前に最後のミスをキャッチするように設定できます。


graph TD  

A[開発者が'/commit'を入力] --> B{Claude Codeがcommit.mdを読み取る};  

B --> C[Claudeが'git status'と'git diff'を実行];  

C --> D{変更を分析};  

D --> E[すべてのファイルを'git add -A'でステージング];  

E --> F[従来のコミットメッセージを作成];  

F --> G[リモートブランチにプッシュ];  

G --> H[ワークフロー完了];  

コンテンツとプロジェクト管理の自動化

ドキュメントサイトやHugoのような静的サイトジェネレーターで構築されたブログで作業している場合、スラッシュコマンドは大量の時間を節約できます。

たとえば、新しいブログ投稿を作成する必要があるとします。/new-post "$ARGUMENTS"コマンドを作成できます。このコマンドのMarkdownファイルには、次の指示が含まれます:

  1. 今日の日付とタイトルのスラグ化バージョン($ARGUMENTS)を使用してファイル名を生成します。

  2. 新しいMarkdownファイルを正しいコンテンツフォルダに作成します。

  3. タイトル、日付、draft: trueなどの必要なフロントマターでファイルを埋めます。

また、ファイルを読み取り、Claudeのブラウジングツールを使用してすべてのハイパーリンクがまだアクティブであることを確認する/check-links "$ARGUMENTS"コマンドを作成することもできます。これにより、恥ずかしい404エラーを避けることができます。

コード品質と一貫性の強制

カスタムコマンドは、コード品質とセキュリティ基準が全体で満たされていることを確認するのにも最適です。

  • /security-review: チームの標準的なセキュリティチェックリストを保持するコマンドを作成できます。ファイルで実行すると、ClaudeにSQLインジェクション、クロスサイトスクリプティング(XSS)、または不安全な直接オブジェクト参照などの一般的な脆弱性を探すように指示します。

  • /refactor: これはコマンドになる可能性がありますが、コードベースの古い部分に現代的なコーディングパターンを適用します。Reactのクラスコンポーネントを関数コンポーネントに変換したり、古いプロミスをasync/await構文に置き換えたりして、コードをクリーンで最新の状態に保つことができます。

このビデオは、実用的な開発タスクのためにClaude Codeでシンプルなスラッシュコマンドを構築し使用する方法のライブコーディングデモを提供します。

Claude Codeのスラッシュコマンドの限界

スラッシュコマンドClaude Codeは開発者にとって非常に便利ですが、特定のオーディエンス向けの専門的なツールであることは間違いありません。ビジネス全体の自動化に必要なものを俯瞰して見ると、その限界がすぐに見えてきます。

非開発者にとっての技術的障壁

正直に言うと、スラッシュコマンドを作成するということは、コマンドラインに住んでいるということです。隠しディレクトリを見つけ、Markdownファイルを作成および編集し、引数やフロントマターのような概念を理解することに慣れている必要があります。これは開発者にとっては第二の天性ですが、カスタマーサポート、営業、ITの同僚にとっては始まりません。

チケット応答を自動化するための素晴らしいアイデアを持っているサポートエージェントは、スラッシュコマンドを簡単に作成することはできません。コードを一行も書かずに自動化を構築および管理できるユーザーフレンドリーなビジュアルインターフェースが必要です。

ビジネスワークフローの自動化の課題

ビジネス自動化の難しい部分は、スクリプトを実行することだけではなく、人々が実際に作業を行うさまざまなツールを接続することです。Claude Codeには統合のためのModel Context Protocol(MCP)というものがありますが、ヘルプデスクやCRMと通信するためのMCPサーバーを設定することは、真剣な開発者の時間を必要とする大きなプロジェクトです。

サポートチームはZendeskShopifyに簡単に接続する必要があります。ITチームはJira Service ManagementConfluenceのナレッジベースと連携する必要があります。これらの種類のワークフローには、数週間かけて設定する複雑なカスタムビルドのコネクタではなく、シンプルなワンクリック統合が必要です。

スラッシュコマンドから協力的なAIプラットフォームへの移行

これは、開発者向けのツールから、チーム全体のビジネス自動化のために設計されたプラットフォームに移行するポイントです。実際の運用効率は、会社の誰もが自分の退屈なタスクを自動化できるときに実現します。

ここで、eesel AIのような異なる種類のツールが登場します。eesel AIは、開発者だけでなく、チーム全体に強力でアクセス可能な自動化を提供するために構築されています。それは少し異なりますが、それは次のようなものです:

  • 徹底的にセルフサービス: AIエージェントを数分で接続し、視覚的なダッシュボードからツールに接続できます。営業電話も、必須のデモも、コマンドラインもありません。

  • ワンクリック統合によるパワー: FreshdeskIntercomSlackGoogle Docsなどの主要なビジネスアプリに即座に接続します。eesel AIは、カスタムパイプラインを構築する開発者を必要とせずに、すべての知識を一元化します。

  • 完全にカスタマイズ可能なワークフローエンジン: 非技術的なユーザーは、コードに触れることなくカスタム自動化のすべての力を得ることができます。シンプルなプロンプトエディタを使用して、AIのペルソナ、声のトーン、チケットのエスカレーションから注文情報の検索までのアクションを定義できます。

機能Claude Codeスラッシュコマンドeesel AIワークフロー自動化
対象ユーザー開発者、技術ユーザービジネスチーム全体(サポート、IT、オペレーション)
セットアップCLIでの.mdファイルの手動作成ビジュアル、セルフサーブダッシュボード
カスタマイズMarkdown/YAMLの編集が必要ノーコードプロンプトエディタとアクションビルダー
統合開発者主導(MCPサーバー)100以上のワンクリックビジネス統合
ユースケースコードリファクタリング、gitワークフロー、デプロイメントチケットトリアージ、返信のドラフト作成、内部Q&A

スラッシュコマンドに関するまとめ

Claude Codeのスラッシュコマンドは、開発者の生産性を向上させるための素晴らしいツールです。複雑でコード重視のタスクを自動化するための深いカスタマイズレベルを提供し、多くの時間を節約し、プロジェクト全体で一貫性を保つことができます。ターミナルで多くの時間を過ごす開発者にとって、これらは習得すべき必須ツールです。

しかし、その力は非常に専門的です。ビジネス全体の運営を本当に変えることができるAI自動化には、よりアクセスしやすく、統合され、チームワークのために構築されたものが必要です。すべてのチームメンバーに同じ自動化の力を与えるためには、彼らがすでに働いている場所で彼らに会うプラットフォームが必要です。

コマンドラインだけでなく自動化を

サポートチーム全体に、実際に自分たちで構築し管理できるAI自動化を提供する準備はできていますか?eesel AIは、既存のヘルプデスクや知識ソースに接続し、数分でフロントラインサポートを自動化します。数ヶ月ではなく、無料トライアルを今すぐ開始してください。

よくある質問

リポジトリのルートにある.claude/commands/ディレクトリにMarkdownファイルを配置して、プロジェクト固有のコマンドを作成するべきです。このフォルダをバージョン管理にチェックインすると、プロジェクトをクローンしたすべてのチームメンバーが同じ標準化されたコマンドにアクセスできます。

コマンドのMarkdownファイル内で$ARGUMENTSプレースホルダーを使用して、コマンドに続くすべてのテキストをキャプチャできます。例えば、/refactor component.jsを実行すると、プロンプト内の$ARGUMENTSの値は「component.js」になります。

はい、組み込みの/helpコマンドを使用して、利用可能な個人およびプロジェクトのコマンドをすべて一覧表示できます。このリストでカスタムコマンドをより有用にするために、MarkdownファイルのYAMLフロントマターにdescriptionフィールドを追加してください。

一般的にはできません。スラッシュコマンドは、ターミナル内でのローカル開発やコーディングワークフローの自動化を目的としています。外部のビジネスアプリケーションに接続して自動化するには、API統合用に作られた別のツールが必要です。

最大の利点は効率と一貫性です。コマンドは、一般的なタスクのための複雑な指示を再入力する手間を省き、チーム全員が同じ方法でタスクを実行することを保証します。これは、デプロイメントやコードレビューなどに最適です。

この記事を共有

Kenneth undefined

Article by

Kenneth Pangan

Writer and marketer for over ten years, Kenneth Pangan splits his time between history, politics, and art with plenty of interruptions from his dogs demanding attention.