Tool Integrations15 de julho de 2026Flatkey

Guia de Configuração do Flatkey para o provedor compatível com OpenAI do Continue.dev

Configure o Continue.dev com o Flatkey como provedor compatível com OpenAI: config.yaml, apiBase, aliases de modelo, funções, verificações de uso de ferramentas, fallback de endpoint e revisão de uso.

A configuração do provedor compatível com OpenAI do Continue.dev não é apenas uma troca de provedor de modelo. Para um assistente de programação, o fluxo precisa comprovar quatro coisas: o Continue está lendo o config.yaml pretendido, o Flatkey é a URL base por trás do provedor OpenAI, o alias do modelo está habilitado para sua chave e o modelo selecionado pode suportar a função do Continue que você está atribuindo a ele.

Este guia foi escrito para desenvolvedores, equipes de produto de IA, construtores de automação, engenheiros de plataforma, operadores financeiros e revisores de compras que querem um único caminho revisável, compatível com OpenAI, para o Continue e o restante de suas ferramentas de IA. Ele cobre a documentação atual do Continue, as verificações da URL base do Flatkey, funções de modelo, capacidade de uso de ferramentas, fallback de endpoint, visibilidade de uso e reversão.

Nota de origem: isso foi verificado em 29 de junho de 2026 contra a página inicial oficial do Continue, a documentação oficial do provedor OpenAI do Continue, a referência oficial do config.yaml do Continue, o guia oficial de capacidades de modelo do Continue e páginas públicas ao vivo do Flatkey. A página inicial do Continue atualmente informa que o Continue foi adquirido pelo Cursor, então verifique a extensão, a CLI e o caminho de suporte desejados do Continue antes de tomar uma nova decisão de implantação para toda a equipe.

Resposta rápida: configuração do provedor compatível com OpenAI do Continue.dev

Para uma configuração do provedor compatível com OpenAI do Continue.dev com o Flatkey, configure um modelo no config.yaml do Continue com provider: openai, defina apiBase para a URL base atual do provedor Flatkey, use uma chave de API do Flatkey e defina model para o alias exato do modelo no Flatkey. Em seguida, teste a mesma URL base e o mesmo alias de modelo fora do Continue antes de depender deles em um workspace de código.

Campo do Continue	Valor do Flatkey	Verificação de revisão
`provider`	`openai`	A documentação do provedor OpenAI do Continue mostra esse provedor para endpoints compatíveis com OpenAI quando `apiBase` é substituído.
`apiBase`	A URL base atual do Flatkey do seu console ou da documentação, como `https://console.flatkey.ai/v1` quando verificada para sua conta	Use apenas a URL base. Não cole o endpoint completo `/chat/completions` em `apiBase`.
`apiKey`	Uma chave do Flatkey pertencente ao usuário, equipe ou ambiente corretos	Use um fluxo de segredo ou variável de ambiente compatível com sua versão do Continue. Não faça commit de uma chave em texto literal.
`model`	O alias exato do modelo Flatkey habilitado para a chave	Não use um nome de família do fornecedor, a menos que o Flatkey exponha esse alias exato.
`roles` e `capabilities`	Atribua apenas as funções que o modelo deve atender e adicione `tool_use` somente após confirmar o suporte a ferramentas/funções	A documentação de capacidades do Continue relaciona `tool_use` a ferramentas e funções, o que é importante para fluxos de trabalho de Agente.

A sequência segura é: copiar a URL base atual do Flatkey, selecionar um alias de modelo visível na conta, testar o endpoint compatível com OpenAI, adicionar o modelo ao Continue, executar um prompt de baixo risco e verificar o uso no Flatkey. O restante deste guia do provedor compatível com OpenAI do Continue.dev transforma isso em um runbook repetível.

O que a documentação atual do Continue confirma

O Continue agora documenta a configuração por meio de config.yaml. O guia de configuração informa que a configuração local fica em ~/.continue/config.yaml no macOS/Linux e %USERPROFILE%\.continue\config.yaml no Windows. Ele também diz que o Continue recarrega a configuração quando o arquivo é salvo, o que torna fácil testar e reverter uma pequena alteração de provedor.

A página do provedor OpenAI mostra o padrão que importa para o Flatkey: uma entrada de modelo pode usar provider: openai, um nome de modelo compatível com OpenAI, uma substituição de apiBase e uma chave de API. Isso faz do caminho do provedor compatível com OpenAI do Continue.dev uma tarefa de configuração de URL base e alias de modelo, e não uma tarefa de implementação de provedor personalizado.

