/plugin marketplace add arbiterForge/codeArbiter
/plugin install ca@codearbiter
适合谁
- 在 Claude Code、Codex CLI 或 Pi 里工作、希望改动在进入代码库前经过强制检查的开发者与团队：codeArbiter 是为这三个宿主设计的治理层（governance layer），官方仓库标题这样描述它的动机——“When you can't trust yourself with your code base, trust Arbiter”（当你在自己的代码库上无法信任自己时，交给 Arbiter）。
- 启用后，向 agent 表达的每个意图都会被路由到 gated skill 或 reviewer agent，门禁全绿之前不会提交，决策经 SMARTS，审计记录 append-only、只能追加。它作用在仓库粒度上：opt in 的对象是某个仓库。需要提交前强制关口与可追溯决策记录的人，面向的正是这类需求。append-only 意味着审计记录只能新增，不能删除或改写。
- 适合“先看后动”的谨慎用户：官方明确说明插件装后默认休眠，在你显式 opt in 某个仓库之前，它对该仓库不做任何事，原文称“That silence is intentional”（这种沉默是有意设计）；安装本身不会立刻改变仓库的现有行为。
- 不适合的情况：不想要门禁式流程、只想做一次性代码分析或改写的场景，以及环境无法满足下节所列要求的机器。它适用于哪些编程语言与项目类型，官方说明未涉及，未知，这直接影响你是否该选它。
- 除 Claude Code、Codex CLI 与 Pi 之外是否支持其他 agent 宿主，证据未说明，未知。
3 分钟完成第一次尝试
- 前提：Windows、macOS 或 Linux；官方要求 Pi 0.80.10、Node.js 22.19 或更新版本、Python 3 与 Git，无需账号或示例数据。缺任何一项时先补齐环境再安装。
- 安装位置：官方给出的安装路径是 Claude Code 的 plugin marketplace。在 Claude Code 中依次执行下面两条命令——第一条把 arbiterForge/codeArbiter 添加为 marketplace 来源，第二条从该来源安装名为 ca 的插件：
/plugin marketplace add arbiterForge/codeArbiter
/plugin install ca@codearbiter
- 安装后的成功信号：hooks、commands、agents 与 statusline 接线自动加载，所有命令在 /ca: 命名空间下解析；也就是说装完不需要手动接线，以 /ca: 为前缀的命令应能被识别。此时插件仍在休眠，这是预期行为，不代表安装失败。
- 关键确认点：仓库必须显式 opt in 之后才会进入治理流程，安装完成不等于开始工作。opt in 的具体命令未在官方说明中出现，这一步如何执行未知，请以官方仓库内的说明为准，不要自行猜测命令。
- 第一次任务：opt in 之后，向 agent 表达一个普通的代码分析或修改意图，然后观察两点——意图是否被路由到 gated skill 或 reviewer agent；门禁全绿前是否保持不提交。如果意图没被路由、或门禁未全绿就提交了，说明治理流程没有按官方描述运行。/ca: 下还有哪些具体命令，证据未列出，无法逐字给出。
使用案例
- 案例 1：给个人仓库启用门禁式提交。场景：希望每次改动在提交前自动过一遍检查。做法：在 Claude Code 中执行上述两条安装命令装好 ca 插件，确认 hooks、commands、agents 与 statusline 已自动加载、/ca: 命令可解析，然后把仓库 opt in，再向 agent 发出变更意图。可期待：意图被路由到 gated skill 或 reviewer agent，门禁全绿前不会提交，决策经 SMARTS，审计记录只能追加。由于装后休眠，这个案例的所有副作用都从 opt in 那一步才开始，安装命令本身不会触发治理动作。只想先看装上后是什么样子的话，到“自动加载、/ca: 可解析”这一步就可以停下来观察，不必急着 opt in。
- 案例 2：让团队的变更决定可追溯。场景：多人协作时，希望每个改动的决策有据可查、历史不被改写。做法：对已 opt in 的仓库向 agent 表达变更意图，走同一套门禁工作流。可期待：决策经 SMARTS 记录，审计记录 append-only，已写入的记录不会被后续操作覆盖。SMARTS 具体如何交互、在哪个界面查看记录，证据未说明，可确认范围到此为止。
使用边界
- 副作用与确认点：安装时会自动加载 hooks、commands、agents 与 statusline 接线，这是官方说明的安装即发生的行为；初始状态为休眠，显式 opt in 某个仓库之前，插件对该仓库不做任何事，因此不 opt in 就无法验证治理效果。opt in 本身是否可撤销、如何撤销，证据未说明，未知；在意回退成本的用户应在 opt in 前先确认这一步。
- 文件、命令与网络：它是否会读写你的文件、执行哪些命令、是否访问网络，官方说明均未涉及，未知；不能据此推断它没有任何这类行为。把它接到重要仓库前，建议先在一个可舍弃的环境中 opt in 试运行。
- 平台与客户端差异：官方逐字给出的安装路径只有 Claude Code 的 plugin marketplace；Codex CLI 与 Pi 虽被列为治理层服务的宿主，但两者的安装方式未在官方说明中出现，未知。
- 尚未确认的关键信息：opt in 的具体命令、/ca: 命名空间下的完整命令清单、SMARTS 的交互方式、支持的编程语言与项目类型、Windows、macOS、Linux 之外的系统支持、如何卸载或临时停用，均未在证据中出现，采用前请到官方仓库逐项确认。