{"meta":{"title":"GitHub Copilot CLI の使用","intro":"コマンド ラインから GitHub Copilot を使用する方法について説明します。","product":"GitHub Copilot","breadcrumbs":[{"href":"/ja/copilot","title":"GitHub Copilot"},{"href":"/ja/copilot/how-tos","title":"方法"},{"href":"/ja/copilot/how-tos/copilot-cli","title":"Copilot CLI"},{"href":"/ja/copilot/how-tos/copilot-cli/use-copilot-cli","title":"Copilot CLI を使用する"},{"href":"/ja/copilot/how-tos/copilot-cli/use-copilot-cli/overview","title":"概要"}],"documentType":"article"},"body":"# GitHub Copilot CLI の使用\n\nコマンド ラインから GitHub Copilot を使用する方法について説明します。\n\nGitHub Copilot用のコマンド ライン インターフェイス (CLI) を使用すると、ターミナルから直接Copilotを使用できます。 詳細については、「[GITHUB COPILOT CLI について](/ja/copilot/concepts/agents/copilot-cli/about-copilot-cli)」を参照してください。\n\n## 前提条件\n\nCopilot CLIをインストールする。 「[GitHub Copilot CLI のインストール](/ja/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli)」を参照してください。\n\n## Copilot CLI の使用\n\n1. ターミナルで、操作するコードが含まれるフォルダーに移動します。\n\n2. `copilot`を開始するには、「Copilot CLI」と入力します。\n\nCopilot は、このフォルダー内のファイルを信頼していることを確認するように求められます。\n\n> \\[!IMPORTANT]\n> この GitHub Copilot CLI セッション中に、 Copilot はこのフォルダーの下にあるファイルの読み取り、変更、および実行を試みる場合があります。 この場所のファイルを信頼している場合にのみ続けるようにする必要があります。 信頼されたディレクトリについて詳しくは、「[GITHUB COPILOT CLI について](/ja/copilot/concepts/agents/copilot-cli/about-copilot-cli#trusted-directories)」をご覧ください。\n\n1. いずれかのオプションを選択してください。\n\n**1. はい。続行します**:\n\nCopilot は、このセッションでのみ、この場所のファイルを操作できます。\n\n**2. はい。今後のセッションでは、このフォルダーを覚えておいてください。**\n\nこのフォルダー内のファイルを、このセッションと今後のセッションで信頼します。 このフォルダーから Copilot CLI を開始しても、もう一度確認するメッセージは表示されません。 このオプションは、 Copilot がこの場所のファイルを常に安全に操作できる場合にのみ選択します。\n\n**3. いいえ。終了します (Esc)**:\n\nCopilot CLI セッションを終了します。\n\n1. 現在 GitHubにログインしていない場合は、 `/login` スラッシュ コマンドを使用するように求められます。 このコマンドを入力し、画面上の指示に従って認証を行います。\n\n2. CLI でプロンプトを入力します。\n\n これは、単純なチャットの質問や、バグの修正、既存のアプリケーションへの機能の追加、新しいアプリケーションの作成など、特定のタスクを実行する Copilot の要求です。\n\n 入力の代わりに、プロンプトを読み上げることもできます。 「[Copilot CLI で音声入力を使用する](/ja/copilot/how-tos/copilot-cli/use-copilot-cli/voice-input)」を参照してください。\n\n プロンプトの例については、「[GITHUB COPILOT CLI について](/ja/copilot/concepts/agents/copilot-cli/about-copilot-cli)」をご覧ください。\n\n3. Copilotファイルを変更または実行できるツール (例: `touch`、`chmod`、`node`、`sed`) を使用する場合は、ツールの使用を承認するように求められます。\n\n いずれかのオプションを選択してください。\n\n**1. はい**:\n\nCopilotにこのツールの使用を許可します。 次回 Copilot このツールを使用する場合は、再度承認するように求められます。\n\n**2. はい。実行中のセッションの残りの部分に対して TOOL を承認します。**\n\nCopilotは、現在実行中のセッションの残りの部分について、もう一度要求することなく、任意のオプションでこのツールを使用できるようにします。 同じ種類の保留中の並列アクセス許可要求はすべて自動承認されます。 これより後のセッションでは、コマンドをもう一度承認する必要があります。\n\nこのオプションを選択すると、同じセッションで同様のコマンドを繰り返し承認する必要が生じないため、 `chmod`などの多くのツールに役立ちます。 ただし、このオプションのセキュリティへの影響に注意してください。 たとえば、コマンド `rm` に対してこのオプションを選択すると、 Copilot は承認を求めることなく、現在のディレクトリまたはそのサブディレクトリ内の任意のファイルを削除できます。\n\n**3. いいえ、Copilotに別の方法を指示します (Esc)**\n\nCopilot はコマンドを実行しません。 代わりに、現在の操作を終了して次のプロンプトを待ちます。\nCopilotにタスクを続行するように指示できますが、別のアプローチを使用します。\n\nたとえば、bash スクリプトの作成を Copilot に依頼したが、提案するスクリプト Copilot 使用したくない場合は、現在の操作を停止して、次のような新しいプロンプトを入力 `Continue the previous task but include usage instructions in the script`。\n\nツールのアクセス許可要求を拒否する場合は、拒否に関する Copilot インライン フィードバックを提供して、完全に停止することなくアプローチを調整することもできます。\n\n## Tips\n\n次のヒントを使用して、 Copilot CLI を使用してエクスペリエンスを最適化します。\n\n### 現在実行中の操作を停止する\n\nプロンプトを入力し、 Copilot がまだ \"考えている\" 状態でタスクの完了を停止する場合は、 Esc キーを押します。\n\n### プラン モードを使用する\n\nプラン モードを使用すると、コードを記述する前に、実装計画で Copilot と共同作業を行うことができます。 Shift+Tab キーを押して、プラン モードを切り替えます。\n\n### プロンプトに特定のファイルを含める\n\nプロンプトに特定のファイルを追加するには、`@` に続けてファイルへの相対パスを指定します。 たとえば、`Explain @config/ci/ci-required-checks.yml` や `Fix the bug in @src/app.js` などです。 これにより、ファイルの内容が Copilotのコンテキストとしてプロンプトに追加されます。\n\nファイルのパスの入力を始めると、一致するパスがプロンプト ボックスの下に表示されます。 方向キーを使ってパスを選び、Tab キーを押して、プロンプトで完全なパスを指定します。\n\n### 画像と PDF を添付する\n\nイメージ入力をサポートするモデルを使用する場合は、プロンプトに画像と PDF を添付できます。\n\nCopilot では、次のファイルの種類がサポートされています。\n\n* JPEG (`.jpg`、 `.jpeg`)\n* PNG(`.png`)\n* GIF(`.gif`)\n* WEBP (`.webp`)\n* PDF (`.pdf`)\n* HEIC (`.heic`)\n* HEIF (`.heif`)\n\n画像と PDF の添付ファイルは、すべての Copilot プランで使用でき、既定で有効になっています。この機能のオンとオフを切り替えるポリシーは必要ありません。\n\n対話型セッション中は、次の方法でファイルを添付できます。\n\n* `@`の後にファイルへのパスを指定して、プロンプト内のファイルを参照します。\n* ファイルを対話型セッションにドラッグ アンド ドロップします。\n* 画像をクリップボードにコピーし、添付ファイルとして貼り付けます。\n\n### 別の場所にあるファイルを操作する\n\nタスクを完了するには、 Copilot 現在の作業ディレクトリの外部にあるファイルを操作する必要がある場合があります。 対話型セッションで入力したプロンプトで、現在の場所以外のファイルを変更するために Copilot が必要な場合は、ファイルのディレクトリへのアクセスを承認するように求められます。\n\nユーザーは、スラッシュ コマンドを使っていつでも手動で、信頼されたディレクトリを追加することもできます。\n\n```shell\n/add-dir /path/to/directory\n```\n\n操作するすべてのファイルが別の場所にある場合は、Copilot CLIまたはスラッシュ コマンドを使用して、新しい`/cwd` セッションを開始せずに現在の作業ディレクトリ`/cd`切り替えることができます。\n\n```shell\n/cwd /path/to/directory\n```\n\n### シェル コマンドを実行する\n\nモデルを呼び出すことなく、 `!` を使用して入力の先頭にシェル コマンドを直接実行できます。\n\n```shell\n!git clone https://github.com/github/copilot-cli\n```\n\n### 後で実行するようにプロンプトをスケジュールする\n\n`/every`コマンドと`/after`スラッシュ コマンドを使用して、プロンプトを将来実行するようにスケジュールできます。\n`/every` コマンドは、指定した間隔で繰り返し実行するプロンプトをスケジュールします。一方、`/after` コマンドは、指定した遅延後に 1 回だけ実行するように 1 回だけプロンプトをスケジュールします。 例えば次が挙げられます。\n\n```shell\n/every 1h Run frontend tests and report any failures\n```\n\n詳細については、「[GitHub Copilot CLI でのプロンプトのスケジュール設定](/ja/copilot/how-tos/copilot-cli/automate-copilot-cli/schedule-prompts)」を参照してください。\n\n### 対話型セッションを再開する\n\n`--resume`コマンド ライン オプションまたは `/resume` スラッシュ コマンドを使用して対話型 CLI セッションを選択して再開できます。これにより、保存されたコンテキストを使用して、中断した場所を右に選択できます。\nCopilot cloud agentでGitHub セッションを開始し、GitHub Copilot CLIを使用してそのセッションをローカル環境に持ち込むことができます。\n\n> \\[!TIP]\n> 最後に閉じたローカル セッションをすばやく再開するには、ターミナルで次のように入力します。\n>\n> ```shell\n> copilot --continue\n> ```\n\n### カスタム指示を使用する\n\n作業中のリポジトリにカスタム命令を追加することで、 Copilotのパフォーマンスを向上させることができます。 カスタム指示は、リポジトリ内の Markdown ファイルに保存される自然言語の説明です。 それらは、そのリポジトリでの作業中に入力したプロンプトに自動的に含められます。 これにより、プロジェクトのコンテキストとプロンプトに応答する方法をより深く理解 Copilot 。\n\nCopilot CLI では次に示すオブジェクトをサポートしています。\n\n* `.github/copilot-instructions.md` ファイル内のリポジトリ全体の指示。\n* パス固有の指示ファイル: `.github/instructions/**/*.instructions.md`。\n* `AGENTS.md` などのエージェント ファイル。\n\n詳細については、「[カスタム指示の追加 GitHub Copilot CLI](/ja/copilot/how-tos/copilot-cli/customize-copilot/add-custom-instructions)」を参照してください。\n\n### custom agents を使用する\n\ncustom agentは、Copilotの特殊なバージョンです。\nCustom agents は Copilot 独自のワークフロー、特定のコーディング規則、スペシャリストのユース ケースを処理するのに役立ちます。\n\nCopilot CLI には、一般的なタスクの既定の custom agents グループが含まれています。\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
AgentDescription
探索簡単なコードベース分析を実行し、メイン コンテキストに追加せずにコードに関する質問をすることができます。
Taskテストやビルドなどのコマンドを実行し、成功に関する簡単な概要と失敗時の完全な出力を提供します。
汎用完全なツールセットと高品質の推論を必要とする複雑な複数ステップのタスクを処理し、メインの会話を明確に集中させるために別のコンテキストで実行します。
コード レビュー本物の問題のみを表示し、ノイズを最小限に抑えることに焦点を当てて変更をレビューします。
研究コードベース、関連するリポジトリ、および Web 全体で詳細な調査を実行し、引用文献を含む詳細なレポートを作成します。
ゴム製アヒル建設的な評論家として機能し、いくつかの簡単でないタスクに関するフィードバックを提供します。 \nCopilot CLIによって自動的に使用されます。
\n\nCLI で使用されている AI モデルは、特定の専門知識を持つ custom agent を使用して動作するサブエージェント プロセスにタスクを委任することを選択できます。これにより、作業がより効果的に完了すると判断されます。 モデルは、メイン エージェントで作業を直接処理することを同じように選択できます。\n\nラバーダックエージェントなどの一部の組み込み custom agentsは、ユーザーが直接呼び出すのではなく、ユーザーの代わりに Copilot によって自動的に相談されます。\n`/agent`を実行すると、オプションとしては個別に表示されませんが、タスクを進行する際にCopilotでその言及がされる場合があります。\n\ncustom agentsと呼ばれる Markdown ファイルを使用して、エージェントに必要な専門知識、使用できるツール、応答方法に関する具体的な指示を指定する独自のagent profilesを定義できます。\n\ncustom agentsは、ユーザー、リポジトリ、または組織/エンタープライズ レベルで定義できます。\n\n| タイプ | 場所 | Scope |\n| -------------------------------------------------- | ------------------------------- | ---------- |\n| ユーザー レベル custom agent | ローカル `~/.copilot/agents` ディレクトリ | すべてのプロジェクト |\n| リポジトリ レベル custom agent | | |\n| `.github/agents` ローカル リポジトリとリモート リポジトリ内のディレクトリ | 現在のプロジェクト | |\n| 組織レベルとエンタープライズ レベル custom agent | | |\n| `/agents` 組織または企業の `.github-private` リポジトリ内のディレクトリ | 組織とエンタープライズ アカウントのすべてのプロジェクト | |\n\n名前の競合の場合、システム レベルのエージェントはリポジトリ レベルのエージェントをオーバーライドし、リポジトリ レベルのエージェントは組織レベルのエージェントをオーバーライドします。\n\nCustom agents は、次の 3 つの方法で使用できます。\n\n* CLI の対話型インターフェイスでスラッシュ コマンドを使用して、使用可能な custom agentsの一覧から選択します。\n\n ```shell\n /agent\n ```\n\n* プロンプトで直接 custom agent を呼び出す:\n\n ```shell\n Use the refactoring agent to refactor this code block\n ```\n\nCopilot は、使用するエージェントを自動的に推論します。\n\n* コマンド ライン オプションで使用する custom agent を指定します。 例えば次が挙げられます。\n\n ```shell\n copilot --agent=refactor-agent --prompt \"Refactor this code block\"\n ```\n\n詳細については、「[Copilot cloud agent用のカスタム エージェントの作成](/ja/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-custom-agents)」を参照してください。\n\n### スキルを使用する\n\n命令、スクリプト、リソースを使用して特殊なタスクを実行する Copilot の能力を高めるスキルを作成できます。\n\n詳細については、「[エージェント スキルの追加 GitHub Copilot CLI](/ja/copilot/how-tos/copilot-cli/customize-copilot/add-skills)」を参照してください。\n\n### フックを使用する\n\nフックを使用して、 Copilot CLIの動作を拡張およびカスタマイズできます。 フックを使用すると、CLI セッション中にキー ポイントでカスタム シェル コマンドを自動的に実行できます。\n\n詳細については、「[GitHub Copilot CLI でフックを使用する](/ja/copilot/how-tos/copilot-cli/customize-copilot/use-hooks)」を参照してください。\n\n### MCP サーバーを追加する\n\nCopilot CLI は、既に構成されている GitHub MCP サーバーに付属しています。 この MCP サーバーを使用すると、 GitHub.com上のリソースと対話できます。たとえば、CLI からのプル要求をマージできます。\n\nCopilot CLIで使用できる機能を拡張するには、MCP サーバーを追加します。\n\n対話型セッションを開始せずにターミナルから直接リモート HTTP サーバーを追加するには、次のコマンドを使用します。\n\n```shell copy\ncopilot mcp add --transport http SERVER-NAME URL\n```\n\n例えば次が挙げられます。\n\n```shell copy\ncopilot mcp add --transport http sentry https://mcp.sentry.dev/mcp\n```\n\nローカル サーバーとその他のオプションについては、 [GitHub Copilot CLI 用の MCP サーバーを追加する](/ja/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers#using-the-copilot-mcp-add-subcommand) を参照してください。\n\nまたは、対話型セッションからサーバーを追加します。\n\n1. 次のスラッシュ コマンドを使います。\n\n ```shell\n /mcp add\n ```\n\n2. Tab キーを使ってフィールド間を移動し、追加する MCP サーバーの詳細を入力します。\n\n3. Ctrl+S キーを押して、詳細を保存します。\n\n構成した MCP サーバーの詳細は、既定では `mcp-config.json` ディレクトリにある `~/.copilot` ファイルに格納されます。 この場所は、`COPILOT_HOME` 環境変数を設定して変更できます。 サーバー定義の JSON の構造については、「[リポジトリの MCP サーバーを構成する](/ja/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers#writing-a-json-configuration-for-mcp-servers)」をご覧ください。\n\n### コンテキスト管理\n\nCopilot CLI には、コンテキスト ウィンドウの監視と管理に役立つスラッシュ コマンドがいくつか用意されています。\n\n* `/usage`: 次のようなセッション統計を表示できます。\n * 現在のセッションで使用 GitHub AI Credits の量\n * セッション期間\n * 編集されたコードの合計行数\n * モデルごとのトークン使用量の内訳\n\n* `/context`: 現在のトークンの使用状況の視覚的な概要を提供します\n\n* `/compact`: 会話履歴を手動で圧縮してコンテキスト領域を解放します\n\nGitHub Copilot CLI では、会話がトークン制限の 95% に近づくと、ワークフローを中断することなく、バックグラウンドで履歴が自動的に圧縮されます。\n\n### すべてのアクセス許可を有効にする\n\nCopilotを信頼して自由に実行できる場合は、`--allow-all`または`--yolo`フラグを使用して、すべてのアクセス許可を一度に有効にすることができます。\n\n### サンドボックスを使用する\n\nサンドボックスを使用して、アクセスできる Copilot を制限できます。 ローカル サンドボックスでは、CLI 自体はサンドボックス内で実行されません。代わりに、ユーザーの代わりに実行 Copilot CLI コマンドとツールが制限され、ファイルシステム、ネットワーク、システムの機能へのアクセスが制限されます。 ローカル サンドボックスを有効にするには、セッション内に「 `/sandbox enable` 」と入力します。\n\nまたは、クラウド サンドボックスを使用すると、 Copilot CLI セッション全体が分離された環境でリモートで実行されます。 クラウドで Copilot CLI セッションを開始するには、 `copilot ‑‑cloud`を実行します。 詳細については、「[クラウドサンドボックスとローカルサンドボックスについて GitHub Copilot](/ja/copilot/concepts/about-cloud-and-local-sandboxes)」を参照してください。\n\n### 推論の可視性を切り替える\n\nCtrl+キーを押して、応答の生成中にモデルの推論プロセスを表示または非表示にします。 この設定はセッション間で保持されるため、複雑な問題によって Copilot がどのように機能するかを確認できます。\n\n### 設定を変更する\n\nCopilot CLIスラッシュ コマンドを使用して、個人用の`/settings`設定を表示および変更できます。\n\n* `/settings`を実行して対話型の設定エディターを開きます。ここで、名前で設定を検索して編集できます。 設定を既定値に戻すには、設定の一覧で設定を強調表示し、Ctrl+キーを押します。\n* `/settings KEY VALUE`を実行して、CLI のプロンプト ボックスで設定を直接変更します。 KEY は設定の名前で、VALUE は設定する値です。 これは、スクリプトや、 `-p`で開始されたプログラム セッションでも機能します。\n* `/settings show KEY`を実行して、エディターを開かずに設定の現在の値をテキストとして表示します。\n\nほとんどの設定の変更は直ちに有効になります。 Copilot CLIを再起動する必要はありません。\n\n詳細については、「[\\`/settings\\` コマンドを使用して設定を変更する](/ja/copilot/how-tos/copilot-cli/customize-copilot/change-settings)」を参照してください。 使用可能な設定の完全な一覧については、 [GitHub Copilot CLI の構成ディレクトリ](/ja/copilot/reference/copilot-cli-reference/cli-config-dir-reference#configuration-file-settings) を参照してください。\n\n## 詳細情報\n\nCopilot CLIで使用できるコマンド ライン オプションとスラッシュ コマンドの完全な一覧については、次のいずれかの操作を行います。\n\n* 対話型セッションのプロンプト ボックスに「`?`」と入力します。\n* ターミナルに「`copilot help`」と入力します。\n\n詳細については、端末で次のいずれかの `copilot help` サブコマンドを使用してください。\n\n* **NDES 構成設定**:\n\n `copilot help config`\n\n* \\*\\*\\*\\*に影響するCopilot CLI:\n\n `copilot help environment`\n\n* **使用可能なログ レベル**:\n\n `copilot help logging`\n\n* ```\n ツールの使用を許可または拒否するための**アクセス許可**:\n ```\n\n `copilot help permissions`\n\n## フィードバック\n\nGitHub Copilot CLI についてフィードバックがある場合は、対話型セッションで `/feedback` スラッシュ コマンドを使い、いずれかのオプションを選んでお知らせください。 プライベート フィードバック アンケートに回答したり、バグ レポートを送信したり、新しい機能を提案したりできます。\n\n## 次のステップ\n\nCopilot CLI は、会話アシスタントとして動作し、質問に答え、対話形式でコードを記述するのに役立ちます。 チャット以外にも、 Copilot CLI では、より自律性の高いタスクを委任できるさまざまなエージェント モードがサポートされています。\n\nCopilot CLIのエージェントと連携して、作業の委任から結果の確認まで、完全なタスク ライフサイクルをサポートできます。\n\n* **タスクを自律的に委任**する: オートパイロット モードで Copilot CLI を実行し、各ステップで承認を必要とせずに複数ステップのタスクを完了します。 「[Copilotにタスクを委任](/ja/copilot/how-tos/copilot-cli/use-copilot-cli/delegate-tasks-to-cca)」を参照してください。\n* **カスタム エージェントの呼び出し**: コード レビュー、ドキュメント、セキュリティ監査など、特定のタスクに合わせて調整された特殊なエージェントを呼び出します。 「[カスタム エージェントの呼び出し](/ja/copilot/how-tos/copilot-cli/use-copilot-cli/invoke-custom-agents)」を参照してください。\n* **エージェントの誘導**: タスクの実行中にエージェントの動作をガイドして調整し、作業を追跡します。 [「AUTOTITLE」を](/ja/copilot/how-tos/copilot-cli/use-copilot-cli/steer-agents)参照してください。\n* **コード レビューを要求**する: Copilot CLI を使用して、コード変更の AI を活用したレビューを取得します。 「[を使用してコード レビューを要求する GitHub Copilot CLI](/ja/copilot/how-tos/copilot-cli/use-copilot-cli/agentic-code-review)」を参照してください。\n\n## 詳細については、次を参照してください。\n\n* [GitHub Copilot CLI のベスト プラクティス](/ja/copilot/how-tos/copilot-cli/cli-best-practices)\n* [GITHUB COPILOT CLI コマンド リファレンス](/ja/copilot/reference/copilot-cli-reference/cli-command-reference)\n* [GitHub Copilot CLI の構成ディレクトリ](/ja/copilot/reference/copilot-cli-reference/cli-config-dir-reference)\n* [Copilot CLI ACP サーバー](/ja/copilot/reference/copilot-cli-reference/acp-server)"}