Getting Started

ワークショップの Part 0。 この章を終えると、Copilot CLI のインストールと認証が完了し、4 つの対話モードを理解し、設定がどこにあるかを把握できます。所要時間は約 45 分です。

まず動画で見たい方へ

公式動画 Ultimate GitHub Copilot CLI tutorial for beginners（GitHub）は、本章の内容（インストール、/login、フォルダの信頼、最初の対話プロンプトと -p プロンプト）を数分でデモし、続けてこのあと出てくるモードやスラッシュコマンドまで紹介します。各コンパニオン動画の内容は References → トーク・デモを参照してください。

前提条件

要件	補足
有効な GitHub Copilot サブスクリプション	API アクセスに必須。組織／Enterprise 管理者はポリシーで CLI を無効化できます（README）
対応 OS	Linux、macOS、Windows（PowerShell v6+ および WSL）（About Copilot CLI）
ターミナルと Git	どちらも使い慣れていること
（任意）Node.js	`npm` でインストールする場合のみ必要

Copilot CLI のインストール

以下の いずれか を選びます。4 つともすべて公式です（README、Installing GitHub Copilot CLI）。

# Install script (macOS / Linux)
curl -fsSL https://gh.io/copilot-install | bash

# Homebrew (macOS / Linux)
brew install copilot-cli

# WinGet (Windows)
winget install GitHub.Copilot

# npm (any platform; requires Node.js)
npm install -g @github/copilot

プレリリース機能を検証する必要がある場合は？ 各チャネルにプレリリース版があります: @github/copilot@prerelease、brew install copilot-cli@prerelease、winget install GitHub.Copilot.Prerelease（README）。プレリリースは、それを明示的に必要とする検証やデモに限定して使ってください。

インストールを確認します。

copilot --version

初回起動と信頼

CLI は 作業対象のコードが入ったフォルダの中 から起動します。ホームディレクトリからは起動しないでください（Security considerations）。

cd ~/projects/my-repo
copilot

初回起動ではアニメーションバナー（--banner でいつでも再表示）と、信頼ディレクトリの確認 が表示されます（Using Copilot CLI）。

1. Yes, proceed
2. Yes, and remember this folder for future sessions
3. No, exit (Esc)

信頼確認が重要な理由

セッション中、Copilot は起動ディレクトリ配下のファイルを読み取り・変更・実行する可能性があります。中身を信頼できる場所だけを信頼してください。ホームディレクトリや、信頼できない実行ファイル・機密情報を含むフォルダから 起動しないでください（Security considerations）。

認証

まだサインインしていない場合、CLI は /login の実行を促します。

対話: デバイスフロー（推奨）

> /login

ブラウザのフローに従います。トークンは自動的に保存され、セッションをまたいで再利用されます（README）。サインイン中の GitHub アカウントは /user でいつでも確認できます（CLI command reference）。

ヘッドレス／CI: Personal Access Token

非対話環境では、「Copilot Requests」 権限を付与した fine-grained PAT を使います（README）。

https://github.com/settings/personal-access-tokens/new でトークンを作成します。
Permissions で Copilot Requests を追加します。
環境変数で公開します。最近の CLI では、GH_TOKEN や GITHUB_TOKEN を使う他ツールとの衝突を避けるために COPILOT_GITHUB_TOKEN もサポートされています（copilot-cli changelog 0.0.354）。CI では COPILOT_GITHUB_TOKEN を優先してください。複数のトークン変数を同時に設定する場合は、copilot help environment で挙動を確認します。

export COPILOT_GITHUB_TOKEN="github_pat_xxxxxxxx"

このしくみは Demo 4 · CI/CD 自動化でそのまま使います。

主な対話モード

ワークショップで必要になるモードは次のとおりです。対話セッション内では Shift+Tab で ask/execute、plan、autopilot などのエージェントモードを切り替えます。programmatic モードはシェルから -p／--prompt で起動します（About Copilot CLI、Best practices）。

graph LR
    Ask["Ask / Execute<br/>(default)"] -->|Shift+Tab| Plan["Plan mode"]
    Plan -->|Shift+Tab| Auto["Autopilot<br/>(experimental)"]
    Auto -->|Shift+Tab| Ask

モード	内容	適した用途
Ask / Execute（既定）	対話的。ファイルを変更・実行するツールごとに承認を求める	学習、慎重を要する変更
Plan	リクエストを分析し、確認の質問をして、構造化された `plan.md` を書き、承認を待ってからコーディングする	複雑な複数ファイルの作業
Autopilot（experimental）	タスクが完了するまで自律的に作業を続ける	定型的でスコープが明確なタスク
Programmatic	`copilot -p "…"` でプロンプトを 1 回実行して終了する	スクリプト、CI/CD、自動化

experimental 機能（autopilot を含む）は --experimental または /experimental スラッシュコマンドで有効化します。設定は以後 config に永続化されます（README）。

# Programmatic example — summarize this week's commits
copilot -p "Show me this week's commits and summarize them" --allow-tool='shell(git)'

送信したプロンプトごとにプレミアムリクエストを 1 つ消費します（README）。

設定のレイヤーと優先順位

Copilot CLI は グローバル（あなた）と リポジトリ（プロジェクト）のソースから設定を合成し、その上に セッション フラグを重ねます。この階層の理解はデモの前提として重要です。

graph TD
    S["Session — highest priority<br/>--model, --experimental, /model, flags"] --> R["Repository<br/>.github/copilot-instructions.md<br/>.github/instructions/**/*.instructions.md<br/>AGENTS.md, .github/agents, .github/skills"]
    R --> G["Global — user level<br/>~/.copilot/settings.json<br/>~/.copilot/copilot-instructions.md<br/>~/.copilot/agents, mcp-config.json"]

押さえておくべき要点（Best practices、Using Copilot CLI）。

カスタム指示ファイルは優先フォールバックではなく結合されるようになりました。競合時はリポジトリの指示がグローバルより優先されます。
グローバル設定ディレクトリは ~/.copilot/ です（COPILOT_HOME 環境変数で上書き可能）。ユーザー設定は settings.json に保存され、MCP、LSP、エージェント、指示、セッション状態のファイルがその周辺に置かれます。.github/mcp.json のような新しいワークスペース設定ファイルは changelog で確認するのが確実です（copilot-cli changelog）。
設定は /settings で編集します。検索可能なダイアログを開くほか、/settings autoUpdate true のようなインライン設定や、既定値へのリセットに対応します（GitHub Blog Changelog: /settings）。

各レイヤーは Feature Deep Dive で詳しく解説します。

セットアップの検証

信頼済みのリポジトリ内で次のチェックリストを実行します。すべて動けばデモの準備完了です。

# 1. Confirm version & auth
copilot --version

# 2. Inside a session, list everything available
> /help

# 3. Confirm which GitHub account is signed in
> /user

# 4. See and switch models
> /model

# 5. Inspect context usage
> /context

# 6. Confirm the GitHub MCP server is wired up
> /mcp

コマンドはライブで発見する

製品は毎週変わります。コマンド一覧を暗記する代わりに、/help（セッション内）と copilot help <topic>（<topic> は config、commands、environment、logging、permissions のいずれか）を使いましょう（Best practices）。