Toutes les pages
Sur cette page

L’explorateur de fichiers

📁 Browse files (Parcourir les fichiers) affiche les fichiers de la machine du relais sans quitter la conversation : le dossier dans lequel travaille l’agent, le reste de la machine, et le dossier que garde la session de l’agent. Vous l’utilisez pour voir ce que l’agent a modifié, ouvrir un fichier, copier une référence pour votre prochain message et faire du rangement. Le même explorateur sert à choisir un dossier quand vous démarrez une conversation ou changez son dossier de travail.

L’ouvrir #

Où Contrôle
Ordinateur Le bouton 📁 dans la rangée de la zone de saisie, avec l’info-bulle Browse files.
Téléphone Le bouton 🗂️ dans la rangée de la zone de saisie, avec l’info-bulle Open file explorer (Ouvrir l’explorateur de fichiers).

L’explorateur s’ouvre dans une boîte de dialogue par-dessus la conversation. Son titre indique dans quelle racine vous êtes : Repository Browser (Explorateur du dépôt), Drives Browser (Explorateur de lecteurs) ou Session Browser (Explorateur de session). Fermez-le avec × ou Escape.

Sur un ordinateur, la boîte de dialogue a deux volets côte à côte. Le volet de gauche, File tree (Arborescence), n’affiche que les dossiers. Le volet de droite affiche les fichiers du dossier ouvert, avec une barre de chemin au-dessus. Sur un téléphone, les deux volets sont l’un au-dessus de l’autre, l’arborescence en haut. Cliquez sur un dossier dans l’arborescence pour l’ouvrir. ⌖ Focus (Centrer) replie l’arborescence sur le dossier ouvert. Un compteur à côté indique combien d’entrées contient l’arborescence, par exemple 12 nodes dans le workspace et 12 entries ailleurs.

List (Liste) et Icons (Icônes) basculent le volet des fichiers entre lignes et cartes. Les cartes affichent une miniature pour les images.

Les trois racines #

Trois boutons à gauche de la barre d’outils choisissent ce que montre l’explorateur.

Bouton Racine Ce qu’il montre
💼 Workspace Le dossier de travail de la conversation, sous forme d’arborescence qui part de ce dossier.
📀 Lecteurs Toute la machine. Sous Windows, la liste des lettres de lecteur que signale le système, comme C:. Sous Linux et macOS, le dossier /.
🕵️ Session Le dossier propre à la session (voir Par fournisseur). Le bouton est désactivé tant que la conversation n’en a pas.

Quel dossier est le workspace #

La racine workspace est le dossier de travail de la conversation. Elle suit la conversation que vous avez ouverte, et une session en cours garde le dossier dans lequel elle travaille réellement. 🗂️ Change CWD (Changer le dossier de travail) dans le menu ⋯ de la conversation le déplace pour le prochain lancement de l’agent, ou tout de suite avec 🚀 Set new CWD and (re)launch (Définir le nouveau dossier de travail et lancer ou relancer) ; voir Le changer plus tard. Quand le dossier de travail change, l’explorateur abandonne ce qu’il avait ouvert et affiche le nouveau dossier. Taper cd dans un message de chat ne déplace pas l’explorateur.

Un chat Claude Cloud n’a ni dossier de travail sur votre machine ni explorateur de fichiers : l’agent travaille sur un clone chez Anthropic.

Les lecteurs et le dossier de session #

La racine des lecteurs atteint toute la machine, pas seulement le dossier de travail. La liste d’autorisation qui limite où un chat peut démarrer (workspaceRootAllowList, voir Limiter où les chats peuvent démarrer) ne limite pas ce que vous pouvez parcourir.

Le dossier de session liste les fichiers que le fournisseur de l’agent garde pour cette session. Vous pouvez les consulter et les ouvrir. Dans le Session Browser, l’explorateur ne propose que New folder (Nouveau dossier) : ni Rename (Renommer) ni Delete (Supprimer). C’est une règle de la page, pas du relais. Le même dossier, ouvert via 📀, propose Rename et Delete, et le relais ne les refuse pas.

La barre d’outils #

