Deep Links

claude-cli:// URL scheme 让任何应用都能通过链接触发本机打开 Claude Code 并预填指令

操作11 分钟

Deep link 是 claude-cli:// 自定义 URL scheme,点击后在本机打开 Claude Code 新终端窗口并预填 prompt。任何能渲染链接的地方都可以放置:事故 runbook、监控告警、README、CI 失败通知。

一、Deep Links 是什么

claude-cli:// 前缀是 Claude Code 向操作系统注册的自定义 URL scheme,类似 mailto: 打开邮件客户端。点击后:

  1. 浏览器或应用将 URL 交给操作系统
  2. 操作系统识别 claude-cli:// 前缀,启动本机 Claude Code
  3. 新终端窗口打开,工作目录设为链接指定的位置,prompt 输入框预填链接中的文本
  4. 用户阅读 prompt、按需编辑,按 Enter 发送

链接可以托管在任何地方,但会话始终在点击者的本机打开。

二、URL 格式与参数

所有 deep link 以 claude-cli://open 开头,后接可选查询参数。最简形式(在 home 目录打开空 prompt):

三个参数控制会话启动行为:

参数说明
q预填到 prompt 输入框的文本。值须 URL 编码。用 %0A 表示换行。上限 5,000 字符
cwd工作目录的绝对路径。拒绝网络路径和 UNC 路径
repoGitHub owner/name slug。Claude Code 解析为本地已知的 clone 路径。无匹配时回退到 home 目录

cwdrepo 同时存在时,cwd 优先,repo 被忽略。

示例(指向 acme/payments 仓库,附带两行诊断 prompt):

cwdrepo 的选择

  • cwd — 所有点击者的项目路径相同时使用(标准化 devcontainer、VM 镜像)
  • repo — 链接被共享、每人 clone 位置不同时使用。Claude Code 解析为最近一次使用过的匹配路径

repo 的解析逻辑:

付费内容

继续阅读完整课程

购买后即可解锁全部 16 个功能模块、实战场景与深度配置。

¥199¥399
  • 30 分钟完成第一个真实任务
  • 实战场景 + 深度配置
  • 无需续费,持续更新