接上一个模型

Marlin 的 AI 功能（润色、翻译、续写、画图、摘要……）要用一个大模型来做。Marlin 自己不带模型，也不替你付费：你接上一个自己的，可以是 DeepSeek、通义千问这类云端服务，也可以是装在自己电脑上的 Ollama、LM Studio，或者已经在用的 Claude Code。

没接模型时，AI 功能用不了，Marlin 也不会发送任何内容。

添加模型

在哪里：设置（Ctrl+,）→「AI」→「＋ 添加模型」

1. 已经添加的模型：名称、模型名和接口地址；右边是密钥（只显示开头和最后几位）
2. 「测试」发一句很短的话，看能不能连上；「编辑」「删除」
3. 添加模型
4. 默认用哪个模型
5. 只用本地模型：打开后，不在这台电脑上的模型都不能用，文档内容不会离开本机

添加时先选「类型」，接口地址和常用的模型名会自动填好，一般只要贴上密钥：

填好点「保存」，再点这个模型的「测试」，显示「连接正常（用时 0.8 秒）」就可以用了。

去哪里拿密钥

密钥要到服务商的网站上注册、充值（多数有免费额度）后创建：

其他兼容 OpenAI 接口的服务（比如公司内部部署的），选「自定义」，按对方给的接口地址、模型名、密钥填。

注意 密钥存在 Windows 凭据管理器里，不写进 Marlin 的设置文件，设置页上也看不到完整的密钥。便携版也一样，所以换一台电脑要重新填。

用自己电脑上的模型

不想让文档离开电脑，可以在本机跑一个模型：

• Ollama：到 ollama.com 下载安装，在命令行里运行 ollama pull qwen2.5 下载一个模型。Marlin 里类型选「Ollama（本机）」，模型名填 qwen2.5
• LM Studio：在 LM Studio 里下载并加载一个模型，打开它的本地服务（Local Server）。Marlin 里类型选「LM Studio（本机）」，模型名填 LM Studio 里显示的名字

本机模型不需要密钥，第一次使用时也不会提示「要发送到哪里」。速度和效果取决于电脑的配置。

用本机的 Claude Code

已经在用 Claude Code（Anthropic 的命令行助手）并登录了订阅，可以直接把它当模型用，不用另外申请密钥：类型选「Claude Code（用你的订阅）」。

• 找不到 Claude Code 时这一项不能选：先安装，并在终端运行 claude 登录一次
• 模型可选默认、Haiku（快）、Sonnet、Opus
• 每次都要先启动 Claude Code，比直接用接口慢几秒
• Claude Code 只拿到要处理的那段文字，不能读你的文件，也不能运行命令

设置里的其他几项

连不上时

「测试」或使用时出错，Marlin 会说明原因：

更多问题见 常见问题。