模型与提供商

提供商是 Mework 发送模型请求的去处：可以是你用密钥接入的 API 服务，也可以是你的 ChatGPT 账号，或这台电脑上的 Claude Code 登录。提供商和模型在设置里添加，模型和思考程度在输入框下方选择。

添加提供商

提供商在 设置 → 提供商 → 模型提供商 里。点侧边栏底部的设置按钮，或按 ⌘,（Windows 上是 Ctrl,）打开。

全新安装自带两个内置提供商：Claude Agent 默认开启并处于使用中，OpenAI Codex 在你用 ChatGPT 登录之前保持关闭。如果这台电脑上的 Claude Code 已经登录，Mework 会在 Claude Agent 下换上 Fable、Opus、Sonnet、Haiku 各自最新的模型，并选中 Opus。

添加你自己的提供商：

点提供商列表下方的 添加提供商。
填写 提供商名称，选择 对话协议，点添加。
把密钥粘贴到 API Key。输入框失去焦点时自动保存；清空输入框再离开，会删除已存的密钥。
核对 API 地址，下方那一行显示对话请求发往哪里。Azure OpenAI、AWS Bedrock 和 Google Vertex AI 还要点地址旁的齿轮填写身份字段：标了 * 的字段没填齐之前，请求会被拒绝。
添加模型。

密钥存进系统凭据库，不会写进对话（存放位置）。在 macOS 上，系统询问能否使用 Mework Safe Storage 时，选 始终允许。

对话协议

按服务文档写的 API 格式选，而不是按它的品牌选。

对话协议	默认地址	说明
OpenAI Responses	`https://api.openai.com/v1`
OpenAI Chat Completions	`https://api.openai.com/v1`	默认选项。
Anthropic Messages	`https://api.anthropic.com/v1`	也适用于 Anthropic 风格的端点。
Google Gemini	`https://generativelanguage.googleapis.com/v1beta`
xAI	`https://api.x.ai/v1`
Azure OpenAI	无：填你的资源地址	模型 ID 填部署名。可选 api-version。
AWS Bedrock	无：留空，由 Mework 根据区域得出	用 Bedrock API 密钥。需要 AWS 区域。
Google Vertex AI	无：留空，由 Mework 根据项目和区域得出	用 Vertex API 密钥（express 模式）。需要 GCP 项目和 GCP 区域。
OpenAI Compatible	无	其他 OpenAI 风格的服务，比如中转站和局域网里的模型服务。

以 DeepSeek 为例：用 OpenAI Chat Completions 或 OpenAI Responses 时地址填 https://api.deepseek.com，用 Anthropic Messages 时填 https://api.deepseek.com/anthropic/v1。

API 地址必须是 https://。你自己网络里的地址（localhost、以 .localhost 或 .local 结尾的名字、回环和私有 IP）可以用 http://，也不需要密钥，所以 Ollama、LM Studio 不填密钥也能用。其他地址都要先有密钥，Bedrock 和 Vertex 也一样。

管理提供商

提供商顶栏的开关可以停用它，停用后它的模型会从模型菜单里消失。
列表顺序就是模型菜单里的顺序。拖动整行排序，或按 ⌥↑ / ⌥↓（Windows 上是 Alt↑ / Alt↓）。搜索列表，或筛选为仅已启用、仅已停用时，不能排序。
删除提供商会一并删除它已存的密钥。两个内置提供商不能删除。
名称旁的齿轮打开 提供商设置，可以改名、更换 API 格式，或编辑身份字段。

用 ChatGPT 登录

OpenAI Codex 用你的 ChatGPT 订阅运行 Codex 模型，不需要 API 密钥。

选中 OpenAI Codex，点 登录 ChatGPT。
在浏览器打开的页面里完成登录，提供商随之开启。
点 拉取模型，添加你要用的模型。登录本身不会添加任何模型。

退出登录 会停用提供商并删除登录信息。内置的 Sol 和 Luna 两个角色需要先在这里添加 gpt-6.1-sol 和 gpt-6-luna。

使用 Claude Code 的登录

Claude Agent 运行随 Mework 附带的一份 Claude Code，所以你不必自己安装 Claude Code。它用的是这台电脑上 Claude Code 的登录，claude.ai 订阅或 Console 账号都可以。

