2026 Cursor Agent Skills 換 Mac 後怎麼繼續用於 Claude Code？

舊 Mac 能用、換到新 Mac 後 Claude Code 出現兩套同名技能 → 先只保留一個安裝來源，再開始複製或重裝。

長期專案選受版本控制的檔案版；純 Claude Code 任務選 plugin。兩者不能同時提供同名技能。

這篇適合三類人：正在把 Cursor 專案搬到新 Mac、需要在臨時或雲端 Mac 上重建開發環境的個人開發者與團隊，以及想在同一台 Mac 並用 Cursor 和 Claude Code 的開發者。若你只想排查單一指令錯誤，本文不是故障排查清單；重點是換機時的來源選擇與交付驗收。

最後更新於 2026 年 8 月 27 日；安裝路徑、CLI 指令與雙裝警告核實自 mattpocock/skills 官方 README、skills CLI 套件文件 與 Claude Code plugin 文件。

2026 Cursor Agent Skills 換 Mac：先判斷唯一來源

換 Mac 前，先在舊機記錄目前採用的方式。不要先把整個使用者目錄打包，也不要先執行另一條安裝指令。這一步直接決定後續是「拉取專案」還是「重新安裝 plugin」。

官方 README 把路線分成兩種：

• 專案檔案版：技能內容位於專案可管理的檔案中。你可以自行修改，更新也由你主動控制。
• Claude Code plugin：由 Claude Code 管理技能包。新機應透過 Claude Code 的 plugin 流程恢復，而不是手動搬移內容。

README 同時警告，兩種方式不能同時安裝，否則可能產生重複技能。這不是單純的目錄整理問題。當兩份同名技能都可見時，你很難判斷 Claude Code 實際載入哪一份，也無法可靠追蹤自訂修改來自哪裡。

這個選擇也解答了「Cursor Agent Skills 換 Mac」最常見的誤區：換機不等於兩條路都要重新安裝。你要重建的是已選定的來源，而不是把舊 Mac 的所有狀態複製過去。

長期新 Mac：專案檔案版對比零散複製

長期使用的新 Mac，專案檔案版的價值在於可審查、可回滾。mattpocock/skills 是否能跟著 Git 儲存庫走，關鍵不在 Mac 本身，而在技能檔案與自訂修改是否真的已提交到儲存庫。

搬遷步驟

一、在舊 Mac 確認來源。
記下技能實際位於專案內還是由 Claude Code plugin 管理。查看 Git 狀態，找出尚未提交的自訂技能、設定和初始化檔案。未提交的內容不能算完成遷移。

二、固定可回溯版本。
提交技能與專案設定，或至少記下目前已驗證的提交。不要以「舊機現在看起來能用」作為交付依據，因為快取與全域目錄不一定會進入新機。

三、在新 Mac 取得專案。
使用團隊原本的 Git 流程拉取儲存庫。先檢查技能目錄、專案設定與忽略規則，再依當天官方 README 和 skills CLI 文件執行安裝或初始化。npx skills add 的參數與路徑可能隨 CLI 更新，執行前應以skills CLI 的目前文件為準，不要照抄舊筆記。

四、核對自訂內容。
逐一比較技能檔案、說明文字、觸發條件與專案設定。若自訂內容只存在舊 Mac 的全域目錄，先把它整理進受版本控制的專案，或明確決定放棄，不要偷偷混入新機。

五、完成初始化。
依專案現有的初始化方式執行，並記錄終端機輸出、可見技能清單和任何權限要求。不要因為技能名稱出現在清單中，就直接判定環境完成。

六、做一次低風險呼叫。
選一個不會修改正式程式碼、不會刪除檔案的任務，確認 Claude Code 能讀取同一份專案上下文，且輸出符合自訂規則。這筆結果就是日後回滾和交付的基準。

長期方案的隱性成本有三個。第一，未提交修改會在換機時消失。第二，全域目錄與本機權限會造成「同一個儲存庫、不同結果」。第三，直接複製快取會把舊環境的偶然狀態當成專案資產。用 Git 內容重建，才有機會在另一台 Mac 再現同樣的技能來源。

臨時雲端 Mac：可重建環境對比完整克隆

臨時 Mac 的目標不是複製舊 Mac，而是從專案重新生成一台可交付環境。完整克隆使用者目錄看似省事，實際會帶入未記錄的權限、快取、全域設定與殘留 plugin，讓下一次重建難以解釋。

若團隊仍會修改技能，或 Cursor 與 Claude Code 需要共享一套可編輯內容，使用專案檔案版。這能降低機器級依賴：技能跟著儲存庫走，環境銷毀後仍可用同一提交重建。

若只是純 Claude Code 任務，技能不需修改，才考慮 plugin。Claude Code 的 plugin 管理方式應依官方 plugin 參考文件執行；新環境不要從舊機手動複製只讀內容。若你不確定 plugin 是否已載入，可參考官方 plugin 發現與安裝說明，再回到專案驗收。

環境銷毀前，至少要帶回：

