Claude Code使用介绍

Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手，直接运行在终端里，能读写本地文件、执行 Shell 命令、操作 Git，并通过 MCP 协议对接外部服务。本文分四个部分递进介绍。

命令速查

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
Shift+Tab      切换工作模式（默认 / 自动 / 规划）
Ctrl+B         将任务推送到后台执行
Esc Esc        快速触发 Rewind

/plan          进入规划模式
/rewind        版本回滚
/resume        恢复历史会话
/compact       压缩上下文
/clear         清空上下文
/init          生成 CLAUDE.md
/hooks         配置 Hook 规则
/agent         唤起 SubAgent
/mcp           查看已安装的 MCP 工具
/tasks         查看后台任务状态
! <command>    执行 Shell 命令并将输出反馈给 Claude
1
2
3
4
claude --dangerously-skip-permissions   # 跳过所有权限确认（慎用）
claude --resume                         # 恢复上次会话
claude -p "任务描述"                     # 单次非交互模式
claude mcp add <name> <command>         # 添加 MCP Server

第一部分：三种模式

通过 Shift + Tab 循环切换三种工作模式：

模式 特点
默认模式 自主决策、边思考边执行，遇到写操作会提示确认
自动模式 跳过大部分确认，适合任务明确、范围可控的场景
规划模式 只输出执行计划，不实际操作，确认后再动手

建议： 不确定改动范围时先用规划模式出方案，确认无误再切回默认执行。

第二部分：复杂任务处理与终端控制

执行终端命令

在对话中用 ! 前缀直接执行 Shell 命令，Claude 能读到输出并基于结果继续推理：

1
2
! git log --oneline -10
! npm test

Claude 也可以主动调用 Bash 工具执行命令，每次执行前会显示具体命令内容，可选择允许或拒绝。

后台任务管理

Ctrl + B 将当前任务推到后台执行，主会话可以继续处理其他问题，互不阻塞。

用 /tasks 查看和管理所有后台任务的运行状态。

跳过所有权限检测

1
claude --dangerously-skip-permissions

Claude 将无需确认直接执行任何操作（包括删除文件、运行任意命令）。仅在本地开发、完全可控的环境下使用。

第三部分：多模态与上下文管理

版本回滚 (Rewind)

Claude Code 在每次写操作前都会保存快照，修改不满意时可以直接回滚：

1
/rewind

或连按两下 Esc，选择要回退的节点即可。相当于内置了一个针对 AI 操作的撤销栈。

图片处理

在终端中直接粘贴截图，或提供图片路径，Claude 会理解图片内容并结合上下文作出回应。常见用途：粘贴报错截图定位问题、粘贴 UI 稿生成对应组件代码。

安装 MCP Server（以 Figma 为例）

MCP（Model Context Protocol）是 Claude Code 对接外部服务的标准协议。

安装 Figma MCP：

  1. 在 Figma → Settings → Personal access tokens 获取 Token

  2. 添加 MCP 配置：

1
claude mcp add figma-developer-mcp --env FIGMA_API_KEY=your_token_here
  1. 用 /mcp 验证，看到 figma-developer-mcp 出现即为成功。

也可以手动编辑 ~/.claude/mcp.json：

1
2
3
4
5
6
7
8
9
10
11
{
  "mcpServers": {
    "figma": {
      "command": "npx",
      "args": ["-y", "figma-developer-mcp"],
      "env": {
        "FIGMA_API_KEY": "your_token_here"
      }
    }
  }
}

使用 MCP 还原设计稿： 安装后直接把 Figma 链接扔给 Claude，指定目标 Frame 和技术栈，Claude 会通过 MCP 拉取节点数据（颜色、字体、间距、布局）生成组件代码，精度比截图更高。

恢复历史会话 (Resume)

1
claude --resume          # 启动时直接选择历史会话

或在会话中：

1
/resume

弹出最近会话列表，选择后上下文完整恢复。适合跨设备继续任务、或 /clear 后想回到某个历史节点。

上下文压缩与清除

命令 效果 适用场景
/compact 将历史总结为精简描述，释放 Token 空间 同一任务上下文变乱、任务切换前
/clear 完全清空对话历史 开始全新不相关的任务

项目记忆文件 (CLAUDE.md)

CLAUDE.md 放在项目根目录，每次启动 Claude Code 自动读取，相当于给 Claude 的项目说明书。用 /init 让 Claude 自动分析项目结构生成初稿。

建议写入：项目简介、常用命令、代码规范、需要注意的禁区。

CLAUDE.md 是项目级共享配置，适合提交到 git；用户个人偏好存在 ~/.claude/，本地私有。

第四部分：高级功能扩展与定制

Hook

Hook 在 Claude Code 生命周期的特定节点自动执行 Shell 命令，由系统触发，无需 AI 介入。

用 /hooks 打开图形化配置界面，也可以直接编辑配置文件。

配置位置： .claude/settings.json 或 ~/.claude/settings.json

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [{ "type": "command", "command": "prettier --write \"$CLAUDE_TOOL_INPUT_FILE_PATH\"" }]
      }
    ],
    "Stop": [
      {
        "hooks": [{ "type": "command", "command": "osascript -e 'display notification \"Claude 已完成\" with title \"Claude Code\"'" }]
      }
    ]
  }
}

支持的节点：

节点 触发时机
PreToolUse 工具调用之前
PostToolUse 工具调用之后
Stop Claude 停止输出后
SubagentStop 子 Agent 完成后

Agent Skill

Skill 是可复用的自定义子流程，输入 /<skill-name> 触发，Claude 按 Skill 定义的步骤执行。

内置 Skill： /init、/review、/security-review、/simplify

自定义 Skill： 在 .claude/commands/ 下创建 Markdown 文件：

1
2
3
4
5
6
<!-- .claude/commands/release.md -->
# Release 发布流程
1. 运行 `npm test`，确保全部通过
2. 更新 CHANGELOG.md
3. 修改 package.json 版本号（询问用户确认）
4. 提交 commit 并打 tag，推送到远端

之后输入 /release 即可触发完整流程。

SubAgent

SubAgent 是主 Agent 动态派发的独立子任务执行单元，拥有完全隔离的上下文。输入 /agent 手动唤起。

内置类型：

类型 能力
Explore 只读，专门搜索代码、查找文件
Plan 只规划不执行，输出实现方案
general-purpose 通用，拥有完整工具权限

适合并行处理多个独立子任务，或防止单一长任务把主会话上下文撑爆。

Skill 与 SubAgent 的区别

Skill SubAgent
触发方式 用户主动输入 /<name> 主 Agent 自动派发
本质 prompt 模板 + 执行步骤 独立运行的子 Agent 实例
上下文 共享主会话 完全隔离
适合场景 固定流程的重复操作 并行任务、上下文隔离
  • Skill：告诉 Claude 按这个流程做事
  • SubAgent：派一个独立的 Claude 去做这件事

Plugin

Plugin 是比 MCP 更轻量的扩展方式，无需搭建独立进程，直接在 .claude/settings.json 的 plugins 字段配置，适合注入公司内部系统查询、项目特有代码生成等轻量自定义工具。