環境での Copilot の構成

JetBrains IDE をお使いの場合、 Copilot は、コード提案の生成、エディター内のコードの動作の説明、コード修正の提案など、さまざまなタスクに役立ちます。 インストール後、 Copilot を有効または無効にしたり、IDE 内または で詳細設定を構成できます。 この記事では、IntelliJ IDE で Copilot を構成する方法について説明しますが、他の JetBrains IDE のユーザー インターフェイスは異なる場合があります。

JetBrains IDE で Copilot を構成するには、 Copilot プラグインをインストールする必要があります。 詳しくは、「環境への Copilot 拡張機能のインストール」をご覧ください。

Copilot を使う場合、JetBrains IDE のインライン候補には既定のキーボード ショートカットを使用できます。 また、特定のコマンドごとに、ショートカットを任意のキーボード ショートカットに再バインドすることもできます。 JetBrains IDE でキーボード ショートカットを再バインドする方法の詳細については、JetBrains のドキュメントを参照してください。 たとえば、IntelliJ IDEA のドキュメントなどがあります。

JetBrains IDE 内で Copilot を有効または無効にすることができます。 JetBrains ウィンドウの下部パネルにある Copilot 状態アイコンは、 Copilot が有効であるか、または無効であるかを示します。 有効の場合、アイコンが強調表示されます。 無効の場合、アイコンは淡色表示されます。

1. Copilot を有効または無効にするには、JetBrains ウィンドウの右にある下部パネルの状態アイコンをクリックします。

   

2. Copilot を無効にする場合、グローバルに無効にするか、または現在編集しているファイルの言語に対して無効にするかを確認されます。 グローバルに無効にするには、 Disable Completions をクリックします。 または、言語固有のボタンをクリックして、指定された言語の Copilot を無効にします。

   

JetBrains IDE では、コードの入力候補の表示方法や、 Copilotで有効にする言語、無効にする言語など、 Copilot の詳細設定を管理できます。

1. JetBrains IDE で、ファイル メニュー (Windows) またはメニュー バー (macOS) のアプリケーションの名前をクリックし、設定 をクリックします。
2. Languages & Frameworks で、 [ Copilot] をクリックします。
3. 自分の好みに合わせて設定を編集します。
   • コード候補の動作と外観、および更新を自動的に確認するかどうかを調整するには、対応するチェックボックスを選択または選択解除してください。
   • 自動更新を受信するように選んだ場合、安定版の更新プログラム (ただし頻度は低い) か、または夜間版の更新プログラム (安定性が低い場合がある) を受け取るかを選択できます。 [Update channel](更新プログラム チャネル) ドロップダウンをクリックして、安定版の更新を受け取る場合は Stable を、夜間版の更新を受け取る場合は Nightly を選びます。

IDE またはファイルを編集して、 Copilot をアクティブ化または非アクティブ化する言語を -copilot.xml 指定できます。 IDE で言語設定を変更する場合は、アクティブ化または非アクティブ化する言語を個別に選択および選択解除できます。

ファイル内の-copilot.xml言語設定を変更する場合は、個々の言語を指定するか、ワイルドカードを使用して、すべての言語の Copilot をアクティブ化または非アクティブ化できます。 また、例外を指定することもできます。これは、指定した言語の野生のカード設定をオーバーライドします。 たとえば、Python と YAML を除くすべての言語で Copilot を非アクティブ化できます。 既定では、 Copilot 拡張機能をインストールすると、すべての言語で Copilot がアクティブになります。

1. JetBrains IDE で、ファイル メニュー (Windows) またはメニュー バー (macOS) のアプリケーションの名前をクリックし、設定 をクリックします。
2. Languages & Frameworks で、 [ Copilot] をクリックします。
3. [言語]で、 Copilotをアクティブまたは非アクティブにしたい言語のチェックボックスを選択または選択解除します。
4. 適用をクリックし、OK をクリックします。
5. 変更を有効にするには、JetBrains IDEを再起動します。

-copilot.xmlファイル内の言語設定を構成するには、languageAllowListを編集する必要があります。 languageAllowListに追加するすべての行には、エントリ キーと値が含まれている必要があります。 エントリ キーは言語の名前、または ワイルドカード (*) です。 値は true または false です。 値がtrueの場合、指定した言語に対して Copilotがアクティブ化されます。 値がfalseの場合、指定した言語に対して Copilotが非アクティブ化されます。

