用了半年Claude Code，现在基本离不开它了。不是因为它能帮我写代码（虽然确实能），而是因为它能帮我理解代码。接手一个陌生项目时，以前要花半天读代码才能开始改，现在直接问Claude"这个模块的调用链是什么"，几分钟就搞清楚了；

这篇文章分享我日常使用Claude Code的几个核心工作流；

安装

npm install -g @anthropic-ai/claude-code
claude auth   # 首次使用配置API Key

在项目目录下运行claude进入交互模式。Claude会自动扫描项目结构，理解代码上下文。

工作流一：快速理解陌生项目

接手新项目最痛苦的就是"不知道从哪看起"。Claude Code可以帮你快速建立全局认知：

> 这个项目的整体架构是什么？各模块之间怎么依赖的？
> src/services/ 目录下的核心业务逻辑有哪些？
> 数据库用了什么ORM？表结构在哪个文件定义的？

Claude会扫描项目文件，分析import关系和调用链，给你一个清晰的架构概览。这比自己grep和读代码快10倍。

具体到某一个API端点：

> /api/orders这个端点的完整调用链是什么？从路由到控制器到数据库操作

Claude会追踪从路由定义→中间件→控制器→服务层→数据访问层的完整链路，标注每一步的文件和行号。

工作流二：功能开发

> 帮我在用户模块中添加修改密码的API。
> 要求：验证旧密码、新密码至少8位且包含大写字母和数字、密码用bcrypt加密
> 参考现有用户模块的代码风格

Claude会先读取现有代码理解风格和约定，然后生成符合项目规范的新代码。关键是"参考现有代码风格"这句话——没有这句话，Claude可能用一套和项目完全不同的风格写代码。

工作流三：调试修复

直接把错误信息贴给Claude：

> 运行 `npm test` 报错了：
> TypeError: Cannot read properties of undefined (reading 'userId')
>   at /src/services/order.ts:45:23

Claude会定位到报错行，分析原因，给出修复方案。对于Stack Overflow上搜不到的项目特定错误，Claude特别有用——因为它能看到你的完整代码上下文。

工作流四：跨文件重构

> 把 src/utils/ 的工具函数按功能分类，拆分成 date-utils.ts、string-utils.ts、
> validation-utils.ts，然后更新所有引用文件的import路径

这种跨文件的重构以前是噩梦——改一个文件要查所有引用、改所有import。Claude能一次性帮你完成。

工作流五：测试编写

> 为 AuthService 写单元测试，覆盖：正常登录、密码错误、用户不存在、账号被锁定。
> 用 Jest，参考 tests/ 目录下已有的测试风格

Claude生成的测试代码包含mock和断言，风格和项目已有测试一致。

实用命令

/review审查最近的代码改动；/compact压缩对话历史节省Token；/config调整行为设置；

注意事项

在有敏感信息的项目中使用时，确保.env和密钥文件在.gitignore中。Claude默认会读取项目文件作为上下文，虽然不会外传，但安全意识要有；

不要盲目接受Claude的所有建议。它是基于代码上下文生成的，不一定理解你的业务约束。关键逻辑一定要人工审查；

写在最后

Claude Code本质上是一个"读代码比写代码更快"的搭档。它最大的价值不是帮你写出新代码，而是帮你快速理解已有代码。用好它，你的开发效率会有质的提升。