Configuração do Plugin Claude Code no VSCode para Windows com API Silicon Flow

Visão Geral da Configuração

Este guia aborda a integração do plugin Claude Code no Visual Studio Code no Windows, utilizando a API da Silicon Flow como provedor de LLM de terceiros. O método elimina a necessidade de uma assinatura paga da Anthropic, ofereecndo uma solução de código aberto para desenvolvimento assistido por IA.

Método Cenário Ideal Complexidade
Plugin do VSCode (foco deste guia) Desenvolvimento de software diário com integração profunda no editor Baixa, instalação direta
CLI via WSL2 Automação de terminal, scripts de shell e operações DevOps Média, requer configuração de ambiente Linux

Os métodos são independentes e podem coexistir. Esta abordagem via plugin executa nativamente no Windows sem dependências adicionais.

Pré-requisitos

  • Sistema Windows 10 ou 11 atualizado
  • Visual Studio Code instalado
  • Conta na Silicon Flow com uma chave de API válida (prefixo sk-)
  • Conexão direta à internet (a API da Silicon Flow é acessível sem proxy na China)

Passo 1: Instalação do Plugin

No VSCode, acesse o painel de extensões usando o atalho Ctrl+Shift+X. Pesquise por Claude Code e instale a versão oficial publicada pela Anthropic. Após a instalação, um ícone dedicado aparecerá na barra lateral para iniciar a interface de chat.

Passo 2: Configuração da API via Variáveis de Ambiente

O plugin utiliza o arquivo settings.json do usuário para injetar variáveis de ambiente, substituindo a necessidade de scripts auxiliares. As variáveis são definidas no campo claudeCode.environmentVariables.

2.1 Acessando o Arquivo de Configurações

Execute o comando Preferences: Open User Settings (JSON) através da paleta de comandos (Ctrl+Shift+P).

2.2 Inserção das Variáveis

Adicione o seguinte bloco JSON ao arquivo, mantendo a formatação adqeuada:

"claudeCode.environmentVariables": [
  {
    "name": "SILICONFLOW_API_ENDPOINT",
    "value": "https://api.siliconflow.cn"
  },
  {
    "name": "SILICONFLOW_AUTH_KEY",
    "value": "sk-sua-chave-aqui"
  },
  {
    "name": "SILICONFLOW_PRIMARY_MODEL",
    "value": "Pro/moonshotai/Kimi-K2.6"
  },
  {
    "name": "SILICONFLOW_TIER_OPUS",
    "value": "Pro/moonshotai/Kimi-K2.6"
  },
  {
    "name": "SILICONFLOW_TIER_SONNET",
    "value": "Pro/moonshotai/Kimi-K2.5"
  },
  {
    "name": "SILICONFLOW_TIER_HAIKU",
    "value": "Pro/deepseek/deepseek-v3"
  }
]

Explicação das variáveis:

Variável Função
SILICONFLOW_API_ENDPOINT URL base da API, sem barra no final
SILICONFLOW_AUTH_KEY Chave de autenticação da Silicon Flow
SILICONFLOW_PRIMARY_MODEL Modelo principal para conversas iniciadas pelo usuário
SILICONFLOW_TIER_OPUS Modelo para tarefas de alta complexidade (equivalente ao nível Opus)
SILICONFLOW_TIER_SONNET Modelo para tarefas de complexidade média (equivalente ao nível Sonnet)
SILICONFLOW_TIER_HAIKU Modelo para tarefas leves e rápidas (equiavlente ao nível Haiku)

Nota sobre autenticação: Utilize a variável SILICONFLOW_AUTH_KEY para provedores de terceiros, pois o cabeçalho Authorization: Bearer <token> é o padrão adotado. Evite usar a variável ANTHROPIC_API_KEY para este fim, pois o formato de autenticação difere.

Passo 3: Validação

Após salvar as configurações, reinicie completamente o VSCode (encerre o processo pelo Gerenciador de Tarefas). Abra o painel do Claude Code e envie uma mensagem de teste como:

Qual modelo de IA você está utilizando atualmente?

Se a resposta contiver o nome do modelo configurado, a integração está funcionando.

Gerenciamento dos Modelos

Para alterar os modelos, edite os valores correspondentes no settings.json e reinicie o VSCode. Não é possível alternar modelos temporariamente durante uma sessão via comando como na CLI. O comando /model no chat permite alternar entre os modelos já configurados nas variáveis.

Modelos recomendados da Silicon Flow para tarefas de programação incluem:

  • Kimi K2.6: Ideal para tarefas complexas e agentes autônomos.
  • DeepSeek V3: Excelente para respostas rápidas e chamadas de ferramentas.
  • Kimi K2 Thinking: Otimizado para análise profunda e raciocínio lógico.

Consulte o catálogo da Silicon Flow para IDs de modelo atualizados.

Cuidados Importantes

  • Evite conflitos garantindo que variáveis globais do Windows como ANTHROPIC_API_KEY não estejam definidas.
  • O arquivo settings.json contém chaves de API sensíveis; não o inclua em repositórios Git.
  • As configurações no nível do projeto (diretório .claude/) são independentes das configurações do usuário.
  • Qualquer alteração nas variáveis de ambiente exige uma reinicialização completa do VSCode.

Localização do Arquivo de Configurações

As configurações do usuário são armazenadas em:

%APPDATA%\Code\User\settings.json

No Windows, isso tipicamente se expande para:

C:\Users\[SeuUsuário]\AppData\Roaming\Code\User\settings.json

Tags: Claude Code vscode Silicon Flow API Windows LLM API

Publicado em 6-7 06:45 por Thomas