Deep Links 让你把一个 Claude Code 会话入口放进 runbook、告警、dashboard 或团队文档里。点击链接后，本地终端打开 Claude Code，进入指定仓库，并把 Prompt 预填好。
什么是 Deep Link？
格式：
text
claude-cli://open它是 Claude Code 注册的自定义 URL scheme。可以带三个参数：
q：预填 Prompt，最多 5000 字符，需要 URL encodecwd：绝对工作目录repo：GitHub owner/name slug，Claude Code 会寻找本地 clone
示例：
text
claude-cli://open?repo=acme/payments&q=review%20open%20PRs安全机制：不会自动执行
Deep Link 不会直接执行命令，也不会自动发送 Prompt。
点击后：
- 系统打开 Claude Code
- 进入指定目录
- Prompt 填到输入框
- 你阅读、编辑
- 你按 Enter 后才发送
如果 Prompt 很长，界面会提醒你滚动检查完整内容。目录信任、权限规则、CLAUDE.md 都和普通会话一样生效。
repo vs cwd 怎么选？
cwd 适合标准化环境：统一 VM、统一 devcontainer、固定路径。
repo 适合团队共享链接。每个人 clone 路径不同，Claude Code 会根据本机记录找到最近使用过的匹配仓库。
规则：
- 你必须曾经在该 repo 中运行过 Claude Code
- 多个 clone/worktree 时，选择最近使用的路径
- 不会自动切换分支
- 如果找不到 clone，打开 home 目录
Runbook 示例
markdown
## web-gateway 5xx 升高
1. Acknowledge PagerDuty alert
2. Open Claude Code in gateway repo with a diagnostic prompt
3. Post findings in incident channel真实链接可以放在支持自定义 URL scheme 的内部 wiki、Notion、Confluence、Slack 或告警系统中。
注意：GitHub README/Issue/Wiki 通常会剥离 claude-cli:// 这类自定义 scheme，链接不会可点击。
告警和 CI 场景
适合把 Deep Link 放进：
- Datadog dashboard
- Grafana panel link
- PagerDuty runbook link
- Slack incident bot
- CI failure notification
- 内部研发平台任务页
比如 CI 失败通知可以带一个链接，点击后直接打开对应 repo，并预填“分析这个失败 job，检查最近提交和失败日志”的 Prompt。
Handler 注册位置
Claude Code 第一次启动交互会话时注册 handler。
| 平台 | 注册位置 |
|---|---|
| macOS | ~/Applications/Claude Code URL Handler.app |
| Linux | claude-code-url-handler.desktop |
| Windows | HKEY_CURRENT_USER\\Software\\Classes\\claude-cli |
最佳实践
- Prompt 不要超过必要长度
- 对 incident 链接写清服务、指标、时间窗口和期望输出
- 使用
repo而不是cwd分享给团队 - 不要在链接里包含密钥、token 或内部敏感数据
- 点击外部来源链接前先检查预填 Prompt
来源：Claude Code 官方文档 - Launch sessions from links | 整理：ClaudeEagle