你會學到什麼?為什麼現在必須懂?

上星期 Hacker News 有一條貼文衝上 239 分、125 則留言,標題叫「OpenShell — 為一大批自主 AI Agent 而設的安全私人執行環境」。留言區最熱門的一句話是:「我朋友讓 Claude 幫他整理資料夾,結果它把整個 Desktop 都清空了。」這不是笑話,是很多 HK/TW 開發者正在踩的坑。

你可能已經在用 Cursor、Claude Code、或者自己寫的 Python Agent 幫你自動化工作。問題是:這些 Agent 有 shell 權限、有檔案讀寫權限、有你的 API key。一旦它「理解錯」你的指令,輕則亂改檔案,重則把你的 OpenAI 帳單刷到幾千蚊美金。這篇文章會教你用 OpenShell 這個開源沙盒方案,把 AI Agent 關進一個「就算發癲都撞唔爛嘢」的籠子裡,三個步驟、十五分鐘搞掂。

為什麼 AI Agent 需要「沙盒」而不是「信任」?

先講一個真實情境。台灣一位做電商的讀者告訴我,他讓 Agent 每晚自動整理訂單 CSV,某晚 Agent 把「刪除重複行」理解成「刪除所有行」,隔天早上他打開 Google Sheet,發現整個月的訂單紀錄變成空白。幸好有備份,但如果 Agent 當時是直接操作本機檔案呢?

核心問題是:大型語言模型本質上是「機率預測機器」,它會按上下文猜你想要什麼,而不是嚴格執行你寫的邏輯。你寫「清理舊檔案」,它可能真的 rm -rf 下去。所以正確的做法不是「叫它小心啲」,而是從系統層面限制它做得到什麼。這就是沙盒(sandbox)的價值:不是相信 Agent 不會出錯,而是確保它出錯時,破壞範圍被鎖死在一個隔離環境內。

OpenShell 的思路正是如此——它為每個 Agent 開一個獨立、可拋棄的執行環境,檔案系統、網路、憑證全部隔離。Agent 在裡面怎麼搞都好,外面你的電腦、你的雲端帳戶完全不受影響。

第一步:安裝與建立你的第一個隔離環境

先講安裝。OpenShell 是開源專案,你可以直接用 Docker 跑,這對 HK/TW 讀者最方便,因為 macOS、Windows WSL、Linux 都通。

打開終端機,先確認你有 Docker:

docker --version

然後拉取 OpenShell 的執行映像:

docker pull openshell/runtime:latest

接著建立一個「工作目錄」給 Agent 用。關鍵技巧是:永遠不要把 Home 目錄掛載進去。只掛載一個空資料夾,讓 Agent 在裡面自由發揮:

mkdir -p ~/agent-workspace
docker run -it --rm \
  -v ~/agent-workspace:/workspace \
  --network none \
  openshell/runtime:latest

注意 --network none 這一行——它直接切斷 Agent 的網路。如果你要讓 Agent 上網查資料,才改成 --network bridge,並配合下一步的憑證限制。這個「預設無網」的設計,是我覺得 OpenShell 最實用的地方:Agent 想偷偷 call API 刷你錢?門都冇。

第二步:用憑證代理鎖住 API Key

很多人的惡夢是 Agent 把你的 API key 寫進 log、或者被 prompt injection 騙走。OpenShell 的做法是「憑證代理」(credential proxy):Agent 永遠見不到真實的 key,它只見到一個本地代理位址。

設定方法是建立一個 agent.env 檔:

OPENAI_BASE_URL=http://proxy:8080/v1
OPENAI_API_KEY=sk-proxy-dummy-key

然後在 OpenShell 的設定檔 openshell.yaml 裡宣告真實憑證:

credentials:
  - name: openai
    env: OPENAI_API_KEY
    inject_to: http://proxy:8080
    max_spend_usd: 5

這裡有兩個殺手級設定。第一,inject_to 讓真實 key 只在代理層出現,Agent 的環境變數裡只有假 key。第二,max_spend_usd: 5 是硬性花費上限——就算 Agent 陷入無限迴圈瘋狂 call API,到 5 美金就自動斷線。對比一下:沒有這個設定,一個失控的 Agent 一晚可以燒掉幾百美金。這個功能單獨就值得你裝 OpenShell。

第三步:設定檔案系統「唯讀白名單」

最後一步是最多人忽略的:即使 Agent 在沙盒內,你都要限制它「看得到什麼」。OpenShell 支援掛載時指定讀寫權限:

docker run -it --rm \
  -v ~/agent-workspace:/workspace:rw \
  -v ~/Documents/reference:/reference:ro \
  --network none \
  openshell/runtime:latest

:ro 代表唯讀(read-only),:rw 代表可讀寫。這個設計讓你放心把參考資料(例如公司文件、客戶名單)給 Agent 讀,但它永遠改不到、刪不到。我建議的黃金比例是:一個可寫的工作目錄 + 多個唯讀的參考目錄。這樣 Agent 有足夠上下文做事,但你的原始資料永遠安全。

做完這三步,你可以做個測試:叫 Agent 嘗試 rm -rf /reference,你會發現它會得到「Permission denied」。那一刻你會明白,安全感不是來自 Agent 的禮貌,而是來自系統的圍欄。

小結:把「信任」換成「設計」

今天學到的三件事:第一,AI Agent 出錯是常態,不要靠「叫它小心」;第二,用 Docker + --network none 建立預設隔離環境;第三,用憑證代理和 max_spend_usd 鎖住 API 費用,用 :ro 掛載保護原始資料。這套做法不只適用 OpenShell,任何 Agent 框架(LangChain、AutoGen、自己寫的)都可以套用同樣原則。

裝好之後,你就可以放心讓 Agent 幫你做更多自動化——因為你知道,就算它發癲,都只係在籠裡面發癲。今晚就試下啦,十五分鐘換來往後幾個月的安心,抵到爛。

延伸閱讀

常見問題

Q: OpenShell 同 Docker 沙盒有什麼分別?我不是直接用 Docker 就夠了嗎?

A: Docker 提供的是「隔離」,OpenShell 提供的是「為 Agent 設計的隔離」。分別在於憑證代理、花費上限、以及預設無網這幾個 Agent 專屬的防護。純 Docker 你要自己砌這些,OpenShell 幫你預設好。

Q: 我用的是 Windows,沒有 WSL,可以裝嗎?

A: 可以,但要先裝 Docker Desktop 並啟用 WSL2 後端。裝好後在 PowerShell 裡跑同樣的 docker 指令即可。建議先在 WSL 的 Ubuntu 環境測試,會順暢很多。

Q: 設定 --network none 之後,Agent 不能上網查資料,豈不是廢了?

A: 不會。你可以針對特定任務才開 --network bridge,並配合憑證代理限制它只能 call 白名單的 API。預設關網、需要時才開,這才是安全原則。

Q: max_spend_usd 是怎樣計算的?會不會誤殺正常使用?

A: 它按代理層記錄的 token 用量換算成美金,逐次累加。建議新手先設 5 美金,觀察一兩天實際用量再調整。正常整理檔案、寫程式的任務,5 美金通常夠用一整週。

Q: 這套做法適用於 Claude Code 或 Cursor 這些現成工具嗎?

A: 部分適用。Claude Code 和 Cursor 本身有權限確認機制,但你仍然可以在 Docker 裡跑它們,套用同樣的 :ro 掛載和無網原則。原理是通用的,工具只是外殼。