> ## 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 link

> 既存のローカル Base44 プロジェクトをクラウド上の Base44 アプリにリンクします。`base44/config.jsonc` はあるが、まだ Base44 アプリに接続していない場合に使用します。

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

# base44 link

既存のローカル Base44 プロジェクトをクラウド上の Base44 アプリにリンクします。`base44/config.jsonc` はあるが、まだ Base44 アプリに接続していない場合に使用します。

## 重要: Link と Create の使い分け

| シナリオ                                       | コマンド                |
| ------------------------------------------ | ------------------- |
| 新規開始、`base44/` フォルダーなし                     | `npx base44 create` |
| `base44/config.jsonc` はあるが `.app.jsonc` なし | `npx base44 link`   |
| プロジェクトが既にリンク済み (`.app.jsonc` あり)           | 完了済み、`deploy` を使用   |

## 構文

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

## オプション

| オプション                             | 説明                                              | 必須             |
| --------------------------------- | ----------------------------------------------- | -------------- |
| `-c, --create`                    | 新規プロジェクトを作成 (選択プロンプトをスキップ)                      | いいえ            |
| `-n, --name <name>`               | プロジェクト名 (`--create` 使用時に必須)                     | `--create` と併用 |
| `-d, --description <description>` | プロジェクトの説明                                       | いいえ            |
| `--app-id <id>`                   | 既存プロジェクトにリンクするためのアプリ ID (グローバルフラグ、選択プロンプトをスキップ) | いいえ            |

## 非対話モード

CI/CD またはエージェント使用の場合:

**新規プロジェクトを作成:**

```bash theme={null}
npx base44 link --create --name my-app
```

**既存アプリにリンク:**

```bash theme={null}
npx base44 link --app-id <app-id>
```

誤: `npx base44 link --create` (--name が不足)
誤: `npx base44 link --create --app-id <id>` (両方は使用不可)
正: `npx base44 link --create --name my-app`
正: `npx base44 link --app-id <id>`

## 例

```bash theme={null}
# Interactive mode - prompts for project details
npx base44 link

# Non-interactive - create and link in one step
npx base44 link --create --name my-app

# With description
npx base44 link --create --name my-app --description "My awesome app"

# Link to a specific existing project by ID
npx base44 link --app-id abc123
```

## 動作

1. カレントディレクトリ (または親ディレクトリ) にある `base44/config.jsonc` を検索します
2. `.app.jsonc` が存在しないことを確認します (プロジェクトが未リンク)
3. 以下のいずれか:
   * クラウドに新規 Base44 アプリを作成 (`--create` を使用)、または
   * 既存アプリにリンク (`--app-id` または対話選択を使用)
4. アプリ ID を `base44/.app.jsonc` に書き込みます

## 要件

* プロジェクトに `base44/config.jsonc` が必要です
* `base44/.app.jsonc` は存在してはいけません (既にリンク済みの場合は `deploy` を使用)
* 認証済みである必要があります (先に `npx base44 login` を実行)

## 注意事項

* リンク後、`npx base44 deploy` でリソースをデプロイできます
* `.app.jsonc` ファイルは git-ignore する必要があります (アプリ ID が含まれます)

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