2026-05-25 임대 Mac mini M4(서울 노드 등)에서 Understand-Anything 설치: Claude Code·Cursor·Codex

Understand-Anything(GitHub: Lum1104/Understand-Anything)은 저장소를 탐색·검색 가능한 지식 그래프로 바꾸고 AI 코딩 에이전트가 질의할 수 있게 합니다. 서울 노드를 포함한 HK·JP·KR·SG·US의 임대 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/7 디스크, GitHub raw 설치 스크립트용 안정적 egress, 기존 자동화와의 동거에 적합합니다. Apple Mac mini 사양 메모리(16–24GB)는 서울 노드 등에서 그래프 인덱싱과 Codex/Claude Code 세션 병행에 맞습니다.

16GB 임대 1대에 여러 도구를 올리기 전 Codex vs Claude Code 벤치마크와 Antigravity 가이드를 확인하세요.

• 통합 메모리 — 큐를 직렬화하면 인덱싱+에이전트 1세션이 16GB에 맞습니다.
• 리전 패리티 — 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 vs 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.