AI 教程 › 基础教程

Claude Code 中文教程

从安装入门到 CLAUDE.md、权限、MCP、子代理、Skills、Hooks、Agent SDK 和综合实战，53 篇。

作者 stormzhang，转载自开源项目 stormzhang/ai-coding-guide（MIT 许可）。

从第 1 篇开始 →

基础入门5 篇

  1. 01Claude Code 简介Claude Code 的产品定位、代理式工作方式、能做与不能做的事情，以及它和 ChatGPT、Copilot、Cursor 的核心区别。
  2. 02安装与使用Mac、Windows、Linux 和 WSL 的安装步骤、登录方法、网络要求与常见报错处理，让第一次使用命令行的读者也能完成安装。
  3. 03Claude Code 如何工作Claude Code 的代理循环、上下文窗口、内置工具和权限确认机制，解释它如何从理解任务走到修改文件与验证结果。
  4. 04API 配置：订阅登录还是 API key，怎么选、怎么切Claude 订阅登录、Anthropic API Key 与云厂商认证的差异、费用归属和切换方式，帮助你选对最合适的接入路径。
  5. 05接入第三方 / 国产模型通过兼容网关或第三方服务为 Claude Code 配置模型的基本原理、环境变量、验证方法和风险边界，避免把兼容接口当成官方能力。

上手与项目8 篇

  1. 06Coding Plan：订阅套餐与计费Claude 各订阅套餐、API 计费与 Claude Code 使用额度的关系，并说明不同使用强度下怎么选方案、怎么看成本和避免意外消耗。
  2. 07第一次使用：跑通第一个例子首次进入项目、授权信任、发送任务、检查修改和验证结果的完整流程，用一个最小示例带你跑通 Claude Code 的第一次代理任务。
  3. 08VS Code 集成Claude Code 在 VS Code 中的安装、启动、选区引用、差异查看与终端协作方式，帮助你把编辑器操作和代理任务连成一套工作流。
  4. 09JetBrains 集成Claude Code 在 IntelliJ IDEA、PyCharm 等 JetBrains IDE 中的安装、上下文共享、差异查看和常用操作，说明插件与终端入口如何配合
  5. 10桌面 app（Desktop）Claude Code 桌面应用的安装、项目管理、会话操作和适用场景，并比较 Desktop、终端与网页版入口的能力边界和选择方式。
  6. 11网页版与云端：把 Claude Code 装进浏览器和手机Claude Code Web 的仓库连接、云端任务、手机访问和 Deep Link 等能力，说明哪些工作适合放到云端、哪些仍应留在本地完成
  7. 12项目初始化：用 /init 一键生成 CLAUDE.md使用 /init 扫描项目并生成 CLAUDE.md 的流程、生成结果的检查方法和后续维护原则，让 Claude 快速理解项目结构与规则。
  8. 13项目结构：Claude Code 在你项目里都放了什么项目中的 .claude 目录、CLAUDE.md、settings、commands、agents、skills 和 hooks 分别放什么，帮助你看懂配置层级与作用范围

核心交互与操作8 篇

  1. 14交互界面与快捷键：把手放对地方交互界面的状态区、输入模式、历史记录、快捷键和 Shell 模式，帮助你减少鼠标操作并准确判断当前会话处于什么状态。
  2. 15怎么提问和给指令：把话说到 Claude 心坎里如何向 Claude Code 说明目标、提供上下文、约束改动范围和定义验收标准，并用可复用的提示词结构减少返工与误改。
  3. 16四个最常用的活儿：探索代码库、修 bug、重构、写测试探索代码库、定位并修复 Bug、控制重构范围和补写测试四类高频任务的标准步骤、提示方式与验收方法。
  4. 17图片与多模态：贴张截图，它就懂了向 Claude Code 提供截图、设计稿和错误界面的方式，以及图片上下文适合解决的问题、提示词写法与视觉还原时的验收要点。
  5. 18CLAUDE.md 使用指南：把项目规矩写进它的记忆CLAUDE.md 的发现范围、层级优先级、推荐内容、反模式和维护方法，帮助你把稳定的项目规则写成 Claude 可执行的说明书。
  6. 19上下文管理：别让它「失忆」也别烧爆 token上下文窗口如何消耗、何时使用 compact 或 clear、怎样减少无关材料和会话漂移，让长任务保持准确并控制 Token 成本。
  7. 20权限配置：放多松、收多紧，你说了算Claude Code 的权限模式、allow 与 deny 规则、工具审批和作用域配置，帮助你在效率与安全之间选择合适的开放程度。
  8. 21安全与风险边界：到底该不该信任 AI 碰你的代码提示词注入、恶意仓库、命令执行、敏感信息和供应链风险，并给出审查权限、隔离环境与检查输出的实用防护原则。

