# Claude Code | 用户指南 | Shotomatic

> 一键或用一条命令，通过 MCP 把 Claude Code 连接到 Shotomatic，确认它能正常工作，并解决常见的设置问题。

- 类型: 公开网页
- 规范页面: [https://www.shotomatic.com/zh-cn/guide/ai-agents/clients/claude-code](https://www.shotomatic.com/zh-cn/guide/ai-agents/clients/claude-code)
- Markdown 页面: [https://www.shotomatic.com/zh-cn/guide/ai-agents/clients/claude-code.md](https://www.shotomatic.com/zh-cn/guide/ai-agents/clients/claude-code.md)

浏览用户指南

本页内容

1.  [一键连接](#一键连接)
2.  [手动添加](#手动添加)
3.  [确认能正常工作](#确认能正常工作)
4.  [看不到工具时](#看不到工具时)

Claude Code 可以通过 Shotomatic 的本地 MCP 服务器，在你的 Mac 或 Windows 电脑上使用 Shotomatic。Shotomatic 已用 Claude Code 测试。

## 一键连接

1.  打开 Shotomatic，进入**设置 > AI 智能体**（`Command + ,`，Windows 上为 `Ctrl + ,`）。
2.  在**连接智能体**下，选择 **Claude** 旁边的**连接**。

Shotomatic 会以用户范围替你运行 `claude mcp add`，所以在任何项目中都能使用 Shotomatic。它还会开启**允许 AI 智能体使用 Shotomatic** 并批准 Claude Code，因此不会出现批准卡片。开始新的 Claude Code 会话即可载入服务器。

只要装有 Claude Code 或 Claude 应用，列表中就会出现 **Claude**。点一次**连接**，会把电脑上已有的那一个或两个都设置好。

## 手动添加

如果你习惯用命令行，请在**设置 > AI 智能体**中开启**允许 AI 智能体使用 Shotomatic**，安装 Node 18.3 或更高版本，然后运行：

```sh
claude mcp add --scope user shotomatic -- npx -y shotomatic mcp
```

不加 `--scope user` 时，Claude Code 只会把服务器添加到当前项目。用这种方式添加的 Claude Code 首次连接时，Shotomatic 会显示批准卡片，选择**允许**即可。请参阅[批准与确认](https://www.shotomatic.com/zh-cn/guide/ai-agents/approvals-and-confirmations)。

## 确认能正常工作

在终端中运行 `claude mcp list`，或在会话中输入 `/mcp`，查看是否有 `shotomatic`。然后这样请求：

> “检查 Shotomatic 的状态，并告诉我你能用它做什么。”

设置正确时，智能体会回复 Shotomatic 版本、Mac 上是否已授予**屏幕录制**和**辅助功能**权限、你的版本以及今天还能使用的免费截图数、网页浏览器是否已安装，以及正在运行的截图任务。

## 看不到工具时

-   **`/mcp` 中没有 `shotomatic`。** 开始新的会话。如果添加时没有加 `--scope user`，请在同一个项目文件夹中打开 Claude Code。
-   **连接时出现与 claude 命令有关的错误。** 在终端中打开一次 Claude Code，让它的命令完成安装，然后再选择**连接**。
-   **“MCP access is turned off.”** 在**设置 > AI 智能体**中开启**允许 AI 智能体使用 Shotomatic**，然后开始新的会话。
-   **智能体在等待批准。** 打开 Shotomatic，在卡片上选择**允许**。
-   **找不到 `npx`。** 只适用于手动添加的情况。请参阅[所有客户端的问题排查列表](https://www.shotomatic.com/zh-cn/guide/ai-agents/other-agents#%E9%97%AE%E9%A2%98%E6%8E%92%E6%9F%A5)。

接下来可以试试[智能体能做什么](https://www.shotomatic.com/zh-cn/guide/ai-agents/what-agents-can-do)中的请求，或在[工具参考](https://www.shotomatic.com/zh-cn/guide/ai-agents/tools)中查看所有工具。

## 本页内容

1.  [一键连接](#一键连接)
2.  [手动添加](#手动添加)
3.  [确认能正常工作](#确认能正常工作)
4.  [看不到工具时](#看不到工具时)

## 关于此版本

此 Markdown 页面根据 Shotomatic 服务端渲染的公开页面生成，不包含交互控件和网站导航。引用或分享时，请使用规范页面。
