> For the complete documentation index, see [llms.txt](https://yeasy.gitbook.io/claude_guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://yeasy.gitbook.io/claude_guide/di-san-bu-fen-jin-jie-pian/07_coding/7.5_practical.md).

# 7.5 自主编码实践与案例

Agentic Coding (代理式编程) 与传统的 Code Completion (代码补全) 最大的区别在于：**Agent 拥有目标感和行动力**。它不是在等你敲下一个字符，而是主动去解决一个问题。

本节将展示三个不同复杂度的实战案例，带领体验 Agentic Coding 的强大。

## 7.5.1 案例一：全栈功能即刻实现

**任务**：在一个现有的 Todo List 应用（React + Node.js）中，新增一个“任务优先级”功能。

**Prompt**:

> “请为当前应用添加任务优先级功能。需要前端支持选择高/中/低优先级（用颜色区分），后端数据库添加字段，API 支持读写该字段。”

**Claude Agent 执行流**:

1. **Reconnaissance (侦察)**:
   * 读取 `package.json` 确认技术栈。
   * 读取 `schema.prisma` (假设用 Prisma) 了解数据库结构。
   * 读取 `App.tsx` 了解前端组件结构。
2. **Backend Changes**:
   * 修改 `schema.prisma`，添加 `priority Enum`.
   * 运行数据库迁移命令 `npx prisma migrate dev`.
   * 更新后端 Controller 处理新字段。
3. **Frontend Changes**:
   * 修改 `TodoItem` 组件，根据优先级渲染不同的 Badge 颜色 (Red/Yellow/Green)。
   * 修改 `TodoForm` 组件，添加下拉选择框。
4. **Verification**:
   * 运行 `npm test`，发现旧测试报错（因为缺少 priority 字段）。
   * 自动修复测试数据。
   * 再次运行测试，通过。

**开发者工作**: 审查 Diff，点击 Merge。耗时从 2 小时缩短到 10 分钟。

## 7.5.2 案例二：遗留代码的大规模重构

**任务**：将一个基于 Python 2.7 的老旧脚本库迁移到 Python 3.10，并添加类型注解。

**Prompt**:

> “将 `scripts/` 目录下的所有 Python 文件迁移到 Python 3。使用 `typing` 模块添加类型注解。确保所有 `print` 语句都改为使用 `logger`。”

**Claude Agent 执行流**:

1. **Analysis**: 扫描目录，发现 50 个 `.py` 文件。
2. **Planning**: 决定按依赖顺序处理，先处理底层的 `utils.py`。
3. **Iterative Refactoring**:
   * *File 1*: `print "hello"` -> `logger.info("hello")`.
   * *File 1*: `def add(a, b):` -> `def add(a: int, b: int) -> int:`.
   * *File 1*: 修复 `urllib` 到 `urllib.request` 的导入变化。
4. **Validation**:
   * 尝试运行脚本。发现 `str` 和 `bytes` 编码错误。
   * 自我修正：添加 `.decode('utf-8')`。
5. **Batch Processing**: 对剩余 49 个文件重复此过程。

**重点**: 对于这种机械性强但极易出错的体力活，Agent 是完美的人选。

## 7.5.3 案例三：从零构建测试套件

**任务**：为一个“裸奔”的电商后端 API 项目补充集成测试。

**Prompt**:

> “分析 `src/routes` 下的所有 API 路由，并在 `tests/` 目录下编写对应的集成测试。使用 `pytest` 和 `httpx`。覆盖正常路径和常见的 400/404 错误路径。”

**Claude Agent 执行流**:

1. **Understanding**: 遍历路由文件，解析出 GET/POST 请求的参数校验逻辑 (Pydantic models)。
2. **Scaffolding**: 创建 `conftest.py`，配置测试数据库 fixture。
3. **Writing Tests**:
   * 生成 `test_products.py`: 测试商品列表、商品详情。
   * 生成 `test_orders.py`: 测试创建订单、库存扣减。
   * **亮点**: 自动生成了 mock 数据（模拟的商品名、价格）。
4. **Running & Fixing**:
   * 初次运行报错 401 Unauthorized。
   * Claude 意识到需要先调用 `/login` 获取 Token。
   * 自动在 `conftest.py` 中添加了一个获取 Token 的 fixture，并注入到所有测试用例中。

## 7.5.4 案例四：Cowork 模式——非开发者的代理编程

2026 年 1 月，Anthropic 发布了 **Cowork** 模式，将 Claude Code 的能力扩展到非程序员用户。

### 什么是 Cowork？

Cowork 是 Claude Code 的“轻量版”，专为非技术用户设计：

* 在 Claude 桌面应用中直接访问
* 授权 Claude 访问指定文件夹
* Claude 可以读取、编辑、创建文件
* 支持与 Connectors (MCP) 和 Skills 配合使用

### 典型用例

| 场景      | 操作                   |
| ------- | -------------------- |
| 整理下载文件夹 | Claude 自动分类、重命名文件    |
| 从截图生成报表 | 识别多张收据截图，生成 Excel 汇总 |
| 笔记整理成报告 | 读取散乱的笔记文件，输出格式化文档    |

### 使用方式

1. 下载 [Claude 桌面应用](https://claude.com/download)（macOS 或 Windows；2026-04-09 GA 后对所有付费计划开放，见 7.8 节）
2. 点击侧边栏中的 “Cowork”
3. 选择要授权的文件夹
4. 描述任务，让 Claude 执行

### 安全注意事项

Cowork 虽然强大，但需要注意以下风险：

| 风险                   | 说明                 | 缓解措施                         |
| -------------------- | ------------------ | ---------------------------- |
| **文件误操作**            | Claude 可能误解指令删除文件  | 重要操作前 Claude 会请求确认           |
| **Prompt Injection** | 恶意内容可能干扰 Claude 行为 | Anthropic 内置了防护，但仍需谨慎处理不可信文件 |
| **权限范围**             | 只有授权的文件夹可被访问       | 最小权限原则：只授权必要的文件夹             |

## 7.5.5 成功要素总结

为什么有些人的 Agent 总是写出 Bug，而有些人的 Agent 却能通过图灵测试？

### 显性上下文

不要让 Agent 猜。如果有数据库 Schema，直接喂给它。如果有 UI 设计图，截图喂给它。

* *Tip*: 维护一个 `CLAUDE.md` 文件在项目根目录（参见 7.2 节），专门写给 AI 看。

### 增量反馈

不要试图一次性生成整个操作系统。

* *Bad*: “做一个类似 Windows 的 OS。”
* *Good*: “先实现一个简单的文件系统抽象，支持 read/write。” -> “好，现在基于这个 FS 实现一个 shell。”

### 即时审查

Agent 就像一个手速极快但偶尔粗心的初级程序员。 **Trust, but Verify (信任，但要验证)。** 永远不要在不看 Diff 的情况下直接 `git commit`。务必运行测试。

***

Agentic Coding 正在重塑软件工程的每一环。它不是要取代程序员，而是要 **消灭重复劳动**，让开发者专注于架构设计和业务价值。

掌握了日常实战场景后，接下来深入 Claude Code 的高级特性——hooks、权限体系与自动化工作流。

➡️ [7.6 高级特性与自动化](/claude_guide/di-san-bu-fen-jin-jie-pian/07_coding/7.6_advanced.md)