Cursor 接入 ModelGate 教程
在 Cursor 中使用 ModelGate 接入 Claude Code，有两种常用方式：直接安装插件，或通过 WSL 连接 Ubuntu 终端。两种方式底层都使用 Claude Code，因此需要先完成 Claude Code 接入教程 中的环境变量配置。
接入前先打开 ModelGate 接入引导页 注册并创建 API Key。
方式一：直接安装插件
Section titled “方式一：直接安装插件”- 打开 Cursor，进入 扩展（Extensions） 界面。
- 在搜索框搜索 Claude Code 官方扩展并安装。
- 安装后重启 Cursor。
- 在 Cursor 中打开 Claude Code 面板，它会读取
~/.claude/settings.json中的ANTHROPIC_AUTH_TOKEN与ANTHROPIC_BASE_URL，即使用 ModelGate 网关。
安装扩展需要能访问扩展市场，网络受限时可能安装失败。
方式二：基于 WSL（推荐可视化操作）
Section titled “方式二：基于 WSL（推荐可视化操作）”使用本质：在 Cursor 中本地连接 Ubuntu 终端使用 Claude Code，可以可视化代码操作。
| 序号 | 操作 | 说明 |
|---|---|---|
| 1 | 打开 Cursor | 进入主界面 |
| 2 | 点击左下角终端图标 | 打开终端面板 |
| 3 | 在弹出选项中选择 Connect to WSL | 选择 Ubuntu 发行版，Cursor 会自动连接 |
没有 “Connect to WSL using Distro” 选项？
若打开后只有 2 个选项而不是 5 个，原因是 WSL 扩展未安装。安装扩展后重启即可：
- 进入 Cursor 扩展界面。
- 搜索 WSL，找到微软官方的 WSL 扩展（不要选错）。
- 点击安装，安装完成后重启 Cursor。
- 此时再打开终端，就会出现完整的连接选项，选择 Ubuntu 即可。
连接后的使用：
在 WSL 终端中安装 Claude Code 并配置 ModelGate 环境变量（与 Claude Code 接入教程 一致），之后就可以在 Cursor 中直接操作文件并调用 Claude Code，代码与终端双屏可视化。
- 无法连接 WSL — 确认已安装 WSL 扩展并重启 Cursor；确认 Windows 已启用 WSL 功能。
- Claude Code 在 WSL 中未生效 — 在 WSL 终端中重新设置
ANTHROPIC_AUTH_TOKEN与ANTHROPIC_BASE_URL（WSL 与 Windows 环境变量相互独立）。 - 扩展安装失败 — 网络受限导致，需要可访问扩展市场的网络环境。
- ModelGate 接入引导页 — 注册并创建 API Key
- Claude Code 接入教程 — 环境变量配置
- Claude Code 常见报错排查 — 错误解决
- 在 VS Code 中使用 Claude Code — 类似的可视化集成方式