KeyHop 是一款 macOS 应用启动工具。你可以把常用应用放进菜单栏,也可以为每个应用设置独立的全局快捷键,在其他应用中直接打开或切换过去。
应用已经运行时,KeyHop 会将它切到前台,保留当前窗口和工作内容。需要代理时,可以在设置中手动开启。
应用列表与快捷键设置。图中的 F1、F2 为手动绑定,首次使用不会预设快捷键。
KeyHop 适合需要经常在几个应用之间切换的场景,例如 Codex、终端和浏览器。添加应用后,日常操作都可以在菜单栏或通过快捷键完成。
- 从菜单栏选择「添加新应用…」,在打开的设置窗口中点击「添加」,选择应用。
- 如果需要快捷键,点击应用旁的「录制快捷键」,按下要使用的组合,例如
⌃⌥C。 - 点击菜单中的应用名,或按下对应快捷键。应用未运行时会启动,已运行时会切到前台。
快捷键可以留空,默认也不会占用 F1 等按键。录制时按 Esc 取消、Delete 清除;重复或系统报告冲突的绑定会提示调整。快捷键在 KeyHop 运行期间生效,无需辅助功能权限。
除了 macOS 应用,也可以添加命令行工具,它们会在 Terminal 中交互运行。已有的命令行实例不会重复启动,需要自行切换到对应终端。
需要 macOS 13+、Node.js 20+。
npm install -g keyhop
keyhop安装包同时支持 Apple Silicon 和 Intel Mac,安装后无需 Swift。首次运行会打开设置;关闭窗口后,KeyHop 留在菜单栏。再次运行 keyhop 会打开已有实例,不重复启动。
代理默认关闭,正常使用 KeyHop 不需要配置代理。有需要时,在设置中开启「使用代理」,填写已有代理软件的地址,例如 127.0.0.1:7897,并选择对应的 HTTP 或 SOCKS5 协议。应用的代理启动方式由 KeyHop 自动判断。
开启代理后的设置界面。关闭开关后,连接设置会收起。
开启后,KeyHop 会在启动应用前检查代理;检查失败时会提示原因,并停止本次启动。开关和地址的变更只影响之后通过 KeyHop 新启动的应用。对于已经运行的应用,点击或按快捷键仍然只是切到前台;要应用新的代理设置,需要先保存工作、退出应用,再通过 KeyHop 打开。
KeyHop 使用已有的代理服务,不修改系统代理。应用是否采用代理配置,取决于它自身的网络实现,因此代理检查通过不代表该应用的全部流量都经过代理。具体说明见 产品说明。
keyhop status # 查看当前状态
keyhop quit # 退出 KeyHop,已打开的 App 继续运行更新前先退出 KeyHop,再运行 npm install -g keyhop@latest;卸载使用 npm uninstall -g keyhop,个人配置会保留。
随包提供的 App 使用 ad hoc 签名,尚未完成 Apple 公证。配置位置、源码构建与签名说明见 开发指南,测试记录见 本地验收。

