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.
2026-08-21 12:17:15 +02:00 · 2026-08-17 12:44:44 +07:00
parent 4f3fa85d7e
commit deb7e5c710
42 changed files with 630 additions and 329 deletions
@@ -68,12 +68,12 @@
 | `/powerup` | Інтерактивні уроки з анімованими демо |
 | `/privacy-settings` | Налаштування приватності (Pro/Max) |
 | `/release-notes` | Переглянути журнал змін |
-| `/reload-plugins` | Перезавантажити активні плагіни |
+| `/reload-plugins` | Перезавантажити активні плагіни. Починаючи з v2.1.221 більшість установок активуються одразу, тож команда потрібна лише коли підсумок установки каже `Run /reload-plugins to activate.` |
 | `/remote-control` | Віддалене керування з claude.ai (аліас: `/rc`) |
 | `/remote-env` | Налаштування стандартного віддаленого середовища |
 | `/rename [name]` | Перейменувати сесію |
 | `/resume [session]` | Відновити розмову (аліас: `/continue`) |
-| `/review` | **Застаріла** — встановіть плагін `code-review` |
+| `/review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | Псевдонім `/code-review` (v2.1.223): переглядає поточний diff або номер PR, гілку чи шлях, які ви передали — наприклад `/review 1234`. Приймає ті самі рівні зусиль і прапорці. Якщо рівень не вказано, використовує останній рівень `low`–`max`, який ви вводили |
 | `/rewind` | Відкат розмови та/або коду (аліас: `/checkpoint`) |
 | `/sandbox` | Перемкнути режим пісочниці |
 | `/schedule [description]` | Створити/управляти хмарними запланованими завданнями |
@@ -86,7 +86,6 @@
 | `/tasks` | Список/управління фоновими завданнями |
 | `/terminal-setup` | Налаштування клавіш терміналу |
 | `/theme` | Змінити колірну тему |
-| `/ultraplan <prompt>` | Створити план в ultraplan-сесії, переглянути в браузері |
 | `/upgrade` | Відкрити сторінку оновлення тарифу |
 | `/usage` | Показати ліміти плану та статус обмежень |
 | `/voice` | Перемкнути голосовий ввід push-to-talk |
@@ -107,7 +106,6 @@

 | Команда | Статус |
 |---------|--------|
-| `/review` | Застаріла — замінена плагіном `code-review` |
 | `/output-style` | Видалена в v2.1.91 (застаріла з v2.1.73) — використовуйте `/config` → Output style або налаштування `outputStyle` |
 | `/fork` | Перейменована на `/branch` (аліас працює, v2.1.77) |
 | `/pr-comments` | Видалена в v2.1.91 — запитайте Claude напряму |
@@ -117,14 +115,14 @@

 - `/fork` перейменовано на `/branch`, `/fork` залишено як аліас (v2.1.77)
 - `/output-style` застаріла (v2.1.73) і видалена (v2.1.91) — стилі виводу все ще доступні через `/config` → Output style або налаштування `outputStyle`; вбудовані: Default, Proactive, Explanatory, Learning
- `/review` застаріла на користь плагіна `code-review`
+- `/review` став повним псевдонімом `/code-review` — ті самі цілі, рівні зусиль і прапорці (v2.1.223). Історія: спершу він перейшов на рушій `/code-review medium` у v2.1.186, залишаючись доступним лише для PR
 - Додано команду `/effort` з рівнем `max` для Opus 4.6
 - Додано команду `/voice` для голосового вводу push-to-talk
 - Додано команду `/schedule` для запланованих завдань
 - Додано команду `/color` для кастомізації рядка промпту
 - `/pr-comments` видалена в v2.1.91
 - `/vim` видалена в v2.1.92
- Додано `/ultraplan` для перегляду плану в браузері
+- `/ultraplan` вилучено у v2.1.222 — використовуйте режим планування
 - Додано `/powerup` для інтерактивних уроків
 - Додано `/sandbox` для режиму пісочниці
 - Вибір `/model` тепер показує зрозумілі назви (наприклад, "Sonnet 4.6") замість ID моделей
@@ -578,8 +576,10 @@ Deploy the application to production:

 ---

-**Останнє оновлення**: 9 квітня 2026
-**Версія Claude Code**: 2.1.97
+**Останнє оновлення**: 15 серпня 2026
+**Версія Claude Code**: 2.1.233
+**Джерела**:
+- https://code.claude.com/docs/en/commands
 **Сумісні моделі**: Claude Sonnet 4.6, Claude Opus 4.6, Claude Haiku 4.5

 *Частина серії посібників [Claude How To](../)*
@@ -213,6 +213,8 @@ Claude Code підтримує **31 подія хуків**:
 | **ElicitationResult** | Відповідь користувача на elicitation | (немає) | Так | Обробка відповіді |
 | **SessionEnd** | Завершення сесії | (немає) | Ні | Очищення, фінальне логування |

+> **`TaskCreated` і `TaskCompleted` потребують увімкнених todo-інструментів (v2.1.233).** Ці події виникають від todo / task-tracking інструментів (`TaskCreate`/`Get`/`Update`/`List`, `TodoWrite`), які **більше не доступні на Opus 4.8, Sonnet 5, Fable 5, Mythos 5 та новіших моделях**. На цих моделях хук лишається валідною конфігурацією, але просто ніколи не спрацьовує — без виводу і без помилки. Встановіть `CLAUDE_CODE_ENABLE_TODO_TOOLS=1`, щоб повернути їх.
+
 ### PreToolUse

 Запускається після створення параметрів інструмента Claude і перед обробкою. Використовується для валідації або модифікації вхідних даних інструмента.
@@ -1203,6 +1205,8 @@ chmod +x ~/.claude/hooks/*.sh
 - **[Посібник з памʼяті](../02-memory/)** — конфігурація постійного контексту

 ---
-**Останнє оновлення**: 9 квітня 2026
-**Версія Claude Code**: 2.1.97
+**Останнє оновлення**: 15 серпня 2026
+**Версія Claude Code**: 2.1.233
+**Джерела**:
+- https://code.claude.com/docs/en/hooks
 **Сумісні моделі**: Claude Sonnet 4.6, Claude Opus 4.6, Claude Haiku 4.5
@@ -462,6 +462,10 @@ graph TB
 | `strictKnownMarketplaces` | Контролювати, які маркетплейси дозволено додавати користувачам |
 | `deniedPlugins` | Блок-список для запобігання встановленню конкретних плагінів (керований адміністратором) |

+> **Дружніші аліаси (v2.1.232)**: `additionalMarketplaces` приймається як аліас для `extraKnownMarketplaces`, а `allowedMarketplaces` — для `strictKnownMarketplaces`. **Джерело — changelog**: changelog v2.1.232 оголошує їх, але офіційна довідка з налаштувань поки не містить жодної з цих назв. Канонічні ключі безпечно використовувати й далі.
+
+> **Шаблони власника (v2.1.223+)**: запис `"owner/*"` дозволяє або блокує всі репозиторії маркетплейсів під одним власником GitHub. **Приймається лише у `strictKnownMarketplaces` та `blockedMarketplaces`.** Скрізь інде, де зʼявляється джерело `github` — включно з `extraKnownMarketplaces` і `/plugin marketplace add` — значення `repo` має вказувати на один репозиторій.
+
 ### Додаткові функції маркетплейсу

 - **Стандартний таймаут git**: Збільшено з 30с до 120с для великих репозиторіїв плагінів
@@ -706,6 +710,10 @@ claude --plugin-dir ./my-plugin --plugin-dir ./another-plugin
 | `strictKnownMarketplaces` | Обмеження маркетплейсів, які дозволено додавати користувачам |
 | `allowedChannelPlugins` | Контроль дозволених плагінів для кожного каналу випуску |

+> **Дружніші аліаси (v2.1.232)**: `additionalMarketplaces` приймається як аліас для `extraKnownMarketplaces`, а `allowedMarketplaces` — для `strictKnownMarketplaces`. **Джерело — changelog**: changelog v2.1.232 оголошує їх, але офіційна довідка з налаштувань поки не містить жодної з цих назв. Канонічні ключі безпечно використовувати й далі.
+
+> **Шаблони власника (v2.1.223+)**: запис `"owner/*"` дозволяє або блокує всі репозиторії маркетплейсів під одним власником GitHub. **Приймається лише у `strictKnownMarketplaces` та `blockedMarketplaces`.** Скрізь інде, де зʼявляється джерело `github` — включно з `extraKnownMarketplaces` і `/plugin marketplace add` — значення `repo` має вказувати на один репозиторій.
+
 Ці налаштування можна застосувати на рівні організації через файли керованої конфігурації, і вони мають пріоритет над налаштуваннями рівня користувача.

 ## Безпека плагінів
@@ -833,6 +841,15 @@ Complete PR review workflow with security, testing, and documentation checks.
   /plugin install plugin-name
   ```

