Claude Code

O agente de codificação em terminal oficial da Anthropic. Ele fala o protocolo Anthropic Messages, então, assim que você o apontar para o Synthorai com duas variáveis de ambiente, cada modelo Claude do seu workspace fica disponível — nada mais na sua configuração muda.

✦

Este é o caminho de integração mais popular para equipes que querem o Claude no terminal e faturamento centralizado + limites de taxa no gateway.

Antes de começar

Crie uma chave de API em Console → API Keys. A chave completa é exibida uma vez — copie-a antes de fechar a caixa de diálogo.

Etapa 1 — Definir variáveis de ambiente

O Claude Code lê ANTHROPIC_BASE_URL e ANTHROPIC_API_KEY do ambiente. Adicione-as ao seu perfil de shell (~/.zshrc, ~/.bashrc, ou ~/.config/fish/config.fish) para que cada novo terminal as utilize.

# ~/.zshrc (or equivalent)
export ANTHROPIC_BASE_URL="https://synthorai.io"
export ANTHROPIC_API_KEY="sk-..."   # your Synthorai key

⚠

A base URL não inclui /v1 — o SDK da Anthropic adiciona /v1/messages internamente. Se você colou https://synthorai.io/v1, as requisições atingirão /v1/v1/messages e retornarão 404.

Etapa 2 — Envie sua primeira requisição

# Reload env, then:
claude --model claude-sonnet-4-6 "explain this diff" < <(git diff HEAD~1)

# Or start an interactive coding session:
claude code --model claude-opus-4-6

Uma resposta bem-sucedida imprime a saída do modelo no stdout. Se você obtiver 401 a chave está incorreta ou desativada; se você obtiver 404 o nome do modelo não é roteável no seu workspace — verifique /console/pricing.

Modelos recomendados

Parâmetro	Tipo	Descrição
`claude-opus-4-6`	`reasoning`	Qualidade de ponta. Use para refatorações profundas e problemas ambíguos.
`claude-sonnet-4-6`	`balanced`	Melhor relação preço/qualidade para codificação do dia a dia e sessões de agente longas.
`claude-haiku-4-5`	`fast`	O mais barato, o mais rápido. Bom para perguntas ad hoc casuais e edições curtas.

Solução de problemas

401 Unauthorized — a chave está incorreta, desativada ou já foi revogada. Gere-a novamente em /console/keys.

404 / "modelo não encontrado" — o modelo que você passou para --model não está no catálogo de canais do seu workspace. Execute curl $ANTHROPIC_BASE_URL/v1/models -H "x-api-key: $ANTHROPIC_API_KEY" para ver o que está disponível.

"Ainda atingindo api.anthropic.com" — seu shell não carregou as novas variáveis de ambiente. Abra um novo terminal, ou source ~/.zshrc.

Posso usar modelos que não sejam Claude através do claude-code? — Não. A CLI fala apenas a API Anthropic Messages e o /v1/messages do Synthorai roteia apenas para modelos Claude. Para modelos OpenAI / Gemini / Qwen use Codex, Aider ou o SDK da OpenAI diretamente.

Os preços atuais por token dos três níveis estão na Claude model price comparison.