Security

Claude Code 陌生倉庫能直接在遠端 Mac 執行嗎?2026 安全清單

Claude Code 陌生倉庫能直接在遠端 Mac 執行嗎?2026 安全清單

Claude Code 遠端 Mac 陌生倉庫安全的結論是:不要在下載目錄或混有未知檔案的工作區直接啟動 Agent;先檢查專案指令與腳本,再限制工作區、權限、憑據和網路。這適合準備用遠端 Mac 處理外部程式碼的人;若環境沒有實際隔離,遠端執行不會自動讓陌生程式碼變安全。

沒有本地 Mac、準備用 Claude Code 或 Codex 接手外部倉庫的開發者,可用本文核驗首次執行前的邊界。
維護共享遠端 Mac 或 CI 節點的 DevOps 工程師,可檢查憑據和殘留狀態是否跨工作區共享。
制定編碼 Agent 團隊規範的工程負責人,可把下列檢查轉成准入流程。

最後更新於 2026 年 10 月 28 日;日期與研究報導核實自 2026 年 10 月 26 日對惡意專案指令研究演示的報導、Anthropic Claude Code 安全文件及 OpenAI 執行環境安全文件。

Claude Code 開啟陌生倉庫前的輸入檢查

倉庫中的內容不應因為被 Agent 讀取,就被當成可信授權。要先確認程式碼從哪裡來、工作目錄中有哪些陌生檔案,以及哪些內容可能引導 Agent 或專案腳本執行操作。

2026 年 10 月 26 日的媒體報導轉述了研究人員展示的案例,內容涉及下載目錄中的惡意檔案和專案指令對 Codex、Claude Code 的影響。這是研究演示的媒體報導,不是廠商確認普遍漏洞的聲明;不能推論所有專案或所有設定都會受到影響。它提供的操作教訓是:把未知專案內容視為不可信輸入,先確認再執行。

建議先查清楚:

  • 來源:倉庫是否來自預期的組織或維護者?複製的網址、分支及近期變更是否符合任務需要?
  • 目錄內容:工作區是否混放下載檔、個人文件、其他專案或舊日誌?不要把「目前在下載目錄裡」誤當成來源可信的證明。
  • 專案指令:檢查 AGENTS.md、CLAUDE.md、README 及其他會提供 Agent 專案脈絡的檔案。OpenAI 的 Codex 指令文件說明可協助辨識專案指引的用途;這類文字是輸入,不是系統層級的授權或安全控制。
  • 執行入口:檢查安裝指令、建置腳本、套件生命週期腳本、專案 hooks 和自動化設定。先讀內容,再判斷是否允許執行。

即使指令檔寫著「不要讀取某個目錄」或「只執行安全命令」,也不能據此認定 Agent 無法存取該目錄,或程式碼不會產生副作用。文本意圖和實際權限是兩回事。

下載目錄專案指令檔對編碼 Agent 的影響

有可能影響 Agent 對專案的理解與後續操作,但影響方式取決於 Agent 如何載入指引、目前工作目錄及工具設定。不能把某個檔案名稱視為所有工具都會自動採用的規則,也不能把指令內容當成強制授權機制。

首次處理陌生倉庫時,將指引檔與其他輸入一起檢查:確認它是否要求讀取工作區以外的資料、輸出環境變數、執行安裝命令,或修改權限與設定。若遇到不明要求,先停止自動流程,改以人工閱讀或在沒有敏感資料的測試環境中確認。

相同原則適用於 Codex 專案指令文件:它可提供操作脈絡,但不等於作業系統會替 Agent 限制檔案存取。若團隊規範需要硬性邊界,必須另行核對 Agent 的工具權限和 macOS 環境的隔離方式。

工作區隔離與 Agent 權限的驗收邊界

「專案放在獨立資料夾」可以縮小誤操作範圍,但不表示 Agent 進程已被作業系統隔離。真正要核對的是 Agent 以哪個使用者身分執行、該身分可讀寫哪些路徑,以及工具權限是否允許改動工作區之外的內容。

驗收維度 較低風險的做法 放行前仍須確認
工作目錄 使用專用、內容清楚的專案目錄 Agent 實際可讀寫的路徑是否超出該目錄
命令與寫入 需要時逐項批准寫檔、執行命令及修改設定 權限模式是否允許未經確認的操作
專案 hooks 審閱 hook 設定及其呼叫的程式 是否會在提示或人工審查前自動執行
系統隔離 依 Agent 與 macOS 的官方文件核對 是否有真正限制檔案及程序存取的控制
網路 只允許任務所需的目的地 下載、套件安裝或代理通道是否仍可繞過預期限制

Anthropic 的 Claude Code 沙箱說明與 CLI 權限模式文件應分開閱讀:權限模式決定工具操作如何受到批准或限制;沙箱相關控制則涉及執行環境的邊界。具體行為須以實際採用的設定和當前文件為準,不能只憑提示詞或專案指令推定。

macOS 工作區隔離的驗收方式

先確認 Agent 的起始目錄、執行帳戶和可用工具,再以該帳戶檢查它能否讀寫專案之外的路徑。核對沙箱或系統限制是否已實際啟用;若無法由官方文件和本機設定證明限制存在,就不要把工作區分開存放說成作業系統級隔離。

