2026-05-25 在租用 Mac mini M4上安裝 Understand-Anything：Claude Code、Cursor 與 Codex（港/日/韓/新/美）

Understand-Anything（GitHub：Lum1104/Understand-Anything）把程式碼庫變成可探索、可搜尋、可向 AI 程式代理查询的互動式知识圖譜。在香港、東京、首爾、新加坡或美國的租用 Mac mini M4上，同一台執行 Xcode CI 與終端代理的主机可同時承載 Claude Code、Cursor 與 OpenAI Codex CLI 的 Understand-Anything 技能——前提是分開安裝路徑並遵守 SSH 與 GUI 限制。上游在 2026 年 5 月报告 14+ 平台 整合與 v2.5 級圖譜工具（市場外掛、Cursor 自動發現、install.sh 目標）。

Understand-Anything 能做什麼

Understand-Anything 根據代码與檔案建置知识圖譜，讓代理用結構上下文回答，而不只盯着最近開啟的檔案。项目提供原生 Claude Code 市場外掛、透過 .cursor-plugin/plugin.json 的 Cursor 自動發現，以及 codex、openclaw、antigravity 等 install.sh 目標。

安裝後的典型流程：

1. 在 NVMe 上為儲存庫檢出索引或重新整理圖譜資料
2. 在代理工作階段中提问架构或依賴
3. 讓代理在提出重構时引用圖譜節點

為何在租用的 M4 Mac 上安裝

Apple Silicon Mac mini M4 節點提供 ~/.understand-anything/repo 的 7×24 磁碟、访问 GitHub 原始安裝腳本的稳定出口頻寬，並與现有自動化同機部署。Apple Mac mini 規格 的記憶體檔位（16–24 GB）可在 Understand-Anything 索引與 Codex 或 Claude Code 工作階段並行时滿足需求（租用方案依區域而定）。

在單台 16 GB 租用机上堆疊多种工具前，请先閱讀 Codex CLI 對比 Claude Code M4 基準 與 Google Antigravity 租用 M4 指南。台灣團隊常關注出口頻寬與 npm 拉取穩定性，租用節點可減輕本機網路波動对 install.sh 的影響。

• 統一記憶體 — 序列化佇列时，圖譜索引加一個代理工作階段可落在 16 GB。
• 區域對等 — 港/日/韩/新/美池提供相同 M4 SKU，到 GitHub 與模型 API 延遲更公平。
• 共用建置层 — 與现有 Xcode、Runner 車道相同的 Apple Silicon 級别。

Claude Code：市場外掛安裝

Claude Code 使用原生外掛市場——在 macOS 上無需手动符號連結：

/plugin marketplace add Lum1104/Understand-Anything /plugin install understand-anything

安裝后请重新啟動 Claude Code 工作階段。在無頭 SSH 租用机上，請在互動式 shell 中執行一次；透過 launchd 單獨持久化 ANTHROPIC_API_KEY（或 OAuth 匯出）——參見 OpenClaw 首次安裝與守護程序 中的 PATH 對齊做法。

Cursor：自動發現與手动備援

在本機克隆儲存庫后，Cursor 可自動發現外掛：

1. 在租用主机（或本机）執行 git clone https://github.com/Lum1104/Understand-Anything.git
2. 用 Cursor 開啟该檔案夹
3. 確認偵測到 .cursor-plugin/plugin.json

若自動發現失败：開啟 Cursor 設定 → 外掛，搜尋 https://github.com/Lum1104/Understand-Anything 並手动新增。

Cursor 需要 GUI 工作階段——若租用机僅 SSH，請參閱 雲 Mac 的 SSH 與 VNC：用 VNC 做 Cursor 索引，用 SSH 執行 Codex/Claude 批次處理。

Codex CLI：一行 install.sh

Codex 與其他 CLI 使用上游安裝器：

curl -fsSL https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.sh | bash -s codex

腳本會克隆到 ~/.understand-anything/repo 並為 codex 平台連結技能。按上游檔案可執行带 --update 的變體。連結后请重新啟動 Codex。

結合 Codex 與 Claude 對比基準 調整 Token 預算，避免共用主机失控。

無頭 SSH 與 GUI 租用建置机

切勿在多租戶租用机上以 root 執行圖譜索引；請在 /Users/builder/<tenant>/ 下按團隊隔離檢出目錄。

平台矩陣（Claude / Cursor / Codex）

上游 install.sh 列出 14 個平台 id，含 gemini、opencode、cline、kimi 等。

八步上線手冊

1. 選擇租用區域（港/日/韩/新/美），靠近開發者與 GitHub
2. 安裝基礎代理（Claude Code、Codex 或 Cursor）並固定版本
3. 為各平台安裝 Understand-Anything
4. 将目標 monorepo 克隆到高速 NVMe 並完成首次圖譜建置
5. 驗證代理 能引用節點回答一道架构题
6. 增加 CI 門禁：發布分支圖譜過期 > N 天則失败
7. 記錄 install.sh --update 後的重新啟動步驟
8. 定期清理 ~/.understand-anything 快取佔用的 NVMe

若圖譜用於合並門禁，请透過 GitHub Actions 自托管 Runner 接入长執行檢查。

延伸閱讀：

• obra Superpowers 安裝（2026-05-26）
• Codex CLI 對比 Claude Code M4 基準（2026-05-23）
• Google Antigravity 租用 M4（2026-05-23）
• OpenClaw 無頭雲 Mac 首次安裝
• 雲 Mac：SSH 與 VNC
• 雲 Mac 上的 GitHub Actions 自托管 Runner

常見問題

為何租用 Mac mini M4 做代理工具鏈

7×24 滿載时自購硬體更划算；租用適合突發索引、區域出口與外掛符號連結漂移後的乾淨重裝。MacXCode M4 節點讓 Understand-Anything、Xcode 與終端代理與 iOS CI 使用同一 Apple Silicon 級别。

結論：在租用 Mac mini M4 上按代理分別安裝 Understand-Anything——Claude Code 市場、Cursor 克隆+發現 或 Codex install.sh——再按八步手冊與 SSH/VNC 矩陣執行，避免圖譜索引阻塞無頭自動化。