aivo:统一管理多模型 API 与编码代理的 CLI 工具
aivo 是一款命令行工具,可集中管理多模型 API 密钥并启动 Claude Code、Codex、Gemini CL…
aivo 是一款面向开发者的命令行工具,定位是「在同一个终端入口里管理多模型 API 密钥并启动不同的编码代理」。它以单一二进制形式提供,支持 macOS、Linux、WSL 和 Windows,安装方式包括一键脚本、PowerShell 脚本以及 Homebrew(brew install yuanchuan/tap/aivo)。
核心能力
工具围绕三块功能展开:
- API 密钥管理:支持 OpenRouter、Vercel AI Gateway、DeepSeek、Cloudflare、Google AI Studio、Amazon Bedrock 等服务商的 API Key,以及 Codex、SuperGrok、GitHub Copilot、Cursor 的 OAuth 登录;同时兼容 Ollama、LM Studio、llama.cpp 等本地模型。所有密钥在本地加密保存,可通过
aivo keys子命令进行新增、列表、激活、查看、编辑、健康检查(ping)和重新授权(reauth)。 - 密钥导入导出:通过
aivo keys export与aivo keys import在多台机器之间迁移,支持密码加密文件以及从 URL 直接导入,并提供--password-stdin用于 CI 脚本场景。 - 编码代理启动器:可一键调用 Claude Code、Codex、Gemini CLI、Pi、Grok CLI、OpenCode、Amp 等多个主流或开源编码代理,统一通过
-k选择密钥、-m选择模型,未传值时会打开交互式选择面板。
多模型与槽位绑定
aivo 的一个关键设计是支持为同一代理的不同「槽位」分别指定模型。例如 Claude Code 在一次会话内会用到 haiku、sonnet、opus、fable 等多个角色,用户可以用 --sonnet-model、--haiku-model、--opus-model、--fable-model、--subagent-model 等参数为每个槽位绑定不同模型,例如:
aivo claude --sonnet-model deepseek-v4-pro --haiku-model deepseek-v4-flashaivo claude --fable-model gpt-5.4 --subagent-model claude-haiku-4-5
Codex 支持 --review-model 与 --subagent-model,Amp 则针对 rush、smart、deep、large 四种模式分别提供 --smart-model、--rush-model 等参数。文档给出的示例里也出现了 moonshotai/kimi-k2.5、xiaomi/mimo-v2-pro、z-ai/glm-4.7、composer-2.5 等第三方模型标识,说明工具对 OpenRouter 风格的多模型路由有较深适配。
内置代理与兼容性细节
工具自带名为 Aivo Code 的内置编码代理,可复用同一套密钥在「前沿 API」与「本地 GGUF」之间切换。Pi 代理支持多协议,aivo 默认在本地插入一个路由器对流做归一化,传入 --transparent 后可让 Pi 直连上游并自行处理协议类型。Codex 桌面应用以实验性方式支持,通过 aivo codex-app 启动,原生应用内的模型选择器仅显示以 gpt- 或 claude- 开头的模型,其它模型仍可工作但不会出现在 UI 里。Amp 的支持以独立插件形式分发,需要先执行 aivo plugins install github:yuanchuan/aivo-amp 再运行 aivo amp。
总体来看,aivo 并非新模型或新研究,而是一层面向多模型编码代理的「统一入口与密钥管家」,对需要在 Claude、Codex、Gemini、Grok、OpenCode 等代理之间频繁切换并希望集中管理凭据的开发者而言,是一个降低操作成本的实用工具。
