Compatibilidade de ferramentas
Qual URL base você deve colar na sua ferramenta? Quase todos os problemas se resumem a uma de duas respostas:
- Ferramentas no estilo OpenAI precisam de
https://synthorai.io/v1(incluir the/v1). - Ferramentas no estilo Anthropic precisam de
https://synthorai.io(não/v1— o SDK o adiciona).
Dedicated step-by-step guides: Claude Code, OpenAI Codex CLI, and OpenClaw.
Referência rápida
| Ferramenta | Base URL para colar | Campo da chave / variável de ambiente |
|---|---|---|
| Claude Code (CLI) | https://synthorai.io | ANTHROPIC_API_KEY |
| Anthropic Python / Node SDK | https://synthorai.io | api_key= (construtor) |
| OpenAI Codex CLI | https://synthorai.io/v1 | OPENAI_API_KEY |
| OpenAI Python / Node SDK | https://synthorai.io/v1 | api_key= (construtor) |
| OpenClaw (provider.type=openai) | https://synthorai.io/v1 | providers.X.api_key |
| OpenClaw (provider.type=anthropic) | https://synthorai.io | providers.X.api_key |
| Cursor (substituição OpenAI) | https://synthorai.io/v1 | Settings → Chave API |
| Continue (config.json) | https://synthorai.io/v1 | models[].apiKey |
| Aider | https://synthorai.io/v1 | OPENAI_API_KEY |
| LangChain ChatOpenAI | https://synthorai.io/v1 | openai_api_key |
| LangChain ChatAnthropic | https://synthorai.io | anthropic_api_key |
| LiteLLM proxy | ver a configuração do LiteLLM | api_key por rota |
| Raw curl (estilo OpenAI) | https://synthorai.io/v1/... | Authorization: Bearer |
| Raw curl (estilo Anthropic) | https://synthorai.io/v1/messages | x-api-key cabeçalho |
Qual protocolo cada ferramenta usa?
O protocolo que a ferramenta usa determina quais modelos upstream ela pode alcançar através do gateway:
- OpenAI Chat Completions (
/v1/chat/completions) — roteia para qualquer modelo de chat: OpenAI, Anthropic, Google, Qwen, DeepSeek e mais. Este é o caminho universal — o padrão para Codex, Aider, Cursor, Continue, OpenClaw-OpenAI, LangChain ChatOpenAI, etc. - Anthropic Messages (
/v1/messages) — roteia apenas para modelos da família Claude via canais Anthropic ou Bedrock-Anthropic. Usado por Claude Code, os SDKs Anthropic, OpenClaw-Anthropic e LangChain ChatAnthropic.
✦
Se uma ferramenta não estiver listada, tente primeiro o formato OpenAI (https://synthorai.io/v1 + qualquer modelo de chat). Isso cobre 90% das integrações da comunidade.
Depois de configurar sua ferramenta, escolha um modelo padrão na model price comparison — ou estime quanto custa um mês de uso com a LLM cost calculator.