Claude Code 完整中文教程
Claude Code 是一个基于命令行的 AI 编程助手,通过模块化设计实现了从代码编写、审查到项目管理的全流程自动化。其核心架构包含 CLI 基础、记忆系统、技能调用、钩子机制、MCP 插件、子代理等多个功能模块。本文将系统梳理这些核心模块的功能定义,并通过一个完整的实操流程演示各模块在实际开发场景中的调用时机与协作方式。
01核心模块功能解析
- CLI Basics(命令行基础)
作为系统的入口,负责启动 Claude、切换模型及查看帮助信息,是交互的基础。 - Memory(记忆)
自动读取项目根目录下的 CLAUDE.md 文件,获取项目规范(如缩进格式、命名规则),避免重复输入上下文。 - Skills(技能)
预设的标准化操作流程,如代码审查、自动测试等。通过 SKILL.md 文件定义执行步骤与输出格式,实现复杂任务的自动化调用。 - Slash Commands(斜杠命令)
快捷指令入口,如 /commit 可自动执行代码提交流程,包括生成 Commit Message 并提交。 - Checkpoints(存档点)
自动记录操作历史,允许随时回退到指定状态,用于调试或撤销错误修改。 - Subagents(子代理)
并行处理机制,当需要同时执行多个独立任务时,可派发专门的子代理分别处理,最后汇总结果。 - Hooks(钩子)
事件触发机制,内置的 PermissionRequest Hook 会在执行敏感操作(写文件、删文件、执行命令)时触发权限确认弹窗。 - MCP(插件系统)
用于连接外部服务(如 GitHub、数据库)或管理本地文件系统权限。支持手动配置服务插件或自动创建临时文件系统授权。
02完整实战流程演示
- 启动与环境加载
在终端启动 Claude Code,系统自动通过 Memory 模块读取项目规则,建立初始上下文。 - 执行写入操作与权限管理
当请求代码写入时,Hooks 模块触发权限确认弹窗。用户选择“Yes --scope ...”选项时,系统自动创建临时 Filesystem MCP 授权,允许后续对指定路径的访问。 - 代码质量审查
调用 Skills 模块中的 code-review 技能,按照预设标准检查代码质量并输出报告。 - 代码提交
使用 Slash Command 输入 /commit,自动扫描 Git 变更并生成规范的提交信息完成提交。 - 状态回退
若发现错误,利用 Checkpoints 模块回退到历史操作记录中的任意存档点。 - 并行任务处理
对于复杂需求,Subagents 模块会启动多个子代理并行处理不同任务,汇总后返回结果。 - 外部服务集成
通过配置 MCP 插件(如 GitHub 服务),直接读取 Issue、创建 PR 或执行仓库操作。
03进阶配置技巧
| 配置项 | 位置 | 功能说明 |
|---|---|---|
| Slash Commands | ~/.claude/commands | 存放自定义快捷命令(如简单文本回复或固定脚本) |
| Skills | .claude/skills | 存放高级技能脚本,支持 Frontmatter 配置(如 disable-model-invocation 防止误调用) |
两种配置路径的功能区别
Skills 模块通过 Frontmatter 定义元数据,支持命令注入和文件内容读取。例如设置 disable-model-invocation: true 可强制要求手动输入命令(如 /deploy)才能触发,防止 AI 自动执行高风险操作。记忆系统遵循优先级:公司级 > 目录级 > 项目级 > 个人级,确保在不同层级下规范的有效覆盖。
当前文章无评论,是时候发表评论了