Comment utiliser les agents Claude Code : Configuration, outils, permissions et workflow en sandbox

Pour bien utiliser les agents Claude Code, traitez Claude Code comme une boucle d’agent plutôt que comme une fenêtre de chat : lancez-le dans le dépôt que vous souhaitez modifier, donnez-lui des instructions claires sur le projet, connectez uniquement les outils dont il a réellement besoin, maintenez des permissions strictes, et exécutez-le dans un runtime isolé lorsque le workflow dépasse des modifications locales à faible risque. Telle est la différence entre une session de codage utile et une session coûteuse et désordonnée.

Si votre question principale est plus large que Claude Code lui-même, commencez par Que sont les agents de codage ? pour une vue d’architecture. Si vous choisissez d’abord entre les outils, comparez Claude Code vs Cursor. Ce guide est plus spécifique : comment utiliser les agents Claude Code en pratique.

Ce que les gens entendent généralement par « agents Claude Code »

La plupart des développeurs qui recherchent « agents Claude Code » désignent l’une des deux choses suivantes :

1. Claude Code lui-même agissant comme un agent de codage autonome.
2. Plusieurs agents spécialisés, outils ou sous-agents travaillant dans un workflow Claude Code.

Les deux sont valables. Claude Code se comporte déjà comme un outil de codage agentique : il peut inspecter un dépôt, modifier des fichiers, exécuter des commandes et réagir aux résultats. Anthropic documente également des blocs de construction connexes tels que les intégrations d’outils MCP, les hooks et les sous-agents, c’est pourquoi le terme apparaît souvent au pluriel.

Le modèle pratique est simple :

• Claude Code est le workflow hôte.
• Le modèle gère la planification et les décisions pour les prochaines étapes.
• Les outils fournissent l’accès aux fichiers, commandes, navigateurs, API et systèmes externes.
• Les permissions déterminent ce que Claude est autorisé à faire sans demander.
• Un sandbox vous offre un endroit sûr pour exécuter du code et des outils.

Si vous gardez ces cinq couches séparées, Claude Code devient beaucoup plus facile à utiliser de manière fiable.

Étape 1 : Installer Claude Code et démarrer dans le bon répertoire

Anthropic documente Claude Code comme une CLI installable. Le chemin d’installation standard est :

npm install -g @anthropic-ai/claude-code
claude

Le détail important n’est pas seulement l’installation. Lancez Claude Code depuis le dépôt sur lequel vous souhaitez qu’il travaille. Claude Code lit le répertoire courant, les instructions locales du projet et toute configuration d’outil à l’échelle du projet à partir de cet emplacement.

Si le dépôt est nouveau, exécutez :

/init

Cela génère un fichier CLAUDE.md de démarrage avec des instructions spécifiques au projet. Utilisez-le pour les choses que Claude doit se rappeler à chaque session : commandes de test préférées, normes de codage, limites d’architecture, attentes de révision et fichiers qu’il doit traiter avec précaution.

Cela compte plus que la plupart des utilisateurs ne le pensent. Un agent Claude Code sans instructions spécifiques au dépôt n’est généralement pas sous-alimenté. Il est sous-spécifié.

Étape 2 : Donner à l’agent une tâche qu’il peut réellement exécuter

Claude Code fonctionne mieux lorsque la tâche inclut un résultat concret et une étape de vérification.

Bons exemples :

• « Ajouter une limitation de débit à /login, mettre à jour les tests et exécuter le fichier de test concerné. »
• « Refactoriser le service de facturation pour utiliser le nouveau client, puis exécuter les tests unitaires pour ce package. »
• « Examiner le diff de cette PR pour les problèmes de sécurité et de correction. »

Les invites faibles sont généralement vagues de la mauvaise manière :

• « Améliorer ce code. »
• « Rendre l’application meilleure. »
• « Vérifier le projet. »

Les outils de codage agentiques font mieux lorsque la ligne d’arrivée est explicite. Si vous voulez de l’autonomie, définissez le succès. Si vous voulez de l’exploration, définissez le périmètre.

Étape 3 : Configurer uniquement les outils dont vous avez besoin

Claude Code utilise le Model Context Protocol pour les outils externes. En pratique, cela signifie que les serveurs MCP sont la surface d’extension pour les navigateurs, bases de données, gestionnaires de tickets, GitHub, exécuteurs de code et services internes.

