Claude Code 全面上手指南：10 大核心能力一篇搞定

weixin_57997461

790人浏览 · 2026-05-19 16:25:49

weixin_57997461 · 2026-05-19 16:25:49 发布

本文基于开源项目 claude-howto-zh-cn（非官方中文版）整理，覆盖 Claude Code 从入门到进阶的全部核心功能，适合中国开发者快速上手。

前言

如果你还不知道 Claude Code，简单说：它是 Anthropic 官方推出的 AI 编程 CLI 工具，能在终端里直接帮你写代码、改 bug、做 code review、跑测试，甚至自动提交 PR。

但它不只是一个"聊天机器人"——Claude Code 背后有一整套能力体系，包括 斜杠命令、记忆系统、技能、子代理、MCP 外部工具接入、Hooks 自动化、插件分发、安全回退 等。这套体系才是它真正强大的地方。

这篇文章就带你 一次性搞懂全部 10 大核心能力。

一、Slash Commands — 斜杠命令（最基础，最先学）

是什么

在 Claude Code 对话框里输入 / 开头的命令，就是 Slash Command。它是你与 Claude 交互的最直接方式。

常用命令速查

命令	作用
`/help`	查看帮助
`/clear`	清空对话
`/config`	修改配置（现在会真正写入配置文件）
`/model`	切换模型
`/effort`	调整思考强度
`/plan`	进入规划模式（只规划不写代码）
`/focus`	聚焦到指定文件/目录
`/commit`	自动生成 commit message
`/pr`	提交 PR 前的整理与检查
`/review`	代码审查
`/init`	初始化项目 CLAUDE.md

四种类型

内置命令 — Claude Code 自带，开箱即用
Skills 形式命令 — 用 Skill 机制封装的自定义命令
Plugin 命令 — 通过插件安装的命令
MCP Prompts — 通过 MCP 服务器提供的命令

Tips： 2026 年 4 月新增了 /powerup、/tui、/recap 等高频命令，建议更新到最新版体验。

二、Memory — 记忆系统（让 Claude "记住"你的项目规则）

是什么

每次开新会话，Claude 都是从零开始。Memory 机制通过 CLAUDE.md 文件让 Claude 自动加载长期规则，不用每次重复说明。

三层记忆结构

~/.claude/CLAUDE.md          ← 个人级（所有项目共享）
./CLAUDE.md                  ← 项目级（团队共享，提交到 Git）
./src/api/CLAUDE.md          ← 目录级（只在该目录生效）
./CLAUDE.local.md            ← 个人项目记忆（不提交到 Git）

怎么用

最简单的四种方式：

复制模板 — 项目提供了现成模板，改改就能用
/init 命令 — 让 Claude 自动分析项目并生成 CLAUDE.md
/memory 命令 — 直接编辑记忆内容
自然语言 — 直接告诉 Claude “记住：本项目使用 pnpm，不要用 npm”

关键点： MEMORY.md 前 200 行会在启动时自动加载，把最重要的规则放在最前面。

三、Skills — 技能系统（可复用的工作流）

是什么

Skill 是一套 预定义的工作流 + 模板 + 最佳实践，当 Claude 检测到合适场景时，会自动"拿出"对应 Skill 来完成任务。

Skill 的目录结构

.claude/skills/my-skill/
├── SKILL.md              ← 技能定义（必需）
├── templates/            ← 模板文件
├── scripts/              ← 辅助脚本
└── references/           ← 参考资料

放在哪里

个人级 ~/.claude/skills/ — 你自己的技能，所有项目可用
项目级 .claude/skills/ — 团队共享，提交到 Git
Plugin 自带 — 安装插件时自动加载

内置示例

Skill	用途
`code-review`	代码审查
`doc-generator`	文档生成
`refactor`	结构化重构
`blog-draft`	博客草稿生成
`brand-voice`	文案风格统一

