Claude Code no VS Code: conectar e verificar a integração

Quer configurar o Claude Code no VS Code com sua própria chave de API? Com o BetterToken, usuários na Rússia não precisam de VPN permanente nem cartão estrangeiro para acessar o endpoint BetterToken. Copie os campos atuais de Base URL e chave para as configurações de usuário do VS Code; a extensão enviará as solicitações ao endpoint escolhido.

As três camadas da integração

O aviso de que Claude Code “não responde” pode vir de três camadas independentes.

CLI. A extensão oficial inclui uma cópia privada da CLI para o painel de chat, mas não adiciona claude ao PATH. Para executá-lo no terminal integrado, instale a CLI independente seguindo o guia atual da Anthropic.

Extensão do VS Code. A extensão oficial da Anthropic oferece chat, diffs lado a lado, menções @ de arquivos e histórico de sessões. O guia atual da Anthropic exige o VS Code 1.94.0 ou posterior.

Endpoint de API. Claude Code usa a API Anthropic por padrão. Para BetterToken, defina ANTHROPIC_BASE_URL e ANTHROPIC_AUTH_TOKEN; a extensão os repassa automaticamente ao Claude Code.

Um registro bem-sucedido no Dashboard confirma que BetterToken aceitou a solicitação. O contexto do arquivo e o diff validam separadamente a integração com a IDE.

---

Use sua própria conta BetterToken, crie uma chave de API no painel e obtenha a Base URL na documentação.

Crie sua chave de API e configure o Claude Code pela documentação BetterToken: docs.bettertoken.ai/ai-tools/claude-code

Criar a chave de API e conectar o endpoint

Quer testar o Claude Code com sua própria chave de API? Criar uma conta BetterToken

Passo 1. Criar conta e chave

Abra bettertoken.ai, registre-se, acesse o gerenciamento de chaves e crie uma nova chave de API. Copie-a para a próxima etapa.

Passo 2. Usar a Base URL

Para Claude Code, use esta Base URL compatível com Anthropic:

No Windows, o arquivo do CLI fica em %USERPROFILE%\.claude\settings.json.

https://bettertoken.ai

Não acrescente /v1: Claude Code adiciona a rota do método. O endereço com /v1 é destinado a ferramentas compatíveis com OpenAI, como Codex CLI.

Passo 3. Definir as variáveis da extensão

Abra o settings.json de usuário do VS Code e adicione um array separado claudeCode.environmentVariables:

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://bettertoken.ai" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "your_api_key_here" },
    { "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "value": "1" },
    { "name": "API_TIMEOUT_MS", "value": "3000000" }
  ]
}

Troque your_api_key_here pela chave do passo 1, preserve os demais campos e execute Developer: Reload Window. Para usar claude no terminal integrado, instale primeiro a CLI independente; no macOS, Linux e WSL, o comando atual é curl -fsSL https://claude.ai/install.sh | bash. Consulte Windows e alternativas no guia oficial. A CLI é configurada separadamente em ~/.claude/settings.json, conforme o guia BetterToken.

Passo 4. Desativar a tela de login

Em configurações do VS Code (Cmd+, no Mac ou Ctrl+, no Windows/Linux), abra Extensions → Claude Code e ative Disable Login Prompt. Isso oculta o login Anthropic para um provedor externo, mas não substitui claudeCode.environmentVariables.

Iniciar Claude Code no VS Code

Passo 5. Instalar a extensão

Use Cmd+Shift+X no Mac ou Ctrl+Shift+X no Windows/Linux, procure “Claude Code” da Anthropic e clique em Install. Se o ícone não aparecer, execute Developer: Reload Window. Atualize o VS Code e confira o requisito atual no Marketplace.

Passo 6. Abrir o painel

Abra um arquivo. O ícone Spark (✱) aparece na Editor Toolbar somente com arquivo aberto. Há também Activity Bar, Command Palette (Cmd+Shift+P / Ctrl+Shift+P) → “Claude Code: Open in New Tab”, e Status Bar → ✱ Claude Code, que funciona sem arquivo aberto.

Passo 7. Confirmar o contexto

Selecione linhas de código; Claude Code mostra a contagem abaixo da entrada. Option+K no Mac ou Alt+K no Windows/Linux insere uma referência como @file.ts#5-10.

Verificar contexto, diff e Dashboard

Passo 8. Enviar um teste de baixo risco

Em um script ou configuração pequeno, peça uma alteração simples e reversível:

Adicione antes da primeira função um comentário de uma linha explicando brevemente o que ela faz.

Ou:

Renomeie a variável `tmp` para `result` neste arquivo.

Passo 9. Revisar o diff

A extensão mostra a comparação antes/depois e solicita permissão. Revise-a e escolha Accept ou Reject. Um diff significativo confirma a resposta do modelo e a associação ao arquivo atual; a rota BetterToken é conferida no Dashboard.

Passo 10. Conferir a solicitação no Dashboard

Abra bettertoken.ai, vá a Dashboard ou ao histórico e localize o registro do horário do teste. Compare modelo, status, tokens de entrada, saída e cache, além da cobrança. Diff correto e registro bem-sucedido no mesmo horário confirmam contexto, processamento pelo BetterToken e retorno à IDE.

Sem resultado: nenhuma resposta e nenhum registro exigem checar extensão, env, Base URL e rede; um erro no Dashboard pede chave, modelo e mensagem; um diff sem registro pede rever endpoint, hora e filtros, pois a rota BetterToken ainda não está confirmada.

Se a integração não for detectada

O ícone Spark não aparece

Ele exige um arquivo aberto na Editor Toolbar. Atualize o VS Code, confira o requisito atual no Marketplace, execute Developer: Reload Window e, se necessário, desative temporariamente Cline, Continue ou GitHub Copilot. ✱ Claude Code na Status Bar funciona sem arquivo aberto.

VS Code não herda variáveis do terminal

Se ANTHROPIC_BASE_URL está no shell, mas há pedido de login, VS Code iniciado pelo Spotlight ou menu de apps não herdou o ambiente. Inicie pelo terminal:

code .

Ou duplique as variáveis em Extensions → Claude Code → environmentVariables.

Login volta a ser solicitado

Confirme Disable Login Prompt. A opção desativa a tela Anthropic; as variáveis de conexão continuam obrigatórias.

A configuração alterada não é lida

Confira o settings.json de usuário do VS Code: uma vírgula extra ou chave sem fechar impede claudeCode.environmentVariables. Recarregue a janela, confira Base URL e chave antigas no shell ou na configuração da CLI e use os nomes da documentação BetterToken atual.

Erro 401 ou ausência de resposta

1. Base URL: https://bettertoken.ai, sem /v1; com /v1, o Claude Code usa a rota de protocolo errada.
2. Chave de API: sem espaços, quebras de linha ou aspas extras.
3. Conflito: outro ANTHROPIC_AUTH_TOKEN ou ANTHROPIC_BASE_URL pode sobrescrever a configuração. Remova-o ou inicie com code ..

Sem registro no Dashboard, verifique envio, endpoint e rede; um 401 aponta para a chave ou o formato.

---

Documentação completa do Claude Code para BetterToken: docs.bettertoken.ai/ai-tools/claude-code