给用 Claude Code · Codex · Gemini CLI 的你 · 内部版 1.3.2

一条命令,
连上你的另一台 Mac

两台 Mac 登录同一个账号就打通了:在公司敲 ssh kk-home,直接进家里那台的终端——不要公网 IP、不改路由器、换了 Wi-Fi 也不断。这边截图 ⌘C,图已经在那边;终端里按 ⌥⌘3,路径就打进 AI 的输入框。ssh 服务器也一样连。

7.3 MB · dmg macOS 13 起 Apple 芯片 苹果公证 主程序零第三方依赖

公司 · MacBook你在这边
家里 · Mac minikk-home · Claude Code 跑着
kk@office — zshkklink
$ 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 盖住了……

为什么做这个

AI 在另一台机器上,眼睛在你这台

Claude Code、Codex、Gemini CLI 跑在家里的 Mac mini 或者远程服务器里。它们读不到你本机的剪贴板、看不到你的屏幕;而你,常常连那台机器都够不着。

1

另一台 Mac 够不着

家里那台跑着 Claude Code,在公司想连上:公网 IP 没有,路由器端口映射不敢动,动态 DNS 隔三差五失效,VPN 一换网就掉。

2

截图传不过去

想让 AI「看一眼」:存桌面、起个文件名、开新标签 scp、回到 AI 窗口、把路径手敲一遍——一天几十次,还经常敲错。

3

换个网就得重来

换 Wi-Fi、开热点、VPN 一掉,连接就得从头配;按 IP 写的命令每到一个地方都不一样,到家还得先查今天的地址是多少。

现在登录同一个账号
ssh kk-home一条命令,哪里都能连
⌘C ⌥⌘3截图过去,路径粘进 AI

怎么用

三步,两台 Mac 就连成一台

  1. 两台都装上,登录同一个账号 菜单栏里多一个 kklink。「设备」页立刻能看到对方:在线、在哪个网、直连还是中转。
  2. 被连的那台:拨开「允许其他设备连接」 系统的「远程登录」由你自己在系统设置里打开,对方的钥匙行也是你自己粘进去——kklink 给你检测、给你按钮、给你那一行,不替你改系统设置、不碰 ~/.ssh。
  3. 另一台:点「打通 SSH 连接」 几秒后卡片变绿,拿到一条固定命令 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 粘的路径在哪台都对。

截图同步

截图 ⌘C,那头的 AI 立刻看到

任何截图工具,复制即触发:压缩、编号、传到每台开着「同步」的设备和服务器,右上角闪一下。在哪个终端窗口按 ⌥⌘3,就粘哪台的路径,shot3: ~/kklink/shots/… 打进 AI 的输入框,不自动回车——想粘几张按几次,补一句话再回车。

  • 登录名自动找只粘 1.2.3.4,它读你的 ssh 配置并发探测,5 秒内变绿
  • 服务器端全自动目录、接收脚本、一把只能放图的钥匙;不要 sudo、不碰 cron
  • 面板看今天每一张缩略图、传到了哪几台、「下次粘这张」「复制路径」「补传」
  • 断了自动补按 ⌥⌘3 时先补传再粘;重启不丢、不重传
  • 自己收拾两边各留 24 小时 / 200 MB,单张压到 5 MB 内,到期自动删
  • 零权限模式不想给「辅助功能」?⌥⌘3 只复制路径到剪贴板,你自己 ⌘V

安全

装在你机器上的东西,
你每一行都看得见