高级功能扩展9 篇

  1. 22MCP：给 Claude 接上外部世界MCP 的工作原理、服务器类型、添加与管理命令、作用域和安全边界，并用实际流程说明如何让 Claude 访问外部数据与工具。
  2. 23子代理（Subagents）：把活儿外包出去，别什么都自己扛子代理的隔离上下文、配置文件、工具权限、自动选择和适用任务，帮助你把专项工作拆出去而不污染主会话。
  3. 24插件（Plugins）：把一堆零碎配置一键打包Claude Code 插件如何组合命令、Agent、Skill、Hook 和 MCP，覆盖插件安装、启用、目录结构与团队分发的基本流程。
  4. 25记忆系统（memory）：让它跨会话记住你Claude Code 自动记忆与 CLAUDE.md 的区别、记忆内容的查看和管理方式，以及什么信息适合长期保留、什么不应该写入。
  5. 26Agent Skills：给 Claude 装一身随叫随到的专项本事Agent Skills 的目录结构、SKILL.md 写法、自动触发与手动调用方式，解释它和命令、子代理、Hook、MCP 的职责差异。
  6. 27Skills 使用实例：装一个、喊一声、看它干活从发现一个 Skill、安装到正确目录、触发执行到检查结果的完整流程，并说明常见路径错误、触发失败和安全检查方法。
  7. 28skill-creator 使用：用一个 skill 造你自己的 skill使用 skill-creator 从需求定义、指令编写、资源组织到测试迭代创建一个自定义 Skill，帮助你把重复工作沉淀为稳定能力。
  8. 29Agent teams 智能体团队：多会话协作Agent Teams 的负责人、队友、共享任务和消息机制，覆盖启用方式、任务拆分、成本风险和适合并行协作的真实场景。
  9. 30功能怎么选：CLAUDE.md vs Skill vs Hook vs MCP vs Subagent对比 CLAUDE.md、Skill、Hook、MCP、Subagent 的触发方式、职责、上下文成本和使用场景，提供一张可直接套用的功能选择表

系统配置与优化7 篇

  1. 31settings.json：用户级 / 项目级配置用户级、项目级和本地 settings.json 的路径、优先级与常用字段，说明权限、环境变量、Hook 和插件配置如何安全落盘。
  2. 32输出样式（Output Styles）：换一档「节目」，不换主持人输出样式的作用、内置样式、自定义文件结构、切换方式和适用场景，解释它如何改变回答形式而不替换系统核心能力。
  3. 33钩子（Hooks）：在固定时机自动扣扳机Hook 的生命周期事件、匹配器、命令配置、输入输出和错误处理，帮助你在固定节点自动执行格式化、检查与安全卡点。
  4. 34CLI 参考手册：命令与全部标志Claude Code 命令行入口、常用参数、会话恢复、模型选择、权限设置和非交互用法，适合需要快速查询准确命令的读者。
  5. 35控制与模式：开会话时手里那块「调音台」启动和会话中的权限模式、模型、思考强度、自动模式与控制选项，帮助你根据任务风险和复杂度调好执行方式。
  6. 36斜杠命令（Slash Commands）：一个 `/` 调出 Claude 的所有快捷动作内置斜杠命令的分类、常用参数和使用时机，覆盖会话管理、上下文、配置、诊断与扩展命令的快速调用方式。
  7. 37检查点（Checkpoints）：随时能倒带的安全网检查点如何保存文件修改、查看历史和恢复到安全状态，说明它能回滚什么、不能替代什么，以及和 Git 的正确配合方式。

