Configuração da Extensão Claude Code no VS Code: Backend, Modelos e Sandbox

O Claude Code chega ao VS Code como um agente de programação completo na barra lateral — não é uma ferramenta de autocompletar, mas um resolvedor de problemas em várias etapas que lê o seu projeto, edita ficheiros e executa comandos. A extensão do VS Code partilha o motor com a CLI, por isso os comandos de barra, o reconhecimento do CLAUDE.md e as chamadas de ferramentas MCP funcionam exatamente como na terminal. O que torna a configuração interessante é a camada de backend: cada chamada de inferência passa por um endpoint que você controla, e encaminhar esse endpoint para a Novita AI abre acesso aos modelos Claude e a um catálogo mais amplo de alternativas open-source de programação — com preços que tornam práticas as tarefas de agente em grande volume.

O Que o Claude Code Faz no VS Code

A extensão Claude Code para o VS Code é um painel lateral, não um motor de autocompletar inline. Abra-o, descreva uma tarefa, e o Claude Code executa trabalho em várias etapas: ler ficheiros, escrever alterações, executar comandos de shell e aguardar a sua aprovação nos diffs antes de os aplicar. Esta distinção é importante porque os programadores costumam procurar por “claude code vs code” esperando uma experiência estilo Copilot — sugestões de uma linha que se completam enquanto escreve. Não é isso. Para autocompletar, existem outras ferramentas. O Claude Code no VS Code serve para tarefas: escrever testes para este módulo, refatorar o handler de autenticação, explicar porque esta query está lenta, criar um pull request com as alterações de hoje.

Capacidades concretas dentro da extensão:

• Edições multi-ficheiro com diffs inline. O Claude Code propõe alterações em vários ficheiros e mostra diffs que pode aceitar ou rejeitar sem sair do editor.
• Comandos de barra. /compact, /clear, /init, /memory e comandos de barra personalizados que você definiu funcionam de forma idêntica à CLI.
• Fixação de contexto. O prefixo # anexa ficheiros, símbolos ou pastas específicos a um pedido. Escrever #src/auth/handler.ts corrige a condição de corrida dá ao Claude Code o contexto certo imediatamente.
• Reconhecimento do CLAUDE.md. Padrões de código do projeto, notas de arquitetura, bibliotecas preferidas — tudo o que estiver em CLAUDE.md é carregado no início da sessão. Você escreve uma vez; o agente respeita em todas as sessões.
• Chamadas de ferramentas MCP. Servidores MCP registados na sua configuração do Claude Code ficam disponíveis dentro do painel da extensão.

O que a extensão não faz: substituir os seus atalhos de teclado existentes, modificar o realce de sintaxe ou adicionar autocompletações por tecla. É uma interface de agente sobreposta ao seu fluxo de trabalho normal no VS Code.

Como Adicionar o Claude Code ao VS Code

Abra o painel de Extensões (Ctrl+Shift+X no Windows/Linux, Cmd+Shift+X no macOS). Pesquise Claude Code e procure o publicador Anthropic. Clique em Instalar.

Se preferir a linha de comandos:

code --install-extension Anthropic.claude-code

Após a instalação, o ícone do Claude aparece na Barra de Atividades do lado esquerdo do VS Code. Clique nele para abrir o painel do agente.

Autenticação no primeiro arranque. A extensão pede para iniciar sessão na primeira abertura. Dois caminhos:

• Conta Anthropic: Fluxo OAuth no navegador — funciona se tiver uma chave de API da Anthropic Console ou uma subscrição Claude ativa.
• Chave de API da Novita AI: Defina ANTHROPIC_BASE_URL e ANTHROPIC_AUTH_TOKEN no ambiente do shell antes de iniciar o VS Code a partir dessa terminal. A extensão lê estas variáveis no arranque e ignora completamente o login da Anthropic. Detalhes na próxima secção.

O VS Code atualiza a extensão automaticamente em segundo plano. Não precisa de acompanhar versões manualmente.

Como Funciona o Backend da API LLM

Compreender a arquitetura de três camadas torna todas as decisões de configuração mais claras:

1. Camada de interface: A extensão do VS Code (ou a CLI, ou a aplicação de desktop — são superfícies intercambiáveis).
2. Camada de lógica do agente: O motor do Claude Code — definições de ferramentas, gestão de sessões, leitura de ficheiros, execução de comandos.
3. Camada de API LLM: O endpoint de inferência que trata de todas as chamadas do modelo de linguagem.

