如果你在用 Claude Code 写代码，却还没看过这个项目——你可能正在以 10% 的效率使用一个 100% 的工具。

这是目前互联网上最完整、最权威的 Claude Code 最佳实践知识库：38K Star，由 Anthropic 核心团队亲自贡献内容。

资源链接

项目	信息
GitHub	github.com/anthropics-docs/claude-code
Star	38K+
更新	持续更新，追随官方
内容	69条实战技巧

核心内容：三大层次

层次	说明
概念与架构	理解 Claude Code 的核心扩展机制
命令与工作流	实战中总结的 69 条技巧
社区实践	工程师们的最佳经验

一、6大核心机制

概念对照表

概念	作用	类比
Subagents	在独立隔离上下文中运行的自主 Actor	分身
Commands	注入当前上下文的斜杠命令	快捷指令
Skills	可配置、可预加载的知识注入单元	知识库
Hooks	Agent 循环外的事件处理器	触发器
MCP Servers	连接外部工具、数据库和 API	扩展坞
Memory	通过 CLAUDE.md 实现的持久记忆	笔记本

二、Command 命令

什么是 Command

Command 是斜杠命令，注入当前上下文，用于工作流编排。

常用 Command

命令	用途
/help	查看帮助
/clear	清除对话历史
/compact	压缩上下文
/claude	访问 Claude 配置
/mcp	MCP 服务器管理

自定义 Command 示例

# 在 .claude/commands/ 创建
# my-task.md

# 命令描述
@working_memory.md

帮我分析这个任务的进度：
1. 核心需求是什么
2. 已经完成了多少
3. 下一步该做什么

三、Subagent 子智能体

什么是 Subagent

Subagent 是在独立隔离上下文中运行的自主 Actor，有自己的工具、权限和记忆。

使用场景

场景	说明
并行任务	同时处理多个独立任务
复杂工作流	主 Agent 协调多个子 Agent
隔离执行	避免污染主上下文

示例

// 使用 Claude Code API
const { ClaudeCode } = require('@anthropic-ai/claude-code');

const agent = new ClaudeCode();

agent.spawnSubagent({
  task: '帮我写一个用户登录模块',
  tools: ['Read', 'Write', 'Bash'],
  memory: ['user-auth-knowledge.md']
});

四、Skills 技能

什么是 Skill

Skill 是可配置、可预加载、可自动发现的知识注入单元。

Skill 结构

skills/
├── my-skill/
│   ├── SKILL.md      # 核心定义
│   └── scripts/      # 辅助脚本
│       ├── setup.py
│       └── validate.py

SKILL.md 示例

---
name: code-review
description: 代码审查技能
trigger: /review
---

# 代码审查技能

## 使用方法
/review <文件路径>

## 审查要点
- 代码风格
- 安全漏洞
- 性能问题
- 最佳实践

## 输出格式
1. 问题列表
2. 修复建议
3. 代码评分

五、Hooks 钩子

什么是 Hook

Hook 在 Agent 循环外运行，可触发脚本、HTTP 请求或 Agent。

Hook 类型

钩子	触发时机
on_tool_use	工具使用时
on_message	收到消息时
on_result	结果返回时
on_error	错误发生时

示例配置

# .claude/hooks.yaml
hooks:
  - name: log-every-tool
    trigger: on_tool_use
    action: |
      console.log('Tool used:', tool_name, args);

六、MCP Servers

什么是 MCP

MCP (Model Context Protocol) 是连接外部工具、数据库和 API 的协议层。

内置 MCP Servers

Server	用途
filesystem	文件系统操作
git	Git 操作
bash	Shell 命令
search	搜索功能

自定义 MCP

// mcp-server-example.js
const { Server } = require('@anthropic-ai/mcp-server');

const server = new Server('my-server');

server.tool('get-weather', async ({ city }) => {
  return { temperature: 25, city };
});

server.start();

七、Memory 记忆

CLAUDE.md

通过 CLAUDE.md 文件实现持久记忆。

常用位置

位置	作用域
./CLAUDE.md	当前项目
~/.claude/CLAUDE.md	全局
@working_memory.md	临时加载

CLAUDE.md 示例

# 项目配置

## 技术栈
- 前端：React + TypeScript
- 后端：Node.js + Express
- 数据库：PostgreSQL

## 开发规范
- 使用 TypeScript strict 模式
- 组件放在 src/components/
- API 放在 src/api/

## 常用命令
- npm run dev    # 开发模式
- npm run build  # 构建
- npm test       # 测试

## 注意事项
- 不要直接修改 node_modules
- 所有 API 调用要加错误处理

八、69条实战技巧精选

高频使用技巧

技巧	说明
使用 @ 引用文件	告诉 Claude 看哪个文件
使用 # 加载规则	临时加载配置
使用 /compact	压缩长对话
使用 /clear	清除对话
创建 CLAUDE.md	项目级记忆

Subagent 技巧

技巧	说明
独立任务用 Subagent	不污染主上下文
共享 Memory	子 Agent 间传递信息
限制工具权限	安全隔离

Command 技巧

技巧	说明
自定义常用命令	提高效率
在 Commands 中加载上下文	减少重复输入
使用 Hook 增强 Command	自动化工作流

Skill 技巧

技巧	说明
按项目创建 Skill	积累可复用知识
在 Skill 中预定义模板	减少重复工作
共享 Skill 给团队	统一最佳实践

九、使用路径速查

新手入门
    │
    ├── 1. 安装 Claude Code
    ├── 2. 配置 API Key
    ├── 3. 创建第一个项目 CLAUDE.md
    ├── 4. 用 @ 引用文件开始对话
    │
    ▼
中级提升
    │
    ├── 1. 学习 /help 查看所有命令
    ├── 2. 使用 /compact 管理长对话
    ├── 3. 创建自定义 Commands
    ├── 4. 安装常用 Skills
    │
    ▼
高级用法
    │
    ├── 1. 使用 Subagent 并行任务
    ├── 2. 配置 Hooks 自动化
    ├── 3. 开发自定义 MCP Server
    ├── 4. 团队共享 Skill 库

一句话总结

Claude Code = Command + Subagent + Skill + Hook + MCP + Memory。

69条技巧的精髓：用 @ 读文件、用 # 加载规则、用 / 调命令、用 Subagent 做并行。

GitHub：github.com/anthropics-docs/claude-code