El explorador de archivos

📁 Browse files (Explorar archivos) muestra los archivos de la máquina del relay sin salir de la conversación: la carpeta en la que trabaja el agente, el resto de la máquina y la carpeta que guarda la propia sesión del agente. Lo usas para ver qué cambió el agente, para abrir un archivo, para copiar una referencia para tu siguiente mensaje y para poner orden. El mismo explorador elige una carpeta cuando inicias una conversación o cambias su carpeta de trabajo.

Abrirlo #

El explorador se abre como un cuadro de diálogo sobre la conversación. Su título indica en qué raíz estás: Repository Browser (Explorador del repositorio), Drives Browser (Explorador de unidades) o Session Browser (Explorador de la sesión). Ciérralo con × o con Escape.

En un escritorio, el cuadro de diálogo tiene dos paneles uno junto al otro. El panel izquierdo, File tree (Árbol de archivos), solo muestra carpetas. El panel derecho muestra los archivos de la carpeta abierta, con una barra de ruta encima. En un teléfono, los dos paneles van uno encima del otro, con el árbol arriba. Haz clic en una carpeta del árbol para abrirla. ⌖ Focus (Enfocar) pliega el árbol hasta la carpeta abierta. Un contador al lado muestra cuántas entradas contiene el árbol, por ejemplo 12 nodes en el workspace y 12 entries en los demás casos.

List (Lista) e Icons (Iconos) cambian el panel de archivos entre filas y tarjetas. Las tarjetas muestran una miniatura para las imágenes.

Las tres raíces #

Tres botones a la izquierda de la barra de herramientas eligen lo que muestra el explorador.

Qué carpeta es el workspace #

La raíz del workspace es la carpeta de trabajo de la conversación. Sigue a la conversación que tienes abierta, y una sesión en curso conserva la carpeta en la que realmente trabaja. 🗂️ Change CWD (Cambiar la carpeta de trabajo) en el menú ⋯ de la conversación la cambia para el siguiente arranque del agente, o al instante con 🚀 Set new CWD and (re)launch (Fijar la nueva carpeta de trabajo e iniciar o reiniciar); consulta Cambiarla más tarde. Cuando cambia la carpeta de trabajo, el explorador descarta lo que tenía abierto y muestra la carpeta nueva. Escribir cd en un mensaje del chat no mueve el explorador.

Un chat de Claude Cloud no tiene carpeta de trabajo en tu máquina ni explorador de archivos: el agente trabaja en un clon en Anthropic.

Las unidades y la carpeta de la sesión #

La raíz de unidades llega a toda la máquina, no solo a la carpeta de trabajo. La lista de carpetas permitidas que limita dónde puede empezar un chat (workspaceRootAllowList, consulta Limitar dónde pueden empezar los chats) no limita lo que puedes explorar.

La carpeta de la sesión enumera los archivos que el proveedor del agente guarda para esta sesión. Puedes mirarlos y abrirlos. En el Session Browser, el explorador solo ofrece New folder (Nueva carpeta): ni Rename (Renombrar) ni Delete (Eliminar). Es una regla de la página, no del relay. La misma carpeta, abierta a través de 📀, ofrece Rename y Delete, y el relay no los rechaza.

La barra de herramientas #

Hidden y Heavy están ambos desactivados la primera vez. Un nombre oculto que además es pesado necesita los dos interruptores. Un cambio surte efecto al instante y actualiza el árbol.

Tu navegador recuerda los filtros: Hidden para el workspace, Hidden para las raíces de unidades y de sesión (un solo ajuste para ambas) y Heavy. No recuerda la raíz, la vista ni qué carpetas estaban abiertas; eso dura mientras la página sigue abierta, y sobrevive a Refresh y a cerrar y volver a abrir el cuadro de diálogo, pero no a recargar la página.

Abrir un archivo #

Haz clic en un archivo del panel de archivos para abrirlo en el visor de archivos. En el selector de carpetas (abajo) no se pueden abrir archivos.

Hacer referencia a un archivo o una carpeta en tu mensaje #

Dos controles copian una referencia al portapapeles, entre comillas invertidas. No la ponen en el área de redacción: la pegas tú en tu mensaje.