它只做这两件事。代码开源、主程序零第三方依赖(只用系统自带的 ssh)、苹果公证。下面这七条写进了软件的「关于」页,也写进了安装说明。

  1. 只在你刚复制了一张图片时,才把那张图传到你添加的服务器和你允许的自己的设备;每次都在右上角闪一下,没有静默上传。
  2. 不看剪贴板文字、不记录键盘、不截屏、不读你的文件;除了你添加的服务器和你自己账号下的设备,只连 kklink 官网(登录、每 6 小时报到 + 检查更新、你主动发的反馈),报到只带版本和机型。
  3. 服务器上只有一把「只能放图」的钥匙(authorized_keys 里一行 restrict,command=…):开不了 shell、改不了配置;想收回,删那一行就行,或在 kklink 里点「移除并清掉服务器上的 kklink」。
  4. 安装到服务器上的每一行命令都先给你看(高级 → 查看安装脚本全文),可以复制了自己跑。
  5. 图片两边各只留 24 小时 / 200 MB,单张不超过 5 MB,自动清理。
  6. 代码开源、主程序零第三方依赖(设备互联的小程序 kklink-net 用开源的 pion 库,版本钉死)、苹果公证;自动更新的包要过 SHA-256 / 版本号 / 代码签名三道校验;卸载一键清干净。
  7. 设备互联只在你自己账号下的设备之间:每台默认「不允许被连接」,要你自己拨开开关、在系统设置里打开远程登录、自己把对方的钥匙行粘进 authorized_keys(kklink 不改系统设置、不碰 ~/.ssh);两台之间端到端加密直连,打不通才经我们的中转机转发密文;任何一台都能把别的设备踢出。

哪些电脑能装

你的 Mac,和你想连的那头

你的 Mac

  • macOS 13 Ventura 或更新
  • Apple 芯片(M1 及以后;1.2 起不再出 Intel 版)
  • 一项权限:「辅助功能」(用来把路径打进终端;不想给就用零权限模式)
  • 任何截图工具:系统自带 ⌘⇧4、Shottr、CleanShot…复制即可

你想连的那头

  • 另一台 Mac:也装 kklink、登录同一个账号;系统「远程登录」你自己打开
  • ssh 服务器:能登录的 Linux / macOS,用户目录能写(装进 ~/kklink/,不要 sudo)
  • AI 工具不限:Claude Code、Codex、Gemini CLI……能读本地文件路径就行
  • 几台都可以,每台一个「同步」开关,截图同名同号

kklink 1.3.2

2026-10-19 发布 · 7.3 MB · dmg · 已装的同事不用管,会自动更新

  1. 1

    下载安装

    打开 dmg,把 kklink 拖进「应用程序」,从「应用程序」打开,菜单栏出现取景框 + 链环的小图标。

  2. 2

    注册并登录

    在 kklink 里点「用邀请码注册」(或在这个网站注册),邀请码找管理员要;另一台 Mac 用同一个账号登录。

  3. 3

    选连什么

    另一台 Mac:「设备」页点「打通 SSH 连接」。服务器:粘 1.2.3.4 → 连接 → 卡片变绿。

  4. 4

    开权限,截一张

    点「去开启」给辅助功能权限,截一张图 ⌘C,到终端里按 ⌥⌘3。引导窗口一步步带你,每步做好自动打勾。

常见问题

你可能想问

连另一台 Mac 需要公网 IP 或改路由器吗?

不需要。两台 Mac 登录同一个账号就能互相找到:先尝试打洞直连(同一 Wi-Fi 直接走局域网),打不通经我们的中转机转发密文。中转走 TLS 443,公司网络、酒店、开着 VPN 都能过。不碰路由器、不要公网 IP、不装 VPN。

两台不在同一个网络也行?换了 Wi-Fi 会断吗?

行,家里、公司、手机热点都可以。任何一边网络一变,kklink 自动重连:先经中转保证能用,再回到直连,十几到四十秒。正开着的 ssh 会话多数能接着用;断了再敲同一条 ssh kk-xxx 就是一个干净的新会话——想保住跑着的东西,在对方那头自己用 tmux / screen,kklink 不干预你的会话。

中转机能看到我的内容吗?

看不到。两台之间端到端加密(DTLS + SSH),中转机只转发密文;而且只有打不通直连时才经过它。

被连的那台要做什么?kklink 会改我的系统设置吗?

两步,都是你自己做:在系统设置里打开「远程登录」,把对方的钥匙行粘进 authorized_keys。kklink 只负责检测、给按钮、把那一行放到你剪贴板——不改系统设置、不碰 ~/.ssh。不想再被连,关掉开关或踢出设备即可。

ssh 的命令是什么?能在 VS Code / scp 里用吗?

每台设备一个固定别名,比如 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。

支持 Intel 的 Mac 吗?

