Extensão do Claude Code para VS Code com uma API de terceiros: configuração de environmentVariables

Wokey Team · 2026-09-24

Resposta curta: para apontar a extensão do Claude Code para VS Code para uma API de terceiros, coloque ANTHROPIC_BASE_URL e ANTHROPIC_AUTH_TOKEN em claudeCode.environmentVariables nas configurações de usuário do VS Code e ative claudeCode.disableLoginPrompt. Exportar variáveis em um terminal quase nunca chega à extensão. O ~/.claude/settings.json também não basta: a verificação de login antes da inicialização da extensão não consegue lê-lo, então a tela de login continua aparecendo.

Configuração

1. Instale a extensão. Ela exige o VS Code 1.94.0 ou posterior. Procure "Claude Code" (publicador: Anthropic) na visualização Extensions (Cmd/Ctrl+Shift+X). O Cursor pode instalar a mesma extensão, e editores como o VSCodium podem obtê-la no Open VSX.
2. Abra suas configurações de usuário. Pressione Cmd/Ctrl+Shift+P e rode Preferences: Open User Settings (JSON).
3. Adicione as configurações. Dentro das {} mais externas, adicione:

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.wokey.ai" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "your Wokey API key" }
  ],
  "claudeCode.disableLoginPrompt": true
}

4. Recarregue. Rode Developer: Reload Window pela paleta de comandos e depois abra o painel do Claude Code.

Três pontos de atenção:

• ANTHROPIC_BASE_URL é só o domínio, sem /v1; a extensão acrescenta /v1/messages sozinha.
• Isso vai nas configurações de usuário, não no .vscode/settings.json do workspace, que muitas vezes vai para o repositório no commit.
• disableLoginPrompt pula o pedido de login. A descrição oficial diz que ele é "for third-party provider setups".

Por que export e settings.json não bastam

Antes de iniciar o processo do Claude, a extensão verifica se há uma credencial disponível. Essa verificação lê apenas claudeCode.environmentVariables:

• O VS Code aberto pelo Dock, pelo menu Iniciar ou por um ícone na área de trabalho não recebe as variáveis que você exporta no ~/.zshrc.
• O bloco env em ~/.claude/settings.json chega ao processo do Claude que a extensão inicia, mas não à verificação de login da própria extensão.

Então, com só o settings.json e disableLoginPrompt desativado, o sintoma típico é uma extensão que continua pedindo para você entrar. Para usar variáveis do shell pontualmente, rode code . em um terminal onde elas estejam definidas. Para o uso diário, as configurações de usuário acima são mais confiáveis.

Confirme que as requisições passam pela Wokey

Rode /status na caixa de prompt da extensão (isso exige o Claude Code v2.1.280 ou posterior). O Anthropic base URL da aba Status deve mostrar https://api.wokey.ai.

Escolhendo modelos

Escolha Switch model… no menu de comandos, ou clique no nome do modelo abaixo da caixa de prompt. Para fixar qual modelo cada nível Opus, Sonnet e Haiku usa, adicione as variáveis à mesma lista:

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.wokey.ai" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "your Wokey API key" },
    { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "claude-opus-5" },
    { "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "claude-sonnet-5" }
  ]
}

O que não fica disponível com uma API de terceiros

Com uma API de terceiros, a extensão não oferece recursos que exigem uma conta do claude.ai:

• Barras de uso do plano, ditado por voz e a aba Web para sessões na nuvem.
• Não há o item Sign out no menu.
• Enviar /bug mostra um erro e não envia nada.

Uma conta do claude.ai em que você entrou antes com /login continua salva, mas sem uso.

Comparada à CLI no terminal, a extensão também suporta só parte dos comandos, e não tem o atalho de Bash ! nem autocompletar com tab.

Solução de problemas

A tela de login continua aparecendo. claudeCode.environmentVariables está faltando ou no lugar errado (como nas configurações do workspace), ou você não recarregou a janela depois da mudança. Confira também se disableLoginPrompt está como true.

invalid x-api-key. A requisição foi para o endereço da própria Anthropic porque ANTHROPIC_BASE_URL não foi aplicada. A Wokey nunca retorna essa mensagem; veja o guia de invalid x-api-key.

Um 404 citando /v1/v1/messages. A base URL tem um /v1 sobrando. Troque para https://api.wokey.ai.

Nenhuma resposta e nenhum erro. A recomendação oficial é rodar claude em um terminal para ver erros mais detalhados. A extensão traz a própria CLI embutida, mas não adiciona claude ao seu PATH, então instale a CLI separadamente e defina as variáveis dela como no guia de base URL do Claude Code.

Usuários do JetBrains

O plugin do JetBrains não traz uma CLI embutida. Ele roda o comando claude instalado na sua máquina no terminal da IDE; você pode mudar o caminho em Settings → Tools → Claude Code [Beta] → Claude command. Por isso, o JetBrains é configurado do mesmo jeito que a CLI: coloque ANTHROPIC_BASE_URL e ANTHROPIC_AUTH_TOKEN no bloco env de ~/.claude/settings.json. Veja o guia de base URL do Claude Code.