[BUG] macOS privacy dialog shows version number instead of "Claude Code" in Files & Folders

Summary

On macOS, when Claude Code requests access to Files & Folders (Desktop, Documents, Network Volumes), the macOS privacy dialog and System Settings > Privacy & Security > Files & Folders show the version number (e.g. 2.1.186) instead of a recognizable app name like \"Claude Code\". The app also shows a generic \"?\" document icon instead of the Claude logo.

Steps to reproduce

1. Install Claude Code CLI on macOS
2. Run Claude Code and have it access files (e.g. read a file on the Desktop or in Documents)
3. macOS triggers a file access permission dialog
4. Open System Settings > Privacy & Security > Files & Folders

Expected: Entry reads \"Claude Code\" (or similar) with the Claude icon
Actual: Entry reads \"2.1.186\" (the version number) with a generic \"?\" document icon

Root cause (likely)

Claude Code installs as a versioned binary at ~/.local/share/claude/versions/<version>/claude rather than as a proper .app bundle in /Applications. macOS TCC (Transparency, Consent, and Control) resolves the display name from CFBundleDisplayName in an app's Info.plist — without a proper .app bundle, it falls back to the version string, which is confusing and alarming to users who don't recognise the entry.

Impact

Users see an unknown entry with just a version number in their privacy settings and reasonably suspect malware or a misconfigured process. This erodes trust and causes unnecessary alarm.

Environment

• macOS (Privacy & Security > Files & Folders)
• Claude Code version: 2.1.186
• Hardware: Apple M4 Max

Suggested fix

Wrap the Claude Code binary in a proper .app bundle (even a minimal one with an Info.plist containing CFBundleDisplayName, CFBundleName, and CFBundleIconFile) so macOS can resolve the display name correctly. Alternatively, use a helper shim that is a proper bundle and proxies to the versioned binary.

🤖 Filed via Claude Code on behalf of a user