Skip to main content
Windsurf JetBrains プラグインは maintenance モードであり、Cascade は非推奨となりました。新しい JetBrains IDE のリリースでは、レガシー プラグインが動作しなくなる可能性があります。Cascade またはプラグインが動作しなくなった場合は、ACP 経由の Devin に切り替えてください。JetBrains ACP セットアップガイド を参照してください。

​
対応バージョン

バージョン 2022.3 以降。
  • JetBrains Fleet または ReSharper はサポート対象外です
  • Remote SSH はサポート対象外です。

​
拡張機能ログの収集

拡張機能バージョン 1.10.0 以降では、Chat Panel の Settings ページに Extension Diagnostics ボタンがあります。このボタンを使うと、関連するログとパラメーターが自動的に収集され、ダウンロード可能なテキストファイルにまとめられます。 古いバージョンの拡張機能の場合:
  1. ログは idea.log ファイルに書き込まれます。このファイルを見つけるには、Help > Show Log in Finder/Explorer メニューオプションに移動します
  2. ログをエクスポートまたはコピーします

​
IDE の既知の問題と解決策

​
Cascade が表示されない

通常、ログに次のエラーが表示されます。
または
JCEF は、Cascade を表示するために必要なブラウザーです。これを解決するには、Help > Find Actions > Choose Java Boot Runtime に移動し、JCEF が同梱されたランタイムを選択してください。 すでにランタイムに JCEF が同梱されている場合は、レジストリまたはプロパティで JCEF が無効になっている可能性があります。 プロパティを編集します: Help > Edit Custom Properties に移動し、次のフラグを追加して IDE を再起動してください:

​
証明書の問題

次のエラーが発生した場合:
これは、Codeium 拡張機能が提示された証明書を信頼していないため、Codeium 拡張機能が貴社のEnterpriseポータル / APIサーバーへの TLS 接続を信頼できないことを示しています。つまり、Codeium deployment で提示される証明書が信頼されていないか、リクエストを傍受している企業のプロキシによって提示される証明書が信頼されていない可能性があります。 いずれの場合も、もっとも望ましい解決策は、この証明書に署名したルート証明書が、エンドユーザーのマシン上の適切な場所に正しくインストールされていることを確認することです。JetBrains IDE とその他ほとんどの IDE は、オペレーティングシステムのデフォルトの場所から証明書を読み込みます。 証明書は、社内の IT チームまたは Admin チームによって発行・管理されています。システムに必要な証明書をインストールする際は、そちらにお問い合わせください。 TLS が終端される箇所では、完全な証明書チェーンが提示されていることが重要です。提示されるのがリーフ証明書だけの場合、JetBrains IDE やその他の IDE はその真正性を検証できないことがよくあります。これは、リーフ証明書を検証し、さらにルート証明書によって検証される中間証明書を認識できないためです。ブラウザーでは、この問題を回避できることがよくあります。ユーザーが以前に完全な証明書チェーンを提示する別の Web サイトにアクセスしており、その結果、中間証明書が認識・キャッシュされている可能性が高いためです。しかし、JetBrains IDE のようなアプリケーションにはこの利点がありません。 注: JetBrains ファミリー製品の 2024.3 では、IDE が OS の証明書を受け付けられなくなる bug が導入されました (JetBrains の issue レポート) 。これを解決するには、users は次のいずれかを実行できます。
  • JB 製品を以前のバージョンにダウングレードする
  • 2024.3.1 のプレビュー版 (ベータ版) を利用する
  • カスタム JVM オプションとして -Djavax.net.ssl.trustStoreType=Windows-ROOT を追加する

​
カスタムワークスペース

Cascade の使用時に次のエラーが表示される場合:
これは、Cascade が正常に動作するためにカスタム ワークスペースへのアクセスを必要としていることを示しています。これを解決するには、次の手順を実行します。
  1. File > Settings (macOS では IntelliJ IDEA > Preferences) に移動して、JetBrains IDE の設定を開きます
  2. Tools > Windsurf Settings に移動します
  3. Windsurf Settings パネルで、下部にある “Custom Workspaces” セクションを見つけます
  4. “Add Workspace” ボタンをクリックして、プロジェクトのワークスペースを追加します
  5. プロジェクトに適したワークスペース ディレクトリを選択します
  6. “OK” をクリックして設定を適用します
  7. 変更を反映するため、IDE を再起動します

​
Enterprise と非 Enterprise での動作の違い

カスタムワークスペースの動作は、ユーザー種別によって異なります。

​
Enterprise ユーザー

Enterprise ユーザーは、ワークスペースのインデックス作成を選択的に制御できます：
  • ワークスペースを追加する際、各ワークスペースでインデックス作成を有効にするためのチェックボックスが表示されます
  • チェックボックスがオンになっているワークスペースのみがインデックス作成され、Cascade で利用可能になります
  • これにより、どのワークスペースでインデックス作成リソースを消費するかを制御できます
  • セキュリティ上の理由から、ツール呼び出しはアクティブなワークスペースに制限されます

​
Enterprise以外のユーザー

Enterprise以外のユーザーでは、ワークスペースのインデックス作成は自動で行われます。
  • 追加したワークスペースは、チェックボックスをオンにしなくても自動的にインデックス作成されます
  • 追加したすべてのワークスペースは、すぐにCascadeで利用可能になります
  • アクティブなワークスペース外でツール呼び出しがブロックされることはありません
  • このモデルでは、選択的インデックス作成機能は関係ありません
上記のセットアップ手順を完了すると、Cascade はワークスペースにアクセスでき、通常どおり機能するはずです。

​
Windows の Rider でキーボード ショートカットが機能しない

Windows で JetBrains Rider を利用している際に、Cascade で Shift+Enter を押しても改行されない、または Delete キーが機能しない場合は、Rider の Unit Test Tool Window とのキーバインドの競合が原因です。 これは Rider の AI プラグインに影響する既知の問題です。これを解決するには、次の手順に従ってください。
  1. File > Settings を開いて、JetBrains IDE の Settings を開きます
  2. Keymap に移動します
  3. “Unit Test Tool Window Action” を検索します
  4. 競合しているキーバインド (Shift+Enter と Delete) を無効にするか、別のキーに再割り当てします
  5. 変更を反映するため、IDE を再起動します