Tool Integrations2026年7月15日Flatkey

Continue.dev OpenAI 兼容提供商：Flatkey 设置指南

将 Continue.dev 与 Flatkey 作为 OpenAI 兼容提供商进行设置：config.yaml、apiBase、模型别名、角色、工具使用检查、端点回退和使用情况审查。

Continue.dev OpenAI 兼容提供商的设置不仅仅是把模型提供商切换一下。对于编码助手来说，这条路由必须证明四件事：Continue 正在读取你想要的 config.yaml，Flatkey 是 OpenAI 提供商背后的基础 URL，你的密钥已启用该模型别名，并且所选模型能够支持你分配给 Continue 的角色。

本指南面向开发者、AI 产品团队、自动化构建者、平台工程师、财务运营人员和采购审核人员，他们希望为 Continue 及其余 AI 工具链提供一条可审查的 OpenAI 兼容路由。它涵盖了当前的 Continue 文档、Flatkey 基础 URL 检查、模型角色、工具使用能力、端点回退、使用可见性以及回滚。

来源说明：本内容于 2026 年 6 月 29 日结合官方 Continue 主页、官方 Continue OpenAI 提供商文档、官方 Continue config.yaml 参考、官方 Continue 模型能力指南以及实时 Flatkey 公共页面进行了检查。Continue 主页当前显示 Continue 已被 Cursor 收购，因此在做出新的全团队推广决策之前，请先确认你需要的 Continue 扩展、CLI 和支持路径。

快速回答：Continue.dev OpenAI 兼容提供商设置

对于使用 Flatkey 的 Continue.dev OpenAI 兼容提供商设置，请在 Continue 的 config.yaml 中将模型配置为 provider: openai，将 apiBase 设置为你当前的 Flatkey 提供商基础 URL，使用 Flatkey API 密钥，并将 model 设置为精确的 Flatkey 模型别名。然后在不依赖 Continue 的情况下先在外部测试相同的基础 URL 和模型别名，再将其用于代码工作区。

Continue 字段	Flatkey 值	审核检查
`provider`	`openai`	Continue 的 OpenAI 提供商文档显示，当 `apiBase` 被覆盖时，可将此提供商用于 OpenAI 兼容端点。
`apiBase`	来自你的控制台或文档的当前 Flatkey 基础 URL，例如在你的账户已验证后为 `https://console.flatkey.ai/v1`	只使用基础 URL。不要把完整的 `/chat/completions` 端点粘贴到 `apiBase` 中。
`apiKey`	由正确的用户、团队或环境拥有的 Flatkey 密钥	使用你的 Continue 版本支持的密钥或环境变量流程。不要提交明文密钥。
`model`	为该密钥启用的精确 Flatkey 模型别名	除非 Flatkey 暴露了该精确别名，否则不要使用供应商系列名称。
`roles` 和 `capabilities`	只分配模型应提供的角色，并且仅在确认支持工具/函数后再添加 `tool_use`	Continue 的能力文档将 `tool_use` 与工具和函数关联起来，这对 Agent 工作流很重要。

安全的顺序是：复制当前的 Flatkey 基础 URL，选择一个账户可见的模型别名，测试 OpenAI 兼容端点，将模型添加到 Continue，运行一个低风险提示词，并在 Flatkey 中验证使用情况。本 Continue.dev OpenAI 兼容提供商指南的其余部分会把这一步变成可重复执行的运行手册。

当前 Continue 文档确认了什么

Continue 现在通过 config.yaml 记录配置。其配置指南说明，本地配置在 macOS/Linux 上位于 ~/.continue/config.yaml，在 Windows 上位于 %USERPROFILE%\.continue\config.yaml。它还说明 Continue 会在文件保存时重新加载配置，这使得小范围的提供商变更很容易测试和回滚。

