⚙️Paramètres et clés

Tout se configure depuis Paramètres ; aucune modification de fichier n'est nécessaire.

Changer le fuseau horaire ici ne change pas l'horloge du serveur : exécutez aussi timedatectl set-timezone <Zone> && systemctl restart cron pour que les tâches planifiées suivent (voir Crons).

Installer l'application

Harness Maxxing s'installe comme une application (sa propre fenêtre, une icône dans le Dock, la barre des tâches ou l'écran d'accueil, plein écran sur un téléphone). Deux endroits : Installer l'application dans le menu du compte (l'icône de personne en bas de la barre latérale ; sur un téléphone, dans le menu ⊞) et Paramètres -> Général -> Application.

• Chrome, Edge (ordinateur ou Android) : un clic quand le navigateur le propose ; sinon le bouton affiche les étapes (l'icône d'installation au bout de la barre d'adresse, ou le menu du navigateur).
• Safari sur un Mac (macOS 14 ou plus récent) : Fichier -> Ajouter au Dock.
• iPhone / iPad : bouton Partager de Safari -> Sur l'écran d'accueil.
• Firefox ne peut pas installer d'applications web sur un ordinateur : utilisez Chrome, Edge ou Safari.
• La carte Application affiche un code QR de l'adresse : scannez-le avec le téléphone, connectez-vous, puis ajoutez-la à l'écran d'accueil.
• L'installation nécessite l'adresse en https (accès par nom de domaine). Via Tailscale (http://100.x.y.z:8787), les navigateurs ne la proposent pas.

Sur un téléphone ou une tablette

Les téléphones et les tablettes utilisent la disposition tactile (Paramètres -> Général -> Disposition la change par appareil) : pas de barre latérale, pas de barre en bas, la conversation remplit l'écran. Deux boutons se trouvent en haut de chaque écran : - ☰ (en haut à gauche) ouvre vos sessions - voir Sessions. Son compteur indique les réponses non lues. - ⊞ (en haut à droite) ouvre tout le reste : un champ de recherche (le même que ⌘K), chaque page (Tableau de bord, Sessions, Fichiers, Tâches, Crons, Notifications, Git et Infra quand ils sont activés, Extensions et pages épinglées), la mise à jour en attente, la santé du serveur, l'utilisation de votre forfait Claude, le thème, le mode présentation, Paramètres, Aide (visite, tutoriel, docs) et Se déconnecter. Un point sur ⊞ signifie qu'une mise à jour est en attente ou que le serveur demande votre attention.

Aussi : - Dans l'application installée, balayez depuis le bord gauche pour ouvrir les sessions, depuis le bord droit pour ouvrir le menu ; balayez un tiroir vers son bord pour le fermer. - Les panneaux qui montent depuis le bas se ferment par un balayage vers le bas (depuis leur poignée, leur titre, ou leur contenu quand il est défilé tout en haut), ou par un appui sur la zone assombrie au-dessus. - Les boutons du microphone et d'envoi sont plus grands ; pendant que vous écrivez, les panneaux restent au-dessus du clavier. - La page ne zoome pas (ni pincement, ni double appui), comme une application native ; les champs ne font jamais zoomer l'iPhone.

Authentification de Claude

Trois façons, de la meilleure à la moins bonne : 1. Jeton longue durée : exécutez claude setup-token sur n'importe quel ordinateur doté d'un navigateur, puis collez le jeton. 2. Clé API de la console Anthropic (facturée à l'usage). 3. Connexion CLI faite sur le serveur (claude, puis /login) : détectée automatiquement.

Tester effectue un vrai appel d'une ligne et affiche le modèle et la latence.

Les tours démarrent Claude sans sa vérification de mise à jour, sans télémétrie et sans téléchargement des indicateurs de fonctionnalités (démarrage plus rapide, prompt plus court) ; "claude_quiet_start": false dans config.json désactive ce comportement.

Claude exécute ses agents auxiliaires au premier plan : vous recevez leur résultat dans le même tour (plusieurs agents tournent toujours en parallèle). L'habitude de Claude Code est de les envoyer en arrière-plan, où le tour attend qu'ils fassent leur rapport, ce qui est plus lent ; "background_agents": true dans config.json revient à ce comportement. Vous pouvez toujours demander à Claude un agent en arrière-plan dans votre message.

Mises à jour de Claude Code

Mettre à jour Claude Code automatiquement (désactivé par défaut) : toutes les 6 heures, le serveur cherche une version stable plus récente de Claude Code (celle qu'Anthropic marque comme stable : déjà utilisée depuis quelques jours, pas la toute dernière). Quand il y en a une, il installe lui-même cette version - mais seulement quand rien n'est en cours : aucun tour de conversation, aucun message en attente dans une file, aucune tâche planifiée, et le dernier tour s'est terminé il y a plus de 10 minutes. Sinon il attend et réessaie quelques minutes plus tard, de sorte qu'une mise à jour ne coupe jamais un tour, et un tour qui démarre pendant la mise à jour l'attend (la conversation l'indique ; 7 minutes au maximum). Seul le serveur installé le fait : un second Harness Maxxing lancé sur la même machine pour le développement ou des tests ne met jamais à jour le Claude Code de la machine. Cela fonctionne pour l'installateur officiel et pour une installation npm globale (un autre type d'installation est laissé tel quel). Si la nouvelle version ne démarre pas, la précédente est remise en place.

Chaque mise à jour apparaît dans les notifications (« Claude Code mis à jour vers 2.1.5 »), et l'interrupteur affiche la dernière (2.1.4 -> 2.1.5 et sa date). Un échec est aussi notifié, une fois par version, avec la raison ; le serveur réessaie 6 heures plus tard. Laissez l'interrupteur désactivé pour mettre à jour à la main (claude update dans un terminal) ; maxxing doctor indique alors Claude Code sous claude_version quand il est en retard.

Mode de permissions

Un sujet peut avoir son propre mode (liste des sessions -> menu du sujet -> Permissions), et une tâche Claude planifiée aussi (Mode de permissions dans l'éditeur de tâche) : utilisez un mode plus strict là où Claude lit du contenu venant de l'extérieur - pages web, e-mails, messages transférés - afin que des instructions cachées dans ce contenu ne puissent pas lui faire faire n'importe quoi. Ordre : le mode de la tâche, sinon celui du sujet, sinon ce mode global.

Protéger les secrets (activé par défaut) : dans tous les modes, les outils de Claude refusent de lire ou de modifier les secrets du serveur (secrets.json) et les clés SSH (~/.ssh). Cela empêche une instruction cachée de simplement les lire ; un script écrit exprès pour ouvrir le fichier n'est pas arrêté, donc cela ne remplace pas un mode plus strict. Autres règles : claude_deny dans config.json (syntaxe des règles de Claude Code, par exemple "Bash(rm -rf:*)").

Voir Sécurité.

Clés (coffre-fort de secrets)

Stockez les clés API et les jetons dont vos projets ont besoin (par exemple OPENAI_API_KEY, SHOP_TOKEN) :

• les noms sont en MAJUSCULES (A-Z, chiffres, _), les valeurs sont masquées et ne s'affichent qu'avec Révéler ;
• ajoutez une note (à quoi il sert, d'où il vient) ;
• Exposer rend le secret disponible comme variable d'environnement pour chaque session Claude et chaque tâche cron shell – pratique pour les scripts, et Claude n'a jamais besoin de voir la valeur dans une conversation ;
• certains noms sont réservés (variables système, variables qui font charger du code par les shells, Node, Python ou git
• NODE_OPTIONS, BASH_ENV, GIT_SSH_COMMAND... -, ANTHROPIC_BASE_URL, tout ce qui commence par MAXXING_) ; une clé existante portant un tel nom est conservée mais n'est plus exposée.

Depuis les scripts et les sessions : maxxing keys list|get|set|delete (la valeur de set est lue sur stdin) - un script qui renouvelle un jeton réécrit ainsi la nouvelle valeur. Les scripts lisent les clés dans l'environnement (os.environ["NAME"]), jamais dans un fichier qui leur est propre.

N'écrivez que le nom de la clé dans les fichiers de mémoire (« API Shop : clé SHOP_TOKEN »). Les extensions lisent les clés avec ctx["secret"]("NAME").

Les clés se trouvent dans /var/lib/claude-maxxing/secrets.json (mode 600) et ne sont pas incluses dans la sauvegarde.