Cursor changelog 大标题说已经支持某个新模型（比如 Claude Opus 4.7，或新出的某个 gpt-5-codex 变体），你打开 Composer 的模型选择器，却发现它不在列表里，或者列表里还是只有旧的几个。这不是你账号坏了。十有八九是这三种情况之一：桌面客户端版本落后、本地缓存的模型清单陈旧、或这个模型正在按订阅档 / 区域分批灰度，还没轮到你。
最快修法（多数人有效）：先升级到最新版 Cursor（截至 2026 年 6 月是 3.8 或更新），彻底退出再重开，然后打开 Cursor Settings → Models 点 Add Models 强制重新拉取一次。如果还是没有，那就是灰度或订阅档问题——直接跳到 Step 3。
为什么要点 “Add Models” 而不是只看下拉框：聊天里的模型下拉只显示你已经启用的模型。完整的、从服务器拉取的目录藏在 Cursor Settings → Models 的 Add Models 按钮后面。一个模型可能已经在目录里，但在你把它加进来之前，下拉框里就是看不到。
常见原因
1. Cursor 本地客户端版本太旧
新模型支持需要客户端代码配合（路由、参数、UI 标签），旧客户端根本不知道有这个模型。自动更新偶尔会悄悄失败（比你想的更常见），企业版还经常锁死版本。
如何判断：打开 Cursor → About Cursor 看版本号，和changelog对比。截至 2026 年 6 月最新版是 3.8（2026 年 6 月 18 日发布）。落后超过 2 个次版本，或者还停在 2.x 那条线上，就算旧。
2. 模型列表缓存未刷新
Settings → Models 是从 Cursor 后端拉取模型清单并在本地缓存的。即使刚升级完，缓存也可能继续提供旧列表，直到你用 Add Models（或重启）强制刷新一次。
如何判断：升级后重开还是旧列表，登出再登入也没用。这说明问题在缓存，而不是版本或订阅档。
3. 新模型按区域或订阅档灰度
新模型通常先上高档位（Pro / Pro+ / Ultra / Business），先上美国基础设施，再过几天逐步放给其他档位和区域。在这个窗口期内，你刷多少次都确实拿不到。
如何判断：去 forum.cursor.com 搜 <模型名> rollout，看是不是大家都在等。状态页上没有把”灰度”做成常驻组件，但它会记录最近的模型事故（比如 2026 年 6 月就有 Composer 2.5 性能下降、以及 “Elevated errors across many models on Anthropic” 的条目），所以可以去看有没有正在发生的模型问题。
4. 账号订阅档不含这个模型
某些模型或模式只对高档位开放——重型 Anthropic / OpenAI 模型的 Max mode、以及部分推理模型，可能只给 Business / Enterprise，Hobby 或 Pro 账号就看不到。还有少数模型只能通过自己的 API key（BYOK）访问。
如何判断：在 Cursor Settings → Account 看当前订阅档，再对照官方Models & Pricing 页面。注意：这个页面列了每个模型的 provider 和 token 价格，但已经不再印一栏按档位区分的 “Available on” 了，所以请在 App 内和定价页确认档位限制，别指望有一张整齐的对照矩阵。
5. BYOK 把列表过滤掉了
当你填了自己的 provider key，选择器只会显示这个 key 实际开放的模型。Cursor 自家的模型（Composer 系列）和只走 Cursor 路由的条目，在裸的 provider key 下不会出现。BYOK 还只解锁标准模型的 chat completions——Agent 和 Edit 依赖 Cursor 路由的 custom models，Tab 补全则完全不能走你的 key。
如何判断：在 Cursor Settings → Models 里，每个条目会标明它是走 Cursor 还是走你自己的 key。如果你加了 key 之后自家的 Composer 模型消失了，那就是 BYOK 过滤导致的。
6. 网络受限 / VPN
某些地区和公司网络会拦 Cursor 后端，客户端拉不到清单，就回退到一份极简的内置列表。
如何判断：打开 View → Output，在下拉里选 Cursor，看有没有拉取失败的日志（比如 “failed to fetch models” 或连接超时）。换个网络或关掉 VPN 再试。
先判断你属于哪一类
动手之前，先把症状对到最可能的原因上：
| 症状 | 最可能的原因 | 去看 |
|---|---|---|
| 还在 2.x 线上，或落后好几个版本 | 客户端太旧 | Step 1 |
| 升级重开后列表还是旧的 | 缓存没刷新 | Step 2 |
| 目录里有这个模型，但下拉框里没有 | 还没加进来 | Step 2（Add Models） |
| 同档位的同事能看到，你看不到 | 缓存 / 区域灰度 | Step 2，再 Step 4 |
| 你这档没人看得到，更高档才有 | 订阅档限制 | Step 3 |
| 加了 key 之后自家 Composer 模型消失了 | BYOK 过滤 | Step 5 |
View → Output → Cursor 里有拉取失败 | 网络 / VPN 拦截 | Step 6 |
动手前先确认
- 确认是只有你账号还是全团队都缺。大范围都没有 = 灰度或订阅档问题，本地修不了。
- 升级前先 commit 一次
settings.json，这样万一新版本改了默认值，你能看出是哪改的。 - 记下当前 Cursor 版本、订阅档、当前网络（家里 / 公司 / VPN）。
需要收集的信息
- Cursor 版本（
Cursor → About Cursor）和订阅档（Cursor Settings → Account）。 - 目标模型在 cursor.com/docs/models-and-pricing 上显示的确切名字。
- 当前 Settings → Models 列表截图（包括 Add Models 选择器）。
View → Output → Cursor最近约 50 行（看拉取报错）。- 你的 BYOK 状态，以及 provider 自己的控制台能不能用这个模型。
最短修复路径
按顺序来：升级 → 刷新目录 → 再排除订阅档和灰度。
Step 1：升级到最新版
Cursor → Check for Updates（macOS 在应用菜单里；Windows / Linux 在 Help 菜单里）。升级后重开。
如果它说”已经是最新版”但changelog上明明有更新的版本，说明内置更新器卡住了。直接覆盖安装：
# macOS（Homebrew 安装的）
brew upgrade --cask cursor
# 或从 https://cursor.com/download 重新下载安装包Windows：从同一页面下载安装包，覆盖现有安装运行。Linux：用下载页的最新 AppImage 替换旧的。企业锁版本的，版本由统一管控——找 IT 升级。
升级后用 Cursor → About Cursor 确认已经到了 3.8 或更新（截至 2026 年 6 月）。
Step 2：刷新模型目录
下拉框只显示你已经启用的模型，而且目录有缓存。强制重新拉取一次：
方法 A（首选）：Cursor Settings → Models → Add Models
→ 重新拉取完整的服务器目录，把你想要的模型启用。
方法 B：登出再登入（左下角头像 → Sign out，再 Sign in）。
方法 C：彻底退出 Cursor（Cmd/Ctrl+Q，不是只关窗口）再重开。如果这些都刷不出来，清掉缓存目录再重开：
# macOS
rm -rf ~/Library/Application\ Support/Cursor/Cache
rm -rf ~/Library/Application\ Support/Cursor/Code\ Cache
# Windows（PowerShell）
# Remove-Item -Recurse -Force "$env:APPDATA\Cursor\Cache","$env:APPDATA\Cursor\Code Cache"
# Linux
# rm -rf ~/.config/Cursor/Cache ~/.config/Cursor/"Code Cache"这些只清缓存，不会动你的设置或登录状态。清完重开。
Step 3：确认你的订阅档确实含这个模型
打开 cursor.com/docs/models-and-pricing 找到目标模型。这个页面列了 provider 和 token 价格，但不再印按档位区分的可用栏，所以从两处确认档位限制：
- App 内：
Cursor Settings → Account显示你当前的档位（Hobby / Pro / Pro+ / Ultra / Business）。 - 网页：定价页说明每档解锁了什么。
重型模型的 Max mode、以及部分推理模型，可能只对高档位开放，所以 Hobby 或 Pro 账号可能就是没权限。如果模型在你档位之上，那列表是正常的——升级订阅档或用 BYOK（Step 5）。
Step 4：查有没有正在进行的灰度或事故
如果你版本是最新、目录也刷新过、订阅档也够，但模型还是没有，那大概率在灰度中。去 forum.cursor.com 搜 <模型名> rollout 看是不是别人也在等。再看状态页有没有正在进行的模型事故——它会记录像 Composer 2.5 性能下降、Anthropic 全线报错这类条目，尽管它没有常驻的”灰度”组件。如果是灰度，等一两天就好；如果是已记录的事故，等它修复。
Step 5：用 BYOK 救急
想在 Cursor 路由的灰度还没到你之前就用上某个模型，可以加自己的 provider key：
Cursor Settings → Models → API Keys → 粘你的 Anthropic / OpenAI key → Verify
→ 启用想要的模型条目依赖它之前先了解限制：
- BYOK 只解锁标准模型的 chat completions；自家的 Composer 模型在裸 provider key 下不会出现。
- Agent 和 Edit 依赖 Cursor 路由的 custom models，所以某些 agent 功能在 BYOK 下可能有功能差。
- Tab 补全永远不走你的 key。
Step 6：排除网络 / VPN 拦截
如果 View → Output → Cursor 里有拉取失败（比如 “failed to fetch models” 或连接超时），说明客户端连不上目录接口：
- 关掉 VPN，或换个节点，再重开。
- 公司代理可能拦了 Cursor 后端。在
Cursor Settings里搜 “proxy” 配置代理，或让 IT 把 Cursor 的域名（cursor.com、cursor.sh）加进白名单。
怎么确认已经修好
Cursor → About Cursor显示已是最新版（截至 2026 年 6 月是 3.8 或更新）。Cursor Settings → Models在 Add Models 之后能看到目标模型（已启用，不是灰的）。- Composer 里的模型选择器能选到它。
- 发一条一行的 prompt 走这个模型。能正常回复（不弹 “model not available” 或 “this model is not enabled”）就说明整条链路通了。
如果还是没修好
- 把复现缩到最小：单 prompt + 单模型，这样描述起来干净。
- 回滚到上一个 Cursor 版本，看是不是新版本悄悄下架了某模型。
- 在 forum.cursor.com 搜
<模型名> not showing，附上你的 Cursor 版本、订阅档、区域。 - 抓
View → Output → Cursor日志贴到 Bug Reports——models 团队会盯这个分类。
预防建议
- 大约每月手动检查一次更新，别全靠自动更新，它可能悄悄失败。
- 关注changelog和 forum.cursor.com，知道模型什么时候发、灰度节奏多快。
- 模型暂时拿不到时，先用 BYOK 救急，等 Cursor 路由开放再切回。
- 团队层面，提前确认订阅档能覆盖大家实际要用的模型，别等到用时才发现没权限。
- 把 Cursor 后端域名（
cursor.com、cursor.sh）加进公司代理白名单。
常见问题
为什么 cursor.com 上有这个模型，我编辑器里没有？ 官网和 changelog 在模型一上线就会公告。你的编辑器要等三件事都到位才看得到：客户端是最新的、缓存目录刷新过（点 Add Models）、灰度也轮到了你的档位和区域。这三件事落后于公告，可能是几分钟，也可能是几天。
我点了 “Add Models” 还是没有，怎么办？ 那就排除了缓存问题。先对照 cursor.com/docs/models-and-pricing 看你的订阅档（Step 3），再去 forum.cursor.com 和状态页看有没有正在进行的灰度或事故（Step 4）。如果同档位的人已经有了，就清缓存目录再重开。
登出再登入能刷新模型列表吗？ 有时能。它会重新拉账号状态，顺带可能刷新目录，但没有 Add Models 或清缓存可靠。可以试，但列表还是旧的话别就停在这一步。
BYOK 能让我用上自家的 Composer 模型吗？ 不能。裸的 provider key 只暴露这家 provider 的标准 chat 模型。Cursor 自家的 Composer 系列（截至 2026 年 6 月是 Composer 2.5）走的是 Cursor 自己的路由，所以在你自己的 key 下不会出现，Tab 补全也用不了你的 key。
模型在我列表里但是灰的，是同一个 bug 吗？ 不是。灰掉通常表示它已启用但被限制在更高档位或模式（比如 Max mode），或者因为事故暂时不可用。这种情况去看订阅档（Step 3）和状态页，而不是刷新目录。