Por padrão, a camada de API LLM aponta para api.anthropic.com. O Claude Code envia pedidos usando o formato da API Messages da Anthropic. O detalhe crítico: ANTHROPIC_BASE_URL redireciona todos esses pedidos para qualquer endpoint compatível com a Anthropic. A Novita AI expõe o mesmo formato da API Messages em https://api.novita.ai/anthropic, por isso a mudança é transparente para a camada de lógica do agente — o Claude Code não sabe nem quer saber se a resposta veio dos servidores da Anthropic ou da Novita.

Mais três variáveis de ambiente completam a configuração:

• ANTHROPIC_AUTH_TOKEN — a sua chave de API para o fornecedor escolhido.
• ANTHROPIC_MODEL — o ID do modelo a usar nas tarefas principais.
• ANTHROPIC_SMALL_FAST_MODEL — o ID do modelo para tarefas rápidas em segundo plano, como sumarização e compressão de contexto.

Defina estas variáveis antes de iniciar o VS Code e a extensão herda-as do ambiente do shell.

Ligar o Claude Code à Novita AI

Passo 1: Obter uma chave de API da Novita AI

Registe-se em novita.ai e navegue até à página Key Management. Gere uma nova chave e copie-a imediatamente — não será mostrada novamente.

Passo 2: Definir as variáveis de ambiente

No macOS ou Linux, exporte as variáveis na terminal antes de iniciar o VS Code:

export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<your-novita-api-key>"
export ANTHROPIC_MODEL="zai-org/glm-4.6"
export ANTHROPIC_SMALL_FAST_MODEL="zai-org/glm-4.6"

No Windows (Command Prompt):

set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=<your-novita-api-key>
set ANTHROPIC_MODEL=zai-org/glm-4.6
set ANTHROPIC_SMALL_FAST_MODEL=zai-org/glm-4.6

Depois, inicie o VS Code a partir dessa mesma sessão de terminal:

code .

Passo 3: Verificar a ligação

Abra o painel do Claude Code e envie uma mensagem de teste curta. Se a extensão devolver uma resposta, o encaminhamento está a funcionar. Passa a ser cobrado através da Novita AI — a sua conta Anthropic não é debitada.

Para tornar a configuração permanente, adicione os exports ao seu perfil de shell (~/.zshrc, ~/.bashrc, ou equivalente) ou use um ficheiro .env ao nível do projeto, gerido por direnv, para alternar modelos por projeto.

Modelos Open-Source Que Igualam o Desempenho de Programação dos Modelos Fechados

Quando passa a encaminhar através da Novita AI, não fica limitado aos modelos Claude. O catálogo LLM da Novita inclui modelos de programação open-source que competem diretamente com as alternativas fechadas nos benchmarks que importam para tarefas de programação agêntica.

O GLM-4.6 da Zhiyu AI é um exemplo prático. Tem uma janela de contexto de 200K tokens e alcança uma taxa de vitória de 48,6% contra o Claude Sonnet 4 em avaliações de programação no mundo real. Para fluxos de trabalho agênticos onde o contexto longo importa (depuração em bases de código grandes, leitura de suites de testes completas), essa janela de contexto é uma vantagem prática, não apenas um número de especificação. O ID do modelo na Novita é zai-org/glm-4.6.

Outros modelos na plataforma Novita que valem a pena avaliar para cargas de trabalho de programação incluem o DeepSeek R1 e o Qwen 3 Coder, ambos com desempenho competitivo demonstrado em benchmarks de geração de código e seguimento de instruções. A mesma variável de ambiente ANTHROPIC_MODEL alterna entre eles — sem reinstalar, sem nova integração.

O argumento de custo para open-source: equipas que executam Claude Code à escala — um grande número de execuções de agente em pipelines de CI, configurações com vários programadores e chaves de API Novita partilhadas, ou sessões agênticas longas que consomem muitos tokens — descobrem que os modelos open-source ao preço da Novita criam margem significativa no orçamento de infraestrutura. Um modelo com 90% do desempenho do Claude Sonnet 4 a 40% do custo muda a economia de executar agentes continuamente.

Novita Agent Sandbox como Ambiente de Execução

O Claude Code no VS Code pode executar comandos de shell localmente — vai compilar o seu projeto, executar testes, instalar pacotes e criar ficheiros na sua máquina. Para a maioria das tarefas do dia a dia, isso é suficiente. Mas algumas tarefas agênticas são melhor tratadas em computação isolada: suites de testes pesadas que bloqueiam a sua máquina, passos de compilação que instalam pacotes de sistema, comandos que modificam a configuração do sistema, ou execuções paralelas de agentes onde é necessária reprodutibilidade.

O Novita Agent Sandbox fornece ambientes de execução em nuvem criados especificamente para este caso de uso. Uma sandbox é uma microVM que arranca em milissegundos, executa código isolado do seu sistema anfitrião e termina de forma limpa quando a tarefa está concluída. Sem estado residual, sem impacto no seu ambiente local, sem esperar que a CPU da sua máquina recupere.

