[BUG] @ File Reference Feature Not Working on macOS

Status Fixed / completed
Maintainer reply None cached
Activity 12 comments · opened Jun 12, 2025 · closed Jul 3, 2025

Environment

  • Platform (select one):
  • [x] Anthropic API
  • [ ] AWS Bedrock
  • [ ] Google Vertex AI
  • [ ] Other: <!-- specify -->
  • Claude CLI version: 1.0.21 (Claude Code)
  • Operating System: macOS 15.5
  • Terminal: Terminal App (also tested in VS Code and VS Code Insiders)

## Bug Description
The @ symbol file reference feature does not work in any environment - it doesn't show the file picker/autocomplete list
when typing @ in chat messages.

## Steps to Reproduce

  1. Open Claude Code in terminal, VS Code, or VS Code Insiders
  2. Start typing a message to Claude
  3. Type the @ symbol
  4. Wait for file picker/autocomplete to appear

## Expected Behavior
After typing @, a file picker or autocomplete list should appear showing available files in the workspace/directory that
can be referenced.

## Actual Behavior
Nothing happens when typing @. No file picker, no autocomplete, no visual indication that file referencing is available.

## Additional Context

  • Tested across multiple environments: Terminal, VS Code, VS Code Insiders
  • Performed complete uninstall/reinstall of Claude Code extension
  • Manually removed all Claude Code related files from macOS
  • Issue persists across all clean installations
  • Have active workspace/folder open in VS Code when testing

View original on GitHub ↗

12 Comments

wcygan · 1 year ago

Mine works without a claude command specified, but not when a command is specified (on MacOS):

I would like to choose from files especially when using commands, but right now I can't

| good | bad |
|--------|--------|
| <img width="889" alt="Image" src="https://github.com/user-attachments/assets/44a8eaba-daff-422a-8f89-dbb9749737d1" /> | <img width="867" alt="Image" src="https://github.com/user-attachments/assets/d6258867-a2d7-41a8-a094-67256880f5a1" /> |

shanecp · 1 year ago

Can confirm this bug exists.

lukefronadaptive · 1 year ago

+1

raysubham · 1 year ago

+1 this broke recently, I'm on v11.4.2

bitomule · 1 year ago

I have been facing this issue for weeks now. At some point is just stopped working.

gabewillen · 1 year ago

+1

amirna2 · 1 year ago

Same issue on version Claude CLI 1.0.30, Ubuntu 22.04

liby · 1 year ago

As an alternative way to mitigate this issue, you can use File reference shortcuts within the file you want to cite to send the file to Claude Code.

File reference shortcuts: Use Cmd+Option+K (Mac) or Alt+Ctrl+K (Linux/Windows) to insert file references (e.g., @File#L1-99)
HarborMind-Eddie · 1 year ago

I'm having the same issue on v1.0.35 macOS 15.5.

simonfunk · 1 year ago

Looks like there was an update and now with the hint " ※ Tip: Open the Command Palette (Cmd+Shift+P) and run "Shell Command: Install 'code' command in PATH" to enable IDE integration" i was able to make it work again :)

HarborMind-Eddie · 1 year ago
Looks like there was an update and now with the hint " ※ Tip: Open the Command Palette (Cmd+Shift+P) and run "Shell Command: Install 'code' command in PATH" to enable IDE integration" i was able to make it work again :)

That didn't work for me, but I am working around it with the file reference shortcut. Hopefully they patch this soon though.

github-actions[bot] · 1 year ago

This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.