进阶： Skill 支持 渐进式加载，不会一次性把所有内容塞进上下文，按需展开，节省 token。

四、Subagents — 子代理（任务拆分与分工）

是什么

面对复杂任务时，主 Claude 可以把子任务交给专门的 Subagent 处理。每个 Subagent 有独立的上下文、专业的 prompt 和受限的工具集。

为什么需要它

上下文隔离 — 子任务不污染主对话
专业分工 — 代码审查和安全审查用不同的 agent
并行执行 — 多个 agent 同时工作，提高效率
可复用 — 定义一次，到处使用

定义方式

在 .claude/agents/ 目录下创建 .md 文件：

---
name: code-reviewer
description: 代码审查专家
tools:
  - Read
  - Grep
  - Glob
model: sonnet
effort: high
---

你是一位资深代码审查员...

内置示例

Subagent	角色定位
`code-reviewer`	代码质量审查
`secure-reviewer`	安全漏洞检查
`test-engineer`	测试策略与覆盖
`performance-optimizer`	性能分析与优化
`debugger`	错误调试与根因定位
`data-scientist`	数据分析与 SQL

五、MCP — 外部工具接入（让 Claude 连接真实世界）

是什么

MCP（Model Context Protocol）是 Claude Code 接入外部服务的标准协议。通过 MCP，Claude 可以操作 GitHub、读写数据库、访问文件系统、调用各种 SaaS 工具。

两种安装方式

stdio transport — 本地启动 MCP 服务器进程
HTTP transport — 连接远程 MCP 服务器

常见场景

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"]
    },
    "database": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"]
    }
  }
}

实用功能

/mcp 命令 — 查看连接状态、排错、触发 OAuth
alwaysLoad — 指定 MCP 工具每轮都加载，不用等 Claude 按需调用
MCP Apps — MCP 服务器可以返回带交互的 UI 组件（仪表盘、表单等）

六、Hooks — 事件驱动自动化（你的 CI/CD 管家）

是什么

Hooks 是 Claude Code 的 事件触发自动化机制——在特定时机（比如执行命令前、文件编辑后、会话结束时）自动执行你预设的动作。

核心模型

事件触发 → Matcher 匹配 → 自动执行动作

五种 Hook 类型

类型	说明	示例
`command`	执行本地 Shell 命令	提交前跑测试
`http`	调用 HTTP 接口	通知团队
`mcp_tool`	调用 MCP 工具	记录到 Notion
`prompt`	插入提示词	自动添加上下文
`agent`	启动子代理	深度分析

典型场景

提交前自动跑测试和格式化
Bash 命令执行前检查高风险操作
会话结束时记录工作日志
文件编辑后自动安全扫描

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Bash",
      "hooks": [{
        "type": "command",
        "command": "./scripts/pre-tool-check.sh"
      }]
    }]
  }
}

七、Plugins — 插件（一键安装整套工作流）

是什么

Plugin 把 Skills、Hooks、MCP、Subagents、Commands 等 多项能力打包成一个可安装包，适合团队统一分发和管理。

插件结构

my-plugin/
├── .claude-plugin/
│   └── plugin.json        ← 插件清单（必需）
├── commands/               ← 自定义命令
├── agents/                 ← 子代理定义
├── skills/                 ← 技能
├── hooks/                  ← 钩子
└── .mcp.json              ← MCP 配置

安装方式

Marketplace — 官方插件市场
本地目录 — claude plugin add ./my-plugin
Git 仓库 — claude plugin add https://github.com/...
ZIP 包 — claude plugin add ./plugin.zip

内置示例

插件	功能
`pr-review`	完整的 PR 审查流程
`documentation`	文档生成与同步
`devops-automation`	部署、监控、事故处理一体化

八、Checkpoints — 安全回退（放心让 Claude 改代码）

是什么

Checkpoints 是 Claude Code 的 自动快照机制。每次 Claude 做出修改时，系统都会自动创建一个快照，包含对话消息、文件改动和工具使用历史。

