agy --model <name>

在启动时指定要使用的模型。

agy --model <name> 用于在启动 CLI 时设置推理模型。在交互式会话中,如果模型无法解析,会带警告回退到默认模型;而在打印模式(-p)下,自 1.1.2 版本起 CLI 会直接以非 0 退出码中止,并列出可用模型。可用的模型名称可通过子命令 agy models 查看。

✅ 什么时候用？

直接以指定模型启动

agy --model="Gemini 3.1 Pro"

在脚本中确保使用的是指定模型

agy --model <name> -p "<prompt>" 在名称错误时会直接中止,而不会静默使用其他模型

⛔ 什么时候不该用？

希望模型选择对之后所有会话都长期生效

--model 只对当前这次启动生效,不会持久保存。

更好的选择: 在运行中的 agy 里使用 /model,它会跨会话持久保存模型设置

来源