razzant/claudexor

Multi-harness control plane for Claude Code, Codex, Cursor, and OpenCode: quota-aware rotation across multiple Claude/Codex subscriptions, shared thread context, and cross-model review.

Claudexor – 面向 AI 驅動程式碼代理的本地優先控制平面

是什麼 – Claudexor 是一個開源的 Node.js 應用程式，安裝在您自己的機器上，協調您已付費的多種 AI 程式碼生成工具（GitHub Codex、Anthropic Claude Code、Cursor CLI、OpenCode、Antigravity/Gemini 等）。它提供單一、類型化 API，將各供應商的原生 CLI 或 API 轉換為統一的「對話回合」模型：

只讀回合：提出問題並取得供應商的原生回應。
寫入回合：產生可檢視的補丁，可供審查、稽核並套用。
最佳 N 選一競賽：讓多個哈希器產生競爭性解決方案，再進行交叉審查與仲裁。
類型化事實（成本、配額、認證、網路證據）會為每次操作記錄，提供決定論的稽核軌跡。

所有這些都在本地執行，狀態儲存在一般檔案中，且不傳送任何遙測資料。

核心功能

功能	作用
統一介面	一個 `claudexor` CLI（以及 macOS 桌面應用）可與任何支援的供應商通訊，無需學習各供應商的細節。
憑證設定檔	命名的設定檔可讓您並行管理多個訂閱，每個設定檔都有獨立的配額追蹤與隔離狀態。
預算與配額會計	每個請求都會記錄精確成本與剩餘配額；未知成本絕不會報告為 `$0`。
最佳 N 選一競賽與仲裁	在多個模型上執行相同任務，收集補丁，並讓可設定的審查小組選擇最佳結果。
決定論門控與受保護路徑	定義通配符（如 `*/.env`、`migrations/**`），在補丁套用前必須手動批准。
遠端 SSH 執行	macOS UI 可透過 SSH 在遠端 Linux/macOS 主機上啟動執行緒，保持 UI 本地化，而繁重工作在遠端執行。
守護程序與控制 API	後台守護程序（`claudexord`）處理長時間執行的任務、事件串流與 JSON-over-HTTP 控制介面，適合嵌入呼叫者使用。
與 Ouroboros 的整合	Claudexor 可作為 Ouroboros 自我開發代理內的執行層，提供程式碼變更的持久證據。
無隱藏遙測	所有資料均儲存在 `~/.claudexor`（或專案工作區）中，從不向上游傳送。

典型工作流程（CLI 範例）

# 全域安裝 CLI
npm install -g claudexor
claudexor doctor   # 檢查環境健康狀態

# 簡單的只讀查詢
claudexor ask "這個函數回傳什麼？"

# 使用特定哈希器（例如 Codex）執行程式碼任務
claudexor agent "修復失敗的認證重新整理測試" --harness codex

# 運行兩個模型競賽並保留最小補丁
claudexor best-of "優化 add()" --harness codex,claude --n 2

# 檢查產生的執行
claudexor inspect <run_id>

# 應用補丁（先進行乾運行）
claudexor apply <run_id> --dry-run

相同的命令也可在圖形化 macOS 應用中使用，該應用還顯示即時配額條、執行緒清單與內嵌工件預覽。

安裝選項

方法	詳細資訊
npm（CLI + 守護程序）	`npm install -g claudexor` 提供 `claudexor` 與 `claudexord` 二進位檔。支援 macOS 與 Linux。
macOS 應用	從 GitHub 發布頁面下載簽署的 DMG，拖曳至 Applications 檔案夾。應用程式內建自身的 Node 執行環境與守護程序，因此無需額外安裝 Node，僅需使用內建版本。
從原始碼建置	克隆倉儲，執行 `pnpm install --frozen-lockfile && pnpm build`。使用建置後的 `packages/cli/dist/cli.js` 作為入口點。
遠端 SSH	應用程式可透過您現有的 `~/.ssh/config` 在任何可存取的主機上啟動執行緒。憑證保留在遠端主機上，僅 UI 流量在本地隧道傳輸。

誰可能使用它？

訂閱多個 AI 程式碼服務並希望擁有單一、可稽核工作流程的個人開發者。
需要決定論成本追蹤、配額強制與程式碼合併前審查門控的團隊。
建構更高層級自主系統（如 Ouroboros 自我開發代理）的研究人員或代理，需要一個可靠、本地託管的執行層。
拒絕任何遙測並希望所有狀態儲存在本機磁碟的安全意識使用者。

成熟度與穩定性

目前版本：v3.10.2。
專案定義了「2.0 穩定性」合約：核心動詞與模式 ID 穩定；任何標記為 experimental 的功能可能變更。
簽署的執行時清單可防止供應鏈攻擊；應用程式會拒絕未簽署或遭篡改的更新。
遠端主機啟動支援至 v3.7；v3.8–v3.9.7 版本因缺少簽署文件，需全新 DMG。
Windows 尚未正式支援（本地哈希器安裝程式在 Windows 上類型不支援）。

隱私與資料駐留

所有檔案（執行日誌、補丁、配額記錄、密鑰）均位於 ~/.claudexor 或專案工作區中。
無背景遙測；唯一網路流量是您明確設定的供應商 API。
密鑰（API 金鑰、OAuth 權杖）使用平台原生密鑰儲存慣例儲存，從不在日誌中以明文寫入。

快速連結

網站：https://claudexor.ai/
文件：docs/ARCHITECTURE.md、docs/AGENT_ONBOARDING.md、docs/FEATURES.md
GitHub：https://github.com/razzant/claudexor
npm 套件：https://www.npmjs.com/package/claudexor

總結

Claudexor 是一個真正的、可投入生產的工具，可將少量商業 AI 程式碼服務視為一個單一、可稽核、本地託管的平台。它在供應商原生 CLI 基礎上增加了預算管理、多模型競賽、審查仲裁與嚴格的檔案式狀態管理，使 AI 輔助開發更可預測且更安全。