发现一个小插件,解决了 Claude Code 远程预览最烦的一步

像我们公司平时会把 Claude Code 跑在服务器上。写代码没什么问题，麻烦往往出在最后一步。

比如让它做一个 HTML 页面，文件确实生成好了，但文件在服务器上，我自己的电脑没法直接打开。按我们原来的工作方式，想看效果通常要先把 HTML 和相关资源下载到本地，再用浏览器打开。改一次、下载一次，来回几轮以后，这个小步骤就变得特别烦。

最近在GitHub上发现了一个开源插件 agent-preview，刚好解决了这个问题。

安装以后，正常和 Claude Code 说「帮我做个页面」就行。插件、CLI 和公网通道正常可用时，页面完成并验证后，它会按任务上下文自动返回一条可以点击的临时预览地址。本地浏览器直接打开这条链接，就能看到服务器上的页面，不需要再手动下载文件，也不用自己拼 --public 之类的命令。

它背后的逻辑也不复杂。工具会先在服务器本机启动预览服务，再通过公网隧道生成一个临时地址。没有 Cloudflare 账号也能用，默认可以走基于 SSH 的 localhost.run 备用通道，前提是服务器有系统 SSH，并允许向公网发起连接。

Claude Code 的安装方式如下。

先安装 CLI。

curl -fsSL https://raw.githubusercontent.com/Zhangs-11/agent-preview/main/install.sh | sh 

再安装 Claude Code 插件。

claude plugin marketplace add Zhangs-11/agent-preview claude plugin install agent-preview@agent-preview 

装完以后不需要改变原来的使用习惯，继续正常提需求即可。

如果使用的是 Codex，也可以安装对应的 Skill。

npx skills add Zhangs-11/agent-preview --skill agent-preview 

除了 HTML 和静态网站，它还支持 PDF、PNG、JPEG、GIF、WebP、SVG 和 TXT 文件，以及 Agent 明确启动并监听 127.0.0.1 的本地 HTTP 服务。工具默认最多运行 24 小时，也可以自己调整这个上限；免费隧道、网络中断或服务器重启可能让链接提前失效。

需要注意的是，完整预览链接相当于一张临时通行证，拿到链接的人就能访问。因此，密钥、客户数据、生产后台和其他敏感内容不要拿来做公网预览。

它不是什么复杂系统，只是把「下载文件，再到本地打开」这一步去掉了。从流程上看，它能省掉不少重复下载和打开文件的操作。

项目地址：

💡

/ 作者：kakarot / 投稿、合作或交流，欢迎在公众号后台留言