Saltar al contenido principal

Iniciar sesión en un motor

Abre Gestionar → Agentes y modelos. Cada motor tiene una fila que indica si está instalado, si has iniciado sesión y con qué plan.
  • Instalar instala un motor que falta.
  • Iniciar sesión ejecuta el inicio de sesión propio del motor. Para Claude Code, Codex y Kimi Code abre un navegador; para Antigravity, ejecuta agy en una terminal. OpenCode empieza con sus modelos gratuitos sin iniciar sesión.
  • Usar lo convierte en el motor con el que empiezan las conversaciones nuevas. Una fila que no está instalada o sin sesión iniciada no lo tiene.
Cada motor guarda su inicio de sesión en sus propios archivos; Archetype no los lee. Añadir cuenta guarda otra cuenta del mismo motor (una de trabajo y otra personal, por ejemplo), y tú eliges cuál se ejecuta. En un servidor sin navegador, dale a Claude Code un token de claude setup-token como CLAUDE_CODE_OAUTH_TOKEN en el archivo env.

Claves de API

Los modelos propios de Archetype funcionan con tus claves de API o con una cuenta de ChatGPT: Iniciar sesión en la fila de OpenAI muestra un código que introduces en el navegador. En la fila de un proveedor, Añadir clave guarda una clave; Añadir otra clave añade una más, que se prueba por turnos cuando una se rechaza o llega a su límite. Las claves van en ~/.config/archetype/env, una por línea:
  • Solo tú puedes leer el archivo (chmod 600); si no, el servicio en segundo plano se niega a arrancar.
  • Una variable ya definida en tu shell tiene prioridad sobre el archivo.
  • El servicio en segundo plano vuelve a leer el archivo en menos de 2 segundos tras un cambio.
Gemini solo funciona con una clave de API; ya no se ofrece iniciar sesión con una cuenta de Google. Cuando el agente necesita una clave para otra cosa, te la pide en una tarjeta con un campo oculto. La clave nunca entra en la conversación; se guarda en ~/.local/share/archetype/secrets/.

Elegir el modelo

La etiqueta bajo el cuadro de mensaje elige el motor y su modelo, y el esfuerzo de razonamiento. Consulta Motores.
La conversación continúa después de un cambio. Un provider y un model por defecto van en tu configuración de usuario; la configuración de un proyecto no puede fijarlos. Los Perfiles guardan ajustes que se aplican juntos: motor, modelo, esfuerzo, modo de permisos y Tokenmaxxing. Guarda los actuales en Gestionar → Perfiles y cambia de uno a otro desde la barra de estado o con /profile NAME.

Traer tu configuración de otras herramientas

El primer inicio ofrece Traer tu configuración; más adelante está en Gestionar → Importar entorno. Archetype encuentra lo que hay en este ordenador y tú eliges qué traer:
  • Las instrucciones se añaden al final de tu AGENTS.md bajo el nombre de cada herramienta, tal como están escritas; no se resume nada.
  • La clave que necesita un servidor MCP va al archivo env, no a la configuración.
  • No se trae: modelos y proveedores, claves de API, inicios de sesión, permisos, hooks ni historial. Vuelve a iniciar sesión en Archetype.
  • No se ejecuta nada mientras busca. Los servidores MCP importados arrancan cuando pulsas Aplicar ahora.
Para seguir con una conversación de Claude Code de esta carpeta, escribe /import en una conversación: continúa en una sesión nueva a partir de una copia.