如何从 Claude Code 部署应用

一次会话内从 Claude Code 部署应用：通过 MCP 或开源插件接入 Fine Structure，随后获得托管、数据库、登录认证与自有域名。

本指南适合谁

在 Claude Code 里工作、希望刚写好的项目真正上线的开发者，托管、数据和登录认证都有人替他们打理。

您将获得什么

- 一条可行的部署路径，一次会话内从 Claude Code 走到线上 URL

- 清楚知道平台替你托管了什么：页面、数据库、登录认证、域名

- 一个诚实的判断标准，知道什么时候静态托管更合适

从 Claude Code 部署到底意味着什么？

要从 Claude Code 部署应用，你需要把 Claude 接到一个能托管它的 runtime 上。在 Fine Structure 有两条路：在 claude.ai 的设置里把 https://finestructure.ai/api/mcp 添加为自定义连接器并通过 OAuth 授权，或者用 /plugin marketplace add finestructure-ai/claude-plugin 再执行 /plugin install finestructure@finestructure 安装开源插件。接下来 Claude 要么用 create_app 生成一个完整应用，要么把你已有的项目逐个文件迁移进平台 runtime，最终以托管的 React 页面运行，并配有托管数据库、登录认证、自定义域名和已保存版本回滚。免费额度不需要绑卡：生成会消耗积分，而编辑、发布和域名都是免费的。

Claude Code 非常擅长写出一个应用，却完全无法运行它。会话结束时，磁盘上留下的是一个文件夹：一堆 React 组件、一个在对话中逐渐成形的数据模型，还有一套默认服务器存在的登录流程。部署就是这个文件夹拿到 URL、拥有数据库、并且让别人也能登录进来的那一刻。

常见的答案是一整套管道工程：把代码推到仓库、接上 CI、在别处开一个数据库、加一个认证服务、指好 DNS、再等证书签发。每一步单独看都合理，加在一起就是一个下午。另一个答案是让 Claude Code 直接访问一个已经具备这些部件的 runtime，于是部署变成同一段对话里的一次工具调用。

• 一个负责提供 React 页面的地方，TLS 已经处理好
• 一个在第一条记录写入之前就已存在的数据库
• 真实用户能顺利通过的登录，会话在刷新页面后依然有效
• 属于你自己的域名，而不是中间夹着一串哈希的预览 URL
• 当新改动比旧版本更糟时，能退回去的路

把话说清楚: 我们的平台不是拧在你现有技术栈上的一个部署按钮。它是一个 runtime，应用会搬进去住。这是一笔实打实的交易：托管、数据库、登录认证和域名不用你自己拼装，代价是交出服务器层的控制权。

如何把 Claude 连接到 Fine Structure？

两条路，同一个终点：同一个账号、同一批应用。如果你的工作大多发生在 claude.ai，选连接器。如果你常驻终端，希望部署命令就在代码旁边，选插件。

路径一：MCP 连接器: 在 claude.ai 打开设置，选择 Add custom connector，把 https://finestructure.ai/api/mcp 粘贴为 URL，然后通过 OAuth 授权。一次点击，不用 API key，也不会有一个环境变量长期躺在配置文件里。之后 Claude 大约能看到 70 个工具：创建应用、写文件、entities、发布、域名和分析。

路径二：开源 Claude Code 插件: 执行 /plugin marketplace add finestructure-ai/claude-plugin，然后执行 /plugin install finestructure@finestructure。这会把 /deploy、/fs-status 和 /fs-domain 加进你的会话。源码是公开的，所以安装之前你可以自己读它到底发送了什么，而不是只信一段说明。

• 连接器：从浏览器开始的工作，用一句描述生成应用，不需要本地代码副本
• 插件：代码仓库已经在磁盘上，从跑测试的那个终端直接部署
• 两者指向同一个账号和同一批应用，所以来回切换没有任何成本

关于目录收录: 我们提交的目录收录申请仍在审核中。在审核结束之前，我们不会把连接器或插件称为官方、已验证或已收录。安装它们的理由是地址公开、源码可读，而不是名字旁边挂着一枚徽章。

让 Claude 生成新应用，还是迁移你已有的项目？

部署有两种模式。一种从一句话开始：create_app 接收一段描述，产出包含页面、entities 结构、认证接线和可用 URL 的完整应用。当想法还很粗糙、理解它最快的方式就是看到它时，这是快车道。生成会消耗积分，也是整个流程里唯一计量的环节。

第二种模式迁移你已经拥有的项目。Claude 读取你的文件，逐个把它们改写进平台 runtime：页面变成平台页面，数据模型变成 entities，认证调用变成平台认证。这是迁移，不是盲目上传。每一个假设存在自有服务器的文件，都会针对 runtime 重写一遍，而这正是 Claude Code 体现价值的地方。

