Claude Code 最强代码清理神器：code-simplifier 完全使用指南

Anthropic 团队内部自用的代码简化 Agent，现已开源。不改变任何功能，只让你的代码更优雅、更易读、更可维护。

一、code-simplifier 是什么？

code-simplifier是 Anthropic 官方开源的 Claude Code 插件——同一个工具，Claude Code 团队自己每天都在用。

它的定位非常纯粹：在不改变代码功能的前提下，简化代码实现，提升清晰度、一致性和可维护性。

用 Boris Cherny（Anthropic 工程师）的话说：

“We just open sourced the code-simplifier agent we use on the Claude Code team. Ask Claude to use the code simplifier agent at the end of a long coding session, or to clean up complex PRs.”

核心原则：一条铁律

Never changes code functionality — only changes implementation.

所有原始特性、输出和行为保持不变。它只关心"怎么写"，不关心"写什么"。

底层规格

二、三大安装方式

方式一：命令行安装（推荐）

claude plugininstallcode-simplifier

方式二：在 Claude Code 会话中安装

/plugin marketplace update claude-plugins-official /plugininstallcode-simplifier

方式三：社区版 Skill 安装（更灵活）

如果你想把它当 Skill 用，而不是 Agent：

npx-yskillsaddpproenca/dot-skills--skillcode-simplifier--agentclaude-code

或者手动下载：

mkdir-p~/.claude/skills/code-simplifier-pproenca-dot-skillscurl-Lhttps://claudskills.com/skills/code-simplifier-pproenca-dot-skills/SKILL.md\-o~/.claude/skills/code-simplifier-pproenca-dot-skills/SKILL.md

安装路径：

• macOS/Linux：~/.claude/skills/code-simplifier/
• Windows：%USERPROFILE%\.claude\skills\code-simplifier\

安装完成后，Claude Code 会在下次启动时自动发现它。

三、如何使用？四种实战场景

场景 1：长时间编码后一键清理（最常用）

写完一个功能模块后，让 code-simplifier 帮你"回头看"：

请用 code-simplifier 清理我们今天修改的代码

或英文：

Run the code-simplifier agent on the changes we made today

Claude 会自动分析所有最近修改的文件，并一次性完成清理。

场景 2：提交 PR 前的质量把关

在创建 Pull Request 前，确保代码符合质量标准：

用 code-simplifier 检查并优化这些变更，然后再创建 PR

英文：

Use the code-simplifier to review and clean up these changes before we create the PR

场景 3：重构后的规范化

当你刚完成跨多个文件的大型重构，需要确保模式一致性：

用 code-simplifier 统一我们刚重构文件中的代码模式

英文：

Use code-simplifier to normalize the patterns in the files we just refactored

场景 4：指定模块清理

针对特定文件或目录：

用 code-simplifier 处理我刚写的 auth 模块

英文：

Use code-simplifier on the auth module I just built

技术调用方式（进阶）

由于 code-simplifier 本质是一个 Agent 而非传统 Skill，正确的调用方式是通过Task Tool：

{"subagent_type":"code-simplifier:code-simplifier"}

而不是通过 Skill tool（那样会报 “Unknown skill” 错误）。

四、它到底能做什么？五大核心能力

1. 保留功能（铁律）

这是 code-simplifier 的第一原则：绝不改变功能。

• 所有原始特性、输出和行为完全保持不变
• 只改实现方式，不改业务逻辑
• 运行后会自动验证功能未受损

2. 遵循项目标准

自动读取并遵循项目的编码规范：

