目录

• 1. 基础交互
  • 1.1 三种模式详解（默认/自动/规划）
• 2. 复杂任务处理与终端控制
  • 2.1 执行终端命令（Bash）
  • 2.2 跳过所有权限检测
  • 2.3 后台任务管理
• 3. 多模态与上下文管理
  • 3.1 版本回滚
  • 3.2 图片处理
  • 3.3 恢复历史会话（Resume）
  • 3.4 上下文压缩与清除
  • 3.5 项目记忆文件（CLAUDE.md）
• 4. 高级功能扩展与定制
  • 4.1 Hooks
  • 4.2 Agent Skill
  • 4.3 SubAgent
  • 4.4 Skill 与 SubAgent 的区别
  • 4.5 MCP Server
  • 4.6 Plugin

1. 基础交互

1. 三种模式详解（默认/自动/规划）

1. Normal Mode（默认模式）

• 特点：最安全；所有文件修改、命令执行都要你手动确认。
• 权限：读写文件 + 执行命令，但必须批准。
• 适用：日常开发、生产环境、学习阶段、不熟悉的项目。

2. Auto-accept Edits（自动接受编辑模式）

按 Shift+Tab 循环切换。在此模式下：

• Claude 编辑文件无需询问
• 仍会询问 shell 命令的权限
• 适用：信任 AI、简单重复任务、熟悉项目结构。

3. Plan Mode（计划模式）

• 特点：只规划、不修改、不执行；只输出方案、步骤、Diff 预览。
• 权限：仅读代码，无写 / 执行权限。
• 适用：复杂任务、架构设计、重构、多文件改动、风险评估。

一句话区别

• Normal：步步确认 → 最安全
• Auto：自动改代码 → 效率高
• Plan：只出方案 → 不碰代码

切换方式

使用 Shift+Tab 在三种模式间循环：

• 默认 → 自动接受编辑 → Plan Mode → 循环

这些模式帮助你在不同场景下控制 Claude 的行为，从完全自主到只读规划。

2. 复杂任务处理与终端控制

1. 执行终端命令（Bash）

在交互模式中，使用 ! 前缀可以直接运行 bash 命令:

! npm test
! git status
! ls -la

2. 跳过所有权限检测

警告：此选项会跳过安全检查，仅在完全信任的环境使用

claude --dangerously-skip-permissions

或在 headless 模式中：

claude -p "your prompt" --dangerously-skip-permissions

3. 后台任务管理

启动后台任务

有两种方式将任务放入后台运行：

1. 提示 Claude：直接要求 Claude “run this in the background”
2. 快捷键：按 Ctrl+B 将正在运行的任务移到后台（Tmux 用户需按两次）

管理后台任务：

使用 /tasks 命令列出并管理后台任务。

/tasks

后台任务工作原理

• 命令异步运行，立即返回后台任务 ID
• 输出被缓冲，Claude 可以使用 TaskOutput 工具检索
• 每个后台任务有唯一 ID 用于跟踪
• Claude Code 退出时，后台任务会自动清理

常见后台命令场景

• 构建工具（webpack、vite、make）
• 包管理器（npm、yarn、pnpm）
• 测试运行器（jest、pytest）
• 开发服务器
• 长时间运行的进程（docker、terraform）

3. 多模态与上下文管理

1. 版本回滚

使用 Rewind 功能

按 Esc + Esc（双击 Escape）或运行 /rewind 命令打开回滚菜单。

你可以选择恢复：

• 仅对话：回退到用户消息，同时保留代码更改
• 仅代码：恢复文件更改，同时保留对话
• 代码和对话：将两者都恢复到会话中的先前点

工作原理

• Claude 在每次编辑前自动创建 checkpoint
• 每个用户提示都会创建一个新的 checkpoint
• Checkpoints 在会话之间持久存在
• 30 天后自动清理（可配置）

限制

• Bash 命令更改未被跟踪：如 rm、mv、cp 等命令的修改无法回滚
• 外部更改未被跟踪：在 Claude Code 外部的手动更改不会被捕获
• 不是 Git 的替代品：仅用于快速的会话级恢复

2. 图片处理

添加图片到对话

有三种方式将图片添加到 Claude Code：

1. 拖放：将图片直接拖放到 Claude Code 窗口中
2. 粘贴：复制图片后使用 Ctrl+V 粘贴到 CLI 中（注意：不要使用 cmd+v）
3. 提供路径：直接告诉 Claude 图片路径，例如 “Analyze this image: /path/to/your/image.png”

提示

• 使用 Up/Left/Right 方向键在附件之间导航
• 使用 Backspace 或 Delete 删除选定的附件
• 使用 Down 或 Escape 退出附件栏
• 想要预览图片，可使用 VSCode插件: Claude Code for VS Code

3. 恢复历史会话（Resume）

恢复会话的所有方式

1. 命令行标志：

• claude --continue - 继续最近的对话
• claude --resume - 打开交互式选择器选择会话

2. 会话内命令：

• /resume - 在活动会话内切换到不同的对话

4. 上下文压缩与清除

手动压缩：

• 运行 /compact 手动压缩上下文
• 可添加自定义说明：/compact Focus on the API changes

自定义压缩行为：
在 CLAUDE.md 中添加指令，如：

# Summary instructions
When you are using compact, always preserve the full list of modified files and any test commands

上下文清除

• 使用 /clear 命令完全重置上下文窗口
• 建议在不相关的任务之间频繁使用 /clear

5. 项目记忆文件（CLAUDE.md）

生成 CLAUDE.md
运行 /init 命令可以根据当前项目结构自动生成一个启动 CLAUDE.md 文件：

> /init