Para utilizadores do Claude Code, o fluxo de trabalho prático é: encaminhar a inferência para o endpoint LLM da Novita AI para chamadas de modelo de linguagem e, para tarefas de execução pesadas — compilações, execução de testes, avaliação de código — criar uma instância Agent Sandbox através da API do Novita Agent Sandbox. Os dois serviços partilham a autenticação (a mesma chave de API da Novita), por isso não há gestão separada de credenciais.

Equipas que constroem pipelines de revisão de código automatizada ou agentes Claude Code integrados em CI consideram esta combinação particularmente útil: o custo do LLM mantém-se previsível com o preço por token da Novita, e o custo de computação mantém-se previsível com a faturação por segundo do Agent Sandbox.

Dicas para o Fluxo de Trabalho Diário no VS Code

Alguns padrões que tornam a extensão prática em vez de uma curiosidade:

Comece novos projetos com /init. Executar /init num repositório novo gera um ficheiro inicial CLAUDE.md. É a forma mais eficiente de informar o Claude Code sobre as convenções do seu projeto antes de ele começar a editar.

Fixe contexto com #. Em vez de descrever que ficheiro deve consultar, escreva #nome_do_ficheiro para o anexar diretamente. Para trabalho de refatoração, #src/components/Button.tsx atualiza o handler onClick para usar o novo tipo de evento é mais rápido do que “olha para o componente Button e…”.

Use /compact proativamente. Numa sessão longa, o Claude Code acumula contexto. /compact resume a conversa e reduz a sobrecarga de tokens. Execute-o depois de concluir uma tarefa importante, antes de começar a seguinte.

Aceite ou rejeite diffs inline. Antes de o Claude Code editar um ficheiro, mostra o diff no painel. Não é obrigado a aceitar todas as alterações — rejeite diffs parciais e peça uma abordagem revista. Tratar cada resposta como um ponto de partida em vez de uma resposta final produz melhores resultados.

Separe as instruções do projeto das instruções de sessão. O CLAUDE.md serve para contexto estável do projeto (comandos de compilação, arquitetura, estilo de código). Instruções temporárias para a tarefa atual pertencem ao prompt da sessão. Não polua o CLAUDE.md com orientações de uma única tarefa.

FAQ

Onde está a documentação da extensão Claude Code para o VS Code?

A documentação oficial da extensão é mantida pela Anthropic em claude.ai/code. As notas de versão e o changelog estão visíveis no painel de Extensões do VS Code, na listagem do Claude Code.

A extensão Claude Code para o VS Code é gratuita?

A extensão em si é gratuita para instalar. Os custos de utilização dependem da configuração do seu backend. Com uma conta Anthropic, paga por token ou usa créditos de subscrição. Com o encaminhamento via Novita AI, paga a taxa por token da Novita e não são aplicados custos da Anthropic. Novas contas Novita recebem créditos de teste gratuitos no registo.

Posso usar a extensão do VS Code e a CLI do Claude Code ao mesmo tempo?

Sim, mas funcionam como sessões separadas. A extensão do VS Code não partilha uma sessão ativa com uma instância CLI aberta. Se precisar de continuidade de sessão entre os dois, use claude -c na CLI para retomar a sessão mais recente desse diretório.

Qual é a diferença entre o Claude Code e o Cline no VS Code?

O Cline é uma extensão do VS Code que encaminha o trabalho do agente através de qualquer backend compatível com OpenAI — oferece máxima flexibilidade de fornecedor, mas requer mais configuração. O Claude Code é o agente da própria Anthropic com um conjunto de ferramentas bem integrado. O redirecionamento ANTHROPIC_BASE_URL dá ao Claude Code uma flexibilidade de backend semelhante na prática. Se já tem a Novita AI configurada para o Claude Code, não precisa de uma instalação separada do Cline para aceder ao catálogo de modelos da Novita.

Posso usar modelos diferentes para projetos diferentes?

Sim. Use direnv com ficheiros .env ao nível do projeto para limitar ANTHROPIC_MODEL a um diretório específico. Quando abrir esse projeto no VS Code a partir de uma terminal com direnv ativo, a extensão herda a definição de modelo específica do projeto.

Novita AI é uma plataforma de nuvem de IA que oferece aos programadores uma forma simples de implementar modelos de IA através da nossa API simples, ao mesmo tempo que fornece GPU em nuvem acessível e fiável para criar e escalar.

Artigos Recomendados

• Claude Code no VS Code: Instale a Extensão, Configure o IDE e Mude para a Novita AI
• Documentação da CLI do Claude Code: Configuração, Comandos de Barra e Integração com a API LLM
• Como Integrar a API LLM da Novita AI com o Cline no VS Code