[Report] File path completion may fail unless USE_BUILTIN_RIPGREP is enabled

Environment

• Platform (select one):
• [x] Anthropic API
• [ ] AWS Bedrock
• [ ] Google Vertex AI
• [ ] Other: <!-- specify -->
• Claude CLI version: 1.0.16 (Claude Code)
• Operating System: macOS 15.5
• Terminal: iTerm2, Wezterm, Ghostty

Report

I discovered that the file path completion feature of the claude command may not work depending on how ripgrep is installed.
I am creating this issue to share a workaround for other claude users who might encounter the same problem.

This issue can be avoided by setting an environment variable. Also, it is being discussed as an issue in the repository of the installation tool.

• https://github.com/aquaproj/aqua/issues/3918

I installed the ripgrep command using aqua, which is a version management tool.

When I run the claude command in this environment, file path completion does not work.
However, if I use the ripgrep command installed via Homebrew, file completion works as expected.

Steps to Reproduce

1. Install ripgrep globally using aqua with AQUA_GLOBAL_CONFIG.

• Reference: https://aquaproj.github.io/docs/tutorial/global-config/

``bash
$ which rg
/Users/budougumi0617/.local/share/aquaproj-aqua/bin/rg
$ ls -la $(which rg)
lrwxr-xr-x@ 1 budougumi0617 staff 13 Mar 8 18:13 /Users/yoichiro.shimizu/.local/share/aquaproj-aqua/bin/rg -> ../aqua-proxy
``

1. Run the claude command.
2. Type @ to try file path completion.

Expected Behavior

File path completion works as expected.

Actual Behavior

File path completion does not work.

Additional Context

• Reference: https://github.com/anthropics/claude-code/issues/155

If I enable the USE_BUILTIN_RIPGREP environment variable in ~/.claude/settings.json, file completion works.

$ cat ~/.claude/settings.json
{
  "env": {
    "USE_BUILTIN_RIPGREP": 1
  }
}