Claude Code in Action 中文版 / Chinese Edition

一套面向中文开发者的 Claude Code 实战课程本地化项目。
A Chinese-localized Claude Code course project built for developers who want a structured, practical path into AI-assisted software engineering.

从编程助手的底层工作方式，到 hooks、SDK、MCP、GitHub 集成与真实工程流，全链路拆解 Claude Code 如何进入现代软件开发现场。
From the mechanics of coding assistants to hooks, SDK, MCP, GitHub integration, and production-style workflows, this project maps how Claude Code fits into modern engineering practice.

项目定位 / Positioning

Claude Code in Action 中文版 是 Anthropic 官方 Claude Code 课程的中文本地化版本。项目将原课程整理为 18 节可直接阅读的中文课程内容，并提供一个本地静态学习入口，方便按照模块循序渐进地学习 Claude Code 的核心能力。

Claude Code in Action Chinese Edition is a Chinese localization of Anthropic's official Claude Code course. It organizes the original curriculum into 18 readable lessons and includes a local static learning portal for module-by-module study.

这不是零散笔记，而是一套结构完整的学习路径：先理解编程助手如何通过工具使用完成真实任务，再进入项目配置、上下文管理、代码修改、命令扩展、MCP、GitHub 集成，最后深入 hooks 与 SDK，把 Claude Code 从“会聊天的工具”推进到“可编排、可扩展、可落地的工程系统”。

This is not a pile of notes. It is a coherent learning path: understand how coding assistants use tools to complete real tasks, move into project setup, context control, code changes, custom commands, MCP, and GitHub integration, then go deeper into hooks and SDKs to turn Claude Code into an extensible engineering system.

核心亮点 / Highlights

• 完整中文化课程体系 / Complete Chinese course structure：覆盖 4 个模块、18 节课程，保留关键技术术语，降低中文开发者的理解门槛。Covers 4 modules and 18 lessons while preserving important technical terms.
• 从原理到实战闭环 / From concepts to practice：不仅解释 Claude Code 是什么，也展示如何配置项目、控制上下文、修改代码、扩展命令和接入工具链。Explains what Claude Code is and how to use it in real workflows.
• 聚焦高级工程能力 / Advanced engineering topics：系统介绍 MCP servers、GitHub integration、hooks、SDK 等进阶主题。Covers MCP servers, GitHub integration, hooks, SDK, and automation-oriented workflows.
• 可本地阅读的静态站点 / Local static learning portal：根目录提供 index.html，无需构建流程即可打开学习。Open index.html directly and start reading without a build step.
• 面向真实工作流 / Built around real workflows：内容围绕开发者如何在项目中使用 Claude Code，而不是停留在概念介绍。Focuses on how developers actually bring Claude Code into projects.

课程全景 / Course Map

模块 / Module	内容 / Content	学习目标 / Outcome
01. What is Claude Code	编程助手原理、Claude Code 介绍 / Coding assistant fundamentals and Claude Code overview	理解 Claude Code 的能力边界与工具使用机制 / Understand tool use and Claude Code's capability boundaries
02. Getting Hands On	安装、项目配置、上下文、修改代码、自定义命令、MCP、GitHub / Setup, project configuration, context, code changes, custom commands, MCP, GitHub	掌握日常开发中使用 Claude Code 的核心工作流 / Learn the core daily workflow
03. Hooks and the SDK	hooks 定义、实现、常见问题、实用 hooks、SDK / Hooks, implementation details, gotchas, useful hooks, SDK	学会把 Claude Code 接入更复杂的自动化与工程系统 / Connect Claude Code to automation and engineering systems
04. Wrapping Up	总结与下一步 / Summary and next steps	建立后续深入实践路线 / Plan the next stage of practice

推荐学习路线 / Recommended Path

1. 从 01-what-is-claude-code 开始，先建立对编程助手和 tool use 的正确理解。
   Start with 01-what-is-claude-code to understand coding assistants and tool use.
