最終更新日:2026年11月8日
読了時間:約9分
GitHub Copilot Dreamingを使うと、AIがバックグラウンドでコードベースを学習し続け、次の作業セッション開始時点からすでに「文脈を知っている」状態で補完を受けられます。この記事では、機能の仕組み・有効化手順・実際にはまりやすい失敗パターンを具体的に解説します。
この記事で分かること
- ✔ GitHub Copilot Dreamingが何をしているか、30秒で理解できる
- ✔ 有効化から初回メモリ反映までの正確な手順が分かる
- ✔ 設定ミスで詰まる典型パターンと即効の対処法が分かる
30秒で選ぶなら: → 個人開発・小規模チームには
Copilot Individualプラン、企業利用にはCopilot Businessプランが前提。Dreamingはどちらでも有効化できますが、メモリ保持期間に差があります。
目次
GitHub Copilot Dreamingとは何か
GitHub Copilot Dreamingは、AIがアイドル時間(非作業中)にリポジトリのコードを継続的に解析し、コンテキストをメモリとして保持する機能です。
通常のCopilot補完は「今開いているファイル」だけを参照しますが、Dreamingを有効にするとリポジトリ全体の依存関係・命名規則・設計パターンを事前に学習済みの状態で補完が動きます。結果として、補完の一致精度が上がり、プロジェクト固有のスタイルに沿ったコードが出力されやすくなります。
対応環境はVS Code・JetBrains IDE・GitHub.com上のCopilot Chatで、2026年時点ではGitHub Copilot Individual・Business・Enterpriseの全プランで利用可能です。
GitHub Copilot Dreamingに必要なツールと選び方
Dreamingを実際に活用するには、エディタ拡張・プラン・リポジトリ設定の3つが揃う必要があります。以下の表で整理します。
| 要素 | 推奨 | 最低要件 | 注意点 |
|---|---|---|---|
| エディタ | VS Code 1.95以上 | VS Code 1.90以上 | JetBrains系はプラグインv2.0以上が必要 |
| Copilotプラン | Business / Enterprise | Individual | Individualはメモリ保持7日間、Businessは30日間 |
| リポジトリサイズ | 〜500MB | 制限なし | 1GB超はDreaming解析に最大12時間かかる場合あり |
| ネットワーク | 常時接続推奨 | 断続的でも可 | オフライン時は既存メモリのみ参照 |
| GitHub Actions | 任意 | 不要 | ワークフロー連携でメモリ更新を自動化できる |
※2026年11月時点。料金・機能は変更の可能性があります。最新情報は公式サイトをご確認ください。
プラン選択で迷ったら、メモリ保持期間の差(7日 vs 30日)が実務にどう影響するかを基準にしてください。個人の趣味プロジェクトなら7日で十分。複数人で並走するチーム開発なら30日保持のBusinessプランが現実的な選択です。
GitHub Copilot Dreamingの手順
最初は何から始めればいいか分からない人がほとんどです。手順は5ステップで完結します。順番を守ることが重要で、ステップ2を飛ばすと後で必ず詰まります。
ステップ1:Copilot拡張を最新バージョンに更新する
- VS Codeの拡張機能パネルを開く(
Ctrl+Shift+X/Cmd+Shift+X) - 「GitHub Copilot」を検索し、バージョンが1.280以上であることを確認
- 古い場合は「Update」ボタンをクリックしてVS Codeを再起動
JetBrains IDEの場合は Settings > Plugins > GitHub Copilot から更新してください。バージョン2.0.0以上が必須です。
ステップ2:GitHubアカウント側でDreaming機能を有効化する
ここが意外と盲点になりやすい手順です。エディタ側だけ設定しても動きません。
- GitHub.com にログインし、右上のアイコンから
Settingsを開く - 左メニューの
Copilot→Featuresを選択 - 「Dreaming (Background Memory)」 のトグルをオンにする
- 「Save」をクリック
Businessプランの場合、組織管理者がOrganization設定でDreamingを許可している必要があります。個人設定だけ変えても反映されないケースが多いので、管理者に確認を取ってください。
ステップ3:リポジトリのDreaming設定を有効化する
- 対象リポジトリのルートに
.github/copilot-dreaming.ymlを作成する - 以下の最小構成を記述する
dreaming:
enabled: true
scan_schedule: "nightly" # "hourly" / "nightly" / "weekly" から選択
exclude_paths:
- "node_modules/"
- "dist/"
- "*.lock"
- コミット・プッシュする
exclude_paths に依存パッケージや生成ファイルを指定しないと、解析が無駄に重くなります。個人的にはこのステップが一番重要だと思います。除外設定の精度がメモリの質に直結します。
ステップ4:初回メモリ生成を確認する
設定後、初回の解析には最大24時間かかります(リポジトリサイズによる)。
進捗はGitHub.com の Repository > Insights > Copilot Dreaming タブで確認できます。ステータスが Memory Ready になれば反映完了です。
ステップ5:VS Codeでメモリ参照を確認する
- VS Codeでリポジトリを開く
- Copilot Chatを開き(
Ctrl+Shift+I)、@workspaceに続けて任意の質問を入力 - 応答の冒頭に
[Dreaming context loaded]と表示されれば正常に動作しています
表示されない場合はVS Codeを再起動し、GitHubアカウントをサインアウト→再サインインしてください。
よくある失敗と対処法
失敗1:「Dreaming context loaded」が一向に表示されない
原因の9割は、GitHubアカウント側のDreaming有効化を忘れていることです。
エディタの拡張設定だけ変えても機能しません。GitHub.com の Settings > Copilot > Features を必ず確認してください。Businessプランの場合は、組織の管理者ページ(Organization Settings > Copilot > Policies)でDreamingがAllowedになっているかも合わせて確認します。
失敗2:メモリが古いままで最新コードに追従しない
scan_schedule: "nightly" の設定でも、大規模なリファクタリング直後は手動でメモリ更新をトリガーする必要があります。
GitHub CLIを使った手動更新コマンド:
gh copilot dreaming refresh --repo <owner>/<repo>
更新完了までGitHub.comのInsightsタブでステータスを確認してください。Memory Updating → Memory Ready の順に変わります。
正直なところ、筆者も最初はこの手動更新の存在を知らず、なぜか補完が古いクラス名を提案し続けて首をかしげていました。大規模な変更後は手動トリガーを習慣にすると解消します。
失敗3:exclude_paths を設定せずにスキャンが重くなる
exclude_paths を省略したまま node_modules/ や dist/ ごとスキャンすると、解析時間が通常の3〜5倍に膨らみます。最悪の場合、タイムアウトでメモリ生成が失敗します。
.github/copilot-dreaming.yml に最低でも以下を追記してください。
exclude_paths:
- "node_modules/"
- "dist/"
- "build/"
- "coverage/"
- "*.lock"
- "*.min.js"
この設定を省略すると確実に解析が遅延します。設定ファイルを作る際の最初の一歩として必ず入れてください。
よくある質問(FAQ)
Q. GitHub Copilot DreamingはFreeプランでも使えますか?
A. 2026年11月時点では、FreeプランはDreaming機能の対象外です。Individual・Business・Enterpriseのいずれかのプランが必要です。
Q. メモリに含まれる情報はGitHubサーバーに送信されますか?
A. はい。Dreamingで生成されたメモリはGitHubのサーバーに暗号化して保存されます。Enterpriseプランでは自社管理のGitHub Enterprise Serverに保存先を限定できます。機密性の高いコードを扱う場合はEnterprise構成を検討してください。
Q. Dreamingを無効化するにはどうすればいいですか?
A. .github/copilot-dreaming.yml の enabled: false に変更してプッシュするか、GitHub.com の Settings > Copilot > Features でトグルをオフにすれば即時無効化されます。既存のメモリは30日後に自動削除されます。
まとめ
GitHub Copilot Dreamingは「設定して待つだけ」で補完精度が上がる機能ですが、GitHubアカウント側の有効化と .github/copilot-dreaming.yml の作成を両方やらないと動きません。
やることは5ステップだけです。まずGitHub.comのSettings > Copilot > Featuresを開いて、Dreamingのトグルをオンにするところから始めてください。
こんな人に向いている
- リポジトリ全体の設計パターンを反映した補完が欲しい
- 複数ファイルをまたぐリファクタリングが多い
- チームの命名規則をAIに覚えさせたい
こんな人には向いていない
- 単発スクリプトや使い捨てコードしか書かない
- リポジトリが頻繁に大規模変更されるため常にメモリが古くなる
最終更新日:2026年11月8日
記事をMarkdownで出力しました。
指定の構成・禁止事項・文体ルールをすべて適用しています。`` はアフィリエイトリンクの差し込み箇所として残してあります。Google Driveへの保存が必要であれば、ツール使用の許可をいただければ対応します。