OpenAI 提供商页面展示了与 Flatkey 相关的关键模式：模型条目可以使用 provider: openai、OpenAI 兼容的模型名称、apiBase 覆盖以及 API 密钥。这使得 Continue.dev OpenAI 兼容提供商路径成为一个基础 URL 和模型别名配置任务，而不是自定义提供商实现任务。

config.yaml 参考补充了运维细节。Continue 模型可以指定 chat、edit 和 autocomplete 等角色。Continue 还可以在自动检测不足时覆盖模型能力，包括 tool_use 和 image_input。请有意识地使用这些字段。一个适合自动补全的模型，可能并不适合代理式工具调用。

还有一个端点细节很重要：Continue 的 OpenAI 提供商文档描述了端点控制，包括旧版 completions 行为，以及在模型路由需要 /chat/completions 时禁用 Responses API。本文检查的 Flatkey 公共定价页列出了包括 /v1/chat/completions 和 /v1/responses 在内的端点系列，但你选择的模型别名和账户权限仍然需要验证。

在编辑 Continue 之前需要确认的 Flatkey 值

Flatkey 首页在 2026 年 6 月 29 日查看时的标题是 One API gateway for production AI teams，并描述了统一的模型访问、路由、计费、使用分析和运营控制。其公开代码示例当前使用 https://console.flatkey.ai/v1/chat/completions，因此 Continue 配置对应的基础 URL 应为 https://console.flatkey.ai/v1，前提是该值已被你的账户确认。

同日查看的 Flatkey 定价页面显示，网站当前有 23 个提供商下的 635 个已启用模型。页面还列出了 chat completions、responses、messages、images 和 video 的端点家族。这些是目录和公开路由事实，并不意味着每个密钥都能调用每个模型。在保存 Continue.dev OpenAI compatible provider 路由之前，请确认该模型别名对 Continue 将使用的 Flatkey 密钥可见。

如果你的团队手头有较旧的 Flatkey 文档、脚本或博客文章，其中提到了不同的基础 URL，请不要盲目复制。应将 Flatkey Console 或当前账户文档视为事实来源，然后从 Continue 将运行的同一台机器上执行下面的预检。

分步操作：使用 Flatkey 配置 Continue

确认 Continue 使用场景。 决定你是在配置 IDE 扩展、CLI，还是已有的本地设置。由于 Continue 首页现在显示它已被 Cursor 收购，在新的推广前请先验证支持与安装路径。
打开当前生效的 config.yaml。 使用 Continue 的配置选择器和齿轮图标，或在 macOS/Linux 上打开 ~/.continue/config.yaml，在 Windows 上打开 %USERPROFILE%\.continue\config.yaml。
记录之前的模型条目。 保存旧的 provider、model、roles 和 endpoint 标志，这样回滚时就可以直接复制粘贴。
复制 Flatkey 基础 URL。 使用 provider 的基础 URL，例如当你的账户已验证时使用 https://console.flatkey.ai/v1。不要在 apiBase 中包含 /chat/completions。
每个角色选择一个模型别名。 先从一个 chat/edit 模型开始，只有在你有专为该角色调优的模型时才添加 autocomplete。
安全存储 Flatkey 密钥。 使用你的 Continue 版本支持的 secret、环境变量或本地凭据模式。不要将原始密钥提交到共享配置中。
添加模型条目。 使用 provider: openai、Flatkey 的 apiBase、Flatkey 模型别名，以及更精确的角色范围。
运行 curl 预检。 在判断 Continue 本身之前，先测试相同的基础 URL、密钥和模型。
运行一次安全的 Continue 提示。 使用一个可丢弃的分支或非破坏性任务，然后在 Flatkey 中检查时间戳、模型、token 和成本。
记录所有权。 记录密钥的负责人、谁可以轮换它、批准的模型别名，以及何时重新审视该路由。

Flatkey 的 config.yaml 模板

这是一个模板，不是通用的即插即用配置。请用你在 Flatkey 账户中确认的值以及你当前的 Continue 版本替换占位符。

