创建.claudeignore文件可彻底屏蔽.venv、__pycache__、dist、.git等冗余目录，使Claude Code在/init及任务中严格跳过扫描，显著节省Token、提升响应速度并避免误读；再执行/init重生成纯净CLAUDE.md，并用/stats验证文件扫描数下降及自然语言提问确认隔离效果。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Claude Code 工作台里堆满 .venv、__pycache__、dist、.git 这类目录，AI 每次扫描都浪费 Token、拖慢响应、还容易误读无关文件，必须从根上精简——不是靠手动删，而是让 Claude Code 从一开始就不看它们。
第一步：创建 .claudeignore 文件屏蔽冗余路径
在项目根目录新建一个纯文本文件，命名为 【.claudeignore】，保存为 UTF-8 编码（不能是 UTF-8-BOM），否则 Claude Code 会静默忽略该文件。
把以下内容直接复制粘贴进去，覆盖你当前项目的典型冗余项：
# Python 环境与缓存
.venv/
__pycache__/
*.pyc
*.pyo
.mypy_cache/
.pytest_cache/
# 构建产物
build/
dist/
*.egg-info/
# 版本控制
.git/
# 日志与数据库
log/
*.log
*.db
*.sqlite3
# 媒体与临时文件
*.png
*.jpg
*.gif
test*.py
*_test.py
这一步做完后，Claude Code 在执行 /init、分析结构、搜索代码等任务时，将完全跳过这些路径——不是“尽量不读”，而是【彻底不扫描】，Token 节省立竿见影。
第二步：用 /init 重建轻量级项目上下文
确保终端已进入项目根目录，运行：
/init
该命令会触发 Claude Code 重新扫描当前目录，但这次它严格遵守 .claudeignore 规则，只读取源码、配置、文档等有效文件，生成的 CLAUDE.md 里不会混入任何 .venv 或 __pycache__ 的痕迹。
如果之前已经运行过 /init，旧的 CLAUDE.md 可能残留冗余路径引用。此时直接删除项目根目录下的 CLAUDE.md 文件，再执行 /init —— 不要编辑旧文件，重生成更干净。
第三步：验证精简效果
输入指令：
/stats
查看最近一次 /init 或代码分析任务的文件读取统计，重点关注 “Files scanned” 数值。对比精简前后：若原项目扫描 127 个文件，现在降到 32 个以内，说明 .claudeignore 生效；若仍接近原数，检查 .claudeignore 是否放在项目最外层根目录（不是子目录）、文件名是否拼错（必须是英文点开头+全小写+无扩展名）。
再试一句自然语言提问：
“这个项目用了哪些第三方库？”
如果回答中不再出现 pip install -r requirements.txt 以外的 .venv/site-packages 内容，或没把 __pycache__/xxx.cpython-311.pyc 当成源码分析对象，就确认冗余目录已被成功隔离。
