OneProvider

VS Code

Use a extensão Claude Code para VS Code com a OneProvider: adicione o endpoint e a chave ao settings.json, reinicie, pule o pedido de login e teste.

A extensão Claude Code do VS Code lê as variáveis de ambiente de um settings.json na sua pasta pessoal. Coloque o endpoint e a chave da OneProvider e reinicie.

Todos os modelos, recursos e preços Índice da documentação para agentes de IA: https://oneprovider.dev/docs/llms.txt Sistema operacional Antes de começar: uma chave do seu painel Abra o seu painel: o bot do Telegram @oneprovider_robot (Painel) ou app.oneprovider.dev . Toque em “Emitir chave”, dê um nome a ela (por exemplo, este cliente) e um limite de gastos, e copie a chave. É no mesmo lugar que você recarrega o saldo. Mais sobre o painel e as chaves .

Instalação

Procure por “Claude Code” no VS Code Marketplace (publicador anthropic.claude-code) e instale. A extensão já traz o próprio runtime — não precisa instalar uma CLI separada para usar no editor.

Configuração

Crie um settings.json no caminho do seu sistema operacional, abaixo. A extensão lê este arquivo ao iniciar e usa o bloco env em todas as requisições enviadas.

Caminho: ~/.claude/settings.json

json
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.oneprovider.dev",
"ANTHROPIC_AUTH_TOKEN": "sk-your-key-here",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
"CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
}
}

Crie o arquivo se ele não existir e reinicie o VS Code por completo para carregar o novo bloco env.

Se a extensão pedir login

A extensão confere as credenciais antes de iniciar e pode mostrar uma tela de login se você não tiver uma conta Claude. A solução confiável é definir o endereço e a chave nas configurações de usuário do próprio VS Code: abra a Command Palette (Paleta de Comandos, ⌘⇧P / Ctrl+Shift+P ) → Preferences: Open User Settings (JSON) e adicione (igual no macOS, no Linux e no Windows):

