docs(aggregation): correct the workaround for the exhausted-quota lock

Since route and aggregation mode keep the ChatGPT login (#8431), the
route table writes requires_openai_auth = true whenever a login is on
disk, so making a third-party card the aggregation default no longer
keeps Codex from locking the send button to Luna Reserve once the
official 5-hour quota runs out.

The guide and the 4.6 manual pages now describe the method that still
works: switch to Direct, keep "Keep official login for direct switches"
off, switch to a third-party card and fully restart Codex; switch back
to Aggregation once the quota resets. The old method is marked as no
longer working.

Refs #7962
This commit is contained in:
Jason committed 2026-10-21 17:04:27 +08:00
1 parent cdfdff5ee7
commit 92ec18d774
4 files changed
+27 -23

No files matched your search

+12 -8
View File
@@ -180,19 +180,23 @@ CC Switch 的三种模式,适合不同的使用习惯。
默认供应商是 OpenAI Official 时,官方的 5 小时额度一旦用完,Codex 可能会锁住发送键,或者把模型选择器收成只剩“Luna Reserve”一项。这时聚合里的第三方模型既选不了,也发不出去。
**这是 Codex 客户端自己的限制。** 2026 年 9 月起的新版 Codex 会自己向 OpenAI 查询账号额度,发现普通额度用完后,就在请求发出之前把模型换成 Luna Reserve(`gpt-reserve`),其他模型要等额度恢复才回来。这个判断只看当前配置是否使用官方登录,不管你选的是哪家模型;请求也根本到不了 CC Switch,所以 CC Switch 这一侧没办法放行。
**这是 Codex 客户端自己的限制。** 2026 年 9 月起的新版 Codex 会自己向 OpenAI 查询账号额度,发现普通额度用完后,就在请求发出之前把模型换成 Luna Reserve(`gpt-reserve`),其他模型要等额度恢复才回来。这个判断只看本机是否有 ChatGPT 官方登录、当前配置是否使用它,不管你选的是哪家模型;请求也根本到不了 CC Switch,所以 CC Switch 这一侧没办法放行。
**绕开方法:** 额度恢复前,暂时让第三方当默认供应商。
聚合和路由模式会保留 Codex 的 ChatGPT 登录(Codex 桌面版继续旧会话需要它),所以只要本机有官方登录,即使把第三方设为默认供应商,Codex 也会按官方账号判断额度。
1. 在 Codex 的聚合页,打开任意一家第三方供应商卡片的「更多」菜单,选择「设为默认」。
2. 彻底重启 Codex(方法见上文“Codex 需要怎样重启”),然后新开一个会话。已经被切到 Luna Reserve 的会话,可能仍保留这个模型。
3. 官方额度恢复后,再把 OpenAI Official 设回默认,并同样重启 Codex。
**绕开方法:** 额度恢复前,暂时回到直连,用第三方供应商。
期间 OpenAI 官方模型不会出现在选择器里,设回默认后就会回来。它们本来就已经用完额度,所以这样换不会有额外损失。
1. 在 Codex 应用页顶部切到「直连」,退出聚合。
2. 确认「设置 → 应用配置 → Codex」里的「非接管切换时保留官方登录」是关闭的(默认关闭)。
3. 在直连下切换到一家第三方供应商。CC Switch 会把官方登录暂时收起来,Codex 就不再按官方账号判断额度。
4. 彻底重启 Codex(方法见上文“Codex 需要怎样重启”),然后新开一个会话。已经被切到 Luna Reserve 的会话,可能仍保留这个模型。
5. 官方额度恢复后,再切回「聚合」,并同样重启 Codex。收起来的官方登录会自动还回去。
这个办法依据 Codex 公开源码里的判断条件。如果按上面的步骤操作后仍然被锁,欢迎到 [#7962](https://github.com/farion1231/cc-switch/issues/7962) 反馈。
期间只能用这一家第三方的模型,聚合里的其他模型和 OpenAI 官方模型都不会出现在选择器里,回到聚合后就会恢复。
> 不用聚合、直连第三方供应商时也可能遇到同样的情况。如果在「设置 → 应用配置 → Codex」里打开了「非接管切换时保留官方登录」,Codex 会继续按官方账号判断额度。关掉这个开关,重新切换一次供应商,再重启 Codex 即可;切回官方时,登录会自动恢复。
> 早先这里写的办法是“把第三方设为默认供应商”。聚合模式改为保留官方登录后,这个办法已经不起作用,请改用上面的步骤。
如果按上面的步骤操作后仍然被锁,欢迎到 [#7962](https://github.com/farion1231/cc-switch/issues/7962) 反馈。
## 致敬 opencodex
@@ -137,12 +137,12 @@ If the classic sub-agent tools are off and the main agent and a sub-agent use mo
## Third-party Models Stop Working After the Official Quota Runs Out
When OpenAI Official is the default provider and its 5-hour quota runs out, Codex may lock the send button or leave only "Luna Reserve" in the model picker. This is a limit inside the Codex client: it checks the account quota on its own and, once ordinary usage is exhausted, switches the model to Luna Reserve before the request is sent, so the request never reaches CC Switch.
Once the official 5-hour quota runs out, Codex may lock the send button or leave only "Luna Reserve" in the model picker. This is a limit inside the Codex client: whenever a ChatGPT login is present on the machine, it checks the account quota on its own and, once ordinary usage is exhausted, switches the model to Luna Reserve before the request is sent, so the request never reaches CC Switch. Aggregation mode keeps the official login (Codex Desktop needs it to continue earlier sessions), so making a third-party provider the default does not get around it.
- **Workaround**: "Set as default" on a third-party provider, fully restart Codex, then start a new session
- **Switching back**: once the official quota resets, set OpenAI Official as the default again and restart Codex once more
- **Trade-off**: OpenAI's official models are missing from the picker in the meantime, though their quota is already used up
- **Also locked when switching directly to a third party**: check "Keep official login for direct switches" under Settings → App config → Codex; turn it off, switch providers once more, and restart Codex
- **Workaround**: switch to "Direct" at the top of the app page, make sure "Keep official login for direct switches" under Settings → App config → Codex is off (it is off by default), then switch to a third-party provider. CC Switch sets the official login aside for now. Fully restart Codex and start a new session
- **Switching back**: once the official quota resets, switch back to "Aggregation" and restart Codex once more; the official login that was set aside is restored automatically
- **Trade-off**: in the meantime only that one third-party provider's models are available; the other aggregated models and OpenAI's official models are missing from the picker
- **The earlier workaround no longer works**: making a third-party provider the default stopped helping once Aggregation began keeping the official login
- **Still locked**: please report it in [#7962](https://github.com/farion1231/cc-switch/issues/7962)
## Limits
@@ -137,12 +137,12 @@ Codex の自動承認(Approve for me、`approvals_reviewer = "auto_review"`)
## 公式の利用枠を使い切ると他社のモデルも送れないとき
既定のプロバイダーが OpenAI Official のとき、公式の 5 時間の利用枠を使い切ると、Codex が送信ボタンをロックしたり、モデル選択に「Luna Reserve」だけを残したりすることがあります。これは Codex クライアント自身の制限です。Codex は自分でアカウントの利用枠を確認し、通常の利用枠が尽きているとリクエストを送る前にモデルを Luna Reserve に切り替えるため、リクエストは CC Switch に届きません。
公式の 5 時間の利用枠を使い切ると、Codex が送信ボタンをロックしたり、モデル選択に「Luna Reserve」だけを残したりすることがあります。これは Codex クライアント自身の制限です。端末に ChatGPT の公式ログインがあると、Codex は自分でアカウントの利用枠を確認し、通常の利用枠が尽きているとリクエストを送る前にモデルを Luna Reserve に切り替えるため、リクエストは CC Switch に届きません。集約モードは公式ログインを保持する(Codex デスクトップ版が以前のセッションを続けるのに必要)ため、他社のプロバイダーを既定にしても回避できません。
- **回避策**:他社のプロバイダーを「既定にする」で既定に設定し、Codex を完全に再起動してから新しいセッションを開きます
- **元に戻す**:公式の利用枠が回復したら OpenAI Official を既定に戻し、もう一度 Codex を再起動します
- **代償**:その間は OpenAI 公式モデルが選択に表示されません。ただし、これらのモデルはもともと利用枠を使い切っています
- **直接接続で他社に切り替えてもロックされる**:「設定 → アプリ設定 → Codex」の「直接切替時に公式ログインを保持」を確認してください。オフにしてからプロバイダーをもう一度切り替え、Codex を再起動します
- **回避策**:アプリページ上部で「直接接続」に切り替え、「設定 → アプリ設定 → Codex」の「直接切替時に公式ログインを保持」がオフになっていること(既定はオフ)を確認してから、他社のプロバイダーに切り替えます。CC Switch が公式ログインを一時的に退避します。そのうえで Codex を完全に再起動し、新しいセッションを開きます
- **元に戻す**:公式の利用枠が回復したら「集約」に戻し、もう一度 Codex を再起動します。退避した公式ログインは自動的に戻ります
- **代償**:その間はその 1 社のモデルしか使えず、集約の他のモデルと OpenAI 公式モデルは選択に表示されません
- **以前の回避策は使えなくなりました**:集約モードが公式ログインを保持するようになってから、他社のプロバイダーを既定にする方法は効かなくなりました
- **それでもロックされる**:[#7962](https://github.com/farion1231/cc-switch/issues/7962) でお知らせください
## 制限事項
@@ -139,12 +139,12 @@ Codex 开了自动审批(Approve for me,`approvals_reviewer = "auto_review"`
## 官方额度用完后第三方也发不出去
默认供应商是 OpenAI Official 时,官方 5 小时额度用完后,Codex 可能锁住发送键,或者模型选择器只剩“Luna Reserve”。这是 Codex 客户端自己的限制:它自己查询账号额度,发现用完就在请求发出前把模型换成 Luna Reserve,请求到不了 CC Switch。
官方 5 小时额度用完后,Codex 可能锁住发送键,或者模型选择器只剩“Luna Reserve”。这是 Codex 客户端自己的限制:只要本机有 ChatGPT 官方登录,它就自己查询账号额度,发现用完就在请求发出前把模型换成 Luna Reserve,请求到不了 CC Switch。聚合模式会保留官方登录(Codex 桌面版继续旧会话需要它),所以把第三方设为默认供应商也绕不开。
- **绕开**:把一家第三方供应商「设为默认」,彻底重启 Codex,然后新开会话
- **恢复**:官方额度恢复后,把 OpenAI Official 设回默认,再重启一次 Codex
- **代价**:期间 OpenAI 官方模型不在选择器里,而它们本来就已用完额度
- **直连第三方也被锁**:检查「设置 → 应用配置 → Codex」里的「非接管切换时保留官方登录」,关掉后重新切换一次供应商并重启 Codex
- **绕开**:在应用页顶部切到「直连」,确认「设置 → 应用配置 → Codex」里的「非接管切换时保留官方登录」是关闭的(默认关闭),再切换到一家第三方供应商。CC Switch 会把官方登录暂时收起来。然后彻底重启 Codex,新开会话
- **恢复**:官方额度恢复后切回「聚合」,再重启一次 Codex,收起来的官方登录会自动还回去
- **代价**:期间只能用这一家第三方的模型,聚合里的其他模型和 OpenAI 官方模型都不在选择器里
- **早先的办法已失效**:“把第三方设为默认供应商”在聚合保留官方登录后不再起作用
- **仍然被锁**:请到 [#7962](https://github.com/farion1231/cc-switch/issues/7962) 反馈
## 限制