settings.json

fileSuggestion

型object記述場所どの設定ファイルでも可

@ ファイル補完用のカスタムスクリプトを設定します。

含まれる設定2件

  • commandstringファイル提案のために実行するシェルコマンドを指定します。
  • typestringファイル提案ハンドラーの型を指定します。

記述例

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

使い方・用途

  • 大規模なモノレポ向けに、組み込みのファイル検索ではなくプロジェクト固有のインデックス（例: 事前構築されたファイルインデックス）を使用する
  • fileSuggestion を command 型で設定し、独自のスクリプト（~/.claude/file-suggestion.sh など）を実行してパスを提供する
英語原文(公式ドキュメントより)

Configure a custom script for @ file autocomplete. See https://code.claude.com/docs/en/settings#file-suggestion-settings

関連ドキュメント

関連する変更履歴

v2.1.275(1件)

Fixed
カスタムfileSuggestionコマンドの使用時や@./・@./の入力時に、@-メンションのファイル候補がMCPリソースの下に埋もれてしまう問題を修正した。
英語原文を表示
Fixed @-mention file suggestions being buried below MCP resources when using a custom fileSuggestion command or typing @./@./

変更前

カスタムfileSuggestionコマンドを設定するか、@./と入力してファイル補完候補を表示すると、ファイルの候補がMCPリソースの下に埋もれず、候補リストの見やすい位置に表示される。

変更後

カスタムfileSuggestionコマンドを設定するか、@./と入力してファイル補完候補を表示すると、接続したMCPサーバーのリソースが補完候補に含まれる関係で、ファイルの候補はMCPリソースより下に埋もれて表示されていた。

ユーザーへの恩恵

@でファイルパスを参照する際に、目的のファイルの補完候補をすばやく選択できる。

関連ドキュメント

v2.1.51(1件)

Fixed
Hooks
ステータスラインと fileSuggestion のフックコマンドが、インタラクティブモードでワークスペースの信頼承認なしに実行できてしまうセキュリティ問題を修正しました。
英語原文を表示
Fixed a security issue where statusLine and fileSuggestion hook commands could execute without workspace trust acceptance in interactive mode.

変更前

ワークスペースの信頼が承認されていない状態でも、statusLine や fileSuggestion のフックコマンドが意図せず実行される可能性があり、セキュリティリスクがありました。

変更後

ワークスペースの信頼が承認されていない場合、これらのフックコマンドは実行されなくなりました。

ユーザーへの恩恵

意図しないコマンド実行を防ぎ、ローカル開発環境のセキュリティを強化します。

関連ドキュメント

v2.0.65(1件)

Added
Added fileSuggestion setting for custom @ file search commands

関連ドキュメント