• 已提交的專案版本與自訂技能；
• 專案初始化設定及必要的環境變數名稱；
• 技能可見清單與一次實際呼叫結果；
• 任何因臨時環境而產生、但未寫入儲存庫的修正；
• 失敗原因和最後採用的單一來源。

不要把快取、歷史工作目錄、登入狀態或本機下載內容列為交付物。它們或許能讓這台臨時 Mac 繼續工作，卻不能保證下一台也能工作。

Claude Code plugin：新機恢復對比檔案搬運

只使用 plugin 的情況，恢復順序應從「新 Mac → Claude Code → plugin → 專案」開始，而不是「舊 Mac → 複製技能目錄 → 猜測 Claude Code 是否載入」。

先依官方流程安裝 plugin，再確認三件事：

• plugin 狀態顯示為啟用，而不是只完成下載；
• 技能可以被 Claude Code 發現；
• 目前專案的初始化要求仍然完成。

如果專案內已經存在同名檔案版，先停止後續設定。不要用再次執行 npx skills add 或另一個 plugin 安裝來「修好」它。你需要先決定保留哪條路，再移除另一份來源，最後重新啟動會話並驗證。官方文件對 plugin 管理與發現的定義，應優先於舊文章、團隊聊天紀錄和個人腳本。

這條路線的優點是技能包由 Claude Code 管理，缺點是你不能把未提交的本機修改當作正式資產。若團隊需要自行維護技能，plugin 就不應被當成專案檔案版的替代備份。

Cursor 與 Claude Code：共用專案對比共存安裝

同一台新 Mac 並用兩個工具時，可以共享一套可編輯的專案檔案，也可以讓 Claude Code 單獨使用 plugin。不能同時為 Claude Code 提供兩份同名技能。工具可以並用，安裝來源不必並存。

建議按以下順序驗證：

先驗證 Cursor。
開啟目標專案，確認它讀到的是新 Mac 拉取的工作目錄與設定。不要只在另一個測試目錄看到技能名稱，就推論正式專案已連線。

再驗證 Claude Code。
確認它使用同一個專案上下文，並列出預期技能。若 Claude Code 顯示同名項目或來源不明，先回到唯一來源判斷。

最後執行低風險任務。
讓兩個工具各自完成不修改正式檔案的檢查，例如解釋一段設定或產生驗收摘要。比對它們是否讀取同一份自訂規則。這不能證明兩者內部實作完全相同，但能揭露工作目錄、檔案內容和技能來源是否偏離。

常見的隱性成本是工作目錄不同、權限不同，以及其中一個工具讀取了另一份殘留檔案。遇到結果不一致時，先比對路徑和來源；不要先增加安裝數量。

交付與回滾：驗收清單對比再次疊加

新 Mac 交付前，將以下項目逐格確認：

• [ ] 已記錄唯一技能來源：專案檔案版或 Claude Code plugin。
• [ ] 預期技能清單可見，且沒有同名的第二份來源。
• [ ] 技能自訂內容與已驗證的儲存庫版本一致。
• [ ] Cursor 和 Claude Code 已在預期工作目錄中完成低風險測試。
• [ ] 專案初始化結果、權限要求與環境變數處理方式已記錄。
• [ ] 重新啟動會話後，技能來源和可見狀態沒有改變。
• [ ] 臨時環境銷毀前，設定、自訂技能和驗收紀錄已回到儲存庫或團隊文件。

回滾時，回到舊 Mac 已驗證的儲存庫版本，或回到單一、已確認的 plugin 來源。不要以「再裝一次」取代回滾。以下內容不應成為新 Mac 的交付依據：未提交的全域技能、工具快取、登入工作階段、舊機專用路徑，以及無法說明來源的自動生成檔案。

若你需要把這套流程整理成團隊可執行的雲端 Mac 開發環境初始化與交付驗收指南，可將本文清單直接加入交付紀錄。需要比較短期測試與長期使用，也可先查看 MacHTML 的方案與租用方式，再按任務週期決定環境形態。

常見問題

以上流程的核心不是把舊 Mac 複製得更完整，而是讓新環境的技能來源、專案內容和驗收證據都能被重新建立。若你只做短期驗證，臨時 Mac 的優勢是不用先承擔長期本機維護；但若每天都要穩定修改同一套技能，自購或長期保留一台已固定的 Mac 可能更合適。

目前方案與 Mac 租用：把環境狀態留在可驗收的位置

如果你目前依賴舊 Mac 的全域目錄、手動複製技能和不完整的本機設定，缺點很直接：換機時容易漏檔、臨時環境難以重建，Cursor 與 Claude Code 還可能因同名來源而產生不一致結果。這種做法把維護成本放在人的記憶，而不是放在儲存庫和驗收紀錄中。

當你的需求是短期測試 Cursor 與 Claude Code、等待正式設備、或需要一台可銷毀後重新建立的環境，MacHTML 的租用方案會比反覆整理本機狀態更容易配合本文的單一來源流程。先完成來源判斷，再按任務週期選擇臨時 Mac；交付時使用上面的清單，才能確保租用結束後帶走的是專案資產，而不是某一台機器的偶然狀態。