Configurar uma chave API personalizada no Cline

Cline é o cliente de codificação. O provedor API fornece o modelo, autentica a solicitação e cobra os tokens. Uma chave API personalizada conecta essas duas camadas; não torna o uso do modelo gratuito e não ignora as regras de acesso do provedor.

A configuração compatível com OpenAI oficial do Cline expõe os campos necessários para esta conexão: Provedor API, Base URL, Chave API e Model ID. Com OmniaKey, uma chave pode alcançar Claude, GPT, Gemini, DeepSeek e outros modelos suportados por meio dessa interface.

Configurações de chave personalizadas Cline API

Abra Cline no VS Code, selecione o ícone de configurações e digite:

O sufixo /v1 faz parte do Base URL compatível com OpenAI. Não use a origem simples aqui e não anexe /chat/completions; Cline cria o caminho da solicitação.

Configure Cline passo a passo

1. Crie uma chave API separada

Faça login em OmniaKey, financie o saldo pré-pago e crie uma chave API. Uma chave separada para Cline torna os limites, a rotação e a revisão de uso mais fáceis do que compartilhar uma credencial em cada ferramenta.

Nunca coloque a chave literal no código-fonte, em um arquivo de repositório, em um problema ou em uma captura de tela. Cole-o apenas no campo Chave API de Cline.

2. Selecione OpenAI compatível

Abra as configurações de Cline e escolha OpenAI Compatible em Provedor API. Não escolha o provedor OpenAI oficial quando a chave pertencer a outro provedor: a escolha do provedor determina quais campos de configuração e endpoint Cline usa.

3. Digite Base URL

Use exatamente:

https://api.omniakey.com/v1

Valores incorretos comuns: https://api.omniakey.com, um /v1/v1 duplicado ou o caminho completo /v1/chat/completions.

4. Insira um Model ID exato

Comece com um modelo atualmente listado no catálogo de modelos OmniaKey:

Esses exemplos não são apelidos. Os sufixos de maiúsculas e minúsculas, pontuação e versão são importantes. Copie o ID em vez de digitá-lo novamente da memória.

5. Verifique antes de atribuir uma tarefa real

Use o controle Verify de Cline se ele for mostrado para o provedor selecionado. Em seguida, execute uma tarefa restrita e reversível:

Read package.json and name the package manager. Do not edit files.

Uma verificação útil estabelece quatro coisas:

1. Cline aceitou as configurações personalizadas do provedor.
2. O provedor aceitou a chave API.
3. O modelo exato existe para essa chave.
4. Uma resposta simples do modelo retorna sem edição ou loop de ferramentas.

Só então passe para uma tarefa de alteração de repositório. A visão geral da configuração do agente de codificação abrange o fluxo de trabalho mais amplo.

Como funciona o faturamento Cline BYOK

BYOK significa trazer sua própria chave. Cline envia solicitações usando as configurações do provedor que você forneceu, e o provedor cobra o uso do modelo de acordo com essa conta. Cline não está transformando um API pago em uso gratuito.

Revise a entrada real, a entrada em cache e os tokens de saída em vez de estimar a partir da resposta visível. O trabalho do agente inclui contexto de repositório, chamadas de ferramentas, novas tentativas e raciocínio intermediário. O guia de faturamento transparente explica por que o custo da tarefa concluída é mais útil do que uma taxa de token principal.

Se a escolha do modelo ainda estiver aberta, compare as famílias no guia do modelo do agente de codificação antes de otimizar a configuração do Cline.

Solucionar problemas de uma chave Cline API que não está funcionando

Chave API ou HTTP 401 inválida

Um 401 significa que o endpoint não aceitou a credencial fornecida com a solicitação.

Verifique isso:

• a chave veio do mesmo fornecedor do Base URL;
• nenhum espaço inicial ou final foi colado;
• a chave está ativa e não foi girada ou excluída;
• a conta possui saldo utilizável;
• Cline ainda está definido como OpenAI Compatible.

