settings-file-path-not-found

Referenced file path does not exist

Warning

Rule Details

This rule validates that the apiKeyHelper path in settings.json points to a file that actually exists on disk. Missing files will cause runtime errors when Claude Code tries to use them. Paths containing variable expansion syntax (e.g., ${HOME}/...) are skipped since they cannot be resolved statically.

Incorrect

Settings referencing a non-existent script

{
  "apiKeyHelper": "/scripts/get-api-key.sh"
}

Correct

Settings referencing existing files

{
  "apiKeyHelper": "./scripts/get-api-key.sh"
}

Settings using variable expansion (skipped)

{
  "apiKeyHelper": "${HOME}/.config/claude/api-key-helper.sh"
}

How To Fix

Verify that the file paths in settings.json are correct and the files exist. Check for typos in the path, ensure the file has been created, and confirm the path is relative to the correct base directory.

Options

This rule does not have any configuration options.

Related Rules

• settings-invalid-env-var
• settings-permission-empty-pattern

Resources

• Rule Implementation
• Rule Tests

Version

Available since: v0.2.0