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

# GitHub プロジェクトの持ち込み

> GitHub からご自身のプロジェクトを持ち込み、Base44 で開発を続けます。

GitHub のプロジェクトを Base44 に取り込み、開発を続けられます。チーム全員が実際の変更を反映でき、リポジトリが唯一の信頼できる情報源として残ります。

<CardGroup cols={2}>
  <Card title="どこからでも開発" icon="globe">
    デスクトップやモバイルからプロジェクトを操作できます。Base44 がクラウドで実行するので、インストールは不要です。
  </Card>

  <Card title="チームと一緒に" icon="users">
    ローカルでコードを実行しないチームメイトも、AI チャットでコードベースに変更を加えられます。
  </Card>

  <Card title="GitHub のワークフローを維持" icon="code-branch">
    各変更はリポジトリのブランチに保存され、作業が完了したらプルリクエストを開けます。
  </Card>

  <Card title="複数の AI モデル" icon="layer-group">
    別途サブスクリプションを管理することなく、Base44 で利用可能な任意の AI モデルを使えます。
  </Card>
</CardGroup>

***

## プロジェクトのインポート

接続済みの GitHub アカウントからリポジトリをインポートするか、リポジトリの URL を貼り付けます。Base44 が確認し、プロジェクトを作成し、コードをクローンし、設定を行い、プレビューを開始します。作業内容を保存するには、GitHub アカウントを接続してください。

<Frame caption="GitHub プロジェクトを Base44 に持ち込む">
  <img src="https://mintcdn.com/base44/OfiMCIK-cHLBT7ER/images/import-home.png?fit=max&auto=format&n=OfiMCIK-cHLBT7ER&q=85&s=efa34a4db3d71210f127fdf482e2f9a6" alt="The plus menu open on the Base44 home page, with Bring your own project under GitHub project" width="921" height="714" data-path="images/import-home.png" />
</Frame>

<Check>
  **開始前に:**

  * インポート先の Base44 ワークスペースで、オーナー、管理者、または編集者である必要があります。
  * プロジェクトは Base44 上で Web サービスとして実行されます。そのため、リポジトリは API 付きフロントエンドやサーバーレンダリングのサイトなど、Docker でソースからビルドして実行できる Web またはフルスタックアプリである必要があります。
  * プライベートリポジトリの場合は、Base44 GitHub App をインストールしてリポジトリにアクセスできるようにします。
  * ワークスペースは、Editors が承認済み GitHub 組織のリポジトリのみをインポートできるよう制限できます。承認済み組織にないリポジトリの場合は、ワークスペースのオーナーまたは管理者に **Settings** > **Governance** > **GitHub organizations** から追加してもらってください。ワークスペースのオーナーと管理者は、任意の GitHub 組織からインポートできます。
</Check>

### GitHub アカウントから

