CalvinBackup/claude-howto
1
0
Fork 0
mirror of https://github.com/luongnv89/claude-howto.git synced 2026-08-21 12:17:15 +02:00
Code Issues Packages Projects Releases Wiki Activity

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

Browse Source 
* 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.
This commit is contained in:
Luong NGUYEN
2026-08-17 12:44:44 +07:00
committed by GitHub
parent 4f3fa85d7e
commit deb7e5c710
42 changed files with 630 additions and 329 deletions
Download Patch File Download Diff File Expand all files Collapse all files
zh/01-slash-commands/README.md
+7 -6
View File
@@ -66,12 +66,12 @@ Claude Code 目前提供 55+ 个内置命令和 5 个内置 Skills。你可以
| `/pr-comments [PR]` | 获取 GitHub PR 评论 |
| `/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`。接受相同的 effort 级别和标志。未指定级别时，复用你上次输入的 `low`–`max` 级别 |
| `/rewind` | 回退对话和/或代码（别名：`/checkpoint`） |
| `/sandbox` | 切换沙盒模式 |
| `/schedule [description]` | 创建/管理定时任务 |
@@ -101,7 +101,6 @@ Claude Code 目前提供 55+ 个内置命令和 5 个内置 Skills。你可以
| 命令 | 状态 |
|---------|--------|
| `/review` | 已弃用，已被 `code-review` 插件替代 |
| `/output-style` | 已于 v2.1.91 移除（v2.1.73 起弃用）— 改用 `/config` → Output style，或 `outputStyle` 设置 |
| `/vim` | 自 v2.1.92 起移除；改用 `/config → Editor mode` |
@@ -109,7 +108,7 @@ Claude Code 目前提供 55+ 个内置命令和 5 个内置 Skills。你可以
- `/fork` 与 `/subtask` 在 **v2.1.212** 互换了角色。`/fork` 现在是把对话复制到一个独立的后台会话；原来的 forked subagent 行为转移到了新命令 `/subtask`。历史：v2.1.77–v2.1.161 期间 `/fork` 是 `/branch` 的别名；v2.1.161–v2.1.211 期间它启动 forked subagent（即现在 `/subtask` 的行为）。关闭 agent view 时 `/subtask` 不可用，`/fork` 仍保留 forked subagent 行为
- `/output-style` 已弃用（v2.1.73）并于 v2.1.91 移除 — output styles 仍可通过 `/config` → Output style 或 `outputStyle` 设置使用
- `/review` 已弃用，推荐改用 `code-review` 插件
- `/review` 成为 `/code-review` 的完整别名 —— 目标、effort 级别和标志完全相同（v2.1.223）。历史：它在 v2.1.186 首次迁移到 `/code-review medium` 引擎，但当时仅支持 PR
- 新增 `/effort`，其中 `max` 级别需要 Opus 4.6
- 新增 `/voice`，用于按住说话语音输入
- 新增 `/schedule`，用于创建和管理定时任务
@@ -549,8 +548,10 @@ allowed-tools: Bash(npm *), Bash(git *)
---
**最后更新**: 2026 年 4 月 9 日
**Claude Code 版本**: 2.1.97
**最后更新**: 2026 年 8 月 15 日
**Claude Code 版本**: 2.1.233
**来源**:
- https://code.claude.com/docs/en/commands
---
zh/06-hooks/README.md
+8 -1
View File
@@ -26,7 +26,7 @@ Claude Code 支持 31 个 hook 事件，按用途分为以下 4 组。事件的
- **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` 仅在启用 todo 工具时触发 —— 在 Opus 4.8、Sonnet 5、Fable 5、Mythos 5 及更新模型上默认关闭；`CLAUDE_CODE_ENABLE_TODO_TOOLS=1` 可恢复）
- **Lifecycle Hooks**：`ConfigChange`、`CwdChanged`、`DirectoryAdded`、`FileChanged`、`PreCompact`、`PostCompact`、`WorktreeCreate`、`WorktreeRemove`、`Notification`、`InstructionsLoaded`、`Elicitation`、`ElicitationResult`
## 安装
@@ -110,3 +110,10 @@ Hooks 会在匹配到事件时自动执行。你可以把它理解成 Claude Cod
- [Memory Guide](../02-memory/README.md)
- [Official Hooks Documentation](https://code.claude.com/docs/en/hooks)
- [CLI Reference](https://code.claude.com/docs/en/cli-reference)
---
**最后更新**: 2026 年 8 月 15 日
**Claude Code 版本**: 2.1.233
**来源**:
- https://code.claude.com/docs/en/hooks
zh/07-plugins/README.md
+25
View File
@@ -444,6 +444,10 @@ graph TB
| `strictKnownMarketplaces` | 控制允许用户添加哪些市场 |
| `deniedPlugins` | 管理员维护的黑名单，阻止特定插件被安装 |
> **更友好的别名（v2.1.232）**：`additionalMarketplaces` 被接受为 `extraKnownMarketplaces` 的别名，`allowedMarketplaces` 为 `strictKnownMarketplaces` 的别名。**来源为 changelog** —— v2.1.232 的 changelog 公布了它们，但官方 settings 参考页面尚未列出。继续使用规范键名是安全的。
> **owner 通配符（v2.1.223+）**：`"owner/*"` 条目可允许或阻止某个 GitHub owner 名下的所有市场仓库。**仅在 `strictKnownMarketplaces` 和 `blockedMarketplaces` 中被接受。** 在其他出现 `github` 源的地方 —— 包括 `extraKnownMarketplaces` 和 `/plugin marketplace add` —— `repo` 的值必须指向单个仓库。
### 额外的市场特性
- **默认 git 超时**：对大型插件仓库从 30 秒增加到 120 秒
@@ -603,6 +607,15 @@ claude plugin validate # 验证插件结构
claude plugin install plugin-name@marketplace-name
```
**是否立即生效？** 自 **v2.1.221** 起通常会立即生效 —— 请查看安装摘要的最后一行：
| 安装摘要显示 | 含义 |
|---|---|
| `Plugin is now active.` | Claude Code 已在安装过程中激活该插件，无需其他操作。 |
| `Run /reload-plugins to activate.` | 插件已安装但尚未生效 —— 要么激活会使 prompt cache 失效，要么激活尝试失败。 |
在 v2.1.221 之前，任何安装都要等到你运行 `/reload-plugins` 或重启后才会在当前会话中生效。
### 启用 / 禁用（自动检测作用域）
```bash
/plugin enable plugin-name
@@ -688,6 +701,10 @@ claude --plugin-dir ./my-plugin --plugin-dir ./another-plugin
| `strictKnownMarketplaces` | 限制用户允许添加的市场 |
| `allowedChannelPlugins` | 控制每个发布渠道允许使用哪些插件 |
> **更友好的别名（v2.1.232）**：`additionalMarketplaces` 被接受为 `extraKnownMarketplaces` 的别名，`allowedMarketplaces` 为 `strictKnownMarketplaces` 的别名。**来源为 changelog** —— v2.1.232 的 changelog 公布了它们，但官方 settings 参考页面尚未列出。继续使用规范键名是安全的。
> **owner 通配符（v2.1.223+）**：`"owner/*"` 条目可允许或阻止某个 GitHub owner 名下的所有市场仓库。**仅在 `strictKnownMarketplaces` 和 `blockedMarketplaces` 中被接受。** 在其他出现 `github` 源的地方 —— 包括 `extraKnownMarketplaces` 和 `/plugin marketplace add` —— `repo` 的值必须指向单个仓库。
这些设置可以通过托管配置文件应用到组织级别，并且优先于用户级设置。
## 插件安全
@@ -928,3 +945,11 @@ claude --plugin-dir ./my-plugin --plugin-dir ./another-plugin
- [MCP Server 参考](https://modelcontextprotocol.io/)
- [Subagent 配置指南](../04-subagents/README.md)
- [Hook 系统参考](../06-hooks/README.md)
---
**最后更新**: 2026 年 8 月 15 日
**Claude Code 版本**: 2.1.233
**来源**:
- https://code.claude.com/docs/en/discover-plugins
- https://code.claude.com/docs/en/settings
zh/CATALOG.md
+8 -5
View File
@@ -64,7 +64,7 @@
| `/logout` | 登出 | 切换账号 |
| `/sandbox` | 切换 sandbox 模式 | 安全执行命令 |
| `/doctor` | 运行诊断 | 排查问题 |
| `/reload-plugins` | 重新加载已安装的 plugins | 插件管理 |
| `/reload-plugins` | 重新加载已安装的 plugins。自 v2.1.221 起，大多数安装会立即生效；仅当安装摘要提示 `Run /reload-plugins to activate.` 时才需要 | 插件管理 |
| `/release-notes` | 显示更新说明 | 查看新功能 |
| `/remote-control` | 启用远程控制 | 远程访问 |
| `/permissions` | 管理权限 | 控制访问 |
@@ -348,8 +348,8 @@ export GITHUB_TOKEN="your_token" && claude mcp add github -- npx -y @modelcontex
| `Stop` | Claude 完成响应 | 响应完成 | 清理、汇报 |
| `StopFailure` | API 错误导致结束 | API 错误发生 | 错误恢复、日志 |
| `TeammateIdle` | 队友 agent 空闲 | agent team 协调 | 分配工作 |
| `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` | 监控文件发生变化 | 文件被修改 | 文件监控、重建 |
@@ -523,5 +523,8 @@ claude mcp add github -- npx -y @modelcontextprotocol/server-github
---
**最后更新**: 2026 年 4 月 9 日
**Claude Code 版本**: 2.1.97
**最后更新**: 2026 年 8 月 15 日
**Claude Code 版本**: 2.1.233
**来源**:
- https://code.claude.com/docs/en/commands
- https://code.claude.com/docs/en/hooks
zh/INDEX.md
+5 -2
View File
@@ -219,7 +219,7 @@ blog-draft/
**Hook 事件**（31 个，分 4 类）— 决定 hook 何时运行：
- 工具 Hook：`PreToolUse`、`PostToolUse`、`PostToolUseFailure`、`PostToolBatch`、`PermissionRequest`、`PermissionDenied`
- 会话 Hook：`SessionStart`、`Setup`、`SessionEnd`、`Stop`、`StopFailure`、`SubagentStart`、`SubagentStop`
- 任务 Hook：`UserPromptSubmit`、`UserPromptExpansion`、`MessageDisplay`、`TaskCompleted`、`TaskCreated`、`TeammateIdle`
- 任务 Hook：`UserPromptSubmit`、`UserPromptExpansion`、`MessageDisplay`、`TaskCompleted`、`TaskCreated`、`TeammateIdle`（TaskCompleted/TaskCreated 仅在启用 todo 工具时触发 —— 在 Opus 4.8、Sonnet 5、Fable 5、Mythos 5 及更新模型上默认关闭；`CLAUDE_CODE_ENABLE_TODO_TOOLS=1` 可恢复）
- 生命周期 Hook：`ConfigChange`、`CwdChanged`、`DirectoryAdded`、`FileChanged`、`PreCompact`、`PostCompact`、`WorktreeCreate`、`WorktreeRemove`、`Notification`、`InstructionsLoaded`、`Elicitation`、`ElicitationResult`
---
@@ -894,9 +894,12 @@ claude -p "Run tests and report results"
---
**最后更新**：2026 年 3 月
**最后更新**：2026 年 8 月 15 日
**Claude Code 版本**：2.1.233
**总示例数**：100+ 文件
**分类数**：10 个功能
**Hooks**：8 个自动化脚本
**配置示例**：10+ 个场景
**可直接使用**：所有示例
**来源**：
- https://code.claude.com/docs/en/hooks
zh/README.md
+5 -3
View File
@@ -483,7 +483,7 @@ chmod +x ~/.claude/hooks/*.sh
**Hook 事件**（31 个，分 4 类）— 决定 hook 何时运行:
- **工具 Hook**: `PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `PostToolBatch`, `PermissionRequest`, `PermissionDenied`
- **会话 Hook**: `SessionStart`, `Setup`, `SessionEnd`, `Stop`, `StopFailure`, `SubagentStart`, `SubagentStop`
- **任务 Hook**: `UserPromptSubmit`, `UserPromptExpansion`, `MessageDisplay`, `TaskCompleted`, `TaskCreated`, `TeammateIdle`
- **任务 Hook**: `UserPromptSubmit`, `UserPromptExpansion`, `MessageDisplay`, `TaskCompleted`, `TaskCreated`, `TeammateIdle`（`TaskCompleted` 和 `TaskCreated` 仅在启用 todo 工具时触发 —— 在 Opus 4.8、Sonnet 5、Fable 5、Mythos 5 及更新模型上默认关闭；`CLAUDE_CODE_ENABLE_TODO_TOOLS=1` 可恢复）
- **生命周期 Hook**: `ConfigChange`, `CwdChanged`, `DirectoryAdded`, `FileChanged`, `PreCompact`, `PostCompact`, `WorktreeCreate`, `WorktreeRemove`, `Notification`, `InstructionsLoaded`, `Elicitation`, `ElicitationResult`
</details>
@@ -878,6 +878,8 @@ MIT 许可证，详见 [LICENSE](LICENSE)。你可以自由使用、修改和分
---
**最后更新**：2026 年 3 月
**Claude Code 版本**：2.1+
**最后更新**：2026 年 8 月 15 日
**Claude Code 版本**：2.1.233
**来源**：
- https://code.claude.com/docs/en/hooks
**兼容模型**：Claude Sonnet 4.6、Claude Opus 4.6、Claude Haiku 4.5
zh/STYLE_GUIDE.md
+7
View File
@@ -628,3 +628,10 @@ docs(skills): Add comprehensive code review skill
- [ ] 段落简短且聚焦
- [ ] 相关指南章节链接到合适的课程
- [ ] 提交信息符合 conventional commits 格式
---
**最后更新**: 2026 年 8 月 15 日
**Claude Code 版本**: 2.1.233
**来源**:
- https://code.claude.com/docs/en/overview