Cursor 官网首页或 changelog 大标题 “Now supporting Claude Opus 4.7”，你打开 Cursor → Composer 模型下拉，opus-4.7 不在列表里；或者列表里还是几个月前的 gpt-5.5，新出的 gpt-5-codex 没影。这不是你账号有问题——通常是 Cursor 本地客户端版本旧、客户端模型清单缓存陈旧、或这个模型按区域 / 订阅档分批灰度还没到你这里。
修法很短，但有几种原因要分清楚。
常见原因
1. Cursor 本地客户端版本太旧
新模型支持要客户端代码配合（路由、参数、UI 标签），旧客户端不知道有这模型。Cursor 自动更新偶尔失败、企业版可能锁版本。
如何判断：Cursor → About → 看版本号；和 https://cursor.com/changelog 上最新版本对比，差超过 2 个版本就是旧。
2. 模型列表缓存未刷新
Settings → Models 页面是从 Cursor 后端拉的 JSON，客户端会缓存 24 小时。即使升级了，缓存没失效列表也是旧的。
如何判断：升级 / 重启后还是旧列表，登出再登入仍旧 = 缓存问题。
3. 新模型按地区或订阅档灰度
新模型通常先放 Pro / Business，几天后才到 Hobby；先放美国节点，再到亚洲；先放 us-east，再到 eu-west。短期内你账号确实没有。
如何判断：去 forum.cursor.com 搜 “model X rollout”，看是不是大家都在等；https://status.cursor.com 也会标 rollout 状态。
4. 账号订阅档不含这个模型
某些模型（opus-4-max-mode, o3-pro 等）只对 Business / Enterprise 开放，Pro 看不到。或某模型对 BYOK 开放但不对 Cursor 代理用户开放。
如何判断：Settings → Plan 看当前档；对照 https://docs.cursor.com/models 的可用矩阵。
5. BYOK 配了但模型只在 Cursor 代理路径下显示
BYOK 路径会重新过滤模型清单——你 OpenAI key 显示的就是 OpenAI 实际开放给你的模型，Cursor 自家路由的 Cursor-specific 模型（如 cursor-small）就不会列。
如何判断：Settings → Models，看每个 model 旁边是 “Cursor” 还是 “Your API Key”。
6. 网络受限 / VPN 让客户端拉不到清单
某些地区 / VPN 路由下，Cursor 客户端无法连后端的 models endpoint，回退到内置默认列表。
如何判断：Output → Cursor 看是否有 “failed to fetch models” 类日志；切到其他网络重试。
动手前先确认
- 确认问题是只有你账号还是全公司，公司多人都缺就更可能是 rollout / 订阅档问题。
- 升级前 commit 一次 settings.json，避免新版本默认值改了不知道哪改的。
- 记下当前 Cursor 版本、订阅档、当前网络（国内 / 海外 / 公司 VPN）。
需要收集的信息
- Cursor 版本（Cursor → About）、订阅档（Settings → Plan）。
- 你期望的模型名，对照官网 docs.cursor.com/models 上的 model ID。
- 当前 Settings → Models 列表截图。
- View → Output → Cursor 最近 50 行（看 fetch models 报错）。
- 是否用 BYOK，对应 provider 控制台是否能用这个模型。
最短修复路径
按”先升级 → 刷缓存 → 看 rollout”。
Step 1：升级到最新版
Cursor → Check for Updates（macOS：菜单栏 Cursor → Check for Updates；Windows / Linux 类似）。
如果”已经是最新版”但 changelog 上看到 2 天前发了新版：
# macOS
brew upgrade --cask cursor
# 或手动从 https://cursor.com/download 重新下载安装企业环境锁版本的要找 IT。
Step 2：清模型清单缓存
方法一：Settings → Models → 页面右上角 "Refresh" 按钮
方法二：登出再登入（左下角头像 → Sign out → Sign in）
方法三：彻底清缓存# macOS
rm -rf ~/Library/Application\ Support/Cursor/Cache
rm -rf ~/Library/Application\ Support/Cursor/Code\ Cache
# 然后重启 CursorStep 3：确认订阅档与模型可用矩阵
打开 https://docs.cursor.com/models，查目标模型的 “Available on” 栏。如果只对 Business，你 Pro 自然看不到。
对照表示例（实际以官方为准）：
- claude-opus-4 (Max mode)：Business / Enterprise
- gpt-5-codex：Pro / Business
- o3-pro：Business / Enterprise
- cursor-small：所有档（仅 Cursor 代理）Step 4：查 rollout 状态
https://status.cursor.com 看是否有 “Model X gradual rollout” 公告。forum.cursor.com 搜 “model name rollout”。如果是 rollout，等几天即可，不用排错。
Step 5：用 BYOK 即时拿到模型
如果你不想等 rollout，可以用 BYOK：
Settings → Models → API Keys → 粘你的 Anthropic / OpenAI key
→ 在 model 列表里勾选 "Use my API key for this model"注意：BYOK 路径下某些 Cursor-specific 集成（agent 工具等）可能有功能差。
Step 6：切网络试
如果 Output 里有 “failed to fetch models”：
- 关 VPN 再试，或换不同 VPN 节点。
- 公司网络代理可能拦了 cursor 后端，配 proxy：Cursor → Settings → 搜 “proxy”。
怎么确认已经修好
- 升级 + 重启后，Settings → Models 列表里能看到目标模型。
- Composer 输入框模型下拉里目标模型可选。
- 发一条简单 prompt 走目标模型，能正常返回（不弹”model not available”）。
如果还是没修好
- 把复现缩到最小：单 prompt + 单模型尝试。
- 回滚最近一次 Cursor 升级看是否新版本默认下架了某模型。
- 在 forum.cursor.com 搜 “model X not showing”；附 Cursor 版本 + 订阅档 + 区域。
- 抓 View → Output → Cursor 日志贴 Bug Reports，可直接 ping models 团队。
预防建议
- 每月手动检查一次 Cursor 升级，不要全靠自动更新。
- 关注 https://cursor.com/changelog 和 forum.cursor.com 公告，知道 rollout 节奏。
- 重要模型如果暂时拿不到，先 BYOK 救急，等 Cursor 路径开放再切回。
- 团队级别确认订阅档够大，避免某些模型档不够看不到。
- 把 Cursor 后端域名（cursor.sh、cursor.com）加进公司白名单，避免代理拦。