claude-code - 💡(How to fix) Fix Desktop file panel can't open markdown links with spaces or commas in path [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#54792Fetched 2026-04-30 06:35:53
View on GitHub
Comments
0
Participants
1
Timeline
3
Reactions
0
Participants
Timeline (top)
labeled ×3

Fix Action

Fix / Workaround

For users whose working directories contain human-readable filenames (notes vaults, design docs, anything with spaces or punctuation), the model can't produce clickable references — forcing a copy-paste workaround.

RAW_BUFFERClick to expand / collapse

The in-app file viewer in Claude Code desktop fails to open files when a clickable markdown link's href contains spaces or commas, regardless of encoding. Plain ASCII paths open fine.

Environment

  • Claude Code desktop app (macOS)
  • Working directory contains files with spaces and commas in filenames (Obsidian vault)

Repro

In a session whose working directory contains a file at Topics/Agentic Development Practices.md, have the model emit any of these link forms:

  1. URL-encoded: [Agentic Development Practices](Topics/Agentic%20Development%20Practices.md)
  2. CommonMark angle-bracket: [Agentic Development Practices](<Topics/Agentic Development Practices.md>)
  3. Same patterns with a comma in the filename, e.g. Side Projects/.../Non-developers can now build production software with AI tools, changing the design process.md

Click the rendered link.

Expected

File opens in the right-hand file panel, same as it does for paths without special characters.

Actual

File panel shows: "File could not be read. It may have been deleted or moved, or it lives outside the session folder."

A second rendering bug compounds it: the comma case also splits visually, with .md getting auto-linkified into a phantom http://...md URL.

What works

Plain relative paths with no special characters open correctly:

[2026-04-24](Journal/2026/04/2026-04-24.md)

Why it matters

For users whose working directories contain human-readable filenames (notes vaults, design docs, anything with spaces or punctuation), the model can't produce clickable references — forcing a copy-paste workaround.

extent analysis

TL;DR

The in-app file viewer in Claude Code desktop can be fixed by properly handling URL-encoded or CommonMark angle-bracket links with spaces or commas in the filename.

Guidance

  • Verify that the issue is indeed caused by the presence of spaces or commas in the filename by testing with different types of links.
  • Check if the Claude Code desktop app has any configuration options for handling special characters in filenames.
  • Consider using a different encoding method, such as replacing spaces with underscores or using a different character encoding scheme.
  • Test the app with a filename that contains only ASCII characters and no special characters to confirm that the issue is specific to filenames with spaces or commas.

Example

No code snippet is provided as the issue does not imply a specific code change.

Notes

The issue may be specific to the Claude Code desktop app on macOS, and the solution may not apply to other environments or platforms.

Recommendation

Apply a workaround, such as using a different encoding method or replacing spaces with underscores, as the issue seems to be related to the app's handling of special characters in filenames.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

claude-code - 💡(How to fix) Fix Desktop file panel can't open markdown links with spaces or commas in path [1 participants]