Documentation 2026-09-20 23:59 UTC to 2026-09-21 22:59 UTC

326每个工件都是一个独立的页面。Claude Code 将您发布的文件包装在 HTML 文档外壳中，并在严格的内容安全策略 (CSP) 下提供服务，这决定了页面可以执行的操作。326每个工件都是一个独立的页面。Claude Code 将您发布的文件包装在 HTML 文档外壳中，并在严格的内容安全策略 (CSP) 下提供服务，这决定了页面可以执行的操作。

327 327 

328| 约束 | 效果 |328| 约束 | 效果 |

329| :---- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |329| :---- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

330| 外部请求 | 页面可以从 Google Fonts 加载字体，以及从[四个公共 CDN 主机](#allowlist-the-viewer-domain)加载脚本：cdnjs、Tailwind 和 jQuery CDN，以及 jsDelivr 上的选定路径，例如 `/npm/`。CSP 阻止所有外部图像和所有其他外部脚本、样式表和字体，并让 `fetch`、XHR 和 WebSocket 调用仅到达页面自身的源和 Google Fonts 主机。因此，Claude 从这些 CDN 之一加载页面需要的任何库，内联所有其他 CSS 和 JavaScript，并将图像嵌入为数据 URI。[连接器调用](#pull-live-data-with-mcp-connectors)通过 claude.ai 进行，它自己进行网络调用。 |330| 外部请求 | 页面可以从 Google Fonts 加载字体，以及从[五个公共 CDN 主机](#allowlist-the-viewer-domain)加载脚本：cdnjs、unpkg、Tailwind 和 jQuery CDN，以及 jsDelivr 上的选定路径，例如 `/npm/`。CSP 阻止所有外部图像和所有其他外部脚本、样式表和字体，并让 `fetch`、XHR 和 WebSocket 调用仅到达页面自身的源和 Google Fonts 主机。因此，Claude 从这些 CDN 之一加载页面需要的任何库，内联所有其他 CSS 和 JavaScript，并将图像嵌入为数据 URI。[连接器调用](#pull-live-data-with-mcp-connectors)通过 claude.ai 进行，它自己进行网络调用。 |

331| 无后端 | 工件是一个静态页面。它无法自行对查看者进行身份验证。 |331| 无后端 | 工件是一个静态页面。它无法自行对查看者进行身份验证。 |

332| 下载 | 页面无法自行启动下载。为了让查看者保存页面生成的文件，Claude 声明下载功能。请参阅[提供文件下载](#offer-a-file-download)。 |332| 下载 | 页面无法自行启动下载。为了让查看者保存页面生成的文件，Claude 声明下载功能。请参阅[提供文件下载](#offer-a-file-download)。 |

333| 单页面 | 相对链接无法解析，因为页面旁边没有部署任何内容。对于多部分内容，Claude 使用页面内锚点而不是单独的文件。 |333| 单页面 | 相对链接无法解析，因为页面旁边没有部署任何内容。对于多部分内容，Claude 使用页面内锚点而不是单独的文件。 |

417 417 

418从 [Google Fonts](#improve-the-visual-design) 加载字体的 artifact 也会请求 `fonts.googleapis.com` 和 `fonts.gstatic.com`。两个主机都是可选的。如果您阻止它们，artifacts 将以备用字体呈现。使用快速拒绝而不是静默丢弃来阻止，以便字体请求立即失败，而不是延迟页面的首次呈现。418从 [Google Fonts](#improve-the-visual-design) 加载字体的 artifact 也会请求 `fonts.googleapis.com` 和 `fonts.gstatic.com`。两个主机都是可选的。如果您阻止它们，artifacts 将以备用字体呈现。使用快速拒绝而不是静默丢弃来阻止，以便字体请求立即失败，而不是延迟页面的首次呈现。

419 419 

420Artifacts 还可以从 `cdnjs.cloudflare.com`、`cdn.jsdelivr.net`、`cdn.tailwindcss.com` 和 `code.jquery.com` 加载 JavaScript 库（如 React 或图表包），而不能从任何其他外部主机加载。如果您阻止这些主机，artifact 中依赖库的部分将无法工作，与被阻止的字体不同，被阻止的库没有备用方案。在这里也使用快速拒绝，以便被阻止的库请求立即失败，而不是挂起直到超时。420Artifacts 还可以从 `cdnjs.cloudflare.com`、`cdn.jsdelivr.net`、`cdn.tailwindcss.com`、`code.jquery.com` 和 `unpkg.com` 加载 JavaScript 库（如 React 或图表包），而不能从任何其他外部主机加载。如果您阻止这些主机，artifact 中依赖库的部分将无法工作，与被阻止的字体不同，被阻止的库没有备用方案。在这里也使用快速拒绝，以便被阻止的库请求立即失败，而不是挂起直到超时。

421 421 

422<h3 id="list-and-delete-artifacts-with-the-compliance-api">422<h3 id="list-and-delete-artifacts-with-the-compliance-api">

423 使用 Compliance API 列出和删除 artifacts423 使用 Compliance API 列出和删除 artifacts

168 volumes: { pgdata: }168 volumes: { pgdata: }

169 ```169 ```

170 170 

171 网关是一个单一的 Linux 二进制文件，读取配置，连接到 Postgres 并应用其架构迁移，针对您的 IdP 运行 OIDC 发现，构建上游客户端，并开始侦听。启动对配置、Postgres 连接（5 秒超时）、OIDC 发现和上游客户端构造是失败关闭的。如果其中任何一个无法访问或配置错误，网关会以错误退出，而不是以降级状态提供流量。171 网关是一个单一的 Linux 二进制文件，读取配置，连接到 Postgres 并应用其架构迁移，针对您的 IdP 运行 OIDC 发现，构建上游客户端，并开始侦听。启动对配置、Postgres 连接、OIDC 发现和上游客户端构造是失败关闭的。如果其中任何一个无法访问或配置错误，网关会以错误退出，而不是以降级状态提供流量。

172 172 

173 成功启动不会验证推理路径，因为 Amazon Bedrock 和 Google Cloud 的 Agent Platform 实例凭证在第一个请求时解析，而不是在启动时。173 成功启动不会验证推理路径，因为 Amazon Bedrock 和 Google Cloud 的 Agent Platform 实例凭证在第一个请求时解析，而不是在启动时。

174 174 

269 269 

270当证书轮换时，每个开发人员都会再次看到信任提示，因此将轮换视为计划事件并重新发布指纹。如果您的网关策略包含[需要批准的设置](/docs/zh-CN/server-managed-settings#security-approval-dialogs)，开发人员在接受新证书后也会再次看到该批准对话框，因为 Claude Code 将[批准记忆](/docs/zh-CN/server-managed-settings#approval-memory)关键到固定的证书。270当证书轮换时，每个开发人员都会再次看到信任提示，因此将轮换视为计划事件并重新发布指纹。如果您的网关策略包含[需要批准的设置](/docs/zh-CN/server-managed-settings#security-approval-dialogs)，开发人员在接受新证书后也会再次看到该批准对话框，因为 Claude Code 将[批准记忆](/docs/zh-CN/server-managed-settings#approval-memory)关键到固定的证书。

271 271 

272网关可以在其令牌响应中返回可选的 `email` 字段，以命名登录使用的账户。当它这样做时，开发人员在 Claude Code 保存凭证之前确认账户。确认登录后，`/status` 显示账户。

273 

274确认需要开发人员机器上的 Claude Code v2.1.275 或更高版本；低于该版本的客户端忽略该字段。`claude` 二进制文件中的网关服务器不返回该字段，因此其登录完成时没有确认。

275 

272开发人员登录后，[模型选择器](/docs/zh-CN/model-config)显示其 `availableModels` 允许列表中的模型。托管设置在启动时应用并每小时刷新一次，遥测路由到您的收集器。276开发人员登录后，[模型选择器](/docs/zh-CN/model-config)显示其 `availableModels` 允许列表中的模型。托管设置在启动时应用并每小时刷新一次，遥测路由到您的收集器。

273 277 

274会话在 `ttl_hours` 过期前静默刷新。当 IdP 取消配置后刷新失败时，Claude Code 会提示开发人员重新登录。278会话在 `ttl_hours` 过期前静默刷新。当 IdP 取消配置后刷新失败时，Claude Code 会提示开发人员重新登录。

485* **启动时网关无法访问**：已登录的会话在启动时约 10 秒后以错误退出，而不是在没有其设置的情况下启动。489* **启动时网关无法访问**：已登录的会话在启动时约 10 秒后以错误退出，而不是在没有其设置的情况下启动。

486* **启动后网关结束会话**：请参阅[强制执行故障关闭启动](/docs/zh-CN/server-managed-settings#enforce-fail-closed-startup)，了解哪些启动从网关登出打开，哪些在网关以 `401` 应答时退出。490* **启动后网关结束会话**：请参阅[强制执行故障关闭启动](/docs/zh-CN/server-managed-settings#enforce-fail-closed-startup)，了解哪些启动从网关登出打开，哪些在网关以 `401` 应答时退出。

487* **取消配置**：用户在 IdP 中被禁用的会话在下一次刷新失败时在 `ttl_hours` 内过期。491* **取消配置**：用户在 IdP 中被禁用的会话在下一次刷新失败时在 `ttl_hours` 内过期。

492* **登出**：`/logout` 从开发人员的机器删除网关凭证。

493 * 当网关的发现文档在网关 URL 自己的方案、主机和端口上宣传 `revocation_endpoint` 时，`/logout` 也将存储的令牌发送到该端点，以便网关可以在其端结束会话。请求是尽力而为的，因此登出在开发人员的机器上完成，无论端点是否应答。撤销需要开发人员机器上的 Claude Code v2.1.275 或更高版本。

494 * `claude` 二进制文件中的网关服务器不宣传任何，因此从它登出仅在开发人员的机器上结束会话。要强制会话从服务器端退出，请参阅 [JWT 密钥轮换](/docs/zh-CN/claude-apps-gateway-deploy#jwt-secret-rotation)。

488 495 

489<h3 id="what-the-organization-can-see">496<h3 id="what-the-organization-can-see">

490 组织可以看到什么497 组织可以看到什么

926 926 

927从 [Google Fonts](/docs/zh-CN/artifacts#improve-the-visual-design) 加载字体的[工件](/docs/zh-CN/artifacts)也请求 `fonts.googleapis.com` 和 `fonts.gstatic.com`。两个主机都是可选的。如果你阻止它们，工件将以备用字体呈现。使用快速拒绝而不是静默丢弃来阻止，以便字体请求立即失败，而不是延迟页面的首次呈现。927从 [Google Fonts](/docs/zh-CN/artifacts#improve-the-visual-design) 加载字体的[工件](/docs/zh-CN/artifacts)也请求 `fonts.googleapis.com` 和 `fonts.gstatic.com`。两个主机都是可选的。如果你阻止它们，工件将以备用字体呈现。使用快速拒绝而不是静默丢弃来阻止，以便字体请求立即失败，而不是延迟页面的首次呈现。

928 928 

929工件还可以从 `cdnjs.cloudflare.com`、`cdn.jsdelivr.net`、`cdn.tailwindcss.com` 和 `code.jquery.com` 加载 JavaScript 库（如 React 或图表包），而不能从其他任何外部主机加载。如果你阻止这些主机，工件中依赖库的部分将无法工作，与阻止的字体不同，阻止的库没有备用。这里也使用快速拒绝，以便阻止的库请求立即失败，而不是挂起直到超时。929工件还可以从 `cdnjs.cloudflare.com`、`cdn.jsdelivr.net`、`cdn.tailwindcss.com`、`code.jquery.com` 和 `unpkg.com` 加载 JavaScript 库（如 React 或图表包），而不能从其他任何外部主机加载。如果你阻止这些主机，工件中依赖库的部分将无法工作，与阻止的字体不同，阻止的库没有备用。这里也使用快速拒绝，以便阻止的库请求立即失败，而不是挂起直到超时。

930 930 

931<h3 id="authentication-and-sso">931<h3 id="authentication-and-sso">

932 身份验证和 SSO932 身份验证和 SSO

39| `Up/Down arrows` 或 `Ctrl+P`/`Ctrl+N` | 移动光标或导航命令历史 | 当输入跨越多个可视行时，无论是换行还是多行，首先在提示中移动光标。一旦光标在第一行或最后一行，再次按下会导航命令历史。当您有排队的消息时，从第一行按 `Up` 会[取回它们](#take-back-what-you-queued) |39| `Up/Down arrows` 或 `Ctrl+P`/`Ctrl+N` | 移动光标或导航命令历史 | 当输入跨越多个可视行时，无论是换行还是多行，首先在提示中移动光标。一旦光标在第一行或最后一行，再次按下会导航命令历史。当您有排队的消息时，从第一行按 `Up` 会[取回它们](#take-back-what-you-queued) |

40| `Esc` | 中断 Claude 或关闭对话框 | 停止当前响应或工具调用中途，以便您可以重定向。Claude 保留迄今为止所做的工作。如果您有[排队的消息](#queue-messages-while-claude-works)，Claude Code 会在下一步发送它们。当对话框打开时，`Esc` 会关闭对话框。在权限提示上，`Esc` 会拒绝该操作，与[**否**不带注释](/docs/zh-CN/permissions#add-a-comment-when-you-answer-a-permission-prompt)相同 |40| `Esc` | 中断 Claude 或关闭对话框 | 停止当前响应或工具调用中途，以便您可以重定向。Claude 保留迄今为止所做的工作。如果您有[排队的消息](#queue-messages-while-claude-works)，Claude Code 会在下一步发送它们。当对话框打开时，`Esc` 会关闭对话框。在权限提示上，`Esc` 会拒绝该操作，与[**否**不带注释](/docs/zh-CN/permissions#add-a-comment-when-you-answer-a-permission-prompt)相同 |

41| `Esc` + `Esc` | 清除输入草稿或回退 | 当提示输入包含文本时，双 `Esc` 会清除它并将草稿保存到历史记录，以便 `Up` 可以调用它。当输入为空时，双 `Esc` 会打开[回退菜单](/docs/zh-CN/checkpointing)以从之前的某个点恢复或总结代码和对话 |41| `Esc` + `Esc` | 清除输入草稿或回退 | 当提示输入包含文本时，双 `Esc` 会清除它并将草稿保存到历史记录，以便 `Up` 可以调用它。当输入为空时，双 `Esc` 会打开[回退菜单](/docs/zh-CN/checkpointing)以从之前的某个点恢复或总结代码和对话 |

42| `Ctrl+Enter` 或 `Ctrl+X Ctrl+S` | 立即发送排队的消息 | 中断当前轮次，以便您的[排队的消息](#queue-messages-while-claude-works)和您的草稿与它们一起立即发出，而不是在轮次结束时发出。在[shell 模式](#shell-mode-with-prefix)中，该键会排队您的命令而不中断。在不报告扩展键的终端中，`Ctrl+Enter` 作为普通 `Enter` 到达；`Ctrl+X Ctrl+S` 在任何终端中都有效。需要 Claude Code v2.1.275 或更高版本 |

42| `Shift+Tab` 或在 Node 或 Bun 运行时不启用 VT 输入模式时在 Windows 上使用 `Alt+M` | 循环权限模式 | 循环通过 `default`（在模式指示器中标记为 Manual）、`acceptEdits`、`plan` 和（如果可用）`bypassPermissions` 然后 `auto`。从 `auto`，第一次按下切换到 `default`。请参阅[权限模式](/docs/zh-CN/permission-modes)。在文件权限提示上，相同的键会关闭打开的[注释字段](/docs/zh-CN/permissions#add-a-comment-when-you-answer-a-permission-prompt)。如果没有字段打开，它会选择允许该操作在会话其余部分的选项，当提示提供该选项时 |43| `Shift+Tab` 或在 Node 或 Bun 运行时不启用 VT 输入模式时在 Windows 上使用 `Alt+M` | 循环权限模式 | 循环通过 `default`（在模式指示器中标记为 Manual）、`acceptEdits`、`plan` 和（如果可用）`bypassPermissions` 然后 `auto`。从 `auto`，第一次按下切换到 `default`。请参阅[权限模式](/docs/zh-CN/permission-modes)。在文件权限提示上，相同的键会关闭打开的[注释字段](/docs/zh-CN/permissions#add-a-comment-when-you-answer-a-permission-prompt)。如果没有字段打开，它会选择允许该操作在会话其余部分的选项，当提示提供该选项时 |

43| `Option+P`（macOS）或 `Alt+P`（Windows/Linux） | 切换模型 | 在不清除提示的情况下切换模型 |44| `Option+P`（macOS）或 `Alt+P`（Windows/Linux） | 切换模型 | 在不清除提示的情况下切换模型 |

44| `Option+T`（macOS）或 `Alt+T`（Windows/Linux） | 切换扩展思考 | 启用或禁用扩展思考模式。对 Fable 5.1 或 Fable 5 无效，它们始终使用扩展思考。在 macOS 上无需配置 Option 为 Meta 即可工作 |45| `Option+T`（macOS）或 `Alt+T`（Windows/Linux） | 切换扩展思考 | 启用或禁用扩展思考模式。对 Fable 5.1 或 Fable 5 无效，它们始终使用扩展思考。在 macOS 上无需配置 Option 为 Meta 即可工作 |

348* 当 Claude Code 退出时，后台任务会自动清理。在 macOS 和 Linux 上，当你从 [`/tasks`](/docs/zh-CN/commands) 停止后台任务或 Claude Code 在退出时停止它时，从任务的 shell 分离的进程（例如在 `setsid` 或 `timeout` 下启动的进程）也会停止349* 当 Claude Code 退出时，后台任务会自动清理。在 macOS 和 Linux 上，当你从 [`/tasks`](/docs/zh-CN/commands) 停止后台任务或 Claude Code 在退出时停止它时，从任务的 shell 分离的进程（例如在 `setsid` 或 `timeout` 下启动的进程）也会停止

349* 如果你将会话放在后台而不是退出，你的后台任务将继续在后台会话中运行。请参阅[将运行中的会话放在后台](/docs/zh-CN/agent-view#from-inside-a-session)350* 如果你将会话放在后台而不是退出，你的后台任务将继续在后台会话中运行。请参阅[将运行中的会话放在后台](/docs/zh-CN/agent-view#from-inside-a-session)

350* 如果输出超过 5GB，后台任务会自动终止，stderr 中会有说明原因的注释351* 如果输出超过 5GB，后台任务会自动终止，stderr 中会有说明原因的注释

351* 在 macOS 和 Linux 上，当操作系统发出内存压力信号时，Claude Code 会终止运行中的后台任务，前提是会话已空闲至少 30 分钟且没有 turn 或 subagent 运行。设置 [`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`](/docs/zh-CN/env-vars) 为 `1` 可关闭此功能。需要 Claude Code v2.1.193 或更高版本352* 在 macOS 和 Linux 上，当操作系统报告严重内存压力时，Claude Code 会停止运行中的后台任务，前提是会话已空闲至少 30 分钟且没有 turn 或 subagent 运行。需要 Claude Code v2.1.193 或更高版本

353 * [调试日志](/docs/zh-CN/debug-your-config)说明了为什么任务被停止，或为什么压力事件让它们继续运行

354 * 将 [`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`](/docs/zh-CN/env-vars) 设置为 `1` 可关闭内存压力停止

352* 由[子代理](/docs/zh-CN/sub-agents)拥有的后台命令没有时间限制，除非由在前台运行的子代理拥有的命令在该子代理给出最终响应时结束；请参阅工具参考中的[后台命令](/docs/zh-CN/tools-reference#background-commands)。在 v2.1.218 之前，内存压力回收和之前对子代理命令的 60 分钟限制都不包括用 `Ctrl+B` 移到后台的命令355* 由[子代理](/docs/zh-CN/sub-agents)拥有的后台命令没有时间限制，除非由在前台运行的子代理拥有的命令在该子代理给出最终响应时结束；请参阅工具参考中的[后台命令](/docs/zh-CN/tools-reference#background-commands)。在 v2.1.218 之前，内存压力回收和之前对子代理命令的 60 分钟限制都不包括用 `Ctrl+B` 移到后台的命令

353 356 

354要禁用所有后台任务功能，请将 `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` 环境变量设置为 `1`。有关详细信息，请参阅[环境变量](/docs/zh-CN/env-vars)。357要禁用所有后台任务功能，请将 `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` 环境变量设置为 `1`。有关详细信息，请参阅[环境变量](/docs/zh-CN/env-vars)。

394 397 

395在 Claude 工作时输入消息并按 `Enter`。Claude Code 会将消息排队而不是中断当前轮次，并在输入框上方列出排队的条目，直到发送它们。您可以以相同的方式排队 `!` [shell 命令](#shell-mode-with-prefix)和大多数[命令](/docs/zh-CN/commands)，除了 `/status` 等 Claude Code 在您发送时立即运行的命令。398在 Claude 工作时输入消息并按 `Enter`。Claude Code 会将消息排队而不是中断当前轮次，并在输入框上方列出排队的条目，直到发送它们。您可以以相同的方式排队 `!` [shell 命令](#shell-mode-with-prefix)和大多数[命令](/docs/zh-CN/commands)，除了 `/status` 等 Claude Code 在您发送时立即运行的命令。

396 399 

400已发送和排队的消息在 Claude 开始响应之前以灰色显示，因此您可以看出 Claude 还没有开始处理哪些消息。

401 

397<h3 id="when-claude-code-sends-what-you-queued">402<h3 id="when-claude-code-sends-what-you-queued">

398 Claude Code 何时发送您排队的内容403 Claude Code 何时发送您排队的内容

399</h3>404</h3>

400 405 

401排队条目何时到达 Claude 取决于您排队的内容。406排队条目何时到达 Claude 取决于您排队的内容。

402 407 

403* 消息：如果您在 Claude 运行工具调用时排队消息，Claude Code 会在这些工具调用完成后立即将其传递给 Claude，在同一轮次内。当轮次以仍有排队消息结束时，Claude Code 仅发送最旧的消息作为下一轮次。其余消息保持排队状态并遵循相同规则：Claude Code 在该轮次的工具调用完成时将其传递给 Claude，或在下一轮次发送下一个最旧的消息408* 消息：如果您在 Claude 运行工具调用时排队消息，Claude Code 会在这些工具调用完成后立即将其传递给 Claude，在同一轮次内。当轮次以仍有排队消息结束时，它们会在没有另一次按键的情况下按您输入的顺序发出

404* 命令和 shell 命令：Claude Code 将其保留到轮次结束，然后逐个运行它们409* 命令和 shell 命令：Claude Code 将其保留到轮次结束，然后逐个运行它们，保持您排队的顺序

410 

411要在不等待轮次完成的情况下发送您排队的内容，请按 `Ctrl+Enter`。Claude Code 会中断轮次，您排队的消息会立即发出，如果您输入了草稿，您的草稿会排在它们后面。在 [shell 模式](#shell-mode-with-prefix)中，该快捷键会排队您的命令而不中断轮次。需要 Claude Code v2.1.275 或更高版本。

412 

413在不报告扩展键的终端中，`Ctrl+Enter` 作为普通 `Enter` 到达并排队草稿；`Ctrl+X Ctrl+S` 在任何终端中都有效。两个快捷键都是 [`chat:sendNow` 操作](/docs/zh-CN/keybindings#chat-actions)的绑定。

405 414 

406按 `Esc` 中断轮次。Claude Code 保留您排队的内容并立即发送。415按 `Esc` 中断轮次而不提交您的草稿。Claude Code 保留您排队的内容并立即发送。

407 416 

408Claude Code 在您发送某些命令时立即运行它们，而不是排队它们，其中包括 `/model`、`/effort` 和 `/fast`。这三个命令各改变一个设置：模型、努力级别或快速模式。Claude Code 是将新设置应用于 Claude 已在处理的轮次，还是仅从您的下一轮次应用，因命令而异：417Claude Code 在您发送某些命令时立即运行它们，而不是排队它们，其中包括 `/model`、`/effort` 和 `/fast`。这三个命令各改变一个设置：模型、努力级别或快速模式。Claude Code 是将新设置应用于 Claude 已在处理的轮次，还是仅从您的下一轮次应用，因命令而异：

409 418 

112在 `Chat` 上下文中可用的操作：112在 `Chat` 上下文中可用的操作：

113 113 

114| 操作 | 默认 | 描述 |114| 操作 | 默认 | 描述 |

115| :-------------------- | :----------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |115| :-------------------- | :----------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

116| `chat:cancel` | Escape | 取消当前输入 |116| `chat:cancel` | Escape | 取消当前输入 |

117| `chat:clearInput` | Ctrl+L | 强制全屏重绘，保留输入和对话。在[全屏渲染](/docs/zh-CN/fullscreen#clear-the-conversation)中，也清除屏幕 |117| `chat:clearInput` | Ctrl+L | 强制全屏重绘，保留输入和对话。在[全屏渲染](/docs/zh-CN/fullscreen#clear-the-conversation)中，也清除屏幕 |

118| `chat:clearScreen` | Cmd+K | 与 `chat:clearInput` 相同。请参阅[清除对话](/docs/zh-CN/fullscreen#clear-the-conversation)了解 Cmd+K 在 iTerm2 和 Terminal.app 上的行为 |118| `chat:clearScreen` | Cmd+K | 与 `chat:clearInput` 相同。请参阅[清除对话](/docs/zh-CN/fullscreen#clear-the-conversation)了解 Cmd+K 在 iTerm2 和 Terminal.app 上的行为 |

123| `chat:thinkingToggle` | Meta+T | 切换扩展思考 |123| `chat:thinkingToggle` | Meta+T | 切换扩展思考 |

124| `chat:submit` | Enter | 提交消息 |124| `chat:submit` | Enter | 提交消息 |

125| `chat:queueSubmit` | Ctrl+X Enter | 提交消息，标记为等待其轮次：当 Claude 工作时，Claude Code [将其排队](/docs/zh-CN/interactive-mode#queue-messages-while-claude-works)并且永远不会中断轮次。与 `chat:submit` 不同，即使自动完成建议被突出显示，它也会提交草稿。需要 v2.1.247 或更高版本 |125| `chat:queueSubmit` | Ctrl+X Enter | 提交消息，标记为等待其轮次：当 Claude 工作时，Claude Code [将其排队](/docs/zh-CN/interactive-mode#queue-messages-while-claude-works)并且永远不会中断轮次。与 `chat:submit` 不同，即使自动完成建议被突出显示，它也会提交草稿。需要 v2.1.247 或更高版本 |

126| `chat:sendNow` | Ctrl+Enter, Ctrl+X Ctrl+S | 中断运行中的轮次，以便您的[排队消息](/docs/zh-CN/interactive-mode#queue-messages-while-claude-works)及其草稿立即发出。当没有任何内容运行时，它会提交草稿，在[shell 模式](/docs/zh-CN/interactive-mode#shell-mode-with-prefix)中它会排队命令而不中断。不报告扩展键的终端将 `Ctrl+Enter` 传递为纯 `Enter`，因此 `Ctrl+X Ctrl+S` 是在任何终端中都有效的绑定。需要 v2.1.275 或更高版本 |

126| `chat:newline` | Ctrl+J | 插入换行符而不提交 |127| `chat:newline` | Ctrl+J | 插入换行符而不提交 |

127| `chat:undo` | Ctrl+\_, Ctrl+Shift+- | 撤销上一个操作 |128| `chat:undo` | Ctrl+\_, Ctrl+Shift+- | 撤销上一个操作 |

128| `chat:externalEditor` | Ctrl+G, Ctrl+X Ctrl+E | 在外部编辑器中打开。[代理视图调度输入](/docs/zh-CN/agent-view#keyboard-shortcuts)也遵循此操作的单键击绑定 |129| `chat:externalEditor` | Ctrl+G, Ctrl+X Ctrl+E | 在外部编辑器中打开。[代理视图调度输入](/docs/zh-CN/agent-view#keyboard-shortcuts)也遵循此操作的单键击绑定 |

542 543 

543这也适用于和弦绑定。取消绑定共享前缀的每个和弦会释放该前缀以用作单键绑定。任何活跃上下文中的和弦都会保留其前缀，因此您必须在定义该和弦的上下文中取消绑定每个和弦。544这也适用于和弦绑定。取消绑定共享前缀的每个和弦会释放该前缀以用作单键绑定。任何活跃上下文中的和弦都会保留其前缀，因此您必须在定义该和弦的上下文中取消绑定每个和弦。

544 545 

545Claude Code 在 `ctrl+x` 前缀上绑定这些默认和弦：`Chat` 中的 `ctrl+x ctrl+k`、`ctrl+x ctrl+e`、`ctrl+x enter`、`ctrl+x ctrl+a` 和 `ctrl+x tab`，`Task` 中的 `ctrl+x ctrl+b`，以及 `DiffPanel` 中的 `ctrl+x b`。`ctrl+x enter` 和弦需要 v2.1.247 或更高版本，`ctrl+x b`、`ctrl+x ctrl+a` 和 `ctrl+x tab` 需要 v2.1.260 或更高版本。要将 `ctrl+x` 本身回收为单键绑定，请取消绑定所有这些：546Claude Code 在 `ctrl+x` 前缀上绑定这些默认和弦：`Chat` 中的 `ctrl+x ctrl+k`、`ctrl+x ctrl+e`、`ctrl+x enter`、`ctrl+x ctrl+a`、`ctrl+x ctrl+s` 和 `ctrl+x tab`，`Task` 中的 `ctrl+x ctrl+b`，以及 `DiffPanel` 中的 `ctrl+x b`。`ctrl+x enter` 和弦需要 v2.1.247 或更高版本，`ctrl+x b`、`ctrl+x ctrl+a` 和 `ctrl+x tab` 需要 v2.1.260 或更高版本，以及 `ctrl+x ctrl+s` 需要 v2.1.275 或更高版本。

547 

548要将 `ctrl+x` 本身回收为单键绑定，请取消绑定所有这些：

546 549 

547```json theme={null}550```json theme={null}

548{551{

566 "ctrl+x ctrl+e": null,569 "ctrl+x ctrl+e": null,

567 "ctrl+x enter": null,570 "ctrl+x enter": null,

568 "ctrl+x ctrl+a": null,571 "ctrl+x ctrl+a": null,

572 "ctrl+x ctrl+s": null,

569 "ctrl+x tab": null,573 "ctrl+x tab": null,

570 "ctrl+x": "chat:newline"574 "ctrl+x": "chat:newline"

571 }575 }

467 467 

468这将 Opus 的推理能力与 Sonnet 的执行效率相结合。468这将 Opus 的推理能力与 Sonnet 的执行效率相结合。

469 469 

470计划模式 Opus 阶段使用与 `opus` 模型设置相同的上下文窗口。在 Opus [自动升级到 1M 上下文](#extended-context)的订阅层上，`opusplan` 在计划模式下也会获得升级。要在您不在自动升级层上时为两个阶段强制使用 1M 上下文，[设置模型](#setting-your-model)为 `opusplan[1m]`，例如使用 `/model opusplan[1m]`。使用 `/model` 设置它需要 Claude Code v2.1.265 或更高版本；在早期版本上，使用 `--model` 标志或 `model` 设置。470计划模式 Opus 阶段使用与 `opus` 模型设置相同的上下文窗口，执行阶段使用与 `sonnet` 相同的窗口。当 `opus` 和 `sonnet` 解析为默认运行[1M 上下文窗口](#extended-context)的模型时，如当前模型在 Anthropic API 上所做的那样，两个阶段都使用它运行。要在它们不这样做的地方为两个阶段请求 1M 上下文，[设置模型](#setting-your-model)为 `opusplan[1m]`，例如使用 `/model opusplan[1m]`。使用 `/model` 设置它需要 Claude Code v2.1.265 或更高版本；在早期版本上，使用 `--model` 标志或 `model` 设置。

471 471 

472当 [`availableModels`](#restrict-model-selection) 排除最新的 Opus 但允许较旧版本时，例如 `["sonnet", "claude-opus-4-6"]`，`opusplan` 使用最新的允许的 Opus 进行规划，仅当每个 Opus 都被排除时才保持在 Sonnet 上。在计划模式下通常会升级到 Sonnet 的 Haiku 会话同样使用最新的允许的 Sonnet，仅当每个 Sonnet 都被排除时才保持在 Haiku 上。在 v2.1.205 之前，当升级系列的最新版本被排除时，计划模式会保持在会话的模型上，即使允许列表允许较旧的版本。472当 [`availableModels`](#restrict-model-selection) 排除最新的 Opus 但允许较旧版本时，例如 `["sonnet", "claude-opus-4-6"]`，`opusplan` 使用最新的允许的 Opus 进行规划，仅当每个 Opus 都被排除时才保持在 Sonnet 上。在计划模式下通常会升级到 Sonnet 的 Haiku 会话同样使用最新的允许的 Sonnet，仅当每个 Sonnet 都被排除时才保持在 Haiku 上。在 v2.1.205 之前，当升级系列的最新版本被排除时，计划模式会保持在会话的模型上，即使允许列表允许较旧的版本。

473 473 

710 710 

711Fable 5.1、Fable 5、Sonnet 5、Opus 4.6 及更高版本和 Sonnet 4.6 支持[100 万令牌上下文窗口](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model)，用于具有大型代码库的长会话。711Fable 5.1、Fable 5、Sonnet 5、Opus 4.6 及更高版本和 Sonnet 4.6 支持[100 万令牌上下文窗口](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model)，用于具有大型代码库的长会话。

712 712 

713可用性因模型和计划而异。在 Anthropic API 上，Fable 5.1、Fable 5、Sonnet 5 和 Opus 4.7 及更高版本默认运行 1M 窗口。713在 Anthropic API 上，Fable 5.1、Fable 5、Sonnet 5 和 Opus 4.7 及更高版本在每个计划上运行 1M 窗口，包括 Pro。您不需要为这些模型上的 1M 窗口选择 `[1m]` 变体或打开使用额度。Fable 使用本身可以在某些计划上计费到使用额度；请参阅[Fable 和使用额度](#fable-and-usage-credits)。

714 714 

715在 Max、Team 和 Enterprise 计划上，包括 Team Standard 和 Team Premium 席位，Opus 自动升级到 1M 上下文，无需额外配置。Sonnet 4.6 与 1M 上下文不是自动升级的一部分，在包括 Max 的每个订阅计划上都需要[使用额度](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)。715Opus 4.6 和 Sonnet 4.6 仅通过其 `[1m]` 变体达到 1M，对该变体的访问取决于您的计划。在 Max、Team 和 Enterprise 计划上，包括 Team Standard 和 Team Premium 席位，Opus 4.6 与 1M 上下文包含在您的订阅中。Sonnet 4.6 与 1M 上下文在每个订阅计划上都需要[使用额度](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)，包括 Max。

716 716 

717| 计划 | Opus 与 1M 上下文 | Sonnet 4.6 与 1M 上下文 |717| 计划 | Opus 4.6 与 1M 上下文 | Sonnet 4.6 与 1M 上下文 |

718| --------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |718| --------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |

719| Max、Team 和 Enterprise | 包含在订阅中 | 需要[使用额度](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |719| Max、Team 和 Enterprise | 包含在订阅中 | 需要[使用额度](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |

720| Pro | 需要[使用额度](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) | 需要[使用额度](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |720| Pro | 需要[使用额度](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) | 需要[使用额度](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |

286 286 

287从 [Google Fonts](/docs/zh-CN/artifacts#improve-the-visual-design) 加载字体的 [Artifact](/docs/zh-CN/artifacts) 也会请求 `fonts.googleapis.com` 和 `fonts.gstatic.com`。两个主机都是可选的。如果您阻止它们，Artifact 会以备用字体呈现。使用快速拒绝而不是静默丢弃来阻止，以便字体请求立即失败，而不是延迟页面的首次呈现。287从 [Google Fonts](/docs/zh-CN/artifacts#improve-the-visual-design) 加载字体的 [Artifact](/docs/zh-CN/artifacts) 也会请求 `fonts.googleapis.com` 和 `fonts.gstatic.com`。两个主机都是可选的。如果您阻止它们，Artifact 会以备用字体呈现。使用快速拒绝而不是静默丢弃来阻止，以便字体请求立即失败，而不是延迟页面的首次呈现。

288 288 

289Artifact 还可以从 `cdnjs.cloudflare.com`、`cdn.jsdelivr.net`、`cdn.tailwindcss.com` 和 `code.jquery.com` 加载 JavaScript 库（如 React 或图表包），而不能从其他外部主机加载。如果您阻止这些主机，Artifact 中依赖库的部分将无法工作，与阻止的字体不同，阻止的库没有备用。也在这里使用快速拒绝，以便阻止的库请求立即失败，而不是挂起直到超时。289Artifact 还可以从 `cdnjs.cloudflare.com`、`cdn.jsdelivr.net`、`cdn.tailwindcss.com`、`code.jquery.com` 和 `unpkg.com` 加载 JavaScript 库（如 React 或图表包），而不能从其他外部主机加载。如果您阻止这些主机，Artifact 中依赖库的部分将无法工作，与阻止的字体不同，阻止的库没有备用。也在这里使用快速拒绝，以便阻止的库请求立即失败，而不是挂起直到超时。

290 290 

291<h2 id="additional-resources">291<h2 id="additional-resources">

292 其他资源292 其他资源

3168 3168 

3169选择 Claude Code 是否记录 Bash 命令在 Git 存储库中更改的文件。当它记录它们时，您会在命令后在终端中看到它们的差异，您的 [PostToolUse Bash hooks](/docs/zh-CN/hooks#bash) 会接收更改的文件列表。3169选择 Claude Code 是否记录 Bash 命令在 Git 存储库中更改的文件。当它记录它们时，您会在命令后在终端中看到它们的差异，您的 [PostToolUse Bash hooks](/docs/zh-CN/hooks#bash) 会接收更改的文件列表。

3170 3170 

3171列出的文件并不总是命令更改的文件。命令运行时另一个程序或另一个 Bash 调用所做的更改也可能出现在那里。

3172 

3171将键设置为 `true` 以在每个权限模式中记录它们。需要 Claude Code v2.1.269 或更高版本。3173将键设置为 `true` 以在每个权限模式中记录它们。需要 Claude Code v2.1.269 或更高版本。

3172 3174 

3173* **Scope**: [`User or managed`](#scopes)。`true` 仅从您的用户设置、使用 `--settings` 传递的 JSON 或[托管设置](/docs/zh-CN/managed-settings)计数，因此存储库的 `.claude/settings.json` 或 `.claude/settings.local.json` 中的 `true` 无法打开记录。存储库文件中的 `false` 仍会关闭它，除非[更高优先级](/docs/zh-CN/settings#settings-precedence)的文件设置 `true`。3175* **Scope**: [`User or managed`](#scopes)。`true` 仅从您的用户设置、使用 `--settings` 传递的 JSON 或[托管设置](/docs/zh-CN/managed-settings)计数，因此存储库的 `.claude/settings.json` 或 `.claude/settings.local.json` 中的 `true` 无法打开记录。存储库文件中的 `false` 仍会关闭它，除非[更高优先级](/docs/zh-CN/settings#settings-precedence)的文件设置 `true`。