文档

文档

集成

Kunavo 支持所有主流客户端都已支持的两种线路格式,因此集成只需配置 base URL 和密钥,无需 SDK。以下是各客户端的具体配置方法。

Kunavo 是一个独立且兼容 OpenAI 的 AI API 网关:只需一个 API 密钥和一个按量付费余额,即可调用 Claude、GPT 以及图像、视频和音频模型,无需为每个提供商单独开设账户。 无需安装 Kunavo SDK:任何带有 base URL 字段的客户端都能使用。将兼容 OpenAI 的客户端指向 https://api.kunavo.com/v1,或将 Anthropic 风格的客户端指向 https://api.kunavo.com,并提供 Kunavo 密钥。

这两种格式有意在 /v1 上采用不同约定:OpenAI SDK 要求将其包含在 base_url 中,而 Anthropic 客户端会自行追加 /v1/messages,因此只需提供基础域名。弄反是最常见的配置错误——请参阅ANTHROPIC_BASE_URL 页面。下方每个页面都会说明相应客户端需要哪种格式,以及其配置最近一次依据客户端自身文档核对的日期。

编程智能体、编辑器和命令行工具

这些客户端都设有自定义提供商字段,并且都将“兼容 OpenAI”或“Anthropic”视为一种协议,而非供应商——因此,在兼容 OpenAI 的提供商中输入 Claude 模型 ID 是预期用法,不是变通方法。

OpenClawAnthropic

在 ~/.openclaw/openclaw.json 里加一个 models.providers 条目——baseUrl https://api.kunavo.com,api "anthropic-messages"——就能让常驻的 OpenClaw 智能体使用 Claude;cacheRetention 要一并设置,因为不设它,自定义 Anthropic 端点收不到任何缓存标记。

核对于 2026年10月5日

Hermes AgentAnthropic

在 ~/.hermes/config.yaml 里写一个命名提供商——api https://api.kunavo.com,transport anthropic_messages,用 provider: custom:kunavo 选中——就能让 Hermes Agent 通过 Messages 协议跑在 Claude 上,在这种协议下它会自己发送缓存标记和输出上限。

核对于 2026年10月5日

Claude CodeAnthropic

两个环境变量 — ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN — 无需改变安装即可让 Claude Code 使用按量付费。

核对于 2026年10月3日

Kilo CodeOpenAI

Providers → Custom provider → OpenAI Compatible,基础 URL 保留 /v1,并填入 Claude 模型 ID — Kilo Code 不会知道背后的厂商。

核对于 2026年9月6日

Roo CodeOpenAI

选择 OpenAI Compatible 提供商,粘贴基础 URL 和密钥,并设置模型的上下文窗口与最大输出,使 Roo Code 的预算计算准确。

核对于 2026年9月6日

ClineOpenAI

Cline 的 OpenAI Compatible 提供商需要基础 URL、密钥和模型 ID,还需要每个模型的价格,以显示实时会话成本。

核对于 2026年9月6日

Codex CLIOpenAI

在 ~/.codex/config.toml 中添加 [model_providers.kunavo] 配置块并设置 env_key,使密钥保留在环境变量中而不会写入配置文件。

核对于 2026年9月6日

opencodeOpenAI

在 opencode.json 中添加一个提供商配置块 — 聊天补全使用 @ai-sdk/openai-compatible,需要 /v1/responses 接口时使用 @ai-sdk/openai。

核对于 2026年9月6日

Claude Code RouterAnthropic

CCR 现在是桌面应用,不再使用 config.json:将 Kunavo 添加为自定义 API 端点,然后让其路由规则将每类请求发送到不同模型。

核对于 2026年9月6日

ZedOpenAI

settings.json 中的 language_models.openai_compatible 配置块声明端点及其模型;密钥放在 Agent Panel 界面中,绝不写入文件。

核对于 2026年9月6日

ContinueOpenAI

Continue 的 `openai` 提供商名称代表协议而非厂商:提供 apiBase,并为每个模型 — 聊天、编辑、自动补全 — 在 config.yaml 中分别添加条目。

AiderOpenAI

设置 OPENAI_API_BASE 和 OPENAI_API_KEY,然后运行 `aider --model openai/<id>` — 这个前缀会将 ID 路由到你的端点,而不是 Aider 的提供商表。

CC SwitchAnthropic

添加 Kunavo 作为 Custom Configuration:端点填写服务根地址,认证字段填写 ANTHROPIC_AUTH_TOKEN,使用原生 Anthropic Messages — Claude Code 端无需本地路由。

Claude Agent SDKAnthropic

不存在 base_url 选项 — SDK 会启动 Claude Code CLI 并传递完整环境,因此可通过 ANTHROPIC_BASE_URL 路由,或由 ClaudeAgentOptions(env=...) 按客户端设置。

AmpOpenAI

在 Amp 的 Model Routing 中添加 Custom URL 连接 — API format 设为 chat-completions,基础 URL 为 https://api.kunavo.com/v1,密钥作为 bearer token — 在支持该选项的档位中,将映射模型切换到一个密钥。

核对于 2026年9月21日

GitHub Copilot CLIOpenAI

四个环境变量 — COPILOT_PROVIDER_BASE_URL、COPILOT_PROVIDER_TYPE、COPILOT_PROVIDER_API_KEY 和 COPILOT_MODEL — 将 Copilot CLI 切换到你自己的端点;GitHub 说明 BYOK 无需 GitHub 登录。

核对于 2026年9月21日

CrushOpenAI

Crush 的配置是 Bash — 在 crushrc 中添加一行 `provider add kunavo --type openai-compat --base-url "https://api.kunavo.com/v1"`,即可让 Charm 的终端代理使用 Claude 与 GPT。

核对于 2026年9月21日

DeepSeek HarnessOpenAI

Settings → Models → “Add model provider” → “Custom model API” 需要五个字段 — Provider ID、显示名称、基础 URL、API 协议和 API 密钥 — 让 Claude 与 GPT 和内置 DeepSeek 卡片一起出现在同一个选择器中。

核对于 2026年10月1日

DyadOpenAI

Dyad 可通过 Settings → AI Providers → Add Custom Provider 接入任何 OpenAI 兼容端点:API Base URL 填写 https://api.kunavo.com/v1,密钥填写在提供商自己的页面中,然后每个模型 ID 添加一行 Add Custom Model。

核对于 2026年9月21日

Factory DroidAnthropic

在 ~/.factory/settings.json 中添加 customModels 条目 — model、baseUrl 和 provider — 让 Droid 使用任何支持 Anthropic Messages 或 OpenAI Chat Completions 的端点。

核对于 2026年9月21日

gooseOpenAI

Settings → Models → Configure providers → OpenAI:Host URL 填写裸源地址,因为 goose 会自行追加请求路径(v1/chat/completions)。

核对于 2026年9月29日

Jan AgentOpenAI

运行一行 `jan config set --base-url https://api.kunavo.com/v1` 即可将 Kunavo 写入 ~/.jan/config.toml,Jan Agent 预览 CLI(不自带推理引擎)会使用该密钥运行。

核对于 2026年9月21日

Junie CLIOpenAI

Junie CLI 在 $JUNIE_HOME/models/ 中通过 JSON 配置文件接收自定义端点,其中 baseUrl 是完整端点 URL,fasterModel 决定辅助流量的去向。

核对于 2026年9月21日

Kimi CodeOpenAI

Kimi Code 将提供商保存在 ~/.kimi-code/config.toml 中 — 设置 providers.<name>.base_url 为 https://api.kunavo.com/v1,type = "openai",CLI 即可通过一个密钥运行 Claude 和 GPT ID。

核对于 2026年9月21日

mini-SWE-agentOpenAI

mini-SWE-agent 没有基础 URL 环境变量 — 端点写在 YAML 配置的 model.model_kwargs.api_base 下,mini 会将其直接传给 litellm.completion。

核对于 2026年9月21日

Mistral Vibe CLIOpenAI

在 .vibe/config.toml 中添加五行 [[providers]] 配置块 — api_base、api_key_env_var、api_style — 将 Vibe CLI 指向 Kunavo,密钥保存在环境变量而非文件中。

核对于 2026年9月21日

Msty GoOpenAI

Settings &gt; Model Providers 需要填写 Base URL 和 API key — 共五个文档字段,其中两个需要你根据 Msty Go 自身文档进行测试确认。

核对于 2026年9月21日

NanocoderOpenAI

在 agents.config.json 的 nanocoder.providers 下添加 Custom Provider 条目 — name、baseUrl、apiKey、models — 无需 sdkProvider,因为默认值就是 openai-compatible。

核对于 2026年9月21日

Oh My PiOpenAI

在 ~/.omp/agent/models.yml 中添加提供商配置块 — baseUrl、api、apiKey — 将 Oh My Pi 指向 Kunavo,发现功能会通过 GET /v1/models 填充模型列表。

核对于 2026年9月21日

Open InterpreterOpenAI

在 ~/.openinterpreter/config.toml 中添加一个 [model_providers.kunavo] 表 — base_url、env_key、wire_api = "chat" — Rust 终端代理即可运行密钥可访问的任意模型。

核对于 2026年9月21日

OpenHandsOpenAI

Settings → LLM → Advanced 需要填写三个字段 — Custom Model、Base URL、API Key — 模型 ID 带有 openai/ 前缀,基础 URL 保留 /v1。

核对于 2026年9月21日

PiOpenAI

在 ~/.pi/agent/models.json 中添加自定义提供商配置块 — baseUrl、api 和模型 ID — 让 Earendil 的 Pi 终端编程代理通过一个密钥使用 Claude 与 GPT。

核对于 2026年10月1日

QoderOpenAI

Qoder Settings → Models → + Add → Provider → Custom 需要 OpenAI 兼容的 Base URL、API Key 和手动输入的 Model IDs — 因此独立 Qoder 桌面应用可以访问 Claude 和 GPT,它们都不在自身目录中。

核对于 2026年9月21日

Qwen CodeOpenAI

Qwen Code 从 ~/.qwen/settings.json 的 modelProviders 读取端点 — 一个包含 baseUrl 和 envKey 的条目即可让 Claude 与 GPT 出现在其 /model 选择器中。

核对于 2026年9月21日

Theia IDEOpenAI

在 ai-features.openAiCustom.customOpenAiModels 中添加一条配置 — model、url 和 apiKey — 即可让 Theia Coder、Architect 和内联补全使用 Kunavo。

核对于 2026年9月21日

twinnyOpenAI

twinny 没有基础 URL 字段 — Add provider → OpenAI-compatible server,然后填写 Protocol https、Hostname api.kunavo.com、Port 留空、API path /v1,其聊天面板即可使用你的密钥。

核对于 2026年9月21日

聊天客户端和自托管界面

桌面应用和自托管前端,使用亮点是通过同一个模型选择器使用一把密钥和同一笔余额,而无需为每个供应商分别注册账户。

Open WebUIOpenAI

在 Admin Settings 中添加一个 OpenAI 连接,或在容器启动时设置 OPENAI_API_BASE_URL 和 OPENAI_API_KEY — 两者最终都指向同一个 /v1。

核对于 2026年9月6日

Cherry StudioOpenAI

Settings → Model Services → 自定义提供商:粘贴密钥和 API 地址,点击 Get Model List,整个目录就会填充到选择器中。

核对于 2026年10月1日

ChatboxOpenAI

添加一个类型为 OpenAI API Compatible 的提供商,将 API Host 设置为服务根地址 — Chatbox 会自行追加 /v1/chat/completions。

核对于 2026年9月6日

LobeChatOpenAI

三个环境变量 — OPENAI_API_KEY、OPENAI_PROXY_URL 和 OPENAI_MODEL_LIST — 将 Claude 与 GPT 放入同一个自托管 LobeChat 选择器。

