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

# 账号和密钥

> 登录每个引擎，添加 API 密钥，选择模型，并从其他工具导入你的设置。

## 登录引擎

打开“管理 → 智能体和模型”。每个引擎占一行，显示它是否已安装、是否已登录，以及使用哪个套餐。

* **安装**：安装缺少的引擎。
* **登录**：运行引擎自己的登录流程。Claude Code、Codex 和 Kimi Code 会打开浏览器；Antigravity 需要在终端中运行 `agy`。OpenCode 无需登录，直接使用它的免费模型。
* **使用**：让新对话默认使用这个引擎。未安装或未登录的行没有这个按钮。

每个引擎把登录信息保存在自己的文件中，Archetype 不会读取。**添加账号**可以为同一个引擎再保存一个账号（比如工作账号和个人账号），由你选择用哪个运行。

在没有浏览器的服务器上，把 `claude setup-token` 生成的令牌作为 `CLAUDE_CODE_OAUTH_TOKEN` 写入 env 文件，交给 Claude Code。

## API 密钥

Archetype 自己的模型使用你的 API 密钥运行，也可以使用 ChatGPT 账号：在 OpenAI 一行按**登录**，会显示一个代码，在浏览器中输入即可。

在提供商一行，**添加密钥**保存一个密钥；**添加其他密钥**再加一个，当某个密钥被拒绝或达到限额时依次尝试。密钥写在 `~/.config/archetype/env` 中，每行一个：

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

* 这个文件只能由你读取（`chmod 600`），否则后台服务拒绝启动。
* shell 中已经设置的变量优先于文件中的。
* 文件更改后 2 秒内，后台服务会重新读取。

Gemini 只能使用 API 密钥，不再提供用 Google 账号登录。

当智能体需要其他用途的密钥时，会用一张带隐藏输入框的卡片向你索取。密钥不会进入对话，保存在 `~/.local/share/archetype/secrets/` 中。

## 选择模型

> [tab] 应用
>
> 消息框下方的标签用于选择引擎及其模型，以及推理强度。见[引擎](https://docs.archetype.ing/zh/use/engines.md)。

> [tab] 终端
>
> ```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
> ```
>
> 启动时：`archetype --backend claude`、`--provider anthropic`、`--model NAME`。`archetype --list-models` 列出所有模型。

切换后对话会继续。默认的 `provider` 和 `model` 写在你的用户配置中；项目的配置不能设置它们。

**配置文件**保存一组一起应用的设置：引擎、模型、推理强度、权限模式和 Tokenmaxxing。在“管理 → 配置文件”中保存当前设置，然后在状态栏或用 `/profile NAME` 切换。

## 从其他工具导入你的设置

首次运行时会提供**导入你的设置**；之后可以在“管理 → 导入环境”中进行。Archetype 会找出这台电脑上已有的内容，由你选择要导入什么：

| 来源 | 导入的内容 |
| - | - |
| Claude Code、Codex、Hermes、Cline、OpenCode、Goose、Aider | 指令、技能和 MCP 服务器 |

* 指令按原文追加到你的 `AGENTS.md` 末尾，放在各工具的名称下；不做任何总结。
* MCP 服务器需要的密钥写入 env 文件，而不是配置。
* 不导入：模型和提供商、API 密钥、登录信息、权限、钩子和历史记录。请在 Archetype 中重新登录。
* 查找期间不运行任何内容。导入的 MCP 服务器在你按**立即应用**后启动。

要在这个文件夹中继续一个 Claude Code 对话，在对话中输入 `/import`：它会从一份副本在新会话中继续。


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