用途
Claudexor 面向已经在为 AI 编程智能体付费、但希望在其之上获得统一控制层的开发者。它把 Codex CLI、Claude Code、Cursor CLI、OpenCode、Antigravity CLI 以及原始 API 适配器放在同一个带类型接口之后运行,解决厂商自身不提供的能力:多订阅配额管理、跨模型评审、竞速仲裁,以及可审计的成本/配额核算。
主要能力
- 多工具统一接口:以「轮次对话(chat of turns)」的形式组织工作;只读提问会恢复厂商自身的原生会话,写入型轮次则产出可检查的补丁或完整文件清单。
- 凭证配置(2.1 起):可并列命名 Antigravity/Claude/Codex/Cursor 订阅绑定,每个配置拥有 Claudexor 作用域内的状态与平台声明的凭证托管方式。
- 配额跟踪与轮换:对具备厂商用量来源的 harness(Antigravity、Claude、Codex)进行实时订阅配额跟踪,并可通过可选策略在遇到带类型的厂商限额时轮换掉已用尽的账户;Cursor 暂不支持该用量来源。
- best-of-N 竞速:让不同 harness 相互竞赛,配合独立评审员与仲裁。
- 诚实的预算/配额核算:未知成本不会记为 0。
- 确定性门禁与受保护路径:可通过 --allow-protected-path 为测试/打包等受保护路径的变更记录按次运行的类型化批准,但不会绕过内置的关键/安全人工门禁。
- 跨模型评审:默认情况下普通 Agent 运行会跳过内部模型评审,已完成变更显示为 Not reviewed;可用 --review 启用自动评审面板选择,Best-of 与 --until-clean 也会包含评审。评审者可通过 --reviewer-panel 传入逗号分隔的 harness=model:effort 列表,或以 --reviewer-panel-json 配合 credentialProfileId 获得确定性的每槽位账户。
- 本地优先:一切运行在用户机器上,文件是事实来源,无遥测。
使用方式
- 前置条件:Node.js >= 24.15;pnpm(通过 corepack: corepack enable pnpm);Git 用于 Git 支持的 worktree、候选信封与源码控制交付(显式目录执行无需 Git);至少一个已登录的厂商 CLI(codex、claude、cursor-agent 或 Cursor 的 agent、opencode、agy),或提供方 API key(适配器接受 OPENAI_API_KEY、ANTHROPIC_API_KEY 等作为回退)。应通过 Claudexor 而非裸厂商 CLI 登录。桌面应用需 macOS;CLI/守护进程也可在 Linux 运行。
- CLI + 守护进程(npm):安装 claudexor 与 claudexord 两个二进制。
- macOS 应用:从 Releases 下载 Claudexor-<version>.dmg,拖入 Applications 并打开;应用会启动其内置的 Claudexor 引擎,随后引导检查所选工作所需的外部 Git 与 harness 路由。应用自带守护进程运行时并在启动时运行,仅在终端使用时才需要安装 Claudexor CLI。
- Harness 安装:宿主集成可用 claudexor harness install <harness> --target local --yes --json 将一个厂商 CLI 安装到 Claudexor 管理的本地工具链中;精确 npm pin 安装在 ~/.claudexor/node 下,Cursor 保持非 pin,收据记录下载安装器的 SHA-256 与字节长度。
- 远程主机:macOS 应用可在 Linux 或 macOS SSH 主机上运行线程而 UI 保持本地,使用系统 /usr/bin/ssh,首次连接会在 ~/.claudexor/remote/ 下安装签名、无需 sudo 的运行时。
- 目录执行:在普通文件夹中需显式选择目录执行,可重复 --scope-path 以缩小复制范围;目录执行永远不会初始化 Git。
- 处理模式:--processing standard|fast|economy 请求所选模型的服务等级,不改变推理强度或路由目标。
- 应用更新:macOS 应用可从签名清单就地安装新的运行时闭包,无需新 DMG,失败时回滚到上一个已知良好版本;npm 用户通过 npm install -g claudexor@latest 更新。
适用场景
需要跨多个 AI 编程工具与订阅进行统一调度、配额管理与成本审计的开发者;希望在提交前引入跨模型独立评审与竞速结果的团队;以及需要在远程主机上运行编码 agent 而界面保持在本地的工作流。Claudexor 也作为 Ouroboros 中精确 pin 的委派执行层运行。
限制
- 需要 Node.js >= 24.15,桌面应用仅支持 macOS。
- Cursor 目前没有厂商用量来源,因此不支持配额跟踪。
- 目录执行的直接更改不承诺完整回滚;复制结果保留完整文件字节以备后续应用。
- 版本 v3.8.0、v3.9.0、v3.9.7 为发布例外,省略了三份自定义 Ed25519 文档,已安装应用无法就地更新到这些版本,也无法从这些版本进行首次远程引导。
- 订阅访问不保证零增量费用,也不启用提供方付费积分;模型目录与上下文限制因账户而异。
- 当前状态为 v4.1.1;已退役的动词与模式 id 会直接报错,而不会静默别名。
- 具体收费、价格信息暂未提供。