このファイルは、次のディレクトリに格納されます。

• macOS: ~/Library/Application Support/JetBrains/<product><version>/options/-copilot.xml
• Windows: %APPDATA%\JetBrains\<product><version>\options\-copilot.xml
• Linux: ~/.config/JetBrains/<product><version>/options/-copilot.xml

たとえば、macOS で IntelliJ IDEA 2021.1 を使用している場合、ファイルは~/Library/Application Support/JetBrains/IdeaIC2021.1/options/-copilot.xmlにあります。

IDE の設定で既定の言語構成を変更するまで、-copilot.xmlファイルは生成されない場合があります。 ファイルが見つからない場合は、IDE で既定の言語設定を変更してみてください。 詳細については、「IDE での言語設定の構成」を参照してください。

または、ファイルを手動で作成し、上記のオペレーティング システムの場所に保存することもできます。 詳細については、「言語構成の例」を参照してください。

1. テキスト エディターで -copilot.xml ファイルを開きます。

2. <map>タグの間に、 Copilot をアクティブ化または非アクティブ化する言語の行または行を追加します。 たとえば、すべての言語で Copilot を非アクティブ化するには、次のようにします。

   XML

   <entry key="*" value="false" />
   

3. -copilot.xml ファイルに加えた変更を保存します。

4. 変更を有効にするには、JetBrains IDEを再起動します。

すべての言語で Copilot を有効にする -copilot.xml ファイルの既定の構成は次のとおりです。

<application>
  <component name="-copilot">
    <languageAllowList>
      <map>
        <entry key="*" value="true" />
      </map>
    </languageAllowList>
  </component>
</application>

<application>
  <component name="-copilot">
    <languageAllowList>
      <map>
        <entry key="*" value="true" />
      </map>
    </languageAllowList>
  </component>
</application>

すべての言語で Copilot を非アクティブ化するには、ワイルドカード (*)の値がfalseに変更されます。

<application>
  <component name="-copilot">
    <languageAllowList>
      <map>
        <entry key="*" value="false" />
      </map>
    </languageAllowList>
  </component>
</application>

<application>
  <component name="-copilot">
    <languageAllowList>
      <map>
        <entry key="*" value="false" />
      </map>
    </languageAllowList>
  </component>
</application>

言語を個別に指定するには、 Copilot をアクティブ化または非アクティブ化する言語ごとにエントリを追加します。 特定の言語設定は、ワイルドカードをオーバーライドします。 たとえば、Python と YAML に対して Copilot をアクティブ化し、他のすべての言語で Copilot を非アクティブ化するには、次のエントリを追加します。

<application>
  <component name="-copilot">
    <languageAllowList>
      <map>
        <entry key="*" value="false" />
        <entry key="Python" value="true" />
        <entry key="YAML" value="true" />
      </map>
    </languageAllowList>
  </component>
</application>

<application>
  <component name="-copilot">
    <languageAllowList>
      <map>
        <entry key="*" value="false" />
        <entry key="Python" value="true" />
        <entry key="YAML" value="true" />
      </map>
    </languageAllowList>
  </component>
</application>

IDE の設定で読み取り languageAllowList 専用にする構成を追加することもできます。 これにより、IDE の言語設定は変更できなくなります。 次に例を示します。

<application>
  <component name="-copilot">
    <option name="languageAllowListReadOnly" value="true" />
    <languageAllowList>
      <map>
        <entry key="*" value="true" />
      </map>
    </languageAllowList>
  </component>
</application>

<application>
  <component name="-copilot">
    <option name="languageAllowListReadOnly" value="true" />
    <languageAllowList>
      <map>
        <entry key="*" value="true" />
      </map>
    </languageAllowList>
  </component>
</application>

での Copilot の設定の構成

Copilot Pro プランをお使いの場合は、一般公開されているコードに一致するコード補完候補を許可または禁止できます。 これを設定するには、.com の個人用の設定を使用します。 「個人のサブスクライバーとしての Copilot ポリシーの管理」を参照してください。

のアカウントに対する認証

GHE.com 上の マネージド ユーザー アカウント 用に Copilot プランをお使いの場合は、サインインする前にいくつかの設定を更新する必要があります。「GHE.com 上のアカウントで Copilot を使う」を参照してください。

• Copilot FAQ