ParallelSandbox打開 app

快速開始

複製這句，貼給你的 AI。

讀取 https://parallelsandbox.com/skill/SKILL.md，幫我安裝 ParallelSandbox skill 並完成連線。

想先搞懂再交給 AI

箱子怎麼運作、程式碼與資料會去哪裡、什麼會留下來、多個 repo 與資料庫怎麼接，都在工程師 Q&A。

AI 回完後仍能接收 App 回饋

使用 parallelsandbox-mcp 0.5.5 的 parallelsandbox-agent 啟動原生對話。先完成原生 AI 與 ParallelSandbox 的認證，準備需求文字檔，再依使用的 AI 選一個指令；把 CLI、專案與需求檔換成自己的絕對路徑：

執行器使用新的私有原生設定目錄。啟動時，Claude 需提供 ANTHROPIC_API_KEY，Codex 需提供 CODEX_API_KEY 或 OPENAI_API_KEY，Gemini 需提供 GEMINI_API_KEY 與有效的服務端點。另一個全域 CLI 目錄的登入不會自動帶入此對話；API key 不會寫入保存的模型／權限設定。ParallelSandbox 的登入另外驗證工具權限。

Gemini 無介面執行時，只針對你決定信任的專案，在啟動前設定 GEMINI_CLI_TRUST_WORKSPACE=true；執行器會保存這個明確選擇，恢復對話時沿用。

npx -y --package parallelsandbox-mcp@0.5.5 parallelsandbox-agent start --provider codex \
  --cli /absolute/path/to/codex --cwd /absolute/path/to/project --prompt-file /absolute/path/to/request.txt
npx -y --package parallelsandbox-mcp@0.5.5 parallelsandbox-agent start --provider claude-code \
  --cli /absolute/path/to/claude --cwd /absolute/path/to/project --prompt-file /absolute/path/to/request.txt
npx -y --package parallelsandbox-mcp@0.5.5 parallelsandbox-agent start --provider gemini \
  --cli /absolute/path/to/gemini --cwd /absolute/path/to/project --prompt-file /absolute/path/to/request.txt

每個對話由一個常駐執行器管理；三個 driver 分別呼叫 Codex、Claude Code、Gemini 的原生 CLI。AI 用 sandbox_review 交件時，執行器會登記這張卡片與原生對話 ID。AI 回完後，執行器仍在；人在 App 送出回饋，它就用保存的同一個 ID 接續下一輪。上一輪還在執行時，回饋會先排隊，避免兩個程序同時寫入原對話。

指令回傳的 session 是這個對話的私有目錄。查看狀態或執行器停止後恢復時，使用原目錄：

npx -y --package parallelsandbox-mcp@0.5.5 parallelsandbox-agent status --session /the/returned/session-directory
npx -y --package parallelsandbox-mcp@0.5.5 parallelsandbox-agent recover --session /the/returned/session-directory

模型、原生工具權限與中斷後的接續方式見原生對話回饋設定。只有明確登記的原生對話使用這條自動接續路徑；一般 MCP 連線或已開啟而未登記的 Desktop 對話，仍可在 App 按「複製給 AI 的訊息」，貼回原對話繼續。

連線起不來時

  • AI 工具啟動 ParallelSandbox 時逾時，而且沒有顯示來自 ParallelSandbox 的錯誤。 npx 還在下載 parallelsandbox-mcp，轉接器還沒啟動。原因寫在 ~/.npm/_logs/ 裡最新的檔案。連 registry.npmjs.org 出現 ENETUNREACH 或 ETIMEDOUT，通常表示電腦解析到一個它連不到的 IPv6 位址：在 AI 工具的 MCP 設定裡，把 "NODE_OPTIONS": "--dns-result-order=ipv4first" 加進這個 server 的 env；或用 npm i -g parallelsandbox-mcp 安裝一次，改執行 parallelsandbox-mcp，不再用 npx。
  • 工具失敗，訊息是 connection from this computer to ParallelSandbox (…) failed: fetch failed (ENOTFOUND …)。 這台電腦連不到 ParallelSandbox（DNS、proxy、VPN、Wi-Fi），括號裡的代碼就是原因。這不是箱子的網路問題：箱子連到你環境的連線在 sandbox_status 的 environment.connections[]。
  • AI 被告知 goal is required，卻從沒看過 goal 欄位。 它的工具清單是這個欄位出現之前的：重新連線 MCP server，或重新啟動 AI 工具。server 的工具清單有變動時，轉接器也會通知 AI 工具。
  • 呼叫 sandbox_* 工具時出現 InputValidationError。 有些 AI 工具只在需要時才載入工具的 schema，其餘列為 deferred（延後載入）；先把它們載入（Claude Code：ToolSearch）。