我要投稿

【早阅】Claude Code最佳实践

发布日期：2025-08-07 20:05:19 浏览次数： 1512

作者：前端早读课

微信搜一搜，关注“前端早读课”

洞察

1.Claude Code：纯粹的 AI 编码代理: Claude Code 作为一个纯粹的 AI 代理，通过工具和循环自主工作，像一位精通终端的同事。它不索引代码库，而是通过探索式搜索理解代码，有效提高开发效率。

2.Claude Code 的多样化应用场景: Claude Code 广泛应用于代码发现、充当思想伙伴、自动化代码生成、部署和调试。它能加速新项目适应，协助复杂代码迁移，并解决 CLI 工具相关问题。

3. 提升 Claude Code 效率的关键实践：最佳实践包括使用 cloud.md 共享指令和状态，智能管理权限，以及有效处理上下文。这些方法能够优化 Claude Code 的工作流程，提升效率。

4. 高效工作流与智能编码策略：高效工作流涉及规划任务、利用待办列表和智能编码策略。采用测试驱动开发、小步提交、利用截图指导，并考虑多代理协作，以实现更优的开发成果。

5.Claude Code 的新功能与 IDE 集成: Claude Code 持续更新，新功能包括模型切换和工具调用间 “思考” 能力，提升了问题解决精度。深度集成主流 IDE，进一步优化开发体验。

6.Claude Code 的未来发展与协作：未来的发展方向包括更强的指令遵循能力和多代理并行执行。用户可以通过共享文件实现多代理协作，虽然产品尚未原生支持，但未来会探索更原生的解决方案。

【第3495期】Claude Code：智能编码的最佳实践

引言：认识 Claude Code

本次演讲旨在深入探讨 Claude Code 的最佳实践和高效应用。演讲者 Cal，作为 Anthropic 应用人工智能团队的核心贡献者，分享了他使用 Claude Code 的个人经历和心得。他回忆了自己如何从一个充满创意但项目烂尾的程序员，在使用 Claude Code 后，在短短一个周末内极大地改变了编程方式和软件工程思维。Cal 强调，Claude Code 就像一位精通终端的同事，能够极大地提高开发效率，特别是在处理复杂任务时。他最初担心使用过多的计算资源，但后来发现自己在内部使用排行榜上名列前茅，并因此加入了 Claude Code 团队，专注于提示词工程、工具使用和评估方法论，确保工具的持续优化和有效性。

Claude Code 的 Agentic 工作方式

Anthropic 团队秉持 “简单有效” 的原则开发 Claude Code，使其成为一个纯粹的智能代理。这意味着 Claude Code 依赖于一系列指令和强大的工具，并在循环中自主运行，直到任务完成。这些工具模拟了终端高手的操作，包括创建、编辑文件和使用命令行工具。与传统代码工具不同，Claude Code 不会预先索引整个代码库，而是通过探索式搜索来理解代码，就像新加入团队的开发者一样。它使用类似 glob、gp 和 find 等搜索工具进行探索性搜索，并根据搜索结果进行迭代，逐步构建对代码库的理解。这种代理式搜索能力是其核心优势。

核心能力与辅助系统

Claude Code 在其核心代理功能之上，还整合了用户界面层、权限管理系统和强大的安全机制。用户可以通过简洁的 UI 实时观察 Claude Code 的操作过程。权限系统能够智能地在代理执行可能修改用户机器的危险操作时介入，强制人工确认，从而确保操作的安全性和可控性。此外，由于 Claude Code 本身是模型上的轻量级层，并且 Anthropic API 模型也通过 AWS 和 GCP 等云提供商提供，这使得用户可以根据自己的偏好，将 Claude Code 指向这些服务，进一步增强了工具的灵活性和安全性。

Claude Code 的实用场景

Claude Code 具备广泛的应用场景，能够显著提升开发者的工作效率。它不仅在代码发现和理解方面表现出色，还能充当开发者的思想伙伴，并在代码构建、部署和调试等生命周期的各个阶段提供支持。无论是初次接触新代码库，还是进行大规模的代码迁移，Claude Code 都能提供强大的辅助。

【第3360期】在JavaScript中从外部解决Promise：实际应用场景

代码发现与理解

对于初次接触新代码库的开发者而言，Claude Code 能够极大地加速熟悉过程。用户可以询问 Claude 特定功能实现的具体位置，或者利用其强大的终端操作能力，查看文件修改历史并总结代码随时间的变化。例如，你可以让 Claude Code 分析某个文件的 Git 历史，从而快速了解其演变过程，有效减少新项目或新团队的适应期。

