Configuración avanzada

Buenas prácticas

Aplica buenas prácticas de BetterToken para proteger tu API Key, elegir modelos, controlar costes, gestionar errores y configurar herramientas externas.

Protege tu API Key

Usa variables de entorno; nunca fijes la Key en el código. Escribir la API Key directamente en el código fuente o en archivos de configuración puede exponerla por accidente en el control de versiones. Método recomendado:

# Add to ~/.zshrc or ~/.bashrc so it loads automatically each session
export BETTERTOKEN_API_KEY="your-api-key-here"

En Claude Code, gestiona los secretos mediante el campo env de settings.json en lugar de exponerlos en la configuración del shell:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-api-key-here"
  }
}

Rota tu API Key periódicamente. Si sospechas que se ha filtrado, elimina la Key inmediatamente desde el panel y genera otra.

Configura un tiempo de espera amplio

Las respuestas de los modelos de IA pueden tardar, especialmente en tareas de razonamiento complejas. Configura un tiempo de espera suficiente para evitar desconexiones prematuras:

{
  "env": {
    "API_TIMEOUT_MS": "3000000"
  }
}

3000000 ms = 50 minutos. Este valor es adecuado para razonamientos profundos o tareas prolongadas con agentes.

Elimina las variables de entorno que provoquen conflictos

Si antes usaste las API oficiales de Anthropic u OpenAI, u otro servicio de relay, las variables de entorno antiguas pueden sustituir la configuración de BetterToken y enviar las solicitudes al endpoint equivocado sin avisar.

Antes de configurar BetterToken, comprueba y elimina estas variables:

# Check if they exist
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL
echo $OPENAI_API_KEY
echo $OPENAI_BASE_URL

# Clear them
unset ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_BASE_URL
unset OPENAI_API_KEY
unset OPENAI_BASE_URL

Claude Code: comprueba primero el proveedor

Sustituye YOUR_MODEL_ID por el ID copiado. ANTHROPIC_MODEL define el modelo principal y las tres variables ANTHROPIC_DEFAULT_*_MODEL definen los alias Haiku, Sonnet y Opus. Puedes usar el mismo modelo o uno distinto para cada función.

No mezcles ambas configuraciones; las solicitudes podrían dirigirse al modelo equivocado.

Desactiva el tráfico no esencial. Definir CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 reduce las solicitudes en segundo plano de Claude Code y reserva la cuota de la API para las tareas reales de programación.

No añadas /v1 en Claude Code. ANTHROPIC_BASE_URL debe ser https://bettertoken.ai.

Usa una API Key en varias herramientas

La misma API Key funciona en Claude Code, Codex y las herramientas externas. La cuota se comparte, lo que simplifica la gestión centralizada.

Sin embargo, el endpoint debe coincidir con el protocolo:

Claude Code / ANTHROPIC_BASE_URL: https://bettertoken.ai
Codex / OPENAI_BASE_URL / herramientas externas: https://bettertoken.ai/v1

Si necesitas registrar el uso por separado para cada proyecto o equipo, crea varias API Keys en el panel y asigna una a cada herramienta o proyecto.

Copia el Model ID exacto de la model plaza.

Lista de solución de problemas

Confirma que la API Key sea correcta: compruébala en el panel y pégala con cuidado, sin espacios adicionales
Confirma el endpoint del protocolo: Claude Code usa https://bettertoken.ai; Codex y las herramientas externas usan https://bettertoken.ai/v1
Busca variables de entorno en conflicto: ejecuta echo $ANTHROPIC_AUTH_TOKEN, echo $OPENAI_BASE_URL y los comandos relacionados
Comprueba los requisitos oficiales de la herramienta: en herramientas externas, verifica primero Base URL, la API Key, el ID del modelo y la versión; añade cabeceras adicionales solo si lo exigen explícitamente la documentación oficial o el gateway original
Comprueba el saldo: las solicitudes se rechazan cuando se agota
Contacta con soporte: si los pasos anteriores no resuelven el problema