govijr/terminal-mac

这是什么？

核心功能

• 01在 Apple silicon 上运行真实的 macOS 虚拟机，应用、文件和账户相互独立。
• 02在 Kitty、Ghostty 或 iTerm2 终端中内联显示虚拟机画面。
• 03以 MCP 工具形式提供截图、点击、拖动、滚动、输入、按键和状态查询。
• 04智能体操作不会移动宿主机指针，也不会改动宿主机剪贴板。
• 05通过 curl 脚本安装，首次运行时下载 macOS 系统镜像。
• 06提供 Ctrl+G 快捷键面板，用于发送终端无法直接输入的 Mac 快捷键。

适用场景

• 让 AI 智能体操作仅限 macOS 的应用，同时不占用你自己的桌面。
• 在隔离的虚拟 Mac 中测试 macOS 图形界面软件。
• 在支持的终端中直接查看和操作本地虚拟 Mac。
• 运行需要一次性 macOS 环境的计算机使用智能体实验。

快速上手

1. 1

   使用 README 中的 curl 安装脚本安装（会校验 SHA-256）

2. 2

   运行引导式设置，下载、安装并启动虚拟 Mac

   terminal-mac up
3. 3

   通过 MCP 连接 AI 代理

   claude mcp add terminal-mac -- terminal-mac mcp

使用前须知

• !需要运行 macOS 14 或更高版本的 Apple 芯片 Mac。
• !处于早期发布候选阶段；在干净 Mac 上的实际客户机验收仍未完成。
• !发布版本为自签名，未经 Apple 公证。
• !内嵌查看器仅支持 Ghostty、Kitty 或 iTerm2。

收录于专题

标签

常见问题

terminal-mac 是什么？

面向计算机使用智能体的 macOS 虚拟机，可通过 MCP 工具操控，并在终端中查看画面。 terminal-mac 基于 Apple 的 Virtualization 框架，在 Apple silicon 上运行真实的 macOS 虚拟机。虚拟机内的辅助程序负责采集屏幕并发送键盘、鼠标事件，因此智能体可以操作这台独立的 Mac，而不会移动宿主机的指针或改动剪贴板。虚拟机拥有自己的应用、文件和账户，不会继承宿主机的登录会话。

terminal-mac 可以免费使用吗？用的什么许可证？

terminal-mac 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

terminal-mac 还在维护吗？

活跃维护中。terminal-mac 最近一次提交是在 2026年11月6日。

terminal-mac 适合用来做什么？

让 AI 智能体操作仅限 macOS 的应用，同时不占用你自己的桌面。 在隔离的虚拟 Mac 中测试 macOS 图形界面软件。 在支持的终端中直接查看和操作本地虚拟 Mac。 运行需要一次性 macOS 环境的计算机使用智能体实验。

terminal-mac 怎么安装和运行？

使用 README 中的 curl 安装脚本安装（会校验 SHA-256） 运行引导式设置，下载、安装并启动虚拟 Mac: terminal-mac up 通过 MCP 连接 AI 代理: claude mcp add terminal-mac -- terminal-mac mcp

在哪里获取 terminal-mac？

源代码和安装说明在 GitHub 上：https://github.com/govijr/terminal-mac