> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# base44 scaffold

> 既存の Base44 アプリのローカルプロジェクトをスキャフォールドします。すでに Base44 アプリを持っている (アプリ ID を知っている) 場合に、それを操作するためのローカルプロジェクトファイルをセットアップするために使用します。完全に非対話的に実行されるため、エージェントや CI で安全に使用できます。

<Warning>
  このページは AI コーディングエージェントスキルの一部で、人間ではなくエージェント向けに書かれています。人間向けの Base44 ドキュメントは [デベロッパードキュメント](/developers) を参照してください。
</Warning>

# base44 scaffold

**既存の** Base44 アプリのローカルプロジェクトをスキャフォールドします。すでに Base44 アプリを持っている (アプリ ID を知っている) 場合に、それを操作するためのローカルプロジェクトファイルをセットアップするために使用します。完全に非対話的に実行されるため、エージェントや CI で安全に使用できます。

## 重要: Scaffold、Create、Link の使い分け

| シナリオ                                             | コマンド                  |
| ------------------------------------------------ | --------------------- |
| 新規開始、テンプレートから新しい Base44 アプリ + プロジェクトを作成したい       | `npx base44 create`   |
| すでに Base44 アプリを持っており (ID で)、そのローカルファイルが必要        | `npx base44 scaffold` |
| ローカルに `base44/config.jsonc` はあるが `.app.jsonc` なし | `npx base44 link`     |

## 構文

```bash theme={null}
npx base44 scaffold [name] [options]
```

**カレントディレクトリ** にスキャフォールドします。

## 引数とオプション

| 引数/オプション        | 説明                                              | 必須   |
| --------------- | ----------------------------------------------- | ---- |
| `name`          | プロジェクト名 (位置引数)。デフォルトはカレントディレクトリ名。               | いいえ  |
| `--app-id <id>` | 既存の Base44 アプリ ID。`BASE44_APP_ID` 環境変数にフォールバック。 | はい\* |
| `--no-skills`   | AI エージェントスキルのインストールをスキップ (デフォルトでインストールされます)     | いいえ  |

\*アプリ ID は必須です: `--app-id` または `BASE44_APP_ID` 環境変数で提供してください。どちらも設定されていない場合、コマンドは失敗します。

## 例

```bash theme={null}
# 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` は不要です。

したがって、プロビジョニング後のステップ全体は以下だけです:

```bash theme={null}
npx base44 scaffold
```

プロジェクトファイルが必要なディレクトリから実行してください。スキャフォールディング後、`npx base44 deploy` でリソースをプッシュします。

## 注意事項

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

<Note>このページは AI を使用して翻訳されました。最も正確で最新の情報については、[英語版](/) を参照してください。 </Note>