安裝
git clone https://github.com/CrossPaste/crosspaste-desktop.git適合誰
如果你要在多台電腦之間無縫複製貼上,同時希望助手能讀取本機貼上板歷史,CrossPaste 對口。它把桌面應用做成跨裝置通用貼上板,並內建 MCP 服務,把貼上板歷史暴露給 Claude 等助手。
它適合已經在用 Mac、Windows 或 Linux 的人:官方寫明介面在這三類系統上保持一致,不必換操作習慣。它也適合不想把剪貼簿送進雲端的人:同步使用非對稱加密做端到端保護,架構是僅區域網路、無雲伺服器,資料本機儲存。
如果你只想在瀏覽器裡點一下就連上某個遠端服務,而手頭沒有本機編譯環境,能確認的範圍到此為止——官方給出的入口是複製倉庫後用 Gradle 跑起來,沒有另一條現成安裝包路徑。
3 分鐘完成第一次嘗試
官方路徑只有一條:從倉庫複製,再在倉庫根目錄編譯執行桌面應用。倉庫位址單獨一行:
https://github.com/CrossPaste/crosspaste-desktop
先決條件:本機已能執行 git 和 Gradle 包裝指令碼,作業系統是 Mac、Windows 或 Linux 之一。同步設計是僅區域網路,因此裝置應在同一區域網路內;官方沒有寫跨公網中繼。
安裝與執行位置是複製下來的 crosspaste-desktop 倉庫根目錄。先執行官方給出的複製命令,再進入目錄並用官方命令啟動:
git clone https://github.com/CrossPaste/crosspaste-desktop.git
cd crosspaste-desktop
./gradlew app:run
低風險第一次動作:應用跑起來後,在同一台機器上複製一段普通文字,再讓已接入該內建 MCP 服務的 Claude 去讀取貼上板歷史。官方只寫到「把貼上板歷史暴露給助手」,沒有給出具體工具名、參數或設定片段;因此第一次只做唯讀查看歷史,不要假設還能寫入或清空剪貼簿。
可觀察成功信號:./gradlew app:run 把應用拉起,桌面介面出現;隨後助手能複述你剛複製的那條文字。若應用沒起來,先停在編譯執行這一步,不要改用未寫明的啟動方式。
使用案例
案例一:讓助手回顧剛才複製過的內容。內建 MCP 服務的職責就是把貼上板歷史暴露給 Claude 等助手。你在任意已連線裝置上複製一段會議紀要或命令,再向助手詢問最近貼上記錄。官方沒有寫出工具名稱或回傳欄位,所以只能確認「能看到歷史」這一層,不能斷言分頁、搜尋或依裝置過濾。
案例二:從截圖裡取出文字且不離開本機。官方寫明內建 OCR 在本機從圖片擷取文字,不發起網路請求,截圖不離開裝置。把截圖複製進貼上板後,用應用做本機辨識即可。官方沒有說明 OCR 是否也透過 MCP 暴露給助手,因此不要把「助手直接讀圖」寫成已證實能力。
使用邊界
同步範圍被寫死為區域網路、無伺服器架構,本機儲存。不要指望它替你做公網漫遊或雲端備份。加密方式是非對稱的端到端加密,用來保護資料;官方沒有給出金鑰託管、多使用者共用或企業稽核介面。
OCR 強調本機、無網路呼叫,但這不等於整條鏈路沒有邊界:應用仍會讀取本機貼上板內容,其中可能有權杖、密碼或個人資訊。把歷史暴露給助手時,助手一側也會看到這些內容。
跨平台只涵蓋 Mac、Windows 和 Linux。行動端、瀏覽器擴充功能或遠端無介面主機是否可用,官方沒有寫。官方啟動命令是 ./gradlew app:run,沒有寫預編譯安裝包、系統套件管理器或一鍵設定 Claude 的步驟;缺哪一步,就停在已寫明的命令上。