接続済みの GitHub アカウントのリポジトリから直接インポートします。プロジェクトを所有していない場合は、代わりに [リンクを貼り付け](#from-a-repository-url) てください。Base44 が所有するコピーを作成します。

**GitHub アカウントからインポートするには:**

1. [Base44 ホームページ](https://app.base44.com) で、プロンプトボックス内の **+** アイコンをクリックします。
2. **Bring your own project** をクリックします。
3. GitHub アカウントがまだ接続されていない場合は接続します。
4. インポートするリポジトリを選択します。
5. **Branch** ドロップダウンをクリックして開始ブランチを選択します。選択しない場合、Base44 はデフォルトブランチを使用します。
6. **Import** をクリックします。

<Frame caption="GitHub アカウントからプロジェクトをインポートする">
  <img src="https://mintcdn.com/base44/rjuHkGr4TVwiXdjq/images/importexistingrepo.png?fit=max&auto=format&n=rjuHkGr4TVwiXdjq&q=85&s=dfbde6a9e935a88dc7029089a9684968" alt="The Import an existing project dialog with a repository selected and the Branch drop-down set to main" width="734" height="724" data-path="images/importexistingrepo.png" />
</Frame>

### リポジトリ URL から

GitHub リポジトリの URL を貼り付けて、パブリックまたはプライベートリポジトリをインポートします。Base44 はアクセス権を確認し、直接インポートするか、まず GitHub アカウントにコピーを作成します。元のリポジトリがプライベートの場合、コピーもプライベートになります。

**リポジトリ URL からインポートするには:**

1. [Base44 ホームページ](https://app.base44.com) で、プロンプトボックス内の **+** アイコンをクリックします。
2. **Bring your own project** をクリックします。
3. **Paste a link** をクリックします。
4. GitHub リポジトリのリンクを貼り付けます。
5. アクセス権に応じて選択します:
   * **Branch:** リポジトリにプッシュできる場合は、開始ブランチを選択します。
   * **Your copy on GitHub:** リポジトリにプッシュできない場合は、Base44 が作成するコピーの名前を入力し、公開範囲を選択します:
     * **Fork (public):** 元のリポジトリにリンクされ、変更を元に送り返せます。
     * **Private copy:** 閲覧と編集ができるのは自分だけで、元のリポジトリとはリンクされません。
6. **Import** をクリックします。コピーを作成する場合は、**Fork and Import** または **Copy and Import** をクリックします。

<Frame caption="リポジトリ URL からプロジェクトをインポートする">
  <img src="https://mintcdn.com/base44/tO7P5YqCK4DKnUwH/images/pasterepolink.png?fit=max&auto=format&n=tO7P5YqCK4DKnUwH&q=85&s=d38b2ffd636ac618ed036042ddde19a9" alt="The Paste a link tab of the Import an existing project dialog, with a pasted repository URL, a name for the copy, and Fork (public) selected" width="737" height="625" data-path="images/pasterepolink.png" />
</Frame>

***

## プロジェクトでの作業

プロジェクトのインポートが完了したら、AI チャットで開発を続け、**Preview** で変更を確認します。**Dashboard** に切り替えると、**Code** でファイルを閲覧したり、**Secrets** でプロジェクトの実行に必要な値を管理できます。

<Frame caption="アプリエディタで実行中のインポート済みプロジェクト">
  <img src="https://mintcdn.com/base44/To3xQZ0gv9AwxKbi/images/imported-project.png?fit=max&auto=format&n=To3xQZ0gv9AwxKbi&q=85&s=341eecfff1b52eb60a614a671edf3691" alt="The app editor for an imported project with the Base44 AI chat and the running app in Preview on the right" width="1024" height="736" data-path="images/imported-project.png" />
</Frame>

### 作業内容の保存

Base44 は作業を随時保存します。インポート時に、`base44/setup-` の後に短い ID を付けたセットアップ用ブランチを作成し、そこでセットアップを実行します。以降は、AI チャットが変更を完了するたびに、作業中のブランチにコミットしてプッシュします。後から作成するブランチには、`dark-mode-toggle` のような短い説明的な名前が付きます。デフォルトブランチは決して触られません。

GitHub を接続せずにパブリックリポジトリをインポートした場合、アプリはローカルモードで実行されます。何もコミットもプッシュもされず、**Create PR** は無効化されます。**Code** で自分で行った編集は、次に AI チャットが変更を完了したときにコミットされます。

インポートされたプロジェクトはリポジトリの git ブランチを直接使用するため、git が信頼できる情報源として残ります。ブランチの動作は Base44 アプリと同じですが、いくつか違いがあります。Base44 内でデフォルトブランチからマージや更新を行うことはなく、すべてのブランチが 1 つのサンドボックスを共有し、Base44 でブランチを削除しても GitHub 上のブランチは残ります。[ブランチの操作](/Building-your-app/Working-with-branches) を参照してください。

### シークレットの追加

プロジェクトの実行に API キーやその他のシークレットが必要な場合、AI チャットが値を尋ねます。値を渡すと、Base44 が暗号化して保存し、プロジェクトが起動するたびに適用します。これはリビルド後も含まれます。リポジトリにはコミットされず、すべてのブランチで共有されるため、1 回だけ入力すれば済みます。

シークレットはアプリのダッシュボードで追加・管理することもできます。

**シークレットを追加するには:**

1. アプリのダッシュボードに移動します。
2. **Secrets** をクリックします。
3. **Add Secret** をクリックします。
4. **Secret Name** と **Secret Value** を入力し、**Add Secret** をクリックします。

<Tip>
  シークレットを一括で追加するには、**Import .env** をクリックし、ファイルをアップロードまたは貼り付けます。各 `KEY=VALUE` 行がシークレットになり、同名の既存シークレットは上書きされます。
</Tip>

***

## 作業の反映

すべての変更は `base44-builder[bot]` によってコミットされます。共有ブランチではチーム全体で 1 つのプルリクエストが作成され、別々のブランチではそれぞれ独自のプルリクエストが作成されます。編集者アクセス権を持つチームメイトは、プロジェクトとそのシークレットを共有します。

### プルリクエストを開く

プルリクエストは、作業ブランチから作成元のブランチに対して作成され、Base44 のクレジットとプロジェクトへのリンクが付きます。セットアップのプルリクエストは、常にインポートしたブランチに対して作成されます。

プルリクエストを開いた後も変更は同じブランチに保存され続けるため、レビュアーは常に最新の作業を確認でき、プッシュのたびにチェックが再実行されます。

**プルリクエストを開くには:**

1. エディタ上部の **Create PR** をクリックします。
2. **Title** と **Description (optional)** を入力します。
3. **Create PR** をクリックします。

<Tip>
  AI チャットにプルリクエストを依頼することもでき、タイトルと説明を下書きしてくれます。
</Tip>

<Note>
  権限をまだ付与していない場合は、**Review permissions on GitHub** をクリックし、アカウントオーナーに承認してもらいます。
</Note>

### レビューコメントへの返信

レビュアーからのフィードバックには、Base44 から離れることなく AI チャットで対応できます。

AI チャットにプルリクエストのレビューコメントを尋ねると、未解決のスレッドをファイルと行番号とともに一覧表示します。変更内容を伝えると、それぞれに対する変更と返信の下書きを作成します。特定の下書きを承認するまで、GitHub には何も投稿されません。スレッドの解決は別途依頼する必要があります。プルリクエスト自体へのコメントも依頼できます。

投稿はすべて `base44-builder[bot]` として表示されます。マージは従来どおり GitHub で行います。

***

## FAQ

<AccordionGroup>
  <Accordion title="Base44 は私のデフォルトブランチを変更しますか？">
    いいえ。Base44 は作業中のブランチにプッシュし、デフォルトブランチにプッシュすることはありません。プルリクエストを開くことが、変更がデフォルトブランチに反映される唯一の方法です。
  </Accordion>

  <Accordion title="Base44 を閉じて後で戻ってきたらどうなりますか？">
    作業を停止するとプロジェクトは一時停止し、戻ると中断した場所から再開します。リビルドが必要な場合、Base44 はリポジトリを再クローンし、最新のコミットから再起動します。
  </Accordion>

  <Accordion title="読み取り権限しかないリポジトリをインポートできますか？">
    はい。ワークスペースがインポートを承認済み GitHub 組織に制限していない限り可能です。読み取り権限しかない場合、Base44 は個人の GitHub アカウントにコピーを作成します。制限されたワークスペースでは、このコピーは承認済み組織ではなく個人アカウントに属するためブロックされます。代わりに、元のリポジトリへのプッシュアクセスを依頼してください。
  </Accordion>

  <Accordion title="なぜ Base44 は「リポジトリが承認済み GitHub 組織にありません」と表示するのですか？">
    このリポジトリの GitHub 組織からのインポートをワークスペースが許可していません。ワークスペースのオーナーまたは管理者に、**Settings** > **Governance** > **GitHub organizations** から組織を追加してもらい、再度お試しください。
  </Accordion>

  <Accordion title="私のリポジトリはモノレポです。インポートできますか？">
    リポジトリのルートにあるアプリが Web またはフルスタックアプリである場合はインポートできます。Base44 はルートを見てプロジェクトの種類を判断します。
  </Accordion>

  <Accordion title="モバイルまたはデスクトップのプロジェクトをインポートできますか？">
    いいえ。Base44 は Web およびフルスタックのプロジェクトのみを実行します。インポートするとすぐにメッセージが表示され、アカウントには何も作成されません。ルートに Web アプリがあるリポジトリは、サブフォルダにモバイルアプリが含まれていても動作します。
  </Accordion>

  <Accordion title="GitHub にエクスポートした Base44 アプリをインポートできますか？">
    いいえ。Base44 アプリのインポートはサポートされておらず、正しく動作しません。アプリはすでに Base44 で実行されており、[GitHub integration](/developers/app-code/local-development/github) がリポジトリと双方向で同期を保ちます。
  </Accordion>

  <Accordion title="インポートしたプロジェクトで Base44 のエンティティ、ログイン、または SDK を使えますか？">
    いいえ。インポートしたプロジェクトには、Base44 のページ、エンティティ、組み込みログイン、SDK はありません。独自のデータベース、認証、ルーティングを保持し、Base44 がそれらを置き換えることはありません。
  </Accordion>

  <Accordion title="データベース、認証、または CI/CD をプロジェクトに追加できますか？">
    はい。AI チャットに依頼すると、Base44 が他の変更と同じ方法でリポジトリにコードを書き込みます。Base44 のページ、エンティティ、ログインではなく、独自のスタックの上に構築するので、プロジェクトを独自のデータベースやサービスに向け、接続文字列や API キーをシークレットとして追加してください。追加したものはすべて、他の作業と同様にリポジトリを介して反映されます。
  </Accordion>

  <Accordion title="プレビューで要素をクリックして編集できますか？">
    いいえ。インポートされたプロジェクトでは、プレビューで要素を選択して編集することはできません。代わりに、AI チャットに変更内容を伝えてください。現在表示しているページを認識できます。
  </Accordion>

  <Accordion title="Base44 アプリを GitHub に接続するのとどう違うのですか？">
    [GitHub integration](/developers/app-code/local-development/github) は、Base44 で構築したアプリをリポジトリと同期します。インポートは逆方向で、すでに存在するリポジトリから始めます。Shopify や Lovable などの別プラットフォームからプロジェクトを移行するには、[プロジェクトを Base44 に移行する](/Getting-Started/migrating-an-existing-app) を参照してください。ローカルの Base44 バックエンドプロジェクトを CLI でリンクするには、[既存プロジェクトのリンク](/developers/backend/overview/link-existing-project) を参照してください。
  </Accordion>
</AccordionGroup>

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