A referência do config.yaml adiciona os detalhes operacionais. Os modelos do Continue podem especificar funções como chat, edit e autocomplete. O Continue também pode substituir capacidades do modelo, incluindo tool_use e image_input, quando a autodetecção não é suficiente. Use esses campos deliberadamente. Um modelo que é adequado para autocomplete pode ser a escolha errada para uso de ferramentas no estilo agente.

Mais um detalhe de endpoint importa: a documentação do provedor OpenAI do Continue descreve controles de endpoint, incluindo comportamento legado de completions e a desativação da Responses API quando um caminho de modelo precisa de /chat/completions. A página pública de preços do Flatkey verificada para este artigo lista famílias de endpoint incluindo /v1/chat/completions e /v1/responses, mas o alias de modelo escolhido e as permissões da conta ainda precisam ser verificados.

Valores do Flatkey a confirmar antes de editar o Continue

A página inicial da Flatkey verificada em 29 de junho de 2026 tem o título One API gateway for production AI teams e descreve acesso unificado a modelos, roteamento, faturamento, análises de uso e controles operacionais. O exemplo de código público atualmente usa https://console.flatkey.ai/v1/chat/completions, então a URL base correspondente para uma configuração do Continue seria https://console.flatkey.ai/v1 quando esse for o valor confirmado pela sua conta.

A página de preços da Flatkey verificada no mesmo dia diz que o site atualmente tem 635 modelos habilitados em 23 provedores. Ela também lista famílias de endpoints para chat completions, responses, messages, images e video. Esses são fatos do catálogo e das rotas públicas, não uma promessa de que toda chave pode chamar todo modelo. Antes de salvar uma rota de provedor compatível com OpenAI do Continue.dev, confirme se o alias do modelo está visível para a chave da Flatkey que o Continue usará.

Se a sua equipe tiver documentação antiga da Flatkey, scripts ou posts de blog que mencionem uma URL base diferente, não os copie às cegas. Trate o Flatkey Console ou a documentação atual da conta como a fonte da verdade e, então, execute o pré-teste abaixo a partir da mesma máquina onde o Continue será executado.

Passo a passo: configure o Continue com a Flatkey

Confirme a interface do Continue. Decida se você está configurando a extensão da IDE, a CLI ou uma configuração local existente. Como a página inicial do Continue agora diz que ele foi adquirido pela Cursor, verifique o suporte e o caminho de instalação antes de um novo rollout.
Abra o config.yaml ativo. Use o seletor de configuração e o ícone de engrenagem do Continue, ou abra ~/.continue/config.yaml no macOS/Linux ou %USERPROFILE%\.continue\config.yaml no Windows.
Registre a entrada de modelo anterior. Salve o provedor antigo, o modelo, as funções e as flags de endpoint para que o rollback seja uma operação de copiar e colar.
Copie a URL base da Flatkey. Use a URL base do provedor, como https://console.flatkey.ai/v1 quando ela estiver verificada para a sua conta. Não inclua /chat/completions em apiBase.
Escolha um alias de modelo por função. Comece com um modelo de chat/edição e adicione autocomplete apenas se você tiver um modelo ajustado para essa função.
Armazene a chave da Flatkey com segurança. Use o padrão de segredo, variável de ambiente ou credencial local compatível com a sua versão do Continue. Não faça commit de uma chave bruta em uma configuração compartilhada.
Adicione a entrada do modelo. Use provider: openai, o apiBase da Flatkey, o alias do modelo da Flatkey e funções restritas.
Execute o pré-teste curl. Teste a mesma URL base, chave e modelo antes de julgar o Continue em si.
Execute um prompt seguro do Continue. Use uma branch descartável ou uma tarefa não destrutiva e, depois, verifique o uso da Flatkey quanto a timestamp, modelo, tokens e custo.
Documente a propriedade. Registre quem é o responsável pela chave, quem pode rotacioná-la, qual alias de modelo foi aprovado e quando revisitar a rota.

Modelo de config.yaml para a Flatkey

Este é um modelo, não um encaixe universal imediato. Substitua os placeholders pelos valores verificados na sua conta da Flatkey e na sua versão atual do 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

Se a rota do modelo selecionado tiver problemas com /responses, a documentação do provedor OpenAI do Continue descreve uma opção useResponsesApi: false. Use isso apenas depois de ter evidências de que o modelo, a família de endpoint ou a rota da conta precisa de /chat/completions para a tarefa.

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

