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_KEYnão estejam definidas. - O arquivo
settings.jsonconté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