メインコンテンツへスキップ
一部の企業ネットワークやエンタープライズ環境では、HTTP/HTTPS プロキシを経由して通信が行われます。JetBrains IDE の Windsurf プラグインは、サインインやエージェント機能を利用するために外部の Windsurf サービスに接続する必要があります。そのため、この接続用にプロキシの構成が必要になる場合があります。

プロキシ設定が必要になるケース

次のような場合は、プロキシ設定が必要になることがあります。
  • Windsurf プラグインで「接続に失敗しました」などのネットワークエラーが表示される
  • IDE の Cascade パネルが空白のままで、読み込まれない
  • Cascade やその他の Windsurf プラグインの機能が接続できない、またはタイムアウトする
このガイドでは、次の内容を説明します。
  • ネットワークでプロキシが利用されているか確認する
  • IDE のプロキシを設定する
  • Windsurf プラグインでプロキシ検出を有効にする
  • JetBrains Remote のプロキシ設定を行う

ネットワークでプロキシが使われているか確認する

何かを変更する前に、次の点を IT / インフラ / ネットワークの担当チームに確認してください。
  • 外向きの通信に HTTP/HTTPS プロキシを利用していますか?
  • 利用している場合、自動的に設定されていますか (システム設定 / PAC ファイル / デバイス管理) ? それとも、アプリケーションごとに手動で設定する必要がありますか?
組織でプロキシを利用していない場合、通常はこれらの設定を変更する必要はありません。 組織でプロキシを利用している場合は、プロキシの詳細 (アドレス、ポート、必要な認証情報) を確認してください。JetBrains の HTTP プロキシと Windsurf の設定画面のスクリーンショットを担当チームに共有できます。共有すれば、どの値を入力すべきかを案内してもらえます。

JetBrains IDE のプロキシを設定する

まず、IDE 自体がプロキシ経由でインターネットにアクセスできること、特に windsurf.com に接続できることを確認してください。
  1. JetBrains IDE で Settings / 環境設定 を開きます。例: File → Settings… (Windows/Linux) または ⌘, → Settings… (macOS) 。
  2. Appearance & Behavior → System Settings → HTTP プロキシ に移動します。
JetBrains HTTP Proxy Settings
  1. IT チームの案内に従って、適切なオプションを選択します。
    • No proxy – ネットワークでプロキシを使用していない場合。
    • Auto-detect proxy settings または Use system proxy settings – マシン全体でプロキシが設定されている場合。
    • Manual proxy configuration – IT から、ここに入力するプロキシのホスト名/ポート (必要に応じてユーザー名/パスワードを含む) の指定を受けている場合。
  2. Check connection… (利用できる場合) を使って設定を確認します。可能であれば、このダイアログから https://windsurf.com への接続をテストしてください。
  3. 変更を適用し、求められた場合は IDE を再起動します。
IDE のネットワークの問題は、まずここで解決してください。たとえば、IDE でプラグインマーケットプレイスや更新、https://windsurf.com への接続が失敗することがあります。Windsurf プラグインの動作にはこの接続が必要です。

JetBrains で Windsurf プラグインのプロキシ検出を有効にする

IDE 階層のプロキシを設定したら (または不要であることを確認したら)、Windsurf プラグインがその設定をどのように利用するかを設定します。 Windsurf プラグインの設定には、プラグイン独自の Detect Proxy オプションがあります。
  1. JetBrains IDE で、設定 / 環境設定 を開きます。
  2. ツール → Windsurf の設定 に移動します。
  3. Detect Proxy チェックボックスを探します。
Windsurf プラグインのプロキシ検出設定
  1. 次の条件を満たす場合は、Detect Proxy にチェックを入れます。
    • プロキシが OS または IDE 階層で設定済みであり、かつ
    • IT 部門が、アプリケーションでそれらの設定が自動的に適用されることを想定している
  2. 必要に応じて「Apply」と「OK」をクリックし、IDE を再起動します。
  3. プラグインをもう一度試します。
    • IDE のサイドバーから Cascade パネルを開きます
    • Cascade を実行するか、「接続に失敗しました」というエラーが表示されていた操作や、画面が真っ白なままだった操作を再試行します