La commande de configuration la plus courante est :

claude mcp add playwright -- npx -y @playwright/mcp@latest

Cela donne à Claude des outils d’automatisation de navigateur. La documentation MCP d’Anthropic et le guide de démarrage rapide couvrent le même modèle pour d’autres serveurs.

La règle de fonctionnement clé est la retenue : n’attachez pas tous les outils que vous pourriez un jour vouloir. Attachez le plus petit ensemble d’outils correspondant à la tâche. Trop d’outils augmentent le bruit au démarrage, élargissent la surface d’action et rendent la sélection des outils moins prévisible.

Pour la plupart des travaux sur un dépôt, un ensemble de départ raisonnable est :

• accès aux fichiers locaux et au shell
• un outil de navigateur si une QA web est nécessaire
• un outil de tickets ou de documentation si la tâche dépend d’un système externe

Tout le reste doit mériter sa place.

Étape 4 : Utiliser les permissions délibérément, pas après coup

L’une des plus grandes différences entre un workflow Claude Code sûr et un workflow imprudent est la discipline en matière de permissions.

Claude Code expose des contrôles de permissions car l’exécution d’outils est la véritable frontière de risque. Lire un fichier est une chose. Exécuter des scripts d’installation, supprimer des répertoires ou accéder à des services externes en est une autre.

Utilisez /permissions tôt dans un projet, surtout si la session peut :

• écrire dans de nombreux fichiers
• exécuter des commandes shell
• installer des packages
• accéder à des secrets ou systèmes internes
• appeler des outils MCP avec effets secondaires

La bonne configuration dépend de la tâche :

• Pour le débogage exploratoire, demander avant d’exécuter est généralement le défaut plus sûr.
• Pour un travail de dépôt répétitif et bien délimité, les règles d’autorisation peuvent réduire les interruptions.
• Pour les commandes à haut risque ou les chemins sensibles, les règles de refus doivent rester explicites.

C’est aussi là que de nombreuses équipes font la mauvaise optimisation. Elles suppriment les frictions en ouvrant les permissions trop largement, puis tentent de retrouver le contrôle avec le seul libellé de l’invite. C’est l’inverse. L’invite est un guide. Les permissions sont une mesure d’exécution.

Étape 5 : Comprendre la boucle d’agent réelle

Claude Code semble puissant lorsque vous comprenez ce qui se passe sous le capot.

La boucle ressemble généralement à ceci :

1. Claude lit la tâche et le contexte du projet.
2. Il planifie la prochaine étape utile.
3. Il lit des fichiers ou appelle des outils.
4. Il modifie le code ou exécute une commande.
5. Il vérifie la sortie.
6. Il révise le plan en fonction de ce qui s’est passé.
7. Il s’arrête lorsque le résultat demandé est complet.

Cette boucle explique pourquoi les workflows d’agents sont différents de l’utilisation normale d’un chatbot. Le modèle ne se contente pas de générer du code. Il coordonne l’état entre les outils, les fichiers, les sorties de commandes et les échecs intermédiaires.

Pour un travail réel sur un dépôt, les parties les plus importantes ne sont généralement pas la première réponse. Ce sont les étapes de récupération après le premier échec de test, l’erreur de lint ou l’inadéquation d’environnement.

Étape 6 : Utiliser des sous-agents lorsque la spécialisation est utile

Claude Code inclut désormais la prise en charge des sous-agents car un agent polyvalent n’est pas toujours le mieux adapté à chaque tâche.

Les sous-agents sont pertinents lorsque le workflow bénéficie de la spécialisation, par exemple :

• un agent pour l’implémentation
• un agent pour la revue de code
• un agent pour la documentation
• un agent pour l’investigation de tests

Cela ne signifie pas que chaque projet a besoin d’un essaim. Dans les petits dépôts, plusieurs agents peuvent ajouter des frais généraux plus rapidement qu’ils n’ajoutent de valeur. Mais pour les équipes ayant des transferts répétables, les sous-agents sont utiles car ils vous permettent d’encoder des instructions et responsabilités plus étroites.

Le principe de fonctionnement est le même que celui que les bonnes équipes d’ingénierie utilisent déjà : séparer les rôles lorsque les limites sont suffisamment claires pour être utiles.

