Snip

Claude Code 的视觉模式。 也适用于 Cursor、Windsurf、Cline 以及任何 AI 编码 CLI。

安装 Snip，运行 snip setup，你的 AI 编码智能体就会开始渲染图表和预览，而不是用文本描述它们。架构？序列图。数据模型？ER 图。UI 组件？渲染预览。一切皆为视觉化，一切皆为自动化。

你可以审查 Claude 渲染的内容——批准它，或者直接在屏幕上进行标注。圈出错误的地方，添加箭头，写下备注。Claude 会看到你的标注并进行迭代。

工作原理

Snip 作为菜单栏/系统托盘应用程序运行，并带有一个可供任何 AI 编码智能体直接调用的 CLI：

# Claude writes a Mermaid diagram to a file, then renders it for your review
snip render --format mermaid < architecture.mmd

# Claude renders an HTML component preview
snip render --format html < preview.html

# Open any image for annotated review
snip open screenshot.png --message "Is the layout correct?"

# Search your screenshot library
snip search "login page error"

智能体会收到结构化的 JSON 返回值：{ status: "approved" | "changes_requested", edited, path, text }。你可以进行空间标注、输入文本反馈，或者直接批准。

专为 Claude Code 构建。也适用于 Cursor、Windsurf、Cline 以及任何可以运行 shell 命令的工具。为没有 shell 访问权限的智能体提供 MCP 服务器。

Related MCP server: Screenshot MCP Server

安装

macOS (Homebrew)

brew install --cask rixinhahaha/snip/snip

或者从 Releases 下载 DMG (Apple Silicon)。

Linux

从 Releases 下载：

• AppImage (便携式，适用于任何发行版) — Snip-x.y.z-x86_64.AppImage

• deb (Ubuntu/Debian) — Snip-x.y.z-amd64.deb

与 Claude Code 一起使用

snip setup

就是这样。snip setup 会自动配置 Claude Code 以使用视觉输出——包括规则、/diagram 技能和权限。下次你向 Claude 询问架构、数据模型或流程时，它会渲染图表而不是用文本描述。

在任何 Claude Code 对话中尝试 /diagram 来可视化你正在讨论的内容。

CLI 参考

所有审查命令 (render, open) 都会阻塞直到用户完成，并返回结构化的 JSON。

MCP 服务器

对于没有 shell 访问权限的智能体 (Claude Desktop, 托管环境)，Snip 也提供了一个 MCP 服务器：

{
  "mcpServers": {
    "snip": {
      "command": "node",
      "args": ["/path/to/snip/src/mcp/server.js"]
    }
  }
}

MCP 服务器公开了相同的功能：render_diagram, open_in_snip, search_screenshots, list_screenshots, get_screenshot, transcribe_screenshot, organize_screenshot, get_categories, install_extension。

同时也是一款截图工具

Snip 本身就是一个完整的截图 + 标注应用程序：

• Cmd+Shift+2 (macOS) / Ctrl+Shift+2 (Linux) — 通过区域选择或窗口捕捉进行捕获

• Cmd+Shift+1 / Ctrl+Shift+1 — 快速截图 (直接捕获到剪贴板)

• 标注 — 矩形、箭头、文本、标签、模糊画笔、AI 分割

• Esc — 复制到剪贴板并关闭

• Cmd+S — 保存到磁盘 + AI 在后台进行整理

AI 整理使用本地视觉 LLM (通过 Ollama) 来命名、分类和标记每一张保存的截图。语义搜索可以通过描述截图内容来查找任何截图。

快捷键

在 Linux 上，将 Cmd 替换为 Ctrl。

开发

npm install
npm run rebuild   # compile native modules (macOS)
npm start         # launch (tray icon appears)

需要 macOS 14+ 或 Linux (Wayland)，Node.js 18+。

文档

技术栈

Electron 33 / Fabric.js 7 / Mermaid.js 11 / Ollama (本地 LLM) / HuggingFace Transformers.js / SlimSAM (ONNX)

所有 AI 均在本地运行——核心功能无需云端 API。

赞助

Snip 是免费、开源的，由两名开发者构建。如果它对你的工作流程有帮助，请考虑赞助该项目。

赞助有助于支付：

• Apple 开发者计划 — 代码签名和公证所必需，以防止 macOS 阻止该应用程序

• CI/CD 成本 — macOS 和 Linux 的自动化构建、测试和发布流水线

• 持续开发 — 新的标注工具、更好的 AI 集成、Linux 改进和错误修复

每一份贡献都有助于保持 Snip 的维护和改进。谢谢！

许可证

MIT