内容
# 有效解决方案：Claude 代码 MCP 服务器 + WSL + VS 代码 IDE
> **跨平台配置，在基于 Windows 的 VS 代码 IDE 中通过 WSL 实现 Claude 代码 MCP 服务器集成**
## 问题
尽管 Anthropic 声称“Claude 代码 MCP 服务器与任何 MCP 客户端配合使用”，但没有文档显示如何在 WSL 上使用 Windows 系统配置此功能。BAM 开发团队在构建复杂的多组件 TypeScript 项目时发现了这一空白，该项目需要高级 AI 开发工具。
**已测试并可与以下工具配合使用：**
Cursor, Augment Code, Windsurf, CodeGPT, Cline, Roo Code, Refact.ai, Continue, VS Code
## 解决方案
在广泛研究和测试后，我们的团队（与 Claude Sonnet 4 合作）开发了一个有效的跨平台桥接配置。
### 先决条件
1. **WSL（版本 1 或 2）与 Ubuntu** 安装在 Windows 上
2. **Claude 代码安装在 WSL 中** (`npm install -g @anthropic-ai/claude-code`)
3. **基于 VS 代码的 IDE**，支持 MCP
4. **Claude 代码工作目录** 可通过 WSL 访问
### 通用 JSON 配置
将以下内容添加到 IDE 的 MCP 配置文件中（用实际值替换 `YOUR_DRIVE` 和 `YOUR_PROJECT_PATH`）：
```json
{
"mcpServers": {
"claude-code": {
"command": "wsl",
"args": [
"-d",
"Ubuntu",
"bash",
"-c",
"cd /mnt/YOUR_DRIVE/YOUR_PROJECT_PATH; /usr/bin/claude mcp serve"
]
}
}
}
```
**C 盘示例：**
```json
"cd /mnt/c/Users/YourName/Projects/MyProject; /usr/bin/claude mcp serve"
```
**D 盘示例：**
```json
"cd /mnt/d/Development/MyProject; /usr/bin/claude mcp serve"
```
### 关键元素
#### 1. **WSL 命令桥接**
```json
"command": "wsl"
```
使 Windows IDE 能够在 WSL 环境中执行命令。
#### 2. **正确的命令链接**
```bash
"cd /mnt/f/YOUR_PROJECT_PATH; /usr/bin/claude mcp serve"
```
**关键：** 使用分号 (`;`) 代替 (`&&`) 以实现可靠的命令执行。
#### 3. **WSL 路径格式**
- ❌ Windows: `C:\Users\Name\Project`
- ✅ WSL: `/mnt/c/Users/Name/Project`
#### 4. **完整的 Claude 路径**
```bash
/usr/bin/claude
```
使用绝对路径以避免 PATH 解析问题。
## IDE 特定设置
### Cursor
创建/编辑 `.cursor/mcp.json`：
```json
{
"mcpServers": {
"claude-code": {
"command": "wsl",
"args": ["-d", "Ubuntu", "bash", "-c", "cd /mnt/c/YOUR_PATH; /usr/bin/claude mcp serve"]
}
}
}
```
### Augment Code
使用设置面板或 `settings.json`：
```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 Code
创建 `.vscode/mcp.json`：
```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`
**Jupyter**：`NotebookRead`、`NotebookEdit`
**任务管理**：`TodoRead`、`TodoWrite`
**网络**：`WebFetch`、`WebSearch`
## 测试您的设置
1. 在保存 MCP 配置后重启您的 IDE
2. 使用提示测试：`"使用 claude-code 读取 /mnt/c/YOUR_PATH/README.md"`（用实际文件名替换）
3. 验证工具可用性：检查 IDE 的 MCP 面板/工具列表
## 故障排除
**"Claude 未识别"**
验证 Claude 代码已安装：`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 代码 MCP 服务器，VS 代码 MCP 配置，WSL MCP 设置，Windows 子系统 Linux MCP，Anthropic Claude 代码，MCP JSON 配置，跨平台 AI 开发，Claude 代码 Windows 设置，VS 代码 AI 工具，MCP 客户端配置
---
如果此解决方案对您有帮助，请给此仓库点赞。 与其他难以设置 MCP + WSL 的开发者分享。 为其他 IDE 配置或改进打开问题。
