OpenRouter 集成与实践

OpenRouter 集成与实践

Ori Harness

1 分钟阅读

Ori Harness

在 OpenRouter 上运行你现有的智能体 CLI,可选用任意模型、组织护栏,并合并为一张账单

Ori Harness(测试框架)会在 OpenRouter 上运行你已经在使用的智能体命令行界面(CLI)。一条命令即可启动你现有的智能体 CLI,并替你配置好 OpenRouter 凭证、模型和运行环境。你的工作流无需改变。

自带智能体

使用 Claude Code、Codex、Hermes 或 OpenCode,以及你已经熟悉的命令:

ori claude
ori codex
ori hermes
ori opencode

这些命令会在你的机器上启动真正的智能体 CLI。Ori 运行的是已在你 PATH 上的 CLI。若尚未安装,Ori 会告诉你如何安装,并允许你再试一次。

install-ori-harness 技能 会把同样的步骤交给编程智能体:

运行 curl -fsSL https://openrouter.ai/skills/install-ori-harness,并按照其输出中的说明开始使用

登录即可,不必管理密钥

安装 Ori:

curl -fsSL https://openrouter.ai/labs/ori/install.sh | bash

然后运行智能体。Ori 使用 OAuth PKCE,配合你现有的 OpenRouter 登录。浏览器会打开以完成登录。无需新账户,也无需创建或粘贴密钥。

也可以在首次运行之前登录:

ori login

你的模型、额度与组织设置会随 OpenRouter 登录一并生效。 不必为每个智能体单独管理提供商密钥。

使用以下命令升级 Ori:

ori update

任意智能体,任意模型

通过 --model 传入任意 OpenRouter 模型 ID:

ori claude --model anthropic/claude-sonnet-4.6
ori codex --model openai/gpt-5.2
ori hermes --model openrouter/auto
ori opencode --model openrouter/auto

一个标志即可选定模型。标志之后的所有内容会原样传给智能体:

ori codex --model google/gemini-3.6-flash --full-auto

你平时使用的智能体标志仍然有效。模型可以来自 OpenRouter 目录中的任意提供商。

在 Ori 的标志之后使用智能体的常规标志。Ori 会原样保留它们,并传给智能体。

护栏,覆盖每个智能体

在 OpenRouter 组织上配置护栏、允许列表以及按工作区划分的权限。也可在同一处设置工作区预算。无论请求来自哪个客户端——包括通过 Ori 运行的智能体——OpenRouter 都会在每次请求上强制执行这些控制。

跨智能体的一张账单

Ori 的流量使用 OpenRouter 的常规计费与活动报告。它会与你的其他 OpenRouter 流量一同出现在用量核算活动导出中。没有单独的 Ori 账单。

常见问题

我需要 OpenRouter API 密钥吗?

不需要。Ori 通过 OAuth PKCE,使用你现有的 OpenRouter 登录完成认证。无需复制或粘贴密钥。

我需要改变智能体工作流吗?

不需要。继续使用相同的智能体,以及相同的命令和标志。你的工作流不会改变。

支持哪些智能体?

目前支持 Claude Code(ori claude)、Codex(ori codex)、Hermes(ori hermes)和 OpenCode(ori opencode),更多测试框架即将推出。