Documentation 2026-11-04 23:59 UTC to 2026-11-05 23:03 UTC

129 129 

130当会话完成时，您可以从 claude.ai/code 创建 PR，或 [teleport](#from-cloud-to-terminal) 会话到您的终端以继续工作。130当会话完成时，您可以从 claude.ai/code 创建 PR，或 [teleport](#from-cloud-to-terminal) 会话到您的终端以继续工作。

131 131 

132#### 发送没有 GitHub 的本地存储库132#### 发送没有 GitHub 的本地仓库

133 133 

134当您从没有 git 远程的仓库运行 `claude --cloud` 时，或从未安装 Claude GitHub App 的 github.com 仓库运行时，Claude Code 会将您的本地仓库打包并直接上传到云端会话。即使您使用 `/web-setup` 连接了 GitHub，这也适用。134当您从没有 git 远程的仓库运行 `claude --cloud` 时，或从未安装 Claude GitHub App 的 github.com 仓库运行时，Claude Code 会将您的本地仓库打包并直接上传到云端会话。即使您使用 `/web-setup` 连接了 GitHub，这也适用。

135 135 

227 227 

228要隐藏或显示该面板，请点击会话标题栏中或标题栏 **⋮** 菜单中的 **Hide session rail** 或 **Show session rail**。如果仍然看不到该面板，请[检查您使用的是哪种 Code 选项卡布局](#check-which-layout-you-have)。228要隐藏或显示该面板，请点击会话标题栏中或标题栏 **⋮** 菜单中的 **Hide session rail** 或 **Show session rail**。如果仍然看不到该面板，请[检查您使用的是哪种 Code 选项卡布局](#check-which-layout-you-have)。

229 229 

230### 最小化窗格

231 

232要让终端、浏览器或 [iOS Simulator](https://code.claude.com/docs/zh-CN/desktop-ios-simulator.md) 以较小尺寸保持在视野中，请点击窗格标题中的 **Minimize**。该按钮需要 Claude Desktop v4.0.0 或更高版本，并且需要使用 Claude 账户而非[第三方提供商](https://code.claude.com/docs/zh-CN/third-party-integrations.md)。浏览器窗格仅在本地会话中提供该按钮。

233 

234当[会话详细信息面板](#see-session-details)显示在屏幕上时，最小化的窗格位于该面板中；否则，它会悬浮在聊天区域的一角：

235 

236* **在面板中**：最小化的窗格位于面板卡片下方，此时无法移动或调整其大小。要改为让它悬浮在聊天区域上方，请[隐藏面板](#hide-or-show-the-session-details-panel)。

237* **在聊天区域的一角**：将鼠标悬停在最小化的窗格上以显示其标题。拖动标题可将其移动到另一个角落。要调整其大小，请拖动最小化窗格中最靠近聊天区域中心的那个角。

238 

239要恢复完整窗格，请点击最小化窗格标题中的 **Expand**。要改为关闭最小化的窗格，请点击 **Expand** 旁的关闭按钮。

240 

230### 在终端中运行命令241### 在终端中运行命令

231 242 

232集成终端让您无需切换到另一个应用即可在会话旁运行命令。点击会话标题栏中的 **Terminal**，或在 macOS 或 Windows 上按 **Ctrl+\`**。终端在您的会话工作目录中打开，并与 Claude 共享相同的环境，因此 `npm test` 或 `git status` 等命令看到 Claude 正在编辑的相同文件。要打开第二个终端选项卡，点击终端窗格标题中的 **+** 或右键点击聊天中的文件夹来选择 **Open in terminal**。243集成终端让您无需切换到另一个应用即可在会话旁运行命令。点击会话标题栏中的 **Terminal**，或在 macOS 或 Windows 上按 **Ctrl+\`**。终端在您的会话工作目录中打开，并与 Claude 共享相同的环境，因此 `npm test` 或 `git status` 等命令看到 Claude 正在编辑的相同文件。要打开第二个终端选项卡，点击终端窗格标题中的 **+** 或右键点击聊天中的文件夹来选择 **Open in terminal**。

94 94 

95## 授予 Claude 对设备的访问权限95## 授予 Claude 对设备的访问权限

96 96 

97Claude 在控制设备之前要求你的同意，而构建应用或在其上打开 URL 遵循你的会话的权限模式。你或你的组织也可以完全关闭 Claude 的访问。97Claude 在控制设备之前会征求您的同意，而在设备上构建或启动应用、打开 URL 则遵循您会话的权限模式。您或您的组织也可以完全关闭 Claude 的访问。

98 98 

99### 第一次允许设备99### 第一次允许设备

100 100 

101Claude 第一次使用模拟器时，桌面应用会要求你允许它。同意涵盖控制该设备和对其进行屏幕截图，你每个设备给予一次而不是每个会话一次。Claude 对设备的屏幕截图被发送到 Anthropic 并根据你的正常对话保留设置保留，因此不要在 Claude 使用的设备上登录真实账户。101Claude 第一次使用模拟器时，桌面应用会要求你允许它。同意涵盖控制该设备和对其进行屏幕截图，你每个设备给予一次而不是每个会话一次。Claude 对设备的屏幕截图被发送到 Anthropic 并根据你的正常对话保留设置保留，因此不要在 Claude 使用的设备上登录真实账户。

102 102 

103在你允许设备后，Claude 对其的操作，例如点击、输入、启动应用和拍摄屏幕截图，无需进一步提示即可运行。它们具有与你在窗格中单击相同的信任，并且它们仅触及模拟设备，因此窗格不需要计算机使用所需的 macOS 辅助功能和屏幕录制权限。103在您允许设备后，Claude 对其执行的操作（例如点击、输入和拍摄屏幕截图）无需提示即可运行，但启动应用需要按照您的[权限模式](#actions-that-follow-your-permission-mode)的要求进行批准。这些操作具有与您在窗格中单击相同的信任级别，并且仅作用于模拟设备，因此窗格不需要计算机使用所需的 macOS 辅助功能和屏幕录制权限。

104 104 

105如果你拒绝，设备仍会启动，窗格仍可用于你自己的点击；只有 Claude 的访问保持关闭。要稍后改变主意，请在窗格中单击**Let Claude use it**。105如果你拒绝，设备仍会启动，窗格仍可用于你自己的点击；只有 Claude 的访问保持关闭。要稍后改变主意，请在窗格中单击**Let Claude use it**。

106 106 

107### 遵循你的权限模式的操作107### 遵循你的权限模式的操作

108 108 

109两个操作遵循你的会话的[权限模式](https://code.claude.com/docs/zh-CN/permissions.md#permission-modes)而不是一次性同意：109即使在您允许设备之后，以下三个操作仍遵循您会话的[权限模式](https://code.claude.com/docs/zh-CN/permissions.md#permission-modes)：

110 110 

111* 在设备上打开 URL，例如测试深层链接或在设备的 Safari 中加载页面，因为 URL 可以将数据从设备中携带出去。111* 在设备上打开 URL，例如测试深层链接或在设备的 Safari 中加载页面，因为 URL 可以将数据从设备中携带出去。

112* 构建应用，因为 `xcodebuild` 在你的 Mac 上运行你的项目的构建脚本。检查已在进行的构建不会提示。112* 构建应用，因为 `xcodebuild` 在你的 Mac 上运行你的项目的构建脚本。检查已在进行的构建不会提示。

113* 安装和启动应用，因为 Claude 可以运行它指定的任何应用，而不仅仅是您正在构建的应用。

113 114 

114### 关闭模拟器访问115### 关闭模拟器访问

115 116 

5612 5612 

5613**应该怎么做：**5613**应该怎么做：**

5614 5614 

5615* 在 VS Code 中，点击错误显示的**查看输出日志**链接以查看底层故障5615* 在 VS Code 中，点击错误显示的 **View output logs** 链接以查看底层故障

5616* 在 Agent SDK 应用程序中，在消息循环周围捕获错误。[CLI 进程退出](https://code.claude.com/docs/zh-CN/agent-sdk/troubleshooting.md#cli-process-exit)下的条目涵盖了您的代码在每种 SDK 语言中接收的内容。5616* 在 Agent SDK 应用程序中，在消息循环周围捕获错误。[CLI 进程退出](https://code.claude.com/docs/zh-CN/agent-sdk/troubleshooting.md#cli-process-exit)下的条目涵盖了您的代码在每种 SDK 语言中接收的内容。

5617* 在终端中的同一项目中运行 `claude`。故障通常会在那里重现，并显示其真实错误消息，您可以在此页面上查找。5617* 在终端中的同一项目中运行 `claude`。故障通常会在那里重现，并显示其真实错误消息，您可以在此页面上查找。

5618* 在终端中运行 `claude doctor` 以检查安装和配置5618* 在终端中运行 `claude doctor` 以检查安装和配置

217| `user_prompt` | 提示文本。除非设置了门，否则值为 `<REDACTED>` | `OTEL_LOG_USER_PROMPTS` |217| `user_prompt` | 提示文本。除非设置了门，否则值为 `<REDACTED>` | `OTEL_LOG_USER_PROMPTS` |

218| `user_prompt_length` | 提示长度（字符） | |218| `user_prompt_length` | 提示长度（字符） | |

219| `interaction.sequence` | 交互的 1 基计数器，按 Claude Code 进程而不是按会话计数，如 [`event.sequence`](#event-correlation-attributes) 所述 | |219| `interaction.sequence` | 交互的 1 基计数器，按 Claude Code 进程而不是按会话计数，如 [`event.sequence`](#event-correlation-attributes) 所述 | |

220| `parent.source` | 跨度如何获得其跟踪父级：当它在入站 `TRACEPARENT` 下作为父级时为 `env`，当它启动自己的跟踪时为 `none`。需要 Claude Code v2.1.268 或更高版本 | |220| `parent.source` | 跨度如何获得其跟踪父级：当它以入站 `TRACEPARENT` 为父级时为 `env`，当它启动自己的跟踪时为 `none`。需要 Claude Code v2.1.268 或更高版本 | |

221| `interaction.duration_ms` | 转向的挂钟持续时间 | |221| `interaction.duration_ms` | 转向的挂钟持续时间 | |

222 222 

223**`claude_code.llm_request`**223**`claude_code.llm_request`**

264| `tool_name` | 工具名称 | |264| `tool_name` | 工具名称 | |

265| `tool_name_safe` | `tool_name` 的形式，不携带任何用户选择的名称。内置工具名称逐字通过。MCP 工具名称显示为 `mcp_other`，除了与几个固定形状匹配的工具名称，例如名为 `browser_*` 的 `playwright` 工具，它们逐字通过。需要 Claude Code v2.1.268 或更高版本 | |265| `tool_name_safe` | `tool_name` 的形式，不携带任何用户选择的名称。内置工具名称逐字通过。MCP 工具名称显示为 `mcp_other`，除了与几个固定形状匹配的工具名称，例如名为 `browser_*` 的 `playwright` 工具，它们逐字通过。需要 Claude Code v2.1.268 或更高版本 | |

266| `bash_command_class` | 对于 Bash 工具：命令的第一个程序的类别，来自固定列表，例如 `vcs` 或 `package_manager`。`other` 表示列表外的程序，`unparsed` 表示无法解析该行。需要 Claude Code v2.1.268 或更高版本 | |266| `bash_command_class` | 对于 Bash 工具：命令的第一个程序的类别，来自固定列表，例如 `vcs` 或 `package_manager`。`other` 表示列表外的程序，`unparsed` 表示无法解析该行。需要 Claude Code v2.1.268 或更高版本 | |

267| `bash_argv0` | 对于 Bash 工具：当命令的第一个程序在同一固定列表上时，例如 `git` 或 `npm`。`other` 表示列表外的任何程序。需要 Claude Code v2.1.268 或更高版本 | |267| `bash_argv0` | 对于 Bash 工具：当命令的第一个程序在同一固定列表上时，为该程序本身，例如 `git` 或 `npm`。`other` 表示列表外的任何程序。需要 Claude Code v2.1.268 或更高版本 | |

268| `duration_ms` | 包括权限等待和执行的挂钟持续时间 | |268| `duration_ms` | 包括权限等待和执行的挂钟持续时间 | |

269| `result_tokens` | 工具结果的近似令牌大小 | |269| `result_tokens` | 工具结果的近似令牌大小 | |

270| `agent_id` | 运行工具的子代理或队友的标识符。在主会话上不存在 | |270| `agent_id` | 运行工具的子代理或队友的标识符。在主会话上不存在 | |

16> * **您构建了 MCP 服务器并希望将其添加到 Anthropic 的目录中**：请参阅[发布到目录](https://claude.com/docs/directory/publish)16> * **您构建了 MCP 服务器并希望将其添加到 Anthropic 的目录中**：请参阅[发布到目录](https://claude.com/docs/directory/publish)

17> * **您希望在 VS Code 或 JetBrains IDE 中使用 Claude Code**：那是 VS Code 扩展或 JetBrains 插件，而不是 Claude Code 插件。请参阅[在 VS Code 中使用 Claude Code](https://code.claude.com/docs/zh-CN/vs-code.md) 或 [JetBrains IDE](https://code.claude.com/docs/zh-CN/jetbrains.md)17> * **您希望在 VS Code 或 JetBrains IDE 中使用 Claude Code**：那是 VS Code 扩展或 JetBrains 插件，而不是 Claude Code 插件。请参阅[在 VS Code 中使用 Claude Code](https://code.claude.com/docs/zh-CN/vs-code.md) 或 [JetBrains IDE](https://code.claude.com/docs/zh-CN/jetbrains.md)

18 18 

19要立即尝试插件，请在 Claude Code 终端会话中运行 `/plugin`，并从**发现**选项卡安装一个插件，该选项卡列出了来自您的市场的插件。从那里：19要立即尝试插件，请在 Claude Code 终端会话中运行 `/plugin`，并从 **Discover** 选项卡安装一个插件，该选项卡列出了来自您的市场的插件。从那里：

20 20 

21* [安装和管理插件](https://code.claude.com/docs/zh-CN/plugins/install.md)：完整的安装步骤、作用域和其他界面21* [安装和管理插件](https://code.claude.com/docs/zh-CN/plugins/install.md)：完整的安装步骤、作用域和其他界面

22* [创建插件](https://code.claude.com/docs/zh-CN/plugins/create.md)：构建您自己的插件22* [创建插件](https://code.claude.com/docs/zh-CN/plugins/create.md)：构建您自己的插件

54 54 

55您可以在每个阶段检查插件的占用空间：55您可以在每个阶段检查插件的占用空间：

56 56 

57* **安装前**：从 `/plugin` 中的**市场**选项卡打开插件。Anthropic 官方市场中的插件在那里显示**上下文成本**估计。57* **安装前**：从 `/plugin` 中的 **Marketplaces** 选项卡打开插件。Anthropic 官方市场中的插件在那里显示 **Context cost** 估计。

58* **安装后**：[测量插件成本](https://code.claude.com/docs/zh-CN/plugins/measure.md#measure-what-a-plugin-costs)显示如何读取插件的占用空间，**已安装**选项卡的**最近未使用**组列出了您可以关闭的插件。58* **安装后**：[测量插件成本](https://code.claude.com/docs/zh-CN/plugins/measure.md#measure-what-a-plugin-costs)显示如何读取插件的占用空间，**Installed** 选项卡的 **Not used recently** 组列出了您可以关闭的插件。

59* **在不卸载的情况下停止它**：使用 `/plugin` 禁用插件，或在您的 shell 中使用 `claude plugin disable`。请参阅[管理已安装的插件](https://code.claude.com/docs/zh-CN/plugins/install.md#manage-installed-plugins)。59* **在不卸载的情况下停止它**：使用 `/plugin` 禁用插件，或在您的 shell 中使用 `claude plugin disable`。请参阅[管理已安装的插件](https://code.claude.com/docs/zh-CN/plugins/install.md#manage-installed-plugins)。

60 60 

61## 从市场获取插件61## 从市场获取插件

66>66>

67> 插件市场不是 [Claude Marketplace](https://claude.com/marketplace)。Claude Marketplace 是 claude.com/marketplace 上的网站，您可以在其中浏览插件、连接器、合作伙伴产品和服务合作伙伴。它不是您使用 `/plugin marketplace add` 添加的市场。67> 插件市场不是 [Claude Marketplace](https://claude.com/marketplace)。Claude Marketplace 是 claude.com/marketplace 上的网站，您可以在其中浏览插件、连接器、合作伙伴产品和服务合作伙伴。它不是您使用 `/plugin marketplace add` 添加的市场。

68 68 

69Claude Code 在您第一次启动交互式终端会话时添加 Anthropic 的官方市场，除非[托管策略](https://code.claude.com/docs/zh-CN/plugins/org.md#allow-the-official-marketplace-and-your-own)阻止它。Claude Code 不会自行添加 Anthropic 的社区市场。要区分 Anthropic 的各个市场，请阅读 [Anthropic 的市场](https://code.claude.com/docs/zh-CN/plugins/anthropic-marketplaces.md)。要查看官方市场列出的内容，请在会话中打开 `/plugin` 的**发现**选项卡，或浏览 [Claude Marketplace](https://claude.com/marketplace/plugins)。69Claude Code 在您第一次启动交互式终端会话时添加 Anthropic 的官方市场，除非[托管策略](https://code.claude.com/docs/zh-CN/plugins/org.md#allow-the-official-marketplace-and-your-own)阻止它。Claude Code 不会自行添加 Anthropic 的社区市场。要区分 Anthropic 的各个市场，请阅读 [Anthropic 的市场](https://code.claude.com/docs/zh-CN/plugins/anthropic-marketplaces.md)。要查看官方市场列出的内容，请在会话中打开 `/plugin` 的 **Discover** 选项卡，或浏览 [Claude Marketplace](https://claude.com/marketplace/plugins)。

70 70 

71此图显示了从市场到您的会话的路径。市场列出一个插件，您安装该插件，Claude Code 加载其组件。71此图显示了从市场到您的会话的路径。市场列出一个插件，您安装该插件，Claude Code 加载其组件。

72 72 

86 86 

87## 区分 Anthropic 的市场和第三方市场87## 区分 Anthropic 的市场和第三方市场

88 88 

89市场的名称将其放在三个层级之一中。Claude Code 仅接受来自 `github.com/anthropics/` 存储库的官方和社区名称：89市场的名称将其放在三个层级之一中。Claude Code 仅对来自 `github.com/anthropics/` 存储库的市场接受官方和社区名称：

90 90 

91* **官方**：具有 Anthropic [官方市场名称](https://code.claude.com/docs/zh-CN/plugins/security.md#official-marketplace-names)之一的市场，包括 `claude-plugins-official` 和 `claude-code-plugins`。91* **官方**：具有 Anthropic [官方市场名称](https://code.claude.com/docs/zh-CN/plugins/security.md#official-marketplace-names)之一的市场，包括 `claude-plugins-official` 和 `claude-code-plugins`。

92* **社区**：具有 Anthropic 社区名称之一的市场，例如 `claude-community`。[按名称识别 Anthropic 的市场](https://code.claude.com/docs/zh-CN/plugins/security.md#marketplace-tiers)列出了它们。92* **社区**：具有 Anthropic 社区名称之一的市场，例如 `claude-community`。[按名称识别 Anthropic 的市场](https://code.claude.com/docs/zh-CN/plugins/security.md#marketplace-tiers)列出了它们。

45 45 

46## 按名称识别 Anthropic 的市场46## 按名称识别 Anthropic 的市场

47 47 

48市场的名称将其分为三个层级之一：官方、社区或第三方。Claude Code 仅接受来自 `github.com/anthropics/` 存储库的官方和社区名称用于市场，所以第三方市场不能将自己呈现为 Anthropic 的。同事或您的组织发布的市场是第三方的。48市场的名称将其分为三个层级之一：官方、社区或第三方。Claude Code 仅对来自 `github.com/anthropics/` 存储库的市场接受官方和社区名称，所以第三方市场不能将自己呈现为 Anthropic 的。同事或您的组织发布的市场是第三方的。

49 49 

50该表列出了每个层级中的市场名称：50该表列出了每个层级中的市场名称：

51 51