若任務不需要改動檔案或執行命令,將相應操作保留為人工批准。若工作流程必須自動執行,則要明確記錄批准規則、可執行命令範圍和回復方式。Anthropic 文件描述的是其產品能力與設定,不會代替使用者檢查目前節點上的實際權限。

遠端 Mac 能隔離工作區與憑據嗎?

不能單憑「遠端」或「雲端」判斷隔離已成立。遠端 Mac 是執行位置;真正的安全邊界取決於帳戶權限、檔案配置、Agent 設定、網路政策,以及同一環境是否還存有其他專案或憑據。

共享節點尤其要留意工作區之間的殘留狀態:Shell 設定、快取、暫存檔、命令歷史、日誌,以及使用者家目錄中的設定都可能包含任務資訊。若同一帳戶可存取多個專案,單純建立不同資料夾不足以證明專案彼此隔離。

憑據暴露範圍

盤點工作目錄、環境變數、命令列設定和日誌中的倉庫、雲端或模型憑據。執行陌生程式碼時,只提供任務所需的最低權限;不要把長期有效的祕密放進可執行任意程式的環境,再把這種做法稱為隔離。

若懷疑令牌曾被讀取或帶出,應按憑據所屬系統的流程撤銷或輪替,並檢查相關日誌。不要只刪除工作區中的檔案,就認定憑據已失效。

網路出口與安裝通道

確認 Agent 和專案腳本能否連到未批准的外部位址。安裝套件、下載建置工具或透過代理轉送請求,都可能形成額外出口。OpenAI 的執行環境安全文件說明其環境安全設計;團隊仍須分清產品文件描述的能力與自行設定的網路政策,不應推斷某項服務預設就具備所需的網路隔離。

若工作需要下載依賴,先確認來源與允許範圍,再決定是否開放連線。若任務不需要網路,應確認實際政策是否能阻擋不必要的出口,而不是只依賴 Agent 指令要求它「不要上網」。

陌生倉庫啟動腳本交由 Codex 執行前的檢查

不建議未檢查就直接執行。先閱讀腳本及它會呼叫的檔案,確認是否會安裝套件、執行 hooks、讀取環境變數、修改工作區外的資料,或連線到未核准的服務。腳本即使是專案慣用的啟動入口,也仍屬於可執行程式碼。

OpenAI 的指令文件與執行環境安全文件提供的是不同層面的資訊:前者說明專案指引,後者說明執行環境安全。兩者都不代表陌生倉庫中的任意腳本已自動獲得安全背書。用 Codex 接手前,至少要確認腳本內容、執行時的帳戶權限,以及它能接觸的憑據和網路。

首次執行前的放行流程

以下流程可用於單人開發、共享遠端 Mac 或 CI 節點。遇到無法驗證的項目,先暫停自動執行,改用沒有敏感資料的工作區進行人工檢視。

  • 確認來源與版本:核對倉庫網址、維護者、分支和目前待處理的變更;無法確認來源時,不載入敏感憑據。
  • 整理工作目錄:把專案放入內容清楚的專用資料夾,不在混有下載檔和其他專案的目錄啟動 Agent。
  • 閱讀指引與腳本:逐一檢查專案指令、安裝腳本、hooks 和建置入口;遇到外部下載、權限更改或不明網路請求,先查明理由。
  • 限定工作區與帳戶:確認 Agent 的起始路徑、執行身分及可讀寫範圍;依所用 Agent 和 macOS 的官方文件驗證實際隔離,而非只看資料夾名稱。
  • 收緊工具批准:對寫檔、執行命令和修改設定保留審查;若使用自動批准,明確設定允許範圍,並檢查項目是否能透過 hooks 提前執行操作。
  • 移除不必要的憑據:檢查環境變數、命令列設定與日誌,只保留任務必需的最低權限;不讓陌生程式碼接觸長期有效的祕密。
  • 檢查網路與清理狀態:核對出站政策及安裝來源;完成後清理工作區、暫存檔和可能含有憑據的記錄,並按需要撤銷或輪替暴露過的令牌。

GitHub Actions 的安全使用文件也值得用來審視 CI 工作流程:工作區內可執行的內容、工作流程權限與祕密管理必須一併考慮。若是共享 Runner,不要假設任務結束就代表節點已清除所有殘留狀態。

若需確認遠端 Mac 的接入與使用條件,可先查看 ProxyMac 使用說明及方案資訊。選擇任何遠端環境前,都應向服務方核對實際帳戶權限、交付方式、工作區隔離與重置方式;無法核實的能力,不應列為已具備的安全控制。

如果目前是在 Windows 或 Linux 上繞行,常見代價是缺少原生 macOS 工具鏈、需要維護另一套執行環境,且專案憑據可能分散在本機與 CI 設定中。需要短期處理 Xcode 或其他 macOS 專屬任務時,租用 ProxyMac 的遠端 Mac 可提供直接使用 macOS 的工作環境;但它不會代替你設定 Agent 權限、憑據和網路邊界。若任務需要長期高負載、專用實體介面,或必須完全自行掌控硬體,購買自有 Mac 可能更合適。選擇租用前,先按上述清單核對可驗證的安全控制,再決定是否符合這次任務的要求。

為陌生倉庫準備一台獨享遠端 Mac

使用 ProxyMac 獨享 Mac mini M4,將陌生專案與日常工作環境分開,降低混用檔案與憑證的風險。
透過 SSH、VNC 或瀏覽器連線,按需要檢查程式、權限與網路設定,再開始執行工作流程。