Configuration du client

Utilisez cette page pour changer le comportement du client sur une machine : où il conserve son état, comment il joint la plateforme, et lesquelles de ses parties s’exécutent.

openlatch init écrit la configuration pour vous. Ne la modifiez à la main que pour un paramètre qu’aucune commande ne couvre, puis exécutez openlatch restart pour l’appliquer : le daemon ne lit sa configuration qu’une fois, au démarrage.

D’où viennent les paramètres

Le client lit chaque paramètre dans la première source qui le définit, dans cet ordre :

1. Une option sur la ligne de commande.
2. Une variable d’environnement (OPENLATCH_*).
3. Le fichier de configuration, config.toml dans le répertoire d’état : ~/.openlatch sous macOS et Linux, %APPDATA%\openlatch sous Windows.
4. La valeur par défaut intégrée.

La route du proxy est la seule exception : elle se résout clé par clé et, après le fichier de configuration, elle tient aussi compte des variables standard de la famille https_proxy, puis des réglages de proxy du système d’exploitation, avant de passer en direct.

Le daemon supervisé n’hérite pas des variables de votre shell. Tout ce dont il a besoin, comme l’adresse de la plateforme, openlatch init l’écrit dans config.toml pour que le daemon l’utilise aussi.

Variables d’environnement

État et connexion

Variable	Ce qu’elle définit	Par défaut
OPENLATCH_DIR	Le répertoire d’état : configuration, identifiant, journaux et outbox	~/.openlatch sous macOS et Linux, %APPDATA%\openlatch sous Windows
OPENLATCH_PORT	Le port du daemon. Définie, openlatch init utilise exactement ce port ; non définie, il cherche un port libre de 7443 à 7543	7443
OPENLATCH_API_URL	L’adresse de la plateforme à laquelle le client envoie les événements et où il récupère les politiques	https://app.openlatch.ai
OPENLATCH_API_KEY	L’identifiant d’enrôlement. openlatch init l’enregistre dans le trousseau du système d’exploitation, ou dans un fichier chiffré quand aucun trousseau n’est utilisable	—
OPENLATCH_SKIP_KEYRING	Considère le trousseau comme indisponible, pour que la variable d’environnement l’emporte	non définie
OPENLATCH_LOG	Niveau de journalisation : error, warn, info, debug ou trace	info

Proxy

Variable	Ce qu’elle définit	Par défaut
OPENLATCH_PROXY	L’URL du proxy pour chaque requête sortante. C’est le seul paramètre qui peut contenir un identifiant ; openlatch init déplace le mot de passe dans le trousseau au lieu de l’écrire sur le disque	non définie
OPENLATCH_NO_PROXY	Destinations supplémentaires qui contournent le proxy. Les adresses de bouclage le contournent toujours	non définie
OPENLATCH_PROXY_MODE	auto, manual ou direct	auto
OPENLATCH_PROXY_AUTH	auto, none, basic ou negotiate (Kerberos). NTLM n’est pas pris en charge	auto
OPENLATCH_PROXY_PAC_URL	Une URL explicite de configuration automatique du proxy, utilisée sur macOS et Windows. Refusée sur Linux avec OL-1225	non définie
OPENLATCH_PROXY_SPN	Le nom de service Kerberos du proxy	HTTP/<proxy-host>
OPENLATCH_CA_BUNDLE	Un bundle PEM ajouté aux certificats approuvés du système d’exploitation, pour un proxy qui inspecte le trafic TLS	non définie

Parties du client

Variable	Ce qu’elle définit	Par défaut
OPENLATCH_POLICY_ENABLED	L’évaluation locale des politiques. false désactive complètement l’application sur cette machine ; ce n’est pas un mode Monitor (OL-1215)	true
OPENLATCH_MODEL_RELAY_ENABLED	Le relais de modèle, l’écouteur local qui enregistre les appels de modèle de chaque agent. Le daemon n’y dirige un agent qu’une fois qu’une requête de test prouve qu’il joint le fournisseur	true
OPENLATCH_MODEL_RELAY_PORT	Le port du relais de modèle	7600
OPENLATCH_INVENTORY_ENABLED	Le suivi des fichiers de configuration des agents (le plan de configuration)	true
OPENLATCH_CLINE_PLUGIN_DELIVERY	La livraison du plugin OpenLatch à Cline.app et à l’extension Cline de VS Code. Équivaut à plugin_delivery dans [cline]	true

Envoi vers la plateforme

Variable	Ce qu’elle définit	Par défaut
OPENLATCH_CLOUD_BATCH_MAX_EVENTS	Nombre d’événements envoyés par lot, de 1 à 100	50
OPENLATCH_CLOUD_BATCH_MAX_WAIT_MS	Combien de temps le premier événement d’un lot attend avant l’envoi du lot, en millisecondes	5000
OPENLATCH_CLOUD_OUTBOX_MAX_BYTES	Le volume maximal d’événements non envoyés que garde l’outbox, en octets, avant l’abandon des plus anciens. 0 supprime la limite	104857600
OPENLATCH_CLOUD_FALLBACK_MAX_BYTES	Le volume maximal d’événements non rejoués que garde le journal de secours, en octets, avant que les plus anciens soient ignorés. Il limite cette fenêtre, pas le fichier : pendant une longue coupure, le fichier sur disque continue de grossir jusqu’à ce que le daemon le rejoue. Lu par le daemon uniquement ; le hook garde sa propre limite de 50 Mo. 0 supprime la limite	52428800

