CLAUDE.md vs GitHub Copilot custom instructions
CLAUDE.md vs GitHub Copilot custom instructions: side-by-side comparison of two file-backed / editor paradigms systems — architecture, taxonomy, license, pricing, MCP/A2A support, and direct edges.
CLAUDE.md · GitHub Copilot custom instructions
Cost & capability
| CLAUDE.md | GitHub Copilot custom instructions | |
|---|---|---|
| Cost tier | — | mid |
| Use cases | Code Generation Focused, Scoped Agentic, Long Running Session | Code Generation Focused, Scoped Agentic |
Where they differ (4)
Rows where both sides have data and the values disagree — the shortlist of dimensions that actually distinguish these two systems.
| CLAUDE.md | GitHub Copilot custom instructions | |
|---|---|---|
| Use cases | Code Generation Focused, Scoped Agentic, Long Running Session | Code Generation Focused, Scoped Agentic |
| Type | Git-backed persistent instructions | .github/copilot-instructions.md + path-scoped |
| Created | 2024-10 (first appeared in Claude Code public release; Claude Code beta May 2024; GA Oct 2024) | 2024 (public preview launched October 2024 in VS Code; .github/copilot-instructions.md format) |
| Backend storage | file (CLAUDE.md) | file (.github/copilot-instructions.md) |
At a glance
| CLAUDE.md | GitHub Copilot custom instructions | |
|---|---|---|
| Section | File-backed / editor paradigms | File-backed / editor paradigms |
| Tier | T1 | T1 |
| Type | Git-backed persistent instructions | .github/copilot-instructions.md + path-scoped |
| Created | 2024-10 (first appeared in Claude Code public release; Claude Code beta May 2024; GA Oct 2024) | 2024 (public preview launched October 2024 in VS Code; .github/copilot-instructions.md format) |
| GitHub | — | 0★ no data — repo unreachable |
| Backend storage | file (CLAUDE.md) | file (.github/copilot-instructions.md) |
| Multi-tenancy | — | hard-isolation (per repo/org) |
| Optimised for | simplicity / git-versioned / human-readable | simplicity / git-versioned / human-readable |
| Anti-fit | not for non-coding / non-IDE use cases | not for non-coding / non-IDE use cases |
Taxonomy
| Axis | CLAUDE.md | GitHub Copilot custom instructions |
|---|---|---|
| storage | file | file |
| retrieval | injection | injection |
| persistence | cross-session | cross-session |
| update | overwrite | overwrite |
| unit | document | document |
| governance | user-controllable | user-controllable |
| conflict | manual | manual |
Pros & cons
CLAUDE.md
Pros: Plain-text + git-versioned + human-reviewable — the highest-trust memory format with zero infra; works in any editor or terminal.
Cons: Manual curation required; doesn't scale beyond ~10–20 KB before context bloat; no semantic recall, only injection-by-default.
GitHub Copilot custom instructions
Pros: Reaches the largest installed base of AI-using developers; integrated where developers already work; backed by GitHub's persistence.
Cons: Repository-scoped instructions only — no persistent learning; less expressive than Cursor Rules' selector model.