Conectar tu clave API de Anthropic (Claude)
Olvio responde a tus compradores con los modelos Claude de Anthropic, usando tu propia clave API de Anthropic. Anthropic factura directamente a tu cuenta de Anthropic las solicitudes que Olvio hace con la clave, por separado de tu plan de Olvio.
La página Clave API aparece en el menú de la app una vez que has elegido un plan. Si la guía de configuración sigue visible en el Panel (haz clic en Olvio en el menú de la app), su paso Añade tu clave API de Anthropic enlaza a la página con Añadir clave. Cuando hay una clave guardada, el paso se marca como completado y su botón cambia a Gestionar clave.
Crear una clave en la Claude Console
Ve a la Claude Console e inicia sesión, o crea una cuenta de Anthropic. La dirección console.anthropic.com que aparece en Olvio abre la misma consola.
Abre Settings → API keys y haz clic en Create key. Si Create key está desactivado, pide a un administrador de la organización que cambie tu rol o que cree una clave de cuenta de servicio para Olvio.
Ponle a la clave un nombre que reconozcas, como Olvio, y elige una caducidad. La caducidad no se puede cambiar después de crear la clave, y Olvio no puede responder a los compradores una vez que la clave caduca, así que elige una duración larga, o Never si tu organización lo permite.
Configura Linked account. Una clave personal, vinculada a ti, deja de funcionar si pierdes el acceso a tu organización de Anthropic o al workspace de la clave, por ejemplo cuando dejas la empresa. Anthropic recomienda una cuenta de servicio para servicios en producción como Olvio, y una clave de cuenta de servicio sigue funcionando cuando una persona se va. Las cuentas de servicio las crea un administrador de la organización en la Claude Console. Una clave de cuenta de servicio deja de funcionar si la cuenta de servicio se archiva o se retira del workspace de la clave.
Limita la clave a un único workspace al crearla, aunque tu organización solo tenga uno. Las solicitudes de Olvio no indican ningún workspace, por lo que Anthropic rechaza todas las solicitudes hechas con una clave que no esté limitada a uno.
Copia la clave y guárdala en un lugar seguro. Empieza por
sk-ant-. La Claude Console solo la muestra una vez, al crearla. Si la pierdes, crea una clave nueva.
Si le pones una fecha de caducidad a la clave, reemplázala en Olvio antes de esa fecha. Anthropic rechaza las claves caducadas, y Olvio no puede responder a los compradores hasta que conectes una nueva. Anthropic envía un correo electrónico a quien creó la clave antes de que caduque, salvo que la clave se haya creado con una duración inferior a 7 días.
Salvo que Anthropic facture a tu organización mensualmente, el uso de la API de Claude se paga con créditos de prepago. Antes de guardar la clave en Olvio, asegúrate de que tu organización tiene créditos. Si no los tiene, inicia sesión en la Claude Console con un rol Admin o Billing, abre Settings → Billing y haz clic en Buy credits. Sin créditos, Anthropic rechaza la solicitud de prueba de Olvio y la clave no se puede guardar. Para que tu saldo no se agote, haz clic en Edit en la sección Auto-reload y activa la opción.
Conectar la clave en Olvio
En el admin de Olvio, abre Clave API.
En la sección Configuración de Anthropic, pega la clave en el campo Clave API.
Revisa el Modelo Claude. Las tiendas nuevas empiezan con Claude Haiku 4.5 — el más rápido, menor coste (recomendado).
Haz clic en Guardar en la barra de guardado.
Antes de guardar, Olvio elimina espacios, saltos de línea, caracteres invisibles y comillas tipográficas, y convierte las rayas largas en guiones. Estos caracteres pueden colarse al copiar una clave desde un documento con formato. Después comprueba la clave enviando a Anthropic una solicitud de prueba muy pequeña con el modelo seleccionado, que Anthropic factura como cualquier otra solicitud.
Si la comprobación es correcta, Olvio cifra y guarda la clave. Verás Configuración guardada, el campo se vacía y la insignia Estado pasa de No configurada a Conectada. Conectada solo significa que hay una clave guardada. La página no vuelve a comprobar la clave con Anthropic, así que la insignia sigue mostrando Conectada aunque la clave caduque más adelante, se agote tu saldo de créditos o se alcance tu límite de gasto de Anthropic. Descartar borra lo que has escrito y restablece el modelo a su valor guardado.
Si el guardado falla
Cuando una comprobación falla, no se guarda nada y Olvio muestra brevemente un mensaje de error en la parte inferior de la página. Si desaparece antes de que puedas leerlo, vuelve a hacer clic en Guardar en la barra de guardado. Estos son algunos de los mensajes que puedes ver:
Invalid Anthropic key… Anthropic no aceptó la clave, por ejemplo porque está mal escrita, incompleta, desactivada o caducada. Vuelve a pegarla desde donde la guardaste, o crea una clave nueva en la Claude Console.
The key doesn't look like an Anthropic API key… Lo que pegaste no empieza por
sk-ant-, es demasiado corto o contiene caracteres inesperados. Vuelve a pegar la clave como texto sin formato, sin pasarla por Word, Notion ni un correo electrónico con formato.Anthropic rejected this model… El modelo no siempre es la causa. Cuando el mensaje da un motivo después de los dos puntos, léelo: si se trata de un límite de gasto, de tu saldo de créditos o de una clave que no está limitada a un único workspace, corrígelo en la Claude Console. En ese caso, cambiar de modelo no servirá de nada.
Para los demás mensajes y las soluciones paso a paso, consulta Error "Invalid Anthropic key" al guardar.
Elegir tu modelo de Claude
El menú Modelo Claude ofrece tres modelos: Claude Haiku 4.5 — el más rápido, menor coste (recomendado), Claude Sonnet 5 — equilibrio entre calidad y coste y Claude Opus 5 — mejor calidad, mayor coste. Como indica la página, el modelo seleccionado se utiliza para cada conversación, sugerencia y turno del advisor. Anthropic factura cada solicitud según la tarifa del modelo utilizado; consulta los precios de Anthropic.
Para cambiar, selecciona otro modelo y haz clic en Guardar. Olvio comprueba primero tu clave guardada con el nuevo modelo, así que no necesitas volver a pegar la clave. Si aún no hay ninguna clave guardada, pega una antes de guardar. Para elegir un modelo y ver para qué se usa, consulta Elegir tu modelo Claude.
Fijar un límite de gasto
Anthropic te permite limitar tu gasto mensual en la API, lo que te protege si una temporada de mucha actividad trae más conversaciones de lo previsto.
En la Claude Console, ve a Settings → Billing.
En la sección Spend limits, haz clic en Set limit, o en Adjust limit si ya tienes uno.
Introduce el importe máximo que quieres gastar.
Cuando tu uso alcanza el límite, Anthropic rechaza las nuevas solicitudes hasta la fecha que indique, o hasta que subas o quites el límite. Durante ese tiempo, Olvio no puede responder a los compradores, así que deja algo de margen. Olvio también deja de responder si tu saldo de créditos se agota antes de alcanzar el límite. Puedes seguir tu uso en la página Usage de la Claude Console, y Qué usa tu clave API de Anthropic y qué no enumera para qué usa Olvio la clave.
Reemplazar tu clave
Reemplaza la clave cuando crees una nueva, por ejemplo tras rotarla o al pasar a otra cuenta de Anthropic.
Abre Clave API. El campo Clave API muestra puntos en lugar de tu clave guardada, con la indicación Déjalo vacío para conservar la clave actual. Introduce una clave nueva para reemplazarla.
Pega la nueva clave en el campo.
Haz clic en Guardar.
Olvio comprueba la nueva clave con Anthropic antes de guardarla. Si la comprobación es correcta, la nueva clave reemplaza a la anterior y tu tienda online la usa en aproximadamente un minuto. Si falla, tu clave actual se mantiene. Cuando la nueva clave funcione, puedes desactivar o eliminar la anterior en la Claude Console.
Eliminar tu clave
Haz clic en Eliminar clave en la página Clave API. El botón solo aparece cuando hay una clave guardada, y no hay paso de confirmación: la clave se elimina de inmediato, ves Clave eliminada y el estado vuelve a No configurada. Tu elección de modelo se conserva para cuando vuelvas a conectar una clave.
Sin clave, Olvio no puede responder a los compradores. El cambio se aplica en tu tienda online en aproximadamente un minuto. El widget sigue apareciendo en tus páginas de producto, pero sin preguntas sugeridas, y cada mensaje recibe la respuesta Lo sentimos, ha ocurrido un error. Inténtalo de nuevo. (o su traducción en una tienda online en otro idioma). En los planes Growth y Scale, Olvio Advisor tampoco puede responder.
Eliminar la clave en Olvio no la cancela en Anthropic. Si ya no la necesitas, desactívala o elimínala en la Claude Console.
Cómo se almacena tu clave
Olvio cifra tu clave con AES-GCM (256 bits) antes de almacenarla, vinculada al dominio de tu tienda para que la clave cifrada no pueda usarse en otra tienda. La clave no vuelve a mostrarse nunca: el campo Clave API muestra puntos en su lugar. Cuando desinstalas Olvio, la clave se elimina junto con el resto de los datos de tu tienda unas 48 horas después. Para más información, consulta Cómo se cifra tu clave API de Anthropic.