> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archetype.ing/llms.txt
> Use this file to discover all available pages before exploring further.

# Cuentas y claves

> Inicia sesión en cada motor, añade claves de API, elige el modelo y trae tu configuración de otras herramientas.

## 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:

```bash theme={null}
ANTHROPIC_API_KEY=…
OPENAI_API_KEY=…
GEMINI_API_KEY=…        # or GOOGLE_API_KEY, from Google AI Studio
OPENROUTER_API_KEY=…
```

* 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

> [tab] App
>
> La etiqueta bajo el cuadro de mensaje elige el motor y su modelo, y el esfuerzo de razonamiento. Consulta [Motores](https://docs.archetype.ing/es/use/engines.md).

> [tab] Terminal
>
> ```bash theme={null}
> /backend                     # choose what runs the conversation
> /backend engine:claude       # an engine, or a provider of Archetype's own models
> /model                       # choose a model with a key
> /model NAME
> ```
>
> Al empezar: `archetype --backend claude`, `--provider anthropic`, `--model NAME`. `archetype --list-models` muestra los modelos.

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:

| De | Qué viene |
| - | - |
| Claude Code, Codex, Hermes, Cline, OpenCode, Goose, Aider | Instrucciones, habilidades y servidores MCP |

* 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.