GitHub Copilot CLI の使用

コマンド ラインから GitHub Copilot を使う方法について説明します。

この機能を使用できるユーザーについて

GitHub Copilot CLI は、GitHub Copilot Pro、GitHub Copilot Pro+、GitHub Copilot Business、GitHub Copilot Enterprise プランで使用できます。

Copilot を organization から受け取る場合は、organization の設定で Copilot CLI ポリシーを有効にする必要があります。

この記事の内容

GitHub Copilot のコマンド ライン インターフェイス (CLI) を使用うと、ターミナルから Copilot を直接使用できます。 詳しくは、「GitHub Copilot CLI について」をご覧ください。

メモ

GitHub Copilot CLI はパブリック プレビュー段階であり、変更される可能性があります。

前提条件

Copilot CLI をインストールします。 「GitHub Copilot CLI のインストール」を参照してください。

Copilot CLI の使用

  1. ターミナルで、操作するコードが含まれるフォルダーに移動します。

  2. 「copilot」と入力して Copilot CLI を開始します。

    Copilot から、このフォルダー内のファイルを信頼することの確認を求められます。

    重要

    この GitHub Copilot CLI セッションの間に、Copilot はこのフォルダーの下にあるファイルの読み取り、変更、実行を試みることがあります。 この場所のファイルを信頼している場合にのみ続けるようにする必要があります。 信頼されたディレクトリについて詳しくは、「GitHub Copilot CLI について」をご覧ください。

  3. いずれかのオプションを選択してください。

    1.Yes, proceed:

    Copilot は、この場所にあるファイルをこのセッションでのみ操作できます。

    2. Yes, and remember this folder for future sessions:

    このフォルダー内のファイルを、このセッションと今後のセッションで信頼します。 このフォルダーから Copilot CLI を開始すると、再び求められることはありません。 このオプションは、Copilot がこの場所のファイルを操作しても常に安全であることが確実な場合にのみ選んでください。

    3.No, exit (Esc):

    Copilot CLI セッションを終了します。

  4. 現在 GitHub にログインしていない場合は、/login スラッシュ コマンドを使うように求められます。 このコマンドを入力し、画面上の指示に従って認証を行います。

  5. CLI でプロンプトを入力します。

    これは、単純なチャットの質問でも、バグの修正、既存のアプリケーションへの機能の追加、新しいアプリケーションの作成など、Copilot に対する特定のタスクの実行要求でもかまいません。

    プロンプトの例については、「GitHub Copilot CLI について」をご覧ください。

  6. Copilot は、ファイルを変更または実行できるツールを使う場合 (例: touch、chmod、node、sed)、ユーザーにツールの使用の承認を求めます。

    いずれかのオプションを選択してください。

    1.Yes:

    Copilot にこのツールの使用を許可します。 Copilot は、次にこのツールを使うとき、もう一度ユーザーに承認を求めます。

    2. Yes, and approve TOOL for the rest of the running session:

    現在実行中のセッションでそれ以降、このツールのどのオプションについても、再び承認を求めることなく使用することを、Copilot に許可します。 これより後のセッションでは、コマンドをもう一度承認する必要があります。

    このオプションを選ぶと、同じセッションで似たコマンドを繰り返し承認する必要がないため、多くのツール (chmod など) に便利です。 ただし、このオプションのセキュリティへの影響に注意する必要があります。 たとえば、rm コマンドに対してこのオプションを選ぶと、Copilot は、ユーザーに承認を求めることなく現在のフォルダー内またはその下にあるファイルを削除できます。

    3.No, and tell Copilot what to do differently (Esc):

    Copilot はコマンドを実行しません。 代わりに、現在の操作を終了して次のプロンプトを待ちます。 Copilot にタスクを続けるよう指示できますが、別の方法を使います。

    たとえば、Copilot に bash スクリプトの作成を指示するものの、Copilot が提案するスクリプトを使いたくない場合は、現在の操作を停止して、Continue the previous task but include usage instructions in the script などの新しいプロンプトを入力できます。

ヒント

次のヒントのようにして、Copilot CLI のエクスペリエンスを最適化します。

現在実行中の操作を停止する

プロンプトを入力した後、Copilot がまだ "考えている" 間にタスクの実行を停止する場合は、Esc キーを押します。

プロンプトに特定のファイルを含める

