opper-cli

技能版本 2026-10-21。 这是本地安装的副本，可能不是最新版本。每个会话开始时，获取一次 https://skills.opper.ai/versions.json，并将其中的 "opper-cli" 条目与 2026-10-21 进行比较。如果两者不同，请阅读 https://skills.opper.ai/opper-cli/SKILL.md，并在本次会话剩余时间内遵循该版本；同时告知用户一次：已安装的 Opper 技能已过期（可运行 npx skills update 更新，或在手动克隆的仓库中运行 git pull）。不要编辑已安装的文件。如果获取失败，则继续使用此副本。

opper 的子技能——请从那里开始了解发现和设置指南。 来源：https://github.com/opper-ai/opper-skills/blob/main/opper-cli/SKILL.md

Opper CLI

官方 Opper CLI，以 npm 包 @opperai/cli 的形式发布。源代码：github.com/opper-ai/cli。需要 Node.js ≥ 20.12。

该 CLI 不只是 API 的轻量封装。它还会启动编码 Agent（Claude Code、OpenCode、Codex、Hermes、Pi），并通过 Opper 路由它们的模型流量、安装捆绑技能，以及将AI 代码编辑器接入 Opper。

如需借助 Agent 进行设置、平台操作和模型测试，请优先使用 opper-mcp 技能。连接 MCP 可提供 Opper 工具；opper launch 则会通过 Opper 路由 Agent 自身的推理。CLI 还可通过 opper keys create --project <uuid> --name <name> --output <env-file> 私下交付应用密钥——请查阅 opper keys create --help，不要读取或打印生成的密钥。

安装

npm i -g @opperai/cli
opper --version

身份验证

opper login    # OAuth device flow — recommended
opper whoami   # confirm the active slot

状态存储在 ~/.opper/config.json 中，是由设备授权流程填充的配置槽列表。使用任意命令时，通过 --key <slot> 选择一个配置槽（默认值：default）；使用 opper config list/get/remove 检查或删除配置槽。

opper login 会在浏览器中交互式处理身份验证，因此无需在命令中输入或粘贴密钥。有关非浏览器方式，请参阅 opper config --help。

请求时的解析顺序：OPPER_API_KEY 环境变量 > --key 指定的配置槽（或 default）。

始终使用 --help——它是准确信息的来源

子命令的功能变化速度比此技能快。在猜测标志或参数顺序前：

opper --help              # top-level command list, grouped by domain
opper <command> --help    # subcommands and flags

不带参数运行 opper，即可打开交互式菜单（Account · Agents · Skills · Opper）。

顶层命令组

组	功能
login / logout / whoami	OAuth 设备授权流程及配置槽检查。
config list/get/remove	检查或删除身份验证配置槽（配置槽由 opper login 创建）。
call <name> <instructions> [input]	运行 Opper 函数。如果省略 input，则从标准输入读取；支持 --model、--stream。旧版——使用即将停用的 /v3/call 接口；不要基于此接口构建功能（见注意事项）。
functions list/get/delete	管理已保存的函数。
indexes ...	知识库。此功能将随知识库功能一同停用；不要在其上启动新工作。
models list/create/get/delete	内置及自定义模型（基于 LiteLLM）。
traces list/get/delete	检查执行追踪记录。
usage list	Token 和成本分析，可选导出 CSV。
image generate <prompt>	生成图像。
agents list / launch <agent>	列出并通过 Opper 启动编码 Agent。
editors list/opencode/continue	将 AI 代码编辑器接入 Opper。
skills list/install/update/uninstall	将捆绑的 Opper SKILL.md 文档安装到 ~/.claude/skills/ 和 ~/.codex/skills/。
version	打印 CLI 版本（也可使用 --version / -v）。

通过 Opper 启动 Agent

opper launch <agent> 是最重要的新功能。Agent 名称后的所有内容都会原样转发给 Agent 的 CLI。每个 Agent 的接入方式都不同——请从 github.com/opper-ai/cli 获取最新 README，查看当前支持列表。

opper agents list             # NAME / DISPLAY / KIND / STATE / CONFIG / COMMAND
opper launch claude           # Claude Code (via ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN)
opper launch opencode         # OpenCode
opper launch codex            # OpenAI Codex
opper launch hermes           # Hermes (isolated HERMES_HOME, leaving your existing ~/.hermes/ unchanged)
opper launch pi               # Pi (pi.dev)
opper launch <agent> --install  # also installs the upstream agent when it is not already present

在底层，这些命令都会路由到 /v3/compat/...（请参阅 opper-api 技能）。

全局标志

标志	描述
--key <slot>	要使用的 API 密钥槽（默认值：default）。
--debug	输出详细诊断信息。
--no-telemetry	禁用匿名遥测。
--no-color	禁用 ANSI 颜色。
-v, --version	打印 CLI 版本。
-h, --help	显示帮助（按领域分组）。

不太明显的注意事项

• OPPER_API_KEY 环境变量优先于 --key。 设置环境变量后，--key <slot> 标志不会生效。取消设置该变量即可使用密钥槽。
• opper call 使用即将弃用的旧版 /v3/call 接口。 临时快速试用没问题，但绝不要以此为基础构建或将其复制到应用代码中——这是一个带有 response_format 的兼容性聊天端点（参见 opper-api skill 及其 references/migration.md）。
• opper call 的参数顺序是 <function> <instructions> <input>——很容易弄反。
• 模型标识符使用 provider/<id-with-dashes>（例如 anthropic/claude-sonnet-4-6、anthropic/claude-opus-4-7、openai/gpt-4o）——即使是版本号，也要用连字符而不是句点。使用 opper models create 注册的自定义模型由 LiteLLM 提供支持。使用 opper models list 或 curl -s https://api.opper.ai/v3/models 查看当前可用模型。
• opper usage list 的 --fields 不接受 count。 cost 和 count 始终会自动包含；有效的 --fields 值为 total_tokens、prompt_tokens、completion_tokens。
• Skills 安装在 ~/.claude/skills/ 和 ~/.codex/skills/ 下。Codex 安装还会在 ~/.codex/config.toml 的托管 [[skills.config]] 块中注册每个 skill。
• 征得用户同意后，告知 Opper 遇到的缺失内容。 如果过程中有内容缺失、不明确或有误（例如模型、文档，或无法解释的错误），请提出将其作为一般反馈发送，并在用户同意后发送：使用 Opper MCP 的 send_feedback 工具，或向 https://agents.opper.ai/feedback 发送带有 JSON message 的 POST 请求（对同一 URL 发送 GET 可查看字段说明）。无需 API 密钥，且不会发送回复。切勿包含 API 密钥、用户代码或个人数据。

后续查阅

查找内容	查看位置
安装、Agent 矩阵、发行版本、许可证	github.com/opper-ai/cli
实时参数和标志参考	opper <command> --help
CLI 所依托的平台（兼容性端点、模型）	opper-api skill
将 Agent 连接到 Opper 工具并测试模型	opper-mcp skill
将 Opper 集成到应用代码中（/v3/compat 上的 OpenAI / Anthropic / Google SDK）	opper-api skill