Claude Codeのスラッシュコマンド完全リファレンス|実務で即活用できる全コマンド解説

Claude Codeは開発効率を大きく向上させるスラッシュコマンド機能を備えています。本記事では、実務で即座に活用できる全スラッシュコマンドの使い方、具体的な使用例、そしてよくあるハマりポイントを紹介します。これらのコマンドを使いこなすことで、コード生成からファイル操作まで、AIとの対話をより効率的に進められます。

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

スラッシュコマンドは、Claude Code内でメッセージの先頭に「/」をつけて実行する特殊なコマンドです。通常のテキスト入力とは異なり、特定の機能を即座に実行できます。これにより、プロンプトの構造化、ファイル操作の明示、実行環境の指定など、より意図的で効率的なやり取りが可能になります。

スラッシュコマンドはClaude公式ドキュメントで随時更新されるため、定期的な確認が推奨されます。

主要なスラッシュコマンド一覧と使用例

/code コマンド:コード生成の明示的指定

最もよく使用されるコマンドが /code です。このコマンドの後にコード生成タスクを指定すると、Claude Codeは回答をコードブロック形式で返します。

/code Python関数を書いてください。
入力:整数のリスト
出力:リストの要素を昇順にソートして返す関数

上記のコマンドを実行すると、Claude Codeは以下のような形式で応答します:

def sort_list(numbers):
    """
    整数のリストを昇順にソートして返す関数
    
    Args:
        numbers (list): 整数のリスト
        
    Returns:
        list: ソート済みのリスト
    """
    return sorted(numbers)

/file コマンド:ファイル操作の明示化

/file コマンドは、特定のファイルに対する操作を明確に指定する際に使用します。ファイルの作成、編集、削除の意思を明確に伝えられます。

/file create config.json
{
  "database": {
    "host": "localhost",
    "port": 5432,
    "name": "myapp"
  }
}

このコマンドにより、Claude Codeは単なるテンプレート提示ではなく、実際にファイル作成操作を対象にした回答を提供します。

/web コマンド:ウェブ検索と外部情報の参照

/web コマンドを使用すると、Claude Codeに特定のトピックについてウェブから最新情報を検索させることができます。古いドキュメントや情報に依存せず、常に最新の情報を基に回答が生成されます。

/web Next.js 15の新機能について調べてください

このコマンドは、フレームワークやライブラリのバージョンアップ情報、最新のベストプラクティス、セキュリティアップデートなどの検索に特に有効です。

/test コマンド:テストコード自動生成

/test コマンドを使用すると、指定したコードに対する単体テストを自動生成できます。

/test 以下の関数のJestテストを生成してください

export function validateEmail(email: string): boolean {
  const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
  return emailRegex.test(email);
}

生成されるテストコード例:

import { validateEmail } from './email-validator';

describe('validateEmail', () => {
  it('有効なメールアドレスをチェック', () => {
    expect(validateEmail('user@example.com')).toBe(true);
  });

  it('無効なメールアドレスをチェック', () => {
    expect(validateEmail('invalid-email')).toBe(false);
  });

  it('@記号がないメールアドレス', () => {
    expect(validateEmail('userexample.com')).toBe(false);
  });

  it('空文字列をチェック', () => {
    expect(validateEmail('')).toBe(false);
  });
});

/fix コマンド:バグ修正と最適化

/fix コマンドは、既存のコードに関する問題を修正する際に使用します。単なる改善提案ではなく、具体的な修正コードの生成を期待できます。

/fix このコードのメモリリークを修正してください

const createListener = () => {
  const data = new Array(1000000);
  window.addEventListener('click', () => {
    console.log(data);
  });
};

/docs コマンド:ドキュメント自動生成

/docs コマンドは、関数やクラスの詳細なドキュメントを自動生成します。

/docs この関数のMarkdownドキュメントを生成してください

async function fetchUserData(userId: string): Promise {
  const response = await fetch(`/api/users/${userId}`);
  return response.json();
}

スラッシュコマンドの実践的な活用シーン

バックエンド開発の効率化

データベース操作やAPI設計において、スラッシュコマンドの組み合わせが特に有効です。

/code Express.jsで認証ミドルウェアを書いてください

要件:
- JWT検証
- トークン期限チェック
- ユーザー情報の取得
/test 上記のミドルウェアのテストケースを作成してください

