2026-05-25 Installer Understand-Anything sur Mac mini M4 loué : Claude Code, Cursor et Codex (HK / JP / KR / SG / US)
Understand-Anything (Lum1104/Understand-Anything sur GitHub) transforme vos dépôts en graphe de connaissances interactif que vous explorez, interrogez et injectez dans vos agents de codage IA. Sur un Mac mini M4 loué à Hong Kong, Tokyo, Séoul, Singapour ou aux États-Unis, le même hôte qui exécute la CI Xcode et les agents terminal peut héberger les skills Understand-Anything pour Claude Code, Cursor et OpenAI Codex CLI — à condition de séparer les chemins d'installation et de respecter les contraintes SSH vs GUI.
À quoi sert Understand-Anything
Understand-Anything construit un graphe de connaissances à partir de votre code et de la documentation pour que les agents répondent avec le contexte structurel — pas seulement le dernier fichier ouvert. Le projet annonce 14+ plateformes (mai 2026), dont le marketplace natif Claude Code, la découverte auto Cursor via .cursor-plugin/plugin.json, et des cibles install.sh comme codex, openclaw et antigravity.
- Indexer ou rafraîchir le graphe sur un checkout NVMe
- Poser des questions d'architecture ou de dépendances dans la session agent
- Laisser les agents citer des nœuds du graphe lors des refactors
Pourquoi installer sur un Mac mini M4 loué
Les nœuds Apple Silicon Mac mini M4 offrent un disque 24/7 pour ~/.understand-anything/repo, un egress stable vers les installateurs GitHub raw et la colocation avec votre automatisation existante. Les spécifications Mac mini correspondent à la classe RAM (16–24 Go) utile quand l'indexation Understand-Anything tourne à côté de sessions Codex ou Claude Code.
Comparez les coûts d'hébergement agent dans notre benchmark Codex CLI vs Claude Code sur M4 et le guide Google Antigravity sur M4 loué avant d'empiler cinq outils parallèles sur une lease 16 Go.
Claude Code : installation marketplace
Claude Code utilise le marketplace de plugins natif — pas de symlink manuel sur macOS :
/plugin marketplace add Lum1104/Understand-Anything
/plugin install understand-anything
Redémarrez la session Claude Code après l'installation. Sur des leases SSH sans tête, exécutez ces commandes une fois en shell interactif ; persistez ANTHROPIC_API_KEY (ou exports OAuth) via launchd séparément — voir les schémas PATH d'OpenClaw onboard pour la parité SSH / utilisateur démon.
Cursor : auto-découverte et repli manuel
git clone https://github.com/Lum1104/Understand-Anything.gitsur l'hôte loué (ou votre Mac)- Ouvrir le dossier dans Cursor
- Vérifier la détection de
.cursor-plugin/plugin.json
Si l'auto-découverte échoue : Cursor Settings → Plugins, recherchez https://github.com/Lum1104/Understand-Anything et ajoutez manuellement.
Cursor exige une session GUI — utilisez SSH vs VNC pour Mac cloud quand la lease est SSH-only : VNC pour l'indexation Cursor, SSH pour le batch Codex/Claude.
Codex CLI : install.sh en une ligne
Codex (et d'autres CLI) utilisent l'installateur upstream :
curl -fsSL https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.sh | bash -s codex
Le script clone vers ~/.understand-anything/repo et lie les skills pour la plateforme codex. Exécutez la variante bash -s --update selon la doc upstream. Redémarrez Codex après le lien.
Associez le réglage terminal du benchmark Codex vs Claude pour garder des budgets tokens prévisibles sur hôtes partagés.
SSH sans tête vs GUI sur builders loués
| Surface | Lease SSH seule | GUI/VNC requis |
|---|---|---|
Codex + install.sh codex | Oui | Non |
| Claude Code CLI | Oui (après bootstrap auth) | OAuth ponctuel possible |
| Cursor + UI graphe | Non | Oui |
| Exploration web/graphe | Souvent GUI | Prévoir fenêtre VNC |
Ne lancez jamais l'indexation graphe en root sur des leases multi-locataires ; scopez les checkouts par équipe sous /Users/builder/<tenant>/.
Matrice plateformes (Claude / Cursor / Codex)
| Plateforme | Méthode | Mieux sur M4 loué |
|---|---|---|
| Claude Code | /plugin install understand-anything | SSH + interactif |
| Cursor | Clone + auto-découverte | VNC ou Mac local + sync distant |
| Codex CLI | install.sh -s codex | Automatisation SSH |
| OpenClaw | install.sh -s openclaw | Même hôte que la passerelle |
| Antigravity | install.sh -s antigravity | Voir guide Antigravity |
Upstream liste 14 ids install.sh dont gemini, opencode, cline et kimi.
Déploiement en huit étapes
- Choisir la région de lease (HK/JP/KR/SG/US) proche des devs et de GitHub
- Installer les agents de base (Claude Code, Codex ou Cursor) avec versions épinglées
- Lancer l'install Understand-Anything pour chaque plateforme utilisée
- Cloner le monorepo cible sur NVMe rapide ; premier build graphe
- Vérifier qu'un agent répond à une question d'architecture avec citations
- Ajouter un garde CI : échec si graphe obsolète > N jours sur branches release
- Documenter les redémarrages après
install.sh --update - Planifier le nettoyage NVMe des caches
~/.understand-anything
Branchez les contrôles longue durée via des runners GitHub Actions self-hosted quand le graphe bloque les merges.
À lire aussi :
- obra Superpowers install (2026-05-26)
- Codex CLI vs Claude Code sur M4 (2026-05-23)
- Google Antigravity sur M4 loué (2026-05-23)
FAQ
Pourquoi louer un Mac mini M4 pour le tooling agent
Acheter du matériel n'a de sens qu'à utilisation 24/7 ; la location gagne pour l'indexation par à-coups, l'egress régional et la réinstallation propre quand les symlinks de plugins dérivent. Les nœuds M4 MacXCode gardent Understand-Anything, Xcode et les agents terminal sur la même classe Apple Silicon que votre CI iOS.
En bref : séparez les chemins Claude Code, Cursor et Codex, hébergez le graphe sur NVMe loué et branchez les garde-fous CI quand le graphe devient critère de merge.
Louez un M4 pour agents + graphe de code
Bare metal SSH-first à HK, JP, KR, SG et US — même classe Mac mini M4 pour Understand-Anything, Xcode et Codex.