[BUG] Claude Code Read tool fails with special characters in filenames
Resolved 💬 3 comments Opened Jun 7, 2025 by P-tite-tete Closed Jan 6, 2026
Environment:
- Platform: Claude Code (VSCode plugin)
- Model: Claude Sonnet 4 (claude-sonnet-4-20250514)
- OS: macOS Darwin 24.5.0
- Claude Code version: 1.0.16
- Date: June 7, 2025
Bug Description:
The Read tool cannot read files with special characters in their
names, particularly French characters.
Reproduction Case:
- File name:
Capture d'écran 2025-06-07 à 10.26.24.png - Full path: `/Users/[user]/Documents/project/capture/Capture
d'écran 2025-06-07 à 10.26.24.png`
- Error: "File does not exist" even though file exists and is
visible in LS tool
Problematic Characters:
- Curved apostrophe (')
- Accented characters (é, à)
- Colons (:)
- Multiple spaces and dots
Workaround:
User had to rename file to Cap1.png (ASCII-only) for Read tool
to work.
Impact:
- Forces users to rename files with non-ASCII characters
- Particularly affects French-speaking users
- Disrupts natural workflow with screenshots and localized
filenames
Expected Behavior:
Read tool should handle UTF-8 encoded filenames with special
characters properly.
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