登录引擎
打开“管理 → 智能体和模型”。每个引擎占一行,显示它是否已安装、是否已登录,以及使用哪个套餐。- 安装:安装缺少的引擎。
- 登录:运行引擎自己的登录流程。Claude Code、Codex 和 Kimi Code 会打开浏览器;Antigravity 需要在终端中运行
agy。OpenCode 无需登录,直接使用它的免费模型。 - 使用:让新对话默认使用这个引擎。未安装或未登录的行没有这个按钮。
claude setup-token 生成的令牌作为 CLAUDE_CODE_OAUTH_TOKEN 写入 env 文件,交给 Claude Code。
API 密钥
Archetype 自己的模型使用你的 API 密钥运行,也可以使用 ChatGPT 账号:在 OpenAI 一行按登录,会显示一个代码,在浏览器中输入即可。 在提供商一行,添加密钥保存一个密钥;添加其他密钥再加一个,当某个密钥被拒绝或达到限额时依次尝试。密钥写在~/.config/archetype/env 中,每行一个:
- 这个文件只能由你读取(
chmod 600),否则后台服务拒绝启动。 - shell 中已经设置的变量优先于文件中的。
- 文件更改后 2 秒内,后台服务会重新读取。
~/.local/share/archetype/secrets/ 中。
选择模型
- 应用
- 终端
消息框下方的标签用于选择引擎及其模型,以及推理强度。见引擎。
provider 和 model 写在你的用户配置中;项目的配置不能设置它们。
配置文件保存一组一起应用的设置:引擎、模型、推理强度、权限模式和 Tokenmaxxing。在“管理 → 配置文件”中保存当前设置,然后在状态栏或用 /profile NAME 切换。
从其他工具导入你的设置
首次运行时会提供导入你的设置;之后可以在“管理 → 导入环境”中进行。Archetype 会找出这台电脑上已有的内容,由你选择要导入什么:- 指令按原文追加到你的
AGENTS.md末尾,放在各工具的名称下;不做任何总结。 - MCP 服务器需要的密钥写入 env 文件,而不是配置。
- 不导入:模型和提供商、API 密钥、登录信息、权限、钩子和历史记录。请在 Archetype 中重新登录。
- 查找期间不运行任何内容。导入的 MCP 服务器在你按立即应用后启动。
/import:它会从一份副本在新会话中继续。