如果面板没有显示 已登录 Claude Code：

点 打开终端登录，按终端里的提示完成登录。
回到 Mework，点 重新检查。登录成功后，提供商随之开启。

复制命令 复制的命令运行的是同一个登录流程，可以粘贴到任何终端里。如果你本来就在用 Claude Code，在那里登录也一样，因为两者共用同一份登录。

Mework 会关掉 Claude Code 自带的工具、CLAUDE.md、设置文件、钩子、插件、MCP 服务器、压缩和后台任务，并忽略环境变量里的 ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL 和 CLAUDE_CODE_OAUTH_TOKEN。上下文窗口 大于 200,000 时，Claude Code 使用 1M token 的额度。

添加模型

提供商的模型列表就是模型菜单里能选的全部。没有逐个模型的开关，不想要的模型直接移除。

拉取模型 会打开 发现模型，即提供商的模型目录：点一行即可添加或移除该模型，也可以用 整组添加 和 添加全部结果。地址留空时，AWS Bedrock 和 Google Vertex AI 没有可拉取的目录，所以不提供 拉取模型。列表里已有的模型保留现有的值；要用上变化后的上限，就编辑这个模型，或者移除后重新添加。

手动添加：点 +（手动添加模型），按提供商要求的写法填 模型 ID，点保存。

模型或分组标题上的减号会立即移除它，不经确认。

模型属性

点模型上的齿轮打开 模型属性，点保存后改动才生效。

属性	默认值	改变什么
模型 ID	必填	发给提供商的 `model` 值，也是模型菜单里显示的名字。
显示名	模型 ID	设置里模型列表显示的名字。
分组	由 ID 推断	设置里模型列表的折叠分组。
上下文窗口	空	上下文用量环的分母。自动压缩需要它。
单次最大输出	空	每次请求的输出 token 上限。留空时，Anthropic Messages 和 AWS Bedrock 发送 32,000，其他协议交给提供商的默认值。
缓存失效时间（分钟）	30	每次请求后，提示词缓存在这段时间内视为有效；在此期间，如果改动设置会让缓存失效，Mework 会先询问。
视觉输入	来自模型目录；手动添加时关闭	允许把图片发给这个模型。关闭后，带图片的对话无法用这个模型发送。
中途追加工具	认得的模型自动打开	让工具发现、自动压缩、计划模式和新打开的工具在对话进行中加入，而不丢失提示词缓存。适用于 Anthropic Messages、OpenAI Responses、Azure OpenAI、OpenAI Codex 和 Claude Agent。否则工具在第一次请求时就固定下来：没有自动压缩和工具发现，计划也只有一开始就开着才能用。
中途追加系统提示词	认得的模型自动打开	对话中途才开始生效的指令（比如计划模式的引导）作为 system 消息送达，而不是经由 box。对 Gemini、Bedrock、Vertex 和 Claude Agent 不起作用。
提示词缓存	开	只对 Anthropic Messages 有效。关掉就没有缓存。
思考字段形态	OpenAI Responses、OpenAI Codex 和 Azure OpenAI 上是加密，其他协议是明文	只在这三种协议上起作用：Mework 总会向它们请求加密思考字段，让思考能在工具调用之间回放；这项设置只决定思考怎样显示。端点会流式返回可读的思考文字时（DeepSeek 和许多中转站都是这样），选明文思考字段，就能把这些文字显示为思考。

遇到中转站或 Mework 不认得的模型，按端点实际支持的情况设置两个中途追加开关。

选择模型

输入框下方的模型按钮列出所有已启用提供商的模型。

注意你选的模型对整个应用生效，而不只是当前对话：每个对话的下一次请求都会用它。

旁边的 思考程度 属于对话本身：low、medium、high、extra 或 max，默认 medium。你选的档位也会成为新对话的起始档位。模型不支持所选档位时，改用它支持且低于所选档位的最高一档，没有更低的就用它最低的一档；Claude Agent 例外，由 Claude Code 改用 high。

子代理角色可以有自己的模型和 思考程度。角色绑定的模型如果不在任何已启用提供商的列表里，这个角色就无法被调用。