A criação de um novo ID de modelo não repara uma falha de autenticação.

Modelo não encontrado ou HTTP 404

Um 404 pode significar que Base URL está errado ou que Model ID está indisponível. Primeiro confirme se Base URL termina uma vez em /v1. Em seguida, copie o ID exato do modelo do catálogo.

Se o endpoint funcionar com um modelo listado, mas não com outro, a conexão será válida e o problema restante será a disponibilidade ou a nomenclatura do modelo.

Erro de conexão

Confirme se https://api.omniakey.com/v1 pode ser acessado na mesma máquina que executa Cline. Regras de VPN, proxy, DNS, inspeção TLS e firewall podem afetar o IDE mesmo quando uma página do navegador é carregada em outro lugar.

Não desative a verificação TLS para ocultar um erro de certificado. Em vez disso, corrija a configuração de rede ou de confiança.

O modelo responde, mas as ferramentas falham

Uma resposta de texto bem-sucedida prova apenas a geração básica. Cline também depende de chamadas de ferramentas estruturadas para leitura, edição e execução de comandos. Teste uma tarefa de repositório somente leitura antes de uma grande alteração autônoma.

Se um modelo produzir repetidamente chamadas de ferramenta malformadas, compare um modelo documentado para o trabalho do agente, em vez de aumentar cegamente os limites de produção.

Os custos são maiores do que o esperado

O contexto longo do repositório pode dominar o projeto mesmo quando a resposta final é curta. Comece com uma tarefa restrita, mantenha as pastas não relacionadas fora do contexto e compare o custo por alteração aceita.

Use teclas ou maiúsculas separadas para experimentos. Um limite limita a exposição financeira; não reduz os tokens que uma tarefa ineficiente consome.

Lista de verificação de segurança

• Use uma chave Cline dedicada em vez de uma credencial compartilhada com serviços de produção.
• Defina um limite apropriado para o projeto e o tamanho da tarefa.
• Gire uma chave que apareceu em um repositório, gravação de terminal, captura de tela ou problema.
• Revise as permissões da ferramenta antes de permitir comandos shell ou edições de arquivos.
• Inicie repositórios novos ou não confiáveis com tarefas somente leitura.
• Verifique o log de uso do provedor após a primeira sessão bem-sucedida.

A chave API controla o acesso ao modelo. As permissões de arquivo e comando de Cline controlam o que o agente pode fazer localmente. Trate-os como limites de segurança separados.

Perguntas frequentes

Posso usar minha própria chave API com Cline?

Sim. Selecione OpenAI Compatible e insira o Base URL do provedor, a chave API e o Model ID exato. O provedor deve expor um API compatível com a interface que Cline espera.

Uma chave API personalizada Cline é gratuita?

Não. BYOK altera quem autentica e cobra a solicitação do modelo. O provedor ainda pode cobrar por tokens de entrada, entrada em cache e saída.

Qual Base URL Cline deve usar para OmniaKey?

Utilize https://api.omniakey.com/v1. Não adicione /chat/completions e não duplique /v1.

Qual modelo devo usar no Cline?

Comece com um modelo atual do catálogo que se adapte à tarefa. gpt-5.6-terra é um ponto de partida equilibrado; use modelos mais fortes ou mais baratos somente depois de comparar os resultados das tarefas aceitas.

Por que Cline diz Modelo não encontrado?

Verifique o Model ID e Base URL exatos. Uma chave API válida ainda pode não ter acesso a um modelo específico, e uma 404 também pode vir de um URL malformado.

Cline armazena minha chave no repositório?

As credenciais do provedor pertencem às configurações do Cline, não aos arquivos do projeto. Independentemente da implementação de armazenamento do cliente, não copie a chave na origem, nos prompts, nas capturas de tela ou nos relatórios de problemas.

Fontes verificadas

• Cline: OpenAI Provedor compatível
• Cline: Autorização e BYOK
• Referência de configuração OmniaKey Cline
• Catálogo de modelos OmniaKey