SillyTavernOpenAI

将 SillyTavern 的 Chat Completion 来源指向 Kunavo,使用自定义端点和一个 API 密钥 — Claude 与 GPT 会出现在同一个模型下拉菜单中。

Janitor AIOpenAI

API Settings → Proxy → Add Configuration:Proxy URL 是完整的 /v1/chat/completions 路径,Model Name 必须精确填写目录 ID。

核对于 2026年9月6日

OllamaOpenAI

Ollama 与 Kunavo 的 OpenAI 兼容接口形状相同,因此为本地 Ollama 编写的工具只需更改基础 URL 即可切换。

AnythingLLMOpenAI

AnythingLLM 通过名为 Generic OpenAI 的提供商访问没有专用提供商的端点 — 基础 URL 保留 /v1,填写密钥和模型 ID;由于它不会获取列表,模型 ID 需手动输入。

核对于 2026年9月21日

ChatWiseOpenAI

Settings → Providers → “+” 通过三个字段创建自定义提供商 — Provider name、设置为 https://api.kunavo.com/v1 的 API Base URL 和 API Key — 随后 Fetch 会从端点读取模型列表。

核对于 2026年9月21日

DifyOpenAI

一个必填字段 — OpenAI-API-compatible 插件 Add Model 表单中的 API Base URL — 可将 Dify 工作区中的所有 LLM 节点指向 Kunavo。

核对于 2026年9月21日

LibreChatOpenAI

LibreChat 在 librechat.yaml 中通过 endpoints.custom 配置网关 — 四个必填字段,密钥来自 .env,并需要重启后选择器才会显示。

核对于 2026年9月21日

Msty StudioOpenAI

Model Hub > Model Providers > Add Provider > Open AI Compatible:填写 API Key 和 https://api.kunavo.com/v1 的 Inference Endpoint — 应用自身说明指出,大多数 OpenAI 兼容端点需要 /v1。

核对于 2026年10月1日

n8nOpenAI

OpenAI 凭据的 Base URL 字段填写 https://api.kunavo.com/v1,并保留 /v1,即可让 n8n 工作流中的所有 OpenAI Chat Model 使用 Kunavo;模型节点本身没有端点字段。

核对于 2026年10月1日

NextChatOpenAI

三个环境变量 — OPENAI_API_KEY、BASE_URL(裸源地址)和 CUSTOM_MODELS — 让自托管 NextChat 通过一个密钥接入 Claude 与 GPT。

核对于 2026年9月21日

Copilot for ObsidianOpenAI

Settings → Copilot → BYOK → Add a custom provider:填写 Display name、密钥和 https://api.kunavo.com/v1 — 始终支持 Quick Chat;当提供商显示在 opencode 下时支持 Agent Chat。

核对于 2026年9月21日

Page AssistOpenAI

Settings → OpenAI Compatible API → Add Provider → Custom:填写 Provider Name、保留 /v1 的 Base URL 和密钥 — 然后从 Page Assist 自动获取的列表中勾选模型 ID。

核对于 2026年9月21日

TypingMindOpenAI

Models → Add custom model:填写完整 Endpoint URL https://api.kunavo.com/v1/chat/completions、包含 Bearer 和密钥的 Authorization 标头、Model ID 及其上下文长度 — 每个模型添加一条,直接从浏览器调用。

核对于 2026年10月1日

其他客户端

未在此列出的客户端几乎肯定也能使用。判断方法是看它是否允许更改端点:如果有“base URL”、“自定义端点”或“兼容 OpenAI 的提供商”设置,就可以接入 Kunavo。先从快速入门开始,然后根据客户端支持的格式,参阅聊天补全或Messages API。模型 ID 来自 GET /v1/models,也会用于填充带模型下拉菜单的客户端;完整的机器可读规范是OpenAPI 3.1 描述,大多数客户端生成器和智能体框架都可以直接使用。