InstallInstallation
Dependencies, install script, build from source, the Android app and the first checks.Dépendances, script d'installation, compilation depuis les sources, application Android et premières vérifications.
claude-cluster is one C++20 program (claude-cluster) plus a small wrapper for heavy commands (cluster-run). Claude Code is the default agent: install and log in to claude first, claude-cluster drives it.
claude-cluster est un programme C++20 (claude-cluster) avec un petit wrapper pour les commandes lourdes (cluster-run). Claude Code est l'agent par défaut : installez claude et connectez-vous d'abord, claude-cluster le pilote.
1. RequirementsPrérequis
| What | Version | Fedora (dnf) | Debian / Ubuntu (apt) |
|---|---|---|---|
| clang++, CMake | C++20, 3.20 or newer | clang cmake | clang cmake |
| libutils | 4.0.0 or newer | libutils | libutils |
| nlohmann/json | 3.10 or newer | json-devel | nlohmann-json3-dev |
| toml++ | 3.0 or newer | tomlplusplus-devel | libtomlplusplus-dev |
| OpenSSL (optional: https of the web access, microphone of the web page) | any | openssl-devel | libssl-dev |
| Qt6 Widgets (optional: the window) | 6.2 or newer | qt6-qtbase-devel | qt6-base-dev |
| chafa, ImageMagick (optional: images in the terminal) | any | chafa ImageMagick | chafa imagemagick |
| an agent | claude (default), ollama, qwen, opencode, codex |
FTXUI (the terminal interface) is fetched by CMake at a fixed version: the first configure needs network access. Without Qt6 the window is not built (--gui says so) and the terminal interface stays. The voice uses the optional local voice-listen / voice-say tools.
The package names of libutils depend on the repository you installed it from; the libutils-install skill of the repository picks the right method for your system.
| Quoi | Version | Fedora (dnf) | Debian / Ubuntu (apt) |
|---|---|---|---|
| clang++, CMake | C++20, 3.20 ou plus | clang cmake | clang cmake |
| libutils | 4.0.0 ou plus | libutils | libutils |
| nlohmann/json | 3.10 ou plus | json-devel | nlohmann-json3-dev |
| toml++ | 3.0 ou plus | tomlplusplus-devel | libtomlplusplus-dev |
| OpenSSL (optionnel : https de l'accès web, micro de la page web) | quelconque | openssl-devel | libssl-dev |
| Qt6 Widgets (optionnel : la fenêtre) | 6.2 ou plus | qt6-qtbase-devel | qt6-base-dev |
| chafa, ImageMagick (optionnel : images dans le terminal) | quelconque | chafa ImageMagick | chafa imagemagick |
| un agent | claude (défaut), ollama, qwen, opencode, codex |
FTXUI (l'interface terminal) est téléchargé par CMake dans une version fixe : la première configuration demande un accès réseau. Sans Qt6 la fenêtre n'est pas compilée (--gui le dit) et l'interface terminal reste. La voix utilise les outils locaux optionnels voice-listen / voice-say.
Les noms des paquets libutils dépendent du dépôt depuis lequel vous l'avez installé ; le skill libutils-install du dépôt choisit la bonne méthode pour votre système.
2. Fedora and DebianFedora et Debian
The one-line way builds and installs for your user (no root):
curl -fsSL https://raw.githubusercontent.com/TsukiNi22/ai-utils/main/setup.sh | bash -s -- install claude-clusterFrom a clone of the repository:
git clone https://github.com/TsukiNi22/ai-utils.git
cd ai-utils
./setup.sh install claude-cluster
./setup.sh remove claude-clusterThe binary goes to ~/.local/bin, with the completion for bash, zsh and fish. When the Android SDK is present the same command also builds the phone app (see below).
Coming soon. Ready-made RPM and DEB packages are not published yet. Until then the script above is the supported way on Fedora and on Debian / Ubuntu.
La méthode en une ligne compile et installe pour votre utilisateur (sans root) :
curl -fsSL https://raw.githubusercontent.com/TsukiNi22/ai-utils/main/setup.sh | bash -s -- install claude-clusterDepuis un clone du dépôt :
git clone https://github.com/TsukiNi22/ai-utils.git
cd ai-utils
./setup.sh install claude-cluster
./setup.sh remove claude-clusterLe binaire va dans ~/.local/bin, avec la complétion bash, zsh et fish. Quand le SDK Android est présent, la même commande compile aussi l'application téléphone (voir plus bas).
Bientôt. Les paquets RPM et DEB prêts à installer ne sont pas encore publiés. D'ici là le script ci-dessus est la méthode supportée sur Fedora et sur Debian / Ubuntu.
3. From sourceDepuis les sources
cmake -S tools/claude-cluster -B build -DCMAKE_BUILD_TYPE=Optimized
cmake --build build --parallel
cmake --install build --prefix ~/.localBuild modes are Debug, Asan and Optimized (the default). Options: -DCLUSTER_GUI=OFF skips the Qt6 window, -DCLUSTER_TESTS=ON builds the unit test of the line editor. Many sessions compiling at once saturate a computer: build with nice -n 19 and a limited --parallel.
cmake -S tools/claude-cluster -B build -DCMAKE_BUILD_TYPE=Optimized
cmake --build build --parallel
cmake --install build --prefix ~/.localLes modes de compilation sont Debug, Asan et Optimized (défaut). Options : -DCLUSTER_GUI=OFF saute la fenêtre Qt6, -DCLUSTER_TESTS=ON compile le test unitaire de l'éditeur de ligne. Beaucoup de sessions qui compilent saturent un ordinateur : compilez avec nice -n 19 et un --parallel limité.
4. The Android appL'application Android
The phone app is a thin shell around the web page of your own computer. It is built by android/build.sh with the Android SDK alone (no Gradle) and signed with a key made once in ~/.config/claude-cluster/android/release.jks: updates need the same key, keep a copy.
Once the web access is open, the page offers the APK to an Android browser at /app.apk. See Notifications and the phone app for what it does and Downloads for the file.
L'application est une coque autour de la page web de votre propre ordinateur. Elle est compilée par android/build.sh avec le seul SDK Android (sans Gradle) et signée avec une clé créée une fois dans ~/.config/claude-cluster/android/release.jks : les mises à jour exigent la même clé, gardez-en une copie.
Dès que l'accès web est ouvert, la page propose l'APK à un navigateur Android sur /app.apk. Voir Notifications et application téléphone pour ce qu'elle fait et Téléchargements pour le fichier.
5. Check it worksVérifier que ça marche
claude-cluster --version
claude-cluster # terminal interface in a terminal, else the window
claude-cluster serve # no interface: driven by the commands and the MCP serverNext: your first session. If something fails, see Troubleshooting.
claude-cluster --version
claude-cluster # interface terminal dans un terminal, sinon la fenêtre
claude-cluster serve # sans interface : piloté par les commandes et le serveur MCPEnsuite : votre première session. En cas de problème, voir Dépannage.