GitHub Copilot CLI GAリリースとOS別インストール手順・活用ガイド

Contents

1 Copilot CLI とは何か
2 公式ドキュメントへのリンク集
3 OS 別インストール手順と依存関係
4 GitHub アカウントでの認証フロー
5 基本コマンド構造と対話モード（Chat）
- 5.1 実用例
6 Plan・Autopilot モードの使い分け例
- 6.1 1. Plan（段階的タスク生成）
- 6.2 2. Autopilot（完全自動化）
7 カスタムエージェントと Hooks の活用方法
- 7.1 1. カスタムエージェント作成
- 7.2 2. Hooks（pre‑run / post‑run）による自動品質保証
8 料金体系・コストシミュレーション（2026‑04）
- 8.1 コストシミュレーション例
9 他ツールとの比較と MCP 連携ポイント
- 9.1 MCP（Marketplace Copilot Plugins）活用のベネフィット
10 まとめ & 次のステップ

スポンサードリンク

Copilot CLI とは何か

GitHub Copilot CLI は、ターミナルから直接 AI アシスタントに質問したり、コード生成・リファクタリングを自動化できる CLI ツールです。主な特徴は次のとおりです。

項目	内容
対象プラットフォーム	macOS、Windows、Linux（Ubuntu/Debian 系・RPM 系）
依存関係	Node.js ≥ 18、Git ≥ 2.30、GitHub CLI (`gh`) がインストール済みであること
認証基盤	`gh auth login` で取得したトークンを内部的に再利用
モード構成	`chat`（対話）、`plan`（段階的タスク生成・承認）、`autopilot`（完全自動）
拡張性	カスタムエージェント (`copilot agent create`) と Hooks (`.copilot/hooks/*`) によるプラグイン化

注意
現在は「プレビュー」版です。機能追加や CLI オプションの変更が行われる可能性があります。公式リリースノートは随時確認してください。

公式ドキュメントへのリンク集

内容	URL
Copilot CLI の概要とインストール手順（英語）	https://docs.github.com/en/copilot/getting-started-with-github-copilot/about-github-copilot-cli
日本語翻訳ドキュメント（公式）	https://docs.github.com/ja/copilot/getting-started-with-github-copilot/about-github-copilot-cli
認証・トークン管理ガイド	https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token
料金プラン（2026‑04 更新）	https://github.com/features/copilot#pricing
Marketplace の Copilot プラグイン一覧	https://github.com/marketplace?type=actions&query=copilot

OS 別インストール手順と依存関係

1. macOS（Homebrew 推奨）

# (1) Homebrew が未インストールの場合は先に導入
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# (2) 必要な依存パッケージを確認（Node と Git は Homebrew で管理）
brew install node git gh   # `gh` は GitHub CLI

# (3) Copilot CLI を拡張としてインストール
gh extension install github/copilot-cli

# (4) インストール確認
copilot version

# (1) Homebrew が未インストールの場合は先に導入

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# (2) 必要な依存パッケージを確認（Node と Git は Homebrew で管理）

brew install node git gh # `gh` は GitHub CLI

# (3) Copilot CLI を拡張としてインストール

gh extension install github/copilot-cli

# (4) インストール確認

copilot version

ポイント
- Homebrew で gh（GitHub CLI）を導入すると、Copilot CLI は自動的に gh copilot のサブコマンドとして有効になります。
- brew install gh-copilot といったパッケージは現在提供されていません。

2. Windows（PowerShell + npm）

手順	コマンド例	補足
1. Chocolatey (任意)で Node.js と Git をインストール	`choco install nodejs git`	管理者権限が必要
2. GitHub CLI (`gh`) のインストール	`winget install --id=GitHub.cli`	最新版を取得
3. Copilot CLI 拡張のインストール	`gh extension install github/copilot-cli`	PowerShell またはコマンドプロンプトで実行
4. バージョン確認	`copilot version`	正常に表示されれば完了

注意
Windows では npm i -g @githubnext/copilot-cli といったパッケージは公式には提供していません。必ず gh extension 経由で導入してください。

3. Linux（Ubuntu/Debian 系）

# (1) 必要パッケージのインストール
sudo apt update &amp;&amp; sudo apt install -y curl git nodejs npm gnupg

# (2) GitHub CLI の公式リポジトリを追加しインストール
curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg \
  | sudo gpg --dearmor -o /usr/share/keyrings/githubcli-archive-keyring.gpg