高级参考与实战11 篇

  1. 38插件参考手册：把自己那套配置，打成一个能发出去的包插件目录结构、manifest、组件路径、版本与 marketplace 分发方式，适合需要制作、检查或发布 Claude Code 插件的读者
  2. 39实战入门：拿一个真需求，从开工到交付走一整趟用一个真实需求串起项目阅读、计划确认、代码修改、测试验证和结果汇报，展示 Claude Code 任务从开工到交付的标准流程。
  3. 40Chrome：让它操作浏览器Claude Code 连接并操作 Chrome 的安装条件、页面交互、权限确认、调试场景和安全边界，说明浏览器能力适合解决哪些任务。
  4. 41并行任务：让几个 Claude 同时开工，而不是排队多会话、子代理、Agent Teams 和 Git Worktree 的并行方式、隔离程度与成本差异，帮助你选择不会互相覆盖的协作方案。
  5. 42环境变量：藏在背后那排「总开关」Claude Code 常用环境变量的作用、配置位置、优先级与排错方式，覆盖认证、模型、网络、日志和运行行为等关键开关。
  6. 43Git 工作流：让 Claude 当你的 git 副手让 Claude Code 安全参与查看差异、创建分支、准备提交、处理冲突和审查变更的流程，强调每一步的人类验收边界。
  7. 44GitHub Actions：在 PR 里 @ 一下，让 Claude 自己干活在 GitHub Actions 和 PR 中调用 Claude Code 的安装、认证、工作流配置、触发方式与安全注意事项，适合仓库自动化场景
  8. 45Agent SDK：把 Claude Code 的能力搬进你自己的程序Claude Agent SDK 的核心概念、安装、调用、工具、会话与权限控制，帮助开发者把 Claude Code 的代理循环嵌入自己的应用
  9. 46开发配置：把 Claude 干活的「工作环境」调顺终端、Shell、开发容器、网络代理和项目初始化等环境配置，帮助你减少命令执行差异并让 Claude 在稳定环境里工作。
  10. 47Voice 语音模式：把提示词说出来，而不是打出来Voice 语音听写的启用方式、快捷键、语言识别、编辑流程和适用场景，说明它与真正的语音对话模式有什么区别。
  11. 48综合实战：从零到上线，把所学串成一条线从需求拆解、项目初始化、功能开发、测试、Git 提交到上线检查的完整案例，把前面学到的 Claude Code 能力串成可复用流程。

收尾与查阅5 篇

  1. 49最佳实践：把零散的好习惯，攒成一套能照着做的心法任务拆分、上下文控制、先计划后修改、验证闭环、权限边界和规则维护等最佳实践，帮助你减少返工并提升代理结果质量。
  2. 50反模式：常见的错误用法模糊指令、无限上下文、过度授权、跳过验证和错误配置等常见反模式，解释问题为什么发生以及应该如何修正。
  3. 51常见问题排查（FAQ / Troubleshooting）安装、登录、网络、权限、MCP、IDE、模型和性能等常见故障的定位顺序与解决方法，适合遇到问题时按现象快速查找。
  4. 52术语表（小白友好）：把这一路的「黑话」一次性翻译成人话解释 Agent、Context、Token、MCP、Hook、Skill、Subagent、Checkpoint 等高频术语，并给出它们在 Claude Code 中的实际作用
  5. 53制作视频（Remotion）〔选读〕使用 Claude Code 和 Remotion 从脚本、组件、动画、素材到渲染输出制作程序化视频，说明适用场景、开发流程与验收方法。