claudeFS

Connect a local folder to claude.ai — the "FS" stands for file system. A browser extension (MV3) for Chrome and Edge: authorize a folder once, and Claude can read, search, and edit the files in it right from the chat — no desktop app, no API key, no command line. Works on the free claude.ai plan.

English | 中文

English

Getting Started

Prerequisites: a Chromium-based browser (Chrome, Edge, etc.) with Manifest V3 and File System Access API support, plus a claude.ai account.

Install

• Chrome: install from the Chrome Web Store.
• Edge: install from the Microsoft Edge Add-ons store.
• From source: clone or download this repository (no build step needed), then load the src/ folder via Developer mode → "Load unpacked".

Use

1. Open claude.ai.
2. Click the connect button at the bottom right of the page and pick a local folder.
3. Ask Claude something like "read xx file" — that's it.

Tip: the file tools only appear in Claude's available tool list after it discovers them — if Claude doesn't use the tools at first, rephrase and mention file operations explicitly.

Privacy

All file operations run locally in your browser; the extension itself sends nothing to any server. File content that Claude reads via the tools goes only into your claude.ai conversation — the same as if you had pasted or uploaded it there yourself. Your folder reference is stored only in the browser's local storage (IndexedDB). Full policy: PRIVACY.md.

Safety

Every write operation (write / edit / move / delete, etc.) shows a diff confirmation dialog before touching your disk — you review the change and decide whether to approve it.

Limitations

Text files only: the read, search, and edit tools work on plain-text files (code, Markdown, JSON, CSV, etc.). Binary files — PDFs, images, Office documents — are rejected with a clear error. Most per-file operations are capped at 5 MB.

Disclaimer

claudeFS is an independent open-source project, not affiliated with or endorsed by Anthropic. Claude is a trademark of Anthropic.

License

MIT — see LICENSE.

中文

一个支持 Chrome 与 Edge 的浏览器扩展（MV3，名字中的 FS 即 file system 文件系统），让你在 claude.ai 授权一个本地文件夹后，Claude 能像 agent 一样直接读写该文件夹里的文件——零安装、无 API Key、无命令行，claude.ai 免费版即可使用。

快速开始

**前置条件：**一个支持 Manifest V3 与 File System Access API 的 Chromium 内核浏览器（Chrome、Edge 等），以及一个 claude.ai 账号。

安装

• **Chrome：**从 Chrome 应用商店 直接安装。
• **Edge：**从 Microsoft Edge 扩展商店 直接安装。
• **源码安装：**克隆或下载本仓库（无需构建），在开发者模式下"加载已解压的扩展程序"，选择 src/ 文件夹。

使用

1. 打开 claude.ai。
2. 点击页面右下角的连接按钮，选择要授权的本地文件夹。
3. 对 Claude 说"读一下 xx 文件"之类的话即可。

提示：文件工具需要 Claude 先检索到，才会出现在它当次对话可用的工具列表里——如果它一开始没用工具，换个更明确提到文件操作的说法再试一次。

隐私

所有文件操作都在你本地浏览器完成，扩展自身不向任何服务器传输任何数据；Claude 通过工具读到的文件内容，只会进入你正在使用的 claude.ai 对话（等同于你手动粘贴/上传给 Claude）。你选的文件夹引用仅保存在浏览器本地存储（IndexedDB）中。完整政策见 PRIVACY.md。

安全

所有写操作（write / edit / move / delete 等）执行前都会弹出 diff 确认，你可以查看改动内容后再决定是否放行。

限制

仅支持文本文件：读取、搜索、编辑工具只处理纯文本文件（代码、Markdown、JSON、CSV 等），二进制文件（PDF、图片、Office 文档等）会被明确拒绝。多数单文件操作有 5MB 大小上限。

免责声明

本项目并非 Anthropic 官方产品，与 Anthropic 无关联、未获其背书。Claude 是 Anthropic 的商标。

License

MIT，见 LICENSE。