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
{
"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):
{
"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.
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