AI 编程

如何使用 Claude Code 进行软件开发

一套实用的 Claude Code 开发工作流，涵盖阅读代码库、规划变更、编写测试、编辑文件、运行验证和使用提示词示例。

发布于 更新于
Claude CodeAI 编程开发者工作流

将 Claude Code 视为能够访问项目的智能体编程伙伴，而不是一个只回答问题的普通聊天机器人，才能发挥其最大价值。最有效的工作流很简单：让 Claude Code 阅读代码库，请它解释相关架构，要求它在编辑前制定计划，规定必须运行测试或构建检查，然后在提交前审核差异。

本指南介绍如何使用 Claude Code 进行软件开发，同时避免让每项任务都变成不受控制的 vibe coding。目标是在保留人工判断、仓库规范和验证环节的前提下，获得实用的实施协助。

本指南适合谁

  • 希望使用 Claude Code 协助构建功能、修复缺陷、重构代码和编写测试的开发者
  • 使用 AI 编程工具但仍需要可靠交付习惯的创始人和独立开发者
  • 需要规划、实施、审核和验证实用提示词示例的产品工程师
  • 使用代码审查、CI、问题跟踪和明确开发规范的团队

分步工作流程

  1. 从项目根目录开始，让 Claude Code 可以读取代码库、项目脚本、测试和本地说明。
  2. 添加或更新 CLAUDE.md，写明编码规范、架构规则、测试命令、分支规则和审核要求。
  3. 要求 Claude Code 在编辑前探索：哪些文件相关、现有模式是什么，以及它发现了哪些风险。
  4. 要求提供简短的实施计划；如果任务有风险、跨模块或对产品敏感，让它等待批准。
  5. 每次只交付一项小任务，并说明预期行为、受影响的路由或模块、验收标准和验证命令。
  6. 当变更影响行为、SEO、数据流、身份验证、计费或面向用户的界面时，要求 Claude Code 先编写或更新测试。
  7. 让它编辑文件，然后要求运行测试、lint、构建、截图或其他可能失败的具体检查。
  8. 亲自审核最终差异，尤其要检查迁移、环境变量使用、身份验证边界、破坏性命令和生成的文案。
  9. 只有当验证输出干净且变更符合原始目标时才提交。

推荐工具

  • Claude 适合长上下文推理、代码审查、规划和严谨的实施支持
  • ChatGPT 适合提供备选实施构想、调试说明和快速的第二意见
  • Perplexity 适合在添加不熟悉的依赖项或 API 前开展有来源支持的研究
  • Goodiebase AI Image Generator 适合在代码工作流准备就绪后制作产品图片、缩略图和视觉素材

常见错误

  • Claude Code 尚未理解仓库结构，就让它开始实施
  • 使用“improve this app”之类的宽泛提示词，却不提供验收标准、文件或验证命令
  • 因为变更看起来很小，就让智能体跳过测试
  • 在同一个会话中要求多项互不相关的变更，导致审核更困难
  • 不检查差异就接受编辑，尤其是身份验证、计费、数据库和部署代码
  • 忘记 Claude Code 可以运行命令，因此提示词应准确说明成功标准

实用示例

提示词 1：探索代码库

You are working in this repository. Read the project structure, package scripts, route layout, and existing tests before suggesting changes. Do not edit files yet. Explain the files that matter for adding a new SEO-friendly guide page, the existing patterns I should follow, and the safest verification command.

提示词 2：编辑前制定计划

I want to add a guide page called "How to use Claude Code for software development". Use the existing guide content model and SEO rules. Propose a concise plan first, including the slug, metadata, content sections, tests to update, and sitemap impact. Wait for approval before editing files.

提示词 3：通过测试实施

Implement the approved guide page. Add a failing test first that checks the slug, title, SEO metadata, Claude Code development workflow, CLAUDE.md mention, prompt examples, published date, and no external source links in the guide content. Then add the content, run the targeted test, run the full test suite, and run the production build.

提示词 4：通过验证修复缺陷

The guide detail page is rendering list formatting incorrectly. Reproduce the issue from the existing component and content, identify the root cause, make the smallest fix, and run the test that proves guide content still renders headings, ordered steps, unordered lists, links, and FAQ sections correctly.

提示词 5：提交前审核

Review the current diff as if you are doing code review. Focus on SEO regressions, sitemap coverage, missing tests, route behavior, unexpected environment changes, and content that could become thin or misleading. List findings first. If there are no blockers, summarize the verification commands that passed and suggest a commit message.

常见问题

问：Claude Code 只能用来编写新代码吗？ 答：不是。它也适合阅读陌生代码、解释架构、编写测试、修复缺陷、重构、审核差异、生成发布说明和自动处理重复开发任务。

问：应该让 Claude Code 立即编辑文件吗？ 答：对于小而明确的变更，这样做没有问题。对于规模较大的工作，应先让它探索和规划，以便在代码改动扩散前发现错误假设。

问：CLAUDE.md 中应该写什么？ 答：添加项目专属说明，例如构建命令、测试命令、样式规则、架构边界、安全规则、首选库，以及提交前必须验证的事项。

问：如何防止 Claude Code 进行高风险变更？ 答：保持任务小而明确，敏感工作先要求制定计划，审核工具权限，要求先写测试，并将验证命令纳入提示词。

相关工具

相关指南