name: Flatkey Continue Config
version: 0.0.1
schema: v1

models:
  - name: Flatkey chat and edit
    provider: openai
    model: <flatkey-chat-model-alias>
    apiBase: https://console.flatkey.ai/v1
    apiKey: <load-from-your-continue-secret-or-env-flow>
    roles:
      - chat
      - edit
      - apply
    capabilities:
      - tool_use
    defaultCompletionOptions:
      maxTokens: 2000

  - name: Flatkey autocomplete
    provider: openai
    model: <flatkey-autocomplete-model-alias>
    apiBase: https://console.flatkey.ai/v1
    apiKey: <load-from-your-continue-secret-or-env-flow>
    roles:
      - autocomplete
    autocompleteOptions:
      debounceDelay: 350
      maxPromptTokens: 1024

如果你所选的模型路由在 /responses 上有问题，Continue 的 OpenAI provider 文档描述了一个 useResponsesApi: false 选项。只有在你有证据表明该模型、端点家族或账户路由在该任务上需要 /chat/completions 时，才使用它。

models:
  - name: Flatkey chat completions only
    provider: openai
    model: <flatkey-model-alias>
    apiBase: https://console.flatkey.ai/v1
    apiKey: <load-from-your-continue-secret-or-env-flow>
    useResponsesApi: false
    roles:
      - chat
      - edit

在 Continue 之外对路由进行预检

一个小型的 curl 测试可以将 Flatkey 路由问题与 Continue 配置问题区分开来。请使用你计划写入 config.yaml 的相同基础 URL、密钥和模型别名。

export FLATKEY_API_KEY="fk_replace_me"
export FLATKEY_BASE_URL="https://console.flatkey.ai/v1"
export FLATKEY_CONTINUE_MODEL="replace-with-flatkey-model-alias"

curl "$FLATKEY_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $FLATKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "'"$FLATKEY_CONTINUE_MODEL"'",
    "messages": [
      {
        "role": "user",
        "content": "Return the word ok."
      }
    ],
    "max_tokens": 16
  }'

对于代理式的 Continue.dev OpenAI compatible provider 路由，如果你所选的 Continue 角色需要工具使用，请添加第二个带工具 schema 的预检。普通聊天响应可以证明传输正常，但不能证明函数/工具行为正常。

curl "$FLATKEY_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $FLATKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "'"$FLATKEY_CONTINUE_MODEL"'",
    "messages": [
      {
        "role": "user",
        "content": "Call route_check with status ok and no prose."
      }
    ],
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "route_check",
          "description": "返回路由状态。",
          "parameters": {
            "type": "object",
            "properties": {
              "status": { "type": "string" }
            },
            "required": ["status"]
          }
        }
      }
    ],
    "tool_choice": {
      "type": "function",
      "function": { "name": "route_check" }
    },
    "max_tokens": 64
  }'

一个健康的工具使用响应应包含 OpenAI 风格的 tool_calls 结构。如果此请求失败，请先修正 Flatkey 密钥、base URL、模型别名、端点族或模型能力，然后再修改 Continue。

能力、角色和端点检查清单

决策	需要验证什么	为什么重要
聊天/编辑模型	模型别名可以通过所选的 Flatkey 端点回答代码问题。	这是开发者面向聊天和编辑角色的最低证明。
工具使用	模型在 curl 预检中返回 OpenAI 风格的工具调用。	Continue 的模型能力文档将 `tool_use` 与工具和函数关联起来。
自动补全	独立角色、更短的提示词，并且开发者机器上的延迟可接受。	自动补全的 UX 期望与聊天不同。
Responses API	所选模型路由支持 Continue 正在调用的端点。	某些模型和网关组合需要 `useResponsesApi: false`。
使用情况审查	Flatkey 会在预期的密钥、时间戳、模型和成本下显示该请求。	财务和平台负责人需要一个地方来核对使用情况。