作为思想伙伴

在启动新功能开发或进行重大代码更改之前，Claude Code 可以充当出色的思想伙伴。开发者可以要求 Claude 探索代码库，并提出两到三种不同的实现方案，而不是立即开始编码。通过这种方式，开发者可以与 Claude 共同验证这些想法，确保在投入实际开发前，选择最优的解决方案。这种协作模式有助于避免不必要的返工和优化开发流程。

代码构建与维护

Claude Code 在代码的从零开始构建和现有代码库的维护方面都表现出色。它可以轻松地在空目录中创建一个完整的应用程序或游戏演示。更重要的是，Claude Code 在现有代码库中进行工作时，其价值体现得淋漓尽致。例如，Claude Code 团队自身就利用该工具来轻松添加单元测试，从而保持异常高的代码覆盖率。此外，它还能自动生成高质量的提交信息和 Pull Request 描述，显著简化了版本控制流程。这些能力使得 Claude Code 成为提升代码质量和开发效率的强大工具。

【第3460期】如何在前端开发中实现零停机部署

部署与支持

Claude Code SDK 使得代理可以无头或以编程方式集成到部署流程和持续集成 / 持续交付（CI/CD）管道中，例如在 GitHub Actions 中实现自动化编程辅助。在支持和规模化方面，Claude Code 能够加快错误调试。一个意想不到但重要的用例是帮助团队处理大型代码库迁移项目，如从旧版 Java 升级或从 PHP 迁移到 React/Angular。有了 Claude Code，这些通常耗时耗力的项目变得更易于管理和消化。其对 Git、Docker、BigQuery 等 CLI 工具的精通，也使得它能轻松解决复杂的版本控制问题，例如 Git rebase 冲突。

Claude Code 最佳实践

要充分发挥 Claude Code 的潜力，掌握其最佳实践至关重要。这些实践涵盖了如何有效管理上下文、利用其权限系统以及优化工作流程，从而实现更高效、更安全的开发体验。

【第3533期】Cursor AI 最佳实践：使用“金标准文件”工作流以获得更精确的结果

使用 `cloud.md` 文件

cloud.md 文件是 Claude Code 分享状态和指令的核心机制，因为它本身没有内置记忆功能。当 Claude 启动时，工作目录中的 cloud.md 文件会被加载到其上下文中，作为开发者留下的重要指示。你可以将 cloud.md 文件放入项目并提交到版本控制，以便团队成员共享。也可以在用户主目录中放置一个 cloud.md 文件，包含你希望 Claude 始终了解的信息，无论当前正在处理哪个项目。文件中可以包含运行单元测试的方法、项目布局概述、测试文件位置、模块划分、代码风格指南等，从而简化 Claude 的工作。

权限管理

在运行 Claude Code 时，权限管理是关键。默认情况下，对于读取操作（如搜索或阅读），Claude 会自动执行。然而，当涉及到写入文件、运行 Bash 命令或任何可能修改机器内容的操作时，Claude Code 会触发用户界面提示，要求人工确认。你可以选择允许、始终允许或拒绝。智能地利用权限管理，例如启用自动接受模式（通过 Shift+Tab 键），或在设置中配置特定命令的自动批准（如 npm run test），可以显著加快工作流程。

集成设置与上下文管理

Claude Code 擅长与命令行工具集成，例如 GitHub CLI (GH)。通过安装更多的 CLI 工具或附加 MCP 服务器，可以扩展 Claude Code 的工作范围。对于成熟且有良好文档的 CLI 工具，通常建议优先使用它们。如果内部有自定义工具，也可以通过 cloud.md 文件告知 Claude。在长期会话中，Claude 的上下文窗口（最高可达 200,000 个 token）可能会被填满。此时，用户有以下两种选择：

使用 /clear 命令清除所有上下文（除了 cloud.md 等），重新开始会话。
使用 /compact 命令让 Claude 自动总结当前会话内容，并用总结作为新会话的起点，从而有效地管理和压缩上下文。

高效工作流程与智能编码

通过利用规划和待办事项列表，可以极大地优化与 Claude Code 的协作。当遇到 Bug 时，可以要求 Claude 先搜索原因并提出修复计划，这能节省大量时间。此外，Claude 在执行大型任务时通常会创建待办事项列表，用户可以监控此列表，并在发现不合理或错误路径时及时按 Escape 键介入，引导 Claude 修正方向。为了确保代码质量，建议采用测试驱动开发（TDD）方法，让 Claude 进行小步更改后立即运行测试，确保通过。同时，要让 Claude 始终检查 TypeScript 和代码风格，并定期提交代码，以便在出现偏差时能够回滚。

