Fichiers, captures d’écran et photos

Montrez un bug à l’agent comme vous le montreriez à un collègue : collez la capture d’écran, et l’agent reçoit son chemin et la lit. Dans l’autre sens, c’est aussi simple. Cliquez sur un chemin que l’agent affiche, et le fichier s’ouvre dans une visionneuse par-dessus le terminal, prêt à être lu, téléchargé ou partagé.

Coller des captures d’écran dans l’agent

Copiez une capture d’écran et appuyez sur ⌘V ou Ctrl+V dans le terminal. L’image est envoyée dans /uploads/clipboard/ de ce terminal et son chemin est collé au curseur ; Claude Code, Codex et OpenCode transforment ce chemin en image jointe.

• Les images jusqu’à 20 MB arrivent à l’agent comme images ; une plus grande part comme fichier.
• Avant l’envoi, l’image devient un WebP de 2500 px au plus sur son grand côté, la taille que lisent les agents : plusieurs fois plus légère que la capture, identique pour l’agent. Là où le WebP n’est pas disponible, elle part en JPEG, et une image qui ne deviendrait pas plus légère part telle quelle.
• Un fichier copié dans le Finder ou l’Explorateur se colle de la même façon : ⌘V envoie le fichier lui-même.
• Le collage d’image propre à Claude Code marche aussi : appuyez sur Ctrl+V dans Claude Code et il trouve l’image que vous venez de coller.

Au premier collage, le navigateur peut demander l’accès au presse-papiers ; le terminal vous renvoie vers cette demande, près de la barre d’adresse. Si le navigateur refuse le presse-papiers au site, autorisez-le dans les paramètres du site et collez de nouveau.

Déposer des fichiers sur le terminal

Faites glisser des fichiers de votre ordinateur sur le terminal ; il affiche « Déposez pour envoyer dans ce terminal ».

• Des fichiers jusqu’à la limite de votre forfait : 100 MB sur Start, 250 MB sur Pro, 500 MB sur Max, 1 GB sur Business, 2 GB sur Business Plus, 5 GB sur Business Max, 10 GB sur Business Ultra.
• Les fichiers vont droit dans votre terminal, par morceaux. Si la connexion tombe, l’envoi attend et reprend au dernier morceau arrivé ; rien ne recommence de zéro.
• Déposez-en plusieurs à la fois : leurs chemins sont collés sur une ligne, séparés par des espaces et échappés pour le shell quand un nom l’exige.
• Les images jusqu’à 20 MB rejoignent celles collées dans /uploads/clipboard/. Les autres fichiers arrivent dans /uploads/ sous leur propre nom ; un second fichier du même nom devient name (1).ext.
• Un dossier est refusé : compressez-le en zip et déposez le zip, ou déposez les fichiers qu’il contient.

Envoyer des photos depuis votre téléphone

Touchez Coller une photo dans la barre de touches sous le terminal. Le téléphone propose sa photothèque, l’appareil photo et ses fichiers ; choisissez une photo ou plusieurs.

• Une photo d’iPhone en HEIC devient un JPEG en route, car aucun agent ne lit le HEIC. AVIF, BMP et TIFF deviennent des PNG.
• Une photo de plus de 4096 × 4096 est réduite pour tenir dans ce cadre.
• Une photo que le navigateur ne sait pas convertir reste sur le téléphone, et le terminal vous dit laquelle.

Le bouton Coller de la barre de touches colle aussi une image du presse-papiers du téléphone. Téléphone détaille le reste de la barre de touches.

Suivre et annuler un envoi

Une pastille au-dessus du terminal affiche « Collage de l’image… » ou « Envoi de report.pdf… » avec sa progression en pourcentage. Appuyez sur Esc ou choisissez Annuler pour l’arrêter ; la partie déjà envoyée est effacée du terminal. Un dépôt à la fois, trois de ses fichiers en même temps. Tant que la connexion manque, la pastille affiche « Connexion perdue. On reprend là où ça s’est arrêté… », et l’envoi repart tout seul dès que vous êtes reconnecté.

Où vivent les fichiers envoyés

