Claude Code 最佳实践指南：从原理到落地的全流程技巧

Claude Code 最佳实践指南：从原理到落地的全流程技巧 Claude Code 最佳实践指南：从原理到落地的全流程技巧 Modified August 10, 2025 熟悉后可以同时使用多个 Claude 实例（Anthropic 和部分客户运行四个），在团队面板或多标签页协调任务；善用 Esc 键——工作时留意动态，按 Esc 可打断并调整方向，连续按两次 Esc 能回溯重置对话；使用工具扩展和 MCP 服务器，若 bash 和现有工具不够用，就用 MCP 服务器；尝试无头自动化，比如在 GitHub Actions 中使用，我们也在探索更多创意场景，也挑战大家一起尝试。 8. 新功能与动态更新 最后，我来实际操作演示一下。 一个重要的最佳实践是始终关注最新动态——我们更新速度极快。比如现在进入 Claude 可以选择模型（默认 sonnet，可切换到 opus）；Claude 四代开始支持工具调用之间“思考”，触发后会显示浅灰色文本思考过程，再调用工具，处理任务和 bug 时加入深入思考环节很有用；还有 vs code 和 jetbrains 的新集成，能让 Claude 知道你当前所在文件。大家可以关注公开的 GitHub 项目“claude code（Anthropic 旗下）”，那里有问题提交和变更日志，建议每周检查一次。 9. 问答环节：实操问题解答 现在还有四分钟，我很乐意回答问题，也可以现场演示功能。 问题 回答 一个项目中有多个 Claude MD 文件，会自动识别吗？ 同一目录不能有多个，但主目录和子目录可以有。默认只读取当前工作目录的 Claude MD 文件，子目录中的需要 Claude 搜索时发现；新功能支持在 Claude MD 中用@符号引用其他文件，方便读取已知必要文件。 如何让 Claude 尊重 Claude MD 中的指令（比如重构时保留部分行内注释）？ 这是模型问题，我们在提示词中做了很多限制，但模型原本喜欢发评论。Claude 四代改进了这一点，更擅长执行指令，建议检查 Claude MD 内容（移除冗余、添加新需求），并转向新模型，重新审视需求归档不必要内容。 多智能体执行与并行化，能否让多个智能体共享上下文？ 目前我们先专注让单个代理擅长编码，若要实现多智能体协作，可让所有代理写入共享 markdown 文件（如 ticket md），启动另一个代理时让它读取该文件，依赖模型读取和理解文件的能力，这是目前可行的方法，未来可能有更原生的解决方案。 以上就是我的分享，谢谢大家。 二、总结 类别 核心内容 演讲者背景 卡尔，Anthropic AI项目组成员，因高频使用Claude Code成为核心贡献者，负责系统提示词开发等工作。 工具定位 终端操作高手般的智能体，如同“随时可用的技术导师”，擅长通过终端工具解决编程问题。 底层原理 1. 基于指令系统+工具，模型循环运行至任务完成； 2. 不索引代码库，通过glob/grep/find等命令逐步探索理解； 3. 含轻量UI层、权限系统（危险操作需确认），兼容云服务商。 适用场景 1. 新代码库探索（提升入职效率）； 2. 思维伙伴（提供实现方案）； 3. 代码开发（从零到一/现有库、写测试、生成提交信息）； 4. 部署集成（SDK调用，CI/CD等）； 5. 调试、技术迁移、CLI工具操作。 最佳实践 1. 用Claude MD文件共享状态（项目/主目录存放指令）； 2. 权限管理（自动接受模式）； 3. 优先用知名CLI工具； 4. 上下文满时清除/压缩； 5. 规划待办、测试驱动开发、多实例协作； 6. 关注GitHub更新。 新功能 1. 模型切换（sonnet/opus）； 2. 工具调用间“思考”功能（Claude四代）； 3. vs code/jetbrains集成（识别当前文件）。 问答要点 1. 多Claude MD文件：默认读当前目录，支持@引用； 2. 指令执行：Claude四代优化，需更新模型和MD内容； 3. 多智能体协作：通过共享文件传递状态。 熟悉后可以同时使用多个 Claude 实例（Anthropic 和部分客户运行四个），在团队面板或多标签页协调任务；善用 Esc 键——工作时留意动态，按 Esc 可打断并调整方向，连续按两次 Esc 能回溯重置对话；使用工具扩展和 MCP 服务器，若 bash 和现有工具不够用，就用 MCP 服务器；尝试无头自动化，比如在 GitHub Actions 中使用，我们也在探索更多创意场景，也挑战大家一起尝试。 8. 新功能与动态更新 最后，我来实际操作演示一下。 一个重要的最佳实践是始终关注最新动态——我们更新速度极快。比如现在进入 Claude 可以选择模型（默认 sonnet，可切换到 opus）；Claude 四代开始支持工具调用之间“思考”，触发后会显示浅灰色文本思考过程，再调用工具，处理任务和 bug 时加入深入思考环节很有用；还有 vs code 和 jetbrains 的新集成，能让 Claude 知道你当前所在文件。大家可以关注公开的 GitHub 项目“claude code（Anthropic 旗下）”，那里有问题提交和变更日志，建议每周检查一次。 9. 问答环节：实操问题解答 现在还有四分钟，我很乐意回答问题，也可以现场演示功能。 问题 回答 一个项目中有多个 Claude MD 文件，会自动识别吗？ 同一目录不能有多个，但主目录和子目录可以有。默认只读取当前工作目录的 Claude MD 文件，子目录中的需要 Claude 搜索时发现；新功能支持在 Claude MD 中用@符号引用其他文件，方便读取已知必要文件。 如何让 Claude 尊重 Claude MD 中的指令（比如重构时保留部分行内注释）？ 这是模型问题，我们在提示词中做了很多限制，但模型原本喜欢发评论。Claude 四代改进了这一点，更擅长执行指令，建议检查 Claude MD 内容（移除冗余、添加新需求），并转向新模型，重新审视需求归档不必要内容。 多智能体执行与并行化，能否让多个智能体共享上下文？ 目前我们先专注让单个代理擅长编码，若要实现多智能体协作，可让所有代理写入共享 markdown 文件（如 ticket md），启动另一个代理时让它读取该文件，依赖模型读取和理解文件的能力，这是目前可行的方法，未来可能有更原生的解决方案。 问题 问题 回答 回答 一个项目中有多个 Claude MD 文件，会自动识别吗？ 一个项目中有多个 Claude MD 文件，会自动识别吗？ 同一目录不能有多个，但主目录和子目录可以有。默认只读取当前工作目录的 Claude MD 文件，子目录中的需要 Claude 搜索时发现；新功能支持在 Claude MD 中用@符号引用其他文件，方便读取已知必要文件。 同一目录不能有多个，但主目录和子目录可以有。默认只读取当前工作目录的 Claude MD 文件，子目录中的需要 Claude 搜索时发现；新功能支持在 Claude MD 中用@符号引用其他文件，方便读取已知必要文件。 如何让 Claude 尊重 Claude MD 中的指令（比如重构时保留部分行内注释）？ 如何让 Claude 尊重 Claude MD 中的指令（比如重构时保留部分行内注释）？ 这是模型问题，我们在提示词中做了很多限制，但模型原本喜欢发评论。Claude 四代改进了这一点，更擅长执行指令，建议检查 Claude MD 内容（移除冗余、添加新需求），并转向新模型，重新审视需求归档不必要内容。 这是模型问题，我们在提示词中做了很多限制，但模型原本喜欢发评论。Claude 四代改进了这一点，更擅长执行指令，建议检查 Claude MD 内容（移除冗余、添加新需求），并转向新模型，重新审视需求归档不必要内容。 多智能体执行与并行化，能否让多个智能体共享上下文？ 多智能体执行与并行化，能否让多个智能体共享上下文？ 目前我们先专注让单个代理擅长编码，若要实现多智能体协作，可让所有代理写入共享 markdown 文件（如 ticket md），启动另一个代理时让它读取该文件，依赖模型读取和理解文件的能力，这是目前可行的方法，未来可能有更原生的解决方案。 目前我们先专注让单个代理擅长编码，若要实现多智能体协作，可让所有代理写入共享 markdown 文件（如 ticket md），启动另一个代理时让它读取该文件，依赖模型读取和理解文件的能力，这是目前可行的方法，未来可能有更原生的解决方案。 以上就是我的分享，谢谢大家。 二、总结 类别 核心内容 演讲者背景 卡尔，Anthropic AI项目组成员，因高频使用Claude Code成为核心贡献者，负责系统提示词开发等工作。 工具定位 终端操作高手般的智能体，如同“随时可用的技术导师”，擅长通过终端工具解决编程问题。 底层原理 1. 基于指令系统+工具，模型循环运行至任务完成； 2. 不索引代码库，通过glob/grep/find等命令逐步探索理解； 3. 含轻量UI层、权限系统（危险操作需确认），兼容云服务商。 适用场景 1. 新代码库探索（提升入职效率）； 2. 思维伙伴（提供实现方案）； 3. 代码开发（从零到一/现有库、写测试、生成提交信息）； 4. 部署集成（SDK调用，CI/CD等）； 5. 调试、技术迁移、CLI工具操作。 最佳实践 1. 用Claude MD文件共享状态（项目/主目录存放指令）； 2. 权限管理（自动接受模式）； 3. 优先用知名CLI工具； 4. 上下文满时清除/压缩； 5. 规划待办、测试驱动开发、多实例协作； 6. 关注GitHub更新。 新功能 1. 模型切换（sonnet/opus）； 2. 工具调用间“思考”功能（Claude四代）； 3. vs code/jetbrains集成（识别当前文件）。 问答要点 1. 多Claude MD文件：默认读当前目录，支持@引用； 2. 指令执行：Claude四代优化，需更新模型和MD内容； 3. 多智能体协作：通过共享文件传递状态。 类别 类别 核心内容 核心内容 演讲者背景 演讲者背景 卡尔，Anthropic AI项目组成员，因高频使用Claude Code成为核心贡献者，负责系统提示词开发等工作。 卡尔，Anthropic AI项目组成员，因高频使用Claude Code成为核心贡献者，负责系统提示词开发等工作。 工具定位 工具定位 终端操作高手般的智能体，如同“随时可用的技术导师”，擅长通过终端工具解决编程问题。 终端操作高手般的智能体，如同“随时可用的技术导师”，擅长通过终端工具解决编程问题。 底层原理 底层原理 1. 基于指令系统+工具，模型循环运行至任务完成； 2. 不索引代码库，通过glob/grep/find等命令逐步探索理解； 3. 含轻量UI层、权限系统（危险操作需确认），兼容云服务商。 1. 基于指令系统+工具，模型循环运行至任务完成； 2. 不索引代码库，通过glob/grep/find等命令逐步探索理解； 3. 含轻量UI层、权限系统（危险操作需确认），兼容云服务商。 适用场景 适用场景 1. 新代码库探索（提升入职效率）； 2. 思维伙伴（提供实现方案）； 3. 代码开发（从零到一/现有库、写测试、生成提交信息）； 4. 部署集成（SDK调用，CI/CD等）； 5. 调试、技术迁移、CLI工具操作。 1. 新代码库探索（提升入职效率）； 2. 思维伙伴（提供实现方案）； 3. 代码开发（从零到一/现有库、写测试、生成提交信息）； 4. 部署集成（SDK调用，CI/CD等）； 5. 调试、技术迁移、CLI工具操作。 最佳实践 最佳实践 1. 用Claude MD文件共享状态（项目/主目录存放指令）； 2. 权限管理（自动接受模式）； 3. 优先用知名CLI工具； 4. 上下文满时清除/压缩； 5. 规划待办、测试驱动开发、多实例协作； 6. 关注GitHub更新。 1. 用Claude MD文件共享状态（项目/主目录存放指令）； 2. 权限管理（自动接受模式）； 3. 优先用知名CLI工具； 4. 上下文满时清除/压缩； 5. 规划待办、测试驱动开发、多实例协作； 6. 关注GitHub更新。 新功能 新功能 1. 模型切换（sonnet/opus）； 2. 工具调用间“思考”功能（Claude四代）； 3. vs code/jetbrains集成（识别当前文件）。 1. 模型切换（sonnet/opus）； 2. 工具调用间“思考”功能（Claude四代）； 3. vs code/jetbrains集成（识别当前文件）。 问答要点 问答要点 1. 多Claude MD文件：默认读当前目录，支持@引用； 2. 指令执行：Claude四代优化，需更新模型和MD内容； 3. 多智能体协作：通过共享文件传递状态。 1. 多Claude MD文件：默认读当前目录，支持@引用； 2. 指令执行：Claude四代优化，需更新模型和MD内容； 3. 多智能体协作：通过共享文件传递状态。 |🔗 原文链接：https://www.youtube.com/watch?v=gv0WHhKelSE&pp=ygULQ2xhdWRlIGNvZGU%3D |⏰ 发表时间：2025 7 31 |原创：卡尔・鲁布 Cal Rueb 本次演讲围绕Claude Code的核心特性、适用场景及最佳实践展开，清晰阐述了其作为“终端智能体”的定位——通过模拟人类探索代码库的方式（依赖终端工具），实现代码开发、调试、迁移等全流程辅助。演讲者结合自身经历，强调了Claude MD文件、权限管理、多实例协作等实用技巧，并介绍了模型切换、多模态思考等新功能，为开发者高效使用Claude Code提供了全面指导。问答环节进一步解答了多文件管理、指令执行、多智能体协作等实操问题，增强了工具的实用性和扩展性理解。 Unable to load the board. Please refresh and try again.Copy ErrorRefresh Nothing on the board yet 一、演讲全文 1. 演讲者自我介绍及与 Claude Code 的结缘 大家好，让我们开始吧。欢迎各位来到 Claude Code 本次演讲的最佳实践分享。我将从高层次介绍 Claude Code 是什么，接下来我们会稍微看看它的内部运作，以理解其工作原理——了解工具如何运作很重要。之后，我们会讨论 Claude Code 的适用场景，以及内部和用户共同总结出的最佳实践，教大家如何充分利用这个工具。 不过在开始之前，我想快速自我介绍并分享我是如何参与到这个项目中的。我叫卡尔，一年半前加入 Anthropic 协助组建团队——我们称为 AI 项目组，专注于实际应用使命，帮助客户和合作伙伴在 Claude 基础上构建优质产品和功能。这意味着我每天都会大量通过提示词让 Claude 生成最佳输出，同时我也热爱编程，是那种喜欢启动很多有疯狂想法的项目、却常常没完成的人，有一个“未完成的代码坟场”，但总在启动新项目。 去年深秋，我在 Slack 上听到有人提到一个新工具，说非常酷。周五晚上我下载了后来成为 Claude Code 的工具，用它开发我想做的新笔记应用。那个周末，我的编程和软件思维完全改变了——我带着笔记本电脑，对 Claude Code 的效果深深着迷，按下回车键、切换到浏览器刷新页面，就能目睹强大应用在眼前成型，比独自开发进展快得多，这让我震惊不已。过程中我还担心消耗太多 tokens 会惹麻烦，但后来发现 Claude Code 团队有内部工具跟踪员工使用情况，我周末突然冲到了榜首，也因此认识了 Boris、Kat 等早期团队成员，我跟他们说“我超爱这个工具，也擅长提示词设计，能帮忙吗？”，就这样参与了进来，现在是团队核心贡献者之一，主要负责系统提示词开发、工具工作原理、工具描述与执行结果设计，同时参与评估工具效果。 2. Claude Code 的定位：终端操作高手般的智能体 言归正传，让我们深入探讨。这是我目前对 Claude Code 的理解模型，也是我向他人解释的方式：当人们问我时，我会说 Claude Code 就像那个终端高手——终端操作样样精通，从不接触图形界面，技术超群。回想我作为初级工程师时，有位导师 Tony，我找他解决 bug，他会立刻打开终端，进行各种复杂的 Bash 命令和 Vim 操作，我总感叹“太厉害了”却没学。而拥有 Claude Code，就像身边时刻有 Tony 随时可用。 3. Claude Code 的底层原理 那么 Claude Code 底层原理及 Anthropic 如何实现？我们始终追求简单有效的解决方案，对 Claude Code 来说，它是我们定义的“纯粹智能体”——当我们谈论智能体时，实际是指特定指令系统、一些强大的工具，然后让模型在循环中运行直到它决定完成为止。这些工具是大家熟悉的，比如熟悉终端的人能用工具创建和编辑文件、使用终端，还能通过 MCP 引入其他内容。 这里要特别说明 Claude 如何理解代码库：如果去年要构建编码代理，可能会想“索引整个代码库并嵌入，进行复杂的 RAG 检索”，但 Claude Code 不是这样。我们不做任何索引，相反，它会逐步探索并理解代码库——就像你刚加入团队不熟悉代码库时，会通过 glob、grep 和 find 等命令搜索一样，Claude 也用相同的搜索工具遍历代码库并理解其运作。 在此基础上，这个代理还有一些附加功能：一个非常友好的轻量级 UI 层，能看到 Claude 编码过程；权限系统，在代理执行危险操作时强制人类介入。同时，我们非常重视工具的安全性，而且 Claude Code 不局限于 Anthropic API，还能与 AWS、GCP 等云服务商原生合作，使用起来很简单。 4. Claude Code 的核心能力与适用场景 现在说说 Claude Code 能做什么。现实是它几乎样样精通： 第一，探索新代码库。职业生涯中，我们常遇到新代码库（换团队、公司或参与开源项目），刚开始熟悉时效率很低，因为要理解结构和团队模式。Claude Code 能大幅提升入职流程——你可以问它“这个功能在哪里实现”，它擅长终端操作，能查看文件和 Git 历史，简单讲述代码过去几周的变化。 第二，作为思维伙伴。这一点我认为被低估了：与其直接开始工作，不如先让 Claude Code 帮忙分析。比如我用 Claude 实现功能时，会说“我在考虑实现这个功能，能否帮忙搜索并找出两到三个实现方法？不要开始工作，不要编写文件”。它会调用搜索能力返回方案，我再和它验证，之后再进入项目。 第三，构建和编写代码。一方面能完成从零到一的任务——放个空目录，让它做个应用或演示游戏，有趣且有成就感；但更重要的是在现有代码库中工作，这是我们的主要关注方向。比如我们代码库的单元测试覆盖率很高，因为 Claude Code 让添加单元测试变得简单；提交和 PR 信息也很优秀，完成工作后让它帮忙写就行。 第四，部署环节。使用 Claude Code SDK 以无界面方式程序化调用，能在任何地方嵌入代码辅助工具，比如集成到 CI/CD 流程、GitHub 中，帮助人们程序化操作。 第五，支持与扩展性。能更快调试错误，还能辅助团队进行技术迁移——比如用旧版 Java 的团队迁移到新版本，或 PHP 团队转向 React/Angular，有了 Claude Code 能让项目更易被接受。 更重要的是，Claude 在终端表现卓越，意味着它在各种 CLI 工具（如 Git、Docker、BigQuery）上表现出色。比如遇到棘手的变基困境，启动 Claude Code 说“帮我修复这个问题”，效果会很惊人。 5. Claude Code 的最佳实践 接下来是最佳实践： 第一条是使用 Claude MD 文件。Claude Code 是代理，有工具和轻量级指令，但没有真正的记忆功能，所以我们通过 Claude MD 文件在不同会话或团队间共享状态。当在同一代码库反复启动 Claude Code 时，若工作目录有 Claude MD 文件，它会被直接纳入上下文插入提示，相当于告诉 Claude“这些是开发者留的重要指令，务必注意”。Claude MD 文件可以放在项目中（纳入版本控制，团队共享）或主目录（存放 Claude 需始终了解的内容，比如运行单元测试的方式、项目结构概述、代码规范等），还能随时间逐步完善。 第二是权限管理。运行 Claude Code 时，读取操作直接放行，但写入、运行 bash 命令或执行可能改变机器状态的操作时，会弹出确认界面（“允许”“始终允许”或“不允许”）。通过智能权限管理能提升效率，比如“自动接受模式”：按下 Shift+Tab 让 Claude 立即工作，还能在设置中配置特定命令（如 npm run test）自动批准，优化工作流程。 第三，充分利用终端优势。常用应用若有 CLI 和 GitHub 访问方式（如 GitHub 的 gh 工具），可以赋予 Claude Code 更多工作——通过安装更多 CLI 工具或附加 MCP 服务器。经验表明，优先使用知名文档齐全的 CLI 工具，比直接本地安装更佳；如果有自定义工具（如 Anthropic 内部的 Coup），也可以告知 Claude 并测试。 第四，处理上下文窗口。Claude 模型有 20 万 token 的上下文窗口，长时间会话可能填满，此时右下角会提示。你可以选择“清除并重新开始”（保留 Claude MD 等）或“压缩”（总结之前内容作为下次会话的种子），我们优化过压缩功能，能让你重新开始并继续工作。 6. 高效工作流技巧 高效工作流： 比如使用规划和待办事项：打开 Claude 时不说“修复这个 bug”，而是说“帮我搜索原因，告诉我修复计划”，能节省时间并验证方向；Claude 处理复杂任务时会生成待办列表，若发现问题，按 Esc 键说“修改待办事项列表，你走错方向了”即可。还有智能编码技巧：采用测试驱动开发（小改动、运行测试、确保通过），用 Claude 检查 TypeScript 和代码规范，定期提交以便回滚；用截图辅助调试（基于多模态模型，粘贴截图或设计稿让它建站）。 7. 高阶使用玩法 再来看看高阶玩法：