CLAUDE.md 是什么
CLAUDE.md 是一个特殊的 markdown 文件，Claude 在每次对话开始时都会读取。它用于存储：

• Bash 命令（构建、测试、lint）
• 代码风格和命名约定
• 工作流规则
• 项目特定的架构决策
• Claude 无法从代码中推断出来的持久上下文

CLAUDE.md 文件位置

位置	用途
~/.claude/CLAUDE.md	适用于所有 Claude 会话的个人偏好
./CLAUDE.md 或 ./.claude/CLAUDE.md	项目根目录，与团队共享
./CLAUDE.local.md	个人的项目特定偏好（不签入版本控制）
子目录	当处理这些目录中的文件时按需加载

4. 高级功能扩展与定制

1. Hooks

Hooks 是用户定义的 shell 命令，在 Claude Code 生命周期的各个点执行。它们提供对 Claude Code 行为的确定性控制，确保某些操作总是发生，而不是依赖 LLM 选择运行它们。

配置方式

运行 /hooks 命令进行交互式配置，或直接编辑 .claude/settings.json。

主要用例

• 通知：自定义当 Claude 等待输入时如何获得通知
• 自动格式化：在每次文件编辑后运行 prettier、gofmt 等
• 日志记录：跟踪所有执行的命令
• 反馈：当代码不遵循约定时提供自动反馈
• 自定义权限：阻止对敏感文件的修改

2. Agent Skill

Skills 是可重用的知识、工作流和说明，可以扩展 Claude 的功能。Claude 可以在相关时自动加载它们，或者你可以使用 /skill-name 直接调用

查看skill：

> /skills

3. SubAgent

Subagents 是在隔离上下文中运行的专门 AI 助手，完成任务后返回摘要结果。它们不会使你的主对话变得混乱。

创建 Subagent

1. 使用 /agents 命令 - 查看所有可用的 subagents 并可以创建新的：

> /agents

然后选择 “Create New subagent” 并按照提示定义。

2. 手动创建文件 -在以下位置创建 Markdown 文件：

• 用户级别：~/.claude/agents/ - 所有项目可用
• 项目级别：.claude/agents/ - 特定于项目，可与团队共享

3. 让 Claude 帮你创建 - 你可以直接要求 Claude：

> 帮我创建一个安全审查的 subagent

Subagent 文件格式

---
name: security-reviewer
description: Reviews code for security vulnerabilities
tools: Read, Grep, Glob, Bash
model: opus
---
You are a senior security engineer. Review code for:
- Injection vulnerabilities
- Authentication flaws
- Secrets in code

使用 Subagent
明确告诉 Claude 使用 subagent：

使用 subagent 审查此代码以查找安全问题

或运行 /agents 查看所有可用的 subagents。

4. Skill 与 SubAgent 的区别

• Skills 是可重用的内容，可以加载到任何上下文中（如 API 风格指南、部署工作流）
• Subagents 是与主对话分开运行的隔离工作者，完成后返回摘要

一句话选择指南

• 要单步能力、复用、可控 → 用 Skill。
• 要独立推理、上下文隔离、并行、复杂子任务 → 用 Subagent。

5. 安装 MCP Server

配置步骤

1. 添加 server：使用 claude mcp add 命令连接外部工具（如 Figma、Notion 或数据库）

运行以下命令添加 MCP server：

#github代码协作：创建PR、管理Issues、触发CI/CD
claude mcp add github --scope user -- npx -y @modelcontextprotocol/server-github

#将复杂任务分解为多个步骤
claude mcp add sequential-thinking --scope user -- npx -y @modelcontextprotocol/server-sequential-thinking

#获取实时的官方技术文档
claude mcp add context7 --scope user -- npx -y context7-mcp
#查询 TypeScript 5.0 的新功能

#自动化测试、网页截图、爬虫
claude mcp add playwright --scope user -- npx -y @playwright/mcp
#用 playwright 打开 https://example.com 并截图

2. 身份验证：某些 servers 需要身份验证。在终端运行 claude，然后输入 /mcp 进行身份验证
3. 使用工具：配置后，直接要求 Claude 使用这些工具

6. Plugin

Plugins 是可重用的包，为 Claude Code 添加 skills、agents、hooks、MCP servers 和LSP 配置。它们可以在项目和团队中共享。

主要特点

• Skills：自定义命令和工作流
• Agents：专门的 AI 助手
• Hooks：事件处理程序（如文件保存后自动运行 lint）
• MCP servers：外部工具集成
• LSP servers：代码智能（语法检查、自动完成等）

安装 Plugin

运行以下命令添加插件市场

# 官方市场，默认启用、自动更新
/plugin marketplace add anthropics/claude-plugins-official

# 官方演示市场
/plugin marketplace add anthropics/claude-code

# Anthropic技能包
/plugin marketplace add anthropics/skills

🍌提示:
- 如果你想在终端里干活，去关注 claude-code
- 如果你想学习如何教 Claude 掌握某种特定工作流（并在任何地方复用），参考 skills；
- 如果你想看看有哪些现成的扩展可以增强你的 Claude Code（比如连通 Slack 或 Jira），去逛 claude-plugins-official。

添加完插件市场后，使用以下步骤安装对应插件：

1. 运行 /plugin 命令打开插件对话框
2. 浏览可用插件或搜索
3. 点击 安装 并选择范围：

• 为您安装：所有项目可用
• 为此项目安装：与团队共享
• 本地安装：仅此仓库

创建 Plugin
在目录中创建 .claude-plugin/plugin.json：

{
  "name": "my-plugin",
  "description": "我的自定义插件",
  "version": "1.0.0"
}

然后添加 commands/、agents/、skills/、hooks/ 等目录。