Mở rộng Claude Code — Skills, Hooks, Subagents và MCP

Hướng dẫn mở rộng Claude Code với Skills (workflow tái sử dụng), Hooks (tự động hóa), Subagents (agent riêng) và MCP (kết nối công cụ bên ngoài).

Claude Code có 4 cơ chế mở rộng chính, mỗi loại phù hợp với mục đích khác nhau. Hiểu lúc nào dùng cái nào giúp bạn build workflow hiệu quả và maintainable.

Tổng quan 4 cơ chế

Cơ chế	Ai trigger	Load khi nào	Dùng cho
Skills	Claude auto hoặc bạn /skill	On-demand, khi relevant	Workflow tái sử dụng, domain knowledge
Hooks	Claude lifecycle events	Mỗi lần event trigger	Deterministic actions, auto-format, lint
Subagents	Bạn yêu cầu Claude	Khi bạn ask "use subagent"	Research trong context riêng
MCP	Claude dùng tool	Session start, khi cần data	Kết nối external services

Skills

Skills extend Claude's knowledge với project-specific hoặc domain-specific information. Claude tự động apply khi relevant, hoặc bạn invoke trực tiếp.

Tạo skill

Tạo thư mục với file SKILL.md trong .claude/skills/:

.claude/skills/api-conventions/SKILL.md

---
name: api-conventions
description: REST API design conventions for our services
---
# API Conventions
- Use kebab-case for URL paths
- Use camelCase for JSON properties
- Always include pagination for list endpoints
- Version APIs in the URL path (/v1/, /v2/)

Skill với workflow

Skills có thể define repeatable workflows bạn invoke trực tiếp:

.claude/skills/fix-issue/SKILL.md

---
name: fix-issue
description: Fix a GitHub issue
disable-model-invocation: true
---
Analyze and fix the GitHub issue: $ARGUMENTS.

1. Use `gh issue view` to get the issue details
2. Understand the problem described in the issue
3. Search the codebase for relevant files
4. Implement the necessary changes to fix the issue
5. Write and run tests to verify the fix
6. Ensure code passes linting and type checking
7. Create a descriptive commit message
8. Push and create a PR

Gọi skill:

Claude Code prompt

/fix-issue 1234

Dùng disable-model-invocation: true cho workflows có side effects mà bạn muốn trigger manually, không để Claude tự invoke.

Hooks

Hooks chạy shell commands tại các lifecycle events cụ thể. Khác với CLAUDE.md (advisory), hooks deterministic — guarantee action happen.

Lifecycle events

Event	Khi nào trigger
PreToolUse	Trước khi tool được execute
PostToolUse	Sau khi tool hoàn thành
SessionStart	Session bắt đầu
SessionEnd	Session kết thúc
UserPromptSubmit	User submit prompt
PreCompact	Trước khi compact context
PostCompact	Sau khi compact
Stop	Claude dừng respond
SubagentStop	Subagent dừng
Notification	Có notification

Ví dụ hook

.claude/settings.json

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit",
        "hooks": [
          {
            "type": "command",
            "command": "eslint --fix $CLAUDE_FILE_PATH"
          }
        ]
      }
    ],
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "pnpm test"
          }
        ]
      }
    ]
  }
}

Tạo hook bằng Claude

Claude Code prompt

Write a hook that runs eslint after every file edit

Claude Code prompt

Write a hook that blocks writes to the migrations folder

Dùng /hooks để browse all configured hooks.

Stop hook chạy check và block turn từ ending nếu check fails. Claude sẽ override hook sau 8 consecutive blocks.

Subagents

Subagents chạy trong context riêng với tools riêng. Hữu ích cho tasks đọc nhiều files hoặc cần specialized focus mà không clutter main conversation.

Tạo subagent

.claude/agents/security-reviewer.md

---
name: security-reviewer
description: Reviews code for security vulnerabilities
tools: Read, Grep, Glob, Bash
model: opus
---
You are a senior security engineer. Review code for:
- Injection vulnerabilities (SQL, XSS, command injection)
- Authentication and authorization flaws
- Secrets or credentials in code
- Insecure data handling

Provide specific line references and suggested fixes.

Sử dụng subagent

Claude Code prompt

use a subagent to review this code for security issues

Claude Code prompt

use subagents to investigate how our authentication system
handles token refresh

Writer/Reviewer pattern

Dùng 2 sessions — 1 viết, 1 review:

Session A (Writer)	Session B (Reviewer)
Implement a rate limiter for our API
	Review the rate limiter in @src/middleware/rateLimiter.ts
Address the review feedback: [output from B]

MCP (Model Context Protocol)

MCP là open standard kết nối AI tools với external data sources. Claude Code có thể read Google Drive, update Jira tickets, query databases, tích hợp Figma designs qua MCP.

Thêm MCP server

Terminal

claude mcp add <server-name> <server-url>

Ví dụ:

Terminal

claude mcp add atlassian https://mcp.atlassian.com/v1/mcp \
  --transport http \
  --header "Authorization: Basic $(echo -n '[e-mail]:api-token' | base64)" \
  --scope user

Quản lý MCP

Terminal

claude mcp list              # Xem danh sách servers
claude mcp remove <name>     # Xóa server

Dùng MCP resources

Claude Code prompt

Show me the data from @github:repos/owner/repo/issues

Format: @server:resource — fetch data từ connected MCP servers.

Plugins

Plugins bundle skills, hooks, subagents, và MCP servers thành installable units từ community và Anthropic.

Claude Code prompt

/plugin

Browse marketplace và cài đặt one-click. Đặc biệt hữu ích:

• Code intelligence plugin — precise symbol navigation, auto error detection

• commit-commands — Git commit helpers

• code-review — Automated code review

Khi nào dùng cái nào?

Nhu cầu	Dùng
Claude cần biết coding conventions	CLAUDE.md hoặc Skill
Workflow có thể tái sử dụng	Skill
Auto-format sau mỗi file edit	Hook
Block action deterministic	Hook
Research codebase không làm sạch context	Subagent
Review code trong context riêng	Subagent
Kết nối Jira, Notion, Figma	MCP
Query database từ Claude	MCP
Cài đặt bundle tools	Plugin

Tài liệu tham khảo

• Skills

• Hooks Guide

• Subagents

• MCP Quickstart

• Plugins

• Extend Claude Code