GitHub Copilot CLI の使用

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

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

GitHub Copilot CLI（コマンドラインインターフェース） は、すべての Copilot プランで使用できます。 組織から Copilot を受け取る場合は、組織の設定で Copilot CLI ポリシーを有効にする必要があります。

この記事で

          GitHub Copilot用のコマンド ライン インターフェイス (CLI) を使用すると、ターミナルから直接Copilotを使用できます。 詳しくは、「[AUTOTITLE](/copilot/concepts/agents/about-copilot-cli)」をご覧ください。

前提条件

          Copilot CLIをインストールする。 「[AUTOTITLE](/copilot/how-tos/set-up/install-copilot-cli)」を参照してください。


          Copilot CLI の使用

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

  2.        `copilot`を開始するには、「Copilot CLI」と入力します。


       Copilot は、このフォルダー内のファイルを信頼していることを確認するように求められます。

    重要

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

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

           **1. はい。続行します**:


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


       **2. はい。今後のセッションでは、このフォルダーを覚えておいてください。**

    このフォルダー内のファイルを、このセッションと今後のセッションで信頼します。 このフォルダーから Copilot CLI を開始しても、もう一度確認するメッセージは表示されません。 このオプションは、 Copilot がこの場所のファイルを常に安全に操作できる場合にのみ選択します。

           **3. いいえ。終了します (Esc)**:


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

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

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

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

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

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

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

           **1. はい**:


       Copilotにこのツールの使用を許可します。 次回 Copilot このツールを使用する場合は、再度承認するように求められます。


       **2. はい。実行中のセッションの残りの部分に対して TOOL を承認します。**


       Copilotは、現在実行中のセッションの残りの部分について、もう一度要求することなく、任意のオプションでこのツールを使用できるようにします。 同じ種類の保留中の並列アクセス許可要求はすべて自動承認されます。 これより後のセッションでは、コマンドをもう一度承認する必要があります。

    このオプションを選択すると、同じセッションで同様のコマンドを繰り返し承認する必要が生じないため、 chmodなどの多くのツールに役立ちます。 ただし、このオプションのセキュリティへの影響に注意してください。 たとえば、コマンド rm に対してこのオプションを選択すると、 Copilot は承認を求めることなく、現在のディレクトリまたはそのサブディレクトリ内の任意のファイルを削除できます。

           **3. いいえ、そして Copilot に異なる指示を与える (Esc)**


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

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

    ツールのアクセス許可要求を拒否する場合は、拒否に関する Copilot インライン フィードバックを提供して、完全に停止することなくアプローチを調整することもできます。

ヒント

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

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

プロンプトを入力し、 Copilot がまだ "考えている" 状態でタスクの完了を停止する場合は、 Esc キーを押します。

プラン モードを使用する

プラン モードを使用すると、コードを記述する前に、実装計画で Copilot と共同作業を行うことができます。 Shift+Tab キーを押して、プラン モードを切り替えます。

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

プロンプトに特定のファイルを追加するには、@ に続けてファイルへの相対パスを指定します。 たとえば、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 セッションを開始せずに現在の作業ディレクトリ/cd切り替えることができます。

/cwd /path/to/directory

シェル コマンドを実行する

モデルを呼び出すことなく、 ! を使用して入力の先頭にシェル コマンドを直接実行できます。

!git clone https://github.com/github/copilot-cli

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

          `--resume`コマンド ライン オプションまたは `/resume` スラッシュ コマンドを使用して対話型 CLI セッションを選択して再開できます。これにより、保存されたコンテキストを使用して、中断した場所を右に選択できます。 
          CopilotコーディングエージェントでGitHub セッションを開始し、GitHub Copilot CLI（コマンドラインインターフェース）を使用してそのセッションをローカル環境に持ち込むことができます。

ヒント

最後に閉じたローカル セッションをすばやく再開するには、ターミナルで次のように入力します。

copilot --continue

カスタム指示を使用する

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

          Copilot CLI では次に示すオブジェクトをサポートしています。

* .github/copilot-instructions.md ファイル内のリポジトリ全体の指示。

  • パス固有の指示ファイル: .github/instructions/**/*.instructions.md。
  •         `AGENTS.md` などのエージェント ファイル。

詳しくは、「GitHub Copilot CLI（コマンドラインインターフェース） のカスタム命令の追加」をご覧ください。

          カスタム エージェント を使用する

          カスタム エージェントは、Copilotの特殊なバージョンです。 
          カスタム・エージェント は Copilot 独自のワークフロー、特定のコーディング規則、スペシャリストのユース ケースを処理するのに役立ちます。

          Copilot CLI には、一般的なタスクの既定の カスタム エージェント グループが含まれています。
エージェント 説明
探検する 簡単なコードベース分析を実行し、メイン コンテキストに追加せずにコードに関する質問をすることができます。
Task テストやビルドなどのコマンドを実行し、成功に関する簡単な概要と失敗時の完全な出力を提供します。
汎用 完全なツールセットと高品質の推論を必要とする複雑な複数ステップのタスクを処理し、メインの会話を明確に集中させるために別のコンテキストで実行します。
コードレビュー 本物の問題のみを表示し、ノイズを最小限に抑えることに焦点を当てて変更をレビューします。

CLI で使用されている AI モデルは、特定の専門知識を持つ カスタム エージェント を使用して動作するサブエージェント プロセスにタスクを委任することを選択できます。これにより、作業がより効果的に完了すると判断されます。 モデルは、メイン エージェントで作業を直接処理することを同じように選択できます。

          カスタム エージェントと呼ばれる Markdown ファイルを使用して、エージェントに必要な専門知識、使用できるツール、応答方法に関する具体的な指示を指定する独自のエージェント プロファイルを定義できます。

          カスタム エージェントは、ユーザー、リポジトリ、または組織/エンタープライズ レベルで定義できます。