1.2 起只出 Apple 芯片版(M1 及以后),macOS 13 Ventura 起,不需要升级到最新系统。

支持哪些终端和 AI 工具?

终端: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 图标 →「反馈问题…」,写两句、附上截图(可勾选附上运行日志,日志里没有图片和密码),管理员在后台直接看到;也可以在这个网站的「反馈」页提交。

更新记录

每一版改了什么

1.3.22026-10-19
  • 修跨 0 点截图串图:凌晨截的图传到对方的是昨天同号的旧图(编号每天归 1、队列留 24 小时,按编号找记录撞了)——现在一律按文件名定位,跨天不会再串;面板「下次粘这张」也按文件名记
  • 改名 kklink:新图标、新官网 kklink.amangoapp.com;打开后旧的 KKSnap 自动退出并移到废纸篓,设置、钥匙、服务器、设备全部自动搬家(要重新授权一次「辅助功能」;图标若被收进菜单栏左侧的 « 里,按住 ⌘ 拖到右边一次即可)
  • 设备互联正式版:换网自动重连、「打通」状态自动恢复、被连时菜单栏绿点、只展示在线设备;新域名连不上时 app 和设备互联小程序都自动退回旧域名
  • ssh kk-xxx 每次进去都是干净的新会话(想保活自己用 tmux);截图路径统一 ~/kklink/shots,多台同名同路径
1.3.12026-10-18
  • 改名 kklink:新图标、新官网 kklink.amangoapp.com;打开后旧的 KKSnap 自动退出并移到废纸篓,设置、钥匙、服务器、设备全部自动搬家(程序身份变了,要重新授权一次「辅助功能」;图标若被收进菜单栏左侧的 « 里,按住 ⌘ 拖到右边一次即可)
  • 新域名连不上时 app 和设备互联小程序都自动退回旧域名(1.3.1 修 1.3.0 设备互联登记不上的问题)
  • 设备互联正式版:换 Wi-Fi / 热点 / 关开 Wi-Fi 自动重连(先中转保通再回直连),「打通」状态自动恢复;被连时菜单栏绿点、设备页写明谁连着;只展示在线设备,过期设备自动剔除
  • ssh kk-xxx 每次进去都是干净的新会话(撤回 1.2.6 的自动接回 screen / tmux,想保活自己用 tmux);固定成短命令后任何终端直接 ssh kk-xxx
  • 截图路径统一 ~/kklink/shots,服务器与另一台 Mac 同名同路径,多台同时连也不会粘错;主窗改为普通窗口(可拖可缩放、记住位置和页签)
1.3.02026-10-18
  • 改名 kklink:新图标、新官网 kklink.amangoapp.com;打开后旧的 KKSnap 自动退出并移到废纸篓,设置、钥匙、服务器、设备全部自动搬家(程序身份变了,要重新授权一次「辅助功能」)
  • 设备互联正式版:换 Wi-Fi / 热点 / 关开 Wi-Fi 自动重连(先中转保通再回直连),「打通」状态自动恢复;被连时菜单栏绿点、设备页写明谁连着;只展示在线设备,过期设备自动剔除
  • ssh kk-xxx 每次进去都是干净的新会话(撤回 1.2.6 的自动接回 screen / tmux,想保活自己用 tmux);固定成短命令后任何终端直接 ssh kk-xxx
  • 截图路径统一 ~/kklink/shots,服务器与另一台 Mac 同名同路径,多台同时连也不会粘错;主窗改为普通窗口(可拖可缩放、记住位置和页签)
  • 官网新域名连不上时自动退回旧域名;旧域名继续可用
1.1.02026-10-17
  • 官网上线 kksnap.amangoapp.com:注册(邀请码)/ 登录后使用,管理员可在后台停用账号
  • 每 6 小时自动检查新版本:下载好、过 SHA-256 / 版本号 / 签名三道校验再问你一句,点「立即更新」自动换好重开
  • 菜单栏 📎 右键「反馈问题…」/ 面板 💬:写两句、附截图(可带运行日志)直接到开发者后台
  • 设置 → 关于新增「账号与更新」;安全承诺更新:除你添加的服务器外只连 KKSnap 官网