AI 编程教程中文版

Claude Code 中文教程

基于 Anthropic 官方文档、源码和发布记录重写的 Claude Code 中文教程,连接翔宇工作流的真实项目实践。

中文开发者的 Claude Code 官方教程中文版。这里以 Anthropic 官方文档、源码和发布记录为事实基准,重新组织成适合中文开发者学习和操作的教程:安装、登录、CLI、配置、权限、MCP、Skills、Subagents、Hooks、插件和 SDK。

这一站不是 Anthropic 官方文档的翻译:每一篇都按"中文新手 → 第一性原理 → 循序渐进"重写。理解篇负责心智模型,官方篇负责事实基准;两条路径同时跑,不替代彼此。

翔宇工作流主站负责另一件事:记录真实项目里怎么用 Claude Code、怎么踩坑、怎么把工具变成长期工作流。教程站不替代主站实践,只给主站提供稳定的事实基准。

两条互补路径

三层分工

  • 教程站:吸收 Claude Code 官方资料,重写成中文学习路径,保持事实准确、结构稳定、便于检索。
  • 翔宇主站:承接 Claude Code 的个人实践、项目复盘、失败经验和工作流判断。
  • GitHub:保留公开内容源,方便追踪变更、提交 Issue 或 PR。

推荐学习顺序

第一次系统学习 Claude Code,不要直接从高级插件或自动化开始。更稳的顺序是:

  1. 先读官方教程中文版,确认安装、登录、CLI、项目上下文、权限和基本命令。
  2. 再读“从原理到实战”,理解它为什么能读代码、改文件、调用工具和运行命令。
  3. 然后回到真实项目,用一个小改动练习 plan、edit、test、review 的闭环。
  4. 最后再进入 MCP、Skills、Subagents、Hooks、插件和 SDK,把重复流程沉淀成可复用能力。

这个站点的定位不是“把 Anthropic 文档翻译一遍”。每篇文章都会尽量回答三个问题:官方能力是什么、中文开发者容易误解在哪里、放到真实项目时应该如何验收。

适合谁读

  • 刚开始使用 Claude Code,需要一套中文路径避免在官方文档里来回跳转。
  • 已经会用 CLI,但想系统理解权限、上下文、MCP 和 agentic workflow。
  • 正在把个人 prompt 升级为团队规则、Skills 或自动化流程。
  • 需要给学员或团队成员一个稳定入口,而不是把零散链接发给他们。

如果你只想看最新产品细节,应该回官方文档核验;如果你想看翔宇工作流怎么在真实项目里使用 Claude Code,再回主站实践文章。

商业项目里的学习目标

学完这套 Claude Code 教程后,最低标准不是“知道有哪些功能”,而是能在一个真实 repo 里完成可审查任务:

  • 让 Claude Code 先读项目规则和相关文件,再开始修改。
  • 能控制权限、命令执行和外部工具访问。
  • 能把大任务拆成可验证的小任务。
  • 能要求它跑测试、解释失败、修根因,而不是跳过错误。
  • 能把高频经验写成项目规则、Skill 或团队 SOP。

这些能力决定它能不能进入长期工作流。只会让模型“帮我写代码”还不够,商业项目需要的是范围控制、事实核验、可回滚 diff 和稳定交付。

入口选择

站内两条路径可以交替读:

  • 想查功能和配置:进官方教程中文版,从目录页按模块找答案。
  • 想理解使用逻辑:进从原理到实战,按“为什么这样用”建立判断。

真实项目里通常先查官方教程确认事实,再回原理页判断任务边界。比如遇到 MCP 问题,先确认 Claude Code 支持什么配置和命令,再判断这个 MCP 是否应该进入项目、是否需要凭据隔离、是否会扩大权限面。这样读,教程站就不是资料堆叠,而是一个能指导工作流决策的索引。

更新原则

Claude Code 变化很快,教程站只保留稳定能力和可复用操作。涉及模型、套餐、平台限制、发布节奏或实验功能时,以官方文档和发布记录为准;涉及翔宇工作流的真实用法时,以主站实践文章为准。两者分开,能避免教程页写成临时新闻,也避免实践页承担事实手册的职责。

后续更新时,优先补会影响真实操作的内容:安装认证、权限边界、MCP 配置、项目规则、工具调用、测试验证和团队复用。只影响营销文案或临时 UI 位置的变化,不进入核心教程。

因此,这个入口页只负责帮你选路;具体步骤进入官方教程,具体判断进入原理实战,具体案例回主站。

阅读时建议从一个真实仓库带着问题进入,而不是只顺序浏览目录。带着失败命令、权限疑问或迁移目标阅读,吸收效率更高,也更容易形成可复用的工作流方法。

官方资料

延伸学习

本页目录