跳转到内容

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 SDKTypeScript(@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 编排模式等通用知识。

快速体验

Terminal window
# 安装(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/
02Hook 事件驱动机制已有common/hook-system/(待创建)
03多 Agent 编排模式补充common/multi-agent/
04Skill 渐进式知识管理首次覆盖common/skill-design/
05企业级安全与沙箱策略首次覆盖common/enterprise-security/

编程核心技术(dev/ 目录)

聚焦 Claude Code 项目的具体工程实践,包括插件目录约定、Agent 文件结构、Command 工作流设计、MDM 部署配置等。

建议阅读顺序:先读本项目介绍 → 通读 AI 知识章节 → 深入 Dev 技术章节。涉及通用概念时,教程会链接到 common/ 下的独立知识库。