CLI do Claude Code

Conecte o Claude Code CLI ao GetVibe API: configure ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN e a seleção do modelo por meio de variáveis de ambiente.

Configuração pronta

Download settings.json

Gerado sob demanda a partir do nosso catálogo: o endereço da API, todos os modelos publicados com seus limites de contexto e saída e as configurações recomendadas. Ele não contém uma chave. O Claude Code lê a chave de GETVIBE_API_KEY por meio de apiKeyHelper — defina-a no seu ambiente. No Windows sem WSL, defina ANTHROPIC_AUTH_TOKEN em vez disso.

# macOS / Linux
mkdir -p ~/.claude
curl -fsSL https://getvibeapi.com/api/integrations/claude-code.json -o ~/.claude/settings.json

# Windows PowerShell
New-Item -ItemType Directory -Force "$HOME\.claude" | Out-Null
Invoke-WebRequest https://getvibeapi.com/api/integrations/claude-code.json -OutFile "$HOME\.claude\settings.json"

Modelo principal — claude-opus-5.5: o Claude mais poderoso que oferecemos por /v1/messages.
Tarefas pequenas — claude-haiku-4.5: o Claude mais barato, usado pelo Claude Code para tarefas em segundo plano.
Streaming ativado, tempo limite de solicitação de 600 segundos e esforço de raciocínio médio: uma resposta com raciocínio longo leva minutos e, sem streaming, atinge o limite de espera.
IDs de modelo sem sufixo em todos os lugares — isso mantém o failover automático para um canal saudável ativado.

O catálogo muda: quando novos modelos aparecerem, baixe o arquivo novamente. Para manter apenas alguns modelos, adicione ?models= com IDs separados por vírgulas à URL.

Não quer terminal? Para a maioria das tarefas o app Claude Desktop é mais simples — poucos passos, sem comandos. Esta página é para quem trabalha com código no terminal.

Claude Code é a CLI oficial da Anthropic para codificação agêntica. Funciona pelo endpoint /v1/messages com o cabeçalho x-api-key.

1. Abra um terminal

Windows: Iniciar → digite PowerShell → Enter. macOS: Terminal (Aplicativos → Utilitários). A instalação via npm exige Node.js 22 ou posterior (node --version) — o bloco abaixo instala a própria CLI. Prefere não usar Node.js? O instalador nativo da Anthropic também funciona: curl -fsSL https://claude.ai/install.sh | bash (macOS/Linux) ou irm https://claude.ai/install.ps1 | iex (PowerShell); depois, defina as variáveis abaixo em uma nova janela.

2. Cole um bloco e pressione Enter

O bloco instala a CLI, salva as configurações para sempre (setx), aplica no janela atual e inicia o programa. Substitua sk-pv-… pela sua chave.

Windows (PowerShell)

npm.cmd install -g @anthropic-ai/claude-code
setx ANTHROPIC_BASE_URL "https://getvibeapi.com"
setx ANTHROPIC_AUTH_TOKEN "sk-pv-…"
$env:ANTHROPIC_BASE_URL="https://getvibeapi.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-pv-…"
$env:ANTHROPIC_API_KEY=""
claude.cmd

macOS / Linux

npm install -g @anthropic-ai/claude-code
export ANTHROPIC_BASE_URL="https://getvibeapi.com"
export ANTHROPIC_AUTH_TOKEN="sk-pv-…"
export ANTHROPIC_API_KEY=""
claude

Importante: o endereço é https://getvibeapi.com (sem /v1): a CLI adiciona o sufixo por conta própria. A chave vai em ANTHROPIC_AUTH_TOKEN, e ANTHROPIC_API_KEY fica vazio: se uma chave da Anthropic já estiver salva na máquina, o Claude Code avisará que há duas chaves em conflito. Depois de setx, as novas janelas do PowerShell passam a usar as configurações; as janelas que já estavam abertas não.

Onde digitar

Ao iniciar, a linha com o sinal > no rodapé da janela é onde você digita e pressiona Enter:

+---------------------------------------+
|                                       |
|  > _                                  |
|                                       |
+---------------------------------------+

A primeira execução pergunta o tema (pressione Enter) e se você confia na pasta (escolha Yes, I trust this folder). Para trabalhar de verdade, inicie a CLI na pasta do projeto.

3. Verifique a conexão

Envie qualquer mensagem e abra Painel → Uso: um novo registro aparece com o modelo e o gasto. Dentro do Claude Code, /status mostra uma linha Anthropic base URL — ela deve mostrar nosso endereço.

Escolha de modelos (opcional)

Por padrão o Claude Code usa o modelo padrão do catálogo. Substitua com variáveis de ambiente:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-pv-…",
    "ANTHROPIC_BASE_URL": "https://getvibeapi.com",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5.5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL":   "claude-opus-5.5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL":  "claude-haiku-5.5"
  }
}

Se preferir settings.json

O mesmo resultado é obtido com o arquivo ~/.claude/settings.json. No Windows: %USERPROFILE%\.claude\settings.json. Cole a própria chave: o Claude Code não expande variáveis como $GETVIBE_API_KEY dentro de settings.json, então essa string seria enviada como chave e a solicitação seria rejeitada.

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-pv-…",
    "ANTHROPIC_BASE_URL": "https://getvibeapi.com",
    "ANTHROPIC_API_KEY": ""
  }
}

Problemas comuns

Parâmetro	Tipo	Descrição
`401`	error	Confira o valor de ANTHROPIC_AUTH_TOKEN: settings.json deve conter a própria chave sk-pv-…, não uma $variable.
`Requests go to Anthropic`	config	ANTHROPIC_BASE_URL não chegou ao Claude Code: abra uma nova janela após setx ou defina o endereço em settings.json. Confira a linha da URL base da Anthropic em /status.
`404`	error	ANTHROPIC_BASE_URL pegou /v1 — deve ser o endereço raiz sem o sufixo.
`npm.ps1 is blocked`	Windows	É a política de execução do PowerShell. Use npm.cmd e claude.cmd como no bloco acima — não é preciso mudar a política.
`"node is not recognized"`	Windows	O Node.js não está instalado, ou a janela é anterior à instalação: instale o Node.js LTS e abra uma janela do PowerShell NOVA.
`claude native binary not installed / warn install-scripts`	npm	As versões mais recentes do npm ignoram a etapa de instalação do Claude Code por padrão. Execute npm config set "allow-scripts=@anthropic-ai/claude-code" --location=user e instale novamente, ou use o instalador nativo.
`Variables are not picked up`	config	settings.json é mais confiável do que os perfis do shell — especialmente no Windows.

← AnteriorPi Agent Próximo →Claude Desktop