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 辅助开发更加可预测且更安全。