Claude Code からデプロイ: 実践的な Lizard ワークフロー

Claude Code は、開発環境でホスティングプロバイダーのツールを使ってアプリケーションをデプロイできます。 Lizard では、エージェントがプロジェクトを調査し、Lizard CLI を使ってデプロイし、依存関係を設定し、公開中のサービスを確認できます。コーディングセッションが終了した後は、ホストがアプリケーションを実行します。

有用な成果は、単に正常終了するコマンドではなく、ライブ URL で動作するユーザーフローです。このガイドは、2026年9月9日時点の Lizard CLI と関連ドキュメントを確認しています。

エージェントに適切なコンテキストを与える

ビルドでき、本番用の start コマンドがあるリポジトリから始めます。どのワークスペースとプロジェクトがそれを所有すべきか、データベースや worker が必要か、デプロイによってテスト用のコピーが作成されるのか既存サービスが変更されるのかを特定します。

CLI をインストールし、そのバージョンに一致する手順を読んでください:

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

認証が必要な場合は、lizard login を使用してブラウザでのサインインを完了してください。再利用可能なエージェント向け手順については、Lizard Skill リポジトリ に従ってください。Claude Code 自身の概要では、コードベースやツールとどのように連携するかが説明されています。

エージェントは、何かを追加する前に既存の設定を確認するべきです。プロジェクト内にすでにあるランタイムバージョン、Dockerfile、または start コマンドは、フレームワーク名から推測したコマンドよりも確かな根拠です。

デプロイ作業を定義するプロンプト

次のような範囲が明確な指示をエージェントに与えます:

このリポジトリを、既存の Lizard project my-project にテストサービスとしてデプロイしてください。最初に現在の Lizard CLI ガイドを読み、ビルドコマンドと start コマンドを調査してください。リポジトリにアクセス可能な GitHub remote がある場合は、GitHub ソースを使用してください。このアプリが実際に必要とするサービスを設定してください。ライブ URL、ログ、実際のアプリケーションフローを 1 つ検証してください。デプロイされた revision と、失敗したチェックがあれば報告してください。

プロジェクトと環境は、意図した対象に置き換えてください。本番サービスやドメインを変更すべき場合は、それを明示的に記載してください。テスト用コピーの公開依頼から、本番データベースの migration をエージェントが推測すべきではありません。

Git デプロイまたはソースアップロードを選ぶ

後続の commit でデプロイをトリガーしたい場合は、リポジトリの GitHub integration を使います。GitHub デプロイガイド では、接続とサービス設定を扱っています。モノレポの場合は、追跡対象の branch とルートディレクトリを確認してください。

適切な GitHub remote がないローカルプロジェクトでは、ソースアップロードが利用できます。適切なワークスペースを選択したあと、新しい example project と service では次を使えます:

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

これらの名前は例です。既存のプロジェクトでは、lizard status --json で現在のリンクを確認し、既存のサービスを選択してください。設定を読むのを避けるためだけに、別のプロジェクトを作成したり、Git-backed service を upload に切り替えたりしないでください。

Lizard はホスト環境でビルドを実行します。プロジェクトとサービスの設定によっては、リポジトリの Dockerfile を使うことも、サポートされているビルド経路で生成することもできます。deployment docs を読み、設定は configuration reference で再現可能に保ってください。

意図的にデータベースを接続する

Managed Postgres を作成しただけでは、アプリケーションがそれに到達できる証明にはなりません。アプリケーションは、設定した接続変数を読み取る必要があります。api という名前の service と、その最初の PostgreSQL add-on である postgres を持つプロジェクトでは、参照は次のとおりです:

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

異なる場合は、実際の add-on 名を使用してください。worker を含む各 consumer service に対して、そのサービスが必要とする変数を設定してください。migration は管理されたリリース手順として実行し、意図したデータベースに対するアプリケーションの読み取りと書き込みを確認してください。variable references と 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 から直接到達したルートも確認してください。

デプロイに失敗した場合は、報告されたエラーを使って次の確認項目を選びます:

エージェントは、build log から成功を宣言するのではなく、未解決のエラーを報告するべきです。Pythonホスティング ガイド には、start-command の問題例があります。

ワークフローのコストを理解する

コーディングのサブスクリプション料金とホスティング料金は、作業の異なる部分に対して支払われます。Lizard は月額サブスクリプションなしの pay as you go を採用しています。pricing page には、リソース料金と支払い条件が記載されています。テストサービス、データベース、または sandbox は、コーディングセッション終了後も引き続きリソースを消費する場合があります。

リソース制限を設定し、使用状況を見直してください。一時的なリソースが不要になったら、通常の承認プロセスに従って停止または削除してください。Claude Code を閉じると、すでにデプロイされたアプリケーションも停止すると考えないでください。

FAQ

Claude Code がアプリをホストするのですか? デプロイ先がホストします。Claude Code はコードを準備してデプロイするためにツールを使い、生成されたアプリケーションはホスティングプロバイダーが実行します。

既存の GitHub リポジトリをデプロイできますか? はい、Lizard がそれにアクセスできる場合は可能です。Git デプロイのワークフローでリポジトリ、branch、service を設定し、その後デプロイされた revision を確認してください。

データベースは自動で接続されますか? データベースをプロビジョニングし、アプリケーションが読み取る変数を設定し、接続をテストしてください。これらは別々の確認項目です。

同じワークフローを別のコーディングエージェントでも使えますか? 必要なツールを使えるエージェントであれば、同じデプロイ確認に従えます。すべての環境が Claude Code と同じように振る舞うと想定せず、その環境自身の権限設定とツール設定を読んでください。

デプロイ完了をどう判断しますか? ライブ URL、期待する revision、正常なプロセス、有意義なアプリケーション動作を確認してください。build の成功だけでは不十分です。