Como Deixar a Sugestão de Arquivos do Claude Code Mais Rápida

A sugestão padrão de arquivos com @ do Claude Code sempre me decepcionou, sendo acostumado com opções superiores tipo fzf.

Além disso, não sugeria arquivos de pastas gitignored ou symlinks, o que era chato pra caramba.

Mas recentemente a Anthropic liberou a customização via File Suggestion settings.

E cara! Fuzzy matching de verdade com fzf é muito melhor do que o padrão!

# Pré-requisitos

Você vai precisar instalar essas ferramentas CLI:

• rg (ripgrep) - pra listagem rápida de arquivos com suporte a symlink
• fzf - pro fuzzy matching
• jq - pra parsear o JSON de entrada

# Setup

# 1. Configurar o Claude Code

Adiciona isso no seu ~/.claude/settings.json:

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

# 2. Criar o Script de Sugestão de Arquivos

Cria o arquivo ~/.claude/file-suggestion.sh com esse conteúdo:

#!/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

# 3. Tornar o Script Executável

Não esquece de deixar o script executável:

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

# 4. Reiniciar o Claude Code

Reinicia o Claude Code e boa!

tmj :)