从第一个账号开始。
准备你的平台账号或 API Key。添加到本机网关后，创建独立的工具密钥，再连接到你熟悉的 AI 工具。
版本与获取
当前版本要求 macOS 26.5 或更高，已有 Intel Mac 与 M1 Mac mini 的构建及运行验证记录。官网尚未开放正式安装包下载。
M1 验证不代表所有 Apple Silicon 设备均已覆盖。Developer ID 正式发行签名、Apple 公证与干净 Mac 安装验证仍待完成，正式发行包将在完成这些检查后提供。
本页面介绍应用的当前行为。官网界面预览使用示意数据，不会连接或读取真实账号。
01 · 启动本机网关
打开应用后，首次启动会初始化私有数据库与运行组件。按应用提示完成管理员确认，待服务准备就绪后再添加账号。
运行所需的网关、数据库和缓存已集成在应用内，无需自行安装 Docker、Go、Homebrew、PostgreSQL 或 Redis。
02 · 添加平台账号
进入「账号 → 添加账号」，选择平台及产品。按界面提供的入口完成官方浏览器授权、设备授权或 API Key 接入。密码与二次验证在平台官方页面完成。
| 平台 | 接入提示 |
|---|---|
| OpenAI | ChatGPT 官方登录，或对应产品的 API Key。 |
| Anthropic、Gemini、Grok | 按应用提供的产品与认证入口选择，API Key 与授权入口因平台而异。 |
| Antigravity | 当前账号添加入口提供 OAuth 授权。 |
| Kimi、MiniMax | API 产品使用 API Key；支持的 Coding 产品使用设备授权。 |
| GLM、DeepSeek、OpenCode、Jev | 当前目录提供 API Key 接入；产品与区域以应用实际选项为准。 |
账号加入目录不代表授权、刷新或模型调用必然成功。请确认所选产品、区域、账号额度和供应商限制，并在应用中验证。Gemini 个人 Code Assist 的旧登录路径已退役，不应将其与 Gemini API Key 接入视为同一种服务。
03 · 创建工具访问密钥
进入「访问密钥 → 创建密钥」，选择当前有效的账号分组。工具访问密钥属于本机网关，不是供应商的 API Key。
在工具配置中使用完整的网关访问密钥。列表只显示脱敏值；分组可用也不代表其中账号一定可调度，需要继续检查该密钥实际可用的模型。
04 · 连接你的工具
默认接口地址示例为 http://127.0.0.1:8080/v1。8080 被占用时会自动选择空闲端口，配置时始终以应用显示的实际地址为准。
- OpenCode：先安装工具，再在应用的「访问密钥 → 快速配置」中选择 OpenCode 版本、模型和配置路径。应用会备份原配置后写入，并可能重启工具。
- Claude Code：先安装 CCSwitch，通过快速配置添加 Claude Code 服务商。此方式需要网关支持
/v1/messages转换；地址格式以生成的配置为准。 - 手动配置：使用应用显示的接口地址、完整网关密钥和可用模型 ID。不同工具或协议可能要求不同的地址路径。
官网示例中的密钥和模型均为占位符，需要替换。优先使用应用生成的配置，避免复制不适合当前工具版本的示例。
查看三种接入示例05 · 验证首个请求
进入「请求验证」，检查所选访问密钥的模型列表，再发起实际请求。只有真实接口结果才能确认当前账号、密钥、模型与调用协议是否可用。
验证成功后，再到日常工具里发起请求。应用内可用而工具失败时，优先核对工具使用的实际端口、密钥、模型 ID 和接口路径。
数据与运行
- 账号和网关数据保存在
~/Library/Application Support/Lantrilo/，运行凭据由 macOS 登录钥匙串管理。 - 网关、数据库与缓存仅在本机监听，局域网访问默认关闭。
- 模型请求会连接相应上游供应商，适用其账号、套餐、余额与调用规则。网关数据库仍保存用量与运维数据。
- 关闭窗口后服务继续运行；从菜单退出应用会有序停止运行组件。
- 局域网共享、备份恢复、登录启动与更新能力请以所用版本的设置及发行说明为准，本指南不承诺未验证的能力。
常见问题排查
- 找不到可选分组：确认已添加账号，并在应用中刷新账号与分组列表。只有有效且启用的分组可用于创建密钥。
- 模型列表为空：核对完整密钥和绑定分组，确认上游账号认证、产品与额度状态，然后重新检查模型。
- 连接被拒绝：确认网关已运行，工具中的端口与应用显示的实际地址一致。默认 8080 不一定是当前端口。
- 官方登录未返回：查看应用提示与官方页面授权状态。回调端口被占用、取消授权或超时都会使流程无法完成。
- 钥匙串要求授权：按 macOS 提示处理；不要删除运行凭据来绕过授权，以免使现有数据无法正常访问。
内容核对：。日期由官网发布信息统一维护，不随浏览日期自动变化；具体功能与发行状态以当前应用及版本说明为准。