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

Commencer ici

Statut : actif Portée : état actuel Dernière revue : 2026-09-16 Responsable : runtime AX Code

Si le README racine est le chemin le plus rapide pour installer AX Code, cette page est le chemin le plus rapide pour le comprendre.

Éditions et disponibilité

Commencez par AX Code Standard, l’édition à source ouverte, gratuite pour un usage personnel et commercial. Utilisez des modèles locaux ou cloud ; AX Engine fournit un chemin d’inférence locale natif sur les Mac Apple Silicon pris en charge. Les permissions existantes, la revue des changements et les preuves d’exécution locale restent des capacités centrales.

Business est une offre propriétaire prévue pour la gouvernance d’organisation via AX Trust et les flux métier via AutomatosX. Utiliser Standard au travail n’exige pas, en soi, une licence Business. Voir Standard et Business pour le détail.

Les installateurs signés et les archives de runtime sont disponibles de façon anonyme depuis download.ax-code.com. Lisez le guide d’installation et le guide de mise à niveau et de reprise. La documentation technique publique est hébergée sur ax-code.app/fr/docs/, indépendamment de l’accès aux sources. Déjà installé ? Ouvrez un terminal dans votre projet, exécutez ax-code, puis utilisez /connect dans le TUI pour choisir un fournisseur. Commencez par une question sur le projet, demandez un petit changement, puis revoyez le diff et les contrôles du projet avant de valider. Utilisez ax-code doctor si le runtime installé doit être diagnostiqué.

Ce qu'est AX Code

AX Code est un runtime de programmation par IA. Il réunit :

• des agents pour différentes tâches de programmation
• une exécution d’outils explicite
• le choix du modèle et du fournisseur
• un état de session persistant
• une isolation et des permissions configurables
• des surfaces d’intégration telles que le TUI, le SDK, le mode serveur et MCP

Cela compte, parce que la programmation par IA n’est utile dans de vrais dépôts que si vous pouvez contrôler ce que l’agent a le droit de faire, conserver le contexte d’une session à l’autre et réutiliser le même flux hors d’une seule fenêtre de conversation.

D'où vient la valeur

AX Code optimise le moment après la fin de l’agent : décider s’il faut garder ce qu’il a produit.

• Preuves. Chaque session est enregistrée comme un journal d’événements typés, plus des instantanés de fichiers, afin que ax-code graph, compare, replay, risk et audit puissent reconstruire ce qui s’est passé une fois la conversation terminée.
• Vérification. Là où une barrière est applicable — candidats d’arène, application de refactorisation sous barrière — les commandes de vérification de types, de lint et de test de votre dépôt décident si un résultat est accepté.
• Réversibilité. Les instantanés sont récupérables étape par étape, et pas seulement par session, depuis un dépôt d’objets Git conservé hors de votre dépôt.
• Votre décision. AX Code classe, note et rapporte. Il ne fusionne pas à votre place.

Pour soutenir cela : des outils explicites avec des règles de permission et des modes d’isolation, des sessions durables, AGENTS.md pour les conventions du dépôt, la portabilité des fournisseurs, et un seul runtime derrière le TUI, la CLI, l’extension VS Code, le SDK, le serveur sans interface et les intégrations MCP. Ce sont des fondations, plutôt que la raison de choisir AX Code — voir Pourquoi AX Code.

Pour les commandes elles-mêmes, voir Preuves d’exécution.

Modèle mental

Voyez AX Code comme cinq couches :

1. Couche fournisseur : choisissez le backend de modèle sur lequel exécuter.
2. Couche agent : choisissez l’agent adapté à la tâche, ou laissez le routage aider.
3. Couche outils : l’agent agit par des outils explicites, et non par des capacités cachées.
4. Couche session : la conversation, les décisions et l’état persistent.
5. Couche de contrôle : l’isolation, les permissions et le comportement d’audit définissent la frontière.

Le reste de la documentation se rapporte à ces couches.

Choisir la suite

Je veux l'essayer rapidement

