[Bug] Extension Fails with Spaces in Project Directory Path
Status Closed — not planned
Maintainer reply ✓ Yes — hackyon-anthropic
Workaround ✓ Mentioned in thread ↓
Activity 11 comments · opened Sep 30, 2025 · closed Feb 5, 2026
💡 Likely answer: A maintainer (hackyon-anthropic, collaborator)
responded on this thread — see the highlighted reply below.
Bug Report:
Bug Description
Claude Code VS Code extension hangs indefinitely ("Unravelling..." state) when the workspace directory path contains spaces. Extension works correctly only when all directory names in the path have no spaces.
Current Workaround
Opening Claude via VS Code's integrated terminal (claude command) works correctly regardless of spaces in directory path.
Expected Behavior
Extension should properly escape/quote directory paths with spaces, matching the behavior of the CLI.
Environment
- Platform: darwin (macOS)
- VS Code Extension Version: 2.0.0
- Claude Code CLI Version: 2.0.1
- Terminal: vscode
- Feedback ID: 20b18886-3527-4632-a325-0e758b93071e
Steps to Reproduce
- Open VS Code in a directory with spaces in the path (e.g.,
/Users/theo/My Projects/test) - Attempt to use Claude Code extension (Cmd+Shift+/)
- First query may work, but subsequent queries hang on "Unravelling..." indefinitely
- Extension becomes unresponsive
Error Log
[
{
"error": "AbortError: The operation was aborted.\n at unknown\n at abortChildProcess (node:child_process:859:42)\n at onAbortListener2 (node:child_process:35:24)\n at abort (unknown)\n at <anonymous> (/$bunfs/root/claude:3557:80)",
"timestamp": "2025-09-30T23:31:01.204Z"
}
]
Impact
Forces users to rely on integrated terminal instead of extension features, significantly reducing UX quality for projects with spaces in paths.
11 Comments
Found 3 possible duplicate issues:
This issue will be automatically closed as a duplicate in 3 days.
🤖 Generated with Claude Code
hey @tlcaputi - we haven't been able to repro this on our end. Is this consistently reproducible for you? If so, any chance you can share some of the logs you're seeing (which can be obtained through the bottom panel, as shown below):
!Image
Thanks!
Yes, it is consistently reproducible for me. However, I don't know where I would find the logs you're describing. The issue only comes up with the Claude Code VS Code extension -- not using Claude Code in the VS Code integrated terminal. It just hangs on any question like this:
<img width="731" height="1410" alt="Image" src="https://github.com/user-attachments/assets/1790bf73-d7dd-4c69-8837-6c138c737e35" />
hey @tlcaputi - any chance you can share the VSCode logs with us? These can be accessed in the VSCode command palette (
Cmd+Shift+P) underClaude Code: Show VSCode LogsNot OP, but I am experiencing the same issue. I have documentation related to the codebase in a folder that contains a
[space]in the path. In my case, as in #1726 , the second directory (additionaldirectory,additionalDirectories,/add-dir) is an iCloud folder.Claude DOES see the additional directory setting and attempts to load it. In the logs below, it is not clear if Claude thinks the path was loaded successfully (false positive) or if there is a silent error.
In a brief 5 minutes, what I think I see is that:
"/Users/brett/Library/Mobile"as the[space]in the path is not escaped.A. The path is not actually valid
B. There are additional (invalid?) arguments passed when loading the path (e.g., the remainder of the path after the
[space])claudeDOES show the user an error if the path specified in the settings file is invalid. This is the expected behavior for an invalid path. It is unclear why this error is not triggered when there is a [space] in the path.Happy to provide further details if needed. If you need additional Claude logs, please provide instructions as part of your request.
Reproduction
I have reproduced the bug 3 different ways.
1)
claudeapplication in the terminal<details>
<summary>
2) Claude Code for VS Code with UI </summary>
"claude-code.useTerminal": false</details>
<details>
<summary>
3) Claude Code for VS Code with terminal </summary>
"claude-code.useTerminal": true</details>
Prompt and Output Logs
<details>
Prompt in Claude
Claude UI Copy
Claude VSCode Output
</details>
Environment Notes
<details>
Claude Code for VS Code Extension Information
Contents of .claude/settings.local.json
treeshows the file</details>
False Positive
Please note: If the file is currently open in the IDE or if the prompt contains the full path, then Claude has no issue reading the file.
While successful, this should be considered a false-positive.
Claude VSCode Output - FALSE POSITIVES
<details>
<summary>File open in IDE</summary>
</details>
<details>
<summary>File referenced in prompt</summary>
</details>
🔧 Workaround: Symbolic Links for Paths with Spaces
While waiting for the official fix, here's a reliable workaround that works at the OS level:
The Problem
Claude Code fails to load directories with spaces in
additionalDirectoriesbecause the path gets truncated at the first space character.✅ Solution: Create Symbolic Links
I've created a comprehensive guide with platform-specific instructions:
📋 Complete Workaround Guide → Github Gist
The guide includes:
Tested and Verified
I've tested this workaround in a development environment and confirmed it works across all platforms.
---
_This workaround should work immediately while the development team implements a proper fix for the underlying issue._
This issue has been inactive for 30 days. If the issue is still occurring, please comment to let us know. Otherwise, this issue will be automatically closed in 30 days for housekeeping purposes.
how do you have this set up? are u using Bedrock and have a special settings/setup for your settings.json?
you can access the logs by starting the VSCode command palette and searching for/selecting
Claude Code: Show LogsThis issue has been automatically closed due to 60 days of inactivity. If you're still experiencing this issue, please open a new issue with updated information.
This issue was closed incorrectly despite recent human comments. This behavior of the bot is reported at https://github.com/anthropics/claude-code/issues/16497. Please upvote that issue, so maybe it gets noticed.
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.