另一台 Mac 够不着
家里那台跑着 Claude Code,在公司想连上:公网 IP 没有,路由器端口映射不敢动,动态 DNS 隔三差五失效,VPN 一换网就掉。
给用 Claude Code · Codex · Gemini CLI 的你 · 内部版 1.3.2
两台 Mac 登录同一个账号就打通了:在公司敲 ssh kk-home,直接进家里那台的终端——不要公网 IP、不改路由器、换了 Wi-Fi 也不断。这边截图 ⌘C,图已经在那边;终端里按 ⌥⌘3,路径就打进 AI 的输入框。ssh 服务器也一样连。
7.3 MB · dmg macOS 13 起 Apple 芯片 苹果公证 主程序零第三方依赖
$ ssh kk-home kk-home · 直连 · 23 ms · 不要公网 IP > shot3: ~/kklink/shots/20261018-153012-3.png ⏺ Read(~/kklink/shots/20261018-153012-3.png) 看到了:弹窗的 z-index 比底部按钮栏低,被 .footer 盖住了……
为什么做这个
Claude Code、Codex、Gemini CLI 跑在家里的 Mac mini 或者远程服务器里。它们读不到你本机的剪贴板、看不到你的屏幕;而你,常常连那台机器都够不着。
家里那台跑着 Claude Code,在公司想连上:公网 IP 没有,路由器端口映射不敢动,动态 DNS 隔三差五失效,VPN 一换网就掉。
想让 AI「看一眼」:存桌面、起个文件名、开新标签 scp、回到 AI 窗口、把路径手敲一遍——一天几十次,还经常敲错。
换 Wi-Fi、开热点、VPN 一掉,连接就得从头配;按 IP 写的命令每到一个地方都不一样,到家还得先查今天的地址是多少。
ssh kk-home一条命令,哪里都能连怎么用
ssh kk-home。点「固定成短命令」,以后在任何终端、VS Code Remote、scp、rsync 里都直接用。
连 ssh 服务器更简单:粘个地址 → 连接。用户名它自己探测,服务器端自动装好,截图从此两头同步。
凭什么靠谱
同一 Wi-Fi 走局域网,跨网先打洞直连;打不通才经我们的中转机转发密文。中转走 TLS 443,公司网络、酒店、开着 VPN 都能过。
换 Wi-Fi、开热点、合盖再开、任何一边网络一变——自动重连,先经中转保通,再回到直连。十几到四十秒,不用你点任何东西。
被连的那台接着电源、开着「允许其他设备连接」时不会自动睡眠:深夜从公司连回家里,它还在线(合上盖子仍会断)。
每台设备一个别名 kk-home,家里公司热点都是这一条;Include 进 ssh 配置后,任何终端、任何工具都认。
被连的那台菜单栏亮一个绿点,设备页写明是谁、几条会话;每台都能一键把别的设备踢出,账号里只有你自己的 Mac。
~/kklink/shots/20261018-153012-3.png 在 Mac 和服务器上一字不差。同时连着三台,⌥⌘3 粘的路径在哪台都对。
截图同步
任何截图工具,复制即触发:压缩、编号、传到每台开着「同步」的设备和服务器,右上角闪一下。在哪个终端窗口按 ⌥⌘3,就粘哪台的路径,shot3: ~/kklink/shots/… 打进 AI 的输入框,不自动回车——想粘几张按几次,补一句话再回车。
1.2.3.4,它读你的 ssh 配置并发探测,5 秒内变绿安全
它只做这两件事。代码开源、主程序零第三方依赖(只用系统自带的 ssh)、苹果公证。下面这七条写进了软件的「关于」页,也写进了安装说明。
authorized_keys 里一行 restrict,command=…):开不了 shell、改不了配置;想收回,删那一行就行,或在 kklink 里点「移除并清掉服务器上的 kklink」。authorized_keys(kklink 不改系统设置、不碰 ~/.ssh);两台之间端到端加密直连,打不通才经我们的中转机转发密文;任何一台都能把别的设备踢出。哪些电脑能装
~/kklink/,不要 sudo)打开 dmg,把 kklink 拖进「应用程序」,从「应用程序」打开,菜单栏出现取景框 + 链环的小图标。
在 kklink 里点「用邀请码注册」(或在这个网站注册),邀请码找管理员要;另一台 Mac 用同一个账号登录。
另一台 Mac:「设备」页点「打通 SSH 连接」。服务器:粘 1.2.3.4 → 连接 → 卡片变绿。
点「去开启」给辅助功能权限,截一张图 ⌘C,到终端里按 ⌥⌘3。引导窗口一步步带你,每步做好自动打勾。
常见问题
不需要。两台 Mac 登录同一个账号就能互相找到:先尝试打洞直连(同一 Wi-Fi 直接走局域网),打不通经我们的中转机转发密文。中转走 TLS 443,公司网络、酒店、开着 VPN 都能过。不碰路由器、不要公网 IP、不装 VPN。
行,家里、公司、手机热点都可以。任何一边网络一变,kklink 自动重连:先经中转保证能用,再回到直连,十几到四十秒。正开着的 ssh 会话多数能接着用;断了再敲同一条 ssh kk-xxx 就是一个干净的新会话——想保住跑着的东西,在对方那头自己用 tmux / screen,kklink 不干预你的会话。
看不到。两台之间端到端加密(DTLS + SSH),中转机只转发密文;而且只有打不通直连时才经过它。
两步,都是你自己做:在系统设置里打开「远程登录」,把对方的钥匙行粘进 authorized_keys。kklink 只负责检测、给按钮、把那一行放到你剪贴板——不改系统设置、不碰 ~/.ssh。不想再被连,关掉开关或踢出设备即可。
每台设备一个固定别名,比如 ssh kk-home。在设备页点「固定成短命令」,把一行 Include 放进 ~/.ssh/config(也是你自己粘),之后任何终端、VS Code Remote、scp、rsync 都直接认这个名字。
不会。只在剪贴板里出现「图片数据」时才动,文字、文件、PDF 一律不看;每次上传右上角都会闪一下,没有静默上传。暂停上传一键可点。
只要「辅助功能」一项——按 ⌥⌘3 把路径打进终端要用,它不读你的键盘(只注册了两个全局快捷键)。不想给就用「零权限模式」:按 ⌥⌘3 只把路径复制到剪贴板,你自己 ⌘V。
用户目录下一个 ~/kklink/(接收脚本 + 图片)和 authorized_keys 里一行受限钥匙(restrict,command=…,只能放图、删图,开不了 shell、转发不了端口)。不碰 cron、不 sudo、不改系统配置。卸载:在 kklink 里点「移除并清掉服务器上的 kklink」,或自己删那一行 + rm -rf ~/kklink。
1.2 起只出 Apple 芯片版(M1 及以后),macOS 13 Ventura 起,不需要升级到最新系统。
终端:iTerm2、Terminal、kitty、Ghostty、Warp、WezTerm、Alacritty、VS Code / Cursor 内置终端(白名单在设置里可改)。AI 工具不限:Claude Code、Codex、Gemini CLI、OpenCode……只要它能读本地文件路径。标记格式也能改。
加几台就同步几台,每台一个「同步」开关;所有机器上文件名一字不差。在哪个终端窗口按热键就粘哪台的路径(按窗口标题判断,匹配串自动生成、可改);都不命中就粘设置里的默认台。
本地和每台服务器各保留 24 小时 / 200 MB,单张自动压到 5 MB 以内,每天最多 500 张,到期自动清理;都可以在设置里调。
不用管。kklink 每 6 小时检查一次,有新版本会先下载好、核对签名,再问你一句;点「立即更新」自动换好重新打开,设置、服务器、设备都保留。官网这个下载按钮永远是最新版。
管理员可以在后台停用账号。停用后 kklink 会在下一次检查时锁上(最晚 6 小时,重开 kklink 立即生效),提示「你的账号已停用」。重新启用后自动恢复,不用重装。
邀请码找管理员要。忘记密码也找管理员,后台可以重置。现在是内部版,凭邀请码免费使用。
右键菜单栏的 kklink 图标 →「反馈问题…」,写两句、附上截图(可勾选附上运行日志,日志里没有图片和密码),管理员在后台直接看到;也可以在这个网站的「反馈」页提交。
更新记录