前提说明,本人文笔不是很好,以下内容有些 AI润色,望海涵。
先放个链接,如果你的 cloud code 版本比较新,你可以点着玩一下
一切的开始:发现一个奇怪的"壳"应用
最近更新 Claude Code 到 v2.1.133 后,我发现 我的 mac ~/Applications/ 目录下多了一个奇怪的应用:
Claude Code URL Handler.app
打开终端一看:
$ ls -la ~/Applications/Claude\ Code\ URL\ Handler.app/Contents/MacOS/
claude -> /Users/admin/.local/bin/claude
只是一个符号链接?为什么要专门搞一个 .app 包?
cc 告诉我
第一反应:这是什么"黑科技"?
我的安全意识意识到——这不是意味着任何网页或其他应用都能通过 URL 启动我的 Claude Code?
如果能通过这种方式,直接在我本地执行一些命令,那很要命了。
查阅官方文档后,发现这个功能叫 Deep Link:
claude-cli://open?q=<URL编码的提示词>
之后借助 AI 做了个安全评估:
不能执行任意命令
不能读取文件
只能预填充 Prompt,用户需要确认才会执行
那就是说风险可控,但那么这个小破玩意儿的用途是什么?
官方文档只说了一句话
在 Claude Code 官方文档的 Settings 页面,只有这一句描述:
Deep links allow external tools to open Claude Code sessions with pre-filled prompts via
claude-cli://open?q=...
就这么一句话。没有示例,没有教程,没有使用场景。
然后让 AI 再帮我深入调研了下:这个功能到底有什么用?
发现VS Code 插件也有类似功能
进一步查阅文档发现,VS Code 的 Claude Code 插件也有类似的 URL Handler:
vscode://anthropic.claude-code/open?prompt=review%20my%20changes
官方说明:
This handler can be used to open a new Claude Code tab from external tools like shell aliases, browser bookmarklets, or scripts.
关键词:external tools、browser bookmarklets
再搜一下看有没有什么用法。结果发现社区里几乎没人讨论
我搜索了:
- 中文社区(CSDN、博客园、知乎、掘金)
- 英文社区(GitHub、Reddit、Twitter)
- 技术论坛(Linux Do、V2EX)
结果:没发现讨论。
正当我好奇的时候,我突然联想到
这会不会是一个"一键分享"功能?
有没有可能分享是这个功能的真正用途?
我们都知道传统分享方式
1. 复制以下 Prompt(或者其他乱七八糟的)
2. 打开 Claude Code
3. 粘贴运行
帮我用 React 写一个带 TypeScript 类型的计数器组件,包含:
- 增加/减少按钮
- 重置功能
- 动画效果
如果使用这个Deep Link 的方式呢?
<a href="claude-cli://open?q=帮我用React写一个带TypeScript类型的计数器组件%0A-%20增加/减少按钮%0A-%20重置功能%0A-%20动画效果">
🚀 一键体验
</a>
访客点击链接 → 自动启动本地 Claude Code → 预填充 Prompt → 确认运行
好!不需要再手动打开了,直接一键就能够运行,马上看到 demo
类比其他工具
工具 URL Scheme 用途 VS Codevscode://file/...
一键打开代码文件
Figma
figma://...
一键打开设计稿
Notion
notion://...
一键打开笔记
Claude Code
claude-cli://open?q=...
就可以一键启动 AI 编程任务
那么也就是说,我们可以在网页当中甚至是传阅的 markdown 当中使用以下的方式来进行一键操作
跟 AI 一起头脑风暴想到的示例:
1. 技术博客
HTML 格式:
<p>想体验这个组件吗?</p>
<a href="claude-cli://open?q=帮我用React写一个计数器组件">
🚀 一键生成代码
</a>
Markdown 格式:
想体验这个组件吗?
[🚀 一键生成代码](claude-cli://open?q=帮我用React写一个计数器组件)
2. 开源项目 README
## 快速开始
[🚀 一键启动项目脚手架](claude-cli://open?q=在当前目录创建一个Next.js项目...)
## 贡献指南
[📋 一键生成贡献文档](claude-cli://open?q=根据当前项目结构生成CONTRIBUTING.md)
3. 在线课程
HTML 格式:
<a href="claude-cli://open?q=完成以下练习:%0A1. 创建一个Todo组件%0A2. 添加删除功能%0A3. 写单元测试">
📝 开始练习
</a>
Markdown 格式:
[📝 开始练习](claude-cli://open?q=完成以下练习:%0A1. 创建一个Todo组件%0A2. 添加删除功能%0A3. 写单元测试)
4. 团队知识库
HTML 格式:
<a href="claude-cli://open?q=解释这个项目的架构:%0A- 读取README.md%0A- 分析src目录结构%0A- 输出架构图">
🔍 一键分析项目
</a>
Markdown 格式:
[🔍 一键分析项目](claude-cli://open?q=解释这个项目的架构:%0A- 读取README.md%0A- 分析src目录结构%0A- 输出架构图)
5. Prompt 分享
HTML 格式:
<a href="claude-cli://open?q=你是代码审查专家。请审查当前文件的代码质量,关注:可读性、性能、安全性">
⚡ 一键代码审查
</a>
Markdown 格式:
[⚡ 一键代码审查](claude-cli://open?q=你是代码审查专家。请审查当前文件的代码质量,关注:可读性、性能、安全性)
[🔧 一键重构优化](claude-cli://open?q=重构当前代码,提升可读性和性能)
[📖 一键生成文档](claude-cli://open?q=为当前项目生成完整的README.md文档)
再分享一些基础的格式
基础格式
claude-cli://open?q=<URL编码的提示词>
多行 Prompt
使用 %0A 表示换行:
claude-cli://open?q=帮我完成以下任务:%0A1. 创建组件%0A2. 添加类型%0A3. 写测试
HTML 示例
<!-- 博客中的"一键体验"按钮 -->
<button onclick="window.location.href='claude-cli://open?q=帮我写一个Vue3响应式计数器'">
🚀 一键体验
</button>
<!-- Markdown 链接 -->
[一键生成 React 组件](claude-cli://open?q=帮我写一个React函数组件)
总结
这个功能目前给我的感觉是"养在深闺人未识",但我想它有巨大的潜力:
优势 说明 降低门槛 访客不需要手动输入 Prompt,以后在网页里面埋个链接,点一下的事 提高转化 从"看教程"到"动手体验"零距离 专业分享 比"复制粘贴"更优雅 社区价值 适合教程、课程、开源项目这是被社区忽略的好功能。
如果你是内容创作者、开源项目维护者、或者课程讲师,这个功能可以让你的读者/用户"一键体验"你分享的内容。
参考链接:
本文首发于我新加入 Linux Do,不设等级并只在这里发,欢迎各位佬友的讨论和补充。
4 个帖子 - 3 位参与者