Cette page est traduite de la documentation anglaise. Les commandes, identifiants et exemples sont inchangés. Runtime 7.24.4 · SDK 2.6.7. Source anglaise

Documentation d'AX Code

Statut : actif Portée : public, état actuel Dernière revue : 2026-10-09 Responsable : mainteneurs d’AX Code

AX Code est un runtime d’agent de programmation pour un travail révisable et réversible : chaque session est enregistrée comme un journal d’événements structuré avec des instantanés de fichiers, les implémentations candidates peuvent être vérifiées contre les contrôles propres au dépôt, et rien ne fusionne automatiquement. Pourquoi AX Code explique ce que cela optimise, à qui cela s’adresse, et ce que le produit s’interdit de prétendre.

Le README racine est le plus court chemin pour installer et lancer AX Code. Utilisez ce hub lorsque vous devez configurer un flux, comprendre une frontière du runtime ou intégrer AX Code à un autre système.

Les dossiers de processus internes (PRD, ADR, spécifications, feuilles de route, plans d’implémentation, revues concurrentielles et fichiers de travail d’audit) vivent sous .internal/, et non dans cet arbre public — voir « Frontières de la documentation » plus bas. Les pages publiques sont celles qui sont liées ici.

Site public : ax-code.app/fr/docs/. Pour les installations existantes, commencez par Mise à niveau et reprise. L’accès aux sources et les téléchargements publics sont distincts ; voir Accès aux sources.

Choisir selon la tâche

Pour une navigation de terminal partagée, sur activation, via un client MCP externe, voir Partager un TUI en direct via MCP.

Pour le pont navigateur expérimental (lire des pages, et au choix cliquer et remplir), voir Pont navigateur WebMCP.

Pour des questions autonomes sur des fichiers choisis, via le cache d’AX Trust, voir Questions à contexte fixe.

Prise en main

• Standard et Business — Standard open source, usage commercial gratuit, Business propriétaire prévu, et statut d’accès public.

• Pourquoi AX Code — ce qu’AX Code optimise, son public visé, en quoi il diffère, et ce qu’il ne prétend pas.

• Commencer ici — modèle mental du produit et chemins les plus courts selon l’usage.

• Canaux d’installation et de runtime — plateformes prises en charge, paquets, mises à jour et lanceurs de contributeurs.

Guides d'exécution

• Visualisation des preuves Wiki — ouvrir un graphe local des relations page/source Wiki enregistrées, ou exporter du HTML hors ligne. Inclut des captures radiales, de force et centrées sur une page, issues du wiki d’AX Code.
• Récapitulatif de conversation — reprendre le travail récent avec /recap et configurer les bandeaux d’inactivité.
• Notifications audio — sons système et alertes parlées, sur activation, lorsqu’une exécution demande votre attention.
• Preuves d’exécution — graphe, comparaison, relecture, risque, retour arrière, branche, trace et export d’audit.
• Changements multi-modèles vérifiés — le flux conseil et arène, de bout en bout.
• Mode bac à sable — modes d’isolation, chemins protégés, contrôles réseau et priorité.
• Mode opérations cloud — flux planifier/approuver/appliquer, jetons d’approbation et posture de l’agent cloudops.
• Mode autonome — exécution sans surveillance, approbations, usage sans interface et garde-fous.
• CLI sans interface — la commande ponctuelle ax-code run pour les scripts, la CI et les appelants agents.
• Langues et configuration du TUI — langues de l’interface et de la conversation, configuration initiale.
• Animations du TUI — paires d’ouverture et de fin, capacités du terminal et replis de rendu.
• Mode boucle et tâches planifiées — invites récurrentes, planifications durables et limites des longues exécutions.
• Opérations de longue durée — exemples de services supervisés, sémantique de reprise et contrôles opérationnels.
• Modes d’exécution — comportement de l’agent, de l’hybride, du conseil et de l’arène.
• Bonnes pratiques de routage multi-modèles — séparer le raisonnement premium et le travail de soutien moins coûteux sans affaiblir en silence les tâches sensibles à la justesse.
• Reprise de modèle — sélection exacte du modèle, configuration explicite du repli et diagnostics.
• Routage automatique — routage vers les spécialistes et routage de complexité facultatif.
• Effort du modèle — niveaux de réflexion et comportement propre à chaque fournisseur.
• Performance — profils d’outils de programmation et diagnostics locaux de durée des requêtes.
• Utilisation de la mémoire — profils mémoire, rétention du cache et limites de sortie en arrière-plan.
• Cache local de preuves — réutilisation facultative des preuves SQLite et RocksDB, qualification et retour arrière.
• Crochets de cycle de vie — événements de crochet et paquets de politique fournis.
• Rapport d’exécution — usage de l’espace de travail, activité, répartitions modèle/outil et rapports par session.