+**Чи набуде чинності одразу?** Починаючи з **v2.1.221** — зазвичай так. Прочитайте останній рядок підсумку встановлення:
+
+| Підсумок встановлення каже | Що це означає |
+|---|---|
+| `Plugin is now active.` | Claude Code активував плагін під час встановлення. Більше нічого робити не треба. |
+| `Run /reload-plugins to activate.` | Плагін встановлено, але він ще не активний — або активація знецінила б prompt cache, або спроба активації не вдалася. |
+
+До v2.1.221 жодне встановлення не набувало чинності в поточній сесії, доки ви не запускали `/reload-plugins` або не перезапускали Claude Code.
+
 ### Встановлення з локального шляху

 ```bash
@@ -948,6 +965,9 @@ Complete PR review workflow with security, testing, and documentation checks.
 - [Довідник системи хуків](../06-hooks/README.md)

 ---
-**Останнє оновлення**: 9 квітня 2026
-**Версія Claude Code**: 2.1.97
+**Останнє оновлення**: 15 серпня 2026
+**Версія Claude Code**: 2.1.233
+**Джерела**:
+- https://code.claude.com/docs/en/discover-plugins
+- https://code.claude.com/docs/en/settings
 **Сумісні моделі**: Claude Sonnet 4.6, Claude Opus 4.6, Claude Haiku 4.5
@@ -197,10 +197,6 @@ claude --model opusplan "design and implement the new API"

 **Редагування плану зовні**: Натисніть `Ctrl+G`, щоб відкрити поточний план у зовнішньому редакторі для детальних змін.

-### Ultraplan
-
-Використовуйте `/ultraplan <prompt>` для наскрізного робочого процесу планування: Claude складає детальний план, відкриває його у браузері для перегляду, потім виконує план віддалено або повертає його у ваш термінал для локального виконання.
-
 ---

 ## Розширене мислення
@@ -1940,6 +1936,8 @@ claude --teammate-mode in-process
 - [Офіційна документація Agent Teams](https://code.claude.com/docs/en/agent-teams)

 ---
-**Останнє оновлення**: 9 квітня 2026
-**Версія Claude Code**: 2.1.97
+**Останнє оновлення**: 15 серпня 2026
+**Версія Claude Code**: 2.1.233
+**Джерела**:
+- https://code.claude.com/docs/en/commands
 **Сумісні моделі**: Claude Sonnet 4.6, Claude Opus 4.6, Claude Haiku 4.5
@@ -68,7 +68,7 @@
 | `/logout` | Вийти з облікового запису | Зміна акаунту |
 | `/sandbox` | Перемкнути режим пісочниці | Безпечне виконання команд |
 | `/doctor` | Запустити діагностику | Усунення неполадок |
-| `/reload-plugins` | Перезавантажити плагіни | Управління плагінами |
+| `/reload-plugins` | Перезавантажити плагіни. Починаючи з v2.1.221 більшість установок активуються одразу; команда потрібна лише коли підсумок установки каже `Run /reload-plugins to activate.` | Управління плагінами |
 | `/release-notes` | Показати нотатки до релізу | Перевірка нових функцій |
 | `/remote-control` | Увімкнути віддалене керування | Віддалений доступ |
 | `/permissions` | Управління дозволами | Контроль доступу |
@@ -352,8 +352,8 @@ export GITHUB_TOKEN="your_token" && claude mcp add github -- npx -y @modelcontex
 | `Stop` | Claude завершив відповідь | Відповідь готова | Очищення, звітність |
 | `StopFailure` | API-помилка завершила черга | API-помилка | Відновлення, логування |
 | `TeammateIdle` | Агент-партнер бездіє | Координація агентів | Розподіл роботи |
-| `TaskCompleted` | Завдання позначено як виконане | Завдання завершено | Пост-обробка |
-| `TaskCreated` | Завдання створено через TaskCreate | Нове завдання створено | Відстеження, логування |
+| `TaskCompleted` | Завдання позначено як виконане (спрацьовує лише коли увімкнені todo-інструменти — типово вимкнені на Opus 4.8, Sonnet 5, Fable 5, Mythos 5 і новіших; `CLAUDE_CODE_ENABLE_TODO_TOOLS=1` повертає їх) | Завдання завершено | Пост-обробка |
+| `TaskCreated` | Завдання створено через TaskCreate (спрацьовує лише коли увімкнені todo-інструменти — типово вимкнені на Opus 4.8, Sonnet 5, Fable 5, Mythos 5 і новіших; `CLAUDE_CODE_ENABLE_TODO_TOOLS=1` повертає їх) | Нове завдання створено | Відстеження, логування |
 | `ConfigChange` | Конфігурацію оновлено | Налаштування змінені | Реакція на зміни конфігурації |
 | `CwdChanged` | Робочий каталог змінився | Зміна каталогу | Налаштування для каталогу |
 | `FileChanged` | Відстежуваний файл змінився | Файл модифіковано | Моніторинг, перебудова |
@@ -524,5 +524,8 @@ chmod +x ~/.claude/hooks/*.sh

 ---

-**Останнє оновлення**: 9 квітня 2026
-**Версія Claude Code**: 2.1.97
+**Останнє оновлення**: 15 серпня 2026
+**Версія Claude Code**: 2.1.233
+**Джерела**:
+- https://code.claude.com/docs/en/commands
+- https://code.claude.com/docs/en/hooks
@@ -237,7 +237,7 @@ blog-draft/

 - Хуки інструментів: PreToolUse, PostToolUse, PostToolUseFailure, PostToolBatch, PermissionRequest, PermissionDenied
 - Хуки сесії: SessionStart, Setup, SessionEnd, Stop, StopFailure, SubagentStart, SubagentStop
- Хуки завдань: UserPromptSubmit, UserPromptExpansion, MessageDisplay, TaskCompleted, TaskCreated, TeammateIdle
+- Хуки завдань: UserPromptSubmit, UserPromptExpansion, MessageDisplay, TaskCompleted, TaskCreated, TeammateIdle (TaskCompleted/TaskCreated спрацьовують лише коли увімкнені todo-інструменти — типово вимкнені на Opus 4.8, Sonnet 5, Fable 5, Mythos 5 і новіших; `CLAUDE_CODE_ENABLE_TODO_TOOLS=1` повертає їх)
 - Хуки життєвого циклу: ConfigChange, CwdChanged, DirectoryAdded, FileChanged, PreCompact, PostCompact, WorktreeCreate, WorktreeRemove, Notification, InstructionsLoaded, Elicitation, ElicitationResult

 ---
@@ -932,10 +932,12 @@ Run tests in background

 ---

-**Останнє оновлення**: 9 квітня 2026
-**Версія Claude Code**: 2.1.97
+**Останнє оновлення**: 15 серпня 2026
+**Версія Claude Code**: 2.1.233
 **Прикладів**: 100+ файлів
 **Категорій**: 10 функцій
 **Хуків**: 8 скриптів автоматизації
 **Прикладів конфігурації**: 10+ сценаріїв
 **Готові до використання**: Усі приклади
+**Джерела**:
+- https://code.claude.com/docs/en/hooks
@@ -443,7 +443,7 @@ chmod +x ~/.claude/hooks/*.sh
 **Події хуків** (31, у 4 категоріях) — коли він виконується:
 - **Хуки інструментів**: `PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `PostToolBatch`, `PermissionRequest`, `PermissionDenied`
 - **Хуки сесій**: `SessionStart`, `Setup`, `SessionEnd`, `Stop`, `StopFailure`, `SubagentStart`, `SubagentStop`
