用途：Opper CLI 是 Opper 官方命令行工具，npm 包名为 @opperai/cli，源码见 github.com/opper-ai/cli，需 Node.js ≥ 20.12。除封装 API 外，还能启动编码智能体（Claude Code、OpenCode、Codex、Hermes、Pi）并将其模型流量经 Opper 路由，安装随附技能文档，以及把 AI 代码编辑器接入 Opper。
主要能力：登录与身份（login/logout/whoami，OAuth 设备流）；配置槽位（config list/get/remove）；调用函数（call，写入类 legacy /v3/call，官方提示该接口正在下线，不要据此构建应用）；函数管理（functions list/get/delete）；知识库 indexes（随知识库功能一同下线）；模型 models list/create/get/delete；追踪 traces list/get/delete；用量分析 usage list（可导出 CSV）；图像生成 image generate；智能体 agents list 与 launch；编辑器 editors list/opencode/continue；技能 skills list/install/update/uninstall；version。
使用方式：安装 npm i -g @opperai/cli，然后 opper --version、opper login（推荐，浏览器交互，无需手输密钥）、opper whoami。鉴权状态存于 ~/.opper/config.json 的槽位列表，可用 --key <slot> 选择槽位（默认 default）；请求时优先级为 OPPER_API_KEY 环境变量 > --key 指定槽位。无参数运行进入交互菜单（Account · Agents · Skills · Opper）。启动智能体示例：opper agents list、opper launch claude、opper launch opencode、opper launch codex、opper launch hermes、opper launch pi，加 --install 可同时安装上游智能体；智能体名后的参数原样转发。应用密钥可用 opper keys create --project <uuid> --name <name> --output <env-file> 私密交付，勿打印密钥。全局标志包括 --key、--debug、--no-telemetry、--no-color、-v/--version、-h/--help。
适用场景：终端内完成 Opper 平台的登录、调用、追踪与用量查看，以及把编码智能体或编辑器统一路由到 Opper。
限制与注意：子命令与参数变化较快，应以 opper --help 和 opper <command> --help 为准。OPPER_API_KEY 一旦设置会覆盖 --key。call 的 /v3/call 正在下线，仅适合临时试探。模型标识用 provider/id-with-dashes（如 anthropic/claude-sonnet-4-6），版本也用短横线；自定义模型基于 LiteLLM。usage list --fields 不接受 count，cost 与 count 始终返回。技能安装到 ~/.claude/skills/ 与 ~/.codex/skills/，Codex 还会在 ~/.codex/config.toml 注册。本技能副本可能过期，建议对照 skills.opper.ai/versions.json 检查版本。智能体接入矩阵、许可证等最新信息以官方 README 为准。