aqua経由でripgrepをインストールしているとClaude Codeのファイルパス補完が動かない

この記事ではCalude Codeのファイルパス補完が動かなかったときのメモです。

TL;DR

• Calude Codeのファイルパス補完が動かない
• aqua を使ってripgrep(rgコマンド)をインストールしていたのが原因だった
• USE_BUILTIN_RIPGREP環境変数を設定すると動くようになる
  • ~/.claude/settings.json にenvとして書くと良さそう

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

{
  "permissions": {
    "allow": ["Read(~/.zshrc)"],
    "deny": ["Bash(curl:*)"]
  },
  "env": {
    "USE_BUILTIN_RIPGREP": 1
  }
}

環境

$ claude -v
1.0.17 (Claude Code)

$ aqua -v
aqua version 2.50.0

Claude Codeを使い始めた

Claude Maxプランを使えることになったのでClaude Code を使い始めました。

https://x.com/y_matsuwitter/status/1929826810466128044
https://tech.layerx.co.jp/entry/2025/06/05/161631

何が要因でこの性能が出ているのか私はよくわかっていないのですが、プロンプトやルールを頑張らなくてもかなり精度がよいので今週はAI系のコーディングツールとしてはClaude Codeしか使いませんでした。
個人的に感じたのは以下です。

• 定額なので「とりあえずやらせてみる」みたいな使い方ができる
• 「こんな雑な依頼の仕方では伝わらないな…（少なくても人間には）」みたいな指示でも自力で調べて対応してくれる
  • なので複数ターミナルで雑に指示を出しながら並列で作業を進めることが可能

ライブラリのバージョンアップ的な「やらなきゃいけないけど直接的な顧客価値が薄いから優先度上がらないタスク」もガシガシ潰せてよいです。
ccusageで確認するとかなりの額になっていたので、従量課金では躊躇していたトークン量と上級モデルの使用が功を奏しているのかもしれません。

https://github.com/ryoppippi/ccusage

…というのは前置き（余談）なのですが、Claude Codeを使っていて1つ困っていたのがファイルパス補完が動かないことでした。

Claude Codeのファイルパス補完が動かない

Claude Codeは@を入力するか、文字入力に続けてTABキーを入力するとファイル名を補完してくれる機能があります。

╭─────────────────────────────────────────────────────────────────────────╮
│ > Try "write a test for <filepath>"                                     │
╰-────────────────────────────────────────────────────────────────────────╯
  ! for bash mode       double tap esc to undo
  / for commands        shift + tab to auto-accept edits
  @ for file paths      ctrl + r for verbose output
  # to memorize         backslash (\) + return (⏎) for newline

この機能が私の環境では動きませんでした。
同僚に聞いても「デフォルトで動いているよ」と言われるし、他に同様の現象に悩んでいたのが周りには一人だけで、よくわからないままとりあえずIDE連携なので誤魔化していました。

aqua を使ってripgrep(rgコマンド)をインストールしていたのが原因だった

会社PC、私物PCで再現したので、自分の設定ファイルが問題だと思い、~.zshrcを一部ずつコメントアウトしながら検証したところ、ripgrepのインストール方法が原因でした。
Calude Codeはファイルパス補完にripgrepを利用しています。
私はripgrepをCLIツールのバージョン管理を行えるaquaを使ってグローバルインストールして使っていました。

https://aquaproj.github.io/

aquaに定義したripgrepをアンインストールするとファイルパス補完が正しく動くのを確認しました。

Calude CodeにUSE_BUILTIN_RIPGREP環境変数を設定する

https://docs.anthropic.com/ja/docs/claude-code/overview

ドキュメントには載っておらず、以下のissueにしか言及されていないのですが、Calude CodeにはUSE_BUILTIN_RIPGREPという環境変数が存在します。
https://github.com/anthropics/claude-code/issues/155

これを有効にすると、vendoerディレクトリ以下にビルドインされているripgrepを使うようになります。

$ ls ~/.claude/local/node_modules/@anthropic-ai/claude-code/vendor/ripgrep
arm64-darwin arm64-linux  COPYING      x64-darwin   x64-linux    x64-win32

環境変数名が"グローバル"すぎるのが気になるので、~/.calude/settings.jsonに指定して解決しました。

https://docs.anthropic.com/en/docs/claude-code/settings#settings-files

{
  "permissions": {
    "allow": ["Read(~/.zshrc)"],
    "deny": ["Bash(curl:*)"]
  },
  "env": {
    "USE_BUILTIN_RIPGREP": 1
  }
}

おわりに

やっと他のみなさんと同じようにClaude Codeでファイルパス補完もできるようになりました。
IDE連携機能を使ってCursorからファイルパスをClaude Codeに送っていたのですが、これでClaude Codeに完結しそうです。
2025年になってからGoLandからCursorに移行し、Roo Codeも使っていたのですが、これならGoLandに戻れる^[1]気がしますし、ターミナルで完結するならばNeovimまで戻っていいのでは？という気持ちになってます。

脚注

1. 有償ツールなので当然と言えば当然なのかもしれませんが、JetBrainsIDEのファイル探索系のパフォーマンスはVSCode系ツールより圧倒的に高速です