把速熙浏览器连接到 Claude Code
这篇能帮你做什么
使用配置文件或 Claude Code 命令完成 Windows 连接，并通过环境列表判断是否成功。
开始之前
- 已完成连接外部 AI 工具前的准备。
- 已复制浏览器页面显示的安装路径、本机连接地址和完整连接密钥。
- 速熙浏览器保持运行，目标环境已经打开。
- 使用配置文件时，先备份原文件。
操作步骤
优先使用 JSON 配置。命令方式作为可选方法，两种方式选一种，不要重复添加同名连接。
- 配置文件方式：打开
%APPDATA%\Claude\claude_desktop_config.json。 - 保留已有内容，只把下面的
suxi-browser配置合并进去，不要覆盖原文件。 - 把三个占位内容替换为浏览器页面中的真实值。
{
"mcpServers": {
"suxi-browser": {
"command": "<速熙浏览器安装目录>\\suxi-browser-mcp.exe",
"args": [],
"env": {
"SUXI_API_KEY": "<在浏览器中生成的连接密钥>",
"SUXI_LOCAL_API_BASE": "<从浏览器中复制的本机连接地址>"
}
}
}
}
- 命令方式：也可以在 Claude Code 可用的终端中运行下面四行命令。先在浏览器产品页复制生成值，再替换连接密钥、本机连接地址和程序路径。程序路径含空格时必须保留双引号。
claude mcp add --transport stdio \
--env SUXI_API_KEY=<在浏览器中生成的连接密钥> \
--env SUXI_LOCAL_API_BASE=<从浏览器中复制的本机连接地址> \
suxi-browser -- "<速熙浏览器安装目录>\suxi-browser-mcp.exe"
- 完全退出并重新打开 Claude Code，或重新加载连接。
- 输入：“请查看速熙浏览器环境列表。”
确认是否成功
- Claude Code 能返回环境名称或编号列表。
- 返回结果中包含你在速熙浏览器中创建的环境。
- 检查过程中没有修改网站数据。
本文配置格式来自浏览器当前生成内容，但我们尚未完成 Claude Code 的首次连接实测。请以“确认是否成功”中的环境列表为准；看不到环境时，不要继续执行网页任务。
遇到问题
“命令执行后提示参数无效。”
→ 改用配置文件方式，并检查 JSON 结构。也可以核对当前 Claude Code 是否支持 claude mcp add。
“提示找不到 suxi-browser-mcp.exe。”
→ 核对程序完整路径，路径含空格时保留双引号。
“能连接，但看不到环境。”
→ 保持速熙浏览器运行，并先在浏览器中打开一个环境。