老实说，

在使用 Claude Code 时使用者常常会遇到以下痛点：

• 不清楚何时会弹出权限请求。导致工作被打断，
• 多种对话框交叉出现，难以判断优先级。
• 缺少对话框的统一视觉风格和交互指引，容易产生误操作。
• 长时间离开后返回时程序未提示可能的费用或上下文丢失。

一、权限类对话框

. 工具权限确认

触发时机：工具需要使用者批准时。

UI 描述：

根据工具类型分发到不同的权限子组件：

• BashPermissionRequest — 显示待执行的 shell 命令、工作目录、以 $ 开头的命令预览。
• FileEditPermissionRequest — 显示文件方法、diff 变更内容。话说回来，
• WebFetchPermissionRequest — 显示目标 URL。

至于通用结构。

• 覆盖层，阻止主交互。
• 工具名称标签。
• 操作描述/预览区域。
• 底部 选项："Allow"、"Allow and don't ask again"、"Deny"。
• Esc 拒绝、Enter 确认。

组件：PermissionRequest.tsx → 分发到 BashPermissionRequest/FileEditPermissionRequest/…

. Sandbox 网络权限

触发时机：工具请求访问外部网络时。

┌──────────────────────────────────────────────────────────────────┐
│ Network request outside of sandbox │
│ │
│ Host: api.example.com │
│ │
│ Do you want to allow this connection?│
│ │
│ > Yes │
│ Yes,and don't ask again for api.example.com │
│ No。and tell Claude what to do differently │
└──────────────────────────────────────────────────────────────────┘

• 包裹在 中。
• 主机名以 dim 颜色显示。
• 说到选项，Allow / Allow + 记住 / Deny + 引导。

组件：SandboxPermissionRequest.tsx

. Worker Sandbox 权限

触发时机：Swar m worker 子代理请求网络访问，等待 leader 审批。

• sandbox-permission 结构相同，只是通过 mailbox 协议跨进程响应。选项通过 sendSandboxPermissionResponseViaMailbox{' '}发送回 worker。

. Worker 等待中指示器

触发时机：Ssub‑agent 正在等待 leader 批准权限时显示。说起来，

┌──────────────────────────────────────────────────────────────────┐
│ ⠋ Waiting for team lead approval │
│ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ │
│ Tool: WebFetchTool │
│ Action: Fetch https://api.example.com/data │
│ Permission request sent to team "my-team" leader │
└──────────────────────────────────────────────────────────────────┘

• Circular rounded border。
"WorkerBadge" 标记代理名称与颜色。

组件：

二、交互输入类对话框

. Hook Prompt 对话框

触发时机： Hook 返回需要使用者选择

code class =" hljs language - vbscript ">
... UI 示例 ...

…

... continue similarly ...

<... continue rows ...>

优先级	对话框	条件
🔴最高	message-selector	使用者主动打开
	sandbox-permission	网络权限请求
	tool-permission	工具权限请求
	prompt	Hook prompt交互
	worker-sandbox-permission	Worker 网络权限
	elicitation	MCP 表单输入
	cost	费用阈值提示