Claude Code 中文教程
从安装入门到高级实战
一套面向 0 基础学习者的 Claude Code 中文指南。内容覆盖安装、认证、各 IDE 集成与 Cloud 端,并深入 CLAUDE.md、子代理、Skills、Hooks、GitHub Actions 与综合实战,共 53 篇,按学习路线循序渐进。
↓学习路线
第一次接触 AI 编程工具:从第一组开始,按编号顺序学习。已经会基础操作:直接进入第三、四组,补齐工作流、权限与扩展能力。只想快速查资料:从第七组的速查、排错和术语进入。
一基础入门先弄清 Claude Code 是什么,完成安装、认证与模型接入。
01Claude Code 是什么:功能、原理与适用场景Claude Code 的产品定位、代理式工作方式、能做什么与不能做什么,以及它和 ChatGPT、Copilot、Cursor 的核心区别。
02安装教程:Mac、Windows 与 Linux三大平台和 WSL 的安装步骤、登录方法、网络要求与常见报错处理,让第一次用命令行的读者也能装好。
03工作原理:代理循环与内置工具代理循环、上下文窗口、内置工具和权限确认机制,解释它如何从理解任务走到修改文件与验证结果。
04API 配置:订阅登录与 API Key 怎么选订阅登录、Anthropic API Key 与云厂商认证的差异、费用归属和切换方式,帮你选对接入路径。
05接入 DeepSeek 等第三方模型通过兼容网关或第三方服务配置模型的基本原理、环境变量、验证方法和风险边界,别把兼容接口当成官方能力。
二上手与项目从第一次任务走到编辑器、桌面端、云端和项目规则。
06订阅套餐与计费完整说明各订阅套餐、API 计费与使用额度的关系,以及不同使用强度下怎么选方案、看成本和避免意外消耗。
07第一次使用:从启动到完成任务首次进入项目、授权信任、发送任务、检查修改和验证结果的完整流程,用一个最小示例跑通第一次代理任务。
08VS Code 集成与使用指南在 VS Code 中安装、启动、选区引用、差异查看与终端协作方式,把编辑器操作和代理任务连成一套工作流。
09JetBrains 集成与使用指南在 IntelliJ IDEA、PyCharm 等 JetBrains IDE 中的安装、上下文共享、差异查看和常用操作,说明插件与终端入口如何配合。
10Desktop 桌面应用完整指南桌面应用的安装、项目管理、会话操作和适用场景,比较 Desktop、终端与网页版入口的能力边界。
11网页版与云端使用指南Web 的仓库连接、云端任务、手机访问和 Deep Link 能力,说明哪些工作适合放云端、哪些应留在本地。
12/init 教程:生成与维护 CLAUDE.md用 /init 扫描项目并生成 CLAUDE.md 的流程、生成结果的检查方法和后续维护原则,让 Claude 快速理解项目。
13项目目录与配置文件详解项目中的 .claude 目录、CLAUDE.md、settings、commands、agents、skills 和 hooks 分别放什么,看懂配置层级与作用范围。
三核心交互与操作掌握提示词、上下文、权限、安全和四类日常工作流。
14交互界面与快捷键速查交互界面的状态区、输入模式、历史记录、快捷键和 Shell 模式,帮你减少鼠标操作、判断会话状态。
15提示词写法:任务、上下文与验收标准如何说明目标、提供上下文、约束改动范围和定义验收标准,用可复用结构减少返工与误改。
16常见工作流:探索、修 Bug、重构与测试探索代码库、定位修复 Bug、控制重构范围和补写测试四类高频任务的标准步骤与验收方法。
17图片与多模态使用指南向 Claude Code 提供截图、设计稿和错误界面的方式,图片上下文适合解决什么问题,以及视觉还原时的验收要点。
18CLAUDE.md 完整指南:层级、写法与最佳实践CLAUDE.md 的发现范围、层级优先级、推荐内容、反模式和维护方法,把稳定的项目规则写成 Claude 可执行的说明书。
19上下文管理:压缩、清理与 Token 控制上下文窗口如何消耗、何时用 compact 或 clear、怎样减少无关材料和会话漂移,让长任务保持准确并控制成本。
20权限配置:模式、规则与审批权限模式、allow 与 deny 规则、工具审批和作用域配置,帮你在效率与安全之间选择合适的开放程度。
21安全指南:风险边界与防护清单提示词注入、恶意仓库、命令执行、敏感信息和供应链风险,以及审查权限、隔离环境与检查输出的防护原则。
四高级功能扩展学会用 MCP、子代理、插件、记忆、Skills 和 Agent Teams 扩展能力。
22MCP 教程:连接外部工具与服务MCP 的工作原理、服务器类型、添加与管理命令、作用域和安全边界,用实际流程说明如何让 Claude 访问外部数据与工具。
23子代理教程:创建、选择与并行协作子代理的隔离上下文、配置文件、工具权限、自动选择和适用任务,帮你把专项工作拆出去而不污染主会话。
24插件指南:安装、组合与分发能力插件如何组合命令、Agent、Skill、Hook 和 MCP,覆盖插件安装、启用、目录结构与团队分发的基本流程。
25记忆系统:跨会话保留项目经验自动记忆与 CLAUDE.md 的区别、记忆内容的查看和管理方式,以及什么信息适合长期保留、什么不该写入。
26Agent Skills 教程:结构、触发与边界Agent Skills 的目录结构、SKILL.md 写法、自动触发与手动调用方式,解释它和命令、子代理、Hook、MCP 的职责差异。
27Skills 实战:安装、调用与验证从发现一个 Skill、安装到正确目录、触发执行到检查结果的完整流程,并说明常见路径错误、触发失败和安全检查方法。
28skill-creator 教程:创建自定义 Skill用 skill-creator 从需求定义、指令编写、资源组织到测试迭代,创建一个自定义 Skill,把重复工作沉淀为稳定能力。
29Agent Teams 教程:多会话团队协作Agent Teams 的负责人、队友、共享任务和消息机制,覆盖启用方式、任务拆分、成本风险和适合并行协作的场景。
30CLAUDE.md、Skill、Hook、MCP 与 Subagent 怎么选对比 CLAUDE.md、Skill、Hook、MCP、Subagent 的触发方式、职责、上下文成本和使用场景,提供一张可套用的功能选择表。
五系统配置与优化集中理解 settings.json、输出样式、Hooks、CLI、模式与检查点。
31settings.json 配置详解用户级、项目级和本地 settings.json 的路径、优先级与常用字段,说明权限、环境变量、Hook 和插件配置如何安全落盘。
32Output Styles 输出样式指南输出样式的作用、内置样式、自定义文件结构、切换方式和适用场景,解释它如何改变回答形式而不替换核心能力。
33Hooks 教程:事件、配置与自动化Hook 的生命周期事件、匹配器、命令配置、输入输出和错误处理,帮你在固定节点自动执行格式化、检查与安全卡点。
34CLI 命令与参数完整参考命令行入口、常用参数、会话恢复、模型选择、权限设置和非交互用法,适合快速查询准确命令。
35控制模式:权限、模型与会话选项启动和会话中的权限模式、模型、思考强度、自动模式与控制选项,帮你看任务风险和复杂度调好执行方式。
36斜杠命令完整指南内置斜杠命令的分类、常用参数和使用时机,覆盖会话管理、上下文、配置、诊断与扩展命令的快速调用。
37Checkpoints 检查点与回滚指南检查点如何保存文件修改、查看历史和恢复到安全状态,说明它能回滚什么、不能替代什么,以及和 Git 的正确配合。
六高级参考与实战把插件、浏览器、并行、Git、CI、SDK 和综合项目串成工程流程。
38插件参考:目录、清单与发布插件目录结构、manifest、组件路径、版本与 marketplace 分发方式,适合需要制作、检查或发布插件的读者。
39实战入门:从需求到交付完整流程用一个真实需求串起项目阅读、计划确认、代码修改、测试验证和结果汇报,展示从开工到交付的标准流程。
40操作 Chrome 浏览器指南连接并操作 Chrome 的安装条件、页面交互、权限确认、调试场景和安全边界,说明浏览器能力适合解决哪些任务。
41并行任务:子代理、Worktree 与团队多会话、子代理、Agent Teams 和 Git Worktree 的并行方式、隔离程度与成本差异,帮你选择不会互相覆盖的协作方案。
42环境变量完整参考常用环境变量的作用、配置位置、优先级与排错方式,覆盖认证、模型、网络、日志和运行行为等关键开关。
43Git 工作流:提交、分支与代码审查让 Claude Code 安全参与查看差异、创建分支、准备提交、处理冲突和审查变更,强调每一步的人类验收边界。
44GitHub Actions 集成教程在 GitHub Actions 和 PR 中调用 Claude Code 的安装、认证、工作流配置、触发方式与安全注意事项。
45Claude Agent SDK 教程:把代理能力接入程序Agent SDK 的核心概念、安装、调用、工具、会话与权限控制,帮开发者把代理循环嵌入自己的应用。
46开发环境配置指南终端、Shell、开发容器、网络代理和项目初始化等环境配置,帮你减少命令执行差异、让 Claude 在稳定环境里工作。
47Voice 语音听写使用指南Voice 语音听写的启用方式、快捷键、语言识别、编辑流程和适用场景,说明它与真正的语音对话模式的区别。
48综合实战:从零开发到上线从需求拆解、项目初始化、功能开发、测试、Git 提交到上线检查的完整案例,把前面学到的能力串成可复用流程。
七收尾与查阅用最佳实践、反模式、故障排查和术语表巩固整套方法。
49最佳实践:稳定交付的工作方法任务拆分、上下文控制、先计划后修改、验证闭环、权限边界和规则维护等最佳实践,帮你减少返工并提升结果质量。
50反模式:常见错误用法与修正模糊指令、无限上下文、过度授权、跳过验证和错误配置等常见反模式,解释问题为什么发生以及如何修正。
51常见问题排查完整指南安装、登录、网络、权限、MCP、IDE、模型和性能等常见故障的定位顺序与解决方法,遇到问题时按现象快速查找。
52术语表:小白也能看懂的概念解释解释 Agent、Context、Token、MCP、Hook、Skill、Subagent、Checkpoint 等高频术语,并给出它们在 Claude Code 中的实际作用。
53制作 Remotion 视频实战用 Claude Code 和 Remotion 从脚本、组件、动画、素材到渲染输出制作程序化视频,说明适用场景、开发流程与验收方法。