Si vous ne pouvez pas expliquer pourquoi un deuxième agent existe, vous n’en avez probablement pas besoin.

Étape 7 : Utiliser des hooks pour le contrôle et l’auditabilité

Les hooks sont la bonne réponse lorsque vous souhaitez que les sessions Claude Code déclenchent des vérifications prévisibles à des points spécifiques du workflow.

Exemples :

• exécuter le formatage après les modifications de fichiers
• journaliser les modifications de fichiers après les opérations d’écriture
• bloquer les commandes touchant des chemins protégés
• envoyer des événements dans une piste d’audit locale

Les hooks sont importants car ils rendent le workflow moins dépendant du fait que le modèle se souvienne de chaque politique à chaque fois. Si une étape doit toujours se produire après une catégorie d’action, automatisez cette limite au lieu d’espérer que l’invite de session soit suffisante.

C’est particulièrement important une fois que Claude Code fait partie d’un processus d’équipe répétable plutôt que d’un outil individuel ponctuel.

Où Novita s’intègre dans une pile d’agents Claude Code

Claude Code est l’interface agent. Ce n’est pas toute la pile.

Une fois qu’une équipe utilise Claude Code sérieusement, deux questions d’infrastructure distinctes apparaissent :

1. Quel backend de modèle doit gérer le raisonnement ?
2. Où l’exécution des outils doit-elle réellement s’exécuter ?

Ce sont exactement les endroits où Novita s’intègre naturellement.

Utiliser Novita LLM API pour la flexibilité du backend

Novita documente un point de terminaison compatible Anthropic pour les workflows de style Claude Code. Cela signifie que vous pouvez conserver le modèle d’interaction Claude Code tout en dirigeant le trafic du modèle vers des modèles hébergés par Novita au lieu d’une seule route par défaut.

Le modèle d’environnement standard est :

export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<your-novita-api-key>"
export ANTHROPIC_MODEL="qwen/qwen3-coder-480b-a35b-instruct"

Cette configuration est utile lorsque vous souhaitez comparer différents modèles de codage sans reconstruire votre couche d’outils.

Cela crée également un chemin plus naturel pour les équipes qui veulent l’ergonomie de Claude Code mais pas une hypothèse de fonctionnement à modèle unique. L’interface reste familière ; le backend devient testable.

Utiliser Novita Agent Sandbox pour l’isolation d’exécution

La seconde moitié du problème est l’exécution.

Un agent Claude Code qui ne fait que lire et écrire de petits fichiers locaux est une chose. Un agent Claude Code qui exécute des commandes, installe des packages, lance des navigateurs, télécharge des dépendances ou touche à des systèmes de type production en est une autre.

C’est là qu’un runtime isolé cesse d’être facultatif et commence à faire partie de la conception.

Novita Agent Sandbox est positionné exactement pour cette couche : des environnements isolés pour l’exécution de code, le travail sur le système de fichiers, l’automatisation de navigateur et les workflows d’agents de longue durée. En d’autres termes, il couvre la partie de la pile où les effets secondaires se produisent.

Le modèle mental clair est :

• utiliser Claude Code pour le workflow agent
• utiliser Novita LLM API pour le routage et l’expérimentation de modèles
• utiliser Novita Agent Sandbox pour des limites d’exécution sûres

Garder le raisonnement et l’exécution séparés est généralement la meilleure architecture à long terme.

Une option de modèle ouvert pratique dans le même workflow

Une fois que vous avez Claude Code qui fonctionne bien, la question suivante n’est généralement pas « Cela peut-il utiliser des agents ? » C’est « Quel backend vaut-il la peine de payer chaque jour ? »

C’est là que les modèles de codage à poids ouverts deviennent intéressants de manière très pratique. Si votre équipe aime l’interface de Claude Code mais souhaite une expérimentation moins coûteuse ou plus de flexibilité de fournisseur, un modèle ouvert peut être le prochain benchmark approprié.

Un candidat crédible est Qwen3-Coder-480B-A35B-Instruct via la route compatible Anthropic de Novita. Vous n’avez pas besoin de le considérer comme un remplacement garanti de Claude pour chaque tâche. Vous devez le considérer comme une option sérieuse de modèle de codage qui appartient au même ensemble d’évaluation que les alternatives fermées.

