claude-cluster docs1.10.1
Advanced conceptsConcepts avancés

Permissions and models policyPermissions et politique de modèles

Permission modes, who may approve what, and the model and thinking policy the global session follows.Modes de permission, qui peut approuver quoi, et la politique de modèle et de réflexion que suit la session globale.

1. Permission modesModes de permission

ModeMeaning
autothe classifier of Claude Code allows the safe actions (default for new sessions: [agent] permission_mode)
manual (= default)every tool asks
acceptEditsfile edits are accepted, the rest asks
planread only, a plan first
dontAskwhat is not allowed is denied without asking
bypassPermissionsnever asks (default of the global session: [global] permission_mode)

Shift+Tab cycles auto, acceptEdits, plan, bypassPermissions, manual; /mode <mode>, claude-cluster mode <s> <mode> or session_set_mode set one. Sessions are launched with --allow-dangerously-skip-permissions ([agent] allow_bypass) so bypass can be chosen later; the mode shown is the one Claude Code confirms. The other drivers start one process per turn, so their permissions follow the mode and cannot be asked live.

ModeSens
autole classificateur de Claude Code autorise les actions sûres (défaut des nouvelles sessions : [agent] permission_mode)
manual (= default)chaque outil demande
acceptEditsles modifications de fichiers sont acceptées, le reste demande
planlecture seule, un plan d'abord
dontAskce qui n'est pas autorisé est refusé sans demander
bypassPermissionsne demande jamais (défaut de la session globale : [global] permission_mode)

Shift+Tab parcourt auto, acceptEdits, plan, bypassPermissions, manual ; /mode <mode>, claude-cluster mode <s> <mode> ou session_set_mode en fixent un. Les sessions sont lancées avec --allow-dangerously-skip-permissions ([agent] allow_bypass) pour que bypass puisse être choisi plus tard ; le mode affiché est celui que Claude Code confirme. Les autres pilotes lancent un processus par tour, donc leurs permissions suivent le mode et ne peuvent pas être demandées en direct.

2. AnsweringRépondre

A pending permission is a popup on the session, a notification (with Allow / Deny) and a line in session_status. You answer with Alt+Y, Alt+A (always, keeps the rule) or Alt+D; the global session answers with session_allow. The reason of every permission is shown with it. In auto mode, when the classifier gives no verdict (a failure on its side) one counted line is shown, and after two in a row the session goes manual for the rest of the turn.

Une permission en attente est une fenêtre sur la session, une notification (avec Allow / Deny) et une ligne dans session_status. Vous répondez par Alt+Y, Alt+A (toujours, garde la règle) ou Alt+D ; la session globale répond avec session_allow. La raison de chaque permission est montrée avec elle. En mode auto, quand le classificateur ne donne pas de verdict (une panne de son côté), une seule ligne comptée s'affiche, et après deux de suite la session passe en manuel pour le reste du tour.

3. Model and thinking policyPolitique de modèle et de réflexion

The global session runs on [global] model / effort and sets the model and thinking of the sub-sessions by the difficulty of each task, within Settings > Model policy ([policy], protected: it never changes them).

SettingWhat it does
default model / thinkingwhat sub-sessions start from
How the default applies (model_mode, effort_mode)free: none, by the task; advise: the start, deviate for a reason; force: nothing else, other choices refused with the reason
allowed models / effortsthe only ones it may choose (a name or a part: haiku, sonnet)
ask before a costly choicethe costly models (opus, fable) and efforts (xhigh, max, and above): a question on every interface (Allow / Deny, a notification)

Its system prompt always carries a routing guide: cheap model and low thinking for lookups and mechanical work, balanced for ordinary coding, premium and high thinking only for hard problems; start low and escalate on a real failure; never move a large session to a stronger model for one step (its whole context is re-read at the new price) but open a new sub-session with a short brief. The tool models_policy gives it your rules live: the models of its provider with tier, price, whether they are costly or allowed, and what a turn of each really cost you.

A costly choice returns at once as asked: the session keeps its model until you answer; Allow applies it and tells the global session, Deny keeps it and says why. These questions are yours alone. A change you make yourself (palette, /model, claude-cluster model) is never gated by the policy.

