github-code/claude-howto
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Files
553a31993417ecbeacccb55a2564d9d54130ba11
claude-howto/vi/QUICK_REFERENCE.md
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

507 lines
16 KiB
Markdown
Raw Blame History

<picture>
<source media="(prefers-color-scheme: dark)" srcset="../resources/logos/claude-howto-logo-dark.svg">
<img alt="Claude How To" src="../resources/logos/claude-howto-logo.svg">
</picture>
# Ví Dụ Claude Code - Tham Khảo Nhanh
## 🚀 Lệnh Cài Đặt Nhanh
### Lệnh Slash
```bash
# Cài đặt tất cả
cp 01-slash-commands/*.md .claude/commands/
# Cài đặt cụ thể
cp 01-slash-commands/optimize.md .claude/commands/
```
### Bộ Nhớ
```bash
# Bộ nhớ dự án
cp 02-memory/project-CLAUDE.md ./CLAUDE.md
# Bộ nhớ cá nhân
cp 02-memory/personal-CLAUDE.md ~/.claude/CLAUDE.md
```
### Skills
```bash
# Skills cá nhân
cp -r 03-skills/code-review ~/.claude/skills/
# Skills dự án
cp -r 03-skills/code-review .claude/skills/
```
### Tác Nhân Con
```bash
# Cài đặt tất cả
cp 04-subagents/*.md .claude/agents/
# Cài đặt cụ thể
cp 04-subagents/code-reviewer.md .claude/agents/
```
### MCP
```bash
# Thiết lập thông tin xác thực
export GITHUB_TOKEN="your_token"
export DATABASE_URL="postgresql://..."
# Cài đặt cấu hình (phạm vi dự án)
cp 05-mcp/github-mcp.json .mcp.json
# Hoặc phạm vi người dùng: thêm vào ~/.claude.json
```
### Hooks
```bash
# Cài đặt hooks
mkdir -p ~/.claude/hooks
cp 06-hooks/*.sh ~/.claude/hooks/
chmod +x ~/.claude/hooks/*.sh
# Cấu hình trong settings (~/.claude/settings.json)
```
### Plugins
```bash
# Cài đặt từ ví dụ (nếu đã xuất bản)
/plugin install pr-review
/plugin install devops-automation
/plugin install documentation
```
### Checkpoints
```bash
# Checkpoints được tạo tự động với mọi prompt của người dùng
# Để quay lại, nhấn Esc hai lần hoặc sử dụng:
/rewind
# Sau đó chọn: Khôi phục code và cuộc hội thoại, Khôi phục cuộc hội thoại,
# Khôi phục code, Tóm tắt từ đây, hoặc Thôi
```
### Tính Năng Nâng Cao
```bash
# Cấu hình trong settings (.claude/settings.json)
# Xem 09-advanced-features/config-examples.json
# Chế độ lập kế hoạch
/plan Mô tả tác vụ
# Chế độ quyền (sử dụng cờ --permission-mode)
# default - Hỏi phê duyệt cho các hành động rủi ro
# acceptEdits - Tự động chấp nhận chỉnh sửa file, hỏi cho các hành động khác
# plan - Chỉ đọc phân tích, không sửa đổi
# dontAsk - Chấp nhận tất cả hành động trừ các hành động rủi ro
# auto - Bộ phân loại nền quyết định quyền tự động
# bypassPermissions - Chấp nhận tất cả hành động (yêu cầu --dangerously-skip-permissions)
# Quản lý phiên
/resume # Tiếp tục cuộc hội thoại trước
/rename "name" # Đặt tên cho phiên hiện tại
/fork # Fork phiên hiện tại
claude -c # Tiếp tục cuộc hội thoại gần nhất
claude -r "session" # Tiếp tục phiên theo tên/ID
```
---
## 📋 Bảng Cheat Sheet Tính Năng
| Tính Năng | Đường Dẫn Cài Đặt | Cách Sử Dụng |
|---------|-------------|-------|
| **Lệnh Slash (55+)** | `.claude/commands/*.md` | `/tên-lệnh` |
| **Bộ Nhớ** | `./CLAUDE.md` | Tự động tải |
| **Skills** | `.claude/skills/*/SKILL.md` | Tự động gọi |
| **Tác Nhân Con** | `.claude/agents/*.md` | Tự động ủy quyền |
| **MCP** | `.mcp.json` (dự án) hoặc `~/.claude.json` (người dùng) | `/mcp__server__action` |
| **Hooks (25 sự kiện)** | `~/.claude/hooks/*.sh` | Kích hoạt sự kiện (4 loại) |
| **Plugins** | Thông qua `/plugin install` | Gói tất cả |
| **Checkpoints** | Được tích hợp sẵn | `Esc+Esc` hoặc `/rewind` |
| **Chế Độ Lập Kế Hoạch** | Được tích hợp sẵn | `/plan <tác vụ>` |
| **Chế Độ Quyền (6)** | Được tích hợp sẵn | `--allowedTools`, `--permission-mode` |
| **Phiên Làm Việc** | Được tích hợp sẵn | `/session <lệnh>` |
| **Tác Vụ Nền** | Được tích hợp sẵn | Chạy trong nền |
| **Điều Khiển Từ Xa** | Được tích hợp sẵn | WebSocket API |
| **Phiên Web** | Được tích hợp sẵn | `claude web` |
| **Git Worktrees** | Được tích hợp sẵn | `/worktree` |
| **Tự Động Bộ Nhớ** | Được tích hợp sẵn | Tự động lưu vào CLAUDE.md |
| **Danh Sách Tác Vụ** | Được tích hợp sẵn | `/task list` |
| **Skills Được Gói (5)** | Được tích hợp sẵn | `/simplify`, `/loop`, `/claude-api`, `/voice`, `/browse` |
---
## 🎯 Trường Hợp Sử Dụng Phổ Biến
### Review Code
```bash
# Cách 1: Lệnh slash
cp 01-slash-commands/optimize.md .claude/commands/
# Sử dụng: /optimize
# Cách 2: Tác nhân con
cp 04-subagents/code-reviewer.md .claude/agents/
# Sử dụng: Tự động ủy quyền
# Cách 3: Skill
cp -r 03-skills/code-review ~/.claude/skills/
# Sử dụng: Tự động gọi
# Cách 4: Plugin (tốt nhất)
/plugin install pr-review
# Sử dụng: /review-pr
```
### Tài Liệu
```bash
# Lệnh slash
cp 01-slash-commands/generate-api-docs.md .claude/commands/
# Tác nhân con
cp 04-subagents/documentation-writer.md .claude/agents/
# Skill
cp -r 03-skills/doc-generator ~/.claude/skills/
# Plugin (giải pháp hoàn chỉnh)
/plugin install documentation
```
### DevOps
```bash
# Plugin hoàn chỉnh
/plugin install devops-automation
# Lệnh: /deploy, /rollback, /status, /incident
```
### Tiêu Chuẩn Đội
```bash
# Bộ nhớ dự án
cp 02-memory/project-CLAUDE.md ./CLAUDE.md
# Chỉnh sửa cho đội của bạn
vim CLAUDE.md
```
### Tự Động Hóa & Hooks
```bash
# Cài đặt hooks (25 sự kiện, 4 loại: command, http, prompt, agent)
mkdir -p ~/.claude/hooks
cp 06-hooks/*.sh ~/.claude/hooks/
chmod +x ~/.claude/hooks/*.sh
# Ví dụ:
# - Tests pre-commit: pre-commit.sh
# - Tự động định dạng code: format-code.sh
# - Quét bảo mật: security-scan.sh
# Chế độ Tự Động cho workflow hoàn toàn tự chủ
claude --enable-auto-mode -p "Refactor và test module auth"
# Hoặc chuyển đổi chế độ tương tác với Shift+Tab
```
### Refactor An Toàn
```bash
# Checkpoints được tạo tự động trước mỗi prompt
# Thử refactoring
# Nếu thành công: tiếp tục
# Nếu thất bại: nhấn Esc+Esc hoặc sử dụng /rewind để quay lại
```
### Triển Khai Phức Tạp
```bash
# Sử dụng chế độ lập kế hoạch
/plan Triển khai hệ thống xác thực người dùng
# Claude tạo kế hoạch chi tiết
# Xem xét và phê duyệt
# Claude triển khai có hệ thống
```
### Tích Hợp CI/CD
```bash
# Chạy ở chế độ headless (không tương tác)
claude -p "Chạy tất cả tests và tạo báo cáo"
# Với chế độ quyền cho CI
claude -p "Chạy tests" --permission-mode dontAsk
# Với Chế độ Tự Động cho tác vụ CI hoàn toàn tự chủ
claude --enable-auto-mode -p "Chạy tests và sửa lỗi thất bại"
# Với hooks để tự động hóa
# Xem 09-advanced-features/README.md
```
### Học & Thử Nghiệm
```bash
# Sử dụng chế độ kế hoạch để phân tích an toàn
claude --permission-mode plan
# Thử nghiệm an toàn - checkpoints được tạo tự động
# Nếu cần quay lại: nhấn Esc+Esc hoặc sử dụng /rewind
```
### Đội Tác Nhân
```bash
# Bật đội tác nhân
export CLAUDE_AGENT_TEAMS=1
# Hoặc trong settings.json
{ "agentTeams": { "enabled": true } }
# Bắt đầu với: "Triển khai tính năng X sử dụng cách tiếp cận đội"
```
### Tác Vụ Định Kỳ
```bash
# Chạy một lệnh mỗi 5 phút
/loop 5m /check-status
# Nhắc nhở một lần
/loop 30m "nhắc tôi kiểm tra deploy"
```
---
## 📁 Tham Khảo Vị Trí File
```
Dự Án Của Bạn/
├── .claude/
│ ├── commands/ # Lệnh slash đặt ở đây
│ ├── agents/ # Tác nhân con đặt ở đây
│ ├── skills/ # Skills dự án đặt ở đây
│ └── settings.json # Cài đặt dự án (hooks, v.v.)
├── .mcp.json # Cấu hình MCP (phạm vi dự án)
├── CLAUDE.md # Bộ nhớ dự án
└── src/
└── api/
└── CLAUDE.md # Bộ nhớ cụ thể thư mục
Home Người Dùng/
├── .claude/
│ ├── commands/ # Lệnh cá nhân
│ ├── agents/ # Tác nhân cá nhân
│ ├── skills/ # Skills cá nhân
│ ├── hooks/ # Script hooks
│ ├── settings.json # Cài đặt người dùng
│ ├── managed-settings.d/ # Cài đặt được quản lý (doanh nghiệp/tổ chức)
│ └── CLAUDE.md # Bộ nhớ cá nhân
└── .claude.json # Cấu hình MCP cá nhân (phạm vi người dùng)
```
---
## 🔍 Tìm Ví Dụ
### Theo Danh Mục
- **Lệnh Slash**: `01-slash-commands/`
- **Bộ Nhớ**: `02-memory/`
- **Skills**: `03-skills/`
- **Tác Nhân Con**: `04-subagents/`
- **MCP**: `05-mcp/`
- **Hooks**: `06-hooks/`
- **Plugins**: `07-plugins/`
- **Checkpoints**: `08-checkpoints/`
- **Tính Năng Nâng Cao**: `09-advanced-features/`
- **CLI**: `10-cli/`
### Theo Trường Hợp Sử Dụng
- **Hiệu Suất**: `01-slash-commands/optimize.md`
- **Bảo Mật**: `04-subagents/secure-reviewer.md`
- **Testing**: `04-subagents/test-engineer.md`
- **Tài Liệu**: `03-skills/doc-generator/`
- **DevOps**: `07-plugins/devops-automation/`
### Theo Độ Phức Tạp
- **Đơn Giản**: Lệnh slash
- **Trung Bình**: Tác nhân con, Bộ nhớ
- **Nâng Cao**: Skills, Hooks
- **Hoàn Chỉnh**: Plugins
---
## 🎓 Lộ Trình Học
### Ngày 1
```bash
# Đọc tổng quan
cat README.md
# Cài đặt một lệnh
cp 01-slash-commands/optimize.md .claude/commands/
# Thử dùng
/optimize
```
### Ngày 2-3
```bash
# Thiết lập bộ nhớ
cp 02-memory/project-CLAUDE.md ./CLAUDE.md
vim CLAUDE.md
# Cài đặt tác nhân con
cp 04-subagents/code-reviewer.md .claude/agents/
```
### Ngày 4-5
```bash
# Thiết lập MCP
export GITHUB_TOKEN="your_token"
cp 05-mcp/github-mcp.json .mcp.json
# Thử lệnh MCP
/mcp__github__list_prs
```
### Tuần 2
```bash
# Cài đặt skill
cp -r 03-skills/code-review ~/.claude/skills/
# Để nó tự động gọi
# Chỉ cần nói: "Review đoạn code này tìm lỗi"
```
### Tuần 3+
```bash
# Cài đặt plugin hoàn chỉnh
/plugin install pr-review
# Sử dụng tính năng được gói
/review-pr
/check-security
/check-tests
```
---
## Tính Năng Mới (Tháng 3/2026)
| Tính Năng | Mô Tả | Cách Sử Dụng |
|---------|-------------|-------|
| **Chế Độ Tự Động** | Vận hành hoàn toàn tự chủ với bộ phân loại nền | Cờ `--enable-auto-mode`, `Shift+Tab` để chuyển đổi chế độ |
| **Kênh** | Tích hợp Discord và Telegram | Cờ `--channels`, bot Discord/Telegram |
| **Nhập Liệu Giọng Nói** | Nói lệnh và bối cảnh cho Claude | Lệnh `/voice` |
| **Hooks (25 sự kiện)** | Hệ thống hook mở rộng với 4 loại | Các loại hook command, http, prompt, agent |
| **MCP Elicitation** | MCP servers có thể yêu cầu input người dùng tại runtime | Tự động nhắc khi server cần làm rõ |
| **WebSocket MCP** | Vận chuyển WebSocket cho kết nối MCP | Cấu hình trong `.mcp.json` với URL `ws://` |
| **Plugin LSP** | Hỗ trợ Language Server Protocol cho plugins | `userConfig`, biến `${CLAUDE_PLUGIN_DATA}` |
| **Điều Khiển Từ Xa** | Điều khiển Claude Code qua WebSocket API | `claude --remote` cho tích hợp bên ngoài |
| **Phiên Web** | Giao diện Claude Code trên trình duyệt | `claude web` để khởi động |
| **Ứng Dụng Desktop** | Ứng dụng desktop native | Tải từ claude.ai/download |
| **Danh Sách Tác Vụ** | Quản lý tác vụ nền | `/task list`, `/task status <id>` |
| **Tự Động Bộ Nhớ** | Tự động lưu bộ nhớ từ cuộc hội thoại | Claude tự động lưu bối cảnh chính vào CLAUDE.md |
| **Git Worktrees** | Không gian làm việc cô lập cho phát triển song song | `/worktree` để tạo không gian làm việc cô lập |
| **Chọn Mô Hình** | Chuyển đổi giữa Sonnet 4.6 và Opus 4.6 | `/model` hoặc cờ `--model` |
| **Đội Tác Nhân** | Phối hợp nhiều tác nhân trên tác vụ | Bật với biến môi trường `CLAUDE_AGENT_TEAMS=1` |
| **Tác Vụ Định Kỳ** | Tác vụ định kỳ với `/loop` | `/loop 5m /command` hoặc công cụ CronCreate |
| **Tích Hợp Chrome** | Tự động hóa trình duyệt | Cờ `--chrome` hoặc lệnh `/chrome` |
| **Tùy Chỉnh Bàn Phím** | Phím tắt tùy chỉnh | Lệnh `/keybindings` |
---
## Mẹo & Thủ Thuật
### Tùy Chỉnh
- Bắt đầu với ví dụ nguyên trạng
- Chỉnh sửa phù hợp nhu cầu của bạn
- Thử nghiệm trước khi chia sẻ với đội
- Sử dụng version control cho cấu hình của bạn
### Thực Hành Tốt Nhất
- Sử dụng bộ nhớ cho tiêu chuẩn đội
- Sử dụng plugins cho workflow hoàn chỉnh
- Sử dụng tác nhân con cho tác vụ phức tạp
- Sử dụng lệnh slash cho tác vụ nhanh
### Xử Lý Sự Cố
```bash
# Kiểm tra vị trí file
ls -la .claude/commands/
ls -la .claude/agents/
# Xác minh cú pháp YAML
head -20 .claude/agents/code-reviewer.md
# Kiểm tra kết nối MCP
echo $GITHUB_TOKEN
```
---
## 📊 Ma Trận Tính Năng
| Nhu Cầu | Sử Dụng Cái Này | Ví Dụ |
|------|----------|---------|
| Lối tắt nhanh | Lệnh Slash (55+) | `01-slash-commands/optimize.md` |
| Tiêu chuẩn đội | Bộ Nhớ | `02-memory/project-CLAUDE.md` |
| Workflow tự động | Skill | `03-skills/code-review/` |
| Tác vụ chuyên biệt | Tác Nhân Con | `04-subagents/code-reviewer.md` |
| Dữ liệu bên ngoài | MCP (+ Elicitation, WebSocket) | `05-mcp/github-mcp.json` |
| Tự động hóa sự kiện | Hook (25 sự kiện, 4 loại) | `06-hooks/pre-commit.sh` |
| Giải pháp hoàn chỉnh | Plugin (+ hỗ trợ LSP) | `07-plugins/pr-review/` |
| Thử nghiệm an toàn | Checkpoint | `08-checkpoints/checkpoint-examples.md` |
| Hoàn toàn tự chủ | Chế Độ Tự Động | `--enable-auto-mode` hoặc `Shift+Tab` |
| Tích hợp chat | Kênh | `--channels` (Discord, Telegram) |
| Pipeline CI/CD | CLI | `10-cli/README.md` |
---
## 🔗 Liên Kết Nhanh
- **Hướng Dẫn Chính**: `README.md`
- **Index Hoàn Chỉnh**: `INDEX.md`
- **Tóm Tắt**: `EXAMPLES_SUMMARY.md`
- **Hướng Dẫn Gốc**: `claude_concepts_guide.md`
---
## 📞 Câu Hỏi Phổ Biến
**Câu: Tôi nên dùng cái nào?**
Đáp: Bắt đầu với lệnh slash, thêm tính năng khi cần.
**Câu: Tôi có thể kết hợp tính năng không?**
Đáp: Có! Chúng hoạt động cùng nhau. Bộ Nhớ + Lệnh + MCP = mạnh mẽ.
**Câu: Làm sao chia sẻ với đội?**
Đáp: Commit thư mục `.claude/` vào git.
**Câu: Còn bí mật thì sao?**
Đáp: Sử dụng biến môi trường, không bao giờ hardcode.
**Câu: Tôi có thể sửa ví dụ không?**
Đáp: Chắc chắn rồi! Chúng là mẫu để tùy chỉnh.
---
## ✅ Checklist
Checklist bắt đầu:
- [ ] Đọc `README.md`
- [ ] Cài đặt 1 lệnh slash
- [ ] Thử lệnh đó
- [ ] Tạo `CLAUDE.md` dự án
- [ ] Cài đặt 1 tác nhân con
- [ ] Thiết lập 1 tích hợp MCP
- [ ] Cài đặt 1 skill
- [ ] Thử một plugin hoàn chỉnh
- [ ] Tùy chỉnh cho nhu cầu của bạn
- [ ] Chia sẻ với đội
---
**Bắt Đầu Nhanh**: `cat README.md`
**Index Hoàn Chỉnh**: `cat INDEX.md`
**Tham Khảo Này**: Giữ sẵn để tham khảo nhanh!
Reference in New Issue View Git Blame Copy Permalink