メインコンテンツへスキップ
一部の企業・エンタープライズネットワークでは、通信が HTTP/HTTPS プロキシ経由で中継されます。JetBrains IDE の Windsurf プラグインは（サインインや AI 機能のために）外部の Windsurf サービスへアクセスする必要があるため、安定して動作させるには事前にプロキシを設定する必要がある場合があります。

​
プロキシ設定が必要になる場合

次のような場合は、プロキシ設定が必要になる可能性があります:
  • Windsurf で「Failed to connect」などのネットワークエラーが表示される
  • IDE の Windsurf パネルが空白のままで読み込まれない
  • Cascade などの Windsurf 機能が接続できない、またはタイムアウトする
このガイドでは次の内容を説明します:
  • ネットワークでプロキシが使用されているかの確認方法
  • IDE のプロキシ設定
  • Windsurf のプロキシ自動検出の有効化
  • JetBrains Remote のプロキシ設定

​
ネットワークでプロキシを使用しているか確認する

何かを変更する前に: IT／インフラ／ネットワーク担当チームに確認してください:
  • 送信トラフィックに HTTP/HTTPS プロキシを使用していますか？
  • 使用している場合、自動設定（システム設定／PAC ファイル／デバイス管理）ですか？ それともアプリケーションごとに手動で設定が必要ですか？
組織でプロキシを使用していない場合、通常これらの設定を変更する必要はありません。 組織でプロキシを使用している場合は、プロキシの詳細（アドレス、ポート、資格情報）を集めてください。JetBrains の HTTP Proxy と Windsurf の設定画面のスクリーンショットを共有すると、入力すべき内容を正確に案内してもらえます。

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

まず、IDE 自体がプロキシ経由でインターネットにアクセスできること、特に windsurf.com に接続できることを確認してください。
  1. 使用中の JetBrains IDE で Settings / Preferences を開きます。例: File → Settings…（Windows/Linux）または ⌘, → Settings…（macOS）。
  2. Appearance & Behavior → System Settings → HTTP Proxy に移動します。
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 自体がネットワークに接続できない場合（例: プラグイン・マーケットプレイス、更新、組み込みの Web 機能が失敗する、または IDE 内から https://windsurf.com に到達できない）、まずここで問題を解消してください。Windsurf はこの接続に依存しています。

​
JetBrains で Windsurf のプロキシ検出を有効にする

IDE レベルのプロキシを設定済み（または不要と確認済み）であれば、Windsurf がその設定をどのように利用するかを構成します。 Windsurf プラグインには、設定内に独自の Detect proxy オプションがあります:
  1. JetBrains IDE で Settings / Preferences を開きます。
  2. Tools → Windsurf Settings に移動します。
  3. Detect proxy のトグルを見つけます。
Windsurf Proxy Detection Settings
  1. 次の場合は Detect proxy を ON にします:
    • プロキシが OS または IDE レベルで設定されており、
    • IT がアプリケーションにそれらの設定を「自動で拾う」ことを想定している場合
  2. 必要に応じて Apply と OK をクリックし、IDE を再起動します。
  3. Windsurf を再度試します:
    • IDE のサイドバーから Windsurf パネルを開く
    • Cascade を実行する、または「Failed to connect」や空白の画面になっていた操作を再試行する
Detect proxy を有効にした後に新たな接続問題が発生した場合は、次のいずれかを行ってください:
  • Detect proxy を OFF に戻す
  • IDE の HTTP Proxy 設定（https://windsurf.com に到達できることを含む）を再確認する
  • 追加の手動設定が必要かどうかを IT に確認する

​
JetBrains Remote におけるプロキシ設定

JetBrains Remote Development（例：JetBrains Gateway、リモートバックエンド、クラウド開発環境）を使用する場合、プロキシ設定が関係するのは実質的に次の2か所です:
  • シンクライアントを実行しているローカルマシン
  • 実際の IDE バックエンド（および Windsurf）が動作しているリモートマシン
JetBrains Remote で接続すると、Windsurf のネットワークリクエストはローカルのノートPCではなくリモートマシンから発行されます。つまり次のことを意味します:
  • リモート側の IDE のプロキシ設定は、Windsurf が Windsurf の各種サービスへ接続する方法に影響します。
  • ローカルマシンの設定が正しくても、リモートマシンには別途プロキシ設定が必要になる場合があります。
JetBrains のリモート開発では、標準の Windsurf プラグインではなく、専用の「Windsurf (Remote Development)」プラグインを使用する必要があります。Windsurf JetBrains はじめにガイドの Remote Development セクションに従って、「Windsurf (Remote Development)」をインストールしていることを確認してください。

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

  1. JetBrains Remote / Gateway を使用してリモートのバックエンドに接続します。
  2. リモート IDE セッションで Settings / Preferences を開きます（リモートマシン上で動作している IDE の設定が開きます）。
  3. リモート IDE のプロキシを設定します:
    • リモート IDE で Appearance & Behavior → System Settings → HTTP Proxy に移動します。
    • IT チームの指示に従ってプロキシを設定します（No proxy / Auto-detect / Use system proxy / Manual）。
    • IDE に Check connection… ボタンがある場合は、リモートマシンから https://windsurf.com への接続をテストするために使用します。
  4. リモート IDE 上の Windsurf を設定します:
    • Tools → Windsurf Settings に移動します（引き続きリモートセッション内）。
    • リモートホスト上のアプリケーションがシステム/IDE のプロキシ設定を使用することを IT チームが想定している場合は、Detect proxy を有効にします。
  5. 変更を適用し、リモート IDE のバックエンドを再起動するか、リモートセッションを切断して再接続します。
  6. リモート IDE で Windsurf パネルを再度開き、以前失敗していた操作を再試行します。
企業環境では、ローカルマシンとリモートマシンの双方に独自のプロキシルールがあるのが一般的です。両方で IT の指示に従ってください。ローカルのプロキシだけを直しても、リモートホスト自体が（https://windsurf.com を含む）インターネットへ独自のプロキシ設定なしでは到達できない場合は解決しません。

​
何をいつ変更すべきか

​
ローカル IDE の HTTP プロキシだけを変更する

次の条件を満たしている場合:
  • JetBrains Remote を使用していない
  • その設定後、他の JetBrains の機能がすでに動作している
  • Windsurf が独自の設定を変更しなくても動作している
  • IDE から https://windsurf.com にアクセスできる

​
Windsurf の「Detect Proxy」を有効にする

（ローカルまたはリモート）次のいずれにも当てはまる場合:
  • そのマシンの OS または IDE レベルでプロキシ設定がすでに行われており、かつ
  • Windsurf だけが接続できない、または Windsurf パネルが空白のまま表示される場合。

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

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

​
IT／インフラ担当に相談

次のような場合は:
  • 自分の環境でプロキシを使用しているかどうか分からない場合、または
  • HTTP Proxy と Windsurf Detect プロキシ（ローカルおよび／またはリモート）を設定し、https://windsurf.com への接続も確認したのに、Windsurf のパネルが空白のまま、または接続に失敗する場合。
最終的な確認先は IT／インフラチームです。ローカルマシン、リモートマシン、またはその両方でプロキシが必要か、JetBrains での設定方法、そしてあなたの環境で Windsurf Detect プロキシ設定を有効にすべきかどうかを確認できます。