​
対応バージョン

バージョン 2022.3 以上。
  • JetBrains Fleet および ReSharper には対応していません
  • Remote SSH には対応していません。

​
拡張機能のログ収集

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

​
Enterprise URL をリセットまたは変更する方法

  1. Tools → Codeium Enterprise → Reset Codeium Enterprise Updater に移動します。
  2. 先頭や末尾に空白が入っていないことを確認し、新しい URL を入力します。
  3. IDE を再起動します。
  4. 再起動後、ログインを求められます。

​
既知の IDE の問題と対処法

​
Cascade が動作しない（または Windsurf プラグインがまったく動作しない）

Windsurf JetBrains プラグインが動作しない場合、まずは Help > Find Action > Reset Windsurf Enterprise Updater に進み、プラグインのリセットをお試しください。 問題が一部のユーザーに限られている場合は、Enterprise Domain の URL 証明書が IDE に読み込まれていないことが原因の可能性が高いです。チームの管理者が設定方法を把握しているはずです。

​
Cascade が表示されない

通常、ログには次のエラーが記録されます。 
この環境ではJCEFがサポートされていないか、初期化に失敗しました
または 
内部JCEFはサポートされていません。外部JCEFを試行中
JCEF は Cascade を表示するために必要なブラウザコンポーネントです。対処するには、Help > Find Actions > Choose Java Boot Runtime を開き、JCEF が同梱されたランタイムを選択してください。 すでにランタイムに JCEF が同梱されている場合は、レジストリやプロパティで JCEF が無効化されている可能性があります。 プロパティを編集します: Help > Edit Custom Properties を開き、次のフラグを追加して IDE を再起動してください: 
ide.browser.jcef.enabled=true

​
証明書に関する問題

次のエラーが発生した場合: 
<YourDomainURL>で拡張機能のベースURLの取得に失敗しました

PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: 
要求されたターゲットへの有効な証明書パスを見つけることができません
これは、Codeium 拡張機能が Enterprise ポータル／API サーバーへの TLS 接続を信頼できていない、すなわち提示された証明書を信頼していないことを示しています。これは、Codeium デプロイメントが提示している証明書が信頼されていないか、リクエストを中継・傍受する社内プロキシが提示する証明書が信頼されていない可能性があります。 いずれの場合も、最善の解決策は、その証明書に署名したルート証明書がエンドユーザーの端末の適切な場所に正しくインストールされていることを確認することです。JetBrains の IDE を含む多くの IDE は、OS のデフォルトの証明書ストアから証明書を読み込みます。 証明書は、お使いの社内 IT または管理チームによって発行・管理されています。必要な証明書のインストールについては、サポートを受けるために該当チームへお問い合わせください。 TLS の終端箇所からは、完全な証明書チェーンが提示されていることが重要です。しばしばリーフ証明書のみが提示されると、JetBrains の IDE などは、そのリーフ証明書を検証する中間証明書（さらにそれがルート証明書で検証される）を把握できないため、正当性を確認できません。ブラウザは、完全な証明書チェーンを提示する別サイトに以前アクセスして中間証明書が参照・キャッシュされていることが多いため、この問題を回避できる場合がありますが、JetBrains の IDE などのアプリケーションにはその利点がありません。 注意: JetBrains ファミリー製品 2024.3 で、IDE が OS の証明書を受け付けない不具合が導入されました（JetBrains の課題レポート）。対処方法として、次のいずれかを実施してください。
  • JB 製品を以前のバージョンにダウングレードする
  • 2024.3.1 のプレビュー版（ベータ版）を使用する
  • カスタム JVM オプションとして -Djavax.net.ssl.trustStoreType=Windows-ROOT を追加する

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

Cascade を使用中に次のエラーが表示される場合： 
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 がワークスペースにアクセスでき、正常に動作するはずです。