ファイル提案の設定

このスキルは、ripgrep、jq、fzf を使用した高速ファジー ファイルマッチングで Claude Code のファイル提案機能を構成するのに役立ちます。

前提条件

セットアップの前に、以下のツールをインストールしてください:

# Ubuntu/Debian
sudo apt install ripgrep jq fzf

# macOS
brew install ripgrep jq fzf

# Arch Linux
sudo pacman -S ripgrep jq fzf

セットアップ手順

1. スクリプトを作成する

ファイル提案スクリプトを ~/.claude/file-suggestion.sh に作成します:

#!/bin/bash
# Custom file suggestion script for Claude Code
# Uses rg + fzf for fuzzy matching and symlink support

# Parse JSON input to get query
QUERY=$(jq -r '.query // ""')

# Use project dir from env, fallback to pwd
PROJECT_DIR="${CLAUDE_PROJECT_DIR:-.}"

# cd into project dir so rg outputs relative paths
cd "$PROJECT_DIR" || exit 1

{
  # Main search - respects .gitignore, includes hidden files, follows symlinks
  rg --files --follow --hidden . 2>/dev/null

  # Additional paths - include even if gitignored (uncomment and customize)
  # [ -e .notes ] && rg --files --follow --hidden --no-ignore-vcs .notes 2>/dev/null
} | sort -u | fzf --filter "$QUERY" | head -15

2. 実行可能にする

chmod +x ~/.claude/file-suggestion.sh

3. Claude Code を構成する

~/.claude/settings.json に以下を追加します:

{
  "fileSuggestion": {
    "type": "command",
    "command": "~/.claude/file-suggestion.sh"
  }
}

仕組み

スクリプトは以下の処理を行います:

1. JSON 入力を受け取ります - Claude Code から query フィールドを含むデータを受け取ります
2. ripgrep を使用します - rg --files でファイルを高速にリストアップし、.gitignore を尊重します
3. シンボリックリンクをフォローします - --follow フラグを使用します
4. 隠しファイルを含めます - --hidden フラグを使用します
5. ファジーフィルタリングを実行します - fzf --filter で結果をフィルタリングします
6. 上位 15 件を返します - 関連性でソートされた結果を返します

カスタマイズ

.gitignore を無視するパスを含める

追加パスセクションのコメントを外してカスタマイズします:

# .notes ディレクトリを .gitignore で無視していても含める
[ -e .notes ] && rg --files --follow --hidden --no-ignore-vcs .notes 2>/dev/null

# vendor ディレクトリを含める
[ -e vendor ] && rg --files --follow --hidden --no-ignore-vcs vendor 2>/dev/null

除外パターン

ripgrep グロブパターンを追加してファイルを除外します:

rg --files --follow --hidden \
   --glob '!*.min.js' \
   --glob '!*.map' \
   --glob '!node_modules' \
   . 2>/dev/null

結果の件数制限を変更する

head -15 を変更して、より多くまたはより少ない結果を返します:

# 上位 25 件のマッチを返す
... | head -25

トラブルシューティング

スクリプトが見つからない

settings.json のパスがスクリプトの場所と一致していること、および ~ または絶対パスを使用していることを確認してください。

結果が返されない

以下を確認してください:

• ripgrep がインストールされている: which rg
• fzf がインストールされている: which fzf
• jq がインストールされている: which jq
• スクリプトが実行可能である: ls -la ~/.claude/file-suggestion.sh

パフォーマンスが遅い

大規模なリポジトリの場合:

• .gitignore が node_modules、dist などを除外していることを確認してください
• 大きなディレクトリに対して明示的な --glob '!pattern' を追加してください

テンプレートスクリプト

すぐに使えるテンプレートは以下の場所にあります:

${CLAUDE_PLUGIN_ROOT}/skills/file-suggestion/scripts/file-suggestion.sh

これを ~/.claude/ ディレクトリにコピーして、必要に応じてカスタマイズしてください。