文档快照 · CLI 7.30.1 · SDK 2.6.53。Desktop 使用其发行版随附的运行时。命令和示例保留英文原文。英文原文

选择和切换模型

找到可用模型

先连接提供方。在终端界面输入 /models，搜索已连接提供方中的模型并选择。收藏与最近使用记录方便你再次找到模型。

模型选择器按提供方分组。不具备必要文本输出或工具调用能力的模型可能被隐藏或禁用。托管的本地模型可能在权重下载前就显示；使用前请完成准备。

要查看当前安装的 CLI 可用的 ID，请运行：

ax-code models
ax-code models --json --verbose

复制完整的 provider/model ID。不同提供方下相同的显示名称，可能对应不同的凭据、能力和限制。

将示例值替换为当前安装版本列出的 ID。第一条命令打开终端界面，第二条运行一个提示。提示内容应放在 -- 之后。

MODEL='provider/model'
ax-code --model "$MODEL"
ax-code run --model "$MODEL" -- "Explain the project entry point without changing files."

模型系列别名 deepseek、glm 和 qwen 会通过可用连接选择受支持的 Flash 模型。目标可能随版本改变。指定具体模型或档位时应使用完整 ID；单独的型号不是完整 ID。

将以下字段合并到现有项目或全局 ax-code.json 中。只替换占位值，不要覆盖整个文件：

{
  "model": "provider/model"
}

编辑配置后重启。未显式指定模型时，已有 agent、会话或最近选择可能影响结果；发送任务前确认当前模型。Desktop 有自己的设置。

先提出一个小范围的仓库问题。修改代码时，确认支持工具调用并运行项目检查。使用图片时确认图片输入能力。长任务应检查上下文和输出限制，而非仅凭模型名称判断。

使用相同的任务、输入和验收检查比较候选模型。考虑延迟、提供方使用条款、数据处理和本地内存需求。任何模型都不能保证修改正确。

推理强度与自动路由是独立控制项。先使用一个明确指定的模型，再启用路由。Wiki 生成可以独立使用自己的 wiki.model，不受前台会话影响。