.claudesignore 文件：给 AI 装上"防火墙"与"省钱闸门"

一、.claudesignore 是什么？

在使用 Claude Code 进行深度开发时，.claudesignore 是你必须配好的第一道防火墙 + 省钱闸门。

它的语法与作用跟 .gitignore 几乎完全一致，区别只在于——它服务的对象只有 Claude Code。
它明确告诉 AI：

"这些目录和文件，你绝对连看都不要看一眼。"

---

二、既然有 .gitignore，为什么还要 .claudesignore？

默认情况下 Claude Code 会遵守 .gitignore，但在前端项目中往往不够，主要原因两点：

1️⃣ Git 要留，但 AI 不该读（Token 炸弹）

比如本地有一个 mock_data.json（5MB），你需要它跑项目，也得提交或保留，
但一旦 Claude 在全项目搜索时顺手读它——几百万 Token 瞬间烧完。

✅ 解：写进 .claudesignore，Git 仍跟踪，Claude 直接跳过。

---

2️⃣ 双重安全防线（防密钥泄露）

.env / config/private.json 虽常在 .gitignore 中，但手误难免。
若 Claude 读取上下文时把这些文件一起打包上传，存在安全风险。

✅ 解：在 .claudesignore 中再锁死一次敏感文件，养成团队安全习惯。

---

三、现代前端项目推荐模板

在项目根目录新建 .claudesignore，推荐配置如下（适配 Vite / Vue3 / Nuxt3 / React / Next.js）：

# 1. 绝对不要让 AI 靠近的“前端黑洞”
node_modules/
.pnpm-store/

# 2. 各类框架的构建产物与缓存（全是自动生成的乱码或压缩代码，AI 看了毫无意义）
dist/
.output/
.nuxt/
.next/
out/
build/
.cache/
.vite/

# 3. 依赖锁定文件（动辄几万行，严禁让 AI 读取，否则账单爆炸）
package-lock.json
pnpm-lock.yaml
yarn.lock

# 4. 敏感的本地环境变量与私钥
.env*
!.env.example
*.pem
*.key

# 5. 本地大型媒体资产或 Mock 数据
src/assets/large-videos/
src/mock/huge-data.json

# 6. 系统与 IDE 缓存
.DS_Store
.idea/
.vscode/
.trae/

---

四、它的三大核心价值

💰 钱包保护（Token 熔断器）

Claude 上下文极大，不加限制可能把 dist/、锁文件全读进去。
配好 .claudesignore 后，API 消耗通常可下降 50%+。

---

⚡ 速度飞跃（减少无效扫描）

AI 搜函数/重构时扫描文件越少越快，避免卡在"正在读取文件..."。

---

🎯 提高 AI 专注度

避免 AI 试图修改 dist/main.js 等产物文件，减少离谱 Bug。

---

五、进阶技巧

✅ 临时让 AI 读被忽略的文件

不需要改 .claudesignore，直接在对话中用绝对/相对路径喂给它：帮我看 src/mock/test.json 的结构，生成对应的 TypeScript interface。

主动指定的文件会突破忽略限制。

---

✅ 团队统一行为

把 .claudesignore 提交到 Git，确保团队成员本地 Claude Code 行为、计费一致。

---

六、小结

• .gitignore → 管版本控制
• .claudesignore → 管 AI 视线与 Token 消耗

理解了这个防线，再配合之前讲的 CLAUDE.md（显式记忆） 与 Auto Memory（隐式记忆），你就已经具备了安全、高效指挥 Claude Code 的完整基础。

---