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 向けスキルを載せられます（インストール経路の分離と SSH/GUI 制約の順守が前提です）。2026年5月時点で14+ プラットフォーム統合と v2.5 クラスのグラフツールが提供されています。

Understand-Anything の役割

Understand-Anything builds a knowledge graph from your codebase and docs so agents answer with structural context—not just the last file opened. The project ships native Claude Code marketplace plugins, Cursor auto-discovery via .cursor-plugin/plugin.json, and install.sh targets such as codex, openclaw, and antigravity.

Typical workflow after install:

1. Index or refresh graph data for a repo checkout on NVMe
2. Ask architecture or dependency questions inside your agent session
3. Let agents cite graph nodes when proposing refactors

レンタル M4 Mac で入れる理由

Apple Silicon の Mac mini M4 は ~/.understand-anything/repo の24時間ディスクと GitHub raw への安定した出口、既存自動化との同居に向いています。Apple Mac mini 仕様 のメモリクラス（16–24 GB）は、東京ノードなどでグラフ索引と Codex／Claude Code セッションを並行する際に有効です。

16 GB レンタル1台に複数ツールを載せる前に、Codex CLI 対 Claude Code ベンチマーク と Antigravity ガイド を確認してください。

• ユニファイドメモリ — キューを直列化すれば、索引+1エージェントは 16 GB に収まります。
• リージョン整合 — HK/JP/KR/SG/US で同一 M4 SKU。
• 共有ビルダー層 — 既存 Xcode／Runner と同じ Apple Silicon クラスです。

Claude Code：マーケットプレイス

Claude Code uses the native plugin marketplace—no manual symlink step on macOS:

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

Restart the Claude Code session after install. On headless SSH leases, run these commands in an interactive shell once; persist ANTHROPIC_API_KEY (or OAuth exports) via launchd separately—see OpenClaw onboard PATH patterns for parity between SSH and daemon users.

Cursor：自動検出と手動フォールバック

Cursor discovers the plugin when the repo is cloned locally:

1. git clone https://github.com/Lum1104/Understand-Anything.git on the lease host (or your Mac)
2. Open the folder in Cursor
3. Confirm .cursor-plugin/plugin.json is detected

If auto-discovery fails: Cursor Settings → Plugins, search https://github.com/Lum1104/Understand-Anything, and add manually.

Cursor requires a GUI session—use SSH vs VNC for cloud Mac when the lease is SSH-only: VNC for Cursor indexing, SSH for Codex/Claude batch work.

Codex CLI：install.sh 一行

Codex (and other CLIs) use the upstream installer:

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

The script clones to ~/.understand-anything/repo and links skills for the codex platform. Run the bash -s --update variant per upstream docs to pull latest. Restart Codex after linking.

Pair with terminal agent tuning from the Codex vs Claude benchmark so token budgets stay predictable on shared hosts.

ヘッドレス SSH と GUI

Never run graph indexing as root on multi-tenant leases; scope checkouts per team under /Users/builder/<tenant>/.

プラットフォームマトリクス

Upstream lists 14 install.sh platform ids including gemini, opencode, cline, and kimi.

8ステップ展開

1. Pick lease region (HK/JP/KR/SG/US) closest to developers and GitHub
2. Install base agents (Claude Code, Codex, or Cursor) with pinned versions
3. Run Understand-Anything install for each platform you use
4. Clone target monorepo to fast NVMe; run first graph build
5. Verify agent can answer one architecture question with citations
6. Add CI guard: fail if graph stale > N days on release branches
7. Document restart steps after install.sh --update
8. Schedule NVMe cleanup for ~/.understand-anything caches

Wire long-running checks through self-hosted GitHub Actions runners when graphs gate merges.

Related:

• obra Superpowers install (2026-05-26)
• Codex CLI vs Claude Code M4 benchmark (2026-05-23)
• Google Antigravity on leased M4 (2026-05-23)
• OpenClaw onboard on headless cloud Mac
• SSH vs VNC for cloud Mac
• GitHub Actions self-hosted runners on cloud Mac

FAQ

エージェント基盤に M4 をレンタルする理由

Buying hardware makes sense at 24/7 utilization; leasing wins for burst indexing, regional egress, and clean reinstall when plugin symlinks drift. MacXCode M4 nodes keep Understand-Anything, Xcode, and terminal agents on the same Apple Silicon class your iOS CI already uses.

Bottom line: on a leased Mac mini M4, install Understand-Anything once per agent path—Claude Code marketplace, Cursor clone + discovery, or Codex install.sh—then follow the eight-step runbook and SSH/VNC matrix so graph indexing never blocks headless automation.