Deep link 是 claude-cli:// 自定义 URL scheme,点击后在本机打开 Claude Code 新终端窗口并预填 prompt。任何能渲染链接的地方都可以放置:事故 runbook、监控告警、README、CI 失败通知。
一、Deep Links 是什么
claude-cli:// 前缀是 Claude Code 向操作系统注册的自定义 URL scheme,类似 mailto: 打开邮件客户端。点击后:
- 浏览器或应用将 URL 交给操作系统
- 操作系统识别
claude-cli://前缀,启动本机 Claude Code - 新终端窗口打开,工作目录设为链接指定的位置,prompt 输入框预填链接中的文本
- 用户阅读 prompt、按需编辑,按 Enter 发送
链接可以托管在任何地方,但会话始终在点击者的本机打开。
二、URL 格式与参数
所有 deep link 以 claude-cli://open 开头,后接可选查询参数。最简形式(在 home 目录打开空 prompt):
三个参数控制会话启动行为:
cwd 和 repo 同时存在时,cwd 优先,repo 被忽略。
示例(指向 acme/payments 仓库,附带两行诊断 prompt):
cwd 与 repo 的选择
cwd— 所有点击者的项目路径相同时使用(标准化 devcontainer、VM 镜像)repo— 链接被共享、每人 clone 位置不同时使用。Claude Code 解析为最近一次使用过的匹配路径
repo 的解析逻辑: