轻松管理 Agent API

内置本地代理,支持将 Claude Code 订阅、Codex 订阅一键转换成本地 API,一键切换 Agent API。

安装 CLI 版本
$npm i -g @clovapi/cli
$clovapi add --name prod
$clovapi switch --cli claude-code prod

添加的API profile 会经由本地代理提供给目标 Agent CLI

ClovAPI Switcher 桌面客户端界面:管理 Claude Code、Codex 等 Agent 的 API 上游

CLI 能做什么

官方订阅与第三方 API 统一管理,一行命令切换 Claude Code、Codex 等 Agent 上游。

clovapi add

保存上游 profile(官方订阅或第三方 API),持久化前先探测连通性。

clovapi switch

将 profile 应用到目标 CLI。交互式选择,或脚本里用 --cli 指定 Claude Code、Codex 等。

官方订阅支持

支持 Claude Code 与 Codex 官方订阅上游,与第三方 API profile 同样一键切换。

多 CLI 适配

覆盖 Claude Code、Codex、OpenCode、OpenClaw、Hermes、Kimi Code CLI 等编程 Agent。

API 形态自动映射

switch 时按 CLI 自动匹配 anthropic、openai-responses、gemini 等上游协议。

开源跨平台

Go 编写,支持 npm、Homebrew、winget 安装;配置保存在 ~/.config/clovapi。

深度支持四种 API 形态

switch 时按 CLI 自动选择最合适的上游 API 形态,无需手动对照风格表。

openai-chat

/v1/chat/completions · Chat Completions 协议,兼容多数 OpenAI 风格 SDK。

anthropic

/v1/messages · Anthropic Messages API,Claude Code 等 Agent 原生形态。

openai-responses

/v1/responses · OpenAI Responses API,Codex 等 Agent 优先使用的形态。

gemini

GenerateContent · Google Gemini API,面向 Gemini 系 CLI 与工具链。

常见问题

关于 clovapi、支持的 Agent 及与 cc-switch 对比的常见问题。

clovapi 是什么?和 API 网关有什么区别?
clovapi 是面向编程 Agent CLI 的上游 API 管理工具,内置本地代理为核心:switch 后 Agent 请求经 localhost 转发,由代理完成上游路由与 API 形态转码。用 clovapi add 保存 profile,clovapi switch 一键应用到目标 CLI。
支持哪些 Agent CLI?
目前支持 Claude Code、Codex、OpenCode、OpenClaw、Hermes、Kimi Code CLI 等。switch 时会按 CLI 自动选择 anthropic、openai-responses、gemini 等 API 形态。
官方订阅和第三方 API 可以同时管理吗?
可以。Claude Code 与 Codex 官方订阅可作为 profile 保存,与 OpenRouter、SiliconFlow 等第三方 API 同样支持 add 与 switch。
clovapi 和 cc-switch 有什么区别?
两者都提供桌面客户端,并支持 Claude Code、Codex、OpenCode 等多 Agent CLI。clovapi 的核心是内置本地代理:switch 默认经 localhost 转发,由同一代理内核完成 anthropic / openai-responses 等形态转码。cc-switch 更侧重可视化 provider 管理、MCP/Skills/Prompts 同步与可选代理接管。详见 /compare/cc-switch。
如何安装?
可通过 npm(npm i -g @clovapi/cli)、Homebrew 或 winget 安装 CLI,也可下载 macOS / Windows 桌面客户端进行图形化管理。

多种使用方式

图形界面管理 Agent API,也支持 CLI 一行命令安装与切换。