文档
集成
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 是预期用法,不是变通方法。
在 ~/.openclaw/openclaw.json 里加一个 models.providers 条目——baseUrl https://api.kunavo.com,api "anthropic-messages"——就能让常驻的 OpenClaw 智能体使用 Claude;cacheRetention 要一并设置,因为不设它,自定义 Anthropic 端点收不到任何缓存标记。
核对于 2026年10月5日
在 ~/.hermes/config.yaml 里写一个命名提供商——api https://api.kunavo.com,transport anthropic_messages,用 provider: custom:kunavo 选中——就能让 Hermes Agent 通过 Messages 协议跑在 Claude 上,在这种协议下它会自己发送缓存标记和输出上限。
核对于 2026年10月5日
两个环境变量 — ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN — 无需改变安装即可让 Claude Code 使用按量付费。
核对于 2026年10月3日
Providers → Custom provider → OpenAI Compatible,基础 URL 保留 /v1,并填入 Claude 模型 ID — Kilo Code 不会知道背后的厂商。
核对于 2026年9月6日
选择 OpenAI Compatible 提供商,粘贴基础 URL 和密钥,并设置模型的上下文窗口与最大输出,使 Roo Code 的预算计算准确。
核对于 2026年9月6日
Cline 的 OpenAI Compatible 提供商需要基础 URL、密钥和模型 ID,还需要每个模型的价格,以显示实时会话成本。
核对于 2026年9月6日
在 ~/.codex/config.toml 中添加 [model_providers.kunavo] 配置块并设置 env_key,使密钥保留在环境变量中而不会写入配置文件。
核对于 2026年9月6日
在 opencode.json 中添加一个提供商配置块 — 聊天补全使用 @ai-sdk/openai-compatible,需要 /v1/responses 接口时使用 @ai-sdk/openai。
核对于 2026年9月6日
CCR 现在是桌面应用,不再使用 config.json:将 Kunavo 添加为自定义 API 端点,然后让其路由规则将每类请求发送到不同模型。
核对于 2026年9月6日
settings.json 中的 language_models.openai_compatible 配置块声明端点及其模型;密钥放在 Agent Panel 界面中,绝不写入文件。
核对于 2026年9月6日
Continue 的 `openai` 提供商名称代表协议而非厂商:提供 apiBase,并为每个模型 — 聊天、编辑、自动补全 — 在 config.yaml 中分别添加条目。
设置 OPENAI_API_BASE 和 OPENAI_API_KEY,然后运行 `aider --model openai/<id>` — 这个前缀会将 ID 路由到你的端点,而不是 Aider 的提供商表。
添加 Kunavo 作为 Custom Configuration:端点填写服务根地址,认证字段填写 ANTHROPIC_AUTH_TOKEN,使用原生 Anthropic Messages — Claude Code 端无需本地路由。
不存在 base_url 选项 — SDK 会启动 Claude Code CLI 并传递完整环境,因此可通过 ANTHROPIC_BASE_URL 路由,或由 ClaudeAgentOptions(env=...) 按客户端设置。
在 Amp 的 Model Routing 中添加 Custom URL 连接 — API format 设为 chat-completions,基础 URL 为 https://api.kunavo.com/v1,密钥作为 bearer token — 在支持该选项的档位中,将映射模型切换到一个密钥。
核对于 2026年9月21日
四个环境变量 — COPILOT_PROVIDER_BASE_URL、COPILOT_PROVIDER_TYPE、COPILOT_PROVIDER_API_KEY 和 COPILOT_MODEL — 将 Copilot CLI 切换到你自己的端点;GitHub 说明 BYOK 无需 GitHub 登录。
核对于 2026年9月21日
Crush 的配置是 Bash — 在 crushrc 中添加一行 `provider add kunavo --type openai-compat --base-url "https://api.kunavo.com/v1"`,即可让 Charm 的终端代理使用 Claude 与 GPT。
核对于 2026年9月21日
Settings → Models → “Add model provider” → “Custom model API” 需要五个字段 — Provider ID、显示名称、基础 URL、API 协议和 API 密钥 — 让 Claude 与 GPT 和内置 DeepSeek 卡片一起出现在同一个选择器中。
核对于 2026年10月1日
Dyad 可通过 Settings → AI Providers → Add Custom Provider 接入任何 OpenAI 兼容端点:API Base URL 填写 https://api.kunavo.com/v1,密钥填写在提供商自己的页面中,然后每个模型 ID 添加一行 Add Custom Model。
核对于 2026年9月21日
在 ~/.factory/settings.json 中添加 customModels 条目 — model、baseUrl 和 provider — 让 Droid 使用任何支持 Anthropic Messages 或 OpenAI Chat Completions 的端点。
核对于 2026年9月21日
Settings → Models → Configure providers → OpenAI:Host URL 填写裸源地址,因为 goose 会自行追加请求路径(v1/chat/completions)。
核对于 2026年9月29日
运行一行 `jan config set --base-url https://api.kunavo.com/v1` 即可将 Kunavo 写入 ~/.jan/config.toml,Jan Agent 预览 CLI(不自带推理引擎)会使用该密钥运行。
核对于 2026年9月21日
Junie CLI 在 $JUNIE_HOME/models/ 中通过 JSON 配置文件接收自定义端点,其中 baseUrl 是完整端点 URL,fasterModel 决定辅助流量的去向。
核对于 2026年9月21日
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-agent 没有基础 URL 环境变量 — 端点写在 YAML 配置的 model.model_kwargs.api_base 下,mini 会将其直接传给 litellm.completion。
核对于 2026年9月21日
在 .vibe/config.toml 中添加五行 [[providers]] 配置块 — api_base、api_key_env_var、api_style — 将 Vibe CLI 指向 Kunavo,密钥保存在环境变量而非文件中。
核对于 2026年9月21日
Settings > Model Providers 需要填写 Base URL 和 API key — 共五个文档字段,其中两个需要你根据 Msty Go 自身文档进行测试确认。
核对于 2026年9月21日
在 agents.config.json 的 nanocoder.providers 下添加 Custom Provider 条目 — name、baseUrl、apiKey、models — 无需 sdkProvider,因为默认值就是 openai-compatible。
核对于 2026年9月21日
在 ~/.omp/agent/models.yml 中添加提供商配置块 — baseUrl、api、apiKey — 将 Oh My Pi 指向 Kunavo,发现功能会通过 GET /v1/models 填充模型列表。
核对于 2026年9月21日
在 ~/.openinterpreter/config.toml 中添加一个 [model_providers.kunavo] 表 — base_url、env_key、wire_api = "chat" — Rust 终端代理即可运行密钥可访问的任意模型。
核对于 2026年9月21日
Settings → LLM → Advanced 需要填写三个字段 — Custom Model、Base URL、API Key — 模型 ID 带有 openai/ 前缀,基础 URL 保留 /v1。
核对于 2026年9月21日
在 ~/.pi/agent/models.json 中添加自定义提供商配置块 — baseUrl、api 和模型 ID — 让 Earendil 的 Pi 终端编程代理通过一个密钥使用 Claude 与 GPT。
核对于 2026年10月1日
Qoder Settings → Models → + Add → Provider → Custom 需要 OpenAI 兼容的 Base URL、API Key 和手动输入的 Model IDs — 因此独立 Qoder 桌面应用可以访问 Claude 和 GPT,它们都不在自身目录中。
核对于 2026年9月21日
Qwen Code 从 ~/.qwen/settings.json 的 modelProviders 读取端点 — 一个包含 baseUrl 和 envKey 的条目即可让 Claude 与 GPT 出现在其 /model 选择器中。
核对于 2026年9月21日
在 ai-features.openAiCustom.customOpenAiModels 中添加一条配置 — model、url 和 apiKey — 即可让 Theia Coder、Architect 和内联补全使用 Kunavo。
核对于 2026年9月21日
twinny 没有基础 URL 字段 — Add provider → OpenAI-compatible server,然后填写 Protocol https、Hostname api.kunavo.com、Port 留空、API path /v1,其聊天面板即可使用你的密钥。
核对于 2026年9月21日
聊天客户端和自托管界面
桌面应用和自托管前端,使用亮点是通过同一个模型选择器使用一把密钥和同一笔余额,而无需为每个供应商分别注册账户。
在 Admin Settings 中添加一个 OpenAI 连接,或在容器启动时设置 OPENAI_API_BASE_URL 和 OPENAI_API_KEY — 两者最终都指向同一个 /v1。
核对于 2026年9月6日
Settings → Model Services → 自定义提供商:粘贴密钥和 API 地址,点击 Get Model List,整个目录就会填充到选择器中。
核对于 2026年10月1日
添加一个类型为 OpenAI API Compatible 的提供商,将 API Host 设置为服务根地址 — Chatbox 会自行追加 /v1/chat/completions。
核对于 2026年9月6日
三个环境变量 — OPENAI_API_KEY、OPENAI_PROXY_URL 和 OPENAI_MODEL_LIST — 将 Claude 与 GPT 放入同一个自托管 LobeChat 选择器。
将 SillyTavern 的 Chat Completion 来源指向 Kunavo,使用自定义端点和一个 API 密钥 — Claude 与 GPT 会出现在同一个模型下拉菜单中。
API Settings → Proxy → Add Configuration:Proxy URL 是完整的 /v1/chat/completions 路径,Model Name 必须精确填写目录 ID。
核对于 2026年9月6日
Ollama 与 Kunavo 的 OpenAI 兼容接口形状相同,因此为本地 Ollama 编写的工具只需更改基础 URL 即可切换。
AnythingLLM 通过名为 Generic OpenAI 的提供商访问没有专用提供商的端点 — 基础 URL 保留 /v1,填写密钥和模型 ID;由于它不会获取列表,模型 ID 需手动输入。
核对于 2026年9月21日
Settings → Providers → “+” 通过三个字段创建自定义提供商 — Provider name、设置为 https://api.kunavo.com/v1 的 API Base URL 和 API Key — 随后 Fetch 会从端点读取模型列表。
核对于 2026年9月21日
一个必填字段 — OpenAI-API-compatible 插件 Add Model 表单中的 API Base URL — 可将 Dify 工作区中的所有 LLM 节点指向 Kunavo。
核对于 2026年9月21日
LibreChat 在 librechat.yaml 中通过 endpoints.custom 配置网关 — 四个必填字段,密钥来自 .env,并需要重启后选择器才会显示。
核对于 2026年9月21日
Model Hub > Model Providers > Add Provider > Open AI Compatible:填写 API Key 和 https://api.kunavo.com/v1 的 Inference Endpoint — 应用自身说明指出,大多数 OpenAI 兼容端点需要 /v1。
核对于 2026年10月1日
OpenAI 凭据的 Base URL 字段填写 https://api.kunavo.com/v1,并保留 /v1,即可让 n8n 工作流中的所有 OpenAI Chat Model 使用 Kunavo;模型节点本身没有端点字段。
核对于 2026年10月1日
三个环境变量 — OPENAI_API_KEY、BASE_URL(裸源地址)和 CUSTOM_MODELS — 让自托管 NextChat 通过一个密钥接入 Claude 与 GPT。
核对于 2026年9月21日
Settings → Copilot → BYOK → Add a custom provider:填写 Display name、密钥和 https://api.kunavo.com/v1 — 始终支持 Quick Chat;当提供商显示在 opencode 下时支持 Agent Chat。
核对于 2026年9月21日
Settings → OpenAI Compatible API → Add Provider → Custom:填写 Provider Name、保留 /v1 的 Base URL 和密钥 — 然后从 Page Assist 自动获取的列表中勾选模型 ID。
核对于 2026年9月21日
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 描述,大多数客户端生成器和智能体框架都可以直接使用。