Claude Code 项目介绍
Claude Code 项目介绍
项目定位
Claude Code 是 Anthropic 开发的 agentic 编程助手,驻留在你的终端中,理解你的代码库,通过自然语言命令帮助开发者更快编码。它不仅能执行日常任务,还能解释复杂代码、处理 git 工作流,并通过插件系统扩展为功能强大的开发平台。
核心能力
- 自然语言编程:在终端中用自然语言与 Claude 对话,完成代码生成、重构、调试等任务
- 插件系统:通过
.claude-plugin目录约定的插件机制,扩展命令、Agent、Skill 和 Hook - Hook 安全机制:支持 PreToolUse、PostToolUse、Stop、UserPromptSubmit 等多种事件钩子,可在工具执行前拦截和验证
- 多 Agent 编排:支持并行启动专业化 Agent(代码审查、架构设计、安全扫描等)进行协作分析
- Skill 系统:渐进式披露的技能机制,SKILL.md 为核心指令,references/ 为深度文档,examples/ 为工作示例
- 企业级部署:支持 MDM(Jamf/Kandji/Intune/Group Policy)集中管理设置,以及沙箱隔离运行
- Claude Agent SDK:提供 TypeScript 和 Python 两种语言的 SDK,允许开发者基于 Claude 构建自定义 Agent 应用
技术栈
| 维度 | 技术选择 |
|---|---|
| 运行时 | Node.js 18+ |
| 安装方式 | 原生安装(curl/brew/winget),npm 安装已弃用 |
| 界面 | TUI(终端) + IDE 集成(VS Code/JetBrains) + GitHub @claude |
| 插件语言 | Markdown(命令、Agent 定义) + Python(Hook 脚本) + JSON(配置) |
| Agent SDK | TypeScript(@anthropic-ai/claude-agent-sdk)+ Python(claude-agent-sdk) |
架构概览
仓库说明
重要:此 GitHub 仓库不包含 Claude Code CLI 的源代码。CLI 本身是闭源的。该仓库包含:
| 目录 | 内容 |
|---|---|
plugins/ | 14 个官方插件,涵盖代码审查、功能开发、前端设计、安全、插件开发等 |
examples/ | 设置、Hook 和 MDM 部署示例配置 |
scripts/ | GitHub issue 自动化脚本(去重、评论、生命周期管理) |
.claude/commands/ | 内置的 git issue 命令 |
CHANGELOG.md | 版本更新日志(当前最新:v2.1.150) |
本教程以该仓库中的官方插件、示例和配置为主要分析对象,从中提取 Claude Code 的插件系统架构、Hook 机制、多 Agent 编排模式等通用知识。
快速体验
# 安装(MacOS/Linux)curl -fsSL https://claude.ai/install.sh | bash
# 进入项目目录并启动claude教程导读
本教程分为 AI 应用通用知识 和 编程核心技术 两部分:
AI 应用通用知识(ai/ 目录)
从 Claude Code 的官方插件和架构中抽象出的行业通用知识,涵盖插件系统设计、Hook 事件驱动、多 Agent 编排、Skill 渐进式知识管理等。每个知识点与 common/ 目录的关系如下:
| 大纲章节 | 知识点 | 覆盖类型 | Common 目标路径 |
|---|---|---|---|
| 01 | 插件系统架构 | 首次覆盖 | common/plugin-system/ |
| 02 | Hook 事件驱动机制 | 已有 | common/hook-system/(待创建) |
| 03 | 多 Agent 编排模式 | 补充 | common/multi-agent/ |
| 04 | Skill 渐进式知识管理 | 首次覆盖 | common/skill-design/ |
| 05 | 企业级安全与沙箱策略 | 首次覆盖 | common/enterprise-security/ |
编程核心技术(dev/ 目录)
聚焦 Claude Code 项目的具体工程实践,包括插件目录约定、Agent 文件结构、Command 工作流设计、MDM 部署配置等。
建议阅读顺序:先读本项目介绍 → 通读 AI 知识章节 → 深入 Dev 技术章节。涉及通用概念时,教程会链接到
common/下的独立知识库。