一个尝试改善 Codex 降智、限流和连接问题的本地工具。不是百分百有效，但把这套思路做成了大家能自己用的程序。

做这个项目，是因为 Codex 有时用着用着就不对劲：回答质量变了，请求被限了，换个配置又接不上。我们从代理出口和 turn-state 入手做了一些尝试，觉得值得继续验证，就整理成 Go 程序开源了。

它不会增加账号额度，也不能保证换个出口就恢复质量。真正要做的是：让连接、配置、采集和排错都看得见，别把所有问题都留给使用者手改文件。

一个服务，一个本地网页。官方 ChatGPT、官方 API key 和 Responses 中转按各自的认证方式走；支持 Astra、5.6 Sol、5.6 Terra，能否调用仍取决于你的账号和上游。已有代理软件就填本地 HTTP / SOCKS5 地址，也可以导入自己的订阅或本地文件。

Windows 上手 · macOS 上手 · 面板教程 · 代理与订阅 · 问题与验收清单 · 测试记录 · 联系与交流

当前仍是公开测试版。 此 README 描述当前源码；下载时以对应 Release 的说明为准，旧发布包不会自动多出新功能。本轮真实 Sol 回复、V2 远程压缩及压缩后回复、Terra 回复已跑通；追加的两次 Astra 短回复也成功，但本轮仍没有采到合格 292；旧式 V1 压缩直连上游返回 404，Team 仍只做合成测试。不能把部分成功写成全部验收通过。具体边界见问题与验收清单。

先确认 Codex 不经过本工具时原本就能用。官方账号先登录；中转先配好自己的 API key。用 CCS / CC Switch 的，先选好这次要用的配置，再退出 Codex，暂时别继续切换。

1. 到 Releases 下载并完整解压。普通 Windows 选 windows-amd64，Windows ARM 选 windows-arm64；Apple 芯片 Mac 选 darwin-arm64，Intel Mac 选 darwin-amd64。
2. Windows 双击 start.cmd，macOS 双击 start.command。 浏览器会自动打开并进入本地面板，不需要先复制口令。
3. 程序会自动备份并接入，打开面板。看到已接管后，重启 Codex，新建会话，发一条短消息；不用再点一次接入。旧会话不会被热切换。

已有代理、订阅、模型和注入开关会保留；没有配过来源时尝试识别常见本地代理。首次 setup 没有明确设置兜底策略，就采用“采不到 state 时先正常转发”；之前明确选过严格模式的会继续保留。

没有找到本地代理，或你只拿到了订阅链接，再到「订阅与代理」填写并保存。首页「一键接入 Codex」用于需要时重新检查和修复，不是每次启动的必点步骤。

如果浏览器没有打开，按终端显示的地址手动进入，再粘贴本次管理口令。默认地址是 http://127.0.0.1:17841/admin/。如果包里没有启动脚本，可以在程序目录执行以下命令；旧版不支持 setup 时先更新。

Windows：

.\ccodex-sleep-state.exe setup

macOS：

./ccodex-sleep-state setup

setup 会创建缺失的服务配置、启动服务并打开面板；已有订阅和代理设置不会被重置。自动接入只检查本机 127.0.0.1 的常见 SOCKS5 端口，不扫描网络、不读取代理软件账号库。启动本身不发送模型请求；接入 Codex 后的采集可能消耗额度。服务 JSON 写坏了会进入修复面板，不会因为启动失败就静默删掉旧文件。

服务运行时保留终端窗口。退出用 Ctrl+C，等配置恢复完成，再重启 Codex。关闭浏览器、关闭注入和停止服务，是三个不同操作。

面板教程有逐步操作，不需要先看懂代码。我们也对照研究了 GPT-Load 的路由诊断、失败分类和部署体验，但没有把它的账号池、所有协议、计费和多渠道平台完整移植进来。功能映射与取舍

程序处理的是响应里的 X-Codex-Turn-State。它从候选出口发短请求，检查封装、时间和密文块数，保存可用值；后续请求带上这份值，并走对应出口。

这不是 OpenAI 公布的质量指标。 符合长度不证明模型“满血”，不符合也不能只凭这一点断定代理坏了或模型降智了。

自动识别使用当前请求里的套餐提示，提示不明确时会说明采用了什么规则；不会仅凭长度把账号认成 Team。你也可以在面板明确选个人或 Team。state 按账号、凭据和模型隔离，不在 Astra、Sol、Terra 之间混用。

没有合格 state 时有两种选择：

• 严格模式。 不使用不合格 state；采集失败返回明确原因。明确选过 strict，之后 setup 不会自动覆盖。底层转发在策略为空时仍按严格处理。
• 普通转发兜底。 首次 setup 没有明确策略时采用，也可在面板自行开启；重新点首页接入按钮会提示并选择此模式。 没有可用 state 时不注入，仍走选定出口，正式请求最多转发一次。状态会说明本次没有注入，而不是假装采集成功。

