OriginRouter CLI：概览与安装

OriginRouter CLI 是运行在开发者设备上的开源执行与控制层，为 Claude Code 和 Codex 提供统一的本地入口。服务、路由、模型服务、远程控制和审批策略等能力在完成安装后按需启用。

按本页步骤安装 CLI 及常用本机运行环境。首次登录、Cloud 路由和工作区操作请继续阅读快速开始；模型服务、远程访问等能力见对应章节。

安装要求

• Node.js 22 或更新版本。Node.js 官方安装包包含 npm；安装程序会分别验证 node 和 npm 是否可用。
• 在没有 Node.js 或版本过旧的系统上，安装脚本会自动安装 Node.js 22 LTS：有 root 或免密 sudo 权限时使用系统包管理器（apt、dnf/yum、apk）；普通用户则通过 nvm 安装到用户主目录，全程不需要 sudo。其他系统请先从 nodejs.org 安装 Node.js 22 或更新版本，再运行安装命令。自动安装失败的处理方式见故障排查。
• 可访问 npm registry、GitHub Releases 及 Claude Code、Codex 官方下载服务的网络环境；企业网络如需代理，请按组织策略配置 npm 和终端代理。
• Local Proxy 使用 OriginRouter 管理的独立 Python 环境，不要求预先安装系统 Python。
• 登录、Cloud 账户和模型服务凭据可在首次使用时配置。

安装 CLI

推荐使用安装程序。npm 安装适用于需要直接管理 CLI 版本的环境。

curl -fsSL https://originrouter.com/install.sh | bash

irm https://originrouter.com/install.ps1 | iex

验证安装结果

所有安装方式都提供完整命令 originrouter 和短命令 or，两者行为一致。先确认命令入口：

originrouter --version
or --help

安装程序已自动完成初始化和验证。通过 npm 安装时，安装来源中的 originrouter setup 会完成相同的本机运行环境准备。

需要复查安装状态时运行：

originrouter setup --verify

如果终端提示命令不存在，请检查 npm 的全局 bin 目录是否在 PATH 中，然后重新打开终端。同一环境不应同时使用 npm 全局安装和旧的 npm link 开发副本。

setup 的选项、后台服务、Local Proxy 和 Shell 补全配置请参阅运行环境初始化、Local Proxy和Shell 补全。

初始化流程

originrouter setup 用于在 CLI 安装后准备完整的本机运行环境，包括智能体运行时、后台服务、Local Proxy 及其依赖，并在流程结束后检查安装状态。

常用选项

originrouter setup --yes

在自动化环境中跳过交互确认。

originrouter setup --dry-run

仅显示检测结果和执行计划，不修改本机环境。

originrouter setup --no-proxy

跳过 Local Proxy 及其受管 Python。适用于只使用 OriginRouter Cloud 或远程设备的场景。

originrouter setup --verify

仅验证 Claude Code、Codex、受管 Python、Local Proxy 和后台服务状态。

Shell 补全

交互式 setup 会询问是否为当前 Shell 安装命令补全。自动化安装完成后，也可以单独运行：

originrouter completion install

后台服务

初始化流程会安装并启动当前用户范围的后台服务，并配置为用户登录时自动启动。需要单独管理时，参阅服务与后台进程。

重试与修复

setup 会在每次运行时重新检测实际文件、版本和服务状态。中途失败后可重复执行同一命令；已完成的步骤会跳过，缺失或不完整的组件会继续安装或修复。

继续阅读快速开始完成登录和 Cloud 路由配置；需要自有 API 或企业网关时，参阅模型与路由。

下一步

• 快速开始：完成首次登录、Cloud 工作区和第一次智能体运行。
• 智能体工作区：了解日常工作区操作。
• 模型与路由：配置自有 API、企业网关或本地模型。
• 远程访问：从 App 或其他设备接管工作区。
• 命令参考：查阅完整语法、选项和退出状态。