echo "deb &#91;arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" \
  | sudo tee /etc/apt/sources.list.d/github-cli.list &gt; /dev/null

sudo apt update &amp;&amp; sudo apt install -y gh

# (3) Copilot CLI 拡張をインストール
gh extension install github/copilot-cli

# (4) 動作確認
copilot version

# (1) 必要パッケージのインストール

sudo apt update && sudo apt install -y curl git nodejs npm gnupg

# (2) GitHub CLI の公式リポジトリを追加しインストール

curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg \

| sudo gpg --dearmor -o /usr/share/keyrings/githubcli-archive-keyring.gpg

echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" \

| sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null

sudo apt update && sudo apt install -y gh

# (3) Copilot CLI 拡張をインストール

gh extension install github/copilot-cli

# (4) 動作確認

copilot version

ポイント
- apt-key は非推奨のため、上記のキーリング方式を必ず使用してください。
- gh-copilot というパッケージ名は存在せず、拡張インストールが公式手順です。

GitHub アカウントでの認証フロー

GitHub CLI の認証

bash gh auth login

対話形式で「GitHub.com」 → 「HTTPS」 → 「ブラウザ」で認証を選択。
認証情報は ~/.config/gh/hosts.yml に保存され、Copilot CLI が自動的に参照します。
トークンのスコープ

Copilot CLI には以下のスコープが必要です（公式ドキュメント参照）。
- repo（プライベートリポジトリへのアクセス）
- read:org（組織情報の取得）
- user（ユーザー情報）

認証確認

bash copilot auth status # 認証済みかどうかを表示

トラブルシューティング
- copilot: error: authentication required が出た場合は、gh auth refresh -h github.com でトークンを再取得してください。

基本コマンド構造と対話モード（Chat）

構文	説明
`copilot <subcommand> [options]`	コア構文
`copilot chat "質問"`	1 行で即座に Chat モード起動
`copilot chat --file path/to/file.py`	ファイルコンテキストを付与して対話

実用例

# Python の関数最適化提案を取得
copilot chat "この関数のパフォーマンスを改善してください。"

# プロジェクト全体の依存関係ツリーを要約させる
copilot chat --file requirements.txt "依存関係の概要と潜在的な脆弱性を教えて"

# Python の関数最適化提案を取得

copilot chat "この関数のパフォーマンスを改善してください。"

# プロジェクト全体の依存関係ツリーを要約させる

copilot chat --file requirements.txt "依存関係の概要と潜在的な脆弱性を教えて"

オプション例

オプション	効果
`--model`	使用モデル（`gpt-4o`, `claude-3.5-sonnet` など）を明示
`--temperature <0‑2>`	出力のランダム性を調整
`--max-tokens <N>`	応答上限トークン数

Plan・Autopilot モードの使い分け例

1. Plan（段階的タスク生成）

# 大規模マイグレーションの計画を立案
copilot plan "Rails 7 にアップグレードする手順と注意点をリスト化してください"

# 大規模マイグレーションの計画を立案

copilot plan "Rails 7 にアップグレードする手順と注意点をリスト化してください"

出力は Task ID とともに箇条書きで提示されます。タスクごとにレビュー・承認が可能です。

# タスク 2 を自動実行（安全確認済みの場合）
copilot run --task 2 --yes

# タスク 3 は手動で確認しながら実行
copilot run --task 3   # デフォルトは対話モードで確認待ち

# タスク 2 を自動実行（安全確認済みの場合）

copilot run --task 2 --yes

# タスク 3 は手動で確認しながら実行

copilot run --task 3 # デフォルトは対話モードで確認待ち

2. Autopilot（完全自動化）

CI/CD パイプライン内での利用例です。

# .github/workflows/copilot-autopilot.yml
name: Copilot Autopilot

on:
  push:
    branches: &#91; main ]

jobs:
  generate-tests:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Set up Node
        uses: actions/setup-node@v4
        with:
          node-version: '20'
      - name: Install GitHub CLI &amp; Copilot CLI
        run: |
          curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg \
            | sudo gpg --dearmor -o /usr/share/keyrings/githubcli-archive-keyring.gpg
          echo "deb &#91;arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" |
            sudo tee /etc/apt/sources.list.d/github-cli.list &gt; /dev/null
          sudo apt update &amp;&amp; sudo apt install -y gh
          gh extension install github/copilot-cli
      - name: Authenticate GitHub CLI
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        run: |
          echo "$GITHUB_TOKEN" | gh auth login --with-token
      - name: Generate Jest テスト（Autopilot）
        run: copilot autopilot "プロジェクト全体の Jest ユニットテストを作成してください" --yes