兜底不是解除限流。401、403、429 的停止规则照常生效；已经发到上游的正式生成不会换出口再重放一次。

程序只处理当前 Codex 选择的 provider，不接管 CCS 的账号数据库。它读取上游与认证方式，临时把 Codex 的入口接到本地服务，停止后恢复。

运行中只改注释或无关设置，不应再把整份配置判为冲突。CCS 真正切换了 provider、上游或认证时，仍会停止转发，防止凭据送错地方。这时去面板检查并保留当前配置，再重新接管；不要删除事务文件，也不用照着群消息盲改 TOML。

最稳妥的切换顺序还是：停止本服务 → CCS 切换 → 启动本服务 → 重启 Codex。 兼容不是让两个程序同时抢写同一份配置。

远程上下文压缩单独验收：本轮真实 Sol 的新版 V2 压缩及压缩后继续回复已成功；旧式 V1 直连上游返回 404，发送前桥接已在本地模拟客户端通过，但追加真实验收的第一条 Sol 回复发生出口传输失败，不能写成所有压缩方式都已跑通。压缩问题进展

给群友或 AI Agent 发排查信息，先运行：

.\ccodex-sleep-state.exe doctor

macOS 对应 ./ccodex-sleep-state doctor。不要发 auth.json、管理口令、完整订阅或整个数据目录。更多问题、修复与尚未验收项都记录在问题清单，不会只留在聊天记录里。

本版新增：拿到可用值后固定使用、多订阅代理池、手动粘贴/TXT 导入、已用/失败清单、单节点重试，以及独立出口与大请求设置。首页给出下一步操作，复杂参数留在高级设置里。

现有版本不会自动升级。下载前请看v0.4.0 发布说明和升级与回退指南，运行边界见合规与风险说明。

• 支持的模型是 gpt-6-astra、gpt-5.6-sol、gpt-5.6-terra，上游必须实际提供对应模型。工具不会替你开通权限，也不会悄悄换模型。
• 目前走 Responses HTTP / SSE，不支持 WebSocket 和任意协议转换。
• 采集会使用实际额度。默认每轮最多 6 个候选出口，单次探测最多 20 秒，两轮至少间隔 180 秒。正常生成请求不自动重放。
• 代理支持 HTTP、HTTPS、SOCKS5，以及 Clash/Mihomo YAML、逐行 URI、Base64 URI 订阅。内嵌出站适配支持 AnyTLS、SS、SSR、VMess、VLESS、Trojan、Hysteria、Hysteria2、TUIC；不导入订阅的 TUN、DNS 或系统规则。具体限制
• 认证值和完整 state 不写常规日志。程序没有遥测，不把日志上传给作者；但本地代理配置和恢复备份仍可能含敏感信息，要自己保管。
• 不切换系统代理，不刷新 Codex 登录，不使用重置卡。中转站能接上不代表 state 思路对中转也有效。

设置过 CODEX_HOME 会跟随它；本工具还有 CCODEX_STATE_HOME 和 --data-dir。不确定实际用的是哪份，运行 paths，不要凭目录名猜。

用起来有没有改善、哪个版本接不上、什么情况下又出问题，都欢迎来聊。报错和复现步骤也可以提 Issue，方便后面查找。

个人微信 · 等待	QQ 群 · 不过是大梦一场空
扫码添加作者个人微信；这是好友二维码，不是微信群入口。	扫码，或搜索群号 797481450。

朋友的卡网：faka.redeemai.org。友情展示，商品、价格及售后以卡网页面为准，图中的服务承诺未由本项目核验。本工具免费使用，无需购买；不代表 OpenAI 官方授权或背书。

反馈时带上系统、Codex 版本、工具版本和错误提示就够了。不要发账号凭据、完整订阅链接或未经检查的配置文件。

项目用 Go 编写，静态管理页嵌入二进制，不需要另外启动前端服务。

• cmd/ccodex-sleep-state：命令、一键入口、诊断。
• internal/codexconfig：provider 解析、接管、语义检查与可恢复修复。
• internal/gateway：模型与账号隔离、采集、压缩和流式转发。
• internal/turnstate：封装规则、当前值与备用值。
• internal/proxyroute：订阅和出站连接。
• internal/service：单实例、面板、配置热切换和请求诊断。

构建方法 · 设计取舍 · GPT-Load 功能映射 · 隐私说明

GPL-3.0，见 LICENSE。代理部分复用了 Mihomo，见 依赖说明。本项目与 OpenAI、Mihomo、GPT-Load 没有隶属关系。