claude-code - 💡(How to fix) Fix [BUG] Cowork on Windows does not support UNC paths or mapped network drives as workspace folders [1 comments, 2 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#54069Fetched 2026-04-28 06:40:03
View on GitHub
Comments
1
Participants
2
Timeline
5
Reactions
0
Author
Timeline (top)
labeled ×4commented ×1

Error Message

Error Messages/Logs

Root Cause

This is the most damaging failure because every Cowork skill that does real document work (PDF rasterization, openpyxl, python-docx, timeline extraction, demand-letter drafting, complaint drafting) shells out to Python through this sandbox. If the sandbox can't traverse the path, none of those skills can operate on files in the workspace folder, regardless of what the file tools manage to do.

Code Example

# Layer 1: Desktop client / mount

Sometimes the UNC path is accepted as a workspace folder, sometimes it is rejected outright with no clear reason. Behavior is inconsistent across sessions.

# Layer 2: File tools (Read / Write / Edit)

Partial and unpredictable access. Reads on individual sub-paths sometimes succeed; reads on the workspace root return:


Read on `\\<server>\<share>\<folder>` is blocked in this session — it resolves to a protected location or a path outside the connected folder.


Directory listings frequently come back empty even when the share contains many files. This produces the classic "some folders work, others don't" symptom.

# Layer 3: Sandboxed Linux shell (the backing for all document-processing skills)

This layer is a hard, categorical block. **Every shell command — including a plain `ls` — fails immediately with:**


UNC paths are not supported: \\<server>\<share>\<folder>


This is the most damaging failure because every Cowork skill that does real document work (PDF rasterization, openpyxl, python-docx, timeline extraction, demand-letter drafting, complaint drafting) shells out to Python through this sandbox. If the sandbox can't traverse the path, none of those skills can operate on files in the workspace folder, regardless of what the file tools manage to do.
RAW_BUFFERClick to expand / collapse

Preflight Checklist

  • I have searched existing issues and this hasn't been reported yet
  • This is a single bug report (please file separate reports for different bugs)
  • I am using the latest version of Claude Code

What's Wrong?

Cowork mode on Windows cannot reliably use a UNC path (\server\share...) or a mapped network drive (Z:\ from net use Z: \server\share) as a workspace folder. Selecting such a path produces inconsistent, partially-broken behavior across Cowork's three internal layers — the desktop client, the file tools (Read/Write/Edit), and the sandboxed Linux shell that backs the document-processing skills. The same paths work without issue in Claude Code (the CLI), so this is a Cowork-specific architectural gap rather than a Claude limitation. This blocks enterprise users whose primary file storage is a corporate Windows file server, including most mid-sized law firms, accounting practices, healthcare administrators, and government offices.

What Should Happen?

UNC paths and mapped network drives behave like local folders for all Cowork operations — directory listings, file reads/writes, and skill execution — matching how Claude Code handles them.

Error Messages/Logs

# Layer 1: Desktop client / mount

Sometimes the UNC path is accepted as a workspace folder, sometimes it is rejected outright with no clear reason. Behavior is inconsistent across sessions.

# Layer 2: File tools (Read / Write / Edit)

Partial and unpredictable access. Reads on individual sub-paths sometimes succeed; reads on the workspace root return:


Read on `\\<server>\<share>\<folder>` is blocked in this session — it resolves to a protected location or a path outside the connected folder.


Directory listings frequently come back empty even when the share contains many files. This produces the classic "some folders work, others don't" symptom.

# Layer 3: Sandboxed Linux shell (the backing for all document-processing skills)

This layer is a hard, categorical block. **Every shell command — including a plain `ls` — fails immediately with:**


UNC paths are not supported: \\<server>\<share>\<folder>


This is the most damaging failure because every Cowork skill that does real document work (PDF rasterization, openpyxl, python-docx, timeline extraction, demand-letter drafting, complaint drafting) shells out to Python through this sandbox. If the sandbox can't traverse the path, none of those skills can operate on files in the workspace folder, regardless of what the file tools manage to do.

Steps to Reproduce

N/A

Claude Model

None

Is this a regression?

Yes, this worked in a previous version

Last Working Version

No response

Claude Code Version

not sure

Platform

Anthropic API

Operating System

Windows

Terminal/Shell

Other

Additional Information

No response

extent analysis

TL;DR

The issue can be addressed by investigating and resolving the inconsistencies in handling UNC paths and mapped network drives across Cowork's internal layers.

Guidance

  • Investigate the desktop client's behavior when accepting or rejecting UNC paths as workspace folders to identify the root cause of the inconsistency.
  • Review the file tools' (Read/Write/Edit) implementation to understand why reads on individual sub-paths sometimes succeed while reads on the workspace root fail.
  • Examine the sandboxed Linux shell's configuration to determine why it categorically blocks UNC paths, and consider updating its configuration to support UNC paths.
  • Verify that the issue is not related to the Anthropic API or the Windows operating system by testing with a different API or operating system.

Example

No code snippet is provided as the issue does not contain sufficient technical details to create a specific example.

Notes

The issue is reported as a regression, indicating that it worked in a previous version, but the last working version is not specified. The Claude Code version is also unknown, which may be relevant to resolving the issue.

Recommendation

Apply a workaround by using a local folder as the workspace folder and copying files from the UNC path or mapped network drive to the local folder, as this is the most straightforward way to bypass the issue until a proper fix is available.

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 [BUG] Cowork on Windows does not support UNC paths or mapped network drives as workspace folders [1 comments, 2 participants]