OriginRouter CLI快速开始

CLI 快速开始

完成 CLI 安装和本机运行环境准备后，使用 OriginRouter Cloud 登录、初始化路由，并选择智能体运行入口。安装 CLI 及智能体运行时、本机服务和 Local Proxy，请先阅读概览与安装。

开始前

确认已完成概览与安装中的 CLI 安装和 originrouter setup，然后执行以下步骤。

1. 初始化 Cloud 路由

originrouter login
originrouter agent setup --cloud
originrouter doctor

初始化完成

setup 完成本机运行环境准备。接下来登录账户并选择 Cloud 模型。

登录账户

运行 login，完成浏览器授权。

初始化 Cloud 路由

运行 agent setup --cloud，为 Claude 与 Codex 写入账户可用的 Cloud 路由。

验证结果

最后运行 doctor。此时它的登录检查才是 Cloud 路径的有效成功判据。

2. 启动 Claude Code 或 Codex

选择智能体工具

保留 Claude Code 原生终端界面，并使用已配置的 Cloud、local 或 remote 路由：

originrouter claude

能力与安全边界

originrouter claude 和 originrouter codex 在不改变原生终端工作方式的前提下，为 Claude Code 与 Codex 提供统一的 Cloud、local、remote 路由、会话控制、审批和跨设备跟进能力。命令与工具仍由目标 CLI 设备执行，App 或账户服务不会在云端代替目标设备运行本地命令。

App 与 CLI 之间的本机直连、局域网直连和账户中继控制通道使用端到端加密，服务端不持有设备私钥，但仍会处理投递所需的设备、消息类型、时间和大小等元数据。发送给 Cloud 或其他模型服务的任务内容，仍按对应模型服务的服务条款和数据策略处理；设备控制通道的 E2EE 不改变模型服务对任务内容的处理边界。详见数据与执行边界、连接方式和App 设备与安全。

Claude Code 和 Codex 入口保持各自的原生终端体验，仅由 OriginRouter 接管路由、会话控制和审批能力；二者是同一层级的主流工具入口。

如需保留 Claude Code 或 Codex 的官方订阅、登录状态、环境变量和项目配置，可使用原生配置模式：

originrouter claude --native-config

使用 Codex 原生配置模式：

originrouter codex --native-config

该模式不使用 OriginRouter 路由，也不要求 OriginRouter 登录，但仍提供支持的会话发现、消息控制和审批能力。未登录时，doctor 的账户检查失败不影响原生智能体的使用。完整参数说明见控制与审批模式。

3. 使用智能体工作区进行多智能体协作

直接运行 originrouter 会进入 OriginRouter 智能体工作区。这里的“工作区”是智能体使用和管理项目文件的范围；一个工作区可以长期保留多次操作。“会话”是可以继续的对话上下文，“任务”是会话中一次具体的执行。该入口适用于需要协调者、任务分工或多智能体审查的场景，与 Claude Code、Codex 的原生入口不同。

originrouter

也可以直接提交目标，或选择多智能体协作模式：

originrouter "修复登录超时并补充回归测试"

选择 Claude 的 build-review 协作模式：

originrouter -c claude --mode build-review "实现修改并让另一个智能体独立审查"

首次使用工作区前，建议阅读智能体工作区和多智能体协作，了解会话、运行、协作模式和恢复操作。

4. 按需扩展

接入自己的 API、企业网关或本地模型：阅读模型与路由，从“可选：自有模型服务”开始。
用 App 或另一台设备接管工作区：阅读远程访问。先完成上面的 Cloud 路径，再为明确需要共享的模型和目录授权。

上述能力用于扩展控制范围，不属于首次运行的必要条件。