mcpField
C
cli-providers

cli-providers

github.com/cheaper-inference云与 DevOps82.3k1.1k 次安装今天更新
代码仓库

关于 cli-providers

cli-providers 介绍用于管理 OmniRoute 服务商连接和密钥的命令行操作，包含目录检索、连接测试与校验、OAuth 管理、指标查看和路由组合管理。

主要功能

  1. 01浏览并筛选服务商目录
  2. 02列出、测试和校验连接
  3. 03轮换服务商凭证
  4. 04管理 OAuth 服务商会话
  5. 05查看服务商指标与用量
  6. 06创建和切换路由组合

适用场景

  1. 01按名称或类别查找服务商
  2. 02使用前检查已配置连接
  3. 03轮换凭证或查看服务商指标
  4. 04设置用于故障切换的路由组合

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/cheaper-inference/omniroute --skill cli-providers

安装后在 Claude Code 中输入/cli-providers确认已加载。

详细介绍

概述

通过 CLI 管理提供商连接：列出可用/已配置的提供商、添加、测试、测试所有连接、验证、轮换 API 密钥，以及查看各提供商的指标。

快速安装

npm install -g omniroute   # or: npx omniroute
omniroute --version

子命令

provider-cmd provider [subcommand]

管理提供商连接（使用

示例：

omniroute provider-cmd provider [subcommand]
providers

示例：

omniroute providers
providers available

显示 OmniRoute 目录中的可用提供商

标志：

  • --json
  • --search <query>
  • -q, --q <query>
  • --category <category>

示例：

omniroute providers available
providers list

列出已配置的提供商连接

标志：

  • --json

示例：

omniroute providers list
providers test <idOrName>

测试已配置的提供商连接

标志：

  • --json

示例：

omniroute providers test <idOrName>
providers test-all

测试所有启用的提供商连接

标志：

  • --json

示例：

omniroute providers test-all
providers validate

验证本地提供商配置，不调用上游

标志：

  • --json

示例：

omniroute providers validate
providers rotate <idOrName>

标志：

  • --new-key <key>
  • --from-env <VAR>
  • --oauth
  • --yes
  • --skip-test
  • --dry-run

示例：

omniroute providers rotate <idOrName>
providers status

标志：

  • --provider <name>
  • --json

示例：

omniroute providers status
providers metrics

标志：

  • --provider <id>
  • --connection-id <id>
  • --period <p>
  • --metric <m>
  • --sort-by <field>
  • --limit <n>
  • --watch
  • --compare <list>

示例：

omniroute providers metrics
providers metric <connectionId> <metric>

标志：

  • --period <p>

示例：

omniroute providers metric <connectionId> <metric>
test-provider test [provider] [model]

标志：

  • --all-providers
  • --json
  • --latency
  • --repeat <n>
  • --compare <models>
  • --save <path>

示例：

omniroute test-provider test [provider] [model]

OmniRoute — CLI 提供商与密钥

需要 omniroute CLI。有关安装和全局标志，请参阅 CLI entry-point skill。

提供商目录（可用提供商）

omniroute providers available                        # Full OmniRoute provider catalog
omniroute providers available --search openai        # Filter by id, name, alias
omniroute providers available --category api-key     # Filter by category
omniroute providers available --json                 # Machine-readable JSON

类别：api-key、oauth、free、local、combo。

已配置的提供商连接

omniroute providers list                             # Connections in your DB
omniroute providers list --json

测试连接

omniroute providers test <id|name>                   # Test one configured connection
omniroute providers test-all                         # Test every active connection (TUI progress)
omniroute providers validate                         # Local-only structural validation (no HTTP)

test-all 会打开交互式 TUI，实时显示每个连接通过或失败的状态。使用 --json 获取机器可读的结果：

omniroute providers test-all --json

API 密钥管理（OmniRoute 密钥）

这些命令管理在 API Manager 下签发的 OmniRoute API 密钥，而非提供商凭据。

omniroute keys list                                  # List all OmniRoute API keys
omniroute keys add <provider> [apiKey]               # Add an API key for a provider
omniroute keys remove <provider>                     # Remove an API key
omniroute keys regenerate <id>                       # Regenerate (rotate) a key
omniroute keys revoke <id>                           # Revoke a key (disables it)
omniroute keys reveal <id>                           # Show the full key value
omniroute keys usage <id>                            # Show usage stats for a key

omniroute keys rotate <id>                           # Rotate + revoke old key atomically
omniroute keys expiration list                       # List key expiration times
密钥策略
omniroute keys policy show <id>                      # Show rate-limit / permission policy
omniroute keys policy set <id> \
  --rate-limit 100 \
  --rate-window minute \
  --permissions chat,models                          # Set policy on a key

模型

omniroute models                                     # List all models (all providers)
omniroute models openai                              # Filter by provider
omniroute models --search gpt                        # Search by name
omniroute models --json                              # JSON output

OAuth 提供商

omniroute oauth list                                 # List OAuth-configured providers
omniroute oauth login <provider>                     # Start browser-based OAuth flow
omniroute oauth logout <provider>                    # Revoke OAuth token
omniroute oauth status <provider>                    # Show token state + expiry
omniroute oauth refresh <provider>                   # Force token refresh

对于 OAuth 提供商（Gemini、Windsurf、Antigravity 等），login 命令会在浏览器中打开 OmniRoute 控制面板的 OAuth 流程。

提供商节点（多账户路由）

提供商节点让你可以将多个 API 密钥/账户关联到一个逻辑提供商，以实现轮询或故障转移。

omniroute nodes list <provider>                      # List nodes for a provider
omniroute nodes add <provider> --api-key <key>       # Add a node
omniroute nodes remove <provider> <nodeId>           # Remove a node
omniroute nodes test <provider> <nodeId>             # Test one node

路由组合（CLI）

在终端中创建和管理路由组合：

omniroute combo list                                 # List all combos
omniroute combo create <name> \
  --strategy priority \
  --targets anthropic/claude-opus-4-7,openai/gpt-4o  # Create combo
omniroute combo switch <name>                        # Activate a combo as default
omniroute combo delete <name>                        # Delete a combo
omniroute combo suggest --task "code review"         # Ask OmniRoute to recommend a combo

有关组合的完整 REST API，请参阅 omni-combos-routing skill。

配额与用量

omniroute quota                                      # Provider quota usage + reset times
omniroute usage                                      # Request + token usage summary
omniroute cost                                       # Cost breakdown (by provider/model)

压缩（CLI）

omniroute compression status                         # Current compression mode + savings stats
omniroute compression set --mode rtk                 # Enable RTK compression
omniroute compression set --mode stacked             # Enable stacked (RTK + Caveman)
omniroute compression set --mode off                 # Disable compression
omniroute compression preview --mode rtk --text "..."  # Preview savings for sample text

健康状态

omniroute health                                     # Detailed health: circuit breakers, cache, memory

错误

  • providers test <id> 失败并返回 401 → 为该提供商存储的 API 密钥有误；使用 keys remove + keys add 重置
  • oauth login 打开但未完成 → OAuth 令牌端点可能被防火墙阻止；改用 API 密钥认证
  • combo create 失败并提示 strategy unknown → 使用以下策略之一：priority、weighted、round-robin、fill-first、least-used、cost-optimized、auto、random、strict-random、p2c、reset-aware、lkgp、context-optimized、context-relay

评论

支持 Markdown