Seul ce terminal voit ses fichiers envoyés, et ils partent quand il se termine ou redémarre. Le terminal conserve les 50 images collées les plus récentes des dernières 24 heures : chaque nouveau collage efface les plus anciennes. Déplacez un fichier dans votre projet pour le garder.

Ouvrir les chemins de fichiers de la sortie

Les chemins que l’agent affiche deviennent des liens dès que le fichier existe : ils se soulignent quand vous pointez dessus. Faites ⌘-clic ou Ctrl-clic sur l’un d’eux, ou touchez-le sur un téléphone.

• Chemins absolus, ~/…, ./…, ../… et chemins comme src/app.ts.
• Un suffixe :line ou :line:col, comme src/app.ts:42, ouvre le fichier à cette ligne. Un nom seul comme app.ts devient un lien quand il porte une ligne.
• Les chemins relatifs partent du dossier où se trouve le shell à cet instant.
• Les liens file:// et ceux qu’affiche ls --hyperlink s’ouvrent aussi dans la visionneuse ; les liens web s’ouvrent dans un nouvel onglet du navigateur.

Ouvrir n’importe quel fichier par son chemin

Choisissez Ouvrir un fichier… dans le menu de commandes ⌘K, ou sur la page Fichiers et aperçus du terminal. Tapez un chemin absolu, un chemin depuis votre dossier personnel (~/…) ou un chemin relatif au dossier du terminal ; ajoutez :line pour y sauter.

Lire des fichiers dans la visionneuse

La visionneuse s’ouvre par-dessus le terminal ; sur un téléphone, elle prend tout l’écran. Son en-tête montre le dossier du fichier, sa taille et sa date de modification, et Échap la ferme.

• Le code, avec numéros de ligne et coloration pour 25 langages, Dockerfiles et Makefiles compris ; un lien :line centre la vue sur cette ligne et la met en évidence.
• Le Markdown, rendu comme sur GitHub. Le HTML brut qu’il contient est ignoré, et les images s’affichent sous forme de leur texte alternatif.
• Les images et les PDF. Sur un téléphone qui n’affiche que la première page d’un PDF, choisissez Ouvrir dans un nouvel onglet.
• Les CSV et TSV sous forme de tableau, les 1 000 premières lignes.
• Les longs journaux : un fichier de plus de 1 MB s’ouvre sur ses 256 derniers KB, et Charger les lignes précédentes remonte de 256 KB à la fois.
• Le HTML en source, avec Ouvrir en tant que page pour voir la page.
• Tout le reste : sa taille et son type, avec Télécharger.

Un chemin de dossier affiche « C’est un dossier », avec Ouvrir sur l’hôte de fichiers pour une liste de 2 000 entrées au plus.

La visionneuse affiche les fichiers jusqu’à 20 MB, et Télécharger accepte les fichiers jusqu’à 1 GiB. Copier le chemin copie le chemin absolu.

Partager un fichier par lien

1. Ouvrez le fichier dans la visionneuse et choisissez Partager un lien.
2. Sous Le lien est valable, choisissez 15 minutes, 1 heure, 1 jour ou 7 jours.
3. Choisissez Créer le lien, puis Copier le lien.

Toute personne qui a le lien peut télécharger ce fichier, et lui seul, sans compte, jusqu’à l’expiration du délai. La page Fichiers et aperçus du terminal liste ses liens sous Fichiers partagés : combien de fois chacun a été ouvert (pointez sur le nombre pour la dernière fois), quand il expire, un bouton pour le recopier et Révoquer pour y mettre fin plus tôt. Un terminal garde jusqu’à 50 liens actifs. Ses liens survivent à un redémarrage et prennent fin avec le terminal.

Ouvrir vos fichiers dans le navigateur

Chaque terminal a une adresse de fichiers : https://files-<terminal ID>.detachbox.dev/<absolute path>. Elle sert ce que ce terminal peut lire, avec la même connexion que les aperçus. Ouvrir en tant que page y affiche un rapport HTML ou un site compilé comme une page. Une page ouverte ainsi n’atteint que les fichiers de son propre dossier, et jamais les fichiers dont le nom commence par un point, comme .env, .git ou .detachbox.