docs: sync to Claude Code v2.1.233 (#168)

* docs: sync to Claude Code v2.1.233

Bring the tutorial from the v2.1.220 baseline up to v2.1.233 (13 releases)
per update-plan-2026-08-15.md.

Corrections:
- Remove /ultraplan (removed in v2.1.222); point at plan mode instead
- Drop the 200-subagent-per-session cap and CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION
  (cap removed in v2.1.224)
- Note TaskCompleted/TaskCreated only fire when todo tools are enabled

Updates:
- /review documented as an alias of /code-review (v2.1.223)
- fork subagents default to interactive (v2.1.232)
- ultrareview v2.1.227 floor, --post/--no-post
- GitLab MR support for -w/--worktree and Agent View

New sections:
- Cross-session messaging (ListAgents, SendMessage, crossSessionInbound)
- Sandbox credential masking (v2.1.221, v2.1.224)
- Trust and permission scoping
- archive and command plugin sources, conditional plugin activation
- claude self-hosted-runner, 7 new env vars

Translations (vi/ja/zh/uk) mirrored where the corresponding pages exist.
Every modified file carries the 2.1.233 metadata footer; files already at
2.1.220 with no content change were left alone.

* docs: address review findings from the v2.1.233 sync

- Mirror the /review alias correction (v2.1.223) into vi/ja/uk/zh
  01-slash-commands: add the live alias row, drop the stale row from the
  deprecated table, and rewrite the history bullet. All four still called
  /review deprecated in favour of a code-review plugin while carrying a
  2.1.233 stamp.
- Rewrite the 10-cli CLAUDE_CODE_FORK_SUBAGENT row to agree with
  04-subagents: fork mode is on by default in interactive sessions on every
  build since v2.1.232; the variable enables it where it is off by default.
- Remove a stray blank line that split the 10-cli environment-variable
  table, leaving the seven new v2.1.221-v2.1.233 rows without a delimiter
  row and rendering them as literal pipe text.
- Add the todo-tools caveat to the TaskCompleted row alongside TaskCreated
  in claude_concepts_guide, uk/ja concepts guides, and the uk/vi/zh/ja
  CATALOGs.
- Fix the ja 07-plugins and 09-advanced-features footers, which paired a
  2.1.233 version stamp with an April 24 last-updated date.

* docs(subagents): correct the stale fork-subagent claim in ja pages (#171)

ja/10-cli and ja/04-subagents both stated that CLAUDE_CODE_FORK_SUBAGENT
only enables forked subagents on external builds (Bedrock, Vertex,
Foundry) with no effect on the Anthropic API. That was true at v2.1.117
but has been wrong since v2.1.232: fork mode is on by default in
interactive sessions on every build, first-party or not, and the variable
now turns it on where it is off by default (claude -p, the Agent SDK, or
Claude Code older than v2.1.232).

Both pages remain stamped 2.1.119 on purpose. Only the individual claim
was verified and corrected; bumping the page stamp would assert a
whole-page verification that has not been done. Do not bump these stamps
without a full resync of the pages.

vi/01-slash-commands/README.md

@@ -66,12 +66,12 @@ Lệnh tích hợp sẵn là các lối tắt cho các hành động phổ biế
 | `/powerup` | Khám phá tính năng thông qua các bài học tương tác với demo hoạt hình |
 | `/privacy-settings` | Cài đặt quyền riêng tư (chỉ Pro/Max) |
 | `/release-notes` | Xem changelog |
-| `/reload-plugins` | Tải lại các plugins hoạt động |
+| `/reload-plugins` | Tải lại các plugins hoạt động. Từ v2.1.221, hầu hết các lần cài đặt đều kích hoạt ngay, nên chỉ cần lệnh này khi bản tóm tắt cài đặt hiển thị `Run /reload-plugins to activate.` |
 | `/remote-control` | Điều khiển từ xa từ claude.ai (bí danh: `/rc`) |
 | `/remote-env` | Cấu hình môi trường từ xa mặc định |
 | `/rename [name]` | Đổi tên phiên |
 | `/resume [session]` | Tiếp tục cuộc hội thoại (bí danh: `/continue`) |
-| `/review` | **Đã lỗi thời** — cài đặt plugin `code-review` thay thế |
+| `/review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | Bí danh của `/code-review` (v2.1.223): review diff hiện tại, hoặc số PR, nhánh, hay đường dẫn bạn truyền vào — ví dụ `/review 1234`. Nhận cùng các mức effort và flags. Nếu không chỉ định mức, nó dùng lại mức `low`–`max` bạn đã gõ lần trước |
 | `/rewind` | Quay lại cuộc hội thoại và/hoặc code (bí danh: `/checkpoint`) |
 | `/sandbox` | Bật/tắt chế độ sandbox |
 | `/schedule [description]` | Tạo/quản lý các tác vụ định kỳ |
@@ -84,7 +84,6 @@ Lệnh tích hợp sẵn là các lối tắt cho các hành động phổ biế
 | `/tasks` | Liệt kê/quản lý các tác vụ nền |
 | `/terminal-setup` | Cấu hình terminal keybindings |
 | `/theme` | Thay đổi chủ đề màu |
-| `/ultraplan <prompt>` | Soạn kế hoạch trong ultraplan session, xem trong trình duyệt |
 | `/upgrade` | Mở trang nâng cấp cho tier cao hơn |
 | `/voice` | Bật/tắt nhập liệu giọng nói push-to-talk |
 
@@ -104,7 +103,6 @@ Những skills này được gửi kèm với Claude Code và được gọi nh
 
 | Lệnh | Trạng Thái |
 |---------|--------|
-| `/review` | Đã lỗi thời — được thay thế bởi plugin `code-review` |
 | `/output-style` | Đã xóa trong v2.1.91 (lỗi thời từ v2.1.73) — dùng `/config` → Output style, hoặc setting `outputStyle` |
 | `/pr-comments` | Đã xóa trong v2.1.91 — hỏi Claude trực tiếp để xem bình luận PR |
 | `/vim` | Đã xóa trong v2.1.92 — sử dụng /config → Editor mode |
@@ -113,14 +111,14 @@ Những skills này được gửi kèm với Claude Code và được gọi nh
 
 - `/fork` và `/subtask` hoán đổi vai trò trong **v2.1.212**. `/fork` giờ sao chép cuộc hội thoại thành một phiên nền độc lập mới; hành vi subagent-được-fork mà nó từng có đã chuyển sang lệnh mới `/subtask`. Lịch sử: `/fork` là bí danh của `/branch` từ v2.1.77 đến v2.1.161; từ v2.1.161 đến v2.1.211 nó khởi chạy một subagent được fork (việc mà `/subtask` làm bây giờ). Khi tắt agent view, `/subtask` không khả dụng và `/fork` giữ hành vi subagent-được-fork
 - `/output-style` đã lỗi thời (v2.1.73) và bị xóa (v2.1.91) — output styles vẫn có sẵn qua `/config` → Output style hoặc setting `outputStyle`; các bản tích hợp sẵn là Default, Proactive, Explanatory, và Learning
-- `/review` đã lỗi thời thay vào đó là plugin `code-review`
+- `/review` trở thành bí danh đầy đủ của `/code-review` — cùng target, mức effort và flags (v2.1.223). Lịch sử: ban đầu nó chuyển sang engine `/code-review medium` trong v2.1.186 nhưng vẫn chỉ dùng cho PR
 - Lệnh `/effort` được thêm với mức `max` yêu cầu Opus 4.6
 - Lệnh `/voice` được thêm cho nhập liệu giọng nói push-to-talk
 - Lệnh `/schedule` được thêm để tạo/quản lý các tác vụ định kỳ
 - Lệnh `/color` được thêm để tùy chỉnh thanh prompt
 - `/pr-comments` đã xóa trong v2.1.91 — hỏi Claude trực tiếp để xem bình luận PR
 - `/vim` đã xóa trong v2.1.92 — sử dụng /config → Editor mode thay thế
-- `/ultraplan` được thêm để xem và thực thi kế hoạch trong trình duyệt
+- `/ultraplan` đã bị gỡ bỏ trong v2.1.222 — hãy dùng plan mode thay thế
 - `/powerup` được thêm để học tính năng tương tác
 - `/sandbox` được thêm để bật/tắt chế độ sandbox
 - Bộ chọn `/model` hiện hiển thị nhãn dễ đọc cho con người (ví dụ: "Sonnet 4.6") thay vì ID mô hình thô
@@ -559,8 +557,10 @@ Nếu cả hai tồn tại với cùng tên, **skill sẽ được ưu tiên**.
 
 ---
 
-**Cập Nhật Lần Cuối**: Tháng 4 năm 2026
-**Phiên Bản Claude Code**: 2.1+
+**Cập Nhật Lần Cuối**: Ngày 15 tháng 8 năm 2026
+**Phiên Bản Claude Code**: 2.1.233
+**Nguồn**:
+- https://code.claude.com/docs/en/commands
 **Các Mô Hình Tương Thích**: Claude Sonnet 4.6, Claude Opus 4.6, Claude Haiku 4.5
 
 *Phần của series hướng dẫn [Claude How To](../)*

vi/06-hooks/README.md

@@ -201,6 +201,8 @@ Claude Code hỗ trợ **31 sự kiện hook**:
 | **ElicitationResult** | Người dùng phản hồi elicitation | (none) | Có | Xử lý phản hồi |
 | **SessionEnd** | Phiên kết thúc | (none) | Không | Dọn dẹp, logging cuối |
 
+> **`TaskCreated` và `TaskCompleted` cần bật todo tools (v2.1.233).** Hai sự kiện này phát ra từ các todo/task-tracking tools (`TaskCreate`/`Get`/`Update`/`List`, `TodoWrite`), vốn **không còn khả dụng trên Opus 4.8, Sonnet 5, Fable 5, Mythos 5 và các model mới hơn**. Trên các model đó, hook vẫn là cấu hình hợp lệ nhưng đơn giản là không bao giờ chạy — không có output và cũng không có lỗi. Đặt `CLAUDE_CODE_ENABLE_TODO_TOOLS=1` để khôi phục.
+
 ### PreToolUse
 
 Chạy sau khi Claude tạo tham số công cụ và trước khi xử lý. Sử dụng điều này để xác thực hoặc sửa đổi đầu vào công cụ.
@@ -864,6 +866,8 @@ Chỉnh sửa `~/.claude/settings.json` hoặc `.claude/settings.json` với c
 
 ---
 
-**Cập Nhật Lần Cuối**: Tháng 4 năm 2026
-**Phiên Bản Claude Code**: 2.1+
+**Cập Nhật Lần Cuối**: Ngày 15 tháng 8 năm 2026
+**Phiên Bản Claude Code**: 2.1.233
+**Nguồn**:
+- https://code.claude.com/docs/en/hooks
 **Các Mô Hình Tương Thích**: Claude Sonnet 4.6, Claude Opus 4.6, Claude Haiku 4.5

vi/07-plugins/README.md

@@ -457,6 +457,10 @@ Người dùng enterprise và nâng cao có thể kiểm soát hành vi marketpl
 | `strictKnownMarketplaces` | Kiểm soát marketplace nào người dùng được phép thêm |
 | `deniedPlugins` | Blocklist do quản trị viên quản lý để ngăn cài đặt các plugin cụ thể |
 
+> **Bí danh thân thiện hơn (v2.1.232)**: `additionalMarketplaces` được chấp nhận như bí danh của `extraKnownMarketplaces`, và `allowedMarketplaces` của `strictKnownMarketplaces`. **Nguồn changelog** — changelog v2.1.232 công bố chúng, nhưng trang settings chính thức chưa liệt kê. Các khóa chuẩn vẫn an toàn để tiếp tục dùng.
+
+> **Ký tự đại diện theo owner (v2.1.223+)**: một mục `"owner/*"` cho phép hoặc chặn mọi repo marketplace thuộc một owner GitHub. **Chỉ được chấp nhận trong `strictKnownMarketplaces` và `blockedMarketplaces`.** Ở mọi nơi khác dùng nguồn `github` — kể cả `extraKnownMarketplaces` và `/plugin marketplace add` — giá trị `repo` phải chỉ đúng một repository.
+
 ### Các Tính Năng Marketplace Thêm / Additional Marketplace Features
 
 - **Git timeout mặc định**: Tăng từ 30s lên 120s cho các repository plugin lớn
@@ -616,6 +620,15 @@ claude plugin validate                       # Xác thực cấu trúc plugin
 claude plugin install plugin-name@marketplace-name
 ```
 
+**Có hiệu lực ngay không?** Từ **v2.1.221**, thường là có — hãy đọc dòng cuối của bản tóm tắt cài đặt:
+
+| Bản tóm tắt cài đặt hiển thị | Ý nghĩa |
+|---|---|
+| `Plugin is now active.` | Claude Code đã kích hoạt plugin ngay trong quá trình cài đặt. Không cần làm gì thêm. |
+| `Run /reload-plugins to activate.` | Plugin đã được cài nhưng chưa hoạt động — hoặc vì việc kích hoạt sẽ làm mất hiệu lực prompt cache, hoặc vì lần kích hoạt đã thất bại. |
+
+Trước v2.1.221, không lần cài đặt nào có hiệu lực trong phiên hiện tại cho đến khi bạn chạy `/reload-plugins` hoặc khởi động lại.
+
 ### Kích Hoạt / Vô Hiệu Hóa (với phạm vi tự phát hiện)
 ```bash
 /plugin enable plugin-name
@@ -701,6 +714,10 @@ Các quản trị viên có thể kiểm soát hành vi plugin trên một tổ
 | `strictKnownMarketplaces` | Hạn chế marketplace nào người dùng được phép thêm |
 | `allowedChannelPlugins` | Kiểm soát plugins nào được phép theo kênh phát hành |
 
+> **Bí danh thân thiện hơn (v2.1.232)**: `additionalMarketplaces` được chấp nhận như bí danh của `extraKnownMarketplaces`, và `allowedMarketplaces` của `strictKnownMarketplaces`. **Nguồn changelog** — changelog v2.1.232 công bố chúng, nhưng trang settings chính thức chưa liệt kê. Các khóa chuẩn vẫn an toàn để tiếp tục dùng.
+
+> **Ký tự đại diện theo owner (v2.1.223+)**: một mục `"owner/*"` cho phép hoặc chặn mọi repo marketplace thuộc một owner GitHub. **Chỉ được chấp nhận trong `strictKnownMarketplaces` và `blockedMarketplaces`.** Ở mọi nơi khác dùng nguồn `github` — kể cả `extraKnownMarketplaces` và `/plugin marketplace add` — giá trị `repo` phải chỉ đúng một repository.
+
 Các cài đặt này có thể được áp dụng ở cấp tổ chức qua các file cấu hình được quản lý và có ưu tiên hơn các cài đặt cấp người dùng.
 
 ## Bảo Mật Plugin / Plugin Security
@@ -944,6 +961,9 @@ Các tính năng Claude Code sau hoạt động cùng với plugins:
 
 ---
 
-**Cập Nhật Lần Cuối**: Tháng 4 năm 2026
-**Phiên Bản Claude Code**: 2.1+
+**Cập Nhật Lần Cuối**: Ngày 15 tháng 8 năm 2026
+**Phiên Bản Claude Code**: 2.1.233
+**Nguồn**:
+- https://code.claude.com/docs/en/discover-plugins
+- https://code.claude.com/docs/en/settings
 **Các Mô Hình Tương Thích**: Claude Sonnet 4.6, Claude Opus 4.6, Claude Haiku 4.5

vi/CATALOG.md

@@ -65,7 +65,7 @@ Commands là các lệnh tắt do người dùng gọi thực hiện các hành
 | `/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 |
+| `/reload-plugins` | Tải lại plugins đã cài đặt. Từ v2.1.221, hầu hết các lần cài đặt kích hoạt ngay; chỉ cần khi bản tóm tắt cài đặt hiển thị `Run /reload-plugins to activate.` | 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 |
@@ -344,8 +344,8 @@ Tự động hóa dựa trên sự kiện thực thi shell commands trên các s
 | `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 |
+| `TaskCompleted` | Task được đánh dấu hoàn tất (chỉ phát ra khi bật todo tools — tắt mặc định trên Opus 4.8, Sonnet 5, Fable 5, Mythos 5 và mới hơn; `CLAUDE_CODE_ENABLE_TODO_TOOLS=1` khôi phục) | Task xong | Xử lý post-task |
+| `TaskCreated` | Task được tạo qua TaskCreate (chỉ phát ra khi bật todo tools — tắt mặc định trên Opus 4.8, Sonnet 5, Fable 5, Mythos 5 và mới hơn; `CLAUDE_CODE_ENABLE_TODO_TOOLS=1` khôi phục) | 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 |
@@ -514,4 +514,8 @@ chmod +x ~/.claude/hooks/*.sh
 
 ---
 
-**Cập Nhật Lần**: Tháng 3 năm 2026
+**Cập Nhật Lần Cuối**: Ngày 15 tháng 8 năm 2026
+**Phiên Bản Claude Code**: 2.1.233
+**Nguồn**:
+- https://code.claude.com/docs/en/commands
+- https://code.claude.com/docs/en/hooks

vi/INDEX.md

@@ -223,7 +223,7 @@ Các script tự động hóa dựa trên sự kiện thực thi tự động.
 **Hook Events** (31, trong 4 nhóm) — khi nào hook chạy:
 - Tool Hooks: PreToolUse, PostToolUse, PostToolUseFailure, PostToolBatch, PermissionRequest, PermissionDenied
 - Session Hooks: SessionStart, Setup, SessionEnd, Stop, StopFailure, SubagentStart, SubagentStop
-- Task Hooks: UserPromptSubmit, UserPromptExpansion, MessageDisplay, TaskCompleted, TaskCreated, TeammateIdle
+- Task Hooks: UserPromptSubmit, UserPromptExpansion, MessageDisplay, TaskCompleted, TaskCreated, TeammateIdle (TaskCompleted/TaskCreated chỉ phát ra khi bật todo tools — tắt mặc định trên Opus 4.8, Sonnet 5, Fable 5, Mythos 5 và mới hơn; `CLAUDE_CODE_ENABLE_TODO_TOOLS=1` khôi phục)
 - Lifecycle Hooks: ConfigChange, CwdChanged, DirectoryAdded, FileChanged, PreCompact, PostCompact, WorktreeCreate, WorktreeRemove, Notification, InstructionsLoaded, Elicitation, ElicitationResult
 
 ---
@@ -876,9 +876,12 @@ Muốn thêm ví dụ nữa? Theo cấu trúc:
 
 ---
 
-**Cập Nhật Lần**: Tháng 3 năm 2026
+**Cập Nhật Lần Cuối**: Ngày 15 tháng 8 năm 2026
+**Phiên Bản Claude Code**: 2.1.233
 **Tổng Số Ví Dụ**: 100+ files
 **Danh Mục**: 10 tính năng
 **Hooks**: 8 scripts tự động hóa
 **Ví Dụ Cấu Hình**: 10+ scenarios
 **Sẵn Sàng Sử Dụng**: Tất cả ví dụ
+**Nguồn**:
+- https://code.claude.com/docs/en/hooks