跳转到主要内容

登录引擎

打开“管理 → 智能体和模型”。每个引擎占一行,显示它是否已安装、是否已登录,以及使用哪个套餐。
  • 安装:安装缺少的引擎。
  • 登录:运行引擎自己的登录流程。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 中,每行一个:
  • 这个文件只能由你读取(chmod 600),否则后台服务拒绝启动。
  • shell 中已经设置的变量优先于文件中的。
  • 文件更改后 2 秒内,后台服务会重新读取。
Gemini 只能使用 API 密钥,不再提供用 Google 账号登录。 当智能体需要其他用途的密钥时,会用一张带隐藏输入框的卡片向你索取。密钥不会进入对话,保存在 ~/.local/share/archetype/secrets/ 中。

选择模型

消息框下方的标签用于选择引擎及其模型,以及推理强度。见引擎。
切换后对话会继续。默认的 provider 和 model 写在你的用户配置中;项目的配置不能设置它们。 配置文件保存一组一起应用的设置:引擎、模型、推理强度、权限模式和 Tokenmaxxing。在“管理 → 配置文件”中保存当前设置,然后在状态栏或用 /profile NAME 切换。

从其他工具导入你的设置

首次运行时会提供导入你的设置;之后可以在“管理 → 导入环境”中进行。Archetype 会找出这台电脑上已有的内容,由你选择要导入什么:
  • 指令按原文追加到你的 AGENTS.md 末尾,放在各工具的名称下;不做任何总结。
  • MCP 服务器需要的密钥写入 env 文件,而不是配置。
  • 不导入:模型和提供商、API 密钥、登录信息、权限、钩子和历史记录。请在 Archetype 中重新登录。
  • 查找期间不运行任何内容。导入的 MCP 服务器在你按立即应用后启动。
要在这个文件夹中继续一个 Claude Code 对话,在对话中输入 /import:它会从一份副本在新会话中继续。