本手册基于 instructkr/claude-code 源码分析编写，涵盖从安装配置到插件开发的完整知识体系。
版本: 2.0.0 | 更新: 2026-04-01 | 源码版本: 2.1.81
本手册的所有内容均基于 instructkr/claude-code 开源项目的源码分析编写。
特别感谢：
- 本手册通过深度阅读源码目录，归纳总结出 39 篇文档
- 所有技术细节均经过源码验证，确保准确性
本文档不是官方文档，而是基于开源源码的独立分析总结：
| 文档类型 | 数量 | 说明 |
|---|---|---|
| 入门指南 | 3 篇 | 安装、核心概念、快速上手 |
| CLI 参考 | 3 篇 | 命令行参数、子命令、环境变量 |
| 工具系统 | 3 篇 | 内置工具、权限管理、MCP集成 |
| 技能系统 | 3 篇 | 原生机制、技能创建、与Agent配合 |
| Hook 系统 | 4 篇 | 27种Hook类型、配置调试、Python实践、常见问题 |
| 配置体系 | 3 篇 | 配置层次、settings.json、项目配置 |
| 进阶功能 | 9 篇 | Agent、多Agent、插件、MCP、Team Mode、Sandbox、Plan Mode、Voice Mode、Bridge Remote |
| 最佳实践 | 3 篇 | 推荐模式、避免使用、团队协作 |
| 内存系统 | 3 篇 | 概述、API、最佳实践 |
| 任务系统 | 1 篇 | 任务管理 |
| 插件开发 | 4 篇 | 概述、结构、API、开发示例 |
| 总计 | 39 篇 | 覆盖 Claude Code 全部核心系统 |
所有文档内容均经过源码验证，包括：
- Hook 类型数量和触发时机
- 配置加载优先级
- Skill frontmatter 字段定义
- Agent 生命周期
- 工具权限模型
| 我想做什么 | 推荐阅读 |
|---|---|
| 第一次用 Claude Code | 快速上手 |
| 安装 Claude Code | 安装与认证 |
| 理解基本概念 | 核心概念 |
| 写 Hooks 自动化脚本 | Hook 类型详解 |
| 开发自定义 Skill | 技能创建规范 |
| 配置 Claude Code | settings.json 参考 |
| 团队共享配置 | 项目级配置 |
| 开发插件/外挂 | 插件开发指南 |
| 理解权限和安全 | 工具权限管理 |
| 多 Agent 协作 | 多 Agent 协作 |
以下是从源码中发现的关键信息，已通过源码验证：
| 发现 | 重要性 | 相关章节 |
|---|---|---|
| PreCommit Hook 不存在 | ⭐⭐⭐ | Hook 类型详解 |
| 实际有 27 种 Hook 类型 | ⭐⭐⭐ | Hook 类型详解 |
| Plugin = Skills + Agents + Hooks + Tools | ⭐⭐⭐ | 插件系统 |
| 6 层配置优先级 | ⭐⭐ | 配置层次结构 |
| Skill frontmatter 有 17 个字段 | ⭐⭐ | 原生技能机制 |
| Skills 支持 条件激活 (paths/arguments) | ⭐⭐ | 原生技能机制 |
| 章节 | 内容 | 状态 |
|---|---|---|
| 安装与认证 | Homebrew/curl 安装、认证配置 | ✅ |
| 核心概念 | Agent、Tools、Skills、Hooks 基本概念 | ✅ |
| 快速上手 | 5分钟上手教程 | ✅ |
| 章节 | 内容 | 状态 |
|---|---|---|
| 全局选项 | CLI 全局选项 | ✅ |
| 子命令 | 所有子命令详解 | ✅ |
| 环境变量 | 环境变量配置 | ✅ |
| 章节 | 内容 | 状态 |
|---|---|---|
| 内置工具清单 | Read/Write/Bash/Glob/Grep 等 | ✅ |
| 工具权限管理 | allow/deny/permit 配置 | ✅ |
| MCP 工具集成 | MCP 服务器集成 | ✅ |
| 章节 | 内容 | 状态 |
|---|---|---|
| 原生技能机制 | 加载原理、优先级、条件激活 | ✅ |
| 技能创建规范 | SKILL.md 规范、frontmatter | ✅ |
| 技能与 Agent 配合 | 技能调用 Agent | ✅ |
| 章节 | 内容 | 状态 |
|---|---|---|
| Hook 类型详解 | 27种 Hook 类型及触发时机 | ✅ |
| 配置与调试 | Hook 配置与问题排查 | ✅ |
| Python Hooks 实践 | Python 编写 Hook 示例 | ✅ |
| 常见问题与坑点 | ✅ |
| 章节 | 内容 | 状态 |
|---|---|---|
| 配置层次结构 | 6 层配置优先级 | ✅ |
| settings.json 参考 | 完整配置项说明 | ✅ |
| 项目级配置 | .claude/ 目录配置 | ✅ |
| 章节 | 内容 | 状态 |
|---|---|---|
| Agent 系统 | Agent 机制详解 | ✅ |
| 多 Agent 协作 | 多 Agent 通信 | ✅ |
| 插件系统 | 插件安装与管理 | ✅ |
| MCP 服务器 | MCP 服务器配置 | ✅ |
| Team Mode | 团队协作模式 | ✅ |
| Sandbox | 沙箱安全机制 | ✅ |
| Plan Mode | 规划模式 | ✅ |
| Voice Mode | 语音模式 | ✅ |
| Bridge Remote | 远程连接 | ✅ |
| 章节 | 内容 | 状态 |
|---|---|---|
| 推荐使用模式 | 最佳实践 | ✅ |
| 避免使用的功能 | ✅ | |
| 团队协作规范 | 团队配置建议 | ✅ |
| 章节 | 内容 | 状态 |
|---|---|---|
| 内存系统概述 | 持久化记忆机制 | ✅ |
| 内存 API | API 参考 | ✅ |
| 内存最佳实践 | 使用建议 | ✅ |
| 章节 | 内容 | 状态 |
|---|---|---|
| 任务系统概述 | 任务管理 | ✅ |
| 章节 | 内容 | 状态 |
|---|---|---|
| 插件系统概述 | 插件架构说明 | ✅ |
| 插件结构 | 目录结构 | ✅ |
| 插件 API | API 参考 | ✅ |
| 开发示例 | 完整开发示例 | ✅ |
所有核心系统已通过脚本验证：
| 测试项 | 脚本 | 状态 |
|---|---|---|
| Hook 安全检查 | 00-hooks-test.sh | ✅ |
| Skill 系统 | 01-skills-test.sh | ✅ |
| Config 配置 | 02-config-test.sh | ✅ |
| 工具权限 | 03-tools-test.sh | ✅ |
| Agent 系统 | 04-agents-test.sh | ✅ |
| 插件结构 | 05-plugins-test.sh | ✅ |
| 内存系统 | 06-memory-test.sh | ✅ |
| 任务系统 | 07-tasks-test.sh | ✅ |
| CLI 参数 | 08-cli-test.sh | ✅ |
| MCP 服务器 | 09-mcp-test.sh | ✅ |
| 沙箱配置 | 10-sandbox-test.sh | ✅ |
| 指标 | 数量 |
|---|---|
| 文档文件 | 39 |
| 测试脚本 | 11 |
| Hook 类型 | 27 |
| Skill frontmatter 字段 | 17 |
| 配置层级 | 6 |
| 进阶功能模块 | 9 |
发现问题或有补充内容？欢迎提交 Issue 或 PR。
所有内容均基于源码分析，如发现与实际不符，请以源码为准。