• Commencez par le README racine pour l’installation et le premier lancement.
• Les chemins d’installation pris en charge utilisent le runtime compilé :
  • Installateur de version Bash pour macOS Apple Silicon et Linux : curl -fsSL -H "Accept: application/vnd.github.raw+json" "https://api.github.com/repos/defai-digital/ax-code/contents/install?ref=main" | bash
  • Alternative Homebrew pour la CLI macOS : brew tap defai-digital/tap && brew trust defai-digital/tap && brew install defai-digital/tap/ax-code
  • Installateur de version GitHub pour PowerShell Windows : powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://download.ax-code.com/install.ps1 | iex"
• L’installateur Bash n’est pas le chemin canonique d’installation sous Windows.
• Les paquets npm ne sont plus des canaux d’installation ou de mise à niveau pris en charge. Voir Canaux d’installation et de runtime pour la politique des plateformes, les libellés de runtime et la matrice des lanceurs locaux.
• Utilisez /connect ou ax-code providers login pour définir un modèle. Voir Fournisseurs et modèles pris en charge pour les fournisseurs d’API cloud, les fournisseurs CLI, AX Engine et les identifiants de modèles. Pour un parcours d’évaluation sans coût, utilisez le démarrage rapide des API gratuites.
• Exécutez ax-code init après avoir ouvert un vrai projet, afin que AGENTS.md capture les conventions locales.
• Si vous voulez des frontières de sûreté plus strictes, activez le mode bac à sable avant des modifications plus larges.

Je veux l'utiliser en sécurité dans un dépôt d'équipe ou d'entreprise

• AX Code démarre avec le mode autonome activé et le mode bac à sable désactivé : full-access, avec un accès illimité au système de fichiers et au réseau.
• Pour un travail d’équipe, d’entreprise, non fiable ou sans surveillance, activez --sandbox workspace-write (ou read-only) avant de commencer la tâche.
• Lisez Mode bac à sable pour les frontières d’exécution.
• Lisez Mode autonome si l’agent doit s’exécuter sans surveillance.
• Lisez Politique de sécurité pour le modèle de menace et le stockage des identifiants.
• Lisez Couche sémantique si la provenance et la relecture comptent pour votre flux.

Je veux l'intégrer ou l'automatiser

• Utilisez les points d’entrée sans interface ou gRPC de @defai-digital/ax-code-sdk pour une intégration d’application TypeScript.
• Utilisez Compatibilité HTTP et OpenAPI pour une frontière de service, des clients générés et le contrat OpenAPI de référence.
• Utilisez ax-code mcp add lorsque l’agent a besoin d’outils ou de services externes.

Je veux comprendre le dépôt ou transmettre un retour

• Lisez le hub de documentation pour le reste de la documentation publique.
• Lisez CONTRIBUTING.md pour la politique actuelle de contribution externe.

Quand AX Code peut ne pas convenir

AX Code est volontairement plus qu’une autocomplétion ou une boîte de dialogue hébergée. Il peut être trop lourd si :

• Vous n’avez besoin que de suggestions de code en ligne et ne voulez pas que des agents exécutent des outils.
• Vous avez besoin d’une expérience uniquement SaaS hébergée, sans runtime local.
• Vous n’avez pas besoin de persistance de session, de relecture, d’intégration SDK ou serveur, ni d’instructions au niveau du dépôt.
• Vous travaillez dans un environnement où aucun processus CLI local n’est autorisé.

Dans ces cas, un assistant d’éditeur plus léger peut être plus simple. AX Code est le plus fort lorsque l’agent doit agir dans de vrais flux de développement, avec contrôle, continuité et frontières d’intégration.

Premières commandes courantes

ax-code
ax-code providers login
ax-code models
ax-code run --model qwen -- "Review this change"
ax-code init
ax-code index
ax-code mcp add
ax-code doctor

Grok s’exécute exclusivement via Grok Build CLI. Sélectionnez grok-build-cli dans /connect ; AX Code invoque la commande locale grok et réutilise sa connexion et sa session CLI. L’ancien fournisseur d’API cloud direct xai n’est plus pris en charge.

Carte de la documentation