• 数据现在放在哪里，哪些表会变成 entities
• 哪些页面原本在服务器端渲染，需要改写成 React 页面
• 哪些 API 调用打向你自己的后端，需要在平台上找到对应方案
• 第三方密钥，改为存进平台配置，而不是本地的 .env 文件

一次真实的首个会话是什么样: 先让 Claude 创建应用，打开预览，然后在同一段对话里继续改文件，直到页面真的接近你想要的样子。编辑文件和发布都不消耗积分，所以生成之后的打磨循环是免费的。看着对了就发布，接上域名，剩下的 TLS 让它自己完成。

这和部署到静态托管相比如何？

静态托管在自己的领域里非常出色。如果你的产物只是一个前端包，它们会比我们更快、更便宜地提供服务，生态也更大。只有当应用需要状态、需要用户、需要一条退路时，这个比较才变得有意思。

应用需要什么 | Fine Structure | 静态部署目标

托管 | 由平台 runtime 提供的托管 React 页面 | 最好的前端原始速度，最广的生态

数据库 | 托管的 entities，首次部署前就已就绪 | 自备数据库，另行开通接入

登录认证 | 内置，带会话和每个应用各自的用户 | 自备认证服务或第三方提供商

域名 | 自定义域名，自动签发 TLS | 自定义域名，自动签发 TLS，流程成熟

回滚 | 恢复应用的一个已保存版本 | 重新部署旧的构建，或回退 commit

智能体 | 按计划持续工作的 AI 智能体 | 不包含，需要另找地方运行

什么时候我们不是正确选择: 有三种情况别的工具更合适，我们会直说。必须归你所有的自定义服务器 runtime，例如一个 Go 二进制文件，或者依赖特定系统库的 Python worker。自带后端且你不打算重写的 monorepo。以及大规模的纯静态托管，那里不带数据库的 CDN 才是赢家。

首次部署之后你会得到什么？

部署不是工作的终点。它是应用开始产出事实而不是观点的地方。有四件事就此打开，而且没有一件需要离开当前这段对话。

• 自动 TLS 的自定义域名，让应用在你自己的名字下响应
• 已保存版本回滚，糟糕的改动只是一次恢复，而不是一整晚的调试
• 流量分析，让你知道到底有没有人来过
• 部署之后仍按计划工作的 AI 智能体，并且可以通过 WhatsApp 或邮件联系已验证的所有者

让人意外的部分是智能体。这里说的智能体不是贴在页面上的聊天挂件。它是挂在应用上的一个工人，你合上笔记本之后仍按计划运行，读取应用自己的数据，并且能通过 WhatsApp 或邮件联系它已验证的所有者。应用会主动告诉你发生了什么，而不是等你去查。

生成之后的一切都留在同一段 Claude 会话里：改一个文件、发布、检查域名、读分析数据、调整一个智能体。免费额度不要求绑卡，所以最实在的评估方式，就是让 Claude 去做一个真实的小应用，看它能走到哪一步。

常见问题

Claude Code 能自己部署应用吗？

单靠它不行。Claude Code 负责写文件和改文件，需要一个能托管它们的目标。添加我们的 MCP 连接器或安装插件之后，部署就变成一次工具调用：创建应用、写文件、发布、绑定域名。

Fine Structure 的 MCP 服务器地址是什么？

https://finestructure.ai/api/mcp。在 claude.ai 打开设置，选择 Add custom connector，粘贴这个地址并通过 OAuth 授权。没有 API key 要复制，之后 Claude 大约能看到 70 个工具。

怎么安装 Claude Code 部署插件？

执行 /plugin marketplace add finestructure-ai/claude-plugin，然后执行 /plugin install finestructure@finestructure。你会得到 /deploy、/fs-status 和 /fs-domain。插件是开源的，我们的目录收录申请仍在审核，因此不声称官方身份。

有免费额度吗，需要信用卡吗？

有免费额度，而且不要求绑卡。生成应用会消耗积分。编辑文件、发布和自定义域名不消耗。

我能部署已有的 React 项目，而不是生成新的吗？

可以。Claude 会逐个文件把它迁移进平台 runtime：页面变成平台页面，数据模型变成 entities，认证调用被重写。这是迁移不是上传，所以要预期文件会改变形态。

平台会处理 HTTPS 和自定义域名吗？

会。添加自定义域名后，TLS 会自动签发。可以在终端用 /fs-domain，也可以通过 MCP 连接器直接让 Claude 去做。

如果一次部署把应用弄坏了怎么办？

恢复一个已保存版本。回滚会把应用退回到较早的已保存状态，通常比在生产环境里诊断某个改动更快，也能给你一个可用的基线。

什么时候它不是合适的工具？

当你需要一个必须归自己所有的服务器 runtime 时，例如一个 Go 二进制文件，或者依赖特定系统库的 Python worker。当 monorepo 保留自己的后端时。或者当你想要大规模的纯静态托管时，那里不带数据库的 CDN 才是赢家。