A small, growing collection of fixes and guides for running Claude Code smoothly inside WSL2 (with WSLg) on Windows. Each one solves a "works on native Linux/macOS, silently broken on WSL" papercut.
Maintained by Cyntax.
| Guide | What it fixes |
|---|---|
| Voice dictation on WSL | /voice finds no microphone in WSL — fixed with a PulseAudio capture backend. |
Clipboard image paste → wsl-clip-bridge |
Pasting Windows clipboard images into Claude Code does nothing. Solved by a dedicated tool (separate repo). |
The clipboard fix is large enough to be its own tool, so it lives in
CyntaxDotDev/wsl-clip-bridge(itself a maintained fork ofrajveerb/wsl-clip-bridge). This kit links to it rather than duplicating it.
WSL2 + WSLg is close to a real Linux desktop, but a few subsystems — audio capture, clipboard image formats, keybinding interception by Windows Terminal — behave just differently enough to break Claude Code features without an obvious error. This repo collects the working fixes so you don't have to rediscover each one.
- In scope: reproducible fixes for Claude Code (or general dev workflow) features that break specifically because you're on WSL.
- Out of scope: generic Claude Code usage docs (see the official docs) and Windows-native setup.
Found another WSL papercut and a fix? Open an issue or PR with: the symptom, the root cause, the exact commands that fix it, and how to verify. Keep guides short, tested, and copy-pasteable.
MIT © Cyntax. Guides reference Claude Code, which is a product of Anthropic; this is an independent community resource, not affiliated with or endorsed by Anthropic.