Valide a rota fora do Continue

Um pequeno teste curl separa problemas de roteamento da Flatkey de problemas de configuração do Continue. Use a mesma URL base, chave e alias de modelo que você planeja colocar em config.yaml.

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
  }'

Para uma rota de provedor compatível com OpenAI do Continue.dev no estilo agent, adicione um segundo pré-teste com um schema de ferramenta se a função Continue selecionada precisar de uso de ferramentas. Uma resposta simples de chat prova o transporte, mas não prova o comportamento de função/ferramenta.

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": "Chame route_check com status ok e sem texto adicional."
      }
    ],
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "route_check",
          "description": "Retorne o status da rota.",
          "parameters": {
            "type": "object",
            "properties": {
              "status": { "type": "string" }
            },
            "required": ["status"]
          }
        }
      }
    ],
    "tool_choice": {
      "type": "function",
      "function": { "name": "route_check" }
    },
    "max_tokens": 64
  }'

Uma resposta saudável de uso de ferramentas deve incluir uma estrutura tool_calls no estilo da OpenAI. Se esta solicitação falhar, corrija a chave do Flatkey, a URL base, o alias do modelo, a família do endpoint ou a capacidade do modelo antes de alterar o Continue novamente.

Checklist de capacidade, função e endpoint

Decisão	O que verificar	Por que isso importa
Modelo de chat/edição	O alias do modelo consegue responder a perguntas de código por meio do endpoint Flatkey selecionado.	Esta é a prova mínima para funções de chat e edição voltadas ao desenvolvedor.
Uso de ferramentas	O modelo retorna chamadas de ferramenta no estilo da OpenAI em uma verificação prévia com curl.	A documentação de capacidade do modelo do Continue relaciona `tool_use` a tools e functions.
Autocomplete	Função separada, prompts mais curtos, latência aceitável a partir da máquina do desenvolvedor.	Autocomplete tem expectativas de UX diferentes das do chat.
API de Responses	A rota do modelo selecionado oferece suporte ao endpoint que o Continue está chamando.	Algumas combinações de modelo e gateway exigem `useResponsesApi: false`.
Revisão de uso	O Flatkey mostra a solicitação sob a chave esperada, timestamp, modelo e custo.	Finanças e responsáveis pela plataforma precisam de um único lugar para conciliar o uso.

Modos de falha para depurar primeiro

A maioria das falhas do provedor compatível com OpenAI do Continue.dev vem de um pequeno conjunto de incompatibilidades. Verifique estas antes de presumir que o Continue ou o Flatkey está fora do ar.

Sintoma	Causa provável	Correção
A configuração não carrega	Arquivo errado, erro de indentação YAML ou uma configuração desatualizada selecionada no IDE.	Abra a configuração pelo seletor do Continue, valide o YAML, salve e aguarde o recarregamento.
Chave de API inválida	A chave foi copiada incorretamente, rotacionada, limitada a outro ambiente ou pertence a um provedor upstream.	Gere ou selecione a chave correta do Flatkey e teste novamente com curl antes de atualizar o Continue.
Erro de conexão	`apiBase` inclui o caminho completo do endpoint, usa uma URL base antiga ou a máquina não consegue alcançar a rota.	Use apenas a URL base atual do provedor e teste a partir da mesma máquina.
Modelo não encontrado	O valor de `model` do Continue não corresponde a um alias do Flatkey habilitado para a chave.	Copie o alias exato do modelo a partir do preço do Flatkey, do catálogo ou da lista de modelos visível na conta.
Falha em Tools ou no modo Agent	O modelo selecionado não consegue produzir o comportamento de ferramenta/função esperado pela função.	Use um modelo compatível com ferramentas e refaça a verificação prévia da chamada de ferramenta antes de definir `tool_use`.
Erros específicos do endpoint	O Continue está chamando `/responses` enquanto a rota selecionada deveria usar chat completions, ou o inverso.	Verifique o suporte ao endpoint do Flatkey e use as flags de endpoint do Continue apenas quando necessário.
Não é possível conciliar o uso	A equipe não registrou o responsável pela chave, alias do modelo, desenvolvedor, ambiente ou timestamp.	Adicione uma linha ao runbook antes de expandir a configuração para mais desenvolvedores.

Runbook de produção para Continue mais Flatkey