• 项目根目录的CLAUDE.md—— 最高优先级
• .cursor/rules/*.md、.cursorrules
• AGENTS.md、.github/copilot-instructions.md
• .editorconfig、.prettierrc、.eslintrc.*

这意味着：你的团队规范定义得越清晰，code-simplifier 的表现就越好。

3. 提升清晰度

• 减少不必要的复杂度和嵌套
• 消除冗余代码和过度抽象
• 优化变量和函数命名
• 合并相关逻辑
• 移除描述明显代码的无用注释
• 避免嵌套三元运算符—— 改用 switch 或 if/else 链
• 选择清晰而非简洁—— 显式代码优于过度紧凑的代码

4. 保持平衡（不过度简化）

code-simplifier 很聪明，知道什么不该做：

• 不会为了简化而牺牲代码清晰度
• 不会创造过于" clever "的难以理解的方案
• 不会将太多关注点塞进单个函数
• 不会移除有助于代码组织的抽象
• 不会为了"行数更少"而牺牲可读性

5. 专注近期修改

默认只关注最近修改的代码（通过git diff/git status识别），除非你显式指定其他范围。这使得它：

• 运行速度快，不浪费 token
• 精准定位需要清理的代码
• 不影响已经稳定的旧代码

五、45 条重构规则速览（8 大类别）

code-simplifier 内置了 45 条重构规则，按优先级和影响范围分为 8 大类：

六、实战前后对比

示例 1：嵌套三元运算符 → 清晰条件链

清理前：

conststatus=user.active?user.verified?'active-verified':'active-unverified':user.suspended?'suspended':'inactive';

清理后：

functiongetUserStatus(user){if(user.suspended)return'suspended';if(!user.active)return'inactive';returnuser.verified?'active-verified':'active-unverified';}conststatus=getUserStatus(user);

示例 2：复杂条件 → 提前返回

清理前：

functionprocessOrder(order){if(order){if(order.items&&order.items.length>0){if(order.paymentStatus==='paid'){returnfulfillOrder(order);}else{thrownewError('Payment not completed');}}else{thrownewError('Order has no items');}}else{thrownewError('Invalid order');}}

清理后：

functionprocessOrder(order){if(!order)thrownewError('Invalid order');if(!order.items?.length)thrownewError('Order has no items');if(order.paymentStatus!=='paid')thrownewError('Payment not completed');returnfulfillOrder(order);}

七、最佳实践与注意事项

五个最佳实践

1. 定期运行—— 不要等代码变乱才想起来用，每次重要编码会话后跑一遍
2. 审查变更—— code-simplifier 很强，但不是绝对可靠，提交前务必 review 它的改动
3. 配置好 CLAUDE.md—— 编码标准定义得越清晰，效果越好
4. 配合版本控制—— 在 git 跟踪的目录中运行，方便对比和回滚
5. 与其他工作流结合—— 与 Plan mode、code-review agent、test runner 配合使用

三个注意事项

1. 它不是 Skill，是 Agent—— 需要通过 Task tool 或自然语言调用，不能通过/code-simplifier调用（社区版 Skill 可以）
2. Token 成本—— 需要重新处理已生成的代码，建议选择性使用，不要对每个小改动都跑
3. 运行前提交代码—— 这样方便对比和回滚：git checkout -- <file>

八、支持的语言

code-simplifier 支持所有主流编程语言，特别擅长：

• TypeScript / JavaScript—— 前端/全栈首选
• Python—— 数据科学、后端开发
• Go—— 云原生、后端服务
• Rust—— 系统编程
• Java—— 企业级应用

社区还贡献了框架专属版本：

• Laravel/PHP：laravel-simplifier@laravel
• Rust：MCP marketplace 上的 Rust 专用变体

九、一句话总结

code-simplifier 就像一位不知疲倦的代码洁癖专家——它不会帮你写新功能，但会让你的每一行代码都干净利落。在 AI 辅助编程的时代，它的价值愈发明显：AI 生成的代码往往倾向于"过度完备"，而 code-simplifier 就是专门来消除这种冗余的。

记住这个黄金时机：每当你完成一个功能、准备提交 PR、或者结束一次长编码会话时——

“Run the code-simplifier.”

参考资源

• Anthropic 官方插件仓库
• Claude Code 官方文档 - Skills
• Claude Code Agent SDK
• ClaudSkills 社区注册表