让 Claude 读我的文件、改我的文件
📍 Claude Code 干活
50 张发票的那个下午
Section titled “50 张发票的那个下午”某个周末下午，洁柔在桌上摊了 50 张报销发票 PDF——下周一要交财务，每张要抠日期、金额、发票号、销售方，手填 Excel。她预估「一下午」。
她试着打开 Claude Code 问了一句：
「桌面上有 50 张发票 PDF，帮我读完做成 Excel——每张抠日期 / 金额 / 发票号 / 销售方。」
没过多久，她桌面上多了一个 发票汇总.csv，50 张发票各占一行。
她那一刻给我发了一条：「这是我用 AI 工具以来最爽的一刻。」
不过，表做出来不等于每个数字都对。财务数据交出去之前，还得拿原件抽查——后面场景 2 会讲具体怎么核。
这种「直接进你电脑干活」的能力，就是这一篇要讲的——读文件、改文件、批量处理。
这是 Claude Code 最值钱的能力
Section titled “这是 Claude Code 最值钱的能力”网页聊天适合处理你贴进对话框、或者上传的几份材料。要是文件散在电脑各处、一次几十上百个，就轮到能直接访问本机文件夹的工具了：读你硬盘里 200 个文件、按规则改其中 50 个、把结果存到新目录，一句话交代清楚就行。
这类工具不止 Claude Code 一家：OpenAI 的 Codex、字节的 TraeCode、DeepSeek Harness 都能在本机文件夹里读写文件，豆包工作也能处理电脑里的本地文件。它们能做多少，看具体功能、套餐和你给的权限，怎么挑见 Claude Code、豆包、ChatGPT 怎么选。本篇以 Claude Code 为例。
读懂这一篇，你就掌握了 Claude Code 最常用的那部分本事。
它怎么读你的文件
Section titled “它怎么读你的文件”Claude Code 读文件有两种方式，对应不同场景：
方式 1：你直接告诉它路径
Section titled “方式 1：你直接告诉它路径”读 ~/Documents/2024年合同.docx，告诉我里面的违约条款写了什么。它做的事：Word 文件它不能直接打开，会先跑一条命令把文字抽出来（比如 macOS 自带的 textutil，或者一小段 Python），再读、再给你总结违约条款。
文件本身留在你的硬盘上，但它读到的内容（文字、图片都算）会随请求发给模型服务处理：默认发给 Anthropic；按本站教程接了 DeepSeek，就发给 DeepSeek。用个人账号时，这些内容会不会被拿去训练模型，还要看你的隐私设置。所以合同、发票这类文件，先确认能不能交给这个服务：判断方法见什么能发给 AI，原理见什么是 Claude Code（官方说明：数据使用）。
哪些格式能直接读、哪些要先转换（按官方 Read 工具说明）：
| 类型 | 文件后缀 | 怎么读 |
|---|---|---|
| 纯文本和代码 | .txt .md .csv .tsv .json .yaml .xml，以及 .py .js .html 等 | 直接读，拿到的是带行号的文字；文件太长会分段读 |
| 图片 | .png .jpg .webp 等 | 直接读，当成图片交给模型看，大图会先缩小 |
.pdf | 直接读：短的整份读，超过 10 页按页分段读，每次最多 20 页 | |
| Jupyter 笔记本（把代码和运行结果写在一起的文件） | .ipynb | 直接读 |
| Word、Excel | .docx .xlsx | 不能直接读，要先用命令把内容转出来（比如 pandoc、python-docx、openpyxl，或 macOS 自带的 textutil）。缺工具时可能要装软件，让它先说明要装什么 |
走 DeepSeek 时注意两点：按本站 DeepSeek 教程配置（默认用 deepseek-flash），能看图；但 PDF 不能直接交给模型，因为 DeepSeek 的兼容接口不支持 PDF 这种消息类型，要先让它把文字抽出来，或者把页面转成图片再看（DeepSeek 兼容接口说明）。第一次用，先拿一两个文件把整条链路试通。
方式 2：让它自己扫目录找
Section titled “方式 2：让它自己扫目录找”看一下 ~/Documents/项目A/ 这个文件夹，列出所有 docx 文件，告诉我哪些是合同、哪些是会议纪要。它做的事：先 ls 看目录结构 → 挑出 docx → 一个一个转成文字再读 → 分类汇总。你不用知道每个文件叫什么，它自己摸清楚。
这种「扫一遍目录帮你梳理」的活，正是这类能访问本机文件夹的工具的看家本领：你不用先把文件一个个找出来上传。
它怎么改你的文件
Section titled “它怎么改你的文件”Claude Code 改文件有三种动作，理解清楚省很多麻烦：
🔧 Edit —— 改一小块
Section titled “🔧 Edit —— 改一小块”「把 ~/简历.md 里 ‘负责开发了一个项目’ 这句改成更具体的描述，加上技术栈。」
它会精准定位那一行，改完只动那一行，其他部分一字不动。适合：
- 局部润色
- 单个 bug 修改
- 只改一个字段
✍️ Write —— 整个重写 / 新建
Section titled “✍️ Write —— 整个重写 / 新建”「在桌面上新建一份 周末计划.md，包含周六周日的安排，每天三件事。」
它会直接创建文件或者整个覆盖现有文件。⚠️ 覆盖现有文件会清空原内容，第一次新手容易踩坑 —— 看清楚它要 Write 的是新文件还是旧文件。
🔁 批量修改 —— 一次改多处
Section titled “🔁 批量修改 —— 一次改多处”「我的简历里 ‘负责’ 这个词出现了 8 次，帮我换成更主动的表达，每个上下文不一样，请挨个改。」
它会找出所有匹配位置，给每个位置生成不同改法，用一连串 Edit 全改完。这是 Claude Code 的杀手锏 —— 手工改 8 处会改到吐血，AI 30 秒搞定。
三个真实可以试的场景
Section titled “三个真实可以试的场景”场景 1：把简历从 markdown 转 docx
Section titled “场景 1：把简历从 markdown 转 docx”很多人用 markdown 写简历（Notion / Typora 导出的）但企业 HR 要 docx。Claude Code 一句话：
读 ~/Desktop/简历.md，转成 docx 格式存到旁边。要求保留所有格式（标题层级、加粗、列表），并加一个合理的封面页。先检查本机已有的工具；需要安装软件时，先告诉我装什么、为什么装，等我确认再装。它做的事：先看本机有没有 pandoc、python-docx 这类转换工具 → 没有就先问你要不要装 → 跑转换 → 给你 简历.docx。装软件会改动你的电脑，所以在提示词里写明「先问我」最稳。比你自己搜「markdown 转 docx 工具」、一个个试省事得多。
场景 2：从 50 个 PDF 里挑数据
Section titled “场景 2：从 50 个 PDF 里挑数据”
财务对账经典痛点 —— 一堆发票 PDF，要把每份的金额和日期录进 Excel。别一上来就让它处理全部，先试 3 份：
~/Documents/2024年发票/ 这个文件夹里有 50 个 PDF 发票。先只处理前 3 份：提取开票日期、金额、发票号、销售方，做成一个 csv 表给我。看不清、拿不准的字段不要猜，在备注列里标出来。它做的事：扫目录 → 读 PDF → 提取文字 → 整理成 csv。
你要做的事：拿这 3 份跟原件逐行对照，日期、金额、发票号一个字一个字核。没问题了，再让它处理剩下的 47 份；整表出来后，至少再抽查几行，重点看它在备注里标出来的那些。一个金额认错，就是一笔错账。
费用看 PDF 有多少页、它读了几遍：按量付费的，以 Claude Console 或 DeepSeek 开放平台的账单为准；用 Claude 订阅的，花的是套餐额度，会话里输入 /usage 能看用了多少。别照搬别人的数字。
注意扫描件：手机拍照、扫描仪生成的 PDF 没有文字层。用 Claude 模型时，PDF 每一页会连图带字交给模型，扫描件也能看；走 DeepSeek 时，要先把页面转成图片再让它看。不管哪种，扫描件认得准不准，都先拿两三张试。
场景 3：改 Excel 表里的日期格式
Section titled “场景 3：改 Excel 表里的日期格式”你接手了一份历史数据表，日期格式乱七八糟（2024-01-15 / 15/1/24 / Jan 15, 2024 混着用）：
读 ~/Downloads/data.xlsx，把日期列（第 3 列）统一成 YYYY-MM-DD 格式，保留其他列不变，存成 data-cleaned.xlsx。先检查本机有没有能读写 xlsx 的工具；需要安装时先告诉我，等我确认。它做的事：用 Python 的 openpyxl、pandas 这类工具读表（没装的话先问你）→ 解析日期 → 重新格式化 → 写新文件。这种「看着简单但写 Python 写半小时」的活，AI 很快就能搞定。做完照样抽几行对一下，特别是 1/2/24 这种分不清是 1 月 2 日还是 2 月 1 日的写法。
它改之前会先问你吗？
Section titled “它改之前会先问你吗？”
⚠️ 这是新手最该弄清楚的一件事：改文件前会不会先问你，取决于「权限模式」（permission mode）。
- 现在默认是 auto（自动模式）：从 Claude Code 2.1.283 起，新开的会话默认进 auto，由另一个模型在后台替你审核，大多数改动不再逐个问你。删掉原来就有的文件、强推代码这类危险动作默认会被拦下，但官方也说了：auto 能减少弹窗，不保证安全。
- 接 DeepSeek 时：auto 大概率用不了，会从 Manual 开始，以界面底部状态栏显示为准。
- 想每一步都自己点头：用手动确认模式启动：
claude --permission-mode default界面底部会显示 ⏸ manual mode on，也就是 Manual（手动确认）模式。这个参数只管这一次启动，下次直接打 claude，又会回到默认模式；已经开着的会话，在 auto 下按一次 Shift+Tab 也能切到 Manual；想每次启动都是 Manual，写进设置的方法见让 Claude 跑命令。
Manual 模式下，它每次改文件前都会先把要改的文件和改动给你看，选项一般有三个：Yes（这一次允许）；第二个写着「Yes, and switch to accept edits … for this session」，选了它，这次会话就切到 acceptEdits（自动接受编辑）模式，之后改文件，连 rm、mv 这类常见文件命令也不再问，想每一步都看就别选它；No（拒绝，可以按 Tab 附一句话告诉它怎么改）。
永远先看清楚要改的是哪个文件，再选 Yes。
给新手的建议就两条：
- 第一个月用 Manual，每一步都看一眼；
- 大改动前先切到 plan 模式（计划模式）：它先读文件、出一份方案，你批准之前不改文件。会话里按 Shift+Tab 可以在几种模式之间切换。
不建议新手用 bypassPermissions（全部放行、什么都不问），官方只建议在隔离的容器或虚拟机里用。六种模式的完整对照、确认弹窗每个选项的意思，统一放在让 Claude 跑命令这一篇。
三个新手坑，提前避
Section titled “三个新手坑，提前避”
❌ 坑 1：让它访问敏感目录
Section titled “❌ 坑 1：让它访问敏感目录”别这么打：
「扫一下我整个 home 目录，告诉我占空间最大的文件是哪些。」
home 目录含 ~/.ssh（你的 SSH 密钥）、~/.aws/credentials（AWS 密钥）、银行下载的对账单等。AI 读到密钥不一定会泄露，但它读到的内容会随请求发给模型服务，你给了它机会。
改这么打：
「扫一下 ~/Documents/项目A/ 这个文件夹，告诉我占空间最大的文件是哪些。」
明确指定一个你确定没有敏感文件的目录，或者先把要处理的文件复制到练习文件夹里再让它处理。
❌ 坑 2：批量改之前没备份
Section titled “❌ 坑 2：批量改之前没备份”「把 ~/Pictures/ 里所有 png 改成 webp。」
如果改坏了你没原图了。永远先备份：
「把 ~/Pictures/ 里所有 png 改成 webp，存到 ~/Pictures-webp/ 这个新目录，保留原文件夹不动。」
让它输出到新位置而不是覆盖原文件。出了问题原始文件还在。
❌ 坑 3：路径错误改错文件
Section titled “❌ 坑 3：路径错误改错文件”新手最痛的一刀 —— 你说「改简历」，AI 改了 ~/Desktop/简历-2023.md（旧版），你想要的是 ~/Documents/求职/简历最新.md（新版）。
改之前先问清楚：
「我要你改的简历是
~/Documents/求职/简历最新.md，不是桌面那份。请确认路径再改。」
或者让它列出来给你确认：
「在 ~/Documents/求职/ 里列出文件名含『简历』的文件，列给我看，我告诉你改哪份。」
新手第一个月遇事多让它确认路径，多花 5 秒避免后悔半小时。
读完这篇你应该会用 Claude Code 完成 「读文件 → 处理 → 写文件」 这个最核心的工作流。
接下来：
→ 让 Claude 跑命令：六种权限模式怎么选 —— 它不光会改文件，还会跑命令（部署、git、安装软件、调用 API）；六种权限模式也在这一篇讲全 → CLAUDE.md 是什么：让它记住你的项目 —— 把你的项目偏好写成它「记得住」的文档