核心功能

自动创建 — 不需要手动"存档"
随时回退 — 选择任意一个检查点恢复
五种回退选项：
1. 恢复代码和对话
2. 只恢复对话
3. 只恢复代码
4. 从该点压缩总结
5. 取消

配置

{
  "cleanupPeriodDays": 30
}

注意： Checkpoints 默认开启，不需要手动设置 autoCheckpoint: true。cleanupPeriodDays 统一控制检查点、任务、Shell 快照和备份的保留周期。

九、Advanced Features — 高级能力（进阶必学）

这部分覆盖 17 个高级特性，挑最实用的几个讲：

9.1 Planning Mode（规划模式）

先让 Claude 规划，审核通过后再执行。从 v2.1.136 起，规划阶段 无条件阻止所有文件写入，真正安全。

9.2 Extended Thinking（扩展思考）

让 Claude “想得更深”。三种触发方式：

输入 ultrathink 关键词
用 /effort 调整思考强度
按 Alt+T 快速切换

9.3 Background Tasks（后台任务）

把耗时任务丢到后台，不阻塞当前会话。

9.4 Scheduled Tasks（定时任务）

像 crontab 一样定时触发 Claude 执行任务。

9.5 Permission Modes（权限模式）

6 种权限模式，从最严格到最宽松：

模式	说明
`default`	每次操作都询问
`acceptEdits`	自动接受文件编辑
`plan`	只规划不执行
`dontAsk`	不询问但不执行高风险操作
`bypassPermissions`	绕过权限检查
`auto`	全自动（需谨慎）

9.6 Print Mode / Headless（无头模式）

claude -p "解释这个函数的作用" < src/utils.ts

适合 CI/CD 集成和自动化脚本。

9.7 Channels（外部通道）

连接 Discord、Telegram、iMessage、Webhooks，让 Claude 通过外部渠道响应事件。

十、CLI — 命令行参考（你的速查手册）

最常用命令

claude                    # 启动交互式对话
claude -p "任务描述"      # 非交互模式，直接输出结果
claude -c                 # 继续上次会话
claude -r                 # 恢复历史会话
claude mcp add            # 添加 MCP 服务器
claude plugin add         # 安装插件

核心 Flags

Flag	作用
`--model`	指定模型
`--effort`	思考强度
`--permission-mode`	权限模式
`--allowedTools`	允许的工具列表
`--output-format`	输出格式（json/text）
`--tmux`	创建 tmux 会话
`--add-dir`	添加工作目录

学习路线推荐

新手入门 → 01 Slash Commands → 02 Memory → 03 Skills
         ↓
进阶使用 → 04 Subagents → 05 MCP → 06 Hooks
         ↓
团队协作 → 07 Plugins → 08 Checkpoints
         ↓
高级定制 → 09 Advanced Features → 10 CLI

总结

Claude Code 不只是一个终端里的 AI 聊天工具，它是一个 完整的 AI 辅助开发平台：

能力层	包含功能	解决什么问题
交互层	Slash Commands	快捷操作、即用即走
记忆层	Memory / CLAUDE.md	跨会话保持上下文
工作流层	Skills	可复用的任务模板
分工层	Subagents	复杂任务拆分
集成层	MCP	连接外部工具和服务
自动化层	Hooks	事件驱动的自动执行
分发层	Plugins	团队统一能力打包
安全层	Checkpoints	安全试错与回退
进阶层	Advanced Features	规划、思考、权限、自动化
入口层	CLI	命令行全集

10 大能力环环相扣，从一个人用终端写代码，到整个团队用插件统一工作流，再到 CI/CD 全自动化，都有覆盖。

相关资源：

原项目地址：claude-howto-zh-cn（中文版）
上游项目：luongnv89/claude-howto
配套文件：LEARNING-ROADMAP.md（学习路线图）、CATALOG.md（功能总表）、QUICK_REFERENCE.md（速查手册）