Contrôle Ce qu’il fait
💼 📀 🕵️ Changent de racine (voir plus haut).
List, Icons Basculent le volet des fichiers entre lignes et cartes.
Hidden: Off / Hidden: On (Masqués : Désactivé / Activé) Dans le workspace : affiche ou masque les entrées dont le nom commence par un point, sur toutes les plateformes. Dans les racines des lecteurs et de session, le bouton affiche Hidden/System: Off / Hidden/System: On (Masqués/Système : Désactivé / Activé). Sous Linux et macOS, il couvre les noms qui commencent par un point. Sous Windows, il couvre les entrées dotées de l’attribut caché ou système, et un nom qui commence par un point s’affiche dans tous les cas.
Heavy: Off / Heavy: On (Lourds : Désactivé / Activé) Affiche ou masque les dossiers nommés .git et node_modules (quelle que soit la casse) dans le workspace. Dans les autres racines, il affiche Heavy: n/a (Lourds : n/d) et est désactivé.
Refresh (Actualiser) Relit la racine ouverte. Les dossiers que vous aviez dépliés et le dossier ouvert restent tels quels.
📁+ New folder Crée un dossier dans le dossier ouvert (voir Dossiers et fichiers).

Hidden et Heavy sont tous deux désactivés la première fois. Un nom caché qui est aussi lourd a besoin des deux interrupteurs. Un changement prend effet tout de suite et actualise l’arborescence.

Votre navigateur retient les filtres : Hidden pour le workspace, Hidden pour les racines des lecteurs et de session (un seul réglage pour les deux), et Heavy. Il ne retient ni la racine, ni la vue, ni les dossiers ouverts : ceux-ci durent tant que la page reste ouverte, et survivent à Refresh ainsi qu’à la fermeture et à la réouverture de la boîte de dialogue, mais pas au rechargement de la page.

Ouvrir un fichier #

Cliquez sur un fichier dans le volet des fichiers pour l’ouvrir dans la visionneuse de fichiers. Dans le sélecteur de dossier (ci-dessous), les fichiers ne s’ouvrent pas.

Référencer un fichier ou un dossier dans votre message #

Deux contrôles copient une référence dans le presse-papiers, entourée d’accents graves. Ils ne la mettent pas dans la zone de saisie : vous la collez vous-même dans votre message.

Contrôle Où Copie
Copy @folder (Copier @folder) La barre de chemin au-dessus du volet des fichiers, dès qu’un dossier autre que la racine du workspace est ouvert (sous Linux et macOS, la racine des lecteurs / compte). @folder: et le chemin du dossier ouvert.
Le titre d’un fichier ouvert En haut de la visionneuse de fichiers. Cliquez dessus. @file: et le chemin du fichier.

Dans le workspace, le chemin est relatif au dossier de travail, comme @folder:src/components. Dans les racines des lecteurs et de session, c’est le chemin complet sur la machine. Ce que l’agent reçoit pour une référence, et la façon dont les images sont jointes, est décrit dans Références de fichiers.

Dossiers et fichiers #

Ajouté en 0.9.10 Vous pouvez créer des dossiers, renommer des fichiers et des dossiers, et les supprimer. Cela fonctionne dans le workspace et sur les lecteurs. Dans le dossier de session, l’explorateur ne propose que la création de dossiers.

Nouveau dossier #

📁+ New folder ouvre un champ de nom en haut du volet des fichiers. Tapez le nom et appuyez sur Enter : le dossier est créé dans le dossier ouvert et l’explorateur l’ouvre. Escape annule. Un avis indique Folder "name" created. Un nom déjà pris, ou que le système refuse, est signalé sous le champ, et le champ reste ouvert. Le bouton est désactivé tant que rien ne peut contenir de dossier, comme la liste des lecteurs sous Windows.

Le menu contextuel #

Faites un clic droit sur un dossier dans l’arborescence ou sur un fichier dans le volet des fichiers. Sur un téléphone, faites un appui long. Le menu propose :

Entrée Sur Ce qu’elle fait
📁 New folder here (Nouveau dossier ici) Dossiers Ouvre le dossier et y affiche le champ de nom.
Rename Fichiers et dossiers Transforme le nom en champ. Enter enregistre, Escape annule, et un nom inchangé vaut annulation.
Delete Fichiers et dossiers Ouvre la boîte de dialogue de suppression.

Rename et Delete ne sont proposés ni pour une racine (le dossier de travail, / ou un lecteur), ni pour quoi que ce soit dans le Session Browser. Un dossier que vous renommez garde sa place dans l’arborescence et reste ouvert.

Supprimer #

Delete demande d’abord au relais ce qui serait supprimé, et la boîte de dialogue vous le dit avant que quoi que ce soit ne disparaisse :

Ce que vous supprimez La boîte de dialogue indique
Un fichier Delete the file name?
Un dossier vide Delete the empty folder name?
Un dossier avec du contenu Delete the folder name and everything in it? et It contains 12 files and 3 folders. Au-delà de 10 000 entrées, le décompte s’arrête et la boîte de dialogue indique more than 10,000 entries.

