Uso de modelos

¿Cómo debo configurar el Base URL?

Aprende cómo deben coincidir el Base URL, las rutas /v1, la API Key y el Model ID en Claude Code, Codex CLI, Cursor, Cline y otras herramientas. Con ejemplos.

Respuesta breve

El Base URL debe coincidir con el protocolo que espera la herramienta. Claude Code suele usar la dirección raíz compatible con Anthropic. Codex CLI, Cursor, Cline, OpenCode, OpenClaw y otras herramientas externas suelen usar la dirección /v1 compatible con OpenAI.

En BetterToken:

Caso de uso	Base URL
Claude Code / compatible con Anthropic	`https://bettertoken.ai`
Codex CLI / compatible con OpenAI	`https://bettertoken.ai/v1`
Cursor, Cline, OpenCode, OpenClaw	`https://bettertoken.ai/v1`

Usa https://bettertoken.ai para Claude Code y https://bettertoken.ai/v1 para Codex CLI y herramientas OpenAI-compatible. Elige la dirección según el protocolo del cliente.

Por qué hay distintos Base URL

Cada SDK añade las rutas de una manera distinta.

Protocolo o tipo de herramienta	Comportamiento habitual
SDK compatible con OpenAI	Suele llamar a recursos como chat completions o responses dentro de `/v1`
SDK compatible con Anthropic	Suele añadir por sí mismo las rutas del endpoint de mensajes, por lo que no debes volver a añadir `/v1`
Proveedor integrado en la herramienta	Puede añadir rutas automáticamente o solicitar un Base URL completo

Usa https://bettertoken.ai para Claude Code y https://bettertoken.ai/v1 para Codex CLI y herramientas OpenAI-compatible. Elige la dirección según el protocolo del cliente.

Referencia rápida

Herramienta	Configuración recomendada
Claude Code	`https://bettertoken.ai`, con una BetterToken API Key
Claude Desktop Gateway	Sigue la página del Gateway, incluido el esquema de autenticación
Codex CLI	`https://bettertoken.ai/v1`, con una BetterToken API Key
Cursor	`https://bettertoken.ai/v1`, con una BetterToken API Key
Cline	`https://bettertoken.ai/v1`, con un proveedor OpenAI Compatible
OpenCode / OpenClaw	`https://bettertoken.ai/v1`, con una BetterToken API Key

Errores comunes

Error o síntoma	Causa posible
`404 Not Found`	La ruta del Base URL no coincide con la que espera el SDK
`model not found`	Comprueba el Model ID exacto en la model plaza e introdúcelo en los ajustes del modelo del cliente.
`invalid_api_key`	La API Key y el Base URL proceden de servicios distintos
La autenticación funciona, pero el modelo no está disponible	Comprueba el Model ID exacto en la model plaza e introdúcelo en los ajustes del modelo del cliente.
Las solicitudes siguen fallando	Se usó una dirección compatible con Anthropic en una herramienta compatible con OpenAI, o al contrario

Orden recomendado para resolver problemas

Confirma si la herramienta espera una API compatible con OpenAI o con Anthropic.
Comprueba si el Base URL corresponde a ese protocolo.
Comprueba si la API Key procede del mismo servicio.
Copia el Model ID exacto de la model plaza.
Envía una solicitud de prueba mínima, como hello.

Ejemplos de código

Las herramientas compatibles con OpenAI suelen usar la dirección /v1:

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://bettertoken.ai/v1"
)

response = client.chat.completions.create(
    model="your-model-id",
    messages=[{"role": "user", "content": "hello"}]
)

Las configuraciones compatibles con Claude o Anthropic suelen usar la dirección raíz:

import anthropic

client = anthropic.Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://bettertoken.ai"
)

message = client.messages.create(
    model="your-model-id",
    max_tokens=1024,
    messages=[{"role": "user", "content": "hello"}]
)

Acerca de BetterToken

BetterToken proporciona acceso compatible con Anthropic y OpenAI. Puedes gestionar API Keys, saldo y registros de uso en el mismo panel, pero cada cliente necesita la dirección del protocolo que admite.

Regla rápida: Claude Code usa https://bettertoken.ai; Codex CLI, Cursor, Cline, OpenCode y OpenClaw usan https://bettertoken.ai/v1.