Claude Code导览

3 阅读3分钟

Claude Code: 一个可编程、可扩展、可组合的AI Agent框架。

它不只是一个“工具”,而是一个“平台”——你可以在上面构建自己的AI工作流。

Claude Code类似的平替工具:

image.png

Claude Code最基本的命令行交互方式:

image.png

Claude Code的底层能力从技术上拆解可以分为四个层次:基础层、扩展层、集成层、编程接口层。

image.png

基础层:Memory(记忆系统)

Claude Code长期记忆系统的核心文件是CLAUDE.md,它是一个项目或者一个系统的“新员工手册”。

Claude Code拥有全局、项目、项目特定模块都可以拥有的自身的记忆文件。

~/.claude/CLAUDE.md           # 全局(所有项目共用)
    ↓
项目根目录/CLAUDE.md          # 项目级(当前项目)
    ↓
项目根目录/.claude/rules/*.md # 模块级(特定目录)

扩展层:四大核心组件

Claude Code的能力中心,包括Commands(斜杠命令)、Skills(技能)、SubAgents(子代理)、Hooks(钩子)四个核心组件。

  • Commands:适合标准化操作,由用户自定义的一系列核心能力,触发方式用户手动输入。
  • Skills:代表AI的一系列专属能力组合,其触发方式是Claude自动判断,也可以用户自己设定。当一个能力具备强烈的“领域感”(性能、容错性、扩展性),判断依赖上下文而非关键词,执行路径可能变化时,就用Skill,而不是Command。
  • SubAgents:适合独立完成专项任务,隔离执行,比如:高噪声任务或者需要特定权限的任务。触发方式可以由Claude决定或者用户指定。
  • Hooks:适合自动化检查,在特定事件触发时自动执行的脚本,其触发方式是事件自动触发。比如:格式化、日志记录等。

触发方式汇总如下:

image.png

集成层:连接外部世界

集成层包括:Headless(无头模式)和MCP(Model Context Protocol)两大技术。

  • Headless:Claude Code在无人工交互的情况下运行,适合CI/CD集成如:自动代码审查、自动修复bug、自动生成变更日志等等。
# 场景:快速根据获取一个Git Commit Message建议
claude -p "Stage我的修改,然后生成一条符合Conventional Commit规范的Message" --allowedTools "Bash,Read" --permission-mode acceptEdits
  • MCP:连接外部工具和服务,适合工具连接——可以把任何外部系统变成Claude可调用的工具。

编程接口层:Agent SDK

当配置式的扩展不够用时,用代码驱动Claude。构建自定义Agent:完全控制执行流程,自定义工具,复杂工作流。

from claude_sdk import ClaudeSDKClient

client = ClaudeSDKClient()

# 执行任务
result = client.query(
    prompt="Review this code for security issues",
    tools=["Read", "Grep"],
    max_turns=10
)

Claude Code的数据流

image.png

Memory是基础设施,始终存在,初始化加载;扩展层是能力中心,可以按需配置激活;Hooks是守门人,监控流程自动触发。

Plugins:打包容器

把你的经验沉淀为一套好用的SubAgents、Commands、Skills、Hooks组合,分享给团队或者社区时,就需要Plugins。

Plugins是一种打包机制,能够把一组相关的Claude Code扩展打包在一起,进行可复用、可版本化、可分发。

my-team-plugin/
├── commands/           # 斜杠命令
│   └── review.md
├── skills/             # 技能
│   └── security-check/
│       └── SKILL.md
├── agents/             # 子代理
│   └── test-runner.md
├── hooks/              # 钩子
│   └── pre-edit.sh
└── plugin.json         # 插件配置