プロンプトに特定のファイルを追加するには、@ に続けてファイルへの相対パスを指定します。 たとえば、Explain @config/ci/ci-required-checks.yml や Fix the bug in @src/app.js などです。 これにより、Copilot に対するコンテキストとしてファイルの内容がプロンプトに追加されます。

ファイルのパスの入力を始めると、一致するパスがプロンプト ボックスの下に表示されます。 方向キーを使ってパスを選び、Tab キーを押して、プロンプトで完全なパスを指定します。

別の場所にあるファイルを操作する

Copilot は、タスクを完了するため、現在の作業ディレクトリの外部にあるファイルの操作が必要な場合があります。 Copilot は、ユーザーが対話型セッションで入力したプロンプトで現在の場所の外部にあるファイルを変更する必要がある場合、ファイルのディレクトリへのアクセスを承認するようユーザーに求めます。

ユーザーは、スラッシュ コマンドを使っていつでも手動で、信頼されたディレクトリを追加することもできます。

/add-dir /path/to/directory

操作するファイルがすべて別の場所にある場合は、スラッシュ コマンドを使って、新しい Copilot CLI セッションを開始することなく、現在の作業ディレクトリを切り替えることができます。

/cwd /path/to/directory

対話型セッションを再開する

--resume コマンド ライン オプションを使い、表示される一覧から再開するセッションを選ぶと、以前の対話型セッションに戻って、Copilot との会話を続けることができます。

カスタム指示を使用する

作業中のリポジトリにカスタム指示を追加して、Copilot のパフォーマンスを向上させることができます。 カスタム指示は、リポジトリ内の Markdown ファイルに保存される自然言語の説明です。 それらは、そのリポジトリでの作業中に入力したプロンプトに自動的に含められます。 これは、Copilot がプロジェクトのコンテキストとプロンプトへの応答方法をより深く理解するのに役立ちます。

Copilot CLI では以下がサポートされます。

  • .github/copilot-instructions.md ファイル内のリポジトリ全体の指示。
  • パス固有の指示ファイル: .github/copilot-instructions/**/*.instructions.md。
  • AGENTS.md などのエージェント ファイル。

詳しくは、「GitHub Copilot のリポジトリ カスタム命令を追加する」をご覧ください。

MCP サーバーを追加する

Copilot CLI には、既に構成されている GitHub MCP サーバーが付属しています。 この MCP サーバーを使って GitHub.com 上のリソースを操作でき、たとえば CLI から pull request をマージできます。

Copilot CLI で使用できる機能を拡張するには、MCP サーバーをさらに追加できます。

  1. 次のスラッシュ コマンドを使います。

    /mcp add

  2. Tab キーを使ってフィールド間を移動し、追加する MCP サーバーの詳細を入力します。

  3. Ctrl+S キーを押して、詳細を保存します。

構成した MCP サーバーの詳細は、既定では ~/.config ディレクトリにある mcp-config.json ファイルに格納されます。 この場所は、XDG_CONFIG_HOME 環境変数を設定して変更できます。 サーバー定義の JSON の構造については、「モデル コンテキスト プロトコル (MCP) を使用した GitHub Copilot コーディング エージェントの拡張」をご覧ください。

詳細情報

Copilot CLI で使用できるコマンド ライン オプションとスラッシュ コマンドの完全な一覧を見るには、次のいずれかを行います。

  • 対話型セッションのプロンプト ボックスに「?」と入力します。
  • ターミナルに「copilot help」と入力します。

追加の情報を見るには、ターミナルで次のいずれかのコマンドを使います。

  • 構成設定:

    copilot help config

    既定では ~/.config ディレクトリにある config.json ファイルを編集して、構成設定を調整できます。 この場所は、XDG_CONFIG_HOME 環境変数を設定して変更できます。

  • Copilot CLI に影響を与える環境変数:

    copilot help environment

  • 使用可能なログ レベル:

    copilot help logging

  • ツールの使用を許可または拒否するためのアクセス許可:

    copilot help permissions

フィードバック

GitHub Copilot CLI についてフィードバックがある場合は、対話型セッションで /feedback スラッシュ コマンドを使い、いずれかのオプションを選んでお知らせください。 プライベート フィードバック アンケートに回答したり、バグ レポートを送信したり、新しい機能を提案したりできます。