Claude Code导览

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

它不只是一个"工具"，而是一个"平台"------你可以在上面构建自己的AI工作流。

Claude Code类似的平替工具：

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

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

基础层：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：适合自动化检查，在特定事件触发时自动执行的脚本，其触发方式是事件自动触发。比如：格式化、日志记录等。

触发方式汇总如下：

集成层：连接外部世界

集成层包括：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的数据流

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         # 插件配置