AIToday
AI Coding AssistantsZenn AI/MLPublished: Nov 1, 2026, 19:01 JST

Claude Code on Windows: pick native or WSL 2 by where your project lives

Send on LINE
Claude Code on Windows: pick native or WSL 2 by where your project lives

3 Key Points

  1. What happened

    Anthropic's official setup guide for Claude Code on Windows, current as of October 2026, sets out three environments: native Windows (no sandbox, optional Git for Windows), WSL 2 (sandbox supported), and WSL 1 (a fallback with no sandbox).

  2. Why it matters

    The guide's first rule is sandbox or no sandbox, which points developers to WSL 2; if no sandbox is needed, it says to match the install to where the project files already sit.

Not sure about something? Ask the AI

Questions and answers are published on this page.

Summaries like this, every morning.

Context & Analysis

The guide's logic rests on a single trade-off. Sandboxed command execution is available only in WSL 2, so any developer who wants commands to run inside a sandbox is steered there regardless of where files sit. When that requirement is absent, the deciding factor becomes file location, and the troubleshooting notes explain why: touching files on the Windows filesystem from WSL slows disk reads, which can quietly reduce how many results Claude Code's search returns. The guide lists three fixes—move the project to the Linux home directory and launch claude there, narrow the search to specific folders or file types, or run natively on Windows when the working folder is on the Windows side. From these it derives an order of checks: first where the project lives, then whether a sandbox is needed. The install steps follow the same split—the shell command inside WSL, and a single PowerShell line for native Windows.

FAQ
How do I install Claude Code on WSL 2?
Run the install command inside the WSL terminal, not in PowerShell or CMD: curl -fsSL https://claude.ai/install.sh | bash.
What does the guide say about sandbox support?
Only WSL 2 supports the sandbox; native Windows and WSL 1 do not.
What happens if I keep my project on the Windows side and run WSL 2?
The guide's troubleshooting notes that reading files under /mnt/c/ slows disk reads, and Claude Code's search can find fewer results than expected, even while claude doctor shows search as OK.
Send on LINE

AI news that matters for your work, delivered every morning.

Pick your industry and the AI tools you use, and get news related to your work every day.

Free · 30 seconds with Google · unsubscribe anytimeWhat is AIToday? →

Ask AI

Ask AI anything about this article. The AI reads this article, earlier AIToday articles, and Wikipedia, and cites its sources. Q&As are published on this page for other readers too.

Questions and answers are published on this page.

Related Articles

Next articleTANGLE's Naviu AR tourist app launches Nov 1, 2026, in 29 languages