En el workspace, la ruta es relativa a la carpeta de trabajo, como @folder:src/components. En las raíces de unidades y de sesión es la ruta completa en la máquina. Lo que recibe el agente por una referencia, y cómo se adjuntan las imágenes, está en Referencias a archivos.

Carpetas y archivos #

Nuevo en 0.9.10 Puedes crear carpetas, renombrar archivos y carpetas, y eliminarlos. Esto funciona en el workspace y en las unidades. En la carpeta de la sesión, el explorador solo ofrece carpetas nuevas.

Nueva carpeta #

📁+ New folder abre un campo de nombre en la parte superior del panel de archivos. Escribe el nombre y pulsa Enter: la carpeta se crea dentro de la carpeta abierta y el explorador la abre. Escape cancela. Un aviso dice Folder "name" created. Un nombre que ya existe, o que el sistema rechaza, se indica bajo el campo y el campo se queda abierto. El botón está desactivado mientras no hay nada que pueda contener una carpeta, como la lista de unidades de Windows.

El menú contextual #

Haz clic derecho en una carpeta del árbol o en un archivo del panel de archivos. En un teléfono, mantén pulsado. El menú ofrece:

Rename y Delete no se ofrecen para una raíz (la carpeta de trabajo, / o una unidad), ni para nada del Session Browser. Una carpeta que renombras conserva su sitio en el árbol y sigue abierta.

Eliminar #

Delete pregunta primero al relay qué se eliminaría, y el cuadro de diálogo te lo dice antes de que se quite nada:

Para una carpeta con contenido, el botón rojo 🗑 Delete sigue desactivado hasta que escribes el nombre de la carpeta en el campo Type the folder name to confirm (Escribe el nombre de la carpeta para confirmar). Eliminar quita el archivo o la carpeta del disco; no va a ninguna papelera.

Nombres y enlaces #

• Un nombre es un solo segmento: no puede estar vacío, ni ser . o .., no puede contener / ni \, y tiene como máximo 255 bytes.
• Cuando el relay se ejecuta en Windows, un nombre tampoco puede contener < > : " | ? * ni caracteres de control, no puede terminar en punto ni en espacio, y no puede ser un nombre que Windows reserva, como con o nul.
• Los nombres se comparan exactamente: un nombre que ya está en la carpeta se rechaza con That name is already taken. Cambiar solo las mayúsculas de un nombre está permitido.
• Un enlace (un enlace simbólico) nunca se renombra ni se elimina: el relay lo rechaza con Links cannot be changed here. El árbol del workspace no enumera enlaces. En Linux y macOS, las raíces de unidades y de sesión sí los enumeran, y muestran un enlace a una carpeta como una carpeta, así que puedes abrirlo y leer a través de él; solo el enlace en sí está protegido. Una ruta que pasa por un enlace a una carpeta sigue llegando a la carpeta de detrás. En el workspace, un enlace que lleva fuera de la carpeta de trabajo se rechaza como ruta no válida.
• Un cambio que el sistema operativo no permite se indica como Permission denied. Un renombrado o una eliminación rechazados aparecen como aviso; una carpeta nueva rechazada aparece bajo el campo de nombre.

Como selector de carpetas #

El mismo explorador elige una carpeta para New chat (Nuevo chat) y para 🗂️ Change CWD: pulsa 📁 junto al campo de ruta. El explorador se abre en la raíz de unidades, una barra en la parte inferior muestra la carpeta seleccionada (o Select a folder…), y ✅ Use this folder as CWD (Usar esta carpeta como carpeta de trabajo) la devuelve. Las tres raíces siguen disponibles. En este modo los archivos no se abren, y no se ofrecen Rename ni Delete; 📁+ New folder y 📁 New folder here funcionan, así que puedes crear una carpeta de proyecto y elegirla de una vez. Consulta La carpeta de trabajo.

Límites #

• El árbol del workspace carga una carpeta cada vez, cuando la abres. Los nombres ocultos y pesados se omiten hasta que los activas.
• Una carpeta que el relay no puede leer se abre vacía en lugar de mostrar un error. Las entradas que no puede leer se omiten de la lista.
• La raíz de la sesión está vacía, no da error, en una sesión de Claude o DeepSeek que aún no ha escrito ningún archivo.

Por proveedor #

El explorador es el mismo con todos los proveedores que trabajan en una carpeta de la máquina del relay. Lo que cambia es la carpeta de la sesión detrás de 🕵️.