Copool Windows

Copool Windows 是一个 Windows 桌面面板，用来管理多个 ChatGPT / Codex 账号，并在本机启动一个 OpenAI 兼容 API 代理。它可以按账号额度、套餐和状态切换账号，适合在 Cursor、VS Code、OpenAI SDK 等兼容 OpenAI API 的客户端里统一使用。

功能

• 多账号导入、去重、改名、切换和导出。
• 自动识别邮箱，默认用邮箱作为账号名称。
• 刷新 5 小时额度和周额度，并标记失效、异常、耗尽账号。
• 本地 OpenAI 兼容代理，支持 /v1/models、/v1/responses、/v1/chat/completions。
• 支持代理账号自动轮换，遇到限额或异常账号时尝试切换到其他可用账号。
• 支持仅本机监听 127.0.0.1，也可以手动改为局域网监听 0.0.0.0。
• 诊断日志、账号备份恢复、联动配置查看。

下载和启动

如果你使用已经打包好的版本，直接运行：

dist\Copool\Copool.exe

如果要从源码运行：

python -m pip install -r requirements.txt
python main.py

也可以双击：

run_copool.bat

启动脚本会把运行日志写入 logs\，方便排查启动问题。

导入账号

1. 打开 ChatGPT 并登录目标账号。
2. 在浏览器访问：

https://chatgpt.com/api/auth/session

3. 页面显示 JSON 后，全选并复制。
4. 回到 Copool，进入“账号管理”，点击“导入账号”。
5. 粘贴完整 JSON，确认识别到邮箱和 token 后导入。

留空标签时，Copool 会默认使用识别出的邮箱命名账号。

刷新额度

在“账号管理”页可以点击：

• 刷新全部凭证：刷新所有账号的用量状态。
• 单个账号的 刷新：只刷新当前账号。
• 总览：用表格查看所有账号，并在当前面板内切换、刷新、更新凭证、改名。

如果某个账号显示“凭证已失效”，通常需要重新打开 https://chatgpt.com/api/auth/session 复制新的 Auth JSON 并更新凭证。

启动本地代理

进入“本地代理”页面：

1. 确认监听端口，默认是 8787。
2. 确认“安全监听”：

仅本机 127.0.0.1（推荐）

3. 点击“启动代理”。
4. 复制 API 地址和 API 密钥到你的客户端。

默认配置：

Base URL: http://127.0.0.1:8787/v1
API Key: 面板中点击“复制 API 密钥”

客户端里可以选择 Copool 面板展示的模型名，例如：

GPT-5
GPT-5.4
GPT-5.3-Codex

API Key 存放位置

代理 API Key 不在源码里，也不会提交到 GitHub。

首次启动代理时，程序会自动生成一个本地密钥，保存到：

%APPDATA%\Copool\proxy.key

相关代码位置：

• src/store.py：生成、读取、保存 proxy.key。
• src/proxy_server.py：校验请求里的 Authorization: Bearer ... 或 x-api-key。
• src/ui/proxy_tab.py：在代理页显示和复制 API Key。
• src/ui/diagnostics_tab.py：在诊断页显示联动配置。

如果怀疑密钥泄露，可以关闭 Copool，删除 %APPDATA%\Copool\proxy.key，下次启动代理时会重新生成。

安全建议

• 推荐保持监听地址为 127.0.0.1，只允许本机客户端访问。
• 只有明确需要局域网设备访问时，才切换到 0.0.0.0。
• 不要把 %APPDATA%\Copool\accounts.json、settings.json、proxy.key 上传到任何公开仓库。
• 不要把从 https://chatgpt.com/api/auth/session 复制出来的 JSON 发给别人。
• 公开发布源码前，确认 .gitignore 仍然排除了 logs/、dist/、build/、accounts.json、settings.json、proxy.key。

本地数据目录

Copool 会把运行数据保存在：

%APPDATA%\Copool

常见文件：

accounts.json   账号和 Auth JSON，本地敏感文件
settings.json   面板设置和代理配置
proxy.key       本地代理 API Key
device.id       当前设备标识
backups\        账号备份

这些文件都是本地运行数据，不应该提交到 GitHub。

打包 EXE

安装 PyInstaller 后执行：

python -m PyInstaller --noconfirm --clean --windowed --name Copool main.py

打包结果在：

dist\Copool\Copool.exe

如果旧的 Copool.exe 正在运行，Windows 可能会锁住 dist\Copool，导致无法覆盖。先退出托盘里的 Copool，或者重启后重新打包。

常见问题

账号刷新不了额度

优先确认复制的是完整 Auth JSON，而不是网页 Cookie 片段。正确来源是：

https://chatgpt.com/api/auth/session

代理启动后客户端连不上

检查三项：

• Base URL 是否是 http://127.0.0.1:8787/v1。
• API Key 是否和面板里的密钥一致。
• 代理页是否显示“运行中”。

想让局域网其他设备访问

在“本地代理”或“设置”里把安全监听改为：

局域网 0.0.0.0（谨慎）

然后重启代理。局域网模式会暴露服务端口，请确认只在可信网络里使用。