clovapi 是运行在本机的模型 API 代理，用来接入官方订阅和自定义上游，并转换常见 API 协议。

默认监听在哪里？

默认监听 http://127.0.0.1:27483，请求路径形如 /{providerId}/v1/...

支持哪些协议？

支持 Anthropic Messages、OpenAI Chat Completions、OpenAI Responses 和 Gemini 之间的转换。

本地模型 API 代理

接入官方订阅和自定义上游，在本机提供统一的 OpenAI、Anthropic、Gemini 兼容接口。

下载 macOS 版下载 Windows 版

clovapi / 快速开始

$npm i -g @clovapi/cli

$clovapi auth login --provider codex

›✓ Codex subscription connected

$clovapi profiles add --provider custom --api-style responses --model my-model

›✓ Profile custom saved

$clovapi proxy start

›✓ Proxy listening on http://127.0.0.1:27483

$clovapi profiles test --provider custom --model my-model --json

›{"provider":"custom","status":"ok","model":"my-model"}

$curl -s "http://127.0.0.1:27483/usage?refresh=1"

›✓ Codex · 5-hour 24% used · weekly 12% used

本地、统一、可观察

用一个轻量代理管理订阅、上游配置、请求日志和协议转换。

本地管理

订阅登录态、上游地址、密钥和模型配置都保存在本机。

统一入口

用稳定的本地 URL 访问 Codex、Claude、自定义 API 或 Ollama。

订阅接入

把 Codex、Claude 等官方订阅接入到本地模型 API 流程里。

请求可观测

查看入站请求、上游响应片段、token 用量和系统事件。

协议转换

适配 Chat Completions、Responses、Messages 和 Gemini 请求格式。

多种使用方式

可使用 Go core、npm launcher，也可通过 Electron 桌面端管理。

兼容主流 API 风格

客户端按熟悉的格式发起请求，clovapi 负责在本地完成协议适配。

OpenAI Chat Completions

为仍使用经典 OpenAI chat API 的客户端提供 /v1/chat/completions。

Anthropic Messages

接收 /v1/messages 风格请求，并转换到你配置的上游 provider。

OpenAI Responses

支持现代 OpenAI 兼容客户端使用的 /v1/responses。

Gemini

把 Gemini 兼容的 generateContent 请求纳入同一套 provider profile 模型。

常见问题

关于 clovapi 本地代理行为的常见问题。

clovapi 是什么？: clovapi 是运行在本机的模型 API 代理，用来接入官方订阅和自定义上游，并转换常见 API 协议。
默认监听在哪里？: 默认监听 http://127.0.0.1:27483，请求路径形如 /{providerId}/v1/...
支持哪些协议？: 支持 Anthropic Messages、OpenAI Chat Completions、OpenAI Responses 和 Gemini 之间的转换。

让模型请求走同一个本地入口

一次配置订阅和上游，给不同客户端提供稳定、统一、可调试的 API 地址。

下载 macOS 版下载 Windows 版