Compatibilidad de herramientas
¿Qué URL base debes pegar en tu herramienta? Casi todos los problemas se reducen a una de dos respuestas:
- Herramientas estilo OpenAI necesitan
https://synthorai.io/v1(incluir the/v1). - Herramientas estilo Anthropic necesitan
https://synthorai.io(no/v1- el SDK lo añade).
Dedicated step-by-step guides: Claude Code, OpenAI Codex CLI, OpenClaw, OpenCode, and Gemini CLI.
Referencia rápida
| Herramienta | Base URL para pegar | Campo de clave / variable de entorno |
|---|---|---|
| Claude Code (CLI) | https://synthorai.io | ANTHROPIC_API_KEY |
| Anthropic Python / Node SDK | https://synthorai.io | api_key= (constructor) |
| OpenAI Codex CLI | https://synthorai.io/v1 | OPENAI_API_KEY |
| OpenAI Python / Node SDK | https://synthorai.io/v1 | api_key= (constructor) |
| OpenClaw (provider.type=openai) | https://synthorai.io/v1 | providers.X.api_key |
| OpenClaw (provider.type=anthropic) | https://synthorai.io | providers.X.api_key |
| OpenCode (opencode auth login) | https://synthorai.io | se crea al iniciar sesión |
| OpenCode (opencode.json) | https://synthorai.io/v1 | options.apiKey |
| Gemini CLI (GOOGLE_GEMINI_BASE_URL) | https://synthorai.io | GEMINI_API_KEY |
| Cursor (anulación OpenAI) | https://synthorai.io/v1 | Settings → Clave API |
| Continue (config.json) | https://synthorai.io/v1 | models[].apiKey |
| Cline / Roo Code / Kilo Code (provider "OpenAI Compatible") | https://synthorai.io/v1 | Clave API |
| Zed (language_models.openai_compatible, api_url) | https://synthorai.io/v1 | Clave API |
| 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 la configuración de LiteLLM | api_key por ruta |
| Raw curl (estilo OpenAI) | https://synthorai.io/v1/... | Authorization: Bearer |
| Raw curl (estilo Anthropic) | https://synthorai.io/v1/messages | x-api-key cabecera |
¿Qué protocolo habla cada herramienta?
El protocolo que usa la herramienta determina a qué modelos upstream puede llegar a través de la pasarela:
- OpenAI Chat Completions (
/v1/chat/completions) - enruta a cualquiera modelo de chat: OpenAI, Anthropic, Google, Qwen, DeepSeek y más. Esta es la ruta universal - la predeterminada para Codex, Aider, Cursor, Continue, OpenClaw-OpenAI, LangChain ChatOpenAI, etc. - Anthropic Messages (
/v1/messages) - enruta solo a modelos de la familia Claude a través de los canales Anthropic o Bedrock-Anthropic. Usado por Claude Code, los SDK de Anthropic, OpenClaw-Anthropic y LangChain ChatAnthropic.
✦
Si una herramienta no aparece, prueba primero el formato OpenAI (https://synthorai.io/v1 + cualquier modelo de chat). Eso cubre el 90 % de las integraciones de la comunidad.
Una vez configurada tu herramienta, elige un modelo por defecto en la model price comparison - o estima cuánto cuesta un mes de uso con la LLM cost calculator.