O Claude Code funciona como uma extensão nativa do VS Code instalada diretamente da marketplace — sem abas de navegador, sem copiar e colar entre janelas. A extensão incorpora o mesmo mecanismo do Claude Code que alimenta a CLI, então tudo, desde comandos de barra até edição de arquivos e chamadas de ferramentas MCP, funciona da mesma forma, só que dentro da barra lateral do seu editor. O PyCharm e o restante da família JetBrains recebem o mesmo tratamento por meio de um plugin JetBrains dedicado. E como ambas as superfícies leem ANTHROPIC_BASE_URL do ambiente, mudar o backend de LLM para a API da Novita AI — e sua seleção mais ampla de modelos — requer apenas uma alteração de variável de ambiente.
O que a Extensão do VS Code Realmente Faz
A extensão do Claude Code para VS Code não é uma aba de chatbot acoplada ao seu editor. Ela exibe o agente completo do Claude Code em um painel lateral: a mesma interface no estilo REPL, o mesmo conjunto de ferramentas, a mesma continuidade de sessão. Quando você pede para refatorar uma função ou escrever testes para um arquivo que está aberto, ela lê e edita esses arquivos diretamente no seu espaço de trabalho — sem usar a área de transferência.
Coisas concretas que a extensão lida:
- Edições em vários arquivos com diffs inline. O Claude Code propõe alterações e mostra um diff que você pode aceitar ou rejeitar sem sair do editor.
- Comandos de barra.
/compact,/init,/memory,/cleare os demais funcionam de forma idêntica à CLI. - Fixação de contexto. O prefixo
#permite anexar arquivos, pastas ou símbolos específicos como contexto para uma solicitação. - Consciência de CLAUDE.md. Instruções do projeto e padrões de codificação que você escreveu no
CLAUDE.mdsão carregados automaticamente no início da sessão. - Chamadas de ferramentas MCP. Quaisquer servidores MCP registrados na sua configuração do Claude Code ficam disponíveis dentro da extensão.
O que ela não faz: não adiciona autocompletar de IA no buffer do editor. Para isso, ferramentas como Copilot ou Cline cumprem um papel diferente. O Claude Code no VS Code é um agente — você dá a ele uma tarefa e ele executa várias etapas, não uma única conclusão inline.
Instalar o Claude Code no VS Code
Abra o painel de Extensões no VS Code (Ctrl+Shift+X no Windows/Linux, Cmd+Shift+X no macOS). Pesquise por Claude Code e procure a extensão publicada pela Anthropic. Clique em Instalar.
Alternativamente, execute isto no terminal:
code --install-extension Anthropic.claude-code
Após a instalação, o ícone do Claude aparece na Barra de Atividades do VS Code à esquerda. Clique nele para abrir o painel do Claude Code.
Autenticação no primeiro acesso. A extensão solicita que você faça login. Você tem duas opções:
- Conta Anthropic (assinatura ou faturamento no console): Siga o fluxo OAuth do navegador.
- Roteamento de chave de API para a Novita AI: Pule a autenticação da Anthropic completamente. Defina
ANTHROPIC_BASE_URLeANTHROPIC_AUTH_TOKENno seu ambiente antes de iniciar o VS Code, e a extensão os utilizará. Instruções completas na próxima seção.
Atualizações automáticas. O VS Code atualiza a extensão em segundo plano quando você reinicia o editor. Você não precisa gerenciar versões manualmente.
Usando o Claude Code no VS Code Diariamente
Depois que o painel estiver aberto, o fluxo de trabalho é direto. Digite uma solicitação, o Claude Code lê seu espaço de trabalho e responde com ações propostas. Antes de editar um arquivo, ele mostra um diff e aguarda aprovação por padrão.
Alguns padrões que tornam o uso diário eficiente:
Referencie o arquivo que você está vendo. Digite # seguido de um nome de arquivo para anexá-lo explicitamente como contexto. Para um arquivo já aberto no editor ativo, o Claude Code geralmente o captura automaticamente, mas # é útil quando você deseja fixar um arquivo específico em uma tarefa com vários arquivos.
Execute /init uma vez em um novo projeto. Isso cria um CLAUDE.md na raiz do repositório, onde você pode armazenar instruções específicas do projeto — bibliotecas preferidas, notas de arquitetura, convenções de teste. O Claude Code o lê em toda inicialização de sessão, para que você não se repita.
Use /compact quando a sessão ficar longa. Assim como na CLI, a extensão comprime o histórico da conversa sob demanda para liberar contexto para a tarefa atual.
Verifique a lista de ferramentas em execução. Na parte inferior do painel, o VS Code mostra qual ferramenta o Claude Code está chamando no momento (leituras de arquivo, comandos bash, pesquisas na web). Isso é útil para entender o que está acontecendo em tarefas automatizadas mais longas.
Desfazer é seu amigo. Todas as edições de arquivo passam pelo sistema de arquivos padrão do VS Code, então Ctrl+Z as reverte como qualquer edição manual. Não há uma pilha de desfazer separada para alterações do Claude Code.
Direcione a Extensão para a Novita AI
A extensão do VS Code lê ANTHROPIC_BASE_URL do ambiente na inicialização — a mesma variável que a CLI usa. Definí-la para o endpoint compatível com Anthropic da Novita AI redireciona todas as chamadas de API dos servidores da Anthropic. Você obtém acesso ao DeepSeek, Kimi K2, Qwen, GLM e outros modelos na infraestrutura da Novita AI, faturados através da sua conta Novita AI pelas taxas de token da Novita.
Obter uma chave de API da Novita AI
Crie uma conta na Novita AI para receber créditos de teste gratuitos. Vá para Gerenciamento de Chaves, crie uma nova chave e copie-a. Esta chave substitui sua chave de API da Anthropic ao rotear pela Novita.
Definir variáveis de ambiente antes de iniciar o VS Code
macOS e Linux — adicione estas ao seu perfil de shell (.zshrc, .bashrc ou equivalente) e recarregue-o:
export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<Sua chave de API da Novita>"
export ANTHROPIC_MODEL="deepseek/deepseek-v4-flash"
export ANTHROPIC_SMALL_FAST_MODEL="deepseek/deepseek-v4-flash"
source ~/.zshrc # ou ~/.bashrc
Windows (persistente — sobrevive a reinicializações) — use o PowerShell para definir variáveis de ambiente do usuário:
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","https://api.novita.ai/anthropic","User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN","<Sua chave de API da Novita>","User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL","deepseek/deepseek-v4-flash","User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_SMALL_FAST_MODEL","deepseek/deepseek-v4-flash","User")
Reinicie o VS Code depois de definir estas para que a extensão leia o ambiente atualizado.
Windows (apenas sessão):
set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=<Sua chave de API da Novita>
set ANTHROPIC_MODEL=deepseek/deepseek-v4-flash
set ANTHROPIC_SMALL_FAST_MODEL=deepseek/deepseek-v4-flash
Depois de defini-las, inicie o VS Code a partir do mesmo shell. A extensão capta as variáveis na inicialização. Você não precisa fazer login na Anthropic — a Novita lida com a autenticação através da chave de API.
Escolhendo um modelo
ANTHROPIC_MODEL informa ao Claude Code qual modelo usar para tarefas principais; ANTHROPIC_SMALL_FAST_MODEL controla operações em segundo plano, como resumos de arquivos. Qualquer modelo disponível na API LLM da Novita AI pode ser definido aqui. Modelos usados com frequência com o Claude Code na Novita incluem DeepSeek V4 Flash, Kimi K2 e GLM-4.6 — cada um com diferentes tamanhos de janela de contexto, preços e características de desempenho dependendo da sua carga de trabalho.
Para reverter ao roteamento padrão da Anthropic, remova as variáveis de ambiente:
unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN ANTHROPIC_MODEL ANTHROPIC_SMALL_FAST_MODEL
Ou abra o VS Code a partir de um shell onde essas variáveis nunca foram definidas.
Integração com PyCharm e JetBrains
O Claude Code oferece um plugin oficial para a plataforma JetBrains, que cobre PyCharm, IntelliJ IDEA, WebStorm, GoLand, Rider e o restante da família JetBrains.
Instalar o plugin
Abra Configurações → Plugins na sua IDE JetBrains, vá para a aba Marketplace e pesquise por Claude Code. Clique em Instalar e reinicie a IDE quando solicitado.
Alternativamente, baixe o arquivo do plugin do site JetBrains Marketplace e instale-o via Configurações → Plugins → Instalar Plugin do Disco.
Primeira execução
Após a instalação, o painel do Claude Code aparece na barra lateral ou na área de janela de ferramentas da IDE, dependendo do seu layout. O primeiro acesso solicita autenticação, de forma idêntica ao VS Code.
Direcionar o PyCharm para a Novita AI
O plugin JetBrains lê as mesmas variáveis de ambiente que a extensão do VS Code e a CLI. Defina ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_MODEL e ANTHROPIC_SMALL_FAST_MODEL no seu perfil de shell antes de iniciar a IDE, e o plugin roteará através da Novita.
Se você iniciar o PyCharm a partir de um lançador da área de trabalho em vez de um terminal (comum no macOS e Linux), a IDE pode não herdar seu ambiente de shell. A correção confiável é um arquivo .env por projeto ou definir as variáveis no ambiente do sistema, em vez de no perfil do shell. No macOS especificamente, variáveis definidas via launchctl setenv ficam visíveis para aplicativos GUI.
Extensão da IDE vs. CLI: Quando Usar Cada Uma
A extensão e a CLI compartilham o mesmo mecanismo. A diferença prática é o contexto e a integração.
| Extensão VS Code / JetBrains | CLI | |
|---|---|---|
| Navegação de arquivos | Clique para abrir, # para referenciar |
Lê a partir do diretório atual; especifique caminhos explicitamente |
| Revisão de diff | Inline no editor | Saída no terminal |
| Múltiplos projetos | Um painel por janela | Sessões separadas por diretório |
| CI/CD e automação | Não apropriado | Sinalizador -p para execuções em lote não interativas |
| Pipe e scripts | Não suportado | Suporte completo a pipes Unix |
| Roteamento Novita AI | Variável de ambiente ANTHROPIC_BASE_URL |
Mesmo |
A extensão é a melhor escolha quando seu fluxo de trabalho principal é editar código interativamente. A CLI é a escolha certa quando você está automatizando tarefas, executando o Claude Code em scripts, integrando com CI ou construindo sobre o Claude Code SDK.
Sandbox de Agentes da Novita AI
Se você migrar do desenvolvimento interativo para pipelines automatizados — executando agentes Claude Code sem cabeça, gerando vários agentes em diferentes repositórios ou construindo estruturas de avaliação — o Sandbox de Agentes da Novita AI fornece ambientes de execução isolados para executar agentes programaticamente. Cada sandbox é uma VM baseada em Firecracker, então os agentes são executados de forma isolada sem afetar sua máquina de desenvolvimento.
Perguntas Frequentes
Preciso de uma assinatura paga da Anthropic para usar a extensão do VS Code?
Não — se você direcionar a extensão para a Novita AI via ANTHROPIC_BASE_URL, todo o faturamento passa pela sua conta Novita AI. Uma conta Anthropic não é necessária e não será cobrada.
Como instalo a extensão do Claude Code para VS Code?
Abra o painel de Extensões no VS Code (Ctrl+Shift+X), pesquise por Claude Code (editor: Anthropic) e clique em Instalar. Ou execute code --install-extension Anthropic.claude-code no terminal.
A extensão do Claude Code funciona no Cursor?
O Cursor é um fork do VS Code e suporta a maioria das extensões do VS Code. A extensão do Claude Code pode ser instalada, mas o Cursor já possui sua própria integração integrada do Claude. Executar ambos simultaneamente pode produzir sugestões duplicadas e fluxos de autenticação conflitantes. A maioria dos desenvolvedores usa um ou outro, não ambos.
Existe uma extensão de navegador do Claude?
Não há uma extensão oficial de navegador do Claude da Anthropic. O Claude Code funciona como extensão do VS Code, plugin JetBrains, CLI, aplicativo de desktop e através da interface web em claude.ai/code — mas não como uma extensão de navegador que se conecta a páginas web arbitrárias.
Como mudo de modelo sem reiniciar o VS Code?
Altere ANTHROPIC_MODEL no seu perfil de shell e reabra o VS Code a partir de uma nova sessão de terminal. Dentro de uma sessão do VS Code em execução, não há um seletor de modelo no painel — a variável de ambiente é lida na inicialização.
Posso usar modelos diferentes para projetos diferentes?
Sim. Defina ANTHROPIC_MODEL em um arquivo .env no nível do projeto ou em uma instrução CLAUDE.md, ou use o direnv para definir variáveis de ambiente para diretórios específicos. O Claude Code respeita os valores do ambiente no nível da sessão, portanto, o roteamento por projeto é alcançável com ferramentas padrão de dotfiles.
Qual é a diferença entre integrar o Claude com o VS Code e usar o Cline?
O Cline é uma extensão que transforma o VS Code em um ambiente de codificação agêntico usando qualquer backend compatível com OpenAI. O Claude Code é o próprio agente da Anthropic, disponível como extensão do VS Code, com seu próprio conjunto de ferramentas e loop de raciocínio. A principal diferença prática: o Cline oferece mais controle sobre qual provedor e modelo executa o loop, enquanto o Claude Code é integrado de forma estreita com a família de modelos Claude por padrão — embora ANTHROPIC_BASE_URL permita redirecioná-lo para o endpoint compatível da Novita AI.
Artigos Recomendados
