Documentation 2026-07-01 21:01 UTC to 2026-07-02 23:59 UTC

89| :------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------ |89| :------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------ |

90| 托管策略设置 | 端点管理的策略（无论是 MDM plist、注册表策略还是托管设置文件）从主机加载；[服务器管理的设置](/zh-CN/server-managed-settings)在会话使用组织 OAuth 登录或直接配置的 API 密钥进行身份验证时获取，在[符合条件的配置](/zh-CN/server-managed-settings#platform-availability)上 | 端点策略：从主机中删除托管设置文件、plist 或注册表策略。服务器管理的设置：由您的组织管理员控制；无法从 SDK 禁用 |90| 托管策略设置 | 端点管理的策略（无论是 MDM plist、注册表策略还是托管设置文件）从主机加载；[服务器管理的设置](/zh-CN/server-managed-settings)在会话使用组织 OAuth 登录或直接配置的 API 密钥进行身份验证时获取，在[符合条件的配置](/zh-CN/server-managed-settings#platform-availability)上 | 端点策略：从主机中删除托管设置文件、plist 或注册表策略。服务器管理的设置：由您的组织管理员控制；无法从 SDK 禁用 |

91| `~/.claude.json` 全局配置 | 始终读取 | 使用 `env` 中的 `CLAUDE_CONFIG_DIR` 重新定位 |91| `~/.claude.json` 全局配置 | 始终读取 | 使用 `env` 中的 `CLAUDE_CONFIG_DIR` 重新定位 |

92| `~/.claude/projects/<project>/memory/` 处的自动内存 | 默认加载到系统提示中 | 在设置中设置 `autoMemoryEnabled: false`，或在 `env` 中设置 `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` |92| `~/.claude/projects/<project>/memory/` 处的自动内存 | 在会话启动时加载到系统提示中。代理使用标准 `Write` 和 `Edit` 工具而不是专用内存工具在那里写入新内存，因此必须启用这些工具才能让代理保存内存 | 在设置中设置 `autoMemoryEnabled: false`，或在 `env` 中设置 `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` |

93| [claude.ai MCP 连接器](/zh-CN/mcp#use-mcp-servers-from-claude-ai) | 当活跃身份验证方法是 claude.ai 订阅时加载。传递 `mcpServers: {}` 不会抑制它们 | 设置 `strictMcpConfig: true`、[`disableClaudeAiConnectors: true`](/zh-CN/mcp#disable-claude-ai-connectors) 在设置中，或在 `env` 中设置 `ENABLE_CLAUDEAI_MCP_SERVERS=false` |93| [claude.ai MCP 连接器](/zh-CN/mcp#use-mcp-servers-from-claude-ai) | 当活跃身份验证方法是 claude.ai 订阅时加载。传递 `mcpServers: {}` 不会抑制它们 | 设置 `strictMcpConfig: true`、[`disableClaudeAiConnectors: true`](/zh-CN/mcp#disable-claude-ai-connectors) 在设置中，或在 `env` 中设置 `ENABLE_CLAUDEAI_MCP_SERVERS=false` |

94 94 

95<Warning>95<Warning>

50 50 

51 <Step title="启动并登录">51 <Step title="启动并登录">

52 从应用启动器启动 **Claude**，或从终端运行 `claude-desktop`，然后使用您的 Anthropic 账户登录。52 从应用启动器启动 **Claude**，或从终端运行 `claude-desktop`，然后使用您的 Anthropic 账户登录。

53 

54 Linux 应用的登录方式与 macOS 和 Windows 上相同：使用 claude.ai 订阅或通过您组织的 SSO。Desktop 不直接接受 Claude Console API 密钥；请使用 [CLI](/zh-CN/quickstart) 进行 API 密钥身份验证。对于路由 Desktop 到 Google Cloud 的 Agent Platform 或 LLM 网关的企业部署，请参阅 [企业配置指南](https://support.claude.com/en/articles/12622667-enterprise-configuration) 和 [网络配置](/zh-CN/network-config)。

53 </Step>55 </Step>

54</Steps>56</Steps>

55 57 

729 Model is restricted by your organization's settings729 Model is restricted by your organization's settings

730</h3>730</h3>

731 731 

732您的组织管理员已在 Claude 控制台中禁用此模型，或者它被托管设置中的 [`availableModels`](/zh-CN/model-config#restrict-model-selection) 允许列表排除。当使用 `--model`、`ANTHROPIC_MODEL` 或 `model` 设置设置受限制的模型时，Claude Code 会替换为允许的模型并继续。为受限制的模型键入 `/model <name>` 会被拒绝，显示 `Run /model to choose a different model.`，会话保持其当前模型。732{/* min-version: 2.1.187 */}您的组织管理员已在 Claude 控制台中禁用此模型，或者它被托管设置中的 [`availableModels`](/zh-CN/model-config#restrict-model-selection) 允许列表排除。当使用 `--model`、`ANTHROPIC_MODEL` 或 `model` 设置设置受限制的模型时，Claude Code 会替换为允许的模型并继续。为受限制的模型键入 `/model <name>` 会被拒绝，显示 `Run /model to choose a different model.`，会话保持其当前模型。

733 733 

734```text theme={null}734```text theme={null}

735Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.735Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.

50* [Remote Control](/zh-CN/remote-control)50* [Remote Control](/zh-CN/remote-control)

51* [Chrome 扩展](/zh-CN/chrome)51* [Chrome 扩展](/zh-CN/chrome)

52* [Computer use](/zh-CN/computer-use)：Pro 和 Max 计划52* [Computer use](/zh-CN/computer-use)：Pro 和 Max 计划

53* [Artifacts](/zh-CN/artifacts)：Team 和 Enterprise 计划53* [Artifacts](/zh-CN/artifacts)：Pro、Max、Team 和 Enterprise 计划

54* [Voice dictation](/zh-CN/voice-dictation)54* [Voice dictation](/zh-CN/voice-dictation)

55 55 

56Desktop 是部分例外：Enterprise 部署可以通过[托管设置](https://support.claude.com/en/articles/12622667-enterprise-configuration)将 Desktop 路由到 Vertex AI 或网关提供商，[Cowork on 3P 研究预览](https://claude.com/docs/cowork/3p/overview)在 Bedrock、Vertex AI、Foundry 或自托管 LLM 网关上运行 Code 选项卡。有关这些功能的按计划可用性，请参阅[按订阅计划的可用性](#availability-by-subscription-plan)。56Desktop 是部分例外：Enterprise 部署可以通过[托管设置](https://support.claude.com/en/articles/12622667-enterprise-configuration)将 Desktop 路由到 Vertex AI 或网关提供商，[Cowork on 3P 研究预览](https://claude.com/docs/cowork/3p/overview)在 Bedrock、Vertex AI、Foundry 或自托管 LLM 网关上运行 Code 选项卡。有关这些功能的按计划可用性，请参阅[按订阅计划的可用性](#availability-by-subscription-plan)。

286| [Computer use](/zh-CN/computer-use) | ✓ | ✓ | ✗ | ✗ |286| [Computer use](/zh-CN/computer-use) | ✓ | ✓ | ✗ | ✗ |

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| [Analytics dashboard、API 和贡献指标](/zh-CN/analytics) | ✗ | ✗ | ✓ | ✓ |

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

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

37| `Ctrl+R` | 反向搜索命令历史 | 交互式搜索以前的命令 |37| `Ctrl+R` | 反向搜索命令历史 | 交互式搜索以前的命令 |

38| `Ctrl+V` 或 `Cmd+V`（iTerm2）或 `Alt+V`（Windows 和 WSL） | 从剪贴板粘贴图像 | 在光标处插入 `[Image #N]` 芯片，以便您可以在提示中按位置引用它。在 WSL 上，`Ctrl+V` 和 `Alt+V` 都被绑定；如果您的终端拦截 `Ctrl+V`，请使用 `Alt+V` |38| `Ctrl+V` 或 `Cmd+V`（iTerm2）或 `Alt+V`（Windows 和 WSL） | 从剪贴板粘贴图像 | 在光标处插入 `[Image #N]` 芯片，以便您可以在提示中按位置引用它。在 WSL 上，`Ctrl+V` 和 `Alt+V` 都被绑定；如果您的终端拦截 `Ctrl+V`，请使用 `Alt+V` |

39| `Ctrl+B` | 后台运行任务 | 后台运行 Bash 命令和代理。Tmux 用户按两次 |39| `Ctrl+B` | 后台运行任务 | 后台运行 Bash 命令和代理。Tmux 用户按两次 |

40| `Ctrl+T` | 切换任务列表 | 在终端状态区域中显示或隐藏[任务列表](#task-list) |40| `Ctrl+T` | 切换 Claude 的任务清单 | 在状态区域中显示或隐藏 [Claude 的待办事项清单](#task-list)。这不是后台任务视图；使用 [`/tasks`](/zh-CN/commands) 查看运行的 shell 和子代理 |

41| `Left/Right arrows` | 在对话框选项卡之间循环 | 在权限对话框和菜单中的选项卡之间导航 |41| `Left/Right arrows` | 在对话框选项卡之间循环 | 在权限对话框和菜单中的选项卡之间导航 |

42| `Up/Down arrows` 或 `Ctrl+P`/`Ctrl+N` | 移动光标或导航命令历史 | 当输入跨越多个可视行时，无论是换行还是多行，首先在提示内移动光标。一旦光标在第一行或最后一行，再次按下会导航命令历史。{/* min-version: 2.1.169 */}从 v2.1.169 开始，换行的单行输入的行为与多行输入相同 |42| `Up/Down arrows` 或 `Ctrl+P`/`Ctrl+N` | 移动光标或导航命令历史 | 当输入跨越多个可视行时，无论是换行还是多行，首先在提示内移动光标。一旦光标在第一行或最后一行，再次按下会导航命令历史。{/* min-version: 2.1.169 */}从 v2.1.169 开始，换行的单行输入的行为与多行输入相同 |

43| `Esc` | 中断 Claude | 停止当前响应或工具调用中途，以便您可以重定向。Claude 保留迄今为止完成的工作 |43| `Esc` | 中断 Claude | 停止当前响应或工具调用中途，以便您可以重定向。Claude 保留迄今为止完成的工作 |

389 任务列表389 任务列表

390</h2>390</h2>

391 391 

392在处理复杂的多步骤工作时，Claude 会创建任务列表来跟踪进度。任务出现在终端的状态区域中，指示器显示待处理、进行中或完成的内容。392任务列表是 Claude 的待办事项清单：Claude 创建的用于规划多步骤工作的项目，带有指示器显示待处理、进行中或完成的内容。它与后台任务视图分开。要查看运行中的 shell 和子代理，请改用 [`/tasks`](/zh-CN/commands)。

393 393 

394* 按 `Ctrl+T` 切换任务列表视图。显示一次最多 5 个任务394* 按 `Ctrl+T` 切换任务列表视图。显示一次最多五个任务。当 Claude 还没有创建任何清单项目时，切换没有可见效果，因为没有任何内容可显示

395* 要查看所有任务或清除它们，直接询问 Claude："show me all tasks"或"clear all tasks"395* 要查看所有任务或清除它们，直接询问 Claude："show me all tasks"或"clear all tasks"

396* 任务在上下文压缩中持续存在，帮助 Claude 在较大的项目上保持组织396* 任务在上下文压缩中持续存在，帮助 Claude 在较大的项目上保持组织

397* 要在会话之间共享任务列表，请设置 `CLAUDE_CODE_TASK_LIST_ID` 以使用 `~/.claude/tasks/` 中的命名目录：`CLAUDE_CODE_TASK_LIST_ID=my-project claude`397* 要在会话之间共享任务列表，请设置 `CLAUDE_CODE_TASK_LIST_ID` 以使用 `~/.claude/tasks/` 中的命名目录：`CLAUDE_CODE_TASK_LIST_ID=my-project claude`

86在 `Global` 上下文中可用的操作：86在 `Global` 上下文中可用的操作：

87 87 

88| 操作 | 默认 | 描述 |88| 操作 | 默认 | 描述 |

89| :--------------------- | :----- | :------------- |89| :--------------------- | :----- | :---------------------------------------------------------- |

90| `app:interrupt` | Ctrl+C | 取消当前操作 |90| `app:interrupt` | Ctrl+C | 取消当前操作 |

91| `app:exit` | Ctrl+D | 退出 Claude Code |91| `app:exit` | Ctrl+D | 退出 Claude Code |

92| `app:redraw` | （未绑定） | 强制终端重绘 |92| `app:redraw` | （未绑定） | 强制终端重绘 |

93| `app:toggleTodos` | Ctrl+T | 切换任务列表可见性 |93| `app:toggleTodos` | Ctrl+T | 切换 Claude 待办事项清单的可见性。这不是 [`/tasks`](/zh-CN/commands) 后台任务视图 |

94| `app:toggleTranscript` | Ctrl+O | 切换详细记录 |94| `app:toggleTranscript` | Ctrl+O | 切换详细记录 |

95 95 

96<h3 id="history-actions">96<h3 id="history-actions">

234 组织模型限制234 组织模型限制

235</h3>235</h3>

236 236 

237组织管理员通过在 Claude 控制台中禁用单个模型来限制成员可以运行的模型。当您的成员通过 Anthropic API 进行身份验证，并且您想要一个组织范围的开关而不部署设置文件时，使用此控制台切换而不是 `availableModels`。此限制与帐户的权利一起交付，当 Claude Code 进行身份验证时，与设置中的任何 `availableModels` 列表分开，服务器在创建会话时独立强制执行相同的限制。需要 Claude Code v2.1.187 或更高版本。237Claude Enterprise 计划上的组织管理员通过在 claude.ai 管理控制台中禁用单个模型来限制成员可以运行的模型。此限制与帐户的权利一起交付，当 Claude Code 进行身份验证时，与设置中的任何 `availableModels` 列表分开，服务器在创建会话时独立强制执行相同的限制。需要 Claude Code v2.1.187 或更高版本。

238 

239此限制在成员登录或使用自己的 API 密钥时适用。组织范围的凭证（如组织服务密钥）不与用户绑定，因此限制不适用于它们。

240 

241Claude 控制台没有模型限制控制。没有 Claude Enterprise 计划的组织（包括其成员通过 Anthropic API 进行身份验证的组织）改用[托管设置](/zh-CN/settings#settings-files)中的 [`availableModels`](#restrict-model-selection) 来限制模型，添加 [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) 来覆盖"默认"选项。这些设置由 Claude Code 本身强制执行，而不是由服务器强制执行。

238 242 

239受限制的模型在 `/model` 选择器中被隐藏。使用 `--model`、`ANTHROPIC_MODEL` 环境变量或 `model` 设置按名称选择它会显示通知 `Model "<name>" is restricted by your organization's settings. Using <model> instead.`，会话在允许的模型上启动。为受限制的模型键入 `/model <name>` 会被拒绝，显示 `Model '<name>' is restricted by your organization's settings. Run /model to choose a different model.`，会话保持其当前模型。243受限制的模型在 `/model` 选择器中被隐藏。使用 `--model`、`ANTHROPIC_MODEL` 环境变量或 `model` 设置按名称选择它会显示通知 `Model "<name>" is restricted by your organization's settings. Using <model> instead.`，会话在允许的模型上启动。为受限制的模型键入 `/model <name>` 会被拒绝，显示 `Model '<name>' is restricted by your organization's settings. Run /model to choose a different model.`，会话保持其当前模型。

240 244 

62 62 

63<Steps>63<Steps>

64 <Step title="创建插件目录">64 <Step title="创建插件目录">

65 每个插件都位于其自己的目录中，包含你的 skills、agents 或 hooks，可选地与 `.claude-plugin/plugin.json` 清单一起。现在创建一个：65 每个插件都位于其自己的目录中，包含你的 skills、agents 或 hooks，可选地与 `.claude-plugin/plugin.json` 清单一起。该位置对于本快速开始并不重要，因为你将在测试步骤中使用 `--plugin-dir` 指向 Claude Code 该目录。在任何方便的地方创建它，例如临时文件夹或项目目录：

66 66 

67 ```bash theme={null}67 ```bash theme={null}

68 mkdir my-first-plugin68 mkdir my-first-plugin

69 ```69 ```

70 

71 其余步骤从父目录运行，并引用相对于它的路径，如 `my-first-plugin/...`。

70 </Step>72 </Step>

71 73 

72 <Step title="创建插件清单">74 <Step title="创建插件清单">

438 440 

439<Steps>441<Steps>

440 <Step title="创建插件结构">442 <Step title="创建插件结构">

441 创建一个新的插件目录：443 在你的项目根目录中创建一个新的插件目录，与现有的 `.claude/` 文件夹并排放置，以便下一步中的相对 `cp` 路径能够解析：

442 444 

443 ```bash theme={null}445 ```bash theme={null}

444 mkdir -p my-plugin/.claude-plugin446 mkdir -p my-plugin/.claude-plugin

13| 工具 | 描述 | 需要权限 |13| 工具 | 描述 | 需要权限 |

14| :--------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--- |14| :--------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--- |

15| `Agent` | 生成一个具有自己 context window 的 [subagent](/zh-CN/sub-agents)，用于处理任务。请参阅 [Agent 工具行为](#agent-tool-behavior) | 否 |15| `Agent` | 生成一个具有自己 context window 的 [subagent](/zh-CN/sub-agents)，用于处理任务。请参阅 [Agent 工具行为](#agent-tool-behavior) | 否 |

16| `Artifact` | 将 HTML 或 Markdown 文件发布为 [artifact](/zh-CN/artifacts)：一个私有的、交互式的 claude.ai 页面，您可以在组织内共享。{/* plan-availability: feature=artifacts plans=team,enterprise providers=anthropic */}需要 Team 或 Enterprise 计划和 `/login` 身份验证；请参阅[可用性](/zh-CN/artifacts#availability) | 是 |16| `Artifact` | 将 HTML 或 Markdown 文件发布为 [artifact](/zh-CN/artifacts)：一个私有的、交互式的 claude.ai 页面。在 Team 和 Enterprise 计划上，您可以在组织内共享它。{/* plan-availability: feature=artifacts plans=pro,max,team,enterprise providers=anthropic */}需要 Pro、Max、Team 或 Enterprise 计划和 `/login` 身份验证；请参阅[可用性](/zh-CN/artifacts#availability) | 是 |

17| `AskUserQuestion` | 提出多选问题以收集需求或澄清歧义 | 否 |17| `AskUserQuestion` | 提出多选问题以收集需求或澄清歧义 | 否 |

18| `Bash` | 在您的环境中执行 shell 命令。请参阅 [Bash 工具行为](#bash-tool-behavior) | 是 |18| `Bash` | 在您的环境中执行 shell 命令。请参阅 [Bash 工具行为](#bash-tool-behavior) | 是 |

19| `CronCreate` | 在当前会话中安排定期或一次性提示。任务是会话范围的，在 `--resume` 或 `--continue` 时如果未过期则会恢复。请参阅[计划任务](/zh-CN/scheduled-tasks) | 否 |19| `CronCreate` | 在当前会话中安排定期或一次性提示。任务是会话范围的，在 `--resume` 或 `--continue` 时如果未过期则会恢复。请参阅[计划任务](/zh-CN/scheduled-tasks) | 否 |

212 212 

213Claude 将列表作为结构化数据传递，所以脚本可以直接在 `args` 上调用数组和对象方法，无需先解析它。如果省略 `args`，脚本内的全局变量为 `undefined`。213Claude 将列表作为结构化数据传递，所以脚本可以直接在 `args` 上调用数组和对象方法，无需先解析它。如果省略 `args`，脚本内的全局变量为 `undefined`。

214 214 

215<h2 id="example-workflow-prompts">

216 工作流提示示例

217</h2>

218 

219工作流最适合当任务大于一个代理可以在上下文中容纳的情况，或当相同的步骤需要在许多项目中运行时。下面的提示显示常见的形状。每一个都要求 Claude 为该任务编写并运行工作流；您不自己编写脚本。

220 

221<h3 id="audit-many-files-for-the-same-issue">

222 审计许多文件以查找相同问题

223</h3>

224 

225扇出每个文件一个代理，然后收集并验证发现。

226 

227```text theme={null}

228> use a workflow to audit every route handler under src/routes/ for missing authentication checks, and adversarially verify each finding before reporting it

229```

230 

231<h3 id="keep-fixing-until-a-check-passes">

232 保持修复直到检查通过

233</h3>

234 

235运行检查器，修复失败的内容，然后重复直到通过或停止取得进展。

236 

237```text theme={null}

238> use a workflow to run npx tsc --noEmit and keep fixing the reported errors until the type check passes or two rounds in a row make no progress

239```

240 

241<h3 id="migrate-many-files-in-parallel">

242 并行迁移许多文件

243</h3>

244 

245发现要迁移的文件，在隔离的副本中转换每个文件，以便编辑不会冲突，并验证每个结果。

246 

247```text theme={null}

248> use a workflow to migrate every component under src/components/ from styled-components to Tailwind, working on each file in its own isolated copy

249```

250 

251<h3 id="review-every-changed-file-and-write-one-summary">

252 审查每个更改的文件并写一份摘要

253</h3>

254 

255为每个文件运行审查者，然后将所有发现交给一个代理，该代理对它们进行排名和去重。

256 

257```text theme={null}

258> use a workflow to review every file changed in this PR for correctness issues, then merge the per-file findings into one ranked summary

259```

260 

261<h3 id="research-a-topic-across-many-sources">

262 跨许多来源研究一个主题

263</h3>

264 

265在更改日志、问题和文档中扇出读者，然后综合。捆绑的 `/deep-research` 工作流执行此操作；您也可以描述一个更狭窄的版本。

266 

267```text theme={null}

268> use a workflow to research how our three competitors handle rate limiting: read their public docs and recent changelog entries in parallel, then compare the approaches

269```

270 

271<h3 id="find-issues-until-the-list-stops-growing">

272 查找问题直到列表停止增长

273</h3>

274 

275保持分轮搜索并在新轮次找不到任何新内容时停止。

276 

277```text theme={null}

278> use a workflow to find flaky tests in this repo: run the suite repeatedly, record which tests fail intermittently, and stop once two rounds in a row find nothing new

279```

280 

281<h3 id="what-the-saved-script-looks-like">

282 保存的脚本看起来像什么

283</h3>

284 

285当您[保存工作流](#save-the-workflow-for-reuse)时，`.claude/workflows/` 中的文件包含一个 `meta` 块，后跟编排子代理的脚本体。您通常不需要编辑它，但这是一个小的形状，所以您可以识别 Claude 生成的内容：

286 

287```javascript theme={null}

288export const meta = {

289 name: 'audit-routes',

290 description: 'Audit every route handler for missing auth checks',

291}

292 

293const found = await agent('List every .ts file under src/routes/.', {

294 schema: { type: 'object', required: ['files'], properties: { files: { type: 'array', items: { type: 'string' } } } },

295})

296 

297const audits = await pipeline(found.files, file =>

298 agent(`Audit ${file} for missing authentication checks.`, { label: file }),

299)

300 

301return audits.filter(Boolean)

302```

303 

304主体是带有顶级 `await` 的纯 JavaScript。`agent()` 生成一个子代理，`pipeline()` 为列表中的每个项目运行一个。如果您想手动编辑脚本，要求 Claude 引导您完成更改，或查看 [Agent SDK 参考](/zh-CN/agent-sdk/typescript)中的 Workflow 工具条目以获取完整的选项集。

305 

215<h2 id="how-a-workflow-runs">306<h2 id="how-a-workflow-runs">

216 工作流如何运行307 工作流如何运行

217</h2>308</h2>