Documentation 2026-07-11 19:03 UTC to 2026-07-13 23:57 UTC

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# 使用 Claude Code 与屏幕阅读器

6 

7> 为 VoiceOver 和 NVDA 等屏幕阅读器设置 Claude Code，以及屏幕放大镜、减少动画和色盲友好主题的设置。

8 

9Claude Code 具有屏幕阅读器模式，可将其视觉终端界面替换为纯文本、线性文本。该模式不使用框、进度动画和原地重绘，而是打印带标签的行，屏幕阅读器（如 VoiceOver 或 NVDA）按顺序读取这些行，因此您可以进行完整对话、批准工具权限并从头到尾查看输出。

10 

11屏幕阅读器模式是可选的。如果您使用屏幕放大镜、减少动画或色盲友好主题而不是屏幕阅读器，请参阅[屏幕阅读器模式之外的辅助功能设置](#accessibility-settings-beyond-screen-reader-mode)。

12 

13<Note>

14 屏幕阅读器模式需要 Claude Code v2.1.181 或更高版本。早期版本会拒绝 `--ax-screen-reader` 标志，并显示 `error: unknown option '--ax-screen-reader'`。

15</Note>

16 

17<h2 id="turn-on-screen-reader-mode">

18 打开屏幕阅读器模式

19</h2>

20 

21选择与您使用屏幕阅读器频率相匹配的方法：

22 

23* 对于一个会话：运行 `claude --ax-screen-reader`。

24* 对于从一个 shell 启动的会话：将 `CLAUDE_AX_SCREEN_READER` 环境变量设置为 `1`。在 Bash 或 Zsh 中，运行 `export CLAUDE_AX_SCREEN_READER=1`；在 PowerShell 中，运行 `$env:CLAUDE_AX_SCREEN_READER = "1"`。将该行添加到您的 shell 配置文件以覆盖每个 shell。

25* 对于机器上的每个会话：将 `"axScreenReader": true` 添加到您的用户[设置文件](/zh-CN/settings)。这涵盖任何终端，包括 VS Code 集成终端。

26 

27<Note>

28 这些方法按优先级顺序列出：[`--ax-screen-reader`](/zh-CN/cli-reference#cli-flags) 标志覆盖 [`CLAUDE_AX_SCREEN_READER`](/zh-CN/env-vars) 环境变量，后者覆盖 [`axScreenReader`](/zh-CN/settings#available-settings) 设置。

29</Note>

30 

31如果您通过 SSH 使用 Claude Code，请在运行 Claude Code 的远程机器上设置环境变量或设置。

32 

33当模式打开时，Claude Code 打印的第一件事是一条确认行，命名打开它的方法：`[Screen Reader Mode: on via flag]`、`[Screen Reader Mode: on via env]` 或 `[Screen Reader Mode: on via settings]`；此方法命名格式需要 Claude Code v2.1.206 或更高版本。

34{/* max-version: 2.1.205 */}早期版本打印 `[Accessible screen reader mode: on]`。

35 

36<h2 id="turn-off-screen-reader-mode">

37 关闭屏幕阅读器模式

38</h2>

39 

40反转打开模式的任何方法：启动时不使用标志、取消设置环境变量或将 `axScreenReader` 设置为 `false`。设置 `CLAUDE_AX_SCREEN_READER=0` 即使设置为 `true` 也会保持模式关闭。

41 

42<h2 id="what-your-screen-reader-hears">

43 您的屏幕阅读器听到的内容

44</h2>

45 

46在屏幕阅读器模式中，Claude Code 写入平面文本：

47 

48* 界面装饰没有制表符绘制字符

49* 没有仅限颜色的提示

50* 没有未更改内容的重绘；进度旋转器呈现为静态文本

51* Claude 回复中的表格读作 `Header: value` 句子而不是制表符字符网格。{/* min-version: 2.1.198 */}需要 Claude Code v2.1.198 或更高版本；早期版本即使在屏幕阅读器模式下也将表格绘制为网格。

52 

53输出在您的终端滚动缓冲区中累积，因此您可以使用屏幕阅读器的查看命令或终端的搜索功能重新阅读早期的轮次。

54 

55屏幕阅读器模式呈现为纯滚动文本，即使您已使用 [`tui` 设置](/zh-CN/settings#available-settings)打开[全屏渲染](/zh-CN/fullscreen)；当模式处于活动状态时，该设置无效。附加的后台会话仍呈现全屏；请参阅[已知限制](#known-limitations)。

56 

57成绩单中的每条消息都以您的屏幕阅读器宣布的标签开头，命名它是什么：您的消息、Claude 的回复、工具活动、错误和提示。这些标签也是可搜索的，因此您可以通过搜索终端的滚动缓冲区在成绩单的各个部分之间跳转：

58 

59| 标签 | 含义 |

60| :--------------------- | :------------------------------------------------ |

61| `you:` | 您的消息 |

62| `claude:` | Claude 的回复 |

63| `tool:` | 工具活动，例如文件编辑或命令运行 |

64| `tool error:` | 失败的工具 |

65| `error:` | 对话中的错误，例如失败的 API 请求 |

66| `Permission Required:` | 等待您回答的权限提示 |

67| `Cost:` | Claude Code 退出时的会话成本摘要，如果您的帐户[显示成本](/zh-CN/costs) |

68 

69终端光标跟随输入插入符号，因此屏幕阅读器的读取当前行命令用您正在编辑的提示回答"我在哪里"。

70 

71<h3 id="jump-between-turns">

72 在轮次之间跳转

73</h3>

74 

75Claude Code 在轮次边界处发出 OSC 133 shell 集成标记，因此您的终端的跳转到上一个提示键可在轮次之间移动，而无需读取整个成绩单：

76 

77* iTerm2：Cmd+Shift+Up

78* VS Code 终端：Windows 上的 Ctrl+Up，macOS 上的 Cmd+Up

79* Windows Terminal：默认没有键；在其设置中绑定 `scrollToMark` 操作

80* Kitty 和 Ghostty：检查终端的文档以了解其跳转到提示键

81 

82macOS Terminal 不对标记进行操作，Claude Code 在 WezTerm 中不发出标记。在这些终端中，搜索滚动缓冲区中的 `you:` 标签。

83 

84<h2 id="answer-menus-and-prompts">

85 回答菜单和提示

86</h2>

87 

88在屏幕阅读器模式中，您通常使用箭头键导航的菜单（包括权限提示）变成编号列表。每个选项都宣布为编号行，后跟一个 `Enter selection` 提示，该提示命名有效范围。键入您想要的选项的编号，然后按 Enter。

89 

90* 要取消可关闭的菜单：按 Escape。其提示以 `or Escape to cancel` 结尾。

91* 如果您键入列表中不存在的编号：Claude Code 宣布有效范围并让您重试。

92 

93是或否提示要求输入类型答案而不是两选项菜单。回答 `y` 或 `n` 并按 Enter。`yes` 和 `no` 也可以。

94 

95<h2 id="hear-when-claude-code-needs-you">

96 听到 Claude Code 何时需要您

97</h2>

98 

99在屏幕阅读器模式中，Claude Code 在需要您注意时会响起终端铃声，因此您不必一直检查成绩单。铃声在以下情况下响起：

100 

101* Claude 完成回复

102* 出现权限提示

103* 运行时间超过 5 秒的工具完成

104 

105铃声是您的终端的标准警报。要使其静音，请更改您的终端应用程序中的铃声设置。铃声不需要屏幕阅读器模式：在模式外，将 [`preferredNotifChannel`](/zh-CN/settings#available-settings) 设置为 `"terminal_bell"` 以在 Claude 等待您时获得类似的警报。请参阅[获取终端铃声或通知](/zh-CN/terminal-config#get-a-terminal-bell-or-notification)。

106 

107<h2 id="accessibility-settings-beyond-screen-reader-mode">

108 屏幕阅读器模式之外的辅助功能设置

109</h2>

110 

111这些选项解决屏幕阅读器模式之外的辅助功能需求。所有这些都与它一起工作。

112 

113* `CLAUDE_CODE_ACCESSIBILITY` [环境变量](/zh-CN/env-vars)用于屏幕放大镜。设置 `CLAUDE_CODE_ACCESSIBILITY=1` 以保持本机终端光标可见，以便放大镜（如 macOS Zoom）可以跟踪光标位置。

114* `prefersReducedMotion` [设置](/zh-CN/settings#available-settings)减少或禁用旋转器、闪烁和其他动画，而不改变界面的其余部分。

115* `theme` [设置](/zh-CN/settings#available-settings)选择界面颜色，包括色盲友好的 `dark-daltonized` 和 `light-daltonized` 主题。

116 

117<h2 id="known-limitations">

118 已知限制

119</h2>

120 

121某些行为不适应屏幕阅读器模式：

122 

123* 屏幕阅读器模式在屏幕阅读器运行时不会自动打开。

124* 模式更改（例如进入[计划模式](/zh-CN/permission-modes#analyze-before-you-edit-with-plan-mode)）尚未宣布。

125* 使用 `claude attach` 或从代理视图附加到[后台会话](/zh-CN/agent-view)会进入终端的备用屏幕，该屏幕没有本机滚动缓冲区。这与[其他附加会话的行为相同](/zh-CN/fullscreen)。要退出，请在空提示上按左箭头，或如果对话框有焦点，请按 Ctrl+Z。

126* Claude Code 在退出时打印的摘要中宣布成本，而不是每轮。

127* 屏幕阅读器模式不改变带有 `-p` 标志的[非交互模式](/zh-CN/headless)。非交互模式已经写入纯文本，并且仍然是脚本编写的替代方案。

128 

129<h2 id="report-an-issue">

130 报告问题

131</h2>

132 

133如果屏幕阅读器、放大镜或终端出现问题，请在 [Claude Code 问题跟踪器](https://github.com/anthropics/claude-code/issues)上打开问题，并在标题中提及您的辅助技术。在报告中包括您的操作系统、终端应用程序以及辅助技术名称和版本。

134 

135<h2 id="related-resources">

136 相关资源

137</h2>

138 

139这些页面包含此页面涵盖内容的完整参考条目和相关设置：

140 

141* [Settings](/zh-CN/settings#available-settings)：`axScreenReader`、`prefersReducedMotion`、`theme` 和 `preferredNotifChannel` 条目

142* [Environment variables](/zh-CN/env-vars)：`CLAUDE_AX_SCREEN_READER` 和 `CLAUDE_CODE_ACCESSIBILITY` 条目

143* [CLI reference](/zh-CN/cli-reference#cli-flags)：`--ax-screen-reader` 标志

144* [Terminal configuration](/zh-CN/terminal-config)：屏幕阅读器模式外的铃声、通知和主题

145* [Non-interactive mode](/zh-CN/headless)：脚本化 `claude -p` 运行，写入纯文本而不使用屏幕阅读器模式

69 69 

70请参阅 [Server-managed settings](/zh-CN/server-managed-settings) 和 [Settings files and precedence](/zh-CN/settings#settings-files)。70请参阅 [Server-managed settings](/zh-CN/server-managed-settings) 和 [Settings files and precedence](/zh-CN/settings#settings-files)。

71 71 

72<h3 id="wsl-sessions-in-claude-code-desktop">

73 WSL 会话在 Claude Code Desktop 中

74</h3>

75 

76在 Windows 上，[Claude Code Desktop 可以在 WSL 2 发行版内运行 Code 会话](/zh-CN/desktop-wsl)。会话的 Claude Code 进程在发行版内运行，因此它通过上述 WSL 发现路径解析托管设置：除非部署了 `wslInheritsWindowsSettings: true`，否则仅限 Windows 的来源无法到达它。

77 

78在存在托管设置的设备上，Desktop WSL 会话默认不可用。如果您的组织想要启用它们，请联系您的 Anthropic 账户团队。启用后：

79 

80* 通过 HKLM 注册表或 `C:\Program Files\ClaudeCode` 文件部署 `wslInheritsWindowsSettings: true`，以便 WSL 会话继承与主机会话相同的策略。

81* 通过在 WSL 会话内运行 `/status` 进行验证：`Setting sources` 行应显示 `Enterprise managed settings` 以及您部署的 Windows 来源，`(HKLM)` 或 `(file)`。

82 

83WSL 2 实用程序 VM 内的进程对 Windows 端端点检测传感器不可见。如果您使用 CrowdStrike Falcon，请在 WSL 2 上启用 Falcon Linux 传感器，并使用 CrowdStrike 的 WSL 文档所需的两个排除项，用于 WSL 虚拟机进程和 VM 磁盘映像，以便可以观察到发行版内的进程和文件活动。Claude Code 的 [OpenTelemetry 工具执行遥测](/zh-CN/monitoring-usage) 对 WSL 和本机会话的发出方式相同。

84 

72<h2 id="decide-what-to-enforce">85<h2 id="decide-what-to-enforce">

73 决定要强制执行的内容86 决定要强制执行的内容

74</h2>87</h2>

100 设置使用情况可见性113 设置使用情况可见性

101</h2>114</h2>

102 115 

103根据您需要报告的内容选择监控。116根据您需要报告的内容选择监控。仪表板、API 和支出控制在 Claude for Teams 或 Enterprise 计划与 Claude Console 组织之间有所不同，因此在围绕某项功能规划报告之前，请检查"可用性"列。

104 117 

105| 功能 | 您获得的内容 | 可用性 | 从何处开始 |118| 功能 | 您获得的内容 | 可用性 | 从何处开始 |

106| :------------------ | :------------------------- | :------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------ |119| :--------------------- | :------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------- |

107| Usage monitoring | 会话、工具和令牌的 OpenTelemetry 导出 | 所有提供商 | [Monitoring usage](/zh-CN/monitoring-usage) |120| Usage monitoring | 会话、工具和令牌的 OpenTelemetry 导出 | 所有提供商 | [Monitoring usage](/zh-CN/monitoring-usage) |

108| Analytics dashboard | 每用户指标、贡献跟踪、排行榜 | 仅 Anthropic | [Analytics](/zh-CN/analytics) |121| Analytics dashboard | Teams / Enterprise 上具有排行榜的采用和贡献指标；Console 上的每用户使用情况和支出指标 | Teams / Enterprise 在 [claude.ai/analytics](https://claude.ai/analytics/claude-code)，Console 在 [platform.claude.com/claude-code](https://platform.claude.com/claude-code) | [Analytics](/zh-CN/analytics) |

109| Cost tracking | 支出限制、速率限制和使用情况归属 | Anthropic；在第三方云上，[Claude apps gateway](/zh-CN/claude-apps-gateway) 提供每用户归属和[支出限制](/zh-CN/claude-apps-gateway-spend-limits) | [Costs](/zh-CN/costs) |122| Programmatic reporting | 通过 API 的每用户使用情况和成本数据 | Enterprise 的 [Enterprise Analytics API](https://support.claude.com/en/articles/13703965-claude-enterprise-analytics-api-reference-guide)，Console 的 [Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api) | [Costs](/zh-CN/costs#manage-costs-for-your-organization) |

123| Spend controls | 支出限制和速率限制 | Teams / Enterprise 的管理员设置，Console 的工作区限制；在第三方云上，云预算控制或具有每用户[支出限制](/zh-CN/claude-apps-gateway-spend-limits)的 [Claude apps gateway](/zh-CN/claude-apps-gateway) | [Costs](/zh-CN/costs#manage-costs-for-your-organization) |

110 124 

111云提供商通过 AWS Cost Explorer、GCP Billing 或 Azure Cost Management 公开支出。Claude for Teams 和 Enterprise 计划在 [claude.ai/analytics/claude-code](https://claude.ai/analytics/claude-code) 包含使用情况仪表板。125在 Teams 和 Enterprise 上，每用户使用情况和支出数字来自您组织的分析设置中的[支出报告](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans)，而不是分析仪表板。云提供商通过 AWS Cost Explorer、GCP Billing 或 Azure Cost Management 公开支出。有关跨 Claude chat、Claude Code 和 Cowork 规划企业预算的信息，请参阅 [Claude Enterprise consumption guide](https://support.claude.com/en/articles/14782391-claude-enterprise-consumption-guide)。

112 126 

113<h2 id="review-data-handling">127<h2 id="review-data-handling">

114 审查数据处理128 审查数据处理

6 6 

7> 将您的主模型与更强大的顾问模型配对，Claude 在任务期间的关键时刻咨询该模型。7> 将您的主模型与更强大的顾问模型配对，Claude 在任务期间的关键时刻咨询该模型。

8 8 

9{/* plan-availability: feature=advisor providers=anthropic */}

10 

11<Note>9<Note>

12 顾问工具是实验性的，需要 Claude Code v2.1.98 或更高版本以及 Anthropic API。它在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用。行为、定价和可用性可能会改变。10 顾问工具是实验性的，需要 Anthropic API。它在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用。行为、定价和可用性可能会改变。

13</Note>11</Note>

14 12 

15顾问工具让 Claude 在任务期间的关键时刻咨询第二个通常更强大的模型，例如在提交方法之前、陷入重复错误时或在声明任务完成之前。顾问接收完整的对话，包括每个工具调用和结果，并返回 Claude 在继续之前应用的指导。13顾问工具让 Claude 在任务期间的关键时刻咨询第二个通常更强大的模型，例如在提交方法之前、陷入重复错误时或在声明任务完成之前。顾问接收完整的对话，包括每个工具调用和结果，并返回 Claude 在继续之前应用的指导。

161 159 

162顾问工具需要以下所有条件：160顾问工具需要以下所有条件：

163 161 

164* **Claude Code v2.1.98 或更高版本**：运行 `claude update` 进行升级。

165* **仅 Anthropic API**：顾问是服务器执行的工具。它在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用。通过配置了 `ANTHROPIC_BASE_URL` 的 [LLM 网关](/zh-CN/llm-gateway)，可用性取决于网关是否将请求完整转发到 Anthropic API。162* **仅 Anthropic API**：顾问是服务器执行的工具。它在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用。通过配置了 `ANTHROPIC_BASE_URL` 的 [LLM 网关](/zh-CN/llm-gateway)，可用性取决于网关是否将请求完整转发到 Anthropic API。

166* **支持的主模型**：Opus 4.6 或更高版本、Sonnet 4.6 或更高版本，或 Haiku 4.5。{/* min-version: 2.1.170 */}Fable 5 在 Claude Code v2.1.170 或更高版本上也符合条件。163* **支持的主模型**：Opus 4.6 或更高版本、Sonnet 4.6 或更高版本，或 Haiku 4.5。{/* min-version: 2.1.170 */}Fable 5 在 Claude Code v2.1.170 或更高版本上也符合条件。

167 164 

497 OAuth2 身份验证497 OAuth2 身份验证

498</h3>498</h3>

499 499 

500[MCP 规范支持 OAuth 2.1](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization) 用于授权。SDK 不会自动处理 OAuth 流程，但您可以在应用程序中完成 OAuth 流程后通过标头传递访问令牌：500[MCP 规范支持 OAuth 2.1](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization) 用于授权。SDK 不会打开浏览器或运行交互式 OAuth 流程。当配置的服务器返回授权质询且没有可用的存储令牌时，代理运行将继续而不使用该服务器的工具，并且该服务器在 [系统初始化消息](/zh-CN/agent-sdk/typescript#sdksystemmessage) 的 `mcp_servers` 数组中报告状态为 `needs-auth`。如果您的代理依赖于特定服务器的连接，请在启动时检查该数组。

501 

502要提供凭据，请在您自己的应用程序中完成 OAuth 流程，并在服务器的 `headers` 中传递生成的访问令牌：

501 503 

502<CodeGroup>504<CodeGroup>

503 ```typescript TypeScript theme={null}505 ```typescript TypeScript theme={null}

62 ```62 ```

63 </Tab>63 </Tab>

64 64 

65 <Tab title="Python">65 <Tab title="Python (uv)">

66 [uv](https://docs.astral.sh/uv/) 是一个快速的 Python 包管理器，可以自动处理虚拟环境：

67 

68 ```bash theme={null}

69 uv init

70 uv add claude-agent-sdk

71 ```

72 </Tab>

73 

74 <Tab title="Python (pip)">

75 创建并激活虚拟环境，然后安装该包。安装到虚拟环境中可以避免 `error: externally-managed-environment` 失败，该失败是最近的 Debian、Ubuntu 和 Homebrew 安装上的系统 Python 在 venv 外运行 `pip install` 时返回的。

76 

77 在 macOS 或 Linux 上：

78 

66 ```bash theme={null}79 ```bash theme={null}

80 python3 -m venv .venv

81 source .venv/bin/activate

82 pip install claude-agent-sdk

83 ```

84 

85 在 Windows 上：

86 

87 ```powershell theme={null}

88 py -m venv .venv

89 .venv\Scripts\Activate.ps1

67 pip install claude-agent-sdk90 pip install claude-agent-sdk

68 ```91 ```

69 92 

93 如果 PowerShell 因执行策略错误而阻止 `Activate.ps1`，请先运行 `Set-ExecutionPolicy -Scope Process RemoteSigned`。

94 

70 Python 包需要 Python 3.10 或更高版本。如果 pip 报告 `No matching distribution found for claude-agent-sdk`，说明您的解释器版本早于 3.10。在 macOS 或 Linux 上运行 `python3 --version`，或在 Windows 上运行 `py --version`，以检查版本。95 Python 包需要 Python 3.10 或更高版本。如果 pip 报告 `No matching distribution found for claude-agent-sdk`，说明您的解释器版本早于 3.10。在 macOS 或 Linux 上运行 `python3 --version`，或在 Windows 上运行 `py --version`，以检查版本。

71 </Tab>96 </Tab>

72 </Tabs>97 </Tabs>

77 </Step>102 </Step>

78 103 

79 <Step title="设置您的 API 密钥">104 <Step title="设置您的 API 密钥">

80 从[控制台](https://platform.claude.com/)获取 API 密钥，然后将其设置为环境变量：105 从[控制台](https://platform.claude.com/)获取 API 密钥，然后将其设置为环境变量。

106 

107 在 macOS 或 Linux 上：

81 108 

82 ```bash theme={null}109 ```bash theme={null}

83 export ANTHROPIC_API_KEY=your-api-key110 export ANTHROPIC_API_KEY=sk-ant-xxxxx

111 ```

112 

113 在 Windows PowerShell 上：

114 

115 ```powershell theme={null}

116 $env:ANTHROPIC_API_KEY = "sk-ant-xxxxx"

84 ```117 ```

85 118 

86 SDK 还支持通过第三方 API 提供商进行身份验证：119 SDK 还支持通过第三方 API 提供商进行身份验证：

10 安装10 安装

11</h2>11</h2>

12 12 

13在虚拟环境中安装该包。在最近的 Debian、Ubuntu 和 Homebrew Python 安装上，针对系统 Python 运行 `pip install` 会失败，出现 `error: externally-managed-environment` 错误。

14 

13```bash theme={null}15```bash theme={null}

16python3 -m venv .venv

17source .venv/bin/activate

14pip install claude-agent-sdk18pip install claude-agent-sdk

15```19```

16 20 

21有关 uv、Windows PowerShell 和 API 密钥设置，请参阅 [Agent SDK 概述中的入门](/zh-CN/agent-sdk/overview#get-started)。

22 

17<h2 id="choosing-between-query-and-claudesdkclient">23<h2 id="choosing-between-query-and-claudesdkclient">

18 在 `query()` 和 `ClaudeSDKClient` 之间选择24 在 `query()` 和 `ClaudeSDKClient` 之间选择

19</h2>25</h2>

332 启动模型检查332 启动模型检查

333</h2>333</h2>

334 334 

335当 Claude Code 启动并配置了 Amazon Bedrock 时，它会验证它打算使用的模型在您的账户中是否可访问。此检查需要 Claude Code v2.1.94 或更高版本。335当 Claude Code 启动并配置了 Amazon Bedrock 时，它会验证它打算使用的模型在您的账户中是否可访问。

336 336 

337如果您固定了一个比当前 Claude Code 默认值更旧的模型版本，并且您的账户可以调用较新版本，Claude Code 会提示您更新固定。接受会将新模型 ID 写入您的[用户设置文件](/zh-CN/settings)并重启 Claude Code。拒绝会被记住，直到下一个默认版本更改。指向[应用推理配置文件 ARN](#map-each-model-version-to-an-inference-profile) 的固定会被跳过，因为这些由您的管理员管理。337如果您固定了一个比当前 Claude Code 默认值更旧的模型版本，并且您的账户可以调用较新版本，Claude Code 会提示您更新固定。接受会将新模型 ID 写入您的[用户设置文件](/zh-CN/settings)并重启 Claude Code。拒绝会被记住，直到下一个默认版本更改。指向[应用推理配置文件 ARN](#map-each-model-version-to-an-inference-profile) 的固定会被跳过，因为这些由您的管理员管理。

338 338 

435 435 

436Mantle 是一个 Amazon Bedrock 端点，通过原生 Anthropic API 形状而不是 Amazon Bedrock Invoke API 提供 Claude 模型。它使用相同的 AWS 凭证、IAM 权限和本页面前面描述的 `awsAuthRefresh` 配置。436Mantle 是一个 Amazon Bedrock 端点，通过原生 Anthropic API 形状而不是 Amazon Bedrock Invoke API 提供 Claude 模型。它使用相同的 AWS 凭证、IAM 权限和本页面前面描述的 `awsAuthRefresh` 配置。

437 437 

438<Note>

439 Mantle 需要 Claude Code v2.1.94 或更高版本。运行 `claude --version` 来检查。

440</Note>

441 

442<h3 id="enable-mantle">438<h3 id="enable-mantle">

443 启用 Mantle439 启用 Mantle

444</h3>440</h3>

26* **排行榜**：按 Claude Code 使用情况排名的顶级贡献者26* **排行榜**：按 Claude Code 使用情况排名的顶级贡献者

27* **数据导出**：将贡献数据下载为 CSV 格式以进行自定义报告27* **数据导出**：将贡献数据下载为 CSV 格式以进行自定义报告

28 28 

29对于每个用户的令牌计数和成本估计，请配置 [OpenTelemetry 导出](/zh-CN/monitoring-usage)。29对于每个用户的令牌计数和成本估计，请配置 [OpenTelemetry 导出](/zh-CN/monitoring-usage)，或从您组织的分析设置中导出 [支出报告](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans)，其中列出了每个用户和每个模型的令牌使用情况和估计的使用额度支出。

30 30 

31<h3 id="enable-contribution-metrics">31<h3 id="enable-contribution-metrics">

32 启用贡献指标32 启用贡献指标

228 以编程方式访问数据228 以编程方式访问数据

229</h4>229</h4>

230 230 

231要通过 GitHub 查询此数据，请搜索标记为 `claude-code-assisted` 的 PR。231在 Enterprise 计划上，[Claude Enterprise Analytics API](https://support.claude.com/en/articles/13703965-claude-enterprise-analytics-api-reference-guide) 为您的组织返回每个用户的参与度、使用情况和成本报告，涵盖 Claude 的所有表面，包括 Claude Code。主要所有者在 [claude.ai/analytics/api-keys](https://claude.ai/analytics/api-keys) 处使用 `read:analytics` 范围创建密钥。该 API 在 Teams 计划上不可用。

232 

233要通过 GitHub 查询贡献数据，请搜索标记为 `claude-code-assisted` 的 PR。

232 234 

233<h2 id="access-analytics-for-api-customers">235<h2 id="access-analytics-for-api-customers">

234 访问 API 客户的分析236 访问 API 客户的分析

235</h2>237</h2>

236 238 

237使用 Claude Console 的 API 客户可以在 [platform.claude.com/claude-code](https://platform.claude.com/claude-code) 访问分析。您需要 UsageView 权限来访问仪表板，该权限授予开发者、计费、管理员、所有者和主要所有者角色。239使用 Claude Console 的 API 客户可以在 [platform.claude.com/claude-code](https://platform.claude.com/claude-code) 访问分析。您需要 UsageView 权限来访问仪表板，该权限授予开发者、计费、管理员、所有者和主要所有者角色。要以编程方式拉取相同的每日每用户指标，请使用 [Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api) 和管理员 API 密钥。

238 240 

239<Note>241<Note>

240 贡献指标与 GitHub 集成目前不可用于 API 客户。Console 仪表板仅显示使用和支出指标。242 贡献指标与 GitHub 集成目前不可用于 API 客户。Console 仪表板仅显示使用和支出指标。

514 在 CI、pre-commit hooks 或脚本中使用 `claude -p "prompt"`。添加 `--output-format stream-json --verbose` 用于流式 JSON 输出。514 在 CI、pre-commit hooks 或脚本中使用 `claude -p "prompt"`。添加 `--output-format stream-json --verbose` 用于流式 JSON 输出。

515</Tip>515</Tip>

516 516 

517使用 `claude -p "your prompt"`，你可以非交互地运行 Claude，不需要会话。[非交互模式](/zh-CN/headless)是你将 Claude 集成到 CI 管道、pre-commit hooks 或任何自动化工作流中的方式。输出格式让你以编程方式解析结果：纯文本、JSON 或流式 JSON。517使用 `claude -p "your prompt"`，你可以非交互地运行 Claude，不需要交互式提示。该运行仍然会创建一个可恢复的会话，除非你传递 `--no-session-persistence`。[非交互模式](/zh-CN/headless)是你将 Claude 集成到 CI 管道、pre-commit hooks 或任何自动化工作流中的方式。输出格式让你以编程方式解析结果：纯文本、JSON 或流式 JSON。

518 518 

519```bash theme={null}519```bash theme={null}

520# One-off queries520# One-off queries

7> 使用 channels 从 MCP 服务器将消息、警报和 webhooks 推送到您的 Claude Code 会话中。转发 CI 结果、聊天消息和监控事件，以便 Claude 在您离开时做出反应。7> 使用 channels 从 MCP 服务器将消息、警报和 webhooks 推送到您的 Claude Code 会话中。转发 CI 结果、聊天消息和监控事件，以便 Claude 在您离开时做出反应。

8 8 

9<Note>9<Note>

10 Channels 处于[研究预览](#research-preview)阶段，需要 Claude Code v2.1.80 或更高版本。它们需要通过 claude.ai 或控制台 API 密钥进行 Anthropic 身份验证，在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用。Team 和 Enterprise 组织必须[明确启用它们](#enterprise-controls)。10 Channels 处于[研究预览](#research-preview)阶段。它们需要通过 claude.ai 或控制台 API 密钥进行 Anthropic 身份验证，在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用。Team 和 Enterprise 组织必须[明确启用它们](#enterprise-controls)。

11</Note>11</Note>

12 12 

13Channel 是一个 MCP 服务器，它将事件推送到您运行中的 Claude Code 会话中，以便 Claude 可以对您不在终端时发生的事情做出反应。Channels 可以是双向的：Claude 读取事件并通过同一 channel 回复，就像聊天桥接一样。事件仅在会话打开时到达，因此对于始终在线的设置，您可以在后台进程或持久终端中运行 Claude。13Channel 是一个 MCP 服务器，它将事件推送到您运行中的 Claude Code 会话中，以便 Claude 可以对您不在终端时发生的事情做出反应。Channels 可以是双向的：Claude 读取事件并通过同一 channel 回复，就像聊天桥接一样。事件仅在会话打开时到达，因此对于始终在线的设置，您可以在后台进程或持久终端中运行 Claude。

7> 构建一个 MCP 服务器，将 webhooks、警报和聊天消息推送到 Claude Code 会话中。频道合约的参考：能力声明、通知事件、回复工具、发送者门控和权限中继。7> 构建一个 MCP 服务器，将 webhooks、警报和聊天消息推送到 Claude Code 会话中。频道合约的参考：能力声明、通知事件、回复工具、发送者门控和权限中继。

8 8 

9<Note>9<Note>

10 Channels 处于[研究预览](/zh-CN/channels#research-preview)阶段，需要 Claude Code v2.1.80 或更高版本。Team 和 Enterprise 组织必须[明确启用它们](/zh-CN/channels#enterprise-controls)。10 Channels 处于[研究预览](/zh-CN/channels#research-preview)阶段。Team 和 Enterprise 组织必须[明确启用它们](/zh-CN/channels#enterprise-controls)。

11</Note>11</Note>

12 12 

13Channel 是一个 MCP 服务器，它将事件推送到 Claude Code 会话中，以便 Claude 可以对终端外发生的事情做出反应。13Channel 是一个 MCP 服务器，它将事件推送到 Claude Code 会话中，以便 Claude 可以对终端外发生的事情做出反应。

453 中继权限提示453 中继权限提示

454</h2>454</h2>

455 455 

456<Note>

457 权限中继需要 Claude Code v2.1.81 或更高版本。较早的版本忽略 `claude/channel/permission` 能力。

458</Note>

459 

460当 Claude 调用需要批准的工具时，本地终端对话打开，会话等待。双向频道可以选择加入以在并行接收相同的提示，并将其中继到您的另一台设备。两者都保持活动：您可以在终端或手机上回答，Claude Code 应用先到达的任何答案并关闭另一个。456当 Claude 调用需要批准的工具时，本地终端对话打开，会话等待。双向频道可以选择加入以在并行接收相同的提示，并将其中继到您的另一台设备。两者都保持活动：您可以在终端或手机上回答，Claude Code 应用先到达的任何答案并关闭另一个。

461 457 

462中继涵盖工具使用批准，如 Bash、Write 和 Edit。项目信任和 MCP 服务器同意对话不中继；这些仅在本地终端中出现。458中继涵盖工具使用批准，如 Bash、Write 和 Edit。项目信任和 MCP 服务器同意对话不中继；这些仅在本地终端中出现。

12 checkpointing 如何工作12 checkpointing 如何工作

13</h2>13</h2>

14 14 

15当您与 Claude 合作时，checkpointing 会自动捕获每次编辑前代码的状态。这个安全网让您可以放心地执行雄心勃勃的大规模任务，因为您始终可以返回到之前的代码状态。15当您与 Claude 合作时，checkpointing 会自动捕获每次用户提示前代码的状态。这个安全网让您可以放心地执行雄心勃勃的大规模任务，因为您始终可以返回到之前的代码状态。

16 16 

17<h3 id="automatic-tracking">17<h3 id="automatic-tracking">

18 自动跟踪18 自动跟踪

21Claude Code 跟踪其文件编辑工具所做的所有更改：21Claude Code 跟踪其文件编辑工具所做的所有更改：

22 22 

23* 每个用户提示都会创建一个新的 checkpoint23* 每个用户提示都会创建一个新的 checkpoint

24* Checkpoints 在会话之间持久存在，因此您可以在恢复的对话中访问它们24* Checkpoints 与对话一起保存，因此恢复的会话仍然可以 `/rewind` 到它们

25* 在 30 天后自动清理（可配置）25* 在 30 天后自动清理（可配置）

26 26 

27<h3 id="rewind-and-summarize">27<h3 id="rewind-and-summarize">

36 36 

37* [Google Chrome](https://www.google.com/chrome/) 或 [Microsoft Edge](https://www.microsoft.com/edge) 浏览器37* [Google Chrome](https://www.google.com/chrome/) 或 [Microsoft Edge](https://www.microsoft.com/edge) 浏览器

38* [Claude in Chrome 扩展程序](https://chromewebstore.google.com/detail/claude/fcoeoabgfenejglbffodgkkbkcdhcgfn) 版本 1.0.36 或更高版本，可在 Chrome Web Store 中为两个浏览器获得38* [Claude in Chrome 扩展程序](https://chromewebstore.google.com/detail/claude/fcoeoabgfenejglbffodgkkbkcdhcgfn) 版本 1.0.36 或更高版本，可在 Chrome Web Store 中为两个浏览器获得

39* [Claude Code](/zh-CN/quickstart#step-1-install-claude-code) 版本 2.0.73 或更高版本39* [Claude Code](/zh-CN/quickstart#step-1-install-claude-code)

40* 直接 Anthropic 计划（Pro、Max、Team 或 Enterprise）40* 直接 Anthropic 计划（Pro、Max、Team 或 Enterprise）

41 41 

42<Note>42<Note>

59| 标志 | 描述 | 示例 |59| 标志 | 描述 | 示例 |

60| :---------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------- |60| :---------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------- |

61| `--add-dir` | 为 Claude 添加额外的工作目录以读取和编辑文件。授予文件访问权限；大多数 `.claude/` 配置 [不会从这些目录中发现](/zh-CN/permissions#additional-directories-grant-file-access-not-configuration)。验证每个路径是否存在为目录。要在会话间持久化这些目录，请在设置中设置 [`permissions.additionalDirectories`](/zh-CN/settings#permission-settings) | `claude --add-dir ../apps ../lib` |61| `--add-dir` | 为 Claude 添加额外的工作目录以读取和编辑文件。授予文件访问权限；大多数 `.claude/` 配置 [不会从这些目录中发现](/zh-CN/permissions#additional-directories-grant-file-access-not-configuration)。验证每个路径是否存在为目录。要在会话间持久化这些目录，请在设置中设置 [`permissions.additionalDirectories`](/zh-CN/settings#permission-settings) | `claude --add-dir ../apps ../lib` |

62| `--advisor <model>` | {/* min-version: 2.1.98 */}为此会话启用服务器端 [advisor tool](/zh-CN/advisor)，使用模型别名：`opus`、`sonnet` 或 `fable`（{/* min-version: 2.1.170 */}v2.1.170+），或完整模型 ID。优先于会话的 `advisorModel` 设置。需要 Claude Code v2.1.98 或更高版本 | `claude --advisor opus` |62| `--advisor <model>` | 为此会话启用服务器端 [advisor tool](/zh-CN/advisor)，使用模型别名：`opus`、`sonnet` 或 `fable`（{/* min-version: 2.1.170 */}v2.1.170+），或完整模型 ID。优先于会话的 `advisorModel` 设置 | `claude --advisor opus` |

63| `--agent` | 为当前会话指定代理（覆盖 `agent` 设置） | `claude --agent my-custom-agent` |63| `--agent` | 为当前会话指定代理（覆盖 `agent` 设置） | `claude --agent my-custom-agent` |

64| `--agents` | 通过 JSON 动态定义自定义 subagents。使用与 subagent [frontmatter](/zh-CN/sub-agents#supported-frontmatter-fields) 相同的字段名称，加上代理指令的 `prompt` 字段 | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |64| `--agents` | 通过 JSON 动态定义自定义 subagents。使用与 subagent [frontmatter](/zh-CN/sub-agents#supported-frontmatter-fields) 相同的字段名称，加上代理指令的 `prompt` 字段 | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |

65| `--allow-dangerously-skip-permissions` | 将 `bypassPermissions` 添加到 `Shift+Tab` 模式循环中而不启动它。允许您以不同的模式（如 `plan`）开始，稍后切换到 `bypassPermissions`。请参阅 [权限模式](/zh-CN/permission-modes#skip-all-checks-with-bypasspermissions-mode) | `claude --permission-mode plan --allow-dangerously-skip-permissions` |65| `--allow-dangerously-skip-permissions` | 将 `bypassPermissions` 添加到 `Shift+Tab` 模式循环中而不启动它。允许您以不同的模式（如 `plan`）开始，稍后切换到 `bypassPermissions`。请参阅 [权限模式](/zh-CN/permission-modes#skip-all-checks-with-bypasspermissions-mode) | `claude --permission-mode plan --allow-dangerously-skip-permissions` |

67| `--append-subagent-system-prompt` | {/* min-version: 2.1.205 */}将自定义文本附加到每个 [subagent](/zh-CN/sub-agents) 的系统提示末尾，包括嵌套的 subagents。仅在非交互模式下与 `-p` 一起应用。需要 Claude Code v2.1.205 或更高版本 | `claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"` |67| `--append-subagent-system-prompt` | {/* min-version: 2.1.205 */}将自定义文本附加到每个 [subagent](/zh-CN/sub-agents) 的系统提示末尾，包括嵌套的 subagents。仅在非交互模式下与 `-p` 一起应用。需要 Claude Code v2.1.205 或更高版本 | `claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"` |

68| `--append-system-prompt` | 将自定义文本附加到默认系统提示的末尾 | `claude --append-system-prompt "Always use TypeScript"` |68| `--append-system-prompt` | 将自定义文本附加到默认系统提示的末尾 | `claude --append-system-prompt "Always use TypeScript"` |

69| `--append-system-prompt-file` | 从文件加载额外的系统提示文本并附加到默认提示 | `claude --append-system-prompt-file ./extra-rules.txt` |69| `--append-system-prompt-file` | 从文件加载额外的系统提示文本并附加到默认提示 | `claude --append-system-prompt-file ./extra-rules.txt` |

70| `--ax-screen-reader` | {/* min-version: 2.1.181 */}渲染屏幕阅读器友好的输出：没有装饰性边框或动画的平面文本。强制使用经典渲染器，因此 [`tui`](/zh-CN/settings#available-settings) 设置在会话期间无效。优先于 [`CLAUDE_AX_SCREEN_READER`](/zh-CN/env-vars) 和 [`axScreenReader`](/zh-CN/settings#available-settings) 设置。需要 Claude Code v2.1.181 或更高版本 | `claude --ax-screen-reader` |70| `--ax-screen-reader` | {/* min-version: 2.1.181 */}渲染屏幕阅读器友好的输出：没有装饰性边框或动画的平面文本。强制使用经典渲染器，因此 [`tui`](/zh-CN/settings#available-settings) 设置在会话期间无效；附加的 [后台会话](/zh-CN/agent-view) 仍然全屏渲染。优先于 [`CLAUDE_AX_SCREEN_READER`](/zh-CN/env-vars) 和 [`axScreenReader`](/zh-CN/settings#available-settings) 设置。需要 Claude Code v2.1.181 或更高版本 | `claude --ax-screen-reader` |

71| `--bare` | 最小模式：跳过 hooks、skills、plugins、MCP 服务器、自动内存和 CLAUDE.md 的自动发现，以便脚本化调用启动更快。Claude 可以访问 Bash、文件读取和文件编辑工具。设置 [`CLAUDE_CODE_SIMPLE`](/zh-CN/env-vars)。请参阅 [bare mode](/zh-CN/headless#start-faster-with-bare-mode) | `claude --bare -p "query"` |71| `--bare` | 最小模式：跳过 hooks、skills、plugins、MCP 服务器、自动内存和 CLAUDE.md 的自动发现，以便脚本化调用启动更快。Claude 可以访问 Bash、文件读取和文件编辑工具。设置 [`CLAUDE_CODE_SIMPLE`](/zh-CN/env-vars)。请参阅 [bare mode](/zh-CN/headless#start-faster-with-bare-mode) | `claude --bare -p "query"` |

72| `--betas` | 要包含在 API 请求中的 Beta 标头（仅限 API 密钥用户） | `claude --betas interleaved-thinking` |72| `--betas` | 要包含在 API 请求中的 Beta 标头（仅限 API 密钥用户） | `claude --betas interleaved-thinking` |

73| `--bg`, `--background` | 启动会话作为 [后台代理](/zh-CN/agent-view) 并立即返回。打印会话 ID 和管理命令。与 `--exec` 结合以作为后台作业运行 shell 命令而不是 Claude 会话，或与 `--agent` 结合以运行特定的 subagent。{/* min-version: 2.1.198 */}不能与 `-p`/`--print` 结合；请参阅 [错误参考](/zh-CN/errors#command-line-errors) | `claude --bg "investigate the flaky test"` |73| `--bg`, `--background` | 启动会话作为 [后台代理](/zh-CN/agent-view) 并立即返回。打印会话 ID 和管理命令。与 `--exec` 结合以作为后台作业运行 shell 命令而不是 Claude 会话，或与 `--agent` 结合以运行特定的 subagent。{/* min-version: 2.1.198 */}不能与 `-p`/`--print` 结合；请参阅 [错误参考](/zh-CN/errors#command-line-errors) | `claude --bg "investigate the flaky test"` |

50| 命令 | 用途 |50| 命令 | 用途 |

51| :--------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |51| :--------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

52| `/add-dir <path>` | 为当前会话期间的文件访问添加工作目录。大多数 `.claude/` 配置[不会从添加的目录中发现](/zh-CN/permissions#additional-directories-grant-file-access-not-configuration)。您可以稍后使用 `--continue` 或 `--resume` 从添加的目录恢复会话 |52| `/add-dir <path>` | 为当前会话期间的文件访问添加工作目录。大多数 `.claude/` 配置[不会从添加的目录中发现](/zh-CN/permissions#additional-directories-grant-file-access-not-configuration)。您可以稍后使用 `--continue` 或 `--resume` 从添加的目录恢复会话 |

53| `/advisor [model\|off]` | {/* min-version: 2.1.98 */}启用或禁用[顾问工具](/zh-CN/advisor)，它在任务期间的关键时刻咨询第二个模型以获取指导。接受 `opus`、`sonnet`、`fable`（{/* min-version: 2.1.170 */}v2.1.170+）或完整模型 ID。不带参数时，打开选择器。需要 Claude Code v2.1.98 或更高版本 |53| `/advisor [model\|off]` | 启用或禁用[顾问工具](/zh-CN/advisor)，它在任务期间的关键时刻咨询第二个模型以获取指导。接受 `opus`、`sonnet`、`fable`（{/* min-version: 2.1.170 */}v2.1.170+）或完整模型 ID。不带参数时，打开选择器 |

54| `/agents` | {/* min-version: 2.1.198 */}从 v2.1.198 开始，运行 `/agents` 会打印一个提醒，要求您询问 Claude 创建或管理 [subagents](/zh-CN/sub-agents)，或直接编辑 `.claude/agents/` 或 `~/.claude/agents/`。{/* max-version: 2.1.197 */}在 v2.1.197 及更早版本中，打开用于创建和管理 subagent 配置的交互式界面 |54| `/agents` | {/* min-version: 2.1.198 */}从 v2.1.198 开始，运行 `/agents` 会打印一个提醒，要求您询问 Claude 创建或管理 [subagents](/zh-CN/sub-agents)，或直接编辑 `.claude/agents/` 或 `~/.claude/agents/`。{/* max-version: 2.1.197 */}在 v2.1.197 及更早版本中，打开用于创建和管理 subagent 配置的交互式界面 |

55| `/autofix-pr [prompt]` | 生成一个[网络版 Claude Code](/zh-CN/claude-code-on-the-web#auto-fix-pull-requests) 会话，监视当前分支的 PR，并在 CI 失败或审阅者留下评论时推送修复。使用 `gh pr view` 检测已检出分支的开放 PR；要监视不同的 PR，请先检出其分支。默认情况下，远程会话被告知修复每个 CI 失败和审阅评论；传递一个提示以给它不同的说明，例如 `/autofix-pr only fix lint and type errors`。需要 `gh` CLI 和访问[网络版 Claude Code](/zh-CN/claude-code-on-the-web) |55| `/autofix-pr [prompt]` | 生成一个[网络版 Claude Code](/zh-CN/claude-code-on-the-web#auto-fix-pull-requests) 会话，监视当前分支的 PR，并在 CI 失败或审阅者留下评论时推送修复。使用 `gh pr view` 检测已检出分支的开放 PR；要监视不同的 PR，请先检出其分支。默认情况下，远程会话被告知修复每个 CI 失败和审阅评论；传递一个提示以给它不同的说明，例如 `/autofix-pr only fix lint and type errors`。需要 `gh` CLI 和访问[网络版 Claude Code](/zh-CN/claude-code-on-the-web) |

56| `/background [prompt]` | 将当前会话分离以作为[后台 agent](/zh-CN/agent-view) 运行并释放此终端。传递一个提示以在分离前发送一条更多指令。使用 `claude agents` 监视会话。别名：`/bg` |56| `/background [prompt]` | 将当前会话分离以作为[后台 agent](/zh-CN/agent-view) 运行并释放此终端。传递一个提示以在分离前发送一条更多指令。使用 `claude agents` 监视会话。别名：`/bg` |

324 您可以使用以下任何方法：324 您可以使用以下任何方法：

325 325 

326 1. 将图像拖放到 Claude Code 窗口中326 1. 将图像拖放到 Claude Code 窗口中

327 2. 复制图像并使用 ctrl+v 将其粘贴到 CLI 中（不要使用 cmd+v）327 2. 复制图像并使用 Ctrl+V 将其粘贴到 CLI 中。在 macOS 上，Cmd+V 也适用于 iTerm2。

328 3. 向 Claude 提供图像路径。例如，"Analyze this image: /path/to/your/image.png"328 3. 向 Claude 提供图像路径。例如，"Analyze this image: /path/to/your/image.png"

329 </Step>329 </Step>

330 330 

7> 在 Claude Code CLI 中启用 computer use，使 Claude 能够在 macOS 上打开应用、点击、输入和查看您的屏幕。测试原生应用、调试视觉问题，以及自动化仅限 GUI 的工具，无需离开您的终端。7> 在 Claude Code CLI 中启用 computer use，使 Claude 能够在 macOS 上打开应用、点击、输入和查看您的屏幕。测试原生应用、调试视觉问题，以及自动化仅限 GUI 的工具，无需离开您的终端。

8 8 

9<Note>9<Note>

10 {/* plan-availability: feature=computer-use plans=pro,max */}10 Computer use 是 macOS 上的研究预览版，需要 Pro 或 Max 计划。它在 Team 或 Enterprise 计划上不可用。它需要交互式会话，因此在使用 `-p` 标志的非交互式模式下不可用。

11 

12 Computer use 是 macOS 上的研究预览版，需要 Pro 或 Max 计划。它在 Team 或 Enterprise 计划上不可用。它需要 Claude Code v2.1.85 或更高版本以及交互式会话，因此在使用 `-p` 标志的非交互式模式下不可用。

13</Note>11</Note>

14 12 

15Computer use 让 Claude 能够打开应用、控制您的屏幕，并以您的方式在您的机器上工作。从 CLI 中，Claude 可以编译 Swift 应用、启动它、点击每个按钮，并截图结果，所有这些都在编写代码的同一对话中进行。13Computer use 让 Claude 能够打开应用、控制您的屏幕，并以您的方式在您的机器上工作。从 CLI 中，Claude 可以编译 Swift 应用、启动它、点击每个按钮，并截图结果，所有这些都在编写代码的同一对话中进行。

236服务器仅在符合条件的设置上出现。检查：234服务器仅在符合条件的设置上出现。检查：

237 235 

238* 您在 macOS 上。Computer use 在 CLI 中在 Linux 或 Windows 上不可用。在 Windows 上，改用 [Desktop 中的 computer use](/zh-CN/desktop#let-claude-use-your-computer)。236* 您在 macOS 上。Computer use 在 CLI 中在 Linux 或 Windows 上不可用。在 Windows 上，改用 [Desktop 中的 computer use](/zh-CN/desktop#let-claude-use-your-computer)。

239* 您运行的是 Claude Code v2.1.85 或更高版本。运行 `claude --version` 来检查。

240* 您在 Pro 或 Max 计划上。运行 `/status` 来确认您的订阅。237* 您在 Pro 或 Max 计划上。运行 `/status` 来确认您的订阅。

241* 您通过 claude.ai 进行身份验证。Computer use 不适用于第三方提供商，如 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry。如果您仅通过第三方提供商访问 Claude，您需要单独的 claude.ai 账户来使用此功能。238* 您通过 claude.ai 进行身份验证。Computer use 不适用于第三方提供商，如 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry。如果您仅通过第三方提供商访问 Claude，您需要单独的 claude.ai 账户来使用此功能。

242* 您在交互式会话中。Computer use 在使用 `-p` 标志的非交互式模式下不可用。239* 您在交互式会话中。Computer use 在使用 `-p` 标志的非交互式模式下不可用。

10 10 

11在企业部署中，平均成本约为每个开发者每个活跃日 $13，每个开发者每月 $150-250，90% 的用户每个活跃日成本保持在 \$30 以下。要估计您自己团队的支出，请从一个小的试点团体开始，并使用下面的跟踪工具建立基线，然后再进行更广泛的推出。11在企业部署中，平均成本约为每个开发者每个活跃日 $13，每个开发者每月 $150-250，90% 的用户每个活跃日成本保持在 \$30 以下。要估计您自己团队的支出，请从一个小的试点团体开始，并使用下面的跟踪工具建立基线，然后再进行更广泛的推出。

12 12 

13本页面介绍如何[跟踪成本](#track-your-costs)、[管理团队成本](#managing-costs-for-teams)和[减少令牌使用](#reduce-token-usage)。13本页面介绍如何[跟踪成本](#track-your-costs)、[管理团队成本](#manage-costs-for-your-organization)和[减少令牌使用](#reduce-token-usage)。

14 14 

15<h2 id="track-your-costs">15<h2 id="track-your-costs">

16 跟踪成本16 跟踪成本

37 37 

38在 [VS Code 扩展](/zh-CN/vs-code#check-account-and-usage) 中，相同的明细显示在"账户和使用情况"对话框中，带有"日"和"周"切换。需要 Claude Code v2.1.174 或更高版本。38在 [VS Code 扩展](/zh-CN/vs-code#check-account-and-usage) 中，相同的明细显示在"账户和使用情况"对话框中，带有"日"和"周"切换。需要 Claude Code v2.1.174 或更高版本。

39 39 

40<h2 id="managing-costs-for-teams">40<h3 id="set-a-spend-limit-on-pro-and-max">

41 管理团队成本41 在 Pro 和 Max 上设置支出限制

42</h3>

43 

44在 Pro 和 Max 计划上，您可以使用 `/usage-credits` 命令为使用额度设置每月支出限制。如果您在仍有使用额度可用时达到该限制，Claude Code 会提示您提高或移除该限制，以便您可以继续使用而无需离开 CLI。更改限制需要账户的计费访问权限。

45 

46<h2 id="manage-costs-for-your-organization">

47 管理组织的成本

42</h2>48</h2>

43 49 

44使用 Claude API 时，您可以在 Claude Code 工作区上[设置工作区支出限制](https://platform.claude.com/docs/zh-CN/build-with-claude/workspaces#workspace-limits)。管理员可以在 Console 中[查看成本和使用情况报告](https://platform.claude.com/docs/zh-CN/build-with-claude/workspaces#usage-and-cost-tracking)。50您对 Claude Code 的控制方式取决于您的组织如何访问 Claude Code：通过 Claude for Teams 或 Enterprise 计划、Claude Console 或云提供商。在 Teams 和 Enterprise 计划中，使用情况从每个成员的座位额度中扣除。在 Console 和云提供商上，使用情况按令牌计费到您的组织。如果您的组织混合使用登录方法，每个开发者将根据他们进行身份验证的方法进行计量。

51 

52该表将每种设置映射到您查看支出的位置、您限制支出的位置以及如何提取每用户数字。

53 

54| 您的设置 | 查看支出 | 限制支出 | 每用户报告 |

55| :----------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------- | :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

56| [Claude for Teams 或 Enterprise](#claude-for-teams-and-enterprise) | [组织分析中的支出报告](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans) | 管理员设置中的支出限制 | [支出报告 CSV](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans)；Enterprise 上的 [Enterprise Analytics API](https://support.claude.com/en/articles/13703965-claude-enterprise-analytics-api-reference-guide) |

57| [Claude Console (API)](#claude-console) | [Console 使用情况页面](https://platform.claude.com/usage) | 工作区支出限制 | [Console 仪表板](https://platform.claude.com/claude-code)、[Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api) |

58| [Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry](#cloud-providers) | 您的云计费控制台 | 您的云预算控制 | [OpenTelemetry](/zh-CN/monitoring-usage) 或 [LLM gateway](/zh-CN/llm-gateway) |

59 

60[OpenTelemetry 导出](/zh-CN/monitoring-usage)适用于每种设置，是唯一能够以近实时方式将每用户令牌和成本指标流式传输到您自己的可观测性堆栈的选项。

45 61 

46在 Pro 和 Max 计划中，您可以使用 `/usage-credits` 命令在使用额度上设置每月支出限制。如果在您仍有可用使用额度的情况下达到该限制，Claude Code 会提示您提高或移除该限制，以便您可以继续使用而无需离开 CLI。更改限制需要账户的计费访问权限。62<h3 id="claude-for-teams-and-enterprise">

63 Claude for Teams 和 Enterprise

64</h3>

65 

66在 Claude for Teams 和 Enterprise 计划中，每个成员的 Claude Code 使用情况从按座位额度中扣除，该额度在滚动五小时窗口和每周窗口上重置。该额度与 Claude chat 和 Cowork 共享，其大小取决于[座位等级](https://support.claude.com/en/articles/11845131-use-claude-code-with-your-team-or-enterprise-plan)。您的控制位于 claude.ai 管理控制台中，而不是 Claude Console。

67 

68* **查看支出**：[组织分析中的支出报告](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans)显示每个用户和每个模型的估计支出，带有 CSV 导出，每日更新。该报告涵盖使用额度支出，并在启用使用额度后出现。座位额度内的使用情况不以美元计量。

69* **查看采用情况**：[分析仪表板](https://claude.ai/analytics/claude-code)显示每日活跃用户、会话和贡献指标，带有贡献数据的 CSV 导出。请参阅[使用分析跟踪团队使用情况](/zh-CN/analytics)。

70* **限制支出**：座位额度是默认上限。要让成员继续超过它，请启用[使用额度](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)并在组织、组或个人成员级别设置支出限制。

71* **提取每用户数字**：在 Enterprise 计划中，[Enterprise Analytics API](https://support.claude.com/en/articles/13703965-claude-enterprise-analytics-api-reference-guide)返回跨 Claude 表面（包括 Claude Code）的每用户使用情况和成本报告。主所有者在 [claude.ai/analytics/api-keys](https://claude.ai/analytics/api-keys) 处使用 `read:analytics` 范围创建密钥。在 Teams 计划中，导出[支出报告 CSV](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans)，其中列出了每个用户和每个模型的令牌使用情况和估计支出。

72 

73[Claude Enterprise 消费指南](https://support.claude.com/en/articles/14782391-claude-enterprise-consumption-guide)是管理员的规划参考。它解释了消费如何在 Claude chat、Claude Code 和 Cowork 中有所不同，并为预算提供了每用户美元起点。为编码座位预算比聊天座位更多：每个 Claude Code 轮次都包含文件内容、工具调用和多步推理，因此一个调试会话可能会消耗超过一天的聊天。

74 

75<h3 id="claude-console">

76 Claude Console

77</h3>

78 

79API 组织通过[工作区](https://platform.claude.com/docs/en/build-with-claude/workspaces)管理 Claude Code 支出。您可以[设置工作区支出限制](https://platform.claude.com/docs/en/build-with-claude/workspaces#workspace-limits)以限制 Claude Code 总支出，并在 Console 中[查看成本和使用情况报告](https://platform.claude.com/docs/en/build-with-claude/workspaces#usage-and-cost-tracking)。

47 80 

48<Note>81<Note>

49 当您首次使用 Claude Console 账户对 Claude Code 进行身份验证时，会自动为您创建一个名为"Claude Code"的工作区。此工作区为您的组织中的所有 Claude Code 使用情况提供集中式成本跟踪和管理。您无法为此工作区创建 API 密钥；它专门用于 Claude Code 身份验证和使用。82 当您首次使用 Claude Console 账户对 Claude Code 进行身份验证时，会自动为您创建一个名为"Claude Code"的工作区。此工作区为您的组织中的所有 Claude Code 使用情况提供集中式成本跟踪和管理。您无法为此工作区创建 API 密钥；它专门用于 Claude Code 身份验证和使用。

51 对于具有自定义速率限制的组织，此工作区中的 Claude Code 流量计入您的组织整体 API 速率限制。您可以在 Claude Console 的此工作区的 Limits 页面上设置[工作区速率限制](https://platform.claude.com/docs/zh-CN/api/rate-limits#setting-lower-limits-for-workspaces)，以限制 Claude Code 的份额并保护其他生产工作负载。84 对于具有自定义速率限制的组织，此工作区中的 Claude Code 流量计入您的组织整体 API 速率限制。您可以在 Claude Console 的此工作区的 Limits 页面上设置[工作区速率限制](https://platform.claude.com/docs/zh-CN/api/rate-limits#setting-lower-limits-for-workspaces)，以限制 Claude Code 的份额并保护其他生产工作负载。

52</Note>85</Note>

53 86 

54在 Amazon Bedrock、Google Cloud 的 Agent Platform 和 Microsoft Foundry 上，Claude Code 不会从您的云中发送指标。自托管的 [Claude apps gateway](/zh-CN/claude-apps-gateway) 提供按用户使用情况归因、带有令牌计数的 OTLP 指标，以及这些提供商上的[按用户支出限制](/zh-CN/claude-apps-gateway-spend-limits)。通过不同 [LLM gateway](/zh-CN/llm-gateway) 路由 Claude Code 的组织可以在网关处跟踪支出，因为网关会看到每个请求。87对于每用户报告，[Console 仪表板](https://platform.claude.com/claude-code)显示每个成员的支出和接受的行数，[Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api)使用[管理员 API 密钥](https://platform.claude.com/settings/admin-keys)以编程方式返回相同的每日每用户指标。请参阅[API 客户的分析](/zh-CN/analytics#access-analytics-for-api-customers)。

55 88 

56<h3 id="rate-limit-recommendations">89<h4 id="rate-limit-recommendations">

57 速率限制建议90 速率限制建议

58</h3>91</h4>

59 92 

60为团队设置 Claude Code 时，请根据您的组织规模考虑这些每用户的令牌/分钟 (TPM) 和请求/分钟 (RPM) 建议：93为团队设置 Claude Code 时，请根据您的组织规模考虑这些每用户的令牌/分钟 (TPM) 和请求/分钟 (RPM) 建议：

61 94 

76 如果您预期会出现异常高的并发使用情况（例如与大型团体进行的实时培训会话），您可能需要更高的每用户 TPM 分配。109 如果您预期会出现异常高的并发使用情况（例如与大型团体进行的实时培训会话），您可能需要更高的每用户 TPM 分配。

77</Note>110</Note>

78 111 

112<h3 id="cloud-providers">

113 云提供商

114</h3>

115 

116在 Amazon Bedrock、Google Cloud 的 Agent Platform 和 Microsoft Foundry 上，Claude Code 按令牌计费到您的云账户，支出控制位于您的云提供商的计费控制台中。Claude Code 不会从您的云向 Anthropic 发送指标，因此[分析仪表板](/zh-CN/analytics)和 Claude Code Analytics API 不涵盖此使用情况。

117 

118对于每用户成本归因，您有三个选项：

119 

120* **OpenTelemetry**：[导出指标](/zh-CN/monitoring-usage)从每个开发者的机器到您自己的可观测性堆栈。这为您提供每用户令牌计数、成本和工具活动，无论提供商如何。

121* **Claude apps gateway**：自托管的 [Claude apps gateway](/zh-CN/claude-apps-gateway)提供每用户使用情况归因、带有令牌计数的 OTLP 指标，以及这些提供商上的[每用户支出限制](/zh-CN/claude-apps-gateway-spend-limits)。

122* **LLM gateway**：通过代理路由所有 Claude Code 流量，该代理按密钥跟踪支出。几个大型企业报告使用[LiteLLM](/zh-CN/llm-gateway)，一个开源工具，可以[按密钥跟踪支出](https://docs.litellm.ai/docs/proxy/virtual_keys#tracking-spend)。此项目与 Anthropic 无关，尚未进行安全审计。

123 

124<h3 id="when-a-developer-asks-about-a-limit">

125 当开发者询问限制时

126</h3>

127 

128开发者通常会向他们的管理员提出限制问题，因此了解他们遇到的上限会很有帮助。这三种情况意味着不同的事情：

129 

130* **"您已达到会话限制"或"您已达到每周限制"**：订阅计划上基于座位的使用窗口。这些窗口在所有模型中共享，因此使用 `/model` 切换模型不会恢复访问权限，尽管在模型特定的"您已达到 Opus 限制"消息之后它确实让开发者继续工作。该消息显示窗口何时重置，开发者可以运行 `/usage-credits` 来请求超过额度的使用情况（如果您已启用[使用额度](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)）。请参阅[使用限制错误](/zh-CN/errors#youve-hit-your-session-limit)。

131* **上下文或自动压缩警告**：不是使用限制。对话已接近模型的最大输入大小，Claude Code 总结较早的历史以释放空间。将开发者指向[减少令牌使用](#reduce-token-usage)。

132* **API 或云提供商计划上的意外高支出**：通常可以追溯到从未清除的长会话或将 Opus 作为默认模型。要分享的最高影响习惯是在不相关的任务之间清除和将模型与工作相匹配，两者都在[减少令牌使用](#reduce-token-usage)中涵盖。

133 

79<h3 id="agent-team-token-costs">134<h3 id="agent-team-token-costs">

80 Agent 团队令牌成本135 Agent 团队令牌成本

81</h3>136</h3>

19 19 

20本页面涵盖如何[构建链接](#build-a-link)、[在运行手册中嵌入链接或从 shell 触发](#examples)，以及[在每个平台上管理或禁用处理程序注册](#registration-and-supported-platforms)。20本页面涵盖如何[构建链接](#build-a-link)、[在运行手册中嵌入链接或从 shell 触发](#examples)，以及[在每个平台上管理或禁用处理程序注册](#registration-and-supported-platforms)。

21 21 

22<Note>

23 深链接需要 Claude Code v2.1.91 或更高版本。

24</Note>

25 

26<h2 id="how-it-works">22<h2 id="how-it-works">

27 工作原理23 工作原理

28</h2>24</h2>

44 44 

45在发送第一条消息之前，在提示区域配置四件事：45在发送第一条消息之前，在提示区域配置四件事：

46 46 

47* **环境**：选择 Claude 运行的位置。选择 **Local** 用于你的机器，**Remote** 用于 Anthropic 托管的云会话，或[**SSH 连接**](#ssh-sessions)用于你管理的远程机器。请参阅[环境配置](#environment-configuration)。47* **环境**：选择 Claude 运行的位置。选择 **Local** 用于你的机器，**Remote** 用于 Anthropic 托管的云会话，[**SSH 连接**](#ssh-sessions)用于你管理的远程机器，或在 Windows 上选择 [**WSL 发行版**](/zh-CN/desktop-wsl)。请参阅[环境配置](#environment-configuration)。

48* **项目文件夹**：选择 Claude 工作的文件夹或存储库。对于远程会话，你可以添加[多个存储库](#run-long-running-tasks-remotely)。48* **项目文件夹**：选择 Claude 工作的文件夹或存储库。对于远程会话，你可以添加[多个存储库](#run-long-running-tasks-remotely)。

49* **模型**：从发送按钮旁的下拉菜单中选择一个[模型](/zh-CN/model-config#available-models)。你可以在会话期间更改此设置。49* **模型**：从发送按钮旁的下拉菜单中选择一个[模型](/zh-CN/model-config#available-models)。你可以在会话期间更改此设置。

50* **权限模式**：从[模式选择器](#choose-a-permission-mode)中选择 Claude 拥有多少自主权。你可以在会话期间更改此设置。50* **权限模式**：从[模式选择器](#choose-a-permission-mode)中选择 Claude 拥有多少自主权。你可以在会话期间更改此设置。

71 71 

72提示框支持两种方式来引入外部上下文：72提示框支持两种方式来引入外部上下文：

73 73 

74* **@mention 文件**：输入 `@` 后跟文件名，将文件添加到对话上下文。Claude 然后可以读取和引用该文件。@mention 在云会话中不可用。74* **@mention 文件**：输入 `@` 后跟文件名，将文件添加到对话上下文。Claude 然后可以读取和引用该文件。@mention 在云会话和 WSL 会话中不可用。

75* **附加文件**：使用附件按钮将图像、PDF 和其他文件附加到你的提示，或直接将文件拖放到提示中。这对于共享错误的屏幕截图、设计模型或参考文档很有用。75* **附加文件**：使用附件按钮将图像、PDF 和其他文件附加到你的提示，或直接将文件拖放到提示中。这对于共享错误的屏幕截图、设计模型或参考文档很有用。

76 76 

77<h3 id="choose-a-permission-mode">77<h3 id="choose-a-permission-mode">

385 385 

386侧边聊天让你提出一个使用你的会话上下文的问题，但不会添加任何内容回到主对话。当你想要理解一段代码、检查一个假设或探索一个想法而不引导会话偏离时，使用它。386侧边聊天让你提出一个使用你的会话上下文的问题，但不会添加任何内容回到主对话。当你想要理解一段代码、检查一个假设或探索一个想法而不引导会话偏离时，使用它。

387 387 

388在 macOS 上按 **Cmd+;** 或在 Windows 上按 **Ctrl+;** 来打开侧边聊天，或在提示框中输入 `/btw`。侧边聊天可以读取主线程中到该点为止的所有内容。完成后，关闭侧边聊天并在你离开的地方继续主会话。侧边聊天在本地和 SSH 会话中可用。388在 macOS 上按 **Cmd+;** 或在 Windows 上按 **Ctrl+;** 来打开侧边聊天，或在提示框中输入 `/btw`。侧边聊天可以读取主线程中到该点为止的所有内容。完成后，关闭侧边聊天并在你离开的地方继续主会话。侧边聊天在本地、SSH 和 WSL 会话中可用。

389 389 

390<h3 id="watch-background-tasks">390<h3 id="watch-background-tasks">

391 观看后台任务391 观看后台任务

440 连接外部工具440 连接外部工具

441</h3>441</h3>

442 442 

443对于本地和 [SSH](#ssh-sessions) 会话，点击提示框旁的 **+** 按钮并选择 **Connectors** 来添加集成，如 Google Calendar、Slack、GitHub、Linear、Notion 等。你可以在会话之前或期间添加连接器。**+** 按钮在云会话中不可用，但[例程](/zh-CN/routines)在例程创建时配置连接器。443对于本地和 [SSH](#ssh-sessions) 会话，点击提示框旁的 **+** 按钮并选择 **Connectors** 来添加集成，如 Google Calendar、Slack、GitHub、Linear、Notion 等。你可以在会话之前或期间添加连接器。**+** 按钮在云会话中不可用，但 [routines](/zh-CN/routines) 在 routine 创建时配置连接器。

444 444 

445要管理或断开连接器，请在桌面应用中转到设置 → Connectors，或从提示框中的 Connectors 菜单中选择 **Manage connectors**。445要管理或断开连接器，请在桌面应用中转到设置 → Connectors，或从提示框中的 Connectors 菜单中选择 **Manage connectors**。

446 446 

462 462 

463对于本地和 [SSH](#ssh-sessions) 会话，点击提示框旁的 **+** 按钮并选择 **Plugins** 来查看你已安装的插件及其 skills。要添加插件，从子菜单中选择 **Add plugin** 来打开插件浏览器，它显示来自你配置的[市场](/zh-CN/plugin-marketplaces)的可用插件，包括官方 Anthropic 市场。选择 **Manage plugins** 来启用、禁用或卸载插件。463对于本地和 [SSH](#ssh-sessions) 会话，点击提示框旁的 **+** 按钮并选择 **Plugins** 来查看你已安装的插件及其 skills。要添加插件，从子菜单中选择 **Add plugin** 来打开插件浏览器，它显示来自你配置的[市场](/zh-CN/plugin-marketplaces)的可用插件，包括官方 Anthropic 市场。选择 **Manage plugins** 来启用、禁用或卸载插件。

464 464 

465插件可以限定到你的用户账户、特定项目或仅本地。如果你的组织集中管理插件，这些插件在桌面会话中的可用方式与在 CLI 中相同。插件在云会话中不可用。有关完整的插件参考，包括创建你自己的插件，请参阅[插件](/zh-CN/plugins)。465插件可以限定到你的用户账户、特定项目或仅本地。如果你的组织集中管理插件，这些插件在桌面会话中的可用方式与在 CLI 中相同。插件在云会话或 WSL 会话中不可用。有关完整的插件参考，包括创建你自己的插件，请参阅 [plugins](/zh-CN/plugins)。

466 466 

467<h3 id="configure-preview-servers">467<h3 id="configure-preview-servers">

468 配置预览服务器468 配置预览服务器

628* **Local**：在你的机器上运行，直接访问你的文件628* **Local**：在你的机器上运行，直接访问你的文件

629* **Remote**：在 Anthropic 的云基础设施上运行。即使你关闭应用，会话也会继续。629* **Remote**：在 Anthropic 的云基础设施上运行。即使你关闭应用，会话也会继续。

630* **SSH**：在你通过 SSH 连接的远程机器上运行，例如你自己的服务器、云虚拟机或开发容器630* **SSH**：在你通过 SSH 连接的远程机器上运行，例如你自己的服务器、云虚拟机或开发容器

631* **WSL**（Windows）：在你的机器上的 [WSL 2 发行版](/zh-CN/desktop-wsl)内运行，使用其 Linux 工具链和本地路径

631 632 

632<h3 id="local-sessions">633<h3 id="local-sessions">

633 本地会话634 本地会话

72 72 

73 * **Remote**：在 Anthropic 的云基础设施上运行会话，即使关闭应用也会继续。远程会话使用与 [Claude Code on the web](/zh-CN/claude-code-on-the-web) 相同的基础设施。73 * **Remote**：在 Anthropic 的云基础设施上运行会话，即使关闭应用也会继续。远程会话使用与 [Claude Code on the web](/zh-CN/claude-code-on-the-web) 相同的基础设施。

74 * **SSH**：通过 SSH 连接到远程机器，例如您自己的服务器、云虚拟机或开发容器。Desktop 在您第一次连接时会自动在远程机器上安装 Claude Code。74 * **SSH**：通过 SSH 连接到远程机器，例如您自己的服务器、云虚拟机或开发容器。Desktop 在您第一次连接时会自动在远程机器上安装 Claude Code。

75 * **WSL**（Windows）：在 [WSL 2 发行版](/zh-CN/desktop-wsl) 内运行会话；Claude Code、工具和 git 在 Linux 端执行，使用本机路径。

75 </Step>76 </Step>

76 77 

77 <Step title="选择模型">78 <Step title="选择模型">

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# Claude Code Desktop 在 WSL 中

6 

7> 在 Windows 上的 WSL 2 发行版内运行 Code 会话

8 

9在 Windows 上，Code 选项卡可以在 WSL 2 发行版内运行会话，而不是在 Windows 本身上运行。会话的 Claude Code 进程、其工具和 git 都在发行版内执行，使用其 Linux 工具链和本机 Linux 路径，与您的项目所针对的环境相同。

10 

11当您的存储库位于发行版的文件系统内时，请使用 WSL 会话。从 Windows 处理这些文件会通过网络文件系统进行，这很慢并且会破坏文件监视；在发行版内运行会话可以避免两者。

12 

13<h2 id="requirements">

14 要求

15</h2>

16 

17* Windows 10 或 11，带有 [WSL 2](https://learn.microsoft.com/windows/wsl/install)。不支持 WSL 1。

18* 至少安装一个发行版（例如 Ubuntu）。

19* 在发行版内安装了 `git`。

20 

21<h2 id="start-a-wsl-session">

22 启动 WSL 会话

23</h2>

24 

25<Steps>

26 <Step title="选择发行版">

27 在 Code 选项卡中启动新会话并打开环境选择器。您安装的 WSL 2 发行版会出现在 **WSL** 部分中。选择一个。

28 </Step>

29 

30 <Step title="选择文件夹">

31 会话在发行版的主目录中启动。使用文件夹选择器选择项目文件夹。浏览在发行版内进行，使用 Linux 路径，如 `/home/you/project`。

32 </Step>

33 

34 <Step title="信任文件夹">

35 文件夹中的第一个会话会显示工作区信任对话框。信任按发行版和文件夹授予；在一个发行版中信任文件夹不适用于另一个发行版或 Windows 上的相同路径。

36 </Step>

37</Steps>

38 

39发行版中的第一个会话需要花费更长时间，而 Claude 在其中进行设置。您也可以从普通文件夹选择器打开 `\\wsl.localhost\...` 文件夹，它会在该发行版内重新打开。

40 

41您最近使用过的文件夹会按发行版出现在选择器中，因此重新连接到项目只需一次点击。

42 

43<h2 id="what-works-in-a-wsl-session">

44 WSL 会话中的工作内容

45</h2>

46 

47并行会话、侧边聊天、可视化差异审查、分支和拉取请求状态以及 worktrees 都可以工作，由发行版内的 git 和工具链支持。"在编辑器中打开"会打开通过 [Remote - WSL](https://code.visualstudio.com/docs/remote/wsl) 连接到发行版的 VS Code。

48 

49WSL 会话中还没有提供一些功能：集成终端、连接器和插件、会话分叉、文件浏览器窗格以及在编辑器中键入 `@` 时的文件建议。

50 

51<h2 id="managed-devices">

52 受管设备

53</h2>

54 

55在由组织管理的设备上，WSL 会话可能不可用。如果会话启动失败并显示设备受管的消息，这由您的管理员控制。管理员：请参阅部署指南中的[设置如何到达设备](/zh-CN/admin-setup#decide-how-settings-reach-devices)。

176| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | 写入调试日志文件的最小日志级别。值：`verbose`、`debug`（默认）、`info`、`warn`、`error`。设置为 `verbose` 以包含高容量诊断（如完整状态行命令输出），或提高到 `error` 以减少噪音 |176| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | 写入调试日志文件的最小日志级别。值：`verbose`、`debug`（默认）、`info`、`warn`、`error`。设置为 `verbose` 以包含高容量诊断（如完整状态行命令输出），或提高到 `error` 以减少噪音 |

177| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | 设置为 `1` 以禁用[1M 上下文窗口](/zh-CN/model-config#extended-context)支持。设置后，1M 模型变体在模型选择器中不可用，[Sonnet 5](/zh-CN/model-config#sonnet-5-context-window) 会话被视为具有 200K 窗口。对于具有合规要求的企业环境很有用 |177| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | 设置为 `1` 以禁用[1M 上下文窗口](/zh-CN/model-config#extended-context)支持。设置后，1M 模型变体在模型选择器中不可用，[Sonnet 5](/zh-CN/model-config#sonnet-5-context-window) 会话被视为具有 200K 窗口。对于具有合规要求的企业环境很有用 |

178| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | 设置为 `1` 以禁用 Opus 4.6 和 Sonnet 4.6 的[自适应推理](/zh-CN/model-config#adjust-effort-level)并回退到由 `MAX_THINKING_TOKENS` 控制的固定思考预算。从 v2.1.111 开始，对 Fable 5、Sonnet 5 或 Opus 4.7 及更高版本无效，它们始终使用自适应推理 |178| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | 设置为 `1` 以禁用 Opus 4.6 和 Sonnet 4.6 的[自适应推理](/zh-CN/model-config#adjust-effort-level)并回退到由 `MAX_THINKING_TOKENS` 控制的固定思考预算。从 v2.1.111 开始，对 Fable 5、Sonnet 5 或 Opus 4.7 及更高版本无效，它们始终使用自适应推理 |

179| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | 设置为 `1` 以禁用[顾问工具](/zh-CN/advisor)。`/advisor` 命令变为不可用，任何配置的 `advisorModel` 被忽略，`--advisor` 标志被接受但无效，因此传递它的现有脚本继续工作而不出错。需要 Claude Code v2.1.98 或更高版本 |179| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | 设置为 `1` 以禁用[顾问工具](/zh-CN/advisor)。`/advisor` 命令变为不可用，任何配置的 `advisorModel` 被忽略，`--advisor` 标志被接受但无效，因此传递它的现有脚本继续工作而不出错 |

180| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | 设置为 `1` 以关闭[后台代理和代理视图](/zh-CN/agent-view)：`claude agents`、`--bg`、`/background` 和按需监督员。等同于 [`disableAgentView`](/zh-CN/settings#available-settings) 设置 |180| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | 设置为 `1` 以关闭[后台代理和代理视图](/zh-CN/agent-view)：`claude agents`、`--bg`、`/background` 和按需监督员。等同于 [`disableAgentView`](/zh-CN/settings#available-settings) 设置 |

181| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | 设置为 `1` 以禁用[全屏渲染](/zh-CN/fullscreen)并使用经典主屏幕渲染器。对话保持在您的终端的原生滚动条中，因此 `Cmd+f` 和 tmux 复制模式可以正常工作。优先于 `CLAUDE_CODE_NO_FLICKER` 和 [`tui`](/zh-CN/settings#available-settings) 设置。您也可以使用 `/tui default` 切换。不适用于从[代理视图](/zh-CN/agent-view)打开的后台会话，它们始终使用全屏渲染 |181| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | 设置为 `1` 以禁用[全屏渲染](/zh-CN/fullscreen)并使用经典主屏幕渲染器。对话保持在您的终端的原生滚动条中，因此 `Cmd+f` 和 tmux 复制模式可以正常工作。优先于 `CLAUDE_CODE_NO_FLICKER` 和 [`tui`](/zh-CN/settings#available-settings) 设置。您也可以使用 `/tui default` 切换。不适用于从[代理视图](/zh-CN/agent-view)打开的后台会话，它们始终使用全屏渲染 |

182| `CLAUDE_CODE_DISABLE_ARTIFACT` | 设置为 `1` 以禁用[工件](/zh-CN/artifacts)工具，该工具将会话输出发布为 claude.ai 上的私有网页。等同于 [`disableArtifact`](/zh-CN/settings#available-settings) 设置 |182| `CLAUDE_CODE_DISABLE_ARTIFACT` | 设置为 `1` 以禁用[工件](/zh-CN/artifacts)工具，该工具将会话输出发布为 claude.ai 上的私有网页。等同于 [`disableArtifact`](/zh-CN/settings#available-settings) 设置 |

283You've hit your Opus limit · resets 3:45pm283You've hit your Opus limit · resets 3:45pm

284```284```

285 285 

286Claude Code 会阻止进一步的请求，直到消息中显示的重置时间。286Claude Code 会阻止进一步的请求，直到消息中显示的重置时间。会话和每周限制在所有模型中共享，因此切换模型不会恢复访问权限。Opus 限制仅适用于 Opus 请求，因此使用 `/model` 切换到另一个模型可以继续工作。

287 287 

288**应该怎么做：**288**应该怎么做：**

289 289 

290* 等待错误消息中显示的重置时间290* 等待错误消息中显示的重置时间

291* 对于 Opus 限制，运行 `/model` 并切换到另一个模型以继续工作

291* 运行 `/usage` 查看您的计划限制以及它们何时重置292* 运行 `/usage` 查看您的计划限制以及它们何时重置

292* 运行 `/usage-credits` 在 Pro 和 Max 上购买额外使用量，或在 Team 和 Enterprise 上向您的管理员请求。有关如何计费，请参阅[付费计划的使用额度](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)。293* 运行 `/usage-credits` 在 Pro 和 Max 上购买额外使用量，或在 Team 和 Enterprise 上向您的管理员请求。有关如何计费，请参阅[付费计划的使用额度](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)。

293* 要升级您的计划以获得更高的基础限制，请参阅 [claude.com/pricing](https://claude.com/pricing)294* 要升级您的计划以获得更高的基础限制，请参阅 [claude.com/pricing](https://claude.com/pricing)

18 Opus 4.7 的快速模式自 2026 年 6 月 25 日起已弃用，将在 2026 年 7 月 24 日移除。移除后，Opus 4.7 上的快速模式请求将返回错误，不会回退到标准 Opus 4.7。迁移到 Opus 4.8 以保持加速。18 Opus 4.7 的快速模式自 2026 年 6 月 25 日起已弃用，将在 2026 年 7 月 24 日移除。移除后，Opus 4.7 上的快速模式请求将返回错误，不会回退到标准 Opus 4.7。迁移到 Opus 4.8 以保持加速。

19</Warning>19</Warning>

20 20 

21<Note>

22 快速模式需要 Claude Code v2.1.36 或更高版本。使用 `claude --version` 检查您的版本。

23</Note>

24 

25需要了解的内容：21需要了解的内容：

26 22 

27* 使用 `/fast` 在 Claude Code CLI 中切换快速模式。Claude Code VS Code 扩展中不支持快速模式。23* 使用 `/fast` 在 Claude Code CLI 中切换快速模式。Claude Code VS Code 扩展中不支持快速模式。

38* 输入 `/fast` 并按 Tab 键打开或关闭34* 输入 `/fast` 并按 Tab 键打开或关闭

39* 在您的[用户设置文件](/zh-CN/settings)中设置 `"fastMode": true`35* 在您的[用户设置文件](/zh-CN/settings)中设置 `"fastMode": true`

40 36 

41默认情况下，在交互式会话中打开的快速模式在会话之间保持。{/* min-version: 2.1.205 */}在[非交互式模式](/zh-CN/headless)中，使用 `-p` 标志，`/fast` 仅在使用快速模式在其 [`--settings`](/zh-CN/cli-reference#cli-flags) 值中启动的会话中工作，例如 `claude -p --settings '{"fastMode": true}'`；切换然后仅适用于该会话，不会保存为您的默认值，在任何其他非交互式会话中，该命令报告快速模式不可用。管理员可以配置快速模式在每个会话时重置。有关详细信息，请参阅[要求每个会话选择加入](#require-per-session-opt-in)。37默认情况下，在交互式会话中打开的快速模式在会话之间保持。{/* min-version: 2.1.205 */}在[非交互式模式](/zh-CN/headless)中，使用 `-p` 标志，`/fast` 仅在使用快速模式在其 [`--settings`](/zh-CN/cli-reference#cli-flags) 值中启动的会话中工作，例如 `claude -p --settings '{"fastMode": true}'`；切换然后仅适用于该会话，不会保存为您的默认值，在任何其他非交互式会话中，该命令报告快速模式不可用。您可以配置快速模式在每个会话时重置。有关详细信息，请参阅[要求每个会话选择加入](#require-per-session-opt-in)。

42 38 

43为了获得最佳成本效率，在会话开始时启用快速模式，而不是在对话中途切换。有关详细信息，请参阅[了解成本权衡](#understand-the-cost-tradeoff)。39为了获得最佳成本效率，在会话开始时启用快速模式，而不是在对话中途切换。有关详细信息，请参阅[了解成本权衡](#understand-the-cost-tradeoff)。

44 40 

131 要求每个会话选择加入127 要求每个会话选择加入

132</h3>128</h3>

133 129 

134默认情况下，快速模式在会话之间保持：如果用户启用快速模式，它会在未来的会话中保持打开。[团队](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_teams#team-&-enterprise)或[企业](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_enterprise)计划上的管理员可以通过在[托管设置](/zh-CN/settings#settings-files)或[服务器托管设置](/zh-CN/server-managed-settings)中将 `fastModePerSessionOptIn` 设置为 `true` 来防止这种情况。这会导致每个会话以快速模式关闭开始，要求用户使用 `/fast` 明确启用它。130默认情况下，快速模式在会话之间保持：如果用户启用快速模式，它会在未来的会话中保持打开。要更改此行为，在任何[设置文件](/zh-CN/settings#settings-files)中将 `fastModePerSessionOptIn` 设置为 `true`，这会导致每个会话以快速模式关闭开始，并要求用户使用 `/fast` 明确启用它。[团队](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_teams#team-&-enterprise)或[企业](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_enterprise)计划上的所有者可以通过[服务器托管设置](/zh-CN/server-managed-settings)在组织范围内部署它。

135 131 

136```json theme={null}132```json theme={null}

137{133{

169 <tbody>169 <tbody>

170 <tr>170 <tr>

171 <td>[Analytics dashboard and API](/zh-CN/analytics)</td>171 <td>[Analytics dashboard and API](/zh-CN/analytics)</td>

172 <td>✓ (Team 和 Enterprise)</td>172 <td>✓ (dashboard: Team 和 Enterprise; API: Enterprise)</td>

173 <td>✓ <sup><a href="#fn5">5</a></sup></td>173 <td>✓ <sup><a href="#fn5">5</a></sup></td>

174 <td>✗</td>174 <td>✗</td>

175 <td>✗</td>175 <td>✗</td>

287| Dispatch ([Desktop](/zh-CN/desktop#sessions-from-dispatch)) | ✓ | ✓ | ✗ | ✗ |287| Dispatch ([Desktop](/zh-CN/desktop#sessions-from-dispatch)) | ✓ | ✓ | ✗ | ✗ |

288| [Code Review](/zh-CN/code-review) | ✗ | ✗ | ✓ | ✓ |288| [Code Review](/zh-CN/code-review) | ✗ | ✗ | ✓ | ✓ |

289| [Artifacts](/zh-CN/artifacts) | ✓ | ✓ | ✓ | Admin-enabled |289| [Artifacts](/zh-CN/artifacts) | ✓ | ✓ | ✓ | Admin-enabled |

290| [Analytics dashboard、API 和贡献指标](/zh-CN/analytics) | ✗ | ✗ | ✓ | ✓ |290| [分析仪表板和贡献指标](/zh-CN/analytics) | ✗ | ✗ | ✓ | ✓ |

291| [Enterprise Analytics API](/zh-CN/analytics#access-data-programmatically) | ✗ | ✗ | ✗ | ✓ |

291| [Server-managed settings](/zh-CN/server-managed-settings) | ✗ | ✗ | ✓ | ✓ |292| [Server-managed settings](/zh-CN/server-managed-settings) | ✗ | ✗ | ✓ | ✓ |

292| [SSO](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) | ✗ | ✗ | ✓ | ✓ |293| [SSO](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) | ✗ | ✗ | ✓ | ✓ |

293| SCIM | ✗ | ✗ | ✗ | ✓ |294| SCIM | ✗ | ✗ | ✗ | ✓ |

7> 启用更流畅、无闪烁的渲染模式，支持鼠标操作，在长对话中保持稳定的内存使用。7> 启用更流畅、无闪烁的渲染模式，支持鼠标操作，在长对话中保持稳定的内存使用。

8 8 

9<Note>9<Note>

10 全屏渲染是一个可选的[研究预览](#research-preview)功能，需要 Claude Code v2.1.89 或更高版本。在当前对话中运行 `/tui fullscreen` 来切换，或在 v2.1.110 之前的版本上设置 `CLAUDE_CODE_NO_FLICKER=1`。行为可能会根据反馈而改变。10 全屏渲染是一个可选的[研究预览](#research-preview)功能。在当前对话中运行 `/tui fullscreen` 来切换，或在 v2.1.110 之前的版本上设置 `CLAUDE_CODE_NO_FLICKER=1`。行为可能会根据反馈而改变。

11</Note>11</Note>

12 12 

13全屏渲染是 Claude Code CLI 的一种替代渲染路径，它消除了闪烁，在长对话中保持内存使用量平稳，并添加了鼠标支持。它在终端的备用屏幕缓冲区上绘制界面，就像 `vim` 或 `htop` 一样，并且只渲染当前可见的消息。这减少了每次更新时发送到终端的数据量。13全屏渲染是 Claude Code CLI 的一种替代渲染路径，它消除了闪烁，在长对话中保持内存使用量平稳，并添加了鼠标支持。它在终端的备用屏幕缓冲区上绘制界面，就像 `vim` 或 `htop` 一样，并且只渲染当前可见的消息。这减少了每次更新时发送到终端的数据量。

213 213 

214禁用点击后，Claude Code 仍然捕获鼠标，因此滚轮和触控板滚动对话，但左键点击在 Claude Code 内不起作用。您仍然需要按住终端的键进行原生点击拖动选择。右键点击和中键粘贴在支持它们的终端上继续工作。214禁用点击后，Claude Code 仍然捕获鼠标，因此滚轮和触控板滚动对话，但左键点击在 Claude Code 内不起作用。您仍然需要按住终端的键进行原生点击拖动选择。右键点击和中键粘贴在支持它们的终端上继续工作。

215 215 

216<h2 id="troubleshooting">

217 Troubleshooting

218</h2>

219 

220<h3 id="stale-or-misplaced-text-on-screen">

221 屏幕上出现陈旧或错位的文本

222</h3>

223 

224全屏渲染仅发送帧之间更改的单元格。某些终端，最常见的是 Windows Terminal 和其他基于 ConPTY 的主机，会错误地合并这些定位写入，并在调整窗口大小之前在屏幕上留下早期输出的片段。

225 

226设置 [`CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT=1`](/zh-CN/env-vars) 以在每一帧上重绘每个单元格，而不是发送增量更新。

227 

228在 Windows PowerShell 上：

229 

230```powershell theme={null}

231$env:CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT = "1"

232claude

233```

234 

235在 macOS 或 Linux 上：

236 

237```bash theme={null}

238CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT=1 claude

239```

240 

241在 Windows 上，Claude Code 已经为后台会话和 [agent view](/zh-CN/agent-view) 自动启用完整重绘，因此您只需要为直接启动的交互式全屏会话设置该变量。

242 

216<h2 id="research-preview">243<h2 id="research-preview">

217 研究预览244 研究预览

218</h2>245</h2>

236 Non-interactive mode236 Non-interactive mode

237</h3>237</h3>

238 238 

239一种执行单个提示并退出而不进行对话会话的模式，使用 `-p` 或 `--print` 调用。用于 CI、脚本和管道。[Agent SDK](/zh-CN/agent-sdk/overview) 是 Python 和 TypeScript 等效项。以前称为 headless mode。239一种执行单个提示并退出而不进行对话会话的模式，使用 `-p` 或 `--print` 调用。用于 CI、脚本和管道。该运行仍然保存为可恢复的会话，除非您传递 `--no-session-persistence`。[Agent SDK](/zh-CN/agent-sdk/overview) 是 Python 和 TypeScript 等效项。以前称为 headless mode。

240 240 

241了解更多：[以编程方式运行 Claude Code](/zh-CN/headless)241了解更多：[以编程方式运行 Claude Code](/zh-CN/headless)

242 242 

98 98 

99如果您拥有 Google Cloud 凭证并想开始通过 Google Cloud 的 Agent Platform 使用 Claude Code，登录向导会引导您完成整个过程。您需要在每个项目中完成一次 GCP 端的前置条件；向导会处理 Claude Code 端的事务。99如果您拥有 Google Cloud 凭证并想开始通过 Google Cloud 的 Agent Platform 使用 Claude Code，登录向导会引导您完成整个过程。您需要在每个项目中完成一次 GCP 端的前置条件；向导会处理 Claude Code 端的事务。

100 100 

101<Note>

102 Google Cloud 的 Agent Platform 设置向导需要 Claude Code v2.1.98 或更高版本。运行 `claude --version` 来检查。

103</Note>

104 

105<Steps>101<Steps>

106 <Step title="在您的 GCP 项目中启用 Claude 模型">102 <Step title="在您的 GCP 项目中启用 Claude 模型">

107 为您的项目[启用 Google Cloud 的 Agent Platform API](#1-enable-agent-platform-api)，然后在 [Google Cloud 的 Agent Platform Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) 中请求访问您想要的 Claude 模型。有关您的账户需要的权限，请参阅 [IAM 配置](#iam-configuration)。103 为您的项目[启用 Google Cloud 的 Agent Platform API](#1-enable-agent-platform-api)，然后在 [Google Cloud 的 Agent Platform Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) 中请求访问您想要的 Claude 模型。有关您的账户需要的权限，请参阅 [IAM 配置](#iam-configuration)。

262 启动模型检查258 启动模型检查

263</h2>259</h2>

264 260 

265当 Claude Code 启动并配置了 Google Cloud 的 Agent Platform 时，它会验证它打算使用的模型在您的项目中是否可访问。此检查需要 Claude Code v2.1.98 或更高版本。261当 Claude Code 启动并配置了 Google Cloud 的 Agent Platform 时，它会验证它打算使用的模型在您的项目中是否可访问。

266 262 

267如果您固定了一个比当前 Claude Code 默认值更旧的模型版本，并且您的项目可以调用较新版本，Claude Code 会提示您更新固定。接受会将新的模型 ID 写入您的[用户设置文件](/zh-CN/settings)并重启 Claude Code。拒绝会被记住，直到下一个默认版本更改。263如果您固定了一个比当前 Claude Code 默认值更旧的模型版本，并且您的项目可以调用较新版本，Claude Code 会提示您更新固定。接受会将新的模型 ID 写入您的[用户设置文件](/zh-CN/settings)并重启 Claude Code。拒绝会被记住，直到下一个默认版本更改。

268 264 

1648 1648 

1649`"defer"` 用于运行 `claude -p` 作为子进程并读取其 JSON 输出的集成，例如 Agent SDK 应用或构建在 Claude Code 之上的自定义 UI。它让该调用进程在工具调用处暂停 Claude，通过其自己的界面收集输入，并从中断处恢复。Claude Code 仅在[非交互模式](/zh-CN/headless)中使用 `-p` 标志时遵守此值。在交互式会话中，它记录警告并忽略 hook 结果。1649`"defer"` 用于运行 `claude -p` 作为子进程并读取其 JSON 输出的集成，例如 Agent SDK 应用或构建在 Claude Code 之上的自定义 UI。它让该调用进程在工具调用处暂停 Claude，通过其自己的界面收集输入，并从中断处恢复。Claude Code 仅在[非交互模式](/zh-CN/headless)中使用 `-p` 标志时遵守此值。在交互式会话中，它记录警告并忽略 hook 结果。

1650 1650 

1651<Note>

1652 `defer` 值需要 Claude Code v2.1.89 或更高版本。早期版本不识别它，工具通过正常权限流程进行。

1653</Note>

1654 

1655`AskUserQuestion` 工具是典型情况：Claude 想要询问用户一些事情，但没有终端来回答。往返工作如下：1651`AskUserQuestion` 工具是典型情况：Claude 想要询问用户一些事情，但没有终端来回答。往返工作如下：

1656 1652 

16571. Claude 调用 `AskUserQuestion`。`PreToolUse` hook 触发。16531. Claude 调用 `AskUserQuestion`。`PreToolUse` hook 触发。

495 495 

496* `"type": "http"`：将事件数据 POST 到 URL。请参阅 [HTTP hooks](#http-hooks)。496* `"type": "http"`：将事件数据 POST 到 URL。请参阅 [HTTP hooks](#http-hooks)。

497* `"type": "mcp_tool"`：在已连接的 MCP 服务器上调用工具。请参阅 [MCP tool hooks](/zh-CN/hooks#mcp-tool-hook-fields)。497* `"type": "mcp_tool"`：在已连接的 MCP 服务器上调用工具。请参阅 [MCP tool hooks](/zh-CN/hooks#mcp-tool-hook-fields)。

498* `"type": "prompt"`：单轮 LLM 评估。请参阅 [基于提示的 hooks](#prompt-based-hooks)。498* `"type": "prompt"`：单轮 LLM 评估。请参阅 [Prompt-based hooks](#prompt-based-hooks)。

499* `"type": "agent"`：具有工具访问权限的多轮验证。Agent hooks 是实验性的，可能会改变。请参阅 [基于代理的 hooks](#agent-based-hooks)。499* `"type": "agent"`：具有工具访问权限的多轮验证。Agent hooks 是实验性的，可能会改变。请参阅 [Agent-based hooks](#agent-based-hooks)。

500 500 

501<h3 id="combine-results-from-multiple-hooks">501<h3 id="combine-results-from-multiple-hooks">

502 合并来自多个 hooks 的结果502 合并来自多个 hooks 的结果

619 619 

620对于 `UserPromptSubmit` hooks，改用 `additionalContext` 将文本注入到 Claude 的上下文中。620对于 `UserPromptSubmit` hooks，改用 `additionalContext` 将文本注入到 Claude 的上下文中。

621 621 

622基于提示的 hooks（`type: "prompt"`）处理输出的方式不同：请参阅 [基于提示的 hooks](#prompt-based-hooks)。622基于 prompt 的 hooks（`type: "prompt"`）处理输出的方式不同：请参阅 [Prompt-based hooks](#prompt-based-hooks)。

623 623 

624<h3 id="filter-hooks-with-matchers">624<h3 id="filter-hooks-with-matchers">

625 使用匹配器过滤 hooks625 使用匹配器过滤 hooks

747 使用 `if` 字段按工具名称和参数过滤747 使用 `if` 字段按工具名称和参数过滤

748</h4>748</h4>

749 749 

750<Note>

751 `if` 字段需要 Claude Code v2.1.85 或更高版本。早期版本忽略它并在每个匹配的调用上运行 hook。

752</Note>

753 

754`if` 字段使用 [权限规则语法](/zh-CN/permissions) 按工具名称和参数一起过滤 hooks，因此 hook 进程仅在工具调用匹配时生成。这超越了 `matcher`，它仅在工具名称级别按组过滤。750`if` 字段使用 [权限规则语法](/zh-CN/permissions) 按工具名称和参数一起过滤 hooks，因此 hook 进程仅在工具调用匹配时生成。这超越了 `matcher`，它仅在工具名称级别按组过滤。

755 751 

756例如，这个配置仅在 Claude 使用 `git` 命令而不是所有 Bash 命令时运行 hook：752例如，这个配置仅在 Claude 使用 `git` 命令而不是所有 Bash 命令时运行 hook：

178 178 

179**每个文件编辑都是可逆的。** 在 Claude 编辑任何文件之前，它会对当前内容进行快照。如果出现问题，按两次 `Esc` 以回退到之前的状态，或要求 Claude 撤销。179**每个文件编辑都是可逆的。** 在 Claude 编辑任何文件之前，它会对当前内容进行快照。如果出现问题，按两次 `Esc` 以回退到之前的状态，或要求 Claude 撤销。

180 180 

181Checkpoints 是会话本地的，独立于 git。它们仅涵盖文件更改。影响远程系统的操作（数据库、API、部署）无法进行 checkpointing，这就是为什么 Claude 在运行具有外部副作用的命令之前询问。181Checkpoints 独立于 git，在您恢复对话时仍然可用。它们仅涵盖文件更改。影响远程系统的操作（数据库、API、部署）无法进行 checkpointing，这就是为什么 Claude 在运行具有外部副作用的命令之前询问。

182 182 

183<h3 id="control-what-claude-can-do">183<h3 id="control-what-claude-can-do">

184 控制 Claude 可以做什么184 控制 Claude 可以做什么

188 188 

189* **Manual**：Claude 在文件编辑和 shell 命令之前询问189* **Manual**：Claude 在文件编辑和 shell 命令之前询问

190* **Accept edits**：Claude 编辑文件并运行常见的文件系统命令（如 `mkdir` 和 `mv`）而不询问，仍然询问其他命令190* **Accept edits**：Claude 编辑文件并运行常见的文件系统命令（如 `mkdir` 和 `mv`）而不询问，仍然询问其他命令

191* **Plan**：Claude 探索并提出计划而不编辑您的源文件；权限提示仍然适用，如 Manual 模式191* **Plan**：Claude 探索并提出计划而不编辑您的源文件

192* **Auto**：Claude 使用后台安全检查评估所有操作192* **Auto**：Claude 使用后台安全检查评估所有操作

193 193 

194您也可以在 `.claude/settings.json` 中允许特定命令，以便 Claude 不会每次都询问。这对于受信任的命令（如 `npm test` 或 `git status`）很有用。设置可以从组织范围的策略范围到个人偏好。有关详细信息，请参阅[权限](/zh-CN/permissions)。194您也可以在 `.claude/settings.json` 中允许特定命令，以便 Claude 不会每次都询问。这对于受信任的命令（如 `npm test` 或 `git status`）很有用。设置可以从组织范围的策略范围到个人偏好。有关详细信息，请参阅[权限](/zh-CN/permissions)。

6 6 

7> 使用快捷键配置文件在 Claude Code 中自定义快捷键。7> 使用快捷键配置文件在 Claude Code 中自定义快捷键。

8 8 

9<Note>

10 可自定义的快捷键需要 Claude Code v2.1.18 或更高版本。使用 `claude --version` 检查您的版本。

11</Note>

12 

13Claude Code 支持可自定义的快捷键。运行 `/keybindings` 来创建或打开位于 `~/.claude/keybindings.json` 的配置文件。9Claude Code 支持可自定义的快捷键。运行 `/keybindings` 来创建或打开位于 `~/.claude/keybindings.json` 的配置文件。

14 10 

15<h2 id="configuration-file">11<h2 id="configuration-file">

722}722}

723```723```

724 724 

725URL 必须使用 `https://`。`authServerMetadataUrl` 需要 Claude Code v2.1.64 或更高版本。元数据 URL 的 `scopes_supported` 覆盖上游服务器公开的范围。725URL 必须使用 `https://`。元数据 URL 的 `scopes_supported` 覆盖上游服务器公开的范围。

726 726 

727<h3 id="restrict-oauth-scopes">727<h3 id="restrict-oauth-scopes">

728 限制 OAuth 范围728 限制 OAuth 范围

365 365 

366自动记忆让 Claude 跨会话积累知识，无需你编写任何内容。Claude 在工作时为自己保存笔记：构建命令、调试见解、架构笔记、代码样式偏好和工作流习惯。Claude 不会每个会话都保存内容。它根据信息在未来对话中是否有用来决定什么值得记住。366自动记忆让 Claude 跨会话积累知识，无需你编写任何内容。Claude 在工作时为自己保存笔记：构建命令、调试见解、架构笔记、代码样式偏好和工作流习惯。Claude 不会每个会话都保存内容。它根据信息在未来对话中是否有用来决定什么值得记住。

367 367 

368<Note>

369 自动记忆需要 Claude Code v2.1.59 或更高版本。使用 `claude --version` 检查你的版本。

370</Note>

371 

372<h3 id="enable-or-disable-auto-memory">368<h3 id="enable-or-disable-auto-memory">

373 启用或禁用自动记忆369 启用或禁用自动记忆

374</h3>370</h3>

8 8 

9Claude Code 是一个由 AI 驱动的编码助手，可帮助你构建功能、修复错误和自动化开发任务。它理解你的整个代码库，可以跨多个文件和工具工作以完成任务。9Claude Code 是一个由 AI 驱动的编码助手，可帮助你构建功能、修复错误和自动化开发任务。它理解你的整个代码库，可以跨多个文件和工具工作以完成任务。

10 10 

11<Note>

12 默认配置下，Claude Code 需要能够访问 claude.ai 和 Anthropic API 等端点才能完成安装、登录和正常使用。在中国大陆的网络环境中，这些端点可能无法直接访问。开始前，请先确认所在网络能够连通这些服务。企业代理配置以及 Amazon Bedrock 等第三方提供商的网络要求，请参阅[网络配置](/zh-CN/network-config#network-access-requirements)。

13</Note>

14 

11<h2 id="get-started">15<h2 id="get-started">

12 开始使用16 开始使用

13</h2>17</h2>

24 <Tab title="Native Install (Recommended)">28 <Tab title="Native Install (Recommended)">

25 **macOS, Linux, WSL:**29 **macOS, Linux, WSL:**

26 30 

27 ```bash theme={null}31 ```bash theme={null} theme={null}

28 curl -fsSL https://claude.ai/install.sh | bash32 curl -fsSL https://claude.ai/install.sh | bash

29 ```33 ```

30 34 

31 **Windows PowerShell:**35 **Windows PowerShell:**

32 36 

33 ```powershell theme={null}37 ```powershell theme={null} theme={null}

34 irm https://claude.ai/install.ps1 | iex38 irm https://claude.ai/install.ps1 | iex

35 ```39 ```

36 40 

37 **Windows CMD:**41 **Windows CMD:**

38 42 

39 ```batch theme={null}43 ```batch theme={null} theme={null}

40 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd44 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

41 ```45 ```

42 46 

52 </Tab>56 </Tab>

53 57 

54 <Tab title="Homebrew">58 <Tab title="Homebrew">

55 ```bash theme={null}59 ```bash theme={null} theme={null}

56 brew install --cask claude-code60 brew install --cask claude-code

57 ```61 ```

58 62 

64 </Tab>68 </Tab>

65 69 

66 <Tab title="WinGet">70 <Tab title="WinGet">

67 ```powershell theme={null}71 ```powershell theme={null} theme={null}

68 winget install Anthropic.ClaudeCode72 winget install Anthropic.ClaudeCode

69 ```73 ```

70 74 

132 使用 plan mode 在编辑前进行分析132 使用 plan mode 在编辑前进行分析

133</h2>133</h2>

134 134 

135Plan mode 告诉 Claude 研究并提议更改而不进行更改。Claude 读取文件、运行 shell 命令进行探索，并编写计划，但不编辑您的源代码。权限提示的应用方式与手动模式相同。135Plan mode 告诉 Claude 研究并提议更改而不进行更改。Claude 读取文件、运行 shell 命令进行探索，并编写计划，但不编辑您的源代码。权限提示的应用方式与手动模式相同，除非 [auto mode](/zh-CN/auto-mode-config) 可用且 `useAutoModeDuringPlan` 已启用（这是默认设置）。启用 auto mode 后，分类器会批准只读命令（如搜索和文件读取）而无需提示。无论哪种方式，编辑都会保持阻止状态，直到您批准计划。

136 136 

137通过按 `Shift+Tab` 或在单个提示前加上 `/plan` 进入 plan mode。您也可以从 CLI 以 plan mode 启动：137通过按 `Shift+Tab` 或在单个提示前加上 `/plan` 进入 plan mode。您也可以从 CLI 以 plan mode 启动：

138 138 

178 使用 auto mode 消除提示178 使用 auto mode 消除提示

179</h2>179</h2>

180 180 

181<Note>

182 Auto mode 需要 Claude Code v2.1.83 或更高版本。

183</Note>

184 

185Auto mode 让 Claude 执行而无需例行权限提示。一个单独的分类器模型在操作运行前审查操作，阻止任何超出您请求范围的操作、针对无法识别的基础设施的操作，或似乎由 Claude 读到的恶意内容驱动的操作。显式[询问规则](/zh-CN/permissions#manage-permissions)仍然会强制提示。181Auto mode 让 Claude 执行而无需例行权限提示。一个单独的分类器模型在操作运行前审查操作，阻止任何超出您请求范围的操作、针对无法识别的基础设施的操作，或似乎由 Claude 读到的恶意内容驱动的操作。显式[询问规则](/zh-CN/permissions#manage-permissions)仍然会强制提示。

186 182 

187Auto mode 还指示 Claude 继续工作而无需停止以提出澄清问题，尽管当您的提示或技能明确依赖它时 Claude 仍然会提问。要在保持权限提示的同时获得更强的自主行为，请改为设置[主动输出风格](/zh-CN/output-styles)。183Auto mode 还指示 Claude 继续工作而无需停止以提出澄清问题，尽管当您的提示或技能明确依赖它时 Claude 仍然会提问。要在保持权限提示的同时获得更强的自主行为，请改为设置[主动输出风格](/zh-CN/output-styles)。

573 573 

574Claude Code 支持从私有存储库安装 plugins。对于手动安装和更新，Claude Code 使用你现有的 git 凭证助手，所以通过 `gh auth login`、macOS Keychain 或 `git-credential-store` 的 HTTPS 访问工作方式与你的终端中相同。SSH 访问工作，只要主机已经在你的 `known_hosts` 文件中，并且密钥已加载到 `ssh-agent` 中，因为 Claude Code 会抑制主机指纹和密钥密码的交互式 SSH 提示。574Claude Code 支持从私有存储库安装 plugins。对于手动安装和更新，Claude Code 使用你现有的 git 凭证助手，所以通过 `gh auth login`、macOS Keychain 或 `git-credential-store` 的 HTTPS 访问工作方式与你的终端中相同。SSH 访问工作，只要主机已经在你的 `known_hosts` 文件中，并且密钥已加载到 `ssh-agent` 中，因为 Claude Code 会抑制主机指纹和密钥密码的交互式 SSH 提示。

575 575 

576后台自动更新在启动时运行，不使用凭证助手，因为交互式提示会阻止 Claude Code 启动。要为私有 marketplaces 启用自动更新，请在你的环境中设置适当的身份验证令牌：576后台自动更新的工作方式不同。默认情况下，后台刷新会为其 `git pull` 禁用 git 凭证助手，所以即使配置了助手，pull 也无法对 HTTPS 上的私有存储库进行身份验证。SSH 远程不受影响：加载到 `ssh-agent` 中的密钥以与手动操作相同的方式对后台 pulls 进行身份验证。当后台 pull 失败时，Claude Code 会回退到从头重新克隆 marketplace。重新克隆确实使用你存储的 git 凭证，但它可能在大型存储库上[超时](#git-operations-time-out)，所以私有 marketplace 自动更新可能会间歇性失败。

577 577 

578| 提供商 | 环境变量 | 注释 |578两个设置使私有 marketplaces 的行为可预测：

579| :-------- | :-------------------------- | :-------------------- |

580| GitHub | `GITHUB_TOKEN` 或 `GH_TOKEN` | 个人访问令牌或 GitHub App 令牌 |

581| GitLab | `GITLAB_TOKEN` 或 `GL_TOKEN` | 个人访问令牌或项目令牌 |

582| Bitbucket | `BITBUCKET_TOKEN` | 应用密码或存储库访问令牌 |

583 579 

584在你的 shell 配置中设置令牌（例如，`.bashrc`、`.zshrc`）或在运行 Claude Code 时传递它：580* 设置 `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1` 以在后台 pull 失败时保留现有克隆，而不是删除并重新克隆。你的 plugins 继续从最后同步的状态工作，使用 `/plugin marketplace update` 的手动更新仍然使用你的凭证进行 pull。

581* 配置 git 凭证助手，例如使用 `gh auth setup-git` 用于 GitHub，以便重新克隆回退可以在不提示的情况下进行身份验证。

582 

583在你的环境中设置提供商令牌（如 `GITHUB_TOKEN`）本身不会启用后台身份验证。令牌仅通过配置的凭证助手（例如 `gh` CLI 的助手，它读取 `GH_TOKEN` 和 `GITHUB_TOKEN`）生效。

584 

585要使后台 pull 本身通过 HTTPS 进行身份验证，请配置全局 git URL 重写。重写在远程 URL 中嵌入令牌，所以即使后台 pull 禁用凭证助手，它也会生效，成功的 pull 会跳过重新克隆回退。以下示例重写 marketplace 存储库的 URL 以包含访问令牌：

585 586 

586```bash theme={null}587```bash theme={null}

587export GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx588git config --global url."https://x-access-token:YOUR_TOKEN@github.com/acme-corp/plugins".insteadOf "https://github.com/acme-corp/plugins"

588```589```

589 590 

591将重写范围限制在 marketplace 存储库或组织路径。仅以主机为基础的重写适用于机器上对该主机的每个 fetch 和 push，并覆盖你的正常凭证，包括对你自己的存储库的 pushes。

592 

593每个提供商在重写的 URL 中期望不同的用户名，相同的路径范围适用于每个提供商。对于自托管服务器，请将主机名替换为你的服务器的主机名：

594 

595| 提供商 | 重写的 URL 形式 |

596| :-------- | :---------------------------------------------------------------- |

597| GitHub | `https://x-access-token:YOUR_TOKEN@github.com/acme-corp/plugins` |

598| GitLab | `https://oauth2:YOUR_TOKEN@gitlab.com/acme-corp/plugins` |

599| Bitbucket | `https://x-token-auth:YOUR_TOKEN@bitbucket.org/acme-corp/plugins` |

600 

601重写以纯文本形式在你的 gitconfig 中存储令牌，所以使用对 marketplace 存储库具有只读访问权限的令牌。

602 

590<Note>603<Note>

591 对于 CI/CD 环境，将令牌配置为秘密环境变量。GitHub Actions 自动为同一组织中的存储库提供 `GITHUB_TOKEN`。604 在 CI/CD 环境中，在从私有存储库安装 plugins 之前配置 git 凭证助手。在 GitHub Actions 上，导出对 marketplace 存储库具有读取访问权限的令牌作为 `GH_TOKEN`，然后运行 `gh auth setup-git`。默认工作流令牌只能访问工作流自己的存储库，所以另一个存储库中的私有 marketplace 需要个人访问令牌或应用令牌。在管道中配置的全局 URL 重写也直接对后台 pull 进行身份验证。

592</Note>605</Note>

593 606 

594<h3 id="test-locally-before-distribution">607<h3 id="test-locally-before-distribution">

1160 1173 

1161对于后台自动更新：1174对于后台自动更新：

1162 1175 

1163* 在你的环境中设置适当的令牌：`echo $GITHUB_TOKEN`1176* 默认情况下，后台刷新会为拉取禁用 git 凭证助手，因此拉取无法通过 HTTPS 进行身份验证。在 `ssh-agent` 中加载了密钥的 SSH 远程仍然可以进行身份验证。失败的拉取会触发从头重新克隆，这使用你存储的凭证，但在大型存储库上可能超时

1164* 检查令牌是否具有所需的权限（对存储库的读取访问权限）1177* 设置 `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1` 以在后台拉取失败时保留现有克隆

1165* 对于 GitHub，确保令牌对私有存储库具有 `repo` 范围1178* 配置 git 凭证助手，例如 `gh auth setup-git`，以便重新克隆回退可以进行身份验证

1166* 对于 GitLab，确保令牌至少具有 `read_repository` 范围1179* 如果重新克隆在大型存储库上超时，请使用 [`CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS`](#git-operations-time-out) 增加限制

1167* 验证令牌未过期1180* 配置一个 [git URL 重写](#private-repositories) 作用于 marketplace 存储库，以便后台拉取直接进行身份验证

1181* 或使用 `/plugin marketplace update <name>` 手动更新私有 marketplaces，这使用你的凭证

1168 1182 

1169<h3 id="marketplace-updates-fail-in-offline-environments">1183<h3 id="marketplace-updates-fail-in-offline-environments">

1170 Marketplace 更新在离线环境中失败1184 Marketplace 更新在离线环境中失败

1171</h3>1185</h3>

1172 1186 

1173**症状**：Marketplace `git pull` 失败，Claude Code 清除现有缓存，导致 plugins 变得不可用。1187**症状**：Marketplace `git pull` 在后台失败，Claude Code 反复尝试无法成功的重新克隆。

1174 1188 

1175**原因**：默认情况下，当 `git pull` 失败时，Claude Code 会删除陈旧的克隆并尝试重新克隆。在离线或隔离的环境中，重新克隆以相同的方式失败，导致 marketplace 目录为空。1189**原因**：默认情况下，当 `git pull` 失败时，Claude Code 会尝试从头重新克隆。在离线或隔离的环境中，重新克隆以相同的方式失败，之后对先前缓存的恢复是尽力而为的。刷新在启动后在后台运行，因此不会延迟启动，但每个会话都会重复失败的尝试，每个 git 操作都可以等待 [120 秒超时](#git-operations-time-out)。

1176 1190 

1177**解决方案**：设置 `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1` 以在拉取失败时保留现有缓存，而不是清除它：1191**解决方案**：设置 `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1` 以在拉取失败时跳过重新克隆尝试并继续使用现有缓存：

1178 1192 

1179```bash theme={null}1193```bash theme={null}

1180export CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=11194export CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1

520| 必须手动复制以共享 | 使用 `/plugin install` 安装 |520| 必须手动复制以共享 | 使用 `/plugin install` 安装 |

521 521 

522<Note>522<Note>

523 迁移后，从 `.claude/` 中删除原始文件以避免重复。项目和用户 `.claude/agents/` 定义会覆盖同名的插件 agents，因此插件版本仅在删除原始文件后才会生效。523 迁移后，从 `.claude/` 中删除原始文件以避免重复。项目和用户 `.claude/agents/` 定义会覆盖同名的插件 agents，因此插件版本仅在删除原始文件后才会生效。Plugin skills 被命名为 `/plugin-name:skill-name`，所以原始的 `/skill-name` 和插件副本都保持可用，而不是其中一个覆盖另一个。

524</Note>524</Note>

525 525 

526<h2 id="next-steps">526<h2 id="next-steps">

95 95 

96成本每个对话应用一次。在第一个快速模式回合之后，Claude Code 继续发送请求头，仅改变请求的速度设置，这不是缓存键的一部分。关闭快速模式、[在速率限制后自动回退到标准速度](/zh-CN/fast-mode#handle-rate-limits)以及稍后重新启用它都保持缓存。`/clear` 和 `/compact` 重置这个，因为它们无论如何都在这些点重建缓存。96成本每个对话应用一次。在第一个快速模式回合之后，Claude Code 继续发送请求头，仅改变请求的速度设置，这不是缓存键的一部分。关闭快速模式、[在速率限制后自动回退到标准速度](/zh-CN/fast-mode#handle-rate-limits)以及稍后重新启用它都保持缓存。`/clear` 和 `/compact` 重置这个，因为它们无论如何都在这些点重建缓存。

97 97 

98<Note>

99 在切换时保持请求头需要 Claude Code v2.1.86 或更高版本。在较早的版本上，每个快速模式切换和速率限制回退都会使缓存失效。

100</Note>

101 

102<h3 id="connecting-or-disconnecting-an-mcp-server">98<h3 id="connecting-or-disconnecting-an-mcp-server">

103 连接或断开 MCP 服务器99 连接或断开 MCP 服务器

104</h3>100</h3>

8 8 

9本快速开始指南将在几分钟内让您使用 AI 驱动的编码辅助。完成本指南后，您将了解如何使用 Claude Code 完成常见的开发任务。9本快速开始指南将在几分钟内让您使用 AI 驱动的编码辅助。完成本指南后，您将了解如何使用 Claude Code 完成常见的开发任务。

10 10 

11<Note>

12 默认配置下，Claude Code 需要能够访问 claude.ai 和 Anthropic API 等端点才能完成安装、登录和正常使用。在中国大陆的网络环境中，这些端点可能无法直接访问。开始前，请先确认所在网络能够连通这些服务。企业代理配置以及 Amazon Bedrock 等第三方提供商的网络要求，请参阅[网络配置](/zh-CN/network-config#network-access-requirements)。

13</Note>

14 

11<h2 id="before-you-begin">15<h2 id="before-you-begin">

12 开始前16 开始前

13</h2>17</h2>

33 <Tab title="Native Install (Recommended)">37 <Tab title="Native Install (Recommended)">

34 **macOS, Linux, WSL:**38 **macOS, Linux, WSL:**

35 39 

36 ```bash theme={null}40 ```bash theme={null} theme={null}

37 curl -fsSL https://claude.ai/install.sh | bash41 curl -fsSL https://claude.ai/install.sh | bash

38 ```42 ```

39 43 

40 **Windows PowerShell:**44 **Windows PowerShell:**

41 45 

42 ```powershell theme={null}46 ```powershell theme={null} theme={null}

43 irm https://claude.ai/install.ps1 | iex47 irm https://claude.ai/install.ps1 | iex

44 ```48 ```

45 49 

46 **Windows CMD:**50 **Windows CMD:**

47 51 

48 ```batch theme={null}52 ```batch theme={null} theme={null}

49 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd53 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

50 ```54 ```

51 55 

61 </Tab>65 </Tab>

62 66 

63 <Tab title="Homebrew">67 <Tab title="Homebrew">

64 ```bash theme={null}68 ```bash theme={null} theme={null}

65 brew install --cask claude-code69 brew install --cask claude-code

66 ```70 ```

67 71 

73 </Tab>77 </Tab>

74 78 

75 <Tab title="WinGet">79 <Tab title="WinGet">

76 ```powershell theme={null}80 ```powershell theme={null} theme={null}

77 winget install Anthropic.ClaudeCode81 winget install Anthropic.ClaudeCode

78 ```82 ```

79 83 

21 21 

22与[网络上的 Claude Code](/zh-CN/claude-code-on-the-web)（在云基础设施上运行）不同，Remote Control 会话直接在您的机器上运行并与您的本地文件系统交互。网络和移动界面只是该本地会话的一个窗口。22与[网络上的 Claude Code](/zh-CN/claude-code-on-the-web)（在云基础设施上运行）不同，Remote Control 会话直接在您的机器上运行并与您的本地文件系统交互。网络和移动界面只是该本地会话的一个窗口。

23 23 

24<Note>

25 Remote Control 需要 Claude Code v2.1.51 或更高版本。使用 `claude --version` 检查您的版本。

26</Note>

27 

28本页涵盖设置、如何启动和连接到会话，以及 Remote Control 与网络上的 Claude Code 的比较。24本页涵盖设置、如何启动和连接到会话，以及 Remote Control 与网络上的 Claude Code 的比较。

29 25 

30<h2 id="requirements">26<h2 id="requirements">

104 </Tab>100 </Tab>

105 101 

106 <Tab title="VS Code">102 <Tab title="VS Code">

107 在 [Claude Code VS Code 扩展](/zh-CN/vs-code)中，在提示框中输入 `/remote-control` 或 `/rc`，或使用 `/` 打开命令菜单并选择它。需要 Claude Code v2.1.79 或更高版本。103 在 [Claude Code VS Code 扩展](/zh-CN/vs-code)中，在提示框中输入 `/remote-control` 或 `/rc`，或使用 `/` 打开命令菜单并选择它。

108 104 

109 ```text theme={null}105 ```text theme={null}

110 /remote-control106 /remote-control

419* 您使用 Console API 密钥或云提供商（如 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry）进行身份验证。`/schedule` 需要 claude.ai 订阅登录。如果在您的 shell 中设置了 `ANTHROPIC_API_KEY` 或 `ANTHROPIC_AUTH_TOKEN`，或在 `settings.json` 中设置了 `apiKeyHelper`，请先删除它，因为这些会优先于 claude.ai 登录419* 您使用 Console API 密钥或云提供商（如 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry）进行身份验证。`/schedule` 需要 claude.ai 订阅登录。如果在您的 shell 中设置了 `ANTHROPIC_API_KEY` 或 `ANTHROPIC_AUTH_TOKEN`，或在 `settings.json` 中设置了 `apiKeyHelper`，请先删除它，因为这些会优先于 claude.ai 登录

420* `DISABLE_TELEMETRY`、`DO_NOT_TRACK`、`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 或 `DISABLE_GROWTHBOOK` 在您的 shell 环境或 [`settings.json` 文件](/zh-CN/settings#available-settings)的 `env` 块中设置。这些会禁用功能标志获取，而 `/schedule` 依赖于此420* `DISABLE_TELEMETRY`、`DO_NOT_TRACK`、`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 或 `DISABLE_GROWTHBOOK` 在您的 shell 环境或 [`settings.json` 文件](/zh-CN/settings#available-settings)的 `env` 块中设置。这些会禁用功能标志获取，而 `/schedule` 依赖于此

421* 您在 Claude Code 网页会话中。改为从 [web UI](https://claude.ai/code/routines) 管理例程421* 您在 Claude Code 网页会话中。改为从 [web UI](https://claude.ai/code/routines) 管理例程

422* {/* min-version: 2.1.81 */}您的 CLI 版本早于 v2.1.81。运行 `claude update`

423 422 

424无论 CLI 如何配置，您始终可以在 [claude.ai/code/routines](https://claude.ai/code/routines) 处创建和管理例程。423无论 CLI 如何配置，您始终可以在 [claude.ai/code/routines](https://claude.ai/code/routines) 处创建和管理例程。

425 424 

136 136 

137会话临时目录在沙箱内默认可写，与工作目录一起。Claude Code 为沙箱化命令设置 `$TMPDIR` 为此目录，因此写入临时文件的工具无需额外配置即可工作。非沙箱化命令继承你的 shell 的 `$TMPDIR` 不变，这意味着沙箱化和非沙箱化命令将 `$TMPDIR` 解析为不同的目录。要在两者之间传递临时文件，请改为在工作目录下写入它们。137会话临时目录在沙箱内默认可写，与工作目录一起。Claude Code 为沙箱化命令设置 `$TMPDIR` 为此目录，因此写入临时文件的工具无需额外配置即可工作。非沙箱化命令继承你的 shell 的 `$TMPDIR` 不变，这意味着沙箱化和非沙箱化命令将 `$TMPDIR` 解析为不同的目录。要在两者之间传递临时文件，请改为在工作目录下写入它们。

138 138 

139某些命令根本无法在沙箱内运行，例如与其不兼容的工具或需要你未允许的主机的工具。与其让任务失败或要求你关闭沙箱，Claude Code 包括一个逃生舱：当命令因沙箱限制而失败时，Claude 分析失败，可能使用 `dangerouslyDisableSandbox` 参数重试命令。重试的命令在沙箱外运行，因此它通过常规权限流程进行，需要你的批准。139某些命令根本无法在沙箱内运行，例如与其不兼容的工具或需要你未允许的主机的工具。与其让任务失败或要求你关闭沙箱，Claude Code 包括一个逃生舱：当命令因沙箱限制而失败时，Claude 分析失败，可能使用 `dangerouslyDisableSandbox` 参数重试命令。重试的命令在沙箱外运行，因此通过常规权限流程进行。在 [自动模式](/zh-CN/permission-modes#eliminate-prompts-with-auto-mode) 中，分类器评估基础命令而不是提示你。

140 140 

141你可以通过在 [沙箱设置](/zh-CN/settings#sandbox-settings) 中设置 `"allowUnsandboxedCommands": false` 来禁用此逃生舱。禁用时，`/sandbox` Overrides 选项卡显示为 **严格沙箱模式**，`dangerouslyDisableSandbox` 参数被完全忽略，所有命令必须沙箱化运行或在 `excludedCommands` 中明确列出。141你可以通过在 [沙箱设置](/zh-CN/settings#sandbox-settings) 中设置 `"allowUnsandboxedCommands": false` 来禁用此逃生舱。禁用时，`/sandbox` Overrides 选项卡显示为 **严格沙箱模式**，`dangerouslyDisableSandbox` 参数被完全忽略，所有命令必须沙箱化运行或在 `excludedCommands` 中明确列出。

142 142 

6 6 

7> 使用 /loop 和 cron 调度工具在 Claude Code 会话中重复运行提示词、轮询状态或设置一次性提醒。7> 使用 /loop 和 cron 调度工具在 Claude Code 会话中重复运行提示词、轮询状态或设置一次性提醒。

8 8 

9<Note>

10 计划任务需要 Claude Code v2.1.72 或更高版本。使用 `claude --version` 检查您的版本。

11</Note>

12 

13计划任务让 Claude 按间隔自动重新运行提示词。使用它们来轮询部署、监督 PR、检查长时间运行的构建，或在会话中稍后提醒自己做某事。要对事件进行实时反应而不是轮询，请参阅 [Channels](/zh-CN/channels)：您的 CI 可以直接将失败推送到会话中。要保持会话工作转向转向直到满足条件而不是按间隔，请参阅 [`/goal`](/zh-CN/goal)。9计划任务让 Claude 按间隔自动重新运行提示词。使用它们来轮询部署、监督 PR、检查长时间运行的构建，或在会话中稍后提醒自己做某事。要对事件进行实时反应而不是轮询，请参阅 [Channels](/zh-CN/channels)：您的 CI 可以直接将失败推送到会话中。要保持会话工作转向转向直到满足条件而不是按间隔，请参阅 [`/goal`](/zh-CN/goal)。

14 10 

15任务是会话范围的：它们存在于当前对话中，当您启动新对话时就会停止。使用 `--resume` 或 `--continue` 恢复会带回任何尚未[过期](#seven-day-expiry)的任务：在过去 7 天内创建的重复任务，或计划时间尚未到达的一次性任务。对于独立于任何会话而存在的调度，请使用 [Routines](/zh-CN/routines) 在 Anthropic 管理的基础设施上创建例程、设置 [Desktop 计划任务](/zh-CN/desktop-scheduled-tasks)，或使用 [GitHub Actions](/zh-CN/github-actions)。11任务是会话范围的：它们存在于当前对话中，当您启动新对话时就会停止。使用 `--resume` 或 `--continue` 恢复会带回任何尚未[过期](#seven-day-expiry)的任务：在过去 7 天内创建的重复任务，或计划时间尚未到达的一次性任务。对于独立于任何会话而存在的调度，请使用 [Routines](/zh-CN/routines) 在 Anthropic 管理的基础设施上创建例程、设置 [Desktop 计划任务](/zh-CN/desktop-scheduled-tasks)，或使用 [GitHub Actions](/zh-CN/github-actions)。

22 22 

23* Claude for Teams 或 Claude for Enterprise 计划23* Claude for Teams 或 Claude for Enterprise 计划

24* 您的 Claude 组织中的所有者或主要所有者角色，以查看和编辑配置24* 您的 Claude 组织中的所有者或主要所有者角色，以查看和编辑配置

25* Claude for Teams 的 Claude Code 版本 2.1.38 或更高版本，或 Claude for Enterprise 的版本 2.1.30 或更高版本

26* 对 `api.anthropic.com` 的网络访问25* 对 `api.anthropic.com` 的网络访问

27 26 

28<h2 id="choose-between-server-managed-and-endpoint-managed-settings">27<h2 id="choose-between-server-managed-and-endpoint-managed-settings">

214 214 

215| 键 | 描述 | 示例 |215| 键 | 描述 | 示例 |

216| :-------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------ |216| :-------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------ |

217| `advisorModel` | {/* min-version: 2.1.98 */}服务器端 [advisor tool](/zh-CN/advisor) 的模型。接受模型别名，如 `"opus"`、`"sonnet"` 或 `"fable"`（{/* min-version: 2.1.170 */}v2.1.170+），或完整模型 ID。当您运行 `/advisor` 时自动写入。取消设置以禁用 advisor。需要 Claude Code v2.1.98 或更高版本 | `"opus"` |217| `advisorModel` | 服务器端 [advisor tool](/zh-CN/advisor) 的模型。接受模型别名，如 `"opus"`、`"sonnet"` 或 `"fable"`（{/* min-version: 2.1.170 */}v2.1.170+），或完整模型 ID。当您运行 `/advisor` 时自动写入。取消设置以禁用 advisor | `"opus"` |

218| `agent` | 将主线程作为命名 subagent 运行，并为从 `claude agents` 分派的会话设置默认 agent。应用该 subagent 的系统提示、工具限制和模型。请参阅[显式调用 subagents](/zh-CN/sub-agents#invoke-subagents-explicitly) | `"code-reviewer"` |218| `agent` | 将主线程作为命名 subagent 运行，并为从 `claude agents` 分派的会话设置默认 agent。应用该 subagent 的系统提示、工具限制和模型。请参阅[显式调用 subagents](/zh-CN/sub-agents#invoke-subagents-explicitly) | `"code-reviewer"` |

219| `agentPushNotifEnabled` | {/* min-version: 2.1.119 */}**默认**：`false`。当[远程控制](/zh-CN/remote-control)已连接时，允许 Claude 向您的手机发送主动推送通知，例如当长任务完成时。在 `/config` 中显示为**Claude 决定时推送**。请参阅[移动推送通知](/zh-CN/remote-control#mobile-push-notifications)。需要 Claude Code v2.1.119 或更高版本 | `true` |219| `agentPushNotifEnabled` | {/* min-version: 2.1.119 */}**默认**：`false`。当[远程控制](/zh-CN/remote-control)已连接时，允许 Claude 向您的手机发送主动推送通知，例如当长任务完成时。在 `/config` 中显示为**Claude 决定时推送**。请参阅[移动推送通知](/zh-CN/remote-control#mobile-push-notifications)。需要 Claude Code v2.1.119 或更高版本 | `true` |

220| `allowAllClaudeAiMcps` | （仅 Managed 设置）加载 claude.ai connectors 与部署的 `managed-mcp.json` 一起，否则后者会获得独占控制并抑制它们。请参阅 [Managed MCP 配置](/zh-CN/managed-mcp) | `true` |220| `allowAllClaudeAiMcps` | （仅 Managed 设置）加载 claude.ai connectors 与部署的 `managed-mcp.json` 一起，否则后者会获得独占控制并抑制它们。请参阅 [Managed MCP 配置](/zh-CN/managed-mcp) | `true` |

239| `awaySummaryEnabled` | 在您离开终端几分钟后返回时显示单行会话回顾。设置为 `false` 或在 `/config` 中关闭会话回顾以禁用。与 [`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`](/zh-CN/env-vars) 相同 | `true` |239| `awaySummaryEnabled` | 在您离开终端几分钟后返回时显示单行会话回顾。设置为 `false` 或在 `/config` 中关闭会话回顾以禁用。与 [`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`](/zh-CN/env-vars) 相同 | `true` |

240| `awsAuthRefresh` | 修改 `.aws` 目录的自定义脚本（请参阅[高级凭证配置](/zh-CN/amazon-bedrock#advanced-credential-configuration)） | `aws sso login --profile myprofile` |240| `awsAuthRefresh` | 修改 `.aws` 目录的自定义脚本（请参阅[高级凭证配置](/zh-CN/amazon-bedrock#advanced-credential-configuration)） | `aws sso login --profile myprofile` |

241| `awsCredentialExport` | 输出包含 AWS 凭证的 JSON 的自定义脚本（请参阅[高级凭证配置](/zh-CN/amazon-bedrock#advanced-credential-configuration)） | `/bin/generate_aws_grant.sh` |241| `awsCredentialExport` | 输出包含 AWS 凭证的 JSON 的自定义脚本（请参阅[高级凭证配置](/zh-CN/amazon-bedrock#advanced-credential-configuration)） | `/bin/generate_aws_grant.sh` |

242| `axScreenReader` | {/* min-version: 2.1.181 */}渲染屏幕阅读器友好的输出：没有装饰性边框或动画的平面文本。屏幕阅读器模式始终使用经典渲染器，因此在其活跃时 `tui` 设置无效。[`CLAUDE_AX_SCREEN_READER`](/zh-CN/env-vars) 环境变量和 [`--ax-screen-reader`](/zh-CN/cli-reference#cli-flags) 标志优先。需要 Claude Code v2.1.181 或更高版本 | `true` |242| `axScreenReader` | {/* min-version: 2.1.181 */}渲染屏幕阅读器友好的输出：没有装饰性边框或动画的平面文本。屏幕阅读器模式始终使用经典渲染器，因此在其活跃时 `tui` 设置无效；附加的[后台会话](/zh-CN/agent-view)仍渲染全屏。[`CLAUDE_AX_SCREEN_READER`](/zh-CN/env-vars) 环境变量和 [`--ax-screen-reader`](/zh-CN/cli-reference#cli-flags) 标志优先。需要 Claude Code v2.1.181 或更高版本 | `true` |

243| `blockedMarketplaces` | （仅 Managed 设置）市场源的阻止列表。在市场添加和插件安装、更新、刷新和自动更新时强制执行，因此在设置策略之前添加的市场无法用于获取插件。被阻止的源在下载前被检查，因此它们永远不会接触文件系统。请参阅 [Managed 市场限制](/zh-CN/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "untrusted/plugins" }]` |243| `blockedMarketplaces` | （仅 Managed 设置）市场源的阻止列表。在市场添加和插件安装、更新、刷新和自动更新时强制执行，因此在设置策略之前添加的市场无法用于获取插件。被阻止的源在下载前被检查，因此它们永远不会接触文件系统。请参阅 [Managed 市场限制](/zh-CN/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "untrusted/plugins" }]` |

244| `browserExternalPageTools` | （仅 Managed 设置）设置为 `"disabled"` 以防止 Claude 使用工具读取或作用于桌面应用[浏览器窗格](/zh-CN/desktop#browse-external-sites)中的外部页面。用户仍可以自己导航到外部站点，本地开发服务器预览不受影响 | `"disabled"` |244| `browserExternalPageTools` | （仅 Managed 设置）设置为 `"disabled"` 以防止 Claude 使用工具读取或作用于桌面应用[浏览器窗格](/zh-CN/desktop#browse-external-sites)中的外部页面。用户仍可以自己导航到外部站点，本地开发服务器预览不受影响 | `"disabled"` |

245| `channelsEnabled` | （仅 Managed 设置）为组织允许 [channels](/zh-CN/channels)。在 claude.ai Team 和 Enterprise 计划上，当此项未设置或为 `false` 时，channels 被阻止。对于使用 API 密钥身份验证的 [Anthropic Console](/zh-CN/authentication#claude-console-authentication) 账户，channels 默认被允许，除非您的组织部署 managed 设置，在这种情况下此键必须设置为 `true` | `true` |245| `channelsEnabled` | （仅 Managed 设置）为组织允许 [channels](/zh-CN/channels)。在 claude.ai Team 和 Enterprise 计划上，当此项未设置或为 `false` 时，channels 被阻止。对于使用 API 密钥身份验证的 [Anthropic Console](/zh-CN/authentication#claude-console-authentication) 账户，channels 默认被允许，除非您的组织部署 managed 设置，在这种情况下此键必须设置为 `true` | `true` |

871* `hostPattern`：正则表达式模式以匹配市场主机（使用 `hostPattern`）871* `hostPattern`：正则表达式模式以匹配市场主机（使用 `hostPattern`）

872* `settings`：直接在 settings.json 中声明的内联市场，无需单独的托管存储库（使用 `name` 和 `plugins`）872* `settings`：直接在 settings.json 中声明的内联市场，无需单独的托管存储库（使用 `name` 和 `plugins`）

873 873 

874`git` 源类型适用于任何 git 托管服务，包括自托管的 GitLab 和 Bitbucket。Claude Code 使用与该机器上 `git clone` 相同的身份验证克隆存储库：配置的凭证助手、SSH 密钥或特定主机的令牌环境变量。有关设置详情，请参阅[私有存储库](/zh-CN/plugin-marketplaces#private-repositories)。874`git` 源类型适用于任何 git 托管服务，包括自托管的 GitLab 和 Bitbucket。Claude Code 使用与该机器上 `git clone` 相同的身份验证克隆存储库：配置的凭证助手或 SSH 密钥。提供者令牌（如 `GITHUB_TOKEN`）仅通过读取它的凭证助手生效。有关设置详情，请参阅[私有存储库](/zh-CN/plugin-marketplaces#private-repositories)。

875 875 

876对于 `github` 和 `git` 源，在 `source` 对象内设置 `"skipLfs": true`（与 `repo` 或 `url` 一起）以在 Claude Code 克隆或更新市场存储库时跳过 Git LFS 下载。LFS 指针文件保持为指针而不是下载其内容。当存储库包含与插件内容无关的大型 LFS 对象时，使用此选项。{/* min-version: 2.1.153 */}需要 Claude Code v2.1.153 或更高版本。876对于 `github` 和 `git` 源，在 `source` 对象内设置 `"skipLfs": true`（与 `repo` 或 `url` 一起）以在 Claude Code 克隆或更新市场存储库时跳过 Git LFS 下载。LFS 指针文件保持为指针而不是下载其内容。当存储库包含与插件内容无关的大型 LFS 对象时，使用此选项。{/* min-version: 2.1.153 */}需要 Claude Code v2.1.153 或更高版本。

877 877 

1158 1158 

1159**仅 Managed 设置**：阻止 skills、agents、hooks 和 MCP servers 来自用户和项目源，因此它们只能来自插件或 managed 设置。将其与 `strictKnownMarketplaces` 结合以控制完整的自定义供应链：市场允许列表控制用户可以安装哪些插件，此设置阻止所有不来自插件或 managed 设置的内容。1159**仅 Managed 设置**：阻止 skills、agents、hooks 和 MCP servers 来自用户和项目源，因此它们只能来自插件或 managed 设置。将其与 `strictKnownMarketplaces` 结合以控制完整的自定义供应链：市场允许列表控制用户可以安装哪些插件，此设置阻止所有不来自插件或 managed 设置的内容。

1160 1160 

1161<Note>

1162 `strictPluginOnlyCustomization` 需要 Claude Code v2.1.82 或更高版本。早期版本忽略该键并继续加载用户和项目自定义，因此锁定在客户端更新之前不会强制执行。

1163</Note>

1164 

1165该值要么是 `true` 以锁定所有四个表面，要么是命名要锁定的表面的数组：1161该值要么是 `true` 以锁定所有四个表面，要么是命名要锁定的表面的数组：

1166 1162 

1167```json theme={null}1163```json theme={null}

870 870 

871嵌套 subagent 的配置方式与顶级 subagent 相同，并从相同的 [scopes](#choose-the-subagent-scope) 解析。871嵌套 subagent 的配置方式与顶级 subagent 相同，并从相同的 [scopes](#choose-the-subagent-scope) 解析。

872 872 

873subagent 面板在提示输入下方显示完整的树：每行显示一个 `(+N)` 后代计数，{/* min-version: 2.1.193 */}从 v2.1.193 开始，打开一行显示该 subagent 的兄弟和直接子代，以及返回到 `main` 的路径。

874 

873深度计算为主对话下方的 subagent 级别数，无论每个级别是否在 [前台或后台](#run-subagents-in-foreground-or-background) 运行。深度为五的 subagent 不接收 Agent 工具，无法进一步生成。限制是固定的且不可配置。875深度计算为主对话下方的 subagent 级别数，无论每个级别是否在 [前台或后台](#run-subagents-in-foreground-or-background) 运行。深度为五的 subagent 不接收 Agent 工具，无法进一步生成。限制是固定的且不可配置。

874 876 

875从 Claude Code v2.1.187 开始，后台 subagent 的深度在首次生成时是固定的，[恢复](#resume-subagents)它稍后不会改变该深度。例如，如果您的主对话生成 subagent A，而 A 在深度二生成后台 subagent B，当您直接从主对话恢复 B 时，B 仍然在深度二。从更浅的上下文恢复 subagent 不会让它生成深度限制已经阻止的额外级别。877从 Claude Code v2.1.187 开始，后台 subagent 的深度在首次生成时是固定的，[恢复](#resume-subagents)它稍后不会改变该深度。例如，如果您的主对话生成 subagent A，而 A 在深度二生成后台 subagent B，当您直接从主对话恢复 B 时，B 仍然在深度二。从更浅的上下文恢复 subagent 不会让它生成深度限制已经阻止的额外级别。

922[Claude resumes the subagent with full context from previous conversation]924[Claude resumes the subagent with full context from previous conversation]

923```925```

924 926 

925如果停止的 subagent 接收 `SendMessage`，它会在后台自动恢复，无需新的 `Agent` 调用。927完成的 subagent 如果接收 `SendMessage`，会在后台自动恢复，无需新的 `Agent` 调用。同样适用于 Claude 用 `TaskStop` 工具停止的 subagent。

928 

929{/* min-version: 2.1.191 */}从 v2.1.191 开始，您自己停止的 subagent，使用 `/tasks` 中的 `x` 或 SDK `stop_task` 请求，不会自动恢复。`SendMessage` 调用返回拒绝，告诉 Claude 代理已被取消。在 subagent 面板中输入到该 subagent 的转录以自己恢复它，这会清除停止，以便稍后 `SendMessage` 调用可以再次自动恢复它。

926 930 

927恢复在相同 ID 下启动代理的新运行，所以已经失败或完成的 subagent 在任务列表和 Agent SDK 的任务事件中再次显示为运行。在 v2.1.205 之前，它在恢复的运行工作时保持显示其早期的失败或完成状态。931恢复在相同 ID 下启动代理的新运行，所以已经失败或完成的 subagent 在任务列表和 Agent SDK 的任务事件中再次显示为运行。在 v2.1.205 之前，它在恢复的运行工作时保持显示其早期的失败或完成状态。

928 932 

296 296 

297如果显示闪烁或在 Claude 工作时滚动位置跳跃，请切换到[全屏渲染模式](/zh-CN/fullscreen)。它绘制到终端为全屏应用程序保留的单独屏幕，而不是附加到您的正常滚动条，这保持内存使用平稳并为滚动和选择添加鼠标支持。在此模式下，您使用鼠标或 PageUp 在 Claude Code 内滚动，而不是使用您的终端的本机滚动条；请参阅[全屏页面](/zh-CN/fullscreen#search-and-review-the-conversation)了解如何搜索和复制。297如果显示闪烁或在 Claude 工作时滚动位置跳跃，请切换到[全屏渲染模式](/zh-CN/fullscreen)。它绘制到终端为全屏应用程序保留的单独屏幕，而不是附加到您的正常滚动条，这保持内存使用平稳并为滚动和选择添加鼠标支持。在此模式下，您使用鼠标或 PageUp 在 Claude Code 内滚动，而不是使用您的终端的本机滚动条；请参阅[全屏页面](/zh-CN/fullscreen#search-and-review-the-conversation)了解如何搜索和复制。

298 298 

299运行 `/tui fullscreen` 在当前会话中切换，您的对话保持不变。要使其成为默认值，请在启动 Claude Code 之前设置 `CLAUDE_CODE_NO_FLICKER` 环境变量：299运行 `/tui fullscreen` 以切换并保存偏好设置。您的对话将完整重新启动，未来的会话将在全屏中启动。您也可以在启动 Claude Code 之前设置 `CLAUDE_CODE_NO_FLICKER` 环境变量：

300 300 

301<CodeGroup>301<CodeGroup>

302 ```bash Bash and Zsh theme={null}302 ```bash Bash and Zsh theme={null}

39| `RemoteTrigger` | 在 claude.ai 上创建、更新、运行和列出 [Routines](/zh-CN/routines)。支持 `/schedule` 命令。{/* plan-availability: feature=routines plans=pro,max,team,enterprise providers=anthropic */}Routines 存在于 claude.ai 上，需要 Pro、Max、Team 或 Enterprise 计划，因此此工具无法从 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 访问 | 否 |39| `RemoteTrigger` | 在 claude.ai 上创建、更新、运行和列出 [Routines](/zh-CN/routines)。支持 `/schedule` 命令。{/* plan-availability: feature=routines plans=pro,max,team,enterprise providers=anthropic */}Routines 存在于 claude.ai 上，需要 Pro、Max、Team 或 Enterprise 计划，因此此工具无法从 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 访问 | 否 |

40| `ReportFindings` | 将代码审查发现报告为结构化列表，每个发现包含文件、摘要和失败场景，以便 Claude Code 可以呈现它们而不是将其打印为文本。当活跃的代码审查指令告诉它时，Claude 会调用它。{/* min-version: 2.1.196 */}需要 Claude Code v2.1.196 或更高版本。{/* min-version: 2.1.199 */}从 v2.1.199 起，发现还可以携带可选的 `category` slug，例如 `correctness` 或 `test-coverage`，显示在呈现列表中的文件位置旁边 | 否 |40| `ReportFindings` | 将代码审查发现报告为结构化列表，每个发现包含文件、摘要和失败场景，以便 Claude Code 可以呈现它们而不是将其打印为文本。当活跃的代码审查指令告诉它时，Claude 会调用它。{/* min-version: 2.1.196 */}需要 Claude Code v2.1.196 或更高版本。{/* min-version: 2.1.199 */}从 v2.1.199 起，发现还可以携带可选的 `category` slug，例如 `correctness` 或 `test-coverage`，显示在呈现列表中的文件位置旁边 | 否 |

41| `ScheduleWakeup` | 重新安排 [self-paced `/loop`](/zh-CN/scheduled-tasks#let-claude-choose-the-interval) 的下一次迭代。Claude 在每次迭代结束时调用此工具以选择下一次运行的时间，范围在一分钟到一小时之间；您不需要直接调用它。要结束循环，Claude 会调用它并设置 `stop: true`，这会取消待处理的唤醒。{/* min-version: 2.1.202 */}`stop` 字段需要 Claude Code v2.1.202 或更高版本。待处理的唤醒显示在 [Stop hook input](/zh-CN/hooks#stop-input) 中的 `session_crons` 中。{/* plan-availability: feature=loop-dynamic providers=anthropic */}在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用，其中没有间隔的 `/loop` 提示按固定时间表运行 | 否 |41| `ScheduleWakeup` | 重新安排 [self-paced `/loop`](/zh-CN/scheduled-tasks#let-claude-choose-the-interval) 的下一次迭代。Claude 在每次迭代结束时调用此工具以选择下一次运行的时间，范围在一分钟到一小时之间；您不需要直接调用它。要结束循环，Claude 会调用它并设置 `stop: true`，这会取消待处理的唤醒。{/* min-version: 2.1.202 */}`stop` 字段需要 Claude Code v2.1.202 或更高版本。待处理的唤醒显示在 [Stop hook input](/zh-CN/hooks#stop-input) 中的 `session_crons` 中。{/* plan-availability: feature=loop-dynamic providers=anthropic */}在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用，其中没有间隔的 `/loop` 提示按固定时间表运行 | 否 |

42| `SendMessage` | 向 [agent team](/zh-CN/agent-teams) 队友发送消息，或按 agent ID 或名称[恢复 subagent](/zh-CN/sub-agents#resume-subagents)。已停止的 subagents 在后台自动恢复。结构化的团队协议消息需要 agent teams。接收者永远不会将来自另一个 agent 的消息视为您的同意或批准。{/* min-version: 2.1.198 */}从 v2.1.198 起，subagent 将来自启动它的 agent 的消息视为正常任务指示，而不是对等请求。{/* min-version: 2.1.199 */}从 v2.1.199 起，发送到现在解析为与对话早期不同的 agent 的名称会被拒绝而不是传递；请参阅[恢复 subagents](/zh-CN/sub-agents#resume-subagents) | 否 |42| `SendMessage` | 向 [agent team](/zh-CN/agent-teams) 队友发送消息，或按 agent ID 或名称[恢复 subagent](/zh-CN/sub-agents#resume-subagents)。已完成的 subagent 在后台自动恢复；您从 `/tasks` 停止的 subagent 不会，调用返回拒绝。结构化的团队协议消息需要 agent teams。接收者永远不会将来自另一个 agent 的消息视为您的同意或批准。{/* min-version: 2.1.198 */}从 v2.1.198 起，subagent 将来自启动它的 agent 的消息视为正常任务指示，而不是对等请求。{/* min-version: 2.1.199 */}从 v2.1.199 起，发送到现在解析为与对话早期不同的 agent 的名称会被拒绝而不是传递；请参阅[恢复 subagents](/zh-CN/sub-agents#resume-subagents) | 否 |

43| `SendUserFile` | 将会话中的文件发送给您，带有可选的标题，以便生成的报告、图表、屏幕截图或构建的工件到达您的设备，而不仅仅是在记录中提及。{/* min-version: 2.1.196 */}从 v2.1.196 起，可选的 `display` 输入控制呈现方式：`render` 在客户端中内联打开文件，`attach` 仅显示下载卡，未设置时客户端按文件类型决定。当连接了 [Remote Control](/zh-CN/remote-control) 客户端或会话在托管云环境（如 [Claude Code on the web](/zh-CN/claude-code-on-the-web)）中运行时可用。传递通过 Anthropic 托管的基础设施运行，因此该工具在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用 | 否 |43| `SendUserFile` | 将会话中的文件发送给您，带有可选的标题，以便生成的报告、图表、屏幕截图或构建的工件到达您的设备，而不仅仅是在记录中提及。{/* min-version: 2.1.196 */}从 v2.1.196 起，可选的 `display` 输入控制呈现方式：`render` 在客户端中内联打开文件，`attach` 仅显示下载卡，未设置时客户端按文件类型决定。当连接了 [Remote Control](/zh-CN/remote-control) 客户端或会话在托管云环境（如 [Claude Code on the web](/zh-CN/claude-code-on-the-web)）中运行时可用。传递通过 Anthropic 托管的基础设施运行，因此该工具在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用 | 否 |

44| `ShareOnboardingGuide` | {/* plan-availability: feature=onboarding-guide-share plans=pro,max,team,enterprise providers=anthropic */}上传 `ONBOARDING.md` 并返回队友可以在 Claude Code 中打开的共享链接。在编写指南后从 `/team-onboarding` 调用。适用于 Pro、Max、Team 和 Enterprise 计划上的 claude.ai 订阅者 | 是 |44| `ShareOnboardingGuide` | {/* plan-availability: feature=onboarding-guide-share plans=pro,max,team,enterprise providers=anthropic */}上传 `ONBOARDING.md` 并返回队友可以在 Claude Code 中打开的共享链接。在编写指南后从 `/team-onboarding` 调用。适用于 Pro、Max、Team 和 Enterprise 计划上的 claude.ai 订阅者 | 是 |

45| `Skill` | 在主对话中执行 [skill](/zh-CN/skills#control-who-invokes-a-skill) | 是 |45| `Skill` | 在主对话中执行 [skill](/zh-CN/skills#control-who-invokes-a-skill) | 是 |

204 Monitor 工具204 Monitor 工具

205</h2>205</h2>

206 206 

207<Note>

208 Monitor 工具需要 Claude Code v2.1.98 或更高版本。

209</Note>

210 

211Monitor 工具让 Claude 在后台监视某些内容，并在其更改时做出反应，而无需暂停对话。要求 Claude：207Monitor 工具让 Claude 在后台监视某些内容，并在其更改时做出反应，而无需暂停对话。要求 Claude：

212 208 

213* 跟踪日志文件并在错误出现时标记它们209* 跟踪日志文件并在错误出现时标记它们

7> 从 CLI 启动计划，在网络上的 Claude Code 中草拟，然后远程执行或在终端中执行7> 从 CLI 启动计划，在网络上的 Claude Code 中草拟，然后远程执行或在终端中执行

8 8 

9<Note>9<Note>

10 Ultraplan 处于研究预览阶段，需要 Claude Code v2.1.91 或更高版本。行为和功能可能会根据反馈而改变。10 Ultraplan 处于研究预览阶段。行为和功能可能会根据反馈而改变。

11</Note>11</Note>

12 12 

13Ultraplan 将规划任务从本地 CLI 交给在 [plan mode](/zh-CN/permission-modes#analyze-before-you-edit-with-plan-mode) 中运行的 [网络上的 Claude Code](/zh-CN/claude-code-on-the-web) 会话。Claude 在云端草拟计划，同时你可以继续在终端中工作。计划准备好后，你在浏览器中打开它来对特定部分进行评论、请求修订，并选择在何处执行。13Ultraplan 将规划任务从本地 CLI 交给在 [plan mode](/zh-CN/permission-modes#analyze-before-you-edit-with-plan-mode) 中运行的 [网络上的 Claude Code](/zh-CN/claude-code-on-the-web) 会话。Claude 在云端草拟计划，同时你可以继续在终端中工作。计划准备好后，你在浏览器中打开它来对特定部分进行评论、请求修订，并选择在何处执行。

7> 使用 /code-review ultra 在云中运行深度多代理代码审查，在合并前查找和验证错误。7> 使用 /code-review ultra 在云中运行深度多代理代码审查，在合并前查找和验证错误。

8 8 

9<Note>9<Note>

10 Ultrareview 是 Claude Code v2.1.86 及更高版本中提供的研究预览功能。该功能、定价和可用性可能会根据反馈而改变。该命令现在通过 `/code-review ultra` 调用，`/ultrareview` 仍然作为别名保留。10 Ultrareview 是一个研究预览功能。该功能、定价和可用性可能会根据反馈而改变。该命令现在通过 `/code-review ultra` 调用，`/ultrareview` 仍然作为别名保留。

11</Note>11</Note>

12 12 

13Ultrareview 是在 Claude Code 网络基础设施上运行的深度代码审查。当您运行 `/code-review ultra` 时，Claude Code 在远程沙箱中启动一队审查代理来查找您的分支或拉取请求中的错误。13Ultrareview 是在 Claude Code 网络基础设施上运行的深度代码审查。当您运行 `/code-review ultra` 时，Claude Code 在远程沙箱中启动一队审查代理来查找您的分支或拉取请求中的错误。

9在 Claude Code CLI 中说出你的提示词，而不是输入它们。你的语音会实时转录到提示词输入中，所以你可以在同一条消息中混合使用语音和输入。使用 `/voice` 启用听写，然后要么在说话时按住一个键，要么点击一次开始，再点击一次发送。9在 Claude Code CLI 中说出你的提示词，而不是输入它们。你的语音会实时转录到提示词输入中，所以你可以在同一条消息中混合使用语音和输入。使用 `/voice` 启用听写，然后要么在说话时按住一个键，要么点击一次开始，再点击一次发送。

10 10 

11<Note>11<Note>

12 语音听写需要 Claude Code v2.1.69 或更高版本。点击模式需要 v2.1.116 或更高版本。使用 `claude --version` 检查你的版本。12 点击模式需要 Claude Code v2.1.116 或更高版本。使用 `claude --version` 检查你的版本。

13</Note>13</Note>

14 14 

15听写功能也适用于[代理视图](/zh-CN/agent-view#peek-and-reply)。在调度输入或窥视面板回复获得焦点时，按住或点击你的按键通话键，以便向后台会话进行听写。15听写功能也适用于[代理视图](/zh-CN/agent-view#peek-and-reply)。在调度输入或窥视面板回复获得焦点时，按住或点击你的按键通话键，以便向后台会话进行听写。

214 214 

215`/web-setup` 在 Claude Code CLI 内运行，而不是在您的 shell 中。首先启动 `claude`，然后在提示符处输入 `/web-setup`。215`/web-setup` 在 Claude Code CLI 内运行，而不是在您的 shell 中。首先启动 `claude`，然后在提示符处输入 `/web-setup`。

216 216 

217如果您在 Claude Code 内输入它，命令菜单显示 `No commands match "/web-setup"`，或提交它返回 `Unknown command: /web-setup`，该命令被隐藏是因为未满足要求。原因通常是您的 CLI 版本早于 v2.1.80，或者您使用 API 密钥或第三方提供商而不是 claude.ai 订阅进行身份验证。运行 `claude update`，然后 `/login` 以使用您的 claude.ai 账户登录。217如果您在 Claude Code 内输入它，命令菜单显示 `No commands match "/web-setup"`，或提交它返回 `Unknown command: /web-setup`，该命令被隐藏是因为未满足要求。原因通常是您使用 API 密钥或第三方提供商而不是 claude.ai 订阅进行身份验证。运行 `/login` 以使用您的 claude.ai 账户登录。

218 218 

219<h3 id="could-not-create-a-cloud-environment-or-no-cloud-environment-available-when-using-cloud-or-ultraplan">219<h3 id="could-not-create-a-cloud-environment-or-no-cloud-environment-available-when-using-cloud-or-ultraplan">

220 使用 `--cloud` 或 ultraplan 时出现 "Could not create a cloud environment" 或 "No cloud environment available"220 使用 `--cloud` 或 ultraplan 时出现 "Could not create a cloud environment" 或 "No cloud environment available"

7> 自动模式用于免提权限、内置计算机使用、云端PR自动修复、转录搜索和Windows PowerShell工具。7> 自动模式用于免提权限、内置计算机使用、云端PR自动修复、转录搜索和Windows PowerShell工具。

8 8 

9<div className="digest-meta">9<div className="digest-meta">

10 <span>发布版本 <a href="/zh-CN/docs/changelog#2-1-83">v2.1.83 → v2.1.85</a></span>10 <span>发布版本 <a href="/docs/en/changelog#2-1-83">v2.1.83 → v2.1.85</a></span>

11 <span>6项功能 · 3月23–27日</span>11 <span>6项功能 · 3月23–27日</span>

12</div>12</div>

13 13 

161 </div>161 </div>

162</div>162</div>

163 163 

164[v2.1.83–v2.1.85 完整更新日志 →](/zh-CN/changelog#2-1-83)164[v2.1.83–v2.1.85 完整更新日志 →](/en/changelog#2-1-83)

7> CLI 中的计算机使用、交互式产品内课程、无闪烁渲染、按工具 MCP 结果大小覆盖以及 PATH 上的插件可执行文件。7> CLI 中的计算机使用、交互式产品内课程、无闪烁渲染、按工具 MCP 结果大小覆盖以及 PATH 上的插件可执行文件。

8 8 

9<div className="digest-meta">9<div className="digest-meta">

10 <span>发布版本 <a href="/zh-CN/docs/changelog#2-1-86">v2.1.86 → v2.1.91</a></span>10 <span>发布版本 <a href="/docs/en/changelog#2-1-86">v2.1.86 → v2.1.91</a></span>

11 <span>5 项功能 · 3 月 30 日 – 4 月 3 日</span>11 <span>5 项功能 · 3 月 30 日 – 4 月 3 日</span>

12</div>12</div>

13 13 

135 </div>135 </div>

136</div>136</div>

137 137 

138[v2.1.86–v2.1.91 的完整更改日志 →](/zh-CN/changelog#2-1-86)138[v2.1.86–v2.1.91 的完整更改日志 →](/en/changelog#2-1-86)

7> Ultraplan 云规划、具有自适应 /loop 的 Monitor 工具、用于打包设置的 /team-onboarding 以及从终端运行的 /autofix-pr。7> Ultraplan 云规划、具有自适应 /loop 的 Monitor 工具、用于打包设置的 /team-onboarding 以及从终端运行的 /autofix-pr。

8 8 

9<div className="digest-meta">9<div className="digest-meta">

10 <span>发布版本 <a href="/zh-CN/docs/changelog#2-1-92">v2.1.92 → v2.1.101</a></span>10 <span>发布版本 <a href="/docs/en/changelog#2-1-92">v2.1.92 → v2.1.101</a></span>

11 <span>4 项功能 · 4月6–10日</span>11 <span>4 项功能 · 4月6–10日</span>

12</div>12</div>

13 13 

116 </div>116 </div>

117</div>117</div>

118 118 

119[v2.1.92–v2.1.101 的完整更改日志 →](/zh-CN/changelog#2-1-92)119[v2.1.92–v2.1.101 的完整更改日志 →](/en/changelog#2-1-92)

7> Claude Opus 4.7 配备新的 xhigh 努力级别、Claude Code 网页版上的 Routines、移动推送通知在 Claude 需要您时 ping 您的手机、显示限制驱动因素的 /usage 分解，以及替代捆绑 JavaScript 的原生二进制文件。7> Claude Opus 4.7 配备新的 xhigh 努力级别、Claude Code 网页版上的 Routines、移动推送通知在 Claude 需要您时 ping 您的手机、显示限制驱动因素的 /usage 分解，以及替代捆绑 JavaScript 的原生二进制文件。

8 8