在上一期中,我们成功召唤了 Claude Code 并体验了它的极速响应。但很多同学反馈:“虽然它写代码快,但有时候不符合我的编码习惯,或者不知道怎么让它帮我处理更复杂的任务。”

今天,第 2 期发车!我们将深入探讨如何通过 CLAUDE.md 调教它、利用 MCP 扩展它的超能力,以及如何在真实开发中实现“一句话完成重构”。


一、 给 Claude 一份“员工手册”:玩转 CLAUDE.md

Claude Code 最强大的地方在于它能自发地遵循项目规范。秘密就在于项目根目录下的 CLAUDE.md 文件。这相当于你给这位 AI 程序员下发的“入职手册”。

1. 为什么要写这个文件?

如果没有它,Claude 可能会用 npm 帮你装包,即使你项目用的是 pnpm;或者它写出的代码风格和你格格不入。

2. 推荐配置模板

在你的项目根目录新建 CLAUDE.md,参考以下配置:

# Claude 项目指南

## 核心技术栈
- 框架: Next.js 14 (App Router)
- 样式: Tailwind CSS
- 状态管理: Zustand

## 开发指令
- 安装依赖: `pnpm install`
- 启动开发环境: `pnpm dev`
- 运行测试: `pnpm test`
- 类型检查: `pnpm type-check`

## 编码规范
- 使用 TypeScript 严谨模式。
- 组件必须放在 `components/` 目录下,并使用命名导出(Named Exports)。
- 优先使用箭头函数定义组件。
- 所有的 API 请求必须封装在 `services/` 目录下。

效果验证: 之后你只需对 Claude 说:“帮我写一个登录组件”,它会自动查看 CLAUDE.md,用 pnpm、Tailwind 和箭头函数帮你写好,甚至连测试脚本都对齐了。


二、 打破边界:MCP(模型上下文协议)实战

Claude Code 不仅仅能改本地文件,通过 MCP (Model Context Protocol),它可以连接你的数据库、GitHub、Notion 甚至是搜索引擎。

1. 如何安装 MCP 工具?

如果你想让 Claude 能够直接查询你的 GitHub Issues,可以运行:

claude config mcp add github

然后根据提示输入你的 GitHub Token。

2. 常用 MCP 场景推荐

场景 推荐 MCP 服务 功能描述
数据库 postgresql 让 Claude 直接查询表结构并生成迁移脚本
文档 google-drive 让 Claude 读取需求文档直接开始写代码
搜索 brave-search 让 Claude 搜索最新的技术文档(不再受限于训练数据)

三、 高阶命令行:像极客一样操作

除了对话模式,Claude Code 的 One-liner(单行命令) 模式是提效神器。

1. 自动提交代码

别再纠结 git commit 该写什么了,直接让 Claude 帮你总结并提交:

claude "分析我的更改并提交,message 要符合规范"

2. 危险但高效的“跳过确认”

在进行大批量重构且你非常信任当前环境时,可以使用:

claude -p "将所有组件从 class 重构为 hooks" --dangerously-skip-permissions

注:此操作建议在独立的分支上进行。


四、 实战场景:一句话重构老旧项目

背景描述:
你手里有一个陈旧的 crawler.py。它是 3 年前写的,代码逻辑混乱,没有类型标注,使用的是同步的 requests 库,且所有配置都硬编码在代码里。

目标:
让 Claude Code 自动完成以下操作:

  1. 架构升级:从单一脚本重构为 FastAPI Web 服务。
  2. 性能优化:将 requests 替换为异步的 httpx
  3. 工程化:引入 Pydantic 进行数据验证,并把硬编码配置提取到 .env 文件。
  4. 质量保证:自动编写并运行 pytest 单元测试。

实战演示步骤

Step 1: 投喂需求

在终端输入:

claude "分析当前的 crawler.py,把它重构成一个 FastAPI 异步服务。要求:
1. 使用 httpx 进行异步请求。
2. 将数据模型定义为 Pydantic 类。
3. 创建 .env 文件管理 API 密钥。
4. 保持原有的逻辑不变,但要把代码模块化。"

Step 2: Claude 的自动操作

这时,你会看到 Claude Code 开始“自言自语”并执行一系列指令:

  • 读取文件Reading crawler.py...
  • 创建文件Creating main.py, models.py, .env...
  • 安装依赖:它会发现你没装 FastAPI,主动询问:May I run: pip install fastapi httpx pydantic python-dotenv? (你只需点个确认)
Step 3: 自动化测试

等它写完,你接着下令:

claude "为这个新服务编写测试用例,并运行 pytest 确保重构后逻辑正常。"

它会创建 tests/test_main.py,模拟 API 调用,如果报错,它会自动修复 Bug 直到测试全部通过。


五、 小结与预告

第 2 期的核心在于“规范”与“连接”。有了 CLAUDE.md,它才真正懂你的项目;有了 MCP,它才真正连接了世界。

Logo

有“AI”的1024 = 2048,欢迎大家加入2048 AI社区

更多推荐