10.9.5 编码 Agent(Claude Code/Codex/Cursor 类)的工程用法
所属:全栈开发面试题库 / 10 AI 应用开发:LLM 与 Agent / 10.9 Agent 框架与工具链
覆盖范围
- 编码 Agent 的能力边界
- Claude Code / Cursor / Codex 的使用模式
- 工程化最佳实践(上下文管理、代码审查、测试)
- 编码 Agent 的安全风险
- 团队协作与规范
- 提示工程与任务分解
高频题速览
| 编号 | 题目 | 难度 | 频率 |
|---|---|---|---|
| 10.9.5-001 | 编码 Agent 能做什么,不能做什么? | 基础 | ★★★★★ |
| 10.9.5-002 | Claude Code 的核心用法? | 进阶 | ★★★★ |
| 10.9.5-003 | Cursor 的 AI 编程模式? | 基础 | ★★★★ |
| 10.9.5-004 | 怎么给编码 Agent 提供上下文? | 进阶 | ★★★★ |
| 10.9.5-005 | 编码 Agent 写的代码怎么审查? | 基础 | ★★★★ |
| 10.9.5-006 | 编码 Agent 有什么安全风险? | 进阶 | ★★★ |
| 10.9.5-007 | 怎么用编码 Agent 做大规模重构? | 高级 | ★★★ |
| 10.9.5-008 | 团队怎么规范使用编码 Agent? | 基础 | ★★★ |
10.9.5-001 编码 Agent 能做什么,不能做什么?
频率 ★★★★★ | 难度 基础
一句话结论
编码 Agent 擅长:写新功能、修 bug、写测试、解释代码、重构小范围代码;不擅长:跨多文件大重构、理解复杂业务上下文、保证安全和性能、做架构决策;它是助手,不是替代。
概念解释
- 擅长:根据明确需求写代码、生成测试用例、解释陌生代码、做小范围修改。
- 不擅长:全局架构决策、复杂业务逻辑理解、保证生产级安全性能、跨多文件大重构。
- 定位:辅助开发者,不是替代开发者。
- 正确用法:人提需求、人审查、Agent 写初稿。
原理流程
- 人明确需求和上下文。
- Agent 生成代码。
- 人审查代码,提出修改意见。
- Agent 修改,人再审查。
- 人决定最终合并。
代码 / 示例
编码 Agent 能力边界:
能做好:
- 写单个函数/组件
- 修复明确的 bug
- 生成测试用例
- 解释代码逻辑
- 小范围重构
做不好:
- 跨多文件大重构
- 理解复杂业务上下文
- 架构设计决策
- 保证安全和性能
- 处理模糊需求
常见误区
- 误区:编码 Agent 能替代程序员;正解:Agent 是助手,需求理解、审查、架构决策还是人做。
- 误区:Agent 写的代码直接就能上线;正解:必须人工审查,Agent 可能引入安全漏洞或性能问题。
追问
- Q:编码 Agent 的正确率? A:简单任务正确率 80%+,复杂任务 50% 以下,必须人工审查。
- Q:怎么提高 Agent 输出质量? A:给足上下文、明确需求、分步迭代、不要一次让它做太多事。
10.9.5-002 Claude Code 的核心用法?
频率 ★★★★ | 难度 进阶
一句话结论
Claude Code 是 Anthropic 推出的终端编码 Agent:在命令行运行,能读取项目文件、执行命令、编辑代码、跑测试;适合在终端里做编码任务,是"AI 结对编程"的 CLI 版。
概念解释
- 终端运行:在命令行里和 Agent 对话。
- 项目上下文:Agent 能读取项目文件结构和内容。
- 执行能力:能运行命令、编辑文件、跑测试。
- 工作模式:人提需求 → Agent 分析 → 写代码 → 跑测试 → 报告结果。
原理流程
- 在项目根目录启动
claude。 - 描述需求:"帮我加一个用户登录接口"。
- Agent 读取相关文件,分析代码结构。
- 生成代码,编辑文件。
- 跑测试,报告结果。
- 人审查和调整。
代码 / 示例
# Claude Code 基本用法
cd my-project
claude
# 对话示例:
# > 帮我写一个 Python 函数, 输入 URL 列表, 返回每个页面的标题
#
# Claude 会:
# 1. 查看项目结构和现有代码
# 2. 生成函数代码
# 3. 编辑文件
# 4. 跑测试
# 5. 报告结果
常见误区
- 误区:Claude Code 是自动编码机器;正解:它是交互式助手,需要人引导和审查。
- 误区:Claude Code 能访问整个项目就够了;正解:上下文窗口有限,大项目需要明确告诉它看哪些文件。
追问
- Q:Claude Code 怎么处理大项目? A:它会主动读取相关文件,你也可以告诉它"看一下 src/auth 目录",引导上下文。
- Q:Claude Code 安全吗? A:它能执行命令,有安全风险,要注意不要让它执行危险操作(如 rm -rf)。
10.9.5-003 Cursor 的 AI 编程模式?
频率 ★★★★ | 难度 基础
一句话结论
Cursor 是 AI 原生代码编辑器:在 IDE 里集成 AI 能力,核心功能有 Code Completion(自动补全)、Chat(对话问答)、Composer(多文件编辑)、Apply(代码修改);是"AI 辅助编程"的 IDE 方案。
概念解释
- Code Completion:类似 GitHub Copilot,行级/块级自动补全。
- Chat:侧边栏对话,问代码问题、解释代码。
- Composer:多文件同时编辑,Agent 模式。
- Apply:AI 生成的代码一键应用到编辑器。
- 优势:在 IDE 里,上下文自然,不用切换工具。
原理流程
- 写代码时,Cursor 自动补全建议。
- 遇到问题,打开 Chat 问 AI。
- 需要大改,用 Composer 让 AI 同时改多个文件。
- 人审查 AI 的修改。
代码 / 示例
Cursor 核心功能:
- Tab 补全: 类似 Copilot, 实时补全
- Chat: Ctrl+L 打开对话, 问代码问题
- Composer: Ctrl+I, Agent 模式改多文件
- Apply: AI 生成的 diff 一键应用
- 代码库索引: 自动索引项目, 全局搜索上下文
常见误区
- 误区:Cursor 就是 Copilot 的替代品;正解:Cursor 的 AI 集成更深,Composer 多文件编辑是独特优势。
- 误区:Cursor 只能写新代码;正解:Cursor 也能解释代码、修 bug、写测试。
追问
- Q:Cursor 和 VS Code 什么关系? A:Cursor 基于 VS Code fork,插件生态兼容,快捷键一致。
- Q:Cursor 的代码库索引有什么用? A:Agent 能搜索整个代码库,理解跨文件的依赖关系,不用手动贴上下文。
10.9.5-004 怎么给编码 Agent 提供上下文?
频率 ★★★★ | 难度 进阶
一句话结论
上下文质量决定输出质量:要告诉 Agent 项目结构、相关文件、业务背景、编码规范;不要只说"帮我加个功能",要给足上下文,Agent 才能写出符合项目风格的代码。
概念解释
- 项目结构:告诉 Agent 目录结构和技术栈。
- 相关文件:直接告诉它看哪些文件。
- 业务背景:解释业务逻辑和约束。
- 编码规范:告诉它代码风格、命名约定。
- 示例:给一个类似功能的现有代码作为参考。
原理流程
- 启动时:告诉 Agent 项目技术栈和目录结构。
- 提需求时:附上相关文件路径和业务背景。
- 给参考:给一个现有类似功能的代码。
- 明确约束:说清楚不能做什么、性能要求等。
代码 / 示例
好的 prompt 示例:
"项目是 React + TypeScript, 目录结构:
src/components/ - 组件
src/hooks/ - 自定义 hooks
src/utils/ - 工具函数
帮我加一个 UserProfile 组件, 参考 src/components/OrderList.tsx 的写法,
用 React Query 取数据, 样式用 Tailwind,
接口是 GET /api/users/:id, 返回 { name, email, avatar }"
差的 prompt 示例:
"帮我写一个用户资料组件"
常见误区
- 误区:Agent 能自己理解整个项目;正解:上下文窗口有限,大项目必须主动提供相关文件和背景。
- 误区:给越多上下文越好;正解:上下文太多会稀释重点,只给相关的文件和信息。
追问
- Q:怎么管理上下文? A:用 CLAUDE.md 或 .cursorrules 文件,把项目规范、技术栈、目录结构写在里面,Agent 启动时自动读取。
- Q:上下文太长怎么办? A:分步迭代,先做一个小功能,再做下一个,不要一次让它做太多。
10.9.5-005 编码 Agent 写的代码怎么审查?
频率 ★★★★ | 难度 基础
一句话结论
审查要点:功能正确性(是否实现需求)、安全性(有没有注入、越权)、性能(有没有 N+1、死循环)、风格一致性(是否符合项目规范)、测试覆盖(有没有测试用例);Agent 写的代码必须人工审查才能合并。
概念解释
- 功能正确性:代码是否真的实现了需求。
- 安全:SQL 注入、XSS、越权、敏感信息泄露。
- 性能:时间复杂度、数据库查询、内存泄漏。
- 风格:命名、结构、是否符合项目规范。
- 测试:有没有写测试,测试是否覆盖。
原理流程
- 看 diff:Agent 改了哪些文件。
- 跑测试:现有测试是否通过。
- 安全审查:有没有明显安全问题。
- 性能检查:有没有性能隐患。
- 风格检查:是否符合项目规范。
- 人决定合并或打回修改。
代码 / 示例
代码审查清单:
[ ] 功能是否符合需求
[ ] 有没有安全漏洞 (注入/越权/泄露)
[ ] 有没有性能问题 (N+1/死循环/内存泄漏)
[ ] 错误处理是否完善
[ ] 有没有写测试用例
[ ] 命名和风格是否符合项目规范
[ ] 有没有多余的注释或调试代码
常见误区
- 误区:Agent 写的代码不用仔细看;正解:Agent 可能引入安全漏洞、性能问题,必须人工审查。
- 误区:跑了测试就没问题了;正解:测试覆盖可能不全,边界情况可能没测到。
追问
- Q:怎么提高审查效率? A:用 CI/CD 自动检查(lint、测试、安全扫描),人只做逻辑和架构审查。
- Q:Agent 写的代码有问题怎么办? A:直接告诉它哪里不对,让它修改,迭代到满意为止。
10.9.5-006 编码 Agent 有什么安全风险?
频率 ★★★ | 难度 进阶
一句话结论
主要风险:提示注入(恶意代码/指令让 Agent 执行危险操作)、代码漏洞(Agent 写出有安全问题的代码)、数据泄露(Agent 把敏感代码/数据发送到外部 API)、命令执行(Agent 执行危险命令);需要严格管控。
概念解释
- 提示注入:恶意文件内容让 Agent 执行非预期操作。
- 代码漏洞:Agent 写出有安全漏洞的代码。
- 数据泄露:Agent 把公司代码发送到外部 LLM API。
- 命令执行:Agent 执行危险命令(删除文件、外传数据)。
原理流程
- 提示注入:仓库里有恶意 README,Agent 读取后被注入指令。
- 代码漏洞:Agent 写出 SQL 注入漏洞。
- 数据泄露:Agent 把代码内容发送到 OpenAI API。
- 命令执行:Agent 跑了
rm -rf或外传数据的命令。
代码 / 示例
安全风险清单:
- 提示注入: 恶意文件内容诱导 Agent 执行危险操作
- 代码漏洞: Agent 写出有安全漏洞的代码
- 数据泄露: 公司代码被发送到外部 LLM API
- 命令执行: Agent 执行危险 shell 命令
- 供应链: Agent 引入有漏洞的第三方库
常见误区
- 误区:编码 Agent 很安全不用管;正解:Agent 有执行权限,安全风险很大,必须管控。
- 误区:公司代码发到外部 API 没问题;正解:敏感代码和数据不能发到外部 API,需要本地模型或脱敏。
追问
- Q:怎么防止数据泄露? A:用本地模型、或确保 LLM 提供商不保留数据、敏感代码脱敏后再发送。
- Q:怎么防止提示注入? A:不要让 Agent 执行未审查的命令、对输入文件做安全扫描、限制 Agent 的权限。
10.9.5-007 怎么用编码 Agent 做大规模重构?
频率 ★★★ | 难度 高级
一句话结论
大规模重构要分步走:先明确目标和约束 → 小步试点改一个模块 → 验证通过 → 逐步推广到其他模块;不要一次让 Agent 改整个项目,容易失控。
概念解释
- 分步走:不要大爆炸式重构,小步迭代。
- 先试点:选一个模块做试点,验证 Agent 能力。
- 验证:每步都要跑测试,确保不破坏功能。
- 回滚:每步都有 git 提交,出问题能回滚。
原理流程
- 明确重构目标:要改成什么样。
- 选一个模块试点:让 Agent 重构这个模块。
- 人工审查和验证。
- 验证通过,总结经验。
- 逐步推广到其他模块。
代码 / 示例
大规模重构步骤:
1. 明确目标: 把所有回调函数改成 async/await
2. 选一个模块试点: 先改 src/auth 模块
3. Agent 重构, 人审查, 跑测试
4. 提交 git, 记录经验
5. 推广到下一个模块: src/api
6. 重复直到全部完成
常见误区
- 误区:让 Agent 一次重构整个项目;正解:一次改太多,出了问题很难定位,必须分步走。
- 误区:重构就是让 Agent 自己改;正解:人要全程控制方向,Agent 只是执行工具。
追问
- Q:怎么保证重构不破坏功能? A:先有完整的测试覆盖,重构后跑全部测试,确保行为不变。
- Q:重构到一半 Agent 卡住了怎么办? A:人介入,手动完成剩下的部分,不要硬推。
10.9.5-008 团队怎么规范使用编码 Agent?
频率 ★★★ | 难度 基础
一句话结论
团队规范:明确哪些场景可以用、哪些不能用、代码审查必须人工、敏感数据不能发到外部 API、用 CLAUDE.md/.cursorrules 统一项目规范;让 Agent 成为团队生产力工具,而不是混乱来源。
概念解释
- 使用场景:明确什么场景用、什么场景不用。
- 代码审查:所有 Agent 生成的代码必须人工审查。
- 数据安全:敏感代码不能发到外部 API。
- 规范统一:用配置文件定义项目规范,Agent 自动遵循。
- 知识沉淀:好的 prompt 和用法沉淀到团队文档。
原理流程
- 制定使用规范:什么场景用、什么不能用。
- 写 CLAUDE.md/.cursorrules:项目技术栈、规范、目录结构。
- 代码审查流程:Agent 代码必须人工审查。
- 定期分享:好的用法和经验团队分享。
代码 / 示例
团队规范示例:
- 可以用: 写新功能、修 bug、写测试、解释代码
- 不能用: 直接合并 Agent 代码不审查、敏感代码发外部 API
- 必须: 人工审查、跑测试、安全检查
- 规范: CLAUDE.md 定义项目结构和编码规范
- 分享: 每周分享好的 Agent 使用技巧
常见误区
- 误区:团队用 Agent 不需要规范;正解:没有规范会导致代码风格混乱、安全风险、质量下降。
- 误区:规范越严越好;正解:规范要平衡效率和质量,太严会让大家不想用。
追问
- Q:怎么衡量 Agent 对团队的价值? A:看开发效率提升(PR 数量、交付速度)、代码质量(bug 率)、开发者满意度。
- Q:团队里有人不用 Agent 怎么办? A:不强制,先让想用的人用,出成果了自然有人跟。
待整理清单
- [ ] 编码 Agent 的提示工程最佳实践
- [ ] CLAUDE.md / .cursorrules 的编写
- [ ] Agent 生成代码的自动化审查流程
- [ ] 本地模型做编码 Agent 的方案
- [ ] 编码 Agent 与 CI/CD 集成