Claude Code部署到Lizard平台实战指南

Claude Code 可以通过在开发环境中使用托管服务商提供的工具来部署应用。结合 Lizard（lizard.build），Agent 可以检查项目、使用 Lizard CLI 进行部署、配置依赖并检查线上服务。编码会话结束后，由主机负责运行应用。

真正有价值的结果是一个在真实 URL 上可用的用户流程，而不仅仅是命令成功退出。本文撰写时参考的 Lizard CLI 及关联文档版本截至 2026 年 9 月 9 日。

给 Agent 正确的上下文

从一个能够正常构建且具备生产环境启动命令的仓库开始。确认工作区和项目归属，是否需要数据库或 Worker，以及部署是创建测试副本还是更改现有服务。

安装 CLI 并查阅版本匹配的说明：

npm install -g @lizard-build/cli
lizard skills get core --json
lizard status --json

如需身份验证，使用 lizard login 并完成浏览器登录。关于可复用的 Agent 指令，参阅 Lizard Skill 仓库。Claude Code 自身概述文档描述了它如何与代码库和工具协同工作。

Agent 应在添加任何配置之前先检查现有配置。项目已有的运行时版本、Dockerfile 或启动命令，比根据框架名猜测出来的更有说服力。

定义部署任务的 Prompt

给 Agent 一个有边界的指令，例如：

将此仓库部署到现有 Lizard 项目 my-project 作为测试服务。先阅读当前 Lizard CLI 指南并检查构建和启动命令。如果仓库有可访问的 GitHub remote，则使用 GitHub 作为源码来源。按应用实际需要配置服务。验证线上 URL、日志和一个真实的业务流程。报告部署的版本以及任何未通过的检查项。

将项目和环境替换为实际目标。明确说明生产服务或域名何时应该变更。Agent 不应因为收到发布测试副本的请求就自行推断需要执行生产数据库迁移。

选择 Git 部署还是源码上传

当希望后续提交能触发部署时，使用仓库的 GitHub 集成。GitHub 部署指南涵盖了连接和服务设置。对于 monorepo，请检查追踪的分支和根目录。

对于没有合适 GitHub remote 的本地项目，可以使用源码上传。选择正确的工作区后，新的示例项目和服务的初始化方式：

lizard init --name my-project
lizard add --service api
lizard up --service api

以上名称仅为示例。对于已有项目，用 lizard status --json 确认当前关联并选择已有服务。不要为了避免读取配置而另建项目或将 Git 关联的服务切换为上传模式。

Lizard 执行托管构建。根据项目和服务的配置，它可以使用仓库中的 Dockerfile 或通过支持的构建路径生成一个。请阅读部署文档并保持配置引用可重复。

审慎地连接数据库

创建 Managed Postgres 并不代表应用能连接到它。应用必须能读取你所设置的连接变量。对于名为 api 的服务及其首个名为 postgres 的 PostgreSQL 插件，引用方式为：

lizard add postgres
lizard secrets set 'DATABASE_URL=${{postgres.DATABASE_URL}}' --service api

如果插件名不同，请使用实际名称。为每个消费服务配置所需变量，包括 Worker。将迁移作为受控的发布步骤执行，并确认应用能对目标数据库执行读写操作。详见变量引用和 Managed Postgres。

对于上传，选择与应用生命周期需求相匹配的存储。对于 Worker，验证它能连接到 broker 并处理重启。不要将资源创建成功等同于应用配置完成。

从外部检查结果

使用结构化输出进行诊断：

lizard status --json
lizard logs --service api --json
lizard logs --service api --build --json
lizard metrics --service api --json

然后请求线上 URL 并执行一个真实的业务流程。对于小型 API，可能是认证后写入再读取。对于前端，检查直接通过 URL 访问的路由以及通过客户端导航访问的路由。

如果部署失败，依据报告的错误选择下一步检查项。

Agent 应报告未解决的实际错误，而非仅凭构建日志就宣告成功。Python 托管指南提供了启动命令问题的示例。

理解工作流的成本

你的编码订阅和托管账单为不同的工作部分付费。Lizard 采用按量付费，无月度订阅。定价页列出了资源费率和支付条款。测试服务、数据库或沙箱在编码会话结束后仍可能持续消耗资源。

设置资源限制并审查使用量。当临时资源不再需要时，通过正常审批流程将其停止或删除。不要以为关闭 Claude Code 就会停止已经部署的应用。

Claude Code 会托管应用吗？ 托管由部署目标负责。Claude Code 使用工具来准备和部署代码；托管服务商运行最终的应用。

我可以部署已有的 GitHub 仓库吗？ 可以，前提是 Lizard 能访问它。通过 Git 部署工作流配置仓库、分支和服务，然后验证部署的版本。

数据库会自动连接吗？ 需要依次执行：配置数据库、配置应用读取的变量、测试连接。这些是独立的检查项。

相同工作流能用于其他编码 Agent 吗？ 能使用所需工具的 Agent 可以遵循相同的部署检查。请阅读其自身的权限和工具配置，不要假设所有环境都与 Claude Code 行为一致。

如何确认部署已完成？ 确认线上 URL、预期版本、健康的进程和有意义的业务行为。仅构建成功是不够的。

原文首发于 Lizard（lizard.build）。