Skip to content

Claude Code para VS Code

Claude Code pode ser usado diretamente em VS Code através da extensão oficial Anthropic. Não é necessária uma conta separada Anthropic: a extensão enviará solicitações por meio de sua chave API NordRouter e debitará o pagamento do seu saldo.

O que você vai precisar

1. Instale a extensão

  1. Abra VS Code.
  2. Clique em Ctrl+Shift+X no Windows/Linux ou Cmd+Shift+X no macOS.
  3. Encontre Claude Code e instale a extensão oficial Anthropic.
  4. Caso o painel Claude não apareça, abra a Paleta de Comandos (Ctrl+Shift+P / Cmd+Shift+P), execute Developer: Reload Window e aguarde a janela reiniciar.

Em seguida, abra as configurações VS Code (Ctrl+, / Cmd+,), encontre Claude Code: Disable Login Prompt e ative esta configuração. Ele desativa o login na conta Anthropic ao trabalhar por meio de um provedor de API de terceiros.

A extensão já inclui Claude Code CLI, portanto, para trabalho normal em VS Code não há necessidade de instalar a CLI separadamente.

2. Adicione configurações NordRouter

Abra ou crie um arquivo:

  • Windows: %USERPROFILE%\.claude\settings.json;
  • macOS e Linux: ~/.claude/settings.json.

Cole a seguinte configuração e substitua sk-nr-ВАШ-КЛЮЧ pela sua chave:

json
{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_API_KEY": "sk-nr-ВАШ-КЛЮЧ",
    "ANTHROPIC_BASE_URL": "https://nordrouter.com",
    "ANTHROPIC_MODEL": "anthropic/claude-sonnet-4.6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "anthropic/claude-opus-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "anthropic/claude-sonnet-4.6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "anthropic/claude-haiku-4.5",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

O URL base é especificado sem /v1

Correto: https://nordrouter.com. Claude Code adiciona independentemente o caminho Anthropic API. Se você especificar /v1, a solicitação poderá ir para o endereço inexistente /v1/v1/messages.

O arquivo settings.json é comum à CLI Claude Code e à extensão VS Code. Não há necessidade de configurá-los separadamente.

3. Abra Claude Code

  1. Abra a pasta do seu projeto em VS Code.
  2. Clique no ícone Claude na barra lateral ou no ícone ✦ no canto superior direito do editor.
  3. Se não houver nenhum ícone, abra a Paleta de Comandos e execute Claude Code: Abrir em Nova Guia.
  4. Depois de alterar settings.json, execute Developer: Reload Window uma vez.

Para a primeira verificação, selecione o modo Plano e envie uma solicitação segura:

Explique a estrutura deste projeto sem alterar os arquivos.

Se Claude responder emhistórico de atividades aparece uma solicitação, a conexão está funcionando.

Como mudar de modelo

Altere ANTHROPIC_MODEL para settings.json, por exemplo:

json
"ANTHROPIC_MODEL": "anthropic/claude-opus-5"

Use o ID completo do modelo com o prefixo anthropic/. Para modelos disponíveis e preços atuais, consulteCatálogo NordRouter.

Problemas comuns

A extensão solicita que você faça login em sua conta Anthropic

Verifique se a configuração Claude Code: Disable Login Prompt está habilitada e se ANTHROPIC_API_KEY está localizado dentro do bloco env no arquivo .claude/settings.json. Em seguida, execute Desenvolvedor: Recarregar janela. Se você fez login anteriormente em Claude Code usando uma conta Anthropic, execute /logout no terminal Claude Code e reinicie a janela VS Code.

Auth conflict: Both a token and an API key are set

O antigo ANTHROPIC_AUTH_TOKEN entra em conflito com a chave da API. Remova esta variável do ambiente e de settings.json, deixando apenas ANTHROPIC_API_KEY.

Invalid URL ou solicite para /v1/v1/messages

Remova /v1 de ANTHROPIC_BASE_URL. Deve ser exatamente https://nordrouter.com.

No pricing available for model …

Especifique o ID completo do modelo, por exemplo anthropic/claude-sonnet-4.6, e verifique os valores de ANTHROPIC_DEFAULT_*_MODEL usando a configuração finalizada acima.

Claude Code não está visível em VS Code

Atualize VS Code para a versão 1.94 ou posterior, certifique-se de que a extensão esteja habilitada para o perfil atual e execute Desenvolvedor: Recarregar janela.

Se o erro persistir, abrainstruções completas para Claude Code eseção com soluções para erros comuns.

Documentação oficial