# .github/workflows/copilot-autopilot.yml

name: Copilot Autopilot

on:

push:

branches: [ main ]

jobs:

generate-tests:

runs-on: ubuntu-latest

steps:

- uses: actions/checkout@v3

- name: Set up Node

uses: actions/setup-node@v4

with:

node-version: '20'

- name: Install GitHub CLI & Copilot CLI

run: |

curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg \

| sudo gpg --dearmor -o /usr/share/keyrings/githubcli-archive-keyring.gpg

echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" |

sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null

sudo apt update && sudo apt install -y gh

gh extension install github/copilot-cli

- name: Authenticate GitHub CLI

env:

GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

run: |

echo "$GITHUB_TOKEN" | gh auth login --with-token

- name: Generate Jest テスト（Autopilot）

run: copilot autopilot "プロジェクト全体の Jest ユニットテストを作成してください" --yes

安全対策
Autopilot では必ず --yes または --no を明示し、誤って本番コードを書き換えないようにしてください。

カスタムエージェントと Hooks の活用方法

1. カスタムエージェント作成

# agent.yml（例：Go 言語向け社内規約エージェント）
name: go-company-agent
description: 社内 Go コーディング規約に沿ったコード生成を支援
language: go
instructions:
  - "すべての関数はエラーハンドリングを必ず実装すること"
  - "import は標準ライブラリ → サードパーティ の順でソート"
  - "コメントは GoDoc スタイルに統一"

# agent.yml（例：Go 言語向け社内規約エージェント）

name: go-company-agent

description: 社内 Go コーディング規約に沿ったコード生成を支援

language: go

instructions:

- "すべての関数はエラーハンドリングを必ず実装すること"

- "import は標準ライブラリ → サードパーティの順でソート"

- "コメントは GoDoc スタイルに統一"

# エージェント作成コマンド
copilot agent create --config ./agent.yml

# 作成したエージェントをプロジェクトで有効化
copilot agent use go-company-agent

# エージェント作成コマンド

copilot agent create --config ./agent.yml

# 作成したエージェントをプロジェクトで有効化

copilot agent use go-company-agent

配布
エージェントは GitHub Packages のプライベートリポジトリに自動公開されます。組織メンバーは copilot agent install <owner>/<repo> で取得可能です。

2. Hooks（pre‑run / post‑run）による自動品質保証

プロジェクトルートに .copilot/hooks/ ディレクトリを作り、実行したいスクリプトを配置します。

# .copilot/hooks/pre-run.sh
#!/usr/bin/env bash
echo "=== Pre‑run Hook: eslint 実行 ==="
npm run lint --silent

# .copilot/hooks/post-run.sh
#!/usr/bin/env bash
echo "=== Post‑run Hook: ユニットテスト実行 ==="
npm test --silent

# .copilot/hooks/pre-run.sh

#!/usr/bin/env bash

echo "=== Pre‑run Hook: eslint 実行 ==="

npm run lint --silent

# .copilot/hooks/post-run.sh

#!/usr/bin/env bash

echo "=== Post‑run Hook: ユニットテスト実行 ==="

npm test --silent