Fournisseurs

• Fournisseurs et modèles pris en charge — identifiants de fournisseurs, authentifiants et découverte de modèles.
• Démarrage rapide des API gratuites — parcours sans coût compatibles, contraintes et évaluation prudente.
• Fournisseurs personnalisés et passerelles — points de terminaison compatibles OpenAI et Anthropic.
• Configuration de MTPLX et d’oMLX — préréglages locaux de checkout, découverte, outils et authentification.
• Synthèse des pairs Tiel (20 septembre 2026) — chiffres actuels de l’API native Tiel / Cyber-Tiel face à MTPLX ; défaut d’achèvement 194.88, pic de décodage 249.01.
• Nouveau test client AX Code/OpenCode — six combinaisons client/runtime, MTP actif, temps de premier passage et de répétition, et contrôles de code.
• Mesures d’inférence locale — tests datés d’AX Code, d’OpenCode et du runtime, avec les limites de chronométrage et de comparabilité.
• Sélection de modèles AX Engine — classement des modèles locaux et guide de mémoire.

Intégrations

• Intégrations MCP — confiance, permissions, ressources et sécurité des serveurs.
• Protocole ACP — chemin nominal du protocole Agent Client Protocol pour les hôtes d’IDE.
• AX Wiki — connaissance du dépôt appuyée sur les sources, et flux CI.
• Intégration VS Code — commandes de l’éditeur, réglages et flux de travail. Installez depuis la fiche Marketplace.

SDK et frontières de service

• @defai-digital/ax-code-sdk — intégration TypeScript et JavaScript de première partie.
• Transport SDK natif — frontière de bureau ou native calquée sur gRPC, et comportement de repli.
• Compatibilité HTTP et OpenAPI — mode serveur et clients générés pour d’autres langages.
• Instantané OpenAPI — contrat de référence des routes HTTP et des schémas.

Architecture et fiabilité

• Couche sémantique — provenance du graphe et du LSP, audit et frontières de relecture.
• Architecture du moteur local — pourquoi AX Code utilise un sidecar AX Engine.
• Stabilité du runtime — contrats de fiabilité pour l’annulation, le plantage, le flux, le délai et le TUI.

Référence

• Schéma JSON de configuration — contrat d’entrée de la configuration générée.

• Prise en charge native de TypeScript — compilateur de sources, service de langage, diagnostics et compatibilité.

• Catalogue des skills et des plugins — skills fournis, skills de projet, plugins et évaluations.

• Paquets de politique d’isolation — exemples de politique lisibles par une machine.

• Vérification des versions — clé publique Minisign canonique et commande de vérification.

• Intégrité du runtime Windows — signatures, vérification des fichiers installés et preuves antivirus.

• Politique de sécurité — modèle de menace, stockage des identifiants et versions prises en charge.

Frontières de la documentation

docs/ contient les consignes publiques pour un comportement présent dans un runtime publié. Le matériau de planification, les cibles de version, la politique d’implémentation et les analyses temporaires n’ont pas leur place ici :

Chaque page Markdown publique doit déclarer, près du haut, son statut, sa portée, sa date de dernière revue et son responsable. Préférez des liens vers des contrats générés ou des sources d’implémentation, plutôt que des listes de routes copiées et d’autres instantanés à forte dérive.

Liste de contrôle de maintenance

Avant une version ou un changement substantiel de la documentation :

1. Vérifiez les commandes, les valeurs par défaut, les indicateurs, les identifiants de fournisseurs et les libellés de runtime contre leur implémentation.
2. Mettez à jour le guide faisant autorité le plus étroit, au lieu de répéter le même comportement sur plusieurs pages d’entrée.
3. Exécutez pnpm run test:scripts pour détecter les liens locaux cassés, les pages orphelines et les métadonnées de page manquantes.
4. Mettez à jour le manifeste d’export approuvé et exécutez node script/export-public-docs.mjs --website /path/to/ax-code.app, puis lancez le contrôle du site, la construction et les contrôles de fumée Workers. Les constructions du site utilisent l’instantané enregistré et n’exigent pas d’accès aux sources. Les nouvelles pages et ressources publiques doivent être approuvées explicitement dans le manifeste.
5. Conservez les propositions, les notes de développement du projet, les cibles de version et les archives de décisions historiques sous .internal/, et non dans la navigation publique.