Guia de Custom API para Claude Code

Antes de começar: dois valores necessários

Importante

ANTHROPIC_BASE_URL deve ser exatamente:

textCopy

https://api.ourtoken.ai

Não adicione /v1/messages. O Claude Code completa o caminho da requisição automaticamente.

Passo 1: instalar o Claude Code

Usuários de Mac

Abra o Terminal, cole e execute:

curl -fsSL https://claude.ai/install.sh | bash

Depois da instalação, adicione o Claude Code ao PATH do sistema para usar o comando claude:

p="$HOME/.local/bin"; grep -qxF 'export PATH="$HOME/.local/bin:$PATH"' "$HOME/.zshrc" 2>/dev/null || echo 'export PATH="$HOME/.local/bin:$PATH"' >> "$HOME/.zshrc"; export PATH="$p:$PATH"; claude --version

Usuários de Windows

No menu Iniciar, pesquise e abra o PowerShell, cole e execute:

irm https://claude.ai/install.ps1 | iex

Depois da instalação, adicione o Claude Code ao PATH do sistema para usar o comando claude:

$p="$env:USERPROFILE\.local\bin"; $u=[Environment]::GetEnvironmentVariable("Path","User"); if (($u-split";")-notcontains$p){[Environment]::SetEnvironmentVariable("Path",$u.TrimEnd(";")+";"+$p,"User")}; $env:Path+=";$p"; claude --version

Execute:

claude --version

Se o número da versão aparecer, a instalação foi concluída.

Captura da versão do Claude Code

⚠️ Se o comando claude não funcionar, verifique se o Claude Code foi adicionado ao PATH do sistema.

⚠️ Após instalar, não faça login com uma conta Anthropic. O próximo passo conecta diretamente com sua OurToken API Key.

Passo 2: configurar as credenciais da OurToken

Depois de instalar o Claude Code, abra o arquivo de configuração abaixo. Se o arquivo ou diretório não existir, crie manualmente.

Caminho do arquivo de configuração

• Mac:

  textCopy

  ~/.claude/settings.json
  

• Windows:

  textCopy

  C:\Users\<username>\.claude\settings.json
  

No Windows, substitua <username> pelo seu nome de usuário.

Cole o conteúdo abaixo em settings.json e substitua your ourtoken api key pela sua OurToken API Key:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your ourtoken api key",
    "ANTHROPIC_BASE_URL": "https://api.ourtoken.ai",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_OPUS_MODEL_NAME": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_SONNET_MODEL_NAME": "claude-sonnet-4-6",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    "ENABLE_TOOL_SEARCH": "true"
  },
  "model": "sonnet",
  "effortLevel": "medium",
  "autoUpdatesChannel": "latest"
}

Observação

Você pode substituir os modelos do arquivo por outros modelos compatíveis. Veja a lista atual na página OurToken API Keys.

Captura da lista de modelos da OurToken

Passo 3: verificar a configuração

Abra o Terminal ou PowerShell e execute em qualquer diretório:

claude

Na interface do Claude Code, envie uma mensagem simples:

Olá

Se o Claude Code responder normalmente, ele já está conectado à OurToken API.

Você também pode entrar na OurToken e verificar os registros de chamadas e custos no Dashboard.

• ✅ Claude Code responde normalmente
• ✅ O Dashboard da OurToken mostra registros de chamada
• ✅ O saldo da conta é debitado corretamente

Depois dessas verificações, você pode começar a usar o Claude Code.

Depois: usar no plugin do VS Code e no cliente Claude Code

Depois dessa configuração, você também pode usar o Claude Code diretamente no VS Code + plugin Claude Code ou no cliente Claude Code. Eles reutilizam as credenciais da OurToken já configuradas na máquina, sem necessidade de configurar novamente.