Documentation 2026-09-12 03:02 UTC to 2026-09-13 21:00 UTC

136| `--teleport` | 在本地终端中恢复 [网络会话](/docs/zh-CN/claude-code-on-the-web) | `claude --teleport` |136| `--teleport` | 在本地终端中恢复 [网络会话](/docs/zh-CN/claude-code-on-the-web) | `claude --teleport` |

137| `--teammate-mode` | 设置 [agent team](/docs/zh-CN/agent-teams) 队友的显示方式：`in-process`（默认）、`auto`、`tmux` 或 `iterm2`（在 v2.1.186 中添加）。覆盖此会话的 [`teammateMode`](/docs/zh-CN/settings-reference#teammatemode) 设置。请参阅 [选择显示模式](/docs/zh-CN/agent-teams#choose-a-display-mode) | `claude --teammate-mode auto` |137| `--teammate-mode` | 设置 [agent team](/docs/zh-CN/agent-teams) 队友的显示方式：`in-process`（默认）、`auto`、`tmux` 或 `iterm2`（在 v2.1.186 中添加）。覆盖此会话的 [`teammateMode`](/docs/zh-CN/settings-reference#teammatemode) 设置。请参阅 [选择显示模式](/docs/zh-CN/agent-teams#choose-a-display-mode) | `claude --teammate-mode auto` |

138| `--tmux` | 为 worktree 创建 tmux 会话。需要 `--worktree`。在可用时使用 iTerm2 原生窗格；传递 `--tmux=classic` 以使用传统 tmux | `claude -w feature-auth --tmux` |138| `--tmux` | 为 worktree 创建 tmux 会话。需要 `--worktree`。在可用时使用 iTerm2 原生窗格；传递 `--tmux=classic` 以使用传统 tmux | `claude -w feature-auth --tmux` |

139| `--tools` | 限制 Claude 可以使用的内置工具。使用 `""` 禁用所有，`"default"` 表示全部，或工具名称如 `"Bash,Edit,Read"`。在 macOS、Linux 和 WSL 上，默认集合排除 `Glob` 和 `Grep`，如 [Glob 工具行为](/docs/zh-CN/tools-reference#glob-tool-behavior) 中所述。如果您在此处命名 [任务跟踪工具](/docs/zh-CN/tools-reference#task-tool-availability) 之一，Claude Code 也会选择加入。标志不影响 MCP 工具；要拒绝这些工具，请改用 `--disallowedTools "mcp__*"`。省略 [`EndConversation`](/docs/zh-CN/tools-reference#endconversation-tool-behavior) 的列表不会删除它；`""` 仅在没有 MCP 工具保持时删除它 | `claude --tools "Bash,Edit,Read"` |139| `--tools` | 限制 Claude 可以使用的内置工具。使用 `""` 禁用所有，`"default"` 表示默认集合，或工具名称如 `"Bash,Edit,Read"`。在 macOS、Linux 和 WSL 上，默认集合排除 `Glob` 和 `Grep`，如 [Glob 工具行为](/docs/zh-CN/tools-reference#glob-tool-behavior) 中所述。如果您在此处命名 [任务跟踪工具](/docs/zh-CN/tools-reference#task-tool-availability) 之一，Claude Code 也会选择加入。标志不影响 MCP 工具；要拒绝这些工具，请改用 `--disallowedTools "mcp__*"`。省略 [`EndConversation`](/docs/zh-CN/tools-reference#endconversation-tool-behavior) 的列表不会删除它；`""` 仅在没有 MCP 工具保持时删除它 | `claude --tools "Bash,Edit,Read"` |

140| `--verbose` | 启用详细日志记录，显示完整的逐轮输出。覆盖此会话的 [`viewMode`](/docs/zh-CN/settings-reference#viewmode) 设置 | `claude --verbose` |140| `--verbose` | 启用详细日志记录，显示完整的逐轮输出。覆盖此会话的 [`viewMode`](/docs/zh-CN/settings-reference#viewmode) 设置 | `claude --verbose` |

141| `--version`, `-v` | 输出版本号 | `claude -v` |141| `--version`, `-v` | 输出版本号 | `claude -v` |

142| `--worktree`, `-w` | 在隔离的 [git worktree](/docs/zh-CN/worktrees) 中启动 Claude，位于 `<repo>/.claude/worktrees/<name>`。如果未给出名称，则自动生成一个。传递 `#<number>`、GitHub 拉取请求 URL 或 GitLab 合并请求 URL 以 [从 `origin` 获取该 PR 或 MR 并从其分支 worktree](/docs/zh-CN/worktrees#branch-from-a-pull-request)。从 GitLab 合并请求分支需要 Claude Code v2.1.233 或更高版本 | `claude -w feature-auth` |142| `--worktree`, `-w` | 在隔离的 [git worktree](/docs/zh-CN/worktrees) 中启动 Claude，位于 `<repo>/.claude/worktrees/<name>`。如果未给出名称，则自动生成一个。传递 `#<number>`、GitHub 拉取请求 URL 或 GitLab 合并请求 URL 以 [从 `origin` 获取该 PR 或 MR 并从其分支 worktree](/docs/zh-CN/worktrees#branch-from-a-pull-request)。从 GitLab 合并请求分支需要 Claude Code v2.1.233 或更高版本 | `claude -w feature-auth` |

281 281 

282当您期望的会话不在代理列表中时，当您想要脚本或钩子发布到会话中时，或当沙箱命令无法到达套接字时，阅读本部分。282当您期望的会话不在代理列表中时，当您想要脚本或钩子发布到会话中时，或当沙箱命令无法到达套接字时，阅读本部分。

283 283 

284Claude Code 为启用跨会话消息传递的每个会话绑定收件箱套接字，其他机器上的会话在其中传递消息。套接字是 macOS 和 Linux 上的 Unix 域套接字，包括 WSL 2 内的 Linux，以及原生 Windows 上的命名管道。对于哪些会话类型绑定一个，请参阅[非交互式会话](#non-interactive-sessions)。284Claude Code 为启用跨会话消息传递的每个会话绑定收件箱套接字，同一机器上的其他会话在其中传递消息。套接字是 macOS 和 Linux 上的 Unix 域套接字，包括 WSL 2 内的 Linux，以及原生 Windows 上的命名管道。对于哪些会话类型绑定一个，请参阅[非交互式会话](#non-interactive-sessions)。

285 285 

286您可以在两个地方找到套接字的路径：286您可以在两个地方找到套接字的路径：

287 287 

298要为整个会话设置基线而不是列出单个工具，请传递 [权限模式](/docs/zh-CN/permission-modes)。对于 `-p`，[内置启动权限模式](/docs/zh-CN/permission-modes#which-mode-a-session-starts-in) 在每个计划上都是 Manual，因此传递您想要的权限模式：298要为整个会话设置基线而不是列出单个工具，请传递 [权限模式](/docs/zh-CN/permission-modes)。对于 `-p`，[内置启动权限模式](/docs/zh-CN/permission-modes#which-mode-a-session-starts-in) 在每个计划上都是 Manual，因此传递您想要的权限模式：

299 299 

300* **`auto`**：传递 `--permission-mode auto` 以让分类器审查大多数操作而不是您300* **`auto`**：传递 `--permission-mode auto` 以让分类器审查大多数操作而不是您

301* **`dontAsk`**：Claude Code 拒绝任何会提示的内容，除非 `permissions.allow` 规则或 [只读命令集](/docs/zh-CN/permissions#read-only-commands) 中包含它，这对于锁定的 CI 运行很有用。`AskUserQuestion`、连接器工具 [您的组织设置为 `ask`](/docs/zh-CN/mcp#organization-controls-on-connector-tools) 和标记为 [`requiresUserInteraction`](/docs/zh-CN/mcp#require-approval-for-a-specific-tool) 的 MCP 工具即使当允许规则匹配时也被拒绝301* **`dontAsk`**：Claude Code 拒绝每个原本会提示的调用，这对于锁定的 CI 运行很有用。在 Manual 模式下无需批准的操作仍会运行，例如工作目录中的文件读取和 [只读命令集](/docs/zh-CN/permissions#read-only-commands)，您的 `--allowedTools` 条目或 `permissions.allow` 规则涵盖的操作也是如此。`AskUserQuestion`、连接器工具 [您的组织设置为 `ask`](/docs/zh-CN/mcp#organization-controls-on-connector-tools) 和标记为 [`requiresUserInteraction`](/docs/zh-CN/mcp#require-approval-for-a-specific-tool) 的 MCP 工具即使当允许规则匹配时也被拒绝

302* **`acceptEdits`**：Claude 写入文件而无需提示，Claude Code 自动批准常见的文件系统命令，例如 `mkdir`、`touch`、`mv` 和 `cp`。[任何模式都不自动批准的操作](/docs/zh-CN/permission-modes#actions-no-mode-auto-approves) 仍然适用。除了只读命令集，其他 shell 命令和网络请求仍然需要 `--allowedTools` 条目或 `permissions.allow` 规则。有关 `acceptEdits` 自动批准的内容，请参阅 [使用 acceptEdits 模式自动批准文件编辑](/docs/zh-CN/permission-modes#auto-approve-file-edits-with-acceptedits-mode)302* **`acceptEdits`**：Claude 写入文件而无需提示，Claude Code 自动批准常见的文件系统命令，例如 `mkdir`、`touch`、`mv` 和 `cp`。[任何模式都不自动批准的操作](/docs/zh-CN/permission-modes#actions-no-mode-auto-approves) 仍然适用。除了只读命令集，其他 shell 命令和网络请求仍然需要 `--allowedTools` 条目或 `permissions.allow` 规则。有关 `acceptEdits` 自动批准的内容，请参阅 [使用 acceptEdits 模式自动批准文件编辑](/docs/zh-CN/permission-modes#auto-approve-file-edits-with-acceptedits-mode)

303 303 

304此示例使用 `acceptEdits` 作为基线应用 lint 修复：304此示例使用 `acceptEdits` 作为基线应用 lint 修复：

1523 1523 

1524* **plugin 或 `.claude` 根目录下的链接 `skills`、`agents` 或 `commands` 目录**：Claude Code 警告其中没有任何内容被读取。1524* **plugin 或 `.claude` 根目录下的链接 `skills`、`agents` 或 `commands` 目录**：Claude Code 警告其中没有任何内容被读取。

1525* **`skills`、`agents` 或 `commands` 目录内的链接条目**：Claude Code 跳过它并警告，每个目录，它跳过了多少条目，会话会加载。1525* **`skills`、`agents` 或 `commands` 目录内的链接条目**：Claude Code 跳过它并警告，每个目录，它跳过了多少条目，会话会加载。

1526* **你命名的 `skills`、`agents` 或 `commands` 目录本身是符号链接，或其父 `.claude` 目录是**：Claude Code 报告错误并检查其中的任何内容。改为命名真实目录。1526* **你命名的 `skills`、`agents` 或 `commands` 目录本身是符号链接，或其父 `.claude` 目录是**：Claude Code 报告错误，并且不检查其中的任何内容。改为命名真实目录。

1527 1527 

1528在两个 skills 情况下，运行通过警告。要检查链接的文件，再次运行并命名直接包含它们的目录：1528在两个 skills 情况下，运行通过警告。要检查链接的文件，再次运行并命名直接包含它们的目录：

1529 1529 

1173 plugin disable1173 plugin disable

1174</h3>1174</h3>

1175 1175 

1176禁用插件而不卸载它。当目标从市场安装时，如果另一个启用的插件 [depends on](/docs/zh-CN/plugin-dependencies#enable-or-disable-a-plugin-with-dependencies) 它，该命令会失败。错误消息包含一个链式命令，首先禁用每个依赖项。1176禁用插件而不卸载它。当目标从市场安装时，如果另一个启用的插件[依赖](/docs/zh-CN/plugin-dependencies#enable-or-disable-a-plugin-with-dependencies)它，该命令会失败。错误消息包含一个链式命令，首先禁用每个依赖它的插件。

1177 1177 

1178```bash theme={null}1178```bash theme={null}

1179claude plugin disable [plugin] [options]1179claude plugin disable [plugin] [options]

381 子代理和缓存381 子代理和缓存

382</h2>382</h2>

383 383 

384[子代理](/docs/zh-CN/sub-agents)启动自己的对话，具有自己的系统提示和工具集，与父代的分开。它的第一个请求不读取父代的缓存，因为两个前缀不同，并在自己的回合中预热自己的缓存。子代理不在主对话[TTL 桶](#which-ttl-each-request-gets)之外，所以即使在订阅上也能获得五分钟，直到你[选择更长的时间](#choose-the-ttl-yourself)。384[子代理](/docs/zh-CN/sub-agents)启动自己的对话，具有自己的系统提示和工具集，与父代的分开。它的第一个请求不读取父代的缓存，因为两个前缀不同，并在自己的回合中预热自己的缓存。子代理不在主对话[TTL 桶](#which-ttl-each-request-gets)之内，所以即使在订阅上也能获得五分钟，直到你[选择更长的时间](#choose-the-ttl-yourself)。

385 385 

386父代的缓存不受影响。从父代的一侧，子代理的调用和结果附加到对话，保留父代的前缀完整。386父代的缓存不受影响。从父代的一侧，子代理的调用和结果附加到对话，保留父代的前缀完整。

387 387 

632 632 

633如果您拼错 JSON 或将键设置为 Claude Code 不接受的值，Claude Code 在交互式会话启动时告诉您。它显示的内容取决于文件受影响的程度：633如果您拼错 JSON 或将键设置为 Claude Code 不接受的值，Claude Code 在交互式会话启动时告诉您。它显示的内容取决于文件受影响的程度：

634 634 

635* **设置错误**：用户、项目或本地文件有无效的 JSON 或架构拒绝的值。在交互式会话启动时，Claude Code 显示一个对话框，让您在 Claude 的帮助下修复文件、退出或继续使用损坏的设置。635* **设置错误**：用户、项目或本地文件有无效的 JSON 或架构拒绝的值。在交互式会话启动时，Claude Code 显示一个对话框，让您在 Claude 的帮助下修复文件、退出，或在不加载这些损坏设置的情况下继续。

636* **设置警告**：仅单个条目失败，如格式错误的权限规则或未知的 hook 事件名称。Claude Code 跳过这些值并保持文件的其余部分生效。636* **设置警告**：仅单个条目失败，如格式错误的权限规则或未知的 hook 事件名称。Claude Code 跳过这些值并保持文件的其余部分生效。

637* **托管设置**：Claude Code 继续强制执行文件的其余部分。[托管设置中的无效条目](/docs/zh-CN/managed-settings#invalid-entries-in-managed-settings)说明它删除什么以及哪些键回退到更严格的值，直到您修复它们。对于不是有效 JSON 的托管设置文档，请参阅[托管设置文档无法解析](/docs/zh-CN/errors#managed-settings-document-could-not-be-parsed)。637* **托管设置**：Claude Code 继续强制执行文件的其余部分。[托管设置中的无效条目](/docs/zh-CN/managed-settings#invalid-entries-in-managed-settings)说明它删除什么以及哪些键回退到更严格的值，直到您修复它们。对于不是有效 JSON 的托管设置文档，请参阅[托管设置文档无法解析](/docs/zh-CN/errors#managed-settings-document-could-not-be-parsed)。

638* **配置错误**：`~/.claude.json` 无法解析。Claude Code 将损坏的文件复制到 `~/.claude/backups/.claude.json.corrupted.<timestamp>` 并询问是否退出并手动修复它或重置为默认配置；`-p` 运行打印错误并退出。要恢复您之前的状态，复制回 `~/.claude/backups/` 中最近五个 `.claude.json.backup.<timestamp>` 文件之一，Claude Code 在写入文件前保存。638* **配置错误**：`~/.claude.json` 无法解析。Claude Code 将损坏的文件复制到 `~/.claude/backups/.claude.json.corrupted.<timestamp>` 并询问是否退出并手动修复它或重置为默认配置；`-p` 运行打印错误并退出。要恢复您之前的状态，复制回 `~/.claude/backups/` 中最近五个 `.claude.json.backup.<timestamp>` 文件之一，Claude Code 在写入文件前保存。