# シンクライアントを使用したリモート開発入門

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

SSH 接続を使用してリモートサーバーに接続し、プロジェクトを開発、実行、デプロイできます。

[JetBrains コードキャンバス](#code_canvas_integration)、 [Gitpod](#gitpod_integration)、 [Google Cloud](#google_cloud_integration) で実行されている開発環境に接続することもできます。

> **Note:**
> Currently, you cannot initiate remote development sessions from CLion, but you can do so through [JetBrains Gateway](#gateway).

> **Warning:**
> 開発を開始する前に、 [システム要件](prerequisites-for-dev-containers.html)が満たされていることを確認してください。

## 前提条件

リモートマシンで開発を開始する前に、次のものがあることを確認してください。

* リモートマシン（IDE のターゲット）は、 [IDE の記事](installation-guide.html#requirements-cl)にある推奨される最小要件を満たしています。 > **Note:** > JetBrains Client はシンクライアントの軽量アプリケーションであるため、ディスク容量とコンピューターリソースの要件はホストよりも低くなります。

* Linux プラットフォームに互換性のある SSH サーバーをインストールしました。 > **Note:** > サーバー部分は自己完結型であるため、特別な依存関係をインストールする必要はありません。 また、 `glibc` ベースの Docker イメージ（つまり Alpine ではない）でも実行されます。

* Linux プラットフォームには、Ubuntu 16.04+、RHEL/Centos 7+ などの最新の Linux AMD64 ディストリビューションがあります。 2 つ以上のコア、4 GB 以上の RAM、5 GB 以上のディスク容量を備えたマシンの使用をお勧めします。

* リモートホストで sftp サブシステムを有効にする必要があります。 現在の実装では、バックエンドデプロイに使用しています。

## JetBrains Gateway

JetBrains Gateway は、リモートサーバーをローカルマシンに接続し、バックエンドに必要なコンポーネントをダウンロードして、   JetBrains Client   でプロジェクトを開く軽量のランチャーです。

JetBrains Gateway の使い始め方については、短いビデオを参照してください。

[Video](https://www.youtube.com/v/TH8wrm449kM)

JetBrains Gateway は、スタンドアロンランチャーとして、または IDE からリモートサーバーに接続するためのエントリポイントとして使用できます。

次のいずれかの方法を使用して、スタンドアロン JetBrains Gateway を起動できます。

* Use CLion and the enabled リモート開発ゲートウェイ plugin in it. In this case, when you open the [CLion welcome screen](remote-development-starting-page.html), the Remote Development option will be available immediately and you can connect to your remote server using SSH.

Procedure: JetBrains Gateway を起動し、リモートサーバーに接続する

1. [JetBrains Gateway アプリ](https://www.jetbrains.com/ja-jp/remote-development/gateway/)をダウンロードしてインストールします。

または、IDE のようこそ画面から   リモート開発   オプションを使用して JetBrains Gateway にアクセスできます。

2. SSH   接続プロバイダーの   新規接続   をクリックします。

![SSH 経由で接続](https://resources.jetbrains.com/help/img/idea/2026.3/all_providers.png)

> **Note:**
> リンクで接続   をクリックして、以前に [生成](#use_local_ide)したリンクを入力して、Code With Me セッションまたはリモートサーバーに接続することもできます。

3. ウィザードの次のページで、リモートサーバーに接続するための SSH 構成を指定します。

![SSH 経由で接続](https://resources.jetbrains.com/help/img/idea/2026.3/cl_gateway_ssh_settings.png)

または、 ![SSH 構成](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg) をクリックして   SSH 構成   ダイアログを開き、SSH 設定を構成します。

SSH 構成   ダイアログで、次の情報を追加します。

![SSH 構成](https://resources.jetbrains.com/help/img/idea/2026.3/cl_gateway_ssh_configuration.png)

* ホスト : リモートサーバーのアドレスを指定します。

* ポート : SSH ポートを指定します。デフォルトは `22` です。

* ユーザー名 : リモートサーバーへの接続に使用されるユーザーの名前を指定します。

* 認証タイプ : 次の認証方法のいずれかを選択します。 * パスワード : パスワードを使用してホストにアクセスします。 CLion にパスワードを保存するには、 パスワードを保存 チェックボックスを選択します。 * キーペア (OpenSSH または PuTTY) : キーペアと一緒に [SSH 認証(英語)](https://www.ssh.com/)を使用します。 この認証方法を適用するには、クライアントマシンに秘密鍵があり、リモートサーバーに公開鍵が必要です。 CLion は、 [OpenSSH](https://www.openssh.com/) ユーティリティで生成した秘密鍵をサポートします。 秘密鍵 が保存されているファイルへのパスを指定し、パスフレーズ (存在する場合) を対応するフィールドに入力します。 CLion にパスフレーズを記憶させるには、 パスフレーズを保存 チェックボックスを選択します。 * 構成ファイル ~/.ssh/config の解析 : JetBrains Gateway で `.ssh/config` ファイルを使用する場合は、このオプションを選択します。

* 接続のテスト : このボタンをクリックして、接続が確立されているかどうかを確認します。

* 接続パラメーター : このセクションを使用して、接続の追加パラメーターを構成します。 詳細については、 [接続パラメーター](settings-tools-ssh-configurations.html#connection-parameters)を参照してください。

* HTTP/SOCKS プロキシ : このセクションを使用して、プロキシ設定を構成します。 詳細については、 [プロキシ設定](settings-http-proxy.html)を参照してください。

OK   をクリックして変更を保存し、   JetBrains Gateway へようこそ   ダイアログに戻ります。

接続を確認して続行   をクリックして、接続が確立されているかどうかを確認します。

4. On the next page, specify the CLion version to download to the remote server. JetBrains Gateway には、ダウンロード可能な IDE バージョンとすでにインストールされている IDE バージョンのリストが表示されます。

「その他のオプション」を使用して、 [IDE インストーラー](null)の代替ソースを設定することもできます。

ローカルマシンにダウンロードされた   JetBrains Client   のバージョンは、常にリモート IDE のバージョンと一致します。

![リモート IDE バージョン](https://resources.jetbrains.com/help/img/idea/2026.3/cl_gateway_dev_ide_version.png)

By default, the downloaded CLion is located in the following folder on the remote server:  `~/.cache/JetBrains/RemoteDev/dist` . However, you can change it and install CLion into a custom location with the following steps:

1.    その他のオプション   をクリックして、   インストールパスのカスタマイズ   オプションを選択します。

2.    インストールパス   フィールドに、インストールに必要な場所を追加します。

![カスタムの場所にインストール](https://resources.jetbrains.com/help/img/idea/2026.3/rd_install_to_custom_location.png)

リモートホスト上のプロジェクトへのパスを追加します。

![リモートプロジェクトへのパス](https://resources.jetbrains.com/help/img/idea/2026.3/cl_gateway_project_path.png)

IDE をアップロードして接続   をクリックします。

JetBrains Gateway   は IDE をダウンロードし、リモートプロジェクトを   JetBrains Client   で開きます。 接続は   JetBrains Gateway   ウィンドウに表示され、そこから他の IDE に接続したり、接続を無効にしたりできます。 このウィンドウは、デフォルトではトレイに対して非表示になっています。

プロジェクトを開く前に、バックエンドの  `-Xmx`  VM オプションをオーバーライドできます。

Procedure: -Xmx VM オプションを上書きする

1. JetBrains Gateway を [起動します](#launch_gateway)。

2. ウィザードの手順に従ってください。   接続を確認して続行   をクリックします。

3. 開いたページの「   IDE バージョン   」フィールドで、「   インストールオプション   」をクリックします。

4. ドロップダウンリストから、   ヒープサイズのカスタマイズ   を選択します。

![ヒープサイズのカスタマイズ](https://resources.jetbrains.com/help/img/idea/2026.3/customize_heap_size.png)

5. 最大ヒープサイズ   フィールドで、必要に応じてデフォルトのヒープサイズをオーバーライドします。

![最大ヒープサイズ](https://resources.jetbrains.com/help/img/idea/2026.3/max_heap_size.png)

このフィールドには数値のみを含めることができ、  `INT_MAX`  値を超えることはできないことに注意してください。

> **Note:**
> デフォルト値に戻す場合は、   インストールオプション   を再度クリックし、   デフォルトのヒープサイズを使用   を選択します。

6. 構成が完了したら、   IDE をダウンロードして接続   をクリックしてプロジェクトを開始します。

Procedure: 最近のプロジェクトを開く

1. JetBrains Gateway   ウィザードで、左側のオプションから   SSH   を選択します。

2. 検索フィールドにプロジェクトの名前を入力すると、すばやくそのプロジェクトに移動できます。

![最近のプロジェクト](https://resources.jetbrains.com/help/img/idea/2026.3/cl_remote_dev_recent_projects.png)

ターミナルにすばやくアクセスする必要がある場合は、 ![ターミナルを開く](https://resources.jetbrains.com/help/img/idea/2026.3/terminal.icons.OpenTerminal_13x13.svg) をクリックします。

Procedure: バックエンドのバージョンを変更する

* JetBrains Gateway   ウィザードで、最近のプロジェクトの名前の横にある ![the More button](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.more.svg) をクリックし、プロジェクトを開くために使用するバックエンドのバージョンを選択します。

![バックエンドのバージョンを変更する](https://resources.jetbrains.com/help/img/idea/2026.3/change_backend_version.png)

必要なバージョンがリストに見つからない場合は、   別の IDE を選択   をクリックし、   IDE バージョン   フィールドで目的の IDE バージョンを選択します。

![IDE のバージョンを選択](https://resources.jetbrains.com/help/img/idea/2026.3/select_ide_version.png)

Procedure: 実行中のインスタンスを停止する

1. JetBrains Gateway   ウィザードで、左側のオプションから   SSH   を選択します。

2. リモートセッションがアクティブな場合、プロジェクトの横に   実行   インジケーターが表示されます。

プロジェクトの横にある ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.moreHorizontal.svg) をクリックし、   IDE バックエンドの停止   を選択して、そのプロジェクトのリモートセッションを停止します。

![IDE バックエンドの停止](https://resources.jetbrains.com/help/img/idea/2026.3/stop_instance.png)

最近のプロジェクトから除去   を選択して、ページにリストされているプロジェクトを完全に削除することもできます。

Procedure: バックエンド IDE バージョンをアンインストールする

1. JetBrains Gateway   ウィザードで、リモートサーバーの名前に対して ![「オプションメニューを表示」アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg) をクリックし、   IDE バックエンドの管理   を選択して、インストールされている IDE バージョンのリストを開きます。

![IDE を管理する](https://resources.jetbrains.com/help/img/idea/2026.3/manage_ide.png)

2. 開いたウィンドウで、アンインストールする必要があるバックエンド IDE バージョンの横にある ![the Close icon](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.close.svg) をクリックし、   はい   をクリックしてアクションを確認します。

## 手動で起動したリモート IDE でリモートプロジェクトに接続する (サーバーからクライアントへのフロー)

If you already have CLion installed on your remote server, you can launch it manually and connect to the remote project started in that IDE. [JetBrains Gateway](#gateway) からの場合と同じように機能します。

会社にカスタムオーケストレーションがある場合、またはリモート IDE が自動的に起動する場合は、この方法を使用します。

プロセスは次のように説明できます:

Procedure:

1. リモート IDE でバックエンドプロジェクトを開始します。

2. バックエンドによって生成された接続リンクの 1 つを選択します。

3. ローカルマシンでリンクを開きます。

リモート IDE を実行するためのメインスクリプトは  `remote-dev-server.sh`  であり、解凍した IDE の  `bin`  サブディレクトリにあります。

> **Note:**
> バックエンドが JetBrains Gateway でインストールされた場合、デフォルトのパスは  `/home/your_system_user/.cache/JetBrains/RemoteDev/dist/`  です。

> **Note:**
> 詳細および使用可能なパラメーターについては、  `remote-dev-server.sh --help`  を実行してください。

> **Note:**
> 接続は特定のプロジェクトにバインドされていることに注意してください。 別のリモートプロジェクトに接続するには、新しい [接続](work-inside-remote-project.html#multiple_connections)を構成する必要があります。

Procedure: リモート IDE に接続する

1. [JetBrains Gateway をダウンロードしてインストールしている](#launch_gateway)か、ローカルマシンに   JetBrains Gateway   プラグインを備えた IDE があることを確認してください。

2. Ensure you have connected to the remote machine with CLion via SSH.

3. リモートサーバーのターミナルで、次のコマンドを実行します:

```
remote-dev-server.sh run /path_to_project/ --ssh-link-host host_server_address
--ssh-link-user remote_side_user
--ssh-link-port ssh_connection_port

```

次の例を確認してください：

```SHELL
~/ideaIU-213.3469/bin/remote-dev-server.sh
run ~/spring-boot-example/
--ssh-link-host ec2-11-50-136-85.eu-north-1.compute.amazonaws.com
--ssh-link-user ubuntu

```

パラメータを渡さない場合、スクリプトはデフォルト値を使用します：ポートには 22、システムユーザーのユーザー名、  `hostname`  コマンドからのホスト。

4. プロジェクトが正常に起動すると、出力としてターミナルに次の 3 個のリンクが表示されます:

* リンクに参加: tcp://127.0.0.1:5990...[ ] : リモート IDE が現在リッスンしているローカルアドレスとポートが含まれています。 例： ``` tcp://127.0.0.1:5991#jt=71e779a1-070e-4fd3-a4e6-83c1f8cb65a5&p=IU&fp=A42F6041C2878D7A22339ECABF4A9C294F643BG05E91E3DFC06035E03DB71BF8&cb=222.4167.29&jb=17.0.4b469.53 ``` これを使用するには、リモートマシンがこのローカルアドレスからアクセス可能であることを確認してください。 例: 転送 / オープンポートを備えた内部 DockerIDE の場合。 > **Tip:** > 詳細については、コマンドラインでの `ssh -L` コマンドの出力を参照してください。

* Http リンク: https://code-with-me.jetbrains.com/remoteDev...[ ] : host-port-user、IDE、そのバージョンに関する情報が含まれています。 例： ``` https://code-with-me.jetbrains.com/remoteDev#idePath=%2Fhome%2Fubuntu%2F.cache%2FJetBrains%2FRemoteDev%2Fdist%2F3e4cd27bfbb95_ideaIU-2022.2.2&projectPath=%2Fhome%2Fubuntu%2Fdevelopment%2Fspring-petclinic&host=ec2-xx-xx-xxx-xx.eu-north-1.compute.amazonaws.com&port=22&user=ubuntu&type=ssh&deploy=false ``` ローカルブラウザーで開くと、ようこそページが表示され、事前入力された接続設定値を使用してローカル Gateway アプリケーションの呼び出しが試行されます。 ローカルマシンに JetBrains Gateway アプリケーションが見つからない場合は、ようこそページからダウンロードできます。

* ゲートウェイリンク: jetbrains-gateway://connect#idePath... [ ] : host-port-user、IDE、そのバージョンに関する情報も含まれています。 例： ``` jetbrains-gateway://connect#idePath=%2Fhome%2Fubuntu%2F.cache%2FJetBrains%2FRemoteDev%2Fdist%2F3e4cd27bfbb95_ideaIU-2022.2.2&projectPath=%2Fhome%2Fubuntu%2Fdevelopment%2Fspring-petclinic&host=ec2-xx-xx-xxx-xx.eu-north-1.compute.amazonaws.com&port=22&user=ubuntu&type=ssh&deploy=false ``` ローカルブラウザーで開くと、ようこそページを表示せずにローカル JetBrains Gateway アプリケーションが直接起動します。

5. 生成されたリンクをコピーし、ローカルブラウザーに貼り付けて、   JetBrains Gateway を開く   を許可します。

6. これらのリンクはすべて、すでに起動している JetBrains Gateway でも開くことができます。

これを行うには、JetBrains Gateway のようこそ画面で   実行中の IDE に接続する   フィールドにリンクを貼り付け、   接続   をクリックします。

CLion は、必要なバージョンの JetBrains Client をダウンロードし、その中でリモートプロジェクトを開きます。

Procedure: 以前にインストールしたリモート IDE を登録する

バージョン   221.5481   以降では、既存のバックエンド IDE をリモートサーバーに手動で登録し、ゲートウェイに表示できるようになります。

インストールされている IDE を登録し、利用可能なビルドのリストに表示するには、次の手順に従います:

1. SSH 経由でリモートサーバーに接続します。

2. 解凍された IDE が含まれるフォルダーを見つけて、  `bin`  ディレクトリを開きます。

3. コマンドラインを使用して次のコマンドを実行します。

```
remote-dev-server.sh registerBackendLocationForGateway
```

例：

```
sh WebStorm-221.5591.52/bin/remote-dev-server.sh registerBackendLocationForGateway
```

## Google Cloud に接続する

JetBrains Gateway を使用して Google Cloud に接続し、リモートプロジェクトで作業できます。

Google Cloud に接続する前に、次のことを行っていることを確認してください:

* クラウドワークステーションの構成ファイルとクラスターをセットアップする (あなたまたは管理者によって行われた)

* ワークステーションを [作成しました](https://cloud.google.com/workstations/docs/create-workstation)

* ワークステーションにアクセスしました

The Cloud Workstations [plugin](https://plugins.jetbrains.com/plugin/19900-cloud-workstations) allows you to connect a workstation and work with it in CLion.

Procedure: Google Cloud のワークステーションに接続する

1. [JetBrains Gateway](#launch_gateway) を起動します。

2. 左側のオプションから   すべてのプロバイダー   を選択します。

3. 他のプロバイダーをインストール   セクションで、   Google Cloud   を見つけて   インストール   をクリックします。

![Google Cloud](https://resources.jetbrains.com/help/img/idea/2026.3/gateway_all_providers.png)

プラグインがインストールされたら、   IDE をリモートで実行   セクションで見つけることができます。

4. 左側のオプションから   クラウドワークステーション   を見つけて、   Google Cloud に接続する   をクリックします。

5. 開いたウィンドウで、使用するワークステーションを選択し、   次へ   をクリックします。

![クラウドワークステーションに接続](https://resources.jetbrains.com/help/img/idea/2026.3/connect_to_cloud_workstation.png)

> **Note:**
> Google Cloud ダッシュボードに切り替えて Cloud Workstation を管理する必要がある場合は、   Cloud コンソール   をクリックします。

6. 次のページで、構成ファイルのコードプロバイダーとして選択した IDE バージョンと、作業するプロジェクトを選択します。

![IDE バージョンとプロジェクト](https://resources.jetbrains.com/help/img/idea/2026.3/ide_backend_project.png)

接続が確立され、プロジェクトを含むワークステーションが JetBrains Client で開き、IDE 内でさらに作業できます。

##  Gitpod Classic または Ona に接続する 

Gitpod Gateway プラグインを使用すると、 [Gitpod Classic](https://ona.com/docs/classic/user/integrations/jetbrains-gateway) ワークスペースを作成したり、接続したりして、CLion で作業できます。

Ona 環境では、 [Toolbox App の Ona プラグイン](https://www.jetbrains.com/ja-jp/help/toolbox-app/manage-providers.html)を使用してください。

Procedure: Gitpod でワークスペースに接続する

1. [JetBrains Gateway](#launch_gateway) を起動します。

2. 左側のオプションから   リモート開発   を選択します。

3. 他のプロバイダーをインストール   セクションで、   Gitpod   を見つけて   インストール   をクリックします。

![Gitpod をインストールする](https://resources.jetbrains.com/help/img/idea/2026.3/gateway_all_providers.png)

プラグインがインストールされると、   他のプロバイダーをインストール   セクションだけでなく   リモート開発   ノードにもプラグインを見つけることができます。

4. 右側のオプションから   Gitpod   を見つけて、   Gitpod に接続する   をクリックします。

![ようこそ画面: Gitpod プラグインをインストール済み](https://resources.jetbrains.com/help/img/idea/2026.3/rd_welcome_screen_installed_gitpod.png). .

5. 開いたウィンドウで、使用する IDE を選択します。

> **Note:**
> Gitpod ダッシュボードに切り替える必要がある場合、Gitpod のドキュメントを読む必要がある場合、または Gitpod からログアウトする必要がある場合は、 ![歯車アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg) をクリックしてください。

6. 新しいワークスペース   をクリックします。

JetBrains Gateway は、ブラウザーで Gitpod ワークスペースに接続します。 Gitpod はワークスペースを準備し、JetBrains Client 内でワークスペースを開くことに関する通知を表示します。

![ブラウザーで JetBrains Gateway を開く](https://resources.jetbrains.com/help/img/idea/2026.3/browser_open_gateway_gitpod.png)

認証ダイアログで   許可   、   はい   の順にクリックします。

接続が確立され、プロジェクトを含むワークスペースが JetBrains Client で開き、IDE 内でさらに作業できます。

作成されたワークスペースは、   最近使ったワークスペース   セクションに追加されます。 既存のワークスペースがある場合は、最近のワークスペースのリストに追加され、必要なワークスペースに対して   接続   をクリックすることでいつでも接続できます。

Gitpod から JetBrains Gateway に直接接続する場合は、 [Gitpod のドキュメント(英語)](https://www.gitpod.io/changelog/jetbrains-desktop-available-in-beta)に従います。

## Coder に接続する

JetBrains Gateway を使用して [Coder(英語)](https://coder.com/docs/v2/latest) に接続し、リモートプロジェクトで作業できます。

Coder は、既存の環境に接続したり、新しい環境を作成して CLion で作業したりできるプラグインとして JetBrains Gateway で利用できます。

Procedure: Coder ワークスペースに接続する

1. [JetBrains Gateway](#launch_gateway) を起動します。

2. 画面下部の ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.build.task.svg) をクリックし、   プロバイダーの管理   を選択します。

3. 開いたページで   Coder   を見つけ、プラグインを [インストールして有効化](managing-plugins.html#install_plugin_from_repo)します。

プラグインが   接続   リストに追加されます。

4. 左側のオプションから   すべてのプロバイダー   を選択します。

![すべてのプロバイダー](https://resources.jetbrains.com/help/img/idea/2026.3/all_providers_coder.png)

5. [Coder](https://coder.com/docs/v2/latest/workspaces#create-workspaces) でワークスペースが構成されていることを確認し、アクセス URL をコピーします。

![Coder ワークスペース](https://resources.jetbrains.com/help/img/idea/2026.3/coder_workspace.png)

6. JetBrains Gateway で、「   Coder に接続する   」をクリックします。

7. ウィザードの次のページで、   URL   フィールドに [コピーした URL](#url) を貼り付け、   接続   をクリックします。

![Coder への接続](https://resources.jetbrains.com/help/img/idea/2026.3/connecting_to_coder.png)

8. ブラウザーからセッショントークンをコピーし、JetBrains Gateway の   セッショントークン   フィールドに貼り付けます。

![セッショントークン](https://resources.jetbrains.com/help/img/idea/2026.3/session_token.png)

OK   をクリックします。

9. すべてが認証されると、構成されたワークスペースのリストが表示され、必要なワークスペースを選択して、   IDE とプロジェクトを選択する   をクリックします。

10. ウィザードの次のページで、必要な IDE を選択し、ワークスペース内のプロジェクトへのパスを指定します。 ワークスペースのターミナルを使用する必要がある場合は、   ターミナルを使用する   をクリックします。

![IDE とプロジェクトのパス](https://resources.jetbrains.com/help/img/idea/2026.3/ide_and_project_coder.png)

すべてを選択したら、「   IDE を起動して接続   」をクリックします。

選択したプロジェクトを含む Coder 開発環境が JetBrains Client で開き、IDE 内でさらに作業できます。

## JetBrains CodeCanvas に接続する

[JetBrains コードキャンバス](https://www.jetbrains.com/ja-jp/help/codecanvas/introduction.html)は、企業がソフトウェア開発を個々のユーザーマシンから移行して開発環境を削除できるようにするソリューションです。

JetBrains Gateway を使用して   CodeCanvas   に接続し、リモートプロジェクトで作業することができます。 または、CodeCanvas 側から接続し、JetBrains Client でプロジェクトを開くこともできます。

JetBrains CodeCanvas は、   CodeCanvas   プラグインを通じて JetBrains Gateway で利用でき、既存の環境に接続したり、新しい環境を作成して CLion で作業したりできます。

Procedure: コードキャンバス開発環境に接続する

1. [JetBrains Gateway](#launch_gateway) を起動します。

CodeCanvas プラグインはデフォルトで有効化されています。

2. 左側のオプションから   すべてのプロバイダー   を選択します。

![すべてのプロバイダー](https://resources.jetbrains.com/help/img/idea/2026.3/all_providers_code_canvas.png)

3. JetBrains Gateway で、「   CodeCanvas に接続する   」をクリックします。

4. ウィザードの次のページで、アクセス URL を入力し、   ブラウザーで続行   をクリックします。

5. 開いたブラウザーウィンドウで、   Accept   をクリックして必要な権限を付与します。 CodeCanvas Web アプリにまだログインしていない場合は、ユーザー名とパスワードの入力も求められます。 その後、JetBrains Gateway にリダイレクトされます。

6. 新しい環境   をクリックして、新しい開発環境を構成します (プロジェクトに必要な開発環境がすでにある場合は、この手順をスキップします)。

* 開発環境に使用する [テンプレート](https://www.jetbrains.com/ja-jp/help/codecanvas/get-started-as-namespace-administrator.html#create-a-dev-environment-template)を選択します。

* 環境名 が自動的に選択されます。

* 必要なブランチと、使用可能な場合はウォームアップスナップショットを選択します。

環境を作成する   をクリックします。

![環境を作成する](https://resources.jetbrains.com/help/img/idea/2026.3/create_dev_env_code_canvas.png)

7. 開発環境が作成されると、プロジェクトが JetBrains Client で開かれ、コーディングを開始できます。

JetBrains Gateway のようこそ画面で   接続   ノードの下にある   JetBrains CodeCanvas   を選択して、既存の開発環境のリストを表示します。

![CodeCanvas 開発環境](https://resources.jetbrains.com/help/img/idea/2026.3/code_canvas_dev_environments.png)

## WSL2 で実行されているプロジェクトに接続する

IDE バックエンドを構成して、WSL2 で直接起動できます。

WSL への接続を開始する前に、次の前提条件が満たされていることを確認してください:

* Windows 10 または 11 バージョンがマシンにインストールされ、Ubuntu 20.04 バージョンが WSL2 にインストールされています。

* Windows マシンで WSL2 が構成されています。 詳細については、 [WSL2 構成](https://www.jetbrains.com/ja-jp/help/idea/how-to-use-wsl-development-environment-in-product.html#wsl-general)セクションを参照してください。

* 少なくとも 200 GB の空き容量、8 GB RAM、4 個の CPU が必要です。

* JetBrains Gateway の最新の EAP ビルドを使用します。

* バックエンド IDE の最新の EAP バージョンを使用します。

Procedure: WSL に接続

1. [JetBrains Gateway](#launch_gateway) を起動します。

2. すべてのプロバイダー   リストで WSL を選択します。

3. 右側のオプションから   新規接続   をクリックします。

![新規接続](https://resources.jetbrains.com/help/img/idea/2026.3/new_connection_wsl.png)

4. 次のページで WSL インスタンスを選択し、   次へ   をクリックします。

![WSL インスタンスの選択](https://resources.jetbrains.com/help/img/idea/2026.3/choose_wsl_instance.png)

5. 次のページで、IDE バージョンと開きたいプロジェクトを選択します。   IDE を起動して接続   をクリックします。

![IDE のバージョンとプロジェクトを選択する](https://resources.jetbrains.com/help/img/idea/2026.3/cl_gateway_wsl_gwside.png)

接続が確立され、バックエンド IDE がダウンロードされ、JetBrains Client でプロジェクトが開きます。

Procedure: WSL システム内のプロジェクトをローカルとして開く

1. `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) を押して設定を開き、  `詳細設定`  を選択します。

2. 詳細設定   ページの検索フィールドに   ゲートウェイ   と入力します。

3. 検索結果で、   WSL プロジェクトをローカルプロジェクトとしてネイティブに開く (リモート開発機能不要)   オプションが選択されていることを確認します。

4. 通常どおり [WSL に接続](#connect_to_wsl)します。

バックエンドをデプロイせずにプロジェクトが起動し、通常のローカルプロジェクトとして開きます。

