Claude Code Chat UI – for Windows (No WSL)
A Native UI for Windows That Makes Claude Code Instantly Better! 🚀
🌐 Languages: English | 简体中文 | 繁體中文
📸 Preview
🚀 Quick Start
Step 1: Environment Setup
- Install Git for Windows (includes Git Bash)
- Install Node.js (LTS version recommended, ≥ 18)
- Open PowerShell as Administrator and set environment variable:
setx SHELL "C:\Program Files\Git\bin\bash.exe"
- Restart your computer (required for changes to take effect)
Step 2: Install Claude Code CLI
After restarting, open a new terminal window:
npm install -g @anthropic-ai/claude-code
⚠️ VPN Users: Please ensure TUN mode is enabled throughout the installation and usage process, otherwise you may not be able to connect to Claude services.
Step 3: Log in to Claude Code
Using Official Account
claude
A browser window will open for authorization. Log in and copy the token back to the terminal.
Using 🔑 Third-Party API
If you're using a third-party API, configure it in the extension:
- Press
Ctrl+Shift+C to open the chat interface
- Click the settings button ⚙️ in the top right corner
- Check "Use Custom API Endpoint"
- Enter your API key in the API Key field (e.g.,
sk-ant-xxxxxxxxxx)
- Enter the API address in the Base URL field (e.g.,
https://v3.codesome.cn)
- Settings are saved automatically. "Settings updated successfully" confirms the configuration
Switch back to official account: Uncheck "Use Custom API Endpoint".
💡 Tips:
- If the API key is incorrect, chat will show "processing" until timeout
- You can switch between official account and third-party API anytime via the toggle
💡 This extension supports various third-party API services (e.g., v3.codesome.cn, openrouter.ai). Please consult your API provider for the specific URL.
Step 4: Install the Extension
✨ Method 1: VS Code Marketplace (Recommended)
- Open VS Code or Cursor
- Press
Ctrl+Shift+X to open Extensions
- Search for
Claude-Code ChatUI or lkbaba
- Click Install
Direct Link: ➡️ VS Code Marketplace
📦 Method 2: GitHub Release Download
- 🔗 Go to Releases page
- Download the
.vsix file
- In VS Code, press
Ctrl+Shift+P, select "Extensions: Install from VSIX..."
🛠️ Method 3: Build from Source
git clone https://github.com/LKbaba/Claude-code-ChatInWindows.git
cd Claude-code-ChatInWindows
npm install
npm run package
# The generated .vsix file is in the project root, install using Method 2
Step 5: Start Using
- Open Chat Interface: Press
Ctrl+Shift+C
- File Explorer Icon: Click the icon next to the new folder button
❓ FAQ
Q: Getting "No suitable shell found" error?
- Make sure Git for Windows is installed
- Run as administrator:
setx SHELL "C:\Program Files\Git\bin\bash.exe"
- Restart your computer (required for changes to take effect)
If the problem persists, try:
- Open system environment variables (Win + X → System → Advanced system settings → Environment Variables)
- Ensure PATH contains
C:\Program Files\Git\cmd
- Restart your computer
Q: Third-party API configured but chat not responding?
Claude Code CLI sometimes needs to be initialized in the command line first. Run in PowerShell:
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass -Force
$Env:ANTHROPIC_API_KEY = "sk-xxxxxxxxxxxxxxxxxxxxxxxx"
$Env:ANTHROPIC_BASE_URL = "https://v3.codesome.cn"
claude
If the problem persists, try updating Claude Code CLI:
npm install -g @anthropic-ai/claude-code@latest
Q: Third-party API stops working after computer restart?
Environment variables $Env:ANTHROPIC_API_KEY and $Env:ANTHROPIC_BASE_URL are temporary and will be lost after restart.
Two solutions:
Option 1: Reset after each restart
$Env:ANTHROPIC_API_KEY = "your API Key"
$Env:ANTHROPIC_BASE_URL = "https://v3.codesome.cn"
claude
Option 2: Set as permanent environment variables (run as administrator)
setx ANTHROPIC_API_KEY "your API Key"
setx ANTHROPIC_BASE_URL "https://v3.codesome.cn"
# Restart computer for changes to take effect
Q: Getting "rg: command not found" error?
This is optional and doesn't affect normal usage. If you want to install ripgrep for better search performance:
# In Git Bash:
curl -L https://github.com/BurntSushi/ripgrep/releases/download/14.1.0/ripgrep-14.1.0-x86_64-pc-windows-msvc.zip -o ripgrep.zip
unzip ripgrep.zip && mkdir -p ~/bin
cp ripgrep-14.1.0-x86_64-pc-windows-msvc/rg.exe ~/bin/
echo 'alias rg="~/bin/rg"' >> ~/.bashrc && source ~/.bashrc
Note: The extension's built-in Grep tool works fine without ripgrep.
Q: Getting "File has been unexpectedly modified" error when Claude edits files?
This error occurs when VS Code/Cursor's auto-save feature modifies files between Claude's Read and Edit operations.
Solution: Disable auto-save
Add this to your VS Code/Cursor settings (settings.json):
"files.autoSave": "off"
Or use a less aggressive option:
"files.autoSave": "onWindowChange"
Why this happens:
- Claude reads a file and stores its content hash
- Auto-save triggers and modifies the file on disk
- Claude tries to edit the file, but the hash no longer matches
- Claude reports "File has been unexpectedly modified"
Other settings that can cause this issue:
editor.formatOnSave: true - Formatters modify file content on savefiles.trimTrailingWhitespace: true - Removes trailing spaces on savefiles.insertFinalNewline: true - Adds newline at end of file
If you need these features, consider disabling them temporarily when using Claude Code.
🤝 How to Contribute
- Fork the project and create a feature branch
- Focus on a single new feature or improvement
- Test thoroughly on a real Windows environment
- Submit a Pull Request with clear description
Welcome all AI engineers, developers, and geeks on Windows!
📝 License
This project is licensed under the MIT License. See LICENSE for details.
🙏 Acknowledgments
- andrepimenta – Original project claude-code-chat
- Mrasxieyang (linux.do community) – Provided the core solution for native Windows installation
- Anthropic – For creating the powerful Claude and Claude Code
- All developers contributing to the Claude Code ecosystem ❤️
