underclass

underclass:一個與 OpenAI 相容的池化代理,可將會話固定到一個帳戶(提示快取保持溫暖),在配額耗盡時冷卻訂閱直到其視窗重置,並在整個池子乾涸時以最早的 Retry-After 快速失敗。

underclass 是什麼?

underclass:一個與 OpenAI 相容的池化代理,可將會話固定到一個帳戶(提示快取保持溫暖),在配額耗盡時冷卻訂閱直到其視窗重置,並在整個池子乾涸時以最早的 Retry-After 快速失敗。

underclass 概覽

這是什麼

這是什麼

這是什麼

這是什麼

這是什麼

這是什麼

這是什麼

這是什麼

這是什麼

這是什麼

這是什麼

這是什麼

這是什麼

這是什麼

這是什麼

這是什麼

這是什麼

這是什麼

這是什麼

這是什麼

這是什麼

這是什麼

這是什麼

這是什麼

這是什麼

這是什麼

這是什麼

underclass 是一個相容 OpenAI 的集區代理,將多個 ChatGPT/Codex、GitHub Copilot 和 Claude Code 訂閱集結在一個端點後面。它將會話固定到一個帳戶(提示快取保持溫熱),當配額耗盡時讓訂閱冷卻直到視窗重置,並在整個集區枯竭時快速失敗並回傳最早的 Retry-After。代理監聽在本機位址,提供 /v1/responses、/v1/chat/completions、/v1/models(OpenAI 表面)和 /v1/messages(Anthropic 表面)端點。同一來源的網頁 UI 提供帳戶管理、目錄、即時請求饋送和統計資料。

主要功能

  • 黏著會話: 帶有提示快取金鑰的請求總是落在同一個訂閱上,保持上游提示快取的溫熱。
  • 健康集區: 配額耗盡的帳戶進入冷卻狀態,並在使用視窗重置時自動回到輪替。
  • 快速飽和失敗: 當所有符合請求模型的帳戶都在冷卻時,代理回傳 429 並附上最早的 Retry-After 標頭。
  • 雙 API 表面: /v1/* 端點使用 OpenAI(用於 Codex 和 Copilot),/v1/messages 使用 Anthropic Messages API(用於 Claude Code),每個請求只路由到服務其表面的後端。
  • 代幣會計: 每次上游嘗試都記錄在 SQLite 中,包含模型、帳戶、提示快取金鑰和報告的代幣;管理頁面顯示當月總計和篩選條件。
  • 網頁 UI 與 CLI 工具: 網頁管理介面提供帳戶管理、統計資料和即時請求饋送;underclass CLI 支援 connect、reset、top 和 stats 指令。

使用情境

  • 將多個個人 ChatGPT/Codex、GitHub Copilot 或 Claude Code 訂閱集結成一個端點,供任何相容 OpenAI 的用戶端使用。
  • 透過自動輪替正在冷卻的帳戶來避免每個帳戶的配額耗盡。
  • 透過將會話固定到單一訂閱來保持跨請求的上游提示快取溫熱。

快速開始

shUNDERCLASS_PROXY_KEY=$(openssl rand -hex 32) UNDERCLASS_UI_TOKEN=$(openssl rand -hex 32) cargo run -- serve然後打開網頁 UI,貼上管理員權杖,並為 ChatGPT/Codex、GitHub Copilot 或 Claude Code 新增帳戶。

授權與價格

此專案採用 MIT 授權。它是開放原始碼且免費使用。

內容整理自該專案公開的 README 與儲存庫資訊。

將此徽章加入你的 README

Featured on YunoDB 徽章樣式與說明

你是這個專案的維護者嗎?展示它已收錄於 YunoDB。

Markdown[![Featured on YunoDB](https://yunodb.com/badge/ghuntleyunderclass.svg)](https://yunodb.com/tools/ghuntleyunderclass?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/ghuntleyunderclass?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/ghuntleyunderclass.svg" alt="Featured on YunoDB" height="20"></a>