配置模型

Axiomate 不绑定单一模型服务。使用前需要先配置至少一个主模型，之后也可以为标题、摘要、输入建议等辅助任务配置更便宜或更快的模型。

第一次配置

首次启动时，Axiomate 会自动引导完成模型配置。之后也可以随时运行：

/model add

大多数情况下，只需要填写 API base URL、API key、Model ID，并为模型服务选择对应的 API 协议。Axiomate 会根据 Model ID 自动推断上下文窗口、输出上限、vendor / model template 等字段，其余字段保持默认即可。

这个向导会依次询问以下字段：

字段	作用	选择建议
API 协议	模型服务使用的接口格式。	必选。OpenAI 兼容服务通常选 `OpenAI Chat Completions`；支持 Responses API 的服务选 `OpenAI Responses API`；Anthropic 或 Anthropic 兼容服务选 `Anthropic-compatible`。
API base URL	模型服务的接口地址，请求会发到这里。	必填。不同 provider 提供的地址不同；本地模型服务也有自己的本地地址。
API key	调用模型服务的密钥，用于证明调用权限。	必填。通常在 provider 控制台创建，避免公开分享。
Model ID	要调用的模型名，会写到 provider 的 `model` 字段。	必填。填具体模型版本（如带日期或代号的 ID）。Axiomate 会按此名匹配后续字段的默认值。
`contextWindow`	模型一次能接收的最大上下文长度。	模型名可识别时会自动预填，通常保持默认即可。
`maxOutputTokens`	模型单次回复最多输出多少 token。	模型名可识别时会自动预填，通常保持默认即可。
是否支持图片输入	模型是否能看图片、截图等视觉内容。	能看图选支持；纯文本模型选不支持。模型名可识别时会预选。
vendor / model template	Axiomate 用来适配不同 provider 和模型特性的模板。	保持 `auto`，让 Axiomate 按 Model ID 自动匹配。
Reasoning depth	模型默认的思考强度。	默认 `High`。推理模型保持默认即可；普通聊天或小模型可改为 `Off`。
使用方式	把这个模型设为主模型、加入 fallback，或仅保存。	第一次配置通常选 Use as main model。

如果不确定某一项，优先使用向导给出的默认值。

配置会保存到 ~/.axiomate.json。

切换模型

日常切换模型最常用的方式是直接打开模型选择器：

/model

它会打开一个 TUI 列表。用上下方向键选择模型；如果模型支持 effort，用左右方向键调整思考强度；按 Enter 确认。

确认后，Axiomate 会把选中的模型设为当前默认 route 的主模型。之后普通对话会使用这个模型。

也可以使用默认快捷键 Alt+P / Meta+P 打开模型选择器。

修改已有模型

如果 API key、base URL、模型名、上下文窗口或图片能力写错了，用：

/model edit <model-id>

它会打开编辑器修改 models[model-id] 这一项。保存时 Axiomate 会校验 JSON 和模型引用。

想查看当前主模型路线：

/model show

思考强度怎么决定

在 /model add 向导里，Reasoning depth 会决定该模型默认的 thinking 配置：

Off：不写入 thinking 字段，模型选择器里也不会显示 effort 调整。
Low / Medium / High / Max：写入类似 { "enabled": true, "effort": "high" } 的配置。

Axiomate 会根据协议、vendor template 和 model template，把这个中立配置转换成 provider 需要的字段。

如果不确定，建议保留默认 High；普通聊天或小模型可以改为 Off。

运行时更改思考强度

模型选择器里的左右方向键可以调整当前模型的思考强度。确认后，这个调整会写入用户设置中的 effortByModel，之后该模型会沿用这个强度。

如果只是想在输入框中快速打开思考强度控件，可以使用默认快捷键 Alt+T / Meta+T。