Configurar Claude

6 min de lectura

Kujira admite dos formas de usar Claude: una suscripción de Claude Pro o Max, o una clave API de Anthropic. Cada una es un tipo de conexión, y puedes tener las que necesites: la suscripción del equipo, una clave para facturar aparte, la cuenta de un cliente.

Recomendado: conecta una suscripción

Para agentes que trabajan de forma habitual, una suscripción de Claude Pro o Max suele ofrecer una previsión de coste mucho mejor. La API se factura por token y el gasto puede crecer con rapidez, especialmente con modelos de mayor capacidad como Opus o Fable.

Antes de empezar

Entra en Ajustes > Modelos > Claude. Necesitas permisos para editar los modelos de la organización. Verás la lista de conexiones de Claude: cada fila es una cuenta, con su nombre, su tipo y si está encendida.

Abrir ajustes de Claude en Kujira

Tipo de conexión	Recomendación	Facturación
Suscripción	Opción preferente para trabajo continuo de agentes.	Incluida dentro de los límites de tu plan Claude Pro o Max.
Clave API	Úsala cuando necesites una cuenta de API específica o una facturación por consumo.	Por token; conviene revisar el uso y los límites con atención.

El nombre es lo que las distingue

El tipo se elige al crear la conexión y no se cambia después. Ponle a cada una un nombre que diga de qué cuenta se trata —«Suscripción del equipo», «Clave de facturación»—: es lo que verás al asignarla a un agente.

Conectar una suscripción de Claude

Esta opción utiliza una cuenta con un plan Claude Pro o Max. La autorización se hace en el navegador y el token llega solo.

Añade la conexión

En Ajustes > Modelos > Claude, pulsa Añadir conexión. Ponle nombre y elige el tipo Suscripción.

Pulsa «Conectar por navegador»

Kujira te lleva al inicio de sesión de Claude.

Autoriza la cuenta

Inicia sesión en Claude con la cuenta que tiene el plan Pro o Max y acepta la autorización.

Confirma el código

Copia el código que muestra Claude y pégalo de vuelta en Kujira para terminar la conexión.

Si más adelante Claude rechaza ese token, no hace falta rehacer la conexión: en su fila tienes Volver a conectar, que repite la autorización sobre esa conexión concreta y deja el resto intactas.

La conexión caduca al año

La autorización vale un año desde que la conectas, y no se renueva sola. La fila de la conexión dice cuándo caduca; cuando quedan menos de 30 días lo marca en ámbar, y si ya ha caducado lo dice en rojo.

Antes de esa fecha recibes un aviso —a 30 días y a 7— para que vuelvas a conectarla con calma. Reconectar la deja lista para otro año y no cambia nada más: los agentes que la usan siguen igual. Si se te pasa, el síntoma es que dejan de contestar y Kujira avisa de que la credencial ha caducado.

Al quitar o reconectar, el acceso anterior se anula

Cuando borras una conexión, le quitas el token o lo reemplazas al reconectar, Kujira anula esa autorización también en Anthropic. El valor anterior deja de servir aunque alguien conserve una copia.

Conectar mediante un token de Claude Code

Usa esta vía si prefieres autorizar la suscripción desde tu terminal o si la conexión desde el navegador no está disponible. Necesitas una cuenta de Claude Pro o Max: este token no es una clave API de Anthropic.

Instala Claude Code

Claude Code necesita Node.js 18 o posterior. Cuando lo tengas instalado, ejecuta:

npm install -g @anthropic-ai/claude-code
claude --version

No ejecutes la instalación con sudo. En Windows, utiliza WSL o Git Bash. Consulta la guía oficial de instalación de Claude Code si necesitas preparar el entorno.

Inicia sesión con tu suscripción

Ejecuta claude en la terminal. Cuando Claude Code te pregunte cómo autenticarte, elige la cuenta de Claude App y completa la sesión en el navegador con la cuenta que tiene el plan Pro o Max.

Genera el token de conexión

Una vez autenticado, ejecuta:

claude setup-token

Copia el token que devuelve el comando en ese momento. Trátalo como una contraseña: no lo compartas en un chat, ticket o documento.

Guárdalo en Kujira

Añade una conexión de tipo Suscripción, ponle nombre y pega el valor en Token de sesión, debajo del botón de conectar por navegador. Guarda.

Abrir ajustes de Claude en Kujira

Claude Code como harness interno

Kujira utiliza exclusivamente Claude Code como harness interno para las ejecuciones que usan una suscripción de Claude. No sustituye Claude Code por otro harness ni lo envuelve en una implementación alternativa; es la integración que empleamos para cumplir los requisitos de uso establecidos por Anthropic.

Añadir una clave API de Anthropic

La clave API se factura por uso a través de tu cuenta de Anthropic. Es la opción adecuada cuando quieres separar el consumo de Claude de una suscripción, pero requiere un control más estrecho del gasto, en especial si asignas modelos como Opus o Fable a tareas de alta frecuencia o conversaciones largas.

1. Abre Anthropic Console: API keys con la cuenta que paga la API.
2. En Settings > API keys, selecciona Create key.
3. Copia la clave en ese momento; Anthropic no vuelve a mostrar su valor completo.
4. En Kujira, pulsa Añadir conexión, ponle nombre, elige el tipo Clave API, pega la clave y guarda.

Guarda la clave solo una vez

Una clave API da acceso a la facturación de tu organización en Anthropic. Guárdala en Kujira y evita copiarla en chats, tickets o documentación.

Varias conexiones de Claude

Nada impide tener varias a la vez, y es lo habitual en cuanto hay más de un equipo o más de un cliente: la suscripción para el trabajo del día a día y una clave API para lo que deba facturarse aparte.

• Una de ellas es la predeterminada: la que utilizan los agentes que no eligen ninguna en concreto. La primera que añades queda marcada; para cambiarla, usa Hacer predeterminada en la fila que quieras. Tiene que estar encendida y tener credencial.
• Las demás siguen disponibles: cualquier agente puede fijar una por su nombre desde su ficha.
• Para retirar una conexión que ya usan agentes, Kujira te pide antes a cuál pasan. Está explicado en Modelos.

Activar un agente

En Configuración > Modelo del agente, elige primero en Conexión con cuál arranca: Heredar de la organización para usar la predeterminada de Claude, una conexión concreta por su nombre, o una propia del agente. Después selecciona un modelo de Claude. Si el agente está en marcha, cambiar la conexión lo reinicia solo; cambiar el modelo requiere reiniciarlo.

Consulta Modelos para entender la herencia de modelos y conexiones.