La session globale tourne sur [global] model / effort et fixe le modèle et la réflexion des sous-sessions selon la difficulté de chaque tâche, dans les limites de Réglages > Model policy ([policy], protégé : elle ne les change jamais).

RéglageEffet
modèle / réflexion par défautce dont partent les sous-sessions
How the default applies (model_mode, effort_mode)free : aucun, selon la tâche ; advise : le point de départ, s'en écarter pour une raison ; force : rien d'autre, les autres choix refusés avec la raison
modèles / efforts autorisésles seuls qu'elle peut choisir (un nom ou une partie : haiku, sonnet)
demander avant un choix coûteuxles modèles coûteux (opus, fable) et efforts (xhigh, max, et au-dessus) : une question sur toutes les interfaces (Allow / Deny, une notification)

Son prompt système porte toujours un guide de routage : modèle bon marché et réflexion basse pour les recherches et le travail mécanique, équilibré pour le code ordinaire, premium et réflexion haute seulement pour les problèmes difficiles ; commencer bas et monter sur un vrai échec ; ne jamais passer une grande session sur un modèle plus fort pour une étape (tout son contexte est relu au nouveau prix) mais ouvrir une nouvelle sous-session avec un bref énoncé. L'outil models_policy lui donne vos règles en direct : les modèles de son fournisseur avec niveau, prix, s'ils sont coûteux ou autorisés, et ce qu'un tour de chacun vous a vraiment coûté.

Un choix coûteux revient aussitôt en asked : la session garde son modèle jusqu'à votre réponse ; Allow l'applique et le dit à la session globale, Deny le garde et dit pourquoi. Ces questions sont les vôtres seules. Un changement que vous faites vous-même (palette, /model, claude-cluster model) n'est jamais filtré par la politique.

4. Changing the model of a loaded sessionChanger le modèle d'une session chargée

The prompt cache belongs to a model: the next turn on another model reads the whole context again, written to its cache at full price. So a model changed while the context is still loaded (its cache alive, or a turn running) is asked first, in every interface: the popup tells how much (84k tokens used by this session, or the total of the N sessions of every session), Cancel is focused (a stray Enter changes nothing), Change anyway applies it. A cache already expired changes at once: everything is read again anyway.

Le cache du prompt appartient à un modèle : le tour suivant sur un autre modèle relit tout le contexte, écrit dans son cache au prix fort. Un modèle changé pendant que le contexte est encore chargé (son cache vivant, ou un tour en cours) est donc demandé d'abord, dans chaque interface : la popup dit combien (84k tokens utilisés par cette session, ou le total des N sessions de toutes les sessions), Annuler a le focus (un Entrée par erreur ne change rien), Changer quand même l'applique. Un cache déjà expiré change tout de suite : tout est relu de toute façon.

5. BackendsFournisseurs

--backend and [agent] provider take <provider>[/<model>]: claude (default), anthropic-api, ollama, openrouter, deepseek, kimi, zai, minimax (Claude Code on an Anthropic-compatible endpoint), openai and ollama-openai (Qwen Code), opencode/<provider>/<model>, codex, or your own [providers.<name>]. The claude driver is the complete one: one process per session, live permissions, the MCP server, Remote Control. claude-cluster auth list shows what is ready. The cost shown for a non-Anthropic provider through Claude Code is a guess of claude and shown as local / unknown.

--backend et [agent] provider prennent <fournisseur>[/<modèle>] : claude (défaut), anthropic-api, ollama, openrouter, deepseek, kimi, zai, minimax (Claude Code sur un point d'accès compatible Anthropic), openai et ollama-openai (Qwen Code), opencode/<fournisseur>/<modèle>, codex, ou vos propres [providers.<nom>]. Le pilote claude est le complet : un processus par session, permissions en direct, le serveur MCP, Remote Control. claude-cluster auth list montre ce qui est prêt. Le coût affiché pour un fournisseur non Anthropic via Claude Code est une estimation de claude et s'affiche local / unknown.