- **Хуки завдань**: `UserPromptSubmit`, `UserPromptExpansion`, `MessageDisplay`, `TaskCompleted`, `TaskCreated`, `TeammateIdle`
+- **Хуки завдань**: `UserPromptSubmit`, `UserPromptExpansion`, `MessageDisplay`, `TaskCompleted`, `TaskCreated`, `TeammateIdle` (`TaskCompleted` і `TaskCreated` спрацьовують лише коли увімкнені todo-інструменти — типово вимкнені на Opus 4.8, Sonnet 5, Fable 5, Mythos 5 і новіших; `CLAUDE_CODE_ENABLE_TODO_TOOLS=1` повертає їх)
 - **Хуки життєвого циклу**: `ConfigChange`, `CwdChanged`, `DirectoryAdded`, `FileChanged`, `PreCompact`, `PostCompact`, `WorktreeCreate`, `WorktreeRemove`, `Notification`, `InstructionsLoaded`, `Elicitation`, `ElicitationResult`

 </details>
@@ -659,6 +659,8 @@ Claude:

 ---

-**Останнє оновлення**: Квітень 2026
-**Версія Claude Code**: 2.1.97
+**Останнє оновлення**: 15 серпня 2026
+**Версія Claude Code**: 2.1.233
+**Джерела**:
+- https://code.claude.com/docs/en/hooks
 **Сумісні моделі**: Claude Sonnet 4.6, Claude Opus 4.6, Claude Haiku 4.5