Detect Proxy にチェックを入れた後に新たな接続の問題が発生した場合は、次の対応を行ってください。
  • Detect Proxy のチェックを外す
  • IDE の HTTP プロキシ設定を再確認する (https://windsurf.com に到達できるかどうかも含む)
  • 追加の手動設定が必要かどうかを IT 部門に確認する

JetBrains Remote でのプロキシ設定

JetBrains Remote Development (たとえば、JetBrains Gateway、リモートバックエンド、クラウド開発環境経由など) を利用する場合、プロキシ設定が重要になる箇所は実質的に 2 か所あります。
  • シンクライアントを実行するローカルマシン
  • IDE バックエンドと Windsurf プラグインのバックエンドが動作するリモートマシン
JetBrains Remote で接続すると、プラグインのネットワークリクエストはローカルマシンではなく、リモートマシンから送信されます。つまり、次の点に注意が必要です。
  • リモート IDE 側のプロキシ設定によって、プラグインが Windsurf のサービスへどのように接続するかが決まります。
  • ローカルマシンがすでに正しく設定されていても、リモートマシン側で別途プロキシ設定が必要になる場合があります。
JetBrains のリモート開発では、標準の Windsurf プラグインではなく、専用の “Windsurf (Remote Development)” プラグインを利用する必要があります。スタートガイドの Remote Development セクション に記載されているとおり、Windsurf (Remote Development) がインストールされていることを確認してください。

リモート環境のプロキシを設定する

  1. JetBrains Remote / Gateway を使用してリモートバックエンドに接続します。
  2. リモート IDE セッションで Settings / 環境設定 を開きます (これにより、リモートマシン上で実行されている IDE の設定が開きます) 。
  3. リモート IDE のプロキシを設定します。
    • リモート IDE で Appearance & Behavior → System Settings → HTTP プロキシ に移動します。
    • IT チームの指示に従ってプロキシを設定します (No proxy / Auto-detect / Use system proxy / Manual) 。
    • IDE に Check connection… ボタンがある場合は、それを利用してリモートマシンから https://windsurf.com への接続をテストします。
  4. リモート IDE で Windsurf プラグインを設定します。
    • Tools → Windsurf の設定 に移動します (引き続きリモートセッション内で操作します) 。
    • IT チームがリモートホスト上のアプリケーションでシステムまたは IDE のプロキシ設定を利用する運用を想定している場合は、Detect Proxy を選択します。
  5. 変更を適用したら、リモート IDE バックエンドを再起動するか、リモートセッションを切断して再接続します。
  6. リモート IDE で再度 Cascade パネルを開き、先ほど失敗したアクションを再試行します。
企業環境では、ローカルマシンとリモートマシンのそれぞれに個別のプロキシルールが設定されていることがよくあります。必ず両方について IT チームの案内に従ってください。リモートホスト自体が独自のプロキシ設定なしではインターネット (https://windsurf.com を含む) に接続できない場合、ローカル側のプロキシだけを修正しても解決しません。

状況に応じた変更箇所

ローカル IDE の HTTP プロキシのみを変更する

次のすべてに当てはまる場合:
  • JetBrains Remote を使用しておらず、
  • 設定後、他の JetBrains の機能はすでに動作しており、
  • Windsurf プラグインは自身の設定を変更しなくても動作し、
  • IDE から https://windsurf.com にアクセスできます。

Windsurf プラグインの「Detect Proxy」オプションを有効にする

(ローカル環境またはリモート環境で) 次の場合:
  • そのマシンで OS または IDE レベルのプロキシがすでに設定されており、
  • 接続できないのが Windsurf プラグインだけである、または Cascade パネルが空白で表示される。

リモートIDEでプロキシを設定する

次のいずれかに当てはまる場合:
  • JetBrains Remoteを利用している
  • その環境にWindsurf (Remote Development) プラグインをインストールしている
  • リモートバックエンドに接続しているときにのみエラーが発生する、または
  • IT部門から、インターネット (https://windsurf.com を含む) にアクセスするにはリモートサーバーもプロキシを経由する必要があると言われている

IT / インフラに相談する

次のいずれかに当てはまる場合:
  • ご利用の環境でそもそもプロキシが使われているかどうかわからない、または
  • HTTP プロキシと Detect Proxy を設定し (ローカル、リモート、またはその両方) 、https://windsurf.com への接続も確認済みであるにもかかわらず、
  • Cascade パネルが空白のままだったり、接続エラーが発生したりする。
IT / インフラチームに、プロキシが必要なマシン (ローカル、リモート、またはその両方) を確認してもらえます。また、JetBrains の設定や Detect Proxy の正しい値についても確認してもらえます。