Antes que mais desenvolvedores usem a rota do provedor compatível com OpenAI do Continue.dev, registre os fatos operacionais que tornam possível o suporte e a revisão de custos.

Campo do runbook	Registre isto
Responsável	Equipe, grupo de desenvolvedores e pessoa que pode rotacionar a chave do Flatkey.
Superfície do Continue	Extensão do IDE ou CLI, versão se disponível e localização da configuração.
URL base do Flatkey	URL base atual aprovada pela conta e data da verificação.
Aliases de modelo	Um alias por função: chat/edição, apply, autocomplete ou caminho do agente com uso de ferramentas.
Política de endpoint	Se a rota deve usar responses, chat completions ou um fallback documentado.
Revisão de custos	Onde o uso, a contagem de tokens, o status da solicitação e o custo serão revisados no Flatkey.
Rollback	Entrada anterior do provedor, alias antigo do modelo e aprovação do responsável para reverter.

Onde isso se encaixa em um cluster de ferramentas do Flatkey

Se a sua equipe já roteia outras ferramentas pela Flatkey, mantenha o mesmo padrão operacional para o Continue. O guia de configuração da API do Cherry Studio é útil para verificações simples de URL base em clientes desktop. O guia CC Switch Claude Code Flatkey é útil para a disciplina de roteamento de ferramentas de desenvolvimento. O playbook mais amplo de migração para API compatível com OpenAI é o lugar para padronizar mudanças de URL base, verificação de alias de modelo e rollback.

O valor de um roteador unificado não é apenas a redução de chaves de provedores. É a capacidade de ver qual ferramenta, modelo, proprietário da chave e fluxo de trabalho criaram o uso. Por isso, uma migração do Continue.dev OpenAI compatible provider deve terminar com uma verificação de uso da Flatkey, e não apenas com um prompt funcionando.

Perguntas frequentes

O Continue ainda oferece suporte a roteamento compatível com OpenAI?

A documentação atual do provedor OpenAI do Continue mostra um padrão de configuração compatível com OpenAI usando provider: openai, model, apiBase e apiKey. A página inicial também diz que o Continue foi adquirido pelo Cursor, então verifique sua extensão, CLI e caminho de suporte exatos antes de uma nova implantação.

Qual URL base da Flatkey devo usar?

Use a URL base atual do provedor da sua conta Flatkey. A página inicial pública verificada para este artigo mostrou https://console.flatkey.ai/v1/chat/completions, que corresponde a https://console.flatkey.ai/v1 como URL base. A documentação ou o console da sua conta têm precedência se forem diferentes.

Um único modelo deve atender a todas as funções do Continue?

Não automaticamente. Chat, edição, aplicação, autocompletar e uso de ferramentas no estilo agente podem ter necessidades diferentes de latência, contexto e capacidade. Comece com a atribuição mais restrita de função e adicione mais funções após os testes.

Preciso de `tool_use`?

Somente quando a função precisar de comportamento de ferramenta/função e o modelo selecionado realmente puder retornar chamadas de ferramenta no estilo OpenAI. O Continue pode detectar automaticamente muitos recursos, mas a documentação permite substituições para implantações personalizadas ou casos em que a detecção automática não está funcionando.

Como devo lidar com a chave de API?

Mantenha a chave da Flatkey fora de arquivos do repositório, capturas de tela e comentários compartilhados de issues. Use o padrão local de segredo ou variável de ambiente compatível com a sua versão do Continue e, em seguida, registre quem é o responsável pela chave e quem pode rotacioná-la.

Lista de verificação final

Superfície atual do Continue verificada após o aviso de aquisição pelo Cursor.
config.yaml ativo localizado e copiado como backup.
URL base da Flatkey copiada da fonte atual da conta.
Alias de modelo confirmado para a chave da Flatkey.
Comportamento do endpoint de chat completions ou responses testado.
Pré-verificação de uso de ferramentas executada quando a função precisar de ferramentas.
Uso revisado na Flatkey após o primeiro prompt seguro do Continue.
Responsável pelo rollback e configuração anterior registrados.

Quando essas verificações estiverem concluídas, o caminho do Continue.dev OpenAI compatible provider se torna uma integração gerenciável com a Flatkey, em vez de apenas mais uma credencial de desenvolvedor não gerenciada. Se você estiver padronizando mais ferramentas, compare aliases de modelo e política de uso em preços da Flatkey e, em seguida, obtenha uma chave para o espaço de trabalho que será responsável pela primeira implantação.