# Claude Code 效率工具：使用 fzf 替代默认的 @ 文件搜索
2 min read
Table of Contents
Claude Code 默认的文件引用方式（使用 @ 符号）在处理简单项目时尚可，但在面对目录层级深、文件数量多的大型工程时，其层级式查找体验并不理想。
为了提升效率，我们可以参考社区的实践，利用 fzf（命令行模糊搜索神器）结合 rg（ripgrep）来接管 Claude Code 的文件建议功能，实现毫秒级的模糊搜索体验。
一、前置条件
本方案依赖以下命令行工具，请确保已安装：
- rg (ripgrep): 用于快速列出文件列表。
- fzf: 用于模糊匹配。
- jq: 用于解析 JSON 输入。
macOS 用户可以通过 Homebrew 安装：
brew install ripgrep fzf jq二、配置指南
1. 修改配置文件
在 Claude Code 的配置文件（通常位于 ~/.claude/config.json）中，添加 fileSuggestion 配置块。
{ "fileSuggestion": { "type": "command", "command": "~/.claude/scripts/file-suggestion.sh" }}2. 创建搜索脚本
创建脚本目录及文件：~/.claude/scripts/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 queryQUERY=$(jq -r '.query // ""')
# Use project dir from env, fallback to pwdPROJECT_DIR="${CLAUDE_PROJECT_DIR:-.}"
# cd into project dir so rg outputs relative pathscd "$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} | sed 's|^\./||' | sort -u | fzf --filter "$QUERY" | head -153. 赋予执行权限
mkdir -p ~/.claude/scriptschmod +x ~/.claude/scripts/file-suggestion.sh完成配置后，在 Claude Code 中输入 @ 并键入部分文件名，即可体验基于 fzf 的快速模糊匹配。
