连接模型服务
所有模型都来自「设置 → 模型服务」。可以选预设,也可以填自定义 OpenAI 兼容地址;每个服务有独立的 API Key、模型列表和推理开关。
添加一个服务
Section titled “添加一个服务”-
打开模型服务
Section titled “打开模型服务”按 Ctrl+,(macOS ⌘+,)打开设置,点左侧「模型服务」。
-
点「添加服务」并选来源
Section titled “点「添加服务」并选来源”下拉里是预设服务;最后一项是「从本机导入…」。预设会带好名称、协议和官方地址。
-
填写连接信息
Section titled “填写连接信息”名称、API 协议、Base URL、API Key。官方地址可以留空;自定义地址必须以
http://或https://开头。 -
点「拉取模型列表」从服务端选择,或在下方手动输入模型 id 后点「添加」。每个模型旁的「推理」开关决定会话里能否选思考档位;内置目录能判定的模型会显示只读标记。
-
检查底部的「启用」开关,保存。卡片上的开关也可以随时停用或恢复,停用不会丢 Key。
测试、编辑与删除
Section titled “测试、编辑与删除”卡片上的「测试连接」会显示耗时,以及服务端返回了多少个模型;没有 API Key 时按钮禁用。编辑会打开同一个表单,已保存的 Key 只显示末 4 位,留空表示不修改;也可以点「清除 key」。
删除前会提示「引用它的角色需重选模型」。确认删除后,角色里仍指向这个服务的模型会显示不可用,需要到「设置 → 角色」重新选模型。
「从本机导入…」会读取 Claude Code、Codex、CC Switch 里已有的服务。没有 API Key 或自定义地址的配置不会出现。选择来源后逐个确认要导入的服务;每个服务还可以选择要加入的模型。