Files
Thiên Toán a70777e9bc Add Vietnamese (Tiếng Việt) Localization (#42)
* feat(i18n): add Vietnamese localization infrastructure

Add comprehensive infrastructure for Vietnamese translation of the
claude-howto documentation:

Features:
- Parallel vi/ directory structure for Vietnamese content
- Modified build_epub.py with --lang flag for Vietnamese EPUB
- Vietnamese-specific pre-commit hooks for quality checks
- Translation support files (glossary, style guide, queue tracker)
- sync_translations.py script to detect outdated translations

Infrastructure:
- vi/ directory with all 10 module subdirectories
- TRANSLATION_NOTES.md: comprehensive glossary and style guide
- TRANSLATION_QUEUE.md: progress tracking for 66+ files
- vi/README.md: Vietnamese landing page

EPUB Build:
- Added --lang CLI flag (en/vi) to build_epub.py
- Language-specific metadata (title, subtitle)
- Automatic root path adjustment for vi/ directory
- Dynamic output filename (claude-howto-guide-vi.epub)

Quality Assurance:
- Vietnamese markdown linting
- Vietnamese cross-reference checking
- Vietnamese Mermaid syntax validation
- Vietnamese link checking
- Vietnamese EPUB build validation

Ready for translation work to begin.

* feat(vi): translate INDEX.md to Vietnamese

Complete Vietnamese translation of INDEX.md - the comprehensive
index of all example files in the repository.

Translation follows vi/TRANSLATION_NOTES.md guidelines:
- Technical terms kept per glossary (slash command → "lệnh slash")
- File paths and code blocks preserved in English
- Table structure and formatting maintained
- All 882 lines translated

Content includes:
- Complete file tree (10 modules, 100+ files)
- Feature coverage matrix
- Quick start guides by use case
- Learning path progression
- Search by keyword sections

Progress: 1/5 core documents completed

* feat(vi): translate CATALOG.md to Vietnamese

Complete Vietnamese translation of CATALOG.md - the quick reference
guide to all Claude Code features.

Translation follows vi/TRANSLATION_NOTES.md guidelines:
- Technical terms kept per glossary (slash command → "lệnh slash")
- All command names preserved (/help, /optimize, etc.)
- Code blocks, JSON examples, and bash commands unchanged
- All tables and formatting maintained
- 517 lines translated with complete feature coverage

Content includes:
- Summary statistics (99 built-in + 43 examples = 117 total)
- Complete built-in commands reference (55+ commands)
- Custom commands examples (8 commands)
- Permission modes (6 modes)
- Subagents (6 built-in + 10 custom)
- Skills (5 bundled + 4 custom)
- Plugins (3 complete plugins)
- MCP servers (1 built-in + 8 common servers)
- Hooks (25 events + 7 example hooks)
- Memory files (7 types)
- New features (March 2026) - 17 new features
- Installation priority guide
- Complete one-command installation

Progress: 2/5 core documents completed

* docs(vi): translate learning roadmap to Vietnamese

- Add complete Vietnamese translation of LEARNING-ROADMAP.md (747 lines)
- Include self-assessment quiz for level determination
- Translate three learning levels: Beginner, Intermediate, Advanced
- Translate all milestones (1A, 1B, 2A, 2B, 3A, 3B) with hands-on exercises
- Preserve Mermaid diagram for learning path visualization
- Maintain progress tracking checklists and learning tips

* docs(vi): translate quick reference guide to Vietnamese

- Add complete Vietnamese translation of QUICK_REFERENCE.md (507 lines)
- Include installation quick commands for all features
- Translate feature cheat sheet with usage examples
- Translate common use cases (code review, documentation, DevOps, etc.)
- Preserve all code snippets, commands, and file paths in English
- Maintain file locations reference diagram
- Include learning path and new features (March 2026) sections
- Keep tips & tricks, feature matrix, and checklist intact

* docs(vi): translate module 01 - slash commands to Vietnamese

- Add complete Vietnamese translation of 01-slash-commands/README.md (553 lines)
- Translate slash commands overview and architecture
- Include 55+ built-in commands reference table with Vietnamese descriptions
- Translate bundled skills section (5 skills)
- Document custom commands (now skills) migration path
- Include frontmatter reference, arguments, and dynamic context sections
- Preserve all command names, code examples, and Mermaid diagrams
- Translate 8 available commands in folder with usage examples
- Include installation, troubleshooting, and best practices sections

* docs(vi): update translation queue progress - Module 01 README done

- Mark 01-slash-commands/README.md as completed (2026-04-02)
- Update Module 01 progress: 1/9 files (11%)
- Update overall progress: 6/66 files (9%)
- Update Priority 2 progress: 1/31 files (3%)
- Add recent completion note to queue header

* docs(vi): translate slash command - commit to Vietnamese

- Translate commit.md slash command to Vietnamese
- Keep all git commands and technical syntax intact
- Translate instructions and descriptions
- Maintain conventional commits format documentation

* docs(vi): translate slash command - doc-refactor to Vietnamese

- Translate doc-refactor.md slash command to Vietnamese
- Keep all technical terms and file paths intact
- Translate documentation refactoring instructions
- Maintain structure and numbering

* docs(vi): translate slash command - generate-api-docs to Vietnamese

- Translate generate-api-docs.md slash command to Vietnamese
- Keep all technical terms and file paths intact
- Translate API documentation generation instructions
- Maintain output format specifications

* docs(vi): translate slash command - optimize to Vietnamese

- Translate optimize.md slash command to Vietnamese
- Keep all technical terms and code concepts intact
- Translate code optimization instructions
- Maintain issue priority and response format

* docs(vi): translate slash command - pr to Vietnamese

- Translate pr.md slash command to Vietnamese
- Keep all commands and technical syntax intact
- Translate PR preparation checklist instructions
- Maintain conventional commits format documentation

* docs(vi): translate slash command - push-all to Vietnamese

- Translate push-all.md slash command to Vietnamese (153 lines)
- Keep all git commands and technical syntax intact
- Translate comprehensive workflow with safety checks
- Maintain API key validation patterns and error handling
- Preserve when to use/avoid sections and alternatives

* docs(vi): translate slash command - setup-ci-cd to Vietnamese

- Translate setup-ci-cd.md slash command to Vietnamese
- Keep all tool names and technical terms intact
- Translate CI/CD pipeline implementation instructions
- Maintain pre-commit hooks and GitHub Actions sections

* docs(vi): translate slash command - unit-test-expand to Vietnamese

- Translate unit-test-expand.md slash command to Vietnamese
- Keep all framework names and technical terms intact
- Translate test coverage expansion instructions
- Maintain testing frameworks and scenario sections

* docs(vi): update translation queue - Module 01 complete (100%)

- Mark all 9 Module 01 files as completed (2026-04-02)
- Update Module 01 progress: 9/9 files (100%) 
- Update overall progress: 14/66 files (21%)
- Update Priority 2 progress: 9/31 files (29%)
- Update header with Module 01 completion milestone

Module 01: Slash Commands - All files translated:
 README.md (overview, built-in commands, skills)
 commit.md (git commit with context)
 doc-refactor.md (documentation restructuring)
 generate-api-docs.md (API documentation generator)
 optimize.md (code optimization analysis)
 pr.md (pull request preparation)
 push-all.md (stage, commit, push with safety)
 setup-ci-cd.md (CI/CD pipeline implementation)
 unit-test-expand.md (test coverage expansion)

* docs(vi): translate module 02 - memory guide to Vietnamese

- Add complete Vietnamese translation of 02-memory/README.md (1162 lines)
- Translate memory system overview and architecture
- Include quick reference for memory commands (/init, /memory, #)
- Document complete memory hierarchy (8 levels with precedence)
- Translate auto memory section with architecture diagrams
- Include practical examples (project, directory-specific, personal memory)
- Add best practices, installation instructions, and troubleshooting
- Preserve all code examples, file paths, and technical terms
- Maintain Mermaid diagrams and tables

* docs(vi): translate example project CLAUDE.md to Vietnamese

- Translate project-CLAUDE.md example memory file
- Keep all technical terms, commands, and code style intact
- Translate descriptions and explanations
- Maintain project configuration structure

* docs(vi): translate example personal CLAUDE.md to Vietnamese

- Translate personal-CLAUDE.md example memory file
- Keep all technical terms, tools, and preferences intact
- Translate descriptions and explanations
- Maintain personal preferences structure

* docs(vi): translate example directory-specific CLAUDE.md to Vietnamese

- Translate directory-api-CLAUDE.md example memory file
- Keep all technical terms, API standards, and code examples intact
- Translate descriptions and explanations
- Maintain API module standards structure

* docs(vi): update translation queue - Module 02 complete (100%)

- Mark all 4 Module 02 files as completed (2026-04-02)
- Update Module 02 progress: 4/4 files (100%) 
- Update overall progress: 18/66 files (27%)
- Update Priority 2 progress: 13/31 files (42%)
- Update header with Module 02 completion milestone

Module 02: Memory - All files translated:
 README.md (1162 lines - comprehensive memory guide)
 project-CLAUDE.md (example project memory)
 personal-CLAUDE.md (example personal preferences)
 directory-api-CLAUDE.md (example directory-specific rules)

* docs(vi): translate module 03 - skills guide to Vietnamese

- Add complete Vietnamese translation of 03-skills/README.md (805 lines)
- Translate Agent Skills overview and architecture
- Include progressive disclosure loading mechanism (3 levels)
- Document skill types, locations, and automatic discovery
- Translate skill creation process and SKILL.md format
- Include required and optional frontmatter fields
- Document skill content types (reference vs task)
- Translate controlling skill invocation and string substitutions
- Include dynamic context injection with shell commands
- Document running skills in subagents with context: fork
- Translate 6 practical examples with directory structures
- Add supporting files, management, and best practices sections
- Preserve all code examples, YAML frontmatter, and Mermaid diagrams
- Maintain tables, troubleshooting guides, and security considerations

* docs(vi): translate skill - blog-draft to Vietnamese

- Translate blog-draft/SKILL.md to Vietnamese (275 lines)
- Keep all workflow steps and technical structure intact
- Translate instructions and descriptions
- Maintain version tracking and file structure
- Preserve all markdown formatting and code examples

* docs(vi): translate skill - brand-voice to Vietnamese

- Translate brand-voice/SKILL.md to Vietnamese (73 lines)
- Keep brand identity, tone, and vocabulary intact
- Translate writing guidelines and examples
- Maintain preferred/avoided terms sections
- Preserve good/bad examples with explanations

* docs(vi): translate skill - claude-md to Vietnamese

- Translate claude-md/SKILL.md to Vietnamese (213 lines)
- Keep all golden rules and core principles intact
- Translate execution flow and content strategy
- Maintain WHAT/WHY/HOW structure
- Preserve quality constraints and validation checklist
- Keep anti-patterns and output format sections

* docs(vi): translate skill - code-review to Vietnamese

- Translate code-review/SKILL.md to Vietnamese (71 lines)
- Keep all review categories and template intact
- Translate security, performance, quality, maintainability sections
- Maintain review template structure
- Preserve version history

* docs(vi): translate skill - refactor to Vietnamese

- Translate refactor/SKILL.md to Vietnamese (427 lines)
- Keep all Martin Fowler refactoring methodology intact
- Translate 6-phase workflow with detailed steps
- Maintain core principles and safety rules
- Preserve code smell catalog and refactoring techniques
- Keep quick start example with before/after code
- Maintain version history and references sections

* docs(vi): update translation queue - Module 03 complete (100%)

- Mark all 6 Module 03 files as completed (2026-04-02)
- Update Module 03 progress: 6/6 files (100%) 
- Update overall progress: 24/66 files (36%)
- Update Priority 2 progress: 19/31 files (61%)
- Update header with Module 03 completion milestone

Module 03: Skills - All files translated:
 README.md (805 lines - comprehensive skills guide)
 blog-draft/SKILL.md (275 lines - blog post creation workflow)
 brand-voice/SKILL.md (73 lines - brand voice consistency)
 claude-md/SKILL.md (213 lines - CLAUDE.md best practices)
 code-review/SKILL.md (71 lines - comprehensive code review)
 refactor/SKILL.md (427 lines - Fowler refactoring methodology)

* docs(vi): translate Module 04 Subagents README

Complete Vietnamese translation of subagents reference guide:
- Configuration and built-in subagents (general-purpose, Plan, Explore, Bash, statusline-setup, Claude Code Guide)
- Agent management with /agents command
- Automatic delegation vs explicit invocation
- Resumable agents and chaining
- Persistent memory across agent sessions
- Background subagents for parallel work
- Worktree isolation for safe experimentation
- Agent Teams (experimental feature)
- Best practices and usage patterns

* docs(vi): complete Module 04 Subagents translation

Translate all 6 subagent example definitions:
- code-reviewer.md: Expert code review specialist
- debugger.md: Root cause analysis and debugging
- documentation-writer.md: Technical documentation creation
- implementation-agent.md: Full-stack feature implementation
- secure-reviewer.md: Security-focused code review
- test-engineer.md: Comprehensive test coverage

Update translation queue progress:
- Module 04: 7/7 files (100%) 
- Overall: 31/66 files (47%)
- Next: Module 05 (MCP)

* docs(vi): complete Module 05 MCP translation

Translate comprehensive MCP (Model Context Protocol) guide:
- Overview and architecture diagrams
- Installation methods (HTTP, Stdio, SSE, WebSocket)
- OAuth 2.0 authentication support
- MCP tool search and dynamic updates
- Elicitation and prompt slash commands
- Configuration management (local, project, user scopes)
- Practical examples (GitHub, Database, Filesystem, Slack MCPs)
- MCP vs Memory decision matrix
- Code execution approach for solving context bloat
- MCPorter runtime reference
- Security best practices and troubleshooting

Translate 4 MCP configuration JSON examples:
- filesystem-mcp.json: File operations
- github-mcp.json: GitHub integration
- database-mcp.json: SQL queries
- multi-mcp.json: Multiple servers configuration

Update translation queue progress:
- Module 05: 5/5 files (100%) 
- Overall: 36/66 files (55%)
- Next: Module 06 (Hooks)

* docs(vi): complete Module 06 Hooks translation

Translate comprehensive Hooks guide:
- Overview and architecture
- Configuration structure (user, project, local scopes)
- Four hook types: command, HTTP, prompt, agent
- 25 hook events with matcher patterns
- Component-scoped hooks and subagent frontmatter
- JSON input/output format and exit codes
- Environment variables and best practices
- Security considerations and debugging
- Installation instructions

Copy 9 hook example files (code, no translation needed):
- format-code.sh: Auto-format code after write/edit
- log-bash.sh: Bash command logging
- notify-team.sh: Team notifications
- pre-commit.sh: Pre-commit validation
- security-scan.sh: Security scanning
- validate-prompt.sh: Prompt validation
- context-tracker.py: Token usage tracking
- context-tracker-tiktoken.py: Accurate token counting

Update translation queue progress:
- Module 06: 9/9 files (100%) 
- Overall: 45/67 files (67%)
- Next: Module 07 (Plugins)

* docs(vi): complete Module 07 Plugins translation

Translate comprehensive Plugins guide:
- Overview and architecture diagrams
- Plugin loading process and lifecycle
- Plugin types (Official, Community, Organization, Personal)
- Plugin definition structure and manifest
- Plugin structure example with all directories
- LSP server configuration and examples
- Plugin options (v2.1.83+) with userConfig
- Persistent plugin data via CLAUDE_PLUGIN_DATA
- Inline plugins via settings (v2.1.80+)
- Standalone vs Plugin approach comparison
- Practical examples (PR Review, DevOps, Documentation plugins)
- Plugin marketplace and distribution
- Marketplace configuration and definition schema
- Plugin source types and distribution methods
- Plugin CLI commands and installation methods
- Plugin features comparison table
- Testing, hot-reload, and managed settings
- Plugin security restrictions
- Publishing workflow and best practices
- Complete troubleshooting guide

Copy all plugin subdirectories (code, no translation needed):
- devops-automation/: Deployment workflows, incident management
- documentation/: API docs, README generation, templates
- pr-review/: Pull request review automation

Update translation queue progress:
- Module 07: 10+/10+ files (100%) 
- Overall: 55+/67 files (82%)
- Next: Module 08-10 (Checkpoints, Advanced Features, CLI)

* docs(vi): complete Modules 08-10 translation

Module 08: Checkpoints and Rewind (2 files)
- Overview and architecture
- Access methods (keyboard shortcut, slash command)
- Five rewind options (restore code+conversation, conversation, code, summarize, cancel)
- Automatic checkpoints and retention policies
- Use cases and practical examples
- Integration with git and best practices

Module 09: Advanced Features (3 files)
- Planning Mode: Two-phase implementation approach
- Extended Thinking: Deep reasoning for complex problems
- Auto Mode: Background safety classifier
- Background Tasks, Scheduled Tasks
- Permission Modes (default, acceptEdits, plan, auto, dontAsk, bypassPermissions)
- Print Mode, Session Management
- Voice Dictation, Channels, Remote Control
- Web Sessions, Desktop App, Task List
- Git Worktrees, Sandboxing, Managed Settings

Module 10: CLI Reference (1 file)
- CLI commands reference
- Core flags and options
- Interactive vs Print Mode
- Model selection and configuration
- System prompt customization
- Tool & permission management
- Output formats and scripting

Update translation queue progress:
- Modules 08-10: 6/6 files (100%) 
- All Modules 01-10: 61+/61+ files (100%) 
- Overall: 61+/67 files (91%)
- Remaining: Supporting docs (6 files)

* docs(vi): complete supporting documentation translation

Translate all 5 supporting documents:
- CONTRIBUTING.md: Contribution guidelines
- SECURITY.md: Security policy and vulnerability reporting
- CODE_OF_CONDUCT.md: Community standards and harassment policy
- STYLE_GUIDE.md: Documentation formatting conventions
- CHANGELOG.md: Version history (v2.2.0, v2.1.1, v2.1.0, v2.0.0)

Update translation queue to 100% completion:
- All Modules 01-10: 61+ files (100%) 
- Supporting Docs: 5/5 files (100%) 
- Overall: 67+/67 files (100%) 
- Status: HOÀN THÀNH 

* fix(vi): fix mermaid syntax and broken cross-references in Vietnamese translation

Fix invalid `#` comment in mermaid block (use `%%` instead) and update
cross-reference script to support Unicode/Vietnamese diacritics in anchor
generation. Fix broken anchor links across vi/ documentation files.

* fix(vi): remove inline mermaid comment causing parse error

Inline %% comments on node definition lines are not supported by the
mermaid parser. The surrounding HTML comment already explains this is
an incorrect example.
2026-04-06 21:34:18 +02:00

28 KiB

Claude How To

Danh Mục Tính Năng Claude Code

Hướng dẫn tham khảo nhanh cho tất cả tính năng Claude Code: commands, agents, skills, plugins, và hooks.

Điều Hướng: Commands | Permission Modes | Tác Nhân Con | Skills | Plugins | MCP Servers | Hooks | Bộ Nhớ | Tính Năng Mới


Tóm Tắt

Tính Năng Built-in Ví Dụ Tổng Tham Chiếu
Lệnh Slash 55+ 8 63+ 01-slash-commands/
Tác Nhân Con 6 10 16 04-subagents/
Skills 5 bundled 4 9 03-skills/
Plugins - 3 3 07-plugins/
MCP Servers 1 8 9 05-mcp/
Hooks 25 sự kiện 7 7 06-hooks/
Bộ Nhớ 7 loại 3 3 02-memory/
Tổng 99 43 117

Lệnh Slash

Commands là các lệnh tắt do người dùng gọi thực hiện các hành động cụ thể.

Built-in Commands

Command Mô Tả Khi Nào Dùng
/help Hiển thị thông tin help Bắt đầu, học commands
/btw Câu hỏi phụ không thêm vào context Câu hỏi nhanh
/chrome Cấu hình tích hợp Chrome Tự động hóa trình duyệt
/clear Xóa lịch sử conversation Bắt đầu mới, giảm context
/diff Trình xem diff tương tác Review thay đổi
/config Xem/chỉnh sửa cấu hình Tùy chỉnh hành vi
/status Hiển thị trạng thái session Kiểm tra trạng thái hiện tại
/agents Liệt kê các agents có sẵn Xem tùy chọn ủy quyền
/skills Liệt kê các skills có sẵn Xem khả năng auto-invoke
/hooks Liệt kê các hooks đã cấu hình Debug tự động hóa
/insights Phân tích patterns của session Tối ưu hóa session
/install-slack-app Cài đặt Claude Slack app Tích hợp Slack
/keybindings Tùy chỉnh phím tắt Tùy chỉnh phím
/mcp Liệt kê MCP servers Kiểm tra tích hợp bên ngoài
/memory Xem các file bộ nhớ đã tải Debug tải context
/mobile Tạo QR code mobile Truy cập mobile
/passes Xem usage passes Thông tin subscription
/plugin Quản lý plugins Cài đặt/gỡ mở rộng
/plan Vào planning mode Triển khai phức tạp
/rewind Rewind về checkpoint Hoàn tác thay đổi, khám phá alternatives
/checkpoint Quản lý checkpoints Lưu/khôi phục trạng thái
/cost Hiển thị chi phí usage token Giám sát chi tiêu
/context Hiển thị usage context window Quản lý độ dài conversation
/export Xuất conversation Lưu để tham khảo
/extra-usage Cấu hình giới hạn usage thêm Quản lý rate limit
/feedback Gửi feedback hoặc báo cáo bug Báo cáo vấn đề
/login Xác thực với Anthropic Truy cập tính năng
/logout Đăng xuất Chuyển tài khoản
/sandbox Bật/tắt sandbox mode Thực thi command an toàn
/vim Bật/tắt vim mode Chỉnh sửa kiểu Vim
/doctor Chạy chẩn đoán Khắc phục sự cố
/reload-plugins Tải lại plugins đã cài đặt Quản lý plugin
/release-notes Hiển thị release notes Kiểm tra tính năng mới
/remote-control Bật điều khiển từ xa Truy cập từ xa
/permissions Quản lý permissions Kiểm soát truy cập
/session Quản lý sessions Workflows đa session
/rename Đổi tên session hiện tại Tổ chức sessions
/resume Tiếp tục session trước Tiếp tục làm việc
/todo Xem/quản lý todo list Theo dõi tasks
/tasks Xem background tasks Giám sát operations async
/copy Sao chép response cuối vào clipboard Chia sẻ output nhanh
/teleport Chuyển session sang máy khác Tiếp tục làm việc từ xa
/desktop Mở Claude Desktop app Chuyển sang interface desktop
/theme Đổi màu theme Tùy chỉnh giao diện
/usage Hiển thị thống kê usage API Giám sát quota và chi phí
/fork Fork conversation hiện tại Khám phá alternatives
/stats Hiển thị thống kê session Review metrics session
/statusline Cấu hình status line Tùy chỉnh hiển thị trạng thái
/stickers Xem stickers của session Phần thưởng vui
/fast Bật/tắt mode output nhanh Tăng tốc độ responses
/terminal-setup Cấu hình tích hợp terminal Thiết lập tính năng terminal
/upgrade Kiểm tra cập nhật Quản lý phiên bản

Custom Commands (Ví Dụ)

Command Mô Tả Khi Nào Dùng Phạm Vi Cài Đặt
/optimize Phân tích code để tối ưu hóa Cải thiện hiệu năng Project cp ../01-slash-commands/optimize.md .claude/commands/
/pr Chuẩn bị pull request Trước khi gửi PRs Project cp ../01-slash-commands/pr.md .claude/commands/
/generate-api-docs Tạo tài liệu API Tài liệu hóa APIs Project cp ../01-slash-commands/generate-api-docs.md .claude/commands/
/commit Tạo git commit với context Commit thay đổi User cp ../01-slash-commands/commit.md .claude/commands/
/push-all Stage, commit, và push Triển khai nhanh User cp ../01-slash-commands/push-all.md .claude/commands/
/doc-refactor Tái cấu trúc tài liệu Cải thiện docs Project cp ../01-slash-commands/doc-refactor.md .claude/commands/
/setup-ci-cd Thiết lập pipeline CI/CD Dự án mới Project cp ../01-slash-commands/setup-ci-cd.md .claude/commands/
/unit-test-expand Mở rộng độ phủ test Cải thiện testing Project cp ../01-slash-commands/unit-test-expand.md .claude/commands/

Phạm Vi: User = workflows cá nhân (~/.claude/commands/), Project = chia sẻ team (.claude/commands/)

Tham Chiếu: 01-slash-commands/ | Tài Liệu Chính Thức

Cài Đặt Nhanh (Tất Cả Custom Commands):

cp ../01-slash-commands/*.md .claude/commands/

Permission Modes

Claude Code hỗ trợ 6 permission modes điều khiển cách tool use được ủy quyền.

Mode Mô Tả Khi Nào Dùng
default Hỏi cho mỗi tool call Sử dụng tương tác tiêu chuẩn
acceptEdits Tự động chấp nhận edits file, hỏi cho các khác Workflows chỉnh sửa tin cậy
plan Chỉ tools read-only, không ghi Lập kế hoạch và khám phá
auto Chấp nhận tất cả tools mà không hỏi Vận hành hoàn toàn tự động (Research Preview)
bypassPermissions Bỏ qua tất cả kiểm tra permissions CI/CD, môi trường headless
dontAsk Bỏ qua tools cần yêu cầu permission Scripting không tương tác

Lưu Ý: auto mode là tính năng Research Preview (Tháng 3 năm 2026). Chỉ dùng bypassPermissions trong môi trường tin cậy, được sandbox.

Tham Chiếu: Tài Liệu Chính Thức


Tác Nhân Con

Các trợ lý AI chuyên biệt với context bị cô lập cho các tasks cụ thể.

Built-in Subagents

Agent Mô Tả Tools Model Khi Nào Dùng
general-purpose Tasks đa bước, nghiên cứu All tools Kế thừa model Nghiên cứu phức tạp, tasks đa file
Plan Lập kế hoạch triển khai Read, Glob, Grep, Bash Kế thừa model Thiết kế kiến trúc, lập kế hoạch
Explore Khám phá codebase Read, Glob, Grep Haiku 4.5 Tìm kiếm nhanh, hiểu code
Bash Thực thi command Bash Kế thừa model Operations Git, tasks terminal
statusline-setup Cấu hình status line Bash, Read, Write Sonnet 4.6 Cấu hình hiển thị status line
Claude Code Guide Trợ giúp và tài liệu Read, Glob, Grep Haiku 4.5 Nhận trợ giúp, học tính năng

Subagent Configuration Fields

Field Type Mô Tả
name string Định danh agent
description string Agent làm gì
model string Ghi đè model (ví dụ: haiku-4.5)
tools array Danh sách tools được phép
effort string Mức độ effort lý luận (low, medium, high)
initialPrompt string System prompt được chèn khi agent bắt đầu
disallowedTools array Tools bị từ chối rõ ràng cho agent này

Custom Subagents (Ví Dụ)

Agent Mô Tả Khi Nào Dùng Phạm Vi Cài Đặt
code-reviewer Chất lượng code toàn diện Sessions review code Project cp ../04-subagents/code-reviewer.md .claude/agents/
code-architect Thiết kế kiến trúc tính năng Lập kế hoạch tính năng mới Project cp ../04-subagents/code-architect.md .claude/agents/
code-explorer Phân tích codebase sâu Hiểu tính năng hiện có Project cp ../04-subagents/code-explorer.md .claude/agents/
clean-code-reviewer Review nguyên tắc Clean Code Review khả năng bảo trì Project cp ../04-subagents/clean-code-reviewer.md .claude/agents/
test-engineer Chiến lược & độ phủ test Lập kế hoạch test Project cp ../04-subagents/test-engineer.md .claude/agents/
documentation-writer Tài liệu kỹ thuật Tài liệu API, hướng dẫn Project cp ../04-subagents/documentation-writer.md .claude/agents/
secure-reviewer Review tập trung bảo mật Kiểm tra bảo mật Project cp ../04-subagents/secure-reviewer.md .claude/agents/
implementation-agent Triển khai tính năng hoàn chỉnh Phát triển tính năng Project cp ../04-subagents/implementation-agent.md .claude/agents/
debugger Phân tích nguyên nhân gốc Điều tra bug User cp ../04-subagents/debugger.md ~/.claude/agents/
data-scientist Truy vấn SQL, phân tích dữ liệu Tasks dữ liệu User cp ../04-subagents/data-scientist.md ~/.claude/agents/

Phạm Vi: User = cá nhân (~/.claude/agents/), Project = chia sẻ team (.claude/agents/)

Tham Chiếu: 04-subagents/ | Tài Liệu Chính Thức

Cài Đặt Nhanh (Tất Cả Custom Agents):

cp ../04-subagents/*.md .claude/agents/

Skills

Các khả năng tự động gọi với hướng dẫn, scripts, và templates.

Ví Dụ Skills

Skill Mô Tả Khi Tự Động Gọi Phạm Vi Cài Đặt
code-review Review code toàn diện "Review this code", "Check quality" Project cp -r ../03-skills/code-review .claude/skills/
brand-voice Kiểm tra nhất quán brand Viết marketing copy Project cp -r ../03-skills/brand-voice .claude/skills/
doc-generator Trình tạo tài liệu API "Generate docs", "Document API" Project cp -r ../03-skills/doc-generator .claude/skills/
refactor Refactor code có hệ thống (Martin Fowler) "Refactor this", "Clean up code" User cp -r ../03-skills/refactor ~/.claude/skills/

Phạm Vi: User = cá nhân (~/.claude/skills/), Project = chia sẻ team (.claude/skills/)

Skill Structure

~/.claude/skills/skill-name/
├── SKILL.md          # Định nghĩa & hướng dẫn skill
├── scripts/          # Scripts hỗ trợ
└── templates/        # Templates output

Skill Frontmatter Fields

Skills hỗ trợ YAML frontmatter trong SKILL.md để cấu hình:

Field Type Mô Tả
name string Tên hiển thị skill
description string Skill làm gì
autoInvoke array Cụm từ kích hoạt cho auto-invocation
effort string Mức độ effort lý luận (low, medium, high)
shell string Shell để dùng cho scripts (bash, zsh, sh)

Tham Chiếu: 03-skills/ | Tài Liệu Chính Thức

Cài Đặt Nhanh (Tất Cả Skills):

cp -r ../03-skills/* ~/.claude/skills/

Bundled Skills

Skill Mô Tả Khi Tự Động Gọi
/simplify Review code về chất lượng Sau khi viết code
/batch Chạy prompts trên nhiều files Operations hàng loạt
/debug Debug tests/errors thất bại Sessions debugging
/loop Chạy prompts theo interval Tasks định kỳ
/claude-api Xây dựng apps với Claude API Phát triển API

Plugins

Bộ sưu tập được đóng gói của commands, agents, MCP servers, và hooks.

Ví Dụ Plugins

Plugin Mô Tả Components Khi Nào Dùng Phạm Vi Cài Đặt
pr-review Workflow review PR 3 commands, 3 agents, GitHub MCP Review code Project /plugin install pr-review
devops-automation Triển khai & giám sát 4 commands, 3 agents, K8s MCP Tasks DevOps Project /plugin install devops-automation
documentation Bộ tạo tài liệu 4 commands, 3 agents, templates Tài liệu Project /plugin install documentation

Phạm Vi: Project = chia sẻ team, User = workflows cá nhân

Plugin Structure

.claude-plugin/
├── plugin.json       # File manifest
├── commands/         # Lệnh slash
├── agents/           # Tác nhân con
├── skills/           # Skills
├── mcp/              # Cấu hình MCP
├── hooks/            # Script hooks
└── scripts/          # Scripts tiện ích

Tham Chiếu: 07-plugins/ | Tài Liệu Chính Thức

Plugin Management Commands:

/plugin list              # Liệt kê plugins đã cài
/plugin install <name>    # Cài plugin
/plugin remove <name>     # Gỡ plugin
/plugin update <name>     # Cập nhật plugin

MCP Servers

Máy chủ Model Context Protocol cho truy cập công cụ và API bên ngoài.

MCP Servers Phổ Biến

Server Mô Tả Khi Nào Dùng Phạm Vi Cài Đặt
GitHub Quản lý PR, issues, code Workflows GitHub Project claude mcp add github -- npx -y @modelcontextprotocol/server-github
Database Truy vấn SQL, truy cập dữ liệu Operations database Project claude mcp add db -- npx -y @modelcontextprotocol/server-postgres
Filesystem Operations file nâng cao Tasks file phức tạp User claude mcp add fs -- npx -y @modelcontextprotocol/server-filesystem
Slack Communication team Thông báo, cập nhật Project Cấu hình trong settings
Google Docs Truy cập tài liệu Chỉnh sửa, review docs Project Cấu hình trong settings
Asana Quản lý dự án Theo dõi tasks Project Cấu hình trong settings
Stripe Dữ liệu thanh toán Phân tích tài chính Project Cấu hình trong settings
Memory Bộ nhớ lưu trữ Nhớ lại qua sessions User Cấu hình trong settings
Context7 Tài liệu thư viện Tra cứu docs cập nhật Built-in Built-in

Phạm Vi: Project = team (.mcp.json), User = cá nhân (~/.claude.json), Built-in = được cài trước

MCP Configuration Example

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

Tham Chiếu: 05-mcp/ | Tài Liệu Giao Thức MCP

Cài Đặt Nhanh (GitHub MCP):

export GITHUB_TOKEN="your_token" && claude mcp add github -- npx -y @modelcontextprotocol/server-github

Hooks

Tự động hóa dựa trên sự kiện thực thi shell commands trên các sự kiện Claude Code.

Hook Events

Event Mô Tả Khi Được Kích Hoạt Use Cases
SessionStart Session bắt đầu/tiếp tục Khởi tạo session Tasks thiết lập
InstructionsLoaded Hướng dẫn được tải CLAUDE.md hoặc file rules được tải Xử lý hướng dẫn tùy chỉnh
UserPromptSubmit Trước khi xử lý prompt User gửi tin nhắn Xác thực input
PreToolUse Trước khi thực thi tool Trước khi bất kỳ tool chạy Xác thực, logging
PermissionRequest Dialog permission được hiển thị Trước hành động nhạy cảm Flows phê duyệt tùy chỉnh
PostToolUse Sau khi tool thành công Sau khi bất kỳ tool hoàn thành Formatting, thông báo
PostToolUseFailure Thực thi tool thất bại Sau khi tool lỗi Xử lý lỗi, logging
Notification Thông báo được gửi Claude gửi thông báo Cảnh báo bên ngoài
SubagentStart Subagent được tạo Task subagent bắt đầu Khởi tạo context subagent
SubagentStop Subagent hoàn thành Task subagent hoàn tất Chuỗi hành động
Stop Claude hoàn thành phản hồi Phản hồi hoàn tất Dọn dẹp, báo cáo
StopFailure Lỗi API kết thúc turn Lỗi API xảy ra Phục hồi lỗi, logging
TeammateIdle Agent teammate rảnh Phối hợp agent team Phân phối work
TaskCompleted Task được đánh dấu hoàn tất Task xong Xử lý post-task
TaskCreated Task được tạo qua TaskCreate Task mới được tạo Theo dõi task, logging
ConfigChange Cấu hình được cập nhật Settings được sửa đổi Phản ứng thay đổi config
CwdChanged Thư mục làm việc thay đổi Thư mục thay đổi Thiết lập cụ thể theo thư mục
FileChanged File được theo dõi thay đổi File được sửa Giám sát file, rebuild
PreCompact Trước operation compact Nén context Bảo toàn trạng thái
PostCompact Sau khi compact hoàn tất Compact xong Hành động post-compact
WorktreeCreate Worktree đang được tạo Git worktree được tạo Thiết lập môi trường worktree
WorktreeRemove Worktree đang bị gỡ Git worktree bị gỡ Dọn dẹp tài nguyên worktree
Elicitation MCP server yêu cầu input MCP elicitation Xác thực input
ElicitationResult User phản hồi elicitation User phản hồi Xử lý phản hồi
SessionEnd Session chấm dứt Chấm dứt session Dọn dẹp, lưu trạng thái

Ví Dụ Hooks

Hook Mô Tả Event Phạm Vi Cài Đặt
validate-bash.py Xác thực command PreToolUse:Bash Project cp ../06-hooks/validate-bash.py .claude/hooks/
security-scan.py Quét bảo mật PostToolUse:Write Project cp ../06-hooks/security-scan.py .claude/hooks/
format-code.sh Tự động format PostToolUse:Write User cp ../06-hooks/format-code.sh ~/.claude/hooks/
validate-prompt.py Xác thực prompt UserPromptSubmit Project cp ../06-hooks/validate-prompt.py .claude/hooks/
context-tracker.py Theo dõi usage token Stop User cp ../06-hooks/context-tracker.py ~/.claude/hooks/
pre-commit.sh Xác thực pre-commit PreToolUse:Bash Project cp ../06-hooks/pre-commit.sh .claude/hooks/
log-bash.sh Ghi log commands PostToolUse:Bash User cp ../06-hooks/log-bash.sh ~/.claude/hooks/

Phạm Vi: Project = team (.claude/settings.json), User = cá nhân (~/.claude/settings.json)

Hook Configuration

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "command": "~/.claude/hooks/validate-bash.py"
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Write",
        "command": "~/.claude/hooks/format-code.sh"
      }
    ]
  }
}

Tham Chiếu: 06-hooks/ | Tài Liệu Chính Thức

Cài Đặt Nhanh (Tất Cả Hooks):

mkdir -p ~/.claude/hooks && cp ../06-hooks/*.sh ~/.claude/hooks/ && chmod +x ~/.claude/hooks/*.sh

Files Bộ Nhớ

Ngữ cảnh lưu trữ được tải tự động qua sessions.

Loại Bộ Nhớ

Loại Vị Trí Phạm Vi Khi Nào Dùng
Managed Policy Policies được quản lý bởi tổ chức Tổ chức Thực thi tiêu chuẩn toàn tổ chức
Project ./CLAUDE.md Project (team) Tiêu chuẩn team, context dự án
Project Rules .claude/rules/ Project (team) Rules dự án modular
User ~/.claude/CLAUDE.md User (cá nhân) Sở thích cá nhân
User Rules ~/.claude/rules/ User (cá nhân) Rules cá nhân modular
Local ./CLAUDE.local.md Local (git-ignored) Ghi đè cụ thể theo máy (không trong tài liệu chính thức tính đến tháng 3/2026; có thể là legacy)
Auto Memory Tự động Session Insights và chỉnh sửa được tự động nắm bắt

Phạm Vi: Organization = được quản lý bởi admins, Project = chia sẻ với team qua git, User = sở thích cá nhân, Local = không được commit, Session = được tự động quản lý

Tham Chiếu: 02-memory/ | Tài Liệu Chính Thức

Cài Đặt Nhanh:

cp ../02-memory/project-CLAUDE.md ./CLAUDE.md
cp ../02-memory/personal-CLAUDE.md ~/.claude/CLAUDE.md

Tính Năng Mới (Tháng 3 Năm 2026)

Tính Năng Mô Tả Cách Dùng
Remote Control Điều khiển sessions Claude Code từ xa qua API Sử dụng API điều khiển từ xa để gửi prompts và nhận responses theo chương trình
Web Sessions Chạy Claude Code trong môi trường dựa trên trình duyệt Truy cập qua claude web hoặc qua Anthropic Console
Desktop App Ứng dụng desktop native cho Claude Code Sử dụng /desktop hoặc tải từ website Anthropic
Agent Teams Phối hợp nhiều agents làm việc trên các tasks liên quan Cấu hình teammate agents cộng tác và chia sẻ context
Task List Quản lý và giám sát background tasks Sử dụng /tasks để xem và quản lý operations nền
Prompt Suggestions Gợi ý command nhận biết ngữ cảnh Gợi ý xuất hiện tự động dựa trên ngữ cảnh hiện tại
Git Worktrees Git worktrees bị cô lập để phát triển song song Sử dụng commands worktree để làm việc branch song song an toàn
Sandboxing Môi trường thực thi bị cô lập để an toàn Sử dụng /sandbox để bật/tắt; chạy commands trong môi trường bị hạn chế
MCP OAuth Xác thực OAuth cho MCP servers Cấu hình credentials OAuth trong settings MCP server để truy cập an toàn
MCP Tool Search Tìm kiếm và khám phá MCP tools động Sử dụng tìm kiếm tool để tìm MCP tools có sẵn qua các servers được kết nối
Scheduled Tasks Thiết lập tasks định kỳ với /loop và cron tools Sử dụng /loop 5m /command hoặc công cụ CronCreate
Chrome Integration Tự động hóa trình duyệt với headless Chromium Sử dụng flag --chrome hoặc command /chrome
Keyboard Customization Tùy chỉnh keybindings bao gồm hỗ trợ chord Sử dụng /keybindings hoặc chỉnh sửa ~/.claude/keybindings.json
Auto Mode Vận hành hoàn toàn tự động mà không cần prompts permission (Research Preview) Sử dụng --mode auto hoặc /permissions auto; Tháng 3 năm 2026
Channels Communication đa kênh (Telegram, Slack, v.v.) (Research Preview) Cấu hình plugins channels; Tháng 3 năm 2026
Voice Dictation Input giọng nói cho prompts Sử dụng icon microphone hoặc keybinding giọng nói
Agent Hook Type Hooks tạo subagent thay vì chạy shell command Đặt "type": "agent" trong cấu hình hook
Prompt Hook Type Hooks chèn văn bản prompt vào conversation Đặt "type": "prompt" trong cấu hình hook
MCP Elicitation MCP servers có thể yêu cầu input người dùng trong khi thực thi tool Xử lý qua các sự kiện hook ElicitationElicitationResult
WebSocket MCP Transport Transport dựa trên WebSocket cho kết nối MCP server Sử dụng "transport": "websocket" trong cấu hình MCP server
Plugin LSP Support Tích hợp Language Server Protocol qua plugins Cấu hình servers LSP trong plugin.json cho tính năng editor
Managed Drop-ins Cấu hình drop-ins được quản lý bởi tổ chức (v2.1.83) Được cấu hình bởi admin qua policies được quản lý; tự động áp dụng cho tất cả users

Ma Trận Tham Khảo Nhanh

Hướng Dẫn Chọn Tính Năng

Nhu Cầu Tính Năng Khuyến Nghị Tại Sao
Phím tắt nhanh Lệnh Slash Thủ công, ngay lập tức
Ngữ cảnh lưu trữ Bộ Nhớ Tự động tải
Tự động hóa phức tạp Skill Tự động gọi
Task chuyên biệt Tác Nhân Con Context bị cô lập
Dữ liệu bên ngoài MCP Server Truy cập thời gian thực
Tự động hóa sự kiện Hook Được kích hoạt bởi sự kiện
Giải pháp hoàn chỉnh Plugin Gói tất cả trong một

Ưu Tiên Cài Đặt

Ưu Tiên Tính Năng Command
1. Thiết Yếu Bộ Nhớ cp ../02-memory/project-CLAUDE.md ./CLAUDE.md
2. Dùng Hàng Ngày Lệnh Slash cp ../01-slash-commands/*.md .claude/commands/
3. Chất Lượng Tác Nhân Con cp ../04-subagents/*.md .claude/agents/
4. Tự Động Hóa Hooks cp ../06-hooks/*.sh ~/.claude/hooks/ && chmod +x ~/.claude/hooks/*.sh
5. Bên Ngoài MCP claude mcp add github -- npx -y @modelcontextprotocol/server-github
6. Nâng Cao Skills cp -r ../03-skills/* ~/.claude/skills/
7. Hoàn Chỉnh Plugins /plugin install pr-review

Cài Đặt Một Lệnh Hoàn Chỉnh

Cài đặt tất cả ví dụ từ repository này:

# Tạo thư mục
mkdir -p .claude/{commands,agents,skills} ~/.claude/{hooks,skills}

# Cài đặt tất cả tính năng
cp ../01-slash-commands/*.md .claude/commands/ && \
cp ../02-memory/project-CLAUDE.md ./CLAUDE.md && \
cp -r ../03-skills/* ~/.claude/skills/ && \
cp ../04-subagents/*.md .claude/agents/ && \
cp ../06-hooks/*.sh ~/.claude/hooks/ && \
chmod +x ~/.claude/hooks/*.sh

Tài Nguyên Thêm


Cập Nhật Lần: Tháng 3 năm 2026