C’est le changement naturel que de nombreuses équipes effectuent :

• garder le workflow agent
• garder les outils
• garder le modèle de permissions
• changer le backend et comparer les résultats réels des tâches

Si le travail est dominé par la navigation dans le dépôt, l’implémentation simple et l’appel d’outils plutôt que par un raisonnement de pointe, un modèle ouvert peut être suffisamment compétitif pour justifier le test.

C’est l’une des choses les plus utiles à propos de la configuration Novita : elle vous permet de comparer cette question dans un workflow Claude Code familier plutôt que de transformer le benchmark en projet de migration.

Erreurs courantes lors de l’utilisation des agents Claude Code

La plupart des échecs proviennent de la conception du workflow, pas de l’idée du codage agentique elle-même.

Donner à l’agent des objectifs larges sans ligne d’arrivée

Si vous voulez des résultats fiables, précisez le livrable et comment le vérifier.

Attacher trop d’outils

Plus d’outils ne rendent pas automatiquement Claude plus intelligent. Ils rendent généralement le routage plus bruyant.

Traiter les permissions comme une nuisance UX

Les permissions sont le plan de contrôle pour les effets secondaires. Elles doivent être ajustées, pas contournées.

Exécuter des actions risquées directement sur une machine de développeur

Si l’agent effectue de l’automatisation de navigateur, des installations de packages ou une exécution répétitive de commandes, utilisez un runtime isolé.

Confondre une démo utile avec un workflow de production

Une démo de Claude Code peut être belle en cinq minutes. Un workflow de production nécessite politique, audit, isolation d’exécution et discipline de choix de modèle.

Workflow recommandé pour la plupart des équipes

Si vous voulez un défaut pragmatique, utilisez cet ordre :

1. Lancez Claude Code dans le dépôt cible.
2. Exécutez /init et rendez CLAUDE.md utile.
3. Attachez uniquement les outils MCP nécessaires à la tâche.
4. Configurez /permissions avant une exécution large.
5. Utilisez un sandbox lorsque le workflow exécute du code réel ou des étapes de navigateur.
6. Évaluez au moins un backend alternatif via Novita avant de standardiser les hypothèses de coût.

Cette séquence maintient le système compréhensible. Elle vous évite également de mélanger l’ergonomie du produit, la qualité du modèle, la prolifération des outils et la sécurité d’exécution en une seule décision floue.

FAQ

Claude Code est-il lui-même un agent ?

Oui. Claude Code est un workflow de codage agentique plutôt qu’un simple outil de complétion de code. Il peut inspecter des fichiers, modifier du code, exécuter des commandes et réagir aux résultats des outils.

Ai-je besoin de MCP pour utiliser les agents Claude Code ?

Non. Claude Code est utile avec un simple accès au dépôt local. MCP devient important lorsque vous voulez des outils externes tels que des navigateurs, bases de données, API ou systèmes de tickets.

Quand dois-je utiliser un sandbox avec Claude Code ?

Utilisez-en un lorsque le workflow exécute du code, installe des packages, lance des navigateurs ou effectue des actions répétées avec effets secondaires que vous ne voulez pas exécuter directement sur l’hôte.

Claude Code peut-il utiliser des modèles via Novita ?

Novita documente une configuration compatible Anthropic pour les workflows de style Claude Code, vous pouvez donc conserver l’interface Claude Code tout en routant les requêtes de modèle via des modèles hébergés par Novita.

Dois-je utiliser plusieurs sous-agents immédiatement ?

Généralement non. Commencez avec un agent et ajoutez des sous-agents uniquement lorsque la spécialisation est suffisamment claire pour réduire la confusion plutôt que de la créer.

Articles recommandés

• Plugins Claude Code : Comment les outils MCP étendent Claude Code avec des capacités externes
• Modèles pris en charge par Claude Code en 2026 : Lequel devriez-vous utiliser ?
• Que sont les agents de codage ? Comment ils fonctionnent et comment en construire un

Sources vérifiées le 24 août 2026 : Anthropic Claude Code overview, Anthropic Claude Code settings and permissions, Anthropic Claude Code hooks, Anthropic Claude Code subagents, Anthropic Claude Code MCP, Novita Claude Code guide, et Novita Sandbox overview.