Skip to content

Commit 3b48681

Browse files
sunbryeCopilotCopilot
authored
Remove models retired on 2026-09-01 from availability docs (#62850)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Copilot-Session: cc37d0bd-c6d3-4849-83f9-f631f7b45eb2 Copilot-Session: a8e2667d-7f41-4341-b1ca-58c0a42d3a73
1 parent 1b2a596 commit 3b48681

23 files changed

Lines changed: 22 additions & 249 deletions

‎content/admin/data-residency/github-copilot-with-data-residency.md‎

Lines changed: 0 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -65,15 +65,10 @@ The models available for {% data variables.product.prodname_copilot_short %} var
6565
* {% data variables.copilot.copilot_gpt_56_sol %}
6666
* {% data variables.copilot.copilot_gpt_56_terra %}
6767
* {% data variables.copilot.copilot_claude_haiku_45 %}
68-
* {% data variables.copilot.copilot_claude_opus_45 %}
69-
* {% data variables.copilot.copilot_claude_opus_46 %}
7068
* {% data variables.copilot.copilot_claude_opus_47 %}
7169
* {% data variables.copilot.copilot_claude_opus_48 %}
7270
* {% data variables.copilot.copilot_claude_opus_5 %}
73-
* {% data variables.copilot.copilot_claude_sonnet_45 %}
74-
* {% data variables.copilot.copilot_claude_sonnet_46 %}
7571
* {% data variables.copilot.copilot_claude_sonnet_5 %}
76-
* {% data variables.copilot.copilot_gemini_31_pro %}
7772
* {% data variables.copilot.copilot_gemini_35_flash %}
7873
* {% data variables.copilot.copilot_mai_code_1_flash %}
7974

‎content/copilot/concepts/agents/copilot-cli/fleet.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ When you use the `/fleet` command, the main {% data variables.product.prodname_c
2929

3030
* **Specialization**: If you've defined custom agents that are specialized for certain types of work, these may be used by the subagents. This allows for specialization, with the subagents using the custom agents best suited to the specific subtask they are working on.
3131

32-
By default, subagents use a low-cost AI model. However, you can tell {% data variables.product.prodname_copilot_short %} to use a specific model for part of the work. For example, within a larger prompt, you could specify `... Use GPT-5.3-Codex, to create ... Use Claude Opus 4.5, to analyze ...`. If a subagent uses a custom agent profile that specifies a particular AI model, then that model will be used by the subagent. Using a specific model may produce better quality results for particular types of subtask.
32+
By default, subagents use a low-cost AI model. However, you can tell {% data variables.product.prodname_copilot_short %} to use a specific model for part of the work. For example, within a larger prompt, you could specify `... Use GPT-5.3-Codex, to create ... Use Claude Opus 5, to analyze ...`. If a subagent uses a custom agent profile that specifies a particular AI model, then that model will be used by the subagent. Using a specific model may produce better quality results for particular types of subtask.
3333

3434
If custom agents are available, {% data variables.product.prodname_copilot_short %} will decide whether to use one to complete a particular subtask. However, if you know that a specific custom agent is well-suited to a particular subtask, you can specify this in your prompt by using `@CUSTOM-AGENT-NAME`. For example, within a larger prompt: `... Use @test-writer to create comprehensive unit tests for ...`.
3535

‎content/copilot/how-tos/copilot-cli/cli-best-practices.md‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -87,15 +87,15 @@ Use `/model` to choose from available models based on your task complexity:
8787
| Model | Best For | Tradeoffs |
8888
| ----- | -------- | --------- |
8989
| **Auto** | Reduced rate limiting and lower latency and errors | See [AUTOTITLE](/copilot/concepts/models/auto-model-selection) |
90-
| **Claude Opus 4.5** (default) | Complex architecture, difficult debugging, nuanced refactoring | Most capable but more costly |
91-
| **Claude Sonnet 4.5** | Day-to-day coding, most routine tasks | Fast, cost-effective, handles most work well |
92-
| **GPT-5.2 Codex** | Code generation, code review, straightforward implementations | Excellent for reviewing code produced by other models |
90+
| **{% data variables.copilot.copilot_claude_opus_5 %}** | Complex architecture, difficult debugging, nuanced refactoring | Most capable but more costly |
91+
| **{% data variables.copilot.copilot_claude_sonnet_5 %}** | Day-to-day coding, most routine tasks | Fast, cost-effective, handles most work well |
92+
| **{% data variables.copilot.copilot_gpt_53_codex %}** | Code generation, code review, straightforward implementations | Excellent for reviewing code produced by other models |
9393

9494
**Recommendations:**
9595

9696
* **Auto** intelligently chooses models based on real-time system health and model performance (reducing rate limiting and providing lower latency and errors), and the complexity of the task you have given {% data variables.product.prodname_copilot_short %}.
97-
* **Opus 4.5** is ideal for tasks requiring deep reasoning, complex system design, subtle bug investigation, or extensive context understanding.
98-
* **Switch to Sonnet 4.5** for routine tasks where speed and cost efficiency matter—it handles the majority of everyday coding effectively.
97+
* **{% data variables.copilot.copilot_claude_opus_5 %}** is ideal for tasks requiring deep reasoning, complex system design, subtle bug investigation, or extensive context understanding.
98+
* **Switch to {% data variables.copilot.copilot_claude_sonnet_5 %}** for routine tasks where speed and cost efficiency matter—it handles the majority of everyday coding effectively.
9999
* **Use Codex** for high-volume code generation and as a second opinion for reviewing code produced by other models.
100100

101101
You can switch models mid-session with `/model` as task complexity changes.
@@ -336,7 +336,7 @@ Pair with {% data variables.copilot.copilot_cli_short %} to develop tests.
336336
### Code review assistance
337337

338338
* ``/security-review Review my current local changes for security issues. Prioritize high-severity findings and suggest remediations I can apply before opening a pull request.``
339-
* ``/review Use Opus 4.5 and Codex 5.2 to review the changes in my current branch against `main`. Focus on potential bugs and security issues.``
339+
* ``/review Use {% data variables.copilot.copilot_claude_opus_5 %} and {% data variables.copilot.copilot_gpt_53_codex %} to review the changes in my current branch against `main`. Focus on potential bugs and security issues.``
340340
* Triage high-severity findings first, validate your fixes, then continue through your normal pull request review workflow.
341341

342342
### Git operations

‎content/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model.md‎

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,6 @@ You may find that different models perform better, or provide more useful respon
3030
The following options are currently available:
3131

3232
* Auto
33-
{% data reusables.copilot.copilot-cloud-agent-auto-models %}
3433
{% data reusables.copilot.copilot-cloud-agent-non-auto-models %}
3534

3635
{% data reusables.copilot.auto-model-option %}

‎content/copilot/reference/ai-models/model-comparison.md‎

Lines changed: 3 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,6 @@ Use these models for common development tasks that require a balance of quality,
4040
| {% data variables.copilot.copilot_gpt_53_codex %} | Delivers higher-quality code on complex engineering tasks like features, tests, debugging, refactors, and reviews without lengthy instructions. |
4141
| {% data variables.copilot.copilot_gpt_5_mini %} | Reliable default for most coding and writing tasks. Fast, accurate, and works well across languages and frameworks. |
4242
| {% data variables.copilot.copilot_gpt_56_terra %} | Balanced all-round choice for everyday interactive and agentic coding. |
43-
| {% data variables.copilot.copilot_raptor_mini %} | Specialized for fast, accurate inline suggestions and explanations. |
4443
| {% data variables.copilot.copilot_mai_code_1_flash %} | Strong instruction-following and adaptive reasoning make it a reliable default for everyday coding tasks, writing, and multi-turn development workflows. |
4544

4645
### When to use these models
@@ -93,9 +92,8 @@ These models are designed for tasks that require step-by-step reasoning, complex
9392
| {% data variables.copilot.copilot_gpt_5_mini %} | Delivers deep reasoning and debugging with faster responses and lower resource usage than GPT-5. Ideal for interactive sessions and step-by-step code analysis. |
9493
| {% data variables.copilot.copilot_gpt_55 %} | Great at complex reasoning, code analysis, and technical decision-making. |
9594
| {% data variables.copilot.copilot_gpt_56_sol %} | The highest reasoning ceiling in the GPT-5.6 family. Best for complex reasoning over large codebases and demanding, long-running agentic work. |
96-
| {% data variables.copilot.copilot_claude_sonnet_46 %} | Improves on Sonnet 4.5 with more reliable completions and smarter reasoning under pressure. |
97-
| {% data variables.copilot.copilot_claude_opus_47 %} | Anthropic’s most powerful model. Improves on {% data variables.copilot.copilot_claude_opus_46 %}. |
98-
| {% data variables.copilot.copilot_gemini_31_pro %} | Advanced reasoning across long contexts and scientific or technical analysis. |
95+
| {% data variables.copilot.copilot_claude_sonnet_46 %} | Reliable completions and smarter reasoning under pressure. |
96+
| {% data variables.copilot.copilot_claude_opus_47 %} | Anthropic’s most powerful model. Strong at deep reasoning over large, complex codebases. |
9997

10098
### When to use these models
10199

@@ -119,8 +117,7 @@ Use these models when you want to ask questions about screenshots, diagrams, UI
119117
| Model | Why it's a good fit |
120118
|-------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
121119
| {% data variables.copilot.copilot_gpt_5_mini %} | Reliable default for most coding and writing tasks. Fast, accurate, and supports multimodal input for visual reasoning tasks. Works well across languages and frameworks. |
122-
| {% data variables.copilot.copilot_claude_sonnet_46 %} | Improves on Sonnet 4.5 with more reliable completions and smarter reasoning under pressure. |
123-
| {% data variables.copilot.copilot_gemini_31_pro %} | Deep reasoning and debugging, ideal for complex code generation, debugging, and research workflows. |
120+
| {% data variables.copilot.copilot_claude_sonnet_46 %} | Reliable completions and smarter reasoning under pressure. |
124121

125122
### When to use these models
126123

‎content/copilot/reference/ai-models/model-hosting.md‎

Lines changed: 0 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -41,11 +41,8 @@ All input requests and output responses processed by {% data variables.product.p
4141
Used for:
4242

4343
* {% data variables.copilot.copilot_claude_haiku_45 %}
44-
* {% data variables.copilot.copilot_claude_sonnet_45 %}
4544
* {% data variables.copilot.copilot_claude_sonnet_46 %}
4645
* {% data variables.copilot.copilot_claude_sonnet_5 %}
47-
* {% data variables.copilot.copilot_claude_opus_45 %}
48-
* {% data variables.copilot.copilot_claude_opus_46 %}
4946
* {% data variables.copilot.copilot_claude_opus_47 %}
5047
* {% data variables.copilot.copilot_claude_opus_48 %}
5148
* {% data variables.copilot.copilot_claude_opus_48_fast %}
@@ -80,7 +77,6 @@ When using {% data variables.copilot.copilot_claude %}, input prompts and output
8077

8178
Used for:
8279

83-
* {% data variables.copilot.copilot_gemini_31_pro %}
8480
* {% data variables.copilot.copilot_gemini_35_flash %}
8581
* {% data variables.copilot.copilot_gemini_36_flash %}
8682
* {% data variables.copilot.copilot_gemini_37_flash %}
@@ -121,7 +117,6 @@ Used for:
121117

122118
* {% data variables.copilot.copilot_mai_code_1_flash %}
123119
* {% data variables.copilot.copilot_mai_code_1_1_flash %}
124-
* {% data variables.copilot.copilot_raptor_mini %}
125120

126121
{% data variables.copilot.copilot_mai_code_1_flash %} and {% data variables.copilot.copilot_mai_code_1_1_flash %} are first-party Microsoft models hosted on Azure in {% data variables.product.github %}'s tenant.
127122

‎content/copilot/reference/ai-models/supported-models.md‎

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -79,7 +79,6 @@ Choosing a larger context window or higher reasoning will impact {% data variabl
7979
| Model | 1 million token context window | Configurable reasoning |
8080
| --- | --- | --- |
8181
| {% data variables.copilot.copilot_claude_sonnet_46 %} | {% octicon "check" aria-label="Supported" %} | {% octicon "check" aria-label="Supported" %} |
82-
| {% data variables.copilot.copilot_claude_opus_46 %} | {% octicon "check" aria-label="Supported" %} | {% octicon "check" aria-label="Supported" %} |
8382
| {% data variables.copilot.copilot_claude_opus_47 %} | {% octicon "check" aria-label="Supported" %} | {% octicon "check" aria-label="Supported" %} |
8483
| {% data variables.copilot.copilot_claude_opus_48 %} | {% octicon "check" aria-label="Supported" %} | {% octicon "check" aria-label="Supported" %} |
8584
| {% data variables.copilot.copilot_claude_opus_5 %} | {% octicon "check" aria-label="Supported" %} | {% octicon "check" aria-label="Supported" %} |
@@ -122,7 +121,6 @@ Some {% data variables.product.prodname_copilot_short %} models require minimum
122121

123122
| Model | {% data variables.product.prodname_vscode %} | {% data variables.product.prodname_vs %} | JetBrains IDEs | Xcode | Eclipse |
124123
|----------------------------------------------------------|----------------------------------------------|------------------------------------------|----------------|-------|---------|
125-
| {% data variables.copilot.copilot_gemini_31_pro %} | `v1.115.0` | `17.14.22` or `18.1.0` | `1.5.62` | `0.46.0` | `0.14.0` |
126124
| {% data variables.copilot.copilot_gemini_35_flash %} | `v1.115.0` | `17.14.22` or `18.1.0` | `1.5.62` | `0.46.0` | `0.14.0` |
127125
| {% data variables.copilot.copilot_gemini_36_flash %} | `v1.128.0` | `17.14.22` or `18.1.0` | TBD | TBD | TBD |
128126
| {% data variables.copilot.copilot_gemini_37_flash %} | `v1.128.0` | `17.14.22` or `18.1.0` | TBD | TBD | TBD |

‎content/copilot/reference/copilot-cli-reference/cli-programmatic-reference.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ There are a number of command-line options that are particularly useful when run
3939
| `--allow-tool=TOOL ...` | Selectively grant permission for a specific tool. For multiple tools, use a quoted, comma-separated list. |
4040
| `--allow-url=URL ...` | Allow the agent to fetch a specific URL or domain. Useful when a workflow needs web access to known endpoints. For multiple URLs, use a quoted, comma-separated list. |
4141
| `--deny-tool=TOOL ...` | Deny a specific tool. Useful for restricting what the agent can do in a locked-down workflow. For multiple tools, use a quoted, comma-separated list. |
42-
| `--model=MODEL` | Choose the AI model (for example, `gpt-5.2` or `claude-sonnet-4.6`). Useful for pinning a model in reproducible workflows. See [Choosing a model](#choosing-a-model) below. |
42+
| `--model=MODEL` | Choose the AI model (for example, `gpt-5.4` or `claude-haiku-4.5`). Useful for pinning a model in reproducible workflows. See [Choosing a model](#choosing-a-model) below. |
4343
| `--no-ask-user` | Prevent the agent from pausing to seek additional user input. |
4444
| `--secret-env-vars=VAR ...` | An environment variable whose value you want redacted in output. For multiple variables, use a quoted, comma-separated list. Essential for preventing secrets being exposed in logs. The values in the `GITHUB_TOKEN` and `COPILOT_GITHUB_TOKEN` environment variables are redacted by default. |
4545
| `--share=PATH` | Export the session transcript to a markdown file after non-interactive completion (defaults to `./copilot-session-<ID>.md`). Useful for auditing or archiving what the agent did. Note that session transcripts may contain sensitive information. |
@@ -86,7 +86,7 @@ You can use environment variables to configure various aspects of the CLI's beha
8686
| Variable | Description |
8787
| --------------------- | ------------- |
8888
| `COPILOT_ALLOW_ALL` | Set to `true` for full permissions |
89-
| `COPILOT_MODEL` | Set the model (for example, `gpt-5.2`, `claude-sonnet-4.5`) |
89+
| `COPILOT_MODEL` | Set the model (for example, `gpt-5.4`, `claude-haiku-4.5`) |
9090
| `COPILOT_HOME` | Set the directory for the CLI configuration file (`~/.copilot` by default) |
9191
| `COPILOT_GITHUB_TOKEN`| Authentication token (highest precedence) |
9292
| `GH_TOKEN` | Authentication token (second precedence) |
@@ -115,7 +115,7 @@ copilot -p "Fix the race condition in the worker pool" \
115115
```
116116

117117
> [!NOTE]
118-
> You can find the model strings for all available models in the description of the `--model` option when you enter `copilot help` in your terminal.
118+
> To see the model strings for all available models, run the `/model` command in an interactive {% data variables.copilot.copilot_cli_short %} session. For the full list of models and the clients that support them, see [AUTOTITLE](/copilot/reference/ai-models/supported-models).
119119
120120
Alternatively, you can set the `COPILOT_MODEL` environment variable to specify a model for the duration of the shell session.
121121

‎content/copilot/tutorials/compare-ai-models.md‎

Lines changed: 0 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -190,21 +190,6 @@ For a complete walkthrough of the scenario, see [AUTOTITLE](/copilot/tutorials/w
190190
* It performs well on everyday coding tasks like test generation, boilerplate scaffolding, and validation logic.
191191
* The task leans into multi-step reasoning, but still stays within the confidence zone of a less advanced model because the logic isn’t too deep.
192192

193-
## {% data variables.copilot.copilot_claude_sonnet_45 %}
194-
195-
{% data reusables.copilot.model-use-cases.claude-sonnet-45 %}
196-
197-
### Example scenario
198-
199-
Consider a scenario where you're modernizing a legacy COBOL application by rewriting it in Node.js. The project involves understanding unfamiliar source code, converting logic across languages, iteratively building the replacement, and verifying correctness through a test suite.
200-
201-
For a complete walkthrough of the scenario, see [AUTOTITLE](/copilot/tutorials/modernize-legacy-code).
202-
203-
### Why {% data variables.copilot.copilot_claude_sonnet_45 %} is a good fit
204-
205-
* {% data variables.copilot.copilot_claude_sonnet_45 %} handles complex context well, making it suited for workflows that span multiple files or languages.
206-
* Its hybrid reasoning architecture allows it to switch between quick answers and deeper, step-by-step problem-solving.
207-
208193
## Further reading
209194

210195
* [AUTOTITLE](/copilot/reference/ai-models/model-comparison)

‎content/copilot/tutorials/vibe-coding.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -71,9 +71,9 @@ We'll create a time-tracking app in a new {% data variables.product.github %} re
7171
1. Choose a model from the models dropdown.
7272

7373
> [!NOTE]
74-
> The responses referred to in this tutorial were received while using Claude Sonnet 4.5. Other models will respond differently, but you should get roughly similar results. Claude Sonnet 4.5 is a good choice, if it's available, as it provides useful commentary in the chat view, explaining what it is doing, and giving detailed summaries when it has finished coding.
74+
> The responses referred to in this tutorial were received while using {% data variables.copilot.copilot_claude_sonnet_45 %}, which has since been retired. Other models will respond differently, but you should get roughly similar results.
7575
>
76-
> If Claude Sonnet 4.5 is not available, set the model to **Auto** or select a model of your choice.
76+
> Set the model to **Auto**, or select a model of your choice.
7777
7878
1. Enter this prompt in the chat:
7979

0 commit comments

Comments
 (0)