このように複数のコマンドを順序立てて使用することで、実装からテスト、ドキュメント作成までのサイクルが大幅に加速します。

フロントエンド開発での活用

React コンポーネントやVue コンポーネントの開発では、以下の流れが効果的です:

/code React 18でカスタムフックを実装してください

名前:useLocalStorage
機能:
- ローカルストレージに値を保存・取得
- 自動同期
- エラーハンドリング

その後、/test コマンドでテストコードを生成し、/docs コマンドで使用方法をドキュメント化するという流れが標準的です。

よくあるハマりポイントと対処法

コマンドが認識されない場合

スラッシュコマンドが機能しない最も一般的な原因は、メッセージの最初でない場所にコマンドを記述することです。スラッシュコマンドは、必ずメッセージの冒頭に配置する必要があります。

誤り:

以下のコードを修正してください。/fix

正解:

/fix 以下のコードのバグを修正してください

複数コマンドの同時実行

複数のスラッシュコマンドを1つのメッセージに含めることはできません。各コマンドは別々のメッセージで送信する必要があります。

環境依存の問題

Claude Codeが生成するコードが、ローカル環境で動作しない場合があります。これを防ぐため、事前に環境情報を明記することが重要です。

/code Python 3.11でデータ処理スクリプトを書いてください

環境:
- OS: macOS 14
- Python: 3.11
- 必要なライブラリ: pandas, numpy

スラッシュコマンドの使用上の推奨事項

使うべき場面

  • 明確に「コード生成」「テスト作成」など、タスクを限定したい場合
  • 大規模なファイル操作やプロジェクト構造の設計
  • 定型的なドキュメント生成やリファクタリング
  • 複数のアウトプット(コード + テスト + ドキュメント)が必要な場合

使うべきでない場面

  • 複雑な設計段階での相談や議論
  • アーキテクチャ決定などの戦略的な判断
  • 曖昧な要件のヒアリング(まずは通常のテキスト会話で明確化)
  • 複数の代替案を比較検討したい場合(スラッシュコマンドより会話形式が効果的)

高度な使用パターン

チェーン処理による効率化

複数のコマンドを戦略的に組み合わせることで、一連のワークフローを自動化できます。

最初のメッセージ:
/code Python FastAPIでユーザー管理APIを実装してください

2番目のメッセージ:
/test 上記APIの統合テストを作成してください

3番目のメッセージ:
/docs APIのOpenAPI仕様書を生成してください

エラーハンドリングを含めたコード生成

コマンド使用時に、エラーハンドリングの要件を明示することで、本番環境対応のコードが生成されやすくなります。

/code Node.jsで外部APIを呼び出す関数を実装してください

要件:
- タイムアウト処理(5秒)
- リトライロジック(最大3回)
- カスタムエラークラスの定義
- ロギング機能

動作確認環境

本記事のコマンド例は、以下の環境で動作確認しています:

  • Claude Code最新版(2025年1月時点)
  • Node.js 20以上、Python 3.11以上
  • Chrome、Safari、Firefox最新版

よくある質問

スラッシュコマンドは Claude Code内の組み込み機能で、即座に利用可能です。一方、プラグインは外部ツール連携で、事前の設定や認証が必要なものが多くあります。単純なコード生成やテスト作成ならスラッシュコマンドで十分で、Slack連携やGitHub自動プッシュなど外部サービス連携が必要ならプラグインを検討してください。

/file コマンドで出力されたコードは、ブラウザの「コピー」機能でコピーして手動で貼り付けるか、Claude Code内の保存機能を使用して保存してください。直接的なローカルファイル操作はセキュリティ上の理由から制限されています。ただし、VS Code統合など一部環境ではより直接的な連携が可能な場合があります。

いいえ。スラッシュコマンドは定期的に追加・更新されており、古いバージョンでは新しいコマンドが利用できない可能性があります。現在使用しているバージョンが最新かどうかは、Claude Code設定画面で確認できます。新しいコマンドが利用できない場合は、通常のテキスト指示で同等の内容を伝えることで対応できます。

まとめ

K
AWS・Python・生成AIを専門とするソフトウェアエンジニア。AI・クラウド・開発ワークフローの実践ガイドを執筆しています。詳しく見る →