Pour un dossier avec du contenu, le bouton rouge 🗑 Delete reste désactivé jusqu’à ce que vous tapiez le nom du dossier dans le champ Type the folder name to confirm (Saisissez le nom du dossier pour confirmer). La suppression retire le fichier ou le dossier du disque ; rien ne passe par une corbeille.

Noms et liens #

  • Un nom est un seul segment : il ne peut pas être vide, . ou .., ne peut pas contenir / ni \, et fait au plus 255 octets.
  • Quand le relais tourne sous Windows, un nom ne peut pas non plus contenir < > : " | ? * ni de caractères de contrôle, ne peut pas se terminer par un point ou une espace, et ne peut pas être un nom que Windows réserve, comme con ou nul.
  • Les noms sont comparés exactement : un nom déjà présent dans le dossier est refusé avec That name is already taken. Changer seulement la casse d’un nom est autorisé.
  • Un lien (lien symbolique) n’est jamais renommé ni supprimé : le relais le refuse avec Links cannot be changed here. L’arborescence du workspace ne liste pas les liens. Sous Linux et macOS, les racines des lecteurs et de session les listent, et affichent un lien vers un dossier comme un dossier, si bien que vous pouvez l’ouvrir et lire à travers ; seul le lien lui-même est protégé. Un chemin qui passe par un lien vers un dossier atteint quand même le dossier derrière. Dans le workspace, un lien qui mène hors du dossier de travail est refusé comme chemin non valide.
  • Une modification que le système d’exploitation n’autorise pas est signalée par Permission denied. Un renommage ou une suppression refusés apparaissent dans un avis ; un nouveau dossier refusé apparaît sous le champ de nom.

Comme sélecteur de dossier #

Le même explorateur choisit un dossier pour New chat (Nouveau chat) et pour 🗂️ Change CWD : appuyez sur 📁 à côté du champ de chemin. L’explorateur s’ouvre sur la racine des lecteurs, une barre en bas affiche le dossier sélectionné (ou Select a folder…), et ✅ Use this folder as CWD (Utiliser ce dossier comme dossier de travail) le renvoie. Les trois racines restent disponibles. Dans ce mode, les fichiers ne s’ouvrent pas, et Rename et Delete ne sont pas proposés ; 📁+ New folder et 📁 New folder here fonctionnent, si bien que vous pouvez créer un dossier de projet et le choisir d’un seul coup. Voir Le dossier de travail.

Limites #

  • L’arborescence du workspace charge un dossier à la fois, quand vous l’ouvrez. Les noms cachés et lourds sont laissés de côté jusqu’à ce que vous les activiez.
  • Un dossier que le relais ne peut pas lire s’ouvre vide au lieu d’afficher une erreur. Les entrées qu’il ne peut pas lire sont omises de la liste.
  • La racine de session est vide, sans erreur, pour une session Claude ou DeepSeek qui n’a encore écrit aucun fichier.

Par fournisseur #

L’explorateur est le même pour chaque fournisseur qui travaille dans un dossier sur la machine du relais. Ce qui diffère, c’est le dossier de session derrière 🕵️.

Fournisseur Le dossier de session (🕵️)
GitHub Copilot (moteur SDK et moteur d’extension) Le dossier du runtime pour la session, dans ~/.copilot/session-state (ou le dossier que désigne COPILOT_SESSION_STATE_DIR). Désactivé tant que le dossier n’existe pas.
OpenAI Comme pour GitHub Copilot : les chats OpenAI tournent sur le runtime Copilot, le dossier est donc du même type.
OpenAI Image Le même dossier session-state de Copilot ; les images générées s’y trouvent, dans generated-images. Voir OpenAI.
Claude Le dossier de la session dans l’espace des projets de l’Agent SDK, dans ~/.claude/projects (ou CLAUDE_CONFIG_DIR), avec le fil de la conversation de la session (un fichier .jsonl) listé dedans. Le dossier lui-même n’apparaît qu’une fois que la session écrit des fichiers de subagent ou de résultats d’outils. Voir Claude.
DeepSeek Ajouté en 0.9.17 Comme Claude, mais dans le dossier Claude Code propre à DeepSeek : dans data/deepseek-claude/projects dans le dossier d’état du relais, jamais dans ~/.claude. Voir DeepSeek.
Claude Cloud Pas d’explorateur de fichiers : l’agent travaille sur un clone chez Anthropic, et il n’y a ni dossier de travail ni dossier de session sur votre machine. Voir Claude Cloud.
Cursor Le stockage de l’agent pour la session, un dossier par conversation créé à son premier turn. Voir Cursor.
Grok Aucun : le relais ne garde pas de dossier de session pour Grok, le bouton reste donc désactivé.