L’envoi des événements à la plateforme ne peut pas être désactivé. Pour les envoyer ailleurs, modifiez OPENLATCH_API_URL.

Mises à jour et télémétrie

Variable	Ce qu’elle définit	Par défaut
OPENLATCH_AUTO_UPDATE	Les mises à jour automatiques : le daemon recherche régulièrement une nouvelle version et l’installe dès qu’aucun hook ne s’exécute. true ou 1 les active ; toute autre valeur les désactive. Équivaut à auto_update dans [update]	true
OPENLATCH_UPDATE_CHECK	La vérification de version au démarrage. false ou 0 la désactive. Équivaut à check dans [update]	true
OPENLATCH_NPM_REGISTRY	Le registre depuis lequel openlatch update télécharge	https://registry.npmjs.org
OPENLATCH_TELEMETRY_DISABLED	1 désactive la télémétrie d’usage	non définie
DO_NOT_TRACK	1 désactive la télémétrie d’usage, comme dans les autres outils qui suivent cette convention	non définie
OPENLATCH_CRASH_REPORTING	0, false, no ou off arrête les rapports de plantage, indépendamment de la télémétrie d’usage	activée

Les mises à jour automatiques ne s’exécutent jamais sur les runners de CI.

Fichier de configuration

config.toml dans le répertoire d’état contient les paramètres qu’écrivent les commandes, regroupés en sections. Les sections que vous lirez ou modifierez le plus probablement :

Section	Clé	Ce qu’elle définit
[policy]	enabled	L’évaluation locale des politiques, comme OPENLATCH_POLICY_ENABLED
[model_relay]	enabled	Le relais de modèle, comme OPENLATCH_MODEL_RELAY_ENABLED. openlatch system model-relay enable et disable l’écrivent
[cline]	plugin_delivery	La livraison du plugin OpenLatch aux hôtes Cline
[update]	auto_update · check	Les mises à jour automatiques et la vérification de version au démarrage
[proxy]	voir ci-dessous	La route empruntée par chaque requête sortante

La section [proxy]

openlatch init trouve la route seul quand il le peut et l’écrit ici. openlatch system proxy set, discover et clear la modifient ; préférez-les à la modification du fichier.

[proxy]
mode = "auto"
url = "http://proxy.corp:8080"
auth = "auto"
no_proxy = ".corp.example,10.0.0.0/8"
ca_bundle = "/etc/ssl/corp-root.pem"
allow_direct = true

Clé	Ce qu’elle définit
mode	auto cherche une route qui fonctionne, manual utilise exactement ce qui est défini et n’est jamais remplacé, direct n’utilise jamais de proxy
url	Le proxy, en http://, https://, socks5:// ou socks5h://. Elle ne contient jamais de nom d’utilisateur ni de mot de passe
username	Le compte avec lequel s’authentifier. Le mot de passe est dans le trousseau, jamais dans ce fichier
auth	auto choisit un schéma au démarrage du daemon ; basic, negotiate et none sont explicites
no_proxy	Destinations supplémentaires qui contournent le proxy, comme example.com, .example.com ou 10.0.0.0/8
ca_bundle	Un bundle PEM ajouté aux certificats approuvés, jamais à leur place
allow_direct	false refuse une connexion directe quand aucun proxy n’est utilisable (OL-1227)
spn	Le nom de service Kerberos du proxy
http1_only	Force HTTP/1.1, pour un proxy d’inspection qui gère mal HTTP/2
pac_url	Une URL explicite de configuration automatique du proxy. Refusée sur Linux (OL-1225)

Exécutez openlatch system proxy test après chaque modification pour vérifier la route.

Ce que le client écrit dans les réglages des agents

Tant que le relais de modèle est activé, le daemon dirige les appels de modèle de chaque agent détecté vers lui, et retire cette liaison quand vous arrêtez le daemon, désactivez le relais ou désinstallez. Une valeur que vous avez définie vous-même n’est jamais écrasée : openlatch doctor la signale à la place (OL-RELAY-SETTINGS).

Agent	Où va la liaison
Claude Code	Des clés d’environnement dans ses réglages : l’adresse du relais, un identifiant d’installation et des entrées de bouclage dans NO_PROXY
Codex CLI	Une entrée de fournisseur openlatch dans ~/.codex/config.toml
Cursor	L’adresse du relais dans les réglages utilisateur de l’IDE, et un wrapper de shell pour la CLI Cursor qu’un nouveau terminal prend en compte
Cline	Un point de terminaison local du relais par fournisseur configuré, dans les fichiers de réglages de Cline

Relier Claude Code au relais de modèle définit son ANTHROPIC_BASE_URL, ce qui désactive Claude Code Remote Control tant que le relais est activé. Sur une machine derrière un proxy, exportez aussi NO_PROXY=127.0.0.1,localhost dans le shell qui lance Codex CLI, pour que ses appels de modèle atteignent le relais local plutôt que le proxy de l’entreprise.

Exécutez openlatch system model-relay status pour voir quels agents ont leurs appels de modèle qui passent par le relais.