小白必看|Anthropic 官方发布Claude Code课程(中文翻译完整版)

小白必看|Anthropic 官方发布Claude Code课程(中文翻译完整版)

小白必看|Anthropic 官方发布Claude Code课程(中文翻译完整版) 小白必看|Anthropic 官方发布Claude Code课程(中文翻译完整版) Modified May 16 Audio or video is not supported Please download the file and open it with the appropriate software. What is Claude Code.mp4 · 33.78MB What is Claude Code 00:00 Audio or video is not supported Please download the file and open it with the appropriate software. Installing Claude Code.mp4 · 20.15MB Installing Claude Code 00:00 No access Claude Code 的上下文管理 00:00 高效用好 Claude Code 的关键就是管好上下文:长会话精简用/compact,换新需求重置用/clear;需求描述精准清晰,定期查看占用状态;非核心查询任务交给子代理分流,最大化利用内存空间。 8. MCP in Claude Code (Claude Code 里的 MCP) 原视频: No access Claude Code 里的 MCP 00:00 中文整理: MCP 基础定义 MCP(Model Context Protocol 模型上下文协议) 是一套开放通用标准,作用是让 Claude Code 能够无缝对接各类外部工具与数据源。 你提出需求时,它可自动判断调用对应外部工具,精准理解并完成任务。 MCP 核心价值 使用 Claude Code 开发时,大量业务相关数据并不在本地代码内,而是存放在数据库、办公协作软件、开源仓库等外部平台,MCP 就是打通这些外部资源的核心桥梁。 同时工具调用是AI Agent的核心能力,区别于普通AI仅纯文字问答,Claude Code 可借助各类工具执行实际操作,落地完整任务。 实际应用场景 1. 团队使用 Linear 项目管理工具:接入对应 Linear MCP 服务,可直接同步同步项目工单、任务详情 2. 查阅依赖库最新文档:接入文档类 MCP 服务,快速获取官方最新技术资料 3. 更多第三方连接器可在官网 https://claude.com/connectors查找 MCP 服务添加与分类 1. 添加命令:使用 claude mcp add 快速接入MCP服务 2. 两大服务类型 • HTTP 服务端:对接云端远程第三方服务,通过网络实现连接 • Stdio 本地服务端:运行在你本机电脑的本地进程服务 3. 会话内管理:在 Claude Code 中输入 /mcp,可查看已连接服务、运行状态,一键停用闲置服务 MCP 三种作用域 1. 本地作用域:仅在当前项目生效 2. 用户全局作用域:绑定个人账号,所有项目均可通用 3. 项目级作用域:通过 project.mcp.json 文件配置并提交版本库,团队所有成员拉取项目后自动同步配置,统一开发环境 上下文优化避坑要点 1. 弊端:即便暂时不用,已配置的MCP服务也会把工具定义信息占用上下文空间,配置过多会挤占可用内存 2. 优化方案 • 及时停用长期闲置的MCP服务,减少资源占用 • 有对应CLI命令行工具(GitHub、AWS等)优先用CLI,比MCP更节省上下文 • 优先使用Skill能力:仅将名称与简介载入上下文,需要用时再完整加载,轻量化更省空间 3. 自动适配机制 当MCP工具占用上下文超过10%,Claude Code会自动切换为工具检索模式,按需查找调用工具,但该模式执行稳定性会有所下降 核心总结 1. MCP实现Claude Code与外部工具、业务数据源互联互通 2. 借助命令快速添加服务,通过配置文件实现团队统一同步 3. 日常维护及时清理无用服务,严控上下文占用 4. 合理搭配CLI工具与Skill能力,平衡功能实用性与运行效率 9. Hooks in Claude Code (Claude Code 里的 Hooks) 原视频: No access Claude Code 里的 Hooks 00:00 中文整理: • Prompt、CLAUDE.md、skill 都是在“尽量引导 Claude”。 • Hook 则是在“强制某件事按规则执行”。 Hooks是什么 hooks可以在 Claude Code 整个运行生命周期的指定节点自动执行命令。 它和其他功能最大区别:执行结果确定、必定触发。 举例: 你写在 claude.md 里让它改完文件自动格式化,偶尔会失效; 但写成hooks规则,每次都会强制执行,毫无例外。 常用实战场景 1. 文件修改完成后自动格式化代码 2. 记录所有执行命令,满足合规审计需求 3. 拦截高危操作,禁止修改生产环境配置文件 4. 任务执行完毕自动推送消息通知 配置入口与基础写法 所有hooks统一在 .claude/settings.json 中配置 配置三要素: 1. 选定触发事件 2. 可选设置匹配规则,限定生效工具 3. 填写需要自动运行的终端命令 五大核心触发时机 1. 用户提交提示词前:提交指令后、模型开始处理前触发 2. 工具调用前置(pre tool use):调用任何工具之前执行 3. 工具调用后置(post tool use):工具执行完成后触发 4. 消息通知触发:Claude 推送通知时运行 5. 会话结束触发:模型完成全部应答后执行 高频用法讲解 1. 改文件自动格式化(最常用) 选用工具调用后置hooks 匹配规则设为:单文件编辑、批量编辑。只要 Claude 修改代码文件就自动触发,可根据文件后缀执行对应格式化命令 2. 拦截高危操作(强约束管控) 前置hooks可直接阻止工具执行 hooks通过标准输入获取工具名称与入参JSON 通过退出码控制行为: • 退出码 0:放行,正常执行操作 • 退出码 2:直接阻断操作,错误信息同步返回给 Claude 模型会明确知晓拦截原因并自行调整行为 适用管控场景: • 禁止写入生产配置目录 • 拦截含 rm rf 等高风险删除命令 • 禁止直接向主干分支提交代码 可强制落地团队硬性规范,而非仅口头提醒。 作用域 1. 该配置属于项目级配置,可提交到代码仓库 2. 团队所有成员拉取项目后,自动同步全套hooks规则 3. 搭配项目环境变量,可直接调用项目内脚本,不受当前工作目录影响 使用总结 1. 后置hooks:用来做自动格式化、操作日志记录 2. 前置hooks:用来拦截危险行为、强制校验规范 3. 统一在项目配置文件编写并入库,全员统一生效 4. 凡是必须次次执行、绝对不能遗漏的操作,不要写在提示词里,直接配置hooks实现强制管控 推荐的学习顺序 如果你是第一次用 Claude Code,建议按下面顺序重新吸收这 9 节: 1. 先看第 1、3 节,建立 agentic loop 心智模型。 2. 再看第 2、4 节,完成安装并用 plan mode 发出第一条高质量 prompt。 3. 然后重点吃透第 6、7 节,把工作流和上下文管理变成习惯。 4. 最后再补第 5、8、9 节,把记忆、外部连接和确定性自动化搭起来。 一页速记 • 先探索,再规划,再写代码,不要一上来就让 Claude 开改。 • 大任务先进 plan mode。 • 项目长期规则写进 CLAUDE.md。 • 同功能继续做,用 /compact;切换新任务,用 /clear。 • 外部上下文用 MCP 接入,但别挂太多无关 server。 • 想“始终执行”的规则,用 hooks,不要只靠提示词。 参考来源 Audio or video is not supported Please download the file and open it with the appropriate software. What is Claude Code.mp4 · 33.78MB What is Claude Code 00:00 Audio or video is not supported Please download the file and open it with the appropriate software. What is Claude Code.mp4 · 33.78MB What is Claude Code 00:00 Audio or video is not supported Please download the file and open it with the appropriate software. Installing Claude Code.mp4 · 20.15MB Installing Claude Code 00:00 Audio or video is not supported Please download the file and open it with the appropriate software. Installing Claude Code.mp4 · 20.15MB Installing Claude Code 00:00 No access Claude Code 的上下文管理 00:00 No access Claude Code 的上下文管理 00:00 高效用好 Claude Code 的关键就是管好上下文:长会话精简用/compact,换新需求重置用/clear;需求描述精准清晰,定期查看占用状态;非核心查询任务交给子代理分流,最大化利用内存空间。 8. MCP in Claude Code (Claude Code 里的 MCP) 原视频: No access Claude Code 里的 MCP 00:00 No access Claude Code 里的 MCP 00:00 中文整理: MCP 基础定义 MCP(Model Context Protocol 模型上下文协议) 是一套开放通用标准,作用是让 Claude Code 能够无缝对接各类外部工具与数据源。 你提出需求时,它可自动判断调用对应外部工具,精准理解并完成任务。 MCP 核心价值 使用 Claude Code 开发时,大量业务相关数据并不在本地代码内,而是存放在数据库、办公协作软件、开源仓库等外部平台,MCP 就是打通这些外部资源的核心桥梁。 同时工具调用是AI Agent的核心能力,区别于普通AI仅纯文字问答,Claude Code 可借助各类工具执行实际操作,落地完整任务。 实际应用场景 1. 团队使用 Linear 项目管理工具:接入对应 Linear MCP 服务,可直接同步同步项目工单、任务详情 2. 查阅依赖库最新文档:接入文档类 MCP 服务,快速获取官方最新技术资料 3. 更多第三方连接器可在官网 https://claude.com/connectors查找 MCP 服务添加与分类 1. 添加命令:使用 claude mcp add 快速接入MCP服务 2. 两大服务类型 • HTTP 服务端:对接云端远程第三方服务,通过网络实现连接 • Stdio 本地服务端:运行在你本机电脑的本地进程服务 3. 会话内管理:在 Claude Code 中输入 /mcp,可查看已连接服务、运行状态,一键停用闲置服务 MCP 三种作用域 1. 本地作用域:仅在当前项目生效 2. 用户全局作用域:绑定个人账号,所有项目均可通用 3. 项目级作用域:通过 project.mcp.json 文件配置并提交版本库,团队所有成员拉取项目后自动同步配置,统一开发环境 上下文优化避坑要点 1. 弊端:即便暂时不用,已配置的MCP服务也会把工具定义信息占用上下文空间,配置过多会挤占可用内存 2. 优化方案 • 及时停用长期闲置的MCP服务,减少资源占用 • 有对应CLI命令行工具(GitHub、AWS等)优先用CLI,比MCP更节省上下文 • 优先使用Skill能力:仅将名称与简介载入上下文,需要用时再完整加载,轻量化更省空间 3. 自动适配机制 当MCP工具占用上下文超过10%,Claude Code会自动切换为工具检索模式,按需查找调用工具,但该模式执行稳定性会有所下降 核心总结 1. MCP实现Claude Code与外部工具、业务数据源互联互通 2. 借助命令快速添加服务,通过配置文件实现团队统一同步 3. 日常维护及时清理无用服务,严控上下文占用 4. 合理搭配CLI工具与Skill能力,平衡功能实用性与运行效率 9. Hooks in Claude Code (Claude Code 里的 Hooks) 原视频: No access Claude Code 里的 Hooks 00:00 No access Claude Code 里的 Hooks 00:00 中文整理: • Prompt、CLAUDE.md、skill 都是在“尽量引导 Claude”。 • Hook 则是在“强制某件事按规则执行”。 Hooks是什么 hooks可以在 Claude Code 整个运行生命周期的指定节点自动执行命令。 它和其他功能最大区别:执行结果确定、必定触发。 举例: 你写在 claude.md 里让它改完文件自动格式化,偶尔会失效; 但写成hooks规则,每次都会强制执行,毫无例外。 常用实战场景 1. 文件修改完成后自动格式化代码 2. 记录所有执行命令,满足合规审计需求 3. 拦截高危操作,禁止修改生产环境配置文件 4. 任务执行完毕自动推送消息通知 配置入口与基础写法 所有hooks统一在 .claude/settings.json 中配置 配置三要素: 1. 选定触发事件 2. 可选设置匹配规则,限定生效工具 3. 填写需要自动运行的终端命令 五大核心触发时机 1. 用户提交提示词前:提交指令后、模型开始处理前触发 2. 工具调用前置(pre tool use):调用任何工具之前执行 3. 工具调用后置(post tool use):工具执行完成后触发 4. 消息通知触发:Claude 推送通知时运行 5. 会话结束触发:模型完成全部应答后执行 高频用法讲解 1. 改文件自动格式化(最常用) 选用工具调用后置hooks 匹配规则设为:单文件编辑、批量编辑。只要 Claude 修改代码文件就自动触发,可根据文件后缀执行对应格式化命令 2. 拦截高危操作(强约束管控) 前置hooks可直接阻止工具执行 hooks通过标准输入获取工具名称与入参JSON 通过退出码控制行为: • 退出码 0:放行,正常执行操作 • 退出码 2:直接阻断操作,错误信息同步返回给 Claude 模型会明确知晓拦截原因并自行调整行为 适用管控场景: • 禁止写入生产配置目录 • 拦截含 rm rf 等高风险删除命令 • 禁止直接向主干分支提交代码 可强制落地团队硬性规范,而非仅口头提醒。 作用域 1. 该配置属于项目级配置,可提交到代码仓库 2. 团队所有成员拉取项目后,自动同步全套hooks规则 3. 搭配项目环境变量,可直接调用项目内脚本,不受当前工作目录影响 使用总结 1. 后置hooks:用来做自动格式化、操作日志记录 2. 前置hooks:用来拦截危险行为、强制校验规范 3. 统一在项目配置文件编写并入库,全员统一生效 4. 凡是必须次次执行、绝对不能遗漏的操作,不要写在提示词里,直接配置hooks实现强制管控 推荐的学习顺序 如果你是第一次用 Claude Code,建议按下面顺序重新吸收这 9 节: 1. 先看第 1、3 节,建立 agentic loop 心智模型。 2. 再看第 2、4 节,完成安装并用 plan mode 发出第一条高质量 prompt。 3. 然后重点吃透第 6、7 节,把工作流和上下文管理变成习惯。 4. 最后再补第 5、8、9 节,把记忆、外部连接和确定性自动化搭起来。 一页速记 • 先探索,再规划,再写代码,不要一上来就让 Claude 开改。 • 大任务先进 plan mode。 • 项目长期规则写进 CLAUDE.md。 • 同功能继续做,用 /compact;切换新任务,用 /clear。 • 外部上下文用 MCP 接入,但别挂太多无关 server。 • 想“始终执行”的规则,用 hooks,不要只靠提示词。 参考来源 • YouTube 播放列表:Claude Code 官方播放列表 Claude Code 官方播放列表 • Claude Help Center:Give Claude context: CLAUDE.md and better prompts Give Claude context: CLAUDE.md and better prompts • Claude Code Docs:Advanced setupHow Claude Code worksExplore the context windowCommon workflowsMCPHooks guideManage costs effectively Advanced setup How Claude Code works Explore the context window Common workflows MCP Hooks guide Manage costs effectively • 可访问到的公开转录/课程页(用于对照视频内容):8news AnthropicDataCamp Claude Code 101 8news Anthropic DataCamp Claude Code 101 课程总览 1. What is Claude Code? 2. Installing Claude Code 3. How Claude Code Works 4. Your first Claude Code prompt 5. The CLAUDE.md file 6. The Explore → Plan → Code → Commit workflow in Claude Code 7. Context Management in Claude Code 8. MCP in Claude Code 9. Hooks in Claude Code 1. What is Claude Code? (什么是 Claude Code?) 原视频: 中文整理: • Claude Code 不是“给你一段代码建议”的聊天机器人,而是一个能直接在开发环境里行动的自主编码工具。它能理解整个代码库,读取和编辑文件,运行终端命令,并接入你现有的开发工具链。它可在你的终端、Visual Studio Code、网页上的云桌面应用以及Jet Brain的集成开发环境(IDE)中使用 • 和普通的 Claude 聊天相比,最大的差别是它有“行动能力”: ◦ 不只是告诉你“应该怎么改”。 ◦ 而是可以自己去读文件、定位问题、执行命令、修改代码、再验证结果。 ◦ 不只是告诉你“应该怎么改”。 ◦ 而是可以自己去读文件、定位问题、执行命令、修改代码、再验证结果。 • Claude Code的核心机制,是让大模型在一个循环里持续工作: ◦ 先理解任务。 ◦ 再决定是否要调用工具。 ◦ 拿到工具结果后继续判断下一步。 ◦ 直到任务完成。 ◦ 先理解任务。 ◦ 再决定是否要调用工具。 ◦ 拿到工具结果后继续判断下一步。 ◦ 直到任务完成。 • 典型能力包括: ◦ 理解和追踪代码库中的功能实现。 ◦ 跨文件排查 bug。 ◦ 构建脚本、运行测试、安装依赖。 ◦ 必要时搜索最新文档或外部资料。 ◦ 理解和追踪代码库中的功能实现。 ◦ 跨文件排查 bug。 ◦ 构建脚本、运行测试、安装依赖。 ◦ 必要时搜索最新文档或外部资料。 • 但它并不是“全知全能”: ◦ 仍然受上下文窗口限制。 ◦ 仍然可能误解意图、引入新 bug、或者过度设计。 ◦ 所以你仍然需要做审查和验收。 ◦ 仍然受上下文窗口限制。 ◦ 仍然可能误解意图、引入新 bug、或者过度设计。 ◦ 所以你仍然需要做审查和验收。 想要高效用好Claude Code,掌握以下核心概念至关重要: 1. 上下文窗口 可将其理解为 Claude 的临时工作记忆。它能容纳海量信息,但无法一次性承载全部内容。这也是其自主执行能力的核心原理:无需把完整代码库全部载入记忆,就能通过合理策略在代码库中精准检索所需答案。 2. 默认请求许可 Claude Code 在执行指令、修改代码文件前,都会主动向你发起确认请求。无论你是全程手动把控,还是交由工具自主运行,始终由你掌握全部操作主导权。 3. 存在失误 和所有开发工具一样,Claude Code 并非绝对完美。它可能曲解你的实际需求、引入新的错误,或者过度设计解决方案。 这一节想传达的核心: • 把 Claude Code 理解为“会自己动手的开发搭档”,而不是“更会写代码的聊天框”。 • 你给它目标,它会自己决定查什么、改什么、验证什么。 2. Installing Claude Code (安装 Claude Code) 原视频: 中文整理: • Claude Code 可以在终端、IDE、桌面端和网页端配合使用,但本系列主要以终端形态为主。 • 教程里强调了多平台安装路径,核心思路是: ◦ 本地终端优先。 ◦ IDE 或网页端如果要访问本地项目或本地终端能力,需要和本地环境连接。 ◦ 本地终端优先。 ◦ IDE 或网页端如果要访问本地项目或本地终端能力,需要和本地环境连接。 终端安装与使用 如果你使用的是Mac OS、Linux或WSL,可使用此curl命令一次性完成安装。 如果你更喜欢使用 Homebrew,也可以使用 brew install 来安装它。但请注意,这并不具备自动更新功能。 如果你使用的是Windows PowerShell: 如果你使用的是Windows CMD: 当然Windows用户也可以使用WinGet命令 • 安装完成后,输入以下命令来运行Claude Code 然后你将完成一些初始设置,比如选择颜色主题、使用云账户登录(可以是专业版、旗舰版或企业版账户),也可以使用 API 密钥。 VS Code 端安装与使用 1. 打开VS Code,搜索 Claude Code,找到 Anthropic 官方出品插件,认准蓝色认证标识后完成安装。 2. 安装完成后建议重启 VS Code 生效。 3. 调出操作面板:Windows/Linux 按 Ctrl+Shift+P,Mac 按 Command+Shift+P,搜索 Claude Code 即可新建操作标签页。 4. 快捷入口:打开项目文件后,直接点击界面上的 Claude 图标快速唤起。 5. 自定义使用模式:可在设置文件中关闭可视化界面,仅保留纯终端操作模式。 JetBrains 系列编辑器(IDEA 等)安装 1. 前往 JetBrains 插件市场,搜索安装 Claude Code 插件。 2. 安装完毕重启编辑器,重启后界面会显示 Claude 专属图标。 3. 点击图标调出专属面板,内置终端交互界面,可搭配云端桌面协同使用。 桌面客户端使用 1. 安装Claude桌面客户端并完成账号登录。 2. 页面顶部找到Code切换按钮即可启用 Claude Code 功能。 3. 界面风格和 Claude 对话界面相近,支持指定项目文件夹、调整操作权限,还可直接在云端开发环境中编写代码。 网页端使用 1. 访问网址:https://claude.ai/code 即可在线使用。 2. 功能逻辑和桌面客户端基本一致,仅支持绑定 GitHub 代码仓库进行开发。 各使用场景优缺点对比 1. 终端模式:功能更新推送最快,追求最新功能首选。 2. 编辑器插件:使用体验高度统一,能深度融入日常编码流程。 3. 桌面客户端:可后台静默运行,方便一边处理其他事务一边调用工具。 4. 网页端:适合远程协作 GitHub 项目,支持多任务会话并行办公。 这一节的实用结论: • 如果你想要最顺手、最完整的体验,优先在本地终端环境里安装并启动。 • 如果你只是想更快上手,先把 claude 命令跑起来,再去接 IDE 或网页端即可。 3. How Claude Code Works (Claude Code 是怎么工作的) 原视频: Audio or video is not supported Please download the file and open it with the appropriate software. How Claude Code Works.mp4 · 25.12MB How Claude Code Works 00:00 Audio or video is not supported Please download the file and open it with the appropriate software. How Claude Code Works.mp4 · 25.12MB How Claude Code Works 00:00 中文整理: 我们都清楚,Claude Code 和普通聊天对话类应用截然不同,下面为你讲清它的核心运行逻辑,核心是一个递归的 Agentic Loop。 核心运行:Agentic Loop 1. 输入指令:你向 Claude Code 输入需求提示词。 2. 搜集所需信息:它结合大模型分析需求,调取完成任务必备相关内容,模型会返回文本内容或可执行的工具调用指令。 3. 执行实际操作:依据指令做出对应行为,例如修改代码文件、运行终端命令等。 4. 结果核验判定:自动校验执行结果,判断是否达成你最初提出的需求目标。 5. 闭环循环 • 结果达标:任务结束,等待你的下一条指令 • 结果未达标:重新进入循环流程,反复执行操作、核验,直至任务完成且结果无误 人工干预权限:整个运行过程中,你随时可以补充信息、中断进程、引导模型思路,把控最终任务走向。 上下文窗口机制 1. 上下文窗口决定了它能留存、回看的内容上限,包含对话记录、代码文件内容、命令执行日志等所有信息。 2. 一旦达到存储上限,Claude Code 会自动压缩整理会话内容:剔除无用信息、精简总结冗余内容,主动释放上下文空间,保证程序正常运行。 核心支柱:工具调用能力 1. 普通 AI 助手仅支持纯文字输入输出,无中间实操能力;而工具调用是智能Agent的核心根基。 2. 借助各类内置工具,Claude Code 可自主判断时机调用功能推进任务,例如读取文件、联网检索等。 3. 它还支持语义检索,精准判断调用对应工具,并获取工具执行结果。 权限运行模式 默认状态下,修改文件、运行终端命令必须提前征得你的手动确认,按下 Shift+Tab 可快速切换运行模式: 1. 自动编辑模式:自动同意文件修改操作,运行命令依旧需要手动授权 2. 规划模式:仅使用只读类工具,先梳理完整执行方案,再正式开始执行任务 重要提醒:切勿随意关闭权限校验、放任其自由执行命令,一旦出现逻辑错误,极易引发难以察觉的代码故障与运行风险。 Claude Code能够读取完整代码项目、自主执行实操动作、自我校验工作成果,这也是它和普通聊天 AI 最本质的区别。 这一节的核心认知升级: • Claude Code 不是一次回答。 • 它更像一个“会思考、会调用工具、会回头验证”的执行循环。 4. Your first Claude Code prompt (你的第一条 Claude Code 提示词) 原视频: Audio or video is not supported Please download the file and open it with the appropriate software. Your first Claude Code prompt .mp4 · 23.48MB Your first Claude Code prompt 00:00 Audio or video is not supported Please download the file and open it with the appropriate software. Your first Cla

在 小宇宙note 阅读完整内容