ClaudeCode完整学习指南

一直会游泳的小猫2026-03-31 10:52

Claude Code 完整学习指南

基于 claude-howto 项目的完整中文学习文档

目录

  1. 概述
  2. 自我评估与学习路径
  3. [01 - 斜杠命令 (Slash Commands)](#01 - 斜杠命令 (Slash Commands))
  4. [02 - 记忆系统 (Memory)](#02 - 记忆系统 (Memory))
  5. [03 - 技能 (Skills)](#03 - 技能 (Skills))
  6. [04 - 子代理 (Subagents)](#04 - 子代理 (Subagents))
  7. [05 - MCP (Model Context Protocol)](#05 - MCP (Model Context Protocol))
  8. [06 - 钩子 (Hooks)](#06 - 钩子 (Hooks))
  9. [07 - 插件 (Plugins)](#07 - 插件 (Plugins))
  10. [08 - 检查点 (Checkpoints)](#08 - 检查点 (Checkpoints))
  11. [09 - 高级功能 (Advanced Features)](#09 - 高级功能 (Advanced Features))
  12. [10 - CLI 命令行参考](#10 - CLI 命令行参考)
  13. 快速参考卡片
  14. 功能目录
  15. 常见用例与最佳实践

概述

Claude Code 是什么？

Claude Code 是 Anthropic 官方推出的 AI 编程助手命令行工具，它将 Claude AI 的能力直接集成到你的开发工作流程中。

本指南解决的问题

  • 官方文档描述了功能，但没告诉你如何组合它们
  • 没有清晰的学习路径
  • 示例太基础，无法帮助构建生产级工作流程

本指南提供的内容

官方文档 本指南
参考文档格式 可视化教程与 Mermaid 图表
功能描述 深入底层原理
基础示例片段 生产级可直接使用的模板
功能组织 渐进式学习路径（从入门到精通）
自我评估 交互式测验找出知识缺口

自我评估与学习路径

🧭 自我评估问题

请诚实回答以下问题：

  • 我能启动 Claude Code 并进行对话 (claude)
  • 我创建或编辑过 CLAUDE.md 文件
  • 我使用过至少 3 个内置斜杠命令（如 /help, /compact, /model)
  • 我创建过自定义斜杠命令或技能 (SKILL.md)
  • 我配置过 MCP 服务器（如 GitHub、数据库）
  • 我在 ~/.claude/settings.json 中设置过钩子
  • 我创建或使用过自定义子代理
  • 我使用过打印模式 (claude -p) 进行脚本或 CI/CD

你的水平定位

检查项数 水平 开始位置 完成时间
0-2 🟢 初学者 Milestone 1A ~3 小时
3-5 🔵 中级 Milestone 2A ~5 小时
6-8 🔴 高级 Milestone 3A ~5 小时

🗺️ 完整学习路径表

步骤 功能 难度 时间 级别
1 斜杠命令 ⭐ 初学者 30分钟 Level 1
2 记忆系统 ⭐⭐ 初学者+ 45分钟 Level 1
3 检查点 ⭐⭐ 中级 45分钟 Level 1
4 CLI 基础 ⭐⭐ 初学者+ 30分钟 Level 1
5 技能 ⭐⭐ 中级 1小时 Level 2
6 钩子 ⭐⭐ 中级 1小时 Level 2
7 MCP ⭐⭐⭐ 中级+ 1小时 Level 2
8 子代理 ⭐⭐⭐ 中级+ 1.5小时 Level 2
9 高级功能 ⭐⭐⭐⭐⭐ 高级 2-3小时 Level 3
10 插件 ⭐⭐⭐⭐ 高级 2小时 Level 3
11 CLI 精通 ⭐⭐⭐ 高级 1小时 Level 3

总学习时间：约 11-13 小时

01 - 斜杠命令 (Slash Commands)

概述

斜杠命令是用户可调用的快捷方式，用于执行常见工作流程。Claude Code 有 55+ 个内置命令，你也可以创建自定义命令。

常用内置命令

命令 功能 使用场景
/help 显示帮助信息 入门学习
/clear 清除对话历史 开始新对话
/compact 压缩对话历史 减少上下文
/model 切换模型 选择不同模型
/cost 显示成本统计 监控费用
/init 初始化项目配置 新项目设置
/plan 进入规划模式 复杂实现
/rewind 回退到检查点 撤销更改
/checkpoint 管理检查点 保存/恢复状态
/mcp 管理 MCP 服务器 外部集成
/agents 列出可用代理 查看委托选项
/skills 列出可用技能 查看自动调用能力
/hooks 列出已配置钩子 调试自动化
/memory 查看已加载记忆 调试上下文
/plugin 管理插件 安装/移除扩展
/config 查看/编辑配置 自定义行为
/status 显示会话状态 检查当前状态
/export 导出对话 保存参考
/feedback 提交反馈 报告问题
/login Anthropic 认证 访问功能
/vim 切换 vim 模式 Vim 风格编辑
/doctor 运行诊断 故障排查
/todo 查看/管理待办列表 任务追踪
/tasks 查看后台任务 监控异步操作
/fast 切换快速模式 加快响应
/branch 或 /fork 分支对话 探索替代方案
/btw <问题> 不计入历史的旁问 快速次要问题
/diff 交互式差异查看器 审查更改
/resume 恢复之前的会话 继续工作
/rename 重命名当前会话 组织会话
/usage 显示 API 使用统计 监控配额和费用

自定义斜杠命令

安装路径
复制代码 
.claude/commands/     # 项目级别（团队共享）
~/.claude/commands/   # 用户级别（个人使用）
安装示例命令
bash 复制代码 
# 创建命令目录
mkdir -p .claude/commands

# 安装所有自定义命令
cp 01-slash-commands/*.md .claude/commands/

# 安装单个命令
cp 01-slash-commands/optimize.md .claude/commands/
可用的示例命令
命令 描述 使用场景
/optimize 代码优化分析器 性能改进
/pr PR 准备 PR 工作流自动化
/generate-api-docs API 文档生成器 生成 API 文档
/commit 提交消息助手 标准化提交
/push-all 推送所有更改 快速推送工作流
/unit-test-expand 扩展单元测试覆盖 测试自动化
/doc-refactor 文档重构 文档改进
/setup-ci-cd CI/CD 管道设置 DevOps 自动化

02 - 记忆系统 (Memory)

概述

记忆系统让 Claude 能够在多个会话和对话之间保持上下文。它有两种形式：自动合成和基于文件的 CLAUDE.md。

记忆类型与位置

类型 作用范围 位置 共享 最佳用途
项目记忆 项目级别 ./CLAUDE.md 团队共享 项目标准、团队约定
目录记忆 特定目录 ./src/api/CLAUDE.md 团队共享 目录特定规则
个人记忆 用户级别 ~/.claude/CLAUDE.md 个人 个人偏好
企业记忆 组织范围 管理设置 组织共享 组织标准

记忆命令快速参考

命令 功能 使用场景
/init 初始化项目记忆 新项目、首次设置 CLAUDE.md
/memory 在编辑器中编辑记忆文件 大量更新、重新组织
# 规则内容 快速添加单行记忆 对话中快速添加规则
# new rule into memory 显式添加复杂规则 多行规则
# remember this 自然语言添加记忆 对话式更新
@path/to/file 导入外部文件内容 引用现有文档

快速记忆更新示例

复制代码 
# 在对话中快速添加规则：
# 此项目始终使用 TypeScript strict mode
# 优先使用 async/await 而非 promise chains
# 每次提交前运行 npm test
# 文件名使用 kebab-case

CLAUDE.md 示例模板

markdown 复制代码 
# 项目配置

## 项目概述
- 名称：Your Project
- 技术栈：TypeScript, React, Node.js
- 团队规模：5 人

## 开发标准
- 使用 ESLint 和 Prettier
- 测试覆盖率需 > 80%
- Git 工作流：feature branches
- 提交信息格式：conventional commits

## 重要文件
- 配置文件：`config/settings.yaml`
- 入口文件：`src/index.ts`

## 代码风格
- 优先使用函数式编程
- 避免深层嵌套
- 保持函数简短（< 50 行）

## 测试要求
- 所有新功能需要单元测试
- 关键路径需要集成测试

记忆系统架构

复制代码 
记忆加载优先级：
1. ~/.claude/CLAUDE.md       (个人记忆 - 最高优先级)
2. ./CLAUDE.md               (项目记忆)
3. ./src/api/CLAUDE.md       (目录记忆 - 最低优先级)

加载顺序：
→ 个人记忆先加载
→ 项目记忆追加
→ 目录记忆最后追加（针对特定目录）

03 - 技能 (Skills)

概述

技能是基于文件系统的可复用能力，扩展 Claude 的功能。它们打包了领域专业知识、工作流程和最佳实践。

技能类型与位置

类型 位置 作用范围 共享 最佳用途
企业技能 管理设置 组织范围 是 组织标准
个人技能 ~/.claude/skills/<name>/SKILL.md 个人 否 个人工作流
项目技能 .claude/skills/<name>/SKILL.md 项目 是 团队共享

技能工作原理：渐进式披露

复制代码 
加载级别：

Level 1: 元数据（始终加载）
├── YAML frontmatter
├── ~100 tokens/技能
└── name + description

Level 2: 指令（触发时加载）
├── SKILL.md 正文
├── < 5k tokens
└── 工作流程与指导

Level 3: 资源（按需加载）
├── 打包文件
├── 实际无限制
└── 脚本、模板、文档

技能结构示例

复制代码 
code-review/
├── SKILL.md              # 技能定义（YAML frontmatter + 正文）
├── scripts/
│   ├── analyze-metrics.py    # 代码分析脚本
│   └── compare-complexity.py # 复杂度比较
└── templates/
    ├── review-checklist.md   # 审查清单
    └── finding-template.md   # 发现模板

SKILL.md 文件格式

markdown 复制代码 
---
name: code-review
description: Comprehensive code review with security, performance, and quality analysis
trigger: When reviewing code
tools: Read, Grep, Glob
effort: high
---

# Code Review Skill

## Overview
This skill provides systematic code review capabilities...

## Workflow
1. Analyze code structure
2. Check security issues
3. Evaluate performance
4. Generate findings report

安装技能

bash 复制代码 
# 安装到用户级别
cp -r 03-skills/code-review ~/.claude/skills/

# 安装到项目级别
cp -r 03-skills/code-review .claude/skills/

内置打包技能（5 个）

技能 命令 功能
simplify /simplify 简化代码审查
loop /loop 循环执行任务
claude-api /claude-api Claude API 开发
usage-stats /usage-stats 使用统计分析
summarize /summarize 总结 URL/文件

示例技能

技能 描述 使用场景
code-review 代码质量综合审查 代码审查会话
brand-voice 确保一致的品牌语调 营销文案创作
doc-generator 从源码生成 API 文档 创建/更新 API 文档
refactor 系统化代码重构 重构代码
blog-draft 博客文章起草 写博客
claude-md 管理 CLAUDE.md 文件 记忆管理

04 - 子代理 (Subagents)

概述

子代理是专门的 AI 助手，Claude Code 可以将任务委托给它们。每个子代理使用独立的上下文窗口，可以配置特定工具和自定义系统提示。

内置子代理（6 个）

代理 描述 工具 模型 使用场景
general-purpose 多步骤任务、研究 所有工具 继承模型 复杂研究、多文件任务
Plan 实现规划 Read, Glob, Grep, Bash 继承模型 架构设计、规划
Explore 代码库探索 Read, Glob, Grep Haiku 4.5 快速搜索、理解代码
Bash 命令执行 Bash 继承模型 Git 操作、终端任务
statusline-setup 状态栏配置 Bash, Read, Write Sonnet 4.6 配置状态栏显示
Claude Code Guide 帮助和文档 Read, Glob, Grep Haiku 4.5 获取帮助、学习功能

子代理配置字段

字段 类型 描述
name string 代理标识符
description string 代理做什么
model string 模型覆盖（如 haiku-4.5）
tools array 允许的工具列表
disallowedTools array 明确禁止的工具
effort string 推理努力级别（low, medium, high）
initialPrompt string 代理启动时的系统提示
permissionMode string 权限模式
maxTurns number 限制代理轮次
skills array 预加载技能
mcpServers array 可用的 MCP 服务器
memory string 持久记忆范围
background boolean 作为后台任务运行
isolation string git worktree 隔离

文件位置

优先级 类型 位置 作用范围
1（最高） CLI 定义 通过 --agents 标志 仅会话
2 项目子代理 .claude/agents/ 当前项目
3 用户子代理 ~/.claude/agents/ 所有项目
4（最低） 插件代理 插件 agents/ 目录 通过插件

子代理文件格式

markdown 复制代码 
---
name: code-reviewer
description: Comprehensive code quality review
tools: Read, Grep, Glob, Bash
model: sonnet
effort: high
---

# Code Reviewer Agent

You are a specialized code reviewer. Your task is to:
1. Analyze code structure and patterns
2. Identify security vulnerabilities
3. Check performance issues
4. Ensure code follows best practices

Provide detailed findings with actionable recommendations.

安装自定义子代理

bash 复制代码 
# 安装所有
cp 04-subagents/*.md .claude/agents/

# 安装单个
cp 04-subagents/code-reviewer.md .claude/agents/

示例自定义子代理

代理 描述 使用场景
code-reviewer 代码质量综合审查 代码审查会话
code-architect 功能架构设计 新功能规划
code-explorer 深入代码库分析 理解现有功能
clean-code-reviewer Clean Code 原则审查 可维护性审查
test-engineer 测试策略与覆盖率 测试规划
documentation-writer 技术文档编写 API 文档、指南
secure-reviewer 安全审查 安全审计
implementation-agent 完整功能实现 功能开发
debugger 根因分析 Bug 调查
data-scientist SQL 查询、数据分析 数据任务

05 - MCP (Model Context Protocol)

概述

MCP 是一种标准化的方式，让 Claude 访问外部工具、API 和实时数据源。与记忆不同，MCP 提供对变化数据的实时访问。

MCP 架构

复制代码 
Claude → MCP 服务器 → 外部服务 → 数据返回

支持的传输协议：
├── HTTP（推荐）
├── Stdio（本地）
├── WebSocket
└── SSE（已弃用）

MCP 安装方法

HTTP 传输（推荐）
bash 复制代码 
# 基本 HTTP 连接
claude mcp add --transport http notion https://mcp.notion.com/mcp

# HTTP 带认证头
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"
Stdio 传输（本地）
bash 复制代码 
# 本地 Node.js 服务器
claude mcp add --transport stdio myserver -- npx @myorg/mcp-server

# 带环境变量
claude mcp add --transport stdio myserver --env KEY=value -- npx server
OAuth 2.0 认证
bash 复制代码 
# 连接 OAuth 服务器（交互式）
claude mcp add --transport http my-service https://my-service.example.com/mcp

# 预配置 OAuth
claude mcp add --transport http my-service https://my-service.example.com/mcp \
  --client-id "your-client-id" \
  --client-secret "your-client-secret" \
  --callback-port 8080

MCP 配置文件位置

复制代码 
.mcp.json           # 项目级别
~/.claude.json      # 用户级别

GitHub MCP 配置示例

json 复制代码 
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "your_token"
      }
    }
  }
}

使用 MCP 命令

复制代码 
/mcp__github__list_prs        # 列出 PR
/mcp__github__create_issue    # 创建 Issue
/mcp__github__get_file        # 获取文件内容

常用 MCP 服务器

服务器 功能
github GitHub PR、Issue 管理
postgres PostgreSQL 数据库
slack Slack 消息
filesystem 文件系统操作
google-docs Google Docs 访问
notion Notion 页面访问

06 - 钩子 (Hooks)

概述

钩子是在 Claude Code 会话期间响应特定事件而自动执行的脚本。它们支持自动化、验证、权限管理和自定义工作流程。

钩子类型（4 种）

类型 描述 使用场景
command 执行 shell 命令 文件格式化、安全扫描
prompt LLM 评估提示 任务完成检查
http HTTP webhook 远程通知
agent 子代理评估 复杂决策

钩子事件（25 种）

事件 描述
PreToolUse 工具执行前
PostToolUse 工具执行后
Notification 通知事件
Stop 任务停止时
PreCompact 压缩前
UserPromptSubmit 用户提交提示
PrePrompt 提示处理前
PostPrompt 提示处理后
SessionStart 会话开始
SessionEnd 会话结束
HookFailure 钩子失败

配置结构

json 复制代码 
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Write",
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/hooks/pre-tool-check.sh",
            "timeout": 60
          }
        ]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "prompt",
            "prompt": "检查文件是否遵循项目标准"
          }
        ]
      }
    ]
  }
}

配置文件位置

复制代码 
~/.claude/settings.json       # 用户设置（所有项目）
.claude/settings.json         # 项目设置（可共享，可提交）
.claude/settings.local.json   # 本地项目设置（不提交）

匹配器模式

模式 描述 示例
精确字符串 匹配特定工具 "Write"
正则模式 匹配多个工具 `"Edit
通配符 匹配所有工具 "*" 或 ""
MCP 工具 服务器和工具模式 "mcp__memory__.*"

示例钩子脚本

代码格式化钩子
bash 复制代码 
#!/bin/bash
# ~/.claude/hooks/format-code.sh

# 读取 JSON 输入
input=$(cat)
file_path=$(echo "$input" | jq -r '.tool_input.file_path')

# 如果是 JS/TS 文件，运行 prettier
if [[ "$file_path" =~ \.(js|ts|jsx|tsx)$ ]]; then
  prettier --write "$file_path"
fi

# 返回成功
exit 0
安全扫描钩子
bash 复制代码 
#!/bin/bash
# ~/.claude/hooks/security-scan.sh

input=$(cat)
file_path=$(echo "$input" | jq -r '.tool_input.file_path')

# 运行安全扫描
if command -v semgrep &> /dev/null; then
  semgrep --config=auto "$file_path" --quiet
fi

exit 0

安装钩子

bash 复制代码 
mkdir -p ~/.claude/hooks
cp 06-hooks/*.sh ~/.claude/hooks/
chmod +x ~/.claude/hooks/*.sh

07 - 插件 (Plugins)

概述

插件是将多个 Claude Code 功能打包成完整、可安装包的捆绑集合。它们是最高级别的扩展机制。

插件架构

复制代码 
插件组成：
├── 斜杠命令
├── 子代理
├── MCP 服务器
├── 钩子
├── 配置

插件结构示例

复制代码 
my-plugin/
├── .claude-plugin/
│   └── plugin.json          # manifest（名称、描述、版本、作者）
├── commands/                # 技能 Markdown 文件
│   ├── task-1.md
│   └── workflows/
├── agents/                  # 自定义代理定义
│   ├── specialist-1.md
│   └── configs/
├── skills/                  # 技能 SKILL.md 文件
│   ├── skill-1.md
│   └── skill-2.md
├── hooks/
│   └── hooks.json           # 事件处理器
├── .mcp.json                # MCP 服务器配置
├── .lsp.json                # LSP 服务器配置
├── settings.json            # 默认设置
├── templates/
├── scripts/
├── docs/
└── tests/

插件 manifest 示例

json 复制代码 
{
  "name": "my-first-plugin",
  "description": "A greeting plugin",
  "version": "1.0.0",
  "author": {
    "name": "Your Name"
  },
  "homepage": "https://example.com",
  "repository": "https://github.com/user/repo",
  "license": "MIT"
}

插件类型与分发

类型 作用范围 共享 来源
官方 全局 所有用户 Anthropic
社区 公开 所有用户 社区
组织 内部 团队成员 公司
个人 个人 单用户 开发者

安装插件

复制代码 
# 在 Claude Code 中：
/plugin install pr-review
/plugin install devops-automation
/plugin install documentation

# 通过 CLI：
claude plugin install my-plugin

示例插件

插件 描述 包含功能
pr-review PR 审查自动化 命令 + 代理 + MCP
devops-automation DevOps 管道自动化 命令 + 钩子 + MCP
documentation 文档生成 技能 + 代理 + 命令

08 - 检查点 (Checkpoints)

概述

检查点允许你保存对话状态并回退到之前的点。这对于探索不同方法、从错误恢复或比较替代方案非常有价值。

检查点包含的内容

  • 所有交换的消息
  • 文件修改
  • 工具使用历史
  • 会话上下文

访问检查点

键盘快捷键： 按 Esc 两次（Esc + Esc）

斜杠命令：

复制代码 
/rewind
/checkpoint

回退选项

选项 描述
恢复代码和对话 恢复文件和消息到该检查点
仅恢复对话 只回退消息，保留当前代码
仅恢复代码 只恢复文件更改，保留完整对话历史
从此处总结 将对话压缩为 AI 生成的摘要
取消 返回当前状态

自动检查点

  • 每个用户提示都会创建检查点
  • 检查点跨会话持久化
  • 30天后自动清理

使用场景

场景 工作流程
探索方法 保存 → 尝试 A → 保存 → 回退 → 尝试 B → 比较
安全重构 保存 → 重构 → 测试 → 失败则回退
A/B 测试 保存 → 设计 A → 保存 → 回退 → 设计 B → 比较
错误恢复 发现问题 → 回退到最后良好状态

实际示例

复制代码 
场景：探索不同缓存方案

1. 用户：添加缓存层到 API
2. Claude：添加 Redis 缓存... [在检查点 A 修改]
3. 用户：实际上，尝试内存缓存
4. 用户按 Esc+Esc，回退到检查点 A
5. Claude：实现内存缓存 [在检查点 B 修改]
6. 用户：现在可以比较两种方案

09 - 高级功能 (Advanced Features)

规划模式 (Planning Mode)

规划模式是一种两阶段方法：先分析任务并创建详细实现计划，批准后执行。

激活方式：

复制代码 
/plan 实现用户认证系统

# 或 CLI 标志：
claude --permission-mode plan

适用场景：

  • ✅ 复杂多文件重构
  • ✅ 新功能实现
  • ✅ 架构变更
  • ✅ 数据库迁移
  • ❌ 简单 bug 修复
  • ❌ 格式化更改

扩展思考 (Extended Thinking)

按 Alt+T（Mac 上 Option+T）切换扩展思考模式，获得更深入的分析。

权限模式（6 种）

模式 描述 使用场景
default 每个工具调用提示确认 标准交互使用
acceptEdits 自动接受文件编辑 信任编辑工作流
plan 只读工具，不写入 规划和探索
auto 自动接受所有工具 完全自主操作（研究预览）
dontAsk 跳过需要权限的工具 非交互脚本
bypassPermissions 跳过所有权限检查 CI/CD、无头环境

使用方式：

bash 复制代码 
claude --permission-mode plan "分析代码库"
claude --permission-mode acceptEdits "重构认证模块"
claude --permission-mode auto "实现功能"

后台任务

在后台运行长操作而不阻塞对话。

bash 复制代码 
# 循环任务
/loop 5m /check-status

# 或创建持久定时任务

自动记忆

Claude 自动学习你的偏好并保存到记忆系统。

通道 (Channels)

用于组织跨会话的结构化工作流程。

bash 复制代码 
claude --channels discord,telegram

语音输入

支持 20 种语言的语音转文字输入。

远程控制

从 claude.ai 或 Claude app 控制 Claude Code。

bash 复制代码 
claude --remote-control
# 或
claude --rc

Web 会话

在浏览器中运行 Claude Code：claude.ai/code

bash 复制代码 
claude --remote "implement API"

桌面应用

独立的桌面应用，用于可视化差异审查和多会话管理。

Git Worktrees

隔离的 worktree 分支用于并行工作。

bash 复制代码 
claude -w

Agent Teams（实验性）

bash 复制代码 
export CLAUDE_AGENT_TEAMS=1
# 请求：使用团队方法实现功能 X

10 - CLI 命令行参考

CLI 命令

命令 描述 示例
claude 启动交互 REPL claude
claude "query" 带初始提示启动 claude "explain this project"
claude -p "query" 打印模式 claude -p "explain this function"
`cat file claude -p "query"` 管道处理
claude -c 继续最近对话 claude -c
claude -r "session" 按名称恢复会话 claude -r "auth-refactor"
claude update 更新到最新版本 claude update
claude mcp 配置 MCP 服务器 claude mcp add github
claude agents 列出所有代理 claude agents
claude auth login 登录 claude auth login
claude auth status 检查认证状态 claude auth status

核心标志

标志 描述 示例
-p, --print 打印模式（非交互） claude -p "query"
-c, --continue 继续最近对话 claude --continue
-r, --resume 恢复特定会话 claude --resume auth-refactor
-v, --version 输出版本号 claude -v
-w, --worktree git worktree 模式 claude -w
-n, --name 会话显示名称 claude -n "auth-refactor"
--permission-mode 权限模式 claude --permission-mode plan
--effort 思考努力级别 claude --effort high
--output-format 输出格式 claude -p --output-format json
--max-turns 限制轮次 claude -p --max-turns 3
--bare 最小模式 claude --bare
--remote 创建 web 会话 claude --remote "implement API"

交互模式 vs 打印模式

特性 交互模式 打印模式
命令 claude claude -p
输入 多轮对话 单次查询
输出 REPL 交互 直接输出
会话保存 是 否（除非指定）
检查点 是 否
使用场景 开发工作流 CI/CD、脚本

CI/CD 集成示例

bash 复制代码 
# 代码审查自动化
claude -p "审查代码变更并生成报告"

# JSON 输出用于脚本处理
claude -p --output-format json "审查代码" | jq '.issues'

# 限制轮次
claude -p --max-turns 3 "审查代码"

# 批量处理
for file in *.md; do
  claude -p "总结：$(cat $file)" > ${file%.md}.summary.txt
done

GitHub Actions 示例

yaml 复制代码 
name: AI Code Review
on: [pull_request]
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Run Claude Review
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          claude -p --output-format json "审查 PR 变更" > review.json

快速参考卡片

安装快速命令

bash 复制代码 
# 斜杠命令
cp 01-slash-commands/*.md .claude/commands/

# 记忆
cp 02-memory/project-CLAUDE.md ./CLAUDE.md

# 技能
cp -r 03-skills/code-review ~/.claude/skills/

# 子代理
cp 04-subagents/*.md .claude/agents/

# MCP
cp 05-mcp/github-mcp.json .mcp.json

# 钩子
mkdir -p ~/.claude/hooks
cp 06-hooks/*.sh ~/.claude/hooks/
chmod +x ~/.claude/hooks/*.sh

功能速查表

功能 安装路径 使用方式
斜杠命令（55+） .claude/commands/*.md /command-name
记忆 ./CLAUDE.md 自动加载
技能 .claude/skills/*/SKILL.md 自动触发
子代理 .claude/agents/*.md 自动委托
MCP .mcp.json 或 ~/.claude.json /mcp__server__action
钩子（25 事件） ~/.claude/hooks/*.sh 事件触发（4 类型）
插件 通过 /plugin install 捆绑所有
检查点 内置 Esc+Esc 或 /rewind
规划模式 内置 /plan <task>
权限模式（6 种） 内置 --permission-mode

功能目录

功能统计

功能 内置 示例 总计
斜杠命令 55+ 8 63+
子代理 6 10 16
技能 5 打包 6 11
插件 - 3 3
MCP 服务器 1 8 9
钩子 25 事件 7 7
记忆 7 类型 3 3
总计 99 43 117

常见用例与最佳实践

代码审查

复制代码 
方法 1：斜杠命令
cp 01-slash-commands/optimize.md .claude/commands/
# 使用：/optimize

方法 2：子代理
cp 04-subagents/code-reviewer.md .claude/agents/
# 使用：自动委托

方法 3：技能
cp -r 03-skills/code-review ~/.claude/skills/
# 使用：自动触发

方法 4：插件（最佳）
/plugin install pr-review
# 使用：/review-pr

文档生成

复制代码 
# 斜杠命令
cp 01-slash-commands/generate-api-docs.md .claude/commands/

# 子代理
cp 04-subagents/documentation-writer.md .claude/agents/

# 技能
cp -r 03-skills/doc-generator ~/.claude/skills/

# 插件（完整方案）
/plugin install documentation

CI/CD 自动化

复制代码 
# CLI 参考 + 钩子 + 后台任务

# 代码审查脚本
claude -p --output-format json "审查代码"

# 预提交钩子
cp 06-hooks/pre-commit.sh ~/.claude/hooks/

团队入职

复制代码 
# 记忆 + 斜杠命令 + 插件

# 项目记忆
cp 02-memory/project-CLAUDE.md ./CLAUDE.md

# 共享命令
cp 01-slash-commands/*.md .claude/commands/

学习技巧

✅ 建议

  • 先做自我评估确定起点
  • 每个里程碑完成实践练习
  • 从简单开始，逐步增加复杂度
  • 使用检查点安全实验
  • 与团队分享知识
  • 测试每个功能后再进入下一阶段

❌ 避免

  • 跳过前置知识检查
  • 一次学习所有内容
  • 不实践就继续下一阶段
  • 忽略与工作流程相关的内容

测试知识

使用交互式测验：

复制代码 
# 自我评估
/self-assessment

# 特定课程测验
/lesson-quiz hooks
/lesson-quiz 03      # 技能测验
/lesson-quiz advanced-features

快速入门路径

只有 15 分钟？

bash 复制代码 
# 1. 复制一个斜杠命令
mkdir -p .claude/commands
cp 01-slash-commands/optimize.md .claude/commands/

# 2. 在 Claude Code 中试用
/optimize

有 1 小时？

bash 复制代码 
# 斜杠命令（15分钟）
cp 01-slash-commands/*.md .claude/commands/

# 项目记忆（15分钟）
cp 02-memory/project-CLAUDE.md ./CLAUDE.md

# 安装技能（15分钟）
cp -r 03-skills/code-review ~/.claude/skills/

# 一起试用（15分钟）

有一个周末？

周六上午（3小时）：

  • 完成斜杠命令 + 记忆系统
  • 完成检查点 + CLI 基础

周六下午（3小时）：

  • 完成技能 + 钩子
  • 完成 MCP + 子代理

周日（4小时）：

  • 完成高级功能
  • 完成插件 + CI/CD
  • 为团队创建自定义插件

参考资源

相关推荐
一颗小行星2 小时前
Harness Engineering 前端开发的下一个阶段
前端·ai编程
第一程序员2 小时前
Python与容器化：Docker和Kubernetes实战
python·github
门豪杰2 小时前
Claude Code 权限系统实践指南
claude·claude code·claude-code
JaydenAI2 小时前
[RAG在LangChain中的实现-04]常用的向量存储和基于向量存储的检索器
python·langchain·ai编程
Roselind_Yi2 小时前
【吴恩达2026 Agentic AI】面试向+项目实战（含面试题+项目案例）-1
人工智能·python·面试·职场和发展·langchain·gpt-3·agent
踩着两条虫2 小时前
重磅！这款AI低代码平台火了：拖拽生成应用，一键输出Web/H5/UniApp
前端·低代码·ai编程
Alan GEO实施教练3 小时前
专利申请是否找代理机构：核心考量与决策逻辑拆解
大数据·人工智能·python
oyguyteggytrrwwwrt3 小时前
抄写YOLOE源码——先抄写ultralytics包，关于__init__.py
开发语言·python
超爱柠檬3 小时前
Skill—— AI 能力封装与复用
openai·ai编程
热门推荐
012026年3月AI领域大事件：DeepSeek引领开源风暴02GitHub 镜像站点03围棋-html版本04纯 HTML/CSS/JS 实现的高颜值登录页，还会眨眼睛！少女心爆棚！05班级宠物园部署指南06OpenClaw 使用和管理 MCP 完全指南07安娜的档案(Anna’s Archive) 镜像网站/国内最新可访问入口（持续更新）08Mac 本地部署 OMLX + 通义千问 Qwen3.5-27B 保姆级教程09“wsl --install -d Ubuntu-22.04”下载慢，中国地区离线安装 Ubuntu 22.04 WSL方法（亲测2025年5月6日）10UV安装并设置国内源