json
{
"claudeCode.disableLoginPrompt": true,
"claudeCode.environmentVariables": [
{ "name": "ANTHROPIC_BASE_URL", "value": "https://api.oneprovider.dev" },
{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-your-key-here" }
]
}

Reinicie o VS Code. Uma chave da OneProvider funciona tanto como ANTHROPIC_AUTH_TOKEN (Bearer) quanto como ANTHROPIC_API_KEY.

Verificação

Abra o painel do Claude Code ( ⌘⇧P / Ctrl+Shift+P → Claude Code: Focus), digite ping e envie. Uma resposta em poucos segundos confirma que a troca de endpoint está ativa.

CLI e extensão A CLI do Claude Code e esta extensão usam o mesmo arquivo de configurações — configure uma e as duas passam a usar.

Qual modelo escolher

A extensão roda o mesmo motor do Claude Code, então escolha os modelos do mesmo jeito. Mantenha claude-sonnet-5-5 como padrão para as edições do dia a dia, troque para claude-opus-5-5 em refatorações grandes e use claude-haiku-5-5 para perguntas rápidas e baratas. Mude o modelo com /model no painel. Os IDs e os valores estão na página de modelos e na página de preços ; um limite de gastos na chave deixa a conta previsível.

Erros comuns e soluções

A extensão mostra uma tela de login

A extensão confere as credenciais antes de iniciar. Adicione claudeCode.disableLoginPrompt e o bloco claudeCode.environmentVariables da seção acima às configurações de usuário (JSON) do VS Code e reinicie o VS Code por completo.

401 Invalid API key

O valor tem uma aspa ou um espaço sobrando, ou um ANTHROPIC_AUTH_TOKEN de outro serviço está sobrescrevendo a sua chave. Defina a chave inteira da OneProvider, sem aspas, em um só lugar.

404 ou endpoint errado

A base URL é https://api.oneprovider.dev, sem /v1. A extensão acrescenta o caminho sozinha.

Nada mudou depois de editar as configurações

Feche o VS Code por completo (não só recarregue a janela) para carregar o novo bloco env. Em uma janela Remote-SSH, WSL ou dev container, a extensão normalmente lê as configurações do lado remoto, então coloque-as lá.

O streaming é cortado

Desative VPN ou proxies VLESS na máquina que roda a extensão: eles seguram o SSE em buffer e quebram o HTTP/2.

Colei o bloco no settings.json e nada mudou

São dois arquivos diferentes. O bloco env vai em ~/.claude/settings.json; as configurações de usuário do próprio VS Code (JSON) aceitam só as chaves claudeCode.disableLoginPrompt e claudeCode.environmentVariables da seção acima. Confira se ~/.claude/settings.json não tem vírgula depois do último item e feche o VS Code por completo.

Perguntas frequentes

Preciso da CLI do Claude Code também?

Não. A extensão já traz o próprio runtime. Se você também usa a CLI, as duas leem o mesmo ~/.claude/settings.json, veja o Claude Code .

Preciso de uma assinatura do Claude?

Não, a chave da OneProvider basta.

Que formato de chave ela aceita?

A chave sk-… pura, como ANTHROPIC_AUTH_TOKEN (Bearer) ou ANTHROPIC_API_KEY.

Onde vejo o custo?

Na página Consumo do Dashboard da chave. Defina um limite de gastos ao emitir a chave.

Posso usar na extensão um id de GPT ou outro do catálogo?

Sim, um id de texto do catálogo : o nosso endpoint da Anthropic também responde a eles. Coloque "model": "gpt-6.1-terra" em ~/.claude/settings.json; a chamada de ferramentas depende do modelo.

Posso usar o GitHub Copilot Chat ou o Continue no lugar?

Sim, os dois aceitam um endpoint no estilo OpenAI. Copilot Chat: paleta de comandos → Chat: Manage Language Models → Add Models → Custom Endpoint e, em chatLanguageModels.json, defina "apiType": "chat-completions", id gpt-6.1-terra, url https://api.oneprovider.dev/v1/chat/completions e "toolCalling": true (modelo sem chamada de ferramentas fica oculto), além de maxInputTokens e maxOutputTokens da linha do catálogo. Nas sessões do harness do Copilot, ligue também chat.agentHost.byokModels.enabled. Cobre chat e agente, não as sugestões em linha. Continue: adicione ao config.yaml um modelo com provider: openai, apiBase: https://api.oneprovider.dev/v1, a sua chave e o id do modelo.

Respostas rápidas

Qual base URL devo usar?

O Claude Code e os SDKs da Anthropic usam https://api.oneprovider.dev. Os SDKs da OpenAI e os clientes compatíveis com a OpenAI usam https://api.oneprovider.dev/v1. Uma única chave funciona nos dois; a lista de modelos está na página de modelos e os preços, na página de preços .

Como me autentico?

Envie a chave sk-… pura em x-api-key ou em Authorization: Bearer: um dos dois, nunca ambos. Guarde a chave em uma variável de ambiente, não em um arquivo que vai para o commit. Mais sobre autenticação .

Onde consigo uma chave?

Abra o seu painel no bot do Telegram @oneprovider_robot ou em app.oneprovider.dev, recarregue o saldo e toque em “Emitir chave”. Cada chave pode ter o seu próprio limite de gastos. Painel e chaves de API .

O que significam 401, 404 e 429?

401: a chave está ausente, foi digitada errado ou enviada no cabeçalho errado; cole a chave inteira, sem aspas nem espaços. 404: em geral, uma base URL errada, por exemplo um /v1 ausente ou duplicado. 429 com “Insufficient balance”: o saldo do painel ou o limite de gastos da chave acabou, então recarregue em vez de tentar de novo; qualquer outro 429 é um limite de requisições, então aguarde o tempo de Retry-After. Detalhes: códigos de erro e solução de problemas .

Por que os streams são cortados ou reiniciados?

VPNs e proxies VLESS costumam armazenar SSE em buffer ou quebrar a negociação do HTTP/2. A OneProvider não tem restrições regionais e não armazena streams em buffer; desative o proxy e tente de novo.

Onde pergunto se isso não bastar?

Escreva para @Oneproviderhelpbot no Telegram ou abra “Suporte” no painel web, informando o código de status HTTP e a mensagem de erro exata. Como funciona o suporte .

Última atualização: 2026-11-17 Encontrou um erro? @Oneproviderhelpbot