Skip to main content
このページは AI コーディングエージェントスキルの一部で、人間ではなくエージェント向けに書かれています。人間向けの Base44 ドキュメントは デベロッパードキュメント を参照してください。

​
base44 scaffold

既存の Base44 アプリのローカルプロジェクトをスキャフォールドします。すでに Base44 アプリを持っている (アプリ ID を知っている) 場合に、それを操作するためのローカルプロジェクトファイルをセットアップするために使用します。完全に非対話的に実行されるため、エージェントや CI で安全に使用できます。
シナリオコマンド
新規開始、テンプレートから新しい Base44 アプリ + プロジェクトを作成したいnpx base44 create
すでに Base44 アプリを持っており (ID で)、そのローカルファイルが必要npx base44 scaffold
ローカルに base44/config.jsonc はあるが .app.jsonc なしnpx base44 link

​
構文

npx base44 scaffold [name] [options]
カレントディレクトリ にスキャフォールドします。

​
引数とオプション

引数/オプション説明必須
nameプロジェクト名 (位置引数)。デフォルトはカレントディレクトリ名。いいえ
--app-id <id>既存の Base44 アプリ ID。BASE44_APP_ID 環境変数にフォールバック。はい*
--no-skillsAI エージェントスキルのインストールをスキップ (デフォルトでインストールされます)いいえ
*アプリ ID は必須です: --app-id または BASE44_APP_ID 環境変数で提供してください。どちらも設定されていない場合、コマンドは失敗します。

​
例

# Scaffold the current directory for an existing app
npx base44 scaffold --app-id app_123

# Scaffold the current directory with an explicit project name
npx base44 scaffold my-app --app-id app_123

# Provide the app ID via environment variable instead of the flag
BASE44_APP_ID=app_123 npx base44 scaffold

# Scaffold without installing AI agent skills
npx base44 scaffold --app-id app_123 --no-skills

​
動作

  1. --app-id または BASE44_APP_ID 環境変数からアプリ ID を解決します
  2. backend-only テンプレートをカレントディレクトリに適用します
  3. プロジェクトファイルを既存のアプリに対して登録し、アプリ ID を含む base44/.app.jsonc を書き込みます
  4. AI エージェントスキルをインストールします (--no-skills が渡されない限り)

​
プロビジョニングハンドオフ (Stripe Projects / projects.dev)

scaffold は、Stripe Projects / projects.dev フローで Base44 アプリがプロビジョニングされた後に実行するコマンドです。create ではなく scaffold を使用してください — アプリは既に存在するため、create は重複を作成します。 Base44 がその方法でプロビジョニングされると、認証情報が BASE44_PROJECTS_ プレフィックスで環境に注入されます (例: BASE44_PROJECTS_BASE44_APP_ID、BASE44_PROJECTS_BASE44_ACCESS_TOKEN、BASE44_PROJECTS_BASE44_REFRESH_TOKEN)。CLI はこれらを使用するベアネーム (BASE44_APP_ID、BASE44_ACCESS_TOKEN、…) に自動的に正規化します。結果として:
  • アプリ ID は BASE44_APP_ID から自動的に解決されます — --app-id フラグは不要です。
  • 認証 は BASE44_ACCESS_TOKEN / BASE44_REFRESH_TOKEN からシードされます — 対話的な npx base44 login は不要です。
したがって、プロビジョニング後のステップ全体は以下だけです: 
npx base44 scaffold
プロジェクトファイルが必要なディレクトリから実行してください。スキャフォールディング後、npx base44 deploy でリソースをプッシュします。

​
注意事項

  • テンプレート: 常に backend-only テンプレートを使用します (Base44 構成のみ — フロントエンドは生成されません)。
  • 非対話: プロンプトを表示しません。エンティティをプッシュしたりサイトをデプロイしたりは しません。その後 npx base44 deploy を使用してリソースをプッシュしてください。
  • 既存アプリのみ: create とは異なり、新しい Base44 アプリを作成しません — 提供されたアプリ ID にローカルファイルをリンクします。
  • 認証: 認証済みである必要があります (先に npx base44 login を実行)。
  • .app.jsonc ファイルは git-ignore する必要があります (アプリ ID が含まれます)。
このページは AI を使用して翻訳されました。最も正確で最新の情報については、英語版 を参照してください。