Nanocoder

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

{
  "nanocoder": {
    "providers": [
      {
        "name": "Kunavo",
        "baseUrl": "https://api.kunavo.com/v1",
        "apiKey": "${KUNAVO_API_KEY}",
        "models": ["claude-sonnet-5", "claude-haiku-4-5", "gpt-5-6-sol"]
      }
    ]
  }
}

分步操作

1. 在 /app/keys 创建密钥并复制——密钥只会显示一次。请将其导出为 KUNAVO_API_KEY，不要直接粘贴到文件中：Nanocoder 会递归替换提供商条目中每个字符串里的 $VAR、${VAR} 和 ${VAR:-default}，并从工作目录读取 .env。
2. 在 Nanocoder 中运行 /settings providers，然后选择 自定义提供商。向导会按自身顺序询问 提供商名称、基础 URL、API 密钥（可选）、模型名称和 请求超时，并提供从端点获取模型列表的选项——Kunavo 会返回 GET /v1/models，因此该操作会自动填充列表。
3. 或者跳过向导，使用上面的配置块自行编写 agents.config.json。请注意，设置按文件解析：如果项目级文件定义了 nanocoder.providers，就会使用该文件中的整个配置块，因此不会将全局配置中的条目合并进来。
4. 设置上下文窗口。Nanocoder 按以下顺序解析上下文限制：/context-max、contextWindows[model]、contextWindow、NANOCODER_CONTEXT_LIMIT，然后是 models.dev。Kunavo 不是 models.dev 提供商，因此如果前四项都未设置，Nanocoder 会按一个并非你的模型实际限制的后备值进行预算。相关数值见 /models。
5. 打开 /model，选择你列出的某个 ID——选择器会将它们显示在你提供的 name 下——然后运行一个需要调用工具的小任务。如果某个模型返回格式错误的工具调用，可使用 disableToolModels 按模型单独关闭，而不是按提供商关闭。

已于 2026年9月21日 对照 Nanocoder 的自定义提供商页面 检查。第三方设置会发生变化；如果这里的字段名称不再与你看到的内容一致，应以该页面为准，而不是本页。

调试客户端前先验证

一个请求即可确定故障来自端点、密钥还是配置文件。如果返回 JSON，则相同的基础 URL 和密钥可以在 Nanocoder 中使用。

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

字段中应填写哪个模型 ID

每个文本模型都可通过模型 ID 访问——实时列表见 GET /v1/models，包含价格的目录见模型页面。费率单位为每 1M token 的美元，格式为输入 / 输出。