@@ -634,4 +634,8 @@ README уроків завершуються блоком метаданих:
 - [ ] Повідомлення коміту відповідає формату conventional commits

 ---
-**Останнє оновлення**: Квітень 2026
+
+**Останнє оновлення**: 15 серпня 2026
+**Версія Claude Code**: 2.1.233
+**Джерела**:
+- https://code.claude.com/docs/en/overview
@@ -2826,8 +2826,8 @@ Claude Code підтримує **31 подія хуків** у п'яти тип
 | **Stop** | Claude завершив відповідь | Генерація підсумку, завдання очищення |
 | **StopFailure** | Помилка API завершує хід | Відновлення після помилки, логування |
 | **TeammateIdle** | Тімейт у команді агентів без роботи | Розподіл роботи, координація |
-| **TaskCompleted** | Завдання позначено як виконане | Пост-обробка завдання |
-| **TaskCreated** | Завдання створено через TaskCreate | Відстеження завдань, логування |
+| **TaskCompleted** | Завдання позначено як виконане (спрацьовує лише коли увімкнені todo-інструменти — типово вимкнені на Opus 4.8, Sonnet 5, Fable 5, Mythos 5 і новіших; `CLAUDE_CODE_ENABLE_TODO_TOOLS=1` повертає їх) | Пост-обробка завдання |
+| **TaskCreated** | Завдання створено через TaskCreate (спрацьовує лише коли увімкнені todo-інструменти — типово вимкнені на Opus 4.8, Sonnet 5, Fable 5, Mythos 5 і новіших; `CLAUDE_CODE_ENABLE_TODO_TOOLS=1` повертає їх) | Відстеження завдань, логування |
 | **ConfigChange** | Зміна конфігураційного файлу | Валідація, поширення |
 | **CwdChanged** | Зміна робочого каталогу | Налаштування для конкретного каталогу |
 | **FileChanged** | Зміна відстежуваного файлу | Моніторинг файлів, тригери перебудови |
@@ -3127,10 +3127,12 @@ User: \

 ---

-*Останнє оновлення: квітень 2026*
+*Останнє оновлення: 15 серпня 2026*
 *Для Claude Haiku 4.5, Sonnet 4.6 та Opus 4.6*
 *Тепер включає: хуки, контрольні точки, режим планування, розширене мислення, фонові завдання, режими дозволів (6 режимів), headless-режим, управління сесіями, авто-пам'ять, команди агентів, заплановані завдання, інтеграцію з Chrome, канали, голосовий ввід та комплектні навички*

 ---
-**Last Updated**: April 9, 2026
-**Claude Code Version**: 2.1.97
+**Останнє оновлення**: 15 серпня 2026
+**Версія Claude Code**: 2.1.233
+**Джерела**:
+- https://code.claude.com/docs/en/hooks