Integraciones

Claude Code

Usa Claude Code con Half Off Dev a mitad del precio oficial de Claude: dos variables de entorno o settings.json, elección de modelos y caché de prompts.

Claude Code toma el endpoint y las credenciales de variables de entorno, y habla la API Messages de Anthropic, que Half Off Dev sirve tal cual, sin traducirla. Apunta esas variables a Half Off Dev y el asistente de programación de tu terminal sigue funcionando igual, pero cobrado al 50 % de la tarifa oficial de Anthropic. Antes de empezar, crea una clave de API.

Configúralo#

Para probar rápido, exporta tres variables y lanza claude en la misma shell:

Shell

export ANTHROPIC_BASE_URL=https://halfoff.dev
export ANTHROPIC_AUTH_TOKEN=$HALFOFF_API_KEY
export ANTHROPIC_MODEL=claude-sonnet-5.5
claude

Para dejarlo fijo, pon los valores en ~/.claude/settings.json con tu clave completa:

~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://halfoff.dev",
    "ANTHROPIC_AUTH_TOKEN": "ho-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5.5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5"
  }
}

No añadas /v1 a la URL base: Claude Code ya lo pone.

O impórtalo desde el panel#

En API keys, elige Usar en herramientas → Claude Code. Verás la configuración anterior con tu clave puesta, y Importar con CC Switch crea un proveedor Half Off Dev en la app de escritorio CC Switch con los modelos ya definidos (CC Switch tiene que estar instalado). Una clave recién creada aparece sola; para una anterior, pega la clave completa, porque Half Off Dev solo guarda su hash.

Modelos#

Claude Code tiene dos huecos. ANTHROPIC_MODEL es el modelo con el que trabajas; ANTHROPIC_DEFAULT_HAIKU_MODEL se encarga de tareas pequeñas en segundo plano, así que conviene uno rápido y barato. Vale cualquier id de Claude de GET /v1/models, por ejemplo claude-opus-5.5. Todos los ids están en la lista de modelos.

Caché de prompts#

Claude Code depende mucho de la caché de prompts, y aquí sigue funcionando. Half Off Dev fija cada sesión al canal que guarda su caché, de modo que el contexto grande y repetido de una sesión de programación se cobra a precio de entrada en caché turno tras turno. Detalles en Caché de prompts.

Solución de errores#

Lo que ves	Qué hacer
`401` `Missing API key`	No llega ninguna clave a Half Off Dev. Exporta `ANTHROPIC_AUTH_TOKEN` en la shell que ejecuta `claude` o ponla en `~/.claude/settings.json`.
`401` `Invalid or revoked API key`	La clave está mal escrita, cortada o revocada. Pégala de nuevo o crea otra.
`404` `Model '...' is not available`	Ese id no existe. Copia un id de Claude de `GET /v1/models` o de la lista de modelos.
`404` con `/v1/v1/` en la ruta	`ANTHROPIC_BASE_URL` termina en `/v1`. Cámbiala a `https://halfoff.dev`.
`402`	El saldo está a cero o la clave alcanzó su tope de gasto. Mira Saldo y facturación.

Cualquier otro código se explica en Errores.

← Anterior

Úsalo con tus herramientas

Primeros pasos

Codex CLI

Integraciones