Claves de API y proyectos

Cada solicitud se hace con una clave de API, y cada clave pertenece a un proyecto. Los proyectos te permiten mantener separado el uso de distintas apps, equipos o entornos dentro de una misma organización: cada uno tiene sus propias claves, logs y analíticas, y todos consumen el saldo único de la organización.

Crear una clave

1. Abre Claves de API.
2. Escribe un nombre que indique dónde se usa la clave: "Backend de producción", "Staging", "Claude Code en mi laptop".
3. Elige el proyecto al que se contabilizarán sus solicitudes.
4. Haz clic en Crear clave y copia el secreto.

El secreto completo se muestra una sola vez, justo después de crearlo. Guárdalo en ese momento en un gestor de secretos o en una variable de entorno; no se puede volver a mostrar. La guía de integración tiene ejemplos listos para copiar y pegar con tu nueva clave.

Cada tarjeta de clave muestra su proyecto, cuándo se creó y cuándo se usó por última vez, lo que facilita detectar claves en desuso.

Rotar una clave

Rotar una clave reemplaza su secreto y conserva su nombre, proyecto e historial de uso. El secreto anterior deja de funcionar de inmediato, así que actualiza enseguida todo lo que lo use. Solo la persona que creó una clave puede rotarla.

Rota una clave siempre que pueda haberse filtrado: pegada en un chat, subida a un repositorio, olvidada en un log.

Eliminar una clave

Al eliminar una clave, todos los clientes que la usan dejan de autenticarse de inmediato. Su historial de uso permanece en tus analíticas, marcado como clave eliminada.

Cada persona gestiona las claves que crea. Los propietarios y administradores pueden ver y eliminar las claves de todos en la organización.

Cuando se quita a alguien de una organización, todas las claves que creó en ella se eliminan con esa persona.

Proyectos

Cada organización empieza con un proyecto llamado default. Agrega más en la configuración de proyectos y cambia entre ellos con el selector de proyectos de la barra lateral de la consola; las páginas de claves, logs y analíticas muestran el proyecto seleccionado.

• Puedes renombrar un proyecto en cualquier momento; sus claves siguen funcionando.
• Los propietarios y administradores pueden eliminar un proyecto. Una organización siempre conserva al menos uno.
• Una buena división es un proyecto por producto y entorno: web-production, web-staging, internal-tools.

Claves de Token Plan

Un Token Plan tiene su propio espacio de trabajo con una asignación compartida. Ahí puedes crear tantas claves con nombre como quieras (una por app o agente es un buen hábito) y todas consumen el crédito mensual del plan. El espacio de trabajo de un plan no tiene selector de proyectos.

Buenas prácticas

• Una clave por app, entorno y persona. Así, una filtración implica rotar una sola clave, no todas.
• Mantén las claves en servidores. Nunca incluyas una clave en un bundle de navegador ni en una app móvil.
• Elimina las claves que no se hayan usado en meses.