GitHub Copilot CLIの使い方|ターミナルでAIコーディング
GitHub Copilot CLIを使うと、エディタを開かなくてもターミナルだけでAIにコードの調査・編集・コマンド実行を任せられます。この記事では、インストールから認証、対話モードでの基本操作、承認フローの仕組みまでを順を追って解説します。読み終える頃には、自分のプロジェクトでCopilot CLIをすぐに使い始められる状態になります。
GitHub Copilot CLIとは
GitHub Copilot CLIは、エディタの補完機能として知られるGitHub Copilotとは異なり、ターミナル上で動作するエージェント型のツールです。copilotコマンドを実行すると対話セッションが起動し、自然言語で指示するだけでファイルの読み書き、コードの修正、シェルコマンドの実行までを自律的にこなします。コードエディタとブラウザを行き来せず、ターミナルに閉じたままAIとやり取りできる点が最大の特徴です。
前提・動作環境
Copilot CLIを使うには、以下の環境が必要です。
- Node.js 22以上(npmでインストールする場合)
- GitHubアカウントと、Copilotを利用できるプラン(Copilot Pro/Business/Enterprise等)
- Windows・macOS・Linuxに対応
料金プランや利用上限は変更されることがあるため、最新情報は公式サイトで確認してください。
インストール方法
インストール方法はOS・環境ごとに複数用意されています。npmを使う場合は、クロスプラットフォームで以下のコマンド一つで導入できます。
npm install -g @github/copilot
Windowsであれば、WinGetからも直接インストールできます。
winget install GitHub.Copilot
macOS・LinuxでHomebrewを使っている場合は次のとおりです。
brew install --cask copilot-cli
インストール後、バージョンを確認しておくと安心です。
copilot --version
認証方法(ログイン)
インストールが済んだら、作業したいプロジェクトのディレクトリでcopilotコマンドを実行してセッションを起動します。
copilot
初回起動時はGitHubアカウントにログインしていない状態なので、セッション内で/loginコマンドを入力します。表示されるワンタイムコードをもとにブラウザ側で認証を完了させれば、ターミナルに戻ったときには利用可能な状態になっています。認証後は、そのプロジェクトフォルダを信頼するかどうかの確認が表示されるので、「今回のみ」「今後も記憶」のいずれかを選んで進めます。
基本的な使い方(対話モード)
ログインが終わったら、そのままプロンプトを入力するだけで作業を依頼できます。たとえば次のように入力すると、プロジェクトの概要を調べて説明してくれます。
Give me an overview of this project.
対話中に使える主なショートカットは以下のとおりです。
@: ファイルをコンテキストとして指定する/: スラッシュコマンド一覧を表示する/help: 使えるコマンドの一覧を確認する
ファイルの編集やコマンド実行が必要な場面では、実行前に必ず確認が入ります。Copilotはユーザーの明示的な承認なしにファイルを変更したりコマンドを実行したりしません。確認時には「今回だけ許可」「このセッション中は同じ操作を自動承認」「拒否して別の方法を指示」の3択が表示されるため、内容を確認してから選択しましょう。
エディタを介さず1回だけ質問したい場合は、非対話モードも使えます。
copilot -p "In Git, how can I apply a commit from another branch"
対話モードのより詳しい操作やコマンド一覧は、Copilot CLIの使い方完全ガイドでまとめて解説しています。
Claude Code・Codex CLIとの位置づけの違い
ターミナルで動くエージェント型AIツールとしては、AnthropicのClaude CodeやOpenAIのCodex CLIも存在し、それぞれ対話モデルや承認フロー、対応エコシステムに違いがあります。Copilot CLIはGitHubのエコシステム(Issue・PR・Actionsなど)との親和性が強みで、既存のCopilotサブスクリプションをそのまま活用できる点が特徴です。両者の細かな機能差や使い分けについては、Copilot CLIとCodex CLIの比較記事で詳しく取り上げています。
使いどころと注意点
Copilot CLIは、リポジトリ内の複数ファイルを横断した調査や、定型的なリファクタリング、コミット前のコード確認などに向いています。一方で、破壊的な操作を伴うタスクでは慎重な運用が求められます。信頼できる自動化環境で全操作を一括承認したい場合は--allow-all(または--yolo)フラグが用意されていますが、本番環境や共有リポジトリではこのフラグの使用を避け、都度内容を確認する運用にするのが安全です。
つまずきポイント/よくあるエラー
copilotコマンドが見つからない: npmのグローバルインストール先にPATHが通っていないことが多いです。npm install -g @github/copilot実行後にターミナルを再起動するか、npm config get prefixで確認したパスをPATHに追加してください。/login後もログイン状態にならない: ブラウザでの認証コード入力を完了する前にターミナル側がタイムアウトしているケースがあります。再度/loginを実行し、表示されたコードをすぐに入力しましょう。- 承認プロンプトが何度も出る: 「Yes」の1回承認は同じ操作でも次回また確認が入る仕様です。同一セッション中に繰り返す作業であれば、「セッション中は自動承認」を選ぶと手間が減ります。
- 意図しないコマンドが実行されそうになる: 提案内容に不安がある場合は「No, and tell Copilot what to do differently」を選び、やり直しの指示を出すことができます。迷ったら承認せずに内容を聞き直すのが安全な使い方です。
よくある質問
Copilot CLIと従来のエディタ拡張のCopilotは何が違いますか
エディタ拡張のCopilotは主にコード補完やチャットによる支援が中心ですが、Copilot CLIはターミナル上でファイル編集やコマンド実行までを自律的に行うエージェント型ツールです。用途が異なるため、両方を併用している開発者も多くいます。
無料で使えますか
Copilot CLIの利用にはGitHub Copilotの有効なプランが必要です。料金体系やプランごとの利用範囲は変更される可能性があるため、契約前に公式サイトで最新情報を確認してください。
gh copilot拡張機能との違いは何ですか
gh copilotはGitHub CLI(gh)のサブコマンドとしてコマンド提案・説明を行う拡張機能でしたが、Copilot CLIは独立したcopilotコマンドとして提供される、対話・自律実行が可能なエージェント型ツールです。現在新規に使い始める場合は、本記事で紹介したCopilot CLIが現行の主流です。
まとめ
GitHub Copilot CLIは、npm install -g @github/copilotなどでインストールし、/loginで認証すれば、その日のうちにターミナルからAIコーディングを始められます。ファイル変更やコマンド実行には必ず承認フローが挟まるため、安全性を保ちながら作業を任せられるのが安心できるポイントです。基本を押さえたら、使い方完全ガイドでより実践的なコマンド活用を、Copilotとは何かで機能全体の位置づけを、Codex CLIとの比較記事で他ツールとの使い分けを確認してみてください。