Claude Code¶

本文你会学到：

🎯 Claude Code 是什么，它和 GitHub Copilot 等工具的本质区别
💡 Claude Code 能帮你做哪些事
🔧 在哪些平台上可以使用
📦 扩展体系概览（CLAUDE.md、Skills、Hooks、MCP、Sub-agents、Plugins）
⚡ 推荐的学习路线和阅读顺序

Claude Code 是什么¶

想象你带了一个实习生团队进项目——他们能读懂整个代码仓库、能改文件、能跑命令、能帮你查文档，但每次只能由你口述需求、他们来执行。Claude Code 就是这样一个团队。

更精确地说，Claude Code 是 Anthropic 推出的 AI 编程助手（Agentic Coding Tool）。它运行在你的终端或 IDE 中，能够：

理解整个代码仓库的结构和逻辑
跨多个文件编辑代码
执行终端命令（构建、测试、部署）
与你已有的开发工具集成

和传统 AI 编程工具的区别¶

传统工具（如 GitHub Copilot）更像一个「智能补全框」——你在编辑器里写代码，它帮你补全下一行。而 Claude Code 是一个 Agent（智能体）：你描述想要的结果，它自己决定怎么做——读哪些文件、改哪些代码、跑哪些命令。

换句话说：

特性	传统 AI 补全工具	Claude Code
交互方式	行级补全 / 内联建议	自然语言对话，描述目标即可
作用范围	当前文件的光标位置	整个代码仓库，跨文件操作
能力边界	生成代码片段	生成代码 + 执行命令 + 多步推理
主动性	等你敲代码才触发	主动分析、主动执行、主动验证

能做什么¶

Claude Code 的核心能力可以归纳为以下几个场景：

🏗️ 功能开发¶

你只需要用自然语言描述需求，比如「给用户模块加上邮箱验证功能」，Claude Code 会：

先阅读现有代码，理解项目结构和编码风格
规划实现方案（创建哪些文件、修改哪些文件）
编写代码并执行测试
如果测试失败，自动调试修复

🔍 Bug 排查¶

把报错信息或问题描述丢给 Claude Code，它会：

追踪错误堆栈，定位到具体文件和行号
分析根因（是逻辑错误、配置问题还是依赖冲突）
提出修复方案并验证

🔄 代码重构¶

比如「把这个类的数据库查询从 MyBatis XML 迁移到 JPA」，Claude Code 能跨多个文件完成迁移，并确保不破坏已有测试。

📝 文档与解释¶

「解释这段代码在做什么」——给出清晰的逐行解读
「为这个 API 写单元测试」——根据你的测试框架生成测试代码

🤖 自动化任务¶

通过 CI/CD 集成和扩展机制，Claude Code 还能自动执行 PR 审查、Issue 分流、定时任务等。

🔧 故障排除¶

安装失败、连接超时、命令找不到？Claude Code 提供了 claude doctor 诊断命令和详细的错误提示。如果遇到问题，先运行 claude doctor 检查环境，再查看常见问题排查指南。

支持哪些平台¶

Claude Code 的底层引擎是统一的，无论你在哪个平台上使用，你的 CLAUDE.md 配置、MCP 服务器、Settings 等都保持一致。

主要使用环境¶

平台	安装方式	特点
Terminal CLI（终端命令行）	`curl` / `brew` / `winget` 安装	功能最完整，支持所有特性，适合重度使用者
VS Code	扩展商店搜索 "Claude Code"	内联 diff 预览、`@` 提及文件、计划评审、对话历史
Cursor	扩展商店安装	类似 VS Code 的体验，在 Cursor 编辑器中使用
JetBrains（IDEA/PyCharm/WebStorm）	JetBrains Marketplace 安装	交互式 diff 查看和选中代码上下文共享
Desktop App（桌面应用）	官网下载安装	可视化 diff、多会话并行、定时任务、云端会话
Web（浏览器）	访问 claude.ai/code	无需本地安装，适合长时间运行的任务和云端仓库

扩展体系¶

Claude Code 的强大之处在于它不是「一个死板固定的工具」，而是一个**可扩展的平台**。以下是六个核心扩展机制：

CLAUDE.md：项目级持久化指令¶

CLAUDE.md 是你放在项目根目录（或 ~/.claude/ 全局目录）下的配置文件。Claude Code 每次启动时都会自动读取它——就像贴在工位隔板上的便利贴，把关键规范和偏好写在最显眼的地方，每次开工都能一眼看到。