优先排查的失败模式

大多数 Continue.dev OpenAI compatible provider 失败都来自少量不匹配。先检查这些，再假设 Continue 或 Flatkey 已宕机。

症状	可能原因	修复方法
配置未加载	文件错误、YAML 缩进错误，或 IDE 中选中了过期配置。	通过 Continue 的选择器打开配置，验证 YAML，保存，并观察是否重新加载。
无效 API 密钥	密钥复制错误、已轮换、作用域属于其他环境，或来自上游提供商。	生成或选择正确的 Flatkey 密钥，并在更新 Continue 之前用 curl 重新测试。
连接错误	`apiBase` 包含完整端点路径、使用了旧 base URL，或者机器无法访问该路由。	只使用当前提供商的 base URL，并从同一台机器测试。
未找到模型	Continue 的 `model` 值与该密钥启用的 Flatkey 别名不匹配。	从 Flatkey 定价、目录或账户可见的模型列表中复制准确的模型别名。
工具或 Agent 模式失败	所选模型无法生成该角色所期望的工具/函数行为。	使用支持工具的模型，并在设置 `tool_use` 之前重新运行工具调用预检。
特定端点错误	Continue 正在调用 `/responses`，而所选路由应使用 chat completions，或者反过来。	检查 Flatkey 端点支持，并且只在需要时使用 Continue 的端点标志。
无法核对使用情况	团队没有记录密钥所有者、模型别名、开发者、环境或时间戳。	在扩展到更多开发者之前，先添加一行运行手册。

Continue + Flatkey 的生产运行手册

在更多开发者使用 Continue.dev OpenAI compatible provider 路由之前，请记录有助于支持和成本审查的运维事实。

运行手册字段	记录这些内容
负责人	团队、开发组，以及可以轮换 Flatkey 密钥的人员。
Continue 界面	IDE 扩展或 CLI，如有版本号则填写版本，以及配置位置。
Flatkey base URL	当前经账户批准的 base URL 以及检查日期。
模型别名	每个角色一个别名：聊天/编辑、应用、自动补全或工具使用 agent 路径。
端点策略	该路由应使用 responses、chat completions，还是已记录的回退方案。
成本审查	在 Flatkey 中将在哪里审查使用量、token 数、请求状态和成本。
回滚	之前的提供商条目、旧模型别名，以及用于恢复的负责人批准。

这在 Flatkey 工具集群中的位置

如果你的团队已经通过 Flatkey 路由其他工具，那么 Continue 也请保持相同的操作模式。Cherry Studio API 设置指南适合用于简单的桌面客户端基础 URL 检查。CC Switch Claude Code Flatkey指南适合用于开发者工具路由规范。更全面的OpenAI 兼容 API 迁移手册则适合用于统一基础 URL 更改、模型别名验证和回滚。

统一路由器的价值不仅仅是减少提供商密钥数量。更重要的是，它能让你看到是哪个工具、模型、密钥所有者和工作流产生了使用量。因此，Continue.dev OpenAI 兼容提供商的迁移，应该以 Flatkey 使用情况检查作为收尾，而不只是确保提示词能正常工作。

常见问题

Continue 现在仍支持 OpenAI 兼容路由吗？

Continue 当前的 OpenAI 提供商文档显示，使用 provider: openai、model、apiBase 和 apiKey 的 OpenAI 兼容配置模式。其主页还说明 Continue 已被 Cursor 收购，因此在新的上线前，请先确认你实际使用的扩展、CLI 以及支持路径。

我应该使用哪个 Flatkey 基础 URL？

请使用你 Flatkey 账户中的当前提供商基础 URL。本文检查到的公开主页显示为 https://console.flatkey.ai/v1/chat/completions，对应的基础 URL 是 https://console.flatkey.ai/v1。如果你的账户文档或控制台显示不同信息，请以它们为准。