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

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 a CLI do Claude Code no terminal integrado. Uma instalação separada só é necessária para usar a CLI fora do pacote da extensão.

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. Na data da verificação, a documentação oficial exigia VS Code 1.98.0 ou superior.

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

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:

https://www.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. Editar ~/.claude/settings.json

Em macOS e Linux, o arquivo fica em ~/.claude/settings.json; no Windows, em %USERPROFILE%\.claude\settings.json. Adicione env:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.bettertoken.ai",
    "ANTHROPIC_AUTH_TOKEN": "your_api_key_here"
  }
}

Troque your_api_key_here pela chave do passo 1. Se o arquivo já tiver campos, adicione apenas "env"; CLI e extensão leem o mesmo arquivo.

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 env.

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 na paleta. Verifique em Help → About que VS Code é 1.98.0 ou posterior.

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. Nesse caso, confirme VS Code 1.98.0+ em Help → About, execute Developer: Reload Window e desative temporariamente Cline, Continue ou GitHub Copilot, que podem conflitar com ícones. ✱ 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 caminho e JSON de settings.json: uma vírgula extra ou chave sem fechar impede env. Recarregue a janela, confira Base URL e chave antigas no shell ou nas configurações e use os nomes da documentação BetterToken atual.

Erro 401 ou ausência de resposta

1. Base URL: https://www.bettertoken.ai, sem /v1; o sufixo pode causar 404.
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