chmod +x .copilot/hooks/*.sh   # 実行権限付与

1 2	chmod +x .copilot/hooks/*.sh # 実行権限付与

copilot run が呼び出されるたびに自動でフックが走り、コード生成 → Lint → テスト のパイプラインがターミナル上だけで完結します。

CI への組み込み例（GitHub Actions）

- name: Run Copilot with Hooks
  run: |
    copilot run --task 1   # pre‑run → generation → post‑run が自動実行

- name: Run Copilot with Hooks

run: |

copilot run --task 1 # pre‑run → generation → post‑run が自動実行

料金体系・コストシミュレーション（2026‑04）

プラン	月額 (USD)	無料トークン上限	主な機能
Free	$0	5,000 tokens / month	Chat モード、Plan の一部利用（トークン超過で制限）
Pro	$20	100,000 tokens / month	Autopilot フルアクセス、カスタムエージェント・Hooks、優先サポート
Enterprise	カスタム見積もり	無制限	SSO、プライベート Marketplace、オンプレミスデプロイ、専任アカウントマネージャー

トークンとは
Copilot CLI が内部で使用する「文字列単位」の課金対象。1 token ≈ 4 文字（英語）です。

コストシミュレーション例

チーム規模	月平均トークン使用量	推奨プラン	想定月額
3 人スタートアップ	30,000 tokens	Pro	$20
10 人開発チーム	85,000 tokens	Pro（上限内）	$20
50 人大規模組織	300,000 tokens	Enterprise (カスタム)	見積もり必要

ポイント
- Free プランはトークン上限を超えるとリクエストが失敗します。プロジェクトで継続的に利用する場合は必ず Pro 以上へのアップグレードをご検討ください。
- Enterprise は年間契約が前提で、オンプレミス環境向けのプライベートパッケージリポジトリも提供されます。

他ツールとの比較と MCP 連携ポイント

項目	GitHub Copilot CLI (MCP 統合)	Claude Code
配布形態	GitHub Marketplace のプラグインとして共有可能（MCP＝Marketplace Copilot Plugins）	独自プラットフォームでの限定公開
拡張性	`copilot agent create` + Hooks によるフルカスタマイズ	プロンプトベースの調整のみ
CI/CD 連携	GitHub Actions とシームレスに統合（公式アクション・テンプレートあり）	外部スクリプトで呼び出す必要がある
認証基盤	`gh auth login` のトークンを共通利用 → SSO も対応可能（Enterprise プラン）	独自 API キー管理
エコシステム	GitHub リポジトリ、Issue、Pull Request と直接連携できる	主にコード生成に特化し、外部連携は限定的

MCP（Marketplace Copilot Plugins）活用のベネフィット

社内プラグインの一元管理
社内専用エージェントや Hook スクリプトを Marketplace に公開 → 権限付与で組織メンバーだけが利用可能。
課金・認証の統合 |
Copilot CLI と同一サブスクリプションでプラグイン使用料がカバーされ、別途ライセンス管理が不要。
更新配布が自動
バージョンを上げて Marketplace にリリースすれば、利用者側は gh extension upgrade だけで最新に追従できる。

まとめ & 次のステップ

ステップ	内容
1️⃣ 環境構築	OS に合わせたインストール手順を実行し、`copilot version` が表示されることを確認。
2️⃣ 認証	`gh auth login` で GitHub アカウントに認証。`copilot auth status` で成功をチェック。
3️⃣ 基本操作体験	`copilot chat "Hello, world!"` で対話モードを試す。
4️⃣ プロジェクト適用	`plan` または `autopilot` を使い、実際のリファクタリングやテスト生成に挑戦。
5️⃣ カスタマイズ	社内規約に合わせたカスタムエージェントと Hooks を作成し、`.copilot/hooks/` に配置。
6️⃣ コスト管理	利用トークン数を GitHub の使用量レポートでモニタリングし、適切なプランへアップグレード。
7️⃣ 継続的改善	MCP で社内プラグインを共有、GitHub Actions に自動化フローを組み込み、定期的にドキュメントを更新。

公式情報の確認方法
- GitHub Docs: https://docs.github.com/（検索窓で “Copilot CLI”）
- 料金ページ: https://github.com/features/copilot#pricing
- リリースノート: https://github.com/github/copilot-cli/releases

このガイドをベースに、まずは ローカル環境で Chat モード を体感し、その後 Plan／Autopilot と カスタムエージェント に展開してみてください。
質問や不具合があれば、GitHub Discussions の Copilot CLI カテゴリか、社内の #copilot-cli Slack チャンネルで共有すると迅速に解決できます。

スポンサードリンク

GitHub Copilot CLI GAリリースとOS別インストール手順・活用ガイド

Copilot CLI とは何か

公式ドキュメントへのリンク集

OS 別インストール手順と依存関係

1. macOS（Homebrew 推奨）

2. Windows（PowerShell + npm）

3. Linux（Ubuntu/Debian 系）

GitHub アカウントでの認証フロー

基本コマンド構造と対話モード（Chat）

実用例

Plan・Autopilot モードの使い分け例

1. Plan（段階的タスク生成）

2. Autopilot（完全自動化）

カスタムエージェントと Hooks の活用方法

1. カスタムエージェント作成

2. Hooks（pre‑run / post‑run）による自動品質保証

料金体系・コストシミュレーション（2026‑04）

コストシミュレーション例

他ツールとの比較と MCP 連携ポイント

MCP（Marketplace Copilot Plugins）活用のベネフィット

まとめ & 次のステップ

Copilot CLI とは何か