项目级（项目根目录/CLAUDE.md）：定义该项目特有的编码规范、常用命令、架构说明
全局级（~/.claude/CLAUDE.md）：定义你个人的偏好，如语言风格、编码规范等，跨所有项目生效

Skills：自定义技能¶

Skills 是预定义的「技能模板」，像手机里的快捷指令——你定义好流程，一键执行。比如你可以创建一个 code-review skill，定义代码审查的标准流程和检查清单。

Skills 存放在 .claude/skills/ 目录下，支持全局和项目级两种范围。

Hooks：事件钩子¶

Hooks 让你在 Claude Code 执行特定操作的前后自动触发脚本。例如：

提交代码前自动运行 linter
文件修改后自动格式化
每次对话开始时自动加载上下文

MCP：外部工具集成¶

MCP（Model Context Protocol）像一个万能转接头——让 Claude Code 能插到各种外部服务上。它是 Anthropic 推出的开放协议，通过配置 MCP 服务器，Claude Code 可以：

查询数据库
调用内部 API
搜索文档
与 Jira/Linear 等项目管理工具交互

Sub-agents：子代理¶

Sub-agents 允许你将复杂任务分解为多个子任务，每个子任务由一个独立的 Claude Code 实例执行。适合：

多个文件并行修改
需要隔离环境的实验性操作
大型重构任务

Plugins：插件系统¶

Plugins 提供了更高级的扩展能力，可以添加全新的命令、工具和工作流。社区和官方都提供了丰富的插件可供使用。

扩展机制对比¶

机制	解决什么问题	典型场景
`CLAUDE.md`	持久化项目规范和个人偏好	定义代码风格、常用命令
Skills	封装可复用的工作流程	代码审查、测试驱动开发
Hooks	在特定时机自动执行脚本	提交前检查、自动格式化
MCP	连接外部工具和服务	查数据库、调 API、查文档
Sub-agents	并行执行独立子任务	多文件重构、实验性操作
Plugins	扩展命令和工具能力	自定义斜杠命令、新工具

速度模式（Fast Mode）¶

Claude Code 还提供 Fast Mode，这是 Opus 4.6 的高速度配置——模型质量不变，但响应速度提升约 2.5 倍。适合需要快速迭代的场景，如实时编码辅助和频繁问答。详见「模型与输出风格」中 Fast Mode 的完整说明。

学习路线¶

如果你是第一次接触 Claude Code，建议按以下顺序学习：

安装与快速入门 — 选择你的平台，安装 Claude Code，完成第一次对话
基本使用 — 学会描述需求、查看 diff、执行命令等日常操作
配置 CLAUDE.md — 为你的项目编写工作手册，让 Claude Code 更懂你的项目
进阶扩展 — 根据需要探索：上下文工程（精准投喂上下文）、多平台支持（VS Code/JetBrains/Desktop/Web）、扩展体系（Skills、Hooks、MCP、Sub-agents、Plugins、Channels）、自动化与企业集成（Agent SDK、GitHub Actions）
最佳实践与故障排除 — 常见反模式、验证闭环、成本管理、排错方法论
相关资源 — 官方插件目录、社区资源与学习材料

每个阶段都建立了前一阶段的基础，不要跳步。尤其 CLAUDE.md 是投资回报率最高的配置——花 10 分钟写好它，后续每次对话都能受益。

场景	推荐方案
在手机上继续本地会话	Remote Control（通过手机远程控制本地正在运行的 Claude Code 会话，适合离开工位后继续跟进任务）
从 Telegram/Discord/Slack 推送事件到会话	Channels（将外部消息平台的提示词自动转发到 Claude Code，实现事件驱动的自动化工作流）
本地开始任务，手机上继续	Web 或 Claude iOS App
定时自动执行任务	Cloud / Desktop 定时任务
自动化 PR 审查和 Issue 分流	GitHub Actions / GitLab CI/CD
每个 PR 自动代码审查	GitHub Code Review
从 Slack 把 Bug 报告路由到 PR	Slack 集成
调试线上 Web 应用	Chrome 浏览器扩展
构建自定义 Agent 工作流	Agent SDK（用 Python/TypeScript 代码编排多步 Agent 调用流程，适合构建自动化流水线）