工作解决方案:克劳德代码MCP服务器+WSL+VS代码IDE
跨平台配置使Claude Code MCP服务器能够通过WSL跨基于Windows的VS Code IDE集成
问题
尽管Anthropic声称“Claude Code MCP服务器适用于任何MCP客户端”,但没有文档显示如何使用WSL在Windows系统上实际配置此服务器。BAM开发团队在构建需要高级AI开发工具的复杂多组件TypeScript项目时发现了这一差距。
测试并使用: 游标、增强代码、Windsurf、CodeGPT、Cline、Roo代码、Refact.ai、Continue、VS代码
解决方案
经过广泛的研究和测试,我们的团队(与Claude Sonnet 4合作)开发了一种可工作的跨平台网桥配置。
先决条件
- WSL(版本1或2)与Ubuntu 安装在Windows上
- WSL中安装了Claude Code (
npm install -g @anthropic-ai/claude-code) - VS基于代码的IDE 支持MCP
- Claude Code工作目录 可通过WSL访问
通用JSON配置
将此添加到IDE的MCP配置文件中(替换 YOUR_DRIVE 和 YOUR_PROJECT_PATH 根据您的实际值):
{
"mcpServers": {
"claude-code": {
"command": "wsl",
"args": [
"-d",
"Ubuntu",
"bash",
"-c",
"cd /mnt/YOUR_DRIVE/YOUR_PROJECT_PATH; /usr/bin/claude mcp serve"
]
}
}
}C:驱动器示例:
"cd /mnt/c/Users/YourName/Projects/MyProject; /usr/bin/claude mcp serve"D:驱动器示例:
"cd /mnt/d/Development/MyProject; /usr/bin/claude mcp serve"关键要素
1. WSL指挥桥
"command": "wsl"使Windows IDE能够在WSL环境中执行命令。
2. 正确的指挥链
"cd /mnt/f/YOUR_PROJECT_PATH; /usr/bin/claude mcp serve"严重: 使用分号(;)而不是(&&)用于可靠的命令执行。
3. WSL路径格式
- ❌ 窗户:
C:\Users\Name\Project - ✅ WSL:
/mnt/c/Users/Name/Project
4. 完整的克劳德路径
/usr/bin/claude使用绝对路径以避免path解析问题。
IDE特定设置
光标
创建/编辑 .cursor/mcp.json:
{
"mcpServers": {
"claude-code": {
"command": "wsl",
"args": ["-d", "Ubuntu", "bash", "-c", "cd /mnt/c/YOUR_PATH; /usr/bin/claude mcp serve"]
}
}
}增强代码
使用设置面板或 settings.json:
{
"augment.advanced": {
"mcpServers": [{
"name": "claude-code",
"command": "wsl",
"args": ["-d", "Ubuntu", "bash", "-c", "cd /mnt/c/YOUR_PATH; /usr/bin/claude mcp serve"]
}]
}
}VS代码
创建 .vscode/mcp.json:
{
"servers": {
"claude-code": {
"command": "wsl",
"args": ["-d", "Ubuntu", "bash", "-c", "cd /mnt/c/YOUR_PATH; /usr/bin/claude mcp serve"]
}
}
}可用的Claude代码工具
配置后,您将可以访问:
文件操作: Read, Write, Edit, MultiEdit\ 发现: LS, Glob, Grep\ 执行: Bash\ 朱庇特: NotebookRead, NotebookEdit\ 任务管理: TodoRead, TodoWrite\ 网络: WebFetch, WebSearch
测试您的设置
- 保存MCP配置后重新启动IDE
- 带提示的测试:
"Use claude-code to read /mnt/c/YOUR_PATH/README.md"(替换为实际文件名) - 验证可用工具:检查IDE的MCP面板/工具列表
故障排除
“克劳德未被认出”\ 验证是否安装了Claude Code: wsl which claude\ 使用完整路径: /usr/bin/claude 或 /home/user/.nvm/versions/node/vXX.X.X/bin/claude
“找不到路径”\ 检查WSL支架: wsl ls /mnt/c/\ 验证WSL中是否存在项目路径\ 使用绝对WSL路径(/mnt/c/...)
“连接已关闭”\ 确保分号(;)分隔命令\ 检查WSL分发名称: wsl -l -v\ 先尝试不更改目录: "/usr/bin/claude mcp serve"
关于此解决方案
此配置由BAM开发团队与Claude Sonnet 4合作开发,同时构建了基于TypeScript的高级开发工具。我们发现了这个文档差距,并解决了Windows→WSL→MCP电桥问题。
搜索关键字
Claude Code MCP服务器、VS Code MCP配置、WSL MCP设置、Windows子系统Linux MCP、拟人Claude Code、MCP JSON配置、跨平台AI开发、Claude Code Windows设置、VS Code AI工具、MCP客户端配置
______________________________________________________________________
如果此解决方案对您有所帮助,请标记此仓库。与其他在MCP+WSL设置上遇到困难的开发人员分享。其他IDE配置或改进的未决问题。
