Claude Code项目越写越乱？用CLAUDE.md加TaoToken清理死代码与重复代码

1. Claude Code 项目为什么会越写越乱用 Claude Code 写项目前两周体验极好第三周开始你会隐约觉得不对劲目录里文件越来越多src下面平铺着三十多个文件有些名字眼熟但想不起干嘛用的有些函数在两个文件里各写了一遍。你让 Claude 加个小功能它读了七八个文件才动手改完还顺手新建了一个工具函数——而你明明记得上周已经写过一模一样的。这不是 Claude 变笨了而是它的工作方式决定的。Claude Code 每次对话都是全新上下文它读你当前项目里的文件构建你这次要的东西但它不记得三次对话前在src/utils/dates.ts里写过一个完全够用的formatDate。于是它又写了一个formatTimestamp放在组件目录里。两个都能跑谁也不调用谁重复代码就这样悄悄蔓延。死代码同理。调试时临时建的test-api.ts、重构后没人引用的旧组件、从没被调用的导出函数它们不会报错但会持续占用 Claude 每次任务的文件读取预算。项目文件从 10 个涨到 40 个Claude 定位目标文件要读的文件数翻了几倍token 消耗和响应延迟同步上涨。这篇要解决的就是这个场景项目长期迭代后死代码堆积、重复代码蔓延、CLAUDE.md逐渐失焦。我会从配置层切入给你一份可复制的CLAUDE.md骨架、TaoToken 统一 Key 与 API 通道的配置片段以及重构前后的对比验证动作。适合已经用 Claude Code 写过至少一个完整项目、开始感到项目变重的开发者。2. 前置准备用 TaoToken 统一模型通道清理工作本身要跑很多轮对话扫描死代码、分析重复函数、合并工具、重组目录、更新导入。如果每轮都手动切 Key、换 base_url光是配置就能耗掉耐心。更实际的做法是把模型通道统一到一个入口让 Claude Code 和后续的验证脚本都走同一条路。TaoToken 在这里扮演的就是统一通道的角色。你可以在官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 了解它的定位核心是把多家模型的调用收敛成一套 Key 和一套 API 地址Claude Code 这类工具只需要配一次环境变量后续换模型、加并发都不用改代码。具体操作分三步。第一步在控制台创建 Key地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 进去后新建一个 API Key命名建议带上用途比如claude-code-cleanup方便后面区分。第二步如果你要长期跑编码和 Agent 任务可以看下 Coding Plan 页面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 它针对的就是这种高频、长会话的编码场景。第三步Key 管理入口在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 后续轮换、吊销都在这里。API 基础地址统一用 https://taotoken.net/api 注意这个地址不带任何查询参数直接作为 base_url 填进配置即可。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面有各语言 SDK 的调用示例遇到参数对不上时优先查这里。注意Key 只放在环境变量或本地.env里不要写进CLAUDE.md也不要提交到仓库。CLAUDE.md是给 Claude 读的项目说明不是密钥仓库。3. 可复制配置CLAUDE.md 骨架与通道片段3.1 环境变量与 Claude Code 通道配置先把通道配好再谈清理。在项目根目录创建.env.local记得加进.gitignore# .env.local TAOTOKEN_API_KEYsk-你的Key TAOTOKEN_BASE_URLhttps://taotoken.net/api如果你用的是 Claude Code 的 Anthropic 兼容接入方式参考 https://taotoken.net/ClaudeCodeAnthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里的配置说明把 base_url 指向https://taotoken.net/apiKey 用上面创建的。配完后可以用一个最小请求验证通道是否通curl https://taotoken.net/api/v1/messages \ -H x-api-key: $TAOTOKEN_API_KEY \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d { model: claude-sonnet-4-20250514, max_tokens: 64, messages: [{role: user, content: 回复 OK 两个字母}] }返回里能看到content字段带OK说明通道正常。这一步别跳过后面所有清理对话都依赖它。3.2 CLAUDE.md 骨架CLAUDE.md是 Claude Code 每次对话的起点上下文它决定了 Claude 怎么理解你的项目。项目乱往往先从这份文件失焦开始。下面是我在清理后稳定使用的一份骨架控制在 30 行以内# 项目 个人任务管理应用。Next.js 14、TypeScript、Tailwind CSS、PostgresPrisma、NextAuth。 ## 架构 - 默认服务器组件仅交互部分用客户端组件 - 所有数据库查询走 Prisma禁止裸 SQL - 所有服务器操作放在 src/actions/ - 任务数据始终限定于已认证用户 ## 文件结构 - src/app/页面、布局、API 路由 - src/components/ui/通用组件Button、Input、Card、Badge - src/components/tasks/任务专用组件TaskList、TaskForm、TaskCard、StatusBadge - src/lib/工具函数formatDate、validateInput、tokenUtils - src/types/TypeScript 类型定义 - src/actions/CRUD 与认证的服务器操作 ## 规则 - 新增工具函数前先检查 src/lib/ 是否已有同功能实现 - 组件超过 100 行时评估是否拆分 - 每周运行一次死代码扫描这份骨架的关键在于「文件结构」和「规则」两节。文件结构告诉 Claude 东西该放哪规则告诉它别重复造轮子。清理过程中每完成一步就回来更新这两节让CLAUDE.md始终反映项目当前状态。3.3 死代码扫描提示词开一个新对话把上下文清干净然后发这段扫描整个代码库识别死代码。检查 1. 每个文件中的未使用导入 2. 未被任何文件引用的导出函数 3. 未被任何页面或布局渲染的组件 4. 未被任何文件引用的孤立文件 列出每个实例包含文件路径和行号。不要修改任何文件只输出清单。Claude 会逐个读文件、追导入关系图最后给你一份清单。典型项目里死代码占比在 10% 到 15%40 个文件的项目大概能揪出 3 到 5 个孤立文件或函数。拿到清单后别急着删。Claude 的静态分析会漏掉动态引用比如通过变量导入、在配置文件里引用、或者作为服务器操作被框架隐式调用的情况。对每个标记项问一句formatDate 是否在静态导入分析可能遗漏的地方被使用 检查服务器操作、动态导入和配置文件。确认无误后再让它动手删除所有已确认的死代码。移除未使用的导入。删除孤立文件。删完立刻跑测试。测试通过这轮清理就是安全的。4. 验证请求与重构前后对比4.1 重复代码合并死代码是明面上的浪费重复代码是隐蔽的浪费。它不报错但让项目变大、让 Claude 每次多读文件。发这段提示词查找在不同文件中实现相同功能的函数、工具或组件。 按功能分组。对每组推荐保留哪个版本、删除哪个版本。Claude 生成的项目里重复代码通常集中在三类多个 API 客户端包装器fetchTasks和getTasks干同一件事、冲突的类型定义Task和TaskType描述同一结构、冗余工具函数字符串格式化、日期解析、校验辅助。选定保留版本后将这些重复的工具合并到 src/lib/utils.ts 的单个文件中。 更新整个代码库中的所有导入。合并完再跑一次测试。这一步的收益很直接文件数减少后续每个 Claude 会话要读的文件更少。4.2 用同一任务做前后对比清理有没有效果别靠感觉用同一个任务测两次。清理前开新对话发为每个任务卡片添加「最后修改」时间戳。记录 Claude 读了几个文件、花了多久、改了几处。清理后再开一个新对话发同样的指令。对比维度就三个读取文件数、响应时间、token 消耗。我实测下来一个 40 文件、存在明显重复的项目清理后同一任务的读取文件数能从 8 个降到 4 个左右响应时间接近减半。原因不复杂重复的formatDate和formatTimestamp合并成一个后Claude 不用再判断该改哪个也不用为读两个文件付费。4.3 目录重组与导入更新Claude 对文件放哪没有强偏好久而久之src下会平铺二十个文件。给它一个明确结构将项目文件重新组织成以下结构 - src/app/仅页面和布局 - src/components/ui/通用可复用组件 - src/components/tasks/任务专用组件 - src/lib/工具函数和共享逻辑 - src/types/TypeScript 类型定义 - src/actions/服务器操作 移动文件后更新所有导入路径。不要更改任何功能。重组后跑测试然后把新结构写回CLAUDE.md的「文件结构」一节。这一步的意义在于Claude 找文件靠的是文件名和目录结构结构清晰时它能直接命中src/components/tasks/TaskCard.tsx而不是在平铺目录里读五个文件才找到目标。5. 本篇常见错排查5.1 删完死代码测试挂了最常见的原因是误删了动态引用的代码。回滚这次删除然后对报错涉及的模块单独问 Claude这个模块是否通过动态导入、配置文件或框架约定被引用 列出所有可能的引用路径。确认引用方式后把该文件加回并在CLAUDE.md的规则里补一条说明避免下次再被误判。5.2 合并重复函数后导入报错合并时容易漏掉相对路径导入。让 Claude 做一次全量检查检查整个代码库中所有指向已删除文件的导入语句列出并修复。如果项目配了路径别名比如/lib/utils确认tsconfig.json里的paths和实际目录一致否则 Claude 更新导入时会用错前缀。5.3 CLAUDE.md 更新后 Claude 行为反而变怪多半是文件里留了过时规则比如引用了已经删掉的文件、或者两条规则互相矛盾。让 Claude 审一遍审查 CLAUDE.md。移除不再适用于当前代码库的规则或引用。 添加已建立的架构模式。保持简洁。30 行以内的CLAUDE.md几乎总是优于 60 行以上的。每多一行无关上下文Claude 就多花一点注意力在噪音上。5.4 通道请求返回 401 或 404先确认 base_url 是https://taotoken.net/api没有多余斜杠或路径。再确认 Key 是从 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里创建的那一个环境变量名和代码里读的一致。如果返回 404检查请求路径是不是/v1/messages不同 SDK 的默认路径可能不同以接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 为准。5.5 清理后 Claude 还是慢检查项目里有没有把node_modules、构建产物、日志目录暴露给 Claude。这些目录文件数量巨大会严重拖慢文件扫描。在项目根目录加一个忽略配置把node_modules/、.next/、dist/、*.log排除掉。这一步的收益往往比删几个死文件还大因为它直接决定了 Claude 能不能聚焦在真正重要的源码上。6. 把清理变成月度例行清理不是一次性动作。Claude 生成代码的速度决定了只要你还在用它写功能重复和死代码就会持续产生。与其等积累到难以收拾不如固定成月度流程跑一次死代码扫描、检查重复工具函数、审查文件结构、更新CLAUDE.md、跑完整测试。整套下来二十来分钟换来的是项目始终保持轻量。如果你还没配好统一通道建议先去 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 建一个专用 Key再按接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 把 Claude Code 接上。通道稳定了清理对话才能连续跑不用中途停下来折腾配置。想先验证模型输出是否符合预期可以去模型对话页面 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 试几轮长期做编码和 Agent 任务的话Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 更贴合这种高频场景。最后提醒一句Claude 没有眼睛也记不住你上周写了什么。它看不到你的界面也记不住你的目录结构。你能做的就是把项目整理得足够清晰让它在每次对话开始时就能快速抓住重点。项目越干净Claude 越像一位熟悉代码库的资深开发者而不是一个每次都要重新摸索的实习生。