タイプ場所Scope
ユーザー レベル カスタム エージェントローカル ~/.copilot/agents ディレクトリすべてのプロジェクト
リポジトリ レベル カスタム エージェント
          `.github/agents` ローカル リポジトリとリモート リポジトリ内のディレクトリ | 現在のプロジェクト |

| 組織レベルとエンタープライズ レベル カスタム エージェント | /agents 組織または企業の .github-private リポジトリ内のディレクトリ | 組織とエンタープライズ アカウントのすべてのプロジェクト |

名前の競合の場合、システム レベルのエージェントはリポジトリ レベルのエージェントをオーバーライドし、リポジトリ レベルのエージェントは組織レベルのエージェントをオーバーライドします。

          カスタム・エージェント は、次の 3 つの方法で使用できます。

  • CLI の対話型インターフェイスでスラッシュ コマンドを使用して、使用可能な カスタム エージェントの一覧から選択します。

    /agent

  • プロンプトで直接 カスタム エージェント を呼び出す:

    Use the refactoring agent to refactor this code block

            Copilot は、使用するエージェントを自動的に推論します。

  • コマンド ライン オプションで使用する カスタム エージェント を指定します。 例えば次が挙げられます。

    copilot --agent=refactor-agent --prompt "Refactor this code block"

詳しくは、「Copilotコーディングエージェント 用のカスタム エージェントの作成」をご覧ください。

スキルを使用する

命令、スクリプト、リソースを使用して特殊なタスクを実行する Copilot の能力を高めるスキルを作成できます。

詳しくは、「GitHub Copilot CLI（コマンドラインインターフェース）のエージェントスキルの作成」をご覧ください。

MCP サーバーを追加する

          Copilot CLI は、既に構成されている GitHub MCP サーバーに付属しています。 この MCP サーバーを使用すると、 GitHub.com上のリソースと対話できます。たとえば、CLI からのプル要求をマージできます。

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

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

    /mcp add

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

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

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

コンテキスト管理

          Copilot CLI には、コンテキスト ウィンドウの監視と管理に役立つスラッシュ コマンドがいくつか用意されています。

* /usage: 次のようなセッション統計を表示できます。

  • 現在のセッションで使用された Premium 要求の量

  • セッション期間

  • 編集されたコードの合計行数

  • モデルごとのトークン使用量の内訳

  •         `/context`: 現在のトークンの使用状況の視覚的な概要を提供します

  •         `/compact`: 会話履歴を手動で圧縮してコンテキスト領域を解放します

        GitHub Copilot CLI（コマンドラインインターフェース） では、会話がトークン制限の 95% に近づくと、ワークフローを中断することなく、バックグラウンドで履歴が自動的に圧縮されます。

すべてのアクセス許可を有効にする

          Copilotを信頼して自由に実行できる場合は、`--allow-all`または`--yolo`フラグを使用して、すべてのアクセス許可を一度に有効にすることができます。

推論の可視性を切り替える

Ctrl+キーを押して、応答の生成中にモデルの推論プロセスを表示または非表示にします。 この設定はセッション間で保持されるため、複雑な問題によって Copilot がどのように機能するかを確認できます。

詳細情報

          Copilot CLIで使用できるコマンド ライン オプションとスラッシュ コマンドの完全な一覧については、次のいずれかの操作を行います。
  • 対話型セッションのプロンプト ボックスに「?」と入力します。
  • ターミナルに「copilot help」と入力します。

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

  •         **NDES 構成設定**:

    copilot help config

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

  •         **
        **に影響するCopilot CLI:

    copilot help environment

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

    copilot help logging

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

    copilot help permissions

フィードバック

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

次のステップ

          Copilot CLI は、会話アシスタントとして動作し、質問に答え、対話形式でコードを記述するのに役立ちます。 チャット以外にも、 Copilot CLI では、より自律性の高いタスクを委任できるさまざまなエージェント モードがサポートされています。

          Copilot CLIのエージェントと連携して、作業の委任から結果の確認まで、完全なタスク ライフサイクルをサポートできます。

* タスクを自律的に委任する: オートパイロット モードで Copilot CLI を実行し、各ステップで承認を必要とせずに複数ステップのタスクを完了します。 「GitHub Copilot CLI（コマンドラインインターフェース） にタスクを委任すること」を参照してください。 * カスタム エージェントの呼び出し: コード レビュー、ドキュメント、セキュリティ監査など、特定のタスクに合わせて調整された特殊なエージェントを呼び出します。 「カスタム エージェントの呼び出し」を参照してください。 * エージェントの誘導: タスクの実行中にエージェントの動作をガイドして調整し、作業を追跡します。 「AUTOTITLE」を参照してください。 * コード レビューを要求する: Copilot CLI を使用して、コード変更の AI を活用したレビューを取得します。 「GitHub Copilot CLI（コマンドラインインターフェース） を使用してコード レビューを要求する」を参照してください。

詳細については、次を参照してください。

  •         [AUTOTITLE](/copilot/how-tos/copilot-cli/cli-best-practices)

  •         [AUTOTITLE](/copilot/reference/copilot-cli-reference/cli-command-reference)

  •         [AUTOTITLE](/copilot/reference/copilot-cli-reference/cli-config-dir-reference)

  •         [AUTOTITLE](/copilot/reference/copilot-cli-reference/acp-server)