引导与高级技术

Claude 的多模态能力允许用户通过截图来指导和调试，例如将 UI 截图粘贴给 Claude，让它根据图片构建网页。随着熟练度的提升，可以尝试高级技术，例如同时运行多个 Claude 实例来协同处理任务，通过 T-Mox 或多标签页实现多代理编排。Escape 键是用户的好朋友，它允许随时中断 Claude 的工作并介入，引导其回到正确的路径。掌握何时介入，何时让 Claude 自行解决问题，是高效使用工具的关键。此外，连续按两次 Escape 键可以回溯会话，重置工具扩展。如果默认工具集无法满足需求，可以探索 MCP 服务器。最后，无头自动化是其未来发展的重点，即如何以编程方式在 GitHub Actions 等环境中应用 Claude 代理，实现更深层次的集成和自动化。

Claude Code 新功能亮点

为了保持 Claude Code 的最佳使用体验，持续关注其最新功能和更新至关重要。 Anthropic 团队正在快速迭代，不断推出新特性来增强其能力。

模型选择与扩展思维

现在，用户可以通过 /model 或 /config 命令轻松切换 Claude 运行的模型，例如从默认的 Sonnet 切换到 Opus，以找到最适合当前任务的模型。此外，Claude 4 及更新的模型引入了在工具调用之间进行 “思考” 的能力，这被称为 “硬思考” 或 “扩展思考”。这意味着模型在执行工具操作（如搜索文件或阅读内容）前后都能进行深入思考，从而更有效地解决复杂问题。用户可以通过观察更浅的灰色文本提示来识别这种思考过程，它显著提升了 Claude 处理任务和调试 Bug 的能力。

集成开发环境（IDE）集成

Claude Code 提供了与主流 IDE 的深度集成，例如 VS Code 和 JetBrains 系列产品。这些集成允许 Claude 感知用户当前所在的文件，并提供上下文相关的帮助和建议。这意味着 Claude 能够更智能地理解用户的意图，并在编码过程中提供更精准的辅助，进一步优化开发体验。

保持更新

为了跟上 Claude Code 的快速发展步伐，建议定期查阅 Anthropic 的 Claude Code GitHub 项目，该项目会发布详细的更新日志和新功能介绍。即使是团队内部成员，也需要定期检查更新，以确保充分利用所有最新特性。

问答：深入理解与展望

在问答环节，演讲者 Cal 回答了关于 cloud.md 文件管理和 Claude 指令遵循能力的问题，并展望了多代理协作的未来。

多 `cloud.md` 文件的处理

在同一个目录下不能有多个 cloud.md 文件，但在子目录中可以存在。然而，默认情况下，Claude 只会读取启动时当前工作目录下的 cloud.md 文件。为了避免在大型仓库中上下文爆炸，Claude 被鼓励在搜索子目录时，如果发现相关的 cloud.md 文件，应主动读取它们。此外，用户可以在主目录设置一个全局 cloud.md。新功能允许在 cloud.md 中引用其他文件，这提供了一种灵活的方式来合并不同 cloud.md 文件的内容。

模型指令遵循能力提升

过去，即使在提示词中明确指示不要添加内联注释，Claude 3.7 也倾向于添加大量注释。这是一个模型层面的问题，并非通过 cloud.md 文件能轻易解决。然而，Claude 4 在指令遵循方面有了显著改进，大大减少了不必要的注释，并更严格地遵守用户的 cloud.md 指令。因此，升级到新模型可能是一个回顾并优化 cloud.md 内容的好时机，以移除不再必要的旧指令，并根据新模型的改进添加新的指引。

“我们总是尝试做那些简单但有效的事情。”

多代理并行执行的设想

目前，Anthropic 专注于打造一个强大的单一编码代理。虽然产品尚未原生支持多代理并行执行和上下文共享，但用户可以通过一些创造性方法实现类似效果。例如，让不同的 Claude 代理将状态写入共享的 Markdown 文件，然后其他代理再读取这些文件进行通信和协作。例如，一个代理可以为另一个代理留下一个 ticket.md 文件，指定接下来的工作内容。这种通过文件共享状态的方式，可以利用模型强大的文件读取和理解能力，是目前实现多代理协作的最佳实践。

原文：https://www.youtube.com/watch?v=gv0WHhKelSE

😀 每天只需花五分钟即可阅读到的技术资讯，加入【早阅】共学，可联系 vx：zhgb_f2er