congmnguyen/claude-code-wsl2-setup

Claude Code WSL2 Setup

Fixes for the most annoying Claude Code papercuts on WSL2 + Windows Terminal.

Most of these (image paste, notifications, CapsLock→Esc, voice) bridge WSL2 to the Windows host and are WSL-specific. But the LSP, statusline, MCP, and Playwright CLI guides are plain Claude Code config — they work on any Linux or macOS too.

Turn on LSP so Claude reads code like an IDE, not grep

Out of the box Claude Code falls back to text search when it needs to find a function or trace a reference. That's why "find the auth handler" sometimes drifts into the wrong file.

LSP plugins ship with Claude Code since v2.0.74 — they wire Claude into the same language servers VSCode uses for Go-to-Definition. Once the four official plugins are installed and the binaries are on your PATH:

• "add a stripe webhook to my payments page" jumps straight to the existing payment module
• "fix the auth bug on my dashboard" follows the actual call hierarchy instead of guessing
• After every edit Claude picks up type errors immediately instead of finding them 10 prompts later

It also saves tokens, because Claude stops scrolling through files that don't match.

2-minute setup. TypeScript, Python, Go, Rust. → LSP setup guide

---

Preview

<p align="center"> <img src="assets/statusline.png" alt="Custom statusline showing project, context bar, 5h and weekly usage" width="640"><br> <em>video-site | main | [████░░░░░░] 42% | 5h:28% | W:4%</em> </p> <p align="center"> <img src="assets/notification.png" alt="Windows balloon tip notification — Claude Code Done!" width="420"><br> <em>Balloon tip fires on <code>Stop</code> and <code>PermissionRequest</code>, skipped when Windows Terminal is focused</em> </p> <p align="center"> <img src="assets/birchline-html.png" alt="Birchline HTML artifact preview — paper recap with tabs and before/after code panels" width="720"><br> <em>Birchline HTML skill — single-file document-style artifacts with tabs,