2. 进入 02-getting-hands-on，按顺序完成安装、项目设置、上下文控制和代码修改。
   Move into 02-getting-hands-on for setup, project configuration, context control, and code changes.
3. 学完 custom commands、MCP servers、GitHub integration，理解 Claude Code 如何嵌入现有工具链。
   Study custom commands, MCP servers, and GitHub integration to see how Claude Code connects with existing tooling.
4. 进入 03-hooks-and-the-sdk，学习 hooks 与 SDK，把 Claude Code 从交互式助手扩展为可自动化的开发平台。
   Continue with 03-hooks-and-the-sdk to extend Claude Code through hooks and SDKs.
5. 最后阅读 04-wrapping-up，整理自己的实践路线。
   Finish with 04-wrapping-up and define your own practice roadmap.

快速开始 / Quick Start

直接打开根目录的静态页面：
Open the static learning portal from the project root:

start .\index.html

也可以直接阅读 Markdown 课程文件：
You can also read the Markdown lessons directly:

claude-code-in-action-course/
├── 01-what-is-claude-code/
├── 02-getting-hands-on/
├── 03-hooks-and-the-sdk/
└── 04-wrapping-up/

项目文档 / Project Docs

• CHANGELOG.md：维护更新记录 / Maintenance history
• CONTRIBUTING.md：贡献指南 / Contribution guide
• docs/COURSE_INDEX.md：完整课程索引 / Full course index
• docs/ROADMAP.md：后续维护路线图 / Maintenance roadmap

项目结构 / Project Structure

claude-code-in-action/
├── index.html                         # 本地静态学习入口 / Local static learning portal
├── AGENTS.md                          # 项目知识库与协作说明 / Project knowledge base and agent notes
├── CHANGELOG.md                       # 更新日志 / Changelog
├── CONTRIBUTING.md                    # 贡献指南 / Contribution guide
├── README.md                          # 项目说明 / Project README
├── docs/
│   ├── COURSE_INDEX.md                # 课程索引 / Course index
│   └── ROADMAP.md                     # 路线图 / Roadmap
└── claude-code-in-action-course/
    ├── 01-what-is-claude-code/        # 模块 1：基础 / Module 1: fundamentals
    ├── 02-getting-hands-on/           # 模块 2：实战 / Module 2: hands-on workflow
    ├── 03-hooks-and-the-sdk/          # 模块 3：Hooks 与 SDK / Module 3: hooks and SDK
    └── 04-wrapping-up/                # 模块 4：总结 / Module 4: wrap-up

适合谁 / Who This Is For

• 想系统学习 Claude Code 的中文开发者
  Chinese-speaking developers who want a structured path into Claude Code
• 想把 AI coding assistant 引入真实项目工作流的工程师
  Engineers bringing AI coding assistants into real project workflows
• 想理解 MCP、hooks、SDK 等 Claude Code 进阶能力的技术人员
  Technical practitioners studying MCP, hooks, SDK, and advanced Claude Code capabilities
• 想为团队建立 Claude Code 使用规范、课程或内部培训材料的人
  Teams building internal Claude Code standards, training material, or onboarding resources

内容约定 / Content Conventions

• 技术术语保留英文，例如 Claude Code、hooks、SDK、MCP。
  Technical terms such as Claude Code, hooks, SDK, and MCP are kept in English.
• 代码示例保留原始表达，必要说明翻译为中文。
  Code examples keep their original form, with supporting explanations localized where needed.
• 文件命名遵循 {序号}-{英文标题}.md，便于和原课程结构对应。
  Filenames follow {number}-{english-title}.md for alignment with the original course structure.
• 视频、满意度调查与 Quiz 内容未包含在本项目中。
  Videos, satisfaction surveys, and quiz sections are not included.

来源说明 / Source

原始课程来自 Anthropic Skilljar 平台的 Claude Code in Action。本项目为中文本地化学习材料，便于中文开发者阅读、检索和本地学习。

The original course comes from Claude Code in Action on Anthropic Skilljar. This repository provides localized learning material for reading, searching, and studying locally.